@ngrok/mantle 0.82.0 → 0.83.0

package/dist/otp-input.d.ts

@@ -104,11 +104,11 @@ type OtpInputSlotProps = ComponentProps<"div"> & {
 declare const OtpInputSlotImpl: ({ className, index, ref, ...props }: OtpInputSlotProps) => import("react").JSX.Element;
 type OtpInputSeparatorProps = ComponentProps<"div"> & WithAsChild & {
   /**
-   * If `true`, the separator will be rendered with `role="separator"` so
-   * assistive tech announces it as a divider between OTP groups.
+   * If `true`, the separator renders with `role="separator"` so assistive
+   * tech announces it as a divider between OTP groups.
    * If `false`, the separator is purely decorative and is removed from
    * the accessibility tree — preferred inside an OTP control where the
-   * minus icon is just visual chrome between slot groups.
+   * minus icon is visual chrome between slot groups.
    *
    * @default false
    */
@@ -176,7 +176,7 @@ declare const Separator: ({ asChild, children, className, ref, semantic, ...prop
 declare const OtpInput: {
   /**
    * The root of the OTP input. Wraps the hidden input that captures
-   * keystrokes, paste, and autofill, and provides per-slot state to
+   * keystrokes, paste, and autofill, and exposes per-slot state to
    * descendant `OtpInput.Slot` parts.
    *
    * @see https://mantle.ngrok.com/components/forms/otp-input

package/dist/otp-input.js

@@ -1 +1 @@
-import{t as e}from"./cx-IiQEAKf5.js";import{t}from"./slot-Dpsqz16D.js";import{t as n}from"./types-D85fCNV3.js";import{a as r,r as i}from"./field-Bpptk_9t.js";import{t as a}from"./field-B1wqeZr4.js";import{useContext as o}from"react";import{jsx as s,jsxs as c}from"react/jsx-runtime";import{MinusIcon as l}from"@phosphor-icons/react/Minus";import{OTPInput as u,OTPInputContext as d,REGEXP_ONLY_CHARS as f,REGEXP_ONLY_DIGITS as p,REGEXP_ONLY_DIGITS_AND_CHARS as m}from"input-otp";const h={error:`danger`,success:`success`,warning:`warning`},g=e=>`var(--color-${e}-600)`,_=e=>`var(--ring-color-focus-${e})`,v=({totalActive:e,total:t})=>e===0?`idle`:e===1?`caret`:e===t?`all`:`range`,y=({children:e,validation:t})=>{let r=o(d),i=r.slots.length,a=r.slots.reduce((e,t)=>e+ +!!t.isActive,0),c=v({totalActive:a,total:i}),l=t?h[t]:void 0,u=l?n({"--otp-validation-border":g(l),"--otp-validation-ring":_(l)}):void 0;return s(`div`,{className:`group/otp contents`,"data-otp-state":c,"data-validation":t||void 0,style:u,children:e})},b={Root:({"aria-invalid":t,children:n,className:c,containerClassName:l,ref:d,validation:f,...p})=>{let m=r(),h=o(a),{ariaInvalid:g,validation:_}=i({"aria-invalid":t,defaultAriaInvalid:!1,validation:f??m});return s(u,{ref:d,"aria-invalid":g,"data-slot":`otp-input`,containerClassName:e(`flex items-center gap-2 has-disabled:opacity-50`,l),className:e(`disabled:cursor-not-allowed`,c),...p,...h?{"aria-describedby":h[`aria-describedby`],"aria-errormessage":h[`aria-errormessage`],id:h.id,name:h.name}:void 0,children:s(y,{validation:_,children:n})})},Group:({asChild:n,children:r,className:i,ref:a,...o})=>s(n?t:`div`,{ref:a,"data-slot":`otp-input-group`,className:e(`relative flex items-center rounded-md`,`has-[[data-active]~[data-active]]:ring-focus-accent has-[[data-active]~[data-active]]:ring-4`,`group-data-validation/otp:has-[[data-active]~[data-active]]:ring-(--otp-validation-ring)`,i),...o,children:r}),Slot:({className:t,index:n,ref:r,...i})=>{let a=o(d).slots[n],l=a?.char??null,u=a?.hasFakeCaret??!1;return c(`div`,{ref:r,"data-slot":`otp-input-slot`,"data-active":a?.isActive??!1?``:void 0,className:e(`border-form bg-form text-strong relative flex h-10 w-10 items-center justify-center border-y border-r text-sm shadow-sm outline-hidden transition-all duration-150 ease-out`,`first:rounded-l-md first:border-l last:rounded-r-md`,`[&:has(+[data-active])]:group-data-[otp-state=caret]/otp:border-r-transparent`,`data-active:group-data-[otp-state=caret]/otp:border-accent-600`,`data-active:group-data-[otp-state=caret]/otp:border-l`,`data-active:group-data-[otp-state=caret]/otp:ring-focus-accent`,`data-active:group-data-[otp-state=caret]/otp:z-20`,`data-active:group-data-[otp-state=caret]/otp:ring-4`,`group-data-[otp-state=all]/otp:border-accent-600`,`group-data-validation/otp:border-y-(--otp-validation-border)`,`group-data-validation/otp:first:border-l-(--otp-validation-border)`,`group-data-validation/otp:last:border-r-(--otp-validation-border)`,`group-data-validation/otp:data-active:group-data-[otp-state=caret]/otp:border-(--otp-validation-border)`,`group-data-validation/otp:data-active:group-data-[otp-state=caret]/otp:ring-(--otp-validation-ring)`,`group-data-validation/otp:group-data-[otp-state=all]/otp:border-(--otp-validation-border)`,t),...i,children:[l,u&&s(`div`,{className:`pointer-events-none absolute inset-0 flex items-center justify-center`,children:s(`div`,{className:`bg-strong h-4 w-px animate-pulse`})})]})},Separator:({asChild:n,children:r,className:i,ref:a,semantic:o=!1,...c})=>{let u=n?t:`div`,d=o?{role:`separator`}:{"aria-hidden":!0,role:`none`};return s(u,{ref:a,"data-slot":`otp-input-separator`,className:e(`text-separator flex items-center`,i),...d,...c,children:r??s(l,{weight:`bold`})})}};export{b as OtpInput,f as REGEXP_ONLY_CHARS,p as REGEXP_ONLY_DIGITS,m as REGEXP_ONLY_DIGITS_AND_CHARS};
+import{t as e}from"./cx-IiQEAKf5.js";import{t}from"./slot-DpNWVci8.js";import{t as n}from"./types-D85fCNV3.js";import{a as r,r as i}from"./field-Bpptk_9t.js";import{t as a}from"./field-B1wqeZr4.js";import{useContext as o}from"react";import{jsx as s,jsxs as c}from"react/jsx-runtime";import{MinusIcon as l}from"@phosphor-icons/react/Minus";import{OTPInput as u,OTPInputContext as d,REGEXP_ONLY_CHARS as f,REGEXP_ONLY_DIGITS as p,REGEXP_ONLY_DIGITS_AND_CHARS as m}from"input-otp";const h={error:`danger`,success:`success`,warning:`warning`},g=e=>`var(--color-${e}-600)`,_=e=>`var(--ring-color-focus-${e})`,v=({totalActive:e,total:t})=>e===0?`idle`:e===1?`caret`:e===t?`all`:`range`,y=({children:e,validation:t})=>{let r=o(d),i=r.slots.length,a=r.slots.reduce((e,t)=>e+ +!!t.isActive,0),c=v({totalActive:a,total:i}),l=t?h[t]:void 0,u=l?n({"--otp-validation-border":g(l),"--otp-validation-ring":_(l)}):void 0;return s(`div`,{className:`group/otp contents`,"data-otp-state":c,"data-validation":t||void 0,style:u,children:e})},b={Root:({"aria-invalid":t,children:n,className:c,containerClassName:l,ref:d,validation:f,...p})=>{let m=r(),h=o(a),{ariaInvalid:g,validation:_}=i({"aria-invalid":t,defaultAriaInvalid:!1,validation:f??m});return s(u,{ref:d,"aria-invalid":g,"data-slot":`otp-input`,containerClassName:e(`flex items-center gap-2 has-disabled:opacity-50`,l),className:e(`disabled:cursor-not-allowed`,c),...p,...h?{"aria-describedby":h[`aria-describedby`],"aria-errormessage":h[`aria-errormessage`],id:h.id,name:h.name}:void 0,children:s(y,{validation:_,children:n})})},Group:({asChild:n,children:r,className:i,ref:a,...o})=>s(n?t:`div`,{ref:a,"data-slot":`otp-input-group`,className:e(`relative flex items-center rounded-md`,`has-[[data-active]~[data-active]]:ring-focus-accent has-[[data-active]~[data-active]]:ring-4`,`group-data-validation/otp:has-[[data-active]~[data-active]]:ring-(--otp-validation-ring)`,i),...o,children:r}),Slot:({className:t,index:n,ref:r,...i})=>{let a=o(d).slots[n],l=a?.char??null,u=a?.hasFakeCaret??!1,f=a?.isActive??!1;return c(`div`,{ref:r,"data-slot":`otp-input-slot`,"data-active":f?``:void 0,className:e(`border-form bg-form text-strong relative flex h-10 w-10 items-center justify-center border-y border-r text-sm shadow-sm outline-hidden transition-all duration-150 ease-out`,`first:rounded-l-md first:border-l last:rounded-r-md`,`[&:has(+[data-active])]:group-data-[otp-state=caret]/otp:border-r-transparent`,`data-active:group-data-[otp-state=caret]/otp:border-accent-600`,`data-active:group-data-[otp-state=caret]/otp:border-l`,`data-active:group-data-[otp-state=caret]/otp:ring-focus-accent`,`data-active:group-data-[otp-state=caret]/otp:z-20`,`data-active:group-data-[otp-state=caret]/otp:ring-4`,`group-data-[otp-state=all]/otp:border-accent-600`,`group-data-validation/otp:border-y-(--otp-validation-border)`,`group-data-validation/otp:first:border-l-(--otp-validation-border)`,`group-data-validation/otp:last:border-r-(--otp-validation-border)`,`group-data-validation/otp:data-active:group-data-[otp-state=caret]/otp:border-(--otp-validation-border)`,`group-data-validation/otp:data-active:group-data-[otp-state=caret]/otp:ring-(--otp-validation-ring)`,`group-data-validation/otp:group-data-[otp-state=all]/otp:border-(--otp-validation-border)`,t),...i,children:[l,u&&s(`div`,{className:`pointer-events-none absolute inset-0 flex items-center justify-center`,children:s(`div`,{className:`bg-strong h-4 w-px animate-pulse`})})]})},Separator:({asChild:n,children:r,className:i,ref:a,semantic:o=!1,...c})=>{let u=n?t:`div`,d=o?{role:`separator`}:{"aria-hidden":!0,role:`none`};return s(u,{ref:a,"data-slot":`otp-input-separator`,className:e(`text-separator flex items-center`,i),...d,...c,children:r??s(l,{weight:`bold`})})}};export{b as OtpInput,f as REGEXP_ONLY_CHARS,p as REGEXP_ONLY_DIGITS,m as REGEXP_ONLY_DIGITS_AND_CHARS};

package/dist/pagination.d.ts

@@ -1,5 +1,5 @@
-import { t as ButtonGroup } from "./button-C-gMbPso.js";
-import { t as Select } from "./select-0z7HVS6r.js";
+import { t as ButtonGroup } from "./button-BIf69CSV.js";
+import { t as Select } from "./select-DVHmgih8.js";
 import { ComponentProps } from "react";
 //#region src/components/pagination/cursor-pagination.d.ts
 type CursorPaginationProps = ComponentProps<"div"> & {

package/dist/pagination.js

@@ -1 +1 @@
-import{t as e}from"./cx-IiQEAKf5.js";import{t}from"./button-C0S8RbaJ.js";import{t as n}from"./button-BO2CKsz6.js";import{n as r}from"./separator-BepAcFFy.js";import{t as i}from"./select-B-9yWrif.js";import{createContext as a,useContext as o,useEffect as s,useMemo as c,useState as l}from"react";import u from"tiny-invariant";import{jsx as d,jsxs as f}from"react/jsx-runtime";import{CaretRightIcon as p}from"@phosphor-icons/react/CaretRight";import{CaretLeftIcon as m}from"@phosphor-icons/react/CaretLeft";const h=a(void 0),g=({className:t,children:n,defaultPageSize:r,ref:i,...a})=>{let[o,s]=l(r),u=c(()=>({defaultPageSize:r,pageSize:o,setPageSize:s}),[r,o]);return d(h.Provider,{value:u,children:d(`div`,{"data-slot":`cursor-pagination`,className:e(`inline-flex items-center justify-between gap-2`,t),ref:i,...a,children:n})})},_=({hasNextPage:e,hasPreviousPage:i,onNextPage:a,onPreviousPage:o,ref:s,...c})=>f(n,{"data-slot":`cursor-pagination-buttons`,appearance:`panel`,ref:s,...c,children:[d(t,{"data-slot":`cursor-pagination-previous`,appearance:`ghost`,disabled:!i,icon:d(m,{}),intent:`neutral`,label:`Previous page`,onClick:o,size:`sm`,type:`button`}),d(r,{"data-slot":`cursor-pagination-separator`,orientation:`vertical`,className:`min-h-5`}),d(t,{"data-slot":`cursor-pagination-next`,appearance:`ghost`,disabled:!e,icon:d(p,{}),intent:`neutral`,label:`Next page`,onClick:a,size:`sm`,type:`button`})]}),v=[5,10,20,50,100],y=({className:t,pageSizes:n=v,onChangePageSize:r,ref:a,...s})=>{let c=o(h);return u(c,`CursorPageSizeSelect must be used as a child of a CursorPagination component`),u(n.includes(c.defaultPageSize),`CursorPagination.defaultPageSize must be included in CursorPageSizeSelect.pageSizes`),u(n.includes(c.pageSize),`CursorPagination.pageSize must be included in CursorPageSizeSelect.pageSizes`),f(i.Root,{defaultValue:`${c.pageSize}`,onValueChange:e=>{let t=Number.parseInt(e,10);Number.isNaN(t)&&(t=c.defaultPageSize),c.setPageSize(t),r?.(t)},children:[d(i.Trigger,{ref:a,"data-slot":`cursor-pagination-page-size-select`,className:e(`w-auto min-w-36`,t),value:c.pageSize,...s,children:d(i.Value,{})}),d(i.Content,{width:`trigger`,children:n.map(e=>f(i.Item,{value:`${e}`,children:[e,` per page`]},e))})]})};function b({className:t,...n}){let r=o(h);return u(r,`CursorPageSizeValue must be used as a child of a CursorPagination component`),f(`span`,{"data-slot":`cursor-pagination-page-size-value`,className:e(`text-muted text-sm font-normal`,t),...n,children:[r.pageSize,` per page`]})}const x={Root:g,Buttons:_,PageSizeSelect:y,PageSizeValue:b};function S({listSize:e,pageSize:t}){let[n,r]=l(1),[i,a]=l(t);s(()=>{a(t),r(1)},[t]),s(()=>{r(1)},[e]);let o=Math.ceil(e/i),c=(n-1)*i,u=n>1,d=n<o;function f(e){r(Math.max(1,Math.min(e,o)))}function p(){d&&r(e=>Math.min(e+1,o))}function m(){u&&r(e=>Math.max(e-1,1))}function h(e){a(e),r(1)}function g(){r(o)}function _(){r(1)}return{currentPage:n,goToFirstPage:_,goToLastPage:g,goToPage:f,hasNextPage:d,hasPreviousPage:u,nextPage:p,offset:c,pageSize:i,previousPage:m,setPageSize:h,totalPages:o}}function C(e,t){return e.slice(t.offset,t.offset+t.pageSize)}export{x as CursorPagination,C as getOffsetPaginatedSlice,S as useOffsetPagination};
+import{t as e}from"./cx-IiQEAKf5.js";import{t}from"./button-CCkGqE1t.js";import{t as n}from"./button-DmJkYfyl.js";import{n as r}from"./separator-D0D6VyyM.js";import{t as i}from"./select-LK9NX-vV.js";import{createContext as a,useContext as o,useEffect as s,useMemo as c,useState as l}from"react";import u from"tiny-invariant";import{jsx as d,jsxs as f}from"react/jsx-runtime";import{CaretRightIcon as p}from"@phosphor-icons/react/CaretRight";import{CaretLeftIcon as m}from"@phosphor-icons/react/CaretLeft";const h=a(void 0),g=({className:t,children:n,defaultPageSize:r,ref:i,...a})=>{let[o,s]=l(r),u=c(()=>({defaultPageSize:r,pageSize:o,setPageSize:s}),[r,o]);return d(h.Provider,{value:u,children:d(`div`,{"data-slot":`cursor-pagination`,className:e(`inline-flex items-center justify-between gap-2`,t),ref:i,...a,children:n})})},_=({hasNextPage:e,hasPreviousPage:i,onNextPage:a,onPreviousPage:o,ref:s,...c})=>f(n,{"data-slot":`cursor-pagination-buttons`,appearance:`panel`,ref:s,...c,children:[d(t,{"data-slot":`cursor-pagination-previous`,appearance:`ghost`,disabled:!i,icon:d(m,{}),intent:`neutral`,label:`Previous page`,onClick:o,size:`sm`,type:`button`}),d(r,{"data-slot":`cursor-pagination-separator`,orientation:`vertical`,className:`min-h-5`}),d(t,{"data-slot":`cursor-pagination-next`,appearance:`ghost`,disabled:!e,icon:d(p,{}),intent:`neutral`,label:`Next page`,onClick:a,size:`sm`,type:`button`})]}),v=[5,10,20,50,100],y=({className:t,pageSizes:n=v,onChangePageSize:r,ref:a,...s})=>{let c=o(h);return u(c,`CursorPageSizeSelect must be used as a child of a CursorPagination component`),u(n.includes(c.defaultPageSize),`CursorPagination.defaultPageSize must be included in CursorPageSizeSelect.pageSizes`),u(n.includes(c.pageSize),`CursorPagination.pageSize must be included in CursorPageSizeSelect.pageSizes`),f(i.Root,{defaultValue:`${c.pageSize}`,onValueChange:e=>{let t=Number.parseInt(e,10);Number.isNaN(t)&&(t=c.defaultPageSize),c.setPageSize(t),r?.(t)},children:[d(i.Trigger,{ref:a,"data-slot":`cursor-pagination-page-size-select`,className:e(`w-auto min-w-36`,t),value:c.pageSize,...s,children:d(i.Value,{})}),d(i.Content,{width:`trigger`,children:n.map(e=>f(i.Item,{value:`${e}`,children:[e,` per page`]},e))})]})};function b({className:t,...n}){let r=o(h);return u(r,`CursorPageSizeValue must be used as a child of a CursorPagination component`),f(`span`,{"data-slot":`cursor-pagination-page-size-value`,className:e(`text-muted text-sm font-normal`,t),...n,children:[r.pageSize,` per page`]})}const x={Root:g,Buttons:_,PageSizeSelect:y,PageSizeValue:b};function S({listSize:e,pageSize:t}){let[n,r]=l(1),[i,a]=l(t);s(()=>{a(t),r(1)},[t]),s(()=>{r(1)},[e]);let o=Math.ceil(e/i),c=(n-1)*i,u=n>1,d=n<o;function f(e){r(Math.max(1,Math.min(e,o)))}function p(){d&&r(e=>Math.min(e+1,o))}function m(){u&&r(e=>Math.max(e-1,1))}function h(e){a(e),r(1)}function g(){r(o)}function _(){r(1)}return{currentPage:n,goToFirstPage:_,goToLastPage:g,goToPage:f,hasNextPage:d,hasPreviousPage:u,nextPage:p,offset:c,pageSize:i,previousPage:m,setPageSize:h,totalPages:o}}function C(e,t){return e.slice(t.offset,t.offset+t.pageSize)}export{x as CursorPagination,C as getOffsetPaginatedSlice,S as useOffsetPagination};

package/dist/{primitive-Dv-3snU3.js → primitive-D-9GIFWb.js}

@@ -1 +1 @@
-import{t as e}from"./slot-Dpsqz16D.js";import{t}from"./booleanish-BfvnW6vy.js";import{createContext as n,useContext as r,useEffect as i,useMemo as a,useState as o}from"react";import{jsx as s}from"react/jsx-runtime";import*as c from"@radix-ui/react-dialog";function l(e){e.target instanceof Element&&e.target.closest(`.overlay-prompt`)&&e.preventDefault()}const u=n({hasDescription:!1,setHasDescription:()=>{}});function d(e){let[t,n]=o(!1),r=a(()=>({hasDescription:t,setHasDescription:n}),[t]);return s(u.Provider,{value:r,children:s(c.Root,{...e})})}const f=c.Trigger,p=c.Portal,m=c.Close,h=e=>s(c.Overlay,{"data-overlay":!0,...e}),g=({onEscapeKeyDown:e,onInteractOutside:t,onPointerDownOutside:n,ref:i,...a})=>{let o=r(u);return s(c.Content,{ref:i,onEscapeKeyDown:t=>{b(t),e?.(t)},onInteractOutside:e=>{l(e),t?.(e)},onPointerDownOutside:e=>{l(e),n?.(e)},...o.hasDescription?{}:{"aria-describedby":void 0},...a})},_=c.Title,v=({asChild:t,children:n,ref:a,...o})=>{let l=r(u);i(()=>(l.setHasDescription(!0),()=>l.setHasDescription(!1)),[l]);let d=t?e:`div`;return s(c.Description,{ref:a,asChild:!0,children:s(d,{...o,children:n})})};function y(e){return e instanceof HTMLElement&&e.hasAttribute(`data-overlay`)}function b(e){if(!w(e.currentTarget))return;let n=e.currentTarget,r=n instanceof Document?n.activeElement:n.ownerDocument?.activeElement??null,i=x(e.target)??x(r),a=i?S(i):null;i!=null&&t(i.getAttribute(`aria-expanded`))&&a!=null&&n.contains(i)&&n.contains(a)&&(a.getAttribute(`data-open`)===`true`||a.getAttribute(`data-state`)===`open`)&&e.preventDefault()}function x(e){return C(e)?e.closest(`[aria-expanded='true'][aria-controls]`):null}function S(e){let t=e.getAttribute(`aria-controls`);if(!t)return null;let n=e.ownerDocument.getElementById(t);return n instanceof HTMLElement?n:null}function C(e){return e instanceof HTMLElement}function w(e){return e instanceof Node&&`querySelector`in e}export{p as a,f as c,h as i,y as l,g as n,d as o,v as r,_ as s,m as t};
+import{t as e}from"./slot-DpNWVci8.js";import{t}from"./booleanish-BfvnW6vy.js";import{createContext as n,useContext as r,useEffect as i,useMemo as a,useState as o}from"react";import{jsx as s}from"react/jsx-runtime";import*as c from"@radix-ui/react-dialog";function l(e){e.target instanceof Element&&e.target.closest(`.overlay-prompt`)&&e.preventDefault()}const u=n({hasDescription:!1,setHasDescription:()=>{}});function d(e){let[t,n]=o(!1),r=a(()=>({hasDescription:t,setHasDescription:n}),[t]);return s(u.Provider,{value:r,children:s(c.Root,{...e})})}const f=c.Trigger,p=c.Portal,m=c.Close,h=e=>s(c.Overlay,{"data-overlay":!0,...e}),g=({onEscapeKeyDown:e,onInteractOutside:t,onPointerDownOutside:n,ref:i,...a})=>{let o=r(u);return s(c.Content,{ref:i,onEscapeKeyDown:t=>{b(t),e?.(t)},onInteractOutside:e=>{l(e),t?.(e)},onPointerDownOutside:e=>{l(e),n?.(e)},...o.hasDescription?{}:{"aria-describedby":void 0},...a})},_=c.Title,v=({asChild:t,children:n,ref:a,...o})=>{let l=r(u);i(()=>(l.setHasDescription(!0),()=>l.setHasDescription(!1)),[l]);let d=t?e:`div`;return s(c.Description,{ref:a,asChild:!0,children:s(d,{...o,children:n})})};function y(e){return e instanceof HTMLElement&&e.hasAttribute(`data-overlay`)}function b(e){if(!w(e.currentTarget))return;let n=e.currentTarget,r=n instanceof Document?n.activeElement:n.ownerDocument?.activeElement??null,i=x(e.target)??x(r),a=i?S(i):null;i!=null&&t(i.getAttribute(`aria-expanded`))&&a!=null&&n.contains(i)&&n.contains(a)&&(a.getAttribute(`data-open`)===`true`||a.getAttribute(`data-state`)===`open`)&&e.preventDefault()}function x(e){return C(e)?e.closest(`[aria-expanded='true'][aria-controls]`):null}function S(e){let t=e.getAttribute(`aria-controls`);if(!t)return null;let n=e.ownerDocument.getElementById(t);return n instanceof HTMLElement?n:null}function C(e){return e instanceof HTMLElement}function w(e){return e instanceof Node&&`querySelector`in e}export{p as a,f as c,h as i,y as l,g as n,d as o,v as r,_ as s,m as t};

package/dist/progress.d.ts

@@ -26,8 +26,8 @@ type Props = SvgAttributes & {
   strokeWidth?: StrokeWidth;
   /**
    * The current value of the progress bar.
-   * This attribute specifies how much of the task that has been completed.
-   * It must be a valid floating point number between 0 and max, or between 0 and 100 if max is omitted.
+   * This attribute specifies how much of the task is complete.
+   * It must be a valid floating point number between 0 and `max`, or, when `max` is omitted, between 0 and 100.
    * If set to `"indeterminate"`, the progress bar is considered indeterminate.
    *
    * @default 0
@@ -159,8 +159,8 @@ type RootProps = ComponentProps<"div"> & {
   max?: number | undefined;
   /**
    * The current value of the progress bar.
-   * This attribute specifies how much of the task that has been completed.
-   * It must be a valid floating point number between 0 and max, or between 0 and 100 if max is omitted.
+   * This attribute specifies how much of the task is complete.
+   * It must be a valid floating point number between 0 and `max`, or, when `max` is omitted, between 0 and 100.
    * If set to `"indeterminate"`, the progress bar is considered indeterminate. (for now there is no visual difference than 0)
    *
    * @default 0

package/dist/qr-code.d.ts

@@ -143,8 +143,8 @@ declare const Overlay: ({ asChild, className, ref, ...props }: QrCodeOverlayProp
 /**
  * A QR code. Compose `QrCode.Root` with a `QrCode.Frame` wrapping a
  * `QrCode.Pattern`, and optionally a `QrCode.Overlay` for a centered logo.
- * Encoding is handled by the dependency-free `uqr` library; the render logic is
- * owned by mantle (no headless runtime).
+ * The dependency-free `uqr` library encodes `value`; mantle owns the render
+ * logic (no headless runtime).
  *
  * `Root` and `Overlay` support the `asChild` prop for polymorphic composition.
  * `Frame` and `Pattern` render fixed SVG elements and do not.

package/dist/qr-code.js

@@ -1 +1 @@
-import{t as e}from"./cx-IiQEAKf5.js";import{t}from"./slot-Dpsqz16D.js";import{createContext as n,useContext as r,useMemo as i}from"react";import a from"tiny-invariant";import{jsx as o}from"react/jsx-runtime";import{encode as s}from"uqr";const c=n(null);function l(e,t){a(Number.isFinite(e)&&e>0,"`QrCode.Root` pixelSize must be a finite number greater than 0."),a(Number.isInteger(t)&&t>=0,"`QrCode.Root` quietZone must be a non-negative integer.")}function u(){let e=r(c);return a(e,"`QrCode.Frame` and `QrCode.Pattern` must be rendered inside a `QrCode.Root`."),e}function d(e,t){let n=[];return e.forEach((e,r)=>{e.forEach((e,i)=>{if(e){let e=i*t,a=r*t;n.push(`M${e},${a}h${t}v${t}h-${t}z`)}})}),n.join(``)}const f={Root:({value:n,ecc:r=`L`,pixelSize:a=10,quietZone:u=4,asChild:f,className:p,children:m,ref:h,...g})=>{l(a,u);let _=i(()=>s(n,{ecc:r,border:u}),[n,r,u]),v=i(()=>d(_.data,a),[_,a]),y=i(()=>({path:v,dimension:_.size*a}),[v,_.size,a]),b=f?t:`div`;return o(c.Provider,{value:y,children:o(b,{ref:h,...g,"data-slot":`qr-code`,className:e(`relative inline-flex bg-static-white text-static-black`,p),children:m})})},Frame:({className:t,children:n,ref:r,...i})=>{let{dimension:a}=u();return o(`svg`,{ref:r,...i,"data-slot":`qr-code-frame`,xmlns:`http://www.w3.org/2000/svg`,viewBox:`0 0 ${a} ${a}`,shapeRendering:`crispEdges`,className:e(`block size-48`,t),children:n})},Pattern:({className:t,ref:n,...r})=>{let{path:i}=u();return o(`path`,{ref:n,...r,"data-slot":`qr-code-pattern`,d:i,className:e(`fill-static-black`,t)})},Overlay:({asChild:n,className:r,ref:i,...a})=>o(n?t:`div`,{ref:i,...a,"data-slot":`qr-code-overlay`,className:e(`absolute left-1/2 top-1/2 flex -translate-x-1/2 -translate-y-1/2 items-center justify-center rounded-md bg-static-white text-static-black p-1.5`,r)})};export{f as QrCode};
+import{t as e}from"./cx-IiQEAKf5.js";import{t}from"./slot-DpNWVci8.js";import{createContext as n,useContext as r,useMemo as i}from"react";import a from"tiny-invariant";import{jsx as o}from"react/jsx-runtime";import{encode as s}from"uqr";const c=n(null);function l(e,t){a(Number.isFinite(e)&&e>0,"`QrCode.Root` pixelSize must be a finite number greater than 0."),a(Number.isInteger(t)&&t>=0,"`QrCode.Root` quietZone must be a non-negative integer.")}function u(){let e=r(c);return a(e,"`QrCode.Frame` and `QrCode.Pattern` must be rendered inside a `QrCode.Root`."),e}function d(e,t){let n=[];return e.forEach((e,r)=>{e.forEach((e,i)=>{if(e){let e=i*t,a=r*t;n.push(`M${e},${a}h${t}v${t}h-${t}z`)}})}),n.join(``)}const f={Root:({value:n,ecc:r=`L`,pixelSize:a=10,quietZone:u=4,asChild:f,className:p,children:m,ref:h,...g})=>{l(a,u);let _=i(()=>s(n,{ecc:r,border:u}),[n,r,u]),v=i(()=>d(_.data,a),[_,a]),y=i(()=>({path:v,dimension:_.size*a}),[v,_.size,a]),b=f?t:`div`;return o(c.Provider,{value:y,children:o(b,{ref:h,...g,"data-slot":`qr-code`,className:e(`relative inline-flex bg-static-white text-static-black`,p),children:m})})},Frame:({className:t,children:n,ref:r,...i})=>{let{dimension:a}=u();return o(`svg`,{ref:r,...i,"data-slot":`qr-code-frame`,xmlns:`http://www.w3.org/2000/svg`,viewBox:`0 0 ${a} ${a}`,shapeRendering:`crispEdges`,className:e(`block size-48`,t),children:n})},Pattern:({className:t,ref:n,...r})=>{let{path:i}=u();return o(`path`,{ref:n,...r,"data-slot":`qr-code-pattern`,d:i,className:e(`fill-static-black`,t)})},Overlay:({asChild:n,className:r,ref:i,...a})=>o(n?t:`div`,{ref:i,...a,"data-slot":`qr-code-overlay`,className:e(`absolute left-1/2 top-1/2 flex -translate-x-1/2 -translate-y-1/2 items-center justify-center rounded-md bg-static-white text-static-black p-1.5`,r)})};export{f as QrCode};

package/dist/radio-group.js

@@ -1 +1 @@
-import{t as e}from"./cx-IiQEAKf5.js";import{t}from"./slot-Dpsqz16D.js";import{t as n}from"./clsx-DUGZgXfJ.js";import{t as r}from"./field-B1wqeZr4.js";import{t as i}from"./input-CXmS0OFN.js";import{Children as a,cloneElement as o,createContext as s,isValidElement as c,useContext as l,useRef as u}from"react";import{jsx as d}from"react/jsx-runtime";import{Radio as f,RadioGroup as p}from"@headlessui/react";const m=({ref:e,...t})=>d(p,{"data-slot":`radio-group`,...t,ref:e}),h=s({autofocus:!1,checked:!1,disabled:!1,focus:!1,hover:!1}),g=({children:t,className:n,ref:i,...a})=>{let o=l(r);return d(f,{"data-slot":`radio-group-item`,className:e(`group/radio cursor-pointer aria-disabled:cursor-default [&_label]:cursor-inherit flex gap-2 py-1 text-sm focus:outline-hidden`,n),as:`div`,...a,...o?{"aria-describedby":o[`aria-describedby`],"aria-errormessage":o[`aria-errormessage`],"aria-invalid":o[`aria-invalid`]}:void 0,ref:i,children:e=>d(h.Provider,{value:e,children:t})})},_=({checked:t,disabled:n,focus:r,hover:i})=>d(`span`,{className:e(`border-form flex size-4 items-center justify-center rounded-full border shrink-0`,n&&`cursor-default opacity-50`,t&&`border-accent-600 bg-accent-600`,r&&!n&&`border-accent-600 ring-focus-accent ring-4`,i&&`border-accent-600`),children:t&&d(`span`,{className:`size-2 rounded-full bg-white shrink-0`})}),v={Button:({children:t,className:n,ref:i,...a})=>{let o=l(r);return d(f,{as:`div`,"data-slot":`radio-group-button`,className:e(`group/radio border-form [&_label]:cursor-inherit relative flex flex-1 select-none items-center justify-center gap-2 border px-3 text-sm`,`h-9`,`focus-visible:ring-focus-accent not-aria-disabled:focus-visible:border-accent-600 focus-visible:ring-4`,`cursor-pointer aria-disabled:cursor-default focus:outline-hidden`,`first-of-type:rounded-bl-md first-of-type:rounded-tl-md last-of-type:rounded-br-md last-of-type:rounded-tr-md`,`not-aria-disabled:hover:z-1 not-aria-disabled:hover:border-accent-600 aria-disabled:opacity-50`,`aria-checked:z-1 aria-checked:border-accent-600/40 aria-checked:bg-accent-500/10 not-aria-disabled:hover:aria-checked:border-accent-600`,`has-[.radio-indicator:first-child]:pl-2 has-[.radio-indicator:last-child]:pr-2`,n),ref:i,...a,...o?{"aria-describedby":o[`aria-describedby`],"aria-errormessage":o[`aria-errormessage`],"aria-invalid":o[`aria-invalid`]}:void 0,children:e=>d(h.Provider,{value:e,children:t})})},ButtonGroup:({className:e,ref:t,...r})=>d(m,{"data-slot":`radio-group-button-group`,className:n(`flex flex-row flex-nowrap -space-x-px`,e),...r,ref:t}),Card:({children:e,className:t,ref:i,...a})=>{let o=l(r);return d(f,{as:`div`,"data-slot":`radio-group-card`,className:n(`group/radio border-card bg-card [&_label]:cursor-inherit relative rounded-md border p-4 text-sm`,`cursor-pointer aria-disabled:cursor-default focus:outline-hidden`,`focus-visible:ring-focus-accent not-aria-disabled:focus-visible:border-accent-600 focus-visible:ring-4`,`first-of-type:rounded-tl-md first-of-type:rounded-tr-md last-of-type:rounded-bl-md last-of-type:rounded-br-md`,`aria-disabled:border-form/50 not-aria-disabled:hover:z-1 not-aria-disabled:hover:border-accent-600`,`aria-checked:z-1 aria-checked:border-accent-600/50 aria-checked:bg-accent-500/10 not-aria-disabled:hover:aria-checked:border-accent-600 dark-high-contrast:aria-checked:border-accent-600 high-contrast:aria-checked:border-accent-600`,t),...a,...o?{"aria-describedby":o[`aria-describedby`],"aria-errormessage":o[`aria-errormessage`],"aria-invalid":o[`aria-invalid`]}:void 0,ref:i,children:t=>d(h.Provider,{value:t,children:e})})},Indicator:({children:t,className:n,...r})=>{let i=l(h);return d(`div`,{"data-slot":`radio-group-indicator`,className:e(`radio-indicator inline-flex size-5 select-none items-center justify-center shrink-0`,n),...r,children:t==null?d(_,{...i}):typeof t==`function`?t(i):t})},InputSandbox:({children:e,onClick:t,onKeyDown:n,...r})=>{let s=u(null),f=l(h),p=a.only(e),m=f.disabled||!f.checked;return d(`div`,{role:`none`,"data-slot":`radio-group-input-sandbox`,ref:s,onKeyDown:e=>{if(f.disabled){e.stopPropagation(),e.preventDefault();return}switch(e.key){case`Enter`:case`Tab`:break;default:e.stopPropagation()}n?.(e)},onClick:e=>{if(f.disabled){e.stopPropagation(),e.preventDefault();return}let n=e.target;i(n)&&window.requestAnimationFrame(()=>{n.focus()}),t?.(e)},...r,children:c(p)?o(p,{disabled:f.disabled||p.props.disabled,tabIndex:m?-1:p.props.tabIndex}):null})},Item:g,ItemContent:({asChild:e=!1,children:r,className:i,...a})=>{let o=l(h);return d(e?t:`div`,{"data-slot":`radio-group-item-content`,className:n(`min-w-0 flex-1`,o.disabled&&`opacity-50`,i),...a,children:r})},List:({className:e,ref:t,...r})=>d(m,{"data-slot":`radio-group-list`,className:n(`-space-y-px`,e),...r,ref:t}),ListItem:({children:t,className:n,ref:i,...a})=>{let o=l(r);return d(f,{as:`div`,"data-slot":`radio-group-list-item`,className:e(`group/radio border-form [&_label]:cursor-inherit relative flex select-none gap-2 border px-3 py-2 text-sm`,`cursor-pointer aria-disabled:cursor-default focus:outline-hidden`,`focus-visible:ring-focus-accent not-aria-disabled:focus-visible:border-accent-600 focus-visible:ring-4`,`first-of-type:rounded-tl-md first-of-type:rounded-tr-md last-of-type:rounded-bl-md last-of-type:rounded-br-md`,`aria-disabled:border-form/50 not-aria-disabled:hover:z-1 not-aria-disabled:hover:border-accent-600`,`aria-checked:z-1 aria-checked:border-accent-500/40 aria-checked:bg-accent-500/10 dark-high-contrast:aria-checked:border-accent-400 high-contrast:aria-checked:border-accent-400 not-aria-disabled:hover:aria-checked:border-accent-600`,`has-[.radio-indicator:first-child]:pl-2 has-[.radio-indicator:last-child]:pr-2`,n),ref:i,...a,...o?{"aria-describedby":o[`aria-describedby`],"aria-errormessage":o[`aria-errormessage`],"aria-invalid":o[`aria-invalid`]}:void 0,children:e=>d(h.Provider,{value:e,children:t})})},Root:m};export{v as RadioGroup};
+import{t as e}from"./cx-IiQEAKf5.js";import{t}from"./slot-DpNWVci8.js";import{t as n}from"./clsx-DUGZgXfJ.js";import{t as r}from"./field-B1wqeZr4.js";import{t as i}from"./input-CXmS0OFN.js";import{Children as a,cloneElement as o,createContext as s,isValidElement as c,useContext as l,useRef as u}from"react";import{jsx as d}from"react/jsx-runtime";import{Radio as f,RadioGroup as p}from"@headlessui/react";const m=({ref:e,...t})=>d(p,{"data-slot":`radio-group`,...t,ref:e}),h=s({autofocus:!1,checked:!1,disabled:!1,focus:!1,hover:!1}),g=({children:t,className:n,ref:i,...a})=>{let o=l(r);return d(f,{"data-slot":`radio-group-item`,className:e(`group/radio cursor-pointer aria-disabled:cursor-default [&_label]:cursor-inherit flex gap-2 py-1 text-sm focus:outline-hidden`,n),as:`div`,...a,...o?{"aria-describedby":o[`aria-describedby`],"aria-errormessage":o[`aria-errormessage`],"aria-invalid":o[`aria-invalid`]}:void 0,ref:i,children:e=>d(h.Provider,{value:e,children:t})})},_=({checked:t,disabled:n,focus:r,hover:i})=>d(`span`,{className:e(`border-form flex size-4 items-center justify-center rounded-full border shrink-0`,n&&`cursor-default opacity-50`,t&&`border-accent-600 bg-accent-600`,r&&!n&&`border-accent-600 ring-focus-accent ring-4`,i&&`border-accent-600`),children:t&&d(`span`,{className:`size-2 rounded-full bg-white shrink-0`})}),v={Button:({children:t,className:n,ref:i,...a})=>{let o=l(r);return d(f,{as:`div`,"data-slot":`radio-group-button`,className:e(`group/radio border-form [&_label]:cursor-inherit relative flex flex-1 select-none items-center justify-center gap-2 border px-3 text-sm`,`h-9`,`focus-visible:ring-focus-accent not-aria-disabled:focus-visible:border-accent-600 focus-visible:ring-4`,`cursor-pointer aria-disabled:cursor-default focus:outline-hidden`,`first-of-type:rounded-bl-md first-of-type:rounded-tl-md last-of-type:rounded-br-md last-of-type:rounded-tr-md`,`not-aria-disabled:hover:z-1 not-aria-disabled:hover:border-accent-600 aria-disabled:opacity-50`,`aria-checked:z-1 aria-checked:border-accent-600/40 aria-checked:bg-accent-500/10 not-aria-disabled:hover:aria-checked:border-accent-600`,`has-[.radio-indicator:first-child]:pl-2 has-[.radio-indicator:last-child]:pr-2`,n),ref:i,...a,...o?{"aria-describedby":o[`aria-describedby`],"aria-errormessage":o[`aria-errormessage`],"aria-invalid":o[`aria-invalid`]}:void 0,children:e=>d(h.Provider,{value:e,children:t})})},ButtonGroup:({className:e,ref:t,...r})=>d(m,{"data-slot":`radio-group-button-group`,className:n(`flex flex-row flex-nowrap -space-x-px`,e),...r,ref:t}),Card:({children:e,className:t,ref:i,...a})=>{let o=l(r);return d(f,{as:`div`,"data-slot":`radio-group-card`,className:n(`group/radio border-card bg-card [&_label]:cursor-inherit relative rounded-md border p-4 text-sm`,`cursor-pointer aria-disabled:cursor-default focus:outline-hidden`,`focus-visible:ring-focus-accent not-aria-disabled:focus-visible:border-accent-600 focus-visible:ring-4`,`first-of-type:rounded-tl-md first-of-type:rounded-tr-md last-of-type:rounded-bl-md last-of-type:rounded-br-md`,`aria-disabled:border-form/50 not-aria-disabled:hover:z-1 not-aria-disabled:hover:border-accent-600`,`aria-checked:z-1 aria-checked:border-accent-600/50 aria-checked:bg-accent-500/10 not-aria-disabled:hover:aria-checked:border-accent-600 dark-high-contrast:aria-checked:border-accent-600 high-contrast:aria-checked:border-accent-600`,t),...a,...o?{"aria-describedby":o[`aria-describedby`],"aria-errormessage":o[`aria-errormessage`],"aria-invalid":o[`aria-invalid`]}:void 0,ref:i,children:t=>d(h.Provider,{value:t,children:e})})},Indicator:({children:t,className:n,...r})=>{let i=l(h);return d(`div`,{"data-slot":`radio-group-indicator`,className:e(`radio-indicator inline-flex size-5 select-none items-center justify-center shrink-0`,n),...r,children:t==null?d(_,{...i}):typeof t==`function`?t(i):t})},InputSandbox:({children:e,onClick:t,onKeyDown:n,...r})=>{let s=u(null),f=l(h),p=a.only(e),m=f.disabled||!f.checked;return d(`div`,{role:`none`,"data-slot":`radio-group-input-sandbox`,ref:s,onKeyDown:e=>{if(f.disabled){e.stopPropagation(),e.preventDefault();return}switch(e.key){case`Enter`:case`Tab`:break;default:e.stopPropagation()}n?.(e)},onClick:e=>{if(f.disabled){e.stopPropagation(),e.preventDefault();return}let n=e.target;i(n)&&window.requestAnimationFrame(()=>{n.focus()}),t?.(e)},...r,children:c(p)?o(p,{disabled:f.disabled||p.props.disabled,tabIndex:m?-1:p.props.tabIndex}):null})},Item:g,ItemContent:({asChild:e=!1,children:r,className:i,...a})=>{let o=l(h);return d(e?t:`div`,{"data-slot":`radio-group-item-content`,className:n(`min-w-0 flex-1`,o.disabled&&`opacity-50`,i),...a,children:r})},List:({className:e,ref:t,...r})=>d(m,{"data-slot":`radio-group-list`,className:n(`-space-y-px`,e),...r,ref:t}),ListItem:({children:t,className:n,ref:i,...a})=>{let o=l(r);return d(f,{as:`div`,"data-slot":`radio-group-list-item`,className:e(`group/radio border-form [&_label]:cursor-inherit relative flex select-none gap-2 border px-3 py-2 text-sm`,`cursor-pointer aria-disabled:cursor-default focus:outline-hidden`,`focus-visible:ring-focus-accent not-aria-disabled:focus-visible:border-accent-600 focus-visible:ring-4`,`first-of-type:rounded-tl-md first-of-type:rounded-tr-md last-of-type:rounded-bl-md last-of-type:rounded-br-md`,`aria-disabled:border-form/50 not-aria-disabled:hover:z-1 not-aria-disabled:hover:border-accent-600`,`aria-checked:z-1 aria-checked:border-accent-500/40 aria-checked:bg-accent-500/10 dark-high-contrast:aria-checked:border-accent-400 high-contrast:aria-checked:border-accent-400 not-aria-disabled:hover:aria-checked:border-accent-600`,`has-[.radio-indicator:first-child]:pl-2 has-[.radio-indicator:last-child]:pr-2`,n),ref:i,...a,...o?{"aria-describedby":o[`aria-describedby`],"aria-errormessage":o[`aria-errormessage`],"aria-invalid":o[`aria-invalid`]}:void 0,children:e=>d(h.Provider,{value:e,children:t})})},Root:m};export{v as RadioGroup};

package/dist/sandbar.d.ts

@@ -0,0 +1,471 @@
+import { n as WithAsChild } from "./as-child-D23mGo4f.js";
+import { t as WithDataSlot } from "./data-slot-CChfb_cv.js";
+import { r as ButtonProps } from "./button-PoIujPMX.js";
+import { ComponentProps, ReactNode, Ref } from "react";
+//#region src/components/sandbar/sandbar.d.ts
+/**
+ * The imperative surface of a {@link Sandbar}, exposed via `Sandbar.Root`'s
+ * `handleRef` prop. `shake()` is a compound feedback action — it wiggles the
+ * panel (skipped under `prefers-reduced-motion`) and always pushes an
+ * assertive live-region announcement, so blocked navigation is perceivable
+ * with or without motion.
+ *
+ * @see https://mantle.ngrok.com/components/feedback/sandbar#sandbarhandle
+ *
+ * @example
+ * ```tsx
+ * const sandbarHandle = useRef<SandbarHandle>(null);
+ *
+ * // hand this to your router's guard — it owns the blocking, the bar reacts
+ * const onNavigationBlocked = () => sandbarHandle.current?.shake();
+ *
+ * <Sandbar.Root open={isDirty} handleRef={sandbarHandle}>
+ *   <Sandbar.Message>You have unsaved changes</Sandbar.Message>
+ *   <Sandbar.Actions>
+ *     <Sandbar.DiscardButton onClick={reset}>Discard</Sandbar.DiscardButton>
+ *     <Sandbar.SaveButton onClick={save} isLoading={isPending}>Save</Sandbar.SaveButton>
+ *   </Sandbar.Actions>
+ * </Sandbar.Root>
+ * ```
+ */
+type SandbarHandle = {
+  /**
+   * Signal that an action (usually navigation) was blocked because changes
+   * are still pending: wiggles the panel and announces assertively.
+   *
+   * The default announcement is save-flavored; pass `announcement` for other
+   * intents (e.g. "Publish or discard your pending items before leaving.").
+   */
+  shake: (options?: {
+    announcement?: string;
+  }) => void;
+};
+/**
+ * Props for `Sandbar.Root`. Extends `<div>` props — which target the visible
+ * panel, not the fixed-position wrapper — with the controlled `open` flag and
+ * the imperative `handleRef`. Deliberately no `asChild`: Root renders four
+ * nodes, so single-child polymorphism has no coherent meaning.
+ *
+ * @see https://mantle.ngrok.com/components/feedback/sandbar#sandbarroot
+ *
+ * @example
+ * ```tsx
+ * <Sandbar.Root open={isDirty} handleRef={sandbarHandle}>
+ *   <Sandbar.Message>You have unsaved changes</Sandbar.Message>
+ *   <Sandbar.Actions>
+ *     <Sandbar.DiscardButton onClick={reset}>Discard</Sandbar.DiscardButton>
+ *     <Sandbar.SaveButton onClick={save} isLoading={isPending}>Save</Sandbar.SaveButton>
+ *   </Sandbar.Actions>
+ * </Sandbar.Root>
+ * ```
+ */
+type SandbarRootProps = ComponentProps<"div"> & WithDataSlot & {
+  /**
+   * Whether the sandbar is showing. Controlled-only — the pending state
+   * (e.g. a form's dirty flag) lives in your app, not in the component.
+   *
+   * `Sandbar.Root` must stay mounted and be toggled with `open`, never
+   * conditionally mounted (`{isDirty && <Sandbar.Root …>}`). The
+   * screen-reader announcement only works when the internal live regions
+   * exist in the tree before the message appears. The exit animation needs
+   * the panel alive to play. A Root that mounts with `open` already true
+   * does not announce (mounting is not a live-region change).
+   */
+  open: boolean;
+  /**
+   * Receives the imperative {@link SandbarHandle}. Kept separate from `ref`
+   * (which stays the panel's DOM element, like every other mantle part) —
+   * wire it to your navigation guard's blocked callback.
+   */
+  handleRef?: Ref<SandbarHandle>;
+};
+/**
+ * The always-mounted shell of the sandbar. Renders a private viewport-fixed
+ * wrapper, two persistent visually-hidden live regions (a polite `status`
+ * announcer and an assertive `alert` announcer), and the visible panel — a
+ * floating island with `role="group"`, named by `Sandbar.Message` via
+ * `aria-labelledby` (a consumer `aria-label` wins when passed).
+ *
+ * The panel is an `invert-theme` island: it renders in the opposite theme of
+ * the page (light ⇄ dark, light-high-contrast ⇄ dark-high-contrast), and so
+ * does everything composed inside it — the blessed buttons and any custom
+ * children.
+ *
+ * `ref`, `className`, and all other props target the panel. Render it in
+ * place at the end of the form it saves — `position: fixed` changes paint
+ * position, not tab order, so Tab from the last field lands on the actions.
+ * Escape is intentionally inert (a one-keypress discard would destroy data).
+ *
+ * Data attributes stamped on the panel:
+ *
+ * | Data Attribute | Value                  | Description                                                                                                                        |
+ * | -------------- | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+ * | `data-slot`    | `"sandbar"`            | Stable styling hook for the panel. Survives `className` overrides.                                                                 |
+ * | `data-state`   | `"open"` \| `"closed"` | `"open"` only at the resting open pose — `"closed"` covers the pre-enter frame and the exit transition, which is what drives them. |
+ *
+ * @see https://mantle.ngrok.com/components/feedback/sandbar#sandbarroot
+ *
+ * @example
+ * ```tsx
+ * <Sandbar.Root open={isDirty} handleRef={sandbarHandle}>
+ *   <Sandbar.Message>You have unsaved changes</Sandbar.Message>
+ *   <Sandbar.Actions>
+ *     <Sandbar.DiscardButton onClick={reset}>Discard</Sandbar.DiscardButton>
+ *     <Sandbar.SaveButton onClick={save} isLoading={isPending}>Save</Sandbar.SaveButton>
+ *   </Sandbar.Actions>
+ * </Sandbar.Root>
+ * ```
+ */
+declare const Root: ({ "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, children, className, "data-slot": dataSlot, handleRef, onTransitionEnd, open, ref, ...props }: SandbarRootProps) => import("react").JSX.Element;
+/**
+ * Props for `Sandbar.Message`. Extends `<p>` props with `asChild`. An `id` is
+ * generated when none is passed — it is what `Sandbar.Root` points
+ * `aria-labelledby` at, so passing your own keeps that wiring intact.
+ *
+ * @see https://mantle.ngrok.com/components/feedback/sandbar#sandbarmessage
+ *
+ * @example
+ * ```tsx
+ * <Sandbar.Root open={isDirty} handleRef={sandbarHandle}>
+ *   <Sandbar.Message>You have unsaved changes</Sandbar.Message>
+ *   <Sandbar.Actions>
+ *     <Sandbar.DiscardButton onClick={reset}>Discard</Sandbar.DiscardButton>
+ *     <Sandbar.SaveButton onClick={save} isLoading={isPending}>Save</Sandbar.SaveButton>
+ *   </Sandbar.Actions>
+ * </Sandbar.Root>
+ * ```
+ */
+type SandbarMessageProps = ComponentProps<"p"> & WithAsChild & WithDataSlot;
+/**
+ * The visible pending-state text (e.g. "You have unsaved changes"). A plain
+ * paragraph: `Sandbar.Root`'s persistent announcer owns the live-region
+ * announcement, not this node. The panel's accessible name points here via
+ * `aria-labelledby`, so the group name always matches the visible text.
+ *
+ * Data attributes:
+ *
+ * | Data Attribute | Value                | Description                                                       |
+ * | -------------- | -------------------- | ----------------------------------------------------------------- |
+ * | `data-slot`    | `"sandbar-message"`  | Stable styling hook. Survives `className` overrides and `asChild`. |
+ *
+ * @see https://mantle.ngrok.com/components/feedback/sandbar#sandbarmessage
+ *
+ * @example
+ * ```tsx
+ * <Sandbar.Root open={isDirty} handleRef={sandbarHandle}>
+ *   <Sandbar.Message>You have unsaved changes</Sandbar.Message>
+ *   <Sandbar.Actions>
+ *     <Sandbar.DiscardButton onClick={reset}>Discard</Sandbar.DiscardButton>
+ *     <Sandbar.SaveButton onClick={save} isLoading={isPending}>Save</Sandbar.SaveButton>
+ *   </Sandbar.Actions>
+ * </Sandbar.Root>
+ * ```
+ */
+declare const Message: ({ asChild, className, "data-slot": dataSlot, id: propId, ref, ...props }: SandbarMessageProps) => import("react").JSX.Element;
+/**
+ * Props for `Sandbar.Actions`. Extends `<div>` props with `asChild`.
+ *
+ * @see https://mantle.ngrok.com/components/feedback/sandbar#sandbaractions
+ *
+ * @example
+ * ```tsx
+ * <Sandbar.Root open={isDirty} handleRef={sandbarHandle}>
+ *   <Sandbar.Message>You have unsaved changes</Sandbar.Message>
+ *   <Sandbar.Actions>
+ *     <Sandbar.DiscardButton onClick={reset}>Discard</Sandbar.DiscardButton>
+ *     <Sandbar.SaveButton onClick={save} isLoading={isPending}>Save</Sandbar.SaveButton>
+ *   </Sandbar.Actions>
+ * </Sandbar.Root>
+ * ```
+ */
+type SandbarActionsProps = ComponentProps<"div"> & WithAsChild & WithDataSlot;
+/**
+ * The action-button row. A plain flex container — deliberately not
+ * `role="toolbar"`, which the ARIA APG reserves for 3+ controls with roving
+ * tab stops.
+ *
+ * Data attributes:
+ *
+ * | Data Attribute | Value                | Description                                                       |
+ * | -------------- | -------------------- | ----------------------------------------------------------------- |
+ * | `data-slot`    | `"sandbar-actions"`  | Stable styling hook. Survives `className` overrides and `asChild`. |
+ *
+ * @see https://mantle.ngrok.com/components/feedback/sandbar#sandbaractions
+ *
+ * @example
+ * ```tsx
+ * <Sandbar.Root open={isDirty} handleRef={sandbarHandle}>
+ *   <Sandbar.Message>You have unsaved changes</Sandbar.Message>
+ *   <Sandbar.Actions>
+ *     <Sandbar.DiscardButton onClick={reset}>Discard</Sandbar.DiscardButton>
+ *     <Sandbar.SaveButton onClick={save} isLoading={isPending}>Save</Sandbar.SaveButton>
+ *   </Sandbar.Actions>
+ * </Sandbar.Root>
+ * ```
+ */
+declare const Actions: ({ asChild, className, "data-slot": dataSlot, ...props }: SandbarActionsProps) => import("react").JSX.Element;
+/**
+ * Props for `Sandbar.SaveButton`. Extends `Button`'s props — including
+ * `asChild` and `isLoading` — but makes `appearance` and `intent` optional
+ * with save-flavored defaults, and `children` required.
+ *
+ * @see https://mantle.ngrok.com/components/feedback/sandbar#sandbarsavebutton
+ *
+ * @example
+ * ```tsx
+ * <Sandbar.Root open={isDirty} handleRef={sandbarHandle}>
+ *   <Sandbar.Message>You have unsaved changes</Sandbar.Message>
+ *   <Sandbar.Actions>
+ *     <Sandbar.DiscardButton onClick={reset}>Discard</Sandbar.DiscardButton>
+ *     <Sandbar.SaveButton onClick={save} isLoading={isPending}>Save</Sandbar.SaveButton>
+ *   </Sandbar.Actions>
+ * </Sandbar.Root>
+ * ```
+ */
+type SandbarSaveButtonProps = Omit<ButtonProps, "appearance" | "children" | "intent"> & WithDataSlot & {
+  /**
+   * The visual style of the button.
+   * @default "filled"
+   */
+  appearance?: ButtonProps["appearance"];
+  /**
+   * The tone of the button.
+   * @default "neutral"
+   */
+  intent?: ButtonProps["intent"];
+  /**
+   * The visible action label (e.g. "Save"). Required — action labels are app
+   * voice and must be visible at the call site.
+   */
+  children: ReactNode;
+};
+/**
+ * The primary (save) action. A mantle `Button` defaulting to the system
+ * primary style (`appearance="filled" intent="neutral"`), wired into
+ * `Sandbar.Root`: while `isLoading`, Root announces "Saving changes…" via the
+ * polite live region and catches the focus drop caused by the button going
+ * natively disabled while focused.
+ *
+ * Defaults to `type="button"`; pass `type="submit"` when rendered inside the
+ * form it saves. Announce the save's resolution yourself (e.g. a success
+ * Toast) — the bar exits silently.
+ *
+ * Data attributes:
+ *
+ * | Data Attribute    | Value                     | Description                                                                                      |
+ * | ----------------- | ------------------------- | -------------------------------------------------------------------------------------------------- |
+ * | `data-slot`       | `"sandbar-save-button"`   | Stable styling hook. Replaces `Button`'s own `data-slot="button"`, as every Button wrapper does. |
+ * | `data-appearance` | the resolved `appearance` | Stamped by `Button`.                                                                             |
+ * | `data-intent`     | the resolved `intent`     | Stamped by `Button`.                                                                             |
+ * | `data-size`       | the resolved `size`       | Stamped by `Button`; absent for `appearance="link"`.                                             |
+ * | `data-disabled`   | `"true"` \| `"false"`     | Stamped by `Button`. Value-based, not presence-based — match on the value.                       |
+ * | `data-loading`    | `"true"` \| `"false"`     | Stamped by `Button`, tracking `isLoading`. Value-based, not presence-based.                      |
+ *
+ * @see https://mantle.ngrok.com/components/feedback/sandbar#sandbarsavebutton
+ *
+ * @example
+ * ```tsx
+ * <Sandbar.Root open={isDirty} handleRef={sandbarHandle}>
+ *   <Sandbar.Message>You have unsaved changes</Sandbar.Message>
+ *   <Sandbar.Actions>
+ *     <Sandbar.DiscardButton onClick={reset}>Discard</Sandbar.DiscardButton>
+ *     <Sandbar.SaveButton onClick={save} isLoading={isPending}>Save</Sandbar.SaveButton>
+ *   </Sandbar.Actions>
+ * </Sandbar.Root>
+ * ```
+ */
+declare const SaveButton: ({ appearance, children, "data-slot": dataSlot, intent, isLoading, ref, ...props }: SandbarSaveButtonProps) => import("react").JSX.Element;
+/**
+ * Props for `Sandbar.DiscardButton`. Extends `Button`'s props — including
+ * `asChild` — but makes `appearance` and `intent` optional with
+ * secondary-action defaults, and `children` required.
+ *
+ * @see https://mantle.ngrok.com/components/feedback/sandbar#sandbardiscardbutton
+ *
+ * @example
+ * ```tsx
+ * <Sandbar.Root open={isDirty} handleRef={sandbarHandle}>
+ *   <Sandbar.Message>You have unsaved changes</Sandbar.Message>
+ *   <Sandbar.Actions>
+ *     <Sandbar.DiscardButton onClick={reset}>Discard</Sandbar.DiscardButton>
+ *     <Sandbar.SaveButton onClick={save} isLoading={isPending}>Save</Sandbar.SaveButton>
+ *   </Sandbar.Actions>
+ * </Sandbar.Root>
+ * ```
+ */
+type SandbarDiscardButtonProps = Omit<ButtonProps, "appearance" | "children" | "intent"> & WithDataSlot & {
+  /**
+   * The visual style of the button.
+   * @default "outlined"
+   */
+  appearance?: ButtonProps["appearance"];
+  /**
+   * The tone of the button.
+   * @default "neutral"
+   */
+  intent?: ButtonProps["intent"];
+  /**
+   * The visible action label (e.g. "Discard"). Required — action labels are
+   * app voice and must be visible at the call site.
+   */
+  children: ReactNode;
+};
+/**
+ * The secondary (discard/reset) action. A mantle `Button` defaulting to
+ * `appearance="outlined" intent="neutral"`. Discard is destructive-ish: for
+ * large forms, consider confirming before discarding.
+ *
+ * Data attributes:
+ *
+ * | Data Attribute    | Value                      | Description                                                                                      |
+ * | ----------------- | -------------------------- | -------------------------------------------------------------------------------------------------- |
+ * | `data-slot`       | `"sandbar-discard-button"` | Stable styling hook. Replaces `Button`'s own `data-slot="button"`, as every Button wrapper does. |
+ * | `data-appearance` | the resolved `appearance`  | Stamped by `Button`.                                                                             |
+ * | `data-intent`     | the resolved `intent`      | Stamped by `Button`.                                                                             |
+ * | `data-size`       | the resolved `size`        | Stamped by `Button`; absent for `appearance="link"`.                                             |
+ * | `data-disabled`   | `"true"` \| `"false"`      | Stamped by `Button`. Value-based, not presence-based — match on the value.                       |
+ * | `data-loading`    | `"true"` \| `"false"`      | Stamped by `Button`, tracking `isLoading`. Value-based, not presence-based.                      |
+ *
+ * @see https://mantle.ngrok.com/components/feedback/sandbar#sandbardiscardbutton
+ *
+ * @example
+ * ```tsx
+ * <Sandbar.Root open={isDirty} handleRef={sandbarHandle}>
+ *   <Sandbar.Message>You have unsaved changes</Sandbar.Message>
+ *   <Sandbar.Actions>
+ *     <Sandbar.DiscardButton onClick={reset}>Discard</Sandbar.DiscardButton>
+ *     <Sandbar.SaveButton onClick={save} isLoading={isPending}>Save</Sandbar.SaveButton>
+ *   </Sandbar.Actions>
+ * </Sandbar.Root>
+ * ```
+ */
+declare const DiscardButton: ({ appearance, children, "data-slot": dataSlot, intent, ...props }: SandbarDiscardButtonProps) => import("react").JSX.Element;
+/**
+ * A persistent, decision-bearing bar that floats near the bottom edge of the
+ * viewport. It surfaces pending state — primarily a form's unsaved ("dirty")
+ * changes — and stays until the user resolves it. Toast announces something
+ * that already happened and leaves on its own; a Sandbar waits for the user's
+ * decision. When the message needs no decision, reach for Toast or Alert.
+ *
+ * The name: a sandbar is a bar that blocks navigation — exactly what this
+ * component does while changes are pending. Pair it with your app's
+ * navigation guard and call `shake()` on the {@link SandbarHandle} when a
+ * navigation attempt is blocked.
+ *
+ * @see https://mantle.ngrok.com/components/feedback/sandbar
+ *
+ * @example
+ * Composition:
+ * ```
+ * Sandbar.Root
+ * ├── Sandbar.Message
+ * └── Sandbar.Actions
+ *     ├── Sandbar.DiscardButton
+ *     └── Sandbar.SaveButton
+ * ```
+ *
+ * @example
+ * ```tsx
+ * <Sandbar.Root open={isDirty} handleRef={sandbarHandle}>
+ *   <Sandbar.Message>You have unsaved changes</Sandbar.Message>
+ *   <Sandbar.Actions>
+ *     <Sandbar.DiscardButton onClick={reset}>Discard</Sandbar.DiscardButton>
+ *     <Sandbar.SaveButton onClick={save} isLoading={isPending}>Save</Sandbar.SaveButton>
+ *   </Sandbar.Actions>
+ * </Sandbar.Root>
+ * ```
+ */
+declare const Sandbar: {
+  /**
+   * The always-mounted shell: fixed positioning, persistent live-region
+   * announcers, presence-managed panel. Toggle with the controlled `open`
+   * prop — never conditionally mount it.
+   *
+   * @see https://mantle.ngrok.com/components/feedback/sandbar#sandbarroot
+   *
+   * @example
+   * ```tsx
+   * <Sandbar.Root open={isDirty} handleRef={sandbarHandle}>
+   *   <Sandbar.Message>You have unsaved changes</Sandbar.Message>
+   *   <Sandbar.Actions>
+   *     <Sandbar.DiscardButton onClick={reset}>Discard</Sandbar.DiscardButton>
+   *     <Sandbar.SaveButton onClick={save} isLoading={isPending}>Save</Sandbar.SaveButton>
+   *   </Sandbar.Actions>
+   * </Sandbar.Root>
+   * ```
+   */
+  readonly Root: typeof Root;
+  /**
+   * The visible pending-state text. Also names the panel (via
+   * `aria-labelledby`) and feeds the polite screen-reader announcement.
+   *
+   * @see https://mantle.ngrok.com/components/feedback/sandbar#sandbarmessage
+   *
+   * @example
+   * ```tsx
+   * <Sandbar.Root open={isDirty} handleRef={sandbarHandle}>
+   *   <Sandbar.Message>You have unsaved changes</Sandbar.Message>
+   *   <Sandbar.Actions>
+   *     <Sandbar.DiscardButton onClick={reset}>Discard</Sandbar.DiscardButton>
+   *     <Sandbar.SaveButton onClick={save} isLoading={isPending}>Save</Sandbar.SaveButton>
+   *   </Sandbar.Actions>
+   * </Sandbar.Root>
+   * ```
+   */
+  readonly Message: typeof Message;
+  /**
+   * The action-button row. Holds `Sandbar.DiscardButton` and
+   * `Sandbar.SaveButton`, or your own composed `Button`s.
+   *
+   * @see https://mantle.ngrok.com/components/feedback/sandbar#sandbaractions
+   *
+   * @example
+   * ```tsx
+   * <Sandbar.Root open={isDirty} handleRef={sandbarHandle}>
+   *   <Sandbar.Message>You have unsaved changes</Sandbar.Message>
+   *   <Sandbar.Actions>
+   *     <Sandbar.DiscardButton onClick={reset}>Discard</Sandbar.DiscardButton>
+   *     <Sandbar.SaveButton onClick={save} isLoading={isPending}>Save</Sandbar.SaveButton>
+   *   </Sandbar.Actions>
+   * </Sandbar.Root>
+   * ```
+   */
+  readonly Actions: typeof Actions;
+  /**
+   * The primary (save) action — announces "Saving changes…" and keeps focus
+   * from being lost while the save is pending.
+   *
+   * @see https://mantle.ngrok.com/components/feedback/sandbar#sandbarsavebutton
+   *
+   * @example
+   * ```tsx
+   * <Sandbar.Root open={isDirty} handleRef={sandbarHandle}>
+   *   <Sandbar.Message>You have unsaved changes</Sandbar.Message>
+   *   <Sandbar.Actions>
+   *     <Sandbar.DiscardButton onClick={reset}>Discard</Sandbar.DiscardButton>
+   *     <Sandbar.SaveButton onClick={save} isLoading={isPending}>Save</Sandbar.SaveButton>
+   *   </Sandbar.Actions>
+   * </Sandbar.Root>
+   * ```
+   */
+  readonly SaveButton: typeof SaveButton;
+  /**
+   * The secondary (discard/reset) action.
+   *
+   * @see https://mantle.ngrok.com/components/feedback/sandbar#sandbardiscardbutton
+   *
+   * @example
+   * ```tsx
+   * <Sandbar.Root open={isDirty} handleRef={sandbarHandle}>
+   *   <Sandbar.Message>You have unsaved changes</Sandbar.Message>
+   *   <Sandbar.Actions>
+   *     <Sandbar.DiscardButton onClick={reset}>Discard</Sandbar.DiscardButton>
+   *     <Sandbar.SaveButton onClick={save} isLoading={isPending}>Save</Sandbar.SaveButton>
+   *   </Sandbar.Actions>
+   * </Sandbar.Root>
+   * ```
+   */
+  readonly DiscardButton: typeof DiscardButton;
+};
+//#endregion
+export { Sandbar, type SandbarActionsProps, type SandbarDiscardButtonProps, type SandbarHandle, type SandbarMessageProps, type SandbarRootProps, type SandbarSaveButtonProps };