@yugu-ui/flow-ui 0.0.0-stage → 0.1.1

package/dist/person-selector/api/index.d.ts

@@ -0,0 +1,4 @@
+import { PersonSelectorData } from '../types';
+export declare const getCachedData: () => PersonSelectorData | null;
+export declare const fetchPersonData: () => Promise<PersonSelectorData>;
+export declare const revalidatePersonData: () => Promise<PersonSelectorData>;

package/dist/person-selector/composables/useOverflowTags.d.ts

@@ -0,0 +1,13 @@
+interface UseOverflowTagsOptions {
+    /** 是否启用溢出测量（displayMode === 'overflow'） */
+    enabled: () => boolean;
+    /** 已选项总数（resolvedSelected.length） */
+    itemCount: () => number;
+}
+export declare function useOverflowTags(options: UseOverflowTagsOptions): {
+    triggerRef: import('vue').Ref<HTMLElement | null, HTMLElement | null>;
+    visibleCount: import('vue').Ref<number, number>;
+    overflowCount: import('vue').ComputedRef<number>;
+    setTagRef: (el: unknown, idx: number) => void;
+};
+export {};

package/dist/person-selector/composables/usePersonData.d.ts

@@ -0,0 +1,40 @@
+import { PersonItem, PersonSelectorData } from '../types';
+export declare function usePersonData(): {
+    depts: import('vue').Ref<{
+        id: string;
+        name: string;
+        isDisabled: boolean;
+    }[], import('../types').DeptItem[] | {
+        id: string;
+        name: string;
+        isDisabled: boolean;
+    }[]>;
+    roles: import('vue').Ref<{
+        id: string;
+        name: string;
+        isDisabled: boolean;
+    }[], import('../types').RoleItem[] | {
+        id: string;
+        name: string;
+        isDisabled: boolean;
+    }[]>;
+    people: import('vue').Ref<{
+        id: string;
+        name: string;
+        deptId: string;
+        roleIds: string[];
+        isDisabled: boolean;
+    }[], PersonItem[] | {
+        id: string;
+        name: string;
+        deptId: string;
+        roleIds: string[];
+        isDisabled: boolean;
+    }[]>;
+    loading: import('vue').Ref<boolean, boolean>;
+    ensureData: () => Promise<PersonSelectorData>;
+    refreshData: () => Promise<PersonSelectorData>;
+    peopleByDept: import('vue').ComputedRef<Map<string, PersonItem[]>>;
+    peopleByRole: import('vue').ComputedRef<Map<string, PersonItem[]>>;
+    deptNameById: import('vue').ComputedRef<Map<string, string>>;
+};

package/dist/person-selector/composables/useSelection.d.ts

@@ -0,0 +1,42 @@
+import { Ref } from 'vue';
+import { DeptItem, PersonItem, ResolvedItem, RoleItem, SelectableType, SelectedItem } from '../types';
+interface UseSelectionOptions {
+    modelValue: () => SelectedItem[];
+    depts: Ref<DeptItem[]>;
+    roles: Ref<RoleItem[]>;
+    people: Ref<PersonItem[]>;
+    /** 弹窗打开期间暂停外部 modelValue 同步，避免用户编辑被外部变化覆盖 */
+    paused?: () => boolean;
+    /** 确认提交回调（组件内在此触发 update:modelValue / change） */
+    onChange: (value: SelectedItem[]) => void;
+}
+export declare function useSelection(options: UseSelectionOptions): {
+    localSelected: Ref<{
+        type: SelectableType;
+        id: string;
+        name?: string | undefined;
+    }[], SelectedItem[] | {
+        type: SelectableType;
+        id: string;
+        name?: string | undefined;
+    }[]>;
+    resolvedSelected: import('vue').ComputedRef<ResolvedItem[]>;
+    resolvedLocalSelected: import('vue').ComputedRef<ResolvedItem[]>;
+    isSelected: (type: SelectableType, id: string) => boolean;
+    isDeptDisabled: (deptId: string) => boolean;
+    isRoleDisabled: (roleId: string) => boolean;
+    isPersonStopDisabled: (personId: string) => boolean;
+    isPersonCovered: (personId: string) => boolean;
+    personCoverSource: (personId: string) => {
+        label: string;
+        kind: "dept" | "role";
+    } | null;
+    addItems: (items: SelectedItem[]) => void;
+    removeMany: (items: SelectedItem[]) => void;
+    toggleItem: (item: SelectedItem) => void;
+    removeLocal: (item: SelectedItem) => void;
+    clearAll: () => void;
+    resetLocal: () => void;
+    commit: () => void;
+};
+export {};

