@aviala-design/spiral 2.4.1 → 2.6.0

package/dist/props.json

@@ -18,7 +18,7 @@
       },
       {
         "name": "mode",
-        "type": "\"default\" | \"primary\" | \"second\" | \"defaultCustom\" | \"noBackground\" | \"noBackgroundCustom\" | \"destructive\"",
+        "type": "\"default\" | \"primary\" | \"second\" | \"defaultCustom\" | \"noBackground\" | \"noBackgroundCustom\" | \"outline\" | \"outlineCustom\" | \"destructive\"",
         "values": [
           "default",
           "primary",
@@ -26,6 +26,8 @@
           "defaultCustom",
           "noBackground",
           "noBackgroundCustom",
+          "outline",
+          "outlineCustom",
           "destructive"
         ],
         "required": false,
@@ -55,12 +57,12 @@
       },
       {
         "name": "variant",
-        "type": "\"default\" | \"destructive\" | \"secondary\" | \"outline\" | \"ghost\" | \"link\"",
+        "type": "\"default\" | \"outline\" | \"destructive\" | \"secondary\" | \"ghost\" | \"link\"",
         "values": [
           "default",
+          "outline",
           "destructive",
           "secondary",
-          "outline",
           "ghost",
           "link"
         ],
@@ -708,6 +710,17 @@
         "required": false,
         "description": ""
       },
+      {
+        "name": "direction",
+        "type": "\"horizontal\" | \"vertical\"",
+        "values": [
+          "horizontal",
+          "vertical"
+        ],
+        "defaultValue": "horizontal",
+        "required": false,
+        "description": "Figma `direction` — horizontal (default) or vertical stack."
+      },
       {
         "name": "allRound",
         "type": "boolean",
@@ -720,7 +733,7 @@
         "type": "boolean",
         "defaultValue": "false",
         "required": false,
-        "description": "When true, the group fills its container and items split the width equally."
+        "description": "When true, the group fills its container and items split the main axis equally."
       },
       {
         "name": "disabled",
@@ -814,6 +827,60 @@
       }
     ]
   },
+  "LocaleProvider": {
+    "displayName": "LocaleProvider",
+    "description": "",
+    "props": [
+      {
+        "name": "locale",
+        "type": "Locale",
+        "required": false,
+        "description": "Locale pack. Defaults to `zhCN`."
+      }
+    ]
+  },
+  "ConfigProvider": {
+    "displayName": "ConfigProvider",
+    "description": "",
+    "props": [
+      {
+        "name": "direction",
+        "type": "\"ltr\" | \"rtl\"",
+        "values": [
+          "ltr",
+          "rtl"
+        ],
+        "defaultValue": "ltr",
+        "required": false,
+        "description": "Writing direction. Defaults to `ltr`."
+      },
+      {
+        "name": "syncDocumentDir",
+        "type": "boolean",
+        "defaultValue": "true",
+        "required": false,
+        "description": "When true (default), the outermost ConfigProvider that opts in writes\n`document.documentElement.dir` so portalled overlays inherit direction.\nNested providers only set `dir` on their local wrapper."
+      },
+      {
+        "name": "locale",
+        "type": "Locale",
+        "required": false,
+        "description": "Optional locale pack — nests `LocaleProvider` when provided."
+      },
+      {
+        "name": "className",
+        "type": "string",
+        "required": false,
+        "description": ""
+      },
+      {
+        "name": "style",
+        "type": "CSSProperties",
+        "required": false,
+        "description": ""
+      }
+    ]
+  },
   "Alert": {
     "displayName": "Alert",
     "description": "",
@@ -889,7 +956,6 @@
       {
         "name": "closeLabel",
         "type": "string",
-        "defaultValue": "Dismiss alert",
         "required": false,
         "description": ""
       },
@@ -1006,7 +1072,6 @@
       {
         "name": "closeLabel",
         "type": "string",
-        "defaultValue": "Dismiss",
         "required": false,
         "description": ""
       },
@@ -1061,7 +1126,6 @@
       {
         "name": "rangePlaceholder",
         "type": "string",
-        "defaultValue": "Start date - End date",
         "required": false,
         "description": ""
       },
@@ -1324,7 +1388,6 @@
           {
             "name": "rangePlaceholder",
             "type": "string",
-            "defaultValue": "Start date - End date",
             "required": false,
             "description": ""
           },
@@ -1427,7 +1490,6 @@
       {
         "name": "placeholder",
         "type": "string",
-        "defaultValue": "HH:mm",
         "required": false,
         "description": ""
       },
@@ -1586,7 +1648,6 @@
           {
             "name": "placeholder",
             "type": "string",
-            "defaultValue": "HH:mm",
             "required": false,
             "description": ""
           },
@@ -1802,6 +1863,17 @@
         "defaultValue": "false",
         "required": false,
         "description": "Figma Checkbox `Round`"
+      },
+      {
+        "name": "size",
+        "type": "\"default\" | \"huge\"",
+        "values": [
+          "default",
+          "huge"
+        ],
+        "defaultValue": "default",
+        "required": false,
+        "description": "Figma Checkbox `Size`"
       }
     ],
     "parts": [
@@ -1839,6 +1911,17 @@
             "required": false,
             "description": "Figma Checkbox `Round`"
           },
