@vkzstudio/muza-ui 1.0.17 → 1.0.19

package/dist/components/FileUpload/FileUpload.d.ts

@@ -6,6 +6,20 @@ declare const fileUploadVariants: (props?: ({
     isDragActive?: boolean | null | undefined;
     disabled?: boolean | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
+/**
+ * Represents a remote file that is already uploaded and accessible via URL.
+ * Used to display previously-uploaded files without re-fetching them as `File` objects.
+ */
+export interface PreselectedUrl {
+    /** Direct URL to the file. */
+    url: string;
+    /** Display name for the file. */
+    name: string;
+    /** MIME type — if starts with `"image/"`, shows thumbnail. Falls back to extension sniffing from name. */
+    type?: string;
+    /** File size in bytes (for display). */
+    size?: number;
+}
 /**
  * Props for the FileUpload component.
  * Extends standard div attributes except `onDrop`, `onError`, and `onChange`
@@ -36,12 +50,16 @@ export interface FileUploadProps extends Omit<React.HTMLAttributes<HTMLDivElemen
     readOnly?: boolean;
     /** Title text displayed inside the dropzone area. Defaults to a translated string. */
     title?: string;
-    /** Label displayed above the upload area. Renders as a `<label>` when passed as a string. */
-    label?: React.ReactNode;
+    /** Label displayed above the upload area. */
+    label?: string;
     /** Subtitle text displayed below the title inside the dropzone. */
     subtitle?: string;
     /** Applies error border and text styling to the dropzone. */
     error?: boolean;
+    /** Marks the field as required and displays a red asterisk next to the label. @default false */
+    required?: boolean;
+    /** Hides the required asterisk even when `required` is true. @default false */
+    disableRequiredAsterisk?: boolean;
     /**
      * Additional options passed to react-dropzone.
      * Props managed by the component (`onDrop`, `accept`, `multiple`, `maxSize`, `disabled`) are excluded.
@@ -81,6 +99,10 @@ export interface FileUploadProps extends Omit<React.HTMLAttributes<HTMLDivElemen
     onDelete?: (file: File, index: number) => void;
     /** Fires when the file list changes. Receives the updated array of all files. */
     onChange?: (files: File[]) => void;
+    /** Already-uploaded files to display via URL, without needing `File` objects. @default [] */
+    preselectedUrls?: PreselectedUrl[];
+    /** Fires when a URL-backed item is deleted. Receives the item and its index in the `preselectedUrls` array. */
+    onDeleteUrl?: (item: PreselectedUrl, index: number) => void;
 }
 declare const FileUpload: React.ForwardRefExoticComponent<FileUploadProps & React.RefAttributes<HTMLDivElement>>;
 export { FileUpload };

package/dist/components/FileUpload/FileUpload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileUpload.d.ts","sourceRoot":"","sources":["../../../src/components/FileUpload/FileUpload.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,KAAK,YAAY,EAAO,MAAM,0BAA0B,CAAA;AACjE,OAAO,EAAE,KAAK,eAAe,EAAe,MAAM,gBAAgB,CAAA;AAQlE,QAAA,MAAM,kBAAkB;;;;8EAoCvB,CAAA;AAgBD;;;;GAIG;AACH,MAAM,WAAW,eACf,SAAQ,IAAI,CACR,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EACpC,QAAQ,GAAG,SAAS,GAAG,UAAU,CAClC,EACD,IAAI,CAAC,YAAY,CAAC,OAAO,kBAAkB,CAAC,EAAE,cAAc,CAAC;IAC/D,kFAAkF;IAClF,MAAM,CAAC,EAAE,CAAC,aAAa,EAAE,IAAI,EAAE,KAAK,IAAI,CAAA;IACxC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gHAAgH;IAChH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,0EAA0E;IAC1E,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAA;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6FAA6F;IAC7F,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;;OAIG;IACH,eAAe,CAAC,EAAE,IAAI,CACpB,eAAe,EACf,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAC1D,CAAA;IACD,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,IAAI,EAAE,CAAA;IACzB;;;;OAIG;IACH,UAAU,CAAC,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACvD;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC9B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC7B,mGAAmG;IACnG,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,KAAK,IAAI,CAAA;IAC9C,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9C,iFAAiF;IACjF,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAA;CACnC;AAED,QAAA,MAAM,UAAU,wFA+Mf,CAAA;AAGD,OAAO,EAAE,UAAU,EAAE,CAAA"}
+{"version":3,"file":"FileUpload.d.ts","sourceRoot":"","sources":["../../../src/components/FileUpload/FileUpload.tsx"],"names":[],"mappings":"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"}

package/dist/components/FileUpload/FileUpload.js

@@ -1,14 +1,15 @@
-import { jsxs as n, jsx as i } from "react/jsx-runtime";
-import * as y from "react";
-import { cva as P } from "class-variance-authority";
-import { useDropzone as D } from "react-dropzone";
-import { FileItem as H } from "./FileItem.js";
-import { useMuzaTranslations as E } from "../../translations/TranslationContext.js";
-import { Flex as j } from "../Flex/Flex.js";
-import { Typography as x } from "../Typography/Typography.js";
-import { cn as A } from "../../utils/cn.js";
-import { CloudUploadOutline as C } from "@solar-icons/react-perf";
-const ee = P(
+import { jsxs as f, jsx as a, Fragment as ee } from "react/jsx-runtime";
+import * as F from "react";
+import { cva as B } from "class-variance-authority";
+import { useDropzone as oe } from "react-dropzone";
+import { FileItem as K } from "./FileItem.js";
+import { useMuzaTranslations as te } from "../../translations/TranslationContext.js";
+import { Flex as re } from "../Flex/Flex.js";
+import { FormField as le } from "../FormField/FormField.js";
+import { cn as _ } from "../../utils/cn.js";
+import { CloudUploadOutline as se } from "@solar-icons/react-perf";
+import { Typography as S } from "../Typography/Typography.js";
+const ie = B(
   [
     "group relative cursor-pointer rounded-xl border-1 border-dashed transition-colors",
     "p-4xl pt-3xl pr-4xl pb-3xl",
@@ -44,7 +45,7 @@ const ee = P(
       }
     }
   }
-), te = P(
+), ae = B(
   [
     "text-center transition-colors",
     "text-comp-file-upload-text-dark-secondary"
@@ -56,161 +57,186 @@ const ee = P(
       }
     }
   }
-), oe = y.forwardRef(
+), de = F.forwardRef(
   ({
-    className: S,
-    onDrop: g,
-    accept: f,
-    multiple: U = !0,
-    maxSize: b,
-    maxSizeErrorMessage: T,
-    size: V = "base",
+    className: y,
+    onDrop: x,
+    accept: u,
+    multiple: k = !0,
+    maxSize: g,
+    maxSizeErrorMessage: G,
+    size: $ = "base",
     disabled: p = !1,
-    readOnly: h = !1,
-    dropzoneOptions: K,
-    label: m,
-    title: _,
-    subtitle: k,
-    preselectedFiles: q = [],
-    fileStatus: B = [],
-    itemErrors: v,
-    itemHints: z,
-    error: G,
-    onError: o,
-    onDelete: M,
+    readOnly: m = !1,
+    dropzoneOptions: J,
+    label: w,
+    title: L,
+    subtitle: N,
+    preselectedFiles: Q = [],
+    fileStatus: W = [],
+    itemErrors: b,
+    itemHints: h,
+    error: X,
+    required: v,
+    disableRequiredAsterisk: Y,
+    onError: t,
+    onDelete: z,
     onChange: c,
-    ...J
-  }, L) => {
-    const u = E(), [w, F] = y.useState(q), [N, $] = y.useState(!1), O = _ ?? u.fileUpload.title, I = b ? u.fileUpload.maxSizeError.replace(
+    preselectedUrls: U = [],
+    onDeleteUrl: M,
+    ...Z
+  }, q) => {
+    const n = te(), [I, R] = F.useState(Q), [j, A] = F.useState(!1), O = L ?? n.fileUpload.title, P = g ? n.fileUpload.maxSizeError.replace(
       "{size}",
-      (b / (1024 * 1024)).toFixed(0)
-    ) : "", R = T ?? I, { getRootProps: Q, getInputProps: W, isDragActive: X } = D({
-      onDrop: (t, a) => {
+      (g / (1024 * 1024)).toFixed(0)
+    ) : "", T = G ?? P, { getRootProps: H, getInputProps: D, isDragActive: E } = oe({
+      onDrop: (e, l) => {
         try {
-          if ($(!1), a.length > 0 && a.some(
-            (r) => r.errors.some((l) => l.code === "file-too-large")
+          if (A(!1), l.length > 0 && l.some(
+            (r) => r.errors.some((s) => s.code === "file-too-large")
           )) {
-            $(!0);
-            const r = R || I;
-            o == null || o(r, a[0].file);
+            A(!0);
+            const r = T || P;
+            t == null || t(r, l[0].file);
             return;
           }
-          F((e) => {
+          R((o) => {
             const r = new Set(
-              e.map((s) => `${s.name}-${s.size}-${s.lastModified}`)
-            ), l = t.filter(
-              (s) => !r.has(`${s.name}-${s.size}-${s.lastModified}`)
-            ), d = [...e, ...l];
+              o.map((i) => `${i.name}-${i.size}-${i.lastModified}`)
+            ), s = e.filter(
+              (i) => !r.has(`${i.name}-${i.size}-${i.lastModified}`)
+            ), d = [...o, ...s];
             return c == null || c(d), d;
-          }), g == null || g(t);
-        } catch (e) {
-          const r = e instanceof Error ? e.message : u.fileUpload.processingError;
-          o == null || o(r);
+          }), x == null || x(e);
+        } catch (o) {
+          const r = o instanceof Error ? o.message : n.fileUpload.processingError;
+          t == null || t(r);
         }
       },
-      accept: typeof f == "string" ? { [f]: [] } : f ? Object.fromEntries(f.map((t) => [t, []])) : void 0,
-      multiple: U,
-      maxSize: b,
+      accept: typeof u == "string" ? { [u]: [] } : u ? Object.fromEntries(u.map((e) => [e, []])) : void 0,
+      multiple: k,
+      maxSize: g,
       disabled: p,
-      ...K
-    }), Y = h || !U && w.length > 0;
-    return /* @__PURE__ */ n(j, { direction: "column", gap: "lg", children: [
-      !Y && /* @__PURE__ */ n(j, { direction: "column", gap: "sm", children: [
-        m && (typeof m == "string" ? /* @__PURE__ */ i(
-          x,
-          {
-            size: "sm",
-            component: "label",
-            weight: "regular",
-            variant: "body",
-            className: "caret-comp-input-text-primary",
-            children: m
-          }
-        ) : m),
-        /* @__PURE__ */ n(
-          "div",
-          {
-            ref: L,
-            tabIndex: p ? void 0 : 0,
-            className: A(
-              ee({
-                error: G || N,
-                disabled: p,
-                className: S,
-                isDragActive: X
-              })
+      ...J
+    }), V = m || !k && (I.length > 0 || U.length > 0);
+    return /* @__PURE__ */ f(re, { direction: "column", gap: "lg", children: [
+      (!V || w) && /* @__PURE__ */ a(
+        le,
+        {
+          label: w,
+          required: v,
+          disableRequiredAsterisk: Y,
+          children: !V && /* @__PURE__ */ f(ee, { children: [
+            /* @__PURE__ */ f(
+              "div",
+              {
+                ref: q,
+                tabIndex: p ? void 0 : 0,
+                className: _(
+                  ie({
+                    error: X || j,
+                    disabled: p,
+                    className: y,
+                    isDragActive: E
+                  })
+                ),
+                ...H(),
+                ...Z,
+                children: [
+                  /* @__PURE__ */ a(
+                    "input",
+                    {
+                      ...D({ required: v }),
+                      "aria-required": v
+                    }
+                  ),
+                  /* @__PURE__ */ a(se, { className: "inline size-comp-file-upload-ico-size" }),
+                  /* @__PURE__ */ f("div", { children: [
+                    /* @__PURE__ */ a(S, { size: "base", component: "p", weight: "medium", children: O }),
+                    N && /* @__PURE__ */ a(
+                      S,
+                      {
+                        size: "sm",
+                        component: "p",
+                        weight: "regular",
+                        className: _(
+                          ae({
+                            disabled: p,
+                            className: y
+                          })
+                        ),
+                        children: N
+                      }
+                    )
+                  ] })
+                ]
+              }
             ),
-            ...Q(),
-            ...J,
-            children: [
-              /* @__PURE__ */ i("input", { ...W() }),
-              /* @__PURE__ */ i(C, { className: "inline size-comp-file-upload-ico-size" }),
-              /* @__PURE__ */ n("div", { children: [
-                /* @__PURE__ */ i(x, { size: "base", component: "p", weight: "medium", children: O }),
-                k && /* @__PURE__ */ i(
-                  x,
-                  {
-                    size: "sm",
-                    component: "p",
-                    weight: "regular",
-                    className: A(
-                      te({
-                        disabled: p,
-                        className: S
-                      })
-                    ),
-                    children: k
-                  }
-                )
-              ] })
-            ]
-          }
-        ),
-        N && /* @__PURE__ */ i(
-          x,
-          {
-            size: "sm",
-            variant: "body",
-            component: "p",
-            weight: "regular",
-            className: "text-comp-file-upload-text-error-def",
-            children: R
-          }
-        )
-      ] }),
-      /* @__PURE__ */ i("ul", { className: "flex flex-col gap-md", children: w.map((t, a) => {
-        const e = B[a], r = e == null ? void 0 : e.uploaded;
-        return h && !r ? null : /* @__PURE__ */ i(
-          H,
+            j && /* @__PURE__ */ a(
+              S,
+              {
+                size: "sm",
+                variant: "body",
+                component: "p",
+                weight: "regular",
+                className: "text-comp-file-upload-text-error-def",
+                children: T
+              }
+            )
+          ] })
+        }
+      ),
+      /* @__PURE__ */ f("ul", { className: "flex flex-col gap-md", children: [
+        U.map((e, l) => /* @__PURE__ */ a(
+          K,
           {
-            file: t,
-            uploaded: r,
-            progress: e == null ? void 0 : e.progress,
+            source: "url",
+            url: e.url,
+            name: e.name,
+            type: e.type,
+            uploaded: !0,
             disabled: p,
-            readOnly: h,
-            error: v == null ? void 0 : v.get(t),
-            note: z == null ? void 0 : z.get(t),
-            onError: o,
-            size: V,
-            onDelete: () => {
-              try {
-                F((l) => {
-                  const d = l.filter((s, Z) => Z !== a);
-                  return c == null || c(d), d;
-                }), M == null || M(t, a);
-              } catch (l) {
-                const d = l instanceof Error ? l.message : u.fileUpload.deleteError;
-                o == null || o(d, t);
-              }
-            }
+            readOnly: m,
+            size: $,
+            onDelete: () => M == null ? void 0 : M(e, l)
           },
-          t.name
-        );
-      }) })
+          `url-${e.url}`
+        )),
+        I.map((e, l) => {
+          const o = W[l], r = o == null ? void 0 : o.uploaded;
+          return m && !r ? null : /* @__PURE__ */ a(
+            K,
+            {
+              source: "file",
+              file: e,
+              uploaded: r,
+              progress: o == null ? void 0 : o.progress,
+              disabled: p,
+              readOnly: m,
+              error: b == null ? void 0 : b.get(e),
+              note: h == null ? void 0 : h.get(e),
+              onError: t,
+              size: $,
+              onDelete: () => {
+                try {
+                  R((s) => {
+                    const d = s.filter((i, C) => C !== l);
+                    return c == null || c(d), d;
+                  }), z == null || z(e, l);
+                } catch (s) {
+                  const d = s instanceof Error ? s.message : n.fileUpload.deleteError;
+                  t == null || t(d, e);
+                }
+              }
+            },
+            e.name
+          );
+        })
+      ] })
     ] });
   }
 );
-oe.displayName = "FileUpload";
+de.displayName = "FileUpload";
 export {
-  oe as FileUpload
+  de as FileUpload
 };

package/dist/components/FileUpload/FileUpload.stories.d.ts

@@ -4,15 +4,20 @@ declare const meta: Meta<typeof FileUpload>;
 export default meta;
 type Story = StoryObj<typeof meta>;
 export declare const Default: Story;
+export declare const Required: Story;
 export declare const Error: Story;
 export declare const ErrorWithUploadedFiles: Story;
 export declare const UploadInProgress: Story;
 export declare const UploadedFiles: Story;
 export declare const SingleFile: Story;
+export declare const SingleFileWithLabel: Story;
 export declare const ImagesOnly: Story;
 export declare const WithSizeLimit: Story;
 export declare const Disabled: Story;
 export declare const WithErrorsAndHints: Story;
 export declare const ReadOnly: Story;
 export declare const UploadSimulation: Story;
+export declare const PreselectedUrls: Story;
+export declare const MixedFilesAndUrls: Story;
+export declare const SingleFileWithUrl: Story;
 //# sourceMappingURL=FileUpload.stories.d.ts.map

package/dist/components/FileUpload/FileUpload.stories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileUpload.stories.d.ts","sourceRoot":"","sources":["../../../src/components/FileUpload/FileUpload.stories.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,UAAU,CAsJjC,CAAA;AAED,eAAe,IAAI,CAAA;AACnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAA;AAElC,eAAO,MAAM,OAAO,EAAE,KAerB,CAAA;AAED,eAAO,MAAM,KAAK,EAAE,KAmBnB,CAAA;AAED,eAAO,MAAM,sBAAsB,EAAE,KAoBpC,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KAsB9B,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,KAkB3B,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,KAiBxB,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,KAexB,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,KAiB3B,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAmBtB,CAAA;AAED,eAAO,MAAM,kBAAkB,EAAE,KA0ChC,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAoBtB,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KA0F9B,CAAA"}
+{"version":3,"file":"FileUpload.stories.d.ts","sourceRoot":"","sources":["../../../src/components/FileUpload/FileUpload.stories.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAE3D,OAAO,EAAE,UAAU,EAAuB,MAAM,cAAc,CAAA;AAE9D,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,UAAU,CA8KjC,CAAA;AAED,eAAe,IAAI,CAAA;AACnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAA;AAElC,eAAO,MAAM,OAAO,EAAE,KAerB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAgBtB,CAAA;AAED,eAAO,MAAM,KAAK,EAAE,KAmBnB,CAAA;AAED,eAAO,MAAM,sBAAsB,EAAE,KAoBpC,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KAsB9B,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,KAkB3B,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,KAiBxB,CAAA;AAED,eAAO,MAAM,mBAAmB,EAAE,KAqBjC,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,KAexB,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,KAiB3B,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAmBtB,CAAA;AAED,eAAO,MAAM,kBAAkB,EAAE,KA0ChC,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAoBtB,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KA0F9B,CAAA;AAmBD,eAAO,MAAM,eAAe,EAAE,KA0B7B,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,KAoC/B,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,KAsB/B,CAAA"}

package/dist/components/FileUpload/index.d.ts

@@ -1,2 +1,2 @@
-export { FileUpload, type FileUploadProps } from './FileUpload';
+export { FileUpload, type FileUploadProps, type PreselectedUrl, } from './FileUpload';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/FileUpload/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/FileUpload/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/FileUpload/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAA"}

package/dist/components/Flex/Flex.d.ts

@@ -37,6 +37,8 @@ export interface FlexProps extends Omit<VariantProps<typeof flexVariants>, 'gap'
     component?: HTMLElementTag;
     /** Additional CSS classes for custom styling. */
     className?: string;
+    /** Inline styles for escape-hatch customizations not covered by tokens. */
+    style?: React.CSSProperties;
     /** Sets the main axis direction for flex items. @default 'row' */
     direction?: 'row' | 'column' | 'row-reverse' | 'column-reverse';
     /** Controls whether flex items wrap to multiple lines. @default 'nowrap' */
@@ -79,6 +81,6 @@ export interface FlexProps extends Omit<VariantProps<typeof flexVariants>, 'gap'
      */
     margin?: SpacingProps['margin'];
 }
-declare const Flex: ({ children, className, direction, wrap, justify, align, flex, gap, padding, margin, component, ...props }: FlexProps) => import("react/jsx-runtime").JSX.Element;
+declare const Flex: ({ children, className, style, direction, wrap, justify, align, flex, gap, padding, margin, component, ...props }: FlexProps) => import("react/jsx-runtime").JSX.Element;
 export { Flex, flexVariants };
 //# sourceMappingURL=Flex.d.ts.map

package/dist/components/Flex/Flex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Flex.d.ts","sourceRoot":"","sources":["../../../src/components/Flex/Flex.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,KAAK,YAAY,EAAO,MAAM,0BAA0B,CAAA;AAEjE,OAAO,EACL,KAAK,YAAY,EAGlB,MAAM,iBAAiB,CAAA;AAExB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;8EA+CjB,CAAA;AAED,KAAK,cAAc,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,iBAAiB,GACrD,MAAM,qBAAqB,CAAA;AAE7B;;;GAGG;AACH,MAAM,WAAW,SACf,SAAQ,IAAI,CACR,YAAY,CAAC,OAAO,YAAY,CAAC,EAC/B,KAAK,GACL,MAAM,GACN,MAAM,GACN,GAAG,GACH,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,WAAW,GACX,MAAM,GACN,SAAS,GACT,OAAO,GACP,MAAM,CACT,EACD,YAAY;IACd,oDAAoD;IACpD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,iEAAiE;IACjE,SAAS,CAAC,EAAE,cAAc,CAAA;IAC1B,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kEAAkE;IAClE,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,aAAa,GAAG,gBAAgB,CAAA;IAC/D,4EAA4E;IAC5E,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,cAAc,CAAA;IACzC,yDAAyD;IACzD,OAAO,CAAC,EACJ,OAAO,GACP,KAAK,GACL,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,SAAS,CAAA;IACb,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAA;IAC3D,0CAA0C;IAC1C,IAAI,CAAC,EAAE,CAAC,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAA;IACtC;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAA;IACzB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC,CAAA;IACjC;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;CAChC;AAED,QAAA,MAAM,IAAI,GAAI,2GAaX,SAAS,4CAuBX,CAAA;AAED,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAA"}
+{"version":3,"file":"Flex.d.ts","sourceRoot":"","sources":["../../../src/components/Flex/Flex.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,KAAK,YAAY,EAAO,MAAM,0BAA0B,CAAA;AAEjE,OAAO,EACL,KAAK,YAAY,EAGlB,MAAM,iBAAiB,CAAA;AAExB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;8EA+CjB,CAAA;AAED,KAAK,cAAc,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,iBAAiB,GACrD,MAAM,qBAAqB,CAAA;AAE7B;;;GAGG;AACH,MAAM,WAAW,SACf,SAAQ,IAAI,CACR,YAAY,CAAC,OAAO,YAAY,CAAC,EAC/B,KAAK,GACL,MAAM,GACN,MAAM,GACN,GAAG,GACH,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,WAAW,GACX,MAAM,GACN,SAAS,GACT,OAAO,GACP,MAAM,CACT,EACD,YAAY;IACd,oDAAoD;IACpD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,iEAAiE;IACjE,SAAS,CAAC,EAAE,cAAc,CAAA;IAC1B,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAA;IAC3B,kEAAkE;IAClE,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,aAAa,GAAG,gBAAgB,CAAA;IAC/D,4EAA4E;IAC5E,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,cAAc,CAAA;IACzC,yDAAyD;IACzD,OAAO,CAAC,EACJ,OAAO,GACP,KAAK,GACL,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,SAAS,CAAA;IACb,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAA;IAC3D,0CAA0C;IAC1C,IAAI,CAAC,EAAE,CAAC,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAA;IACtC;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAA;IACzB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC,CAAA;IACjC;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;CAChC;AAED,QAAA,MAAM,IAAI,GAAI,kHAcX,SAAS,4CAwBX,CAAA;AAED,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAA"}

package/dist/components/Flex/Flex.js

@@ -1,9 +1,9 @@
-import { jsx as x } from "react/jsx-runtime";
+import { jsx as w } from "react/jsx-runtime";
 import "react";
-import { cva as w } from "class-variance-authority";
-import { getSpacingVariants as v, spacingVariantDefinitions as d } from "../../utils/spacing.js";
-import { cn as y } from "../../utils/cn.js";
-const j = w(
+import { cva as v } from "class-variance-authority";
+import { getSpacingVariants as d, spacingVariantDefinitions as y } from "../../utils/spacing.js";
+import { cn as j } from "../../utils/cn.js";
+const g = v(
   // Base classes
   "flex",
   {
@@ -41,7 +41,7 @@ const j = w(
         initial: "flex-initial",
         none: "flex-none"
       },
-      ...d
+      ...y
     },
     defaultVariants: {
       direction: "row",
@@ -50,41 +50,43 @@ const j = w(
       align: "stretch"
     }
   }
-), D = ({
+), F = ({
   children: e,
   className: t,
-  direction: r,
-  wrap: n,
-  justify: i,
-  align: s,
-  flex: a,
-  gap: o,
-  padding: f,
-  margin: l,
-  component: c = "div",
-  ...p
+  style: r,
+  direction: n,
+  wrap: i,
+  justify: s,
+  align: a,
+  flex: o,
+  gap: f,
+  padding: l,
+  margin: c,
+  component: p = "div",
+  ...m
 }) => {
-  const m = c ?? "div", u = v({ gap: o, padding: f, margin: l });
-  return /* @__PURE__ */ x(
-    m,
+  const u = p ?? "div", x = d({ gap: f, padding: l, margin: c });
+  return /* @__PURE__ */ w(
+    u,
     {
-      className: y(
-        j({
-          direction: r,
-          wrap: n,
-          justify: i,
-          align: s,
-          flex: a,
-          ...u
+      className: j(
+        g({
+          direction: n,
+          wrap: i,
+          justify: s,
+          align: a,
+          flex: o,
+          ...x
         }),
         t
       ),
-      ...p,
+      style: r,
+      ...m,
       children: e
     }
   );
 };
 export {
-  D as Flex,
-  j as flexVariants
+  F as Flex,
+  g as flexVariants
 };

package/dist/components/FormField/FormField.d.ts

@@ -0,0 +1,30 @@
+import { ReactNode } from 'react';
+export interface FormFieldProps {
+    /** The form control element (input, textarea, select trigger, etc.). */
+    children: ReactNode;
+    /** Label text displayed above the control. */
+    label?: string;
+    /** Helper or error text displayed below the control. */
+    hint?: string;
+    /** Renders the hint in an error color when true. */
+    error?: boolean;
+    /** Displays a red asterisk in the label when true. */
+    required?: boolean;
+    /**
+     * Hides the required asterisk (*) even when `required` is true.
+     * @default false
+     */
+    disableRequiredAsterisk?: boolean;
+    /** Associates the label with a form element by ID. */
+    htmlFor?: string;
+    /** ID for the label element (used with `aria-labelledby`). */
+    labelId?: string;
+    /** ID for the hint element (used with `aria-describedby`). */
+    hintId?: string;
+    /** Extra content rendered inline next to the label (e.g. a tooltip icon). */
+    labelExtra?: ReactNode;
+    /** Additional CSS classes for the outer wrapper. */
+    className?: string;
+}
+export declare const FormField: import('react').ForwardRefExoticComponent<FormFieldProps & import('react').RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=FormField.d.ts.map

package/dist/components/FormField/FormField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormField.d.ts","sourceRoot":"","sources":["../../../src/components/FormField/FormField.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,OAAO,CAAA;AAKlD,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,QAAQ,EAAE,SAAS,CAAA;IACnB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAA;IACjC,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6EAA6E;IAC7E,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,eAAO,MAAM,SAAS,2GAoDrB,CAAA"}