@skdx/web-components 0.26.0 → 0.28.0

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

@@ -1,30 +1,21 @@
 import { LitElement } from 'lit';
 /**
  * `<skdx-qr-code-overlay>` — a centred slot for a logo, sitting on top of the
- * pattern.
- *
- * Positioned as a percentage of the symbol's edge rather than as an SVG `<g>`:
- * `size` is still counted **in modules**, so `7` is seven modules wide however
- * large the symbol renders, but the box is placed with `inset`/`width` against
- * the `<skdx-qr-code-frame>` around it. That is what lets you slot ordinary
- * markup — an `<img>`, an inline `<svg>`, a `<div>` — into it, which a `<g>`
- * inside a shadow `<svg>` could not accept.
+ * pattern. Positioned as a percentage of the symbol's edge; `extent` is counted
+ * **in modules** but the box uses `inset`/`width` against the frame.
  *
  * Nothing is drawn for you — no backing plate, no padding, no clip. A logo
- * usually wants an opaque background so the modules do not show through; that
- * is a consumer decision, and this library ships no paint.
+ * usually wants an opaque background so the modules do not show through.
  *
- * **Use `error-correction="H"` on the root whenever this is present.** The
- * overlay hides every module underneath it; only level `'H'` has the redundancy
- * (~30%) to reconstruct them, and this element cannot raise the level on your
- * behalf without silently changing the symbol you asked for.
+ * **Use `error-correction="H"` on the root whenever this is present.** The overlay
+ * destroys every module underneath it; only level `'H'` carries ~30% redundancy to
+ * reconstruct them. This element warns in development if the level is too low.
  *
- * `aria-hidden`, because the root's `hidden-label` already carries the payload
- * and a decorative logo adds nothing to it.
+ * Renders `aria-hidden` since the root's `hidden-label` carries the payload.
  *
  * @example
  * ```html
- * <skdx-qr-code-overlay size="7" style="background: white">
+ * <skdx-qr-code-overlay extent="7" style="background: white">
  *   <img src="/logo.svg" alt="" width="100%" height="100%" />
  * </skdx-qr-code-overlay>
  * ```
@@ -32,15 +23,12 @@ import { LitElement } from 'lit';
 export declare class SkdxQrCodeOverlay extends LitElement {
     static styles: import("lit").CSSResult;
     /**
-     * Edge length of the overlay box, **in module units** — the same counting as
-     * the pattern's `viewBox`, so `8` is eight modules wide however large the
-     * symbol renders.
-     *
-     * 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;
     private root;
     private readonly onRootUpdate;
     connectedCallback(): void;

package/dist/qr-code/QrCodeOverlay.js

@@ -1,7 +1,7 @@
-var c=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var l=(i,r,o,e)=>{for(var t=e>1?void 0:e?p(r,o):r,d=i.length-1,n;d>=0;d--)(n=i[d])&&(t=(e?n(r,o,t):n(t))||t);return e&&t&&c(r,o,t),t};import{css as h,html as m,LitElement as b}from"lit";import{property as u}from"lit/decorators.js";import{customElement as v}from"../internal/define.js";import{QR_CODE_INTERNAL_UPDATE as a}from"./QrCode.js";var s=class extends b{constructor(){super(...arguments);this.size=7;this.root=null;this.onRootUpdate=()=>this.requestUpdate()}connectedCallback(){super.connectedCallback(),this.root=this.closest("skdx-qr-code"),this.root?.addEventListener(a,this.onRootUpdate),this.setAttribute("data-skdx-qr-code-overlay",""),this.setAttribute("aria-hidden","true")}disconnectedCallback(){this.root?.removeEventListener(a,this.onRootUpdate),super.disconnectedCallback()}updated(){let o=this.root?.size??0;if(o===0)return;let e=this.size/o*100,t=(100-e)/2;this.style.width=`${e}%`,this.style.height=`${e}%`,this.style.insetInlineStart=`${t}%`,this.style.insetBlockStart=`${t}%`}render(){return m`<slot></slot>`}};s.styles=h`
+var h=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var c=(o,i,r,t)=>{for(var e=t>1?void 0:t?p(i,r):i,n=o.length-1,d;n>=0;n--)(d=o[n])&&(e=(t?d(i,r,e):d(e))||e);return t&&e&&h(i,r,e),e};import{css as m,html as u,LitElement as v}from"lit";import{property as y}from"lit/decorators.js";import{customElement as f,whenUpgraded as b}from"../internal/define.js";import{isDevMode as E}from"../utils/is-dev-mode.js";import{QR_CODE_INTERNAL_UPDATE as a}from"./QrCode.js";function k(o){E()&&(o==="H"||l||(l=!0,console.warn(`[skandadx] <skdx-qr-code-overlay> covers modules the symbol needs, and the <skdx-qr-code> above it is at error correction "${o}". Only "H" carries enough redundancy (~30%) to reconstruct them \u2014 set error-correction="H" on the root, or drop the overlay.`)))}var l=!1,s=class extends v{constructor(){super(...arguments);this.extent=7;this.root=null;this.onRootUpdate=()=>this.requestUpdate()}connectedCallback(){super.connectedCallback(),this.root=this.closest("skdx-qr-code"),this.root?.addEventListener(a,this.onRootUpdate),this.setAttribute("aria-hidden","true"),this.root&&b(this.root,()=>{this.root&&k(this.root.errorCorrection)})}disconnectedCallback(){this.root?.removeEventListener(a,this.onRootUpdate),super.disconnectedCallback()}updated(){let r=this.root?.size??0;if(r===0)return;let t=this.extent/r*100,e=(100-t)/2;this.style.width=`${t}%`,this.style.height=`${t}%`,this.style.insetInlineStart=`${e}%`,this.style.insetBlockStart=`${e}%`}render(){return u`<slot></slot>`}};s.styles=m`
     :host {
       position: absolute;
       display: block;
       box-sizing: border-box;
     }
-  `,l([u({type:Number})],s.prototype,"size",2),s=l([v("skdx-qr-code-overlay","qr-code","overlay")],s);export{s as SkdxQrCodeOverlay};
+  `,c([y({type:Number})],s.prototype,"extent",2),s=c([f("skdx-qr-code-overlay","qr-code","overlay")],s);export{s as SkdxQrCodeOverlay};

package/dist/qr-code/QrCodePattern.cjs

@@ -1,4 +1,4 @@
-"use strict";var c=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var f=(i,r)=>{for(var e in r)c(i,e,{get:r[e],enumerable:!0})},b=(i,r,e,o)=>{if(r&&typeof r=="object"||typeof r=="function")for(let t of g(r))!m.call(i,t)&&t!==e&&c(i,t,{get:()=>r[t],enumerable:!(o=h(r,t))||o.enumerable});return i};var E=i=>b(c({},"__esModule",{value:!0}),i),d=(i,r,e,o)=>{for(var t=o>1?void 0:o?h(r,e):r,n=i.length-1,s;n>=0;n--)(s=i[n])&&(t=(o?s(r,e,t):s(t))||t);return o&&t&&c(r,e,t),t};var k={};f(k,{SkdxQrCodePattern:()=>a});module.exports=E(k);var l=require("lit"),v=require("lit/decorators.js"),u=require("../internal/define.cjs"),p=require("./QrCode.cjs");var a=class extends l.LitElement{constructor(){super(...arguments);this.fill="currentColor";this.root=null;this.onRootUpdate=()=>this.requestUpdate();this.cache=null}connectedCallback(){super.connectedCallback(),this.root=this.closest("skdx-qr-code"),this.root?.addEventListener(p.QR_CODE_INTERNAL_UPDATE,this.onRootUpdate),this.setAttribute("data-skdx-qr-code-pattern","")}disconnectedCallback(){this.root?.removeEventListener(p.QR_CODE_INTERNAL_UPDATE,this.onRootUpdate),super.disconnectedCallback()}pathData(e){if(this.cache?.matrix===e)return this.cache.d;let o="";for(let t=0;t<e.length;t++){let n=e[t];for(let s=0;s<n.length;s++)n[s]&&(o+=`M${s} ${t}h1v1h-1z`)}return this.cache={matrix:e,d:o},o}render(){let e=this.root?.matrix??null;if(e===null)return null;let o=e.length;return l.html`
+"use strict";var c=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var f=(i,r)=>{for(var e in r)c(i,e,{get:r[e],enumerable:!0})},b=(i,r,e,o)=>{if(r&&typeof r=="object"||typeof r=="function")for(let t of g(r))!m.call(i,t)&&t!==e&&c(i,t,{get:()=>r[t],enumerable:!(o=h(r,t))||o.enumerable});return i};var E=i=>b(c({},"__esModule",{value:!0}),i),d=(i,r,e,o)=>{for(var t=o>1?void 0:o?h(r,e):r,a=i.length-1,l;a>=0;a--)(l=i[a])&&(t=(o?l(r,e,t):l(t))||t);return o&&t&&c(r,e,t),t};var y={};f(y,{SkdxQrCodePattern:()=>n});module.exports=E(y);var s=require("lit"),v=require("lit/decorators.js"),u=require("../internal/define.cjs"),p=require("./QrCode.cjs");var n=class extends s.LitElement{constructor(){super(...arguments);this.fill="currentColor";this.root=null;this.onRootUpdate=()=>this.requestUpdate();this.cache=null}connectedCallback(){super.connectedCallback(),this.root=this.closest("skdx-qr-code"),this.root?.addEventListener(p.QR_CODE_INTERNAL_UPDATE,this.onRootUpdate)}disconnectedCallback(){this.root?.removeEventListener(p.QR_CODE_INTERNAL_UPDATE,this.onRootUpdate),super.disconnectedCallback()}pathData(e){if(this.cache?.matrix===e)return this.cache.d;let o="";for(let t=0;t<e.length;t++){let a=e[t];for(let l=0;l<a.length;l++)a[l]&&(o+=`M${l} ${t}h1v1h-1z`)}return this.cache={matrix:e,d:o},o}render(){let e=this.root?.matrix??null;if(e===null)return null;let o=e.length;return s.html`
       <svg
         part="svg"
         xmlns="http://www.w3.org/2000/svg"
@@ -6,9 +6,9 @@
         shape-rendering="crispEdges"
         aria-hidden="true"
       >
-        ${l.svg`<path part="pattern" d=${this.pathData(e)} fill=${this.fill} />`}
+        ${s.svg`<path part="pattern" d=${this.pathData(e)} fill=${this.fill} />`}
       </svg>
-    `}};a.styles=l.css`
+    `}};n.styles=s.css`
     :host {
       display: block;
     }
@@ -17,4 +17,4 @@
       width: 100%;
       height: auto;
     }
-  `,d([(0,v.property)({type:String})],a.prototype,"fill",2),a=d([(0,u.customElement)("skdx-qr-code-pattern","qr-code","pattern")],a);0&&(module.exports={SkdxQrCodePattern});
+  `,d([(0,v.property)({type:String})],n.prototype,"fill",2),n=d([(0,u.customElement)("skdx-qr-code-pattern","qr-code","pattern")],n);0&&(module.exports={SkdxQrCodePattern});

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

@@ -1,25 +1,6 @@
 import { LitElement } from 'lit';
 /**
- * `<skdx-qr-code-pattern>` — every dark module of the symbol, as **one
- * `<path>`** inside its own `<svg>`.
- *
- * 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 cached on the matrix so it
- * survives re-renders that do not re-encode.
- *
- * The `<svg>`'s `viewBox` is `0 0 size size`, so **one user unit is one
- * module**. It fills its container; give the `<skdx-qr-code-frame>` around it a
- * width.
- *
- * It has no fill of its own: set the `fill` attribute, or style
- * `::part(pattern)`. Adjacent subpaths share edges, so `fill-rule` never
- * matters here.
- *
- * Owns the `<svg>` rather than living inside the frame's, because a custom
- * element slotted into an `<svg>` is still an HTML element and does not render
- * as SVG content — see `<skdx-qr-code-frame>`.
+ * Dark modules as single `<path>` with one subpath per module (cached vs. 31,329 rects for v40). `viewBox` is `0 0 size size`; set `fill` or style part. Adjacent subpaths share edges (no `fill-rule` needed). Owns `<svg>` (slotted elements don't render as SVG).
  *
  * @csspart svg - The `<svg>` element inside the shadow root.
  * @csspart pattern - The single `<path>` carrying every dark module.
@@ -38,7 +19,7 @@ export declare class SkdxQrCodePattern extends LitElement {
     fill: string;
     private root;
     private readonly onRootUpdate;
-    /** The last `d` built, keyed on the matrix identity it was built from. */
+    /** Last `d` built, keyed on matrix identity. */
     private cache;
     connectedCallback(): void;
     disconnectedCallback(): void;

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

