@flemo/core 1.23.0 → 1.24.0

package/dist/core/engine/__tests__/createTransitionEngine.steadySixty.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/engine/__tests__/diagnosticFlags.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/engine/__tests__/documentedDefaults.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/engine/__tests__/flightWindow.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/engine/__tests__/imageRevealHold.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/engine/__tests__/lowPowerCadence.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/engine/__tests__/steadySixtyCadence.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/engine/compositorWarmUp.d.ts

@@ -1,2 +1,3 @@
 export declare const WARM_ATTR = "data-flemo-warm";
+export declare const resetCompositorWarmForTesting: () => void;
 export default function holdCompositorWarm(): () => void;

package/dist/core/engine/createSwipeController.d.ts

@@ -1,9 +1,8 @@
 import { Transition } from '../../transition/typing';
+import { SharedBarPresenceLike } from '../../screen/computeBarRiding';
+import { SharedBarId, SharedBarsMetadata } from '../../screen/store';
 import { Decorator } from '../../transition/decorator/typing';
-export interface SharedBarPresenceLike {
-    topBar: boolean;
-    bottomBar: boolean;
-}
+export type { SharedBarPresenceLike } from '../../screen/computeBarRiding';
 export interface SwipeControllerElements {
     scope: HTMLElement | null;
     screenContainer: HTMLElement | null;
@@ -17,9 +16,12 @@ export interface SwipeControllerConfig {
     getElements: () => SwipeControllerElements;
     hasSharedTopBar: () => boolean;
     hasSharedBottomBar: () => boolean;
+    getSharedTopBarId?: () => SharedBarId | undefined;
+    getSharedBottomBarId?: () => SharedBarId | undefined;
     getViewportScrollHeight: () => number;
     isReadyForDrag: () => boolean;
     getPartnerBars: () => SharedBarPresenceLike | undefined;
+    getPartnerBarMetadata?: () => SharedBarsMetadata | undefined;
     setDragStatus: (status: "IDLE" | "PENDING") => void;
     back: () => void;
 }
@@ -27,6 +29,7 @@ export interface SwipeController {
     pointerDown: (event: PointerEvent) => void;
     pointerMove: (event: PointerEvent) => void;
     pointerUp: (event: PointerEvent) => void;
+    pointerCancel: (event: PointerEvent) => void;
     shouldPreventTouch: () => boolean;
 }
 export default function createSwipeController(config: SwipeControllerConfig): SwipeController;

package/dist/core/engine/createTransitionEngine.d.ts

@@ -1,2 +1,3 @@
 import { TransitionEngine, TransitionEngineDeps } from './types';
+export declare const resetDisplayProbeForTests: () => void;
 export default function createTransitionEngine(deps: TransitionEngineDeps): TransitionEngine;

package/dist/core/engine/diagnosticFlags.d.ts

@@ -0,0 +1,19 @@
+export declare const readLandingSnapFlag: () => boolean;
+export declare const readImageHoldFlag: () => "on" | "off" | null;
+export declare const readSettleGateFlag: () => boolean;
+export declare const readHandoffFlag: () => boolean;
+export declare const readArrivalHoldFlag: () => boolean;
+export declare const readPrerasterFlag: () => boolean;
+export declare const readImageOffloadOverride: () => "on" | "off" | null;
+export declare const HANDOFF_MS_DEFAULT: number;
+export declare const JITTER_BAND_MAX_DEVICE_PX = 4;
+export declare const snapshotApplyOverride: () => "scrub" | null;
+export declare const handoffOverride: () => "on" | null;
+export declare const snapOverride: () => "always" | "off" | "gate" | "hybrid" | null;
+export declare const jitterBandMaxDevicePx: () => number;
+export declare const handoffMs: () => number;
+export declare const resetSessionOverrideCachesForTests: () => void;
+export declare const residentScreenLayers: () => boolean;
+export declare const resetResidentLayersForTesting: () => void;
+export declare const shallowFreeze: () => boolean;
+export declare const resetShallowFreezeForTesting: () => void;

package/dist/core/engine/driverPolicy.d.ts

@@ -1,21 +1,10 @@
-export interface DriverPolicyStorage {
-    read: () => string | null;
-    write: (value: string) => void;
-}
 export declare const FORCE_PIN_TTL_MS: number;
 export interface DriverPolicy {
     playerAllowed: () => boolean;
     pinnedDriver: () => "css" | "raf" | null;
-    beginRun: () => void;
-    reportGap: (gapMs: number) => void;
-    endRun: (frameIntervalMs?: number) => void;
-    stats: () => {
-        runGaps: number[];
-        strikes: number;
-        demoted: boolean;
-    };
 }
 export declare const detectBlinkEngine: () => boolean;
-export declare const createDriverPolicy: (storage?: DriverPolicyStorage, playerByDefault?: boolean, demotable?: boolean) => DriverPolicy;
+export declare const isLegacyAndroidBlink: () => boolean;
+export declare const createDriverPolicy: (playerByDefault?: boolean) => DriverPolicy;
 declare const driverPolicy: DriverPolicy;
 export default driverPolicy;

package/dist/core/engine/flightWindow.d.ts

@@ -0,0 +1,5 @@
+export declare function beginFlightWindow(): () => void;
+export declare const flightWindowActive: () => boolean;
+export declare function onFlightWindowStart(callback: () => void): () => void;
+export declare function onFlightWindowIdle(callback: () => void): void;
+export declare const resetFlightWindowForTests: () => void;

package/dist/core/engine/imageRevealHold.d.ts

@@ -0,0 +1,2 @@
+export declare function beginImageRevealHold(scope: Element | null, backstopMs: number, unpaintedOnly?: boolean): () => void;
+export default beginImageRevealHold;

package/dist/core/engine/landingPixelSnap.d.ts

@@ -3,3 +3,8 @@ import { PerceptualBox } from './perceptualSpan';
 export declare const SNAP_VELOCITY_DEVICE_PX_PER_FRAME = 40;
 export declare const SNAP_BAND_MAX_DEVICE_PX = 480;
 export declare const snappedEasingForMotion: (motion: VariantMotion, box: PerceptualBox, devicePixelRatio: number) => string | null;
+export declare const governedEasingForMotion: (motion: VariantMotion, box: PerceptualBox, devicePixelRatio: number, frameIntervalMs: number) => string | null;
+export declare const governedBezierForMotion: (motion: VariantMotion | null, box: PerceptualBox, devicePixelRatio: number, frameIntervalMs: number) => {
+    easing: string;
+    durationMs: number;
+} | null;

package/dist/core/engine/layerSettleHold.d.ts

@@ -1,5 +1,5 @@
 import { Transition } from '../../transition/typing';
+export { resetResidentLayersForTesting } from './diagnosticFlags';
 export declare const LAYER_SETTLE_MS = 300;
-export declare const resetResidentLayersForTesting: () => void;
 export declare const holdScopeLayer: (scope: HTMLElement, transitionLike: Pick<Transition, "initial" | "variants">, containment?: boolean, owner?: symbol) => void;
 export declare const releaseScopeLayerAfterSettle: (scope: HTMLElement, owner?: symbol) => void;

package/dist/core/engine/lowPowerCadence.d.ts

@@ -0,0 +1,6 @@
+export declare const lowPowerCadenceActive: () => boolean;
+export declare const governedCompiledActive: () => boolean;
+export declare const lowPowerFrameIntervalMs: () => number | null;
+export declare const resetLowPowerCadenceForTests: () => void;
+export declare const probeLowPowerCadence: (attempt?: number) => void;
+export declare const armLowPowerCadenceLifecycle: () => void;

package/dist/core/engine/nativeStallAnchor.d.ts

@@ -1,4 +1,5 @@
 export declare const NATIVE_STALL_STEP_MS: number;
 export declare function holdNativeClocksToFirstFrame(scope: HTMLElement, elements: () => (HTMLElement | null | undefined)[], onHeld?: () => void): () => void;
-export declare function anchorNativeFlightStart(elements: () => (HTMLElement | null | undefined)[], onShift?: (excessMs: number) => void): () => void;
+export declare function anchorNativeFlightStart(elements: () => (HTMLElement | null | undefined)[], onShift?: (excessMs: number) => void, holdFirstFrame?: boolean, firstTickOnly?: boolean): () => void;
 export declare function watchNativeStalls(elements: () => (HTMLElement | null | undefined)[], onStall?: (excessMs: number) => void): () => void;
+export declare function armFlightStartAnchorAtRelease(scope: HTMLElement, elements: () => (HTMLElement | null | undefined)[], onShift?: (excessMs: number) => void, holdFirstFrame?: boolean, firstTickOnly?: boolean): () => void;

package/dist/core/engine/responseHold.d.ts

@@ -1,3 +1,4 @@
 export declare function beginResponseHold(backstopMs?: number): () => void;
 export declare const heldResponseCount: () => number;
 export declare const responseHoldDepth: () => number;
+export declare const reinstallResponseHoldForTests: () => void;

package/dist/core/engine/steadySixtyCadence.d.ts

@@ -0,0 +1,5 @@
+export declare const HIGH_REFRESH_MAX_INTERVAL_MS = 12;
+export declare const reportInFlightCadence: (rawMedianMs: number, rawMaxMs?: number) => void;
+export declare const steadySixtyVerified: () => boolean;
+export declare const steadySixtyPlayerEligible: () => boolean;
+export declare const resetSteadySixtyForTests: () => void;

package/dist/core/engine/transitionPlayer.d.ts

@@ -1,10 +1,18 @@
 import { VariantMotion } from '../../transition/variantMotion';
+export { resetSessionOverrideCachesForTests } from './diagnosticFlags';
 export declare const isPlayerDrivable: (motion: VariantMotion) => boolean;
 export interface SnapMemory {
     x: number | null;
     y: number | null;
+    landingX?: number | null;
+    landingY?: number | null;
+    writtenX?: number | null;
+    writtenY?: number | null;
+    pendingLanding?: boolean;
+    glide?: boolean;
 }
-export declare const resetSessionOverrideCachesForTests: () => void;
+export declare const learnedFrameIntervalMs: () => number;
+export declare const reportDisplayIntervalMs: (intervalMs: number) => void;
 export interface PlayerScheduler {
     request: (callback: (time: number) => void) => number;
     cancel: (handle: number) => void;
@@ -15,6 +23,7 @@ export interface TrackInput {
     motion: VariantMotion;
     role: "active" | "passive";
     onComplete?: () => void;
+    status?: string;
 }
 export interface TransitionPlayerRegistry {
     join: (taskId: string, input: TrackInput) => (() => void) | null;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { default as TaskManger } from './core/TaskManger';
+export { default as TaskManger, default as TaskManager } from './core/TaskManger';
 export { default as createHistoryStore, type History, type HistoryStore, type HistoryStoreApi } from './history/store';
 export { default as seedInitialHistory } from './history/seedInitialHistory';
 export { default as ensureWindowHistoryState } from './history/ensureWindowHistoryState';
@@ -11,7 +11,7 @@ export { markSelfInducedPop, consumeSelfInducedPop, createSelfPopGuard, type Sel
 export { default as createNavigationController, type NavigationControllerDeps, type DistanceOptions, type NavigateOptions, type PopOptions } from './navigate/createNavigationController';
 export { default as createStepController, readStepParams, appendParamsQuery, subscribeStepParamsRestore, type StepControllerDeps } from './navigate/createStepController';
 export { default as createRouterScope, type FlemoStores, type CreateRouterScopeInput } from './core/createRouterScope';
-export { default as createScreenStore, type ScreenStore, type ScreenStoreApi, type SharedBarPresence, type ScreenSurface } from './screen/store';
+export { default as createScreenStore, type ScreenStore, type ScreenStoreApi, type SharedBarPresence, type SharedBarId, type SharedBarMetadata, type SharedBarsMetadata, type ScreenSurface } from './screen/store';
 export { default as createScreenSelector, type ScreenSelection } from './screen/createScreenSelector';
 export { default as computeScreenFreeze, computeScreenFreezeMode, type ScreenFreezeInput, type ScreenFreezeMode } from './screen/computeScreenFreeze';
 export { default as createTransition } from './transition/createTransition';
@@ -36,12 +36,15 @@ export { default as registerTransitionDefinitions } from './transition/registerT
 export { default as enteringInitialStyle, type EnteringInitialStyleInput } from './transition/enteringInitialStyle';
 export { default as animateInline, clearInlineAnimation } from './transition/animateInline';
 export { default as createTransitionEngine } from './core/engine/createTransitionEngine';
+export { lowPowerCadenceActive, governedCompiledActive } from './core/engine/lowPowerCadence';
+export { readSettleGateFlag, readPrerasterFlag, readImageOffloadOverride } from './core/engine/diagnosticFlags';
 export { SKIP_ANIMATION_ATTR, type TransitionEngine, type TransitionEngineDeps, type ScreenLifecycleInput } from './core/engine/types';
 export { default as createSwipeController } from './core/engine/createSwipeController';
 export { type SwipeController, type SwipeControllerConfig, type SwipeControllerElements, type SharedBarPresenceLike } from './core/engine/createSwipeController';
-export { default as computeBarRiding, type BarRidingInput } from './screen/computeBarRiding';
+export { default as computeBarRiding, sharedBarsMatch, type BarRidingInput } from './screen/computeBarRiding';
 export { animHoldKey, scheduleAnimHoldRelease, createAnimHoldCoordinator, eagerlyDecodeImages, ANIM_HOLD_RELEASE_BACKSTOP_MS, type AnimHoldInput, type AnimHoldCoordinator } from './screen/animStartAnchor';
-export { detectBlinkEngine } from './core/engine/driverPolicy';
+export { detectBlinkEngine, isLegacyAndroidBlink } from './core/engine/driverPolicy';
+export { steadySixtyPlayerEligible } from './core/engine/steadySixtyCadence';
 export { default as observeBarHeight } from './screen/observeBarHeight';
 export { default as observeViewportScrollHeight } from './screen/observeViewportScrollHeight';
 export { default as holdCompositorWarm } from './core/engine/compositorWarmUp';