@pactor-app/ui 1.25.0 → 1.26.0

package/dist/{chunk-7VQS23L5.js → chunk-HSQJWJDS.js}

@@ -2645,6 +2645,7 @@ import { jsx as jsx39, jsxs as jsxs30 } from "react/jsx-runtime";
 function Field2({
   label,
   required,
+  labelHint,
   description,
   error,
   children,
@@ -2652,6 +2653,8 @@ function Field2({
   style,
   labelClassName,
   labelStyle,
+  labelHintClassName,
+  labelHintStyle,
   controlClassName,
   controlStyle,
   descriptionClassName,
@@ -2660,18 +2663,32 @@ function Field2({
   errorStyle
 }) {
   return /* @__PURE__ */ jsxs30(Field, { className, style, children: [
-    label ? /* @__PURE__ */ jsxs30(FieldLabel, { className: labelClassName, style: labelStyle, children: [
-      required ? /* @__PURE__ */ jsxs30("span", { "aria-hidden": true, className: "text-destructive", children: [
-        "*",
-        " "
-      ] }) : null,
-      label
+    label || labelHint ? /* @__PURE__ */ jsxs30("div", { className: "flex w-full items-center justify-between gap-2", children: [
+      label ? /* @__PURE__ */ jsxs30(FieldLabel, { className: labelClassName, style: labelStyle, children: [
+        required ? /* @__PURE__ */ jsxs30("span", { "aria-hidden": true, className: "text-destructive", children: [
+          "*",
+          " "
+        ] }) : null,
+        label
+      ] }) : /* @__PURE__ */ jsx39("span", {}),
+      labelHint ? /* @__PURE__ */ jsx39(
+        "span",
+        {
+          "data-slot": "field-label-hint",
+          className: cn(
+            "shrink-0 text-xs leading-none text-muted-foreground",
+            labelHintClassName
+          ),
+          style: labelHintStyle,
+          children: labelHint
+        }
+      ) : null
     ] }) : null,
     /* @__PURE__ */ jsx39(
       "div",
       {
         "data-slot": "field-control",
-        className: cn(label ? "mt-2" : void 0, controlClassName),
+        className: cn(label || labelHint ? "mt-2" : void 0, controlClassName),
         style: controlStyle,
         children
       }

package/dist/components/index.cjs

@@ -4592,6 +4592,7 @@ var import_jsx_runtime67 = require("react/jsx-runtime");
 function Field2({
   label,
   required,
+  labelHint,
   description,
   error,
   children,
@@ -4599,6 +4600,8 @@ function Field2({
   style,
   labelClassName,
   labelStyle,
+  labelHintClassName,
+  labelHintStyle,
   controlClassName,
   controlStyle,
   descriptionClassName,
@@ -4607,18 +4610,32 @@ function Field2({
   errorStyle
 }) {
   return /* @__PURE__ */ (0, import_jsx_runtime67.jsxs)(Field, { className, style, children: [
-    label ? /* @__PURE__ */ (0, import_jsx_runtime67.jsxs)(FieldLabel, { className: labelClassName, style: labelStyle, children: [
-      required ? /* @__PURE__ */ (0, import_jsx_runtime67.jsxs)("span", { "aria-hidden": true, className: "text-destructive", children: [
-        "*",
-        " "
-      ] }) : null,
-      label
+    label || labelHint ? /* @__PURE__ */ (0, import_jsx_runtime67.jsxs)("div", { className: "flex w-full items-center justify-between gap-2", children: [
+      label ? /* @__PURE__ */ (0, import_jsx_runtime67.jsxs)(FieldLabel, { className: labelClassName, style: labelStyle, children: [
+        required ? /* @__PURE__ */ (0, import_jsx_runtime67.jsxs)("span", { "aria-hidden": true, className: "text-destructive", children: [
+          "*",
+          " "
+        ] }) : null,
+        label
+      ] }) : /* @__PURE__ */ (0, import_jsx_runtime67.jsx)("span", {}),
+      labelHint ? /* @__PURE__ */ (0, import_jsx_runtime67.jsx)(
+        "span",
+        {
+          "data-slot": "field-label-hint",
+          className: cn(
+            "shrink-0 text-xs leading-none text-muted-foreground",
+            labelHintClassName
+          ),
+          style: labelHintStyle,
+          children: labelHint
+        }
+      ) : null
     ] }) : null,
     /* @__PURE__ */ (0, import_jsx_runtime67.jsx)(
       "div",
       {
         "data-slot": "field-control",
-        className: cn(label ? "mt-2" : void 0, controlClassName),
+        className: cn(label || labelHint ? "mt-2" : void 0, controlClassName),
         style: controlStyle,
         children
       }

package/dist/components/index.d.cts

@@ -989,6 +989,8 @@ interface FieldProps {
     label?: string;
     /** 必填标记（label 前渲染红色 `*`；仅视觉标记，校验仍由 Form rules 承担） */
     required?: boolean;
+    /** label 行右侧的提示文字（如「创建后不可修改」），右对齐小字弱化展示 */
+    labelHint?: string;
     /** 辅助说明文案 */
     description?: string;
     /** 错误文案（声明式展示，如校验失败信息） */
@@ -1002,6 +1004,9 @@ interface FieldProps {
     /** label 节点 class / style（必填星号随 label 节点） */
     labelClassName?: string;
     labelStyle?: CSSProperties;
+    /** label 行右侧提示节点 class / style */
+    labelHintClassName?: string;
+    labelHintStyle?: CSSProperties;
     /** 控件容器（label 下方）class / style；缺省有 label 时容器自带 mt-2 */
     controlClassName?: string;
     controlStyle?: CSSProperties;
@@ -1014,12 +1019,13 @@ interface FieldProps {
 }
 /**
  * Field 适配器（shadcn kit）：通用表单项容器（Base UI Field 封装，
- * 上下结构：label 在上、控件容器在下）；label / description / error 为
- * 框架级 props，error 声明式强制展示；`required` 在 label 前渲染必填星号
- * （对齐 antd Form.Item required 语义）；label 与控件容器之间默认 mt-2，
- * 四个节点（label / 控件容器 / description / error）均可独立加样式。
+ * 上下结构：label 在上、控件容器在下）；label / labelHint / description /
+ * error 为框架级 props，error 声明式强制展示；`required` 在 label 前渲染
+ * 必填星号（对齐 antd Form.Item required 语义）；`labelHint` 与 label 同行
+ * 右对齐（弱化为小字）；label 与控件容器之间默认 mt-2，五个节点
+ * （label / labelHint / 控件容器 / description / error）均可独立加样式。
  */
-declare function Field({ label, required, description, error, children, className, style, labelClassName, labelStyle, controlClassName, controlStyle, descriptionClassName, descriptionStyle, errorClassName, errorStyle, }: FieldProps): React.JSX.Element;
+declare function Field({ label, required, labelHint, description, error, children, className, style, labelClassName, labelStyle, labelHintClassName, labelHintStyle, controlClassName, controlStyle, descriptionClassName, descriptionStyle, errorClassName, errorStyle, }: FieldProps): React.JSX.Element;
 
 /** 文件类别（缺省按 fileType / name 扩展名推断） */
 type FilePreviewKind = 'image' | 'text' | 'video' | 'audio' | 'other';

package/dist/components/index.d.ts

@@ -989,6 +989,8 @@ interface FieldProps {
     label?: string;
     /** 必填标记（label 前渲染红色 `*`；仅视觉标记，校验仍由 Form rules 承担） */
     required?: boolean;
+    /** label 行右侧的提示文字（如「创建后不可修改」），右对齐小字弱化展示 */
+    labelHint?: string;
     /** 辅助说明文案 */
     description?: string;
     /** 错误文案（声明式展示，如校验失败信息） */
@@ -1002,6 +1004,9 @@ interface FieldProps {
     /** label 节点 class / style（必填星号随 label 节点） */
     labelClassName?: string;
     labelStyle?: CSSProperties;
+    /** label 行右侧提示节点 class / style */
+    labelHintClassName?: string;
+    labelHintStyle?: CSSProperties;
     /** 控件容器（label 下方）class / style；缺省有 label 时容器自带 mt-2 */
     controlClassName?: string;
     controlStyle?: CSSProperties;
@@ -1014,12 +1019,13 @@ interface FieldProps {
 }
 /**
  * Field 适配器（shadcn kit）：通用表单项容器（Base UI Field 封装，
- * 上下结构：label 在上、控件容器在下）；label / description / error 为
- * 框架级 props，error 声明式强制展示；`required` 在 label 前渲染必填星号
- * （对齐 antd Form.Item required 语义）；label 与控件容器之间默认 mt-2，
- * 四个节点（label / 控件容器 / description / error）均可独立加样式。
+ * 上下结构：label 在上、控件容器在下）；label / labelHint / description /
+ * error 为框架级 props，error 声明式强制展示；`required` 在 label 前渲染
+ * 必填星号（对齐 antd Form.Item required 语义）；`labelHint` 与 label 同行
+ * 右对齐（弱化为小字）；label 与控件容器之间默认 mt-2，五个节点
+ * （label / labelHint / 控件容器 / description / error）均可独立加样式。
  */
-declare function Field({ label, required, description, error, children, className, style, labelClassName, labelStyle, controlClassName, controlStyle, descriptionClassName, descriptionStyle, errorClassName, errorStyle, }: FieldProps): React.JSX.Element;
+declare function Field({ label, required, labelHint, description, error, children, className, style, labelClassName, labelStyle, labelHintClassName, labelHintStyle, controlClassName, controlStyle, descriptionClassName, descriptionStyle, errorClassName, errorStyle, }: FieldProps): React.JSX.Element;
 
 /** 文件类别（缺省按 fileType / name 扩展名推断） */
 type FilePreviewKind = 'image' | 'text' | 'video' | 'audio' | 'other';

package/dist/components/index.js

@@ -154,7 +154,7 @@ import {
   inferKind,
   registerBuiltinComponents,
   useFormContext
-} from "../chunk-7VQS23L5.js";
+} from "../chunk-HSQJWJDS.js";
 import {
   ICONS,
   Icon,

package/dist/index.cjs

@@ -4631,6 +4631,7 @@ var import_jsx_runtime67 = require("react/jsx-runtime");
 function Field2({
   label,
   required,
+  labelHint,
   description,
   error,
   children,
@@ -4638,6 +4639,8 @@ function Field2({
   style,
   labelClassName,
   labelStyle,
+  labelHintClassName,
+  labelHintStyle,
   controlClassName,
   controlStyle,
   descriptionClassName,
@@ -4646,18 +4649,32 @@ function Field2({
   errorStyle
 }) {
   return /* @__PURE__ */ (0, import_jsx_runtime67.jsxs)(Field, { className, style, children: [
-    label ? /* @__PURE__ */ (0, import_jsx_runtime67.jsxs)(FieldLabel, { className: labelClassName, style: labelStyle, children: [
-      required ? /* @__PURE__ */ (0, import_jsx_runtime67.jsxs)("span", { "aria-hidden": true, className: "text-destructive", children: [
-        "*",
-        " "
-      ] }) : null,
-      label
+    label || labelHint ? /* @__PURE__ */ (0, import_jsx_runtime67.jsxs)("div", { className: "flex w-full items-center justify-between gap-2", children: [
+      label ? /* @__PURE__ */ (0, import_jsx_runtime67.jsxs)(FieldLabel, { className: labelClassName, style: labelStyle, children: [
+        required ? /* @__PURE__ */ (0, import_jsx_runtime67.jsxs)("span", { "aria-hidden": true, className: "text-destructive", children: [
+          "*",
+          " "
+        ] }) : null,
+        label
+      ] }) : /* @__PURE__ */ (0, import_jsx_runtime67.jsx)("span", {}),
+      labelHint ? /* @__PURE__ */ (0, import_jsx_runtime67.jsx)(
+        "span",
+        {
+          "data-slot": "field-label-hint",
+          className: cn(
+            "shrink-0 text-xs leading-none text-muted-foreground",
+            labelHintClassName
+          ),
+          style: labelHintStyle,
+          children: labelHint
+        }
+      ) : null
     ] }) : null,
     /* @__PURE__ */ (0, import_jsx_runtime67.jsx)(
       "div",
       {
         "data-slot": "field-control",
-        className: cn(label ? "mt-2" : void 0, controlClassName),
+        className: cn(label || labelHint ? "mt-2" : void 0, controlClassName),
         style: controlStyle,
         children
       }

package/dist/index.js

@@ -154,7 +154,7 @@ import {
   inferKind,
   registerBuiltinComponents,
   useFormContext
-} from "./chunk-7VQS23L5.js";
+} from "./chunk-HSQJWJDS.js";
 import {
   InteractionProvider,
   OVERLAY_CANCEL_PAYLOAD,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pactor-app/ui",
-  "version": "1.25.0",
+  "version": "1.26.0",
   "description": "Pactor UI kit (shadcn): the single built-in UI kit — vendored shadcn/ui components (Base UI primitives + cva + tailwind-merge + lucide-react), props contracts, interaction core (OverlayManager / UiBridge) and layouts, with build-time Tailwind v4 prebuilt styles.css (zero consumer-side Tailwind config)",
   "keywords": [
     "pactor",
@@ -107,11 +107,11 @@
     "react-resizable-panels": "^4.12.3",
     "tailwind-merge": "^3.6.0",
     "vaul": "^1.1.2",
-    "@pactor-app/core": "1.25.0",
-    "@pactor-app/router": "1.25.0",
-    "@pactor-app/markdown": "1.25.0",
-    "@pactor-app/permission": "1.25.0",
-    "@pactor-app/runtime": "1.25.0"
+    "@pactor-app/core": "1.26.0",
+    "@pactor-app/runtime": "1.26.0",
+    "@pactor-app/permission": "1.26.0",
+    "@pactor-app/router": "1.26.0",
+    "@pactor-app/markdown": "1.26.0"
   },
   "peerDependencies": {
     "react": ">=18",