@kromatv/sdk 0.1.39-canary.3579809

package/types/ui/src/lib/input-gate.d.ts

@@ -0,0 +1,27 @@
+/** Shared by overlays, focus controls and remote bridges in one app tree. */
+export declare function createInputGate(): {
+    armPressGuard(ms?: number): void;
+    pressGuardActive: () => boolean;
+    clearPressGuard(): void;
+    holdInput(): () => void;
+    inputHeld: () => boolean;
+    clearInputHolds(): void;
+};
+export type InputGate = ReturnType<typeof createInputGate>;
+export declare const InputGateProvider: import("react").Provider<{
+    armPressGuard(ms?: number): void;
+    pressGuardActive: () => boolean;
+    clearPressGuard(): void;
+    holdInput(): () => void;
+    inputHeld: () => boolean;
+    clearInputHolds(): void;
+} | null>;
+export declare const useInputGateParent: () => {
+    armPressGuard(ms?: number): void;
+    pressGuardActive: () => boolean;
+    clearPressGuard(): void;
+    holdInput(): () => void;
+    inputHeld: () => boolean;
+    clearInputHolds(): void;
+} | null;
+export declare function useInputGate(): InputGate;

package/types/ui/src/lib/input-kind.d.ts

@@ -0,0 +1,4 @@
+/** Whether pointer-only controls such as a rail's paging arrows show: never without a pointer. */
+export declare function pointerControls(_wanted: boolean): boolean;
+/** Whether a scoped strip draws its edge fades: not where a finger scrolls it. */
+export declare function keyedEdges(scoped: boolean): boolean;

package/types/ui/src/lib/input-kind.web.d.ts

@@ -0,0 +1,4 @@
+/** Whether pointer-only controls such as a rail's paging arrows show: never without a pointer. */
+export declare function pointerControls(wanted: boolean): boolean;
+/** Whether a scoped strip draws its edge fades: not where a finger scrolls it. */
+export declare function keyedEdges(scoped: boolean): boolean;

package/types/ui/src/lib/input-source.d.ts

@@ -0,0 +1,14 @@
+/** Pointer modality and its listeners have the same lifetime as their host. */
+export declare function createInputSource(): {
+    pointerDriving: () => boolean;
+    retain(): () => void;
+};
+export declare const InputSourceProvider: import("react").Provider<{
+    pointerDriving: () => boolean;
+    retain(): () => void;
+} | null>;
+export declare const useInputSourceParent: () => {
+    pointerDriving: () => boolean;
+    retain(): () => void;
+} | null;
+export declare function usePointerDriving(): () => boolean;

package/types/ui/src/lib/intl.d.ts

@@ -0,0 +1,30 @@
+import type { Locale, Translate } from '@kromatv/i18n';
+/** A count with the locale's grouping: `1 064` in French, `1,064` in English. */
+export declare function formatCount(n: number, locale: Locale): string;
+/** A fixed-point number with the locale's decimal separator: `1,5` in French,
+ *  `1.5` in English. Grouping is off: these sit in tabular columns beside a
+ *  unit, where a thousands separator reads as a second number. */
+export declare function decimal(n: number, locale: Locale, digits?: number): string;
+/** A byte size in the locale's units: `1,5 Go` in French, `1.5 GB` in English.
+ *  Zero and negatives render as the smallest unit rather than empty. */
+export declare function formatBytes(bytes: number, locale: Locale): string;
+/** A throughput figure, one decimal, no unit: the caller supplies `Mb/s`. */
+export declare function formatMbps(n: number, locale: Locale): string;
+/** A scrub-bar timecode, `1:04:07` or `4:07`, with no leading hours under one
+ *  hour. Digits only, so no locale. */
+export declare function formatTimecode(seconds: number): string;
+/** {@link formatTimecode} fed milliseconds, which is what the APIs return. */
+export declare function formatTimecodeMs(ms: number): string;
+/** Hours with one decimal for a chart axis: `14,3 h`. */
+export declare function formatHours(ms: number, locale: Locale): string;
+/** Watch time from milliseconds, to the minute: `4 h 29 min` / `65 min`. */
+export declare function formatDuration(t: Translate, ms: number): string;
+/** How long the server has been up, at the coarsest useful scale:
+ *  `18 j 04 h` / `4 h 12 min` / `8 min`. */
+export declare function formatUptime(t: Translate, seconds: number): string;
+/** A timestamp written out in full: the date and the time of day, in the
+ *  locale's own order. Where [`formatElapsed`] answers "how long ago", this
+ *  answers "when", which is what a log wants: two rows a minute apart both read
+ *  "2 days ago", and a reader auditing a history needs to tell them apart. */
+export declare function formatStamp(locale: Locale, at: string | number | null | undefined): string | null;
+export declare function formatElapsed(t: Translate, locale: Locale, at: string | number | null | undefined, now?: number): string;