@@ -1,25 +1,6 @@
 import { LitElement } from 'lit';
 /**
- * `<skdx-qr-code-pattern>` — every dark module of the symbol, as **one
- * `<path>`** inside its own `<svg>`.
- *
- * 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 cached on the matrix so it
- * survives re-renders that do not re-encode.
- *
- * The `<svg>`'s `viewBox` is `0 0 size size`, so **one user unit is one
- * module**. It fills its container; give the `<skdx-qr-code-frame>` around it a
- * width.
- *
- * It has no fill of its own: set the `fill` attribute, or style
- * `::part(pattern)`. Adjacent subpaths share edges, so `fill-rule` never
- * matters here.
- *
- * Owns the `<svg>` rather than living inside the frame's, because a custom
- * element slotted into an `<svg>` is still an HTML element and does not render
- * as SVG content — see `<skdx-qr-code-frame>`.
+ * Dark modules as single `<path>` with one subpath per module (cached vs. 31,329 rects for v40). `viewBox` is `0 0 size size`; set `fill` or style part. Adjacent subpaths share edges (no `fill-rule` needed). Owns `<svg>` (slotted elements don't render as SVG).
  *
  * @csspart svg - The `<svg>` element inside the shadow root.
  * @csspart pattern - The single `<path>` carrying every dark module.
@@ -38,7 +19,7 @@ export declare class SkdxQrCodePattern extends LitElement {
     fill: string;
     private root;
     private readonly onRootUpdate;
-    /** The last `d` built, keyed on the matrix identity it was built from. */
+    /** Last `d` built, keyed on matrix identity. */
     private cache;
     connectedCallback(): void;
     disconnectedCallback(): void;

