tempest-react-sdk 0.77.0 → 0.79.0

package/dist/br/whatsapp.js.map

@@ -1 +1 @@
-{"version":3,"file":"whatsapp.js","names":[],"sources":["../../src/br/whatsapp.ts"],"sourcesContent":["/** Country calling code for Brazil, the digits `wa.me` needs in front of a national number. */\nconst BR_COUNTRY_CODE = \"55\";\n\nconst NATIONAL_LENGTHS = new Set([10, 11]);\nconst E164_MIN_WITH_COUNTRY_CODE = 12;\nconst E164_MAX = 15;\n\n/**\n * Normalise a phone number to the digits-only form `wa.me` accepts.\n *\n * A Brazilian number is stored almost everywhere **without** the country code —\n * ten digits for a landline, eleven for a mobile — and `wa.me` refuses anything\n * that is not fully qualified. Those two shapes get `55` in front; a number that\n * already carries a country code (12 to 15 digits, the E.164 range that no\n * Brazilian national number can reach) is returned untouched, so a foreign\n * client's number still works.\n *\n * Everything else returns an empty string rather than a best guess. Handing back\n * the digits as typed is what the naive version does, and it builds a `wa.me`\n * URL that opens WhatsApp on a number nobody owns — a typo becomes a dead chat\n * window instead of a disabled button.\n *\n * Trunk and carrier-selection prefixes (`0`, `021`, …) are **not** stripped: a\n * leading zero is ambiguous between the two, so a number carrying one reads as\n * invalid instead of being silently reinterpreted. Pass the plain number. The\n * leading zero is what rules it out even at a plausible length — no E.164\n * country code starts with `0`, so `011999998888` is a national number wearing a\n * trunk prefix, never an international one.\n *\n * @example\n * toWhatsAppNumber(\"(11) 99999-8888\"); // \"5511999998888\"\n * toWhatsAppNumber(\"+55 11 99999-8888\"); // \"5511999998888\"\n * toWhatsAppNumber(\"99999-8888\"); // \"\" — no area code, nothing to dial\n *\n * @param phone - Phone number in any shape: masked, spaced, `+`-prefixed.\n * @returns Digits ready for a `wa.me` link, or an empty string when the input\n *   cannot be resolved to a dialable number.\n */\nexport function toWhatsAppNumber(phone: string): string {\n    const digits = phone.replace(/\\D/g, \"\");\n    if (NATIONAL_LENGTHS.has(digits.length)) return `${BR_COUNTRY_CODE}${digits}`;\n    const withinE164 = digits.length >= E164_MIN_WITH_COUNTRY_CODE && digits.length <= E164_MAX;\n    if (withinE164 && !digits.startsWith(\"0\")) return digits;\n    return \"\";\n}\n\n/**\n * Build the `wa.me` deep link that opens a chat with an optional message\n * already typed.\n *\n * This is a **deep link, never a send**: the chat opens with the text ready and\n * the person presses send. That is the feature, not a limitation — it needs no\n * official Cloud API, no approved template and no business verification, and it\n * cannot let the UI claim a message was delivered when it was not.\n *\n * `api.whatsapp.com/send?phone=…` is deliberately not offered as an alternative\n * host: both resolve to the same chooser, and `wa.me` is the short form of it.\n *\n * @example\n * whatsAppUrl(\"(11) 99999-8888\", \"Seu horário é amanhã às 14h.\");\n * // \"https://wa.me/5511999998888?text=Seu%20hor%C3%A1rio%20%C3%A9%20amanh%C3%A3%20%C3%A0s%2014h.\"\n *\n * @param phone - Phone number in any shape; normalised by {@link toWhatsAppNumber}.\n * @param text - Message to pre-fill. Omitted or empty leaves the composer blank.\n * @returns The `https://wa.me/…` URL, or an empty string when the number cannot\n *   be normalised.\n */\nexport function whatsAppUrl(phone: string, text?: string): string {\n    const number = toWhatsAppNumber(phone);\n    if (!number) return \"\";\n    const url = `https://wa.me/${number}`;\n    return text ? `${url}?text=${encodeURIComponent(text)}` : url;\n}\n\n/**\n * Open the WhatsApp chat in a new tab.\n *\n * @example\n * <Button onClick={() => openWhatsApp(client.phone, greeting)}>\n *     Falar no WhatsApp\n * </Button>\n *\n * @param phone - Phone number in any shape; normalised by {@link toWhatsAppNumber}.\n * @param text - Message to pre-fill. Omitted or empty leaves the composer blank.\n * @returns `true` when a URL was built and the open was requested, `false` when\n *   the number is unusable or there is no `window` (test runner, service worker,\n *   build plugin). It reports the **request**, not the tab: opening with\n *   `noopener` makes `window.open` return `null` even on success, so its result\n *   cannot distinguish a blocked popup from an opened one.\n */\nexport function openWhatsApp(phone: string, text?: string): boolean {\n    if (typeof window === \"undefined\") return false;\n    const url = whatsAppUrl(phone, text);\n    if (!url) return false;\n    window.open(url, \"_blank\", \"noopener,noreferrer\");\n    return true;\n}\n"],"mappings":";AACA,IAEM,oBAAmB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,GACnC,IAA6B,IAC7B,IAAW;AAiCjB,SAAgB,EAAiB,GAAuB;CACpD,IAAM,IAAS,EAAM,QAAQ,OAAO,EAAE;CAItC,OAHI,EAAiB,IAAI,EAAO,MAAM,IAAU,KAAqB,MAClD,EAAO,UAAU,KAA8B,EAAO,UAAU,KACjE,CAAC,EAAO,WAAW,GAAG,IAAU,IAC3C;AACX;AAuBA,SAAgB,EAAY,GAAe,GAAuB;CAC9D,IAAM,IAAS,EAAiB,CAAK;CACrC,IAAI,CAAC,GAAQ,OAAO;CACpB,IAAM,IAAM,iBAAiB;CAC7B,OAAO,IAAO,GAAG,EAAI,QAAQ,mBAAmB,CAAI,MAAM;AAC9D;AAkBA,SAAgB,EAAa,GAAe,GAAwB;CAChE,IAAI,OAAO,SAAW,KAAa,OAAO;CAC1C,IAAM,IAAM,EAAY,GAAO,CAAI;CAGnC,OAFK,KACL,OAAO,KAAK,GAAK,UAAU,qBAAqB,GACzC,MAFU;AAGrB"}
+{"version":3,"file":"whatsapp.js","names":["NATIONAL_LENGTHS","E164_MIN_WITH_COUNTRY_CODE","E164_MAX","toWhatsAppNumber","digits","phone","whatsAppUrl","number","url","text","openWhatsApp"],"sources":["../../src/br/whatsapp.ts"],"sourcesContent":["/** Country calling code for Brazil, the digits `wa.me` needs in front of a national number. */\nconst BR_COUNTRY_CODE = \"55\";\n\nconst NATIONAL_LENGTHS = new Set([10, 11]);\nconst E164_MIN_WITH_COUNTRY_CODE = 12;\nconst E164_MAX = 15;\n\n/**\n * Normalise a phone number to the digits-only form `wa.me` accepts.\n *\n * A Brazilian number is stored almost everywhere **without** the country code —\n * ten digits for a landline, eleven for a mobile — and `wa.me` refuses anything\n * that is not fully qualified. Those two shapes get `55` in front; a number that\n * already carries a country code (12 to 15 digits, the E.164 range that no\n * Brazilian national number can reach) is returned untouched, so a foreign\n * client's number still works.\n *\n * Everything else returns an empty string rather than a best guess. Handing back\n * the digits as typed is what the naive version does, and it builds a `wa.me`\n * URL that opens WhatsApp on a number nobody owns — a typo becomes a dead chat\n * window instead of a disabled button.\n *\n * Trunk and carrier-selection prefixes (`0`, `021`, …) are **not** stripped: a\n * leading zero is ambiguous between the two, so a number carrying one reads as\n * invalid instead of being silently reinterpreted. Pass the plain number. The\n * leading zero is what rules it out even at a plausible length — no E.164\n * country code starts with `0`, so `011999998888` is a national number wearing a\n * trunk prefix, never an international one.\n *\n * @example\n * toWhatsAppNumber(\"(11) 99999-8888\"); // \"5511999998888\"\n * toWhatsAppNumber(\"+55 11 99999-8888\"); // \"5511999998888\"\n * toWhatsAppNumber(\"99999-8888\"); // \"\" — no area code, nothing to dial\n *\n * @param phone - Phone number in any shape: masked, spaced, `+`-prefixed.\n * @returns Digits ready for a `wa.me` link, or an empty string when the input\n *   cannot be resolved to a dialable number.\n */\nexport function toWhatsAppNumber(phone: string): string {\n    const digits = phone.replace(/\\D/g, \"\");\n    if (NATIONAL_LENGTHS.has(digits.length)) return `${BR_COUNTRY_CODE}${digits}`;\n    const withinE164 = digits.length >= E164_MIN_WITH_COUNTRY_CODE && digits.length <= E164_MAX;\n    if (withinE164 && !digits.startsWith(\"0\")) return digits;\n    return \"\";\n}\n\n/**\n * Build the `wa.me` deep link that opens a chat with an optional message\n * already typed.\n *\n * This is a **deep link, never a send**: the chat opens with the text ready and\n * the person presses send. That is the feature, not a limitation — it needs no\n * official Cloud API, no approved template and no business verification, and it\n * cannot let the UI claim a message was delivered when it was not.\n *\n * `api.whatsapp.com/send?phone=…` is deliberately not offered as an alternative\n * host: both resolve to the same chooser, and `wa.me` is the short form of it.\n *\n * @example\n * whatsAppUrl(\"(11) 99999-8888\", \"Seu horário é amanhã às 14h.\");\n * // \"https://wa.me/5511999998888?text=Seu%20hor%C3%A1rio%20%C3%A9%20amanh%C3%A3%20%C3%A0s%2014h.\"\n *\n * @param phone - Phone number in any shape; normalised by {@link toWhatsAppNumber}.\n * @param text - Message to pre-fill. Omitted or empty leaves the composer blank.\n * @returns The `https://wa.me/…` URL, or an empty string when the number cannot\n *   be normalised.\n */\nexport function whatsAppUrl(phone: string, text?: string): string {\n    const number = toWhatsAppNumber(phone);\n    if (!number) return \"\";\n    const url = `https://wa.me/${number}`;\n    return text ? `${url}?text=${encodeURIComponent(text)}` : url;\n}\n\n/**\n * Open the WhatsApp chat in a new tab.\n *\n * @example\n * <Button onClick={() => openWhatsApp(client.phone, greeting)}>\n *     Falar no WhatsApp\n * </Button>\n *\n * @param phone - Phone number in any shape; normalised by {@link toWhatsAppNumber}.\n * @param text - Message to pre-fill. Omitted or empty leaves the composer blank.\n * @returns `true` when a URL was built and the open was requested, `false` when\n *   the number is unusable or there is no `window` (test runner, service worker,\n *   build plugin). It reports the **request**, not the tab: opening with\n *   `noopener` makes `window.open` return `null` even on success, so its result\n *   cannot distinguish a blocked popup from an opened one.\n */\nexport function openWhatsApp(phone: string, text?: string): boolean {\n    if (typeof window === \"undefined\") return false;\n    const url = whatsAppUrl(phone, text);\n    if (!url) return false;\n    window.open(url, \"_blank\", \"noopener,noreferrer\");\n    return true;\n}\n"],"mappings":";AACA,IAEMA,oBAAmB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,GACnCC,IAA6B,IAC7BC,IAAW;AAiCjB,SAAgBC,EAAiB,GAAuB;CACpD,IAAMC,IAASC,EAAM,QAAQ,OAAO,EAAE;CAItC,OAHIL,EAAiB,IAAII,EAAO,MAAM,IAAU,KAAqBA,MAClDA,EAAO,UAAUH,KAA8BG,EAAO,UAAUF,KACjE,CAACE,EAAO,WAAW,GAAG,IAAUA,IAC3C;AACX;AAuBA,SAAgBE,EAAY,GAAe,GAAuB;CAC9D,IAAMC,IAASJ,EAAiBE,CAAK;CACrC,IAAI,CAACE,GAAQ,OAAO;CACpB,IAAMC,IAAM,iBAAiBD;CAC7B,OAAOE,IAAO,GAAGD,EAAI,QAAQ,mBAAmBC,CAAI,MAAMD;AAC9D;AAkBA,SAAgBE,EAAa,GAAe,GAAwB;CAChE,IAAI,OAAO,SAAW,KAAa,OAAO;CAC1C,IAAMF,IAAMF,EAAYD,GAAOI,CAAI;CAGnC,OAFKD,KACL,OAAO,KAAKA,GAAK,UAAU,qBAAqB,GACzC,MAFU;AAGrB"}

package/dist/br.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"br.cjs","names":[],"sources":["../src/br/index.ts"],"sourcesContent":["// Brazilian locations data (states + cities) — mirrors the `utils/locations`\n// module of tempest-fastapi-sdk.\nexport {\n    listStates,\n    getState,\n    citiesByUf,\n    statesByRegion,\n    isValidUf,\n    normalizeUf,\n    isValidCity,\n    ufChoices,\n    cityChoices,\n    municipalitiesByUf,\n    administrativeRegionsByUf,\n    resolveMunicipality,\n    datasetVintage,\n    pendingGeometryIds,\n} from \"./locations\";\nexport type {\n    UF,\n    BrRegion,\n    BrazilState,\n    BrazilMunicipality,\n    BrazilAdministrativeRegion,\n    Choice,\n} from \"./locations\";\n\n// UF GeoJSON types (the geometry itself is lazy-loaded by BrazilMap).\nimport type { BrUfFeatureCollection } from \"./br-geo\";\nexport type { BrUfFeature, BrUfFeatureCollection, BrUfGeometry, Ring } from \"./br-geo\";\n\n/**\n * Lazily load the bundled simplified UF GeoJSON (~36 KB gzip). Kept out of the\n * synchronous barrel so a data-only import never pulls the geometry.\n */\nexport async function loadBrUfGeoJson(): Promise<BrUfFeatureCollection> {\n    const mod = await import(\"./br-geo\");\n    return mod.BR_UF_GEOJSON;\n}\n\n// Per-state municipality geometry (lazy, one chunk per UF).\nexport { loadStateMunicipalities } from \"./state-geo\";\nexport type { MunicipalityFeature, StateMunicipalities } from \"./state-geo\";\n\n// Offline geocoding (lazy centroid index).\nexport {\n    nearestMunicipality,\n    reverseGeocode,\n    geocodeMunicipality,\n    searchMunicipalities,\n    municipalityCentroid,\n    stateCentroid,\n} from \"./geocode\";\nexport type { MunicipalityCentroid, NearestMunicipality, ReverseGeocodeResult } from \"./geocode\";\n\n// Components\nexport { BrazilMap } from \"./BrazilMap\";\nexport type { BrazilMapProps, BrazilMapTooltipData } from \"./BrazilMap\";\nexport { BrazilStateMap } from \"./BrazilStateMap\";\nexport type {\n    BrazilStateMapProps,\n    BrazilStateMapTooltipData,\n    Municipality,\n} from \"./BrazilStateMap\";\nexport { BrazilStateCitySelect } from \"./BrazilStateCitySelect\";\nexport type { BrazilStateCitySelectProps, BrazilStateCitySelection } from \"./BrazilStateCitySelect\";\nexport { MunicipalitySearch } from \"./MunicipalitySearch\";\nexport type { MunicipalitySearchProps } from \"./MunicipalitySearch\";\nexport type { GeoMarker } from \"@/geo/types\";\nexport type { MapMarkersProps } from \"./MapMarkers\";\nexport { MapLegend } from \"./MapLegend\";\nexport type { MapLegendProps, LegendItem } from \"./MapLegend\";\n\n// Pix — BR Code (EMV MPM) payload + the QR that carries it.\nexport {\n    normalizePixKey,\n    parsePixPayload,\n    PixError,\n    pixCrc16,\n    pixKeyType,\n    pixPayload,\n} from \"./pix\";\nexport type {\n    NormalizedPixKey,\n    ParsePixOptions,\n    PixData,\n    PixDynamicInput,\n    PixField,\n    PixInput,\n    PixKeyType,\n    PixStaticInput,\n} from \"./pix\";\nexport { PixQRCode } from \"./PixQRCode\";\nexport type { PixQRCodeLabels, PixQRCodeProps } from \"./PixQRCode\";\n\n// Boleto — 47/48-digit typed line, 44-digit barcode, FEBRABAN check digits.\nexport {\n    boletoDueDate,\n    BoletoError,\n    boletoKind,\n    codigoBarrasToLinhaDigitavel,\n    fatorVencimento,\n    formatLinhaDigitavel,\n    linhaDigitavelToCodigoBarras,\n    mod10Dac,\n    mod11DacArrecadacao,\n    mod11DacCobranca,\n    parseCodigoBarras,\n    parseLinhaDigitavel,\n    validateBoleto,\n} from \"./boleto\";\nexport type {\n    Boleto,\n    BoletoArrecadacao,\n    BoletoBanco,\n    BoletoEpoch,\n    BoletoKind,\n    BoletoOptions,\n} from \"./boleto\";\n\n// NF-e / NFC-e / CT-e access key.\nexport {\n    chaveNFeCheckDigit,\n    ChaveNFeError,\n    formatChaveNFe,\n    parseChaveNFe,\n    validateChaveNFe,\n} from \"./nfe\";\nexport type { ChaveNFe } from \"./nfe\";\n\n// WhatsApp deep link (chat opened with the message ready, never an API send).\nexport { openWhatsApp, toWhatsAppNumber, whatsAppUrl } from \"./whatsapp\";\n\n// National holidays + business-day arithmetic.\nexport {\n    addBusinessDays,\n    easterSunday,\n    holidaysFor,\n    isBusinessDay,\n    isHoliday,\n    nextBusinessDay,\n} from \"./holidays\";\nexport type { BusinessDayOptions, DateInput, Holiday, HolidayKind } from \"./holidays\";\n\n// Color scales + palettes for choropleths.\nexport {\n    sequentialScale,\n    quantizeScale,\n    thresholdScale,\n    SEQUENTIAL_BLUES,\n    SEQUENTIAL_GREENS,\n    SEQUENTIAL_VIRIDIS,\n    DIVERGING_RDBU,\n} from \"./scales\";\nexport type { ColorScale } from \"./scales\";\nexport { REGION_COLORS, regionLegendItems } from \"./regions\";\n"],"mappings":"2kBAmCA,eAAsB,GAAkD,CAEpE,OAAO,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QADW,iBAAA,CAAA,EAAA,CACP,aACf"}
+{"version":3,"file":"br.cjs","names":["require_locations","require_state_geo","require_geocode","require_regions","require_BrazilMap","require_BrazilStateMap","require_BrazilStateCitySelect","require_MunicipalitySearch","require_scales","require_MapLegend","require_pix","require_PixQRCode","require_boleto","require_nfe","require_whatsapp","require_holidays","loadBrUfGeoJson"],"sources":["../src/br/index.ts"],"sourcesContent":["// Brazilian locations data (states + cities) — mirrors the `utils/locations`\n// module of tempest-fastapi-sdk.\nexport {\n    listStates,\n    getState,\n    citiesByUf,\n    statesByRegion,\n    isValidUf,\n    normalizeUf,\n    isValidCity,\n    ufChoices,\n    cityChoices,\n    municipalitiesByUf,\n    administrativeRegionsByUf,\n    resolveMunicipality,\n    datasetVintage,\n    pendingGeometryIds,\n} from \"./locations\";\nexport type {\n    UF,\n    BrRegion,\n    BrazilState,\n    BrazilMunicipality,\n    BrazilAdministrativeRegion,\n    Choice,\n} from \"./locations\";\n\n// UF GeoJSON types (the geometry itself is lazy-loaded by BrazilMap).\nimport type { BrUfFeatureCollection } from \"./br-geo\";\nexport type { BrUfFeature, BrUfFeatureCollection, BrUfGeometry, Ring } from \"./br-geo\";\n\n/**\n * Lazily load the bundled simplified UF GeoJSON (~36 KB gzip). Kept out of the\n * synchronous barrel so a data-only import never pulls the geometry.\n */\nexport async function loadBrUfGeoJson(): Promise<BrUfFeatureCollection> {\n    const mod = await import(\"./br-geo\");\n    return mod.BR_UF_GEOJSON;\n}\n\n// Per-state municipality geometry (lazy, one chunk per UF).\nexport { loadStateMunicipalities } from \"./state-geo\";\nexport type { MunicipalityFeature, StateMunicipalities } from \"./state-geo\";\n\n// Offline geocoding (lazy centroid index).\nexport {\n    nearestMunicipality,\n    reverseGeocode,\n    geocodeMunicipality,\n    searchMunicipalities,\n    municipalityCentroid,\n    stateCentroid,\n} from \"./geocode\";\nexport type { MunicipalityCentroid, NearestMunicipality, ReverseGeocodeResult } from \"./geocode\";\n\n// Components\nexport { BrazilMap } from \"./BrazilMap\";\nexport type { BrazilMapProps, BrazilMapTooltipData } from \"./BrazilMap\";\nexport { BrazilStateMap } from \"./BrazilStateMap\";\nexport type {\n    BrazilStateMapProps,\n    BrazilStateMapTooltipData,\n    Municipality,\n} from \"./BrazilStateMap\";\nexport { BrazilStateCitySelect } from \"./BrazilStateCitySelect\";\nexport type { BrazilStateCitySelectProps, BrazilStateCitySelection } from \"./BrazilStateCitySelect\";\nexport { MunicipalitySearch } from \"./MunicipalitySearch\";\nexport type { MunicipalitySearchProps } from \"./MunicipalitySearch\";\nexport type { GeoMarker } from \"@/geo/types\";\nexport type { MapMarkersProps } from \"./MapMarkers\";\nexport { MapLegend } from \"./MapLegend\";\nexport type { MapLegendProps, LegendItem } from \"./MapLegend\";\n\n// Pix — BR Code (EMV MPM) payload + the QR that carries it.\nexport {\n    normalizePixKey,\n    parsePixPayload,\n    PixError,\n    pixCrc16,\n    pixKeyType,\n    pixPayload,\n} from \"./pix\";\nexport type {\n    NormalizedPixKey,\n    ParsePixOptions,\n    PixData,\n    PixDynamicInput,\n    PixField,\n    PixInput,\n    PixKeyType,\n    PixStaticInput,\n} from \"./pix\";\nexport { PixQRCode } from \"./PixQRCode\";\nexport type { PixQRCodeLabels, PixQRCodeProps } from \"./PixQRCode\";\n\n// Boleto — 47/48-digit typed line, 44-digit barcode, FEBRABAN check digits.\nexport {\n    boletoDueDate,\n    BoletoError,\n    boletoKind,\n    codigoBarrasToLinhaDigitavel,\n    fatorVencimento,\n    formatLinhaDigitavel,\n    linhaDigitavelToCodigoBarras,\n    mod10Dac,\n    mod11DacArrecadacao,\n    mod11DacCobranca,\n    parseCodigoBarras,\n    parseLinhaDigitavel,\n    validateBoleto,\n} from \"./boleto\";\nexport type {\n    Boleto,\n    BoletoArrecadacao,\n    BoletoBanco,\n    BoletoEpoch,\n    BoletoKind,\n    BoletoOptions,\n} from \"./boleto\";\n\n// NF-e / NFC-e / CT-e access key.\nexport {\n    chaveNFeCheckDigit,\n    ChaveNFeError,\n    formatChaveNFe,\n    parseChaveNFe,\n    validateChaveNFe,\n} from \"./nfe\";\nexport type { ChaveNFe } from \"./nfe\";\n\n// WhatsApp deep link (chat opened with the message ready, never an API send).\nexport { openWhatsApp, toWhatsAppNumber, whatsAppUrl } from \"./whatsapp\";\n\n// National holidays + business-day arithmetic.\nexport {\n    addBusinessDays,\n    easterSunday,\n    holidaysFor,\n    isBusinessDay,\n    isHoliday,\n    nextBusinessDay,\n} from \"./holidays\";\nexport type { BusinessDayOptions, DateInput, Holiday, HolidayKind } from \"./holidays\";\n\n// Color scales + palettes for choropleths.\nexport {\n    sequentialScale,\n    quantizeScale,\n    thresholdScale,\n    SEQUENTIAL_BLUES,\n    SEQUENTIAL_GREENS,\n    SEQUENTIAL_VIRIDIS,\n    DIVERGING_RDBU,\n} from \"./scales\";\nexport type { ColorScale } from \"./scales\";\nexport { REGION_COLORS, regionLegendItems } from \"./regions\";\n"],"mappings":"A,2kBAmCA,eAAsBgB,GAAkD,CAEpE,OAAO,MAAA,QAAA,QAAA,CAAA,CAAA,SAAA,QADW,iBAAA,CAAA,EAAA,CACP,aACf,C"}

package/dist/br.d.ts

