@pyreon/server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present Vit Bokisch
+
+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,91 @@
+# @pyreon/server
+
+SSR handler, static site generation, and island architecture for Pyreon.
+
+## Install
+
+```bash
+bun add @pyreon/server
+```
+
+## SSR
+
+Create a request handler that renders your Pyreon app on the server:
+
+```ts
+import { createHandler } from "@pyreon/server"
+import { App } from "./App"
+import { routes } from "./routes"
+
+const handler = createHandler({
+  App,
+  routes,
+  template: await Bun.file("index.html").text(),
+})
+
+Bun.serve({ fetch: handler, port: 3000 })
+```
+
+## SSG (Static Site Generation)
+
+Pre-render pages to static HTML files:
+
+```ts
+import { createHandler, prerender } from "@pyreon/server"
+
+const handler = createHandler({ App, routes })
+const result = await prerender({
+  handler,
+  paths: ["/", "/about", "/blog"],
+  outDir: "dist",
+})
+console.log(`Generated ${result.pages} pages in ${result.elapsed}ms`)
+```
+
+## Islands
+
+Render mostly-static pages with interactive islands that hydrate independently:
+
+```ts
+// Server
+import { island } from "@pyreon/server"
+
+const Counter = island(() => import("./Counter"), {
+  name: "Counter",
+  hydrate: "visible",  // load | idle | visible | media(query) | never
+})
+```
+
+```ts
+// Client entry
+import { startClient, hydrateIslands } from "@pyreon/server/client"
+
+// Full app hydration
+startClient({ App, routes, container: "#app" })
+
+// Or island-only hydration
+hydrateIslands({
+  Counter: () => import("./Counter"),
+  Search: () => import("./Search"),
+})
+```
+
+## API
+
+### Server Exports (`@pyreon/server`)
+
+- `createHandler(options: HandlerOptions)` -- create an SSR request handler
+- `prerender(options: PrerenderOptions)` -- generate static HTML files
+- `island(loader, options: IslandOptions)` -- define an island component
+- `processTemplate(template, data)` -- inject rendered HTML into an HTML template
+- `buildScripts(data)` -- generate script tags for hydration
+- `DEFAULT_TEMPLATE` -- built-in HTML template
+
+### Client Exports (`@pyreon/server/client`)
+
+- `startClient(options: StartClientOptions)` -- hydrate a full SSR app
+- `hydrateIslands(registry)` -- hydrate island components on the page
+
+### Types
+
+`HandlerOptions`, `PrerenderOptions`, `PrerenderResult`, `IslandOptions`, `IslandMeta`, `HydrationStrategy`, `Middleware`, `MiddlewareContext`, `TemplateData`, `StartClientOptions`