@a.nemreen/dga-ui 0.3.15 → 0.3.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a.nemreen/dga-ui",
-  "version": "0.3.15",
+  "version": "0.3.17",
   "description": "DGA Angular UI library — standalone forms, overlays, navigation, and portal shell with RTL-first Tailwind styling",
   "license": "MIT",
   "author": {

package/types/a.nemreen-dga-ui.d.ts

@@ -1034,6 +1034,7 @@ interface DgaUploadRejection {
 }
 type DgaUploadAppearance = 'zone' | 'browse';
 declare class DgaUpload implements ControlValueAccessor {
+    private readonly localeService;
     readonly filesInput: _angular_core.InputSignal<DgaUploadFile[]>;
     readonly files: _angular_core.WritableSignal<DgaUploadFile[]>;
     readonly accept: _angular_core.InputSignal<string>;
@@ -1046,9 +1047,15 @@ declare class DgaUpload implements ControlValueAccessor {
     readonly disabledInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
     private readonly cvaDisabled;
     readonly disabled: _angular_core.Signal<boolean>;
+    /** Max bytes per file (`0` = unlimited). */
     readonly maxSize: _angular_core.InputSignal<number>;
     /** Max files kept when `multiple` is true (`0` = unlimited). */
     readonly maxFiles: _angular_core.InputSignal<number>;
+    /**
+     * Optional override for the constraints line under the drop zone.
+     * When empty, a line is built from `accept`, `maxSize`, and `maxFiles`.
+     */
+    readonly constraints: _angular_core.InputSignal<string>;
     readonly filesChange: _angular_core.OutputEmitterRef<DgaUploadFile[]>;
     /** Emitted when picked/dropped files were filtered out (size, accept, or maxFiles). */
     readonly rejected: _angular_core.OutputEmitterRef<DgaUploadRejection[]>;
@@ -1056,11 +1063,16 @@ declare class DgaUpload implements ControlValueAccessor {
     private onChange;
     onTouched: () => void;
     readonly zoneClasses: _angular_core.Signal<string>;
+    /** e.g. `.pdf,.doc | حجم الملف الأقصى هو : 1MB | الحد الأقصى للملفات هو : 2` */
+    readonly constraintsText: _angular_core.Signal<string>;
     onDragOver(event: DragEvent): void;
     onDrop(event: DragEvent): void;
     onPick(event: Event): void;
     remove(id: string): void;
     formatSize(bytes: number): string;
+    /** Compact label for constraints (`1MB`, `500KB`) matching legacy portal copy. */
+    formatMaxSizeCompact(bytes: number): string;
+    private isArabic;
     private addFiles;
     /** Enforce `accept` for both picker and drag-drop (HTML accept is advisory). */
     private matchesAccept;
@@ -1070,7 +1082,7 @@ declare class DgaUpload implements ControlValueAccessor {
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaUpload, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaUpload, "dga-upload", never, { "filesInput": { "alias": "files"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "browseLabel": { "alias": "browseLabel"; "required": false; "isSignal": true; }; "removeLabel": { "alias": "removeLabel"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "maxSize": { "alias": "maxSize"; "required": false; "isSignal": true; }; "maxFiles": { "alias": "maxFiles"; "required": false; "isSignal": true; }; "dragging": { "alias": "dragging"; "required": false; "isSignal": true; }; }, { "filesChange": "filesChange"; "rejected": "rejected"; "dragging": "draggingChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaUpload, "dga-upload", never, { "filesInput": { "alias": "files"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "appearance": { "alias": "appearance"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "browseLabel": { "alias": "browseLabel"; "required": false; "isSignal": true; }; "removeLabel": { "alias": "removeLabel"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "maxSize": { "alias": "maxSize"; "required": false; "isSignal": true; }; "maxFiles": { "alias": "maxFiles"; "required": false; "isSignal": true; }; "constraints": { "alias": "constraints"; "required": false; "isSignal": true; }; "dragging": { "alias": "dragging"; "required": false; "isSignal": true; }; }, { "filesChange": "filesChange"; "rejected": "rejected"; "dragging": "draggingChange"; }, never, never, true, never>;
 }
 
 /** Infer UI locale from `<html lang>` (avoids importing `@a.nemreen/dga-tokens` into ng-packagr graph). */
@@ -1290,12 +1302,20 @@ declare class DgaSignaturePad implements ControlValueAccessor {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaSignaturePad, "dga-signature-pad", never, { "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "penColor": { "alias": "penColor"; "required": false; "isSignal": true; }; "lineWidth": { "alias": "lineWidth"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "clearLabel": { "alias": "clearLabel"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
 }
 
-type DgaRichTextCmd = 'bold' | 'italic' | 'underline' | 'insertUnorderedList' | 'insertOrderedList';
+type DgaRichTool = 'bold' | 'italic' | 'underline' | 'strike' | 'h2' | 'h3' | 'ul' | 'ol' | 'quote' | 'alignStart' | 'alignCenter' | 'alignEnd' | 'link' | 'clear';
 /**
- * Lightweight contenteditable rich-text field (bold / italic / underline / lists).
+ * Contenteditable rich-text field: inline styles, headings, lists, quote,
+ * alignment, and links. `value` is sanitized HTML.
+ *
+ * @example
+ * ```html
+ * <dga-rich-text [(value)]="html" label="الوصف" />
+ * ```
  */
 declare class DgaRichText {
+    private readonly destroyRef;
     private readonly editorRef;
+    private readonly linkInputRef;
     readonly value: _angular_core.ModelSignal<string>;
     readonly placeholder: _angular_core.InputSignal<string>;
     readonly label: _angular_core.InputSignal<string>;
@@ -1303,23 +1323,65 @@ declare class DgaRichText {
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     private readonly uiLocale;
     private readonly ar;
-    private readonly syncing;
-    private readonly activeCmds;
+    private readonly active;
+    private readonly block;
+    /** Last HTML this component published. External writes differ from this. */
+    private owned;
+    private range;
+    readonly empty: _angular_core.WritableSignal<boolean>;
+    readonly linkOpen: _angular_core.WritableSignal<boolean>;
+    readonly linkUrl: _angular_core.WritableSignal<string>;
+    readonly labelId: string;
     readonly toolbarLabel: _angular_core.Signal<"شريط التنسيق" | "Formatting toolbar">;
     readonly labels: _angular_core.Signal<{
         bold: string;
         italic: string;
         underline: string;
+        strike: string;
+        h2: string;
+        h3: string;
         ul: string;
         ol: string;
+        quote: string;
+        alignStart: string;
+        alignCenter: string;
+        alignEnd: string;
+        link: string;
+        clear: string;
+        linkUrl: string;
+        apply: string;
+        cancel: string;
     }>;
+    readonly tools: _angular_core.Signal<{
+        id: DgaRichTool;
+        label: string;
+        text: boolean;
+        sep: boolean;
+    }[]>;
     constructor();
-    isActive(cmd: DgaRichTextCmd): boolean;
-    exec(cmd: DgaRichTextCmd): void;
+    pressed(id: DgaRichTool): boolean;
+    keepSelection(event: Event): void;
+    onTool(id: DgaRichTool): void;
     onInput(): void;
     onBlur(): void;
-    refreshActive(): void;
-    private emitFromEditor;
+    onCaret(): void;
+    onKeydown(event: KeyboardEvent): void;
+    openLink(): void;
+    closeLink(): void;
+    applyLink(): void;
+    private exec;
+    private formatBlock;
+    private clearFormat;
+    private explicitAlign;
+    private alignCommand;
+    private refreshActive;
+    private publish;
+    private restoreSelection;
+    private captureRange;
+    private rangeIsCollapsed;
+    private anchorFromSelection;
+    private direction;
+    private editorEl;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DgaRichText, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DgaRichText, "dga-rich-text", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "minHeight": { "alias": "minHeight"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
 }
@@ -3104,7 +3166,7 @@ declare class DgaNavRail {
     readonly smoothScroll: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly select: _angular_core.OutputEmitterRef<DgaNavRailItem>;
     readonly expandChange: _angular_core.OutputEmitterRef<boolean>;
-    readonly edgeAttr: _angular_core.Signal<"left" | "start" | "end" | "right" | null>;
+    readonly edgeAttr: _angular_core.Signal<"left" | "right" | "start" | "end" | null>;
     readonly offsetCss: _angular_core.Signal<string>;
     readonly tooltipPlacement: _angular_core.Signal<"start" | "end">;
     readonly iconSize: _angular_core.Signal<"sm" | "md" | "lg">;