peachsim 0.1.1641 → 0.1.1653

package/dist-types/packages/peach-engine/src/engine/scene-table.d.ts

@@ -0,0 +1,379 @@
+import { type DamageRect } from './damage-rect.d.ts';
+import type { NativeLayoutExports } from './native-layout.d.ts';
+import type { ParsedFilterOp, SootSimLayout, SootSimStyle } from './types.d.ts';
+import type { CanvasKit, Image as SkImage, RuntimeEffect, Shader } from 'canvaskit-wasm';
+export declare const SCENE_I32_STRIDE = 8;
+export declare const SCENE_F64_STRIDE = 100;
+export declare const SCENE_F32_STRIDE = 20;
+export declare const SCENE_MAX_TRANSFORM_OPS = 6;
+export declare const AUTO_RETAINED_MAX_LAYOUT_AREA = 400000;
+export declare const SCENE_I_FIRST_CHILD = 4;
+export declare const SCENE_I_NEXT_SIBLING = 5;
+export declare const SCENE_I_PAINT_KIND = 6;
+export declare const SCENE_I_PAINT_BITS = 7;
+export declare const SCENE_FLAG_PORTAL_VIEW = 1;
+export declare const SCENE_FLAG_PRESENTATION_LAYER_TRANSFORM = 2;
+export declare const SCENE_FLAG_TRANSFORM_UNBOUNDED = 4;
+export declare const SCENE_FLAG_OVERFLOW_CLIP = 8;
+export declare const SCENE_FLAG_TRANSFORM = 16;
+export declare const SCENE_FLAG_PRESENTED_BOX = 32;
+export declare const SCENE_FLAG_PRESENTATION_STYLE = 64;
+export declare const SCENE_FLAG_Z_DYNAMIC = 128;
+export declare const SCENE_FLAG_TRANSFORM_STYLE = 256;
+export declare const SCENE_FLAG_MASK_SLOT = 512;
+export declare const SCENE_FLAG_STICKY_HEADER = 1024;
+export declare const SCENE_FLAG_VERTICAL_SCROLL = 2048;
+export declare const SCENE_FLAG_TEXT = 4096;
+export declare const SCENE_FLAG_IMAGE = 524288;
+export declare const SCENE_FLAG_HOISTED = 2097152;
+export declare const SCENE_FLAG_HOIST_HOST = 4194304;
+export declare const SCENE_FLAG_STICKY_INVERTED = 8388608;
+export declare const SCENE_FLAG_PORTAL_HOST = 536870912;
+export declare const SCENE_PAINT_KIND_JS = 1;
+export declare const SCENE_PAINT_KIND_JS_VOLATILE = 2;
+export declare const SCENE_PAINT_KIND_BOX = 3;
+export declare const SCENE_PAINT_KIND_SKIP = 4;
+export declare const SCENE_PAINT_KIND_HOST = 5;
+export declare const SCENE_PAINT_KIND_TEXT = 6;
+export declare const SCENE_PAINT_KIND_IMAGE = 7;
+export declare const SCENE_PAINT_KIND_PICTURE = 8;
+export declare const SCENE_PAINT_KIND_MASKED_VIEW = 9;
+export declare const SCENE_PAINT_FILL = 1;
+export declare const SCENE_PAINT_ANTIALIAS = 2;
+export declare const SCENE_PAINT_BORDER = 4;
+export declare const SCENE_PAINT_BORDER_UNIFORM = 8;
+export declare const SCENE_PAINT_BORDER_STYLE_SHIFT = 4;
+export declare const SCENE_PAINT_CLIP = 64;
+export declare const SCENE_PAINT_FOLD = 128;
+export declare const SCENE_PAINT_LAYER = 256;
+export declare const SCENE_PAINT_SHADOW = 512;
+export declare const SCENE_PAINT_BLEND_LAYER = 1024;
+export declare const SCENE_PAINT_FILL_BLEND = 2048;
+export declare const SCENE_PAINT_BLEND_SHIFT = 12;
+export declare const SCENE_PAINT_BLEND_RUNTIME = 30;
+export declare const SCENE_PAINT_BLEND_MATRIX = 31;
+export declare const SCENE_PAINT_GRADIENT = 131072;
+export declare const SCENE_PAINT_GLASS = 262144;
+export declare const SCENE_PAINT_OUTLINE = 524288;
+export declare const SCENE_PAINT_CLIP_BORDER_BOX = 1048576;
+export declare const SCENE_PAINT_BORDER_OVER = 2097152;
+export declare const SCENE_PAINT_BORDER_IMAGE = 4194304;
+export declare const SCENE_PAINT_CA_ROUNDED = 8388608;
+export declare const SCENE_PAINT_BORDER_CLIPS_CONTENT = 16777216;
+export declare const SCENE_PAINT_MIX_BLEND = 33554432;
+export declare const SCENE_PAINT_MASK_SAMPLES_BACKDROP = 67108864;
+export declare const SCENE_PAINT_MASK_SEEDS_BACKDROP = 134217728;
+export declare const SCENE_PAINT_SIZE_FREE = 268435456;
+export declare const SCENE_PAINT_MATERIAL = 536870912;
+export declare const SCENE_PAINT_VIEW_MASK = 1073741824;
+export declare const SCENE_D_SELF_GEN = 38;
+export declare const SCENE_D_SUB_GEN = 39;
+export declare const SCENE_D_KIND_STAMP = 53;
+export declare const SCENE_D_BOUNDED_VERSION = 54;
+export declare const SCENE_D_BOUNDED = 55;
+export declare const SCENE_D_RADII = 56;
+export declare const SCENE_D_SHAPE = 60;
+export declare const SCENE_D_BORDER_WIDTHS = 61;
+export declare const SCENE_D_BOUNDS_GEN = 65;
+export declare const SCENE_D_FILL_SHAPE = 66;
+export declare const SCENE_F_FILL = 0;
+export declare const SCENE_F_BORDER = 4;
+export interface SceneMemoryBlock {
+    view(): ArrayBufferView;
+    free(): void;
+}
+export interface SceneMemory {
+    allocate(byteLength: number): SceneMemoryBlock;
+}
+export declare const PAINT_EXTENT_SKIP = 1;
+export declare const PAINT_EXTENT_UNKNOWN = 2;
+export declare const PAINT_EXTENT_CHILDREN = 4;
+export declare const PAINT_EXTENT_FILTER = 8;
+export declare const PAINT_EXTENT_TRANSFORM = 16;
+export interface PaintExtent {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+}
+type PaintExtentPublisher = (node: object, x: number, y: number, width: number, height: number, subtree: boolean, output: () => Float64Array) => number;
+interface LensFoldDraw {
+    prepare(x: number, y: number, dpr: number): void;
+    restore(): void;
+    capture(): boolean;
+    draw(canvas: number, effect: RuntimeEffect, x: number, y: number, w: number, h: number, uniforms: number[]): boolean;
+    delete(): void;
+}
+interface SdfDisplacementDraw {
+    prepare(x: number, y: number, dpr: number): void;
+    restore(): void;
+    draw(canvas: number, uniforms: number[]): boolean;
+    delete(): void;
+}
+export interface SceneNativeBinding {
+    p10: new (surface: number) => LensFoldDraw;
+    p16: new (content: number, field: number, left: number, top: number) => SdfDisplacementDraw;
+    peachPaintExtentParameters?: (slot: number, x: number, y: number, width: number, height: number, subtree: number, out: number) => number;
+    _peach_scene_paint_extent(slot: number, x: number, y: number, width: number, height: number, skipPortalViews: number, subtree: number): number;
+    _peach_scene_paint_extent_out(): number;
+    peachRasterTransformParameters?: (slot: number, out: number) => number;
+    _peach_scene_raster_candidate(slot: number): void;
+    _peach_scene_retained_changed(slot: number): void;
+    _peach_scene_bounds_changed(slot: number): void;
+    _peach_scene_child_order_changed(parent: number): void;
+    _peach_scene_resize_keeps_classification(slot: number, fromWidth: number, fromHeight: number): number;
+    _peach_walk_retained_census(): number;
+    _peach_classic_layout_set(slot: number, start: number, duration: number, easing: number, fromX: number, fromY: number, fromWidth: number, fromHeight: number, targetX: number, targetY: number, targetWidth: number, targetHeight: number): void;
+    _peach_classic_layout_clear(slot: number): void;
+    _peach_classic_layout_sample(slot: number, timestamp: number): number;
+    peachExtentParameters?: (slot: number) => void;
+    _peach_scene_set_buffers(integers: number, doubles: number, floats: number, layoutMatrices: number): void;
+    _peach_paint_walk(canvas: number, slot: number, self: number, childX: number, childY: number, flags: number, txOffX: number, txOffY: number, hasClip: number, clipLeft: number, clipTop: number, clipRight: number, clipBottom: number, dpr: number, surfaceWidth: number, surfaceHeight: number, layoutVersion: number, paintFloor: number, paintEpoch: number, fontGeneration: number, android: number, hasDamage: number, damageLeft: number, damageTop: number, damageRight: number, damageBottom: number, damageId: number, frameMs: number): number;
+    _peach_scene_bounds_out(): number;
+    _peach_shared_set(slot: number, boundary: number, shared: number, exiting: number): void;
+    _peach_shared_reset(): void;
+    _peach_shared_collect(root: number, guess: number): number;
+    _peach_shared_result(): number;
+    _peach_shared_progress_values(): number;
+    _peach_shared_progress(progress: number): void;
+    _peach_scene_bounds(slot: number, hasExtent: number, left: number, top: number, right: number, bottom: number): void;
+    _peach_scene_paint_bounded(slot: number, layoutVersion: number, android: number): number;
+    _peach_walk_flat_dep(): number;
+    _peach_walk_motion_take(): number;
+    _peach_walk_host_continues(): number;
+    _peach_walk_host_continue_slots(): number;
+    _peach_host_drop(slot: number, release: number): void;
+    _peach_scene_subtree_raster(slot: number): number;
+    _peach_scene_set_text(slot: number, paragraph: number, dpr: number, fontGeneration: number, padLeft: number, padTop: number, clipOffset: number, offsetX: number, offsetY: number, clip: number, maxWidth: number, contentHeight: number, overlay: number, embeds: number): number;
+    _peach_numeric_text_create(fromPicture: number, toPicture: number, glyphs: number): number;
+    _peach_numeric_text_parameters(handle: number): number;
+    _peach_numeric_text_draw(canvas: number, handle: number, x: number, y: number, elapsed: number): void;
+    _peach_numeric_text_drop(handle: number): void;
+    _peach_scene_set_image(slot: number, image: number, padLeft: number, padTop: number, padRight: number, padBottom: number, srcLeft: number, srcTop: number, srcRight: number, srcBottom: number, offsetX: number, adjustX: number, offsetY: number, adjustY: number, width: number, height: number, repeat: number, mipmaps: number, tintR: number, tintG: number, tintB: number, tintA: number, alpha: number, shape: number, sampling: number): void;
+    _peach_scene_set_picture(slot: number, picture: number, fontGeneration: number, drawnNodes: number): void;
+    _peach_scene_set_ink(slot: number, glass: number, id: number): void;
+    _peach_ink_draw_picture(canvas: number, picture: number, shader: number, text: number, left: number, top: number, right: number, bottom: number): void;
+    pe(): RuntimeEffect | null;
+    pf(dark: boolean): RuntimeEffect | null;
+    pb(id: number, offsetX: number, offsetY: number): Shader | null;
+    p1f(index: number): RuntimeEffect | null;
+    p19(): RuntimeEffect | null;
+    p1b(): void;
+    p1c(): void;
+    p1(): RuntimeEffect | null;
+    p0(): RuntimeEffect | null;
+    p1a(scratch: number, transport: number, first: number, second: number, layers: number, width: number, height: number, glyphScale: number, referenceHeight: number, left: number, top: number): SkImage | null;
+    p3(parent: number, sharp: number, blurW: number, blurH: number, leftPad: number, topPad: number, rightPad: number, bottomPad: number, sigma: number, scale: number): SkImage | null;
+    pa(parent: number, x: number, y: number, width: number, height: number, tenant: number, tenantScale: number): SkImage | null;
+    pc(parent: number, sharp: number, width: number, height: number, sigma: number): SkImage | null;
+    p5(surface: number, key: string, snapshot: string, layered: boolean): SkImage | null;
+    p6(surface: number, key: string, snapshot: string, sigmaPx: number, staticBackdrop: boolean): SkImage | null;
+    p9(surface: number, key: string, image: number): void;
+    p8(surface: number, key: string, snapshot: string, image: number, scale: number, cropX: number, cropY: number, cropW: number, cropH: number, portal: boolean, layered: boolean): boolean;
+    p4(surface: number, key: string, compositeKey: string, width: number, height: number): SkImage | null;
+    p7(surface: number, key: string, compositeKey: string, image: number): boolean;
+    _peach_scene_drop_leaf(slot: number): void;
+    _peach_scene_shadow_input(): number;
+    _peach_scene_set_shadows(slot: number, count: number): void;
+    _peach_scene_gradient_input(count: number): number;
+    _peach_scene_set_gradient(slot: number, count: number): void;
+    _peach_scene_material_input(): number;
+    _peach_scene_set_material(slot: number): void;
+    _peach_scene_filter_input(): number;
+    _peach_scene_set_filter(slot: number, count: number): void;
+    _peach_scene_set_blend_matrix(slot: number, effect: number, m0: number, m1: number, m2: number, m3: number, m4: number, m5: number, m6: number, m7: number, m8: number, b0: number, b1: number, b2: number): void;
+    _peach_scene_set_blend_runtime(slot: number, effect: number): void;
+    _peach_scene_set_damage_outsets(slot: number, known: number, left: number, top: number, right: number, bottom: number, glassPadding: number, glassMaterial: number, glassIntensity: number): void;
+    _peach_scene_set_outline(slot: number, r: number, g: number, b: number, a: number, width: number, offset: number, style: number): void;
+    _peach_scene_set_scroll_indicator(slot: number, horizontal: number, pos: number, length: number, thickness: number, margin: number, radius: number, alpha: number, white: number): void;
+    _peach_scene_set_fading_edges(slot: number, horizontal: number, length: number, edges: number): void;
+    _peach_walk_painted_images(): number;
+    _peach_anim_create(ints: number, doubles: number): number;
+    _peach_anim_program_create(ints: number, doubles: number): number;
+    _peach_anim_program_bind(entry: number, program: number, indexes: number): void;
+    _peach_anim_program_unbind(entry: number): void;
+    _peach_anim_program_drop(id: number): void;
+    _peach_anim_program_values(id: number): number;
+    _peach_zoom_overlay_set(root: number, program: number, wrapper: number, image: number, input: number): number;
+    _peach_zoom_overlay_clear(root: number, wrapper: number): void;
+    _peach_anim_program_info(id: number): number;
+    _peach_anim_program_time(animationMs: number): void;
+    _peach_anim_program_check(animationMs: number): number;
+    _peach_anim_drop(id: number): void;
+    _peach_anim_set_lanes(id: number, ints: number, doubles: number): void;
+    _peach_anim_drop_lanes(id: number): void;
+    _peach_anim_fill_class(id: number): number;
+    _peach_anim_values(id: number): number;
+    _peach_anim_skips(): number;
+    _peach_anim_gather(): number;
+    _peach_anim_prepare(): number;
+    _peach_anim_step(epochMs: number): number;
+    _peach_anim_drive_create(ints: number, doubles: number): number;
+    _peach_anim_drive_publication(): number;
+    _peach_anim_drive_drop(id: number): void;
+    _peach_anim_drives_finished(): number;
+    _peach_anim_output(): number;
+    _peach_anim_entry_count(): number;
+    _peach_loupe_state(): number;
+    _peach_loupe_step(x: number, y: number, epochMs: number): void;
+    _peach_frame_config(): number;
+    _peach_frame_surfaces(): number;
+    _peach_frame_portals(surface: number, count: number): number;
+    _peach_portal_end(slot: number): void;
+    _peach_frame_classes(entries: number): number;
+    _peach_frame_hold_slots(): number;
+    _peach_frame_dirty(): number;
+    _peach_frame_current_surface(): number;
+    _peach_frame_watch(count: number): number;
+    _peach_frame(hostMs: number, nowMs: number): number;
+    peachFramePresent?: (mask: number, submitted: number) => number;
+    readonly HEAPU8: Uint8Array;
+}
+export declare function arrayBufferSceneMemory(): SceneMemory;
+export declare function isSceneNativeBinding(value: object): value is SceneNativeBinding;
+export declare function requireSceneNativeBinding(value: object): SceneNativeBinding;
+export declare function canvasKitSceneMemory(ck: Pick<CanvasKit, 'Malloc' | 'Free'>): SceneMemory;
+export interface SceneSlotted {
+    _sceneSlot: number;
+}
+export interface SceneAbsolutePositionOptions {
+    ignorePresentationLayerTransforms?: boolean;
+    ignoreSelfTransform?: boolean;
+}
+export declare class SceneTable {
+    #private;
+    constructor(memory: SceneMemory, capacity?: number);
+    static byteLength(capacity: number): number;
+    get capacity(): number;
+    migrate(memory: SceneMemory, native?: SceneNativeBinding): void;
+    nativeIn(module: object): SceneNativeBinding | undefined;
+    i32(): Int32Array;
+    f64(): Float64Array;
+    f32(): Float32Array;
+    allocate(node: object, tag: number, flags: number): number;
+    setRasterTransformPublisher(publisher: (node: object, output: () => Float64Array) => number): void;
+    setExtentPublisher(reader: (node: object) => void): void;
+    setStickyOffsetReader(reader: (node: object) => number): void;
+    setPaintExtentPublisher(publisher: PaintExtentPublisher): void;
+    paintExtent(slot: number, x: number, y: number, width: number, height: number, skipPortalViews: boolean, subtree: boolean): Float64Array | null;
+    node(slot: number): object | undefined;
+    writeSharedNode(slot: number, update: {
+        boundary?: number;
+        shared?: number;
+        exiting?: boolean;
+    }): void;
+    collectSharedNodes(root: number, selection: 'active' | 'guess'): {
+        boundary: number;
+        slots: number[];
+    };
+    sharedProgress(before: readonly number[], after: readonly number[], progress: number): number[];
+    release(node: object, slot: number): void;
+    dropReplay(slot: number): void;
+    subtreeHoldsRaster(slot: number): boolean;
+    dropLeaf(slot: number): void;
+    writeParent(slot: number, parentSlot: number): void;
+    linkChild(parentSlot: number, previous: number, slot: number, next: number): void;
+    unlinkChild(parentSlot: number, previous: number, next: number): void;
+    markChildOrderChanged(parentSlot: number): void;
+    markPaintChanged(slot: number): void;
+    markOwnPaintChanged(slot: number): void;
+    invalidatePaintKinds(): void;
+    get paintFloor(): number;
+    get paintGeneration(): number;
+    get boundsGeneration(): number;
+    adoptNativeFrameGenerations(paint: number, bounds: number): void;
+    armNativeFrame(config: number): void;
+    paintBounded(slot: number, layoutVersion: number): boolean;
+    writePaintBox(slot: number, radii: {
+        tl: number;
+        tr: number;
+        br: number;
+        bl: number;
+    }, shape: number, fillShape: number, topWidth: number, rightWidth: number, bottomWidth: number, leftWidth: number, fill: Float32Array, top: Float32Array, right: Float32Array, bottom: Float32Array, left: Float32Array): void;
+    writePropFlags(slot: number, propFlags: number): void;
+    writeHoistFlag(slot: number, flag: number, on: boolean): void;
+    presentationStyleBacked(slot: number): boolean;
+    presentsBox(slot: number): boolean;
+    stampedPaintKind(slot: number): number;
+    stampedPaintSubtreeCurrent(slot: number): boolean;
+    resizeKeepsClassification(slot: number, fromWidth: number, fromHeight: number): boolean;
+    transformStyled(slot: number): boolean;
+    transformBounded(slot: number): boolean;
+    zIndex(slot: number): number;
+    noteScrolled(slot: number): void;
+    get scrolledPending(): boolean;
+    drainScrolled(into: Set<number>): void;
+    reclassify(slot: number): void;
+    flushClassification(root: number, classify: (slot: number) => void): void;
+    stampPaintInputs(slot: number, values: unknown[] | null, matches: (node: object, values: unknown[]) => boolean): void;
+    refreshPaintInputs(): void;
+    stampPaintKind(slot: number, kind: number, bits: number): void;
+    readLayout(slot: number, layout: SootSimLayout): void;
+    writeClassicLayoutAnimation(slot: number, from: SootSimLayout, target: SootSimLayout, start: number, duration: number, type: string | null): void;
+    clearClassicLayoutAnimation(slot: number): void;
+    sampleClassicLayoutAnimation(slot: number, timestamp: number, out: SootSimLayout): boolean;
+    commitNativeLayouts(native: NativeLayoutExports): void;
+    writeLayout(slot: number, x: number, y: number, width: number, height: number): void;
+    writeJsBoundary(slot: number, on: boolean): void;
+    writeJsBoundaryDirty(slot: number, on: boolean): void;
+    writeLiveChunk(slot: number, on: boolean): void;
+    writeScroll(slot: number, x: number, y: number): void;
+    writeStickyHidden(slot: number, offset: number): void;
+    writeZoom(slot: number, zoom: number | undefined): void;
+    writeStyle(slot: number, style: SootSimStyle, resolve: (value: unknown) => unknown, owned?: Readonly<Record<string, unknown>> | null): void;
+    writeExtentStyle(slot: number, style: SootSimStyle, resolve: (value: unknown) => unknown): void;
+    writeLayoutMatrix(slot: number, transform: SootSimStyle['transform'], transformOrigin: SootSimStyle['transformOrigin'], resolve: (value: unknown) => unknown): void;
+    writeTransform(slot: number, transform: SootSimStyle['transform'], transformOrigin: SootSimStyle['transformOrigin'], resolve: (value: unknown) => unknown): void;
+    writePaintedBox(slot: number, x: number, y: number, width: number, height: number, animated: boolean, transform: SootSimStyle['transform'], transformOrigin: SootSimStyle['transformOrigin'], resolve: (value: unknown) => unknown): void;
+    paintMatrix(slot: number, x: number, y: number): number[] | null;
+    absolutePosition(slot: number, options: SceneAbsolutePositionOptions | undefined, out: {
+        x: number;
+        y: number;
+    }): void;
+    nodeBoundsDamage(slot: number, extent?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }): DamageRect | null;
+    addDriveDamage(before: DamageRect | null, after?: DamageRect | null): void;
+    takeDriveDamage(): DamageRect | null;
+    seedPresentationStyle(slot: number, style: SootSimStyle, program: SceneLaneProgram, resolve: (value: unknown) => unknown): void;
+    laneStyleValues(slot: number, program: SceneLaneProgram): Record<string, unknown>;
+}
+declare class SceneLaneReader {
+    readonly lane: number;
+    readonly getValue: () => number | string;
+    constructor(lane: number, getValue: () => number | string);
+}
+export declare class SceneFilterReader extends SceneLaneReader {
+    readonly parsed: ParsedFilterOp[];
+    constructor(read: () => number);
+}
+export interface SceneLaneProgram {
+    readonly writes: Float64Array;
+    readonly styleLanes: Readonly<Record<string, number>>;
+    readonly parameterKeys: readonly string[];
+    readonly geometry: boolean;
+    readonly layoutFrame: Readonly<Record<string, unknown>> | null;
+    readonly translates: boolean;
+    readonly txBase: number;
+    readonly tyBase: number;
+    readonly txIndexes: readonly number[];
+    readonly tyIndexes: readonly number[];
+    readonly transform: ReadonlyArray<Record<string, unknown>> | null;
+    readonly filterBlur: boolean;
+    readonly keys: ReadonlySet<string>;
+    readonly objectKeys: readonly string[];
+    readonly objectIndexes: readonly number[];
+    readonly fillIndex: number;
+    readonly layoutStyle: readonly number[];
+    readonly layoutStyleIndexes: Readonly<Record<string, number>>;
+    readonly glass: readonly number[];
+    readonly glassIndexes: Readonly<Record<string, number>>;
+    readonly glassRectIndexes: Readonly<Record<string, number>>;
+    readonly glassOpacityIndex: number;
+}
+export declare function compileSceneLaneProgram(template: Record<string, unknown>, slotIds: readonly number[]): SceneLaneProgram | string;
+export declare const sceneTable: SceneTable;
+export {};

