@lobehub/ui 5.57.3 → 5.59.0

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

@@ -0,0 +1,10 @@
+import { PanelSurfaceProps } from "./type.mjs";
+//#region src/dashboard/PanelSurface/PanelSurface.d.ts
+/** Titled console panel. Body padding stays inside so a trailing table can bleed to the edges. */
+declare const PanelSurface: {
+  ({ title, description, extra, href, loading, renderLink, size, className, style, children }: PanelSurfaceProps): import("react").JSX.Element;
+  displayName: string;
+};
+//#endregion
+export { PanelSurface as default };
+//# sourceMappingURL=PanelSurface.d.mts.map

package/es/dashboard/PanelSurface/PanelSurface.mjs

@@ -0,0 +1,36 @@
+"use client";
+import Spin from "../../base-ui/Spin/Spin.mjs";
+import Skeleton from "../../base-ui/Skeleton/index.mjs";
+import { styles } from "../Surface/style.mjs";
+import Surface from "../Surface/Surface.mjs";
+import { styles as styles$1 } from "./style.mjs";
+import { jsx } from "react/jsx-runtime";
+import { cx } from "antd-style";
+//#region src/dashboard/PanelSurface/PanelSurface.tsx
+/** Titled console panel. Body padding stays inside so a trailing table can bleed to the edges. */
+const PanelSurface = ({ title, description, extra, href, loading, renderLink, size = "default", className, style, children }) => /* @__PURE__ */ jsx(Surface, {
+	className,
+	description,
+	extra: loading && children ? /* @__PURE__ */ jsx(Spin, { size: "small" }) : extra,
+	href,
+	padded: false,
+	renderLink,
+	style,
+	title,
+	children: loading && !children ? /* @__PURE__ */ jsx("div", {
+		"aria-busy": "true",
+		className: styles$1.loadingBody,
+		children: /* @__PURE__ */ jsx(Skeleton, {
+			height: 220,
+			radius: 8
+		})
+	}) : /* @__PURE__ */ jsx("div", {
+		className: cx(size === "small" ? styles$1.bodySmall : styles$1.body, styles.tableBleed),
+		children
+	})
+});
+PanelSurface.displayName = "PanelSurface";
+//#endregion
+export { PanelSurface as default };
+
+//# sourceMappingURL=PanelSurface.mjs.map

package/es/dashboard/PanelSurface/PanelSurface.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PanelSurface.mjs","names":["styles","surfaceStyles"],"sources":["../../../src/dashboard/PanelSurface/PanelSurface.tsx"],"sourcesContent":["'use client';\n\nimport { cx } from 'antd-style';\n\nimport Skeleton from '@/base-ui/Skeleton';\nimport Spin from '@/base-ui/Spin';\n\nimport { styles as surfaceStyles } from '../Surface/style';\nimport Surface from '../Surface/Surface';\nimport { styles } from './style';\nimport type { PanelSurfaceProps } from './type';\n\n/** Titled console panel. Body padding stays inside so a trailing table can bleed to the edges. */\nconst PanelSurface = ({\n  title,\n  description,\n  extra,\n  href,\n  loading,\n  renderLink,\n  size = 'default',\n  className,\n  style,\n  children,\n}: PanelSurfaceProps) => (\n  <Surface\n    className={className}\n    description={description}\n    extra={loading && children ? <Spin size=\"small\" /> : extra}\n    href={href}\n    padded={false}\n    renderLink={renderLink}\n    style={style}\n    title={title}\n  >\n    {loading && !children ? (\n      <div aria-busy=\"true\" className={styles.loadingBody}>\n        <Skeleton height={220} radius={8} />\n      </div>\n    ) : (\n      <div\n        className={cx(size === 'small' ? styles.bodySmall : styles.body, surfaceStyles.tableBleed)}\n      >\n        {children}\n      </div>\n    )}\n  </Surface>\n);\n\nPanelSurface.displayName = 'PanelSurface';\n\nexport default PanelSurface;\n"],"mappings":";;;;;;;;;;AAaA,MAAM,gBAAgB,EACpB,OACA,aACA,OACA,MACA,SACA,YACA,OAAO,WACP,WACA,OACA,eAEA,oBAAC,SAAD;CACa;CACE;CACb,OAAO,WAAW,WAAW,oBAAC,MAAD,EAAM,MAAK,QAAS,CAAA,IAAI;CAC/C;CACN,QAAQ;CACI;CACL;CACA;CAEN,UAAA,WAAW,CAAC,WACX,oBAAC,OAAD;EAAK,aAAU;EAAO,WAAWA,SAAO;EACtC,UAAA,oBAAC,UAAD;GAAU,QAAQ;GAAK,QAAQ;EAAI,CAAA;CAChC,CAAA,IAEL,oBAAC,OAAD;EACE,WAAW,GAAG,SAAS,UAAUA,SAAO,YAAYA,SAAO,MAAMC,OAAc,UAAU;EAExF;CACE,CAAA;AAEA,CAAA;AAGX,aAAa,cAAc"}

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

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

