ngx-kit 6.1.0 → 6.2.0

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

@@ -4,7 +4,7 @@ import { HttpHeaders } from '@angular/common/http';
 import { Observable } from 'rxjs';
 
 type NgxDropzoneFileStatus = 'pending' | 'accepted' | 'uploading' | 'uploaded' | 'error' | 'canceled';
-interface NgxDropzoneFile<TResponse = unknown> {
+interface NgxDropzoneFile<TResponse = any> {
     /** شناسه‌ی یکتا برای track کردن توی @for و امکان حذف تکی */
     id: string;
     file: File;
@@ -16,7 +16,7 @@ interface NgxDropzoneFile<TResponse = unknown> {
     /** Response returned by the upload adapter. */
     response?: TResponse;
     /** Upload error, if the request failed. */
-    error?: unknown;
+    error?: any;
     /** در صورت رد شدن، دلیلش */
     rejectionReason?: NgxDropzoneRejectionReason;
 }
@@ -112,17 +112,17 @@ declare class NgxDropzoneComponent implements OnDestroy {
     filesRejected: _angular_core.OutputEmitterRef<NgxDropzoneRejectedFile[]>;
     filesChange: _angular_core.OutputEmitterRef<File[]>;
     /** Emitted when an individual upload starts. */
-    uploadStarted: _angular_core.OutputEmitterRef<NgxDropzoneFile<unknown>>;
+    uploadStarted: _angular_core.OutputEmitterRef<NgxDropzoneFile<any>>;
     /** Emitted for every upload progress update. */
     uploadProgress: _angular_core.OutputEmitterRef<NgxDropzoneUploadProgressEvent>;
     /** Emitted after a file is successfully uploaded. */
-    uploadSuccess: _angular_core.OutputEmitterRef<NgxDropzoneFile<unknown>>;
+    uploadSuccess: _angular_core.OutputEmitterRef<NgxDropzoneFile<any>>;
     /** Emitted when an upload fails. */
     uploadError: _angular_core.OutputEmitterRef<{
         item: NgxDropzoneFile;
         error: unknown;
     }>;
-    protected readonly files: _angular_core.WritableSignal<NgxDropzoneFile<unknown>[]>;
+    protected readonly files: _angular_core.WritableSignal<NgxDropzoneFile<any>[]>;
     protected readonly isDragging: _angular_core.WritableSignal<boolean>;
     private dragCounter;
     private readonly uploadService;

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

@@ -1,4 +1,5 @@
 import * as _angular_core from '@angular/core';
+import { InjectionToken } from '@angular/core';
 
 interface NgxCropRect {
     /** همه به پیکسل‌های واقعیِ تصویر مبدأ (نه پیکسل صفحه) */
@@ -54,6 +55,7 @@ declare class NgxPointerDragDirective {
 
 type Corner = 'nw' | 'ne' | 'sw' | 'se';
 
+declare const NGX_IMAGE_EDITOR_LOCALIZATION: InjectionToken<NgxImageEditorLocalization>;
 declare class NgxImageEditorLocalization {
     LoadingImage: string;
     Rotation: string;
@@ -69,7 +71,9 @@ declare class NgxImageEditorLocalization {
     Cancel: string;
     Save: string;
     Saving: string;
+    Reset: string;
 }
+declare const DEFAULT_NGX_IMAGE_EDITOR_LOCALIZATION: NgxImageEditorLocalization;
 
 /**
  * ویرایشگر تصویر: کراپ + چرخش + روشنایی/کنتراست/اشباع + فیلترهای آماده
@@ -81,6 +85,15 @@ declare class NgxImageEditorLocalization {
  * (createWorkingCopy)، نه روی تصویر اصلی که ممکنه چند مگاپیکسل باشه — وگرنه
  * درگ‌کردن اسلایدرها/گوشه‌های کراپ رو کاربر حس تاخیر می‌کرد. فقط لحظه‌ی
  * save()، رندر نهایی از روی تصویر اصلیِ کامل انجام می‌شه.
+ *
+ * اندازه‌ی صحنه (stage) با panelSize کنترل می‌شه: عرض همیشه ۱۰۰٪ عرضِ
+ * والدِ کامپوننته (با ResizeObserver اندازه‌گیری می‌شه، پس با تغییر سایز
+ * صفحه/layout هم زنده هماهنگ می‌مونه)، ارتفاع دقیقاً همون چیزیه که کاربر با
+ * panelSize می‌ده. تصویر همیشه با یک مقیاسِ «contain» واقعی (هم بر اساس
+ * عرض، هم بر اساس ارتفاع — هرکدوم تنگ‌تره) جا داده می‌شه، پس کلِ تصویر
+ * همیشه در محدوده‌ی همین باکس دیده می‌شه، صرف‌نظر از اندازه‌ی واقعیِ فایل.
+ * سقفِ مقیاس هم ۱ هست، یعنی تصاویر کوچیک بزرگ‌نمایی نمی‌شن (که باعثِ محو
+ * شدن‌شون می‌شد).
  */
 declare class NgxImageEditorComponent {
     source: _angular_core.InputSignal<string | File | Blob | null>;
@@ -89,8 +102,11 @@ declare class NgxImageEditorComponent {
     outputMaxWidth: _angular_core.InputSignal<number | undefined>;
     outputMaxHeight: _angular_core.InputSignal<number | undefined>;
     outputType: _angular_core.InputSignal<"image/jpeg" | "image/png" | "image/webp">;
-    /** حداکثر عرض نمایشِ ناحیه‌ی کراپ روی صفحه (پیکسل) */
-    displayMaxWidth: _angular_core.InputSignal<number>;
+    /**
+     * کدوم فیلترها نشون داده بشن (و به چه ترتیبی). اگه ندید، هر ۵ تا نشون داده
+     * می‌شن. آرایه‌ی خالی یعنی کلِ بخشِ فیلتر مخفی بشه.
+     */
+    filters: _angular_core.InputSignal<NgxImageFilterPreset[]>;
     quality: _angular_core.InputSignal<number>;
     defaultLocalization: NgxImageEditorLocalization;
     localize: _angular_core.InputSignal<NgxImageEditorLocalization>;
@@ -101,6 +117,9 @@ declare class NgxImageEditorComponent {
     protected readonly loadError: _angular_core.WritableSignal<string | null>;
     private readonly originalImage;
     private readonly workingCanvas;
+    private readonly stageWrapEl;
+    /** عرضِ واقعیِ رندرشده‌ی کانتینر؛ چون عرض همیشه ۱۰۰٪ (fluid) هست، باید زنده اندازه‌گیری بشه */
+    private readonly containerWidth;
     protected readonly rotation: _angular_core.WritableSignal<number>;
     protected readonly brightness: _angular_core.WritableSignal<number>;
     protected readonly contrast: _angular_core.WritableSignal<number>;
@@ -108,8 +127,14 @@ declare class NgxImageEditorComponent {
     protected readonly filterPreset: _angular_core.WritableSignal<NgxImageFilterPreset>;
     protected readonly crop: _angular_core.WritableSignal<NgxCropRect>;
     protected readonly adjustments: _angular_core.Signal<NgxImageEditorAdjustments>;
+    protected readonly filterLabels: _angular_core.Signal<Record<NgxImageFilterPreset, string>>;
     /** تصویرِ (کوچیک‌شده‌یِ) چرخیده — پایه‌ی نمایش صحنه‌ی کراپ */
     protected readonly rotatedWorkingCanvas: _angular_core.Signal<HTMLCanvasElement | null>;
+    protected readonly panelSize: _angular_core.Signal<number>;
+    /**
+     * مقیاسِ «contain» واقعی: کوچیک‌ترینِ نسبتِ عرض و ارتفاع (هرکدوم تنگ‌تره)
+     * تعیین‌کننده‌ست، و سقفش هم ۱ هست تا تصاویر کوچیک بزرگ‌نمایی نشن.
+     */
     protected readonly displayScale: _angular_core.Signal<number>;
     protected readonly stageImageUrl: _angular_core.Signal<string | null>;
     protected readonly stageSize: _angular_core.Signal<{
@@ -137,7 +162,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; }; "quality": { "alias": "quality"; "required": false; "isSignal": true; }; "localize": { "alias": "localize"; "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; }; "filters": { "alias": "filters"; "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 بارگذاری‌شده تبدیل می‌کنه */
@@ -191,5 +216,5 @@ declare function applyCartoonEffect(ctx: CanvasRenderingContext2D, width: number
     edgeThreshold?: number;
 }): void;
 
-export { NgxImageEditorComponent, NgxPointerDragDirective, applyCartoonEffect, canvasToBlob, createWorkingCopy, fitWithin, loadImage, renderComposite, renderRotated };
+export { DEFAULT_NGX_IMAGE_EDITOR_LOCALIZATION, NGX_IMAGE_EDITOR_LOCALIZATION, NgxImageEditorComponent, NgxImageEditorLocalization, NgxPointerDragDirective, applyCartoonEffect, canvasToBlob, createWorkingCopy, fitWithin, loadImage, renderComposite, renderRotated };
 export type { NgxCropRect, NgxImageEditorAdjustments, NgxImageEditorResult, NgxImageFilterPreset, NgxPointerDragDelta };