@ghia/native 0.0.0 → 0.11.0

package/dist/events/types.d.ts

@@ -0,0 +1,269 @@
+import type { RootEvent } from "./dispatch.js";
+/** One entry of `DataTransfer.files`. Filled in by native on file drags. */
+export type HostFile = {
+    path: string;
+    name: string;
+    size: number;
+    /** MIME type guessed from the extension, empty when unknown. */
+    type: string;
+    lastModified: number;
+};
+export type HostDropEffect = "none" | "copy" | "link" | "move";
+export type HostEffectAllowed = "none" | "copy" | "copyLink" | "copyMove" | "link" | "linkMove" | "move" | "all" | "uninitialized";
+/**
+ * The data of one drag, shared by every event of it. DOM protected mode
+ * applies: `getData` returns `""` and `setData` does nothing except in
+ * `dragstart` (where both work) and `drop` (where only `getData` does).
+ */
+export type HostDataTransfer = {
+    /**
+     * What the drop will do. A `dragover` handler picks it; it must be allowed
+     * by `effectAllowed` and not `"none"` for the drop to be delivered. In
+     * `dragend` it is what the drop did, `"none"` when nothing was dropped.
+     */
+    dropEffect: HostDropEffect;
+    /** What the source allows. Writable in `dragstart` only. */
+    effectAllowed: HostEffectAllowed;
+    readonly files: readonly HostFile[];
+    readonly types: readonly string[];
+    getData(format: string): string;
+    setData(format: string, data: string): void;
+    clearData(format?: string): void;
+    /** Accepted and ignored: there is no drag image. */
+    setDragImage(element: unknown, x: number, y: number): void;
+};
+/**
+ * What every dispatched event carries, like the DOM `Event`. `target` is the
+ * element the event was aimed at and `currentTarget` the one whose handler is
+ * running (the `window` or `document` object during their phases). Both are
+ * the object a `ref` gives for the element, `relatedTarget` too; use
+ * `elementId` for the numeric id native knows it by.
+ */
+export interface HostDomEvent extends RootEvent {
+    readonly type: string;
+    /** Never `null` for an element's handler: only `window` and `document` hear an event with no element. */
+    readonly target: object;
+    readonly currentTarget: object | null;
+    /** The elements on the propagation path, target first. */
+    composedPath(): object[];
+    /** 1 capturing, 2 at target, 3 bubbling. */
+    readonly eventPhase: number;
+    readonly bubbles: boolean;
+    readonly cancelable: boolean;
+    readonly timeStamp: number;
+    readonly defaultPrevented: boolean;
+    stopPropagation(): void;
+    stopImmediatePropagation(): void;
+    preventDefault(): void;
+}
+/**
+ * Coordinates and buttons of a mouse event. `clientX`/`clientY` are window
+ * coordinates; `offsetX`/`offsetY` are relative to the target's padding edge.
+ * Native fills in the coordinates as the pointer model lands, so each can be
+ * absent. `pointerId` and `pointerType` are always there, mouse event or not,
+ * as on a DOM `PointerEvent`.
+ */
+export interface HostMouseEvent extends HostDomEvent {
+    clientX?: number;
+    clientY?: number;
+    offsetX?: number;
+    offsetY?: number;
+    /**
+     * How far the pointer moved since the previous move, in logical pixels: the
+     * real motion while the pointer is locked (`requestPointerLock()`), when
+     * `clientX`/`clientY` stand still. `0` on every event but `mousemove` and
+     * `pointermove`, as in the DOM, and on a platform that reports no relative
+     * motion (everything but macOS).
+     */
+    movementX: number;
+    movementY: number;
+    /** Buttons held right now, as a bitmask: 1 primary, 2 secondary, 4 auxiliary. */
+    buttons?: number;
+    /** Consecutive clicks: 1 single, 2 double. */
+    detail?: number;
+    /** 1 for the mouse, -1 for a click no pointer made (VoiceOver, Enter or Space on a button). */
+    pointerId: number;
+    /** `""` for a click no pointer made. */
+    pointerType: "mouse" | "pen" | "touch" | "";
+}
+export interface HostPointerEvent extends HostMouseEvent {
+}
+/**
+ * A drag fires `dragenter`, `dragover`, `dragleave` and `drop` at what is under
+ * the pointer, and all carry the drag's one `dataTransfer`. `drop` is delivered
+ * only after a `dragover` whose handler called `preventDefault()`.
+ *
+ * Files dragged from the OS fire only those four. Dragging an element that has
+ * `draggable` adds `dragstart`, `drag` and `dragend` at the dragged element,
+ * the source. No pointer or mouse event fires during either kind of drag.
+ */
+export interface HostDragEvent extends HostMouseEvent {
+    dataTransfer?: HostDataTransfer;
+}
+/**
+ * `wheel`: one wheel or trackpad input, aimed at the element under the pointer
+ * (pointer capture does not redirect it). It bubbles and `preventDefault()` cancels
+ * the scroll that input would cause, but only where native can wait for the handler
+ * (macOS and the test renderer).
+ *
+ * `deltaX` and `deltaY` are pixels, positive for down and right, like the DOM.
+ * `deltaMode` is always `0`: a mouse wheel's lines are converted to pixels natively
+ * at 20 px a line. `precise` says a trackpad sent it, and `touchPhase` (`"started"`,
+ * `"moved"`, `"ended"` or `"cancelled"`) where it sits in a gesture. It fires
+ * whether or not anything scrolls.
+ */
+export interface HostWheelEvent extends HostMouseEvent {
+    deltaX: number;
+    deltaY: number;
+    deltaMode: 0;
+    precise: boolean;
+    touchPhase: "started" | "moved" | "ended" | "cancelled";
+}
+export interface PointerEventHandlerProps {
+    /** Primary button only, like the DOM. Use `onAuxClick` for the others. */
+    onClick?: (event: HostPointerEvent) => void;
+    /** Non-primary click. */
+    onAuxClick?: (event: HostPointerEvent) => void;
+    onDoubleClick?: (event: HostMouseEvent) => void;
+    onContextMenu?: (event: HostPointerEvent) => void;
+    onMouseDown?: (event: HostMouseEvent) => void;
+    onMouseUp?: (event: HostMouseEvent) => void;
+    onMouseMove?: (event: HostMouseEvent) => void;
+    /** Does not bubble: fires on each element the pointer enters. */
+    onMouseEnter?: (event: HostMouseEvent) => void;
+    /** Does not bubble: fires on each element the pointer leaves. */
+    onMouseLeave?: (event: HostMouseEvent) => void;
+    onMouseOver?: (event: HostMouseEvent) => void;
+    onMouseOut?: (event: HostMouseEvent) => void;
+    onPointerDown?: (event: HostPointerEvent) => void;
+    onPointerMove?: (event: HostPointerEvent) => void;
+    onPointerUp?: (event: HostPointerEvent) => void;
+    onPointerEnter?: (event: HostPointerEvent) => void;
+    onPointerLeave?: (event: HostPointerEvent) => void;
+    onPointerOver?: (event: HostPointerEvent) => void;
+    onPointerOut?: (event: HostPointerEvent) => void;
+    onPointerCancel?: (event: HostPointerEvent) => void;
+    onGotPointerCapture?: (event: HostPointerEvent) => void;
+    onLostPointerCapture?: (event: HostPointerEvent) => void;
+    /** On a `draggable` source. `preventDefault()` cancels the drag. */
+    onDragStart?: (event: HostDragEvent) => void;
+    /** On the source, on each move. Only fires when something listens. */
+    onDrag?: (event: HostDragEvent) => void;
+    /** On the source. `dataTransfer.dropEffect` is `"none"` if nothing was dropped. */
+    onDragEnd?: (event: HostDragEvent) => void;
+    onDragEnter?: (event: HostDragEvent) => void;
+    /** `preventDefault()` makes the element a drop target. */
+    onDragOver?: (event: HostDragEvent) => void;
+    onDragLeave?: (event: HostDragEvent) => void;
+    onDrop?: (event: HostDragEvent) => void;
+    onWheel?: (event: HostWheelEvent) => void;
+}
+/**
+ * `transitionrun`, `transitionstart`, `transitionend` and `transitioncancel`.
+ * They bubble from the transitioning element (`target`) and cannot be cancelled.
+ * `propertyName` is the CSS name (`background-color`), `elapsedTime` is in
+ * seconds and `pseudoElement` is always `""`.
+ */
+export interface HostTransitionEvent extends HostDomEvent {
+    propertyName: string;
+    elapsedTime: number;
+    pseudoElement: "";
+}
+/**
+ * `animationstart`, `animationiteration`, `animationend` and `animationcancel`.
+ * They bubble from the animating element (`target`) and cannot be cancelled.
+ * `animationName` is the name given to `defineKeyframes`, `elapsedTime` is in
+ * seconds and `pseudoElement` is always `""`.
+ */
+export interface HostAnimationEvent extends HostDomEvent {
+    animationName: string;
+    elapsedTime: number;
+    pseudoElement: "";
+}
+export interface AnimationEventHandlerProps {
+    /** A transition was created, before its delay. */
+    onTransitionRun?: (event: HostTransitionEvent) => void;
+    /** A transition's delay ended and it started animating. */
+    onTransitionStart?: (event: HostTransitionEvent) => void;
+    /** A transition reached its end value. */
+    onTransitionEnd?: (event: HostTransitionEvent) => void;
+    /** A transition was interrupted: its property changed again, left the
+     *  transition list, or became owned by `motion`. */
+    onTransitionCancel?: (event: HostTransitionEvent) => void;
+    /** An animation's delay ended and it started playing. */
+    onAnimationStart?: (event: HostAnimationEvent) => void;
+    /** An animation began another iteration. Not fired for the last one. */
+    onAnimationIteration?: (event: HostAnimationEvent) => void;
+    /** An animation finished its last iteration. */
+    onAnimationEnd?: (event: HostAnimationEvent) => void;
+    /** An animation was interrupted before it ended: its name left
+     *  `animation-name` or the name changed. */
+    onAnimationCancel?: (event: HostAnimationEvent) => void;
+}
+/**
+ * `contentvisibilityautostatechange`: an element with `contentVisibility: "auto"` began or stopped
+ * skipping its content. It bubbles from the element (`target`) and can be cancelled, which does
+ * nothing. `skipped` is whether the content is skipped now.
+ */
+export interface HostContentVisibilityAutoStateChangeEvent extends HostDomEvent {
+    skipped: boolean;
+}
+export interface ContentVisibilityEventHandlerProps {
+    /**
+     * An `auto` element is told once it has been decided whether it is near enough to the viewport to show its
+     * content, and again each time that changes, after the frame that applied it. A mounted element near the viewport
+     * is told `skipped: false` once.
+     */
+    onContentVisibilityAutoStateChange?: (event: HostContentVisibilityAutoStateChangeEvent) => void;
+}
+/**
+ * `compositionstart`, `compositionupdate` and `compositionend`: an input method
+ * composing text in an `<input>` or `<textarea>`. They bubble from the text
+ * input (`target`) and cannot be cancelled. `data` is the text the composition
+ * replaces on start (the selection, usually `""`), the composition's current
+ * text on update and the text it ended with on end. Only macOS composes.
+ */
+export interface HostCompositionEvent extends HostDomEvent {
+    data: string;
+}
+/**
+ * The `onChange` event of an `<input>` or `<textarea>`: one edit of its text,
+ * which is what the DOM calls `input`. `inputType` and `data` are those of an
+ * `InputEvent` as Chrome fills them: `insertText`, `insertFromPaste` and
+ * `insertCompositionText` carry the inserted text in `data`; `insertLineBreak`,
+ * the `delete…` types (`deleteContentBackward`, `deleteContentForward`,
+ * `deleteWordBackward`, `deleteWordForward`, `deleteSoftLineBackward`,
+ * `deleteSoftLineForward`, `deleteByCut`, `deleteCompositionText`) and
+ * `historyUndo` / `historyRedo` have `data` `null`. The number stepper's edit
+ * has `inputType` `""`. `isComposing` is true for the edits of a composition,
+ * the last of which comes before its `compositionend`. Setting `value` from
+ * outside fires none.
+ */
+export interface HostInputEvent extends Omit<HostDomEvent, "data"> {
+    /** The text after the edit. */
+    readonly value: string;
+    readonly inputType: string;
+    readonly data: string | null;
+    readonly isComposing: boolean;
+}
+export interface CompositionEventHandlerProps {
+    /** A composition began. Fires before its first `compositionupdate`. */
+    onCompositionStart?: (event: HostCompositionEvent) => void;
+    /** The composition's text changed. Fires before the `onChange` of that edit. */
+    onCompositionUpdate?: (event: HostCompositionEvent) => void;
+    /** The composition ended, committed or cancelled. Fires after the `onChange` of its final edit. */
+    onCompositionEnd?: (event: HostCompositionEvent) => void;
+}
+type CaptureProps<Props> = {
+    [Name in keyof Props & string as `${Name}Capture`]: Props[Name];
+};
+/** Each pointer, mouse and drag handler, plus its capture-phase `on…Capture` twin. */
+export type PointerEventProps = PointerEventHandlerProps & Partial<CaptureProps<PointerEventHandlerProps>>;
+/** Each transition and animation handler, plus its capture-phase `on…Capture` twin. */
+export type AnimationEventProps = AnimationEventHandlerProps & Partial<CaptureProps<AnimationEventHandlerProps>>;
+/** The `content-visibility` handler, plus its capture-phase `on…Capture` twin. */
+export type ContentVisibilityEventProps = ContentVisibilityEventHandlerProps & Partial<CaptureProps<ContentVisibilityEventHandlerProps>>;
+/** Each composition handler, plus its capture-phase `on…Capture` twin. */
+export type CompositionEventProps = CompositionEventHandlerProps & Partial<CaptureProps<CompositionEventHandlerProps>>;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/events/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../js/events/types.ts"],"names":[],"mappings":"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"}

