@skdx/react 0.26.0 → 0.28.0

package/dist/qr-code/QrCodeAnatomy.d.cts

@@ -0,0 +1,10 @@
+import type * as React from 'react';
+/**
+ * The anatomy a {@link QrCode} draws when given no children: a `QrCodeFrame`
+ * holding the `QrCodePattern`, plus a derived `QrCodeOverlay` when `overlay` is given.
+ *
+ * @internal
+ */
+export declare const QrCodeAnatomy: ({ overlay }: {
+    overlay?: React.ReactNode;
+}) => React.JSX.Element;

package/dist/qr-code/QrCodeAnatomy.d.ts

@@ -0,0 +1,10 @@
+import type * as React from 'react';
+/**
+ * The anatomy a {@link QrCode} draws when given no children: a `QrCodeFrame`
+ * holding the `QrCodePattern`, plus a derived `QrCodeOverlay` when `overlay` is given.
+ *
+ * @internal
+ */
+export declare const QrCodeAnatomy: ({ overlay }: {
+    overlay?: React.ReactNode;
+}) => React.JSX.Element;

package/dist/qr-code/QrCodeFrame.d.cts

@@ -1,17 +1,14 @@
 import * as React from 'react';
 import type { QrCodeFrameProps } from './types.cjs';
 /**
- * The `<svg>` host for a QR code. Its `viewBox` is `0 0 size size` where `size`
- * is the module count, so **one user unit is one module** — `QrCodePattern` and
- * `QrCodeOverlay` both work in whole modules and never need a scale factor.
- * The element itself carries no width or height; size it from CSS, optionally
- * via the root's `--skdx-qr-code-size`.
+ * SVG host for the QR code. Its `viewBox` is `0 0 size size` where `size`
+ * is the module count — one user unit per module, so no scale factor needed.
+ * Size it from CSS, optionally via `--skdx-qr-code-size`.
  *
- * ARIA follows what you name it. Pass `aria-label` or `aria-labelledby` and it
- * becomes `role="img"` with that name — worth doing when the symbol is the only
- * copy of the destination on screen. Pass neither and it is `aria-hidden`,
- * because an unnamed `<svg>` full of squares is decoration, and the root's
- * `hiddenLabel` text already carries the payload.
+ * Role follows naming: pass `aria-label`/`aria-labelledby` for `role="img"`,
+ * or neither for `aria-hidden` (unnamed SVG is decoration; the root's
+ * `hiddenLabel` carries the data). Children cannot name it; the role is set
+ * from props before rendering.
  *
  * Must be used inside a `QrCode`.
  *

package/dist/qr-code/QrCodeFrame.d.ts

@@ -1,17 +1,14 @@
 import * as React from 'react';
 import type { QrCodeFrameProps } from './types.js';
 /**
- * The `<svg>` host for a QR code. Its `viewBox` is `0 0 size size` where `size`
- * is the module count, so **one user unit is one module** — `QrCodePattern` and
- * `QrCodeOverlay` both work in whole modules and never need a scale factor.
- * The element itself carries no width or height; size it from CSS, optionally
- * via the root's `--skdx-qr-code-size`.
+ * SVG host for the QR code. Its `viewBox` is `0 0 size size` where `size`
+ * is the module count — one user unit per module, so no scale factor needed.
+ * Size it from CSS, optionally via `--skdx-qr-code-size`.
  *
- * ARIA follows what you name it. Pass `aria-label` or `aria-labelledby` and it
- * becomes `role="img"` with that name — worth doing when the symbol is the only
- * copy of the destination on screen. Pass neither and it is `aria-hidden`,
- * because an unnamed `<svg>` full of squares is decoration, and the root's
- * `hiddenLabel` text already carries the payload.
+ * Role follows naming: pass `aria-label`/`aria-labelledby` for `role="img"`,
+ * or neither for `aria-hidden` (unnamed SVG is decoration; the root's
+ * `hiddenLabel` carries the data). Children cannot name it; the role is set
+ * from props before rendering.
  *
  * Must be used inside a `QrCode`.
  *

package/dist/qr-code/QrCodeOverlay.d.cts

@@ -1,29 +1,22 @@
 import * as React from 'react';
 import type { QrCodeOverlayProps } from './types.cjs';
 /**
- * A centred slot for a logo, sitting on top of the pattern.
+ * A centred logo slot on top of the pattern. Uses `<g transform>`, not
+ * `<foreignObject>`. Children draw into an `extent` × `extent` box with
+ * origin `(0, 0)`.
  *
- * Implemented as a `<g transform="translate(…)">` rather than a
- * `<foreignObject>`: it is one attribute against a nested HTML document with
- * its own namespace, sizing rules and inconsistent serialization, and an SVG
- * `<image>` or `<path>` is what a logo in an SVG wants to be anyway. Children
- * draw into a `size` × `size` box whose own origin is `(0, 0)`, so they never
- * have to know where the centre of the symbol is.
+ * No backing, padding, or clip drawn (consumer adds `<rect>` if needed).
  *
- * Nothing is drawn for you — no backing plate, no padding, no clip. A logo
- * usually wants an opaque `<rect>` behind it so the modules do not show
- * through; that is a consumer decision, and this library ships no paint.
- *
- * **Use `errorCorrection="H"` on the root whenever this is present.** The
- * overlay destroys every module underneath it; only level `'H'` has the
- * redundancy (~30%) to reconstruct them, and this component cannot raise the
- * level on your behalf without silently changing the symbol you asked for.
+ * **Use `errorCorrection="H"` on the root.** Overlay destroys modules
+ * underneath; only 'H' has the redundancy to reconstruct them. Component
+ * warns once in development if not 'H', rather than silently changing the
+ * symbol.
  *
  * Must be used inside a `QrCode`.
  *
  * @example
  * ```tsx
- * <QrCodeOverlay size={7}>
+ * <QrCodeOverlay extent={7}>
  *   <rect width={7} height={7} fill="white" />
  *   <image href={logo} width={7} height={7} />
  * </QrCodeOverlay>

package/dist/qr-code/QrCodeOverlay.d.ts

@@ -1,29 +1,22 @@
 import * as React from 'react';
 import type { QrCodeOverlayProps } from './types.js';
 /**
- * A centred slot for a logo, sitting on top of the pattern.
+ * A centred logo slot on top of the pattern. Uses `<g transform>`, not
+ * `<foreignObject>`. Children draw into an `extent` × `extent` box with
+ * origin `(0, 0)`.
  *
- * Implemented as a `<g transform="translate(…)">` rather than a
- * `<foreignObject>`: it is one attribute against a nested HTML document with
- * its own namespace, sizing rules and inconsistent serialization, and an SVG
- * `<image>` or `<path>` is what a logo in an SVG wants to be anyway. Children
- * draw into a `size` × `size` box whose own origin is `(0, 0)`, so they never
- * have to know where the centre of the symbol is.
+ * No backing, padding, or clip drawn (consumer adds `<rect>` if needed).
  *
- * Nothing is drawn for you — no backing plate, no padding, no clip. A logo
- * usually wants an opaque `<rect>` behind it so the modules do not show
- * through; that is a consumer decision, and this library ships no paint.
- *
- * **Use `errorCorrection="H"` on the root whenever this is present.** The
- * overlay destroys every module underneath it; only level `'H'` has the
- * redundancy (~30%) to reconstruct them, and this component cannot raise the
- * level on your behalf without silently changing the symbol you asked for.
+ * **Use `errorCorrection="H"` on the root.** Overlay destroys modules
+ * underneath; only 'H' has the redundancy to reconstruct them. Component
+ * warns once in development if not 'H', rather than silently changing the
+ * symbol.
  *
  * Must be used inside a `QrCode`.
  *
  * @example
  * ```tsx
- * <QrCodeOverlay size={7}>
+ * <QrCodeOverlay extent={7}>
  *   <rect width={7} height={7} fill="white" />
  *   <image href={logo} width={7} height={7} />
  * </QrCodeOverlay>

package/dist/qr-code/QrCodePattern.d.cts

@@ -1,18 +1,9 @@
 import * as React from 'react';
 import type { QrCodePatternProps } from './types.cjs';
 /**
- * Every dark module of the symbol, as **one `<path>`**.
- *
- * The obvious implementation — one `<rect>` per module — puts 31,329 elements
- * in the DOM for a version 40 code and makes the browser lay out and paint
- * each of them. A single path with one `M x y h1 v1 h-1 z` subpath per module
- * is one element and one paint, and the `d` string is memoized on the matrix so
- * it survives re-renders that do not re-encode.
- *
- * It has no fill of its own: set `fill` (or a `className`) yourself. Adjacent
- * subpaths share edges, so `fill-rule` never matters here.
- *
- * Must be used inside a `QrCode`.
+ * Every dark module of the symbol as one `<path>`. Uses subpaths per module
+ * for one element and one paint, with memoized `d` that survives re-renders.
+ * Has no fill: set `fill` or `className` yourself.
  *
  * @example
  * ```tsx

package/dist/qr-code/QrCodePattern.d.ts

@@ -1,18 +1,9 @@
 import * as React from 'react';
 import type { QrCodePatternProps } from './types.js';
 /**
- * Every dark module of the symbol, as **one `<path>`**.
- *
- * The obvious implementation — one `<rect>` per module — puts 31,329 elements
- * in the DOM for a version 40 code and makes the browser lay out and paint
- * each of them. A single path with one `M x y h1 v1 h-1 z` subpath per module
- * is one element and one paint, and the `d` string is memoized on the matrix so
- * it survives re-renders that do not re-encode.
- *
- * It has no fill of its own: set `fill` (or a `className`) yourself. Adjacent
- * subpaths share edges, so `fill-rule` never matters here.
- *
- * Must be used inside a `QrCode`.
+ * Every dark module of the symbol as one `<path>`. Uses subpaths per module
+ * for one element and one paint, with memoized `d` that survives re-renders.
+ * Has no fill: set `fill` or `className` yourself.
  *
  * @example
  * ```tsx

package/dist/qr-code/encoder.d.cts

@@ -1,15 +1,6 @@
 /**
- * A compact QR Code encoder written from ISO/IEC 18004, deliberately narrow in
- * scope: **byte mode only** (UTF-8), versions 1–40, all four error-correction
- * levels. No Kanji/alphanumeric/numeric mode switching, no ECI, no Micro QR.
- *
- * Byte mode alone is not a limitation worth fixing: it encodes every string,
- * and the modes it omits only ever buy density for inputs that are entirely
- * digits or entirely uppercase-alphanumeric. Paying ~20% more modules on a URL
- * is cheaper than shipping a segment optimiser nobody reads.
- *
- * The whole module is pure and synchronous — no DOM, no canvas, no timers — so
- * it runs unchanged under SSR.
+ * QR Code encoder from ISO/IEC 18004: byte mode only (UTF-8), versions 1–40,
+ * all four error-correction levels. Pure and synchronous; runs unchanged under SSR.
  *
  * @module
  */
