@vkzstudio/muza-ui 1.0.46 → 1.0.48

package/dist/components/Typography/Typography.js

@@ -1,62 +1,75 @@
 import * as t from "react";
-import { cva as d } from "class-variance-authority";
-import { cn as p } from "../../utils/cn.js";
-const f = d(["text-inherit"], {
-  variants: {
-    size: {
-      "7xl": "text-7xl leading-[120%] tracking-[-0.0347em]",
-      "6xl": "text-6xl leading-[120%] tracking-[-0.03906em]",
-      "5xl": "text-5xl leading-[120%] tracking-[-0.04464em]",
-      "4xl": "text-4xl leading-[120%] tracking-[-0.03125em]",
-      "3xl": "text-3xl leading-[120%] tracking-[-0.0375em]",
-      "2xl": "text-2xl leading-[130%] tracking-[-0.03125em]",
-      xl: "text-xl leading-[130%] tracking-[-0.02083em]",
-      lg: "text-lg leading-[140%] tracking-[-0.0125em]",
-      md: "text-md leading-[140%] tracking-[-0.01389em]",
-      base: "text-sm leading-[140%] tracking-[-0.01562em]",
-      sm: "text-xs leading-[140%] tracking-normal",
-      caption: "text-2xs leading-[140%] tracking-normal",
-      input: "text-input leading-[140%] tracking-normal"
-    },
-    weight: {
-      light: "font-light",
-      regular: "font-regular",
-      medium: "font-medium",
-      bold: "font-bold"
-    },
-    variant: {
-      title: "font-heading",
-      // Future proofing
-      body: "font-text",
-      // Future proofing
-      paragraph: "font-text leading-[180%]",
-      cta: "font-cta leading-[120%]"
-    },
-    uppercase: {
-      true: "tracking-normal uppercase",
-      false: ""
+import { cva as p } from "class-variance-authority";
+import { cn as f } from "../../utils/cn.js";
+const u = p(
+  ["text-inherit", "decoration-solid decoration-1"],
+  {
+    variants: {
+      size: {
+        "7xl": "text-7xl leading-[120%] tracking-[-0.0347em]",
+        "6xl": "text-6xl leading-[120%] tracking-[-0.03906em]",
+        "5xl": "text-5xl leading-[120%] tracking-[-0.04464em]",
+        "4xl": "text-4xl leading-[120%] tracking-[-0.03125em]",
+        "3xl": "text-3xl leading-[120%] tracking-[-0.0375em]",
+        "2xl": "text-2xl leading-[130%] tracking-[-0.03125em]",
+        xl: "text-xl leading-[130%] tracking-[-0.02083em]",
+        lg: "text-lg leading-[140%] tracking-[-0.0125em]",
+        md: "text-md leading-[140%] tracking-[-0.01389em]",
+        base: "text-sm leading-[140%] tracking-[-0.01562em]",
+        sm: "text-xs leading-[140%] tracking-normal",
+        caption: "text-2xs leading-[140%] tracking-normal",
+        input: "text-input leading-[140%] tracking-normal"
+      },
+      weight: {
+        light: "font-light",
+        regular: "font-regular",
+        medium: "font-medium",
+        bold: "font-bold"
+      },
+      variant: {
+        title: "font-heading",
+        // Future proofing
+        body: "font-text",
+        // Future proofing
+        paragraph: "font-text leading-[180%]",
+        cta: "font-cta leading-[120%]"
+      },
+      uppercase: {
+        true: "tracking-normal uppercase",
+        false: ""
+      },
+      fixY: {
+        true: "fix-y-text",
+        false: ""
+      },
+      // The underline rendering spec (offset, skip-ink, position from-font)
+      // is underline-specific per the CSS spec but visibly shifts
+      // `line-through` in some browsers. We apply it by default so it takes
+      // effect whenever `text-decoration-line` adds an underline, and turn
+      // it off when the consumer opts into `line-through` rendering.
+      lineThrough: {
+        true: "line-through",
+        false: "underline-offset-[16%] [text-decoration-skip-ink:auto] [text-underline-position:from-font]"
+      }
     },
-    fixY: {
-      true: "fix-y-text",
-      false: ""
-    }
-  },
-  compoundVariants: [
-    {
-      variant: ["cta", "body"],
-      size: ["sm", "caption", "input"],
-      fixY: !0,
-      class: "fix-y-text-1"
+    compoundVariants: [
+      {
+        variant: ["cta", "body"],
+        size: ["sm", "caption", "input"],
+        fixY: !0,
+        class: "fix-y-text-1"
+      }
+    ],
+    defaultVariants: {
+      variant: "body",
+      size: "base",
+      weight: "regular",
+      uppercase: !1,
+      fixY: !1,
+      lineThrough: !1
     }
-  ],
-  defaultVariants: {
-    variant: "body",
-    size: "base",
-    weight: "regular",
-    uppercase: !1,
-    fixY: !1
   }
-}), u = t.forwardRef(
+), h = t.forwardRef(
   ({
     component: e,
     size: a,
@@ -64,35 +77,37 @@ const f = d(["text-inherit"], {
     weight: i,
     uppercase: r,
     fixY: l,
+    lineThrough: o,
     className: g,
     children: x,
-    ...o
-  }, m) => {
-    const c = e ?? "p", s = {
-      className: p(
-        f({
+    ...s
+  }, c) => {
+    const m = e ?? "p", d = {
+      className: f(
+        u({
           size: a,
           variant: n,
           weight: i,
           uppercase: r,
           fixY: l,
+          lineThrough: o,
           className: g
         })
       ),
-      ...o
+      ...s
     };
     return t.createElement(
-      c,
+      m,
       {
-        ...s,
-        ref: m
+        ...d,
+        ref: c
       },
       x
     );
   }
 );
-u.displayName = "Typography";
+h.displayName = "Typography";
 export {
-  u as Typography,
-  f as typographyVariants
+  h as Typography,
+  u as typographyVariants
 };

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

@@ -13,5 +13,6 @@ export declare const WeightVariations: Story;
 export declare const UppercaseExample: Story;
 export declare const VariantComparison: Story;
 export declare const RealWorldExample: Story;
+export declare const Decorations: Story;
 export declare const Playground: Story;
 //# sourceMappingURL=Typography.stories.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Typography.stories.d.ts","sourceRoot":"","sources":["../../../src/components/Typography/Typography.stories.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAE3D,OAAO,EAAE,UAAU,EAAwB,MAAM,cAAc,CAAA;AAgC/D,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,UAAU,CAgFjC,CAAA;AAED,eAAe,IAAI,CAAA;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,UAAU,CAAC,CAAA;AAuCxC,eAAO,MAAM,OAAO,EAAE,KAkBrB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAwEtB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAsEtB,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,KAuE3B,CAAA;AAED,eAAO,MAAM,OAAO,EAAE,KAsErB,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,KAgC5B,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KAuC9B,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KAyC9B,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,KAwD/B,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KA4H9B,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,KAkBxB,CAAA"}
+{"version":3,"file":"Typography.stories.d.ts","sourceRoot":"","sources":["../../../src/components/Typography/Typography.stories.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAE3D,OAAO,EAAE,UAAU,EAAwB,MAAM,cAAc,CAAA;AAgC/D,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,UAAU,CAwDjC,CAAA;AAED,eAAe,IAAI,CAAA;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,UAAU,CAAC,CAAA;AAuCxC,eAAO,MAAM,OAAO,EAAE,KAkBrB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAwEtB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAsEtB,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,KAuE3B,CAAA;AAED,eAAO,MAAM,OAAO,EAAE,KAsErB,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,KAgC5B,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KAuC9B,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KAyC9B,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,KAwD/B,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,KA4H9B,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,KAsIzB,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,KAkBxB,CAAA"}

package/dist/components/TypographyLink/TypographyLink.d.ts

@@ -0,0 +1,72 @@
+import { AnchorHTMLAttributes } from 'react';
+import { VariantProps } from 'class-variance-authority';
+import { TypographyProps } from '../Typography';
+export declare const typographyLinkVariants: (props?: ({
+    variant?: "default" | "danger" | "invertPrimary" | "invertSecondary" | null | undefined;
+    underline?: boolean | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+type InheritedTypographyProps = Pick<TypographyProps, 'size' | 'weight' | 'uppercase' | 'fixY'>;
+/** Props for the TypographyLink component. */
+export interface TypographyLinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, keyof InheritedTypographyProps> {
+    /**
+     * Renders the single child as the root element via Radix `Slot`, merging
+     * TypographyLink's props, className, ref, and event handlers onto it. Use
+     * for polymorphic rendering — e.g. a Next.js `Link`, a react-router `Link`,
+     * or any anchor-like component — while keeping full TypographyLink styling.
+     *
+     * @default false
+     * @example
+     * <TypographyLink asChild>
+     *   <Link href="/dashboard">Go to dashboard</Link>
+     * </TypographyLink>
+     */
+    asChild?: boolean;
+    /**
+     * Color treatment of the link. `default` uses brand tokens; `danger`
+     * uses destructive/error tokens; `invertPrimary` and `invertSecondary`
+     * are intended for use on dark or branded surfaces.
+     *
+     * @default 'default'
+     */
+    variant?: NonNullable<VariantProps<typeof typographyLinkVariants>['variant']>;
+    /**
+     * Shows the underline beneath the text. Uses native CSS `text-decoration`
+     * so the underline wraps correctly across multiple lines. When `false`,
+     * the underline fades in on hover and keyboard focus so the interactive
+     * affordance stays discoverable.
+     *
+     * @default true
+     */
+    underline?: boolean;
+    /**
+     * Marks the link as disabled. Sets `aria-disabled="true"` and disables
+     * pointer events; the `href` is preserved on the DOM for assistive tech.
+     * Use instead of removing `href` so the element stays a link semantically.
+     *
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Typography size scale applied to the link text.
+     * @see TypographyProps
+     */
+    size?: InheritedTypographyProps['size'];
+    /**
+     * Typography font weight applied to the link text.
+     * @see TypographyProps
+     */
+    weight?: InheritedTypographyProps['weight'];
+    /**
+     * Renders the link text in uppercase.
+     * @see TypographyProps
+     */
+    uppercase?: InheritedTypographyProps['uppercase'];
+    /**
+     * Applies the vertical-trim fix used by Typography for tighter alignment.
+     * @see TypographyProps
+     */
+    fixY?: InheritedTypographyProps['fixY'];
+}
+declare const TypographyLink: import('react').ForwardRefExoticComponent<TypographyLinkProps & import('react').RefAttributes<HTMLAnchorElement>>;
+export { TypographyLink };
+//# sourceMappingURL=TypographyLink.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TypographyLink.d.ts","sourceRoot":"","sources":["../../../src/components/TypographyLink/TypographyLink.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,oBAAoB,EAK1B,MAAM,OAAO,CAAA;AAEd,OAAO,EAAE,KAAK,YAAY,EAAO,MAAM,0BAA0B,CAAA;AAEjE,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,eAAe,CAAA;AAEhE,eAAO,MAAM,sBAAsB;;;8EAsDlC,CAAA;AAED,KAAK,wBAAwB,GAAG,IAAI,CAClC,eAAe,EACf,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CACzC,CAAA;AAED,8CAA8C;AAC9C,MAAM,WAAW,mBACf,SAAQ,IAAI,CACV,oBAAoB,CAAC,iBAAiB,CAAC,EACvC,MAAM,wBAAwB,CAC/B;IACD;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,OAAO,sBAAsB,CAAC,CAAC,SAAS,CAAC,CAAC,CAAA;IAC7E;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,wBAAwB,CAAC,MAAM,CAAC,CAAA;IACvC;;;OAGG;IACH,MAAM,CAAC,EAAE,wBAAwB,CAAC,QAAQ,CAAC,CAAA;IAC3C;;;OAGG;IACH,SAAS,CAAC,EAAE,wBAAwB,CAAC,WAAW,CAAC,CAAA;IACjD;;;OAGG;IACH,IAAI,CAAC,EAAE,wBAAwB,CAAC,MAAM,CAAC,CAAA;CACxC;AAED,QAAA,MAAM,cAAc,mHAiDnB,CAAA;AAGD,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/dist/components/TypographyLink/TypographyLink.js

@@ -0,0 +1,103 @@
+import { jsx as t } from "react/jsx-runtime";
+import { forwardRef as h, isValidElement as b, cloneElement as g } from "react";
+import { Slot as k } from "@radix-ui/react-slot";
+import { cva as x } from "class-variance-authority";
+import { cn as w } from "../../utils/cn.js";
+import { Typography as L } from "../Typography/Typography.js";
+const T = x(
+  [
+    "cursor-pointer transition-colors duration-200 ease-out",
+    // Underline spec from Figma — applied as base utilities so they take
+    // effect whenever the `underline` variant adds `text-decoration-line`.
+    // The 16% offset scales with the current font size.
+    "decoration-solid decoration-1 underline-offset-[16%]",
+    "[text-decoration-skip-ink:auto] [text-underline-position:from-font]",
+    "focus-visible:outline-none",
+    "aria-disabled:pointer-events-none aria-disabled:cursor-not-allowed"
+  ],
+  {
+    variants: {
+      variant: {
+        default: [
+          "text-comp-typography-link-brand-def",
+          "hover:text-comp-typography-link-brand-hover",
+          "focus-visible-default focus-visible:text-comp-typography-link-brand-focused",
+          "aria-disabled:text-comp-typography-link-brand-disabled"
+        ],
+        danger: [
+          "text-comp-typography-link-danger-def",
+          "hover:text-comp-typography-link-danger-hover",
+          "focus-visible-default focus-visible:text-comp-typography-link-danger-focused",
+          "aria-disabled:text-comp-typography-link-danger-disabled"
+        ],
+        invertPrimary: [
+          "text-comp-typography-link-invert-primary-def",
+          "hover:text-comp-typography-link-invert-primary-hover",
+          "focus-visible-default focus-visible:text-comp-typography-link-invert-primary-focused",
+          "aria-disabled:text-comp-typography-link-invert-primary-disabled"
+        ],
+        invertSecondary: [
+          "text-comp-typography-link-invert-secondary-def",
+          "hover:text-comp-typography-link-invert-secondary-hover",
+          "focus-visible-default focus-visible:text-comp-typography-link-invert-secondary-focused",
+          "aria-disabled:text-comp-typography-link-invert-secondary-disabled"
+        ]
+      },
+      underline: {
+        true: "underline",
+        // The underline is always declared but starts transparent and
+        // fades in on hover / keyboard focus. We animate
+        // text-decoration-color (which `transition-colors` covers)
+        // because text-decoration-line itself is not animatable.
+        false: "underline decoration-transparent hover:decoration-current focus-visible:decoration-current"
+      }
+    },
+    defaultVariants: {
+      variant: "default",
+      underline: !0
+    }
+  }
+), V = h(
+  ({
+    className: i,
+    asChild: r = !1,
+    variant: a,
+    underline: n,
+    disabled: p = !1,
+    size: d,
+    weight: s,
+    uppercase: l,
+    fixY: c,
+    children: e,
+    ...y
+  }, f) => {
+    const m = r ? k : "a", o = (v) => /* @__PURE__ */ t(
+      L,
+      {
+        component: "span",
+        size: d,
+        weight: s,
+        uppercase: l,
+        fixY: c,
+        children: v
+      }
+    ), u = r && b(e) ? g(e, void 0, o(e.props.children)) : o(e);
+    return /* @__PURE__ */ t(
+      m,
+      {
+        ref: f,
+        "aria-disabled": p || void 0,
+        className: w(
+          T({ variant: a, underline: n, className: i })
+        ),
+        ...y,
+        children: u
+      }
+    );
+  }
+);
+V.displayName = "TypographyLink";
+export {
+  V as TypographyLink,
+  T as typographyLinkVariants
+};

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

@@ -0,0 +1,12 @@
+import { Meta, StoryObj } from '@storybook/react-vite';
+import { TypographyLink } from './TypographyLink';
+declare const meta: Meta<typeof TypographyLink>;
+export default meta;
+type Story = StoryObj<typeof TypographyLink>;
+export declare const Default: Story;
+export declare const AllStates: Story;
+export declare const Sizes: Story;
+export declare const MultilineUnderline: Story;
+export declare const Disabled: Story;
+export declare const AsChildExample: Story;
+//# sourceMappingURL=TypographyLink.stories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TypographyLink.stories.d.ts","sourceRoot":"","sources":["../../../src/components/TypographyLink/TypographyLink.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAE3D,OAAO,EAAE,cAAc,EAA4B,MAAM,kBAAkB,CAAA;AAyB3E,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,OAAO,cAAc,CAsErC,CAAA;AAED,eAAe,IAAI,CAAA;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,cAAc,CAAC,CAAA;AAI5C,eAAO,MAAM,OAAO,EAAE,KAIrB,CAAA;AAgDD,eAAO,MAAM,SAAS,EAAE,KA8BvB,CAAA;AAED,eAAO,MAAM,KAAK,EAAE,KA6BnB,CAAA;AAED,eAAO,MAAM,kBAAkB,EAAE,KAoDhC,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAQtB,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,KAuB5B,CAAA"}

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

@@ -0,0 +1,2 @@
+export * from './TypographyLink';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/TypographyLink/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA"}

package/dist/components/UniversalFooter/UniversalFooter.d.ts

@@ -0,0 +1,198 @@
+import { TypographyLinkProps } from '../TypographyLink';
+import * as React from 'react';
+/**
+ * Props for the UniversalFooter root component.
+ *
+ * Renders a `<footer>` landmark with the dark surface background and an
+ * inner content container whose width steps with the breakpoint scale
+ * (matching the project-wide `Container` pattern). Children compose the
+ * footer's vertical sections — typically a [[UniversalFooterTop]] row, a
+ * [[UniversalFooterSections]] block, a [[UniversalFooterBottom]] row, and
+ * a [[UniversalFooterCopyright]] line, each separated by
+ * [[UniversalFooterSeparator]] rules.
+ */
+export interface UniversalFooterProps extends React.ComponentProps<'footer'> {
+    /**
+     * Classes appended to the inner content container that controls the
+     * stepped responsive width and centering. Use to override or extend
+     * the defaults — for example to pin the footer content to a different
+     * max width than the rest of the page. Whatever you pass wins via
+     * Tailwind's source-order merge.
+     */
+    contentClassName?: string;
+}
+declare const UniversalFooter: React.ForwardRefExoticComponent<Omit<UniversalFooterProps, "ref"> & React.RefAttributes<HTMLElement>>;
+/** Props for the [[UniversalFooterBody]] wrapper around top/sections/bottom. */
+export type UniversalFooterBodyProps = React.ComponentProps<'div'>;
+declare const UniversalFooterBody: {
+    ({ className, ...props }: UniversalFooterBodyProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/** Props for the [[UniversalFooterTop]] row that pairs the brand logo with social links. */
+export type UniversalFooterTopProps = React.ComponentProps<'div'>;
+declare const UniversalFooterTop: {
+    ({ className, ...props }: UniversalFooterTopProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/**
+ * Props for [[UniversalFooterLogo]] — a sized container for a consumer-
+ * supplied logo (a Next.js `Image`, an SVG component, or any other React
+ * node). Size the wrapper via token-backed Tailwind utilities on
+ * `className` (e.g. `className="h-7 w-auto"`) so dimensions stay in sync
+ * with the design system instead of inline styles.
+ */
+export type UniversalFooterLogoProps = React.ComponentProps<'div'>;
+declare const UniversalFooterLogo: {
+    ({ className, ...props }: UniversalFooterLogoProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/** Props for the [[UniversalFooterSocialList]] container of social-link buttons. */
+export type UniversalFooterSocialListProps = React.ComponentProps<'ul'>;
+declare const UniversalFooterSocialList: {
+    ({ className, ...props }: UniversalFooterSocialListProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/**
+ * Props for [[UniversalFooterSocialLink]] — a circular brand-filled icon
+ * button rendered inside a list item for use in [[UniversalFooterSocialList]].
+ * Pass the brand icon (e.g. `<Facebook />`, `<Linkedin />`) as children;
+ * sizing is handled internally.
+ */
+export interface UniversalFooterSocialLinkProps extends React.ComponentProps<'a'> {
+    /**
+     * Accessible label for the icon-only link. Required — screen readers
+     * have no other text to read for these buttons.
+     */
+    'aria-label': string;
+}
+declare const UniversalFooterSocialLink: React.ForwardRefExoticComponent<Omit<UniversalFooterSocialLinkProps, "ref"> & React.RefAttributes<HTMLAnchorElement>>;
+/**
+ * Props for the [[UniversalFooterSeparator]] horizontal rule. Thin divider
+ * painted with the secondary stroke token on the dark surface — used between
+ * the top row and the sections, and between the sections and the bottom row.
+ */
+export type UniversalFooterSeparatorProps = React.ComponentProps<'hr'>;
+declare const UniversalFooterSeparator: {
+    ({ className, ...props }: UniversalFooterSeparatorProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/** Props for the [[UniversalFooterSections]] responsive container. */
+export type UniversalFooterSectionsProps = React.ComponentProps<'div'>;
+/**
+ * Lays out section children responsively:
+ * - `lg` (≥1024px): horizontal row, sections justified between.
+ * - `md` (≥768px): 2-column grid; the **first** section spans both rows
+ *   (left column) while the remaining sections stack in the right column.
+ *   This matches the design-system tablet pattern where the primary section
+ *   (typically the long category list) occupies the full left column.
+ * - mobile (<768px): single column, sections stacked.
+ *
+ * Kept as a plain `<div>` because the responsive layout flips between
+ * `display: flex` and `display: grid` — Flex can't represent grid mode.
+ */
+declare const UniversalFooterSections: {
+    ({ className, ...props }: UniversalFooterSectionsProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/**
+ * Props for [[UniversalFooterSection]] — wraps a heading with a vertical
+ * list of links (or other content). Pass link content as children, usually
+ * [[UniversalFooterLink]] items but any node is accepted (e.g. an inline
+ * modal trigger, an [[UniversalFooterAppBadges]] group).
+ */
+export interface UniversalFooterSectionProps extends React.ComponentProps<'div'> {
+    /**
+     * Heading text rendered above the section's content. Wrapped in
+     * `Typography` with medium weight on the invert (white) color.
+     */
+    heading: React.ReactNode;
+    /**
+     * Splits child items into N visual columns at `lg` (desktop). Below `lg`
+     * the items collapse into a single vertical list. The split is done by
+     * dividing children evenly in source order — pass items in the order you
+     * want them to read top-to-bottom, left-to-right.
+     *
+     * @default 1
+     */
+    columns?: 1 | 2 | 3;
+}
+declare const UniversalFooterSection: {
+    ({ className, heading, columns, children, ...props }: UniversalFooterSectionProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/**
+ * Props for [[UniversalFooterLink]] — wraps [[TypographyLink]] with footer
+ * defaults: `invertSecondary` color for dark-surface body links, no resting
+ * underline, and `size="base"`. Override any of those via the underlying
+ * `TypographyLink` props.
+ */
+export type UniversalFooterLinkProps = TypographyLinkProps;
+declare const UniversalFooterLink: React.ForwardRefExoticComponent<TypographyLinkProps & React.RefAttributes<HTMLAnchorElement>>;
+/**
+ * Props for [[UniversalFooterContactList]] — tighter vertical rhythm than
+ * the standard section list, matching the design `gap-md` (12px) spacing
+ * used for phone + email contact rows.
+ */
+export type UniversalFooterContactListProps = React.ComponentProps<'div'>;
+declare const UniversalFooterContactList: {
+    ({ className, ...props }: UniversalFooterContactListProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/**
+ * Props for [[UniversalFooterAppBadges]] — horizontal row of app-store /
+ * google-play badge links. The consumer supplies the actual badge artwork;
+ * wrap each badge in an `<a>` with `href` and an `aria-label` so screen-
+ * reader users get a destination cue.
+ */
+export type UniversalFooterAppBadgesProps = React.ComponentProps<'div'>;
+declare const UniversalFooterAppBadges: {
+    ({ className, ...props }: UniversalFooterAppBadgesProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/** Props for the [[UniversalFooterBottom]] row that pairs meta blocks like the language switcher and an employer link. */
+export type UniversalFooterBottomProps = React.ComponentProps<'div'>;
+declare const UniversalFooterBottom: {
+    ({ className, ...props }: UniversalFooterBottomProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/**
+ * Props for [[UniversalFooterBottomGroup]] — two-row stack with a small
+ * muted label above the content. Used for the language-switcher block on
+ * the left and the employer / portal link on the right of the bottom row.
+ */
+export interface UniversalFooterBottomGroupProps extends React.ComponentProps<'div'> {
+    /** Muted label rendered above the content (e.g. "Language", "Are you an employer?"). */
+    label?: React.ReactNode;
+    /**
+     * Horizontal alignment of the group within the bottom row at `md`+.
+     * Below `md` both groups stack and align to the start regardless.
+     *
+     * @default 'start'
+     */
+    align?: 'start' | 'end';
+    /**
+     * Typography size of the label. Defaults to `sm` (14px from `text/xs`)
+     * for the language label and should be set to `base` (16px) for the
+     * employer label per Figma.
+     *
+     * @default 'sm'
+     */
+    labelSize?: 'sm' | 'base';
+}
+declare const UniversalFooterBottomGroup: {
+    ({ className, label, align, labelSize, children, ...props }: UniversalFooterBottomGroupProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/**
+ * Props for [[UniversalFooterCopyright]] — centered, muted (40% opacity)
+ * small text rendered as the last item of the footer. Wrap any
+ * copyright / company text; the consumer supplies the year and legal
+ * identifiers.
+ */
+export type UniversalFooterCopyrightProps = React.ComponentProps<'p'>;
+declare const UniversalFooterCopyright: {
+    ({ className, ...props }: UniversalFooterCopyrightProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export { UniversalFooter, UniversalFooterBody, UniversalFooterTop, UniversalFooterLogo, UniversalFooterSocialList, UniversalFooterSocialLink, UniversalFooterSeparator, UniversalFooterSections, UniversalFooterSection, UniversalFooterLink, UniversalFooterContactList, UniversalFooterAppBadges, UniversalFooterBottom, UniversalFooterBottomGroup, UniversalFooterCopyright, };
+//# sourceMappingURL=UniversalFooter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UniversalFooter.d.ts","sourceRoot":"","sources":["../../../src/components/UniversalFooter/UniversalFooter.tsx"],"names":[],"mappings":"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"}