@urk/adapters 0.1.0

package/dist/pointer.js

@@ -0,0 +1,135 @@
+/**
+ * Company: EonHive Inc.
+ * Title: Pointer Adapter
+ * Purpose: Normalize pointer target binding and emit interaction events.
+ * Author: Stan Nesi
+ * Created: 2026-04-12
+ * Updated: 2026-04-22
+ * Notes: Vibe coded with Codex.
+ */
+function getSurfaceCoordinates(element, nativeEvent) {
+    const bounds = element.getBoundingClientRect();
+    return {
+        clientX: nativeEvent.clientX,
+        clientY: nativeEvent.clientY,
+        localX: nativeEvent.clientX - bounds.left,
+        localY: nativeEvent.clientY - bounds.top,
+    };
+}
+export function createPointerAdapter(id = 'pointer-adapter') {
+    return {
+        id,
+        capability: 'pointer',
+        setup(ctx) {
+            const cleanups = new Map();
+            const emit = (type, payload) => {
+                ctx.events.emit({
+                    type,
+                    source: id,
+                    payload,
+                    timestamp: Date.now(),
+                });
+            };
+            return {
+                bindTarget(target) {
+                    if (cleanups.has(target.id)) {
+                        throw new Error(`Pointer target already bound: ${target.id}`);
+                    }
+                    const onEnter = (nativeEvent) => {
+                        emit('pointer:hover', {
+                            targetId: target.id,
+                            element: target.element,
+                            meta: target.meta,
+                            nativeEvent,
+                        });
+                    };
+                    const onLeave = (nativeEvent) => {
+                        emit('pointer:leave', {
+                            targetId: target.id,
+                            element: target.element,
+                            meta: target.meta,
+                            nativeEvent,
+                        });
+                    };
+                    const onSelect = (nativeEvent) => {
+                        emit('pointer:select', {
+                            targetId: target.id,
+                            element: target.element,
+                            meta: target.meta,
+                            nativeEvent,
+                        });
+                    };
+                    target.element.addEventListener('pointerenter', onEnter);
+                    target.element.addEventListener('pointerleave', onLeave);
+                    target.element.addEventListener('click', onSelect);
+                    const cleanup = () => {
+                        target.element.removeEventListener('pointerenter', onEnter);
+                        target.element.removeEventListener('pointerleave', onLeave);
+                        target.element.removeEventListener('click', onSelect);
+                    };
+                    cleanups.set(target.id, cleanup);
+                    return () => {
+                        cleanup();
+                        cleanups.delete(target.id);
+                    };
+                },
+                bindSurface(surface) {
+                    const cleanupKey = `surface:${surface.id}`;
+                    if (cleanups.has(cleanupKey)) {
+                        throw new Error(`Pointer surface already bound: ${surface.id}`);
+                    }
+                    const onMove = (nativeEvent) => {
+                        emit('pointer:surface-move', {
+                            surfaceId: surface.id,
+                            element: surface.element,
+                            meta: surface.meta,
+                            ...getSurfaceCoordinates(surface.element, nativeEvent),
+                            nativeEvent,
+                        });
+                    };
+                    const onLeave = (nativeEvent) => {
+                        emit('pointer:surface-leave', {
+                            surfaceId: surface.id,
+                            element: surface.element,
+                            meta: surface.meta,
+                            ...getSurfaceCoordinates(surface.element, nativeEvent),
+                            nativeEvent,
+                        });
+                    };
+                    const onSelect = (nativeEvent) => {
+                        emit('pointer:surface-select', {
+                            surfaceId: surface.id,
+                            element: surface.element,
+                            meta: surface.meta,
+                            ...getSurfaceCoordinates(surface.element, nativeEvent),
+                            nativeEvent,
+                        });
+                    };
+                    surface.element.addEventListener('pointermove', onMove);
+                    surface.element.addEventListener('pointerleave', onLeave);
+                    surface.element.addEventListener('click', onSelect);
+                    const cleanup = () => {
+                        surface.element.removeEventListener('pointermove', onMove);
+                        surface.element.removeEventListener('pointerleave', onLeave);
+                        surface.element.removeEventListener('click', onSelect);
+                    };
+                    cleanups.set(cleanupKey, cleanup);
+                    return () => {
+                        cleanup();
+                        cleanups.delete(cleanupKey);
+                    };
+                },
+                clear() {
+                    for (const cleanup of cleanups.values()) {
+                        cleanup();
+                    }
+                    cleanups.clear();
+                },
+            };
+        },
+        dispose(_ctx, api) {
+            api.clear();
+        },
+    };
+}
+//# sourceMappingURL=pointer.js.map