package/types/ui/src/lib/intro-timing.d.ts

@@ -0,0 +1,4 @@
+/** How long the intro's exit fade lasts, in ms. */
+export declare const EXIT_MS = 850;
+/** Slack past the intro film's own length before the safety exit, in ms. */
+export declare const SAFETY_SLACK_MS = 1500;

package/types/ui/src/lib/key-grace.d.ts

@@ -0,0 +1,2 @@
+/** Whether the last focus move came from a direction key. Native focus only moves by key. */
+export declare function useKeyGrace(_scoped: boolean): () => boolean;

package/types/ui/src/lib/key-grace.web.d.ts

@@ -0,0 +1,2 @@
+/** Whether the last focus move came from a direction key. Native focus only moves by key. */
+export declare function useKeyGrace(scoped: boolean): () => boolean;

package/types/ui/src/lib/key-press.d.ts

@@ -0,0 +1,18 @@
+import { type RefObject } from 'react';
+import type { FocusServices } from '#ui/lib/focus-services';
+/** The key props a browser element answers Enter and Space with; null where nothing does. */
+export type KeyProps = {
+    tabIndex: number;
+    onKeyDown: (event: {
+        nativeEvent: {
+            key: string;
+        };
+        preventDefault: () => void;
+    }) => void;
+} | null;
+/** Enter and Space presses for a control on the browser targets, null on native. */
+declare function useKeyPress(active: boolean, role: string, press: RefObject<() => void>, mirror: FocusServices['mirror'], tabbable?: boolean): {
+    pressable: KeyProps;
+    view: KeyProps;
+} | null;
+export { useKeyPress };

package/types/ui/src/lib/kit-settings.d.ts

@@ -0,0 +1,27 @@
+import { type ComponentType } from 'react';
+import type { FrostBackdropProps } from '#ui/components/atoms/frost';
+import type { DeviceStore } from './device-store';
+import type { ControlSize } from './field-shell';
+import type { FrostHost } from './gl-frost/host';
+import type { ImageBackend } from './image-backend';
+import type { createMenuKeys } from './menu-keys';
+import type { createScrollLock } from './scroll-lock';
+import type { SurfacePresentation } from './surface-presentation';
+interface KitSettings {
+    deviceStore: DeviceStore | null | undefined;
+    menuKeys: ReturnType<typeof createMenuKeys> | null;
+    scrollLock: ReturnType<typeof createScrollLock> | null;
+    entry: Readonly<{
+        physicalKeyboard: boolean;
+        size: ControlSize;
+    }>;
+    frostEnabled: boolean;
+    frostLayerOnly: boolean;
+    surfaces: SurfacePresentation;
+    image: ImageBackend | null;
+    frost: ComponentType<FrostBackdropProps> | null;
+    frostHost: FrostHost | null;
+}
+export declare const KitSettingsContext: import("react").Context<KitSettings>;
+export declare function useKitSettings(): KitSettings;
+export {};

package/types/ui/src/lib/landmark.d.ts

@@ -0,0 +1,4 @@
+import type { ReactNode } from 'react';
+export declare const PageMain: ({ children }: {
+    children: ReactNode;
+}) => import("react").JSX.Element;

package/types/ui/src/lib/landmark.web.d.ts

@@ -0,0 +1,4 @@
+import type { ReactNode } from 'react';
+export declare const PageMain: ({ children }: {
+    children: ReactNode;
+}) => import("react").JSX.Element;

package/types/ui/src/lib/list-cursor-keys-types.d.ts

