@archbase/components 4.0.18 → 4.0.19

package/dist/editors/ArchbaseImageEdit.d.ts

@@ -54,5 +54,25 @@ export interface ArchbaseImageEditProps<T, ID> extends ImageProps {
     maxHeight?: number;
     /** Tamanho máximo da imagem em KB (recomprime se exceder) */
     maxSizeKb?: number;
+    /**
+     * Preserva a transparência da imagem (canal alfa).
+     *
+     * Quando true:
+     *  - desabilita a compressão automática (`compressInitial` é forçado para `null`),
+     *    impedindo que a biblioteca subjacente reencodifique PNG/WebP como JPEG.
+     *  - força a saída em PNG (ou WebP, quando a origem já é WebP) ao redimensionar
+     *    via `maxWidth`/`maxHeight`/`maxSizeKb`.
+     *
+     * Útil quando o usuário precisa enviar logos com fundo transparente.
+     * Default: `false`.
+     */
+    preserveTransparency?: boolean;
+    /**
+     * Habilita logs detalhados do fluxo de processamento da imagem no console
+     * (formato detectado, decisões de compressão, mime de saída, tamanhos, etc).
+     * Útil para diagnosticar problemas como perda de transparência.
+     * Default: `false`.
+     */
+    debug?: boolean;
 }
-export declare function ArchbaseImageEdit<T, ID>({ width, height, dataSource, dataField, disabled, readOnly, required, label, description, error, src, radius, aspectRatio, objectFit, compressInitial, onChangeImage, disabledBase64Convertion, innerRef, variant, imageBackgroundColor, onProcessingChange, maxWidth, maxHeight, maxSizeKb, ...otherProps }: ArchbaseImageEditProps<T, ID>): import("react/jsx-runtime").JSX.Element;
+export declare function ArchbaseImageEdit<T, ID>({ width, height, dataSource, dataField, disabled, readOnly, required, label, description, error, src, radius, aspectRatio, objectFit, compressInitial, onChangeImage, disabledBase64Convertion, innerRef, variant, imageBackgroundColor, onProcessingChange, maxWidth, maxHeight, maxSizeKb, preserveTransparency, debug, ...otherProps }: ArchbaseImageEditProps<T, ID>): import("react/jsx-runtime").JSX.Element;

package/dist/image/editor/functions/crop-image.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Utilidades de crop usadas pelo modal de edição do ArchbaseImagePickerEditor.
+ * Trabalham diretamente sobre data URIs, preservando o mime original (PNG/WebP
+ * mantêm alpha; JPEG continua JPEG). Não há "fallback silencioso" para JPEG.
+ *
+ * Algoritmo de crop com rotação adaptado do exemplo oficial do react-easy-crop:
+ * https://github.com/ValentinH/react-easy-crop/blob/master/example/utils.ts
+ */
+export interface PixelCrop {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Aplica rotação (em graus) + crop sobre `imageSrc` e retorna o data URI
+ * resultante.
+ *
+ * Estratégia:
+ *   1. Desenha a imagem rotacionada centralizada num canvas auxiliar do
+ *      tamanho do bounding box rotacionado.
+ *   2. Faz drawImage do recorte (pixelCrop) desse canvas auxiliar para o
+ *      canvas final do tamanho do recorte.
+ *
+ * Output mime respeita `preserveTransparency` e a origem (ver pickOutputMime).
+ */
+export declare function getCroppedImage(imageSrc: string, pixelCrop: PixelCrop, rotation?: number, preserveTransparency?: boolean, quality?: number): Promise<string>;
+/**
+ * Redimensiona um data URI para respeitar maxWidth/maxHeight, preservando
+ * proporção e mime apropriado. Usado fora do fluxo de crop, ao subir um arquivo.
+ */
+export declare function resizeDataUri(dataUri: string, maxWidth?: number, maxHeight?: number, maxSizeKb?: number, quality?: number, preserveTransparency?: boolean): Promise<string>;

package/dist/image/editor/index.d.ts

@@ -2,10 +2,6 @@ import { ActionIconVariant } from '@mantine/core';
 import { default as React } from 'react';
 import { ArchbaseImagePickerConf } from './models/index.models';
 export * from './models/index.models';
-/**
- * Props do ArchbaseImagePickerEditor
- * Mantém compatibilidade total com a versão anterior
- */
 export interface ArchbaseImagePickerEditorProps {
     /** Configuração do editor (interface ArchbaseImagePickerConf) */
     config?: ArchbaseImagePickerConf;
@@ -23,30 +19,4 @@ export interface ArchbaseImagePickerEditorProps {
     /** Callback quando o estado de processamento muda (útil para desabilitar botões enquanto processa) */
     onProcessingChange?: (isProcessing: boolean) => void;
 }
-/**
- * ArchbaseImagePickerEditor - Componente de seleção e edição de imagens
- *
- * Funcionalidades:
- * - Seleção de imagens (upload)
- * - Edição com crop, redimensionamento
- * - Compressão de qualidade (JPEG/WebP)
- * - Conversão de formatos (PNG, JPEG, WebP)
- * - Filtros (contraste, brilho, saturação, sépia, blur)
- * - Suporte a dark mode
- * - Suporte a URL externa, data URI e blob URL
- *
- * @example
- * ```tsx
- * <ArchbaseImagePickerEditor
- *   imageSrcProp={imageValue}
- *   config={{
- *     width: 300,
- *     height: 200,
- *     compressInitial: 80,
- *     objectFit: 'contain',
- *     onChangeImage: (newImage) => setImageValue(newImage),
- *   }}
- * />
- * ```
- */
 export declare const ArchbaseImagePickerEditor: React.MemoExoticComponent<({ config, imageSrcProp, color, imageChanged, variant, onProcessingChange, }: ArchbaseImagePickerEditorProps) => import("react/jsx-runtime").JSX.Element>;

package/dist/image/editor/models/index.models.d.ts

@@ -18,6 +18,22 @@ export interface ArchbaseImagePickerConf {
     maxHeight?: number;
     /** Tamanho máximo da imagem em KB (recomprime se exceder) */
     maxSizeKb?: number;
+    /**
+     * Preserva a transparência (canal alfa) da imagem enviada.
+     * Quando true:
+     *  - desabilita a compressão automática (compressInitial é forçado para null),
+     *    impedindo que a biblioteca subjacente reencodifique PNG/WebP como JPEG.
+     *  - força o mime de saída para PNG (ou WebP, se a origem já for WebP) ao
+     *    redimensionar via maxWidth/maxHeight/maxSizeKb.
+     * Default: false.
+     */
+    preserveTransparency?: boolean;
+    /**
+     * Habilita logs de diagnóstico no console (formato detectado, mime de saída,
+     * tamanhos, decisões de compressão/redimensionamento).
+     * Default: false.
+     */
+    debug?: boolean;
 }
 export interface IState {
     quality: number;