@payfit/unity-components 0.0.0-alpha.9 → 1.0.0

package/dist/esm/components/number-input/NumberInput.js

@@ -0,0 +1,214 @@
+import { jsxs as o, jsx as e } from "react/jsx-runtime";
+import { forwardRef as G } from "react";
+import { NumberField as W, Group as q, Input as A } from "react-aria-components";
+import { tv as C } from "tailwind-variants";
+import { Icon as H } from "../icon/Icon.js";
+import "@payfit/unity-icons";
+import { useIntl as J } from "react-intl";
+import { CircularIconButton as s } from "../icon-button/CircularIconButton.js";
+import { Spinner as K } from "../spinner/Spinner.js";
+const Q = C({
+  slots: {
+    base: [
+      "uy:group uy:flex uy:h-500 uy:border uy:border-solid uy:rounded-100",
+      "uy:focus-within:outline-none uy:focus-within:ring-2 uy:focus-within:ring-utility-focus-ring uy:focus-within:ring-offset-2",
+      "uy:active:border-border-form-active"
+    ],
+    wrapper: [
+      "uy:flex uy:gap-50 uy:flex-grow uy:flex-nowrap uy:pt-100 uy:pb-100 uy:pl-150 uy:pr-150 uy:rounded-100 uy:max-w-full uy:justify-between uy:items-center"
+    ],
+    input: [
+      "uy:w-full uy:flex-1 uy:outline-none uy:typography-body uy:min-w-0 uy:max-w-full",
+      "uy:placeholder:text-content-neutral-lowest"
+    ],
+    prefix: [
+      "uy:flex-grow-0 uy:content-center uy:pt-100 uy:pb-100 uy:pl-150 uy:pr-150 uy:border-r uy:border-solid uy:rounded-l-100",
+      "uy:active:border-border-form-active"
+    ],
+    suffix: [
+      "uy:flex-grow-0 uy:content-center uy:pt-100 uy:pb-100 uy:pl-150 uy:pr-150 uy:border-l uy:border-solid uy:rounded-r-100",
+      "uy:active:border-border-form-active"
+    ],
+    state: [
+      "uy:flex uy:gap-50 uy:items-center uy:shrink-0 uy:text-content-neutral-disabled"
+    ],
+    controls: ["uy:flex uy:gap-50"]
+  },
+  variants: {
+    isReadOnly: {
+      true: {
+        base: ["uy:border-border-form-disabled uy:bg-surface-form-disabled"],
+        prefix: [
+          "uy:bg-surface-form-disabled uy:border-border-form-disabled uy:text-content-form-read-only"
+        ],
+        wrapper: [
+          "uy:bg-surface-form-disabled uy:text-content-form-disabled",
+          "uy:group-data-[invalid=true]:bg-surface-form-error"
+        ],
+        input: ["uy:bg-surface-form-disabled uy:text-content-form-read-only"],
+        suffix: [
+          "uy:bg-surface-form-disabled uy:border-border-form-disabled uy:text-content-form-read-only"
+        ]
+      },
+      false: {
+        base: [
+          "uy:border-border-form-enabled uy:bg-surface-form-enabled",
+          "uy:data-[invalid=true]:border-border-form-error uy:data-[invalid=true]:bg-surface-form-error",
+          "uy:data-[disabled=true]:border-border-form-disabled uy:data-[disabled=true]:bg-surface-form-disabled uy:data-[disabled=true]:cursor-not-allowed"
+        ],
+        prefix: [
+          "uy:bg-surface-neutral-low uy:border-border-form-enabled uy:text-content-form-enabled",
+          "uy:group-data-[invalid=true]:bg-surface-form-error uy:group-data-[invalid=true]:border-border-form-error",
+          "uy:group-data-[disabled=true]:bg-surface-form-disabled uy:group-data-[disabled=true]:border-border-form-disabled uy:group-data-[disabled=true]:text-content-form-disabled uy:data-[disabled=true]:cursor-not-allowed"
+        ],
+        suffix: [
+          "uy:bg-surface-neutral-low uy:border-border-form-enabled uy:text-content-form-enabled",
+          "uy:group-data-[invalid=true]:bg-surface-form-error uy:group-data-[invalid=true]:border-border-form-error",
+          "uy:group-data-[disabled=true]:bg-surface-form-disabled uy:group-data-[disabled=true]:border-border-form-disabled uy:group-data-[disabled=true]:text-content-form-disabled uy:data-[disabled=true]:cursor-not-allowed"
+        ],
+        wrapper: [
+          "uy:border-border-form-enabled uy:bg-surface-form-enabled",
+          "uy:group-data-[invalid=true]:bg-surface-form-error uy:group-data-[invalid=true]:border-border-form-error",
+          "uy:group-data-[disabled=true]:bg-surface-form-disabled uy:group-data-[disabled=true]:text-content-form-disabled uy:data-[disabled=true]:cursor-not-allowed"
+        ],
+        input: [
+          "uy:text-content-form-enabled uy:bg-surface-form-enabled",
+          "uy:group-data-[invalid=true]:bg-surface-form-error",
+          "uy:group-data-[disabled=true]:bg-surface-form-disabled uy:group-data-[disabled=true]:text-content-form-disabled uy:data-[disabled=true]:cursor-not-allowed"
+        ],
+        state: ["uy:group-data-[invalid=true]:text-content-form-error"],
+        button: "uy:data-[disabled=true]:cursor-not-allowed"
+      }
+    }
+  }
+}), R = G(
+  ({
+    withControls: b = !1,
+    defaultValue: u,
+    formatOptions: p,
+    isDisabled: f,
+    isInvalid: y,
+    isLoading: a,
+    isReadOnly: d,
+    isRequired: g,
+    maxValue: n,
+    minValue: i,
+    prefix: m,
+    onBlur: x,
+    onChange: w,
+    onClearButtonPress: l,
+    step: v,
+    suffix: c,
+    value: r,
+    ...h
+  }, N) => {
+    const {
+      base: M,
+      wrapper: I,
+      input: j,
+      prefix: E,
+      suffix: O,
+      state: S,
+      controls: D
+    } = Q({ isReadOnly: d }), t = J(), k = r !== void 0 && !isNaN(r), z = u !== void 0 && !isNaN(u), F = (k || z) && !b && !a && !d && !f;
+    return /* @__PURE__ */ o(
+      W,
+      {
+        ref: N,
+        className: M(),
+        value: r,
+        defaultValue: u,
+        minValue: i,
+        maxValue: n,
+        step: v,
+        isDisabled: f,
+        isReadOnly: d,
+        isInvalid: y,
+        isRequired: g,
+        "aria-busy": a,
+        onChange: w,
+        formatOptions: p,
+        onBlur: x,
+        ...h,
+        children: [
+          m ? /* @__PURE__ */ e("span", { className: E(), children: m }) : null,
+          /* @__PURE__ */ o(q, { className: I(), children: [
+            /* @__PURE__ */ e(A, { className: j() }),
+            /* @__PURE__ */ o("div", { className: S(), children: [
+              a && /* @__PURE__ */ e(
+                K,
+                {
+                  color: "inherit",
+                  size: "small",
+                  label: t.formatMessage({
+                    id: "unity:component:common:loading:label",
+                    defaultMessage: "Loading..."
+                  })
+                }
+              ),
+              y && /* @__PURE__ */ e(
+                H,
+                {
+                  src: "WarningCircleOutlined",
+                  color: "content.form.invalid",
+                  alt: t.formatMessage({
+                    id: "unity:component:form-field:form-input:error:alt",
+                    defaultMessage: "Error"
+                  })
+                }
+              ),
+              F && /* @__PURE__ */ e(
+                s,
+                {
+                  title: t.formatMessage({
+                    id: "unity:component:common:clear:title",
+                    defaultMessage: "Clear"
+                  }),
+                  className: "uy:text-content-neutral-enabled",
+                  icon: "CloseOutlined",
+                  onPress: () => {
+                    l == null || l();
+                  }
+                }
+              )
+            ] }),
+            b && /* @__PURE__ */ o("div", { className: D(), children: [
+              /* @__PURE__ */ e(
+                s,
+                {
+                  asElement: "button",
+                  icon: "MinusOutlined",
+                  slot: "decrement",
+                  isDisabled: i !== void 0 && r === i,
+                  title: t.formatMessage({
+                    id: "unity:component:form-field:number-input:decrement:title",
+                    defaultMessage: "decrement"
+                  })
+                }
+              ),
+              /* @__PURE__ */ e(
+                s,
+                {
+                  asElement: "button",
+                  icon: "PlusOutlined",
+                  slot: "increment",
+                  isDisabled: n !== void 0 && r === n,
+                  title: t.formatMessage({
+                    id: "unity:component:form-field:number-input:increment:title",
+                    defaultMessage: "increment"
+                  })
+                }
+              )
+            ] })
+          ] }),
+          c ? /* @__PURE__ */ e("span", { className: O(), children: c }) : null
+        ]
+      }
+    );
+  }
+);
+R.displayName = "NumberInput";
+export {
+  R as NumberInput,
+  Q as numberInput
+};