@@ -28,35 +19,22 @@ export declare function totalCodewords(version: number): number;
  */
 export declare function dataCapacityBits(version: number, level: ErrorCorrectionLevel): number;
 /**
- * Centre coordinates of the alignment patterns for `version`, ascending.
- * Empty at version 1, which has none.
- *
- * The spacing is even except for the first gap, which absorbs the remainder —
- * exactly the rule ISO/IEC 18004 Table E.1 tabulates, with version 32's
- * one-off step of 26 as the single exception the rule does not cover.
+ * Centre coordinates of alignment patterns for `version`, ascending.
+ * Empty at v1. Spacing per ISO/IEC 18004 Table E.1; v32 has a one-off step of 26.
  */
 export declare function alignmentPatternPositions(version: number): number[];
 /**
- * Reed–Solomon generator polynomial of the given degree — the product
- * `(x − α^0)(x − α^1)…(x − α^(degree−1))` over GF(256).
- *
- * Returned **monic-implicit**: `degree` coefficients from x^(degree−1) down to
- * x^0, with the leading 1 omitted, which is the form the remainder loop wants.
- * Degree 7 is `[127, 122, 154, 164, 11, 68, 117]`.
+ * Reed–Solomon generator polynomial: `(x − α^0)(x − α^1)…(x − α^(degree−1))`.
+ * Returned monic-implicit (leading 1 omitted).
  */
 export declare function reedSolomonGeneratorPoly(degree: number): Uint8Array;
 /**
- * The 15-bit format-information word for a level/mask pair: a BCH(15, 5)
- * codeword over the 5 data bits `level | mask`, XOR-masked with `0b101010000010010`
- * so that the all-zero data never produces an all-zero word.
- *
- * `formatInfoBits('L', 0)` is `0b111011111000100`.
+ * 15-bit format-information word: BCH(15, 5) over `level | mask`,
+ * XOR-masked to avoid all-zero output.
  */
 export declare function formatInfoBits(level: ErrorCorrectionLevel, mask: number): number;
 /**
- * The 18-bit version-information word, a BCH(18, 6) codeword over the version
- * number. Only versions ≥ 7 carry one; smaller symbols are identified by their
- * size alone. Unmasked, unlike the format word.
+ * 18-bit version-information word: BCH(18, 6). Only v7+; smaller symbols need none.
  */
 export declare function versionInfoBits(version: number): number;
 /**

package/dist/qr-code/encoder.d.ts

@@ -1,15 +1,6 @@
 /**
- * A compact QR Code encoder written from ISO/IEC 18004, deliberately narrow in
- * scope: **byte mode only** (UTF-8), versions 1–40, all four error-correction
- * levels. No Kanji/alphanumeric/numeric mode switching, no ECI, no Micro QR.
- *
- * Byte mode alone is not a limitation worth fixing: it encodes every string,
- * and the modes it omits only ever buy density for inputs that are entirely
- * digits or entirely uppercase-alphanumeric. Paying ~20% more modules on a URL
- * is cheaper than shipping a segment optimiser nobody reads.
- *
- * The whole module is pure and synchronous — no DOM, no canvas, no timers — so
- * it runs unchanged under SSR.
+ * QR Code encoder from ISO/IEC 18004: byte mode only (UTF-8), versions 1–40,
+ * all four error-correction levels. Pure and synchronous; runs unchanged under SSR.
  *
  * @module
  */