package/dist/pointer.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Company: EonHive Inc.
+ * Title: Storage Adapter
+ * Purpose: Expose a small namespaced storage capability for local and session persistence.
+ * Author: Stan Nesi
+ * Created: 2026-04-21
+ * Updated: 2026-04-21
+ * Notes: Vibe coded with Codex.
+ */
+import type { AdapterRegistration } from '@urk/core';
+export type StorageArea = 'local' | 'session';
+export interface StorageAdapterOptions {
+    id?: string;
+    namespace?: string;
+}
+export interface StorageAdapterApi {
+    getItem<T = unknown>(key: string, area?: StorageArea): T | null;
+    setItem<T>(key: string, value: T, area?: StorageArea): void;
+    removeItem(key: string, area?: StorageArea): void;
+    listKeys(area?: StorageArea): string[];
+    clear(area?: StorageArea): void;
+}
+export declare function createStorageAdapter(options?: StorageAdapterOptions): AdapterRegistration<StorageAdapterApi>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAkB,MAAM,WAAW,CAAC;AAErE,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;AAE9C,MAAM,WAAW,qBAAqB;IACpC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC;IAChE,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5D,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CACjC;AA2GD,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,qBAA0B,GAClC,mBAAmB,CAAC,iBAAiB,CAAC,CA2DxC"}

package/dist/storage.js

