shirkasoft-ui-components 1.2.0 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shirkasoft-ui-components",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Angular UI Components Library — themeable via CSS custom properties",
   "keywords": [
     "angular",
@@ -44,6 +44,106 @@
     ".": {
       "types": "./types/shirkasoft-ui-components.d.ts",
       "default": "./fesm2022/shirkasoft-ui-components.mjs"
+    },
+    "./breadcrumb": {
+      "types": "./types/shirkasoft-ui-components-breadcrumb.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-breadcrumb.mjs"
+    },
+    "./button": {
+      "types": "./types/shirkasoft-ui-components-button.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-button.mjs"
+    },
+    "./chart": {
+      "types": "./types/shirkasoft-ui-components-chart.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-chart.mjs"
+    },
+    "./confirm-dialog": {
+      "types": "./types/shirkasoft-ui-components-confirm-dialog.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-confirm-dialog.mjs"
+    },
+    "./date-picker": {
+      "types": "./types/shirkasoft-ui-components-date-picker.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-date-picker.mjs"
+    },
+    "./fieldset": {
+      "types": "./types/shirkasoft-ui-components-fieldset.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-fieldset.mjs"
+    },
+    "./file-upload": {
+      "types": "./types/shirkasoft-ui-components-file-upload.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-file-upload.mjs"
+    },
+    "./knob": {
+      "types": "./types/shirkasoft-ui-components-knob.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-knob.mjs"
+    },
+    "./loading": {
+      "types": "./types/shirkasoft-ui-components-loading.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-loading.mjs"
+    },
+    "./modal": {
+      "types": "./types/shirkasoft-ui-components-modal.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-modal.mjs"
+    },
+    "./notification": {
+      "types": "./types/shirkasoft-ui-components-notification.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-notification.mjs"
+    },
+    "./price-input": {
+      "types": "./types/shirkasoft-ui-components-price-input.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-price-input.mjs"
+    },
+    "./rail-sidebar": {
+      "types": "./types/shirkasoft-ui-components-rail-sidebar.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-rail-sidebar.mjs"
+    },
+    "./select": {
+      "types": "./types/shirkasoft-ui-components-select.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-select.mjs"
+    },
+    "./sidebar": {
+      "types": "./types/shirkasoft-ui-components-sidebar.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-sidebar.mjs"
+    },
+    "./skeleton": {
+      "types": "./types/shirkasoft-ui-components-skeleton.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-skeleton.mjs"
+    },
+    "./table": {
+      "types": "./types/shirkasoft-ui-components-table.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-table.mjs"
+    },
+    "./tabs": {
+      "types": "./types/shirkasoft-ui-components-tabs.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-tabs.mjs"
+    },
+    "./tag": {
+      "types": "./types/shirkasoft-ui-components-tag.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-tag.mjs"
+    },
+    "./text-field": {
+      "types": "./types/shirkasoft-ui-components-text-field.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-text-field.mjs"
+    },
+    "./timeline": {
+      "types": "./types/shirkasoft-ui-components-timeline.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-timeline.mjs"
+    },
+    "./toggle": {
+      "types": "./types/shirkasoft-ui-components-toggle.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-toggle.mjs"
+    },
+    "./tooltip": {
+      "types": "./types/shirkasoft-ui-components-tooltip.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-tooltip.mjs"
+    },
+    "./utils": {
+      "types": "./types/shirkasoft-ui-components-utils.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-utils.mjs"
+    },
+    "./wizard": {
+      "types": "./types/shirkasoft-ui-components-wizard.d.ts",
+      "default": "./fesm2022/shirkasoft-ui-components-wizard.mjs"
     }
   },
   "module": "fesm2022/shirkasoft-ui-components.mjs",

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

