@skdx/web-components 0.27.0 → 0.29.0

package/dist/internal/pointer-angle.d.cts

@@ -1,85 +1,35 @@
 /**
- * Pointer-drag-to-angle, for any element whose input is a *direction* rather
- * than a distance — an angle slider, a hue wheel, a gradient-angle picker, a
- * compass. Mirrors `packages/react/src/utils/usePointerAngle.ts`, shaped like
- * the other helpers in this directory: a plain function over an element that
- * returns a disposer, not a transliterated hook.
- *
- * **Convention: 0° is at 12 o'clock and the angle increases clockwise**, so
- * 90° is 3 o'clock, 180° is 6 o'clock and 270° is 9 o'clock. Values are always
- * in `[0, 360)`; 360 is never emitted.
- *
- * It knows nothing about what the angle *means*: no value range, no ARIA, no
- * `disabled`/`read-only` policy beyond the `enabled` gate the caller supplies.
- * That is what lets one helper serve both `<skdx-angle-slider>` (0–359 degrees)
- * and a hue wheel (0–359 hue) without either leaking into the other.
- *
- * @internal
- */
-/**
- * Options for {@link trackPointerAngle}. Every callback is read at call time
- * rather than captured at subscribe time, so an element that rebinds a handler
- * (or changes its `step`) mid-drag is honoured by the drag already in flight.
- *
+ * Options for {@link trackPointerAngle}; every callback is read at call time, so rebinding mid-drag is honoured by the drag already in flight.
  * @internal
  */
 export interface PointerAngleOptions {
     /**
-     * Snap increment in degrees, or a getter for one. Angles are rounded to the
-     * nearest multiple before any callback sees them, and a drag that stays
-     * within one increment emits nothing — which is what keeps a per-pixel
-     * `pointermove` from becoming a per-pixel render. Pass a getter when the
-     * increment is derived from live state (`<skdx-angle-slider>` passes
-     * `() => restrictToMarks ? 0 : step`).
-     * @default 0 — continuous; every pixel of movement reports a fresh angle.
+     * Snap increment in degrees or a getter; drag within one increment emits nothing.
+     * @default 0 — continuous
      */
     step?: number | (() => number);
     /**
-     * Consulted on `pointerdown`; returning `false` ignores the gesture
-     * entirely — no capture, no callbacks, no drag. This is where a
-     * `disabled`/`read-only` policy lives, since a custom element cannot simply
-     * decline to wire up its own listener the way a React component can.
-     * @default undefined — every gesture starts a drag.
+     * Checked on pointerdown; returning false ignores the gesture, since a custom element can't skip a listener like React can.
+     * @default undefined
      */
     enabled?: () => boolean;
-    /**
-     * Fires with the angle in `[0, 360)` on pointer down and on every subsequent
-     * move that changes it, plus the native event that produced it.
-     */
+    /** Fires with the angle in `[0, 360)` on pointer down and on every subsequent move that changes it, plus the native event that produced it. */
     onAngleChange: (angle: number, event: PointerEvent) => void;
     /**
-     * Fires once with the final angle when the drag ends — `pointerup` or
-     * `pointercancel`. This is the hook that lets a consumer avoid one network
-     * call per frame; `onAngleChange` is the per-frame signal.
-     * @default undefined — no-op if omitted.
+     * Fires once on drag end (pointerup/pointercancel), so consumers can avoid per-frame network calls.
+     * @default undefined
      */
     onAngleChangeEnd?: (angle: number, event: PointerEvent) => void;
     /**
-     * Fires with `true` when a drag starts and `false` when it ends, for a
-     * `data-dragging` styling hook. Called twice per drag, never per move.
-     * @default undefined — no-op if omitted.
+     * Fires true on drag start, false on end (twice per drag, never per move).
+     * @default undefined
      */
     onDraggingChange?: (dragging: boolean) => void;
 }
 /**
- * Turns pointer gestures on `element` into normalized angles. `element`'s
- * border box is the measurement source: its centre is the pivot, and it is
- * re-measured on every move, so a page that scrolls or resizes mid-drag stays
- * correct.
+ * Converts pointer gestures to normalized angles around `element`'s border-box center, taking pointer capture so the drag survives leaving the element.
  *
- * It takes pointer capture on the element so a drag survives leaving it, and
- * tracks the drag through document-level listeners so it survives leaving the
- * *window* too. Those listeners are removed on pointer up, on `pointercancel`
- * (which also fires `onAngleChangeEnd`, so a drag interrupted by a system
- * gesture still commits rather than hanging), and by the returned disposer —
- * where nothing is fired, because a disconnected element has no value to
- * commit to.
- *
- * A second pointer landing while a drag is in flight is ignored: the first one
- * owns the drag until it ends, so its listeners can never be stranded.
- *
- * @returns A disposer that unsubscribes the `pointerdown` listener and any
- * in-flight drag. Call it from `disconnectedCallback`.
+ * @returns Disposer for pointerdown listener and in-flight drag (call from disconnectedCallback).
  *
  * @example
  * ```ts
@@ -89,11 +39,9 @@ export interface PointerAngleOptions {
  *     step: () => this.step,
  *     enabled: () => !this.disabled,
  *     onAngleChange: (angle) => this.commit(angle),
- *     onAngleChangeEnd: () => this.dispatchEvent(new CustomEvent('value-commit', { detail: this.value })),
  *     onDraggingChange: (dragging) => { this.dragging = dragging; },
  *   });
  * }
- *
  * override disconnectedCallback(): void {
  *   this.disposePointer?.();
  *   super.disconnectedCallback();

package/dist/internal/pointer-angle.d.ts

@@ -1,85 +1,35 @@
 /**
- * Pointer-drag-to-angle, for any element whose input is a *direction* rather
- * than a distance — an angle slider, a hue wheel, a gradient-angle picker, a
- * compass. Mirrors `packages/react/src/utils/usePointerAngle.ts`, shaped like
- * the other helpers in this directory: a plain function over an element that
- * returns a disposer, not a transliterated hook.
- *
- * **Convention: 0° is at 12 o'clock and the angle increases clockwise**, so
- * 90° is 3 o'clock, 180° is 6 o'clock and 270° is 9 o'clock. Values are always
- * in `[0, 360)`; 360 is never emitted.
- *
- * It knows nothing about what the angle *means*: no value range, no ARIA, no
- * `disabled`/`read-only` policy beyond the `enabled` gate the caller supplies.
- * That is what lets one helper serve both `<skdx-angle-slider>` (0–359 degrees)
- * and a hue wheel (0–359 hue) without either leaking into the other.
- *
- * @internal
- */
-/**
- * Options for {@link trackPointerAngle}. Every callback is read at call time
- * rather than captured at subscribe time, so an element that rebinds a handler
- * (or changes its `step`) mid-drag is honoured by the drag already in flight.
- *
+ * Options for {@link trackPointerAngle}; every callback is read at call time, so rebinding mid-drag is honoured by the drag already in flight.
  * @internal
  */
 export interface PointerAngleOptions {
     /**
-     * Snap increment in degrees, or a getter for one. Angles are rounded to the
-     * nearest multiple before any callback sees them, and a drag that stays
-     * within one increment emits nothing — which is what keeps a per-pixel
-     * `pointermove` from becoming a per-pixel render. Pass a getter when the
-     * increment is derived from live state (`<skdx-angle-slider>` passes
-     * `() => restrictToMarks ? 0 : step`).
-     * @default 0 — continuous; every pixel of movement reports a fresh angle.
+     * Snap increment in degrees or a getter; drag within one increment emits nothing.
+     * @default 0 — continuous
      */
     step?: number | (() => number);
     /**
-     * Consulted on `pointerdown`; returning `false` ignores the gesture
-     * entirely — no capture, no callbacks, no drag. This is where a
-     * `disabled`/`read-only` policy lives, since a custom element cannot simply
-     * decline to wire up its own listener the way a React component can.
-     * @default undefined — every gesture starts a drag.
+     * Checked on pointerdown; returning false ignores the gesture, since a custom element can't skip a listener like React can.
+     * @default undefined
      */
     enabled?: () => boolean;
-    /**
-     * Fires with the angle in `[0, 360)` on pointer down and on every subsequent
-     * move that changes it, plus the native event that produced it.
-     */
+    /** Fires with the angle in `[0, 360)` on pointer down and on every subsequent move that changes it, plus the native event that produced it. */
     onAngleChange: (angle: number, event: PointerEvent) => void;
     /**
-     * Fires once with the final angle when the drag ends — `pointerup` or
-     * `pointercancel`. This is the hook that lets a consumer avoid one network
-     * call per frame; `onAngleChange` is the per-frame signal.
-     * @default undefined — no-op if omitted.
+     * Fires once on drag end (pointerup/pointercancel), so consumers can avoid per-frame network calls.
+     * @default undefined
      */
     onAngleChangeEnd?: (angle: number, event: PointerEvent) => void;
     /**
-     * Fires with `true` when a drag starts and `false` when it ends, for a
-     * `data-dragging` styling hook. Called twice per drag, never per move.
-     * @default undefined — no-op if omitted.
+     * Fires true on drag start, false on end (twice per drag, never per move).
+     * @default undefined
      */
     onDraggingChange?: (dragging: boolean) => void;
 }
 /**
- * Turns pointer gestures on `element` into normalized angles. `element`'s
- * border box is the measurement source: its centre is the pivot, and it is
- * re-measured on every move, so a page that scrolls or resizes mid-drag stays
- * correct.
+ * Converts pointer gestures to normalized angles around `element`'s border-box center, taking pointer capture so the drag survives leaving the element.
  *
- * It takes pointer capture on the element so a drag survives leaving it, and
- * tracks the drag through document-level listeners so it survives leaving the
- * *window* too. Those listeners are removed on pointer up, on `pointercancel`
- * (which also fires `onAngleChangeEnd`, so a drag interrupted by a system
- * gesture still commits rather than hanging), and by the returned disposer —
- * where nothing is fired, because a disconnected element has no value to
- * commit to.
- *
- * A second pointer landing while a drag is in flight is ignored: the first one
- * owns the drag until it ends, so its listeners can never be stranded.
- *
- * @returns A disposer that unsubscribes the `pointerdown` listener and any
- * in-flight drag. Call it from `disconnectedCallback`.
+ * @returns Disposer for pointerdown listener and in-flight drag (call from disconnectedCallback).
  *
  * @example
  * ```ts
@@ -89,11 +39,9 @@ export interface PointerAngleOptions {
  *     step: () => this.step,
  *     enabled: () => !this.disabled,
  *     onAngleChange: (angle) => this.commit(angle),
- *     onAngleChangeEnd: () => this.dispatchEvent(new CustomEvent('value-commit', { detail: this.value })),
  *     onDraggingChange: (dragging) => { this.dragging = dragging; },
  *   });
  * }
- *
  * override disconnectedCallback(): void {
  *   this.disposePointer?.();
  *   super.disconnectedCallback();

package/dist/internal/positioning.cjs

@@ -1 +1 @@
-"use strict";var x=Object.defineProperty;var E=Object.getOwnPropertyDescriptor;var H=Object.getOwnPropertyNames;var M=Object.prototype.hasOwnProperty;var L=(t,e)=>{for(var r in e)x(t,r,{get:e[r],enumerable:!0})},T=(t,e,r,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of H(e))!M.call(t,o)&&o!==r&&x(t,o,{get:()=>e[o],enumerable:!(n=E(e,o))||n.enumerable});return t};var I=t=>T(x({},"__esModule",{value:!0}),t);var C={};L(C,{optOutBoolean:()=>W,positionFloating:()=>j,setMeasurementProperties:()=>$});module.exports=I(C);var i=require("@floating-ui/dom"),p=require("./direction.cjs"),W={fromAttribute:t=>t!=="false"};function k(t,e){return e==="center"?t:`${t}-${e}`}var D={start:"0%",center:"50%",end:"100%"};function $(t,e,r){let{availableWidth:n,availableHeight:o,triggerWidth:g,side:l,align:m}=r,s=D[m],a=l==="top"||l==="bottom"?`${s} ${l==="top"?"100%":"0%"}`:`${l==="left"?"100%":"0%"} ${s}`;t.style.setProperty(`--skdx-${e}-available-width`,`${n}px`),t.style.setProperty(`--skdx-${e}-available-height`,`${o}px`),t.style.setProperty(`--skdx-${e}-trigger-width`,`${g}px`),t.style.setProperty(`--skdx-${e}-transform-origin`,a)}var R={top:"bottom",right:"left",bottom:"top",left:"right"};function B(t,e,r){let n=R[r];Object.assign(t.style,{position:"absolute",left:e?.x!=null?`${e.x}px`:"",top:e?.y!=null?`${e.y}px`:"",right:"",bottom:"",transform:n==="top"||n==="bottom"?`translateY(${n==="top"?"-100%":"100%"})`:`translateX(${n==="left"?"-100%":"100%"})`,[n]:"0"})}function j(t,e,r={}){let{side:n="bottom",align:o="center",sideOffset:g=0,alignOffset:l=0,avoidCollisions:m=!0,collisionPadding:s=8,collisionBoundary:a,component:S,arrow:A,direction:v}=r,u=a?{boundary:a}:{};return(0,i.autoUpdate)(t,e,()=>{let d=A?.()??null,O=(0,p.resolvePhysicalSide)(n,(0,p.resolveDirection)(t,v));(0,i.computePosition)(t,e,{strategy:"fixed",placement:k(O,o),middleware:[(0,i.offset)({mainAxis:g,alignmentAxis:l}),...m?[(0,i.flip)({padding:s,...u}),(0,i.shift)({padding:s,limiter:(0,i.limitShift)(),...u})]:[],(0,i.size)({padding:s,...u,apply({availableWidth:y,availableHeight:b,elements:P,rects:h,placement:c}){if(!S)return;let[f,w="center"]=c.split("-");$(P.floating,S,{availableWidth:y,availableHeight:b,triggerWidth:h.reference.width,side:f,align:w})}}),...d?[(0,i.arrow)({element:d})]:[]]}).then(({x:y,y:b,placement:P,middlewareData:h})=>{Object.assign(e.style,{position:"fixed",left:`${y}px`,top:`${b}px`});let[c,f="center"]=P.split("-");e.setAttribute("data-side",c),e.setAttribute("data-align",f),d&&B(d,h.arrow,c)})})}0&&(module.exports={optOutBoolean,positionFloating,setMeasurementProperties});
+"use strict";var a=Object.defineProperty;var B=Object.getOwnPropertyDescriptor;var C=Object.getOwnPropertyNames;var L=Object.prototype.hasOwnProperty;var j=(i,e)=>{for(var r in e)a(i,r,{get:e[r],enumerable:!0})},F=(i,e,r,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of C(e))!L.call(i,o)&&o!==r&&a(i,o,{get:()=>e[o],enumerable:!(s=B(e,o))||s.enumerable});return i};var V=i=>F(a({},"__esModule",{value:!0}),i);var z={};j(z,{optOutBoolean:()=>$,placementChanged:()=>k,positionFloating:()=>q,setMeasurementProperties:()=>g.setMeasurementProperties});module.exports=V(z);var t=require("@floating-ui/dom"),d=require("./direction.cjs"),n=require("./placement.cjs"),g=require("./placement.cjs"),W={offset:t.offset,flip:t.flip,shift:t.shift,limitShift:t.limitShift,size:t.size,arrow:t.arrow,hide:t.hide},$={fromAttribute:i=>i!=="false"};function k(i){return["side","align","sideOffset","alignOffset"].some(e=>i.get(e)!==void 0)}function q(i,e,r={}){let{side:s="bottom",align:o="center",sideOffset:y=0,alignOffset:P=0,avoidCollisions:b=!0,collisionPadding:w=8,collisionBoundary:h,component:O,arrow:x,direction:A,arrowPadding:E=0,hideWhenDetached:p=!1}=r,c=()=>{let l=x?.()??null,S=(0,d.resolvePhysicalSide)(s,(0,d.resolveDirection)("nodeType"in i?i:i.contextElement,A));(0,t.computePosition)(i,e,{strategy:"fixed",placement:(0,n.toPlacement)(S,o),middleware:(0,n.positioningMiddleware)(W,{sideOffset:y,alignOffset:P,avoidCollisions:b,collisionPadding:w,collisionBoundary:h,component:O,arrow:l,arrowPadding:E,hideWhenDetached:p})}).then(({x:H,y:M,placement:D,middlewareData:u})=>{if(Object.assign(e.style,{position:"fixed",left:`${H}px`,top:`${M}px`}),p){let m=u.hide?.referenceHidden===!0;e.style.visibility=m?"hidden":"",e.style.pointerEvents=m?"none":""}let[f,T]=(0,n.placementParts)(D);e.setAttribute("data-side",f),e.setAttribute("data-align",T),l&&(0,n.styleArrow)(l,u.arrow,f)})},v=(0,t.autoUpdate)(i,e,c);return Object.assign(()=>v(),{update:c})}0&&(module.exports={optOutBoolean,placementChanged,positionFloating,setMeasurementProperties});

package/dist/internal/positioning.d.cts

@@ -1,98 +1,70 @@
+import { type VirtualElement } from '@floating-ui/dom';
 import { type Direction, type PhysicalSide } from './direction.cjs';
-/**
- * @internal Edge of the anchor the floating element is placed against.
- * `start`/`end` are *logical*: they resolve to `left`/`right` under
- * `dir="ltr"` and swap under `dir="rtl"`, so a panel authored as `side="end"`
- * mirrors itself. `left`/`right` are physical and never mirror. `data-side`
- * keeps reporting a physical side — floating-ui's resolved, post-flip
- * placement, exactly as before.
- */
-export type Side = PhysicalSide | 'start' | 'end';
-/** @internal Alignment of the floating element along the chosen {@link Side}. */
-export type Align = 'start' | 'center' | 'end';
+import { type Align, type Side } from './placement.cjs';
+export { setMeasurementProperties, type Align, type Side } from './placement.cjs';
 /** @internal Side/align options mirroring the React popper util's public API. */
 export interface PositionOptions {
-    side?: Side;
-    align?: Align;
+    side?: Side | undefined;
+    align?: Align | undefined;
     sideOffset?: number;
     alignOffset?: number;
     avoidCollisions?: boolean;
-    /**
-     * Minimum distance in pixels kept from the collision boundary. A number
-     * applies to every side; an object sets only the sides it names, the rest
-     * falling back to `0`.
-     */
+    /** Min distance from collision boundary (number for all, object for per-side). */
     collisionPadding?: number | Partial<Record<PhysicalSide, number>>;
     /**
-     * Element (or elements) collisions are measured against, instead of the
-     * floating element's clipping ancestors. Use it to keep an overlay inside a
-     * scroll container or one pane of a split layout rather than the whole
-     * viewport.
+     * Collision boundary instead of clipping ancestors (keeps overlay in scroll/pane).
      * @default undefined — the floating element's clipping ancestors.
      */
-    collisionBoundary?: Element | Element[] | null;
+    collisionBoundary?: Element | Element[] | null | undefined;
     /**
-     * Kebab-case component name the measurement CSS custom properties are
-     * namespaced under — `"popover"` yields `--skdx-popover-available-width` and
-     * friends. The namespace belongs to the component, not to its consumer, so
-     * each Content part passes its own slug.
+     * Kebab-case component name for CSS custom properties (`--skdx-{component}-available-width`).
      * @internal
-     * @default undefined — an internal popper with no documented namespace writes no measurement properties at all.
+     * @default undefined — no measurement properties written.
      */
     component?: string;
     /** Writing direction override; omit to resolve from the nearest `[dir]` ancestor of the anchor. */
     direction?: Direction;
+    /** Resolves `<skdx-*-arrow>` element; called on reposition, picks up late-added arrows. */
+    arrow?: () => HTMLElement | null | undefined;
     /**
-     * Resolves the `<skdx-*-arrow>` element inside `floating`, if one is
-     * rendered. Called on every reposition rather than captured once, so an
-     * arrow added after the overlay opened is picked up on the next update.
+     * Clearance between arrow and panel edge (prevents rounded-corner overlap).
+     * @default 0
      */
-    arrow?: () => HTMLElement | null | undefined;
+    arrowPadding?: number;
+    /**
+     * Hide when anchor is clipped by scroll container (off by default, adds overhead).
+     * @default false
+     */
+    hideWhenDetached?: boolean;
+}
+/**
+ * Teardown function from positionFloating, with manual reposition trigger as property.
+ * @internal
+ */
+export interface PositionHandle {
+    (): void;
+    /** Recomputes position now; `autoUpdate` covers scroll and resize, this covers anchor movement the DOM never reports. */
+    update: () => void;
 }
 /**
- * Boolean attribute converter for positioning props that default to `true`
- * (`avoid-collisions`). Lit's stock `Boolean` converter reads attribute
- * *presence*, so `avoid-collisions="false"` would come back `true` and the
- * prop could never be switched off from HTML at all — unlike React, where
- * `avoidCollisions={false}` is the documented way to opt out. Here the value
- * wins: only the literal string `"false"` is false.
+ * Boolean converter for props that default to `true`: Lit's presence-only `Boolean` converter would treat `avoid-collisions="false"` as `true`, so only the literal `"false"` string is false.
  * @internal
  */
 export declare const optOutBoolean: {
     fromAttribute: (value: string | null) => boolean;
 };
 /**
- * Writes the four measurement custom properties onto the floating element
- * after each reposition, so a consumer can size the panel from CSS alone
- * (`max-height: var(--skdx-select-available-height)`) instead of measuring in
- * JavaScript. Mirrored by `PopperContent`/`usePopperPosition` in the other
- * four packages and asserted by `assertPopperMeasurementProperties`.
- *
- * The transform origin is derived from the *resolved* side and alignment, so
- * a panel that flipped grows from the edge it actually landed on.
+ * Whether a Lit `updated()` change set moved a placement prop, so an open panel has to re-run
+ * {@link positionFloating} — its options are captured by value, so `handle.update()` keeps the old side.
  *
- * ponytail: origin is edge-and-alignment accurate but not arrow-accurate —
- * a panel with a shifted arrow scales from the aligned edge rather than from
- * the arrow's tip. Feed the arrow middleware's offset in here if that ever
- * shows.
+ * Reads the recorded previous value rather than key presence: on the first render every previous
+ * value is `undefined`, and these four props all carry a defined default, so that skips the
+ * pointless restart right after the panel first positioned itself.
  * @internal
  */
