tempest-react-sdk 0.78.0 → 0.79.0

package/dist/vision/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../src/vision/types.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\n * Public output types returned by the SDK's vision tasks.\n *\n * These types form the contract between the SDK and its callers. They mirror\n * the Python `ort-vision-sdk` output dataclasses 1-to-1.\n *\n * Naming is intentionally compatible with the Ultralytics / torchvision idiom\n * (`cls`, `conf`, `box`, `xyxy`, `xywh`, normalized variants) so code ported\n * from those projects keeps working with minimal edits. The original verbose\n * names (`classId`, `className`, `confidence`, `bbox`) are still populated for\n * backwards compatibility.\n */\n\nimport { ImageLoadError } from \"./core/exceptions\";\n\n/**\n * HWC RGB uint8 image — the canonical image format used across the SDK.\n *\n * `data.length` must equal `width * height * 3`. The buffer is laid out row\n * by row, top-to-bottom, with each pixel as `[R, G, B]`.\n *\n * The pixels can also be produced on first read — see {@link RGBImage.deferred}.\n * Reading `data` is the same either way.\n */\nexport class RGBImage {\n    private _data: Uint8Array | null;\n    private _materialize: (() => Uint8Array) | null = null;\n\n    constructor(\n        data: Uint8Array,\n        public readonly width: number,\n        public readonly height: number,\n    ) {\n        RGBImage._check(data, width, height);\n        this._data = data;\n    }\n\n    /**\n     * An image whose pixels are computed the first time `data` is read.\n     *\n     * Used by the decoder for frames it can hand to preprocessing without\n     * reading back: a 1080p `getImageData` plus the RGBA→RGB copy is most of\n     * the `load` stage (9.4 ms vs 1.9 ms for the GPU-side copy, measured in\n     * Chromium), and a camera loop that only reads boxes never needs it.\n     *\n     * @param width Width in pixels.\n     * @param height Height in pixels.\n     * @param materialize Produces the `width * height * 3` buffer; called at most\n     *   once, and must keep returning the pixels of the moment the image was\n     *   made — snapshot whatever it reads from.\n     * @returns The image. Built without the constructor, which would need the\n     *   very buffer this defers.\n     */\n    static deferred(width: number, height: number, materialize: () => Uint8Array): RGBImage {\n        const image = Object.create(RGBImage.prototype) as RGBImage;\n        Object.assign(image, { width, height, _data: null, _materialize: materialize });\n        return image;\n    }\n\n    /**\n     * The HWC RGB pixels, materialized on first read for a deferred image.\n     *\n     * @throws {@link ImageLoadError} if a deferred image's buffer has the wrong length.\n     */\n    get data(): Uint8Array {\n        if (this._data === null) {\n            const data = (this._materialize as () => Uint8Array)();\n            RGBImage._check(data, this.width, this.height);\n            this._data = data;\n            this._materialize = null;\n        }\n        return this._data;\n    }\n\n    /**\n     * Validate a buffer's length against the image size.\n     *\n     * @param data The pixels.\n     * @param width Width in pixels.\n     * @param height Height in pixels.\n     * @throws {@link ImageLoadError} if `data.length !== width * height * 3`.\n     */\n    private static _check(data: Uint8Array, width: number, height: number): void {\n        if (data.length !== width * height * 3) {\n            throw new ImageLoadError(\n                `RGBImage data length ${data.length} does not match width * height * 3 = ${\n                    width * height * 3\n                }.`,\n            );\n        }\n    }\n}\n\n/**\n * Axis-aligned bounding box in absolute pixel coordinates (xyxy format).\n *\n * Coordinates refer to the original input image (before any internal resize),\n * so callers can map detections back onto their source image without any\n * additional bookkeeping.\n */\nexport class BoundingBox {\n    constructor(\n        public readonly x1: number,\n        public readonly y1: number,\n        public readonly x2: number,\n        public readonly y2: number,\n    ) {}\n\n    /** Box width in pixels (clamped to non-negative). */\n    get width(): number {\n        return Math.max(0, this.x2 - this.x1);\n    }\n\n    /** Box height in pixels (clamped to non-negative). */\n    get height(): number {\n        return Math.max(0, this.y2 - this.y1);\n    }\n\n    /** Box area in pixels squared. */\n    get area(): number {\n        return this.width * this.height;\n    }\n\n    /** The box as `[x1, y1, x2, y2]` in absolute pixels (Ultralytics-style). */\n    get xyxy(): readonly [number, number, number, number] {\n        return [this.x1, this.y1, this.x2, this.y2];\n    }\n\n    /**\n     * The box as `[cx, cy, w, h]` with `(cx, cy)` at the center.\n     *\n     * Matches Ultralytics' `boxes.xywh` and YOLO's native head format. For the\n     * top-left `[x, y, w, h]` convention, use {@link asXywh}.\n     */\n    get xywh(): readonly [number, number, number, number] {\n        return [(this.x1 + this.x2) / 2, (this.y1 + this.y2) / 2, this.width, this.height];\n    }\n\n    /**\n     * The box as `[x1, y1, x2, y2]` normalized to `[0, 1]`.\n     *\n     * @param origShape `[height, width]` of the source image, in pixels.\n     */\n    xyxyn(origShape: readonly [number, number]): readonly [number, number, number, number] {\n        const [h, w] = origShape;\n        if (w <= 0 || h <= 0) return [0, 0, 0, 0];\n        return [this.x1 / w, this.y1 / h, this.x2 / w, this.y2 / h];\n    }\n\n    /**\n     * The box as `[cx, cy, w, h]` normalized to `[0, 1]`.\n     *\n     * @param origShape `[height, width]` of the source image, in pixels.\n     */\n    xywhn(origShape: readonly [number, number]): readonly [number, number, number, number] {\n        const [h, w] = origShape;\n        if (w <= 0 || h <= 0) return [0, 0, 0, 0];\n        const [cx, cy, bw, bh] = this.xywh;\n        return [cx / w, cy / h, bw / w, bh / h];\n    }\n\n    /** Returns `[x1, y1, x2, y2]`. */\n    asXyxy(): readonly [number, number, number, number] {\n        return [this.x1, this.y1, this.x2, this.y2];\n    }\n\n    /**\n     * Returns `[x, y, width, height]` with `(x, y)` at the **top-left**.\n     *\n     * Note: this is the top-left convention. Ultralytics' `xywh` getter uses\n     * **center** coordinates — for that, read {@link xywh}.\n     */\n    asXywh(): readonly [number, number, number, number] {\n        return [this.x1, this.y1, this.width, this.height];\n    }\n\n    /** Returns `[x1, y1, x2, y2]` truncated to integers, useful for slicing arrays. */\n    asIntXyxy(): readonly [number, number, number, number] {\n        return [Math.trunc(this.x1), Math.trunc(this.y1), Math.trunc(this.x2), Math.trunc(this.y2)];\n    }\n}\n\n/**\n * Probability assigned to a single class for a classification prediction.\n *\n * `cls` / `name` / `conf` are Ultralytics-style aliases populated alongside\n * the verbose `classId` / `className` / `probability` fields.\n */\nexport interface ClassProbability {\n    readonly classId: number;\n    readonly className: string;\n    readonly probability: number;\n    /** Alias for `classId` (Ultralytics-style). */\n    readonly cls: number;\n    /** Alias for `className`. */\n    readonly name: string;\n    /** Alias for `probability` (Ultralytics-style). */\n    readonly conf: number;\n}\n\n/**\n * Output of an image classification inference.\n */\nexport interface ClassificationResult {\n    readonly classId: number;\n    readonly className: string;\n    readonly confidence: number;\n    /** Alias for `classId` (Ultralytics-style). */\n    readonly cls: number;\n    /** Alias for `className`. */\n    readonly name: string;\n    /** Alias for `confidence` (Ultralytics-style). */\n    readonly conf: number;\n    /** The original input image as an HWC RGB uint8 array. */\n    readonly image: RGBImage;\n    /**\n     * Probabilities per class, sorted in descending order. The first entry\n     * mirrors `classId`, `className`, and `confidence`. When `topK` was passed\n     * to `predict`, the array is truncated to that length.\n     */\n    readonly probabilities: readonly ClassProbability[];\n}\n\n/**\n * Single detected object produced by an object-detection model.\n */\nexport interface DetectionResult {\n    readonly classId: number;\n    readonly className: string;\n    readonly confidence: number;\n    readonly bbox: BoundingBox;\n    /** Alias for `classId` (Ultralytics-style). */\n    readonly cls: number;\n    /** Alias for `className`. */\n    readonly name: string;\n    /** Alias for `confidence` (Ultralytics-style). */\n    readonly conf: number;\n    /** Alias for `bbox` (Ultralytics-style). */\n    readonly box: BoundingBox;\n    /**\n     * The original image cropped to `bbox`, HWC RGB uint8. Empty boxes\n     * (zero area) yield a zero-sized `RGBImage`.\n     */\n    readonly croppedImage: RGBImage;\n    /**\n     * What a second, classification stage predicted **for this crop** —\n     * populated only by {@link DetectClassify}, and `null` for a plain detector.\n     *\n     * Kept as its own field rather than folded into `classId`/`className`\n     * because the two answers are different questions: the detector says *what\n     * kind of object this is*, the classifier says *which sub-category the object\n     * belongs to*, and collapsing them would lose one of the two.\n     */\n    readonly classification?: ClassificationResult | null;\n    /**\n     * Binary foreground mask for this object, shaped to `bbox` in original-image\n     * pixels — the same contract {@link SegmentationResult.mask} uses.\n     *\n     * Populated only by a `detect_segment_classify` pipeline, where a\n     * segmentation stage ran inside the crop. `null` everywhere else.\n     */\n    readonly mask?: Mask | null;\n}\n\n/**\n * Single-channel binary or grayscale mask, laid out row-major.\n *\n * `data.length` must equal `width * height`. For binary masks, values are\n * `0` (background) or `255` (foreground); soft masks may use the full\n * `[0, 255]` range.\n */\nexport class Mask {\n    constructor(\n        public readonly data: Uint8Array,\n        public readonly width: number,\n        public readonly height: number,\n    ) {\n        if (data.length !== width * height) {\n            throw new ImageLoadError(\n                `Mask data length ${data.length} does not match width * height = ${\n                    width * height\n                }.`,\n            );\n        }\n    }\n}\n\n/**\n * Single segmented instance produced by an instance-segmentation model.\n *\n * Mirrors {@link DetectionResult} and adds the per-instance binary mask\n * plus a \"ready-to-display\" background-removed crop.\n */\nexport interface SegmentationResult {\n    readonly classId: number;\n    readonly className: string;\n    readonly confidence: number;\n    readonly bbox: BoundingBox;\n    /** Alias for `classId` (Ultralytics-style). */\n    readonly cls: number;\n    /** Alias for `className`. */\n    readonly name: string;\n    /** Alias for `confidence` (Ultralytics-style). */\n    readonly conf: number;\n    /** Alias for `bbox` (Ultralytics-style). */\n    readonly box: BoundingBox;\n    /**\n     * Binary mask cropped to `bbox`. Values are `0` (background) or `255`\n     * (foreground). Empty boxes yield a zero-sized `Mask`.\n     */\n    readonly mask: Mask;\n    /**\n     * The original image cropped to `bbox` with background pixels (where\n     * `mask.data[i] === 0`) zeroed out. Empty boxes yield a zero-sized\n     * `RGBImage`.\n     */\n    readonly segmentedImage: RGBImage;\n}\n"],"mappings":";;AAyBA,IAAa,IAAb,MAAa,EAAS;CAME;CACA;CANpB;CACA,eAAkD;CAElD,YACI,GACA,GACA,GACF;EAEE,AAJgB,KAAA,QAAA,GACA,KAAA,SAAA,GAEhB,EAAS,OAAO,GAAM,GAAO,CAAM,GACnC,KAAK,QAAQ;CACjB;CAkBA,OAAO,SAAS,GAAe,GAAgB,GAAyC;EACpF,IAAM,IAAQ,OAAO,OAAO,EAAS,SAAS;EAE9C,OADA,OAAO,OAAO,GAAO;GAAE;GAAO;GAAQ,OAAO;GAAM,cAAc;EAAY,CAAC,GACvE;CACX;CAOA,IAAI,OAAmB;EACnB,IAAI,KAAK,UAAU,MAAM;GACrB,IAAM,IAAQ,KAAK,aAAkC;GAGrD,AAFA,EAAS,OAAO,GAAM,KAAK,OAAO,KAAK,MAAM,GAC7C,KAAK,QAAQ,GACb,KAAK,eAAe;EACxB;EACA,OAAO,KAAK;CAChB;CAUA,OAAe,OAAO,GAAkB,GAAe,GAAsB;EACzE,IAAI,EAAK,WAAW,IAAQ,IAAS,GACjC,MAAM,IAAI,EACN,wBAAwB,EAAK,OAAO,uCAChC,IAAQ,IAAS,EACpB,EACL;CAER;AACJ,GASa,IAAb,MAAyB;CAED;CACA;CACA;CACA;CAJpB,YACI,GACA,GACA,GACA,GACF;EADkB,AAHA,KAAA,KAAA,GACA,KAAA,KAAA,GACA,KAAA,KAAA,GACA,KAAA,KAAA;CACjB;CAGH,IAAI,QAAgB;EAChB,OAAO,KAAK,IAAI,GAAG,KAAK,KAAK,KAAK,EAAE;CACxC;CAGA,IAAI,SAAiB;EACjB,OAAO,KAAK,IAAI,GAAG,KAAK,KAAK,KAAK,EAAE;CACxC;CAGA,IAAI,OAAe;EACf,OAAO,KAAK,QAAQ,KAAK;CAC7B;CAGA,IAAI,OAAkD;EAClD,OAAO;GAAC,KAAK;GAAI,KAAK;GAAI,KAAK;GAAI,KAAK;EAAE;CAC9C;CAQA,IAAI,OAAkD;EAClD,OAAO;IAAE,KAAK,KAAK,KAAK,MAAM;IAAI,KAAK,KAAK,KAAK,MAAM;GAAG,KAAK;GAAO,KAAK;EAAM;CACrF;CAOA,MAAM,GAAiF;EACnF,IAAM,CAAC,GAAG,KAAK;EAEf,OADI,KAAK,KAAK,KAAK,IAAU;GAAC;GAAG;GAAG;GAAG;EAAC,IACjC;GAAC,KAAK,KAAK;GAAG,KAAK,KAAK;GAAG,KAAK,KAAK;GAAG,KAAK,KAAK;EAAC;CAC9D;CAOA,MAAM,GAAiF;EACnF,IAAM,CAAC,GAAG,KAAK;EACf,IAAI,KAAK,KAAK,KAAK,GAAG,OAAO;GAAC;GAAG;GAAG;GAAG;EAAC;EACxC,IAAM,CAAC,GAAI,GAAI,GAAI,KAAM,KAAK;EAC9B,OAAO;GAAC,IAAK;GAAG,IAAK;GAAG,IAAK;GAAG,IAAK;EAAC;CAC1C;CAGA,SAAoD;EAChD,OAAO;GAAC,KAAK;GAAI,KAAK;GAAI,KAAK;GAAI,KAAK;EAAE;CAC9C;CAQA,SAAoD;EAChD,OAAO;GAAC,KAAK;GAAI,KAAK;GAAI,KAAK;GAAO,KAAK;EAAM;CACrD;CAGA,YAAuD;EACnD,OAAO;GAAC,KAAK,MAAM,KAAK,EAAE;GAAG,KAAK,MAAM,KAAK,EAAE;GAAG,KAAK,MAAM,KAAK,EAAE;GAAG,KAAK,MAAM,KAAK,EAAE;EAAC;CAC9F;AACJ,GA2Fa,IAAb,MAAkB;CAEM;CACA;CACA;CAHpB,YACI,GACA,GACA,GACF;EACE,IAJgB,KAAA,OAAA,GACA,KAAA,QAAA,GACA,KAAA,SAAA,GAEZ,EAAK,WAAW,IAAQ,GACxB,MAAM,IAAI,EACN,oBAAoB,EAAK,OAAO,mCAC5B,IAAQ,EACX,EACL;CAER;AACJ"}
+{"version":3,"file":"types.js","names":["RGBImage","width","height","data","image","materialize","ImageLoadError","BoundingBox","x1","y1","x2","y2","h","w","origShape","cx","cy","bw","bh","Mask"],"sources":["../../src/vision/types.ts"],"sourcesContent":["/** @generated Vendored from @mauriciobenjamin700/ort-vision-sdk-web. Do not hand-edit — regenerate with `npm run vendor:vision`. */\n/**\n * Public output types returned by the SDK's vision tasks.\n *\n * These types form the contract between the SDK and its callers. They mirror\n * the Python `ort-vision-sdk` output dataclasses 1-to-1.\n *\n * Naming is intentionally compatible with the Ultralytics / torchvision idiom\n * (`cls`, `conf`, `box`, `xyxy`, `xywh`, normalized variants) so code ported\n * from those projects keeps working with minimal edits. The original verbose\n * names (`classId`, `className`, `confidence`, `bbox`) are still populated for\n * backwards compatibility.\n */\n\nimport { ImageLoadError } from \"./core/exceptions\";\n\n/**\n * HWC RGB uint8 image — the canonical image format used across the SDK.\n *\n * `data.length` must equal `width * height * 3`. The buffer is laid out row\n * by row, top-to-bottom, with each pixel as `[R, G, B]`.\n *\n * The pixels can also be produced on first read — see {@link RGBImage.deferred}.\n * Reading `data` is the same either way.\n */\nexport class RGBImage {\n    private _data: Uint8Array | null;\n    private _materialize: (() => Uint8Array) | null = null;\n\n    constructor(\n        data: Uint8Array,\n        public readonly width: number,\n        public readonly height: number,\n    ) {\n        RGBImage._check(data, width, height);\n        this._data = data;\n    }\n\n    /**\n     * An image whose pixels are computed the first time `data` is read.\n     *\n     * Used by the decoder for frames it can hand to preprocessing without\n     * reading back: a 1080p `getImageData` plus the RGBA→RGB copy is most of\n     * the `load` stage (9.4 ms vs 1.9 ms for the GPU-side copy, measured in\n     * Chromium), and a camera loop that only reads boxes never needs it.\n     *\n     * @param width Width in pixels.\n     * @param height Height in pixels.\n     * @param materialize Produces the `width * height * 3` buffer; called at most\n     *   once, and must keep returning the pixels of the moment the image was\n     *   made — snapshot whatever it reads from.\n     * @returns The image. Built without the constructor, which would need the\n     *   very buffer this defers.\n     */\n    static deferred(width: number, height: number, materialize: () => Uint8Array): RGBImage {\n        const image = Object.create(RGBImage.prototype) as RGBImage;\n        Object.assign(image, { width, height, _data: null, _materialize: materialize });\n        return image;\n    }\n\n    /**\n     * The HWC RGB pixels, materialized on first read for a deferred image.\n     *\n     * @throws {@link ImageLoadError} if a deferred image's buffer has the wrong length.\n     */\n    get data(): Uint8Array {\n        if (this._data === null) {\n            const data = (this._materialize as () => Uint8Array)();\n            RGBImage._check(data, this.width, this.height);\n            this._data = data;\n            this._materialize = null;\n        }\n        return this._data;\n    }\n\n    /**\n     * Validate a buffer's length against the image size.\n     *\n     * @param data The pixels.\n     * @param width Width in pixels.\n     * @param height Height in pixels.\n     * @throws {@link ImageLoadError} if `data.length !== width * height * 3`.\n     */\n    private static _check(data: Uint8Array, width: number, height: number): void {\n        if (data.length !== width * height * 3) {\n            throw new ImageLoadError(\n                `RGBImage data length ${data.length} does not match width * height * 3 = ${\n                    width * height * 3\n                }.`,\n            );\n        }\n    }\n}\n\n/**\n * Axis-aligned bounding box in absolute pixel coordinates (xyxy format).\n *\n * Coordinates refer to the original input image (before any internal resize),\n * so callers can map detections back onto their source image without any\n * additional bookkeeping.\n */\nexport class BoundingBox {\n    constructor(\n        public readonly x1: number,\n        public readonly y1: number,\n        public readonly x2: number,\n        public readonly y2: number,\n    ) {}\n\n    /** Box width in pixels (clamped to non-negative). */\n    get width(): number {\n        return Math.max(0, this.x2 - this.x1);\n    }\n\n    /** Box height in pixels (clamped to non-negative). */\n    get height(): number {\n        return Math.max(0, this.y2 - this.y1);\n    }\n\n    /** Box area in pixels squared. */\n    get area(): number {\n        return this.width * this.height;\n    }\n\n    /** The box as `[x1, y1, x2, y2]` in absolute pixels (Ultralytics-style). */\n    get xyxy(): readonly [number, number, number, number] {\n        return [this.x1, this.y1, this.x2, this.y2];\n    }\n\n    /**\n     * The box as `[cx, cy, w, h]` with `(cx, cy)` at the center.\n     *\n     * Matches Ultralytics' `boxes.xywh` and YOLO's native head format. For the\n     * top-left `[x, y, w, h]` convention, use {@link asXywh}.\n     */\n    get xywh(): readonly [number, number, number, number] {\n        return [(this.x1 + this.x2) / 2, (this.y1 + this.y2) / 2, this.width, this.height];\n    }\n\n    /**\n     * The box as `[x1, y1, x2, y2]` normalized to `[0, 1]`.\n     *\n     * @param origShape `[height, width]` of the source image, in pixels.\n     */\n    xyxyn(origShape: readonly [number, number]): readonly [number, number, number, number] {\n        const [h, w] = origShape;\n        if (w <= 0 || h <= 0) return [0, 0, 0, 0];\n        return [this.x1 / w, this.y1 / h, this.x2 / w, this.y2 / h];\n    }\n\n    /**\n     * The box as `[cx, cy, w, h]` normalized to `[0, 1]`.\n     *\n     * @param origShape `[height, width]` of the source image, in pixels.\n     */\n    xywhn(origShape: readonly [number, number]): readonly [number, number, number, number] {\n        const [h, w] = origShape;\n        if (w <= 0 || h <= 0) return [0, 0, 0, 0];\n        const [cx, cy, bw, bh] = this.xywh;\n        return [cx / w, cy / h, bw / w, bh / h];\n    }\n\n    /** Returns `[x1, y1, x2, y2]`. */\n    asXyxy(): readonly [number, number, number, number] {\n        return [this.x1, this.y1, this.x2, this.y2];\n    }\n\n    /**\n     * Returns `[x, y, width, height]` with `(x, y)` at the **top-left**.\n     *\n     * Note: this is the top-left convention. Ultralytics' `xywh` getter uses\n     * **center** coordinates — for that, read {@link xywh}.\n     */\n    asXywh(): readonly [number, number, number, number] {\n        return [this.x1, this.y1, this.width, this.height];\n    }\n\n    /** Returns `[x1, y1, x2, y2]` truncated to integers, useful for slicing arrays. */\n    asIntXyxy(): readonly [number, number, number, number] {\n        return [Math.trunc(this.x1), Math.trunc(this.y1), Math.trunc(this.x2), Math.trunc(this.y2)];\n    }\n}\n\n/**\n * Probability assigned to a single class for a classification prediction.\n *\n * `cls` / `name` / `conf` are Ultralytics-style aliases populated alongside\n * the verbose `classId` / `className` / `probability` fields.\n */\nexport interface ClassProbability {\n    readonly classId: number;\n    readonly className: string;\n    readonly probability: number;\n    /** Alias for `classId` (Ultralytics-style). */\n    readonly cls: number;\n    /** Alias for `className`. */\n    readonly name: string;\n    /** Alias for `probability` (Ultralytics-style). */\n    readonly conf: number;\n}\n\n/**\n * Output of an image classification inference.\n */\nexport interface ClassificationResult {\n    readonly classId: number;\n    readonly className: string;\n    readonly confidence: number;\n    /** Alias for `classId` (Ultralytics-style). */\n    readonly cls: number;\n    /** Alias for `className`. */\n    readonly name: string;\n    /** Alias for `confidence` (Ultralytics-style). */\n    readonly conf: number;\n    /** The original input image as an HWC RGB uint8 array. */\n    readonly image: RGBImage;\n    /**\n     * Probabilities per class, sorted in descending order. The first entry\n     * mirrors `classId`, `className`, and `confidence`. When `topK` was passed\n     * to `predict`, the array is truncated to that length.\n     */\n    readonly probabilities: readonly ClassProbability[];\n}\n\n/**\n * Single detected object produced by an object-detection model.\n */\nexport interface DetectionResult {\n    readonly classId: number;\n    readonly className: string;\n    readonly confidence: number;\n    readonly bbox: BoundingBox;\n    /** Alias for `classId` (Ultralytics-style). */\n    readonly cls: number;\n    /** Alias for `className`. */\n    readonly name: string;\n    /** Alias for `confidence` (Ultralytics-style). */\n    readonly conf: number;\n    /** Alias for `bbox` (Ultralytics-style). */\n    readonly box: BoundingBox;\n    /**\n     * The original image cropped to `bbox`, HWC RGB uint8. Empty boxes\n     * (zero area) yield a zero-sized `RGBImage`.\n     */\n    readonly croppedImage: RGBImage;\n    /**\n     * What a second, classification stage predicted **for this crop** —\n     * populated only by {@link DetectClassify}, and `null` for a plain detector.\n     *\n     * Kept as its own field rather than folded into `classId`/`className`\n     * because the two answers are different questions: the detector says *what\n     * kind of object this is*, the classifier says *which sub-category the object\n     * belongs to*, and collapsing them would lose one of the two.\n     */\n    readonly classification?: ClassificationResult | null;\n    /**\n     * Binary foreground mask for this object, shaped to `bbox` in original-image\n     * pixels — the same contract {@link SegmentationResult.mask} uses.\n     *\n     * Populated only by a `detect_segment_classify` pipeline, where a\n     * segmentation stage ran inside the crop. `null` everywhere else.\n     */\n    readonly mask?: Mask | null;\n}\n\n/**\n * Single-channel binary or grayscale mask, laid out row-major.\n *\n * `data.length` must equal `width * height`. For binary masks, values are\n * `0` (background) or `255` (foreground); soft masks may use the full\n * `[0, 255]` range.\n */\nexport class Mask {\n    constructor(\n        public readonly data: Uint8Array,\n        public readonly width: number,\n        public readonly height: number,\n    ) {\n        if (data.length !== width * height) {\n            throw new ImageLoadError(\n                `Mask data length ${data.length} does not match width * height = ${\n                    width * height\n                }.`,\n            );\n        }\n    }\n}\n\n/**\n * Single segmented instance produced by an instance-segmentation model.\n *\n * Mirrors {@link DetectionResult} and adds the per-instance binary mask\n * plus a \"ready-to-display\" background-removed crop.\n */\nexport interface SegmentationResult {\n    readonly classId: number;\n    readonly className: string;\n    readonly confidence: number;\n    readonly bbox: BoundingBox;\n    /** Alias for `classId` (Ultralytics-style). */\n    readonly cls: number;\n    /** Alias for `className`. */\n    readonly name: string;\n    /** Alias for `confidence` (Ultralytics-style). */\n    readonly conf: number;\n    /** Alias for `bbox` (Ultralytics-style). */\n    readonly box: BoundingBox;\n    /**\n     * Binary mask cropped to `bbox`. Values are `0` (background) or `255`\n     * (foreground). Empty boxes yield a zero-sized `Mask`.\n     */\n    readonly mask: Mask;\n    /**\n     * The original image cropped to `bbox` with background pixels (where\n     * `mask.data[i] === 0`) zeroed out. Empty boxes yield a zero-sized\n     * `RGBImage`.\n     */\n    readonly segmentedImage: RGBImage;\n}\n"],"mappings":";;AAyBA,IAAaA,IAAb,MAAaA,EAAS;CAME;CACA;CANpB;CACA,eAAkD;CAElD,YACI,GACA,GACA,GACF;EAEE,AAJgB,KAAA,QAAAC,GACA,KAAA,SAAAC,GAEhBF,EAAS,OAAOG,GAAMF,GAAOC,CAAM,GACnC,KAAK,QAAQC;CACjB;CAkBA,OAAO,SAAS,GAAe,GAAgB,GAAyC;EACpF,IAAMC,IAAQ,OAAO,OAAOJ,EAAS,SAAS;EAE9C,OADA,OAAO,OAAOI,GAAO;GAAE;GAAO;GAAQ,OAAO;GAAM,cAAcC;EAAY,CAAC,GACvED;CACX;CAOA,IAAI,OAAmB;EACnB,IAAI,KAAK,UAAU,MAAM;GACrB,IAAMD,IAAQ,KAAK,aAAkC;GAGrD,AAFAH,EAAS,OAAOG,GAAM,KAAK,OAAO,KAAK,MAAM,GAC7C,KAAK,QAAQA,GACb,KAAK,eAAe;EACxB;EACA,OAAO,KAAK;CAChB;CAUA,OAAe,OAAO,GAAkB,GAAe,GAAsB;EACzE,IAAIA,EAAK,WAAWF,IAAQC,IAAS,GACjC,MAAM,IAAII,EACN,wBAAwBH,EAAK,OAAO,uCAChCF,IAAQC,IAAS,EACpB,EACL;CAER;AACJ,GASaK,IAAb,MAAyB;CAED;CACA;CACA;CACA;CAJpB,YACI,GACA,GACA,GACA,GACF;EADkB,AAHA,KAAA,KAAAC,GACA,KAAA,KAAAC,GACA,KAAA,KAAAC,GACA,KAAA,KAAAC;CACjB;CAGH,IAAI,QAAgB;EAChB,OAAO,KAAK,IAAI,GAAG,KAAK,KAAK,KAAK,EAAE;CACxC;CAGA,IAAI,SAAiB;EACjB,OAAO,KAAK,IAAI,GAAG,KAAK,KAAK,KAAK,EAAE;CACxC;CAGA,IAAI,OAAe;EACf,OAAO,KAAK,QAAQ,KAAK;CAC7B;CAGA,IAAI,OAAkD;EAClD,OAAO;GAAC,KAAK;GAAI,KAAK;GAAI,KAAK;GAAI,KAAK;EAAE;CAC9C;CAQA,IAAI,OAAkD;EAClD,OAAO;IAAE,KAAK,KAAK,KAAK,MAAM;IAAI,KAAK,KAAK,KAAK,MAAM;GAAG,KAAK;GAAO,KAAK;EAAM;CACrF;CAOA,MAAM,GAAiF;EACnF,IAAM,CAACC,GAAGC,KAAKC;EAEf,OADID,KAAK,KAAKD,KAAK,IAAU;GAAC;GAAG;GAAG;GAAG;EAAC,IACjC;GAAC,KAAK,KAAKC;GAAG,KAAK,KAAKD;GAAG,KAAK,KAAKC;GAAG,KAAK,KAAKD;EAAC;CAC9D;CAOA,MAAM,GAAiF;EACnF,IAAM,CAACA,GAAGC,KAAKC;EACf,IAAID,KAAK,KAAKD,KAAK,GAAG,OAAO;GAAC;GAAG;GAAG;GAAG;EAAC;EACxC,IAAM,CAACG,GAAIC,GAAIC,GAAIC,KAAM,KAAK;EAC9B,OAAO;GAACH,IAAKF;GAAGG,IAAKJ;GAAGK,IAAKJ;GAAGK,IAAKN;EAAC;CAC1C;CAGA,SAAoD;EAChD,OAAO;GAAC,KAAK;GAAI,KAAK;GAAI,KAAK;GAAI,KAAK;EAAE;CAC9C;CAQA,SAAoD;EAChD,OAAO;GAAC,KAAK;GAAI,KAAK;GAAI,KAAK;GAAO,KAAK;EAAM;CACrD;CAGA,YAAuD;EACnD,OAAO;GAAC,KAAK,MAAM,KAAK,EAAE;GAAG,KAAK,MAAM,KAAK,EAAE;GAAG,KAAK,MAAM,KAAK,EAAE;GAAG,KAAK,MAAM,KAAK,EAAE;EAAC;CAC9F;AACJ,GA2FaO,IAAb,MAAkB;CAEM;CACA;CACA;CAHpB,YACI,GACA,GACA,GACF;EACE,IAJgB,KAAA,OAAAhB,GACA,KAAA,QAAAF,GACA,KAAA,SAAAC,GAEZC,EAAK,WAAWF,IAAQC,GACxB,MAAM,IAAII,EACN,oBAAoBH,EAAK,OAAO,mCAC5BF,IAAQC,EACX,EACL;CAER;AACJ"}

