@manohub/app-kit 0.1.0

package/dist/atoms/app-select.d.ts

@@ -0,0 +1,106 @@
+import { type PropType } from 'vue';
+export interface AppSelectOption {
+    label: string;
+    value: string | number;
+    disabled?: boolean;
+}
+export type AppSelectValue = string | number | null;
+/**
+ * 下拉选择框（封装 farris FComboList）。
+ *
+ * farris 侧需要 `data` + `valueField` + `textField` + `enumValueType` 四件套，
+ * 且**漏设 `valueField` / `enumValueType` 会导致选中值被整体静默丢弃**（本仓已多次踩到：
+ * skill-admission 筛选栏、skill-auth 规则行、mcp 分类与所属服务选择）。
+ * 本组件对外只暴露 `options` + `modelValue`，内部完成全部翻译，并固定 `editable: false`
+ * （farris 默认可输入态会与外部受控值不同步）。
+ *
+ * @example
+ * <AppSelect modelValue={topic} options={topics.map(t => ({ label: t.name, value: t.code }))}
+ *   placeholder="请选择" clearable onChange={(v) => (topic = v)} />
+ */
+export declare const AppSelect: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    modelValue: {
+        type: PropType<AppSelectValue>;
+        default: null;
+    };
+    /** 业务选项；内部翻译为 farris 的 data + valueField/textField */
+    options: {
+        type: PropType<AppSelectOption[]>;
+        default: () => never[];
+    };
+    placeholder: {
+        type: StringConstructor;
+        default: string;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    readonly: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    clearable: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * 浮层宿主元素：抽屉 / 滚动容器内必须指定，否则浮层会被容器的 overflow 裁切
+     * （mcp 配置抽屉已踩）。传普通 DOM 元素，非 farris 专属概念。
+     */
+    popupHost: {
+        type: () => HTMLElement | undefined;
+        default: undefined;
+    };
+    onChange: {
+        type: PropType<(value: AppSelectValue) => void>;
+        default: undefined;
+    };
+}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    modelValue: {
+        type: PropType<AppSelectValue>;
+        default: null;
+    };
+    /** 业务选项；内部翻译为 farris 的 data + valueField/textField */
+    options: {
+        type: PropType<AppSelectOption[]>;
+        default: () => never[];
+    };
+    placeholder: {
+        type: StringConstructor;
+        default: string;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    readonly: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    clearable: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * 浮层宿主元素：抽屉 / 滚动容器内必须指定，否则浮层会被容器的 overflow 裁切
+     * （mcp 配置抽屉已踩）。传普通 DOM 元素，非 farris 专属概念。
+     */
+    popupHost: {
+        type: () => HTMLElement | undefined;
+        default: undefined;
+    };
+    onChange: {
+        type: PropType<(value: AppSelectValue) => void>;
+        default: undefined;
+    };
+}>> & Readonly<{}>, {
+    onChange: (value: AppSelectValue) => void;
+    disabled: boolean;
+    modelValue: AppSelectValue;
+    placeholder: string;
+    readonly: boolean;
+    clearable: boolean;
+    options: AppSelectOption[];
+    popupHost: HTMLElement | undefined;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/atoms/app-select.js

@@ -0,0 +1,74 @@
+import { defineComponent, createVNode, mergeProps } from "vue";
+import { FComboList } from "@farris/ui-vue";
+const AppSelect = /* @__PURE__ */ defineComponent({
+  name: "AppSelect",
+  inheritAttrs: false,
+  props: {
+    modelValue: {
+      type: [String, Number],
+      default: null
+    },
+    /** 业务选项；内部翻译为 farris 的 data + valueField/textField */
+    options: {
+      type: Array,
+      default: () => []
+    },
+    placeholder: {
+      type: String,
+      default: ""
+    },
+    disabled: {
+      type: Boolean,
+      default: false
+    },
+    readonly: {
+      type: Boolean,
+      default: false
+    },
+    clearable: {
+      type: Boolean,
+      default: false
+    },
+    /**
+     * 浮层宿主元素：抽屉 / 滚动容器内必须指定，否则浮层会被容器的 overflow 裁切
+     * （mcp 配置抽屉已踩）。传普通 DOM 元素，非 farris 专属概念。
+     */
+    popupHost: {
+      type: Object,
+      default: void 0
+    },
+    onChange: {
+      type: Function,
+      default: void 0
+    }
+  },
+  setup(props, {
+    attrs
+  }) {
+    return () => createVNode(FComboList, mergeProps(attrs.class ? {
+      customClass: attrs.class
+    } : {}, {
+      "data": props.options.map((o) => ({
+        value: o.value,
+        name: o.label,
+        disabled: o.disabled
+      })),
+      "valueField": "value",
+      "textField": "name",
+      "enumValueType": "string",
+      "editable": false,
+      "enableClear": props.clearable,
+      "disabled": props.disabled,
+      "readonly": props.readonly,
+      "placeholder": props.placeholder,
+      "fitEditor": true,
+      "minPanelWidth": 0,
+      "modelValue": props.modelValue,
+      "popupHost": props.popupHost,
+      "onUpdate:modelValue": (value) => props.onChange?.(value ?? null)
+    }), null);
+  }
+});
+export {
+  AppSelect
+};

package/dist/atoms/app-switch.d.ts

@@ -0,0 +1,72 @@
+import { type PropType } from 'vue';
+import type { AppControlSize } from './app-button';
+/**
+ * 开关（封装 farris FSwitch）。
+ *
+ * farris 的坑在内部消化：FSwitch 点击后即切换内部视觉态；父级阻断（不接收新值）时
+ * 视觉无法回退，现状靠外部递增 key 强制重建。本组件把该 workaround 收进来 ——
+ * onChange 返回 false / Promise<false> / Promise reject 时，内部自动回退视觉。
+ *
+ * @example
+ * // 异步提交：失败自动回退视觉
+ * <AppSwitch modelValue={item.enabled}
+ *   onChange={(v) => updateMutation.mutateAsync({ id: item.id, request: { enabled: v } })} />
+ * // 同步阻断：返回 false
+ * <AppSwitch modelValue={enabled.value} onChange={(v) => canToggle() ? (enabled.value = v) : false} />
+ */
+export declare const AppSwitch: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    modelValue: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    size: {
+        type: PropType<AppControlSize>;
+        default: string;
+    };
+    /**
+     * 值变更回调。返回值决定视觉是否保留：
+     * - 返回 false：同步阻断，视觉立即回退
+     * - 返回 Promise：resolve false 或 reject 时视觉回退（异步提交失败场景）
+     * - 返回 true / undefined / void：视觉保留
+     */
+    onChange: {
+        type: PropType<(v: boolean) => boolean | void | Promise<boolean | void>>;
+        default: undefined;
+    };
+}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    'update:modelValue': (v: boolean) => true;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    modelValue: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    size: {
+        type: PropType<AppControlSize>;
+        default: string;
+    };
+    /**
+     * 值变更回调。返回值决定视觉是否保留：
+     * - 返回 false：同步阻断，视觉立即回退
+     * - 返回 Promise：resolve false 或 reject 时视觉回退（异步提交失败场景）
+     * - 返回 true / undefined / void：视觉保留
+     */
+    onChange: {
+        type: PropType<(v: boolean) => boolean | void | Promise<boolean | void>>;
+        default: undefined;
+    };
+}>> & Readonly<{
+    "onUpdate:modelValue"?: ((v: boolean) => any) | undefined;
+}>, {
+    onChange: (v: boolean) => boolean | void | Promise<boolean | void>;
+    size: AppControlSize;
+    disabled: boolean;
+    modelValue: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/atoms/app-switch.js

@@ -0,0 +1,66 @@
+import { defineComponent, ref, createVNode } from "vue";
+import { FSwitch } from "@farris/ui-vue";
+const AppSwitch = /* @__PURE__ */ defineComponent({
+  name: "AppSwitch",
+  inheritAttrs: false,
+  props: {
+    modelValue: {
+      type: Boolean,
+      default: false
+    },
+    disabled: {
+      type: Boolean,
+      default: false
+    },
+    size: {
+      type: String,
+      default: "sm"
+    },
+    /**
+     * 值变更回调。返回值决定视觉是否保留：
+     * - 返回 false：同步阻断，视觉立即回退
+     * - 返回 Promise：resolve false 或 reject 时视觉回退（异步提交失败场景）
+     * - 返回 true / undefined / void：视觉保留
+     */
+    onChange: {
+      type: Function,
+      default: void 0
+    }
+  },
+  emits: {
+    "update:modelValue": (v) => true
+  },
+  setup(props, {
+    emit,
+    attrs
+  }) {
+    const remountKey = ref(0);
+    const handleChange = (v) => {
+      emit("update:modelValue", v);
+      const result = props.onChange?.(v);
+      if (result === false) {
+        remountKey.value++;
+        return;
+      }
+      if (result && typeof result.then === "function") {
+        result.then((ok) => {
+          if (ok === false) remountKey.value++;
+        }).catch(() => {
+          remountKey.value++;
+        });
+      }
+    };
+    return () => createVNode(FSwitch, {
+      "key": `${remountKey.value}:${props.modelValue}`,
+      "modelValue": props.modelValue,
+      "size": props.size === "sm" ? "small" : props.size === "lg" ? "large" : "medium",
+      "disabled": props.disabled,
+      "onUpdate:modelValue": handleChange,
+      "customClass": attrs.class,
+      "customStyle": attrs.style
+    }, null);
+  }
+});
+export {
+  AppSwitch
+};

package/dist/atoms/app-textarea.d.ts

@@ -0,0 +1,89 @@
+import { type PropType } from 'vue';
+/**
+ * 多行文本（封装 farris FTextarea）。
+ *
+ * 内部固定 `updateOn="change"`：farris `useTextBox` 只认 `blur | change`，
+ * 缺省 `blur` 会让受控值在输入过程中不同步（本仓已在 topic-dialog、拒绝原因等处的注释中记录）。
+ *
+ * @example
+ * <AppTextarea modelValue={reason} rows={4} maxLength={500} showCount
+ *   placeholder="请填写拒绝原因" onChange={(v) => (reason = v)} />
+ */
+export declare const AppTextarea: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    modelValue: {
+        type: StringConstructor;
+        default: string;
+    };
+    rows: {
+        type: NumberConstructor;
+        default: number;
+    };
+    maxLength: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    /** 右下角字数统计（超出 maxLength 时可配合 showCount 提示） */
+    showCount: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    placeholder: {
+        type: StringConstructor;
+        default: string;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    readonly: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    onChange: {
+        type: PropType<(value: string) => void>;
+        default: undefined;
+    };
+}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    modelValue: {
+        type: StringConstructor;
+        default: string;
+    };
+    rows: {
+        type: NumberConstructor;
+        default: number;
+    };
+    maxLength: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    /** 右下角字数统计（超出 maxLength 时可配合 showCount 提示） */
+    showCount: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    placeholder: {
+        type: StringConstructor;
+        default: string;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    readonly: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    onChange: {
+        type: PropType<(value: string) => void>;
+        default: undefined;
+    };
+}>> & Readonly<{}>, {
+    onChange: (value: string) => void;
+    disabled: boolean;
+    modelValue: string;
+    placeholder: string;
+    readonly: boolean;
+    rows: number;
+    maxLength: number;
+    showCount: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/atoms/app-textarea.js

@@ -0,0 +1,61 @@
+import { defineComponent, createVNode, mergeProps } from "vue";
+import { FTextarea } from "@farris/ui-vue";
+const AppTextarea = /* @__PURE__ */ defineComponent({
+  name: "AppTextarea",
+  inheritAttrs: false,
+  props: {
+    modelValue: {
+      type: String,
+      default: ""
+    },
+    rows: {
+      type: Number,
+      default: 4
+    },
+    maxLength: {
+      type: Number,
+      default: void 0
+    },
+    /** 右下角字数统计（超出 maxLength 时可配合 showCount 提示） */
+    showCount: {
+      type: Boolean,
+      default: false
+    },
+    placeholder: {
+      type: String,
+      default: ""
+    },
+    disabled: {
+      type: Boolean,
+      default: false
+    },
+    readonly: {
+      type: Boolean,
+      default: false
+    },
+    onChange: {
+      type: Function,
+      default: void 0
+    }
+  },
+  setup(props, {
+    attrs
+  }) {
+    return () => createVNode(FTextarea, mergeProps(attrs.class ? {
+      customClass: attrs.class
+    } : {}, {
+      "modelValue": props.modelValue,
+      "rows": props.rows,
+      "maxLength": props.maxLength,
+      "showCount": props.showCount,
+      "placeholder": props.placeholder,
+      "disabled": props.disabled,
+      "readonly": props.readonly,
+      "updateOn": "change",
+      "onUpdate:modelValue": (value) => props.onChange?.(value ?? "")
+    }), null);
+  }
+});
+export {
+  AppTextarea
+};

package/dist/atoms/app-tooltip.d.ts

@@ -0,0 +1,70 @@
+import { type PropType, type SlotsType, type VNodeChild } from 'vue';
+export type AppTooltipPlacement = 'top' | 'bottom' | 'left' | 'right';
+export type AppTooltipTrigger = 'hover' | 'click';
+/**
+ * 文字提示（封装 farris FTooltip）。
+ *
+ * 吃掉两个 farris 坑：
+ * 1. `content` 的类型声明是 `ObjectConstructor`，实际支持字符串 —— 类型面必须断言，
+ *    调用方不必再写 `content={text as any}`（本仓 overflow-tooltip 与批量向导各处都写过）。
+ * 2. 浮层定位属性会被 farris 自身规则覆盖导致微前端下偏移，修复规则收敛在
+ *    app-kit 的 `farris-bridge.css`（`.app-container .fv-tooltip`），应用侧不再各写补丁。
+ *
+ * 默认挂 `ak-tooltip` 外观类；`class` 载荷可叠加自定义主题类。
+ *
+ * @example
+ * <AppTooltip content={fileName} placement="top"><span class="truncate">{fileName}</span></AppTooltip>
+ */
+export declare const AppTooltip: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    content: {
+        type: StringConstructor;
+        default: string;
+    };
+    placement: {
+        type: PropType<AppTooltipPlacement>;
+        default: string;
+    };
+    trigger: {
+        type: PropType<AppTooltipTrigger>;
+        default: string;
+    };
+    /** 固定宽度，如 '200px'（设置后解除最大宽度限制） */
+    width: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    content: {
+        type: StringConstructor;
+        default: string;
+    };
+    placement: {
+        type: PropType<AppTooltipPlacement>;
+        default: string;
+    };
+    trigger: {
+        type: PropType<AppTooltipTrigger>;
+        default: string;
+    };
+    /** 固定宽度，如 '200px'（设置后解除最大宽度限制） */
+    width: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>> & Readonly<{}>, {
+    width: string;
+    disabled: boolean;
+    content: string;
+    placement: AppTooltipPlacement;
+    trigger: AppTooltipTrigger;
+}, SlotsType<{
+    default?: () => VNodeChild;
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/atoms/app-tooltip.js

@@ -0,0 +1,48 @@
+import { defineComponent, createVNode } from "vue";
+import { FTooltip } from "@farris/ui-vue";
+const AppTooltip = /* @__PURE__ */ defineComponent({
+  name: "AppTooltip",
+  inheritAttrs: false,
+  props: {
+    content: {
+      type: String,
+      default: ""
+    },
+    placement: {
+      type: String,
+      default: "top"
+    },
+    trigger: {
+      type: String,
+      default: "hover"
+    },
+    /** 固定宽度，如 '200px'（设置后解除最大宽度限制） */
+    width: {
+      type: String,
+      default: void 0
+    },
+    disabled: {
+      type: Boolean,
+      default: false
+    }
+  },
+  slots: Object,
+  setup(props, {
+    slots,
+    attrs
+  }) {
+    return () => createVNode(FTooltip, {
+      "content": props.content,
+      "placement": props.placement,
+      "trigger": props.trigger,
+      "width": props.width,
+      "enable": !props.disabled,
+      "customClass": ["ak-tooltip", attrs.class].filter(Boolean).join(" ")
+    }, {
+      default: () => [slots.default?.()]
+    });
+  }
+});
+export {
+  AppTooltip
+};