@stackone/malachite 0.68.0 → 0.69.0

package/dist/index.d.ts

@@ -127,7 +127,7 @@ declare interface AlertProps {
     onToggle?: (expanded: boolean) => void;
 }
 
-declare type AlertType = 'info' | 'success' | 'error' | 'warning';
+export declare type AlertType = 'info' | 'success' | 'error' | 'warning';
 
 export declare const AppLogo: default_2.FC<AppLogoProps>;
 
@@ -223,9 +223,25 @@ declare interface BaseSkeletonProps {
     className?: string;
 }
 
+export declare interface BreadcrumbLink {
+    name: default_2.ReactNode;
+    url?: string;
+    isRoot?: boolean;
+}
+
+export declare const Breadcrumbs: default_2.FC<BreadcrumbsProps>;
+
+export declare interface BreadcrumbsProps {
+    links: BreadcrumbLink[];
+    actions?: PageAction[];
+    renderLink?: RenderBreadcrumbLink;
+    className?: string;
+    style?: default_2.CSSProperties;
+}
+
 export declare const buildActionBarMenuItems: (buttons: ActionBarItem[]) => ActionMenuItem[];
 
-export declare const Button: default_2.ForwardRefExoticComponent<ButtonProps & default_2.RefAttributes<HTMLButtonElement>>;
+export declare const Button: default_2.ForwardRefExoticComponent<ButtonProps & default_2.RefAttributes<HTMLButtonElement | HTMLAnchorElement>>;
 
 declare interface ButtonDefinition {
     label: string;
@@ -276,14 +292,18 @@ declare interface ButtonProps extends default_2.ButtonHTMLAttributes<HTMLButtonE
     tooltipPlacement?: 'top' | 'bottom' | 'left' | 'right';
     iconOnly?: boolean;
     children?: default_2.ReactNode;
-    onClick?: default_2.MouseEventHandler<HTMLButtonElement>;
+    onClick?: default_2.MouseEventHandler<HTMLButtonElement & HTMLAnchorElement>;
+    /** Renders the button as a real anchor, so a link action is never an <a> nested in a <button>. */
+    href?: string;
+    target?: default_2.HTMLAttributeAnchorTarget;
+    rel?: string;
 }
 
-declare type ButtonRadius = 'md' | 'lg' | 'xl';
+export declare type ButtonRadius = 'md' | 'lg' | 'xl';
 
-declare type ButtonSize = 'xsmall' | 'small' | 'medium' | 'large';
+export declare type ButtonSize = 'xsmall' | 'small' | 'medium' | 'large';
 
-declare type ButtonVariant = 'filled' | 'outline' | 'destructive' | 'success' | 'warning' | 'error' | 'ghost' | 'no-style';
+export declare type ButtonVariant = 'filled' | 'outline' | 'destructive' | 'success' | 'warning' | 'error' | 'ghost' | 'no-style';
 
 export declare const Card: default_2.FC<CardProps>;
 
@@ -660,6 +680,21 @@ declare interface EllipsisTextProps {
     style?: default_2.CSSProperties;
 }
 
