@manohub/ui 0.8.0 → 0.8.2

package/dist/components/card/index.d.ts

@@ -42,17 +42,19 @@ export type CardHeaderIcon = string | (() => VNodeChild);
  * 几何：图标 36×36（与 `ListView.CardItem` 同一档）、圆角取控件档 6；标题 16/600 单行省略；
  * 副标题 12 + 弱字色，同样单行省略。
  *
- * ## 内距：**全部由段承载，根件不出内距；相邻两段之间只有一份**
+ * ## 内距：**全部由段承载，根件不出内距**
  *
  * 根件只出面（底 / 描边 / 圆角），既不出内距也不出段间距；内距一律吃在**段**上：
  * `Card.Header` / `Body` / `Footer`（分件）与 `Card` 内建头 / 操作行默认各吃 `--mh-card-padding`（20px）。
  *
- * 纵向的分配是「**每段只吃上边**」：一段只负责**与自己上方之间的距离**（下一段的上内距就是段间距），
- * 卡片的**下沿由最后一段补**（面上 `:last-child` 那条规则）——
+ * **不给 `padding`**（面上的缺省口径）：纵向是「**每段只吃上边**」—— 一段只负责**与自己上方之间的距离**
+ * （下一段的上内距就是段间距），卡片的**下沿由最后一段补**（面上 `:last-child` 那条规则）——
  * 所以 header + body、body + footer 相邻时都不会叠成两份（20 + 20），卡片首末两端又各有一份完整内距。
  *
- * 要收紧某一段给那一段传 `padding`（px 数字或 `{ y, x }`，**缺哪边不覆盖哪边**：
- * 这里的 `y` 就是该段的段间距，横向照 `x`）；要整卡统一就改令牌 `--mh-card-padding`。
+ * **给了 `padding`**：这一段**整段由消费方定价**（`y` = 上下、`x` = 左右，两维都给时下 `padding: y x` 简写，
+ * 只给一维就只落那一维、另一维照旧吃令牌）。行内样式盖过面上那条 `:last-child`，
+ * 故**下边也按 `y` 走**（`{ y: 0, x: 16 }` ≡ `padding: 0 16px`，内容贴该段下边）—— 要保留兜底就别传。
+ * 要整卡统一就改令牌 `--mh-card-padding`。
  *
  * 直接写内容（`<Card>正文</Card>`）时，**裸子节点会被自动包进一层 `Card.Body`**（与 `Panel` 的简写路径同款），
  * 所以它与显式写 `<Card><Card.Body>正文</Card.Body></Card>` 得到同一份内距。
@@ -60,7 +62,7 @@ export type CardHeaderIcon = string | (() => VNodeChild);
  * ## 三件（`Card.Header` / `Body` / `Footer`）
  *
  * 分件只有内距这一个维度：**不给就走 CSS 默认值**（不额外产生行内 `style`，DOM 与没有该维度时一致）。
- * 分件的 `padding` 语义同上（纵向只表达段间距；下边由末段补）。
+ * 分件的 `padding` 语义同上（给了就整段由消费方定价，含下边；不给才吃「只吃上边 + 末段补下沿」的缺省口径）。
  *
  * ## 底部操作行（`actions` 插槽）
  *
@@ -108,7 +110,7 @@ export interface CardProps {
  * 一个位都不给时退化为自排容器：默认插槽内容原样进头容器（`Card.Header` 也仍然是「自己排头」的逃生口）。
  */
 export declare const CardHeader: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-    /** 这一段的内距（横向 + 段间距）：缺省吃组件令牌 `--mh-card-padding`（20px）；下边由卡片末段统一补 */
+    /** 这一段的内距（`number` = 四边同值；`{ y, x }` = 上下 / 左右）：不给时吃组件令牌 `--mh-card-padding`（20px）、下边由末段补；**给了就整段由消费方定价（含下边）** */
     padding: {
         type: PropType<CardPadding>;
         default: undefined;
@@ -129,7 +131,7 @@ export declare const CardHeader: import("vue").DefineComponent<import("vue").Ext
         default: undefined;
     };
 }>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-    /** 这一段的内距（横向 + 段间距）：缺省吃组件令牌 `--mh-card-padding`（20px）；下边由卡片末段统一补 */
+    /** 这一段的内距（`number` = 四边同值；`{ y, x }` = 上下 / 左右）：不给时吃组件令牌 `--mh-card-padding`（20px）、下边由末段补；**给了就整段由消费方定价（含下边）** */
     padding: {
         type: PropType<CardPadding>;
         default: undefined;
@@ -163,13 +165,13 @@ export declare const CardHeader: import("vue").DefineComponent<import("vue").Ext
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 /** 卡片内容区：撑满剩余高度（卡片被拉伸时才有差别），本身不滚动 —— 滚动归属由所在容器决定 */
 export declare const CardBody: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-    /** 这一段的内距（横向 + 段间距）：缺省吃组件令牌 `--mh-card-padding`（20px）；下边由卡片末段统一补 */
+    /** 这一段的内距（`number` = 四边同值；`{ y, x }` = 上下 / 左右）：不给时吃组件令牌 `--mh-card-padding`（20px）、下边由末段补；**给了就整段由消费方定价（含下边）** */
     padding: {
         type: PropType<CardPadding>;
         default: undefined;
     };
 }>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-    /** 这一段的内距（横向 + 段间距）：缺省吃组件令牌 `--mh-card-padding`（20px）；下边由卡片末段统一补 */