@@ -0,0 +1,12 @@
+/** The keys a list cursor answers to. */
+export interface ListCursorKeysOptions<T> {
+    /** The row the cursor is on. */
+    cursor: T;
+    /** Rows to move the cursor by: one for an arrow, a page for PageUp/PageDown. */
+    onStep: (rows: number) => void;
+    /** Enter: open whatever the cursor is on. */
+    onChoose: () => void;
+    onClose: () => void;
+}
+/** What PageUp and PageDown are worth. */
+export declare const PAGE = 8;

package/types/ui/src/lib/list-cursor-keys.d.ts

@@ -0,0 +1,5 @@
+import type { ListCursorKeysOptions } from './list-cursor-keys-types';
+/** Binds a list's keyboard cursor; returns the cursor where the platform draws one. A
+ *  television walks the rows with spatial focus, so it binds nothing. */
+declare function useListCursorKeys<T>(_options: ListCursorKeysOptions<T>): T | undefined;
+export { useListCursorKeys };

package/types/ui/src/lib/list-cursor-keys.web.d.ts

@@ -0,0 +1,4 @@
+import { type ListCursorKeysOptions } from './list-cursor-keys-types';
+/** Binds a list's keyboard cursor on the capture phase; returns the cursor where the platform draws one. */
+declare function useListCursorKeys<T>({ onStep, onChoose, onClose, cursor, }: ListCursorKeysOptions<T>): T | undefined;
+export { useListCursorKeys };

package/types/ui/src/lib/live-announce.d.ts

@@ -0,0 +1,4 @@
+/** Says `text` to a screen reader each time it changes, and nothing while it is empty. */
+export declare function LiveAnnounce({ text }: Readonly<{
+    text: string;
+}>): null;

package/types/ui/src/lib/live-announce.web.d.ts

@@ -0,0 +1,4 @@
+/** Says `text` to a screen reader each time it changes, and nothing while it is empty. */
+export declare function LiveAnnounce({ text }: Readonly<{
+    text: string;
+}>): import("react").JSX.Element;

package/types/ui/src/lib/lockup-paths.d.ts

@@ -0,0 +1,10 @@
+export declare const KROMA_KR_PATH = "M19.32 90.2H0V11H19.32V45.68C23.24 43.92 26.88 41.72 30.24 39.08C33.6 36.44 36.58 33.56 39.18 30.44C41.78 27.32 43.94 24.1 45.66 20.78C47.38 17.46 48.64 14.2 49.44 11H71.76C70.8 14.68 69.24 18.42 67.08 22.22C64.92 26.02 62.32 29.66 59.28 33.14C56.24 36.62 52.98 39.72 49.5 42.44C46.02 45.16 42.48 47.32 38.88 48.92V50.72C42.56 50.72 45.82 51.12 48.66 51.92C51.5 52.72 54.02 53.96 56.22 55.64C58.42 57.32 60.34 59.42 61.98 61.94C63.62 64.46 65.04 67.48 66.24 71L73.08 90.2H51.12L46.68 74.48C45.72 70.96 44.44 68.18 42.84 66.14C41.24 64.1 39.12 62.62 36.48 61.7C33.84 60.78 30.44 60.32 26.28 60.32H19.32V90.2ZM101.28 90.2H81.96V11H115.68C120.08 11 124.08 11.34 127.68 12.02C131.28 12.7 134.46 13.7 137.22 15.02C139.98 16.34 142.32 17.94 144.24 19.82C146.16 21.7 147.6 23.86 148.56 26.3C149.52 28.74 150 31.44 150 34.4C150 37.2 149.56 39.72 148.68 41.96C147.8 44.2 146.46 46.16 144.66 47.84C142.86 49.52 140.6 50.88 137.88 51.92C135.16 52.96 132 53.72 128.4 54.2V56C132.96 56.48 136.5 57.5 139.02 59.06C141.54 60.62 143.48 62.68 144.84 65.24C146.2 67.8 147.4 70.88 148.44 74.48L153 90.2H131.52L128.04 75.68C127.32 72.48 126.34 70 125.1 68.24C123.86 66.48 122.28 65.26 120.36 64.58C118.44 63.9 116.04 63.56 113.16 63.56H101.28V90.2ZM101.28 25.64V49.28H114.36C119.24 49.28 123.04 48.32 125.76 46.4C128.48 44.48 129.84 41.48 129.84 37.4C129.84 33.4 128.6 30.44 126.12 28.52C123.64 26.6 119.88 25.64 114.84 25.64H101.28Z";
+export declare const KROMA_MA_PATH = "M287 90.2H269V11H297.92L318.56 68H319.16L339.32 11H366.92V90.2H348.68L349.76 30.68H348.44L325.52 90.2H309.68L287.24 30.68H285.92L287 90.2ZM396.44 90.2H375.32L402.2 11H430.52L457.4 90.2H436.28L431.84 75.32H400.88L396.44 90.2ZM404.72 62.36H428L417.32 26.12H415.4L404.72 62.36Z";
+export declare const KROMA_LOCKUP: {
+    readonly height: 100;
+    readonly krWidth: 153;
+    readonly maX: 269;
+    readonly maWidth: 188.4;
+    readonly gapLeft: 6;
+    readonly gapRight: 10;
+};