+          {
+            "name": "size",
+            "type": "\"default\" | \"huge\"",
+            "values": [
+              "default",
+              "huge"
+            ],
+            "defaultValue": "default",
+            "required": false,
+            "description": "Figma Checkbox `Size`"
+          },
           {
             "name": "description",
             "type": "ReactNode",
@@ -2044,7 +2127,6 @@
       {
         "name": "placeholder",
         "type": "string",
-        "defaultValue": "Text",
         "required": false,
         "description": ""
       },
@@ -2198,7 +2280,6 @@
           {
             "name": "placeholder",
             "type": "string",
-            "defaultValue": "Text",
             "required": false,
             "description": ""
           },
@@ -2575,7 +2656,6 @@
           {
             "name": "placeholder",
             "type": "string",
-            "defaultValue": "Select color",
             "required": false,
             "description": ""
           }
@@ -3082,7 +3162,7 @@
       },
       {
         "displayName": "NavigationItemMenuContent",
-        "description": "Flyout surface — right of the item in vertical, below it in horizontal.",
+        "description": "Flyout surface — forward of the item in vertical (LTR right / RTL left), below it in horizontal.",
         "props": [
           {
             "name": "asChild",
@@ -3519,7 +3599,7 @@
   },
   "FormField": {
     "displayName": "FormField",
-    "description": "",
+    "description": "FormField — layout wrapper around a form control, or a react-hook-form\nbound field when given `name` + `render` (shadcn-style).",
     "props": [
       {
         "name": "label",
@@ -3543,7 +3623,7 @@
         "name": "error",
         "type": "ReactNode",
         "required": false,
-        "description": ""
+        "description": "Overrides the validation error message shown under the control"
       },
       {
         "name": "info",
@@ -3565,14 +3645,56 @@
       },
       {
         "name": "direction",
-        "type": "\"vertical\" | \"horizontal\"",
+        "type": "\"horizontal\" | \"vertical\"",
         "values": [
-          "vertical",
-          "horizontal"
+          "horizontal",
+          "vertical"
         ],
         "defaultValue": "vertical",
         "required": false,
         "description": "Figma `Direction` — vertical stacks label above control; horizontal places label beside"
+      },
+      {
+        "name": "ref",
+        "type": "Ref<HTMLDivElement>",
+        "required": false,
+        "description": ""
+      },
+      {
+        "name": "rules",
+        "type": "Omit<RegisterOptions<TFieldValues, TName>, \"disabled\" | \"valueAsNumber\" | \"valueAsDate\" | \"setValueAs\">",
+        "required": false,
+        "description": ""
+      },
+      {
+        "name": "shouldUnregister",
+        "type": "boolean",
+        "required": false,
+        "description": ""
+      },
+      {
+        "name": "disabled",
+        "type": "boolean",
+        "required": false,
+        "description": ""
+      },
+      {
+        "name": "name",
+        "type": "string",
+        "required": true,
+        "description": ""
+      },
+      {
+        "name": "control",
+        "type": "Control<TFieldValues>",
+        "required": false,
+        "description": ""
+      },
+      {
+        "name": "render",
+        "type": "(props: FormFieldRenderProps<TFieldValues, TName>) => ReactNode",
+        "required": true,
+        "description": ""
       }
     ]
   },
@@ -3686,7 +3808,17 @@
             ],
             "defaultValue": "default",
             "required": false,
-            "description": "Visual skin of the surface:\n- `default` — light bordered panel (select-menu aligned), text typography, stroked caret.\n- `tooltip` — shared inverted tooltip skin (dark, caption text, borderless, solid caret).\n- `primary` — brand primary surface with white text, borderless, solid caret."
+            "description": "Visual skin of the surface:\n- `default` — light bordered panel (select-menu aligned), text typography, stroked caret.\n- `tooltip` — shared inverted tooltip skin (dark, caption text by default, borderless, solid caret).\n- `primary` — brand primary surface with white text, borderless, solid caret."
+          },
+          {
+            "name": "level",
+            "type": "\"caption\" | \"text\"",
+            "values": [
+              "caption",
+              "text"
+            ],
+            "required": false,
+            "description": "Typography level for the surface copy.\nDefaults to `caption` for `appearance=\"tooltip\"`, otherwise `text`."
           }
         ]
       },
