@f-ewald/components 1.23.1 → 1.25.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 (96) hide show
  1. package/README.md +13 -0
  2. package/custom-elements.json +1882 -595
  3. package/dist/address-autocomplete.d.ts.map +1 -1
  4. package/dist/address-autocomplete.js +7 -3
  5. package/dist/address-autocomplete.js.map +1 -1
  6. package/dist/audio-player.d.ts +53 -0
  7. package/dist/audio-player.d.ts.map +1 -0
  8. package/dist/audio-player.js +267 -0
  9. package/dist/audio-player.js.map +1 -0
  10. package/dist/autocomplete-input.d.ts.map +1 -1
  11. package/dist/autocomplete-input.js +7 -3
  12. package/dist/autocomplete-input.js.map +1 -1
  13. package/dist/button-group.d.ts +12 -1
  14. package/dist/button-group.d.ts.map +1 -1
  15. package/dist/button-group.js +35 -3
  16. package/dist/button-group.js.map +1 -1
  17. package/dist/comment-composer.d.ts +54 -0
  18. package/dist/comment-composer.d.ts.map +1 -0
  19. package/dist/comment-composer.js +244 -0
  20. package/dist/comment-composer.js.map +1 -0
  21. package/dist/confirm-dialog.d.ts +4 -1
  22. package/dist/confirm-dialog.d.ts.map +1 -1
  23. package/dist/confirm-dialog.js +47 -9
  24. package/dist/confirm-dialog.js.map +1 -1
  25. package/dist/dropdown-button.d.ts +4 -1
  26. package/dist/dropdown-button.d.ts.map +1 -1
  27. package/dist/dropdown-button.js +29 -3
  28. package/dist/dropdown-button.js.map +1 -1
  29. package/dist/icons.d.ts +12 -0
  30. package/dist/icons.d.ts.map +1 -1
  31. package/dist/icons.js +12 -0
  32. package/dist/icons.js.map +1 -1
  33. package/dist/index.d.ts +4 -1
  34. package/dist/index.d.ts.map +1 -1
  35. package/dist/index.js +4 -1
  36. package/dist/index.js.map +1 -1
  37. package/dist/page-header.d.ts +8 -3
  38. package/dist/page-header.d.ts.map +1 -1
  39. package/dist/page-header.js +33 -12
  40. package/dist/page-header.js.map +1 -1
  41. package/dist/pagination-nav.d.ts +7 -0
  42. package/dist/pagination-nav.d.ts.map +1 -1
  43. package/dist/pagination-nav.js +19 -4
  44. package/dist/pagination-nav.js.map +1 -1
  45. package/dist/radio-cards.d.ts +6 -0
  46. package/dist/radio-cards.d.ts.map +1 -1
  47. package/dist/radio-cards.js +13 -3
  48. package/dist/radio-cards.js.map +1 -1
  49. package/dist/radio-pills.d.ts +6 -0
  50. package/dist/radio-pills.d.ts.map +1 -1
  51. package/dist/radio-pills.js +13 -3
  52. package/dist/radio-pills.js.map +1 -1
  53. package/dist/range-slider.d.ts.map +1 -1
  54. package/dist/range-slider.js +11 -7
  55. package/dist/range-slider.js.map +1 -1
  56. package/dist/reveal-button.d.ts +5 -1
  57. package/dist/reveal-button.d.ts.map +1 -1
  58. package/dist/reveal-button.js +26 -4
  59. package/dist/reveal-button.js.map +1 -1
  60. package/dist/tokens.css +38 -1
  61. package/dist/tokens.d.ts +16 -0
  62. package/dist/tokens.d.ts.map +1 -1
  63. package/dist/tokens.js +93 -0
  64. package/dist/tokens.js.map +1 -1
  65. package/dist/ui-button.d.ts +18 -0
  66. package/dist/ui-button.d.ts.map +1 -1
  67. package/dist/ui-button.js +50 -7
  68. package/dist/ui-button.js.map +1 -1
  69. package/dist/utils/duration.d.ts +8 -0
  70. package/dist/utils/duration.d.ts.map +1 -1
  71. package/dist/utils/duration.js +18 -0
  72. package/dist/utils/duration.js.map +1 -1
  73. package/dist/utils/transport-controls.d.ts +11 -0
  74. package/dist/utils/transport-controls.d.ts.map +1 -0
  75. package/dist/utils/transport-controls.js +113 -0
  76. package/dist/utils/transport-controls.js.map +1 -0
  77. package/dist/video-player.d.ts +60 -0
  78. package/dist/video-player.d.ts.map +1 -0
  79. package/dist/video-player.js +324 -0
  80. package/dist/video-player.js.map +1 -0
  81. package/docs/audio-player.md +60 -0
  82. package/docs/button-group.md +18 -1
  83. package/docs/comment-composer.md +68 -0
  84. package/docs/confirm-dialog.md +19 -1
  85. package/docs/dropdown-button.md +10 -1
  86. package/docs/icons.md +6 -0
  87. package/docs/page-header.md +11 -4
  88. package/docs/pagination-nav.md +14 -0
  89. package/docs/radio-cards.md +9 -0
  90. package/docs/radio-pills.md +9 -0
  91. package/docs/range-slider.md +3 -0
  92. package/docs/reveal-button.md +11 -1
  93. package/docs/ui-button.md +34 -0
  94. package/docs/video-player.md +59 -0
  95. package/llms.txt +165 -23
  96. package/package.json +1 -1
@@ -1398,83 +1398,153 @@
1398
1398
  },
1399
1399
  {
1400
1400
  "kind": "javascript-module",
1401
- "path": "src/auto-scroll.ts",
1401
+ "path": "src/audio-player.ts",
1402
1402
  "declarations": [
1403
1403
  {
1404
1404
  "kind": "class",
1405
- "description": "Wraps arbitrary slotted content (e.g. `timeline-container`) and keeps it\nscrolled to the bottom as new children are appended — but only while the\nuser is already scrolled near the bottom (\"stick to bottom\", a chat/log-\nviewer convention). If the user has scrolled up to read earlier content,\nnew content does not yank the scroll position back down.\n\nNew content is detected via a `MutationObserver`, so no cooperation from\nwhatever is slotted in is required. The host itself is the scrollable\nregion (`overflow-y: auto`) and needs a consumer-supplied bounded height to\nhave anything to scroll, e.g. `auto-scroll { height: 24rem; }`.",
1406
- "name": "AutoScroll",
1407
- "slots": [
1408
- {
1409
- "description": "Content to auto-scroll.",
1410
- "name": ""
1411
- }
1412
- ],
1405
+ "description": "Compact audio player wrapping a native `<audio>` element (kept off-screen\nfor its decoding/playback engine and free `timeupdate`/`loadedmetadata`\nevents) behind a tokenized transport bar: a play/pause `icon-button`,\nelapsed/total time, a seekable progress bar, and a mute toggle + volume\nslider. The seek/volume sliders are native `<input type=\"range\">`\nelements (see `utils/transport-controls.ts`) for free keyboard and\npointer support, per this package's \"native semantics before custom ARIA\"\nrule.",
1406
+ "name": "AudioPlayer",
1413
1407
  "members": [
1414
1408
  {
1415
1409
  "kind": "field",
1416
- "name": "threshold",
1410
+ "name": "src",
1417
1411
  "type": {
1418
- "text": "number"
1412
+ "text": "string"
1419
1413
  },
1420
- "default": "24",
1421
- "description": "Pixels of tolerance from the bottom edge counted as \"still at the bottom\".",
1422
- "attribute": "threshold"
1414
+ "default": "\"\"",
1415
+ "description": "URL of the audio file to play.",
1416
+ "attribute": "src"
1423
1417
  },
1424
1418
  {
1425
1419
  "kind": "field",
1426
- "name": "_pinned",
1420
+ "name": "label",
1421
+ "type": {
1422
+ "text": "string"
1423
+ },
1424
+ "default": "\"Audio player\"",
1425
+ "description": "Accessible name for the player, e.g. a track/episode title.",
1426
+ "attribute": "label"
1427
+ },
1428
+ {
1429
+ "kind": "field",
1430
+ "name": "loop",
1431
+ "type": {
1432
+ "text": "boolean"
1433
+ },
1434
+ "default": "false",
1435
+ "description": "Loops playback once it reaches the end.",
1436
+ "attribute": "loop"
1437
+ },
1438
+ {
1439
+ "kind": "field",
1440
+ "name": "preload",
1441
+ "type": {
1442
+ "text": "\"none\" | \"metadata\" | \"auto\""
1443
+ },
1444
+ "default": "\"metadata\"",
1445
+ "description": "Native `<audio preload>` hint.",
1446
+ "attribute": "preload"
1447
+ },
1448
+ {
1449
+ "kind": "field",
1450
+ "name": "_playing",
1427
1451
  "type": {
1428
1452
  "text": "boolean"
1429
1453
  },
1430
1454
  "privacy": "private",
1431
- "default": "true"
1455
+ "default": "false"
1432
1456
  },
1433
1457
  {
1434
1458
  "kind": "field",
1435
- "name": "#observer",
1459
+ "name": "_currentTime",
1460
+ "type": {
1461
+ "text": "number"
1462
+ },
1463
+ "privacy": "private",
1464
+ "default": "0"
1465
+ },
1466
+ {
1467
+ "kind": "field",
1468
+ "name": "_duration",
1436
1469
  "privacy": "private",
1470
+ "default": "NaN"
1471
+ },
1472
+ {
1473
+ "kind": "field",
1474
+ "name": "_volume",
1437
1475
  "type": {
1438
- "text": "MutationObserver | undefined"
1439
- }
1476
+ "text": "number"
1477
+ },
1478
+ "privacy": "private",
1479
+ "default": "1"
1440
1480
  },
1441
1481
  {
1442
1482
  "kind": "field",
1443
- "name": "pinned",
1483
+ "name": "_muted",
1444
1484
  "type": {
1445
1485
  "text": "boolean"
1446
1486
  },
1447
- "description": "Whether the view is currently stuck to the bottom. Read-only; see `scrollToBottom()`.",
1448
- "readonly": true
1487
+ "privacy": "private",
1488
+ "default": "false"
1489
+ },
1490
+ {
1491
+ "kind": "field",
1492
+ "name": "_errored",
1493
+ "type": {
1494
+ "text": "boolean"
1495
+ },
1496
+ "privacy": "private",
1497
+ "default": "false"
1498
+ },
1499
+ {
1500
+ "kind": "field",
1501
+ "name": "_audio",
1502
+ "type": {
1503
+ "text": "HTMLAudioElement | undefined"
1504
+ },
1505
+ "privacy": "private"
1449
1506
  },
1450
1507
  {
1451
1508
  "kind": "method",
1452
- "name": "scrollToBottom",
1509
+ "name": "_togglePlay",
1510
+ "privacy": "private",
1453
1511
  "return": {
1454
1512
  "type": {
1455
1513
  "text": "void"
1456
1514
  }
1457
- },
1458
- "description": "Scrolls to the bottom immediately, regardless of the current `pinned` state."
1515
+ }
1459
1516
  },
1460
1517
  {
1461
- "kind": "field",
1462
- "name": "#onScroll",
1463
- "privacy": "private"
1518
+ "kind": "method",
1519
+ "name": "_toggleMute",
1520
+ "privacy": "private",
1521
+ "return": {
1522
+ "type": {
1523
+ "text": "void"
1524
+ }
1525
+ }
1464
1526
  },
1465
1527
  {
1466
1528
  "kind": "method",
1467
- "name": "#onMutation",
1529
+ "name": "_onSeekInput",
1468
1530
  "privacy": "private",
1469
1531
  "return": {
1470
1532
  "type": {
1471
1533
  "text": "void"
1472
1534
  }
1473
- }
1535
+ },
1536
+ "parameters": [
1537
+ {
1538
+ "name": "e",
1539
+ "type": {
1540
+ "text": "Event"
1541
+ }
1542
+ }
1543
+ ]
1474
1544
  },
1475
1545
  {
1476
1546
  "kind": "method",
1477
- "name": "#setPinned",
1547
+ "name": "_onVolumeInput",
1478
1548
  "privacy": "private",
1479
1549
  "return": {
1480
1550
  "type": {
@@ -1483,98 +1553,351 @@
1483
1553
  },
1484
1554
  "parameters": [
1485
1555
  {
1486
- "name": "pinned",
1556
+ "name": "e",
1487
1557
  "type": {
1488
- "text": "boolean"
1558
+ "text": "Event"
1489
1559
  }
1490
1560
  }
1491
1561
  ]
1562
+ },
1563
+ {
1564
+ "kind": "method",
1565
+ "name": "_onLoadedMetadata",
1566
+ "privacy": "private",
1567
+ "return": {
1568
+ "type": {
1569
+ "text": "void"
1570
+ }
1571
+ }
1572
+ },
1573
+ {
1574
+ "kind": "method",
1575
+ "name": "_onTimeUpdate",
1576
+ "privacy": "private",
1577
+ "return": {
1578
+ "type": {
1579
+ "text": "void"
1580
+ }
1581
+ }
1582
+ },
1583
+ {
1584
+ "kind": "method",
1585
+ "name": "_onPlay",
1586
+ "privacy": "private",
1587
+ "return": {
1588
+ "type": {
1589
+ "text": "void"
1590
+ }
1591
+ }
1592
+ },
1593
+ {
1594
+ "kind": "method",
1595
+ "name": "_onPause",
1596
+ "privacy": "private",
1597
+ "return": {
1598
+ "type": {
1599
+ "text": "void"
1600
+ }
1601
+ }
1602
+ },
1603
+ {
1604
+ "kind": "method",
1605
+ "name": "_onEnded",
1606
+ "privacy": "private",
1607
+ "return": {
1608
+ "type": {
1609
+ "text": "void"
1610
+ }
1611
+ }
1612
+ },
1613
+ {
1614
+ "kind": "method",
1615
+ "name": "_onVolumeChange",
1616
+ "privacy": "private",
1617
+ "return": {
1618
+ "type": {
1619
+ "text": "void"
1620
+ }
1621
+ }
1622
+ },
1623
+ {
1624
+ "kind": "method",
1625
+ "name": "_onError",
1626
+ "privacy": "private",
1627
+ "return": {
1628
+ "type": {
1629
+ "text": "void"
1630
+ }
1631
+ }
1492
1632
  }
1493
1633
  ],
1494
1634
  "events": [
1495
1635
  {
1496
- "name": "pinned-change",
1636
+ "name": "play",
1497
1637
  "type": {
1498
1638
  "text": "CustomEvent"
1499
1639
  },
1500
- "description": "The stick-to-bottom state toggled; detail: `{ pinned }`."
1640
+ "description": "The audio started playing."
1641
+ },
1642
+ {
1643
+ "name": "pause",
1644
+ "type": {
1645
+ "text": "CustomEvent"
1646
+ },
1647
+ "description": "The audio was paused."
1648
+ },
1649
+ {
1650
+ "name": "ended",
1651
+ "type": {
1652
+ "text": "CustomEvent"
1653
+ },
1654
+ "description": "Playback reached the end."
1501
1655
  }
1502
1656
  ],
1503
1657
  "attributes": [
1504
1658
  {
1505
- "name": "threshold",
1659
+ "name": "src",
1506
1660
  "type": {
1507
- "text": "number"
1661
+ "text": "string"
1508
1662
  },
1509
- "default": "24",
1510
- "description": "Pixels of tolerance from the bottom edge counted as \"still at the bottom\".",
1511
- "fieldName": "threshold"
1663
+ "default": "\"\"",
1664
+ "description": "URL of the audio file to play.",
1665
+ "fieldName": "src"
1666
+ },
1667
+ {
1668
+ "name": "label",
1669
+ "type": {
1670
+ "text": "string"
1671
+ },
1672
+ "default": "\"Audio player\"",
1673
+ "description": "Accessible name for the player, e.g. a track/episode title.",
1674
+ "fieldName": "label"
1675
+ },
1676
+ {
1677
+ "name": "loop",
1678
+ "type": {
1679
+ "text": "boolean"
1680
+ },
1681
+ "default": "false",
1682
+ "description": "Loops playback once it reaches the end.",
1683
+ "fieldName": "loop"
1684
+ },
1685
+ {
1686
+ "name": "preload",
1687
+ "type": {
1688
+ "text": "\"none\" | \"metadata\" | \"auto\""
1689
+ },
1690
+ "default": "\"metadata\"",
1691
+ "description": "Native `<audio preload>` hint.",
1692
+ "fieldName": "preload"
1512
1693
  }
1513
1694
  ],
1514
1695
  "superclass": {
1515
1696
  "name": "LitElement",
1516
1697
  "package": "lit"
1517
1698
  },
1518
- "tagName": "auto-scroll",
1699
+ "tagName": "audio-player",
1519
1700
  "customElement": true
1520
1701
  }