-export declare function setMeasurementProperties(floating: HTMLElement, component: string, measurements: {
-    availableWidth: number;
-    availableHeight: number;
-    triggerWidth: number;
-    side: PhysicalSide;
-    align: Align;
-}): void;
+export declare function placementChanged(changed: Map<string, unknown>): boolean;
 /**
- * Positions `floating` relative to `anchor` using floating-ui, re-running on
- * scroll/resize while active. Reflects floating-ui's *resolved* (post-flip,
- * post-shift) placement onto `floating` as `data-side`/`data-align`, and
- * positions an optional arrow element from the same resolved placement —
- * the same contract as React's `PopperContent`/`PopperArrow`. Given a
- * `component` namespace it also writes the four measurement custom
- * properties (see {@link setMeasurementProperties}) onto `floating` after
- * each reposition. Returns a cleanup function to call on close.
+ * Positions `floating` relative to `anchor` using floating-ui, re-running on scroll/resize and reflecting the resolved placement as `data-side`/`data-align`.
  * @internal
  */
-export declare function positionFloating(anchor: HTMLElement, floating: HTMLElement, options?: PositionOptions): () => void;
+export declare function positionFloating(anchor: Element | VirtualElement, floating: HTMLElement, options?: PositionOptions): PositionHandle;

package/dist/internal/positioning.d.ts

