shirkasoft-ui-components 1.2.0 → 1.3.0

package/types/shirkasoft-ui-components-fieldset.d.ts

@@ -0,0 +1,72 @@
+import * as _angular_core from '@angular/core';
+
+/** An action button rendered on the right side of the fieldset header. */
+interface FieldsetHeaderAction {
+    label: string;
+    icon: string | any;
+    onClick: () => void;
+    class?: string;
+    isVisible?: () => boolean;
+    isDisabled?: () => boolean;
+}
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Collapsible content group with a legend header, optional leading icon,
+ * badge and action buttons on the right side.
+ */
+declare class FieldsetComponent {
+    protected getIcon: (name: any) => any;
+    /** Title shown in the header. */
+    legend: _angular_core.InputSignal<string>;
+    /** Collapsed state (default: collapsed). Two-way bindable with [(collapsed)]. */
+    collapsed: _angular_core.ModelSignal<boolean>;
+    /** Whether the header toggles the content. */
+    toggleable: _angular_core.InputSignal<boolean>;
+    /** Shows the expand/collapse icon button. */
+    showToggleIcon: _angular_core.InputSignal<boolean>;
+    /** Optional leading icon shown next to the legend. */
+    icon: _angular_core.InputSignal<any>;
+    /** Optional badge/count shown after the legend. */
+    badge: _angular_core.InputSignal<string | number>;
+    /** CSS classes for the badge (override). */
+    badgeClass: _angular_core.InputSignal<string>;
+    /** Icon shown when collapsed. */
+    collapsedIcon: _angular_core.InputSignal<string>;
+    /** Icon shown when expanded. */
+    expandedIcon: _angular_core.InputSignal<string>;
+    /** Action buttons rendered on the right side of the header. */
+    headerActions: _angular_core.InputSignal<FieldsetHeaderAction[]>;
+    /** Custom content templates: key 'legend' (context: $implicit collapsed, expanded). */
+    customTemplates: _angular_core.InputSignal<{
+        [key: string]: any;
+    }>;
+    /** CSS classes for the extra shadow styling of the panel. */
+    hasShadow: _angular_core.InputSignal<boolean>;
+    /** Accessible label for the expand action. */
+    expandLabel: _angular_core.InputSignal<string>;
+    /** Accessible label for the collapse action. */
+    collapseLabel: _angular_core.InputSignal<string>;
+    /** Emits the new expanded state when toggled. */
+    toggle: _angular_core.OutputEmitterRef<boolean>;
+    /** Emitted when the fieldset is expanded. */
+    expand: _angular_core.OutputEmitterRef<void>;
+    /** Emitted when the fieldset is collapsed. */
+    collapse: _angular_core.OutputEmitterRef<void>;
+    /** Stable id linking the header button and the content region. */
+    contentId: string;
+    /** Toggles the collapsed state and emits the new state (unless not toggleable). */
+    onToggle(): void;
+    /** Whether a header action can be rendered. */
+    isHeaderActionVisible(action: FieldsetHeaderAction): boolean;
+    /** Whether a header action should be disabled. */
+    isHeaderActionDisabled(action: FieldsetHeaderAction): boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FieldsetComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FieldsetComponent, "shk-fieldset", never, { "legend": { "alias": "legend"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "toggleable": { "alias": "toggleable"; "required": false; "isSignal": true; }; "showToggleIcon": { "alias": "showToggleIcon"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "badge": { "alias": "badge"; "required": false; "isSignal": true; }; "badgeClass": { "alias": "badgeClass"; "required": false; "isSignal": true; }; "collapsedIcon": { "alias": "collapsedIcon"; "required": false; "isSignal": true; }; "expandedIcon": { "alias": "expandedIcon"; "required": false; "isSignal": true; }; "headerActions": { "alias": "headerActions"; "required": false; "isSignal": true; }; "customTemplates": { "alias": "customTemplates"; "required": false; "isSignal": true; }; "hasShadow": { "alias": "hasShadow"; "required": false; "isSignal": true; }; "expandLabel": { "alias": "expandLabel"; "required": false; "isSignal": true; }; "collapseLabel": { "alias": "collapseLabel"; "required": false; "isSignal": true; }; }, { "collapsed": "collapsedChange"; "toggle": "toggle"; "expand": "expand"; "collapse": "collapse"; }, never, ["*"], true, never>;
+}
+
+export { FieldsetComponent };
+export type { FieldsetHeaderAction };

package/types/shirkasoft-ui-components-file-upload.d.ts

@@ -0,0 +1,87 @@
+import * as _angular_core from '@angular/core';
+
+interface FileUploadError {
+    type: 'size' | 'type';
+    message: string;
+    file: File;
+}
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Drag & drop file uploader with file type/size validation, image previews,
+ * multiple files support and localized error messages.
+ */
+declare class FileUploadComponent {
+    protected getIcon: (name: any) => any;
+    private transloco;
+    /** Main label of the uploader. */
+    label: _angular_core.InputSignal<string>;
+    /** Accepted MIME types/extensions (e.g. 'image/*', '.pdf'). */
+    accept: _angular_core.InputSignal<string>;
+    /** Maximum allowed size per file (bytes). */
+    maxFileSize: _angular_core.InputSignal<number>;
+    /** Maximum number of files (0 = unlimited). */
+    maxFiles: _angular_core.InputSignal<number>;
+    /** Text of the file picker button. */
+    fileUploadText: _angular_core.InputSignal<string>;
+    /** Helper text shown next to the label. */
+    fileRecommendation: _angular_core.InputSignal<string>;
+    /** Text shown when files are already loaded. */
+    changeFilesText: _angular_core.InputSignal<string>;
+    /** Enables selecting more than one file at once. */
+    multiple: _angular_core.InputSignal<boolean>;
+    /** Emitted with the currently selected files. */
+    fileSelected: _angular_core.OutputEmitterRef<File[]>;
+    /** Emitted when the last selected file is removed. */
+    fileRemoved: _angular_core.OutputEmitterRef<void>;
+    /** Emitted when a file fails validation (type/size). */
+    fileError: _angular_core.OutputEmitterRef<FileUploadError>;
+    /** Emitted when a file is near the size limit. */
+    fileWarning: _angular_core.OutputEmitterRef<FileUploadError>;
+    /** Currently selected files. */
+    selectedFiles: _angular_core.WritableSignal<File[]>;
+    /** Localized error message displayed to the user. */
+    errorMessage: _angular_core.WritableSignal<string>;
+    /** Whether the user is dragging files over the zone. */
+    isDragOver: _angular_core.WritableSignal<boolean>;
+    /** Object URLs used for image previews. */
+    private previewUrls;
+    /** Whether another selection is allowed. */
+    canAddMore: _angular_core.Signal<boolean>;
+    /** True when the maximum number of files has been reached. */
+    maxReached: _angular_core.Signal<boolean>;
+    /** Whether the file is an image (used for previews). */
+    isImageFile(file: File): boolean;
+    /** Returns (creating on demand) the object URL for a file preview. */
+    previewUrl(file: File): string;
+    /** Marks the drop zone as active while dragging over it. */
+    onDragOver(event: DragEvent): void;
+    /** Clears the drag-over state when the drag leaves the zone. */
+    onDragLeave(event: DragEvent): void;
+    /** Processes the files dropped on the zone. */
+    onDrop(event: DragEvent): void;
+    /** Processes the files picked from the native file input. */
+    onFileChange(event: Event): void;
+    /** Validates and appends the received files, emitting errors/warnings. */
+    private processFiles;
+    /** Validates a file against `accept` and `maxFileSize`. */
+    private validateFile;
+    /** Emits a warning when the file is close to the size limit (>90%). */
+    private checkSizeWarning;
+    /** Removes a file, revoking its preview URL. */
+    removeFile(file: File): void;
+    /** Clears all selected files and previews. */
+    changeFiles(): void;
+    /** Revokes every stored preview object URL. */
+    private clearPreviews;
+    /** Human readable size (B/KB/MB). */
+    private formatFileSize;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FileUploadComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FileUploadComponent, "shk-file-upload", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "maxFileSize": { "alias": "maxFileSize"; "required": false; "isSignal": true; }; "maxFiles": { "alias": "maxFiles"; "required": false; "isSignal": true; }; "fileUploadText": { "alias": "fileUploadText"; "required": false; "isSignal": true; }; "fileRecommendation": { "alias": "fileRecommendation"; "required": false; "isSignal": true; }; "changeFilesText": { "alias": "changeFilesText"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; }, { "fileSelected": "fileSelected"; "fileRemoved": "fileRemoved"; "fileError": "fileError"; "fileWarning": "fileWarning"; }, never, never, true, never>;
+}
+
+export { FileUploadComponent };
+export type { FileUploadError };

package/types/shirkasoft-ui-components-knob.d.ts

@@ -0,0 +1,69 @@
+import * as _angular_core from '@angular/core';
+import { ElementRef } from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** SVG radial knob with drag and keyboard support. Implements ControlValueAccessor. */
+declare class KnobComponent implements ControlValueAccessor {
+    /** Current value. Two-way bindable with [(value)]. */
+    value: _angular_core.ModelSignal<number>;
+    /** Minimum value. */
+    min: _angular_core.InputSignal<number>;
+    /** Maximum value. */
+    max: _angular_core.InputSignal<number>;
+    /** Increment used by arrows and pointer drag rounding. */
+    step: _angular_core.InputSignal<number>;
+    /** Diameter of the knob in px. */
+    size: _angular_core.InputSignal<number>;
+    /** Thickness of the arc stroke. */
+    strokeWidth: _angular_core.InputSignal<number>;
+    /** Color of the filled arc. */
+    valueColor: _angular_core.InputSignal<string>;
+    /** Color of the track arc. */
+    rangeColor: _angular_core.InputSignal<string>;
+    /** Whether the current value is shown in the center. */
+    showValue: _angular_core.InputSignal<boolean>;
+    /** Disables user interaction. */
+    disabled: _angular_core.InputSignal<boolean>;
+    /** Blocks editing but keeps the control styled as enabled. */
+    readonly: _angular_core.InputSignal<boolean>;
+    /** Accessible label. */
+    ariaLabel: _angular_core.InputSignal<string>;
+    /** Emitted when the knob value changes. */
+    change: _angular_core.OutputEmitterRef<number>;
+    /** Emitted when the user releases the pointer. */
+    end: _angular_core.OutputEmitterRef<number>;
+    protected knobSvg: _angular_core.Signal<ElementRef<SVGElement> | undefined>;
+    private onChange;
+    private onTouched;
+    private dragging;
+    private formDisabled;
+    /** Effective disabled state combining the `disabled` input and the form binding. */
+    protected effectiveDisabled: _angular_core.Signal<boolean>;
+    protected r: _angular_core.Signal<number>;
+    protected center: _angular_core.Signal<number>;
+    protected fraction: _angular_core.Signal<number>;
+    protected rangeArc: _angular_core.Signal<string>;
+    protected valueArc: _angular_core.Signal<string>;
+    writeValue(value: any): void;
+    registerOnChange(fn: any): void;
+    registerOnTouched(fn: any): void;
+    setDisabledState(isDisabled: boolean): void;
+    onPointerDown(event: PointerEvent): void;
+    onPointerMove(event: PointerEvent): void;
+    onPointerUp(event: PointerEvent): void;
+    updateByKey(step: number): void;
+    private applyEvent;
+    private setValue;
+    private clamp;
+    private getArcPath;
+    private anglePoint;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KnobComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KnobComponent, "shk-knob", never, { "value": { "alias": "value"; "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; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "strokeWidth": { "alias": "strokeWidth"; "required": false; "isSignal": true; }; "valueColor": { "alias": "valueColor"; "required": false; "isSignal": true; }; "rangeColor": { "alias": "rangeColor"; "required": false; "isSignal": true; }; "showValue": { "alias": "showValue"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "change": "change"; "end": "end"; }, never, never, true, never>;
+}
+
+export { KnobComponent };

package/types/shirkasoft-ui-components-loading.d.ts

@@ -0,0 +1,94 @@
+import * as _angular_core from '@angular/core';
+
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** Circular indeterminate spinner. */
+declare class LoadingSpinnerComponent {
+    /** Diameter of the spinner. */
+    size: _angular_core.InputSignal<string>;
+    /** Border thickness in px. */
+    thickness: _angular_core.InputSignal<number>;
+    /** Color of the moving arc. Defaults to the primary token. */
+    color: _angular_core.InputSignal<string>;
+    /** Optional text shown under the spinner. */
+    label: _angular_core.InputSignal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<LoadingSpinnerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<LoadingSpinnerComponent, "shk-loading-spinner", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "thickness": { "alias": "thickness"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** Progress bar with an indeterminate sweep or a determinate percentage. */
+declare class LoadingBarComponent {
+    /** Height of the bar. */
+    height: _angular_core.InputSignal<string>;
+    /** When true the bar animates without a known percentage. */
+    indeterminate: _angular_core.InputSignal<boolean>;
+    /** Current progress 0-100 when `indeterminate` is false. */
+    progress: _angular_core.InputSignal<number>;
+    /** Fill color. Defaults to the primary token. */
+    color: _angular_core.InputSignal<string>;
+    /** Renders fully rounded ends. */
+    rounded: _angular_core.InputSignal<boolean>;
+    /** Fill width/style for the determinate mode, empty for indeterminate. */
+    protected fillStyle: _angular_core.Signal<{
+        width?: undefined;
+    } | {
+        width: string;
+    }>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<LoadingBarComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<LoadingBarComponent, "shk-loading-bar", never, { "height": { "alias": "height"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "progress": { "alias": "progress"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/** Backdrop style behind the overlay: none, light or dark. */
+type LoadingOverlayBackdrop = 'transparent' | 'light' | 'dark';
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** Wraps content and shows a centered spinner over it while `visible` is true. */
+declare class LoadingOverlayComponent {
+    /** Controls whether the spinner layer is shown. */
+    visible: _angular_core.InputSignal<boolean>;
+    /** Optional text under the spinner. */
+    message: _angular_core.InputSignal<string>;
+    /** Diameter of the spinner. */
+    spinnerSize: _angular_core.InputSignal<string>;
+    /** Spinner color. Defaults to the primary token. */
+    color: _angular_core.InputSignal<string>;
+    /** Backdrop behind the spinner. */
+    backdrop: _angular_core.InputSignal<LoadingOverlayBackdrop>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<LoadingOverlayComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<LoadingOverlayComponent, "shk-loading-overlay", never, { "visible": { "alias": "visible"; "required": false; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "spinnerSize": { "alias": "spinnerSize"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "backdrop": { "alias": "backdrop"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** Bouncing dots loading indicator. */
+declare class LoadingDotsComponent {
+    /** Diameter of each dot. */
+    size: _angular_core.InputSignal<string>;
+    /** Dot color. Defaults to the primary token. */
+    color: _angular_core.InputSignal<string>;
+    /** Number of dots. */
+    count: _angular_core.InputSignal<number>;
+    /** Optional text shown next to the dots. */
+    label: _angular_core.InputSignal<string>;
+    /** Array of dot indices to render based on the `count` input. */
+    protected dots: _angular_core.Signal<unknown[]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<LoadingDotsComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<LoadingDotsComponent, "shk-loading-dots", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "count": { "alias": "count"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { LoadingBarComponent, LoadingDotsComponent, LoadingOverlayComponent, LoadingSpinnerComponent };
+export type { LoadingOverlayBackdrop };

package/types/shirkasoft-ui-components-modal.d.ts

@@ -0,0 +1,139 @@
+import * as _angular_core from '@angular/core';
+import { Type, ViewContainerRef, ComponentRef } from '@angular/core';
+
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** Options for opening a modal through the service. */
+interface ModalConfig {
+    /** Title shown in the modal header. */
+    title: string;
+    /** Component rendered inside the modal body. */
+    component: Type<any>;
+    /** Data passed to the modal component via inputs. */
+    data?: Record<string, any>;
+    /** Modal width (CSS value). */
+    width?: string;
+    /** Whether the accept/cancel buttons are shown. */
+    showButtons?: boolean;
+    /** Whether the expand (fullscreen) button is shown. */
+    showExpandButton?: boolean;
+    /** Label of the accept button. */
+    acceptLabel?: string;
+    /** Label of the cancel button. */
+    cancelLabel?: string;
+    /** Optional callback invoked when the modal closes. */
+    onClose?: () => void;
+}
+/**
+ * Global modal manager. Opens modals on a stack, exposing reactive access to
+ * the current modal and the top-most opened config.
+ */
+declare class ModalService {
+    /** Stack of open modals (top-most renders on top). */
+    private stackSignal;
+    /** Counter emitted on each close, used to trigger close animations. */
+    private closeRequestSignal;
+    private router;
+    private destroyRef;
+    constructor();
+    /** Reactive list of open modals. */
+    modalStack: _angular_core.Signal<ModalConfig[]>;
+    /** Top-most modal on the stack, or null. */
+    currentModal: _angular_core.Signal<ModalConfig | null>;
+    /** Reactive close-request counter. */
+    closeRequest: _angular_core.Signal<number>;
+    /** Opens a new modal on top of the stack. */
+    open(config: ModalConfig): void;
+    /** Alias of `close()` used by the accept button. */
+    accept(): void;
+    /** Closes the top-most modal, invoking its onClose callback. */
+    close(): void;
+    /** Closes all open modals at once. */
+    clear(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ModalService>;
+}
+
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Modal dialog that renders a dynamically loaded component, tracks its
+ * form validity and submit outputs, and delegates accept/cancel to the
+ * shared ModalService.
+ */
+declare class ModalComponent {
+    protected getIcon: (name: any) => any;
+    private notificationSrv;
+    private destroyRef;
+    private modalSrv;
+    private transloco;
+    private cdr;
+    /** Reference where the dynamic content is rendered. */
+    container: _angular_core.Signal<ViewContainerRef | undefined>;
+    /** Configuration of the modal currently open (from the service). */
+    currentConfig: _angular_core.WritableSignal<ModalConfig | null>;
+    /** Modal title. */
+    title: _angular_core.WritableSignal<string>;
+    /** Whether the modal is visible. */
+    visible: _angular_core.WritableSignal<boolean>;
+    /** Generic loading flag for the footer actions. */
+    loading: _angular_core.WritableSignal<boolean>;
+    /** Whether the accept action is being processed. */
+    isProcessing: _angular_core.WritableSignal<boolean>;
+    /** Whether the modal is currently expanded to fullscreen. */
+    isExpanded: _angular_core.WritableSignal<boolean>;
+    /** True when the dynamic component reports a valid form. */
+    isFormValid: _angular_core.WritableSignal<boolean>;
+    /** Reference to the dynamically created component. */
+    componentRef: ComponentRef<any> | null;
+    /** Subscriptions to the dynamic component outputs. */
+    private subscriptions;
+    /** Width of the modal (fullscreen when expanded). */
+    computedModalWidth: _angular_core.Signal<string>;
+    /** Whether the footer buttons should be rendered. */
+    modalButtonsVisible: _angular_core.Signal<boolean>;
+    /** Whether the expand/fullscreen button is shown. */
+    showExpandButton: _angular_core.Signal<boolean>;
+    /** Resolved cancel button label. */
+    cancelLabel: _angular_core.Signal<string>;
+    /** Resolved accept button label. */
+    acceptLabel: _angular_core.Signal<string>;
+    constructor();
+    /** Updates visibility when the backdrop/close controls change. */
+    onVisibleChange(show: boolean): void;
+    /** Creates the dynamic component and wires its form/submit outputs. */
+    private loadComponent;
+    /** Subscribes to a dynamic component output if it exists. */
+    private subscribeToOutput;
+    /** Finalizes the submit flow, accepting the modal on success. */
+    private handleSubmit;
+    /** Closes the modal, calling the dynamic component's `handleCancel` if any. */
+    closeModal(): void;
+    /** Performs the actual close sequence and cleanup. */
+    doClose(): void;
+    /** Toggles between normal width and fullscreen. */
+    toggleExpand(): void;
+    /** Validates the dynamic component form and triggers its `onSubmit`. */
+    onAccept(): void;
+    /** Resolves the dynamic component's form (property or getter function). */
+    private getForm;
+    /** Recursively checks for real validation errors (ignoring 'warning'). */
+    private hasRealErrors;
+    /** Marks a form (and all its descendants) as touched. */
+    private markAllAsTouched;
+    /** True when the component exposes both `onSubmit` and a `form`. */
+    private isDynamicComponent;
+    /** Unsubscribes outputs and destroys the dynamic component. */
+    private cleanup;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModalComponent, "shk-modal", never, {}, {}, never, never, true, never>;
+}
+
+export { ModalComponent, ModalService };
+export type { ModalConfig };

package/types/shirkasoft-ui-components-notification.d.ts

@@ -0,0 +1,82 @@
+import * as _angular_core from '@angular/core';
+
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** Toast-style notification entry. */
+interface Notification {
+    id: string;
+    message: string;
+    type: 'success' | 'error' | 'warning' | 'info';
+    /** Current progress 0-100 when `showProgress` is true. */
+    progress?: number;
+    /** Whether the notification renders a progress indicator. */
+    showProgress?: boolean;
+}
+/**
+ * Central notification store. Components push/update/remove notifications
+ * reactively through signals for the notification component to render.
+ */
+declare class NotificationService {
+    /** Reactive list of visible notifications. */
+    private notificationsSignal;
+    /** Monotonic id counter for new notifications. */
+    private currentId;
+    /** Readonly reactive list of visible notifications. */
+    notifications: _angular_core.Signal<Notification[]>;
+    /**
+     * Adds a notification and returns its id. When `showProgress` is false and
+     * `duration` is positive, it auto-removes after that many ms.
+     */
+    addNotification(message: string, type?: Notification['type'], showProgress?: boolean, duration?: number): string;
+    /** Updates a progress notification; auto-removes when progress hits 100. */
+    updateProgress(notificationId: string, progress: number): void;
+    /** Removes the given notification. */
+    removeNotification(notification: Notification): void;
+    /** Removes the notification with the given id. */
+    removeNotificationById(notificationId: string): void;
+    /** Removes every visible notification. */
+    clearAll(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NotificationService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<NotificationService>;
+}
+
+type NotificationPosition = 'center-top' | 'right-top' | 'left-top';
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Toast notification host that renders the notifications pushed through the
+ * NotificationService in the configured position.
+ */
+declare class NotificationComponent {
+    /** Position of the notification stack: center, right or left top. */
+    position: _angular_core.InputSignal<NotificationPosition>;
+    private notificationService;
+    protected getIcon: (name: any) => any;
+    /** Maps each notification type to its internal icon name. */
+    private readonly iconMap;
+    /** Resolves the icon name for a notification type. */
+    getNotificationIcon(type: string): string;
+    /** Live list of active notifications. */
+    notifications: _angular_core.Signal<Notification[]>;
+    /** Notifications sorted with the newest first. */
+    sortedNotifications: _angular_core.Signal<Notification[]>;
+    /** Removes a notification through the service. */
+    removeNotification(notification: Notification): void;
+    /** Rounds the progress value of a notification. */
+    roundProgress(progress: number | undefined): number;
+    /** Whether there are notifications to show. */
+    hasNotifications: _angular_core.Signal<boolean>;
+    /** CSS classes positioning the stack according to `position`. */
+    positionClass: _angular_core.Signal<"fixed top-4 z-[9999] space-y-4 sm:space-y-6 sm:top-6 lg:top-8 right-4" | "fixed top-4 z-[9999] space-y-4 sm:space-y-6 sm:top-6 lg:top-8 left-4" | "fixed top-4 z-[9999] space-y-4 sm:space-y-6 sm:top-6 lg:top-8 left-1/2 -translate-x-1/2">;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NotificationComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NotificationComponent, "shk-notification", never, { "position": { "alias": "position"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { NotificationComponent, NotificationService };
+export type { Notification, NotificationPosition };

package/types/shirkasoft-ui-components-price-input.d.ts

@@ -0,0 +1,41 @@
+import * as _angular_core from '@angular/core';
+
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Numeric input tailored for currency values with a optional percentage mode.
+ * Uses two-way bindable models: `value` and `isPercentage`.
+ */
+declare class PriceInputComponent {
+    /** Numeric value, bindable with [(value)]. */
+    value: _angular_core.ModelSignal<number>;
+    /** Whether the input works as a percentage, bindable with [(isPercentage)]. */
+    isPercentage: _angular_core.ModelSignal<boolean>;
+    /** Label displayed above the field. */
+    label: _angular_core.InputSignal<string>;
+    /** id attribute applied to the native input. */
+    inputId: _angular_core.InputSignal<string>;
+    /** Marks the field as required. */
+    required: _angular_core.InputSignal<boolean>;
+    /** Disables the input. */
+    disabled: _angular_core.InputSignal<boolean>;
+    /** Minimum allowed value. */
+    min: _angular_core.InputSignal<number>;
+    /** Maximum allowed value. */
+    max: _angular_core.InputSignal<number>;
+    /** Shows the error styling on the field. */
+    showError: _angular_core.InputSignal<boolean>;
+    /** Message rendered when the field is in error state. */
+    errorMessage: _angular_core.InputSignal<string>;
+    /** Toggles between amount and percentage modes (unless disabled). */
+    toggleMode(): void;
+    /** Parses the user input and updates the bound `value`. */
+    onInput(event: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PriceInputComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PriceInputComponent, "shk-price-input", never, { "value": { "alias": "value"; "required": true; "isSignal": true; }; "isPercentage": { "alias": "isPercentage"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "showError": { "alias": "showError"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "isPercentage": "isPercentageChange"; }, never, never, true, never>;
+}
+
+export { PriceInputComponent };