@f-ewald/components 1.41.0 → 1.43.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 (47) hide show
  1. package/README.md +5 -1
  2. package/custom-elements.json +2102 -332
  3. package/dist/autocomplete-input.d.ts +10 -2
  4. package/dist/autocomplete-input.d.ts.map +1 -1
  5. package/dist/autocomplete-input.js +34 -1
  6. package/dist/autocomplete-input.js.map +1 -1
  7. package/dist/dag-graph.d.ts +161 -0
  8. package/dist/dag-graph.d.ts.map +1 -0
  9. package/dist/dag-graph.js +724 -0
  10. package/dist/dag-graph.js.map +1 -0
  11. package/dist/data-table.d.ts +11 -2
  12. package/dist/data-table.d.ts.map +1 -1
  13. package/dist/data-table.js +31 -3
  14. package/dist/data-table.js.map +1 -1
  15. package/dist/icons.d.ts +16 -0
  16. package/dist/icons.d.ts.map +1 -1
  17. package/dist/icons.js +16 -0
  18. package/dist/icons.js.map +1 -1
  19. package/dist/index.d.ts +4 -1
  20. package/dist/index.d.ts.map +1 -1
  21. package/dist/index.js +3 -0
  22. package/dist/index.js.map +1 -1
  23. package/dist/kind-icon.d.ts +38 -0
  24. package/dist/kind-icon.d.ts.map +1 -0
  25. package/dist/kind-icon.js +87 -0
  26. package/dist/kind-icon.js.map +1 -0
  27. package/dist/tokens.css +4 -0
  28. package/dist/tokens.d.ts.map +1 -1
  29. package/dist/tokens.js +10 -0
  30. package/dist/tokens.js.map +1 -1
  31. package/dist/ui-tooltip.d.ts +49 -0
  32. package/dist/ui-tooltip.d.ts.map +1 -0
  33. package/dist/ui-tooltip.js +317 -0
  34. package/dist/ui-tooltip.js.map +1 -0
  35. package/dist/utils/dag-layout.d.ts +60 -0
  36. package/dist/utils/dag-layout.d.ts.map +1 -0
  37. package/dist/utils/dag-layout.js +80 -0
  38. package/dist/utils/dag-layout.js.map +1 -0
  39. package/docs/autocomplete-input.md +9 -2
  40. package/docs/dag-graph.md +101 -0
  41. package/docs/data-table.md +18 -0
  42. package/docs/design-language.md +4 -1
  43. package/docs/icons.md +8 -0
  44. package/docs/kind-icon.md +53 -0
  45. package/docs/ui-tooltip.md +70 -0
  46. package/llms.txt +150 -2
  47. package/package.json +2 -1