@@ -1,98 +1,70 @@
+import { type VirtualElement } from '@floating-ui/dom';
 import { type Direction, type PhysicalSide } from './direction.js';
-/**
- * @internal Edge of the anchor the floating element is placed against.
- * `start`/`end` are *logical*: they resolve to `left`/`right` under
- * `dir="ltr"` and swap under `dir="rtl"`, so a panel authored as `side="end"`
- * mirrors itself. `left`/`right` are physical and never mirror. `data-side`
- * keeps reporting a physical side — floating-ui's resolved, post-flip
- * placement, exactly as before.
- */
-export type Side = PhysicalSide | 'start' | 'end';
-/** @internal Alignment of the floating element along the chosen {@link Side}. */
-export type Align = 'start' | 'center' | 'end';
+import { type Align, type Side } from './placement.js';
+export { setMeasurementProperties, type Align, type Side } from './placement.js';
 /** @internal Side/align options mirroring the React popper util's public API. */
 export interface PositionOptions {
-    side?: Side;
-    align?: Align;
+    side?: Side | undefined;
+    align?: Align | undefined;
     sideOffset?: number;
     alignOffset?: number;
     avoidCollisions?: boolean;
-    /**
-     * Minimum distance in pixels kept from the collision boundary. A number
-     * applies to every side; an object sets only the sides it names, the rest
-     * falling back to `0`.
-     */
+    /** Min distance from collision boundary (number for all, object for per-side). */
     collisionPadding?: number | Partial<Record<PhysicalSide, number>>;
     /**
-     * Element (or elements) collisions are measured against, instead of the
-     * floating element's clipping ancestors. Use it to keep an overlay inside a
-     * scroll container or one pane of a split layout rather than the whole
-     * viewport.
+     * Collision boundary instead of clipping ancestors (keeps overlay in scroll/pane).
      * @default undefined — the floating element's clipping ancestors.
      */
-    collisionBoundary?: Element | Element[] | null;
+    collisionBoundary?: Element | Element[] | null | undefined;
     /**
-     * Kebab-case component name the measurement CSS custom properties are
-     * namespaced under — `"popover"` yields `--skdx-popover-available-width` and
-     * friends. The namespace belongs to the component, not to its consumer, so
-     * each Content part passes its own slug.
+     * Kebab-case component name for CSS custom properties (`--skdx-{component}-available-width`).
      * @internal
-     * @default undefined — an internal popper with no documented namespace writes no measurement properties at all.
+     * @default undefined — no measurement properties written.
      */
     component?: string;
     /** Writing direction override; omit to resolve from the nearest `[dir]` ancestor of the anchor. */
     direction?: Direction;
+    /** Resolves `<skdx-*-arrow>` element; called on reposition, picks up late-added arrows. */
+    arrow?: () => HTMLElement | null | undefined;
     /**
-     * Resolves the `<skdx-*-arrow>` element inside `floating`, if one is
-     * rendered. Called on every reposition rather than captured once, so an
-     * arrow added after the overlay opened is picked up on the next update.
+     * Clearance between arrow and panel edge (prevents rounded-corner overlap).
+     * @default 0
      */
-    arrow?: () => HTMLElement | null | undefined;
+    arrowPadding?: number;
+    /**
+     * Hide when anchor is clipped by scroll container (off by default, adds overhead).
+     * @default false
+     */
+    hideWhenDetached?: boolean;
+}
+/**
+ * Teardown function from positionFloating, with manual reposition trigger as property.
+ * @internal
+ */
+export interface PositionHandle {
+    (): void;
+    /** Recomputes position now; `autoUpdate` covers scroll and resize, this covers anchor movement the DOM never reports. */
+    update: () => void;
 }
 /**
- * Boolean attribute converter for positioning props that default to `true`
- * (`avoid-collisions`). Lit's stock `Boolean` converter reads attribute
- * *presence*, so `avoid-collisions="false"` would come back `true` and the
- * prop could never be switched off from HTML at all — unlike React, where
- * `avoidCollisions={false}` is the documented way to opt out. Here the value
- * wins: only the literal string `"false"` is false.
+ * Boolean converter for props that default to `true`: Lit's presence-only `Boolean` converter would treat `avoid-collisions="false"` as `true`, so only the literal `"false"` string is false.
  * @internal
  */
 export declare const optOutBoolean: {
     fromAttribute: (value: string | null) => boolean;
 };
 /**
- * Writes the four measurement custom properties onto the floating element
- * after each reposition, so a consumer can size the panel from CSS alone
- * (`max-height: var(--skdx-select-available-height)`) instead of measuring in
- * JavaScript. Mirrored by `PopperContent`/`usePopperPosition` in the other
- * four packages and asserted by `assertPopperMeasurementProperties`.
- *
- * The transform origin is derived from the *resolved* side and alignment, so
- * a panel that flipped grows from the edge it actually landed on.
+ * Whether a Lit `updated()` change set moved a placement prop, so an open panel has to re-run
+ * {@link positionFloating} — its options are captured by value, so `handle.update()` keeps the old side.
  *
- * ponytail: origin is edge-and-alignment accurate but not arrow-accurate —
- * a panel with a shifted arrow scales from the aligned edge rather than from
- * the arrow's tip. Feed the arrow middleware's offset in here if that ever
- * shows.
+ * Reads the recorded previous value rather than key presence: on the first render every previous
+ * value is `undefined`, and these four props all carry a defined default, so that skips the
+ * pointless restart right after the panel first positioned itself.
  * @internal
  */