package/dist/esm/components/page/Page.d.ts

@@ -0,0 +1,55 @@
+import { PropsWithChildren } from 'react';
+import { VariantProps } from 'tailwind-variants';
+export declare const page: import('tailwind-variants').TVReturnType<{
+    variant: {
+        default: string[];
+        legacy__midnight: string[];
+    };
+}, undefined, "uy:min-h-dvh uy:flex uy:flex-col uy:gap-400", {
+    variant: {
+        default: string[];
+        legacy__midnight: string[];
+    };
+}, undefined, import('tailwind-variants').TVReturnType<{
+    variant: {
+        default: string[];
+        legacy__midnight: string[];
+    };
+}, undefined, "uy:min-h-dvh uy:flex uy:flex-col uy:gap-400", unknown, unknown, undefined>>;
+export interface PageProps extends PropsWithChildren {
+    /**
+     * The variant of the page.
+     * @default 'default'
+     * @remarks
+     * - `default` - The default variant is a standard page with a left-aligned header and a right-aligned footer.
+     * - `legacy__midnight` - The legacy__midnight variant is a page with a left-aligned header and a right-aligned footer.
+     */
+    variant: VariantProps<typeof page>['variant'];
+}
+/**
+ * The Page component provides a consistent layout container for page content with predefined spacing and styling.
+ *
+ * Use this component as the main container for your content to ensure a consistent look and feel across the application.
+ * It works seamlessly with PageHeader for structured page layouts and adapts to different screen sizes.
+ * @param {PageProps} props - Standard props from HTMLDivElement with additional variant option
+ * @see {@link PageProps} for all available props
+ * @example
+ * ```tsx
+ * import { Page, PageHeader, PageHeading } from '@payfit/unity-components'
+ *
+ * function MyPage() {
+ *   return (
+ *     <Page variant="default">
+ *       <PageHeader>
+ *         <PageHeading variant="title">My Page</PageHeading>
+ *       </PageHeader>
+ *       <div>Content goes here</div>
+ *     </Page>
+ *   )
+ * }
+ * ```
+ * @remarks
+ * [API](https://unity-components.payfit.io/?path=/docs/layout-page--docs) • [Design docs](https://www.payfit.design/24f360409/p/99b0ae-app-body)
+ */
+declare const Page: import('react').ForwardRefExoticComponent<PageProps & import('react').RefAttributes<HTMLDivElement>>;
+export { Page };