package/dist/qr-code/QrCodePattern.js

@@ -1,4 +1,4 @@
-var d=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var n=(a,l,t,r)=>{for(var e=r>1?void 0:r?p(l,t):l,i=a.length-1,o;i>=0;i--)(o=a[i])&&(e=(r?o(l,t,e):o(e))||e);return r&&e&&d(l,t,e),e};import{css as h,html as v,LitElement as u,svg as g}from"lit";import{property as m}from"lit/decorators.js";import{customElement as f}from"../internal/define.js";import{QR_CODE_INTERNAL_UPDATE as c}from"./QrCode.js";var s=class extends u{constructor(){super(...arguments);this.fill="currentColor";this.root=null;this.onRootUpdate=()=>this.requestUpdate();this.cache=null}connectedCallback(){super.connectedCallback(),this.root=this.closest("skdx-qr-code"),this.root?.addEventListener(c,this.onRootUpdate),this.setAttribute("data-skdx-qr-code-pattern","")}disconnectedCallback(){this.root?.removeEventListener(c,this.onRootUpdate),super.disconnectedCallback()}pathData(t){if(this.cache?.matrix===t)return this.cache.d;let r="";for(let e=0;e<t.length;e++){let i=t[e];for(let o=0;o<i.length;o++)i[o]&&(r+=`M${o} ${e}h1v1h-1z`)}return this.cache={matrix:t,d:r},r}render(){let t=this.root?.matrix??null;if(t===null)return null;let r=t.length;return v`
+var d=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var a=(n,s,t,r)=>{for(var e=r>1?void 0:r?p(s,t):s,i=n.length-1,o;i>=0;i--)(o=n[i])&&(e=(r?o(s,t,e):o(e))||e);return r&&e&&d(s,t,e),e};import{css as h,html as v,LitElement as u,svg as g}from"lit";import{property as m}from"lit/decorators.js";import{customElement as f}from"../internal/define.js";import{QR_CODE_INTERNAL_UPDATE as c}from"./QrCode.js";var l=class extends u{constructor(){super(...arguments);this.fill="currentColor";this.root=null;this.onRootUpdate=()=>this.requestUpdate();this.cache=null}connectedCallback(){super.connectedCallback(),this.root=this.closest("skdx-qr-code"),this.root?.addEventListener(c,this.onRootUpdate)}disconnectedCallback(){this.root?.removeEventListener(c,this.onRootUpdate),super.disconnectedCallback()}pathData(t){if(this.cache?.matrix===t)return this.cache.d;let r="";for(let e=0;e<t.length;e++){let i=t[e];for(let o=0;o<i.length;o++)i[o]&&(r+=`M${o} ${e}h1v1h-1z`)}return this.cache={matrix:t,d:r},r}render(){let t=this.root?.matrix??null;if(t===null)return null;let r=t.length;return v`
       <svg
         part="svg"
         xmlns="http://www.w3.org/2000/svg"
@@ -8,7 +8,7 @@ var d=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var n=(a,l,t,r
       >
         ${g`<path part="pattern" d=${this.pathData(t)} fill=${this.fill} />`}
       </svg>
-    `}};s.styles=h`
+    `}};l.styles=h`
     :host {
       display: block;
     }
@@ -17,4 +17,4 @@ var d=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var n=(a,l,t,r
       width: 100%;
       height: auto;
     }
-  `,n([m({type:String})],s.prototype,"fill",2),s=n([f("skdx-qr-code-pattern","qr-code","pattern")],s);export{s as SkdxQrCodePattern};
+  `,a([m({type:String})],l.prototype,"fill",2),l=a([f("skdx-qr-code-pattern","qr-code","pattern")],l);export{l as SkdxQrCodePattern};

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

@@ -1,16 +1,7 @@
 /**
- * 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, no DOM/canvas/timers,
+ * runs unchanged under SSR.
  * @module
  */
 /** Error-correction level, in ascending order of redundancy: `L` ≈ 7%, `M` ≈ 15%, `Q` ≈ 25%, `H` ≈ 30%. */
@@ -21,53 +12,35 @@ export declare const MAX_VERSION = 40;
 export declare function moduleCount(version: number): number;
 /** Total codewords (data + EC) a version holds, independent of level. */
 export declare function totalCodewords(version: number): number;
-/**
- * Bits available for the *data* segment (mode indicator, character count,
- * payload, padding) at this version and level — total codewords less every
- * error-correction codeword.
- */
+/** Data segment bits (mode, char count, payload, padding): total codewords minus error-correction. */
 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.
+ * Alignment pattern center coordinates (ISO/IEC 18004 Table E.1), ascending.
+ * Empty at version 1. Spacing is even except first gap (absorbs remainder);
+ * version 32 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))
+ * over GF(256). Monic-implicit: degree coefficients x^(degree-1) to x^0,
+ * 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)): level/mask data XOR-masked
+ * with 0b101010000010010 to prevent all-zero data from producing 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)): version number only. Versions ≥7 only, unmasked. */
 export declare function versionInfoBits(version: number): number;
 /**
  * Encodes `value` as a QR Code matrix.
  *
  * @param value - The payload, encoded as UTF-8 bytes (byte mode).
- * @param level - Error-correction level. Use `'H'` whenever a logo covers the centre.
- * @param version - Force a symbol version 1–40. Omit to pick the smallest that fits.
- * @returns A square `boolean[][]` indexed `[row][column]`, `true` meaning a dark
- * module — or `null` when the payload exceeds capacity, or `version` is out of
- * range or too small. **Never throws**: over-capacity is an ordinary outcome for
- * a user-supplied string, not an exceptional one.
+ * @param level - Error-correction level; use `'H'` whenever a logo covers the centre.
+ * @param version - Force a symbol version 1–40; omit to pick the smallest that fits.
+ * @returns A square `boolean[][]` indexed `[row][column]`, `true` meaning a
+ * dark module — or `null` when the payload exceeds capacity or `version` is
+ * out of range. Never throws.
  */
 export declare function encodeQr(value: string, level: ErrorCorrectionLevel, version?: number): boolean[][] | null;

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

