@skdx/react 0.26.0

package/dist/progress/ProgressIndicator.d.cts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+import type { ProgressIndicatorProps } from './types.cjs';
+/**
+ * The visual fill of a `Progress` bar. Mirrors the root's `data-state` /
+ * `data-value` / `data-max` and sets a `--skdx-progress` CSS custom property
+ * (a percentage) so width/transform can be driven purely from CSS. Must be
+ * used inside a `Progress`.
+ *
+ * @example
+ * ```tsx
+ * <Progress value={66}>
+ *   <ProgressIndicator />
+ * </Progress>
+ * ```
+ */
+export declare const ProgressIndicator: React.ForwardRefExoticComponent<Omit<ProgressIndicatorProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/progress/ProgressIndicator.d.ts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+import type { ProgressIndicatorProps } from './types.js';
+/**
+ * The visual fill of a `Progress` bar. Mirrors the root's `data-state` /
+ * `data-value` / `data-max` and sets a `--skdx-progress` CSS custom property
+ * (a percentage) so width/transform can be driven purely from CSS. Must be
+ * used inside a `Progress`.
+ *
+ * @example
+ * ```tsx
+ * <Progress value={66}>
+ *   <ProgressIndicator />
+ * </Progress>
+ * ```
+ */
+export declare const ProgressIndicator: React.ForwardRefExoticComponent<Omit<ProgressIndicatorProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/progress/index.d.cts

@@ -0,0 +1,5 @@
+export * from './Progress.cjs';
+export { ProgressIndicator } from './ProgressIndicator.cjs';
+export { ProgressCircle } from './ProgressCircle.cjs';
+export { ProgressCircleIndicator } from './ProgressCircleIndicator.cjs';
+export type { ProgressProps, ProgressIndicatorProps, ProgressCircleProps, ProgressCircleIndicatorProps, } from './types.cjs';

package/dist/progress/index.d.ts

@@ -0,0 +1,5 @@
+export * from './Progress.js';
+export { ProgressIndicator } from './ProgressIndicator.js';
+export { ProgressCircle } from './ProgressCircle.js';
+export { ProgressCircleIndicator } from './ProgressCircleIndicator.js';
+export type { ProgressProps, ProgressIndicatorProps, ProgressCircleProps, ProgressCircleIndicatorProps, } from './types.js';

package/dist/progress/types.d.cts

@@ -0,0 +1,54 @@
+import type { PrimitivePropsWithRef } from '../utils/primitive.cjs';
+/** @internal Shared value/max distributed from {@link Progress} to {@link ProgressIndicator} via context. Not part of the public API. */
+export interface ProgressContextValue {
+    value: number | null;
+    max: number;
+}
+/** Props for the {@link Progress} root. */
+export interface ProgressProps extends PrimitivePropsWithRef<'div'> {
+    /**
+     * Current value. `null` renders an indeterminate progress bar.
+     * @default null
+     */
+    value?: number | null;
+    /**
+     * Maximum value that `value` is measured against.
+     * @default 100
+     */
+    max?: number;
+    /**
+     * Formats the `aria-valuetext`. Defaults to a percentage.
+     * @default undefined — falls back to a rounded percentage of value/max.
+     */
+    getValueLabel?: (value: number, max: number) => string;
+}
+/** Props for {@link ProgressIndicator}, the fill/bar element inside `Progress`. */
+export interface ProgressIndicatorProps extends PrimitivePropsWithRef<'div'> {
+}
+/** @internal Ring geometry distributed from {@link ProgressCircle} to {@link ProgressCircleIndicator} via context. Not part of the public API. */
+export interface ProgressCircleContextValue {
+    size: number;
+    thickness: number;
+    radius: number;
+    circumference: number;
+}
+/** Props for {@link ProgressCircle}, the circular geometry host inside `Progress`. */
+export interface ProgressCircleProps extends PrimitivePropsWithRef<'div'> {
+    /**
+     * Outer diameter of the ring, in unitless SVG user units — the number you
+     * also put in your own `viewBox="0 0 size size"`. Unitless rather than a CSS
+     * length because it feeds `stroke-dasharray`/`stroke-dashoffset`, which are
+     * path lengths, not lengths CSS can convert.
+     * @default 48 — a ring that reads at body-text scale, so the default renders visibly with no config.
+     */
+    size?: number;
+    /**
+     * Stroke width of the ring, in the same unitless units as `size`. Insets the
+     * radius by half its value so the stroke stays inside the `size` box.
+     * @default 4 — about a twelfth of the default `size`, thick enough to see and thin enough not to close the hole.
+     */
+    thickness?: number;
+}
+/** Props for {@link ProgressCircleIndicator}, the swept arc inside `ProgressCircle`. */
+export interface ProgressCircleIndicatorProps extends PrimitivePropsWithRef<'div'> {
+}

package/dist/progress/types.d.ts