@@ -1917,7 +1917,7 @@
1917
1917
  "declarations": [
1918
1918
  {
1919
1919
  "kind": "class",
1920
- "description": "Generic form-associated text input with a suggestion dropdown, for any\n\"type to filter a list of `{key, value}` options\" use case. Works as a\ndrop-in replacement for a plain `<input>` inside a `<form>`: set `name` on\nthe element itself and consumers keep reading\n`new FormData(form).get(name)` and calling `form.reset()` unchanged — the\nsubmitted value is the picked option's `value`, while `key` is available\nvia the `option-select` event and the `selectedOption` getter for cases\nthat need the underlying id rather than the display text.\n\nSupports two suggestion sources:\n- **API**: set `endpoint` to a URL that, given a `?<query-param>=<text>`\n query string, responds with a JSON array of `{key, value}` objects.\n Requests are debounced as the user types.\n- **Local array**: set `options` to a fixed `AutocompleteOption[]` and the\n component filters it client-side instead of making any network\n request. Useful for small/fixed lists, offline use, or tests. Takes\n priority over `endpoint` whenever it's non-null.\n\nSet `clearable` to show an in-field clear action whenever a value is\npresent.",
1920
+ "description": "Generic form-associated text input with a suggestion dropdown, for any\n\"type to filter a list of `{key, value}` options\" use case. Works as a\ndrop-in replacement for a plain `<input>` inside a `<form>`: set `name` on\nthe element itself and consumers keep reading\n`new FormData(form).get(name)` and calling `form.reset()` unchanged — the\nsubmitted value is the picked option's `value`, while `key` is available\nvia the `option-select` event and the `selectedOption` getter for cases\nthat need the underlying id rather than the display text.\n\nSupports two suggestion sources:\n- **API**: set `endpoint` to a URL that, given a `?<query-param>=<text>`\n query string, responds with a JSON array of `{key, value}` objects.\n Requests are debounced as the user types.\n- **Local array**: set `options` to a fixed `AutocompleteOption[]` and the\n component filters it client-side instead of making any network\n request. Useful for small/fixed lists, offline use, or tests. Takes\n priority over `endpoint` whenever it's non-null.\n\nEach option may also carry a pre-rendered `icon` (shown before the value)\nand a `description` (a smaller, muted line under the value); options\nwithout them render as a plain value.\n\nSet `clearable` to show an in-field clear action whenever a value is\npresent.",
1921
1921
  "name": "AutocompleteInput",
1922
1922
  "members": [
1923
1923
  {
@@ -6557,13 +6557,797 @@
6557
6557
  }
6558
6558
  ]
6559
6559
  },
6560
+ {
6561
+ "kind": "javascript-module",
6562
+ "path": "src/dag-graph.ts",
6563
+ "declarations": [
6564
+ {
6565
+ "kind": "class",
6566
+ "description": "Interactive layered drawing of a directed graph — dependencies, pipelines, or any node-link data.\n\nNodes are placed in layers (via dagre) so edges flow left to right (or top to bottom with\n`direction=\"TB\"`); cycles are allowed, and the edges closing them are drawn dashed and point backward.\nEach node is a compact card sized to its label, with an optional icon, color, and border style from\n`kinds`. The whole graph is shown when it fits at a readable zoom; otherwise the selected node is centered at\n100%. Drag to pan; pinch or Ctrl/⌘ + wheel to zoom (a plain wheel scrolls the page). With keyboard\nfocus on the graph, arrow keys pan, `+`/`-` zoom, and `0` fits the graph. Clicking a node, or pressing\nEnter/Space on it, selects it. A toolbar in the top-right corner offers the `controls` you enable.\n\nSet `static` to present a fixed picture: the graph is always fitted into view, panning and zooming\nare off, and the toolbar is hidden; nodes can still be selected.\n\nColors can be changed with these custom properties: `--dag-node-background`, `--dag-node-text`,\n`--dag-edge-color`, `--dag-selected-color`, and `--dag-highlight-color`; `--dag-graph-height` sets the\nheight (default `24rem`).",
6567
+ "name": "DagGraph",
6568
+ "slots": [
6569
+ {
6570
+ "description": "Shown when there are no nodes.",
6571
+ "name": "empty"
6572
+ }
6573
+ ],
6574
+ "members": [
6575
+ {
6576
+ "kind": "field",
6577
+ "name": "nodes",
6578
+ "type": {
6579
+ "text": "DagNode[]"
6580
+ },
6581
+ "default": "[]",
6582
+ "description": "Nodes to draw.",
6583
+ "attribute": "nodes"
6584
+ },
6585
+ {
6586
+ "kind": "field",
6587
+ "name": "edges",
6588
+ "type": {
6589
+ "text": "DagEdge[]"
6590
+ },
6591
+ "default": "[]",
6592
+ "description": "Directed edges between `nodes`; edges with an unknown endpoint or to the node itself are ignored.",
6593
+ "attribute": "edges"
6594
+ },
6595
+ {
6596
+ "kind": "field",
6597
+ "name": "kinds",
6598
+ "type": {
6599
+ "text": "Record<string, DagNodeKind>"
6600
+ },
6601
+ "default": "{}",
6602
+ "description": "Presentation per node `kind`: legend label, color, icon, and border style."
6603
+ },
6604
+ {
6605
+ "kind": "field",
6606
+ "name": "selected",
6607
+ "type": {
6608
+ "text": "string | null"
6609
+ },
6610
+ "default": "null",
6611
+ "description": "Id of the selected node. Selecting a node updates it; when it changes to a node outside the visible area,\nthe view follows.",
6612
+ "attribute": "selected",
6613
+ "reflects": true
6614
+ },
6615
+ {
6616
+ "kind": "field",
6617
+ "name": "direction",
6618
+ "type": {
6619
+ "text": "DagDirection"
6620
+ },
6621
+ "default": "\"LR\"",
6622
+ "description": "Layer direction: `LR` (left to right) or `TB` (top to bottom).",
6623
+ "attribute": "direction",
6624
+ "reflects": true
6625
+ },
6626
+ {
6627
+ "kind": "field",
6628
+ "name": "label",
6629
+ "type": {
6630
+ "text": "string"
6631
+ },
6632
+ "default": "\"Directed graph\"",
6633
+ "description": "Accessible name of the graph; the node and edge counts are appended.",
6634
+ "attribute": "label"
6635
+ },
6636
+ {
6637
+ "kind": "field",
6638
+ "name": "legend",
6639
+ "type": {
6640
+ "text": "boolean"
6641
+ },
6642
+ "default": "false",
6643
+ "description": "Shows a legend of `kinds` below the graph.",
6644
+ "attribute": "legend",
6645
+ "reflects": true
6646
+ },
6647
+ {
6648
+ "kind": "field",
6649
+ "name": "controls",
6650
+ "type": {
6651
+ "text": "string"
6652
+ },
6653
+ "default": "\"zoom fit center\"",
6654
+ "description": "Space-separated toolbar controls to show: any of `zoom`, `fit`, `center`, and `direction`, in that\norder. An empty value hides the toolbar.",
6655
+ "attribute": "controls",
6656
+ "reflects": true
6657
+ },
6658
+ {
6659
+ "kind": "field",
6660
+ "name": "isStatic",
6661
+ "type": {
6662
+ "text": "boolean"
6663
+ },
6664
+ "default": "false",
6665
+ "description": "Presents a static picture: always fitted, with panning, zooming, and the toolbar turned off.",
6666
+ "attribute": "static",
6667
+ "reflects": true
6668
+ },
6669
+ {
6670
+ "kind": "field",
6671
+ "name": "_view",
6672
+ "type": {
6673
+ "text": "View"
6674
+ },
6675
+ "privacy": "private",
6676
+ "default": "{ x: 0, y: 0, k: 1 }"
6677
+ },
6678
+ {
6679
+ "kind": "field",
6680
+ "name": "_hovered",
6681
+ "type": {
6682
+ "text": "string | null"
6683
+ },
6684
+ "privacy": "private",
6685
+ "default": "null"
6686
+ },
6687
+ {
6688
+ "kind": "field",
6689
+ "name": "_panning",
6690
+ "type": {
6691
+ "text": "boolean"
6692
+ },
6693
+ "privacy": "private",
6694
+ "default": "false"
6695
+ },
6696
+ {
6697
+ "kind": "field",
6698
+ "name": "_svg",
6699
+ "type": {
6700
+ "text": "SVGSVGElement"
6701
+ },
6702
+ "privacy": "private"
6703
+ },
6704
+ {
6705
+ "kind": "field",
6706
+ "name": "_layout",
6707
+ "type": {
6708
+ "text": "DagLayout"
6709
+ },
6710
+ "privacy": "private",
6711
+ "default": "{ nodes: [], edges: [] }"
6712
+ },
6713
+ {
6714
+ "kind": "field",
6715
+ "name": "_positions",
6716
+ "privacy": "private",
6717
+ "default": "new Map<string, DagLayoutNode>()"
6718
+ },
6719
+ {
6720
+ "kind": "field",
6721
+ "name": "_size",
6722
+ "type": {
6723
+ "text": "object"
6724
+ },
6725
+ "privacy": "private",
6726
+ "default": "{ width: 0, height: 0 }"
6727
+ },
6728
+ {
6729
+ "kind": "field",
6730
+ "name": "_viewReady",
6731
+ "type": {
6732
+ "text": "boolean"
6733
+ },
6734
+ "privacy": "private",
6735
+ "default": "false"
6736
+ },
6737
+ {
6738
+ "kind": "field",
6739
+ "name": "_lastSelected",
6740
+ "type": {
6741
+ "text": "string | null"
6742
+ },
6743
+ "privacy": "private",
6744
+ "default": "null"
6745
+ },
6746
+ {
6747
+ "kind": "field",
6748
+ "name": "_lastDirection",
6749
+ "type": {
6750
+ "text": "DagDirection | null"
6751
+ },
6752
+ "privacy": "private",
6753
+ "default": "null"
6754
+ },
6755
+ {
6756
+ "kind": "field",
6757
+ "name": "_measure",
6758
+ "type": {
6759
+ "text": "MeasureText"
6760
+ },
6761
+ "privacy": "private",
6762
+ "default": "approximateTextWidth"
6763
+ },
6764
+ {
6765
+ "kind": "field",
6766
+ "name": "_measureFont",
6767
+ "type": {
6768
+ "text": "string"
6769
+ },
6770
+ "privacy": "private",
6771
+ "default": "\"\""
6772
+ },
6773
+ {
6774
+ "kind": "field",
6775
+ "name": "_resizeObserver",
6776
+ "type": {
6777
+ "text": "ResizeObserver | null"
6778
+ },
6779
+ "privacy": "private",
6780
+ "default": "null"
6781
+ },
6782
+ {
6783
+ "kind": "field",
6784
+ "name": "_drag",
6785
+ "type": {
6786
+ "text": "{ pointerId: number; x: number; y: number; view: View; moved: boolean } | null"
6787
+ },
6788
+ "privacy": "private",
6789
+ "default": "null"
6790
+ },
6791
+ {
6792
+ "kind": "field",
6793
+ "name": "_suppressClick",
6794
+ "type": {
6795
+ "text": "boolean"
6796
+ },
6797
+ "privacy": "private",
6798
+ "default": "false"
6799
+ },
6800
+ {
6801
+ "kind": "method",
6802
+ "name": "fit",
6803
+ "return": {
6804
+ "type": {
6805
+ "text": "void"
6806
+ }
6807
+ },
6808
+ "description": "Fits the whole graph into view, never enlarging it beyond 100%."
6809
+ },
6810
+ {
6811
+ "kind": "method",
6812
+ "name": "center",
6813
+ "return": {
6814
+ "type": {
6815
+ "text": "void"
6816
+ }
6817
+ },
6818
+ "parameters": [
6819
+ {
6820
+ "name": "id",
6821
+ "default": "this.selected",
6822
+ "type": {
6823
+ "text": "string | null"
6824
+ }
6825
+ }
6826
+ ],
6827
+ "description": "Centers the view on a node (the selected one by default) at 100% zoom."
6828
+ },
6829
+ {
6830
+ "kind": "method",
6831
+ "name": "zoomBy",
6832
+ "return": {
6833
+ "type": {
6834
+ "text": "void"
6835
+ }
6836
+ },
6837
+ "parameters": [
6838
+ {
6839
+ "name": "factor",
6840
+ "type": {
6841
+ "text": "number"
6842
+ }
6843
+ }
6844
+ ],
6845
+ "description": "Zooms by `factor` (e.g. `1.25` or `0.8`) around the center of the view."
6846
+ },
6847
+ {
6848
+ "kind": "field",
6849
+ "name": "_controls",
6850
+ "type": {
6851
+ "text": "DagControl[]"
6852
+ },
6853
+ "privacy": "private",
6854
+ "description": "The enabled `controls`, in their fixed order; none in static mode or without nodes.",
6855
+ "readonly": true
6856
+ },
6857
+ {
6858
+ "kind": "method",
6859
+ "name": "_renderToolbar",
6860
+ "privacy": "private"
6861
+ },
6862
+ {
6863
+ "kind": "method",
6864
+ "name": "_toggleDirection",
6865
+ "privacy": "private",
6866
+ "return": {
6867
+ "type": {
6868
+ "text": "void"
6869
+ }
6870
+ }
6871
+ },
6872
+ {
6873
+ "kind": "method",
6874
+ "name": "_renderEdges",
6875
+ "privacy": "private",
6876
+ "return": {
6877
+ "type": {
6878
+ "text": "SVGTemplateResult[]"
6879
+ }
6880
+ }
6881
+ },
6882
+ {
6883
+ "kind": "method",
6884
+ "name": "_renderNode",
6885
+ "privacy": "private",
6886
+ "return": {
6887
+ "type": {
6888
+ "text": "SVGTemplateResult"
6889
+ }
6890
+ },
6891
+ "parameters": [
6892
+ {
6893
+ "name": "position",
6894
+ "type": {
6895
+ "text": "DagLayoutNode"
6896
+ }
6897
+ }
6898
+ ]
6899
+ },
6900
+ {
6901
+ "kind": "method",
6902
+ "name": "_renderLegend",
6903
+ "privacy": "private"
6904
+ },
6905
+ {
6906
+ "kind": "method",
6907
+ "name": "_edgeKey",
6908
+ "privacy": "private",
6909
+ "return": {
6910
+ "type": {
6911
+ "text": "string"
6912
+ }
6913
+ },
6914
+ "parameters": [
6915
+ {
6916
+ "name": "edge",
6917
+ "type": {
6918
+ "text": "{ source: string; target: string }"
6919
+ }
6920
+ }
6921
+ ]
6922
+ },
6923
+ {
6924
+ "kind": "method",
6925
+ "name": "_layoutChanged",
6926
+ "privacy": "private",
6927
+ "return": {
6928
+ "type": {
6929
+ "text": "boolean"
6930
+ }
6931
+ },
6932
+ "parameters": [
6933
+ {
6934
+ "name": "changed",
6935
+ "type": {
6936
+ "text": "PropertyValues<this>"
6937
+ }
6938
+ }
6939
+ ]
6940
+ },
6941
+ {
6942
+ "kind": "method",
6943
+ "name": "_relayout",
6944
+ "privacy": "private",
6945
+ "return": {
6946
+ "type": {
6947
+ "text": "void"
6948
+ }
6949
+ },
6950
+ "description": "Lays the graph out again, keeping the selected node where it was on screen."
6951
+ },
6952
+ {
6953
+ "kind": "method",
6954
+ "name": "_initView",
6955
+ "privacy": "private",
6956
+ "return": {
6957
+ "type": {
6958
+ "text": "void"
6959
+ }
6960
+ }
6961
+ },
6962
+ {
6963
+ "kind": "method",
6964
+ "name": "_frame",
6965
+ "privacy": "private",
6966
+ "return": {
6967
+ "type": {
6968
+ "text": "void"
6969
+ }
6970
+ },
6971
+ "description": "Shows the whole graph when it fits at a readable zoom (always, when static); otherwise centers the selected\nnode at 100%."
6972
+ },
6973
+ {
6974
+ "kind": "method",
6975
+ "name": "_revealSelected",
6976
+ "privacy": "private",
6977
+ "return": {
6978
+ "type": {
6979
+ "text": "void"
6980
+ }
6981
+ },
6982
+ "description": "Brings the selected node into view if it is outside the visible area."
6983
+ },
6984
+ {
6985
+ "kind": "method",
6986
+ "name": "_updateMeasure",
6987
+ "privacy": "private",
6988
+ "return": {
6989
+ "type": {
6990
+ "text": "void"
6991
+ }
6992
+ },
6993
+ "description": "Measures labels with the host's actual font, so themes with other fonts still size cards correctly."
6994
+ },
6995
+ {
6996
+ "kind": "method",
6997
+ "name": "_resize",
6998
+ "privacy": "private",
6999
+ "return": {
7000
+ "type": {
7001
+ "text": "void"
7002
+ }
7003
+ },
7004
+ "parameters": [
7005
+ {
7006
+ "name": "rect",
7007
+ "type": {
7008
+ "text": "DOMRectReadOnly | undefined"
7009
+ }
7010
+ }
7011
+ ]
7012
+ },
7013
+ {
7014
+ "kind": "method",
7015
+ "name": "_clamp",
7016
+ "privacy": "private",
7017
+ "return": {
7018
+ "type": {
7019
+ "text": "number"
7020
+ }
7021
+ },
7022
+ "parameters": [
7023
+ {
7024
+ "name": "k",
7025
+ "type": {
7026
+ "text": "number"
7027
+ }
7028
+ }
7029
+ ]
7030
+ },
7031
+ {
7032
+ "kind": "method",
7033
+ "name": "_centerOn",
7034
+ "privacy": "private",
7035
+ "return": {
7036
+ "type": {
7037
+ "text": "void"
7038
+ }
7039
+ },
7040
+ "parameters": [
7041
+ {
7042
+ "name": "point",
7043
+ "type": {
7044
+ "text": "DagPoint"
7045
+ }
7046
+ },
7047
+ {
7048
+ "name": "k",
7049
+ "type": {
7050
+ "text": "number"
7051
+ }
7052
+ }
7053
+ ]
7054
+ },
7055
+ {
7056
+ "kind": "method",
7057
+ "name": "_zoomAround",
7058
+ "privacy": "private",
7059
+ "return": {
7060
+ "type": {
7061
+ "text": "void"
7062
+ }
7063
+ },
7064
+ "parameters": [
7065
+ {
7066
+ "name": "screenX",
7067
+ "type": {
7068
+ "text": "number"
7069
+ }
7070
+ },
7071
+ {
7072
+ "name": "screenY",
7073
+ "type": {
7074
+ "text": "number"
7075
+ }
7076
+ },
7077
+ {
7078
+ "name": "factor",
7079
+ "type": {
7080
+ "text": "number"
7081
+ }
7082
+ }
7083
+ ]
7084
+ },
7085
+ {
7086
+ "kind": "method",
7087
+ "name": "_activate",
7088
+ "privacy": "private",
7089
+ "return": {
7090
+ "type": {
7091
+ "text": "void"
7092
+ }
7093
+ },
7094
+ "parameters": [
7095
+ {
7096
+ "name": "id",
7097
+ "type": {
7098
+ "text": "string"
7099
+ }
7100
+ }
7101
+ ]
7102
+ },
7103
+ {
7104
+ "kind": "method",
7105
+ "name": "_onNodeKey",
7106
+ "privacy": "private",
7107
+ "return": {
7108
+ "type": {
7109
+ "text": "void"
7110
+ }
7111
+ },
7112
+ "parameters": [
7113
+ {
7114
+ "name": "event",
7115
+ "type": {
7116
+ "text": "KeyboardEvent"
7117
+ }
7118
+ },
7119
+ {
7120
+ "name": "id",
7121
+ "type": {
7122
+ "text": "string"
7123
+ }
7124
+ }
7125
+ ]
7126
+ },
7127
+ {
7128
+ "kind": "method",
7129
+ "name": "_onPointerDown",
7130
+ "privacy": "private",
7131
+ "return": {
7132
+ "type": {
7133
+ "text": "void"
7134
+ }
7135
+ },
7136
+ "parameters": [
7137
+ {
7138
+ "name": "event",
7139
+ "type": {
7140
+ "text": "PointerEvent"
7141
+ }
7142
+ }
7143
+ ]
7144
+ },
7145
+ {
7146
+ "kind": "method",
7147
+ "name": "_onPointerMove",
7148
+ "privacy": "private",
7149
+ "return": {
7150
+ "type": {
7151
+ "text": "void"
7152
+ }
7153
+ },
7154
+ "parameters": [
7155
+ {
7156
+ "name": "event",
7157
+ "type": {
7158
+ "text": "PointerEvent"
7159
+ }
7160
+ }
7161
+ ]
7162
+ },
7163
+ {
7164
+ "kind": "method",
7165
+ "name": "_onPointerUp",
7166
+ "privacy": "private",
7167
+ "return": {
7168
+ "type": {
7169
+ "text": "void"
7170
+ }
7171
+ },
7172
+ "parameters": [
7173
+ {
7174
+ "name": "event",
7175
+ "type": {
7176
+ "text": "PointerEvent"
7177
+ }
7178
+ }
7179
+ ]
7180
+ },
7181
+ {
7182
+ "kind": "method",
7183
+ "name": "_onWheel",
7184
+ "privacy": "private",
7185
+ "return": {
7186
+ "type": {
7187
+ "text": "void"
7188
+ }
7189
+ },
7190
+ "parameters": [
7191
+ {
7192
+ "name": "event",
7193
+ "type": {
7194
+ "text": "WheelEvent"
7195
+ }
7196
+ }
7197
+ ],
7198
+ "description": "Pinch gestures and Ctrl/⌘ + wheel zoom; a plain wheel is left to the page so it can scroll."
7199
+ },
7200
+ {
7201
+ "kind": "method",
7202
+ "name": "_onKeyDown",
7203
+ "privacy": "private",
7204
+ "return": {
7205
+ "type": {
7206
+ "text": "void"
7207
+ }
7208
+ },
7209
+ "parameters": [
7210
+ {
7211
+ "name": "event",
7212
+ "type": {
7213
+ "text": "KeyboardEvent"
7214
+ }
7215
+ }
7216
+ ]
7217
+ }
7218
+ ],
7219
+ "events": [
7220
+ {
7221
+ "name": "direction-change",
7222
+ "type": {
7223
+ "text": "CustomEvent"
7224
+ },
7225
+ "description": "The toolbar's direction control flipped `direction`; `detail` is `{ direction }`."
7226
+ },
7227
+ {
7228
+ "name": "node-select",
7229
+ "type": {
7230
+ "text": "CustomEvent"
7231
+ },
7232
+ "description": "A node was clicked or activated with the keyboard; `detail` is `{ id }`."
7233
+ }
7234
+ ],
7235
+ "attributes": [
7236
+ {
7237
+ "name": "nodes",
7238
+ "type": {
7239
+ "text": "DagNode[]"
7240
+ },
7241
+ "default": "[]",
7242
+ "description": "Nodes to draw.",
7243
+ "fieldName": "nodes"
7244
+ },
7245
+ {
7246
+ "name": "edges",
7247
+ "type": {
7248
+ "text": "DagEdge[]"
7249
+ },
7250
+ "default": "[]",
7251
+ "description": "Directed edges between `nodes`; edges with an unknown endpoint or to the node itself are ignored.",
7252
+ "fieldName": "edges"
7253
+ },
7254
+ {
7255
+ "name": "selected",
7256
+ "type": {
7257
+ "text": "string | null"
7258
+ },
7259
+ "default": "null",
7260
+ "description": "Id of the selected node. Selecting a node updates it; when it changes to a node outside the visible area,\nthe view follows.",
7261
+ "fieldName": "selected"
7262
+ },
7263
+ {
7264
+ "name": "direction",
7265
+ "type": {
7266
+ "text": "DagDirection"
7267
+ },
7268
+ "default": "\"LR\"",
7269
+ "description": "Layer direction: `LR` (left to right) or `TB` (top to bottom).",
7270
+ "fieldName": "direction"
7271
+ },
7272
+ {
7273
+ "name": "label",
7274
+ "type": {
7275
+ "text": "string"
7276
+ },
7277
+ "default": "\"Directed graph\"",
7278
+ "description": "Accessible name of the graph; the node and edge counts are appended.",
7279
+ "fieldName": "label"
7280
+ },
7281
+ {
7282
+ "name": "legend",
7283
+ "type": {
7284
+ "text": "boolean"
7285
+ },
7286
+ "default": "false",
7287
+ "description": "Shows a legend of `kinds` below the graph.",
7288
+ "fieldName": "legend"
7289
+ },
7290
+ {
7291
+ "name": "controls",
7292
+ "type": {
7293
+ "text": "string"
7294
+ },
7295
+ "default": "\"zoom fit center\"",
7296
+ "description": "Space-separated toolbar controls to show: any of `zoom`, `fit`, `center`, and `direction`, in that\norder. An empty value hides the toolbar.",
7297
+ "fieldName": "controls"
7298
+ },
7299
+ {
7300
+ "name": "static",
7301
+ "type": {
7302
+ "text": "boolean"
7303
+ },
7304
+ "default": "false",
7305
+ "description": "Presents a static picture: always fitted, with panning, zooming, and the toolbar turned off.",
7306
+ "fieldName": "isStatic"
7307
+ }
7308
+ ],
7309
+ "superclass": {
7310
+ "name": "LitElement",
7311
+ "package": "lit"
7312
+ },
7313
+ "tagName": "dag-graph",
7314
+ "customElement": true
7315
+ }
7316
+ ],
7317
+ "exports": [
7318
+ {
7319
+ "kind": "js",
7320
+ "name": "DagDirection",
7321
+ "declaration": {
7322
+ "name": "DagDirection",
7323
+ "module": "./utils/dag-layout.js"
7324
+ }
7325
+ },
7326
+ {
7327
+ "kind": "js",
7328
+ "name": "DagGraph",
7329
+ "declaration": {
7330
+ "name": "DagGraph",
7331
+ "module": "src/dag-graph.ts"
7332
+ }
7333
+ },
7334
+ {
7335
+ "kind": "custom-element-definition",
7336
+ "name": "dag-graph",
7337
+ "declaration": {
7338
+ "name": "DagGraph",
7339
+ "module": "src/dag-graph.ts"
7340
+ }
7341
+ }
7342
+ ]
7343
+ },
6560
7344
  {
6561
7345
  "kind": "javascript-module",
6562
7346
  "path": "src/data-table.ts",
6563
7347
  "declarations": [
6564
7348
  {
6565
7349
  "kind": "class",
6566
- "description": "A generic, presentational table shell: renders a `<thead>` from `columns`\nand one `<tr>` per entry in `rows`, with each cell's content produced by\n`renderCell` (default: plain property lookup on the row object). Knows\nnothing about what a \"row\" means — callers own the data shape entirely.\n\nOptional `rowHref` makes whole rows clickable (navigating via `location.hash`),\nwithout hijacking clicks on nested interactive elements (links/buttons) a\ncell's rendered content might contain.",
7350
+ "description": "A generic, presentational table shell: renders a `<thead>` from `columns`\nand one `<tr>` per entry in `rows`, with each cell's content produced by\n`renderCell` (default: plain property lookup on the row object). Knows\nnothing about what a \"row\" means — callers own the data shape entirely.\n\nEach column may add a decorative header `icon` and an `align` for its\nheader and cells (`end` right-aligns numbers, with tabular figures).\n\nOptional `rowHref` makes whole rows clickable (navigating via `location.hash`),\nwithout hijacking clicks on nested interactive elements (links/buttons) a\ncell's rendered content might contain.",
6567
7351
  "name": "DataTable",
6568
7352
  "members": [
6569
7353
  {
@@ -6666,6 +7450,24 @@
6666
7450
  }
6667
7451
  ]
6668
7452
  },
7453
+ {
7454
+ "kind": "method",
7455
+ "name": "#alignClass",
7456
+ "privacy": "private",
7457
+ "return": {
7458
+ "type": {
7459
+ "text": "string"
7460
+ }
7461
+ },
7462
+ "parameters": [
7463
+ {
7464
+ "name": "column",
7465
+ "type": {
7466
+ "text": "DataTableColumn"
7467
+ }
7468
+ }
7469
+ ]
7470
+ },
6669
7471
  {
6670
7472
  "kind": "method",
6671
7473
  "name": "#rowLinkLabel",
@@ -9307,113 +10109,201 @@
9307
10109
  "fieldName": "disabled"
9308
10110
  }
9309
10111
  ],
9310
- "superclass": {
9311
- "name": "LitElement",
9312
- "package": "lit"
9313
- },
9314
- "tagName": "icon-button",
9315
- "customElement": true
9316
- }
9317
- ],
9318
- "exports": [
9319
- {
9320
- "kind": "js",
9321
- "name": "IconButton",
9322
- "declaration": {
9323
- "name": "IconButton",
9324
- "module": "src/icon-button.ts"
9325
- }
10112
+ "superclass": {
10113
+ "name": "LitElement",
10114
+ "package": "lit"
10115
+ },
10116
+ "tagName": "icon-button",
10117
+ "customElement": true
10118
+ }
10119
+ ],
10120
+ "exports": [
10121
+ {
10122
+ "kind": "js",
10123
+ "name": "IconButton",
10124
+ "declaration": {
10125
+ "name": "IconButton",
10126
+ "module": "src/icon-button.ts"
10127
+ }
10128
+ },
10129
+ {
10130
+ "kind": "custom-element-definition",
10131
+ "name": "icon-button",
10132
+ "declaration": {
10133
+ "name": "IconButton",
10134
+ "module": "src/icon-button.ts"
10135
+ }
10136
+ }
10137
+ ]
10138
+ },
10139
+ {
10140
+ "kind": "javascript-module",
10141
+ "path": "src/icons.ts",
10142
+ "declarations": [
10143
+ {
10144
+ "kind": "function",
10145
+ "name": "iconX",
10146
+ "parameters": [
10147
+ {
10148
+ "name": "size",
10149
+ "default": "18"
10150
+ }
10151
+ ],
10152
+ "description": "Close, dismiss, or clear (e.g. a modal, toast, or clearable input)."
10153
+ },
10154
+ {
10155
+ "kind": "function",
10156
+ "name": "iconBars3",
10157
+ "parameters": [
10158
+ {
10159
+ "name": "size",
10160
+ "default": "18"
10161
+ }
10162
+ ],
10163
+ "description": "A hamburger menu toggle, e.g. collapsing or opening a sidebar/nav drawer."
10164
+ },
10165
+ {
10166
+ "kind": "function",
10167
+ "name": "iconChevronLeft",
10168
+ "parameters": [
10169
+ {
10170
+ "name": "size",
10171
+ "default": "16"
10172
+ }
10173
+ ],
10174
+ "description": "\"Previous\" navigation, e.g. pagination or carousel back controls."
10175
+ },
10176
+ {
10177
+ "kind": "function",
10178
+ "name": "iconChevronRight",
10179
+ "parameters": [
10180
+ {
10181
+ "name": "size",
10182
+ "default": "16"
10183
+ }
10184
+ ],
10185
+ "description": "\"Next\" navigation, or a collapsed disclosure/submenu indicator."
10186
+ },
10187
+ {
10188
+ "kind": "function",
10189
+ "name": "iconChevronUp",
10190
+ "parameters": [
10191
+ {
10192
+ "name": "size",
10193
+ "default": "16"
10194
+ }
10195
+ ],
10196
+ "description": "\"Scroll to top\", or an expanded/upward disclosure control."
10197
+ },
10198
+ {
10199
+ "kind": "function",
10200
+ "name": "iconCog",
10201
+ "parameters": [
10202
+ {
10203
+ "name": "size",
10204
+ "default": "20"
10205
+ }
10206
+ ],
10207
+ "description": "Settings, preferences, or configuration entry points."
10208
+ },
10209
+ {
10210
+ "kind": "function",
10211
+ "name": "iconInfo",
10212
+ "parameters": [
10213
+ {
10214
+ "name": "size",
10215
+ "default": "20"
10216
+ }
10217
+ ],
10218
+ "description": "Neutral informational messages, e.g. an info toast or status banner."
9326
10219
  },
9327
10220
  {
9328
- "kind": "custom-element-definition",
9329
- "name": "icon-button",
9330
- "declaration": {
9331
- "name": "IconButton",
9332
- "module": "src/icon-button.ts"
9333
- }
9334
- }
9335
- ]
9336
- },
9337
- {
9338
- "kind": "javascript-module",
9339
- "path": "src/icons.ts",
9340
- "declarations": [
10221
+ "kind": "function",
10222
+ "name": "iconMagnifyingGlassPlus",
10223
+ "parameters": [
10224
+ {
10225
+ "name": "size",
10226
+ "default": "18"
10227
+ }
10228
+ ],
10229
+ "description": "Zoom in, e.g. dag-graph's toolbar."
10230
+ },
9341
10231
  {
9342
10232
  "kind": "function",
9343
- "name": "iconX",
10233
+ "name": "iconMagnifyingGlassMinus",
9344
10234
  "parameters": [
9345
10235
  {
9346
10236
  "name": "size",
9347
10237
  "default": "18"
9348
10238
  }
9349
10239
  ],
9350
- "description": "Close, dismiss, or clear (e.g. a modal, toast, or clearable input)."
10240
+ "description": "Zoom out, e.g. dag-graph's toolbar."
9351
10241
  },
9352
10242
  {
9353
10243
  "kind": "function",
9354
- "name": "iconBars3",
10244
+ "name": "iconViewfinderCircle",
9355
10245
  "parameters": [
9356
10246
  {
9357
10247
  "name": "size",
9358
10248
  "default": "18"
9359
10249
  }
9360
10250
  ],
9361
- "description": "A hamburger menu toggle, e.g. collapsing or opening a sidebar/nav drawer."
10251
+ "description": "Center or focus the view on the current selection, e.g. dag-graph's toolbar."
9362
10252
  },
9363
10253
  {
9364
10254
  "kind": "function",
9365
- "name": "iconChevronLeft",
10255
+ "name": "iconArrowLongRight",
9366
10256
  "parameters": [
9367
10257
  {
9368
10258
  "name": "size",
9369
- "default": "16"
10259
+ "default": "18"
9370
10260
  }
9371
10261
  ],
9372
- "description": "\"Previous\" navigation, e.g. pagination or carousel back controls."
10262
+ "description": "A left-to-right flow or layout direction."
9373
10263
  },
9374
10264
  {
9375
10265
  "kind": "function",
9376
- "name": "iconChevronRight",
10266
+ "name": "iconArrowLongDown",
9377
10267
  "parameters": [
9378
10268
  {
9379
10269
  "name": "size",
9380
- "default": "16"
10270
+ "default": "18"
9381
10271
  }
9382
10272
  ],
9383
- "description": "\"Next\" navigation, or a collapsed disclosure/submenu indicator."
10273
+ "description": "A top-to-bottom flow or layout direction."
9384
10274
  },
9385
10275
  {
9386
10276
  "kind": "function",
9387
- "name": "iconChevronUp",
10277
+ "name": "iconBookOpen",
9388
10278
  "parameters": [
9389
10279
  {
9390
10280
  "name": "size",
9391
- "default": "16"
10281
+ "default": "20"
9392
10282
  }
9393
10283
  ],
9394
- "description": "\"Scroll to top\", or an expanded/upward disclosure control."
10284
+ "description": "A library, documentation, or reading content, e.g. a library node in dag-graph."
9395
10285
  },
9396
10286
  {
9397
10287
  "kind": "function",
9398
- "name": "iconCog",
10288
+ "name": "iconCube",
9399
10289
  "parameters": [
9400
10290
  {
9401
10291
  "name": "size",
9402
10292
  "default": "20"
9403
10293
  }
9404
10294
  ],
9405
- "description": "Settings, preferences, or configuration entry points."
10295
+ "description": "A package or self-contained artifact, e.g. an external package node in dag-graph."
9406
10296
  },
9407
10297
  {
9408
10298
  "kind": "function",
9409
- "name": "iconInfo",
10299
+ "name": "iconServer",
9410
10300
  "parameters": [
9411
10301
  {
9412
10302
  "name": "size",
9413
10303
  "default": "20"
9414
10304
  }
9415
10305
  ],
9416
- "description": "Neutral informational messages, e.g. an info toast or status banner."
10306
+ "description": "A running service or deployable, e.g. a service node in dag-graph."
9417
10307
  },
9418
10308
  {
9419
10309
  "kind": "function",
@@ -10122,6 +11012,70 @@
10122
11012
  "module": "src/icons.ts"
10123
11013
  }
10124
11014
  },
