@lobehub/ui 5.58.0 → 5.60.0

package/es/dashboard/PanelSurface/type.d.mts

@@ -0,0 +1,18 @@
+import { SurfaceRenderLink } from "../Surface/type.mjs";
+import { CSSProperties, ReactNode } from "react";
+//#region src/dashboard/PanelSurface/type.d.ts
+interface PanelSurfaceProps {
+  children?: ReactNode;
+  className?: string;
+  description?: ReactNode;
+  extra?: ReactNode;
+  href?: string;
+  loading?: boolean;
+  renderLink?: SurfaceRenderLink;
+  size?: 'default' | 'small';
+  style?: CSSProperties;
+  title?: ReactNode;
+}
+//#endregion
+export { PanelSurfaceProps };
+//# sourceMappingURL=type.d.mts.map

package/es/dashboard/Section/Section.d.mts

@@ -0,0 +1,10 @@
+import { SectionProps } from "./type.mjs";
+//#region src/dashboard/Section/Section.d.ts
+/** A titled page section with description, extra and a "more" link, flat or as a card. */
+declare const Section: {
+  ({ className, variant, fontSize, title, more, moreLink, icon, children, desc, extra, gap, padded, renderLink, ...rest }: SectionProps): import("react").JSX.Element;
+  displayName: string;
+};
+//#endregion
+export { Section as default };
+//# sourceMappingURL=Section.d.mts.map

package/es/dashboard/Section/Section.mjs

@@ -0,0 +1,81 @@
+"use client";
+import FlexBasic_default from "../../Flex/FlexBasic.mjs";
+import Icon from "../../Icon/Icon.mjs";
+import { useSurfaceLink } from "../Surface/link.mjs";
+import Surface from "../Surface/Surface.mjs";
+import { styles } from "./style.mjs";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { ChevronRight } from "lucide-react";
+//#region src/dashboard/Section/Section.tsx
+/** A titled page section with description, extra and a "more" link, flat or as a card. */
+const Section = ({ className, variant = "default", fontSize, title, more, moreLink, icon, children, desc, extra, gap, padded, renderLink, ...rest }) => {
+	const link = useSurfaceLink(renderLink);
+	const moreNode = moreLink ? link({
+		children: /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("span", { children: more }), /* @__PURE__ */ jsx(Icon, { icon: ChevronRight })] }),
+		className: styles.more,
+		href: moreLink,
+		rel: moreLink.startsWith("http") ? "noreferrer" : void 0,
+		target: moreLink.startsWith("http") ? "_blank" : void 0
+	}) : null;
+	const actions = extra || moreNode ? /* @__PURE__ */ jsxs(FlexBasic_default, {
+		horizontal: true,
+		align: "center",
+		gap: 8,
+		children: [extra, moreNode]
+	}) : void 0;
+	if (variant === "card") return /* @__PURE__ */ jsx(Surface, {
+		description: desc,
+		extra: actions,
+		padded: padded ?? true,
+		title: title ? /* @__PURE__ */ jsxs("span", {
+			className: styles.title,
+			style: fontSize ? { fontSize } : void 0,
+			children: [icon, title]
+		}) : void 0,
+		children: /* @__PURE__ */ jsx(FlexBasic_default, {
+			className,
+			gap: gap ?? 12,
+			...rest,
+			children
+		})
+	});
+	if (!title) return /* @__PURE__ */ jsx(FlexBasic_default, {
+		className,
+		gap,
+		...rest,
+		children
+	});
+	return /* @__PURE__ */ jsxs(FlexBasic_default, {
+		className,
+		gap: gap ?? 16,
+		width: "100%",
+		...rest,
+		children: [/* @__PURE__ */ jsxs(FlexBasic_default, {
+			horizontal: true,
+			align: "center",
+			gap: 12,
+			justify: "space-between",
+			width: "100%",
+			children: [/* @__PURE__ */ jsxs(FlexBasic_default, {
+				gap: 4,
+				children: [
+					icon,
+					/* @__PURE__ */ jsx("h2", {
+						className: styles.title,
+						style: fontSize ? { fontSize } : void 0,
+						children: title
+					}),
+					desc ? /* @__PURE__ */ jsx("div", {
+						className: styles.desc,
+						children: desc
+					}) : null
+				]
+			}), actions ?? null]
+		}), children]
+	});
+};
+Section.displayName = "Section";
+//#endregion
+export { Section as default };
+
+//# sourceMappingURL=Section.mjs.map