@@ -0,0 +1,54 @@
+import type { PrimitivePropsWithRef } from '../utils/primitive.js';
+/** @internal Shared value/max distributed from {@link Progress} to {@link ProgressIndicator} via context. Not part of the public API. */
+export interface ProgressContextValue {
+    value: number | null;
+    max: number;
+}
+/** Props for the {@link Progress} root. */
+export interface ProgressProps extends PrimitivePropsWithRef<'div'> {
+    /**
+     * Current value. `null` renders an indeterminate progress bar.
+     * @default null
+     */
+    value?: number | null;
+    /**
+     * Maximum value that `value` is measured against.
+     * @default 100
+     */
+    max?: number;
+    /**
+     * Formats the `aria-valuetext`. Defaults to a percentage.
+     * @default undefined — falls back to a rounded percentage of value/max.
+     */
+    getValueLabel?: (value: number, max: number) => string;
+}
+/** Props for {@link ProgressIndicator}, the fill/bar element inside `Progress`. */
+export interface ProgressIndicatorProps extends PrimitivePropsWithRef<'div'> {
+}
+/** @internal Ring geometry distributed from {@link ProgressCircle} to {@link ProgressCircleIndicator} via context. Not part of the public API. */
+export interface ProgressCircleContextValue {
+    size: number;
+    thickness: number;
+    radius: number;
+    circumference: number;
+}
+/** Props for {@link ProgressCircle}, the circular geometry host inside `Progress`. */
+export interface ProgressCircleProps extends PrimitivePropsWithRef<'div'> {
+    /**
+     * Outer diameter of the ring, in unitless SVG user units — the number you
+     * also put in your own `viewBox="0 0 size size"`. Unitless rather than a CSS
+     * length because it feeds `stroke-dasharray`/`stroke-dashoffset`, which are
+     * path lengths, not lengths CSS can convert.
+     * @default 48 — a ring that reads at body-text scale, so the default renders visibly with no config.
+     */
+    size?: number;
+    /**
+     * Stroke width of the ring, in the same unitless units as `size`. Insets the
+     * radius by half its value so the stroke stays inside the `size` box.
+     * @default 4 — about a twelfth of the default `size`, thick enough to see and thin enough not to close the hole.
+     */
+    thickness?: number;
+}
+/** Props for {@link ProgressCircleIndicator}, the swept arc inside `ProgressCircle`. */
+export interface ProgressCircleIndicatorProps extends PrimitivePropsWithRef<'div'> {
+}

package/dist/qr-code/QrCode.cjs

