wasi-shims: à la carte wasi:sockets UDP over Deno.listenDatagram

docs/architecture.md

@@ -88,7 +88,10 @@ contracts throughout the repo. Related documents:
   they are the ecosystem's most important interfaces and the conventions must
   serve them well — and a minimal WASI shim *package* (`wasi-shims/`, a
   separate deliverable; consumer-driven scope: p2 cli/io/clocks/random
-  baseline + p3 clocks).
+  baseline + p3 clocks, plus an à la carte p3 `wasi:sockets` UDP fragment
+  (`@deltic/wasi-shims/sockets`, adopted from polymorph-iroh's Deno host —
+  [#4](https://github.com/lann/deltic/issues/4)) that Deno-native hosts
+  opt into and the default `wasiShims()` never carries).
 - **Componentizing JS/TS.** Guests are components built by external toolchains
   (Rust + wit-bindgen is the reference). No embedded-JS-engine work.
 - **jco compatibility or reuse.** Ignored entirely — including at the

wasi-shims/deno.json

@@ -2,10 +2,11 @@
   "name": "@deltic/wasi-shims",
   "version": "0.1.0",
   "exports": {
-    ".": "./src/mod.ts"
+    ".": "./src/mod.ts",
+    "./sockets": "./src/sockets.ts"
   },
   "tasks": {
-    "test": "deno test --allow-read tests/",
+    "test": "deno test --allow-read --allow-net --unstable-net tests/",
     "check": "deno check src tests"
   },
   "publish": {

wasi-shims/src/mod.ts

@@ -1,7 +1,11 @@
 // wasi-shims — the minimal WASI shim package (contracts/embedder-api.md
 // C2 checklist item 7): the executable check that the embedder conventions
 // (`@deltic/runtime/embedder`) serve WASI. Scope: p2 baseline +
-// p3 clocks (mission scope; wasi:sockets/wasi:http deferred).
+// p3 clocks (mission scope; wasi:http deferred). p3 sockets UDP is à la
+// carte at `@deltic/wasi-shims/sockets` (issue #4; Deno-native hosts
+// only) — deliberately not merged here: this root module stays
+// host-agnostic web-platform code, and `wasiShims()` never grows a
+// fragment whose honest answer on most hosts is `not-supported`.
 //
 // `wasiShims(options)` returns one flat imports-record fragment, keyed by
 // compatibility-**track** keys per contracts/embedder-api.md §"Version