1521
1702
  ],
1522
1703
  "exports": [
1523
1704
  {
1524
1705
  "kind": "js",
1525
- "name": "AutoScroll",
1706
+ "name": "AudioPlayer",
1526
1707
  "declaration": {
1527
- "name": "AutoScroll",
1528
- "module": "src/auto-scroll.ts"
1708
+ "name": "AudioPlayer",
1709
+ "module": "src/audio-player.ts"
1529
1710
  }
1530
1711
  },
1531
1712
  {
1532
1713
  "kind": "custom-element-definition",
1533
- "name": "auto-scroll",
1714
+ "name": "audio-player",
1534
1715
  "declaration": {
1535
- "name": "AutoScroll",
1536
- "module": "src/auto-scroll.ts"
1716
+ "name": "AudioPlayer",
1717
+ "module": "src/audio-player.ts"
1537
1718
  }
1538
1719
  }
1539
1720
  ]
1540
1721
  },
1541
1722
  {
1542
1723
  "kind": "javascript-module",
1543
- "path": "src/autocomplete-input.ts",
1724
+ "path": "src/auto-scroll.ts",
1544
1725
  "declarations": [
1545
1726
  {
1546
1727
  "kind": "class",
1547
- "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.",
1548
- "name": "AutocompleteInput",
1728
+ "description": "Wraps arbitrary slotted content (e.g. `timeline-container`) and keeps it\nscrolled to the bottom as new children are appended — but only while the\nuser is already scrolled near the bottom (\"stick to bottom\", a chat/log-\nviewer convention). If the user has scrolled up to read earlier content,\nnew content does not yank the scroll position back down.\n\nNew content is detected via a `MutationObserver`, so no cooperation from\nwhatever is slotted in is required. The host itself is the scrollable\nregion (`overflow-y: auto`) and needs a consumer-supplied bounded height to\nhave anything to scroll, e.g. `auto-scroll { height: 24rem; }`.",
1729
+ "name": "AutoScroll",
1730
+ "slots": [
1731
+ {
1732
+ "description": "Content to auto-scroll.",
1733
+ "name": ""
1734
+ }
1735
+ ],
1549
1736
  "members": [
1550
1737
  {
1551
1738
  "kind": "field",
1552
- "name": "formAssociated",
1739
+ "name": "threshold",
1553
1740
  "type": {
1554
- "text": "boolean"
1741
+ "text": "number"
1555
1742
  },
1556
- "static": true,
1557
- "default": "true"
1743
+ "default": "24",
1744
+ "description": "Pixels of tolerance from the bottom edge counted as \"still at the bottom\".",
1745
+ "attribute": "threshold"
1558
1746
  },
1559
1747
  {
1560
1748
  "kind": "field",
1561
- "name": "value",
1749
+ "name": "_pinned",
1562
1750
  "type": {
1563
- "text": "string"
1751
+ "text": "boolean"
1564
1752
  },
1565
- "default": "\"\"",
1566
- "description": "Current input value; also the form-associated value submitted with the form.",
1567
- "attribute": "value"
1753
+ "privacy": "private",
1754
+ "default": "true"
1568
1755
  },
1569
1756
  {
1570
1757
  "kind": "field",
1571
- "name": "placeholder",
1758
+ "name": "#observer",
1759
+ "privacy": "private",
1572
1760
  "type": {
1573
- "text": "string"
1574
- },
1575
- "default": "\"\"",
1576
- "description": "Placeholder text shown when the input is empty.",
1577
- "attribute": "placeholder"
1761
+ "text": "MutationObserver | undefined"
1762
+ }
1763
+ },
1764
+ {
1765
+ "kind": "field",
1766
+ "name": "pinned",
1767
+ "type": {
1768
+ "text": "boolean"
1769
+ },
1770
+ "description": "Whether the view is currently stuck to the bottom. Read-only; see `scrollToBottom()`.",
1771
+ "readonly": true
1772
+ },
1773
+ {
1774
+ "kind": "method",
1775
+ "name": "scrollToBottom",
1776
+ "return": {
1777
+ "type": {
1778
+ "text": "void"
1779
+ }
1780
+ },
1781
+ "description": "Scrolls to the bottom immediately, regardless of the current `pinned` state."
1782
+ },
1783
+ {
1784
+ "kind": "field",
1785
+ "name": "#onScroll",
1786
+ "privacy": "private"
1787
+ },
1788
+ {
1789
+ "kind": "method",
1790
+ "name": "#onMutation",
1791
+ "privacy": "private",
1792
+ "return": {
1793
+ "type": {
1794
+ "text": "void"
1795
+ }
1796
+ }
1797
+ },
1798
+ {
1799
+ "kind": "method",
1800
+ "name": "#setPinned",
1801
+ "privacy": "private",
1802
+ "return": {
1803
+ "type": {
1804
+ "text": "void"
1805
+ }
1806
+ },
1807
+ "parameters": [
1808
+ {
1809
+ "name": "pinned",
1810
+ "type": {
1811
+ "text": "boolean"
1812
+ }
1813
+ }
1814
+ ]
1815
+ }
1816
+ ],
1817
+ "events": [
1818
+ {
1819
+ "name": "pinned-change",
1820
+ "type": {
1821
+ "text": "CustomEvent"
1822
+ },
1823
+ "description": "The stick-to-bottom state toggled; detail: `{ pinned }`."
1824
+ }
1825
+ ],
1826
+ "attributes": [
1827
+ {
1828
+ "name": "threshold",
1829
+ "type": {
1830
+ "text": "number"
1831
+ },
1832
+ "default": "24",
1833
+ "description": "Pixels of tolerance from the bottom edge counted as \"still at the bottom\".",
1834
+ "fieldName": "threshold"
1835
+ }
1836
+ ],
1837
+ "superclass": {
1838
+ "name": "LitElement",
1839
+ "package": "lit"
1840
+ },
1841
+ "tagName": "auto-scroll",
1842
+ "customElement": true
1843
+ }
1844
+ ],
1845
+ "exports": [
1846
+ {
1847
+ "kind": "js",
1848
+ "name": "AutoScroll",
1849
+ "declaration": {
1850
+ "name": "AutoScroll",
1851
+ "module": "src/auto-scroll.ts"
1852
+ }
1853
+ },
1854
+ {
1855
+ "kind": "custom-element-definition",
1856
+ "name": "auto-scroll",
1857
+ "declaration": {
1858
+ "name": "AutoScroll",
1859
+ "module": "src/auto-scroll.ts"
1860
+ }
1861
+ }
1862
+ ]
1863
+ },
1864
+ {
1865
+ "kind": "javascript-module",
1866
+ "path": "src/autocomplete-input.ts",
1867
+ "declarations": [
1868
+ {
1869
+ "kind": "class",
1870
+ "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.",
1871
+ "name": "AutocompleteInput",
1872
+ "members": [
1873
+ {
1874
+ "kind": "field",
1875
+ "name": "formAssociated",
1876
+ "type": {
1877
+ "text": "boolean"
1878
+ },
1879
+ "static": true,
1880
+ "default": "true"
1881
+ },
1882
+ {
1883
+ "kind": "field",
1884
+ "name": "value",
1885
+ "type": {
1886
+ "text": "string"
1887
+ },
1888
+ "default": "\"\"",
1889
+ "description": "Current input value; also the form-associated value submitted with the form.",
1890
+ "attribute": "value"
1891
+ },
1892
+ {
1893
+ "kind": "field",
1894
+ "name": "placeholder",
1895
+ "type": {
1896
+ "text": "string"
1897
+ },
1898
+ "default": "\"\"",
1899
+ "description": "Placeholder text shown when the input is empty.",
1900
+ "attribute": "placeholder"
1578
1901
  },
1579
1902
  {
1580
1903
  "kind": "field",
@@ -2187,7 +2510,7 @@
2187
2510
  "declarations": [
2188
2511
  {
2189
2512
  "kind": "class",
2190
- "description": "Single-select segmented control — a strip of buttons joined into one\nshared-border shape, for a small, persistent set of mutually exclusive\nchoices (a view switcher, a theme picker) where the *currently selected*\noption should read as visually \"pressed,\" not just checked. For many\nshort, individually pill-shaped choices, use `radio-pills` instead. Wraps\nnative radio inputs for keyboard/a11y and fires `change` rather than\nrelying on form submission.",
2513
+ "description": "Single-select segmented control — a strip of buttons joined into one\nshared-border shape, for a small, persistent set of mutually exclusive\nchoices (a view switcher, a theme picker) where the *currently selected*\noption should read as visually \"pressed,\" not just checked. For many\nshort, individually pill-shaped choices, use `radio-pills` instead. Wraps\nnative radio inputs for keyboard/a11y and fires `change` rather than\nrelying on form submission. Set `size=\"sm\"` for a compact strip one step\nbelow the default, matching `ui-button`'s `sm` size.\n\nThe checked segment reads `--ui-button-background`/`-hover`/`-active`,\nsame as `ui-button`'s `primary` variant. Unchecked segments are treated as\n`ui-button`'s `secondary` variant: they read the shared\n`--ui-button-secondary-background`/`-active` (rest/pressed) so a gradient\ntheme applies consistently, but use the shared `--ui-button-secondary-surface-muted`\n(also used by `pagination-nav`) for hover, since — unlike `secondary` — an\nunchecked segment already paints `--ui-surface-muted` on hover by default.",
2191
2514
  "name": "ButtonGroup",
2192
2515
  "members": [
2193
2516
  {
@@ -2230,6 +2553,17 @@
2230
2553
  "attribute": "icon-only",
2231
2554
  "reflects": true
2232
2555
  },
2556
+ {
2557
+ "kind": "field",
2558
+ "name": "size",
2559
+ "type": {
2560
+ "text": "\"sm\" | \"md\""
2561
+ },
2562
+ "default": "\"md\"",
2563
+ "description": "Size — `sm` reduces segment height/padding/font-size one step below the default.",
2564
+ "attribute": "size",
2565
+ "reflects": true
2566
+ },
2233
2567
  {
2234
2568
  "kind": "field",
2235
2569
  "name": "#name",
@@ -2287,6 +2621,15 @@
2287
2621
  "default": "false",
2288
2622
  "description": "Hides labels visually (icons only) while keeping them as the accessible name.",
2289
2623
  "fieldName": "iconOnly"
2624
+ },
2625
+ {
2626
+ "name": "size",
2627
+ "type": {
2628
+ "text": "\"sm\" | \"md\""
2629
+ },
2630
+ "default": "\"md\"",
2631
+ "description": "Size — `sm` reduces segment height/padding/font-size one step below the default.",
2632
+ "fieldName": "size"
2290
2633
  }
2291
2634
  ],
2292
2635
  "superclass": {
@@ -3223,32 +3566,62 @@
3223
3566
  },
3224
3567
  {
3225
3568
  "kind": "javascript-module",
3226
- "path": "src/confirm-dialog.ts",
3569
+ "path": "src/comment-composer.ts",
3227
3570
  "declarations": [
3228
3571
  {
3229
3572
  "kind": "class",
3230
- "description": "Reusable confirmation dialog: overlay + centered card with a slotted body,\nan optional error line, and Cancel/Confirm actions. Instant `display:none`\n→ `display:flex` toggle (no transitions). Fires `confirm`/`cancel`\n(bubbling, composed) instead of owning any deletion logic itself —\ncallers stay in charge of the request.",
3231
- "name": "ConfirmDialog",
3573
+ "description": "GitHub/Slack-style comment composer: a one-line text field that expands\ninto a multi-line textarea with a bottom-right Cancel/Submit footer\n(`form-actions`) as soon as it's focused or clicked. Submitting fires\n`submit` with the trimmed value, then clears the field and collapses back\nto one line — it's meant for posting one comment at a time, not editing a\npersistent value in place (see `editable-text` for that). Canceling (the\nCancel button or `Escape`) discards the draft and collapses without\nfiring `submit`. Clicking away (blur) does neither — the composer stays\nexpanded until the user explicitly submits or cancels. `Cmd`/`Ctrl`+`Enter`\nsubmits from the textarea, matching `editable-text`'s multiline shortcut.\nPurely token-styled (no bespoke colors), so it's themeable via the same\n`--ui-*` custom properties as every other value-entry field.",
3574
+ "name": "CommentComposer",
3232
3575
  "members": [
3233
3576
  {
3234
3577
  "kind": "field",
3235
- "name": "open",
3578
+ "name": "value",
3236
3579
  "type": {
3237
- "text": "boolean"
3580
+ "text": "string"
3238
3581
  },
3239
- "default": "false",
3240
- "description": "Whether the dialog is visible.",
3241
- "attribute": "open"
3582
+ "default": "\"\"",
3583
+ "description": "Committed value shown in the collapsed one-line field.",
3584
+ "attribute": "value"
3242
3585
  },
3243
3586
  {
3244
3587
  "kind": "field",
3245
- "name": "confirmLabel",
3588
+ "name": "placeholder",
3246
3589
  "type": {
3247
3590
  "text": "string"
3248
3591
  },
3249
- "default": "\"Delete\"",
3250
- "description": "Label for the confirm button.",
3251
- "attribute": "confirm-label"
3592
+ "default": "\"Add a comment…\"",
3593
+ "description": "Placeholder text shown when empty.",
3594
+ "attribute": "placeholder"
3595
+ },
3596
+ {
3597
+ "kind": "field",
3598
+ "name": "label",
3599
+ "type": {
3600
+ "text": "string"
3601
+ },
3602
+ "default": "\"Comment\"",
3603
+ "description": "Accessible name applied to the input/textarea.",
3604
+ "attribute": "label"
3605
+ },
3606
+ {
3607
+ "kind": "field",
3608
+ "name": "rows",
3609
+ "type": {
3610
+ "text": "number"
3611
+ },
3612
+ "default": "4",
3613
+ "description": "Visible row count once expanded.",
3614
+ "attribute": "rows"
3615
+ },
3616
+ {
3617
+ "kind": "field",
3618
+ "name": "submitLabel",
3619
+ "type": {
3620
+ "text": "string"
3621
+ },
3622
+ "default": "\"Submit\"",
3623
+ "description": "Label for the primary submit button.",
3624
+ "attribute": "submit-label"
3252
3625
  },
3253
3626
  {
3254
3627
  "kind": "field",
@@ -3257,71 +3630,86 @@
3257
3630
  "text": "string"
3258
3631
  },
3259
3632
  "default": "\"Cancel\"",
3260
- "description": "Label for the cancel button.",
3633
+ "description": "Label for the secondary cancel button.",
3261
3634
  "attribute": "cancel-label"
3262
3635
  },
3263
3636
  {
3264
3637
  "kind": "field",
3265
- "name": "danger",
3638
+ "name": "disabled",
3266
3639
  "type": {
3267
3640
  "text": "boolean"
3268
3641
  },
3269
- "default": "true",
3270
- "description": "Danger (red) vs. primary (indigo) styling for the confirm button.",
3271
- "attribute": "danger"
3642
+ "default": "false",
3643
+ "description": "Disables the field entirely.",
3644
+ "attribute": "disabled"
3272
3645
  },
3273
3646
  {
3274
3647
  "kind": "field",
3275
- "name": "busy",
3648
+ "name": "_expanded",
3276
3649
  "type": {
3277
3650
  "text": "boolean"
3278
3651
  },
3279
- "default": "false",
3280
- "description": "Shows a spinner and disables both buttons while a request is in flight.",
3281
- "attribute": "busy"
3652
+ "privacy": "private",
3653
+ "default": "false"
3282
3654
  },
3283
3655
  {
3284
3656
  "kind": "field",
3285
- "name": "error",
3657
+ "name": "_draft",
3286
3658
  "type": {
3287
- "text": "string | null"
3659
+ "text": "string"
3288
3660
  },
3289
- "default": "null",
3290
- "description": "Inline error line shown below the body, or null for none.",
3291
- "attribute": "error"
3661
+ "privacy": "private",
3662
+ "default": "\"\""
3292
3663
  },
3293
3664
  {
3294
3665
  "kind": "field",
3295
- "name": "_previousFocus",
3666
+ "name": "_textarea",
3296
3667
  "type": {
3297
- "text": "HTMLElement | null"
3668
+ "text": "HTMLTextAreaElement | undefined"
3298
3669
  },
3299
- "privacy": "private",
3300
- "default": "null"
3670
+ "privacy": "private"
3301
3671
  },
3302
3672
  {
3303
3673
  "kind": "method",
3304
- "name": "_confirm",
3305
- "privacy": "private"
3674
+ "name": "_expand",
3675
+ "privacy": "private",
3676
+ "return": {
3677
+ "type": {
3678
+ "text": "void"
3679
+ }
3680
+ }
3306
3681
  },
3307
3682
  {
3308
3683
  "kind": "method",
3309
- "name": "_cancel",
3310
- "privacy": "private"
3684
+ "name": "_onInput",
3685
+ "privacy": "private",
3686
+ "return": {
3687
+ "type": {
3688
+ "text": "void"
3689
+ }
3690
+ },
3691
+ "parameters": [
3692
+ {
3693
+ "name": "e",
3694
+ "type": {
3695
+ "text": "Event"
3696
+ }
3697
+ }
3698
+ ]
3311
3699
  },
3312
3700
  {
3313
3701
  "kind": "method",
3314
- "name": "_getFocusableElements",
3702
+ "name": "_cancel",
3315
3703
  "privacy": "private",
3316
3704
  "return": {
3317
3705
  "type": {
3318
- "text": "HTMLElement[]"
3706
+ "text": "void"
3319
3707
  }
3320
3708
  }
3321
3709
  },
3322
3710
  {
3323
3711
  "kind": "method",
3324
- "name": "_focusInitial",
3712
+ "name": "_submit",
3325
3713
  "privacy": "private",
3326
3714
  "return": {
3327
3715
  "type": {
@@ -3330,8 +3718,254 @@
3330
3718
  }
3331
3719
  },
3332
3720
  {
3333
- "kind": "field",
3334
- "name": "_onDocumentFocusIn",
3721
+ "kind": "method",
3722
+ "name": "_onKeydown",
3723
+ "privacy": "private",
3724
+ "return": {
3725
+ "type": {
3726
+ "text": "void"
3727
+ }
3728
+ },
3729
+ "parameters": [
3730
+ {
3731
+ "name": "e",
3732
+ "type": {
3733
+ "text": "KeyboardEvent"
3734
+ }
3735
+ }
3736
+ ]
3737
+ }
3738
+ ],
3739
+ "events": [
3740
+ {
3741
+ "name": "cancel",
3742
+ "type": {
3743
+ "text": "CustomEvent"
3744
+ },
3745
+ "description": "User discarded the draft via the Cancel button or `Escape`."
3746
+ },
3747
+ {
3748
+ "name": "submit",
3749
+ "type": {
3750
+ "text": "CustomEvent"
3751
+ },
3752
+ "description": "User submitted a non-empty comment; detail: `{ value: string }`."
3753
+ }
3754
+ ],
3755
+ "attributes": [
3756
+ {
3757
+ "name": "value",
3758
+ "type": {
3759
+ "text": "string"
3760
+ },
3761
+ "default": "\"\"",
3762
+ "description": "Committed value shown in the collapsed one-line field.",
3763
+ "fieldName": "value"
3764
+ },
3765
+ {
3766
+ "name": "placeholder",
3767
+ "type": {
3768
+ "text": "string"
3769
+ },
3770
+ "default": "\"Add a comment…\"",
3771
+ "description": "Placeholder text shown when empty.",
3772
+ "fieldName": "placeholder"
3773
+ },
3774
+ {
3775
+ "name": "label",
3776
+ "type": {
3777
+ "text": "string"
3778
+ },
3779
+ "default": "\"Comment\"",
3780
+ "description": "Accessible name applied to the input/textarea.",
3781
+ "fieldName": "label"
3782
+ },
3783
+ {
3784
+ "name": "rows",
3785
+ "type": {
3786
+ "text": "number"
3787
+ },
3788
+ "default": "4",
3789
+ "description": "Visible row count once expanded.",
3790
+ "fieldName": "rows"
3791
+ },
3792
+ {
3793
+ "name": "submit-label",
3794
+ "type": {
3795
+ "text": "string"
3796
+ },
3797
+ "default": "\"Submit\"",
3798
+ "description": "Label for the primary submit button.",
3799
+ "fieldName": "submitLabel"
3800
+ },
3801
+ {
3802
+ "name": "cancel-label",
3803
+ "type": {
3804
+ "text": "string"
3805
+ },
3806
+ "default": "\"Cancel\"",
3807
+ "description": "Label for the secondary cancel button.",
3808
+ "fieldName": "cancelLabel"
3809
+ },
3810
+ {
3811
+ "name": "disabled",
3812
+ "type": {
3813
+ "text": "boolean"
3814
+ },
3815
+ "default": "false",
3816
+ "description": "Disables the field entirely.",
3817
+ "fieldName": "disabled"
3818
+ }
3819
+ ],
3820
+ "superclass": {
3821
+ "name": "LitElement",
3822
+ "package": "lit"
3823
+ },
3824
+ "tagName": "comment-composer",
3825
+ "customElement": true
3826
+ }
3827
+ ],
3828
+ "exports": [
3829
+ {
3830
+ "kind": "js",
3831
+ "name": "CommentComposer",
3832
+ "declaration": {
3833
+ "name": "CommentComposer",
3834
+ "module": "src/comment-composer.ts"
3835
+ }
3836
+ },
3837
+ {
3838
+ "kind": "custom-element-definition",
3839
+ "name": "comment-composer",
3840
+ "declaration": {
3841
+ "name": "CommentComposer",
3842
+ "module": "src/comment-composer.ts"
3843
+ }
3844
+ }
3845
+ ]
3846
+ },
3847
+ {
3848
+ "kind": "javascript-module",
3849
+ "path": "src/confirm-dialog.ts",
3850
+ "declarations": [
3851
+ {
3852
+ "kind": "class",
3853
+ "description": "Reusable confirmation dialog: overlay + centered card with a slotted body,\nan optional error line, and Cancel/Confirm actions. Instant `display:none`\n→ `display:flex` toggle (no transitions). Fires `confirm`/`cancel`\n(bubbling, composed) instead of owning any deletion logic itself —\ncallers stay in charge of the request. Set `size=\"sm\"` for compact\nactions one step below the default, matching `ui-button`'s `sm` size.",
3854
+ "name": "ConfirmDialog",
3855
+ "members": [
3856
+ {
3857
+ "kind": "field",
3858
+ "name": "open",
3859
+ "type": {
3860
+ "text": "boolean"
3861
+ },
3862
+ "default": "false",
3863
+ "description": "Whether the dialog is visible.",
3864
+ "attribute": "open"
3865
+ },
3866
+ {
3867
+ "kind": "field",
3868
+ "name": "confirmLabel",
3869
+ "type": {
3870
+ "text": "string"
3871
+ },
3872
+ "default": "\"Delete\"",
3873
+ "description": "Label for the confirm button.",
3874
+ "attribute": "confirm-label"
3875
+ },
3876
+ {
3877
+ "kind": "field",
3878
+ "name": "cancelLabel",
3879
+ "type": {
3880
+ "text": "string"
3881
+ },
3882
+ "default": "\"Cancel\"",
3883
+ "description": "Label for the cancel button.",
3884
+ "attribute": "cancel-label"
3885
+ },
3886
+ {
3887
+ "kind": "field",
3888
+ "name": "danger",
3889
+ "type": {
3890
+ "text": "boolean"
3891
+ },
3892
+ "default": "true",
3893
+ "description": "Danger (red) vs. primary (indigo) styling for the confirm button.",
3894
+ "attribute": "danger"
3895
+ },
3896
+ {
3897
+ "kind": "field",
3898
+ "name": "busy",
3899
+ "type": {
3900
+ "text": "boolean"
3901
+ },
3902
+ "default": "false",
3903
+ "description": "Shows a spinner and disables both buttons while a request is in flight.",
3904
+ "attribute": "busy"
3905
+ },
3906
+ {
3907
+ "kind": "field",
3908
+ "name": "error",
3909
+ "type": {
3910
+ "text": "string | null"
3911
+ },
3912
+ "default": "null",
3913
+ "description": "Inline error line shown below the body, or null for none.",
3914
+ "attribute": "error"
3915
+ },
3916
+ {
3917
+ "kind": "field",
3918
+ "name": "size",
3919
+ "type": {
3920
+ "text": "\"sm\" | \"md\""
3921
+ },
3922
+ "default": "\"md\"",
3923
+ "description": "Size — `sm` reduces both action buttons' height/padding/font-size one step below the default.",
3924
+ "attribute": "size",
3925
+ "reflects": true
3926
+ },
3927
+ {
3928
+ "kind": "field",
3929
+ "name": "_previousFocus",
3930
+ "type": {
3931
+ "text": "HTMLElement | null"
3932
+ },
3933
+ "privacy": "private",
3934
+ "default": "null"
3935
+ },
3936
+ {
3937
+ "kind": "method",
3938
+ "name": "_confirm",
3939
+ "privacy": "private"
3940
+ },
3941
+ {
3942
+ "kind": "method",
3943
+ "name": "_cancel",
3944
+ "privacy": "private"
3945
+ },
3946
+ {
3947
+ "kind": "method",
3948
+ "name": "_getFocusableElements",
3949
+ "privacy": "private",
3950
+ "return": {
3951
+ "type": {
3952
+ "text": "HTMLElement[]"
3953
+ }
3954
+ }
3955
+ },
3956
+ {
3957
+ "kind": "method",
3958
+ "name": "_focusInitial",
3959
+ "privacy": "private",
3960
+ "return": {
3961
+ "type": {
3962
+ "text": "void"
3963
+ }
3964
+ }
3965
+ },
3966
+ {
3967
+ "kind": "field",
3968
+ "name": "_onDocumentFocusIn",
3335
3969
  "privacy": "private"
3336
3970
  },
3337
3971
  {
@@ -3410,6 +4044,15 @@
3410
4044
  "default": "null",
3411
4045
  "description": "Inline error line shown below the body, or null for none.",
3412
4046
  "fieldName": "error"
4047
+ },
4048
+ {
4049
+ "name": "size",
4050
+ "type": {
4051
+ "text": "\"sm\" | \"md\""
4052
+ },
4053
+ "default": "\"md\"",
4054
+ "description": "Size — `sm` reduces both action buttons' height/padding/font-size one step below the default.",
4055
+ "fieldName": "size"
3413
4056
  }
3414
4057
  ],
3415
4058
  "superclass": {
@@ -4043,7 +4686,7 @@
4043
4686
  "declarations": [
4044
4687
  {
4045
4688
  "kind": "class",
4046
- "description": "A button that opens an anchored menu of actions — essentially `form-select`\nminus \"current value\" semantics: a menu, not a select. Use for a set of\nmutually exclusive next-step actions (e.g. a failed task's Retry / Close /\nBacklog, or a table row's overflow actions).\n\nThree trigger presentations share one base: `text` (the default — a\nprimary-filled button with a label and a rotating chevron), `text-icon`\n(the same, with `icon` ahead of the label), and `icon` (a borderless,\nsquare, low-emphasis icon target in the style of `icon-button` — the\nclassic \"three-dot\"/overflow menu, where `label` becomes the accessible\nname rather than visible text).",
4689
+ "description": "A button that opens an anchored menu of actions — essentially `form-select`\nminus \"current value\" semantics: a menu, not a select. Use for a set of\nmutually exclusive next-step actions (e.g. a failed task's Retry / Close /\nBacklog, or a table row's overflow actions).\n\nThree trigger presentations share one base: `text` (the default — a\nprimary-filled button with a label and a rotating chevron), `text-icon`\n(the same, with `icon` ahead of the label), and `icon` (a borderless,\nsquare, low-emphasis icon target in the style of `icon-button` — the\nclassic \"three-dot\"/overflow menu, where `label` becomes the accessible\nname rather than visible text). Set `size=\"sm\"` for a compact trigger one\nstep below the default, matching `ui-button`'s `sm` size.",
4047
4690
  "name": "DropdownButton",
4048
4691
  "members": [
4049
4692
  {
@@ -4095,6 +4738,17 @@
4095
4738
  "default": "null",
4096
4739
  "description": "Icon template rendered by the `icon` and `text-icon` variants."
4097
4740
  },
4741
+ {
4742
+ "kind": "field",
4743
+ "name": "size",
4744
+ "type": {
4745
+ "text": "\"sm\" | \"md\""
4746
+ },
4747
+ "default": "\"md\"",
4748
+ "description": "Size — `sm` reduces the trigger's height/padding/font-size one step below the default.",
4749
+ "attribute": "size",
4750
+ "reflects": true
4751
+ },
4098
4752
  {
4099
4753
  "kind": "field",
4100
4754
  "name": "_open",
@@ -4241,6 +4895,15 @@
4241
4895
  "default": "\"text\"",
4242
4896
  "description": "Trigger presentation: label only, icon only, or icon + label.",
4243
4897
  "fieldName": "variant"
4898
+ },
4899
+ {
4900
+ "name": "size",
4901
+ "type": {
4902
+ "text": "\"sm\" | \"md\""
4903
+ },
4904
+ "default": "\"md\"",
4905
+ "description": "Size — `sm` reduces the trigger's height/padding/font-size one step below the default.",
4906
+ "fieldName": "size"
4244
4907
  }
4245
4908
  ],
4246
4909
  "superclass": {
@@ -6250,25 +6913,36 @@
6250
6913
  },
6251
6914
  {
6252
6915
  "kind": "function",
6253
- "name": "iconShieldExclamation",
6916
+ "name": "iconSparkles",
6254
6917
  "parameters": [
6255
6918
  {
6256
6919
  "name": "size",
6257
6920
  "default": "16"
6258
6921
  }
6259
6922
  ],
6260
- "description": "Security warnings, or at-risk/compromised states."
6923
+ "description": "A gradient-theme toggle, or to represent a decorative/enhanced visual style."
6261
6924
  },
6262
6925
  {
6263
6926
  "kind": "function",
6264
- "name": "iconArrowPath",
6927
+ "name": "iconShieldExclamation",
6265
6928
  "parameters": [
6266
6929
  {
6267
6930
  "name": "size",
6268
- "default": "12"
6931
+ "default": "16"
6269
6932
  }
6270
6933
  ],
6271
- "description": "Refresh actions, or an animated busy/loading spinner."
6934
+ "description": "Security warnings, or at-risk/compromised states."
6935
+ },
6936
+ {
6937
+ "kind": "function",
6938
+ "name": "iconArrowPath",
6939
+ "parameters": [
6940
+ {
6941
+ "name": "size",
6942
+ "default": "12"
6943
+ }
6944
+ ],
6945
+ "description": "Refresh actions, or an animated busy/loading spinner."
6272
6946
  },
6273
6947
  {
6274
6948
  "kind": "function",
@@ -6588,6 +7262,61 @@
6588
7262
  }
6589
7263
  ],
6590
7264
  "description": "Tools, maintenance, or build/configuration actions."
7265
+ },
7266
+ {
7267
+ "kind": "function",
7268
+ "name": "iconPlay",
7269
+ "parameters": [
7270
+ {
7271
+ "name": "size",
7272
+ "default": "18"
7273
+ }
7274
+ ],
7275
+ "description": "\"Play\" transport actions, e.g. audio-player/video-player's paused state."
7276
+ },
7277
+ {
7278
+ "kind": "function",
7279
+ "name": "iconPause",
7280
+ "parameters": [
7281
+ {
7282
+ "name": "size",
7283
+ "default": "18"
7284
+ }
7285
+ ],
7286
+ "description": "\"Pause\" transport actions, e.g. audio-player/video-player's playing state."
7287
+ },
7288
+ {
7289
+ "kind": "function",
7290
+ "name": "iconSpeakerWave",
7291
+ "parameters": [
7292
+ {
7293
+ "name": "size",
7294
+ "default": "18"
7295
+ }
7296
+ ],
7297
+ "description": "An unmuted volume control, e.g. audio-player/video-player's mute toggle."
7298
+ },
7299
+ {
7300
+ "kind": "function",
7301
+ "name": "iconSpeakerXMark",
7302
+ "parameters": [
7303
+ {
7304
+ "name": "size",
7305
+ "default": "18"
7306
+ }
7307
+ ],
7308
+ "description": "A muted volume state; pair with iconSpeakerWave for the unmuted state."
7309
+ },
7310
+ {
7311
+ "kind": "function",
7312
+ "name": "iconArrowsPointingIn",
7313
+ "parameters": [
7314
+ {
7315
+ "name": "size",
7316
+ "default": "16"
7317
+ }
7318
+ ],
7319
+ "description": "\"Exit fullscreen\" actions; pair with iconArrowsPointingOut for entering fullscreen."
6591
7320
  }
6592
7321
  ],
6593
7322
  "exports": [
@@ -6775,6 +7504,14 @@
6775
7504
  "module": "src/icons.ts"
6776
7505
  }
6777
7506
  },
7507
+ {
7508
+ "kind": "js",
7509
+ "name": "iconSparkles",
7510
+ "declaration": {
7511
+ "name": "iconSparkles",
7512
+ "module": "src/icons.ts"
7513
+ }
7514
+ },
6778
7515
  {
6779
7516
  "kind": "js",
6780
7517
  "name": "iconShieldExclamation",
@@ -7022,6 +7759,46 @@
7022
7759
  "name": "iconWrenchScrewdriver",
7023
7760
  "module": "src/icons.ts"
7024
7761
  }
7762
+ },
7763
+ {
7764
+ "kind": "js",
7765
+ "name": "iconPlay",
7766
+ "declaration": {
7767
+ "name": "iconPlay",
7768
+ "module": "src/icons.ts"
7769
+ }
7770
+ },
7771
+ {
7772
+ "kind": "js",
7773
+ "name": "iconPause",
7774
+ "declaration": {
7775
+ "name": "iconPause",
7776
+ "module": "src/icons.ts"
7777
+ }
7778
+ },
7779
+ {
7780
+ "kind": "js",
7781
+ "name": "iconSpeakerWave",
7782
+ "declaration": {
7783
+ "name": "iconSpeakerWave",
7784
+ "module": "src/icons.ts"
7785
+ }
7786
+ },
7787
+ {
7788
+ "kind": "js",
7789
+ "name": "iconSpeakerXMark",
7790
+ "declaration": {
7791
+ "name": "iconSpeakerXMark",
7792
+ "module": "src/icons.ts"
7793
+ }
7794
+ },
7795
+ {
7796
+ "kind": "js",
7797
+ "name": "iconArrowsPointingIn",
7798
+ "declaration": {
7799
+ "name": "iconArrowsPointingIn",
7800
+ "module": "src/icons.ts"
7801
+ }
7025
7802
  }
7026
7803
  ]
7027
7804
  },
@@ -7958,6 +8735,14 @@
7958
8735
  "module": "./utils/duration.js"
7959
8736
  }
7960
8737
  },
8738
+ {
8739
+ "kind": "js",
8740
+ "name": "formatClockDuration",
8741
+ "declaration": {
8742
+ "name": "formatClockDuration",
8743
+ "module": "./utils/duration.js"
8744
+ }
8745
+ },
7961
8746
  {
7962
8747
  "kind": "js",
7963
8748
  "name": "DurationFormat",
@@ -7966,6 +8751,30 @@
7966
8751
  "module": "./utils/duration.js"
7967
8752
  }
7968
8753
  },
8754
+ {
8755
+ "kind": "js",
8756
+ "name": "AudioPlayer",
8757
+ "declaration": {
8758
+ "name": "AudioPlayer",
8759
+ "module": "./audio-player.js"
8760
+ }
8761
+ },
8762
+ {
8763
+ "kind": "js",
8764
+ "name": "VideoPlayer",
8765
+ "declaration": {
8766
+ "name": "VideoPlayer",
8767
+ "module": "./video-player.js"
8768
+ }
8769
+ },
8770
+ {
8771
+ "kind": "js",
8772
+ "name": "CommentComposer",
8773
+ "declaration": {
8774
+ "name": "CommentComposer",
8775
+ "module": "./comment-composer.js"
8776
+ }
8777
+ },
7969
8778
  {
7970
8779
  "kind": "js",
7971
8780
  "name": "tokens",
@@ -11311,7 +12120,7 @@
11311
12120
  "declarations": [
11312
12121
  {
11313
12122
  "kind": "class",
11314
- "description": "Page title block for the top of a dashboard view: an optional breadcrumb\ntrail, the page heading, and a right-aligned cluster of page-level actions.\nIt only lays these out — the breadcrumb links and action buttons are entirely\nthe consumer's, so it stays framework- and router-agnostic.",
12123
+ "description": "Page title block for the top of a dashboard view: an optional breadcrumb\ntrail, the page heading with a right-aligned cluster of page-level actions\nbeside it, and an optional description of what the page is for underneath.\nThe actions sit in the title row rather than beside the whole block, so a\nlonger or wrapping description never moves them. It only lays these out —\nthe breadcrumb links and action buttons are entirely the consumer's, so it\nstays framework- and router-agnostic.",
11315
12124
  "name": "PageHeader",
11316
12125
  "slots": [
11317
12126
  {
@@ -11334,6 +12143,16 @@
11334
12143
  "description": "The page heading text.",
11335
12144
  "attribute": "heading"
11336
12145
  },
12146
+ {
12147
+ "kind": "field",
12148
+ "name": "description",
12149
+ "type": {
12150
+ "text": "string"
12151
+ },
12152
+ "default": "\"\"",
12153
+ "description": "Optional supporting line under the heading, explaining what the page does.",
12154
+ "attribute": "description"
12155
+ },
11337
12156
  {
11338
12157
  "kind": "field",
11339
12158
  "name": "_hasBreadcrumb",
@@ -11373,6 +12192,15 @@
11373
12192
  "default": "\"\"",
11374
12193
  "description": "The page heading text.",
11375
12194
  "fieldName": "heading"
12195
+ },
12196
+ {
12197
+ "name": "description",
12198
+ "type": {
12199
+ "text": "string"
12200
+ },
12201
+ "default": "\"\"",
12202
+ "description": "Optional supporting line under the heading, explaining what the page does.",
12203
+ "fieldName": "description"
11376
12204
  }
11377
12205
  ],
11378
12206
  "superclass": {
@@ -11408,7 +12236,7 @@
11408
12236
  "declarations": [
11409
12237
  {
11410
12238
  "kind": "class",
11411
- "description": "Minimal, controlled pager for list/table views: a previous/next control pair\naround a \"Page N of M\" status. It owns no data — the consumer sets\n`current-page` / `total-pages` and moves the page in response to the\n`page-change` event (typically alongside its own data fetch), exactly like\n`data-table` leaves the row data to the caller.\n\nPrevious is disabled on the first page and next on the last; neither fires an\nevent when there is nowhere to go.",
12239
+ "description": "Minimal, controlled pager for list/table views: a previous/next control pair\naround a \"Page N of M\" status. It owns no data — the consumer sets\n`current-page` / `total-pages` and moves the page in response to the\n`page-change` event (typically alongside its own data fetch), exactly like\n`data-table` leaves the row data to the caller.\n\nPrevious is disabled on the first page and next on the last; neither fires an\nevent when there is nowhere to go.\n\nThe prev/next buttons are treated as `ui-button`'s `secondary` variant:\nthey read the same shared `--ui-button-secondary-*`/`--ui-button-highlight`\ntokens (and `--ui-button-secondary-surface-muted` for hover, since — like\n`button-group`'s unchecked segments — they already paint\n`--ui-surface-muted` on hover by default), so a gradient theme applies\nconsistently here too.",
11412
12240
  "name": "PaginationNav",
11413
12241
  "members": [
11414
12242
  {
@@ -12734,7 +13562,7 @@
12734
13562
  "declarations": [
12735
13563
  {
12736
13564
  "kind": "class",
12737
- "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.",
13565
+ "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.",
12738
13566
  "name": "RadioCards",
12739
13567
  "members": [
12740
13568
  {
@@ -12849,7 +13677,7 @@
12849
13677
  "declarations": [
12850
13678
  {
12851
13679
  "kind": "class",
12852
- "description": "Single-select group of compact pill-shaped options — for many short,\nsame-shaped choices (a basemap style, a unit toggle). For a handful of\nchoices where a description matters, use `radio-cards` instead. Wraps\nnative radio inputs for keyboard/a11y and fires `change` rather than\nrelying on form submission.",
13680
+ "description": "Single-select group of compact pill-shaped options — for many short,\nsame-shaped choices (a basemap style, a unit toggle). For a handful of\nchoices where a description matters, use `radio-cards` instead. Wraps\nnative radio inputs for keyboard/a11y and fires `change` rather than\nrelying on form submission.\n\nThe selected pill'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.",
12853
13681
  "name": "RadioPills",
12854
13682
  "members": [
12855
13683
  {
@@ -13338,7 +14166,7 @@
13338
14166
  "declarations": [
13339
14167
  {
13340
14168
  "kind": "class",
13341
- "description": "Button that reveals hidden slotted content when clicked.",
14169
+ "description": "Button that reveals hidden slotted content when clicked. Set `size=\"sm\"`\nfor a compact button one step below the default, matching `ui-button`'s\n`sm` size.",
13342
14170
  "name": "RevealButton",
13343
14171
  "members": [
13344
14172
  {
@@ -13361,6 +14189,17 @@
13361
14189
  "description": "Disables revealing the slotted content.",
13362
14190
  "attribute": "disabled"
13363
14191
  },
14192
+ {
14193
+ "kind": "field",
14194
+ "name": "size",
14195
+ "type": {
14196
+ "text": "\"sm\" | \"md\""
14197
+ },
14198
+ "default": "\"md\"",
14199
+ "description": "Size — `sm` reduces the button's height/padding/font-size one step below the default.",
14200
+ "attribute": "size",
14201
+ "reflects": true
14202
+ },
13364
14203
  {
13365
14204
  "kind": "method",
13366
14205
  "name": "_reveal",
@@ -13385,6 +14224,15 @@
13385
14224
  "default": "false",
13386
14225
  "description": "Disables revealing the slotted content.",
13387
14226
  "fieldName": "disabled"
14227
+ },
14228
+ {
14229
+ "name": "size",
14230
+ "type": {
14231
+ "text": "\"sm\" | \"md\""
14232
+ },
14233
+ "default": "\"md\"",
14234
+ "description": "Size — `sm` reduces the button's height/padding/font-size one step below the default.",
14235
+ "fieldName": "size"
13388
14236
  }
13389
14237
  ],
13390
14238
  "superclass": {
@@ -15404,7 +16252,7 @@
15404
16252
  "type": {
15405
16253
  "text": "Record<string, string>"
15406
16254
  },
15407
- "default": "{ // Colors \"--ui-primary\": \"#4f46e5\", // indigo-600 \"--ui-primary-hover\": \"#4338ca\", // indigo-700 \"--ui-info\": \"#0ea5e9\", // sky-500 \"--ui-info-hover\": \"#0284c7\", // sky-600 \"--ui-danger\": \"#dc2626\", // red-600 \"--ui-danger-hover\": \"#b91c1c\", // red-700 \"--ui-success\": \"#16a34a\", // green-600 \"--ui-warning\": \"#d97706\", // amber-600 \"--ui-warning-hover\": \"#b45309\", // amber-700 \"--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\", }",
16255
+ "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 \"--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\", }",
15408
16256
  "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`)."
15409
16257
  },
15410
16258
  {
@@ -15416,6 +16264,15 @@
15416
16264
  "default": "{ \"--ui-primary\": \"#6366f1\", // indigo-500 \"--ui-primary-hover\": \"#818cf8\", // indigo-400 \"--ui-info\": \"#38bdf8\", // sky-400 \"--ui-info-hover\": \"#7dd3fc\", // sky-300 \"--ui-danger\": \"#ef4444\", // red-500 \"--ui-danger-hover\": \"#f87171\", // red-400 \"--ui-success\": \"#22c55e\", // green-500 \"--ui-warning\": \"#f59e0b\", // amber-500 \"--ui-warning-hover\": \"#fbbf24\", // amber-400 \"--ui-on-accent\": \"#ffffff\", \"--ui-text\": \"#f1f5f9\", // slate-100 \"--ui-text-muted\": \"#94a3b8\", // slate-400 \"--ui-border\": \"#334155\", // slate-700 \"--ui-surface\": \"#0f172a\", // slate-900 \"--ui-surface-muted\": \"#1e293b\", // slate-800 \"--ui-highlight\": \"#854d0e\", // amber-800 — transient \"just changed\" flash on dark \"--ui-tooltip\": \"#020617\", // slate-950 \"--ui-hover-overlay\": \"rgb(255 255 255 / 0.12)\", \"--ui-overlay\": \"rgb(2 6 23 / 0.6)\", // slate-950 / 60% \"--ui-focus-ring\": \"0 0 0 3px rgb(99 102 241 / 0.45)\", }",
15417
16265
  "description": "Dark-mode overrides for the same `--ui-*` custom properties, applied by\n`tokens.css` via `@media (prefers-color-scheme: dark)` and `[data-theme]`\n(see generate-tokens-css.mjs). Same Tailwind slate scale as the light\npalette, inverted, with primary/danger/success lightened one step (500\ninstead of 600) for sufficient contrast against dark surfaces. Shape/type\ntokens are theme-independent and not repeated here."
15418
16266
  },
16267
+ {
16268
+ "kind": "variable",
16269
+ "name": "gradientTokenValues",
16270
+ "type": {
16271
+ "text": "Record<string, string>"
16272
+ },
16273
+ "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 subtle (white -> slate-50) rather than a saturated hue, // matching its flat \"not the primary action\" role, with a slightly // stronger border (slate-300 instead of the flat slate-200) so its edge // still reads against the near-white gradient fill. \"--ui-button-secondary-background\": \"linear-gradient(180deg, #ffffff 0%, #f8fafc 100%)\", // white -> slate-50 \"--ui-button-secondary-background-hover\": \"linear-gradient(180deg, #f8fafc 0%, #f1f5f9 100%)\", // slate-50 -> 100 \"--ui-button-secondary-background-active\": \"linear-gradient(180deg, #f1f5f9 0%, #ffffff 100%)\", // reversed 100 -> white \"--ui-button-secondary-border\": \"#cbd5e1\", // slate-300 \"--ui-button-secondary-border-hover\": \"#94a3b8\", // slate-400 \"--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 }",
16274
+ "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). Every other token (`--ui-text`, `--ui-surface`, …)\nis left at its light-mode default — this theme is button-only by design.\nEach variant's gradient runs light-to-dark top-to-bottom (`180deg`)\nacross one Tailwind shade step lighter/darker than the flat token so it\nstill reads as \"the same color, glossy\" rather than a different hue;\n`-hover` shifts the whole pair one shade lighter, `-active` reverses the\ntwo stops for a pressed/\"indented\" look, and `-border` is a shade darker\nthan the gradient's dark stop for a defining edge."
16275
+ },
15419
16276
  {
15420
16277
  "kind": "variable",
15421
16278
  "name": "tokens",
@@ -15440,6 +16297,14 @@
15440
16297
  "module": "src/tokens.ts"
15441
16298
  }
15442
16299
  },
16300
+ {
16301
+ "kind": "js",
16302
+ "name": "gradientTokenValues",
16303
+ "declaration": {
16304
+ "name": "gradientTokenValues",
16305
+ "module": "src/tokens.ts"
16306
+ }
16307
+ },
15443
16308
  {
15444
16309
  "kind": "js",
15445
16310
  "name": "tokens",
@@ -15528,12 +16393,540 @@
15528
16393
  "text": "string"
15529
16394
  }
15530
16395
  }
15531
- ]
16396
+ ]
16397
+ },
16398
+ {
16399
+ "kind": "method",
16400
+ "name": "#activate",
16401
+ "privacy": "private",
16402
+ "return": {
16403
+ "type": {
16404
+ "text": "void"
16405
+ }
16406
+ },
16407
+ "parameters": [
16408
+ {
16409
+ "name": "node",
16410
+ "type": {
16411
+ "text": "TreeNode"
16412
+ }
16413
+ }
16414
+ ]
16415
+ },
16416
+ {
16417
+ "kind": "method",
16418
+ "name": "#onKeydown",
16419
+ "privacy": "private",
16420
+ "return": {
16421
+ "type": {
16422
+ "text": "void"
16423
+ }
16424
+ },
16425
+ "parameters": [
16426
+ {
16427
+ "name": "node",
16428
+ "type": {
16429
+ "text": "TreeNode"
16430
+ }
16431
+ },
16432
+ {
16433
+ "name": "e",
16434
+ "type": {
16435
+ "text": "KeyboardEvent"
16436
+ }
16437
+ }
16438
+ ]
16439
+ },
16440
+ {
16441
+ "kind": "method",
16442
+ "name": "#onRowClick",
16443
+ "privacy": "private",
16444
+ "return": {
16445
+ "type": {
16446
+ "text": "void"
16447
+ }
16448
+ },
16449
+ "parameters": [
16450
+ {
16451
+ "name": "node",
16452
+ "type": {
16453
+ "text": "TreeNode"
16454
+ }
16455
+ },
16456
+ {
16457
+ "name": "e",
16458
+ "type": {
16459
+ "text": "MouseEvent"
16460
+ }
16461
+ }
16462
+ ]
16463
+ },
16464
+ {
16465
+ "kind": "method",
16466
+ "name": "#isNestedInteractive",
16467
+ "privacy": "private",
16468
+ "return": {
16469
+ "type": {
16470
+ "text": "boolean"
16471
+ }
16472
+ },
16473
+ "parameters": [
16474
+ {
16475
+ "name": "path",
16476
+ "type": {
16477
+ "text": "EventTarget[]"
16478
+ }
16479
+ },
16480
+ {
16481
+ "name": "row",
16482
+ "type": {
16483
+ "text": "EventTarget | null"
16484
+ }
16485
+ }
16486
+ ]
16487
+ },
16488
+ {
16489
+ "kind": "method",
16490
+ "name": "#renderNode",
16491
+ "privacy": "private",
16492
+ "return": {
16493
+ "type": {
16494
+ "text": "TemplateResult"
16495
+ }
16496
+ },
16497
+ "parameters": [
16498
+ {
16499
+ "name": "node",
16500
+ "type": {
16501
+ "text": "TreeNode"
16502
+ }
16503
+ },
16504
+ {
16505
+ "name": "depth",
16506
+ "type": {
16507
+ "text": "number"
16508
+ }
16509
+ },
16510
+ {
16511
+ "name": "isLast",
16512
+ "type": {
16513
+ "text": "boolean"
16514
+ }
16515
+ },
16516
+ {
16517
+ "name": "ancestorHasNext",
16518
+ "type": {
16519
+ "text": "boolean[]"
16520
+ }
16521
+ }
16522
+ ]
16523
+ }
16524
+ ],
16525
+ "events": [
16526
+ {
16527
+ "name": "node-click",
16528
+ "type": {
16529
+ "text": "CustomEvent"
16530
+ },
16531
+ "description": "A leaf row was activated; detail is `{ id, data }`."
16532
+ }
16533
+ ],
16534
+ "attributes": [
16535
+ {
16536
+ "name": "default-expanded",
16537
+ "type": {
16538
+ "text": "boolean"
16539
+ },
16540
+ "default": "false",
16541
+ "description": "Start every folder expanded instead of the default all-collapsed.",
16542
+ "fieldName": "defaultExpanded"
16543
+ },
16544
+ {
16545
+ "name": "lines",
16546
+ "type": {
16547
+ "text": "boolean"
16548
+ },
16549
+ "default": "false",
16550
+ "description": "Draw classic file-tree connector guides (vertical ancestor lines plus a\nbranch elbow/tee per row) instead of indentation alone. Off by default.",
16551
+ "fieldName": "lines"
16552
+ }
16553
+ ],
16554
+ "superclass": {
16555
+ "name": "LitElement",
16556
+ "package": "lit"
16557
+ },
16558
+ "tagName": "tree-view",
16559
+ "customElement": true
16560
+ }
16561
+ ],
16562
+ "exports": [
16563
+ {
16564
+ "kind": "js",
16565
+ "name": "TreeView",
16566
+ "declaration": {
16567
+ "name": "TreeView",
16568
+ "module": "src/tree-view.ts"
16569
+ }
16570
+ },
16571
+ {
16572
+ "kind": "custom-element-definition",
16573
+ "name": "tree-view",
16574
+ "declaration": {
16575
+ "name": "TreeView",
16576
+ "module": "src/tree-view.ts"
16577
+ }
16578
+ }
16579
+ ]
16580
+ },
16581
+ {
16582
+ "kind": "javascript-module",
16583
+ "path": "src/ui-button.ts",
16584
+ "declarations": [
16585
+ {
16586
+ "kind": "class",
16587
+ "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.",
16588
+ "name": "UiButton",
16589
+ "slots": [
16590
+ {
16591
+ "description": "Optional leading icon (e.g. an inline SVG).",
16592
+ "name": "icon"
16593
+ },
16594
+ {
16595
+ "description": "Button label.",
16596
+ "name": ""
16597
+ }
16598
+ ],
16599
+ "members": [
16600
+ {
16601
+ "kind": "field",
16602
+ "name": "formAssociated",
16603
+ "type": {
16604
+ "text": "boolean"
16605
+ },
16606
+ "static": true,
16607
+ "default": "true"
16608
+ },
16609
+ {
16610
+ "kind": "field",
16611
+ "name": "#internals",
16612
+ "privacy": "private"
16613
+ },
16614
+ {
16615
+ "kind": "field",
16616
+ "name": "variant",
16617
+ "type": {
16618
+ "text": "ButtonVariant"
16619
+ },
16620
+ "default": "\"primary\"",
16621
+ "description": "Visual weight.",
16622
+ "attribute": "variant"
16623
+ },
16624
+ {
16625
+ "kind": "field",
16626
+ "name": "size",
16627
+ "type": {
16628
+ "text": "\"sm\" | \"md\""
16629
+ },
16630
+ "default": "\"md\"",
16631
+ "description": "Size — `sm` reduces height/padding/font-size one step below the default.",
16632
+ "attribute": "size"
16633
+ },
16634
+ {
16635
+ "kind": "field",
16636
+ "name": "href",
16637
+ "type": {
16638
+ "text": "string | null"
16639
+ },
16640
+ "default": "null",
16641
+ "description": "Renders an `<a href=\"...\">` instead of a `<button>` when set.",
16642
+ "attribute": "href"
16643
+ },
16644
+ {
16645
+ "kind": "field",
16646
+ "name": "type",
16647
+ "type": {
16648
+ "text": "\"button\" | \"submit\" | \"reset\""
16649
+ },
16650
+ "default": "\"button\"",
16651
+ "description": "Native button `type`. Ignored when `href` is set.",
16652
+ "attribute": "type"
16653
+ },
16654
+ {
16655
+ "kind": "field",
16656
+ "name": "disabled",
16657
+ "type": {
16658
+ "text": "boolean"
16659
+ },
16660
+ "default": "false",
16661
+ "description": "Disables the control and dims it.",
16662
+ "attribute": "disabled"
16663
+ },
16664
+ {
16665
+ "kind": "field",
16666
+ "name": "busy",
16667
+ "type": {
16668
+ "text": "boolean"
16669
+ },
16670
+ "default": "false",
16671
+ "description": "Shows a spinner in place of the icon slot and disables the control.",
16672
+ "attribute": "busy"
16673
+ },
16674
+ {
16675
+ "kind": "method",
16676
+ "name": "_onClick",
16677
+ "privacy": "private",
16678
+ "description": "Drives submit/reset on the ancestor form via ElementInternals, since a shadow-DOM button can't do it natively."
16679
+ },
16680
+ {
16681
+ "kind": "method",
16682
+ "name": "_onLinkClick",
16683
+ "privacy": "private",
16684
+ "parameters": [
16685
+ {
16686
+ "name": "e",
16687
+ "type": {
16688
+ "text": "MouseEvent"
16689
+ }
16690
+ }
16691
+ ],
16692
+ "description": "Suppresses navigation while a link-styled button is disabled or busy."
16693
+ }
16694
+ ],
16695
+ "attributes": [
16696
+ {
16697
+ "name": "variant",
16698
+ "type": {
16699
+ "text": "ButtonVariant"
16700
+ },
16701
+ "default": "\"primary\"",
16702
+ "description": "Visual weight.",
16703
+ "fieldName": "variant"
16704
+ },
16705
+ {
16706
+ "name": "size",
16707
+ "type": {
16708
+ "text": "\"sm\" | \"md\""
16709
+ },
16710
+ "default": "\"md\"",
16711
+ "description": "Size — `sm` reduces height/padding/font-size one step below the default.",
16712
+ "fieldName": "size"
16713
+ },
16714
+ {
16715
+ "name": "href",
16716
+ "type": {
16717
+ "text": "string | null"
16718
+ },
16719
+ "default": "null",
16720
+ "description": "Renders an `<a href=\"...\">` instead of a `<button>` when set.",
16721
+ "fieldName": "href"
16722
+ },
16723
+ {
16724
+ "name": "type",
16725
+ "type": {
16726
+ "text": "\"button\" | \"submit\" | \"reset\""
16727
+ },
16728
+ "default": "\"button\"",
16729
+ "description": "Native button `type`. Ignored when `href` is set.",
16730
+ "fieldName": "type"
16731
+ },
16732
+ {
16733
+ "name": "disabled",
16734
+ "type": {
16735
+ "text": "boolean"
16736
+ },
16737
+ "default": "false",
16738
+ "description": "Disables the control and dims it.",
16739
+ "fieldName": "disabled"
16740
+ },
16741
+ {
16742
+ "name": "busy",
16743
+ "type": {
16744
+ "text": "boolean"
16745
+ },
16746
+ "default": "false",
16747
+ "description": "Shows a spinner in place of the icon slot and disables the control.",
16748
+ "fieldName": "busy"
16749
+ }
16750
+ ],
16751
+ "superclass": {
16752
+ "name": "LitElement",
16753
+ "package": "lit"
16754
+ },
16755
+ "tagName": "ui-button",
16756
+ "customElement": true
16757
+ }
16758
+ ],
16759
+ "exports": [
16760
+ {
16761
+ "kind": "js",
16762
+ "name": "UiButton",
16763
+ "declaration": {
16764
+ "name": "UiButton",
16765
+ "module": "src/ui-button.ts"
16766
+ }
16767
+ },
16768
+ {
16769
+ "kind": "custom-element-definition",
16770
+ "name": "ui-button",
16771
+ "declaration": {
16772
+ "name": "UiButton",
16773
+ "module": "src/ui-button.ts"
16774
+ }
16775
+ }
16776
+ ]
16777
+ },
16778
+ {
16779
+ "kind": "javascript-module",
16780
+ "path": "src/ui-checkbox.ts",
16781
+ "declarations": [
16782
+ {
16783
+ "kind": "class",
16784
+ "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.",
16785
+ "name": "UiCheckbox",
16786
+ "members": [
16787
+ {
16788
+ "kind": "field",
16789
+ "name": "formAssociated",
16790
+ "type": {
16791
+ "text": "boolean"
16792
+ },
16793
+ "static": true,
16794
+ "default": "true"
16795
+ },
16796
+ {
16797
+ "kind": "field",
16798
+ "name": "checked",
16799
+ "type": {
16800
+ "text": "boolean"
16801
+ },
16802
+ "default": "false",
16803
+ "description": "Whether the box is checked.",
16804
+ "attribute": "checked"
16805
+ },
16806
+ {
16807
+ "kind": "field",
16808
+ "name": "indeterminate",
16809
+ "type": {
16810
+ "text": "boolean"
16811
+ },
16812
+ "default": "false",
16813
+ "description": "Visual \"partial selection\" state; cleared on the next user interaction.",
16814
+ "attribute": "indeterminate"
16815
+ },
16816
+ {
16817
+ "kind": "field",
16818
+ "name": "disabled",
16819
+ "type": {
16820
+ "text": "boolean"
16821
+ },
16822
+ "default": "false",
16823
+ "description": "Disables interaction; merged with an ancestor `<fieldset disabled>`.",
16824
+ "attribute": "disabled"
16825
+ },
16826
+ {
16827
+ "kind": "field",
16828
+ "name": "required",
16829
+ "type": {
16830
+ "text": "boolean"
16831
+ },
16832
+ "default": "false",
16833
+ "description": "Marks the control invalid via `ElementInternals` while unchecked.",
16834
+ "attribute": "required"
16835
+ },
16836
+ {
16837
+ "kind": "field",
16838
+ "name": "name",
16839
+ "type": {
16840
+ "text": "string"
16841
+ },
16842
+ "default": "\"\"",
16843
+ "description": "Form field name; submitted as `name=on` only while checked.",
16844
+ "attribute": "name"
16845
+ },
16846
+ {
16847
+ "kind": "field",
16848
+ "name": "label",
16849
+ "type": {
16850
+ "text": "string"
16851
+ },
16852
+ "default": "\"\"",
16853
+ "description": "Visible label text rendered next to the box.",
16854
+ "attribute": "label"
16855
+ },
16856
+ {
16857
+ "kind": "field",
16858
+ "name": "icon",
16859
+ "type": {
16860
+ "text": "TemplateResult | null"
16861
+ },
16862
+ "default": "null",
16863
+ "description": "Pre-rendered icon template displayed between the box and the label, e.g. `iconPencil(14)` from this package's icon set."
16864
+ },
16865
+ {
16866
+ "kind": "field",
16867
+ "name": "iconSize",
16868
+ "type": {
16869
+ "text": "number"
16870
+ },
16871
+ "default": "14",
16872
+ "description": "Square icon size in pixels — 14 (inline icon size) by default.",
16873
+ "attribute": "iconSize"
16874
+ },
16875
+ {
16876
+ "kind": "field",
16877
+ "name": "_formDisabled",
16878
+ "type": {
16879
+ "text": "boolean"
16880
+ },
16881
+ "privacy": "private",
16882
+ "default": "false"
16883
+ },
16884
+ {
16885
+ "kind": "field",
16886
+ "name": "#internals",
16887
+ "privacy": "private"
16888
+ },
16889
+ {
16890
+ "kind": "field",
16891
+ "name": "#defaultChecked",
16892
+ "privacy": "private",
16893
+ "type": {
16894
+ "text": "boolean"
16895
+ },
16896
+ "default": "false"
16897
+ },
16898
+ {
16899
+ "kind": "field",
16900
+ "name": "#inputEl",
16901
+ "privacy": "private",
16902
+ "type": {
16903
+ "text": "HTMLInputElement | null"
16904
+ },
16905
+ "default": "null"
16906
+ },
16907
+ {
16908
+ "kind": "field",
16909
+ "name": "#isDisabled",
16910
+ "privacy": "private",
16911
+ "type": {
16912
+ "text": "boolean"
16913
+ },
16914
+ "description": "Whether the host or an ancestor fieldset currently disables the control.",
16915
+ "readonly": true
16916
+ },
16917
+ {
16918
+ "kind": "method",
16919
+ "name": "formResetCallback",
16920
+ "return": {
16921
+ "type": {
16922
+ "text": "void"
16923
+ }
16924
+ },
16925
+ "description": "Restores the checked state captured at first render, per the form contract."
15532
16926
  },
15533
16927
  {
15534
16928
  "kind": "method",
15535
- "name": "#activate",
15536
- "privacy": "private",
16929
+ "name": "formDisabledCallback",
15537
16930
  "return": {
15538
16931
  "type": {
15539
16932
  "text": "void"
@@ -15541,17 +16934,17 @@
15541
16934
  },
15542
16935
  "parameters": [
15543
16936
  {
15544
- "name": "node",
16937
+ "name": "disabled",
15545
16938
  "type": {
15546
- "text": "TreeNode"
16939
+ "text": "boolean"
15547
16940
  }
15548
16941
  }
15549
- ]
16942
+ ],
16943
+ "description": "Mirrors an ancestor fieldset's disabled state."
15550
16944
  },
15551
16945
  {
15552
16946
  "kind": "method",
15553
- "name": "#onKeydown",
15554
- "privacy": "private",
16947
+ "name": "formStateRestoreCallback",
15555
16948
  "return": {
15556
16949
  "type": {
15557
16950
  "text": "void"
@@ -15559,457 +16952,381 @@
15559
16952
  },
15560
16953
  "parameters": [
15561
16954
  {
15562
- "name": "node",
15563
- "type": {
15564
- "text": "TreeNode"
15565
- }
15566
- },
15567
- {
15568
- "name": "e",
16955
+ "name": "state",
15569
16956
  "type": {
15570
- "text": "KeyboardEvent"
16957
+ "text": "string | File | FormData | null"
15571
16958
  }
15572
16959
  }
15573
- ]
16960
+ ],
16961
+ "description": "Restores the checked state from saved form state (bfcache/autofill)."
15574
16962
  },
15575
16963
  {
15576
16964
  "kind": "method",
15577
- "name": "#onRowClick",
16965
+ "name": "#syncFormValue",
15578
16966
  "privacy": "private",
15579
16967
  "return": {
15580
16968
  "type": {
15581
16969
  "text": "void"
15582
16970
  }
15583
- },
15584
- "parameters": [
15585
- {
15586
- "name": "node",
15587
- "type": {
15588
- "text": "TreeNode"
15589
- }
15590
- },
15591
- {
15592
- "name": "e",
15593
- "type": {
15594
- "text": "MouseEvent"
15595
- }
15596
- }
15597
- ]
16971
+ }
15598
16972
  },
15599
16973
  {
15600
16974
  "kind": "method",
15601
- "name": "#isNestedInteractive",
16975
+ "name": "#syncValidity",
15602
16976
  "privacy": "private",
15603
16977
  "return": {
15604
16978
  "type": {
15605
- "text": "boolean"
15606
- }
15607
- },
15608
- "parameters": [
15609
- {
15610
- "name": "path",
15611
- "type": {
15612
- "text": "EventTarget[]"
15613
- }
15614
- },
15615
- {
15616
- "name": "row",
15617
- "type": {
15618
- "text": "EventTarget | null"
15619
- }
16979
+ "text": "void"
15620
16980
  }
15621
- ]
16981
+ }
15622
16982
  },
15623
16983
  {
15624
16984
  "kind": "method",
15625
- "name": "#renderNode",
16985
+ "name": "#onChange",
15626
16986
  "privacy": "private",
15627
16987
  "return": {
15628
16988
  "type": {
15629
- "text": "TemplateResult"
16989
+ "text": "void"
15630
16990
  }
15631
16991
  },
15632
16992
  "parameters": [
15633
16993
  {
15634
- "name": "node",
15635
- "type": {
15636
- "text": "TreeNode"
15637
- }
15638
- },
15639
- {
15640
- "name": "depth",
15641
- "type": {
15642
- "text": "number"
15643
- }
15644
- },
15645
- {
15646
- "name": "isLast",
15647
- "type": {
15648
- "text": "boolean"
15649
- }
15650
- },
15651
- {
15652
- "name": "ancestorHasNext",
16994
+ "name": "e",
15653
16995
  "type": {
15654
- "text": "boolean[]"
16996
+ "text": "Event"
15655
16997
  }
15656
16998
  }
15657
16999
  ]
17000
+ },
17001
+ {
17002
+ "kind": "field",
17003
+ "name": "#onInputRef",
17004
+ "privacy": "private"
15658
17005
  }
15659
17006
  ],
15660
17007
  "events": [
15661
17008
  {
15662
- "name": "node-click",
17009
+ "name": "change",
15663
17010
  "type": {
15664
17011
  "text": "CustomEvent"
15665
17012
  },
15666
- "description": "A leaf row was activated; detail is `{ id, data }`."
17013
+ "description": "The checkbox was toggled by the user, in either direction; detail: `{ checked }`. Programmatic `checked` assignments do not fire it."
15667
17014
  }
15668
17015
  ],
15669
17016
  "attributes": [
15670
17017
  {
15671
- "name": "default-expanded",
17018
+ "name": "checked",
15672
17019
  "type": {
15673
17020
  "text": "boolean"
15674
17021
  },
15675
17022
  "default": "false",
15676
- "description": "Start every folder expanded instead of the default all-collapsed.",
15677
- "fieldName": "defaultExpanded"
17023
+ "description": "Whether the box is checked.",
17024
+ "fieldName": "checked"
15678
17025
  },
15679
17026
  {
15680
- "name": "lines",
17027
+ "name": "indeterminate",
15681
17028
  "type": {
15682
17029
  "text": "boolean"
15683
17030
  },
15684
17031
  "default": "false",
15685
- "description": "Draw classic file-tree connector guides (vertical ancestor lines plus a\nbranch elbow/tee per row) instead of indentation alone. Off by default.",
15686
- "fieldName": "lines"
17032
+ "description": "Visual \"partial selection\" state; cleared on the next user interaction.",
17033
+ "fieldName": "indeterminate"
17034
+ },
17035
+ {
17036
+ "name": "disabled",
17037
+ "type": {
17038
+ "text": "boolean"
17039
+ },
17040
+ "default": "false",
17041
+ "description": "Disables interaction; merged with an ancestor `<fieldset disabled>`.",
17042
+ "fieldName": "disabled"
17043
+ },
17044
+ {
17045
+ "name": "required",
17046
+ "type": {
17047
+ "text": "boolean"
17048
+ },
17049
+ "default": "false",
17050
+ "description": "Marks the control invalid via `ElementInternals` while unchecked.",
17051
+ "fieldName": "required"
17052
+ },
17053
+ {
17054
+ "name": "name",
17055
+ "type": {
17056
+ "text": "string"
17057
+ },
17058
+ "default": "\"\"",
17059
+ "description": "Form field name; submitted as `name=on` only while checked.",
17060
+ "fieldName": "name"
17061
+ },
17062
+ {
17063
+ "name": "label",
17064
+ "type": {
17065
+ "text": "string"
17066
+ },
17067
+ "default": "\"\"",
17068
+ "description": "Visible label text rendered next to the box.",
17069
+ "fieldName": "label"
17070
+ },
17071
+ {
17072
+ "name": "iconSize",
17073
+ "type": {
17074
+ "text": "number"
17075
+ },
17076
+ "default": "14",
17077
+ "description": "Square icon size in pixels — 14 (inline icon size) by default.",
17078
+ "fieldName": "iconSize"
15687
17079
  }
15688
17080
  ],
15689
17081
  "superclass": {
15690
17082
  "name": "LitElement",
15691
17083
  "package": "lit"
15692
17084
  },
15693
- "tagName": "tree-view",
17085
+ "tagName": "ui-checkbox",
15694
17086
  "customElement": true
15695
17087
  }
15696
17088
  ],
15697
17089
  "exports": [
15698
17090
  {
15699
17091
  "kind": "js",
15700
- "name": "TreeView",
17092
+ "name": "UiCheckbox",
15701
17093
  "declaration": {
15702
- "name": "TreeView",
15703
- "module": "src/tree-view.ts"
17094
+ "name": "UiCheckbox",
17095
+ "module": "src/ui-checkbox.ts"
15704
17096
  }
15705
17097
  },
15706
17098
  {
15707
17099
  "kind": "custom-element-definition",
15708
- "name": "tree-view",
17100
+ "name": "ui-checkbox",
15709
17101
  "declaration": {
15710
- "name": "TreeView",
15711
- "module": "src/tree-view.ts"
17102
+ "name": "UiCheckbox",
17103
+ "module": "src/ui-checkbox.ts"
15712
17104
  }
15713
17105
  }
15714
17106
  ]
15715
17107
  },
15716
17108
  {
15717
17109
  "kind": "javascript-module",
15718
- "path": "src/ui-button.ts",
17110
+ "path": "src/user-avatar.ts",
15719
17111
  "declarations": [
15720
17112
  {
15721
17113
  "kind": "class",
15722
- "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.",
15723
- "name": "UiButton",
15724
- "slots": [
15725
- {
15726
- "description": "Optional leading icon (e.g. an inline SVG).",
15727
- "name": "icon"
15728
- },
15729
- {
15730
- "description": "Button label.",
15731
- "name": ""
15732
- }
15733
- ],
17114
+ "description": "Circular avatar. Shows `src` when it loads successfully; falls back to the\nfirst letter of `name` (uppercased) if `src` is unset or fails to load\n(e.g. an expired OAuth profile-photo URL); falls back further to a generic\nperson icon if `name` is also unset. A broken image never leaves a blank\ncircle.",
17115
+ "name": "UserAvatar",
15734
17116
  "members": [
15735
17117
  {
15736
17118
  "kind": "field",
15737
- "name": "formAssociated",
15738
- "type": {
15739
- "text": "boolean"
15740
- },
15741
- "static": true,
15742
- "default": "true"
15743
- },
15744
- {
15745
- "kind": "field",
15746
- "name": "#internals",
15747
- "privacy": "private"
15748
- },
15749
- {
15750
- "kind": "field",
15751
- "name": "variant",
15752
- "type": {
15753
- "text": "ButtonVariant"
15754
- },
15755
- "default": "\"primary\"",
15756
- "description": "Visual weight.",
15757
- "attribute": "variant"
15758
- },
15759
- {
15760
- "kind": "field",
15761
- "name": "size",
15762
- "type": {
15763
- "text": "\"sm\" | \"md\""
15764
- },
15765
- "default": "\"md\"",
15766
- "description": "Size — `sm` reduces height/padding/font-size one step below the default.",
15767
- "attribute": "size"
15768
- },
15769
- {
15770
- "kind": "field",
15771
- "name": "href",
17119
+ "name": "src",
15772
17120
  "type": {
15773
17121
  "text": "string | null"
15774
17122
  },
15775
17123
  "default": "null",
15776
- "description": "Renders an `<a href=\"...\">` instead of a `<button>` when set.",
15777
- "attribute": "href"
17124
+ "description": "Image URL to show. Falls back to initials/icon if unset or it fails to load.",
17125
+ "attribute": "src"
15778
17126
  },
15779
17127
  {
15780
17128
  "kind": "field",
15781
- "name": "type",
17129
+ "name": "name",
15782
17130
  "type": {
15783
- "text": "\"button\" | \"submit\" | \"reset\""
17131
+ "text": "string | null"
15784
17132
  },
15785
- "default": "\"button\"",
15786
- "description": "Native button `type`. Ignored when `href` is set.",
15787
- "attribute": "type"
17133
+ "default": "null",
17134
+ "description": "Source string for the fallback initial (e.g. a display name or email) — first character, uppercased.",
17135
+ "attribute": "name"
15788
17136
  },
15789
17137
  {
15790
17138
  "kind": "field",
15791
- "name": "disabled",
17139
+ "name": "size",
15792
17140
  "type": {
15793
- "text": "boolean"
17141
+ "text": "string | number"
15794
17142
  },
15795
- "default": "false",
15796
- "description": "Disables the control and dims it.",
15797
- "attribute": "disabled"
17143
+ "default": "32",
17144
+ "description": "Diameter in CSS pixels, or a preset name (`xs`=18, `sm`=24, `md`=32, `lg`=48).",
17145
+ "attribute": "size"
15798
17146
  },
15799
17147
  {
15800
17148
  "kind": "field",
15801
- "name": "busy",
17149
+ "name": "_imgError",
15802
17150
  "type": {
15803
17151
  "text": "boolean"
15804
17152
  },
15805
- "default": "false",
15806
- "description": "Shows a spinner in place of the icon slot and disables the control.",
15807
- "attribute": "busy"
17153
+ "privacy": "private",
17154
+ "default": "false"
15808
17155
  },
15809
17156
  {
15810
- "kind": "method",
15811
- "name": "_onClick",
17157
+ "kind": "field",
17158
+ "name": "SIZE_PRESETS",
17159
+ "type": {
17160
+ "text": "Record<string, number>"
17161
+ },
15812
17162
  "privacy": "private",
15813
- "description": "Drives submit/reset on the ancestor form via ElementInternals, since a shadow-DOM button can't do it natively."
17163
+ "static": true,
17164
+ "readonly": true,
17165
+ "default": "{ xs: 18, sm: 24, md: 32, lg: 48, }"
15814
17166
  },
15815
17167
  {
15816
17168
  "kind": "method",
15817
- "name": "_onLinkClick",
17169
+ "name": "resolveSize",
15818
17170
  "privacy": "private",
15819
- "parameters": [
15820
- {
15821
- "name": "e",
15822
- "type": {
15823
- "text": "MouseEvent"
15824
- }
17171
+ "return": {
17172
+ "type": {
17173
+ "text": "number"
15825
17174
  }
15826
- ],
15827
- "description": "Suppresses navigation while a link-styled button is disabled or busy."
17175
+ },
17176
+ "description": "Resolves the `size` property (number or preset name) to a pixel diameter."
15828
17177
  }
15829
17178
  ],
15830
17179
  "attributes": [
15831
17180
  {
15832
- "name": "variant",
15833
- "type": {
15834
- "text": "ButtonVariant"
15835
- },
15836
- "default": "\"primary\"",
15837
- "description": "Visual weight.",
15838
- "fieldName": "variant"
15839
- },
15840
- {
15841
- "name": "size",
15842
- "type": {
15843
- "text": "\"sm\" | \"md\""
15844
- },
15845
- "default": "\"md\"",
15846
- "description": "Size — `sm` reduces height/padding/font-size one step below the default.",
15847
- "fieldName": "size"
15848
- },
15849
- {
15850
- "name": "href",
17181
+ "name": "src",
15851
17182
  "type": {
15852
17183
  "text": "string | null"
15853
17184
  },
15854
17185
  "default": "null",
15855
- "description": "Renders an `<a href=\"...\">` instead of a `<button>` when set.",
15856
- "fieldName": "href"
15857
- },
15858
- {
15859
- "name": "type",
15860
- "type": {
15861
- "text": "\"button\" | \"submit\" | \"reset\""
15862
- },
15863
- "default": "\"button\"",
15864
- "description": "Native button `type`. Ignored when `href` is set.",
15865
- "fieldName": "type"
17186
+ "description": "Image URL to show. Falls back to initials/icon if unset or it fails to load.",
17187
+ "fieldName": "src"
15866
17188
  },
15867
17189
  {
15868
- "name": "disabled",
17190
+ "name": "name",
15869
17191
  "type": {
15870
- "text": "boolean"
17192
+ "text": "string | null"
15871
17193
  },
15872
- "default": "false",
15873
- "description": "Disables the control and dims it.",
15874
- "fieldName": "disabled"
17194
+ "default": "null",
17195
+ "description": "Source string for the fallback initial (e.g. a display name or email) — first character, uppercased.",
17196
+ "fieldName": "name"
15875
17197
  },
15876
17198
  {
15877
- "name": "busy",
17199
+ "name": "size",
15878
17200
  "type": {
15879
- "text": "boolean"
17201
+ "text": "string | number"
15880
17202
  },
15881
- "default": "false",
15882
- "description": "Shows a spinner in place of the icon slot and disables the control.",
15883
- "fieldName": "busy"
17203
+ "default": "32",
17204
+ "description": "Diameter in CSS pixels, or a preset name (`xs`=18, `sm`=24, `md`=32, `lg`=48).",
17205
+ "fieldName": "size"
15884
17206
  }
15885
17207
  ],
15886
17208
  "superclass": {
15887
17209
  "name": "LitElement",
15888
17210
  "package": "lit"
15889
17211
  },
15890
- "tagName": "ui-button",
17212
+ "tagName": "user-avatar",
15891
17213
  "customElement": true
15892
17214
  }
15893
17215
  ],
15894
17216
  "exports": [
15895
17217
  {
15896
17218
  "kind": "js",
15897
- "name": "UiButton",
17219
+ "name": "UserAvatar",
15898
17220
  "declaration": {
15899
- "name": "UiButton",
15900
- "module": "src/ui-button.ts"
17221
+ "name": "UserAvatar",
17222
+ "module": "src/user-avatar.ts"
15901
17223
  }
15902
17224
  },
15903
17225
  {
15904
17226
  "kind": "custom-element-definition",
15905
- "name": "ui-button",
17227
+ "name": "user-avatar",
15906
17228
  "declaration": {
15907
- "name": "UiButton",
15908
- "module": "src/ui-button.ts"
17229
+ "name": "UserAvatar",
17230
+ "module": "src/user-avatar.ts"
15909
17231
  }
15910
17232
  }
15911
17233
  ]
15912
17234
  },
15913
17235
  {
15914
17236
  "kind": "javascript-module",
15915
- "path": "src/ui-checkbox.ts",
17237
+ "path": "src/video-player.ts",
15916
17238
  "declarations": [
15917
17239
  {
15918
17240
  "kind": "class",
15919
- "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.",
15920
- "name": "UiCheckbox",
17241
+ "description": "Video player wrapping a native `<video>` element (native `controls`\ndisabled) with the same tokenized transport bar as `audio-player` — a\nplay/pause `icon-button`, elapsed/total time, a seekable progress bar, a\nmute toggle + volume slider — plus a fullscreen toggle. The control bar\nsits in a persistent strip under the video frame rather than a\nhover-reveal overlay, so it stays usable for keyboard/touch input without\na pointer hover state.",
17242
+ "name": "VideoPlayer",
15921
17243
  "members": [
15922
17244
  {
15923
17245
  "kind": "field",
15924
- "name": "formAssociated",
17246
+ "name": "src",
15925
17247
  "type": {
15926
- "text": "boolean"
17248
+ "text": "string"
15927
17249
  },
15928
- "static": true,
15929
- "default": "true"
17250
+ "default": "\"\"",
17251
+ "description": "URL of the video file to play.",
17252
+ "attribute": "src"
15930
17253
  },
15931
17254
  {
15932
17255
  "kind": "field",
15933
- "name": "checked",
17256
+ "name": "poster",
15934
17257
  "type": {
15935
- "text": "boolean"
17258
+ "text": "string"
15936
17259
  },
15937
- "default": "false",
15938
- "description": "Whether the box is checked.",
15939
- "attribute": "checked"
17260
+ "default": "\"\"",
17261
+ "description": "Poster image shown before playback starts.",
17262
+ "attribute": "poster"
15940
17263
  },
15941
17264
  {
15942
17265
  "kind": "field",
15943
- "name": "indeterminate",
17266
+ "name": "label",
15944
17267
  "type": {
15945
- "text": "boolean"
17268
+ "text": "string"
15946
17269
  },
15947
- "default": "false",
15948
- "description": "Visual \"partial selection\" state; cleared on the next user interaction.",
15949
- "attribute": "indeterminate"
17270
+ "default": "\"Video player\"",
17271
+ "description": "Accessible name for the player, e.g. a video title.",
17272
+ "attribute": "label"
15950
17273
  },
15951
17274
  {
15952
17275
  "kind": "field",
15953
- "name": "disabled",
17276
+ "name": "loop",
15954
17277
  "type": {
15955
17278
  "text": "boolean"
15956
17279
  },
15957
17280
  "default": "false",
15958
- "description": "Disables interaction; merged with an ancestor `<fieldset disabled>`.",
15959
- "attribute": "disabled"
17281
+ "description": "Loops playback once it reaches the end.",
17282
+ "attribute": "loop"
15960
17283
  },
15961
17284
  {
15962
17285
  "kind": "field",
15963
- "name": "required",
17286
+ "name": "preload",
15964
17287
  "type": {
15965
- "text": "boolean"
17288
+ "text": "\"none\" | \"metadata\" | \"auto\""
15966
17289
  },
15967
- "default": "false",
15968
- "description": "Marks the control invalid via `ElementInternals` while unchecked.",
15969
- "attribute": "required"
17290
+ "default": "\"metadata\"",
17291
+ "description": "Native `<video preload>` hint.",
17292
+ "attribute": "preload"
15970
17293
  },
15971
17294
  {
15972
17295
  "kind": "field",
15973
- "name": "name",
17296
+ "name": "_playing",
15974
17297
  "type": {
15975
- "text": "string"
17298
+ "text": "boolean"
15976
17299
  },
15977
- "default": "\"\"",
15978
- "description": "Form field name; submitted as `name=on` only while checked.",
15979
- "attribute": "name"
17300
+ "privacy": "private",
17301
+ "default": "false"
15980
17302
  },
15981
17303
  {
15982
17304
  "kind": "field",
15983
- "name": "label",
17305
+ "name": "_currentTime",
15984
17306
  "type": {
15985
- "text": "string"
17307
+ "text": "number"
15986
17308
  },
15987
- "default": "\"\"",
15988
- "description": "Visible label text rendered next to the box.",
15989
- "attribute": "label"
17309
+ "privacy": "private",
17310
+ "default": "0"
15990
17311
  },
15991
17312
  {
15992
17313
  "kind": "field",
15993
- "name": "icon",
15994
- "type": {
15995
- "text": "TemplateResult | null"
15996
- },
15997
- "default": "null",
15998
- "description": "Pre-rendered icon template displayed between the box and the label, e.g. `iconPencil(14)` from this package's icon set."
17314
+ "name": "_duration",
17315
+ "privacy": "private",
17316
+ "default": "NaN"
15999
17317
  },
16000
17318
  {
16001
17319
  "kind": "field",
16002
- "name": "iconSize",
17320
+ "name": "_volume",
16003
17321
  "type": {
16004
17322
  "text": "number"
16005
17323
  },
16006
- "default": "14",
16007
- "description": "Square icon size in pixels — 14 (inline icon size) by default.",
16008
- "attribute": "iconSize"
17324
+ "privacy": "private",
17325
+ "default": "1"
16009
17326
  },
16010
17327
  {
16011
17328
  "kind": "field",
16012
- "name": "_formDisabled",
17329
+ "name": "_muted",
16013
17330
  "type": {
16014
17331
  "text": "boolean"
16015
17332
  },
@@ -16018,86 +17335,152 @@
16018
17335
  },
16019
17336
  {
16020
17337
  "kind": "field",
16021
- "name": "#internals",
16022
- "privacy": "private"
17338
+ "name": "_errored",
17339
+ "type": {
17340
+ "text": "boolean"
17341
+ },
17342
+ "privacy": "private",
17343
+ "default": "false"
16023
17344
  },
16024
17345
  {
16025
17346
  "kind": "field",
16026
- "name": "#defaultChecked",
16027
- "privacy": "private",
17347
+ "name": "_fullscreen",
16028
17348
  "type": {
16029
17349
  "text": "boolean"
16030
17350
  },
17351
+ "privacy": "private",
16031
17352
  "default": "false"
16032
17353
  },
16033
17354
  {
16034
17355
  "kind": "field",
16035
- "name": "#inputEl",
16036
- "privacy": "private",
17356
+ "name": "_video",
16037
17357
  "type": {
16038
- "text": "HTMLInputElement | null"
17358
+ "text": "HTMLVideoElement | undefined"
16039
17359
  },
16040
- "default": "null"
17360
+ "privacy": "private"
16041
17361
  },
16042
17362
  {
16043
17363
  "kind": "field",
16044
- "name": "#isDisabled",
16045
- "privacy": "private",
17364
+ "name": "_frame",
16046
17365
  "type": {
16047
- "text": "boolean"
17366
+ "text": "HTMLDivElement | undefined"
16048
17367
  },
16049
- "description": "Whether the host or an ancestor fieldset currently disables the control.",
16050
- "readonly": true
17368
+ "privacy": "private"
17369
+ },
17370
+ {
17371
+ "kind": "field",
17372
+ "name": "#onFullscreenChange",
17373
+ "privacy": "private"
16051
17374
  },
16052
17375
  {
16053
17376
  "kind": "method",
16054
- "name": "formResetCallback",
17377
+ "name": "_togglePlay",
17378
+ "privacy": "private",
17379
+ "return": {
17380
+ "type": {
17381
+ "text": "void"
17382
+ }
17383
+ }
17384
+ },
17385
+ {
17386
+ "kind": "method",
17387
+ "name": "_toggleMute",
17388
+ "privacy": "private",
17389
+ "return": {
17390
+ "type": {
17391
+ "text": "void"
17392
+ }
17393
+ }
17394
+ },
17395
+ {
17396
+ "kind": "method",
17397
+ "name": "_toggleFullscreen",
17398
+ "privacy": "private",
17399
+ "return": {
17400
+ "type": {
17401
+ "text": "void"
17402
+ }
17403
+ }
17404
+ },
17405
+ {
17406
+ "kind": "method",
17407
+ "name": "_onSeekInput",
17408
+ "privacy": "private",
16055
17409
  "return": {
16056
17410
  "type": {
16057
17411
  "text": "void"
16058
17412
  }
16059
17413
  },
16060
- "description": "Restores the checked state captured at first render, per the form contract."
17414
+ "parameters": [
17415
+ {
17416
+ "name": "e",
17417
+ "type": {
17418
+ "text": "Event"
17419
+ }
17420
+ }
17421
+ ]
16061
17422
  },
16062
17423
  {
16063
17424
  "kind": "method",
16064
- "name": "formDisabledCallback",
17425
+ "name": "_onVolumeInput",
17426
+ "privacy": "private",
17427
+ "return": {
17428
+ "type": {
17429
+ "text": "void"
17430
+ }
17431
+ },
17432
+ "parameters": [
17433
+ {
17434
+ "name": "e",
17435
+ "type": {
17436
+ "text": "Event"
17437
+ }
17438
+ }
17439
+ ]
17440
+ },
17441
+ {
17442
+ "kind": "method",
17443
+ "name": "_onLoadedMetadata",
17444
+ "privacy": "private",
17445
+ "return": {
17446
+ "type": {
17447
+ "text": "void"
17448
+ }
17449
+ }
17450
+ },
17451
+ {
17452
+ "kind": "method",
17453
+ "name": "_onTimeUpdate",
17454
+ "privacy": "private",
17455
+ "return": {
17456
+ "type": {
17457
+ "text": "void"
17458
+ }
17459
+ }
17460
+ },
17461
+ {
17462
+ "kind": "method",
17463
+ "name": "_onPlay",
17464
+ "privacy": "private",
16065
17465
  "return": {
16066
17466
  "type": {
16067
17467
  "text": "void"
16068
17468
  }
16069
- },
16070
- "parameters": [
16071
- {
16072
- "name": "disabled",
16073
- "type": {
16074
- "text": "boolean"
16075
- }
16076
- }
16077
- ],
16078
- "description": "Mirrors an ancestor fieldset's disabled state."
17469
+ }
16079
17470
  },
16080
17471
  {
16081
17472
  "kind": "method",
16082
- "name": "formStateRestoreCallback",
17473
+ "name": "_onPause",
17474
+ "privacy": "private",
16083
17475
  "return": {
16084
17476
  "type": {
16085
17477
  "text": "void"
16086
17478
  }
16087
- },
16088
- "parameters": [
16089
- {
16090
- "name": "state",
16091
- "type": {
16092
- "text": "string | File | FormData | null"
16093
- }
16094
- }
16095
- ],
16096
- "description": "Restores the checked state from saved form state (bfcache/autofill)."
17479
+ }
16097
17480
  },
16098
17481
  {
16099
17482
  "kind": "method",
16100
- "name": "#syncFormValue",
17483
+ "name": "_onEnded",
16101
17484
  "privacy": "private",
16102
17485
  "return": {
16103
17486
  "type": {
@@ -16107,7 +17490,7 @@
16107
17490
  },
16108
17491
  {
16109
17492
  "kind": "method",
16110
- "name": "#syncValidity",
17493
+ "name": "_onVolumeChange",
16111
17494
  "privacy": "private",
16112
17495
  "return": {
16113
17496
  "type": {
@@ -16117,252 +17500,108 @@
16117
17500
  },
16118
17501
  {
16119
17502
  "kind": "method",
16120
- "name": "#onChange",
17503
+ "name": "_onError",
16121
17504
  "privacy": "private",
16122
17505
  "return": {
16123
17506
  "type": {
16124
17507
  "text": "void"
16125
17508
  }
16126
- },
16127
- "parameters": [
16128
- {
16129
- "name": "e",
16130
- "type": {
16131
- "text": "Event"
16132
- }
16133
- }
16134
- ]
16135
- },
16136
- {
16137
- "kind": "field",
16138
- "name": "#onInputRef",
16139
- "privacy": "private"
17509
+ }
16140
17510
  }
16141
17511
  ],
16142
17512
  "events": [
16143
17513
  {
16144
- "name": "change",
17514
+ "name": "play",
16145
17515
  "type": {
16146
17516
  "text": "CustomEvent"
16147
17517
  },
16148
- "description": "The checkbox was toggled by the user, in either direction; detail: `{ checked }`. Programmatic `checked` assignments do not fire it."
16149
- }
16150
- ],
16151
- "attributes": [
16152
- {
16153
- "name": "checked",
16154
- "type": {
16155
- "text": "boolean"
16156
- },
16157
- "default": "false",
16158
- "description": "Whether the box is checked.",
16159
- "fieldName": "checked"
17518
+ "description": "The video started playing."
16160
17519
  },
16161
17520
  {
16162
- "name": "indeterminate",
17521
+ "name": "pause",
16163
17522
  "type": {
16164
- "text": "boolean"
17523
+ "text": "CustomEvent"
16165
17524
  },
16166
- "default": "false",
16167
- "description": "Visual \"partial selection\" state; cleared on the next user interaction.",
16168
- "fieldName": "indeterminate"
17525
+ "description": "The video was paused."
16169
17526
  },
16170
17527
  {
16171
- "name": "disabled",
17528
+ "name": "ended",
16172
17529
  "type": {
16173
- "text": "boolean"
17530
+ "text": "CustomEvent"
16174
17531
  },
16175
- "default": "false",
16176
- "description": "Disables interaction; merged with an ancestor `<fieldset disabled>`.",
16177
- "fieldName": "disabled"
16178
- },
17532
+ "description": "Playback reached the end."
17533
+ }
17534
+ ],
17535
+ "attributes": [
16179
17536
  {
16180
- "name": "required",
17537
+ "name": "src",
16181
17538
  "type": {
16182
- "text": "boolean"
17539
+ "text": "string"
16183
17540
  },
16184
- "default": "false",
16185
- "description": "Marks the control invalid via `ElementInternals` while unchecked.",
16186
- "fieldName": "required"
17541
+ "default": "\"\"",
17542
+ "description": "URL of the video file to play.",
17543
+ "fieldName": "src"
16187
17544
  },
16188
17545
  {
16189
- "name": "name",
17546
+ "name": "poster",
16190
17547
  "type": {
16191
17548
  "text": "string"
16192
17549
  },
16193
17550
  "default": "\"\"",
16194
- "description": "Form field name; submitted as `name=on` only while checked.",
16195
- "fieldName": "name"
17551
+ "description": "Poster image shown before playback starts.",
17552
+ "fieldName": "poster"
16196
17553
  },
16197
17554
  {
16198
17555
  "name": "label",
16199
17556
  "type": {
16200
17557
  "text": "string"
16201
17558
  },
16202
- "default": "\"\"",
16203
- "description": "Visible label text rendered next to the box.",
17559
+ "default": "\"Video player\"",
17560
+ "description": "Accessible name for the player, e.g. a video title.",
16204
17561
  "fieldName": "label"
16205
17562
  },
16206
17563
  {
16207
- "name": "iconSize",
16208
- "type": {
16209
- "text": "number"
16210
- },
16211
- "default": "14",
16212
- "description": "Square icon size in pixels — 14 (inline icon size) by default.",
16213
- "fieldName": "iconSize"
16214
- }
16215
- ],
16216
- "superclass": {
16217
- "name": "LitElement",
16218
- "package": "lit"
16219
- },
16220
- "tagName": "ui-checkbox",
16221
- "customElement": true
16222
- }
16223
- ],
16224
- "exports": [
16225
- {
16226
- "kind": "js",
16227
- "name": "UiCheckbox",
16228
- "declaration": {
16229
- "name": "UiCheckbox",
16230
- "module": "src/ui-checkbox.ts"
16231
- }
16232
- },
16233
- {
16234
- "kind": "custom-element-definition",
16235
- "name": "ui-checkbox",
16236
- "declaration": {
16237
- "name": "UiCheckbox",
16238
- "module": "src/ui-checkbox.ts"
16239
- }
16240
- }
16241
- ]
16242
- },
16243
- {
16244
- "kind": "javascript-module",
16245
- "path": "src/user-avatar.ts",
16246
- "declarations": [
16247
- {
16248
- "kind": "class",
16249
- "description": "Circular avatar. Shows `src` when it loads successfully; falls back to the\nfirst letter of `name` (uppercased) if `src` is unset or fails to load\n(e.g. an expired OAuth profile-photo URL); falls back further to a generic\nperson icon if `name` is also unset. A broken image never leaves a blank\ncircle.",
16250
- "name": "UserAvatar",
16251
- "members": [
16252
- {
16253
- "kind": "field",
16254
- "name": "src",
16255
- "type": {
16256
- "text": "string | null"
16257
- },
16258
- "default": "null",
16259
- "description": "Image URL to show. Falls back to initials/icon if unset or it fails to load.",
16260
- "attribute": "src"
16261
- },
16262
- {
16263
- "kind": "field",
16264
- "name": "name",
16265
- "type": {
16266
- "text": "string | null"
16267
- },
16268
- "default": "null",
16269
- "description": "Source string for the fallback initial (e.g. a display name or email) — first character, uppercased.",
16270
- "attribute": "name"
16271
- },
16272
- {
16273
- "kind": "field",
16274
- "name": "size",
16275
- "type": {
16276
- "text": "string | number"
16277
- },
16278
- "default": "32",
16279
- "description": "Diameter in CSS pixels, or a preset name (`xs`=18, `sm`=24, `md`=32, `lg`=48).",
16280
- "attribute": "size"
16281
- },
16282
- {
16283
- "kind": "field",
16284
- "name": "_imgError",
17564
+ "name": "loop",
16285
17565
  "type": {
16286
17566
  "text": "boolean"
16287
17567
  },
16288
- "privacy": "private",
16289
- "default": "false"
16290
- },
16291
- {
16292
- "kind": "field",
16293
- "name": "SIZE_PRESETS",
16294
- "type": {
16295
- "text": "Record<string, number>"
16296
- },
16297
- "privacy": "private",
16298
- "static": true,
16299
- "readonly": true,
16300
- "default": "{ xs: 18, sm: 24, md: 32, lg: 48, }"
16301
- },
16302
- {
16303
- "kind": "method",
16304
- "name": "resolveSize",
16305
- "privacy": "private",
16306
- "return": {
16307
- "type": {
16308
- "text": "number"
16309
- }
16310
- },
16311
- "description": "Resolves the `size` property (number or preset name) to a pixel diameter."
16312
- }
16313
- ],
16314
- "attributes": [
16315
- {
16316
- "name": "src",
16317
- "type": {
16318
- "text": "string | null"
16319
- },
16320
- "default": "null",
16321
- "description": "Image URL to show. Falls back to initials/icon if unset or it fails to load.",
16322
- "fieldName": "src"
16323
- },
16324
- {
16325
- "name": "name",
16326
- "type": {
16327
- "text": "string | null"
16328
- },
16329
- "default": "null",
16330
- "description": "Source string for the fallback initial (e.g. a display name or email) — first character, uppercased.",
16331
- "fieldName": "name"
17568
+ "default": "false",
17569
+ "description": "Loops playback once it reaches the end.",
17570
+ "fieldName": "loop"
16332
17571
  },
16333
17572
  {
16334
- "name": "size",
17573
+ "name": "preload",
16335
17574
  "type": {
16336
- "text": "string | number"
17575
+ "text": "\"none\" | \"metadata\" | \"auto\""
16337
17576
  },
16338
- "default": "32",
16339
- "description": "Diameter in CSS pixels, or a preset name (`xs`=18, `sm`=24, `md`=32, `lg`=48).",
16340
- "fieldName": "size"
17577
+ "default": "\"metadata\"",
17578
+ "description": "Native `<video preload>` hint.",
17579
+ "fieldName": "preload"
16341
17580
  }
16342
17581
  ],
16343
17582
  "superclass": {
16344
17583
  "name": "LitElement",
16345
17584
  "package": "lit"
16346
17585
  },
16347
- "tagName": "user-avatar",
17586
+ "tagName": "video-player",
16348
17587
  "customElement": true
16349
17588
  }
16350
17589
  ],
16351
17590
  "exports": [
16352
17591
  {
16353
17592
  "kind": "js",
16354
- "name": "UserAvatar",
17593
+ "name": "VideoPlayer",
16355
17594
  "declaration": {
16356
- "name": "UserAvatar",
16357
- "module": "src/user-avatar.ts"
17595
+ "name": "VideoPlayer",
17596
+ "module": "src/video-player.ts"
16358
17597
  }
16359
17598
  },
16360
17599
  {
16361
17600
  "kind": "custom-element-definition",
16362
- "name": "user-avatar",
17601
+ "name": "video-player",
16363
17602
  "declaration": {
16364
- "name": "UserAvatar",
16365
- "module": "src/user-avatar.ts"
17603
+ "name": "VideoPlayer",
17604
+ "module": "src/video-player.ts"
16366
17605
  }
16367
17606
  }
16368
17607
  ]
@@ -16840,6 +18079,24 @@
16840
18079
  }
16841
18080
  ],
16842
18081
  "description": "Formats a millisecond duration for display.\n\n`\"seconds\"` renders a whole-second count with a pluralized unit word (e.g.\n\"1 second\", \"12 seconds\"). `\"compact\"` renders the shortest sensible\n`Xh Ym Zs` form, dropping leading-zero units (`\"12s\"`, `\"3m 12s\"`,\n`\"1h 03m 12s\"`) — minutes/seconds are zero-padded only once a larger unit\nis present."
18082
+ },
18083
+ {
18084
+ "kind": "function",
18085
+ "name": "formatClockDuration",
18086
+ "return": {
18087
+ "type": {
18088
+ "text": "string"
18089
+ }
18090
+ },
18091
+ "parameters": [
18092
+ {
18093
+ "name": "totalSeconds",
18094
+ "type": {
18095
+ "text": "number"
18096
+ }
18097
+ }
18098
+ ],
18099
+ "description": "Formats a duration in seconds as a transport-bar clock label:\n`M:SS` (e.g. `\"3:45\"`), or `H:MM:SS` once an hour is reached (e.g.\n`\"1:02:03\"`). `NaN`/negative/non-finite input (e.g. a not-yet-loaded\nmedia duration) renders as `\"-:--\"` rather than `\"0:00\"`, so a player can\ndistinguish \"no reading yet\" from an actual zero-length duration."
16843
18100
  }
16844
18101
  ],
16845
18102
  "exports": [
@@ -16850,6 +18107,14 @@
16850
18107
  "name": "formatDuration",
16851
18108
  "module": "src/utils/duration.ts"
16852
18109
  }
18110
+ },
18111
+ {
18112
+ "kind": "js",
18113
+ "name": "formatClockDuration",
18114
+ "declaration": {
18115
+ "name": "formatClockDuration",
18116
+ "module": "src/utils/duration.ts"
18117
+ }
16853
18118
  }
16854
18119
  ]
16855
18120
  },
@@ -17270,6 +18535,28 @@
17270
18535
  }
17271
18536
  }
17272
18537
  ]
18538
+ },
18539
+ {
18540
+ "kind": "javascript-module",
18541
+ "path": "src/utils/transport-controls.ts",
18542
+ "declarations": [
18543
+ {
18544
+ "kind": "variable",
18545
+ "name": "transportRangeStyles",
18546
+ "default": "css` input[type=\"range\"] { -webkit-appearance: none; appearance: none; /* Width is intentionally left to the consumer (e.g. .seek/.volume in audio-player/video-player) — this element+attribute selector has higher specificity than a single class rule, so setting a width here would win over a component's own narrower class and silently stretch every range input (including a fixed-width volume slider) to 100%. */ height: 1rem; margin: 0; background: transparent; cursor: pointer; } input[type=\"range\"]:disabled { cursor: not-allowed; opacity: 0.6; } input[type=\"range\"]::-webkit-slider-runnable-track { height: 0.25rem; border-radius: 9999px; /* A hard-stop gradient two-tone fill trick — see range-slider.ts for why this reads --ui-button-accent rather than --ui-button-background. */ background: linear-gradient( to right, var(--ui-button-accent, var(--ui-primary, #4f46e5)) 0%, var(--ui-button-accent, var(--ui-primary, #4f46e5)) var(--range-percent, 0%), var(--ui-surface-muted, #f8fafc) var(--range-percent, 0%), var(--ui-surface-muted, #f8fafc) 100% ); } input[type=\"range\"]::-moz-range-track { height: 0.25rem; border-radius: 9999px; background: var(--ui-surface-muted, #f8fafc); } input[type=\"range\"]::-moz-range-progress { height: 0.25rem; border-radius: 9999px; background: var(--ui-button-accent, var(--ui-primary, #4f46e5)); } input[type=\"range\"]::-webkit-slider-thumb { -webkit-appearance: none; appearance: none; width: 0.75rem; height: 0.75rem; /* WebKit centers the thumb on the input's full 1rem box, not the thinner custom track — nudge it up to align, as in range-slider.ts. */ transform: translateY(-0.25rem); border-radius: 50%; background: var(--ui-button-background, var(--ui-primary, #4f46e5)); border: 2px solid var(--ui-surface, #ffffff); box-shadow: 0 1px 2px rgb(0 0 0 / 0.2), var(--ui-button-highlight, 0 0 0 0 transparent); } input[type=\"range\"]::-moz-range-thumb { width: 0.75rem; height: 0.75rem; border-radius: 50%; background: var(--ui-button-background, var(--ui-primary, #4f46e5)); border: 2px solid var(--ui-surface, #ffffff); box-shadow: 0 1px 2px rgb(0 0 0 / 0.2), var(--ui-button-highlight, 0 0 0 0 transparent); } input[type=\"range\"]:disabled::-webkit-slider-thumb { background: var(--ui-text-muted, #64748b); } input[type=\"range\"]:disabled::-moz-range-thumb { background: var(--ui-text-muted, #64748b); } input[type=\"range\"]:focus-visible { outline: none; } input[type=\"range\"]:focus-visible::-webkit-slider-thumb { box-shadow: var(--ui-focus-ring, 0 0 0 3px rgb(79 70 229 / 0.35)); } input[type=\"range\"]:focus-visible::-moz-range-thumb { box-shadow: var(--ui-focus-ring, 0 0 0 3px rgb(79 70 229 / 0.35)); } @media (prefers-reduced-motion: no-preference) { input[type=\"range\"]::-webkit-slider-thumb { transition: box-shadow 120ms ease; } input[type=\"range\"]::-moz-range-thumb { transition: box-shadow 120ms ease; } } @media (forced-colors: active) { input[type=\"range\"]::-webkit-slider-runnable-track { background: Canvas; border: 1px solid CanvasText; } input[type=\"range\"]::-webkit-slider-thumb { background: Highlight; border-color: Canvas; } input[type=\"range\"]:focus-visible::-webkit-slider-thumb { outline: 2px solid CanvasText; outline-offset: 2px; box-shadow: none; } } `",
18547
+ "description": "Shared `<input type=\"range\">` track/thumb styling for media transport\ncontrols (the seek bar and volume slider in `audio-player`/`video-player`).\nReuses `range-slider.ts`'s track/fill visual language (a filled portion up\nto `--range-percent`) so both players get free native keyboard/pointer\nseeking instead of a custom-built draggable control, matching the \"native\nsemantics before custom ARIA\" rule. Extracted here rather than duplicated\nbecause both components need the identical rule set."
18548
+ }
18549
+ ],
18550
+ "exports": [
18551
+ {
18552
+ "kind": "js",
18553
+ "name": "transportRangeStyles",
18554
+ "declaration": {
18555
+ "name": "transportRangeStyles",
18556
+ "module": "src/utils/transport-controls.ts"
18557
+ }
18558
+ }
18559
+ ]
17273
18560
  }
17274
18561
  ]
17275
18562
  }