@fangxinyan/lumina 0.6.5 → 0.6.7

package/dist/{Card-MA6SV7D5.css → Card-M6UMBDD2.css}

@@ -5,6 +5,12 @@
   box-shadow: var(--neu-shadow-panel);
   padding: var(--gap-5);
 }
+.card.fill {
+  display: flex;
+  flex-direction: column;
+  min-height: 0;
+  height: 100%;
+}
 .card.flat   { box-shadow: var(--neu-shadow-subtle); }
 .card.sunken { box-shadow: var(--neu-shadow-inset-strong); }
 .card.pad-none { padding: 0; }
@@ -30,4 +36,38 @@
 .card-title { font-size: 15px; font-weight: 600; }
 .card-desc  { font-size: 12px; color: var(--fg-muted); }
 .card-actions { display: flex; gap: 6px; }
-.card-body { font-size: 13px; }
+.card-body {
+  font-size: 13px;
+  min-width: 0;
+  position: relative;
+}
+.card-body.body-stack {
+  display: flex;
+  flex-direction: column;
+  gap: var(--gap-3);
+}
+.card-body.body-fill {
+  display: flex;
+  flex: 1;
+  flex-direction: column;
+  min-height: 0;
+}
+.card-body.body-center {
+  display: grid;
+  place-items: center;
+}
+.card-body.loading {
+  pointer-events: none;
+}
+
+.card-loading-overlay {
+  position: absolute;
+  inset: calc(var(--gap-2) * -1);
+  border-radius: var(--r-md);
+  display: grid;
+  place-items: center;
+  background: color-mix(in oklch, var(--bg) 82%, transparent);
+  box-shadow: var(--neu-shadow-inset);
+  color: var(--fg-muted);
+  z-index: 1;
+}

package/dist/Card.cjs

@@ -1,10 +1,11 @@
 'use strict';
 
-var chunkCBKJXKVI_cjs = require('./chunk-CBKJXKVI.cjs');
+var chunkWHXSUPJB_cjs = require('./chunk-WHXSUPJB.cjs');
+require('./chunk-SG42F5VB.cjs');
 
 
 
 Object.defineProperty(exports, "Card", {
   enumerable: true,
-  get: function () { return chunkCBKJXKVI_cjs.Card; }
+  get: function () { return chunkWHXSUPJB_cjs.Card; }
 });

package/dist/Card.d.cts

@@ -1,5 +1,9 @@
 import * as React from 'react';
 
+type DataAttributes = {
+    [K in `data-${string}`]?: string | number | boolean | undefined;
+};
+type CardBodyProps = Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "className" | "style"> & DataAttributes;
 interface CardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
     /** Visual variant. `raised` protrudes; `sunken` recesses; `flat` is subtle. */
     variant?: "raised" | "sunken" | "flat";
@@ -13,6 +17,20 @@ interface CardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title">
     description?: React.ReactNode;
     /** Action slot aligned to the card heading. */
     actions?: React.ReactNode;
+    /** Make the card and its body fill the available height. */
+    fill?: boolean;
+    /** Body layout strategy. */
+    bodyLayout?: "block" | "stack" | "fill" | "center";
+    /** Class name forwarded to the card body wrapper. */
+    bodyClassName?: string;
+    /** Inline style forwarded to the card body wrapper. */
+    bodyStyle?: React.CSSProperties;
+    /** Extra DOM props forwarded to the card body wrapper. */
+    bodyProps?: CardBodyProps;
+    /** Show a built-in loading overlay above the body content. */
+    loading?: boolean;
+    /** Custom overlay content shown while `loading` is true. */
+    loadingOverlay?: React.ReactNode;
     children?: React.ReactNode;
 }
 /**

package/dist/Card.d.ts

@@ -1,5 +1,9 @@
 import * as React from 'react';
 
+type DataAttributes = {
+    [K in `data-${string}`]?: string | number | boolean | undefined;
+};
+type CardBodyProps = Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "className" | "style"> & DataAttributes;
 interface CardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
     /** Visual variant. `raised` protrudes; `sunken` recesses; `flat` is subtle. */
     variant?: "raised" | "sunken" | "flat";
@@ -13,6 +17,20 @@ interface CardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title">
     description?: React.ReactNode;
     /** Action slot aligned to the card heading. */
     actions?: React.ReactNode;
+    /** Make the card and its body fill the available height. */
+    fill?: boolean;
+    /** Body layout strategy. */
+    bodyLayout?: "block" | "stack" | "fill" | "center";
+    /** Class name forwarded to the card body wrapper. */
+    bodyClassName?: string;
+    /** Inline style forwarded to the card body wrapper. */
+    bodyStyle?: React.CSSProperties;
+    /** Extra DOM props forwarded to the card body wrapper. */
+    bodyProps?: CardBodyProps;
+    /** Show a built-in loading overlay above the body content. */
+    loading?: boolean;
+    /** Custom overlay content shown while `loading` is true. */
+    loadingOverlay?: React.ReactNode;
     children?: React.ReactNode;
 }
 /**

package/dist/Card.js

@@ -1 +1,2 @@
-export { Card } from './chunk-WEJKY3DF.js';
+export { Card } from './chunk-J7EQJXSJ.js';
+import './chunk-Y5F7ZTBH.js';

package/dist/Modal.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkGBKUGKIY_cjs = require('./chunk-GBKUGKIY.cjs');
+var chunk5PR7UWIZ_cjs = require('./chunk-5PR7UWIZ.cjs');
 require('./chunk-2ZADGBUN.cjs');
 require('./chunk-6LARTGLP.cjs');
 
@@ -8,5 +8,5 @@ require('./chunk-6LARTGLP.cjs');
 
 Object.defineProperty(exports, "Modal", {
   enumerable: true,
-  get: function () { return chunkGBKUGKIY_cjs.Modal; }
+  get: function () { return chunk5PR7UWIZ_cjs.Modal; }
 });

package/dist/Modal.d.cts

@@ -3,6 +3,10 @@ import { ButtonProps } from './Button.cjs';
 import './Icon.cjs';
 import 'react/jsx-runtime';
 
+type DataAttributes = {
+    [K in `data-${string}`]?: string | number | boolean | undefined;
+};
+type ModalBodyProps = Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "className" | "style"> & DataAttributes;
 interface ModalProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title" | "children" | "onClose"> {
     /** Whether the modal is visible. */
     open: boolean;
@@ -39,6 +43,14 @@ interface ModalProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"
     cancelButtonProps?: Partial<ButtonProps>;
     /** Show a spinner on the OK button (e.g. while an async submit is running). */
     confirmLoading?: boolean;
