ngx-dsxlibrary 2.21.21 → 2.21.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-dsxlibrary",
-  "version": "2.21.21",
+  "version": "2.21.23",
   "description": "Libreria para control de código automatizado.",
   "author": "DevSoftXela",
   "dependencies": {

package/types/ngx-dsxlibrary.d.ts

@@ -177,6 +177,131 @@ declare class PdfPreviewComponent implements OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<PdfPreviewComponent, "app-pdf-preview", never, { "visible": { "alias": "visible"; "required": false; "isSignal": true; }; "blob": { "alias": "blob"; "required": false; "isSignal": true; }; }, { "visible": "visibleChange"; }, never, never, true, never>;
 }
 
+/**
+ * Tipos de acción disponibles para el componente `dsx-button`.
+ *
+ * Usa `ACTION_TYPES` en el consumidor para evitar typos.
+ *
+ * **Persistencia de datos (formulario)**
+ * - `create`      → Navega a la ruta de nuevo registro (azul)
+ * - `saveOrUpdate` → Muestra "Guardar" si `id` es 0, "Actualizar" si `id` > 0 (amarillo)
+ *
+ * **Eliminar**
+ * - `delete`     → Eliminar registro permanentemente (rojo)
+ * - `softDelete` → Borrar registro con borrado lógico (amarillo)
+ *
+ * **Formulario**
+ * - `validate` → Validar formulario sin guardar (gris)
+ * - `restore`  → Restaurar datos originales (gris)
+ *
+ * **Navegación / Utilidades**
+ * - `home`    → Ir al inicio (gris)
+ * - `refresh` → Recargar datos desde el servidor (morado)
+ */
+declare const ACTION_TYPES: {
+    readonly delete: "delete";
+    readonly softDelete: "softDelete";
+    readonly home: "home";
+    readonly validate: "validate";
+    readonly restore: "restore";
+    readonly edit: "edit";
+    readonly create: "create";
+    readonly saveOrUpdate: "saveOrUpdate";
+    readonly refresh: "refresh";
+};
+type ActionType = (typeof ACTION_TYPES)[keyof typeof ACTION_TYPES];
+/**
+ * Paleta corporativa de colores para `dsx-button`.
+ *
+ * Cada token tiene un significado semántico fijo. Úsala como referencia
+ * para asignar `colorToken` al añadir nuevos tipos de botón.
+ *
+ * | Token     | Color          | Uso semántico                                     |
+ * |-----------|----------------|---------------------------------------------------|
+ * | danger    | Coral rojo     | Acción destructiva e irreversible (eliminar)      |
+ * | warning   | Naranja cálido | Acción con riesgo moderado / borrado lógico       |
+ * | caution   | Ámbar dorado   | Requiere verificación del usuario (actualizar)    |
+ * | success   | Verde menta    | Guardar nuevo registro / agregar                  |
+ * | primary   | Azul claro     | Editar / navegar con contexto de registro         |
+ * | info      | Cian suave     | Recargar datos / refrescar vista                  |
+ * | neutral   | Gris azulado   | Acción secundaria / navegación sin contexto       |
+ * | restore   | Violeta suave  | Deshacer / restaurar estado anterior              |
+ */
+declare const DSX_PALETTE: {
+    readonly danger: "#EF5350";
+    readonly warning: "#FF7043";
+    readonly caution: "#FFB300";
+    readonly success: "#66BB6A";
+    readonly primary: "#42A5F5";
+    readonly info: "#26C6DA";
+    readonly neutral: "#90A4AE";
+    readonly restore: "#AB47BC";
+};
+type DsxColorToken = keyof typeof DSX_PALETTE;
+type DsxButtonConfig = {
+    label: string;
+    icon: string;
+    tooltip: string;
+    /** Token de la paleta corporativa que determina el color del botón. */
+    colorToken: DsxColorToken;
+    primeIcon?: string;
+    /** Si es `true`, el botón se renderiza con contorno en lugar de relleno sólido. */
+    outlined?: boolean;
+};
+declare class DsxButtonComponent {
+    private readonly _paramService;
+    private readonly _router;
+    type: i0.InputSignal<"delete" | "softDelete" | "home" | "validate" | "restore" | "edit" | "create" | "saveOrUpdate" | "refresh">;
+    disabled: i0.InputSignal<boolean>;
+    routerLink: i0.InputSignal<string | any[] | undefined>;
+    /**
+     * Ruta de navegación simplificada. La `/` inicial se agrega automáticamente.
+     * Cada segmento solo admite: letras, números, `-`, `_`, `.` y `:` (params de ruta).
+     * Ejemplos válidos:   `'home'`, `'container/nuevo'`, `'item/123'`
+     * Ejemplos inválidos: `'item/*'`, `'item?foo=bar'`, `'item/../other'`
+     * Para rutas dinámicas complejas usa `[routerLink]` directamente.
+     */
+    routerPath: i0.InputSignal<string | undefined>;
+    /** Ancho del botón. Usa `rem` para que escale con la preferencia de fuente del usuario.
+     *  Ejemplo: `'8rem'`, `'12rem'`. Valor por defecto: `'9rem'`.
+     */
+    width: i0.InputSignal<string>;
+    iconOnly: i0.InputSignal<boolean>;
+    iconOnlyWidth: i0.InputSignal<string>;
+    raised: i0.InputSignal<boolean>;
+    rounded: i0.InputSignal<boolean>;
+    parameterName: i0.InputSignal<string | undefined>;
+    parameterExpectedValue: i0.InputSignal<any>;
+    parameterIndex: i0.InputSignal<number>;
+    id: i0.InputSignal<string | number | null | undefined>;
+    requireIdInput: i0.InputSignal<boolean>;
+    requiresIdGreaterThanZero: i0.InputSignal<boolean>;
+    labelOverride: i0.InputSignal<string | undefined>;
+    tooltipOverride: i0.InputSignal<string | undefined>;
+    iconOverride: i0.InputSignal<string | undefined>;
+    primeIconOverride: i0.InputSignal<string | undefined>;
+    action: i0.OutputEmitterRef<void>;
+    /** Valida y normaliza `routerPath`: agrega `/` inicial y rechaza caracteres inválidos. */
+    readonly resolvedRouterLink: i0.Signal<string | undefined>;
+    /** Prioriza routerPath (validado) sobre routerLink (libre). */
+    readonly effectiveRouterLink: i0.Signal<string | any[] | undefined>;
+    get buttonStyle(): Record<string, string>;
+    get buttonLabel(): string | undefined;
+    get config(): DsxButtonConfig;
+    get label(): string;
+    get tooltip(): string;
+    get icon(): string;
+    get primeIcon(): string | undefined;
+    showButton(): boolean;
+    onButtonClick(): Promise<void>;
+    private passesIdValidation;
+    private getNormalizedId;
+    private navigateToTarget;
+    private passesParameterValidation;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DsxButtonComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DsxButtonComponent, "dsx-button", never, { "type": { "alias": "type"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "routerLink": { "alias": "routerLink"; "required": false; "isSignal": true; }; "routerPath": { "alias": "routerPath"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "iconOnly": { "alias": "iconOnly"; "required": false; "isSignal": true; }; "iconOnlyWidth": { "alias": "iconOnlyWidth"; "required": false; "isSignal": true; }; "raised": { "alias": "raised"; "required": false; "isSignal": true; }; "rounded": { "alias": "rounded"; "required": false; "isSignal": true; }; "parameterName": { "alias": "parameterName"; "required": false; "isSignal": true; }; "parameterExpectedValue": { "alias": "parameterExpectedValue"; "required": false; "isSignal": true; }; "parameterIndex": { "alias": "parameterIndex"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "requireIdInput": { "alias": "requireIdInput"; "required": false; "isSignal": true; }; "requiresIdGreaterThanZero": { "alias": "requiresIdGreaterThanZero"; "required": false; "isSignal": true; }; "labelOverride": { "alias": "labelOverride"; "required": false; "isSignal": true; }; "tooltipOverride": { "alias": "tooltipOverride"; "required": false; "isSignal": true; }; "iconOverride": { "alias": "iconOverride"; "required": false; "isSignal": true; }; "primeIconOverride": { "alias": "primeIconOverride"; "required": false; "isSignal": true; }; }, { "action": "action"; }, never, never, true, never>;
+}
+
 declare class IconDsxService {
     private http;
     private sanitizer;
@@ -192,12 +317,12 @@ declare class IconDsxService {
 
 declare class IconDsxComponent {
     private iconService;
-    name: string;
+    name: i0.InputSignal<string>;
     svg$: Observable<SafeHtml>;
     constructor(iconService: IconDsxService);
     ngOnInit(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<IconDsxComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<IconDsxComponent, "icon-dsx", never, { "name": { "alias": "name"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<IconDsxComponent, "icon-dsx", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class JsonValuesDebujComponent {
@@ -3016,5 +3141,5 @@ interface AsyncExistsValidatorOptions {
  */
 declare function asyncExistsValidator<T extends string | number = string | number>(serviceMethod: (value: T, currentId: string | number) => Observable<boolean>, options?: AsyncExistsValidatorOptions): AsyncValidatorFn;
 
-export { AlertaService, AppMessageErrorComponent, ArrowNavigationDirective, AuthorizeService, BaseCRUDService, CACHE_KEYS, CacheService, CssV2Component, DocxPreviewComponent, DsxAddToolsModule, DteService, ENVIRONMENT, EndpointService, ErrorHandlerService, FileComponent, GTQFormatter, HttpHelpersService, INITIAL_PARAMETERS, IconDsxComponent, JoinByPipe, JsonHighlightPipe, JsonValuesDebujComponent, JsonViewerComponent, KpicardComponent, LoadingComponent, LoadingLottieComponent, LogoDsxComponent, MasterDetailChangeService, NavbarDsxComponent, NetworkStatusComponent, OnlyRangoPatternDirective, ParameterValuesService, PdfPreviewComponent, PrimeNgModule, SWEET_ALERT_THEMES, SecurityService, SelectAllOnFocusDirective, SpinnerLoadingService, TruncatePipe, UtilityAddService, asyncExistsValidator, atLeastOneFieldRequiredValidator, createCurrencyFormatter, createInitialCache, createTypedCacheProvider, cuiValidator, dateMinMaxValidator, dateRangeValidator, dateRangeValidatorFromTo, developmentEnvironment, getZeroBasedRolIndex, httpAuthorizeInterceptor, nitValidator, productionEnvironment, provideEnvironment, validateEnvironmentConfig };
-export type { AppEnvironment, AsyncExistsValidatorOptions, BlobRequestOptions, Certificacion, Column, Complemento, Complementos, DatosEmision, DatosGenerales, DevEnvironmentComplete, DevEnvironmentDefaults, Direccion, DocumentoFelResponse, DsxValidateUnique, Dte, Emisor, EnvironmentConfig, ExportColumn, FechasConversion, FieldConfig, FilterOption, FormRule, Frase, Frases, Impuesto, Impuestos, InferCacheKeyType, InferCacheOptions, Item, Items, MasterDetailChangeResult, MasterDetailDifference, MasterDetailRawEntity, MasterDetailSimpleFormOptions, MasterDetailSimpleFormTracker, MasterDetailState, MyParameterValues, NITResponse, NumeroAutorizacion, ParameterSecurity, ParameterValue, ProdEnvironmentComplete, ProdEnvironmentDefaults, ReactiveForm, Receptor, ResponseHttpModel, Sat, SeguridadITParameter, ServiceResult, ServiceResultVoid, SweetAlertThemeType, T, TipoFechaConversion, TotalImpuesto, Totales, TypedForm, typeModel };
+export { ACTION_TYPES, AlertaService, AppMessageErrorComponent, ArrowNavigationDirective, AuthorizeService, BaseCRUDService, CACHE_KEYS, CacheService, CssV2Component, DSX_PALETTE, DocxPreviewComponent, DsxAddToolsModule, DsxButtonComponent, DteService, ENVIRONMENT, EndpointService, ErrorHandlerService, FileComponent, GTQFormatter, HttpHelpersService, INITIAL_PARAMETERS, IconDsxComponent, JoinByPipe, JsonHighlightPipe, JsonValuesDebujComponent, JsonViewerComponent, KpicardComponent, LoadingComponent, LoadingLottieComponent, LogoDsxComponent, MasterDetailChangeService, NavbarDsxComponent, NetworkStatusComponent, OnlyRangoPatternDirective, ParameterValuesService, PdfPreviewComponent, PrimeNgModule, SWEET_ALERT_THEMES, SecurityService, SelectAllOnFocusDirective, SpinnerLoadingService, TruncatePipe, UtilityAddService, asyncExistsValidator, atLeastOneFieldRequiredValidator, createCurrencyFormatter, createInitialCache, createTypedCacheProvider, cuiValidator, dateMinMaxValidator, dateRangeValidator, dateRangeValidatorFromTo, developmentEnvironment, getZeroBasedRolIndex, httpAuthorizeInterceptor, nitValidator, productionEnvironment, provideEnvironment, validateEnvironmentConfig };
+export type { ActionType, AppEnvironment, AsyncExistsValidatorOptions, BlobRequestOptions, Certificacion, Column, Complemento, Complementos, DatosEmision, DatosGenerales, DevEnvironmentComplete, DevEnvironmentDefaults, Direccion, DocumentoFelResponse, DsxColorToken, DsxValidateUnique, Dte, Emisor, EnvironmentConfig, ExportColumn, FechasConversion, FieldConfig, FilterOption, FormRule, Frase, Frases, Impuesto, Impuestos, InferCacheKeyType, InferCacheOptions, Item, Items, MasterDetailChangeResult, MasterDetailDifference, MasterDetailRawEntity, MasterDetailSimpleFormOptions, MasterDetailSimpleFormTracker, MasterDetailState, MyParameterValues, NITResponse, NumeroAutorizacion, ParameterSecurity, ParameterValue, ProdEnvironmentComplete, ProdEnvironmentDefaults, ReactiveForm, Receptor, ResponseHttpModel, Sat, SeguridadITParameter, ServiceResult, ServiceResultVoid, SweetAlertThemeType, T, TipoFechaConversion, TotalImpuesto, Totales, TypedForm, typeModel };