@theseam/ui-common 1.0.2-beta.59 → 1.0.2-beta.63

package/signature-input/index.d.ts

@@ -1,12 +1,12 @@
 import * as _almothafar_angular_signature_pad from '@almothafar/angular-signature-pad';
 import { NgSignaturePadOptions } from '@almothafar/angular-signature-pad';
 import * as _angular_core from '@angular/core';
-import { InjectionToken, AfterViewInit } from '@angular/core';
+import { InjectionToken, AfterViewInit, EventEmitter } from '@angular/core';
 import * as _fortawesome_fontawesome_common_types from '@fortawesome/fontawesome-common-types';
 import { FormGroup, FormControl, ControlValueAccessor } from '@angular/forms';
-import { NgxFileDropEntry } from 'ngx-file-drop';
+import { ModalConfig } from '@theseam/ui-common/modal';
 import * as _angular_cdk_testing from '@angular/cdk/testing';
-import { ComponentHarness, TestElement } from '@angular/cdk/testing';
+import { ComponentHarness, TestElement, BaseHarnessFilters, HarnessPredicate } from '@angular/cdk/testing';
 
 /**
  * Options for `szimek/signature_pad` exposed by
@@ -152,24 +152,13 @@ declare class TheSeamSignatureInputImgComponent implements ControlValueAccessor,
     static readonly MAX_FILE_SIZE: number;
     private readonly _container;
     private readonly _destroyRef;
-    /**
-     * The File is only needed for validation at selection time. Once it's been
-     * converted to a data URL and stored in the form value, we don't need the
-     * File again — so there's no point trying to round-trip it through
-     * writeValue / form state. The preview renders off the current form value.
-     */
     protected readonly _fileControl: FormControl<File | null>;
     private readonly _fileStatus;
     protected readonly _sizeError: _angular_core.Signal<string | null>;
-    /**
-     * Single source of truth for both the form value and the preview image.
-     * External writes (writeValue) and successful uploads both funnel through
-     * here, so switching tabs and coming back always shows the last committed
-     * signature.
-     */
     private readonly _value;
     protected readonly _previewDataUrl: _angular_core.Signal<string | null>;
     protected readonly _previewBackgroundImage: _angular_core.Signal<string | null>;
+    private readonly _nativeInput;
     private _onChange;
     private _onTouched;
     constructor();
@@ -179,12 +168,66 @@ declare class TheSeamSignatureInputImgComponent implements ControlValueAccessor,
     setDisabledState(isDisabled: boolean): void;
     clear(): void;
     openFileBrowse(): void;
-    protected _onFileDropped(files: NgxFileDropEntry[]): void;
+    protected _onFilesDropped(files: File[]): void;
+    protected _onNativeChange(event: Event): void;
     private _setValue;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TheSeamSignatureInputImgComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TheSeamSignatureInputImgComponent, "seam-signature-input-img", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * Opens the signature input panel in a modal when the host button/anchor is
+ * clicked, and writes the submitted data URL back through its bound form
+ * control. Implements `ControlValueAccessor` so it works with any of the form
+ * binding styles (`formControl`, `formControlName`, `ngModel`).
+ *
+ * Usage:
+ *
+ * ```html
+ * <button seamButton theme="primary" seamSignatureInput formControlName="signature">
+ *   Sign
+ * </button>
+ * ```
+ *
+ * The selector-name input accepts a partial `ModalConfig` for cases that need
+ * to tweak the modal (e.g. `disableClose`):
+ *
+ * ```html
+ * <button
+ *   seamButton
+ *   [seamSignatureInput]="{ disableClose: true }"
+ *   formControlName="signature"
+ * >Sign</button>
+ * ```
+ */
+declare class TheSeamSignatureInputButtonDirective implements ControlValueAccessor {
+    private readonly _modal;
+    private readonly _elementRef;
+    private readonly _seamButton;
+    private readonly _seamAnchor;
+    /**
+     * Partial `ModalConfig` passthrough. Most consumers leave this unset; the
+     * signature panel's styles assume the default modal size.
+     */
+    modalConfig: ModalConfig | null | undefined;
+    /** Emits the submitted data URL when the user applies a signature. */
+    signed: EventEmitter<string>;
+    /** Emits when the user dismisses the panel without submitting. */
+    canceled: EventEmitter<void>;
+    private _value;
+    private _disabled;
+    private _onChange;
+    private _onTouched;
+    writeValue(value: string | null): void;
+    registerOnChange(fn: (value: string | null) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    /** @ignore */
+    _onClick(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TheSeamSignatureInputButtonDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<TheSeamSignatureInputButtonDirective, "button[seamSignatureInput], a[seamSignatureInput]", ["seamSignatureInput"], { "modalConfig": { "alias": "seamSignatureInput"; "required": false; }; }, { "signed": "signed"; "canceled": "canceled"; }, never, never, true, never>;
+}
+
 declare class TheSeamSignatureInputImgHarness extends ComponentHarness {
     static hostSelector: string;
     private readonly _fileDrop;
@@ -237,5 +280,16 @@ declare class TheSeamSignatureInputPanelHarness extends ComponentHarness {
     submit(): Promise<void>;
 }
 
-export { THESEAM_SIGNATURE_INPUT_CONTAINER, TheSeamSignatureInputImgComponent, TheSeamSignatureInputImgHarness, TheSeamSignatureInputPanelComponent, TheSeamSignatureInputPanelHarness, TheSeamSignatureInputPenComponent, TheSeamSignatureInputPenHarness, TheSeamSignatureInputTextComponent, TheSeamSignatureInputTextHarness };
+interface SignatureInputButtonHarnessFilters extends BaseHarnessFilters {
+    text?: string | RegExp;
+}
+declare class TheSeamSignatureInputButtonHarness extends ComponentHarness {
+    static hostSelector: string;
+    static with(options?: SignatureInputButtonHarnessFilters): HarnessPredicate<TheSeamSignatureInputButtonHarness>;
+    getText(): Promise<string>;
+    isDisabled(): Promise<boolean>;
+    click(): Promise<void>;
+}
+
+export { THESEAM_SIGNATURE_INPUT_CONTAINER, TheSeamSignatureInputButtonDirective, TheSeamSignatureInputButtonHarness, TheSeamSignatureInputImgComponent, TheSeamSignatureInputImgHarness, TheSeamSignatureInputPanelComponent, TheSeamSignatureInputPanelHarness, TheSeamSignatureInputPenComponent, TheSeamSignatureInputPenHarness, TheSeamSignatureInputTextComponent, TheSeamSignatureInputTextHarness };
 export type { SignatureFontState, SignatureInputContainer, SignatureInputItem, SignatureInputOptions, SignatureInputPanelResult, SignatureInputResetType, SignatureInputType, SignaturePadOptions };