package/dist/esm/components/page/Page.js

@@ -0,0 +1,44 @@
+import { jsx as m } from "react/jsx-runtime";
+import { forwardRef as y } from "react";
+import { tv as t } from "tailwind-variants";
+const o = t({
+  base: "uy:min-h-dvh uy:flex uy:flex-col uy:gap-400",
+  variants: {
+    variant: {
+      default: [
+        "uy:px-200 uy:py-300 uy:md:p-300 uy:lg:p-400",
+        // a tiny margin left so the shadow is visible
+        "uy:md:ml-100",
+        "uy:bg-surface-neutral uy:md:border uy:md:border-solid uy:md:border-border-neutral uy:border-r-0 uy:md:rounded-tl-400 uy:md:rounded-bl-400 uy:md:shadow-raising"
+      ],
+      legacy__midnight: [
+        "uy:bg-transparent",
+        "uy:md:mt-250 uy:md:mr-300",
+        "uy:md:ml-100"
+      ]
+    }
+  },
+  defaultVariants: {
+    variant: "default"
+  }
+}), l = y(
+  ({ children: r, variant: a, ...d }, u) => {
+    const e = o({ variant: a });
+    return /* @__PURE__ */ m(
+      "main",
+      {
+        ...d,
+        ref: u,
+        className: e,
+        "data-dd-privacy": "allow",
+        "data-unity-page": a,
+        children: r
+      }
+    );
+  }
+);
+l.displayName = "Page";
+export {
+  l as Page,
+  o as page
+};

