@c2n/framework-types 0.0.7 → 0.0.8

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.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
3
3
  "name": "@c2n/framework-types",
4
- "version": "0.0.7",
4
+ "version": "0.0.8",
5
5
  "description": "GENERATED by @c2n/framework-types. Do not edit by hand.",
6
6
  "description-markup": "markdown",
7
7
  "contributions": {
@@ -1181,6 +1181,14 @@
1181
1181
  }
1182
1182
  ],
1183
1183
  "events": [
1184
+ {
1185
+ "name": "tooltip-change",
1186
+ "description": "Fired with the complete tooltip model as the pointer moves, and with `null` when it leaves. Used by `c2-chart-tooltip`.",
1187
+ "value": {
1188
+ "type": "CustomEvent<ChartTooltipContext | null>",
1189
+ "kind": "expression"
1190
+ }
1191
+ },
1184
1192
  {
1185
1193
  "name": "series-toggle",
1186
1194
  "description": "Fired when a legend entry is toggled. Does not bubble.",
@@ -1189,6 +1197,14 @@
1189
1197
  "kind": "expression"
1190
1198
  }
1191
1199
  },
1200
+ {
1201
+ "name": "legend-change",
1202
+ "description": "Fired when legend entries or visibility change. Used by `c2-chart-legend`.",
1203
+ "value": {
1204
+ "type": "CustomEvent<ChartLegendChangeEventDetail>",
1205
+ "kind": "expression"
1206
+ }
1207
+ },
1192
1208
  {
1193
1209
  "name": "range-change",
1194
1210
  "description": "Fired after the user zooms or brushes. `detail.min` and `detail.max` are the new x bounds. Does not bubble.",
@@ -1217,7 +1233,7 @@
1217
1233
  "name": "point-hover",
1218
1234
  "description": "Fired as the pointer moves between data points, and with a `null` detail when it leaves the plot. Does not bubble.",
1219
1235
  "value": {
1220
- "type": "CustomEvent<ChartPointEventDetail>",
1236
+ "type": "CustomEvent<ChartPointEventDetail | null>",
1221
1237
  "kind": "expression"
1222
1238
  }
1223
1239
  },
@@ -1523,6 +1539,14 @@
1523
1539
  }
1524
1540
  ],
1525
1541
  "events": [
1542
+ {
1543
+ "name": "tooltip-change",
1544
+ "description": "Fired with the complete tooltip model as the pointer moves, and with `null` when it leaves. Used by `c2-chart-tooltip`.",
1545
+ "value": {
1546
+ "type": "CustomEvent<ChartTooltipContext | null>",
1547
+ "kind": "expression"
1548
+ }
1549
+ },
1526
1550
  {
1527
1551
  "name": "series-toggle",
1528
1552
  "description": "Fired when a legend entry is toggled. Does not bubble.",
@@ -1531,6 +1555,14 @@
1531
1555
  "kind": "expression"
1532
1556
  }
1533
1557
  },
1558
+ {
1559
+ "name": "legend-change",
1560
+ "description": "Fired when legend entries or visibility change. Used by `c2-chart-legend`.",
1561
+ "value": {
1562
+ "type": "CustomEvent<ChartLegendChangeEventDetail>",
1563
+ "kind": "expression"
1564
+ }
1565
+ },
1534
1566
  {
1535
1567
  "name": "range-change",
1536
1568
  "description": "Fired after the user zooms or brushes. `detail.min` and `detail.max` are the new x bounds. Does not bubble.",
@@ -1559,7 +1591,7 @@
1559
1591
  "name": "point-hover",
1560
1592
  "description": "Fired as the pointer moves between data points, and with a `null` detail when it leaves the plot. Does not bubble.",
1561
1593
  "value": {
1562
- "type": "CustomEvent<ChartPointEventDetail>",
1594
+ "type": "CustomEvent<ChartPointEventDetail | null>",
1563
1595
  "kind": "expression"
1564
1596
  }
1565
1597
  },
@@ -1575,171 +1607,60 @@
1575
1607
  }
1576
1608
  },
1577
1609
  {
1578
- "name": "c2-chart-series",
1579
- "description": "One series of a chart, declared as a light-DOM child. The element renders nothing: it is a definition\nthe chart reads, the same way `c2-table` reads its `c2-table-column` children. Everything it exposes as\nan attribute can also be set as a property, and `format` is property-only.\n\n`@c2n/chart`",
1610
+ "name": "c2-candlestick-chart",
1611
+ "description": "An OHLC candlestick chart drawn by ECharts. With no series children it reads the `open`, `close`, `low`\nand `high` fields; the four `*-field` attributes rename that convention. Four explicit series children\ncan instead supply those columns in the same order.\n\n`@c2n/chart`",
1580
1612
  "attributes": [
1581
1613
  {
1582
- "name": "field",
1583
- "description": "Key of the value in the row object; may be a dotted path such as `stats.cpu`.",
1584
- "default": "''",
1614
+ "name": "open-field",
1615
+ "description": "Row field containing the opening value.",
1616
+ "default": "'open'",
1585
1617
  "value": {
1586
1618
  "type": "string",
1587
1619
  "kind": "expression"
1588
1620
  }
1589
1621
  },
1590
1622
  {
1591
- "name": "label",
1592
- "description": "Legend and tooltip label. Falls back to the field name.",
1593
- "value": {
1594
- "type": "string | undefined",
1595
- "kind": "expression"
1596
- }
1597
- },
1598
- {
1599
- "name": "color",
1600
- "description": "Explicit colour. Falls back to this series' slot in the chart's palette.",
1601
- "value": {
1602
- "type": "string | undefined",
1603
- "kind": "expression"
1604
- }
1605
- },
1606
- {
1607
- "name": "line-width",
1608
- "description": "Stroke width in pixels. Falls back to `--c2-chart__line--width`.",
1623
+ "name": "close-field",
1624
+ "description": "Row field containing the closing value.",
1625
+ "default": "'close'",
1609
1626
  "value": {
1610
- "type": "number | undefined",
1611
- "kind": "expression"
1612
- }
1613
- },
1614
- {
1615
- "name": "axis",
1616
- "description": "Which y axis the series is drawn against.",
1617
- "default": "'left'",
1618
- "value": {
1619
- "type": "'left' | 'right'",
1620
- "kind": "expression"
1621
- }
1622
- },
1623
- {
1624
- "name": "span-gaps",
1625
- "description": "Joins across gaps instead of breaking the line.",
1626
- "default": "false",
1627
- "value": {
1628
- "type": "boolean",
1629
- "kind": "expression"
1630
- }
1631
- },
1632
- {
1633
- "name": "hidden",
1634
- "description": "Leaves the series out of the chart without removing the definition.",
1635
- "default": "false",
1636
- "value": {
1637
- "type": "boolean",
1638
- "kind": "expression"
1639
- }
1640
- }
1641
- ],
1642
- "js": {
1643
- "properties": [
1644
- {
1645
- "name": "lineWidth",
1646
- "description": "Stroke width in pixels. Falls back to `--c2-chart__line--width`.",
1647
- "value": {
1648
- "type": "number | undefined",
1649
- "kind": "expression"
1650
- }
1651
- },
1652
- {
1653
- "name": "spanGaps",
1654
- "description": "Joins across gaps instead of breaking the line.",
1655
- "value": {
1656
- "type": "boolean",
1657
- "kind": "expression"
1658
- }
1659
- }
1660
- ],
1661
- "events": [
1662
- {
1663
- "name": "SERIES_CHANGE_EVENT",
1664
- "value": {
1665
- "type": "CustomEvent",
1666
- "kind": "expression"
1667
- }
1668
- }
1669
- ]
1670
- }
1671
- },
1672
- {
1673
- "name": "c2-line-chart",
1674
- "description": "A line chart over a time or numeric x axis, drawn on canvas by uPlot.\n\n`@c2n/chart`",
1675
- "attributes": [
1676
- {
1677
- "name": "curve",
1678
- "description": "Interpolation between points.",
1679
- "default": "'linear'",
1680
- "value": {
1681
- "type": "'linear' | 'smooth' | 'step'",
1682
- "kind": "expression"
1683
- }
1684
- },
1685
- {
1686
- "name": "points",
1687
- "description": "When point markers are drawn. `auto` lets uPlot show them once points are far enough apart.",
1688
- "default": "'auto'",
1689
- "value": {
1690
- "type": "'auto' | 'always' | 'none'",
1691
- "kind": "expression"
1692
- }
1693
- },
1694
- {
1695
- "name": "grid",
1696
- "description": "Which grid lines are drawn. A string rather than a boolean because a boolean attribute reads as `true`\nwhenever it is present — `grid=\"false\"` in markup would turn the grid *on*, and there would be no way to\nturn it off from HTML at all. `y` (the default) draws the horizontal lines, matching `axes`' shape.",
1697
- "default": "'y'",
1698
- "value": {
1699
- "type": "'both' | 'x' | 'y' | 'none'",
1700
- "kind": "expression"
1701
- }
1702
- },
1703
- {
1704
- "name": "axes",
1705
- "description": "Which axes are drawn.",
1706
- "default": "'both'",
1707
- "value": {
1708
- "type": "'both' | 'x' | 'y' | 'none'",
1627
+ "type": "string",
1709
1628
  "kind": "expression"
1710
1629
  }
1711
1630
  },
1712
1631
  {
1713
- "name": "y-min",
1714
- "description": "Lower bound of the y scale. Auto-ranged when unset.",
1632
+ "name": "low-field",
1633
+ "description": "Row field containing the lowest value.",
1634
+ "default": "'low'",
1715
1635
  "value": {
1716
- "type": "number | undefined",
1636
+ "type": "string",
1717
1637
  "kind": "expression"
1718
1638
  }
1719
1639
  },
1720
1640
  {
1721
- "name": "y-max",
1722
- "description": "Upper bound of the y scale. Auto-ranged when unset.",
1641
+ "name": "high-field",
1642
+ "description": "Row field containing the highest value.",
1643
+ "default": "'high'",
1723
1644
  "value": {
1724
- "type": "number | undefined",
1645
+ "type": "string",
1725
1646
  "kind": "expression"
1726
1647
  }
1727
1648
  },
1728
1649
  {
1729
- "name": "zoom",
1730
- "description": "Lets the user drag horizontally to zoom the x scale.",
1731
- "default": "false",
1650
+ "name": "name",
1651
+ "description": "Name shown by an enabled legend for the complete OHLC series.",
1652
+ "default": "'Price'",
1732
1653
  "value": {
1733
- "type": "boolean",
1654
+ "type": "string",
1734
1655
  "kind": "expression"
1735
1656
  }
1736
1657
  },
1737
1658
  {
1738
- "name": "cursor",
1739
- "description": "The cursor crosshair.",
1740
- "default": "'x'",
1659
+ "name": "renderer",
1660
+ "description": "Which ECharts renderer to use. SVG prints and scales crisply; canvas is faster with many marks.",
1661
+ "default": "'canvas'",
1741
1662
  "value": {
1742
- "type": "'x' | 'none'",
1663
+ "type": "'canvas' | 'svg'",
1743
1664
  "kind": "expression"
1744
1665
  }
1745
1666
  },
@@ -1879,18 +1800,34 @@
1879
1800
  "js": {
1880
1801
  "properties": [
1881
1802
  {
1882
- "name": "yMin",
1883
- "description": "Lower bound of the y scale. Auto-ranged when unset.",
1803
+ "name": "openField",
1804
+ "description": "Row field containing the opening value.",
1884
1805
  "value": {
1885
- "type": "number | undefined",
1806
+ "type": "string",
1886
1807
  "kind": "expression"
1887
1808
  }
1888
1809
  },
1889
1810
  {
1890
- "name": "yMax",
1891
- "description": "Upper bound of the y scale. Auto-ranged when unset.",
1811
+ "name": "closeField",
1812
+ "description": "Row field containing the closing value.",
1892
1813
  "value": {
1893
- "type": "number | undefined",
1814
+ "type": "string",
1815
+ "kind": "expression"
1816
+ }
1817
+ },
1818
+ {
1819
+ "name": "lowField",
1820
+ "description": "Row field containing the lowest value.",
1821
+ "value": {
1822
+ "type": "string",
1823
+ "kind": "expression"
1824
+ }
1825
+ },
1826
+ {
1827
+ "name": "highField",
1828
+ "description": "Row field containing the highest value.",
1829
+ "value": {
1830
+ "type": "string",
1894
1831
  "kind": "expression"
1895
1832
  }
1896
1833
  },
@@ -1944,6 +1881,14 @@
1944
1881
  }
1945
1882
  ],
1946
1883
  "events": [
1884
+ {
1885
+ "name": "tooltip-change",
1886
+ "description": "Fired with the complete tooltip model as the pointer moves, and with `null` when it leaves. Used by `c2-chart-tooltip`.",
1887
+ "value": {
1888
+ "type": "CustomEvent<ChartTooltipContext | null>",
1889
+ "kind": "expression"
1890
+ }
1891
+ },
1947
1892
  {
1948
1893
  "name": "series-toggle",
1949
1894
  "description": "Fired when a legend entry is toggled. Does not bubble.",
@@ -1952,6 +1897,14 @@
1952
1897
  "kind": "expression"
1953
1898
  }
1954
1899
  },
1900
+ {
1901
+ "name": "legend-change",
1902
+ "description": "Fired when legend entries or visibility change. Used by `c2-chart-legend`.",
1903
+ "value": {
1904
+ "type": "CustomEvent<ChartLegendChangeEventDetail>",
1905
+ "kind": "expression"
1906
+ }
1907
+ },
1955
1908
  {
1956
1909
  "name": "range-change",
1957
1910
  "description": "Fired after the user zooms or brushes. `detail.min` and `detail.max` are the new x bounds. Does not bubble.",
@@ -1980,7 +1933,7 @@
1980
1933
  "name": "point-hover",
1981
1934
  "description": "Fired as the pointer moves between data points, and with a `null` detail when it leaves the plot. Does not bubble.",
1982
1935
  "value": {
1983
- "type": "CustomEvent<ChartPointEventDetail>",
1936
+ "type": "CustomEvent<ChartPointEventDetail | null>",
1984
1937
  "kind": "expression"
1985
1938
  }
1986
1939
  },
@@ -1996,12 +1949,163 @@
1996
1949
  }
1997
1950
  },