11015
+ {
11016
+ "kind": "js",
11017
+ "name": "iconMagnifyingGlassPlus",
11018
+ "declaration": {
11019
+ "name": "iconMagnifyingGlassPlus",
11020
+ "module": "src/icons.ts"
11021
+ }
11022
+ },
11023
+ {
11024
+ "kind": "js",
11025
+ "name": "iconMagnifyingGlassMinus",
11026
+ "declaration": {
11027
+ "name": "iconMagnifyingGlassMinus",
11028
+ "module": "src/icons.ts"
11029
+ }
11030
+ },
11031
+ {
11032
+ "kind": "js",
11033
+ "name": "iconViewfinderCircle",
11034
+ "declaration": {
11035
+ "name": "iconViewfinderCircle",
11036
+ "module": "src/icons.ts"
11037
+ }
11038
+ },
11039
+ {
11040
+ "kind": "js",
11041
+ "name": "iconArrowLongRight",
11042
+ "declaration": {
11043
+ "name": "iconArrowLongRight",
11044
+ "module": "src/icons.ts"
11045
+ }
11046
+ },
11047
+ {
11048
+ "kind": "js",
11049
+ "name": "iconArrowLongDown",
11050
+ "declaration": {
11051
+ "name": "iconArrowLongDown",
11052
+ "module": "src/icons.ts"
11053
+ }
11054
+ },
11055
+ {
11056
+ "kind": "js",
11057
+ "name": "iconBookOpen",
11058
+ "declaration": {
11059
+ "name": "iconBookOpen",
11060
+ "module": "src/icons.ts"
11061
+ }
11062
+ },
11063
+ {
11064
+ "kind": "js",
11065
+ "name": "iconCube",
11066
+ "declaration": {
11067
+ "name": "iconCube",
11068
+ "module": "src/icons.ts"
11069
+ }
11070
+ },
11071
+ {
11072
+ "kind": "js",
11073
+ "name": "iconServer",
11074
+ "declaration": {
11075
+ "name": "iconServer",
11076
+ "module": "src/icons.ts"
11077
+ }
11078
+ },
10125
11079
  {
10126
11080
  "kind": "js",
10127
11081
  "name": "iconQuestionMarkCircle",
@@ -10921,6 +11875,70 @@
10921
11875
  "module": "./weight-bar-chart.js"
10922
11876
  }
10923
11877
  },
11878
+ {
11879
+ "kind": "js",
11880
+ "name": "DagGraph",
11881
+ "declaration": {
11882
+ "name": "DagGraph",
11883
+ "module": "./dag-graph.js"
11884
+ }
11885
+ },
11886
+ {
11887
+ "kind": "js",
11888
+ "name": "DagControl",
11889
+ "declaration": {
11890
+ "name": "DagControl",
11891
+ "module": "./dag-graph.js"
11892
+ }
11893
+ },
11894
+ {
11895
+ "kind": "js",
11896
+ "name": "DagDirection",
11897
+ "declaration": {
11898
+ "name": "DagDirection",
11899
+ "module": "./dag-graph.js"
11900
+ }
11901
+ },
11902
+ {
11903
+ "kind": "js",
11904
+ "name": "DagDirectionChangeDetail",
11905
+ "declaration": {
11906
+ "name": "DagDirectionChangeDetail",
11907
+ "module": "./dag-graph.js"
11908
+ }
11909
+ },
11910
+ {
11911
+ "kind": "js",
11912
+ "name": "DagEdge",
11913
+ "declaration": {
11914
+ "name": "DagEdge",
11915
+ "module": "./dag-graph.js"
11916
+ }
11917
+ },
11918
+ {
11919
+ "kind": "js",
11920
+ "name": "DagNode",
11921
+ "declaration": {
11922
+ "name": "DagNode",
11923
+ "module": "./dag-graph.js"
11924
+ }
11925
+ },
11926
+ {
11927
+ "kind": "js",
11928
+ "name": "DagNodeKind",
11929
+ "declaration": {
11930
+ "name": "DagNodeKind",
11931
+ "module": "./dag-graph.js"
11932
+ }
11933
+ },
11934
+ {
11935
+ "kind": "js",
11936
+ "name": "DagNodeSelectDetail",
11937
+ "declaration": {
11938
+ "name": "DagNodeSelectDetail",
11939
+ "module": "./dag-graph.js"
11940
+ }
11941
+ },
10924
11942
  {
10925
11943
  "kind": "js",
10926
11944
  "name": "AddressAutocomplete",
@@ -11241,6 +12259,22 @@
11241
12259
  "module": "./ui-checkbox.js"
11242
12260
  }
11243
12261
  },
12262
+ {
12263
+ "kind": "js",
12264
+ "name": "UiTooltip",
12265
+ "declaration": {
12266
+ "name": "UiTooltip",
12267
+ "module": "./ui-tooltip.js"
12268
+ }
12269
+ },
12270
+ {
12271
+ "kind": "js",
12272
+ "name": "UiTooltipPlacement",
12273
+ "declaration": {
12274
+ "name": "UiTooltipPlacement",
12275
+ "module": "./ui-tooltip.js"
12276
+ }
12277
+ },
11244
12278
  {
11245
12279
  "kind": "js",
11246
12280
  "name": "FormField",
@@ -11297,6 +12331,14 @@
11297
12331
  "module": "./data-table.js"
11298
12332
  }
11299
12333
  },
12334
+ {
12335
+ "kind": "js",
12336
+ "name": "DataTableAlign",
12337
+ "declaration": {
12338
+ "name": "DataTableAlign",
12339
+ "module": "./data-table.js"
12340
+ }
12341
+ },
11300
12342
  {
11301
12343
  "kind": "js",
11302
12344
  "name": "DataTableColumn",
@@ -11385,6 +12427,22 @@
11385
12427
  "module": "./kbd-hint.js"
11386
12428
  }
11387
12429
  },
12430
+ {
12431
+ "kind": "js",
12432
+ "name": "KindIcon",
12433
+ "declaration": {
12434
+ "name": "KindIcon",
12435
+ "module": "./kind-icon.js"
12436
+ }
12437
+ },
12438
+ {
12439
+ "kind": "js",
12440
+ "name": "KindIconStyle",
12441
+ "declaration": {
12442
+ "name": "KindIconStyle",
12443
+ "module": "./kind-icon.js"
12444
+ }
12445
+ },
11388
12446
  {
11389
12447
  "kind": "js",
11390
12448
  "name": "FrameBox",
@@ -13032,38 +14090,145 @@
13032
14090
  "fieldName": "keys"
13033
14091
  },