@@ -0,0 +1 @@
+"use strict";var le=Object.create;var E=Object.defineProperty;var fe=Object.getOwnPropertyDescriptor;var ue=Object.getOwnPropertyNames;var me=Object.getPrototypeOf,de=Object.prototype.hasOwnProperty;var be=(e,r)=>{for(var t in r)E(e,t,{get:r[t],enumerable:!0})},O=(e,r,t,n)=>{if(r&&typeof r=="object"||typeof r=="function")for(let o of ue(r))!de.call(e,o)&&o!==t&&E(e,o,{get:()=>r[o],enumerable:!(n=fe(r,o))||n.enumerable});return e};var M=(e,r,t)=>(t=e!=null?le(me(e)):{},O(r||!e||!e.__esModule?E(t,"default",{value:e,enumerable:!0}):t,e)),pe=e=>O(E({},"__esModule",{value:!0}),e);var Ve={};be(Ve,{QrCode:()=>U,QrCodeFrame:()=>_,QrCodeOverlay:()=>B,QrCodePattern:()=>V});module.exports=pe(Ve);var x=M(require("react"),1),K=require("../utils/createContext.cjs"),X=require("../utils/part.cjs"),J=require("../utils/primitive.cjs"),Z=require("../utils/useCallbackRef.cjs"),j=require("../utils/visuallyHidden.cjs");var Ce={L:1,M:0,Q:3,H:2},v={L:0,M:1,Q:2,H:3},g=[[-1,7,10,15,20,26,18,20,24,30,18,20,24,26,30,22,24,28,30,28,28,28,28,30,30,26,28,30,30,30,30,30,30,30,30,30,30,30,30,30,30],[-1,10,16,26,18,24,16,18,22,22,26,30,22,22,24,24,28,28,26,26,26,26,28,28,28,28,28,28,28,28,28,28,28,28,28,28,28,28,28,28,28],[-1,13,22,18,26,18,24,18,22,20,24,28,26,24,20,30,24,28,28,26,30,28,30,30,30,30,28,30,30,30,30,30,30,30,30,30,30,30,30,30,30],[-1,17,28,22,16,22,28,26,26,24,28,24,28,22,24,24,30,28,28,26,28,30,24,30,30,30,30,30,30,30,30,30,30,30,30,30,30,30,30,30,30]],$=[[-1,1,1,1,1,1,2,2,2,2,4,4,4,4,4,6,6,6,6,7,8,8,9,9,10,12,12,12,13,14,15,16,17,18,19,19,20,21,22,24,25],[-1,1,1,1,2,2,4,4,4,5,5,5,8,9,9,10,10,11,13,14,16,17,17,18,20,21,23,25,26,28,29,31,33,35,37,38,40,43,45,47,49],[-1,1,1,2,2,4,4,6,6,8,8,8,10,12,16,12,17,16,18,21,20,23,23,25,27,29,34,34,35,38,40,43,45,48,51,53,56,59,62,65,68],[-1,1,1,2,4,4,4,5,6,8,8,11,11,16,16,18,16,19,21,25,25,25,34,30,32,35,37,40,42,45,48,51,54,57,60,63,66,70,74,77,81]],q=1,I=40,ye=3,he=3,xe=40,Pe=10;function D(e){return e*4+17}function Qe(e){let r=(16*e+128)*e+64;if(e>=2){let t=Math.floor(e/7)+2;r-=(25*t-10)*t-55,e>=7&&(r-=36)}return r}function T(e){return Math.floor(Qe(e)/8)}function z(e,r){let t=v[r],n=g[t][e]*$[t][e];return(T(e)-n)*8}function we(e){if(e===1)return[];let r=Math.floor(e/7)+2,t=e===32?26:Math.ceil((e*4+4)/(r*2-2))*2,n=[6];for(let o=D(e)-7;n.length<r;o-=t)n.splice(1,0,o);return n}var L=new Uint8Array(512),S=new Uint8Array(256);{let e=1;for(let r=0;r<255;r++)L[r]=e,S[e]=r,e<<=1,e&256&&(e^=285);for(let r=255;r<512;r++)L[r]=L[r-255]}function N(e,r){return e===0||r===0?0:L[S[e]+S[r]]}function Ee(e){let r=new Uint8Array(e);r[e-1]=1;let t=1;for(let n=0;n<e;n++){for(let o=0;o<e;o++){let a=N(r[o]??0,t);r[o]=o+1<e?a^(r[o+1]??0):a}t=N(t,2)}return r}function Me(e,r){let t=new Uint8Array(r.length);for(let n of e){let o=n^(t[0]??0);t.copyWithin(0,1),t[t.length-1]=0;for(let a=0;a<t.length;a++)t[a]=(t[a]??0)^N(r[a]??0,o)}return t}function H(e,r,t){let n=e;for(let o=0;o<t;o++)n=n<<1^(n>>>t-1)*r;return n}function Le(e,r){let t=Ce[e]<<3|r;return((t<<10|H(t,1335,10))^21522)&32767}function Re(e){return(e<<12|H(e,7973,12))&262143}function F(e){return e<=9?8:16}function h(e,r,t){for(let n=t-1;n>=0;n--)e.push(r>>>n&1)}function Ae(e,r,t){let n=z(r,t),o=[];h(o,4,4),h(o,e.length,F(r));for(let s of e)h(o,s,8);h(o,0,Math.min(4,n-o.length)),h(o,0,(8-o.length%8)%8);for(let s=236;o.length<n;s^=253)h(o,s,8);let a=new Uint8Array(o.length/8);for(let s=0;s<o.length;s++){let i=s>>>3;a[i]=(a[i]??0)|o[s]<<7-(s&7)}return a}function ke(e,r,t){let n=v[t],o=$[n][r],a=g[n][r],s=T(r),i=o-s%o,c=Math.floor(s/o)-a,l=Ee(a),p=[];for(let f=0,b=0;f<o;f++){let y=c+(f<i?0:1),Q=e.subarray(b,b+y);b+=y,p.push({data:Q,ecc:Me(Q,l)})}let d=new Uint8Array(s),u=0;for(let f=0;f<=c;f++)for(let b of p)f<b.data.length&&(d[u++]=b.data[f]);for(let f=0;f<a;f++)for(let b of p)d[u++]=b.ecc[f];return d}var W=[(e,r)=>(e+r)%2===0,(e,r)=>r%2===0,e=>e%3===0,(e,r)=>(e+r)%3===0,(e,r)=>(Math.floor(r/2)+Math.floor(e/3))%2===0,(e,r)=>e*r%2+e*r%3===0,(e,r)=>(e*r%2+e*r%3)%2===0,(e,r)=>((e+r)%2+e*r%3)%2===0];function Se(e){let r=D(e),t=()=>Array.from({length:r},()=>new Array(r).fill(!1));return{size:r,modules:t(),isFunction:t()}}function m(e,r,t,n){e.modules[t][r]=n,e.isFunction[t][r]=!0}var C=(e,r)=>(e>>>r&1)!==0;function A(e,r,t){for(let n=-4;n<=4;n++)for(let o=-4;o<=4;o++){let a=r+o,s=t+n;if(a<0||a>=e.size||s<0||s>=e.size)continue;let i=Math.max(Math.abs(o),Math.abs(n));m(e,a,s,i!==2&&i!==4)}}function Ne(e,r,t){for(let n=-2;n<=2;n++)for(let o=-2;o<=2;o++)m(e,r+o,t+n,Math.max(Math.abs(o),Math.abs(n))!==1)}function G(e,r,t){let n=Le(r,t),{size:o}=e;for(let a=0;a<=5;a++)m(e,8,a,C(n,a));m(e,8,7,C(n,6)),m(e,8,8,C(n,7)),m(e,7,8,C(n,8));for(let a=9;a<15;a++)m(e,14-a,8,C(n,a));for(let a=0;a<8;a++)m(e,o-1-a,8,C(n,a));for(let a=8;a<15;a++)m(e,8,o-15+a,C(n,a));m(e,8,o-8,!0)}function Ge(e,r){if(r<7)return;let t=Re(r);for(let n=0;n<18;n++){let o=C(t,n),a=e.size-11+n%3,s=Math.floor(n/3);m(e,a,s,o),m(e,s,a,o)}}function ze(e,r,t){let{size:n}=e;for(let s=0;s<n;s++)m(e,6,s,s%2===0),m(e,s,6,s%2===0);A(e,3,3),A(e,n-4,3),A(e,3,n-4);let o=we(r),a=o.length-1;for(let s=0;s<=a;s++)for(let i=0;i<=a;i++)s===0&&i===0||s===0&&i===a||s===a&&i===0||Ne(e,o[s],o[i]);G(e,t,0),Ge(e,r)}function Fe(e,r){let{size:t}=e,n=0;for(let o=t-1;o>=1;o-=2){o===6&&(o=5);for(let a=0;a<t;a++)for(let s=0;s<2;s++){let i=o-s,l=(o+1&2)===0?t-1-a:a;e.isFunction[l][i]||n>=r.length*8||(e.modules[l][i]=C(r[n>>>3],7-(n&7)),n++)}}}function k(e,r){let t=W[r];for(let n=0;n<e.size;n++)for(let o=0;o<e.size;o++)!e.isFunction[n][o]&&t(o,n)&&(e.modules[n][o]=!e.modules[n][o])}function Ue(e){let{size:r,modules:t}=e,n=0;for(let i of[!0,!1])for(let c=0;c<r;c++){let l=u=>i?t[c][u]:t[u][c],p=l(0),d=1;for(let u=1;u<r;u++)l(u)===p?(d++,d===5?n+=ye:d>5&&(n+=1)):(p=l(u),d=1);for(let u=0;u+10<r;u++){let f=0,b=0;for(let y=0;y<11;y++){let Q=l(u+y)?1:0;f=f<<1|Q,b|=Q<<y}(f===1488||b===1488)&&(n+=xe)}}for(let i=0;i+1<r;i++)for(let c=0;c+1<r;c++){let l=t[i][c];l===t[i][c+1]&&l===t[i+1][c]&&l===t[i+1][c+1]&&(n+=he)}let o=0;for(let i of t)for(let c of i)c&&o++;let a=r*r,s=Math.floor(Math.abs(o*2-a)*10/a);return n+s*Pe}function _e(e,r){for(let t=q;t<=I;t++)if(4+F(t)+e*8<=z(t,r))return t;return null}function Y(e,r,t){let n=new TextEncoder().encode(e),o;if(t===void 0?o=_e(n.length,r):!Number.isInteger(t)||t<q||t>I?o=null:o=4+F(t)+n.length*8<=z(t,r)?t:null,o===null)return null;let a=Se(o);ze(a,o,r),Fe(a,ke(Ae(n,o,r),o,r));let s=0,i=1/0;for(let c=0;c<W.length;c++){k(a,c),G(a,r,c);let l=Ue(a);l<i&&(i=l,s=c),k(a,c)}return k(a,s),G(a,r,s),a.modules}var w=require("react/jsx-runtime"),[Be,P]=(0,K.createSafeContext)("QrCode"),U=x.forwardRef(({value:e,errorCorrection:r="M",version:t,encoding:n="byte",onEncodeError:o,hiddenLabel:a=!0,children:s,...i},c)=>{let l=x.useMemo(()=>Y(e,r,t),[e,r,t]),p=(0,Z.useCallbackRef)(o);if(x.useEffect(()=>{l===null&&p(new Error(`[skandadx] QrCode cannot encode a ${e.length}-character value at error correction "${r}"`+(t===void 0?" within version 40.":` at version ${t}.`)))},[l,e,r,t,p]),l===null)return null;let d=l.length;return(0,w.jsx)(Be,{matrix:l,size:d,value:e,children:(0,w.jsxs)(J.Primitive.div,{"data-skdx-qr-code":"",...i,...(0,X.skdxPart)("qr-code","root",i.className),ref:c,style:{"--skdx-qr-code-size":d,...i.style},children:[s,a?(0,w.jsx)(j.VisuallyHidden,{children:e}):null]})})});U.displayName="QrCode";var ee=M(require("react"),1),re=require("../utils/part.cjs"),te=require("../utils/primitive.cjs");var oe=require("react/jsx-runtime"),_=ee.forwardRef((e,r)=>{let{size:t}=P("QrCodeFrame"),n=e["aria-label"]!==void 0||e["aria-labelledby"]!==void 0;return(0,oe.jsx)(te.Primitive.svg,{xmlns:"http://www.w3.org/2000/svg",viewBox:`0 0 ${t} ${t}`,shapeRendering:"crispEdges",role:n?"img":void 0,"aria-hidden":n?void 0:!0,"data-skdx-qr-code-frame":"",...e,...(0,re.skdxPart)("qr-code","frame",e.className),ref:r})});_.displayName="QrCodeFrame";var ne=M(require("react"),1),ae=require("../utils/part.cjs");var se=require("react/jsx-runtime"),B=ne.forwardRef(({size:e=7,...r},t)=>{let{size:n}=P("QrCodeOverlay"),o=(n-e)/2;return(0,se.jsx)("g",{transform:`translate(${o} ${o})`,"data-skdx-qr-code-overlay":"",...r,...(0,ae.skdxPart)("qr-code","overlay",r.className),ref:t})});B.displayName="QrCodeOverlay";var R=M(require("react"),1),ie=require("../utils/part.cjs");var ce=require("react/jsx-runtime"),V=R.forwardRef((e,r)=>{let{matrix:t}=P("QrCodePattern"),n=R.useMemo(()=>{let o="";for(let a=0;a<t.length;a++){let s=t[a];for(let i=0;i<s.length;i++)s[i]&&(o+=`M${i} ${a}h1v1h-1z`)}return o},[t]);return(0,ce.jsx)("path",{d:n,"data-skdx-qr-code-pattern":"",...e,...(0,ie.skdxPart)("qr-code","pattern",e.className),ref:r})});V.displayName="QrCodePattern";0&&(module.exports={QrCode,QrCodeFrame,QrCodeOverlay,QrCodePattern});

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