package/dist/esm/components/page/parts/PageHeader.d.ts

@@ -0,0 +1,82 @@
+import { PropsWithChildren, ReactNode } from 'react';
+import { VariantProps } from 'tailwind-variants';
+import { BreadcrumbProps } from '../../breadcrumbs/parts/Breadcrumb.js';
+export declare const pageHeader: import('tailwind-variants').TVReturnType<{
+    [key: string]: {
+        [key: string]: import('tailwind-merge').ClassNameValue | {
+            base?: import('tailwind-merge').ClassNameValue;
+            actions?: import('tailwind-merge').ClassNameValue;
+            headingActionsWrapper?: import('tailwind-merge').ClassNameValue;
+            titles?: import('tailwind-merge').ClassNameValue;
+        };
+    };
+} | {
+    [x: string]: {
+        [x: string]: import('tailwind-merge').ClassNameValue | {
+            base?: import('tailwind-merge').ClassNameValue;
+            actions?: import('tailwind-merge').ClassNameValue;
+            headingActionsWrapper?: import('tailwind-merge').ClassNameValue;
+            titles?: import('tailwind-merge').ClassNameValue;
+        };
+    };
+} | {}, {
+    base: string;
+    headingActionsWrapper: string;
+    titles: string;
+    actions: string;
+}, undefined, {
+    [key: string]: {
+        [key: string]: import('tailwind-merge').ClassNameValue | {
+            base?: import('tailwind-merge').ClassNameValue;
+            actions?: import('tailwind-merge').ClassNameValue;
+            headingActionsWrapper?: import('tailwind-merge').ClassNameValue;
+            titles?: import('tailwind-merge').ClassNameValue;
+        };
+    };
+} | {}, {
+    base: string;
+    headingActionsWrapper: string;
+    titles: string;
+    actions: string;
+}, import('tailwind-variants').TVReturnType<unknown, {
+    base: string;
+    headingActionsWrapper: string;
+    titles: string;
+    actions: string;
+}, undefined, unknown, unknown, undefined>>;
+export interface PageHeaderProps extends PropsWithChildren<VariantProps<typeof pageHeader>> {
+    pagePath?: BreadcrumbProps[];
+    actions?: ReactNode;
+}
+/**
+ * The PageHeader component provides a consistent layout for page headers with title, subtitle, and actions support.
+ *
+ * It creates a structured header for pages with support for breadcrumbs navigation, title/subtitle content, and action buttons.
+ * The component adapts to different screen sizes, reorganizing elements for optimal display on mobile and desktop views.
+ * @param {PageHeaderProps} props - Props for the PageHeader component
+ * @example
+ * ```tsx
+ * import { PageHeader, PageHeading, Button } from '@payfit/unity-components'
+ *
+ * <PageHeader
+ *   pagePath={[
+ *     { href: '/dashboard', label: 'Dashboard' },
+ *     { href: '/employees', label: 'Employees' }
+ *   ]}
+ *   actions={
+ *     <>
+ *       <Button variant="secondary">Cancel</Button>
+ *       <Button variant="primary">Save</Button>
+ *     </>
+ *   }
+ * >
+ *   <PageHeading variant="title">Employee List</PageHeading>
+ *   <PageHeading variant="subtitle">View and manage your employees</PageHeading>
+ * </PageHeader>
+ * ```
+ * @see {@link PageHeaderProps} for all available props
+ * @remarks
+ * [API](https://unity-components.payfit.io/?path=/docs/layout-page-pageheader--docs) • [Design docs](https://www.payfit.design/24f360409/p/202477-page-header)
+ */
+declare const PageHeader: import('react').ForwardRefExoticComponent<PageHeaderProps & import('react').RefAttributes<HTMLDivElement>>;
+export { PageHeader };