package/dist-types/packages/peach-engine/src/engine/scroll-momentum-math.d.ts

@@ -0,0 +1,152 @@
+import type { DeviceSpec } from '../../../../../src/device-catalog.ts';
+import type { ScrollRange } from './scroll-range.d.ts';
+export declare function scrollMomentumFrameDuration(elapsedMs: number, platform: string | undefined): number;
+export declare const IOS_SET_CONTENT_OFFSET_MS = 300;
+export type TimedScrollCurve = 'ios-set-content-offset' | 'ios-status-bar-scroll-to-top';
+export type TimedScrollControl = {
+    id: number;
+    type: 'start';
+    target: number;
+    durationMs: number;
+    curve: TimedScrollCurve;
+} | {
+    id: number;
+    type: 'cancel';
+} | {
+    id: number;
+    type: 'shift';
+    delta: number;
+};
+export interface TimedScrollPresentation {
+    id: number;
+    phase: 'step' | 'done' | 'canceled';
+    refused?: true;
+}
+export interface TimedScrollState {
+    from: number;
+    target: number;
+    durationMs: number;
+    elapsedMs: number;
+    curve: TimedScrollCurve;
+}
+export declare const IOS_STATUS_BAR_SCROLL_TO_TOP_MS = 1600;
+export declare function iosSetContentOffsetProgress(fraction: number): number;
+export declare function sampleTimedScroll(timed: TimedScrollState): number;
+export declare const IOS_TOUCH_RUBBER_BAND_COEFFICIENT = 0.55;
+export declare const IOS_SMALL_TRACKPAD_RUBBER_BAND_COEFFICIENT = 0.715;
+export type ScrollMomentumPhysics = {
+    kind: 'ios-exponential';
+    decelerationRate: number;
+} | {
+    kind: 'android-over-scroller';
+    friction: number;
+};
+export declare function isScrollMomentumPhysics(value: unknown): value is ScrollMomentumPhysics;
+type ScrollMomentumDriver = {
+    kind: 'ios-exponential';
+    decelerationRate: number;
+    fastScrollMultiplier: number;
+} | {
+    kind: 'android-over-scroller';
+    startOffset: number;
+    elapsedMs: number;
+    durationMs: number;
+    distance: number;
+};
+export interface ScrollMomentumState {
+    offset: number;
+    velocity: number;
+    bouncing: boolean;
+    driver: ScrollMomentumDriver;
+    snapTarget: number | null;
+    snapOmega: number | null;
+    releasePanVelocity: number;
+    paging: IosPagingSettle | null;
+}
+interface IosPagingSettle {
+    target: number;
+    direction: -1 | 0 | 1;
+    range: ScrollRange;
+}
+export interface ScrollMomentumConfig extends ScrollRange {
+    allowsOverscroll: boolean;
+    pagingEnabled: boolean;
+    pageSize: number;
+    pageStartPage: number;
+    boundsWidth: number;
+    pixelScale: number;
+    snapToInterval?: number;
+    snapToAlignment?: 'start' | 'center' | 'end';
+    snapToOffsets?: readonly number[];
+    snapToStart?: boolean;
+    snapToEnd?: boolean;
+    disableIntervalMomentum?: boolean;
+    collapseBand?: CollapseBand | null;
+}
+export type ScrollSnapFlags = Required<Pick<ScrollMomentumConfig, 'snapToStart' | 'snapToEnd' | 'disableIntervalMomentum'>>;
+export declare function readScrollSnapFlags(props: Record<string, unknown> | null | undefined): ScrollSnapFlags;
+export interface CollapseBand {
+    start: number;
+    end: number;
+}
+export declare function isCollapseBand(value: unknown): value is CollapseBand;
+export interface AndroidOverScrollerFling {
+    distance: number;
+    durationMs: number;
+}
+export interface NestedScrollOffset extends ScrollRange {
+    offset: number;
+}
+export declare function consumeNestedScrollDelta(entries: readonly NestedScrollOffset[], delta: number): number;
+export declare function getAndroidOverScrollerFling(velocity: number, friction: number): AndroidOverScrollerFling;
+export declare function createScrollMomentumState(opts: {
+    offset: number;
+    velocity: number;
+    releasePanVelocity?: number;
+    bouncing?: boolean;
+    physics: ScrollMomentumPhysics;
+    fastScrollMultiplier?: number;
+}): ScrollMomentumState;
+export declare function rebaseScrollMomentumState(state: ScrollMomentumState, offset: number): ScrollMomentumState;
+export declare function projectedScrollOffset(state: ScrollMomentumState): number;
+export declare function iosDelegateMovesTarget(state: ScrollMomentumState, target: number, range: ScrollRange): boolean;
+export declare function reaimIosScrollMomentum(state: ScrollMomentumState, target: number): ScrollMomentumState;
+export declare function scrollNeedsSettle(config: Omit<ScrollMomentumConfig, 'pageStartPage' | 'boundsWidth' | 'pixelScale'> & Pick<ScrollMomentumState, 'offset'>): boolean;
+export interface ScrollMomentumStep extends ScrollMomentumState {
+    done: boolean;
+    clamped: boolean;
+    absorbedEdge: 'start' | 'end' | null;
+    absorbedVelocity: number;
+}
+export declare function advanceScrollMomentumSpring(state: ScrollMomentumState, dtMs: number, target: number, spring?: {
+    stiffness: number;
+    damping: number;
+}): ScrollMomentumStep;
+export declare function restingScrollOffset(state: ScrollMomentumState, config: ScrollMomentumConfig): number;
+export declare function roundToIosPixel(value: number, scale: number): number;
+export declare function appliedScrollOffset(value: number, spec: DeviceSpec | undefined): number;
+export declare function nativeScrollEventOffset(value: number, spec: DeviceSpec | undefined): number;
+export declare function advanceScrollMomentum(state: ScrollMomentumState, dtMs: number, config: ScrollMomentumConfig): ScrollMomentumStep;
+export type ScrollRelease = {
+    velocityX: number;
+    velocityY: number;
+    targetX: number;
+    targetY: number;
+};
+export declare function restingScrollRelease(offset: {
+    x: number;
+    y: number;
+}): ScrollRelease;
+export declare function scrollEndDragFields(release: ScrollRelease): {
+    velocity: {
+        x: number;
+        y: number;
+    };
+    targetContentOffset: {
+        x: number;
+        y: number;
+    };
+};
+export declare function iosRubberBand(overscroll: number, dimension: number, coefficient?: number): number;
+export declare function inverseIosRubberBand(displayed: number, dimension: number, coefficient?: number): number;
+export {};

