@f-ewald/components 1.23.1 → 1.24.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 (95) hide show
  1. package/README.md +3 -0
  2. package/custom-elements.json +1847 -596
  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 +10 -0
  30. package/dist/icons.d.ts.map +1 -1
  31. package/dist/icons.js +10 -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 +17 -0
  61. package/dist/tokens.d.ts.map +1 -1
  62. package/dist/tokens.js +56 -0
  63. package/dist/tokens.js.map +1 -1
  64. package/dist/ui-button.d.ts +16 -0
  65. package/dist/ui-button.d.ts.map +1 -1
  66. package/dist/ui-button.js +48 -7
  67. package/dist/ui-button.js.map +1 -1
  68. package/dist/utils/duration.d.ts +8 -0
  69. package/dist/utils/duration.d.ts.map +1 -1
  70. package/dist/utils/duration.js +18 -0
  71. package/dist/utils/duration.js.map +1 -1
  72. package/dist/utils/transport-controls.d.ts +11 -0
  73. package/dist/utils/transport-controls.d.ts.map +1 -0
  74. package/dist/utils/transport-controls.js +113 -0
  75. package/dist/utils/transport-controls.js.map +1 -0
  76. package/dist/video-player.d.ts +60 -0
  77. package/dist/video-player.d.ts.map +1 -0
  78. package/dist/video-player.js +324 -0
  79. package/dist/video-player.js.map +1 -0
  80. package/docs/audio-player.md +60 -0
  81. package/docs/button-group.md +18 -1
  82. package/docs/comment-composer.md +68 -0
  83. package/docs/confirm-dialog.md +19 -1
  84. package/docs/dropdown-button.md +10 -1
  85. package/docs/icons.md +5 -0
  86. package/docs/page-header.md +11 -4
  87. package/docs/pagination-nav.md +14 -0
  88. package/docs/radio-cards.md +9 -0
  89. package/docs/radio-pills.md +9 -0
  90. package/docs/range-slider.md +3 -0
  91. package/docs/reveal-button.md +11 -1
  92. package/docs/ui-button.md +32 -0
  93. package/docs/video-player.md +59 -0
  94. package/llms.txt +162 -23
  95. 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": {
@@ -6588,13 +7251,68 @@
6588
7251
  }
6589
7252
  ],
6590
7253
  "description": "Tools, maintenance, or build/configuration actions."
6591
- }
6592
- ],
6593
- "exports": [
7254
+ },
6594
7255
  {
6595
- "kind": "js",
6596
- "name": "iconX",
6597
- "declaration": {
7256
+ "kind": "function",
7257
+ "name": "iconPlay",
7258
+ "parameters": [
7259
+ {
7260
+ "name": "size",
7261
+ "default": "18"
7262
+ }
7263
+ ],
7264
+ "description": "\"Play\" transport actions, e.g. audio-player/video-player's paused state."
7265
+ },
7266
+ {
7267
+ "kind": "function",
7268
+ "name": "iconPause",
7269
+ "parameters": [
7270
+ {
7271
+ "name": "size",
7272
+ "default": "18"
7273
+ }
7274
+ ],
7275
+ "description": "\"Pause\" transport actions, e.g. audio-player/video-player's playing state."
7276
+ },
7277
+ {
7278
+ "kind": "function",
7279
+ "name": "iconSpeakerWave",
7280
+ "parameters": [
7281
+ {
7282
+ "name": "size",
7283
+ "default": "18"
7284
+ }
7285
+ ],
7286
+ "description": "An unmuted volume control, e.g. audio-player/video-player's mute toggle."
7287
+ },
7288
+ {
7289
+ "kind": "function",
7290
+ "name": "iconSpeakerXMark",
7291
+ "parameters": [
7292
+ {
7293
+ "name": "size",
7294
+ "default": "18"
7295
+ }
7296
+ ],
7297
+ "description": "A muted volume state; pair with iconSpeakerWave for the unmuted state."
7298
+ },
7299
+ {
7300
+ "kind": "function",
7301
+ "name": "iconArrowsPointingIn",
7302
+ "parameters": [
7303
+ {
7304
+ "name": "size",
7305
+ "default": "16"
7306
+ }
7307
+ ],
7308
+ "description": "\"Exit fullscreen\" actions; pair with iconArrowsPointingOut for entering fullscreen."
7309
+ }
7310
+ ],
7311
+ "exports": [
7312
+ {
7313
+ "kind": "js",
7314
+ "name": "iconX",
7315
+ "declaration": {
6598
7316
  "name": "iconX",
6599
7317
  "module": "src/icons.ts"
6600
7318
  }
@@ -7022,6 +7740,46 @@
7022
7740
  "name": "iconWrenchScrewdriver",
7023
7741
  "module": "src/icons.ts"
7024
7742
  }
7743
+ },
7744
+ {
7745
+ "kind": "js",
7746
+ "name": "iconPlay",
7747
+ "declaration": {
7748
+ "name": "iconPlay",
7749
+ "module": "src/icons.ts"
7750
+ }
7751
+ },
7752
+ {
7753
+ "kind": "js",
7754
+ "name": "iconPause",
7755
+ "declaration": {
7756
+ "name": "iconPause",
7757
+ "module": "src/icons.ts"
7758
+ }
7759
+ },
7760
+ {
7761
+ "kind": "js",
7762
+ "name": "iconSpeakerWave",
7763
+ "declaration": {
7764
+ "name": "iconSpeakerWave",
7765
+ "module": "src/icons.ts"
7766
+ }
7767
+ },
7768
+ {
7769
+ "kind": "js",
7770
+ "name": "iconSpeakerXMark",
7771
+ "declaration": {
7772
+ "name": "iconSpeakerXMark",
7773
+ "module": "src/icons.ts"
7774
+ }
7775
+ },
7776
+ {
7777
+ "kind": "js",
7778
+ "name": "iconArrowsPointingIn",
7779
+ "declaration": {
7780
+ "name": "iconArrowsPointingIn",
7781
+ "module": "src/icons.ts"
7782
+ }
7025
7783
  }
7026
7784
  ]
7027
7785
  },
@@ -7958,6 +8716,14 @@
7958
8716
  "module": "./utils/duration.js"
7959
8717
  }
7960
8718
  },
8719
+ {
8720
+ "kind": "js",
8721
+ "name": "formatClockDuration",
8722
+ "declaration": {
8723
+ "name": "formatClockDuration",
8724
+ "module": "./utils/duration.js"
8725
+ }
8726
+ },
7961
8727
  {
7962
8728
  "kind": "js",
7963
8729
  "name": "DurationFormat",
@@ -7966,6 +8732,30 @@
7966
8732
  "module": "./utils/duration.js"
7967
8733
  }
7968
8734
  },
