@piying-lib/angular-daisyui 1.1.7 → 1.2.1

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,57 +173,76 @@ 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>;
-    isUnion: _angular_core.InputSignal<boolean>;
     activatedIndex$: _angular_core.WritableSignal<number>;
+    /** 切换前的回调函数 */
     beforeChange: _angular_core.InputSignal<((index: number) => any) | undefined>;
     wrapperClass$$: _angular_core.Signal<string>;
+    isUnion$$: _angular_core.Signal<boolean>;
     labelInputs: (input: any) => {
         content: any;
     };
     constructor();
     changeIndex(index: number): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TabsFGC, never>;
-    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; }; "isUnion": { "alias": "isUnion"; "required": false; "isSignal": true; }; "beforeChange": { "alias": "beforeChange"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    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.ModelSignal<number>;
+    /** 当前激活的步骤索引 */
+    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;
     isActivated(activatedIndex: number, currentIndex: number): boolean;
     wrapperClass$$: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StepsFGC, never>;
-    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; }; }, { "activatedIndex": "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>;
+    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>;
 }
 
-export { AccordionFGC, CardFGC, CarouselFGC, DockFGC, DrawerFGC, FieldsetFGC, ListFGC, NavbarFGC, StepsFGC, TabsFGC };
+export { AccordionFGC, CardFGC, CarouselFGC, DockFGC, DrawerFGC, ListFGC, NavbarFGC, StepsFGC, TabsFGC };

package/non-field-control/index.d.ts

@@ -6,51 +6,85 @@ import { PiyingView } from '@piying/view-angular';
 import * as _piying_valibot_visit from '@piying/valibot-visit';
 import * as _piying_view_angular_core from '@piying/view-angular-core';
 