package/types/ui/src/lib/loop.d.ts

@@ -0,0 +1,15 @@
+import { type StyleProp, type ViewStyle } from 'react-native';
+/** `spin` rotates a full turn; `sweep` travels a segment across its parent and
+ *  carries its own width; `pulse` breathes the opacity down and back; `blink` is
+ *  the caret's hard on/off; `halo` swells past the box it sits behind as it
+ *  fades away. */
+export type LoopKind = 'spin' | 'sweep' | 'pulse' | 'blink' | 'halo';
+/**
+ * A style that loops for as long as it is mounted, or `null` when `active` is
+ * false (nothing is animated and nothing is scheduled).
+ *
+ * The result belongs on an `Animated.View`: it carries an `Animated.Value`,
+ * which is why it is cast rather than typed - a driven value is not a `number`,
+ * and `Animated.View` is the component that knows the difference.
+ */
+export declare function useLoop(kind: LoopKind, ms: number, active?: boolean): StyleProp<ViewStyle>;

package/types/ui/src/lib/loop.web.d.ts

@@ -0,0 +1,5 @@
+import { type StyleProp, type ViewStyle } from 'react-native';
+export type LoopKind = 'spin' | 'sweep' | 'pulse' | 'blink' | 'halo';
+/** A style that loops for as long as it is mounted, or `null` when `active` is
+ * false. Plain styles, so it rides on the `Animated.View` the native half needs. */
+export declare function useLoop(kind: LoopKind, ms: number, active?: boolean): StyleProp<ViewStyle>;

package/types/ui/src/lib/menu-keys.d.ts

@@ -0,0 +1,4 @@
+/** An app host owns the native Menu switch; nested consumers take leases. */
+export declare function createMenuKeys(): {
+    hold(): () => void;
+};

package/types/ui/src/lib/menu-keys.web.d.ts

@@ -0,0 +1,4 @@
+/** The browser has no native Menu switch. */
+export declare function createMenuKeys(): {
+    hold: () => () => void;
+};

package/types/ui/src/lib/modal-portal.d.ts

@@ -0,0 +1,3 @@
+/** No-op off the web. See `modal-portal.web.ts` for what this repairs. */
+declare function useModalPortalRepair(_mounted: boolean): void;
+export { useModalPortalRepair };

package/types/ui/src/lib/modal-portal.web.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Call from the component that renders the `<Modal>` - the repair is a re-render
+ * of the Modal's PARENT, since that is what re-runs ModalPortal's render. Repairs
+ * when `mounted` turns true, so a dialog that opens later is fixed on open, not
+ * only on first mount.
+ */
+declare function useModalPortalRepair(mounted: boolean): void;
+export { useModalPortalRepair };

package/types/ui/src/lib/mono-font.d.ts

@@ -0,0 +1,2 @@
+/** A monospaced family this renderer can draw: one family name natively, a CSS stack in a browser. */
+export declare function monoFont(): string;

package/types/ui/src/lib/mount-root.d.ts

@@ -0,0 +1,3 @@
+import type { ReactNode } from 'react';
+/** Renders `node` into the page's `#root`. */
+export declare function mountRoot(node: ReactNode): void;

package/types/ui/src/lib/name-of.d.ts