+    /** 这一段的内距（`number` = 四边同值；`{ y, x }` = 上下 / 左右）：不给时吃组件令牌 `--mh-card-padding`（20px）、下边由末段补；**给了就整段由消费方定价（含下边）** */
     padding: {
         type: PropType<CardPadding>;
         default: undefined;
@@ -181,13 +183,13 @@ export declare const CardBody: import("vue").DefineComponent<import("vue").Extra
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 /** 卡片尾部：贴卡片底部（`margin-top: auto`），承载标签 / 统计 / 操作位 */
 export declare const CardFooter: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-    /** 这一段的内距（横向 + 段间距）：缺省吃组件令牌 `--mh-card-padding`（20px）；下边由卡片末段统一补 */
+    /** 这一段的内距（`number` = 四边同值；`{ y, x }` = 上下 / 左右）：不给时吃组件令牌 `--mh-card-padding`（20px）、下边由末段补；**给了就整段由消费方定价（含下边）** */
     padding: {
         type: PropType<CardPadding>;
         default: undefined;
     };
 }>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-    /** 这一段的内距（横向 + 段间距）：缺省吃组件令牌 `--mh-card-padding`（20px）；下边由卡片末段统一补 */
+    /** 这一段的内距（`number` = 四边同值；`{ y, x }` = 上下 / 左右）：不给时吃组件令牌 `--mh-card-padding`（20px）、下边由末段补；**给了就整段由消费方定价（含下边）** */
     padding: {
         type: PropType<CardPadding>;
         default: undefined;
@@ -365,7 +367,7 @@ export declare const Card: {
     actions?: () => VNodeChild;
 }>, import("vue").GlobalComponents, import("vue").GlobalDirectives, string, import("vue").ComponentProvideOptions> & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps & {
     Header: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-        /** 这一段的内距（横向 + 段间距）：缺省吃组件令牌 `--mh-card-padding`（20px）；下边由卡片末段统一补 */
+        /** 这一段的内距（`number` = 四边同值；`{ y, x }` = 上下 / 左右）：不给时吃组件令牌 `--mh-card-padding`（20px）、下边由末段补；**给了就整段由消费方定价（含下边）** */
         padding: {
             type: PropType<CardPadding>;
             default: undefined;
@@ -386,7 +388,7 @@ export declare const Card: {
             default: undefined;
         };
     }>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-        /** 这一段的内距（横向 + 段间距）：缺省吃组件令牌 `--mh-card-padding`（20px）；下边由卡片末段统一补 */
+        /** 这一段的内距（`number` = 四边同值；`{ y, x }` = 上下 / 左右）：不给时吃组件令牌 `--mh-card-padding`（20px）、下边由末段补；**给了就整段由消费方定价（含下边）** */
         padding: {
             type: PropType<CardPadding>;
             default: undefined;
@@ -419,13 +421,13 @@ export declare const Card: {
         extra?: () => VNodeChild;
     }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
     Body: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-        /** 这一段的内距（横向 + 段间距）：缺省吃组件令牌 `--mh-card-padding`（20px）；下边由卡片末段统一补 */
+        /** 这一段的内距（`number` = 四边同值；`{ y, x }` = 上下 / 左右）：不给时吃组件令牌 `--mh-card-padding`（20px）、下边由末段补；**给了就整段由消费方定价（含下边）** */
         padding: {
             type: PropType<CardPadding>;
             default: undefined;
         };
     }>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-        /** 这一段的内距（横向 + 段间距）：缺省吃组件令牌 `--mh-card-padding`（20px）；下边由卡片末段统一补 */
+        /** 这一段的内距（`number` = 四边同值；`{ y, x }` = 上下 / 左右）：不给时吃组件令牌 `--mh-card-padding`（20px）、下边由末段补；**给了就整段由消费方定价（含下边）** */
         padding: {
             type: PropType<CardPadding>;
             default: undefined;
@@ -436,13 +438,13 @@ export declare const Card: {
         default?: () => VNodeChild;
     }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
     Footer: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
-        /** 这一段的内距（横向 + 段间距）：缺省吃组件令牌 `--mh-card-padding`（20px）；下边由卡片末段统一补 */
+        /** 这一段的内距（`number` = 四边同值；`{ y, x }` = 上下 / 左右）：不给时吃组件令牌 `--mh-card-padding`（20px）、下边由末段补；**给了就整段由消费方定价（含下边）** */
         padding: {
             type: PropType<CardPadding>;
             default: undefined;
         };
     }>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
-        /** 这一段的内距（横向 + 段间距）：缺省吃组件令牌 `--mh-card-padding`（20px）；下边由卡片末段统一补 */
+        /** 这一段的内距（`number` = 四边同值；`{ y, x }` = 上下 / 左右）：不给时吃组件令牌 `--mh-card-padding`（20px）、下边由末段补；**给了就整段由消费方定价（含下边）** */
         padding: {
             type: PropType<CardPadding>;
             default: undefined;

package/dist/components/card/index.js

@@ -42,8 +42,16 @@ const mergeSegmentStyle = (attrsStyle, padding) => {
   }];
   const y = typeof padding === "number" ? padding : padding.y;
   const x = typeof padding === "number" ? padding : padding.x;
+  if (y !== void 0 && x !== void 0) {
+    return [attrsStyle, {
+      padding: `${y}px ${x}px`
+    }];
+  }
   const style = {};
-  if (y !== void 0) style.paddingTop = `${y}px`;
+  if (y !== void 0) {
+    style.paddingTop = `${y}px`;
+    style.paddingBottom = `${y}px`;
+  }
   if (x !== void 0) {
     style.paddingLeft = `${x}px`;
     style.paddingRight = `${x}px`;
@@ -55,7 +63,7 @@ const CardHeader = /* @__PURE__ */ defineComponent({
   name: "CardHeader",
   inheritAttrs: false,
   props: {
-    /** 这一段的内距（横向 + 段间距）：缺省吃组件令牌 `--mh-card-padding`（20px）；下边由卡片末段统一补 */
+    /** 这一段的内距（`number` = 四边同值；`{ y, x }` = 上下 / 左右）：不给时吃组件令牌 `--mh-card-padding`（20px）、下边由末段补；**给了就整段由消费方定价（含下边）** */
     padding: {
       type: [Number, Object, String],
       default: void 0
@@ -97,7 +105,7 @@ const CardBody = /* @__PURE__ */ defineComponent({
   name: "CardBody",
   inheritAttrs: false,
   props: {
-    /** 这一段的内距（横向 + 段间距）：缺省吃组件令牌 `--mh-card-padding`（20px）；下边由卡片末段统一补 */
+    /** 这一段的内距（`number` = 四边同值；`{ y, x }` = 上下 / 左右）：不给时吃组件令牌 `--mh-card-padding`（20px）、下边由末段补；**给了就整段由消费方定价（含下边）** */
     padding: {
       type: [Number, Object, String],
       default: void 0
@@ -118,7 +126,7 @@ const CardFooter = /* @__PURE__ */ defineComponent({
   name: "CardFooter",
   inheritAttrs: false,
   props: {
-    /** 这一段的内距（横向 + 段间距）：缺省吃组件令牌 `--mh-card-padding`（20px）；下边由卡片末段统一补 */
+    /** 这一段的内距（`number` = 四边同值；`{ y, x }` = 上下 / 左右）：不给时吃组件令牌 `--mh-card-padding`（20px）、下边由末段补；**给了就整段由消费方定价（含下边）** */
     padding: {
       type: [Number, Object, String],
       default: void 0

package/dist/styles/components/card.css

@@ -39,6 +39,11 @@
  *    段的位置由组件保证（裸内容自动成段、封面不吃内距也不是段），故 `:last-child` 必定落在段上。
  * 4. 横向每段恒吃 `--mh-card-padding`（`padding-inline`）。
  *
+ * ⚠️ 以上 2 / 3 / 4 是**不给 `padding` 时的缺省口径**。分件一旦显式传了 `padding`，
+ * 组件就落行内样式（`{ y, x }` 两维都给时是 `padding: y x` 简写），**整段四边由消费方定价** ——
+ * 行内样式盖过这里的类规则，`:last-child` 那条下沿兜底也随之失效（这是有意的：消费方显式给了就说得清）。
+ * 要保留兜底就不要给那一段传 `padding`。
+ *
  * 直接写的内容（没包 `Card.Body` 的裸子节点）由组件自动补一层 Body，所以
  * 「不给分件」（`<Card>正文</Card>`）与显式分段得到的是同一套几何。 */
 
@@ -148,7 +153,8 @@
   padding-inline: var(--mh-card-padding);
 }
 
-/* 卡片下沿：纵向只吃上边（见上），底边由**最后一段**补，否则内容贴卡片边 */
+/* 卡片下沿：不给 `padding` 时纵向只吃上边（见上），底边由**最后一段**补，否则内容贴卡片边。
+   （传了 `padding` 的段由行内样式接管，这里的兜底对那一段不再生效。） */
 
 .mh-card > .mh-card__header:last-child,
 .mh-card > .mh-card__body:last-child,

package/dist/styles/reset.css

@@ -203,3 +203,7 @@
 :where([data-manohub-ui]) summary {
   display: list-item;
 }
+
+:where([data-manohub-ui]) label {
+  margin: 0;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manohub/ui",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "private": false,
   "type": "module",
   "description": "AIHub 自绘组件层：不依赖 farris 的手写 Vue TSX 组件 + 自带令牌层（Farris 规范视觉 · daisyUI 式语义令牌 · shadcn 式 API 词汇）。",
@@ -46,7 +46,7 @@
     "vue": "^3.5.0"
   },
   "dependencies": {
-    "@manohub/icon": "^0.8.0"
+    "@manohub/icon": "^0.8.2"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",