@react-x11/components 0.11.0 → 0.13.0

package/dist/html/surfaces.d.ts

@@ -1,8 +1,14 @@
 /** ntk's `Surface`, as this uses it. */
-interface SurfaceLike {
+export interface SurfaceLike {
     getContext(kind: '2d'): unknown;
     destroy?(): void;
 }
+/**
+ * A transparent surface of its own, the caller's to destroy once drawn: a
+ * masked element is drawn on one and composited. Null where the backend
+ * has no offscreen surface — the headless mock.
+ */
+export declare function newSurface(app: unknown, width: number, height: number): SurfaceLike | null;
 /**
  * Surfaces by key, the least recently drawn given up first once they hold
  * more than `budget` pixels. One too large for a quarter of the budget is
@@ -19,5 +25,4 @@ export declare class SurfaceCache {
     get(key: string, width: number, height: number, draw: (ctx: unknown) => void): SurfaceLike | null;
     destroy(): void;
 }
-export {};
 //# sourceMappingURL=surfaces.d.ts.map

package/dist/html/surfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"surfaces.d.ts","sourceRoot":"","sources":["../../src/html/surfaces.ts"],"names":[],"mappings":"AASA,wCAAwC;AACxC,UAAU,WAAW;IACnB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;IAChC,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAOD;;;;;GAKG;AACH,qBAAa,YAAY;IAMrB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAChD,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,WAAW,CAAS;IAE5B,YACmB,GAAG,EAAE,OAAO,EACZ,MAAM,SAAkB,EACvC;IAEJ,GAAG,CACD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAC3B,WAAW,GAAG,IAAI,CAgCpB;IAED,OAAO,IAAI,IAAI,CAId;CACF"}
+{"version":3,"file":"surfaces.d.ts","sourceRoot":"","sources":["../../src/html/surfaces.ts"],"names":[],"mappings":"AASA,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;IAChC,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAOD;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,WAAW,GAAG,IAAI,CASpB;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IAMrB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAChD,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,WAAW,CAAS;IAE5B,YACmB,GAAG,EAAE,OAAO,EACZ,MAAM,SAAkB,EACvC;IAEJ,GAAG,CACD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAC3B,WAAW,GAAG,IAAI,CAgCpB;IAED,OAAO,IAAI,IAAI,CAId;CACF"}

package/dist/html/surfaces.js

@@ -5,6 +5,22 @@
 // thirty cards; the name is the shadow's geometry and colour, which only
 // the painter knows, so the cache is here.
 import { Surface } from 'react-x11/ntk';
+/**
+ * A transparent surface of its own, the caller's to destroy once drawn: a
+ * masked element is drawn on one and composited. Null where the backend
+ * has no offscreen surface — the headless mock.
+ */
+export function newSurface(app, width, height) {
+    try {
+        return new Surface(app, {
+            width,
+            height,
+        });
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * Surfaces by key, the least recently drawn given up first once they hold
  * more than `budget` pixels. One too large for a quarter of the budget is

package/dist/html/surfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"surfaces.js","sourceRoot":"","sources":["../../src/html/surfaces.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,4EAA4E;AAC5E,0EAA0E;AAC1E,2EAA2E;AAC3E,yEAAyE;AACzE,2CAA2C;AAE3C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAaxC;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IAMJ,GAAG;IACH,MAAM;IANR,IAAI,GAAG,IAAI,GAAG,EAAgB,CAAC;IACxC,MAAM,GAAG,CAAC,CAAC;IACX,WAAW,GAAG,KAAK,CAAC;IAE5B,YACmB,GAAY,EACZ,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI;mBADxB,GAAG;sBACH,MAAM;IACtB,CAAC;IAEJ,GAAG,CACD,GAAW,EACX,KAAa,EACb,MAAc,EACd,IAA4B;QAE5B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,GAAG,EAAE,CAAC;YACR,+DAA+D;YAC/D,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACtB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACxB,OAAO,GAAG,CAAC,OAAO,CAAC;QACrB,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;QAC9B,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAChE,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1C,IAAI,OAAoB,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,GAAY,EAAE;gBACvC,KAAK;gBACL,MAAM;aACP,CAA2B,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,qEAAqE;QACrE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC;QACtB,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACxC,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO;gBAAE,MAAM;YACnE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACzB,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;YAC5B,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO;QACL,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAAE,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAClE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAClB,CAAC;CACF"}
+{"version":3,"file":"surfaces.js","sourceRoot":"","sources":["../../src/html/surfaces.ts"],"names":[],"mappings":"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"}

package/dist/html/widgets.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+import type { ReactNode } from 'react';
+import type { DrawnNode, MouseEvent as X11MouseEvent } from 'react-x11';
+import type { Element } from './dom.js';
+import type { HtmlViewNode } from './node.js';
+import type { RootLook } from './css/style.js';
+import type { ControlRect } from './controls.js';
+import type { FormSubmission } from './form.js';
+export interface FormsOptions {
+    /** The element, for the document's base, its geometry and its window. */
+    view: React.RefObject<HtmlViewNode | null>;
+    /** The URL the document came from: an empty `action` is it. */
+    baseUrl: string | null | undefined;
+    onControlChange?: (element: Element, value: string | boolean) => void;
+    onSubmit?: (submission: FormSubmission) => void;
+    /** Restyle and lay out again: a change a selector can see. */
+    touch: () => void;
+}
+export interface Forms {
+    /** The document's own presses: its `<button>`s, `<label>`s and image
+     *  buttons. */
+    onMouseDown: (ev: X11MouseEvent<DrawnNode>) => void;
+    onMouseUp: (ev: X11MouseEvent<DrawnNode>) => void;
+    /** The widgets for the rectangles layout reported, and the message of a
+     *  form that would not submit. */
+    render(rects: readonly ControlRect[], look: RootLook): ReactNode[];
+}
+export declare function useForms(options: FormsOptions): Forms;
+//# sourceMappingURL=widgets.d.ts.map

package/dist/html/widgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgets.d.ts","sourceRoot":"","sources":["../../src/html/widgets.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,IAAI,aAAa,EAAE,MAAM,WAAW,CAAC;AAQxE,OAAO,KAAK,EAAY,OAAO,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,eAAe,CAAC;AAe5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAOhD,MAAM,WAAW,YAAY;IAC3B,yEAAyE;IACzE,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAC3C,+DAA+D;IAC/D,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACnC,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,KAAK,IAAI,CAAC;IACtE,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,cAAc,KAAK,IAAI,CAAC;IAChD,8DAA8D;IAC9D,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,KAAK;IACpB;mBACe;IACf,WAAW,EAAE,CAAC,EAAE,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;IACpD,SAAS,EAAE,CAAC,EAAE,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;IAClD;sCACkC;IAClC,MAAM,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,EAAE,CAAC;CACpE;AASD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,KAAK,CAqNrD"}