13034
14092
  {
13035
- "name": "platform",
14093
+ "name": "platform",
14094
+ "type": {
14095
+ "text": "KbdPlatform"
14096
+ },
14097
+ "default": "\"auto\"",
14098
+ "description": "Platform override; `auto` detects macOS from the browser.",
14099
+ "fieldName": "platform"
14100
+ }
14101
+ ],
14102
+ "superclass": {
14103
+ "name": "LitElement",
14104
+ "package": "lit"
14105
+ },
14106
+ "tagName": "kbd-hint",
14107
+ "customElement": true
14108
+ }
14109
+ ],
14110
+ "exports": [
14111
+ {
14112
+ "kind": "js",
14113
+ "name": "KbdHint",
14114
+ "declaration": {
14115
+ "name": "KbdHint",
14116
+ "module": "src/kbd-hint.ts"
14117
+ }
14118
+ },
14119
+ {
14120
+ "kind": "custom-element-definition",
14121
+ "name": "kbd-hint",
14122
+ "declaration": {
14123
+ "name": "KbdHint",
14124
+ "module": "src/kbd-hint.ts"
14125
+ }
14126
+ }
14127
+ ]
14128
+ },
14129
+ {
14130
+ "kind": "javascript-module",
14131
+ "path": "src/kind-icon.ts",
14132
+ "declarations": [
14133
+ {
14134
+ "kind": "class",
14135
+ "description": "Inline icon for a named kind (e.g. a service, a library, an external\npackage), looked up in a shared `kinds` map so tables, lists, and search\nresults show the same icon and color as a `dag-graph` legend. With\n`show-label` the kind's label follows the icon as text; otherwise the\nicon alone is exposed as an image named by the label. Renders nothing for\na kind missing from `kinds`.",
14136
+ "name": "KindIcon",
14137
+ "members": [
14138
+ {
14139
+ "kind": "field",
14140
+ "name": "kind",
14141
+ "type": {
14142
+ "text": "string"
14143
+ },
14144
+ "default": "\"\"",
14145
+ "description": "Key of the kind to show, looked up in `kinds`.",
14146
+ "attribute": "kind",
14147
+ "reflects": true
14148
+ },
14149
+ {
14150
+ "kind": "field",
14151
+ "name": "kinds",
14152
+ "type": {
14153
+ "text": "Record<string, KindIconStyle>"
14154
+ },
14155
+ "default": "{}",
14156
+ "description": "Presentation per kind: label, color, and icon. Shareable with `dag-graph`'s `kinds`."
14157
+ },
14158
+ {
14159
+ "kind": "field",
14160
+ "name": "size",
14161
+ "type": {
14162
+ "text": "14 | 18"
14163
+ },
14164
+ "default": "14",
14165
+ "description": "Square icon size in pixels: 14 inline, 18 standalone.",
14166
+ "attribute": "size"
14167
+ },
14168
+ {
14169
+ "kind": "field",
14170
+ "name": "showLabel",
14171
+ "type": {
14172
+ "text": "boolean"
14173
+ },
14174
+ "default": "false",
14175
+ "description": "Shows the kind's label as text after the icon.",
14176
+ "attribute": "show-label",
14177
+ "reflects": true
14178
+ }
14179
+ ],
14180
+ "attributes": [
14181
+ {
14182
+ "name": "kind",
14183
+ "type": {
14184
+ "text": "string"
14185
+ },
14186
+ "default": "\"\"",
14187
+ "description": "Key of the kind to show, looked up in `kinds`.",
14188
+ "fieldName": "kind"
14189
+ },
14190
+ {
14191
+ "name": "size",
14192
+ "type": {
14193
+ "text": "14 | 18"
14194
+ },
14195
+ "default": "14",
14196
+ "description": "Square icon size in pixels: 14 inline, 18 standalone.",
14197
+ "fieldName": "size"
14198
+ },
14199
+ {
14200
+ "name": "show-label",
13036
14201
  "type": {
13037
- "text": "KbdPlatform"
14202
+ "text": "boolean"
13038
14203
  },
13039
- "default": "\"auto\"",
13040
- "description": "Platform override; `auto` detects macOS from the browser.",
13041
- "fieldName": "platform"
14204
+ "default": "false",
14205
+ "description": "Shows the kind's label as text after the icon.",
14206
+ "fieldName": "showLabel"
13042
14207
  }
13043
14208
  ],
13044
14209
  "superclass": {
13045
14210
  "name": "LitElement",
13046
14211
  "package": "lit"
13047
14212
  },
13048
- "tagName": "kbd-hint",
14213
+ "tagName": "kind-icon",
13049
14214
  "customElement": true
13050
14215
  }
13051
14216
  ],
13052
14217
  "exports": [
13053
14218
  {
13054
14219
  "kind": "js",
13055
- "name": "KbdHint",
14220
+ "name": "KindIcon",
13056
14221
  "declaration": {
13057
- "name": "KbdHint",
13058
- "module": "src/kbd-hint.ts"
14222
+ "name": "KindIcon",
14223
+ "module": "src/kind-icon.ts"
13059
14224
  }
13060
14225
  },
13061
14226
  {
13062
14227
  "kind": "custom-element-definition",
13063
- "name": "kbd-hint",
14228
+ "name": "kind-icon",
13064
14229
  "declaration": {
13065
- "name": "KbdHint",
13066
- "module": "src/kbd-hint.ts"
14230
+ "name": "KindIcon",
14231
+ "module": "src/kind-icon.ts"
13067
14232
  }
13068
14233
  }
13069
14234
  ]
@@ -20938,7 +22103,7 @@
20938
22103
  "type": {
20939
22104
  "text": "Record<string, string>"
20940
22105
  },
20941
- "default": "{ // Colors \"--ui-primary\": \"#4f46e5\", // indigo-600 \"--ui-primary-hover\": \"#4338ca\", // indigo-700 // Button-specific background/border hooks: default to the flat --ui-primary // / --ui-danger tokens above unchanged, so those stay the single source of // truth for every other component. Overriding just these lets a theme opt // ui-button into a gradient (or any other) background without touching // component markup; --ui-button-border/--ui-button-danger-border default // to transparent (today's look) and are meant to be paired with a shade // darker than the gradient's dark stop when one is set. The `-active` // variants default to whatever `-background` already resolved to (so a // solid override still applies while pressed) — a gradient theme should // set them to the same stops in reverse, for a pressed/\"indented\" look. \"--ui-button-background\": \"var(--ui-primary, #4f46e5)\", \"--ui-button-background-hover\": \"var(--ui-primary-hover, #4338ca)\", \"--ui-button-background-active\": \"var(--ui-button-background, var(--ui-primary, #4f46e5))\", \"--ui-button-border\": \"transparent\", // The primary/danger fill's own text color, split out from --ui-on-accent // (which every button used directly until now): --ui-on-accent means \"text // on any solid semantic fill\" and a theme may need to darken it for a light // accent color (see developerDarkTokenValues), but that darkening should // only reach the button itself if the theme wants it to. Defaults to // --ui-on-accent unchanged, so every existing theme renders identically. \"--ui-button-text\": \"var(--ui-on-accent, #ffffff)\", \"--ui-button-danger-text\": \"var(--ui-on-accent, #ffffff)\", // The bordered, transparent-background secondary variant's equivalents — // shared with confirm-dialog's Cancel button, which is the same visual // pattern. Defaults reproduce today's literal secondary styling exactly // (no background at any state, border colors matching --ui-border / // --ui-text-muted), so a theme only needs to override these to make // secondary/Cancel buttons match a primary/danger gradient theme. \"--ui-button-secondary-background\": \"none\", \"--ui-button-secondary-background-hover\": \"none\", \"--ui-button-secondary-background-active\": \"var(--ui-button-secondary-background, none)\", \"--ui-button-secondary-border\": \"var(--ui-border, #e2e8f0)\", \"--ui-button-secondary-border-hover\": \"var(--ui-text-muted, #64748b)\", // A muted-gray surface used wherever something already paints // --ui-surface-muted as a state indicator in flat mode — button-group's // unchecked-segment hover, pagination-nav's button hover, and // radio-cards/radio-pills' checked background — which is a genuinely // different default than secondary's borderless flat hover, so it can't // reuse --ui-button-secondary-background-hover's \"none\" default. \"--ui-button-secondary-surface-muted\": \"var(--ui-surface-muted, #f8fafc)\", // Shared by both primary/danger — a purely cosmetic gloss/legibility pair, // not color-specific, so one token covers both variants. `-highlight` is a // full box-shadow value (e.g. `inset 0 1px 0 rgb(255 255 255 / 0.35)`) for // a glossy top edge, defaulting to a fully transparent (so invisible) // shadow rather than the keyword `none` — some usages combine it with // another literal shadow in a comma-separated list, where a bare `none` // item is invalid CSS and would zero out the *whole* declaration. // `-text-shadow` is a full text-shadow value for label legibility against // a gradient's lighter stop, always used standalone, so it keeps `none`. \"--ui-button-highlight\": \"0 0 0 0 transparent\", \"--ui-button-text-shadow\": \"none\", // A solid stand-in for the same accent, for spots that can't render a // background gradient at all — a native <input>'s accent-color only // accepts a plain color, and a hard-stop background gradient (e.g. // range-slider's filled track) can't nest another gradient inside its own // color-stop list. Consumers that theme the buttons into a gradient should // set this to the gradient's dark stop, so these non-button accents (radio // selection indicators, the range-slider track/thumb) stay visually // coordinated with it even though they can't literally paint a gradient. \"--ui-button-accent\": \"var(--ui-primary, #4f46e5)\", \"--ui-info\": \"#0ea5e9\", // sky-500 \"--ui-info-hover\": \"#0284c7\", // sky-600 \"--ui-danger\": \"#dc2626\", // red-600 \"--ui-danger-hover\": \"#b91c1c\", // red-700 \"--ui-button-danger-background\": \"var(--ui-danger, #dc2626)\", \"--ui-button-danger-background-hover\": \"var(--ui-danger-hover, #b91c1c)\", \"--ui-button-danger-background-active\": \"var(--ui-button-danger-background, var(--ui-danger, #dc2626))\", \"--ui-button-danger-border\": \"transparent\", \"--ui-success\": \"#16a34a\", // green-600 \"--ui-warning\": \"#d97706\", // amber-600 \"--ui-warning-hover\": \"#b45309\", // amber-700 // toast-notification's per-variant background hooks: default to the flat // --ui-success/--ui-danger/--ui-info/--ui-warning tokens unchanged, so // those stay the single source of truth for every other component — // the same pattern as --ui-button-background/--ui-button-danger-background // above. `-highlight`/`-text-shadow` are the same glossy-top-edge / // legibility-shadow pair as --ui-button-highlight/--ui-button-text-shadow, // kept as separate tokens so a theme can gloss toasts and buttons // independently. \"--ui-toast-success-background\": \"var(--ui-success, #16a34a)\", \"--ui-toast-error-background\": \"var(--ui-danger, #dc2626)\", \"--ui-toast-info-background\": \"var(--ui-info, #0ea5e9)\", \"--ui-toast-warning-background\": \"var(--ui-warning, #d97706)\", \"--ui-toast-highlight\": \"0 0 0 0 transparent\", \"--ui-toast-text-shadow\": \"none\", // AI accent sweep — the four stops of the animated multi-hue ring // ui-button's `ai` modifier draws around a button (and the only place a // rainbow reads as meaning \"this action is AI-powered\" rather than a // semantic state). Ordered around the color wheel and looping back to // stop 1, so the sweep is seamless; --ui-ai-2 is --ui-primary's own // indigo, anchoring the ring to the rest of the palette. Overriding these // four retunes every AI button at once. \"--ui-ai-1\": \"#38bdf8\", // sky-400 \"--ui-ai-2\": \"#6366f1\", // indigo-500 \"--ui-ai-3\": \"#d946ef\", // fuchsia-500 \"--ui-ai-4\": \"#fbbf24\", // amber-400 \"--ui-on-accent\": \"#ffffff\", \"--ui-text\": \"#0f172a\", // slate-900 \"--ui-text-muted\": \"#64748b\", // slate-500 \"--ui-border\": \"#e2e8f0\", // slate-200 \"--ui-surface\": \"#ffffff\", // white \"--ui-surface-muted\": \"#f8fafc\", // slate-50 \"--ui-highlight\": \"#fde68a\", // amber-200 — transient \"just changed\" flash \"--ui-tooltip\": \"#0f172a\", // slate-900 // The tooltip's own foreground, kept separate from --ui-on-accent: that // token means \"text on a solid *semantic* fill\" (a button, a toast), which // a theme may need to darken if it makes those fills light (see // developerDarkTokenValues). --ui-tooltip's own fill is a dedicated dark // surface in every theme regardless, so its text stays white unconditionally. \"--ui-tooltip-text\": \"#ffffff\", \"--ui-hover-overlay\": \"rgb(255 255 255 / 0.32)\", \"--ui-overlay\": \"rgb(15 23 42 / 0.45)\", // slate-900 / 45% // Same reasoning as --ui-tooltip-text: a control drawn directly on the // --ui-overlay scrim (photo-gallery's arrow buttons) needs text/icon // contrast against that always-dark backdrop, not against whatever a theme // repoints --ui-on-accent to for its semantic fills. \"--ui-overlay-text\": \"#ffffff\", // Shape / depth \"--ui-radius\": \"0.5rem\", // rounded-lg \"--ui-radius-sm\": \"0.25rem\", // rounded // The width of a themeable surface/control border. Spacing is deliberately // untokenized, but a border is chrome rather than layout: the `blueprint` // theme's whole structure is carried by hairline rules instead of shadows, // and it needs those rules one step heavier than the default. Defaults to // the literal 1px every component used before, so nothing renders // differently until a theme overrides it. Only genuine surface/control // borders read this — forced-colors `CanvasText` borders and purely // decorative literals (a slider thumb's white ring, a tab's 2px underline) // keep their own widths, since those aren't the theme's structural rules. // Anything with a fixed height/width and a themeable border must also set // `box-sizing: border-box`, or a heavier border grows it past the shared // 2rem control target. \"--ui-border-width\": \"1px\", // Deliberate pill/circle shapes — a chip, an avatar, a slider thumb, a dot. // Tokenized rather than hardcoded so a theme that squares the design system // (metro) can reach them too; a literal 9999px/50% silently opts that shape // out of every theme. Use these only where the shape is the point, not as a // heavier --ui-radius. \"--ui-radius-pill\": \"9999px\", \"--ui-radius-circle\": \"50%\", \"--ui-shadow\": \"0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1)\", // shadow-md \"--ui-shadow-lg\": \"0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1)\", // shadow-xl \"--ui-focus-ring\": \"0 0 0 3px rgb(79 70 229 / 0.35)\", // Type \"--ui-font\": 'ui-sans-serif, system-ui, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\", \"Noto Color Emoji\"', \"--ui-font-mono\": \"ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace\", \"--ui-font-size-lg\": \"1rem\", // text-base \"--ui-font-size\": \"0.875rem\", // text-sm \"--ui-font-size-sm\": \"0.75rem\", // text-xs \"--ui-font-size-xs\": \"0.6875rem\", // Font weights — the only four weights the system uses. \"--ui-font-weight-regular\": \"400\", \"--ui-font-weight-medium\": \"500\", \"--ui-font-weight-semibold\": \"600\", \"--ui-font-weight-bold\": \"700\", // Line heights — glyph (icon/marker box), tight (headings), normal (body). \"--ui-line-height-glyph\": \"1\", \"--ui-line-height-tight\": \"1.25\", \"--ui-line-height-normal\": \"1.5\", // Letter spacing / tracking — default and the single widened step. \"--ui-tracking-normal\": \"0\", \"--ui-tracking-wide\": \"0.04em\", // Casing of chrome micro-labels — the small, wide-tracked labels that name a // region rather than carry content (a `frame-box` legend, an `app-sidebar` // section heading, a `stat-meter` caption). Defaults to `none`, today's // sentence case, so nothing changes until a theme sets it; the `blueprint` // theme sets `uppercase`, where signage-style labels are the point. Never // apply this to user-supplied content — shouting someone's data is not a // theme's decision, and `text-transform` is a presentational lie that // survives copy/paste as the original casing anyway. \"--ui-label-transform\": \"none\", // Numeral rendering for figures that change in place or stack into a column // — a score, a page number, a running clock. Defaults to `normal` // (proportional, as before); `tabular-nums` stops digits from jittering // horizontally as they tick, which the `blueprint` theme's spec-sheet // aesthetic wants everywhere. \"--ui-numeric\": \"normal\", }",
22106
+ "default": "{ // Colors \"--ui-primary\": \"#4f46e5\", // indigo-600 \"--ui-primary-hover\": \"#4338ca\", // indigo-700 // Button-specific background/border hooks: default to the flat --ui-primary // / --ui-danger tokens above unchanged, so those stay the single source of // truth for every other component. Overriding just these lets a theme opt // ui-button into a gradient (or any other) background without touching // component markup; --ui-button-border/--ui-button-danger-border default // to transparent (today's look) and are meant to be paired with a shade // darker than the gradient's dark stop when one is set. The `-active` // variants default to whatever `-background` already resolved to (so a // solid override still applies while pressed) — a gradient theme should // set them to the same stops in reverse, for a pressed/\"indented\" look. \"--ui-button-background\": \"var(--ui-primary, #4f46e5)\", \"--ui-button-background-hover\": \"var(--ui-primary-hover, #4338ca)\", \"--ui-button-background-active\": \"var(--ui-button-background, var(--ui-primary, #4f46e5))\", \"--ui-button-border\": \"transparent\", // The primary/danger fill's own text color, split out from --ui-on-accent // (which every button used directly until now): --ui-on-accent means \"text // on any solid semantic fill\" and a theme may need to darken it for a light // accent color (see developerDarkTokenValues), but that darkening should // only reach the button itself if the theme wants it to. Defaults to // --ui-on-accent unchanged, so every existing theme renders identically. \"--ui-button-text\": \"var(--ui-on-accent, #ffffff)\", \"--ui-button-danger-text\": \"var(--ui-on-accent, #ffffff)\", // The bordered, transparent-background secondary variant's equivalents — // shared with confirm-dialog's Cancel button, which is the same visual // pattern. Defaults reproduce today's literal secondary styling exactly // (no background at any state, border colors matching --ui-border / // --ui-text-muted), so a theme only needs to override these to make // secondary/Cancel buttons match a primary/danger gradient theme. \"--ui-button-secondary-background\": \"none\", \"--ui-button-secondary-background-hover\": \"none\", \"--ui-button-secondary-background-active\": \"var(--ui-button-secondary-background, none)\", \"--ui-button-secondary-border\": \"var(--ui-border, #e2e8f0)\", \"--ui-button-secondary-border-hover\": \"var(--ui-text-muted, #64748b)\", // A muted-gray surface used wherever something already paints // --ui-surface-muted as a state indicator in flat mode — button-group's // unchecked-segment hover, pagination-nav's button hover, and // radio-cards/radio-pills' checked background — which is a genuinely // different default than secondary's borderless flat hover, so it can't // reuse --ui-button-secondary-background-hover's \"none\" default. \"--ui-button-secondary-surface-muted\": \"var(--ui-surface-muted, #f8fafc)\", // The secondary gloss as two plain stop colors, for SVG surfaces that act // as secondary buttons (dag-graph's nodes): SVG fills can't paint a CSS // linear-gradient, so they build an SVG gradient from these stops instead. // Both default to the flat --ui-surface, i.e. a solid fill; a gradient // theme sets them to its secondary background's stops. \"--ui-button-secondary-gloss-start\": \"var(--ui-surface, #ffffff)\", \"--ui-button-secondary-gloss-end\": \"var(--ui-surface, #ffffff)\", // Shared by both primary/danger — a purely cosmetic gloss/legibility pair, // not color-specific, so one token covers both variants. `-highlight` is a // full box-shadow value (e.g. `inset 0 1px 0 rgb(255 255 255 / 0.35)`) for // a glossy top edge, defaulting to a fully transparent (so invisible) // shadow rather than the keyword `none` — some usages combine it with // another literal shadow in a comma-separated list, where a bare `none` // item is invalid CSS and would zero out the *whole* declaration. // `-text-shadow` is a full text-shadow value for label legibility against // a gradient's lighter stop, always used standalone, so it keeps `none`. \"--ui-button-highlight\": \"0 0 0 0 transparent\", \"--ui-button-text-shadow\": \"none\", // A solid stand-in for the same accent, for spots that can't render a // background gradient at all — a native <input>'s accent-color only // accepts a plain color, and a hard-stop background gradient (e.g. // range-slider's filled track) can't nest another gradient inside its own // color-stop list. Consumers that theme the buttons into a gradient should // set this to the gradient's dark stop, so these non-button accents (radio // selection indicators, the range-slider track/thumb) stay visually // coordinated with it even though they can't literally paint a gradient. \"--ui-button-accent\": \"var(--ui-primary, #4f46e5)\", \"--ui-info\": \"#0ea5e9\", // sky-500 \"--ui-info-hover\": \"#0284c7\", // sky-600 \"--ui-danger\": \"#dc2626\", // red-600 \"--ui-danger-hover\": \"#b91c1c\", // red-700 \"--ui-button-danger-background\": \"var(--ui-danger, #dc2626)\", \"--ui-button-danger-background-hover\": \"var(--ui-danger-hover, #b91c1c)\", \"--ui-button-danger-background-active\": \"var(--ui-button-danger-background, var(--ui-danger, #dc2626))\", \"--ui-button-danger-border\": \"transparent\", \"--ui-success\": \"#16a34a\", // green-600 \"--ui-warning\": \"#d97706\", // amber-600 \"--ui-warning-hover\": \"#b45309\", // amber-700 // toast-notification's per-variant background hooks: default to the flat // --ui-success/--ui-danger/--ui-info/--ui-warning tokens unchanged, so // those stay the single source of truth for every other component — // the same pattern as --ui-button-background/--ui-button-danger-background // above. `-highlight`/`-text-shadow` are the same glossy-top-edge / // legibility-shadow pair as --ui-button-highlight/--ui-button-text-shadow, // kept as separate tokens so a theme can gloss toasts and buttons // independently. \"--ui-toast-success-background\": \"var(--ui-success, #16a34a)\", \"--ui-toast-error-background\": \"var(--ui-danger, #dc2626)\", \"--ui-toast-info-background\": \"var(--ui-info, #0ea5e9)\", \"--ui-toast-warning-background\": \"var(--ui-warning, #d97706)\", \"--ui-toast-highlight\": \"0 0 0 0 transparent\", \"--ui-toast-text-shadow\": \"none\", // AI accent sweep — the four stops of the animated multi-hue ring // ui-button's `ai` modifier draws around a button (and the only place a // rainbow reads as meaning \"this action is AI-powered\" rather than a // semantic state). Ordered around the color wheel and looping back to // stop 1, so the sweep is seamless; --ui-ai-2 is --ui-primary's own // indigo, anchoring the ring to the rest of the palette. Overriding these // four retunes every AI button at once. \"--ui-ai-1\": \"#38bdf8\", // sky-400 \"--ui-ai-2\": \"#6366f1\", // indigo-500 \"--ui-ai-3\": \"#d946ef\", // fuchsia-500 \"--ui-ai-4\": \"#fbbf24\", // amber-400 \"--ui-on-accent\": \"#ffffff\", \"--ui-text\": \"#0f172a\", // slate-900 \"--ui-text-muted\": \"#64748b\", // slate-500 \"--ui-border\": \"#e2e8f0\", // slate-200 \"--ui-surface\": \"#ffffff\", // white \"--ui-surface-muted\": \"#f8fafc\", // slate-50 \"--ui-highlight\": \"#fde68a\", // amber-200 — transient \"just changed\" flash \"--ui-tooltip\": \"#0f172a\", // slate-900 // The tooltip's own foreground, kept separate from --ui-on-accent: that // token means \"text on a solid *semantic* fill\" (a button, a toast), which // a theme may need to darken if it makes those fills light (see // developerDarkTokenValues). --ui-tooltip's own fill is a dedicated dark // surface in every theme regardless, so its text stays white unconditionally. \"--ui-tooltip-text\": \"#ffffff\", \"--ui-hover-overlay\": \"rgb(255 255 255 / 0.32)\", \"--ui-overlay\": \"rgb(15 23 42 / 0.45)\", // slate-900 / 45% // Same reasoning as --ui-tooltip-text: a control drawn directly on the // --ui-overlay scrim (photo-gallery's arrow buttons) needs text/icon // contrast against that always-dark backdrop, not against whatever a theme // repoints --ui-on-accent to for its semantic fills. \"--ui-overlay-text\": \"#ffffff\", // Shape / depth \"--ui-radius\": \"0.5rem\", // rounded-lg \"--ui-radius-sm\": \"0.25rem\", // rounded // The width of a themeable surface/control border. Spacing is deliberately // untokenized, but a border is chrome rather than layout: the `blueprint` // theme's whole structure is carried by hairline rules instead of shadows, // and it needs those rules one step heavier than the default. Defaults to // the literal 1px every component used before, so nothing renders // differently until a theme overrides it. Only genuine surface/control // borders read this — forced-colors `CanvasText` borders and purely // decorative literals (a slider thumb's white ring, a tab's 2px underline) // keep their own widths, since those aren't the theme's structural rules. // Anything with a fixed height/width and a themeable border must also set // `box-sizing: border-box`, or a heavier border grows it past the shared // 2rem control target. \"--ui-border-width\": \"1px\", // Deliberate pill/circle shapes — a chip, an avatar, a slider thumb, a dot. // Tokenized rather than hardcoded so a theme that squares the design system // (metro) can reach them too; a literal 9999px/50% silently opts that shape // out of every theme. Use these only where the shape is the point, not as a // heavier --ui-radius. \"--ui-radius-pill\": \"9999px\", \"--ui-radius-circle\": \"50%\", \"--ui-shadow\": \"0 4px 6px -1px rgb(0 0 0 / 0.1), 0 2px 4px -2px rgb(0 0 0 / 0.1)\", // shadow-md \"--ui-shadow-lg\": \"0 20px 25px -5px rgb(0 0 0 / 0.1), 0 8px 10px -6px rgb(0 0 0 / 0.1)\", // shadow-xl \"--ui-focus-ring\": \"0 0 0 3px rgb(79 70 229 / 0.35)\", // Type \"--ui-font\": 'ui-sans-serif, system-ui, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\", \"Noto Color Emoji\"', \"--ui-font-mono\": \"ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace\", \"--ui-font-size-lg\": \"1rem\", // text-base \"--ui-font-size\": \"0.875rem\", // text-sm \"--ui-font-size-sm\": \"0.75rem\", // text-xs \"--ui-font-size-xs\": \"0.6875rem\", // Font weights — the only four weights the system uses. \"--ui-font-weight-regular\": \"400\", \"--ui-font-weight-medium\": \"500\", \"--ui-font-weight-semibold\": \"600\", \"--ui-font-weight-bold\": \"700\", // Line heights — glyph (icon/marker box), tight (headings), normal (body). \"--ui-line-height-glyph\": \"1\", \"--ui-line-height-tight\": \"1.25\", \"--ui-line-height-normal\": \"1.5\", // Letter spacing / tracking — default and the single widened step. \"--ui-tracking-normal\": \"0\", \"--ui-tracking-wide\": \"0.04em\", // Casing of chrome micro-labels — the small, wide-tracked labels that name a // region rather than carry content (a `frame-box` legend, an `app-sidebar` // section heading, a `stat-meter` caption). Defaults to `none`, today's // sentence case, so nothing changes until a theme sets it; the `blueprint` // theme sets `uppercase`, where signage-style labels are the point. Never // apply this to user-supplied content — shouting someone's data is not a // theme's decision, and `text-transform` is a presentational lie that // survives copy/paste as the original casing anyway. \"--ui-label-transform\": \"none\", // Numeral rendering for figures that change in place or stack into a column // — a score, a page number, a running clock. Defaults to `normal` // (proportional, as before); `tabular-nums` stops digits from jittering // horizontally as they tick, which the `blueprint` theme's spec-sheet // aesthetic wants everywhere. \"--ui-numeric\": \"normal\", }",
20942
22107
  "description": "Design token values, sourced from Tailwind v4's default theme palette.\nEach entry maps a `--ui-*` custom property name to its default value.\nThese are the same values baked in as `var(--ui-*, <fallback>)` fallbacks\nthroughout component styles, so components render correctly with zero\nexternal CSS. Consumers may override any of these by setting the custom\nproperty on `:root` or an ancestor element (see `tokens.css`)."
20943
22108
  },
