ngx-kit 6.0.1 → 6.1.0

package/time-picker/README.md

@@ -0,0 +1,95 @@
+# ngx-kit/time-picker
+
+An analog clock time picker (MUI-style), usable either inline or as a popup attached to a text input, with 12h/24h format support and a configurable minute step.
+
+## Install
+
+```bash
+npm install ngx-kit
+```
+
+## Setup (optional)
+
+```ts
+// app.config.ts
+import { provideTimePicker } from 'ngx-kit/time-picker';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideTimePicker({
+      format: '24',
+      minuteStep: 5,
+      confirmButtonText: 'Done',
+    }),
+  ],
+};
+```
+
+`provideTimePicker` only needs the fields you want to override — everything else falls back to the defaults (`confirmButtonText: 'Ok'`, `cancelButtonText: 'Cancel'`, `amText: 'AM'`, `pmText: 'PM'`, `format: '12'`, `minuteStep: 1`, `autoSwitchToMinute: true`).
+
+## Usage — popup attached to an input
+
+```html
+<input
+  type="text"
+  formControlName="time"
+  ngxInputTimePicker
+  #dp="ngxInputTimePicker"
+/>
+<button (click)="dp.toggle()">Open</button>
+```
+
+`[ngxInputTimePicker]` is a full `ControlValueAccessor` + `Validator`, so it works with `ngModel`/`formControl`/`formControlName`. The value is always a string in `HH:MM` (24h) form, e.g. `'14:35'`.
+
+If the typed text isn't a valid time, the control gets a `{ invalid: true }` error (in addition to whatever built-in validators like `Validators.required` you add yourself):
+
+```html
+@if (form.get('time')?.hasError('invalid')) {
+  <div class="text-danger">Invalid time</div>
+}
+@if (form.get('time')?.hasError('required')) {
+  <div class="text-danger">Time is required</div>
+}
+```
+
+## Usage — inline (always visible)
+
+```html
+<ngx-time-picker format="24" [(value)]="time" (change)="onTimeChange($event)"></ngx-time-picker>
+```
+
+## API
+
+### `[ngxInputTimePicker]`
+
+| Input | Type | Default | Description |
+| --- | --- | --- | --- |
+| `openOnCLick` | `boolean` | `true` | Open the popup when the input itself is clicked |
+| `format` | `'12' \| '24'` | from config | |
+
+| Output | Type | Description |
+| --- | --- | --- |
+| `change` | `EventEmitter<string \| null>` | Emitted when the user confirms a time |
+
+| Member | Description |
+| --- | --- |
+| `toggle()` | Opens the popup if closed, closes it if open |
+
+### `<ngx-time-picker>`
+
+| Input | Type | Default | Description |
+| --- | --- | --- | --- |
+| `value` (model, two-way) | `string` | `'12:00'` | Bind with `[(value)]` |
+| `format` | `'12' \| '24'` | from config | |
+| `minuteStep` | `number` | from config | |
+| `disabled` | `boolean` | `false` | |
+| `autoSwitchToMinute` | `boolean` | from config | Switch to minute-selection mode right after picking the hour |
+
+| Output | Type | Description |
+| --- | --- | --- |
+| `change` | `EventEmitter<string \| null>` | Emitted when "OK" is pressed |
+| `cancel` | `EventEmitter<void>` | Emitted when "Cancel" is pressed |
+
+## Dark mode and RTL
+
+Supported automatically.

package/types/ngx-kit-data-table.d.ts