@@ -0,0 +1,9 @@
+import { type ReactNode } from 'react';
+/**
+ * The first plain text under a node, at whatever depth it sits: what a compound
+ * reads off its children to name itself to assistive tech. Deliberately not a
+ * type check against a Label part: a component composing the row writes a label
+ * part of its own (<ChoiceList.Label>), and the row still has to name itself.
+ */
+declare function nameOf(node: ReactNode): string | undefined;
+export { nameOf };

package/types/ui/src/lib/naming-props.d.ts

@@ -0,0 +1,10 @@
+/** How a labelled surface such as a dialog names itself. */
+export interface Naming {
+    title?: string;
+    titleId?: string;
+    descriptionId?: string;
+}
+/** The props that name a surface: `titleId` and `descriptionId` reference rendered nodes. */
+export declare function namingProps({ title }: Naming): {
+    accessibilityLabel?: string;
+};

package/types/ui/src/lib/naming-props.web.d.ts

@@ -0,0 +1,7 @@
+import type { Naming } from './naming-props';
+/** The props that name a surface: `titleId` and `descriptionId` reference rendered nodes. */
+export declare function namingProps({ title, titleId, descriptionId }: Naming): {
+    'aria-labelledby'?: string;
+    'aria-label'?: string;
+    'aria-describedby'?: string;
+};

package/types/ui/src/lib/native-device.d.ts

@@ -0,0 +1,7 @@
+/** The hardware this app runs on, as a User-Agent would name it. */
+export interface NativeDevice {
+    model: string;
+    os: string;
+}
+/** The device a native shell runs on, or `null` in a browser, whose own User-Agent already names it. */
+export declare function nativeDevice(): NativeDevice | null;

package/types/ui/src/lib/native-film.d.ts

@@ -0,0 +1,7 @@
+/** What `<NativeFilm>` takes. */
+export interface NativeFilmProps {
+    videoSrc?: string;
+    onDone: () => void;
+}
+/** The brand film over the app through the native video player; renders nothing in a browser, where `KromaIntro` plays it. */
+export declare function NativeFilm({ videoSrc, onDone }: Readonly<NativeFilmProps>): import("react").JSX.Element;

package/types/ui/src/lib/native-film.web.d.ts

@@ -0,0 +1,3 @@
+import type { NativeFilmProps } from './native-film';
+/** The brand film over the app through the native video player; renders nothing in a browser, where `KromaIntro` plays it. */
+export declare function NativeFilm(_props: Readonly<NativeFilmProps>): null;

package/types/ui/src/lib/native-layers.d.ts

@@ -0,0 +1,31 @@
+import { type ReactNode } from 'react';
+import { Animated } from 'react-native';
+import type { ImageBackend } from '#ui/lib/image-backend';
+interface Size {
+    width: number;
+    height: number;
+}
+interface NativeLayersArgs {
+    backend: ImageBackend;
+    src: string | null;
+    under: string | null;
+    alt: string;
+    fit: 'cover' | 'contain';
+    rect: {
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+    } | null;
+    duration: number;
+    errored: boolean;
+    opacity: Animated.Value;
+    setNatural: (size: Size) => void;
+    markLoaded: () => void;
+    onCovered: ((uri: string) => void) | undefined;
+    onLoad: (() => void) | undefined;
+    onError: () => void;
+}
+declare function nativeLayers(at: Readonly<NativeLayersArgs>): ReactNode;
+export type { Size };
+export { nativeLayers };

package/types/ui/src/lib/nav-style.d.ts

@@ -0,0 +1,5 @@
+import type { NavigatorViewProps } from '@kromatv/spatial-nav/react';
+import type { StyleProp, ViewStyle } from 'react-native';
+type NavigatorStyle = NavigatorViewProps['style'];
+export declare const flat: (style: StyleProp<ViewStyle>[] | StyleProp<ViewStyle>) => NavigatorStyle;
+export {};

package/types/ui/src/lib/navigator-item-host.d.ts

