@psnext/design-system 2.5.0 → 2.7.0

package/dist/index30.d.cts

@@ -1,37 +1,54 @@
-import * as react_jsx_runtime142 from "react/jsx-runtime";
-import * as class_variance_authority_types16 from "class-variance-authority/types";
-import { VariantProps } from "class-variance-authority";
+import * as react_jsx_runtime330 from "react/jsx-runtime";
 import * as React from "react";
 
-//#region src/primitives/Heading/Heading.d.ts
-declare const headingVariants: (props?: ({
-  size?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | null | undefined;
-  weight?: "normal" | "medium" | "semibold" | null | undefined;
-  align?: "left" | "right" | "center" | null | undefined;
-  gradient?: boolean | null | undefined;
-} & class_variance_authority_types16.ClassProp) | undefined) => string;
-type HeadingProps = React.ComponentProps<"h2"> & VariantProps<typeof headingVariants> & {
-  /** Semantic heading level/element. Defaults to `h2`. */
-  as?: React.ElementType;
-  /** Visual step on the Figma heading scale (1 largest → 7 smallest); also sets the per-step default weight. */
-  size?: VariantProps<typeof headingVariants>["size"];
-  /** Override the per-step default weight. */
-  weight?: VariantProps<typeof headingVariants>["weight"];
-  /** Text alignment. */
-  align?: VariantProps<typeof headingVariants>["align"];
-  /** When true, fills the text with the brand gradient instead of the foreground colour. */
-  gradient?: VariantProps<typeof headingVariants>["gradient"];
+//#region src/primitives/FileUpload/FileUpload.d.ts
+type FileUploadStatus = "idle" | "uploading" | "success" | "error";
+type FileUploadItem = {
+  id: string;
+  file: File;
+  status: FileUploadStatus;
+  progress: number;
+  error?: string;
 };
-/** Display/section title using the design-system heading scale; `size` sets the visual step, `as` the semantic element. */
-declare function Heading({
-  as,
+type FileUploadHandler = (params: {
+  file: File;
+  signal: AbortSignal;
+  reportProgress: (value: number) => void;
+}) => Promise<void>;
+type FileUploadProps = Omit<React.ComponentProps<"div">, "onChange"> & {
+  /** Disable click, drag/drop, and file selection. */
+  disabled?: boolean;
+  /** Allow selecting or dropping multiple files in one interaction. */
+  multiple?: boolean;
+  /** Native file accept filter (e.g. `image/*,.pdf`). */
+  accept?: string;
+  /** Maximum number of files held by the component at once. */
+  maxFiles?: number;
+  /** Maximum file size in bytes; oversized files are rejected with an error message. */
+  maxFileSize?: number;
+  /** Optional custom validator. Return a message to reject the file, or `null` to accept it. */
+  validateFile?: (file: File) => string | null;
+  /** Called for each accepted file; receives a progress reporter and abort signal. */
+  onUpload?: FileUploadHandler;
+  /** Called whenever file entries change (added, progress updates, completed, removed). */
+  onItemsChange?: (items: FileUploadItem[]) => void;
+  /** Accessible label for the drag-and-drop region. */
+  dropzoneAriaLabel?: string;
+};
+/** File upload primitive with click-to-browse and drag-and-drop interactions, validation, and per-file upload states. */
+declare function FileUpload({
   className,
-  size,
-  weight,
-  align,
-  gradient,
+  multiple,
+  accept,
+  maxFiles,
+  maxFileSize,
+  validateFile,
+  onUpload,
+  onItemsChange,
+  dropzoneAriaLabel,
+  disabled,
   ...props
-}: HeadingProps): react_jsx_runtime142.JSX.Element;
+}: FileUploadProps): react_jsx_runtime330.JSX.Element;
 //#endregion
-export { HeadingProps as n, headingVariants as r, Heading as t };
+export { FileUploadStatus as a, FileUploadProps as i, FileUploadHandler as n, FileUploadItem as r, FileUpload as t };
 //# sourceMappingURL=index30.d.cts.map

package/dist/index30.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index30.d.cts","names":[],"sources":["../src/primitives/Heading/Heading.tsx"],"mappings":";;;;;;cAUM,uBAiCW;;;;EAjCX,QAAA,CAAA,EAAA,OA+BJ,GAAA,IAAA,GAAA,SAAA;IAAA,gCAAA,CAAA,SAEe,CAAA,GAAA,SAAA,EAAA,GAAA,MAAA;KAAZ,YAAA,GAAe,KAAA,CAAM,cAAT,CAAA,IAAA,CAAA,GACf,YADe,CAAA,OACK,eADL,CAAA,GAAA;;KACK,EAEb,KAAA,CAAM,WAFO;;MAEb,CAAA,EAEE,YAFI,CAAA,OAEgB,eAFhB,CAAA,CAAA,MAAA,CAAA;;QAEJ,CAAA,EAEE,YAFF,CAAA,OAEsB,eAFtB,CAAA,CAAA,QAAA,CAAA;;OAEE,CAAA,EAED,YAFC,CAAA,OAEmB,eAFnB,CAAA,CAAA,OAAA,CAAA;;UAED,CAAA,EAEG,YAFH,CAAA,OAEuB,eAFvB,CAAA,CAAA,UAAA,CAAA;;;AAEe,iBAIlB,OAAA,CAJkB;EAAA,EAAA;EAAA,SAAA;EAAA,IAAA;EAAA,MAAA;EAAA,KAAA;EAAA,QAAA;EAAA,GAAA;AAAA,CAAA,EAIkD,YAJlD,CAAA,EAI8D,oBAAA,CAAA,GAAA,CAAA,OAJ9D"}
+{"version":3,"file":"index30.d.cts","names":[],"sources":["../src/primitives/FileUpload/FileUpload.tsx"],"mappings":";;;;KASK,gBAAA;KAEA,cAAA;;EAFA,IAAA,EAIG,IAJH;EAEA,MAAA,EAGK,gBAHS;EAAA,QAAA,EAAA,MAAA;OAEX,CAAA,EAAA,MAAA;;AACkB,KAKrB,iBAAA,GALqB,CAAA,MAAA,EAAA;EAKrB,IAAA,EACG,IADH;EAAiB,MAAA,EAEZ,WAFY;gBACd,EAAA,CAAA,KAAA,EAAA,MAAA,EAAA,GAAA,IAAA;MAGF,OAFI,CAAA,IAAA,CAAA;KAIL,eAAA,GAAkB,IAFjB,CAEsB,KAAA,CAAM,cAF5B,CAAA,KAAA,CAAA,EAAA,UAAA,CAAA,GAAA;EAAO;EAER,QAAA,CAAA,EAAA,OAAe;EAAA;UAAQ,CAAM,EAAA,OAAA;;QAYV,CAAA,EAAA,MAAA;;UAIE,CAAA,EAAA,MAAA;EAAc;EAqF/B,WAAA,CAAA,EAAU,MAAA;EAAA;cACjB,CAAA,EAAA,CAAA,IAAA,EA1FsB,IA0FtB,EAAA,GAAA,MAAA,GAAA,IAAA;;UAEA,CAAA,EA1FW,iBA0FX;;eAEA,CAAA,EAAA,CAAA,KAAA,EA1FwB,cA0FxB,EAAA,EAAA,GAAA,IAAA;;mBAEA,CAAA,EAAA,MAAA;;;iBAPO,UAAA,CAUP;EAAA,SAAA;EAAA,QAAA;EAAA,MAAA;EAAA,QAAA;EAAA,WAAA;EAAA,YAAA;EAAA,QAAA;EAAA,aAAA;EAAA,iBAAA;EAAA,QAAA;EAAA,GAAA;AAAA,CAAA,EAEC,eAFD,CAAA,EAEgB,oBAAA,CAAA,GAAA,CAAA,OAFhB"}

package/dist/index30.d.ts

@@ -1,37 +1,54 @@
-import { VariantProps } from "class-variance-authority";
 import * as React from "react";
-import * as react_jsx_runtime170 from "react/jsx-runtime";
-import * as class_variance_authority_types15 from "class-variance-authority/types";
+import * as react_jsx_runtime135 from "react/jsx-runtime";
 
-//#region src/primitives/Heading/Heading.d.ts
-declare const headingVariants: (props?: ({
-  size?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | null | undefined;
-  weight?: "normal" | "medium" | "semibold" | null | undefined;
-  align?: "center" | "left" | "right" | null | undefined;
-  gradient?: boolean | null | undefined;
-} & class_variance_authority_types15.ClassProp) | undefined) => string;
-type HeadingProps = React.ComponentProps<"h2"> & VariantProps<typeof headingVariants> & {
-  /** Semantic heading level/element. Defaults to `h2`. */
-  as?: React.ElementType;
-  /** Visual step on the Figma heading scale (1 largest → 7 smallest); also sets the per-step default weight. */
-  size?: VariantProps<typeof headingVariants>["size"];
-  /** Override the per-step default weight. */
-  weight?: VariantProps<typeof headingVariants>["weight"];
-  /** Text alignment. */
-  align?: VariantProps<typeof headingVariants>["align"];
-  /** When true, fills the text with the brand gradient instead of the foreground colour. */
-  gradient?: VariantProps<typeof headingVariants>["gradient"];
+//#region src/primitives/FileUpload/FileUpload.d.ts
+type FileUploadStatus = "idle" | "uploading" | "success" | "error";
+type FileUploadItem = {
+  id: string;
+  file: File;
+  status: FileUploadStatus;
+  progress: number;
+  error?: string;
 };
-/** Display/section title using the design-system heading scale; `size` sets the visual step, `as` the semantic element. */
-declare function Heading({
-  as,
+type FileUploadHandler = (params: {
+  file: File;
+  signal: AbortSignal;
+  reportProgress: (value: number) => void;
+}) => Promise<void>;
+type FileUploadProps = Omit<React.ComponentProps<"div">, "onChange"> & {
+  /** Disable click, drag/drop, and file selection. */
+  disabled?: boolean;
+  /** Allow selecting or dropping multiple files in one interaction. */
+  multiple?: boolean;
+  /** Native file accept filter (e.g. `image/*,.pdf`). */
+  accept?: string;
+  /** Maximum number of files held by the component at once. */
+  maxFiles?: number;
+  /** Maximum file size in bytes; oversized files are rejected with an error message. */
+  maxFileSize?: number;
+  /** Optional custom validator. Return a message to reject the file, or `null` to accept it. */
+  validateFile?: (file: File) => string | null;
+  /** Called for each accepted file; receives a progress reporter and abort signal. */
+  onUpload?: FileUploadHandler;
+  /** Called whenever file entries change (added, progress updates, completed, removed). */
+  onItemsChange?: (items: FileUploadItem[]) => void;
+  /** Accessible label for the drag-and-drop region. */
+  dropzoneAriaLabel?: string;
+};
+/** File upload primitive with click-to-browse and drag-and-drop interactions, validation, and per-file upload states. */
+declare function FileUpload({
   className,
-  size,
-  weight,
-  align,
-  gradient,
+  multiple,
+  accept,
+  maxFiles,
+  maxFileSize,
+  validateFile,
+  onUpload,
+  onItemsChange,
+  dropzoneAriaLabel,
+  disabled,
   ...props
-}: HeadingProps): react_jsx_runtime170.JSX.Element;
+}: FileUploadProps): react_jsx_runtime135.JSX.Element;
 //#endregion
-export { HeadingProps as n, headingVariants as r, Heading as t };
+export { FileUploadStatus as a, FileUploadProps as i, FileUploadHandler as n, FileUploadItem as r, FileUpload as t };
 //# sourceMappingURL=index30.d.ts.map

package/dist/index30.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index30.d.ts","names":[],"sources":["../src/primitives/Heading/Heading.tsx"],"mappings":";;;;;;cAUM,uBAiCW;;;;EAjCX,QAAA,CAAA,EAAA,OA+BJ,GAAA,IAAA,GAAA,SAAA;IAAA,gCAAA,CAAA,SAEe,CAAA,GAAA,SAAA,EAAA,GAAA,MAAA;KAAZ,YAAA,GAAe,KAAA,CAAM,cAAT,CAAA,IAAA,CAAA,GACf,YADe,CAAA,OACK,eADL,CAAA,GAAA;;KACK,EAEb,KAAA,CAAM,WAFO;;MAEb,CAAA,EAEE,YAFI,CAAA,OAEgB,eAFhB,CAAA,CAAA,MAAA,CAAA;;QAEJ,CAAA,EAEE,YAFF,CAAA,OAEsB,eAFtB,CAAA,CAAA,QAAA,CAAA;;OAEE,CAAA,EAED,YAFC,CAAA,OAEmB,eAFnB,CAAA,CAAA,OAAA,CAAA;;UAED,CAAA,EAEG,YAFH,CAAA,OAEuB,eAFvB,CAAA,CAAA,UAAA,CAAA;;;AAEe,iBAIlB,OAAA,CAJkB;EAAA,EAAA;EAAA,SAAA;EAAA,IAAA;EAAA,MAAA;EAAA,KAAA;EAAA,QAAA;EAAA,GAAA;AAAA,CAAA,EAIkD,YAJlD,CAAA,EAI8D,oBAAA,CAAA,GAAA,CAAA,OAJ9D"}
+{"version":3,"file":"index30.d.ts","names":[],"sources":["../src/primitives/FileUpload/FileUpload.tsx"],"mappings":";;;;KASK,gBAAA;KAEA,cAAA;;EAFA,IAAA,EAIG,IAJH;EAEA,MAAA,EAGK,gBAHS;EAAA,QAAA,EAAA,MAAA;OAEX,CAAA,EAAA,MAAA;;AACkB,KAKrB,iBAAA,GALqB,CAAA,MAAA,EAAA;EAKrB,IAAA,EACG,IADH;EAAiB,MAAA,EAEZ,WAFY;gBACd,EAAA,CAAA,KAAA,EAAA,MAAA,EAAA,GAAA,IAAA;MAGF,OAFI,CAAA,IAAA,CAAA;KAIL,eAAA,GAAkB,IAFjB,CAEsB,KAAA,CAAM,cAF5B,CAAA,KAAA,CAAA,EAAA,UAAA,CAAA,GAAA;EAAO;EAER,QAAA,CAAA,EAAA,OAAe;EAAA;UAAQ,CAAM,EAAA,OAAA;;QAYV,CAAA,EAAA,MAAA;;UAIE,CAAA,EAAA,MAAA;EAAc;EAqF/B,WAAA,CAAA,EAAU,MAAA;EAAA;cACjB,CAAA,EAAA,CAAA,IAAA,EA1FsB,IA0FtB,EAAA,GAAA,MAAA,GAAA,IAAA;;UAEA,CAAA,EA1FW,iBA0FX;;eAEA,CAAA,EAAA,CAAA,KAAA,EA1FwB,cA0FxB,EAAA,EAAA,GAAA,IAAA;;mBAEA,CAAA,EAAA,MAAA;;;iBAPO,UAAA,CAUP;EAAA,SAAA;EAAA,QAAA;EAAA,MAAA;EAAA,QAAA;EAAA,WAAA;EAAA,YAAA;EAAA,QAAA;EAAA,aAAA;EAAA,iBAAA;EAAA,QAAA;EAAA,GAAA;AAAA,CAAA,EAEC,eAFD,CAAA,EAEgB,oBAAA,CAAA,GAAA,CAAA,OAFhB"}

package/dist/index31.d.cts

@@ -1,25 +1,71 @@
-import * as react_jsx_runtime139 from "react/jsx-runtime";
-import { HoverCard } from "radix-ui";
+import { i as FieldError, o as FieldLabel, r as FieldDescription, t as Field } from "./index29.cjs";
+import * as react_jsx_runtime166 from "react/jsx-runtime";
+import { Slot } from "radix-ui";
 import * as React from "react";
+import * as react_hook_form0 from "react-hook-form";
+import { ControllerProps, FieldPath, FieldValues } from "react-hook-form";
 
-//#region src/primitives/HoverCard/HoverCard.d.ts
-/** Root that reveals a floating card when the user hovers (or focuses) the trigger. */
-declare function HoverCard$1({
+//#region src/primitives/Form/Form.d.ts
+/** Root provider that shares one react-hook-form instance with all nested form pieces. */
+declare const Form: <TFieldValues extends FieldValues, TContext = any, TTransformedValues = TFieldValues>({
+  children,
+  watch,
+  getValues,
+  getFieldState,
+  setError,
+  clearErrors,
+  setValue,
+  setValues,
+  trigger,
+  formState,
+  resetField,
+  reset,
+  handleSubmit,
+  unregister,
+  control,
+  register,
+  setFocus,
+  subscribe
+}: react_hook_form0.FormProviderProps<TFieldValues, TContext, TTransformedValues>) => React.JSX.Element;
+/** Connects a single input to the form via RHF's `Controller`, exposing `field` to its render prop. */
+declare const FormField: <TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>({
   ...props
-}: React.ComponentProps<typeof HoverCard.Root>): react_jsx_runtime139.JSX.Element;
-/** The element that opens the hover card on pointer hover or keyboard focus. */
-declare function HoverCardTrigger({
+}: ControllerProps<TFieldValues, TName>) => react_jsx_runtime166.JSX.Element;
+/** Hook for form pieces to read the current field's id, name, ARIA ids, and validation state. */
+declare const useFormField: () => {
+  invalid: boolean;
+  isDirty: boolean;
+  isTouched: boolean;
+  isValidating: boolean;
+  error?: react_hook_form0.FieldError;
+  id: string;
+  name: string;
+  formItemId: string;
+  formDescriptionId: string;
+  formMessageId: string;
+};
+/** Wraps one field, generating an id so its label, control, and messages stay linked. */
+declare function FormItem({
   ...props
-}: React.ComponentProps<typeof HoverCard.Trigger>): react_jsx_runtime139.JSX.Element;
-/** The floating, portalled surface shown while the trigger is hovered/focused. */
-declare function HoverCardContent({
+}: React.ComponentProps<typeof Field>): react_jsx_runtime166.JSX.Element;
+/** Field label wired to the control's id and tinted destructive when the field is invalid. */
+declare function FormLabel({
   className,
-  /** Alignment of the content relative to the trigger along the chosen side. */
-  align,
-  /** Gap in pixels between the trigger and the content. */
-  sideOffset,
   ...props
-}: React.ComponentProps<typeof HoverCard.Content>): react_jsx_runtime139.JSX.Element;
+}: React.ComponentProps<typeof FieldLabel>): react_jsx_runtime166.JSX.Element;
+/** Slots the actual input, applying the field's id, `aria-describedby`, and `aria-invalid`. */
+declare function FormControl({
+  ...props
+}: React.ComponentProps<typeof Slot.Root>): react_jsx_runtime166.JSX.Element;
+/** Helper text for a field, linked to its control via `aria-describedby`. */
+declare function FormDescription({
+  ...props
+}: React.ComponentProps<typeof FieldDescription>): react_jsx_runtime166.JSX.Element;
+/** Renders the field's validation error (or `children`), and nothing when there is no message. */
+declare function FormMessage({
+  children,
+  ...props
+}: React.ComponentProps<typeof FieldError>): react_jsx_runtime166.JSX.Element | null;
 //#endregion
-export { HoverCardContent as n, HoverCardTrigger as r, HoverCard$1 as t };
+export { FormItem as a, useFormField as c, FormField as i, FormControl as n, FormLabel as o, FormDescription as r, FormMessage as s, Form as t };
 //# sourceMappingURL=index31.d.cts.map

package/dist/index31.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index31.d.cts","names":[],"sources":["../src/primitives/HoverCard/HoverCard.tsx"],"mappings":";;;;;;iBAMS,WAAA;;GAAwB,KAAA,CAAM,sBAAsB,SAAA,CAAmB,QAAK,oBAAA,CAAA,GAAA,CAAA;;AALjD,iBAU3B,gBAAA,CALS;EAAA,GAAA;AAAA,CAAA,EAKsB,KAAA,CAAM,cAL5B,CAAA,OAKkD,SAAA,CAAmB,OALrE,CAAA,CAAA,EAK6E,oBAAA,CAAA,GAAA,CAAA,OAL7E;;iBAUT,gBAAA,CAVuE;EAAA,SAAA;;;EAAK;EAAA,UAK5E;EAAA,GAAA;AAAgB,CAAhB,EAYN,KAAA,CAAM,cAZgB,CAAA,OAYM,SAAA,CAAmB,OAZzB,CAAA,CAAA,EAYiC,oBAAA,CAAA,GAAA,CAAA,OAZjC"}
+{"version":3,"file":"index31.d.cts","names":[],"sources":["../src/primitives/Form/Form.tsx"],"mappings":";;;;;;;;;cAqBM,4BAAI,kDAAA;;;;;;;;;;;;;;;;;;;GAAA,gBAAA,CAAA,kBAAA,cAAA,UAAA,wBAAA,KAAA,CAAA,GAAA,CAAA;;cAaJ,iCACiB,cAAc,2BACrB,UAAU,gBAAgB,UAAU;;GAGjD,gBAAgB,cAAc,WAAM,oBAAA,CAAA,GAAA,CAAA;AAzB8C;cAkC/E,YA3BmB,EAAA,GAAA,GAAA;SAAf,EAAA,OAAA;SAAA,EAAA,OAAA;WAAA,EAAA,OAAA;cAAA,EAAA,OAAA;OAAA,CAAA,EAgDT,gBAAA,CAAA,UAhDS;MAAA,MAAA;MAAA,EAAA,MAAA;YAAA,EAAA,MAAA;mBAAA,EAAA,MAAA;eAAA,EAAA,MAAA;;;iBA0DD,QAAA,CA1DC;EAAA,GAAA;AAAA,CAAA,EA0DsB,KAAA,CAAM,cA1D5B,CAAA,OA0DkD,KA1DlD,CAAA,CAAA,EA0DwD,oBAAA,CAAA,GAAA,CAAA,OA1DxD;;iBAqED,SAAA,CArEC;EAAA,SAAA;EAAA,GAAA;AAAA,CAAA,EAqEkC,KAAA,CAAM,cArExC,CAAA,OAqE8D,UArE9D,CAAA,CAAA,EAqEyE,oBAAA,CAAA,GAAA,CAAA,OArEzE;;iBAoFD,WAAA,CApFC;EAAA,GAAA;AAAA,CAAA,EAoFyB,KAAA,CAAM,cApF/B,CAAA,OAoFqD,IAAA,CAAK,IApF1D,CAAA,CAAA,EAoF+D,oBAAA,CAAA,GAAA,CAAA,OApF/D;;iBAmGD,eAAA,CAnGC;EAAA,GAAA;AAAA,CAAA,EAmG6B,KAAA,CAAM,cAnGnC,CAAA,OAmGyD,gBAnGzD,CAAA,CAAA,EAmG0E,oBAAA,CAAA,GAAA,CAAA,OAnG1E;;iBA0GD,WAAA,CA1GC;EAAA,QAAA;EAAA,GAAA;AAAA,CAAA,EA0GmC,KAAA,CAAM,cA1GzC,CAAA,OA0G+D,UA1G/D,CAAA,CAAA,EA0G0E,oBAAA,CAAA,GAAA,CAAA,OAAA,GA1G1E,IAAA"}

package/dist/index31.d.ts

@@ -1,25 +1,71 @@
+import { i as FieldError, o as FieldLabel, r as FieldDescription, t as Field } from "./index29.js";
 import * as React from "react";
-import * as react_jsx_runtime164 from "react/jsx-runtime";
-import { HoverCard } from "radix-ui";
+import * as react_jsx_runtime103 from "react/jsx-runtime";
+import { Slot } from "radix-ui";
+import * as react_hook_form0 from "react-hook-form";
+import { ControllerProps, FieldPath, FieldValues } from "react-hook-form";
 
-//#region src/primitives/HoverCard/HoverCard.d.ts
-/** Root that reveals a floating card when the user hovers (or focuses) the trigger. */
-declare function HoverCard$1({
+//#region src/primitives/Form/Form.d.ts
+/** Root provider that shares one react-hook-form instance with all nested form pieces. */
+declare const Form: <TFieldValues extends FieldValues, TContext = any, TTransformedValues = TFieldValues>({
+  children,
+  watch,
+  getValues,
+  getFieldState,
+  setError,
+  clearErrors,
+  setValue,
+  setValues,
+  trigger,
+  formState,
+  resetField,
+  reset,
+  handleSubmit,
+  unregister,
+  control,
+  register,
+  setFocus,
+  subscribe
+}: react_hook_form0.FormProviderProps<TFieldValues, TContext, TTransformedValues>) => React.JSX.Element;
+/** Connects a single input to the form via RHF's `Controller`, exposing `field` to its render prop. */
+declare const FormField: <TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>({
   ...props
-}: React.ComponentProps<typeof HoverCard.Root>): react_jsx_runtime164.JSX.Element;
-/** The element that opens the hover card on pointer hover or keyboard focus. */
-declare function HoverCardTrigger({
+}: ControllerProps<TFieldValues, TName>) => react_jsx_runtime103.JSX.Element;
+/** Hook for form pieces to read the current field's id, name, ARIA ids, and validation state. */
+declare const useFormField: () => {
+  invalid: boolean;
+  isDirty: boolean;
+  isTouched: boolean;
+  isValidating: boolean;
+  error?: react_hook_form0.FieldError;
+  id: string;
+  name: string;
+  formItemId: string;
+  formDescriptionId: string;
+  formMessageId: string;
+};
+/** Wraps one field, generating an id so its label, control, and messages stay linked. */
+declare function FormItem({
   ...props
-}: React.ComponentProps<typeof HoverCard.Trigger>): react_jsx_runtime164.JSX.Element;
-/** The floating, portalled surface shown while the trigger is hovered/focused. */
-declare function HoverCardContent({
+}: React.ComponentProps<typeof Field>): react_jsx_runtime103.JSX.Element;
+/** Field label wired to the control's id and tinted destructive when the field is invalid. */
+declare function FormLabel({
   className,
-  /** Alignment of the content relative to the trigger along the chosen side. */
-  align,
-  /** Gap in pixels between the trigger and the content. */
-  sideOffset,
   ...props
-}: React.ComponentProps<typeof HoverCard.Content>): react_jsx_runtime164.JSX.Element;
+}: React.ComponentProps<typeof FieldLabel>): react_jsx_runtime103.JSX.Element;
+/** Slots the actual input, applying the field's id, `aria-describedby`, and `aria-invalid`. */
+declare function FormControl({
+  ...props
+}: React.ComponentProps<typeof Slot.Root>): react_jsx_runtime103.JSX.Element;
+/** Helper text for a field, linked to its control via `aria-describedby`. */
+declare function FormDescription({
+  ...props
+}: React.ComponentProps<typeof FieldDescription>): react_jsx_runtime103.JSX.Element;
+/** Renders the field's validation error (or `children`), and nothing when there is no message. */
+declare function FormMessage({
+  children,
+  ...props
+}: React.ComponentProps<typeof FieldError>): react_jsx_runtime103.JSX.Element | null;
 //#endregion
-export { HoverCardContent as n, HoverCardTrigger as r, HoverCard$1 as t };
+export { FormItem as a, useFormField as c, FormField as i, FormControl as n, FormLabel as o, FormDescription as r, FormMessage as s, Form as t };
 //# sourceMappingURL=index31.d.ts.map

package/dist/index31.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index31.d.ts","names":[],"sources":["../src/primitives/HoverCard/HoverCard.tsx"],"mappings":";;;;;;iBAMS,WAAA;;GAAwB,KAAA,CAAM,sBAAsB,SAAA,CAAmB,QAAK,oBAAA,CAAA,GAAA,CAAA;;AALjD,iBAU3B,gBAAA,CALS;EAAA,GAAA;AAAA,CAAA,EAKsB,KAAA,CAAM,cAL5B,CAAA,OAKkD,SAAA,CAAmB,OALrE,CAAA,CAAA,EAK6E,oBAAA,CAAA,GAAA,CAAA,OAL7E;;iBAUT,gBAAA,CAVuE;EAAA,SAAA;;;EAAK;EAAA,UAK5E;EAAA,GAAA;AAAgB,CAAhB,EAYN,KAAA,CAAM,cAZgB,CAAA,OAYM,SAAA,CAAmB,OAZzB,CAAA,CAAA,EAYiC,oBAAA,CAAA,GAAA,CAAA,OAZjC"}
+{"version":3,"file":"index31.d.ts","names":[],"sources":["../src/primitives/Form/Form.tsx"],"mappings":";;;;;;;;;cAqBM,4BAAI,kDAAA;;;;;;;;;;;;;;;;;;;GAAA,gBAAA,CAAA,kBAAA,cAAA,UAAA,wBAAA,KAAA,CAAA,GAAA,CAAA;;cAaJ,iCACiB,cAAc,2BACrB,UAAU,gBAAgB,UAAU;;GAGjD,gBAAgB,cAAc,WAAM,oBAAA,CAAA,GAAA,CAAA;AAzB8C;cAkC/E,YA3BmB,EAAA,GAAA,GAAA;SAAf,EAAA,OAAA;SAAA,EAAA,OAAA;WAAA,EAAA,OAAA;cAAA,EAAA,OAAA;OAAA,CAAA,EAgDT,gBAAA,CAAA,UAhDS;MAAA,MAAA;MAAA,EAAA,MAAA;YAAA,EAAA,MAAA;mBAAA,EAAA,MAAA;eAAA,EAAA,MAAA;;;iBA0DD,QAAA,CA1DC;EAAA,GAAA;AAAA,CAAA,EA0DsB,KAAA,CAAM,cA1D5B,CAAA,OA0DkD,KA1DlD,CAAA,CAAA,EA0DwD,oBAAA,CAAA,GAAA,CAAA,OA1DxD;;iBAqED,SAAA,CArEC;EAAA,SAAA;EAAA,GAAA;AAAA,CAAA,EAqEkC,KAAA,CAAM,cArExC,CAAA,OAqE8D,UArE9D,CAAA,CAAA,EAqEyE,oBAAA,CAAA,GAAA,CAAA,OArEzE;;iBAoFD,WAAA,CApFC;EAAA,GAAA;AAAA,CAAA,EAoFyB,KAAA,CAAM,cApF/B,CAAA,OAoFqD,IAAA,CAAK,IApF1D,CAAA,CAAA,EAoF+D,oBAAA,CAAA,GAAA,CAAA,OApF/D;;iBAmGD,eAAA,CAnGC;EAAA,GAAA;AAAA,CAAA,EAmG6B,KAAA,CAAM,cAnGnC,CAAA,OAmGyD,gBAnGzD,CAAA,CAAA,EAmG0E,oBAAA,CAAA,GAAA,CAAA,OAnG1E;;iBA0GD,WAAA,CA1GC;EAAA,QAAA;EAAA,GAAA;AAAA,CAAA,EA0GmC,KAAA,CAAM,cA1GzC,CAAA,OA0G+D,UA1G/D,CAAA,CAAA,EA0G0E,oBAAA,CAAA,GAAA,CAAA,OAAA,GA1G1E,IAAA"}

package/dist/index32.d.cts

@@ -1,88 +1,37 @@
-import * as react_jsx_runtime134 from "react/jsx-runtime";
-import * as class_variance_authority_types15 from "class-variance-authority/types";
+import * as react_jsx_runtime57 from "react/jsx-runtime";
+import * as class_variance_authority_types4 from "class-variance-authority/types";
 import { VariantProps } from "class-variance-authority";
 import * as React from "react";
-import { LucideProps } from "lucide-react";
 
-//#region src/primitives/Icon/icon-names.d.ts
-type IconName = "a-arrow-down" | "a-arrow-up" | "a-large-small" | "accessibility" | "activity" | "activity-square" | "air-vent" | "airplay" | "alarm-check" | "alarm-clock" | "alarm-clock-check" | "alarm-clock-minus" | "alarm-clock-off" | "alarm-clock-plus" | "alarm-minus" | "alarm-plus" | "alarm-smoke" | "album" | "alert-circle" | "alert-octagon" | "alert-triangle" | "align-center" | "align-center-horizontal" | "align-center-vertical" | "align-end-horizontal" | "align-end-vertical" | "align-horizontal-distribute-center" | "align-horizontal-distribute-end" | "align-horizontal-distribute-start" | "align-horizontal-justify-center" | "align-horizontal-justify-end" | "align-horizontal-justify-start" | "align-horizontal-space-around" | "align-horizontal-space-between" | "align-justify" | "align-left" | "align-right" | "align-start-horizontal" | "align-start-vertical" | "align-vertical-distribute-center" | "align-vertical-distribute-end" | "align-vertical-distribute-start" | "align-vertical-justify-center" | "align-vertical-justify-end" | "align-vertical-justify-start" | "align-vertical-space-around" | "align-vertical-space-between" | "ambulance" | "ampersand" | "ampersands" | "amphora" | "anchor" | "angry" | "annoyed" | "antenna" | "anvil" | "aperture" | "app-window" | "app-window-mac" | "apple" | "archive" | "archive-restore" | "archive-x" | "area-chart" | "armchair" | "arrow-big-down" | "arrow-big-down-dash" | "arrow-big-left" | "arrow-big-left-dash" | "arrow-big-right" | "arrow-big-right-dash" | "arrow-big-up" | "arrow-big-up-dash" | "arrow-down" | "arrow-down-0-1" | "arrow-down-01" | "arrow-down-1-0" | "arrow-down-10" | "arrow-down-a-z" | "arrow-down-az" | "arrow-down-circle" | "arrow-down-from-line" | "arrow-down-left" | "arrow-down-left-from-circle" | "arrow-down-left-from-square" | "arrow-down-left-square" | "arrow-down-narrow-wide" | "arrow-down-right" | "arrow-down-right-from-circle" | "arrow-down-right-from-square" | "arrow-down-right-square" | "arrow-down-square" | "arrow-down-to-dot" | "arrow-down-to-line" | "arrow-down-up" | "arrow-down-wide-narrow" | "arrow-down-z-a" | "arrow-down-za" | "arrow-left" | "arrow-left-circle" | "arrow-left-from-line" | "arrow-left-right" | "arrow-left-square" | "arrow-left-to-line" | "arrow-right" | "arrow-right-circle" | "arrow-right-from-line" | "arrow-right-left" | "arrow-right-square" | "arrow-right-to-line" | "arrow-up" | "arrow-up-0-1" | "arrow-up-01" | "arrow-up-1-0" | "arrow-up-10" | "arrow-up-a-z" | "arrow-up-az" | "arrow-up-circle" | "arrow-up-down" | "arrow-up-from-dot" | "arrow-up-from-line" | "arrow-up-left" | "arrow-up-left-from-circle" | "arrow-up-left-from-square" | "arrow-up-left-square" | "arrow-up-narrow-wide" | "arrow-up-right" | "arrow-up-right-from-circle" | "arrow-up-right-from-square" | "arrow-up-right-square" | "arrow-up-square" | "arrow-up-to-line" | "arrow-up-wide-narrow" | "arrow-up-z-a" | "arrow-up-za" | "arrows-up-from-line" | "asterisk" | "asterisk-square" | "at-sign" | "atom" | "audio-lines" | "audio-waveform" | "award" | "axe" | "axis-3-d" | "axis-3d" | "baby" | "backpack" | "badge" | "badge-alert" | "badge-cent" | "badge-check" | "badge-dollar-sign" | "badge-euro" | "badge-help" | "badge-indian-rupee" | "badge-info" | "badge-japanese-yen" | "badge-minus" | "badge-percent" | "badge-plus" | "badge-pound-sterling" | "badge-russian-ruble" | "badge-swiss-franc" | "badge-x" | "baggage-claim" | "ban" | "banana" | "bandage" | "banknote" | "banknote-arrow-down" | "banknote-arrow-up" | "banknote-x" | "bar-chart" | "bar-chart-2" | "bar-chart-3" | "bar-chart-4" | "bar-chart-big" | "bar-chart-horizontal" | "bar-chart-horizontal-big" | "barcode" | "baseline" | "bath" | "battery" | "battery-charging" | "battery-full" | "battery-low" | "battery-medium" | "battery-plus" | "battery-warning" | "beaker" | "bean" | "bean-off" | "bed" | "bed-double" | "bed-single" | "beef" | "beer" | "beer-off" | "bell" | "bell-dot" | "bell-electric" | "bell-minus" | "bell-off" | "bell-plus" | "bell-ring" | "between-horizonal-end" | "between-horizonal-start" | "between-horizontal-end" | "between-horizontal-start" | "between-vertical-end" | "between-vertical-start" | "biceps-flexed" | "bike" | "binary" | "binoculars" | "biohazard" | "bird" | "bitcoin" | "blend" | "blinds" | "blocks" | "bluetooth" | "bluetooth-connected" | "bluetooth-off" | "bluetooth-searching" | "bold" | "bolt" | "bomb" | "bone" | "book" | "book-a" | "book-audio" | "book-check" | "book-copy" | "book-dashed" | "book-down" | "book-headphones" | "book-heart" | "book-image" | "book-key" | "book-lock" | "book-marked" | "book-minus" | "book-open" | "book-open-check" | "book-open-text" | "book-plus" | "book-template" | "book-text" | "book-type" | "book-up" | "book-up-2" | "book-user" | "book-x" | "bookmark" | "bookmark-check" | "bookmark-minus" | "bookmark-plus" | "bookmark-x" | "boom-box" | "bot" | "bot-message-square" | "bot-off" | "box" | "box-select" | "boxes" | "braces" | "brackets" | "brain" | "brain-circuit" | "brain-cog" | "brick-wall" | "briefcase" | "briefcase-business" | "briefcase-conveyor-belt" | "briefcase-medical" | "bring-to-front" | "brush" | "bug" | "bug-off" | "bug-play" | "building" | "building-2" | "bus" | "bus-front" | "cable" | "cable-car" | "cake" | "cake-slice" | "calculator" | "calendar" | "calendar-1" | "calendar-arrow-down" | "calendar-arrow-up" | "calendar-check" | "calendar-check-2" | "calendar-clock" | "calendar-cog" | "calendar-days" | "calendar-fold" | "calendar-heart" | "calendar-minus" | "calendar-minus-2" | "calendar-off" | "calendar-plus" | "calendar-plus-2" | "calendar-range" | "calendar-search" | "calendar-sync" | "calendar-x" | "calendar-x-2" | "camera" | "camera-off" | "candlestick-chart" | "candy" | "candy-cane" | "candy-off" | "cannabis" | "captions" | "captions-off" | "car" | "car-front" | "car-taxi-front" | "caravan" | "carrot" | "case-lower" | "case-sensitive" | "case-upper" | "cassette-tape" | "cast" | "castle" | "cat" | "cctv" | "chart-area" | "chart-bar" | "chart-bar-big" | "chart-bar-decreasing" | "chart-bar-increasing" | "chart-bar-stacked" | "chart-candlestick" | "chart-column" | "chart-column-big" | "chart-column-decreasing" | "chart-column-increasing" | "chart-column-stacked" | "chart-gantt" | "chart-line" | "chart-network" | "chart-no-axes-column" | "chart-no-axes-column-decreasing" | "chart-no-axes-column-increasing" | "chart-no-axes-combined" | "chart-no-axes-gantt" | "chart-pie" | "chart-scatter" | "chart-spline" | "check" | "check-check" | "check-circle" | "check-circle-2" | "check-square" | "check-square-2" | "chef-hat" | "cherry" | "chevron-down" | "chevron-down-circle" | "chevron-down-square" | "chevron-first" | "chevron-last" | "chevron-left" | "chevron-left-circle" | "chevron-left-square" | "chevron-right" | "chevron-right-circle" | "chevron-right-square" | "chevron-up" | "chevron-up-circle" | "chevron-up-square" | "chevrons-down" | "chevrons-down-up" | "chevrons-left" | "chevrons-left-right" | "chevrons-left-right-ellipsis" | "chevrons-right" | "chevrons-right-left" | "chevrons-up" | "chevrons-up-down" | "chrome" | "church" | "cigarette" | "cigarette-off" | "circle" | "circle-alert" | "circle-arrow-down" | "circle-arrow-left" | "circle-arrow-out-down-left" | "circle-arrow-out-down-right" | "circle-arrow-out-up-left" | "circle-arrow-out-up-right" | "circle-arrow-right" | "circle-arrow-up" | "circle-check" | "circle-check-big" | "circle-chevron-down" | "circle-chevron-left" | "circle-chevron-right" | "circle-chevron-up" | "circle-dashed" | "circle-divide" | "circle-dollar-sign" | "circle-dot" | "circle-dot-dashed" | "circle-ellipsis" | "circle-equal" | "circle-fading-arrow-up" | "circle-fading-plus" | "circle-gauge" | "circle-help" | "circle-minus" | "circle-off" | "circle-parking" | "circle-parking-off" | "circle-pause" | "circle-percent" | "circle-play" | "circle-plus" | "circle-power" | "circle-slash" | "circle-slash-2" | "circle-slashed" | "circle-small" | "circle-stop" | "circle-user" | "circle-user-round" | "circle-x" | "circuit-board" | "citrus" | "clapperboard" | "clipboard" | "clipboard-check" | "clipboard-copy" | "clipboard-edit" | "clipboard-list" | "clipboard-minus" | "clipboard-paste" | "clipboard-pen" | "clipboard-pen-line" | "clipboard-plus" | "clipboard-signature" | "clipboard-type" | "clipboard-x" | "clock" | "clock-1" | "clock-10" | "clock-11" | "clock-12" | "clock-2" | "clock-3" | "clock-4" | "clock-5" | "clock-6" | "clock-7" | "clock-8" | "clock-9" | "clock-alert" | "clock-arrow-down" | "clock-arrow-up" | "clock-fading" | "cloud" | "cloud-alert" | "cloud-cog" | "cloud-download" | "cloud-drizzle" | "cloud-fog" | "cloud-hail" | "cloud-lightning" | "cloud-moon" | "cloud-moon-rain" | "cloud-off" | "cloud-rain" | "cloud-rain-wind" | "cloud-snow" | "cloud-sun" | "cloud-sun-rain" | "cloud-upload" | "cloudy" | "clover" | "club" | "code" | "code-2" | "code-square" | "code-xml" | "codepen" | "codesandbox" | "coffee" | "cog" | "coins" | "columns" | "columns-2" | "columns-3" | "columns-4" | "combine" | "command" | "compass" | "component" | "computer" | "concierge-bell" | "cone" | "construction" | "contact" | "contact-2" | "contact-round" | "container" | "contrast" | "cookie" | "cooking-pot" | "copy" | "copy-check" | "copy-minus" | "copy-plus" | "copy-slash" | "copy-x" | "copyleft" | "copyright" | "corner-down-left" | "corner-down-right" | "corner-left-down" | "corner-left-up" | "corner-right-down" | "corner-right-up" | "corner-up-left" | "corner-up-right" | "cpu" | "creative-commons" | "credit-card" | "croissant" | "crop" | "cross" | "crosshair" | "crown" | "cuboid" | "cup-soda" | "curly-braces" | "currency" | "cylinder" | "dam" | "database" | "database-backup" | "database-zap" | "delete" | "dessert" | "diameter" | "diamond" | "diamond-minus" | "diamond-percent" | "diamond-plus" | "dice-1" | "dice-2" | "dice-3" | "dice-4" | "dice-5" | "dice-6" | "dices" | "diff" | "disc" | "disc-2" | "disc-3" | "disc-album" | "divide" | "divide-circle" | "divide-square" | "dna" | "dna-off" | "dock" | "dog" | "dollar-sign" | "donut" | "door-closed" | "door-open" | "dot" | "dot-square" | "download" | "download-cloud" | "drafting-compass" | "drama" | "dribbble" | "drill" | "droplet" | "droplet-off" | "droplets" | "drum" | "drumstick" | "dumbbell" | "ear" | "ear-off" | "earth" | "earth-lock" | "eclipse" | "edit" | "edit-2" | "edit-3" | "egg" | "egg-fried" | "egg-off" | "ellipsis" | "ellipsis-vertical" | "equal" | "equal-approximately" | "equal-not" | "equal-square" | "eraser" | "ethernet-port" | "euro" | "expand" | "external-link" | "eye" | "eye-closed" | "eye-off" | "facebook" | "factory" | "fan" | "fast-forward" | "feather" | "fence" | "ferris-wheel" | "figma" | "file" | "file-archive" | "file-audio" | "file-audio-2" | "file-axis-3-d" | "file-axis-3d" | "file-badge" | "file-badge-2" | "file-bar-chart" | "file-bar-chart-2" | "file-box" | "file-chart-column" | "file-chart-column-increasing" | "file-chart-line" | "file-chart-pie" | "file-check" | "file-check-2" | "file-clock" | "file-code" | "file-code-2" | "file-cog" | "file-cog-2" | "file-diff" | "file-digit" | "file-down" | "file-edit" | "file-heart" | "file-image" | "file-input" | "file-json" | "file-json-2" | "file-key" | "file-key-2" | "file-line-chart" | "file-lock" | "file-lock-2" | "file-minus" | "file-minus-2" | "file-music" | "file-output" | "file-pen" | "file-pen-line" | "file-pie-chart" | "file-plus" | "file-plus-2" | "file-question" | "file-scan" | "file-search" | "file-search-2" | "file-signature" | "file-sliders" | "file-spreadsheet" | "file-stack" | "file-symlink" | "file-terminal" | "file-text" | "file-type" | "file-type-2" | "file-up" | "file-user" | "file-video" | "file-video-2" | "file-volume" | "file-volume-2" | "file-warning" | "file-x" | "file-x-2" | "files" | "film" | "filter" | "filter-x" | "fingerprint" | "fire-extinguisher" | "fish" | "fish-off" | "fish-symbol" | "flag" | "flag-off" | "flag-triangle-left" | "flag-triangle-right" | "flame" | "flame-kindling" | "flashlight" | "flashlight-off" | "flask-conical" | "flask-conical-off" | "flask-round" | "flip-horizontal" | "flip-horizontal-2" | "flip-vertical" | "flip-vertical-2" | "flower" | "flower-2" | "focus" | "fold-horizontal" | "fold-vertical" | "folder" | "folder-archive" | "folder-check" | "folder-clock" | "folder-closed" | "folder-code" | "folder-cog" | "folder-cog-2" | "folder-dot" | "folder-down" | "folder-edit" | "folder-git" | "folder-git-2" | "folder-heart" | "folder-input" | "folder-kanban" | "folder-key" | "folder-lock" | "folder-minus" | "folder-open" | "folder-open-dot" | "folder-output" | "folder-pen" | "folder-plus" | "folder-root" | "folder-search" | "folder-search-2" | "folder-symlink" | "folder-sync" | "folder-tree" | "folder-up" | "folder-x" | "folders" | "footprints" | "fork-knife" | "fork-knife-crossed" | "forklift" | "form-input" | "forward" | "frame" | "framer" | "frown" | "fuel" | "fullscreen" | "function-square" | "funnel" | "funnel-plus" | "funnel-x" | "gallery-horizontal" | "gallery-horizontal-end" | "gallery-thumbnails" | "gallery-vertical" | "gallery-vertical-end" | "gamepad" | "gamepad-2" | "gantt-chart" | "gantt-chart-square" | "gauge" | "gauge-circle" | "gavel" | "gem" | "ghost" | "gift" | "git-branch" | "git-branch-plus" | "git-commit" | "git-commit-horizontal" | "git-commit-vertical" | "git-compare" | "git-compare-arrows" | "git-fork" | "git-graph" | "git-merge" | "git-pull-request" | "git-pull-request-arrow" | "git-pull-request-closed" | "git-pull-request-create" | "git-pull-request-create-arrow" | "git-pull-request-draft" | "github" | "gitlab" | "glass-water" | "glasses" | "globe" | "globe-2" | "globe-lock" | "goal" | "grab" | "graduation-cap" | "grape" | "grid" | "grid-2-x-2" | "grid-2-x-2-check" | "grid-2-x-2-plus" | "grid-2-x-2-x" | "grid-2x2" | "grid-2x2-check" | "grid-2x2-plus" | "grid-2x2-x" | "grid-3-x-3" | "grid-3x3" | "grip" | "grip-horizontal" | "grip-vertical" | "group" | "guitar" | "ham" | "hammer" | "hand" | "hand-coins" | "hand-heart" | "hand-helping" | "hand-metal" | "hand-platter" | "handshake" | "hard-drive" | "hard-drive-download" | "hard-drive-upload" | "hard-hat" | "hash" | "haze" | "hdmi-port" | "heading" | "heading-1" | "heading-2" | "heading-3" | "heading-4" | "heading-5" | "heading-6" | "headphone-off" | "headphones" | "headset" | "heart" | "heart-crack" | "heart-handshake" | "heart-off" | "heart-pulse" | "heater" | "help-circle" | "helping-hand" | "hexagon" | "highlighter" | "history" | "home" | "hop" | "hop-off" | "hospital" | "hotel" | "hourglass" | "house" | "house-plug" | "house-plus" | "house-wifi" | "ice-cream" | "ice-cream-2" | "ice-cream-bowl" | "ice-cream-cone" | "id-card" | "image" | "image-down" | "image-minus" | "image-off" | "image-play" | "image-plus" | "image-up" | "image-upscale" | "images" | "import" | "inbox" | "indent" | "indent-decrease" | "indent-increase" | "indian-rupee" | "infinity" | "info" | "inspect" | "inspection-panel" | "instagram" | "italic" | "iteration-ccw" | "iteration-cw" | "japanese-yen" | "joystick" | "kanban" | "kanban-square" | "kanban-square-dashed" | "key" | "key-round" | "key-square" | "keyboard" | "keyboard-music" | "keyboard-off" | "lamp" | "lamp-ceiling" | "lamp-desk" | "lamp-floor" | "lamp-wall-down" | "lamp-wall-up" | "land-plot" | "landmark" | "languages" | "laptop" | "laptop-2" | "laptop-minimal" | "laptop-minimal-check" | "lasso" | "lasso-select" | "laugh" | "layers" | "layers-2" | "layers-3" | "layout" | "layout-dashboard" | "layout-grid" | "layout-list" | "layout-panel-left" | "layout-panel-top" | "layout-template" | "leaf" | "leafy-green" | "lectern" | "letter-text" | "library" | "library-big" | "library-square" | "life-buoy" | "ligature" | "lightbulb" | "lightbulb-off" | "line-chart" | "link" | "link-2" | "link-2-off" | "linkedin" | "list" | "list-check" | "list-checks" | "list-collapse" | "list-end" | "list-filter" | "list-filter-plus" | "list-minus" | "list-music" | "list-ordered" | "list-plus" | "list-restart" | "list-start" | "list-todo" | "list-tree" | "list-video" | "list-x" | "loader" | "loader-2" | "loader-circle" | "loader-pinwheel" | "locate" | "locate-fixed" | "locate-off" | "lock" | "lock-keyhole" | "lock-keyhole-open" | "lock-open" | "log-in" | "log-out" | "logs" | "lollipop" | "luggage" | "m-square" | "magnet" | "mail" | "mail-check" | "mail-minus" | "mail-open" | "mail-plus" | "mail-question" | "mail-search" | "mail-warning" | "mail-x" | "mailbox" | "mails" | "map" | "map-pin" | "map-pin-check" | "map-pin-check-inside" | "map-pin-house" | "map-pin-minus" | "map-pin-minus-inside" | "map-pin-off" | "map-pin-plus" | "map-pin-plus-inside" | "map-pin-x" | "map-pin-x-inside" | "map-pinned" | "map-plus" | "mars" | "mars-stroke" | "martini" | "maximize" | "maximize-2" | "medal" | "megaphone" | "megaphone-off" | "meh" | "memory-stick" | "menu" | "menu-square" | "merge" | "message-circle" | "message-circle-code" | "message-circle-dashed" | "message-circle-heart" | "message-circle-more" | "message-circle-off" | "message-circle-plus" | "message-circle-question" | "message-circle-reply" | "message-circle-warning" | "message-circle-x" | "message-square" | "message-square-code" | "message-square-dashed" | "message-square-diff" | "message-square-dot" | "message-square-heart" | "message-square-lock" | "message-square-more" | "message-square-off" | "message-square-plus" | "message-square-quote" | "message-square-reply" | "message-square-share" | "message-square-text" | "message-square-warning" | "message-square-x" | "messages-square" | "mic" | "mic-2" | "mic-off" | "mic-vocal" | "microchip" | "microscope" | "microwave" | "milestone" | "milk" | "milk-off" | "minimize" | "minimize-2" | "minus" | "minus-circle" | "minus-square" | "monitor" | "monitor-check" | "monitor-cog" | "monitor-dot" | "monitor-down" | "monitor-off" | "monitor-pause" | "monitor-play" | "monitor-smartphone" | "monitor-speaker" | "monitor-stop" | "monitor-up" | "monitor-x" | "moon" | "moon-star" | "more-horizontal" | "more-vertical" | "mountain" | "mountain-snow" | "mouse" | "mouse-off" | "mouse-pointer" | "mouse-pointer-2" | "mouse-pointer-ban" | "mouse-pointer-click" | "mouse-pointer-square-dashed" | "move" | "move-3-d" | "move-3d" | "move-diagonal" | "move-diagonal-2" | "move-down" | "move-down-left" | "move-down-right" | "move-horizontal" | "move-left" | "move-right" | "move-up" | "move-up-left" | "move-up-right" | "move-vertical" | "music" | "music-2" | "music-3" | "music-4" | "navigation" | "navigation-2" | "navigation-2-off" | "navigation-off" | "network" | "newspaper" | "nfc" | "non-binary" | "notebook" | "notebook-pen" | "notebook-tabs" | "notebook-text" | "notepad-text" | "notepad-text-dashed" | "nut" | "nut-off" | "octagon" | "octagon-alert" | "octagon-minus" | "octagon-pause" | "octagon-x" | "omega" | "option" | "orbit" | "origami" | "outdent" | "package" | "package-2" | "package-check" | "package-minus" | "package-open" | "package-plus" | "package-search" | "package-x" | "paint-bucket" | "paint-roller" | "paintbrush" | "paintbrush-2" | "paintbrush-vertical" | "palette" | "palmtree" | "panel-bottom" | "panel-bottom-close" | "panel-bottom-dashed" | "panel-bottom-inactive" | "panel-bottom-open" | "panel-left" | "panel-left-close" | "panel-left-dashed" | "panel-left-inactive" | "panel-left-open" | "panel-right" | "panel-right-close" | "panel-right-dashed" | "panel-right-inactive" | "panel-right-open" | "panel-top" | "panel-top-close" | "panel-top-dashed" | "panel-top-inactive" | "panel-top-open" | "panels-left-bottom" | "panels-left-right" | "panels-right-bottom" | "panels-top-bottom" | "panels-top-left" | "paperclip" | "parentheses" | "parking-circle" | "parking-circle-off" | "parking-meter" | "parking-square" | "parking-square-off" | "party-popper" | "pause" | "pause-circle" | "pause-octagon" | "paw-print" | "pc-case" | "pen" | "pen-box" | "pen-line" | "pen-off" | "pen-square" | "pen-tool" | "pencil" | "pencil-line" | "pencil-off" | "pencil-ruler" | "pentagon" | "percent" | "percent-circle" | "percent-diamond" | "percent-square" | "person-standing" | "philippine-peso" | "phone" | "phone-call" | "phone-forwarded" | "phone-incoming" | "phone-missed" | "phone-off" | "phone-outgoing" | "pi" | "pi-square" | "piano" | "pickaxe" | "picture-in-picture" | "picture-in-picture-2" | "pie-chart" | "piggy-bank" | "pilcrow" | "pilcrow-left" | "pilcrow-right" | "pilcrow-square" | "pill" | "pill-bottle" | "pin" | "pin-off" | "pipette" | "pizza" | "plane" | "plane-landing" | "plane-takeoff" | "play" | "play-circle" | "play-square" | "plug" | "plug-2" | "plug-zap" | "plug-zap-2" | "plus" | "plus-circle" | "plus-square" | "pocket" | "pocket-knife" | "podcast" | "pointer" | "pointer-off" | "popcorn" | "popsicle" | "pound-sterling" | "power" | "power-circle" | "power-off" | "power-square" | "presentation" | "printer" | "printer-check" | "projector" | "proportions" | "puzzle" | "pyramid" | "qr-code" | "quote" | "rabbit" | "radar" | "radiation" | "radical" | "radio" | "radio-receiver" | "radio-tower" | "radius" | "rail-symbol" | "rainbow" | "rat" | "ratio" | "receipt" | "receipt-cent" | "receipt-euro" | "receipt-indian-rupee" | "receipt-japanese-yen" | "receipt-pound-sterling" | "receipt-russian-ruble" | "receipt-swiss-franc" | "receipt-text" | "rectangle-ellipsis" | "rectangle-horizontal" | "rectangle-vertical" | "recycle" | "redo" | "redo-2" | "redo-dot" | "refresh-ccw" | "refresh-ccw-dot" | "refresh-cw" | "refresh-cw-off" | "refrigerator" | "regex" | "remove-formatting" | "repeat" | "repeat-1" | "repeat-2" | "replace" | "replace-all" | "reply" | "reply-all" | "rewind" | "ribbon" | "rocket" | "rocking-chair" | "roller-coaster" | "rotate-3-d" | "rotate-3d" | "rotate-ccw" | "rotate-ccw-square" | "rotate-cw" | "rotate-cw-square" | "route" | "route-off" | "router" | "rows" | "rows-2" | "rows-3" | "rows-4" | "rss" | "ruler" | "russian-ruble" | "sailboat" | "salad" | "sandwich" | "satellite" | "satellite-dish" | "saudi-riyal" | "save" | "save-all" | "save-off" | "scale" | "scale-3-d" | "scale-3d" | "scaling" | "scan" | "scan-barcode" | "scan-eye" | "scan-face" | "scan-heart" | "scan-line" | "scan-qr-code" | "scan-search" | "scan-text" | "scatter-chart" | "school" | "school-2" | "scissors" | "scissors-line-dashed" | "scissors-square" | "scissors-square-dashed-bottom" | "screen-share" | "screen-share-off" | "scroll" | "scroll-text" | "search" | "search-check" | "search-code" | "search-slash" | "search-x" | "section" | "send" | "send-horizonal" | "send-horizontal" | "send-to-back" | "separator-horizontal" | "separator-vertical" | "server" | "server-cog" | "server-crash" | "server-off" | "settings" | "settings-2" | "shapes" | "share" | "share-2" | "sheet" | "shell" | "shield" | "shield-alert" | "shield-ban" | "shield-check" | "shield-close" | "shield-ellipsis" | "shield-half" | "shield-minus" | "shield-off" | "shield-plus" | "shield-question" | "shield-user" | "shield-x" | "ship" | "ship-wheel" | "shirt" | "shopping-bag" | "shopping-basket" | "shopping-cart" | "shovel" | "shower-head" | "shrimp" | "shrink" | "shrub" | "shuffle" | "sidebar" | "sidebar-close" | "sidebar-open" | "sigma" | "sigma-square" | "signal" | "signal-high" | "signal-low" | "signal-medium" | "signal-zero" | "signature" | "signpost" | "signpost-big" | "siren" | "skip-back" | "skip-forward" | "skull" | "slack" | "slash" | "slash-square" | "slice" | "sliders" | "sliders-horizontal" | "sliders-vertical" | "smartphone" | "smartphone-charging" | "smartphone-nfc" | "smile" | "smile-plus" | "snail" | "snowflake" | "sofa" | "sort-asc" | "sort-desc" | "soup" | "space" | "spade" | "sparkle" | "sparkles" | "speaker" | "speech" | "spell-check" | "spell-check-2" | "spline" | "spline-pointer" | "split" | "split-square-horizontal" | "split-square-vertical" | "spray-can" | "sprout" | "square" | "square-activity" | "square-arrow-down" | "square-arrow-down-left" | "square-arrow-down-right" | "square-arrow-left" | "square-arrow-out-down-left" | "square-arrow-out-down-right" | "square-arrow-out-up-left" | "square-arrow-out-up-right" | "square-arrow-right" | "square-arrow-up" | "square-arrow-up-left" | "square-arrow-up-right" | "square-asterisk" | "square-bottom-dashed-scissors" | "square-chart-gantt" | "square-check" | "square-check-big" | "square-chevron-down" | "square-chevron-left" | "square-chevron-right" | "square-chevron-up" | "square-code" | "square-dashed" | "square-dashed-bottom" | "square-dashed-bottom-code" | "square-dashed-kanban" | "square-dashed-mouse-pointer" | "square-divide" | "square-dot" | "square-equal" | "square-function" | "square-gantt-chart" | "square-kanban" | "square-library" | "square-m" | "square-menu" | "square-minus" | "square-mouse-pointer" | "square-parking" | "square-parking-off" | "square-pen" | "square-percent" | "square-pi" | "square-pilcrow" | "square-play" | "square-plus" | "square-power" | "square-radical" | "square-round-corner" | "square-scissors" | "square-sigma" | "square-slash" | "square-split-horizontal" | "square-split-vertical" | "square-square" | "square-stack" | "square-terminal" | "square-user" | "square-user-round" | "square-x" | "squircle" | "squirrel" | "stamp" | "star" | "star-half" | "star-off" | "stars" | "step-back" | "step-forward" | "stethoscope" | "sticker" | "sticky-note" | "stop-circle" | "store" | "stretch-horizontal" | "stretch-vertical" | "strikethrough" | "subscript" | "subtitles" | "sun" | "sun-dim" | "sun-medium" | "sun-moon" | "sun-snow" | "sunrise" | "sunset" | "superscript" | "swatch-book" | "swiss-franc" | "switch-camera" | "sword" | "swords" | "syringe" | "table" | "table-2" | "table-cells-merge" | "table-cells-split" | "table-columns-split" | "table-of-contents" | "table-properties" | "table-rows-split" | "tablet" | "tablet-smartphone" | "tablets" | "tag" | "tags" | "tally-1" | "tally-2" | "tally-3" | "tally-4" | "tally-5" | "tangent" | "target" | "telescope" | "tent" | "tent-tree" | "terminal" | "terminal-square" | "test-tube" | "test-tube-2" | "test-tube-diagonal" | "test-tubes" | "text" | "text-cursor" | "text-cursor-input" | "text-quote" | "text-search" | "text-select" | "text-selection" | "theater" | "thermometer" | "thermometer-snowflake" | "thermometer-sun" | "thumbs-down" | "thumbs-up" | "ticket" | "ticket-check" | "ticket-minus" | "ticket-percent" | "ticket-plus" | "ticket-slash" | "ticket-x" | "tickets" | "tickets-plane" | "timer" | "timer-off" | "timer-reset" | "toggle-left" | "toggle-right" | "toilet" | "tornado" | "torus" | "touchpad" | "touchpad-off" | "tower-control" | "toy-brick" | "tractor" | "traffic-cone" | "train" | "train-front" | "train-front-tunnel" | "train-track" | "tram-front" | "transgender" | "trash" | "trash-2" | "tree-deciduous" | "tree-palm" | "tree-pine" | "trees" | "trello" | "trending-down" | "trending-up" | "trending-up-down" | "triangle" | "triangle-alert" | "triangle-dashed" | "triangle-right" | "trophy" | "truck" | "turtle" | "tv" | "tv-2" | "tv-minimal" | "tv-minimal-play" | "twitch" | "twitter" | "type" | "type-outline" | "umbrella" | "umbrella-off" | "underline" | "undo" | "undo-2" | "undo-dot" | "unfold-horizontal" | "unfold-vertical" | "ungroup" | "university" | "unlink" | "unlink-2" | "unlock" | "unlock-keyhole" | "unplug" | "upload" | "upload-cloud" | "usb" | "user" | "user-2" | "user-check" | "user-check-2" | "user-circle" | "user-circle-2" | "user-cog" | "user-cog-2" | "user-minus" | "user-minus-2" | "user-pen" | "user-plus" | "user-plus-2" | "user-round" | "user-round-check" | "user-round-cog" | "user-round-minus" | "user-round-pen" | "user-round-plus" | "user-round-search" | "user-round-x" | "user-search" | "user-square" | "user-square-2" | "user-x" | "user-x-2" | "users" | "users-2" | "users-round" | "utensils" | "utensils-crossed" | "utility-pole" | "variable" | "vault" | "vegan" | "venetian-mask" | "venus" | "venus-and-mars" | "verified" | "vibrate" | "vibrate-off" | "video" | "video-off" | "videotape" | "view" | "voicemail" | "volleyball" | "volume" | "volume-1" | "volume-2" | "volume-off" | "volume-x" | "vote" | "wallet" | "wallet-2" | "wallet-cards" | "wallet-minimal" | "wallpaper" | "wand" | "wand-2" | "wand-sparkles" | "warehouse" | "washing-machine" | "watch" | "waves" | "waves-ladder" | "waypoints" | "webcam" | "webhook" | "webhook-off" | "weight" | "wheat" | "wheat-off" | "whole-word" | "wifi" | "wifi-high" | "wifi-low" | "wifi-off" | "wifi-zero" | "wind" | "wind-arrow-down" | "wine" | "wine-off" | "workflow" | "worm" | "wrap-text" | "wrench" | "x" | "x-circle" | "x-octagon" | "x-square" | "youtube" | "zap" | "zap-off" | "zoom-in" | "zoom-out";
-/** Runtime set of valid icon names (for validation / iteration). */
-declare const ICON_NAMES: Set<IconName>;
-//# sourceMappingURL=icon-names.d.ts.map
-//#endregion
-//#region src/primitives/Icon/Icon.d.ts
-declare const ICON_SIZE: {
-  readonly xs: "size-3";
-  readonly sm: "size-3.5";
-  readonly md: "size-4";
-  readonly lg: "size-5";
-  readonly xl: "size-6";
-};
-/** Container (box) styling — combines shape + fill tone + color. */
-declare const iconBoxVariants: (props?: ({
-  shape?: "round" | "square" | null | undefined;
-  color?: "default" | "muted" | "primary" | "destructive" | "success" | "inverted" | null | undefined;
-  fill?: "subtle" | "solid" | null | undefined;
-} & class_variance_authority_types15.ClassProp) | undefined) => string;
-type IconSize = keyof typeof ICON_SIZE;
-/**
- * Any component usable as the icon glyph via `as` — a lucide icon component, or
- * a custom icon component of your own. It just has to accept `className` (and,
- * ideally, standard `<svg>` props); most icon components do.
- */
-type IconComponent = React.ComponentType<LucideProps>;
-type IconSharedProps = VariantProps<typeof iconBoxVariants> & {
-  /** Glyph size from the `xs`–`xl` scale (and the box padding when `shape` is set). */
-  size?: IconSize;
-  /**
-   * Wrap the icon in a {@link shape} container. Omit for a bare icon.
-   * When set, `fill` controls the background tone and `color` the accent.
-   */
-  shape?: "square" | "round";
-  /** lucide stroke width passthrough (lucide accepts number or string). */
-  strokeWidth?: number | string;
-  /**
-   * Accessible label. When provided the icon is exposed as `role="img"`;
-   * otherwise it is decorative (`aria-hidden`) — unless you pass your own
-   * `role`/`aria-label`, which always win.
-   */
-  label?: string;
+//#region src/primitives/Heading/Heading.d.ts
+declare const headingVariants: (props?: ({
+  size?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | null | undefined;
+  weight?: "normal" | "medium" | "semibold" | null | undefined;
+  align?: "center" | "left" | "right" | null | undefined;
+  gradient?: boolean | null | undefined;
+} & class_variance_authority_types4.ClassProp) | undefined) => string;
+type HeadingProps = React.ComponentProps<"h2"> & VariantProps<typeof headingVariants> & {
+  /** Semantic heading level/element. Defaults to `h2`. */
+  as?: React.ElementType;
+  /** Visual step on the Figma heading scale (1 largest → 7 smallest); also sets the per-step default weight. */
+  size?: VariantProps<typeof headingVariants>["size"];
+  /** Override the per-step default weight. */
+  weight?: VariantProps<typeof headingVariants>["weight"];
+  /** Text alignment. */
+  align?: VariantProps<typeof headingVariants>["align"];
+  /** When true, fills the text with the brand gradient instead of the foreground colour. */
+  gradient?: VariantProps<typeof headingVariants>["gradient"];
 };
-/**
- * Provide exactly one glyph source:
- *  - `icon` — a lucide icon NAME (string). Lazily code-split (one chunk per icon
- *    loaded on demand); ideal for app/content icons picked at runtime. Renders a
- *    `<span>` wrapper, so rest props are span props.
- *  - `as` — an icon COMPONENT (lucide *or* your own custom icon). Rendered
- *    synchronously (no Suspense) and, when un-boxed, as a bare `<svg>`, so it
- *    slots into components that style a direct-child `[&>svg]` — rest props are
- *    svg (Lucide) props. Ideal inside components and for static/custom icons.
- *  (`size` is always the DS scale, never Lucide's numeric size.)
- */
-type IconProps = (Omit<React.ComponentProps<"span">, "color"> & IconSharedProps & {
-  icon: IconName;
-  as?: never;
-}) | (Omit<LucideProps, "color" | "size" | "fill"> & IconSharedProps & {
-  as: IconComponent;
-  icon?: never;
-});
-/**
- * Icon with size/color tokens and an optional boxed (square/round) container.
- * Pass `icon` (a lucide name, lazily code-split) or `as` (an icon component —
- * lucide or your own custom one — rendered synchronously).
- */
-declare function Icon({
-  icon,
-  as: AsIcon,
-  size,
-  color,
-  shape,
-  fill,
-  strokeWidth,
-  label,
+/** Display/section title using the design-system heading scale; `size` sets the visual step, `as` the semantic element. */
+declare function Heading({
+  as,
   className,
+  size,
+  weight,
+  align,
+  gradient,
   ...props
-}: IconProps): react_jsx_runtime134.JSX.Element;
+}: HeadingProps): react_jsx_runtime57.JSX.Element;
 //#endregion
-export { IconName as i, IconProps as n, ICON_NAMES as r, Icon as t };
+export { HeadingProps as n, headingVariants as r, Heading as t };
 //# sourceMappingURL=index32.d.cts.map

package/dist/index32.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index32.d.cts","names":[],"sources":["../src/primitives/Icon/icon-names.ts","../src/primitives/Icon/Icon.tsx"],"mappings":";;;;;;;KAGY,QAAA;;cA+uDC,YAAU,IAAA;;;;cCptDjB;;;ED3BM,SAAA,EAAQ,EAAA,QAAA;EA+uDP,SAAA,EAAA,EA6uDX,QAAA;EAAA,SAAA,EAAA,EAAA,QAAA;;;AA7uDqB,cC5qDjB,eD4qDiB,EAAA,CAAA,KC9sDb,CD8sDa,EAAA,CAAA;;;;AC7uDsB,CAAA,GA+G3C,gCAAA,CAAA,SAhFQ,CAAA,GAAA,SAAA,EAAA,GAAA,MAAA;AAAA,KAkFL,QAAA,GAhDC,MA8CJ,OAE2B,SAF3B;;AAEoC;;;;AAOE,KAAnC,aAAA,GAAgB,KAAA,CAAM,aAAa,CAAC,WAAD,CAAA;AAAA,KAEnC,eAAA,GAAkB,YAAH,CAAA,OAAuB,eAAvB,CAAA,GAAA;EAAA;MAAuB,CAAA,EAElC,QAFkC;;;AAE1B;AAAA;EA2BH,KAAA,CAAA,EAAA,QAAA,GAAA,OAAA;;aACT,CAAA,EAAA,MAAA,GAAA,MAAA;;;;;;OAEyB,CAAA,EAAA,MAAA;AAAa,CAAA;AAAA;;;;;;;;;;;KAHtC,SAAA,GAqBF,CApBE,IAoBF,CApBO,KAAA,CAAM,cAoBb,CAAA,MAAA,CAAA,EAAA,OAAA,CAAA,GApBgD,eAoBhD,GAAA;MAAS,EApBiE,QAoBjE;EAAA,EAAA,CAAA,EAAA,KAAA;MAnBP,KAAK,0CACJ;MAAwB;;;;;;;;iBAOrB,IAAA;;MAEH;;;;;;;;;GASH,YAAS,oBAAA,CAAA,GAAA,CAAA"}
+{"version":3,"file":"index32.d.cts","names":[],"sources":["../src/primitives/Heading/Heading.tsx"],"mappings":";;;;;;cAUM,uBAiCW;;;;EAjCX,QAAA,CAAA,EAAA,OA+BJ,GAAA,IAAA,GAAA,SAAA;IAAA,+BAAA,CAAA,SAEe,CAAA,GAAA,SAAA,EAAA,GAAA,MAAA;KAAZ,YAAA,GAAe,KAAA,CAAM,cAAT,CAAA,IAAA,CAAA,GACf,YADe,CAAA,OACK,eADL,CAAA,GAAA;;KACK,EAEb,KAAA,CAAM,WAFO;;MAEb,CAAA,EAEE,YAFI,CAAA,OAEgB,eAFhB,CAAA,CAAA,MAAA,CAAA;;QAEJ,CAAA,EAEE,YAFF,CAAA,OAEsB,eAFtB,CAAA,CAAA,QAAA,CAAA;;OAEE,CAAA,EAED,YAFC,CAAA,OAEmB,eAFnB,CAAA,CAAA,OAAA,CAAA;;UAED,CAAA,EAEG,YAFH,CAAA,OAEuB,eAFvB,CAAA,CAAA,UAAA,CAAA;;;AAEe,iBAIlB,OAAA,CAJkB;EAAA,EAAA;EAAA,SAAA;EAAA,IAAA;EAAA,MAAA;EAAA,KAAA;EAAA,QAAA;EAAA,GAAA;AAAA,CAAA,EAIkD,YAJlD,CAAA,EAI8D,mBAAA,CAAA,GAAA,CAAA,OAJ9D"}