ngx-tethys 19.1.13 → 20.0.0-next.0

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+# [20.0.0-next.0](https://github.com/atinc/ngx-tethys/compare/19.1.14...20.0.0-next.0) (2025-11-14)
+
+
+### Features
+
+* upgrade angular to v20 TINFR-2654 ([#3611](https://github.com/atinc/ngx-tethys/issues/3611)) ([ed358f0](https://github.com/atinc/ngx-tethys/commit/ed358f0c341fe6af7725ed43bf44a0ef45b2b6e4))
+
+
+
+## [19.1.14](https://github.com/atinc/ngx-tethys/compare/19.1.13...19.1.14) (2025-11-12)
+
+
+### Features
+
+* **input-number:** support thyShowStepControls #TINFR-2994 ([#3605](https://github.com/atinc/ngx-tethys/issues/3605)) ([c06a6f8](https://github.com/atinc/ngx-tethys/commit/c06a6f813e619ef63ac99459f8c149439c93bafd)), closes [#TINFR-2994](https://github.com/atinc/ngx-tethys/issues/TINFR-2994)
+
+
+
 ## [19.1.13](https://github.com/atinc/ngx-tethys/compare/19.1.12...19.1.13) (2025-11-05)
 
 

package/action/index.d.ts

@@ -1,3 +1,107 @@
-export * from './action.component';
-export * from './actions.component';
-export * from './action.module';
+import * as _angular_core from '@angular/core';
+import { OnInit, AfterViewInit, OnDestroy, Signal } from '@angular/core';
+import { ThySpacingSize } from 'ngx-tethys/core';
+import * as i1 from '@angular/common';
+import * as i2 from 'ngx-tethys/icon';
+
+type ThyActionType = 'primary' | 'success' | 'danger' | 'warning';
+type ThyActionFeedback = 'success' | 'error';
+interface ThyActionFeedbackOptions {
+    icon?: string;
+    class?: string;
+    duration?: number;
+}
+/**
+ * 立即操作组件
+ * @name thy-action,[thyAction]
+ */
+declare class ThyAction implements OnInit, AfterViewInit, OnDestroy {
+    private elementRef;
+    private renderer;
+    private cdr;
+    readonly icon: Signal<string>;
+    feedback: ThyActionFeedback;
+    feedbackOptions: ThyActionFeedbackOptions;
+    readonly active: Signal<boolean>;
+    private hostRenderer;
+    private feedbackTimer;
+    /**
+     * 操作图标的类型
+     * @type primary | success | danger | warning
+     */
+    readonly thyType: _angular_core.InputSignalWithTransform<ThyActionType, ThyActionType>;
+    /**
+     * 操作图标，支持传参同时也支持在投影中写 thy-icon 组件
+     */
+    readonly thyIcon: _angular_core.InputSignal<string>;
+    /**
+     * 操作图标，当 thyIcon 和其他指令参数名有冲突时使用 thyActionIcon
+     */
+    readonly thyActionIcon: _angular_core.InputSignal<string>;
+    /**
+     * 操作的图标 Active 状态，设置为 true 时会在 Item 上添加 active class
+     */
+    readonly thyActive: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * 操作的图标 Active 状态，当 thyActive 和其他指令参数名有冲突时使用 thyActionActive
+     */
+    readonly thyActionActive: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * 操作图标的主题
+     * @type fill(背景色填充) | lite(简单文本颜色变化)
+     */
+    readonly thyTheme: _angular_core.InputSignal<"fill" | "lite">;
+    /**
+     * Hover 展示的图标
+     */
+    readonly thyHoverIcon: _angular_core.InputSignal<string>;
+    /**
+     * 是否处于禁用状态
+     */
+    readonly thyDisabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    ngOnInit(): void;
+    ngAfterViewInit(): void;
+    constructor();
+    setMarginRight(marginRight: string): void;
+    /**
+     * 触发成功反馈操作
+     */
+    success(options?: ThyActionFeedbackOptions): void;
+    /**
+     * 触发失败反馈操作
+     */
+    error(options?: ThyActionFeedbackOptions): void;
+    private setFeedback;
+    private wrapSpanForText;
+    private updateClasses;
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThyAction, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ThyAction, "thy-action, [thyAction]", never, { "thyType": { "alias": "thyType"; "required": false; "isSignal": true; }; "thyIcon": { "alias": "thyIcon"; "required": false; "isSignal": true; }; "thyActionIcon": { "alias": "thyActionIcon"; "required": false; "isSignal": true; }; "thyActive": { "alias": "thyActive"; "required": false; "isSignal": true; }; "thyActionActive": { "alias": "thyActionActive"; "required": false; "isSignal": true; }; "thyTheme": { "alias": "thyTheme"; "required": false; "isSignal": true; }; "thyHoverIcon": { "alias": "thyHoverIcon"; "required": false; "isSignal": true; }; "thyDisabled": { "alias": "thyDisabled"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+/**
+ * Actions 组件
+ * @name thy-actions
+ */
+declare class ThyActions implements OnInit {
+    readonly actions: _angular_core.Signal<readonly ThyAction[]>;
+    /**
+     * 大小，支持 `zero` | `xxs` | `xs` | `sm` | `md` | `lg` | `xlg` 和自定义数字大小
+     * @type string | number
+     */
+    readonly thySize: _angular_core.InputSignal<ThySpacingSize>;
+    constructor();
+    ngOnInit(): void;
+    private setActionsSize;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThyActions, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ThyActions, "thy-actions", never, { "thySize": { "alias": "thySize"; "required": false; "isSignal": true; }; }, {}, ["actions"], ["*"], true, never>;
+}
+
+declare class ThyActionModule {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThyActionModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<ThyActionModule, never, [typeof i1.CommonModule, typeof i2.ThyIconModule, typeof ThyAction, typeof ThyActions], [typeof ThyAction, typeof ThyActions]>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<ThyActionModule>;
+}
+
+export { ThyAction, ThyActionModule, ThyActions };
+export type { ThyActionFeedback, ThyActionFeedbackOptions, ThyActionType };

package/affix/index.d.ts

@@ -1,2 +1,65 @@
-export * from './affix.module';
-export * from './affix.component';
+import * as i0 from '@angular/core';
+import { AfterViewInit, OnDestroy } from '@angular/core';
+import * as i1 from '@angular/common';
+import * as i2 from '@angular/cdk/platform';
+import { SimpleRect } from 'ngx-tethys/util';
+
+/**
+ * 固钉组件
+ * @name thy-affix
+ * @order 10
+ */
+declare class ThyAffix implements AfterViewInit, OnDestroy {
+    private scrollService;
+    private ngZone;
+    private platform;
+    private renderer;
+    private readonly fixedElement;
+    /**
+     * 设置 thy-affix 需要监听其滚动事件的元素，值为一个返回对应 DOM 元素的函数
+     * @default window
+     * @type string | Element | Window
+     */
+    readonly thyContainer: i0.InputSignal<string | Element | Window>;
+    /**
+     * 距离窗口顶部缓冲的偏移量阈值
+     */
+    readonly thyOffsetTop: i0.InputSignalWithTransform<number, unknown>;
+    /**
+     * 距离窗口底部缓冲的偏移量阈值
+     */
+    readonly thyOffsetBottom: i0.InputSignalWithTransform<number, unknown>;
+    /**
+     * 固定状态改变时触发的回调函数
+     */
+    readonly thyChange: i0.OutputEmitterRef<boolean>;
+    private readonly placeholderNode;
+    private affixStyle?;
+    private placeholderStyle?;
+    private positionChangeSubscription;
+    private offsetChanged$;
+    private destroy$;
+    private timeout?;
+    private document;
+    private readonly container;
+    constructor();
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    private registerListeners;
+    private removeListeners;
+    getOffset(element: Element, target: Element | Window | undefined): SimpleRect;
+    private setAffixStyle;
+    private setPlaceholderStyle;
+    private syncPlaceholderStyle;
+    updatePosition(e: Event): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ThyAffix, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ThyAffix, "thy-affix", ["thyAffix"], { "thyContainer": { "alias": "thyContainer"; "required": false; "isSignal": true; }; "thyOffsetTop": { "alias": "thyOffsetTop"; "required": false; "isSignal": true; }; "thyOffsetBottom": { "alias": "thyOffsetBottom"; "required": false; "isSignal": true; }; }, { "thyChange": "thyChange"; }, never, ["*"], true, never>;
+}
+
+declare class ThyAffixModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<ThyAffixModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<ThyAffixModule, never, [typeof i1.CommonModule, typeof i2.PlatformModule, typeof ThyAffix], [typeof ThyAffix]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<ThyAffixModule>;
+}
+
+export { ThyAffix, ThyAffixModule };

package/alert/index.d.ts

@@ -1,3 +1,74 @@
-export * from './alert.module';
-export * from './alert.component';
-export * from './alert.directive';
+import * as _angular_core from '@angular/core';
+import { TemplateRef } from '@angular/core';
+import * as i1 from '@angular/common';
+import * as i2 from 'ngx-tethys/icon';
+
+type ThyAlertType = 'success' | 'warning' | 'danger' | 'info' | 'primary' | 'primary-weak' | 'success-weak' | 'warning-weak' | 'danger-weak';
+type ThyAlertTheme = 'fill' | 'bordered' | 'naked';
+/**
+ * 警告提示，展现需要关注的信息
+ * @name thy-alert
+ * @order 10
+ */
+declare class ThyAlert {
+    private hidden;
+    private hostRenderer;
+    messageIsTemplate: _angular_core.Signal<boolean>;
+    /**
+     * 指定警告提示的类型
+     * @type success | warning | danger | info | primary | primary-weak | success-weak | warning-weak | danger-weak
+     * @default info
+     */
+    thyType: _angular_core.InputSignal<ThyAlertType>;
+    /**
+     * 指定警告提示的主题
+     * @type fill | bordered | naked
+     * @default fill
+     */
+    thyTheme: _angular_core.InputSignal<ThyAlertTheme>;
+    /**
+     * 显示警告提示的内容
+     */
+    thyMessage: _angular_core.InputSignal<string | TemplateRef<HTMLElement>>;
+    /**
+     * 显示自定义图标，可传 true/false 控制是否显示图标，或者传字符串去指定图标名称
+     */
+    thyIcon: _angular_core.InputSignal<string | boolean>;
+    icon: _angular_core.Signal<string>;
+    /**
+     * 是否显示关闭警告框按钮，默认不显示
+     * @default false
+     */
+    thyCloseable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * 警告框自定义操作
+     * @type TemplateRef
+     */
+    alertOperation: _angular_core.Signal<TemplateRef<any>>;
+    constructor();
+    closeAlert(): void;
+    private updateClass;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThyAlert, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ThyAlert, "thy-alert", never, { "thyType": { "alias": "thyType"; "required": false; "isSignal": true; }; "thyTheme": { "alias": "thyTheme"; "required": false; "isSignal": true; }; "thyMessage": { "alias": "thyMessage"; "required": false; "isSignal": true; }; "thyIcon": { "alias": "thyIcon"; "required": false; "isSignal": true; }; "thyCloseable": { "alias": "thyCloseable"; "required": false; "isSignal": true; }; }, {}, ["alertOperation"], never, true, never>;
+}
+
+/**
+ * 操作按钮的样式指令，可为警告内容添加自定义操作按钮样式
+ * @name thyAlertActionItem
+ * @order 20
+ */
+declare class ThyAlertActionItemDirective {
+    class: boolean;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThyAlertActionItemDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ThyAlertActionItemDirective, "[thyAlertActionItem]", never, {}, {}, never, never, true, never>;
+}
+
+declare class ThyAlertModule {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThyAlertModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<ThyAlertModule, never, [typeof i1.CommonModule, typeof i2.ThyIconModule, typeof ThyAlert, typeof ThyAlertActionItemDirective], [typeof ThyAlert, typeof ThyAlertActionItemDirective]>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<ThyAlertModule>;
+}
+
+export { ThyAlert, ThyAlertActionItemDirective, ThyAlertModule };
+export type { ThyAlertTheme };

package/anchor/index.d.ts

@@ -1,3 +1,118 @@
-export * from './anchor.module';
-export * from './anchor.component';
-export * from './anchor-link.component';
+import * as _angular_core from '@angular/core';
+import { OnInit, OnDestroy, ElementRef, Signal, TemplateRef, AfterViewInit } from '@angular/core';
+import * as i1 from '@angular/common';
+import * as i2 from '@angular/cdk/platform';
+import * as i3 from 'ngx-tethys/affix';
+
+interface IThyAnchorLinkComponent {
+}
+interface IThyAnchorComponent {
+    registerLink(link: IThyAnchorLinkComponent): void;
+    unregisterLink(link: IThyAnchorLinkComponent): void;
+    handleScrollTo(linkComponent: IThyAnchorLinkComponent): void;
+}
+
+/**
+ * 锚点链接组件，可供锚点跳转
+ * @name thy-anchor-link,thyAnchorLink
+ */
+declare class ThyAnchorLink implements IThyAnchorLinkComponent, OnInit, OnDestroy {
+    elementRef: ElementRef<any>;
+    private anchorComponent;
+    private platform;
+    readonly title: Signal<string | null>;
+    readonly titleTemplate: Signal<TemplateRef<any>>;
+    private hostRenderer;
+    /**
+     * 锚点链接
+     */
+    readonly thyHref: _angular_core.InputSignal<string>;
+    /**
+     * 文字内容
+     */
+    readonly thyTitle: _angular_core.InputSignal<string | TemplateRef<void>>;
+    readonly thyTemplate: Signal<TemplateRef<void>>;
+    readonly linkTitle: Signal<ElementRef<HTMLAnchorElement>>;
+    constructor();
+    ngOnInit(): void;
+    getLinkTitleElement(): HTMLAnchorElement;
+    setActive(): void;
+    unsetActive(): void;
+    goToClick(e: Event): void;
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThyAnchorLink, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ThyAnchorLink, "thy-link,thy-anchor-link", ["thyLink", "thyAnchorLink"], { "thyHref": { "alias": "thyHref"; "required": false; "isSignal": true; }; "thyTitle": { "alias": "thyTitle"; "required": false; "isSignal": true; }; }, {}, ["thyTemplate"], ["*"], true, never>;
+}
+
+/**
+ * 锚点组件
+ * @name thy-anchor
+ */
+declare class ThyAnchor implements IThyAnchorComponent, OnDestroy, AfterViewInit {
+    private document;
+    private cdr;
+    private platform;
+    private zone;
+    private renderer;
+    private scrollService;
+    readonly ink: Signal<ElementRef<any>>;
+    /**
+     * 固定模式
+     */
+    readonly thyAffix: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * 锚点区域边界，单位：px
+     */
+    readonly thyBounds: _angular_core.InputSignalWithTransform<number, unknown>;
+    /**
+     * 缓冲的偏移量阈值
+     */
+    readonly thyOffsetTop: _angular_core.InputSignalWithTransform<number, unknown>;
+    /**
+     * 指定滚动的容器
+     */
+    readonly thyContainer: _angular_core.InputSignal<string | HTMLElement>;
+    /**
+     * 设置导航方向
+     */
+    readonly thyDirection: _angular_core.InputSignal<"horizontal" | "vertical">;
+    /**
+     * 点击项触发
+     */
+    readonly thyClick: _angular_core.OutputEmitterRef<ThyAnchorLink>;
+    /**
+     * 滚动到某锚点时触发
+     */
+    readonly thyScroll: _angular_core.OutputEmitterRef<ThyAnchorLink>;
+    visible: boolean;
+    readonly wrapperStyle: Signal<{
+        'max-height': string;
+    }>;
+    readonly container: Signal<HTMLElement | Window>;
+    private links;
+    private animating;
+    private destroy$;
+    private handleScrollTimeoutID;
+    registerLink(link: ThyAnchorLink): void;
+    unregisterLink(link: ThyAnchorLink): void;
+    constructor();
+    ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    private warningPrompt;
+    private registerScrollEvent;
+    handleScroll(): void;
+    private clearActive;
+    private handleActive;
+    private setVisible;
+    handleScrollTo(linkComponent: ThyAnchorLink): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThyAnchor, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ThyAnchor, "thy-anchor", ["thyAnchor"], { "thyAffix": { "alias": "thyAffix"; "required": false; "isSignal": true; }; "thyBounds": { "alias": "thyBounds"; "required": false; "isSignal": true; }; "thyOffsetTop": { "alias": "thyOffsetTop"; "required": false; "isSignal": true; }; "thyContainer": { "alias": "thyContainer"; "required": false; "isSignal": true; }; "thyDirection": { "alias": "thyDirection"; "required": false; "isSignal": true; }; }, { "thyClick": "thyClick"; "thyScroll": "thyScroll"; }, never, ["*"], true, never>;
+}
+
+declare class ThyAnchorModule {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThyAnchorModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<ThyAnchorModule, never, [typeof i1.CommonModule, typeof i2.PlatformModule, typeof i3.ThyAffixModule, typeof ThyAnchor, typeof ThyAnchorLink], [typeof ThyAnchor, typeof ThyAnchorLink]>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<ThyAnchorModule>;
+}
+
+export { ThyAnchor, ThyAnchorLink, ThyAnchorModule };

package/arrow-switcher/index.d.ts

@@ -1,2 +1,79 @@
-export * from './module';
-export * from './arrow-switcher.component';
+import * as _angular_core from '@angular/core';
+import { Signal, WritableSignal } from '@angular/core';
+import * as i1 from '@angular/common';
+import * as i2 from 'ngx-tethys/button';
+import * as i3 from 'ngx-tethys/icon';
+import * as i4 from 'ngx-tethys/action';
+import * as i5 from 'ngx-tethys/tooltip';
+import { ControlValueAccessor } from '@angular/forms';
+
+type ThyArrowSwitcherTheme = 'default' | 'lite';
+interface ThyArrowSwitcherEvent {
+    index: number;
+    event: Event;
+}
+/**
+ * 上下条切换组件
+ * @name thy-arrow-switcher
+ * @order 10
+ */
+declare class ThyArrowSwitcher implements ControlValueAccessor {
+    private cd;
+    private disabled;
+    /**
+     * 点击上一条事件
+     */
+    readonly thyPrevious: _angular_core.OutputEmitterRef<ThyArrowSwitcherEvent>;
+    /**
+     * 点击下一条事件
+     */
+    readonly thyNext: _angular_core.OutputEmitterRef<ThyArrowSwitcherEvent>;
+    /**
+     * 设置上一条 Hover Tooltip 提示
+     */
+    readonly thyPreviousTooltip: _angular_core.InputSignal<string>;
+    /**
+     * 设置下一条 Hover Tooltip 提示
+     */
+    readonly thyNextTooltip: _angular_core.InputSignal<string>;
+    /**
+     * 展示主题
+     * @type default | lite
+     */
+    readonly thyTheme: _angular_core.InputSignal<ThyArrowSwitcherTheme>;
+    /**
+     * 总条数
+     */
+    readonly thyTotal: _angular_core.InputSignalWithTransform<number, unknown>;
+    /**
+     * 尺寸大小，默认尺寸为大号，取值为`sm`时展示小号
+     */
+    readonly thySize: _angular_core.InputSignal<string>;
+    readonly isSmallSize: Signal<boolean>;
+    protected readonly index: WritableSignal<number>;
+    readonly previousDisabled: Signal<boolean>;
+    readonly nextDisabled: Signal<boolean>;
+    private onModelChange;
+    private onModelTouched;
+    protected readonly previousTooltip: WritableSignal<string>;
+    protected readonly nextTooltip: WritableSignal<string>;
+    setPreviousTooltip(value: string): void;
+    setNextTooltip(value: string): void;
+    writeValue(value: number): void;
+    registerOnChange(fn: () => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisable: boolean): void;
+    onPreviousClick(event: Event): void;
+    onNextClick(event: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThyArrowSwitcher, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ThyArrowSwitcher, "thy-arrow-switcher", never, { "thyPreviousTooltip": { "alias": "thyPreviousTooltip"; "required": false; "isSignal": true; }; "thyNextTooltip": { "alias": "thyNextTooltip"; "required": false; "isSignal": true; }; "thyTheme": { "alias": "thyTheme"; "required": false; "isSignal": true; }; "thyTotal": { "alias": "thyTotal"; "required": false; "isSignal": true; }; "thySize": { "alias": "thySize"; "required": false; "isSignal": true; }; }, { "thyPrevious": "thyPrevious"; "thyNext": "thyNext"; }, never, never, true, never>;
+}
+
+declare class ThyArrowSwitcherModule {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThyArrowSwitcherModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<ThyArrowSwitcherModule, never, [typeof i1.CommonModule, typeof i2.ThyButtonModule, typeof i3.ThyIconModule, typeof i4.ThyActionModule, typeof i5.ThyTooltipModule, typeof ThyArrowSwitcher], [typeof ThyArrowSwitcher]>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<ThyArrowSwitcherModule>;
+}
+
+export { ThyArrowSwitcher, ThyArrowSwitcherModule };
+export type { ThyArrowSwitcherEvent, ThyArrowSwitcherTheme };