@@ -1175,9 +1175,18 @@ export declare interface ParsePixOptions {
  * *not* tolerated is a broken frame — a length prefix that runs off the end, a
  * missing tag 63 — a checksum mismatch, which means the string was corrupted in
  * transit, or a payload with two readings: a tag repeated at the root or inside
- * tags 26 and 62, a tag 26 with both a key and a URL, or a tag 54 outside the EMV
- * amount format. A preview built from one reading while the wallet pays the
- * other is the failure those rules exist for.
+ * tags 26 and 62, a tag 63 anywhere but at the end, a tag 26 with both a key and
+ * a URL, a tag 54 outside the EMV amount format, non-ASCII text in an `ans`
+ * field (every root tag but 64 and 80–99, and so every subfield of tags 26 and
+ * 62), or `String` text that a reader counting UTF-8 bytes or UTF-16 units
+ * frames into other tags (#497). A preview built from one
+ * reading while the wallet pays the other is the failure those rules exist for.
+ *
+ * Position is checked where EMV® QRCPS-MPM — the reference the BACEN manual
+ * defers to — fixes it: tag 00 is the first object and tag 63 the last; every
+ * other root tag may appear in any order. Before #475 an inner `6304` + CRC
+ * followed by `5405…` and a second `6304` + CRC parsed as a priced payload,
+ * while the same text cut at the first CRC was a valid payload with no amount.
  *
  * The CRC detects corruption, not authorship: whoever crafts a payload
  * recomputes it, so a valid CRC says nothing about who published the account.
@@ -1185,9 +1194,11 @@ export declare interface ParsePixOptions {
  * @param payload - The copia-e-cola string. Surrounding whitespace is ignored.
  * @param options - See {@link ParsePixOptions}.
  * @returns The decoded payload.
- * @throws {PixError} On a malformed frame, a missing CRC tag, a repeated tag, a
+ * @throws {PixError} On a malformed frame, a missing CRC tag, a tag 00 that is
+ * not first or a tag 63 that is not last, a repeated tag, a
  * tag 26 that is not a Pix account or that carries both a key and a URL, an
- * amount outside the EMV format, or — unless `requireCrc` is `false` — a CRC
+ * amount outside the EMV format, non-ASCII text in an `ans` field, a payload
+ * that another length unit reads differently, or — unless `requireCrc` is `false` — a CRC
  * mismatch.
  *
  * @example

package/dist/br.js.map

@@ -1 +1 @@
-{"version":3,"file":"br.js","names":[],"sources":["../src/br/index.ts"],"sourcesContent":["// Brazilian locations data (states + cities) — mirrors the `utils/locations`\n// module of tempest-fastapi-sdk.\nexport {\n    listStates,\n    getState,\n    citiesByUf,\n    statesByRegion,\n    isValidUf,\n    normalizeUf,\n    isValidCity,\n    ufChoices,\n    cityChoices,\n    municipalitiesByUf,\n    administrativeRegionsByUf,\n    resolveMunicipality,\n    datasetVintage,\n    pendingGeometryIds,\n} from \"./locations\";\nexport type {\n    UF,\n    BrRegion,\n    BrazilState,\n    BrazilMunicipality,\n    BrazilAdministrativeRegion,\n    Choice,\n} from \"./locations\";\n\n// UF GeoJSON types (the geometry itself is lazy-loaded by BrazilMap).\nimport type { BrUfFeatureCollection } from \"./br-geo\";\nexport type { BrUfFeature, BrUfFeatureCollection, BrUfGeometry, Ring } from \"./br-geo\";\n\n/**\n * Lazily load the bundled simplified UF GeoJSON (~36 KB gzip). Kept out of the\n * synchronous barrel so a data-only import never pulls the geometry.\n */\nexport async function loadBrUfGeoJson(): Promise<BrUfFeatureCollection> {\n    const mod = await import(\"./br-geo\");\n    return mod.BR_UF_GEOJSON;\n}\n\n// Per-state municipality geometry (lazy, one chunk per UF).\nexport { loadStateMunicipalities } from \"./state-geo\";\nexport type { MunicipalityFeature, StateMunicipalities } from \"./state-geo\";\n\n// Offline geocoding (lazy centroid index).\nexport {\n    nearestMunicipality,\n    reverseGeocode,\n    geocodeMunicipality,\n    searchMunicipalities,\n    municipalityCentroid,\n    stateCentroid,\n} from \"./geocode\";\nexport type { MunicipalityCentroid, NearestMunicipality, ReverseGeocodeResult } from \"./geocode\";\n\n// Components\nexport { BrazilMap } from \"./BrazilMap\";\nexport type { BrazilMapProps, BrazilMapTooltipData } from \"./BrazilMap\";\nexport { BrazilStateMap } from \"./BrazilStateMap\";\nexport type {\n    BrazilStateMapProps,\n    BrazilStateMapTooltipData,\n    Municipality,\n} from \"./BrazilStateMap\";\nexport { BrazilStateCitySelect } from \"./BrazilStateCitySelect\";\nexport type { BrazilStateCitySelectProps, BrazilStateCitySelection } from \"./BrazilStateCitySelect\";\nexport { MunicipalitySearch } from \"./MunicipalitySearch\";\nexport type { MunicipalitySearchProps } from \"./MunicipalitySearch\";\nexport type { GeoMarker } from \"@/geo/types\";\nexport type { MapMarkersProps } from \"./MapMarkers\";\nexport { MapLegend } from \"./MapLegend\";\nexport type { MapLegendProps, LegendItem } from \"./MapLegend\";\n\n// Pix — BR Code (EMV MPM) payload + the QR that carries it.\nexport {\n    normalizePixKey,\n    parsePixPayload,\n    PixError,\n    pixCrc16,\n    pixKeyType,\n    pixPayload,\n} from \"./pix\";\nexport type {\n    NormalizedPixKey,\n    ParsePixOptions,\n    PixData,\n    PixDynamicInput,\n    PixField,\n    PixInput,\n    PixKeyType,\n    PixStaticInput,\n} from \"./pix\";\nexport { PixQRCode } from \"./PixQRCode\";\nexport type { PixQRCodeLabels, PixQRCodeProps } from \"./PixQRCode\";\n\n// Boleto — 47/48-digit typed line, 44-digit barcode, FEBRABAN check digits.\nexport {\n    boletoDueDate,\n    BoletoError,\n    boletoKind,\n    codigoBarrasToLinhaDigitavel,\n    fatorVencimento,\n    formatLinhaDigitavel,\n    linhaDigitavelToCodigoBarras,\n    mod10Dac,\n    mod11DacArrecadacao,\n    mod11DacCobranca,\n    parseCodigoBarras,\n    parseLinhaDigitavel,\n    validateBoleto,\n} from \"./boleto\";\nexport type {\n    Boleto,\n    BoletoArrecadacao,\n    BoletoBanco,\n    BoletoEpoch,\n    BoletoKind,\n    BoletoOptions,\n} from \"./boleto\";\n\n// NF-e / NFC-e / CT-e access key.\nexport {\n    chaveNFeCheckDigit,\n    ChaveNFeError,\n    formatChaveNFe,\n    parseChaveNFe,\n    validateChaveNFe,\n} from \"./nfe\";\nexport type { ChaveNFe } from \"./nfe\";\n\n// WhatsApp deep link (chat opened with the message ready, never an API send).\nexport { openWhatsApp, toWhatsAppNumber, whatsAppUrl } from \"./whatsapp\";\n\n// National holidays + business-day arithmetic.\nexport {\n    addBusinessDays,\n    easterSunday,\n    holidaysFor,\n    isBusinessDay,\n    isHoliday,\n    nextBusinessDay,\n} from \"./holidays\";\nexport type { BusinessDayOptions, DateInput, Holiday, HolidayKind } from \"./holidays\";\n\n// Color scales + palettes for choropleths.\nexport {\n    sequentialScale,\n    quantizeScale,\n    thresholdScale,\n    SEQUENTIAL_BLUES,\n    SEQUENTIAL_GREENS,\n    SEQUENTIAL_VIRIDIS,\n    DIVERGING_RDBU,\n} from \"./scales\";\nexport type { ColorScale } from \"./scales\";\nexport { REGION_COLORS, regionLegendItems } from \"./regions\";\n"],"mappings":";;;;;;;;;;;;;;;;;AAmCA,eAAsB,KAAkD;CAEpE,QAAO,MADW,OAAO,kBAAA,CACd;AACf"}
+{"version":3,"file":"br.js","names":["loadBrUfGeoJson","BoletoError","BrazilMap","BrazilStateCitySelect","BrazilStateMap","ChaveNFeError","DIVERGING_RDBU","MapLegend","MunicipalitySearch","PixError","PixQRCode","REGION_COLORS","SEQUENTIAL_BLUES","SEQUENTIAL_GREENS","SEQUENTIAL_VIRIDIS","addBusinessDays","administrativeRegionsByUf","boletoDueDate","boletoKind","chaveNFeCheckDigit","citiesByUf","cityChoices","codigoBarrasToLinhaDigitavel","datasetVintage","easterSunday","fatorVencimento","formatChaveNFe","formatLinhaDigitavel","geocodeMunicipality","getState","holidaysFor","isBusinessDay","isHoliday","isValidCity","isValidUf","linhaDigitavelToCodigoBarras","listStates","loadStateMunicipalities","mod10Dac","mod11DacArrecadacao","mod11DacCobranca","municipalitiesByUf","municipalityCentroid","nearestMunicipality","nextBusinessDay","normalizePixKey","normalizeUf","openWhatsApp","parseChaveNFe","parseCodigoBarras","parseLinhaDigitavel","parsePixPayload","pendingGeometryIds","pixCrc16","pixKeyType","pixPayload","quantizeScale","regionLegendItems","resolveMunicipality","reverseGeocode","searchMunicipalities","sequentialScale","stateCentroid","statesByRegion","thresholdScale","toWhatsAppNumber","ufChoices","validateBoleto","validateChaveNFe","whatsAppUrl"],"sources":["../src/br/index.ts"],"sourcesContent":["// Brazilian locations data (states + cities) — mirrors the `utils/locations`\n// module of tempest-fastapi-sdk.\nexport {\n    listStates,\n    getState,\n    citiesByUf,\n    statesByRegion,\n    isValidUf,\n    normalizeUf,\n    isValidCity,\n    ufChoices,\n    cityChoices,\n    municipalitiesByUf,\n    administrativeRegionsByUf,\n    resolveMunicipality,\n    datasetVintage,\n    pendingGeometryIds,\n} from \"./locations\";\nexport type {\n    UF,\n    BrRegion,\n    BrazilState,\n    BrazilMunicipality,\n    BrazilAdministrativeRegion,\n    Choice,\n} from \"./locations\";\n\n// UF GeoJSON types (the geometry itself is lazy-loaded by BrazilMap).\nimport type { BrUfFeatureCollection } from \"./br-geo\";\nexport type { BrUfFeature, BrUfFeatureCollection, BrUfGeometry, Ring } from \"./br-geo\";\n\n/**\n * Lazily load the bundled simplified UF GeoJSON (~36 KB gzip). Kept out of the\n * synchronous barrel so a data-only import never pulls the geometry.\n */\nexport async function loadBrUfGeoJson(): Promise<BrUfFeatureCollection> {\n    const mod = await import(\"./br-geo\");\n    return mod.BR_UF_GEOJSON;\n}\n\n// Per-state municipality geometry (lazy, one chunk per UF).\nexport { loadStateMunicipalities } from \"./state-geo\";\nexport type { MunicipalityFeature, StateMunicipalities } from \"./state-geo\";\n\n// Offline geocoding (lazy centroid index).\nexport {\n    nearestMunicipality,\n    reverseGeocode,\n    geocodeMunicipality,\n    searchMunicipalities,\n    municipalityCentroid,\n    stateCentroid,\n} from \"./geocode\";\nexport type { MunicipalityCentroid, NearestMunicipality, ReverseGeocodeResult } from \"./geocode\";\n\n// Components\nexport { BrazilMap } from \"./BrazilMap\";\nexport type { BrazilMapProps, BrazilMapTooltipData } from \"./BrazilMap\";\nexport { BrazilStateMap } from \"./BrazilStateMap\";\nexport type {\n    BrazilStateMapProps,\n    BrazilStateMapTooltipData,\n    Municipality,\n} from \"./BrazilStateMap\";\nexport { BrazilStateCitySelect } from \"./BrazilStateCitySelect\";\nexport type { BrazilStateCitySelectProps, BrazilStateCitySelection } from \"./BrazilStateCitySelect\";\nexport { MunicipalitySearch } from \"./MunicipalitySearch\";\nexport type { MunicipalitySearchProps } from \"./MunicipalitySearch\";\nexport type { GeoMarker } from \"@/geo/types\";\nexport type { MapMarkersProps } from \"./MapMarkers\";\nexport { MapLegend } from \"./MapLegend\";\nexport type { MapLegendProps, LegendItem } from \"./MapLegend\";\n\n// Pix — BR Code (EMV MPM) payload + the QR that carries it.\nexport {\n    normalizePixKey,\n    parsePixPayload,\n    PixError,\n    pixCrc16,\n    pixKeyType,\n    pixPayload,\n} from \"./pix\";\nexport type {\n    NormalizedPixKey,\n    ParsePixOptions,\n    PixData,\n    PixDynamicInput,\n    PixField,\n    PixInput,\n    PixKeyType,\n    PixStaticInput,\n} from \"./pix\";\nexport { PixQRCode } from \"./PixQRCode\";\nexport type { PixQRCodeLabels, PixQRCodeProps } from \"./PixQRCode\";\n\n// Boleto — 47/48-digit typed line, 44-digit barcode, FEBRABAN check digits.\nexport {\n    boletoDueDate,\n    BoletoError,\n    boletoKind,\n    codigoBarrasToLinhaDigitavel,\n    fatorVencimento,\n    formatLinhaDigitavel,\n    linhaDigitavelToCodigoBarras,\n    mod10Dac,\n    mod11DacArrecadacao,\n    mod11DacCobranca,\n    parseCodigoBarras,\n    parseLinhaDigitavel,\n    validateBoleto,\n} from \"./boleto\";\nexport type {\n    Boleto,\n    BoletoArrecadacao,\n    BoletoBanco,\n    BoletoEpoch,\n    BoletoKind,\n    BoletoOptions,\n} from \"./boleto\";\n\n// NF-e / NFC-e / CT-e access key.\nexport {\n    chaveNFeCheckDigit,\n    ChaveNFeError,\n    formatChaveNFe,\n    parseChaveNFe,\n    validateChaveNFe,\n} from \"./nfe\";\nexport type { ChaveNFe } from \"./nfe\";\n\n// WhatsApp deep link (chat opened with the message ready, never an API send).\nexport { openWhatsApp, toWhatsAppNumber, whatsAppUrl } from \"./whatsapp\";\n\n// National holidays + business-day arithmetic.\nexport {\n    addBusinessDays,\n    easterSunday,\n    holidaysFor,\n    isBusinessDay,\n    isHoliday,\n    nextBusinessDay,\n} from \"./holidays\";\nexport type { BusinessDayOptions, DateInput, Holiday, HolidayKind } from \"./holidays\";\n\n// Color scales + palettes for choropleths.\nexport {\n    sequentialScale,\n    quantizeScale,\n    thresholdScale,\n    SEQUENTIAL_BLUES,\n    SEQUENTIAL_GREENS,\n    SEQUENTIAL_VIRIDIS,\n    DIVERGING_RDBU,\n} from \"./scales\";\nexport type { ColorScale } from \"./scales\";\nexport { REGION_COLORS, regionLegendItems } from \"./regions\";\n"],"mappings":";;;;;;;;;;;;;;;;;AAmCA,eAAsBA,KAAkD;CAEpE,QAAO,MADW,OAAO,kBAAA,CACd;AACf"}

package/dist/capture/barcode.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"barcode.cjs","names":[],"sources":["../../src/capture/barcode.ts"],"sourcesContent":["/**\n * Symbologies the `BarcodeDetector` API names.\n *\n * Three of them carry the weight in Brazil: `ean_13` is the retail barcode on every\n * packaged product, `qr_code` is what a Pix \"copia e cola\" payload travels in, and\n * `code_128` is the label on a shipment. The rest are here because the spec has them\n * and asking for one costs nothing.\n */\nexport type BarcodeFormat =\n    | \"aztec\"\n    | \"codabar\"\n    | \"code_128\"\n    | \"code_39\"\n    | \"code_93\"\n    | \"data_matrix\"\n    | \"ean_13\"\n    | \"ean_8\"\n    | \"itf\"\n    | \"pdf417\"\n    | \"qr_code\"\n    | \"upc_a\"\n    | \"upc_e\"\n    | \"unknown\";\n\n/** Every symbology in the spec, used to validate what a detector reports back. */\nexport const ALL_BARCODE_FORMATS: readonly BarcodeFormat[] = [\n    \"aztec\",\n    \"codabar\",\n    \"code_128\",\n    \"code_39\",\n    \"code_93\",\n    \"data_matrix\",\n    \"ean_13\",\n    \"ean_8\",\n    \"itf\",\n    \"pdf417\",\n    \"qr_code\",\n    \"upc_a\",\n    \"upc_e\",\n    \"unknown\",\n];\n\n/**\n * What a scanner looks for when you do not say.\n *\n * Deliberately three formats, not all fourteen. Every extra symbology is more work\n * per frame, and on a mid-range phone the difference between three and fourteen is the\n * difference between a scanner that locks on instantly and one that feels broken.\n */\nexport const DEFAULT_BARCODE_FORMATS: readonly BarcodeFormat[] = [\"qr_code\", \"ean_13\", \"code_128\"];\n\n/** A corner of a detected symbol, in the source's pixel coordinates. */\nexport interface BarcodePoint {\n    x: number;\n    y: number;\n}\n\n/** One decoded symbol, normalised. */\nexport interface BarcodeScanResult {\n    /** The decoded payload — a GTIN, a URL, a Pix BR Code. */\n    rawValue: string;\n    /** Which symbology it was read as. `\"unknown\"` when the engine does not say. */\n    format: BarcodeFormat;\n    /** Box in source pixels, or `null` when the engine reports none. */\n    boundingBox: DOMRectReadOnly | null;\n    /** Corners in source pixels, clockwise from top-left. Empty when unreported. */\n    cornerPoints: readonly BarcodePoint[];\n}\n\n/**\n * The shape a detector resolves with, before normalisation.\n *\n * Every field is optional because a polyfill is allowed to report the value and no\n * geometry at all, and the native engines differ on `cornerPoints`.\n */\nexport interface DetectedBarcodeLike {\n    rawValue?: string;\n    format?: string;\n    boundingBox?: DOMRectReadOnly;\n    cornerPoints?: readonly BarcodePoint[];\n}\n\n/**\n * The slice of `BarcodeDetector` this SDK uses.\n *\n * Exported so a consumer can **inject a polyfill** where the native API is missing —\n * see {@link isBarcodeDetectionSupported} for why that matters — and so tests can hand\n * in a decoder without a camera. Anything with a `detect()` that resolves to objects\n * carrying a `rawValue` will do.\n */\nexport interface BarcodeDetectorLike {\n    /**\n     * Decode every symbol visible in the source.\n     *\n     * @param source - A `<video>`, a `<canvas>`, an `ImageBitmap`, a `Blob`…\n     * @returns Every symbol found, or an empty array — finding nothing is not an error.\n     */\n    detect: (source: ImageBitmapSource) => Promise<readonly DetectedBarcodeLike[]>;\n}\n\n/** The constructor, as Chromium exposes it on the global scope. */\ninterface BarcodeDetectorConstructorLike {\n    new (options?: { formats?: readonly string[] }): BarcodeDetectorLike;\n    getSupportedFormats?: () => Promise<readonly string[]>;\n}\n\n/**\n * Read the constructor off the global scope, or `null` when the engine has none.\n *\n * Kept private: everything a consumer needs is covered by\n * {@link isBarcodeDetectionSupported}, {@link getSupportedBarcodeFormats} and\n * {@link createBarcodeDetector}.\n */\nfunction barcodeDetectorConstructor(): BarcodeDetectorConstructorLike | null {\n    const candidate = (globalThis as { BarcodeDetector?: unknown }).BarcodeDetector;\n    return typeof candidate === \"function\" ? (candidate as BarcodeDetectorConstructorLike) : null;\n}\n\n/**\n * Whether this browser can decode barcodes on its own.\n *\n * **Expect `false` on a lot of real devices, and design for it.** `BarcodeDetector` is\n * a Chromium-only API backed by a platform decoder, so it is there on Android and\n * ChromeOS, usually there on macOS, and **absent** on Chromium for Windows and Linux,\n * in Firefox, and in every browser on iOS (all of which are WebKit underneath,\n * including Chrome for iOS).\n *\n * This SDK ships **no** decoder of its own and no bundled fallback: a QR reader is\n * Reed–Solomon error correction plus perspective correction plus a finder-pattern\n * search, and the honest options are a WASM build every consumer of this SDK would pay\n * for, or nothing. So the escape hatch is injection instead — pass any\n * {@link BarcodeDetectorLike} (the `barcode-detector` polyfill, your own `zxing-wasm`\n * wrapper) as `detector` to `useBarcodeScanner`, and the SDK drives it exactly like\n * the native one.\n *\n * @returns `true` when `new BarcodeDetector()` will work.\n */\nexport function isBarcodeDetectionSupported(): boolean {\n    return barcodeDetectorConstructor() !== null;\n}\n\n/**\n * Which symbologies this engine will actually decode.\n *\n * Worth asking rather than assuming: the format list belongs to the platform decoder,\n * not to the browser, so two Chromium builds on two operating systems answer\n * differently — and asking for a format the engine does not have makes the constructor\n * throw `NotSupportedError`, which reads like a bug in your code.\n *\n * @returns The supported formats, or an empty array when there is no detector.\n */\nexport async function getSupportedBarcodeFormats(): Promise<readonly BarcodeFormat[]> {\n    const constructor = barcodeDetectorConstructor();\n    if (!constructor || typeof constructor.getSupportedFormats !== \"function\") return [];\n    try {\n        const formats = await constructor.getSupportedFormats();\n        return formats.filter((format): format is BarcodeFormat =>\n            ALL_BARCODE_FORMATS.includes(format as BarcodeFormat),\n        );\n    } catch {\n        return [];\n    }\n}\n\n/**\n * Build a native detector for the given formats.\n *\n * @param formats - Symbologies to look for. Must be ones the engine supports.\n * @returns The detector, or `null` when the API is missing or refused the formats.\n */\nexport function createBarcodeDetector(\n    formats: readonly BarcodeFormat[] = DEFAULT_BARCODE_FORMATS,\n): BarcodeDetectorLike | null {\n    const constructor = barcodeDetectorConstructor();\n    if (!constructor) return null;\n    try {\n        return new constructor({ formats: [...formats] });\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Turn one raw detection into a {@link BarcodeScanResult}.\n *\n * An unrecognised `format` string becomes `\"unknown\"` rather than being passed through\n * as a lie about the union, and missing geometry becomes `null`/`[]` rather than\n * `undefined`, so a consumer never has to branch on three kinds of absence.\n *\n * @param raw - What the detector resolved with.\n * @param known - The formats considered valid. Defaults to the whole spec list.\n * @returns The normalised result.\n */\nexport function normalizeBarcode(\n    raw: DetectedBarcodeLike,\n    known: readonly BarcodeFormat[] = ALL_BARCODE_FORMATS,\n): BarcodeScanResult {\n    const format = raw.format as BarcodeFormat | undefined;\n    return {\n        rawValue: raw.rawValue ?? \"\",\n        format: format !== undefined && known.includes(format) ? format : \"unknown\",\n        boundingBox: raw.boundingBox ?? null,\n        cornerPoints: raw.cornerPoints ?? [],\n    };\n}\n"],"mappings":"AAyBA,IAAa,EAAgD,CACzD,QACA,UACA,WACA,UACA,UACA,cACA,SACA,QACA,MACA,SACA,UACA,QACA,QACA,SACJ,EASa,EAAoD,CAAC,UAAW,SAAU,UAAU,EAgEjG,SAAS,GAAoE,CACzE,IAAM,EAAa,WAA6C,gBAChE,OAAO,OAAO,GAAc,WAAc,EAA+C,IAC7F,CAqBA,SAAgB,GAAuC,CACnD,OAAO,EAA2B,IAAM,IAC5C,CAYA,eAAsB,GAAgE,CAClF,IAAM,EAAc,EAA2B,EAC/C,GAAI,CAAC,GAAe,OAAO,EAAY,qBAAwB,WAAY,MAAO,CAAC,EACnF,GAAI,CAEA,OAAO,MADe,EAAY,oBAAoB,EAAA,CACvC,OAAQ,GACnB,EAAoB,SAAS,CAAuB,CACxD,CACJ,MAAQ,CACJ,MAAO,CAAC,CACZ,CACJ,CAQA,SAAgB,EACZ,EAAoC,EACV,CAC1B,IAAM,EAAc,EAA2B,EAC/C,GAAI,CAAC,EAAa,OAAO,KACzB,GAAI,CACA,OAAO,IAAI,EAAY,CAAE,QAAS,CAAC,GAAG,CAAO,CAAE,CAAC,CACpD,MAAQ,CACJ,OAAO,IACX,CACJ,CAaA,SAAgB,EACZ,EACA,EAAkC,EACjB,CACjB,IAAM,EAAS,EAAI,OACnB,MAAO,CACH,SAAU,EAAI,UAAY,GAC1B,OAAQ,IAAW,IAAA,IAAa,EAAM,SAAS,CAAM,EAAI,EAAS,UAClE,YAAa,EAAI,aAAe,KAChC,aAAc,EAAI,cAAgB,CAAC,CACvC,CACJ"}
+{"version":3,"file":"barcode.cjs","names":["ALL_BARCODE_FORMATS","DEFAULT_BARCODE_FORMATS","barcodeDetectorConstructor","candidate","isBarcodeDetectionSupported","getSupportedBarcodeFormats","constructor","format","createBarcodeDetector","formats","normalizeBarcode","raw","known"],"sources":["../../src/capture/barcode.ts"],"sourcesContent":["/**\n * Symbologies the `BarcodeDetector` API names.\n *\n * Three of them carry the weight in Brazil: `ean_13` is the retail barcode on every\n * packaged product, `qr_code` is what a Pix \"copia e cola\" payload travels in, and\n * `code_128` is the label on a shipment. The rest are here because the spec has them\n * and asking for one costs nothing.\n */\nexport type BarcodeFormat =\n    | \"aztec\"\n    | \"codabar\"\n    | \"code_128\"\n    | \"code_39\"\n    | \"code_93\"\n    | \"data_matrix\"\n    | \"ean_13\"\n    | \"ean_8\"\n    | \"itf\"\n    | \"pdf417\"\n    | \"qr_code\"\n    | \"upc_a\"\n    | \"upc_e\"\n    | \"unknown\";\n\n/** Every symbology in the spec, used to validate what a detector reports back. */\nexport const ALL_BARCODE_FORMATS: readonly BarcodeFormat[] = [\n    \"aztec\",\n    \"codabar\",\n    \"code_128\",\n    \"code_39\",\n    \"code_93\",\n    \"data_matrix\",\n    \"ean_13\",\n    \"ean_8\",\n    \"itf\",\n    \"pdf417\",\n    \"qr_code\",\n    \"upc_a\",\n    \"upc_e\",\n    \"unknown\",\n];\n\n/**\n * What a scanner looks for when you do not say.\n *\n * Deliberately three formats, not all fourteen. Every extra symbology is more work\n * per frame, and on a mid-range phone the difference between three and fourteen is the\n * difference between a scanner that locks on instantly and one that feels broken.\n */\nexport const DEFAULT_BARCODE_FORMATS: readonly BarcodeFormat[] = [\"qr_code\", \"ean_13\", \"code_128\"];\n\n/** A corner of a detected symbol, in the source's pixel coordinates. */\nexport interface BarcodePoint {\n    x: number;\n    y: number;\n}\n\n/** One decoded symbol, normalised. */\nexport interface BarcodeScanResult {\n    /** The decoded payload — a GTIN, a URL, a Pix BR Code. */\n    rawValue: string;\n    /** Which symbology it was read as. `\"unknown\"` when the engine does not say. */\n    format: BarcodeFormat;\n    /** Box in source pixels, or `null` when the engine reports none. */\n    boundingBox: DOMRectReadOnly | null;\n    /** Corners in source pixels, clockwise from top-left. Empty when unreported. */\n    cornerPoints: readonly BarcodePoint[];\n}\n\n/**\n * The shape a detector resolves with, before normalisation.\n *\n * Every field is optional because a polyfill is allowed to report the value and no\n * geometry at all, and the native engines differ on `cornerPoints`.\n */\nexport interface DetectedBarcodeLike {\n    rawValue?: string;\n    format?: string;\n    boundingBox?: DOMRectReadOnly;\n    cornerPoints?: readonly BarcodePoint[];\n}\n\n/**\n * The slice of `BarcodeDetector` this SDK uses.\n *\n * Exported so a consumer can **inject a polyfill** where the native API is missing —\n * see {@link isBarcodeDetectionSupported} for why that matters — and so tests can hand\n * in a decoder without a camera. Anything with a `detect()` that resolves to objects\n * carrying a `rawValue` will do.\n */\nexport interface BarcodeDetectorLike {\n    /**\n     * Decode every symbol visible in the source.\n     *\n     * @param source - A `<video>`, a `<canvas>`, an `ImageBitmap`, a `Blob`…\n     * @returns Every symbol found, or an empty array — finding nothing is not an error.\n     */\n    detect: (source: ImageBitmapSource) => Promise<readonly DetectedBarcodeLike[]>;\n}\n\n/** The constructor, as Chromium exposes it on the global scope. */\ninterface BarcodeDetectorConstructorLike {\n    new (options?: { formats?: readonly string[] }): BarcodeDetectorLike;\n    getSupportedFormats?: () => Promise<readonly string[]>;\n}\n\n/**\n * Read the constructor off the global scope, or `null` when the engine has none.\n *\n * Kept private: everything a consumer needs is covered by\n * {@link isBarcodeDetectionSupported}, {@link getSupportedBarcodeFormats} and\n * {@link createBarcodeDetector}.\n */\nfunction barcodeDetectorConstructor(): BarcodeDetectorConstructorLike | null {\n    const candidate = (globalThis as { BarcodeDetector?: unknown }).BarcodeDetector;\n    return typeof candidate === \"function\" ? (candidate as BarcodeDetectorConstructorLike) : null;\n}\n\n/**\n * Whether this browser can decode barcodes on its own.\n *\n * **Expect `false` on a lot of real devices, and design for it.** `BarcodeDetector` is\n * a Chromium-only API backed by a platform decoder, so it is there on Android and\n * ChromeOS, usually there on macOS, and **absent** on Chromium for Windows and Linux,\n * in Firefox, and in every browser on iOS (all of which are WebKit underneath,\n * including Chrome for iOS).\n *\n * This SDK ships **no** decoder of its own and no bundled fallback: a QR reader is\n * Reed–Solomon error correction plus perspective correction plus a finder-pattern\n * search, and the honest options are a WASM build every consumer of this SDK would pay\n * for, or nothing. So the escape hatch is injection instead — pass any\n * {@link BarcodeDetectorLike} (the `barcode-detector` polyfill, your own `zxing-wasm`\n * wrapper) as `detector` to `useBarcodeScanner`, and the SDK drives it exactly like\n * the native one.\n *\n * @returns `true` when `new BarcodeDetector()` will work.\n */\nexport function isBarcodeDetectionSupported(): boolean {\n    return barcodeDetectorConstructor() !== null;\n}\n\n/**\n * Which symbologies this engine will actually decode.\n *\n * Worth asking rather than assuming: the format list belongs to the platform decoder,\n * not to the browser, so two Chromium builds on two operating systems answer\n * differently — and asking for a format the engine does not have makes the constructor\n * throw `NotSupportedError`, which reads like a bug in your code.\n *\n * @returns The supported formats, or an empty array when there is no detector.\n */\nexport async function getSupportedBarcodeFormats(): Promise<readonly BarcodeFormat[]> {\n    const constructor = barcodeDetectorConstructor();\n    if (!constructor || typeof constructor.getSupportedFormats !== \"function\") return [];\n    try {\n        const formats = await constructor.getSupportedFormats();\n        return formats.filter((format): format is BarcodeFormat =>\n            ALL_BARCODE_FORMATS.includes(format as BarcodeFormat),\n        );\n    } catch {\n        return [];\n    }\n}\n\n/**\n * Build a native detector for the given formats.\n *\n * @param formats - Symbologies to look for. Must be ones the engine supports.\n * @returns The detector, or `null` when the API is missing or refused the formats.\n */\nexport function createBarcodeDetector(\n    formats: readonly BarcodeFormat[] = DEFAULT_BARCODE_FORMATS,\n): BarcodeDetectorLike | null {\n    const constructor = barcodeDetectorConstructor();\n    if (!constructor) return null;\n    try {\n        return new constructor({ formats: [...formats] });\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Turn one raw detection into a {@link BarcodeScanResult}.\n *\n * An unrecognised `format` string becomes `\"unknown\"` rather than being passed through\n * as a lie about the union, and missing geometry becomes `null`/`[]` rather than\n * `undefined`, so a consumer never has to branch on three kinds of absence.\n *\n * @param raw - What the detector resolved with.\n * @param known - The formats considered valid. Defaults to the whole spec list.\n * @returns The normalised result.\n */\nexport function normalizeBarcode(\n    raw: DetectedBarcodeLike,\n    known: readonly BarcodeFormat[] = ALL_BARCODE_FORMATS,\n): BarcodeScanResult {\n    const format = raw.format as BarcodeFormat | undefined;\n    return {\n        rawValue: raw.rawValue ?? \"\",\n        format: format !== undefined && known.includes(format) ? format : \"unknown\",\n        boundingBox: raw.boundingBox ?? null,\n        cornerPoints: raw.cornerPoints ?? [],\n    };\n}\n"],"mappings":"AAyBA,IAAaA,EAAgD,CACzD,QACA,UACA,WACA,UACA,UACA,cACA,SACA,QACA,MACA,SACA,UACA,QACA,QACA,SACJ,EASaC,EAAoD,CAAC,UAAW,SAAU,UAAU,EAgEjG,SAASC,GAAoE,CACzE,IAAMC,EAAa,WAA6C,gBAChE,OAAO,OAAOA,GAAc,WAAcA,EAA+C,IAC7F,CAqBA,SAAgBC,GAAuC,CACnD,OAAOF,EAA2B,IAAM,IAC5C,CAYA,eAAsBG,GAAgE,CAClF,IAAMC,EAAcJ,EAA2B,EAC/C,GAAI,CAACI,GAAe,OAAOA,EAAY,qBAAwB,WAAY,MAAO,CAAC,EACnF,GAAI,CAEA,OAAO,MADeA,EAAY,oBAAoB,EAAA,CACvC,OAAQ,GACnBN,EAAoB,SAASO,CAAuB,CACxD,CACJ,MAAQ,CACJ,MAAO,CAAC,CACZ,CACJ,CAQA,SAAgBC,EACZ,EAAoCP,EACV,CAC1B,IAAMK,EAAcJ,EAA2B,EAC/C,GAAI,CAACI,EAAa,OAAO,KACzB,GAAI,CACA,OAAO,IAAIA,EAAY,CAAE,QAAS,CAAC,GAAGG,CAAO,CAAE,CAAC,CACpD,MAAQ,CACJ,OAAO,IACX,CACJ,CAaA,SAAgBC,EACZ,EACA,EAAkCV,EACjB,CACjB,IAAMO,EAASI,EAAI,OACnB,MAAO,CACH,SAAUA,EAAI,UAAY,GAC1B,OAAQJ,IAAW,IAAA,IAAaK,EAAM,SAASL,CAAM,EAAIA,EAAS,UAClE,YAAaI,EAAI,aAAe,KAChC,aAAcA,EAAI,cAAgB,CAAC,CACvC,CACJ,C"}

package/dist/capture/barcode.js.map

@@ -1 +1 @@
-{"version":3,"file":"barcode.js","names":[],"sources":["../../src/capture/barcode.ts"],"sourcesContent":["/**\n * Symbologies the `BarcodeDetector` API names.\n *\n * Three of them carry the weight in Brazil: `ean_13` is the retail barcode on every\n * packaged product, `qr_code` is what a Pix \"copia e cola\" payload travels in, and\n * `code_128` is the label on a shipment. The rest are here because the spec has them\n * and asking for one costs nothing.\n */\nexport type BarcodeFormat =\n    | \"aztec\"\n    | \"codabar\"\n    | \"code_128\"\n    | \"code_39\"\n    | \"code_93\"\n    | \"data_matrix\"\n    | \"ean_13\"\n    | \"ean_8\"\n    | \"itf\"\n    | \"pdf417\"\n    | \"qr_code\"\n    | \"upc_a\"\n    | \"upc_e\"\n    | \"unknown\";\n\n/** Every symbology in the spec, used to validate what a detector reports back. */\nexport const ALL_BARCODE_FORMATS: readonly BarcodeFormat[] = [\n    \"aztec\",\n    \"codabar\",\n    \"code_128\",\n    \"code_39\",\n    \"code_93\",\n    \"data_matrix\",\n    \"ean_13\",\n    \"ean_8\",\n    \"itf\",\n    \"pdf417\",\n    \"qr_code\",\n    \"upc_a\",\n    \"upc_e\",\n    \"unknown\",\n];\n\n/**\n * What a scanner looks for when you do not say.\n *\n * Deliberately three formats, not all fourteen. Every extra symbology is more work\n * per frame, and on a mid-range phone the difference between three and fourteen is the\n * difference between a scanner that locks on instantly and one that feels broken.\n */\nexport const DEFAULT_BARCODE_FORMATS: readonly BarcodeFormat[] = [\"qr_code\", \"ean_13\", \"code_128\"];\n\n/** A corner of a detected symbol, in the source's pixel coordinates. */\nexport interface BarcodePoint {\n    x: number;\n    y: number;\n}\n\n/** One decoded symbol, normalised. */\nexport interface BarcodeScanResult {\n    /** The decoded payload — a GTIN, a URL, a Pix BR Code. */\n    rawValue: string;\n    /** Which symbology it was read as. `\"unknown\"` when the engine does not say. */\n    format: BarcodeFormat;\n    /** Box in source pixels, or `null` when the engine reports none. */\n    boundingBox: DOMRectReadOnly | null;\n    /** Corners in source pixels, clockwise from top-left. Empty when unreported. */\n    cornerPoints: readonly BarcodePoint[];\n}\n\n/**\n * The shape a detector resolves with, before normalisation.\n *\n * Every field is optional because a polyfill is allowed to report the value and no\n * geometry at all, and the native engines differ on `cornerPoints`.\n */\nexport interface DetectedBarcodeLike {\n    rawValue?: string;\n    format?: string;\n    boundingBox?: DOMRectReadOnly;\n    cornerPoints?: readonly BarcodePoint[];\n}\n\n/**\n * The slice of `BarcodeDetector` this SDK uses.\n *\n * Exported so a consumer can **inject a polyfill** where the native API is missing —\n * see {@link isBarcodeDetectionSupported} for why that matters — and so tests can hand\n * in a decoder without a camera. Anything with a `detect()` that resolves to objects\n * carrying a `rawValue` will do.\n */\nexport interface BarcodeDetectorLike {\n    /**\n     * Decode every symbol visible in the source.\n     *\n     * @param source - A `<video>`, a `<canvas>`, an `ImageBitmap`, a `Blob`…\n     * @returns Every symbol found, or an empty array — finding nothing is not an error.\n     */\n    detect: (source: ImageBitmapSource) => Promise<readonly DetectedBarcodeLike[]>;\n}\n\n/** The constructor, as Chromium exposes it on the global scope. */\ninterface BarcodeDetectorConstructorLike {\n    new (options?: { formats?: readonly string[] }): BarcodeDetectorLike;\n    getSupportedFormats?: () => Promise<readonly string[]>;\n}\n\n/**\n * Read the constructor off the global scope, or `null` when the engine has none.\n *\n * Kept private: everything a consumer needs is covered by\n * {@link isBarcodeDetectionSupported}, {@link getSupportedBarcodeFormats} and\n * {@link createBarcodeDetector}.\n */\nfunction barcodeDetectorConstructor(): BarcodeDetectorConstructorLike | null {\n    const candidate = (globalThis as { BarcodeDetector?: unknown }).BarcodeDetector;\n    return typeof candidate === \"function\" ? (candidate as BarcodeDetectorConstructorLike) : null;\n}\n\n/**\n * Whether this browser can decode barcodes on its own.\n *\n * **Expect `false` on a lot of real devices, and design for it.** `BarcodeDetector` is\n * a Chromium-only API backed by a platform decoder, so it is there on Android and\n * ChromeOS, usually there on macOS, and **absent** on Chromium for Windows and Linux,\n * in Firefox, and in every browser on iOS (all of which are WebKit underneath,\n * including Chrome for iOS).\n *\n * This SDK ships **no** decoder of its own and no bundled fallback: a QR reader is\n * Reed–Solomon error correction plus perspective correction plus a finder-pattern\n * search, and the honest options are a WASM build every consumer of this SDK would pay\n * for, or nothing. So the escape hatch is injection instead — pass any\n * {@link BarcodeDetectorLike} (the `barcode-detector` polyfill, your own `zxing-wasm`\n * wrapper) as `detector` to `useBarcodeScanner`, and the SDK drives it exactly like\n * the native one.\n *\n * @returns `true` when `new BarcodeDetector()` will work.\n */\nexport function isBarcodeDetectionSupported(): boolean {\n    return barcodeDetectorConstructor() !== null;\n}\n\n/**\n * Which symbologies this engine will actually decode.\n *\n * Worth asking rather than assuming: the format list belongs to the platform decoder,\n * not to the browser, so two Chromium builds on two operating systems answer\n * differently — and asking for a format the engine does not have makes the constructor\n * throw `NotSupportedError`, which reads like a bug in your code.\n *\n * @returns The supported formats, or an empty array when there is no detector.\n */\nexport async function getSupportedBarcodeFormats(): Promise<readonly BarcodeFormat[]> {\n    const constructor = barcodeDetectorConstructor();\n    if (!constructor || typeof constructor.getSupportedFormats !== \"function\") return [];\n    try {\n        const formats = await constructor.getSupportedFormats();\n        return formats.filter((format): format is BarcodeFormat =>\n            ALL_BARCODE_FORMATS.includes(format as BarcodeFormat),\n        );\n    } catch {\n        return [];\n    }\n}\n\n/**\n * Build a native detector for the given formats.\n *\n * @param formats - Symbologies to look for. Must be ones the engine supports.\n * @returns The detector, or `null` when the API is missing or refused the formats.\n */\nexport function createBarcodeDetector(\n    formats: readonly BarcodeFormat[] = DEFAULT_BARCODE_FORMATS,\n): BarcodeDetectorLike | null {\n    const constructor = barcodeDetectorConstructor();\n    if (!constructor) return null;\n    try {\n        return new constructor({ formats: [...formats] });\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Turn one raw detection into a {@link BarcodeScanResult}.\n *\n * An unrecognised `format` string becomes `\"unknown\"` rather than being passed through\n * as a lie about the union, and missing geometry becomes `null`/`[]` rather than\n * `undefined`, so a consumer never has to branch on three kinds of absence.\n *\n * @param raw - What the detector resolved with.\n * @param known - The formats considered valid. Defaults to the whole spec list.\n * @returns The normalised result.\n */\nexport function normalizeBarcode(\n    raw: DetectedBarcodeLike,\n    known: readonly BarcodeFormat[] = ALL_BARCODE_FORMATS,\n): BarcodeScanResult {\n    const format = raw.format as BarcodeFormat | undefined;\n    return {\n        rawValue: raw.rawValue ?? \"\",\n        format: format !== undefined && known.includes(format) ? format : \"unknown\",\n        boundingBox: raw.boundingBox ?? null,\n        cornerPoints: raw.cornerPoints ?? [],\n    };\n}\n"],"mappings":";AAyBA,IAAa,IAAgD;CACzD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACJ,GASa,IAAoD;CAAC;CAAW;CAAU;AAAU;AAgEjG,SAAS,IAAoE;CACzE,IAAM,IAAa,WAA6C;CAChE,OAAO,OAAO,KAAc,aAAc,IAA+C;AAC7F;AAqBA,SAAgB,IAAuC;CACnD,OAAO,EAA2B,MAAM;AAC5C;AAYA,eAAsB,IAAgE;CAClF,IAAM,IAAc,EAA2B;CAC/C,IAAI,CAAC,KAAe,OAAO,EAAY,uBAAwB,YAAY,OAAO,CAAC;CACnF,IAAI;EAEA,QAAO,MADe,EAAY,oBAAoB,EAAA,CACvC,QAAQ,MACnB,EAAoB,SAAS,CAAuB,CACxD;CACJ,QAAQ;EACJ,OAAO,CAAC;CACZ;AACJ;AAQA,SAAgB,EACZ,IAAoC,GACV;CAC1B,IAAM,IAAc,EAA2B;CAC/C,IAAI,CAAC,GAAa,OAAO;CACzB,IAAI;EACA,OAAO,IAAI,EAAY,EAAE,SAAS,CAAC,GAAG,CAAO,EAAE,CAAC;CACpD,QAAQ;EACJ,OAAO;CACX;AACJ;AAaA,SAAgB,EACZ,GACA,IAAkC,GACjB;CACjB,IAAM,IAAS,EAAI;CACnB,OAAO;EACH,UAAU,EAAI,YAAY;EAC1B,QAAQ,MAAW,KAAA,KAAa,EAAM,SAAS,CAAM,IAAI,IAAS;EAClE,aAAa,EAAI,eAAe;EAChC,cAAc,EAAI,gBAAgB,CAAC;CACvC;AACJ"}
+{"version":3,"file":"barcode.js","names":["ALL_BARCODE_FORMATS","DEFAULT_BARCODE_FORMATS","barcodeDetectorConstructor","candidate","isBarcodeDetectionSupported","getSupportedBarcodeFormats","constructor","format","createBarcodeDetector","formats","normalizeBarcode","raw","known"],"sources":["../../src/capture/barcode.ts"],"sourcesContent":["/**\n * Symbologies the `BarcodeDetector` API names.\n *\n * Three of them carry the weight in Brazil: `ean_13` is the retail barcode on every\n * packaged product, `qr_code` is what a Pix \"copia e cola\" payload travels in, and\n * `code_128` is the label on a shipment. The rest are here because the spec has them\n * and asking for one costs nothing.\n */\nexport type BarcodeFormat =\n    | \"aztec\"\n    | \"codabar\"\n    | \"code_128\"\n    | \"code_39\"\n    | \"code_93\"\n    | \"data_matrix\"\n    | \"ean_13\"\n    | \"ean_8\"\n    | \"itf\"\n    | \"pdf417\"\n    | \"qr_code\"\n    | \"upc_a\"\n    | \"upc_e\"\n    | \"unknown\";\n\n/** Every symbology in the spec, used to validate what a detector reports back. */\nexport const ALL_BARCODE_FORMATS: readonly BarcodeFormat[] = [\n    \"aztec\",\n    \"codabar\",\n    \"code_128\",\n    \"code_39\",\n    \"code_93\",\n    \"data_matrix\",\n    \"ean_13\",\n    \"ean_8\",\n    \"itf\",\n    \"pdf417\",\n    \"qr_code\",\n    \"upc_a\",\n    \"upc_e\",\n    \"unknown\",\n];\n\n/**\n * What a scanner looks for when you do not say.\n *\n * Deliberately three formats, not all fourteen. Every extra symbology is more work\n * per frame, and on a mid-range phone the difference between three and fourteen is the\n * difference between a scanner that locks on instantly and one that feels broken.\n */\nexport const DEFAULT_BARCODE_FORMATS: readonly BarcodeFormat[] = [\"qr_code\", \"ean_13\", \"code_128\"];\n\n/** A corner of a detected symbol, in the source's pixel coordinates. */\nexport interface BarcodePoint {\n    x: number;\n    y: number;\n}\n\n/** One decoded symbol, normalised. */\nexport interface BarcodeScanResult {\n    /** The decoded payload — a GTIN, a URL, a Pix BR Code. */\n    rawValue: string;\n    /** Which symbology it was read as. `\"unknown\"` when the engine does not say. */\n    format: BarcodeFormat;\n    /** Box in source pixels, or `null` when the engine reports none. */\n    boundingBox: DOMRectReadOnly | null;\n    /** Corners in source pixels, clockwise from top-left. Empty when unreported. */\n    cornerPoints: readonly BarcodePoint[];\n}\n\n/**\n * The shape a detector resolves with, before normalisation.\n *\n * Every field is optional because a polyfill is allowed to report the value and no\n * geometry at all, and the native engines differ on `cornerPoints`.\n */\nexport interface DetectedBarcodeLike {\n    rawValue?: string;\n    format?: string;\n    boundingBox?: DOMRectReadOnly;\n    cornerPoints?: readonly BarcodePoint[];\n}\n\n/**\n * The slice of `BarcodeDetector` this SDK uses.\n *\n * Exported so a consumer can **inject a polyfill** where the native API is missing —\n * see {@link isBarcodeDetectionSupported} for why that matters — and so tests can hand\n * in a decoder without a camera. Anything with a `detect()` that resolves to objects\n * carrying a `rawValue` will do.\n */\nexport interface BarcodeDetectorLike {\n    /**\n     * Decode every symbol visible in the source.\n     *\n     * @param source - A `<video>`, a `<canvas>`, an `ImageBitmap`, a `Blob`…\n     * @returns Every symbol found, or an empty array — finding nothing is not an error.\n     */\n    detect: (source: ImageBitmapSource) => Promise<readonly DetectedBarcodeLike[]>;\n}\n\n/** The constructor, as Chromium exposes it on the global scope. */\ninterface BarcodeDetectorConstructorLike {\n    new (options?: { formats?: readonly string[] }): BarcodeDetectorLike;\n    getSupportedFormats?: () => Promise<readonly string[]>;\n}\n\n/**\n * Read the constructor off the global scope, or `null` when the engine has none.\n *\n * Kept private: everything a consumer needs is covered by\n * {@link isBarcodeDetectionSupported}, {@link getSupportedBarcodeFormats} and\n * {@link createBarcodeDetector}.\n */\nfunction barcodeDetectorConstructor(): BarcodeDetectorConstructorLike | null {\n    const candidate = (globalThis as { BarcodeDetector?: unknown }).BarcodeDetector;\n    return typeof candidate === \"function\" ? (candidate as BarcodeDetectorConstructorLike) : null;\n}\n\n/**\n * Whether this browser can decode barcodes on its own.\n *\n * **Expect `false` on a lot of real devices, and design for it.** `BarcodeDetector` is\n * a Chromium-only API backed by a platform decoder, so it is there on Android and\n * ChromeOS, usually there on macOS, and **absent** on Chromium for Windows and Linux,\n * in Firefox, and in every browser on iOS (all of which are WebKit underneath,\n * including Chrome for iOS).\n *\n * This SDK ships **no** decoder of its own and no bundled fallback: a QR reader is\n * Reed–Solomon error correction plus perspective correction plus a finder-pattern\n * search, and the honest options are a WASM build every consumer of this SDK would pay\n * for, or nothing. So the escape hatch is injection instead — pass any\n * {@link BarcodeDetectorLike} (the `barcode-detector` polyfill, your own `zxing-wasm`\n * wrapper) as `detector` to `useBarcodeScanner`, and the SDK drives it exactly like\n * the native one.\n *\n * @returns `true` when `new BarcodeDetector()` will work.\n */\nexport function isBarcodeDetectionSupported(): boolean {\n    return barcodeDetectorConstructor() !== null;\n}\n\n/**\n * Which symbologies this engine will actually decode.\n *\n * Worth asking rather than assuming: the format list belongs to the platform decoder,\n * not to the browser, so two Chromium builds on two operating systems answer\n * differently — and asking for a format the engine does not have makes the constructor\n * throw `NotSupportedError`, which reads like a bug in your code.\n *\n * @returns The supported formats, or an empty array when there is no detector.\n */\nexport async function getSupportedBarcodeFormats(): Promise<readonly BarcodeFormat[]> {\n    const constructor = barcodeDetectorConstructor();\n    if (!constructor || typeof constructor.getSupportedFormats !== \"function\") return [];\n    try {\n        const formats = await constructor.getSupportedFormats();\n        return formats.filter((format): format is BarcodeFormat =>\n            ALL_BARCODE_FORMATS.includes(format as BarcodeFormat),\n        );\n    } catch {\n        return [];\n    }\n}\n\n/**\n * Build a native detector for the given formats.\n *\n * @param formats - Symbologies to look for. Must be ones the engine supports.\n * @returns The detector, or `null` when the API is missing or refused the formats.\n */\nexport function createBarcodeDetector(\n    formats: readonly BarcodeFormat[] = DEFAULT_BARCODE_FORMATS,\n): BarcodeDetectorLike | null {\n    const constructor = barcodeDetectorConstructor();\n    if (!constructor) return null;\n    try {\n        return new constructor({ formats: [...formats] });\n    } catch {\n        return null;\n    }\n}\n\n/**\n * Turn one raw detection into a {@link BarcodeScanResult}.\n *\n * An unrecognised `format` string becomes `\"unknown\"` rather than being passed through\n * as a lie about the union, and missing geometry becomes `null`/`[]` rather than\n * `undefined`, so a consumer never has to branch on three kinds of absence.\n *\n * @param raw - What the detector resolved with.\n * @param known - The formats considered valid. Defaults to the whole spec list.\n * @returns The normalised result.\n */\nexport function normalizeBarcode(\n    raw: DetectedBarcodeLike,\n    known: readonly BarcodeFormat[] = ALL_BARCODE_FORMATS,\n): BarcodeScanResult {\n    const format = raw.format as BarcodeFormat | undefined;\n    return {\n        rawValue: raw.rawValue ?? \"\",\n        format: format !== undefined && known.includes(format) ? format : \"unknown\",\n        boundingBox: raw.boundingBox ?? null,\n        cornerPoints: raw.cornerPoints ?? [],\n    };\n}\n"],"mappings":";AAyBA,IAAaA,IAAgD;CACzD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACJ,GASaC,IAAoD;CAAC;CAAW;CAAU;AAAU;AAgEjG,SAASC,IAAoE;CACzE,IAAMC,IAAa,WAA6C;CAChE,OAAO,OAAOA,KAAc,aAAcA,IAA+C;AAC7F;AAqBA,SAAgBC,IAAuC;CACnD,OAAOF,EAA2B,MAAM;AAC5C;AAYA,eAAsBG,IAAgE;CAClF,IAAMC,IAAcJ,EAA2B;CAC/C,IAAI,CAACI,KAAe,OAAOA,EAAY,uBAAwB,YAAY,OAAO,CAAC;CACnF,IAAI;EAEA,QAAO,MADeA,EAAY,oBAAoB,EAAA,CACvC,QAAQ,MACnBN,EAAoB,SAASO,CAAuB,CACxD;CACJ,QAAQ;EACJ,OAAO,CAAC;CACZ;AACJ;AAQA,SAAgBC,EACZ,IAAoCP,GACV;CAC1B,IAAMK,IAAcJ,EAA2B;CAC/C,IAAI,CAACI,GAAa,OAAO;CACzB,IAAI;EACA,OAAO,IAAIA,EAAY,EAAE,SAAS,CAAC,GAAGG,CAAO,EAAE,CAAC;CACpD,QAAQ;EACJ,OAAO;CACX;AACJ;AAaA,SAAgBC,EACZ,GACA,IAAkCV,GACjB;CACjB,IAAMO,IAASI,EAAI;CACnB,OAAO;EACH,UAAUA,EAAI,YAAY;EAC1B,QAAQJ,MAAW,KAAA,KAAaK,EAAM,SAASL,CAAM,IAAIA,IAAS;EAClE,aAAaI,EAAI,eAAe;EAChC,cAAcA,EAAI,gBAAgB,CAAC;CACvC;AACJ"}

package/dist/capture/media-recorder.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"media-recorder.cjs","names":[],"sources":["../../src/capture/media-recorder.ts"],"sourcesContent":["/**\n * @tempest-limits function-lines — the engine behind both the audio and the video\n * recorder: MIME negotiation, the state machine MediaRecorder does not give you, and\n * the clock kept by hand because a fresh WebM reports no duration. The clock has to\n * pause and resume with the state machine, so they are one closure.\n */\n/** Lifecycle of a recording. */\nexport type MediaRecorderStatus = \"idle\" | \"recording\" | \"paused\" | \"stopped\";\n\n/** What a track carries — used only to word the errors this engine throws. */\nexport type MediaRecordingKind = \"audio\" | \"video\";\n\n/** A finished recording, whatever it was made of. */\nexport interface MediaRecording {\n    /** The bytes. Wrap with `useObjectUrl` to play it, or POST it as-is. */\n    blob: Blob;\n    /** What the browser actually produced — not necessarily what you asked for. */\n    mimeType: string;\n    /** Recorded length, excluding time spent paused. */\n    durationMs: number;\n}\n\n/** Options for {@link createMediaRecorder}. */\nexport interface MediaRecordingOptions {\n    /**\n     * Container candidates, best first. Required: this engine has no opinion about\n     * codecs — the audio and video wrappers own that list.\n     */\n    candidates: readonly string[];\n    /** Wording for the thrown messages (\"cannot record any supported *video* container\"). */\n    kind: MediaRecordingKind;\n    /** Force a container, bypassing the negotiation. Throws when unsupported. */\n    mimeType?: string;\n    /** Target audio bitrate. */\n    audioBitsPerSecond?: number;\n    /** Target video bitrate. Ignored by the browser on an audio-only stream. */\n    videoBitsPerSecond?: number;\n    /**\n     * Emit a chunk every N ms through `onChunk`, for streaming upload.\n     *\n     * Without it the whole recording is buffered in memory until `stop()`.\n     */\n    timesliceMs?: number;\n    /** Receives each chunk when `timesliceMs` is set. Chunks are **not** independently playable. */\n    onChunk?: (chunk: Blob) => void;\n    /** Recorder-level failure (device unplugged mid-recording, encoder error). */\n    onError?: (error: unknown) => void;\n}\n\n/** Imperative recorder over one `MediaStream`. */\nexport interface MediaRecorderHandle {\n    /** Begin recording. No-op when already recording or paused. */\n    start: () => void;\n    /** Pause. The clock stops; `durationMs` freezes. */\n    pause: () => void;\n    /** Resume after `pause()`. */\n    resume: () => void;\n    /** Stop and resolve with the assembled recording. */\n    stop: () => Promise<MediaRecording>;\n    /** Stop and throw the bytes away. */\n    cancel: () => void;\n    status: () => MediaRecorderStatus;\n    /** Recorded length so far, excluding paused time. */\n    durationMs: () => number;\n    /** The negotiated container. */\n    mimeType: string;\n}\n\n/**\n * First container in `preferred` the browser can actually produce, or `null`.\n *\n * @param preferred - Candidates, best first.\n * @returns A supported MIME type, or `null` when none is.\n */\nexport function pickRecordingMimeType(preferred: readonly string[]): string | null {\n    if (typeof MediaRecorder === \"undefined\") return null;\n    // Older WebViews ship `MediaRecorder` without the static probe. Assume the first\n    // candidate rather than refusing outright — the constructor will tell us.\n    if (typeof MediaRecorder.isTypeSupported !== \"function\") return preferred[0] ?? null;\n    return preferred.find((type) => MediaRecorder.isTypeSupported(type)) ?? null;\n}\n\n/**\n * Wrap a `MediaStream` in a recorder with a real state machine and an honest clock.\n *\n * This is the engine behind both `createAudioRecorder` and `createVideoRecorder`; the\n * only thing it does not decide is which containers to try, because that is the one\n * part that genuinely differs between the two.\n *\n * Two things `MediaRecorder` does not give you:\n *\n * - **A duration.** It reports none, and the `Blob` has no reliable one either —\n *   WebM written by `MediaRecorder` carries no duration in its header, which is why\n *   `<audio>`/`<video>` shows `Infinity` for a fresh recording. So the clock is kept\n *   here, and it subtracts paused time: a recorder that counts wall-clock through a\n *   pause reports a 30-second note as two minutes.\n * - **A promise from `stop()`.** The last chunk arrives *after* `stop()` returns, in\n *   a `dataavailable` event that fires before `onstop`. Assembling the blob in\n *   `onstop` is the only point where every chunk is in hand.\n *\n * The stream is **not** owned here: `stop()` leaves the device open so a retake does\n * not need a second permission round-trip. Release it with the owning hook's `stop()`.\n *\n * @param stream - A live stream, from `getUserMedia` or `getDisplayMedia`.\n * @param options - See {@link MediaRecordingOptions}.\n * @returns The imperative recorder.\n * @throws When `MediaRecorder` is unavailable, or an explicit `mimeType` is unsupported.\n */\nexport function createMediaRecorder(\n    stream: MediaStream,\n    options: MediaRecordingOptions,\n): MediaRecorderHandle {\n    const {\n        candidates,\n        kind,\n        mimeType: forced,\n        audioBitsPerSecond,\n        videoBitsPerSecond,\n        timesliceMs,\n        onChunk,\n        onError,\n    } = options;\n\n    if (typeof MediaRecorder === \"undefined\") {\n        throw new Error(\"MediaRecorder is not available in this environment.\");\n    }\n    const negotiated = forced ?? pickRecordingMimeType(candidates);\n    if (negotiated === null) {\n        throw new Error(`This browser cannot record any supported ${kind} container.`);\n    }\n    if (\n        forced !== undefined &&\n        typeof MediaRecorder.isTypeSupported === \"function\" &&\n        !MediaRecorder.isTypeSupported(forced)\n    ) {\n        throw new Error(`This browser cannot record \"${forced}\".`);\n    }\n\n    const recorder = new MediaRecorder(stream, {\n        mimeType: negotiated,\n        ...(audioBitsPerSecond !== undefined ? { audioBitsPerSecond } : {}),\n        ...(videoBitsPerSecond !== undefined ? { videoBitsPerSecond } : {}),\n    });\n\n    let chunks: Blob[] = [];\n    let status: MediaRecorderStatus = \"idle\";\n    let accumulatedMs = 0;\n    let segmentStart = 0;\n    let settle: ((recording: MediaRecording) => void) | null = null;\n    let discard = false;\n\n    const elapsed = (): number =>\n        accumulatedMs + (status === \"recording\" ? Date.now() - segmentStart : 0);\n\n    recorder.ondataavailable = (event: BlobEvent): void => {\n        if (event.data.size === 0) return;\n        if (discard) return;\n        chunks.push(event.data);\n        onChunk?.(event.data);\n    };\n\n    recorder.onerror = (event: Event): void => {\n        onError?.((event as unknown as { error?: unknown }).error ?? event);\n    };\n\n    recorder.onstop = (): void => {\n        const durationMs = elapsed();\n        status = \"stopped\";\n        const resolve = settle;\n        settle = null;\n        if (discard) {\n            chunks = [];\n            return;\n        }\n        // `recorder.mimeType` is the source of truth: a browser handed\n        // `video/webm;codecs=vp9,opus` may report plain `video/webm` back.\n        const type = recorder.mimeType || negotiated;\n        resolve?.({ blob: new Blob(chunks, { type }), mimeType: type, durationMs });\n        chunks = [];\n    };\n\n    return {\n        mimeType: negotiated,\n        status: () => status,\n        durationMs: elapsed,\n\n        start(): void {\n            if (status === \"recording\" || status === \"paused\") return;\n            chunks = [];\n            accumulatedMs = 0;\n            discard = false;\n            segmentStart = Date.now();\n            status = \"recording\";\n            if (timesliceMs !== undefined) recorder.start(timesliceMs);\n            else recorder.start();\n        },\n\n        pause(): void {\n            if (status !== \"recording\") return;\n            accumulatedMs += Date.now() - segmentStart;\n            status = \"paused\";\n            recorder.pause();\n        },\n\n        resume(): void {\n            if (status !== \"paused\") return;\n            segmentStart = Date.now();\n            status = \"recording\";\n            recorder.resume();\n        },\n\n        stop(): Promise<MediaRecording> {\n            if (status === \"idle\" || status === \"stopped\") {\n                return Promise.resolve({\n                    blob: new Blob([], { type: negotiated }),\n                    mimeType: negotiated,\n                    durationMs: 0,\n                });\n            }\n            // Stopping while paused needs no clock fix-up: `pause()` already folded\n            // the last segment into `accumulatedMs`, and `elapsed()` adds nothing\n            // while the status is not `\"recording\"`.\n            return new Promise<MediaRecording>((resolve) => {\n                settle = resolve;\n                recorder.stop();\n            });\n        },\n\n        cancel(): void {\n            if (status === \"idle\" || status === \"stopped\") return;\n            discard = true;\n            settle = null;\n            recorder.stop();\n        },\n    };\n}\n"],"mappings":"AA0EA,SAAgB,EAAsB,EAA6C,CAK/E,OAJI,OAAO,cAAkB,IAAoB,KAG7C,OAAO,cAAc,iBAAoB,WACtC,EAAU,KAAM,GAAS,cAAc,gBAAgB,CAAI,CAAC,GAAK,KADR,EAAU,IAAM,IAEpF,CA4BA,SAAgB,EACZ,EACA,EACmB,CACnB,GAAM,CACF,aACA,OACA,SAAU,EACV,qBACA,qBACA,cACA,UACA,WACA,EAEJ,GAAI,OAAO,cAAkB,IACzB,MAAU,MAAM,qDAAqD,EAEzE,IAAM,EAAa,GAAU,EAAsB,CAAU,EAC7D,GAAI,IAAe,KACf,MAAU,MAAM,4CAA4C,EAAK,YAAY,EAEjF,GACI,IAAW,IAAA,IACX,OAAO,cAAc,iBAAoB,YACzC,CAAC,cAAc,gBAAgB,CAAM,EAErC,MAAU,MAAM,+BAA+B,EAAO,GAAG,EAG7D,IAAM,EAAW,IAAI,cAAc,EAAQ,CACvC,SAAU,EACV,GAAI,IAAuB,IAAA,GAAqC,CAAC,EAA1B,CAAE,oBAAmB,EAC5D,GAAI,IAAuB,IAAA,GAAqC,CAAC,EAA1B,CAAE,oBAAmB,CAChE,CAAC,EAEG,EAAiB,CAAC,EAClB,EAA8B,OAC9B,EAAgB,EAChB,EAAe,EACf,EAAuD,KACvD,EAAU,GAER,MACF,GAAiB,IAAW,YAAc,KAAK,IAAI,EAAI,EAAe,GA6B1E,MA3BA,GAAS,gBAAmB,GAA2B,CAC/C,EAAM,KAAK,OAAS,IACpB,IACJ,EAAO,KAAK,EAAM,IAAI,EACtB,IAAU,EAAM,IAAI,GACxB,EAEA,EAAS,QAAW,GAAuB,CACvC,IAAW,EAAyC,OAAS,CAAK,CACtE,EAEA,EAAS,WAAqB,CAC1B,IAAM,EAAa,EAAQ,EAC3B,EAAS,UACT,IAAM,EAAU,EAEhB,GADA,EAAS,KACL,EAAS,CACT,EAAS,CAAC,EACV,MACJ,CAGA,IAAM,EAAO,EAAS,UAAY,EAClC,IAAU,CAAE,KAAM,IAAI,KAAK,EAAQ,CAAE,MAAK,CAAC,EAAG,SAAU,EAAM,YAAW,CAAC,EAC1E,EAAS,CAAC,CACd,EAEO,CACH,SAAU,EACV,WAAc,EACd,WAAY,EAEZ,OAAc,CACN,IAAW,aAAe,IAAW,WACzC,EAAS,CAAC,EACV,EAAgB,EAChB,EAAU,GACV,EAAe,KAAK,IAAI,EACxB,EAAS,YACL,IAAgB,IAAA,GACf,EAAS,MAAM,EADW,EAAS,MAAM,CAAW,EAE7D,EAEA,OAAc,CACN,IAAW,cACf,GAAiB,KAAK,IAAI,EAAI,EAC9B,EAAS,SACT,EAAS,MAAM,EACnB,EAEA,QAAe,CACP,IAAW,WACf,EAAe,KAAK,IAAI,EACxB,EAAS,YACT,EAAS,OAAO,EACpB,EAEA,MAAgC,CAW5B,OAVI,IAAW,QAAU,IAAW,UACzB,QAAQ,QAAQ,CACnB,KAAM,IAAI,KAAK,CAAC,EAAG,CAAE,KAAM,CAAW,CAAC,EACvC,SAAU,EACV,WAAY,CAChB,CAAC,EAKE,IAAI,QAAyB,GAAY,CAC5C,EAAS,EACT,EAAS,KAAK,CAClB,CAAC,CACL,EAEA,QAAe,CACP,IAAW,QAAU,IAAW,YACpC,EAAU,GACV,EAAS,KACT,EAAS,KAAK,EAClB,CACJ,CACJ"}
+{"version":3,"file":"media-recorder.cjs","names":["pickRecordingMimeType","preferred","type","createMediaRecorder","forced","options","negotiated","candidates","kind","recorder","stream","audioBitsPerSecond","videoBitsPerSecond","chunks","status","accumulatedMs","segmentStart","settle","discard","elapsed","event","onChunk","onError","durationMs","resolve","timesliceMs"],"sources":["../../src/capture/media-recorder.ts"],"sourcesContent":["/**\n * @tempest-limits function-lines — the engine behind both the audio and the video\n * recorder: MIME negotiation, the state machine MediaRecorder does not give you, and\n * the clock kept by hand because a fresh WebM reports no duration. The clock has to\n * pause and resume with the state machine, so they are one closure.\n */\n/** Lifecycle of a recording. */\nexport type MediaRecorderStatus = \"idle\" | \"recording\" | \"paused\" | \"stopped\";\n\n/** What a track carries — used only to word the errors this engine throws. */\nexport type MediaRecordingKind = \"audio\" | \"video\";\n\n/** A finished recording, whatever it was made of. */\nexport interface MediaRecording {\n    /** The bytes. Wrap with `useObjectUrl` to play it, or POST it as-is. */\n    blob: Blob;\n    /** What the browser actually produced — not necessarily what you asked for. */\n    mimeType: string;\n    /** Recorded length, excluding time spent paused. */\n    durationMs: number;\n}\n\n/** Options for {@link createMediaRecorder}. */\nexport interface MediaRecordingOptions {\n    /**\n     * Container candidates, best first. Required: this engine has no opinion about\n     * codecs — the audio and video wrappers own that list.\n     */\n    candidates: readonly string[];\n    /** Wording for the thrown messages (\"cannot record any supported *video* container\"). */\n    kind: MediaRecordingKind;\n    /** Force a container, bypassing the negotiation. Throws when unsupported. */\n    mimeType?: string;\n    /** Target audio bitrate. */\n    audioBitsPerSecond?: number;\n    /** Target video bitrate. Ignored by the browser on an audio-only stream. */\n    videoBitsPerSecond?: number;\n    /**\n     * Emit a chunk every N ms through `onChunk`, for streaming upload.\n     *\n     * Without it the whole recording is buffered in memory until `stop()`.\n     */\n    timesliceMs?: number;\n    /** Receives each chunk when `timesliceMs` is set. Chunks are **not** independently playable. */\n    onChunk?: (chunk: Blob) => void;\n    /** Recorder-level failure (device unplugged mid-recording, encoder error). */\n    onError?: (error: unknown) => void;\n}\n\n/** Imperative recorder over one `MediaStream`. */\nexport interface MediaRecorderHandle {\n    /** Begin recording. No-op when already recording or paused. */\n    start: () => void;\n    /** Pause. The clock stops; `durationMs` freezes. */\n    pause: () => void;\n    /** Resume after `pause()`. */\n    resume: () => void;\n    /** Stop and resolve with the assembled recording. */\n    stop: () => Promise<MediaRecording>;\n    /** Stop and throw the bytes away. */\n    cancel: () => void;\n    status: () => MediaRecorderStatus;\n    /** Recorded length so far, excluding paused time. */\n    durationMs: () => number;\n    /** The negotiated container. */\n    mimeType: string;\n}\n\n/**\n * First container in `preferred` the browser can actually produce, or `null`.\n *\n * @param preferred - Candidates, best first.\n * @returns A supported MIME type, or `null` when none is.\n */\nexport function pickRecordingMimeType(preferred: readonly string[]): string | null {\n    if (typeof MediaRecorder === \"undefined\") return null;\n    // Older WebViews ship `MediaRecorder` without the static probe. Assume the first\n    // candidate rather than refusing outright — the constructor will tell us.\n    if (typeof MediaRecorder.isTypeSupported !== \"function\") return preferred[0] ?? null;\n    return preferred.find((type) => MediaRecorder.isTypeSupported(type)) ?? null;\n}\n\n/**\n * Wrap a `MediaStream` in a recorder with a real state machine and an honest clock.\n *\n * This is the engine behind both `createAudioRecorder` and `createVideoRecorder`; the\n * only thing it does not decide is which containers to try, because that is the one\n * part that genuinely differs between the two.\n *\n * Two things `MediaRecorder` does not give you:\n *\n * - **A duration.** It reports none, and the `Blob` has no reliable one either —\n *   WebM written by `MediaRecorder` carries no duration in its header, which is why\n *   `<audio>`/`<video>` shows `Infinity` for a fresh recording. So the clock is kept\n *   here, and it subtracts paused time: a recorder that counts wall-clock through a\n *   pause reports a 30-second note as two minutes.\n * - **A promise from `stop()`.** The last chunk arrives *after* `stop()` returns, in\n *   a `dataavailable` event that fires before `onstop`. Assembling the blob in\n *   `onstop` is the only point where every chunk is in hand.\n *\n * The stream is **not** owned here: `stop()` leaves the device open so a retake does\n * not need a second permission round-trip. Release it with the owning hook's `stop()`.\n *\n * @param stream - A live stream, from `getUserMedia` or `getDisplayMedia`.\n * @param options - See {@link MediaRecordingOptions}.\n * @returns The imperative recorder.\n * @throws When `MediaRecorder` is unavailable, or an explicit `mimeType` is unsupported.\n */\nexport function createMediaRecorder(\n    stream: MediaStream,\n    options: MediaRecordingOptions,\n): MediaRecorderHandle {\n    const {\n        candidates,\n        kind,\n        mimeType: forced,\n        audioBitsPerSecond,\n        videoBitsPerSecond,\n        timesliceMs,\n        onChunk,\n        onError,\n    } = options;\n\n    if (typeof MediaRecorder === \"undefined\") {\n        throw new Error(\"MediaRecorder is not available in this environment.\");\n    }\n    const negotiated = forced ?? pickRecordingMimeType(candidates);\n    if (negotiated === null) {\n        throw new Error(`This browser cannot record any supported ${kind} container.`);\n    }\n    if (\n        forced !== undefined &&\n        typeof MediaRecorder.isTypeSupported === \"function\" &&\n        !MediaRecorder.isTypeSupported(forced)\n    ) {\n        throw new Error(`This browser cannot record \"${forced}\".`);\n    }\n\n    const recorder = new MediaRecorder(stream, {\n        mimeType: negotiated,\n        ...(audioBitsPerSecond !== undefined ? { audioBitsPerSecond } : {}),\n        ...(videoBitsPerSecond !== undefined ? { videoBitsPerSecond } : {}),\n    });\n\n    let chunks: Blob[] = [];\n    let status: MediaRecorderStatus = \"idle\";\n    let accumulatedMs = 0;\n    let segmentStart = 0;\n    let settle: ((recording: MediaRecording) => void) | null = null;\n    let discard = false;\n\n    const elapsed = (): number =>\n        accumulatedMs + (status === \"recording\" ? Date.now() - segmentStart : 0);\n\n    recorder.ondataavailable = (event: BlobEvent): void => {\n        if (event.data.size === 0) return;\n        if (discard) return;\n        chunks.push(event.data);\n        onChunk?.(event.data);\n    };\n\n    recorder.onerror = (event: Event): void => {\n        onError?.((event as unknown as { error?: unknown }).error ?? event);\n    };\n\n    recorder.onstop = (): void => {\n        const durationMs = elapsed();\n        status = \"stopped\";\n        const resolve = settle;\n        settle = null;\n        if (discard) {\n            chunks = [];\n            return;\n        }\n        // `recorder.mimeType` is the source of truth: a browser handed\n        // `video/webm;codecs=vp9,opus` may report plain `video/webm` back.\n        const type = recorder.mimeType || negotiated;\n        resolve?.({ blob: new Blob(chunks, { type }), mimeType: type, durationMs });\n        chunks = [];\n    };\n\n    return {\n        mimeType: negotiated,\n        status: () => status,\n        durationMs: elapsed,\n\n        start(): void {\n            if (status === \"recording\" || status === \"paused\") return;\n            chunks = [];\n            accumulatedMs = 0;\n            discard = false;\n            segmentStart = Date.now();\n            status = \"recording\";\n            if (timesliceMs !== undefined) recorder.start(timesliceMs);\n            else recorder.start();\n        },\n\n        pause(): void {\n            if (status !== \"recording\") return;\n            accumulatedMs += Date.now() - segmentStart;\n            status = \"paused\";\n            recorder.pause();\n        },\n\n        resume(): void {\n            if (status !== \"paused\") return;\n            segmentStart = Date.now();\n            status = \"recording\";\n            recorder.resume();\n        },\n\n        stop(): Promise<MediaRecording> {\n            if (status === \"idle\" || status === \"stopped\") {\n                return Promise.resolve({\n                    blob: new Blob([], { type: negotiated }),\n                    mimeType: negotiated,\n                    durationMs: 0,\n                });\n            }\n            // Stopping while paused needs no clock fix-up: `pause()` already folded\n            // the last segment into `accumulatedMs`, and `elapsed()` adds nothing\n            // while the status is not `\"recording\"`.\n            return new Promise<MediaRecording>((resolve) => {\n                settle = resolve;\n                recorder.stop();\n            });\n        },\n\n        cancel(): void {\n            if (status === \"idle\" || status === \"stopped\") return;\n            discard = true;\n            settle = null;\n            recorder.stop();\n        },\n    };\n}\n"],"mappings":"AA0EA,SAAgBA,EAAsB,EAA6C,CAK/E,OAJI,OAAO,cAAkB,IAAoB,KAG7C,OAAO,cAAc,iBAAoB,WACtCC,EAAU,KAAM,GAAS,cAAc,gBAAgBC,CAAI,CAAC,GAAK,KADRD,EAAU,IAAM,IAEpF,CA4BA,SAAgBE,EACZ,EACA,EACmB,CACnB,GAAM,CACF,aACA,OACA,SAAUC,EACV,qBACA,qBACA,cACA,UACA,WACAC,EAEJ,GAAI,OAAO,cAAkB,IACzB,MAAU,MAAM,qDAAqD,EAEzE,IAAMC,EAAaF,GAAUJ,EAAsBO,CAAU,EAC7D,GAAID,IAAe,KACf,MAAU,MAAM,4CAA4CE,EAAK,YAAY,EAEjF,GACIJ,IAAW,IAAA,IACX,OAAO,cAAc,iBAAoB,YACzC,CAAC,cAAc,gBAAgBA,CAAM,EAErC,MAAU,MAAM,+BAA+BA,EAAO,GAAG,EAG7D,IAAMK,EAAW,IAAI,cAAcC,EAAQ,CACvC,SAAUJ,EACV,GAAIK,IAAuB,IAAA,GAAqC,CAAC,EAA1B,CAAE,oBAAmB,EAC5D,GAAIC,IAAuB,IAAA,GAAqC,CAAC,EAA1B,CAAE,oBAAmB,CAChE,CAAC,EAEGC,EAAiB,CAAC,EAClBC,EAA8B,OAC9BC,EAAgB,EAChBC,EAAe,EACfC,EAAuD,KACvDC,EAAU,GAERC,MACFJ,GAAiBD,IAAW,YAAc,KAAK,IAAI,EAAIE,EAAe,GA6B1E,MA3BA,GAAS,gBAAmB,GAA2B,CAC/CI,EAAM,KAAK,OAAS,IACpBF,IACJL,EAAO,KAAKO,EAAM,IAAI,EACtBC,IAAUD,EAAM,IAAI,GACxB,EAEA,EAAS,QAAW,GAAuB,CACvCE,IAAWF,EAAyC,OAASA,CAAK,CACtE,EAEA,EAAS,WAAqB,CAC1B,IAAMG,EAAaJ,EAAQ,EAC3B,EAAS,UACT,IAAMK,EAAUP,EAEhB,GADA,EAAS,KACLC,EAAS,CACT,EAAS,CAAC,EACV,MACJ,CAGA,IAAMhB,EAAOO,EAAS,UAAYH,EAClCkB,IAAU,CAAE,KAAM,IAAI,KAAKX,EAAQ,CAAE,MAAK,CAAC,EAAG,SAAUX,EAAM,YAAW,CAAC,EAC1E,EAAS,CAAC,CACd,EAEO,CACH,SAAUI,EACV,WAAcQ,EACd,WAAYK,EAEZ,OAAc,CACNL,IAAW,aAAeA,IAAW,WACzC,EAAS,CAAC,EACV,EAAgB,EAChB,EAAU,GACV,EAAe,KAAK,IAAI,EACxB,EAAS,YACLW,IAAgB,IAAA,GACfhB,EAAS,MAAM,EADWA,EAAS,MAAMgB,CAAW,EAE7D,EAEA,OAAc,CACNX,IAAW,cACf,GAAiB,KAAK,IAAI,EAAIE,EAC9B,EAAS,SACTP,EAAS,MAAM,EACnB,EAEA,QAAe,CACPK,IAAW,WACf,EAAe,KAAK,IAAI,EACxB,EAAS,YACTL,EAAS,OAAO,EACpB,EAEA,MAAgC,CAW5B,OAVIK,IAAW,QAAUA,IAAW,UACzB,QAAQ,QAAQ,CACnB,KAAM,IAAI,KAAK,CAAC,EAAG,CAAE,KAAMR,CAAW,CAAC,EACvC,SAAUA,EACV,WAAY,CAChB,CAAC,EAKE,IAAI,QAAyB,GAAY,CAC5C,EAASkB,EACTf,EAAS,KAAK,CAClB,CAAC,CACL,EAEA,QAAe,CACPK,IAAW,QAAUA,IAAW,YACpC,EAAU,GACV,EAAS,KACTL,EAAS,KAAK,EAClB,CACJ,CACJ,C"}

package/dist/capture/media-recorder.js.map

@@ -1 +1 @@
-{"version":3,"file":"media-recorder.js","names":[],"sources":["../../src/capture/media-recorder.ts"],"sourcesContent":["/**\n * @tempest-limits function-lines — the engine behind both the audio and the video\n * recorder: MIME negotiation, the state machine MediaRecorder does not give you, and\n * the clock kept by hand because a fresh WebM reports no duration. The clock has to\n * pause and resume with the state machine, so they are one closure.\n */\n/** Lifecycle of a recording. */\nexport type MediaRecorderStatus = \"idle\" | \"recording\" | \"paused\" | \"stopped\";\n\n/** What a track carries — used only to word the errors this engine throws. */\nexport type MediaRecordingKind = \"audio\" | \"video\";\n\n/** A finished recording, whatever it was made of. */\nexport interface MediaRecording {\n    /** The bytes. Wrap with `useObjectUrl` to play it, or POST it as-is. */\n    blob: Blob;\n    /** What the browser actually produced — not necessarily what you asked for. */\n    mimeType: string;\n    /** Recorded length, excluding time spent paused. */\n    durationMs: number;\n}\n\n/** Options for {@link createMediaRecorder}. */\nexport interface MediaRecordingOptions {\n    /**\n     * Container candidates, best first. Required: this engine has no opinion about\n     * codecs — the audio and video wrappers own that list.\n     */\n    candidates: readonly string[];\n    /** Wording for the thrown messages (\"cannot record any supported *video* container\"). */\n    kind: MediaRecordingKind;\n    /** Force a container, bypassing the negotiation. Throws when unsupported. */\n    mimeType?: string;\n    /** Target audio bitrate. */\n    audioBitsPerSecond?: number;\n    /** Target video bitrate. Ignored by the browser on an audio-only stream. */\n    videoBitsPerSecond?: number;\n    /**\n     * Emit a chunk every N ms through `onChunk`, for streaming upload.\n     *\n     * Without it the whole recording is buffered in memory until `stop()`.\n     */\n    timesliceMs?: number;\n    /** Receives each chunk when `timesliceMs` is set. Chunks are **not** independently playable. */\n    onChunk?: (chunk: Blob) => void;\n    /** Recorder-level failure (device unplugged mid-recording, encoder error). */\n    onError?: (error: unknown) => void;\n}\n\n/** Imperative recorder over one `MediaStream`. */\nexport interface MediaRecorderHandle {\n    /** Begin recording. No-op when already recording or paused. */\n    start: () => void;\n    /** Pause. The clock stops; `durationMs` freezes. */\n    pause: () => void;\n    /** Resume after `pause()`. */\n    resume: () => void;\n    /** Stop and resolve with the assembled recording. */\n    stop: () => Promise<MediaRecording>;\n    /** Stop and throw the bytes away. */\n    cancel: () => void;\n    status: () => MediaRecorderStatus;\n    /** Recorded length so far, excluding paused time. */\n    durationMs: () => number;\n    /** The negotiated container. */\n    mimeType: string;\n}\n\n/**\n * First container in `preferred` the browser can actually produce, or `null`.\n *\n * @param preferred - Candidates, best first.\n * @returns A supported MIME type, or `null` when none is.\n */\nexport function pickRecordingMimeType(preferred: readonly string[]): string | null {\n    if (typeof MediaRecorder === \"undefined\") return null;\n    // Older WebViews ship `MediaRecorder` without the static probe. Assume the first\n    // candidate rather than refusing outright — the constructor will tell us.\n    if (typeof MediaRecorder.isTypeSupported !== \"function\") return preferred[0] ?? null;\n    return preferred.find((type) => MediaRecorder.isTypeSupported(type)) ?? null;\n}\n\n/**\n * Wrap a `MediaStream` in a recorder with a real state machine and an honest clock.\n *\n * This is the engine behind both `createAudioRecorder` and `createVideoRecorder`; the\n * only thing it does not decide is which containers to try, because that is the one\n * part that genuinely differs between the two.\n *\n * Two things `MediaRecorder` does not give you:\n *\n * - **A duration.** It reports none, and the `Blob` has no reliable one either —\n *   WebM written by `MediaRecorder` carries no duration in its header, which is why\n *   `<audio>`/`<video>` shows `Infinity` for a fresh recording. So the clock is kept\n *   here, and it subtracts paused time: a recorder that counts wall-clock through a\n *   pause reports a 30-second note as two minutes.\n * - **A promise from `stop()`.** The last chunk arrives *after* `stop()` returns, in\n *   a `dataavailable` event that fires before `onstop`. Assembling the blob in\n *   `onstop` is the only point where every chunk is in hand.\n *\n * The stream is **not** owned here: `stop()` leaves the device open so a retake does\n * not need a second permission round-trip. Release it with the owning hook's `stop()`.\n *\n * @param stream - A live stream, from `getUserMedia` or `getDisplayMedia`.\n * @param options - See {@link MediaRecordingOptions}.\n * @returns The imperative recorder.\n * @throws When `MediaRecorder` is unavailable, or an explicit `mimeType` is unsupported.\n */\nexport function createMediaRecorder(\n    stream: MediaStream,\n    options: MediaRecordingOptions,\n): MediaRecorderHandle {\n    const {\n        candidates,\n        kind,\n        mimeType: forced,\n        audioBitsPerSecond,\n        videoBitsPerSecond,\n        timesliceMs,\n        onChunk,\n        onError,\n    } = options;\n\n    if (typeof MediaRecorder === \"undefined\") {\n        throw new Error(\"MediaRecorder is not available in this environment.\");\n    }\n    const negotiated = forced ?? pickRecordingMimeType(candidates);\n    if (negotiated === null) {\n        throw new Error(`This browser cannot record any supported ${kind} container.`);\n    }\n    if (\n        forced !== undefined &&\n        typeof MediaRecorder.isTypeSupported === \"function\" &&\n        !MediaRecorder.isTypeSupported(forced)\n    ) {\n        throw new Error(`This browser cannot record \"${forced}\".`);\n    }\n\n    const recorder = new MediaRecorder(stream, {\n        mimeType: negotiated,\n        ...(audioBitsPerSecond !== undefined ? { audioBitsPerSecond } : {}),\n        ...(videoBitsPerSecond !== undefined ? { videoBitsPerSecond } : {}),\n    });\n\n    let chunks: Blob[] = [];\n    let status: MediaRecorderStatus = \"idle\";\n    let accumulatedMs = 0;\n    let segmentStart = 0;\n    let settle: ((recording: MediaRecording) => void) | null = null;\n    let discard = false;\n\n    const elapsed = (): number =>\n        accumulatedMs + (status === \"recording\" ? Date.now() - segmentStart : 0);\n\n    recorder.ondataavailable = (event: BlobEvent): void => {\n        if (event.data.size === 0) return;\n        if (discard) return;\n        chunks.push(event.data);\n        onChunk?.(event.data);\n    };\n\n    recorder.onerror = (event: Event): void => {\n        onError?.((event as unknown as { error?: unknown }).error ?? event);\n    };\n\n    recorder.onstop = (): void => {\n        const durationMs = elapsed();\n        status = \"stopped\";\n        const resolve = settle;\n        settle = null;\n        if (discard) {\n            chunks = [];\n            return;\n        }\n        // `recorder.mimeType` is the source of truth: a browser handed\n        // `video/webm;codecs=vp9,opus` may report plain `video/webm` back.\n        const type = recorder.mimeType || negotiated;\n        resolve?.({ blob: new Blob(chunks, { type }), mimeType: type, durationMs });\n        chunks = [];\n    };\n\n    return {\n        mimeType: negotiated,\n        status: () => status,\n        durationMs: elapsed,\n\n        start(): void {\n            if (status === \"recording\" || status === \"paused\") return;\n            chunks = [];\n            accumulatedMs = 0;\n            discard = false;\n            segmentStart = Date.now();\n            status = \"recording\";\n            if (timesliceMs !== undefined) recorder.start(timesliceMs);\n            else recorder.start();\n        },\n\n        pause(): void {\n            if (status !== \"recording\") return;\n            accumulatedMs += Date.now() - segmentStart;\n            status = \"paused\";\n            recorder.pause();\n        },\n\n        resume(): void {\n            if (status !== \"paused\") return;\n            segmentStart = Date.now();\n            status = \"recording\";\n            recorder.resume();\n        },\n\n        stop(): Promise<MediaRecording> {\n            if (status === \"idle\" || status === \"stopped\") {\n                return Promise.resolve({\n                    blob: new Blob([], { type: negotiated }),\n                    mimeType: negotiated,\n                    durationMs: 0,\n                });\n            }\n            // Stopping while paused needs no clock fix-up: `pause()` already folded\n            // the last segment into `accumulatedMs`, and `elapsed()` adds nothing\n            // while the status is not `\"recording\"`.\n            return new Promise<MediaRecording>((resolve) => {\n                settle = resolve;\n                recorder.stop();\n            });\n        },\n\n        cancel(): void {\n            if (status === \"idle\" || status === \"stopped\") return;\n            discard = true;\n            settle = null;\n            recorder.stop();\n        },\n    };\n}\n"],"mappings":";AA0EA,SAAgB,EAAsB,GAA6C;CAK/E,OAJI,OAAO,gBAAkB,MAAoB,OAG7C,OAAO,cAAc,mBAAoB,aACtC,EAAU,MAAM,MAAS,cAAc,gBAAgB,CAAI,CAAC,KAAK,OADR,EAAU,MAAM;AAEpF;AA4BA,SAAgB,EACZ,GACA,GACmB;CACnB,IAAM,EACF,eACA,SACA,UAAU,GACV,uBACA,uBACA,gBACA,YACA,eACA;CAEJ,IAAI,OAAO,gBAAkB,KACzB,MAAU,MAAM,qDAAqD;CAEzE,IAAM,IAAa,KAAU,EAAsB,CAAU;CAC7D,IAAI,MAAe,MACf,MAAU,MAAM,4CAA4C,EAAK,YAAY;CAEjF,IACI,MAAW,KAAA,KACX,OAAO,cAAc,mBAAoB,cACzC,CAAC,cAAc,gBAAgB,CAAM,GAErC,MAAU,MAAM,+BAA+B,EAAO,GAAG;CAG7D,IAAM,IAAW,IAAI,cAAc,GAAQ;EACvC,UAAU;EACV,GAAI,MAAuB,KAAA,IAAqC,CAAC,IAA1B,EAAE,sBAAmB;EAC5D,GAAI,MAAuB,KAAA,IAAqC,CAAC,IAA1B,EAAE,sBAAmB;CAChE,CAAC,GAEG,IAAiB,CAAC,GAClB,IAA8B,QAC9B,IAAgB,GAChB,IAAe,GACf,IAAuD,MACvD,IAAU,IAER,UACF,KAAiB,MAAW,cAAc,KAAK,IAAI,IAAI,IAAe;CA6B1E,OA3BA,EAAS,mBAAmB,MAA2B;EAC/C,EAAM,KAAK,SAAS,MACpB,MACJ,EAAO,KAAK,EAAM,IAAI,GACtB,IAAU,EAAM,IAAI;CACxB,GAEA,EAAS,WAAW,MAAuB;EACvC,IAAW,EAAyC,SAAS,CAAK;CACtE,GAEA,EAAS,eAAqB;EAC1B,IAAM,IAAa,EAAQ;EAC3B,IAAS;EACT,IAAM,IAAU;EAEhB,IADA,IAAS,MACL,GAAS;GACT,IAAS,CAAC;GACV;EACJ;EAGA,IAAM,IAAO,EAAS,YAAY;EAElC,AADA,IAAU;GAAE,MAAM,IAAI,KAAK,GAAQ,EAAE,QAAK,CAAC;GAAG,UAAU;GAAM;EAAW,CAAC,GAC1E,IAAS,CAAC;CACd,GAEO;EACH,UAAU;EACV,cAAc;EACd,YAAY;EAEZ,QAAc;GACN,MAAW,eAAe,MAAW,aACzC,IAAS,CAAC,GACV,IAAgB,GAChB,IAAU,IACV,IAAe,KAAK,IAAI,GACxB,IAAS,aACL,MAAgB,KAAA,IACf,EAAS,MAAM,IADW,EAAS,MAAM,CAAW;EAE7D;EAEA,QAAc;GACN,MAAW,gBACf,KAAiB,KAAK,IAAI,IAAI,GAC9B,IAAS,UACT,EAAS,MAAM;EACnB;EAEA,SAAe;GACP,MAAW,aACf,IAAe,KAAK,IAAI,GACxB,IAAS,aACT,EAAS,OAAO;EACpB;EAEA,OAAgC;GAW5B,OAVI,MAAW,UAAU,MAAW,YACzB,QAAQ,QAAQ;IACnB,MAAM,IAAI,KAAK,CAAC,GAAG,EAAE,MAAM,EAAW,CAAC;IACvC,UAAU;IACV,YAAY;GAChB,CAAC,IAKE,IAAI,SAAyB,MAAY;IAE5C,AADA,IAAS,GACT,EAAS,KAAK;GAClB,CAAC;EACL;EAEA,SAAe;GACP,MAAW,UAAU,MAAW,cACpC,IAAU,IACV,IAAS,MACT,EAAS,KAAK;EAClB;CACJ;AACJ"}
+{"version":3,"file":"media-recorder.js","names":["pickRecordingMimeType","preferred","type","createMediaRecorder","forced","options","negotiated","candidates","kind","recorder","stream","audioBitsPerSecond","videoBitsPerSecond","chunks","status","accumulatedMs","segmentStart","settle","discard","elapsed","event","onChunk","durationMs","resolve","timesliceMs"],"sources":["../../src/capture/media-recorder.ts"],"sourcesContent":["/**\n * @tempest-limits function-lines — the engine behind both the audio and the video\n * recorder: MIME negotiation, the state machine MediaRecorder does not give you, and\n * the clock kept by hand because a fresh WebM reports no duration. The clock has to\n * pause and resume with the state machine, so they are one closure.\n */\n/** Lifecycle of a recording. */\nexport type MediaRecorderStatus = \"idle\" | \"recording\" | \"paused\" | \"stopped\";\n\n/** What a track carries — used only to word the errors this engine throws. */\nexport type MediaRecordingKind = \"audio\" | \"video\";\n\n/** A finished recording, whatever it was made of. */\nexport interface MediaRecording {\n    /** The bytes. Wrap with `useObjectUrl` to play it, or POST it as-is. */\n    blob: Blob;\n    /** What the browser actually produced — not necessarily what you asked for. */\n    mimeType: string;\n    /** Recorded length, excluding time spent paused. */\n    durationMs: number;\n}\n\n/** Options for {@link createMediaRecorder}. */\nexport interface MediaRecordingOptions {\n    /**\n     * Container candidates, best first. Required: this engine has no opinion about\n     * codecs — the audio and video wrappers own that list.\n     */\n    candidates: readonly string[];\n    /** Wording for the thrown messages (\"cannot record any supported *video* container\"). */\n    kind: MediaRecordingKind;\n    /** Force a container, bypassing the negotiation. Throws when unsupported. */\n    mimeType?: string;\n    /** Target audio bitrate. */\n    audioBitsPerSecond?: number;\n    /** Target video bitrate. Ignored by the browser on an audio-only stream. */\n    videoBitsPerSecond?: number;\n    /**\n     * Emit a chunk every N ms through `onChunk`, for streaming upload.\n     *\n     * Without it the whole recording is buffered in memory until `stop()`.\n     */\n    timesliceMs?: number;\n    /** Receives each chunk when `timesliceMs` is set. Chunks are **not** independently playable. */\n    onChunk?: (chunk: Blob) => void;\n    /** Recorder-level failure (device unplugged mid-recording, encoder error). */\n    onError?: (error: unknown) => void;\n}\n\n/** Imperative recorder over one `MediaStream`. */\nexport interface MediaRecorderHandle {\n    /** Begin recording. No-op when already recording or paused. */\n    start: () => void;\n    /** Pause. The clock stops; `durationMs` freezes. */\n    pause: () => void;\n    /** Resume after `pause()`. */\n    resume: () => void;\n    /** Stop and resolve with the assembled recording. */\n    stop: () => Promise<MediaRecording>;\n    /** Stop and throw the bytes away. */\n    cancel: () => void;\n    status: () => MediaRecorderStatus;\n    /** Recorded length so far, excluding paused time. */\n    durationMs: () => number;\n    /** The negotiated container. */\n    mimeType: string;\n}\n\n/**\n * First container in `preferred` the browser can actually produce, or `null`.\n *\n * @param preferred - Candidates, best first.\n * @returns A supported MIME type, or `null` when none is.\n */\nexport function pickRecordingMimeType(preferred: readonly string[]): string | null {\n    if (typeof MediaRecorder === \"undefined\") return null;\n    // Older WebViews ship `MediaRecorder` without the static probe. Assume the first\n    // candidate rather than refusing outright — the constructor will tell us.\n    if (typeof MediaRecorder.isTypeSupported !== \"function\") return preferred[0] ?? null;\n    return preferred.find((type) => MediaRecorder.isTypeSupported(type)) ?? null;\n}\n\n/**\n * Wrap a `MediaStream` in a recorder with a real state machine and an honest clock.\n *\n * This is the engine behind both `createAudioRecorder` and `createVideoRecorder`; the\n * only thing it does not decide is which containers to try, because that is the one\n * part that genuinely differs between the two.\n *\n * Two things `MediaRecorder` does not give you:\n *\n * - **A duration.** It reports none, and the `Blob` has no reliable one either —\n *   WebM written by `MediaRecorder` carries no duration in its header, which is why\n *   `<audio>`/`<video>` shows `Infinity` for a fresh recording. So the clock is kept\n *   here, and it subtracts paused time: a recorder that counts wall-clock through a\n *   pause reports a 30-second note as two minutes.\n * - **A promise from `stop()`.** The last chunk arrives *after* `stop()` returns, in\n *   a `dataavailable` event that fires before `onstop`. Assembling the blob in\n *   `onstop` is the only point where every chunk is in hand.\n *\n * The stream is **not** owned here: `stop()` leaves the device open so a retake does\n * not need a second permission round-trip. Release it with the owning hook's `stop()`.\n *\n * @param stream - A live stream, from `getUserMedia` or `getDisplayMedia`.\n * @param options - See {@link MediaRecordingOptions}.\n * @returns The imperative recorder.\n * @throws When `MediaRecorder` is unavailable, or an explicit `mimeType` is unsupported.\n */\nexport function createMediaRecorder(\n    stream: MediaStream,\n    options: MediaRecordingOptions,\n): MediaRecorderHandle {\n    const {\n        candidates,\n        kind,\n        mimeType: forced,\n        audioBitsPerSecond,\n        videoBitsPerSecond,\n        timesliceMs,\n        onChunk,\n        onError,\n    } = options;\n\n    if (typeof MediaRecorder === \"undefined\") {\n        throw new Error(\"MediaRecorder is not available in this environment.\");\n    }\n    const negotiated = forced ?? pickRecordingMimeType(candidates);\n    if (negotiated === null) {\n        throw new Error(`This browser cannot record any supported ${kind} container.`);\n    }\n    if (\n        forced !== undefined &&\n        typeof MediaRecorder.isTypeSupported === \"function\" &&\n        !MediaRecorder.isTypeSupported(forced)\n    ) {\n        throw new Error(`This browser cannot record \"${forced}\".`);\n    }\n\n    const recorder = new MediaRecorder(stream, {\n        mimeType: negotiated,\n        ...(audioBitsPerSecond !== undefined ? { audioBitsPerSecond } : {}),\n        ...(videoBitsPerSecond !== undefined ? { videoBitsPerSecond } : {}),\n    });\n\n    let chunks: Blob[] = [];\n    let status: MediaRecorderStatus = \"idle\";\n    let accumulatedMs = 0;\n    let segmentStart = 0;\n    let settle: ((recording: MediaRecording) => void) | null = null;\n    let discard = false;\n\n    const elapsed = (): number =>\n        accumulatedMs + (status === \"recording\" ? Date.now() - segmentStart : 0);\n\n    recorder.ondataavailable = (event: BlobEvent): void => {\n        if (event.data.size === 0) return;\n        if (discard) return;\n        chunks.push(event.data);\n        onChunk?.(event.data);\n    };\n\n    recorder.onerror = (event: Event): void => {\n        onError?.((event as unknown as { error?: unknown }).error ?? event);\n    };\n\n    recorder.onstop = (): void => {\n        const durationMs = elapsed();\n        status = \"stopped\";\n        const resolve = settle;\n        settle = null;\n        if (discard) {\n            chunks = [];\n            return;\n        }\n        // `recorder.mimeType` is the source of truth: a browser handed\n        // `video/webm;codecs=vp9,opus` may report plain `video/webm` back.\n        const type = recorder.mimeType || negotiated;\n        resolve?.({ blob: new Blob(chunks, { type }), mimeType: type, durationMs });\n        chunks = [];\n    };\n\n    return {\n        mimeType: negotiated,\n        status: () => status,\n        durationMs: elapsed,\n\n        start(): void {\n            if (status === \"recording\" || status === \"paused\") return;\n            chunks = [];\n            accumulatedMs = 0;\n            discard = false;\n            segmentStart = Date.now();\n            status = \"recording\";\n            if (timesliceMs !== undefined) recorder.start(timesliceMs);\n            else recorder.start();\n        },\n\n        pause(): void {\n            if (status !== \"recording\") return;\n            accumulatedMs += Date.now() - segmentStart;\n            status = \"paused\";\n            recorder.pause();\n        },\n\n        resume(): void {\n            if (status !== \"paused\") return;\n            segmentStart = Date.now();\n            status = \"recording\";\n            recorder.resume();\n        },\n\n        stop(): Promise<MediaRecording> {\n            if (status === \"idle\" || status === \"stopped\") {\n                return Promise.resolve({\n                    blob: new Blob([], { type: negotiated }),\n                    mimeType: negotiated,\n                    durationMs: 0,\n                });\n            }\n            // Stopping while paused needs no clock fix-up: `pause()` already folded\n            // the last segment into `accumulatedMs`, and `elapsed()` adds nothing\n            // while the status is not `\"recording\"`.\n            return new Promise<MediaRecording>((resolve) => {\n                settle = resolve;\n                recorder.stop();\n            });\n        },\n\n        cancel(): void {\n            if (status === \"idle\" || status === \"stopped\") return;\n            discard = true;\n            settle = null;\n            recorder.stop();\n        },\n    };\n}\n"],"mappings":";AA0EA,SAAgBA,EAAsB,GAA6C;CAK/E,OAJI,OAAO,gBAAkB,MAAoB,OAG7C,OAAO,cAAc,mBAAoB,aACtCC,EAAU,MAAM,MAAS,cAAc,gBAAgBC,CAAI,CAAC,KAAK,OADRD,EAAU,MAAM;AAEpF;AA4BA,SAAgBE,EACZ,GACA,GACmB;CACnB,IAAM,EACF,eACA,SACA,UAAUC,GACV,uBACA,uBACA,gBACA,YACA,eACAC;CAEJ,IAAI,OAAO,gBAAkB,KACzB,MAAU,MAAM,qDAAqD;CAEzE,IAAMC,IAAaF,KAAUJ,EAAsBO,CAAU;CAC7D,IAAID,MAAe,MACf,MAAU,MAAM,4CAA4CE,EAAK,YAAY;CAEjF,IACIJ,MAAW,KAAA,KACX,OAAO,cAAc,mBAAoB,cACzC,CAAC,cAAc,gBAAgBA,CAAM,GAErC,MAAU,MAAM,+BAA+BA,EAAO,GAAG;CAG7D,IAAMK,IAAW,IAAI,cAAcC,GAAQ;EACvC,UAAUJ;EACV,GAAIK,MAAuB,KAAA,IAAqC,CAAC,IAA1B,EAAE,sBAAmB;EAC5D,GAAIC,MAAuB,KAAA,IAAqC,CAAC,IAA1B,EAAE,sBAAmB;CAChE,CAAC,GAEGC,IAAiB,CAAC,GAClBC,IAA8B,QAC9BC,IAAgB,GAChBC,IAAe,GACfC,IAAuD,MACvDC,IAAU,IAERC,UACFJ,KAAiBD,MAAW,cAAc,KAAK,IAAI,IAAIE,IAAe;CA6B1E,OA3BA,EAAS,mBAAmB,MAA2B;EACnD,AAAII,EAAM,KAAK,SAAS,MACpBF,MACJL,EAAO,KAAKO,EAAM,IAAI,GACtBC,IAAUD,EAAM,IAAI;CACxB,GAEA,EAAS,WAAW,MAAuB;EACvC,IAAWA,EAAyC,SAASA,CAAK;CACtE,GAEA,EAAS,eAAqB;EAC1B,IAAME,IAAaH,EAAQ;EAC3B,IAAS;EACT,IAAMI,IAAUN;EAEhB,IADA,IAAS,MACLC,GAAS;GACT,IAAS,CAAC;GACV;EACJ;EAGA,IAAMhB,IAAOO,EAAS,YAAYH;EAElC,AADAiB,IAAU;GAAE,MAAM,IAAI,KAAKV,GAAQ,EAAE,QAAK,CAAC;GAAG,UAAUX;GAAM;EAAW,CAAC,GAC1E,IAAS,CAAC;CACd,GAEO;EACH,UAAUI;EACV,cAAcQ;EACd,YAAYK;EAEZ,QAAc;GACV,AAAIL,MAAW,eAAeA,MAAW,aACzC,IAAS,CAAC,GACV,IAAgB,GAChB,IAAU,IACV,IAAe,KAAK,IAAI,GACxB,IAAS,aACLU,MAAgB,KAAA,IACff,EAAS,MAAM,IADWA,EAAS,MAAMe,CAAW;EAE7D;EAEA,QAAc;GACV,AAAIV,MAAW,gBACf,KAAiB,KAAK,IAAI,IAAIE,GAC9B,IAAS,UACTP,EAAS,MAAM;EACnB;EAEA,SAAe;GACX,AAAIK,MAAW,aACf,IAAe,KAAK,IAAI,GACxB,IAAS,aACTL,EAAS,OAAO;EACpB;EAEA,OAAgC;GAW5B,OAVIK,MAAW,UAAUA,MAAW,YACzB,QAAQ,QAAQ;IACnB,MAAM,IAAI,KAAK,CAAC,GAAG,EAAE,MAAMR,EAAW,CAAC;IACvC,UAAUA;IACV,YAAY;GAChB,CAAC,IAKE,IAAI,SAAyB,MAAY;IAE5C,AADA,IAASiB,GACTd,EAAS,KAAK;GAClB,CAAC;EACL;EAEA,SAAe;GACX,AAAIK,MAAW,UAAUA,MAAW,cACpC,IAAU,IACV,IAAS,MACTL,EAAS,KAAK;EAClB;CACJ;AACJ"}

package/dist/capture/use-barcode-scanner.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-barcode-scanner.cjs","names":[],"sources":["../../src/capture/use-barcode-scanner.ts"],"sourcesContent":["/**\n * @tempest-limits hook-lines — the scan loop, the repeat suppression window and the\n * torch control share the same track and the same interval handle; splitting them\n * would leave a timer running against a track another hook stopped.\n */\nimport { useEffect, useRef, useState, type RefObject } from \"react\";\n\nimport { useStableCallback } from \"@/hooks/use-stable-callback\";\nimport {\n    useCameraStream,\n    type CameraStreamError,\n    type CameraStreamStatus,\n} from \"@/vision/use-camera-stream\";\n\nimport {\n    createBarcodeDetector,\n    getSupportedBarcodeFormats,\n    isBarcodeDetectionSupported,\n    normalizeBarcode,\n    DEFAULT_BARCODE_FORMATS,\n    type BarcodeDetectorLike,\n    type BarcodeFormat,\n    type BarcodeScanResult,\n} from \"./barcode\";\nimport { useTorch, type UseTorchResult } from \"./use-torch\";\n\n/** Options for {@link useBarcodeScanner}. */\nexport interface UseBarcodeScannerOptions {\n    /** Symbologies to look for. Defaults to {@link DEFAULT_BARCODE_FORMATS}. */\n    formats?: readonly BarcodeFormat[];\n    /** Called for every accepted read — that is, after repeat suppression. */\n    onScan?: (result: BarcodeScanResult) => void;\n    /**\n     * How often a frame is examined, in ms. Default 200.\n     *\n     * Not `requestAnimationFrame`: decoding is 10–40 ms of main-thread work on a\n     * phone, so running it per frame competes with the preview it is reading from and\n     * makes the video stutter. Five looks per second is faster than a human can aim.\n     */\n    intervalMs?: number;\n    /**\n     * Ignore the **same** value again for this long, in ms. Default 2500.\n     *\n     * A symbol stays in frame for as long as the user holds the camera there, so a\n     * scanner without this fires the same code five times a second — which, wired to\n     * \"add item to cart\", is a bug the user pays for. A *different* value is never\n     * suppressed.\n     */\n    repeatDelayMs?: number;\n    /** Stop looking without releasing the camera — a confirmation sheet is open. */\n    paused?: boolean;\n    /**\n     * A decoder to use instead of the native one.\n     *\n     * The way to support Safari and Firefox: hand in a polyfill and everything else\n     * here works unchanged. See {@link isBarcodeDetectionSupported} for why the SDK\n     * does not bundle one.\n     */\n    detector?: BarcodeDetectorLike;\n    /** Camera constraints, forwarded to `useCameraStream`. Defaults to the rear camera. */\n    constraints?: MediaStreamConstraints;\n    /**\n     * A frame the engine refused to decode.\n     *\n     * Not \"nothing found\" — that resolves to an empty list and is the normal case.\n     * This is the engine itself failing, which the loop survives because it is\n     * usually transient (a frame arriving between two resolutions).\n     */\n    onError?: (error: unknown) => void;\n}\n\n/** Value returned by {@link useBarcodeScanner}. */\nexport interface UseBarcodeScannerResult {\n    /** Attach to a `<video ref={…} muted playsInline />`. */\n    videoRef: RefObject<HTMLVideoElement | null>;\n    /** Camera lifecycle. `\"ready\"` means the preview is running. */\n    status: CameraStreamStatus;\n    /** Classified camera error, or `null`. */\n    error: CameraStreamError | null;\n    /** `false` when there is no decoder — no native API and none injected. */\n    supported: boolean;\n    /**\n     * Formats actually in use: the requested ones intersected with what the engine\n     * reports. Empty while the probe is in flight, or when nothing matched.\n     */\n    formats: readonly BarcodeFormat[];\n    /** Whether the detect loop is running right now. */\n    scanning: boolean;\n    /** The most recent accepted read, or `null`. */\n    result: BarcodeScanResult | null;\n    /** The LED torch of this camera, when it has one. */\n    torch: UseTorchResult;\n    /** Re-open the camera after an error (the user changed the permission). */\n    retry: () => void;\n}\n\n/** A video is decodable once it has data for the current frame and a real size. */\nfunction frameIsReady(video: HTMLVideoElement): boolean {\n    return video.readyState >= 2 && video.videoWidth > 0 && video.videoHeight > 0;\n}\n\n/**\n * Read barcodes and QR codes from the camera.\n *\n * The camera and its classified errors come from `useCameraStream`, so this hook is\n * only the decoding half: it drives a `BarcodeDetector` over the preview on an\n * interval, suppresses the same value repeating, and exposes the torch.\n *\n * **Mounting this opens the camera.** It inherits that from `useCameraStream`, which\n * acquires on mount — so mount it *after* the user asks to scan (a button that reveals\n * the scanner), never on a page that merely contains one. A permission prompt nobody\n * provoked is the most reliable way to earn a permanent block, after which\n * `getUserMedia` rejects without ever prompting again.\n *\n * `supported` deserves a branch in the UI, not an assertion: `BarcodeDetector` is\n * Chromium-only and missing on Windows/Linux desktop, Firefox and everything on iOS.\n * Inject a `detector` to cover those, or tell the user to type the code.\n *\n * @param options - See {@link UseBarcodeScannerOptions}.\n * @returns The camera plumbing plus the scan state.\n *\n * @example\n * const scanner = useBarcodeScanner({\n *     formats: [\"ean_13\"],\n *     onScan: ({ rawValue }) => addToCart(rawValue),\n * });\n * return <video ref={scanner.videoRef} muted playsInline />;\n */\nexport function useBarcodeScanner(options: UseBarcodeScannerOptions = {}): UseBarcodeScannerResult {\n    const {\n        formats: requested = DEFAULT_BARCODE_FORMATS,\n        onScan,\n        intervalMs = 200,\n        repeatDelayMs = 2500,\n        paused = false,\n        detector: injected,\n        constraints,\n        onError,\n    } = options;\n\n    const [supported, setSupported] = useState(\n        () => injected !== undefined || isBarcodeDetectionSupported(),\n    );\n\n    /**\n     * No decoder, no camera.\n     *\n     * Opening the camera only to report \"this browser cannot decode barcodes\" spends a\n     * permission prompt on nothing — and a refusal is permanent, so it also spends the\n     * *next* feature that needs the camera.\n     */\n    const camera = useCameraStream({ constraints, enabled: supported });\n    const torch = useTorch(camera.stream);\n\n    const [formats, setFormats] = useState<readonly BarcodeFormat[]>(\n        injected !== undefined ? requested : [],\n    );\n    const [scanning, setScanning] = useState(false);\n    const [result, setResult] = useState<BarcodeScanResult | null>(null);\n\n    const detectorRef = useRef<BarcodeDetectorLike | null>(null);\n    const lastValue = useRef<string | null>(null);\n    const lastAt = useRef(0);\n\n    const emitScan = useStableCallback((scan: BarcodeScanResult) => onScan?.(scan));\n    const emitError = useStableCallback((error: unknown) => onError?.(error));\n\n    const requestedKey = requested.join(\",\");\n\n    /**\n     * Resolve which formats the engine will take, then build the detector.\n     *\n     * The intersection is not defensive coding: `new BarcodeDetector({ formats })`\n     * throws `NotSupportedError` when any entry is unknown to the platform decoder, and\n     * that list differs between two Chromium builds on two operating systems. Asking\n     * for the intersection is the only way one call site works everywhere.\n     */\n    useEffect(() => {\n        if (injected) {\n            detectorRef.current = injected;\n            setSupported(true);\n            setFormats(requested);\n            return;\n        }\n        if (!isBarcodeDetectionSupported()) {\n            detectorRef.current = null;\n            setSupported(false);\n            setFormats([]);\n            return;\n        }\n        let cancelled = false;\n        void getSupportedBarcodeFormats().then((available) => {\n            if (cancelled) return;\n            const usable =\n                available.length === 0\n                    ? requested\n                    : requested.filter((format) => available.includes(format));\n            const detector = usable.length > 0 ? createBarcodeDetector(usable) : null;\n            detectorRef.current = detector;\n            setFormats(detector ? usable : []);\n            setSupported(detector !== null);\n        });\n        return () => {\n            cancelled = true;\n        };\n        // `requestedKey` stands in for the array identity, so a caller passing an\n        // inline `formats={[\"ean_13\"]}` does not rebuild the detector every render.\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [injected, requestedKey]);\n\n    /**\n     * Look at a frame every `intervalMs`, and never overlap two looks.\n     *\n     * The loop re-arms itself *after* each `detect()` settles rather than running on a\n     * fixed `setInterval`: decoding sometimes takes longer than the interval, and an\n     * interval would then queue calls faster than the engine drains them until the tab\n     * is unusable.\n     */\n    useEffect(() => {\n        if (!supported || paused || camera.status !== \"ready\") {\n            setScanning(false);\n            return;\n        }\n        let stopped = false;\n        let timer: ReturnType<typeof setTimeout> | undefined;\n        setScanning(true);\n\n        const accept = (scan: BarcodeScanResult): void => {\n            const now = Date.now();\n            const isRepeat =\n                scan.rawValue === lastValue.current && now - lastAt.current < repeatDelayMs;\n            if (isRepeat) return;\n            lastValue.current = scan.rawValue;\n            lastAt.current = now;\n            setResult(scan);\n            emitScan(scan);\n        };\n\n        const look = async (): Promise<void> => {\n            const video = camera.videoRef.current;\n            const detector = detectorRef.current;\n            if (!video || !detector || !frameIsReady(video)) return;\n            try {\n                const found = await detector.detect(video);\n                if (stopped) return;\n                for (const raw of found) {\n                    const scan = normalizeBarcode(raw);\n                    if (scan.rawValue !== \"\") accept(scan);\n                }\n            } catch (error) {\n                if (!stopped) emitError(error);\n            }\n        };\n\n        const tick = (): void => {\n            void look().finally(() => {\n                if (!stopped) timer = setTimeout(tick, intervalMs);\n            });\n        };\n        tick();\n\n        return () => {\n            stopped = true;\n            if (timer !== undefined) clearTimeout(timer);\n            setScanning(false);\n        };\n    }, [\n        supported,\n        paused,\n        camera.status,\n        camera.videoRef,\n        intervalMs,\n        repeatDelayMs,\n        emitScan,\n        emitError,\n    ]);\n\n    return {\n        videoRef: camera.videoRef,\n        status: camera.status,\n        error: camera.error,\n        supported,\n        formats,\n        scanning,\n        result,\n        torch,\n        retry: camera.retry,\n    };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-barcode-scanner.cjs","names":["DEFAULT_BARCODE_FORMATS","useState","isBarcodeDetectionSupported","useCameraStream","useTorch","useRef","useStableCallback","getSupportedBarcodeFormats","createBarcodeDetector","normalizeBarcode","require_use_stable_callback","require_use_camera_stream","require_barcode","require_use_torch","react","frameIsReady","video","useBarcodeScanner","requested","injected","options","supported","setSupported","camera","torch","formats","setFormats","scanning","setScanning","result","setResult","detectorRef","lastValue","lastAt","emitScan","onScan","scan","emitError","onError","error","requestedKey","cancelled","usable","available","format","detector","paused","stopped","timer","accept","now","repeatDelayMs","look","found","raw","tick","intervalMs"],"sources":["../../src/capture/use-barcode-scanner.ts"],"sourcesContent":["/**\n * @tempest-limits hook-lines — the scan loop, the repeat suppression window and the\n * torch control share the same track and the same interval handle; splitting them\n * would leave a timer running against a track another hook stopped.\n */\nimport { useEffect, useRef, useState, type RefObject } from \"react\";\n\nimport { useStableCallback } from \"@/hooks/use-stable-callback\";\nimport {\n    useCameraStream,\n    type CameraStreamError,\n    type CameraStreamStatus,\n} from \"@/vision/use-camera-stream\";\n\nimport {\n    createBarcodeDetector,\n    getSupportedBarcodeFormats,\n    isBarcodeDetectionSupported,\n    normalizeBarcode,\n    DEFAULT_BARCODE_FORMATS,\n    type BarcodeDetectorLike,\n    type BarcodeFormat,\n    type BarcodeScanResult,\n} from \"./barcode\";\nimport { useTorch, type UseTorchResult } from \"./use-torch\";\n\n/** Options for {@link useBarcodeScanner}. */\nexport interface UseBarcodeScannerOptions {\n    /** Symbologies to look for. Defaults to {@link DEFAULT_BARCODE_FORMATS}. */\n    formats?: readonly BarcodeFormat[];\n    /** Called for every accepted read — that is, after repeat suppression. */\n    onScan?: (result: BarcodeScanResult) => void;\n    /**\n     * How often a frame is examined, in ms. Default 200.\n     *\n     * Not `requestAnimationFrame`: decoding is 10–40 ms of main-thread work on a\n     * phone, so running it per frame competes with the preview it is reading from and\n     * makes the video stutter. Five looks per second is faster than a human can aim.\n     */\n    intervalMs?: number;\n    /**\n     * Ignore the **same** value again for this long, in ms. Default 2500.\n     *\n     * A symbol stays in frame for as long as the user holds the camera there, so a\n     * scanner without this fires the same code five times a second — which, wired to\n     * \"add item to cart\", is a bug the user pays for. A *different* value is never\n     * suppressed.\n     */\n    repeatDelayMs?: number;\n    /** Stop looking without releasing the camera — a confirmation sheet is open. */\n    paused?: boolean;\n    /**\n     * A decoder to use instead of the native one.\n     *\n     * The way to support Safari and Firefox: hand in a polyfill and everything else\n     * here works unchanged. See {@link isBarcodeDetectionSupported} for why the SDK\n     * does not bundle one.\n     */\n    detector?: BarcodeDetectorLike;\n    /** Camera constraints, forwarded to `useCameraStream`. Defaults to the rear camera. */\n    constraints?: MediaStreamConstraints;\n    /**\n     * A frame the engine refused to decode.\n     *\n     * Not \"nothing found\" — that resolves to an empty list and is the normal case.\n     * This is the engine itself failing, which the loop survives because it is\n     * usually transient (a frame arriving between two resolutions).\n     */\n    onError?: (error: unknown) => void;\n}\n\n/** Value returned by {@link useBarcodeScanner}. */\nexport interface UseBarcodeScannerResult {\n    /** Attach to a `<video ref={…} muted playsInline />`. */\n    videoRef: RefObject<HTMLVideoElement | null>;\n    /** Camera lifecycle. `\"ready\"` means the preview is running. */\n    status: CameraStreamStatus;\n    /** Classified camera error, or `null`. */\n    error: CameraStreamError | null;\n    /** `false` when there is no decoder — no native API and none injected. */\n    supported: boolean;\n    /**\n     * Formats actually in use: the requested ones intersected with what the engine\n     * reports. Empty while the probe is in flight, or when nothing matched.\n     */\n    formats: readonly BarcodeFormat[];\n    /** Whether the detect loop is running right now. */\n    scanning: boolean;\n    /** The most recent accepted read, or `null`. */\n    result: BarcodeScanResult | null;\n    /** The LED torch of this camera, when it has one. */\n    torch: UseTorchResult;\n    /** Re-open the camera after an error (the user changed the permission). */\n    retry: () => void;\n}\n\n/** A video is decodable once it has data for the current frame and a real size. */\nfunction frameIsReady(video: HTMLVideoElement): boolean {\n    return video.readyState >= 2 && video.videoWidth > 0 && video.videoHeight > 0;\n}\n\n/**\n * Read barcodes and QR codes from the camera.\n *\n * The camera and its classified errors come from `useCameraStream`, so this hook is\n * only the decoding half: it drives a `BarcodeDetector` over the preview on an\n * interval, suppresses the same value repeating, and exposes the torch.\n *\n * **Mounting this opens the camera.** It inherits that from `useCameraStream`, which\n * acquires on mount — so mount it *after* the user asks to scan (a button that reveals\n * the scanner), never on a page that merely contains one. A permission prompt nobody\n * provoked is the most reliable way to earn a permanent block, after which\n * `getUserMedia` rejects without ever prompting again.\n *\n * `supported` deserves a branch in the UI, not an assertion: `BarcodeDetector` is\n * Chromium-only and missing on Windows/Linux desktop, Firefox and everything on iOS.\n * Inject a `detector` to cover those, or tell the user to type the code.\n *\n * @param options - See {@link UseBarcodeScannerOptions}.\n * @returns The camera plumbing plus the scan state.\n *\n * @example\n * const scanner = useBarcodeScanner({\n *     formats: [\"ean_13\"],\n *     onScan: ({ rawValue }) => addToCart(rawValue),\n * });\n * return <video ref={scanner.videoRef} muted playsInline />;\n */\nexport function useBarcodeScanner(options: UseBarcodeScannerOptions = {}): UseBarcodeScannerResult {\n    const {\n        formats: requested = DEFAULT_BARCODE_FORMATS,\n        onScan,\n        intervalMs = 200,\n        repeatDelayMs = 2500,\n        paused = false,\n        detector: injected,\n        constraints,\n        onError,\n    } = options;\n\n    const [supported, setSupported] = useState(\n        () => injected !== undefined || isBarcodeDetectionSupported(),\n    );\n\n    /**\n     * No decoder, no camera.\n     *\n     * Opening the camera only to report \"this browser cannot decode barcodes\" spends a\n     * permission prompt on nothing — and a refusal is permanent, so it also spends the\n     * *next* feature that needs the camera.\n     */\n    const camera = useCameraStream({ constraints, enabled: supported });\n    const torch = useTorch(camera.stream);\n\n    const [formats, setFormats] = useState<readonly BarcodeFormat[]>(\n        injected !== undefined ? requested : [],\n    );\n    const [scanning, setScanning] = useState(false);\n    const [result, setResult] = useState<BarcodeScanResult | null>(null);\n\n    const detectorRef = useRef<BarcodeDetectorLike | null>(null);\n    const lastValue = useRef<string | null>(null);\n    const lastAt = useRef(0);\n\n    const emitScan = useStableCallback((scan: BarcodeScanResult) => onScan?.(scan));\n    const emitError = useStableCallback((error: unknown) => onError?.(error));\n\n    const requestedKey = requested.join(\",\");\n\n    /**\n     * Resolve which formats the engine will take, then build the detector.\n     *\n     * The intersection is not defensive coding: `new BarcodeDetector({ formats })`\n     * throws `NotSupportedError` when any entry is unknown to the platform decoder, and\n     * that list differs between two Chromium builds on two operating systems. Asking\n     * for the intersection is the only way one call site works everywhere.\n     */\n    useEffect(() => {\n        if (injected) {\n            detectorRef.current = injected;\n            setSupported(true);\n            setFormats(requested);\n            return;\n        }\n        if (!isBarcodeDetectionSupported()) {\n            detectorRef.current = null;\n            setSupported(false);\n            setFormats([]);\n            return;\n        }\n        let cancelled = false;\n        void getSupportedBarcodeFormats().then((available) => {\n            if (cancelled) return;\n            const usable =\n                available.length === 0\n                    ? requested\n                    : requested.filter((format) => available.includes(format));\n            const detector = usable.length > 0 ? createBarcodeDetector(usable) : null;\n            detectorRef.current = detector;\n            setFormats(detector ? usable : []);\n            setSupported(detector !== null);\n        });\n        return () => {\n            cancelled = true;\n        };\n        // `requestedKey` stands in for the array identity, so a caller passing an\n        // inline `formats={[\"ean_13\"]}` does not rebuild the detector every render.\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [injected, requestedKey]);\n\n    /**\n     * Look at a frame every `intervalMs`, and never overlap two looks.\n     *\n     * The loop re-arms itself *after* each `detect()` settles rather than running on a\n     * fixed `setInterval`: decoding sometimes takes longer than the interval, and an\n     * interval would then queue calls faster than the engine drains them until the tab\n     * is unusable.\n     */\n    useEffect(() => {\n        if (!supported || paused || camera.status !== \"ready\") {\n            setScanning(false);\n            return;\n        }\n        let stopped = false;\n        let timer: ReturnType<typeof setTimeout> | undefined;\n        setScanning(true);\n\n        const accept = (scan: BarcodeScanResult): void => {\n            const now = Date.now();\n            const isRepeat =\n                scan.rawValue === lastValue.current && now - lastAt.current < repeatDelayMs;\n            if (isRepeat) return;\n            lastValue.current = scan.rawValue;\n            lastAt.current = now;\n            setResult(scan);\n            emitScan(scan);\n        };\n\n        const look = async (): Promise<void> => {\n            const video = camera.videoRef.current;\n            const detector = detectorRef.current;\n            if (!video || !detector || !frameIsReady(video)) return;\n            try {\n                const found = await detector.detect(video);\n                if (stopped) return;\n                for (const raw of found) {\n                    const scan = normalizeBarcode(raw);\n                    if (scan.rawValue !== \"\") accept(scan);\n                }\n            } catch (error) {\n                if (!stopped) emitError(error);\n            }\n        };\n\n        const tick = (): void => {\n            void look().finally(() => {\n                if (!stopped) timer = setTimeout(tick, intervalMs);\n            });\n        };\n        tick();\n\n        return () => {\n            stopped = true;\n            if (timer !== undefined) clearTimeout(timer);\n            setScanning(false);\n        };\n    }, [\n        supported,\n        paused,\n        camera.status,\n        camera.videoRef,\n        intervalMs,\n        repeatDelayMs,\n        emitScan,\n        emitError,\n    ]);\n\n    return {\n        videoRef: camera.videoRef,\n        status: camera.status,\n        error: camera.error,\n        supported,\n        formats,\n        scanning,\n        result,\n        torch,\n        retry: camera.retry,\n    };\n}\n"],"mappings":"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"}

