@tekus/design-system 5.34.0 → 5.36.0

package/types/tekus-design-system-components-modal.d.ts

@@ -56,19 +56,19 @@ declare class ModalComponent<T = unknown> implements OnDestroy {
     private readonly contentHost;
     private componentRef?;
     /** The dialog ref associated with this modal */
-    dialogRef: _angular_core.InputSignal<TkDialogRef<ModalComponent<T>, unknown> | null>;
+    readonly dialogRef: _angular_core.InputSignal<TkDialogRef<ModalComponent<T>, unknown> | null>;
     /** The title displayed at the top of the modal */
-    title: _angular_core.InputSignal<string>;
+    readonly title: _angular_core.InputSignal<string>;
     /** The main content of the modal. Can be a string or a Component Type. */
-    content: _angular_core.InputSignal<string | Type<T> | null>;
+    readonly content: _angular_core.InputSignal<string | Type<T> | null>;
     /** Array of footer buttons with label, callback, and return value */
-    footerButtons: _angular_core.ModelSignal<ModalFooterButton[]>;
+    readonly footerButtons: _angular_core.ModelSignal<ModalFooterButton[]>;
     /** Modal size: 'small', 'large', 'medium' or 'full' */
-    size: _angular_core.InputSignal<ModalSizeType>;
+    readonly size: _angular_core.InputSignal<ModalSizeType>;
     /** Whether the modal can be closed by the user via close button */
-    closable: _angular_core.InputSignal<boolean>;
+    readonly closable: _angular_core.InputSignal<boolean>;
     /** Whether clicking outside the modal mask closes the modal */
-    closeOnOutsideClick: _angular_core.InputSignal<boolean>;
+    readonly closeOnOutsideClick: _angular_core.InputSignal<boolean>;
     /**
      * Optional data to be passed as inputs to the dynamic component.
      */
@@ -77,15 +77,15 @@ declare class ModalComponent<T = unknown> implements OnDestroy {
      * Optional interceptor called before the modal closes.
      * MUST be synchronous. Returns true to allow closing.
      */
-    interceptor: _angular_core.InputSignal<TkCloseInterceptor | undefined>;
+    readonly interceptor: _angular_core.InputSignal<TkCloseInterceptor | undefined>;
     /** Computed: whether the content is a simple string */
-    isContentString: _angular_core.Signal<boolean>;
+    readonly isContentString: _angular_core.Signal<boolean>;
     /** Computed: whether the modal has footer buttons to display */
-    hasFooter: _angular_core.Signal<boolean>;
+    readonly hasFooter: _angular_core.Signal<boolean>;
     /** Whether the modal should be responsive on mobile screens */
-    responsive: _angular_core.InputSignal<boolean>;
+    readonly responsive: _angular_core.InputSignal<boolean>;
     /** Visibility flag as Model Signal (allows two-way binding) */
-    isOpened: _angular_core.ModelSignal<boolean>;
+    readonly isOpened: _angular_core.ModelSignal<boolean>;
     /** Whether the modal content has a scrollbar */
     hasScroll: boolean;
     /** Emits when the modal closes, passing the return value from footer buttons or null */
@@ -93,14 +93,27 @@ declare class ModalComponent<T = unknown> implements OnDestroy {
     private alreadyEmitted;
     private returnValueOnClose;
     constructor();
+    /**
+     * @summary Orchestrates the reactive dynamic lifecycle.
+     * @private
+     */
+    private registerContentLifecycleEffect;
+    /**
+     * @private
+     */
+    private registerDataSyncEffect;
     /** Computed: calculates modal max-width based on `size` */
-    modalMaxWidth: _angular_core.Signal<"67.5rem" | "35rem" | "98vw" | "25rem">;
+    modalMaxWidth: _angular_core.Signal<"67.5rem" | "35rem" | "98vw" | "28.125rem">;
     ngOnDestroy(): void;
     /**
      * @summary Orchestrates dynamic rendering and destruction based on visibility.
      * @private
      */
     private attachDynamicContent;
+    /**
+     * @private
+     */
+    private createContentInjector;
     /**
      * @summary Synchronizes incoming data record with the dynamic instance @Inputs.
      * @private
@@ -126,6 +139,11 @@ declare class ModalComponent<T = unknown> implements OnDestroy {
      * @param returnValue (Optional) Value to emit on close.
      */
     tryClose(returnValue?: unknown): void;
+    /**
+     * @summary Evaluates the optional close interceptor, then executes closure.
+     * @private
+     */
+    private resolveInterceptorAndClose;
     /**
      * Evaluates a boolean, Promise or Observable to check if closing is allowed.
      */

package/types/tekus-design-system-components-process-steps.d.ts

@@ -0,0 +1,72 @@
+import * as _angular_core from '@angular/core';
+
+type StepState = 'waiting' | 'active' | 'done' | 'error' | 'warning';
+interface ProcessStep {
+    label: string;
+    state: StepState;
+    /** Optional secondary line shown below the label — e.g. "Errors detected — check notifications" for a failed step. */
+    description?: string;
+}
+/**
+ * Overall result of the process:
+ * - `progress`: shows the spinner header and the step list.
+ * - `success` | `error` | `warning`: replaces the progress view with a
+ *   final result message (used once polling finishes).
+ */
+type ProcessStepsStatus = 'progress' | 'success' | 'error' | 'warning';
+
+declare class ProcessStepsComponent {
+    readonly steps: _angular_core.InputSignal<ProcessStep[]>;
+    readonly title: _angular_core.InputSignal<string>;
+    readonly description: _angular_core.InputSignal<string | undefined>;
+    readonly icon: _angular_core.InputSignal<string>;
+    readonly status: _angular_core.InputSignal<ProcessStepsStatus>;
+    /** Whether to show the spinner + icon header while `status` is `progress`. */
+    readonly showIcon: _angular_core.InputSignal<boolean>;
+    /**
+     * Strips the panel down to just the step list: no padding, and no
+     * `title`/`description` header while `status` is `progress` — for hosts
+     * that provide their own framing (e.g. a card) and already show the file
+     * name elsewhere. The final result view (`success`/`error`/`warning`)
+     * still shows its own title/message, since that's the only place the
+     * outcome text is surfaced.
+     */
+    readonly compact: _angular_core.InputSignal<boolean>;
+    /** Specific problems to list inside the result message box (ignored when `status` is `success`). */
+    readonly errors: _angular_core.InputSignal<string[]>;
+    /** Seconds until the countdown finishes; omit to disable it. */
+    readonly countdownSeconds: _angular_core.InputSignal<number | undefined>;
+    /**
+     * Countdown text; `{seconds}` is replaced with the seconds left. Defaults to a "closing"
+     * message, but the countdown isn't only for closing — override it to match what
+     * `(countdownFinished)` actually does.
+     */
+    readonly countdownLabel: _angular_core.InputSignal<string>;
+    /** Emitted once when the countdown reaches zero — the consumer decides what happens next (close a modal, show a toast, etc.). */
+    readonly countdownFinished: _angular_core.OutputEmitterRef<void>;
+    /** Seconds left in the countdown, or `undefined` while it's disabled. */
+    readonly remainingSeconds: _angular_core.WritableSignal<number | undefined>;
+    constructor();
+    /** Starts (or disables) the countdown whenever `status`/`countdownSeconds` change. */
+    private runCountdown;
+    /** Decrements `remainingSeconds` by one and emits `countdownFinished` once it bottoms out. */
+    private tickCountdown;
+    /**
+     * Accessible suffix announced per step since state is otherwise
+     * conveyed only through color/icon.
+     */
+    stepStatusLabel(state: StepState): string;
+    readonly resultIcon: _angular_core.Signal<string>;
+    readonly resultColor: _angular_core.Signal<"warning" | "success" | "danger">;
+    /** Severity for the message box wrapping `description`/`errors` (success has no box). */
+    readonly resultMessageSeverity: _angular_core.Signal<"error" | "warn">;
+    /** Severity for the compact terminal banner (`tk-message`) — unlike `resultMessageSeverity`, success gets its own box here. */
+    readonly bannerSeverity: _angular_core.Signal<"error" | "success" | "warn">;
+    /** `countdownLabel` with `{seconds}` filled in, or `undefined` while the countdown is disabled. */
+    readonly countdownText: _angular_core.Signal<string | undefined>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ProcessStepsComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ProcessStepsComponent, "tk-process-steps", never, { "steps": { "alias": "steps"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "showIcon": { "alias": "showIcon"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "countdownSeconds": { "alias": "countdownSeconds"; "required": false; "isSignal": true; }; "countdownLabel": { "alias": "countdownLabel"; "required": false; "isSignal": true; }; }, { "countdownFinished": "countdownFinished"; }, never, never, true, never>;
+}
+
+export { ProcessStepsComponent };
+export type { ProcessStep, ProcessStepsStatus, StepState };

package/types/tekus-design-system-components-sidebar-layout.d.ts

@@ -1,5 +1,6 @@
 import * as i0 from '@angular/core';
 import { OnInit, OnDestroy } from '@angular/core';
+import { TkHeaderAction } from '@tekus/design-system/components/header';
 import * as rxjs from 'rxjs';
 import { MenuItem } from 'primeng/api';
 
@@ -18,6 +19,10 @@ declare class SidebarLayoutComponent implements OnInit, OnDestroy {
      * If provided, it overrides the service state.
      */
     isCollapsed: i0.InputSignal<boolean | undefined>;
+    /**
+     * Actions rendered in the right zone of the header via tk-header.
+     */
+    headerActions: i0.InputSignal<TkHeaderAction[]>;
     /**
      * Emitted when the collapsed state changes.
      */
@@ -37,6 +42,11 @@ declare class SidebarLayoutComponent implements OnInit, OnDestroy {
      * Determines if the sidebar is currently collapsed.
      */
     get displayCollapsed(): boolean;
+    /**
+     * Returns the left actions for tk-header: includes the toggle button
+     * only when the sidebar is collapsed or in tablet/mobile mode.
+     */
+    get headerLeftActions(): TkHeaderAction[];
     /**
      * Toggles the sidebar state.
      */
@@ -55,7 +65,7 @@ declare class SidebarLayoutComponent implements OnInit, OnDestroy {
      */
     handleBackdropClick(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SidebarLayoutComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SidebarLayoutComponent, "tk-sidebar-layout", never, { "isCollapsed": { "alias": "isCollapsed"; "required": false; "isSignal": true; }; }, { "collapsedChange": "collapsedChange"; }, never, ["[sidebar-content]", "[header-actions]", "*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SidebarLayoutComponent, "tk-sidebar-layout", never, { "isCollapsed": { "alias": "isCollapsed"; "required": false; "isSignal": true; }; "headerActions": { "alias": "headerActions"; "required": false; "isSignal": true; }; }, { "collapsedChange": "collapsedChange"; }, never, ["[sidebar-content]", "*"], true, never>;
 }
 
 declare class SidebarService {