-export declare function setMeasurementProperties(floating: HTMLElement, component: string, measurements: {
-    availableWidth: number;
-    availableHeight: number;
-    triggerWidth: number;
-    side: PhysicalSide;
-    align: Align;
-}): void;
+export declare function placementChanged(changed: Map<string, unknown>): boolean;
 /**
- * Positions `floating` relative to `anchor` using floating-ui, re-running on
- * scroll/resize while active. Reflects floating-ui's *resolved* (post-flip,
- * post-shift) placement onto `floating` as `data-side`/`data-align`, and
- * positions an optional arrow element from the same resolved placement —
- * the same contract as React's `PopperContent`/`PopperArrow`. Given a
- * `component` namespace it also writes the four measurement custom
- * properties (see {@link setMeasurementProperties}) onto `floating` after
- * each reposition. Returns a cleanup function to call on close.
+ * Positions `floating` relative to `anchor` using floating-ui, re-running on scroll/resize and reflecting the resolved placement as `data-side`/`data-align`.
  * @internal
  */
-export declare function positionFloating(anchor: HTMLElement, floating: HTMLElement, options?: PositionOptions): () => void;
+export declare function positionFloating(anchor: Element | VirtualElement, floating: HTMLElement, options?: PositionOptions): PositionHandle;

package/dist/internal/positioning.js