package/dist/capture/use-barcode-scanner.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-barcode-scanner.js","names":[],"sources":["../../src/capture/use-barcode-scanner.ts"],"sourcesContent":["/**\n * @tempest-limits hook-lines — the scan loop, the repeat suppression window and the\n * torch control share the same track and the same interval handle; splitting them\n * would leave a timer running against a track another hook stopped.\n */\nimport { useEffect, useRef, useState, type RefObject } from \"react\";\n\nimport { useStableCallback } from \"@/hooks/use-stable-callback\";\nimport {\n    useCameraStream,\n    type CameraStreamError,\n    type CameraStreamStatus,\n} from \"@/vision/use-camera-stream\";\n\nimport {\n    createBarcodeDetector,\n    getSupportedBarcodeFormats,\n    isBarcodeDetectionSupported,\n    normalizeBarcode,\n    DEFAULT_BARCODE_FORMATS,\n    type BarcodeDetectorLike,\n    type BarcodeFormat,\n    type BarcodeScanResult,\n} from \"./barcode\";\nimport { useTorch, type UseTorchResult } from \"./use-torch\";\n\n/** Options for {@link useBarcodeScanner}. */\nexport interface UseBarcodeScannerOptions {\n    /** Symbologies to look for. Defaults to {@link DEFAULT_BARCODE_FORMATS}. */\n    formats?: readonly BarcodeFormat[];\n    /** Called for every accepted read — that is, after repeat suppression. */\n    onScan?: (result: BarcodeScanResult) => void;\n    /**\n     * How often a frame is examined, in ms. Default 200.\n     *\n     * Not `requestAnimationFrame`: decoding is 10–40 ms of main-thread work on a\n     * phone, so running it per frame competes with the preview it is reading from and\n     * makes the video stutter. Five looks per second is faster than a human can aim.\n     */\n    intervalMs?: number;\n    /**\n     * Ignore the **same** value again for this long, in ms. Default 2500.\n     *\n     * A symbol stays in frame for as long as the user holds the camera there, so a\n     * scanner without this fires the same code five times a second — which, wired to\n     * \"add item to cart\", is a bug the user pays for. A *different* value is never\n     * suppressed.\n     */\n    repeatDelayMs?: number;\n    /** Stop looking without releasing the camera — a confirmation sheet is open. */\n    paused?: boolean;\n    /**\n     * A decoder to use instead of the native one.\n     *\n     * The way to support Safari and Firefox: hand in a polyfill and everything else\n     * here works unchanged. See {@link isBarcodeDetectionSupported} for why the SDK\n     * does not bundle one.\n     */\n    detector?: BarcodeDetectorLike;\n    /** Camera constraints, forwarded to `useCameraStream`. Defaults to the rear camera. */\n    constraints?: MediaStreamConstraints;\n    /**\n     * A frame the engine refused to decode.\n     *\n     * Not \"nothing found\" — that resolves to an empty list and is the normal case.\n     * This is the engine itself failing, which the loop survives because it is\n     * usually transient (a frame arriving between two resolutions).\n     */\n    onError?: (error: unknown) => void;\n}\n\n/** Value returned by {@link useBarcodeScanner}. */\nexport interface UseBarcodeScannerResult {\n    /** Attach to a `<video ref={…} muted playsInline />`. */\n    videoRef: RefObject<HTMLVideoElement | null>;\n    /** Camera lifecycle. `\"ready\"` means the preview is running. */\n    status: CameraStreamStatus;\n    /** Classified camera error, or `null`. */\n    error: CameraStreamError | null;\n    /** `false` when there is no decoder — no native API and none injected. */\n    supported: boolean;\n    /**\n     * Formats actually in use: the requested ones intersected with what the engine\n     * reports. Empty while the probe is in flight, or when nothing matched.\n     */\n    formats: readonly BarcodeFormat[];\n    /** Whether the detect loop is running right now. */\n    scanning: boolean;\n    /** The most recent accepted read, or `null`. */\n    result: BarcodeScanResult | null;\n    /** The LED torch of this camera, when it has one. */\n    torch: UseTorchResult;\n    /** Re-open the camera after an error (the user changed the permission). */\n    retry: () => void;\n}\n\n/** A video is decodable once it has data for the current frame and a real size. */\nfunction frameIsReady(video: HTMLVideoElement): boolean {\n    return video.readyState >= 2 && video.videoWidth > 0 && video.videoHeight > 0;\n}\n\n/**\n * Read barcodes and QR codes from the camera.\n *\n * The camera and its classified errors come from `useCameraStream`, so this hook is\n * only the decoding half: it drives a `BarcodeDetector` over the preview on an\n * interval, suppresses the same value repeating, and exposes the torch.\n *\n * **Mounting this opens the camera.** It inherits that from `useCameraStream`, which\n * acquires on mount — so mount it *after* the user asks to scan (a button that reveals\n * the scanner), never on a page that merely contains one. A permission prompt nobody\n * provoked is the most reliable way to earn a permanent block, after which\n * `getUserMedia` rejects without ever prompting again.\n *\n * `supported` deserves a branch in the UI, not an assertion: `BarcodeDetector` is\n * Chromium-only and missing on Windows/Linux desktop, Firefox and everything on iOS.\n * Inject a `detector` to cover those, or tell the user to type the code.\n *\n * @param options - See {@link UseBarcodeScannerOptions}.\n * @returns The camera plumbing plus the scan state.\n *\n * @example\n * const scanner = useBarcodeScanner({\n *     formats: [\"ean_13\"],\n *     onScan: ({ rawValue }) => addToCart(rawValue),\n * });\n * return <video ref={scanner.videoRef} muted playsInline />;\n */\nexport function useBarcodeScanner(options: UseBarcodeScannerOptions = {}): UseBarcodeScannerResult {\n    const {\n        formats: requested = DEFAULT_BARCODE_FORMATS,\n        onScan,\n        intervalMs = 200,\n        repeatDelayMs = 2500,\n        paused = false,\n        detector: injected,\n        constraints,\n        onError,\n    } = options;\n\n    const [supported, setSupported] = useState(\n        () => injected !== undefined || isBarcodeDetectionSupported(),\n    );\n\n    /**\n     * No decoder, no camera.\n     *\n     * Opening the camera only to report \"this browser cannot decode barcodes\" spends a\n     * permission prompt on nothing — and a refusal is permanent, so it also spends the\n     * *next* feature that needs the camera.\n     */\n    const camera = useCameraStream({ constraints, enabled: supported });\n    const torch = useTorch(camera.stream);\n\n    const [formats, setFormats] = useState<readonly BarcodeFormat[]>(\n        injected !== undefined ? requested : [],\n    );\n    const [scanning, setScanning] = useState(false);\n    const [result, setResult] = useState<BarcodeScanResult | null>(null);\n\n    const detectorRef = useRef<BarcodeDetectorLike | null>(null);\n    const lastValue = useRef<string | null>(null);\n    const lastAt = useRef(0);\n\n    const emitScan = useStableCallback((scan: BarcodeScanResult) => onScan?.(scan));\n    const emitError = useStableCallback((error: unknown) => onError?.(error));\n\n    const requestedKey = requested.join(\",\");\n\n    /**\n     * Resolve which formats the engine will take, then build the detector.\n     *\n     * The intersection is not defensive coding: `new BarcodeDetector({ formats })`\n     * throws `NotSupportedError` when any entry is unknown to the platform decoder, and\n     * that list differs between two Chromium builds on two operating systems. Asking\n     * for the intersection is the only way one call site works everywhere.\n     */\n    useEffect(() => {\n        if (injected) {\n            detectorRef.current = injected;\n            setSupported(true);\n            setFormats(requested);\n            return;\n        }\n        if (!isBarcodeDetectionSupported()) {\n            detectorRef.current = null;\n            setSupported(false);\n            setFormats([]);\n            return;\n        }\n        let cancelled = false;\n        void getSupportedBarcodeFormats().then((available) => {\n            if (cancelled) return;\n            const usable =\n                available.length === 0\n                    ? requested\n                    : requested.filter((format) => available.includes(format));\n            const detector = usable.length > 0 ? createBarcodeDetector(usable) : null;\n            detectorRef.current = detector;\n            setFormats(detector ? usable : []);\n            setSupported(detector !== null);\n        });\n        return () => {\n            cancelled = true;\n        };\n        // `requestedKey` stands in for the array identity, so a caller passing an\n        // inline `formats={[\"ean_13\"]}` does not rebuild the detector every render.\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [injected, requestedKey]);\n\n    /**\n     * Look at a frame every `intervalMs`, and never overlap two looks.\n     *\n     * The loop re-arms itself *after* each `detect()` settles rather than running on a\n     * fixed `setInterval`: decoding sometimes takes longer than the interval, and an\n     * interval would then queue calls faster than the engine drains them until the tab\n     * is unusable.\n     */\n    useEffect(() => {\n        if (!supported || paused || camera.status !== \"ready\") {\n            setScanning(false);\n            return;\n        }\n        let stopped = false;\n        let timer: ReturnType<typeof setTimeout> | undefined;\n        setScanning(true);\n\n        const accept = (scan: BarcodeScanResult): void => {\n            const now = Date.now();\n            const isRepeat =\n                scan.rawValue === lastValue.current && now - lastAt.current < repeatDelayMs;\n            if (isRepeat) return;\n            lastValue.current = scan.rawValue;\n            lastAt.current = now;\n            setResult(scan);\n            emitScan(scan);\n        };\n\n        const look = async (): Promise<void> => {\n            const video = camera.videoRef.current;\n            const detector = detectorRef.current;\n            if (!video || !detector || !frameIsReady(video)) return;\n            try {\n                const found = await detector.detect(video);\n                if (stopped) return;\n                for (const raw of found) {\n                    const scan = normalizeBarcode(raw);\n                    if (scan.rawValue !== \"\") accept(scan);\n                }\n            } catch (error) {\n                if (!stopped) emitError(error);\n            }\n        };\n\n        const tick = (): void => {\n            void look().finally(() => {\n                if (!stopped) timer = setTimeout(tick, intervalMs);\n            });\n        };\n        tick();\n\n        return () => {\n            stopped = true;\n            if (timer !== undefined) clearTimeout(timer);\n            setScanning(false);\n        };\n    }, [\n        supported,\n        paused,\n        camera.status,\n        camera.videoRef,\n        intervalMs,\n        repeatDelayMs,\n        emitScan,\n        emitError,\n    ]);\n\n    return {\n        videoRef: camera.videoRef,\n        status: camera.status,\n        error: camera.error,\n        supported,\n        formats,\n        scanning,\n        result,\n        torch,\n        retry: camera.retry,\n    };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-barcode-scanner.js","names":["frameIsReady","video","useBarcodeScanner","requested","DEFAULT_BARCODE_FORMATS","injected","options","supported","setSupported","useState","isBarcodeDetectionSupported","camera","useCameraStream","torch","useTorch","formats","setFormats","scanning","setScanning","result","setResult","detectorRef","useRef","lastValue","lastAt","emitScan","useStableCallback","onScan","scan","emitError","onError","error","requestedKey","useEffect","cancelled","getSupportedBarcodeFormats","usable","available","format","detector","createBarcodeDetector","paused","stopped","timer","accept","now","repeatDelayMs","look","found","raw","normalizeBarcode","tick","intervalMs"],"sources":["../../src/capture/use-barcode-scanner.ts"],"sourcesContent":["/**\n * @tempest-limits hook-lines — the scan loop, the repeat suppression window and the\n * torch control share the same track and the same interval handle; splitting them\n * would leave a timer running against a track another hook stopped.\n */\nimport { useEffect, useRef, useState, type RefObject } from \"react\";\n\nimport { useStableCallback } from \"@/hooks/use-stable-callback\";\nimport {\n    useCameraStream,\n    type CameraStreamError,\n    type CameraStreamStatus,\n} from \"@/vision/use-camera-stream\";\n\nimport {\n    createBarcodeDetector,\n    getSupportedBarcodeFormats,\n    isBarcodeDetectionSupported,\n    normalizeBarcode,\n    DEFAULT_BARCODE_FORMATS,\n    type BarcodeDetectorLike,\n    type BarcodeFormat,\n    type BarcodeScanResult,\n} from \"./barcode\";\nimport { useTorch, type UseTorchResult } from \"./use-torch\";\n\n/** Options for {@link useBarcodeScanner}. */\nexport interface UseBarcodeScannerOptions {\n    /** Symbologies to look for. Defaults to {@link DEFAULT_BARCODE_FORMATS}. */\n    formats?: readonly BarcodeFormat[];\n    /** Called for every accepted read — that is, after repeat suppression. */\n    onScan?: (result: BarcodeScanResult) => void;\n    /**\n     * How often a frame is examined, in ms. Default 200.\n     *\n     * Not `requestAnimationFrame`: decoding is 10–40 ms of main-thread work on a\n     * phone, so running it per frame competes with the preview it is reading from and\n     * makes the video stutter. Five looks per second is faster than a human can aim.\n     */\n    intervalMs?: number;\n    /**\n     * Ignore the **same** value again for this long, in ms. Default 2500.\n     *\n     * A symbol stays in frame for as long as the user holds the camera there, so a\n     * scanner without this fires the same code five times a second — which, wired to\n     * \"add item to cart\", is a bug the user pays for. A *different* value is never\n     * suppressed.\n     */\n    repeatDelayMs?: number;\n    /** Stop looking without releasing the camera — a confirmation sheet is open. */\n    paused?: boolean;\n    /**\n     * A decoder to use instead of the native one.\n     *\n     * The way to support Safari and Firefox: hand in a polyfill and everything else\n     * here works unchanged. See {@link isBarcodeDetectionSupported} for why the SDK\n     * does not bundle one.\n     */\n    detector?: BarcodeDetectorLike;\n    /** Camera constraints, forwarded to `useCameraStream`. Defaults to the rear camera. */\n    constraints?: MediaStreamConstraints;\n    /**\n     * A frame the engine refused to decode.\n     *\n     * Not \"nothing found\" — that resolves to an empty list and is the normal case.\n     * This is the engine itself failing, which the loop survives because it is\n     * usually transient (a frame arriving between two resolutions).\n     */\n    onError?: (error: unknown) => void;\n}\n\n/** Value returned by {@link useBarcodeScanner}. */\nexport interface UseBarcodeScannerResult {\n    /** Attach to a `<video ref={…} muted playsInline />`. */\n    videoRef: RefObject<HTMLVideoElement | null>;\n    /** Camera lifecycle. `\"ready\"` means the preview is running. */\n    status: CameraStreamStatus;\n    /** Classified camera error, or `null`. */\n    error: CameraStreamError | null;\n    /** `false` when there is no decoder — no native API and none injected. */\n    supported: boolean;\n    /**\n     * Formats actually in use: the requested ones intersected with what the engine\n     * reports. Empty while the probe is in flight, or when nothing matched.\n     */\n    formats: readonly BarcodeFormat[];\n    /** Whether the detect loop is running right now. */\n    scanning: boolean;\n    /** The most recent accepted read, or `null`. */\n    result: BarcodeScanResult | null;\n    /** The LED torch of this camera, when it has one. */\n    torch: UseTorchResult;\n    /** Re-open the camera after an error (the user changed the permission). */\n    retry: () => void;\n}\n\n/** A video is decodable once it has data for the current frame and a real size. */\nfunction frameIsReady(video: HTMLVideoElement): boolean {\n    return video.readyState >= 2 && video.videoWidth > 0 && video.videoHeight > 0;\n}\n\n/**\n * Read barcodes and QR codes from the camera.\n *\n * The camera and its classified errors come from `useCameraStream`, so this hook is\n * only the decoding half: it drives a `BarcodeDetector` over the preview on an\n * interval, suppresses the same value repeating, and exposes the torch.\n *\n * **Mounting this opens the camera.** It inherits that from `useCameraStream`, which\n * acquires on mount — so mount it *after* the user asks to scan (a button that reveals\n * the scanner), never on a page that merely contains one. A permission prompt nobody\n * provoked is the most reliable way to earn a permanent block, after which\n * `getUserMedia` rejects without ever prompting again.\n *\n * `supported` deserves a branch in the UI, not an assertion: `BarcodeDetector` is\n * Chromium-only and missing on Windows/Linux desktop, Firefox and everything on iOS.\n * Inject a `detector` to cover those, or tell the user to type the code.\n *\n * @param options - See {@link UseBarcodeScannerOptions}.\n * @returns The camera plumbing plus the scan state.\n *\n * @example\n * const scanner = useBarcodeScanner({\n *     formats: [\"ean_13\"],\n *     onScan: ({ rawValue }) => addToCart(rawValue),\n * });\n * return <video ref={scanner.videoRef} muted playsInline />;\n */\nexport function useBarcodeScanner(options: UseBarcodeScannerOptions = {}): UseBarcodeScannerResult {\n    const {\n        formats: requested = DEFAULT_BARCODE_FORMATS,\n        onScan,\n        intervalMs = 200,\n        repeatDelayMs = 2500,\n        paused = false,\n        detector: injected,\n        constraints,\n        onError,\n    } = options;\n\n    const [supported, setSupported] = useState(\n        () => injected !== undefined || isBarcodeDetectionSupported(),\n    );\n\n    /**\n     * No decoder, no camera.\n     *\n     * Opening the camera only to report \"this browser cannot decode barcodes\" spends a\n     * permission prompt on nothing — and a refusal is permanent, so it also spends the\n     * *next* feature that needs the camera.\n     */\n    const camera = useCameraStream({ constraints, enabled: supported });\n    const torch = useTorch(camera.stream);\n\n    const [formats, setFormats] = useState<readonly BarcodeFormat[]>(\n        injected !== undefined ? requested : [],\n    );\n    const [scanning, setScanning] = useState(false);\n    const [result, setResult] = useState<BarcodeScanResult | null>(null);\n\n    const detectorRef = useRef<BarcodeDetectorLike | null>(null);\n    const lastValue = useRef<string | null>(null);\n    const lastAt = useRef(0);\n\n    const emitScan = useStableCallback((scan: BarcodeScanResult) => onScan?.(scan));\n    const emitError = useStableCallback((error: unknown) => onError?.(error));\n\n    const requestedKey = requested.join(\",\");\n\n    /**\n     * Resolve which formats the engine will take, then build the detector.\n     *\n     * The intersection is not defensive coding: `new BarcodeDetector({ formats })`\n     * throws `NotSupportedError` when any entry is unknown to the platform decoder, and\n     * that list differs between two Chromium builds on two operating systems. Asking\n     * for the intersection is the only way one call site works everywhere.\n     */\n    useEffect(() => {\n        if (injected) {\n            detectorRef.current = injected;\n            setSupported(true);\n            setFormats(requested);\n            return;\n        }\n        if (!isBarcodeDetectionSupported()) {\n            detectorRef.current = null;\n            setSupported(false);\n            setFormats([]);\n            return;\n        }\n        let cancelled = false;\n        void getSupportedBarcodeFormats().then((available) => {\n            if (cancelled) return;\n            const usable =\n                available.length === 0\n                    ? requested\n                    : requested.filter((format) => available.includes(format));\n            const detector = usable.length > 0 ? createBarcodeDetector(usable) : null;\n            detectorRef.current = detector;\n            setFormats(detector ? usable : []);\n            setSupported(detector !== null);\n        });\n        return () => {\n            cancelled = true;\n        };\n        // `requestedKey` stands in for the array identity, so a caller passing an\n        // inline `formats={[\"ean_13\"]}` does not rebuild the detector every render.\n        // eslint-disable-next-line react-hooks/exhaustive-deps\n    }, [injected, requestedKey]);\n\n    /**\n     * Look at a frame every `intervalMs`, and never overlap two looks.\n     *\n     * The loop re-arms itself *after* each `detect()` settles rather than running on a\n     * fixed `setInterval`: decoding sometimes takes longer than the interval, and an\n     * interval would then queue calls faster than the engine drains them until the tab\n     * is unusable.\n     */\n    useEffect(() => {\n        if (!supported || paused || camera.status !== \"ready\") {\n            setScanning(false);\n            return;\n        }\n        let stopped = false;\n        let timer: ReturnType<typeof setTimeout> | undefined;\n        setScanning(true);\n\n        const accept = (scan: BarcodeScanResult): void => {\n            const now = Date.now();\n            const isRepeat =\n                scan.rawValue === lastValue.current && now - lastAt.current < repeatDelayMs;\n            if (isRepeat) return;\n            lastValue.current = scan.rawValue;\n            lastAt.current = now;\n            setResult(scan);\n            emitScan(scan);\n        };\n\n        const look = async (): Promise<void> => {\n            const video = camera.videoRef.current;\n            const detector = detectorRef.current;\n            if (!video || !detector || !frameIsReady(video)) return;\n            try {\n                const found = await detector.detect(video);\n                if (stopped) return;\n                for (const raw of found) {\n                    const scan = normalizeBarcode(raw);\n                    if (scan.rawValue !== \"\") accept(scan);\n                }\n            } catch (error) {\n                if (!stopped) emitError(error);\n            }\n        };\n\n        const tick = (): void => {\n            void look().finally(() => {\n                if (!stopped) timer = setTimeout(tick, intervalMs);\n            });\n        };\n        tick();\n\n        return () => {\n            stopped = true;\n            if (timer !== undefined) clearTimeout(timer);\n            setScanning(false);\n        };\n    }, [\n        supported,\n        paused,\n        camera.status,\n        camera.videoRef,\n        intervalMs,\n        repeatDelayMs,\n        emitScan,\n        emitError,\n    ]);\n\n    return {\n        videoRef: camera.videoRef,\n        status: camera.status,\n        error: camera.error,\n        supported,\n        formats,\n        scanning,\n        result,\n        torch,\n        retry: camera.retry,\n    };\n}\n"],"mappings":"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"}

