@salt-ds/core 1.32.0 → 1.34.0

package/dist-types/interactable-card/InteractableCard.d.ts

@@ -21,7 +21,7 @@ export interface InteractableCardProps extends ComponentPropsWithoutRef<"div"> {
     /**
      * Styling variant; defaults to "primary".
      */
-    variant?: "primary" | "secondary";
+    variant?: "primary" | "secondary" | "tertiary";
     /**
      * Value of card (for selectable use case).
      */

package/dist-types/link-card/LinkCard.d.ts

@@ -7,6 +7,6 @@ export interface LinkCardProps extends ComponentPropsWithoutRef<"a"> {
     /**
      * Styling variant; defaults to "primary".
      */
-    variant?: "primary" | "secondary";
+    variant?: "primary" | "secondary" | "tertiary";
 }
 export declare const LinkCard: import("react").ForwardRefExoticComponent<LinkCardProps & import("react").RefAttributes<HTMLAnchorElement>>;

package/dist-types/navigation-item/ExpansionIcon.d.ts

@@ -1,2 +1,12 @@
-import type { NavigationItemProps } from "./NavigationItem";
-export declare function ExpansionIcon({ expanded, orientation, }: Pick<NavigationItemProps, "expanded" | "orientation" | "className">): import("react/jsx-runtime").JSX.Element;
+interface ExpansionIconProps {
+    /**
+     * Whether the navigation item is expanded.
+     */
+    expanded?: boolean;
+    /**
+     * The orientation of the navigation item.
+     */
+    orientation?: "horizontal" | "vertical";
+}
+export declare const ExpansionIcon: ({ expanded, orientation, }: ExpansionIconProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist-types/navigation-item/NavigationItem.d.ts

@@ -1,4 +1,5 @@
 import { type ComponentPropsWithoutRef, type MouseEventHandler } from "react";
+import type { RenderPropsType } from "../utils";
 export interface NavigationItemProps extends ComponentPropsWithoutRef<"div"> {
     /**
      * Whether the navigation item is active.
@@ -24,6 +25,10 @@ export interface NavigationItemProps extends ComponentPropsWithoutRef<"div"> {
      * Whether the navigation item is a parent with nested items.
      */
     parent?: boolean;
+    /**
+     * Render prop to enable customisation of navigation item element.
+     */
+    render?: RenderPropsType["render"];
     /**
      * Action to be triggered when the navigation item is expanded.
      */

package/dist-types/navigation-item/NavigationItemAction.d.ts

@@ -0,0 +1,5 @@
+import type { ComponentPropsWithoutRef } from "react";
+interface NavigationItemActionProps extends ComponentPropsWithoutRef<any> {
+}
+export declare function NavigationItemAction(props: NavigationItemActionProps): import("react").ReactElement<any, string | import("react").JSXElementConstructor<any>>;
+export {};

package/dist-types/overlay/OverlayContext.d.ts

@@ -1,4 +1,5 @@
 import type { FloatingArrowProps, FloatingContext, ReferenceType, Strategy } from "@floating-ui/react";
+import { type HTMLProps } from "react";
 declare type FloatingStyleProps = {
     top: number;
     left: number;
@@ -13,8 +14,8 @@ export interface OverlayContextValue {
     context: FloatingContext;
     reference?: (node: ReferenceType | null) => void;
     floating?: (node: HTMLElement | null) => void;
-    getFloatingProps: (userProps?: React.HTMLProps<HTMLElement> | undefined) => Record<string, unknown>;
-    getReferenceProps: (userProps?: React.HTMLProps<Element> | undefined) => Record<string, unknown>;
+    getFloatingProps: (userProps?: HTMLProps<HTMLElement> | undefined) => Record<string, unknown>;
+    getReferenceProps: (userProps?: HTMLProps<Element> | undefined) => Record<string, unknown>;
 }
 export declare const OverlayContext: import("react").Context<OverlayContextValue>;
 export declare function useOverlayContext(): OverlayContextValue;

package/dist-types/panel/Panel.d.ts

@@ -14,6 +14,6 @@ export interface PanelProps extends HTMLAttributes<HTMLDivElement> {
     /**
      * Styling variant; defaults to "primary".
      */
-    variant?: "primary" | "secondary";
+    variant?: "primary" | "secondary" | "tertiary";
 }
 export declare const Panel: import("react").ForwardRefExoticComponent<PanelProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist-types/salt-provider/SaltProvider.d.ts

@@ -1,5 +1,5 @@
 import { type WindowContextType } from "@salt-ds/window";
-import React, { type ReactElement, type ReactNode } from "react";
+import { type ReactElement, type ReactNode } from "react";
 import { type Breakpoints } from "../breakpoints";
 import type { Accent, ActionFont, Corner, Density, HeadingFont, Mode, ThemeName } from "../theme";
 export declare const DEFAULT_DENSITY = "medium";
@@ -22,9 +22,9 @@ export interface ThemeContextProps {
     /** @deprecated use `actionFont` */
     UNSTABLE_actionFont: ActionFont;
 }
-export declare const DensityContext: React.Context<"touch" | "high" | "low" | "medium">;
-export declare const ThemeContext: React.Context<ThemeContextProps>;
-export declare const BreakpointContext: React.Context<Breakpoints>;
+export declare const DensityContext: import("react").Context<"touch" | "high" | "low" | "medium">;
+export declare const ThemeContext: import("react").Context<ThemeContextProps>;
+export declare const BreakpointContext: import("react").Context<Breakpoints>;
 declare type TargetElement = "root" | "scope" | "child";
 interface SaltProviderBaseProps {
     /**
@@ -55,7 +55,7 @@ interface SaltProviderBaseProps {
     mode?: Mode;
     /**
      * Shape of `{ xs: number; sm: number; md: number; lg: number; xl: number; }`.
-     * Determins breakpoints used in responsive calulation for layout components.
+     * Determines breakpoints used in responsive calculation for layout components.
      */
     breakpoints?: Breakpoints;
     /**
@@ -80,9 +80,29 @@ interface SaltProviderThatClassesToRoot extends SaltProviderThatInjectsThemeElem
 declare type SaltProviderProps = SaltProviderThatAppliesClassesToChild | SaltProviderThatInjectsThemeElement | SaltProviderThatClassesToRoot;
 export declare function SaltProvider({ enableStyleInjection, ...restProps }: SaltProviderProps): import("react/jsx-runtime").JSX.Element;
 interface SaltProviderNextAdditionalProps {
+    /**
+     * Either "sharp" or "rounded".
+     * Determines selected components corner radius.
+     * @default "sharp"
+     */
     corner?: Corner;
+    /**
+     * Either "Open Sans" or "Amplitude".
+     * Determines font family of display and heading text.
+     * @default "Open Sans"
+     */
     headingFont?: HeadingFont;
+    /**
+     * Either "blue" or "teal".
+     * Determines accent color used across components, e.g. Accent Button, List, Calendar.
+     * @default "blue"
+     */
     accent?: Accent;
+    /**
+     * Either "Open Sans" or "Amplitude".
+     * Determines font family of action components, mostly Buttons.
+     * @default "Open Sans"
+     */
     actionFont?: ActionFont;
 }
 export declare type SaltProviderNextProps = SaltProviderProps & SaltProviderNextAdditionalProps;

package/dist-types/utils/index.d.ts

@@ -8,6 +8,7 @@ export * from "./marginMiddleware";
 export * from "./ownerDocument";
 export * from "./ownerWindow";
 export * from "./polymorphicTypes";
+export * from "./renderProps";
 export * from "./setRef";
 export * from "./useControlled";
 export * from "./useFloatingUI";

package/dist-types/utils/renderProps.d.ts

@@ -0,0 +1,5 @@
+import { type ComponentProps, type ElementType, type ReactElement } from "react";
+export interface RenderPropsType {
+    render?: ReactElement | ((props: any) => ReactElement);
+}
+export declare function renderProps<Type extends ElementType>(Type: Type | null, props: RenderPropsType & ComponentProps<Type>): ReactElement;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salt-ds/core",
-  "version": "1.32.0",
+  "version": "1.34.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",

package/dist-cjs/navigation-item/ConditionalWrapper.js

@@ -1,36 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var jsxRuntime = require('react/jsx-runtime');
-
-const ConditionalWrapper = ({
-  children,
-  className,
-  parent,
-  expanded,
-  onExpand,
-  active,
-  href
-}) => {
-  const handleExpand = (event) => {
-    event.stopPropagation();
-    onExpand == null ? void 0 : onExpand(event);
-  };
-  return parent || href === void 0 ? /* @__PURE__ */ jsxRuntime.jsx("button", {
-    "aria-label": "expand",
-    "aria-expanded": expanded,
-    className,
-    onClick: handleExpand,
-    type: "button",
-    children
-  }) : /* @__PURE__ */ jsxRuntime.jsx("a", {
-    "aria-current": active ? "page" : void 0,
-    href,
-    className,
-    children
-  });
-};
-
-exports.ConditionalWrapper = ConditionalWrapper;
-//# sourceMappingURL=ConditionalWrapper.js.map

package/dist-cjs/navigation-item/ConditionalWrapper.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ConditionalWrapper.js","sources":["../src/navigation-item/ConditionalWrapper.tsx"],"sourcesContent":["import type { MouseEvent, ReactNode } from \"react\";\nimport type { NavigationItemProps } from \"./NavigationItem\";\n\ninterface ConditionalWrapperProps\n  extends Pick<\n    NavigationItemProps,\n    \"parent\" | \"expanded\" | \"onExpand\" | \"active\" | \"href\" | \"onClick\"\n  > {\n  children: ReactNode;\n  className: string;\n}\n\nexport const ConditionalWrapper = ({\n  children,\n  className,\n  parent,\n  expanded,\n  onExpand,\n  active,\n  href,\n}: ConditionalWrapperProps) => {\n  const handleExpand = (event: MouseEvent<HTMLButtonElement>) => {\n    event.stopPropagation();\n    onExpand?.(event);\n  };\n\n  return parent || href === undefined ? (\n    <button\n      aria-label=\"expand\"\n      aria-expanded={expanded}\n      className={className}\n      onClick={handleExpand}\n      type=\"button\"\n    >\n      {children}\n    </button>\n  ) : (\n    <a\n      aria-current={active ? \"page\" : undefined}\n      href={href}\n      className={className}\n    >\n      {children}\n    </a>\n  );\n};\n"],"names":["jsx"],"mappings":";;;;;;AAYO,MAAM,qBAAqB,CAAC;AAAA,EACjC,QAAA;AAAA,EACA,SAAA;AAAA,EACA,MAAA;AAAA,EACA,QAAA;AAAA,EACA,QAAA;AAAA,EACA,MAAA;AAAA,EACA,IAAA;AACF,CAA+B,KAAA;AAC7B,EAAM,MAAA,YAAA,GAAe,CAAC,KAAyC,KAAA;AAC7D,IAAA,KAAA,CAAM,eAAgB,EAAA,CAAA;AACtB,IAAW,QAAA,IAAA,IAAA,GAAA,KAAA,CAAA,GAAA,QAAA,CAAA,KAAA,CAAA,CAAA;AAAA,GACb,CAAA;AAEA,EAAO,OAAA,MAAA,IAAU,IAAS,KAAA,KAAA,CAAA,mBACvBA,cAAA,CAAA,QAAA,EAAA;AAAA,IACC,YAAW,EAAA,QAAA;AAAA,IACX,eAAe,EAAA,QAAA;AAAA,IACf,SAAA;AAAA,IACA,OAAS,EAAA,YAAA;AAAA,IACT,IAAK,EAAA,QAAA;AAAA,IAEJ,QAAA;AAAA,GACH,oBAECA,cAAA,CAAA,GAAA,EAAA;AAAA,IACC,cAAA,EAAc,SAAS,MAAS,GAAA,KAAA,CAAA;AAAA,IAChC,IAAA;AAAA,IACA,SAAA;AAAA,IAEC,QAAA;AAAA,GACH,CAAA,CAAA;AAEJ;;;;"}

package/dist-es/navigation-item/ConditionalWrapper.js

@@ -1,32 +0,0 @@
-import { jsx } from 'react/jsx-runtime';
-
-const ConditionalWrapper = ({
-  children,
-  className,
-  parent,
-  expanded,
-  onExpand,
-  active,
-  href
-}) => {
-  const handleExpand = (event) => {
-    event.stopPropagation();
-    onExpand == null ? void 0 : onExpand(event);
-  };
-  return parent || href === void 0 ? /* @__PURE__ */ jsx("button", {
-    "aria-label": "expand",
-    "aria-expanded": expanded,
-    className,
-    onClick: handleExpand,
-    type: "button",
-    children
-  }) : /* @__PURE__ */ jsx("a", {
-    "aria-current": active ? "page" : void 0,
-    href,
-    className,
-    children
-  });
-};
-
-export { ConditionalWrapper };
-//# sourceMappingURL=ConditionalWrapper.js.map

package/dist-es/navigation-item/ConditionalWrapper.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ConditionalWrapper.js","sources":["../src/navigation-item/ConditionalWrapper.tsx"],"sourcesContent":["import type { MouseEvent, ReactNode } from \"react\";\nimport type { NavigationItemProps } from \"./NavigationItem\";\n\ninterface ConditionalWrapperProps\n  extends Pick<\n    NavigationItemProps,\n    \"parent\" | \"expanded\" | \"onExpand\" | \"active\" | \"href\" | \"onClick\"\n  > {\n  children: ReactNode;\n  className: string;\n}\n\nexport const ConditionalWrapper = ({\n  children,\n  className,\n  parent,\n  expanded,\n  onExpand,\n  active,\n  href,\n}: ConditionalWrapperProps) => {\n  const handleExpand = (event: MouseEvent<HTMLButtonElement>) => {\n    event.stopPropagation();\n    onExpand?.(event);\n  };\n\n  return parent || href === undefined ? (\n    <button\n      aria-label=\"expand\"\n      aria-expanded={expanded}\n      className={className}\n      onClick={handleExpand}\n      type=\"button\"\n    >\n      {children}\n    </button>\n  ) : (\n    <a\n      aria-current={active ? \"page\" : undefined}\n      href={href}\n      className={className}\n    >\n      {children}\n    </a>\n  );\n};\n"],"names":[],"mappings":";;AAYO,MAAM,qBAAqB,CAAC;AAAA,EACjC,QAAA;AAAA,EACA,SAAA;AAAA,EACA,MAAA;AAAA,EACA,QAAA;AAAA,EACA,QAAA;AAAA,EACA,MAAA;AAAA,EACA,IAAA;AACF,CAA+B,KAAA;AAC7B,EAAM,MAAA,YAAA,GAAe,CAAC,KAAyC,KAAA;AAC7D,IAAA,KAAA,CAAM,eAAgB,EAAA,CAAA;AACtB,IAAW,QAAA,IAAA,IAAA,GAAA,KAAA,CAAA,GAAA,QAAA,CAAA,KAAA,CAAA,CAAA;AAAA,GACb,CAAA;AAEA,EAAO,OAAA,MAAA,IAAU,IAAS,KAAA,KAAA,CAAA,mBACvB,GAAA,CAAA,QAAA,EAAA;AAAA,IACC,YAAW,EAAA,QAAA;AAAA,IACX,eAAe,EAAA,QAAA;AAAA,IACf,SAAA;AAAA,IACA,OAAS,EAAA,YAAA;AAAA,IACT,IAAK,EAAA,QAAA;AAAA,IAEJ,QAAA;AAAA,GACH,oBAEC,GAAA,CAAA,GAAA,EAAA;AAAA,IACC,cAAA,EAAc,SAAS,MAAS,GAAA,KAAA,CAAA;AAAA,IAChC,IAAA;AAAA,IACA,SAAA;AAAA,IAEC,QAAA;AAAA,GACH,CAAA,CAAA;AAEJ;;;;"}

package/dist-types/navigation-item/ConditionalWrapper.d.ts

@@ -1,8 +0,0 @@
-import type { ReactNode } from "react";
-import type { NavigationItemProps } from "./NavigationItem";
-interface ConditionalWrapperProps extends Pick<NavigationItemProps, "parent" | "expanded" | "onExpand" | "active" | "href" | "onClick"> {
-    children: ReactNode;
-    className: string;
-}
-export declare const ConditionalWrapper: ({ children, className, parent, expanded, onExpand, active, href, }: ConditionalWrapperProps) => import("react/jsx-runtime").JSX.Element;
-export {};