package/dist/vision/use-camera-stream.cjs

@@ -1,2 +1,2 @@
-const e=require("../hooks/use-latest-ref.cjs"),t=require("../audio/media-access.cjs");let n=require("react");var r={video:{facingMode:{ideal:`environment`},width:{ideal:1920},height:{ideal:1080}},audio:!1};function i({kind:e,message:t}){return{kind:e===`not-found`?`no-camera`:e,message:t}}function a(e){return i(t.classifyMediaError(e,`camera`))}function o(o={}){let[s,c]=(0,n.useState)(`loading`),[l,u]=(0,n.useState)(null),[d,f]=(0,n.useState)(null),[p,m]=(0,n.useState)(0),h=(0,n.useRef)(null),g=e.useLatestRef(o.constraints??r),_=o.enabled??!0;return(0,n.useEffect)(()=>{let e=!1,n=null,r=null;async function o(){if(!_){c(`idle`),u(null);return}if(c(`loading`),u(null),typeof navigator>`u`||!navigator.mediaDevices||typeof navigator.mediaDevices.getUserMedia!=`function`){e||(u(i(t.missingCaptureApiError(`camera`))),c(`error`));return}try{if(n=await navigator.mediaDevices.getUserMedia(g.current),e){n.getTracks().forEach(e=>e.stop());return}let t=h.current;if(!t){n.getTracks().forEach(e=>e.stop());return}r=t,t.srcObject=n,f(n),await t.play().catch(()=>void 0),e||c(`ready`)}catch(t){e||(u(a(t)),c(`error`))}}return o(),()=>{e=!0,n&&n.getTracks().forEach(e=>e.stop()),r&&(r.srcObject=null),f(null)}},[p,_,g]),{status:s,error:l,videoRef:h,stream:d,retry:()=>m(e=>e+1)}}exports.useCameraStream=o;
+const e=require("../hooks/use-latest-ref.cjs"),t=require("../audio/media-access.cjs");let n=require("react");var r={video:{facingMode:{ideal:`environment`},width:{ideal:1920},height:{ideal:1080}},audio:!1};function i({kind:e,message:t}){return{kind:e===`not-found`?`no-camera`:e,message:t}}function a(e){return i(t.classifyMediaError(e,`camera`))}function o(o={}){let[s,c]=(0,n.useState)(`loading`),[l,u]=(0,n.useState)(null),[d,f]=(0,n.useState)(null),[p,m]=(0,n.useState)(0),h=(0,n.useRef)(null),g=e.useLatestRef(o.constraints??r),_=o.enabled??!0;return(0,n.useEffect)(()=>{let e=!1,n=null,r=null;async function o(){if(!_)c(`idle`),u(null);else if(c(`loading`),u(null),typeof navigator>`u`||!navigator.mediaDevices||typeof navigator.mediaDevices.getUserMedia!=`function`)e||(u(i(t.missingCaptureApiError(`camera`))),c(`error`));else try{if(n=await navigator.mediaDevices.getUserMedia(g.current),e){n.getTracks().forEach(e=>e.stop());return}let t=h.current;if(!t){n.getTracks().forEach(e=>e.stop());return}r=t,t.srcObject=n,f(n),await t.play().catch(()=>void 0),e||c(`ready`)}catch(t){e||(u(a(t)),c(`error`))}}return o(),()=>{e=!0,n&&n.getTracks().forEach(e=>e.stop()),r&&(r.srcObject=null),f(null)}},[p,_,g]),{status:s,error:l,videoRef:h,stream:d,retry:()=>m(e=>e+1)}}exports.useCameraStream=o;
 //# sourceMappingURL=use-camera-stream.cjs.map

package/dist/vision/use-camera-stream.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-camera-stream.cjs","names":[],"sources":["../../src/vision/use-camera-stream.ts"],"sourcesContent":["import { useEffect, useRef, useState, type RefObject } from \"react\";\nimport { useLatestRef } from \"@/hooks/use-latest-ref\";\n\nimport {\n    classifyMediaError,\n    missingCaptureApiError,\n    type MediaAccessError,\n} from \"@/audio/media-access\";\n\n/** Lifecycle status of the camera stream. */\nexport type CameraStreamStatus = \"idle\" | \"loading\" | \"ready\" | \"error\";\n\n/** Classified reason a camera stream could not be acquired. */\nexport type CameraStreamErrorKind =\n    \"unsupported\" | \"permission-denied\" | \"no-camera\" | \"in-use\" | \"insecure\" | \"unknown\";\n\n/** A classified camera error with a human-readable, English message. */\nexport interface CameraStreamError {\n    kind: CameraStreamErrorKind;\n    message: string;\n}\n\n/** Options for {@link useCameraStream}. */\nexport interface UseCameraStreamOptions {\n    /**\n     * Constraints passed to `getUserMedia`. Defaults to the rear\n     * (\"environment\") camera at Full-HD ideal resolution with audio off.\n     * Read when the stream (re)starts — change it and call `retry()` to apply.\n     */\n    constraints?: MediaStreamConstraints;\n    /**\n     * Hold off acquiring the camera until this is `true`. Default `true`.\n     *\n     * The point is to be able to *not* prompt. A permission prompt costs the user a\n     * decision and, if they refuse, costs the app the feature permanently — so a\n     * surface that already knows it cannot do its job (a barcode scanner in a browser\n     * with no decoder) must not open the camera to then say so. Flipping this to `false`\n     * also releases a stream that is already live.\n     */\n    enabled?: boolean;\n}\n\n/** Value returned by {@link useCameraStream}. */\nexport interface UseCameraStreamApi {\n    /** Current lifecycle status. */\n    status: CameraStreamStatus;\n    /** The classified error, or `null` while not in the `error` status. */\n    error: CameraStreamError | null;\n    /** Attach to a `<video ref={…} />`. The stream is wired to it once ready. */\n    videoRef: RefObject<HTMLVideoElement | null>;\n    /**\n     * The live stream, or `null`.\n     *\n     * Exposed for the things that need the **track** rather than the picture — the LED\n     * torch (`useTorch`), the real frame size from `getSettings()`, recording it with\n     * `useVideoRecorder`. Do not stop it yourself: the hook owns its lifetime and\n     * releases it on unmount and on `retry()`.\n     */\n    stream: MediaStream | null;\n    /** Manually re-attempt after an error (e.g. the user changed permissions). */\n    retry: () => void;\n}\n\n/** Rear-camera Full-HD defaults used when no `constraints` are supplied. */\nconst DEFAULT_CONSTRAINTS: MediaStreamConstraints = {\n    video: {\n        facingMode: { ideal: \"environment\" },\n        width: { ideal: 1920 },\n        height: { ideal: 1080 },\n    },\n    audio: false,\n};\n\n/**\n * Re-label a {@link MediaAccessError} as a {@link CameraStreamError}.\n *\n * The classification itself lives in one place for the whole SDK\n * (`classifyMediaError`), so a microphone and a camera failure are never explained\n * two different ways. Only the name of one kind differs: this surface shipped\n * `\"no-camera\"` where the shared taxonomy says `\"not-found\"`, and renaming a\n * published union member would break every consumer switching on it.\n *\n * @param error - The shared classification.\n * @returns The same error under this module's kind names.\n */\nfunction toCameraError({ kind, message }: MediaAccessError): CameraStreamError {\n    return { kind: kind === \"not-found\" ? \"no-camera\" : kind, message };\n}\n\n/**\n * Map an unknown `getUserMedia` failure into a {@link CameraStreamError}. Secure-context\n * and environment checks run first (they are the reason `getUserMedia` is missing or\n * rejects), then the `DOMException.name` is mapped to a stable `kind`.\n */\nfunction classifyError(err: unknown): CameraStreamError {\n    return toCameraError(classifyMediaError(err, \"camera\"));\n}\n\n/**\n * Acquire a `MediaStream` via `getUserMedia`, attach it to a `<video>` element,\n * and expose status/error so the page can render permission and error states.\n * The stream is automatically released on unmount or retry.\n *\n * Defaults to the rear (\"environment\") camera; desktops fall back to whatever\n * single camera they expose. Pass `options.constraints` to override, or\n * `options.enabled: false` to render the surface without prompting for the camera\n * at all.\n *\n * Implementation notes:\n * - Cleanup detaches the stream from a *snapshotted* video node, so it releases\n *   the same element it attached to even if the page remounts the `<video>`.\n * - When `getUserMedia` is missing, an insecure context is the usual cause, so\n *   the hook prefers that (actionable) error; otherwise it reports `unsupported`.\n * - `video.play()` rejections are swallowed: autoplay may be blocked, but the\n *   user gesture that opened the camera usually counts and playback resumes on\n *   the next interaction.\n *\n * @param options - optional configuration (see {@link UseCameraStreamOptions}).\n * @returns The stream status, classified error, a `videoRef` to attach, the live\n *   `stream` for whatever needs the track itself, and a `retry()` to re-attempt\n *   acquisition.\n */\nexport function useCameraStream(options: UseCameraStreamOptions = {}): UseCameraStreamApi {\n    const [status, setStatus] = useState<CameraStreamStatus>(\"loading\");\n    const [error, setError] = useState<CameraStreamError | null>(null);\n    const [live, setLive] = useState<MediaStream | null>(null);\n    const [retryToken, setRetryToken] = useState(0);\n    const videoRef = useRef<HTMLVideoElement | null>(null);\n    const constraintsRef = useLatestRef(options.constraints ?? DEFAULT_CONSTRAINTS);\n\n    const enabled = options.enabled ?? true;\n\n    useEffect(() => {\n        let cancelled = false;\n        let stream: MediaStream | null = null;\n        let attachedVideo: HTMLVideoElement | null = null;\n\n        async function start(): Promise<void> {\n            if (!enabled) {\n                setStatus(\"idle\");\n                setError(null);\n                return;\n            }\n            setStatus(\"loading\");\n            setError(null);\n\n            if (\n                typeof navigator === \"undefined\" ||\n                !navigator.mediaDevices ||\n                typeof navigator.mediaDevices.getUserMedia !== \"function\"\n            ) {\n                if (!cancelled) {\n                    setError(toCameraError(missingCaptureApiError(\"camera\")));\n                    setStatus(\"error\");\n                }\n                return;\n            }\n\n            try {\n                stream = await navigator.mediaDevices.getUserMedia(constraintsRef.current);\n                if (cancelled) {\n                    stream.getTracks().forEach((track) => track.stop());\n                    return;\n                }\n                const video = videoRef.current;\n                if (!video) {\n                    stream.getTracks().forEach((track) => track.stop());\n                    return;\n                }\n                attachedVideo = video;\n                video.srcObject = stream;\n                setLive(stream);\n                await video.play().catch(() => undefined);\n                if (!cancelled) setStatus(\"ready\");\n            } catch (err) {\n                if (!cancelled) {\n                    setError(classifyError(err));\n                    setStatus(\"error\");\n                }\n            }\n        }\n\n        void start();\n\n        return () => {\n            cancelled = true;\n            if (stream) {\n                stream.getTracks().forEach((track) => track.stop());\n            }\n            if (attachedVideo) {\n                attachedVideo.srcObject = null;\n            }\n            setLive(null);\n        };\n    }, [retryToken, enabled, constraintsRef]);\n\n    return {\n        status,\n        error,\n        videoRef,\n        stream: live,\n        retry: () => setRetryToken((n) => n + 1),\n    };\n}\n"],"mappings":"6GAgEA,IAAM,EAA8C,CAChD,MAAO,CACH,WAAY,CAAE,MAAO,aAAc,EACnC,MAAO,CAAE,MAAO,IAAK,EACrB,OAAQ,CAAE,MAAO,IAAK,CAC1B,EACA,MAAO,EACX,EAcA,SAAS,EAAc,CAAE,OAAM,WAAgD,CAC3E,MAAO,CAAE,KAAM,IAAS,YAAc,YAAc,EAAM,SAAQ,CACtE,CAOA,SAAS,EAAc,EAAiC,CACpD,OAAO,EAAc,EAAA,mBAAmB,EAAK,QAAQ,CAAC,CAC1D,CA0BA,SAAgB,EAAgB,EAAkC,CAAC,EAAuB,CACtF,GAAM,CAAC,EAAQ,IAAA,EAAa,EAAA,SAAA,CAA6B,SAAS,EAC5D,CAAC,EAAO,IAAA,EAAY,EAAA,SAAA,CAAmC,IAAI,EAC3D,CAAC,EAAM,IAAA,EAAW,EAAA,SAAA,CAA6B,IAAI,EACnD,CAAC,EAAY,IAAA,EAAiB,EAAA,SAAA,CAAS,CAAC,EACxC,GAAA,EAAW,EAAA,OAAA,CAAgC,IAAI,EAC/C,EAAiB,EAAA,aAAa,EAAQ,aAAe,CAAmB,EAExE,EAAU,EAAQ,SAAW,GAkEnC,OAhEA,EAAA,EAAA,UAAA,KAAgB,CACZ,IAAI,EAAY,GACZ,EAA6B,KAC7B,EAAyC,KAE7C,eAAe,GAAuB,CAClC,GAAI,CAAC,EAAS,CACV,EAAU,MAAM,EAChB,EAAS,IAAI,EACb,MACJ,CAIA,GAHA,EAAU,SAAS,EACnB,EAAS,IAAI,EAGT,OAAO,UAAc,KACrB,CAAC,UAAU,cACX,OAAO,UAAU,aAAa,cAAiB,WACjD,CACO,IACD,EAAS,EAAc,EAAA,uBAAuB,QAAQ,CAAC,CAAC,EACxD,EAAU,OAAO,GAErB,MACJ,CAEA,GAAI,CAEA,GADA,EAAS,MAAM,UAAU,aAAa,aAAa,EAAe,OAAO,EACrE,EAAW,CACX,EAAO,UAAU,CAAC,CAAC,QAAS,GAAU,EAAM,KAAK,CAAC,EAClD,MACJ,CACA,IAAM,EAAQ,EAAS,QACvB,GAAI,CAAC,EAAO,CACR,EAAO,UAAU,CAAC,CAAC,QAAS,GAAU,EAAM,KAAK,CAAC,EAClD,MACJ,CACA,EAAgB,EAChB,EAAM,UAAY,EAClB,EAAQ,CAAM,EACd,MAAM,EAAM,KAAK,CAAC,CAAC,UAAY,IAAA,EAAS,EACnC,GAAW,EAAU,OAAO,CACrC,OAAS,EAAK,CACL,IACD,EAAS,EAAc,CAAG,CAAC,EAC3B,EAAU,OAAO,EAEzB,CACJ,CAIA,OAFA,EAAW,MAEE,CACT,EAAY,GACR,GACA,EAAO,UAAU,CAAC,CAAC,QAAS,GAAU,EAAM,KAAK,CAAC,EAElD,IACA,EAAc,UAAY,MAE9B,EAAQ,IAAI,CAChB,CACJ,EAAG,CAAC,EAAY,EAAS,CAAc,CAAC,EAEjC,CACH,SACA,QACA,WACA,OAAQ,EACR,UAAa,EAAe,GAAM,EAAI,CAAC,CAC3C,CACJ"}
+{"version":3,"file":"use-camera-stream.cjs","names":["classifyMediaError","useState","useRef","useLatestRef","missingCaptureApiError","require_use_latest_ref","require_media_access","react","DEFAULT_CONSTRAINTS","toCameraError","kind","classifyError","err","useCameraStream","status","setStatus","error","setError","live","setLive","retryToken","setRetryToken","videoRef","constraintsRef","options","enabled","cancelled","stream","attachedVideo","start","track","video","n"],"sources":["../../src/vision/use-camera-stream.ts"],"sourcesContent":["import { useEffect, useRef, useState, type RefObject } from \"react\";\nimport { useLatestRef } from \"@/hooks/use-latest-ref\";\n\nimport {\n    classifyMediaError,\n    missingCaptureApiError,\n    type MediaAccessError,\n} from \"@/audio/media-access\";\n\n/** Lifecycle status of the camera stream. */\nexport type CameraStreamStatus = \"idle\" | \"loading\" | \"ready\" | \"error\";\n\n/** Classified reason a camera stream could not be acquired. */\nexport type CameraStreamErrorKind =\n    \"unsupported\" | \"permission-denied\" | \"no-camera\" | \"in-use\" | \"insecure\" | \"unknown\";\n\n/** A classified camera error with a human-readable, English message. */\nexport interface CameraStreamError {\n    kind: CameraStreamErrorKind;\n    message: string;\n}\n\n/** Options for {@link useCameraStream}. */\nexport interface UseCameraStreamOptions {\n    /**\n     * Constraints passed to `getUserMedia`. Defaults to the rear\n     * (\"environment\") camera at Full-HD ideal resolution with audio off.\n     * Read when the stream (re)starts — change it and call `retry()` to apply.\n     */\n    constraints?: MediaStreamConstraints;\n    /**\n     * Hold off acquiring the camera until this is `true`. Default `true`.\n     *\n     * The point is to be able to *not* prompt. A permission prompt costs the user a\n     * decision and, if they refuse, costs the app the feature permanently — so a\n     * surface that already knows it cannot do its job (a barcode scanner in a browser\n     * with no decoder) must not open the camera to then say so. Flipping this to `false`\n     * also releases a stream that is already live.\n     */\n    enabled?: boolean;\n}\n\n/** Value returned by {@link useCameraStream}. */\nexport interface UseCameraStreamApi {\n    /** Current lifecycle status. */\n    status: CameraStreamStatus;\n    /** The classified error, or `null` while not in the `error` status. */\n    error: CameraStreamError | null;\n    /** Attach to a `<video ref={…} />`. The stream is wired to it once ready. */\n    videoRef: RefObject<HTMLVideoElement | null>;\n    /**\n     * The live stream, or `null`.\n     *\n     * Exposed for the things that need the **track** rather than the picture — the LED\n     * torch (`useTorch`), the real frame size from `getSettings()`, recording it with\n     * `useVideoRecorder`. Do not stop it yourself: the hook owns its lifetime and\n     * releases it on unmount and on `retry()`.\n     */\n    stream: MediaStream | null;\n    /** Manually re-attempt after an error (e.g. the user changed permissions). */\n    retry: () => void;\n}\n\n/** Rear-camera Full-HD defaults used when no `constraints` are supplied. */\nconst DEFAULT_CONSTRAINTS: MediaStreamConstraints = {\n    video: {\n        facingMode: { ideal: \"environment\" },\n        width: { ideal: 1920 },\n        height: { ideal: 1080 },\n    },\n    audio: false,\n};\n\n/**\n * Re-label a {@link MediaAccessError} as a {@link CameraStreamError}.\n *\n * The classification itself lives in one place for the whole SDK\n * (`classifyMediaError`), so a microphone and a camera failure are never explained\n * two different ways. Only the name of one kind differs: this surface shipped\n * `\"no-camera\"` where the shared taxonomy says `\"not-found\"`, and renaming a\n * published union member would break every consumer switching on it.\n *\n * @param error - The shared classification.\n * @returns The same error under this module's kind names.\n */\nfunction toCameraError({ kind, message }: MediaAccessError): CameraStreamError {\n    return { kind: kind === \"not-found\" ? \"no-camera\" : kind, message };\n}\n\n/**\n * Map an unknown `getUserMedia` failure into a {@link CameraStreamError}. Secure-context\n * and environment checks run first (they are the reason `getUserMedia` is missing or\n * rejects), then the `DOMException.name` is mapped to a stable `kind`.\n */\nfunction classifyError(err: unknown): CameraStreamError {\n    return toCameraError(classifyMediaError(err, \"camera\"));\n}\n\n/**\n * Acquire a `MediaStream` via `getUserMedia`, attach it to a `<video>` element,\n * and expose status/error so the page can render permission and error states.\n * The stream is automatically released on unmount or retry.\n *\n * Defaults to the rear (\"environment\") camera; desktops fall back to whatever\n * single camera they expose. Pass `options.constraints` to override, or\n * `options.enabled: false` to render the surface without prompting for the camera\n * at all.\n *\n * Implementation notes:\n * - Cleanup detaches the stream from a *snapshotted* video node, so it releases\n *   the same element it attached to even if the page remounts the `<video>`.\n * - When `getUserMedia` is missing, an insecure context is the usual cause, so\n *   the hook prefers that (actionable) error; otherwise it reports `unsupported`.\n * - `video.play()` rejections are swallowed: autoplay may be blocked, but the\n *   user gesture that opened the camera usually counts and playback resumes on\n *   the next interaction.\n *\n * @param options - optional configuration (see {@link UseCameraStreamOptions}).\n * @returns The stream status, classified error, a `videoRef` to attach, the live\n *   `stream` for whatever needs the track itself, and a `retry()` to re-attempt\n *   acquisition.\n */\nexport function useCameraStream(options: UseCameraStreamOptions = {}): UseCameraStreamApi {\n    const [status, setStatus] = useState<CameraStreamStatus>(\"loading\");\n    const [error, setError] = useState<CameraStreamError | null>(null);\n    const [live, setLive] = useState<MediaStream | null>(null);\n    const [retryToken, setRetryToken] = useState(0);\n    const videoRef = useRef<HTMLVideoElement | null>(null);\n    const constraintsRef = useLatestRef(options.constraints ?? DEFAULT_CONSTRAINTS);\n\n    const enabled = options.enabled ?? true;\n\n    useEffect(() => {\n        let cancelled = false;\n        let stream: MediaStream | null = null;\n        let attachedVideo: HTMLVideoElement | null = null;\n\n        async function start(): Promise<void> {\n            if (!enabled) {\n                setStatus(\"idle\");\n                setError(null);\n                return;\n            }\n            setStatus(\"loading\");\n            setError(null);\n\n            if (\n                typeof navigator === \"undefined\" ||\n                !navigator.mediaDevices ||\n                typeof navigator.mediaDevices.getUserMedia !== \"function\"\n            ) {\n                if (!cancelled) {\n                    setError(toCameraError(missingCaptureApiError(\"camera\")));\n                    setStatus(\"error\");\n                }\n                return;\n            }\n\n            try {\n                stream = await navigator.mediaDevices.getUserMedia(constraintsRef.current);\n                if (cancelled) {\n                    stream.getTracks().forEach((track) => track.stop());\n                    return;\n                }\n                const video = videoRef.current;\n                if (!video) {\n                    stream.getTracks().forEach((track) => track.stop());\n                    return;\n                }\n                attachedVideo = video;\n                video.srcObject = stream;\n                setLive(stream);\n                await video.play().catch(() => undefined);\n                if (!cancelled) setStatus(\"ready\");\n            } catch (err) {\n                if (!cancelled) {\n                    setError(classifyError(err));\n                    setStatus(\"error\");\n                }\n            }\n        }\n\n        void start();\n\n        return () => {\n            cancelled = true;\n            if (stream) {\n                stream.getTracks().forEach((track) => track.stop());\n            }\n            if (attachedVideo) {\n                attachedVideo.srcObject = null;\n            }\n            setLive(null);\n        };\n    }, [retryToken, enabled, constraintsRef]);\n\n    return {\n        status,\n        error,\n        videoRef,\n        stream: live,\n        retry: () => setRetryToken((n) => n + 1),\n    };\n}\n"],"mappings":"A,6GAgEA,IAAMQ,EAA8C,CAChD,MAAO,CACH,WAAY,CAAE,MAAO,aAAc,EACnC,MAAO,CAAE,MAAO,IAAK,EACrB,OAAQ,CAAE,MAAO,IAAK,CAC1B,EACA,MAAO,EACX,EAcA,SAASC,EAAc,CAAE,OAAM,WAAgD,CAC3E,MAAO,CAAE,KAAMC,IAAS,YAAc,YAAcA,EAAM,SAAQ,CACtE,CAOA,SAASC,EAAc,EAAiC,CACpD,OAAOF,EAAcT,EAAAA,mBAAmBY,EAAK,QAAQ,CAAC,CAC1D,CA0BA,SAAgBC,EAAgB,EAAkC,CAAC,EAAuB,CACtF,GAAM,CAACC,EAAQC,IAAA,EAAad,EAAAA,SAAAA,CAA6B,SAAS,EAC5D,CAACe,EAAOC,IAAA,EAAYhB,EAAAA,SAAAA,CAAmC,IAAI,EAC3D,CAACiB,EAAMC,IAAA,EAAWlB,EAAAA,SAAAA,CAA6B,IAAI,EACnD,CAACmB,EAAYC,IAAA,EAAiBpB,EAAAA,SAAAA,CAAS,CAAC,EACxCqB,GAAA,EAAWpB,EAAAA,OAAAA,CAAgC,IAAI,EAC/CqB,EAAiBpB,EAAAA,aAAaqB,EAAQ,aAAehB,CAAmB,EAExEiB,EAAUD,EAAQ,SAAW,GAkEnC,OAhEA,EAAAjB,EAAA,UAAA,KAAgB,CACZ,IAAImB,EAAY,GACZC,EAA6B,KAC7BC,EAAyC,KAE7C,eAAeC,GAAuB,CAClC,GAAI,CAACJ,EACDV,EAAU,MAAM,EAChBE,EAAS,IAAI,OAMjB,GAHAF,EAAU,SAAS,EACnBE,EAAS,IAAI,EAGT,OAAO,UAAc,KACrB,CAAC,UAAU,cACX,OAAO,UAAU,aAAa,cAAiB,WAE1CS,IACDT,EAASR,EAAcL,EAAAA,uBAAuB,QAAQ,CAAC,CAAC,EACxDW,EAAU,OAAO,QAKzB,GAAI,CAEA,GADA,EAAS,MAAM,UAAU,aAAa,aAAaQ,EAAe,OAAO,EACrEG,EAAW,CACXC,EAAO,UAAU,CAAC,CAAC,QAAS,GAAUG,EAAM,KAAK,CAAC,EAClD,MACJ,CACA,IAAMC,EAAQT,EAAS,QACvB,GAAI,CAACS,EAAO,CACRJ,EAAO,UAAU,CAAC,CAAC,QAAS,GAAUG,EAAM,KAAK,CAAC,EAClD,MACJ,CACA,EAAgBC,EAChB,EAAM,UAAYJ,EAClBR,EAAQQ,CAAM,EACd,MAAMI,EAAM,KAAK,CAAC,CAAC,UAAY,IAAA,EAAS,EACnCL,GAAWX,EAAU,OAAO,CACrC,OAASH,EAAK,CACLc,IACDT,EAASN,EAAcC,CAAG,CAAC,EAC3BG,EAAU,OAAO,EAEzB,CACJ,CAIA,OAFAc,EAAW,MAEE,CACT,EAAY,GACRF,GACAA,EAAO,UAAU,CAAC,CAAC,QAAS,GAAUG,EAAM,KAAK,CAAC,EAElDF,IACA,EAAc,UAAY,MAE9BT,EAAQ,IAAI,CAChB,CACJ,EAAG,CAACC,EAAYK,EAASF,CAAc,CAAC,EAEjC,CACH,SACA,QACA,WACA,OAAQL,EACR,UAAaG,EAAe,GAAMW,EAAI,CAAC,CAC3C,CACJ,C"}