package/dist/events/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/events/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../js/events/types.ts"],"names":[],"mappings":""}

package/dist/events/window-target.d.ts

@@ -0,0 +1,120 @@
+import type { EventPayload } from "../../index.js";
+import type { Animation } from "../web-animations.js";
+import { type DomDispatchResult, type DomEvent, type DomEventRoot, type DomEventState } from "./dispatch.js";
+export type WindowEventListener = (event: DomEvent) => void;
+export interface AddEventListenerOptions {
+    /** Listen in the capture phase, before the element tree sees the event. */
+    capture?: boolean;
+    /** Remove the listener after its first call. */
+    once?: boolean;
+}
+/**
+ * The `window` and `document` of a GPUIX app: an `EventTarget` shaped like the
+ * DOM's, for events that reach the top of the tree.
+ *
+ * Event types are the DOM's lowercase names (`keydown`, `keyup`, `focusin`,
+ * `focusout`, `focus`, `blur`). `focus` and `blur` do not bubble, so only a
+ * capture listener hears them, as in the DOM.
+ */
+export declare class GpuixEventTarget {
+    private readonly onTypesChange?;
+    private readonly registrations;
+    /** @param onTypesChange Called when a type gains its first listener or loses its last. */
+    constructor(onTypesChange?: (() => void) | undefined);
+    addEventListener(type: string, listener: WindowEventListener, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener(type: string, listener: WindowEventListener, options?: boolean | Pick<AddEventListenerOptions, "capture">): void;
+    /** Whether any listener is registered for `type` in either phase. */
+    hasListeners(type: string): boolean;
+    /** @internal The types with a listener in either phase. */
+    listenedTypes(): string[];
+    /**
+     * @internal Calls the listeners of one phase. A listener that throws does not
+     * end the phase: its error goes to `fail`.
+     */
+    run(event: DomEvent, state: DomEventState, capture: boolean, phase: number, fail: (error: unknown) => void): void;
+}
+/**
+ * The `document` of a GPUIX app: the `window` target plus `activeElement` and
+ * `pointerLockElement`.
+ *
+ * `Element` is what the adapter hands out for an element: React's host
+ * instance, Solid's element.
+ */
+export declare class GpuixDocument<Element = unknown> extends GpuixEventTarget {
+    /**
+     * The focused element, the same object a `ref` gives, or `null` when nothing
+     * is focused. With several windows (one root each), the window that holds
+     * focus decides: of the roots that have a focused element, the one that heard
+     * a focus event last.
+     */
+    get activeElement(): Element | null;
+    /**
+     * The element that holds the pointer lock, the same object a `ref` gives, or
+     * `null` while none does. Where the platform can lock (macOS) it is held as
+     * soon as `requestPointerLock()` returns, before `pointerlockchange` arrives.
+     */
+    get pointerLockElement(): Element | null;
+    /**
+     * The CSS transitions, then the CSS animations, of every window, as `Animation` objects: for
+     * each renderer in the order its root was installed, those of its elements in document order
+     * (every transition, then every animation). The same objects `element.getAnimations()` gives.
+     */
+    getAnimations(): Animation[];
+}
+/** @internal Called by `web-animations` once, with how to list the animations of one renderer's window. */
+export declare function setDocumentAnimations(list: (renderer: object) => Animation[]): void;
+export declare const window: GpuixEventTarget;
+export declare const document: GpuixDocument<unknown>;
+/**
+ * Lets the runtime see the elements of the root that drives `renderer`, through
+ * `elementById`: the object the adapter gives for an element id, as a `ref`
+ * does. `document.activeElement` and the `target`, `currentTarget` and
+ * `relatedTarget` of every event read it. The returned function takes the root
+ * out again. A renderer that cannot report focus still names its elements; it
+ * just never has an `activeElement`.
+ */
+export declare function installElementSource(renderer: {
+    getFocusedElementId?: () => number | null;
+    pointerLockElement?: () => number | null;
+}, elementById: (id: number) => object | undefined): () => void;
+/** Drops the root of `renderer` whose window is gone, so nothing asks it for elements. */
+export declare function forgetElementSource(renderer: object): void;
+/**
+ * Stops asking `renderer` what is focused or animating, for a renderer whose
+ * window another took over or that was closed: its root still names its
+ * elements, but the window it would ask about is not its own any more.
+ */
+export declare function forgetWindowSource(renderer: object): void;
+/**
+ * @internal The element `renderer`'s root has for `id`, or `undefined` once it
+ * dropped it. Throws when no adapter installed a source for `renderer`: the
+ * ids of its events cannot be turned into elements.
+ */
+export declare function elementOf(renderer: object, id: number): object | undefined;
+/** @internal Records that `owner`'s window just moved focus, for the tie-break of `activeElement`. */
+export declare function noteFocusEvent(owner: object): void;
+/**
+ * Keeps `renderer` told which event types `window` or `document` listens for,
+ * so native produces them even when no element on the event's path does (the
+ * pointer over bare background). Sends the current set now and again whenever
+ * it changes. The returned function clears it on the renderer and stops.
+ */
+export declare function syncWindowEventListeners(renderer: {
+    setWindowEventListeners?: (types: string[]) => void;
+}): () => void;
+/** Whether the DOM aims the event at `document` itself, with no element on the path. */
+export declare function isDocumentEvent(eventType: string): boolean;
+export interface PropagationResult extends DomDispatchResult {
+    /** The event the listeners saw. */
+    event: DomEvent;
+}
+/**
+ * Runs an event through the whole propagation: window capture, document
+ * capture, the element path, document bubble, window bubble. An event with no
+ * element path is aimed at the window and only those two targets hear it.
+ *
+ * `scoped` is a window-level target that belongs to one renderer, such as the
+ * `onKeyDown` option of its root. It hears the bubble phase after `window`.
+ */
+export declare function dispatchPropagating(root: DomEventRoot, payload: EventPayload, scoped?: GpuixEventTarget): PropagationResult;
+//# sourceMappingURL=window-target.d.ts.map

package/dist/events/window-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window-target.d.ts","sourceRoot":"","sources":["../../js/events/window-target.ts"],"names":[],"mappings":"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"}