@twip/web 0.0.0 → 0.1.0-alpha.1

package/dist/Rect.d.ts

@@ -0,0 +1,34 @@
+// generated by diplomat-tool
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+export type Rect_obj = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+
+
+
+/**
+ * A rectangle in points (page coordinates) or pixels (content coordinates), as the method says.
+ */
+export class Rect {
+    get x(): number;
+    set x(value: number);
+    get y(): number;
+    set y(value: number);
+    get width(): number;
+    set width(value: number);
+    get height(): number;
+    set height(value: number);
+    /** @internal */
+    static fromFields(structObj : Rect_obj) : Rect;
+
+    /**
+    * Create `Rect` from an object that contains all of `Rect`s fields.
+    * Optional fields do not need to be included in the provided object.
+    */
+    constructor(structObj: Rect_obj);
+
+}

package/dist/Rect.mjs

@@ -0,0 +1,148 @@
+// generated by diplomat-tool
+import wasm from "./diplomat-wasm.mjs";
+import * as diplomatRuntime from "./diplomat-runtime.mjs";
+
+
+
+/**
+ * A rectangle in points (page coordinates) or pixels (content coordinates), as the method says.
+ */
+export class Rect {
+    #x;
+    get x() {
+        return this.#x;
+    }
+    set x(value){
+        this.#x = value;
+    }
+    #y;
+    get y() {
+        return this.#y;
+    }
+    set y(value){
+        this.#y = value;
+    }
+    #width;
+    get width() {
+        return this.#width;
+    }
+    set width(value){
+        this.#width = value;
+    }
+    #height;
+    get height() {
+        return this.#height;
+    }
+    set height(value){
+        this.#height = value;
+    }
+    /** @internal */
+    static fromFields(structObj) {
+        return new Rect(structObj);
+    }
+
+    #internalConstructor(structObj) {
+        if (typeof structObj !== "object") {
+            throw new Error("Rect's constructor takes an object of Rect's fields.");
+        }
+
+        if ("x" in structObj) {
+            this.#x = structObj.x;
+        } else {
+            throw new Error("Missing required field x.");
+        }
+
+        if ("y" in structObj) {
+            this.#y = structObj.y;
+        } else {
+            throw new Error("Missing required field y.");
+        }
+
+        if ("width" in structObj) {
+            this.#width = structObj.width;
+        } else {
+            throw new Error("Missing required field width.");
+        }
+
+        if ("height" in structObj) {
+            this.#height = structObj.height;
+        } else {
+            throw new Error("Missing required field height.");
+        }
+
+        return this;
+    }
+
+    // Return this struct in FFI function friendly format.
+    // Returns an array that can be expanded with spread syntax (...)
+    _intoFFI(
+        dst,
+        functionCleanupArena,
+        appendArrayMap
+    ) {
+
+        this._writeToArrayBuffer(wasm.memory.buffer, dst, functionCleanupArena, appendArrayMap);
+
+        return dst;
+    }
+
+    static get _sizeBytes() {
+        return 32;
+    }
+
+    /// Currently unused, we may want to use later on though:
+    static get _sizeAlign() {
+        return 8;
+    }
+
+    static _fromSuppliedValue(internalConstructor, obj) {
+        if (internalConstructor !== diplomatRuntime.internalConstructor) {
+            throw new Error("_fromSuppliedValue cannot be called externally.");
+        }
+
+        if (obj instanceof Rect) {
+            return obj;
+        }
+
+        return Rect.fromFields(obj);
+    }
+
+    _writeToArrayBuffer(
+        arrayBuffer,
+        offset,
+        functionCleanupArena,
+        appendArrayMap
+    ) {
+        diplomatRuntime.writeToArrayBuffer(arrayBuffer, offset + 0, this.#x, Float64Array);
+        diplomatRuntime.writeToArrayBuffer(arrayBuffer, offset + 8, this.#y, Float64Array);
+        diplomatRuntime.writeToArrayBuffer(arrayBuffer, offset + 16, this.#width, Float64Array);
+        diplomatRuntime.writeToArrayBuffer(arrayBuffer, offset + 24, this.#height, Float64Array);
+    }
+
+    // This struct contains borrowed fields, so this takes in a list of
+    // "edges" corresponding to where each lifetime's data may have been borrowed from
+    // and passes it down to individual fields containing the borrow.
+    // This method does not attempt to handle any dependencies between lifetimes, the caller
+    // should handle this when constructing edge arrays.
+    static _fromFFI(internalConstructor, ptr) {
+        if (internalConstructor !== diplomatRuntime.internalConstructor) {
+            throw new Error("Rect._fromFFI is not meant to be called externally. Please use the default constructor.");
+        }
+        let structObj = {};
+        const xDeref = (new Float64Array(wasm.memory.buffer, ptr, 1))[0];
+        structObj.x = xDeref;
+        const yDeref = (new Float64Array(wasm.memory.buffer, ptr + 8, 1))[0];
+        structObj.y = yDeref;
+        const widthDeref = (new Float64Array(wasm.memory.buffer, ptr + 16, 1))[0];
+        structObj.width = widthDeref;
+        const heightDeref = (new Float64Array(wasm.memory.buffer, ptr + 24, 1))[0];
+        structObj.height = heightDeref;
+
+        return new Rect(structObj);
+    }
+
+
+    constructor(structObj) {
+        return this.#internalConstructor(...arguments)
+    }
+}

package/dist/Request.d.ts

@@ -0,0 +1,55 @@
+// generated by diplomat-tool
+import type { Rect } from "./Rect"
+import type { RequestKind } from "./RequestKind"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+export class Request {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    get kind(): RequestKind;
+
+    /**
+     * ScrollIntoView: the page (from 0).
+     */
+    get page(): number;
+
+    /**
+     * ScrollIntoView: the rectangle on the page, points.
+     */
+    get rect(): Rect;
+
+    get velocityX(): number;
+
+    get velocityY(): number;
+
+    /**
+     * Cursor: the CSS cursor name.
+     */
+    cursor(): string;
+
+    /**
+     * Clipboard: the plain text.
+     */
+    text(): string;
+
+    /**
+     * Clipboard: the HTML (empty if none).
+     */
+    html(): string;
+
+    /**
+     * Placeholder: its key (what to fill it with).
+     */
+    placeholderKey(): string;
+
+    /**
+     * Placeholder: its label.
+     */
+    placeholderLabel(): string;
+}

package/dist/Request.mjs

@@ -0,0 +1,207 @@
+// generated by diplomat-tool
+import { Rect } from "./Rect.mjs"
+import { RequestKind } from "./RequestKind.mjs"
+import wasm from "./diplomat-wasm.mjs";
+import * as diplomatRuntime from "./diplomat-runtime.mjs";
+
+const Request_box_destroy_registry = new FinalizationRegistry((ptr) => {
+    wasm.Request_destroy(ptr);
+});
+
+export class Request {
+    // Internal ptr reference:
+    #ptr = null;
+
+    // Lifetimes are only to keep dependencies alive.
+    // Since JS won't garbage collect until there are no incoming edges.
+    #selfEdge = [];
+
+    #internalConstructor(symbol, ptr, selfEdge) {
+        if (symbol !== diplomatRuntime.internalConstructor) {
+            console.error("Request is an Opaque type. You cannot call its constructor.");
+            return;
+        }
+        this.#ptr = ptr;
+        this.#selfEdge = selfEdge;
+
+        // Are we being borrowed? If not, we can register.
+        if (this.#selfEdge.length === 0) {
+            Request_box_destroy_registry.register(this, this.#ptr);
+        }
+
+        return this;
+    }
+    /** @internal */
+    get ffiValue() {
+        return this.#ptr;
+    }
+
+
+    get kind() {
+
+        const result = wasm.Request_kind(this.ffiValue);
+
+        try {
+            return new RequestKind(diplomatRuntime.internalConstructor, result);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * ScrollIntoView: the page (from 0).
+     */
+    get page() {
+
+        const result = wasm.Request_page(this.ffiValue);
+
+        try {
+            return result;
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * ScrollIntoView: the rectangle on the page, points.
+     */
+    get rect() {
+        const diplomatReceive = new diplomatRuntime.DiplomatReceiveBuf(wasm, 32, 8, false);
+
+
+        const result = wasm.Request_rect(diplomatReceive.buffer, this.ffiValue);
+
+        try {
+            return Rect._fromFFI(diplomatRuntime.internalConstructor, diplomatReceive.buffer);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            diplomatReceive.free();
+        }
+    }
+
+    get velocityX() {
+
+        const result = wasm.Request_velocity_x(this.ffiValue);
+
+        try {
+            return result;
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    get velocityY() {
+
+        const result = wasm.Request_velocity_y(this.ffiValue);
+
+        try {
+            return result;
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    /**
+     * Cursor: the CSS cursor name.
+     */
+    cursor() {
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+    wasm.Request_cursor(this.ffiValue, write.buffer);
+
+        try {
+            return write.readString8();
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            write.free();
+        }
+    }
+
+    /**
+     * Clipboard: the plain text.
+     */
+    text() {
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+    wasm.Request_text(this.ffiValue, write.buffer);
+
+        try {
+            return write.readString8();
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            write.free();
+        }
+    }
+
+    /**
+     * Clipboard: the HTML (empty if none).
+     */
+    html() {
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+    wasm.Request_html(this.ffiValue, write.buffer);
+
+        try {
+            return write.readString8();
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            write.free();
+        }
+    }
+
+    /**
+     * Placeholder: its key (what to fill it with).
+     */
+    placeholderKey() {
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+    wasm.Request_placeholder_key(this.ffiValue, write.buffer);
+
+        try {
+            return write.readString8();
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            write.free();
+        }
+    }
+
+    /**
+     * Placeholder: its label.
+     */
+    placeholderLabel() {
+        const write = new diplomatRuntime.DiplomatWriteBuf(wasm);
+
+    wasm.Request_placeholder_label(this.ffiValue, write.buffer);
+
+        try {
+            return write.readString8();
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+            write.free();
+        }
+    }
+
+    constructor(symbol, ptr, selfEdge) {
+        return this.#internalConstructor(...arguments)
+    }
+}

package/dist/RequestKind.d.ts

@@ -0,0 +1,45 @@
+// generated by diplomat-tool
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * What the editor asks of the host after an input.
+ */
+export class RequestKind {
+
+    /** @internal */
+    static fromValue(value: RequestKind | string): RequestKind;
+
+    get value(): string;
+
+    /** @internal */
+    get ffiValue(): number;
+
+    /**
+     * Scroll so that `rect` on `page` is visible.
+     */
+    static ScrollIntoView : RequestKind;
+    /**
+     * Keep scrolling at `velocity_x` / `velocity_y` pixels per second while the pointer is held outside the view.
+     */
+    static Autoscroll : RequestKind;
+    static CapturePointer : RequestKind;
+    static ReleasePointer : RequestKind;
+    /**
+     * Show the `cursor` (a CSS cursor name: `text`, `default`, `move`, `col-resize`, ...).
+     */
+    static Cursor : RequestKind;
+    /**
+     * Put `text` and `html` on the system clipboard (a copy or cut from the keyboard).
+     */
+    static Clipboard : RequestKind;
+    /**
+     * An unfilled placeholder was activated: supply its content (`fill_placeholder`).
+     */
+    static Placeholder : RequestKind;
+    static Unknown : RequestKind;
+
+
+    constructor(value: RequestKind | string );
+}

package/dist/RequestKind.mjs

@@ -0,0 +1,105 @@
+// generated by diplomat-tool
+import wasm from "./diplomat-wasm.mjs";
+import * as diplomatRuntime from "./diplomat-runtime.mjs";
+
+
+
+/**
+ * What the editor asks of the host after an input.
+ */
+export class RequestKind {
+    #value = undefined;
+
+    static #values = new Map([
+        ["ScrollIntoView", 0],
+        ["Autoscroll", 1],
+        ["CapturePointer", 2],
+        ["ReleasePointer", 3],
+        ["Cursor", 4],
+        ["Clipboard", 5],
+        ["Placeholder", 6],
+        ["Unknown", 7]
+    ]);
+
+    static getAllEntries() {
+        return RequestKind.#values.entries();
+    }
+
+    #internalConstructor(value) {
+        if (arguments.length > 1 && arguments[0] === diplomatRuntime.internalConstructor) {
+            // We pass in two internalConstructor arguments to create *new*
+            // instances of this type, otherwise the enums are treated as singletons.
+            if (arguments[1] === diplomatRuntime.internalConstructor ) {
+                this.#value = arguments[2];
+                return this;
+            }
+            return RequestKind.#objectValues[arguments[1]];
+        }
+
+        if (value instanceof RequestKind) {
+            return value;
+        }
+
+        let intVal = RequestKind.#values.get(value);
+
+        // Nullish check, checks for null or undefined
+        if (intVal != null) {
+            return RequestKind.#objectValues[intVal];
+        }
+
+        throw TypeError(value + " is not a RequestKind and does not correspond to any of its enumerator values.");
+    }
+
+    /** @internal */
+    static fromValue(value) {
+        return new RequestKind(value);
+    }
+
+    get value(){
+        return [...RequestKind.#values.keys()][this.#value];
+    }
+
+    /** @internal */
+    get ffiValue(){
+        return this.#value;
+    }
+    static #objectValues = [
+        new RequestKind(diplomatRuntime.internalConstructor, diplomatRuntime.internalConstructor, 0),
+        new RequestKind(diplomatRuntime.internalConstructor, diplomatRuntime.internalConstructor, 1),
+        new RequestKind(diplomatRuntime.internalConstructor, diplomatRuntime.internalConstructor, 2),
+        new RequestKind(diplomatRuntime.internalConstructor, diplomatRuntime.internalConstructor, 3),
+        new RequestKind(diplomatRuntime.internalConstructor, diplomatRuntime.internalConstructor, 4),
+        new RequestKind(diplomatRuntime.internalConstructor, diplomatRuntime.internalConstructor, 5),
+        new RequestKind(diplomatRuntime.internalConstructor, diplomatRuntime.internalConstructor, 6),
+        new RequestKind(diplomatRuntime.internalConstructor, diplomatRuntime.internalConstructor, 7),
+    ];
+
+    /**
+     * Scroll so that `rect` on `page` is visible.
+     */
+    static ScrollIntoView = RequestKind.#objectValues[0];
+    /**
+     * Keep scrolling at `velocity_x` / `velocity_y` pixels per second while the pointer is held outside the view.
+     */
+    static Autoscroll = RequestKind.#objectValues[1];
+    static CapturePointer = RequestKind.#objectValues[2];
+    static ReleasePointer = RequestKind.#objectValues[3];
+    /**
+     * Show the `cursor` (a CSS cursor name: `text`, `default`, `move`, `col-resize`, ...).
+     */
+    static Cursor = RequestKind.#objectValues[4];
+    /**
+     * Put `text` and `html` on the system clipboard (a copy or cut from the keyboard).
+     */
+    static Clipboard = RequestKind.#objectValues[5];
+    /**
+     * An unfilled placeholder was activated: supply its content (`fill_placeholder`).
+     */
+    static Placeholder = RequestKind.#objectValues[6];
+    static Unknown = RequestKind.#objectValues[7];
+
+
+    constructor(value) {
+        return this.#internalConstructor(...arguments)
+    }
+}

package/dist/RequestList.d.ts

@@ -0,0 +1,20 @@
+// generated by diplomat-tool
+import type { Request } from "./Request"
+import type { pointer, codepoint } from "./diplomat-runtime.d.ts";
+
+
+
+/**
+ * Requests since the host last took them, in order.
+ */
+export class RequestList {
+    /** @internal */
+    get ffiValue(): pointer;
+    /** @internal */
+    constructor();
+
+
+    get len(): number;
+
+    get(index: number): Request | null;
+}

package/dist/RequestList.mjs

@@ -0,0 +1,71 @@
+// generated by diplomat-tool
+import { Request } from "./Request.mjs"
+import wasm from "./diplomat-wasm.mjs";
+import * as diplomatRuntime from "./diplomat-runtime.mjs";
+
+const RequestList_box_destroy_registry = new FinalizationRegistry((ptr) => {
+    wasm.RequestList_destroy(ptr);
+});
+
+/**
+ * Requests since the host last took them, in order.
+ */
+export class RequestList {
+    // Internal ptr reference:
+    #ptr = null;
+
+    // Lifetimes are only to keep dependencies alive.
+    // Since JS won't garbage collect until there are no incoming edges.
+    #selfEdge = [];
+
+    #internalConstructor(symbol, ptr, selfEdge) {
+        if (symbol !== diplomatRuntime.internalConstructor) {
+            console.error("RequestList is an Opaque type. You cannot call its constructor.");
+            return;
+        }
+        this.#ptr = ptr;
+        this.#selfEdge = selfEdge;
+
+        // Are we being borrowed? If not, we can register.
+        if (this.#selfEdge.length === 0) {
+            RequestList_box_destroy_registry.register(this, this.#ptr);
+        }
+
+        return this;
+    }
+    /** @internal */
+    get ffiValue() {
+        return this.#ptr;
+    }
+
+
+    get len() {
+
+        const result = wasm.RequestList_len(this.ffiValue);
+
+        try {
+            return result;
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    get(index) {
+
+        const result = wasm.RequestList_get(this.ffiValue, index);
+
+        try {
+            return result === 0 ? null : new Request(diplomatRuntime.internalConstructor, result, []);
+        }
+
+        finally {
+            diplomatRuntime.FUNCTION_PARAM_ALLOC.clean();
+        }
+    }
+
+    constructor(symbol, ptr, selfEdge) {
+        return this.#internalConstructor(...arguments)
+    }
+}