package/dist/vision/use-camera-stream.js

@@ -24,15 +24,9 @@ function l(t = {}) {
 	return r(() => {
 		let e = !1, t = null, r = null;
 		async function i() {
-			if (!y) {
-				u("idle"), f(null);
-				return;
-			}
-			if (u("loading"), f(null), typeof navigator > "u" || !navigator.mediaDevices || typeof navigator.mediaDevices.getUserMedia != "function") {
-				e || (f(s(n("camera"))), u("error"));
-				return;
-			}
-			try {
+			if (!y) u("idle"), f(null);
+			else if (u("loading"), f(null), typeof navigator > "u" || !navigator.mediaDevices || typeof navigator.mediaDevices.getUserMedia != "function") e || (f(s(n("camera"))), u("error"));
+			else try {
 				if (t = await navigator.mediaDevices.getUserMedia(v.current), e) {
 					t.getTracks().forEach((e) => e.stop());
 					return;

package/dist/vision/use-camera-stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-camera-stream.js","names":[],"sources":["../../src/vision/use-camera-stream.ts"],"sourcesContent":["import { useEffect, useRef, useState, type RefObject } from \"react\";\nimport { useLatestRef } from \"@/hooks/use-latest-ref\";\n\nimport {\n    classifyMediaError,\n    missingCaptureApiError,\n    type MediaAccessError,\n} from \"@/audio/media-access\";\n\n/** Lifecycle status of the camera stream. */\nexport type CameraStreamStatus = \"idle\" | \"loading\" | \"ready\" | \"error\";\n\n/** Classified reason a camera stream could not be acquired. */\nexport type CameraStreamErrorKind =\n    \"unsupported\" | \"permission-denied\" | \"no-camera\" | \"in-use\" | \"insecure\" | \"unknown\";\n\n/** A classified camera error with a human-readable, English message. */\nexport interface CameraStreamError {\n    kind: CameraStreamErrorKind;\n    message: string;\n}\n\n/** Options for {@link useCameraStream}. */\nexport interface UseCameraStreamOptions {\n    /**\n     * Constraints passed to `getUserMedia`. Defaults to the rear\n     * (\"environment\") camera at Full-HD ideal resolution with audio off.\n     * Read when the stream (re)starts — change it and call `retry()` to apply.\n     */\n    constraints?: MediaStreamConstraints;\n    /**\n     * Hold off acquiring the camera until this is `true`. Default `true`.\n     *\n     * The point is to be able to *not* prompt. A permission prompt costs the user a\n     * decision and, if they refuse, costs the app the feature permanently — so a\n     * surface that already knows it cannot do its job (a barcode scanner in a browser\n     * with no decoder) must not open the camera to then say so. Flipping this to `false`\n     * also releases a stream that is already live.\n     */\n    enabled?: boolean;\n}\n\n/** Value returned by {@link useCameraStream}. */\nexport interface UseCameraStreamApi {\n    /** Current lifecycle status. */\n    status: CameraStreamStatus;\n    /** The classified error, or `null` while not in the `error` status. */\n    error: CameraStreamError | null;\n    /** Attach to a `<video ref={…} />`. The stream is wired to it once ready. */\n    videoRef: RefObject<HTMLVideoElement | null>;\n    /**\n     * The live stream, or `null`.\n     *\n     * Exposed for the things that need the **track** rather than the picture — the LED\n     * torch (`useTorch`), the real frame size from `getSettings()`, recording it with\n     * `useVideoRecorder`. Do not stop it yourself: the hook owns its lifetime and\n     * releases it on unmount and on `retry()`.\n     */\n    stream: MediaStream | null;\n    /** Manually re-attempt after an error (e.g. the user changed permissions). */\n    retry: () => void;\n}\n\n/** Rear-camera Full-HD defaults used when no `constraints` are supplied. */\nconst DEFAULT_CONSTRAINTS: MediaStreamConstraints = {\n    video: {\n        facingMode: { ideal: \"environment\" },\n        width: { ideal: 1920 },\n        height: { ideal: 1080 },\n    },\n    audio: false,\n};\n\n/**\n * Re-label a {@link MediaAccessError} as a {@link CameraStreamError}.\n *\n * The classification itself lives in one place for the whole SDK\n * (`classifyMediaError`), so a microphone and a camera failure are never explained\n * two different ways. Only the name of one kind differs: this surface shipped\n * `\"no-camera\"` where the shared taxonomy says `\"not-found\"`, and renaming a\n * published union member would break every consumer switching on it.\n *\n * @param error - The shared classification.\n * @returns The same error under this module's kind names.\n */\nfunction toCameraError({ kind, message }: MediaAccessError): CameraStreamError {\n    return { kind: kind === \"not-found\" ? \"no-camera\" : kind, message };\n}\n\n/**\n * Map an unknown `getUserMedia` failure into a {@link CameraStreamError}. Secure-context\n * and environment checks run first (they are the reason `getUserMedia` is missing or\n * rejects), then the `DOMException.name` is mapped to a stable `kind`.\n */\nfunction classifyError(err: unknown): CameraStreamError {\n    return toCameraError(classifyMediaError(err, \"camera\"));\n}\n\n/**\n * Acquire a `MediaStream` via `getUserMedia`, attach it to a `<video>` element,\n * and expose status/error so the page can render permission and error states.\n * The stream is automatically released on unmount or retry.\n *\n * Defaults to the rear (\"environment\") camera; desktops fall back to whatever\n * single camera they expose. Pass `options.constraints` to override, or\n * `options.enabled: false` to render the surface without prompting for the camera\n * at all.\n *\n * Implementation notes:\n * - Cleanup detaches the stream from a *snapshotted* video node, so it releases\n *   the same element it attached to even if the page remounts the `<video>`.\n * - When `getUserMedia` is missing, an insecure context is the usual cause, so\n *   the hook prefers that (actionable) error; otherwise it reports `unsupported`.\n * - `video.play()` rejections are swallowed: autoplay may be blocked, but the\n *   user gesture that opened the camera usually counts and playback resumes on\n *   the next interaction.\n *\n * @param options - optional configuration (see {@link UseCameraStreamOptions}).\n * @returns The stream status, classified error, a `videoRef` to attach, the live\n *   `stream` for whatever needs the track itself, and a `retry()` to re-attempt\n *   acquisition.\n */\nexport function useCameraStream(options: UseCameraStreamOptions = {}): UseCameraStreamApi {\n    const [status, setStatus] = useState<CameraStreamStatus>(\"loading\");\n    const [error, setError] = useState<CameraStreamError | null>(null);\n    const [live, setLive] = useState<MediaStream | null>(null);\n    const [retryToken, setRetryToken] = useState(0);\n    const videoRef = useRef<HTMLVideoElement | null>(null);\n    const constraintsRef = useLatestRef(options.constraints ?? DEFAULT_CONSTRAINTS);\n\n    const enabled = options.enabled ?? true;\n\n    useEffect(() => {\n        let cancelled = false;\n        let stream: MediaStream | null = null;\n        let attachedVideo: HTMLVideoElement | null = null;\n\n        async function start(): Promise<void> {\n            if (!enabled) {\n                setStatus(\"idle\");\n                setError(null);\n                return;\n            }\n            setStatus(\"loading\");\n            setError(null);\n\n            if (\n                typeof navigator === \"undefined\" ||\n                !navigator.mediaDevices ||\n                typeof navigator.mediaDevices.getUserMedia !== \"function\"\n            ) {\n                if (!cancelled) {\n                    setError(toCameraError(missingCaptureApiError(\"camera\")));\n                    setStatus(\"error\");\n                }\n                return;\n            }\n\n            try {\n                stream = await navigator.mediaDevices.getUserMedia(constraintsRef.current);\n                if (cancelled) {\n                    stream.getTracks().forEach((track) => track.stop());\n                    return;\n                }\n                const video = videoRef.current;\n                if (!video) {\n                    stream.getTracks().forEach((track) => track.stop());\n                    return;\n                }\n                attachedVideo = video;\n                video.srcObject = stream;\n                setLive(stream);\n                await video.play().catch(() => undefined);\n                if (!cancelled) setStatus(\"ready\");\n            } catch (err) {\n                if (!cancelled) {\n                    setError(classifyError(err));\n                    setStatus(\"error\");\n                }\n            }\n        }\n\n        void start();\n\n        return () => {\n            cancelled = true;\n            if (stream) {\n                stream.getTracks().forEach((track) => track.stop());\n            }\n            if (attachedVideo) {\n                attachedVideo.srcObject = null;\n            }\n            setLive(null);\n        };\n    }, [retryToken, enabled, constraintsRef]);\n\n    return {\n        status,\n        error,\n        videoRef,\n        stream: live,\n        retry: () => setRetryToken((n) => n + 1),\n    };\n}\n"],"mappings":";;;;AAgEA,IAAM,IAA8C;CAChD,OAAO;EACH,YAAY,EAAE,OAAO,cAAc;EACnC,OAAO,EAAE,OAAO,KAAK;EACrB,QAAQ,EAAE,OAAO,KAAK;CAC1B;CACA,OAAO;AACX;AAcA,SAAS,EAAc,EAAE,SAAM,cAAgD;CAC3E,OAAO;EAAE,MAAM,MAAS,cAAc,cAAc;EAAM;CAAQ;AACtE;AAOA,SAAS,EAAc,GAAiC;CACpD,OAAO,EAAc,EAAmB,GAAK,QAAQ,CAAC;AAC1D;AA0BA,SAAgB,EAAgB,IAAkC,CAAC,GAAuB;CACtF,IAAM,CAAC,GAAQ,KAAa,EAA6B,SAAS,GAC5D,CAAC,GAAO,KAAY,EAAmC,IAAI,GAC3D,CAAC,GAAM,KAAW,EAA6B,IAAI,GACnD,CAAC,GAAY,KAAiB,EAAS,CAAC,GACxC,IAAW,EAAgC,IAAI,GAC/C,IAAiB,EAAa,EAAQ,eAAe,CAAmB,GAExE,IAAU,EAAQ,WAAW;CAkEnC,OAhEA,QAAgB;EACZ,IAAI,IAAY,IACZ,IAA6B,MAC7B,IAAyC;EAE7C,eAAe,IAAuB;GAClC,IAAI,CAAC,GAAS;IAEV,AADA,EAAU,MAAM,GAChB,EAAS,IAAI;IACb;GACJ;GAIA,IAHA,EAAU,SAAS,GACnB,EAAS,IAAI,GAGT,OAAO,YAAc,OACrB,CAAC,UAAU,gBACX,OAAO,UAAU,aAAa,gBAAiB,YACjD;IACE,AAAK,MACD,EAAS,EAAc,EAAuB,QAAQ,CAAC,CAAC,GACxD,EAAU,OAAO;IAErB;GACJ;GAEA,IAAI;IAEA,IADA,IAAS,MAAM,UAAU,aAAa,aAAa,EAAe,OAAO,GACrE,GAAW;KACX,EAAO,UAAU,CAAC,CAAC,SAAS,MAAU,EAAM,KAAK,CAAC;KAClD;IACJ;IACA,IAAM,IAAQ,EAAS;IACvB,IAAI,CAAC,GAAO;KACR,EAAO,UAAU,CAAC,CAAC,SAAS,MAAU,EAAM,KAAK,CAAC;KAClD;IACJ;IAKA,AAJA,IAAgB,GAChB,EAAM,YAAY,GAClB,EAAQ,CAAM,GACd,MAAM,EAAM,KAAK,CAAC,CAAC,YAAY,KAAA,CAAS,GACnC,KAAW,EAAU,OAAO;GACrC,SAAS,GAAK;IACV,AAAK,MACD,EAAS,EAAc,CAAG,CAAC,GAC3B,EAAU,OAAO;GAEzB;EACJ;EAIA,OAFA,EAAW,SAEE;GAQT,AAPA,IAAY,IACR,KACA,EAAO,UAAU,CAAC,CAAC,SAAS,MAAU,EAAM,KAAK,CAAC,GAElD,MACA,EAAc,YAAY,OAE9B,EAAQ,IAAI;EAChB;CACJ,GAAG;EAAC;EAAY;EAAS;CAAc,CAAC,GAEjC;EACH;EACA;EACA;EACA,QAAQ;EACR,aAAa,GAAe,MAAM,IAAI,CAAC;CAC3C;AACJ"}
+{"version":3,"file":"use-camera-stream.js","names":["DEFAULT_CONSTRAINTS","toCameraError","kind","classifyError","classifyMediaError","err","useCameraStream","status","setStatus","useState","error","setError","live","setLive","retryToken","setRetryToken","videoRef","useRef","constraintsRef","useLatestRef","options","enabled","useEffect","cancelled","stream","attachedVideo","start","missingCaptureApiError","track","video","n"],"sources":["../../src/vision/use-camera-stream.ts"],"sourcesContent":["import { useEffect, useRef, useState, type RefObject } from \"react\";\nimport { useLatestRef } from \"@/hooks/use-latest-ref\";\n\nimport {\n    classifyMediaError,\n    missingCaptureApiError,\n    type MediaAccessError,\n} from \"@/audio/media-access\";\n\n/** Lifecycle status of the camera stream. */\nexport type CameraStreamStatus = \"idle\" | \"loading\" | \"ready\" | \"error\";\n\n/** Classified reason a camera stream could not be acquired. */\nexport type CameraStreamErrorKind =\n    \"unsupported\" | \"permission-denied\" | \"no-camera\" | \"in-use\" | \"insecure\" | \"unknown\";\n\n/** A classified camera error with a human-readable, English message. */\nexport interface CameraStreamError {\n    kind: CameraStreamErrorKind;\n    message: string;\n}\n\n/** Options for {@link useCameraStream}. */\nexport interface UseCameraStreamOptions {\n    /**\n     * Constraints passed to `getUserMedia`. Defaults to the rear\n     * (\"environment\") camera at Full-HD ideal resolution with audio off.\n     * Read when the stream (re)starts — change it and call `retry()` to apply.\n     */\n    constraints?: MediaStreamConstraints;\n    /**\n     * Hold off acquiring the camera until this is `true`. Default `true`.\n     *\n     * The point is to be able to *not* prompt. A permission prompt costs the user a\n     * decision and, if they refuse, costs the app the feature permanently — so a\n     * surface that already knows it cannot do its job (a barcode scanner in a browser\n     * with no decoder) must not open the camera to then say so. Flipping this to `false`\n     * also releases a stream that is already live.\n     */\n    enabled?: boolean;\n}\n\n/** Value returned by {@link useCameraStream}. */\nexport interface UseCameraStreamApi {\n    /** Current lifecycle status. */\n    status: CameraStreamStatus;\n    /** The classified error, or `null` while not in the `error` status. */\n    error: CameraStreamError | null;\n    /** Attach to a `<video ref={…} />`. The stream is wired to it once ready. */\n    videoRef: RefObject<HTMLVideoElement | null>;\n    /**\n     * The live stream, or `null`.\n     *\n     * Exposed for the things that need the **track** rather than the picture — the LED\n     * torch (`useTorch`), the real frame size from `getSettings()`, recording it with\n     * `useVideoRecorder`. Do not stop it yourself: the hook owns its lifetime and\n     * releases it on unmount and on `retry()`.\n     */\n    stream: MediaStream | null;\n    /** Manually re-attempt after an error (e.g. the user changed permissions). */\n    retry: () => void;\n}\n\n/** Rear-camera Full-HD defaults used when no `constraints` are supplied. */\nconst DEFAULT_CONSTRAINTS: MediaStreamConstraints = {\n    video: {\n        facingMode: { ideal: \"environment\" },\n        width: { ideal: 1920 },\n        height: { ideal: 1080 },\n    },\n    audio: false,\n};\n\n/**\n * Re-label a {@link MediaAccessError} as a {@link CameraStreamError}.\n *\n * The classification itself lives in one place for the whole SDK\n * (`classifyMediaError`), so a microphone and a camera failure are never explained\n * two different ways. Only the name of one kind differs: this surface shipped\n * `\"no-camera\"` where the shared taxonomy says `\"not-found\"`, and renaming a\n * published union member would break every consumer switching on it.\n *\n * @param error - The shared classification.\n * @returns The same error under this module's kind names.\n */\nfunction toCameraError({ kind, message }: MediaAccessError): CameraStreamError {\n    return { kind: kind === \"not-found\" ? \"no-camera\" : kind, message };\n}\n\n/**\n * Map an unknown `getUserMedia` failure into a {@link CameraStreamError}. Secure-context\n * and environment checks run first (they are the reason `getUserMedia` is missing or\n * rejects), then the `DOMException.name` is mapped to a stable `kind`.\n */\nfunction classifyError(err: unknown): CameraStreamError {\n    return toCameraError(classifyMediaError(err, \"camera\"));\n}\n\n/**\n * Acquire a `MediaStream` via `getUserMedia`, attach it to a `<video>` element,\n * and expose status/error so the page can render permission and error states.\n * The stream is automatically released on unmount or retry.\n *\n * Defaults to the rear (\"environment\") camera; desktops fall back to whatever\n * single camera they expose. Pass `options.constraints` to override, or\n * `options.enabled: false` to render the surface without prompting for the camera\n * at all.\n *\n * Implementation notes:\n * - Cleanup detaches the stream from a *snapshotted* video node, so it releases\n *   the same element it attached to even if the page remounts the `<video>`.\n * - When `getUserMedia` is missing, an insecure context is the usual cause, so\n *   the hook prefers that (actionable) error; otherwise it reports `unsupported`.\n * - `video.play()` rejections are swallowed: autoplay may be blocked, but the\n *   user gesture that opened the camera usually counts and playback resumes on\n *   the next interaction.\n *\n * @param options - optional configuration (see {@link UseCameraStreamOptions}).\n * @returns The stream status, classified error, a `videoRef` to attach, the live\n *   `stream` for whatever needs the track itself, and a `retry()` to re-attempt\n *   acquisition.\n */\nexport function useCameraStream(options: UseCameraStreamOptions = {}): UseCameraStreamApi {\n    const [status, setStatus] = useState<CameraStreamStatus>(\"loading\");\n    const [error, setError] = useState<CameraStreamError | null>(null);\n    const [live, setLive] = useState<MediaStream | null>(null);\n    const [retryToken, setRetryToken] = useState(0);\n    const videoRef = useRef<HTMLVideoElement | null>(null);\n    const constraintsRef = useLatestRef(options.constraints ?? DEFAULT_CONSTRAINTS);\n\n    const enabled = options.enabled ?? true;\n\n    useEffect(() => {\n        let cancelled = false;\n        let stream: MediaStream | null = null;\n        let attachedVideo: HTMLVideoElement | null = null;\n\n        async function start(): Promise<void> {\n            if (!enabled) {\n                setStatus(\"idle\");\n                setError(null);\n                return;\n            }\n            setStatus(\"loading\");\n            setError(null);\n\n            if (\n                typeof navigator === \"undefined\" ||\n                !navigator.mediaDevices ||\n                typeof navigator.mediaDevices.getUserMedia !== \"function\"\n            ) {\n                if (!cancelled) {\n                    setError(toCameraError(missingCaptureApiError(\"camera\")));\n                    setStatus(\"error\");\n                }\n                return;\n            }\n\n            try {\n                stream = await navigator.mediaDevices.getUserMedia(constraintsRef.current);\n                if (cancelled) {\n                    stream.getTracks().forEach((track) => track.stop());\n                    return;\n                }\n                const video = videoRef.current;\n                if (!video) {\n                    stream.getTracks().forEach((track) => track.stop());\n                    return;\n                }\n                attachedVideo = video;\n                video.srcObject = stream;\n                setLive(stream);\n                await video.play().catch(() => undefined);\n                if (!cancelled) setStatus(\"ready\");\n            } catch (err) {\n                if (!cancelled) {\n                    setError(classifyError(err));\n                    setStatus(\"error\");\n                }\n            }\n        }\n\n        void start();\n\n        return () => {\n            cancelled = true;\n            if (stream) {\n                stream.getTracks().forEach((track) => track.stop());\n            }\n            if (attachedVideo) {\n                attachedVideo.srcObject = null;\n            }\n            setLive(null);\n        };\n    }, [retryToken, enabled, constraintsRef]);\n\n    return {\n        status,\n        error,\n        videoRef,\n        stream: live,\n        retry: () => setRetryToken((n) => n + 1),\n    };\n}\n"],"mappings":";;;;AAgEA,IAAMA,IAA8C;CAChD,OAAO;EACH,YAAY,EAAE,OAAO,cAAc;EACnC,OAAO,EAAE,OAAO,KAAK;EACrB,QAAQ,EAAE,OAAO,KAAK;CAC1B;CACA,OAAO;AACX;AAcA,SAASC,EAAc,EAAE,SAAM,cAAgD;CAC3E,OAAO;EAAE,MAAMC,MAAS,cAAc,cAAcA;EAAM;CAAQ;AACtE;AAOA,SAASC,EAAc,GAAiC;CACpD,OAAOF,EAAcG,EAAmBC,GAAK,QAAQ,CAAC;AAC1D;AA0BA,SAAgBC,EAAgB,IAAkC,CAAC,GAAuB;CACtF,IAAM,CAACC,GAAQC,KAAaC,EAA6B,SAAS,GAC5D,CAACC,GAAOC,KAAYF,EAAmC,IAAI,GAC3D,CAACG,GAAMC,KAAWJ,EAA6B,IAAI,GACnD,CAACK,GAAYC,KAAiBN,EAAS,CAAC,GACxCO,IAAWC,EAAgC,IAAI,GAC/CC,IAAiBC,EAAaC,EAAQ,eAAepB,CAAmB,GAExEqB,IAAUD,EAAQ,WAAW;CAkEnC,OAhEAE,QAAgB;EACZ,IAAIC,IAAY,IACZC,IAA6B,MAC7BC,IAAyC;EAE7C,eAAeC,IAAuB;GAClC,IAAI,CAACL,GAED,AADAb,EAAU,MAAM,GAChBG,EAAS,IAAI;QAMjB,IAHAH,EAAU,SAAS,GACnBG,EAAS,IAAI,GAGT,OAAO,YAAc,OACrB,CAAC,UAAU,gBACX,OAAO,UAAU,aAAa,gBAAiB,YAE/C,AAAKY,MACDZ,EAASV,EAAc0B,EAAuB,QAAQ,CAAC,CAAC,GACxDnB,EAAU,OAAO;QAKzB,IAAI;IAEA,IADA,IAAS,MAAM,UAAU,aAAa,aAAaU,EAAe,OAAO,GACrEK,GAAW;KACX,EAAO,UAAU,CAAC,CAAC,SAAS,MAAUK,EAAM,KAAK,CAAC;KAClD;IACJ;IACA,IAAMC,IAAQb,EAAS;IACvB,IAAI,CAACa,GAAO;KACR,EAAO,UAAU,CAAC,CAAC,SAAS,MAAUD,EAAM,KAAK,CAAC;KAClD;IACJ;IAKA,AAJA,IAAgBC,GAChB,EAAM,YAAYL,GAClBX,EAAQW,CAAM,GACd,MAAMK,EAAM,KAAK,CAAC,CAAC,YAAY,KAAA,CAAS,GACnCN,KAAWf,EAAU,OAAO;GACrC,SAASH,GAAK;IACV,AAAKkB,MACDZ,EAASR,EAAcE,CAAG,CAAC,GAC3BG,EAAU,OAAO;GAEzB;EACJ;EAIA,OAFAkB,EAAW,SAEE;GAQT,AAPA,IAAY,IACRF,KACAA,EAAO,UAAU,CAAC,CAAC,SAAS,MAAUI,EAAM,KAAK,CAAC,GAElDH,MACA,EAAc,YAAY,OAE9BZ,EAAQ,IAAI;EAChB;CACJ,GAAG;EAACC;EAAYO;EAASH;CAAc,CAAC,GAEjC;EACH;EACA;EACA;EACA,QAAQN;EACR,aAAaG,GAAe,MAAMe,IAAI,CAAC;CAC3C;AACJ"}

package/dist/vision/use-live-luminance.cjs

@@ -1,2 +1,2 @@
-const e=require("./luminance.cjs");let t=require("react");function n(n,{enabled:r=!0,intervalMs:i=160}={}){let[a,o]=(0,t.useState)(0),s=(0,t.useRef)(null);return(0,t.useEffect)(()=>{if(!r||typeof window>`u`)return;s.current||=document.createElement(`canvas`);let t=0,a=0,c=r=>{let l=n.current;if(!l||l.readyState<2||l.videoWidth===0){t=window.requestAnimationFrame(c);return}r-a>=i&&(a=r,o(e.computeImageLuminance(l,s.current??void 0))),t=window.requestAnimationFrame(c)};return t=window.requestAnimationFrame(c),()=>window.cancelAnimationFrame(t)},[n,r,i]),a}exports.useLiveLuminance=n;
+const e=require("./luminance.cjs");let t=require("react");function n(n,{enabled:r=!0,intervalMs:i=160}={}){let[a,o]=(0,t.useState)(0),s=(0,t.useRef)(null);return(0,t.useEffect)(()=>{if(!r||typeof window>`u`)return;s.current||=document.createElement(`canvas`);let t=0,a=0,c=r=>{let l=n.current;!l||l.readyState<2||l.videoWidth===0||r-a>=i&&(a=r,o(e.computeImageLuminance(l,s.current??void 0))),t=window.requestAnimationFrame(c)};return t=window.requestAnimationFrame(c),()=>window.cancelAnimationFrame(t)},[n,r,i]),a}exports.useLiveLuminance=n;
 //# sourceMappingURL=use-live-luminance.cjs.map

package/dist/vision/use-live-luminance.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-live-luminance.cjs","names":[],"sources":["../../src/vision/use-live-luminance.ts"],"sourcesContent":["import { useEffect, useRef, useState, type RefObject } from \"react\";\nimport { computeImageLuminance } from \"./luminance\";\n\n/** Options for {@link useLiveLuminance}. */\nexport interface UseLiveLuminanceOptions {\n    /** When `false` the loop is paused (e.g. while a capture is in flight). Default: `true`. */\n    enabled?: boolean;\n    /** Throttle measurements in milliseconds. Default: `160` (~6 fps), plenty for UX. */\n    intervalMs?: number;\n}\n\n/**\n * Sample mean luminance from a `<video>` source on a `requestAnimationFrame`\n * loop and expose the rolling value. Sampling is throttled by `intervalMs` and\n * paused whenever `enabled` is `false` or the video is not ready yet\n * (`readyState < 2` or `videoWidth === 0`).\n *\n * One offscreen canvas is reused across frames to avoid GC pressure. Designed\n * to feed a live brightness bar / border color on a camera page.\n *\n * @param videoRef - ref to the `<video>` element to sample.\n * @param options - optional configuration (see {@link UseLiveLuminanceOptions}).\n * @returns The rolling mean luminance in `0..255` (`0` until the first sample).\n */\nexport function useLiveLuminance(\n    videoRef: RefObject<HTMLVideoElement | null>,\n    { enabled = true, intervalMs = 160 }: UseLiveLuminanceOptions = {},\n): number {\n    const [luminance, setLuminance] = useState(0);\n    const canvasRef = useRef<HTMLCanvasElement | null>(null);\n\n    useEffect(() => {\n        if (!enabled) return;\n        if (typeof window === \"undefined\") return;\n        if (!canvasRef.current) canvasRef.current = document.createElement(\"canvas\");\n\n        let rafId = 0;\n        let lastSampledAt = 0;\n\n        const tick = (timestamp: number): void => {\n            const video = videoRef.current;\n            if (!video || video.readyState < 2 || video.videoWidth === 0) {\n                rafId = window.requestAnimationFrame(tick);\n                return;\n            }\n            if (timestamp - lastSampledAt >= intervalMs) {\n                lastSampledAt = timestamp;\n                setLuminance(computeImageLuminance(video, canvasRef.current ?? undefined));\n            }\n            rafId = window.requestAnimationFrame(tick);\n        };\n\n        rafId = window.requestAnimationFrame(tick);\n        return () => window.cancelAnimationFrame(rafId);\n    }, [videoRef, enabled, intervalMs]);\n\n    return luminance;\n}\n"],"mappings":"0DAwBA,SAAgB,EACZ,EACA,CAAE,UAAU,GAAM,aAAa,KAAiC,CAAC,EAC3D,CACN,GAAM,CAAC,EAAW,IAAA,EAAgB,EAAA,SAAA,CAAS,CAAC,EACtC,GAAA,EAAY,EAAA,OAAA,CAAiC,IAAI,EA2BvD,OAzBA,EAAA,EAAA,UAAA,KAAgB,CAEZ,GADI,CAAC,GACD,OAAO,OAAW,IAAa,OACnC,AAAwB,EAAU,UAAU,SAAS,cAAc,QAAQ,EAE3E,IAAI,EAAQ,EACR,EAAgB,EAEd,EAAQ,GAA4B,CACtC,IAAM,EAAQ,EAAS,QACvB,GAAI,CAAC,GAAS,EAAM,WAAa,GAAK,EAAM,aAAe,EAAG,CAC1D,EAAQ,OAAO,sBAAsB,CAAI,EACzC,MACJ,CACI,EAAY,GAAiB,IAC7B,EAAgB,EAChB,EAAa,EAAA,sBAAsB,EAAO,EAAU,SAAW,IAAA,EAAS,CAAC,GAE7E,EAAQ,OAAO,sBAAsB,CAAI,CAC7C,EAGA,MADA,GAAQ,OAAO,sBAAsB,CAAI,MAC5B,OAAO,qBAAqB,CAAK,CAClD,EAAG,CAAC,EAAU,EAAS,CAAU,CAAC,EAE3B,CACX"}
+{"version":3,"file":"use-live-luminance.cjs","names":["useState","useRef","computeImageLuminance","require_luminance","react","useLiveLuminance","luminance","setLuminance","canvasRef","enabled","rafId","lastSampledAt","tick","video","videoRef","timestamp","intervalMs"],"sources":["../../src/vision/use-live-luminance.ts"],"sourcesContent":["import { useEffect, useRef, useState, type RefObject } from \"react\";\nimport { computeImageLuminance } from \"./luminance\";\n\n/** Options for {@link useLiveLuminance}. */\nexport interface UseLiveLuminanceOptions {\n    /** When `false` the loop is paused (e.g. while a capture is in flight). Default: `true`. */\n    enabled?: boolean;\n    /** Throttle measurements in milliseconds. Default: `160` (~6 fps), plenty for UX. */\n    intervalMs?: number;\n}\n\n/**\n * Sample mean luminance from a `<video>` source on a `requestAnimationFrame`\n * loop and expose the rolling value. Sampling is throttled by `intervalMs` and\n * paused whenever `enabled` is `false` or the video is not ready yet\n * (`readyState < 2` or `videoWidth === 0`).\n *\n * One offscreen canvas is reused across frames to avoid GC pressure. Designed\n * to feed a live brightness bar / border color on a camera page.\n *\n * @param videoRef - ref to the `<video>` element to sample.\n * @param options - optional configuration (see {@link UseLiveLuminanceOptions}).\n * @returns The rolling mean luminance in `0..255` (`0` until the first sample).\n */\nexport function useLiveLuminance(\n    videoRef: RefObject<HTMLVideoElement | null>,\n    { enabled = true, intervalMs = 160 }: UseLiveLuminanceOptions = {},\n): number {\n    const [luminance, setLuminance] = useState(0);\n    const canvasRef = useRef<HTMLCanvasElement | null>(null);\n\n    useEffect(() => {\n        if (!enabled) return;\n        if (typeof window === \"undefined\") return;\n        if (!canvasRef.current) canvasRef.current = document.createElement(\"canvas\");\n\n        let rafId = 0;\n        let lastSampledAt = 0;\n\n        const tick = (timestamp: number): void => {\n            const video = videoRef.current;\n            if (!video || video.readyState < 2 || video.videoWidth === 0) {\n                rafId = window.requestAnimationFrame(tick);\n                return;\n            }\n            if (timestamp - lastSampledAt >= intervalMs) {\n                lastSampledAt = timestamp;\n                setLuminance(computeImageLuminance(video, canvasRef.current ?? undefined));\n            }\n            rafId = window.requestAnimationFrame(tick);\n        };\n\n        rafId = window.requestAnimationFrame(tick);\n        return () => window.cancelAnimationFrame(rafId);\n    }, [videoRef, enabled, intervalMs]);\n\n    return luminance;\n}\n"],"mappings":"A,0DAwBA,SAAgBK,EACZ,EACA,CAAE,UAAU,GAAM,aAAa,KAAiC,CAAC,EAC3D,CACN,GAAM,CAACC,EAAWC,IAAA,EAAgBP,EAAAA,SAAAA,CAAS,CAAC,EACtCQ,GAAA,EAAYP,EAAAA,OAAAA,CAAiC,IAAI,EA2BvD,OAzBA,EAAAG,EAAA,UAAA,KAAgB,CAEZ,GADI,CAACK,GACD,OAAO,OAAW,IAAa,OACnC,AAAwBD,EAAU,UAAU,SAAS,cAAc,QAAQ,EAE3E,IAAIE,EAAQ,EACRC,EAAgB,EAEdC,EAAQ,GAA4B,CACtC,IAAMC,EAAQC,EAAS,QACnB,CAACD,GAASA,EAAM,WAAa,GAAKA,EAAM,aAAe,GAIvDE,EAAYJ,GAAiBK,IAC7B,EAAgBD,EAChBR,EAAaL,EAAAA,sBAAsBW,EAAOL,EAAU,SAAW,IAAA,EAAS,CAAC,GAE7E,EAAQ,OAAO,sBAAsBI,CAAI,CAC7C,EAGA,MADA,GAAQ,OAAO,sBAAsBA,CAAI,MAC5B,OAAO,qBAAqBF,CAAK,CAClD,EAAG,CAACI,EAAUL,EAASO,CAAU,CAAC,EAE3BV,CACX,C"}

package/dist/vision/use-live-luminance.js

@@ -8,11 +8,7 @@ function i(i, { enabled: a = !0, intervalMs: o = 160 } = {}) {
 		l.current ||= document.createElement("canvas");
 		let t = 0, n = 0, r = (a) => {
 			let s = i.current;
-			if (!s || s.readyState < 2 || s.videoWidth === 0) {
-				t = window.requestAnimationFrame(r);
-				return;
-			}
-			a - n >= o && (n = a, c(e(s, l.current ?? void 0))), t = window.requestAnimationFrame(r);
+			!s || s.readyState < 2 || s.videoWidth === 0 || a - n >= o && (n = a, c(e(s, l.current ?? void 0))), t = window.requestAnimationFrame(r);
 		};
 		return t = window.requestAnimationFrame(r), () => window.cancelAnimationFrame(t);
 	}, [

package/dist/vision/use-live-luminance.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-live-luminance.js","names":[],"sources":["../../src/vision/use-live-luminance.ts"],"sourcesContent":["import { useEffect, useRef, useState, type RefObject } from \"react\";\nimport { computeImageLuminance } from \"./luminance\";\n\n/** Options for {@link useLiveLuminance}. */\nexport interface UseLiveLuminanceOptions {\n    /** When `false` the loop is paused (e.g. while a capture is in flight). Default: `true`. */\n    enabled?: boolean;\n    /** Throttle measurements in milliseconds. Default: `160` (~6 fps), plenty for UX. */\n    intervalMs?: number;\n}\n\n/**\n * Sample mean luminance from a `<video>` source on a `requestAnimationFrame`\n * loop and expose the rolling value. Sampling is throttled by `intervalMs` and\n * paused whenever `enabled` is `false` or the video is not ready yet\n * (`readyState < 2` or `videoWidth === 0`).\n *\n * One offscreen canvas is reused across frames to avoid GC pressure. Designed\n * to feed a live brightness bar / border color on a camera page.\n *\n * @param videoRef - ref to the `<video>` element to sample.\n * @param options - optional configuration (see {@link UseLiveLuminanceOptions}).\n * @returns The rolling mean luminance in `0..255` (`0` until the first sample).\n */\nexport function useLiveLuminance(\n    videoRef: RefObject<HTMLVideoElement | null>,\n    { enabled = true, intervalMs = 160 }: UseLiveLuminanceOptions = {},\n): number {\n    const [luminance, setLuminance] = useState(0);\n    const canvasRef = useRef<HTMLCanvasElement | null>(null);\n\n    useEffect(() => {\n        if (!enabled) return;\n        if (typeof window === \"undefined\") return;\n        if (!canvasRef.current) canvasRef.current = document.createElement(\"canvas\");\n\n        let rafId = 0;\n        let lastSampledAt = 0;\n\n        const tick = (timestamp: number): void => {\n            const video = videoRef.current;\n            if (!video || video.readyState < 2 || video.videoWidth === 0) {\n                rafId = window.requestAnimationFrame(tick);\n                return;\n            }\n            if (timestamp - lastSampledAt >= intervalMs) {\n                lastSampledAt = timestamp;\n                setLuminance(computeImageLuminance(video, canvasRef.current ?? undefined));\n            }\n            rafId = window.requestAnimationFrame(tick);\n        };\n\n        rafId = window.requestAnimationFrame(tick);\n        return () => window.cancelAnimationFrame(rafId);\n    }, [videoRef, enabled, intervalMs]);\n\n    return luminance;\n}\n"],"mappings":";;;AAwBA,SAAgB,EACZ,GACA,EAAE,aAAU,IAAM,gBAAa,QAAiC,CAAC,GAC3D;CACN,IAAM,CAAC,GAAW,KAAgB,EAAS,CAAC,GACtC,IAAY,EAAiC,IAAI;CA2BvD,OAzBA,QAAgB;EAEZ,IADI,CAAC,KACD,OAAO,SAAW,KAAa;EACnC,AAAwB,EAAU,YAAU,SAAS,cAAc,QAAQ;EAE3E,IAAI,IAAQ,GACR,IAAgB,GAEd,KAAQ,MAA4B;GACtC,IAAM,IAAQ,EAAS;GACvB,IAAI,CAAC,KAAS,EAAM,aAAa,KAAK,EAAM,eAAe,GAAG;IAC1D,IAAQ,OAAO,sBAAsB,CAAI;IACzC;GACJ;GAKA,AAJI,IAAY,KAAiB,MAC7B,IAAgB,GAChB,EAAa,EAAsB,GAAO,EAAU,WAAW,KAAA,CAAS,CAAC,IAE7E,IAAQ,OAAO,sBAAsB,CAAI;EAC7C;EAGA,OADA,IAAQ,OAAO,sBAAsB,CAAI,SAC5B,OAAO,qBAAqB,CAAK;CAClD,GAAG;EAAC;EAAU;EAAS;CAAU,CAAC,GAE3B;AACX"}
+{"version":3,"file":"use-live-luminance.js","names":["useLiveLuminance","luminance","setLuminance","useState","canvasRef","useRef","useEffect","enabled","rafId","lastSampledAt","tick","video","videoRef","timestamp","intervalMs","computeImageLuminance"],"sources":["../../src/vision/use-live-luminance.ts"],"sourcesContent":["import { useEffect, useRef, useState, type RefObject } from \"react\";\nimport { computeImageLuminance } from \"./luminance\";\n\n/** Options for {@link useLiveLuminance}. */\nexport interface UseLiveLuminanceOptions {\n    /** When `false` the loop is paused (e.g. while a capture is in flight). Default: `true`. */\n    enabled?: boolean;\n    /** Throttle measurements in milliseconds. Default: `160` (~6 fps), plenty for UX. */\n    intervalMs?: number;\n}\n\n/**\n * Sample mean luminance from a `<video>` source on a `requestAnimationFrame`\n * loop and expose the rolling value. Sampling is throttled by `intervalMs` and\n * paused whenever `enabled` is `false` or the video is not ready yet\n * (`readyState < 2` or `videoWidth === 0`).\n *\n * One offscreen canvas is reused across frames to avoid GC pressure. Designed\n * to feed a live brightness bar / border color on a camera page.\n *\n * @param videoRef - ref to the `<video>` element to sample.\n * @param options - optional configuration (see {@link UseLiveLuminanceOptions}).\n * @returns The rolling mean luminance in `0..255` (`0` until the first sample).\n */\nexport function useLiveLuminance(\n    videoRef: RefObject<HTMLVideoElement | null>,\n    { enabled = true, intervalMs = 160 }: UseLiveLuminanceOptions = {},\n): number {\n    const [luminance, setLuminance] = useState(0);\n    const canvasRef = useRef<HTMLCanvasElement | null>(null);\n\n    useEffect(() => {\n        if (!enabled) return;\n        if (typeof window === \"undefined\") return;\n        if (!canvasRef.current) canvasRef.current = document.createElement(\"canvas\");\n\n        let rafId = 0;\n        let lastSampledAt = 0;\n\n        const tick = (timestamp: number): void => {\n            const video = videoRef.current;\n            if (!video || video.readyState < 2 || video.videoWidth === 0) {\n                rafId = window.requestAnimationFrame(tick);\n                return;\n            }\n            if (timestamp - lastSampledAt >= intervalMs) {\n                lastSampledAt = timestamp;\n                setLuminance(computeImageLuminance(video, canvasRef.current ?? undefined));\n            }\n            rafId = window.requestAnimationFrame(tick);\n        };\n\n        rafId = window.requestAnimationFrame(tick);\n        return () => window.cancelAnimationFrame(rafId);\n    }, [videoRef, enabled, intervalMs]);\n\n    return luminance;\n}\n"],"mappings":";;;AAwBA,SAAgBA,EACZ,GACA,EAAE,aAAU,IAAM,gBAAa,QAAiC,CAAC,GAC3D;CACN,IAAM,CAACC,GAAWC,KAAgBC,EAAS,CAAC,GACtCC,IAAYC,EAAiC,IAAI;CA2BvD,OAzBAC,QAAgB;EAEZ,IADI,CAACC,KACD,OAAO,SAAW,KAAa;EACnC,AAAwBH,EAAU,YAAU,SAAS,cAAc,QAAQ;EAE3E,IAAII,IAAQ,GACRC,IAAgB,GAEdC,KAAQ,MAA4B;GACtC,IAAMC,IAAQC,EAAS;GACvB,AAAI,CAACD,KAASA,EAAM,aAAa,KAAKA,EAAM,eAAe,KAIvDE,IAAYJ,KAAiBK,MAC7B,IAAgBD,GAChBX,EAAaa,EAAsBJ,GAAOP,EAAU,WAAW,KAAA,CAAS,CAAC,IAE7E,IAAQ,OAAO,sBAAsBM,CAAI;EAC7C;EAGA,OADA,IAAQ,OAAO,sBAAsBA,CAAI,SAC5B,OAAO,qBAAqBF,CAAK;CAClD,GAAG;EAACI;EAAUL;EAASO;CAAU,CAAC,GAE3Bb;AACX"}

package/dist/vite/base-url.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"base-url.cjs","names":[],"sources":["../../src/vite/base-url.ts"],"sourcesContent":["/**\n * The resolved Vite `base` as a prefix that always ends in a slash.\n *\n * One rule, three call sites: the manifest prefixes the URLs it precaches, and\n * the dev middleware matches the paths the browser asks for. They have to agree\n * by definition — when they drift, dev serves `/app/sw.js` while the manifest\n * precached `/sw.js`, and the symptom only appears on a subpath deploy, which is\n * the least exercised configuration there is.\n *\n * @param base - Vite's resolved `base`, with or without a trailing slash.\n * @returns The same base, guaranteed to end in `/`.\n */\nexport function basePrefix(base: string): string {\n    return base.endsWith(\"/\") ? base : `${base}/`;\n}\n"],"mappings":"AAYA,SAAgB,EAAW,EAAsB,CAC7C,OAAO,EAAK,SAAS,GAAG,EAAI,EAAO,GAAG,EAAK,EAC/C"}
+{"version":3,"file":"base-url.cjs","names":["basePrefix","base"],"sources":["../../src/vite/base-url.ts"],"sourcesContent":["/**\n * The resolved Vite `base` as a prefix that always ends in a slash.\n *\n * One rule, three call sites: the manifest prefixes the URLs it precaches, and\n * the dev middleware matches the paths the browser asks for. They have to agree\n * by definition — when they drift, dev serves `/app/sw.js` while the manifest\n * precached `/sw.js`, and the symptom only appears on a subpath deploy, which is\n * the least exercised configuration there is.\n *\n * @param base - Vite's resolved `base`, with or without a trailing slash.\n * @returns The same base, guaranteed to end in `/`.\n */\nexport function basePrefix(base: string): string {\n    return base.endsWith(\"/\") ? base : `${base}/`;\n}\n"],"mappings":"AAYA,SAAgBA,EAAW,EAAsB,CAC7C,OAAOC,EAAK,SAAS,GAAG,EAAIA,EAAO,GAAGA,EAAK,EAC/C,C"}

package/dist/vite/base-url.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-url.js","names":[],"sources":["../../src/vite/base-url.ts"],"sourcesContent":["/**\n * The resolved Vite `base` as a prefix that always ends in a slash.\n *\n * One rule, three call sites: the manifest prefixes the URLs it precaches, and\n * the dev middleware matches the paths the browser asks for. They have to agree\n * by definition — when they drift, dev serves `/app/sw.js` while the manifest\n * precached `/sw.js`, and the symptom only appears on a subpath deploy, which is\n * the least exercised configuration there is.\n *\n * @param base - Vite's resolved `base`, with or without a trailing slash.\n * @returns The same base, guaranteed to end in `/`.\n */\nexport function basePrefix(base: string): string {\n    return base.endsWith(\"/\") ? base : `${base}/`;\n}\n"],"mappings":";AAYA,SAAgB,EAAW,GAAsB;CAC7C,OAAO,EAAK,SAAS,GAAG,IAAI,IAAO,GAAG,EAAK;AAC/C"}
+{"version":3,"file":"base-url.js","names":["basePrefix","base"],"sources":["../../src/vite/base-url.ts"],"sourcesContent":["/**\n * The resolved Vite `base` as a prefix that always ends in a slash.\n *\n * One rule, three call sites: the manifest prefixes the URLs it precaches, and\n * the dev middleware matches the paths the browser asks for. They have to agree\n * by definition — when they drift, dev serves `/app/sw.js` while the manifest\n * precached `/sw.js`, and the symptom only appears on a subpath deploy, which is\n * the least exercised configuration there is.\n *\n * @param base - Vite's resolved `base`, with or without a trailing slash.\n * @returns The same base, guaranteed to end in `/`.\n */\nexport function basePrefix(base: string): string {\n    return base.endsWith(\"/\") ? base : `${base}/`;\n}\n"],"mappings":";AAYA,SAAgBA,EAAW,GAAsB;CAC7C,OAAOC,EAAK,SAAS,GAAG,IAAIA,IAAO,GAAGA,EAAK;AAC/C"}

package/dist/vite/create-vite-config.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-vite-config.cjs","names":[],"sources":["../../src/vite/create-vite-config.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport { defineConfig } from \"vite\";\nimport type { PluginOption, ProxyOptions, UserConfig } from \"vite\";\n\nimport { tempestIcons, type TempestIconsOptions } from \"./tempest-icons\";\nimport { tempestVitest } from \"./tempest-vitest\";\n\n/**\n * A Vite proxy entry: either a target URL string (expanded to\n * `{ target, changeOrigin: true }`) or a raw Vite `ProxyOptions` object.\n */\nexport type ProxyEntry = string | Record<string, unknown>;\n\nexport interface CreateViteConfigOptions {\n    /**\n     * Source directory aliased to `@`, relative to the project root.\n     * Default: `\"src\"` (so `@/components/Button` → `<root>/src/components/Button`).\n     */\n    srcDir?: string;\n    /** Dev server port. Default: `5173`. */\n    port?: number;\n    /** Dev server host. Default: `\"127.0.0.1\"`. */\n    host?: string | boolean;\n    /** Open the browser on `dev` start. Default: `false`. */\n    open?: boolean;\n    /**\n     * Dev proxy table. String values are expanded to\n     * `{ target, changeOrigin: true }`; objects are passed through untouched.\n     *\n     * @example { \"/api\": \"http://127.0.0.1:8000\" }\n     */\n    proxy?: Record<string, ProxyEntry>;\n    /** Extra path aliases merged on top of the default `@` → src alias. */\n    alias?: Record<string, string>;\n    /** Vite plugins appended after `@vitejs/plugin-react`. */\n    plugins?: unknown[];\n    /**\n     * The `tempestIcons()` plugin, which generates `virtual:tempest-icons` from the\n     * icon slugs your source mentions. On by default — it only ever removes\n     * requests. Pass `false` to leave it out, or an options object to configure the\n     * scan.\n     */\n    icons?: boolean | TempestIconsOptions;\n    /**\n     * Arbitrary Vite config (a `UserConfig` object) deep-merged last, for\n     * escape-hatch overrides (build target, define, extra `server` keys, …).\n     */\n    overrides?: Record<string, unknown>;\n}\n\n/**\n * The resulting Vite config object. Typed loosely so the SDK's published\n * declarations stay free of `vite`'s internal types; assign it straight to a\n * `vite.config.ts` default export.\n */\nexport type TempestViteConfig = Record<string, unknown>;\n\nfunction normalizeProxy(proxy: Record<string, ProxyEntry>): Record<string, ProxyOptions> {\n    const out: Record<string, ProxyOptions> = {};\n    for (const [path, value] of Object.entries(proxy)) {\n        out[path] =\n            typeof value === \"string\"\n                ? { target: value, changeOrigin: true }\n                : (value as ProxyOptions);\n    }\n    return out;\n}\n\n/**\n * Load `@vitejs/plugin-react` when a config is built, not when this module loads.\n *\n * The plugin is an optional peer, and every helper of `tempest-react-sdk/vite`\n * ships through one barrel. A top-level import made the whole barrel require it:\n * a project without the React plugin could not load a config importing only\n * `tempestVitest` or `tempestCsp` (`ERR_MODULE_NOT_FOUND`, #401). Vite resolves a\n * promise in `plugins` before using it, so {@link createViteConfig} stays\n * synchronous and only it needs the peer.\n *\n * @returns The React plugin, once its module has loaded.\n */\nfunction reactPlugin(): Promise<PluginOption> {\n    return import(\"@vitejs/plugin-react\").then((module) => module.default());\n}\n\n/**\n * Build a Tempest-flavored Vite config for a React app: the `@vitejs/plugin-react`\n * plugin, the `@` → `src` import alias, sane dev-server defaults and\n * {@link tempestVitest}, which lets a Vitest suite import the SDK — so a\n * consuming app's `vite.config.ts` is a single call instead of repeated\n * boilerplate. Everything is overridable.\n *\n * Import it from the dedicated Node entry point:\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({\n *     proxy: { \"/api\": \"http://127.0.0.1:8000\" },\n * });\n */\nexport function createViteConfig(options: CreateViteConfigOptions = {}): TempestViteConfig {\n    const {\n        srcDir = \"src\",\n        port = 5173,\n        host = \"127.0.0.1\",\n        open = false,\n        proxy,\n        alias = {},\n        plugins = [],\n        icons = true,\n        overrides = {},\n    } = options;\n\n    const overridesConfig = overrides as UserConfig;\n    const iconsPlugin = icons\n        ? [tempestIcons({ dir: srcDir, ...(typeof icons === \"object\" ? icons : {}) })]\n        : [];\n\n    const base: UserConfig = {\n        plugins: [\n            reactPlugin(),\n            ...iconsPlugin,\n            tempestVitest(),\n            ...plugins,\n        ] as UserConfig[\"plugins\"],\n        resolve: {\n            alias: {\n                \"@\": resolve(process.cwd(), srcDir),\n                ...alias,\n            },\n        },\n        server: {\n            port,\n            host,\n            open,\n            ...(proxy ? { proxy: normalizeProxy(proxy) } : {}),\n        },\n    };\n\n    const merged: UserConfig = {\n        ...base,\n        ...overridesConfig,\n        plugins: [...(base.plugins ?? []), ...(overridesConfig.plugins ?? [])],\n        resolve: { ...base.resolve, ...overridesConfig.resolve },\n        server: { ...base.server, ...overridesConfig.server },\n    };\n\n    return defineConfig(merged) as TempestViteConfig;\n}\n"],"mappings":"sHAyDA,SAAS,EAAe,EAAiE,CACrF,IAAM,EAAoC,CAAC,EAC3C,IAAK,GAAM,CAAC,EAAM,KAAU,OAAO,QAAQ,CAAK,EAC5C,EAAI,GACA,OAAO,GAAU,SACX,CAAE,OAAQ,EAAO,aAAc,EAAK,EACnC,EAEf,OAAO,CACX,CAcA,SAAS,GAAqC,CAC1C,OAAO,OAAO,uBAAuB,CAAC,KAAM,GAAW,EAAO,QAAQ,CAAC,CAC3E,CAmBA,SAAgB,EAAiB,EAAmC,CAAC,EAAsB,CACvF,GAAM,CACF,SAAS,MACT,OAAO,KACP,OAAO,YACP,OAAO,GACP,QACA,QAAQ,CAAC,EACT,UAAU,CAAC,EACX,QAAQ,GACR,YAAY,CAAC,GACb,EAEE,EAAkB,EAClB,EAAc,EACd,CAAC,EAAA,aAAa,CAAE,IAAK,EAAQ,GAAI,OAAO,GAAU,SAAW,EAAQ,CAAC,CAAG,CAAC,CAAC,EAC3E,CAAC,EAED,EAAmB,CACrB,QAAS,CACL,EAAY,EACZ,GAAG,EACH,EAAA,cAAc,EACd,GAAG,CACP,EACA,QAAS,CACL,MAAO,CACH,KAAA,EAAK,EAAA,QAAA,CAAQ,QAAQ,IAAI,EAAG,CAAM,EAClC,GAAG,CACP,CACJ,EACA,OAAQ,CACJ,OACA,OACA,OACA,GAAI,EAAQ,CAAE,MAAO,EAAe,CAAK,CAAE,EAAI,CAAC,CACpD,CACJ,EAEM,EAAqB,CACvB,GAAG,EACH,GAAG,EACH,QAAS,CAAC,GAAI,EAAK,SAAW,CAAC,EAAI,GAAI,EAAgB,SAAW,CAAC,CAAE,EACrE,QAAS,CAAE,GAAG,EAAK,QAAS,GAAG,EAAgB,OAAQ,EACvD,OAAQ,CAAE,GAAG,EAAK,OAAQ,GAAG,EAAgB,MAAO,CACxD,EAEA,OAAA,EAAO,EAAA,aAAA,CAAa,CAAM,CAC9B"}
+{"version":3,"file":"create-vite-config.cjs","names":["tempestIcons","tempestVitest","resolve","defineConfig","require_tempest_icons","require_tempest_vitest","node_path","vite","normalizeProxy","out","path","value","proxy","reactPlugin","module","createViteConfig","options","overridesConfig","overrides","iconsPlugin","icons","srcDir","base","plugins","alias","merged"],"sources":["../../src/vite/create-vite-config.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport { defineConfig } from \"vite\";\nimport type { PluginOption, ProxyOptions, UserConfig } from \"vite\";\n\nimport { tempestIcons, type TempestIconsOptions } from \"./tempest-icons\";\nimport { tempestVitest } from \"./tempest-vitest\";\n\n/**\n * A Vite proxy entry: either a target URL string (expanded to\n * `{ target, changeOrigin: true }`) or a raw Vite `ProxyOptions` object.\n */\nexport type ProxyEntry = string | Record<string, unknown>;\n\nexport interface CreateViteConfigOptions {\n    /**\n     * Source directory aliased to `@`, relative to the project root.\n     * Default: `\"src\"` (so `@/components/Button` → `<root>/src/components/Button`).\n     */\n    srcDir?: string;\n    /** Dev server port. Default: `5173`. */\n    port?: number;\n    /** Dev server host. Default: `\"127.0.0.1\"`. */\n    host?: string | boolean;\n    /** Open the browser on `dev` start. Default: `false`. */\n    open?: boolean;\n    /**\n     * Dev proxy table. String values are expanded to\n     * `{ target, changeOrigin: true }`; objects are passed through untouched.\n     *\n     * @example { \"/api\": \"http://127.0.0.1:8000\" }\n     */\n    proxy?: Record<string, ProxyEntry>;\n    /** Extra path aliases merged on top of the default `@` → src alias. */\n    alias?: Record<string, string>;\n    /** Vite plugins appended after `@vitejs/plugin-react`. */\n    plugins?: unknown[];\n    /**\n     * The `tempestIcons()` plugin, which generates `virtual:tempest-icons` from the\n     * icon slugs your source mentions. On by default — it only ever removes\n     * requests. Pass `false` to leave it out, or an options object to configure the\n     * scan.\n     */\n    icons?: boolean | TempestIconsOptions;\n    /**\n     * Arbitrary Vite config (a `UserConfig` object) deep-merged last, for\n     * escape-hatch overrides (build target, define, extra `server` keys, …).\n     */\n    overrides?: Record<string, unknown>;\n}\n\n/**\n * The resulting Vite config object. Typed loosely so the SDK's published\n * declarations stay free of `vite`'s internal types; assign it straight to a\n * `vite.config.ts` default export.\n */\nexport type TempestViteConfig = Record<string, unknown>;\n\nfunction normalizeProxy(proxy: Record<string, ProxyEntry>): Record<string, ProxyOptions> {\n    const out: Record<string, ProxyOptions> = {};\n    for (const [path, value] of Object.entries(proxy)) {\n        out[path] =\n            typeof value === \"string\"\n                ? { target: value, changeOrigin: true }\n                : (value as ProxyOptions);\n    }\n    return out;\n}\n\n/**\n * Load `@vitejs/plugin-react` when a config is built, not when this module loads.\n *\n * The plugin is an optional peer, and every helper of `tempest-react-sdk/vite`\n * ships through one barrel. A top-level import made the whole barrel require it:\n * a project without the React plugin could not load a config importing only\n * `tempestVitest` or `tempestCsp` (`ERR_MODULE_NOT_FOUND`, #401). Vite resolves a\n * promise in `plugins` before using it, so {@link createViteConfig} stays\n * synchronous and only it needs the peer.\n *\n * @returns The React plugin, once its module has loaded.\n */\nfunction reactPlugin(): Promise<PluginOption> {\n    return import(\"@vitejs/plugin-react\").then((module) => module.default());\n}\n\n/**\n * Build a Tempest-flavored Vite config for a React app: the `@vitejs/plugin-react`\n * plugin, the `@` → `src` import alias, sane dev-server defaults and\n * {@link tempestVitest}, which lets a Vitest suite import the SDK — so a\n * consuming app's `vite.config.ts` is a single call instead of repeated\n * boilerplate. Everything is overridable.\n *\n * Import it from the dedicated Node entry point:\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({\n *     proxy: { \"/api\": \"http://127.0.0.1:8000\" },\n * });\n */\nexport function createViteConfig(options: CreateViteConfigOptions = {}): TempestViteConfig {\n    const {\n        srcDir = \"src\",\n        port = 5173,\n        host = \"127.0.0.1\",\n        open = false,\n        proxy,\n        alias = {},\n        plugins = [],\n        icons = true,\n        overrides = {},\n    } = options;\n\n    const overridesConfig = overrides as UserConfig;\n    const iconsPlugin = icons\n        ? [tempestIcons({ dir: srcDir, ...(typeof icons === \"object\" ? icons : {}) })]\n        : [];\n\n    const base: UserConfig = {\n        plugins: [\n            reactPlugin(),\n            ...iconsPlugin,\n            tempestVitest(),\n            ...plugins,\n        ] as UserConfig[\"plugins\"],\n        resolve: {\n            alias: {\n                \"@\": resolve(process.cwd(), srcDir),\n                ...alias,\n            },\n        },\n        server: {\n            port,\n            host,\n            open,\n            ...(proxy ? { proxy: normalizeProxy(proxy) } : {}),\n        },\n    };\n\n    const merged: UserConfig = {\n        ...base,\n        ...overridesConfig,\n        plugins: [...(base.plugins ?? []), ...(overridesConfig.plugins ?? [])],\n        resolve: { ...base.resolve, ...overridesConfig.resolve },\n        server: { ...base.server, ...overridesConfig.server },\n    };\n\n    return defineConfig(merged) as TempestViteConfig;\n}\n"],"mappings":"A,sHAyDA,SAASQ,EAAe,EAAiE,CACrF,IAAMC,EAAoC,CAAC,EAC3C,IAAK,GAAM,CAACC,EAAMC,KAAU,OAAO,QAAQC,CAAK,EAC5C,EAAIF,GACA,OAAOC,GAAU,SACX,CAAE,OAAQA,EAAO,aAAc,EAAK,EACnCA,EAEf,OAAOF,CACX,CAcA,SAASI,GAAqC,CAC1C,OAAO,OAAO,uBAAuB,CAAC,KAAM,GAAWC,EAAO,QAAQ,CAAC,CAC3E,CAmBA,SAAgBC,EAAiB,EAAmC,CAAC,EAAsB,CACvF,GAAM,CACF,SAAS,MACT,OAAO,KACP,OAAO,YACP,OAAO,GACP,QACA,QAAQ,CAAC,EACT,UAAU,CAAC,EACX,QAAQ,GACR,YAAY,CAAC,GACbC,EAEEC,EAAkBC,EAClBC,EAAcC,EACd,CAACpB,EAAAA,aAAa,CAAE,IAAKqB,EAAQ,GAAI,OAAOD,GAAU,SAAWA,EAAQ,CAAC,CAAG,CAAC,CAAC,EAC3E,CAAC,EAEDE,EAAmB,CACrB,QAAS,CACLT,EAAY,EACZ,GAAGM,EACHlB,EAAAA,cAAc,EACd,GAAGsB,CACP,EACA,QAAS,CACL,MAAO,CACH,KAAA,EAAKrB,EAAAA,QAAAA,CAAQ,QAAQ,IAAI,EAAGmB,CAAM,EAClC,GAAGG,CACP,CACJ,EACA,OAAQ,CACJ,OACA,OACA,OACA,GAAIZ,EAAQ,CAAE,MAAOJ,EAAeI,CAAK,CAAE,EAAI,CAAC,CACpD,CACJ,EAEMa,EAAqB,CACvB,GAAGH,EACH,GAAGL,EACH,QAAS,CAAC,GAAIK,EAAK,SAAW,CAAC,EAAI,GAAIL,EAAgB,SAAW,CAAC,CAAE,EACrE,QAAS,CAAE,GAAGK,EAAK,QAAS,GAAGL,EAAgB,OAAQ,EACvD,OAAQ,CAAE,GAAGK,EAAK,OAAQ,GAAGL,EAAgB,MAAO,CACxD,EAEA,OAAA,EAAOd,EAAAA,aAAAA,CAAasB,CAAM,CAC9B,C"}