+    /** Class name forwarded to the modal body wrapper. */
+    bodyClassName?: string;
+    /** Inline style forwarded to the modal body wrapper. */
+    bodyStyle?: React.CSSProperties;
+    /** Extra DOM props forwarded to the modal body wrapper. */
+    bodyProps?: ModalBodyProps;
+    /** Convenience overflow control for the body wrapper. */
+    bodyOverflow?: React.CSSProperties["overflow"];
     /**
      * When true the modal's children are unmounted every time it closes.
      * Default `false` — children stay mounted so internal state survives

package/dist/Modal.d.ts

@@ -3,6 +3,10 @@ import { ButtonProps } from './Button.js';
 import './Icon.js';
 import 'react/jsx-runtime';
 
+type DataAttributes = {
+    [K in `data-${string}`]?: string | number | boolean | undefined;
+};
+type ModalBodyProps = Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "className" | "style"> & DataAttributes;
 interface ModalProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title" | "children" | "onClose"> {
     /** Whether the modal is visible. */
     open: boolean;
@@ -39,6 +43,14 @@ interface ModalProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"
     cancelButtonProps?: Partial<ButtonProps>;
     /** Show a spinner on the OK button (e.g. while an async submit is running). */
     confirmLoading?: boolean;
+    /** Class name forwarded to the modal body wrapper. */
+    bodyClassName?: string;
+    /** Inline style forwarded to the modal body wrapper. */
+    bodyStyle?: React.CSSProperties;
+    /** Extra DOM props forwarded to the modal body wrapper. */
+    bodyProps?: ModalBodyProps;
+    /** Convenience overflow control for the body wrapper. */
+    bodyOverflow?: React.CSSProperties["overflow"];
     /**
      * When true the modal's children are unmounted every time it closes.
      * Default `false` — children stay mounted so internal state survives

package/dist/Modal.js

@@ -1,3 +1,3 @@
-export { Modal } from './chunk-OHIFKN4E.js';
+export { Modal } from './chunk-N4USDBY2.js';
 import './chunk-CNGKJYGZ.js';
 import './chunk-YT5NLCRC.js';

package/dist/{Timeline-ZIM7QFQC.css → Timeline-CRFZ3I2W.css}

@@ -11,6 +11,7 @@
   grid-template-columns: 1fr auto 1fr;
   gap: 0 var(--gap-3);
   min-height: 60px;
+  min-width: 0;
   position: relative;
 }
 
@@ -78,7 +79,7 @@
   justify-content: center;
   position: relative;
   z-index: 1;
-  margin-top: 4px;
+  margin-top: var(--timeline-dot-offset, 4px);
 }
 
 .timeline-item-dot.accent { background: var(--accent); }
@@ -108,6 +109,7 @@
 .timeline-item-content {
   padding-bottom: var(--gap-5);
   line-height: 1.6;
+  min-width: var(--timeline-content-min-width, 0);
 }
 .timeline-item-last .timeline-item-content {
   padding-bottom: 0;
@@ -118,6 +120,7 @@
   line-height: 1.6;
   color: var(--fg-muted);
   font-size: 13px;
+  min-width: 0;
 }
 
 /* ---- Pending animation ---- */

package/dist/Timeline.cjs

@@ -1,11 +1,11 @@
 'use strict';
 
-var chunkBJ6WUVEG_cjs = require('./chunk-BJ6WUVEG.cjs');
+var chunkPVOQWCP2_cjs = require('./chunk-PVOQWCP2.cjs');
 require('./chunk-SG42F5VB.cjs');
 
 
 
 Object.defineProperty(exports, "Timeline", {
   enumerable: true,
-  get: function () { return chunkBJ6WUVEG_cjs.Timeline; }
+  get: function () { return chunkPVOQWCP2_cjs.Timeline; }
 });

package/dist/Timeline.d.cts

@@ -11,6 +11,22 @@ interface TimelineItemConfig {
     color?: "accent" | "success" | "warning" | "danger" | "info" | "muted";
     /** Custom dot content (replaces default dot) */
     dot?: React.ReactNode;
+    /** Class name forwarded to the item wrapper. */
+    className?: string;
+    /** Inline style forwarded to the item wrapper. */
+    style?: React.CSSProperties;
+    /** Class name forwarded to the content wrapper. */
+    contentClassName?: string;
+    /** Inline style forwarded to the content wrapper. */
+    contentStyle?: React.CSSProperties;
+    /** Class name forwarded to the dot wrapper. */
+    dotClassName?: string;
+    /** Inline style forwarded to the dot wrapper. */
+    dotStyle?: React.CSSProperties;
+    /** Class name forwarded to the label wrapper. */
+    labelClassName?: string;
+    /** Inline style forwarded to the label wrapper. */
+    labelStyle?: React.CSSProperties;
 }
 interface TimelineProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
     /** Timeline items */
@@ -26,6 +42,28 @@ interface TimelineProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "chil
     mode?: "left" | "right" | "alternate";
     /** Reverse the order of items */
     reverse?: boolean;
+    /** Class name forwarded to every item wrapper. */
+    itemClassName?: string;
+    /** Inline style forwarded to every item wrapper. */
+    itemStyle?: React.CSSProperties;
+    /** Class name forwarded to every content wrapper. */
+    contentClassName?: string;
+    /** Inline style forwarded to every content wrapper. */
+    contentStyle?: React.CSSProperties;
+    /** Minimum width for every content wrapper. Defaults to `0` so flex/grid children can shrink. */
+    contentMinWidth?: React.CSSProperties["minWidth"];
+    /** Class name forwarded to every dot wrapper. */
+    dotClassName?: string;
+    /** Inline style forwarded to every dot wrapper. */
+    dotStyle?: React.CSSProperties;
+    /** Vertical offset for the dot. */
+    dotOffset?: React.CSSProperties["marginTop"];
+    /** Cross-axis dot alignment inside the head column. */
+    dotAlign?: "start" | "center" | "end";
+    /** Class name forwarded to every label wrapper. */
+    labelClassName?: string;
+    /** Inline style forwarded to every label wrapper. */
+    labelStyle?: React.CSSProperties;
 }
 /**
  * `Timeline` — vertical timeline with pending/loading state.

package/dist/Timeline.d.ts

@@ -11,6 +11,22 @@ interface TimelineItemConfig {
     color?: "accent" | "success" | "warning" | "danger" | "info" | "muted";
     /** Custom dot content (replaces default dot) */
     dot?: React.ReactNode;
+    /** Class name forwarded to the item wrapper. */
+    className?: string;
+    /** Inline style forwarded to the item wrapper. */
+    style?: React.CSSProperties;
+    /** Class name forwarded to the content wrapper. */
+    contentClassName?: string;
+    /** Inline style forwarded to the content wrapper. */
+    contentStyle?: React.CSSProperties;
+    /** Class name forwarded to the dot wrapper. */
+    dotClassName?: string;
+    /** Inline style forwarded to the dot wrapper. */
+    dotStyle?: React.CSSProperties;
+    /** Class name forwarded to the label wrapper. */
+    labelClassName?: string;
+    /** Inline style forwarded to the label wrapper. */
+    labelStyle?: React.CSSProperties;
 }
 interface TimelineProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
     /** Timeline items */
