@apform-ui/core 1.10.26 → 1.10.29

package/dist/components/PropertyField/PropertyField.vue.d.ts

@@ -0,0 +1,48 @@
+import { FetchRemoteOptionsFn, PropertyArrayEditorMode, PropertyFieldType, PropertySelectOption } from '../PropertyPanel/types';
+type __VLS_Props = {
+    /** 字段键 */
+    keyName: string;
+    /** 标签 */
+    label: string;
+    /** 控件类型 */
+    type: PropertyFieldType;
+    /** 当前值 */
+    value: unknown;
+    /** 提示 */
+    desc?: string;
+    /** 占位 */
+    placeholder?: string;
+    /** 静态选项 */
+    options?: PropertySelectOption[];
+    /** 远程 URL */
+    remoteUrl?: string;
+    labelField?: string;
+    valueField?: string;
+    min?: number;
+    max?: number;
+    required?: boolean;
+    /** array-editor 行模式 */
+    arrayMode?: PropertyArrayEditorMode;
+    /** 覆盖 inject 的远程拉取 */
+    fetchRemoteOptions?: FetchRemoteOptionsFn;
+};
+declare var __VLS_6: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_6) => any;
+};
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    update: (value: unknown) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onUpdate?: ((value: unknown) => any) | undefined;
+}>, {
+    labelField: string;
+    valueField: string;
+    arrayMode: PropertyArrayEditorMode;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/PropertyField/doc.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../../docs/types';
+/** PropertyField 文档 */
+export declare const PropertyFieldDoc: ComponentDoc;

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

@@ -0,0 +1 @@
+export { default as PropertyField } from './PropertyField.vue';

package/dist/components/PropertyPanel/PropertyPanel.vue.d.ts

@@ -0,0 +1,34 @@
+import { FetchRemoteOptionsFn, PropertyItem, PropertySection, PropertyUpdatePayload } from './types';
+type __VLS_Props = {
+    /** 分区列表 */
+    sections: PropertySection[];
+    /** 远程下拉拉取（可选） */
+    fetchRemoteOptions?: FetchRemoteOptionsFn;
+    /** 空态文案 */
+    emptyText?: string;
+    /**
+     * 当前属性值字典；传入后按各 item 的 visibleOn 过滤
+     * （键可与字段 key 对齐，也支持点路径读取）
+     */
+    values?: Record<string, unknown>;
+};
+declare var __VLS_10: `field-${string & {}}`, __VLS_11: {
+    item: PropertyItem;
+    section: PropertySection;
+    update: (value: unknown) => void;
+};
+type __VLS_Slots = {} & {
+    [K in NonNullable<typeof __VLS_10>]?: (props: typeof __VLS_11) => any;
+};
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    update: (payload: PropertyUpdatePayload) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onUpdate?: ((payload: PropertyUpdatePayload) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/PropertyPanel/doc.d.ts

@@ -0,0 +1,3 @@
+import { ComponentDoc } from '../../docs/types';
+/** PropertyPanel 文档 */
+export declare const PropertyPanelDoc: ComponentDoc;

package/dist/components/PropertyPanel/editors/ArrayListEditor.vue.d.ts

@@ -0,0 +1,19 @@
+export type ArrayListMode = 'string' | 'label-value';
+type __VLS_Props = {
+    /** 当前数组 */
+    value: unknown;
+    /**
+     * 行模式：
+     * - string：字符串列表
+     * - label-value：{ label, value } 对象列表
+     */
+    mode?: ArrayListMode;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    update: (value: unknown[]) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onUpdate?: ((value: unknown[]) => any) | undefined;
+}>, {
+    mode: ArrayListMode;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/PropertyPanel/editors/NumberArrayEditor.vue.d.ts

@@ -0,0 +1,17 @@
+type __VLS_Props = {
+    /** 当前数值数组 */
+    value: unknown;
+    /** 下限 */
+    min?: number;
+    /** 上限 */
+    max?: number;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    update: (value: number[]) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onUpdate?: ((value: number[]) => any) | undefined;
+}>, {
+    min: number;
+    max: number;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/PropertyPanel/editors/OptionsListEditor.vue.d.ts

@@ -0,0 +1,14 @@
+export interface OptionDictItem {
+    label: string;
+    value: string | number;
+}
+type __VLS_Props = {
+    /** 当前选项数组 */
+    value: unknown;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    update: (value: OptionDictItem[]) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onUpdate?: ((value: OptionDictItem[]) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -0,0 +1,3 @@
+export { default as PropertyPanel } from './PropertyPanel.vue';
+export * from './types';
+export { evalVisibleOn, filterVisiblePropertyItems, filterVisiblePropertySections, } from './visibleOn';

package/dist/components/PropertyPanel/types.d.ts

@@ -0,0 +1,79 @@
+/**
+ * PropertyPanel / PropertyField 共享类型与尺寸常量
+ *
+ * 独立于 editor widget / Pinia；消费方自行映射业务对象为 sections。
+ */
+/** 库内属性控件统一尺寸，避免各处 size 不一致（对齐 CSS `--apf-control-size`） */
+export declare const PROPERTY_CONTROL_SIZE: "small";
+/** 内置字段类型 */
+export type BuiltinPropertyFieldType = 'text' | 'textarea' | 'number' | 'switch' | 'color' | 'select' | 'remote-select' | 'json' | 'color-array' | 'options' | 'number-array' | 'array-editor';
+/** array-editor 行模式 */
+export type PropertyArrayEditorMode = 'string' | 'label-value';
+/** 字段类型：内置 + 自定义（自定义走 slot） */
+export type PropertyFieldType = BuiltinPropertyFieldType | (string & {});
+/** 下拉选项 */
+export interface PropertySelectOption {
+    label: string;
+    value: string | number | boolean;
+}
+/** 单行属性项 */
+export interface PropertyItem {
+    /** 字段键 */
+    key: string;
+    /** 标签 */
+    label: string;
+    /** 控件类型 */
+    type: PropertyFieldType;
+    /** 当前值 */
+    value: unknown;
+    /** 提示（label tooltip） */
+    desc?: string;
+    /** 占位文案 */
+    placeholder?: string;
+    /** select 选项 */
+    options?: PropertySelectOption[];
+    /** remote-select URL（由 fetchRemoteOptions 消费） */
+    remoteUrl?: string;
+    /** remote 标签字段名 */
+    labelField?: string;
+    /** remote 值字段名 */
+    valueField?: string;
+    /**
+     * 可见条件（可由 `evalVisibleOn` / `filterVisiblePropertyItems` 求值；
+     * PropertyPanel 传入 `values` 时自动过滤）
+     */
+    visibleOn?: string;
+    /** number / number-array 下限 */
+    min?: number;
+    /** number / number-array 上限 */
+    max?: number;
+    /** 必填标记 */
+    required?: boolean;
+    /**
+     * array-editor 行模式：
+     * - `string`（默认）：字符串列表
+     * - `label-value`：{ label, value } 对象列表
+     */
+    arrayMode?: PropertyArrayEditorMode;
+}
+/** 属性分区 */
+export interface PropertySection {
+    /** 分区键 */
+    key: string;
+    /** 分区标题 */
+    label: string;
+    /** 字段列表 */
+    items: PropertyItem[];
+    /** 默认是否展开 */
+    defaultOpen?: boolean;
+}
+/** PropertyPanel update 载荷 */
+export interface PropertyUpdatePayload {
+    sectionKey: string;
+    key: string;
+    value: unknown;
+}
+/** 远程选项拉取函数 */
+export type FetchRemoteOptionsFn = (url: string, labelField: string, valueField: string) => Promise<PropertySelectOption[]>;
+/** provide/inject key：远程选项 */
+export declare const PROPERTY_FETCH_REMOTE_KEY: "apfPropertyFetchRemote";

package/dist/components/PropertyPanel/visibleOn.d.ts

@@ -0,0 +1,20 @@
+import { PropertyItem, PropertySection } from './types';
+/**
+ * 安全求值 visibleOn 表达式
+ * @param expr 表达式；空则视为可见
+ * @param values 当前属性值字典
+ * @returns 是否可见；无法识别的表达式默认可见
+ */
+export declare function evalVisibleOn(expr: string | undefined | null, values: Record<string, unknown>): boolean;
+/**
+ * 按 visibleOn 过滤属性项
+ * @param items 属性项列表
+ * @param values 当前值字典
+ */
+export declare function filterVisiblePropertyItems(items: PropertyItem[], values: Record<string, unknown>): PropertyItem[];
+/**
+ * 按 visibleOn 过滤分区（空分区会剔除）
+ * @param sections 分区列表
+ * @param values 当前值字典
+ */
+export declare function filterVisiblePropertySections(sections: PropertySection[], values: Record<string, unknown>): PropertySection[];

package/dist/docs/index.d.ts

@@ -58,6 +58,8 @@ export { EmptyStateDoc } from '../components/EmptyState/doc';
 export { ErrorBoundaryDoc } from '../components/ErrorBoundary/doc';
 export { ExcelPreviewCardDoc } from '../components/ExcelPreviewCard/doc';
 export { FieldRowDoc } from '../components/FieldRow/doc';
+export { PropertyFieldDoc } from '../components/PropertyField/doc';
+export { PropertyPanelDoc } from '../components/PropertyPanel/doc';
 export { FilterBarDoc } from '../components/FilterBar/doc';
 export { FilterTabsDoc } from '../components/FilterTabs/doc';
 export { FormDialogDoc } from '../components/FormDialog/doc';

package/dist/index.d.ts

@@ -56,6 +56,10 @@ export { HintText } from './components/HintText';
 export { SectionToggle } from './components/SectionToggle';
 export { TruncatedTooltipText } from './components/TruncatedTooltipText';
 export { LoadingDots } from './components/LoadingDots';
+export { PropertyField } from './components/PropertyField';
+export { PropertyPanel } from './components/PropertyPanel';
+export type { BuiltinPropertyFieldType, FetchRemoteOptionsFn, PropertyArrayEditorMode, PropertyFieldType, PropertyItem, PropertySection, PropertySelectOption, PropertyUpdatePayload, } from './components/PropertyPanel';
+export { PROPERTY_CONTROL_SIZE, PROPERTY_FETCH_REMOTE_KEY, evalVisibleOn, filterVisiblePropertyItems, filterVisiblePropertySections, } from './components/PropertyPanel';
 export { JsonCard } from './components/JsonCard';
 export { JsonDetailDialog } from './components/JsonDetailDialog';
 export { SchemaLitePreview } from './components/SchemaLitePreview';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apform-ui/core",
-  "version": "1.10.26",
+  "version": "1.10.29",
   "type": "module",
   "author": "yangdongnan",
   "license": "MIT",

package/src/docs/index.ts

@@ -58,6 +58,8 @@ export { EmptyStateDoc } from '../components/EmptyState/doc'
 export { ErrorBoundaryDoc } from '../components/ErrorBoundary/doc'
 export { ExcelPreviewCardDoc } from '../components/ExcelPreviewCard/doc'
 export { FieldRowDoc } from '../components/FieldRow/doc'
+export { PropertyFieldDoc } from '../components/PropertyField/doc'
+export { PropertyPanelDoc } from '../components/PropertyPanel/doc'
 export { FilterBarDoc } from '../components/FilterBar/doc'
 export { FilterTabsDoc } from '../components/FilterTabs/doc'
 export { FormDialogDoc } from '../components/FormDialog/doc'
@@ -149,6 +151,8 @@ import { EmptyStateDoc } from '../components/EmptyState/doc'
 import { ErrorBoundaryDoc } from '../components/ErrorBoundary/doc'
 import { ExcelPreviewCardDoc } from '../components/ExcelPreviewCard/doc'
 import { FieldRowDoc } from '../components/FieldRow/doc'
+import { PropertyFieldDoc } from '../components/PropertyField/doc'
+import { PropertyPanelDoc } from '../components/PropertyPanel/doc'
 import { FilterBarDoc } from '../components/FilterBar/doc'
 import { FilterTabsDoc } from '../components/FilterTabs/doc'
 import { FormDialogDoc } from '../components/FormDialog/doc'
@@ -241,6 +245,8 @@ export const componentDocs: Record<string, ComponentDoc> = {
   ErrorBoundary: ErrorBoundaryDoc,
   ExcelPreviewCard: ExcelPreviewCardDoc,
   FieldRow: FieldRowDoc,
+  PropertyField: PropertyFieldDoc,
+  PropertyPanel: PropertyPanelDoc,
   FilterBar: FilterBarDoc,
   FilterTabs: FilterTabsDoc,
   FormDialog: FormDialogDoc,

package/src/tokens/tokens.css

@@ -141,6 +141,15 @@
   --apf-overlay-bg: rgba(0, 0, 0, 0.4);
 
   /* ---------- 尺寸 ---------- */
+  /*
+   * 控件尺寸语义 token（与 JS 常量 PROPERTY_CONTROL_SIZE = 'small' 对齐）
+   * Element Plus size 枚举：small / default / large；默认库内属性面板用 small。
+   */
+  --apf-control-size: small;
+  --apf-control-size-sm: small;
+  --apf-control-size-md: default;
+  --apf-control-size-lg: large;
+
   --apf-control-height-xs: 24px;
   --apf-control-height-sm: 28px;
   --apf-control-height-md: 32px;
@@ -332,6 +341,11 @@
   --shadow-lg: var(--apf-shadow-lg);
   --overlay-bg: var(--apf-overlay-bg);
 
+  --control-size: var(--apf-control-size);
+  --control-size-sm: var(--apf-control-size-sm);
+  --control-size-md: var(--apf-control-size-md);
+  --control-size-lg: var(--apf-control-size-lg);
+
   --control-height-xs: var(--apf-control-height-xs);
   --control-height-sm: var(--apf-control-height-sm);
   --control-height-md: var(--apf-control-height-md);