1998
1951
  {
1999
- "name": "c2-pie-chart",
2000
- "description": "A pie or donut chart, drawn by ECharts. `label-field` names each slice and the single series supplies\nits value, so one row is one slice.\n\n`@c2n/chart`",
1952
+ "name": "c2-chart-legend",
1953
+ "description": "A legend linked to a chart by id. Place it anywhere in the document to control the legend's layout\nindependently from the chart.\n\n`@c2n/chart`",
2001
1954
  "attributes": [
2002
1955
  {
2003
- "name": "inner-radius",
2004
- "description": "Hole in the middle, from 0 (a full pie) to 1. Anything above 0 makes it a donut.",
1956
+ "name": "for",
1957
+ "description": "Id of the chart this element presents.",
1958
+ "default": "''",
1959
+ "value": {
1960
+ "type": "string",
1961
+ "kind": "expression"
1962
+ }
1963
+ }
1964
+ ],
1965
+ "js": {
1966
+ "properties": [],
1967
+ "events": []
1968
+ }
1969
+ },
1970
+ {
1971
+ "name": "c2-chart-series",
1972
+ "description": "One series of a chart, declared as a light-DOM child. The element renders nothing: it is a definition\nthe chart reads, the same way `c2-table` reads its `c2-table-column` children. Everything it exposes as\nan attribute can also be set as a property, and `format` is property-only.\n\n`@c2n/chart`",
1973
+ "attributes": [
1974
+ {
1975
+ "name": "field",
1976
+ "description": "Key of the value in the row object; may be a dotted path such as `stats.cpu`.",
1977
+ "default": "''",
1978
+ "value": {
1979
+ "type": "string",
1980
+ "kind": "expression"
1981
+ }
1982
+ },
1983
+ {
1984
+ "name": "label",
1985
+ "description": "Legend and tooltip label. Falls back to the field name.",
1986
+ "value": {
1987
+ "type": "string | undefined",
1988
+ "kind": "expression"
1989
+ }
1990
+ },
1991
+ {
1992
+ "name": "color",
1993
+ "description": "Explicit colour. Falls back to this series' slot in the chart's palette.",
1994
+ "value": {
1995
+ "type": "string | undefined",
1996
+ "kind": "expression"
1997
+ }
1998
+ },
1999
+ {
2000
+ "name": "line-width",
2001
+ "description": "Stroke width in pixels. Falls back to `--c2-chart__line--width`.",
2002
+ "value": {
2003
+ "type": "number | undefined",
2004
+ "kind": "expression"
2005
+ }
2006
+ },
2007
+ {
2008
+ "name": "axis",
2009
+ "description": "Which y axis the series is drawn against.",
2010
+ "default": "'left'",
2011
+ "value": {
2012
+ "type": "'left' | 'right'",
2013
+ "kind": "expression"
2014
+ }
2015
+ },
2016
+ {
2017
+ "name": "span-gaps",
2018
+ "description": "Joins across gaps instead of breaking the line.",
2019
+ "default": "false",
2020
+ "value": {
2021
+ "type": "boolean",
2022
+ "kind": "expression"
2023
+ }
2024
+ },
2025
+ {
2026
+ "name": "hidden",
2027
+ "description": "Leaves the series out of the chart without removing the definition.",
2028
+ "default": "false",
2029
+ "value": {
2030
+ "type": "boolean",
2031
+ "kind": "expression"
2032
+ }
2033
+ }
2034
+ ],
2035
+ "js": {
2036
+ "properties": [
2037
+ {
2038
+ "name": "lineWidth",
2039
+ "description": "Stroke width in pixels. Falls back to `--c2-chart__line--width`.",
2040
+ "value": {
2041
+ "type": "number | undefined",
2042
+ "kind": "expression"
2043
+ }
2044
+ },
2045
+ {
2046
+ "name": "spanGaps",
2047
+ "description": "Joins across gaps instead of breaking the line.",
2048
+ "value": {
2049
+ "type": "boolean",
2050
+ "kind": "expression"
2051
+ }
2052
+ }
2053
+ ],
2054
+ "events": [
2055
+ {
2056
+ "name": "SERIES_CHANGE_EVENT",
2057
+ "value": {
2058
+ "type": "CustomEvent",
2059
+ "kind": "expression"
2060
+ }
2061
+ }
2062
+ ]
2063
+ }
2064
+ },
2065
+ {
2066
+ "name": "c2-chart-tooltip",
2067
+ "description": "A tooltip linked to a chart by id. It can float beside the hovered point or render inline wherever it is\nplaced in the document.\n\n`@c2n/chart`",
2068
+ "attributes": [
2069
+ {
2070
+ "name": "position",
2071
+ "description": "Whether the tooltip follows the hovered point or occupies its authored HTML position.",
2072
+ "default": "'floating'",
2073
+ "value": {
2074
+ "type": "'floating' | 'inline'",
2075
+ "kind": "expression"
2076
+ }
2077
+ },
2078
+ {
2079
+ "name": "placement",
2080
+ "description": "Preferred side of the hovered point when `position=\"floating\"`. Flips at viewport edges.",
2081
+ "default": "'top'",
2082
+ "value": {
2083
+ "type": "'top' | 'bottom' | 'start' | 'end'",
2084
+ "kind": "expression"
2085
+ }
2086
+ },
2087
+ {
2088
+ "name": "for",
2089
+ "description": "Id of the chart this element presents.",
2090
+ "default": "''",
2091
+ "value": {
2092
+ "type": "string",
2093
+ "kind": "expression"
2094
+ }
2095
+ }
2096
+ ],
2097
+ "js": {
2098
+ "properties": [],
2099
+ "events": []
2100
+ }
2101
+ },
2102
+ {
2103
+ "name": "c2-gauge-chart",
2104
+ "description": "A radial gauge drawn by ECharts. Use one row and one series for a current value; `label-field` names it.\n\n`@c2n/chart`",
2105
+ "attributes": [
2106
+ {
2107
+ "name": "min",
2108
+ "description": "Lowest value on the gauge scale.",
2005
2109
  "default": "0",
2006
2110
  "value": {
2007
2111
  "type": "number",
@@ -2009,9 +2113,9 @@
2009
2113
  }
2010
2114
  },
2011
2115
  {
2012
- "name": "outer-radius",
2013
- "description": "Outer edge as a share of the available box, from 0 to 1.",
2014
- "default": "0.75",
2116
+ "name": "max",
2117
+ "description": "Highest value on the gauge scale.",
2118
+ "default": "100",
2015
2119
  "value": {
2016
2120
  "type": "number",
2017
2121
  "kind": "expression"
@@ -2019,28 +2123,748 @@
2019
2123
  },
2020
2124
  {
2021
2125
  "name": "start-angle",
2022
- "description": "Angle the first slice starts at, in degrees, counter-clockwise from three o'clock.",
2023
- "default": "90",
2126
+ "description": "Angle where the arc starts, in degrees counter-clockwise from three o'clock.",
2127
+ "default": "225",
2024
2128
  "value": {
2025
2129
  "type": "number",
2026
2130
  "kind": "expression"
2027
2131
  }
2028
2132
  },
2029
2133
  {
2030
- "name": "labels",
2031
- "description": "Where the slice labels are drawn, or `none` to leave them off.",
2032
- "default": "'none'",
2134
+ "name": "end-angle",
2135
+ "description": "Angle where the arc ends, in degrees counter-clockwise from three o'clock.",
2136
+ "default": "-45",
2033
2137
  "value": {
2034
- "type": "'none' | 'inside' | 'outside'",
2138
+ "type": "number",
2035
2139
  "kind": "expression"
2036
2140
  }
2037
2141
  },
2038
2142
  {
2039
- "name": "sort",
2040
- "description": "Orders the slices by value rather than keeping the data order.",
2041
- "default": "'none'",
2143
+ "name": "split-number",
2144
+ "description": "Number of labelled divisions around the arc.",
2145
+ "default": "5",
2042
2146
  "value": {
2043
- "type": "'none' | 'asc' | 'desc'",
2147
+ "type": "number",
2148
+ "kind": "expression"
2149
+ }
2150
+ },
2151
+ {
2152
+ "name": "precision",
2153
+ "description": "Maximum number of decimal places shown in the current value.",
2154
+ "default": "0",
2155
+ "value": {
2156
+ "type": "number",
2157
+ "kind": "expression"
2158
+ }
2159
+ },
2160
+ {
2161
+ "name": "value-suffix",
2162
+ "description": "Text appended to the current value and scale labels, such as `%`.",
2163
+ "default": "''",
2164
+ "value": {
2165
+ "type": "string",
2166
+ "kind": "expression"
2167
+ }
2168
+ },
2169
+ {
2170
+ "name": "progress",
2171
+ "description": "Whether to draw the filled progress arc up to the current value.",
2172
+ "default": "'show'",
2173
+ "value": {
2174
+ "type": "'show' | 'none'",
2175
+ "kind": "expression"
2176
+ }
2177
+ },
2178
+ {
2179
+ "name": "pointer",
2180
+ "description": "Whether to draw the radial pointer.",
2181
+ "default": "'show'",
2182
+ "value": {
2183
+ "type": "'show' | 'none'",
2184
+ "kind": "expression"
2185
+ }
2186
+ },
2187
+ {
2188
+ "name": "renderer",
2189
+ "description": "Which ECharts renderer to use. SVG prints and scales crisply; canvas is faster with many marks.",
2190
+ "default": "'canvas'",
2191
+ "value": {
2192
+ "type": "'canvas' | 'svg'",
2193
+ "kind": "expression"
2194
+ }
2195
+ },
2196
+ {
2197
+ "name": "data",
2198
+ "description": "The data to plot. Row objects, a bare `number[]`, columnar `[xs, ys…]`, or an already-normalised\nframe. Compared by identity: replace the array, or bump `revision` after mutating it in place.",
2199
+ "value": {
2200
+ "type": "ChartInput | undefined",
2201
+ "kind": "expression"
2202
+ }
2203
+ },
2204
+ {
2205
+ "name": "revision",
2206
+ "description": "Bump after mutating `data` in place. The cheap escape hatch for a large buffer you own.",
2207
+ "default": "0",
2208
+ "value": {
2209
+ "type": "number",
2210
+ "kind": "expression"
2211
+ }
2212
+ },
2213
+ {
2214
+ "name": "series",
2215
+ "description": "Series definitions, as an alternative to `c2-chart-series` children. Children win when both are set.",
2216
+ "value": {
2217
+ "type": "ChartSeriesConfig[] | undefined",
2218
+ "kind": "expression"
2219
+ }
2220
+ },
2221
+ {
2222
+ "name": "x-field",
2223
+ "description": "Row field holding the x value; may be a dotted path. Defaults to the row index.",
2224
+ "default": "''",
2225
+ "value": {
2226
+ "type": "string",
2227
+ "kind": "expression"
2228
+ }
2229
+ },
2230
+ {
2231
+ "name": "label-field",
2232
+ "description": "Row field holding the category label, for charts that name their slices.",
2233
+ "default": "''",
2234
+ "value": {
2235
+ "type": "string",
2236
+ "kind": "expression"
2237
+ }
2238
+ },
2239
+ {
2240
+ "name": "x-type",
2241
+ "description": "How x values are interpreted, which decides the axis and the tooltip format.",
2242
+ "default": "'linear'",
2243
+ "value": {
2244
+ "type": "'time' | 'linear' | 'category'",
2245
+ "kind": "expression"
2246
+ }
2247
+ },
2248
+ {
2249
+ "name": "legend",
2250
+ "description": "Where the legend sits, or `none` to hide it. Shown by default: a chart with more than one series is\nunreadable without one, and a single-series chart simply renders a one-entry legend.",
2251
+ "default": "'bottom'",
2252
+ "value": {
2253
+ "type": "'none' | 'top' | 'bottom' | 'start' | 'end'",
2254
+ "kind": "expression"
2255
+ }
2256
+ },
2257
+ {
2258
+ "name": "tooltip",
2259
+ "description": "Whether the tooltip follows the whole x position or only the hovered datum.",
2260
+ "default": "'axis'",
2261
+ "value": {
2262
+ "type": "'none' | 'item' | 'axis'",
2263
+ "kind": "expression"
2264
+ }
2265
+ },
2266
+ {
2267
+ "name": "animation",
2268
+ "description": "Whether the engine animates entry and updates. `none` by default: a chart fed by a live source should\nnot animate every tick. Named `animation` rather than `animate` because `HTMLElement.animate()` is a\nmethod every element already has, and shadowing it breaks the Web Animations API on the host.",
2269
+ "default": "'none'",
2270
+ "value": {
2271
+ "type": "'none' | 'auto'",
2272
+ "kind": "expression"
2273
+ }
2274
+ },
2275
+ {
2276
+ "name": "locale",
2277
+ "description": "BCP 47 locale for the axis and tooltip formatting. Defaults to the browser locale.",
2278
+ "value": {
2279
+ "type": "string | undefined",
2280
+ "kind": "expression"
2281
+ }
2282
+ },
2283
+ {
2284
+ "name": "loading",
2285
+ "description": "Shows the loading state instead of the plot.",
2286
+ "default": "false",
2287
+ "value": {
2288
+ "type": "boolean",
2289
+ "kind": "expression"
2290
+ }
2291
+ },
2292
+ {
2293
+ "name": "error",
2294
+ "description": "Shows an error message instead of the plot.",
2295
+ "default": "''",
2296
+ "value": {
2297
+ "type": "string",
2298
+ "kind": "expression"
2299
+ }
2300
+ },
2301
+ {
2302
+ "name": "empty-message",
2303
+ "description": "Replaces the built-in \"no data\" text.",
2304
+ "default": "'No data'",
2305
+ "value": {
2306
+ "type": "string",
2307
+ "kind": "expression"
2308
+ }
2309
+ },
2310
+ {
2311
+ "name": "max-points",
2312
+ "description": "Caps how many points a streaming chart keeps; older points fall off the front. `0` keeps everything.",
2313
+ "default": "0",
2314
+ "value": {
2315
+ "type": "number",
2316
+ "kind": "expression"
2317
+ }
2318
+ },
2319
+ {
2320
+ "name": "lazy-render",
2321
+ "description": "Defers loading the engine until the host first scrolls into view.",
2322
+ "default": "false",
2323
+ "value": {
2324
+ "type": "boolean",
2325
+ "kind": "expression"
2326
+ }
2327
+ }
2328
+ ],
2329
+ "js": {
2330
+ "properties": [
2331
+ {
2332
+ "name": "startAngle",
2333
+ "description": "Angle where the arc starts, in degrees counter-clockwise from three o'clock.",
2334
+ "value": {
2335
+ "type": "number",
2336
+ "kind": "expression"
2337
+ }
2338
+ },
2339
+ {
2340
+ "name": "endAngle",
2341
+ "description": "Angle where the arc ends, in degrees counter-clockwise from three o'clock.",
2342
+ "value": {
2343
+ "type": "number",
2344
+ "kind": "expression"
2345
+ }
2346
+ },
2347
+ {
2348
+ "name": "splitNumber",
2349
+ "description": "Number of labelled divisions around the arc.",
2350
+ "value": {
2351
+ "type": "number",
2352
+ "kind": "expression"
2353
+ }
2354
+ },
2355
+ {
2356
+ "name": "valueSuffix",
2357
+ "description": "Text appended to the current value and scale labels, such as `%`.",
2358
+ "value": {
2359
+ "type": "string",
2360
+ "kind": "expression"
2361
+ }
2362
+ },
2363
+ {
2364
+ "name": "xField",
2365
+ "description": "Row field holding the x value; may be a dotted path. Defaults to the row index.",
2366
+ "value": {
2367
+ "type": "string",
2368
+ "kind": "expression"
2369
+ }
2370
+ },
2371
+ {
2372
+ "name": "labelField",
2373
+ "description": "Row field holding the category label, for charts that name their slices.",
2374
+ "value": {
2375
+ "type": "string",
2376
+ "kind": "expression"
2377
+ }
2378
+ },
2379
+ {
2380
+ "name": "xType",
2381
+ "description": "How x values are interpreted, which decides the axis and the tooltip format.",
2382
+ "value": {
2383
+ "type": "'time' | 'linear' | 'category'",
2384
+ "kind": "expression"
2385
+ }
2386
+ },
2387
+ {
2388
+ "name": "emptyMessage",
2389
+ "description": "Replaces the built-in \"no data\" text.",
2390
+ "value": {
2391
+ "type": "string",
2392
+ "kind": "expression"
2393
+ }
2394
+ },
2395
+ {
2396
+ "name": "maxPoints",
2397
+ "description": "Caps how many points a streaming chart keeps; older points fall off the front. `0` keeps everything.",
2398
+ "value": {
2399
+ "type": "number",
2400
+ "kind": "expression"
2401
+ }
2402
+ },
2403
+ {
2404
+ "name": "lazyRender",
2405
+ "description": "Defers loading the engine until the host first scrolls into view.",
2406
+ "value": {
2407
+ "type": "boolean",
2408
+ "kind": "expression"
2409
+ }
2410
+ }
2411
+ ],
2412
+ "events": [
2413
+ {
2414
+ "name": "tooltip-change",
2415
+ "description": "Fired with the complete tooltip model as the pointer moves, and with `null` when it leaves. Used by `c2-chart-tooltip`.",
2416
+ "value": {
2417
+ "type": "CustomEvent<ChartTooltipContext | null>",
2418
+ "kind": "expression"
2419
+ }
2420
+ },
2421
+ {
2422
+ "name": "series-toggle",
2423
+ "description": "Fired when a legend entry is toggled. Does not bubble.",
2424
+ "value": {
2425
+ "type": "CustomEvent<ChartSeriesToggleEventDetail>",
2426
+ "kind": "expression"
2427
+ }
2428
+ },
2429
+ {
2430
+ "name": "legend-change",
2431
+ "description": "Fired when legend entries or visibility change. Used by `c2-chart-legend`.",
2432
+ "value": {
2433
+ "type": "CustomEvent<ChartLegendChangeEventDetail>",
2434
+ "kind": "expression"
2435
+ }
2436
+ },
2437
+ {
2438
+ "name": "range-change",
2439
+ "description": "Fired after the user zooms or brushes. `detail.min` and `detail.max` are the new x bounds. Does not bubble.",
2440
+ "value": {
2441
+ "type": "CustomEvent<ChartRangeEventDetail>",
2442
+ "kind": "expression"
2443
+ }
2444
+ },
2445
+ {
2446
+ "name": "chart-ready",
2447
+ "description": "Fired after the engine has loaded and drawn for the first time. The host also gains `data-chart-ready`, which is what a test should wait on.",
2448
+ "value": {
2449
+ "type": "CustomEvent<{ engine: string }>",
2450
+ "kind": "expression"
2451
+ }
2452
+ },
2453
+ {
2454
+ "name": "chart-error",
2455
+ "description": "Fired when the engine fails to load or to draw. `detail.error` is the underlying failure.",
2456
+ "value": {
2457
+ "type": "CustomEvent<{ error: unknown }>",
2458
+ "kind": "expression"
2459
+ }
2460
+ },
2461
+ {
2462
+ "name": "point-hover",
2463
+ "description": "Fired as the pointer moves between data points, and with a `null` detail when it leaves the plot. Does not bubble.",
2464
+ "value": {
2465
+ "type": "CustomEvent<ChartPointEventDetail | null>",
2466
+ "kind": "expression"
2467
+ }
2468
+ },
2469
+ {
2470
+ "name": "point-click",
2471
+ "description": "Fired when a datum is clicked. Does not bubble: several components fire point events, so a listener belongs on the element itself.",
2472
+ "value": {
2473
+ "type": "CustomEvent<ChartPointEventDetail>",
2474
+ "kind": "expression"
2475
+ }
2476
+ }
2477
+ ]
2478
+ }
2479
+ },
2480
+ {
2481
+ "name": "c2-line-chart",
2482
+ "description": "A line chart over a time or numeric x axis, drawn on canvas by uPlot.\n\n`@c2n/chart`",
2483
+ "attributes": [
2484
+ {
2485
+ "name": "curve",
2486
+ "description": "Interpolation between points.",
2487
+ "default": "'linear'",
2488
+ "value": {
2489
+ "type": "'linear' | 'smooth' | 'step'",
2490
+ "kind": "expression"
2491
+ }
2492
+ },
2493
+ {
2494
+ "name": "points",
2495
+ "description": "When point markers are drawn. `auto` lets uPlot show them once points are far enough apart.",
2496
+ "default": "'auto'",
2497
+ "value": {
2498
+ "type": "'auto' | 'always' | 'none'",
2499
+ "kind": "expression"
2500
+ }
2501
+ },
2502
+ {
2503
+ "name": "grid",
2504
+ "description": "Which grid lines are drawn. A string rather than a boolean because a boolean attribute reads as `true`\nwhenever it is present — `grid=\"false\"` in markup would turn the grid *on*, and there would be no way to\nturn it off from HTML at all. `y` (the default) draws the horizontal lines, matching `axes`' shape.",
2505
+ "default": "'y'",
2506
+ "value": {
2507
+ "type": "'both' | 'x' | 'y' | 'none'",
2508
+ "kind": "expression"
2509
+ }
2510
+ },
2511
+ {
2512
+ "name": "axes",
2513
+ "description": "Which axes are drawn.",
2514
+ "default": "'both'",
2515
+ "value": {
2516
+ "type": "'both' | 'x' | 'y' | 'none'",
2517
+ "kind": "expression"
2518
+ }
2519
+ },
2520
+ {
2521
+ "name": "y-min",
2522
+ "description": "Lower bound of the y scale. Auto-ranged when unset.",
2523
+ "value": {
2524
+ "type": "number | undefined",
2525
+ "kind": "expression"
2526
+ }
2527
+ },
2528
+ {
2529
+ "name": "y-max",
2530
+ "description": "Upper bound of the y scale. Auto-ranged when unset.",
2531
+ "value": {
2532
+ "type": "number | undefined",
2533
+ "kind": "expression"
2534
+ }
2535
+ },
2536
+ {
2537
+ "name": "zoom",
2538
+ "description": "Lets the user drag horizontally to zoom the x scale.",
2539
+ "default": "false",
2540
+ "value": {
2541
+ "type": "boolean",
2542
+ "kind": "expression"
2543
+ }
2544
+ },
2545
+ {
2546
+ "name": "cursor",
2547
+ "description": "The cursor crosshair.",
2548
+ "default": "'x'",
2549
+ "value": {
2550
+ "type": "'x' | 'none'",
2551
+ "kind": "expression"
2552
+ }
2553
+ },
2554
+ {
2555
+ "name": "data",
2556
+ "description": "The data to plot. Row objects, a bare `number[]`, columnar `[xs, ys…]`, or an already-normalised\nframe. Compared by identity: replace the array, or bump `revision` after mutating it in place.",
2557
+ "value": {
2558
+ "type": "ChartInput | undefined",
2559
+ "kind": "expression"
2560
+ }
2561
+ },
2562
+ {
2563
+ "name": "revision",
2564
+ "description": "Bump after mutating `data` in place. The cheap escape hatch for a large buffer you own.",
2565
+ "default": "0",
2566
+ "value": {
2567
+ "type": "number",
2568
+ "kind": "expression"
2569
+ }
2570
+ },
2571
+ {
2572
+ "name": "series",
2573
+ "description": "Series definitions, as an alternative to `c2-chart-series` children. Children win when both are set.",
2574
+ "value": {
2575
+ "type": "ChartSeriesConfig[] | undefined",
2576
+ "kind": "expression"
2577
+ }
2578
+ },
2579
+ {
2580
+ "name": "x-field",
2581
+ "description": "Row field holding the x value; may be a dotted path. Defaults to the row index.",
2582
+ "default": "''",
2583
+ "value": {
2584
+ "type": "string",
2585
+ "kind": "expression"
2586
+ }
2587
+ },
2588
+ {
2589
+ "name": "label-field",
2590
+ "description": "Row field holding the category label, for charts that name their slices.",
2591
+ "default": "''",
2592
+ "value": {
2593
+ "type": "string",
2594
+ "kind": "expression"
2595
+ }
2596
+ },
2597
+ {
2598
+ "name": "x-type",
2599
+ "description": "How x values are interpreted, which decides the axis and the tooltip format.",
2600
+ "default": "'linear'",
2601
+ "value": {
2602
+ "type": "'time' | 'linear' | 'category'",
2603
+ "kind": "expression"
2604
+ }
2605
+ },
2606
+ {
2607
+ "name": "legend",
2608
+ "description": "Where the legend sits, or `none` to hide it. Shown by default: a chart with more than one series is\nunreadable without one, and a single-series chart simply renders a one-entry legend.",
2609
+ "default": "'bottom'",
2610
+ "value": {
2611
+ "type": "'none' | 'top' | 'bottom' | 'start' | 'end'",
2612
+ "kind": "expression"
2613
+ }
2614
+ },
2615
+ {
2616
+ "name": "tooltip",
2617
+ "description": "Whether the tooltip follows the whole x position or only the hovered datum.",
2618
+ "default": "'axis'",
2619
+ "value": {
2620
+ "type": "'none' | 'item' | 'axis'",
2621
+ "kind": "expression"
2622
+ }
2623
+ },
2624
+ {
2625
+ "name": "animation",
2626
+ "description": "Whether the engine animates entry and updates. `none` by default: a chart fed by a live source should\nnot animate every tick. Named `animation` rather than `animate` because `HTMLElement.animate()` is a\nmethod every element already has, and shadowing it breaks the Web Animations API on the host.",
2627
+ "default": "'none'",
2628
+ "value": {
2629
+ "type": "'none' | 'auto'",
2630
+ "kind": "expression"
2631
+ }
2632
+ },
2633
+ {
2634
+ "name": "locale",
2635
+ "description": "BCP 47 locale for the axis and tooltip formatting. Defaults to the browser locale.",
2636
+ "value": {
2637
+ "type": "string | undefined",
2638
+ "kind": "expression"
2639
+ }
2640
+ },
2641
+ {
2642
+ "name": "loading",
2643
+ "description": "Shows the loading state instead of the plot.",
2644
+ "default": "false",
2645
+ "value": {
2646
+ "type": "boolean",
2647
+ "kind": "expression"
2648
+ }
2649
+ },
2650
+ {
2651
+ "name": "error",
2652
+ "description": "Shows an error message instead of the plot.",
2653
+ "default": "''",
2654
+ "value": {
2655
+ "type": "string",
2656
+ "kind": "expression"
2657
+ }
2658
+ },
2659
+ {
2660
+ "name": "empty-message",
2661
+ "description": "Replaces the built-in \"no data\" text.",
2662
+ "default": "'No data'",
2663
+ "value": {
2664
+ "type": "string",
2665
+ "kind": "expression"
2666
+ }
2667
+ },
2668
+ {
2669
+ "name": "max-points",
2670
+ "description": "Caps how many points a streaming chart keeps; older points fall off the front. `0` keeps everything.",
2671
+ "default": "0",
2672
+ "value": {
2673
+ "type": "number",
2674
+ "kind": "expression"
2675
+ }
2676
+ },
2677
+ {
2678
+ "name": "lazy-render",
2679
+ "description": "Defers loading the engine until the host first scrolls into view.",
2680
+ "default": "false",
2681
+ "value": {
2682
+ "type": "boolean",
2683
+ "kind": "expression"
2684
+ }
2685
+ }
2686
+ ],
2687
+ "js": {
2688
+ "properties": [
2689
+ {
2690
+ "name": "yMin",
2691
+ "description": "Lower bound of the y scale. Auto-ranged when unset.",
2692
+ "value": {
2693
+ "type": "number | undefined",
2694
+ "kind": "expression"
2695
+ }
2696
+ },
2697
+ {
2698
+ "name": "yMax",
2699
+ "description": "Upper bound of the y scale. Auto-ranged when unset.",
2700
+ "value": {
2701
+ "type": "number | undefined",
2702
+ "kind": "expression"
2703
+ }
2704
+ },
2705
+ {
2706
+ "name": "xField",
2707
+ "description": "Row field holding the x value; may be a dotted path. Defaults to the row index.",
2708
+ "value": {
2709
+ "type": "string",
2710
+ "kind": "expression"
2711
+ }
2712
+ },
2713
+ {
2714
+ "name": "labelField",
2715
+ "description": "Row field holding the category label, for charts that name their slices.",
2716
+ "value": {
2717
+ "type": "string",
2718
+ "kind": "expression"
2719
+ }
2720
+ },
2721
+ {
2722
+ "name": "xType",
2723
+ "description": "How x values are interpreted, which decides the axis and the tooltip format.",
2724
+ "value": {
2725
+ "type": "'time' | 'linear' | 'category'",
2726
+ "kind": "expression"
2727
+ }
2728
+ },
2729
+ {
2730
+ "name": "emptyMessage",
2731
+ "description": "Replaces the built-in \"no data\" text.",
2732
+ "value": {
2733
+ "type": "string",
2734
+ "kind": "expression"
2735
+ }
2736
+ },
2737
+ {
2738
+ "name": "maxPoints",
2739
+ "description": "Caps how many points a streaming chart keeps; older points fall off the front. `0` keeps everything.",
2740
+ "value": {
2741
+ "type": "number",
2742
+ "kind": "expression"
2743
+ }
2744
+ },
2745
+ {
2746
+ "name": "lazyRender",
2747
+ "description": "Defers loading the engine until the host first scrolls into view.",
2748
+ "value": {
2749
+ "type": "boolean",
2750
+ "kind": "expression"
2751
+ }
2752
+ }
2753
+ ],
2754
+ "events": [
2755
+ {
2756
+ "name": "tooltip-change",
2757
+ "description": "Fired with the complete tooltip model as the pointer moves, and with `null` when it leaves. Used by `c2-chart-tooltip`.",
2758
+ "value": {
2759
+ "type": "CustomEvent<ChartTooltipContext | null>",
2760
+ "kind": "expression"
2761
+ }
2762
+ },
2763
+ {
2764
+ "name": "series-toggle",
2765
+ "description": "Fired when a legend entry is toggled. Does not bubble.",
2766
+ "value": {
2767
+ "type": "CustomEvent<ChartSeriesToggleEventDetail>",
2768
+ "kind": "expression"
2769
+ }
2770
+ },
2771
+ {
2772
+ "name": "legend-change",
2773
+ "description": "Fired when legend entries or visibility change. Used by `c2-chart-legend`.",
2774
+ "value": {
2775
+ "type": "CustomEvent<ChartLegendChangeEventDetail>",
2776
+ "kind": "expression"
2777
+ }
2778
+ },
2779
+ {
2780
+ "name": "range-change",
2781
+ "description": "Fired after the user zooms or brushes. `detail.min` and `detail.max` are the new x bounds. Does not bubble.",
2782
+ "value": {
2783
+ "type": "CustomEvent<ChartRangeEventDetail>",
2784
+ "kind": "expression"
2785
+ }
2786
+ },
2787
+ {
2788
+ "name": "chart-ready",
2789
+ "description": "Fired after the engine has loaded and drawn for the first time. The host also gains `data-chart-ready`, which is what a test should wait on.",
2790
+ "value": {
2791
+ "type": "CustomEvent<{ engine: string }>",
2792
+ "kind": "expression"
2793
+ }
2794
+ },
2795
+ {
2796
+ "name": "chart-error",
2797
+ "description": "Fired when the engine fails to load or to draw. `detail.error` is the underlying failure.",
2798
+ "value": {
2799
+ "type": "CustomEvent<{ error: unknown }>",
2800
+ "kind": "expression"
2801
+ }
2802
+ },
2803
+ {
2804
+ "name": "point-hover",
2805
+ "description": "Fired as the pointer moves between data points, and with a `null` detail when it leaves the plot. Does not bubble.",
2806
+ "value": {
2807
+ "type": "CustomEvent<ChartPointEventDetail | null>",
2808
+ "kind": "expression"
2809
+ }
2810
+ },
2811
+ {
2812
+ "name": "point-click",
2813
+ "description": "Fired when a datum is clicked. Does not bubble: several components fire point events, so a listener belongs on the element itself.",
2814
+ "value": {
2815
+ "type": "CustomEvent<ChartPointEventDetail>",
2816
+ "kind": "expression"
2817
+ }
2818
+ }
2819
+ ]
2820
+ }
2821
+ },
2822
+ {
2823
+ "name": "c2-pie-chart",
2824
+ "description": "A pie or donut chart, drawn by ECharts. `label-field` names each slice and the single series supplies\nits value, so one row is one slice.\n\n`@c2n/chart`",
2825
+ "attributes": [
2826
+ {
2827
+ "name": "inner-radius",
2828
+ "description": "Hole in the middle, from 0 (a full pie) to 1. Anything above 0 makes it a donut.",
2829
+ "default": "0",
2830
+ "value": {
2831
+ "type": "number",
2832
+ "kind": "expression"
2833
+ }
2834
+ },
2835
+ {
2836
+ "name": "outer-radius",
2837
+ "description": "Outer edge as a share of the available box, from 0 to 1.",
2838
+ "default": "0.75",
2839
+ "value": {
2840
+ "type": "number",
2841
+ "kind": "expression"
2842
+ }
2843
+ },
2844
+ {
2845
+ "name": "start-angle",
2846
+ "description": "Angle the first slice starts at, in degrees, counter-clockwise from three o'clock.",
2847
+ "default": "90",
2848
+ "value": {
2849
+ "type": "number",
2850
+ "kind": "expression"
2851
+ }
2852
+ },
2853
+ {
2854
+ "name": "labels",
2855
+ "description": "Where the slice labels are drawn, or `none` to leave them off.",
2856
+ "default": "'none'",
2857
+ "value": {
2858
+ "type": "'none' | 'inside' | 'outside'",
2859
+ "kind": "expression"
2860
+ }
2861
+ },
2862
+ {
2863
+ "name": "sort",
2864
+ "description": "Orders the slices by value rather than keeping the data order.",
2865
+ "default": "'none'",
2866
+ "value": {
2867
+ "type": "'none' | 'asc' | 'desc'",
2044
2868
  "kind": "expression"
2045
2869
  }
2046
2870
  },
@@ -2262,6 +3086,14 @@
2262
3086
  }
2263
3087
  ],
2264
3088
  "events": [
3089
+ {
3090
+ "name": "tooltip-change",
3091
+ "description": "Fired with the complete tooltip model as the pointer moves, and with `null` when it leaves. Used by `c2-chart-tooltip`.",
3092
+ "value": {
3093
+ "type": "CustomEvent<ChartTooltipContext | null>",
3094
+ "kind": "expression"
3095
+ }
3096
+ },
2265
3097
  {
2266
3098
  "name": "series-toggle",
2267
3099
  "description": "Fired when a legend entry is toggled. Does not bubble.",
@@ -2270,6 +3102,14 @@
2270
3102
  "kind": "expression"
2271
3103
  }
2272
3104
  },
3105
+ {
3106
+ "name": "legend-change",
3107
+ "description": "Fired when legend entries or visibility change. Used by `c2-chart-legend`.",
3108
+ "value": {
3109
+ "type": "CustomEvent<ChartLegendChangeEventDetail>",
3110
+ "kind": "expression"
3111
+ }
3112
+ },
2273
3113
  {
2274
3114
  "name": "range-change",
2275
3115
  "description": "Fired after the user zooms or brushes. `detail.min` and `detail.max` are the new x bounds. Does not bubble.",
@@ -2297,10 +3137,327 @@
2297
3137
  {
2298
3138
  "name": "point-hover",
2299
3139
  "description": "Fired as the pointer moves between data points, and with a `null` detail when it leaves the plot. Does not bubble.",
3140
+ "value": {
3141
+ "type": "CustomEvent<ChartPointEventDetail | null>",
3142
+ "kind": "expression"
3143
+ }
3144
+ },
3145
+ {
3146
+ "name": "point-click",
3147
+ "description": "Fired when a datum is clicked. Does not bubble: several components fire point events, so a listener belongs on the element itself.",
2300
3148
  "value": {
2301
3149
  "type": "CustomEvent<ChartPointEventDetail>",
2302
3150
  "kind": "expression"
2303
3151
  }
3152
+ }
3153
+ ]
3154
+ }
3155
+ },
3156
+ {
3157
+ "name": "c2-scatter-chart",
3158
+ "description": "A scatter plot drawn by ECharts. `x-field` supplies the shared horizontal value and every series supplies\none vertical measure, so several populations can be compared on the same axes.\n\n`@c2n/chart`",
3159
+ "attributes": [
3160
+ {
3161
+ "name": "symbol-size",
3162
+ "description": "Diameter of each point in CSS pixels.",
3163
+ "default": "10",
3164
+ "value": {
3165
+ "type": "number",
3166
+ "kind": "expression"
3167
+ }
3168
+ },
3169
+ {
3170
+ "name": "symbol",
3171
+ "description": "Shape used for points.",
3172
+ "default": "'circle'",
3173
+ "value": {
3174
+ "type": "'circle' | 'rect' | 'roundRect' | 'triangle' | 'diamond' | 'pin' | 'arrow'",
3175
+ "kind": "expression"
3176
+ }
3177
+ },
3178
+ {
3179
+ "name": "large",
3180
+ "description": "Enables ECharts' large-point rendering path.",
3181
+ "default": "false",
3182
+ "value": {
3183
+ "type": "boolean",
3184
+ "kind": "expression"
3185
+ }
3186
+ },
3187
+ {
3188
+ "name": "large-threshold",
3189
+ "description": "Point count at which the large rendering path takes effect.",
3190
+ "default": "2000",
3191
+ "value": {
3192
+ "type": "number",
3193
+ "kind": "expression"
3194
+ }
3195
+ },
3196
+ {
3197
+ "name": "renderer",
3198
+ "description": "Which ECharts renderer to use. SVG prints and scales crisply; canvas is faster with many marks.",
3199
+ "default": "'canvas'",
3200
+ "value": {
3201
+ "type": "'canvas' | 'svg'",
3202
+ "kind": "expression"
3203
+ }
3204
+ },
3205
+ {
3206
+ "name": "data",
3207
+ "description": "The data to plot. Row objects, a bare `number[]`, columnar `[xs, ys…]`, or an already-normalised\nframe. Compared by identity: replace the array, or bump `revision` after mutating it in place.",
3208
+ "value": {
3209
+ "type": "ChartInput | undefined",
3210
+ "kind": "expression"
3211
+ }
3212
+ },
3213
+ {
3214
+ "name": "revision",
3215
+ "description": "Bump after mutating `data` in place. The cheap escape hatch for a large buffer you own.",
3216
+ "default": "0",
3217
+ "value": {
3218
+ "type": "number",
3219
+ "kind": "expression"
3220
+ }
3221
+ },
3222
+ {
3223
+ "name": "series",
3224
+ "description": "Series definitions, as an alternative to `c2-chart-series` children. Children win when both are set.",
3225
+ "value": {
3226
+ "type": "ChartSeriesConfig[] | undefined",
3227
+ "kind": "expression"
3228
+ }
3229
+ },
3230
+ {
3231
+ "name": "x-field",
3232
+ "description": "Row field holding the x value; may be a dotted path. Defaults to the row index.",
3233
+ "default": "''",
3234
+ "value": {
3235
+ "type": "string",
3236
+ "kind": "expression"
3237
+ }
3238
+ },
3239
+ {
3240
+ "name": "label-field",
3241
+ "description": "Row field holding the category label, for charts that name their slices.",
3242
+ "default": "''",
3243
+ "value": {
3244
+ "type": "string",
3245
+ "kind": "expression"
3246
+ }
3247
+ },
3248
+ {
3249
+ "name": "x-type",
3250
+ "description": "How x values are interpreted, which decides the axis and the tooltip format.",
3251
+ "default": "'linear'",
3252
+ "value": {
3253
+ "type": "'time' | 'linear' | 'category'",
3254
+ "kind": "expression"
3255
+ }
3256
+ },
3257
+ {
3258
+ "name": "legend",
3259
+ "description": "Where the legend sits, or `none` to hide it. Shown by default: a chart with more than one series is\nunreadable without one, and a single-series chart simply renders a one-entry legend.",
3260
+ "default": "'bottom'",
3261
+ "value": {
3262
+ "type": "'none' | 'top' | 'bottom' | 'start' | 'end'",
3263
+ "kind": "expression"
3264
+ }
3265
+ },
3266
+ {
3267
+ "name": "tooltip",
3268
+ "description": "Whether the tooltip follows the whole x position or only the hovered datum.",
3269
+ "default": "'axis'",
3270
+ "value": {
3271
+ "type": "'none' | 'item' | 'axis'",
3272
+ "kind": "expression"
3273
+ }
3274
+ },
3275
+ {
3276
+ "name": "animation",
3277
+ "description": "Whether the engine animates entry and updates. `none` by default: a chart fed by a live source should\nnot animate every tick. Named `animation` rather than `animate` because `HTMLElement.animate()` is a\nmethod every element already has, and shadowing it breaks the Web Animations API on the host.",
3278
+ "default": "'none'",
3279
+ "value": {
3280
+ "type": "'none' | 'auto'",
3281
+ "kind": "expression"
3282
+ }
3283
+ },
3284
+ {
3285
+ "name": "locale",
3286
+ "description": "BCP 47 locale for the axis and tooltip formatting. Defaults to the browser locale.",
3287
+ "value": {
3288
+ "type": "string | undefined",
3289
+ "kind": "expression"
3290
+ }
3291
+ },
3292
+ {
3293
+ "name": "loading",
3294
+ "description": "Shows the loading state instead of the plot.",
3295
+ "default": "false",
3296
+ "value": {
3297
+ "type": "boolean",
3298
+ "kind": "expression"
3299
+ }
3300
+ },
3301
+ {
3302
+ "name": "error",
3303
+ "description": "Shows an error message instead of the plot.",
3304
+ "default": "''",
3305
+ "value": {
3306
+ "type": "string",
3307
+ "kind": "expression"
3308
+ }
3309
+ },
3310
+ {
3311
+ "name": "empty-message",
3312
+ "description": "Replaces the built-in \"no data\" text.",
3313
+ "default": "'No data'",
3314
+ "value": {
3315
+ "type": "string",
3316
+ "kind": "expression"
3317
+ }
3318
+ },
3319
+ {
3320
+ "name": "max-points",
3321
+ "description": "Caps how many points a streaming chart keeps; older points fall off the front. `0` keeps everything.",
3322
+ "default": "0",
3323
+ "value": {
3324
+ "type": "number",
3325
+ "kind": "expression"
3326
+ }
3327
+ },
3328
+ {
3329
+ "name": "lazy-render",
3330
+ "description": "Defers loading the engine until the host first scrolls into view.",
3331
+ "default": "false",
3332
+ "value": {
3333
+ "type": "boolean",
3334
+ "kind": "expression"
3335
+ }
3336
+ }
3337
+ ],
3338
+ "js": {
3339
+ "properties": [
3340
+ {
3341
+ "name": "symbolSize",
3342
+ "description": "Diameter of each point in CSS pixels.",
3343
+ "value": {
3344
+ "type": "number",
3345
+ "kind": "expression"
3346
+ }
3347
+ },
3348
+ {
3349
+ "name": "largeThreshold",
3350
+ "description": "Point count at which the large rendering path takes effect.",
3351
+ "value": {
3352
+ "type": "number",
3353
+ "kind": "expression"
3354
+ }
3355
+ },
3356
+ {
3357
+ "name": "xField",
3358
+ "description": "Row field holding the x value; may be a dotted path. Defaults to the row index.",
3359
+ "value": {
3360
+ "type": "string",
3361
+ "kind": "expression"
3362
+ }
3363
+ },
3364
+ {
3365
+ "name": "labelField",
3366
+ "description": "Row field holding the category label, for charts that name their slices.",
3367
+ "value": {
3368
+ "type": "string",
3369
+ "kind": "expression"
3370
+ }
3371
+ },
3372
+ {
3373
+ "name": "xType",
3374
+ "description": "How x values are interpreted, which decides the axis and the tooltip format.",
3375
+ "value": {
3376
+ "type": "'time' | 'linear' | 'category'",
3377
+ "kind": "expression"
3378
+ }
3379
+ },
3380
+ {
3381
+ "name": "emptyMessage",
3382
+ "description": "Replaces the built-in \"no data\" text.",
3383
+ "value": {
3384
+ "type": "string",
3385
+ "kind": "expression"
3386
+ }
3387
+ },
3388
+ {
3389
+ "name": "maxPoints",
3390
+ "description": "Caps how many points a streaming chart keeps; older points fall off the front. `0` keeps everything.",
3391
+ "value": {
3392
+ "type": "number",
3393
+ "kind": "expression"
3394
+ }
3395
+ },
3396
+ {
3397
+ "name": "lazyRender",
3398
+ "description": "Defers loading the engine until the host first scrolls into view.",
3399
+ "value": {
3400
+ "type": "boolean",
3401
+ "kind": "expression"
3402
+ }
3403
+ }
3404
+ ],
3405
+ "events": [
3406
+ {
3407
+ "name": "tooltip-change",
3408
+ "description": "Fired with the complete tooltip model as the pointer moves, and with `null` when it leaves. Used by `c2-chart-tooltip`.",
3409
+ "value": {
3410
+ "type": "CustomEvent<ChartTooltipContext | null>",
3411
+ "kind": "expression"
3412
+ }
3413
+ },
3414
+ {
3415
+ "name": "series-toggle",
3416
+ "description": "Fired when a legend entry is toggled. Does not bubble.",
3417
+ "value": {
3418
+ "type": "CustomEvent<ChartSeriesToggleEventDetail>",
3419
+ "kind": "expression"
3420
+ }
3421
+ },
3422
+ {
3423
+ "name": "legend-change",
3424
+ "description": "Fired when legend entries or visibility change. Used by `c2-chart-legend`.",
3425
+ "value": {
3426
+ "type": "CustomEvent<ChartLegendChangeEventDetail>",
3427
+ "kind": "expression"
3428
+ }
3429
+ },
3430
+ {
3431
+ "name": "range-change",
3432
+ "description": "Fired after the user zooms or brushes. `detail.min` and `detail.max` are the new x bounds. Does not bubble.",
3433
+ "value": {
3434
+ "type": "CustomEvent<ChartRangeEventDetail>",
3435
+ "kind": "expression"
3436
+ }
3437
+ },
3438
+ {
3439
+ "name": "chart-ready",
3440
+ "description": "Fired after the engine has loaded and drawn for the first time. The host also gains `data-chart-ready`, which is what a test should wait on.",
3441
+ "value": {
3442
+ "type": "CustomEvent<{ engine: string }>",
3443
+ "kind": "expression"
3444
+ }
3445
+ },
3446
+ {
3447
+ "name": "chart-error",
3448
+ "description": "Fired when the engine fails to load or to draw. `detail.error` is the underlying failure.",
3449
+ "value": {
3450
+ "type": "CustomEvent<{ error: unknown }>",
3451
+ "kind": "expression"
3452
+ }
3453
+ },
3454
+ {
3455
+ "name": "point-hover",
3456
+ "description": "Fired as the pointer moves between data points, and with a `null` detail when it leaves the plot. Does not bubble.",
3457
+ "value": {
3458
+ "type": "CustomEvent<ChartPointEventDetail | null>",
3459
+ "kind": "expression"
3460
+ }
2304
3461
  },
2305
3462
  {
2306
3463
  "name": "point-click",
@@ -2588,6 +3745,14 @@
2588
3745
  }
2589
3746
  ],
2590
3747
  "events": [
3748
+ {
3749
+ "name": "tooltip-change",
3750
+ "description": "Fired with the complete tooltip model as the pointer moves, and with `null` when it leaves. Used by `c2-chart-tooltip`.",
3751
+ "value": {
3752
+ "type": "CustomEvent<ChartTooltipContext | null>",
3753
+ "kind": "expression"
3754
+ }
3755
+ },
2591
3756
  {
2592
3757
  "name": "series-toggle",
2593
3758
  "description": "Fired when a legend entry is toggled. Does not bubble.",
@@ -2596,6 +3761,14 @@
2596
3761
  "kind": "expression"
2597
3762
  }
2598
3763
  },
3764
+ {
3765
+ "name": "legend-change",
3766
+ "description": "Fired when legend entries or visibility change. Used by `c2-chart-legend`.",
3767
+ "value": {
3768
+ "type": "CustomEvent<ChartLegendChangeEventDetail>",
3769
+ "kind": "expression"
3770
+ }
3771
+ },
2599
3772
  {
2600
3773
  "name": "range-change",
2601
3774
  "description": "Fired after the user zooms or brushes. `detail.min` and `detail.max` are the new x bounds. Does not bubble.",
@@ -2624,7 +3797,7 @@
2624
3797
  "name": "point-hover",
2625
3798
  "description": "Fired as the pointer moves between data points, and with a `null` detail when it leaves the plot. Does not bubble.",
2626
3799
  "value": {
2627
- "type": "CustomEvent<ChartPointEventDetail>",
3800
+ "type": "CustomEvent<ChartPointEventDetail | null>",
2628
3801
  "kind": "expression"
2629
3802
  }
2630
3803
  },
@@ -3413,6 +4586,327 @@
3413
4586
  ]
3414
4587
  }