package/dist/vite/create-vite-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-vite-config.js","names":[],"sources":["../../src/vite/create-vite-config.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport { defineConfig } from \"vite\";\nimport type { PluginOption, ProxyOptions, UserConfig } from \"vite\";\n\nimport { tempestIcons, type TempestIconsOptions } from \"./tempest-icons\";\nimport { tempestVitest } from \"./tempest-vitest\";\n\n/**\n * A Vite proxy entry: either a target URL string (expanded to\n * `{ target, changeOrigin: true }`) or a raw Vite `ProxyOptions` object.\n */\nexport type ProxyEntry = string | Record<string, unknown>;\n\nexport interface CreateViteConfigOptions {\n    /**\n     * Source directory aliased to `@`, relative to the project root.\n     * Default: `\"src\"` (so `@/components/Button` → `<root>/src/components/Button`).\n     */\n    srcDir?: string;\n    /** Dev server port. Default: `5173`. */\n    port?: number;\n    /** Dev server host. Default: `\"127.0.0.1\"`. */\n    host?: string | boolean;\n    /** Open the browser on `dev` start. Default: `false`. */\n    open?: boolean;\n    /**\n     * Dev proxy table. String values are expanded to\n     * `{ target, changeOrigin: true }`; objects are passed through untouched.\n     *\n     * @example { \"/api\": \"http://127.0.0.1:8000\" }\n     */\n    proxy?: Record<string, ProxyEntry>;\n    /** Extra path aliases merged on top of the default `@` → src alias. */\n    alias?: Record<string, string>;\n    /** Vite plugins appended after `@vitejs/plugin-react`. */\n    plugins?: unknown[];\n    /**\n     * The `tempestIcons()` plugin, which generates `virtual:tempest-icons` from the\n     * icon slugs your source mentions. On by default — it only ever removes\n     * requests. Pass `false` to leave it out, or an options object to configure the\n     * scan.\n     */\n    icons?: boolean | TempestIconsOptions;\n    /**\n     * Arbitrary Vite config (a `UserConfig` object) deep-merged last, for\n     * escape-hatch overrides (build target, define, extra `server` keys, …).\n     */\n    overrides?: Record<string, unknown>;\n}\n\n/**\n * The resulting Vite config object. Typed loosely so the SDK's published\n * declarations stay free of `vite`'s internal types; assign it straight to a\n * `vite.config.ts` default export.\n */\nexport type TempestViteConfig = Record<string, unknown>;\n\nfunction normalizeProxy(proxy: Record<string, ProxyEntry>): Record<string, ProxyOptions> {\n    const out: Record<string, ProxyOptions> = {};\n    for (const [path, value] of Object.entries(proxy)) {\n        out[path] =\n            typeof value === \"string\"\n                ? { target: value, changeOrigin: true }\n                : (value as ProxyOptions);\n    }\n    return out;\n}\n\n/**\n * Load `@vitejs/plugin-react` when a config is built, not when this module loads.\n *\n * The plugin is an optional peer, and every helper of `tempest-react-sdk/vite`\n * ships through one barrel. A top-level import made the whole barrel require it:\n * a project without the React plugin could not load a config importing only\n * `tempestVitest` or `tempestCsp` (`ERR_MODULE_NOT_FOUND`, #401). Vite resolves a\n * promise in `plugins` before using it, so {@link createViteConfig} stays\n * synchronous and only it needs the peer.\n *\n * @returns The React plugin, once its module has loaded.\n */\nfunction reactPlugin(): Promise<PluginOption> {\n    return import(\"@vitejs/plugin-react\").then((module) => module.default());\n}\n\n/**\n * Build a Tempest-flavored Vite config for a React app: the `@vitejs/plugin-react`\n * plugin, the `@` → `src` import alias, sane dev-server defaults and\n * {@link tempestVitest}, which lets a Vitest suite import the SDK — so a\n * consuming app's `vite.config.ts` is a single call instead of repeated\n * boilerplate. Everything is overridable.\n *\n * Import it from the dedicated Node entry point:\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({\n *     proxy: { \"/api\": \"http://127.0.0.1:8000\" },\n * });\n */\nexport function createViteConfig(options: CreateViteConfigOptions = {}): TempestViteConfig {\n    const {\n        srcDir = \"src\",\n        port = 5173,\n        host = \"127.0.0.1\",\n        open = false,\n        proxy,\n        alias = {},\n        plugins = [],\n        icons = true,\n        overrides = {},\n    } = options;\n\n    const overridesConfig = overrides as UserConfig;\n    const iconsPlugin = icons\n        ? [tempestIcons({ dir: srcDir, ...(typeof icons === \"object\" ? icons : {}) })]\n        : [];\n\n    const base: UserConfig = {\n        plugins: [\n            reactPlugin(),\n            ...iconsPlugin,\n            tempestVitest(),\n            ...plugins,\n        ] as UserConfig[\"plugins\"],\n        resolve: {\n            alias: {\n                \"@\": resolve(process.cwd(), srcDir),\n                ...alias,\n            },\n        },\n        server: {\n            port,\n            host,\n            open,\n            ...(proxy ? { proxy: normalizeProxy(proxy) } : {}),\n        },\n    };\n\n    const merged: UserConfig = {\n        ...base,\n        ...overridesConfig,\n        plugins: [...(base.plugins ?? []), ...(overridesConfig.plugins ?? [])],\n        resolve: { ...base.resolve, ...overridesConfig.resolve },\n        server: { ...base.server, ...overridesConfig.server },\n    };\n\n    return defineConfig(merged) as TempestViteConfig;\n}\n"],"mappings":";;;;;AAyDA,SAAS,EAAe,GAAiE;CACrF,IAAM,IAAoC,CAAC;CAC3C,KAAK,IAAM,CAAC,GAAM,MAAU,OAAO,QAAQ,CAAK,GAC5C,EAAI,KACA,OAAO,KAAU,WACX;EAAE,QAAQ;EAAO,cAAc;CAAK,IACnC;CAEf,OAAO;AACX;AAcA,SAAS,IAAqC;CAC1C,OAAO,OAAO,uBAAuB,CAAC,MAAM,MAAW,EAAO,QAAQ,CAAC;AAC3E;AAmBA,SAAgB,EAAiB,IAAmC,CAAC,GAAsB;CACvF,IAAM,EACF,YAAS,OACT,UAAO,MACP,UAAO,aACP,UAAO,IACP,UACA,WAAQ,CAAC,GACT,aAAU,CAAC,GACX,WAAQ,IACR,eAAY,CAAC,MACb,GAEE,IAAkB,GAClB,IAAc,IACd,CAAC,EAAa;EAAE,KAAK;EAAQ,GAAI,OAAO,KAAU,WAAW,IAAQ,CAAC;CAAG,CAAC,CAAC,IAC3E,CAAC,GAED,IAAmB;EACrB,SAAS;GACL,EAAY;GACZ,GAAG;GACH,EAAc;GACd,GAAG;EACP;EACA,SAAS,EACL,OAAO;GACH,KAAK,EAAQ,QAAQ,IAAI,GAAG,CAAM;GAClC,GAAG;EACP,EACJ;EACA,QAAQ;GACJ;GACA;GACA;GACA,GAAI,IAAQ,EAAE,OAAO,EAAe,CAAK,EAAE,IAAI,CAAC;EACpD;CACJ,GAEM,IAAqB;EACvB,GAAG;EACH,GAAG;EACH,SAAS,CAAC,GAAI,EAAK,WAAW,CAAC,GAAI,GAAI,EAAgB,WAAW,CAAC,CAAE;EACrE,SAAS;GAAE,GAAG,EAAK;GAAS,GAAG,EAAgB;EAAQ;EACvD,QAAQ;GAAE,GAAG,EAAK;GAAQ,GAAG,EAAgB;EAAO;CACxD;CAEA,OAAO,EAAa,CAAM;AAC9B"}
+{"version":3,"file":"create-vite-config.js","names":["normalizeProxy","out","path","value","proxy","reactPlugin","module","createViteConfig","options","overridesConfig","overrides","iconsPlugin","icons","tempestIcons","srcDir","base","tempestVitest","plugins","resolve","alias","merged","defineConfig"],"sources":["../../src/vite/create-vite-config.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport { defineConfig } from \"vite\";\nimport type { PluginOption, ProxyOptions, UserConfig } from \"vite\";\n\nimport { tempestIcons, type TempestIconsOptions } from \"./tempest-icons\";\nimport { tempestVitest } from \"./tempest-vitest\";\n\n/**\n * A Vite proxy entry: either a target URL string (expanded to\n * `{ target, changeOrigin: true }`) or a raw Vite `ProxyOptions` object.\n */\nexport type ProxyEntry = string | Record<string, unknown>;\n\nexport interface CreateViteConfigOptions {\n    /**\n     * Source directory aliased to `@`, relative to the project root.\n     * Default: `\"src\"` (so `@/components/Button` → `<root>/src/components/Button`).\n     */\n    srcDir?: string;\n    /** Dev server port. Default: `5173`. */\n    port?: number;\n    /** Dev server host. Default: `\"127.0.0.1\"`. */\n    host?: string | boolean;\n    /** Open the browser on `dev` start. Default: `false`. */\n    open?: boolean;\n    /**\n     * Dev proxy table. String values are expanded to\n     * `{ target, changeOrigin: true }`; objects are passed through untouched.\n     *\n     * @example { \"/api\": \"http://127.0.0.1:8000\" }\n     */\n    proxy?: Record<string, ProxyEntry>;\n    /** Extra path aliases merged on top of the default `@` → src alias. */\n    alias?: Record<string, string>;\n    /** Vite plugins appended after `@vitejs/plugin-react`. */\n    plugins?: unknown[];\n    /**\n     * The `tempestIcons()` plugin, which generates `virtual:tempest-icons` from the\n     * icon slugs your source mentions. On by default — it only ever removes\n     * requests. Pass `false` to leave it out, or an options object to configure the\n     * scan.\n     */\n    icons?: boolean | TempestIconsOptions;\n    /**\n     * Arbitrary Vite config (a `UserConfig` object) deep-merged last, for\n     * escape-hatch overrides (build target, define, extra `server` keys, …).\n     */\n    overrides?: Record<string, unknown>;\n}\n\n/**\n * The resulting Vite config object. Typed loosely so the SDK's published\n * declarations stay free of `vite`'s internal types; assign it straight to a\n * `vite.config.ts` default export.\n */\nexport type TempestViteConfig = Record<string, unknown>;\n\nfunction normalizeProxy(proxy: Record<string, ProxyEntry>): Record<string, ProxyOptions> {\n    const out: Record<string, ProxyOptions> = {};\n    for (const [path, value] of Object.entries(proxy)) {\n        out[path] =\n            typeof value === \"string\"\n                ? { target: value, changeOrigin: true }\n                : (value as ProxyOptions);\n    }\n    return out;\n}\n\n/**\n * Load `@vitejs/plugin-react` when a config is built, not when this module loads.\n *\n * The plugin is an optional peer, and every helper of `tempest-react-sdk/vite`\n * ships through one barrel. A top-level import made the whole barrel require it:\n * a project without the React plugin could not load a config importing only\n * `tempestVitest` or `tempestCsp` (`ERR_MODULE_NOT_FOUND`, #401). Vite resolves a\n * promise in `plugins` before using it, so {@link createViteConfig} stays\n * synchronous and only it needs the peer.\n *\n * @returns The React plugin, once its module has loaded.\n */\nfunction reactPlugin(): Promise<PluginOption> {\n    return import(\"@vitejs/plugin-react\").then((module) => module.default());\n}\n\n/**\n * Build a Tempest-flavored Vite config for a React app: the `@vitejs/plugin-react`\n * plugin, the `@` → `src` import alias, sane dev-server defaults and\n * {@link tempestVitest}, which lets a Vitest suite import the SDK — so a\n * consuming app's `vite.config.ts` is a single call instead of repeated\n * boilerplate. Everything is overridable.\n *\n * Import it from the dedicated Node entry point:\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({\n *     proxy: { \"/api\": \"http://127.0.0.1:8000\" },\n * });\n */\nexport function createViteConfig(options: CreateViteConfigOptions = {}): TempestViteConfig {\n    const {\n        srcDir = \"src\",\n        port = 5173,\n        host = \"127.0.0.1\",\n        open = false,\n        proxy,\n        alias = {},\n        plugins = [],\n        icons = true,\n        overrides = {},\n    } = options;\n\n    const overridesConfig = overrides as UserConfig;\n    const iconsPlugin = icons\n        ? [tempestIcons({ dir: srcDir, ...(typeof icons === \"object\" ? icons : {}) })]\n        : [];\n\n    const base: UserConfig = {\n        plugins: [\n            reactPlugin(),\n            ...iconsPlugin,\n            tempestVitest(),\n            ...plugins,\n        ] as UserConfig[\"plugins\"],\n        resolve: {\n            alias: {\n                \"@\": resolve(process.cwd(), srcDir),\n                ...alias,\n            },\n        },\n        server: {\n            port,\n            host,\n            open,\n            ...(proxy ? { proxy: normalizeProxy(proxy) } : {}),\n        },\n    };\n\n    const merged: UserConfig = {\n        ...base,\n        ...overridesConfig,\n        plugins: [...(base.plugins ?? []), ...(overridesConfig.plugins ?? [])],\n        resolve: { ...base.resolve, ...overridesConfig.resolve },\n        server: { ...base.server, ...overridesConfig.server },\n    };\n\n    return defineConfig(merged) as TempestViteConfig;\n}\n"],"mappings":";;;;;AAyDA,SAASA,EAAe,GAAiE;CACrF,IAAMC,IAAoC,CAAC;CAC3C,KAAK,IAAM,CAACC,GAAMC,MAAU,OAAO,QAAQC,CAAK,GAC5C,EAAIF,KACA,OAAOC,KAAU,WACX;EAAE,QAAQA;EAAO,cAAc;CAAK,IACnCA;CAEf,OAAOF;AACX;AAcA,SAASI,IAAqC;CAC1C,OAAO,OAAO,uBAAuB,CAAC,MAAM,MAAWC,EAAO,QAAQ,CAAC;AAC3E;AAmBA,SAAgBC,EAAiB,IAAmC,CAAC,GAAsB;CACvF,IAAM,EACF,YAAS,OACT,UAAO,MACP,UAAO,aACP,UAAO,IACP,UACA,WAAQ,CAAC,GACT,aAAU,CAAC,GACX,WAAQ,IACR,eAAY,CAAC,MACbC,GAEEC,IAAkBC,GAClBC,IAAcC,IACd,CAACC,EAAa;EAAE,KAAKC;EAAQ,GAAI,OAAOF,KAAU,WAAWA,IAAQ,CAAC;CAAG,CAAC,CAAC,IAC3E,CAAC,GAEDG,IAAmB;EACrB,SAAS;GACLV,EAAY;GACZ,GAAGM;GACHK,EAAc;GACd,GAAGC;EACP;EACA,SAAS,EACL,OAAO;GACH,KAAKC,EAAQ,QAAQ,IAAI,GAAGJ,CAAM;GAClC,GAAGK;EACP,EACJ;EACA,QAAQ;GACJ;GACA;GACA;GACA,GAAIf,IAAQ,EAAE,OAAOJ,EAAeI,CAAK,EAAE,IAAI,CAAC;EACpD;CACJ,GAEMgB,IAAqB;EACvB,GAAGL;EACH,GAAGN;EACH,SAAS,CAAC,GAAIM,EAAK,WAAW,CAAC,GAAI,GAAIN,EAAgB,WAAW,CAAC,CAAE;EACrE,SAAS;GAAE,GAAGM,EAAK;GAAS,GAAGN,EAAgB;EAAQ;EACvD,QAAQ;GAAE,GAAGM,EAAK;GAAQ,GAAGN,EAAgB;EAAO;CACxD;CAEA,OAAOY,EAAaD,CAAM;AAC9B"}

