@ghia/native 0.0.0 → 0.11.0

package/dist/automation/protocol.js

@@ -0,0 +1,320 @@
+/// Typed GPUIX automation protocol and SSE codec.
+///
+/// Wire format is SSE `data:` lines so `eventsource-parser` can extract
+/// messages from noisy stdout. JSON carries every field. Do not emit SSE
+/// `id:` or `event:` fields; process logs that start with those prefixes
+/// would otherwise leak into the next message.
+import { createParser } from "eventsource-parser";
+import { z } from "zod";
+export const PROTOCOL_VERSION = 1;
+export const automationErrorCodes = [
+    "Timeout",
+    "NotFound",
+    "Ambiguous",
+    "Protocol",
+    "Closed",
+    "Unsupported",
+    "Security",
+    "Cancelled",
+];
+export class AutomationError extends Error {
+    code;
+    data;
+    constructor(code, message, data) {
+        super(message);
+        this.name = "AutomationError";
+        this.code = code;
+        this.data = data;
+    }
+}
+const errorCodeSchema = z.enum(automationErrorCodes);
+const pointSchema = z.object({
+    x: z.number(),
+    y: z.number(),
+});
+const buttonSchema = z.number().int().min(0).max(2).optional();
+/** Held modifiers, hyphenated: `"cmd"`, `"cmd-shift"`, `"alt"`. */
+const modifiersSchema = z.string().optional();
+export const boundsSchema = z.object({
+    x: z.number(),
+    y: z.number(),
+    width: z.number(),
+    height: z.number(),
+});
+export const treeNodeSchema = z.lazy(() => z.object({
+    id: z.number(),
+    type: z.string(),
+    text: z.string().optional(),
+    testId: z.string().optional(),
+    style: z.record(z.string(), z.unknown()).optional(),
+    events: z.array(z.string()).optional(),
+    customProps: z.record(z.string(), z.unknown()).optional(),
+    bounds: boundsSchema.optional(),
+    children: z.array(treeNodeSchema).optional(),
+}));
+const okSchema = z.object({ ok: z.literal(true) });
+const capabilitiesSchema = z.array(z.enum(["input", "screenshot", "clock", "tree"]));
+/** Single source of truth for method names, params, and results. */
+export const methods = {
+    initialize: {
+        params: z.object({
+            protocolVersion: z.literal(PROTOCOL_VERSION),
+            client: z.string(),
+        }),
+        result: z.object({
+            protocolVersion: z.literal(PROTOCOL_VERSION),
+            pid: z.number().int(),
+            capabilities: capabilitiesSchema,
+            window: z.object({
+                width: z.number(),
+                height: z.number(),
+            }),
+        }),
+    },
+    cancel: {
+        params: z.object({ id: z.number().int() }),
+        result: okSchema,
+    },
+    click: {
+        params: z.object({
+            x: z.number(),
+            y: z.number(),
+            button: buttonSchema,
+            modifiers: modifiersSchema,
+        }),
+        result: okSchema,
+    },
+    mouseDown: {
+        params: pointSchema.extend({
+            button: buttonSchema,
+            modifiers: modifiersSchema,
+        }),
+        result: okSchema,
+    },
+    mouseUp: {
+        params: pointSchema.extend({
+            button: buttonSchema,
+            modifiers: modifiersSchema,
+        }),
+        result: okSchema,
+    },
+    mouseMove: {
+        params: pointSchema.extend({
+            modifiers: modifiersSchema,
+        }),
+        result: okSchema,
+    },
+    scrollWheel: {
+        params: pointSchema.extend({
+            deltaX: z.number(),
+            deltaY: z.number(),
+            modifiers: modifiersSchema,
+        }),
+        result: okSchema,
+    },
+    keystrokes: {
+        params: z.object({
+            keys: z.string(),
+            elementId: z.number().optional(),
+        }),
+        result: okSchema,
+    },
+    keyDown: {
+        params: z.object({
+            key: z.string(),
+            isHeld: z.boolean().optional(),
+            elementId: z.number().optional(),
+        }),
+        result: okSchema,
+    },
+    keyUp: {
+        params: z.object({
+            key: z.string(),
+            elementId: z.number().optional(),
+        }),
+        result: okSchema,
+    },
+    focus: {
+        params: z.object({ elementId: z.number() }),
+        result: okSchema,
+    },
+    blur: {
+        params: z.object({}),
+        result: okSchema,
+    },
+    scrollTo: {
+        // The DOM's scroll position (`scrollLeft`, `scrollTop`, zero or more), not GPUI's offset.
+        params: z.object({
+            elementId: z.number(),
+            x: z.number(),
+            y: z.number(),
+        }),
+        result: okSchema,
+    },
+    getScrollOffset: {
+        // `[scrollLeft, scrollTop]`, zero or more.
+        params: z.object({ elementId: z.number() }),
+        result: z.object({
+            offset: z.tuple([z.number(), z.number()]).nullable(),
+        }),
+    },
+    getTree: {
+        params: z.object({}),
+        result: z.object({ tree: treeNodeSchema.nullable() }),
+    },
+    getPaintedText: {
+        params: z.object({}),
+        result: z.object({ text: z.array(z.string()) }),
+    },
+    getAllText: {
+        params: z.object({}),
+        result: z.object({ text: z.array(z.string()) }),
+    },
+    getBounds: {
+        params: z.object({ elementId: z.number() }),
+        result: z.object({ bounds: boundsSchema.nullable() }),
+    },
+    getSelectedText: {
+        params: z.object({}),
+        result: z.object({ text: z.string().nullable() }),
+    },
+    clearSelection: {
+        params: z.object({}),
+        result: okSchema,
+    },
+    screenshot: {
+        params: z.object({ path: z.string() }),
+        result: z.object({ path: z.string() }),
+    },
+    clockPause: {
+        params: z.object({}),
+        result: z.object({ nowMs: z.number() }),
+    },
+    clockSet: {
+        params: z.object({ nowMs: z.number().nonnegative() }),
+        result: z.object({ nowMs: z.number() }),
+    },
+    clockFastForward: {
+        params: z.object({ deltaMs: z.number().nonnegative() }),
+        result: z.object({ nowMs: z.number() }),
+    },
+    clockResume: {
+        params: z.object({}),
+        result: z.object({ nowMs: z.number() }),
+    },
+};
+export const serverEventNames = ["console", "frame", "closed"];
+const methodNames = Object.keys(methods);
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseMethodName(value) {
+    if (typeof value !== "string" || !methodNames.includes(value)) {
+        throw new AutomationError("Protocol", `Unknown automation method: ${String(value)}`);
+    }
+    return value;
+}
+export function parseRequest(value) {
+    if (!isObject(value)) {
+        throw new AutomationError("Protocol", "Request must be an object");
+    }
+    if (typeof value.id !== "number" || !Number.isInteger(value.id)) {
+        throw new AutomationError("Protocol", "Request id must be an integer");
+    }
+    const method = parseMethodName(value.method);
+    const parsed = methods[method].params.safeParse(value.params);
+    if (!parsed.success) {
+        throw new AutomationError("Protocol", `Invalid params for ${method}: ${parsed.error.message}`, parsed.error.issues);
+    }
+    return { id: value.id, method, params: parsed.data };
+}
+export function parseResponse(value) {
+    if (!isObject(value)) {
+        throw new AutomationError("Protocol", "Response must be an object");
+    }
+    if (typeof value.id !== "number" || !Number.isInteger(value.id)) {
+        throw new AutomationError("Protocol", "Response id must be an integer");
+    }
+    if ("error" in value) {
+        if (!isObject(value.error) || typeof value.error.message !== "string") {
+            throw new AutomationError("Protocol", "Invalid error payload");
+        }
+        const code = errorCodeSchema.safeParse(value.error.code);
+        if (!code.success) {
+            throw new AutomationError("Protocol", "Invalid error code");
+        }
+        return {
+            id: value.id,
+            error: {
+                code: code.data,
+                message: value.error.message,
+                ...(value.error.data === undefined ? {} : { data: value.error.data }),
+            },
+        };
+    }
+    if (!("result" in value)) {
+        throw new AutomationError("Protocol", "Response needs result or error");
+    }
+    return { id: value.id, result: value.result };
+}
+export function parseServerEvent(value) {
+    if (!isObject(value) || typeof value.event !== "string") {
+        throw new AutomationError("Protocol", "Event must have an event name");
+    }
+    if (value.event === "console") {
+        const params = z.object({ text: z.string() }).parse(value.params);
+        return { event: "console", params };
+    }
+    if (value.event === "frame") {
+        const params = z
+            .object({ n: z.number(), path: z.string().optional() })
+            .parse(value.params);
+        return { event: "frame", params };
+    }
+    if (value.event === "closed") {
+        const params = z.object({ reason: z.string() }).parse(value.params);
+        return { event: "closed", params };
+    }
+    throw new AutomationError("Protocol", `Unknown server event: ${value.event}`);
+}
+export function parseWireMessage(value) {
+    if (!isObject(value)) {
+        throw new AutomationError("Protocol", "Wire message must be an object");
+    }
+    if ("method" in value)
+        return parseRequest(value);
+    if ("event" in value)
+        return parseServerEvent(value);
+    if ("result" in value || "error" in value)
+        return parseResponse(value);
+    throw new AutomationError("Protocol", "Unrecognized wire message");
+}
+export function encodeSse(message) {
+    return `data: ${JSON.stringify(message)}\n\n`;
+}
+export function createSseDecoder(onMessage, onInvalid) {
+    const parser = createParser({
+        onEvent(event) {
+            try {
+                onMessage(parseWireMessage(JSON.parse(event.data)));
+            }
+            catch (error) {
+                onInvalid?.(event.data, error);
+            }
+        },
+    });
+    return {
+        feed(chunk) {
+            parser.feed(chunk);
+        },
+    };
+}
+export function decodeSseChunk(chunk) {
+    const messages = [];
+    const decoder = createSseDecoder((message) => {
+        messages.push(message);
+    });
+    decoder.feed(chunk);
+    return messages;
+}
+//# sourceMappingURL=protocol.js.map

