shared/globals.native.d.ts - master - githubmirror/client

shared/globals.native.d.ts
132 строки4 KB
chrisnojima
build(mobile): harden gobuild.sh and go bind pipeline 2 (#29364)
08 июл 2026, 15:25
08 июл 2026, 15:2519b55b3
// Globals available on React Native's `global` object.
// `location` and `window` only exist in Chrome DevTools remote debugging builds.
declare var location: unknown
declare var window:
  | {
      __perfReact?: unknown
      requestIdleCallback?: (
        cb: (info: {didTimeout: boolean; timeRemaining: () => number}) => void,
        opts?: {timeout?: number}
      ) => number
      cancelIdleCallback?: (handle: number) => void
      addEventListener: (event: string, cb: () => void) => void
      location: {search: string}
    }
  | undefined

// Stub for Web Notification API used in merged util/misc.tsx (desktop-only at runtime)
declare class Notification {
  onclick: (() => void) | null
  onclose: (() => void) | null
  constructor(title: string, options?: {body?: string; silent?: boolean})
}

// Stub for navigator.onLine used in merged desktop-only init code (guarded by !isMobile)
declare var navigator: {onLine: boolean}

// Minimal File/DataTransfer stubs for shared files that use these types
// (actual drag-and-drop only runs on desktop, but the code is in shared files)
interface File {
  readonly type: string
  readonly name: string
}
interface DataTransfer {
  readonly files: ReadonlyArray<File>
  readonly types: ReadonlyArray<string>
}

// Stubs for DOM observer/element types used in merged platform files.
// Desktop build excludes this file so declare class is safe (no conflict with lib.dom).
interface Element {}
interface HTMLElement extends Element {}
interface HTMLDivElement extends HTMLElement {
  clientWidth?: number
}

interface DOMRectReadOnly {
  readonly width: number
  readonly height: number
  readonly top: number
  readonly left: number
  readonly bottom: number
  readonly right: number
  readonly x: number
  readonly y: number
}

interface ResizeObserverEntry {
  readonly target: Element
  readonly contentRect: DOMRectReadOnly
}
declare class ResizeObserver {
  constructor(callback: (entries: ResizeObserverEntry[], observer: ResizeObserver) => void)
  disconnect(): void
  observe(target: Element): void
  unobserve(target: Element): void
}

type IntersectionObserverCallback = (
  entries: IntersectionObserverEntry[],
  observer: IntersectionObserver
) => void
interface IntersectionObserverInit {
  root?: Element | Document | null
  rootMargin?: string
  threshold?: number | number[]
}
interface IntersectionObserverEntry {
  readonly isIntersecting: boolean
  readonly target: Element
  readonly time: number
  readonly intersectionRatio: number
  readonly rootBounds: DOMRectReadOnly | null
  readonly boundingClientRect: DOMRectReadOnly
  readonly intersectionRect: DOMRectReadOnly
}
declare class IntersectionObserver {
  readonly POLL_INTERVAL: number | null | undefined
  readonly USE_MUTATION_OBSERVER: boolean | undefined
  constructor(callback: IntersectionObserverCallback, options?: IntersectionObserverInit)
  observe(target: Element): void
  unobserve(target: Element): void
  disconnect(): void
}

declare function requestAnimationFrame(callback: FrameRequestCallback): number
type FrameRequestCallback = (time: number) => void

// Stub for keyboard event key property used in desktop key handler (desktop-only at runtime)
interface KeyboardEvent {
  readonly key: string
}

// Stub for document used in merged initDesktopStyles (desktop-only at runtime, guarded by !isMobile)
interface DOMNode {
  firstChild: DOMElement | null
  appendChild(child: DOMNode): DOMNode
  removeChild(child: DOMNode): DOMNode
}
interface DOMElement extends DOMNode {
  setAttribute(k: string, v: string): void
  classList: {add(c: string): void}
  clientWidth: number
  appendChild(child: DOMNode): DOMNode
}
interface DOMTextNode extends DOMNode {}
declare var document: {
  activeElement: unknown
  addEventListener(type: string, listener: (e: any) => void, useCapture?: boolean): void
  removeEventListener(type: string, listener: (e: any) => void, useCapture?: boolean): void
  getElementById(id: string): DOMElement | null
  head: {appendChild(el: DOMElement): void}
  body: {
    appendChild(el: DOMElement): void
    removeChild(el: DOMElement): void
    classList: {add(c: string): void}
    addEventListener(type: string, listener: (e: any) => void, useCapture?: boolean): void
    removeEventListener(type: string, listener: (e: any) => void, useCapture?: boolean): void
  }
  createElement(tag: string): DOMElement
  createTextNode(text: string): DOMTextNode
  documentElement: {style: {colorScheme: string}}
}