package/es/dashboard/PanelSurface/style.mjs

@@ -0,0 +1,24 @@
+import { createStaticStyles } from "antd-style";
+//#region src/dashboard/PanelSurface/style.ts
+const styles = createStaticStyles(({ css }) => ({
+	body: css`
+    --surface-pad-inline: 16px;
+    --surface-pad-block: 16px;
+
+    padding: 16px;
+  `,
+	bodySmall: css`
+    --surface-pad-inline: 16px;
+    --surface-pad-block: 12px;
+
+    padding-block: 12px;
+    padding-inline: 16px;
+  `,
+	loadingBody: css`
+    padding-block: 4px 8px;
+  `
+}));
+//#endregion
+export { styles };
+
+//# sourceMappingURL=style.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"style.mjs","names":[],"sources":["../../../src/dashboard/PanelSurface/style.ts"],"sourcesContent":["import { createStaticStyles } from 'antd-style';\n\nexport const styles = createStaticStyles(({ css }) => ({\n  body: css`\n    --surface-pad-inline: 16px;\n    --surface-pad-block: 16px;\n\n    padding: 16px;\n  `,\n  bodySmall: css`\n    --surface-pad-inline: 16px;\n    --surface-pad-block: 12px;\n\n    padding-block: 12px;\n    padding-inline: 16px;\n  `,\n  loadingBody: css`\n    padding-block: 4px 8px;\n  `,\n}));\n"],"mappings":";;AAEA,MAAa,SAAS,oBAAoB,EAAE,WAAW;CACrD,MAAM,GAAG;;;;;;CAMT,WAAW,GAAG;;;;;;;CAOd,aAAa,GAAG;;;AAGlB,EAAE"}

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/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,76 @@
 "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, 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 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;
+	return /* @__PURE__ */ jsx(SurfaceDepthContext, {
+		value: depth + 1,
+		children: /* @__PURE__ */ jsxs("div", {
+			className: cx(styles.card, 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, /* @__PURE__ */ jsx(ArrowUpRight, {
+							"aria-hidden": true,
+							"data-surface-arrow": true,
+							className: styles.arrow,
+							size: 16
+						})] }),
+						className: styles.headingLink,
+						href
+					}) : heading, refreshing || defined(extra) ? /* @__PURE__ */ jsxs("div", {
+						className: styles.extra,
+						children: [refreshing ? /* @__PURE__ */ jsx(Spin, { size: "small" }) : null, extra]
+					}) : 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 { SurfaceDepthContext, useSurfaceDepth, useSurfaceLink } 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 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  return (\n    <SurfaceDepthContext value={depth + 1}>\n      <div\n        className={cx(\n          styles.card,\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                      <ArrowUpRight\n                        aria-hidden\n                        data-surface-arrow\n                        className={styles.arrow}\n                        size={16}\n                      />\n                    </>\n                  ),\n                  className: styles.headingLink,\n                  href,\n                })\n              : heading}\n            {refreshing || defined(extra) ? (\n              <div className={styles.extra}>\n                {refreshing ? <Spin size=\"small\" /> : null}\n                {extra}\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":";;;;;;;;;AAaA,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,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;CAGF,OACE,oBAAC,qBAAD;EAAqB,OAAO,QAAQ;EAClC,UAAA,qBAAC,OAAD;GACE,WAAW,GACT,OAAO,MACP,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,SACD,oBAAC,cAAD;OACE,eAAA;OACA,sBAAA;OACA,WAAW,OAAO;OAClB,MAAM;MACP,CAAA,CACD,EAAA,CAAA;MAEJ,WAAW,OAAO;MAClB;KACF,CAAC,IACD,SACH,cAAc,QAAQ,KAAK,IAC1B,qBAAC,OAAD;MAAK,WAAW,OAAO;MAAvB,UAAA,CACG,aAAa,oBAAC,MAAD,EAAM,MAAK,QAAS,CAAA,IAAI,MACrC,KACE;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, 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, useSurfaceDepth, useSurfaceLink };

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

@@ -0,0 +1,14 @@
+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;
+//#endregion
+export { SurfaceLinkProvider, useSurfaceDepth, useSurfaceLink };
+//# sourceMappingURL=link.d.mts.map

package/es/dashboard/Surface/link.mjs

@@ -0,0 +1,22 @@
+"use client";
+import { createContext, use } from "react";
+import { jsx } from "react/jsx-runtime";
+//#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);
+//#endregion
+export { SurfaceDepthContext, SurfaceLinkProvider, 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 { createContext, type ReactNode, use } from 'react';\n\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"],"mappings":";;;;AAMA,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"}

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

@@ -8,6 +8,29 @@
  */
 declare const styles: {
   card: string;
+  chart: string;
+  /** Rounded corners clip a bled table, header rule, or chart. Bare cards keep overflow visible. */
+  clip: string;
+  loading: string;
+  arrow: 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 };