3415
4588
  },
4589
+ {
4590
+ "name": "c2-date-input",
4591
+ "description": "A form-associated single-date field backed by a native `<input type=\"date\">`. Values, `min` and `max` use local\ncalendar ISO strings (`YYYY-MM-DD`). The native picker and keyboard editing remain available while the component\nadds a consistent field, calendar affordance, helper text, error state and theming surface.\n\n`@c2n/date-input`",
4592
+ "attributes": [
4593
+ {
4594
+ "name": "value",
4595
+ "description": "Current date as a local-calendar `YYYY-MM-DD` string, or an empty string.",
4596
+ "default": "''",
4597
+ "value": {
4598
+ "type": "string",
4599
+ "kind": "expression"
4600
+ }
4601
+ },
4602
+ {
4603
+ "name": "min",
4604
+ "description": "Earliest selectable date as `YYYY-MM-DD`.",
4605
+ "default": "''",
4606
+ "value": {
4607
+ "type": "string",
4608
+ "kind": "expression"
4609
+ }
4610
+ },
4611
+ {
4612
+ "name": "max",
4613
+ "description": "Latest selectable date as `YYYY-MM-DD`.",
4614
+ "default": "''",
4615
+ "value": {
4616
+ "type": "string",
4617
+ "kind": "expression"
4618
+ }
4619
+ },
4620
+ {
4621
+ "name": "step",
4622
+ "description": "Number of days between valid dates.",
4623
+ "default": "1",
4624
+ "value": {
4625
+ "type": "number",
4626
+ "kind": "expression"
4627
+ }
4628
+ },
4629
+ {
4630
+ "name": "name",
4631
+ "description": "Form field name.",
4632
+ "default": "''",
4633
+ "value": {
4634
+ "type": "string",
4635
+ "kind": "expression"
4636
+ }
4637
+ },
4638
+ {
4639
+ "name": "autocomplete",
4640
+ "description": "Browser autocomplete hint, for example `bday`.",
4641
+ "default": "''",
4642
+ "value": {
4643
+ "type": "string",
4644
+ "kind": "expression"
4645
+ }
4646
+ },
4647
+ {
4648
+ "name": "required",
4649
+ "description": "Requires a date before the form can be submitted.",
4650
+ "default": "false",
4651
+ "value": {
4652
+ "type": "boolean",
4653
+ "kind": "expression"
4654
+ }
4655
+ },
4656
+ {
4657
+ "name": "readOnly",
4658
+ "description": "Prevents editing while keeping the value in form submission.",
4659
+ "default": "false",
4660
+ "value": {
4661
+ "type": "boolean",
4662
+ "kind": "expression"
4663
+ }
4664
+ },
4665
+ {
4666
+ "name": "disabled",
4667
+ "description": "Prevents interaction and excludes the value from form submission.",
4668
+ "default": "false",
4669
+ "value": {
4670
+ "type": "boolean",
4671
+ "kind": "expression"
4672
+ }
4673
+ },
4674
+ {
4675
+ "name": "error",
4676
+ "description": "Applies the visual error state and sets `aria-invalid`.",
4677
+ "default": "false",
4678
+ "value": {
4679
+ "type": "boolean",
4680
+ "kind": "expression"
4681
+ }
4682
+ },
4683
+ {
4684
+ "name": "help",
4685
+ "description": "Helper text shown below the field.",
4686
+ "default": "''",
4687
+ "value": {
4688
+ "type": "string",
4689
+ "kind": "expression"
4690
+ }
4691
+ },
4692
+ {
4693
+ "name": "error-text",
4694
+ "description": "Message shown below the field while `error` is set.",
4695
+ "default": "''",
4696
+ "value": {
4697
+ "type": "string",
4698
+ "kind": "expression"
4699
+ }
4700
+ },
4701
+ {
4702
+ "name": "aria-label",
4703
+ "description": "Accessible name forwarded to the native date input.",
4704
+ "default": "null",
4705
+ "value": {
4706
+ "type": "string | null",
4707
+ "kind": "expression"
4708
+ }
4709
+ }
4710
+ ],
4711
+ "js": {
4712
+ "properties": [
4713
+ {
4714
+ "name": "errorText",
4715
+ "description": "Message shown below the field while `error` is set.",
4716
+ "value": {
4717
+ "type": "string",
4718
+ "kind": "expression"
4719
+ }
4720
+ },
4721
+ {
4722
+ "name": "ariaLabel",
4723
+ "description": "Accessible name forwarded to the native date input.",
4724
+ "value": {
4725
+ "type": "string | null",
4726
+ "kind": "expression"
4727
+ }
4728
+ }
4729
+ ],
4730
+ "events": [
4731
+ {
4732
+ "name": "input",
4733
+ "description": "Re-dispatched from the inner date input whenever the value changes.",
4734
+ "value": {
4735
+ "type": "InputEvent",
4736
+ "kind": "expression"
4737
+ }
4738
+ },
4739
+ {
4740
+ "name": "change",
4741
+ "description": "Re-dispatched from the inner date input when the value is committed.",
4742
+ "value": {
4743
+ "type": "Event",
4744
+ "kind": "expression"
4745
+ }
4746
+ }
4747
+ ]
4748
+ }
4749
+ },
4750
+ {
4751
+ "name": "c2-date-selector",
4752
+ "description": "A keyboard-accessible date-range calendar inspired by travel booking pickers. It shows one or two consecutive\nmonths, starts a range on the first activation, completes it on the second, and starts over on the third. Dates are\nlocal-calendar ISO strings (`YYYY-MM-DD`), so they do not shift across time zones. Arrow keys move by day or week,\nHome/End move within the week, and Page Up/Page Down change month.\n\n`@c2n/date-selector`",
4753
+ "attributes": [
4754
+ {
4755
+ "name": "from",
4756
+ "description": "Start of the selected range as `YYYY-MM-DD`.",
4757
+ "default": "''",
4758
+ "value": {
4759
+ "type": "string",
4760
+ "kind": "expression"
4761
+ }
4762
+ },
4763
+ {
4764
+ "name": "to",
4765
+ "description": "End of the selected range as `YYYY-MM-DD`; empty while the range is incomplete.",
4766
+ "default": "''",
4767
+ "value": {
4768
+ "type": "string",
4769
+ "kind": "expression"
4770
+ }
4771
+ },
4772
+ {
4773
+ "name": "min",
4774
+ "description": "Earliest selectable date as `YYYY-MM-DD`.",
4775
+ "default": "''",
4776
+ "value": {
4777
+ "type": "string",
4778
+ "kind": "expression"
4779
+ }
4780
+ },
4781
+ {
4782
+ "name": "max",
4783
+ "description": "Latest selectable date as `YYYY-MM-DD`.",
4784
+ "default": "''",
4785
+ "value": {
4786
+ "type": "string",
4787
+ "kind": "expression"
4788
+ }
4789
+ },
4790
+ {
4791
+ "name": "locale",
4792
+ "description": "Locale used for month, weekday and accessible date labels. Defaults to the document language.",
4793
+ "default": "''",
4794
+ "value": {
4795
+ "type": "string",
4796
+ "kind": "expression"
4797
+ }
4798
+ },
4799
+ {
4800
+ "name": "week-start",
4801
+ "description": "First day of each calendar week.",
4802
+ "default": "'monday'",
4803
+ "value": {
4804
+ "type": "DateSelectorWeekStart",
4805
+ "kind": "expression"
4806
+ }
4807
+ },
4808
+ {
4809
+ "name": "months",
4810
+ "description": "Number of consecutive months shown; clamped to one or two.",
4811
+ "default": "2",
4812
+ "value": {
4813
+ "type": "number",
4814
+ "kind": "expression"
4815
+ }
4816
+ },
4817
+ {
4818
+ "name": "name",
4819
+ "description": "Form field name for the start date.",
4820
+ "default": "''",
4821
+ "value": {
4822
+ "type": "string",
4823
+ "kind": "expression"
4824
+ }
4825
+ },
4826
+ {
4827
+ "name": "end-name",
4828
+ "description": "Form field name for the end date. Defaults to `${name}-end`.",
4829
+ "default": "''",
4830
+ "value": {
4831
+ "type": "string",
4832
+ "kind": "expression"
4833
+ }
4834
+ },
4835
+ {
4836
+ "name": "required",
4837
+ "description": "Requires both endpoints when the selector participates in a form.",
4838
+ "default": "false",
4839
+ "value": {
4840
+ "type": "boolean",
4841
+ "kind": "expression"
4842
+ }
4843
+ },
4844
+ {
4845
+ "name": "disabled",
4846
+ "description": "Prevents navigation and selection and excludes the control from form submission.",
4847
+ "default": "false",
4848
+ "value": {
4849
+ "type": "boolean",
4850
+ "kind": "expression"
4851
+ }
4852
+ },
4853
+ {
4854
+ "name": "aria-label",
4855
+ "description": "Accessible name for the complete calendar.",
4856
+ "default": "'Choose a date range'",
4857
+ "value": {
4858
+ "type": "string | null",
4859
+ "kind": "expression"
4860
+ }
4861
+ }
4862
+ ],
4863
+ "js": {
4864
+ "properties": [
4865
+ {
4866
+ "name": "weekStart",
4867
+ "description": "First day of each calendar week.",
4868
+ "value": {
4869
+ "type": "DateSelectorWeekStart",
4870
+ "kind": "expression"
4871
+ }
4872
+ },
4873
+ {
4874
+ "name": "endName",
4875
+ "description": "Form field name for the end date. Defaults to `${name}-end`.",
4876
+ "value": {
4877
+ "type": "string",
4878
+ "kind": "expression"
4879
+ }
4880
+ },
4881
+ {
4882
+ "name": "ariaLabel",
4883
+ "description": "Accessible name for the complete calendar.",
4884
+ "value": {
4885
+ "type": "string | null",
4886
+ "kind": "expression"
4887
+ }
4888
+ }
4889
+ ],
4890
+ "events": [
4891
+ {
4892
+ "name": "input",
4893
+ "description": "Fired after either endpoint changes, with `from` and `to` already updated.",
4894
+ "value": {
4895
+ "type": "Event",
4896
+ "kind": "expression"
4897
+ }
4898
+ },
4899
+ {
4900
+ "name": "change",
4901
+ "description": "Fired with `input`; `detail` contains the ISO `from` and `to` values.",
4902
+ "value": {
4903
+ "type": "CustomEvent<DateRangeChangeDetail>",
4904
+ "kind": "expression"
4905
+ }
4906
+ }
4907
+ ]
4908
+ }
4909
+ },
3416
4910
  {
3417
4911
  "name": "c2-details",
3418
4912
  "description": "Collapsible disclosure built on native `<details>` / `<summary>`, so keyboard access, screen-reader semantics and\nfind-in-page auto-expand come from the browser. Panels that share a `name` form an exclusive accordion. Open and\nclose animate the content height (plus a fade) with the Web Animations API, so the motion is identical in every\nbrowser; the native `open` attribute is only removed once the close animation has finished.\n\n`@c2n/details`",
@@ -7282,6 +8776,191 @@
7282
8776
  "events": []
7283
8777
  }