20944
22109
  {
@@ -20956,7 +22121,7 @@
20956
22121
  "type": {
20957
22122
  "text": "Record<string, string>"
20958
22123
  },
20959
- "default": "{ \"--ui-button-background\": \"linear-gradient(180deg, #6366f1 0%, #4f46e5 100%)\", // indigo-500 -> 600 \"--ui-button-background-hover\": \"linear-gradient(180deg, #818cf8 0%, #6366f1 100%)\", // indigo-400 -> 500 \"--ui-button-background-active\": \"linear-gradient(180deg, #4f46e5 0%, #6366f1 100%)\", // reversed 600 -> 500 \"--ui-button-border\": \"#4338ca\", // indigo-700 \"--ui-button-danger-background\": \"linear-gradient(180deg, #ef4444 0%, #dc2626 100%)\", // red-500 -> 600 \"--ui-button-danger-background-hover\": \"linear-gradient(180deg, #f87171 0%, #ef4444 100%)\", // red-400 -> 500 \"--ui-button-danger-background-active\": \"linear-gradient(180deg, #dc2626 0%, #ef4444 100%)\", // reversed 600 -> 500 \"--ui-button-danger-border\": \"#b91c1c\", // red-700 // Secondary stays neutral gray rather than a saturated hue, matching its // flat \"not the primary action\" role, but one shade darker than the // original white -> slate-50 pairing: at a small button size, that pair // read as flat white with no visible gradient at all. slate-50 -> 100 // keeps enough contrast to actually look like a gradient while still // being clearly lighter/quieter than primary/danger. Border stays // slate-300 (a step past the flat slate-200) so its edge still reads // against the fill. \"--ui-button-secondary-background\": \"linear-gradient(180deg, #f8fafc 0%, #f1f5f9 100%)\", // slate-50 -> 100 \"--ui-button-secondary-background-hover\": \"linear-gradient(180deg, #f1f5f9 0%, #e2e8f0 100%)\", // slate-100 -> 200 \"--ui-button-secondary-background-active\": \"linear-gradient(180deg, #f1f5f9 0%, #f8fafc 100%)\", // reversed 100 -> 50 \"--ui-button-secondary-border\": \"#cbd5e1\", // slate-300 \"--ui-button-secondary-border-hover\": \"#94a3b8\", // slate-400 // button-group's unchecked segments, pagination-nav's prev/next buttons, and // radio-cards/radio-pills' checked background read this rather than // --ui-button-secondary-background (see tokens above). Left flat they were // the one \"secondary\" surface that stayed matte while every actual secondary // button turned glossy, so it tracks the hover gradient rather than a // separate literal that could drift out of step with it. \"--ui-button-secondary-surface-muted\": \"var(--ui-button-secondary-background-hover)\", \"--ui-button-highlight\": \"inset 0 1px 0 rgb(255 255 255 / 0.35)\", // glossy top edge \"--ui-button-text-shadow\": \"0 1px 1px rgb(0 0 0 / 0.25)\", // legibility on primary/danger \"--ui-button-accent\": \"#4338ca\", // indigo-700, matches --ui-button-border // toast-notification: same light-to-dark, one-shade-step gradient // convention as the button variants above; the bottom stop always matches // the flat --ui-success/--ui-danger/--ui-info/--ui-warning value exactly. \"--ui-toast-success-background\": \"linear-gradient(180deg, #22c55e 0%, #16a34a 100%)\", // green-500 -> 600 \"--ui-toast-error-background\": \"linear-gradient(180deg, #ef4444 0%, #dc2626 100%)\", // red-500 -> 600 \"--ui-toast-info-background\": \"linear-gradient(180deg, #38bdf8 0%, #0ea5e9 100%)\", // sky-400 -> 500 \"--ui-toast-warning-background\": \"linear-gradient(180deg, #f59e0b 0%, #d97706 100%)\", // amber-500 -> 600 \"--ui-toast-highlight\": \"inset 0 1px 0 rgb(255 255 255 / 0.35)\", // glossy top edge, same as --ui-button-highlight \"--ui-toast-text-shadow\": \"0 1px 1px rgb(0 0 0 / 0.25)\", // legibility, same as --ui-button-text-shadow }",
22124
+ "default": "{ \"--ui-button-background\": \"linear-gradient(180deg, #6366f1 0%, #4f46e5 100%)\", // indigo-500 -> 600 \"--ui-button-background-hover\": \"linear-gradient(180deg, #818cf8 0%, #6366f1 100%)\", // indigo-400 -> 500 \"--ui-button-background-active\": \"linear-gradient(180deg, #4f46e5 0%, #6366f1 100%)\", // reversed 600 -> 500 \"--ui-button-border\": \"#4338ca\", // indigo-700 \"--ui-button-danger-background\": \"linear-gradient(180deg, #ef4444 0%, #dc2626 100%)\", // red-500 -> 600 \"--ui-button-danger-background-hover\": \"linear-gradient(180deg, #f87171 0%, #ef4444 100%)\", // red-400 -> 500 \"--ui-button-danger-background-active\": \"linear-gradient(180deg, #dc2626 0%, #ef4444 100%)\", // reversed 600 -> 500 \"--ui-button-danger-border\": \"#b91c1c\", // red-700 // Secondary stays neutral gray rather than a saturated hue, matching its // flat \"not the primary action\" role, but one shade darker than the // original white -> slate-50 pairing: at a small button size, that pair // read as flat white with no visible gradient at all. slate-50 -> 100 // keeps enough contrast to actually look like a gradient while still // being clearly lighter/quieter than primary/danger. Border stays // slate-300 (a step past the flat slate-200) so its edge still reads // against the fill. \"--ui-button-secondary-background\": \"linear-gradient(180deg, #f8fafc 0%, #f1f5f9 100%)\", // slate-50 -> 100 \"--ui-button-secondary-background-hover\": \"linear-gradient(180deg, #f1f5f9 0%, #e2e8f0 100%)\", // slate-100 -> 200 \"--ui-button-secondary-background-active\": \"linear-gradient(180deg, #f1f5f9 0%, #f8fafc 100%)\", // reversed 100 -> 50 \"--ui-button-secondary-border\": \"#cbd5e1\", // slate-300 \"--ui-button-secondary-border-hover\": \"#94a3b8\", // slate-400 // button-group's unchecked segments, pagination-nav's prev/next buttons, and // radio-cards/radio-pills' checked background read this rather than // --ui-button-secondary-background (see tokens above). Left flat they were // the one \"secondary\" surface that stayed matte while every actual secondary // button turned glossy, so it tracks the hover gradient rather than a // separate literal that could drift out of step with it. \"--ui-button-secondary-surface-muted\": \"var(--ui-button-secondary-background-hover)\", // Stops of --ui-button-secondary-background above, for SVG surfaces. \"--ui-button-secondary-gloss-start\": \"#f8fafc\", // slate-50 \"--ui-button-secondary-gloss-end\": \"#f1f5f9\", // slate-100 \"--ui-button-highlight\": \"inset 0 1px 0 rgb(255 255 255 / 0.35)\", // glossy top edge \"--ui-button-text-shadow\": \"0 1px 1px rgb(0 0 0 / 0.25)\", // legibility on primary/danger \"--ui-button-accent\": \"#4338ca\", // indigo-700, matches --ui-button-border // toast-notification: same light-to-dark, one-shade-step gradient // convention as the button variants above; the bottom stop always matches // the flat --ui-success/--ui-danger/--ui-info/--ui-warning value exactly. \"--ui-toast-success-background\": \"linear-gradient(180deg, #22c55e 0%, #16a34a 100%)\", // green-500 -> 600 \"--ui-toast-error-background\": \"linear-gradient(180deg, #ef4444 0%, #dc2626 100%)\", // red-500 -> 600 \"--ui-toast-info-background\": \"linear-gradient(180deg, #38bdf8 0%, #0ea5e9 100%)\", // sky-400 -> 500 \"--ui-toast-warning-background\": \"linear-gradient(180deg, #f59e0b 0%, #d97706 100%)\", // amber-500 -> 600 \"--ui-toast-highlight\": \"inset 0 1px 0 rgb(255 255 255 / 0.35)\", // glossy top edge, same as --ui-button-highlight \"--ui-toast-text-shadow\": \"0 1px 1px rgb(0 0 0 / 0.25)\", // legibility, same as --ui-button-text-shadow }",
20960
22125
  "description": "\"Gradient\" theme overrides, applied via `data-theme=\"gradient\"` on `<html>`\n(see `generate-tokens-css.mjs`) — forces `color-scheme: light` like the\n`\"light\"` override and layers a glossy gradient look on top of the flat\nlight palette, using exactly the `--ui-button-*`/`--ui-button-danger-*`/\n`--ui-button-secondary-*` hooks `ui-button.ts` already reads (see that\nfile's doc comment), plus the `--ui-toast-*` hooks `toast-notification.ts`\nreads (see its doc comment). Every other token (`--ui-text`, `--ui-surface`,\n…) is left at its light-mode default — this theme only glosses buttons and\ntoasts by design. Each variant's gradient runs light-to-dark top-to-bottom\n(`180deg`) across one Tailwind shade step lighter/darker than the flat\ntoken so it still reads as \"the same color, glossy\" rather than a\ndifferent hue; `-hover` shifts the whole pair one shade lighter, `-active`\nreverses the two stops for a pressed/\"indented\" look, and `-border` is a\nshade darker than the gradient's dark stop for a defining edge."
20961
22126
  },