package/dist/capture/use-screen-capture.cjs

@@ -1,2 +1,2 @@
-const e=require("../hooks/use-stable-callback.cjs"),t=require("../audio/media-access.cjs");let n=require("react");function r(){return typeof navigator<`u`&&navigator.mediaDevices!==void 0&&typeof navigator.mediaDevices.getDisplayMedia==`function`}function i(e){return e instanceof DOMException&&(e.name===`NotAllowedError`||e.name===`AbortError`)}function a(a={}){let{audio:o=!1,displaySurface:s,preferCurrentTab:c,selfBrowserSurface:l,surfaceSwitching:u,systemAudio:d,options:f,onEnded:p,onCancelled:m}=a,[h,g]=(0,n.useState)(`idle`),[_,v]=(0,n.useState)(null),[y,b]=(0,n.useState)(null),[x,S]=(0,n.useState)(null),[C,w]=(0,n.useState)(!1),[T]=(0,n.useState)(r),E=(0,n.useRef)(null),D=(0,n.useRef)(null),O=(0,n.useRef)(0),k=e.useStableCallback(()=>p?.()),A=e.useStableCallback(e=>m?.(e)),j=(0,n.useCallback)(()=>{D.current?.(),D.current=null,E.current?.getTracks().forEach(e=>e.stop()),E.current=null},[]),M=(0,n.useCallback)(()=>{v(null),S(null),w(!1)},[]),N=(0,n.useCallback)(()=>{O.current+=1,j(),M(),g(`idle`),b(null)},[j,M]),P=(0,n.useCallback)(()=>{if(E.current)return;let e=O.current+=1;if(g(`requesting`),b(null),!r()){b(t.missingCaptureApiError(`screen`)),g(`error`);return}let n=f??{video:s?{displaySurface:s}:{},audio:o,...c===void 0?{}:{preferCurrentTab:c},...l===void 0?{}:{selfBrowserSurface:l},...u===void 0?{}:{surfaceSwitching:u},...d===void 0?{}:{systemAudio:d}};navigator.mediaDevices.getDisplayMedia(n).then(t=>{if(e!==O.current){t.getTracks().forEach(e=>e.stop());return}E.current=t;let n=t.getVideoTracks()[0],r=()=>{e===O.current&&(j(),M(),g(`idle`),k())};n?.addEventListener(`ended`,r),D.current=()=>n?.removeEventListener(`ended`,r),v(t),S(n?.getSettings().displaySurface??null),w(t.getAudioTracks().length>0),g(`sharing`)}).catch(n=>{if(e===O.current){if(i(n)){g(`idle`),A(n);return}b(t.classifyMediaError(n,`screen`)),g(`error`)}})},[o,s,c,l,u,d,f,j,M,k,A]);return(0,n.useEffect)(()=>j,[j]),{status:h,stream:_,error:y,surface:x,hasAudio:C,supported:T,start:P,stop:N}}exports.isScreenCaptureSupported=r,exports.useScreenCapture=a;
+const e=require("../hooks/use-stable-callback.cjs"),t=require("../audio/media-access.cjs");let n=require("react");function r(){return typeof navigator<`u`&&navigator.mediaDevices!==void 0&&typeof navigator.mediaDevices.getDisplayMedia==`function`}function i(e){return e instanceof DOMException&&(e.name===`NotAllowedError`||e.name===`AbortError`)}function a(a={}){let{audio:o=!1,displaySurface:s,preferCurrentTab:c,selfBrowserSurface:l,surfaceSwitching:u,systemAudio:d,options:f,onEnded:p,onCancelled:m}=a,[h,g]=(0,n.useState)(`idle`),[_,v]=(0,n.useState)(null),[y,b]=(0,n.useState)(null),[x,S]=(0,n.useState)(null),[C,w]=(0,n.useState)(!1),[T]=(0,n.useState)(r),E=(0,n.useRef)(null),D=(0,n.useRef)(null),O=(0,n.useRef)(0),k=e.useStableCallback(()=>p?.()),A=e.useStableCallback(e=>m?.(e)),j=(0,n.useCallback)(()=>{D.current?.(),D.current=null,E.current?.getTracks().forEach(e=>e.stop()),E.current=null},[]),M=(0,n.useCallback)(()=>{v(null),S(null),w(!1)},[]),N=(0,n.useCallback)(()=>{O.current+=1,j(),M(),g(`idle`),b(null)},[j,M]),P=(0,n.useCallback)(()=>{if(E.current)return;let e=O.current+=1;if(g(`requesting`),b(null),!r()){b(t.missingCaptureApiError(`screen`)),g(`error`);return}let n=f??{video:s?{displaySurface:s}:{},audio:o,...c===void 0?{}:{preferCurrentTab:c},...l===void 0?{}:{selfBrowserSurface:l},...u===void 0?{}:{surfaceSwitching:u},...d===void 0?{}:{systemAudio:d}};navigator.mediaDevices.getDisplayMedia(n).then(t=>{if(e!==O.current){t.getTracks().forEach(e=>e.stop());return}E.current=t;let n=t.getVideoTracks()[0],r=()=>{e===O.current&&(j(),M(),g(`idle`),k())};n?.addEventListener(`ended`,r),D.current=()=>n?.removeEventListener(`ended`,r),v(t),S(n?.getSettings().displaySurface??null),w(t.getAudioTracks().length>0),g(`sharing`)}).catch(n=>{e===O.current&&(i(n)?(g(`idle`),A(n)):(b(t.classifyMediaError(n,`screen`)),g(`error`)))})},[o,s,c,l,u,d,f,j,M,k,A]);return(0,n.useEffect)(()=>j,[j]),{status:h,stream:_,error:y,surface:x,hasAudio:C,supported:T,start:P,stop:N}}exports.isScreenCaptureSupported=r,exports.useScreenCapture=a;
 //# sourceMappingURL=use-screen-capture.cjs.map