7284
8778
  },
8779
+ {
8780
+ "name": "c2-number-input",
8781
+ "description": "A form-associated number field backed by a native `<input type=\"number\">`. It keeps native decimal parsing,\nvalidation and Arrow Up/Down behavior, replaces browser-specific spinners with themeable decrement/increment\ncontrols, and supports prefix/suffix adornments, helper text and an error state.\n\n`@c2n/number-input`",
8782
+ "attributes": [
8783
+ {
8784
+ "name": "value",
8785
+ "description": "Current numeric text, or an empty string. Use `valueAsNumber` for a parsed value.",
8786
+ "default": "''",
8787
+ "value": {
8788
+ "type": "string",
8789
+ "kind": "expression"
8790
+ }
8791
+ },
8792
+ {
8793
+ "name": "min",
8794
+ "description": "Minimum valid value.",
8795
+ "value": {
8796
+ "type": "number | undefined",
8797
+ "kind": "expression"
8798
+ }
8799
+ },
8800
+ {
8801
+ "name": "max",
8802
+ "description": "Maximum valid value.",
8803
+ "value": {
8804
+ "type": "number | undefined",
8805
+ "kind": "expression"
8806
+ }
8807
+ },
8808
+ {
8809
+ "name": "step",
8810
+ "description": "Increment used by Arrow keys and the step controls, or `any` to disable step controls.",
8811
+ "default": "'1'",
8812
+ "value": {
8813
+ "type": "string",
8814
+ "kind": "expression"
8815
+ }
8816
+ },
8817
+ {
8818
+ "name": "name",
8819
+ "description": "Form field name.",
8820
+ "default": "''",
8821
+ "value": {
8822
+ "type": "string",
8823
+ "kind": "expression"
8824
+ }
8825
+ },
8826
+ {
8827
+ "name": "autocomplete",
8828
+ "description": "Browser autocomplete hint.",
8829
+ "default": "''",
8830
+ "value": {
8831
+ "type": "string",
8832
+ "kind": "expression"
8833
+ }
8834
+ },
8835
+ {
8836
+ "name": "placeholder",
8837
+ "description": "Text shown while the field is empty.",
8838
+ "default": "''",
8839
+ "value": {
8840
+ "type": "string",
8841
+ "kind": "expression"
8842
+ }
8843
+ },
8844
+ {
8845
+ "name": "required",
8846
+ "description": "Requires a number before the form can be submitted.",
8847
+ "default": "false",
8848
+ "value": {
8849
+ "type": "boolean",
8850
+ "kind": "expression"
8851
+ }
8852
+ },
8853
+ {
8854
+ "name": "readOnly",
8855
+ "description": "Prevents editing while keeping the value in form submission.",
8856
+ "default": "false",
8857
+ "value": {
8858
+ "type": "boolean",
8859
+ "kind": "expression"
8860
+ }
8861
+ },
8862
+ {
8863
+ "name": "disabled",
8864
+ "description": "Prevents interaction and excludes the value from form submission.",
8865
+ "default": "false",
8866
+ "value": {
8867
+ "type": "boolean",
8868
+ "kind": "expression"
8869
+ }
8870
+ },
8871
+ {
8872
+ "name": "hide-steppers",
8873
+ "description": "Hides the decrement and increment controls.",
8874
+ "default": "false",
8875
+ "value": {
8876
+ "type": "boolean",
8877
+ "kind": "expression"
8878
+ }
8879
+ },
8880
+ {
8881
+ "name": "error",
8882
+ "description": "Applies the visual error state and sets `aria-invalid`.",
8883
+ "default": "false",
8884
+ "value": {
8885
+ "type": "boolean",
8886
+ "kind": "expression"
8887
+ }
8888
+ },
8889
+ {
8890
+ "name": "help",
8891
+ "description": "Helper text shown below the field.",
8892
+ "default": "''",
8893
+ "value": {
8894
+ "type": "string",
8895
+ "kind": "expression"
8896
+ }
8897
+ },
8898
+ {
8899
+ "name": "error-text",
8900
+ "description": "Message shown below the field while `error` is set.",
8901
+ "default": "''",
8902
+ "value": {
8903
+ "type": "string",
8904
+ "kind": "expression"
8905
+ }
8906
+ },
8907
+ {
8908
+ "name": "aria-label",
8909
+ "description": "Accessible name forwarded to the native number input.",
8910
+ "default": "null",
8911
+ "value": {
8912
+ "type": "string | null",
8913
+ "kind": "expression"
8914
+ }
8915
+ }
8916
+ ],
8917
+ "js": {
8918
+ "properties": [
8919
+ {
8920
+ "name": "hideSteppers",
8921
+ "description": "Hides the decrement and increment controls.",
8922
+ "value": {
8923
+ "type": "boolean",
8924
+ "kind": "expression"
8925
+ }
8926
+ },
8927
+ {
8928
+ "name": "errorText",
8929
+ "description": "Message shown below the field while `error` is set.",
8930
+ "value": {
8931
+ "type": "string",
8932
+ "kind": "expression"
8933
+ }
8934
+ },
8935
+ {
8936
+ "name": "ariaLabel",
8937
+ "description": "Accessible name forwarded to the native number input.",
8938
+ "value": {
8939
+ "type": "string | null",
8940
+ "kind": "expression"
8941
+ }
8942
+ }
8943
+ ],
8944
+ "events": [
8945
+ {
8946
+ "name": "input",
8947
+ "description": "Re-dispatched when typing or stepping changes the value.",
8948
+ "value": {
8949
+ "type": "InputEvent",
8950
+ "kind": "expression"
8951
+ }
8952
+ },
8953
+ {
8954
+ "name": "change",
8955
+ "description": "Re-dispatched when a typed value is committed or a step control changes the value.",
8956
+ "value": {
8957
+ "type": "Event",
8958
+ "kind": "expression"
8959
+ }
8960
+ }
8961
+ ]
8962
+ }
8963
+ },
7285
8964
  {
7286
8965
  "name": "c2-overlay",
7287
8966
  "description": "Anchored popup built on the browser Popover API: the element sits in the top layer, opens and light-dismisses\nnatively (Escape, click outside) and is positioned next to its anchor with floating-ui. The anchor is found in\nthis order: the `anchor` property (an element), the `anchor` attribute (an element id in the same tree), or the\nelement whose `popovertarget` points at this overlay's `id`. The overlay only positions itself; the content brings\nits own surface (background, border, shadow), so it fits menus, pickers and cards alike.\n\n`@c2n/overlay`",
@@ -37736,6 +39415,42 @@
37736
39415
  "kind": "expression"
37737
39416
  }