@@ -26,6 +42,28 @@ interface TimelineProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "chil
     mode?: "left" | "right" | "alternate";
     /** Reverse the order of items */
     reverse?: boolean;
+    /** Class name forwarded to every item wrapper. */
+    itemClassName?: string;
+    /** Inline style forwarded to every item wrapper. */
+    itemStyle?: React.CSSProperties;
+    /** Class name forwarded to every content wrapper. */
+    contentClassName?: string;
+    /** Inline style forwarded to every content wrapper. */
+    contentStyle?: React.CSSProperties;
+    /** Minimum width for every content wrapper. Defaults to `0` so flex/grid children can shrink. */
+    contentMinWidth?: React.CSSProperties["minWidth"];
+    /** Class name forwarded to every dot wrapper. */
+    dotClassName?: string;
+    /** Inline style forwarded to every dot wrapper. */
+    dotStyle?: React.CSSProperties;
+    /** Vertical offset for the dot. */
+    dotOffset?: React.CSSProperties["marginTop"];
+    /** Cross-axis dot alignment inside the head column. */
+    dotAlign?: "start" | "center" | "end";
+    /** Class name forwarded to every label wrapper. */
+    labelClassName?: string;
+    /** Inline style forwarded to every label wrapper. */
+    labelStyle?: React.CSSProperties;
 }
 /**
  * `Timeline` — vertical timeline with pending/loading state.

package/dist/Timeline.js

@@ -1,2 +1,2 @@
-export { Timeline } from './chunk-OQU3TJCF.js';
+export { Timeline } from './chunk-I4M2RL2X.js';
 import './chunk-Y5F7ZTBH.js';

package/dist/{chunk-GBKUGKIY.cjs → chunk-5PR7UWIZ.cjs}

@@ -53,6 +53,10 @@ var ModalBase = React__namespace.forwardRef(({
   okButtonProps,
   cancelButtonProps,
   confirmLoading,
+  bodyClassName = "",
+  bodyStyle,
+  bodyProps,
+  bodyOverflow,
   destroyOnClose = false,
   afterOpenChange,
   zIndex,
@@ -104,6 +108,7 @@ var ModalBase = React__namespace.forwardRef(({
       }
     )
   ] });
+  const modalBodyStyle = bodyOverflow == null ? bodyStyle : { overflow: bodyOverflow, ...bodyStyle };
   return ReactDOM__default.default.createPortal(
     /* @__PURE__ */ jsxRuntime.jsx(
       "div",
@@ -143,7 +148,15 @@ var ModalBase = React__namespace.forwardRef(({
                   }
                 )
               ] }),
-              /* @__PURE__ */ jsxRuntime.jsx("div", { className: "modal-body", children }),
+              /* @__PURE__ */ jsxRuntime.jsx(
+                "div",
+                {
+                  ...bodyProps,
+                  className: `modal-body ${bodyClassName}`.trim(),
+                  style: modalBodyStyle,
+                  children
+                }
+              ),
               footer === null ? null : /* @__PURE__ */ jsxRuntime.jsx("div", { className: "modal-foot", children: footer ?? defaultFooter })
             ]
           }

package/dist/chunk-I4M2RL2X.js

@@ -0,0 +1,151 @@
+import { Spin } from './chunk-Y5F7ZTBH.js';
+import './tokens-EF34LSWI.css';
+import './shared-NJHRNLRH.css';
+import './Timeline-CRFZ3I2W.css';
+import * as React from 'react';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+var Timeline = React.forwardRef(
+  ({
+    items,
+    pending = false,
+    pendingContent = "\u52A0\u8F7D\u4E2D...",
+    mode = "left",
+    reverse = false,
+    itemClassName,
+    itemStyle,
+    contentClassName,
+    contentStyle,
+    contentMinWidth,
+    dotClassName,
+    dotStyle,
+    dotOffset,
+    dotAlign = "center",
+    labelClassName,
+    labelStyle,
+    className = "",
+    style,
+    ...rest
+  }, ref) => {
+    const displayItems = [...items];
+    if (reverse) displayItems.reverse();
+    const hasPending = pending !== false;
+    const timelineStyle = {
+      ...dotOffset != null ? { "--timeline-dot-offset": toCssSize(dotOffset) } : {},
+      ...contentMinWidth != null ? { "--timeline-content-min-width": toCssSize(contentMinWidth) } : {},
+      ...style
+    };
+    const sharedItemProps = {
+      itemClassName,
+      itemStyle,
+      contentClassName,
+      contentStyle,
+      dotClassName,
+      dotStyle,
+      dotAlign,
+      labelClassName,
+      labelStyle
+    };
+    return /* @__PURE__ */ jsxs(
+      "div",
+      {
+        ref,
+        className: `timeline timeline-${mode} timeline-dot-${dotAlign} ${className}`,
+        style: timelineStyle,
+        ...rest,
+        children: [
+          displayItems.map((item, i) => /* @__PURE__ */ jsx(
+            TimelineItem,
+            {
+              item,
+              isLast: !hasPending && i === displayItems.length - 1,
+              position: getPosition(mode, i),
+              ...sharedItemProps
+            },
+            item.key ?? i
+          )),
+          hasPending && /* @__PURE__ */ jsx(
+            TimelineItem,
+            {
+              item: {
+                children: pendingContent,
+                dot: typeof pending === "boolean" ? void 0 : pending,
+                color: "muted"
+              },
+              isLast: true,
+              isPending: true,
+              position: getPosition(mode, displayItems.length),
+              ...sharedItemProps
+            }
+          )
+        ]
+      }
+    );
+  }
+);
+Timeline.displayName = "Timeline";
+function getPosition(mode, index) {
+  if (mode === "left") return "left";
+  if (mode === "right") return "right";
+  return index % 2 === 0 ? "left" : "right";
+}
+var TimelineItem = ({
+  item,
+  isLast,
+  isPending,
+  position,
+  itemClassName,
+  itemStyle,
+  contentClassName,
+  contentStyle,
+  dotClassName,
+  dotStyle,
+  dotAlign,
+  labelClassName,
+  labelStyle
+}) => {
+  const color = item.color ?? "accent";
+  const cls = [
+    "timeline-item",
+    `timeline-item-${position}`,
+    isLast ? "timeline-item-last" : "",
+    isPending ? "timeline-item-pending" : "",
+    itemClassName,
+    item.className
+  ].filter(Boolean).join(" ");
+  const dotCls = [
+    "timeline-item-dot",
+    color,
+    isPending ? "pending" : "",
+    dotClassName,
+    item.dotClassName
+  ].filter(Boolean).join(" ");
+  const dotAlignStyle = dotAlign === "start" ? { alignSelf: "flex-start" } : dotAlign === "end" ? { alignSelf: "flex-end" } : {};
+  return /* @__PURE__ */ jsxs("div", { className: cls, style: { ...itemStyle, ...item.style }, children: [
+    /* @__PURE__ */ jsx(
+      "div",
+      {
+        className: `timeline-item-label ${labelClassName ?? ""} ${item.labelClassName ?? ""}`,
+        style: { ...labelStyle, ...item.labelStyle },
+        children: item.label
+      }
+    ),
+    /* @__PURE__ */ jsxs("div", { className: "timeline-item-head", children: [
+      /* @__PURE__ */ jsx("div", { className: dotCls, style: { ...dotAlignStyle, ...dotStyle, ...item.dotStyle }, children: item.dot ?? (isPending && /* @__PURE__ */ jsx(Spin, { size: 14 })) }),
+      !isLast && /* @__PURE__ */ jsx("div", { className: "timeline-item-tail" })
+    ] }),
+    /* @__PURE__ */ jsx(
+      "div",
+      {
+        className: `timeline-item-content ${contentClassName ?? ""} ${item.contentClassName ?? ""}`,
+        style: { ...contentStyle, ...item.contentStyle },
+        children: item.children
+      }
+    )
+  ] });
+};
+function toCssSize(value) {
+  return typeof value === "number" ? `${value}px` : String(value);
+}
+
+export { Timeline };