@@ -0,0 +1,41 @@
+import * as React from 'react';
+import type { QrCodeContextValue, QrCodeProps } from './types.cjs';
+export declare const QrCodeProvider: {
+    (props: QrCodeContextValue & {
+        children: React.ReactNode;
+    }): React.JSX.Element;
+    displayName: string;
+}, useQrCodeContext: (consumerName: string) => QrCodeContextValue;
+/**
+ * Root of a QR code: encodes `value` once and hands the resulting module
+ * matrix to `QrCodeFrame` / `QrCodePattern` / `QrCodeOverlay` via context.
+ * Renders a `Primitive.div` carrying `--skdx-qr-code-size` — the module count,
+ * e.g. `29` — as an inline custom property, so a consumer can size the symbol
+ * from CSS (`width: calc(var(--skdx-qr-code-size) * 4px)`) without reading the
+ * version back out in JavaScript.
+ *
+ * **The encode is memoized on `value` + `errorCorrection` + `version`.** A QR
+ * encode is ~8 full passes over up to 177² modules for mask selection; doing it
+ * on every render is the bug this component ships with everywhere.
+ *
+ * By default the root also renders `value` as visually hidden text: a QR code
+ * is a dead end for anyone without a camera, and the payload is usually a URL
+ * they would otherwise never reach. See {@link QrCodeProps.hiddenLabel}.
+ *
+ * When `value` will not fit — over capacity, or a pinned `version` too small —
+ * `onEncodeError` fires and the root renders **nothing**. A partial or clipped
+ * symbol would scan to the wrong destination, which is worse than no symbol.
+ *
+ * @example
+ * ```tsx
+ * <QrCode value="https://example.com" errorCorrection="H">
+ *   <QrCodeFrame aria-label="Link to example.com">
+ *     <QrCodePattern fill="currentColor" />
+ *     <QrCodeOverlay size={7}>
+ *       <image href={logo} width={7} height={7} />
+ *     </QrCodeOverlay>
+ *   </QrCodeFrame>
+ * </QrCode>
+ * ```
+ */
+export declare const QrCode: React.ForwardRefExoticComponent<Omit<QrCodeProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

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