20962
22127
  {
@@ -21357,74 +22522,306 @@
21357
22522
  "type": {
21358
22523
  "text": "AdmonitionVariant"
21359
22524
  },
21360
- "default": "\"info\"",
21361
- "description": "Visual style; also selects the accent color for the icon/border/tint.",
21362
- "attribute": "variant",
21363
- "reflects": true
22525
+ "default": "\"info\"",
22526
+ "description": "Visual style; also selects the accent color for the icon/border/tint.",
22527
+ "attribute": "variant",
22528
+ "reflects": true
22529
+ },
22530
+ {
22531
+ "kind": "field",
22532
+ "name": "icon",
22533
+ "type": {
22534
+ "text": "TemplateResult | null"
22535
+ },
22536
+ "default": "null",
22537
+ "description": "Optional leading icon, pre-rendered by the consumer (e.g. `iconInfo(18)`),\nmatching `status-banner`/`nav-item`/`icon-button` — icons are passed in,\nnot named, so the component never has to know the icon catalog."
22538
+ }
22539
+ ],
22540
+ "attributes": [
22541
+ {
22542
+ "name": "variant",
22543
+ "type": {
22544
+ "text": "AdmonitionVariant"
22545
+ },
22546
+ "default": "\"info\"",
22547
+ "description": "Visual style; also selects the accent color for the icon/border/tint.",
22548
+ "fieldName": "variant"
22549
+ }
22550
+ ],
22551
+ "superclass": {
22552
+ "name": "LitElement",
22553
+ "package": "lit"
22554
+ },
22555
+ "tagName": "ui-admonition",
22556
+ "customElement": true
22557
+ }
22558
+ ],
22559
+ "exports": [
22560
+ {
22561
+ "kind": "js",
22562
+ "name": "UiAdmonition",
22563
+ "declaration": {
22564
+ "name": "UiAdmonition",
22565
+ "module": "src/ui-admonition.ts"
22566
+ }
22567
+ },
22568
+ {
22569
+ "kind": "custom-element-definition",
22570
+ "name": "ui-admonition",
22571
+ "declaration": {
22572
+ "name": "UiAdmonition",
22573
+ "module": "src/ui-admonition.ts"
22574
+ }
22575
+ }
22576
+ ]
22577
+ },
22578
+ {
22579
+ "kind": "javascript-module",
22580
+ "path": "src/ui-button.ts",
22581
+ "declarations": [
22582
+ {
22583
+ "kind": "class",
22584
+ "description": "Button (or link styled as one) with an optional leading icon, in three\nvisual weights. Set `href` to render an `<a>` instead of a `<button>` —\nsame styling either way — for cross-page navigation that should look like\nan action button; a disabled/busy link stays a real `<a>` with\n`aria-disabled` + `pointer-events: none` rather than losing its href.\nPut the icon in the `icon` slot and the label in the default slot.\n\nForm-associated (`type=\"submit\"`/`\"reset\"`): the actual `<button>` lives in\nthis element's shadow root, which native HTML form association does not\ncross into from an ancestor light-DOM `<form>`. `type=\"submit\"`/`\"reset\"`\nis instead wired through `ElementInternals.form` — the same mechanism\n`address-autocomplete` uses to associate with an ancestor form.\n\n`primary`/`danger` backgrounds read `--ui-button-background`/\n`--ui-button-danger-background` (and their `-hover`/`-active`\ncounterparts), which default to the flat `--ui-primary`/`--ui-danger`\ntokens unchanged — so `--ui-primary`/`--ui-danger` stay the single source\nof truth for every other component. A consumer can override just these\nbutton-specific tokens with a `linear-gradient(...)` to opt every\n`ui-button` into a gradient look without touching component markup —\n`gradientTokenValues` in `tokens.ts` ships exactly this, wired up via\n`data-theme=\"gradient\"` (see `tokens.css`'s \"Gradient theme\" section) —\npairing it with `--ui-button-border`/`--ui-button-danger-border` (default\n`transparent`) for a defining edge a shade darker than the gradient's dark\nstop, and setting the `-active` variant's stops in reverse for a\npressed/\"indented\" look while the button is held down. `secondary`'s\nbackground/border read the equivalent `--ui-button-secondary-*` tokens\n(shared with `confirm-dialog`'s Cancel button), defaulting to today's\ntransparent/bordered look, so it can be themed into a matching (e.g.\nwhite-to-gray) gradient too.\n\n`ai` is an orthogonal modifier rather than a fourth variant: it leaves the\nvariant's fill (flat or gradient-themed) untouched and only adds an\nanimated multi-hue ring *outside* the button box — a crisp masked edge\nplus a blurred bloom behind it that fades out to transparent, so the ring\nmelts into the page instead of ending on a hard line. Both layers are\nmasked into a donut, so nothing is ever painted over the background or\nlabel. The ring's four stops are the `--ui-ai-1`…`--ui-ai-4` tokens. It\nsweeps slowly at rest, faster on hover and while `busy`, holds still while\ndisabled or under `prefers-reduced-motion`, and drops the bloom for a\nsolid `CanvasText` ring in forced-colors mode. The bloom reaches about\n`0.5rem` past the control, so give an AI button that much clearance from\nits neighbors and avoid `overflow: hidden` ancestors that would clip it.\n\nDo not combine `ai` with `pill` under the gradient theme\n(`data-theme=\"gradient\"`). That theme defines a button through a darker\n`--ui-button-border` edge plus a glossy top highlight; a pill's\nfully-rounded silhouette runs flush against the ring around its entire\noutline, so that border and gloss read as the inner edge of the rainbow\nrather than as the button's own shape, and the vertical gradient fill\nstops reading as a gradient at all. Use `ai` with the default\n`--ui-radius-sm` corners there, and keep `ai` + `pill` for the flat theme.",
22585
+ "name": "UiButton",
22586
+ "slots": [
22587
+ {
22588
+ "description": "Optional leading icon (e.g. an inline SVG).",
22589
+ "name": "icon"
22590
+ },
22591
+ {
22592
+ "description": "Button label.",
22593
+ "name": ""
22594
+ }
22595
+ ],
22596
+ "members": [
22597
+ {
22598
+ "kind": "field",
22599
+ "name": "formAssociated",
22600
+ "type": {
22601
+ "text": "boolean"
22602
+ },
22603
+ "static": true,
22604
+ "default": "true"
22605
+ },
22606
+ {
22607
+ "kind": "field",
22608
+ "name": "#internals",
22609
+ "privacy": "private"
22610
+ },
22611
+ {
22612
+ "kind": "field",
22613
+ "name": "variant",
22614
+ "type": {
22615
+ "text": "ButtonVariant"
22616
+ },
22617
+ "default": "\"primary\"",
22618
+ "description": "Visual weight.",
22619
+ "attribute": "variant"
22620
+ },
22621
+ {
22622
+ "kind": "field",
22623
+ "name": "size",
22624
+ "type": {
22625
+ "text": "\"sm\" | \"md\""
22626
+ },
22627
+ "default": "\"md\"",
22628
+ "description": "Size — `sm` reduces height/padding/font-size one step below the default.",
22629
+ "attribute": "size"
22630
+ },
22631
+ {
22632
+ "kind": "field",
22633
+ "name": "pill",
22634
+ "type": {
22635
+ "text": "boolean"
22636
+ },
22637
+ "default": "false",
22638
+ "description": "Renders fully rounded (pill-shaped) corners instead of the default `--ui-radius-sm`.",
22639
+ "attribute": "pill"
22640
+ },
22641
+ {
22642
+ "kind": "field",
22643
+ "name": "ai",
22644
+ "type": {
22645
+ "text": "boolean"
22646
+ },
22647
+ "default": "false",
22648
+ "description": "Draws the animated multi-hue \"AI\" ring (crisp edge plus a bloom fading out to transparent) around the button, on top of whatever variant/theme it already uses.",
22649
+ "attribute": "ai",
22650
+ "reflects": true
22651
+ },
22652
+ {
22653
+ "kind": "field",
22654
+ "name": "href",
22655
+ "type": {
22656
+ "text": "string | null"
22657
+ },
22658
+ "default": "null",
22659
+ "description": "Renders an `<a href=\"...\">` instead of a `<button>` when set.",
22660
+ "attribute": "href"
22661
+ },
22662
+ {
22663
+ "kind": "field",
22664
+ "name": "type",
22665
+ "type": {
22666
+ "text": "\"button\" | \"submit\" | \"reset\""
22667
+ },
22668
+ "default": "\"button\"",
22669
+ "description": "Native button `type`. Ignored when `href` is set.",
22670
+ "attribute": "type"
22671
+ },
22672
+ {
22673
+ "kind": "field",
22674
+ "name": "disabled",
22675
+ "type": {
22676
+ "text": "boolean"
22677
+ },
22678
+ "default": "false",
22679
+ "description": "Disables the control and dims it.",
22680
+ "attribute": "disabled"
22681
+ },
22682
+ {
22683
+ "kind": "field",
22684
+ "name": "busy",
22685
+ "type": {
22686
+ "text": "boolean"
22687
+ },
22688
+ "default": "false",
22689
+ "description": "Shows a spinner in place of the icon slot and disables the control.",
22690
+ "attribute": "busy"
22691
+ },
22692
+ {
22693
+ "kind": "method",
22694
+ "name": "_onClick",
22695
+ "privacy": "private",
22696
+ "description": "Drives submit/reset on the ancestor form via ElementInternals, since a shadow-DOM button can't do it natively."
22697
+ },
22698
+ {
22699
+ "kind": "method",
22700
+ "name": "_onLinkClick",
22701
+ "privacy": "private",
22702
+ "parameters": [
22703
+ {
22704
+ "name": "e",
22705
+ "type": {
22706
+ "text": "MouseEvent"
22707
+ }
22708
+ }
22709
+ ],
22710
+ "description": "Suppresses navigation while a link-styled button is disabled or busy."
22711
+ }
22712
+ ],
22713
+ "attributes": [
22714
+ {
22715
+ "name": "variant",
22716
+ "type": {
22717
+ "text": "ButtonVariant"
22718
+ },
22719
+ "default": "\"primary\"",
22720
+ "description": "Visual weight.",
22721
+ "fieldName": "variant"
22722
+ },
22723
+ {
22724
+ "name": "size",
22725
+ "type": {
22726
+ "text": "\"sm\" | \"md\""
22727
+ },
22728
+ "default": "\"md\"",
22729
+ "description": "Size — `sm` reduces height/padding/font-size one step below the default.",
22730
+ "fieldName": "size"
22731
+ },
22732
+ {
22733
+ "name": "pill",
22734
+ "type": {
22735
+ "text": "boolean"
22736
+ },
22737
+ "default": "false",
22738
+ "description": "Renders fully rounded (pill-shaped) corners instead of the default `--ui-radius-sm`.",
22739
+ "fieldName": "pill"
22740
+ },
22741
+ {
22742
+ "name": "ai",
22743
+ "type": {
22744
+ "text": "boolean"
22745
+ },
22746
+ "default": "false",
22747
+ "description": "Draws the animated multi-hue \"AI\" ring (crisp edge plus a bloom fading out to transparent) around the button, on top of whatever variant/theme it already uses.",
22748
+ "fieldName": "ai"
22749
+ },
22750
+ {
22751
+ "name": "href",
22752
+ "type": {
22753
+ "text": "string | null"
22754
+ },
22755
+ "default": "null",
22756
+ "description": "Renders an `<a href=\"...\">` instead of a `<button>` when set.",
22757
+ "fieldName": "href"
22758
+ },
22759
+ {
22760
+ "name": "type",
22761
+ "type": {
22762
+ "text": "\"button\" | \"submit\" | \"reset\""
22763
+ },
22764
+ "default": "\"button\"",
22765
+ "description": "Native button `type`. Ignored when `href` is set.",
22766
+ "fieldName": "type"
21364
22767
  },
21365
22768
  {
21366
- "kind": "field",
21367
- "name": "icon",
22769
+ "name": "disabled",
21368
22770
  "type": {
21369
- "text": "TemplateResult | null"
22771
+ "text": "boolean"
21370
22772
  },
21371
- "default": "null",
21372
- "description": "Optional leading icon, pre-rendered by the consumer (e.g. `iconInfo(18)`),\nmatching `status-banner`/`nav-item`/`icon-button` — icons are passed in,\nnot named, so the component never has to know the icon catalog."
21373
- }
21374
- ],
21375
- "attributes": [
22773
+ "default": "false",
22774
+ "description": "Disables the control and dims it.",
22775
+ "fieldName": "disabled"
22776
+ },
21376
22777
  {
21377
- "name": "variant",
22778
+ "name": "busy",
21378
22779
  "type": {
21379
- "text": "AdmonitionVariant"
22780
+ "text": "boolean"
21380
22781
  },
21381
- "default": "\"info\"",
21382
- "description": "Visual style; also selects the accent color for the icon/border/tint.",
21383
- "fieldName": "variant"
22782
+ "default": "false",
22783
+ "description": "Shows a spinner in place of the icon slot and disables the control.",
22784
+ "fieldName": "busy"
21384
22785
  }
21385
22786
  ],
21386
22787
  "superclass": {
21387
22788
  "name": "LitElement",
21388
22789
  "package": "lit"
21389
22790
  },
21390
- "tagName": "ui-admonition",
22791
+ "tagName": "ui-button",
21391
22792
  "customElement": true
21392
22793
  }
21393
22794
  ],
21394
22795
  "exports": [
21395
22796
  {
21396
22797
  "kind": "js",
21397
- "name": "UiAdmonition",
22798
+ "name": "UiButton",
21398
22799
  "declaration": {
21399
- "name": "UiAdmonition",
21400
- "module": "src/ui-admonition.ts"
22800
+ "name": "UiButton",
22801
+ "module": "src/ui-button.ts"
21401
22802
  }
21402
22803
  },
21403
22804
  {
21404
22805
  "kind": "custom-element-definition",
21405
- "name": "ui-admonition",
22806
+ "name": "ui-button",
21406
22807
  "declaration": {
21407
- "name": "UiAdmonition",
21408
- "module": "src/ui-admonition.ts"
22808
+ "name": "UiButton",
22809
+ "module": "src/ui-button.ts"
21409
22810
  }
21410
22811
  }
21411
22812
  ]
21412
22813
  },
21413
22814
  {
21414
22815
  "kind": "javascript-module",
21415
- "path": "src/ui-button.ts",
22816
+ "path": "src/ui-checkbox.ts",
21416
22817
  "declarations": [
21417
22818
  {
21418
22819
  "kind": "class",
21419
- "description": "Button (or link styled as one) with an optional leading icon, in three\nvisual weights. Set `href` to render an `<a>` instead of a `<button>` —\nsame styling either way — for cross-page navigation that should look like\nan action button; a disabled/busy link stays a real `<a>` with\n`aria-disabled` + `pointer-events: none` rather than losing its href.\nPut the icon in the `icon` slot and the label in the default slot.\n\nForm-associated (`type=\"submit\"`/`\"reset\"`): the actual `<button>` lives in\nthis element's shadow root, which native HTML form association does not\ncross into from an ancestor light-DOM `<form>`. `type=\"submit\"`/`\"reset\"`\nis instead wired through `ElementInternals.form` — the same mechanism\n`address-autocomplete` uses to associate with an ancestor form.\n\n`primary`/`danger` backgrounds read `--ui-button-background`/\n`--ui-button-danger-background` (and their `-hover`/`-active`\ncounterparts), which default to the flat `--ui-primary`/`--ui-danger`\ntokens unchanged — so `--ui-primary`/`--ui-danger` stay the single source\nof truth for every other component. A consumer can override just these\nbutton-specific tokens with a `linear-gradient(...)` to opt every\n`ui-button` into a gradient look without touching component markup —\n`gradientTokenValues` in `tokens.ts` ships exactly this, wired up via\n`data-theme=\"gradient\"` (see `tokens.css`'s \"Gradient theme\" section) —\npairing it with `--ui-button-border`/`--ui-button-danger-border` (default\n`transparent`) for a defining edge a shade darker than the gradient's dark\nstop, and setting the `-active` variant's stops in reverse for a\npressed/\"indented\" look while the button is held down. `secondary`'s\nbackground/border read the equivalent `--ui-button-secondary-*` tokens\n(shared with `confirm-dialog`'s Cancel button), defaulting to today's\ntransparent/bordered look, so it can be themed into a matching (e.g.\nwhite-to-gray) gradient too.\n\n`ai` is an orthogonal modifier rather than a fourth variant: it leaves the\nvariant's fill (flat or gradient-themed) untouched and only adds an\nanimated multi-hue ring *outside* the button box — a crisp masked edge\nplus a blurred bloom behind it that fades out to transparent, so the ring\nmelts into the page instead of ending on a hard line. Both layers are\nmasked into a donut, so nothing is ever painted over the background or\nlabel. The ring's four stops are the `--ui-ai-1`…`--ui-ai-4` tokens. It\nsweeps slowly at rest, faster on hover and while `busy`, holds still while\ndisabled or under `prefers-reduced-motion`, and drops the bloom for a\nsolid `CanvasText` ring in forced-colors mode. The bloom reaches about\n`0.5rem` past the control, so give an AI button that much clearance from\nits neighbors and avoid `overflow: hidden` ancestors that would clip it.\n\nDo not combine `ai` with `pill` under the gradient theme\n(`data-theme=\"gradient\"`). That theme defines a button through a darker\n`--ui-button-border` edge plus a glossy top highlight; a pill's\nfully-rounded silhouette runs flush against the ring around its entire\noutline, so that border and gloss read as the inner edge of the rainbow\nrather than as the button's own shape, and the vertical gradient fill\nstops reading as a gradient at all. Use `ai` with the default\n`--ui-radius-sm` corners there, and keep `ai` + `pill` for the flat theme.",
21420
- "name": "UiButton",
22820
+ "description": "A form-associated boolean checkbox, usable standalone or inside a native\n`<form>`. Submits `name=on` when checked (matching native\n`<input type=\"checkbox\">` semantics) and participates fully in form\n`reset()`, ancestor `<fieldset disabled>`, and `required` validity.\n\nRenders a native `<input type=\"checkbox\">` wrapped in a `<label>`, styled\nvia `:has()` on the wrapping label (matching `radio-pills`/`radio-cards`)\nrather than styling the native input directly; the checkbox itself renders\nat `1rem`, matching the existing radio-input convention. An optional\npre-rendered `icon` (matching `form-select`'s per-option icon convention)\nrenders between the box and the label, inside the same clickable `<label>`\n— for a row that pairs a checkbox with an icon/swatch and needs the whole\nrow, icon included, to stay one click target.\n\nThe label is the default slot, with the `label` property as its fallback.\nSlot it instead of setting the property when it needs its own markup or\nstyling — a link, an emphasized word — since a property renders inside this\ncomponent's shadow DOM and cannot be reached from outside. Either way the\nlabel sits inside the native `<label>`, so it stays clickable and still\nnames the checkbox for assistive technology.",
22821
+ "name": "UiCheckbox",
21421
22822
  "slots": [
21422
22823
  {
21423
- "description": "Optional leading icon (e.g. an inline SVG).",
21424
- "name": "icon"
21425
- },
21426
- {
21427
- "description": "Button label.",
22824
+ "description": "The label, overriding the `label` property; for a label that needs its own markup or styling.",
21428
22825
  "name": ""
21429
22826
  }
21430
22827
  ],
@@ -21440,370 +22837,575 @@
21440
22837
  },
21441
22838
  {
21442
22839
  "kind": "field",
21443
- "name": "#internals",
21444
- "privacy": "private"
22840
+ "name": "checked",
22841
+ "type": {
22842
+ "text": "boolean"
22843
+ },
22844
+ "default": "false",
22845
+ "description": "Whether the box is checked.",
22846
+ "attribute": "checked"
21445
22847
  },
21446
22848
  {
21447
22849
  "kind": "field",
21448
- "name": "variant",
22850
+ "name": "indeterminate",
21449
22851
  "type": {
21450
- "text": "ButtonVariant"
22852
+ "text": "boolean"
21451
22853
  },
21452
- "default": "\"primary\"",
21453
- "description": "Visual weight.",
21454
- "attribute": "variant"
22854
+ "default": "false",
22855
+ "description": "Visual \"partial selection\" state; cleared on the next user interaction.",
22856
+ "attribute": "indeterminate"
21455
22857
  },
21456
22858
  {
21457
22859
  "kind": "field",
21458
- "name": "size",
22860
+ "name": "disabled",
21459
22861
  "type": {
21460
- "text": "\"sm\" | \"md\""
22862
+ "text": "boolean"
21461
22863
  },
21462
- "default": "\"md\"",
21463
- "description": "Size — `sm` reduces height/padding/font-size one step below the default.",
21464
- "attribute": "size"
22864
+ "default": "false",
22865
+ "description": "Disables interaction; merged with an ancestor `<fieldset disabled>`.",
22866
+ "attribute": "disabled"
21465
22867
  },
21466
22868
  {
21467
22869
  "kind": "field",
21468
- "name": "pill",
22870
+ "name": "required",
21469
22871
  "type": {
21470
22872
  "text": "boolean"
21471
22873
  },
21472
22874
  "default": "false",
21473
- "description": "Renders fully rounded (pill-shaped) corners instead of the default `--ui-radius-sm`.",
21474
- "attribute": "pill"
22875
+ "description": "Marks the control invalid via `ElementInternals` while unchecked.",
22876
+ "attribute": "required"
21475
22877
  },
21476
22878
  {
21477
22879
  "kind": "field",
21478
- "name": "ai",
22880
+ "name": "name",
21479
22881
  "type": {
21480
- "text": "boolean"
22882
+ "text": "string"
21481
22883
  },
21482
- "default": "false",
21483
- "description": "Draws the animated multi-hue \"AI\" ring (crisp edge plus a bloom fading out to transparent) around the button, on top of whatever variant/theme it already uses.",
21484
- "attribute": "ai",
21485
- "reflects": true
22884
+ "default": "\"\"",
22885
+ "description": "Form field name; submitted as `name=on` only while checked.",
22886
+ "attribute": "name"
21486
22887
  },
21487
22888
  {
21488
22889
  "kind": "field",
21489
- "name": "href",
22890
+ "name": "label",
21490
22891
  "type": {
21491
- "text": "string | null"
22892
+ "text": "string"
22893
+ },
22894
+ "default": "\"\"",
22895
+ "description": "Visible label text rendered next to the box; overridden by the default slot.",
22896
+ "attribute": "label"
22897
+ },
22898
+ {
22899
+ "kind": "field",
22900
+ "name": "icon",
22901
+ "type": {
22902
+ "text": "TemplateResult | null"
21492
22903
  },
21493
22904
  "default": "null",
21494
- "description": "Renders an `<a href=\"...\">` instead of a `<button>` when set.",
21495
- "attribute": "href"
22905
+ "description": "Pre-rendered icon template displayed between the box and the label, e.g. `iconPencil(14)` from this package's icon set."
21496
22906
  },
21497
22907
  {
21498
22908
  "kind": "field",
21499
- "name": "type",
22909
+ "name": "iconSize",
21500
22910
  "type": {
21501
- "text": "\"button\" | \"submit\" | \"reset\""
22911
+ "text": "number"
21502
22912
  },
21503
- "default": "\"button\"",
21504
- "description": "Native button `type`. Ignored when `href` is set.",
21505
- "attribute": "type"
22913
+ "default": "14",
22914
+ "description": "Square icon size in pixels — 14 (inline icon size) by default.",
22915
+ "attribute": "iconSize"
21506
22916
  },
21507
22917
  {
21508
22918
  "kind": "field",
21509
- "name": "disabled",
22919
+ "name": "_formDisabled",
21510
22920
  "type": {
21511
22921
  "text": "boolean"
21512
22922
  },
21513
- "default": "false",
21514
- "description": "Disables the control and dims it.",
21515
- "attribute": "disabled"
22923
+ "privacy": "private",
22924
+ "default": "false"
21516
22925
  },
21517
22926
  {
21518
22927
  "kind": "field",
21519
- "name": "busy",
22928
+ "name": "#internals",
22929
+ "privacy": "private"
22930
+ },
22931
+ {
22932
+ "kind": "field",
22933
+ "name": "#defaultChecked",
22934
+ "privacy": "private",
21520
22935
  "type": {
21521
22936
  "text": "boolean"
21522
22937
  },
21523
- "default": "false",
21524
- "description": "Shows a spinner in place of the icon slot and disables the control.",
21525
- "attribute": "busy"
22938
+ "default": "false"
22939
+ },
22940
+ {
22941
+ "kind": "field",
22942
+ "name": "#inputEl",
22943
+ "privacy": "private",
22944
+ "type": {
22945
+ "text": "HTMLInputElement | null"
22946
+ },
22947
+ "default": "null"
22948
+ },
22949
+ {
22950
+ "kind": "field",
22951
+ "name": "#isDisabled",
22952
+ "privacy": "private",
22953
+ "type": {
22954
+ "text": "boolean"
22955
+ },
22956
+ "description": "Whether the host or an ancestor fieldset currently disables the control.",
22957
+ "readonly": true
21526
22958
  },
21527
22959
  {
21528
22960
  "kind": "method",
21529
- "name": "_onClick",
22961
+ "name": "formResetCallback",
22962
+ "return": {
22963
+ "type": {
22964
+ "text": "void"
22965
+ }
22966
+ },
22967
+ "description": "Restores the checked state captured at first render, per the form contract."
22968
+ },
22969
+ {
22970
+ "kind": "method",
22971
+ "name": "formDisabledCallback",
22972
+ "return": {
22973
+ "type": {
22974
+ "text": "void"
22975
+ }
22976
+ },
22977
+ "parameters": [
22978
+ {
22979
+ "name": "disabled",
22980
+ "type": {
22981
+ "text": "boolean"
22982
+ }
22983
+ }
22984
+ ],
22985
+ "description": "Mirrors an ancestor fieldset's disabled state."
22986
+ },
22987
+ {
22988
+ "kind": "method",
22989
+ "name": "formStateRestoreCallback",
22990
+ "return": {
22991
+ "type": {
22992
+ "text": "void"
22993
+ }
22994
+ },
22995
+ "parameters": [
22996
+ {
22997
+ "name": "state",
22998
+ "type": {
22999
+ "text": "string | File | FormData | null"
23000
+ }
23001
+ }
23002
+ ],
23003
+ "description": "Restores the checked state from saved form state (bfcache/autofill)."
23004
+ },
23005
+ {
23006
+ "kind": "method",
23007
+ "name": "#syncFormValue",
21530
23008
  "privacy": "private",
21531
- "description": "Drives submit/reset on the ancestor form via ElementInternals, since a shadow-DOM button can't do it natively."
23009
+ "return": {
23010
+ "type": {
23011
+ "text": "void"
23012
+ }
23013
+ }
21532
23014
  },
21533
23015
  {
21534
23016
  "kind": "method",
21535
- "name": "_onLinkClick",
23017
+ "name": "#syncValidity",
23018
+ "privacy": "private",
23019
+ "return": {
23020
+ "type": {
23021
+ "text": "void"
23022
+ }
23023
+ }
23024
+ },
23025
+ {
23026
+ "kind": "method",
23027
+ "name": "#onChange",
21536
23028
  "privacy": "private",
23029
+ "return": {
23030
+ "type": {
23031
+ "text": "void"
23032
+ }
23033
+ },
21537
23034
  "parameters": [
21538
23035
  {
21539
23036
  "name": "e",
21540
23037
  "type": {
21541
- "text": "MouseEvent"
23038
+ "text": "Event"
21542
23039
  }
21543
23040
  }
21544
- ],
21545
- "description": "Suppresses navigation while a link-styled button is disabled or busy."
23041
+ ]
23042
+ },
23043
+ {
23044
+ "kind": "field",
23045
+ "name": "#onInputRef",
23046
+ "privacy": "private"
21546
23047
  }
21547
23048
  ],