package/dist/vite/narrow-tokens.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"narrow-tokens.cjs","names":[],"sources":["../../src/vite/narrow-tokens.ts"],"sourcesContent":["/**\n * Cut the token sheet down to the tokens a set of stylesheets can reach.\n *\n * Once every component loads its own stylesheet, `tokens.css` stops being a rounding\n * error and becomes the biggest single thing an app downloads: measured on a probe\n * app mounting `Button`, `Card` and `Badge`, the sheet is 2516 B brotli of a 4927 B\n * total. The components read 105 of its 223 tokens, so the other 118 are bytes\n * nothing on the page can consult.\n *\n * The cut is a reachability closure, not a filter: a token's value routinely names\n * another token (`--tempest-primary: var(--tempest-primary-500)`), so keeping only\n * the names a stylesheet mentions literally would keep aliases whose targets were\n * dropped — `var()` would resolve to nothing and the component would render with the\n * property unset, which is worse than shipping the whole sheet.\n */\n\n/** A token block: one selector and the custom properties it declares, in order. */\ninterface TokenBlock {\n    /** The block's selector text, e.g. `:root` or `[data-tempest-theme=dark]`. */\n    selector: string;\n    /** Declaration name → value, in source order. */\n    declarations: Map<string, string>;\n}\n\n/**\n * Any custom property being read, not only the `--tempest-*` ones.\n *\n * Deliberately wider than the tokens this cut is about. `tokens.css` also carries\n * the `--lightningcss-light`/`--lightningcss-dark` pair the compiler emits, which\n * nothing reads today — measured: two declarations, zero reads — and which a\n * `--tempest-`-only scan would therefore always drop. That is the right answer right\n * up until one rule uses `light-dark()`, at which point the compiler emits the read\n * and a narrow scan would drop the pair it depends on. Matching every custom\n * property costs nothing (a name the sheet does not declare is discarded) and makes\n * the closure correct for names this file does not know about.\n */\nconst TOKEN_REFERENCE = /var\\(\\s*(--[A-Za-z0-9-]+)/g;\n\n/**\n * A token name being assembled at runtime rather than written out.\n *\n * `style={{ color: `var(--tempest-${tone})` }}` names a token no static scan can\n * know, so a cut made without it would drop the one the app is about to read. The\n * caller falls back to the whole sheet when this matches — the same shape as the\n * plugin's own namespace-import fallback, and for the same reason: serve more than\n * asked for rather than less than needed.\n */\nconst DYNAMIC_TOKEN = /--tempest-[A-Za-z0-9-]*(?:\\$\\{|[\"'`]\\s*\\+|\\s*\\+\\s*[\"'`])/;\n\n/**\n * Parse a token stylesheet into its blocks.\n *\n * Written against the compiler's own output, which is already valid and flat — every\n * block in `tokens.css` is either a bare selector or one nested inside a single\n * at-rule — so a brace-depth reader is enough and a full parser would not be more\n * correct here.\n *\n * @param css - Contents of `tokens.css`.\n * @returns One entry per block that declares anything.\n */\nexport function parseTokenBlocks(css: string): TokenBlock[] {\n    const blocks: TokenBlock[] = [];\n    for (const match of css.matchAll(/([^{}]+)\\{([^{}]*)\\}/g)) {\n        const declarations = new Map<string, string>();\n        for (const declaration of (match[2] ?? \"\").split(\";\")) {\n            const colon = declaration.indexOf(\":\");\n            if (colon < 0) continue;\n            const name = declaration.slice(0, colon).trim();\n            if (name) declarations.set(name, declaration.slice(colon + 1).trim());\n        }\n        if (declarations.size === 0) continue;\n        blocks.push({ selector: (match[1] ?? \"\").trim(), declarations });\n    }\n    return blocks;\n}\n\n/**\n * Every token a body of CSS reaches, following token-to-token references.\n *\n * @param blocks - The parsed token sheet.\n * @param usage - CSS and source text to scan for `var(--tempest-*)`.\n * @returns The reachable token names.\n */\nexport function reachableTokens(blocks: readonly TokenBlock[], usage: string): Set<string> {\n    const declared = new Set<string>();\n    for (const block of blocks) for (const name of block.declarations.keys()) declared.add(name);\n\n    const reached = new Set<string>();\n    const queue = [...usage.matchAll(TOKEN_REFERENCE)].map((match) => match[1] ?? \"\");\n    while (queue.length > 0) {\n        const token = queue.pop() ?? \"\";\n        if (reached.has(token) || !declared.has(token)) continue;\n        reached.add(token);\n        for (const block of blocks) {\n            const value = block.declarations.get(token);\n            if (value === undefined) continue;\n            for (const match of value.matchAll(TOKEN_REFERENCE)) queue.push(match[1] ?? \"\");\n        }\n    }\n    return reached;\n}\n\n/**\n * Rebuild the token sheet with only the tokens a set of stylesheets reaches.\n *\n * Companion declarations that are not custom properties travel with the block that\n * survives — `color-scheme` is the one, and dropping it would leave the browser\n * painting its own surfaces (scrollbar, `<select>` popup, autofill) in the wrong\n * theme while every `.tempest_*` rule was correct.\n *\n * @param tokensCss - Contents of `tokens.css`.\n * @param usage - The CSS the app will load, plus its own source, scanned for reads.\n * @returns The narrowed sheet, or `null` when a token name is built at runtime and\n *   no static answer is safe.\n */\nexport function narrowTokens(tokensCss: string, usage: string): string | null {\n    if (DYNAMIC_TOKEN.test(usage)) return null;\n\n    const blocks = parseTokenBlocks(tokensCss);\n    const reached = reachableTokens(blocks, usage);\n    if (reached.size === 0) return null;\n\n    const out: string[] = [];\n    for (const block of blocks) {\n        const kept = [...block.declarations].filter(\n            ([name]) => name.startsWith(\"--\") === false || reached.has(name),\n        );\n        if (kept.every(([name]) => name.startsWith(\"--\") === false)) continue;\n        out.push(`${block.selector}{${kept.map(([name, value]) => `${name}:${value}`).join(\";\")}}`);\n    }\n    return out.join(\"\\n\");\n}\n"],"mappings":"AAoCA,IAAM,EAAkB,6BAWlB,EAAgB,2DAatB,SAAgB,EAAiB,EAA2B,CACxD,IAAM,EAAuB,CAAC,EAC9B,IAAK,IAAM,KAAS,EAAI,SAAS,uBAAuB,EAAG,CACvD,IAAM,EAAe,IAAI,IACzB,IAAK,IAAM,KAAgB,EAAM,IAAM,GAAA,CAAI,MAAM,GAAG,EAAG,CACnD,IAAM,EAAQ,EAAY,QAAQ,GAAG,EACrC,GAAI,EAAQ,EAAG,SACf,IAAM,EAAO,EAAY,MAAM,EAAG,CAAK,CAAC,CAAC,KAAK,EAC1C,GAAM,EAAa,IAAI,EAAM,EAAY,MAAM,EAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CACxE,CACI,EAAa,OAAS,GAC1B,EAAO,KAAK,CAAE,UAAW,EAAM,IAAM,GAAA,CAAI,KAAK,EAAG,cAAa,CAAC,CACnE,CACA,OAAO,CACX,CASA,SAAgB,EAAgB,EAA+B,EAA4B,CACvF,IAAM,EAAW,IAAI,IACrB,IAAK,IAAM,KAAS,EAAQ,IAAK,IAAM,KAAQ,EAAM,aAAa,KAAK,EAAG,EAAS,IAAI,CAAI,EAE3F,IAAM,EAAU,IAAI,IACd,EAAQ,CAAC,GAAG,EAAM,SAAS,CAAe,CAAC,CAAC,CAAC,IAAK,GAAU,EAAM,IAAM,EAAE,EAChF,KAAO,EAAM,OAAS,GAAG,CACrB,IAAM,EAAQ,EAAM,IAAI,GAAK,GACzB,MAAQ,IAAI,CAAK,GAAM,EAAS,IAAI,CAAK,EAC7C,GAAQ,IAAI,CAAK,EACjB,IAAK,IAAM,KAAS,EAAQ,CACxB,IAAM,EAAQ,EAAM,aAAa,IAAI,CAAK,EACtC,OAAU,IAAA,GACd,IAAK,IAAM,KAAS,EAAM,SAAS,CAAe,EAAG,EAAM,KAAK,EAAM,IAAM,EAAE,CAClF,CALiB,CAMrB,CACA,OAAO,CACX,CAeA,SAAgB,EAAa,EAAmB,EAA8B,CAC1E,GAAI,EAAc,KAAK,CAAK,EAAG,OAAO,KAEtC,IAAM,EAAS,EAAiB,CAAS,EACnC,EAAU,EAAgB,EAAQ,CAAK,EAC7C,GAAI,EAAQ,OAAS,EAAG,OAAO,KAE/B,IAAM,EAAgB,CAAC,EACvB,IAAK,IAAM,KAAS,EAAQ,CACxB,IAAM,EAAO,CAAC,GAAG,EAAM,YAAY,CAAC,CAAC,QAChC,CAAC,KAAU,EAAK,WAAW,IAAI,IAAM,IAAS,EAAQ,IAAI,CAAI,CACnE,EACI,EAAK,OAAO,CAAC,KAAU,EAAK,WAAW,IAAI,IAAM,EAAK,GAC1D,EAAI,KAAK,GAAG,EAAM,SAAS,GAAG,EAAK,KAAK,CAAC,EAAM,KAAW,GAAG,EAAK,GAAG,GAAO,CAAC,CAAC,KAAK,GAAG,EAAE,EAAE,CAC9F,CACA,OAAO,EAAI,KAAK;CAAI,CACxB"}
+{"version":3,"file":"narrow-tokens.cjs","names":["TOKEN_REFERENCE","DYNAMIC_TOKEN","parseTokenBlocks","blocks","match","css","declarations","declaration","colon","name","reachableTokens","declared","block","reached","queue","usage","token","value","narrowTokens","tokensCss","out","kept"],"sources":["../../src/vite/narrow-tokens.ts"],"sourcesContent":["/**\n * Cut the token sheet down to the tokens a set of stylesheets can reach.\n *\n * Once every component loads its own stylesheet, `tokens.css` stops being a rounding\n * error and becomes the biggest single thing an app downloads: measured on a probe\n * app mounting `Button`, `Card` and `Badge`, the sheet is 2516 B brotli of a 4927 B\n * total. The components read 105 of its 223 tokens, so the other 118 are bytes\n * nothing on the page can consult.\n *\n * The cut is a reachability closure, not a filter: a token's value routinely names\n * another token (`--tempest-primary: var(--tempest-primary-500)`), so keeping only\n * the names a stylesheet mentions literally would keep aliases whose targets were\n * dropped — `var()` would resolve to nothing and the component would render with the\n * property unset, which is worse than shipping the whole sheet.\n */\n\n/** A token block: one selector and the custom properties it declares, in order. */\ninterface TokenBlock {\n    /** The block's selector text, e.g. `:root` or `[data-tempest-theme=dark]`. */\n    selector: string;\n    /** Declaration name → value, in source order. */\n    declarations: Map<string, string>;\n}\n\n/**\n * Any custom property being read, not only the `--tempest-*` ones.\n *\n * Deliberately wider than the tokens this cut is about. `tokens.css` also carries\n * the `--lightningcss-light`/`--lightningcss-dark` pair the compiler emits, which\n * nothing reads today — measured: two declarations, zero reads — and which a\n * `--tempest-`-only scan would therefore always drop. That is the right answer right\n * up until one rule uses `light-dark()`, at which point the compiler emits the read\n * and a narrow scan would drop the pair it depends on. Matching every custom\n * property costs nothing (a name the sheet does not declare is discarded) and makes\n * the closure correct for names this file does not know about.\n */\nconst TOKEN_REFERENCE = /var\\(\\s*(--[A-Za-z0-9-]+)/g;\n\n/**\n * A token name being assembled at runtime rather than written out.\n *\n * `style={{ color: `var(--tempest-${tone})` }}` names a token no static scan can\n * know, so a cut made without it would drop the one the app is about to read. The\n * caller falls back to the whole sheet when this matches — the same shape as the\n * plugin's own namespace-import fallback, and for the same reason: serve more than\n * asked for rather than less than needed.\n */\nconst DYNAMIC_TOKEN = /--tempest-[A-Za-z0-9-]*(?:\\$\\{|[\"'`]\\s*\\+|\\s*\\+\\s*[\"'`])/;\n\n/**\n * Parse a token stylesheet into its blocks.\n *\n * Written against the compiler's own output, which is already valid and flat — every\n * block in `tokens.css` is either a bare selector or one nested inside a single\n * at-rule — so a brace-depth reader is enough and a full parser would not be more\n * correct here.\n *\n * @param css - Contents of `tokens.css`.\n * @returns One entry per block that declares anything.\n */\nexport function parseTokenBlocks(css: string): TokenBlock[] {\n    const blocks: TokenBlock[] = [];\n    for (const match of css.matchAll(/([^{}]+)\\{([^{}]*)\\}/g)) {\n        const declarations = new Map<string, string>();\n        for (const declaration of (match[2] ?? \"\").split(\";\")) {\n            const colon = declaration.indexOf(\":\");\n            if (colon < 0) continue;\n            const name = declaration.slice(0, colon).trim();\n            if (name) declarations.set(name, declaration.slice(colon + 1).trim());\n        }\n        if (declarations.size === 0) continue;\n        blocks.push({ selector: (match[1] ?? \"\").trim(), declarations });\n    }\n    return blocks;\n}\n\n/**\n * Every token a body of CSS reaches, following token-to-token references.\n *\n * @param blocks - The parsed token sheet.\n * @param usage - CSS and source text to scan for `var(--tempest-*)`.\n * @returns The reachable token names.\n */\nexport function reachableTokens(blocks: readonly TokenBlock[], usage: string): Set<string> {\n    const declared = new Set<string>();\n    for (const block of blocks) for (const name of block.declarations.keys()) declared.add(name);\n\n    const reached = new Set<string>();\n    const queue = [...usage.matchAll(TOKEN_REFERENCE)].map((match) => match[1] ?? \"\");\n    while (queue.length > 0) {\n        const token = queue.pop() ?? \"\";\n        if (reached.has(token) || !declared.has(token)) continue;\n        reached.add(token);\n        for (const block of blocks) {\n            const value = block.declarations.get(token);\n            if (value === undefined) continue;\n            for (const match of value.matchAll(TOKEN_REFERENCE)) queue.push(match[1] ?? \"\");\n        }\n    }\n    return reached;\n}\n\n/**\n * Rebuild the token sheet with only the tokens a set of stylesheets reaches.\n *\n * Companion declarations that are not custom properties travel with the block that\n * survives — `color-scheme` is the one, and dropping it would leave the browser\n * painting its own surfaces (scrollbar, `<select>` popup, autofill) in the wrong\n * theme while every `.tempest_*` rule was correct.\n *\n * @param tokensCss - Contents of `tokens.css`.\n * @param usage - The CSS the app will load, plus its own source, scanned for reads.\n * @returns The narrowed sheet, or `null` when a token name is built at runtime and\n *   no static answer is safe.\n */\nexport function narrowTokens(tokensCss: string, usage: string): string | null {\n    if (DYNAMIC_TOKEN.test(usage)) return null;\n\n    const blocks = parseTokenBlocks(tokensCss);\n    const reached = reachableTokens(blocks, usage);\n    if (reached.size === 0) return null;\n\n    const out: string[] = [];\n    for (const block of blocks) {\n        const kept = [...block.declarations].filter(\n            ([name]) => name.startsWith(\"--\") === false || reached.has(name),\n        );\n        if (kept.every(([name]) => name.startsWith(\"--\") === false)) continue;\n        out.push(`${block.selector}{${kept.map(([name, value]) => `${name}:${value}`).join(\";\")}}`);\n    }\n    return out.join(\"\\n\");\n}\n"],"mappings":"AAoCA,IAAMA,EAAkB,6BAWlBC,EAAgB,2DAatB,SAAgBC,EAAiB,EAA2B,CACxD,IAAMC,EAAuB,CAAC,EAC9B,IAAK,IAAMC,KAASC,EAAI,SAAS,uBAAuB,EAAG,CACvD,IAAMC,EAAe,IAAI,IACzB,IAAK,IAAMC,KAAgBH,EAAM,IAAM,GAAA,CAAI,MAAM,GAAG,EAAG,CACnD,IAAMI,EAAQD,EAAY,QAAQ,GAAG,EACrC,GAAIC,EAAQ,EAAG,SACf,IAAMC,EAAOF,EAAY,MAAM,EAAGC,CAAK,CAAC,CAAC,KAAK,EAC1CC,GAAMH,EAAa,IAAIG,EAAMF,EAAY,MAAMC,EAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CACxE,CACIF,EAAa,OAAS,GAC1BH,EAAO,KAAK,CAAE,UAAWC,EAAM,IAAM,GAAA,CAAI,KAAK,EAAG,cAAa,CAAC,CACnE,CACA,OAAOD,CACX,CASA,SAAgBO,EAAgB,EAA+B,EAA4B,CACvF,IAAMC,EAAW,IAAI,IACrB,IAAK,IAAMC,KAAST,EAAQ,IAAK,IAAMM,KAAQG,EAAM,aAAa,KAAK,EAAGD,EAAS,IAAIF,CAAI,EAE3F,IAAMI,EAAU,IAAI,IACdC,EAAQ,CAAC,GAAGC,EAAM,SAASf,CAAe,CAAC,CAAC,CAAC,IAAK,GAAUI,EAAM,IAAM,EAAE,EAChF,KAAOU,EAAM,OAAS,GAAG,CACrB,IAAME,EAAQF,EAAM,IAAI,GAAK,GAC7B,GAAI,GAAQ,IAAIE,CAAK,GAAML,EAAS,IAAIK,CAAK,EAC7C,GAAQ,IAAIA,CAAK,EACjB,IAAK,IAAMJ,KAAST,EAAQ,CACxB,IAAMc,EAAQL,EAAM,aAAa,IAAII,CAAK,EAC1C,GAAIC,IAAU,IAAA,GACd,IAAK,IAAMb,KAASa,EAAM,SAASjB,CAAe,EAAGc,EAAM,KAAKV,EAAM,IAAM,EAAE,CAClF,CALiB,CAMrB,CACA,OAAOS,CACX,CAeA,SAAgBK,EAAa,EAAmB,EAA8B,CAC1E,GAAIjB,EAAc,KAAKc,CAAK,EAAG,OAAO,KAEtC,IAAMZ,EAASD,EAAiBiB,CAAS,EACnCN,EAAUH,EAAgBP,EAAQY,CAAK,EAC7C,GAAIF,EAAQ,OAAS,EAAG,OAAO,KAE/B,IAAMO,EAAgB,CAAC,EACvB,IAAK,IAAMR,KAAST,EAAQ,CACxB,IAAMkB,EAAO,CAAC,GAAGT,EAAM,YAAY,CAAC,CAAC,QAChC,CAACH,KAAUA,EAAK,WAAW,IAAI,IAAM,IAASI,EAAQ,IAAIJ,CAAI,CACnE,EACIY,EAAK,OAAO,CAACZ,KAAUA,EAAK,WAAW,IAAI,IAAM,EAAK,GAC1DW,EAAI,KAAK,GAAGR,EAAM,SAAS,GAAGS,EAAK,KAAK,CAACZ,EAAMQ,KAAW,GAAGR,EAAK,GAAGQ,GAAO,CAAC,CAAC,KAAK,GAAG,EAAE,EAAE,CAC9F,CACA,OAAOG,EAAI,KAAK;CAAI,CACxB,C"}

