@urk/adapters 0.1.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (17) hide show
  1. package/README.md +34 -0
  2. package/dist/adapters.d.ts +8 -8
  3. package/dist/adapters.d.ts.map +1 -1
  4. package/dist/adapters.js +8 -8
  5. package/dist/adapters.js.map +1 -1
  6. package/dist/dom.d.ts +6 -6
  7. package/dist/dom.d.ts.map +1 -1
  8. package/dist/dom.js +6 -6
  9. package/dist/dom.js.map +1 -1
  10. package/dist/index.d.ts +1 -1
  11. package/dist/index.d.ts.map +1 -1
  12. package/dist/index.js +1 -1
  13. package/dist/index.js.map +1 -1
  14. package/package.json +3 -3
  15. package/src/adapters.ts +8 -8
  16. package/src/dom.ts +6 -6
  17. package/src/index.ts +1 -1
package/README.md CHANGED
@@ -2,6 +2,10 @@
2
2
 
3
3
  Contract-first capability adapters that prove URK's v0 kernel surface.
4
4
 
5
+ The root `@urk/adapters` entrypoint exports every reference adapter, including
6
+ the Three scene adapter. DOM-only consumers that do not need Three should import
7
+ from `@urk/adapters/dom`.
8
+
5
9
  ## Reference adapters
6
10
 
7
11
  - `createAudioAdapter()` - manage browser-native audio transport across a small set of registered tracks