@@ -3797,7 +3929,6 @@
           {
             "name": "closeLabel",
             "type": "string",
-            "defaultValue": "Close dialog",
             "required": false,
             "description": ""
           }
@@ -3830,7 +3961,6 @@
           {
             "name": "closeLabel",
             "type": "string",
-            "defaultValue": "Close dialog",
             "required": false,
             "description": ""
           },
@@ -3908,6 +4038,32 @@
     "description": "",
     "props": [],
     "parts": [
+      {
+        "displayName": "TooltipProvider",
+        "description": "Provides shared hover-delay state for nested Tooltips.\nPass `delayDuration={0}` for instant open on hover.",
+        "props": [
+          {
+            "name": "delayDuration",
+            "type": "number",
+            "defaultValue": "300",
+            "required": false,
+            "description": "Delay before the tooltip opens on hover, in ms.\nDefaults to `TOOLTIP_DELAY_DURATION` (300). Pass `0` for instant open on hover."
+          },
+          {
+            "name": "skipDelayDuration",
+            "type": "number",
+            "defaultValue": "0",
+            "required": false,
+            "description": "When moving between tooltips, skip the open delay within this window (ms)."
+          },
+          {
+            "name": "disableHoverableContent",
+            "type": "boolean",
+            "required": false,
+            "description": "When true, hovering the tooltip content itself does not keep it open."
+          }
+        ]
+      },
       {
         "displayName": "TooltipTrigger",
         "description": "",
@@ -3936,11 +4092,136 @@
             "defaultValue": "true",
             "required": false,
             "description": "Show a caret arrow pointing at the trigger (default true)."
+          },
+          {
+            "name": "level",
+            "type": "\"caption\" | \"text\"",
+            "values": [
+              "caption",
+              "text"
+            ],
+            "defaultValue": "caption",
+            "required": false,
+            "description": "Typography level for the surface copy.\nFigma default is `caption`; pass `text` for body-sized tooltip copy."
           }
         ]
       }
     ]
   },