@@ -0,0 +1,29 @@
+import { type NodeHandle } from '@kromatv/spatial-nav/react';
+import type { ReactNode, Ref } from 'react';
+import { type StyleProp, type ViewStyle } from 'react-native';
+import type { splitBoxLayers } from './box-layers';
+/** What a navigator node needs to render a control, identical on every target. */
+export interface NavigatorItemHostProps {
+    entry: Ref<NodeHandle | null>;
+    onSelect: () => void;
+    onLongSelect: (() => void) | undefined;
+    onFocus: () => void;
+    onBlur: () => void;
+    painted: StyleProp<ViewStyle>[];
+    layers: ReturnType<typeof splitBoxLayers> | null;
+    viewProps: object;
+    pointer: {
+        onHoverIn: () => void;
+        onHoverOut: () => void;
+        onPointerDown: () => void;
+        onPointerUp: () => void;
+    };
+    focused: boolean;
+    pressed: boolean;
+    render: (focused: boolean, pressed: boolean) => ReactNode;
+    renderFace: (focused: boolean, painted: StyleProp<ViewStyle>[]) => ReactNode;
+}
+/** The face lifts on the browser's single element; natively the lift rides the outer box. */
+export declare const faceLift: (_focused: boolean) => boolean;
+/** A navigator node as two views: the outer box placed and lifted, the painted face inside. */
+export declare function NavigatorItemHost({ entry, renderFace, focused, layers, onBlur, onFocus, onLongSelect, onSelect, painted, viewProps, }: Readonly<NavigatorItemHostProps>): ReactNode;

package/types/ui/src/lib/navigator-item-host.web.d.ts

@@ -0,0 +1,6 @@
+import type { ReactNode } from 'react';
+import type { NavigatorItemHostProps } from './navigator-item-host';
+/** The face lifts on the browser's single element; natively the lift rides the outer box. */
+export declare const faceLift: (focused: boolean) => boolean;
+/** A navigator node as ONE element: its style array stays classes and the pointer reaches it directly. */
+export declare function NavigatorItemHost({ entry, onBlur, onFocus, onLongSelect, onSelect, painted, pointer, pressed, render, viewProps, }: Readonly<NavigatorItemHostProps>): ReactNode;

package/types/ui/src/lib/overlay-host.d.ts

@@ -0,0 +1,23 @@
+import { type ReactNode } from 'react';
+export declare function OverlayHost({ children }: Readonly<{
+    children: ReactNode;
+}>): import("react").JSX.Element;
+/**
+ * Is there a host above this? Answerable before the node exists, which is what
+ * lets a caller decide what to BUILD from it - a dialog's panel behaves
+ * differently in a host than in the <Modal> it otherwise falls back to.
+ *
+ * `false` is not a failure: an app with no host (the browser client, a phone)
+ * has no reason for one, and the caller keeps whatever it did before.
+ */
+export declare function useOverlayHost(): boolean;
+/**
+ * Render `node` in the nearest <OverlayHost>, and say whether there was one.
+ *
+ * The node renders in the HOST's position in the React tree, so it reads the
+ * context the host sits in rather than the caller's. Everything app-wide (the
+ * client, the locale, the theme) is above the host and therefore still there; a
+ * context opened by a single screen is not, which is the one thing to know
+ * before putting a screen's own provider around a dialog's content.
+ */
+export declare function useOverlay(node: ReactNode | null): boolean;

package/types/ui/src/lib/overlay-z.d.ts

@@ -0,0 +1,5 @@
+export declare const OVERLAY_Z: {
+    readonly backdrop: number;
+    readonly panel: number;
+    readonly tooltip: number;
+};

package/types/ui/src/lib/pan-gestures.d.ts

@@ -0,0 +1,3 @@
+import { type PanResponderInstance } from 'react-native';
+/** The responder's handlers where a finger can drag it, null on a television. */
+export declare function panHandlers(pan: PanResponderInstance): import("react-native").GestureResponderHandlers | null;

package/types/ui/src/lib/part-context.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The context a compound's Root publishes, and the hook its parts read it with.
+ * `owner` is the part that provides it, written as a caller would: under
+ * `partContext<SelectState>('Select.Root')`, `useSelect('Label')` outside a Root
+ * throws `<Select.Label> must be used inside <Select.Root>`.
+ */
+declare function partContext<T>(owner: string): readonly [import("react").Context<T | null>, (part: string) => T];
+export { partContext };

package/types/ui/src/lib/perf-memory.d.ts