@@ -28,35 +19,22 @@ export declare function totalCodewords(version: number): number;
  */
 export declare function dataCapacityBits(version: number, level: ErrorCorrectionLevel): number;
 /**
- * Centre coordinates of the alignment patterns for `version`, ascending.
- * Empty at version 1, which has none.
- *
- * The spacing is even except for the first gap, which absorbs the remainder —
- * exactly the rule ISO/IEC 18004 Table E.1 tabulates, with version 32's
- * one-off step of 26 as the single exception the rule does not cover.
+ * Centre coordinates of alignment patterns for `version`, ascending.
+ * Empty at v1. Spacing per ISO/IEC 18004 Table E.1; v32 has a one-off step of 26.
  */
 export declare function alignmentPatternPositions(version: number): number[];
 /**
- * Reed–Solomon generator polynomial of the given degree — the product
- * `(x − α^0)(x − α^1)…(x − α^(degree−1))` over GF(256).
- *
- * Returned **monic-implicit**: `degree` coefficients from x^(degree−1) down to
- * x^0, with the leading 1 omitted, which is the form the remainder loop wants.
- * Degree 7 is `[127, 122, 154, 164, 11, 68, 117]`.
+ * Reed–Solomon generator polynomial: `(x − α^0)(x − α^1)…(x − α^(degree−1))`.
+ * Returned monic-implicit (leading 1 omitted).
  */
 export declare function reedSolomonGeneratorPoly(degree: number): Uint8Array;
 /**
- * The 15-bit format-information word for a level/mask pair: a BCH(15, 5)
- * codeword over the 5 data bits `level | mask`, XOR-masked with `0b101010000010010`
- * so that the all-zero data never produces an all-zero word.
- *
- * `formatInfoBits('L', 0)` is `0b111011111000100`.
+ * 15-bit format-information word: BCH(15, 5) over `level | mask`,
+ * XOR-masked to avoid all-zero output.
  */
 export declare function formatInfoBits(level: ErrorCorrectionLevel, mask: number): number;
 /**
- * The 18-bit version-information word, a BCH(18, 6) codeword over the version
- * number. Only versions ≥ 7 carry one; smaller symbols are identified by their
- * size alone. Unmasked, unlike the format word.
+ * 18-bit version-information word: BCH(18, 6). Only v7+; smaller symbols need none.
  */
 export declare function versionInfoBits(version: number): number;
 /**

package/dist/qr-code/index.d.cts

@@ -1,5 +1,2 @@
 export { QrCode } from './QrCode.cjs';
-export { QrCodeFrame } from './QrCodeFrame.cjs';
-export { QrCodeOverlay } from './QrCodeOverlay.cjs';
-export { QrCodePattern } from './QrCodePattern.cjs';
-export type { QrCodeErrorCorrection, QrCodeFrameProps, QrCodeOverlayProps, QrCodePatternProps, QrCodeProps, } from './types.cjs';
+export type { QrCodeErrorCorrection, QrCodeProps } from './types.cjs';

package/dist/qr-code/index.d.ts

@@ -1,5 +1,2 @@
 export { QrCode } from './QrCode.js';
-export { QrCodeFrame } from './QrCodeFrame.js';
-export { QrCodeOverlay } from './QrCodeOverlay.js';
-export { QrCodePattern } from './QrCodePattern.js';
-export type { QrCodeErrorCorrection, QrCodeFrameProps, QrCodeOverlayProps, QrCodePatternProps, QrCodeProps, } from './types.js';
+export type { QrCodeErrorCorrection, QrCodeProps } from './types.js';

package/dist/qr-code/primitives.d.cts

@@ -0,0 +1,23 @@
+/**
+ * Advanced primitives for `QrCode` — the parts the recipe composes. Use
+ * for full manual composition.
+ *
+ * @example
+ * ```tsx
+ * import { QrCode, QrCodeFrame, QrCodeOverlay, QrCodePattern } from '@skdx/react/primitives/qr-code';
+ *
+ * <QrCode value="https://example.com" errorCorrection="H">
+ *   <QrCodeFrame aria-label="Link to example.com">
+ *     <QrCodePattern fill="currentColor" />
+ *     <QrCodeOverlay extent={7}>
+ *       <image href={logo} width={7} height={7} />
+ *     </QrCodeOverlay>
+ *   </QrCodeFrame>
+ * </QrCode>
+ * ```
+ */
+export { QrCode } from './QrCode.cjs';
+export { QrCodeFrame } from './QrCodeFrame.cjs';
+export { QrCodeOverlay } from './QrCodeOverlay.cjs';
+export { QrCodePattern } from './QrCodePattern.cjs';
+export type { QrCodeProps, QrCodeFrameProps, QrCodeOverlayProps, QrCodePatternProps, } from './types.cjs';

