limbo-component 4.4.0 → 4.5.0

package/dist/types/src/utils/imageFilters.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Convert a validated 6-digit hex color + alpha (0..1) to an `rgba()` CSS color string.
+ *
+ * @param {*} hex
+ * @param {number} alpha - 0..1
+ * @param {string} fallback - Fallback hex color if `hex` fails validation (T-10-02).
+ * @returns {string}
+ */
+export function hexToRgba(hex: any, alpha: number, fallback: string): string;
+/**
+ * Return a fresh, independent deep clone of the canonical neutral filter state (IMGFLT-07).
+ *
+ * Never returns a shared reference — mutating the result never affects
+ * `NEUTRAL_FILTER_STATE` nor any other call's result.
+ *
+ * @returns {object} A new neutral filter state object (JSON-serializable).
+ */
+export function getNeutralFilterState(): object;
+/**
+ * Build the shared CSS `<filter-function-list>` string consumed identically by
+ * `style.filter` (preview) and `ctx.filter` (Canvas bake) — D-08.
+ *
+ * Basic adjustments (brightness/contrast/saturate) are clamped to -100..100 and mapped
+ * to 0%..200% with neutral at 0 → 100% (D-11). Presets (IMGFLT-03) stack after the basics
+ * (D-07). Opacity is clamped to 0..100 and mapped directly (D-12). Non-numeric input
+ * degrades to neutral before interpolation (ASVS V5 / T-10-01).
+ *
+ * @param {object} filters - Filter state (see module interfaces contract).
+ * @returns {string} CSS filter string, e.g. "brightness(120%) contrast(100%) saturate(100%) sepia(100%) opacity(100%)".
+ */
+export function buildFilterString(filters: object): string;
+/**
+ * Build the CSS `linear-gradient()` string used as a preview overlay (IMGFLT-04).
+ *
+ * Returns `null` when the gradient is disabled. Colors are validated as 6-digit hex
+ * before composing (T-10-02); the gradient opacity (0..100, D-12) is applied as alpha.
+ *
+ * NOTE: This is preview-only. `ctx.createLinearGradient()` (Phase 11 bake) does not
+ * accept an angle — use `gradientAngleToCanvasVector()` to convert.
+ *
+ * @param {object} gradient - { enabled, angle, colorStart, colorEnd, opacity }.
+ * @returns {string|null}
+ */
+export function buildGradientCss(gradient: object): string | null;
+/**
+ * Convert a CSS gradient angle (0°=up, clockwise, D-16) to a Canvas gradient vector
+ * (x0,y0 → x1,y1) suitable for `ctx.createLinearGradient()` (IMGFLT-04, Pitfall 4).
+ *
+ * CSS and Canvas use incompatible angle/coordinate conventions — this is the single
+ * source of truth for that conversion so preview (CSS) and bake (Canvas, Phase 11)
+ * never diverge visually.
+ *
+ * @param {number} angleDeg - CSS gradient angle, 0..360.
+ * @param {number} width - Target canvas/image width in px.
+ * @param {number} height - Target canvas/image height in px.
+ * @returns {{x0: number, y0: number, x1: number, y1: number}}
+ */
+export function gradientAngleToCanvasVector(angleDeg: number, width: number, height: number): {
+    x0: number;
+    y0: number;
+    x1: number;
+    y1: number;
+};
+/**
+ * Return the total number of non-neutral filters currently active (D-03 badge counter).
+ *
+ * Each basic adjustment, the preset, the opacity and the gradient count as at most 1
+ * each (max 6).
+ *
+ * @param {object} filters
+ * @returns {number}
+ */
+export function countActiveFilters(filters: object): number;
+/**
+ * Return whether any filter is currently non-neutral (D-03 badge visibility gate).
+ *
+ * @param {object} filters
+ * @returns {boolean}
+ */
+export function hasActiveFilters(filters: object): boolean;
+/**
+ * Return human-readable labels (via the provided `t` i18n function) for every
+ * currently active filter — used to populate the badge tooltip (D-03, IMGFLT-12).
+ *
+ * @param {object} filters
+ * @param {(key: string) => string} t - i18n translation function.
+ * @returns {string[]}
+ */
+export function getActiveFilterLabels(filters: object, t: (key: string) => string): string[];
+/**
+ * Apply the shared filter string to a Canvas 2D rendering context (Phase 11 bake).
+ *
+ * `ctx` is received by parameter — this does not introduce a DOM/global dependency
+ * into the module (IMGFLT-11 portability preserved).
+ *
+ * @param {CanvasRenderingContext2D} ctx
+ * @param {object} filters
+ * @returns {void}
+ */
+export function applyFiltersToCanvas(ctx: CanvasRenderingContext2D, filters: object): void;
+/**
+ * Bake the full filter pipeline (basics/preset/opacity via ctx.filter + gradient overlay)
+ * onto a Canvas 2D context — single source of truth reused by generatePreview,
+ * processSingleCrop/downloadSingleCrop (con recorte) y handleKeepOriginal (sin recorte),
+ * garantizando la paridad WYSIWYG exigida por D-02/D-06 (Phase 11).
+ *
+ * @param {CanvasRenderingContext2D} ctx
+ * @param {CanvasImageSource} image - Fuente a dibujar (HTMLImageElement, HTMLCanvasElement, etc.)
+ * @param {{width: number, height: number}} size
+ * @param {object} filters
+ * @returns {void}
+ */
+export function bakeFiltersToCanvas(ctx: CanvasRenderingContext2D, image: CanvasImageSource, { width, height }: {
+    width: number;
+    height: number;
+}, filters: object): void;
+export namespace NEUTRAL_FILTER_STATE {
+    let brightness: number;
+    let contrast: number;
+    let saturate: number;
+    let preset: any;
+    let opacity: number;
+    namespace gradient {
+        export let enabled: boolean;
+        export let angle: number;
+        export let colorStart: string;
+        export let colorEnd: string;
+        let opacity_1: number;
+        export { opacity_1 as opacity };
+    }
+}
+//# sourceMappingURL=imageFilters.d.ts.map

