annotate src/layout/ViewConfig.ts @ 128:5a1a79f54779

big rewrite
author drewp@bigasterisk.com
date Fri, 05 May 2023 21:26:36 -0700
parents 2e8fa3fec0c8
children cf642d395be4
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
128
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
1 import Immutable from "immutable"; // mostly using this for the builtin equals() testing, since NamedNode(x)!=NamedNode(x)
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
2 import { DataFactory, NamedNode, Quad_Predicate, Term } from "n3";
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
3 import { MultiStore } from "../MultiStore";
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
4 import { EX } from "./namespaces";
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
5 import { uriValue } from "./rdf_value";
94
a5f53d397526 view: pick types to show at top-level
drewp@bigasterisk.com
parents: 93
diff changeset
6 const Uri = DataFactory.namedNode;
93
955cde1550c3 start the View work: parse view document
drewp@bigasterisk.com
parents:
diff changeset
7
94
a5f53d397526 view: pick types to show at top-level
drewp@bigasterisk.com
parents: 93
diff changeset
8 function firstElem<E>(seq: Iterable<E>): E {
a5f53d397526 view: pick types to show at top-level
drewp@bigasterisk.com
parents: 93
diff changeset
9 for (let e of seq) {
a5f53d397526 view: pick types to show at top-level
drewp@bigasterisk.com
parents: 93
diff changeset
10 return e;
a5f53d397526 view: pick types to show at top-level
drewp@bigasterisk.com
parents: 93
diff changeset
11 }
a5f53d397526 view: pick types to show at top-level
drewp@bigasterisk.com
parents: 93
diff changeset
12 throw new Error("no elems");
a5f53d397526 view: pick types to show at top-level
drewp@bigasterisk.com
parents: 93
diff changeset
13 }
a5f53d397526 view: pick types to show at top-level
drewp@bigasterisk.com
parents: 93
diff changeset
14
122
2e8fa3fec0c8 support joining subjects into wider rows
drewp@bigasterisk.com
parents: 110
diff changeset
15 export interface Link {
2e8fa3fec0c8 support joining subjects into wider rows
drewp@bigasterisk.com
parents: 110
diff changeset
16 // If you display a subject u1 with a `pred` edge to u2, then treat u2 as an alias of u1.
2e8fa3fec0c8 support joining subjects into wider rows
drewp@bigasterisk.com
parents: 110
diff changeset
17 pred: NamedNode;
2e8fa3fec0c8 support joining subjects into wider rows
drewp@bigasterisk.com
parents: 110
diff changeset
18 }
2e8fa3fec0c8 support joining subjects into wider rows
drewp@bigasterisk.com
parents: 110
diff changeset
19
2e8fa3fec0c8 support joining subjects into wider rows
drewp@bigasterisk.com
parents: 110
diff changeset
20 interface TableDesc {
97
26c55d5d5202 WIP on views & joins
drewp@bigasterisk.com
parents: 95
diff changeset
21 uri: NamedNode;
26c55d5d5202 WIP on views & joins
drewp@bigasterisk.com
parents: 95
diff changeset
22 primary: NamedNode;
26c55d5d5202 WIP on views & joins
drewp@bigasterisk.com
parents: 95
diff changeset
23 joins: NamedNode[];
122
2e8fa3fec0c8 support joining subjects into wider rows
drewp@bigasterisk.com
parents: 110
diff changeset
24 links: Link[];
97
26c55d5d5202 WIP on views & joins
drewp@bigasterisk.com
parents: 95
diff changeset
25 }
26c55d5d5202 WIP on views & joins
drewp@bigasterisk.com
parents: 95
diff changeset
26
128
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
27 // High-level guide to how to draw the page, independent of the graph data.
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
28 // Layout.ts turns this plus the actual graph data into a structure that's
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
29 // close to the final render.
102
ab7dca42afbd rewrite ViewConfig
drewp@bigasterisk.com
parents: 97
diff changeset
30 export class ViewConfig {
128
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
31 viewRoot: NamedNode; // this structure...
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
32 graph: MultiStore; // in this graph...
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
33 tables: TableDesc[] = []; // populates all the rest of these fields for use by Layout
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
34 freeStatementsHidePred: Immutable.Set<Quad_Predicate> = Immutable.Set();
95
47d3b5a5bd5e refactor
drewp@bigasterisk.com
parents: 94
diff changeset
35
128
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
36 constructor(graph: MultiStore, viewUri: NamedNode) {
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
37 this.graph = graph;
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
38 this.viewRoot = viewUri;
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
39 // todo
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
40 const here = "https://bigasterisk.com/lanscape/";
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
41 if (this.viewRoot.value.startsWith(here)) {
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
42 this.viewRoot = new NamedNode(this.viewRoot.value.slice(here.length));
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
43 }
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
44 // todo: might need to reread if graph changes
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
45 this.read();
93
955cde1550c3 start the View work: parse view document
drewp@bigasterisk.com
parents:
diff changeset
46 }
95
47d3b5a5bd5e refactor
drewp@bigasterisk.com
parents: 94
diff changeset
47
128
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
48 private read() {
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
49 for (let table of this.graph.getObjects(this.viewRoot, EX("table"), null)) {
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
50 const t = this.readTable(table);
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
51 this.tables.push(t);
102
ab7dca42afbd rewrite ViewConfig
drewp@bigasterisk.com
parents: 97
diff changeset
52 }
128
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
53 this.tables.sort();
102
ab7dca42afbd rewrite ViewConfig
drewp@bigasterisk.com
parents: 97
diff changeset
54
128
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
55 this.readHides();
102
ab7dca42afbd rewrite ViewConfig
drewp@bigasterisk.com
parents: 97
diff changeset
56 }
ab7dca42afbd rewrite ViewConfig
drewp@bigasterisk.com
parents: 97
diff changeset
57
128
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
58 private readHides() {
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
59 for (let hideInstruction of this.graph.getObjects(
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
60 this.viewRoot,
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
61 EX("freeStatementsHide"),
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
62 null
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
63 )) {
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
64 for (let pred of this.graph.getObjects(
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
65 hideInstruction,
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
66 EX("predicate"),
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
67 null
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
68 )) {
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
69 this.freeStatementsHidePred = this.freeStatementsHidePred.add(
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
70 pred as Quad_Predicate
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
71 );
97
26c55d5d5202 WIP on views & joins
drewp@bigasterisk.com
parents: 95
diff changeset
72 }
128
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
73 }
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
74 }
122
2e8fa3fec0c8 support joining subjects into wider rows
drewp@bigasterisk.com
parents: 110
diff changeset
75
128
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
76 private readTable(table: Term): TableDesc {
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
77 const tableType = uriValue(this.graph, table, EX("primaryType"));
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
78 const joins: NamedNode[] = [];
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
79 for (let joinType of this.graph.getObjects(table, EX("joinType"), null)) {
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
80 joins.push(joinType as NamedNode);
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
81 }
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
82 joins.sort();
122
2e8fa3fec0c8 support joining subjects into wider rows
drewp@bigasterisk.com
parents: 110
diff changeset
83
128
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
84 const links: Link[] = [];
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
85 for (let linkDesc of this.graph.getObjects(table, EX("link"), null)) {
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
86 links.push({
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
87 pred: uriValue(this.graph, linkDesc, EX("predicate")),
102
ab7dca42afbd rewrite ViewConfig
drewp@bigasterisk.com
parents: 97
diff changeset
88 });
94
a5f53d397526 view: pick types to show at top-level
drewp@bigasterisk.com
parents: 93
diff changeset
89 }
102
ab7dca42afbd rewrite ViewConfig
drewp@bigasterisk.com
parents: 97
diff changeset
90
128
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
91 return {
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
92 uri: table as NamedNode,
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
93 primary: tableType,
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
94 joins: joins,
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
95 links: links,
5a1a79f54779 big rewrite
drewp@bigasterisk.com
parents: 122
diff changeset
96 };
93
955cde1550c3 start the View work: parse view document
drewp@bigasterisk.com
parents:
diff changeset
97 }
955cde1550c3 start the View work: parse view document
drewp@bigasterisk.com
parents:
diff changeset
98 }