37738
39417
  },
39418
+ {
39419
+ "name": "animate-updates",
39420
+ "description": "Smoothly interpolates changed finite numbers when `rows` is replaced. Rows are matched by `row-key`, or by index.",
39421
+ "default": "false",
39422
+ "value": {
39423
+ "type": "boolean",
39424
+ "kind": "expression"
39425
+ }
39426
+ },
39427
+ {
39428
+ "name": "update-duration",
39429
+ "description": "Duration of an animated rows update in milliseconds.",
39430
+ "default": "400",
39431
+ "value": {
39432
+ "type": "number",
39433
+ "kind": "expression"
39434
+ }
39435
+ },
39436
+ {
39437
+ "name": "highlight-updates",
39438
+ "description": "Pulses changed row backgrounds: green for additions/increases, red for removals/decreases, blue otherwise.",
39439
+ "default": "false",
39440
+ "value": {
39441
+ "type": "boolean",
39442
+ "kind": "expression"
39443
+ }
39444
+ },
39445
+ {
39446
+ "name": "update-highlight-field",
39447
+ "description": "Numeric field that determines whether a modified row highlights as increased or decreased. Defaults to its first changed number.",
39448
+ "default": "''",
39449
+ "value": {
39450
+ "type": "string",
39451
+ "kind": "expression"
39452
+ }
39453
+ },
37739
39454
  {
37740
39455
  "name": "virtual",
37741
39456
  "description": "`auto` virtualizes past `virtual-threshold` rows; `always` and `never` force it.",
@@ -37861,6 +39576,38 @@
37861
39576
  "kind": "expression"
37862
39577
  }