package/dist/vite/narrow-tokens.js.map

@@ -1 +1 @@
-{"version":3,"file":"narrow-tokens.js","names":[],"sources":["../../src/vite/narrow-tokens.ts"],"sourcesContent":["/**\n * Cut the token sheet down to the tokens a set of stylesheets can reach.\n *\n * Once every component loads its own stylesheet, `tokens.css` stops being a rounding\n * error and becomes the biggest single thing an app downloads: measured on a probe\n * app mounting `Button`, `Card` and `Badge`, the sheet is 2516 B brotli of a 4927 B\n * total. The components read 105 of its 223 tokens, so the other 118 are bytes\n * nothing on the page can consult.\n *\n * The cut is a reachability closure, not a filter: a token's value routinely names\n * another token (`--tempest-primary: var(--tempest-primary-500)`), so keeping only\n * the names a stylesheet mentions literally would keep aliases whose targets were\n * dropped — `var()` would resolve to nothing and the component would render with the\n * property unset, which is worse than shipping the whole sheet.\n */\n\n/** A token block: one selector and the custom properties it declares, in order. */\ninterface TokenBlock {\n    /** The block's selector text, e.g. `:root` or `[data-tempest-theme=dark]`. */\n    selector: string;\n    /** Declaration name → value, in source order. */\n    declarations: Map<string, string>;\n}\n\n/**\n * Any custom property being read, not only the `--tempest-*` ones.\n *\n * Deliberately wider than the tokens this cut is about. `tokens.css` also carries\n * the `--lightningcss-light`/`--lightningcss-dark` pair the compiler emits, which\n * nothing reads today — measured: two declarations, zero reads — and which a\n * `--tempest-`-only scan would therefore always drop. That is the right answer right\n * up until one rule uses `light-dark()`, at which point the compiler emits the read\n * and a narrow scan would drop the pair it depends on. Matching every custom\n * property costs nothing (a name the sheet does not declare is discarded) and makes\n * the closure correct for names this file does not know about.\n */\nconst TOKEN_REFERENCE = /var\\(\\s*(--[A-Za-z0-9-]+)/g;\n\n/**\n * A token name being assembled at runtime rather than written out.\n *\n * `style={{ color: `var(--tempest-${tone})` }}` names a token no static scan can\n * know, so a cut made without it would drop the one the app is about to read. The\n * caller falls back to the whole sheet when this matches — the same shape as the\n * plugin's own namespace-import fallback, and for the same reason: serve more than\n * asked for rather than less than needed.\n */\nconst DYNAMIC_TOKEN = /--tempest-[A-Za-z0-9-]*(?:\\$\\{|[\"'`]\\s*\\+|\\s*\\+\\s*[\"'`])/;\n\n/**\n * Parse a token stylesheet into its blocks.\n *\n * Written against the compiler's own output, which is already valid and flat — every\n * block in `tokens.css` is either a bare selector or one nested inside a single\n * at-rule — so a brace-depth reader is enough and a full parser would not be more\n * correct here.\n *\n * @param css - Contents of `tokens.css`.\n * @returns One entry per block that declares anything.\n */\nexport function parseTokenBlocks(css: string): TokenBlock[] {\n    const blocks: TokenBlock[] = [];\n    for (const match of css.matchAll(/([^{}]+)\\{([^{}]*)\\}/g)) {\n        const declarations = new Map<string, string>();\n        for (const declaration of (match[2] ?? \"\").split(\";\")) {\n            const colon = declaration.indexOf(\":\");\n            if (colon < 0) continue;\n            const name = declaration.slice(0, colon).trim();\n            if (name) declarations.set(name, declaration.slice(colon + 1).trim());\n        }\n        if (declarations.size === 0) continue;\n        blocks.push({ selector: (match[1] ?? \"\").trim(), declarations });\n    }\n    return blocks;\n}\n\n/**\n * Every token a body of CSS reaches, following token-to-token references.\n *\n * @param blocks - The parsed token sheet.\n * @param usage - CSS and source text to scan for `var(--tempest-*)`.\n * @returns The reachable token names.\n */\nexport function reachableTokens(blocks: readonly TokenBlock[], usage: string): Set<string> {\n    const declared = new Set<string>();\n    for (const block of blocks) for (const name of block.declarations.keys()) declared.add(name);\n\n    const reached = new Set<string>();\n    const queue = [...usage.matchAll(TOKEN_REFERENCE)].map((match) => match[1] ?? \"\");\n    while (queue.length > 0) {\n        const token = queue.pop() ?? \"\";\n        if (reached.has(token) || !declared.has(token)) continue;\n        reached.add(token);\n        for (const block of blocks) {\n            const value = block.declarations.get(token);\n            if (value === undefined) continue;\n            for (const match of value.matchAll(TOKEN_REFERENCE)) queue.push(match[1] ?? \"\");\n        }\n    }\n    return reached;\n}\n\n/**\n * Rebuild the token sheet with only the tokens a set of stylesheets reaches.\n *\n * Companion declarations that are not custom properties travel with the block that\n * survives — `color-scheme` is the one, and dropping it would leave the browser\n * painting its own surfaces (scrollbar, `<select>` popup, autofill) in the wrong\n * theme while every `.tempest_*` rule was correct.\n *\n * @param tokensCss - Contents of `tokens.css`.\n * @param usage - The CSS the app will load, plus its own source, scanned for reads.\n * @returns The narrowed sheet, or `null` when a token name is built at runtime and\n *   no static answer is safe.\n */\nexport function narrowTokens(tokensCss: string, usage: string): string | null {\n    if (DYNAMIC_TOKEN.test(usage)) return null;\n\n    const blocks = parseTokenBlocks(tokensCss);\n    const reached = reachableTokens(blocks, usage);\n    if (reached.size === 0) return null;\n\n    const out: string[] = [];\n    for (const block of blocks) {\n        const kept = [...block.declarations].filter(\n            ([name]) => name.startsWith(\"--\") === false || reached.has(name),\n        );\n        if (kept.every(([name]) => name.startsWith(\"--\") === false)) continue;\n        out.push(`${block.selector}{${kept.map(([name, value]) => `${name}:${value}`).join(\";\")}}`);\n    }\n    return out.join(\"\\n\");\n}\n"],"mappings":";AAoCA,IAAM,IAAkB,8BAWlB,IAAgB;AAatB,SAAgB,EAAiB,GAA2B;CACxD,IAAM,IAAuB,CAAC;CAC9B,KAAK,IAAM,KAAS,EAAI,SAAS,uBAAuB,GAAG;EACvD,IAAM,oBAAe,IAAI,IAAoB;EAC7C,KAAK,IAAM,MAAgB,EAAM,MAAM,GAAA,CAAI,MAAM,GAAG,GAAG;GACnD,IAAM,IAAQ,EAAY,QAAQ,GAAG;GACrC,IAAI,IAAQ,GAAG;GACf,IAAM,IAAO,EAAY,MAAM,GAAG,CAAK,CAAC,CAAC,KAAK;GAC9C,AAAI,KAAM,EAAa,IAAI,GAAM,EAAY,MAAM,IAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;EACxE;EACI,EAAa,SAAS,KAC1B,EAAO,KAAK;GAAE,WAAW,EAAM,MAAM,GAAA,CAAI,KAAK;GAAG;EAAa,CAAC;CACnE;CACA,OAAO;AACX;AASA,SAAgB,EAAgB,GAA+B,GAA4B;CACvF,IAAM,oBAAW,IAAI,IAAY;CACjC,KAAK,IAAM,KAAS,GAAQ,KAAK,IAAM,KAAQ,EAAM,aAAa,KAAK,GAAG,EAAS,IAAI,CAAI;CAE3F,IAAM,oBAAU,IAAI,IAAY,GAC1B,IAAQ,CAAC,GAAG,EAAM,SAAS,CAAe,CAAC,CAAC,CAAC,KAAK,MAAU,EAAM,MAAM,EAAE;CAChF,OAAO,EAAM,SAAS,IAAG;EACrB,IAAM,IAAQ,EAAM,IAAI,KAAK;EACzB,OAAQ,IAAI,CAAK,KAAM,EAAS,IAAI,CAAK,GAC7C;KAAQ,IAAI,CAAK;GACjB,KAAK,IAAM,KAAS,GAAQ;IACxB,IAAM,IAAQ,EAAM,aAAa,IAAI,CAAK;IACtC,UAAU,KAAA,GACd,KAAK,IAAM,KAAS,EAAM,SAAS,CAAe,GAAG,EAAM,KAAK,EAAM,MAAM,EAAE;GAClF;EALiB;CAMrB;CACA,OAAO;AACX;AAeA,SAAgB,EAAa,GAAmB,GAA8B;CAC1E,IAAI,EAAc,KAAK,CAAK,GAAG,OAAO;CAEtC,IAAM,IAAS,EAAiB,CAAS,GACnC,IAAU,EAAgB,GAAQ,CAAK;CAC7C,IAAI,EAAQ,SAAS,GAAG,OAAO;CAE/B,IAAM,IAAgB,CAAC;CACvB,KAAK,IAAM,KAAS,GAAQ;EACxB,IAAM,IAAO,CAAC,GAAG,EAAM,YAAY,CAAC,CAAC,QAChC,CAAC,OAAU,EAAK,WAAW,IAAI,MAAM,MAAS,EAAQ,IAAI,CAAI,CACnE;EACI,EAAK,OAAO,CAAC,OAAU,EAAK,WAAW,IAAI,MAAM,EAAK,KAC1D,EAAI,KAAK,GAAG,EAAM,SAAS,GAAG,EAAK,KAAK,CAAC,GAAM,OAAW,GAAG,EAAK,GAAG,GAAO,CAAC,CAAC,KAAK,GAAG,EAAE,EAAE;CAC9F;CACA,OAAO,EAAI,KAAK,IAAI;AACxB"}
+{"version":3,"file":"narrow-tokens.js","names":["TOKEN_REFERENCE","DYNAMIC_TOKEN","parseTokenBlocks","blocks","match","css","declarations","declaration","colon","name","reachableTokens","declared","block","reached","queue","usage","token","value","narrowTokens","tokensCss","out","kept"],"sources":["../../src/vite/narrow-tokens.ts"],"sourcesContent":["/**\n * Cut the token sheet down to the tokens a set of stylesheets can reach.\n *\n * Once every component loads its own stylesheet, `tokens.css` stops being a rounding\n * error and becomes the biggest single thing an app downloads: measured on a probe\n * app mounting `Button`, `Card` and `Badge`, the sheet is 2516 B brotli of a 4927 B\n * total. The components read 105 of its 223 tokens, so the other 118 are bytes\n * nothing on the page can consult.\n *\n * The cut is a reachability closure, not a filter: a token's value routinely names\n * another token (`--tempest-primary: var(--tempest-primary-500)`), so keeping only\n * the names a stylesheet mentions literally would keep aliases whose targets were\n * dropped — `var()` would resolve to nothing and the component would render with the\n * property unset, which is worse than shipping the whole sheet.\n */\n\n/** A token block: one selector and the custom properties it declares, in order. */\ninterface TokenBlock {\n    /** The block's selector text, e.g. `:root` or `[data-tempest-theme=dark]`. */\n    selector: string;\n    /** Declaration name → value, in source order. */\n    declarations: Map<string, string>;\n}\n\n/**\n * Any custom property being read, not only the `--tempest-*` ones.\n *\n * Deliberately wider than the tokens this cut is about. `tokens.css` also carries\n * the `--lightningcss-light`/`--lightningcss-dark` pair the compiler emits, which\n * nothing reads today — measured: two declarations, zero reads — and which a\n * `--tempest-`-only scan would therefore always drop. That is the right answer right\n * up until one rule uses `light-dark()`, at which point the compiler emits the read\n * and a narrow scan would drop the pair it depends on. Matching every custom\n * property costs nothing (a name the sheet does not declare is discarded) and makes\n * the closure correct for names this file does not know about.\n */\nconst TOKEN_REFERENCE = /var\\(\\s*(--[A-Za-z0-9-]+)/g;\n\n/**\n * A token name being assembled at runtime rather than written out.\n *\n * `style={{ color: `var(--tempest-${tone})` }}` names a token no static scan can\n * know, so a cut made without it would drop the one the app is about to read. The\n * caller falls back to the whole sheet when this matches — the same shape as the\n * plugin's own namespace-import fallback, and for the same reason: serve more than\n * asked for rather than less than needed.\n */\nconst DYNAMIC_TOKEN = /--tempest-[A-Za-z0-9-]*(?:\\$\\{|[\"'`]\\s*\\+|\\s*\\+\\s*[\"'`])/;\n\n/**\n * Parse a token stylesheet into its blocks.\n *\n * Written against the compiler's own output, which is already valid and flat — every\n * block in `tokens.css` is either a bare selector or one nested inside a single\n * at-rule — so a brace-depth reader is enough and a full parser would not be more\n * correct here.\n *\n * @param css - Contents of `tokens.css`.\n * @returns One entry per block that declares anything.\n */\nexport function parseTokenBlocks(css: string): TokenBlock[] {\n    const blocks: TokenBlock[] = [];\n    for (const match of css.matchAll(/([^{}]+)\\{([^{}]*)\\}/g)) {\n        const declarations = new Map<string, string>();\n        for (const declaration of (match[2] ?? \"\").split(\";\")) {\n            const colon = declaration.indexOf(\":\");\n            if (colon < 0) continue;\n            const name = declaration.slice(0, colon).trim();\n            if (name) declarations.set(name, declaration.slice(colon + 1).trim());\n        }\n        if (declarations.size === 0) continue;\n        blocks.push({ selector: (match[1] ?? \"\").trim(), declarations });\n    }\n    return blocks;\n}\n\n/**\n * Every token a body of CSS reaches, following token-to-token references.\n *\n * @param blocks - The parsed token sheet.\n * @param usage - CSS and source text to scan for `var(--tempest-*)`.\n * @returns The reachable token names.\n */\nexport function reachableTokens(blocks: readonly TokenBlock[], usage: string): Set<string> {\n    const declared = new Set<string>();\n    for (const block of blocks) for (const name of block.declarations.keys()) declared.add(name);\n\n    const reached = new Set<string>();\n    const queue = [...usage.matchAll(TOKEN_REFERENCE)].map((match) => match[1] ?? \"\");\n    while (queue.length > 0) {\n        const token = queue.pop() ?? \"\";\n        if (reached.has(token) || !declared.has(token)) continue;\n        reached.add(token);\n        for (const block of blocks) {\n            const value = block.declarations.get(token);\n            if (value === undefined) continue;\n            for (const match of value.matchAll(TOKEN_REFERENCE)) queue.push(match[1] ?? \"\");\n        }\n    }\n    return reached;\n}\n\n/**\n * Rebuild the token sheet with only the tokens a set of stylesheets reaches.\n *\n * Companion declarations that are not custom properties travel with the block that\n * survives — `color-scheme` is the one, and dropping it would leave the browser\n * painting its own surfaces (scrollbar, `<select>` popup, autofill) in the wrong\n * theme while every `.tempest_*` rule was correct.\n *\n * @param tokensCss - Contents of `tokens.css`.\n * @param usage - The CSS the app will load, plus its own source, scanned for reads.\n * @returns The narrowed sheet, or `null` when a token name is built at runtime and\n *   no static answer is safe.\n */\nexport function narrowTokens(tokensCss: string, usage: string): string | null {\n    if (DYNAMIC_TOKEN.test(usage)) return null;\n\n    const blocks = parseTokenBlocks(tokensCss);\n    const reached = reachableTokens(blocks, usage);\n    if (reached.size === 0) return null;\n\n    const out: string[] = [];\n    for (const block of blocks) {\n        const kept = [...block.declarations].filter(\n            ([name]) => name.startsWith(\"--\") === false || reached.has(name),\n        );\n        if (kept.every(([name]) => name.startsWith(\"--\") === false)) continue;\n        out.push(`${block.selector}{${kept.map(([name, value]) => `${name}:${value}`).join(\";\")}}`);\n    }\n    return out.join(\"\\n\");\n}\n"],"mappings":";AAoCA,IAAMA,IAAkB,8BAWlBC,IAAgB;AAatB,SAAgBC,EAAiB,GAA2B;CACxD,IAAMC,IAAuB,CAAC;CAC9B,KAAK,IAAMC,KAASC,EAAI,SAAS,uBAAuB,GAAG;EACvD,IAAMC,oBAAe,IAAI,IAAoB;EAC7C,KAAK,IAAMC,MAAgBH,EAAM,MAAM,GAAA,CAAI,MAAM,GAAG,GAAG;GACnD,IAAMI,IAAQD,EAAY,QAAQ,GAAG;GACrC,IAAIC,IAAQ,GAAG;GACf,IAAMC,IAAOF,EAAY,MAAM,GAAGC,CAAK,CAAC,CAAC,KAAK;GAC9C,AAAIC,KAAMH,EAAa,IAAIG,GAAMF,EAAY,MAAMC,IAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;EACxE;EACA,AAAIF,EAAa,SAAS,KAC1BH,EAAO,KAAK;GAAE,WAAWC,EAAM,MAAM,GAAA,CAAI,KAAK;GAAG;EAAa,CAAC;CACnE;CACA,OAAOD;AACX;AASA,SAAgBO,EAAgB,GAA+B,GAA4B;CACvF,IAAMC,oBAAW,IAAI,IAAY;CACjC,KAAK,IAAMC,KAAST,GAAQ,KAAK,IAAMM,KAAQG,EAAM,aAAa,KAAK,GAAG,EAAS,IAAIH,CAAI;CAE3F,IAAMI,oBAAU,IAAI,IAAY,GAC1BC,IAAQ,CAAC,GAAGC,EAAM,SAASf,CAAe,CAAC,CAAC,CAAC,KAAK,MAAUI,EAAM,MAAM,EAAE;CAChF,OAAOU,EAAM,SAAS,IAAG;EACrB,IAAME,IAAQF,EAAM,IAAI,KAAK;EAC7B,IAAI,GAAQ,IAAIE,CAAK,KAAML,EAAS,IAAIK,CAAK,GAC7C;KAAQ,IAAIA,CAAK;GACjB,KAAK,IAAMJ,KAAST,GAAQ;IACxB,IAAMc,IAAQL,EAAM,aAAa,IAAII,CAAK;IAC1C,IAAIC,MAAU,KAAA,GACd,KAAK,IAAMb,KAASa,EAAM,SAASjB,CAAe,GAAG,EAAM,KAAKI,EAAM,MAAM,EAAE;GAClF;EALiB;CAMrB;CACA,OAAOS;AACX;AAeA,SAAgBK,EAAa,GAAmB,GAA8B;CAC1E,IAAIjB,EAAc,KAAKc,CAAK,GAAG,OAAO;CAEtC,IAAMZ,IAASD,EAAiBiB,CAAS,GACnCN,IAAUH,EAAgBP,GAAQY,CAAK;CAC7C,IAAIF,EAAQ,SAAS,GAAG,OAAO;CAE/B,IAAMO,IAAgB,CAAC;CACvB,KAAK,IAAMR,KAAST,GAAQ;EACxB,IAAMkB,IAAO,CAAC,GAAGT,EAAM,YAAY,CAAC,CAAC,QAChC,CAACH,OAAUA,EAAK,WAAW,IAAI,MAAM,MAASI,EAAQ,IAAIJ,CAAI,CACnE;EACA,AAAIY,EAAK,OAAO,CAACZ,OAAUA,EAAK,WAAW,IAAI,MAAM,EAAK,KAC1DW,EAAI,KAAK,GAAGR,EAAM,SAAS,GAAGS,EAAK,KAAK,CAACZ,GAAMQ,OAAW,GAAGR,EAAK,GAAGQ,GAAO,CAAC,CAAC,KAAK,GAAG,EAAE,EAAE;CAC9F;CACA,OAAOG,EAAI,KAAK,IAAI;AACxB"}