@@ -1,16 +1,7 @@
 /**
- * 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, no DOM/canvas/timers,
+ * runs unchanged under SSR.
  * @module
  */
 /** Error-correction level, in ascending order of redundancy: `L` ≈ 7%, `M` ≈ 15%, `Q` ≈ 25%, `H` ≈ 30%. */
@@ -21,53 +12,35 @@ export declare const MAX_VERSION = 40;
 export declare function moduleCount(version: number): number;
 /** Total codewords (data + EC) a version holds, independent of level. */
 export declare function totalCodewords(version: number): number;
-/**
- * Bits available for the *data* segment (mode indicator, character count,
- * payload, padding) at this version and level — total codewords less every
- * error-correction codeword.
- */
+/** Data segment bits (mode, char count, payload, padding): total codewords minus error-correction. */
 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.
+ * Alignment pattern center coordinates (ISO/IEC 18004 Table E.1), ascending.
+ * Empty at version 1. Spacing is even except first gap (absorbs remainder);
+ * version 32 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))
+ * over GF(256). Monic-implicit: degree coefficients x^(degree-1) to x^0,
+ * 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)): level/mask data XOR-masked
+ * with 0b101010000010010 to prevent all-zero data from producing 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)): version number only. Versions ≥7 only, unmasked. */
 export declare function versionInfoBits(version: number): number;
 /**
  * Encodes `value` as a QR Code matrix.
  *
  * @param value - The payload, encoded as UTF-8 bytes (byte mode).
- * @param level - Error-correction level. Use `'H'` whenever a logo covers the centre.
- * @param version - Force a symbol version 1–40. Omit to pick the smallest that fits.
- * @returns A square `boolean[][]` indexed `[row][column]`, `true` meaning a dark
- * module — or `null` when the payload exceeds capacity, or `version` is out of
- * range or too small. **Never throws**: over-capacity is an ordinary outcome for
- * a user-supplied string, not an exceptional one.
+ * @param level - Error-correction level; use `'H'` whenever a logo covers the centre.
+ * @param version - Force a symbol version 1–40; omit to pick the smallest that fits.
+ * @returns A square `boolean[][]` indexed `[row][column]`, `true` meaning a
+ * dark module — or `null` when the payload exceeds capacity or `version` is
+ * out of range. Never throws.
  */
 export declare function encodeQr(value: string, level: ErrorCorrectionLevel, version?: number): boolean[][] | null;