@@ -0,0 +1,41 @@
+import * as React from 'react';
+import type { QrCodeContextValue, QrCodeProps } from './types.js';
+export declare const QrCodeProvider: {
+    (props: QrCodeContextValue & {
+        children: React.ReactNode;
+    }): React.JSX.Element;
+    displayName: string;
+}, useQrCodeContext: (consumerName: string) => QrCodeContextValue;
+/**
+ * Root of a QR code: encodes `value` once and hands the resulting module
+ * matrix to `QrCodeFrame` / `QrCodePattern` / `QrCodeOverlay` via context.
+ * Renders a `Primitive.div` carrying `--skdx-qr-code-size` — the module count,
+ * e.g. `29` — as an inline custom property, so a consumer can size the symbol
+ * from CSS (`width: calc(var(--skdx-qr-code-size) * 4px)`) without reading the
+ * version back out in JavaScript.
+ *
+ * **The encode is memoized on `value` + `errorCorrection` + `version`.** A QR
+ * encode is ~8 full passes over up to 177² modules for mask selection; doing it
+ * on every render is the bug this component ships with everywhere.
+ *
+ * By default the root also renders `value` as visually hidden text: a QR code
+ * is a dead end for anyone without a camera, and the payload is usually a URL
+ * they would otherwise never reach. See {@link QrCodeProps.hiddenLabel}.
+ *
+ * When `value` will not fit — over capacity, or a pinned `version` too small —
+ * `onEncodeError` fires and the root renders **nothing**. A partial or clipped
+ * symbol would scan to the wrong destination, which is worse than no symbol.
+ *
+ * @example
+ * ```tsx
+ * <QrCode value="https://example.com" errorCorrection="H">
+ *   <QrCodeFrame aria-label="Link to example.com">
+ *     <QrCodePattern fill="currentColor" />
+ *     <QrCodeOverlay size={7}>
+ *       <image href={logo} width={7} height={7} />
+ *     </QrCodeOverlay>
+ *   </QrCodeFrame>
+ * </QrCode>
+ * ```
+ */
+export declare const QrCode: React.ForwardRefExoticComponent<Omit<QrCodeProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/qr-code/QrCode.js