@@ -0,0 +1,12 @@
+export interface MemoryReading {
+    /** JS heap in use, MB. */
+    usedMb: number;
+    /** What the engine will let the heap grow to, MB, or 0 when it will not say. */
+    limitMb: number;
+}
+/** The JS heap right now, or null where the engine does not report one.
+ *
+ * Hermes keeps no `performance.memory`, and the numbers a native app would want
+ * (RSS, the image cache, the texture pool) are not the JS heap anyway, so this
+ * says nothing rather than something misleading. */
+export declare function readMemory(): MemoryReading | null;

package/types/ui/src/lib/perf-memory.web.d.ts

@@ -0,0 +1,4 @@
+import type { MemoryReading } from './perf-memory';
+/** The JS heap right now, or null where the engine does not report one. */
+export declare function readMemory(): MemoryReading | null;
+export type { MemoryReading };

package/types/ui/src/lib/perf-provider.d.ts

@@ -0,0 +1,8 @@
+import { type ReactNode } from 'react';
+import { type PerfSampler } from './perf';
+/** A measurement lifetime belongs to this root, including its rAF cleanup. */
+export declare function PerfProvider({ children, debug, }: Readonly<{
+    children: ReactNode;
+    debug?: boolean;
+}>): import("react").JSX.Element;
+export declare function usePerfSampler(): PerfSampler | null;

package/types/ui/src/lib/perf.d.ts

@@ -0,0 +1,35 @@
+export interface PerfReport {
+    fps: number;
+    worstFrame: number;
+    jankyFrames: number;
+    frameCount: number;
+    responseP50: number;
+    responseWorst: number;
+    responseCount: number;
+    /** The most recent `CHART_FRAMES` durations, oldest first, for the HUD's
+     *  chart. An average hides the shape of a stall; this is what shows whether
+     *  the last second was evenly slow or one long hitch. */
+    frames: readonly number[];
+    /** Focused grid cell as `row,col`, or `-` when no grid has the focus. */
+    gridCell: string;
+    /** JS heap in use, MB, or 0 where the engine reports none. */
+    heapMb: number;
+    /** What the heap may grow to, MB, or 0 where the engine reports none. */
+    heapLimitMb: number;
+}
+/** How many of the ring's samples a report carries: what the HUD's chart draws.
+ *  The rest of the window is only ever read as an average, and copying it out
+ *  twice a second is work on the device being measured. */
+export declare const CHART_FRAMES = 48;
+/** A recorder owned by one app root or measurement run. */
+export declare function createPerfSampler(): {
+    startPerf: () => void;
+    stopPerf: () => void;
+    resetPerf: () => void;
+    perfRunning: () => boolean;
+    perfReport: () => PerfReport;
+    markPress: () => void;
+    markFocus: () => void;
+    markGridFocus: (row: number, col: number) => void;
+};
+export type PerfSampler = ReturnType<typeof createPerfSampler>;

package/types/ui/src/lib/platform.d.ts

@@ -0,0 +1,3 @@
+/** True on the browser targets (Vite: web, Tizen, webOS, desktop, workbench),
+ *  false under Metro (Apple TV, Android TV, iOS, Android). */
+export declare const WEB = false;

package/types/ui/src/lib/platform.web.d.ts

@@ -0,0 +1,2 @@
+/** True on the browser targets; this file IS the web resolution. */
+export declare const WEB = true;

package/types/ui/src/lib/player/native-player.d.ts

@@ -0,0 +1,13 @@
+export interface NativeBufferBudget {
+    preferredForwardBufferDuration: number;
+    maxBufferBytes: number;
+}
+/** The OS whose platform player plays natively: AVPlayer on `ios`, Media3 on `android`. */
+export declare function nativePlayerOs(): 'ios' | 'android';
+/** The platform player's name, as the stats panel and the logs spell it. */
+export declare function nativePlayerPlane(): 'media3' | 'AVPlayer';
+/** The buffer bounds to hand expo-video's `bufferOptions`, or null where the
+ * platform is left to decide for itself. */
+export declare function nativeBufferBudget(): NativeBufferBudget | null;
+/** The device a native build runs on, as the player names it to the server. */
+export declare function nativePlayerDevice(): 'Apple TV' | 'Android TV';

