tempest-react-sdk 0.40.0 → 0.42.0

package/dist/vision.d.ts

@@ -205,6 +205,28 @@ export declare class Classifier extends VisionTask {
     private readonly _std;
     private readonly _applySoftmax;
     private constructor();
+    private _pipelineCache;
+    /**
+     * Run the model once on a zero tensor, paying one-time costs up front.
+     *
+     * The first inference of a session is not representative: WebGPU compiles its
+     * shaders on it and the WASM backend faults in its arenas. Calling this while
+     * a loading spinner is still up moves that cost somewhere the user is already
+     * waiting — which matters most for a classifier running as the last step of
+     * an on-device analysis, where the delay lands right before the answer shows.
+     *
+     * @param runs How many warm-up inferences to run. One is enough for WASM;
+     *   WebGPU sometimes settles on the second.
+     */
+    warmup(runs?: number): Promise<void>;
+    /**
+     * The fused preprocessing pipeline, built on first use.
+     *
+     * Lazily, because constructing it reserves the output buffer: a task built in
+     * an environment without a canvas implementation stays constructible, and only
+     * fails if it is actually asked to preprocess something.
+     */
+    private get _pipeline();
     /** Load the model and resolve labels. */
     static create(model: ModelSource, options?: ClassifierOptions): Promise<Classifier>;
     /** Class labels indexed by class id. */
@@ -958,6 +980,19 @@ export declare const DEFAULT_PROVIDERS: readonly string[];
          readonly reused: boolean;
      }
 
+     /** Planar tensor data produced by {@link ResizePipeline}. */
+     export declare interface FusedResizeResult {
+         /** CHW float32, normalized, length `3 * targetHeight * targetWidth`. */
+         readonly data: Float32Array;
+         /**
+          * Whether {@link data} is the pipeline's reusable buffer.
+          *
+          * `true` means the next {@link ResizePipeline.run} overwrites it, so a caller
+          * keeping the values past its own inference has to copy them.
+          */
+         readonly reused: boolean;
+     }
+
      /** Value of the `ovs.kind` metadata key for a detector→classifier pipeline. */
      export declare const FUSION_KIND_DETECT_CLASSIFY = "detect_classify";
 
@@ -1571,6 +1606,90 @@ export declare const DEFAULT_PROVIDERS: readonly string[];
             /** Resize an image to `(targetWidth, targetHeight)` using high-quality canvas resampling. */
             export declare function resize(image: RGBImage, targetWidth: number, targetHeight: number): RGBImage;
 