package/dist/automation/protocol.js.map

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

package/dist/blob-images.d.ts

@@ -0,0 +1,32 @@
+/** Method syntax so a renderer whose `setImage` wants a `Buffer` still fits. */
+export type BlobImageHost = {
+    setImage?(elementId: number, bytes: Uint8Array): void;
+};
+type BlobImageCallbacks = {
+    /** Applies queued mutations, so the `<img>` exists natively before `setImage`. */
+    flush(): void;
+    /**
+     * Tells the `<img>` that its `blob:` src could not be read. `ticket` is unique
+     * per src assignment: the failure travels as a prop and a prop is applied only
+     * when its value changes, so two failures with one message must still differ.
+     */
+    fail(id: number, message: string, ticket: number): void;
+};
+/**
+ * `<img src="blob:...">`. A blob URL only means something in this JS process, so
+ * the native layer cannot open it. This fetches the bytes and hands them to
+ * `setImage`, the path live images already use. The native element treats a
+ * `blob:` src as pending, then fires `load` when `setImage` lands or `error` when
+ * `fail` is called.
+ *
+ * A src that changes while its fetch is in flight wins: the late result is
+ * dropped. A revoked URL fails the fetch and reports `error`, as in a browser.
+ */
+export declare function createBlobImageLoader(host: BlobImageHost, callbacks: BlobImageCallbacks): {
+    created(id: number, elementType: string): void;
+    destroyed(id: number): void;
+    /** Call for every `setCustomProp`, before it is queued. */
+    prop(id: number, key: string, value: unknown): void;
+};
+export {};
+//# sourceMappingURL=blob-images.d.ts.map

