@surdeddd/bottom-sheet 0.1.0 → 0.3.0

package/README.md

@@ -2,8 +2,8 @@
 
 > Universal, headless bottom-sheet engine. **One core, eight adapters, GPU-accelerated, fully tested.**
 
-![bundle](https://img.shields.io/badge/core-15.8%20KB%20gzip-1a1614?style=flat-square)
-![tests](https://img.shields.io/badge/tests-327%20unit-2ea44f?style=flat-square)
+![bundle](https://img.shields.io/badge/core-16.8%20KB%20gzip-1a1614?style=flat-square)
+![tests](https://img.shields.io/badge/tests-392%20unit-2ea44f?style=flat-square)
 ![ts](https://img.shields.io/badge/TypeScript-strict-3178c6?style=flat-square&logo=typescript&logoColor=white)
 ![license](https://img.shields.io/badge/license-MIT-dc3522?style=flat-square)
 
@@ -11,6 +11,12 @@ A framework-agnostic bottom-sheet primitive. Spring physics, Pointer Events,
 GPU-only motion, full keyboard a11y, hardware-back interception, multi-sheet
 stacking — and the exact same engine behind every adapter.
 
+## 🚀 [Live demo → bottom-sheet-demo.vercel.app](https://bottom-sheet-demo.vercel.app)
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Surdeddd/BottomSheet/main/docs/gifs/01-drag-to-close.gif" alt="drag to close — spring physics" width="380" />
+</p>
+
 ```
 
                        ┌───────────────────────────────────────┐
@@ -41,7 +47,7 @@ stacking — and the exact same engine behind every adapter.
 | WCAG 2.1 AA keyboard slider          | partial |         —         |     **✓**     |
 | Multi-sheet stacking                 |    —    |         —         |     **✓**     |
 | Sheet-manager registry (typed)       |    —    |         —         |     **✓**     |
-| Tests (unit + e2e)                   | partial |      partial      | **253 + 32**  |
+| Tests (unit + e2e)                   | partial |      partial      | **392 + 164**  |
 
 ## Install
 
@@ -164,7 +170,7 @@ Drop-in usage from a static HTML page. The IIFE bundle registers
   rel="stylesheet"
   href="https://unpkg.com/@surdeddd/bottom-sheet/dist/styles.css"
 />
-<script src="https://unpkg.com/@surdeddd/bottom-sheet/dist/element.iife.js"></script>
+<script src="https://unpkg.com/@surdeddd/bottom-sheet/dist/element.iife.global.js"></script>
 <bottom-sheet
   snap-points='[{"id":"min","size":96},{"id":"full","size":"85%"}]'
   initial="min"
@@ -211,23 +217,53 @@ type SnapPoint =
 
 ### Engine options
 
-| Option           | Default       | What it does                                       |
-| ---------------- | ------------- | -------------------------------------------------- |
-| `snapPoints`     | required      | Ordered list of `{ id, size }`                     |
-| `allowed`        | all ids       | Subset the sheet may settle on right now           |
-| `initial`        | first allowed | Snap id to start at                                |
-| `mode`           | `"bottom"`    | `bottom \| top \| left \| right`                   |
-| `animation`      | `"spring"`    | `spring \| tween`                                  |
-| `spring`         | snappy        | `{ stiffness, damping, mass }`                     |
-| `flickVelocity`  | `0.65 px/ms`  | Mobile flick threshold                             |
-| `dragThreshold`  | `18 px`       | Below this, drag snaps back                        |
-| `rubberBand`     | `true`        | iOS-style soft over-drag                           |
-| `backdropRange`  | `[0, 1]`      | Progress range over which backdrop fades           |
-| `focusTrap`      | `false`       | Trap Tab focus inside the sheet when open          |
-| `closeOnEscape`  | `true`        | Listen for Escape and close                        |
-| `closeOnBack`    | `false`       | Intercept Android back button (history.popstate)   |
-| `lockBodyScroll` | `true`        | iOS-safe body lock (`position: fixed`)             |
-| `inertSiblings`  | `false`       | Mark page siblings `inert` while open (full modal) |
+| Option           | Default       | What it does                                                           |
+| ---------------- | ------------- | ---------------------------------------------------------------------- |
+| `snapPoints`     | required      | Ordered list of `{ id, size }`                                         |
+| `allowed`        | all ids       | Subset the sheet may settle on right now                               |
+| `initial`        | first allowed | Snap id to start at                                                    |
+| `mode`           | `"bottom"`    | `bottom`, `top`, `left`, `right`                                       |
+| `animation`      | `"spring"`    | `spring`, `tween`, `ios-spring`, `material-bounce`, `linear`, `snappy` |
+| `spring`         | snappy        | `{ stiffness, damping, mass }`                                         |
+| `flickVelocity`  | `0.65 px/ms`  | Mobile flick threshold                                                 |
+| `dragThreshold`  | `18 px`       | Below this, drag snaps back                                            |
+| `rubberBand`     | `true`        | iOS-style soft over-drag                                               |
+| `backdropRange`  | `[0, 1]`      | Progress range over which backdrop fades                               |
+| `focusTrap`      | `false`       | Trap Tab focus inside the sheet when open                              |
+| `closeOnEscape`  | `true`        | Listen for Escape and close                                            |
+| `closeOnBack`    | `false`       | Intercept Android back button (history.popstate)                       |
+| `lockBodyScroll` | `true`        | iOS-safe body lock (`position: fixed`)                                 |
+| `stackEffect`    | `false`       | iOS card-stack: back sheets scale down per depth                       |
+| `inertSiblings`  | `false`       | Mark page siblings `inert` while open (full modal)                     |
+
+### Anchored elements, docked bars & scrim stages
+
+Pin UI around the sheet — it rides the motion on the compositor (zero JS per
+frame) and shows/hides per state with configurable animations:
+
+```ts
+engine.addAnchor({
+  element: closeBtn,
+  position: 'sheet-top-right', // rides the sheet edge; 9 screen positions too
+  showOn: ['half', 'full'],    // snap ids or a predicate
+  animation: 'pop',            // fade | scale | slide | pop | custom keyframes
+});
+
+engine.addAnchor({
+  element: tabBar,
+  position: 'dock-bottom',     // full-width bar; the sheet slides under it
+});
+
+engine.setScrimStages({
+  stages: [
+    { for: 'peek', element: teaser },
+    { forRange: [0.5, 1], element: expanded },
+  ],
+  animation: 'fade',
+});
+```
+
+[Full anchors & stages docs →](docs/anchors.md)
 
 ### Events
 

package/dist/BottomSheetEngine-CAymrH-P.d.cts

@@ -0,0 +1,285 @@
+import { T as TransformAxis } from './transform-jVfAikE9.cjs';
+
+type SnapPoint = number | `${number}%` | "fit" | "full" | (string & {});
+type SnapPointDef<Id extends string = string> = {
+    id: Id;
+    size: SnapPoint;
+};
+type SnapId<T extends readonly SnapPointDef<string>[] | {
+    snapPoints: readonly SnapPointDef<string>[];
+}> = T extends {
+    snapPoints: readonly SnapPointDef<infer U>[];
+} ? U : T extends readonly SnapPointDef<infer U>[] ? U : never;
+type SheetMode = TransformAxis;
+type ScrimPreset = "subtle" | "standard" | "monitoring" | "cinematic";
+type ScrimPresetConfig = {
+    color: string;
+    blur: string | undefined;
+    range: [number, number];
+    interactive: boolean;
+};
+declare const SCRIM_PRESETS: Readonly<Record<ScrimPreset, ScrimPresetConfig>>;
+type ScrimUpdate = {
+    color?: string | null;
+    blur?: string | null;
+    interactive?: boolean;
+    range?: [number, number];
+    preset?: ScrimPreset;
+    mode?: "full" | "above-sheet" | "off";
+    tapToClose?: boolean;
+    enabled?: boolean;
+};
+type ScrimOverlayPosition = "top-left" | "top-center" | "top-right" | "center-left" | "center" | "center-right" | "bottom-left" | "bottom-center" | "bottom-right" | "sheet-top-left" | "sheet-top-center" | "sheet-top-right";
+type ScrimOverlayOptions = {
+    children: HTMLElement | DocumentFragment;
+    position?: ScrimOverlayPosition;
+    interactive?: boolean;
+    inset?: string;
+};
+type SheetEventMap = {
+    "before-snap": {
+        id: string;
+        size: number;
+        cancel: () => void;
+        previousId: string;
+    };
+    snap: {
+        id: string;
+        size: number;
+    };
+    progress: {
+        value: number;
+        size: number;
+    };
+    dragstart: {
+        size: number;
+    };
+    drag: {
+        size: number;
+        delta: number;
+    };
+    dragend: {
+        size: number;
+        velocity: number;
+    };
+    close: void;
+    open: {
+        id: string;
+    };
+};
+type EngineOptions = {
+    element: HTMLElement;
+    handle?: HTMLElement;
+    scrollContainer?: HTMLElement;
+    backdrop?: HTMLElement;
+    scrim?: HTMLElement;
+    screenComponent?: HTMLElement;
+    mode?: SheetMode;
+    snapPoints: SnapPointDef[];
+    allowed?: string[];
+    initial?: string;
+    duration?: number;
+    easing?: (t: number) => number;
+    respectReducedMotion?: boolean;
+    flickVelocity?: number;
+    dragThreshold?: number;
+    rubberBand?: boolean;
+    backdropRange?: [number, number];
+    screenRange?: [number, number];
+    scrimMode?: "full" | "above-sheet" | "off";
+    scrimColor?: string;
+    scrimBlur?: string;
+    scrimInteractive?: boolean;
+    scrimTapToClose?: boolean;
+    scrimPreset?: ScrimPreset;
+    animation?: "spring" | "tween" | "ios-spring" | "material-bounce" | "linear" | "snappy";
+    spring?: {
+        stiffness?: number;
+        damping?: number;
+        mass?: number;
+    };
+    focusTrap?: boolean;
+    initialFocus?: string | HTMLElement;
+    closeOnEscape?: boolean;
+    lockBodyScroll?: boolean;
+    closeOnBack?: boolean;
+    routedTo?: string;
+    inertSiblings?: boolean;
+    persistKey?: string;
+    autoCollapseAfter?: number;
+    linkedSheets?: BottomSheetEngineLike[];
+    viewTransitions?: boolean;
+    stackEffect?: boolean;
+};
+
+type BottomSheetEngineLike = BottomSheetEngine;
+type TeardownScope = {
+    add: (fn: (() => void) | null | undefined) => void;
+};
+type Plugin = {
+    name: string;
+    install: (engine: BottomSheetEngine, scope: TeardownScope) => void | (() => void);
+};
+type EngineState = {
+    size: number;
+    activeId: string;
+    isDragging: boolean;
+    isAnimating: boolean;
+    progress: number;
+};
+
+type AnchorAnimationPreset = "fade" | "scale" | "slide" | "pop" | "none";
+type AnchorAnimationSpec = AnchorAnimationPreset | {
+    preset?: AnchorAnimationPreset;
+    enter?: Keyframe[];
+    exit?: Keyframe[];
+    duration?: number;
+    easing?: string;
+    respectReducedMotion?: boolean;
+};
+type AnchorTransitionHandle = {
+    finished: Promise<void>;
+    cancel: () => void;
+};
+declare function runAnchorTransition(el: HTMLElement, spec: AnchorAnimationSpec | undefined, phase: "enter" | "exit"): AnchorTransitionHandle;
+
+type AnchorState = {
+    activeId: string;
+    size: number;
+    progress: number;
+};
+type AnchorPosition = ScrimOverlayPosition | "dock-bottom" | "dock-top";
+type AnchorOptions = {
+    element: HTMLElement;
+    position?: AnchorPosition;
+    inset?: string;
+    showOn?: string[] | ((state: AnchorState) => boolean);
+    fadeRange?: [number, number];
+    interactive?: boolean;
+    animation?: AnchorAnimationSpec;
+};
+type AnchorHandle = {
+    wrapper: HTMLElement;
+    detach: () => void;
+    syncZ: (z: number) => void;
+};
+
+type ScrimStageDef = {
+    id?: string;
+    for?: string | string[];
+    forRange?: [number, number];
+    element: HTMLElement;
+    position?: ScrimOverlayPosition;
+    inset?: string;
+    interactive?: boolean;
+    animation?: AnchorAnimationSpec;
+};
+type ScrimStagesOptions = {
+    stages: ScrimStageDef[];
+    position?: ScrimOverlayPosition;
+    inset?: string;
+    interactive?: boolean;
+    animation?: AnchorAnimationSpec;
+};
+
+type Listener<K extends keyof SheetEventMap> = (payload: SheetEventMap[K]) => void;
+declare class BottomSheetEngine {
+    private id;
+    private element;
+    private handle;
+    private scrollContainer?;
+    private backdrop?;
+    private screenComponent?;
+    private scrimParent;
+    private mode;
+    private flickVelocity;
+    private dragThreshold;
+    private rubberBandEnabled;
+    private scrim;
+    private aria;
+    private animation;
+    private lifecycle;
+    private closeOnBack;
+    private routedTo;
+    private snapPointsRaw;
+    private snaps;
+    private activeId;
+    private size;
+    private gesture;
+    private rootEl;
+    private destroyed;
+    private currentViewTransition;
+    private currentAbort;
+    private sizeWriteSentinel;
+    private progressWriteSentinel;
+    private isTopSheet;
+    private progressPayload;
+    private dragContextBuf;
+    private bus;
+    private persistKey;
+    private linkedSheets;
+    private scrollCache;
+    private teardowns;
+    private anchors;
+    private anchorHost;
+    private stackZ;
+    private detachScrimStages;
+    private stackEffectEnabled;
+    private stackEffectPrimed;
+    private transformTemplate;
+    constructor(opts: EngineOptions);
+    get state(): EngineState;
+    on<K extends keyof SheetEventMap>(event: K, fn: Listener<K>): () => void;
+    use(plugin: Plugin): this;
+    setLinkedSheets(sheets: BottomSheetEngine[]): void;
+    getAllowedIds(): string[];
+    snapTo(id: string, velocityOrOpts?: number | {
+        velocity?: number;
+        signal?: AbortSignal;
+    }, _skipBeforeSnap?: boolean): Promise<void>;
+    dragTo(targetSize: number, velocityOrOpts?: number | {
+        velocity?: number;
+        signal?: AbortSignal;
+    }): Promise<void>;
+    open(id?: string): Promise<void>;
+    close(): Promise<void>;
+    setAllowed(ids: string[], snap?: string): void;
+    setBackdropRange(range: [number, number]): void;
+    setScreenRange(range: [number, number]): void;
+    setScrimColor(color: string | undefined | null): void;
+    setScrimBlur(blur: string | undefined | null): void;
+    setScrimInteractive(interactive: boolean): void;
+    setScrim(opts: ScrimUpdate): void;
+    setScrimMode(mode: "full" | "above-sheet" | "off"): void;
+    setScrimTapToClose(enabled: boolean): void;
+    setScrimEnabled(enabled: boolean): void;
+    setScrimOverlay(opts: ScrimOverlayOptions): () => void;
+    addAnchor(opts: AnchorOptions): () => void;
+    setScrimStages(opts: ScrimStagesOptions | null): () => void;
+    getScrimState(): {
+        mode: "full" | "above-sheet" | "off";
+        enabled: boolean;
+    };
+    setSnapPoints(points: EngineOptions["snapPoints"], allowed?: string[]): void;
+    destroy(): void;
+    private emit;
+    private newCycle;
+    private emitBeforeSnap;
+    private recomputeSnaps;
+    private getAllowedRange;
+    private allowedIdsBySize;
+    private updateAriaSlider;
+    private registerInStack;
+    private applyStackDepth;
+    private attach;
+    private attachFeatures;
+    private settleAfterDrag;
+    private haptic;
+    private applySize;
+    private computeProgress;
+    private handleOpen;
+    private resyncAfterResize;
+    private handleClose;
+}
+
+export { type AnchorOptions as A, BottomSheetEngine as B, type EngineState as E, type Plugin as P, type ScrimStagesOptions as S, type TeardownScope as T, type SnapPointDef as a, type SheetMode as b, type EngineOptions as c, type SnapPoint as d, type SheetEventMap as e, type ScrimOverlayPosition as f, type AnchorAnimationPreset as g, type AnchorAnimationSpec as h, type AnchorHandle as i, type AnchorPosition as j, type AnchorState as k, SCRIM_PRESETS as l, type ScrimOverlayOptions as m, type ScrimPreset as n, type ScrimPresetConfig as o, type ScrimStageDef as p, type ScrimUpdate as q, type SnapId as r, runAnchorTransition as s };

package/dist/BottomSheetEngine-DcqcuudN.d.ts

@@ -0,0 +1,285 @@
+import { T as TransformAxis } from './transform-jVfAikE9.js';
+
+type SnapPoint = number | `${number}%` | "fit" | "full" | (string & {});
+type SnapPointDef<Id extends string = string> = {
+    id: Id;
+    size: SnapPoint;
+};
+type SnapId<T extends readonly SnapPointDef<string>[] | {
+    snapPoints: readonly SnapPointDef<string>[];
+}> = T extends {
+    snapPoints: readonly SnapPointDef<infer U>[];
+} ? U : T extends readonly SnapPointDef<infer U>[] ? U : never;
+type SheetMode = TransformAxis;
+type ScrimPreset = "subtle" | "standard" | "monitoring" | "cinematic";
+type ScrimPresetConfig = {
+    color: string;
+    blur: string | undefined;
+    range: [number, number];
+    interactive: boolean;
+};
+declare const SCRIM_PRESETS: Readonly<Record<ScrimPreset, ScrimPresetConfig>>;
+type ScrimUpdate = {
+    color?: string | null;
+    blur?: string | null;
+    interactive?: boolean;
+    range?: [number, number];
+    preset?: ScrimPreset;
+    mode?: "full" | "above-sheet" | "off";
+    tapToClose?: boolean;
+    enabled?: boolean;
+};
+type ScrimOverlayPosition = "top-left" | "top-center" | "top-right" | "center-left" | "center" | "center-right" | "bottom-left" | "bottom-center" | "bottom-right" | "sheet-top-left" | "sheet-top-center" | "sheet-top-right";
+type ScrimOverlayOptions = {
+    children: HTMLElement | DocumentFragment;
+    position?: ScrimOverlayPosition;
+    interactive?: boolean;
+    inset?: string;
+};
+type SheetEventMap = {
+    "before-snap": {
+        id: string;
+        size: number;
+        cancel: () => void;
+        previousId: string;
+    };
+    snap: {
+        id: string;
+        size: number;
+    };
+    progress: {
+        value: number;
+        size: number;
+    };
+    dragstart: {
+        size: number;
+    };
+    drag: {
+        size: number;
+        delta: number;
+    };
+    dragend: {
+        size: number;
+        velocity: number;
+    };
+    close: void;
+    open: {
+        id: string;
+    };
+};
+type EngineOptions = {
+    element: HTMLElement;
+    handle?: HTMLElement;
+    scrollContainer?: HTMLElement;
+    backdrop?: HTMLElement;
+    scrim?: HTMLElement;
+    screenComponent?: HTMLElement;
+    mode?: SheetMode;
+    snapPoints: SnapPointDef[];
+    allowed?: string[];
+    initial?: string;
+    duration?: number;
+    easing?: (t: number) => number;
+    respectReducedMotion?: boolean;
+    flickVelocity?: number;
+    dragThreshold?: number;
+    rubberBand?: boolean;
+    backdropRange?: [number, number];
+    screenRange?: [number, number];
+    scrimMode?: "full" | "above-sheet" | "off";
+    scrimColor?: string;
+    scrimBlur?: string;
+    scrimInteractive?: boolean;
+    scrimTapToClose?: boolean;
+    scrimPreset?: ScrimPreset;
+    animation?: "spring" | "tween" | "ios-spring" | "material-bounce" | "linear" | "snappy";
+    spring?: {
+        stiffness?: number;
+        damping?: number;
+        mass?: number;
+    };
+    focusTrap?: boolean;
+    initialFocus?: string | HTMLElement;
+    closeOnEscape?: boolean;
+    lockBodyScroll?: boolean;
+    closeOnBack?: boolean;
+    routedTo?: string;
+    inertSiblings?: boolean;
+    persistKey?: string;
+    autoCollapseAfter?: number;
+    linkedSheets?: BottomSheetEngineLike[];
+    viewTransitions?: boolean;
+    stackEffect?: boolean;
+};
+
+type BottomSheetEngineLike = BottomSheetEngine;
+type TeardownScope = {
+    add: (fn: (() => void) | null | undefined) => void;
+};
+type Plugin = {
+    name: string;
+    install: (engine: BottomSheetEngine, scope: TeardownScope) => void | (() => void);
+};
+type EngineState = {
+    size: number;
+    activeId: string;
+    isDragging: boolean;
+    isAnimating: boolean;
+    progress: number;
+};
+
+type AnchorAnimationPreset = "fade" | "scale" | "slide" | "pop" | "none";
+type AnchorAnimationSpec = AnchorAnimationPreset | {
+    preset?: AnchorAnimationPreset;
+    enter?: Keyframe[];
+    exit?: Keyframe[];
+    duration?: number;
+    easing?: string;
+    respectReducedMotion?: boolean;
+};
+type AnchorTransitionHandle = {
+    finished: Promise<void>;
+    cancel: () => void;
+};
+declare function runAnchorTransition(el: HTMLElement, spec: AnchorAnimationSpec | undefined, phase: "enter" | "exit"): AnchorTransitionHandle;
+
+type AnchorState = {
+    activeId: string;
+    size: number;
+    progress: number;
+};
+type AnchorPosition = ScrimOverlayPosition | "dock-bottom" | "dock-top";
+type AnchorOptions = {
+    element: HTMLElement;
+    position?: AnchorPosition;
+    inset?: string;
+    showOn?: string[] | ((state: AnchorState) => boolean);
+    fadeRange?: [number, number];
+    interactive?: boolean;
+    animation?: AnchorAnimationSpec;
+};
+type AnchorHandle = {
+    wrapper: HTMLElement;
+    detach: () => void;
+    syncZ: (z: number) => void;
+};
+
+type ScrimStageDef = {
+    id?: string;
+    for?: string | string[];
+    forRange?: [number, number];
+    element: HTMLElement;
+    position?: ScrimOverlayPosition;
+    inset?: string;
+    interactive?: boolean;
+    animation?: AnchorAnimationSpec;
+};
+type ScrimStagesOptions = {
+    stages: ScrimStageDef[];
+    position?: ScrimOverlayPosition;
+    inset?: string;
+    interactive?: boolean;
+    animation?: AnchorAnimationSpec;
+};
+
+type Listener<K extends keyof SheetEventMap> = (payload: SheetEventMap[K]) => void;
+declare class BottomSheetEngine {
+    private id;
+    private element;
+    private handle;
+    private scrollContainer?;
+    private backdrop?;
+    private screenComponent?;
+    private scrimParent;
+    private mode;
+    private flickVelocity;
+    private dragThreshold;
+    private rubberBandEnabled;
+    private scrim;
+    private aria;
+    private animation;
+    private lifecycle;
+    private closeOnBack;
+    private routedTo;
+    private snapPointsRaw;
+    private snaps;
+    private activeId;
+    private size;
+    private gesture;
+    private rootEl;
+    private destroyed;
+    private currentViewTransition;
+    private currentAbort;
+    private sizeWriteSentinel;
+    private progressWriteSentinel;
+    private isTopSheet;
+    private progressPayload;
+    private dragContextBuf;
+    private bus;
+    private persistKey;
+    private linkedSheets;
+    private scrollCache;
+    private teardowns;
+    private anchors;
+    private anchorHost;
+    private stackZ;
+    private detachScrimStages;
+    private stackEffectEnabled;
+    private stackEffectPrimed;
+    private transformTemplate;
+    constructor(opts: EngineOptions);
+    get state(): EngineState;
+    on<K extends keyof SheetEventMap>(event: K, fn: Listener<K>): () => void;
+    use(plugin: Plugin): this;
+    setLinkedSheets(sheets: BottomSheetEngine[]): void;
+    getAllowedIds(): string[];
+    snapTo(id: string, velocityOrOpts?: number | {
+        velocity?: number;
+        signal?: AbortSignal;
+    }, _skipBeforeSnap?: boolean): Promise<void>;
+    dragTo(targetSize: number, velocityOrOpts?: number | {
+        velocity?: number;
+        signal?: AbortSignal;
+    }): Promise<void>;
+    open(id?: string): Promise<void>;
+    close(): Promise<void>;
+    setAllowed(ids: string[], snap?: string): void;
+    setBackdropRange(range: [number, number]): void;
+    setScreenRange(range: [number, number]): void;
+    setScrimColor(color: string | undefined | null): void;
+    setScrimBlur(blur: string | undefined | null): void;
+    setScrimInteractive(interactive: boolean): void;
+    setScrim(opts: ScrimUpdate): void;
+    setScrimMode(mode: "full" | "above-sheet" | "off"): void;
+    setScrimTapToClose(enabled: boolean): void;
+    setScrimEnabled(enabled: boolean): void;
+    setScrimOverlay(opts: ScrimOverlayOptions): () => void;
+    addAnchor(opts: AnchorOptions): () => void;
+    setScrimStages(opts: ScrimStagesOptions | null): () => void;
+    getScrimState(): {
+        mode: "full" | "above-sheet" | "off";
+        enabled: boolean;
+    };
+    setSnapPoints(points: EngineOptions["snapPoints"], allowed?: string[]): void;
+    destroy(): void;
+    private emit;
+    private newCycle;
+    private emitBeforeSnap;
+    private recomputeSnaps;
+    private getAllowedRange;
+    private allowedIdsBySize;
+    private updateAriaSlider;
+    private registerInStack;
+    private applyStackDepth;
+    private attach;
+    private attachFeatures;
+    private settleAfterDrag;
+    private haptic;
+    private applySize;
+    private computeProgress;
+    private handleOpen;
+    private resyncAfterResize;
+    private handleClose;
+}
+
+export { type AnchorOptions as A, BottomSheetEngine as B, type EngineState as E, type Plugin as P, type ScrimStagesOptions as S, type TeardownScope as T, type SnapPointDef as a, type SheetMode as b, type EngineOptions as c, type SnapPoint as d, type SheetEventMap as e, type ScrimOverlayPosition as f, type AnchorAnimationPreset as g, type AnchorAnimationSpec as h, type AnchorHandle as i, type AnchorPosition as j, type AnchorState as k, SCRIM_PRESETS as l, type ScrimOverlayOptions as m, type ScrimPreset as n, type ScrimPresetConfig as o, type ScrimStageDef as p, type ScrimUpdate as q, type SnapId as r, runAnchorTransition as s };