@simpludify/core 0.1.4 → 0.1.6

package/dist/interaction/virtual-regions.d.ts

@@ -0,0 +1,68 @@
+import type { Point, ScreenPoint, Viewport } from "../graphics/coordinates.js";
+export type VirtualSpace = "viewport" | "screen";
+export interface VirtualPosition extends Point {
+    /** viewport uses fractions of the current Viewport; screen uses host CSS pixels. */
+    readonly space?: VirtualSpace;
+}
+export interface VirtualRectRegion extends VirtualPosition {
+    readonly kind: "rect";
+    readonly width: number;
+    readonly height: number;
+}
+export interface VirtualCircleRegion extends VirtualPosition {
+    readonly kind: "circle";
+    /** In viewport space the radius is a fraction of its smaller dimension. */
+    readonly radius: number;
+}
+export interface VirtualCustomRegion {
+    readonly kind: "custom";
+    /** Conservative host CSS-pixel bounds, including every point accepted by contains. */
+    readonly bounds: (viewport: Viewport) => Viewport;
+    readonly contains: (point: ScreenPoint, viewport: Viewport) => boolean;
+}
+export type VirtualRegion = VirtualRectRegion | VirtualCircleRegion | VirtualCustomRegion;
+export declare const VirtualRegions: Readonly<{
+    /** A shared edge is not an overlap. Use separate rectangles to leave a center gap. */
+    Left: Readonly<{
+        readonly kind: "rect";
+        readonly x: 0;
+        readonly y: 0;
+        readonly width: 0.5;
+        readonly height: 1;
+    }>;
+    Right: Readonly<{
+        readonly kind: "rect";
+        readonly x: 0.5;
+        readonly y: 0;
+        readonly width: 0.5;
+        readonly height: 1;
+    }>;
+}>;
+/** @internal */
+export type ResolvedVirtualRegion = {
+    readonly kind: "rect";
+    readonly bounds: Viewport;
+} | {
+    readonly kind: "circle";
+    readonly bounds: Viewport;
+    readonly center: Point;
+    readonly radius: number;
+} | {
+    readonly kind: "custom";
+    readonly bounds: Viewport;
+    readonly test: VirtualCustomRegion["contains"];
+};
+/** @internal */
+export declare function virtualFinite(value: number, field: string): number;
+/** @internal */
+export declare function virtualBounds(value: Viewport): Viewport;
+/** @internal */
+export declare function virtualPosition(value: VirtualPosition, viewport: Viewport): Point;
+/** @internal Copy configuration before retaining it. Predicate functions are deliberately live. */
+export declare function checkedVirtualRegion(region: VirtualRegion): VirtualRegion;
+/** @internal */
+export declare function resolveVirtualRegion(region: VirtualRegion, viewport: Viewport): ResolvedVirtualRegion;
+/** @internal Rectangles are half-open; circles exclude their circumference. */
+export declare function virtualContains(region: ResolvedVirtualRegion, point: ScreenPoint, viewport: Viewport): boolean;
+/** @internal Exact built-in intersection; custom bounds are conservatively ambiguous. */
+export declare function virtualOverlap(a: ResolvedVirtualRegion, b: ResolvedVirtualRegion): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simpludify/core",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "type": "module",
   "exports": {
     ".": {