package/dist/types/src/utils/imageFilters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageFilters.d.ts","sourceRoot":"","sources":["../../../../src/utils/imageFilters.js"],"names":[],"mappings":"AA+EA;;;;;;;GAOG;AACH,+BALW,GAAC,SACD,MAAM,YACN,MAAM,GACJ,MAAM,CAQlB;AAYD;;;;;;;GAOG;AACH,yCAFa,MAAM,CAIlB;AAED;;;;;;;;;;;GAWG;AACH,2CAHW,MAAM,GACJ,MAAM,CA+BlB;AAED;;;;;;;;;;;GAWG;AACH,2CAHW,MAAM,GACJ,MAAM,GAAC,IAAI,CAavB;AAED;;;;;;;;;;;;GAYG;AACH,sDALW,MAAM,SACN,MAAM,UACN,MAAM,GACJ;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAC,CAY5D;AAED;;;;;;;;GAQG;AACH,4CAHW,MAAM,GACJ,MAAM,CAWlB;AAED;;;;;GAKG;AACH,0CAHW,MAAM,GACJ,OAAO,CAInB;AAED;;;;;;;GAOG;AACH,+CAJW,MAAM,KACN,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GACrB,MAAM,EAAE,CAWpB;AAED;;;;;;;;;GASG;AACH,0CAJW,wBAAwB,WACxB,MAAM,GACJ,IAAI,CAIhB;AAED;;;;;;;;;;;GAWG;AACH,yCANW,wBAAwB,SACxB,iBAAiB,qBACjB;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,WAC/B,MAAM,GACJ,IAAI,CAgBhB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "limbo-component",
-  "version": "4.4.0",
+  "version": "4.5.0",
   "private": false,
   "type": "module",
   "description": "Limbo - Highly configurable React image manager component for web portals",