@glassly/jspolyfill 0.1.0-dev.0

package/README.md

@@ -0,0 +1,31 @@
+# @glassly/jspolyfill
+
+The GlasslyJS polyfill bundle. Glassly runs each miniapp in its own bare JS
+context (JavaScriptCore on iOS, QuickJS on Android); this package provides the
+browser-like standard library those contexts lack — `console`, timers,
+`fetch`, `WebSocket`, `localStorage`, `crypto.getRandomValues`, and
+`crypto.randomUUID` — implemented over a single `__dispatch` native bridge,
+plus the `__deliver` / `signalReady` plumbing the host runtime relies on.
+`crypto.subtle` is not implemented.
+
+You don't import this package from app code: it's a **peer of the runtime
+stack**. [`@glassly/crust`](https://www.npmjs.com/package/@glassly/crust)'s
+Android build reads the bundle from this package's `assets/` at build time,
+and the engine injects it into each miniapp context at spawn.
+
+## Install
+
+Installed automatically alongside
+[`@glassly/engine`](https://www.npmjs.com/package/@glassly/engine) /
+`@glassly/crust`. For direct use:
+
+```sh
+npm install @glassly/jspolyfill@dev
+```
+
+> Currently published on the `dev` dist-tag (prerelease channel).
+
+## Part of Glassly
+
+Source lives in the [Glassly monorepo](https://github.com/tetramo-labs/glassly)
+under `mobile/modules/jspolyfill`. Issues and contributions welcome there.