@@ -1 +1 @@
-import{arrow as A,autoUpdate as v,computePosition as O,flip as w,limitShift as E,offset as H,shift as M,size as L}from"@floating-ui/dom";import{resolveDirection as T,resolvePhysicalSide as I}from"./direction.js";var N={fromAttribute:t=>t!=="false"};function W(t,e){return e==="center"?t:`${t}-${e}`}var k={start:"0%",center:"50%",end:"100%"};function D(t,e,o){let{availableWidth:i,availableHeight:d,triggerWidth:c,side:n,align:p}=o,r=k[p],l=n==="top"||n==="bottom"?`${r} ${n==="top"?"100%":"0%"}`:`${n==="left"?"100%":"0%"} ${r}`;t.style.setProperty(`--skdx-${e}-available-width`,`${i}px`),t.style.setProperty(`--skdx-${e}-available-height`,`${d}px`),t.style.setProperty(`--skdx-${e}-trigger-width`,`${c}px`),t.style.setProperty(`--skdx-${e}-transform-origin`,l)}var R={top:"bottom",right:"left",bottom:"top",left:"right"};function B(t,e,o){let i=R[o];Object.assign(t.style,{position:"absolute",left:e?.x!=null?`${e.x}px`:"",top:e?.y!=null?`${e.y}px`:"",right:"",bottom:"",transform:i==="top"||i==="bottom"?`translateY(${i==="top"?"-100%":"100%"})`:`translateX(${i==="left"?"-100%":"100%"})`,[i]:"0"})}function _(t,e,o={}){let{side:i="bottom",align:d="center",sideOffset:c=0,alignOffset:n=0,avoidCollisions:p=!0,collisionPadding:r=8,collisionBoundary:l,component:h,arrow:f,direction:x}=o,g=l?{boundary:l}:{};return v(t,e,()=>{let s=f?.()??null,S=I(i,T(t,x));O(t,e,{strategy:"fixed",placement:W(S,d),middleware:[H({mainAxis:c,alignmentAxis:n}),...p?[w({padding:r,...g}),M({padding:r,limiter:E(),...g})]:[],L({padding:r,...g,apply({availableWidth:m,availableHeight:u,elements:y,rects:b,placement:a}){if(!h)return;let[P,$="center"]=a.split("-");D(y.floating,h,{availableWidth:m,availableHeight:u,triggerWidth:b.reference.width,side:P,align:$})}}),...s?[A({element:s})]:[]]}).then(({x:m,y:u,placement:y,middlewareData:b})=>{Object.assign(e.style,{position:"fixed",left:`${m}px`,top:`${u}px`});let[a,P="center"]=y.split("-");e.setAttribute("data-side",a),e.setAttribute("data-align",P),s&&B(s,b.arrow,a)})})}export{N as optOutBoolean,_ as positionFloating,D as setMeasurementProperties};
+import{arrow as S,autoUpdate as H,computePosition as M,flip as D,hide as T,limitShift as B,offset as C,shift as L,size as j}from"@floating-ui/dom";import{resolveDirection as F,resolvePhysicalSide as V}from"./direction.js";import{placementParts as W,positioningMiddleware as $,styleArrow as k,toPlacement as q}from"./placement.js";import{setMeasurementProperties as X}from"./placement.js";var z={offset:C,flip:D,shift:L,limitShift:B,size:j,arrow:S,hide:T},R={fromAttribute:e=>e!=="false"};function U(e){return["side","align","sideOffset","alignOffset"].some(t=>e.get(t)!==void 0)}function J(e,t,l={}){let{side:a="bottom",align:p="center",sideOffset:c=0,alignOffset:u=0,avoidCollisions:f=!0,collisionPadding:m=8,collisionBoundary:g,component:y,arrow:P,direction:b,arrowPadding:w=0,hideWhenDetached:n=!1}=l,o=()=>{let i=P?.()??null,O=V(a,F("nodeType"in e?e:e.contextElement,b));M(e,t,{strategy:"fixed",placement:q(O,p),middleware:$(z,{sideOffset:c,alignOffset:u,avoidCollisions:f,collisionPadding:m,collisionBoundary:g,component:y,arrow:i,arrowPadding:w,hideWhenDetached:n})}).then(({x,y:A,placement:E,middlewareData:r})=>{if(Object.assign(t.style,{position:"fixed",left:`${x}px`,top:`${A}px`}),n){let d=r.hide?.referenceHidden===!0;t.style.visibility=d?"hidden":"",t.style.pointerEvents=d?"none":""}let[s,v]=W(E);t.setAttribute("data-side",s),t.setAttribute("data-align",v),i&&k(i,r.arrow,s)})},h=H(e,t,o);return Object.assign(()=>h(),{update:o})}export{R as optOutBoolean,U as placementChanged,J as positionFloating,X as setMeasurementProperties};

