@matdata/yasgui-explain-plugin 0.1.0 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/LICENSE +201 -201
  2. package/README.md +91 -91
  3. package/dist/ExplainPlugin.d.ts +64 -0
  4. package/dist/ExplainPlugin.d.ts.map +1 -0
  5. package/dist/algebra/print.d.ts +21 -0
  6. package/dist/algebra/print.d.ts.map +1 -0
  7. package/dist/algebra/terms.d.ts +18 -0
  8. package/dist/algebra/terms.d.ts.map +1 -0
  9. package/dist/algebra/translate.d.ts +19 -0
  10. package/dist/algebra/translate.d.ts.map +1 -0
  11. package/dist/engines/blazegraph.d.ts +12 -0
  12. package/dist/engines/blazegraph.d.ts.map +1 -0
  13. package/dist/engines/graphdb.d.ts +23 -0
  14. package/dist/engines/graphdb.d.ts.map +1 -0
  15. package/dist/engines/index.d.ts +23 -0
  16. package/dist/engines/index.d.ts.map +1 -0
  17. package/dist/engines/neptune.d.ts +11 -0
  18. package/dist/engines/neptune.d.ts.map +1 -0
  19. package/dist/engines/qlever.d.ts +35 -0
  20. package/dist/engines/qlever.d.ts.map +1 -0
  21. package/dist/engines/stardog.d.ts +14 -0
  22. package/dist/engines/stardog.d.ts.map +1 -0
  23. package/dist/host.d.ts +24 -0
  24. package/dist/host.d.ts.map +1 -0
  25. package/dist/icons.d.ts +22 -0
  26. package/dist/icons.d.ts.map +1 -0
  27. package/dist/index.d.ts +17 -0
  28. package/dist/index.d.ts.map +1 -0
  29. package/dist/render.d.ts +46 -0
  30. package/dist/render.d.ts.map +1 -0
  31. package/dist/settings.d.ts +11 -0
  32. package/dist/settings.d.ts.map +1 -0
  33. package/dist/types.d.ts +141 -0
  34. package/dist/types.d.ts.map +1 -0
  35. package/dist/yasgui-explain-plugin.cjs.js +20519 -0
  36. package/dist/yasgui-explain-plugin.cjs.js.map +7 -0
  37. package/dist/yasgui-explain-plugin.css +354 -0
  38. package/dist/yasgui-explain-plugin.esm.js +20513 -0
  39. package/dist/yasgui-explain-plugin.esm.js.map +7 -0
  40. package/dist/yasgui-explain-plugin.min.css +1 -0
  41. package/dist/yasgui-explain-plugin.min.js +146 -0
  42. package/dist/yasgui-explain-plugin.min.js.map +7 -0
  43. package/package.json +73 -73