package/types/ui/src/lib/player/panel-travel.d.ts

@@ -0,0 +1,10 @@
+import { Animated } from 'react-native';
+/** The settings panel's entrance and exit: on screen when `shown`, `width`
+ * pixels off its edge and transparent when not. Driven by Animated with the
+ * native driver; the result belongs on an `Animated.View`. */
+export declare function usePanelTravel(shown: boolean, width: number): {
+    opacity: Animated.AnimatedInterpolation<string | number>;
+    transform: {
+        translateX: Animated.AnimatedInterpolation<string | number>;
+    }[];
+};

package/types/ui/src/lib/player/panel-travel.web.d.ts

@@ -0,0 +1,5 @@
+import type { ViewStyle } from 'react-native';
+/** The settings panel's entrance and exit: on screen when `shown`, `width`
+ * pixels off its edge and transparent when not. The browsers have no native
+ * driver, so the panel travels on a CSS transition owned by the compositor. */
+export declare function usePanelTravel(shown: boolean, width: number): ViewStyle;

package/types/ui/src/lib/player/pointer-to-canvas.d.ts

@@ -0,0 +1,4 @@
+/** A pointer's `locationX` on a track, in the track's canvas units. React Native's
+ * hit test undoes the ancestor transforms first, so the offset already arrives in
+ * canvas units: rescaling it doubled every offset on a 1920-into-960 stage. */
+export declare function pointerToCanvas(locationX: number, _onScreen: number, _inCanvas: number): number;

package/types/ui/src/lib/player/pointer-to-canvas.web.d.ts

@@ -0,0 +1,4 @@
+/** A pointer's `locationX` on a track, in the track's canvas units. A browser
+ * hands it out in screen pixels, so it is rescaled by the track's on-screen
+ * width; an unmeasured track (0) counts as unscaled. */
+export declare function pointerToCanvas(locationX: number, onScreen: number, inCanvas: number): number;

package/types/ui/src/lib/player/rise.d.ts

@@ -0,0 +1,12 @@
+import { type StyleProp, type ViewStyle } from 'react-native';
+export declare const RISE_MS = 420;
+export declare const RISE_PX = 26;
+export interface Rise {
+    /** The art and its scrims, fading up from black. */
+    veil: StyleProp<ViewStyle>;
+    /** The copy, arriving a little from below. */
+    copy: StyleProp<ViewStyle>;
+}
+/** A film does not cut to a menu: the art fades up and the copy settles into
+ * it. Both belong on an `Animated.View`, since they carry an `Animated.Value`. */
+export declare function useRise(): Rise;

package/types/ui/src/lib/player/rise.web.d.ts

@@ -0,0 +1,10 @@
+import type { StyleProp, ViewStyle } from 'react-native';
+export declare const RISE_MS = 420;
+export declare const RISE_PX = 26;
+export interface Rise {
+    veil: StyleProp<ViewStyle>;
+    copy: StyleProp<ViewStyle>;
+}
+/** A film does not cut to a menu: the art fades up and the copy settles into
+ * it. Plain styles, so they ride on the `Animated.View` the native half needs. */
+export declare function useRise(): Rise;

package/types/ui/src/lib/player/sheet-moves-ring.d.ts

@@ -0,0 +1,3 @@
+/** Whether the up-next sheet posts a routed direction to its navigator itself:
+ * not when a configured remote already delivers it there. */
+export declare function sheetMovesRing(remoteEnabled: boolean): boolean;

package/types/ui/src/lib/player/sheet-moves-ring.web.d.ts

@@ -0,0 +1,3 @@
+/** Whether the up-next sheet posts a routed direction to its navigator itself:
+ * always, since the player swallows every key it routes. */
+export declare function sheetMovesRing(_remoteEnabled: boolean): boolean;

package/types/ui/src/lib/player/sheet-slide.d.ts

@@ -0,0 +1,5 @@
+import { type StyleProp, type ViewStyle } from 'react-native';
+/** The sheet's transform: home when `open`, parked `by` pixels down the screen
+ * when not. The result belongs on an `Animated.View`: it carries an
+ * `Animated.Value`. */
+export declare function useSheetSlide(open: boolean, by: number): StyleProp<ViewStyle>;