@link-foundation/ui-components 0.0.0-stage → 0.1.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.
- package/CONFIGURATIONS.md +74 -0
- package/ICONS.md +76 -0
- package/LICENSE +24 -0
- package/README.md +1499 -2
- package/bin/lino-network.mjs +71 -0
- package/dist/icons/ATTRIBUTION.md +602 -0
- package/dist/icons/NOTICE.lino +1261 -0
- package/dist/icons/brand.js +31 -0
- package/dist/icons/brand.svg +3 -0
- package/dist/icons/licenses/brand/DISCLAIMER.md +51 -0
- package/dist/icons/licenses/brand/LICENSE.md +30 -0
- package/dist/icons/licenses/lucide/LICENSE +43 -0
- package/dist/icons/licenses/material-symbols/LICENSE +202 -0
- package/dist/icons/licenses/material-symbols/NOTICE +12 -0
- package/dist/icons/licenses/tabler/LICENSE +21 -0
- package/dist/icons/lucide.js +681 -0
- package/dist/icons/lucide.svg +34 -0
- package/dist/icons/material-symbols.js +681 -0
- package/dist/icons/material-symbols.svg +34 -0
- package/dist/icons/own.js +521 -0
- package/dist/icons/own.svg +34 -0
- package/dist/icons/tabler.js +681 -0
- package/dist/icons/tabler.svg +34 -0
- package/dist/network-layout-NOTICE.md +6 -0
- package/dist/network-layout-d3-dispatch-LICENSE.txt +13 -0
- package/dist/network-layout-d3-force-LICENSE.txt +13 -0
- package/dist/network-layout-d3-quadtree-LICENSE.txt +13 -0
- package/dist/network-layout-d3-timer-LICENSE.txt +13 -0
- package/dist/network-layout-dagre-LICENSE.txt +19 -0
- package/dist/network-layout.worker.mjs +2 -0
- package/package.json +246 -4
- package/src/a11y/announce.js +88 -0
- package/src/a11y/bind-machine.js +181 -0
- package/src/a11y/focus.js +169 -0
- package/src/a11y/index.d.ts +89 -0
- package/src/a11y/index.js +19 -0
- package/src/a11y/keys.js +182 -0
- package/src/a11y/roving.js +167 -0
- package/src/a11y/typeahead.js +82 -0
- package/src/behavior/actions.js +235 -0
- package/src/behavior/diagnostics.js +73 -0
- package/src/behavior/dom.d.ts +38 -0
- package/src/behavior/dom.js +420 -0
- package/src/behavior/index.d.ts +211 -0
- package/src/behavior/index.js +29 -0
- package/src/behavior/interpret.js +454 -0
- package/src/behavior/machines/disclosure.lino +46 -0
- package/src/behavior/machines/index.js +91 -0
- package/src/behavior/machines/toggle.lino +25 -0
- package/src/behavior/parse-machine.js +367 -0
- package/src/charts/README.md +78 -0
- package/src/charts/activity-layout.js +350 -0
- package/src/charts/activity-model.js +130 -0
- package/src/charts/activity-validation.js +31 -0
- package/src/charts/chart-model.js +667 -0
- package/src/charts/chart.js +518 -0
- package/src/charts/echarts-adapter.d.ts +23 -0
- package/src/charts/echarts-adapter.js +240 -0
- package/src/charts/element.js +330 -0
- package/src/charts/errors.js +62 -0
- package/src/charts/gauge.js +27 -0
- package/src/charts/index.d.ts +344 -0
- package/src/charts/index.js +59 -0
- package/src/charts/layout.js +542 -0
- package/src/charts/lino.js +158 -0
- package/src/charts/mark-options.js +78 -0
- package/src/charts/read.js +101 -0
- package/src/charts/renderer-features.js +8 -0
- package/src/charts/scales.js +223 -0
- package/src/charts/small-model.js +223 -0
- package/src/charts/small-svg.js +269 -0
- package/src/charts/sparkline.js +27 -0
- package/src/charts/stat-tile.js +37 -0
- package/src/charts/summary.js +193 -0
- package/src/charts/svg-renderer.js +226 -0
- package/src/charts/svg.js +69 -0
- package/src/charts/tag-cloud.js +129 -0
- package/src/charts/tokens.js +171 -0
- package/src/charts/tooltip.js +47 -0
- package/src/charts/values.js +146 -0
- package/src/chat/README.md +142 -0
- package/src/chat/actions.js +75 -0
- package/src/chat/chat-contract.js +95 -0
- package/src/chat/chat-list.js +42 -0
- package/src/chat/chat-model.js +125 -0
- package/src/chat/chat.css +228 -0
- package/src/chat/composer.js +131 -0
- package/src/chat/day-separator.js +12 -0
- package/src/chat/dom.js +33 -0
- package/src/chat/follow.js +49 -0
- package/src/chat/index.d.ts +142 -0
- package/src/chat/index.js +13 -0
- package/src/chat/message-bubble.js +191 -0
- package/src/chat/message-stream.js +331 -0
- package/src/chat/reasoning-trace.js +70 -0
- package/src/chat/selection.js +39 -0
- package/src/chat/skins/bubbles.lino +2 -0
- package/src/chat/skins/cards.lino +4 -0
- package/src/chat/skins/compact.lino +4 -0
- package/src/chat/skins/signal.lino +25 -0
- package/src/chat/skins/t3.lino +25 -0
- package/src/chat/skins/telegram.lino +31 -0
- package/src/chat/skins/whatsapp.lino +25 -0
- package/src/chat/stream-keys.js +57 -0
- package/src/chat/stream-window.js +159 -0
- package/src/chat/vocabulary.js +19 -0
- package/src/controls/accordion.js +160 -0
- package/src/controls/avatar.js +80 -0
- package/src/controls/badge.js +48 -0
- package/src/controls/button-template.js +32 -0
- package/src/controls/button.js +97 -0
- package/src/controls/catalog.lino +84 -0
- package/src/controls/checkbox.js +112 -0
- package/src/controls/chip.js +140 -0
- package/src/controls/choices.js +45 -0
- package/src/controls/color-field.js +217 -0
- package/src/controls/color-popover.js +135 -0
- package/src/controls/color-rgb.js +80 -0
- package/src/controls/color.js +67 -0
- package/src/controls/combobox.js +192 -0
- package/src/controls/dom.js +261 -0
- package/src/controls/icon-button.js +33 -0
- package/src/controls/index.d.ts +163 -0
- package/src/controls/index.js +182 -0
- package/src/controls/kinds-text.js +358 -0
- package/src/controls/kinds.lino +350 -0
- package/src/controls/label.js +52 -0
- package/src/controls/link.js +101 -0
- package/src/controls/listbox.js +144 -0
- package/src/controls/machines/button.lino +20 -0
- package/src/controls/machines/checkbox.lino +17 -0
- package/src/controls/machines/chip.lino +20 -0
- package/src/controls/machines/color-field.lino +23 -0
- package/src/controls/machines/combobox.lino +82 -0
- package/src/controls/machines/icon-button.lino +20 -0
- package/src/controls/machines/index.js +586 -0
- package/src/controls/machines/number-field.lino +71 -0
- package/src/controls/machines/radio-group.lino +17 -0
- package/src/controls/machines/select.lino +122 -0
- package/src/controls/machines/slider.lino +99 -0
- package/src/controls/machines/switch.lino +19 -0
- package/src/controls/machines/text-area.lino +26 -0
- package/src/controls/machines/text-field.lino +26 -0
- package/src/controls/number-field.js +239 -0
- package/src/controls/numeric-keys.js +125 -0
- package/src/controls/option.js +54 -0
- package/src/controls/progress.js +76 -0
- package/src/controls/radio-group.js +234 -0
- package/src/controls/select.js +229 -0
- package/src/controls/slider.js +234 -0
- package/src/controls/stories.js +172 -0
- package/src/controls/styles.css +1060 -0
- package/src/controls/switch.js +95 -0
- package/src/controls/text-area.js +39 -0
- package/src/controls/text-field.js +131 -0
- package/src/controls/vocabulary.js +164 -0
- package/src/data/data.css +95 -0
- package/src/data/index.d.ts +83 -0
- package/src/data/index.js +10 -0
- package/src/data/keyboard.js +189 -0
- package/src/data/list.js +215 -0
- package/src/data/render-data.js +116 -0
- package/src/data/selection-dom.js +39 -0
- package/src/data/selection-model.js +43 -0
- package/src/data/sort-model.js +42 -0
- package/src/data/source.js +45 -0
- package/src/data/table.js +160 -0
- package/src/data/tree-model.js +41 -0
- package/src/data/tree.js +55 -0
- package/src/data/viewport.js +216 -0
- package/src/data/virtual-range.js +92 -0
- package/src/data/vocabulary.js +67 -0
- package/src/diagrams/diagram-model.js +511 -0
- package/src/diagrams/diagram.js +204 -0
- package/src/diagrams/index.d.ts +225 -0
- package/src/diagrams/index.js +48 -0
- package/src/diagrams/layout-dagre.js +164 -0
- package/src/diagrams/layout-plugins.js +131 -0
- package/src/diagrams/mermaid-export.js +232 -0
- package/src/diagrams/mermaid-view.js +229 -0
- package/src/diagrams/svg-diagram.js +215 -0
- package/src/editor/code-editor.js +206 -0
- package/src/editor/documents-model.js +170 -0
- package/src/editor/documents-persistence.js +85 -0
- package/src/editor/editor-engine.js +22 -0
- package/src/editor/editor-ui.js +203 -0
- package/src/editor/editor.css +106 -0
- package/src/editor/engines/codemirror.js +227 -0
- package/src/editor/engines/monaco.js +219 -0
- package/src/editor/index.d.ts +111 -0
- package/src/editor/index.js +14 -0
- package/src/editor/lino-highlight.js +106 -0
- package/src/editor/lino-structure.js +85 -0
- package/src/editor/validate-lino.js +43 -0
- package/src/embed/README.md +161 -0
- package/src/embed/controller.js +223 -0
- package/src/embed/element.js +141 -0
- package/src/embed/index.d.ts +75 -0
- package/src/embed/index.js +9 -0
- package/src/embed/providers/telegram.d.ts +3 -0
- package/src/embed/providers/telegram.js +38 -0
- package/src/embed/providers/vk.d.ts +3 -0
- package/src/embed/providers/vk.js +42 -0
- package/src/embed/providers/x.d.ts +3 -0
- package/src/embed/providers/x.js +31 -0
- package/src/embed/registry.js +35 -0
- package/src/embed/script.js +73 -0
- package/src/embed/view.js +122 -0
- package/src/icons/adapters/lucide.d.ts +15 -0
- package/src/icons/adapters/lucide.js +142 -0
- package/src/icons/adapters/material-symbols.d.ts +13 -0
- package/src/icons/adapters/material-symbols.js +113 -0
- package/src/icons/adapters/shared.d.ts +38 -0
- package/src/icons/adapters/shared.js +157 -0
- package/src/icons/adapters/simple-icons.d.ts +9 -0
- package/src/icons/adapters/simple-icons.js +38 -0
- package/src/icons/adapters/tabler.d.ts +9 -0
- package/src/icons/adapters/tabler.js +86 -0
- package/src/icons/icon-registry.js +215 -0
- package/src/icons/icon.js +356 -0
- package/src/icons/index.d.ts +123 -0
- package/src/icons/index.js +30 -0
- package/src/icons/names.js +51 -0
- package/src/icons/own-icons.js +521 -0
- package/src/icons/presentation.js +55 -0
- package/src/icons/svg.js +136 -0
- package/src/index.d.ts +14 -0
- package/src/index.js +40 -0
- package/src/layout/README.md +102 -0
- package/src/layout/app-shell.js +150 -0
- package/src/layout/catalog.lino +27 -0
- package/src/layout/dock-model.js +576 -0
- package/src/layout/dock-view.js +312 -0
- package/src/layout/dock.js +352 -0
- package/src/layout/dom.js +312 -0
- package/src/layout/grid.js +192 -0
- package/src/layout/index.d.ts +267 -0
- package/src/layout/index.js +60 -0
- package/src/layout/layer-manager.js +120 -0
- package/src/layout/layout.css +760 -0
- package/src/layout/menu.js +141 -0
- package/src/layout/nav-strip.js +174 -0
- package/src/layout/page-links.js +166 -0
- package/src/layout/panel.js +26 -0
- package/src/layout/pref-switches.js +209 -0
- package/src/layout/split-model.js +270 -0
- package/src/layout/split.js +430 -0
- package/src/layout/stack.js +86 -0
- package/src/layout/surfaces.js +119 -0
- package/src/layout/tab-group.js +151 -0
- package/src/layout/tab-strip.js +277 -0
- package/src/layout/vocabulary.js +229 -0
- package/src/layout/window-frame.js +222 -0
- package/src/layout/window.js +146 -0
- package/src/links-view/animator.js +144 -0
- package/src/links-view/configuration-classes.js +150 -0
- package/src/links-view/configuration-model.js +191 -0
- package/src/links-view/configuration-notations.js +230 -0
- package/src/links-view/configurations.d.ts +73 -0
- package/src/links-view/configurations.js +33 -0
- package/src/links-view/create-layout-runner.js +79 -0
- package/src/links-view/doublet-curves.js +239 -0
- package/src/links-view/doublet-layout.js +148 -0
- package/src/links-view/doublet-markers.js +109 -0
- package/src/links-view/doublet-options.js +369 -0
- package/src/links-view/doublet-svg.js +156 -0
- package/src/links-view/doublet.js +230 -0
- package/src/links-view/export.js +146 -0
- package/src/links-view/geometry.js +409 -0
- package/src/links-view/index.d.ts +1029 -0
- package/src/links-view/index.js +140 -0
- package/src/links-view/labels.js +28 -0
- package/src/links-view/layout-worker-entry.mjs +2 -0
- package/src/links-view/layout-worker.js +28 -0
- package/src/links-view/layouts/circle.js +7 -0
- package/src/links-view/layouts/force.js +76 -0
- package/src/links-view/layouts/grid.js +7 -0
- package/src/links-view/layouts/hex.js +8 -0
- package/src/links-view/layouts/index.js +15 -0
- package/src/links-view/layouts/layered.js +29 -0
- package/src/links-view/layouts/regular.js +27 -0
- package/src/links-view/layouts/spiral.js +10 -0
- package/src/links-view/link-view.js +494 -0
- package/src/links-view/links-gallery.js +306 -0
- package/src/links-view/links-network.js +496 -0
- package/src/links-view/lino-network-source.js +122 -0
- package/src/links-view/lino-network.js +233 -0
- package/src/links-view/lino-to-network.js +252 -0
- package/src/links-view/markers.js +192 -0
- package/src/links-view/model.js +233 -0
- package/src/links-view/network-editor/dom.js +36 -0
- package/src/links-view/network-editor/editor.js +202 -0
- package/src/links-view/network-editor/model.js +163 -0
- package/src/links-view/network-editor/options.js +265 -0
- package/src/links-view/network-editor/panels.js +423 -0
- package/src/links-view/network-editor/presets.js +76 -0
- package/src/links-view/network-editor/provider.js +93 -0
- package/src/links-view/network-editor/remap.js +45 -0
- package/src/links-view/network-editor/schema.js +224 -0
- package/src/links-view/network-editor/share.js +232 -0
- package/src/links-view/network-editor/styles.js +19 -0
- package/src/links-view/network-editor/url-sync.js +131 -0
- package/src/links-view/network-interaction.js +228 -0
- package/src/links-view/network-model.js +85 -0
- package/src/links-view/network-renderer.js +259 -0
- package/src/links-view/network-scene.js +245 -0
- package/src/links-view/network-source.js +82 -0
- package/src/links-view/network-vocabulary.js +18 -0
- package/src/links-view/presentation.js +199 -0
- package/src/links-view/render-canvas.js +102 -0
- package/src/links-view/render-svg.js +118 -0
- package/src/links-view/scene.js +233 -0
- package/src/links-view/solver-job.js +106 -0
- package/src/links-view/tokens.js +114 -0
- package/src/links-view/zoom-pan.js +203 -0
- package/src/overlays/catalog.lino +89 -0
- package/src/overlays/context-menu.js +110 -0
- package/src/overlays/dialog.js +117 -0
- package/src/overlays/dom.js +168 -0
- package/src/overlays/drawer.js +8 -0
- package/src/overlays/index.d.ts +80 -0
- package/src/overlays/index.js +25 -0
- package/src/overlays/kinds.lino +137 -0
- package/src/overlays/list-popover.js +129 -0
- package/src/overlays/machines/index.js +71 -0
- package/src/overlays/machines/surface.lino +11 -0
- package/src/overlays/machines/tabs.lino +7 -0
- package/src/overlays/machines/toast.lino +16 -0
- package/src/overlays/machines/tooltip.lino +29 -0
- package/src/overlays/menu.js +240 -0
- package/src/overlays/popover.js +194 -0
- package/src/overlays/position.js +84 -0
- package/src/overlays/radial-geometry.js +38 -0
- package/src/overlays/radial-menu.js +50 -0
- package/src/overlays/styles.css +155 -0
- package/src/overlays/tabs.js +125 -0
- package/src/overlays/toast-queue.js +105 -0
- package/src/overlays/toast.js +163 -0
- package/src/overlays/tooltip.js +110 -0
- package/src/overlays/vocabulary.js +3 -0
- package/src/settings/conditions.js +44 -0
- package/src/settings/control-for.js +62 -0
- package/src/settings/field-control.js +201 -0
- package/src/settings/index.d.ts +201 -0
- package/src/settings/index.js +3 -0
- package/src/settings/messages.js +112 -0
- package/src/settings/miniature.js +26 -0
- package/src/settings/panel-actions.js +234 -0
- package/src/settings/panel-model.js +49 -0
- package/src/settings/panel-refresh.js +56 -0
- package/src/settings/panel-rows.js +200 -0
- package/src/settings/preset-cards.js +43 -0
- package/src/settings/saved-looks.js +227 -0
- package/src/settings/section-layout.js +95 -0
- package/src/settings/section-tabs.js +175 -0
- package/src/settings/settings-panel.js +192 -0
- package/src/settings/settings.css +178 -0
- package/stories/accordion.lino +14 -0
- package/stories/alert-dialog.lino +4 -0
- package/stories/app-bar.lino +10 -0
- package/stories/avatar.lino +7 -0
- package/stories/badge.lino +12 -0
- package/stories/button.lino +17 -0
- package/stories/card.lino +10 -0
- package/stories/checkbox.lino +14 -0
- package/stories/chip.lino +19 -0
- package/stories/color-field.lino +9 -0
- package/stories/combobox.lino +10 -0
- package/stories/container.lino +11 -0
- package/stories/context-menu.lino +15 -0
- package/stories/dialog.lino +16 -0
- package/stories/drawer.lino +12 -0
- package/stories/icon-button.lino +13 -0
- package/stories/label.lino +7 -0
- package/stories/link-cards.lino +9 -0
- package/stories/link.lino +9 -0
- package/stories/menu-item.lino +6 -0
- package/stories/menu-separator.lino +7 -0
- package/stories/menu.lino +30 -0
- package/stories/nav-strip.lino +11 -0
- package/stories/number-field.lino +16 -0
- package/stories/option.lino +10 -0
- package/stories/paper.lino +11 -0
- package/stories/popover.lino +4 -0
- package/stories/pref-switches.lino +4 -0
- package/stories/progress.lino +14 -0
- package/stories/radial-menu.lino +19 -0
- package/stories/radio-group.lino +22 -0
- package/stories/radio.lino +10 -0
- package/stories/section-nav.lino +9 -0
- package/stories/select.lino +16 -0
- package/stories/slider.lino +14 -0
- package/stories/switch.lino +10 -0
- package/stories/tab-panel.lino +7 -0
- package/stories/tab.lino +7 -0
- package/stories/tabs.lino +25 -0
- package/stories/text-area.lino +12 -0
- package/stories/text-field.lino +23 -0
- package/stories/titled-section.lino +7 -0
- package/stories/toast.lino +3 -0
- package/stories/toaster.lino +2 -0
- package/stories/tooltip.lino +3 -0
|
@@ -0,0 +1,240 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The optional ECharts renderer of the chart dialect, for `(renderer
|
|
3
|
+
* echarts)`.
|
|
4
|
+
*
|
|
5
|
+
* `toEChartsOption(spec)` is pure: it turns a chart spec into an ECharts
|
|
6
|
+
* option object (no functions, so it is plain data and can be compared in
|
|
7
|
+
* tests). `renderECharts` loads ECharts with a dynamic `import('echarts')`
|
|
8
|
+
* only when called, so ECharts (an optional peer dependency) is never part
|
|
9
|
+
* of a page that does not use `(renderer echarts)`.
|
|
10
|
+
*
|
|
11
|
+
* The series and their data follow the order of `layoutChart`, so the
|
|
12
|
+
* keyboard points of `<ui-chart>` map to `(seriesIndex, dataIndex)`.
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
import { supportsECharts } from './renderer-features.js';
|
|
16
|
+
import { layoutChart } from './layout.js';
|
|
17
|
+
import {
|
|
18
|
+
continuousValue,
|
|
19
|
+
discreteDomain,
|
|
20
|
+
fieldTitle,
|
|
21
|
+
isDiscrete,
|
|
22
|
+
sizeScale,
|
|
23
|
+
} from './scales.js';
|
|
24
|
+
import { chartLabel } from './summary.js';
|
|
25
|
+
import { CHART_TOKENS, SERIES_COUNT, seriesToken } from './tokens.js';
|
|
26
|
+
|
|
27
|
+
/** The ECharts axis type of a field. */
|
|
28
|
+
function axisType(def) {
|
|
29
|
+
if (isDiscrete(def)) {
|
|
30
|
+
return 'category';
|
|
31
|
+
}
|
|
32
|
+
return def.type === 'temporal' ? 'time' : 'value';
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/** An axis option of a field. */
|
|
36
|
+
function axisOption(def, rows, colors, zero) {
|
|
37
|
+
const type = axisType(def);
|
|
38
|
+
return {
|
|
39
|
+
type,
|
|
40
|
+
name: fieldTitle(def),
|
|
41
|
+
nameLocation: 'middle',
|
|
42
|
+
nameGap: 32,
|
|
43
|
+
...(type === 'category' ? { data: discreteDomain(def, rows) } : {}),
|
|
44
|
+
...(type === 'value' ? { scale: !zero } : {}),
|
|
45
|
+
axisLine: { lineStyle: { color: colors.axis } },
|
|
46
|
+
axisLabel: { color: colors.muted },
|
|
47
|
+
nameTextStyle: { color: colors.text },
|
|
48
|
+
splitLine: { lineStyle: { color: colors.grid } },
|
|
49
|
+
};
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/** The value of a field on an ECharts axis. */
|
|
53
|
+
const axisValue = (def, value) =>
|
|
54
|
+
isDiscrete(def) ? String(value) : continuousValue(def, value);
|
|
55
|
+
|
|
56
|
+
const SERIES_TYPES = {
|
|
57
|
+
line: 'line',
|
|
58
|
+
area: 'line',
|
|
59
|
+
bar: 'bar',
|
|
60
|
+
point: 'scatter',
|
|
61
|
+
};
|
|
62
|
+
|
|
63
|
+
/** The style options of a mark. */
|
|
64
|
+
function markOptions(spec, stacked) {
|
|
65
|
+
const { mark } = spec;
|
|
66
|
+
return {
|
|
67
|
+
...(mark.type === 'area' ? { areaStyle: { opacity: 0.35 } } : {}),
|
|
68
|
+
...(mark.type === 'line' || mark.type === 'area'
|
|
69
|
+
? {
|
|
70
|
+
showSymbol: mark.point,
|
|
71
|
+
smooth: mark.interpolate === 'monotone',
|
|
72
|
+
...(mark.interpolate === 'step' ? { step: 'end' } : {}),
|
|
73
|
+
}
|
|
74
|
+
: {}),
|
|
75
|
+
...(stacked ? { stack: 'total' } : {}),
|
|
76
|
+
};
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
function cartesianSeries(spec, layout, colors) {
|
|
80
|
+
const { x, y, size } = spec.encoding;
|
|
81
|
+
const rows = spec.data.values;
|
|
82
|
+
const radius = sizeScale(size, rows);
|
|
83
|
+
const stacked =
|
|
84
|
+
(spec.mark.type === 'bar' || spec.mark.type === 'area') &&
|
|
85
|
+
spec.encoding.color !== undefined;
|
|
86
|
+
return layout.series.map((series, s) => ({
|
|
87
|
+
type: SERIES_TYPES[spec.mark.type],
|
|
88
|
+
name: series.key ?? fieldTitle(y),
|
|
89
|
+
itemStyle: { color: colors.series[s % SERIES_COUNT] },
|
|
90
|
+
...markOptions(spec, stacked),
|
|
91
|
+
data: series.points.map((point) => {
|
|
92
|
+
const row = rows[point.row];
|
|
93
|
+
return {
|
|
94
|
+
name: point.text,
|
|
95
|
+
value: [axisValue(x, row[x.field]), axisValue(y, row[y.field])],
|
|
96
|
+
...(size === undefined
|
|
97
|
+
? {}
|
|
98
|
+
: { symbolSize: Math.round(radius(row[size.field]) * 2) }),
|
|
99
|
+
};
|
|
100
|
+
}),
|
|
101
|
+
}));
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
function arcSeries(spec, layout, colors) {
|
|
105
|
+
const { theta, color } = spec.encoding;
|
|
106
|
+
const rows = spec.data.values;
|
|
107
|
+
const domain = color === undefined ? [] : discreteDomain(color, rows);
|
|
108
|
+
const radius = Math.min(layout.plot.width, layout.plot.height) / 2;
|
|
109
|
+
return [
|
|
110
|
+
{
|
|
111
|
+
type: 'pie',
|
|
112
|
+
name: fieldTitle(theta),
|
|
113
|
+
radius: [spec.mark.innerRadius, Math.round(radius)],
|
|
114
|
+
label: { color: colors.text },
|
|
115
|
+
data: layout.series[0].points.map((point, i) => {
|
|
116
|
+
const row = rows[point.row];
|
|
117
|
+
const index =
|
|
118
|
+
color === undefined
|
|
119
|
+
? i
|
|
120
|
+
: Math.max(0, domain.indexOf(String(row[color.field])));
|
|
121
|
+
return {
|
|
122
|
+
name: color === undefined ? point.text : String(row[color.field]),
|
|
123
|
+
value: Number(row[theta.field]),
|
|
124
|
+
tooltip: { formatter: point.text },
|
|
125
|
+
itemStyle: { color: colors.series[index % SERIES_COUNT] },
|
|
126
|
+
};
|
|
127
|
+
}),
|
|
128
|
+
},
|
|
129
|
+
];
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
/** The colours of a mode as literal values (ECharts cannot read CSS vars). */
|
|
133
|
+
function modeColors(theme) {
|
|
134
|
+
const tokens = CHART_TOKENS[theme] ?? CHART_TOKENS.light;
|
|
135
|
+
return {
|
|
136
|
+
series: Array.from(
|
|
137
|
+
{ length: SERIES_COUNT },
|
|
138
|
+
(_, i) => tokens[seriesToken(i)]
|
|
139
|
+
),
|
|
140
|
+
background: tokens['color.chart.background'],
|
|
141
|
+
text: tokens['color.chart.text'],
|
|
142
|
+
muted: tokens['color.chart.muted'],
|
|
143
|
+
axis: tokens['color.chart.axis'],
|
|
144
|
+
grid: tokens['color.chart.grid'],
|
|
145
|
+
};
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
/**
|
|
149
|
+
* The ECharts option of a chart spec: pure and deterministic.
|
|
150
|
+
* @param {import('./chart-model.js').ChartSpec} spec
|
|
151
|
+
* @param {{theme?: 'light'|'dark', width?: number, height?: number}} [options]
|
|
152
|
+
* @returns {object}
|
|
153
|
+
*/
|
|
154
|
+
export function toEChartsOption(spec, options = {}) {
|
|
155
|
+
if (spec.kind !== 'chart') {
|
|
156
|
+
throw new TypeError(`ECharts renders (chart ...) links, not ${spec.kind}`);
|
|
157
|
+
}
|
|
158
|
+
if (!supportsECharts(spec)) {
|
|
159
|
+
throw new TypeError(
|
|
160
|
+
'Activity features require the SVG renderer; use renderChartSvg or ui-chart'
|
|
161
|
+
);
|
|
162
|
+
}
|
|
163
|
+
const colors = modeColors(options.theme ?? 'light');
|
|
164
|
+
const layout = layoutChart(spec, options);
|
|
165
|
+
const arc = spec.mark.type === 'arc';
|
|
166
|
+
const legend =
|
|
167
|
+
spec.encoding.color === undefined
|
|
168
|
+
? {}
|
|
169
|
+
: {
|
|
170
|
+
legend: {
|
|
171
|
+
top: spec.title ? 28 : 4,
|
|
172
|
+
textStyle: { color: colors.text },
|
|
173
|
+
},
|
|
174
|
+
};
|
|
175
|
+
const option = {
|
|
176
|
+
animation: false,
|
|
177
|
+
backgroundColor: colors.background,
|
|
178
|
+
color: colors.series,
|
|
179
|
+
textStyle: { color: colors.text },
|
|
180
|
+
aria: { enabled: true, label: { description: chartLabel(spec) } },
|
|
181
|
+
...(spec.title
|
|
182
|
+
? { title: { text: spec.title, textStyle: { color: colors.text } } }
|
|
183
|
+
: {}),
|
|
184
|
+
tooltip: { trigger: 'item', formatter: '{b}' },
|
|
185
|
+
...legend,
|
|
186
|
+
series: arc
|
|
187
|
+
? arcSeries(spec, layout, colors)
|
|
188
|
+
: cartesianSeries(spec, layout, colors),
|
|
189
|
+
};
|
|
190
|
+
if (!arc) {
|
|
191
|
+
const filled = spec.mark.type === 'bar' || spec.mark.type === 'area';
|
|
192
|
+
const horizontal = spec.mark.type === 'bar' && isDiscrete(spec.encoding.y);
|
|
193
|
+
const rows = spec.data.values;
|
|
194
|
+
option.grid = {
|
|
195
|
+
left: layout.plot.x,
|
|
196
|
+
top: layout.plot.y,
|
|
197
|
+
width: layout.plot.width,
|
|
198
|
+
height: layout.plot.height,
|
|
199
|
+
};
|
|
200
|
+
option.xAxis = axisOption(
|
|
201
|
+
spec.encoding.x,
|
|
202
|
+
rows,
|
|
203
|
+
colors,
|
|
204
|
+
filled && horizontal
|
|
205
|
+
);
|
|
206
|
+
option.yAxis = axisOption(
|
|
207
|
+
spec.encoding.y,
|
|
208
|
+
rows,
|
|
209
|
+
colors,
|
|
210
|
+
filled && !horizontal
|
|
211
|
+
);
|
|
212
|
+
}
|
|
213
|
+
return option;
|
|
214
|
+
}
|
|
215
|
+
|
|
216
|
+
/**
|
|
217
|
+
* Render a chart spec with ECharts into a container, loading ECharts on
|
|
218
|
+
* first use.
|
|
219
|
+
* @param {HTMLElement} container sized to the chart
|
|
220
|
+
* @param {import('./chart-model.js').ChartSpec} spec
|
|
221
|
+
* @param {object} [options]
|
|
222
|
+
* @param {() => Promise<object>} [options.loadECharts] default `import('echarts')`
|
|
223
|
+
* @param {'light'|'dark'} [options.theme]
|
|
224
|
+
* @param {number} [options.width]
|
|
225
|
+
* @param {number} [options.height]
|
|
226
|
+
* @returns {Promise<{instance: object, option: object}>}
|
|
227
|
+
*/
|
|
228
|
+
export async function renderECharts(container, spec, options = {}) {
|
|
229
|
+
const load = options.loadECharts ?? (() => import('echarts'));
|
|
230
|
+
const module = await load();
|
|
231
|
+
const echarts = module.init === undefined ? module.default : module;
|
|
232
|
+
const option = toEChartsOption(spec, options);
|
|
233
|
+
const instance = echarts.init(container, null, {
|
|
234
|
+
renderer: 'svg',
|
|
235
|
+
width: options.width ?? spec.width ?? undefined,
|
|
236
|
+
height: options.height ?? spec.height ?? undefined,
|
|
237
|
+
});
|
|
238
|
+
instance.setOption(option);
|
|
239
|
+
return { instance, option };
|
|
240
|
+
}
|
|
@@ -0,0 +1,330 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The shared base of the chart custom elements (`<ui-chart>`,
|
|
3
|
+
* `<ui-stat-tile>`, `<ui-gauge>`, `<ui-sparkline>`): where the spec comes
|
|
4
|
+
* from, the chart style sheet, the data table twin and error reporting.
|
|
5
|
+
*
|
|
6
|
+
* The elements render into their light DOM, so page styles and the token
|
|
7
|
+
* custom properties apply. Every element is built for a given window (a
|
|
8
|
+
* browser window, or a jsdom window in tests), so nothing touches globals.
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
import { drawTagCloud } from './tag-cloud.js';
|
|
12
|
+
import { chartFromLinks, chartToLino, parseChart } from './chart-model.js';
|
|
13
|
+
import { atomNode, formatNode, parseLino, prop } from './lino.js';
|
|
14
|
+
import { renderSmallChartSvg } from './small-svg.js';
|
|
15
|
+
import { chartTable } from './summary.js';
|
|
16
|
+
import { CHART_CSS } from './tokens.js';
|
|
17
|
+
|
|
18
|
+
/** The `<script>` type of an inline spec: `<script type="text/lino">`. */
|
|
19
|
+
export const LINO_SCRIPT_TYPE = 'text/lino';
|
|
20
|
+
|
|
21
|
+
const counters = new WeakMap();
|
|
22
|
+
|
|
23
|
+
/** An ID that is unique in the document: `ui-chart-1`, `ui-chart-2`... */
|
|
24
|
+
export function uniqueId(document, prefix = 'ui-chart') {
|
|
25
|
+
const next = (counters.get(document) ?? 0) + 1;
|
|
26
|
+
counters.set(document, next);
|
|
27
|
+
return `${prefix}-${next}`;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/** Add the chart style sheet to the document once. */
|
|
31
|
+
export function ensureChartStyles(document) {
|
|
32
|
+
if (document.querySelector('style[data-ui-chart]') !== null) {
|
|
33
|
+
return;
|
|
34
|
+
}
|
|
35
|
+
const style = document.createElement('style');
|
|
36
|
+
style.setAttribute('data-ui-chart', '');
|
|
37
|
+
style.textContent = CHART_CSS;
|
|
38
|
+
(document.head ?? document.documentElement).append(style);
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* The data table twin of a chart: a caption, column headers, and one row
|
|
43
|
+
* per data row. Built with DOM methods, so every value is text.
|
|
44
|
+
* @param {Document} document
|
|
45
|
+
* @param {object} spec
|
|
46
|
+
* @param {string} id
|
|
47
|
+
*/
|
|
48
|
+
export function createTable(document, spec, id) {
|
|
49
|
+
const { caption, columns, numeric, rows } = chartTable(spec);
|
|
50
|
+
const table = document.createElement('table');
|
|
51
|
+
table.id = id;
|
|
52
|
+
table.className = 'ui-chart-table';
|
|
53
|
+
table.setAttribute('role', 'table');
|
|
54
|
+
const captionEl = document.createElement('caption');
|
|
55
|
+
captionEl.textContent = caption;
|
|
56
|
+
const head = document.createElement('thead');
|
|
57
|
+
const headRow = document.createElement('tr');
|
|
58
|
+
for (const column of columns) {
|
|
59
|
+
const th = document.createElement('th');
|
|
60
|
+
th.scope = 'col';
|
|
61
|
+
th.textContent = column;
|
|
62
|
+
headRow.append(th);
|
|
63
|
+
}
|
|
64
|
+
head.append(headRow);
|
|
65
|
+
const body = document.createElement('tbody');
|
|
66
|
+
for (const row of rows) {
|
|
67
|
+
const tr = document.createElement('tr');
|
|
68
|
+
row.forEach((value, i) => {
|
|
69
|
+
const td = document.createElement('td');
|
|
70
|
+
td.textContent = value;
|
|
71
|
+
if (numeric[i]) {
|
|
72
|
+
td.style.textAlign = 'end';
|
|
73
|
+
}
|
|
74
|
+
tr.append(td);
|
|
75
|
+
});
|
|
76
|
+
body.append(tr);
|
|
77
|
+
}
|
|
78
|
+
table.append(captionEl, head, body);
|
|
79
|
+
return table;
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
/** A `<div>` with a class name. */
|
|
83
|
+
export function div(document, className) {
|
|
84
|
+
const el = document.createElement('div');
|
|
85
|
+
el.className = className;
|
|
86
|
+
return el;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/**
|
|
90
|
+
* The base class of the chart elements in a window. Subclasses set
|
|
91
|
+
* `static kinds` (the chart kinds they show) and implement `draw(spec)`,
|
|
92
|
+
* which returns the nodes to show.
|
|
93
|
+
* @param {Window} win
|
|
94
|
+
*/
|
|
95
|
+
export function createChartElementClass(win) {
|
|
96
|
+
return class ChartElement extends win.HTMLElement {
|
|
97
|
+
/** @type {string[]|null} the kinds this element shows; null: any */
|
|
98
|
+
static kinds = null;
|
|
99
|
+
|
|
100
|
+
#lino = null;
|
|
101
|
+
#spec = null;
|
|
102
|
+
#rendered = null;
|
|
103
|
+
#output = [];
|
|
104
|
+
|
|
105
|
+
/** The LiNo text of the chart; setting it renders the element again. */
|
|
106
|
+
get lino() {
|
|
107
|
+
return this.#lino ?? this.inlineLino();
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
set lino(text) {
|
|
111
|
+
this.#lino = text === null ? null : String(text);
|
|
112
|
+
this.#spec = null;
|
|
113
|
+
this.update();
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
/** The normalised spec shown (`null` before the first render). */
|
|
117
|
+
get spec() {
|
|
118
|
+
return this.#rendered;
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
/** Show a spec object (as `chartFromLinks` returns). */
|
|
122
|
+
set spec(spec) {
|
|
123
|
+
this.#spec = spec;
|
|
124
|
+
this.#lino = null;
|
|
125
|
+
this.update();
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
connectedCallback() {
|
|
129
|
+
if (this.#rendered === null) {
|
|
130
|
+
this.update();
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
/** The text of the inline `<script type="text/lino">` child, or null. */
|
|
135
|
+
inlineLino() {
|
|
136
|
+
const script = [...this.children].find(
|
|
137
|
+
(child) =>
|
|
138
|
+
child.localName === 'script' &&
|
|
139
|
+
child.getAttribute('type') === LINO_SCRIPT_TYPE
|
|
140
|
+
);
|
|
141
|
+
return script === undefined ? null : script.textContent;
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
/** LiNo text built from the attributes (small charts), or null. */
|
|
145
|
+
attributeLino() {
|
|
146
|
+
return null;
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
/** The spec to show, read and checked by the chart model. */
|
|
150
|
+
readSpec() {
|
|
151
|
+
if (this.#spec !== null) {
|
|
152
|
+
// Normalise (and check) a spec object by writing and reading it.
|
|
153
|
+
const normalized = parseChart(chartToLino(this.#spec));
|
|
154
|
+
if (this.#spec.tooltip?.content) {
|
|
155
|
+
normalized.tooltip = {
|
|
156
|
+
...normalized.tooltip,
|
|
157
|
+
content: this.#spec.tooltip.content,
|
|
158
|
+
};
|
|
159
|
+
}
|
|
160
|
+
return normalized;
|
|
161
|
+
}
|
|
162
|
+
const text = this.lino ?? this.attributeLino();
|
|
163
|
+
if (text === null) {
|
|
164
|
+
return null;
|
|
165
|
+
}
|
|
166
|
+
const spec = chartFromLinks(parseLino(text));
|
|
167
|
+
const { kinds } = this.constructor;
|
|
168
|
+
if (kinds !== null && !kinds.includes(spec.kind)) {
|
|
169
|
+
throw new TypeError(
|
|
170
|
+
`<${this.localName}> shows ${kinds.join(', ')}, not ${spec.kind}`
|
|
171
|
+
);
|
|
172
|
+
}
|
|
173
|
+
return spec;
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
/** Render the element again from its current source. */
|
|
177
|
+
update() {
|
|
178
|
+
const document = this.ownerDocument;
|
|
179
|
+
ensureChartStyles(document);
|
|
180
|
+
this.#output.forEach((node) => node.remove());
|
|
181
|
+
let spec;
|
|
182
|
+
try {
|
|
183
|
+
spec = this.readSpec();
|
|
184
|
+
} catch (error) {
|
|
185
|
+
this.#rendered = null;
|
|
186
|
+
this.show([this.errorNode(error)]);
|
|
187
|
+
this.dispatchEvent(
|
|
188
|
+
new win.CustomEvent('chart-error', { detail: error, bubbles: true })
|
|
189
|
+
);
|
|
190
|
+
return;
|
|
191
|
+
}
|
|
192
|
+
this.#rendered = spec;
|
|
193
|
+
this.show(spec === null ? [] : this.draw(spec));
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
/** Append the rendered nodes, remembering them for the next update. */
|
|
197
|
+
show(nodes) {
|
|
198
|
+
this.#output = nodes;
|
|
199
|
+
this.append(...nodes);
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
/** The message of a spec that cannot be shown. */
|
|
203
|
+
errorNode(error) {
|
|
204
|
+
const p = this.ownerDocument.createElement('p');
|
|
205
|
+
p.className = 'ui-chart-error';
|
|
206
|
+
p.setAttribute('role', 'alert');
|
|
207
|
+
p.textContent = `Chart error: ${error.message}`;
|
|
208
|
+
return p;
|
|
209
|
+
}
|
|
210
|
+
|
|
211
|
+
/**
|
|
212
|
+
* The nodes of a spec.
|
|
213
|
+
* @param {object} spec
|
|
214
|
+
* @returns {Node[]}
|
|
215
|
+
*/
|
|
216
|
+
// eslint-disable-next-line no-unused-vars
|
|
217
|
+
draw(spec) {
|
|
218
|
+
return [];
|
|
219
|
+
}
|
|
220
|
+
};
|
|
221
|
+
}
|
|
222
|
+
|
|
223
|
+
/**
|
|
224
|
+
* Define a custom element in a window unless the tag is taken.
|
|
225
|
+
* @param {Window} win
|
|
226
|
+
* @param {string} tag
|
|
227
|
+
* @param {(win: Window) => CustomElementConstructor} create
|
|
228
|
+
*/
|
|
229
|
+
export function defineElement(win, tag, create) {
|
|
230
|
+
const registry = win?.customElements;
|
|
231
|
+
if (registry === undefined) {
|
|
232
|
+
throw new TypeError('defineChartElements needs a window');
|
|
233
|
+
}
|
|
234
|
+
const existing = registry.get(tag);
|
|
235
|
+
if (existing !== undefined) {
|
|
236
|
+
return existing;
|
|
237
|
+
}
|
|
238
|
+
const constructor = create(win);
|
|
239
|
+
registry.define(tag, constructor);
|
|
240
|
+
return constructor;
|
|
241
|
+
}
|
|
242
|
+
|
|
243
|
+
/**
|
|
244
|
+
* LiNo text of a small chart from element attributes: `(id: kind (name
|
|
245
|
+
* value...) ...)`. Written with the links-notation writer, so attribute
|
|
246
|
+
* values are escaped, and read back by the chart model, which checks them.
|
|
247
|
+
* @param {Element} element
|
|
248
|
+
* @param {string} kind
|
|
249
|
+
* @param {string[]} names the attributes, in order
|
|
250
|
+
* @param {string[]} [lists] the attributes that hold numbers split by spaces
|
|
251
|
+
* @returns {string|null} null when none of the attributes is set
|
|
252
|
+
*/
|
|
253
|
+
export function attributesLino(element, kind, names, lists = []) {
|
|
254
|
+
const props = names
|
|
255
|
+
.filter((name) => element.hasAttribute(name))
|
|
256
|
+
.map((name) => {
|
|
257
|
+
const value = element.getAttribute(name);
|
|
258
|
+
return lists.includes(name)
|
|
259
|
+
? prop(name, ...value.split(/\s+/u).filter(Boolean))
|
|
260
|
+
: prop(name, value);
|
|
261
|
+
});
|
|
262
|
+
if (props.length === 0) {
|
|
263
|
+
return null;
|
|
264
|
+
}
|
|
265
|
+
const id = element.id === '' ? kind : element.id;
|
|
266
|
+
return formatNode({ id, values: [atomNode(kind), ...props] });
|
|
267
|
+
}
|
|
268
|
+
|
|
269
|
+
/**
|
|
270
|
+
* A small chart (stat tile, gauge, sparkline): its SVG and a visually
|
|
271
|
+
* hidden data table twin in a box.
|
|
272
|
+
* @param {Document} document
|
|
273
|
+
* @param {object} spec
|
|
274
|
+
* @param {string} [className]
|
|
275
|
+
* @param {string} [tag]
|
|
276
|
+
*/
|
|
277
|
+
export function drawSmallChart(
|
|
278
|
+
document,
|
|
279
|
+
spec,
|
|
280
|
+
className = `ui-${spec.kind}`,
|
|
281
|
+
tag = 'div'
|
|
282
|
+
) {
|
|
283
|
+
const box = document.createElement(tag);
|
|
284
|
+
box.className = className;
|
|
285
|
+
if (spec.kind === 'tag-cloud') {
|
|
286
|
+
box.append(drawTagCloud(document, spec));
|
|
287
|
+
} else {
|
|
288
|
+
box.innerHTML = renderSmallChartSvg(spec);
|
|
289
|
+
}
|
|
290
|
+
if (spec.footnote) {
|
|
291
|
+
const link = document.createElement('a');
|
|
292
|
+
link.textContent = spec.footnote.label;
|
|
293
|
+
link.href = spec.footnote.href;
|
|
294
|
+
box.append(link);
|
|
295
|
+
}
|
|
296
|
+
const table = createTable(document, spec, uniqueId(document));
|
|
297
|
+
table.classList.add('ui-visually-hidden');
|
|
298
|
+
box.append(table);
|
|
299
|
+
return box;
|
|
300
|
+
}
|
|
301
|
+
|
|
302
|
+
/**
|
|
303
|
+
* The class of a small chart element (`<ui-stat-tile>`, `<ui-gauge>`,
|
|
304
|
+
* `<ui-sparkline>`): its SVG (`role="img"` with an accessible name) and a
|
|
305
|
+
* visually hidden data table twin.
|
|
306
|
+
* @param {Window} win
|
|
307
|
+
* @param {{kind: string, className: string, names: string[], lists?: string[], tag?: string}} options
|
|
308
|
+
*/
|
|
309
|
+
export function createSmallChartClass(win, options) {
|
|
310
|
+
const { kind, className, names, lists = [], tag = 'div' } = options;
|
|
311
|
+
return class SmallChartElement extends createChartElementClass(win) {
|
|
312
|
+
static kinds = [kind];
|
|
313
|
+
|
|
314
|
+
static observedAttributes = names;
|
|
315
|
+
|
|
316
|
+
attributeChangedCallback() {
|
|
317
|
+
if (this.isConnected) {
|
|
318
|
+
this.update();
|
|
319
|
+
}
|
|
320
|
+
}
|
|
321
|
+
|
|
322
|
+
attributeLino() {
|
|
323
|
+
return attributesLino(this, kind, names, lists);
|
|
324
|
+
}
|
|
325
|
+
|
|
326
|
+
draw(spec) {
|
|
327
|
+
return [drawSmallChart(this.ownerDocument, spec, className, tag)];
|
|
328
|
+
}
|
|
329
|
+
};
|
|
330
|
+
}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The error of a chart spec that cannot be read, with the position of the
|
|
3
|
+
* bad link so an author can find it.
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import { formatNode } from './lino.js';
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* The position of a link: its index path in the unfolded tree of the
|
|
10
|
+
* document (`[0, 3, 1]` is the second value of the fourth value of the
|
|
11
|
+
* first top-level link) and its LiNo text.
|
|
12
|
+
* @typedef {{ path: number[], link: string|null }} LinkPosition
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* A position of a node.
|
|
17
|
+
* @param {number[]} path
|
|
18
|
+
* @param {import('./lino.js').Node} [node]
|
|
19
|
+
* @returns {LinkPosition}
|
|
20
|
+
*/
|
|
21
|
+
export const at = (path, node) => ({
|
|
22
|
+
path: [...path],
|
|
23
|
+
link: node === undefined ? null : formatNode(node),
|
|
24
|
+
});
|
|
25
|
+
|
|
26
|
+
/** The position as text: `link 1 > 4 > 2: (mark pie)` (1-based). */
|
|
27
|
+
export function describePosition({ path, link }) {
|
|
28
|
+
const where =
|
|
29
|
+
path.length === 0
|
|
30
|
+
? 'document'
|
|
31
|
+
: `link ${path.map((i) => i + 1).join(' > ')}`;
|
|
32
|
+
return link === null ? where : `${where}: ${link}`;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/** A chart spec that cannot be read. */
|
|
36
|
+
export class ChartSpecError extends Error {
|
|
37
|
+
/**
|
|
38
|
+
* @param {string} code a stable machine-readable reason (`unknown-mark`)
|
|
39
|
+
* @param {string} reason the human-readable reason
|
|
40
|
+
* @param {LinkPosition} position where the bad link is
|
|
41
|
+
*/
|
|
42
|
+
constructor(code, reason, position) {
|
|
43
|
+
super(`${reason} (at ${describePosition(position)})`);
|
|
44
|
+
this.name = 'ChartSpecError';
|
|
45
|
+
this.code = code;
|
|
46
|
+
this.reason = reason;
|
|
47
|
+
this.path = position.path;
|
|
48
|
+
this.link = position.link;
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* Throw a ChartSpecError at a node.
|
|
54
|
+
* @param {string} code
|
|
55
|
+
* @param {string} reason
|
|
56
|
+
* @param {import('./lino.js').Node} node
|
|
57
|
+
* @param {number[]} path
|
|
58
|
+
* @returns {never}
|
|
59
|
+
*/
|
|
60
|
+
export function fail(code, reason, node, path) {
|
|
61
|
+
throw new ChartSpecError(code, reason, at(path, node));
|
|
62
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The `<ui-gauge>` element: a gauge chart (`(id: gauge ...)`) as SVG with
|
|
3
|
+
* `role="img"`, an accessible name and a visually hidden data table twin.
|
|
4
|
+
* The spec is an inline `<script type="text/lino">` child, the `lino` or
|
|
5
|
+
* `spec` property, or the attributes ('label', 'value', 'min', 'max', 'unit', 'description').
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
import { createSmallChartClass, defineElement } from './element.js';
|
|
9
|
+
|
|
10
|
+
/** The tag of the element. */
|
|
11
|
+
export const GAUGE_TAG = 'ui-gauge';
|
|
12
|
+
|
|
13
|
+
/**
|
|
14
|
+
* Define `<ui-gauge>` in a window, unless the tag is taken.
|
|
15
|
+
* @param {Window} [win]
|
|
16
|
+
* @returns {CustomElementConstructor}
|
|
17
|
+
*/
|
|
18
|
+
export const defineGaugeElement = (win = globalThis.window) =>
|
|
19
|
+
defineElement(win, GAUGE_TAG, (w) =>
|
|
20
|
+
createSmallChartClass(w, {
|
|
21
|
+
kind: 'gauge',
|
|
22
|
+
className: 'ui-gauge',
|
|
23
|
+
names: ['label', 'value', 'min', 'max', 'unit', 'description'],
|
|
24
|
+
lists: [],
|
|
25
|
+
tag: 'div',
|
|
26
|
+
})
|
|
27
|
+
);
|