@@ -0,0 +1,68 @@
+import * as _angular_core from '@angular/core';
+import { OnInit, OnDestroy } from '@angular/core';
+import { Observable } from 'rxjs';
+
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** A single breadcrumb entry with an optional navigation route. */
+interface BreadcrumbItem {
+    label: string;
+    route?: string;
+}
+/**
+ * Global breadcrumb state. Components and pages write the current trail via
+ * `set()` and observatories read it through `breadcrumbs$`.
+ */
+declare class BreadcrumbService {
+    /** Internal buffer holding the current breadcrumb trail. */
+    private breadcrumbsSubject;
+    /** Observable emitted with the latest breadcrumb trail. */
+    breadcrumbs$: Observable<BreadcrumbItem[]>;
+    /** Replaces the whole breadcrumb trail. */
+    set(items: BreadcrumbItem[]): void;
+    /** Empties the breadcrumb trail. */
+    clear(): void;
+    /** Returns the breadcrumb trail currently held (snapshot). */
+    getCurrent(): BreadcrumbItem[];
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<BreadcrumbService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<BreadcrumbService>;
+}
+
+type BreadcrumbSeparator = 'chevron' | 'slash' | 'arrow';
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Navigation breadcrumb showing the current page hierarchy. Can be fed with
+ * static items or driven by the shared BreadcrumbService.
+ */
+declare class BreadcrumbComponent implements OnInit, OnDestroy {
+    private readonly breadcrumbService;
+    /** Static list of breadcrumb items. Takes precedence over the service items. */
+    items: _angular_core.InputSignal<BreadcrumbItem[]>;
+    /** Visual separator between items: 'chevron', 'slash' or 'arrow'. */
+    separator: _angular_core.InputSignal<BreadcrumbSeparator>;
+    /** When true, subscribes to the BreadcrumbService to resolve items. */
+    useService: _angular_core.InputSignal<boolean>;
+    /** Items received from the BreadcrumbService. */
+    protected serviceItems: _angular_core.WritableSignal<BreadcrumbItem[]>;
+    /** Final items: static `items` if provided, otherwise the service items. */
+    protected resolvedItems: _angular_core.Signal<BreadcrumbItem[]>;
+    /** Active subscription to the breadcrumb stream. */
+    private serviceSub;
+    constructor();
+    /** Subscribes to the BreadcrumbService when `useService` is enabled. */
+    ngOnInit(): void;
+    /** Unsubscribes from the breadcrumb stream to avoid leaks. */
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<BreadcrumbComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BreadcrumbComponent, "shk-breadcrumb", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "separator": { "alias": "separator"; "required": false; "isSignal": true; }; "useService": { "alias": "useService"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { BreadcrumbComponent, BreadcrumbService };
+export type { BreadcrumbItem, BreadcrumbSeparator };

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

@@ -0,0 +1,59 @@
+import * as _angular_core from '@angular/core';
+import { getIcon } from 'shirkasoft-ui-components/utils';
+
+type ButtonSeverity = 'primary' | 'secondary' | 'success' | 'info' | 'warning' | 'danger' | 'help' | 'contrast';
+type ButtonSize = 'small' | 'large';
+type ButtonIconPosition = 'left' | 'right' | 'top' | 'bottom';
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** Generic button with icon, severity variants, loading state and sizes. */
+declare class ButtonComponent {
+    /** Text shown inside the button. */
+    label: _angular_core.InputSignal<string>;
+    /** Optional leading lucide icon name or component. */
+    icon: _angular_core.InputSignal<any>;
+    /** Position of the icon relative to the label. */
+    iconPos: _angular_core.InputSignal<ButtonIconPosition>;
+    /** Color variant. Defaults to 'primary'. */
+    severity: _angular_core.InputSignal<ButtonSeverity>;
+    /** Transparent background with a colored border. */
+    outlined: _angular_core.InputSignal<boolean>;
+    /** Borderless button with a colored label. */
+    text: _angular_core.InputSignal<boolean>;
+    /** Adds a soft shadow. */
+    raised: _angular_core.InputSignal<boolean>;
+    /** Fully rounded corners (pill). */
+    rounded: _angular_core.InputSignal<boolean>;
+    /** Size variant. */
+    size: _angular_core.InputSignal<ButtonSize | undefined>;
+    /** Disables the button. */
+    disabled: _angular_core.InputSignal<boolean>;
+    /** Shows a spinner and disables the button. */
+    loading: _angular_core.InputSignal<boolean>;
+    /** Icon shown while loading. Defaults to 'refresh'. */
+    loadingIcon: _angular_core.InputSignal<string>;
+    /** Optional text shown instead of the label while loading. */
+    loadingText: _angular_core.InputSignal<string>;
+    /** Native button type. */
+    type: _angular_core.InputSignal<"button" | "submit" | "reset">;
+    /** Accessible label when the button is icon-only. */
+    ariaLabel: _angular_core.InputSignal<string>;
+    /** Native title tooltip. */
+    title: _angular_core.InputSignal<string>;
+    /** Inline styles applied to the button. */
+    style: _angular_core.InputSignal<Record<string, string | number>>;
+    /** Extra CSS classes. */
+    styleClass: _angular_core.InputSignal<string>;
+    /** Emitted on click with the original MouseEvent. */
+    onClick: _angular_core.OutputEmitterRef<MouseEvent>;
+    protected getIcon: typeof getIcon;
+    protected iconOnly: _angular_core.Signal<boolean>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ButtonComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonComponent, "shk-button", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "iconPos": { "alias": "iconPos"; "required": false; "isSignal": true; }; "severity": { "alias": "severity"; "required": false; "isSignal": true; }; "outlined": { "alias": "outlined"; "required": false; "isSignal": true; }; "text": { "alias": "text"; "required": false; "isSignal": true; }; "raised": { "alias": "raised"; "required": false; "isSignal": true; }; "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "loadingIcon": { "alias": "loadingIcon"; "required": false; "isSignal": true; }; "loadingText": { "alias": "loadingText"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "style": { "alias": "style"; "required": false; "isSignal": true; }; "styleClass": { "alias": "styleClass"; "required": false; "isSignal": true; }; }, { "onClick": "onClick"; }, never, ["*"], true, never>;
+}
+
+export { ButtonComponent };
+export type { ButtonIconPosition, ButtonSeverity, ButtonSize };

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

@@ -0,0 +1,65 @@
+import * as _angular_core from '@angular/core';
+import { AfterViewInit, OnDestroy } from '@angular/core';
+
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Chart.js wrapper that renders line, bar, pie, doughnut or polarArea charts
+ * and updates them reactively as the inputs change.
+ */
+declare class ChartComponent implements AfterViewInit, OnDestroy {
+    /** Guarantees Chart.js plugins are only registered once. */
+    private static registered;
+    /** Type of chart to render. */
+    type: _angular_core.InputSignal<"line" | "bar" | "pie" | "doughnut" | "polarArea">;
+    /** Chart.js datasets payload. */
+    data: _angular_core.InputSignal<any>;
+    /** Chart.js options object. */
+    options: _angular_core.InputSignal<any>;
+    /** Reference to the inner canvas element. */
+    private canvasRef;
+    /** Live Chart.js instance. */
+    private chartInstance;
+    /** Whether the view has been initialized yet. */
+    private initialized;
+    constructor();
+    /** Creates the initial chart once the canvas is available. */
+    ngAfterViewInit(): void;
+    /** Destroys the Chart.js instance. */
+    ngOnDestroy(): void;
+    /** Clears the canvas by reassigning its width. */
+    private resetCanvas;
+    /** Creates a new Chart.js instance on the canvas. */
+    private initChart;
+    /** Deep clones a value to detach it from Angular's reactive objects. */
+    private deepClone;
+    /** Applies the new data/options, rebuilding the chart when the type changes. */
+    private updateChart;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartComponent, "shk-chart", never, { "type": { "alias": "type"; "required": false; "isSignal": true; }; "data": { "alias": "data"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "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.
+ */
+/** Default dataset colors used by the ChartComponent when no palette is provided. */
+declare const COLOR_PALETTE: {
+    bg: string;
+    border: string;
+}[];
+/**
+ * Reads the current `--shk-*` CSS variables from the document and returns
+ * the text, muted and border colors used by charts to follow the active theme.
+ */
+declare function readThemeColors(): {
+    text: string;
+    muted: string;
+    border: string;
+};
+
+export { COLOR_PALETTE, ChartComponent, readThemeColors };

package/types/shirkasoft-ui-components-confirm-dialog.d.ts

@@ -0,0 +1,88 @@
+import * as _angular_core from '@angular/core';
+import { OnDestroy } from '@angular/core';
+
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Confirmation dialog opened via `show()` which resolves a Promise<boolean>
+ * with the user's choice.
+ */
+declare class ConfirmDialogComponent implements OnDestroy {
+    protected getIcon: (name: any) => any;
+    /** Title shown in the dialog header. */
+    title: _angular_core.InputSignal<string>;
+    /** Message body of the dialog. */
+    message: _angular_core.InputSignal<string>;
+    /** Label of the confirm button. */
+    confirmLabel: _angular_core.InputSignal<string>;
+    /** Label of the cancel button. */
+    cancelLabel: _angular_core.InputSignal<string>;
+    /** Text shown on the confirm button while `loading` is true. */
+    loadingText: _angular_core.InputSignal<string>;
+    /** Visual style: 'danger', 'info' or 'warning'. */
+    type: _angular_core.InputSignal<"danger" | "info" | "warning">;
+    /** Shows a spinner and disables the confirm button. */
+    loading: _angular_core.InputSignal<boolean>;
+    /** Whether the cancel button is shown. */
+    showCancel: _angular_core.InputSignal<boolean>;
+    /** Controls dialog visibility. */
+    visible: _angular_core.WritableSignal<boolean>;
+    /** Resolver of the currently pending confirmation promise. */
+    private resolveRef;
+    /** Emitted whenever the dialog is closed (confirm or cancel). */
+    closed: _angular_core.OutputEmitterRef<void>;
+    /** Opens the dialog and returns a promise resolving with the user choice. */
+    show(): Promise<boolean>;
+    /** Resolves with `true` when the user confirms. */
+    onConfirm(): void;
+    /** Resolves with `false` when the user cancels. */
+    onCancel(): void;
+    /** Clears the pending resolver on destroy. */
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ConfirmDialogComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ConfirmDialogComponent, "shk-confirm-dialog", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "confirmLabel": { "alias": "confirmLabel"; "required": false; "isSignal": true; }; "cancelLabel": { "alias": "cancelLabel"; "required": false; "isSignal": true; }; "loadingText": { "alias": "loadingText"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "showCancel": { "alias": "showCancel"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, never, true, never>;
+}
+
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/** Options for opening a confirmation dialog. */
+interface ConfirmConfig {
+    title?: string;
+    message: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+    loadingText?: string;
+    type?: 'danger' | 'info' | 'warning';
+    showCancel?: boolean;
+    loading?: boolean;
+}
+/**
+ * Programmatically opens the confirmation dialog and resolves a Promise
+ * with the user's decision (true = confirm, false = cancel).
+ */
+declare class ConfirmDialogService {
+    /** Reference to the currently open dialog, if any. */
+    private dialogRef;
+    private destroyRef;
+    private appRef;
+    private injector;
+    constructor();
+    /**
+     * Opens a confirmation dialog with the given configuration and returns a
+     * promise resolving with the user's choice.
+     */
+    confirm(config: ConfirmConfig): Promise<boolean>;
+    /** Detaches and destroys the mounted dialog if present. */
+    private cleanupDialog;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ConfirmDialogService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ConfirmDialogService>;
+}
+
+export { ConfirmDialogComponent, ConfirmDialogService };
+export type { ConfirmConfig };

package/types/shirkasoft-ui-components-date-picker.d.ts

@@ -0,0 +1,200 @@
+import * as _angular_core from '@angular/core';
+import { ControlValueAccessor, FormGroup, FormControl } from '@angular/forms';
+
+/** Which granularity the picker edits: a day, a month or a year. */
+type DatePickerView = 'date' | 'month' | 'year';
+/**
+ * Shirkasoft UI Components.
+ * Authors: Roberto Valladares Martin (Ansem13), Julio César García García (Sanjuli14).
+ * Belongs to Shirkasoft.
+ */
+/**
+ * Date/time picker implemented as a ControlValueAccessor. Supports choosing a
+ * day, month or year, optional time selection (with seconds/12-hour format),
+ * min/max constraints and locale-aware labels.
+ */
+declare class DatePickerComponent implements ControlValueAccessor {
+    private elementRef;
+    private cdr;
+    private destroyRef;
+    private transloco;
+    /** HTML id for the input (for label/for pairing). */
+    id: _angular_core.InputSignal<string>;
+    /** Granularity of the picker ('date' | 'month' | 'year'). */
+    view: _angular_core.InputSignal<DatePickerView>;
+    /** Label shown above the input. */
+    label: _angular_core.InputSignal<string>;
+    /** Placeholder of the input. */
+    placeholder: _angular_core.InputSignal<string>;
+    /** FormGroup used to resolve the control from `label`. */
+    formGroup: _angular_core.InputSignal<FormGroup<any> | undefined>;
+    /** Directly bound FormControl. */
+    control: _angular_core.InputSignal<FormControl<any> | undefined>;
+    /** Disables the picker. */
+    disabled: _angular_core.InputSignal<boolean>;
+    /** Custom error message displayed (overrides translated ones). */
+    errorMessage: _angular_core.InputSignal<string>;
+    /** Per-validation-key custom error messages. */
+    errorMessages: _angular_core.InputSignal<{
+        [key: string]: string;
+    }>;
+    /** Minimum allowed date (YYYY-MM-DD) or year/month string. */
+    minValue: _angular_core.InputSignal<string>;
+    /** Maximum allowed date (YYYY-MM-DD) or year/month string. */
+    maxValue: _angular_core.InputSignal<string>;
+    /** Locale used for month/day names and formatted labels. */
+    locale: _angular_core.InputSignal<string>;
+    /** Edits only the time portion of the value. */
+    timeOnly: _angular_core.InputSignal<boolean>;
+    /** Shows the time selectors alongside the date. */
+    showTime: _angular_core.InputSignal<boolean>;
+    /** Hour format: '12' or '24'. */
+    hourFormat: _angular_core.InputSignal<"12" | "24">;
+    /** Whether the seconds selector is shown. */
+    showSeconds: _angular_core.InputSignal<boolean>;
+    /** Step (in minutes) for the minute selector. */
+    minuteStep: _angular_core.InputSignal<number>;
+    /** Whether the dropdown calendar is open. */
+    isOpen: _angular_core.WritableSignal<boolean>;
+    /** Year currently displayed in the calendar. */
+    viewYear: _angular_core.WritableSignal<number>;
+    /** Month currently displayed in the calendar (0-based). */
+    viewMonth: _angular_core.WritableSignal<number>;
+    /** Starting year of the decade shown in year view. */
+    viewDecade: _angular_core.WritableSignal<number>;
+    /** Hour selected in the time selectors. */
+    viewHour: _angular_core.WritableSignal<number>;
+    /** Minute selected in the time selectors. */
+    viewMinute: _angular_core.WritableSignal<number>;
+    /** Second selected in the time selectors. */
+    viewSecond: _angular_core.WritableSignal<number>;
+    /** Meridiem selected in 12-hour format. */
+    viewMeridiem: _angular_core.WritableSignal<"AM" | "PM">;
+    /** Date part selected but not yet committed until the time is confirmed. */
+    private pendingDate;
+    /** Underlying value (mirrors the reactive control). */
+    private _value;
+    /** Disabled state coming from the reactive form infrastructure. */
+    private _disabledState;
+    /** Whether status subscriptions have been attached to the control. */
+    private subscribed;
+    private valueSubscribed;
+    /** Counter used to recompute the error helpers reactively. */
+    private errorTracker;
+    /** Whether an error was displayed at some point. */
+    hadError: _angular_core.WritableSignal<boolean>;
+    /** ControlValueAccessor callbacks. */
+    private onChange;
+    private onTouched;
+    /** Current value of the picker. */
+    value: _angular_core.Signal<string | null>;
+    /** Whether the picker is disabled (input or reactive form). */
+    isDisabled: _angular_core.Signal<boolean>;
+    /** Resolves the control from `control` input or `formGroup`+`label`. */
+    actualControl: _angular_core.Signal<FormControl<any> | undefined>;
+    /** Whether the bound control should show its error message. */
+    shouldShowError: _angular_core.Signal<boolean | undefined>;
+    /** Whether an error was fixed (invalid before, now valid and touched). */
+    wasFixedError: _angular_core.Signal<boolean | undefined>;
+    /** Validation error messages to display, custom or translated. */
+    getErrorMessages: _angular_core.Signal<string[]>;
+    /** Date part displayed in the calendar (pending date or committed value). */
+    displayedDate: _angular_core.Signal<string | null>;
+    /** Human-readable label for the selected value in the input. */
+    displayLabel: _angular_core.Signal<string>;
+    /** Localized short month names for the year view. */
+    monthNames: _angular_core.Signal<string[]>;
+    /** Localized short weekday names for the calendar header. */
+    dayNames: _angular_core.Signal<string[]>;
+    /** Number of days in the currently viewed month. */
+    daysInMonth: _angular_core.Signal<number>;
+    /** Weekday index (0=Sunday) of the first day of the viewed month. */
+    firstDayOfMonth: _angular_core.Signal<number>;
+    /** Calendar grid: nulls for leading blanks then the days of the month. */
+    calendarDays: _angular_core.Signal<(number | null)[]>;
+    /** Whether the prev navigation button is allowed by `minValue`. */
+    canGoPrev: _angular_core.Signal<boolean>;
+    /** Whether the next navigation button is allowed by `maxValue`. */
+    canGoNext: _angular_core.Signal<boolean>;
+    /** Year of the displayed date, if any. */
+    selectedYear: _angular_core.Signal<number | null>;
+    /** Month index (0-based) of the displayed date, if any. */
+    selectedMonth: _angular_core.Signal<number | null>;
+    /** Day of the displayed date, if any (date view only). */
+    selectedDay: _angular_core.Signal<number | null>;
+    /** 12 years of the viewed decade for the year view. */
+    decadeYears: _angular_core.Signal<number[]>;
+    /** (Unused legacy placeholder) plain year list. */
+    years: number[];
+    constructor();
+    /** Closes the dropdown when clicking outside the component. */
+    onDocumentClick(event: MouseEvent): void;
+    /** Closes the dropdown on Escape. */
+    onEscape(): void;
+    /** Opens/closes the dropdown, syncing the calendar to the current value. */
+    toggle(): void;
+    /** Aligns the calendar view signals with the current value (or today). */
+    private syncViewToValue;
+    /** Closes the dropdown, marks the control as touched and refreshes errors. */
+    close(): void;
+    /** Navigates the calendar to the previous year/month/decade. */
+    prev(): void;
+    /** Navigates the calendar to the next year/month/decade. */
+    next(): void;
+    /** Selects a day of the month (pending if time is shown). */
+    selectDay(day: number): void;
+    /** Selects a month of the year (pending if time is shown). */
+    selectMonth(monthIndex: number): void;
+    /** Selects a year (pending if time is shown). */
+    selectYear(year: number): void;
+    /** Commits a value, updates the component, the control and the outputs. */
+    private setValue;
+    /** Confirms the selected time and commits the combined date+time value. */
+    confirmTime(): void;
+    /** Reads the hour selected in the time selector. */
+    onHourChange(event: Event): void;
+    /** Reads the minute selected in the time selector. */
+    onMinuteChange(event: Event): void;
+    /** Reads the second selected in the time selector. */
+    onSecondChange(event: Event): void;
+    /** Current meridiem ("AM"/"PM") for the 12-hour format. */
+    meridiem(): 'AM' | 'PM';
+    /** Reads the meridiem selected in the time selector. */
+    onMeridiemChange(event: Event): void;
+    /** Splits the date part from a full ISO "date" or "dateTtime" value. */
+    private datePartOf;
+    /** Formats a raw time string ("HH:mm[:ss]") using the configured format. */
+    private formatTimeFromValue;
+    /** Formats hour/minute/second according to hour format and seconds option. */
+    private formatTime;
+    /** Formats a Date as a YYYY-MM-DD ISO string. */
+    private toISODate;
+    /** Whether the given day matches the currently selected date. */
+    isSelectedDay(day: number): boolean;
+    /** Hours available in the time selector ('12' maps to 0..11 or 12..23). */
+    hoursRange(): number[];
+    /** Minutes available in the time selector, stepped by `minuteStep`. */
+    minutesRange(): number[];
+    /** Seconds available in the time selector (0..59). */
+    secondsRange(): number[];
+    /** Formats an hour for display in the selector (12-hour aware). */
+    hourDisplay(hour: number): string;
+    /** Pads a minute value with a leading zero. */
+    minutesLabel(value: number): string;
+    /** Whether the given day is today's date. */
+    isToday(day: number): boolean;
+    /** Whether the given month matches the selected month and year. */
+    isSelectedMonth(monthIndex: number): boolean;
+    isCurrentMonth(monthIndex: number): boolean;
+    isSelectedYear(year: number): boolean;
+    isCurrentYear(year: number): boolean;
+    writeValue(value: any): void;
+    registerOnChange(fn: any): void;
+    registerOnTouched(fn: any): void;
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DatePickerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DatePickerComponent, "shk-date-picker", never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; "view": { "alias": "view"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "formGroup": { "alias": "formGroup"; "required": false; "isSignal": true; }; "control": { "alias": "control"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "errorMessages": { "alias": "errorMessages"; "required": false; "isSignal": true; }; "minValue": { "alias": "minValue"; "required": false; "isSignal": true; }; "maxValue": { "alias": "maxValue"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "timeOnly": { "alias": "timeOnly"; "required": false; "isSignal": true; }; "showTime": { "alias": "showTime"; "required": false; "isSignal": true; }; "hourFormat": { "alias": "hourFormat"; "required": false; "isSignal": true; }; "showSeconds": { "alias": "showSeconds"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { DatePickerComponent };
+export type { DatePickerView };