package/dist/blob-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-images.d.ts","sourceRoot":"","sources":["../js/blob-images.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;CACtD,CAAA;AAED,KAAK,kBAAkB,GAAG;IACxB,kFAAkF;IAClF,KAAK,IAAI,IAAI,CAAA;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACxD,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,kBAAkB;gBAsBxE,MAAM,eAAe,MAAM;kBAGzB,MAAM;IAIpB,2DAA2D;aAClD,MAAM,OAAO,MAAM,SAAS,OAAO;EAS/C"}

package/dist/blob-images.js

@@ -0,0 +1,55 @@
+/**
+ * `<img src="blob:...">`. A blob URL only means something in this JS process, so
+ * the native layer cannot open it. This fetches the bytes and hands them to
+ * `setImage`, the path live images already use. The native element treats a
+ * `blob:` src as pending, then fires `load` when `setImage` lands or `error` when
+ * `fail` is called.
+ *
+ * A src that changes while its fetch is in flight wins: the late result is
+ * dropped. A revoked URL fails the fetch and reports `error`, as in a browser.
+ */
+export function createBlobImageLoader(host, callbacks) {
+    const types = new Map();
+    const latest = new Map();
+    let counter = 0;
+    const load = async (id, url, ticket) => {
+        const current = () => latest.get(id) === ticket;
+        try {
+            const response = await fetch(url);
+            if (!response.ok)
+                throw new Error(`fetch ${url} failed with status ${response.status}`);
+            const bytes = new Uint8Array(await response.arrayBuffer());
+            if (!current())
+                return;
+            if (!host.setImage)
+                throw new Error("this renderer cannot set an image from bytes");
+            callbacks.flush();
+            host.setImage(id, bytes);
+        }
+        catch (error) {
+            if (!current())
+                return;
+            callbacks.fail(id, error instanceof Error ? error.message : String(error), ticket);
+        }
+    };
+    return {
+        created(id, elementType) {
+            types.set(id, elementType);
+        },
+        destroyed(id) {
+            types.delete(id);
+            latest.delete(id);
+        },
+        /** Call for every `setCustomProp`, before it is queued. */
+        prop(id, key, value) {
+            if (key !== "src" || types.get(id) !== "img")
+                return;
+            const ticket = ++counter;
+            latest.set(id, ticket);
+            if (typeof value === "string" && value.trim().startsWith("blob:")) {
+                void load(id, value.trim(), ticket);
+            }
+        },
+    };
+}
+//# sourceMappingURL=blob-images.js.map