@@ -0,0 +1,125 @@
+/**
+ * Company: EonHive Inc.
+ * Title: Storage Adapter
+ * Purpose: Expose a small namespaced storage capability for local and session persistence.
+ * Author: Stan Nesi
+ * Created: 2026-04-21
+ * Updated: 2026-04-21
+ * Notes: Vibe coded with Codex.
+ */
+const DEFAULT_NAMESPACE = 'urk';
+function isStorageBackendLike(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const candidate = value;
+    return (typeof candidate.length === 'number' &&
+        typeof candidate.key === 'function' &&
+        typeof candidate.getItem === 'function' &&
+        typeof candidate.setItem === 'function' &&
+        typeof candidate.removeItem === 'function');
+}
+function resolveServiceBackend(ctx, area) {
+    const serviceName = area === 'local' ? 'storage:local' : 'storage:session';
+    const value = ctx.services.get(serviceName);
+    if (value === undefined) {
+        return null;
+    }
+    if (!isStorageBackendLike(value)) {
+        throw new Error(`Service ${serviceName} must provide a Storage-compatible backend.`);
+    }
+    return value;
+}
+function resolveWindowBackend(area) {
+    if (typeof window === 'undefined') {
+        return null;
+    }
+    try {
+        return area === 'local' ? window.localStorage : window.sessionStorage;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : `Unable to access ${area}Storage.`;
+        throw new Error(`Storage adapter could not access ${area}Storage: ${message}`);
+    }
+}
+function resolveBackend(ctx, area) {
+    const serviceBackend = resolveServiceBackend(ctx, area);
+    if (serviceBackend) {
+        return serviceBackend;
+    }
+    const windowBackend = resolveWindowBackend(area);
+    if (windowBackend) {
+        return windowBackend;
+    }
+    throw new Error(`Storage adapter requires a ${area} storage backend.`);
+}
+function getStoragePrefix(namespace) {
+    return `${namespace}:`;
+}
+function getNamespacedKey(namespace, key) {
+    return `${getStoragePrefix(namespace)}${key}`;
+}
+function collectNamespacedKeys(backend, namespace) {
+    const keys = [];
+    const prefix = getStoragePrefix(namespace);
+    for (let index = 0; index < backend.length; index += 1) {
+        const key = backend.key(index);
+        if (!key || !key.startsWith(prefix)) {
+            continue;
+        }
+        keys.push(key.slice(prefix.length));
+    }
+    return keys;
+}
+export function createStorageAdapter(options = {}) {
+    const id = options.id ?? 'storage-adapter';
+    const namespace = options.namespace?.trim() || DEFAULT_NAMESPACE;
+    return {
+        id,
+        capability: 'storage',
+        setup(ctx) {
+            const backends = {
+                local: resolveBackend(ctx, 'local'),
+                session: resolveBackend(ctx, 'session'),
+            };
+            const getBackend = (area = 'local') => {
+                return backends[area];
+            };
+            return {
+                getItem(key, area = 'local') {
+                    const raw = getBackend(area).getItem(getNamespacedKey(namespace, key));
+                    if (raw === null) {
+                        return null;
+                    }
+                    try {
+                        return JSON.parse(raw);
+                    }
+                    catch {
+                        throw new Error(`Stored value for key "${key}" in ${area} storage is not valid JSON.`);
+                    }
+                },
+                setItem(key, value, area = 'local') {
+                    const serialized = JSON.stringify(value);
+                    if (serialized === undefined) {
+                        throw new Error(`Storage value for key "${key}" is not JSON serializable.`);
+                    }
+                    getBackend(area).setItem(getNamespacedKey(namespace, key), serialized);
+                },
+                removeItem(key, area = 'local') {
+                    getBackend(area).removeItem(getNamespacedKey(namespace, key));
+                },
+                listKeys(area = 'local') {
+                    return collectNamespacedKeys(getBackend(area), namespace);
+                },
+                clear(area = 'local') {
+                    const backend = getBackend(area);
+                    // Only remove keys owned by this adapter namespace.
+                    for (const key of collectNamespacedKeys(backend, namespace)) {
+                        backend.removeItem(getNamespacedKey(namespace, key));
+                    }
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2BH,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAEhC,SAAS,oBAAoB,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,KAAoC,CAAC;IAEvD,OAAO,CACL,OAAO,SAAS,CAAC,MAAM,KAAK,QAAQ;QACpC,OAAO,SAAS,CAAC,GAAG,KAAK,UAAU;QACnC,OAAO,SAAS,CAAC,OAAO,KAAK,UAAU;QACvC,OAAO,SAAS,CAAC,OAAO,KAAK,UAAU;QACvC,OAAO,SAAS,CAAC,UAAU,KAAK,UAAU,CAC3C,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAC5B,GAAmB,EACnB,IAAiB;IAEjB,MAAM,WAAW,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAC3E,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAU,WAAW,CAAC,CAAC;IAErD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,WAAW,WAAW,6CAA6C,CACpE,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAiB;IAC7C,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC;IACxE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,oBAAoB,IAAI,UAAU,CAAC;QAE9E,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,YAAY,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,GAAmB,EAAE,IAAiB;IAC5D,MAAM,cAAc,GAAG,qBAAqB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAExD,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,MAAM,aAAa,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAEjD,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,mBAAmB,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAiB;IACzC,OAAO,GAAG,SAAS,GAAG,CAAC;AACzB,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAiB,EAAE,GAAW;IACtD,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,GAAG,GAAG,EAAE,CAAC;AAChD,CAAC;AAED,SAAS,qBAAqB,CAC5B,OAA2B,EAC3B,SAAiB;IAEjB,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAE3C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAE/B,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,SAAS;QACX,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,UAAiC,EAAE;IAEnC,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,iBAAiB,CAAC;IAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,iBAAiB,CAAC;IAEjE,OAAO;QACL,EAAE;QACF,UAAU,EAAE,SAAS;QACrB,KAAK,CAAC,GAAG;YACP,MAAM,QAAQ,GAA4C;gBACxD,KAAK,EAAE,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC;gBACnC,OAAO,EAAE,cAAc,CAAC,GAAG,EAAE,SAAS,CAAC;aACxC,CAAC;YAEF,MAAM,UAAU,GAAG,CAAC,OAAoB,OAAO,EAAsB,EAAE;gBACrE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;YACxB,CAAC,CAAC;YAEF,OAAO;gBACL,OAAO,CAAc,GAAW,EAAE,OAAoB,OAAO;oBAC3D,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;oBAEvE,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;wBACjB,OAAO,IAAI,CAAC;oBACd,CAAC;oBAED,IAAI,CAAC;wBACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;oBAC9B,CAAC;oBAAC,MAAM,CAAC;wBACP,MAAM,IAAI,KAAK,CACb,yBAAyB,GAAG,QAAQ,IAAI,6BAA6B,CACtE,CAAC;oBACJ,CAAC;gBACH,CAAC;gBACD,OAAO,CAAI,GAAW,EAAE,KAAQ,EAAE,OAAoB,OAAO;oBAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;oBAEzC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;wBAC7B,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,6BAA6B,CAAC,CAAC;oBAC9E,CAAC;oBAED,UAAU,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC;gBACzE,CAAC;gBACD,UAAU,CAAC,GAAW,EAAE,OAAoB,OAAO;oBACjD,UAAU,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,gBAAgB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;gBAChE,CAAC;gBACD,QAAQ,CAAC,OAAoB,OAAO;oBAClC,OAAO,qBAAqB,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;gBAC5D,CAAC;gBACD,KAAK,CAAC,OAAoB,OAAO;oBAC/B,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;oBAEjC,oDAAoD;oBACpD,KAAK,MAAM,GAAG,IAAI,qBAAqB,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;wBAC5D,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;oBACvD,CAAC;gBACH,CAAC;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/three.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Company: EonHive Inc.
+ * Title: Three Adapter
+ * Purpose: Mount a small Three.js scene surface behind a stable URK capability contract.
+ * Author: Stan Nesi
+ * Created: 2026-04-22
+ * Updated: 2026-04-22
+ * Notes: Vibe coded with Codex.
+ */
+import type { AdapterRegistration } from '@urk/core';
+import * as THREE from 'three';
+export interface ThreeAdapterSize {
+    width: number;
+    height: number;
+}
+export interface ThreeAdapterApi {
+    getHost(): HTMLElement;
+    getCanvas(): HTMLCanvasElement;
+    getScene(): THREE.Scene;
+    getCamera(): THREE.PerspectiveCamera;
+    getRenderer(): THREE.WebGLRenderer;
+    getSize(): ThreeAdapterSize;
+    resize(): void;
+    render(): void;
+    raycast(clientX: number, clientY: number, objects: THREE.Object3D[]): THREE.Intersection<THREE.Object3D>[];
+}
+export declare function createThreeAdapter(id?: string): AdapterRegistration<ThreeAdapterApi>;
+//# sourceMappingURL=three.d.ts.map

package/dist/three.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"three.d.ts","sourceRoot":"","sources":["../src/three.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,IAAI,WAAW,CAAC;IACvB,SAAS,IAAI,iBAAiB,CAAC;IAC/B,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC;IACxB,SAAS,IAAI,KAAK,CAAC,iBAAiB,CAAC;IACrC,WAAW,IAAI,KAAK,CAAC,aAAa,CAAC;IACnC,OAAO,IAAI,gBAAgB,CAAC;IAC5B,MAAM,IAAI,IAAI,CAAC;IACf,MAAM,IAAI,IAAI,CAAC;IACf,OAAO,CACL,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,GACxB,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;CACzC;AAyBD,wBAAgB,kBAAkB,CAChC,EAAE,SAAkB,GACnB,mBAAmB,CAAC,eAAe,CAAC,CAsHtC"}

package/dist/three.js

@@ -0,0 +1,131 @@
+/**
+ * Company: EonHive Inc.
+ * Title: Three Adapter
+ * Purpose: Mount a small Three.js scene surface behind a stable URK capability contract.
+ * Author: Stan Nesi
+ * Created: 2026-04-22
+ * Updated: 2026-04-22
+ * Notes: Vibe coded with Codex.
+ */
+import * as THREE from 'three';
+function assertHtmlElement(value, serviceName) {
+    if (typeof HTMLElement === 'undefined' || !(value instanceof HTMLElement)) {
+        throw new Error(`Service ${serviceName} must be an HTMLElement.`);
+    }
+    return value;
+}
+function getHostSize(host) {
+    return {
+        width: Math.max(host.clientWidth, 1),
+        height: Math.max(host.clientHeight, 1),
+    };
+}
+function getPixelRatio() {
+    if (typeof window === 'undefined') {
+        return 1;
+    }
+    return Math.min(window.devicePixelRatio || 1, 2);
+}
+export function createThreeAdapter(id = 'three-adapter') {
+    let disposeResizeTracking = null;
+    return {
+        id,
+        capability: 'three',
+        isSupported() {
+            return typeof window !== 'undefined' && typeof document !== 'undefined';
+        },
+        setup(ctx) {
+            const host = assertHtmlElement(ctx.services.require('three:host'), 'three:host');
+            const scene = new THREE.Scene();
+            const camera = new THREE.PerspectiveCamera(42, 1, 0.1, 100);
+            const renderer = new THREE.WebGLRenderer({
+                alpha: true,
+                antialias: true,
+            });
+            const raycaster = new THREE.Raycaster();
+            const raycastPointer = new THREE.Vector2();
+            camera.position.set(0, 0, 5.75);
+            camera.lookAt(0, 0, 0);
+            renderer.outputColorSpace = THREE.SRGBColorSpace;
+            renderer.setClearColor(0x000000, 0);
+            renderer.domElement.style.width = '100%';
+            renderer.domElement.style.height = '100%';
+            renderer.domElement.style.display = 'block';
+            renderer.domElement.style.pointerEvents = 'none';
+            host.append(renderer.domElement);
+            let size = getHostSize(host);
+            const resize = () => {
+                size = getHostSize(host);
+                renderer.setPixelRatio(getPixelRatio());
+                renderer.setSize(size.width, size.height, false);
+                camera.aspect = size.width / size.height;
+                camera.updateProjectionMatrix();
+            };
+            resize();
+            if (typeof ResizeObserver !== 'undefined') {
+                const observer = new ResizeObserver(() => {
+                    resize();
+                });
+                observer.observe(host);
+                disposeResizeTracking = () => {
+                    observer.disconnect();
+                };
+            }
+            else if (typeof window !== 'undefined') {
+                const onResize = () => {
+                    resize();
+                };
+                window.addEventListener('resize', onResize);
+                disposeResizeTracking = () => {
+                    window.removeEventListener('resize', onResize);
+                };
+            }
+            else {
+                disposeResizeTracking = null;
+            }
+            return {
+                getHost() {
+                    return host;
+                },
+                getCanvas() {
+                    return renderer.domElement;
+                },
+                getScene() {
+                    return scene;
+                },
+                getCamera() {
+                    return camera;
+                },
+                getRenderer() {
+                    return renderer;
+                },
+                getSize() {
+                    return { ...size };
+                },
+                resize,
+                render() {
+                    renderer.render(scene, camera);
+                },
+                raycast(clientX, clientY, objects) {
+                    if (objects.length === 0) {
+                        return [];
+                    }
+                    const bounds = renderer.domElement.getBoundingClientRect();
+                    if (bounds.width <= 0 || bounds.height <= 0) {
+                        return [];
+                    }
+                    raycastPointer.set(((clientX - bounds.left) / bounds.width) * 2 - 1, -((clientY - bounds.top) / bounds.height) * 2 + 1);
+                    raycaster.setFromCamera(raycastPointer, camera);
+                    return raycaster.intersectObjects(objects, true);
+                },
+            };
+        },
+        dispose(_ctx, api) {
+            disposeResizeTracking?.();
+            disposeResizeTracking = null;
+            api.getRenderer().dispose();
+            api.getCanvas().remove();
+        },
+    };
+}
+//# sourceMappingURL=three.js.map

package/dist/three.js.map

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

package/dist/ui-widgets.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Company: EonHive Inc.
+ * Title: UI Widgets Adapter
+ * Purpose: Mount a small overlay shell with status and callout surfaces.
+ * Author: Stan Nesi
+ * Created: 2026-04-12
+ * Updated: 2026-04-15
+ * Notes: Vibe coded with Codex.
+ */
+import type { AdapterRegistration } from '@urk/core';
+export interface UiWidgetCallout {
+    title: string;
+    body: string;
+    tone?: 'neutral' | 'active' | 'selected';
+}
+export interface UiWidgetsAdapterApi {
+    setStatus(message: string): void;
+    showCallout(callout: UiWidgetCallout): void;
+    hideCallout(): void;
+    destroy(): void;
+}
+export declare function createUiWidgetsAdapter(id?: string): AdapterRegistration<UiWidgetsAdapterApi>;
+//# sourceMappingURL=ui-widgets.d.ts.map

package/dist/ui-widgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-widgets.d.ts","sourceRoot":"","sources":["../src/ui-widgets.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;CAC1C;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAC5C,WAAW,IAAI,IAAI,CAAC;IACpB,OAAO,IAAI,IAAI,CAAC;CACjB;AAUD,wBAAgB,sBAAsB,CACpC,EAAE,SAAuB,GACxB,mBAAmB,CAAC,mBAAmB,CAAC,CAoF1C"}

package/dist/ui-widgets.js

@@ -0,0 +1,92 @@
+/**
+ * Company: EonHive Inc.
+ * Title: UI Widgets Adapter
+ * Purpose: Mount a small overlay shell with status and callout surfaces.
+ * Author: Stan Nesi
+ * Created: 2026-04-12
+ * Updated: 2026-04-15
+ * Notes: Vibe coded with Codex.
+ */
+function assertHtmlElement(value, serviceName) {
+    if (typeof HTMLElement === 'undefined' || !(value instanceof HTMLElement)) {
+        throw new Error(`Service ${serviceName} must be an HTMLElement.`);
+    }
+    return value;
+}
+export function createUiWidgetsAdapter(id = 'ui-widgets-adapter') {
+    return {
+        id,
+        capability: 'ui-widgets',
+        setup(ctx) {
+            const host = assertHtmlElement(ctx.services.require('ui:host'), 'ui:host');
+            const root = document.createElement('div');
+            const status = document.createElement('div');
+            const callout = document.createElement('div');
+            const title = document.createElement('div');
+            const body = document.createElement('div');
+            root.style.position = 'absolute';
+            root.style.inset = '0';
+            root.style.pointerEvents = 'none';
+            root.style.display = 'flex';
+            root.style.flexDirection = 'column';
+            root.style.justifyContent = 'space-between';
+            root.style.padding = '16px';
+            status.style.alignSelf = 'flex-start';
+            status.style.padding = '8px 12px';
+            status.style.borderRadius = '999px';
+            status.style.background = 'rgba(15, 23, 42, 0.82)';
+            status.style.color = '#f8fafc';
+            status.style.fontSize = '13px';
+            status.style.fontWeight = '600';
+            status.style.letterSpacing = '0.02em';
+            status.style.backdropFilter = 'blur(12px)';
+            callout.style.alignSelf = 'flex-end';
+            callout.style.maxWidth = '280px';
+            callout.style.padding = '14px 16px';
+            callout.style.borderRadius = '18px';
+            callout.style.background = 'rgba(15, 23, 42, 0.92)';
+            callout.style.color = '#f8fafc';
+            callout.style.boxShadow = '0 20px 45px rgba(15, 23, 42, 0.22)';
+            callout.style.backdropFilter = 'blur(12px)';
+            callout.style.display = 'none';
+            title.style.fontSize = '14px';
+            title.style.fontWeight = '700';
+            title.style.marginBottom = '6px';
+            body.style.fontSize = '13px';
+            body.style.lineHeight = '1.5';
+            body.style.opacity = '0.92';
+            callout.append(title, body);
+            root.append(status, callout);
+            host.append(root);
+            const applyTone = (tone = 'neutral') => {
+                const palette = {
+                    neutral: 'rgba(15, 23, 42, 0.92)',
+                    active: 'rgba(14, 116, 144, 0.92)',
+                    selected: 'rgba(22, 101, 52, 0.94)',
+                };
+                callout.style.background = palette[tone];
+            };
+            return {
+                setStatus(message) {
+                    status.textContent = message;
+                },
+                showCallout(config) {
+                    title.textContent = config.title;
+                    body.textContent = config.body;
+                    callout.style.display = 'block';
+                    applyTone(config.tone);
+                },
+                hideCallout() {
+                    callout.style.display = 'none';
+                },
+                destroy() {
+                    root.remove();
+                },
+            };
+        },
+        dispose(_ctx, api) {
+            api.destroy();
+        },
+    };
+}
+//# sourceMappingURL=ui-widgets.js.map

package/dist/ui-widgets.js.map

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

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@urk/adapters",
+  "version": "0.1.0",
+  "description": "URK adapters - reference three, pointer, input, loading, storage, and overlay capability adapters",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "echo 'manual validation only for this milestone'",
+    "lint": "echo 'no lint yet'"
+  },
+  "peerDependencies": {
+    "@urk/core": "workspace:*",
+    "three": "^0.184.0"
+  },
+  "devDependencies": {
+    "@types/three": "^0.184.0",
+    "@urk/core": "workspace:*",
+    "three": "^0.184.0",
+    "typescript": "^5.3.0"
+  }
+}

package/src/adapters.ts

@@ -0,0 +1,11 @@
+/**
+ * URK adapter exports.
+ */
+
+export * from './loading';
+export * from './input';
+export * from './pointer';
+export * from './storage';
+export * from './three';
+export * from './ui-widgets';
+export * from './contracts';