37863
39578
  },
39579
+ {
39580
+ "name": "animateUpdates",
39581
+ "description": "Smoothly interpolates changed finite numbers when `rows` is replaced. Rows are matched by `row-key`, or by index.",
39582
+ "value": {
39583
+ "type": "boolean",
39584
+ "kind": "expression"
39585
+ }
39586
+ },
39587
+ {
39588
+ "name": "updateDuration",
39589
+ "description": "Duration of an animated rows update in milliseconds.",
39590
+ "value": {
39591
+ "type": "number",
39592
+ "kind": "expression"
39593
+ }
39594
+ },
39595
+ {
39596
+ "name": "highlightUpdates",
39597
+ "description": "Pulses changed row backgrounds: green for additions/increases, red for removals/decreases, blue otherwise.",
39598
+ "value": {
39599
+ "type": "boolean",
39600
+ "kind": "expression"
39601
+ }
39602
+ },
39603
+ {
39604
+ "name": "updateHighlightField",
39605
+ "description": "Numeric field that determines whether a modified row highlights as increased or decreased. Defaults to its first changed number.",
39606
+ "value": {
39607
+ "type": "string",
39608
+ "kind": "expression"
39609
+ }
39610
+ },
37864
39611
  {
37865
39612
  "name": "rowHeight",
37866
39613
  "description": "Row height in pixels used before the first row has been measured.",