package/dist/{chunk-WEJKY3DF.js → chunk-J7EQJXSJ.js}

@@ -1,10 +1,10 @@
+import { Spin } from './chunk-Y5F7ZTBH.js';
 import './tokens-EF34LSWI.css';
 import './shared-NJHRNLRH.css';
-import './Card-MA6SV7D5.css';
+import './Card-M6UMBDD2.css';
 import * as React from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';
 
-// src/components/Card/Card.tsx
 var Card = React.forwardRef(
   ({
     variant = "raised",
@@ -13,18 +13,34 @@ var Card = React.forwardRef(
     title,
     description,
     actions,
+    fill = false,
+    bodyLayout,
+    bodyClassName = "",
+    bodyStyle,
+    bodyProps,
+    loading = false,
+    loadingOverlay,
     className = "",
     children,
     ...rest
   }, ref) => {
+    const resolvedBodyLayout = bodyLayout ?? (fill ? "fill" : "block");
     const cls = [
       "card",
       variant,
       padding !== "md" && `pad-${padding}`,
+      fill && "fill",
       hoverable && "hoverable",
+      loading && "loading",
       className
     ].filter(Boolean).join(" ");
-    return /* @__PURE__ */ jsxs("div", { ref, className: cls, ...rest, children: [
+    const bodyCls = [
+      "card-body",
+      resolvedBodyLayout !== "block" && `body-${resolvedBodyLayout}`,
+      loading && "loading",
+      bodyClassName
+    ].filter(Boolean).join(" ");
+    return /* @__PURE__ */ jsxs("div", { ref, className: cls, "aria-busy": loading || void 0, ...rest, children: [
       (title || description || actions) && /* @__PURE__ */ jsxs("div", { className: "card-head", children: [
         /* @__PURE__ */ jsxs("div", { className: "card-titles", children: [
           title && /* @__PURE__ */ jsx("div", { className: "card-title", children: title }),
@@ -32,7 +48,10 @@ var Card = React.forwardRef(
         ] }),
         actions && /* @__PURE__ */ jsx("div", { className: "card-actions", children: actions })
       ] }),
-      /* @__PURE__ */ jsx("div", { className: "card-body", children })
+      /* @__PURE__ */ jsxs("div", { ...bodyProps, className: bodyCls, style: bodyStyle, children: [
+        children,
+        loading && /* @__PURE__ */ jsx("div", { className: "card-loading-overlay", "aria-live": "polite", children: loadingOverlay ?? /* @__PURE__ */ jsx(Spin, { tip: "\u52A0\u8F7D\u4E2D..." }) })
+      ] })
     ] });
   }
 );

package/dist/{chunk-OHIFKN4E.js → chunk-N4USDBY2.js}

@@ -28,6 +28,10 @@ var ModalBase = React.forwardRef(({
   okButtonProps,
   cancelButtonProps,
   confirmLoading,
+  bodyClassName = "",
+  bodyStyle,
+  bodyProps,
+  bodyOverflow,
   destroyOnClose = false,
   afterOpenChange,
   zIndex,
@@ -79,6 +83,7 @@ var ModalBase = React.forwardRef(({
       }
     )
   ] });
+  const modalBodyStyle = bodyOverflow == null ? bodyStyle : { overflow: bodyOverflow, ...bodyStyle };
   return ReactDOM.createPortal(
     /* @__PURE__ */ jsx(
       "div",
@@ -118,7 +123,15 @@ var ModalBase = React.forwardRef(({
                   }
                 )
               ] }),
-              /* @__PURE__ */ jsx("div", { className: "modal-body", children }),
+              /* @__PURE__ */ jsx(
+                "div",
+                {
+                  ...bodyProps,
+                  className: `modal-body ${bodyClassName}`.trim(),
+                  style: modalBodyStyle,
+                  children
+                }
+              ),
               footer === null ? null : /* @__PURE__ */ jsx("div", { className: "modal-foot", children: footer ?? defaultFooter })
             ]
           }

package/dist/{chunk-BJ6WUVEG.cjs → chunk-PVOQWCP2.cjs}

@@ -3,7 +3,7 @@
 var chunkSG42F5VB_cjs = require('./chunk-SG42F5VB.cjs');
 require('./tokens-EF34LSWI.css');
 require('./shared-NJHRNLRH.css');
-require('./Timeline-ZIM7QFQC.css');
+require('./Timeline-CRFZ3I2W.css');
 var React = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
@@ -34,17 +34,46 @@ var Timeline = React__namespace.forwardRef(
     pendingContent = "\u52A0\u8F7D\u4E2D...",
     mode = "left",
     reverse = false,
+    itemClassName,
+    itemStyle,
+    contentClassName,
+    contentStyle,
+    contentMinWidth,
+    dotClassName,
+    dotStyle,
+    dotOffset,
+    dotAlign = "center",
+    labelClassName,
+    labelStyle,
     className = "",
+    style,
     ...rest
   }, ref) => {
     const displayItems = [...items];
     if (reverse) displayItems.reverse();
     const hasPending = pending !== false;
+    const timelineStyle = {
+      ...dotOffset != null ? { "--timeline-dot-offset": toCssSize(dotOffset) } : {},
+      ...contentMinWidth != null ? { "--timeline-content-min-width": toCssSize(contentMinWidth) } : {},
+      ...style
+    };
+    const sharedItemProps = {
+      itemClassName,
+      itemStyle,
+      contentClassName,
+      contentStyle,
+      dotClassName,
+      dotStyle,
+      dotAlign,
+      labelClassName,
+      labelStyle
+    };
     return /* @__PURE__ */ jsxRuntime.jsxs(
       "div",
       {
         ref,
-        className: `timeline timeline-${mode} ${className}`,
+        className: `timeline timeline-${mode} timeline-dot-${dotAlign} ${className}`,
+        style: timelineStyle,
         ...rest,
         children: [
           displayItems.map((item, i) => /* @__PURE__ */ jsxRuntime.jsx(
@@ -52,7 +81,8 @@ var Timeline = React__namespace.forwardRef(
             {
               item,
               isLast: !hasPending && i === displayItems.length - 1,
-              position: getPosition(mode, i)
+              position: getPosition(mode, i),
+              ...sharedItemProps
             },
             item.key ?? i
           )),
@@ -66,7 +96,8 @@ var Timeline = React__namespace.forwardRef(
               },
               isLast: true,
               isPending: true,
-              position: getPosition(mode, displayItems.length)
+              position: getPosition(mode, displayItems.length),
+              ...sharedItemProps
             }
           )
         ]
@@ -84,23 +115,59 @@ var TimelineItem = ({
   item,
   isLast,
   isPending,
-  position
+  position,
+  itemClassName,
+  itemStyle,
+  contentClassName,
+  contentStyle,
+  dotClassName,
+  dotStyle,
+  dotAlign,
+  labelClassName,
+  labelStyle
 }) => {
   const color = item.color ?? "accent";
   const cls = [
     "timeline-item",
     `timeline-item-${position}`,
     isLast ? "timeline-item-last" : "",
-    isPending ? "timeline-item-pending" : ""
+    isPending ? "timeline-item-pending" : "",
+    itemClassName,
+    item.className
   ].filter(Boolean).join(" ");
-  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: cls, children: [
-    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "timeline-item-label", children: item.label }),
+  const dotCls = [
+    "timeline-item-dot",
+    color,
+    isPending ? "pending" : "",
+    dotClassName,
+    item.dotClassName
+  ].filter(Boolean).join(" ");
+  const dotAlignStyle = dotAlign === "start" ? { alignSelf: "flex-start" } : dotAlign === "end" ? { alignSelf: "flex-end" } : {};
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: cls, style: { ...itemStyle, ...item.style }, children: [
+    /* @__PURE__ */ jsxRuntime.jsx(
+      "div",
+      {
+        className: `timeline-item-label ${labelClassName ?? ""} ${item.labelClassName ?? ""}`,
+        style: { ...labelStyle, ...item.labelStyle },
+        children: item.label
+      }
+    ),
     /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "timeline-item-head", children: [
-      /* @__PURE__ */ jsxRuntime.jsx("div", { className: `timeline-item-dot ${color} ${isPending ? "pending" : ""}`, children: item.dot ?? (isPending && /* @__PURE__ */ jsxRuntime.jsx(chunkSG42F5VB_cjs.Spin, { size: 14 })) }),
+      /* @__PURE__ */ jsxRuntime.jsx("div", { className: dotCls, style: { ...dotAlignStyle, ...dotStyle, ...item.dotStyle }, children: item.dot ?? (isPending && /* @__PURE__ */ jsxRuntime.jsx(chunkSG42F5VB_cjs.Spin, { size: 14 })) }),
       !isLast && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "timeline-item-tail" })
     ] }),
-    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "timeline-item-content", children: item.children })
+    /* @__PURE__ */ jsxRuntime.jsx(
+      "div",
+      {
+        className: `timeline-item-content ${contentClassName ?? ""} ${item.contentClassName ?? ""}`,
+        style: { ...contentStyle, ...item.contentStyle },
+        children: item.children
+      }
+    )
   ] });
 };