package/dist/qr-code/index.cjs

@@ -1 +1 @@
-"use strict";var d=Object.defineProperty;var Q=Object.getOwnPropertyDescriptor;var k=Object.getOwnPropertyNames;var S=Object.prototype.hasOwnProperty;var a=(o,r)=>{for(var t in r)d(o,t,{get:r[t],enumerable:!0})},y=(o,r,t,x)=>{if(r&&typeof r=="object"||typeof r=="function")for(let e of k(r))!S.call(o,e)&&e!==t&&d(o,e,{get:()=>r[e],enumerable:!(x=Q(r,e))||x.enumerable});return o};var n=o=>y(d({},"__esModule",{value:!0}),o);var c={};a(c,{SkdxQrCode:()=>p.SkdxQrCode,SkdxQrCodeFrame:()=>m.SkdxQrCodeFrame,SkdxQrCodeOverlay:()=>f.SkdxQrCodeOverlay,SkdxQrCodePattern:()=>C.SkdxQrCodePattern});module.exports=n(c);var p=require("./QrCode.cjs"),m=require("./QrCodeFrame.cjs"),C=require("./QrCodePattern.cjs"),f=require("./QrCodeOverlay.cjs");0&&(module.exports={SkdxQrCode,SkdxQrCodeFrame,SkdxQrCodeOverlay,SkdxQrCodePattern});
+"use strict";var p=Object.defineProperty;var C=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var y=(o,r)=>{for(var t in r)p(o,t,{get:r[t],enumerable:!0})},Q=(o,r,t,d)=>{if(r&&typeof r=="object"||typeof r=="function")for(let e of f(r))!m.call(o,e)&&e!==t&&p(o,e,{get:()=>r[e],enumerable:!(d=C(r,e))||d.enumerable});return o};var c=o=>Q(p({},"__esModule",{value:!0}),o);var i={};y(i,{SkdxQrCode:()=>x.SkdxQrCode});module.exports=c(i);var x=require("./QrCode.cjs");0&&(module.exports={SkdxQrCode});

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

@@ -1,5 +1,2 @@
 export { SkdxQrCode } from './QrCode.cjs';
-export { SkdxQrCodeFrame } from './QrCodeFrame.cjs';
-export { SkdxQrCodePattern } from './QrCodePattern.cjs';
-export { SkdxQrCodeOverlay } from './QrCodeOverlay.cjs';
 export type { QrCodeErrorCorrection } from './types.cjs';

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

@@ -1,5 +1,2 @@
 export { SkdxQrCode } from './QrCode.js';
-export { SkdxQrCodeFrame } from './QrCodeFrame.js';
-export { SkdxQrCodePattern } from './QrCodePattern.js';
-export { SkdxQrCodeOverlay } from './QrCodeOverlay.js';
 export type { QrCodeErrorCorrection } from './types.js';

package/dist/qr-code/index.js

@@ -1 +1 @@
-import{SkdxQrCode as e}from"./QrCode.js";import{SkdxQrCodeFrame as d}from"./QrCodeFrame.js";import{SkdxQrCodePattern as p}from"./QrCodePattern.js";import{SkdxQrCodeOverlay as C}from"./QrCodeOverlay.js";export{e as SkdxQrCode,d as SkdxQrCodeFrame,C as SkdxQrCodeOverlay,p as SkdxQrCodePattern};
+import{SkdxQrCode as e}from"./QrCode.js";export{e as SkdxQrCode};

package/dist/qr-code/primitives.cjs

@@ -0,0 +1 @@
+"use strict";var x=Object.defineProperty;var k=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var C=Object.prototype.hasOwnProperty;var Q=(e,r)=>{for(var d in r)x(e,d,{get:r[d],enumerable:!0})},S=(e,r,d,t)=>{if(r&&typeof r=="object"||typeof r=="function")for(let o of p(r))!C.call(e,o)&&o!==d&&x(e,o,{get:()=>r[o],enumerable:!(t=k(r,o))||t.enumerable});return e};var l=e=>S(x({},"__esModule",{value:!0}),e);var n={};Q(n,{SkdxQrCodeFrame:()=>m.SkdxQrCodeFrame,SkdxQrCodeOverlay:()=>f.SkdxQrCodeOverlay,SkdxQrCodePattern:()=>a.SkdxQrCodePattern});module.exports=l(n);var m=require("./QrCodeFrame.cjs"),a=require("./QrCodePattern.cjs"),f=require("./QrCodeOverlay.cjs");0&&(module.exports={SkdxQrCodeFrame,SkdxQrCodeOverlay,SkdxQrCodePattern});

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

@@ -0,0 +1,20 @@
+/**
+ * Advanced primitives for `<skdx-qr-code>` — the parts the recipe composes.
+ * Reach for these when the derived anatomy is not the structure you need.
+ *
+ * @example
+ * ```ts
+ * import * as QrCode from '@skdx/web-components/primitives/qr-code';
+ * ```
+ * ```html
+ * <skdx-qr-code value="https://example.com" error-correction="H">
+ *   <skdx-qr-code-frame aria-label="Link to example.com">
+ *     <skdx-qr-code-pattern fill="currentColor"></skdx-qr-code-pattern>
+ *     <skdx-qr-code-overlay extent="7"><img src="/logo.svg" alt="" /></skdx-qr-code-overlay>
+ *   </skdx-qr-code-frame>
+ * </skdx-qr-code>
+ * ```
+ */
+export { SkdxQrCodeFrame } from './QrCodeFrame.cjs';
+export { SkdxQrCodePattern } from './QrCodePattern.cjs';
+export { SkdxQrCodeOverlay } from './QrCodeOverlay.cjs';

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

