@loworbitstudio/visor 1.45.1 → 1.49.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/CHANGELOG.json +25 -1
- package/dist/index.js +43 -5
- package/dist/registry.json +143 -7
- package/dist/visor-manifest.json +550 -30
- package/package.json +2 -2
package/dist/visor-manifest.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": "0.4.0",
|
|
3
|
-
"generated_at": "2026-11-
|
|
3
|
+
"generated_at": "2026-11-14T00:04:31.498Z",
|
|
4
4
|
"components": {
|
|
5
5
|
"accessibility-specimen": {
|
|
6
6
|
"category": "specimen",
|
|
@@ -915,6 +915,173 @@
|
|
|
915
915
|
],
|
|
916
916
|
"example": "<BentoGrid cols={{ base: 1, md: 2 }} gap=\"4\">\n <BentoTile span=\"full\" aspect=\"21/9\">\n <BentoTileMedia src=\"/projects/knowmentum.jpg\" alt=\"Knowmentum project hero\" />\n <BentoTileBody>\n <h3>Knowmentum</h3>\n <p>Knowledge platform for high-performers.</p>\n </BentoTileBody>\n </BentoTile>\n\n <BentoTile span=\"half\" aspect=\"2/1\" href=\"https://animal.nyc/\" target=\"_blank\">\n <BentoTileMedia src=\"/projects/animal-nyc.jpg\" alt=\"Animal NYC\" />\n <BentoTileBody>\n <h3>Animal NYC</h3>\n </BentoTileBody>\n </BentoTile>\n\n <BentoTile span=\"half\" aspect=\"2/1\" href=\"https://animal.la/\" target=\"_blank\">\n <BentoTileMedia src=\"/projects/animal-la.jpg\" alt=\"Animal LA\" />\n <BentoTileBody>\n <h3>Animal LA</h3>\n </BentoTileBody>\n </BentoTile>\n\n <BentoTile span=\"half\" aspect=\"4/3\" fit=\"contain\">\n <BentoTileMedia src=\"/logos/client-logo.png\" alt=\"Client logo\" />\n <BentoTileBody>\n <p>Natural-fit logo tile</p>\n </BentoTileBody>\n </BentoTile>\n</BentoGrid>\n"
|
|
917
917
|
},
|
|
918
|
+
"billing-slider": {
|
|
919
|
+
"category": "form",
|
|
920
|
+
"description": "A range slider for how many hours a package bills. The track starts at a floor, carries marks as notches, stripes past the high, draws worked, agent and proposed hours along its foot with a tick at the evidence, stripes the gap between the thumb and that tick, and ends at a computed maximum.",
|
|
921
|
+
"when_to_use": [
|
|
922
|
+
"Choosing how many hours a by-estimate package bills, between its signed low and what the ceiling allows",
|
|
923
|
+
"An amount the operator sets against evidence, where the evidence should sit on the track itself",
|
|
924
|
+
"A range with a soft limit inside it (a package's high) that the value may pass with a reason",
|
|
925
|
+
"Showing money at stake between what something bills and what was worked"
|
|
926
|
+
],
|
|
927
|
+
"when_not_to_use": [
|
|
928
|
+
"A plain numeric value or a two-thumb range (use Slider)",
|
|
929
|
+
"A slider with a label and a value readout and nothing else (use SliderControl)",
|
|
930
|
+
"Use against a limit that nobody edits (use Meter)",
|
|
931
|
+
"Typing an exact number (use NumberInput)"
|
|
932
|
+
],
|
|
933
|
+
"variants": {
|
|
934
|
+
"size": [
|
|
935
|
+
"md",
|
|
936
|
+
"lg"
|
|
937
|
+
],
|
|
938
|
+
"status": [
|
|
939
|
+
"saving",
|
|
940
|
+
"failed"
|
|
941
|
+
]
|
|
942
|
+
},
|
|
943
|
+
"props": [
|
|
944
|
+
{
|
|
945
|
+
"name": "value",
|
|
946
|
+
"type": "number",
|
|
947
|
+
"required": true,
|
|
948
|
+
"description": "What it bills. Controlled."
|
|
949
|
+
},
|
|
950
|
+
{
|
|
951
|
+
"name": "onValueChange",
|
|
952
|
+
"type": "(value: number) => void",
|
|
953
|
+
"required": true,
|
|
954
|
+
"description": "Called while dragging and on every key step."
|
|
955
|
+
},
|
|
956
|
+
{
|
|
957
|
+
"name": "onValueCommit",
|
|
958
|
+
"type": "(value: number) => void",
|
|
959
|
+
"description": "Enter, or releasing the thumb after a drag. Arrow keys never commit."
|
|
960
|
+
},
|
|
961
|
+
{
|
|
962
|
+
"name": "savedValue",
|
|
963
|
+
"type": "number",
|
|
964
|
+
"description": "The last saved value. Escape returns the thumb here."
|
|
965
|
+
},
|
|
966
|
+
{
|
|
967
|
+
"name": "min",
|
|
968
|
+
"type": "number",
|
|
969
|
+
"required": true,
|
|
970
|
+
"description": "The floor. Nothing below it."
|
|
971
|
+
},
|
|
972
|
+
{
|
|
973
|
+
"name": "max",
|
|
974
|
+
"type": "number",
|
|
975
|
+
"required": true,
|
|
976
|
+
"description": "The track's end, computed by the caller."
|
|
977
|
+
},
|
|
978
|
+
{
|
|
979
|
+
"name": "step",
|
|
980
|
+
"type": "number",
|
|
981
|
+
"default": "0.25",
|
|
982
|
+
"description": "The arrow step. Shift + arrows step four times it (an hour)."
|
|
983
|
+
},
|
|
984
|
+
{
|
|
985
|
+
"name": "marks",
|
|
986
|
+
"type": "{ value: number; label?: ReactNode; hatchPast?: boolean }[]",
|
|
987
|
+
"default": "[]",
|
|
988
|
+
"description": "Notches across the track with their text in the labels row. Past the mark with `hatchPast` the filled range stripes."
|
|
989
|
+
},
|
|
990
|
+
{
|
|
991
|
+
"name": "evidence",
|
|
992
|
+
"type": "{ value: number; agent?: number; proposed?: number }",
|
|
993
|
+
"description": "Worked hours as a solid strip along the foot with a tick at the end. `agent` extends it dotted and moves the tick; `proposed` extends it pale with a dashed tick. A tick past max becomes an arrow at the end."
|
|
994
|
+
},
|
|
995
|
+
{
|
|
996
|
+
"name": "gap",
|
|
997
|
+
"type": "boolean",
|
|
998
|
+
"default": "false",
|
|
999
|
+
"description": "Stripe the gap between the thumb and the evidence tick, in --billing-slider-gap-color."
|
|
1000
|
+
},
|
|
1001
|
+
{
|
|
1002
|
+
"name": "hue",
|
|
1003
|
+
"type": "number",
|
|
1004
|
+
"description": "A Paper project-hue angle (75 to 339). Reads --paper-hue-<angle>-fill-strong and -ink."
|
|
1005
|
+
},
|
|
1006
|
+
{
|
|
1007
|
+
"name": "size",
|
|
1008
|
+
"type": "\"md\" | \"lg\"",
|
|
1009
|
+
"default": "\"md\"",
|
|
1010
|
+
"description": "\"md\" is the 40px row track; \"lg\" is the 56px hero track."
|
|
1011
|
+
},
|
|
1012
|
+
{
|
|
1013
|
+
"name": "status",
|
|
1014
|
+
"type": "\"saving\" | \"failed\"",
|
|
1015
|
+
"description": "\"saving\" pulses the thumb. On \"failed\" put value back to savedValue."
|
|
1016
|
+
},
|
|
1017
|
+
{
|
|
1018
|
+
"name": "disabled",
|
|
1019
|
+
"type": "boolean",
|
|
1020
|
+
"default": "false"
|
|
1021
|
+
},
|
|
1022
|
+
{
|
|
1023
|
+
"name": "formatValue",
|
|
1024
|
+
"type": "(value: number) => string",
|
|
1025
|
+
"description": "Formats a value for the bubble and the labels row."
|
|
1026
|
+
},
|
|
1027
|
+
{
|
|
1028
|
+
"name": "valueText",
|
|
1029
|
+
"type": "(value: number) => string",
|
|
1030
|
+
"description": "aria-valuetext, the formatted value and its amount. Defaults to formatValue."
|
|
1031
|
+
},
|
|
1032
|
+
{
|
|
1033
|
+
"name": "minLabel",
|
|
1034
|
+
"type": "ReactNode",
|
|
1035
|
+
"description": "Text before the floor's value (\"Low\")."
|
|
1036
|
+
},
|
|
1037
|
+
{
|
|
1038
|
+
"name": "maxLabel",
|
|
1039
|
+
"type": "ReactNode",
|
|
1040
|
+
"description": "Text before the end's value (\"Ceiling allows\")."
|
|
1041
|
+
}
|
|
1042
|
+
],
|
|
1043
|
+
"dependencies": [
|
|
1044
|
+
"@radix-ui/react-slider"
|
|
1045
|
+
],
|
|
1046
|
+
"tokens_used": [
|
|
1047
|
+
"--_fill",
|
|
1048
|
+
"--_foot-h",
|
|
1049
|
+
"--_gap",
|
|
1050
|
+
"--_grip-inset",
|
|
1051
|
+
"--_hatch",
|
|
1052
|
+
"--_ink",
|
|
1053
|
+
"--_rail-h",
|
|
1054
|
+
"--_rail-r",
|
|
1055
|
+
"--_ring",
|
|
1056
|
+
"--_thumb-h",
|
|
1057
|
+
"--_thumb-w",
|
|
1058
|
+
"--billing-slider-gap-color",
|
|
1059
|
+
"--billing-slider-hue-fill-strong",
|
|
1060
|
+
"--billing-slider-hue-ink",
|
|
1061
|
+
"--billing-slider-thumb-bg",
|
|
1062
|
+
"--billing-slider-thumb-grip",
|
|
1063
|
+
"--billing-slider-track-bg",
|
|
1064
|
+
"--border-focus",
|
|
1065
|
+
"--color-success-600",
|
|
1066
|
+
"--focus-ring-offset",
|
|
1067
|
+
"--focus-ring-width",
|
|
1068
|
+
"--font-size-xs",
|
|
1069
|
+
"--font-weight-bold",
|
|
1070
|
+
"--font-weight-medium",
|
|
1071
|
+
"--motion-duration-1000",
|
|
1072
|
+
"--motion-duration-150",
|
|
1073
|
+
"--motion-easing-default",
|
|
1074
|
+
"--shadow-md",
|
|
1075
|
+
"--spacing-1",
|
|
1076
|
+
"--spacing-2",
|
|
1077
|
+
"--surface-interactive-active",
|
|
1078
|
+
"--surface-page",
|
|
1079
|
+
"--surface-popover",
|
|
1080
|
+
"--text-primary",
|
|
1081
|
+
"--text-secondary"
|
|
1082
|
+
],
|
|
1083
|
+
"example": "<BillingSlider\n aria-label=\"Hours Website embeds bills\"\n value={hours}\n onValueChange={setHours}\n onValueCommit={save}\n savedValue={saved}\n min={8}\n max={16.75}\n hue={339}\n marks={[{ value: 10, label: \"High\", hatchPast: true }]}\n evidence={{ value: 10.5, agent: 3 }}\n gap\n minLabel=\"Low\"\n maxLabel=\"Ceiling allows\"\n formatValue={(h) => `${h} h`}\n valueText={(h) => `Bills ${h} h, $${h * 120}`}\n/>\n"
|
|
1084
|
+
},
|
|
918
1085
|
"bottom-nav": {
|
|
919
1086
|
"category": "navigation",
|
|
920
1087
|
"description": "A bottom navigation bar of icon destinations for phone widths. Filled active destination, an optional unread mark, a hairline group break, safe-area padding, and its height published as --bottom-nav-height.",
|
|
@@ -5723,7 +5890,9 @@
|
|
|
5723
5890
|
"variants": {
|
|
5724
5891
|
"state": {
|
|
5725
5892
|
"rest": "The text (or the muted default), then the pencil. No edge.",
|
|
5726
|
-
"editing": "A single-line input in the text's place, at the same size, drawing the shared control edge."
|
|
5893
|
+
"editing": "A single-line input in the text's place, at the same size, drawing the shared control edge.",
|
|
5894
|
+
"saving": "onCommit returned a promise that has not settled. The root carries aria-busy, the input is read-only and its text drops to --text-secondary.",
|
|
5895
|
+
"error": "The save rejected or resolved to `{ error }`. The message shows under the field (role=\"alert\", read like FieldError), the input draws the error edge and keeps the typed text, and Enter retries."
|
|
5727
5896
|
}
|
|
5728
5897
|
},
|
|
5729
5898
|
"props": [
|
|
@@ -5740,8 +5909,8 @@
|
|
|
5740
5909
|
},
|
|
5741
5910
|
{
|
|
5742
5911
|
"name": "onCommit",
|
|
5743
|
-
"type": "(value: string) => void",
|
|
5744
|
-
"description": "Called with the trimmed text on Enter, blur or Tab, only when it differs from `value`. An empty string means \"restore the default\". The parent updates `value`."
|
|
5912
|
+
"type": "(value: string) => void | Promise<unknown>",
|
|
5913
|
+
"description": "Called with the trimmed text on Enter, blur or Tab, only when it differs from `value`. An empty string means \"restore the default\". The parent updates `value`. Return a promise (a server action) to save asynchronously - the field stays open and busy until it settles. If it rejects, or resolves to `{ error: string }`, the message shows under the field, the typed text stays, and Enter retries; Escape gives up and restores `value`."
|
|
5745
5914
|
},
|
|
5746
5915
|
{
|
|
5747
5916
|
"name": "label",
|
|
@@ -5778,6 +5947,7 @@
|
|
|
5778
5947
|
],
|
|
5779
5948
|
"tokens_used": [
|
|
5780
5949
|
"--border-default",
|
|
5950
|
+
"--border-error",
|
|
5781
5951
|
"--border-focus",
|
|
5782
5952
|
"--button-icon-ghost-color",
|
|
5783
5953
|
"--button-icon-pad",
|
|
@@ -5785,16 +5955,21 @@
|
|
|
5785
5955
|
"--control-edge-color",
|
|
5786
5956
|
"--control-edge-style",
|
|
5787
5957
|
"--control-edge-width",
|
|
5958
|
+
"--control-invalid-ring-color",
|
|
5788
5959
|
"--control-state-edge-width",
|
|
5789
5960
|
"--focus-ring-offset",
|
|
5790
5961
|
"--focus-ring-width",
|
|
5962
|
+
"--font-size-sm",
|
|
5963
|
+
"--font-weight-normal",
|
|
5791
5964
|
"--inline-edit-underline-style",
|
|
5965
|
+
"--line-height-normal",
|
|
5792
5966
|
"--motion-duration-150",
|
|
5793
5967
|
"--motion-easing-default",
|
|
5794
5968
|
"--radius-sm",
|
|
5795
5969
|
"--spacing-1",
|
|
5796
5970
|
"--spacing-2",
|
|
5797
5971
|
"--stroke-width-thin",
|
|
5972
|
+
"--text-error",
|
|
5798
5973
|
"--text-primary",
|
|
5799
5974
|
"--text-secondary",
|
|
5800
5975
|
"--text-tertiary"
|
|
@@ -6077,6 +6252,127 @@
|
|
|
6077
6252
|
],
|
|
6078
6253
|
"example": "<Label htmlFor=\"email\">Email address</Label>\n<Input id=\"email\" type=\"email\" />\n"
|
|
6079
6254
|
},
|
|
6255
|
+
"layer-chart": {
|
|
6256
|
+
"category": "data-display",
|
|
6257
|
+
"description": "A zoomable icicle that opens a tree layer by layer. Rows are layers; clicking a block grows it to full width and opens its children below it, animated. One hue per top-level node, lighter by depth, with solid, covered, not-billable, unresolved and today fills. SpanStrip draws a day's 5-minute spans in lanes on a time axis, the layer below the last.",
|
|
6258
|
+
"when_to_use": [
|
|
6259
|
+
"Hours or money broken down layer by layer (all clients, client, engagement, package, ticket, day) where the order of the layers matters",
|
|
6260
|
+
"Drilling into one branch of a deep tree while the path above it stays in view",
|
|
6261
|
+
"Showing what share of a parent each child takes, with thin children still clickable",
|
|
6262
|
+
"Re-measuring the same tree in a second measure (hours, then money) without changing its shapes",
|
|
6263
|
+
"A day's time in 5-minute cells per lane (SpanStrip), opened from the day layer"
|
|
6264
|
+
],
|
|
6265
|
+
"when_not_to_use": [
|
|
6266
|
+
"A flat list of parts that add up to a whole (use a stacked bar or ProportionBar)",
|
|
6267
|
+
"Use against a limit (use Meter)",
|
|
6268
|
+
"Trends over time (use Chart)",
|
|
6269
|
+
"A tree where sizes do not matter, only structure (use a tree view or nested list)"
|
|
6270
|
+
],
|
|
6271
|
+
"variants": {
|
|
6272
|
+
"kind": [
|
|
6273
|
+
"solid",
|
|
6274
|
+
"covered",
|
|
6275
|
+
"not-billable",
|
|
6276
|
+
"unresolved"
|
|
6277
|
+
]
|
|
6278
|
+
},
|
|
6279
|
+
"props": [
|
|
6280
|
+
{
|
|
6281
|
+
"name": "data",
|
|
6282
|
+
"type": "LayerNode",
|
|
6283
|
+
"description": "The tree. Each node has an id, a name, and optionally ref, layer, value, hue, kind, today, sub and children."
|
|
6284
|
+
},
|
|
6285
|
+
{
|
|
6286
|
+
"name": "measure",
|
|
6287
|
+
"type": "(node: LayerNode) => number | undefined",
|
|
6288
|
+
"default": "(node) => node.value",
|
|
6289
|
+
"description": "Reads a node's value in the current measure. Undefined on a parent sums its children; zero leaves the chart."
|
|
6290
|
+
},
|
|
6291
|
+
{
|
|
6292
|
+
"name": "focusId",
|
|
6293
|
+
"type": "string",
|
|
6294
|
+
"description": "The open block (controlled)."
|
|
6295
|
+
},
|
|
6296
|
+
{
|
|
6297
|
+
"name": "defaultFocusId",
|
|
6298
|
+
"type": "string",
|
|
6299
|
+
"description": "The block open at first (uncontrolled). Defaults to the root."
|
|
6300
|
+
},
|
|
6301
|
+
{
|
|
6302
|
+
"name": "onFocusChange",
|
|
6303
|
+
"type": "(id: string, node: LayerNode, reason: 'open' | 'up' | 'more') => void",
|
|
6304
|
+
"description": "Called when a block opens, by a click, Enter, Esc (up a layer) or a \"+n\" block (opens its parent)."
|
|
6305
|
+
},
|
|
6306
|
+
{
|
|
6307
|
+
"name": "format",
|
|
6308
|
+
"type": "(value: number, info: { node: LayerNode; short: boolean }) => string",
|
|
6309
|
+
"description": "Formats a value. short is the number alone, for thin blocks."
|
|
6310
|
+
},
|
|
6311
|
+
{
|
|
6312
|
+
"name": "renderBlock",
|
|
6313
|
+
"type": "(node: LayerNode, info: { role, width }) => ReactNode",
|
|
6314
|
+
"description": "Content drawn at the foot of a wide block one or two layers down, such as an estimate Meter in a package block."
|
|
6315
|
+
},
|
|
6316
|
+
{
|
|
6317
|
+
"name": "renderCard",
|
|
6318
|
+
"type": "(node: LayerNode, info: { value, share, more }) => ReactNode",
|
|
6319
|
+
"description": "The hover card's content. Defaults to the name, the layer, the value and the share of the parent."
|
|
6320
|
+
},
|
|
6321
|
+
{
|
|
6322
|
+
"name": "band",
|
|
6323
|
+
"type": "{ value: (node) => number | undefined; label?: string; format?: (v) => string; note?: (layer) => ReactNode }",
|
|
6324
|
+
"description": "An optional paler band under the rows where it is measured (agent time), with a one-line note where it is not."
|
|
6325
|
+
}
|
|
6326
|
+
],
|
|
6327
|
+
"dependencies": [],
|
|
6328
|
+
"tokens_used": [
|
|
6329
|
+
"--_c",
|
|
6330
|
+
"--_dur",
|
|
6331
|
+
"--_ease",
|
|
6332
|
+
"--_ground",
|
|
6333
|
+
"--_hf",
|
|
6334
|
+
"--_hfs",
|
|
6335
|
+
"--_hi",
|
|
6336
|
+
"--_hs",
|
|
6337
|
+
"--_segment",
|
|
6338
|
+
"--border-focus",
|
|
6339
|
+
"--color-error-500",
|
|
6340
|
+
"--focus-ring-offset",
|
|
6341
|
+
"--focus-ring-width",
|
|
6342
|
+
"--font-weight-bold",
|
|
6343
|
+
"--font-weight-medium",
|
|
6344
|
+
"--font-weight-semibold",
|
|
6345
|
+
"--layer-chart-alert-fill",
|
|
6346
|
+
"--layer-chart-alert-text",
|
|
6347
|
+
"--layer-chart-duration",
|
|
6348
|
+
"--layer-chart-easing",
|
|
6349
|
+
"--layer-chart-ground",
|
|
6350
|
+
"--layer-chart-investment-fill",
|
|
6351
|
+
"--layer-chart-investment-fill-strong",
|
|
6352
|
+
"--layer-chart-investment-ink",
|
|
6353
|
+
"--layer-chart-investment-solid",
|
|
6354
|
+
"--layer-hue-fill",
|
|
6355
|
+
"--layer-hue-fill-strong",
|
|
6356
|
+
"--layer-hue-ink",
|
|
6357
|
+
"--layer-hue-solid",
|
|
6358
|
+
"--paper-track-label",
|
|
6359
|
+
"--paper-track-tight",
|
|
6360
|
+
"--shadow-lg",
|
|
6361
|
+
"--spacing-1",
|
|
6362
|
+
"--spacing-2",
|
|
6363
|
+
"--spacing-3",
|
|
6364
|
+
"--spacing-4",
|
|
6365
|
+
"--surface-card",
|
|
6366
|
+
"--surface-interactive-active",
|
|
6367
|
+
"--surface-muted",
|
|
6368
|
+
"--surface-page",
|
|
6369
|
+
"--surface-popover",
|
|
6370
|
+
"--text-error",
|
|
6371
|
+
"--text-primary",
|
|
6372
|
+
"--text-secondary"
|
|
6373
|
+
],
|
|
6374
|
+
"example": "<LayerChart\n data={tree}\n measure={(n) => (mode === \"money\" ? n.money : n.hours)}\n focusId={focus}\n onFocusChange={(id) => setFocus(id)}\n format={(v) => `${v} h`}\n/>\n"
|
|
6375
|
+
},
|
|
6080
6376
|
"lightbox": {
|
|
6081
6377
|
"category": "media",
|
|
6082
6378
|
"description": "A full-screen image viewer with gallery navigation, keyboard and touch support, built on Radix Dialog.",
|
|
@@ -6454,6 +6750,117 @@
|
|
|
6454
6750
|
],
|
|
6455
6751
|
"example": "<Menubar>\n <MenubarMenu>\n <MenubarTrigger>File</MenubarTrigger>\n <MenubarContent>\n <MenubarItem>New <MenubarShortcut>Cmd+N</MenubarShortcut></MenubarItem>\n <MenubarItem>Open <MenubarShortcut>Cmd+O</MenubarShortcut></MenubarItem>\n <MenubarSeparator />\n <MenubarItem>Save <MenubarShortcut>Cmd+S</MenubarShortcut></MenubarItem>\n </MenubarContent>\n </MenubarMenu>\n</Menubar>\n"
|
|
6456
6752
|
},
|
|
6753
|
+
"meter": {
|
|
6754
|
+
"category": "data-display",
|
|
6755
|
+
"description": "A thin meter for use against a limit. The track is a hue's tint, the fill its ink, ticks mark a heads-up threshold and a ceiling, and a one-line label sits under it. The contract size adds zones (up to the low, hatched to the high), mark text and striped use past the limit.",
|
|
6756
|
+
"when_to_use": [
|
|
6757
|
+
"Hours used against a contract's ceiling, with a tick at the heads-up point (usually 80%)",
|
|
6758
|
+
"One compact meter per row in a list of clients or accounts",
|
|
6759
|
+
"A full contract meter with the low and high totals as zones and labelled marks",
|
|
6760
|
+
"A retainer month against its included hours, with billable overage striped in ink",
|
|
6761
|
+
"Quota or plan usage where crossing a threshold matters more than the exact percentage"
|
|
6762
|
+
],
|
|
6763
|
+
"when_not_to_use": [
|
|
6764
|
+
"Task completion or upload progress (use Progress)",
|
|
6765
|
+
"Discrete steps (use SegmentedProgress or Stepper)",
|
|
6766
|
+
"Parts of a whole that add up to 100% (use a stacked bar or chart)",
|
|
6767
|
+
"An editable amount (use Slider)"
|
|
6768
|
+
],
|
|
6769
|
+
"variants": {
|
|
6770
|
+
"size": [
|
|
6771
|
+
"compact",
|
|
6772
|
+
"contract"
|
|
6773
|
+
],
|
|
6774
|
+
"overflow": [
|
|
6775
|
+
"alert",
|
|
6776
|
+
"ink"
|
|
6777
|
+
]
|
|
6778
|
+
},
|
|
6779
|
+
"props": [
|
|
6780
|
+
{
|
|
6781
|
+
"name": "value",
|
|
6782
|
+
"type": "number",
|
|
6783
|
+
"description": "What has been used."
|
|
6784
|
+
},
|
|
6785
|
+
{
|
|
6786
|
+
"name": "max",
|
|
6787
|
+
"type": "number",
|
|
6788
|
+
"description": "The limit (a contract's ceiling, a month's included hours)."
|
|
6789
|
+
},
|
|
6790
|
+
{
|
|
6791
|
+
"name": "marks",
|
|
6792
|
+
"type": "{ value: number; label?: ReactNode; caption?: ReactNode; align?: 'start' | 'center' | 'end'; variant?: 'tick' | 'limit'; threshold?: boolean; hideWhenNarrow?: boolean }[]",
|
|
6793
|
+
"default": "[]",
|
|
6794
|
+
"description": "Ticks on the track. `threshold` marks the heads-up point. `label` and `caption` draw text under the tick; `hideWhenNarrow` hides that text under 30rem."
|
|
6795
|
+
},
|
|
6796
|
+
{
|
|
6797
|
+
"name": "zones",
|
|
6798
|
+
"type": "{ from?: number; to: number; variant?: 'solid' | 'hatched' }[]",
|
|
6799
|
+
"default": "[]",
|
|
6800
|
+
"description": "Bands behind the fill, in the hue's strong fill, solid or hatched."
|
|
6801
|
+
},
|
|
6802
|
+
{
|
|
6803
|
+
"name": "hue",
|
|
6804
|
+
"type": "number",
|
|
6805
|
+
"description": "A Paper project-hue angle (75 to 339). Reads --paper-hue-<angle>-fill, -fill-strong and -ink. Set --meter-hue-fill, --meter-hue-fill-strong and --meter-hue-ink yourself for any other colour."
|
|
6806
|
+
},
|
|
6807
|
+
{
|
|
6808
|
+
"name": "size",
|
|
6809
|
+
"type": "\"compact\" | \"contract\"",
|
|
6810
|
+
"default": "\"compact\"",
|
|
6811
|
+
"description": "\"compact\" is the 10px row meter; \"contract\" is the 30px meter with a thinner used bar."
|
|
6812
|
+
},
|
|
6813
|
+
{
|
|
6814
|
+
"name": "overflow",
|
|
6815
|
+
"type": "\"alert\" | \"ink\"",
|
|
6816
|
+
"default": "\"alert\"",
|
|
6817
|
+
"description": "How use past max draws. \"alert\" stripes it coral (unresolved hours); \"ink\" stripes it in ink (billable overage) and runs the fill through it."
|
|
6818
|
+
},
|
|
6819
|
+
{
|
|
6820
|
+
"name": "scale",
|
|
6821
|
+
"type": "number",
|
|
6822
|
+
"description": "The value at the track's right edge. Defaults to max, or 6% past value when it overflows. Pass one scale to line several meters up."
|
|
6823
|
+
},
|
|
6824
|
+
{
|
|
6825
|
+
"name": "children",
|
|
6826
|
+
"type": "ReactNode",
|
|
6827
|
+
"description": "The one-line label under the meter. Wrap the figure in <strong>."
|
|
6828
|
+
}
|
|
6829
|
+
],
|
|
6830
|
+
"dependencies": [],
|
|
6831
|
+
"tokens_used": [
|
|
6832
|
+
"--_alert",
|
|
6833
|
+
"--_fill",
|
|
6834
|
+
"--_fill-strong",
|
|
6835
|
+
"--_hatch",
|
|
6836
|
+
"--_ink",
|
|
6837
|
+
"--_inset-x",
|
|
6838
|
+
"--_inset-y",
|
|
6839
|
+
"--_tick",
|
|
6840
|
+
"--_tick-out",
|
|
6841
|
+
"--_track-h",
|
|
6842
|
+
"--_track-radius",
|
|
6843
|
+
"--color-error-500",
|
|
6844
|
+
"--font-size-xs",
|
|
6845
|
+
"--font-weight-bold",
|
|
6846
|
+
"--font-weight-medium",
|
|
6847
|
+
"--line-height-snug",
|
|
6848
|
+
"--meter-alert",
|
|
6849
|
+
"--meter-hatch-width",
|
|
6850
|
+
"--meter-hue-fill",
|
|
6851
|
+
"--meter-hue-fill-strong",
|
|
6852
|
+
"--meter-hue-ink",
|
|
6853
|
+
"--meter-tick",
|
|
6854
|
+
"--radius-full",
|
|
6855
|
+
"--spacing-1",
|
|
6856
|
+
"--spacing-2",
|
|
6857
|
+
"--surface-interactive-active",
|
|
6858
|
+
"--surface-muted",
|
|
6859
|
+
"--text-primary",
|
|
6860
|
+
"--text-secondary"
|
|
6861
|
+
],
|
|
6862
|
+
"example": "<Meter value={141} max={220} hue={219} marks={[{ value: 176, threshold: true }]}>\n <strong>64%</strong> of 220 h · heads-up at 80%\n</Meter>\n"
|
|
6863
|
+
},
|
|
6457
6864
|
"motion-specimen": {
|
|
6458
6865
|
"category": "specimen",
|
|
6459
6866
|
"description": "Duration and easing preview components with interactive play-animation controls.",
|
|
@@ -7560,6 +7967,96 @@
|
|
|
7560
7967
|
],
|
|
7561
7968
|
"example": "<Progress value={65} />\n\n{/* Static 4px chrome (e.g. door-open capacity meter — caller normalizes 0-1 to 0-100) */}\n<Progress\n value={Math.round(ratio * 100)}\n size=\"thin\"\n animate={false}\n aria-label=\"Time until door opens\"\n/>\n"
|
|
7562
7969
|
},
|
|
7970
|
+
"proportion-bar": {
|
|
7971
|
+
"category": "data-display",
|
|
7972
|
+
"description": "One measured total split into named parts, widths proportional to value, with an optional legend of swatch, label and value. Parts are told apart by the ground between them; hatched, striped and alert fills are built in.",
|
|
7973
|
+
"when_to_use": [
|
|
7974
|
+
"Hours split by bucket, money split by state, earned split into invoiced and waiting",
|
|
7975
|
+
"Two totals compared on one width, stacked one above the other (hours above money)",
|
|
7976
|
+
"A thin summary bar inside a card (`size=\"thin\"`)"
|
|
7977
|
+
],
|
|
7978
|
+
"when_not_to_use": [
|
|
7979
|
+
"One value against a maximum (use Progress)",
|
|
7980
|
+
"Equal steps of a flow (use SegmentedProgress)",
|
|
7981
|
+
"A share over time or many series (use Chart)"
|
|
7982
|
+
],
|
|
7983
|
+
"variants": {
|
|
7984
|
+
"size": [
|
|
7985
|
+
"default",
|
|
7986
|
+
"thin"
|
|
7987
|
+
]
|
|
7988
|
+
},
|
|
7989
|
+
"props": [
|
|
7990
|
+
{
|
|
7991
|
+
"name": "parts",
|
|
7992
|
+
"type": "{ label: string; value: number; fill?: string | 'hatched' | 'striped' | 'alert' }[]",
|
|
7993
|
+
"required": true,
|
|
7994
|
+
"description": "The parts, left to right. A part of zero or less is left out of the bar and kept in the legend. Without `fill` a part takes --proportion-bar-fill-1 to -4 by position; any other string is the part's CSS background."
|
|
7995
|
+
},
|
|
7996
|
+
{
|
|
7997
|
+
"name": "size",
|
|
7998
|
+
"type": "\"default\" | \"thin\"",
|
|
7999
|
+
"default": "\"default\"",
|
|
8000
|
+
"description": "Bar height. default=30px (a main balance), thin=8px (inside a card)."
|
|
8001
|
+
},
|
|
8002
|
+
{
|
|
8003
|
+
"name": "legend",
|
|
8004
|
+
"type": "boolean",
|
|
8005
|
+
"default": "false",
|
|
8006
|
+
"description": "Draw the legend row under the bar — swatch, label, value. The alert part's label and value read in --proportion-bar-alert-text."
|
|
8007
|
+
},
|
|
8008
|
+
{
|
|
8009
|
+
"name": "formatValue",
|
|
8010
|
+
"type": "(value: number) => string",
|
|
8011
|
+
"default": "String",
|
|
8012
|
+
"description": "Formats every value in the legend, the summary and the part tooltips (e.g. v => `${v} h`)."
|
|
8013
|
+
},
|
|
8014
|
+
{
|
|
8015
|
+
"name": "summary",
|
|
8016
|
+
"type": "string",
|
|
8017
|
+
"description": "The bar's accessible text (it is a role=\"img\"). Defaults to \"186.5 h: On a package 92.25 h, Outside a package 41.5 h, …\"."
|
|
8018
|
+
}
|
|
8019
|
+
],
|
|
8020
|
+
"dependencies": [
|
|
8021
|
+
"@loworbitstudio/visor-core"
|
|
8022
|
+
],
|
|
8023
|
+
"tokens_used": [
|
|
8024
|
+
"--chart-1",
|
|
8025
|
+
"--chart-2",
|
|
8026
|
+
"--chart-3",
|
|
8027
|
+
"--chart-4",
|
|
8028
|
+
"--color-success-500",
|
|
8029
|
+
"--color-success-600",
|
|
8030
|
+
"--font-size-xs",
|
|
8031
|
+
"--font-weight-bold",
|
|
8032
|
+
"--font-weight-medium",
|
|
8033
|
+
"--interactive-destructive-bg",
|
|
8034
|
+
"--line-height-snug",
|
|
8035
|
+
"--proportion-bar-alert-bg",
|
|
8036
|
+
"--proportion-bar-alert-text",
|
|
8037
|
+
"--proportion-bar-fill-1",
|
|
8038
|
+
"--proportion-bar-fill-2",
|
|
8039
|
+
"--proportion-bar-fill-3",
|
|
8040
|
+
"--proportion-bar-fill-4",
|
|
8041
|
+
"--proportion-bar-hatch-color",
|
|
8042
|
+
"--proportion-bar-hatch-gap",
|
|
8043
|
+
"--proportion-bar-stripe-a",
|
|
8044
|
+
"--proportion-bar-stripe-b",
|
|
8045
|
+
"--proportion-bar-track-bg",
|
|
8046
|
+
"--radius-full",
|
|
8047
|
+
"--radius-sm",
|
|
8048
|
+
"--spacing-1",
|
|
8049
|
+
"--spacing-2",
|
|
8050
|
+
"--spacing-4",
|
|
8051
|
+
"--surface-card",
|
|
8052
|
+
"--surface-muted",
|
|
8053
|
+
"--text-error",
|
|
8054
|
+
"--text-primary",
|
|
8055
|
+
"--text-secondary",
|
|
8056
|
+
"--text-tertiary"
|
|
8057
|
+
],
|
|
8058
|
+
"example": "<ProportionBar\n legend\n formatValue={(v) => `${v} h`}\n parts={[\n { label: \"On a package\", value: 92.25 },\n { label: \"Outside a package\", value: 41.5 },\n { label: \"Not billable\", value: 4, fill: \"hatched\" },\n { label: \"Unresolved\", value: 9.25, fill: \"alert\" },\n ]}\n/>\n<ProportionBar size=\"thin\" parts={[{ label: \"Invoiced\", value: 12455 }, { label: \"Waiting\", value: 9025, fill: \"striped\" }]} />\n"
|
|
8059
|
+
},
|
|
7563
8060
|
"quick-actions": {
|
|
7564
8061
|
"category": "navigation",
|
|
7565
8062
|
"description": "Vertical list of action rows pairing a left-aligned label with a right-aligned Kbd shortcut.",
|
|
@@ -13167,6 +13664,25 @@
|
|
|
13167
13664
|
"Content sections without full-viewport height"
|
|
13168
13665
|
]
|
|
13169
13666
|
},
|
|
13667
|
+
"kanban-board": {
|
|
13668
|
+
"category": "data-display",
|
|
13669
|
+
"description": "Stage columns in one row with cards that move between columns. Cards move by native drag and drop or by keyboard: Space picks a card up, Left and Right choose the column, Space or Enter drops, Escape cancels; arrows move focus between cards when nothing is held. Each move is announced through an aria-live region. Each column header shows its count and an optional total. Columns listed in `rails` draw as collapsed side rails that expand on click and accept drops. Columns are told apart by tone, never borders; a held card tilts and lifts. The block owns no data: the consumer renders each card's inside and owns persistence, optimistic state and Undo through onMove.",
|
|
13670
|
+
"components_used": [
|
|
13671
|
+
"card",
|
|
13672
|
+
"status-dot",
|
|
13673
|
+
"chip"
|
|
13674
|
+
],
|
|
13675
|
+
"when_to_use": [
|
|
13676
|
+
"Records that move through stages (a sales pipeline, orders, booking requests)",
|
|
13677
|
+
"Boards where stages are changed by drag and must also work from the keyboard",
|
|
13678
|
+
"Parked stages (paused, archived) that should stay one click away without taking a full column"
|
|
13679
|
+
],
|
|
13680
|
+
"when_not_to_use": [
|
|
13681
|
+
"Sorting and filtering many records by field (use data-table)",
|
|
13682
|
+
"Reordering cards within one list (the block moves cards between columns only)",
|
|
13683
|
+
"Read-only status summaries (use stat-card or right-rail-list)"
|
|
13684
|
+
]
|
|
13685
|
+
},
|
|
13170
13686
|
"login-form": {
|
|
13171
13687
|
"category": "authentication",
|
|
13172
13688
|
"description": "A login form block using Visor form components (Button, Input, Label, Card), with optional OAuth provider buttons.",
|
|
@@ -14115,8 +14631,11 @@
|
|
|
14115
14631
|
"chart",
|
|
14116
14632
|
"fidelity-mirror",
|
|
14117
14633
|
"key-value-list",
|
|
14634
|
+
"layer-chart",
|
|
14118
14635
|
"marquee",
|
|
14636
|
+
"meter",
|
|
14119
14637
|
"name-roster",
|
|
14638
|
+
"proportion-bar",
|
|
14120
14639
|
"segmented-progress",
|
|
14121
14640
|
"sparkline",
|
|
14122
14641
|
"spinner",
|
|
@@ -14158,33 +14677,8 @@
|
|
|
14158
14677
|
"toast-card",
|
|
14159
14678
|
"tooltip"
|
|
14160
14679
|
],
|
|
14161
|
-
"navigation": [
|
|
14162
|
-
"bottom-nav",
|
|
14163
|
-
"breadcrumb",
|
|
14164
|
-
"command",
|
|
14165
|
-
"doc-frame",
|
|
14166
|
-
"doc-nav",
|
|
14167
|
-
"navbar",
|
|
14168
|
-
"page-header",
|
|
14169
|
-
"pagination",
|
|
14170
|
-
"quick-actions",
|
|
14171
|
-
"section-header",
|
|
14172
|
-
"section-nav",
|
|
14173
|
-
"stepper",
|
|
14174
|
-
"tabs"
|
|
14175
|
-
],
|
|
14176
|
-
"layout": [
|
|
14177
|
-
"box",
|
|
14178
|
-
"collapsible",
|
|
14179
|
-
"container",
|
|
14180
|
-
"grid",
|
|
14181
|
-
"inline",
|
|
14182
|
-
"scroll-area",
|
|
14183
|
-
"separator",
|
|
14184
|
-
"sidebar",
|
|
14185
|
-
"stack"
|
|
14186
|
-
],
|
|
14187
14680
|
"form": [
|
|
14681
|
+
"billing-slider",
|
|
14188
14682
|
"button",
|
|
14189
14683
|
"calendar",
|
|
14190
14684
|
"checkbox",
|
|
@@ -14221,6 +14715,32 @@
|
|
|
14221
14715
|
"tin-input",
|
|
14222
14716
|
"toggle-group"
|
|
14223
14717
|
],
|
|
14718
|
+
"navigation": [
|
|
14719
|
+
"bottom-nav",
|
|
14720
|
+
"breadcrumb",
|
|
14721
|
+
"command",
|
|
14722
|
+
"doc-frame",
|
|
14723
|
+
"doc-nav",
|
|
14724
|
+
"navbar",
|
|
14725
|
+
"page-header",
|
|
14726
|
+
"pagination",
|
|
14727
|
+
"quick-actions",
|
|
14728
|
+
"section-header",
|
|
14729
|
+
"section-nav",
|
|
14730
|
+
"stepper",
|
|
14731
|
+
"tabs"
|
|
14732
|
+
],
|
|
14733
|
+
"layout": [
|
|
14734
|
+
"box",
|
|
14735
|
+
"collapsible",
|
|
14736
|
+
"container",
|
|
14737
|
+
"grid",
|
|
14738
|
+
"inline",
|
|
14739
|
+
"scroll-area",
|
|
14740
|
+
"separator",
|
|
14741
|
+
"sidebar",
|
|
14742
|
+
"stack"
|
|
14743
|
+
],
|
|
14224
14744
|
"media": [
|
|
14225
14745
|
"carousel",
|
|
14226
14746
|
"image",
|