@f-ewald/components 1.27.3 → 1.29.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -0
- package/custom-elements.json +460 -9
- package/dist/fullscreen-button.d.ts +43 -0
- package/dist/fullscreen-button.d.ts.map +1 -0
- package/dist/fullscreen-button.js +172 -0
- package/dist/fullscreen-button.js.map +1 -0
- package/dist/icons.d.ts +1 -1
- package/dist/icons.d.ts.map +1 -1
- package/dist/icons.js +1 -1
- package/dist/icons.js.map +1 -1
- package/dist/index.d.ts +3 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -0
- package/dist/index.js.map +1 -1
- package/dist/percent-bar-chart.d.ts.map +1 -1
- package/dist/percent-bar-chart.js +9 -2
- package/dist/percent-bar-chart.js.map +1 -1
- package/dist/radio-cards.d.ts +5 -1
- package/dist/radio-cards.d.ts.map +1 -1
- package/dist/radio-cards.js +19 -2
- package/dist/radio-cards.js.map +1 -1
- package/dist/scroll-dots.d.ts +54 -0
- package/dist/scroll-dots.d.ts.map +1 -0
- package/dist/scroll-dots.js +178 -0
- package/dist/scroll-dots.js.map +1 -0
- package/dist/scroll-to-bottom.d.ts +6 -0
- package/dist/scroll-to-bottom.d.ts.map +1 -1
- package/dist/scroll-to-bottom.js +31 -7
- package/dist/scroll-to-bottom.js.map +1 -1
- package/dist/scroll-to-top.d.ts +6 -0
- package/dist/scroll-to-top.d.ts.map +1 -1
- package/dist/scroll-to-top.js +31 -7
- package/dist/scroll-to-top.js.map +1 -1
- package/dist/timeline-container.d.ts +21 -5
- package/dist/timeline-container.d.ts.map +1 -1
- package/dist/timeline-container.js +35 -7
- package/dist/timeline-container.js.map +1 -1
- package/dist/timeline-entry.d.ts +32 -0
- package/dist/timeline-entry.d.ts.map +1 -1
- package/dist/timeline-entry.js +130 -3
- package/dist/timeline-entry.js.map +1 -1
- package/dist/tokens.css +4 -0
- package/dist/tokens.d.ts.map +1 -1
- package/dist/tokens.js +11 -0
- package/dist/tokens.js.map +1 -1
- package/dist/ui-button.d.ts +24 -0
- package/dist/ui-button.d.ts.map +1 -1
- package/dist/ui-button.js +122 -1
- package/dist/ui-button.js.map +1 -1
- package/dist/weight-bar-chart.js +2 -2
- package/dist/weight-bar-chart.js.map +1 -1
- package/docs/design-language.md +19 -0
- package/docs/fullscreen-button.md +70 -0
- package/docs/icons.md +1 -1
- package/docs/radio-cards.md +6 -1
- package/docs/scroll-dots.md +65 -0
- package/docs/scroll-to-bottom.md +15 -0
- package/docs/scroll-to-top.md +15 -0
- package/docs/timeline-container.md +30 -6
- package/docs/timeline-entry.md +18 -0
- package/docs/ui-button.md +28 -0
- package/docs/weight-bar-chart.md +1 -0
- package/llms.txt +159 -16
- package/package.json +1 -1
package/custom-elements.json
CHANGED
|
@@ -7278,6 +7278,118 @@
|
|
|
7278
7278
|
}
|
|
7279
7279
|
]
|
|
7280
7280
|
},
|
|
7281
|
+
{
|
|
7282
|
+
"kind": "javascript-module",
|
|
7283
|
+
"path": "src/fullscreen-button.ts",
|
|
7284
|
+
"declarations": [
|
|
7285
|
+
{
|
|
7286
|
+
"kind": "class",
|
|
7287
|
+
"description": "Toggles fullscreen presentation of the page, or of a given `target` element.\n\nThe icon and accessible name track the *actual* fullscreen state rather than\nthis button's own clicks, because fullscreen can be left without touching it\n— Escape, or the browser's own chrome — which would otherwise leave the\nbutton showing the wrong affordance.\n\nThe control is styled as a square icon-sized `ui-button` `secondary` variant\n(2rem, `--ui-radius-sm` corners, the `--ui-button-secondary-*` background and\nborder tokens, so a gradient theme carries over) layered over an opaque\n`--ui-surface` base and an elevation shadow, since it normally floats above\nthe content it expands.",
|
|
7288
|
+
"name": "FullscreenButton",
|
|
7289
|
+
"members": [
|
|
7290
|
+
{
|
|
7291
|
+
"kind": "field",
|
|
7292
|
+
"name": "target",
|
|
7293
|
+
"type": {
|
|
7294
|
+
"text": "HTMLElement | null"
|
|
7295
|
+
},
|
|
7296
|
+
"default": "null",
|
|
7297
|
+
"description": "Element to present fullscreen; `null` (default) presents the whole page."
|
|
7298
|
+
},
|
|
7299
|
+
{
|
|
7300
|
+
"kind": "field",
|
|
7301
|
+
"name": "enterLabel",
|
|
7302
|
+
"type": {
|
|
7303
|
+
"text": "string"
|
|
7304
|
+
},
|
|
7305
|
+
"default": "\"Enter full screen\"",
|
|
7306
|
+
"description": "Accessible name while not fullscreen.",
|
|
7307
|
+
"attribute": "enter-label"
|
|
7308
|
+
},
|
|
7309
|
+
{
|
|
7310
|
+
"kind": "field",
|
|
7311
|
+
"name": "exitLabel",
|
|
7312
|
+
"type": {
|
|
7313
|
+
"text": "string"
|
|
7314
|
+
},
|
|
7315
|
+
"default": "\"Exit full screen\"",
|
|
7316
|
+
"description": "Accessible name while fullscreen.",
|
|
7317
|
+
"attribute": "exit-label"
|
|
7318
|
+
},
|
|
7319
|
+
{
|
|
7320
|
+
"kind": "field",
|
|
7321
|
+
"name": "_active",
|
|
7322
|
+
"type": {
|
|
7323
|
+
"text": "boolean"
|
|
7324
|
+
},
|
|
7325
|
+
"privacy": "private",
|
|
7326
|
+
"default": "false"
|
|
7327
|
+
},
|
|
7328
|
+
{
|
|
7329
|
+
"kind": "field",
|
|
7330
|
+
"name": "#onChange",
|
|
7331
|
+
"privacy": "private"
|
|
7332
|
+
},
|
|
7333
|
+
{
|
|
7334
|
+
"kind": "field",
|
|
7335
|
+
"name": "#toggle",
|
|
7336
|
+
"privacy": "private",
|
|
7337
|
+
"description": "Rejections are swallowed: browsers refuse the request outside a user\ngesture or under a permissions policy, and there is nothing useful to tell\nthe user about it."
|
|
7338
|
+
}
|
|
7339
|
+
],
|
|
7340
|
+
"events": [
|
|
7341
|
+
{
|
|
7342
|
+
"description": "The fullscreen state changed, from this button or otherwise (`detail: { active }`).",
|
|
7343
|
+
"name": "fullscreen-change"
|
|
7344
|
+
}
|
|
7345
|
+
],
|
|
7346
|
+
"attributes": [
|
|
7347
|
+
{
|
|
7348
|
+
"name": "enter-label",
|
|
7349
|
+
"type": {
|
|
7350
|
+
"text": "string"
|
|
7351
|
+
},
|
|
7352
|
+
"default": "\"Enter full screen\"",
|
|
7353
|
+
"description": "Accessible name while not fullscreen.",
|
|
7354
|
+
"fieldName": "enterLabel"
|
|
7355
|
+
},
|
|
7356
|
+
{
|
|
7357
|
+
"name": "exit-label",
|
|
7358
|
+
"type": {
|
|
7359
|
+
"text": "string"
|
|
7360
|
+
},
|
|
7361
|
+
"default": "\"Exit full screen\"",
|
|
7362
|
+
"description": "Accessible name while fullscreen.",
|
|
7363
|
+
"fieldName": "exitLabel"
|
|
7364
|
+
}
|
|
7365
|
+
],
|
|
7366
|
+
"superclass": {
|
|
7367
|
+
"name": "LitElement",
|
|
7368
|
+
"package": "lit"
|
|
7369
|
+
},
|
|
7370
|
+
"tagName": "fullscreen-button",
|
|
7371
|
+
"customElement": true
|
|
7372
|
+
}
|
|
7373
|
+
],
|
|
7374
|
+
"exports": [
|
|
7375
|
+
{
|
|
7376
|
+
"kind": "js",
|
|
7377
|
+
"name": "FullscreenButton",
|
|
7378
|
+
"declaration": {
|
|
7379
|
+
"name": "FullscreenButton",
|
|
7380
|
+
"module": "src/fullscreen-button.ts"
|
|
7381
|
+
}
|
|
7382
|
+
},
|
|
7383
|
+
{
|
|
7384
|
+
"kind": "custom-element-definition",
|
|
7385
|
+
"name": "fullscreen-button",
|
|
7386
|
+
"declaration": {
|
|
7387
|
+
"name": "FullscreenButton",
|
|
7388
|
+
"module": "src/fullscreen-button.ts"
|
|
7389
|
+
}
|
|
7390
|
+
}
|
|
7391
|
+
]
|
|
7392
|
+
},
|
|
7281
7393
|
{
|
|
7282
7394
|
"kind": "javascript-module",
|
|
7283
7395
|
"path": "src/gallery-item-variant.ts",
|
|
@@ -7825,7 +7937,7 @@
|
|
|
7825
7937
|
"default": "16"
|
|
7826
7938
|
}
|
|
7827
7939
|
],
|
|
7828
|
-
"description": "
|
|
7940
|
+
"description": "An AI-powered action (pairs with ui-button's `ai` ring), a gradient-theme toggle, or a decorative/enhanced visual style."
|
|
7829
7941
|
},
|
|
7830
7942
|
{
|
|
7831
7943
|
"kind": "function",
|
|
@@ -8872,6 +8984,38 @@
|
|
|
8872
8984
|
"module": "./scroll-to-bottom.js"
|
|
8873
8985
|
}
|
|
8874
8986
|
},
|
|
8987
|
+
{
|
|
8988
|
+
"kind": "js",
|
|
8989
|
+
"name": "ScrollDots",
|
|
8990
|
+
"declaration": {
|
|
8991
|
+
"name": "ScrollDots",
|
|
8992
|
+
"module": "./scroll-dots.js"
|
|
8993
|
+
}
|
|
8994
|
+
},
|
|
8995
|
+
{
|
|
8996
|
+
"kind": "js",
|
|
8997
|
+
"name": "DotSelectDetail",
|
|
8998
|
+
"declaration": {
|
|
8999
|
+
"name": "DotSelectDetail",
|
|
9000
|
+
"module": "./scroll-dots.js"
|
|
9001
|
+
}
|
|
9002
|
+
},
|
|
9003
|
+
{
|
|
9004
|
+
"kind": "js",
|
|
9005
|
+
"name": "ScrollDotItem",
|
|
9006
|
+
"declaration": {
|
|
9007
|
+
"name": "ScrollDotItem",
|
|
9008
|
+
"module": "./scroll-dots.js"
|
|
9009
|
+
}
|
|
9010
|
+
},
|
|
9011
|
+
{
|
|
9012
|
+
"kind": "js",
|
|
9013
|
+
"name": "ScrollDotsItem",
|
|
9014
|
+
"declaration": {
|
|
9015
|
+
"name": "ScrollDotsItem",
|
|
9016
|
+
"module": "./scroll-dots.js"
|
|
9017
|
+
}
|
|
9018
|
+
},
|
|
8875
9019
|
{
|
|
8876
9020
|
"kind": "js",
|
|
8877
9021
|
"name": "ScrollToTop",
|
|
@@ -8880,6 +9024,22 @@
|
|
|
8880
9024
|
"module": "./scroll-to-top.js"
|
|
8881
9025
|
}
|
|
8882
9026
|
},
|
|
9027
|
+
{
|
|
9028
|
+
"kind": "js",
|
|
9029
|
+
"name": "FullscreenButton",
|
|
9030
|
+
"declaration": {
|
|
9031
|
+
"name": "FullscreenButton",
|
|
9032
|
+
"module": "./fullscreen-button.js"
|
|
9033
|
+
}
|
|
9034
|
+
},
|
|
9035
|
+
{
|
|
9036
|
+
"kind": "js",
|
|
9037
|
+
"name": "FullscreenChangeDetail",
|
|
9038
|
+
"declaration": {
|
|
9039
|
+
"name": "FullscreenChangeDetail",
|
|
9040
|
+
"module": "./fullscreen-button.js"
|
|
9041
|
+
}
|
|
9042
|
+
},
|
|
8883
9043
|
{
|
|
8884
9044
|
"kind": "js",
|
|
8885
9045
|
"name": "SlidePanel",
|
|
@@ -9448,6 +9608,14 @@
|
|
|
9448
9608
|
"module": "./timeline-container.js"
|
|
9449
9609
|
}
|
|
9450
9610
|
},
|
|
9611
|
+
{
|
|
9612
|
+
"kind": "js",
|
|
9613
|
+
"name": "TimelineLayout",
|
|
9614
|
+
"declaration": {
|
|
9615
|
+
"name": "TimelineLayout",
|
|
9616
|
+
"module": "./timeline-container.js"
|
|
9617
|
+
}
|
|
9618
|
+
},
|
|
9451
9619
|
{
|
|
9452
9620
|
"kind": "js",
|
|
9453
9621
|
"name": "TimelineEntry",
|
|
@@ -14682,7 +14850,7 @@
|
|
|
14682
14850
|
"declarations": [
|
|
14683
14851
|
{
|
|
14684
14852
|
"kind": "class",
|
|
14685
|
-
"description": "Single-select group of full-width cards, each with a label and optional\ndescription — for a handful of meaningfully different choices where the\ndescription matters. For many short, same-shaped options (a color swatch,\na basemap style), use `radio-pills` instead. Wraps native radio inputs for\nkeyboard/a11y and fires `change` rather than relying on form submission.\n\nThe selected card's border/radio dot read `--ui-button-accent` (a solid\nstand-in, since `border-color`/`accent-color` can't render a gradient),\nand its background reads the shared `--ui-button-secondary-surface-muted`\nplus `--ui-button-highlight`, so a gradient theme tints it consistently\nwith `button-group`/`pagination-nav`'s equivalents.",
|
|
14853
|
+
"description": "Single-select group of full-width cards, each with a label and optional\ndescription — for a handful of meaningfully different choices where the\ndescription matters. For many short, same-shaped options (a color swatch,\na basemap style), use `radio-pills` instead. Wraps native radio inputs for\nkeyboard/a11y and fires `change` rather than relying on form submission.\n\nThe selected card's border/radio dot read `--ui-button-accent` (a solid\nstand-in, since `border-color`/`accent-color` can't render a gradient),\nand its background reads the shared `--ui-button-secondary-surface-muted`\nplus `--ui-button-highlight`, so a gradient theme tints it consistently\nwith `button-group`/`pagination-nav`'s equivalents. That shared value is\ntuned for small controls, so a card — with far more area — blends it 45%\ntoward `--ui-surface` rather than taking a second token: the tint stays\nthe same hue and gradient, just lighter on light themes (and\ncorrespondingly deeper on dark ones) than on a button.",
|
|
14686
14854
|
"name": "RadioCards",
|
|
14687
14855
|
"members": [
|
|
14688
14856
|
{
|
|
@@ -15457,13 +15625,164 @@
|
|
|
15457
15625
|
}
|
|
15458
15626
|
]
|
|
15459
15627
|
},
|
|
15628
|
+
{
|
|
15629
|
+
"kind": "javascript-module",
|
|
15630
|
+
"path": "src/scroll-dots.ts",
|
|
15631
|
+
"declarations": [
|
|
15632
|
+
{
|
|
15633
|
+
"kind": "class",
|
|
15634
|
+
"description": "Vertical section navigator for a long scrolled page or a slide deck: one dot\nper section, the active one drawn as an elongated rounded bar rather than a\ndot, which is the only cue needed to read position at a glance.\n\nControlled, like `pagination-nav`: it owns no scroll behavior and never\nreads the scroll position. The consumer sets `active` and moves the page in\nresponse to `dot-select` — what counts as the active section differs too much\nbetween a snapped deck and an ordinary long page to bake in.\n\nPositioning is also the consumer's, since a rail is normally fixed into a\nreserved gutter that only the page knows the width of.\n\nThe dots use the same lighter-on-top gradient as `map-circle`/`map-pin`,\nderived from a single base `color` — a rail beside a map reads as the same\nfamily of marks as the pins on it.",
|
|
15635
|
+
"name": "ScrollDots",
|
|
15636
|
+
"members": [
|
|
15637
|
+
{
|
|
15638
|
+
"kind": "field",
|
|
15639
|
+
"name": "items",
|
|
15640
|
+
"type": {
|
|
15641
|
+
"text": "ScrollDotsItem[]"
|
|
15642
|
+
},
|
|
15643
|
+
"default": "[]",
|
|
15644
|
+
"description": "Dots to render, in document order. A bare string is shorthand for `{ label }`."
|
|
15645
|
+
},
|
|
15646
|
+
{
|
|
15647
|
+
"kind": "field",
|
|
15648
|
+
"name": "active",
|
|
15649
|
+
"type": {
|
|
15650
|
+
"text": "number"
|
|
15651
|
+
},
|
|
15652
|
+
"default": "0",
|
|
15653
|
+
"description": "0-based index of the active dot. Out-of-range values simply match no dot.",
|
|
15654
|
+
"attribute": "active"
|
|
15655
|
+
},
|
|
15656
|
+
{
|
|
15657
|
+
"kind": "field",
|
|
15658
|
+
"name": "color",
|
|
15659
|
+
"type": {
|
|
15660
|
+
"text": "string"
|
|
15661
|
+
},
|
|
15662
|
+
"default": "\"\"",
|
|
15663
|
+
"description": "Base color the dot gradient is derived from. Empty uses `--ui-primary`.",
|
|
15664
|
+
"attribute": "color"
|
|
15665
|
+
},
|
|
15666
|
+
{
|
|
15667
|
+
"kind": "field",
|
|
15668
|
+
"name": "label",
|
|
15669
|
+
"type": {
|
|
15670
|
+
"text": "string"
|
|
15671
|
+
},
|
|
15672
|
+
"default": "\"\"",
|
|
15673
|
+
"description": "Accessible name for the rail, e.g. \"Journey stops\".",
|
|
15674
|
+
"attribute": "label"
|
|
15675
|
+
},
|
|
15676
|
+
{
|
|
15677
|
+
"kind": "method",
|
|
15678
|
+
"name": "_renderDot",
|
|
15679
|
+
"privacy": "private",
|
|
15680
|
+
"parameters": [
|
|
15681
|
+
{
|
|
15682
|
+
"name": "item",
|
|
15683
|
+
"type": {
|
|
15684
|
+
"text": "ScrollDotItem"
|
|
15685
|
+
}
|
|
15686
|
+
},
|
|
15687
|
+
{
|
|
15688
|
+
"name": "index",
|
|
15689
|
+
"type": {
|
|
15690
|
+
"text": "number"
|
|
15691
|
+
}
|
|
15692
|
+
}
|
|
15693
|
+
]
|
|
15694
|
+
},
|
|
15695
|
+
{
|
|
15696
|
+
"kind": "method",
|
|
15697
|
+
"name": "_select",
|
|
15698
|
+
"privacy": "private",
|
|
15699
|
+
"return": {
|
|
15700
|
+
"type": {
|
|
15701
|
+
"text": "void"
|
|
15702
|
+
}
|
|
15703
|
+
},
|
|
15704
|
+
"parameters": [
|
|
15705
|
+
{
|
|
15706
|
+
"name": "index",
|
|
15707
|
+
"type": {
|
|
15708
|
+
"text": "number"
|
|
15709
|
+
}
|
|
15710
|
+
}
|
|
15711
|
+
]
|
|
15712
|
+
}
|
|
15713
|
+
],
|
|
15714
|
+
"events": [
|
|
15715
|
+
{
|
|
15716
|
+
"name": "dot-select",
|
|
15717
|
+
"type": {
|
|
15718
|
+
"text": "CustomEvent"
|
|
15719
|
+
},
|
|
15720
|
+
"description": "The user picked a dot (`detail: { index }`)."
|
|
15721
|
+
}
|
|
15722
|
+
],
|
|
15723
|
+
"attributes": [
|
|
15724
|
+
{
|
|
15725
|
+
"name": "active",
|
|
15726
|
+
"type": {
|
|
15727
|
+
"text": "number"
|
|
15728
|
+
},
|
|
15729
|
+
"default": "0",
|
|
15730
|
+
"description": "0-based index of the active dot. Out-of-range values simply match no dot.",
|
|
15731
|
+
"fieldName": "active"
|
|
15732
|
+
},
|
|
15733
|
+
{
|
|
15734
|
+
"name": "color",
|
|
15735
|
+
"type": {
|
|
15736
|
+
"text": "string"
|
|
15737
|
+
},
|
|
15738
|
+
"default": "\"\"",
|
|
15739
|
+
"description": "Base color the dot gradient is derived from. Empty uses `--ui-primary`.",
|
|
15740
|
+
"fieldName": "color"
|
|
15741
|
+
},
|
|
15742
|
+
{
|
|
15743
|
+
"name": "label",
|
|
15744
|
+
"type": {
|
|
15745
|
+
"text": "string"
|
|
15746
|
+
},
|
|
15747
|
+
"default": "\"\"",
|
|
15748
|
+
"description": "Accessible name for the rail, e.g. \"Journey stops\".",
|
|
15749
|
+
"fieldName": "label"
|
|
15750
|
+
}
|
|
15751
|
+
],
|
|
15752
|
+
"superclass": {
|
|
15753
|
+
"name": "LitElement",
|
|
15754
|
+
"package": "lit"
|
|
15755
|
+
},
|
|
15756
|
+
"tagName": "scroll-dots",
|
|
15757
|
+
"customElement": true
|
|
15758
|
+
}
|
|
15759
|
+
],
|
|
15760
|
+
"exports": [
|
|
15761
|
+
{
|
|
15762
|
+
"kind": "js",
|
|
15763
|
+
"name": "ScrollDots",
|
|
15764
|
+
"declaration": {
|
|
15765
|
+
"name": "ScrollDots",
|
|
15766
|
+
"module": "src/scroll-dots.ts"
|
|
15767
|
+
}
|
|
15768
|
+
},
|
|
15769
|
+
{
|
|
15770
|
+
"kind": "custom-element-definition",
|
|
15771
|
+
"name": "scroll-dots",
|
|
15772
|
+
"declaration": {
|
|
15773
|
+
"name": "ScrollDots",
|
|
15774
|
+
"module": "src/scroll-dots.ts"
|
|
15775
|
+
}
|
|
15776
|
+
}
|
|
15777
|
+
]
|
|
15778
|
+
},
|
|
15460
15779
|
{
|
|
15461
15780
|
"kind": "javascript-module",
|
|
15462
15781
|
"path": "src/scroll-to-bottom.ts",
|
|
15463
15782
|
"declarations": [
|
|
15464
15783
|
{
|
|
15465
15784
|
"kind": "class",
|
|
15466
|
-
"description": "Overlay button that appears once the page (or a given `target` container)\nhas scrolled more than `threshold` pixels away from the bottom edge, and\nscrolls back to the bottom on click.\n\nWith no `target` (default), the button is `position: fixed` to the\nviewport. When `target` is set, the button switches to `position:\nabsolute` and expects to be placed as a descendant of a `position:\nrelative` (or otherwise positioned) ancestor that establishes the visual\nbounds to float within — typically `target` itself, given `overflow-y:\nauto; position: relative`, so the button stays pinned to that container's\nown visible corner as its content scrolls, rather than floating over the\nwhole page.",
|
|
15785
|
+
"description": "Overlay button that appears once the page (or a given `target` container)\nhas scrolled more than `threshold` pixels away from the bottom edge, and\nscrolls back to the bottom on click.\n\nWith no `target` (default), the button is `position: fixed` to the\nviewport. When `target` is set, the button switches to `position:\nabsolute` and expects to be placed as a descendant of a `position:\nrelative` (or otherwise positioned) ancestor that establishes the visual\nbounds to float within — typically `target` itself, given `overflow-y:\nauto; position: relative`, so the button stays pinned to that container's\nown visible corner as its content scrolls, rather than floating over the\nwhole page.\n\nThe control is styled as a standard secondary button (ui-button's\n`secondary` variant: 2rem tall, `--ui-radius-sm` corners, the\n`--ui-button-secondary-*` background/border tokens, so a gradient theme\ncarries over) rather than a pill, layered over an opaque `--ui-surface`\nbase and an elevation shadow, since it floats above scrolled content.",
|
|
15467
15786
|
"name": "ScrollToBottom",
|
|
15468
15787
|
"members": [
|
|
15469
15788
|
{
|
|
@@ -15611,7 +15930,7 @@
|
|
|
15611
15930
|
"declarations": [
|
|
15612
15931
|
{
|
|
15613
15932
|
"kind": "class",
|
|
15614
|
-
"description": "Overlay button that appears once the page (or a given `target` container)\nhas scrolled more than `threshold` pixels away from the top edge, and\nscrolls back to the top on click.\n\nWith no `target` (default), the button is `position: fixed` to the\nviewport. When `target` is set, the button switches to `position:\nabsolute` and expects to be placed as a descendant of a `position:\nrelative` (or otherwise positioned) ancestor that establishes the visual\nbounds to float within — typically `target` itself, given `overflow-y:\nauto; position: relative`, so the button stays pinned to that container's\nown visible corner as its content scrolls, rather than floating over the\nwhole page.",
|
|
15933
|
+
"description": "Overlay button that appears once the page (or a given `target` container)\nhas scrolled more than `threshold` pixels away from the top edge, and\nscrolls back to the top on click.\n\nWith no `target` (default), the button is `position: fixed` to the\nviewport. When `target` is set, the button switches to `position:\nabsolute` and expects to be placed as a descendant of a `position:\nrelative` (or otherwise positioned) ancestor that establishes the visual\nbounds to float within — typically `target` itself, given `overflow-y:\nauto; position: relative`, so the button stays pinned to that container's\nown visible corner as its content scrolls, rather than floating over the\nwhole page.\n\nThe control is styled as a standard secondary button (ui-button's\n`secondary` variant: 2rem tall, `--ui-radius-sm` corners, the\n`--ui-button-secondary-*` background/border tokens, so a gradient theme\ncarries over) rather than a pill, layered over an opaque `--ui-surface`\nbase and an elevation shadow, since it floats above scrolled content.",
|
|
15615
15934
|
"name": "ScrollToTop",
|
|
15616
15935
|
"members": [
|
|
15617
15936
|
{
|
|
@@ -16941,7 +17260,7 @@
|
|
|
16941
17260
|
"declarations": [
|
|
16942
17261
|
{
|
|
16943
17262
|
"kind": "class",
|
|
16944
|
-
"description": "Vertical timeline: a
|
|
17263
|
+
"description": "Vertical timeline: a connecting line runs down the entries and each slotted\n`timeline-entry` places a dot on it. This is a thin layout and semantics\nwrapper — the entries draw the line segments and dots themselves, so the\ncontainer adds no gap between them (a gap would break the line). Exposed to\nassistive technology as a list of events.\n\n`layout` chooses where the line runs. `left` (the default) puts it down the\nleft edge with each entry's label inline beside its headline. `alternating`\ncenters it and gives each entry three columns — label, line, body — with the\ntwo sides swapping on every second entry, for a presentation timeline rather\nthan an event log.\n\nThe layout is pushed onto each entry rather than read from here, because a\nshadow-DOM child cannot style itself against an ancestor portably —\n`:host-context()` is Chromium-only.",
|
|
16945
17264
|
"name": "TimelineContainer",
|
|
16946
17265
|
"slots": [
|
|
16947
17266
|
{
|
|
@@ -16949,7 +17268,41 @@
|
|
|
16949
17268
|
"name": ""
|
|
16950
17269
|
}
|
|
16951
17270
|
],
|
|
16952
|
-
"members": [
|
|
17271
|
+
"members": [
|
|
17272
|
+
{
|
|
17273
|
+
"kind": "field",
|
|
17274
|
+
"name": "layout",
|
|
17275
|
+
"type": {
|
|
17276
|
+
"text": "TimelineLayout"
|
|
17277
|
+
},
|
|
17278
|
+
"default": "\"left\"",
|
|
17279
|
+
"description": "Arrangement of the entries: a left-edge line, or a centered alternating one.",
|
|
17280
|
+
"attribute": "layout",
|
|
17281
|
+
"reflects": true
|
|
17282
|
+
},
|
|
17283
|
+
{
|
|
17284
|
+
"kind": "method",
|
|
17285
|
+
"name": "#applyLayout",
|
|
17286
|
+
"privacy": "private",
|
|
17287
|
+
"return": {
|
|
17288
|
+
"type": {
|
|
17289
|
+
"text": "void"
|
|
17290
|
+
}
|
|
17291
|
+
},
|
|
17292
|
+
"description": "Mirrors `layout` onto every slotted entry so each can style itself."
|
|
17293
|
+
}
|
|
17294
|
+
],
|
|
17295
|
+
"attributes": [
|
|
17296
|
+
{
|
|
17297
|
+
"name": "layout",
|
|
17298
|
+
"type": {
|
|
17299
|
+
"text": "TimelineLayout"
|
|
17300
|
+
},
|
|
17301
|
+
"default": "\"left\"",
|
|
17302
|
+
"description": "Arrangement of the entries: a left-edge line, or a centered alternating one.",
|
|
17303
|
+
"fieldName": "layout"
|
|
17304
|
+
}
|
|
17305
|
+
],
|
|
16953
17306
|
"superclass": {
|
|
16954
17307
|
"name": "LitElement",
|
|
16955
17308
|
"package": "lit"
|
|
@@ -16983,13 +17336,17 @@
|
|
|
16983
17336
|
"declarations": [
|
|
16984
17337
|
{
|
|
16985
17338
|
"kind": "class",
|
|
16986
|
-
"description": "One event on a `timeline-container`: a dot on the vertical line, an optional\nheadline, a relative timestamp (\"3 hours ago\"), and freely nested content.\nThe connecting line is drawn here — its segment above the dot is hidden on\nthe first entry and the segment below is hidden on the last, so the line caps\nexactly at the first and last dots. Only meaningful inside a\n`timeline-container`; demonstrated through it.\n\n`datetime` is the entry's one timestamp. A nested element that has its own\ntimestamp prop (e.g. `chat-message`'s `timestamp`) should leave it unset —\nsetting both renders the same time twice.\n\nThe dot's `color` types the entry using the shared status-pill palette —\n`primary` by default, plus `neutral`, `info`, `success`, `warning`, and\n`danger`.\n\nSet `compact` for dense, one-line system-status entries: it tightens the\nvertical spacing and renders the content smaller and muted.\n\nSet `running` to replace the dot with an animated gray ring spinner,\nindicating the entry represents in-progress work; `color` has no visible\neffect while `running` is set.",
|
|
17339
|
+
"description": "One event on a `timeline-container`: a dot on the vertical line, an optional\nheadline, a relative timestamp (\"3 hours ago\"), and freely nested content.\nThe connecting line is drawn here — its segment above the dot is hidden on\nthe first entry and the segment below is hidden on the last, so the line caps\nexactly at the first and last dots. Only meaningful inside a\n`timeline-container`; demonstrated through it.\n\n`datetime` is the entry's one timestamp. A nested element that has its own\ntimestamp prop (e.g. `chat-message`'s `timestamp`) should leave it unset —\nsetting both renders the same time twice.\n\n`label` is a free-text alternative for a timeline whose axis is not a wall\nclock — a year, an era, a phase. It wins over `datetime` when both are set.\nSlot `label` instead when it needs its own styling, since a property is\nrendered inside this component's shadow DOM and cannot be reached from\noutside.\n\n`alternating` is set by `timeline-container` and should not be set by hand:\nit switches the entry to three columns — label, line, body — with the sides\nswapping on every second entry. The entry fills whatever height it is given,\nso the line spans it rather than only its content — do not override the\nhost's `display` from outside, since a light-DOM rule beats the `:host`\ndeclaration this relies on.\n\nThe dot's `color` types the entry using the shared status-pill palette —\n`primary` by default, plus `neutral`, `info`, `success`, `warning`, and\n`danger`.\n\nSet `compact` for dense, one-line system-status entries: it tightens the\nvertical spacing and renders the content smaller and muted.\n\nSet `running` to replace the dot with an animated gray ring spinner,\nindicating the entry represents in-progress work; `color` has no visible\neffect while `running` is set.",
|
|
16987
17340
|
"name": "TimelineEntry",
|
|
16988
17341
|
"slots": [
|
|
16989
17342
|
{
|
|
16990
17343
|
"description": "Optional headline/title for the event.",
|
|
16991
17344
|
"name": "headline"
|
|
16992
17345
|
},
|
|
17346
|
+
{
|
|
17347
|
+
"description": "Optional replacement for the `label` property, for a label that needs its own styling.",
|
|
17348
|
+
"name": "label"
|
|
17349
|
+
},
|
|
16993
17350
|
{
|
|
16994
17351
|
"description": "The event content; nest any elements here.",
|
|
16995
17352
|
"name": ""
|
|
@@ -17006,6 +17363,27 @@
|
|
|
17006
17363
|
"description": "ISO 8601 or SQLite datetime string, rendered as a relative time.",
|
|
17007
17364
|
"attribute": "datetime"
|
|
17008
17365
|
},
|
|
17366
|
+
{
|
|
17367
|
+
"kind": "field",
|
|
17368
|
+
"name": "label",
|
|
17369
|
+
"type": {
|
|
17370
|
+
"text": "string | null"
|
|
17371
|
+
},
|
|
17372
|
+
"default": "null",
|
|
17373
|
+
"description": "Free-text label shown in place of the relative time; wins over `datetime`.",
|
|
17374
|
+
"attribute": "label"
|
|
17375
|
+
},
|
|
17376
|
+
{
|
|
17377
|
+
"kind": "field",
|
|
17378
|
+
"name": "alternating",
|
|
17379
|
+
"type": {
|
|
17380
|
+
"text": "boolean"
|
|
17381
|
+
},
|
|
17382
|
+
"default": "false",
|
|
17383
|
+
"description": "Three-column alternating presentation. Set by `timeline-container` from its\nown `layout`; setting it directly is not supported.",
|
|
17384
|
+
"attribute": "alternating",
|
|
17385
|
+
"reflects": true
|
|
17386
|
+
},
|
|
17009
17387
|
{
|
|
17010
17388
|
"kind": "field",
|
|
17011
17389
|
"name": "color",
|
|
@@ -17048,6 +17426,41 @@
|
|
|
17048
17426
|
"default": "false",
|
|
17049
17427
|
"description": "Whether the headline slot currently has assigned content."
|
|
17050
17428
|
},
|
|
17429
|
+
{
|
|
17430
|
+
"kind": "field",
|
|
17431
|
+
"name": "_hasLabel",
|
|
17432
|
+
"type": {
|
|
17433
|
+
"text": "boolean"
|
|
17434
|
+
},
|
|
17435
|
+
"privacy": "private",
|
|
17436
|
+
"default": "false",
|
|
17437
|
+
"description": "Whether the label slot currently has assigned content."
|
|
17438
|
+
},
|
|
17439
|
+
{
|
|
17440
|
+
"kind": "method",
|
|
17441
|
+
"name": "_renderMeta",
|
|
17442
|
+
"privacy": "private",
|
|
17443
|
+
"description": "The entry's one time/label element: a slotted label, else the `label`\nproperty, else a relative time. Placed inline beside the headline in the\ndefault layout and in its own column when alternating."
|
|
17444
|
+
},
|
|
17445
|
+
{
|
|
17446
|
+
"kind": "method",
|
|
17447
|
+
"name": "_onLabelSlotChange",
|
|
17448
|
+
"privacy": "private",
|
|
17449
|
+
"return": {
|
|
17450
|
+
"type": {
|
|
17451
|
+
"text": "void"
|
|
17452
|
+
}
|
|
17453
|
+
},
|
|
17454
|
+
"parameters": [
|
|
17455
|
+
{
|
|
17456
|
+
"name": "event",
|
|
17457
|
+
"type": {
|
|
17458
|
+
"text": "Event"
|
|
17459
|
+
}
|
|
17460
|
+
}
|
|
17461
|
+
],
|
|
17462
|
+
"description": "Tracks whether the label slot has content, so an empty one can collapse."
|
|
17463
|
+
},
|
|
17051
17464
|
{
|
|
17052
17465
|
"kind": "method",
|
|
17053
17466
|
"name": "_onHeadlineSlotChange",
|
|
@@ -17078,6 +17491,24 @@
|
|
|
17078
17491
|
"description": "ISO 8601 or SQLite datetime string, rendered as a relative time.",
|
|
17079
17492
|
"fieldName": "datetime"
|
|
17080
17493
|
},
|
|
17494
|
+
{
|
|
17495
|
+
"name": "label",
|
|
17496
|
+
"type": {
|
|
17497
|
+
"text": "string | null"
|
|
17498
|
+
},
|
|
17499
|
+
"default": "null",
|
|
17500
|
+
"description": "Free-text label shown in place of the relative time; wins over `datetime`.",
|
|
17501
|
+
"fieldName": "label"
|
|
17502
|
+
},
|
|
17503
|
+
{
|
|
17504
|
+
"name": "alternating",
|
|
17505
|
+
"type": {
|
|
17506
|
+
"text": "boolean"
|
|
17507
|
+
},
|
|
17508
|
+
"default": "false",
|
|
17509
|
+
"description": "Three-column alternating presentation. Set by `timeline-container` from its\nown `layout`; setting it directly is not supported.",
|
|
17510
|
+
"fieldName": "alternating"
|
|
17511
|
+
},
|
|
17081
17512
|
{
|
|
17082
17513
|
"name": "color",
|
|
17083
17514
|
"type": {
|
|
@@ -17372,7 +17803,7 @@
|
|
|
17372
17803
|
"type": {
|
|
17373
17804
|
"text": "Record<string, string>"
|
|
17374
17805
|
},
|
|
17375
|
-
"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 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\", \"--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 \"--ui-hover-overlay\": \"rgb(255 255 255 / 0.32)\", \"--ui-overlay\": \"rgb(15 23 42 / 0.45)\", // slate-900 / 45% // Shape / depth \"--ui-radius\": \"0.5rem\", // rounded-lg \"--ui-radius-sm\": \"0.25rem\", // rounded \"--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\", }",
|
|
17806
|
+
"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 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 \"--ui-hover-overlay\": \"rgb(255 255 255 / 0.32)\", \"--ui-overlay\": \"rgb(15 23 42 / 0.45)\", // slate-900 / 45% // Shape / depth \"--ui-radius\": \"0.5rem\", // rounded-lg \"--ui-radius-sm\": \"0.25rem\", // rounded \"--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\", }",
|
|
17376
17807
|
"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`)."
|
|
17377
17808
|
},
|
|
17378
17809
|
{
|
|
@@ -17704,7 +18135,7 @@
|
|
|
17704
18135
|
"declarations": [
|
|
17705
18136
|
{
|
|
17706
18137
|
"kind": "class",
|
|
17707
|
-
"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.",
|
|
18138
|
+
"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.",
|
|
17708
18139
|
"name": "UiButton",
|
|
17709
18140
|
"slots": [
|
|
17710
18141
|
{
|
|
@@ -17761,6 +18192,17 @@
|
|
|
17761
18192
|
"description": "Renders fully rounded (pill-shaped) corners instead of the default `--ui-radius-sm`.",
|
|
17762
18193
|
"attribute": "pill"
|
|
17763
18194
|
},
|
|
18195
|
+
{
|
|
18196
|
+
"kind": "field",
|
|
18197
|
+
"name": "ai",
|
|
18198
|
+
"type": {
|
|
18199
|
+
"text": "boolean"
|
|
18200
|
+
},
|
|
18201
|
+
"default": "false",
|
|
18202
|
+
"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.",
|
|
18203
|
+
"attribute": "ai",
|
|
18204
|
+
"reflects": true
|
|
18205
|
+
},
|
|
17764
18206
|
{
|
|
17765
18207
|
"kind": "field",
|
|
17766
18208
|
"name": "href",
|
|
@@ -17850,6 +18292,15 @@
|
|
|
17850
18292
|
"description": "Renders fully rounded (pill-shaped) corners instead of the default `--ui-radius-sm`.",
|
|
17851
18293
|
"fieldName": "pill"
|
|
17852
18294
|
},
|
|
18295
|
+
{
|
|
18296
|
+
"name": "ai",
|
|
18297
|
+
"type": {
|
|
18298
|
+
"text": "boolean"
|
|
18299
|
+
},
|
|
18300
|
+
"default": "false",
|
|
18301
|
+
"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.",
|
|
18302
|
+
"fieldName": "ai"
|
|
18303
|
+
},
|
|
17853
18304
|
{
|
|
17854
18305
|
"name": "href",
|
|
17855
18306
|
"type": {
|