+export declare interface EmptyLayoutProps {
+    title?: string;
+    children: default_2.ReactNode;
+    centered?: boolean;
+    uniformPadding?: boolean;
+    headerActions?: default_2.ReactNode;
+    background?: default_2.ReactNode;
+    /** Demotes the default `main` landmark — pass e.g. `region` when the app owns its own. */
+    role?: default_2.AriaRole;
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+    className?: string;
+    style?: default_2.CSSProperties;
+}
+
 export declare const Flex: default_2.FC<FlexProps>;
 
 export declare enum FlexAlign {
@@ -1357,6 +1392,28 @@ declare type PaddingSize_2 = 'xsmall' | 'small' | 'medium' | 'large' | 'none';
 
 declare type PaddingSize_3 = 'default' | 'compact';
 
+export declare interface PageAction {
+    label: string;
+    /** Ignored when `href` is set. */
+    onClick?: () => void;
+    disabled?: boolean;
+    variant?: ButtonVariant;
+    icon?: default_2.ReactNode;
+    href?: string;
+    /** Defaults to `_blank`. */
+    target?: '_self' | '_blank';
+    tooltip?: string;
+    tooltipPlacement?: 'top' | 'bottom' | 'left' | 'right';
+    dividerBefore?: boolean;
+}
+
+declare type PageContentGap = 'small' | 'medium' | 'large' | 'xlarge';
+
+export declare const PageLayout: {
+    Regular: FC<RegularLayoutProps>;
+    Empty: FC<EmptyLayoutProps>;
+};
+
 declare interface PageTitleProps {
     children: default_2.ReactNode;
     margin?: string;
@@ -1479,6 +1536,48 @@ export declare interface RadioProps {
     id?: string;
 }
 
+export declare interface RegularLayoutProps {
+    breadcrumbLinks?: BreadcrumbLink[];
+    breadcrumbActions?: PageAction[];
+    renderLink?: RenderBreadcrumbLink;
+    title?: default_2.ReactNode;
+    titleSuffix?: default_2.ReactNode;
+    subtitle?: string;
+    description?: default_2.ReactNode;
+    buttons?: PageAction[];
+    /**
+     * Hides the buttons and skeletons the title. `subtitle` and `description` are only
+     * skeletoned when those props are also passed.
+     */
+    loading?: boolean;
+    children: default_2.ReactNode;
+    centered?: boolean;
+    noPadding?: boolean;
+    contentGap?: PageContentGap;
+    alert?: {
+        message: string;
+        type?: AlertType;
+    };
+    /** Demotes the default `main` landmark — pass e.g. `region` when the app owns its own. */
+    role?: default_2.AriaRole;
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+    className?: string;
+    style?: default_2.CSSProperties;
+}
+
+/**
+ * Renders a crumb or the back button through the app's own link component, spreading every
+ * field onto it. A client-side-routed consumer MUST pass this, or navigation breaks.
+ */
+declare type RenderBreadcrumbLink = (props: {
+    href: string;
+    children: default_2.ReactNode;
+    className?: string;
+    'aria-current'?: 'page';
+    'aria-label'?: string;
+}) => default_2.ReactNode;
+
 /**
  * Reset theme to default values
  */

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A as s, c as t, d as o, e as r, f as i, g as n, B as l, h as p, i as d, j as T, k as c, l as m, m as S, n as u, o as h, p as g, q as C, r as y, D as w, s as x, t as B, u as F, F as A, v as f, w as v, x as L, y as b, z as k, E as P, G as z, H as D, I as M, K as R, L as I, J as N, M as V, N as j, O as q, P as E, Q as G, R as H, S as J, T as K, U as O, V as W, W as Q, X as U, Y as X, Z as Y, $ as Z, a0 as $, a1 as _, a2 as aa, a3 as ea, a4 as sa, a5 as ta, a6 as oa, a7 as ra, a8 as ia, a9 as na, aa as la, ab as pa, ac as da, ad as Ta, ae as ca, af as ma, ag as Sa, ah as ua, ai as ha, aj as ga, ak as Ca, al as ya, am as wa, an as xa, ao as Ba, ap as Fa, aq as Aa, ar as fa, as as va, at as La, au as ba, av as ka, aw as Pa, ax as za, ay as Da, az as Ma, aA as Ra, aB as Ia } from "./index-BRH2BT_r.js";
+import { A as s, c as t, d as o, e as r, f as i, g as n, B as l, h as p, i as d, j as c, k as m, l as T, m as S, n as u, o as g, p as h, q as C, r as y, s as B, D as w, t as x, u as F, v as A, F as L, w as b, x as f, y as v, z as P, E as k, G as D, H as z, I as M, J as R, K as I, L as N, M as V, N as j, O as q, P as E, Q as G, R as H, S as J, T as K, U as O, V as W, W as Q, X as U, Y as X, Z as Y, $ as Z, a0 as $, a1 as _, a2 as aa, a3 as ea, a4 as sa, a5 as ta, a6 as oa, a7 as ra, a8 as ia, a9 as na, aa as la, ab as pa, ac as da, ad as ca, ae as ma, af as Ta, ag as Sa, ah as ua, ai as ga, aj as ha, ak as Ca, al as ya, am as Ba, an as wa, ao as xa, ap as Fa, aq as Aa, ar as La, as as ba, at as fa, au as va, av as Pa, aw as ka, ax as Da, ay as za, az as Ma, aA as Ra, aB as Ia, aC as Na, aD as Va } from "./index-CG9LBZIb.js";
 export {
   s as Accordion,
   t as ActionBar,
@@ -7,86 +7,88 @@ export {
   i as AppLogo,
   n as Avatar,
   l as BaseFormComponent,
-  p as Button,
-  d as ButtonList,
-  T as Card,
-  c as CardStrip,
-  m as Checkbox,
-  S as ClampText,
-  u as CodeBlock,
+  p as Breadcrumbs,
+  d as Button,
+  c as ButtonList,
+  m as Card,
+  T as CardStrip,
+  S as Checkbox,
+  u as ClampText,
+  g as CodeBlock,
   h as CollapsibleSection,
-  g as Confetti,
-  C as ConnectionHeader,
-  y as CustomIcons,
+  C as Confetti,
+  y as ConnectionHeader,
+  B as CustomIcons,
   w as DefinitionRow,
   x as Divider,
-  B as DividerVariant,
-  F as Dropdown,
-  A as Flex,
-  f as FlexAlign,
-  v as FlexDirection,
-  L as FlexGapSize,
-  b as FlexJustify,
+  F as DividerVariant,
+  A as Dropdown,
+  L as Flex,
+  b as FlexAlign,
+  f as FlexDirection,
+  v as FlexGapSize,
+  P as FlexJustify,
   k as FooterLinks,
-  P as FooterNav,
+  D as FooterNav,
   z as Form,
-  D as FormItem,
-  M as Input,
-  R as KeyValueList,
-  I as Link,
-  N as LoadingBar,
-  V as MalachiteContext,
-  j as MultiSelect,
-  q as NumberTag,
-  E as OverflowRow,
-  G as Padded,
-  H as PaddingSize,
-  J as PillButton,
-  K as PreviewTree,
-  O as PreviewTreeRow,
-  W as Progress,
-  Q as Radio,
-  U as Search,
-  X as SegmentedControl,
-  Y as SelectableCard,
-  Z as ShadowEscape,
-  $ as SidePanel,
-  _ as SidePanelNavFooter,
-  aa as Skeleton,
-  ea as Spacer,
-  sa as SpacingSize,
-  ta as Spinner,
-  oa as SplitScreenLayout,
-  ra as StatBadge,
-  ia as Statistic,
-  na as StatusBadge,
-  la as Stepper,
-  pa as Surface,
-  da as SurfaceRow,
+  M as FormItem,
+  R as Input,
+  I as KeyValueList,
+  N as Link,
+  V as LoadingBar,
+  j as MalachiteContext,
+  q as MultiSelect,
+  E as NumberTag,
+  G as OverflowRow,
+  H as Padded,
+  J as PaddingSize,
+  K as PageLayout,
+  O as PillButton,
+  W as PreviewTree,
+  Q as PreviewTreeRow,
+  U as Progress,
+  X as Radio,
+  Y as Search,
+  Z as SegmentedControl,
+  $ as SelectableCard,
+  _ as ShadowEscape,
+  aa as SidePanel,
+  ea as SidePanelNavFooter,
+  sa as Skeleton,
+  ta as Spacer,
+  oa as SpacingSize,
+  ra as Spinner,
+  ia as SplitScreenLayout,
+  na as StatBadge,
+  la as Statistic,
+  pa as StatusBadge,
+  da as Stepper,
+  ca as Surface,
+  ma as SurfaceRow,
   Ta as Swatch,
-  ca as Table,
-  ma as Tabs,
-  Sa as Tag,
-  ua as TextArea,
-  ha as ThemeScope,
-  ga as Toggle,
-  Ca as Toolbar,
-  ya as Tooltip,
-  wa as TruncatedTooltip,
-  xa as Typography,
-  Ba as WizardLayout,
-  Fa as applyCustomTheme,
-  Aa as applyDarkTheme,
+  Sa as Table,
+  ua as Tabs,
+  ga as Tag,
+  ha as TextArea,
+  Ca as ThemeScope,
+  ya as Toggle,
+  Ba as Toolbar,
+  wa as Tooltip,
+  xa as TruncatedTooltip,
+  Fa as Typography,
+  Aa as WizardLayout,
+  La as applyCustomTheme,
+  ba as applyDarkTheme,
   fa as applyLightTheme,
   va as applyTheme,
-  La as applyThemeVars,
-  ba as buildActionBarMenuItems,
-  ka as darkTheme,
-  Pa as defaultTheme,
-  za as getCurrentTheme,
-  Da as getCurrentThemeMode,
-  Ma as initializeTheme,
-  Ra as resetTheme,
-  Ia as toggleTheme
+  Pa as applyThemeVars,
+  ka as buildActionBarMenuItems,
+  Da as darkTheme,
+  za as defaultTheme,
+  Ma as getCurrentTheme,
+  Ra as getCurrentThemeMode,
+  Ia as initializeTheme,
+  Na as resetTheme,
+  Va as toggleTheme
 };
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackone/malachite",
-  "version": "0.68.0",
+  "version": "0.69.0",
   "description": "StackOne's themeable React component library — Shadow DOM isolated, scoped Tailwind, theme-token driven.",
   "license": "MIT",
   "author": "StackOne",