package/dist/person-selector/constants/index.d.ts

@@ -0,0 +1,5 @@
+import { SelectableType } from '../types';
+export declare const TYPE_COLORS: Record<SelectableType, string>;
+export declare const TYPE_LABELS: Record<SelectableType, string>;
+export declare const SEARCH_LABELS: Record<SelectableType, string>;
+export declare const AVATAR_PALETTE: string[];

package/dist/person-selector/index.d.ts

@@ -0,0 +1,21 @@
+import { SelectedItem, SelectableType } from './types';
+type __VLS_Props = {
+    modelValue?: SelectedItem[];
+    selectableTypes?: SelectableType[];
+    placeholder?: string;
+    displayMode?: 'wrap' | 'overflow';
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    change: (value: SelectedItem[]) => any;
+    "update:modelValue": (value: SelectedItem[]) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onChange?: ((value: SelectedItem[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: SelectedItem[]) => any) | undefined;
+}>, {
+    placeholder: string;
+    modelValue: SelectedItem[];
+    selectableTypes: SelectableType[];
+    displayMode: "wrap" | "overflow";
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/person-selector/types/index.d.ts

@@ -0,0 +1,35 @@
+export type SelectableType = 'person' | 'role' | 'dept';
+export interface SelectedItem {
+    type: SelectableType;
+    id: string;
+    /** 名称：组件确认时从选人字典解析带出；外部旧数据（type+id）可缺省 */
+    name?: string;
+}
+export type ResolvedItem = SelectedItem & {
+    name: string;
+};
+export interface DeptItem {
+    id: string;
+    name: string;
+    /** 是否停用：true-停用；false-正常（来自接口 is_disabled） */
+    isDisabled: boolean;
+}
+export interface RoleItem {
+    id: string;
+    name: string;
+    /** 是否停用：true-停用；false-正常（来自接口 is_disabled） */
+    isDisabled: boolean;
+}
+export interface PersonItem {
+    id: string;
+    name: string;
+    deptId: string;
+    roleIds: string[];
+    /** 是否停用：true-停用；false-正常（来自接口 is_disabled） */
+    isDisabled: boolean;
+}
+export interface PersonSelectorData {
+    depts: DeptItem[];
+    roles: RoleItem[];
+    people: PersonItem[];
+}

package/dist/person-selector/utils/index.d.ts

@@ -0,0 +1,5 @@
+import { ResolvedItem, SelectedItem, SelectableType } from '../types';
+export declare const itemKey: (item: SelectedItem) => string;
+export declare const typeChar: (item: ResolvedItem) => string;
+export declare const typeColor: (type: SelectableType) => string;
+export declare const avatarColor: (id: string) => string;

package/dist/provider/index.d.ts

@@ -0,0 +1,25 @@
+import { App } from 'vue';
+import { FlowUIConfig, FlowUIOptions } from './types';
+export type { FlowUIComponents, FlowUIConfig, FlowUIOptions, FlowUIRequest, FlowUIRequestConfig, FlowUIResponse, PersonSelectorApi, PersonSelectorRawData } from './types';
+export { FLOW_UI_KEY } from './key';
+/** createFlowUI 返回的 Vue 插件实例（供 app.use 使用） */
+export interface FlowUIInstance {
+    install(app: App): void;
+}
+/** 非 setup 上下文（adapter 层等）读取注入配置：未注入时 DEV 告警一次并返回兜底配置（不抛错） */
+export declare function getFlowUIConfig(): FlowUIConfig;
+/**
+ * 流程组件库注入入口：`app.use(createFlowUI({ request, getToken?, baseURL?, personSelectorApi? }))`
+ * - `request`：宿主请求实例（平面函数式，返回 `{ data, error }`），包内全部接口改走它；
+ * - `getToken`：返回完整 Authorization 头值（如 `Bearer xxx`），供包内原生 fetch 场景使用；
+ * - `baseURL`：后端接口基础路径，远程选项相对 action 拼接用；
+ * - `personSelectorApi`：人员选择器数据源，默认请求 GET /system/person-selector。
+ * - `components`：能力组件注入（如附件上传组件），包内以动态组件消费，未注入时对应能力降级提示。
+ * Developed collaboratively with vscode - 改动代码行数: 1行（2.12 宿主全局组件解耦：注入入口文档补能力组件说明）
+ */
+export declare function createFlowUI(options: FlowUIOptions): FlowUIInstance;
+/**
+ * 组件内读取注入配置（须在 setup 上下文调用）：
+ * 未注入时 DEV 告警一次并返回兜底配置（不抛错，请求走 error 分支降级）。
+ */
+export declare function useFlowUI(): FlowUIConfig;

package/dist/provider/key.d.ts

@@ -0,0 +1,4 @@
+import { InjectionKey } from 'vue';
+import { FlowUIConfig } from './types';
+/** 注入 key：应用内唯一（Symbol），组件统一经 useFlowUI() 读取 */
+export declare const FLOW_UI_KEY: InjectionKey<FlowUIConfig>;

package/dist/provider/types.d.ts

@@ -0,0 +1,68 @@
+import { Component } from 'vue';
+/** 请求配置（axios 风格子集，包内仅用到 url/method/params/data） */
+export interface FlowUIRequestConfig {
+    url: string;
+    method?: 'get' | 'post' | 'put' | 'delete' | 'patch';
+    params?: Record<string, unknown>;
+    data?: unknown;
+}
+/** 平面请求响应结构（与宿主 request 实例一致：data + error，不抛异常） */
+export interface FlowUIResponse<T = unknown> {
+    data: T | null;
+    error: unknown;
+}
+/**
+ * 宿主请求实例最小结构（平面函数式）。
+ * 要求自带 tenant_no/operator 填充与统一错误处理（401 提示、错误 toast），
+ * 包内所有接口调用均改走该实例，不再依赖宿主 service 层。
+ */
+export type FlowUIRequest = <T = unknown>(config: FlowUIRequestConfig) => Promise<FlowUIResponse<T>>;
+/** 人员选择器原始数据（GET /system/person-selector 响应 data，snake_case 原样） */
+export interface PersonSelectorRawData {
+    depts: Array<{
+        id: number;
+        name: string;
+        is_disabled: boolean;
+    }>;
+    roles: Array<{
+        id: number;
+        name: string;
+        is_disabled: boolean;
+    }>;
+    people: Array<{
+        id: number;
+        name: string;
+        dept_id: number;
+        role_ids: number[];
+        is_disabled: boolean;
+    }>;
+}
+/** 人员选择器数据源函数（宿主可覆盖；默认实现走注入 request 请求 /system/person-selector） */
+export type PersonSelectorApi = () => Promise<FlowUIResponse<PersonSelectorRawData>>;
+/** 宿主能力组件（可选注入）：包内以动态组件渲染，未注入对应槽位时该能力降级提示 */
+export interface FlowUIComponents {
+    /** 附件上传组件：须支持 v-model（附件数组）与 upload-type/drag props */
+    FileUpload?: Component;
+}
+/** 注入选项（宿主 app.use(createFlowUI(options)) 传入） */
+export interface FlowUIOptions {
+    /** 宿主请求实例（必填）：包内 wflow/PersonSelector 等接口全部改走它 */
+    request: FlowUIRequest;
+    /** 鉴权头获取函数：返回完整 Authorization 头值（如 `Bearer xxx`），供包内原生 fetch 等场景使用；缺省视为未登录 */
+    getToken?: () => string;
+    /** 后端接口基础路径：远程选项 action 为相对路径时拼接（对应宿主 VITE_SERVICE_BASE_URL） */
+    baseURL?: string;
+    /** 人员选择器数据源：默认 GET /system/person-selector，宿主可自定义覆盖 */
+    personSelectorApi?: PersonSelectorApi;
+    /** 能力组件注入：附件上传等宿主专属组件 */
+    components?: FlowUIComponents;
+}
+/** 解析后的注入配置（包内 useFlowUI 返回，全部字段有兜底值） */
+export interface FlowUIConfig {
+    request: FlowUIRequest;
+    getToken: () => string;
+    baseURL: string;
+    personSelectorApi: PersonSelectorApi;
+    /** 能力组件（未注入为空对象，对应能力降级提示） */
+    components: FlowUIComponents;
+}