package/dist/qr-code/primitives.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Advanced primitives for `QrCode` — the parts the recipe composes. Use
+ * for full manual composition.
+ *
+ * @example
+ * ```tsx
+ * import { QrCode, QrCodeFrame, QrCodeOverlay, QrCodePattern } from '@skdx/react/primitives/qr-code';
+ *
+ * <QrCode value="https://example.com" errorCorrection="H">
+ *   <QrCodeFrame aria-label="Link to example.com">
+ *     <QrCodePattern fill="currentColor" />
+ *     <QrCodeOverlay extent={7}>
+ *       <image href={logo} width={7} height={7} />
+ *     </QrCodeOverlay>
+ *   </QrCodeFrame>
+ * </QrCode>
+ * ```
+ */
+export { QrCode } from './QrCode.js';
+export { QrCodeFrame } from './QrCodeFrame.js';
+export { QrCodeOverlay } from './QrCodeOverlay.js';
+export { QrCodePattern } from './QrCodePattern.js';
+export type { QrCodeProps, QrCodeFrameProps, QrCodeOverlayProps, QrCodePatternProps, } from './types.js';

package/dist/qr-code/types.d.cts

@@ -14,6 +14,8 @@ export interface QrCodeContextValue {
     size: number;
     /** The encoded payload, so parts can label themselves without re-threading the prop. */
     value: string;
+    /** The level the symbol was encoded at, so the Overlay can warn when it is not `'H'`. */
+    errorCorrection: QrCodeErrorCorrection;
 }
 /** Props for the {@link QrCode} root. */
 export interface QrCodeProps extends PrimitivePropsWithRef<'div'> {
@@ -24,15 +26,9 @@ export interface QrCodeProps extends PrimitivePropsWithRef<'div'> {
      */
     value: string;
     /**
-     * Error-correction level. Higher levels survive more damage, at the cost of
-     * a denser symbol for the same payload.
-     *
-     * **A logo overlay requires `'H'`, or the code stops scanning.** Anything
-     * painted over the centre destroys the modules underneath it, and only `'H'`
-     * carries enough redundancy (~30%) to reconstruct them. `QrCodeOverlay` does
-     * not raise the level for you — covering an `'M'` symbol produces a code that
-     * looks right and scans in your hand, then fails on a customer's older phone
-     * in poor light.
+     * Error-correction level. Higher levels survive more damage at the cost of
+     * a denser symbol. **A logo overlay requires `'H'`** — only its ~30%
+     * redundancy can reconstruct modules destroyed by overlay paint.
      * @default 'M'
      */
     errorCorrection?: QrCodeErrorCorrection;
@@ -45,12 +41,6 @@ export interface QrCodeProps extends PrimitivePropsWithRef<'div'> {
      * @default undefined — the smallest version whose capacity fits `value`.
      */
     version?: number;
-    /**
-     * Encoding mode. `'byte'` is the only value today; the prop exists so numeric,
-     * alphanumeric and Kanji modes can be added later without a breaking change.
-     * @default 'byte'
-     */
-    encoding?: 'byte';
     /**
      * Fires when `value` cannot be encoded — it exceeds the capacity of version 40
      * at the chosen level, or of the `version` you pinned, or `version` is outside
@@ -60,15 +50,24 @@ export interface QrCodeProps extends PrimitivePropsWithRef<'div'> {
      */
     onEncodeError?: (error: Error) => void;
     /**
-     * Render `value` as visually hidden text inside the root, so a screen-reader
-     * user reaches the destination without a camera. A QR code is otherwise a
-     * dead end to anyone who cannot point a phone at it.
+     * Visually hidden text rendered inside the root. Allows screen-reader users
+     * to reach the destination without a camera.
      *
-     * Set to `false` only when you already render the value (or an equivalent
-     * link) yourself — otherwise it is announced twice.
+     * - `true` renders `value` itself.
+     * - A **string** renders that instead — use for payloads not meant to be
+     *   recited aloud (Wi-Fi credentials, signed tokens). Pass a description
+     *   like "Wi-Fi network Guest" instead.
+     * - `false` renders none — only when you render the value yourself.
      * @default true
      */
-    hiddenLabel?: boolean;
+    hiddenLabel?: boolean | string;
+    /**
+     * Content centred over the pattern in a derived `QrCodeOverlay`. Ignored
+     * when `children` is given. **Requires `errorCorrection="H"`** to preserve
+     * scannability through paint.
+     * @default undefined
+     */
+    overlay?: React.ReactNode;
 }
 /** Props for {@link QrCodeFrame}, the `<svg>` host. */
 export interface QrCodeFrameProps extends PrimitivePropsWithRef<'svg'> {
@@ -79,14 +78,10 @@ export interface QrCodePatternProps extends React.ComponentPropsWithRef<'path'>
 /** Props for {@link QrCodeOverlay}, the centred slot for a logo. */
 export interface QrCodeOverlayProps extends React.ComponentPropsWithRef<'g'> {
     /**
-     * Edge length of the overlay box, **in module units** — the same coordinate
-     * space as the `viewBox`, so `8` is eight modules wide however large the
-     * symbol renders. Children draw into a `size` × `size` box with its own
-     * origin at `(0, 0)`.
-     *
-     * Keep it under roughly a fifth of the symbol's edge: a larger patch damages
-     * more modules than even `'H'` error correction can reconstruct.
-     * @default 7 — the width of a finder pattern, which reads as deliberate at any version.
+     * Edge length of the overlay box **in module units** — `8` is eight modules
+     * wide at any symbol size. Keep it under roughly a fifth of the symbol's edge;
+     * larger overlays damage more modules than `'H'` error correction recovers.
+     * @default 7
      */
-    size?: number;
+    extent?: number;
 }

package/dist/qr-code/types.d.ts

@@ -14,6 +14,8 @@ export interface QrCodeContextValue {
     size: number;
     /** The encoded payload, so parts can label themselves without re-threading the prop. */
     value: string;
+    /** The level the symbol was encoded at, so the Overlay can warn when it is not `'H'`. */
+    errorCorrection: QrCodeErrorCorrection;
 }
 /** Props for the {@link QrCode} root. */
 export interface QrCodeProps extends PrimitivePropsWithRef<'div'> {
@@ -24,15 +26,9 @@ export interface QrCodeProps extends PrimitivePropsWithRef<'div'> {
      */
     value: string;
     /**
-     * Error-correction level. Higher levels survive more damage, at the cost of
-     * a denser symbol for the same payload.
-     *
-     * **A logo overlay requires `'H'`, or the code stops scanning.** Anything
-     * painted over the centre destroys the modules underneath it, and only `'H'`
-     * carries enough redundancy (~30%) to reconstruct them. `QrCodeOverlay` does
-     * not raise the level for you — covering an `'M'` symbol produces a code that
-     * looks right and scans in your hand, then fails on a customer's older phone
-     * in poor light.
+     * Error-correction level. Higher levels survive more damage at the cost of
+     * a denser symbol. **A logo overlay requires `'H'`** — only its ~30%
+     * redundancy can reconstruct modules destroyed by overlay paint.
      * @default 'M'
      */
     errorCorrection?: QrCodeErrorCorrection;
@@ -45,12 +41,6 @@ export interface QrCodeProps extends PrimitivePropsWithRef<'div'> {
      * @default undefined — the smallest version whose capacity fits `value`.
      */
     version?: number;
-    /**
-     * Encoding mode. `'byte'` is the only value today; the prop exists so numeric,
-     * alphanumeric and Kanji modes can be added later without a breaking change.
-     * @default 'byte'
-     */
-    encoding?: 'byte';
     /**
      * Fires when `value` cannot be encoded — it exceeds the capacity of version 40
      * at the chosen level, or of the `version` you pinned, or `version` is outside
@@ -60,15 +50,24 @@ export interface QrCodeProps extends PrimitivePropsWithRef<'div'> {
      */
     onEncodeError?: (error: Error) => void;
     /**
-     * Render `value` as visually hidden text inside the root, so a screen-reader
-     * user reaches the destination without a camera. A QR code is otherwise a
-     * dead end to anyone who cannot point a phone at it.
+     * Visually hidden text rendered inside the root. Allows screen-reader users
+     * to reach the destination without a camera.
      *
-     * Set to `false` only when you already render the value (or an equivalent
-     * link) yourself — otherwise it is announced twice.
+     * - `true` renders `value` itself.
+     * - A **string** renders that instead — use for payloads not meant to be
+     *   recited aloud (Wi-Fi credentials, signed tokens). Pass a description
+     *   like "Wi-Fi network Guest" instead.
+     * - `false` renders none — only when you render the value yourself.
      * @default true
      */
-    hiddenLabel?: boolean;
+    hiddenLabel?: boolean | string;
+    /**
+     * Content centred over the pattern in a derived `QrCodeOverlay`. Ignored
+     * when `children` is given. **Requires `errorCorrection="H"`** to preserve
+     * scannability through paint.
+     * @default undefined
+     */
+    overlay?: React.ReactNode;
 }
 /** Props for {@link QrCodeFrame}, the `<svg>` host. */
 export interface QrCodeFrameProps extends PrimitivePropsWithRef<'svg'> {
@@ -79,14 +78,10 @@ export interface QrCodePatternProps extends React.ComponentPropsWithRef<'path'>
 /** Props for {@link QrCodeOverlay}, the centred slot for a logo. */
 export interface QrCodeOverlayProps extends React.ComponentPropsWithRef<'g'> {
     /**
-     * Edge length of the overlay box, **in module units** — the same coordinate
-     * space as the `viewBox`, so `8` is eight modules wide however large the
-     * symbol renders. Children draw into a `size` × `size` box with its own
-     * origin at `(0, 0)`.
-     *
-     * Keep it under roughly a fifth of the symbol's edge: a larger patch damages
-     * more modules than even `'H'` error correction can reconstruct.
-     * @default 7 — the width of a finder pattern, which reads as deliberate at any version.
+     * Edge length of the overlay box **in module units** — `8` is eight modules
+     * wide at any symbol size. Keep it under roughly a fifth of the symbol's edge;
+     * larger overlays damage more modules than `'H'` error correction recovers.
+     * @default 7
      */
-    size?: number;
+    extent?: number;
 }

package/dist/radio-card/RadioCard.cjs

@@ -1 +1 @@
-"use strict";var Y=Object.create;var f=Object.defineProperty;var Z=Object.getOwnPropertyDescriptor;var _=Object.getOwnPropertyNames;var j=Object.getPrototypeOf,ee=Object.prototype.hasOwnProperty;var ae=(a,o)=>{for(var e in o)f(a,e,{get:o[e],enumerable:!0})},I=(a,o,e,t)=>{if(o&&typeof o=="object"||typeof o=="function")for(let r of _(o))!ee.call(a,r)&&r!==e&&f(a,r,{get:()=>o[r],enumerable:!(t=Z(o,r))||t.enumerable});return a};var c=(a,o,e)=>(e=a!=null?Y(j(a)):{},I(o||!a||!a.__esModule?f(e,"default",{value:a,enumerable:!0}):e,a)),oe=a=>I(f({},"__esModule",{value:!0}),a);var re={};ae(re,{RadioCard:()=>E,RadioCardControl:()=>P,RadioCardDescription:()=>y,RadioCardIndicator:()=>x,RadioCardLabel:()=>h,RadioCardProvider:()=>S,useRadioCardContext:()=>i});module.exports=oe(re);var d=c(require("react"),1),D=require("../radio-group/RadioGroup.cjs"),H=require("../utils/createContext.cjs"),v=require("../utils/part.cjs"),s=require("../utils/primitive.cjs"),u=require("react/jsx-runtime"),[S,i]=(0,H.createSafeContext)("RadioCard"),E=d.forwardRef(({value:a,disabled:o=!1,...e},t)=>{let r=(0,D.useRadioGroupContext)("RadioCard"),n=r.value===a,p=r.disabled||o,J=n||r.value===void 0&&r.firstEnabledValue===a,L=d.useId(),[K,O]=d.useState(!1),[Q,U]=d.useState(!1),[W,k]=d.useState(!1),m=d.useRef(!1),X=d.useCallback(()=>{p||n||r.onValueChange(a)},[p,n,r,a]);return(0,u.jsx)(S,{value:a,checked:n,disabled:p,tabStop:J,required:r.required,name:r.name,labelId:`${L}-label`,descriptionId:`${L}-description`,hasLabel:K,hasDescription:Q,setHasLabel:O,setHasDescription:U,onSelect:X,children:(0,u.jsx)(s.Primitive.label,{"data-state":n?"checked":"unchecked","data-disabled":p?"":void 0,"data-focus-visible":W?"":void 0,...e,...(0,v.skdxPart)("radio-card","root",e.className),ref:t,onPointerDown:(0,s.composeEventHandlers)(e.onPointerDown,()=>{m.current=!0}),onFocus:(0,s.composeEventHandlers)(e.onFocus,()=>{k(!m.current),m.current=!1}),onBlur:(0,s.composeEventHandlers)(e.onBlur,()=>{k(!1),m.current=!1})})})});E.displayName="RadioCard";var N=c(require("react"),1),V=require("../utils/part.cjs"),l=require("../utils/primitive.cjs"),w=require("../utils/visuallyHidden.cjs");var b=require("react/jsx-runtime"),P=N.forwardRef((a,o)=>{let e=i("RadioCardControl");return(0,b.jsx)(w.VisuallyHidden,{asChild:!0,children:(0,b.jsx)(l.Primitive.input,{type:"radio",role:"radio",name:e.name,value:e.value,checked:e.checked,required:e.required,disabled:e.disabled,tabIndex:e.tabStop?0:-1,"aria-labelledby":e.hasLabel?e.labelId:void 0,"aria-describedby":e.hasDescription?e.descriptionId:void 0,"data-value":e.value,"data-state":e.checked?"checked":"unchecked",...a,...(0,V.skdxPart)("radio-card","control",a.className),ref:o,onChange:(0,l.composeEventHandlers)(a.onChange,e.onSelect),onFocus:(0,l.composeEventHandlers)(a.onFocus,e.onSelect)})})});P.displayName="RadioCardControl";var F=c(require("react"),1),M=require("../utils/part.cjs"),T=require("../utils/primitive.cjs");var g=require("react/jsx-runtime"),x=F.forwardRef((a,o)=>{let e=i("RadioCardIndicator");return(0,g.jsx)(T.Primitive.span,{"aria-hidden":!0,"data-state":e.checked?"checked":"unchecked","data-disabled":e.disabled?"":void 0,...a,...(0,M.skdxPart)("radio-card","indicator",a.className),ref:o})});x.displayName="RadioCardIndicator";var R=c(require("react"),1),q=require("../utils/part.cjs"),B=require("../utils/primitive.cjs");var $=require("react/jsx-runtime"),h=R.forwardRef((a,o)=>{let e=i("RadioCardLabel"),{setHasLabel:t}=e;return R.useEffect(()=>(t(!0),()=>t(!1)),[t]),(0,$.jsx)(B.Primitive.span,{id:e.labelId,"data-disabled":e.disabled?"":void 0,...a,...(0,q.skdxPart)("radio-card","label",a.className),ref:o})});h.displayName="RadioCardLabel";var C=c(require("react"),1),G=require("../utils/part.cjs"),z=require("../utils/primitive.cjs");var A=require("react/jsx-runtime"),y=C.forwardRef((a,o)=>{let e=i("RadioCardDescription"),{setHasDescription:t}=e;return C.useEffect(()=>(t(!0),()=>t(!1)),[t]),(0,A.jsx)(z.Primitive.span,{id:e.descriptionId,"data-disabled":e.disabled?"":void 0,...a,...(0,G.skdxPart)("radio-card","description",a.className),ref:o})});y.displayName="RadioCardDescription";0&&(module.exports={RadioCard,RadioCardControl,RadioCardDescription,RadioCardIndicator,RadioCardLabel,RadioCardProvider,useRadioCardContext});
+"use strict";var le=Object.create;var R=Object.defineProperty;var ce=Object.getOwnPropertyDescriptor;var me=Object.getOwnPropertyNames;var pe=Object.getPrototypeOf,fe=Object.prototype.hasOwnProperty;var Re=(o,a)=>{for(var e in a)R(o,e,{get:a[e],enumerable:!0})},I=(o,a,e,t)=>{if(a&&typeof a=="object"||typeof a=="function")for(let r of me(a))!fe.call(o,r)&&r!==e&&R(o,r,{get:()=>a[r],enumerable:!(t=ce(a,r))||t.enumerable});return o};var c=(o,a,e)=>(e=o!=null?le(pe(o)):{},I(a||!o||!o.__esModule?R(e,"default",{value:o,enumerable:!0}):e,o)),ue=o=>I(R({},"__esModule",{value:!0}),o);var Ce={};Re(Ce,{RadioCard:()=>S,RadioCardControl:()=>u,RadioCardDescription:()=>b,RadioCardIndicator:()=>y,RadioCardLabel:()=>x,RadioCardProvider:()=>Y,RadioCardRoot:()=>k,useRadioCardContext:()=>i});module.exports=ue(Ce);var d=c(require("react"),1),J=require("../radio-group/RadioGroup.cjs"),K=require("../utils/cardNesting.cjs"),Q=require("../utils/composeRefs.cjs"),U=require("../utils/createContext.cjs"),g=require("../utils/declaredChildren.cjs"),X=require("../utils/part.cjs"),l=require("../utils/primitive.cjs");var N=c(require("react"),1),E=require("../utils/part.cjs"),m=require("../utils/primitive.cjs"),T=require("../utils/useRovingFocus.cjs"),V=require("../utils/visuallyHidden.cjs");var L=require("react/jsx-runtime"),u=N.forwardRef((o,a)=>{let e=i("RadioCardControl");return(0,L.jsx)(V.VisuallyHidden,{asChild:!0,children:(0,L.jsx)(m.Primitive.input,{type:"radio",role:"radio",name:e.name,value:e.value,form:e.form,checked:e.checked,required:e.required,disabled:e.disabled,tabIndex:(0,T.rovingTabIndex)(e.tabStopResolved,e.tabStop,e.disabled),"aria-labelledby":e.hasLabel?e.labelId:void 0,"aria-describedby":e.hasDescription?e.descriptionId:void 0,"data-value":e.value,"data-state":e.checked?"checked":"unchecked",...o,...(0,E.skdxPart)("radio-card","control",o.className),ref:a,onChange:(0,m.composeEventHandlers)(o.onChange,()=>e.onSelect("pointer")),onFocus:(0,m.composeEventHandlers)(o.onFocus,t=>{let r=t.relatedTarget;r?.getAttribute("role")==="radio"&&r.closest('[role="radiogroup"]')===t.currentTarget.closest('[role="radiogroup"]')&&e.onSelect("keyboard")})})})});u.displayName="RadioCardControl";var C=c(require("react"),1),w=require("../utils/part.cjs"),M=require("../utils/primitive.cjs");var F=require("react/jsx-runtime"),b=C.forwardRef((o,a)=>{let e=i("RadioCardDescription"),{setHasDescription:t}=e;return C.useEffect(()=>(t(!0),()=>t(!1)),[t]),(0,F.jsx)(M.Primitive.span,{id:e.descriptionId,"data-disabled":e.disabled?"":void 0,...o,...(0,w.skdxPart)("radio-card","description",o.className),ref:a})});b.displayName="RadioCardDescription";var q=c(require("react"),1),A=require("../utils/part.cjs"),G=require("../utils/primitive.cjs");var O=require("react/jsx-runtime"),y=q.forwardRef((o,a)=>{let e=i("RadioCardIndicator");return(0,O.jsx)(G.Primitive.span,{"aria-hidden":!0,"data-state":e.checked?"checked":"unchecked","data-disabled":e.disabled?"":void 0,...o,...(0,A.skdxPart)("radio-card","indicator",o.className),ref:a})});y.displayName="RadioCardIndicator";var h=c(require("react"),1),B=require("../utils/part.cjs"),$=require("../utils/primitive.cjs");var W=require("react/jsx-runtime"),x=h.forwardRef((o,a)=>{let e=i("RadioCardLabel"),{setHasLabel:t}=e;return h.useEffect(()=>(t(!0),()=>t(!1)),[t]),(0,W.jsx)($.Primitive.span,{id:e.labelId,"data-disabled":e.disabled?"":void 0,...o,...(0,B.skdxPart)("radio-card","label",o.className),ref:a})});x.displayName="RadioCardLabel";var n=require("react/jsx-runtime"),z=({label:o,description:a})=>(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(u,{}),(0,n.jsx)(y,{}),o===void 0?null:(0,n.jsx)(x,{children:o}),a===void 0?null:(0,n.jsx)(b,{children:a})]});var P=require("react/jsx-runtime"),[Y,i]=(0,U.createSafeContext)("RadioCard"),k=d.forwardRef(({value:o,disabled:a=!1,...e},t)=>{let r=(0,J.useRadioGroupContext)("RadioCard"),s=r.value===o,p=r.disabled||a,Z=s||r.value==null&&r.firstEnabledValue===o,_=r.value!=null||r.firstEnabledValue!==null,v=d.useId(),[j,ee]=d.useState(!1),[oe,ae]=d.useState(!1),re=j||(0,g.hasDeclaredChild)(e.children,"RadioCardLabel"),te=oe||(0,g.hasDeclaredChild)(e.children,"RadioCardDescription"),[de,D]=d.useState(!1),f=d.useRef(!1),ie=d.useCallback(se=>{p||s||r.readOnly||r.onValueChange(o,se)},[p,s,r,o]),H=d.useRef(null),ne=(0,Q.useComposedRefs)(t,H);return(0,K.useCardNestingWarning)("RadioCard",H),(0,P.jsx)(Y,{value:o,checked:s,disabled:p,readOnly:r.readOnly,tabStop:Z,tabStopResolved:_,required:r.required,name:r.name,form:r.form,labelId:`${v}-label`,descriptionId:`${v}-description`,hasLabel:re,hasDescription:te,setHasLabel:ee,setHasDescription:ae,onSelect:ie,children:(0,P.jsx)(l.Primitive.label,{"data-state":s?"checked":"unchecked","data-disabled":p?"":void 0,"data-focus-visible":de?"":void 0,...e,...(0,X.skdxPart)("radio-card","root",e.className),ref:ne,onPointerDown:(0,l.composeEventHandlers)(e.onPointerDown,()=>{f.current=!0}),onFocus:(0,l.composeEventHandlers)(e.onFocus,()=>{D(!f.current),f.current=!1}),onBlur:(0,l.composeEventHandlers)(e.onBlur,()=>{D(!1),f.current=!1})})})});k.displayName="RadioCardRoot";var S=d.forwardRef(({label:o,description:a,children:e,...t},r)=>(0,P.jsx)(k,{...t,ref:r,children:e??z({label:o,description:a})}));S.displayName="RadioCard";0&&(module.exports={RadioCard,RadioCardControl,RadioCardDescription,RadioCardIndicator,RadioCardLabel,RadioCardProvider,RadioCardRoot,useRadioCardContext});