package/dist/capture/use-screen-capture.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-screen-capture.cjs","names":[],"sources":["../../src/capture/use-screen-capture.ts"],"sourcesContent":["/**\n * @tempest-limits hook-lines — getDisplayMedia's cancellation is indistinguishable\n * from a policy block, so the hook holds the classification, the track's own `ended`\n * event (the user can stop sharing from the browser's bar) and the stop path in one\n * place — all three end the same session.\n */\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nimport {\n    classifyMediaError,\n    missingCaptureApiError,\n    type MediaAccessError,\n} from \"@/audio/media-access\";\nimport { useStableCallback } from \"@/hooks/use-stable-callback\";\n\n/** Lifecycle of a screen share. */\nexport type ScreenCaptureStatus = \"idle\" | \"requesting\" | \"sharing\" | \"error\";\n\n/** Which surface to put first in the picker. */\nexport type DisplaySurfaceHint = \"monitor\" | \"window\" | \"browser\";\n\n/**\n * Hints `getDisplayMedia` takes that TypeScript's `DisplayMediaStreamOptions` does not\n * list yet.\n */\ntype DisplayMediaOptionsWithHints = DisplayMediaStreamOptions & {\n    preferCurrentTab?: boolean;\n    selfBrowserSurface?: \"include\" | \"exclude\";\n    surfaceSwitching?: \"include\" | \"exclude\";\n    systemAudio?: \"include\" | \"exclude\";\n};\n\n/** `displaySurface` is a constrainable property of a display track, but not in the DOM lib. */\ntype DisplayVideoConstraints = MediaTrackConstraints & { displaySurface?: DisplaySurfaceHint };\n\n/** Options for {@link useScreenCapture}. */\nexport interface UseScreenCaptureOptions {\n    /**\n     * Capture the tab's audio too. Default `false`.\n     *\n     * Chromium only offers this for a **tab** — sharing a window or a whole screen\n     * yields no audio track no matter what you ask for, and Safari has no display\n     * audio at all. Ask for it and check what you got.\n     */\n    audio?: boolean;\n    /**\n     * Which surface the picker should offer first — `\"browser\"` is a tab.\n     *\n     * A hint, never a guarantee: the user can always pick something else, and Firefox\n     * ignores it. Read `surface` afterwards to learn what actually happened.\n     */\n    displaySurface?: DisplaySurfaceHint;\n    /**\n     * Put *this* tab at the top of the picker. Default `false`.\n     *\n     * The right setting for \"record what you are seeing right now\" in a support flow.\n     * Chromium only.\n     */\n    preferCurrentTab?: boolean;\n    /** Offer this tab in the list at all. `\"exclude\"` prevents the hall-of-mirrors capture. */\n    selfBrowserSurface?: \"include\" | \"exclude\";\n    /** Let the user switch to a different surface mid-share, without a new prompt. */\n    surfaceSwitching?: \"include\" | \"exclude\";\n    /** Include the system audio when a whole screen is shared. Chromium, Windows only. */\n    systemAudio?: \"include\" | \"exclude\";\n    /** Escape hatch: full options, replacing everything above. */\n    options?: DisplayMediaStreamOptions;\n    /**\n     * The user stopped the share from the browser's own bar.\n     *\n     * The single most important callback here — see the note on\n     * {@link useScreenCapture}.\n     */\n    onEnded?: () => void;\n    /**\n     * The user dismissed the picker. **Not an error.**\n     *\n     * Receives the rejection so an app that needs to tell a dismissal from an OS-level\n     * block (macOS screen-recording permission) can look at the message. Most should\n     * simply return the UI to its previous state.\n     */\n    onCancelled?: (reason: unknown) => void;\n}\n\n/** Value returned by {@link useScreenCapture}. */\nexport interface UseScreenCaptureResult {\n    status: ScreenCaptureStatus;\n    /** The live stream, or `null`. Feed it to {@link useVideoRecorder} or a `<video>`. */\n    stream: MediaStream | null;\n    /** Classified error, or `null`. A cancelled picker leaves this `null`. */\n    error: MediaAccessError | null;\n    /** What the user actually picked, when the browser reports it. */\n    surface: string | null;\n    /** Whether the stream carries an audio track — ask, do not assume. */\n    hasAudio: boolean;\n    /** `false` when `getDisplayMedia` is missing (every browser on iOS, insecure pages). */\n    supported: boolean;\n    /** Open the picker. Must be called from a user gesture. */\n    start: () => void;\n    /** Stop sharing from the app side. Fires nothing — you asked for it. */\n    stop: () => void;\n}\n\n/** Whether `getDisplayMedia` is reachable at all. */\nexport function isScreenCaptureSupported(): boolean {\n    return (\n        typeof navigator !== \"undefined\" &&\n        navigator.mediaDevices !== undefined &&\n        typeof navigator.mediaDevices.getDisplayMedia === \"function\"\n    );\n}\n\n/**\n * A rejection from `getDisplayMedia` that means \"the user said no thanks\".\n *\n * There is no distinct exception for a dismissed picker: closing it produces the same\n * `NotAllowedError` as a policy block, and some builds report `AbortError` instead. The\n * useful default is therefore to treat both as a cancellation, because a\n * display-capture prompt is **always** user-initiated — nothing can open it behind\n * their back — so the overwhelmingly likely cause is that they changed their mind, and\n * a red error toast for that punishes them for it. The rejection is handed to\n * `onCancelled` so the rarer causes stay diagnosable.\n */\nfunction isCancellation(err: unknown): boolean {\n    return (\n        err instanceof DOMException && (err.name === \"NotAllowedError\" || err.name === \"AbortError\")\n    );\n}\n\n/**\n * Capture a screen, a window or a tab with `getDisplayMedia`.\n *\n * Three states decide whether this feels right, and two of them are easy to miss:\n *\n * - **The user dismissed the picker.** A rejection, but not a failure. It leaves\n *   `error` at `null` and the status back at `\"idle\"`, and calls `onCancelled`.\n * - **The user stopped the share from the browser's own bar.** Nothing in your UI was\n *   clicked and no promise rejects — the *only* signal is the video track's `ended`\n *   event, so the hook listens for it and clears the stream. Without that listener, an\n *   app shows \"gravando\" over a stream that is already dead.\n * - **The share is live.** `surface` says what was picked and `hasAudio` says whether\n *   audio actually came along, which is not what you asked for but what you got.\n *\n * The stream is owned here: `stop()` and unmount both release every track. A recorder\n * built on it (`useVideoRecorder`) deliberately does not, so stopping a recording\n * leaves the share running for the next take.\n *\n * @param options - See {@link UseScreenCaptureOptions}.\n * @returns The stream, its status, a classified error and `start`/`stop`.\n *\n * @example\n * const screen = useScreenCapture({ preferCurrentTab: true, onEnded: () => save() });\n * const rec = useVideoRecorder(screen.stream);\n * <button onClick={screen.start}>Compartilhar tela</button>\n */\nexport function useScreenCapture(options: UseScreenCaptureOptions = {}): UseScreenCaptureResult {\n    const {\n        audio = false,\n        displaySurface,\n        preferCurrentTab,\n        selfBrowserSurface,\n        surfaceSwitching,\n        systemAudio,\n        options: raw,\n        onEnded,\n        onCancelled,\n    } = options;\n\n    const [status, setStatus] = useState<ScreenCaptureStatus>(\"idle\");\n    const [stream, setStream] = useState<MediaStream | null>(null);\n    const [error, setError] = useState<MediaAccessError | null>(null);\n    const [surface, setSurface] = useState<string | null>(null);\n    const [hasAudio, setHasAudio] = useState(false);\n    const [supported] = useState(isScreenCaptureSupported);\n\n    const streamRef = useRef<MediaStream | null>(null);\n    const detach = useRef<(() => void) | null>(null);\n    const generation = useRef(0);\n\n    const emitEnded = useStableCallback(() => onEnded?.());\n    const emitCancelled = useStableCallback((reason: unknown) => onCancelled?.(reason));\n\n    const release = useCallback((): void => {\n        detach.current?.();\n        detach.current = null;\n        streamRef.current?.getTracks().forEach((track) => track.stop());\n        streamRef.current = null;\n    }, []);\n\n    const reset = useCallback((): void => {\n        setStream(null);\n        setSurface(null);\n        setHasAudio(false);\n    }, []);\n\n    const stop = useCallback((): void => {\n        generation.current += 1;\n        release();\n        reset();\n        setStatus(\"idle\");\n        setError(null);\n    }, [release, reset]);\n\n    const start = useCallback((): void => {\n        if (streamRef.current) return;\n        const run = (generation.current += 1);\n        setStatus(\"requesting\");\n        setError(null);\n\n        if (!isScreenCaptureSupported()) {\n            setError(missingCaptureApiError(\"screen\"));\n            setStatus(\"error\");\n            return;\n        }\n\n        const video: DisplayVideoConstraints = displaySurface ? { displaySurface } : {};\n        const request: DisplayMediaOptionsWithHints = raw ?? {\n            video,\n            audio,\n            ...(preferCurrentTab !== undefined ? { preferCurrentTab } : {}),\n            ...(selfBrowserSurface !== undefined ? { selfBrowserSurface } : {}),\n            ...(surfaceSwitching !== undefined ? { surfaceSwitching } : {}),\n            ...(systemAudio !== undefined ? { systemAudio } : {}),\n        };\n\n        void navigator.mediaDevices\n            .getDisplayMedia(request)\n            .then((next) => {\n                if (run !== generation.current) {\n                    next.getTracks().forEach((track) => track.stop());\n                    return;\n                }\n                streamRef.current = next;\n                const track = next.getVideoTracks()[0];\n                const ended = (): void => {\n                    if (run !== generation.current) return;\n                    release();\n                    reset();\n                    setStatus(\"idle\");\n                    emitEnded();\n                };\n                track?.addEventListener(\"ended\", ended);\n                detach.current = () => track?.removeEventListener(\"ended\", ended);\n\n                setStream(next);\n                setSurface(track?.getSettings().displaySurface ?? null);\n                setHasAudio(next.getAudioTracks().length > 0);\n                setStatus(\"sharing\");\n            })\n            .catch((err: unknown) => {\n                if (run !== generation.current) return;\n                if (isCancellation(err)) {\n                    setStatus(\"idle\");\n                    emitCancelled(err);\n                    return;\n                }\n                setError(classifyMediaError(err, \"screen\"));\n                setStatus(\"error\");\n            });\n    }, [\n        audio,\n        displaySurface,\n        preferCurrentTab,\n        selfBrowserSurface,\n        surfaceSwitching,\n        systemAudio,\n        raw,\n        release,\n        reset,\n        emitEnded,\n        emitCancelled,\n    ]);\n\n    useEffect(() => release, [release]);\n\n    return { status, stream, error, surface, hasAudio, supported, start, stop };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-screen-capture.cjs","names":["useState","useRef","useStableCallback","useCallback","missingCaptureApiError","classifyMediaError","require_use_stable_callback","require_media_access","react","isScreenCaptureSupported","isCancellation","err","useScreenCapture","raw","options","status","setStatus","stream","setStream","error","setError","surface","setSurface","hasAudio","setHasAudio","supported","streamRef","detach","generation","emitEnded","onEnded","emitCancelled","onCancelled","reason","release","track","reset","stop","start","run","request","displaySurface","preferCurrentTab","selfBrowserSurface","surfaceSwitching","systemAudio","next","ended","audio"],"sources":["../../src/capture/use-screen-capture.ts"],"sourcesContent":["/**\n * @tempest-limits hook-lines — getDisplayMedia's cancellation is indistinguishable\n * from a policy block, so the hook holds the classification, the track's own `ended`\n * event (the user can stop sharing from the browser's bar) and the stop path in one\n * place — all three end the same session.\n */\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nimport {\n    classifyMediaError,\n    missingCaptureApiError,\n    type MediaAccessError,\n} from \"@/audio/media-access\";\nimport { useStableCallback } from \"@/hooks/use-stable-callback\";\n\n/** Lifecycle of a screen share. */\nexport type ScreenCaptureStatus = \"idle\" | \"requesting\" | \"sharing\" | \"error\";\n\n/** Which surface to put first in the picker. */\nexport type DisplaySurfaceHint = \"monitor\" | \"window\" | \"browser\";\n\n/**\n * Hints `getDisplayMedia` takes that TypeScript's `DisplayMediaStreamOptions` does not\n * list yet.\n */\ntype DisplayMediaOptionsWithHints = DisplayMediaStreamOptions & {\n    preferCurrentTab?: boolean;\n    selfBrowserSurface?: \"include\" | \"exclude\";\n    surfaceSwitching?: \"include\" | \"exclude\";\n    systemAudio?: \"include\" | \"exclude\";\n};\n\n/** `displaySurface` is a constrainable property of a display track, but not in the DOM lib. */\ntype DisplayVideoConstraints = MediaTrackConstraints & { displaySurface?: DisplaySurfaceHint };\n\n/** Options for {@link useScreenCapture}. */\nexport interface UseScreenCaptureOptions {\n    /**\n     * Capture the tab's audio too. Default `false`.\n     *\n     * Chromium only offers this for a **tab** — sharing a window or a whole screen\n     * yields no audio track no matter what you ask for, and Safari has no display\n     * audio at all. Ask for it and check what you got.\n     */\n    audio?: boolean;\n    /**\n     * Which surface the picker should offer first — `\"browser\"` is a tab.\n     *\n     * A hint, never a guarantee: the user can always pick something else, and Firefox\n     * ignores it. Read `surface` afterwards to learn what actually happened.\n     */\n    displaySurface?: DisplaySurfaceHint;\n    /**\n     * Put *this* tab at the top of the picker. Default `false`.\n     *\n     * The right setting for \"record what you are seeing right now\" in a support flow.\n     * Chromium only.\n     */\n    preferCurrentTab?: boolean;\n    /** Offer this tab in the list at all. `\"exclude\"` prevents the hall-of-mirrors capture. */\n    selfBrowserSurface?: \"include\" | \"exclude\";\n    /** Let the user switch to a different surface mid-share, without a new prompt. */\n    surfaceSwitching?: \"include\" | \"exclude\";\n    /** Include the system audio when a whole screen is shared. Chromium, Windows only. */\n    systemAudio?: \"include\" | \"exclude\";\n    /** Escape hatch: full options, replacing everything above. */\n    options?: DisplayMediaStreamOptions;\n    /**\n     * The user stopped the share from the browser's own bar.\n     *\n     * The single most important callback here — see the note on\n     * {@link useScreenCapture}.\n     */\n    onEnded?: () => void;\n    /**\n     * The user dismissed the picker. **Not an error.**\n     *\n     * Receives the rejection so an app that needs to tell a dismissal from an OS-level\n     * block (macOS screen-recording permission) can look at the message. Most should\n     * simply return the UI to its previous state.\n     */\n    onCancelled?: (reason: unknown) => void;\n}\n\n/** Value returned by {@link useScreenCapture}. */\nexport interface UseScreenCaptureResult {\n    status: ScreenCaptureStatus;\n    /** The live stream, or `null`. Feed it to {@link useVideoRecorder} or a `<video>`. */\n    stream: MediaStream | null;\n    /** Classified error, or `null`. A cancelled picker leaves this `null`. */\n    error: MediaAccessError | null;\n    /** What the user actually picked, when the browser reports it. */\n    surface: string | null;\n    /** Whether the stream carries an audio track — ask, do not assume. */\n    hasAudio: boolean;\n    /** `false` when `getDisplayMedia` is missing (every browser on iOS, insecure pages). */\n    supported: boolean;\n    /** Open the picker. Must be called from a user gesture. */\n    start: () => void;\n    /** Stop sharing from the app side. Fires nothing — you asked for it. */\n    stop: () => void;\n}\n\n/** Whether `getDisplayMedia` is reachable at all. */\nexport function isScreenCaptureSupported(): boolean {\n    return (\n        typeof navigator !== \"undefined\" &&\n        navigator.mediaDevices !== undefined &&\n        typeof navigator.mediaDevices.getDisplayMedia === \"function\"\n    );\n}\n\n/**\n * A rejection from `getDisplayMedia` that means \"the user said no thanks\".\n *\n * There is no distinct exception for a dismissed picker: closing it produces the same\n * `NotAllowedError` as a policy block, and some builds report `AbortError` instead. The\n * useful default is therefore to treat both as a cancellation, because a\n * display-capture prompt is **always** user-initiated — nothing can open it behind\n * their back — so the overwhelmingly likely cause is that they changed their mind, and\n * a red error toast for that punishes them for it. The rejection is handed to\n * `onCancelled` so the rarer causes stay diagnosable.\n */\nfunction isCancellation(err: unknown): boolean {\n    return (\n        err instanceof DOMException && (err.name === \"NotAllowedError\" || err.name === \"AbortError\")\n    );\n}\n\n/**\n * Capture a screen, a window or a tab with `getDisplayMedia`.\n *\n * Three states decide whether this feels right, and two of them are easy to miss:\n *\n * - **The user dismissed the picker.** A rejection, but not a failure. It leaves\n *   `error` at `null` and the status back at `\"idle\"`, and calls `onCancelled`.\n * - **The user stopped the share from the browser's own bar.** Nothing in your UI was\n *   clicked and no promise rejects — the *only* signal is the video track's `ended`\n *   event, so the hook listens for it and clears the stream. Without that listener, an\n *   app shows \"gravando\" over a stream that is already dead.\n * - **The share is live.** `surface` says what was picked and `hasAudio` says whether\n *   audio actually came along, which is not what you asked for but what you got.\n *\n * The stream is owned here: `stop()` and unmount both release every track. A recorder\n * built on it (`useVideoRecorder`) deliberately does not, so stopping a recording\n * leaves the share running for the next take.\n *\n * @param options - See {@link UseScreenCaptureOptions}.\n * @returns The stream, its status, a classified error and `start`/`stop`.\n *\n * @example\n * const screen = useScreenCapture({ preferCurrentTab: true, onEnded: () => save() });\n * const rec = useVideoRecorder(screen.stream);\n * <button onClick={screen.start}>Compartilhar tela</button>\n */\nexport function useScreenCapture(options: UseScreenCaptureOptions = {}): UseScreenCaptureResult {\n    const {\n        audio = false,\n        displaySurface,\n        preferCurrentTab,\n        selfBrowserSurface,\n        surfaceSwitching,\n        systemAudio,\n        options: raw,\n        onEnded,\n        onCancelled,\n    } = options;\n\n    const [status, setStatus] = useState<ScreenCaptureStatus>(\"idle\");\n    const [stream, setStream] = useState<MediaStream | null>(null);\n    const [error, setError] = useState<MediaAccessError | null>(null);\n    const [surface, setSurface] = useState<string | null>(null);\n    const [hasAudio, setHasAudio] = useState(false);\n    const [supported] = useState(isScreenCaptureSupported);\n\n    const streamRef = useRef<MediaStream | null>(null);\n    const detach = useRef<(() => void) | null>(null);\n    const generation = useRef(0);\n\n    const emitEnded = useStableCallback(() => onEnded?.());\n    const emitCancelled = useStableCallback((reason: unknown) => onCancelled?.(reason));\n\n    const release = useCallback((): void => {\n        detach.current?.();\n        detach.current = null;\n        streamRef.current?.getTracks().forEach((track) => track.stop());\n        streamRef.current = null;\n    }, []);\n\n    const reset = useCallback((): void => {\n        setStream(null);\n        setSurface(null);\n        setHasAudio(false);\n    }, []);\n\n    const stop = useCallback((): void => {\n        generation.current += 1;\n        release();\n        reset();\n        setStatus(\"idle\");\n        setError(null);\n    }, [release, reset]);\n\n    const start = useCallback((): void => {\n        if (streamRef.current) return;\n        const run = (generation.current += 1);\n        setStatus(\"requesting\");\n        setError(null);\n\n        if (!isScreenCaptureSupported()) {\n            setError(missingCaptureApiError(\"screen\"));\n            setStatus(\"error\");\n            return;\n        }\n\n        const video: DisplayVideoConstraints = displaySurface ? { displaySurface } : {};\n        const request: DisplayMediaOptionsWithHints = raw ?? {\n            video,\n            audio,\n            ...(preferCurrentTab !== undefined ? { preferCurrentTab } : {}),\n            ...(selfBrowserSurface !== undefined ? { selfBrowserSurface } : {}),\n            ...(surfaceSwitching !== undefined ? { surfaceSwitching } : {}),\n            ...(systemAudio !== undefined ? { systemAudio } : {}),\n        };\n\n        void navigator.mediaDevices\n            .getDisplayMedia(request)\n            .then((next) => {\n                if (run !== generation.current) {\n                    next.getTracks().forEach((track) => track.stop());\n                    return;\n                }\n                streamRef.current = next;\n                const track = next.getVideoTracks()[0];\n                const ended = (): void => {\n                    if (run !== generation.current) return;\n                    release();\n                    reset();\n                    setStatus(\"idle\");\n                    emitEnded();\n                };\n                track?.addEventListener(\"ended\", ended);\n                detach.current = () => track?.removeEventListener(\"ended\", ended);\n\n                setStream(next);\n                setSurface(track?.getSettings().displaySurface ?? null);\n                setHasAudio(next.getAudioTracks().length > 0);\n                setStatus(\"sharing\");\n            })\n            .catch((err: unknown) => {\n                if (run !== generation.current) return;\n                if (isCancellation(err)) {\n                    setStatus(\"idle\");\n                    emitCancelled(err);\n                    return;\n                }\n                setError(classifyMediaError(err, \"screen\"));\n                setStatus(\"error\");\n            });\n    }, [\n        audio,\n        displaySurface,\n        preferCurrentTab,\n        selfBrowserSurface,\n        surfaceSwitching,\n        systemAudio,\n        raw,\n        release,\n        reset,\n        emitEnded,\n        emitCancelled,\n    ]);\n\n    useEffect(() => release, [release]);\n\n    return { status, stream, error, surface, hasAudio, supported, start, stop };\n}\n"],"mappings":"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"}