package/dist/internal/qr-encoder.cjs

@@ -0,0 +1 @@
+"use strict";var w=Object.defineProperty;var Y=Object.getOwnPropertyDescriptor;var j=Object.getOwnPropertyNames;var H=Object.prototype.hasOwnProperty;var K=(n,t)=>{for(var e in t)w(n,e,{get:t[e],enumerable:!0})},X=(n,t,e,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of j(t))!H.call(n,o)&&o!==e&&w(n,o,{get:()=>t[o],enumerable:!(r=Y(t,o))||r.enumerable});return n};var W=n=>X(w({},"__esModule",{value:!0}),n);var yn={};K(yn,{MAX_VERSION:()=>U,MIN_VERSION:()=>G,alignmentPatternPositions:()=>I,dataCapacityBits:()=>y,encodeQr:()=>hn,formatInfoBits:()=>T,moduleCount:()=>k,reedSolomonGeneratorPoly:()=>O,totalCodewords:()=>_,versionInfoBits:()=>V});module.exports=W(yn);var q={L:1,M:0,Q:3,H:2},S={L:0,M:1,Q:2,H:3},F=[[-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]],R=[[-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]],G=1,U=40,J=3,Z=3,$=40,v=10;function k(n){return n*4+17}function g(n){let t=(16*n+128)*n+64;if(n>=2){let e=Math.floor(n/7)+2;t-=(25*e-10)*e-55,n>=7&&(t-=36)}return t}function _(n){return Math.floor(g(n)/8)}function y(n,t){let e=S[t],r=F[e][n]*R[e][n];return(_(n)-r)*8}function I(n){if(n===1)return[];let t=Math.floor(n/7)+2,e=n===32?26:Math.ceil((n*4+4)/(t*2-2))*2,r=[6];for(let o=k(n)-7;r.length<t;o-=e)r.splice(1,0,o);return r}var h=new Uint8Array(512),L=new Uint8Array(256);{let n=1;for(let t=0;t<255;t++)h[t]=n,L[n]=t,n<<=1,n&256&&(n^=285);for(let t=255;t<512;t++)h[t]=h[t-255]}function M(n,t){return n===0||t===0?0:h[L[n]+L[t]]}function O(n){let t=new Uint8Array(n);t[n-1]=1;let e=1;for(let r=0;r<n;r++){for(let o=0;o<n;o++){let u=M(t[o]??0,e);t[o]=o+1<n?u^(t[o+1]??0):u}e=M(e,2)}return t}function nn(n,t){let e=new Uint8Array(t.length);for(let r of n){let o=r^(e[0]??0);e.copyWithin(0,1),e[e.length-1]=0;for(let u=0;u<e.length;u++)e[u]=(e[u]??0)^M(t[u]??0,o)}return e}function D(n,t,e){let r=n;for(let o=0;o<e;o++)r=r<<1^(r>>>e-1)*t;return r}function T(n,t){let e=q[n]<<3|t;return((e<<10|D(e,1335,10))^21522)&32767}function V(n){return(n<<12|D(n,7973,12))&262143}function B(n){return n<=9?8:16}function d(n,t,e){for(let r=e-1;r>=0;r--)n.push(t>>>r&1)}function tn(n,t,e){let r=y(t,e),o=[];d(o,4,4),d(o,n.length,B(t));for(let c of n)d(o,c,8);d(o,0,Math.min(4,r-o.length)),d(o,0,(8-o.length%8)%8);for(let c=236;o.length<r;c^=253)d(o,c,8);let u=new Uint8Array(o.length/8);for(let c=0;c<o.length;c++){let l=c>>>3;u[l]=(u[l]??0)|o[c]<<7-(c&7)}return u}function on(n,t,e){let r=S[e],o=R[r][t],u=F[r][t],c=_(t),l=o-c%o,f=Math.floor(c/o)-u,m=O(u),p=[];for(let i=0,b=0;i<o;i++){let N=f+(i<l?0:1),z=n.subarray(b,b+N);b+=N,p.push({data:z,ecc:nn(z,m)})}let x=new Uint8Array(c),P=0;for(let i=0;i<=f;i++)for(let b of p)i<b.data.length&&(x[P++]=b.data[i]);for(let i=0;i<u;i++)for(let b of p)x[P++]=b.ecc[i];return x}var Q=[(n,t)=>(n+t)%2===0,(n,t)=>t%2===0,n=>n%3===0,(n,t)=>(n+t)%3===0,(n,t)=>(Math.floor(t/2)+Math.floor(n/3))%2===0,(n,t)=>n*t%2+n*t%3===0,(n,t)=>(n*t%2+n*t%3)%2===0,(n,t)=>((n+t)%2+n*t%3)%2===0];function rn(n){let t=k(n),e=()=>Array.from({length:t},()=>new Array(t).fill(!1));return{size:t,modules:e(),isFunction:e()}}function s(n,t,e,r){n.modules[e][t]=r,n.isFunction[e][t]=!0}var a=(n,t)=>(n>>>t&1)!==0;function A(n,t,e){for(let r=-4;r<=4;r++)for(let o=-4;o<=4;o++){let u=t+o,c=e+r;if(u<0||u>=n.size||c<0||c>=n.size)continue;let l=Math.max(Math.abs(o),Math.abs(r));s(n,u,c,l!==2&&l!==4)}}function en(n,t,e){for(let r=-2;r<=2;r++)for(let o=-2;o<=2;o++)s(n,t+o,e+r,Math.max(Math.abs(o),Math.abs(r))!==1)}function C(n,t,e){let r=T(t,e),{size:o}=n;for(let u=0;u<=5;u++)s(n,8,u,a(r,u));s(n,8,7,a(r,6)),s(n,8,8,a(r,7)),s(n,7,8,a(r,8));for(let u=9;u<15;u++)s(n,14-u,8,a(r,u));for(let u=0;u<8;u++)s(n,o-1-u,8,a(r,u));for(let u=8;u<15;u++)s(n,8,o-15+u,a(r,u));s(n,8,o-8,!0)}function un(n,t){if(t<7)return;let e=V(t);for(let r=0;r<18;r++){let o=a(e,r),u=n.size-11+r%3,c=Math.floor(r/3);s(n,u,c,o),s(n,c,u,o)}}function cn(n,t,e){let{size:r}=n;for(let c=0;c<r;c++)s(n,6,c,c%2===0),s(n,c,6,c%2===0);A(n,3,3),A(n,r-4,3),A(n,3,r-4);let o=I(t),u=o.length-1;for(let c=0;c<=u;c++)for(let l=0;l<=u;l++)c===0&&l===0||c===0&&l===u||c===u&&l===0||en(n,o[c],o[l]);C(n,e,0),un(n,t)}function ln(n,t){let{size:e}=n,r=0;for(let o=e-1;o>=1;o-=2){o===6&&(o=5);for(let u=0;u<e;u++)for(let c=0;c<2;c++){let l=o-c,m=(o+1&2)===0?e-1-u:u;n.isFunction[m][l]||r>=t.length*8||(n.modules[m][l]=a(t[r>>>3],7-(r&7)),r++)}}}function E(n,t){let e=Q[t];for(let r=0;r<n.size;r++)for(let o=0;o<n.size;o++)!n.isFunction[r][o]&&e(o,r)&&(n.modules[r][o]=!n.modules[r][o])}function sn(n,t){let e=0,r=n(0),o=1;for(let u=1;u<t;u++)n(u)===r?(o++,o===5?e+=J:o>5&&(e+=1)):(r=n(u),o=1);return e}function fn(n,t){let e=0;for(let r=0;r+10<t;r++){let o=0,u=0;for(let c=0;c<11;c++){let l=n(r+c)?1:0;o=o<<1|l,u|=l<<c}(o===1488||u===1488)&&(e+=$)}return e}function an(n){let{size:t,modules:e}=n,r=0;for(let o=0;o+1<t;o++)for(let u=0;u+1<t;u++){let c=e[o][u];c===e[o][u+1]&&c===e[o+1][u]&&c===e[o+1][u+1]&&(r+=Z)}return r}function bn(n){let{size:t,modules:e}=n,r=0;for(let u of e)for(let c of u)c&&r++;let o=t*t;return Math.floor(Math.abs(r*2-o)*10/o)*v}function mn(n){let{size:t,modules:e}=n,r=0;for(let o of[!0,!1])for(let u=0;u<t;u++){let c=l=>o?e[u][l]:e[l][u];r+=sn(c,t),r+=fn(c,t)}return r+an(n)+bn(n)}function dn(n,t){for(let e=G;e<=U;e++)if(4+B(e)+n*8<=y(e,t))return e;return null}function hn(n,t,e){let r=new TextEncoder().encode(n),o;if(e===void 0?o=dn(r.length,t):!Number.isInteger(e)||e<G||e>U?o=null:o=4+B(e)+r.length*8<=y(e,t)?e:null,o===null)return null;let u=rn(o);cn(u,o,t),ln(u,on(tn(r,o,t),o,t));let c=0,l=1/0;for(let f=0;f<Q.length;f++){E(u,f),C(u,t,f);let m=mn(u);m<l&&(l=m,c=f),E(u,f)}return E(u,c),C(u,t,c),u.modules}0&&(module.exports={MAX_VERSION,MIN_VERSION,alignmentPatternPositions,dataCapacityBits,encodeQr,formatInfoBits,moduleCount,reedSolomonGeneratorPoly,totalCodewords,versionInfoBits});

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