package/dist/blob-images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-images.js","sourceRoot":"","sources":["../js/blob-images.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAmB,EAAE,SAA6B;IACtF,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAA;IACvC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAA;IACxC,IAAI,OAAO,GAAG,CAAC,CAAA;IAEf,MAAM,IAAI,GAAG,KAAK,EAAE,EAAU,EAAE,GAAW,EAAE,MAAc,EAAE,EAAE;QAC7D,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,MAAM,CAAA;QAC/C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAA;YACjC,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,SAAS,GAAG,uBAAuB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;YACvF,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAA;YAC1D,IAAI,CAAC,OAAO,EAAE;gBAAE,OAAM;YACtB,IAAI,CAAC,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;YACnF,SAAS,CAAC,KAAK,EAAE,CAAA;YACjB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,EAAE;gBAAE,OAAM;YACtB,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAA;QACpF,CAAC;IACH,CAAC,CAAA;IAED,OAAO;QACL,OAAO,CAAC,EAAU,EAAE,WAAmB;YACrC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,CAAC,CAAA;QAC5B,CAAC;QACD,SAAS,CAAC,EAAU;YAClB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YAChB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QACnB,CAAC;QACD,2DAA2D;QAC3D,IAAI,CAAC,EAAU,EAAE,GAAW,EAAE,KAAc;YAC1C,IAAI,GAAG,KAAK,KAAK,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,KAAK;gBAAE,OAAM;YACpD,MAAM,MAAM,GAAG,EAAE,OAAO,CAAA;YACxB,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;YACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAClE,KAAK,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAA;YACrC,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/bounds.d.ts

