@hoardodile/sdk-web 0.0.0

package/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 Wooloo <ayan0312000@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,47 @@
+# @hoardodile/sdk-web
+
+Pure-browser iframe runtime for hoardodile content plugins: the wire
+protocol (single source of truth, versioned via `PROTOCOL_VERSION`), host
+bridge, stores, and theme/font/visibility helpers. No node code — the
+d.ts surface is guarded against node references in CI.
+
+Use `@hoardodile/sdk-react` when you build with React; drop to this
+package for framework-agnostic iframe code.
+
+## Install
+
+```bash
+pnpm add @hoardodile/sdk-web
+```
+
+## What's in it
+
+- **`createIframeHostAPI(ctx)`** — the imperative, framework-agnostic
+  `WebPluginAPI`: files, messages, danmaku, prefs, cache, invalidation,
+  anchor-jump subscription
+- **`mountPlugin(mount)`** — host→plugin communication with a pooled
+  iframe lifecycle (rebind without reload)
+- **`createWebPluginAPI(overrides)`** — a stubbed API for render tests
+- **`jsonCodec` / `numberCodec` / `booleanCodec`** — typed pref codecs
+- **`applyTheme` / `applyFonts`** — host theme and font inheritance
+- **`ensureHostBridge`** — low-level postMessage bridge (rarely needed)
+
+## Quick start
+
+```ts
+import { mountPlugin, createIframeHostAPI } from "@hoardodile/sdk-web"
+
+mountPlugin((ctx) => {
+	const api = createIframeHostAPI(ctx)
+	api.listFiles().then((files) => {
+		document.querySelector("#root")!.textContent = files.join(", ")
+	})
+})
+```
+
+## Where does the code live?
+
+The wire protocol is the contract, defined once in `@hoardodile/sdk-types`
+and re-exported here for a single import root. The browser-side *host*
+runtime (`@hoardodile/host-web`) consumes this protocol — it never
+redefines it.