package/dist-types/packages/peach-engine/src/engine/scroll-pan-contacts.d.ts

@@ -0,0 +1,10 @@
+export declare class ScrollPanContacts {
+    private readonly contacts;
+    x: number;
+    y: number;
+    get size(): number;
+    begin(pointerId: number, x: number, y: number): boolean;
+    move(pointerId: number, x: number, y: number): boolean;
+    end(pointerId: number): boolean;
+    clear(): void;
+}

package/dist-types/packages/peach-engine/src/engine/scroll-platform.d.ts

@@ -0,0 +1,75 @@
+import { type ScrollMomentumPhysics } from './scroll-momentum-math.d.ts';
+export declare const IOS_REFRESH_TITLE_FONT_SIZE = 12;
+export declare function getIOSRefreshTitleFontSize(): number;
+export declare function getRefreshHoldOffset(platform: string | undefined, hasTitle: boolean, titleFontSize?: number): number;
+export declare const REFRESH_TRIGGER_THRESHOLD = 60;
+export declare function getRefreshTriggerThreshold(platform: string | undefined, viewportHeight: number, hasTitle: boolean, titleFontSize?: number): number;
+export declare function getRefreshMaximumSnappingHeight(viewportHeight: number, hasTitle: boolean, titleFontSize?: number): number;
+export type ScrollDirectionalLock = 'horizontal' | 'vertical' | null;
+export declare function selectScrollDirectionalLock(dx: number, dy: number, horizontalAvailable: boolean, verticalAvailable: boolean, selected: ScrollDirectionalLock): ScrollDirectionalLock;
+export declare function scrollTouchSlop(platform: string | undefined, primaryDelta: number): number;
+export interface ScrollDragOrigin {
+    x: number;
+    y: number;
+    timestamp?: number;
+}
+export declare function scrollDragAdmission(platform: string | undefined, primaryDelta: number, crossDelta: number): 'pending' | 'reject' | 'begin';
+export declare function scrollDragDelta(platform: string | undefined, pointerDelta: number, slop: number, beganDrag: boolean): number;
+export declare function scrollDragMatchesAxis(platform: string | undefined, primaryDelta: number, crossDelta: number): boolean;
+export declare function allowsRubberBandScroll(opts: {
+    platform?: string;
+    bounces?: unknown;
+}): boolean;
+export declare function shouldTrackAndroidRefreshPull(opts: {
+    platform?: string;
+    horizontal?: boolean;
+    refreshEnabled?: boolean;
+    refreshing?: boolean;
+}): boolean;
+export declare function shouldRenderAndroidEdgeEffect(opts: {
+    platform?: string;
+    overScrollMode?: unknown;
+    contentSize: number;
+    viewportSize: number;
+}): boolean;
+export declare function resolveScrollDecelerationRate(opts: {
+    platform?: string;
+    decelerationRate?: unknown;
+}): number;
+export declare function resolveScrollMomentumPhysics(opts: {
+    platform?: string;
+    decelerationRate?: unknown;
+}): ScrollMomentumPhysics;
+export declare function resolveAndroidFadingEdgeLength(opts: {
+    platform?: string;
+    fadingEdgeLength?: unknown;
+}): number;
+export declare function resolveScrollIndicatorMetrics(opts: {
+    platform?: string;
+    persistentScrollbar?: unknown;
+    indicatorStyle?: unknown;
+    colorScheme?: string;
+}): {
+    width: number;
+    minLength: number;
+    margin: number;
+    radius: number;
+    alpha: number;
+    white: boolean;
+    idleOpacity: number | null;
+};
+export declare function layoutIosScrollIndicator(opts: {
+    viewportSize: number;
+    scrollRange: number;
+    contentOffset: number;
+    minOffset: number;
+    startInset: number;
+    endInset: number;
+    minLength: number;
+    margin: number;
+    scale: number;
+}): {
+    pos: number;
+    length: number;
+};
+export declare function iosConcentricCornerInset(radius: number, dx: number, dy: number): number;