@@ -0,0 +1 @@
+import*as x from"react";import{createSafeContext as be}from"../utils/createContext.js";import{skdxPart as pe}from"../utils/part.js";import{Primitive as Ce}from"../utils/primitive.js";import{useCallbackRef as ye}from"../utils/useCallbackRef.js";import{VisuallyHidden as he}from"../utils/visuallyHidden.js";var Y={L:1,M:0,Q:3,H:2},G={L:0,M:1,Q:2,H:3},z=[[-1,7,10,15,20,26,18,20,24,30,18,20,24,26,30,22,24,28,30,28,28,28,28,30,30,26,28,30,30,30,30,30,30,30,30,30,30,30,30,30,30],[-1,10,16,26,18,24,16,18,22,22,26,30,22,22,24,24,28,28,26,26,26,26,28,28,28,28,28,28,28,28,28,28,28,28,28,28,28,28,28,28,28],[-1,13,22,18,26,18,24,18,22,20,24,28,26,24,20,30,24,28,28,26,30,28,30,30,30,30,28,30,30,30,30,30,30,30,30,30,30,30,30,30,30],[-1,17,28,22,16,22,28,26,26,24,28,24,28,22,24,24,30,28,28,26,28,30,24,30,30,30,30,30,30,30,30,30,30,30,30,30,30,30,30,30,30]],F=[[-1,1,1,1,1,1,2,2,2,2,4,4,4,4,4,6,6,6,6,7,8,8,9,9,10,12,12,12,13,14,15,16,17,18,19,19,20,21,22,24,25],[-1,1,1,1,2,2,4,4,4,5,5,5,8,9,9,10,10,11,13,14,16,17,17,18,20,21,23,25,26,28,29,31,33,35,37,38,40,43,45,47,49],[-1,1,1,2,2,4,4,6,6,8,8,8,10,12,16,12,17,16,18,21,20,23,23,25,27,29,34,34,35,38,40,43,45,48,51,53,56,59,62,65,68],[-1,1,1,2,4,4,4,5,6,8,8,11,11,16,16,18,16,19,21,25,25,25,34,30,32,35,37,40,42,45,48,51,54,57,60,63,66,70,74,77,81]],U=1,_=40,K=3,X=3,J=40,Z=10;function B(e){return e*4+17}function j(e){let r=(16*e+128)*e+64;if(e>=2){let t=Math.floor(e/7)+2;r-=(25*t-10)*t-55,e>=7&&(r-=36)}return r}function V(e){return Math.floor(j(e)/8)}function S(e,r){let t=G[r],n=z[t][e]*F[t][e];return(V(e)-n)*8}function ee(e){if(e===1)return[];let r=Math.floor(e/7)+2,t=e===32?26:Math.ceil((e*4+4)/(r*2-2))*2,n=[6];for(let o=B(e)-7;n.length<r;o-=t)n.splice(1,0,o);return n}var w=new Uint8Array(512),R=new Uint8Array(256);{let e=1;for(let r=0;r<255;r++)w[r]=e,R[e]=r,e<<=1,e&256&&(e^=285);for(let r=255;r<512;r++)w[r]=w[r-255]}function A(e,r){return e===0||r===0?0:w[R[e]+R[r]]}function re(e){let r=new Uint8Array(e);r[e-1]=1;let t=1;for(let n=0;n<e;n++){for(let o=0;o<e;o++){let a=A(r[o]??0,t);r[o]=o+1<e?a^(r[o+1]??0):a}t=A(t,2)}return r}function te(e,r){let t=new Uint8Array(r.length);for(let n of e){let o=n^(t[0]??0);t.copyWithin(0,1),t[t.length-1]=0;for(let a=0;a<t.length;a++)t[a]=(t[a]??0)^A(r[a]??0,o)}return t}function O(e,r,t){let n=e;for(let o=0;o<t;o++)n=n<<1^(n>>>t-1)*r;return n}function oe(e,r){let t=Y[e]<<3|r;return((t<<10|O(t,1335,10))^21522)&32767}function ne(e){return(e<<12|O(e,7973,12))&262143}function N(e){return e<=9?8:16}function h(e,r,t){for(let n=t-1;n>=0;n--)e.push(r>>>n&1)}function ae(e,r,t){let n=S(r,t),o=[];h(o,4,4),h(o,e.length,N(r));for(let s of e)h(o,s,8);h(o,0,Math.min(4,n-o.length)),h(o,0,(8-o.length%8)%8);for(let s=236;o.length<n;s^=253)h(o,s,8);let a=new Uint8Array(o.length/8);for(let s=0;s<o.length;s++){let i=s>>>3;a[i]=(a[i]??0)|o[s]<<7-(s&7)}return a}function se(e,r,t){let n=G[t],o=F[n][r],a=z[n][r],s=V(r),i=o-s%o,c=Math.floor(s/o)-a,l=re(a),p=[];for(let f=0,b=0;f<o;f++){let y=c+(f<i?0:1),Q=e.subarray(b,b+y);b+=y,p.push({data:Q,ecc:te(Q,l)})}let d=new Uint8Array(s),u=0;for(let f=0;f<=c;f++)for(let b of p)f<b.data.length&&(d[u++]=b.data[f]);for(let f=0;f<a;f++)for(let b of p)d[u++]=b.ecc[f];return d}var v=[(e,r)=>(e+r)%2===0,(e,r)=>r%2===0,e=>e%3===0,(e,r)=>(e+r)%3===0,(e,r)=>(Math.floor(r/2)+Math.floor(e/3))%2===0,(e,r)=>e*r%2+e*r%3===0,(e,r)=>(e*r%2+e*r%3)%2===0,(e,r)=>((e+r)%2+e*r%3)%2===0];function ie(e){let r=B(e),t=()=>Array.from({length:r},()=>new Array(r).fill(!1));return{size:r,modules:t(),isFunction:t()}}function m(e,r,t,n){e.modules[t][r]=n,e.isFunction[t][r]=!0}var C=(e,r)=>(e>>>r&1)!==0;function M(e,r,t){for(let n=-4;n<=4;n++)for(let o=-4;o<=4;o++){let a=r+o,s=t+n;if(a<0||a>=e.size||s<0||s>=e.size)continue;let i=Math.max(Math.abs(o),Math.abs(n));m(e,a,s,i!==2&&i!==4)}}function ce(e,r,t){for(let n=-2;n<=2;n++)for(let o=-2;o<=2;o++)m(e,r+o,t+n,Math.max(Math.abs(o),Math.abs(n))!==1)}function k(e,r,t){let n=oe(r,t),{size:o}=e;for(let a=0;a<=5;a++)m(e,8,a,C(n,a));m(e,8,7,C(n,6)),m(e,8,8,C(n,7)),m(e,7,8,C(n,8));for(let a=9;a<15;a++)m(e,14-a,8,C(n,a));for(let a=0;a<8;a++)m(e,o-1-a,8,C(n,a));for(let a=8;a<15;a++)m(e,8,o-15+a,C(n,a));m(e,8,o-8,!0)}function le(e,r){if(r<7)return;let t=ne(r);for(let n=0;n<18;n++){let o=C(t,n),a=e.size-11+n%3,s=Math.floor(n/3);m(e,a,s,o),m(e,s,a,o)}}function fe(e,r,t){let{size:n}=e;for(let s=0;s<n;s++)m(e,6,s,s%2===0),m(e,s,6,s%2===0);M(e,3,3),M(e,n-4,3),M(e,3,n-4);let o=ee(r),a=o.length-1;for(let s=0;s<=a;s++)for(let i=0;i<=a;i++)s===0&&i===0||s===0&&i===a||s===a&&i===0||ce(e,o[s],o[i]);k(e,t,0),le(e,r)}function ue(e,r){let{size:t}=e,n=0;for(let o=t-1;o>=1;o-=2){o===6&&(o=5);for(let a=0;a<t;a++)for(let s=0;s<2;s++){let i=o-s,l=(o+1&2)===0?t-1-a:a;e.isFunction[l][i]||n>=r.length*8||(e.modules[l][i]=C(r[n>>>3],7-(n&7)),n++)}}}function L(e,r){let t=v[r];for(let n=0;n<e.size;n++)for(let o=0;o<e.size;o++)!e.isFunction[n][o]&&t(o,n)&&(e.modules[n][o]=!e.modules[n][o])}function me(e){let{size:r,modules:t}=e,n=0;for(let i of[!0,!1])for(let c=0;c<r;c++){let l=u=>i?t[c][u]:t[u][c],p=l(0),d=1;for(let u=1;u<r;u++)l(u)===p?(d++,d===5?n+=K:d>5&&(n+=1)):(p=l(u),d=1);for(let u=0;u+10<r;u++){let f=0,b=0;for(let y=0;y<11;y++){let Q=l(u+y)?1:0;f=f<<1|Q,b|=Q<<y}(f===1488||b===1488)&&(n+=J)}}for(let i=0;i+1<r;i++)for(let c=0;c+1<r;c++){let l=t[i][c];l===t[i][c+1]&&l===t[i+1][c]&&l===t[i+1][c+1]&&(n+=X)}let o=0;for(let i of t)for(let c of i)c&&o++;let a=r*r,s=Math.floor(Math.abs(o*2-a)*10/a);return n+s*Z}function de(e,r){for(let t=U;t<=_;t++)if(4+N(t)+e*8<=S(t,r))return t;return null}function g(e,r,t){let n=new TextEncoder().encode(e),o;if(t===void 0?o=de(n.length,r):!Number.isInteger(t)||t<U||t>_?o=null:o=4+N(t)+n.length*8<=S(t,r)?t:null,o===null)return null;let a=ie(o);fe(a,o,r),ue(a,se(ae(n,o,r),o,r));let s=0,i=1/0;for(let c=0;c<v.length;c++){L(a,c),k(a,r,c);let l=me(a);l<i&&(i=l,s=c),L(a,c)}return L(a,s),k(a,r,s),a.modules}import{jsx as $,jsxs as Pe}from"react/jsx-runtime";var[xe,P]=be("QrCode"),q=x.forwardRef(({value:e,errorCorrection:r="M",version:t,encoding:n="byte",onEncodeError:o,hiddenLabel:a=!0,children:s,...i},c)=>{let l=x.useMemo(()=>g(e,r,t),[e,r,t]),p=ye(o);if(x.useEffect(()=>{l===null&&p(new Error(`[skandadx] QrCode cannot encode a ${e.length}-character value at error correction "${r}"`+(t===void 0?" within version 40.":` at version ${t}.`)))},[l,e,r,t,p]),l===null)return null;let d=l.length;return $(xe,{matrix:l,size:d,value:e,children:Pe(Ce.div,{"data-skdx-qr-code":"",...i,...pe("qr-code","root",i.className),ref:c,style:{"--skdx-qr-code-size":d,...i.style},children:[s,a?$(he,{children:e}):null]})})});q.displayName="QrCode";import*as I from"react";import{skdxPart as Qe}from"../utils/part.js";import{Primitive as we}from"../utils/primitive.js";import{jsx as Ee}from"react/jsx-runtime";var D=I.forwardRef((e,r)=>{let{size:t}=P("QrCodeFrame"),n=e["aria-label"]!==void 0||e["aria-labelledby"]!==void 0;return Ee(we.svg,{xmlns:"http://www.w3.org/2000/svg",viewBox:`0 0 ${t} ${t}`,shapeRendering:"crispEdges",role:n?"img":void 0,"aria-hidden":n?void 0:!0,"data-skdx-qr-code-frame":"",...e,...Qe("qr-code","frame",e.className),ref:r})});D.displayName="QrCodeFrame";import*as T from"react";import{skdxPart as Me}from"../utils/part.js";import{jsx as Le}from"react/jsx-runtime";var H=T.forwardRef(({size:e=7,...r},t)=>{let{size:n}=P("QrCodeOverlay"),o=(n-e)/2;return Le("g",{transform:`translate(${o} ${o})`,"data-skdx-qr-code-overlay":"",...r,...Me("qr-code","overlay",r.className),ref:t})});H.displayName="QrCodeOverlay";import*as E from"react";import{skdxPart as Re}from"../utils/part.js";import{jsx as Ae}from"react/jsx-runtime";var W=E.forwardRef((e,r)=>{let{matrix:t}=P("QrCodePattern"),n=E.useMemo(()=>{let o="";for(let a=0;a<t.length;a++){let s=t[a];for(let i=0;i<s.length;i++)s[i]&&(o+=`M${i} ${a}h1v1h-1z`)}return o},[t]);return Ae("path",{d:n,"data-skdx-qr-code-pattern":"",...e,...Re("qr-code","pattern",e.className),ref:r})});W.displayName="QrCodePattern";export{q as QrCode,D as QrCodeFrame,H as QrCodeOverlay,W as QrCodePattern};

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