@@ -0,0 +1,33 @@
+/**
+ * QR Code encoder from ISO/IEC 18004: byte mode only (UTF-8), versions 1–40, all four error-correction levels.
+ *
+ * @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. */
+export declare function dataCapacityBits(version: number, level: ErrorCorrectionLevel): number;
+/** Centre coordinates of alignment patterns for `version`, ascending, per ISO/IEC 18004 Table E.1. */
+export declare function alignmentPatternPositions(version: number): number[];
+/** Reed–Solomon generator polynomial `(x − α^0)(x − α^1)…(x − α^(degree−1))`, returned monic-implicit (leading 1 omitted). */
+export declare function reedSolomonGeneratorPoly(degree: number): Uint8Array;
+/** 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;
+/** 18-bit version-information word: BCH(18, 6), used only for version 7 and up. */
+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 invalid. Never throws.
+ */
+export declare function encodeQr(value: string, level: ErrorCorrectionLevel, version?: number): boolean[][] | null;

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

@@ -0,0 +1,33 @@
+/**
+ * QR Code encoder from ISO/IEC 18004: byte mode only (UTF-8), versions 1–40, all four error-correction levels.
+ *
+ * @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. */
+export declare function dataCapacityBits(version: number, level: ErrorCorrectionLevel): number;
+/** Centre coordinates of alignment patterns for `version`, ascending, per ISO/IEC 18004 Table E.1. */
+export declare function alignmentPatternPositions(version: number): number[];
+/** Reed–Solomon generator polynomial `(x − α^0)(x − α^1)…(x − α^(degree−1))`, returned monic-implicit (leading 1 omitted). */
+export declare function reedSolomonGeneratorPoly(degree: number): Uint8Array;
+/** 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;
+/** 18-bit version-information word: BCH(18, 6), used only for version 7 and up. */
+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 invalid. Never throws.
+ */
+export declare function encodeQr(value: string, level: ErrorCorrectionLevel, version?: number): boolean[][] | null;