package/dist/esm/components/page/parts/PageHeader.js

@@ -0,0 +1,34 @@
+import { jsxs as o, jsx as e } from "react/jsx-runtime";
+import { forwardRef as p } from "react";
+import { tv as n } from "tailwind-variants";
+import { Breadcrumbs as u } from "../../breadcrumbs/Breadcrumbs.js";
+import { Breadcrumb as y } from "../../breadcrumbs/parts/Breadcrumb.js";
+const x = n({
+  slots: {
+    base: "uy:flex uy:flex-col uy:gap-400",
+    headingActionsWrapper: "uy:flex uy:flex-col uy:gap-400 uy:md:flex-row",
+    titles: "uy:flex uy:flex-col uy:gap-100 uy:flex-1",
+    actions: "uy:flex uy:flex-row uy:gap-100"
+  }
+}), g = p(
+  ({ children: s, actions: a, pagePath: r, ...i }, c) => {
+    const {
+      base: d,
+      titles: t,
+      headingActionsWrapper: f,
+      actions: m
+    } = x();
+    return /* @__PURE__ */ o("header", { "data-dd-privacy": "allow", ...i, ref: c, className: d(), children: [
+      r && /* @__PURE__ */ e(u, { items: r, wrap: "nowrap", children: (l) => /* @__PURE__ */ e(y, { href: l.href, label: l.label }) }),
+      /* @__PURE__ */ o("div", { className: f(), children: [
+        /* @__PURE__ */ e("div", { className: t(), children: s }),
+        a && /* @__PURE__ */ e("div", { className: m(), children: a })
+      ] })
+    ] });
+  }
+);
+g.displayName = "PageHeader";
+export {
+  g as PageHeader,
+  x as pageHeader
+};

package/dist/esm/components/page/parts/PageHeading.d.ts

@@ -0,0 +1,30 @@
+import { TextProps } from '../../text/Text.js';
+export interface PageHeadingProps extends Omit<TextProps, 'variant' | 'color'> {
+    /**
+     * The variant of the page heading.
+     * @default 'title'
+     */
+    variant: 'title' | 'subtitle';
+}
+/**
+ * The PageHeading component provides typography for page titles and subtitles with consistent styling.
+ *
+ * You can create properly styled page titles and subtitles using this component, which ensures correct
+ * font sizes, weights and colors according to the design system.
+ * @param {PageHeadingProps} props - Props for the PageHeading component
+ * @example
+ * ```tsx
+ * import { PageHeading } from '@payfit/unity-components'
+ *
+ * // For main page title
+ * <PageHeading variant="title">Employee Management</PageHeading>
+ *
+ * // For page subtitle
+ * <PageHeading variant="subtitle">View and manage employee information</PageHeading>
+ * ```
+ * @see {@link PageHeadingProps} for all available props
+ * @remarks
+ * [API](https://unity-components.payfit.io/?path=/docs/layout-page-pageheading--docs) • [Design docs](https://www.payfit.design/24f360409/p/202477-page-header)
+ */
+declare const PageHeading: import('react').ForwardRefExoticComponent<PageHeadingProps & import('react').RefAttributes<HTMLHeadingElement>>;
+export { PageHeading };

package/dist/esm/components/page/parts/PageHeading.js

