@fusion.dev/helix 0.116.0 → 0.118.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/types/svelte.d.ts CHANGED
@@ -62,6 +62,7 @@ declare module 'svelte/elements' {
62
62
  'helix-filter-input': CustomElements['helix-filter-input']
63
63
  'helix-flex': CustomElements['helix-flex']
64
64
  'helix-format-date': CustomElements['helix-format-date']
65
+ 'helix-graph': CustomElements['helix-graph']
65
66
  'helix-grid': CustomElements['helix-grid']
66
67
  'helix-heatmap': CustomElements['helix-heatmap']
67
68
  'helix-icon-button': CustomElements['helix-icon-button']
package/types/vue.d.ts CHANGED
@@ -52,6 +52,7 @@ import type {
52
52
  HelixFilterInput,
53
53
  HelixFlex,
54
54
  HelixFormatDate,
55
+ HelixGraph,
55
56
  HelixGrid,
56
57
  HelixHeatmap,
57
58
  HelixIconButton,
@@ -185,10 +186,15 @@ import type {
185
186
  HelixReorderEvent,
186
187
  HelixSortEvent,
187
188
  HelixFacetEvent,
188
- HelixResizeEvent,
189
- HelixShortcutEvent,
190
189
  HelixActivateEvent,
191
190
  HelixBeforeActivateEvent,
191
+ HelixGraphLayoutEvent,
192
+ HelixGraphPanEvent,
193
+ HelixGraphPartChangeEvent,
194
+ HelixGraphReadyEvent,
195
+ HelixGraphZoomEvent,
196
+ HelixResizeEvent,
197
+ HelixShortcutEvent,
192
198
  HelixMapPartChangeEvent,
193
199
  HelixMapClusterEvent,
194
200
  HelixMapPanEvent,
@@ -1535,6 +1541,12 @@ Absent is no ruling, a resting value being an attribute's absence. */
1535
1541
  Framed is where it rests. Plain is for a board that fills a panel or an
1536
1542
  app's working area, where the container is already the frame. */
1537
1543
  separation?: (HelixCanvas["separation"]) | undefined;
1544
+ /** The hint shown when a surface waiting to be pressed is scrolled or
1545
+ swiped over, with `gestures="activate"`. Absent is the family's own. */
1546
+ "activate-hint-label"?: (HelixCanvas["activateHintLabel"]) | undefined;
1547
+ /** The hint shown when a surface waiting to be pressed is scrolled or
1548
+ swiped over, with `gestures="activate"`. Absent is the family's own. */
1549
+ activateHintLabel?: (HelixCanvas["activateHintLabel"]) | undefined;
1538
1550
  /** Which controls to show, as a list such as `pan zoom fullscreen`, or
1539
1551
  `none`. A family can add words of its own.
1540
1552
 
@@ -1599,6 +1611,26 @@ would write an attribute onto every host that no server sent. */
1599
1611
  "fullscreen-label"?: (HelixCanvas["fullscreenLabel"]) | undefined;
1600
1612
  /** The fullscreen button's label. */
1601
1613
  fullscreenLabel?: (HelixCanvas["fullscreenLabel"]) | undefined;
1614
+ /** Which gestures the surface takes from the page.
1615
+
1616
+ - `always`: the surface takes the wheel and one finger, for a surface
1617
+ that is the page, such as a full-screen view. A map rests here.
1618
+ - Unset is the family's own: `always` for a map, and for a board, a
1619
+ drag and a pinch, with the plain wheel left to the page until the
1620
+ board fills the screen.
1621
+ - `cooperative`: the wheel and one finger scroll the page, and the
1622
+ surface takes Ctrl or ⌘ with the wheel, and two fingers. The frame
1623
+ says so when a gesture passes to the page. Best for a surface embedded
1624
+ in a page.
1625
+ - `activate`: the surface takes nothing until it is pressed, and gives it
1626
+ back on Escape, when the pointer leaves it, or on a press elsewhere.
1627
+
1628
+ The keyboard and the frame's buttons work in every mode.
1629
+
1630
+ **Unreflected and without a default**, because a default that reflected
1631
+ would write an attribute onto every host that no server sent, and the
1632
+ hydration that followed would disagree with it. */
1633
+ gestures?: (HelixCanvas["gestures"]) | undefined;
1602
1634
  /** How long, in milliseconds, before the header and footer hide when the user is inactive. `0` keeps them visible.
1603
1635
 
1604
1636
  Zero keeps it up, which is the default: these controls are how a keyboard
@@ -1653,6 +1685,26 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
1653
1685
  "pan-up-label"?: (HelixCanvas["panUpLabel"]) | undefined;
1654
1686
  /** The pan up button's label. */
1655
1687
  panUpLabel?: (HelixCanvas["panUpLabel"]) | undefined;
1688
+ /** The hint shown when one finger swipes over a surface with
1689
+ `gestures="cooperative"`. Absent is the family's own. */
1690
+ "two-finger-hint-label"?: (HelixCanvas["twoFingerHintLabel"]) | undefined;
1691
+ /** The hint shown when one finger swipes over a surface with
1692
+ `gestures="cooperative"`. Absent is the family's own. */
1693
+ twoFingerHintLabel?: (HelixCanvas["twoFingerHintLabel"]) | undefined;
1694
+ /** The line shown while a surface with `gestures="activate"` has the
1695
+ gestures. Absent is the family's own. */
1696
+ "using-label"?: (HelixCanvas["usingLabel"]) | undefined;
1697
+ /** The line shown while a surface with `gestures="activate"` has the
1698
+ gestures. Absent is the family's own. */
1699
+ usingLabel?: (HelixCanvas["usingLabel"]) | undefined;
1700
+ /** The hint shown when the wheel scrolls past a surface with
1701
+ `gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
1702
+ elsewhere. Absent is the family's own. */
1703
+ "wheel-hint-label"?: (HelixCanvas["wheelHintLabel"]) | undefined;
1704
+ /** The hint shown when the wheel scrolls past a surface with
1705
+ `gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
1706
+ elsewhere. Absent is the family's own. */
1707
+ wheelHintLabel?: (HelixCanvas["wheelHintLabel"]) | undefined;
1656
1708
  /** The zoom in button's label. */
1657
1709
  "zoom-in-label"?: (HelixCanvas["zoomInLabel"]) | undefined;
1658
1710
  /** The zoom in button's label. */
@@ -5642,6 +5694,277 @@ Empty is the runtime's own. */
5642
5694
 
5643
5695
  export type HelixFormatDateVueEvents = {};
5644
5696
 
5697
+ /** `HelixGraph` component event */
5698
+ export type HelixGraphElementEvent<E = Event> = TypedEvent<HelixGraph, E>;
5699
+ /** `helix-activate` event type */
5700
+ export type HelixGraphHelixActivateElementEvent =
5701
+ HelixGraphElementEvent<HelixActivateEvent>;
5702
+ /** `helix-before-activate` event type */
5703
+ export type HelixGraphHelixBeforeActivateElementEvent =
5704
+ HelixGraphElementEvent<HelixBeforeActivateEvent>;
5705
+ /** `helix-graph-layout` event type */
5706
+ export type HelixGraphHelixGraphLayoutElementEvent =
5707
+ HelixGraphElementEvent<HelixGraphLayoutEvent>;
5708
+ /** `helix-graph-pan` event type */
5709
+ export type HelixGraphHelixGraphPanElementEvent =
5710
+ HelixGraphElementEvent<HelixGraphPanEvent>;
5711
+ /** `helix-graph-part-change` event type */
5712
+ export type HelixGraphHelixGraphPartChangeElementEvent =
5713
+ HelixGraphElementEvent<HelixGraphPartChangeEvent>;
5714
+ /** `helix-graph-ready` event type */
5715
+ export type HelixGraphHelixGraphReadyElementEvent =
5716
+ HelixGraphElementEvent<HelixGraphReadyEvent>;
5717
+ /** `helix-graph-zoom` event type */
5718
+ export type HelixGraphHelixGraphZoomElementEvent =
5719
+ HelixGraphElementEvent<HelixGraphZoomEvent>;
5720
+
5721
+ export type HelixGraphVueProps = {
5722
+ /** The hint shown when a surface waiting to be pressed is scrolled or
5723
+ swiped over, with `gestures="activate"`. Absent is the family's own. */
5724
+ "activate-hint-label"?: (HelixGraph["activateHintLabel"]) | undefined;
5725
+ /** The hint shown when a surface waiting to be pressed is scrolled or
5726
+ swiped over, with `gestures="activate"`. Absent is the family's own. */
5727
+ activateHintLabel?: (HelixGraph["activateHintLabel"]) | undefined;
5728
+ /** Which controls to show, as a list such as `pan zoom fullscreen`, or
5729
+ `none`. A family can add words of its own.
5730
+
5731
+ **A list rather than a switch, because the overlap is not symmetric.** A
5732
+ surface a consumer brings often has zoom controls of its own and almost
5733
+ never has pan buttons, so a single switch would make them choose between
5734
+ a duplicate and nothing.
5735
+
5736
+ `none` draws none of them, which is the right answer where what was
5737
+ slotted already has controls a reader can find: what this argues for is
5738
+ that *a* findable control exists, never that it is ours. The methods stay
5739
+ public either way, so a consumer drawing their own chrome can still drive
5740
+ the surface.
5741
+
5742
+ Absent is whatever the family rests at, which is this library's rule that
5743
+ a resting value is an attribute's absence: zoom, the compass and
5744
+ fullscreen for a map, whose pan buttons a page asks for, and zoom and
5745
+ fullscreen for a board, which a reader drags and whose pad took a third
5746
+ of the frame. The
5747
+ stylesheet lays the cluster out by which buttons are in it rather than by
5748
+ this attribute, so the two defaults need no rule each. */
5749
+ controls?: (HelixGraph["controls"]) | undefined;
5750
+ /** The name of the group of controls, read by screen readers.
5751
+
5752
+ Absent is the family's own name for it, "Map controls" or "Board
5753
+ controls", which names what the controls drive rather than the
5754
+ mechanism. Written here to say it in another language, which every other
5755
+ string this surface speaks already allowed and this one did not. */
5756
+ "controls-label"?: (HelixGraph["controlsLabel"]) | undefined;
5757
+ /** The name of the group of controls, read by screen readers.
5758
+
5759
+ Absent is the family's own name for it, "Map controls" or "Board
5760
+ controls", which names what the controls drive rather than the
5761
+ mechanism. Written here to say it in another language, which every other
5762
+ string this surface speaks already allowed and this one did not. */
5763
+ controlsLabel?: (HelixGraph["controlsLabel"]) | undefined;
5764
+ /** Which corner the controls sit in.
5765
+
5766
+ **Configurable because there is no safe default**, which is a collision
5767
+ rather than a taste: whatever a consumer slots may put its own controls
5768
+ in any corner, and every library that draws some made this a setting for
5769
+ the same reason.
5770
+
5771
+ Logical corners rather than left and right, so a right-to-left page moves
5772
+ them without a consumer writing a second rule. Absent is the top end, a
5773
+ resting value being an attribute's absence: a default that reflected
5774
+ would write an attribute onto every host that no server sent. */
5775
+ "controls-placement"?: (HelixGraph["controlsPlacement"]) | undefined;
5776
+ /** Which corner the controls sit in.
5777
+
5778
+ **Configurable because there is no safe default**, which is a collision
5779
+ rather than a taste: whatever a consumer slots may put its own controls
5780
+ in any corner, and every library that draws some made this a setting for
5781
+ the same reason.
5782
+
5783
+ Logical corners rather than left and right, so a right-to-left page moves
5784
+ them without a consumer writing a second rule. Absent is the top end, a
5785
+ resting value being an attribute's absence: a default that reflected
5786
+ would write an attribute onto every host that no server sent. */
5787
+ controlsPlacement?: (HelixGraph["controlsPlacement"]) | undefined;
5788
+ /** The fullscreen button's label. */
5789
+ "fullscreen-label"?: (HelixGraph["fullscreenLabel"]) | undefined;
5790
+ /** The fullscreen button's label. */
5791
+ fullscreenLabel?: (HelixGraph["fullscreenLabel"]) | undefined;
5792
+ /** Which gestures the surface takes from the page.
5793
+
5794
+ - `always`: the surface takes the wheel and one finger, for a surface
5795
+ that is the page, such as a full-screen view. A map rests here.
5796
+ - Unset is the family's own: `always` for a map, and for a board, a
5797
+ drag and a pinch, with the plain wheel left to the page until the
5798
+ board fills the screen.
5799
+ - `cooperative`: the wheel and one finger scroll the page, and the
5800
+ surface takes Ctrl or ⌘ with the wheel, and two fingers. The frame
5801
+ says so when a gesture passes to the page. Best for a surface embedded
5802
+ in a page.
5803
+ - `activate`: the surface takes nothing until it is pressed, and gives it
5804
+ back on Escape, when the pointer leaves it, or on a press elsewhere.
5805
+
5806
+ The keyboard and the frame's buttons work in every mode.
5807
+
5808
+ **Unreflected and without a default**, because a default that reflected
5809
+ would write an attribute onto every host that no server sent, and the
5810
+ hydration that followed would disagree with it. */
5811
+ gestures?: (HelixGraph["gestures"]) | undefined;
5812
+ /** How long, in milliseconds, before the header and footer hide when the user is inactive. `0` keeps them visible.
5813
+
5814
+ Zero keeps it up, which is the default: these controls are how a keyboard
5815
+ reader operates the surface, and chrome that hid itself by default would
5816
+ be the component undoing its own argument. Set it for a display nobody
5817
+ drives. */
5818
+ "idle-delay"?: (HelixGraph["idleDelay"] | `${number}`) | undefined;
5819
+ /** How long, in milliseconds, before the header and footer hide when the user is inactive. `0` keeps them visible.
5820
+
5821
+ Zero keeps it up, which is the default: these controls are how a keyboard
5822
+ reader operates the surface, and chrome that hid itself by default would
5823
+ be the component undoing its own argument. Set it for a display nobody
5824
+ drives. */
5825
+ idleDelay?: (HelixGraph["idleDelay"]) | undefined;
5826
+ /** The pan down button's label.
5827
+
5828
+ **A label for each way rather than one with the way filled in**, which is
5829
+ what this was: `Pan {way}` filled in with `left`, so a page that said it
5830
+ in French read out "Déplacer left". The word for a direction is as much
5831
+ the translator's as the word for panning, and a language can put it
5832
+ anywhere in the phrase. */
5833
+ "pan-down-label"?: (HelixGraph["panDownLabel"]) | undefined;
5834
+ /** The pan down button's label.
5835
+
5836
+ **A label for each way rather than one with the way filled in**, which is
5837
+ what this was: `Pan {way}` filled in with `left`, so a page that said it
5838
+ in French read out "Déplacer left". The word for a direction is as much
5839
+ the translator's as the word for panning, and a language can put it
5840
+ anywhere in the phrase. */
5841
+ panDownLabel?: (HelixGraph["panDownLabel"]) | undefined;
5842
+ /** The pan left button's label. */
5843
+ "pan-left-label"?: (HelixGraph["panLeftLabel"]) | undefined;
5844
+ /** The pan left button's label. */
5845
+ panLeftLabel?: (HelixGraph["panLeftLabel"]) | undefined;
5846
+ /** The pan right button's label. */
5847
+ "pan-right-label"?: (HelixGraph["panRightLabel"]) | undefined;
5848
+ /** The pan right button's label. */
5849
+ panRightLabel?: (HelixGraph["panRightLabel"]) | undefined;
5850
+ /** How far one press pans the view, as a fraction of its size.
5851
+
5852
+ A fraction rather than a distance, because this surface does not know the
5853
+ scale of what is inside it: a quarter of the viewport is the same gesture
5854
+ at any zoom, and a consumer who wants their own units multiplies by them. */
5855
+ "pan-step"?: (HelixGraph["panStep"] | `${number}`) | undefined;
5856
+ /** How far one press pans the view, as a fraction of its size.
5857
+
5858
+ A fraction rather than a distance, because this surface does not know the
5859
+ scale of what is inside it: a quarter of the viewport is the same gesture
5860
+ at any zoom, and a consumer who wants their own units multiplies by them. */
5861
+ panStep?: (HelixGraph["panStep"]) | undefined;
5862
+ /** The pan up button's label. */
5863
+ "pan-up-label"?: (HelixGraph["panUpLabel"]) | undefined;
5864
+ /** The pan up button's label. */
5865
+ panUpLabel?: (HelixGraph["panUpLabel"]) | undefined;
5866
+ /** The hint shown when one finger swipes over a surface with
5867
+ `gestures="cooperative"`. Absent is the family's own. */
5868
+ "two-finger-hint-label"?: (HelixGraph["twoFingerHintLabel"]) | undefined;
5869
+ /** The hint shown when one finger swipes over a surface with
5870
+ `gestures="cooperative"`. Absent is the family's own. */
5871
+ twoFingerHintLabel?: (HelixGraph["twoFingerHintLabel"]) | undefined;
5872
+ /** The line shown while a surface with `gestures="activate"` has the
5873
+ gestures. Absent is the family's own. */
5874
+ "using-label"?: (HelixGraph["usingLabel"]) | undefined;
5875
+ /** The line shown while a surface with `gestures="activate"` has the
5876
+ gestures. Absent is the family's own. */
5877
+ usingLabel?: (HelixGraph["usingLabel"]) | undefined;
5878
+ /** The hint shown when the wheel scrolls past a surface with
5879
+ `gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
5880
+ elsewhere. Absent is the family's own. */
5881
+ "wheel-hint-label"?: (HelixGraph["wheelHintLabel"]) | undefined;
5882
+ /** The hint shown when the wheel scrolls past a surface with
5883
+ `gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
5884
+ elsewhere. Absent is the family's own. */
5885
+ wheelHintLabel?: (HelixGraph["wheelHintLabel"]) | undefined;
5886
+ /** The zoom in button's label. */
5887
+ "zoom-in-label"?: (HelixGraph["zoomInLabel"]) | undefined;
5888
+ /** The zoom in button's label. */
5889
+ zoomInLabel?: (HelixGraph["zoomInLabel"]) | undefined;
5890
+ /** The zoom out button's label. */
5891
+ "zoom-out-label"?: (HelixGraph["zoomOutLabel"]) | undefined;
5892
+ /** The zoom out button's label. */
5893
+ zoomOutLabel?: (HelixGraph["zoomOutLabel"]) | undefined;
5894
+ /** The `value` of the current item.
5895
+
5896
+ Not `option.active`, which is the option the keyboard is on: that is a
5897
+ different question from which one is chosen.
5898
+
5899
+ Writing always applies, so `<helix-tabs active="one">` starts on that
5900
+ tab, and `default-active` is how markup says where to start without
5901
+ naming the current one. */
5902
+ active?: (HelixGraph["active"]) | undefined;
5903
+ /** The `value` of the item declared current in markup.
5904
+
5905
+ Ignored once `active` is written. */
5906
+ "default-active"?: (HelixGraph["defaultActive"]) | undefined;
5907
+ /** The `value` of the item declared current in markup.
5908
+
5909
+ Ignored once `active` is written. */
5910
+ defaultActive?: (HelixGraph["defaultActive"]) | undefined;
5911
+ /** What the list says of a note's count, with `{count}`. */
5912
+ "count-label"?: (HelixGraph["countLabel"]) | undefined;
5913
+ /** What the list says of a note's count, with `{count}`. */
5914
+ countLabel?: (HelixGraph["countLabel"]) | undefined;
5915
+ /** How many links from the selected note to show, for its local graph. Unset
5916
+ shows every note. The list holds what the drawing shows. */
5917
+ depth?: (HelixGraph["depth"]) | undefined;
5918
+ /** The graph's name, read by screen readers, such as "Research notes".
5919
+ Required. */
5920
+ label?: (HelixGraph["label"]) | undefined;
5921
+ /** How a note linked both to and from the selected one is described, with `{note}`. */
5922
+ "linked-both-label"?: (HelixGraph["linkedBothLabel"]) | undefined;
5923
+ /** How a note linked both to and from the selected one is described, with `{note}`. */
5924
+ linkedBothLabel?: (HelixGraph["linkedBothLabel"]) | undefined;
5925
+ /** How a note the selected one links to is described, with `{note}`, the selected note's name. */
5926
+ "linked-from-label"?: (HelixGraph["linkedFromLabel"]) | undefined;
5927
+ /** How a note the selected one links to is described, with `{note}`, the selected note's name. */
5928
+ linkedFromLabel?: (HelixGraph["linkedFromLabel"]) | undefined;
5929
+ /** How a note that links to the selected one is described, with `{note}`. */
5930
+ "links-to-label"?: (HelixGraph["linksToLabel"]) | undefined;
5931
+ /** How a note that links to the selected one is described, with `{note}`. */
5932
+ linksToLabel?: (HelixGraph["linksToLabel"]) | undefined;
5933
+ /** The list's name, read by screen readers. */
5934
+ "notes-label"?: (HelixGraph["notesLabel"]) | undefined;
5935
+ /** The list's name, read by screen readers. */
5936
+ notesLabel?: (HelixGraph["notesLabel"]) | undefined;
5937
+ /** The search field's name. */
5938
+ "search-label"?: (HelixGraph["searchLabel"]) | undefined;
5939
+ /** The search field's name. */
5940
+ searchLabel?: (HelixGraph["searchLabel"]) | undefined;
5941
+ /** How the selected note is described in the list. */
5942
+ "selected-label"?: (HelixGraph["selectedLabel"]) | undefined;
5943
+ /** How the selected note is described in the list. */
5944
+ selectedLabel?: (HelixGraph["selectedLabel"]) | undefined;
5945
+ /** The links between notes, each from `source` to `target`. A property, never an attribute. */
5946
+ links?: (HelixGraph["links"]) | undefined;
5947
+ /** The notes. A property, never an attribute. */
5948
+ nodes?: (HelixGraph["nodes"]) | undefined;
5949
+ };
5950
+
5951
+ export type HelixGraphVueEvents = {
5952
+ /** A note was selected, in the list or in the drawing. The detail's `value` is its `id`. */
5953
+ "helix-activate": HelixGraphHelixActivateElementEvent;
5954
+ /** A note is about to be selected. Cancelable: cancel it to keep the selection in your own state. */
5955
+ "helix-before-activate": HelixGraphHelixBeforeActivateElementEvent;
5956
+ /** A layout settled, with where it put each note, sent by `laidOut()`. Keep the positions and pass them back as each note's `x` and `y`. */
5957
+ "helix-graph-layout": HelixGraphHelixGraphLayoutElementEvent;
5958
+ /** A pan button or arrow key was pressed. `connectGraph` moves the drawing. */
5959
+ "helix-graph-pan": HelixGraphHelixGraphPanElementEvent;
5960
+ /** The notes, the links, the selection, the depth or the gestures changed. Used by `connectGraph`; pages do not need to listen for it. */
5961
+ "helix-graph-part-change": HelixGraphHelixGraphPartChangeElementEvent;
5962
+ /** The graph has been drawn whole, laid out and settled. Sent each time `drawn()` says it is drawn after it was not. */
5963
+ "helix-graph-ready": HelixGraphHelixGraphReadyElementEvent;
5964
+ /** A zoom button or key was pressed. `connectGraph` zooms the drawing. */
5965
+ "helix-graph-zoom": HelixGraphHelixGraphZoomElementEvent;
5966
+ };
5967
+
5645
5968
  export type HelixGridVueProps = {
5646
5969
  /** How each cell aligns within its row. Sets `align-items`.
5647
5970
 
@@ -7340,6 +7663,12 @@ the container's edge is the map's. */
7340
7663
  shows the map through a blur, `frosted` blurs more, and `transparent` has
7341
7664
  no background. Your theme sets how see-through each one is. */
7342
7665
  material?: (HelixMap["material"]) | undefined;
7666
+ /** The hint shown when a surface waiting to be pressed is scrolled or
7667
+ swiped over, with `gestures="activate"`. Absent is the family's own. */
7668
+ "activate-hint-label"?: (HelixMap["activateHintLabel"]) | undefined;
7669
+ /** The hint shown when a surface waiting to be pressed is scrolled or
7670
+ swiped over, with `gestures="activate"`. Absent is the family's own. */
7671
+ activateHintLabel?: (HelixMap["activateHintLabel"]) | undefined;
7343
7672
  /** Which controls to show, as a list such as `pan zoom fullscreen`, or
7344
7673
  `none`. A family can add words of its own.
7345
7674
 
@@ -7404,6 +7733,26 @@ would write an attribute onto every host that no server sent. */
7404
7733
  "fullscreen-label"?: (HelixMap["fullscreenLabel"]) | undefined;
7405
7734
  /** The fullscreen button's label. */
7406
7735
  fullscreenLabel?: (HelixMap["fullscreenLabel"]) | undefined;
7736
+ /** Which gestures the surface takes from the page.
7737
+
7738
+ - `always`: the surface takes the wheel and one finger, for a surface
7739
+ that is the page, such as a full-screen view. A map rests here.
7740
+ - Unset is the family's own: `always` for a map, and for a board, a
7741
+ drag and a pinch, with the plain wheel left to the page until the
7742
+ board fills the screen.
7743
+ - `cooperative`: the wheel and one finger scroll the page, and the
7744
+ surface takes Ctrl or ⌘ with the wheel, and two fingers. The frame
7745
+ says so when a gesture passes to the page. Best for a surface embedded
7746
+ in a page.
7747
+ - `activate`: the surface takes nothing until it is pressed, and gives it
7748
+ back on Escape, when the pointer leaves it, or on a press elsewhere.
7749
+
7750
+ The keyboard and the frame's buttons work in every mode.
7751
+
7752
+ **Unreflected and without a default**, because a default that reflected
7753
+ would write an attribute onto every host that no server sent, and the
7754
+ hydration that followed would disagree with it. */
7755
+ gestures?: (HelixMap["gestures"]) | undefined;
7407
7756
  /** How long, in milliseconds, before the header and footer hide when the user is inactive. `0` keeps them visible.
7408
7757
 
7409
7758
  Zero keeps it up, which is the default: these controls are how a keyboard
@@ -7458,6 +7807,26 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
7458
7807
  "pan-up-label"?: (HelixMap["panUpLabel"]) | undefined;
7459
7808
  /** The pan up button's label. */
7460
7809
  panUpLabel?: (HelixMap["panUpLabel"]) | undefined;
7810
+ /** The hint shown when one finger swipes over a surface with
7811
+ `gestures="cooperative"`. Absent is the family's own. */
7812
+ "two-finger-hint-label"?: (HelixMap["twoFingerHintLabel"]) | undefined;
7813
+ /** The hint shown when one finger swipes over a surface with
7814
+ `gestures="cooperative"`. Absent is the family's own. */
7815
+ twoFingerHintLabel?: (HelixMap["twoFingerHintLabel"]) | undefined;
7816
+ /** The line shown while a surface with `gestures="activate"` has the
7817
+ gestures. Absent is the family's own. */
7818
+ "using-label"?: (HelixMap["usingLabel"]) | undefined;
7819
+ /** The line shown while a surface with `gestures="activate"` has the
7820
+ gestures. Absent is the family's own. */
7821
+ usingLabel?: (HelixMap["usingLabel"]) | undefined;
7822
+ /** The hint shown when the wheel scrolls past a surface with
7823
+ `gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
7824
+ elsewhere. Absent is the family's own. */
7825
+ "wheel-hint-label"?: (HelixMap["wheelHintLabel"]) | undefined;
7826
+ /** The hint shown when the wheel scrolls past a surface with
7827
+ `gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
7828
+ elsewhere. Absent is the family's own. */
7829
+ wheelHintLabel?: (HelixMap["wheelHintLabel"]) | undefined;
7461
7830
  /** The zoom in button's label. */
7462
7831
  "zoom-in-label"?: (HelixMap["zoomInLabel"]) | undefined;
7463
7832
  /** The zoom in button's label. */
@@ -7466,12 +7835,6 @@ at any zoom, and a consumer who wants their own units multiplies by them. */
7466
7835
  "zoom-out-label"?: (HelixMap["zoomOutLabel"]) | undefined;
7467
7836
  /** The zoom out button's label. */
7468
7837
  zoomOutLabel?: (HelixMap["zoomOutLabel"]) | undefined;
7469
- /** The hint shown when a map waiting to be pressed is scrolled or swiped
7470
- over, with `gestures="activate"`. */
7471
- "activate-hint-label"?: (HelixMap["activateHintLabel"]) | undefined;
7472
- /** The hint shown when a map waiting to be pressed is scrolled or swiped
7473
- over, with `gestures="activate"`. */
7474
- activateHintLabel?: (HelixMap["activateHintLabel"]) | undefined;
7475
7838
  /** The map's rotation, in degrees clockwise from north. `connectMap` keeps it
7476
7839
  current, and the Face north button's needle turns with it. */
7477
7840
  bearing?: (HelixMap["bearing"]) | undefined;
@@ -7486,19 +7849,6 @@ the map zooms in, and pressing one zooms in to its places. */
7486
7849
  "flat-label"?: (HelixMap["flatLabel"]) | undefined;
7487
7850
  /** What screen readers hear when the map is tilted back to looking straight down. */
7488
7851
  flatLabel?: (HelixMap["flatLabel"]) | undefined;
7489
- /** Which gestures the map takes from the page.
7490
-
7491
- - `always`, which unset is: the wheel zooms the map and one finger pans
7492
- it, for a map that is the page, such as a full-screen view.
7493
- - `cooperative`: the wheel and one finger scroll the page, and the map
7494
- takes Ctrl or ⌘ with the wheel, and two fingers. The frame says so
7495
- when a gesture passes to the page. Best for a map embedded in a page.
7496
- - `activate`: the map takes nothing until it is pressed, and gives it
7497
- back on Escape, when the pointer leaves it, or on a press elsewhere.
7498
-
7499
- The keyboard and the frame's buttons work in every mode. The renderer is
7500
- told through the connector, so MapLibre and Leaflet behave alike. */
7501
- gestures?: (HelixMap["gestures"]) | undefined;
7502
7852
  /** The Hybrid map type's name. */
7503
7853
  "hybrid-label"?: (HelixMap["hybridLabel"]) | undefined;
7504
7854
  /** The Hybrid map type's name. */
@@ -7580,22 +7930,6 @@ top of the map faces, clockwise from north. */
7580
7930
  /** What screen readers hear when the map is turned. `{degrees}` is the way the
7581
7931
  top of the map faces, clockwise from north. */
7582
7932
  turnedLabel?: (HelixMap["turnedLabel"]) | undefined;
7583
- /** The hint shown when one finger swipes over a map with `gestures="cooperative"`. */
7584
- "two-finger-hint-label"?: (HelixMap["twoFingerHintLabel"]) | undefined;
7585
- /** The hint shown when one finger swipes over a map with `gestures="cooperative"`. */
7586
- twoFingerHintLabel?: (HelixMap["twoFingerHintLabel"]) | undefined;
7587
- /** The line shown while a map with `gestures="activate"` has the gestures. */
7588
- "using-label"?: (HelixMap["usingLabel"]) | undefined;
7589
- /** The line shown while a map with `gestures="activate"` has the gestures. */
7590
- usingLabel?: (HelixMap["usingLabel"]) | undefined;
7591
- /** The hint shown when the wheel scrolls past a map with
7592
- `gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
7593
- elsewhere, as the renderer reads it. */
7594
- "wheel-hint-label"?: (HelixMap["wheelHintLabel"]) | undefined;
7595
- /** The hint shown when the wheel scrolls past a map with
7596
- `gestures="cooperative"`, with `{key}`, which is ⌘ on a Mac and Ctrl
7597
- elsewhere, as the renderer reads it. */
7598
- wheelHintLabel?: (HelixMap["wheelHintLabel"]) | undefined;
7599
7933
  /** What screen readers hear after a zoom. `{level}` is the zoom level. */
7600
7934
  "zoomed-label"?: (HelixMap["zoomedLabel"]) | undefined;
7601
7935
  /** What screen readers hear after a zoom. `{level}` is the zoom level. */
@@ -13965,6 +14299,14 @@ export type CustomCssProperties = {
13965
14299
  "--filter-input-shadow"?: (string) | undefined;
13966
14300
  /** The height of the empty field. The field grows from this height. */
13967
14301
  "--filter-input-size"?: (string) | undefined;
14302
+ /** The color behind the drawing while it loads. */
14303
+ "--graph-background-color"?: (string) | undefined;
14304
+ /** The frame's height, as a length. */
14305
+ "--graph-block-size"?: (string) | undefined;
14306
+ /** The frame's border color. */
14307
+ "--graph-border-color"?: (string) | undefined;
14308
+ /** The list's width beside the drawing. */
14309
+ "--graph-panel-size"?: (string) | undefined;
13968
14310
  /** An explicit track list. It overrides `min` and `columns`. Use it for tracks of unequal widths, which neither attribute can set. */
13969
14311
  "--grid-columns"?: (string) | undefined;
13970
14312
  /** How tall a cell is. One row of tall, narrow cells looks like a status page. */
@@ -14979,6 +15321,12 @@ export interface WcToolkitVueGlobalComponents {
14979
15321
  HelixFormatDateVueProps,
14980
15322
  HelixFormatDateVueEvents
14981
15323
  >;
15324
+ /** The styled frame: the drawing with its zoom and fullscreen buttons, and the list of notes beside it, which moves below the drawing where the frame is narrower than 40rem. The selected note leads the list on a surface of its own, and the notes linked to it are named by how they link. */
15325
+ "helix-graph": DefineCustomElement<
15326
+ HelixGraph,
15327
+ HelixGraphVueProps,
15328
+ HelixGraphVueEvents
15329
+ >;
14982
15330
  /** Set columns in one of two ways: - 'columns' sets a fixed count. - 'min' fits as many equal columns as there is room for at that width, so the layout responds with no breakpoints to maintain. If you set both, 'min' wins. The grid is presentation only, so there is no headless tier. */
14983
15331
  "helix-grid": DefineCustomElement<
14984
15332
  HelixGrid,