package/dist/vite/tempest-csp.cjs

@@ -1,3 +1,3 @@
-let e=require("node:crypto");var t=new Set([`frame-ancestors`,`report-uri`,`sandbox`]),n=[{module:/[\\/]forms[\\/]use-viacep\.(?:[cm]?js|tsx?)$/,origin:`https://viacep.com.br`,from:`tempest-react-sdk useViaCEP`}],r={"script-src-elem":[`script-src`,`default-src`],"script-src-attr":[`script-src`,`default-src`],"style-src-elem":[`style-src`,`default-src`],"style-src-attr":[`style-src`,`default-src`],"worker-src":[`child-src`,`script-src`,`default-src`],"frame-src":[`child-src`,`default-src`],"fenced-frame-src":[`frame-src`,`child-src`,`default-src`],"child-src":[`default-src`],"connect-src":[`default-src`],"font-src":[`default-src`],"img-src":[`default-src`],"manifest-src":[`default-src`],"media-src":[`default-src`],"object-src":[`default-src`],"prefetch-src":[`default-src`],"script-src":[`default-src`],"style-src":[`default-src`]};function i(e,t){for(let n of r[t]??[])if(n in e)return e[n]}var a=/^(?:https?|wss?):\/\//i,o=/^((?:https?|wss?):\/\/\*\.[a-z0-9.-]+(?::\d+)?)(?:[/?#].*)?$/i;function s(e,t){let n=e.trim();if(n.startsWith(`/`)&&!n.startsWith(`//`))return;let r=o.exec(n);if(r)return r[1].toLowerCase();if(a.test(n))try{let e=new URL(n);return`${e.protocol}//${e.host}`}catch{throw Error(`tempestCsp: ${t} is not a valid URL: "${e}"`)}throw Error(`tempestCsp: ${t} must be an absolute http(s)/ws(s) URL or a root-relative path, got "${e}"`)}function c(e){let t={};for(let n of e.split(`;`)){let[e,...r]=n.trim().split(/\s+/);if(!e)continue;let i=e.toLowerCase();i in t||(t[i]=r)}return t}function l(e,n){return Object.entries(e).filter(([e])=>n===`header`||!t.has(e)).map(([e,t])=>[e,...t].join(` `)).join(`; `)}function u(e,t){return e.toLowerCase()===t}function d(e){return e.every(e=>u(e,`'none'`))}function f(e){return e.replace(/^'(?:sha\d{3}|nonce)-/i,e=>e.toLowerCase())}function p(e,t){let n=e.filter(e=>!u(e,`'none'`)||t.length===0);for(let e of t)n.includes(e)||n.push(e);return n.length===0?[`'none'`]:n}function m(t){return`'sha256-${(0,e.createHash)(`sha256`).update(t,`utf8`).digest(`base64`)}'`}function h(e){return e.replace(/&#39;|&#x27;|&apos;/gi,`'`).replace(/&quot;/gi,`"`).replace(/&amp;/gi,`&`)}function g(e){let t={};for(let n of e.matchAll(/([^\s=<>/]+)\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/g))t[n[1].toLowerCase()]=h(n[2]??n[3]??n[4]??``);return t}function _(e){let t=[...e.matchAll(/<meta\b[^>]*>/gi)].filter(e=>g(e[0])[`http-equiv`]?.toLowerCase()===`content-security-policy`);if(t.length===0)return{html:e};if(t.length>1)throw Error(`tempestCsp: index.html declares more than one Content-Security-Policy <meta>; merge them into one`);let n=t[0];return{html:e.slice(0,n.index)+e.slice(n.index+n[0].length).replace(/^[ \t]*\r?\n/,``),declared:c(g(n[0]).content??``)}}function v(e,t){let n=RegExp(`<${t}\\b([^>]*)>([\\s\\S]*?)</${t}>`,`gi`),r=[];for(let i of e.matchAll(n)){let e=g(`<x ${i[1]}>`);if(t===`script`&&`src`in e||i[2].length===0)continue;let n=m(i[2]);r.includes(n)||r.push(n)}return r}function y(e,t){let n=`<meta http-equiv="Content-Security-Policy" content="${t.replace(/&/g,`&amp;`).replace(/"/g,`&quot;`)}" />`,r=/<meta\b[^>]*\bcharset\s*=[^>]*>/i.exec(e),i=/<head\b[^>]*>/i.exec(e),a=r!==null&&i!==null&&/<(?:script|link|style)\b/i.test(e.slice(i.index,r.index)),o=r&&i&&r.index>i.index&&!a?r:i;if(!o)return`${n}\n${e}`;let s=o.index+o[0].length;return`${e.slice(0,s)}\n    ${n}${e.slice(s)}`}function b(e){let t=[];for(let n of Object.values(e.bundle??{}))n.type===`chunk`&&t.push(...n.moduleIds??Object.keys(n.modules??{}));return t}function x(e={}){let{connect:t=[],env:r=!0,sockets:o=!0,wasm:c=!0,inlineStyles:m=!0,directives:h={},dev:g=!0,log:x=!0,onPolicy:S}=e,C=Object.fromEntries(Object.entries(h).map(([e,t])=>[e.toLowerCase(),t])),w,T=[],E=``;function D(e,t,n){t===void 0||e.some(e=>e.origin===t)||e.push({origin:t,from:n})}function O(e){let n=[],i=e.env??{},o=[e.envPrefix??`VITE_`].flat();if(r===!0)for(let[e,t]of Object.entries(i))o.some(t=>e.startsWith(t))&&typeof t==`string`&&a.test(t.trim())&&D(n,s(t,`env ${e}`),`env ${e}`);else if(Array.isArray(r))for(let t of r){let r=i[t];if(typeof r!=`string`||r.trim()===``){e.logger.warn(`tempestCsp: env ${t} is empty — nothing added to connect-src`);continue}D(n,s(r,`env ${t}`),`env ${t}`)}return t.forEach((t,r)=>{if(!t||t.trim()===``){e.logger.warn(`tempestCsp: connect[${r}] is empty — skipped, nothing added to connect-src`);return}D(n,s(t,`connect[${r}]`),`connect[${r}]`)}),n}function k(e){let t=[...e];if(!o)return t;for(let{origin:n}of e){let e=n.replace(/^http(s?):/i,`ws$1:`);e!==n&&D(t,e,`sockets (${n})`)}return t}function A(e,t){let n=e?[`'self'`,e]:[`'self'`],r={"default-src":[...n],"script-src":c?[...n,`'wasm-unsafe-eval'`]:[...n],"style-src":m||t?[...n,`'unsafe-inline'`]:[...n],"img-src":[...n,`data:`,`blob:`],"font-src":[...n,`data:`],"media-src":[...n,`blob:`],"connect-src":[`'self'`,`blob:`,`data:`],"worker-src":[...n,`blob:`],"manifest-src":[...n],"object-src":[`'none'`],"base-uri":[`'self'`],"form-action":[`'self'`]};for(let[e,t]of Object.entries(C))t===!1?delete r[e]:r[e]=p(r[e]??[],t);return r}function j(e,t){let n={};for(let[r,a]of Object.entries(e)){if(r in t){n[r]=t[r];continue}let e=i(t,r),o=C[r];e===void 0?n[r]=a:Array.isArray(o)?n[r]=p(e,o):a.length>0&&d(a)&&(n[r]=a)}for(let[e,r]of Object.entries(t))n[e]??=r;for(let[e,r]of Object.entries(C)){if(!(e in t))continue;if(r===!1){delete n[e];continue}let i=r.filter(n=>!t[e].includes(n));i.length>0&&w?.logger.warn(`tempestCsp: index.html declares ${e}, so directives["${e}"] is not added to it (${i.join(` `)}); the plugin never loosens a declared policy — add them to the <meta> instead`)}return n}function M(e,t,n){if(!n||!w)return;let r=n.map(f);if(n.some(e=>u(e,`'unsafe-inline'`))&&!r.some(e=>/^'(?:sha\d{3}|nonce)-/.test(e)))return;let i=v(e,`script`).filter(e=>!r.includes(e));i.length!==0&&w.logger.warn(`tempestCsp: the Content-Security-Policy declared in index.html blocks ${i.length} inline <script> (${t} ${n.join(` `)}); the plugin never loosens a declared policy, so add ${i.join(` `)} to ${t}`)}return{name:`tempest-csp`,configResolved(e){w=e,T=O(e)},transformIndexHtml:{order:`post`,handler(e,t){let r=w?.command===`serve`;if(r&&!g)return e;let o=k(T),c=w?.base??`/`,f=a.test(c)?s(c,`base`):void 0;f&&D(o,f,`base`);let m=r?[]:b(t);for(let e of n)(r||m.some(t=>e.module.test(t)))&&D(o,e.origin,e.from);let h=o,{html:C,declared:O={}}=_(e),N=A(f,r),P=e=>!(e in O)&&i(O,e)===void 0;P(`script-src`)&&!(`script-src-elem`in O)&&(N[`script-src`]=p(N[`script-src`]??[],v(C,`script`))),P(`style-src`)&&!(`style-src-elem`in O)&&!N[`style-src`]?.some(e=>u(e,`'unsafe-inline'`))&&(N[`style-src`]=p(N[`style-src`]??[],v(C,`style`)));let F=j(N,O),I=h.map(e=>e.origin),L=i(O,`connect-src`),R=F[`connect-src`]??L;R!==void 0&&d(R)&&(`connect-src`in O||L!==void 0)?I.length>0&&w?.logger.warn(`tempestCsp: index.html declares connect-src ${R.join(` `)||`with no source`}${`connect-src`in O?``:` (through default-src)`}, so these origins stay out and requests to them will be blocked: ${I.join(` `)}`):(`connect-src`in F||I.length>0||L===void 0)&&(F[`connect-src`]=p(R??[`'self'`],I));let z=`script-src-elem`in O?`script-src-elem`:`script-src`;M(C,z,F[z]??i(O,z));let B={directives:F,meta:l(F,`meta`),header:l(F,`header`),connect:h,command:r?`serve`:`build`};if(x&&w&&B.header!==E){E=B.header;let e=h.map(e=>`  ${e.origin}  ← ${e.from}`);w.logger.info([`tempest-csp: connect-src ${(F[`connect-src`]??L??[]).join(` `)}`,...e.length>0?e:[`  (no cross-origin endpoint: only 'self')`]].join(`
+let e=require("node:crypto");var t=new Set([`frame-ancestors`,`report-uri`,`sandbox`]),n=[{module:/[\\/]forms[\\/]use-viacep\.(?:[cm]?js|tsx?)$/,origin:`https://viacep.com.br`,from:`tempest-react-sdk useViaCEP`}],r={"script-src-elem":[`script-src`,`default-src`],"script-src-attr":[`script-src`,`default-src`],"style-src-elem":[`style-src`,`default-src`],"style-src-attr":[`style-src`,`default-src`],"worker-src":[`child-src`,`script-src`,`default-src`],"frame-src":[`child-src`,`default-src`],"fenced-frame-src":[`frame-src`,`child-src`,`default-src`],"child-src":[`default-src`],"connect-src":[`default-src`],"font-src":[`default-src`],"img-src":[`default-src`],"manifest-src":[`default-src`],"media-src":[`default-src`],"object-src":[`default-src`],"prefetch-src":[`default-src`],"script-src":[`default-src`],"style-src":[`default-src`]};function i(e,t){for(let n of r[t]??[])if(n in e)return e[n]}var a=/^(?:https?|wss?):\/\//i,o=/^((?:https?|wss?):\/\/\*\.[a-z0-9.-]+(?::\d+)?)(?:[/?#].*)?$/i;function s(e,t){let n=e.trim();if(n.startsWith(`/`)&&!n.startsWith(`//`))return;let r=o.exec(n);if(r)return r[1].toLowerCase();if(a.test(n))try{let e=new URL(n);return`${e.protocol}//${e.host}`}catch{throw Error(`tempestCsp: ${t} is not a valid URL: "${e}"`)}throw Error(`tempestCsp: ${t} must be an absolute http(s)/ws(s) URL or a root-relative path, got "${e}"`)}function c(e){let t={};for(let n of e.split(`;`)){let[e,...r]=n.trim().split(/\s+/);if(!e)continue;let i=e.toLowerCase();i in t||(t[i]=r)}return t}function l(e,n){return Object.entries(e).filter(([e])=>n===`header`||!t.has(e)).map(([e,t])=>[e,...t].join(` `)).join(`; `)}function u(e,t){return e.toLowerCase()===t}function d(e){return e.every(e=>u(e,`'none'`))}function f(e){return e.replace(/^'(?:sha\d{3}|nonce)-/i,e=>e.toLowerCase())}function p(e,t){let n=e.filter(e=>!u(e,`'none'`)||t.length===0);for(let e of t)n.includes(e)||n.push(e);return n.length===0?[`'none'`]:n}function m(t){return`'sha256-${(0,e.createHash)(`sha256`).update(t,`utf8`).digest(`base64`)}'`}function h(e){return e.replace(/&#39;|&#x27;|&apos;/gi,`'`).replace(/&quot;/gi,`"`).replace(/&amp;/gi,`&`)}function g(e){let t={};for(let n of e.matchAll(/([^\s=<>/]+)\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/g))t[n[1].toLowerCase()]=h(n[2]??n[3]??n[4]??``);return t}function _(e){let t=[...e.matchAll(/<meta\b[^>]*>/gi)].filter(e=>g(e[0])[`http-equiv`]?.toLowerCase()===`content-security-policy`);if(t.length===0)return{html:e};if(t.length>1)throw Error(`tempestCsp: index.html declares more than one Content-Security-Policy <meta>; merge them into one`);let n=t[0];return{html:e.slice(0,n.index)+e.slice(n.index+n[0].length).replace(/^[ \t]*\r?\n/,``),declared:c(g(n[0]).content??``)}}function v(e,t){let n=RegExp(`<${t}\\b([^>]*)>([\\s\\S]*?)</${t}>`,`gi`),r=[];for(let i of e.matchAll(n)){let e=g(`<x ${i[1]}>`);if(t===`script`&&`src`in e||i[2].length===0)continue;let n=m(i[2]);r.includes(n)||r.push(n)}return r}function y(e,t){let n=`<meta http-equiv="Content-Security-Policy" content="${t.replace(/&/g,`&amp;`).replace(/"/g,`&quot;`)}" />`,r=/<meta\b[^>]*\bcharset\s*=[^>]*>/i.exec(e),i=/<head\b[^>]*>/i.exec(e),a=r!==null&&i!==null&&/<(?:script|link|style)\b/i.test(e.slice(i.index,r.index)),o=r&&i&&r.index>i.index&&!a?r:i;if(!o)return`${n}\n${e}`;let s=o.index+o[0].length;return`${e.slice(0,s)}\n    ${n}${e.slice(s)}`}function b(e){let t=[];for(let n of Object.values(e.bundle??{}))n.type===`chunk`&&t.push(...n.moduleIds??Object.keys(n.modules??{}));return t}function x(e={}){let{connect:t=[],env:r=!0,sockets:o=!0,wasm:c=!0,inlineStyles:m=!0,directives:h={},dev:g=!0,log:x=!0,onPolicy:S}=e,C=Object.fromEntries(Object.entries(h).map(([e,t])=>[e.toLowerCase(),t])),w,T=[],E=``;function D(e,t,n){t===void 0||e.some(e=>e.origin===t)||e.push({origin:t,from:n})}function O(e){let n=[],i=e.env??{},o=[e.envPrefix??`VITE_`].flat();if(r===!0)for(let[e,t]of Object.entries(i))o.some(t=>e.startsWith(t))&&typeof t==`string`&&a.test(t.trim())&&D(n,s(t,`env ${e}`),`env ${e}`);else if(Array.isArray(r))for(let t of r){let r=i[t];typeof r!=`string`||r.trim()===``?e.logger.warn(`tempestCsp: env ${t} is empty — nothing added to connect-src`):D(n,s(r,`env ${t}`),`env ${t}`)}return t.forEach((t,r)=>{!t||t.trim()===``?e.logger.warn(`tempestCsp: connect[${r}] is empty — skipped, nothing added to connect-src`):D(n,s(t,`connect[${r}]`),`connect[${r}]`)}),n}function k(e){let t=[...e];if(!o)return t;for(let{origin:n}of e){let e=n.replace(/^http(s?):/i,`ws$1:`);e!==n&&D(t,e,`sockets (${n})`)}return t}function A(e,t){let n=e?[`'self'`,e]:[`'self'`],r={"default-src":[...n],"script-src":c?[...n,`'wasm-unsafe-eval'`]:[...n],"style-src":m||t?[...n,`'unsafe-inline'`]:[...n],"img-src":[...n,`data:`,`blob:`],"font-src":[...n,`data:`],"media-src":[...n,`blob:`],"connect-src":[`'self'`,`blob:`,`data:`],"worker-src":[...n,`blob:`],"manifest-src":[...n],"object-src":[`'none'`],"base-uri":[`'self'`],"form-action":[`'self'`]};for(let[e,t]of Object.entries(C))t===!1?delete r[e]:r[e]=p(r[e]??[],t);return r}function j(e,t){let n={};for(let[r,a]of Object.entries(e)){if(r in t){n[r]=t[r];continue}let e=i(t,r),o=C[r];e===void 0?n[r]=a:Array.isArray(o)?n[r]=p(e,o):a.length>0&&d(a)&&(n[r]=a)}for(let[e,r]of Object.entries(t))n[e]??=r;for(let[e,r]of Object.entries(C)){if(!(e in t))continue;if(r===!1){delete n[e];continue}let i=r.filter(n=>!t[e].includes(n));i.length>0&&w?.logger.warn(`tempestCsp: index.html declares ${e}, so directives["${e}"] is not added to it (${i.join(` `)}); the plugin never loosens a declared policy — add them to the <meta> instead`)}return n}function M(e,t,n){if(!n||!w)return;let r=n.map(f);if(n.some(e=>u(e,`'unsafe-inline'`))&&!r.some(e=>/^'(?:sha\d{3}|nonce)-/.test(e)))return;let i=v(e,`script`).filter(e=>!r.includes(e));i.length!==0&&w.logger.warn(`tempestCsp: the Content-Security-Policy declared in index.html blocks ${i.length} inline <script> (${t} ${n.join(` `)}); the plugin never loosens a declared policy, so add ${i.join(` `)} to ${t}`)}return{name:`tempest-csp`,configResolved(e){w=e,T=O(e)},transformIndexHtml:{order:`post`,handler(e,t){let r=w?.command===`serve`;if(r&&!g)return e;let o=k(T),c=w?.base??`/`,f=a.test(c)?s(c,`base`):void 0;f&&D(o,f,`base`);let m=r?[]:b(t);for(let e of n)(r||m.some(t=>e.module.test(t)))&&D(o,e.origin,e.from);let h=o,{html:C,declared:O={}}=_(e),N=A(f,r),P=e=>!(e in O)&&i(O,e)===void 0;P(`script-src`)&&!(`script-src-elem`in O)&&(N[`script-src`]=p(N[`script-src`]??[],v(C,`script`))),P(`style-src`)&&!(`style-src-elem`in O)&&!N[`style-src`]?.some(e=>u(e,`'unsafe-inline'`))&&(N[`style-src`]=p(N[`style-src`]??[],v(C,`style`)));let F=j(N,O),I=h.map(e=>e.origin),L=i(O,`connect-src`),R=F[`connect-src`]??L;R!==void 0&&d(R)&&(`connect-src`in O||L!==void 0)?I.length>0&&w?.logger.warn(`tempestCsp: index.html declares connect-src ${R.join(` `)||`with no source`}${`connect-src`in O?``:` (through default-src)`}, so these origins stay out and requests to them will be blocked: ${I.join(` `)}`):(`connect-src`in F||I.length>0||L===void 0)&&(F[`connect-src`]=p(R??[`'self'`],I));let z=`script-src-elem`in O?`script-src-elem`:`script-src`;M(C,z,F[z]??i(O,z));let B={directives:F,meta:l(F,`meta`),header:l(F,`header`),connect:h,command:r?`serve`:`build`};if(x&&w&&B.header!==E){E=B.header;let e=h.map(e=>`  ${e.origin}  ← ${e.from}`);w.logger.info([`tempest-csp: connect-src ${(F[`connect-src`]??L??[]).join(` `)}`,...e.length>0?e:[`  (no cross-origin endpoint: only 'self')`]].join(`
 `))}return S?.(B),y(C,B.meta)}}}}exports.cspOrigin=s,exports.parseCsp=c,exports.serializeCsp=l,exports.tempestCsp=x;
 //# sourceMappingURL=tempest-csp.cjs.map