@@ -0,0 +1,19 @@
+import { jsx as r } from "react/jsx-runtime";
+import { forwardRef as a } from "react";
+import { Text as n } from "../../text/Text.js";
+const i = a(
+  ({ variant: t, ...e }, o) => /* @__PURE__ */ r(
+    n,
+    {
+      "data-dd-privacy": "mask",
+      ...e,
+      ref: o,
+      variant: t === "title" ? "h1" : "subtitle",
+      color: t === "title" ? "content.neutral" : "content.neutral.low"
+    }
+  )
+);
+i.displayName = "PageHeading";
+export {
+  i as PageHeading
+};

package/dist/esm/components/pagination/Pagination.d.ts

@@ -0,0 +1,92 @@
+import { VariantProps } from 'tailwind-variants';
+export declare const pagination: import('tailwind-variants').TVReturnType<{
+    [key: string]: {
+        [key: string]: import('tailwind-merge').ClassNameValue | {
+            base?: import('tailwind-merge').ClassNameValue;
+            pagesList?: import('tailwind-merge').ClassNameValue;
+        };
+    };
+} | {
+    [x: string]: {
+        [x: string]: import('tailwind-merge').ClassNameValue | {
+            base?: import('tailwind-merge').ClassNameValue;
+            pagesList?: import('tailwind-merge').ClassNameValue;
+        };
+    };
+} | {}, {
+    base: string;
+    pagesList: string;
+}, undefined, {
+    [key: string]: {
+        [key: string]: import('tailwind-merge').ClassNameValue | {
+            base?: import('tailwind-merge').ClassNameValue;
+            pagesList?: import('tailwind-merge').ClassNameValue;
+        };
+    };
+} | {}, {
+    base: string;
+    pagesList: string;
+}, import('tailwind-variants').TVReturnType<unknown, {
+    base: string;
+    pagesList: string;
+}, undefined, unknown, unknown, undefined>>;
+export interface PaginationProps extends VariantProps<typeof pagination> {
+    /**
+     * The total number of pages to display
+     */
+    pageCount: number;
+    /**
+     * The current page for controlled mode usage
+     */
+    currentPage?: number;
+    /**
+     * The initial page to display when in uncontrolled mode
+     */
+    defaultPage?: number;
+    /**
+     * Optional callback function that is triggered when a page hover event occurs.
+     * Can be used to handle logic or effects related to the hover action over a specific page.
+     * @param {number} page - The number of the page that is being hovered over.
+     */
+    onPageHover?: (page: number) => void;
+    /**
+     * Callback fired when the page changes
+     * @param page - The new page number
+     * @param previous - The previous page number
+     * @param direction - The direction of navigation (1 for forward, -1 for backward)
+     */
+    onPageChange?: (page: number, previous: number, direction: -1 | 1) => void;
+    /**
+     * Optional callback for the "next" button's press
+     */
+    onNextPress?: () => void;
+    /**
+     * Optional callback for previous button press
+     */
+    onPreviousPress?: () => void;
+}
+/**
+ * The Pagination component helps users navigate through multiple pages of content by providing intuitive controls for moving between pages.
+ *
+ * Pagination offers both controlled and uncontrolled usage, support for keyboard navigation, and automatic handling of page ranges with ellipsis for large numbers of pages.
+ * @param {PaginationProps} props - Regular HTML div attributes plus pagination-specific properties
+ * @see {@link PaginationProps} for all available props
+ * @example
+ * ```tsx
+ * import { Pagination } from '@payfit/unity-components'
+ *
+ * function Example() {
+ *   return (
+ *     <Pagination
+ *       pageCount={10}
+ *       defaultPage={1}
+ *       onPageChange={(page) => console.log(`Navigated to page ${page}`)}
+ *     />
+ *   )
+ * }
+ * ```
+ * @remarks
+ * [API](https://unity-components.payfit.io/?path=/docs/navigation-pagination--docs) • [Demo](https://unity-components.payfit.io/?path=/docs/navigation-pagination--docs)
+ */
+declare const Pagination: import('react').ForwardRefExoticComponent<PaginationProps & import('react').RefAttributes<HTMLDivElement>>;
+export { Pagination };