@@ -0,0 +1,25 @@
+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`.
+ *
+ * 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.
+ *
+ * Must be used inside a `QrCode`.
+ *
+ * @example
+ * ```tsx
+ * <QrCodeFrame aria-label="Scan to open example.com" style={{ width: 160 }}>
+ *   <QrCodePattern fill="currentColor" />
+ * </QrCodeFrame>
+ * ```
+ */
+export declare const QrCodeFrame: React.ForwardRefExoticComponent<Omit<QrCodeFrameProps, "ref"> & React.RefAttributes<SVGSVGElement>>;

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

@@ -0,0 +1,25 @@
+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`.
+ *
+ * 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.
+ *
+ * Must be used inside a `QrCode`.
+ *
+ * @example
+ * ```tsx
+ * <QrCodeFrame aria-label="Scan to open example.com" style={{ width: 160 }}>
+ *   <QrCodePattern fill="currentColor" />
+ * </QrCodeFrame>
+ * ```
+ */
+export declare const QrCodeFrame: React.ForwardRefExoticComponent<Omit<QrCodeFrameProps, "ref"> & React.RefAttributes<SVGSVGElement>>;

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

@@ -0,0 +1,32 @@
+import * as React from 'react';
+import type { QrCodeOverlayProps } from './types.cjs';
+/**
+ * A centred slot for a logo, sitting on top of the pattern.
+ *
+ * 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.
+ *
+ * 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.
+ *
+ * Must be used inside a `QrCode`.
+ *
+ * @example
+ * ```tsx
+ * <QrCodeOverlay size={7}>
+ *   <rect width={7} height={7} fill="white" />
+ *   <image href={logo} width={7} height={7} />
+ * </QrCodeOverlay>
+ * ```
+ */
+export declare const QrCodeOverlay: React.ForwardRefExoticComponent<Omit<QrCodeOverlayProps, "ref"> & React.RefAttributes<SVGGElement>>;

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