+            /**
+             * Reusable stretch-resize → normalized tensor pipeline for one target size.
+             *
+             * The classification counterpart of {@link LetterboxPipeline}. A classifier
+             * stretches to the model's square input instead of letterboxing into it — no
+             * padding, no scale to invert later, because nothing is mapped back onto the
+             * source image afterwards. That difference is why it cannot simply reuse the
+             * letterbox path.
+             *
+             * What it does share is the technique. The composable route
+             * (`resize` → `normalize` → `toCHW`) allocates an `RGBImage` and two
+             * `Float32Array`s and walks each end to end on every call: about 1.4 MB of
+             * fresh garbage per 224×224 `predict()`, produced at the exact moment a phone
+             * near its memory ceiling can least afford it. Here one `drawImage` resizes,
+             * and one loop reads the resulting RGBA and writes normalized planar float32
+             * into a buffer held across calls.
+             *
+             * Create one per task, not per frame.
+             */
+            export declare class ResizePipeline {
+                private readonly _targetWidth;
+                private readonly _targetHeight;
+                private readonly _mean;
+                private readonly _std;
+                private readonly _buffer;
+                private _target;
+                private _targetContext;
+                private _source;
+                private _sourceContext;
+                private _bufferInUse;
+                /**
+                 * @param targetWidth Model input width in pixels.
+                 * @param targetHeight Model input height in pixels.
+                 * @param mean Per-channel RGB mean in `[0, 1]`. Defaults to no shift.
+                 * @param std Per-channel RGB standard deviation. Defaults to no scaling.
+                 */
+                constructor(targetWidth: number, targetHeight: number, mean?: readonly [number, number, number], std?: readonly [number, number, number]);
+                /** The `[width, height]` this pipeline resizes into. */
+                get targetSize(): readonly [number, number];
+                /**
+                 * Resize an image to the target size and write it as normalized planar float32.
+                 *
+                 * An image that already arrives at the target size skips the canvas entirely
+                 * and is read straight out of its packed RGB — which is both faster and what
+                 * keeps the result identical to `resize()`, whose own fast path returns the
+                 * input untouched.
+                 *
+                 * @param image Source image in the SDK's canonical HWC RGB layout.
+                 */
+                run(image: RGBImage): FusedResizeResult;
+                /**
+                 * Mark the reusable buffer free again.
+                 *
+                 * Call it once the tensor built from a {@link run} result has been handed to
+                 * ONNX Runtime and the run has resolved — after that the values are inside
+                 * the WASM heap and the buffer can be overwritten.
+                 */
+                release(): void;
+                /**
+                 * Build the target canvas on first use.
+                 *
+                 * Lazily, so a pipeline constructed where no canvas implementation exists
+                 * (a Node test, a worker without OffscreenCanvas) only fails if it is asked
+                 * to resize something.
+                 */
+                private _ensureTarget;
+                /** Grow the scratch source canvas to fit an image, reusing it when possible. */
+                private _ensureSource;
+            }
+
+            /**
+             * Resize an image into normalized planar float32 without keeping any state.
+             *
+             * The allocation-free path is {@link ResizePipeline}; this is the one-shot
+             * form, for a caller who wants the fused behaviour without owning a pipeline.
+             *
+             * @param image Source image in the SDK's canonical HWC RGB layout.
+             * @param targetWidth Model input width in pixels.
+             * @param targetHeight Model input height in pixels.
+             * @param mean Per-channel RGB mean in `[0, 1]`. Defaults to no shift.
+             * @param std Per-channel RGB standard deviation. Defaults to no scaling.
+             */
+            export declare function resizeToTensorData(image: RGBImage, targetWidth: number, targetHeight: number, mean?: readonly [number, number, number], std?: readonly [number, number, number]): FusedResizeResult;
+
             /**
              * Decide the input size a task will preprocess to.
              *
@@ -2054,6 +2173,27 @@ export declare const DEFAULT_PROVIDERS: readonly string[];
                 get session(): OrtSession;
             }
 
+            /**
+             * Write an RGBA buffer as normalized planar float32.
+             *
+             * Shared by {@link ResizePipeline} and exported for a custom pipeline that
+             * already holds pixels and wants the SDK's exact arithmetic.
+             *
+             * The expression is `(value / 255 - mean) / std`, evaluated in that order on
+             * purpose: folding it into a single multiply-add (`value * k + b`) computes the
+             * same quantity but rounds differently, and the tasks' output is asserted to be
+             * bit-identical to the composable `normalize` → `toCHW` path.
+             *
+             * @param rgba Source pixels, 4 bytes per pixel, `width * height` long.
+             * @param width Image width in pixels.
+             * @param height Image height in pixels.
+             * @param mean Per-channel RGB mean, already in `[0, 1]`.
+             * @param std Per-channel RGB standard deviation.
+             * @param out Destination buffer, `3 * width * height` long.
+             * @param stride Bytes per source pixel: 4 for canvas RGBA, 3 for packed RGB.
+             */
+            export declare function writePlanarFloat32(rgba: Uint8ClampedArray | Uint8Array, width: number, height: number, mean: readonly [number, number, number], std: readonly [number, number, number], out: Float32Array, stride?: number): void;
+
             /**
              * Build a zero-filled CHW tensor payload for a warm-up run.
              *

package/dist/vision.js

@@ -11,16 +11,16 @@ import { OrtSession as N } from "./vision/core/session.js";
 import { loadImage as P } from "./vision/io/image.js";
 import { FUSION_KIND_DETECT_CLASSIFY as F, INPUT_IMAGE as I, INPUT_PAD as L, INPUT_SCALE as R, INPUT_SOURCE as z, METADATA_PREFIX as B, OUTPUT_BOXES as V, OUTPUT_CLASSES as H, OUTPUT_NUM_DETECTIONS as U, OUTPUT_PROBS as W, OUTPUT_SCORES as G, readFusionSpec as K } from "./vision/fusion.js";
 import { fromCv2 as q, letterbox as J, normalize as Y, resize as X, toCHW as Z, toCv2 as Q, toFloat32 as $, toFloat32Tensor as ee, toTensor as te } from "./vision/preprocess/image.js";
-import { LetterboxPipeline as ne, letterboxToTensorData as re, zeroTensorData as ie } from "./vision/preprocess/pipeline.js";
-import { softmax as ae, topK as oe } from "./vision/postprocess/classification.js";
-import { batchedNms as se, decodeYolo as ce, decodeYoloAnchors as le, nms as ue } from "./vision/postprocess/detection.js";
-import { decodeYoloSeg as de } from "./vision/postprocess/segmentation.js";
-import { VisionTask as fe, requireDetections as pe } from "./vision/tasks/base.js";
-import { Classifier as me } from "./vision/tasks/classifier.js";
-import { DetectClassify as he } from "./vision/tasks/detectClassify.js";
-import { Detector as ge } from "./vision/tasks/detector.js";
-import { Segmenter as _e } from "./vision/tasks/segmenter.js";
-import { VERSION as ve } from "./vision/index.js";
-import { LUMINANCE_SAMPLE_MAX_EDGE as ye, LowLuminanceError as be, computeImageLuminance as xe, isLuminanceAcceptable as Se } from "./vision/luminance.js";
-import { useLiveLuminance as Ce } from "./vision/use-live-luminance.js";
-export { l as BoundingBox, p as Boxes, b as COCO_CLASSES, m as ClassificationResults, me as Classifier, j as DEFAULT_PROVIDERS, he as DetectClassify, h as DetectClassifyResults, g as DetectionResults, ge as Detector, F as FUSION_KIND_DETECT_CLASSIFY, t as FusionError, I as INPUT_IMAGE, L as INPUT_PAD, R as INPUT_SCALE, z as INPUT_SOURCE, n as ImageLoadError, r as InferenceError, ye as LUMINANCE_SAMPLE_MAX_EDGE, i as LabelMapError, ne as LetterboxPipeline, be as LowLuminanceError, B as METADATA_PREFIX, u as Mask, _ as Masks, a as ModelLoadError, o as NoDetectionsError, V as OUTPUT_BOXES, H as OUTPUT_CLASSES, U as OUTPUT_NUM_DETECTIONS, W as OUTPUT_PROBS, G as OUTPUT_SCORES, N as OrtSession, s as OrtVisionError, v as Probs, c as ProviderNotAvailableError, d as RGBImage, y as SegmentationResults, _e as Segmenter, f as SpeedTimer, ve as VERSION, fe as VisionTask, se as batchedNms, C as classificationNumClasses, xe as computeImageLuminance, w as declaredShapesFrom, ce as decodeYolo, le as decodeYoloAnchors, de as decodeYoloSeg, x as defaultLabels, T as detectionNumClasses, q as fromCv2, Se as isLuminanceAcceptable, J as letterbox, re as letterboxToTensorData, P as loadImage, O as modelNames, ue as nms, Y as normalize, k as parseNames, K as readFusionSpec, A as readModelMetadata, pe as requireDetections, X as resize, E as resolveInputSize, S as resolveLabels, M as resolveProviders, ae as softmax, D as spatialInputSize, Z as toCHW, Q as toCv2, $ as toFloat32, ee as toFloat32Tensor, te as toTensor, oe as topK, e as useCameraStream, Ce as useLiveLuminance, ie as zeroTensorData };
+import { LetterboxPipeline as ne, ResizePipeline as re, letterboxToTensorData as ie, resizeToTensorData as ae, writePlanarFloat32 as oe, zeroTensorData as se } from "./vision/preprocess/pipeline.js";
+import { softmax as ce, topK as le } from "./vision/postprocess/classification.js";
+import { batchedNms as ue, decodeYolo as de, decodeYoloAnchors as fe, nms as pe } from "./vision/postprocess/detection.js";
+import { decodeYoloSeg as me } from "./vision/postprocess/segmentation.js";
+import { VisionTask as he, requireDetections as ge } from "./vision/tasks/base.js";
+import { Classifier as _e } from "./vision/tasks/classifier.js";
+import { DetectClassify as ve } from "./vision/tasks/detectClassify.js";
+import { Detector as ye } from "./vision/tasks/detector.js";
+import { Segmenter as be } from "./vision/tasks/segmenter.js";
+import { VERSION as xe } from "./vision/index.js";
+import { LUMINANCE_SAMPLE_MAX_EDGE as Se, LowLuminanceError as Ce, computeImageLuminance as we, isLuminanceAcceptable as Te } from "./vision/luminance.js";
+import { useLiveLuminance as Ee } from "./vision/use-live-luminance.js";
+export { l as BoundingBox, p as Boxes, b as COCO_CLASSES, m as ClassificationResults, _e as Classifier, j as DEFAULT_PROVIDERS, ve as DetectClassify, h as DetectClassifyResults, g as DetectionResults, ye as Detector, F as FUSION_KIND_DETECT_CLASSIFY, t as FusionError, I as INPUT_IMAGE, L as INPUT_PAD, R as INPUT_SCALE, z as INPUT_SOURCE, n as ImageLoadError, r as InferenceError, Se as LUMINANCE_SAMPLE_MAX_EDGE, i as LabelMapError, ne as LetterboxPipeline, Ce as LowLuminanceError, B as METADATA_PREFIX, u as Mask, _ as Masks, a as ModelLoadError, o as NoDetectionsError, V as OUTPUT_BOXES, H as OUTPUT_CLASSES, U as OUTPUT_NUM_DETECTIONS, W as OUTPUT_PROBS, G as OUTPUT_SCORES, N as OrtSession, s as OrtVisionError, v as Probs, c as ProviderNotAvailableError, d as RGBImage, re as ResizePipeline, y as SegmentationResults, be as Segmenter, f as SpeedTimer, xe as VERSION, he as VisionTask, ue as batchedNms, C as classificationNumClasses, we as computeImageLuminance, w as declaredShapesFrom, de as decodeYolo, fe as decodeYoloAnchors, me as decodeYoloSeg, x as defaultLabels, T as detectionNumClasses, q as fromCv2, Te as isLuminanceAcceptable, J as letterbox, ie as letterboxToTensorData, P as loadImage, O as modelNames, pe as nms, Y as normalize, k as parseNames, K as readFusionSpec, A as readModelMetadata, ge as requireDetections, X as resize, ae as resizeToTensorData, E as resolveInputSize, S as resolveLabels, M as resolveProviders, ce as softmax, D as spatialInputSize, Z as toCHW, Q as toCv2, $ as toFloat32, ee as toFloat32Tensor, te as toTensor, le as topK, e as useCameraStream, Ee as useLiveLuminance, oe as writePlanarFloat32, se as zeroTensorData };

package/dist/vite.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./vite/tempest-icons.cjs"),t=require("./vite/create-vite-config.cjs"),n=require("./vite/tempest-pwa-manifest.cjs"),r=require("./vite/tempest-pwa-icons.cjs"),i=require("./vite/tempest-pwa-dev-sw.cjs");exports.TEMPEST_ICONS_ID=e.TEMPEST_ICONS_ID,exports.buildIconsModule=e.buildIconsModule,exports.createViteConfig=t.createViteConfig,exports.scanIconSlugs=e.scanIconSlugs,exports.tempestIcons=e.tempestIcons,exports.tempestPwaDevSw=i.tempestPwaDevSw,exports.tempestPwaIcons=r.tempestPwaIcons,exports.tempestPwaManifest=n.tempestPwaManifest;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./vite/tempest-icons.cjs"),t=require("./vite/create-vite-config.cjs"),n=require("./vite/tempest-pwa-manifest.cjs"),r=require("./vite/tempest-pwa-icons.cjs"),i=require("./vite/tempest-pwa-dev-sw.cjs");exports.createViteConfig=t.createViteConfig,exports.tempestIcons=e.tempestIcons,exports.tempestPwaDevSw=i.tempestPwaDevSw,exports.tempestPwaIcons=r.tempestPwaIcons,exports.tempestPwaManifest=n.tempestPwaManifest;

package/dist/vite.d.ts

@@ -8,19 +8,6 @@ export declare interface AppleSplashSpec {
     ratio: number;
 }
 
-/**
- * Build the virtual module source for a set of slugs.
- *
- * Aliases resolve to their canonical slug before importing, because only the
- * canonical name is a real lucide export — but the alias key still points at the
- * component, so `<Icon name="alert-circle" />` stays a zero-request lookup.
- *
- * @param slugs - Validated slugs to include.
- * @param aliases - Alias slug → canonical slug.
- * @returns ES module source.
- */
-export declare function buildIconsModule(slugs: readonly string[], aliases: Record<string, string>): string;
-
 /**
  * Build a Tempest-flavored Vite config for a React app: the `@vitejs/plugin-react`
  * plugin, the `@` → `src` import alias, and sane dev-server defaults — so a
@@ -82,18 +69,6 @@ export declare interface CreateViteConfigOptions {
  */
 export declare type ProxyEntry = string | Record<string, unknown>;
 