+  "ResponsiveTooltip": {
+    "displayName": "ResponsiveTooltip",
+    "description": "Tooltip with a mobile-friendly trigger.\n\nRadix Tooltip is hover/focus only and deliberately ignores touch, so it has\nno trigger on phones. `ResponsiveTooltip` renders the SAME content through the\nright primitive for the device:\n- Desktop (`pointer: fine`): Radix Tooltip — opens on hover and keyboard focus.\n- Touch (`pointer: coarse`): Radix Popover with `appearance=\"tooltip\"` — opens on\n  **long-press** (short tap still reaches the trigger’s own `onClick`), dismisses\n  on outside tap / Escape, and keeps the tooltip visual skin (dark surface,\n  caption text, solid caret) so it looks identical to desktop.\n\nThe consumer API and the look are unchanged between devices; only the trigger\ngesture differs. Animations are handled by the respective effect CSS\n(tooltip-effects / popover-effects), so direction-aware scale-in/out works on\nboth branches.",
+    "props": [
+      {
+        "name": "content",
+        "type": "ReactNode",
+        "required": true,
+        "description": "Tooltip body — the same content is shown on desktop (hover) and touch\n(long-press)."
+      },
+      {
+        "name": "children",
+        "type": "ReactNode",
+        "required": true,
+        "description": "The trigger element. Rendered with `asChild`, so pass a single element."
+      },
+      {
+        "name": "side",
+        "type": "\"top\" | \"right\" | \"bottom\" | \"left\"",
+        "values": [
+          "top",
+          "right",
+          "bottom",
+          "left"
+        ],
+        "defaultValue": "top",
+        "required": false,
+        "description": "Preferred placement of the floating content."
+      },
+      {
+        "name": "align",
+        "type": "\"start\" | \"center\" | \"end\"",
+        "values": [
+          "start",
+          "center",
+          "end"
+        ],
+        "defaultValue": "center",
+        "required": false,
+        "description": "Cross-axis alignment relative to the trigger."
+      },
+      {
+        "name": "sideOffset",
+        "type": "number",
+        "defaultValue": "4",
+        "required": false,
+        "description": "Gap between trigger and content, in px."
+      },
+      {
+        "name": "collisionPadding",
+        "type": "number",
+        "defaultValue": "8",
+        "required": false,
+        "description": "Distance from viewport edges before collision flipping, in px."
+      },
+      {
+        "name": "showArrow",
+        "type": "boolean",
+        "defaultValue": "true",
+        "required": false,
+        "description": "Show the caret arrow pointing at the trigger."
+      },
+      {
+        "name": "level",
+        "type": "\"caption\" | \"text\"",
+        "values": [
+          "caption",
+          "text"
+        ],
+        "defaultValue": "caption",
+        "required": false,
+        "description": "Typography level for the content surface (default `caption`)."
+      },
+      {
+        "name": "delayDuration",
+        "type": "number",
+        "defaultValue": "300",
+        "required": false,
+        "description": "Hover open delay on desktop, in ms (ignored on touch).\nDefaults to 300 (`TOOLTIP_DELAY_DURATION`). Pass `0` for instant open on hover.\nRequires a TooltipProvider ancestor for shared delay context."
+      },
+      {
+        "name": "longPressMs",
+        "type": "number",
+        "defaultValue": "500",
+        "required": false,
+        "description": "Hold duration on touch before the tip opens, in ms.\nDefaults to 500 (`RESPONSIVE_TOOLTIP_LONG_PRESS_MS`)."
+      },
+      {
+        "name": "open",
+        "type": "boolean",
+        "required": false,
+        "description": "Controlled open state."
+      },
+      {
+        "name": "defaultOpen",
+        "type": "boolean",
+        "defaultValue": "false",
+        "required": false,
+        "description": "Uncontrolled initial open state."
+      },
+      {
+        "name": "onOpenChange",
+        "type": "(open: boolean) => void",
+        "required": false,
+        "description": "Open-state change callback."
+      },
+      {
+        "name": "contentClassName",
+        "type": "string",
+        "required": false,
+        "description": "Extra class on the inner content surface."
+      }
+    ]
+  },
   "Loading": {
     "displayName": "Loading",
     "description": "",
@@ -3985,7 +4266,6 @@
       {
         "name": "label",
         "type": "string",
-        "defaultValue": "Loading",
         "required": false,
         "description": "Accessible name; omit when decorative (`aria-hidden`)."
       }
@@ -4169,7 +4449,6 @@
       {
         "name": "closeLabel",
         "type": "string",
-        "defaultValue": "Remove",
         "required": false,
         "description": ""
       },
@@ -4300,6 +4579,19 @@
         "defaultValue": "default",
         "required": false,
         "description": "Figma `Type` — single thumb vs range (two thumbs)"
+      },
+      {
+        "name": "showValueTooltip",
+        "type": "boolean",
+        "defaultValue": "false",
+        "required": false,
+        "description": "When true, hovering a thumb (and while dragging it) shows a value\ntooltip bound to that thumb."
+      },
+      {
+        "name": "formatValueTooltip",
+        "type": "(value: number, index: number) => ReactNode",
+        "required": false,
+        "description": "Format the value tooltip label. Defaults to `String(value)`."
       }
     ]
   },
@@ -4321,14 +4613,12 @@
       {
         "name": "description",
         "type": "ReactNode",
-        "defaultValue": "Or click here to upload",
         "required": false,
         "description": "Secondary line — Large style"
       },
       {
         "name": "label",
         "type": "ReactNode",
-        "defaultValue": "Upload",
         "required": false,
         "description": "Default style button label"
       },
@@ -4732,21 +5022,18 @@
       {
         "name": "jumpLabel",
         "type": "ReactNode",
-        "defaultValue": "跳转至",
         "required": false,
         "description": ""
       },
       {
         "name": "sizeLabel",
         "type": "ReactNode",
-        "defaultValue": "每页",
         "required": false,
         "description": ""
       },
       {
         "name": "sizeOptionLabel",
         "type": "(size: number) => ReactNode",
-        "defaultValue": "(size) => `${size} 项`",
         "required": false,
         "description": ""
       }
@@ -4947,7 +5234,7 @@
           },
           {
             "name": "checkboxProps",
-            "type": "Omit<Omit<CheckboxProps & RefAttributes<HTMLButtonElement>, \"ref\"> & { round?: boolean; } & RefAttributes<HTMLButtonElement>, \"ref\">",
+            "type": "Omit<Omit<CheckboxProps & RefAttributes<HTMLButtonElement>, \"ref\"> & { round?: boolean; size?: CheckboxSize; } & RefAttributes<...>, \"ref\">",
             "required": false,
             "description": ""
           }