ontologyviewer 0.1.2 → 0.2.0

package/dist/rdf/compactTriples.d.ts

@@ -0,0 +1,58 @@
+import type { OntologyEdge, OntologyGraph, OntologyNode } from "./graphModel";
+export interface CompactTriplesResult {
+    nodes: OntologyNode[];
+    edges: OntologyEdge[];
+    /**
+     * Statements absorbed into a node because their object was folded away,
+     * keyed by node id — e.g. `":createdAt" -> ["range: dateTime"]`. Rendered on
+     * the node so nothing the document states disappears from view.
+     */
+    foldedFacts: Map<string, string[]>;
+    removedNodeCount: number;
+    removedEdgeCount: number;
+}
+/**
+ * Folds leaf annotation nodes out of the triples graph so the remaining boxes
+ * are the things the ontology is actually about.
+ *
+ * Measured on a 1182-triple schema-heavy ontology, the raw triples view drew
+ * 741 nodes and 1182 edges. Two thirds of those boxes carried no structure:
+ *
+ *  - **485 literal nodes (65% of all boxes).** Every `rdfs:label` and
+ *    `rdfs:comment` became its own box even though `buildGraphModel` already
+ *    copies those values onto the subject's `label`/`comment` fields — the
+ *    same fact drawn twice.
+ *  - **A handful of enormous vocabulary hubs.** `owl:ObjectProperty` reached
+ *    degree 105, `owl:DatatypeProperty` 95, `xsd:string` 56, `owl:Class` 49.
+ *    No force-directed layout can arrange a 105-way hub, and none of them says
+ *    anything as a node.
+ *
+ * Folding both takes that document to 246 nodes (-67%) and 349 edges (-70%).
+ *
+ * A node is folded when all three hold, which keeps the rule principled rather
+ * than a hardcoded blocklist:
+ *  1. it has no outgoing edges — it is purely something other nodes point at,
+ *  2. it has at least one incoming edge, and
+ *  3. it is a literal, or its IRI is in a standard vocabulary namespace
+ *     (rdf, rdfs, owl, xsd, skos, dcterms, foaf).
+ *
+ * Condition 1 is what protects real structure: a document that states
+ * `xsd:string rdfs:comment "..."` has described that term, so it keeps its box.
+ *
+ * `rdfs:label` and `rdfs:comment` are folded *without* a fact line, because the
+ * node already displays them — restating them would reintroduce the very
+ * duplication being removed. Every other folded statement becomes a fact line.
+ *
+ * Note what this deliberately does **not** do: hide property nodes. On a
+ * schema-heavy ontology the property node is the hinge connecting one class to
+ * another (`Class <-domain- property -range-> Class`), so hiding those shatters
+ * the graph. The transformation that removes properties *and* keeps the graph
+ * connected is what the schema view already does, by rewiring domain/range
+ * into a direct class-to-class edge.
+ *
+ * Pure, and never mutates its input: the `OntologyGraph` stays a faithful
+ * representation of the parsed triples, and this compaction is a presentation
+ * choice the viewer can turn off.
+ */
+export declare function compactTriples(graph: OntologyGraph): CompactTriplesResult;
+//# sourceMappingURL=compactTriples.d.ts.map

package/dist/rdf/compactTriples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactTriples.d.ts","sourceRoot":"","sources":["../../src/rdf/compactTriples.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE9E,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB;;;;OAIG;IACH,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,oBAAoB,CA4DzE"}

package/dist/types.d.ts

@@ -20,6 +20,11 @@ export interface OntologyViewerOptions {
     layout?: LayoutName;
     /** Initial graph view. */
     defaultView?: ViewMode;
+    /**
+     * In the triples view, fold leaf annotation nodes (literals and standard
+     * vocabulary terms) into the nodes that point at them. Default: true.
+     */
+    compactTriples?: boolean;
     /** Base IRI used when the Turtle source has no @base directive. */
     baseIri?: string;
     /** @deprecated Use baseIri. */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC5C,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAC3C,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,CAAC;AAEjF,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACrD,8CAA8C;IAC9C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACjF,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC9D,kEAAkE;IAClE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uGAAuG;IACvG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAChD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,IAAI,IAAI,CAAC;IAChB,GAAG,IAAI,IAAI,CAAC;IACZ,SAAS,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,sBAAsB,EAAE,CAAC,CAAC;IAC3D,SAAS,IAAI,SAAS,sBAAsB,EAAE,CAAC;IAC/C,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,sBAAsB,GAAG,SAAS,CAAC;IACtE,gFAAgF;IAChF,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,sBAAsB,EAAE,CAAC;IAC3D,UAAU,IAAI,IAAI,CAAC;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC5C,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAC3C,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,CAAC;AAEjF,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACrD,8CAA8C;IAC9C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACjF,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;IAC9D,kEAAkE;IAClE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uGAAuG;IACvG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAChD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,IAAI,IAAI,CAAC;IAChB,GAAG,IAAI,IAAI,CAAC;IACZ,SAAS,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,sBAAsB,EAAE,CAAC,CAAC;IAC3D,SAAS,IAAI,SAAS,sBAAsB,EAAE,CAAC;IAC/C,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,sBAAsB,GAAG,SAAS,CAAC;IACtE,gFAAgF;IAChF,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,sBAAsB,EAAE,CAAC;IAC3D,UAAU,IAAI,IAAI,CAAC;CACpB"}

package/dist/viewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../src/viewer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAmC,sBAAsB,EAAE,qBAAqB,EAA0B,MAAM,SAAS,CAAC;AAmCtI,wBAAgB,YAAY,CAC1B,aAAa,EAAE,WAAW,EAC1B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,MAAM,IAAI,GACpB,sBAAsB,CAgdxB"}
+{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../src/viewer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAmC,sBAAsB,EAAE,qBAAqB,EAA0B,MAAM,SAAS,CAAC;AAsCtI,wBAAgB,YAAY,CAC1B,aAAa,EAAE,WAAW,EAC1B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,MAAM,IAAI,GACpB,sBAAsB,CA8dxB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ontologyviewer",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Standalone read-only Turtle ontology viewer for web pages, with Schema and Triples diagrams powered by Cytoscape.",
   "type": "module",
   "main": "./dist/ontologyviewer.esm.mjs",