21548
- "attributes": [
23049
+ "events": [
21549
23050
  {
21550
- "name": "variant",
23051
+ "name": "change",
21551
23052
  "type": {
21552
- "text": "ButtonVariant"
23053
+ "text": "CustomEvent"
21553
23054
  },
21554
- "default": "\"primary\"",
21555
- "description": "Visual weight.",
21556
- "fieldName": "variant"
21557
- },
23055
+ "description": "The checkbox was toggled by the user, in either direction; detail: `{ checked }`. Programmatic `checked` assignments do not fire it."
23056
+ }
23057
+ ],
23058
+ "attributes": [
21558
23059
  {
21559
- "name": "size",
23060
+ "name": "checked",
21560
23061
  "type": {
21561
- "text": "\"sm\" | \"md\""
23062
+ "text": "boolean"
21562
23063
  },
21563
- "default": "\"md\"",
21564
- "description": "Size — `sm` reduces height/padding/font-size one step below the default.",
21565
- "fieldName": "size"
23064
+ "default": "false",
23065
+ "description": "Whether the box is checked.",
23066
+ "fieldName": "checked"
21566
23067
  },
21567
23068
  {
21568
- "name": "pill",
23069
+ "name": "indeterminate",
21569
23070
  "type": {
21570
23071
  "text": "boolean"
21571
23072
  },
21572
23073
  "default": "false",
21573
- "description": "Renders fully rounded (pill-shaped) corners instead of the default `--ui-radius-sm`.",
21574
- "fieldName": "pill"
23074
+ "description": "Visual \"partial selection\" state; cleared on the next user interaction.",
23075
+ "fieldName": "indeterminate"
21575
23076
  },
21576
23077
  {
21577
- "name": "ai",
23078
+ "name": "disabled",
21578
23079
  "type": {
21579
23080
  "text": "boolean"
21580
23081
  },
21581
23082
  "default": "false",
21582
- "description": "Draws the animated multi-hue \"AI\" ring (crisp edge plus a bloom fading out to transparent) around the button, on top of whatever variant/theme it already uses.",
21583
- "fieldName": "ai"
23083
+ "description": "Disables interaction; merged with an ancestor `<fieldset disabled>`.",
23084
+ "fieldName": "disabled"
21584
23085
  },
21585
23086
  {
21586
- "name": "href",
23087
+ "name": "required",
21587
23088
  "type": {
21588
- "text": "string | null"
23089
+ "text": "boolean"
21589
23090
  },
21590
- "default": "null",
21591
- "description": "Renders an `<a href=\"...\">` instead of a `<button>` when set.",
21592
- "fieldName": "href"
23091
+ "default": "false",
23092
+ "description": "Marks the control invalid via `ElementInternals` while unchecked.",
23093
+ "fieldName": "required"
21593
23094
  },
21594
23095
  {
21595
- "name": "type",
23096
+ "name": "name",
21596
23097
  "type": {
21597
- "text": "\"button\" | \"submit\" | \"reset\""
23098
+ "text": "string"
21598
23099
  },
21599
- "default": "\"button\"",
21600
- "description": "Native button `type`. Ignored when `href` is set.",
21601
- "fieldName": "type"
23100
+ "default": "\"\"",
23101
+ "description": "Form field name; submitted as `name=on` only while checked.",
23102
+ "fieldName": "name"
21602
23103
  },
21603
23104
  {
21604
- "name": "disabled",
23105
+ "name": "label",
21605
23106
  "type": {
21606
- "text": "boolean"
23107
+ "text": "string"
21607
23108
  },
21608
- "default": "false",
21609
- "description": "Disables the control and dims it.",
21610
- "fieldName": "disabled"
23109
+ "default": "\"\"",
23110
+ "description": "Visible label text rendered next to the box; overridden by the default slot.",
23111
+ "fieldName": "label"
21611
23112
  },
21612
23113
  {
21613
- "name": "busy",
23114
+ "name": "iconSize",
21614
23115
  "type": {
21615
- "text": "boolean"
23116
+ "text": "number"
21616
23117
  },
21617
- "default": "false",
21618
- "description": "Shows a spinner in place of the icon slot and disables the control.",
21619
- "fieldName": "busy"
23118
+ "default": "14",
23119
+ "description": "Square icon size in pixels — 14 (inline icon size) by default.",
23120
+ "fieldName": "iconSize"
21620
23121
  }
21621
23122
  ],
21622
23123
  "superclass": {
21623
23124
  "name": "LitElement",
21624
23125
  "package": "lit"
21625
23126
  },
21626
- "tagName": "ui-button",
23127
+ "tagName": "ui-checkbox",
21627
23128
  "customElement": true
21628
23129
  }
21629
23130
  ],
21630
23131
  "exports": [
21631
23132
  {
21632
23133
  "kind": "js",
21633
- "name": "UiButton",
23134
+ "name": "UiCheckbox",
21634
23135
  "declaration": {
21635
- "name": "UiButton",
21636
- "module": "src/ui-button.ts"
23136
+ "name": "UiCheckbox",
23137
+ "module": "src/ui-checkbox.ts"
21637
23138
  }
21638
23139
  },
21639
23140
  {
21640
23141
  "kind": "custom-element-definition",
21641
- "name": "ui-button",
23142
+ "name": "ui-checkbox",
21642
23143
  "declaration": {
21643
- "name": "UiButton",
21644
- "module": "src/ui-button.ts"
23144
+ "name": "UiCheckbox",
23145
+ "module": "src/ui-checkbox.ts"
21645
23146
  }
21646
23147
  }
21647
23148
  ]
21648
23149
  },