@@ -0,0 +1,20 @@
+/**
+ * Advanced primitives for `<skdx-qr-code>` — the parts the recipe composes.
+ * Reach for these when the derived anatomy is not the structure you need.
+ *
+ * @example
+ * ```ts
+ * import * as QrCode from '@skdx/web-components/primitives/qr-code';
+ * ```
+ * ```html
+ * <skdx-qr-code value="https://example.com" error-correction="H">
+ *   <skdx-qr-code-frame aria-label="Link to example.com">
+ *     <skdx-qr-code-pattern fill="currentColor"></skdx-qr-code-pattern>
+ *     <skdx-qr-code-overlay extent="7"><img src="/logo.svg" alt="" /></skdx-qr-code-overlay>
+ *   </skdx-qr-code-frame>
+ * </skdx-qr-code>
+ * ```
+ */
+export { SkdxQrCodeFrame } from './QrCodeFrame.js';
+export { SkdxQrCodePattern } from './QrCodePattern.js';
+export { SkdxQrCodeOverlay } from './QrCodeOverlay.js';

package/dist/qr-code/primitives.js

@@ -0,0 +1 @@
+import{SkdxQrCodeFrame as o}from"./QrCodeFrame.js";import{SkdxQrCodePattern as x}from"./QrCodePattern.js";import{SkdxQrCodeOverlay as m}from"./QrCodeOverlay.js";export{o as SkdxQrCodeFrame,m as SkdxQrCodeOverlay,x as SkdxQrCodePattern};

package/dist/radio-card/RadioCard.cjs