@@ -43,6 +47,36 @@ const kernel = createKernel({
43
47
  await kernel.boot();
44
48
  ```
45
49
 
50
+ ## DOM-only consumers
51
+
52
+ Use the `@urk/adapters/dom` subpath when a host only needs browser DOM
53
+ capabilities and should not consume the Three adapter surface:
54
+
55
+ ```ts
56
+ import { createKernel } from '@urk/core';
57
+ import {
58
+ createLoadingAdapter,
59
+ createPointerAdapter,
60
+ createUiWidgetsAdapter,
61
+ } from '@urk/adapters/dom';
62
+
63
+ const kernel = createKernel({
64
+ services: {
65
+ 'ui:host': document.querySelector('#overlay-host'),
66
+ },
67
+ adapters: [
68
+ createLoadingAdapter(),
69
+ createPointerAdapter(),
70
+ createUiWidgetsAdapter(),
71
+ ],
72
+ });
73
+
74
+ await kernel.boot();
75
+ ```
76
+
77
+ This is the intended path for dependency-light DOM hosts such as Kivatar's
78
+ current host shell. The DOM subpath does not export `createThreeAdapter()`.
79
+
46
80
  These adapters use the canonical `AdapterRegistration<TApi>` contract from `@urk/core`. They are intentionally small and exist to prove the kernel surface, not to introduce a broad adapter matrix early.
47
81
 
48
82
  `createAudioAdapter()` is deliberately transport-first in this milestone:
package/dist/adapters.d.ts CHANGED
@@ -1,12 +1,12 @@
1
1
  /**
2
2
  * URK adapter exports.
3
3
  */
4
- export * from './loading';
5
- export * from './audio';
6
- export * from './input';
7
- export * from './pointer';
8
- export * from './storage';
9
- export * from './three';
10
- export * from './ui-widgets';
11
- export * from './contracts';
4
+ export * from './loading.js';
5
+ export * from './audio.js';
6
+ export * from './input.js';
7
+ export * from './pointer.js';
8
+ export * from './storage.js';
9
+ export * from './three.js';
10
+ export * from './ui-widgets.js';
11
+ export * from './contracts.js';
12
12
  //# sourceMappingURL=adapters.d.ts.map
package/dist/adapters.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}
1
+ {"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}
package/dist/adapters.js CHANGED
@@ -1,12 +1,12 @@
1
1
  /**
2
2
  * URK adapter exports.
3
3
  */
4
- export * from './loading';
5
- export * from './audio';
6
- export * from './input';
7
- export * from './pointer';
8
- export * from './storage';
9
- export * from './three';
10
- export * from './ui-widgets';
11
- export * from './contracts';
4
+ export * from './loading.js';
5
+ export * from './audio.js';
6
+ export * from './input.js';
7
+ export * from './pointer.js';
8
+ export * from './storage.js';
9
+ export * from './three.js';
10
+ export * from './ui-widgets.js';
11
+ export * from './contracts.js';
12
12
  //# sourceMappingURL=adapters.js.map
package/dist/adapters.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"adapters.js","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}
1
+ {"version":3,"file":"adapters.js","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}
package/dist/dom.d.ts CHANGED
@@ -7,10 +7,10 @@
7
7
  * Updated: 2026-04-23
8
8
  * Notes: Vibe coded with Codex.
9
9
  */
10
- export * from './loading';
11
- export * from './input';
12
- export * from './pointer';
13
- export * from './storage';
14
- export * from './ui-widgets';
15
- export * from './contracts';
10
+ export * from './loading.js';
11
+ export * from './input.js';
12
+ export * from './pointer.js';
13
+ export * from './storage.js';
14
+ export * from './ui-widgets.js';
15
+ export * from './contracts.js';
16
16
  //# sourceMappingURL=dom.d.ts.map
package/dist/dom.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}
1
+ {"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}
package/dist/dom.js CHANGED
@@ -7,10 +7,10 @@
7
7
  * Updated: 2026-04-23
8
8
  * Notes: Vibe coded with Codex.
9
9
  */
10
- export * from './loading';
11
- export * from './input';
12
- export * from './pointer';
13
- export * from './storage';
14
- export * from './ui-widgets';
15
- export * from './contracts';
10
+ export * from './loading.js';
11
+ export * from './input.js';
12
+ export * from './pointer.js';
13
+ export * from './storage.js';
14
+ export * from './ui-widgets.js';
15
+ export * from './contracts.js';
16
16
  //# sourceMappingURL=dom.js.map
package/dist/dom.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"dom.js","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}
1
+ {"version":3,"file":"dom.js","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
2
  * URK Adapters - Contract-first capability adapters.
3
3
  */
4
- export * from './adapters';
4
+ export * from './adapters.js';
5
5
  //# sourceMappingURL=index.d.ts.map
package/dist/index.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,eAAe,CAAC"}
package/dist/index.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
2
  * URK Adapters - Contract-first capability adapters.
3
3
  */
4
- export * from './adapters';
4
+ export * from './adapters.js';
5
5
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,eAAe,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@urk/adapters",
3
- "version": "0.1.1",
3
+ "version": "0.1.3",
4
4
  "description": "URK adapters - reference three, pointer, input, loading, storage, and overlay capability adapters",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -27,7 +27,7 @@
27
27
  "lint": "echo 'no lint yet'"
28
28
  },
29
29
  "peerDependencies": {
30
- "@urk/core": "^0.1.0",
30
+ "@urk/core": "^0.1.1",
31
31
  "three": "^0.184.0"
32
32
  },
33
33
  "peerDependenciesMeta": {
@@ -37,7 +37,7 @@
37
37
  },
38
38
  "devDependencies": {
39
39
  "@types/three": "^0.184.0",
40
- "@urk/core": "^0.1.0",
40
+ "@urk/core": "^0.1.1",
41
41
  "three": "^0.184.0",
42
42
  "typescript": "^5.3.0"
43
43
  }
package/src/adapters.ts CHANGED
@@ -2,11 +2,11 @@
2
2
  * URK adapter exports.
3
3
  */
4
4
 
5
- export * from './loading';
6
- export * from './audio';
7
- export * from './input';
8
- export * from './pointer';
9
- export * from './storage';
10
- export * from './three';
11
- export * from './ui-widgets';
12
- export * from './contracts';
5
+ export * from './loading.js';
6
+ export * from './audio.js';
7
+ export * from './input.js';
8
+ export * from './pointer.js';
9
+ export * from './storage.js';
10
+ export * from './three.js';
11
+ export * from './ui-widgets.js';
12
+ export * from './contracts.js';
package/src/dom.ts CHANGED
@@ -8,9 +8,9 @@
8
8
  * Notes: Vibe coded with Codex.
9
9
  */
10
10
 
11
- export * from './loading';
12
- export * from './input';
13
- export * from './pointer';
14
- export * from './storage';
15
- export * from './ui-widgets';
16
- export * from './contracts';
11
+ export * from './loading.js';
12
+ export * from './input.js';
13
+ export * from './pointer.js';
14
+ export * from './storage.js';
15
+ export * from './ui-widgets.js';
16
+ export * from './contracts.js';
package/src/index.ts CHANGED
@@ -2,4 +2,4 @@
2
2
  * URK Adapters - Contract-first capability adapters.
3
3
  */
4
4
 
5
- export * from './adapters';
5
+ export * from './adapters.js';