package/es/dashboard/Section/Section.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Section.mjs","names":["Flexbox"],"sources":["../../../src/dashboard/Section/Section.tsx"],"sourcesContent":["'use client';\n\nimport { ChevronRight } from 'lucide-react';\n\nimport { Flexbox } from '@/Flex';\nimport Icon from '@/Icon';\n\nimport { useSurfaceLink } from '../Surface/link';\nimport Surface from '../Surface/Surface';\nimport { styles } from './style';\nimport type { SectionProps } from './type';\n\n/** A titled page section with description, extra and a \"more\" link, flat or as a card. */\nconst Section = ({\n  className,\n  variant = 'default',\n  fontSize,\n  title,\n  more,\n  moreLink,\n  icon,\n  children,\n  desc,\n  extra,\n  gap,\n  padded,\n  renderLink,\n  ...rest\n}: SectionProps) => {\n  const link = useSurfaceLink(renderLink);\n  const moreNode = moreLink\n    ? link({\n        children: (\n          <>\n            <span>{more}</span>\n            <Icon icon={ChevronRight} />\n          </>\n        ),\n        className: styles.more,\n        href: moreLink,\n        rel: moreLink.startsWith('http') ? 'noreferrer' : undefined,\n        target: moreLink.startsWith('http') ? '_blank' : undefined,\n      })\n    : null;\n  const actions =\n    extra || moreNode ? (\n      <Flexbox horizontal align=\"center\" gap={8}>\n        {extra}\n        {moreNode}\n      </Flexbox>\n    ) : undefined;\n\n  if (variant === 'card') {\n    return (\n      <Surface\n        description={desc}\n        extra={actions}\n        padded={padded ?? true}\n        title={\n          title ? (\n            <span className={styles.title} style={fontSize ? { fontSize } : undefined}>\n              {icon}\n              {title}\n            </span>\n          ) : undefined\n        }\n      >\n        <Flexbox className={className} gap={gap ?? 12} {...rest}>\n          {children}\n        </Flexbox>\n      </Surface>\n    );\n  }\n\n  if (!title) {\n    return (\n      <Flexbox className={className} gap={gap} {...rest}>\n        {children}\n      </Flexbox>\n    );\n  }\n\n  return (\n    <Flexbox className={className} gap={gap ?? 16} width=\"100%\" {...rest}>\n      <Flexbox horizontal align=\"center\" gap={12} justify=\"space-between\" width=\"100%\">\n        <Flexbox gap={4}>\n          {icon}\n          <h2 className={styles.title} style={fontSize ? { fontSize } : undefined}>\n            {title}\n          </h2>\n          {desc ? <div className={styles.desc}>{desc}</div> : null}\n        </Flexbox>\n        {actions ?? null}\n      </Flexbox>\n      {children}\n    </Flexbox>\n  );\n};\n\nSection.displayName = 'Section';\n\nexport default Section;\n"],"mappings":";;;;;;;;;;AAaA,MAAM,WAAW,EACf,WACA,UAAU,WACV,UACA,OACA,MACA,UACA,MACA,UACA,MACA,OACA,KACA,QACA,YACA,GAAG,WACe;CAClB,MAAM,OAAO,eAAe,UAAU;CACtC,MAAM,WAAW,WACb,KAAK;EACH,UACE,qBAAA,UAAA,EAAA,UAAA,CACE,oBAAC,QAAD,EAAA,UAAO,KAAW,CAAA,GAClB,oBAAC,MAAD,EAAM,MAAM,aAAe,CAAA,CAC3B,EAAA,CAAA;EAEJ,WAAW,OAAO;EAClB,MAAM;EACN,KAAK,SAAS,WAAW,MAAM,IAAI,eAAe,KAAA;EAClD,QAAQ,SAAS,WAAW,MAAM,IAAI,WAAW,KAAA;CACnD,CAAC,IACD;CACJ,MAAM,UACJ,SAAS,WACP,qBAACA,mBAAD;EAAS,YAAA;EAAW,OAAM;EAAS,KAAK;EAAxC,UAAA,CACG,OACA,QACM;CACP,CAAA,IAAA,KAAA;CAEN,IAAI,YAAY,QACd,OACE,oBAAC,SAAD;EACE,aAAa;EACb,OAAO;EACP,QAAQ,UAAU;EAClB,OACE,QACE,qBAAC,QAAD;GAAM,WAAW,OAAO;GAAO,OAAO,WAAW,EAAE,SAAS,IAAI,KAAA;GAAhE,UAAA,CACG,MACA,KACG;EACJ,CAAA,IAAA,KAAA;EAGN,UAAA,oBAACA,mBAAD;GAAoB;GAAW,KAAK,OAAO;GAAI,GAAI;GAChD;EACM,CAAA;CACF,CAAA;CAIb,IAAI,CAAC,OACH,OACE,oBAACA,mBAAD;EAAoB;EAAgB;EAAK,GAAI;EAC1C;CACM,CAAA;CAIb,OACE,qBAACA,mBAAD;EAAoB;EAAW,KAAK,OAAO;EAAI,OAAM;EAAO,GAAI;EAAhE,UAAA,CACE,qBAACA,mBAAD;GAAS,YAAA;GAAW,OAAM;GAAS,KAAK;GAAI,SAAQ;GAAgB,OAAM;GAA1E,UAAA,CACE,qBAACA,mBAAD;IAAS,KAAK;IAAd,UAAA;KACG;KACD,oBAAC,MAAD;MAAI,WAAW,OAAO;MAAO,OAAO,WAAW,EAAE,SAAS,IAAI,KAAA;MAC3D,UAAA;KACC,CAAA;KACH,OAAO,oBAAC,OAAD;MAAK,WAAW,OAAO;MAAO,UAAA;KAAU,CAAA,IAAI;IAC7C;GACR,CAAA,GAAA,WAAW,IACL;EACR,CAAA,GAAA,QACM;;AAEb;AAEA,QAAQ,cAAc"}

package/es/dashboard/Section/index.d.mts

@@ -0,0 +1,3 @@
+import { SectionProps } from "./type.mjs";
+import Section from "./Section.mjs";
+export { type SectionProps, Section as default };

package/es/dashboard/Section/style.mjs

@@ -0,0 +1,35 @@
+import { createStaticStyles } from "antd-style";
+//#region src/dashboard/Section/style.ts
+const styles = createStaticStyles(({ css, cssVar }) => ({
+	desc: css`
+    font-size: 13px;
+    font-weight: 400;
+    line-height: 1.45;
+    color: ${cssVar.colorTextSecondary};
+  `,
+	more: css`
+    display: inline-flex;
+    gap: 2px;
+    align-items: center;
+
+    font-size: 13px;
+    color: ${cssVar.colorTextSecondary};
+    text-decoration: none;
+
+    &:hover {
+      color: ${cssVar.colorText};
+    }
+  `,
+	title: css`
+    margin: 0;
+
+    font-size: 15px;
+    font-weight: 600;
+    line-height: 1.4;
+    color: ${cssVar.colorText};
+  `
+}));
+//#endregion
+export { styles };
+
+//# sourceMappingURL=style.mjs.map

package/es/dashboard/Section/style.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.mjs","names":[],"sources":["../../../src/dashboard/Section/style.ts"],"sourcesContent":["import { createStaticStyles } from 'antd-style';\n\nexport const styles = createStaticStyles(({ css, cssVar }) => ({\n  desc: css`\n    font-size: 13px;\n    font-weight: 400;\n    line-height: 1.45;\n    color: ${cssVar.colorTextSecondary};\n  `,\n  more: css`\n    display: inline-flex;\n    gap: 2px;\n    align-items: center;\n\n    font-size: 13px;\n    color: ${cssVar.colorTextSecondary};\n    text-decoration: none;\n\n    &:hover {\n      color: ${cssVar.colorText};\n    }\n  `,\n  title: css`\n    margin: 0;\n\n    font-size: 15px;\n    font-weight: 600;\n    line-height: 1.4;\n    color: ${cssVar.colorText};\n  `,\n}));\n"],"mappings":";;AAEA,MAAa,SAAS,oBAAoB,EAAE,KAAK,cAAc;CAC7D,MAAM,GAAG;;;;aAIE,OAAO,mBAAmB;;CAErC,MAAM,GAAG;;;;;;aAME,OAAO,mBAAmB;;;;eAIxB,OAAO,UAAU;;;CAG9B,OAAO,GAAG;;;;;;aAMC,OAAO,UAAU;;AAE9B,EAAE"}

package/es/dashboard/Section/type.d.mts

