@piying-lib/angular-daisyui 1.2.0 → 1.2.1

package/field-control/index.d.ts

@@ -5,25 +5,44 @@ import * as _piying_lib_angular_core from '@piying-lib/angular-core';
 import { Color, Size, SelectOption, OptionConvert, ResolvedOption, StrOrTemplateComponent } from '@piying-lib/angular-core';
 import { CalendarDateProps, CalendarMultiProps, CalendarRangeProps } from 'cally';
 
+/**
+ * 复选框控件
+ *
+ * 提供单个复选框的勾选功能，支持确定、不确定两种状态。
+ * 常用于需要选择多个选项的场景。
+ */
 declare class CheckboxFCC extends BaseControl {
     #private;
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
-    indeterminate: _angular_core.InputSignal<boolean | undefined>;
+    /** 颜色主题 */
     color: _angular_core.InputSignal<Color | undefined>;
+    /** 尺寸大小 */
     size: _angular_core.InputSignal<Size | undefined>;
+    /** 是否为不确定状态 */
+    indeterminate: _angular_core.InputSignal<boolean | undefined>;
     wrapperClass$: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CheckboxFCC, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckboxFCC, "app-checkbox", never, { "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckboxFCC, "app-checkbox", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 文件上传控件
+ *
+ * 提供文件选择和上传功能，支持单文件和多文件选择。
+ * 适用于需要上传文件的表单场景。
+ */
 declare class FileInputFCC extends BaseControl {
     #private;
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
+    /** 颜色主题 */
     color: _angular_core.InputSignal<Color | undefined>;
+    /** 尺寸大小 */
     size: _angular_core.InputSignal<Size | undefined>;
+    /** 是否支持多文件选择 */
     multiple: _angular_core.InputSignal<boolean | undefined>;
+    /** 是否使用幽灵样式 */
     ghost: _angular_core.InputSignal<boolean | undefined>;
     fileChange: _angular_core.OutputEmitterRef<File | File[]>;
     fileChanged(input: HTMLInputElement): void;
@@ -33,13 +52,23 @@ declare class FileInputFCC extends BaseControl {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<FileInputFCC, "app-file-input", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "ghost": { "alias": "ghost"; "required": false; "isSignal": true; }; }, { "fileChange": "fileChange"; }, never, never, true, never>;
 }
 
+/**
+ * 文本输入控件
+ *
+ * 提供多种类型的文本输入功能，支持文本、密码、数字、日期等常见输入场景。
+ * 适合作为表单中的基础输入组件使用。
+ */
 declare class InputFCC extends BaseControl {
     #private;
     static __version: number;
+    /** 输入框类型 */
     type: _angular_core.InputSignal<"number" | "text" | "password" | "email" | "date" | "datetime-local" | "week" | "month" | "tel" | "url" | "search" | "time">;
+    /** 是否使用幽灵样式 */
     ghost: _angular_core.InputSignal<boolean | undefined>;
     templateRef: _angular_core.Signal<unknown>;
+    /** 颜色主题 */
     color: _angular_core.InputSignal<Color | undefined>;
+    /** 尺寸大小 */
     size: _angular_core.InputSignal<Size | undefined>;
     wrapperClass$$: _angular_core.Signal<string>;
     valueChange2(value: any, el: HTMLInputElement): void;
@@ -48,16 +77,27 @@ declare class InputFCC extends BaseControl {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<InputFCC, "app-input", never, { "type": { "alias": "type"; "required": false; "isSignal": true; }; "ghost": { "alias": "ghost"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 单选框控件
+ *
+ * 提供一组选项中的单选功能，支持通过配置项数组动态生成选项列表。
+ * 适用于需要在多个互斥选项中选择一个的场景。
+ */
 declare class RadioFCC extends BaseControl {
     #private;
     static __version: number;
     static index: number;
     templateRef: _angular_core.Signal<unknown>;
+    /** 颜色主题 */
     color: _angular_core.InputSignal<Color | undefined>;
+    /** 尺寸大小 */
     size: _angular_core.InputSignal<Size | undefined>;
     name: string;
+    /** 选项列表 */
     options: _angular_core.InputSignalWithTransform<SelectOption[], SelectOption[] | undefined>;
+    /** 选项模板 */
     optionTemplate: _angular_core.InputSignal<TemplateRef<any> | undefined>;
+    /** 选项转换器 */
     optionConvert: _angular_core.InputSignalWithTransform<OptionConvert, Partial<OptionConvert>>;
     resolvedOptions$$: _angular_core.Signal<ResolvedOption[]>;
     transformOptions(options: any[]): ResolvedOption[];
@@ -66,30 +106,52 @@ declare class RadioFCC extends BaseControl {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioFCC, "app-radio", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionTemplate": { "alias": "optionTemplate"; "required": false; "isSignal": true; }; "optionConvert": { "alias": "optionConvert"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 范围选择控件
+ *
+ * 提供滑动条形式的数值输入，支持设置最小值、最大值和步长。
+ * 适用于需要选择数值范围或评分等场景。
+ */
 declare class RangeFCC extends BaseControl {
     #private;
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
+    /** 颜色主题 */
     color: _angular_core.InputSignal<Color | undefined>;
+    /** 尺寸大小 */
     size: _angular_core.InputSignal<Size | undefined>;
+    /** 最小值 */
     min: _angular_core.InputSignal<number | undefined>;
+    /** 最大值 */
     max: _angular_core.InputSignal<number | undefined>;
+    /** 步长 */
     step: _angular_core.InputSignal<number | undefined>;
     wrapperClass$: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RangeFCC, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<RangeFCC, "app-range", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 评分控件
+ *
+ * 提供星级或爱心形式的评分选择功能，支持半星选择。
+ * 适用于评价、评级、评分等场景。
+ */
 declare class RatingFCC extends BaseControl {
     #private;
     static index: number;
     name: string;
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
-    size: _angular_core.InputSignal<Size | undefined>;
+    /** 尺寸大小 */
+    size: _angular_core.InputSignal<Size>;
+    /** 最小值 */
     min: _angular_core.InputSignal<number>;
+    /** 最大值 */
     max: _angular_core.InputSignal<number>;
+    /** 是否支持半星选择 */
     half: _angular_core.InputSignal<boolean | undefined>;
+    /** 类型，支持星形或爱心形状 */
     type: _angular_core.InputSignal<"star" | "star-2" | "heart">;
     list: _angular_core.Signal<number[]>;
     itemClass$$: _angular_core.Signal<string | undefined>;
@@ -98,20 +160,31 @@ declare class RatingFCC extends BaseControl {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<RatingFCC, "app-rating", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "half": { "alias": "half"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 选择器控件
+ *
+ * 提供下拉选择功能，支持单选、多选以及原生 select 样式。
+ * 适用于需要在多个选项中选择一个或多个的场景。
+ */
 declare class SelectFCC extends BaseControl {
     #private;
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
+    /** 颜色主题 */
     color: _angular_core.InputSignal<Color | undefined>;
+    /** 尺寸大小 */
     size: _angular_core.InputSignal<Size | undefined>;
+    /** 是否多选 */
     multiple: _angular_core.InputSignal<boolean>;
+    /** 是否使用幽灵样式 */
     ghost: _angular_core.InputSignal<boolean | undefined>;
+    /** 是否使用原生 select 样式 */
     native: _angular_core.InputSignal<boolean | undefined>;
-    /** ---输入--- */
-    /** @title 列表
-    @default [] */
+    /** 选项列表 */
     options: _angular_core.InputSignalWithTransform<SelectOption[], SelectOption[] | undefined>;
+    /** 选项转换器 */
     optionConvert: _angular_core.InputSignalWithTransform<OptionConvert, Partial<OptionConvert>>;
+    /** 空选项时显示的内容 */
     emptyOptionContent: _angular_core.InputSignal<string>;
     resolvedOptions$$: _angular_core.Signal<_piying_lib_angular_core.ResolvedOption[]>;
     wrapperClass$$: _angular_core.Signal<string>;
@@ -119,40 +192,70 @@ declare class SelectFCC extends BaseControl {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectFCC, "app-select", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "ghost": { "alias": "ghost"; "required": false; "isSignal": true; }; "native": { "alias": "native"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionConvert": { "alias": "optionConvert"; "required": false; "isSignal": true; }; "emptyOptionContent": { "alias": "emptyOptionContent"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 多行文本输入控件
+ *
+ * 提供多行文本的输入功能，支持大段文本的编辑场景。
+ * 适用于评论、描述、备注等需要大量文本输入的表单字段。
+ */
 declare class TextareaFCC extends BaseControl {
     #private;
     static __version: number;
+    /** 是否使用幽灵样式 */
     ghost: _angular_core.InputSignal<boolean | undefined>;
     templateRef: _angular_core.Signal<unknown>;
+    /** 颜色主题 */
     color: _angular_core.InputSignal<Color | undefined>;
+    /** 尺寸大小 */
     size: _angular_core.InputSignal<Size | undefined>;
     wrapperClass$$: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TextareaFCC, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextareaFCC, "app-textarea", never, { "ghost": { "alias": "ghost"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 开关控件
+ *
+ * 提供开/关状态切换功能，支持确定和不确定两种状态。
+ * 适用于功能开关、选项启用/禁用等场景。
+ */
 declare class ToggleFCC extends BaseControl {
     #private;
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
+    /** 颜色主题 */
     color: _angular_core.InputSignal<Color | undefined>;
+    /** 尺寸大小 */
     size: _angular_core.InputSignal<Size | undefined>;
+    /** 是否为不确定状态 */
     indeterminate: _angular_core.InputSignal<boolean | undefined>;
     wrapperClass$: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToggleFCC, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ToggleFCC, "app-toggle", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 交换控件（状态切换控件）
+ *
+ * 提供两种或三种状态之间的切换功能，支持旋转、翻转等动画效果。
+ * 可自定义不同状态下的显示内容，适用于需要状态切换的场景。
+ */
 declare class SwapFCC extends BaseControl {
     #private;
     static __version: number;
     readonly StrOrTemplateComponent: typeof StrOrTemplateComponent;
     templateRef: _angular_core.Signal<unknown>;
+    /** 开启状态时显示的内容 */
     onContent: _angular_core.InputSignal<string | TemplateRef<any>>;
+    /** 关闭状态时显示的内容 */
     offContent: _angular_core.InputSignal<string | TemplateRef<any>>;
+    /** 不确定状态时显示的内容 */
     indeterminateContent: _angular_core.InputSignal<string | TemplateRef<any> | undefined>;
+    /** 是否为不确定状态 */
     indeterminate: _angular_core.InputSignal<boolean | undefined>;
+    /** 是否启用旋转动画 */
     rotate: _angular_core.InputSignal<boolean | undefined>;
+    /** 是否启用翻转动画 */
     flip: _angular_core.InputSignal<boolean | undefined>;
     wrapperClass$: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SwapFCC, never>;
@@ -171,8 +274,11 @@ declare class CalendarFCC extends BaseControl<Date | Date[]> {
     #private;
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
+    /** 日期选择模式，支持单选、多选、范围选择 */
     type: _angular_core.InputSignal<"multi" | "range" | "date">;
+    /** 日期属性配置 */
     dateProps: _angular_core.InputSignal<DatedCalendarDateProps | DatedCalendarMultiProps | DatedCalendarRangeProps | undefined>;
+    /** 显示的月份数量 */
     monthProps: _angular_core.InputSignal<number | number[]>;
     monthProps$$: _angular_core.Signal<number[]>;
     dateProps$$: _angular_core.Signal<{
@@ -202,6 +308,12 @@ declare class CalendarFCC extends BaseControl<Date | Date[]> {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CalendarFCC, "app-calendar", never, { "type": { "alias": "type"; "required": false; "isSignal": true; }; "dateProps": { "alias": "dateProps"; "required": false; "isSignal": true; }; "monthProps": { "alias": "monthProps"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 密码输入控件
+ *
+ * 提供带有密码可见性切换功能的输入框。
+ * 适用于需要输入密码等敏感信息的场景。
+ */
 declare class PasswordInputFCC extends BaseControl {
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
@@ -213,13 +325,21 @@ declare class PasswordInputFCC extends BaseControl {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<PasswordInputFCC, "app-password", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * 可编辑标签控件
+ *
+ * 提供可直接点击编辑的标签显示功能，支持在显示和编辑状态之间切换。
+ * 适用于需要Inline编辑的场景，如自定义标签、备注等。
+ */
 declare class EditableBadgeFCC extends BaseControl {
     #private;
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
     isEdit$: _angular_core.WritableSignal<boolean>;
     editContent$: _angular_core.WritableSignal<any>;
+    /** 尺寸大小 */
     size: _angular_core.InputSignal<Size>;
+    /** 颜色主题 */
     color: _angular_core.InputSignal<Color | undefined>;
     wrapperClass$: _angular_core.Signal<string>;
     size$$: _angular_core.Signal<{

package/field-group/index.d.ts

@@ -3,16 +3,27 @@ import { PiyingViewGroupBase, PiResolvedViewFieldConfig } from '@piying/view-ang
 import * as _piying_view_angular_core from '@piying/view-angular-core';
 import { Size, StrOrTemplateComponent, Color } from '@piying-lib/angular-core';
 
+/**
+ * 折叠面板组
+ *
+ * 用于将多个内容块进行折叠/展开管理，支持单展开或多展开模式。
+ * 适合内容较多但需要节省空间的场景，如常见问题解答、设置选项分组等。
+ */
 declare class AccordionFGC extends PiyingViewGroupBase {
     #private;
     static __version: number;
     static index: number;
     name: string;
+    /** 是否允许多个面板同时展开 */
     multi: _angular_core.InputSignal<boolean>;
     templateRef: _angular_core.Signal<unknown>;
+    /** 子项标题函数，用于自定义标题显示 */
     childTitleFn: _angular_core.InputSignal<(item: PiResolvedViewFieldConfig) => any>;
+    /** 是否连接子项 */
     joinChild: _angular_core.InputSignal<boolean>;
+    /** 折叠图标样式 */
     collapseIcon: _angular_core.InputSignal<"arrow" | "plus" | undefined>;
+    /** 子项 CSS 类名 */
     childClass: _angular_core.InputSignal<string>;
     childClass$$: _angular_core.Signal<string>;
     childName: (multi: boolean, index: number) => string;
@@ -20,17 +31,31 @@ declare class AccordionFGC extends PiyingViewGroupBase {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AccordionFGC, "app-accordion", never, { "multi": { "alias": "multi"; "required": false; "isSignal": true; }; "childTitleFn": { "alias": "childTitleFn"; "required": false; "isSignal": true; }; "joinChild": { "alias": "joinChild"; "required": false; "isSignal": true; }; "collapseIcon": { "alias": "collapseIcon"; "required": false; "isSignal": true; }; "childClass": { "alias": "childClass"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 卡片组
+ *
+ * 用于将表单字段组织成卡片式布局，支持标题、图片和操作区的自定义。
+ * 适合需要突出显示每组字段、创建美观表单界面的场景，如用户资料编辑、表单 Wizard 等。
+ */
 declare class CardFGC extends PiyingViewGroupBase {
     #private;
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
+    /** 边框样式 */
     border: _angular_core.InputSignal<"border" | "dash" | undefined>;
+    /** 尺寸大小 */
     size: _angular_core.InputSignal<Size | undefined>;
+    /** 内容区域 CSS 类名 */
     bodyClass: _angular_core.InputSignal<string | undefined>;
+    /** 图片区域 CSS 类名 */
     figureClass: _angular_core.InputSignal<string | undefined>;
+    /** 操作区域 CSS 类名 */
     actionsClass: _angular_core.InputSignal<string>;
+    /** 标题字段键名 */
     titleKey: _angular_core.InputSignal<string>;
+    /** 图片字段键名 */
     figureKey: _angular_core.InputSignal<string>;
+    /** 操作字段键名 */
     actionsKey: _angular_core.InputSignal<string>;
     titleFiled$$: _angular_core.Signal<_piying_view_angular_core._PiResolvedCommonViewFieldConfig | undefined>;
     figureFiled$$: _angular_core.Signal<_piying_view_angular_core._PiResolvedCommonViewFieldConfig | undefined>;
@@ -41,25 +66,41 @@ declare class CardFGC extends PiyingViewGroupBase {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CardFGC, "app-card", never, { "border": { "alias": "border"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "bodyClass": { "alias": "bodyClass"; "required": false; "isSignal": true; }; "figureClass": { "alias": "figureClass"; "required": false; "isSignal": true; }; "actionsClass": { "alias": "actionsClass"; "required": false; "isSignal": true; }; "titleKey": { "alias": "titleKey"; "required": false; "isSignal": true; }; "figureKey": { "alias": "figureKey"; "required": false; "isSignal": true; }; "actionsKey": { "alias": "actionsKey"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 走马灯组
+ *
+ * 用于横向或纵向滚动展示多个表单字段，支持自动滚动和对齐方式设置。
+ * 适合字段较多且需要空间节省的场景，如多步骤表单、长列表项展示等。
+ */
 declare class CarouselFGC extends PiyingViewGroupBase {
     #private;
     static __version: number;
     static index: number;
     index: number;
     templateRef: _angular_core.Signal<unknown>;
+    /** 滚动方向 */
     direction: _angular_core.InputSignal<"horizontal" | "vertical" | undefined>;
+    /** 滚动对齐方式 */
     scrollAlign: _angular_core.InputSignal<"start" | "center" | "end" | undefined>;
+    /** 子项 ID 映射函数 */
     childIdMap: _angular_core.InputSignal<(compIndex: number, childIndex: number) => string>;
     ngClass$$: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CarouselFGC, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CarouselFGC, "app-carousel", never, { "direction": { "alias": "direction"; "required": false; "isSignal": true; }; "scrollAlign": { "alias": "scrollAlign"; "required": false; "isSignal": true; }; "childIdMap": { "alias": "childIdMap"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 舷窗组
+ *
+ * 底部导航栏（也称为“Dock”或“底部栏”）是一种用户界面元素，用于向用户提供导航选项。该栏固定在屏幕底部。
+ */
 declare class DockFGC extends PiyingViewGroupBase {
     #private;
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
+    /** 尺寸大小 */
     size: _angular_core.InputSignal<Size | undefined>;
+    /** 当前激活的索引 */
     activatedIndex: _angular_core.InputSignal<number>;
     activatedIndex$: _angular_core.WritableSignal<number>;
     toggleActivate(index: number): void;
@@ -68,14 +109,27 @@ declare class DockFGC extends PiyingViewGroupBase {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DockFGC, "app-dock", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "activatedIndex": { "alias": "activatedIndex"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 列表组
+ *
+ * 用于将表单字段以列表形式垂直排列展示，支持自定义标题样式。
+ * 适合字段较多、需要清晰层级结构的场景，如设置列表、表单项清单等。
+ */
 declare class ListFGC extends PiyingViewGroupBase {
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
+    /** 标题 CSS 类名 */
     titleClass: _angular_core.InputSignal<unknown>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ListFGC, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ListFGC, "app-list", never, { "titleClass": { "alias": "titleClass"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 导航栏组
+ *
+ * 用于将表单字段组织成导航栏布局，支持开始、中间、结束三个区域的智能分配。
+ * 适合需要在顶部导航栏展示表单操作或导航项的场景，如搜索栏、工具栏等。
+ */
 declare class NavbarFGC extends PiyingViewGroupBase {
     static __version: number;
     static index: number;
@@ -88,16 +142,27 @@ declare class NavbarFGC extends PiyingViewGroupBase {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<NavbarFGC, "app-navbar", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * 抽屉组
+ *
+ * 用于将表单字段组织成可侧边抽屉展开/收起的布局，支持覆盖和侧边两种模式。
+ * 适合次要或辅助性的字段组，如筛选条件、详细信息、操作面板等。
+ */
 declare class DrawerFGC extends PiyingViewGroupBase {
     #private;
     static __version: number;
     static index: number;
     name: string;
     templateRef: _angular_core.Signal<unknown>;
+    /** 抽屉内容区域 CSS 类名 */
     contentClass: _angular_core.InputSignal<string | undefined>;
+    /** 侧边栏区域 CSS 类名 */
     sideClass: _angular_core.InputSignal<string | undefined>;
+    /** 遮罩层 CSS 类名 */
     overlayClass: _angular_core.InputSignal<string | undefined>;
+    /** 抽屉模式 */
     mode: _angular_core.InputSignal<"over" | "side">;
+    /** 抽屉位置 */
     position: _angular_core.InputSignal<"start" | "end" | undefined>;
     contentFiled$$: _angular_core.Signal<_piying_view_angular_core._PiResolvedCommonViewFieldConfig | undefined>;
     sideFiled$$: _angular_core.Signal<_piying_view_angular_core._PiResolvedCommonViewFieldConfig | undefined>;
@@ -108,19 +173,31 @@ declare class DrawerFGC extends PiyingViewGroupBase {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DrawerFGC, "app-drawer", never, { "contentClass": { "alias": "contentClass"; "required": false; "isSignal": true; }; "sideClass": { "alias": "sideClass"; "required": false; "isSignal": true; }; "overlayClass": { "alias": "overlayClass"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "opened": { "alias": "opened"; "required": false; "isSignal": true; }; }, { "opened": "openedChange"; }, never, never, true, never>;
 }
 
+/**
+ * 标签页组
+ *
+ * 用于将表单字段组织成多标签页切换展示，支持多种标签样式和位置布局。
+ * 适合字段较多需要分类管理、多配置项分页展示的场景，如系统设置、表单分组等。
+ */
 declare class TabsFGC extends PiyingViewGroupBase {
     #private;
     static __version: number;
     static index: number;
     templateRef: _angular_core.Signal<unknown>;
-    StrOrTemplateComponent: typeof StrOrTemplateComponent;
+    readonly StrOrTemplateComponent: typeof StrOrTemplateComponent;
+    /** 尺寸大小 */
     size: _angular_core.InputSignal<Size | undefined>;
     name: string;
+    /** 当前激活的标签页索引 */
     activatedIndex: _angular_core.InputSignal<number>;
+    /** 标签类型 */
     type: _angular_core.InputSignal<"border" | "box" | "lift" | undefined>;
+    /** 标签页位置 */
     placement: _angular_core.InputSignal<"top" | "bottom" | undefined>;
+    /** 标签页内容区域 CSS 类名 */
     tabContentClass: _angular_core.InputSignal<string>;
     activatedIndex$: _angular_core.WritableSignal<number>;
+    /** 切换前的回调函数 */
     beforeChange: _angular_core.InputSignal<((index: number) => any) | undefined>;
     wrapperClass$$: _angular_core.Signal<string>;
     isUnion$$: _angular_core.Signal<boolean>;
@@ -133,20 +210,32 @@ declare class TabsFGC extends PiyingViewGroupBase {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabsFGC, "app-tabs", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "activatedIndex": { "alias": "activatedIndex"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "tabContentClass": { "alias": "tabContentClass"; "required": false; "isSignal": true; }; "beforeChange": { "alias": "beforeChange"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 步骤组
+ *
+ * 用于将表单字段组织成多步骤向导流程，支持步骤进度管理和前后切换。
+ * 适合复杂表单分步填写的场景，如注册流程、配置向导、订单填写等。
+ */
 declare class StepsFGC extends PiyingViewGroupBase {
     #private;
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
     readonly StrOrTemplateComponent: typeof StrOrTemplateComponent;
+    /** 当前激活的步骤索引 */
     activatedIndex: _angular_core.InputSignal<number>;
     activatedIndex$: _angular_core.WritableSignal<number>;
     activatedIndexChange: _angular_core.OutputEmitterRef<number>;
     activatedItem$$: _angular_core.Signal<_piying_view_angular_core._PiResolvedCommonViewFieldConfig>;
     prevItem$$: _angular_core.Signal<_piying_view_angular_core._PiResolvedCommonViewFieldConfig>;
+    /** 自定义操作区域 */
     customAction: _angular_core.InputSignal<unknown>;
+    /** 上一步按钮内容 */
     prev: _angular_core.InputSignal<string>;
+    /** 下一步按钮内容 */
     next: _angular_core.InputSignal<string>;
+    /** 步骤方向 */
     direction: _angular_core.InputSignal<"horizontal" | "vertical" | undefined>;
+    /** 步骤颜色 */
     stepColor: _angular_core.InputSignal<Color>;
     toPrev(): void;
     toNext(): void;
@@ -156,11 +245,4 @@ declare class StepsFGC extends PiyingViewGroupBase {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StepsFGC, "app-steps", never, { "activatedIndex": { "alias": "activatedIndex"; "required": false; "isSignal": true; }; "customAction": { "alias": "customAction"; "required": false; "isSignal": true; }; "prev": { "alias": "prev"; "required": false; "isSignal": true; }; "next": { "alias": "next"; "required": false; "isSignal": true; }; "direction": { "alias": "direction"; "required": false; "isSignal": true; }; "stepColor": { "alias": "stepColor"; "required": false; "isSignal": true; }; }, { "activatedIndexChange": "activatedIndexChange"; }, never, never, true, never>;
 }
 
-declare class FieldsetFGC extends PiyingViewGroupBase {
-    static __version: number;
-    templateRef: _angular_core.Signal<unknown>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FieldsetFGC, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FieldsetFGC, "app-fieldset", never, {}, {}, never, never, true, never>;
-}
-
-export { AccordionFGC, CardFGC, CarouselFGC, DockFGC, DrawerFGC, FieldsetFGC, ListFGC, NavbarFGC, StepsFGC, TabsFGC };
+export { AccordionFGC, CardFGC, CarouselFGC, DockFGC, DrawerFGC, ListFGC, NavbarFGC, StepsFGC, TabsFGC };