+function toCssSize(value) {
+  return typeof value === "number" ? `${value}px` : String(value);
+}
 
 exports.Timeline = Timeline;

package/dist/{chunk-CBKJXKVI.cjs → chunk-WHXSUPJB.cjs}

@@ -1,8 +1,9 @@
 'use strict';
 
+var chunkSG42F5VB_cjs = require('./chunk-SG42F5VB.cjs');
 require('./tokens-EF34LSWI.css');
 require('./shared-NJHRNLRH.css');
-require('./Card-MA6SV7D5.css');
+require('./Card-M6UMBDD2.css');
 var React = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
@@ -26,7 +27,6 @@ function _interopNamespace(e) {
 
 var React__namespace = /*#__PURE__*/_interopNamespace(React);
 
-// src/components/Card/Card.tsx
 var Card = React__namespace.forwardRef(
   ({
     variant = "raised",
@@ -35,18 +35,34 @@ var Card = React__namespace.forwardRef(
     title,
     description,
     actions,
+    fill = false,
+    bodyLayout,
+    bodyClassName = "",
+    bodyStyle,
+    bodyProps,
+    loading = false,
+    loadingOverlay,
     className = "",
     children,
     ...rest
   }, ref) => {
+    const resolvedBodyLayout = bodyLayout ?? (fill ? "fill" : "block");
     const cls = [
       "card",
       variant,
       padding !== "md" && `pad-${padding}`,
+      fill && "fill",
       hoverable && "hoverable",
+      loading && "loading",
       className
     ].filter(Boolean).join(" ");
-    return /* @__PURE__ */ jsxRuntime.jsxs("div", { ref, className: cls, ...rest, children: [
+    const bodyCls = [
+      "card-body",
+      resolvedBodyLayout !== "block" && `body-${resolvedBodyLayout}`,
+      loading && "loading",
+      bodyClassName
+    ].filter(Boolean).join(" ");
+    return /* @__PURE__ */ jsxRuntime.jsxs("div", { ref, className: cls, "aria-busy": loading || void 0, ...rest, children: [
       (title || description || actions) && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "card-head", children: [
         /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "card-titles", children: [
           title && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "card-title", children: title }),
@@ -54,7 +70,10 @@ var Card = React__namespace.forwardRef(
         ] }),
         actions && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "card-actions", children: actions })
       ] }),
-      /* @__PURE__ */ jsxRuntime.jsx("div", { className: "card-body", children })
+      /* @__PURE__ */ jsxRuntime.jsxs("div", { ...bodyProps, className: bodyCls, style: bodyStyle, children: [
+        children,
+        loading && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "card-loading-overlay", "aria-live": "polite", children: loadingOverlay ?? /* @__PURE__ */ jsxRuntime.jsx(chunkSG42F5VB_cjs.Spin, { tip: "\u52A0\u8F7D\u4E2D..." }) })
+      ] })
     ] });
   }
 );

package/dist/index.cjs

@@ -2,11 +2,10 @@
 
 var chunkIHK2FRTS_cjs = require('./chunk-IHK2FRTS.cjs');
 var chunkLFTCK2VM_cjs = require('./chunk-LFTCK2VM.cjs');
-var chunkBJ6WUVEG_cjs = require('./chunk-BJ6WUVEG.cjs');
+var chunkPVOQWCP2_cjs = require('./chunk-PVOQWCP2.cjs');
 var chunkRIUDYPRB_cjs = require('./chunk-RIUDYPRB.cjs');
 var chunkYU5JK247_cjs = require('./chunk-YU5JK247.cjs');
 var chunkZWCDB5PP_cjs = require('./chunk-ZWCDB5PP.cjs');