@@ -0,0 +1,32 @@
+import * as React from 'react';
+import type { QrCodeOverlayProps } from './types.js';
+/**
+ * A centred slot for a logo, sitting on top of the pattern.
+ *
+ * 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.
+ *
+ * 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.
+ *
+ * Must be used inside a `QrCode`.
+ *
+ * @example
+ * ```tsx
+ * <QrCodeOverlay size={7}>
+ *   <rect width={7} height={7} fill="white" />
+ *   <image href={logo} width={7} height={7} />
+ * </QrCodeOverlay>
+ * ```
+ */
+export declare const QrCodeOverlay: React.ForwardRefExoticComponent<Omit<QrCodeOverlayProps, "ref"> & React.RefAttributes<SVGGElement>>;

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

@@ -0,0 +1,22 @@
+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`.
+ *
+ * @example
+ * ```tsx
+ * <QrCodePattern fill="currentColor" />
+ * ```
+ */
+export declare const QrCodePattern: React.ForwardRefExoticComponent<Omit<QrCodePatternProps, "ref"> & React.RefAttributes<SVGPathElement>>;

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

@@ -0,0 +1,22 @@
+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`.
+ *
+ * @example
+ * ```tsx
+ * <QrCodePattern fill="currentColor" />
+ * ```
+ */
+export declare const QrCodePattern: React.ForwardRefExoticComponent<Omit<QrCodePatternProps, "ref"> & React.RefAttributes<SVGPathElement>>;

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

@@ -0,0 +1,73 @@
+/**
+ * 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.
+ *
+ * @module
+ */
+/** Error-correction level, in ascending order of redundancy: `L` ≈ 7%, `M` ≈ 15%, `Q` ≈ 25%, `H` ≈ 30%. */
+export type ErrorCorrectionLevel = 'L' | 'M' | 'Q' | 'H';
+export declare const MIN_VERSION = 1;
+export declare const MAX_VERSION = 40;
+/** Module count along one edge for `version`: `4 × version + 17`, so 21 at v1 and 177 at v40. */
+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.
+ */
+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.
+ */
+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]`.
+ */
+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`.
+ */
+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.
+ */
+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.
+ */
+export declare function encodeQr(value: string, level: ErrorCorrectionLevel, version?: number): boolean[][] | null;

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

@@ -0,0 +1,73 @@
+/**
+ * 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.
+ *
+ * @module
+ */
+/** Error-correction level, in ascending order of redundancy: `L` ≈ 7%, `M` ≈ 15%, `Q` ≈ 25%, `H` ≈ 30%. */
+export type ErrorCorrectionLevel = 'L' | 'M' | 'Q' | 'H';
+export declare const MIN_VERSION = 1;
+export declare const MAX_VERSION = 40;
+/** Module count along one edge for `version`: `4 × version + 17`, so 21 at v1 and 177 at v40. */
+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.
+ */
+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.
+ */
+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]`.
+ */
+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`.
+ */
+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.
+ */
+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.
+ */
+export declare function encodeQr(value: string, level: ErrorCorrectionLevel, version?: number): boolean[][] | null;

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

@@ -0,0 +1,5 @@
+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';

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

@@ -0,0 +1,5 @@
+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';