@@ -0,0 +1,61 @@
+import type { ElementBounds } from "../index.js";
+import type { MutationRenderer, NativeRenderer } from "./host.js";
+/** Border box in window coordinates, shaped like a DOM `DOMRectReadOnly`. */
+export interface BoundingClientRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    top: number;
+    left: number;
+    right: number;
+    bottom: number;
+}
+interface FlushableQueue {
+    flushMutations(): void;
+}
+/**
+ * Let `flushPendingMutations(renderer)` reach this queue. `createMutationQueue`
+ * calls it, so a framework adapter never has to.
+ */
+export declare function registerMutationQueue(renderer: object, queue: FlushableQueue): void;
+/**
+ * Send every mutation a framework has queued for this renderer. A read that
+ * must see the current tree (bounds, hit tests) calls it first, because Solid
+ * flushes in a microtask and React only at commit.
+ */
+export declare function flushPendingMutations(renderer: object): void;
+/** The zero rect a DOM element without a box reports. */
+export declare function toBoundingClientRect(bounds: Pick<ElementBounds, "x" | "y" | "width" | "height"> | null): BoundingClientRect;
+/**
+ * `getBoundingClientRect` for the element with this id: pending mutations are
+ * sent and the renderer lays out before it answers. An element with no box
+ * (not mounted, not painted) reports a zero rect.
+ */
+export declare function readBoundingClientRect(renderer: NativeRenderer, id: number): BoundingClientRect;
+/**
+ * Key of the method a framework adapter puts on its host element instances to
+ * let shared code (observers) reach the element's renderer and mutation queue.
+ */
+export declare const HOST_BINDING: unique symbol;
+/**
+ * Key of the method a host element offers to be told each time it is created
+ * natively. Solid creates the native element when the tree is inserted and
+ * again after a removal, so an observer started earlier must follow it. An
+ * element that is always mounted when handed out (React) does not have it.
+ */
+export declare const HOST_MOUNT: unique symbol;
+export interface HostBinding {
+    readonly renderer: NativeRenderer;
+    readonly mutations: MutationRenderer;
+}
+/** A mounted host element, as `ResizeObserver` and `IntersectionObserver` take it. */
+export interface ObservableElement {
+    readonly id: number;
+    /** The binding while the element is mounted, `undefined` before and after. */
+    [HOST_BINDING](): HostBinding | undefined;
+    /** Calls `listener` each time the element is created natively. Returns the stop function. */
+    [HOST_MOUNT]?(listener: () => void): () => void;
+}
+export {};
+//# sourceMappingURL=bounds.d.ts.map

package/dist/bounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.d.ts","sourceRoot":"","sources":["../js/bounds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAEjE,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,UAAU,cAAc;IACtB,cAAc,IAAI,IAAI,CAAA;CACvB;AAgBD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAWnF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAQ5D;AAED,yDAAyD;AACzD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,GAAG,GAAG,GAAG,GAAG,OAAO,GAAG,QAAQ,CAAC,GAAG,IAAI,GAAG,kBAAkB,CAY3H;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,GAAG,kBAAkB,CAM/F;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,OAAO,MAAgD,CAAA;AAElF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,OAAO,MAA8C,CAAA;AAE9E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IACjC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAA;CACrC;AAED,sFAAsF;AACtF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,8EAA8E;IAC9E,CAAC,YAAY,CAAC,IAAI,WAAW,GAAG,SAAS,CAAA;IACzC,6FAA6F;IAC7F,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;CAChD"}

package/dist/bounds.js