-var chunkSG42F5VB_cjs = require('./chunk-SG42F5VB.cjs');
 var chunkN3OLFKV5_cjs = require('./chunk-N3OLFKV5.cjs');
 var chunk6XVLERA3_cjs = require('./chunk-6XVLERA3.cjs');
 var chunkNT6CJYI3_cjs = require('./chunk-NT6CJYI3.cjs');
@@ -16,7 +15,7 @@ var chunk6GQPF3EI_cjs = require('./chunk-6GQPF3EI.cjs');
 var chunkD64IPDUE_cjs = require('./chunk-D64IPDUE.cjs');
 var chunkOGPDCBPD_cjs = require('./chunk-OGPDCBPD.cjs');
 var chunkN2BTMKF2_cjs = require('./chunk-N2BTMKF2.cjs');
-var chunkGBKUGKIY_cjs = require('./chunk-GBKUGKIY.cjs');
+var chunk5PR7UWIZ_cjs = require('./chunk-5PR7UWIZ.cjs');
 var chunkDYSGXQUK_cjs = require('./chunk-DYSGXQUK.cjs');
 var chunk4UKM4KAC_cjs = require('./chunk-4UKM4KAC.cjs');
 var chunkMOMLQP7B_cjs = require('./chunk-MOMLQP7B.cjs');
@@ -30,7 +29,8 @@ var chunkC24W6PTJ_cjs = require('./chunk-C24W6PTJ.cjs');
 var chunkDYHNOYRC_cjs = require('./chunk-DYHNOYRC.cjs');
 var chunk66T76GII_cjs = require('./chunk-66T76GII.cjs');
 var chunkU2H4DRMV_cjs = require('./chunk-U2H4DRMV.cjs');
-var chunkCBKJXKVI_cjs = require('./chunk-CBKJXKVI.cjs');
+var chunkWHXSUPJB_cjs = require('./chunk-WHXSUPJB.cjs');
+var chunkSG42F5VB_cjs = require('./chunk-SG42F5VB.cjs');
 var chunkQY76WTO5_cjs = require('./chunk-QY76WTO5.cjs');
 var chunkZPKHGKVL_cjs = require('./chunk-ZPKHGKVL.cjs');
 var chunkR74TZKJS_cjs = require('./chunk-R74TZKJS.cjs');
@@ -51,7 +51,7 @@ var chunkACQSRMLF_cjs = require('./chunk-ACQSRMLF.cjs');
 var chunk6LARTGLP_cjs = require('./chunk-6LARTGLP.cjs');
 
 // src/index.ts