@@ -21,7 +21,8 @@ interface PageState {
 }
 /** هر بار سرور باید صفحه‌ی جدید را (در حالت lazy) واکشی کند، امیت می‌شود. */
 interface LazyLoadEvent<T> extends PageState {
-    sorts: SortMeta<T>[];
+    sorts?: SortMeta<T>[];
+    sorting?: string;
 }
 
 interface PaginationLabel {
@@ -59,7 +60,7 @@ type RendererExtraInputs<C extends Type<any>> = {
     [K in keyof InstanceOf<C> as K extends 'value' | 'row' | 'field' ? never : InstanceOf<C>[K] extends () => any ? K : never]?: UnwrapSignal<InstanceOf<C>[K]>;
 };
 type ColumnAlign = 'start' | 'center' | 'end';
-type TableCellFormatter<T extends object = object> = (value: unknown, row: T, field: TableFieldBase<T>) => unknown;
+type TableCellFormatter<T extends object = object> = (value: any, row: T, field: TableFieldBase<T>) => any;
 interface CellTemplateContext<T extends object> {
     $implicit: T;
     row: T;
@@ -71,7 +72,14 @@ interface CellTemplateContext<T extends object> {
 interface TableFieldBase<T extends object> {
     column: Extract<keyof T, string>;
     title: string;
-    width?: number;
+    /**
+     * عرضِ این ستون. عدد یعنی پیکسل (`160` = `160px`)؛ رشته یعنی هر مقدار
+     * معتبرِ CSS length برای flex-basis (`'20%'`, `'12rem'`, ...). اگه اصلاً
+     * ندید، این ستون flex می‌شه (`flex: 1 1 0`) و فضای باقی‌مونده‌ی جدول رو پر
+     * می‌کنه — دقیقاً برخلافِ ستون‌هایی که width دارن (که `flex: 0 0 <width>`
+     * می‌گیرن و ثابت می‌مونن).
+     */
+    width?: number | string;
     minWidth?: number;
     maxWidth?: number;
     resizable?: boolean;
@@ -144,6 +152,7 @@ type ResolvedTableOptions = Required<Omit<NgxTableOptions, 'labels' | 'renderers
     labels: Required<TableLabels>;
     renderers: RendererRegistry;
     formatters: Readonly<Record<string, TableCellFormatter<any>>>;
+    lazy: boolean;
 };
 
 declare const NGX_TABLE_CONFIG_DEFAULT: ResolvedTableOptions;
@@ -210,6 +219,7 @@ declare class ColumnResize {
     readonly direction: _angular_core.InputSignal<"ltr" | "rtl">;
     readonly resizing: _angular_core.OutputEmitterRef<number>;
     readonly resizeEnd: _angular_core.OutputEmitterRef<number>;
+    private readonly elementRef;
     private dragging;
     private startX;
     private baseWidth;
@@ -248,9 +258,12 @@ declare class NgxTable<T extends object> implements OnInit, AfterContentInit {
     readonly operationWidth: _angular_core.InputSignal<number>;
     readonly numWidth: _angular_core.InputSignal<number>;
     readonly pageSize: _angular_core.InputSignal<number>;
+    readonly page: _angular_core.InputSignal<number>;
+    readonly pageChange: _angular_core.OutputEmitterRef<number>;
     readonly loading: _angular_core.InputSignal<boolean>;
     readonly multiSort: _angular_core.InputSignal<boolean | undefined>;
     readonly lazy: _angular_core.InputSignal<boolean>;
+    readonly resizable: _angular_core.InputSignal<boolean>;
     /** پیش‌فرض بر اساس ایندکس؛ برای جلوگیری از گم‌شدن state سطرها هنگام سورت،
      *  یک شناسه‌ی یکتا بدهید: [trackBy]="(i, row) => row.id" */
     readonly trackBy: _angular_core.InputSignal<(index: number, row: T) => unknown>;
@@ -260,7 +273,7 @@ declare class NgxTable<T extends object> implements OnInit, AfterContentInit {
         field: string;
         width: number;
     }>;
-    protected readonly page: _angular_core.WritableSignal<number>;
+    protected readonly pageIndex: _angular_core.WritableSignal<number>;
     protected readonly pageSizeS: _angular_core.WritableSignal<number>;
     protected readonly sorts: _angular_core.WritableSignal<SortMeta<T>[]>;
     protected readonly widths: _angular_core.WritableSignal<Record<string, number>>;
@@ -287,6 +300,13 @@ declare class NgxTable<T extends object> implements OnInit, AfterContentInit {
     protected onPaginate(event: PageEvent): void;
     private emitLazyIfNeeded;
     protected columnWidth(column: string): number;
+    /**
+     * مقدار CSS `flex` واقعیِ این ستون:
+     *  - اگه دستی ریسایز شده یا width عددی داره → `0 0 <px>` (ثابت، بدون رشد/کوچک‌شدن)
+     *  - اگه width رشته‌ای داره (مثلاً '20%') → `0 0 <رشته>` (ثابت، هر واحد CSS معتبری)
+     *  - اگه اصلاً width نداره → `1 1 0` (رشد می‌کنه تا فضای باقی‌مونده‌ی جدول رو پر کنه)
+     */
+    protected columnFlex(field: TableField<T, any>): string;
     protected columnMin(field: TableField<T, any>): number;
     protected columnMax(field: TableField<T, any>): number;
     protected isResizable(field: TableField<T, any>): boolean;
@@ -302,7 +322,7 @@ declare class NgxTable<T extends object> implements OnInit, AfterContentInit {
      *  شود (مثلاً بعد از عوض‌شدن صفحه)، entry آن هم خودکار پاک می‌شود. */
     protected getRendererInputs(row: T, field: TableField<T, any>): Record<string, unknown>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgxTable<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgxTable<any>, "ngx-table", never, { "fields": { "alias": "fields"; "required": true; "isSignal": true; }; "data": { "alias": "data"; "required": true; "isSignal": true; }; "totalRecords": { "alias": "totalRecords"; "required": true; "isSignal": true; }; "showRecordNumber": { "alias": "showRecordNumber"; "required": false; "isSignal": true; }; "operations": { "alias": "operations"; "required": false; "isSignal": true; }; "operationWidth": { "alias": "operationWidth"; "required": false; "isSignal": true; }; "numWidth": { "alias": "numWidth"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "multiSort": { "alias": "multiSort"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "trackBy": { "alias": "trackBy"; "required": false; "isSignal": true; }; }, { "lazyLoad": "lazyLoad"; "sortChange": "sortChange"; "columnResize": "columnResize"; }, ["cellTemplates"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgxTable<any>, "ngx-table", never, { "fields": { "alias": "fields"; "required": true; "isSignal": true; }; "data": { "alias": "data"; "required": true; "isSignal": true; }; "totalRecords": { "alias": "totalRecords"; "required": true; "isSignal": true; }; "showRecordNumber": { "alias": "showRecordNumber"; "required": false; "isSignal": true; }; "operations": { "alias": "operations"; "required": false; "isSignal": true; }; "operationWidth": { "alias": "operationWidth"; "required": false; "isSignal": true; }; "numWidth": { "alias": "numWidth"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "multiSort": { "alias": "multiSort"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "resizable": { "alias": "resizable"; "required": false; "isSignal": true; }; "trackBy": { "alias": "trackBy"; "required": false; "isSignal": true; }; }, { "pageChange": "pageChange"; "lazyLoad": "lazyLoad"; "sortChange": "sortChange"; "columnResize": "columnResize"; }, ["cellTemplates"], never, true, never>;
 }
 
 declare class NgxPagination {

package/types/ngx-kit-dropzone.d.ts

@@ -1,13 +1,22 @@
 import * as _angular_core from '@angular/core';
-import { OnDestroy } from '@angular/core';
+import { OnDestroy, InjectionToken } from '@angular/core';
+import { HttpHeaders } from '@angular/common/http';
+import { Observable } from 'rxjs';
 
-interface NgxDropzoneFile {
+type NgxDropzoneFileStatus = 'pending' | 'accepted' | 'uploading' | 'uploaded' | 'error' | 'canceled';
+interface NgxDropzoneFile<TResponse = unknown> {
     /** شناسه‌ی یکتا برای track کردن توی @for و امکان حذف تکی */
     id: string;
     file: File;
     /** فقط برای فایل‌های تصویری پر می‌شه (object URL) */
     previewUrl?: string;
-    status: 'pending' | 'accepted' | 'rejected';
+    status: NgxDropzoneFileStatus;
+    /** Upload progress, from 0 to 100. */
+    progress: number;
+    /** Response returned by the upload adapter. */
+    response?: TResponse;
+    /** Upload error, if the request failed. */
+    error?: unknown;
     /** در صورت رد شدن، دلیلش */
     rejectionReason?: NgxDropzoneRejectionReason;
 }
@@ -17,19 +26,57 @@ interface NgxDropzoneRejectedFile {
     reason: NgxDropzoneRejectionReason;
 }
 
+interface NgxDropzoneUploadRequest {
+    /** Target endpoint. */
+    url: string;
+    /** Multipart form field name used for the file. */
+    alias: string;
+    file: File;
+    /** Optional additional multipart fields. */
+    data?: Record<string, string | Blob | number | boolean>;
+    /** Optional request headers. */
+    headers?: HttpHeaders | Record<string, string | string[]>;
+    /** Send cookies/auth information for cross-origin requests. */
+    withCredentials?: boolean;
+}
+type NgxDropzoneUploadEvent<TResponse = unknown> = {
+    type: 'progress';
+    loaded: number;
+    total?: number;
+    percent: number;
+} | {
+    type: 'response';
+    response: TResponse;
+    status: number;
+    headers?: HttpHeaders;
+};
 /**
- * ناحیه‌ی درگ‌اند‌دراپِ فایل — کاملاً مستقل (بدون وابستگی به هیچ lib
- * دیگه‌ای، حتی shared)، signal-based و OnPush.
+ * Upload adapter used by ngx-dropzone.
  *
- * ویژگی‌های مهمی که معمولاً پیاده‌سازی‌های ساده‌ی dropzone ندارن:
- *  - شمارنده‌ی dragenter/dragleave: چون dragleave برای فرزندهای داخل
- *    dropzone هم شلیک می‌شه، پیاده‌سازی‌های ساده موقع درگ‌کردن روی متن/آیکون
- *    داخل ناحیه، حالت "درگ" رو اشتباهی خاموش می‌کنن (چشمک‌زدن). این‌جا با
- *    شمارنده حل شده.
- *  - پیمایش بازگشتیِ پوشه‌ها (وقتی کاربر یه پوشه رو درگ کنه، نه فقط فایل).
- *  - قابل‌دسترسی با کیبورد (focusable + Enter/Space).
- *  - پاک‌سازی object URL پیش‌نمایش‌ها روی حذف/destroy (وگرنه نشتی حافظه‌ست).
+ * Implement this interface when the default HttpClient implementation is not
+ * suitable (for example, when the host application uses Axios, fetch, tus,
+ * S3 multipart upload, etc.).
+ */
+interface NgxDropzoneUploadService {
+    upload<TResponse = unknown>(request: NgxDropzoneUploadRequest): Observable<NgxDropzoneUploadEvent<TResponse>>;
+}
+interface NgxDropzoneUploadProgressEvent {
+    item: NgxDropzoneFileLike;
+    loaded: number;
+    total?: number;
+    percent: number;
+}
+/**
+ * Deliberately small structural type so consumers do not have to depend on a
+ * concrete response type.
  */
+interface NgxDropzoneFileLike {
+    id: string;
+    file: File;
+    progress: number;
+}
+
+type NgxDropzoneUploadMode = 'all' | 'single';
 declare class NgxDropzoneComponent implements OnDestroy {
     /** الگوی accept مثل input[type=file]: "image/*", ".pdf,.docx" و ... */
     accept: _angular_core.InputSignal<string>;
@@ -41,16 +88,55 @@ declare class NgxDropzoneComponent implements OnDestroy {
     disabled: _angular_core.InputSignal<boolean>;
     /** نمایش لیست/پیش‌نمایش فایل‌های انتخاب‌شده داخل خودِ کامپوننت */
     showFileList: _angular_core.InputSignal<boolean>;
+    /** Upload endpoint. */
+    uploadUrl: _angular_core.InputSignal<string>;
+    /** Multipart form-data field name. */
+    uploadAlias: _angular_core.InputSignal<string>;
+    /** Automatically enqueue newly accepted files for upload. */
+    autoUpload: _angular_core.InputSignal<boolean>;
+    /** Maximum number of simultaneous uploads. */
+    maxParallel: _angular_core.InputSignal<number>;
+    /**
+     * Manual upload behavior:
+     * - all: one "Upload all" action uploads all pending files.
+     * - single: every pending row gets its own Upload button.
+     */
+    uploadMode: _angular_core.InputSignal<NgxDropzoneUploadMode>;
+    /** Extra multipart form fields sent with every file. */
+    uploadData: _angular_core.InputSignal<Record<string, string | number | boolean | Blob>>;
+    /** Optional request headers. */
+    uploadHeaders: _angular_core.InputSignal<Record<string, string | string[]>>;
+    /** Send credentials/cookies with the upload request. */
+    uploadWithCredentials: _angular_core.InputSignal<boolean>;
     filesAdded: _angular_core.OutputEmitterRef<File[]>;
     filesRejected: _angular_core.OutputEmitterRef<NgxDropzoneRejectedFile[]>;
-    /** کل لیست فعلی (بعد از هر تغییر) — برای binding راحت‌تر */
     filesChange: _angular_core.OutputEmitterRef<File[]>;
-    protected readonly files: _angular_core.WritableSignal<NgxDropzoneFile[]>;
+    /** Emitted when an individual upload starts. */
+    uploadStarted: _angular_core.OutputEmitterRef<NgxDropzoneFile<unknown>>;
+    /** Emitted for every upload progress update. */
+    uploadProgress: _angular_core.OutputEmitterRef<NgxDropzoneUploadProgressEvent>;
+    /** Emitted after a file is successfully uploaded. */
+    uploadSuccess: _angular_core.OutputEmitterRef<NgxDropzoneFile<unknown>>;
+    /** Emitted when an upload fails. */
+    uploadError: _angular_core.OutputEmitterRef<{
+        item: NgxDropzoneFile;
+        error: unknown;
+    }>;
+    protected readonly files: _angular_core.WritableSignal<NgxDropzoneFile<unknown>[]>;
     protected readonly isDragging: _angular_core.WritableSignal<boolean>;
     private dragCounter;
+    private readonly uploadService;
     private readonly fileInput;
+    private readonly uploadSubscriptions;
+    private readonly uploadQueue;
+    private activeUploads;
+    private readonly activeUploadIds;
+    protected readonly pendingCount: _angular_core.Signal<number>;
+    protected readonly hasUploadConfiguration: _angular_core.Signal<boolean>;
     protected readonly hint: _angular_core.Signal<string>;
     protected formatSize(bytes: number): string;
+    protected isPending(item: NgxDropzoneFile): boolean;
+    protected trackById(_index: number, item: NgxDropzoneFile): string;
     ngOnDestroy(): void;
     protected onDragEnter(ev: DragEvent): void;
     protected onDragOver(ev: DragEvent): void;
@@ -60,12 +146,37 @@ declare class NgxDropzoneComponent implements OnDestroy {
     protected onKeydown(ev: KeyboardEvent): void;
     protected onFileInputChange(ev: Event): void;
     protected removeFile(id: string): void;
+    protected uploadAll(): void;
+    protected uploadSingle(id: string): void;
+    protected retryUpload(id: string): void;
     private handleIncomingFiles;
+    private enqueueUploads;
+    private pumpQueue;
+    private startUpload;
+    private markUploadError;
+    private finishUpload;
+    private updateFile;
     private emitCurrentFiles;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgxDropzoneComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgxDropzoneComponent, "ngx-dropzone", never, { "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "maxFileSize": { "alias": "maxFileSize"; "required": false; "isSignal": true; }; "maxFiles": { "alias": "maxFiles"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "showFileList": { "alias": "showFileList"; "required": false; "isSignal": true; }; }, { "filesAdded": "filesAdded"; "filesRejected": "filesRejected"; "filesChange": "filesChange"; }, never, ["[dropzone-icon]", "*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgxDropzoneComponent, "ngx-dropzone", never, { "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "maxFileSize": { "alias": "maxFileSize"; "required": false; "isSignal": true; }; "maxFiles": { "alias": "maxFiles"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "showFileList": { "alias": "showFileList"; "required": false; "isSignal": true; }; "uploadUrl": { "alias": "uploadUrl"; "required": false; "isSignal": true; }; "uploadAlias": { "alias": "uploadAlias"; "required": false; "isSignal": true; }; "autoUpload": { "alias": "autoUpload"; "required": false; "isSignal": true; }; "maxParallel": { "alias": "maxParallel"; "required": false; "isSignal": true; }; "uploadMode": { "alias": "uploadMode"; "required": false; "isSignal": true; }; "uploadData": { "alias": "uploadData"; "required": false; "isSignal": true; }; "uploadHeaders": { "alias": "uploadHeaders"; "required": false; "isSignal": true; }; "uploadWithCredentials": { "alias": "uploadWithCredentials"; "required": false; "isSignal": true; }; }, { "filesAdded": "filesAdded"; "filesRejected": "filesRejected"; "filesChange": "filesChange"; "uploadStarted": "uploadStarted"; "uploadProgress": "uploadProgress"; "uploadSuccess": "uploadSuccess"; "uploadError": "uploadError"; }, never, ["[dropzone-icon]", "*"], true, never>;
+}
+
+declare class NgxDropzoneHttpUploadService implements NgxDropzoneUploadService {
+    private readonly http;
+    upload<TResponse = unknown>(request: NgxDropzoneUploadRequest): Observable<NgxDropzoneUploadEvent<TResponse>>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgxDropzoneHttpUploadService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<NgxDropzoneHttpUploadService>;
 }
 
+/**
+ * Upload adapter used by ngx-dropzone.
+ *
+ * Default: Angular HttpClient.
+ * Override this token at application/component level to use Axios or any
+ * other upload implementation.
+ */
+declare const NGX_DROPZONE_UPLOAD_SERVICE: InjectionToken<NgxDropzoneUploadService>;
+
 /**
  * چک می‌کنه یه فایل با pattern رشته‌ای accept (مثل input[type=file])
  * مطابقت داره یا نه. پشتیبانی می‌شه از:
@@ -80,5 +191,5 @@ declare function formatBytes(bytes: number): string;
 /** استخراج فایل‌های واقعی از یک DataTransfer، شامل پیمایش بازگشتیِ پوشه‌ها (وقتی مرورگر پشتیبانی کنه) */
 declare function extractFilesFromDataTransfer(dataTransfer: DataTransfer): Promise<File[]>;
 
-export { NgxDropzoneComponent, extractFilesFromDataTransfer, formatBytes, matchesAccept };
-export type { NgxDropzoneFile, NgxDropzoneRejectedFile, NgxDropzoneRejectionReason };
+export { NGX_DROPZONE_UPLOAD_SERVICE, NgxDropzoneComponent, NgxDropzoneHttpUploadService, extractFilesFromDataTransfer, formatBytes, matchesAccept };
+export type { NgxDropzoneFile, NgxDropzoneFileLike, NgxDropzoneFileStatus, NgxDropzoneRejectedFile, NgxDropzoneRejectionReason, NgxDropzoneUploadEvent, NgxDropzoneUploadMode, NgxDropzoneUploadProgressEvent, NgxDropzoneUploadRequest, NgxDropzoneUploadService };

package/types/ngx-kit-form-field.d.ts

@@ -1,31 +1,69 @@
-import * as _angular_core from '@angular/core';
-
-type NgxFormFieldType = 'text' | 'password' | 'email' | 'number' | 'tel' | 'url' | 'search' | 'textarea';
+import * as i0 from '@angular/core';
+import { AfterViewInit, ElementRef, InjectionToken } from '@angular/core';
+import * as ngx_kit_form_field from 'ngx-kit/form-field';
 
 declare class NgxFormField {
-    readonly value: _angular_core.ModelSignal<string | number>;
-    readonly label: _angular_core.InputSignal<string>;
-    readonly type: _angular_core.InputSignal<NgxFormFieldType>;
-    readonly placeholder: _angular_core.InputSignal<string>;
-    readonly required: _angular_core.InputSignal<boolean>;
-    readonly disabled: _angular_core.InputSignal<boolean>;
-    readonly readonly: _angular_core.InputSignal<boolean>;
-    readonly float: _angular_core.InputSignal<boolean>;
-    readonly name: _angular_core.InputSignal<string | null>;
-    readonly autocomplete: _angular_core.InputSignal<string | null>;
-    readonly rows: _angular_core.InputSignal<number>;
-    readonly hint: _angular_core.InputSignal<string>;
-    readonly errorMessages: _angular_core.InputSignal<string[]>;
-    readonly dir: _angular_core.InputSignal<"" | "ltr" | "rtl">;
-    readonly id: _angular_core.InputSignal<string>;
-    readonly focused: _angular_core.OutputEmitterRef<void>;
-    readonly blurred: _angular_core.OutputEmitterRef<void>;
-    readonly hasValue: _angular_core.Signal<boolean>;
-    onInput(event: Event): void;
-    onFocus(): void;
-    onBlur(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgxFormField, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgxFormField, "ngx-form-field", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "float": { "alias": "float"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorMessages": { "alias": "errorMessages"; "required": false; "isSignal": true; }; "dir": { "alias": "dir"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "focused": "focused"; "blurred": "blurred"; }, never, never, true, never>;
+    protected readonly ref: ngx_kit_form_field.MgxFormFieldRef;
+    readonly label: i0.InputSignal<string>;
+    /**
+     * Forces the label to float even when the control is empty.
+     * Similar to Material's floatLabel behavior.
+     */
+    readonly float: i0.InputSignal<boolean>;
+    /**
+     * Explicit state overrides are useful when the projected control
+     * is managed by Angular Forms.
+     */
+    readonly invalid: i0.InputSignal<boolean>;
+    readonly required: i0.InputSignal<boolean>;
+    readonly disabled: i0.InputSignal<boolean>;
+    readonly readonly: i0.InputSignal<boolean>;
+    readonly hintVisible: i0.Signal<boolean>;
+    readonly errorVisible: i0.Signal<boolean>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgxFormField, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<NgxFormField, "ngx-form-field", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "float": { "alias": "float"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; }, {}, never, ["[ngxPrefix],ngx-prefix", "[ngxInput],ngx-input", "[ngxSuffix],ngx-suffix", "[ngxHint],ngx-hint", "[ngxError],ngx-error"], true, never>;
+}
+
+declare class NgxInput implements AfterViewInit {
+    private readonly el;
+    private readonly ref;
+    readonly hasValue: i0.WritableSignal<boolean>;
+    ngAfterViewInit(): void;
+    protected onInput(): void;
+    protected onChange(): void;
+    protected onBlur(): void;
+    private syncValue;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgxInput, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgxInput, "[ngxInput],ngx-input", never, {}, {}, never, never, true, never>;
+}
+
+declare class NgxError {
+    readonly el: ElementRef<HTMLElement>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgxError, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgxError, "[ngxError],ngx-error", never, {}, {}, never, never, true, never>;
+}
+
+declare class NgxHint {
+    readonly el: ElementRef<HTMLElement>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgxHint, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgxHint, "[ngxHint],ngx-hint", never, {}, {}, never, never, true, never>;
+}
+
+declare class NgxPrefix {
+    readonly el: ElementRef<HTMLElement>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgxPrefix, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgxPrefix, "[ngxPrefix],ngx-prefix", never, {}, {}, never, never, true, never>;
+}
+
+declare class NgxSuffix {
+    readonly el: ElementRef<HTMLElement>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NgxSuffix, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgxSuffix, "[ngxSuffix],ngx-suffix", never, {}, {}, never, never, true, never>;
+}
+
+declare const MX_FORM_FIELD: InjectionToken<MgxFormFieldRef>;
+declare class MgxFormFieldRef {
+    readonly value: i0.WritableSignal<string>;
 }
 
-export { NgxFormField };
+export { MX_FORM_FIELD, MgxFormFieldRef, NgxError, NgxFormField, NgxHint, NgxInput, NgxPrefix, NgxSuffix };

package/types/ngx-kit-image-editor.d.ts

@@ -53,6 +53,24 @@ declare class NgxPointerDragDirective {
 }
 
 type Corner = 'nw' | 'ne' | 'sw' | 'se';
+
+declare class NgxImageEditorLocalization {
+    LoadingImage: string;
+    Rotation: string;
+    Brightness: string;
+    Contrast: string;
+    Saturation: string;
+    Filter: string;
+    None: string;
+    Grayscale: string;
+    Sepia: string;
+    Invert: string;
+    Cartoon: string;
+    Cancel: string;
+    Save: string;
+    Saving: string;
+}
+
 /**
  * ویرایشگر تصویر: کراپ + چرخش + روشنایی/کنتراست/اشباع + فیلترهای آماده
  * (سیاه‌وسفید، سپیا، معکوس، کارتونی) + فشرده‌سازی خروجی. کاملاً روی Canvas
@@ -65,7 +83,7 @@ type Corner = 'nw' | 'ne' | 'sw' | 'se';
  * save()، رندر نهایی از روی تصویر اصلیِ کامل انجام می‌شه.
  */
 declare class NgxImageEditorComponent {
-    source: _angular_core.InputSignal<string | Blob | File | null>;
+    source: _angular_core.InputSignal<string | File | Blob | null>;
     /** قفل نسبتِ کراپ (مثلاً ۱ برای آواتار مربعی)؛ undefined یعنی آزاد */
     aspectRatio: _angular_core.InputSignal<number | undefined>;
     outputMaxWidth: _angular_core.InputSignal<number | undefined>;
@@ -73,6 +91,9 @@ declare class NgxImageEditorComponent {
     outputType: _angular_core.InputSignal<"image/jpeg" | "image/png" | "image/webp">;
     /** حداکثر عرض نمایشِ ناحیه‌ی کراپ روی صفحه (پیکسل) */
     displayMaxWidth: _angular_core.InputSignal<number>;
+    quality: _angular_core.InputSignal<number>;
+    defaultLocalization: NgxImageEditorLocalization;
+    localize: _angular_core.InputSignal<NgxImageEditorLocalization>;
     saved: _angular_core.OutputEmitterRef<NgxImageEditorResult>;
     cancelled: _angular_core.OutputEmitterRef<void>;
     protected readonly loading: _angular_core.WritableSignal<boolean>;
@@ -85,7 +106,6 @@ declare class NgxImageEditorComponent {
     protected readonly contrast: _angular_core.WritableSignal<number>;
     protected readonly saturation: _angular_core.WritableSignal<number>;
     protected readonly filterPreset: _angular_core.WritableSignal<NgxImageFilterPreset>;
-    protected readonly quality: _angular_core.WritableSignal<number>;
     protected readonly crop: _angular_core.WritableSignal<NgxCropRect>;
     protected readonly adjustments: _angular_core.Signal<NgxImageEditorAdjustments>;
     /** تصویرِ (کوچیک‌شده‌یِ) چرخیده — پایه‌ی نمایش صحنه‌ی کراپ */
@@ -117,7 +137,7 @@ declare class NgxImageEditorComponent {
     protected cancel(): void;
     save(): Promise<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NgxImageEditorComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgxImageEditorComponent, "ngx-image-editor", never, { "source": { "alias": "source"; "required": false; "isSignal": true; }; "aspectRatio": { "alias": "aspectRatio"; "required": false; "isSignal": true; }; "outputMaxWidth": { "alias": "outputMaxWidth"; "required": false; "isSignal": true; }; "outputMaxHeight": { "alias": "outputMaxHeight"; "required": false; "isSignal": true; }; "outputType": { "alias": "outputType"; "required": false; "isSignal": true; }; "displayMaxWidth": { "alias": "displayMaxWidth"; "required": false; "isSignal": true; }; }, { "saved": "saved"; "cancelled": "cancelled"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NgxImageEditorComponent, "ngx-image-editor", never, { "source": { "alias": "source"; "required": false; "isSignal": true; }; "aspectRatio": { "alias": "aspectRatio"; "required": false; "isSignal": true; }; "outputMaxWidth": { "alias": "outputMaxWidth"; "required": false; "isSignal": true; }; "outputMaxHeight": { "alias": "outputMaxHeight"; "required": false; "isSignal": true; }; "outputType": { "alias": "outputType"; "required": false; "isSignal": true; }; "displayMaxWidth": { "alias": "displayMaxWidth"; "required": false; "isSignal": true; }; "quality": { "alias": "quality"; "required": false; "isSignal": true; }; "localize": { "alias": "localize"; "required": false; "isSignal": true; }; }, { "saved": "saved"; "cancelled": "cancelled"; }, never, never, true, never>;
 }
 
 /** یه File/Blob/data-URL/URL رو به یک HTMLImageElement بارگذاری‌شده تبدیل می‌کنه */

package/types/ngx-kit-time-picker.d.ts

@@ -1,25 +1,16 @@
+import * as ngx_kit_time_picker from 'ngx-kit/time-picker';
 import * as _angular_core from '@angular/core';
-import { OnInit, ElementRef } from '@angular/core';
+import { OnInit, ElementRef, InjectionToken, Provider } from '@angular/core';
 import { BrowserService } from 'ngx-kit/shared';
 import { ControlValueAccessor, Validator, AbstractControl, ValidationErrors } from '@angular/forms';
 
-declare class NgxTimePickerConfig {
-    cancelButtonText: string;
-    confirmButtonText: string;
-    amText: string;
-    pmText: string;
-    format: '12' | '24';
-    minuteStep: number;
-    autoSwitchToMinute: boolean;
-}
-
 declare type NgxTimePickerMode = 'hour' | 'minute';
 
 declare class NgxInputTimePickerComponent implements ControlValueAccessor, Validator, OnInit {
     protected readonly browserService: BrowserService;
     readonly change: _angular_core.OutputEmitterRef<string | null>;
     readonly cancel: _angular_core.OutputEmitterRef<void>;
-    protected readonly config: NgxTimePickerConfig;
+    protected readonly config: ngx_kit_time_picker.NgxTimePickerConfig;
     isDisabled: boolean;
     /**
      * Time value.
@@ -113,7 +104,7 @@ declare class NgxInputTimePickerComponent implements ControlValueAccessor, Valid
 
 declare class NgxInputTimePicker implements ControlValueAccessor, Validator {
     private el;
-    protected readonly config: NgxTimePickerConfig;
+    protected readonly config: ngx_kit_time_picker.NgxTimePickerConfig;
     openOnCLick: _angular_core.InputSignal<boolean>;
     readonly change: _angular_core.OutputEmitterRef<string | null>;
     protected readonly value: _angular_core.WritableSignal<string>;
@@ -145,5 +136,19 @@ declare class NgxInputTimePicker implements ControlValueAccessor, Validator {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NgxInputTimePicker, "[ngxInputTimePicker]", ["ngxInputTimePicker"], { "openOnCLick": { "alias": "openOnCLick"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; }, { "change": "change"; }, never, never, true, never>;
 }
 
-export { NgxInputTimePicker, NgxInputTimePickerComponent };
+declare class NgxTimePickerConfig {
+    cancelButtonText: string;
+    confirmButtonText: string;
+    amText: string;
+    pmText: string;
+    format: '12' | '24';
+    minuteStep: number;
+    autoSwitchToMinute: boolean;
+}
+declare const DEFAULT_TIME_PICKER_CONFIG: NgxTimePickerConfig;
+declare const NGX_TIME_PICKER_CONFIG: InjectionToken<NgxTimePickerConfig>;
+
+declare function provideTimePicker(config: Partial<NgxTimePickerConfig>): Provider[];
+
+export { DEFAULT_TIME_PICKER_CONFIG, NGX_TIME_PICKER_CONFIG, NgxInputTimePicker, NgxInputTimePickerComponent, NgxTimePickerConfig, provideTimePicker };
 export type { NgxTimePickerMode };