@@ -1,4 +1,4 @@
-"use strict";var u=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var A=Object.prototype.hasOwnProperty;var L=(r,s)=>{for(var e in s)u(r,e,{get:s[e],enumerable:!0})},w=(r,s,e,i)=>{if(s&&typeof s=="object"||typeof s=="function")for(let t of g(s))!A.call(r,t)&&t!==e&&u(r,t,{get:()=>s[t],enumerable:!(i=f(s,t))||i.enumerable});return r};var D=r=>w(u({},"__esModule",{value:!0}),r),c=(r,s,e,i)=>{for(var t=i>1?void 0:i?f(s,e):s,a=r.length-1,d;a>=0;a--)(d=r[a])&&(t=(i?d(s,e,t):d(t))||t);return i&&t&&u(s,e,t),t};var P={};L(P,{SkdxRadioCard:()=>l});module.exports=D(P);var n=require("lit"),h=require("lit/decorators.js"),m=require("../internal/define.cjs"),E=require("../internal/ids.cjs"),F=require("../radio-group/index.cjs");var T="skdx-radio-card-control",I="skdx-radio-card-indicator",p="skdx-radio-card-label",_="skdx-radio-card-description",l=class extends n.LitElement{constructor(){super(...arguments);this.value="";this.disabled=!1;this._focusVisible=!1;this._viaPointer=!1;this.rootEl=null;this._handleClick=()=>{this.effectiveDisabled||(this.select(),this._control?.focus())};this._handleKeydown=e=>{this.effectiveDisabled||(e.key===" "?(e.preventDefault(),this.select()):e.key==="Enter"&&e.preventDefault())};this._handlePointerDown=()=>{this._viaPointer=!0};this._handleFocusIn=()=>{this._focusVisible=!this._viaPointer,this._viaPointer=!1,this.select(),this._sync()};this._handleFocusOut=()=>{this._focusVisible=!1,this._viaPointer=!1,this._sync()}}connectedCallback(){if(super.connectedCallback(),this.rootEl=this.closest("skdx-radio-group"),!this.rootEl)throw new Error("<skdx-radio-card> must be used inside <skdx-radio-group>.");this.rootEl.registerItem(this,this.value,this.disabled),this.addEventListener("click",this._handleClick),this.addEventListener("keydown",this._handleKeydown),this.addEventListener("pointerdown",this._handlePointerDown),this.addEventListener("focusin",this._handleFocusIn),this.addEventListener("focusout",this._handleFocusOut),this._sync()}disconnectedCallback(){this.rootEl?.unregisterItem(this),this.removeEventListener("click",this._handleClick),this.removeEventListener("keydown",this._handleKeydown),this.removeEventListener("pointerdown",this._handlePointerDown),this.removeEventListener("focusin",this._handleFocusIn),this.removeEventListener("focusout",this._handleFocusOut),super.disconnectedCallback()}updated(){this._sync()}refresh(){this._sync()}get checked(){return this.rootEl?.getSelectedValue()===this.value}get effectiveDisabled(){return(this.rootEl?.disabled??!1)||this.disabled}get _control(){return this.querySelector(T)}select(){this.effectiveDisabled||this.checked||this.rootEl?.setValue(this.value)}syncParts(){this._sync()}_sync(){let e=this.rootEl,i=this.checked,t=this.effectiveDisabled,a=i?"checked":"unchecked";this.setAttribute("data-state",a),this.setAttribute("data-value",this.value),this._toggleAttribute("data-disabled",t),this._toggleAttribute("data-focus-visible",this._focusVisible);let d=e?.getSelectedValue()===void 0&&e?.getFirstEnabledValue()===this.value,y=!t&&(i||d),o=this._control;o&&(o.setAttribute("aria-checked",String(i)),o.setAttribute("data-state",a),o.setAttribute("data-value",this.value),o.setAttribute("tabindex",y?"0":"-1"),t?(o.setAttribute("data-disabled",""),o.setAttribute("aria-disabled","true")):(o.removeAttribute("data-disabled"),o.removeAttribute("aria-disabled")),this._link(o,"aria-labelledby",p,"label"),this._link(o,"aria-describedby",_,"description"));let b=this.querySelector(I);b?.setAttribute("data-state",a);let k=[b,this.querySelector(p),this.querySelector(_)];for(let v of k)v&&(t?v.setAttribute("data-disabled",""):v.removeAttribute("data-disabled"))}_toggleAttribute(e,i){i?this.setAttribute(e,""):this.removeAttribute(e)}_link(e,i,t,a){let d=this.querySelector(t);d?e.setAttribute(i,(0,E.ensureId)(d,"skdx-radio-card",a)):e.removeAttribute(i)}render(){return n.html`<slot></slot>`}};l.styles=n.css`
+"use strict";var u=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var D=Object.prototype.hasOwnProperty;var w=(r,s)=>{for(var e in s)u(r,e,{get:s[e],enumerable:!0})},M=(r,s,e,i)=>{if(s&&typeof s=="object"||typeof s=="function")for(let t of T(s))!D.call(r,t)&&t!==e&&u(r,t,{get:()=>s[t],enumerable:!(i=p(s,t))||i.enumerable});return r};var I=r=>M(u({},"__esModule",{value:!0}),r),d=(r,s,e,i)=>{for(var t=i>1?void 0:i?p(s,e):s,l=r.length-1,n;l>=0;l--)(n=r[l])&&(t=(i?n(s,e,t):n(t))||t);return i&&t&&u(s,e,t),t};var F={};w(F,{SkdxRadioCard:()=>a});module.exports=I(F);var h=require("lit"),c=require("lit/decorators.js"),_=require("../internal/authored.cjs"),E=require("../internal/card-nesting.cjs"),g=require("../internal/define.cjs"),A=require("../internal/ids.cjs"),S=require("../radio-group/index.cjs"),v=require("./RadioCardAnatomy.cjs");var O="skdx-radio-card-control",P="skdx-radio-card-indicator",m="skdx-radio-card-label",y="skdx-radio-card-description",a=class extends h.LitElement{constructor(){super(...arguments);this.value="";this.disabled=!1;this._focusVisible=!1;this._viaPointer=!1;this.rootEl=null;this.fillAnatomy=()=>{(0,_.hasAuthoredParts)(this,v.RADIO_CARD_ANATOMY_GENERATED)||((0,v.fillRadioCardAnatomy)(this),this._sync())};this._handleClick=()=>{this.effectiveDisabled||(this.select("pointer"),this._control?.focus())};this._handleKeydown=e=>{this.effectiveDisabled||(e.key===" "?(e.preventDefault(),this.select("keyboard")):e.key==="Enter"&&e.preventDefault())};this._handlePointerDown=()=>{this._viaPointer=!0};this._handleFocusIn=e=>{this._focusVisible=!this._viaPointer,this._viaPointer=!1;let i=e.relatedTarget;i?.getAttribute("role")==="radio"&&i.closest('[role="radiogroup"]')===this.closest('[role="radiogroup"]')&&this.select("keyboard"),this._sync()};this._handleFocusOut=()=>{this._focusVisible=!1,this._viaPointer=!1,this._sync()}}connectedCallback(){if(super.connectedCallback(),this.rootEl=this.closest("skdx-radio-group"),!this.rootEl)throw new Error("<skdx-radio-card> must be used inside <skdx-radio-group>.");this.rootEl.registerItem(this,this.value,this.disabled),this.addEventListener("click",this._handleClick),this.addEventListener("keydown",this._handleKeydown),this.addEventListener("pointerdown",this._handlePointerDown),this.addEventListener("focusin",this._handleFocusIn),this.addEventListener("focusout",this._handleFocusOut),this._sync(),queueMicrotask(()=>{(0,E.warnOnNestedInteractive)("RadioCard",this),this.fillAnatomy()})}disconnectedCallback(){this.rootEl?.unregisterItem(this),this.removeEventListener("click",this._handleClick),this.removeEventListener("keydown",this._handleKeydown),this.removeEventListener("pointerdown",this._handlePointerDown),this.removeEventListener("focusin",this._handleFocusIn),this.removeEventListener("focusout",this._handleFocusOut),super.disconnectedCallback()}updated(e){(e.has("label")||e.has("description"))&&this.fillAnatomy(),this._sync()}refresh(){this._sync()}get checked(){return this.rootEl?.getSelectedValue()===this.value}get effectiveDisabled(){return(this.rootEl?.disabled??!1)||this.disabled}get _control(){return this.querySelector(O)}select(e){this.effectiveDisabled||this.checked||(this.rootEl?.readOnly??!1)||this.rootEl?.setValue(this.value,e)}syncParts(){this._sync()}_sync(){let e=this.rootEl,i=this.checked,t=this.effectiveDisabled,l=i?"checked":"unchecked";this.setAttribute("data-state",l),this.setAttribute("data-value",this.value),this._toggleAttribute("data-disabled",t),this._toggleAttribute("data-focus-visible",this._focusVisible);let n=e?.getSelectedValue()==null&&e?.getFirstEnabledValue()===this.value,k=!t&&(i||n),o=this._control;o&&(o.setAttribute("aria-checked",String(i)),o.setAttribute("data-state",l),o.setAttribute("data-value",this.value),o.setAttribute("tabindex",k?"0":"-1"),t?(o.setAttribute("data-disabled",""),o.setAttribute("aria-disabled","true")):(o.removeAttribute("data-disabled"),o.removeAttribute("aria-disabled")),this._link(o,"aria-labelledby",m,"label"),this._link(o,"aria-describedby",y,"description"));let f=this.querySelector(P);f?.setAttribute("data-state",l);let L=[f,this.querySelector(m),this.querySelector(y)];for(let b of L)b&&(t?b.setAttribute("data-disabled",""):b.removeAttribute("data-disabled"))}_toggleAttribute(e,i){i?this.setAttribute(e,""):this.removeAttribute(e)}_link(e,i,t,l){let n=this.querySelector(t);n?e.setAttribute(i,(0,A.ensureId)(n,"skdx-radio-card",l)):e.removeAttribute(i)}render(){return h.html`<slot @slotchange=${this.fillAnatomy}></slot>`}};a.styles=h.css`
     :host {
       display: block;
       position: relative;
@@ -10,4 +10,4 @@
     :host([hidden]) {
       display: none;
     }
-  `,c([(0,h.property)({type:String,reflect:!0})],l.prototype,"value",2),c([(0,h.property)({type:Boolean,reflect:!0})],l.prototype,"disabled",2),c([(0,h.state)()],l.prototype,"_focusVisible",2),l=c([(0,m.customElement)("skdx-radio-card","radio-card","root")],l);0&&(module.exports={SkdxRadioCard});
+  `,d([(0,c.property)({type:String,reflect:!0})],a.prototype,"value",2),d([(0,c.property)({type:Boolean,reflect:!0})],a.prototype,"disabled",2),d([(0,c.property)({type:String})],a.prototype,"label",2),d([(0,c.property)({type:String})],a.prototype,"description",2),d([(0,c.state)()],a.prototype,"_focusVisible",2),a=d([(0,g.customElement)("skdx-radio-card","radio-card","root")],a);0&&(module.exports={SkdxRadioCard});

package/dist/radio-card/RadioCard.d.cts

@@ -1,38 +1,14 @@
 import { LitElement } from 'lit';
+import type { RadioGroupChangeReason } from '../radio-group/RadioGroup.cjs';
 import '../radio-group/index.cjs';
 /**
- * `<skdx-radio-card>` — the Web Components implementation of the shared RadioCard
- * contract (see `@skdx/shared`'s `radioCardContract`). One card in a
- * single-select group: the root behaves as a `<label>`, so a click anywhere on
- * the card surface selects it and moves focus to its control.
- *
- * Selection state is **not** re-implemented here. The card finds the enclosing
- * `<skdx-radio-group>` with `closest('skdx-radio-group')`, registers with it, and
- * reads the selected value, group-level `disabled` and the roving tab stop back
- * out — so a `<skdx-radio-card>` and a plain `<skdx-radio-group-item>` are
- * interchangeable inside the same group and answer to the same
- * `value`/`value-change`. Arrow-key navigation, form submission and validation
- * all belong to the group, which is why this element has no `checked-change`
- * event and no `name`/`required` of its own. Used outside a group it throws.
- *
- * Emits `data-state="checked" | "unchecked"`, `data-disabled`,
- * `data-focus-visible` and `data-value` on the host, which is the whole styling
- * contract.
- *
- * **Nothing interactive may be nested inside the card.** The root behaves as a
- * `<label>`, so a link or button in there is both an HTML content-model
- * violation and a real usability bug — clicking the inner control would also
- * select the card. Put actions beside the card, never inside it.
+ * Single-select radio card. Root behaves as `<label>`; click selects and focuses control.
+ * Registers with enclosing `<skdx-radio-group>` for state management. No nesting of interactive elements.
  *
  * @example
  * ```html
  * <skdx-radio-group name="plan" default-value="pro" aria-label="Plan">
- *   <skdx-radio-card value="pro">
- *     <skdx-radio-card-control></skdx-radio-card-control>
- *     <skdx-radio-card-indicator></skdx-radio-card-indicator>
- *     <skdx-radio-card-label>Pro</skdx-radio-card-label>
- *     <skdx-radio-card-description>$20 per seat, per month.</skdx-radio-card-description>
- *   </skdx-radio-card>
+ *   <skdx-radio-card value="pro" label="Pro" description="$20 per seat"></skdx-radio-card>
  * </skdx-radio-group>
  * ```
  */
@@ -49,12 +25,25 @@ export declare class SkdxRadioCard extends LitElement {
      * @default false — the card follows the group.
      */
     disabled: boolean;
+    /**
+     * The card's visible label, rendered into a derived `<skdx-radio-card-label>`
+     * that names the control.
+     * @default undefined — an unnamed card; name it with `aria-label` on the control instead.
+     */
+    label?: string;
+    /**
+     * Supporting text below the label, rendered into a derived
+     * `<skdx-radio-card-description>`.
+     * @default undefined — no description is derived.
+     */
+    description?: string;
     private _focusVisible;
     private _viaPointer;
     private rootEl;
     connectedCallback(): void;
+    private readonly fillAnatomy;
     disconnectedCallback(): void;
-    protected updated(): void;
+    protected updated(changed: Map<string, unknown>): void;
     /** @internal Called by the enclosing `<skdx-radio-group>` whenever the selected value changes. */
     refresh(): void;
     /** Whether this card is currently the group's selected value. */
@@ -62,16 +51,11 @@ export declare class SkdxRadioCard extends LitElement {
     /** This card's own `disabled`, or the whole group's — either one disables it. */
     get effectiveDisabled(): boolean;
     private get _control();
+    /** Selects this card through the group. A no-op while disabled or already selected, so re-picking emits nothing. */
+    select(reason: RadioGroupChangeReason): void;
     /**
-     * Selects this card through the group. A no-op while disabled or already
-     * selected — re-picking the selected card emits nothing, matching how
-     * `<skdx-radio-group-item>` and React's `RadioCard` both stay silent.
-     */
-    select(): void;
-    /**
-     * @internal Pushes the card's resolved state onto the host and every part.
-     * Called by each part on connect (parts upgrade after the root) and by the
-     * root on every state change.
+     * @internal Pushes the card's resolved state onto the host and every
+     * part. Called by each part on connect, and by the root on every change.
      */
     syncParts(): void;
     private _sync;