@@ -0,0 +1,85 @@
+const QUEUES_KEY = Symbol.for("@ghia/native/mutation-queues");
+// Keyed by the renderer object a queue applies to. Queues are held weakly: a
+// root that was unmounted and replaced leaves its queue behind otherwise.
+function allQueues() {
+    const existing = Reflect.get(globalThis, QUEUES_KEY);
+    if (existing)
+        return existing;
+    const queues = new WeakMap();
+    Reflect.set(globalThis, QUEUES_KEY, queues);
+    return queues;
+}
+/**
+ * Let `flushPendingMutations(renderer)` reach this queue. `createMutationQueue`
+ * calls it, so a framework adapter never has to.
+ */
+export function registerMutationQueue(renderer, queue) {
+    const queues = allQueues();
+    let refs = queues.get(renderer);
+    if (!refs) {
+        refs = new Set();
+        queues.set(renderer, refs);
+    }
+    for (const ref of refs) {
+        if (ref.deref() === undefined)
+            refs.delete(ref);
+    }
+    refs.add(new WeakRef(queue));
+}
+/**
+ * Send every mutation a framework has queued for this renderer. A read that
+ * must see the current tree (bounds, hit tests) calls it first, because Solid
+ * flushes in a microtask and React only at commit.
+ */
+export function flushPendingMutations(renderer) {
+    const refs = allQueues().get(renderer);
+    if (!refs)
+        return;
+    for (const ref of [...refs]) {
+        const queue = ref.deref();
+        if (queue)
+            queue.flushMutations();
+        else
+            refs.delete(ref);
+    }
+}
+/** The zero rect a DOM element without a box reports. */
+export function toBoundingClientRect(bounds) {
+    if (!bounds)
+        return { x: 0, y: 0, width: 0, height: 0, top: 0, left: 0, right: 0, bottom: 0 };
+    return {
+        x: bounds.x,
+        y: bounds.y,
+        width: bounds.width,
+        height: bounds.height,
+        top: bounds.y,
+        left: bounds.x,
+        right: bounds.x + bounds.width,
+        bottom: bounds.y + bounds.height,
+    };
+}
+/**
+ * `getBoundingClientRect` for the element with this id: pending mutations are
+ * sent and the renderer lays out before it answers. An element with no box
+ * (not mounted, not painted) reports a zero rect.
+ */
+export function readBoundingClientRect(renderer, id) {
+    if (!renderer.getElementBounds) {
+        throw new Error("This renderer cannot measure elements: it has no getElementBounds");
+    }
+    flushPendingMutations(renderer);
+    return toBoundingClientRect(renderer.getElementBounds(id));
+}
+/**
+ * Key of the method a framework adapter puts on its host element instances to
+ * let shared code (observers) reach the element's renderer and mutation queue.
+ */
+export const HOST_BINDING = Symbol.for("@ghia/native/host-binding");
+/**
+ * Key of the method a host element offers to be told each time it is created
+ * natively. Solid creates the native element when the tree is inserted and
+ * again after a removal, so an observer started earlier must follow it. An
+ * element that is always mounted when handed out (React) does not have it.
+ */
+export const HOST_MOUNT = Symbol.for("@ghia/native/host-mount");
+//# sourceMappingURL=bounds.js.map

package/dist/bounds.js.map

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

package/dist/clipboard-global.d.ts

@@ -0,0 +1,11 @@
+declare global {
+    interface Clipboard {
+        writeText(text: string): Promise<void>;
+        readText(): Promise<string>;
+    }
+    interface Navigator {
+        readonly clipboard: Clipboard;
+    }
+}
+export {};
+//# sourceMappingURL=clipboard-global.d.ts.map

package/dist/clipboard-global.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard-global.d.ts","sourceRoot":"","sources":["../js/clipboard-global.ts"],"names":[],"mappings":"AAIA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,SAAS;QACjB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;QACtC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;KAC5B;IACD,UAAU,SAAS;QACjB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;KAC9B;CACF;AAED,OAAO,EAAE,CAAA"}

package/dist/clipboard-global.js

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

package/dist/clipboard-global.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard-global.js","sourceRoot":"","sources":["../js/clipboard-global.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,CAAA"}

package/dist/clipboard.d.ts

@@ -0,0 +1,19 @@
+import type { NativeRenderer } from "./host.js";
+import "./clipboard-global.js";
+/** The `navigator.clipboard` text subset. Images and rich items are not supported. */
+export interface Clipboard {
+    writeText(text: string): Promise<void>;
+    /** Resolves `""` when the clipboard holds no text, as in the DOM. */
+    readText(): Promise<string>;
+}
+export type ClipboardHost = Pick<NativeRenderer, "writeClipboardText" | "readClipboardText">;
+export declare function createClipboard(host: () => ClipboardHost | undefined): Clipboard;
+/** The clipboard of the renderer created last. */
+export declare const clipboard: Clipboard;
+/**
+ * Point `clipboard` at `host`, and expose it as `navigator.clipboard` when the
+ * runtime has a `navigator` without one, so code written for the web runs
+ * unchanged. A runtime with no `navigator` is left without one.
+ */
+export declare function bindClipboard(host: ClipboardHost): void;
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../js/clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,uBAAuB,CAAA;AAE9B,sFAAsF;AACtF,MAAM,WAAW,SAAS;IACxB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,qEAAqE;IACrE,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CAC5B;AAED,MAAM,MAAM,aAAa,GAAG,IAAI,CAC9B,cAAc,EACd,oBAAoB,GAAG,mBAAmB,CAC3C,CAAA;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,aAAa,GAAG,SAAS,GACpC,SAAS,CAkBX;AAID,kDAAkD;AAClD,eAAO,MAAM,SAAS,EAAE,SAA6C,CAAA;AAErE;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAWvD"}