+/**
+ * 警告提示组件
+ * 用于显示重要的提示信息，支持多种样式、颜色和布局方向
+ * 常用于操作反馈、错误提示、成功通知等场景
+ */
 declare class AlertNFCC {
     #private;
     static __version: number;
     readonly StrOrTemplateComponent: typeof StrOrTemplateComponent;
     templateRef: _angular_core.Signal<unknown>;
+    /** 样式风格 */
     style: _angular_core.InputSignal<"outline" | "dash" | "soft" | undefined>;
+    /** 颜色主题 */
     color: _angular_core.InputSignal<AlertColor | undefined>;
+    /** 方向 */
     direction: _angular_core.InputSignal<"vertical" | "horizontal" | undefined>;
+    /** 内容 */
     content: _angular_core.InputSignal<string>;
     wrapperClass$: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AlertNFCC, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AlertNFCC, "app-alert", never, { "style": { "alias": "style"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "direction": { "alias": "direction"; "required": false; "isSignal": true; }; "content": { "alias": "content"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 头像组件
+ * 用于显示用户头像、图标或占位符，支持在线/离线状态指示
+ * 可用于个人资料、列表项、评论等场景
+ */
 declare class AvatarNFCC {
     #private;
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
+    /** 占位符文本或内容 */
     placeholder: _angular_core.InputSignal<string | undefined>;
+    /** 占位符 CSS 类名 */
     placeholderClass: _angular_core.InputSignal<string>;
+    /** 图片 URL */
     imgUrl: _angular_core.InputSignal<string | undefined>;
+    /** 包装器 CSS 类名 */
     wrapperClass: _angular_core.InputSignal<string>;
+    /** 状态指示 */
     status: _angular_core.InputSignal<"online" | "offline" | undefined>;
     mainClass$$: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AvatarNFCC, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AvatarNFCC, "app-avatar", never, { "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "placeholderClass": { "alias": "placeholderClass"; "required": false; "isSignal": true; }; "imgUrl": { "alias": "imgUrl"; "required": false; "isSignal": true; }; "wrapperClass": { "alias": "wrapperClass"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 徽章组件
+ * 用于显示数量标签、状态标记或重要提示，如未读消息数、通知提示等
+ * 支持多种样式风格和颜色尺寸配置
+ */
 declare class BadgeNFCC {
     #private;
     static __version: number;
     readonly StrOrTemplateComponent: typeof StrOrTemplateComponent;
     templateRef: _angular_core.Signal<unknown>;
+    /** 样式风格 */
     style: _angular_core.InputSignal<"outline" | "dash" | "soft" | "ghost" | undefined>;
+    /** 颜色主题 */
     color: _angular_core.InputSignal<Color | undefined>;
+    /** 尺寸大小 */
     size: _angular_core.InputSignal<Size | undefined>;
+    /** 内容 */
     content: _angular_core.InputSignal<string>;
     wrapperClass$: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BadgeNFCC, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<BadgeNFCC, "app-badge", never, { "style": { "alias": "style"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "content": { "alias": "content"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 面包屑导航组件
+ * 用于显示页面层级结构和当前位置，帮助用户了解所处位置并快速返回上级页面
+ * 支持自定义标签、图标和 URL 配置
+ */
 declare class BreadcrumbsNFCC {
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
+    /** 面包屑选项列表 */
     options: _angular_core.InputSignal<{
         label?: string;
         icon?: IconConfig;
@@ -58,24 +92,39 @@ declare class BreadcrumbsNFCC {
         extraLink?: boolean;
         templateRef?: TemplateRef<any>;
     }[] | undefined>;
+    /** 选项 CSS 类名 */
     optionClass: _angular_core.InputSignal<unknown>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BreadcrumbsNFCC, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<BreadcrumbsNFCC, "app-breadcrumbs", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionClass": { "alias": "optionClass"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 按钮组件
+ * 用于触发操作或提交表单，是最常用的操作控件
+ * 支持多种颜色、样式、尺寸、形状以及加载状态
+ */
 declare class ButtonNFCC {
     #private;
     static __version: number;
     readonly StrOrTemplateComponent: typeof StrOrTemplateComponent;
     templateRef: _angular_core.Signal<unknown>;
+    /** 颜色主题 */
     color: _angular_core.InputSignal<Color | undefined>;
+    /** 按钮样式风格 */
     style: _angular_core.InputSignal<"outline" | "dash" | "soft" | "link" | "ghost" | undefined>;
+    /** 尺寸大小 */
     size: _angular_core.InputSignal<Size | undefined>;
+    /** 形状 */
     shape: _angular_core.InputSignal<"wide" | "block" | "square" | "circle" | undefined>;
+    /** 是否激活状态 */
     active: _angular_core.InputSignal<boolean | undefined>;
+    /** 按钮内容 */
     content: _angular_core.InputSignal<any>;
+    /** 点击事件处理函数 */
     clicked: _angular_core.InputSignal<((event: PointerEvent) => void | Promise<void>) | undefined>;
+    /** 是否禁用 */
     disabled: _angular_core.InputSignal<boolean>;
+    /** 是否禁用加载图标 */
     disableLoadingIcon: _angular_core.InputSignal<boolean>;
     isLoading$: _angular_core.WritableSignal<boolean>;
     onClick(event: PointerEvent): Promise<void>;
@@ -84,19 +133,33 @@ declare class ButtonNFCC {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonNFCC, "app-button", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "style": { "alias": "style"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; "content": { "alias": "content"; "required": false; "isSignal": true; }; "clicked": { "alias": "clicked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "disableLoadingIcon": { "alias": "disableLoadingIcon"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 分割线组件
+ * 用于在内容之间添加视觉分隔，支持水平/垂直方向和内容位置调整
+ * 常用于表单、列表、段落之间的分隔
+ */
 declare class DividerNFCC {
     #private;
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
+    /** 颜色主题 */
     color: _angular_core.InputSignal<Color | undefined>;
+    /** 方向 */
     direction: _angular_core.InputSignal<"vertical" | "horizontal" | undefined>;
+    /** 内容位置 */
     contentPosition: _angular_core.InputSignal<"start" | "end" | undefined>;
+    /** 分割线内容 */
     content: _angular_core.InputSignal<string>;
     wrapperClass$$: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DividerNFCC, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DividerNFCC, "app-divider", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "direction": { "alias": "direction"; "required": false; "isSignal": true; }; "contentPosition": { "alias": "contentPosition"; "required": false; "isSignal": true; }; "content": { "alias": "content"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 悬浮操作按钮组件
+ * 通常悬浮在页面角落，用于提供主要或常用的操作入口
+ * 支持展开式菜单和自定义图标配置
+ */
 interface FabOption {
     class?: string;
     label?: string;
@@ -115,8 +178,11 @@ declare class FabNFCC {
     #private;
     static __version: number;
     templateRef: Signal<unknown>;
+    /** 选项列表 */
     options: _angular_core.InputSignal<FabOption[] | undefined>;
+    /** 是否启用花朵式展开 */
     flower: _angular_core.InputSignal<boolean>;
+    /** 点击选项后是否自动关闭 */
     autoClose: _angular_core.InputSignal<boolean>;
     resolvedOptions$$: Signal<FabItem[]>;
     commonClass: _angular_core.InputSignal<string>;
@@ -131,34 +197,56 @@ declare class FabNFCC {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<FabNFCC, "app-fab", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "flower": { "alias": "flower"; "required": false; "isSignal": true; }; "autoClose": { "alias": "autoClose"; "required": false; "isSignal": true; }; "commonClass": { "alias": "commonClass"; "required": false; "isSignal": true; }; "defaultIcon": { "alias": "defaultIcon"; "required": false; "isSignal": true; }; "closeIcon": { "alias": "closeIcon"; "required": false; "isSignal": true; }; "mainIcon": { "alias": "mainIcon"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 键盘按键组件
+ * 用于展示键盘快捷键或组合键提示，常见于帮助文档、教程或功能说明中
+ * 可显示单个按键或按键组合
+ */
 declare class KbdNFCC {
     #private;
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
+    /** 尺寸大小 */
     size: _angular_core.InputSignal<Size | undefined>;
+    /** 内容 */
     content: _angular_core.InputSignal<string>;
     wrapperClass$: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbdNFCC, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbdNFCC, "app-kbd", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "content": { "alias": "content"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 加载指示器组件
+ * 用于在数据加载、请求处理等异步操作期间显示加载状态
+ * 提供多种样式类型（-spinner、dots、ring 等）供选择
+ */
 declare class LoadingNFCC {
     #private;
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
+    /** 尺寸大小 */
     size: _angular_core.InputSignal<Size | undefined>;
+    /** 加载类型 */
     type: _angular_core.InputSignal<"spinner" | "dots" | "ring" | "ball" | "bars" | "infinity" | undefined>;
     wrapperClass$$: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<LoadingNFCC, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<LoadingNFCC, "app-loading", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 进度条组件
+ * 用于显示操作完成的进度或数据加载的百分比
+ * 支持自定义颜色和进度值显示
+ */
 declare class ProgressNFCC {
     #private;
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
+    /** 颜色主题 */
     color: _angular_core.InputSignal<Color | undefined>;
+    /** 进度值 */
     value: _angular_core.InputSignal<number | undefined>;
+    /** 最大值 */
     max: _angular_core.InputSignal<number>;
     wrapperClass$: _angular_core.Signal<string>;
     isNumber(value: any): value is number;
@@ -166,12 +254,20 @@ declare class ProgressNFCC {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ProgressNFCC, "app-progress", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 环形进度组件
+ * 用于显示圆形的进度指示器，适合空间受限或需要美观展示的场景
+ * 支持自定义线宽和进度值配置
+ */
 declare class RadialProgressNFCC {
     #private;
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
+    /** 进度值 */
     value: _angular_core.InputSignal<number>;
+    /** 进度值映射函数 */
     valueMap: _angular_core.InputSignal<(value: number) => string>;
+    /** 线宽 */
     strokeWidth: _angular_core.InputSignal<string | undefined>;
     value$$: _angular_core.Signal<number>;
     wrapperStyle$$: _angular_core.Signal<Record<string, string>>;
@@ -179,45 +275,78 @@ declare class RadialProgressNFCC {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadialProgressNFCC, "app-radial-progress", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "valueMap": { "alias": "valueMap"; "required": false; "isSignal": true; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 状态指示器组件
+ * 用于显示对象的当前状态（如在线、离线、完成等），常用于列表项或卡片中
+ * 支持多种动画效果（ping、bounce）增强视觉提示
+ */
 declare class StatusNFCC {
     #private;
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
+    /** 内容 */
     content: _angular_core.InputSignal<string>;
+    /** 颜色主题 */
     color: _angular_core.InputSignal<Color | undefined>;
+    /** 尺寸大小 */
     size: _angular_core.InputSignal<Size | undefined>;
+    /** 是否启用 ping 动画效果 */
     animatePing: _angular_core.InputSignal<boolean | undefined>;
+    /** 是否启用 bounce 动画效果 */
     animateBounce: _angular_core.InputSignal<boolean | undefined>;
     wrapperClass$: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StatusNFCC, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StatusNFCC, "app-status", never, { "content": { "alias": "content"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "animatePing": { "alias": "animatePing"; "required": false; "isSignal": true; }; "animateBounce": { "alias": "animateBounce"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 主题控制器组件
+ * 用于切换应用的主题样式，通常与主题切换功能配合使用
+ * 可通过配置不同的主题值来改变整体配色方案
+ */
 declare class ThemeControllerNFCC {
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
+    /** 主题值 */
     value: _angular_core.InputSignal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThemeControllerNFCC, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ThemeControllerNFCC, "app-theme-controller", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 下拉菜单组件
+ * 用于在有限空间内展示多个操作选项或列表项
+ * 支持悬停或点击触发，可配置菜单对齐方式和显示位置
+ */
 declare class DropdownNFCC {
     #private;
     static __version: number;
     readonly StrOrTemplateComponent: typeof StrOrTemplateComponent;
     templateRef: _angular_core.Signal<unknown>;
+    /** 标题内容 */
     title: _angular_core.InputSignal<string>;
+    /** 标题 CSS 类名 */
     titleClass: _angular_core.InputSignal<string | undefined>;
+    /** 对齐方式 */
     align: _angular_core.InputSignal<"start" | "end" | "center" | undefined>;
+    /** 位置 */
     position: _angular_core.InputSignal<"top" | "bottom" | "left" | "right" | undefined>;
+    /** 触发动作 */
     triggerAction: _angular_core.InputSignal<"hover" | "open" | undefined>;
+    /** 内容 */
     content: _angular_core.InputSignal<unknown>;
+    /** 内容 CSS 类名 */
     contentClass: _angular_core.InputSignal<string | undefined>;
     wrapperClass$: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DropdownNFCC, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DropdownNFCC, "app-dropdown", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "titleClass": { "alias": "titleClass"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "triggerAction": { "alias": "triggerAction"; "required": false; "isSignal": true; }; "content": { "alias": "content"; "required": false; "isSignal": true; }; "contentClass": { "alias": "contentClass"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 统计数据显示组件
+ * 用于展示关键数据指标，支持标题、数值、描述和图标的组合展示
+ * 常用于数据报表、仪表盘等数据可视化场景
+ */
 declare class StatNFCC {
     static __version: number;
     readonly StrOrTemplateComponent: typeof StrOrTemplateComponent;
@@ -229,13 +358,21 @@ declare class StatNFCC {
     }, "handle" | "builder">, "fieldGlobalConfig"> & {
         fieldGlobalConfig?: _piying_view_angular.PiViewConfig;
     }> | null;
+    /** 标题内容 */
     title: _angular_core.InputSignal<unknown>;
+    /** 标题 CSS 类名 */
     titleClass: _angular_core.InputSignal<string | undefined>;
+    /** 数值内容 */
     value: _angular_core.InputSignal<unknown>;
+    /** 数值 CSS 类名 */
     valueClass: _angular_core.InputSignal<string | undefined>;
+    /** 描述内容 */
     desc: _angular_core.InputSignal<unknown>;
+    /** 描述 CSS 类名 */
     descClass: _angular_core.InputSignal<string | undefined>;
+    /** 图标内容 */
     figure: _angular_core.InputSignal<unknown>;
+    /** 图标 CSS 类名 */
     figureClass: _angular_core.InputSignal<string | undefined>;
     templateInput: (schema: Signal<any>) => {
         schema: Signal<any>;
@@ -251,17 +388,30 @@ declare class StatNFCC {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<StatNFCC, "app-stat", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "titleClass": { "alias": "titleClass"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "valueClass": { "alias": "valueClass"; "required": false; "isSignal": true; }; "desc": { "alias": "desc"; "required": false; "isSignal": true; }; "descClass": { "alias": "descClass"; "required": false; "isSignal": true; }; "figure": { "alias": "figure"; "required": false; "isSignal": true; }; "figureClass": { "alias": "figureClass"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * 表单提交按钮组件
+ * 用于表单提交、重置等操作，具有与按钮组件相同的样式特性
+ * 常用于表单底部操作区域
+ */
 declare class InputButtonNFCC {
     #private;
     static __version: number;
     templateRef: _angular_core.Signal<unknown>;
+    /** 按钮类型 */
     type: _angular_core.InputSignal<"reset" | "submit">;
+    /** 颜色主题 */
     color: _angular_core.InputSignal<Color | undefined>;
+    /** 按钮样式风格 */
     style: _angular_core.InputSignal<"outline" | "dash" | "soft" | "link" | "ghost" | undefined>;
+    /** 尺寸大小 */
     size: _angular_core.InputSignal<Size | undefined>;
+    /** 形状 */
     shape: _angular_core.InputSignal<"wide" | "block" | "square" | "circle" | undefined>;
+    /** 是否激活状态 */
     active: _angular_core.InputSignal<boolean | undefined>;
+    /** 点击事件处理函数 */
     clicked: _angular_core.InputSignal<((event: PointerEvent) => void | Promise<void>) | undefined>;
+    /** 是否禁用 */
     disabled: _angular_core.InputSignal<boolean>;
     isLoading$: _angular_core.WritableSignal<boolean>;
     onClick(event: PointerEvent): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@piying-lib/angular-daisyui",
-    "version": "1.1.7",
+    "version": "1.2.1",
     "peerDependencies": {
         "@angular/common": ">=20.3.0",
         "@angular/core": ">=20.3.0",
@@ -9,7 +9,7 @@
     },
     "dependencies": {
         "tslib": "^2.3.0",
-        "@piying-lib/angular-core": "^1.1.7"
+        "@piying-lib/angular-core": "^1.2.1"
     },
     "sideEffects": false,
     "module": "fesm2022/piying-lib-angular-daisyui.mjs",