import { HostBackend } from "./backend.js";
import { NativeCommandBackend, NativeCommandBackendOptions, NativeCommandNode, createNativeCommandBackend } from "./native-command-backend.js";

//#region src/native.d.ts
/**
 * 🔬 Research track. The native (iOS/Android) host backend. Extends the same
 * {@link HostBackend} contract the reconciler already speaks, so when it lands,
 * `render()` works against native views with no reconciler changes.
 */
interface NativeBackend<N> extends HostBackend<N> {
  /** The target platform this backend drives. */
  readonly platform: 'ios' | 'android';
}
/**
 * 🔬 Research track. A GPU-canvas backend (wgpu/WebGPU) for pixel-perfect custom
 * UI. Composes with the native strand: a canvas subtree renders to a GPU surface
 * embedded among native host nodes.
 */
interface GpuCanvasBackend<N> extends HostBackend<N> {
  /** Marks this backend as drawing to a GPU canvas surface. */
  readonly surface: 'gpu-canvas';
}
/**
 * 🔬 Research track — a direct iOS/Android runtime backend that draws platform views.
 * **Not implemented**: throws {@link NotImplementedError}.
 *
 * Today, drive {@link createNativeCommandBackend} to produce the native command
 * stream consumed by the verified host projects in `examples/native-hosts/`, or
 * {@link createDomBackend} for the web.
 *
 * @experimental
 */
declare function createNativeBackend(_platform: 'ios' | 'android'): never;
/**
 * 🔬 Research track — not implemented. Throws {@link NotImplementedError}. (Named `Gpu…` to distinguish it
 * from the IMPLEMENTED 2D scene backend {@link import('./canvas').createCanvas2DBackend}.)
 *
 * @experimental
 */
declare function createGpuCanvasBackend(): never;
//#endregion
export { GpuCanvasBackend, NativeBackend, createGpuCanvasBackend, createNativeBackend };
//# sourceMappingURL=native.d.ts.map