-/**
- * Collect the icon slugs a source file references literally.
- *
- * @param code - File contents.
- * @param known - The set of real lucide slugs, aliases included.
- * @returns The slugs found, validated against `known`.
- */
-export declare function scanIconSlugs(code: string, known: ReadonlySet<string>): string[];
-
-/** The module id an app imports to get its static registry. */
-export declare const TEMPEST_ICONS_ID = "virtual:tempest-icons";
-
 /**
  * Generate a static icon registry from the slugs your source mentions.
  *

package/dist/vite.js

@@ -1,6 +1,6 @@
-import { TEMPEST_ICONS_ID as e, buildIconsModule as t, scanIconSlugs as n, tempestIcons as r } from "./vite/tempest-icons.js";
-import { createViteConfig as i } from "./vite/create-vite-config.js";
-import { tempestPwaManifest as a } from "./vite/tempest-pwa-manifest.js";
-import { tempestPwaIcons as o } from "./vite/tempest-pwa-icons.js";
-import { tempestPwaDevSw as s } from "./vite/tempest-pwa-dev-sw.js";
-export { e as TEMPEST_ICONS_ID, t as buildIconsModule, i as createViteConfig, n as scanIconSlugs, r as tempestIcons, s as tempestPwaDevSw, o as tempestPwaIcons, a as tempestPwaManifest };
+import { tempestIcons as e } from "./vite/tempest-icons.js";
+import { createViteConfig as t } from "./vite/create-vite-config.js";
+import { tempestPwaManifest as n } from "./vite/tempest-pwa-manifest.js";
+import { tempestPwaIcons as r } from "./vite/tempest-pwa-icons.js";
+import { tempestPwaDevSw as i } from "./vite/tempest-pwa-dev-sw.js";
+export { t as createViteConfig, e as tempestIcons, i as tempestPwaDevSw, r as tempestPwaIcons, n as tempestPwaManifest };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tempest-react-sdk",
-  "version": "0.40.0",
+  "version": "0.42.0",
   "description": "SDK público da Tempest com componentes, hooks e integrações para projetos React.",
   "type": "module",
   "license": "MIT",
@@ -136,7 +136,7 @@
     "@tanstack/react-query": "^5.0.0",
     "dexie": "^4.4.2",
     "fflate": "^0.8.3",
-    "lucide-react": "^1.26.0",
+    "lucide-react": "^1.31.0",
     "react-hook-form": "^7.76.0",
     "react-router": "^8.3.0",
     "zod": "^3.23.0 || ^4.0.0",
@@ -203,10 +203,10 @@
     "fake-indexeddb": "^6.2.5",
     "globals": "^17.7.0",
     "husky": "^9.1.7",
-    "jsdom": "^29.1.1",
+    "jsdom": "^30.0.1",
     "jsqr": "^1.4.0",
     "lint-staged": "^17.0.5",
-    "lucide-react": "^1.26.0",
+    "lucide-react": "^1.31.0",
     "onnxruntime-web": "^1.27.0",
     "prettier": "^3.8.3",
     "react": "^19.1.0",
@@ -226,6 +226,6 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=20.19"
+    "node": ">=22.12"
   }
 }