@@ -0,0 +1,24 @@
+import { FlexboxProps } from "../../Flex/type.mjs";
+import "../../Flex/index.mjs";
+import { SurfaceRenderLink } from "../Surface/type.mjs";
+import { ReactNode } from "react";
+//#region src/dashboard/Section/type.d.ts
+interface SectionProps extends Omit<FlexboxProps, 'title'> {
+  desc?: ReactNode;
+  extra?: ReactNode;
+  fontSize?: number;
+  icon?: ReactNode;
+  /** Text of the "more" link. */
+  more?: ReactNode;
+  /** Target of the "more" link. An `http` URL opens in a new tab. */
+  moreLink?: string;
+  /** Card body padding (`variant="card"`). Turn off when the children already sit on the card edge. */
+  padded?: boolean;
+  renderLink?: SurfaceRenderLink;
+  title?: ReactNode;
+  /** `default` is a titled page section; `card` wraps it in a Surface. */
+  variant?: 'default' | 'card';
+}
+//#endregion
+export { SectionProps };
+//# sourceMappingURL=type.d.mts.map

package/es/dashboard/StatCard/StatCard.d.mts

@@ -1,6 +1,7 @@
 import { StatCardProps } from "./type.mjs";
 //#region src/dashboard/StatCard/StatCard.d.ts
-declare function StatCard({ action, delta, direction, hint, label, mark, prominent, value, wash }: StatCardProps): import("react").JSX.Element;
+/** One metric in its own card: the same item as a `split` MetricStrip. */
+declare function StatCard({ action, className, delta, direction, hint, href, label, loading, mark, onClick, renderLink, value, valueTone }: StatCardProps): import("react").JSX.Element;
 declare namespace StatCard {
   var displayName: string;
 }

package/es/dashboard/StatCard/StatCard.mjs

@@ -1,79 +1,31 @@
 "use client";
-import FlexBasic_default from "../../Flex/FlexBasic.mjs";
-import Block from "../../Block/Block.mjs";
-import Icon from "../../Icon/Icon.mjs";
-import Text from "../../base-ui/Text/Text.mjs";
 import { styles } from "../Surface/style.mjs";
-import { styles as styles$1 } from "./style.mjs";
-import { jsx, jsxs } from "react/jsx-runtime";
-import { Minus, TrendingDown, TrendingUp } from "lucide-react";
+import { useSurfaceCardClassName } from "../Surface/link.mjs";
+import { styles as styles$1 } from "../MetricStrip/style.mjs";
+import MetricCell from "../MetricStrip/MetricCell.mjs";
+import { jsx } from "react/jsx-runtime";
+import { cx } from "antd-style";
 //#region src/dashboard/StatCard/StatCard.tsx
