sass-cms-template-common 0.0.11 → 0.0.12

package/dist/index.d.ts

@@ -919,7 +919,11 @@ export declare type CmsConfirmDialogProps = {
     minHeight?: number | string;
     /** Evita cerrar al hacer clic fuera o con Escape (p. ej. mientras carga). */
     disableBackdropClose?: boolean;
-    /** Base para los `data-testid`. */
+    /**
+     * Base para los `data-testid`. Emite: `${testId}` (modal),
+     * `${testId}-icon-btn-close` (botón X), `${testId}-actions` (fila de botones)
+     * y los botones `${testId}-actions-btn-cancel` y `${testId}-actions-btn-confirm`.
+     */
     testId?: string;
 };
 
@@ -1052,7 +1056,11 @@ export declare type CmsDialogActionsProps = {
     fullWidth?: boolean;
     /** Alineación horizontal de los botones. Por defecto `end`. */
     align?: CmsDialogActionsAlign;
-    /** Base para los `data-testid`. */
+    /**
+     * Base para los `data-testid`. El contenedor usa `testId`; el botón cancelar
+     * emite `${testId}-btn-cancel` y el de confirmar `${testId}-btn-confirm`
+     * (cada uno con su `data-action` `cancel` / `confirm` como atributo extra).
+     */
     testId?: string;
 };
 
@@ -6937,6 +6945,28 @@ export declare type TopBarProps = {
  */
 export declare function toSiteWallClock(epochMs: number, gmtRedaction: string | null | undefined): number;
 
+/**
+ * Normaliza un valor a un `data-testid` estable en kebab-case ASCII.
+ *
+ * Equivalente React del pipe `toTestId` del CMS Angular (`cmsmedios-ux`):
+ * pasa a minúsculas, quita tildes/acentos y convierte cualquier separador
+ * (espacios, puntos, guiones bajos, barras) en un único guion.
+ *
+ * IMPORTANTE: el valor que se le pasa debe ser **independiente del idioma**
+ * (una clave i18n, un `id`/`value`/`slug`, un código o enum interno), nunca el
+ * texto traducido: si no, el `data-testid` cambiaría según el idioma del usuario
+ * y las pruebas no podrían apuntarlo de forma estable.
+ *
+ * @param value Valor de origen (clave i18n, id, código o índice).
+ * @returns El `data-testid` normalizado, o `''` si el valor es vacío/nulo.
+ *
+ * @example
+ * toTestId('modal.deactivate.title') // 'modal-deactivate-title'
+ * toTestId('Próximo evento')         // 'proximo-evento'
+ * toTestId(3)                        // '3'
+ */
+export declare function toTestId(value: string | number | null | undefined): string;
+
 /**
  * Cuerpo de la respuesta de POST /transcribe/get.
  *