8735
+ {
8736
+ "kind": "js",
8737
+ "name": "AudioPlayer",
8738
+ "declaration": {
8739
+ "name": "AudioPlayer",
8740
+ "module": "./audio-player.js"
8741
+ }
8742
+ },
8743
+ {
8744
+ "kind": "js",
8745
+ "name": "VideoPlayer",
8746
+ "declaration": {
8747
+ "name": "VideoPlayer",
8748
+ "module": "./video-player.js"
8749
+ }
8750
+ },
8751
+ {
8752
+ "kind": "js",
8753
+ "name": "CommentComposer",
8754
+ "declaration": {
8755
+ "name": "CommentComposer",
8756
+ "module": "./comment-composer.js"
8757
+ }
8758
+ },
7969
8759
  {
7970
8760
  "kind": "js",
7971
8761
  "name": "tokens",
@@ -11311,7 +12101,7 @@
11311
12101
  "declarations": [
11312
12102
  {
11313
12103
  "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.",
12104
+ "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
12105
  "name": "PageHeader",
11316
12106
  "slots": [
11317
12107
  {
@@ -11334,6 +12124,16 @@
11334
12124
  "description": "The page heading text.",
11335
12125
  "attribute": "heading"
11336
12126
  },
12127
+ {
12128
+ "kind": "field",
12129
+ "name": "description",
12130
+ "type": {
12131
+ "text": "string"
12132
+ },
12133
+ "default": "\"\"",
12134
+ "description": "Optional supporting line under the heading, explaining what the page does.",
12135
+ "attribute": "description"
12136
+ },
11337
12137
  {
11338
12138
  "kind": "field",
11339
12139
  "name": "_hasBreadcrumb",
@@ -11373,6 +12173,15 @@
11373
12173
  "default": "\"\"",
11374
12174
  "description": "The page heading text.",
11375
12175
  "fieldName": "heading"
12176
+ },
12177
+ {
12178
+ "name": "description",
12179
+ "type": {
12180
+ "text": "string"
12181
+ },
12182
+ "default": "\"\"",
12183
+ "description": "Optional supporting line under the heading, explaining what the page does.",
12184
+ "fieldName": "description"
11376
12185
  }
11377
12186
  ],
11378
12187
  "superclass": {
@@ -11408,7 +12217,7 @@
11408
12217
  "declarations": [
11409
12218
  {
11410
12219
  "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.",
12220
+ "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
12221
  "name": "PaginationNav",
11413
12222
  "members": [
11414
12223
  {
@@ -12734,7 +13543,7 @@
12734
13543
  "declarations": [
12735
13544
  {
12736
13545
  "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.",
13546
+ "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
13547
  "name": "RadioCards",
12739
13548
  "members": [
12740
13549
  {
@@ -12849,7 +13658,7 @@
12849
13658
  "declarations": [
12850
13659
  {
12851
13660
  "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.",
13661
+ "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
13662
  "name": "RadioPills",
12854
13663
  "members": [
12855
13664
  {
@@ -13338,7 +14147,7 @@
13338
14147
  "declarations": [
13339
14148
  {
13340
14149
  "kind": "class",
13341
- "description": "Button that reveals hidden slotted content when clicked.",
14150
+ "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
14151
  "name": "RevealButton",
13343
14152
  "members": [
13344
14153
  {
@@ -13361,6 +14170,17 @@
13361
14170
  "description": "Disables revealing the slotted content.",
13362
14171
  "attribute": "disabled"
13363
14172
  },
14173
+ {
14174
+ "kind": "field",
14175
+ "name": "size",
14176
+ "type": {
14177
+ "text": "\"sm\" | \"md\""
14178
+ },
14179
+ "default": "\"md\"",
14180
+ "description": "Size — `sm` reduces the button's height/padding/font-size one step below the default.",
14181
+ "attribute": "size",
14182
+ "reflects": true
14183
+ },
13364
14184
  {
13365
14185
  "kind": "method",
13366
14186
  "name": "_reveal",
@@ -13385,6 +14205,15 @@
13385
14205
  "default": "false",
13386
14206
  "description": "Disables revealing the slotted content.",
13387
14207
  "fieldName": "disabled"
14208
+ },
14209
+ {
14210
+ "name": "size",
14211
+ "type": {
14212
+ "text": "\"sm\" | \"md\""
14213
+ },
14214
+ "default": "\"md\"",
14215
+ "description": "Size — `sm` reduces the button's height/padding/font-size one step below the default.",
14216
+ "fieldName": "size"
13388
14217
  }
13389
14218
  ],
13390
14219
  "superclass": {
@@ -15404,7 +16233,7 @@
15404
16233
  "type": {
15405
16234
  "text": "Record<string, string>"
15406
16235
  },
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\", }",
16236
+ "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
16237
  "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
16238
  },
15410
16239
  {
@@ -15528,12 +16357,540 @@
15528
16357
  "text": "string"
15529
16358
  }
15530
16359
  }
15531
- ]
16360
+ ]
16361
+ },
16362
+ {
16363
+ "kind": "method",
16364
+ "name": "#activate",
16365
+ "privacy": "private",
16366
+ "return": {
16367
+ "type": {
16368
+ "text": "void"
16369
+ }
16370
+ },
16371
+ "parameters": [
16372
+ {
16373
+ "name": "node",
16374
+ "type": {
16375
+ "text": "TreeNode"
16376
+ }
16377
+ }
16378
+ ]
16379
+ },
16380
+ {
16381
+ "kind": "method",
16382
+ "name": "#onKeydown",
16383
+ "privacy": "private",
16384
+ "return": {
16385
+ "type": {
16386
+ "text": "void"
16387
+ }
16388
+ },
16389
+ "parameters": [
16390
+ {
16391
+ "name": "node",
16392
+ "type": {
16393
+ "text": "TreeNode"
16394
+ }
16395
+ },
16396
+ {
16397
+ "name": "e",
16398
+ "type": {
16399
+ "text": "KeyboardEvent"
16400
+ }
16401
+ }
16402
+ ]
16403
+ },
16404
+ {
16405
+ "kind": "method",
16406
+ "name": "#onRowClick",
16407
+ "privacy": "private",
16408
+ "return": {
16409
+ "type": {
16410
+ "text": "void"
16411
+ }
16412
+ },
16413
+ "parameters": [
16414
+ {
16415
+ "name": "node",
16416
+ "type": {
16417
+ "text": "TreeNode"
16418
+ }
16419
+ },
16420
+ {
16421
+ "name": "e",
16422
+ "type": {
16423
+ "text": "MouseEvent"
16424
+ }
16425
+ }
16426
+ ]
16427
+ },
16428
+ {
16429
+ "kind": "method",
16430
+ "name": "#isNestedInteractive",
16431
+ "privacy": "private",
16432
+ "return": {
16433
+ "type": {
16434
+ "text": "boolean"
16435
+ }
16436
+ },
16437
+ "parameters": [
16438
+ {
16439
+ "name": "path",
16440
+ "type": {
16441
+ "text": "EventTarget[]"
16442
+ }
16443
+ },
16444
+ {
16445
+ "name": "row",
16446
+ "type": {
16447
+ "text": "EventTarget | null"
16448
+ }
16449
+ }
16450
+ ]
16451
+ },
16452
+ {
16453
+ "kind": "method",
16454
+ "name": "#renderNode",
16455
+ "privacy": "private",
16456
+ "return": {
16457
+ "type": {
16458
+ "text": "TemplateResult"
16459
+ }
16460
+ },
16461
+ "parameters": [
16462
+ {
16463
+ "name": "node",
16464
+ "type": {
16465
+ "text": "TreeNode"
16466
+ }
16467
+ },
16468
+ {
16469
+ "name": "depth",
16470
+ "type": {
16471
+ "text": "number"
16472
+ }
16473
+ },
16474
+ {
16475
+ "name": "isLast",
16476
+ "type": {
16477
+ "text": "boolean"
16478
+ }
16479
+ },
16480
+ {
16481
+ "name": "ancestorHasNext",
16482
+ "type": {
16483
+ "text": "boolean[]"
16484
+ }
16485
+ }
16486
+ ]
16487
+ }
16488
+ ],
16489
+ "events": [
16490
+ {
16491
+ "name": "node-click",
16492
+ "type": {
16493
+ "text": "CustomEvent"
16494
+ },
16495
+ "description": "A leaf row was activated; detail is `{ id, data }`."
16496
+ }
16497
+ ],
16498
+ "attributes": [
16499
+ {
16500
+ "name": "default-expanded",
16501
+ "type": {
16502
+ "text": "boolean"
16503
+ },
16504
+ "default": "false",
16505
+ "description": "Start every folder expanded instead of the default all-collapsed.",
16506
+ "fieldName": "defaultExpanded"
16507
+ },
16508
+ {
16509
+ "name": "lines",
16510
+ "type": {
16511
+ "text": "boolean"
16512
+ },
16513
+ "default": "false",
16514
+ "description": "Draw classic file-tree connector guides (vertical ancestor lines plus a\nbranch elbow/tee per row) instead of indentation alone. Off by default.",
16515
+ "fieldName": "lines"
16516
+ }
16517
+ ],
16518
+ "superclass": {
16519
+ "name": "LitElement",
16520
+ "package": "lit"
16521
+ },
16522
+ "tagName": "tree-view",
16523
+ "customElement": true
16524
+ }
16525
+ ],
16526
+ "exports": [
16527
+ {
16528
+ "kind": "js",
16529
+ "name": "TreeView",
16530
+ "declaration": {
16531
+ "name": "TreeView",
16532
+ "module": "src/tree-view.ts"
16533
+ }
16534
+ },
16535
+ {
16536
+ "kind": "custom-element-definition",
16537
+ "name": "tree-view",
16538
+ "declaration": {
16539
+ "name": "TreeView",
16540
+ "module": "src/tree-view.ts"
16541
+ }
16542
+ }
16543
+ ]
16544
+ },
16545
+ {
16546
+ "kind": "javascript-module",
16547
+ "path": "src/ui-button.ts",
16548
+ "declarations": [
16549
+ {
16550
+ "kind": "class",
16551
+ "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,\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.",
16552
+ "name": "UiButton",
16553
+ "slots": [
16554
+ {
16555
+ "description": "Optional leading icon (e.g. an inline SVG).",
16556
+ "name": "icon"
16557
+ },
16558
+ {
16559
+ "description": "Button label.",
16560
+ "name": ""
16561
+ }
16562
+ ],
16563
+ "members": [
16564
+ {
16565
+ "kind": "field",
16566
+ "name": "formAssociated",
16567
+ "type": {
16568
+ "text": "boolean"
16569
+ },
16570
+ "static": true,
16571
+ "default": "true"
16572
+ },
16573
+ {
16574
+ "kind": "field",
16575
+ "name": "#internals",
16576
+ "privacy": "private"
16577
+ },
16578
+ {
16579
+ "kind": "field",
16580
+ "name": "variant",
16581
+ "type": {
16582
+ "text": "ButtonVariant"
16583
+ },
16584
+ "default": "\"primary\"",
16585
+ "description": "Visual weight.",
16586
+ "attribute": "variant"
16587
+ },
16588
+ {
16589
+ "kind": "field",
16590
+ "name": "size",
16591
+ "type": {
16592
+ "text": "\"sm\" | \"md\""
16593
+ },
16594
+ "default": "\"md\"",
16595
+ "description": "Size — `sm` reduces height/padding/font-size one step below the default.",
16596
+ "attribute": "size"
16597
+ },
16598
+ {
16599
+ "kind": "field",
16600
+ "name": "href",
16601
+ "type": {
16602
+ "text": "string | null"
16603
+ },
16604
+ "default": "null",
16605
+ "description": "Renders an `<a href=\"...\">` instead of a `<button>` when set.",
16606
+ "attribute": "href"
16607
+ },
16608
+ {
16609
+ "kind": "field",
16610
+ "name": "type",
16611
+ "type": {
16612
+ "text": "\"button\" | \"submit\" | \"reset\""
16613
+ },
16614
+ "default": "\"button\"",
16615
+ "description": "Native button `type`. Ignored when `href` is set.",
16616
+ "attribute": "type"
16617
+ },
16618
+ {
16619
+ "kind": "field",
16620
+ "name": "disabled",
16621
+ "type": {
16622
+ "text": "boolean"
16623
+ },
16624
+ "default": "false",
16625
+ "description": "Disables the control and dims it.",
16626
+ "attribute": "disabled"
16627
+ },
16628
+ {
16629
+ "kind": "field",
16630
+ "name": "busy",
16631
+ "type": {
16632
+ "text": "boolean"
16633
+ },
16634
+ "default": "false",
16635
+ "description": "Shows a spinner in place of the icon slot and disables the control.",
16636
+ "attribute": "busy"
16637
+ },
16638
+ {
16639
+ "kind": "method",
16640
+ "name": "_onClick",
16641
+ "privacy": "private",
16642
+ "description": "Drives submit/reset on the ancestor form via ElementInternals, since a shadow-DOM button can't do it natively."
16643
+ },
16644
+ {
16645
+ "kind": "method",
16646
+ "name": "_onLinkClick",
16647
+ "privacy": "private",
16648
+ "parameters": [
16649
+ {
16650
+ "name": "e",
16651
+ "type": {
16652
+ "text": "MouseEvent"
16653
+ }
16654
+ }
16655
+ ],
16656
+ "description": "Suppresses navigation while a link-styled button is disabled or busy."
16657
+ }
16658
+ ],
16659
+ "attributes": [
16660
+ {
16661
+ "name": "variant",
16662
+ "type": {
16663
+ "text": "ButtonVariant"
16664
+ },
16665
+ "default": "\"primary\"",
16666
+ "description": "Visual weight.",
16667
+ "fieldName": "variant"
16668
+ },
16669
+ {
16670
+ "name": "size",
16671
+ "type": {
16672
+ "text": "\"sm\" | \"md\""
16673
+ },
16674
+ "default": "\"md\"",
16675
+ "description": "Size — `sm` reduces height/padding/font-size one step below the default.",
16676
+ "fieldName": "size"
16677
+ },
16678
+ {
16679
+ "name": "href",
16680
+ "type": {
16681
+ "text": "string | null"
16682
+ },
16683
+ "default": "null",
16684
+ "description": "Renders an `<a href=\"...\">` instead of a `<button>` when set.",
16685
+ "fieldName": "href"
16686
+ },
16687
+ {
16688
+ "name": "type",
16689
+ "type": {
16690
+ "text": "\"button\" | \"submit\" | \"reset\""
16691
+ },
16692
+ "default": "\"button\"",
16693
+ "description": "Native button `type`. Ignored when `href` is set.",
16694
+ "fieldName": "type"
16695
+ },
16696
+ {
16697
+ "name": "disabled",
16698
+ "type": {
16699
+ "text": "boolean"
16700
+ },
16701
+ "default": "false",
16702
+ "description": "Disables the control and dims it.",
16703
+ "fieldName": "disabled"
16704
+ },
16705
+ {
16706
+ "name": "busy",
16707
+ "type": {
16708
+ "text": "boolean"
16709
+ },
16710
+ "default": "false",
16711
+ "description": "Shows a spinner in place of the icon slot and disables the control.",
16712
+ "fieldName": "busy"
16713
+ }
16714
+ ],
16715
+ "superclass": {
16716
+ "name": "LitElement",
16717
+ "package": "lit"
16718
+ },
16719
+ "tagName": "ui-button",
16720
+ "customElement": true
16721
+ }
16722
+ ],
16723
+ "exports": [
16724
+ {
16725
+ "kind": "js",
16726
+ "name": "UiButton",
16727
+ "declaration": {
16728
+ "name": "UiButton",
16729
+ "module": "src/ui-button.ts"
16730
+ }
16731
+ },
16732
+ {
16733
+ "kind": "custom-element-definition",
16734
+ "name": "ui-button",
16735
+ "declaration": {
16736
+ "name": "UiButton",
16737
+ "module": "src/ui-button.ts"
16738
+ }
16739
+ }
16740
+ ]
16741
+ },
16742
+ {
16743
+ "kind": "javascript-module",
16744
+ "path": "src/ui-checkbox.ts",
16745
+ "declarations": [
16746
+ {
16747
+ "kind": "class",
16748
+ "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.",
16749
+ "name": "UiCheckbox",
16750
+ "members": [
16751
+ {
16752
+ "kind": "field",
16753
+ "name": "formAssociated",
16754
+ "type": {
16755
+ "text": "boolean"
16756
+ },
16757
+ "static": true,
16758
+ "default": "true"
16759
+ },
16760
+ {
16761
+ "kind": "field",
16762
+ "name": "checked",
16763
+ "type": {
16764
+ "text": "boolean"
16765
+ },
16766
+ "default": "false",
16767
+ "description": "Whether the box is checked.",
16768
+ "attribute": "checked"
16769
+ },
16770
+ {
16771
+ "kind": "field",
16772
+ "name": "indeterminate",
16773
+ "type": {
16774
+ "text": "boolean"
16775
+ },
16776
+ "default": "false",
16777
+ "description": "Visual \"partial selection\" state; cleared on the next user interaction.",
16778
+ "attribute": "indeterminate"
16779
+ },
16780
+ {
16781
+ "kind": "field",
16782
+ "name": "disabled",
16783
+ "type": {
16784
+ "text": "boolean"
16785
+ },
16786
+ "default": "false",
16787
+ "description": "Disables interaction; merged with an ancestor `<fieldset disabled>`.",
16788
+ "attribute": "disabled"
16789
+ },
16790
+ {
16791
+ "kind": "field",
16792
+ "name": "required",
16793
+ "type": {
16794
+ "text": "boolean"
16795
+ },
16796
+ "default": "false",
16797
+ "description": "Marks the control invalid via `ElementInternals` while unchecked.",
16798
+ "attribute": "required"
16799
+ },
16800
+ {
16801
+ "kind": "field",
16802
+ "name": "name",
16803
+ "type": {
16804
+ "text": "string"
16805
+ },
16806
+ "default": "\"\"",
16807
+ "description": "Form field name; submitted as `name=on` only while checked.",
16808
+ "attribute": "name"
16809
+ },
16810
+ {
16811
+ "kind": "field",
16812
+ "name": "label",
16813
+ "type": {
16814
+ "text": "string"
16815
+ },
16816
+ "default": "\"\"",
16817
+ "description": "Visible label text rendered next to the box.",
16818
+ "attribute": "label"
16819
+ },
16820
+ {
16821
+ "kind": "field",
16822
+ "name": "icon",
16823
+ "type": {
16824
+ "text": "TemplateResult | null"
16825
+ },
16826
+ "default": "null",
16827
+ "description": "Pre-rendered icon template displayed between the box and the label, e.g. `iconPencil(14)` from this package's icon set."
16828
+ },
16829
+ {
16830
+ "kind": "field",
16831
+ "name": "iconSize",
16832
+ "type": {
16833
+ "text": "number"
16834
+ },
16835
+ "default": "14",
16836
+ "description": "Square icon size in pixels — 14 (inline icon size) by default.",
16837
+ "attribute": "iconSize"
16838
+ },
16839
+ {
16840
+ "kind": "field",
16841
+ "name": "_formDisabled",
16842
+ "type": {
16843
+ "text": "boolean"
16844
+ },
16845
+ "privacy": "private",
16846
+ "default": "false"
16847
+ },
16848
+ {
16849
+ "kind": "field",
16850
+ "name": "#internals",
16851
+ "privacy": "private"
16852
+ },
16853
+ {
16854
+ "kind": "field",
16855
+ "name": "#defaultChecked",
16856
+ "privacy": "private",
16857
+ "type": {
16858
+ "text": "boolean"
16859
+ },
16860
+ "default": "false"
16861
+ },
16862
+ {
16863
+ "kind": "field",
16864
+ "name": "#inputEl",
16865
+ "privacy": "private",
16866
+ "type": {
16867
+ "text": "HTMLInputElement | null"
16868
+ },
16869
+ "default": "null"
16870
+ },
16871
+ {
16872
+ "kind": "field",
16873
+ "name": "#isDisabled",
16874
+ "privacy": "private",
16875
+ "type": {
16876
+ "text": "boolean"
16877
+ },
16878
+ "description": "Whether the host or an ancestor fieldset currently disables the control.",
16879
+ "readonly": true
16880
+ },
16881
+ {
16882
+ "kind": "method",
16883
+ "name": "formResetCallback",
16884
+ "return": {
16885
+ "type": {
16886
+ "text": "void"
16887
+ }
16888
+ },
16889
+ "description": "Restores the checked state captured at first render, per the form contract."
15532
16890
  },
15533
16891
  {
15534
16892
  "kind": "method",
15535
- "name": "#activate",
15536
- "privacy": "private",
16893
+ "name": "formDisabledCallback",
15537
16894
  "return": {
15538
16895
  "type": {
15539
16896
  "text": "void"
@@ -15541,17 +16898,17 @@
15541
16898
  },
15542
16899
  "parameters": [
15543
16900
  {
15544
- "name": "node",
16901
+ "name": "disabled",
15545
16902
  "type": {
15546
- "text": "TreeNode"
16903
+ "text": "boolean"
15547
16904
  }
15548
16905
  }
15549
- ]
16906
+ ],
16907
+ "description": "Mirrors an ancestor fieldset's disabled state."
15550
16908
  },
15551
16909
  {
15552
16910
  "kind": "method",
15553
- "name": "#onKeydown",
15554
- "privacy": "private",
16911
+ "name": "formStateRestoreCallback",
15555
16912
  "return": {
15556
16913
  "type": {
15557
16914
  "text": "void"
@@ -15559,457 +16916,381 @@
15559
16916
  },
15560
16917
  "parameters": [
15561
16918
  {
15562
- "name": "node",
15563
- "type": {
15564
- "text": "TreeNode"
15565
- }
15566
- },
15567
- {
15568
- "name": "e",
16919
+ "name": "state",
15569
16920
  "type": {
15570
- "text": "KeyboardEvent"
16921
+ "text": "string | File | FormData | null"
15571
16922
  }
15572
16923
  }
15573
- ]
16924
+ ],
16925
+ "description": "Restores the checked state from saved form state (bfcache/autofill)."
15574
16926
  },
15575
16927
  {
15576
16928
  "kind": "method",
15577
- "name": "#onRowClick",
16929
+ "name": "#syncFormValue",
15578
16930
  "privacy": "private",
15579
16931
  "return": {
15580
16932
  "type": {
15581
16933
  "text": "void"
15582
16934
  }
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
- ]
16935
+ }
15598
16936
  },
15599
16937
  {
15600
16938
  "kind": "method",
15601
- "name": "#isNestedInteractive",
16939
+ "name": "#syncValidity",
15602
16940
  "privacy": "private",
15603
16941
  "return": {
15604
16942
  "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
- }
16943
+ "text": "void"
15620
16944
  }
15621
- ]
16945
+ }
15622
16946
  },
15623
16947
  {
15624
16948
  "kind": "method",
15625
- "name": "#renderNode",
16949
+ "name": "#onChange",
15626
16950
  "privacy": "private",
15627
16951
  "return": {
15628
16952
  "type": {
15629
- "text": "TemplateResult"
16953
+ "text": "void"
15630
16954
  }
15631
16955
  },
15632
16956
  "parameters": [
15633
16957
  {
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",
16958
+ "name": "e",
15653
16959
  "type": {
15654
- "text": "boolean[]"
16960
+ "text": "Event"
15655
16961
  }
15656
16962
  }
15657
16963
  ]
16964
+ },
16965
+ {
16966
+ "kind": "field",
16967
+ "name": "#onInputRef",
16968
+ "privacy": "private"
15658
16969
  }
15659
16970
  ],
15660
16971
  "events": [
15661
16972
  {
15662
- "name": "node-click",
16973
+ "name": "change",
15663
16974
  "type": {
15664
16975
  "text": "CustomEvent"
15665
16976
  },
15666
- "description": "A leaf row was activated; detail is `{ id, data }`."
16977
+ "description": "The checkbox was toggled by the user, in either direction; detail: `{ checked }`. Programmatic `checked` assignments do not fire it."
15667
16978
  }
15668
16979
  ],
15669
16980
  "attributes": [
15670
16981
  {
15671
- "name": "default-expanded",
16982
+ "name": "checked",
15672
16983
  "type": {
15673
16984
  "text": "boolean"
15674
16985
  },
15675
16986
  "default": "false",
15676
- "description": "Start every folder expanded instead of the default all-collapsed.",
15677
- "fieldName": "defaultExpanded"
16987
+ "description": "Whether the box is checked.",
16988
+ "fieldName": "checked"
15678
16989
  },
15679
16990
  {
15680
- "name": "lines",
16991
+ "name": "indeterminate",
15681
16992
  "type": {
15682
16993
  "text": "boolean"
15683
16994
  },
15684
16995
  "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"
16996
+ "description": "Visual \"partial selection\" state; cleared on the next user interaction.",
16997
+ "fieldName": "indeterminate"
16998
+ },
16999
+ {
17000
+ "name": "disabled",
17001
+ "type": {
17002
+ "text": "boolean"
17003
+ },
17004
+ "default": "false",
17005
+ "description": "Disables interaction; merged with an ancestor `<fieldset disabled>`.",
17006
+ "fieldName": "disabled"
17007
+ },
17008
+ {
17009
+ "name": "required",
17010
+ "type": {
17011
+ "text": "boolean"
17012
+ },
17013
+ "default": "false",
17014
+ "description": "Marks the control invalid via `ElementInternals` while unchecked.",
17015
+ "fieldName": "required"
17016
+ },
17017
+ {
17018
+ "name": "name",
17019
+ "type": {
17020
+ "text": "string"
17021
+ },
17022
+ "default": "\"\"",
17023
+ "description": "Form field name; submitted as `name=on` only while checked.",
17024
+ "fieldName": "name"
17025
+ },
17026
+ {
17027
+ "name": "label",
17028
+ "type": {
17029
+ "text": "string"
17030
+ },
17031
+ "default": "\"\"",
17032
+ "description": "Visible label text rendered next to the box.",
17033
+ "fieldName": "label"
17034
+ },
17035
+ {
17036
+ "name": "iconSize",
17037
+ "type": {
17038
+ "text": "number"
17039
+ },
17040
+ "default": "14",
17041
+ "description": "Square icon size in pixels — 14 (inline icon size) by default.",
17042
+ "fieldName": "iconSize"
15687
17043
  }
15688
17044
  ],
15689
17045
  "superclass": {
15690
17046
  "name": "LitElement",
15691
17047
  "package": "lit"
15692
17048
  },
15693
- "tagName": "tree-view",
17049
+ "tagName": "ui-checkbox",
15694
17050
  "customElement": true
15695
17051
  }
15696
17052
  ],
15697
17053
  "exports": [
15698
17054
  {
15699
17055
  "kind": "js",
15700
- "name": "TreeView",
17056
+ "name": "UiCheckbox",
15701
17057
  "declaration": {
15702
- "name": "TreeView",
15703
- "module": "src/tree-view.ts"
17058
+ "name": "UiCheckbox",
17059
+ "module": "src/ui-checkbox.ts"
15704
17060
  }
15705
17061
  },
15706
17062
  {
15707
17063
  "kind": "custom-element-definition",
15708
- "name": "tree-view",
17064
+ "name": "ui-checkbox",
15709
17065
  "declaration": {
15710
- "name": "TreeView",
15711
- "module": "src/tree-view.ts"
17066
+ "name": "UiCheckbox",
17067
+ "module": "src/ui-checkbox.ts"
15712
17068
  }
15713
17069
  }
15714
17070
  ]
15715
17071
  },
15716
17072
  {
15717
17073
  "kind": "javascript-module",
15718
- "path": "src/ui-button.ts",
17074
+ "path": "src/user-avatar.ts",
15719
17075
  "declarations": [
15720
17076
  {
15721
17077
  "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
- ],
17078
+ "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.",
17079
+ "name": "UserAvatar",
15734
17080
  "members": [
15735
17081
  {
15736
17082
  "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",
17083
+ "name": "src",
15772
17084
  "type": {
15773
17085
  "text": "string | null"
15774
17086
  },
15775
17087
  "default": "null",
15776
- "description": "Renders an `<a href=\"...\">` instead of a `<button>` when set.",
15777
- "attribute": "href"
17088
+ "description": "Image URL to show. Falls back to initials/icon if unset or it fails to load.",
17089
+ "attribute": "src"
15778
17090
  },
15779
17091
  {
15780
17092
  "kind": "field",
15781
- "name": "type",
17093
+ "name": "name",
15782
17094
  "type": {
15783
- "text": "\"button\" | \"submit\" | \"reset\""
17095
+ "text": "string | null"
15784
17096
  },
15785
- "default": "\"button\"",
15786
- "description": "Native button `type`. Ignored when `href` is set.",
15787
- "attribute": "type"
17097
+ "default": "null",
17098
+ "description": "Source string for the fallback initial (e.g. a display name or email) — first character, uppercased.",
17099
+ "attribute": "name"
15788
17100
  },
15789
17101
  {
15790
17102
  "kind": "field",
15791
- "name": "disabled",
17103
+ "name": "size",
15792
17104
  "type": {
15793
- "text": "boolean"
17105
+ "text": "string | number"
15794
17106
  },
15795
- "default": "false",
15796
- "description": "Disables the control and dims it.",
15797
- "attribute": "disabled"
17107
+ "default": "32",
17108
+ "description": "Diameter in CSS pixels, or a preset name (`xs`=18, `sm`=24, `md`=32, `lg`=48).",
17109
+ "attribute": "size"
15798
17110
  },
15799
17111
  {
15800
17112
  "kind": "field",
15801
- "name": "busy",
17113
+ "name": "_imgError",
15802
17114
  "type": {
15803
17115
  "text": "boolean"
15804
17116
  },
15805
- "default": "false",
15806
- "description": "Shows a spinner in place of the icon slot and disables the control.",
15807
- "attribute": "busy"
17117
+ "privacy": "private",
17118
+ "default": "false"
15808
17119
  },
15809
17120
  {
15810
- "kind": "method",
15811
- "name": "_onClick",
17121
+ "kind": "field",
17122
+ "name": "SIZE_PRESETS",
17123
+ "type": {
17124
+ "text": "Record<string, number>"
17125
+ },
15812
17126
  "privacy": "private",
15813
- "description": "Drives submit/reset on the ancestor form via ElementInternals, since a shadow-DOM button can't do it natively."
17127
+ "static": true,
17128
+ "readonly": true,
17129
+ "default": "{ xs: 18, sm: 24, md: 32, lg: 48, }"
15814
17130
  },
15815
17131
  {
15816
17132
  "kind": "method",
15817
- "name": "_onLinkClick",
17133
+ "name": "resolveSize",
15818
17134
  "privacy": "private",
15819
- "parameters": [
15820
- {
15821
- "name": "e",
15822
- "type": {
15823
- "text": "MouseEvent"
15824
- }
17135
+ "return": {
17136
+ "type": {
17137
+ "text": "number"
15825
17138
  }
15826
- ],
15827
- "description": "Suppresses navigation while a link-styled button is disabled or busy."
17139
+ },
17140
+ "description": "Resolves the `size` property (number or preset name) to a pixel diameter."
15828
17141
  }
15829
17142
  ],
15830
17143
  "attributes": [
15831
17144
  {
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",
17145
+ "name": "src",
15851
17146
  "type": {
15852
17147
  "text": "string | null"
15853
17148
  },
15854
17149
  "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"
17150
+ "description": "Image URL to show. Falls back to initials/icon if unset or it fails to load.",
17151
+ "fieldName": "src"
15866
17152
  },
15867
17153
  {
15868
- "name": "disabled",
17154
+ "name": "name",
15869
17155
  "type": {
15870
- "text": "boolean"
17156
+ "text": "string | null"
15871
17157
  },
15872
- "default": "false",
15873
- "description": "Disables the control and dims it.",
15874
- "fieldName": "disabled"
17158
+ "default": "null",
17159
+ "description": "Source string for the fallback initial (e.g. a display name or email) — first character, uppercased.",
17160
+ "fieldName": "name"
15875
17161
  },
15876
17162
  {
15877
- "name": "busy",
17163
+ "name": "size",
15878
17164
  "type": {
15879
- "text": "boolean"
17165
+ "text": "string | number"
15880
17166
  },
15881
- "default": "false",
15882
- "description": "Shows a spinner in place of the icon slot and disables the control.",
15883
- "fieldName": "busy"
17167
+ "default": "32",
17168
+ "description": "Diameter in CSS pixels, or a preset name (`xs`=18, `sm`=24, `md`=32, `lg`=48).",
17169
+ "fieldName": "size"
15884
17170
  }
15885
17171
  ],
15886
17172
  "superclass": {
15887
17173
  "name": "LitElement",
15888
17174
  "package": "lit"
15889
17175
  },
15890
- "tagName": "ui-button",
17176
+ "tagName": "user-avatar",
15891
17177
  "customElement": true
15892
17178
  }
15893
17179
  ],
15894
17180
  "exports": [
15895
17181
  {
15896
17182
  "kind": "js",
15897
- "name": "UiButton",
17183
+ "name": "UserAvatar",
15898
17184
  "declaration": {
15899
- "name": "UiButton",
15900
- "module": "src/ui-button.ts"
17185
+ "name": "UserAvatar",
17186
+ "module": "src/user-avatar.ts"
15901
17187
  }
15902
17188
  },
15903
17189
  {
15904
17190
  "kind": "custom-element-definition",
15905
- "name": "ui-button",
17191
+ "name": "user-avatar",
15906
17192
  "declaration": {
15907
- "name": "UiButton",
15908
- "module": "src/ui-button.ts"
17193
+ "name": "UserAvatar",
17194
+ "module": "src/user-avatar.ts"
15909
17195
  }
15910
17196
  }
15911
17197
  ]
15912
17198
  },
15913
17199
  {
15914
17200
  "kind": "javascript-module",
15915
- "path": "src/ui-checkbox.ts",
17201
+ "path": "src/video-player.ts",
15916
17202
  "declarations": [
15917
17203
  {
15918
17204
  "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",
17205
+ "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.",
17206
+ "name": "VideoPlayer",
15921
17207
  "members": [
15922
17208
  {
15923
17209
  "kind": "field",
15924
- "name": "formAssociated",
17210
+ "name": "src",
15925
17211
  "type": {
15926
- "text": "boolean"
17212
+ "text": "string"
15927
17213
  },
15928
- "static": true,
15929
- "default": "true"
17214
+ "default": "\"\"",
17215
+ "description": "URL of the video file to play.",
17216
+ "attribute": "src"
15930
17217
  },
15931
17218
  {
15932
17219
  "kind": "field",
15933
- "name": "checked",
17220
+ "name": "poster",
15934
17221
  "type": {
15935
- "text": "boolean"
17222
+ "text": "string"
15936
17223
  },
15937
- "default": "false",
15938
- "description": "Whether the box is checked.",
15939
- "attribute": "checked"
17224
+ "default": "\"\"",
17225
+ "description": "Poster image shown before playback starts.",
17226
+ "attribute": "poster"
15940
17227
  },
15941
17228
  {
15942
17229
  "kind": "field",
15943
- "name": "indeterminate",
17230
+ "name": "label",
15944
17231
  "type": {
15945
- "text": "boolean"
17232
+ "text": "string"
15946
17233
  },
15947
- "default": "false",
15948
- "description": "Visual \"partial selection\" state; cleared on the next user interaction.",
15949
- "attribute": "indeterminate"
17234
+ "default": "\"Video player\"",
17235
+ "description": "Accessible name for the player, e.g. a video title.",
17236
+ "attribute": "label"
15950
17237
  },
15951
17238
  {
15952
17239
  "kind": "field",
15953
- "name": "disabled",
17240
+ "name": "loop",
15954
17241
  "type": {
15955
17242
  "text": "boolean"
15956
17243
  },
15957
17244
  "default": "false",
15958
- "description": "Disables interaction; merged with an ancestor `<fieldset disabled>`.",
15959
- "attribute": "disabled"
17245
+ "description": "Loops playback once it reaches the end.",
17246
+ "attribute": "loop"
15960
17247
  },
15961
17248
  {
15962
17249
  "kind": "field",
15963
- "name": "required",
17250
+ "name": "preload",
15964
17251
  "type": {
15965
- "text": "boolean"
17252
+ "text": "\"none\" | \"metadata\" | \"auto\""
15966
17253
  },
15967
- "default": "false",
15968
- "description": "Marks the control invalid via `ElementInternals` while unchecked.",
15969
- "attribute": "required"
17254
+ "default": "\"metadata\"",
17255
+ "description": "Native `<video preload>` hint.",
17256
+ "attribute": "preload"
15970
17257
  },
15971
17258
  {
15972
17259
  "kind": "field",
15973
- "name": "name",
17260
+ "name": "_playing",
15974
17261
  "type": {
15975
- "text": "string"
17262
+ "text": "boolean"
15976
17263
  },
15977
- "default": "\"\"",
15978
- "description": "Form field name; submitted as `name=on` only while checked.",
15979
- "attribute": "name"
17264
+ "privacy": "private",
17265
+ "default": "false"
15980
17266
  },
15981
17267
  {
15982
17268
  "kind": "field",
15983
- "name": "label",
17269
+ "name": "_currentTime",
15984
17270
  "type": {
15985
- "text": "string"
17271
+ "text": "number"
15986
17272
  },
15987
- "default": "\"\"",
15988
- "description": "Visible label text rendered next to the box.",
15989
- "attribute": "label"
17273
+ "privacy": "private",
17274
+ "default": "0"
15990
17275
  },
15991
17276
  {
15992
17277
  "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."
17278
+ "name": "_duration",
17279
+ "privacy": "private",
17280
+ "default": "NaN"
15999
17281
  },
16000
17282
  {
16001
17283
  "kind": "field",
16002
- "name": "iconSize",
17284
+ "name": "_volume",
16003
17285
  "type": {
16004
17286
  "text": "number"
16005
17287
  },
16006
- "default": "14",
16007
- "description": "Square icon size in pixels — 14 (inline icon size) by default.",
16008
- "attribute": "iconSize"
17288
+ "privacy": "private",
17289
+ "default": "1"
16009
17290
  },
16010
17291
  {
16011
17292
  "kind": "field",
16012
- "name": "_formDisabled",
17293
+ "name": "_muted",
16013
17294
  "type": {
16014
17295
  "text": "boolean"
16015
17296
  },
@@ -16018,86 +17299,152 @@
16018
17299
  },
16019
17300
  {
16020
17301
  "kind": "field",
16021
- "name": "#internals",
16022
- "privacy": "private"
17302
+ "name": "_errored",
17303
+ "type": {
17304
+ "text": "boolean"
17305
+ },
17306
+ "privacy": "private",
17307
+ "default": "false"
16023
17308
  },
16024
17309
  {
16025
17310
  "kind": "field",
16026
- "name": "#defaultChecked",
16027
- "privacy": "private",
17311
+ "name": "_fullscreen",
16028
17312
  "type": {
16029
17313
  "text": "boolean"
16030
17314
  },
17315
+ "privacy": "private",
16031
17316
  "default": "false"
16032
17317
  },
16033
17318
  {
16034
17319
  "kind": "field",
16035
- "name": "#inputEl",
16036
- "privacy": "private",
17320
+ "name": "_video",
16037
17321
  "type": {
16038
- "text": "HTMLInputElement | null"
17322
+ "text": "HTMLVideoElement | undefined"
16039
17323
  },
16040
- "default": "null"
17324
+ "privacy": "private"
16041
17325
  },
16042
17326
  {
16043
17327
  "kind": "field",
16044
- "name": "#isDisabled",
16045
- "privacy": "private",
17328
+ "name": "_frame",
16046
17329
  "type": {
16047
- "text": "boolean"
17330
+ "text": "HTMLDivElement | undefined"
16048
17331
  },
16049
- "description": "Whether the host or an ancestor fieldset currently disables the control.",
16050
- "readonly": true
17332
+ "privacy": "private"
17333
+ },
17334
+ {
17335
+ "kind": "field",
17336
+ "name": "#onFullscreenChange",
17337
+ "privacy": "private"
16051
17338
  },
16052
17339
  {
16053
17340
  "kind": "method",
16054
- "name": "formResetCallback",
17341
+ "name": "_togglePlay",
17342
+ "privacy": "private",
17343
+ "return": {
17344
+ "type": {
17345
+ "text": "void"
17346
+ }
17347
+ }
17348
+ },
17349
+ {
17350
+ "kind": "method",
17351
+ "name": "_toggleMute",
17352
+ "privacy": "private",
17353
+ "return": {
17354
+ "type": {
17355
+ "text": "void"
17356
+ }
17357
+ }
17358
+ },
17359
+ {
17360
+ "kind": "method",
17361
+ "name": "_toggleFullscreen",
17362
+ "privacy": "private",
17363
+ "return": {
17364
+ "type": {
17365
+ "text": "void"
17366
+ }
17367
+ }
17368
+ },
17369
+ {
17370
+ "kind": "method",
17371
+ "name": "_onSeekInput",
17372
+ "privacy": "private",
16055
17373
  "return": {
16056
17374
  "type": {
16057
17375
  "text": "void"
16058
17376
  }
16059
17377
  },
16060
- "description": "Restores the checked state captured at first render, per the form contract."
17378
+ "parameters": [
17379
+ {
17380
+ "name": "e",
17381
+ "type": {
17382
+ "text": "Event"
17383
+ }
17384
+ }
17385
+ ]
16061
17386
  },
16062
17387
  {
16063
17388
  "kind": "method",
16064
- "name": "formDisabledCallback",
17389
+ "name": "_onVolumeInput",
17390
+ "privacy": "private",
17391
+ "return": {
17392
+ "type": {
17393
+ "text": "void"
17394
+ }
17395
+ },
17396
+ "parameters": [
17397
+ {
17398
+ "name": "e",
17399
+ "type": {
17400
+ "text": "Event"
17401
+ }
17402
+ }
17403
+ ]
17404
+ },
17405
+ {
17406
+ "kind": "method",
17407
+ "name": "_onLoadedMetadata",
17408
+ "privacy": "private",
17409
+ "return": {
17410
+ "type": {
17411
+ "text": "void"
17412
+ }
17413
+ }
17414
+ },
17415
+ {
17416
+ "kind": "method",
17417
+ "name": "_onTimeUpdate",
17418
+ "privacy": "private",
17419
+ "return": {
17420
+ "type": {
17421
+ "text": "void"
17422
+ }
17423
+ }
17424
+ },
17425
+ {
17426
+ "kind": "method",
17427
+ "name": "_onPlay",
17428
+ "privacy": "private",
16065
17429
  "return": {
16066
17430
  "type": {
16067
17431
  "text": "void"
16068
17432
  }
16069
- },
16070
- "parameters": [
16071
- {
16072
- "name": "disabled",
16073
- "type": {
16074
- "text": "boolean"
16075
- }
16076
- }
16077
- ],
16078
- "description": "Mirrors an ancestor fieldset's disabled state."
17433
+ }
16079
17434
  },
16080
17435
  {
16081
17436
  "kind": "method",
16082
- "name": "formStateRestoreCallback",
17437
+ "name": "_onPause",
17438
+ "privacy": "private",
16083
17439
  "return": {
16084
17440
  "type": {
16085
17441
  "text": "void"
16086
17442
  }
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)."
17443
+ }
16097
17444
  },
16098
17445
  {
16099
17446
  "kind": "method",
16100
- "name": "#syncFormValue",
17447
+ "name": "_onEnded",
16101
17448
  "privacy": "private",
16102
17449
  "return": {
16103
17450
  "type": {
@@ -16107,7 +17454,7 @@
16107
17454
  },
16108
17455
  {
16109
17456
  "kind": "method",
16110
- "name": "#syncValidity",
17457
+ "name": "_onVolumeChange",
16111
17458
  "privacy": "private",
16112
17459
  "return": {
16113
17460
  "type": {
@@ -16117,252 +17464,108 @@
16117
17464
  },
16118
17465
  {
16119
17466
  "kind": "method",
16120
- "name": "#onChange",
17467
+ "name": "_onError",
16121
17468
  "privacy": "private",
16122
17469
  "return": {
16123
17470
  "type": {
16124
17471
  "text": "void"
16125
17472
  }
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"
17473
+ }
16140
17474
  }
16141
17475
  ],
16142
17476
  "events": [
16143
17477
  {
16144
- "name": "change",
17478
+ "name": "play",
16145
17479
  "type": {
16146
17480
  "text": "CustomEvent"
16147
17481
  },
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"
17482
+ "description": "The video started playing."
16160
17483
  },
16161
17484
  {
16162
- "name": "indeterminate",
17485
+ "name": "pause",
16163
17486
  "type": {
16164
- "text": "boolean"
17487
+ "text": "CustomEvent"
16165
17488
  },
16166
- "default": "false",
16167
- "description": "Visual \"partial selection\" state; cleared on the next user interaction.",
16168
- "fieldName": "indeterminate"
17489
+ "description": "The video was paused."
16169
17490
  },
16170
17491
  {
16171
- "name": "disabled",
17492
+ "name": "ended",
16172
17493
  "type": {
16173
- "text": "boolean"
17494
+ "text": "CustomEvent"
16174
17495
  },
16175
- "default": "false",
16176
- "description": "Disables interaction; merged with an ancestor `<fieldset disabled>`.",
16177
- "fieldName": "disabled"
16178
- },
17496
+ "description": "Playback reached the end."
17497
+ }
17498
+ ],
17499
+ "attributes": [
16179
17500
  {
16180
- "name": "required",
17501
+ "name": "src",
16181
17502
  "type": {
16182
- "text": "boolean"
17503
+ "text": "string"
16183
17504
  },
16184
- "default": "false",
16185
- "description": "Marks the control invalid via `ElementInternals` while unchecked.",
16186
- "fieldName": "required"
17505
+ "default": "\"\"",
17506
+ "description": "URL of the video file to play.",
17507
+ "fieldName": "src"
16187
17508
  },
16188
17509
  {
16189
- "name": "name",
17510
+ "name": "poster",
16190
17511
  "type": {
16191
17512
  "text": "string"
16192
17513
  },
16193
17514
  "default": "\"\"",
16194
- "description": "Form field name; submitted as `name=on` only while checked.",
16195
- "fieldName": "name"
17515
+ "description": "Poster image shown before playback starts.",
17516
+ "fieldName": "poster"
16196
17517
  },
16197
17518
  {
16198
17519
  "name": "label",
16199
17520
  "type": {
16200
17521
  "text": "string"
16201
17522
  },
16202
- "default": "\"\"",
16203
- "description": "Visible label text rendered next to the box.",
17523
+ "default": "\"Video player\"",
17524
+ "description": "Accessible name for the player, e.g. a video title.",
16204
17525
  "fieldName": "label"
16205
17526
  },
16206
17527
  {
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",
17528
+ "name": "loop",
16285
17529
  "type": {
16286
17530
  "text": "boolean"
16287
17531
  },
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"
17532
+ "default": "false",
17533
+ "description": "Loops playback once it reaches the end.",
17534
+ "fieldName": "loop"
16332
17535
  },
16333
17536
  {
16334
- "name": "size",
17537
+ "name": "preload",
16335
17538
  "type": {
16336
- "text": "string | number"
17539
+ "text": "\"none\" | \"metadata\" | \"auto\""
16337
17540
  },
16338
- "default": "32",
16339
- "description": "Diameter in CSS pixels, or a preset name (`xs`=18, `sm`=24, `md`=32, `lg`=48).",
16340
- "fieldName": "size"
17541
+ "default": "\"metadata\"",
17542
+ "description": "Native `<video preload>` hint.",
17543
+ "fieldName": "preload"
16341
17544
  }
16342
17545
  ],
16343
17546
  "superclass": {
16344
17547
  "name": "LitElement",
16345
17548
  "package": "lit"
16346
17549
  },
16347
- "tagName": "user-avatar",
17550
+ "tagName": "video-player",
16348
17551
  "customElement": true
16349
17552
  }
16350
17553
  ],
16351
17554
  "exports": [
16352
17555
  {
16353
17556
  "kind": "js",
16354
- "name": "UserAvatar",
17557
+ "name": "VideoPlayer",
16355
17558
  "declaration": {
16356
- "name": "UserAvatar",
16357
- "module": "src/user-avatar.ts"
17559
+ "name": "VideoPlayer",
17560
+ "module": "src/video-player.ts"
16358
17561
  }
16359
17562
  },
16360
17563
  {
16361
17564
  "kind": "custom-element-definition",
16362
- "name": "user-avatar",
17565
+ "name": "video-player",
16363
17566
  "declaration": {
16364
- "name": "UserAvatar",
16365
- "module": "src/user-avatar.ts"
17567
+ "name": "VideoPlayer",
17568
+ "module": "src/video-player.ts"
16366
17569
  }
16367
17570
  }
16368
17571
  ]
@@ -16840,6 +18043,24 @@
16840
18043
  }
16841
18044
  ],
16842
18045
  "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."
18046
+ },
18047
+ {
18048
+ "kind": "function",
18049
+ "name": "formatClockDuration",
18050
+ "return": {
18051
+ "type": {
18052
+ "text": "string"
18053
+ }
18054
+ },
18055
+ "parameters": [
18056
+ {
18057
+ "name": "totalSeconds",
18058
+ "type": {
18059
+ "text": "number"
18060
+ }
18061
+ }
18062
+ ],
18063
+ "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
18064
  }
16844
18065
  ],
16845
18066
  "exports": [
@@ -16850,6 +18071,14 @@
16850
18071
  "name": "formatDuration",
16851
18072
  "module": "src/utils/duration.ts"
16852
18073
  }
18074
+ },
18075
+ {
18076
+ "kind": "js",
18077
+ "name": "formatClockDuration",
18078
+ "declaration": {
18079
+ "name": "formatClockDuration",
18080
+ "module": "src/utils/duration.ts"
18081
+ }
16853
18082
  }
16854
18083
  ]
16855
18084
  },
@@ -17270,6 +18499,28 @@
17270
18499
  }
17271
18500
  }
17272
18501
  ]
18502
+ },
18503
+ {
18504
+ "kind": "javascript-module",
18505
+ "path": "src/utils/transport-controls.ts",
18506
+ "declarations": [
18507
+ {
18508
+ "kind": "variable",
18509
+ "name": "transportRangeStyles",
18510
+ "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; } } `",
18511
+ "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."
18512
+ }
18513
+ ],
18514
+ "exports": [
18515
+ {
18516
+ "kind": "js",
18517
+ "name": "transportRangeStyles",
18518
+ "declaration": {
18519
+ "name": "transportRangeStyles",
18520
+ "module": "src/utils/transport-controls.ts"
18521
+ }
18522
+ }
18523
+ ]
17273
18524
  }
17274
18525
  ]
17275
18526
  }