@@ -0,0 +1,354 @@
1
+ /* Colours follow the YASGUI theme variables, with fallbacks for standalone use */
2
+ :root {
3
+ --explain-background: var(--yasgui-bg-primary, #ffffff);
4
+ --explain-surface: var(--yasgui-bg-secondary, #f5f5f5);
5
+ --explain-text: var(--yasgui-text-primary, #222222);
6
+ --explain-text-muted: var(--yasgui-text-secondary, #666666);
7
+ --explain-border: var(--yasgui-border-color, #d0d0d0);
8
+ --explain-control-hover: var(--yasgui-bg-tertiary, #eeeeee);
9
+ --explain-primary: var(--yasgui-accent-color, #1976d2);
10
+ --explain-error: var(--yasgui-error-color, #c62828);
11
+ --explain-bar: var(--yasgui-accent-color, #1976d2);
12
+ --explain-bar-slow: #e65100;
13
+ --explain-mono: var(--yasgui-font-mono, ui-monospace, 'JetBrains Mono', Menlo, Consolas, monospace);
14
+ }
15
+
16
+ [data-theme='dark'] {
17
+ --explain-background: var(--yasgui-bg-primary, #1e1e1e);
18
+ --explain-surface: var(--yasgui-bg-secondary, #2a2a2a);
19
+ --explain-text: var(--yasgui-text-primary, #e0e0e0);
20
+ --explain-text-muted: var(--yasgui-text-secondary, #aaaaaa);
21
+ --explain-border: var(--yasgui-border-color, #444444);
22
+ --explain-control-hover: var(--yasgui-bg-tertiary, #21262d);
23
+ --explain-primary: var(--yasgui-accent-color, #6aa6e8);
24
+ --explain-error: var(--yasgui-error-color, #ef7a7a);
25
+ --explain-bar: var(--yasgui-accent-color, #6aa6e8);
26
+ --explain-bar-slow: #ffa040;
27
+ }
28
+
29
+ .yasgui-explain-plugin {
30
+ color-scheme: light;
31
+ display: flex;
32
+ flex-direction: column;
33
+ width: 100%;
34
+ color: var(--explain-text);
35
+ background: var(--explain-background);
36
+ font-size: 13px;
37
+ }
38
+
39
+ [data-theme='dark'] .yasgui-explain-plugin {
40
+ color-scheme: dark;
41
+ }
42
+
43
+ /* Own toolbar, used when the host has no toolbar slot */
44
+ .explain-toolbar {
45
+ display: flex;
46
+ flex-wrap: wrap;
47
+ align-items: center;
48
+ gap: 8px 14px;
49
+ padding: 6px 8px;
50
+ border-bottom: 1px solid var(--explain-border);
51
+ }
52
+
53
+ .explain-field {
54
+ display: inline-flex;
55
+ align-items: center;
56
+ gap: 6px;
57
+ }
58
+
59
+ .explain-field > span {
60
+ color: var(--explain-text-muted);
61
+ }
62
+
63
+ .explain-select,
64
+ .explain-button {
65
+ min-height: 26px;
66
+ padding: 2px 8px;
67
+ border: 1px solid var(--explain-border);
68
+ border-radius: 4px;
69
+ background: var(--explain-background);
70
+ color: var(--explain-text);
71
+ font: inherit;
72
+ cursor: pointer;
73
+ }
74
+
75
+ .explain-button {
76
+ display: inline-flex;
77
+ align-items: center;
78
+ gap: 5px;
79
+ }
80
+
81
+ .explain-button:hover:not(:disabled),
82
+ .explain-select:hover:not(:disabled) {
83
+ background: var(--explain-control-hover);
84
+ }
85
+
86
+ .explain-button:disabled,
87
+ .explain-select:disabled {
88
+ opacity: 0.5;
89
+ cursor: default;
90
+ }
91
+
92
+ /* Sections */
93
+ .explain-section {
94
+ border-bottom: 1px solid var(--explain-border);
95
+ }
96
+
97
+ .explain-section:last-child {
98
+ border-bottom: 0;
99
+ }
100
+
101
+ .explain-section-header {
102
+ display: flex;
103
+ flex-wrap: wrap;
104
+ align-items: center;
105
+ gap: 6px 12px;
106
+ padding: 6px 8px;
107
+ background: var(--explain-surface);
108
+ }
109
+
110
+ .explain-section-toggle {
111
+ display: inline-flex;
112
+ align-items: center;
113
+ gap: 4px;
114
+ padding: 2px 4px 2px 0;
115
+ border: 0;
116
+ background: none;
117
+ color: var(--explain-text);
118
+ font: inherit;
119
+ font-weight: 600;
120
+ cursor: pointer;
121
+ }
122
+
123
+ .explain-section-toggle .explain-icon {
124
+ transition: transform 0.15s;
125
+ }
126
+
127
+ .explain-section--collapsed .explain-section-toggle .explain-icon {
128
+ transform: rotate(-90deg);
129
+ }
130
+
131
+ .explain-section--collapsed .explain-section-body {
132
+ display: none;
133
+ }
134
+
135
+ .explain-section-status {
136
+ color: var(--explain-text-muted);
137
+ }
138
+
139
+ .explain-section-status--error {
140
+ color: var(--explain-error);
141
+ }
142
+
143
+ .explain-section-actions {
144
+ display: inline-flex;
145
+ flex-wrap: wrap;
146
+ gap: 6px;
147
+ margin-left: auto;
148
+ }
149
+
150
+ .explain-section-body {
151
+ overflow: auto;
152
+ }
153
+
154
+ .explain-message {
155
+ padding: 12px 10px;
156
+ color: var(--explain-text-muted);
157
+ }
158
+
159
+ .explain-message--error {
160
+ color: var(--explain-error);
161
+ white-space: pre-wrap;
162
+ font-family: var(--explain-mono);
163
+ font-size: 12px;
164
+ }
165
+
166
+ .explain-message--info {
167
+ color: var(--explain-text);
168
+ }
169
+
170
+ .explain-summary {
171
+ display: flex;
172
+ flex-wrap: wrap;
173
+ gap: 4px 18px;
174
+ padding: 8px 10px 4px;
175
+ color: var(--explain-text-muted);
176
+ }
177
+
178
+ /* Trees */
179
+ .explain-tree {
180
+ padding: 6px 4px 8px;
181
+ font-family: var(--explain-mono);
182
+ font-size: 12px;
183
+ line-height: 1.45;
184
+ }
185
+
186
+ .explain-row {
187
+ display: flex;
188
+ align-items: flex-start;
189
+ gap: 4px;
190
+ padding: 2px 6px 2px calc(4px + var(--explain-depth, 0) * 18px);
191
+ border-radius: 4px;
192
+ }
193
+
194
+ .explain-row:hover {
195
+ background: var(--explain-control-hover);
196
+ }
197
+
198
+ .explain-toggle {
199
+ flex: 0 0 18px;
200
+ display: inline-flex;
201
+ align-items: center;
202
+ justify-content: center;
203
+ width: 18px;
204
+ height: 18px;
205
+ margin-top: 1px;
206
+ padding: 0;
207
+ border: 0;
208
+ border-radius: 3px;
209
+ background: none;
210
+ color: var(--explain-text-muted);
211
+ cursor: pointer;
212
+ }
213
+
214
+ .explain-toggle:hover {
215
+ color: var(--explain-text);
216
+ }
217
+
218
+ .explain-toggle--leaf {
219
+ visibility: hidden;
220
+ cursor: default;
221
+ }
222
+
223
+ .explain-node--collapsed > .explain-row .explain-toggle .explain-icon {
224
+ transform: rotate(-90deg);
225
+ }
226
+
227
+ .explain-node--collapsed > .explain-children {
228
+ display: none;
229
+ }
230
+
231
+ .explain-row-main {
232
+ flex: 1 1 auto;
233
+ min-width: 0;
234
+ }
235
+
236
+ .explain-label {
237
+ word-break: break-word;
238
+ }
239
+
240
+ .explain-operator {
241
+ font-weight: 600;
242
+ color: var(--explain-primary);
243
+ }
244
+
245
+ .explain-args {
246
+ margin-left: 8px;
247
+ }
248
+
249
+ .explain-meta {
250
+ display: flex;
251
+ flex-direction: column;
252
+ color: var(--explain-text-muted);
253
+ }
254
+
255
+ .explain-meta--code {
256
+ color: var(--explain-text);
257
+ }
258
+
259
+ .explain-badge {
260
+ display: inline-block;
261
+ margin-left: 8px;
262
+ padding: 0 6px;
263
+ border-radius: 8px;
264
+ background: var(--explain-surface);
265
+ border: 1px solid var(--explain-border);
266
+ color: var(--explain-text-muted);
267
+ font-size: 11px;
268
+ font-family: inherit;
269
+ vertical-align: 1px;
270
+ }
271
+
272
+ .explain-node--cached > .explain-row {
273
+ opacity: 0.7;
274
+ }
275
+
276
+ .explain-node--inactive > .explain-row {
277
+ opacity: 0.55;
278
+ }
279
+
280
+ /* Plan statistics: rows, time, bar */
281
+ .explain-stats {
282
+ flex: 0 0 auto;
283
+ display: grid;
284
+ grid-template-columns: 90px 70px 120px;
285
+ align-items: center;
286
+ gap: 8px;
287
+ margin-left: 12px;
288
+ text-align: right;
289
+ color: var(--explain-text-muted);
290
+ white-space: nowrap;
291
+ }
292
+
293
+ .explain-plan--no-times .explain-stats {
294
+ grid-template-columns: 90px;
295
+ }
296
+
297
+ .explain-plan--no-times .explain-time,
298
+ .explain-plan--no-times .explain-bar {
299
+ display: none;
300
+ }
301
+
302
+ .explain-bar {
303
+ display: block;
304
+ height: 8px;
305
+ border-radius: 4px;
306
+ background: var(--explain-surface);
307
+ overflow: hidden;
308
+ }
309
+
310
+ .explain-bar-fill {
311
+ display: block;
312
+ height: 100%;
313
+ background: var(--explain-bar);
314
+ }
315
+
316
+ .explain-node--slowest > .explain-row .explain-bar-fill {
317
+ background: var(--explain-bar-slow);
318
+ }
319
+
320
+ .explain-node--slowest > .explain-row .explain-time {
321
+ color: var(--explain-bar-slow);
322
+ font-weight: 600;
323
+ }
324
+
325
+ @media (max-width: 700px) {
326
+ .explain-stats {
327
+ grid-template-columns: 70px 60px;
328
+ }
329
+
330
+ .explain-bar {
331
+ display: none;
332
+ }
333
+ }
334
+
335
+ /* Text plans */
336
+ .explain-text {
337
+ margin: 0;
338
+ padding: 10px;
339
+ font-family: var(--explain-mono);
340
+ font-size: 12px;
341
+ line-height: 1.45;
342
+ white-space: pre;
343
+ color: var(--explain-text);
344
+ }
345
+
346
+ /* HTML plans (Blazegraph) */
347
+ .explain-frame {
348
+ display: block;
349
+ width: 100%;
350
+ min-height: 480px;
351
+ height: 70vh;
352
+ border: 0;
353
+ background: #ffffff;
354
+ }