21649
23150
  {
21650
23151
  "kind": "javascript-module",
21651
- "path": "src/ui-checkbox.ts",
23152
+ "path": "src/ui-tooltip.ts",
21652
23153
  "declarations": [
21653
23154
  {
21654
23155
  "kind": "class",
21655
- "description": "A form-associated boolean checkbox, usable standalone or inside a native\n`<form>`. Submits `name=on` when checked (matching native\n`<input type=\"checkbox\">` semantics) and participates fully in form\n`reset()`, ancestor `<fieldset disabled>`, and `required` validity.\n\nRenders a native `<input type=\"checkbox\">` wrapped in a `<label>`, styled\nvia `:has()` on the wrapping label (matching `radio-pills`/`radio-cards`)\nrather than styling the native input directly; the checkbox itself renders\nat `1rem`, matching the existing radio-input convention. An optional\npre-rendered `icon` (matching `form-select`'s per-option icon convention)\nrenders between the box and the label, inside the same clickable `<label>`\n— for a row that pairs a checkbox with an icon/swatch and needs the whole\nrow, icon included, to stay one click target.\n\nThe label is the default slot, with the `label` property as its fallback.\nSlot it instead of setting the property when it needs its own markup or\nstyling — a link, an emphasized word — since a property renders inside this\ncomponent's shadow DOM and cannot be reached from outside. Either way the\nlabel sits inside the native `<label>`, so it stays clickable and still\nnames the checkbox for assistive technology.",
21656
- "name": "UiCheckbox",
23156
+ "description": "Hover and focus tooltip for its default-slot trigger. The `content` slot\nholds the tooltip body — plain text or rich markup such as a list. It\nappears after `show-delay` on hover and at once on keyboard focus, stays\nopen while the pointer is over the tooltip itself, and closes on Escape,\nblur, or when the pointer leaves. It renders in the top layer, so\nscrolling or `overflow: hidden` ancestors never clip it.\n\nThe trigger is described by the content (`aria-describedby`). A trigger\nwith nothing focusable inside (e.g. plain text) makes the tooltip host\nfocusable so keyboard users can reach the description too. ARIA references\ncan't cross shadow roots, so when the trigger is a custom element whose\nfocusable control lives in its own shadow root, screen readers won't\nannounce the description on focus; prefer a native trigger such as\n`<button>` when that matters.",
23157
+ "name": "UiTooltip",
23158
+ "cssParts": [
23159
+ {
23160
+ "description": "The floating tooltip surface.",
23161
+ "name": "tooltip"
23162
+ }
23163
+ ],
21657
23164
  "slots": [
21658
23165
  {
21659
- "description": "The label, overriding the `label` property; for a label that needs its own markup or styling.",
23166
+ "description": "The trigger the tooltip describes.",
21660
23167
  "name": ""
23168
+ },
23169
+ {
23170
+ "description": "The tooltip body.",
23171
+ "name": "content"
21661
23172
  }
21662
23173
  ],
21663
23174
  "members": [
21664
23175
  {
21665
23176
  "kind": "field",
21666
- "name": "formAssociated",
23177
+ "name": "placement",
21667
23178
  "type": {
21668
- "text": "boolean"
23179
+ "text": "UiTooltipPlacement"
21669
23180
  },
21670
- "static": true,
21671
- "default": "true"
23181
+ "default": "\"top\"",
23182
+ "description": "Preferred side of the trigger; flips to the other side when this one lacks room.",
23183
+ "attribute": "placement",
23184
+ "reflects": true
21672
23185
  },
21673
23186
  {
21674
23187
  "kind": "field",
21675
- "name": "checked",
23188
+ "name": "showDelay",
21676
23189
  "type": {
21677
- "text": "boolean"
23190
+ "text": "number"
21678
23191
  },
21679
- "default": "false",
21680
- "description": "Whether the box is checked.",
21681
- "attribute": "checked"
23192
+ "default": "300",
23193
+ "description": "Hover delay in milliseconds before the tooltip appears; keyboard focus shows it at once.",
23194
+ "attribute": "show-delay"
21682
23195
  },
21683
23196
  {
21684
23197
  "kind": "field",
21685
- "name": "indeterminate",
23198
+ "name": "disabled",
21686
23199
  "type": {
21687
23200
  "text": "boolean"
21688
23201
  },
21689
23202
  "default": "false",
21690
- "description": "Visual \"partial selection\" state; cleared on the next user interaction.",
21691
- "attribute": "indeterminate"
23203
+ "description": "Suppresses the tooltip and closes it if open.",
23204
+ "attribute": "disabled",
23205
+ "reflects": true
21692
23206
  },
21693
23207
  {
21694
23208
  "kind": "field",
21695
- "name": "disabled",
23209
+ "name": "_open",
21696
23210
  "type": {
21697
23211
  "text": "boolean"
21698
23212
  },
21699
- "default": "false",
21700
- "description": "Disables interaction; merged with an ancestor `<fieldset disabled>`.",
21701
- "attribute": "disabled"
23213
+ "privacy": "private",
23214
+ "default": "false"
21702
23215
  },
21703
23216
  {
21704
23217
  "kind": "field",
21705
- "name": "required",
23218
+ "name": "_tooltip",
21706
23219
  "type": {
21707
- "text": "boolean"
23220
+ "text": "HTMLElement"
21708
23221
  },
21709
- "default": "false",
21710
- "description": "Marks the control invalid via `ElementInternals` while unchecked.",
21711
- "attribute": "required"
23222
+ "privacy": "private"
21712
23223
  },
21713
23224
  {
21714
23225
  "kind": "field",
21715
- "name": "name",
23226
+ "name": "#showTimer",
23227
+ "privacy": "private",
21716
23228
  "type": {
21717
- "text": "string"
23229
+ "text": "ReturnType<typeof setTimeout> | null"
21718
23230
  },
21719
- "default": "\"\"",
21720
- "description": "Form field name; submitted as `name=on` only while checked.",
21721
- "attribute": "name"
23231
+ "default": "null"
21722
23232
  },
21723
23233
  {
21724
23234
  "kind": "field",
21725
- "name": "label",
23235
+ "name": "#hideTimer",
23236
+ "privacy": "private",
21726
23237
  "type": {
21727
- "text": "string"
23238
+ "text": "ReturnType<typeof setTimeout> | null"
21728
23239
  },
21729
- "default": "\"\"",
21730
- "description": "Visible label text rendered next to the box; overridden by the default slot.",
21731
- "attribute": "label"
23240
+ "default": "null"
21732
23241
  },
21733
23242
  {
21734
23243
  "kind": "field",
21735
- "name": "icon",
23244
+ "name": "#describedTarget",
23245
+ "privacy": "private",
21736
23246
  "type": {
21737
- "text": "TemplateResult | null"
23247
+ "text": "HTMLElement | null"
21738
23248
  },
21739
- "default": "null",
21740
- "description": "Pre-rendered icon template displayed between the box and the label, e.g. `iconPencil(14)` from this package's icon set."
23249
+ "default": "null"
21741
23250
  },
21742
23251
  {
21743
23252
  "kind": "field",
21744
- "name": "iconSize",
23253
+ "name": "#describedId",
23254
+ "privacy": "private",
21745
23255
  "type": {
21746
- "text": "number"
23256
+ "text": "string | null"
21747
23257
  },
21748
- "default": "14",
21749
- "description": "Square icon size in pixels — 14 (inline icon size) by default.",
21750
- "attribute": "iconSize"
23258
+ "default": "null"
21751
23259
  },
21752
23260
  {
21753
23261
  "kind": "field",
21754
- "name": "_formDisabled",
23262
+ "name": "#content",
23263
+ "privacy": "private",
21755
23264
  "type": {
21756
- "text": "boolean"
23265
+ "text": "HTMLElement | null"
21757
23266
  },
23267
+ "default": "null"
23268
+ },
23269
+ {
23270
+ "kind": "field",
23271
+ "name": "#madeFocusable",
21758
23272
  "privacy": "private",
23273
+ "type": {
23274
+ "text": "boolean"
23275
+ },
21759
23276
  "default": "false"
21760
23277
  },
21761
23278
  {
21762
23279
  "kind": "field",
21763
- "name": "#internals",
21764
- "privacy": "private"
23280
+ "name": "#contentId",
23281
+ "privacy": "private",
23282
+ "readonly": true,
23283
+ "default": "`ui-tooltip-content-${++instanceCount}`"
21765
23284
  },
21766
23285
  {
21767
23286
  "kind": "field",
21768
- "name": "#defaultChecked",
21769
- "privacy": "private",
23287
+ "name": "open",
21770
23288
  "type": {
21771
23289
  "text": "boolean"
21772
23290
  },
21773
- "default": "false"
23291
+ "description": "Whether the tooltip is currently showing.",
23292
+ "readonly": true
21774
23293
  },
21775
23294
  {
21776
- "kind": "field",
21777
- "name": "#inputEl",
23295
+ "kind": "method",
23296
+ "name": "#scheduleShow",
21778
23297
  "privacy": "private",
21779
- "type": {
21780
- "text": "HTMLInputElement | null"
23298
+ "return": {
23299
+ "type": {
23300
+ "text": "void"
23301
+ }
21781
23302
  },
21782
- "default": "null"
23303
+ "parameters": [
23304
+ {
23305
+ "name": "delay",
23306
+ "type": {
23307
+ "text": "number"
23308
+ }
23309
+ }
23310
+ ]
23311
+ },
23312
+ {
23313
+ "kind": "method",
23314
+ "name": "#scheduleHide",
23315
+ "privacy": "private",
23316
+ "return": {
23317
+ "type": {
23318
+ "text": "void"
23319
+ }
23320
+ },
23321
+ "parameters": [
23322
+ {
23323
+ "name": "delay",
23324
+ "type": {
23325
+ "text": "number"
23326
+ }
23327
+ },
23328
+ {
23329
+ "name": "keepOpenWhile",
23330
+ "type": {
23331
+ "text": "string"
23332
+ }
23333
+ }
23334
+ ],
23335
+ "description": "Hides after `delay` unless the host still matches `keepOpenWhile` (still hovered or focused)."
23336
+ },
23337
+ {
23338
+ "kind": "method",
23339
+ "name": "#clearTimers",
23340
+ "privacy": "private",
23341
+ "return": {
23342
+ "type": {
23343
+ "text": "void"
23344
+ }
23345
+ }
23346
+ },
23347
+ {
23348
+ "kind": "method",
23349
+ "name": "#setOpen",
23350
+ "privacy": "private",
23351
+ "return": {
23352
+ "type": {
23353
+ "text": "void"
23354
+ }
23355
+ },
23356
+ "parameters": [
23357
+ {
23358
+ "name": "open",
23359
+ "type": {
23360
+ "text": "boolean"
23361
+ }
23362
+ }
23363
+ ]
21783
23364
  },
21784
23365
  {
21785
23366
  "kind": "field",
21786
- "name": "#isDisabled",
23367
+ "name": "#onDocumentKeydown",
21787
23368
  "privacy": "private",
21788
- "type": {
21789
- "text": "boolean"
23369
+ "description": "Escape closes the tooltip without dismissing anything else (WCAG 1.4.13)."
23370
+ },
23371
+ {
23372
+ "kind": "field",
23373
+ "name": "#onViewportChange",
23374
+ "privacy": "private"
23375
+ },
23376
+ {
23377
+ "kind": "method",
23378
+ "name": "#position",
23379
+ "privacy": "private",
23380
+ "return": {
23381
+ "type": {
23382
+ "text": "void"
23383
+ }
21790
23384
  },
21791
- "description": "Whether the host or an ancestor fieldset currently disables the control.",
21792
- "readonly": true
23385
+ "description": "Places the tooltip beside the host, flipping sides and clamping it inside the viewport."
21793
23386
  },
21794
23387
  {
21795
23388
  "kind": "method",
21796
- "name": "formResetCallback",
23389
+ "name": "#onTriggerSlotChange",
23390
+ "privacy": "private",
21797
23391
  "return": {
21798
23392
  "type": {
21799
- "text": "void"
23393
+ "text": "Promise<void>"
21800
23394
  }
21801
23395
  },
21802
- "description": "Restores the checked state captured at first render, per the form contract."
23396
+ "parameters": [
23397
+ {
23398
+ "name": "event",
23399
+ "type": {
23400
+ "text": "Event"
23401
+ }
23402
+ }
23403
+ ]
21803
23404
  },
21804
23405
  {
21805
23406
  "kind": "method",
21806
- "name": "formDisabledCallback",
23407
+ "name": "#onContentSlotChange",
23408
+ "privacy": "private",
21807
23409
  "return": {
21808
23410
  "type": {
21809
23411
  "text": "void"
@@ -21811,17 +23413,17 @@
21811
23413
  },
21812
23414
  "parameters": [
21813
23415
  {
21814
- "name": "disabled",
23416
+ "name": "event",
21815
23417
  "type": {
21816
- "text": "boolean"
23418
+ "text": "Event"
21817
23419
  }
21818
23420
  }
21819
- ],
21820
- "description": "Mirrors an ancestor fieldset's disabled state."
23421
+ ]
21821
23422
  },
21822
23423
  {
21823
23424
  "kind": "method",
21824
- "name": "formStateRestoreCallback",
23425
+ "name": "#describe",
23426
+ "privacy": "private",
21825
23427
  "return": {
21826
23428
  "type": {
21827
23429
  "text": "void"
@@ -21829,37 +23431,60 @@
21829
23431
  },
21830
23432
  "parameters": [
21831
23433
  {
21832
- "name": "state",
23434
+ "name": "target",
21833
23435
  "type": {
21834
- "text": "string | File | FormData | null"
23436
+ "text": "HTMLElement | null"
21835
23437
  }
21836
23438
  }
21837
23439
  ],
21838
- "description": "Restores the checked state from saved form state (bfcache/autofill)."
23440
+ "description": "Points the trigger's `aria-describedby` at the content, replacing this tooltip's previous reference."
21839
23441
  },
21840
23442
  {
21841
23443
  "kind": "method",
21842
- "name": "#syncFormValue",
23444
+ "name": "#describedIds",
21843
23445
  "privacy": "private",
21844
23446
  "return": {
21845
23447
  "type": {
21846
- "text": "void"
23448
+ "text": "string[]"
21847
23449
  }
21848
- }
23450
+ },
23451
+ "parameters": [
23452
+ {
23453
+ "name": "target",
23454
+ "type": {
23455
+ "text": "HTMLElement"
23456
+ }
23457
+ }
23458
+ ],
23459
+ "description": "The target's `aria-describedby` ids, minus the one this tooltip added."
21849
23460
  },
21850
23461
  {
21851
23462
  "kind": "method",
21852
- "name": "#syncValidity",
23463
+ "name": "#setDescribedBy",
21853
23464
  "privacy": "private",
21854
23465
  "return": {
21855
23466
  "type": {
21856
23467
  "text": "void"
21857
23468
  }
21858
- }
23469
+ },
23470
+ "parameters": [
23471
+ {
23472
+ "name": "target",
23473
+ "type": {
23474
+ "text": "HTMLElement"
23475
+ }
23476
+ },
23477
+ {
23478
+ "name": "ids",
23479
+ "type": {
23480
+ "text": "string[]"
23481
+ }
23482
+ }
23483
+ ]
21859
23484
  },
21860
23485
  {
21861
23486
  "kind": "method",
21862
- "name": "#onChange",
23487
+ "name": "#updateFocusability",
21863
23488
  "privacy": "private",
21864
23489
  "return": {
21865
23490
  "type": {
@@ -21868,46 +23493,32 @@
21868
23493
  },
21869
23494
  "parameters": [
21870
23495
  {
21871
- "name": "e",
23496
+ "name": "needed",
21872
23497
  "type": {
21873
- "text": "Event"
23498
+ "text": "boolean"
21874
23499
  }
21875
23500
  }
21876
23501
  ]
21877
- },
21878
- {
21879
- "kind": "field",
21880
- "name": "#onInputRef",
21881
- "privacy": "private"
21882
- }
21883
- ],
21884
- "events": [
21885
- {
21886
- "name": "change",
21887
- "type": {
21888
- "text": "CustomEvent"
21889
- },
21890
- "description": "The checkbox was toggled by the user, in either direction; detail: `{ checked }`. Programmatic `checked` assignments do not fire it."
21891
23502
  }
21892
23503
  ],
21893
23504
  "attributes": [
21894
23505
  {
21895
- "name": "checked",
23506
+ "name": "placement",
21896
23507
  "type": {
21897
- "text": "boolean"
23508
+ "text": "UiTooltipPlacement"
21898
23509
  },
21899
- "default": "false",
21900
- "description": "Whether the box is checked.",
21901
- "fieldName": "checked"
23510
+ "default": "\"top\"",
23511
+ "description": "Preferred side of the trigger; flips to the other side when this one lacks room.",
23512
+ "fieldName": "placement"
21902
23513
  },
21903
23514
  {
21904
- "name": "indeterminate",
23515
+ "name": "show-delay",
21905
23516
  "type": {
21906
- "text": "boolean"
23517
+ "text": "number"
21907
23518
  },
21908
- "default": "false",
21909
- "description": "Visual \"partial selection\" state; cleared on the next user interaction.",
21910
- "fieldName": "indeterminate"
23519
+ "default": "300",
23520
+ "description": "Hover delay in milliseconds before the tooltip appears; keyboard focus shows it at once.",
23521
+ "fieldName": "showDelay"
21911
23522
  },
21912
23523
  {
21913
23524
  "name": "disabled",
@@ -21915,69 +23526,33 @@
21915
23526
  "text": "boolean"
21916
23527
  },
21917
23528
  "default": "false",
21918
- "description": "Disables interaction; merged with an ancestor `<fieldset disabled>`.",
23529
+ "description": "Suppresses the tooltip and closes it if open.",
21919
23530
  "fieldName": "disabled"
21920
- },
21921
- {
21922
- "name": "required",
21923
- "type": {
21924
- "text": "boolean"
21925
- },
21926
- "default": "false",
21927
- "description": "Marks the control invalid via `ElementInternals` while unchecked.",
21928
- "fieldName": "required"
21929
- },
21930
- {
21931
- "name": "name",
21932
- "type": {
21933
- "text": "string"
21934
- },
21935
- "default": "\"\"",
21936
- "description": "Form field name; submitted as `name=on` only while checked.",
21937
- "fieldName": "name"
21938
- },
21939
- {
21940
- "name": "label",
21941
- "type": {
21942
- "text": "string"
21943
- },
21944
- "default": "\"\"",
21945
- "description": "Visible label text rendered next to the box; overridden by the default slot.",
21946
- "fieldName": "label"
21947
- },
21948
- {
21949
- "name": "iconSize",
21950
- "type": {
21951
- "text": "number"
21952
- },
21953
- "default": "14",
21954
- "description": "Square icon size in pixels — 14 (inline icon size) by default.",
21955
- "fieldName": "iconSize"
21956
23531
  }
21957
23532
  ],
21958
23533
  "superclass": {
21959
23534
  "name": "LitElement",
21960
23535
  "package": "lit"
21961
23536
  },
21962
- "tagName": "ui-checkbox",
23537
+ "tagName": "ui-tooltip",
21963
23538
  "customElement": true
21964
23539
  }
21965
23540
  ],
21966
23541
  "exports": [
21967
23542
  {
21968
23543
  "kind": "js",
21969
- "name": "UiCheckbox",
23544
+ "name": "UiTooltip",
21970
23545
  "declaration": {
21971
- "name": "UiCheckbox",
21972
- "module": "src/ui-checkbox.ts"
23546
+ "name": "UiTooltip",
23547
+ "module": "src/ui-tooltip.ts"
21973
23548
  }
21974
23549
  },
21975
23550
  {
21976
23551
  "kind": "custom-element-definition",
21977
- "name": "ui-checkbox",
23552
+ "name": "ui-tooltip",
21978
23553
  "declaration": {
21979
- "name": "UiCheckbox",
21980
- "module": "src/ui-checkbox.ts"
23554
+ "name": "UiTooltip",
23555
+ "module": "src/ui-tooltip.ts"
21981
23556
  }
21982
23557
  }
21983
23558
  ]
@@ -23611,6 +25186,201 @@
23611
25186
  }
23612
25187
  ]
23613
25188
  },
25189
+ {
25190
+ "kind": "javascript-module",
25191
+ "path": "src/utils/dag-layout.ts",
25192
+ "declarations": [
25193
+ {
25194
+ "kind": "variable",
25195
+ "name": "DAG_NODE_HEIGHT",
25196
+ "type": {
25197
+ "text": "number"
25198
+ },
25199
+ "default": "24",
25200
+ "description": "Height of every node card, in pixels."
25201
+ },
25202
+ {
25203
+ "kind": "variable",
25204
+ "name": "DAG_LABEL_OFFSET",
25205
+ "type": {
25206
+ "text": "number"
25207
+ },
25208
+ "default": "26",
25209
+ "description": "Space before a node's label: left padding, 14px icon, and gap."
25210
+ },
25211
+ {
25212
+ "kind": "variable",
25213
+ "name": "DAG_LABEL_OFFSET_PLAIN",
25214
+ "type": {
25215
+ "text": "number"
25216
+ },
25217
+ "default": "8",
25218
+ "description": "Space before a node's label when it has no icon."
25219
+ },
25220
+ {
25221
+ "kind": "variable",
25222
+ "name": "DAG_MIN_NODE_WIDTH",
25223
+ "type": {
25224
+ "text": "number"
25225
+ },
25226
+ "default": "48",
25227
+ "description": "Narrowest node card, in pixels."
25228
+ },
25229
+ {
25230
+ "kind": "variable",
25231
+ "name": "DAG_MAX_NODE_WIDTH",
25232
+ "type": {
25233
+ "text": "number"
25234
+ },
25235
+ "default": "200",
25236
+ "description": "Widest node card, in pixels; longer labels are shortened with an ellipsis."
25237
+ },
25238
+ {
25239
+ "kind": "function",
25240
+ "name": "approximateTextWidth",
25241
+ "parameters": [
25242
+ {
25243
+ "name": "text"
25244
+ }
25245
+ ],
25246
+ "description": "Width estimate used when the browser cannot measure text (no 2D canvas)."
25247
+ },
25248
+ {
25249
+ "kind": "function",
25250
+ "name": "fitLabel",
25251
+ "return": {
25252
+ "type": {
25253
+ "text": "string"
25254
+ }
25255
+ },
25256
+ "parameters": [
25257
+ {
25258
+ "name": "text",
25259
+ "type": {
25260
+ "text": "string"
25261
+ }
25262
+ },
25263
+ {
25264
+ "name": "maxWidth",
25265
+ "type": {
25266
+ "text": "number"
25267
+ }
25268
+ },
25269
+ {
25270
+ "name": "measure",
25271
+ "type": {
25272
+ "text": "MeasureText"
25273
+ }
25274
+ }
25275
+ ],
25276
+ "description": "Shortens `text` with an ellipsis until it fits `maxWidth`."
25277
+ },
25278
+ {
25279
+ "kind": "function",
25280
+ "name": "layoutDag",
25281
+ "return": {
25282
+ "type": {
25283
+ "text": "DagLayout"
25284
+ }
25285
+ },
25286
+ "parameters": [
25287
+ {
25288
+ "name": "nodes",
25289
+ "type": {
25290
+ "text": "DagLayoutInput[]"
25291
+ }
25292
+ },
25293
+ {
25294
+ "name": "edges",
25295
+ "type": {
25296
+ "text": "Array<{ source: string; target: string }>"
25297
+ }
25298
+ },
25299
+ {
25300
+ "name": "direction",
25301
+ "default": "\"LR\"",
25302
+ "type": {
25303
+ "text": "DagDirection"
25304
+ }
25305
+ },
25306
+ {
25307
+ "name": "measure",
25308
+ "default": "approximateTextWidth",
25309
+ "type": {
25310
+ "text": "MeasureText"
25311
+ }
25312
+ }
25313
+ ],
25314
+ "description": "Lays out a directed graph in layers (Sugiyama-style, via dagre) so every edge points along `direction`.\n\nCycles are broken only to assign layers: every edge is returned, and the ones that close a cycle are marked\n`backward`. Edges whose endpoints are not both in `nodes`, self-edges, and duplicates are ignored. The result\ndoes not depend on input order."
25315
+ }
25316
+ ],
25317
+ "exports": [
25318
+ {
25319
+ "kind": "js",
25320
+ "name": "DAG_NODE_HEIGHT",
25321
+ "declaration": {
25322
+ "name": "DAG_NODE_HEIGHT",
25323
+ "module": "src/utils/dag-layout.ts"
25324
+ }
25325
+ },
25326
+ {
25327
+ "kind": "js",
25328
+ "name": "DAG_LABEL_OFFSET",
25329
+ "declaration": {
25330
+ "name": "DAG_LABEL_OFFSET",
25331
+ "module": "src/utils/dag-layout.ts"
25332
+ }
25333
+ },
25334
+ {
25335
+ "kind": "js",
25336
+ "name": "DAG_LABEL_OFFSET_PLAIN",
25337
+ "declaration": {
25338
+ "name": "DAG_LABEL_OFFSET_PLAIN",
25339
+ "module": "src/utils/dag-layout.ts"
25340
+ }
25341
+ },
25342
+ {
25343
+ "kind": "js",
25344
+ "name": "DAG_MIN_NODE_WIDTH",
25345
+ "declaration": {
25346
+ "name": "DAG_MIN_NODE_WIDTH",
25347
+ "module": "src/utils/dag-layout.ts"
25348
+ }
25349
+ },
25350
+ {
25351
+ "kind": "js",
25352
+ "name": "DAG_MAX_NODE_WIDTH",
25353
+ "declaration": {
25354
+ "name": "DAG_MAX_NODE_WIDTH",
25355
+ "module": "src/utils/dag-layout.ts"
25356
+ }
25357
+ },
25358
+ {
25359
+ "kind": "js",
25360
+ "name": "approximateTextWidth",
25361
+ "declaration": {
25362
+ "name": "approximateTextWidth",
25363
+ "module": "src/utils/dag-layout.ts"
25364
+ }
25365
+ },
25366
+ {
25367
+ "kind": "js",
25368
+ "name": "fitLabel",
25369
+ "declaration": {
25370
+ "name": "fitLabel",
25371
+ "module": "src/utils/dag-layout.ts"
25372
+ }
25373
+ },
25374
+ {
25375
+ "kind": "js",
25376
+ "name": "layoutDag",
25377
+ "declaration": {
25378
+ "name": "layoutDag",
25379
+ "module": "src/utils/dag-layout.ts"
25380
+ }
25381
+ }
25382
+ ]
25383
+ },
23614
25384
  {
23615
25385
  "kind": "javascript-module",
23616
25386
  "path": "src/utils/distance.ts",