-var VERSION = "0.6.5";
+var VERSION = "0.6.7";
 
 Object.defineProperty(exports, "Tabs", {
   enumerable: true,
@@ -71,7 +71,7 @@ Object.defineProperty(exports, "ThemePanel", {
 });
 Object.defineProperty(exports, "Timeline", {
   enumerable: true,
-  get: function () { return chunkBJ6WUVEG_cjs.Timeline; }
+  get: function () { return chunkPVOQWCP2_cjs.Timeline; }
 });
 Object.defineProperty(exports, "Tooltip", {
   enumerable: true,
@@ -101,10 +101,6 @@ Object.defineProperty(exports, "Slider", {
   enumerable: true,
   get: function () { return chunkZWCDB5PP_cjs.Slider; }
 });
-Object.defineProperty(exports, "Spin", {
-  enumerable: true,
-  get: function () { return chunkSG42F5VB_cjs.Spin; }
-});
 Object.defineProperty(exports, "Splitter", {
   enumerable: true,
   get: function () { return chunkN3OLFKV5_cjs.Splitter; }
@@ -195,7 +191,7 @@ Object.defineProperty(exports, "toast", {
 });
 Object.defineProperty(exports, "Modal", {
   enumerable: true,
-  get: function () { return chunkGBKUGKIY_cjs.Modal; }
+  get: function () { return chunk5PR7UWIZ_cjs.Modal; }
 });
 Object.defineProperty(exports, "Pagination", {
   enumerable: true,
@@ -275,7 +271,11 @@ Object.defineProperty(exports, "List", {
 });
 Object.defineProperty(exports, "Card", {
   enumerable: true,
-  get: function () { return chunkCBKJXKVI_cjs.Card; }
+  get: function () { return chunkWHXSUPJB_cjs.Card; }
+});
+Object.defineProperty(exports, "Spin", {
+  enumerable: true,
+  get: function () { return chunkSG42F5VB_cjs.Spin; }
 });
 Object.defineProperty(exports, "Cascader", {
   enumerable: true,

package/dist/index.d.cts

@@ -49,6 +49,6 @@ import 'react/jsx-runtime';
 import 'react';
 
 /** Package version — bumped by release scripts. */
-declare const VERSION = "0.6.5";
+declare const VERSION = "0.6.7";
 
 export { VERSION };

package/dist/index.d.ts

@@ -49,6 +49,6 @@ import 'react/jsx-runtime';
 import 'react';
 
 /** Package version — bumped by release scripts. */
-declare const VERSION = "0.6.5";
+declare const VERSION = "0.6.7";
 
 export { VERSION };

package/dist/index.js

@@ -1,10 +1,9 @@
 export { Tabs } from './chunk-TVUBGXWA.js';
 export { THEME_PANEL_DEFAULT_PRESET_OPTIONS, THEME_PANEL_DEFAULT_THEME_PRESETS, ThemePanel } from './chunk-NJCHFXGC.js';
-export { Timeline } from './chunk-OQU3TJCF.js';
+export { Timeline } from './chunk-I4M2RL2X.js';
 export { Tooltip } from './chunk-SFAGHPBT.js';
 export { Link, Paragraph, Text, Title, Typography } from './chunk-5JNDDWFZ.js';
 export { Slider } from './chunk-HU7T64Y3.js';
-export { Spin } from './chunk-Y5F7ZTBH.js';
 export { Splitter } from './chunk-7ZNGHWVS.js';
 export { StatusBar, StatusBarItem } from './chunk-2SCXQ7QS.js';
 export { SURFACE_THEME_PRESETS, Surface } from './chunk-O43DOE7V.js';
@@ -14,7 +13,7 @@ export { Switch } from './chunk-YJEXAO2I.js';
 export { TablePro } from './chunk-GUZ2DNDC.js';
 export { Table } from './chunk-YSXD344H.js';
 export { MessageContainer, ToastContainer, message, toast } from './chunk-W5CJC7S7.js';
-export { Modal } from './chunk-OHIFKN4E.js';
+export { Modal } from './chunk-N4USDBY2.js';
 export { Pagination } from './chunk-2ZFJTMEF.js';
 export { Popover } from './chunk-PKHITACT.js';
 export { Progress } from './chunk-YVTLHTG6.js';
@@ -28,7 +27,8 @@ export { Form, FormItem, useForm } from './chunk-SABWUELE.js';
 export { Image, ImageGrid, LayeredImage, SpriteImage } from './chunk-2NT5QKEX.js';
 export { InputNumber } from './chunk-LI4XJTEA.js';
 export { List } from './chunk-OHFZ7L4T.js';
-export { Card } from './chunk-WEJKY3DF.js';
+export { Card } from './chunk-J7EQJXSJ.js';
+export { Spin } from './chunk-Y5F7ZTBH.js';
 export { Cascader } from './chunk-REMJWNAT.js';
 export { Checkbox } from './chunk-WXWFMWWF.js';
 export { Collapse } from './chunk-AJH2O4WC.js';
@@ -49,6 +49,6 @@ export { Calendar } from './chunk-CEZ2DR4R.js';
 export { AimOutlined, AppstoreOutlined, BarChartOutlined, BlockOutlined, BorderOutlined, CameraOutlined, CaretDownOutlined, CaretUpOutlined, CheckCircleFilled, CheckCircleOutlined, CheckOutlined, ClockCircleFilled, CloseCircleOutlined, CloseOutlined, CopyOutlined, DashboardOutlined, DeleteOutlined, DownOutlined, EnvironmentOutlined, ExclamationCircleOutlined, FolderOpenOutlined, ICON_NAMES, Icon, LeftOutlined, LoadingOutlined, MinusCircleOutlined, MinusOutlined, NAMED_ICON_MAP, PictureOutlined, PlusOutlined, QqOutlined, ReloadOutlined, RightOutlined, RobotOutlined, SearchOutlined, SettingOutlined, StarFilled, StarOutlined, SwapOutlined, SwapRightOutlined, SyncOutlined, ThunderboltOutlined, TranslationOutlined, UnorderedListOutlined, UserOutlined, isIconName, renderIconSlot, resolveIconName } from './chunk-YT5NLCRC.js';
 
 // src/index.ts
-var VERSION = "0.6.5";
+var VERSION = "0.6.7";
 
 export { VERSION };

package/dist/styles.css

@@ -1121,6 +1121,12 @@ input, textarea, select { font-family: inherit; color: inherit; }
   box-shadow: var(--neu-shadow-panel);
   padding: var(--gap-5);
 }
+.card.fill {
+  display: flex;
+  flex-direction: column;
+  min-height: 0;
+  height: 100%;
+}
 .card.flat   { box-shadow: var(--neu-shadow-subtle); }
 .card.sunken { box-shadow: var(--neu-shadow-inset-strong); }
 .card.pad-none { padding: 0; }
@@ -1144,7 +1150,40 @@ input, textarea, select { font-family: inherit; color: inherit; }
 .card-title { font-size: 15px; font-weight: 600; }
 .card-desc  { font-size: 12px; color: var(--fg-muted); }
 .card-actions { display: flex; gap: 6px; }
-.card-body { font-size: 13px; }
+.card-body {
+  font-size: 13px;
+  min-width: 0;
+  position: relative;
+}
+.card-body.body-stack {
+  display: flex;
+  flex-direction: column;
+  gap: var(--gap-3);
+}
+.card-body.body-fill {
+  display: flex;
+  flex: 1;
+  flex-direction: column;
+  min-height: 0;
+}
+.card-body.body-center {
+  display: grid;
+  place-items: center;
+}
+.card-body.loading {
+  pointer-events: none;
+}
+.card-loading-overlay {
+  position: absolute;
+  inset: calc(var(--gap-2) * -1);
+  border-radius: var(--r-md);
+  display: grid;
+  place-items: center;
+  background: color-mix(in oklch, var(--bg) 82%, transparent);
+  box-shadow: var(--neu-shadow-inset);
+  color: var(--fg-muted);
+  z-index: 1;
+}
 /* ============ Surface ============ */
 .surface {
   position: relative;

package/docs/llms/card.md

@@ -44,6 +44,31 @@ hoverable 在鼠标悬浮时轻微上移并加强阴影,适合可点击的卡片
 <Card title="..." actions={<Button size="sm" icon="plus">邀请</Button>}>...</Card>
 ```
 
+### 正文布局
+
+bodyLayout 控制正文槽布局，bodyClassName / bodyStyle / bodyProps 直接作用到 .card-body。
+
+```tsx
+<Card
+  fill
+  bodyLayout="stack"
+  bodyClassName="settings-card-body"
+  bodyStyle={{ minHeight: 160 }}
+>
+  ...
+</Card>
+```
+
+### 加载覆盖
+
+loading 会在正文区域显示内建 overlay；loadingOverlay 可替换默认 Spin。
+
+```tsx
+<Card loading loadingOverlay="正在同步...">
+  ...
+</Card>
+```
+
 ## API
 
 **Card**
@@ -56,6 +81,13 @@ hoverable 在鼠标悬浮时轻微上移并加强阴影,适合可点击的卡片
 | title | `ReactNode` | — | 标题 |
 | description | `ReactNode` | — | 副标题 |
 | actions | `ReactNode` | — | 右上操作区 |
+| fill | `boolean` | `false` | 卡片和正文填满可用高度 |
+| bodyLayout | `"block" | "stack" | "fill" | "center"` | `"block"` | 正文布局策略 |
+| bodyClassName | `string` | — | 正文容器 className |
+| bodyStyle | `CSSProperties` | — | 正文容器内联样式 |
+| bodyProps | `HTMLAttributes<HTMLDivElement>` | — | 透传给正文容器的 DOM props |
+| loading | `boolean` | `false` | 显示正文加载覆盖层 |
+| loadingOverlay | `ReactNode` | — | 自定义加载覆盖层内容 |
 
 
 ---

package/docs/llms/modal.md

@@ -78,6 +78,21 @@ closable={false} 隐藏右上角 ×,closeIcon 可自定义。
 <Modal closeIcon={<Icon name="chevDown" />} />
 ```
 
+### 正文容器控制
+
+bodyClassName / bodyStyle / bodyProps 可直接作用到正文容器；bodyOverflow 用于切换滚动或允许拟态阴影外溢。
+
+```tsx
+<Modal
+  bodyClassName="settings-modal-body"
+  bodyStyle={{ maxHeight: 260, padding: 12 }}
+  bodyOverflow="visible"
+  bodyProps={{ "data-panel": "settings" }}
+>
+  ...
+</Modal>
+```
+
 ## API
 
 **Modal**
@@ -93,6 +108,10 @@ closable={false} 隐藏右上角 ×,closeIcon 可自定义。
 | okText / cancelText | `ReactNode` | `"确定" / "取消"` | 默认按钮文案 |
 | okButtonProps / cancelButtonProps | `Partial<ButtonProps>` | — | 透传给默认按钮 |
 | confirmLoading | `boolean` | `false` | OK 按钮显示 spinner 并禁用 |
+| bodyClassName | `string` | — | 正文容器 className |
+| bodyStyle | `CSSProperties` | — | 正文容器内联样式 |
+| bodyProps | `HTMLAttributes<HTMLDivElement>` | — | 透传给正文容器的 DOM props |
+| bodyOverflow | `CSSProperties['overflow']` | — | 正文容器 overflow 快捷控制 |
 | closable | `boolean` | `true` | 显示右上角 × |
 | closeIcon | `ReactNode` | — | 自定义关闭图标 |
 | maskClosable | `boolean` | `true` | 点击遮罩关闭 |

package/docs/llms/timeline.md

@@ -112,6 +112,24 @@ reverse 属性将时间线反转，最新的事件在最上面
 />
 ```
 
+### 槽位样式
+
+item / content / dot / label 都可以拿到样式入口；content 默认 min-width: 0，长内容能在弹性容器里正确收缩。
+
+```tsx
+<Timeline
+  contentMinWidth={0}
+  dotOffset={4}
+  items={[
+    {
+      children: "很长的任务标题...",
+      contentStyle: { overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" },
+      dotStyle: { boxShadow: "var(--neu-shadow-lift)" },
+    },
+  ]}
+/>
+```
+
 ## API
 
 **Timeline**
@@ -123,6 +141,13 @@ reverse 属性将时间线反转，最新的事件在最上面
 | pendingContent | `ReactNode` | `"加载中..."` | 等待节点的文字内容 |
 | mode | `"left" | "right" | "alternate"` | `"left"` | 布局模式 |
 | reverse | `boolean` | `false` | 反转节点顺序 |
+| itemClassName / itemStyle | `string / CSSProperties` | — | 透传到每个节点外层 |
+| contentClassName / contentStyle | `string / CSSProperties` | — | 透传到每个内容槽 |
+| contentMinWidth | `CSSProperties['minWidth']` | `0` | 内容槽最小宽度，默认允许在 flex/grid 中收缩 |
+| dotClassName / dotStyle | `string / CSSProperties` | — | 透传到每个圆点槽 |
+| dotOffset | `CSSProperties['marginTop']` | `4` | 圆点垂直偏移 |
+| dotAlign | `"start" | "center" | "end"` | `"center"` | 圆点在 head 列中的横向对齐 |
+| labelClassName / labelStyle | `string / CSSProperties` | — | 透传到每个标签槽 |
 
 
 **TimelineItemConfig**
@@ -134,6 +159,10 @@ reverse 属性将时间线反转，最新的事件在最上面
 | label | `ReactNode` | — | 对侧标签（alternate 模式下使用） |
 | color | `"accent" | "success" | "warning" | "danger" | "info" | "muted"` | `"accent"` | 圆点颜色 |
 | dot | `ReactNode` | — | 自定义圆点内容 |
+| className / style | `string / CSSProperties` | — | 节点外层样式槽 |
+| contentClassName / contentStyle | `string / CSSProperties` | — | 内容槽样式 |
+| dotClassName / dotStyle | `string / CSSProperties` | — | 圆点槽样式 |
+| labelClassName / labelStyle | `string / CSSProperties` | — | 标签槽样式 |
 
 
 ---

package/docs/llms.md

@@ -3,7 +3,7 @@
 > 拟态风格的 React 18 组件库,目标是 Electron 桌面应用。**写给 AI 编程助手**的按需文档 —— 每个组件单独一个 `.md`,避免一次性读取全部。示例源自 playground 的 demo,可直接复制运行。
 
 - **包名**: `@fangxinyan/lumina`
-- **版本**: `0.6.5`
+- **版本**: `0.6.7`
 - **React 最低版本**: 18
 - **环境**: 带打包器的 React 工程(Vite / Next.js / Webpack / Remix / Electron + Vite 等)
 - **零运行时依赖**: 只依赖 `react` / `react-dom` (peer deps)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fangxinyan/lumina",
-  "version": "0.6.5",
+  "version": "0.6.7",
   "description": "Lumina — Neumorphic component library for Electron & React apps",
   "type": "module",
   "main": "./dist/index.cjs",

package/dist/chunk-OQU3TJCF.js

@@ -1,84 +0,0 @@
-import { Spin } from './chunk-Y5F7ZTBH.js';
-import './tokens-EF34LSWI.css';
-import './shared-NJHRNLRH.css';
-import './Timeline-ZIM7QFQC.css';
-import * as React from 'react';
-import { jsxs, jsx } from 'react/jsx-runtime';
-
-var Timeline = React.forwardRef(
-  ({
-    items,
-    pending = false,
-    pendingContent = "\u52A0\u8F7D\u4E2D...",
-    mode = "left",
-    reverse = false,
-    className = "",
-    ...rest
-  }, ref) => {
-    const displayItems = [...items];
-    if (reverse) displayItems.reverse();
-    const hasPending = pending !== false;
-    return /* @__PURE__ */ jsxs(
-      "div",
-      {
-        ref,
-        className: `timeline timeline-${mode} ${className}`,
-        ...rest,
-        children: [
-          displayItems.map((item, i) => /* @__PURE__ */ jsx(
-            TimelineItem,
-            {
-              item,
-              isLast: !hasPending && i === displayItems.length - 1,
-              position: getPosition(mode, i)
-            },
-            item.key ?? i
-          )),
-          hasPending && /* @__PURE__ */ jsx(
-            TimelineItem,
-            {
-              item: {
-                children: pendingContent,
-                dot: typeof pending === "boolean" ? void 0 : pending,
-                color: "muted"
-              },
-              isLast: true,
-              isPending: true,
-              position: getPosition(mode, displayItems.length)
-            }
-          )
-        ]
-      }
-    );
-  }
-);
-Timeline.displayName = "Timeline";
-function getPosition(mode, index) {
-  if (mode === "left") return "left";
-  if (mode === "right") return "right";
-  return index % 2 === 0 ? "left" : "right";
-}
-var TimelineItem = ({
-  item,
-  isLast,
-  isPending,
-  position
-}) => {
-  const color = item.color ?? "accent";
-  const cls = [
-    "timeline-item",
-    `timeline-item-${position}`,
-    isLast ? "timeline-item-last" : "",
-    isPending ? "timeline-item-pending" : ""
-  ].filter(Boolean).join(" ");
-  return /* @__PURE__ */ jsxs("div", { className: cls, children: [
-    /* @__PURE__ */ jsx("div", { className: "timeline-item-label", children: item.label }),
-    /* @__PURE__ */ jsxs("div", { className: "timeline-item-head", children: [
-      /* @__PURE__ */ jsx("div", { className: `timeline-item-dot ${color} ${isPending ? "pending" : ""}`, children: item.dot ?? (isPending && /* @__PURE__ */ jsx(Spin, { size: 14 })) }),
-      !isLast && /* @__PURE__ */ jsx("div", { className: "timeline-item-tail" })
-    ] }),
-    /* @__PURE__ */ jsx("div", { className: "timeline-item-content", children: item.children })
-  ] });
-};
-
-export { Timeline };