-const deltaIcon = {
-	down: TrendingDown,
-	flat: Minus,
-	up: TrendingUp
-};
-function StatCard({ action, delta, direction = "flat", hint, label, mark, prominent = false, value, wash }) {
-	const deltaClass = {
-		down: styles$1.deltaDown,
-		flat: styles$1.deltaFlat,
-		up: styles$1.deltaUp
-	}[direction];
+/** One metric in its own card: the same item as a `split` MetricStrip. */
+function StatCard({ action, className, delta, direction = "flat", hint, href, label, loading, mark, onClick, renderLink, value, valueTone }) {
+	const cardClassName = useSurfaceCardClassName();
 	return /* @__PURE__ */ jsx("div", {
-		className: styles$1.lift,
-		children: /* @__PURE__ */ jsx(Block, {
-			className: `${styles$1.root} ${styles.card}${wash ? ` ${styles$1.wash} ${styles$1[wash]}` : ""} ${styles$1.frame}`,
-			variant: "borderless",
-			children: /* @__PURE__ */ jsxs(FlexBasic_default, {
-				className: styles$1.body,
-				gap: prominent ? 0 : 8,
-				children: [
-					/* @__PURE__ */ jsxs(FlexBasic_default, {
-						horizontal: true,
-						align: "center",
-						justify: "space-between",
-						children: [/* @__PURE__ */ jsxs(FlexBasic_default, {
-							horizontal: true,
-							align: "center",
-							className: styles$1.copy,
-							gap: 6,
-							children: [/* @__PURE__ */ jsx(Text, {
-								ellipsis: true,
-								className: prominent ? styles$1.metricLabel : styles$1.label,
-								children: label
-							}), action]
-						}), mark ? /* @__PURE__ */ jsx("span", {
-							"aria-hidden": true,
-							className: styles$1.badge,
-							children: /* @__PURE__ */ jsx(Icon, {
-								icon: mark,
-								size: 14
-							})
-						}) : null]
-					}),
-					/* @__PURE__ */ jsx("div", {
-						className: prominent ? styles$1.metricValue : styles$1.value,
-						children: value
-					}),
-					delta || hint ? /* @__PURE__ */ jsxs(FlexBasic_default, {
-						horizontal: true,
-						align: "center",
-						className: prominent ? styles$1.metricFoot : void 0,
-						gap: 8,
-						wrap: "wrap",
-						children: [delta ? /* @__PURE__ */ jsxs("span", {
-							className: `${styles$1.delta} ${deltaClass}`,
-							children: [/* @__PURE__ */ jsx(Icon, {
-								icon: deltaIcon[direction],
-								size: 14
-							}), delta]
-						}) : null, hint ? /* @__PURE__ */ jsx(Text, {
-							className: prominent ? styles$1.metricHint : styles$1.hint,
-							children: hint
-						}) : null]
-					}) : null
-				]
-			})
+		className: cx(styles$1.card, cardClassName, styles.clip, className),
+		children: /* @__PURE__ */ jsx(MetricCell, {
+			renderLink,
+			item: {
+				action,
+				delta,
+				direction,
+				hint,
+				href,
+				label,
+				loading,
+				mark,
+				onClick,
+				value,
+				valueTone
+			}
 		})
 	});
 }

package/es/dashboard/StatCard/StatCard.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"StatCard.mjs","names":["styles","surfaceStyles","Flexbox"],"sources":["../../../src/dashboard/StatCard/StatCard.tsx"],"sourcesContent":["'use client';\n\nimport { Minus, TrendingDown, TrendingUp } from 'lucide-react';\n\nimport Text from '@/base-ui/Text';\nimport Block from '@/Block';\nimport { Flexbox } from '@/Flex';\nimport Icon from '@/Icon';\n\nimport { styles as surfaceStyles } from '../Surface/style';\nimport { styles } from './style';\nimport type { StatCardProps, StatDirection } from './type';\n\nconst deltaIcon = {\n  down: TrendingDown,\n  flat: Minus,\n  up: TrendingUp,\n} satisfies Record<StatDirection, typeof Minus>;\n\nfunction StatCard({\n  action,\n  delta,\n  direction = 'flat',\n  hint,\n  label,\n  mark,\n  prominent = false,\n  value,\n  wash,\n}: StatCardProps) {\n  const deltaClass = {\n    down: styles.deltaDown,\n    flat: styles.deltaFlat,\n    up: styles.deltaUp,\n  }[direction];\n\n  return (\n    <div className={styles.lift}>\n      <Block\n        className={`${styles.root} ${surfaceStyles.card}${wash ? ` ${styles.wash} ${styles[wash]}` : ''} ${styles.frame}`}\n        variant=\"borderless\"\n      >\n        <Flexbox className={styles.body} gap={prominent ? 0 : 8}>\n          <Flexbox horizontal align=\"center\" justify=\"space-between\">\n            <Flexbox horizontal align=\"center\" className={styles.copy} gap={6}>\n              <Text ellipsis className={prominent ? styles.metricLabel : styles.label}>\n                {label}\n              </Text>\n              {action}\n            </Flexbox>\n            {mark ? (\n              <span aria-hidden className={styles.badge}>\n                <Icon icon={mark} size={14} />\n              </span>\n            ) : null}\n          </Flexbox>\n          <div className={prominent ? styles.metricValue : styles.value}>{value}</div>\n          {delta || hint ? (\n            <Flexbox\n              horizontal\n              align=\"center\"\n              className={prominent ? styles.metricFoot : undefined}\n              gap={8}\n              wrap=\"wrap\"\n            >\n              {delta ? (\n                <span className={`${styles.delta} ${deltaClass}`}>\n                  <Icon icon={deltaIcon[direction]} size={14} />\n                  {delta}\n                </span>\n              ) : null}\n              {hint ? (\n                <Text className={prominent ? styles.metricHint : styles.hint}>{hint}</Text>\n              ) : null}\n            </Flexbox>\n          ) : null}\n        </Flexbox>\n      </Block>\n    </div>\n  );\n}\n\nStatCard.displayName = 'StatCard';\n\nexport default StatCard;\n"],"mappings":";;;;;;;;;;AAaA,MAAM,YAAY;CAChB,MAAM;CACN,MAAM;CACN,IAAI;AACN;AAEA,SAAS,SAAS,EAChB,QACA,OACA,YAAY,QACZ,MACA,OACA,MACA,YAAY,OACZ,OACA,QACgB;CAChB,MAAM,aAAa;EACjB,MAAMA,SAAO;EACb,MAAMA,SAAO;EACb,IAAIA,SAAO;CACb,EAAE;CAEF,OACE,oBAAC,OAAD;EAAK,WAAWA,SAAO;EACrB,UAAA,oBAAC,OAAD;GACE,WAAW,GAAGA,SAAO,KAAK,GAAGC,OAAc,OAAO,OAAO,IAAID,SAAO,KAAK,GAAGA,SAAO,UAAU,GAAG,GAAGA,SAAO;GAC1G,SAAQ;GAER,UAAA,qBAACE,mBAAD;IAAS,WAAWF,SAAO;IAAM,KAAK,YAAY,IAAI;IAAtD,UAAA;KACE,qBAACE,mBAAD;MAAS,YAAA;MAAW,OAAM;MAAS,SAAQ;MAA3C,UAAA,CACE,qBAACA,mBAAD;OAAS,YAAA;OAAW,OAAM;OAAS,WAAWF,SAAO;OAAM,KAAK;OAAhE,UAAA,CACE,oBAAC,MAAD;QAAM,UAAA;QAAS,WAAW,YAAYA,SAAO,cAAcA,SAAO;QAC/D,UAAA;OACG,CAAA,GACL,MACM;MACR,CAAA,GAAA,OACC,oBAAC,QAAD;OAAM,eAAA;OAAY,WAAWA,SAAO;OAClC,UAAA,oBAAC,MAAD;QAAM,MAAM;QAAM,MAAM;OAAK,CAAA;MACzB,CAAA,IACJ,IACG;;KACT,oBAAC,OAAD;MAAK,WAAW,YAAYA,SAAO,cAAcA,SAAO;MAAQ,UAAA;KAAW,CAAA;KAC1E,SAAS,OACR,qBAACE,mBAAD;MACE,YAAA;MACA,OAAM;MACN,WAAW,YAAYF,SAAO,aAAa,KAAA;MAC3C,KAAK;MACL,MAAK;MALP,UAAA,CAOG,QACC,qBAAC,QAAD;OAAM,WAAW,GAAGA,SAAO,MAAM,GAAG;OAApC,UAAA,CACE,oBAAC,MAAD;QAAM,MAAM,UAAU;QAAY,MAAM;OAAK,CAAA,GAC5C,KACG;MACJ,CAAA,IAAA,MACH,OACC,oBAAC,MAAD;OAAM,WAAW,YAAYA,SAAO,aAAaA,SAAO;OAAO,UAAA;MAAW,CAAA,IACxE,IACG;KACP,CAAA,IAAA;IACG;;EACJ,CAAA;CACJ,CAAA;AAET;AAEA,SAAS,cAAc"}
+{"version":3,"file":"StatCard.mjs","names":["metricStyles","surfaceStyles"],"sources":["../../../src/dashboard/StatCard/StatCard.tsx"],"sourcesContent":["'use client';\n\nimport { cx } from 'antd-style';\n\nimport MetricCell from '../MetricStrip/MetricCell';\nimport { styles as metricStyles } from '../MetricStrip/style';\nimport { useSurfaceCardClassName } from '../Surface/link';\nimport { styles as surfaceStyles } from '../Surface/style';\nimport type { StatCardProps } from './type';\n\n/** One metric in its own card: the same item as a `split` MetricStrip. */\nfunction StatCard({\n  action,\n  className,\n  delta,\n  direction = 'flat',\n  hint,\n  href,\n  label,\n  loading,\n  mark,\n  onClick,\n  renderLink,\n  value,\n  valueTone,\n}: StatCardProps) {\n  const cardClassName = useSurfaceCardClassName();\n\n  return (\n    <div className={cx(metricStyles.card, cardClassName, surfaceStyles.clip, className)}>\n      <MetricCell\n        renderLink={renderLink}\n        item={{\n          action,\n          delta,\n          direction,\n          hint,\n          href,\n          label,\n          loading,\n          mark,\n          onClick,\n          value,\n          valueTone,\n        }}\n      />\n    </div>\n  );\n}\n\nStatCard.displayName = 'StatCard';\n\nexport default StatCard;\n"],"mappings":";;;;;;;;;AAWA,SAAS,SAAS,EAChB,QACA,WACA,OACA,YAAY,QACZ,MACA,MACA,OACA,SACA,MACA,SACA,YACA,OACA,aACgB;CAChB,MAAM,gBAAgB,wBAAwB;CAE9C,OACE,oBAAC,OAAD;EAAK,WAAW,GAAGA,SAAa,MAAM,eAAeC,OAAc,MAAM,SAAS;EAChF,UAAA,oBAAC,YAAD;GACc;GACZ,MAAM;IACJ;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;GACF;EACD,CAAA;CACE,CAAA;AAET;AAEA,SAAS,cAAc"}

package/es/dashboard/StatCard/type.d.mts

@@ -1,24 +1,35 @@
 import { IconProps } from "../../Icon/type.mjs";
 import "../../Icon/index.mjs";
+import { SurfaceRenderLink } from "../Surface/type.mjs";
 import { ReactNode } from "react";
 //#region src/dashboard/StatCard/type.d.ts
 type StatDirection = 'up' | 'down' | 'flat';
-/** Top-to-bottom gray wash. Decorative color fields stay in the app. */
+/** @deprecated StatCard renders as a MetricStrip item and no longer draws a wash. */
 type StatWash = 'gray';
 interface StatCardProps {
   /** Control rendered on the label row, such as a menu. */
   action?: ReactNode;
+  className?: string;
   /** Change amount, colored by `direction`. */
-  delta?: string;
+  delta?: ReactNode;
   direction?: StatDirection;
-  /** Line under the figure. */
-  hint?: string;
+  /** Line after the delta. */
+  hint?: ReactNode;
+  /** Makes the card a link (through `renderLink` / `SurfaceLinkProvider`). */
+  href?: string;
   label: ReactNode;
+  /** Value placeholder while loading; the label stays. */
+  loading?: boolean;
   /** Corner glyph. Hidden from assistive tech so it does not repeat the label. */
   mark?: IconProps['icon'];
-  /** Overview scale: label, then a large figure, then the note. */
+  onClick?: () => void;
+  /** @deprecated Ignored. StatCard always uses the MetricStrip item scale. */
   prominent?: boolean;
+  renderLink?: SurfaceRenderLink;
   value: ReactNode;
+  /** Color the figure when the number itself is the thing to act on. */
+  valueTone?: 'danger' | 'warning';
+  /** @deprecated Ignored. StatCard renders as a MetricStrip item without a wash. */
   wash?: StatWash;
 }
 //#endregion

package/es/dashboard/Surface/Surface.d.mts

@@ -1,10 +1,11 @@
 import { SurfaceProps } from "./type.mjs";
 //#region src/dashboard/Surface/Surface.d.ts
 /**
- * Elevated card on a workspace canvas. Use it for panels that should read
- * above the page background without inventing a new surface color.
+ * Elevated card on a workspace canvas. Bare, it is a plain frame. With `title`,
+ * `description` or `extra` it gets a header and a padded body that lets a
+ * trailing table meet the card edges.
  */
-declare function Surface({ className, ...rest }: SurfaceProps): import("react").JSX.Element;
+declare function Surface({ bleed, chart, children, className, description, extra, href, loading, padded, renderLink, title, ...rest }: SurfaceProps): import("react").JSX.Element;
 declare namespace Surface {
   var displayName: string;
 }

package/es/dashboard/Surface/Surface.mjs

@@ -1,16 +1,92 @@
 "use client";
+import Spin from "../../base-ui/Spin/Spin.mjs";
+import Skeleton from "../../base-ui/Skeleton/index.mjs";
 import { styles } from "./style.mjs";
-import { jsx } from "react/jsx-runtime";
+import { SurfaceDepthContext, useSurfaceCardClassName, useSurfaceDepth, useSurfaceLink } from "./link.mjs";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { cx } from "antd-style";
+import { ArrowUpRight } from "lucide-react";
 //#region src/dashboard/Surface/Surface.tsx
+const defined = (node) => node !== null && node !== void 0 && node !== false;
 /**
-* Elevated card on a workspace canvas. Use it for panels that should read
-* above the page background without inventing a new surface color.
+* Elevated card on a workspace canvas. Bare, it is a plain frame. With `title`,
+* `description` or `extra` it gets a header and a padded body that lets a
+* trailing table meet the card edges.
 */
-function Surface({ className, ...rest }) {
-	return /* @__PURE__ */ jsx("div", {
-		className: cx(styles.card, className),
-		...rest
+function Surface({ bleed = false, chart, children, className, description, extra, href, loading, padded, renderLink, title, ...rest }) {
+	const depth = useSurfaceDepth();
+	const link = useSurfaceLink(renderLink);
+	const cardClassName = useSurfaceCardClassName();
+	const refreshing = Boolean(loading) && defined(children);
+	const placeholder = Boolean(loading) && !defined(children);
+	const hasHeader = defined(title) || defined(description) || defined(extra) || refreshing;
+	const pad = bleed ? false : padded ?? (hasHeader || placeholder);
+	const clip = hasHeader || bleed || pad || defined(chart);
+	const heading = /* @__PURE__ */ jsxs("div", {
+		className: styles.heading,
+		children: [defined(title) ? /* @__PURE__ */ jsx("div", {
+			className: styles.title,
+			children: title
+		}) : null, defined(description) ? /* @__PURE__ */ jsx("div", {
+			className: styles.desc,
+			children: description
+		}) : null]
+	});
+	const body = placeholder ? /* @__PURE__ */ jsx("div", {
+		"aria-busy": "true",
+		className: styles.loading,
+		children: /* @__PURE__ */ jsx(Skeleton, {
+			height: 220,
+			radius: 8
+		})
+	}) : children;
+	const trailing = refreshing || defined(extra);
+	const arrow = /* @__PURE__ */ jsx(ArrowUpRight, {
+		"aria-hidden": true,
+		"data-surface-arrow": true,
+		className: styles.arrow,
+		size: 16
+	});
+	return /* @__PURE__ */ jsx(SurfaceDepthContext, {
+		value: depth + 1,
+		children: /* @__PURE__ */ jsxs("div", {
+			className: cx(cardClassName, styles.content, clip && styles.clip, href && styles.cardLinked, bleed && styles.bleed, className),
+			...rest,
+			children: [
+				hasHeader ? /* @__PURE__ */ jsxs("div", {
+					className: styles.header,
+					children: [href ? link({
+						children: /* @__PURE__ */ jsxs(Fragment, { children: [heading, trailing ? null : arrow] }),
+						className: styles.headingLink,
+						href
+					}) : heading, trailing ? /* @__PURE__ */ jsxs("div", {
+						className: styles.extra,
+						children: [
+							refreshing ? /* @__PURE__ */ jsx(Spin, {
+								size: "small",
+								variant: "network"
+							}) : null,
+							extra,
+							href ? link({
+								"aria-hidden": true,
+								"children": arrow,
+								"className": styles.arrowLink,
+								href,
+								"tabIndex": -1
+							}) : null
+						]
+					}) : null]
+				}) : null,
+				pad ? /* @__PURE__ */ jsx("div", {
+					className: cx(styles.body, styles.tableBleed),
+					children: body
+				}) : body,
+				defined(chart) ? /* @__PURE__ */ jsx("div", {
+					className: styles.chart,
+					children: chart
+				}) : null
+			]
+		})
 	});
 }
 Surface.displayName = "Surface";

package/es/dashboard/Surface/Surface.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Surface.mjs","names":[],"sources":["../../../src/dashboard/Surface/Surface.tsx"],"sourcesContent":["'use client';\n\nimport { cx } from 'antd-style';\n\nimport { styles } from './style';\nimport type { SurfaceProps } from './type';\n\n/**\n * Elevated card on a workspace canvas. Use it for panels that should read\n * above the page background without inventing a new surface color.\n */\nfunction Surface({ className, ...rest }: SurfaceProps) {\n  return <div className={cx(styles.card, className)} {...rest} />;\n}\n\nSurface.displayName = 'Surface';\n\nexport default Surface;\n"],"mappings":";;;;;;;;;AAWA,SAAS,QAAQ,EAAE,WAAW,GAAG,QAAsB;CACrD,OAAO,oBAAC,OAAD;EAAK,WAAW,GAAG,OAAO,MAAM,SAAS;EAAG,GAAI;CAAO,CAAA;AAChE;AAEA,QAAQ,cAAc"}
+{"version":3,"file":"Surface.mjs","names":[],"sources":["../../../src/dashboard/Surface/Surface.tsx"],"sourcesContent":["'use client';\n\nimport { cx } from 'antd-style';\nimport { ArrowUpRight } from 'lucide-react';\nimport type { ReactNode } from 'react';\n\nimport Skeleton from '@/base-ui/Skeleton';\nimport Spin from '@/base-ui/Spin';\n\nimport {\n  SurfaceDepthContext,\n  useSurfaceCardClassName,\n  useSurfaceDepth,\n  useSurfaceLink,\n} from './link';\nimport { styles } from './style';\nimport type { SurfaceProps } from './type';\n\nconst defined = (node: ReactNode) => node !== null && node !== undefined && node !== false;\n\n/**\n * Elevated card on a workspace canvas. Bare, it is a plain frame. With `title`,\n * `description` or `extra` it gets a header and a padded body that lets a\n * trailing table meet the card edges.\n */\nfunction Surface({\n  bleed = false,\n  chart,\n  children,\n  className,\n  description,\n  extra,\n  href,\n  loading,\n  padded,\n  renderLink,\n  title,\n  ...rest\n}: SurfaceProps) {\n  const depth = useSurfaceDepth();\n  const link = useSurfaceLink(renderLink);\n  const cardClassName = useSurfaceCardClassName();\n  const refreshing = Boolean(loading) && defined(children);\n  const placeholder = Boolean(loading) && !defined(children);\n  const hasHeader = defined(title) || defined(description) || defined(extra) || refreshing;\n  const pad = bleed ? false : (padded ?? (hasHeader || placeholder));\n  const clip = hasHeader || bleed || pad || defined(chart);\n\n  const heading = (\n    <div className={styles.heading}>\n      {defined(title) ? <div className={styles.title}>{title}</div> : null}\n      {defined(description) ? <div className={styles.desc}>{description}</div> : null}\n    </div>\n  );\n\n  const body = placeholder ? (\n    <div aria-busy=\"true\" className={styles.loading}>\n      <Skeleton height={220} radius={8} />\n    </div>\n  ) : (\n    children\n  );\n\n  // With header actions, the arrow sits after them as the rightmost item.\n  const trailing = refreshing || defined(extra);\n  const arrow = <ArrowUpRight aria-hidden data-surface-arrow className={styles.arrow} size={16} />;\n\n  return (\n    <SurfaceDepthContext value={depth + 1}>\n      <div\n        className={cx(\n          cardClassName,\n          styles.content,\n          clip && styles.clip,\n          href && styles.cardLinked,\n          bleed && styles.bleed,\n          className,\n        )}\n        {...rest}\n      >\n        {hasHeader ? (\n          <div className={styles.header}>\n            {href\n              ? link({\n                  children: (\n                    <>\n                      {heading}\n                      {trailing ? null : arrow}\n                    </>\n                  ),\n                  className: styles.headingLink,\n                  href,\n                })\n              : heading}\n            {trailing ? (\n              <div className={styles.extra}>\n                {refreshing ? <Spin size=\"small\" variant=\"network\" /> : null}\n                {extra}\n                {href\n                  ? link({\n                      'aria-hidden': true,\n                      'children': arrow,\n                      'className': styles.arrowLink,\n                      href,\n                      'tabIndex': -1,\n                    } as any)\n                  : null}\n              </div>\n            ) : null}\n          </div>\n        ) : null}\n        {pad ? <div className={cx(styles.body, styles.tableBleed)}>{body}</div> : body}\n        {defined(chart) ? <div className={styles.chart}>{chart}</div> : null}\n      </div>\n    </SurfaceDepthContext>\n  );\n}\n\nSurface.displayName = 'Surface';\n\nexport default Surface;\n"],"mappings":";;;;;;;;;AAkBA,MAAM,WAAW,SAAoB,SAAS,QAAQ,SAAS,KAAA,KAAa,SAAS;;;;;;AAOrF,SAAS,QAAQ,EACf,QAAQ,OACR,OACA,UACA,WACA,aACA,OACA,MACA,SACA,QACA,YACA,OACA,GAAG,QACY;CACf,MAAM,QAAQ,gBAAgB;CAC9B,MAAM,OAAO,eAAe,UAAU;CACtC,MAAM,gBAAgB,wBAAwB;CAC9C,MAAM,aAAa,QAAQ,OAAO,KAAK,QAAQ,QAAQ;CACvD,MAAM,cAAc,QAAQ,OAAO,KAAK,CAAC,QAAQ,QAAQ;CACzD,MAAM,YAAY,QAAQ,KAAK,KAAK,QAAQ,WAAW,KAAK,QAAQ,KAAK,KAAK;CAC9E,MAAM,MAAM,QAAQ,QAAS,WAAW,aAAa;CACrD,MAAM,OAAO,aAAa,SAAS,OAAO,QAAQ,KAAK;CAEvD,MAAM,UACJ,qBAAC,OAAD;EAAK,WAAW,OAAO;EAAvB,UAAA,CACG,QAAQ,KAAK,IAAI,oBAAC,OAAD;GAAK,WAAW,OAAO;GAAQ,UAAA;EAAW,CAAA,IAAI,MAC/D,QAAQ,WAAW,IAAI,oBAAC,OAAD;GAAK,WAAW,OAAO;GAAO,UAAA;EAAiB,CAAA,IAAI,IACxE;;CAGP,MAAM,OAAO,cACX,oBAAC,OAAD;EAAK,aAAU;EAAO,WAAW,OAAO;EACtC,UAAA,oBAAC,UAAD;GAAU,QAAQ;GAAK,QAAQ;EAAI,CAAA;CAChC,CAAA,IAEL;CAIF,MAAM,WAAW,cAAc,QAAQ,KAAK;CAC5C,MAAM,QAAQ,oBAAC,cAAD;EAAc,eAAA;EAAY,sBAAA;EAAmB,WAAW,OAAO;EAAO,MAAM;CAAK,CAAA;CAE/F,OACE,oBAAC,qBAAD;EAAqB,OAAO,QAAQ;EAClC,UAAA,qBAAC,OAAD;GACE,WAAW,GACT,eACA,OAAO,SACP,QAAQ,OAAO,MACf,QAAQ,OAAO,YACf,SAAS,OAAO,OAChB,SACF;GACA,GAAI;GATN,UAAA;IAWG,YACC,qBAAC,OAAD;KAAK,WAAW,OAAO;KAAvB,UAAA,CACG,OACG,KAAK;MACH,UACE,qBAAA,UAAA,EAAA,UAAA,CACG,SACA,WAAW,OAAO,KACnB,EAAA,CAAA;MAEJ,WAAW,OAAO;MAClB;KACF,CAAC,IACD,SACH,WACC,qBAAC,OAAD;MAAK,WAAW,OAAO;MAAvB,UAAA;OACG,aAAa,oBAAC,MAAD;QAAM,MAAK;QAAQ,SAAQ;OAAW,CAAA,IAAI;OACvD;OACA,OACG,KAAK;QACH,eAAe;QACf,YAAY;QACZ,aAAa,OAAO;QACpB;QACA,YAAY;OACd,CAAQ,IACR;MACD;KACH,CAAA,IAAA,IACD;IACH,CAAA,IAAA;IACH,MAAM,oBAAC,OAAD;KAAK,WAAW,GAAG,OAAO,MAAM,OAAO,UAAU;KAAI,UAAA;IAAU,CAAA,IAAI;IACzE,QAAQ,KAAK,IAAI,oBAAC,OAAD;KAAK,WAAW,OAAO;KAAQ,UAAA;IAAW,CAAA,IAAI;GAC7D;;CACc,CAAA;AAEzB;AAEA,QAAQ,cAAc"}

package/es/dashboard/Surface/index.d.mts

@@ -1,4 +1,5 @@
+import { SurfaceLinkProps, SurfaceProps, SurfaceRenderLink } from "./type.mjs";
+import { SurfaceLinkProvider, useSurfaceCardClassName, useSurfaceDepth, useSurfaceLink } from "./link.mjs";
 import { styles } from "./style.mjs";
-import { SurfaceProps } from "./type.mjs";
 import Surface from "./Surface.mjs";
-export { type SurfaceProps, Surface as default, styles as surfaceStyles };
+export { type SurfaceLinkProps, SurfaceLinkProvider, type SurfaceProps, type SurfaceRenderLink, Surface as default, styles as surfaceStyles, useSurfaceCardClassName, useSurfaceDepth, useSurfaceLink };

package/es/dashboard/Surface/link.d.mts

@@ -0,0 +1,19 @@
+import { SurfaceRenderLink } from "./type.mjs";
+import { ReactNode } from "react";
+//#region src/dashboard/Surface/link.d.ts
+/** Plugs the app router into every dashboard card link (Surface, MetricStrip, Section). */
+declare const SurfaceLinkProvider: ({ children, renderLink }: {
+  children?: ReactNode;
+  renderLink: SurfaceRenderLink;
+}) => import("react").JSX.Element;
+declare const useSurfaceLink: (override?: SurfaceRenderLink) => SurfaceRenderLink;
+/** How many Surface cards wrap this node. A table can skip its own card when already inside one. */
+declare const useSurfaceDepth: () => number;
+/**
+ * Class for a dashboard card: `colorBgContainer` in light, translucent `colorFillTertiary` in
+ * dark, and no fill of its own when nested in another Surface.
+ */
+declare const useSurfaceCardClassName: () => string;
+//#endregion
+export { SurfaceLinkProvider, useSurfaceCardClassName, useSurfaceDepth, useSurfaceLink };
+//# sourceMappingURL=link.d.mts.map

package/es/dashboard/Surface/link.mjs

@@ -0,0 +1,33 @@
+"use client";
+import { styles } from "./style.mjs";
+import { createContext, use } from "react";
+import { jsx } from "react/jsx-runtime";
+import { cx, useThemeMode } from "antd-style";
+//#region src/dashboard/Surface/link.tsx
+const defaultRenderLink = ({ children, ...rest }) => /* @__PURE__ */ jsx("a", {
+	...rest,
+	children
+});
+const SurfaceLinkContext = createContext(defaultRenderLink);
+const SurfaceDepthContext = createContext(0);
+/** Plugs the app router into every dashboard card link (Surface, MetricStrip, Section). */
+const SurfaceLinkProvider = ({ children, renderLink }) => /* @__PURE__ */ jsx(SurfaceLinkContext, {
+	value: renderLink,
+	children
+});
+const useSurfaceLink = (override) => override ?? use(SurfaceLinkContext);
+/** How many Surface cards wrap this node. A table can skip its own card when already inside one. */
+const useSurfaceDepth = () => use(SurfaceDepthContext);
+/**
+* Class for a dashboard card: `colorBgContainer` in light, translucent `colorFillTertiary` in
+* dark, and no fill of its own when nested in another Surface.
+*/
+const useSurfaceCardClassName = () => {
+	const { isDarkMode } = useThemeMode();
+	const depth = useSurfaceDepth();
+	return cx(styles.card, isDarkMode && styles.cardDark, depth > 0 && styles.cardNested);
+};
+//#endregion
+export { SurfaceDepthContext, SurfaceLinkProvider, useSurfaceCardClassName, useSurfaceDepth, useSurfaceLink };
+
+//# sourceMappingURL=link.mjs.map

package/es/dashboard/Surface/link.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.mjs","names":[],"sources":["../../../src/dashboard/Surface/link.tsx"],"sourcesContent":["'use client';\n\nimport { cx, useThemeMode } from 'antd-style';\nimport { createContext, type ReactNode, use } from 'react';\n\nimport { styles } from './style';\nimport type { SurfaceLinkProps, SurfaceRenderLink } from './type';\n\nconst defaultRenderLink: SurfaceRenderLink = ({ children, ...rest }: SurfaceLinkProps) => (\n  <a {...rest}>{children}</a>\n);\n\nconst SurfaceLinkContext = createContext<SurfaceRenderLink>(defaultRenderLink);\n\nconst SurfaceDepthContext = createContext(0);\n\n/** Plugs the app router into every dashboard card link (Surface, MetricStrip, Section). */\nexport const SurfaceLinkProvider = ({\n  children,\n  renderLink,\n}: {\n  children?: ReactNode;\n  renderLink: SurfaceRenderLink;\n}) => <SurfaceLinkContext value={renderLink}>{children}</SurfaceLinkContext>;\n\nexport const useSurfaceLink = (override?: SurfaceRenderLink) => override ?? use(SurfaceLinkContext);\n\n/** How many Surface cards wrap this node. A table can skip its own card when already inside one. */\nexport const useSurfaceDepth = () => use(SurfaceDepthContext);\n\nexport { SurfaceDepthContext };\n\n/**\n * Class for a dashboard card: `colorBgContainer` in light, translucent `colorFillTertiary` in\n * dark, and no fill of its own when nested in another Surface.\n */\nexport const useSurfaceCardClassName = () => {\n  const { isDarkMode } = useThemeMode();\n  const depth = useSurfaceDepth();\n  return cx(styles.card, isDarkMode && styles.cardDark, depth > 0 && styles.cardNested);\n};\n"],"mappings":";;;;;;AAQA,MAAM,qBAAwC,EAAE,UAAU,GAAG,WAC3D,oBAAC,KAAD;CAAG,GAAI;CAAO;AAAY,CAAA;AAG5B,MAAM,qBAAqB,cAAiC,iBAAiB;AAE7E,MAAM,sBAAsB,cAAc,CAAC;;AAG3C,MAAa,uBAAuB,EAClC,UACA,iBAII,oBAAC,oBAAD;CAAoB,OAAO;CAAa;AAA6B,CAAA;AAE3E,MAAa,kBAAkB,aAAiC,YAAY,IAAI,kBAAkB;;AAGlG,MAAa,wBAAwB,IAAI,mBAAmB;;;;;AAQ5D,MAAa,gCAAgC;CAC3C,MAAM,EAAE,eAAe,aAAa;CACpC,MAAM,QAAQ,gBAAgB;CAC9B,OAAO,GAAG,OAAO,MAAM,cAAc,OAAO,UAAU,QAAQ,KAAK,OAAO,UAAU;AACtF"}

package/es/dashboard/Surface/style.d.mts

@@ -2,12 +2,54 @@
 /**
  * A content card sitting on the workspace.
  *
- * Outlined `Block` uses `colorBorderSecondary` on `colorBgContainer`.
- * The workspace is already that container, so a card inside it steps up to
- * `colorBgElevated` and `colorBorder`.
+ * Backgrounds: light mode uses `colorBgContainer`. Dark mode uses the translucent
+ * `colorFillTertiary` (white 6%): on the #0d0d0d workspace it reads as about #1c1c1c, a subtle
+ * raised step. `colorFillQuaternary` (white 2%, about #111) would barely separate from the page.
+ *
+ * Borders and inner dividers (table, header and cell lines, PageSkeleton) use `colorFillSecondary`
+ * (white 10% / black 6%); hover and focus use the stronger `colorFill`. Painted over the dark card
+ * the border lands near #2f2f2f against #1c1c1c, and in light near #f0f0f0 against #ffffff.
+ *
+ * Anything that must hide content scrolled beneath it (table header cells, pinned and sticky
+ * cells, their scroll shadows) uses `--lobe-surface-bg-solid`: the same white 6% blended onto
+ * `--lobe-surface-canvas` (default `colorBgContainer`, the ConsoleShell workspace). `color-mix`
+ * in srgb with an opaque base is plain alpha compositing, so it matches the translucent card.
+ * Set `--lobe-surface-canvas` when a card sits on another page color.
+ *
+ * A Surface inside another Surface (`useSurfaceDepth() > 0`) drops its own fill so fills do not
+ * stack. Row hover backgrounds keep their own mix. Layout containers (ConsoleShell, ConsoleNav,
+ * FilterSidebar split divider, AuthLayout page canvas) keep their own tokens.
+ *
+ * Apply the card with `useSurfaceCardClassName()`; plain `surfaceStyles.card` is the light look.
  */
 declare const styles: {
   card: string;
+  cardDark: string;
+  cardNested: string;
+  chart: string;
+  /** Rounded corners clip a bled table, header rule, or chart. Bare cards keep overflow visible. */
+  clip: string;
+  loading: string;
+  arrow: string;
+  arrowLink: string;
+  bleed: string;
+  body: string;
+  /** Table and header rules for the rich card. Kept off `card` so the shared class stays a plain frame. */
+  content: string;
+  /** Whole card answers hover when its header drills into another page. */
+  cardLinked: string;
+  desc: string;
+  extra: string;
+  header: string;
+  heading: string;
+  headingLink: string;
+  /**
+   * A table inside padded card body meets the card's left, right, and bottom
+   * edges. A table that is the only body content also meets the header.
+   * Padding amounts come from `--surface-pad-*` on the same element.
+   */
+  tableBleed: string;
+  title: string;
 };
 //#endregion
 export { styles };