package/dist-types/packages/peach-engine/src/engine/scroll-range.d.ts

@@ -0,0 +1,14 @@
+export interface ScrollContentInset {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+}
+export declare function getLargeTitleInsetReduction(automaticTop: number, collapseBand: unknown, offsetY: number): number;
+export declare function getScrollEventContentInset(adjusted: Partial<ScrollContentInset> | undefined, automatic: Partial<ScrollContentInset> | undefined): ScrollContentInset;
+export interface ScrollRange {
+    min: number;
+    max: number;
+}
+export declare function getScrollStartOffset(leadingInset: number, platform: string | undefined): number;
+export declare function getScrollEndOffset(contentSize: number, viewportSize: number, endInset: number, minOffset: number): number;

package/dist-types/packages/peach-engine/src/engine/scroll-velocity.d.ts

@@ -0,0 +1,14 @@
+export interface ScrollVelocitySample {
+    delta: number;
+    dt: number;
+    timestamp: number;
+}
+export declare const SCROLL_VELOCITY_SAMPLE_RETENTION_MS: number;
+export declare function combineIosPanSegmentVelocities(previousSegmentVelocity: number | undefined, currentSegmentVelocity: number): number;
+export declare function pushScrollVelocitySample(samples: ScrollVelocitySample[], sample: ScrollVelocitySample): void;
+export interface ScrollReleaseVelocity {
+    velocity: number;
+    panVelocity: number;
+}
+export declare function estimateScrollReleaseVelocity(samples: readonly ScrollVelocitySample[], releaseTimestamp: number, platform: string | undefined, overscrolled: boolean): ScrollReleaseVelocity;
+export declare function latestIosPanVelocity(samples: readonly ScrollVelocitySample[]): number;