@hyperspan/framework 0.1.7 → 0.2.0

package/LICENSE.txt

@@ -0,0 +1,30 @@
+BSD 3-Clause License
+
+Hyperspan copyright (c) 2025, Vance Lucas.
+LINK: https://www.hyperspan.dev
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -1,5 +1,11 @@
 # @hyperspan/framework
 
-> [!NOTE] > **The Hyperspan framework package is still in the heavy development. APIs may change without notice.**
+![License](https://img.shields.io/npm/l/%40hyperspan%2Fframework?style=for-the-badge&labelColor=2e3440&color=6f4fbe)
+![Version](https://img.shields.io/npm/v/%40hyperspan%2Fframework.svg?label=Version&style=for-the-badge&labelColor=2e3440&color=eea837)
+![Downloads](https://img.shields.io/npm/dw/%40hyperspan%2Fframework?style=for-the-badge&labelColor=2e3440&color=50b6a9)
+![Bun Badge](https://img.shields.io/badge/Bun-000?logo=bun&logoColor=fff&style=for-the-badge&color=2e3440)
+![TypeScript Badge](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=fff&style=for-the-badge)
 
-Full Hyperspan framework docs coming soon...
+Hyperspan web framework!
+
+Information and docs are at [Hyperspan.dev](https://www.hyperspan.dev)

package/build.ts

@@ -1,7 +1,7 @@
 import { build } from 'bun';
 
 const entrypoints = ['./src/server.ts', './src/assets.ts'];
-const external = ['@hyperspan/html'];
+const external = ['@hyperspan/html', 'preact', 'preact-render-to-string'];
 const outdir = './dist';
 const target = 'node';
 const splitting = true;

package/dist/assets.js

@@ -55,67 +55,36 @@ function hyperspanScriptTags() {
         ></script>`)}
   `;
 }
-var PREACT_PUBLIC_FILE_PATH = "/_hs/js/preact.js";
-function md5(content) {
+function assetHash(content) {
   return createHash("md5").update(content).digest("hex");
 }
-async function copyPreactToPublicFolder() {
-  const sourceFile = resolve(PWD, "../", "./src/clientjs/preact.ts");
-  const preactClient = Bun.build({
-    entrypoints: [sourceFile],
-    outdir: "./public/_hs/js",
-    minify: true,
-    format: "esm",
-    target: "browser"
-  });
-}
-async function createPreactIsland(file) {
-  let filePath = file.replace("file://", "");
-  const jsId = md5(filePath);
-  if (!clientImportMap.has("preact")) {
-    await copyPreactToPublicFolder();
-    clientImportMap.set("preact", "" + PREACT_PUBLIC_FILE_PATH);
-    clientImportMap.set("preact/compat", "" + PREACT_PUBLIC_FILE_PATH);
-    clientImportMap.set("preact/hooks", "" + PREACT_PUBLIC_FILE_PATH);
-    clientImportMap.set("preact/jsx-runtime", "" + PREACT_PUBLIC_FILE_PATH);
+var ISLAND_PUBLIC_PATH = "/_hs/js/islands";
+var ISLAND_DEFAULTS = () => ({
+  ssr: true
+});
+function renderIsland(Component, props, options = ISLAND_DEFAULTS()) {
+  if (Component.__HS_ISLAND?.render) {
+    return Component.__HS_ISLAND.render(props, options);
   }
-  if (!clientImportMap.has("react")) {
-    clientImportMap.set("react", "." + PREACT_PUBLIC_FILE_PATH);
-    clientImportMap.set("react-dom", "." + PREACT_PUBLIC_FILE_PATH);
+  if (Component.__HS_ISLAND?.ssr && options.ssr) {
+    return Component.__HS_ISLAND.ssr(props);
   }
-  let resultStr = 'import{h,render}from"preact";';
-  const buildResult = await Bun.build({
-    entrypoints: [filePath],
-    minify: true,
-    external: ["react", "preact"],
-    env: "APP_PUBLIC_*"
-  });
-  for (const output of buildResult.outputs) {
-    resultStr += await output.text();
-  }
-  const r = /export\{([a-zA-Z]+) as default\}/g;
-  const matchExport = r.exec(resultStr);
-  if (!matchExport) {
-    throw new Error("File does not have a default export! Ensure a function has export default to use this.");
+  if (Component.__HS_ISLAND?.clientOnly) {
+    return Component.__HS_ISLAND.clientOnly(props);
   }
-  const fn = matchExport[1];
-  let _mounted = false;
-  return (props) => {
-    if (!_mounted) {
-      _mounted = true;
-      resultStr += `render(h(${fn}, ${JSON.stringify(props)}), document.getElementById("${jsId}"));`;
-    }
-    return html.raw(`<div id="${jsId}"></div><script type="module" data-source-id="${jsId}">${resultStr}</script>`);
-  };
+  throw new Error(`Module ${Component.name} was not loaded with an island plugin! Did you forget to install an island plugin and add it to the createServer() 'islandPlugins' config?`);
 }
 export {
+  renderIsland,
   hyperspanStyleTags,
   hyperspanScriptTags,
-  createPreactIsland,
   clientJSFiles,
   clientImportMap,
   clientCSSFiles,
   buildClientJS,
-  buildClientCSS
+  buildClientCSS,
+  assetHash,
+  ISLAND_PUBLIC_PATH,
+  ISLAND_DEFAULTS
 };
 

package/dist/server.js

@@ -8,8 +8,8 @@ import { readdir } from "node:fs/promises";
 import { basename, extname, join } from "node:path";
 import { html, isHSHtml, renderStream, renderAsync, render } from "@hyperspan/html";
 
-// node_modules/isbot/index.mjs
-var fullPattern = " daum[ /]| deusu/| yadirectfetcher|(?:^|[^g])news(?!sapphire)|(?<! (?:channel/|google/))google(?!(app|/google| pixel))|(?<! cu)bots?(?:\\b|_)|(?<!(?:lib))http|(?<![hg]m)score|(?<!cam)scan|@[a-z][\\w-]+\\.|\\(\\)|\\.com\\b|\\btime/|\\||^<|^[\\w \\.\\-\\(?:\\):%]+(?:/v?\\d+(?:\\.\\d+)?(?:\\.\\d{1,10})*?)?(?:,|$)|^[^ ]{50,}$|^\\d+\\b|^\\w*search\\b|^\\w+/[\\w\\(\\)]*$|^active|^ad muncher|^amaya|^avsdevicesdk/|^biglotron|^bot|^bw/|^clamav[ /]|^client/|^cobweb/|^custom|^ddg[_-]android|^discourse|^dispatch/\\d|^downcast/|^duckduckgo|^email|^facebook|^getright/|^gozilla/|^hobbit|^hotzonu|^hwcdn/|^igetter/|^jeode/|^jetty/|^jigsaw|^microsoft bits|^movabletype|^mozilla/\\d\\.\\d\\s[\\w\\.-]+$|^mozilla/\\d\\.\\d\\s\\(compatible;?(?:\\s\\w+\\/\\d+\\.\\d+)?\\)$|^navermailapp|^netsurf|^offline|^openai/|^owler|^php|^postman|^python|^rank|^read|^reed|^rest|^rss|^snapchat|^space bison|^svn|^swcd |^taringa|^thumbor/|^track|^w3c|^webbandit/|^webcopier|^wget|^whatsapp|^wordpress|^xenu link sleuth|^yahoo|^yandex|^zdm/\\d|^zoom marketplace/|^{{.*}}$|analyzer|archive|ask jeeves/teoma|audit|bit\\.ly/|bluecoat drtr|browsex|burpcollaborator|capture|catch|check\\b|checker|chrome-lighthouse|chromeframe|classifier|cloudflare|convertify|crawl|cypress/|dareboost|datanyze|dejaclick|detect|dmbrowser|download|evc-batch/|exaleadcloudview|feed|firephp|functionize|gomezagent|grab|headless|httrack|hubspot marketing grader|hydra|ibisbrowser|infrawatch|insight|inspect|iplabel|ips-agent|java(?!;)|library|linkcheck|mail\\.ru/|manager|measure|neustar wpm|node|nutch|offbyone|onetrust|optimize|pageburst|pagespeed|parser|perl|phantomjs|pingdom|powermarks|preview|proxy|ptst[ /]\\d|retriever|rexx;|rigor|rss\\b|scrape|server|sogou|sparkler/|speedcurve|spider|splash|statuscake|supercleaner|synapse|synthetic|tools|torrent|transcoder|url|validator|virtuoso|wappalyzer|webglance|webkit2png|whatcms/";
+// ../../node_modules/isbot/index.mjs
+var fullPattern = " daum[ /]| deusu/| yadirectfetcher|(?:^|[^g])news(?!sapphire)|(?<! (?:channel/|google/))google(?!(app|/google| pixel))|(?<! cu)bots?(?:\\b|_)|(?<!(?:lib))http|(?<![hg]m)score|(?<!cam)scan|@[a-z][\\w-]+\\.|\\(\\)|\\.com\\b|\\btime/|\\||^<|^[\\w \\.\\-\\(?:\\):%]+(?:/v?\\d+(?:\\.\\d+)?(?:\\.\\d{1,10})*?)?(?:,|$)|^[^ ]{50,}$|^\\d+\\b|^\\w*search\\b|^\\w+/[\\w\\(\\)]*$|^active|^ad muncher|^amaya|^avsdevicesdk/|^biglotron|^bot|^bw/|^clamav[ /]|^client/|^cobweb/|^custom|^ddg[_-]android|^discourse|^dispatch/\\d|^downcast/|^duckduckgo|^email|^facebook|^getright/|^gozilla/|^hobbit|^hotzonu|^hwcdn/|^igetter/|^jeode/|^jetty/|^jigsaw|^microsoft bits|^movabletype|^mozilla/\\d\\.\\d\\s[\\w\\.-]+$|^mozilla/\\d\\.\\d\\s\\(compatible;?(?:\\s\\w+\\/\\d+\\.\\d+)?\\)$|^navermailapp|^netsurf|^offline|^openai/|^owler|^php|^postman|^python|^rank|^read|^reed|^rest|^rss|^snapchat|^space bison|^svn|^swcd |^taringa|^thumbor/|^track|^w3c|^webbandit/|^webcopier|^wget|^whatsapp|^wordpress|^xenu link sleuth|^yahoo|^yandex|^zdm/\\d|^zoom marketplace/|^{{.*}}$|analyzer|archive|ask jeeves/teoma|audit|bit\\.ly/|bluecoat drtr|browsex|burpcollaborator|capture|catch|check\\b|checker|chrome-lighthouse|chromeframe|classifier|cloudflare|convertify|crawl|cypress/|dareboost|datanyze|dejaclick|detect|dmbrowser|download|evc-batch/|exaleadcloudview|feed|firephp|functionize|gomezagent|grab|headless|httrack|hubspot marketing grader|hydra|ibisbrowser|infrawatch|insight|inspect|iplabel|ips-agent|java(?!;)|library|linkcheck|mail\\.ru/|manager|measure|neustar wpm|node|nutch|offbyone|onetrust|optimize|pageburst|pagespeed|parser|perl|phantomjs|pingdom|powermarks|preview|proxy|ptst[ /]\\d|retriever|rexx;|rigor|rss\\b|scrape|server|sogou|sparkler/|speedcurve|spider|splash|statuscake|supercleaner|synapse|synthetic|tools|torrent|transcoder|url|validator|virtuoso|wappalyzer|webglance|webkit2png|whatcms/|xtate/";
 var naivePattern = /bot|crawl|http|lighthouse|scan|search|spider/i;
 var pattern;
 function getPattern() {
@@ -27,7 +27,7 @@ function isbot(userAgent) {
   return Boolean(userAgent) && getPattern().test(userAgent);
 }
 
-// node_modules/hono/dist/compose.js
+// ../../node_modules/hono/dist/compose.js
 var compose = (middleware, onError, onNotFound) => {
   return (context, next) => {
     let index = -1;
@@ -71,7 +71,7 @@ var compose = (middleware, onError, onNotFound) => {
   };
 };
 
-// node_modules/hono/dist/utils/body.js
+// ../../node_modules/hono/dist/utils/body.js
 var parseBody = async (request, options = /* @__PURE__ */ Object.create(null)) => {
   const { all = false, dot = false } = options;
   const headers = request instanceof HonoRequest ? request.raw.headers : request.headers;
@@ -135,7 +135,7 @@ var handleParsingNestedValues = (form, key, value) => {
   });
 };
 
-// node_modules/hono/dist/utils/url.js
+// ../../node_modules/hono/dist/utils/url.js
 var splitPath = (path) => {
   const paths = path.split("/");
   if (paths[0] === "") {
@@ -330,7 +330,7 @@ var getQueryParams = (url, key) => {
 };
 var decodeURIComponent_ = decodeURIComponent;
 
-// node_modules/hono/dist/request.js
+// ../../node_modules/hono/dist/request.js
 var tryDecodeURIComponent = (str) => tryDecode(str, decodeURIComponent_);
 var HonoRequest = class {
   raw;
@@ -438,7 +438,7 @@ var HonoRequest = class {
   }
 };
 
-// node_modules/hono/dist/utils/html.js
+// ../../node_modules/hono/dist/utils/html.js
 var HtmlEscapedCallbackPhase = {
   Stringify: 1,
   BeforeStream: 2,
@@ -476,7 +476,7 @@ var resolveCallback = async (str, phase, preserveCallbacks, context, buffer) =>
   }
 };
 
-// node_modules/hono/dist/context.js
+// ../../node_modules/hono/dist/context.js
 var TEXT_PLAIN = "text/plain; charset=UTF-8";
 var setHeaders = (headers, map = {}) => {
   for (const key of Object.keys(map)) {
@@ -717,7 +717,7 @@ var Context = class {
   };
 };
 
-// node_modules/hono/dist/router.js
+// ../../node_modules/hono/dist/router.js
 var METHOD_NAME_ALL = "ALL";
 var METHOD_NAME_ALL_LOWERCASE = "all";
 var METHODS = ["get", "post", "put", "delete", "options", "patch"];
@@ -725,10 +725,10 @@ var MESSAGE_MATCHER_IS_ALREADY_BUILT = "Can not add a route since the matcher is
 var UnsupportedPathError = class extends Error {
 };
 
-// node_modules/hono/dist/utils/constants.js
+// ../../node_modules/hono/dist/utils/constants.js
 var COMPOSED_HANDLER = "__COMPOSED_HANDLER";
 
-// node_modules/hono/dist/hono-base.js
+// ../../node_modules/hono/dist/hono-base.js
 var notFoundHandler = (c) => {
   return c.text("404 Not Found", 404);
 };
@@ -801,6 +801,8 @@ var Hono = class {
       router: this.router,
       getPath: this.getPath
     });
+    clone.errorHandler = this.errorHandler;
+    clone.#notFoundHandler = this.#notFoundHandler;
     clone.routes = this.routes;
     return clone;
   }
@@ -855,8 +857,7 @@ var Hono = class {
       let executionContext = undefined;
       try {
         executionContext = c.executionCtx;
-      } catch {
-      }
+      } catch {}
       return [c.env, executionContext];
     };
     replaceRequest ||= (() => {
@@ -945,7 +946,7 @@ var Hono = class {
   };
 };
 
-// node_modules/hono/dist/router/reg-exp-router/node.js
+// ../../node_modules/hono/dist/router/reg-exp-router/node.js
 var LABEL_REG_EXP_STR = "[^/]+";
 var ONLY_WILDCARD_REG_EXP_STR = ".*";
 var TAIL_WILDCARD_REG_EXP_STR = "(?:|/.*)";
@@ -1046,7 +1047,7 @@ var Node = class {
   }
 };
 
-// node_modules/hono/dist/router/reg-exp-router/trie.js
+// ../../node_modules/hono/dist/router/reg-exp-router/trie.js
 var Trie = class {
   #context = { varIndex: 0 };
   #root = new Node;
@@ -1102,7 +1103,7 @@ var Trie = class {
   }
 };
 
-// node_modules/hono/dist/router/reg-exp-router/router.js
+// ../../node_modules/hono/dist/router/reg-exp-router/router.js
 var emptyParam = [];
 var nullMatcher = [/^$/, [], /* @__PURE__ */ Object.create(null)];
 var wildcardRegExpCache = /* @__PURE__ */ Object.create(null);
@@ -1284,7 +1285,7 @@ var RegExpRouter = class {
   }
 };
 
-// node_modules/hono/dist/router/smart-router/router.js
+// ../../node_modules/hono/dist/router/smart-router/router.js
 var SmartRouter = class {
   name = "SmartRouter";
   #routers = [];
@@ -1339,7 +1340,7 @@ var SmartRouter = class {
   }
 };
 
-// node_modules/hono/dist/router/trie-router/node.js
+// ../../node_modules/hono/dist/router/trie-router/node.js
 var emptyParams = /* @__PURE__ */ Object.create(null);
 var Node2 = class {
   #methods;
@@ -1495,7 +1496,7 @@ var Node2 = class {
   }
 };
 
-// node_modules/hono/dist/router/trie-router/router.js
+// ../../node_modules/hono/dist/router/trie-router/router.js
 var TrieRouter = class {
   name = "TrieRouter";
   #node;
@@ -1517,7 +1518,7 @@ var TrieRouter = class {
   }
 };
 
-// node_modules/hono/dist/hono.js
+// ../../node_modules/hono/dist/hono.js
 var Hono2 = class extends Hono {
   constructor(options = {}) {
     super(options);
@@ -1527,13 +1528,13 @@ var Hono2 = class extends Hono {
   }
 };
 
-// node_modules/hono/dist/adapter/bun/serve-static.js
+// ../../node_modules/hono/dist/adapter/bun/serve-static.js
 import { stat } from "node:fs/promises";
 
-// node_modules/hono/dist/utils/compress.js
+// ../../node_modules/hono/dist/utils/compress.js
 var COMPRESSIBLE_CONTENT_TYPE_REGEX = /^\s*(?:text\/(?!event-stream(?:[;\s]|$))[^;\s]+|application\/(?:javascript|json|xml|xml-dtd|ecmascript|dart|postscript|rtf|tar|toml|vnd\.dart|vnd\.ms-fontobject|vnd\.ms-opentype|wasm|x-httpd-php|x-javascript|x-ns-proxy-autoconfig|x-sh|x-tar|x-virtualbox-hdd|x-virtualbox-ova|x-virtualbox-ovf|x-virtualbox-vbox|x-virtualbox-vdi|x-virtualbox-vhd|x-virtualbox-vmdk|x-www-form-urlencoded)|font\/(?:otf|ttf)|image\/(?:bmp|vnd\.adobe\.photoshop|vnd\.microsoft\.icon|vnd\.ms-dds|x-icon|x-ms-bmp)|message\/rfc822|model\/gltf-binary|x-shader\/x-fragment|x-shader\/x-vertex|[^;\s]+?\+(?:json|text|xml|yaml))(?:[;\s]|$)/i;
 
-// node_modules/hono/dist/utils/filepath.js
+// ../../node_modules/hono/dist/utils/filepath.js
 var getFilePath = (options) => {
   let filename = options.filename;
   const defaultDocument = options.defaultDocument || "index.html";
@@ -1565,7 +1566,7 @@ var getFilePathWithoutDefaultDocument = (options) => {
   return path;
 };
 
-// node_modules/hono/dist/utils/mime.js
+// ../../node_modules/hono/dist/utils/mime.js
 var getMimeType = (filename, mimes = baseMimes) => {
   const regexp = /\.([a-zA-Z0-9]+?)$/;
   const match = filename.match(regexp);
@@ -1637,7 +1638,7 @@ var _baseMimes = {
 };
 var baseMimes = _baseMimes;
 
-// node_modules/hono/dist/middleware/serve-static/index.js
+// ../../node_modules/hono/dist/middleware/serve-static/index.js
 var ENCODINGS = {
   br: ".br",
   zstd: ".zst",
@@ -1734,7 +1735,7 @@ var serveStatic = (options) => {
   };
 };
 
-// node_modules/hono/dist/adapter/bun/serve-static.js
+// ../../node_modules/hono/dist/adapter/bun/serve-static.js
 var serveStatic2 = (options) => {
   return async function serveStatic2(c, next) {
     const getContent = async (path) => {
@@ -1750,8 +1751,7 @@ var serveStatic2 = (options) => {
       try {
         const stats = await stat(path);
         isDir2 = stats.isDirectory();
-      } catch {
-      }
+      } catch {}
       return isDir2;
     };
     return serveStatic({
@@ -1763,7 +1763,7 @@ var serveStatic2 = (options) => {
   };
 };
 
-// node_modules/hono/dist/helper/ssg/middleware.js
+// ../../node_modules/hono/dist/helper/ssg/middleware.js
 var X_HONO_DISABLE_SSG_HEADER_KEY = "x-hono-disable-ssg";
 var SSG_DISABLED_RESPONSE = (() => {
   try {
@@ -1775,10 +1775,10 @@ var SSG_DISABLED_RESPONSE = (() => {
     return null;
   }
 })();
-// node_modules/hono/dist/adapter/bun/ssg.js
+// ../../node_modules/hono/dist/adapter/bun/ssg.js
 var { write } = Bun;
 
-// node_modules/hono/dist/helper/websocket/index.js
+// ../../node_modules/hono/dist/helper/websocket/index.js
 var WSContext = class {
   #init;
   constructor(init) {
@@ -1802,7 +1802,7 @@ var WSContext = class {
   }
 };
 
-// node_modules/hono/dist/http-exception.js
+// ../../node_modules/hono/dist/http-exception.js
 var HTTPException = class extends Error {
   res;
   status;
@@ -1828,6 +1828,9 @@ var HTTPException = class extends Error {
 // src/server.ts
 var IS_PROD = false;
 var CWD = process.cwd();
+function createConfig(config) {
+  return config;
+}
 function createRoute(handler) {
   let _handlers = {};
   if (handler) {
@@ -1952,6 +1955,9 @@ function getRunnableRoute(route) {
 function isRunnableRoute(route) {
   return typeof route === "object" && "run" in route;
 }
+function createLayout(layout) {
+  return layout;
+}
 async function showErrorReponse(context, err) {
   const output = render(html`
     <main>
@@ -1969,7 +1975,6 @@ async function showErrorReponse(context, err) {
 var ROUTE_SEGMENT = /(\[[a-zA-Z_\.]+\])/g;
 async function buildRoutes(config) {
   const routesDir = join(config.appDir, "routes");
-  console.log(routesDir);
   const files = await readdir(routesDir, { recursive: true });
   const routes = [];
   for (const file of files) {
@@ -2096,6 +2101,8 @@ export {
   createRouteFromModule,
   createRoute,
   createReadableStreamFromAsyncGenerator,
+  createLayout,
+  createConfig,
   createAPIRoute,
   buildRoutes,
   StreamResponse,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperspan/framework",
-  "version": "0.1.7",
+  "version": "0.2.0",
   "description": "Hyperspan Web Framework",
   "main": "dist/server.js",
   "types": "src/server.ts",
@@ -53,21 +53,16 @@
     "prepack": "bun run clean && bun run build"
   },
   "devDependencies": {
-    "@types/bun": "^1.1.9",
-    "@types/node": "^22.5.5",
-    "@types/react": "^19.1.0",
-    "bun-plugin-dts": "^0.3.0",
-    "bun-types": "latest",
-    "prettier": "^3.2.5"
-  },
-  "peerDependencies": {
-    "typescript": "^5.0.0"
+    "@types/bun": "^1.2.14",
+    "@types/node": "^22.15.20",
+    "@types/react": "^19.1.5",
+    "prettier": "^3.5.3",
+    "typescript": "^5.8.3"
   },
   "dependencies": {
-    "@hyperspan/html": "^0.1.6",
-    "hono": "^4.7.4",
-    "isbot": "^5.1.25",
-    "preact": "^10.26.5",
-    "zod": "^4.0.0-beta.20250415T232143"
+    "@hyperspan/html": "^0.1.7",
+    "hono": "^4.7.10",
+    "isbot": "^5.1.28",
+    "zod": "^3.25.28"
   }
 }

package/src/actions.test.ts

@@ -1,4 +1,4 @@
-import z from 'zod';
+import z from 'zod/v4';
 import { createAction } from './actions';
 import { describe, it, expect } from 'bun:test';
 import { html, render, type HSHtml } from '@hyperspan/html';

package/src/actions.ts

@@ -1,5 +1,5 @@
 import { html, HSHtml } from '@hyperspan/html';
-import * as z from 'zod';
+import * as z from 'zod/v4';
 import { HTTPException } from 'hono/http-exception';
 
 import type { THSResponseTypes } from './server';

package/src/assets.ts

@@ -89,82 +89,35 @@ export function hyperspanScriptTags() {
   `;
 }
 
-// External ESM = https://esm.sh/preact@10.26.4/compat
-const PREACT_PUBLIC_FILE_PATH = '/_hs/js/preact.js';
-
-function md5(content: string): string {
+export function assetHash(content: string): string {
   return createHash('md5').update(content).digest('hex');
 }
 
 /**
- * Build Preact client JS and copy to public folder
- */
-async function copyPreactToPublicFolder() {
-  const sourceFile = resolve(PWD, '../', './src/clientjs/preact.ts');
-  const preactClient = Bun.build({
-    entrypoints: [sourceFile],
-    outdir: './public/_hs/js',
-    minify: true,
-    format: 'esm',
-    target: 'browser',
-  });
-}
-
-/**
- * Return a Preact component, mounted as an island in a <script> tag so it can be embedded into the page response.
+ * Island defaults
  */
-export async function createPreactIsland(file: string) {
-  let filePath = file.replace('file://', '');
-  const jsId = md5(filePath);
-
-  // Add Preact to client import map if not already present
-  if (!clientImportMap.has('preact')) {
-    await copyPreactToPublicFolder();
-    clientImportMap.set('preact', '' + PREACT_PUBLIC_FILE_PATH);
-    clientImportMap.set('preact/compat', '' + PREACT_PUBLIC_FILE_PATH);
-    clientImportMap.set('preact/hooks', '' + PREACT_PUBLIC_FILE_PATH);
-    clientImportMap.set('preact/jsx-runtime', '' + PREACT_PUBLIC_FILE_PATH);
+export const ISLAND_PUBLIC_PATH = '/_hs/js/islands';
+export const ISLAND_DEFAULTS = () => ({
+  ssr: true,
+});
+
+export function renderIsland(Component: any, props: any, options = ISLAND_DEFAULTS()) {
+  // Render is an OPTIONAL override that allows you to render the island with your own logic
+  if (Component.__HS_ISLAND?.render) {
+    return Component.__HS_ISLAND.render(props, options);
   }
-  if (!clientImportMap.has('react')) {
-    clientImportMap.set('react', '.' + PREACT_PUBLIC_FILE_PATH);
-    clientImportMap.set('react-dom', '.' + PREACT_PUBLIC_FILE_PATH);
-  }
-
-  let resultStr = 'import{h,render}from"preact";';
-  const buildResult = await Bun.build({
-    entrypoints: [filePath],
-    minify: true,
-    external: ['react', 'preact'],
-    // @ts-ignore
-    env: 'APP_PUBLIC_*', // Inlines any ENV that starts with 'APP_PUBLIC_'
-  });
 
-  for (const output of buildResult.outputs) {
-    resultStr += await output.text(); // string
+  // If ssr is true, render the island with the ssr function
+  if (Component.__HS_ISLAND?.ssr && options.ssr) {
+    return Component.__HS_ISLAND.ssr(props);
   }
 
-  // Find default export - this is our component
-  const r = /export\{([a-zA-Z]+) as default\}/g;
-  const matchExport = r.exec(resultStr);
-
-  if (!matchExport) {
-    throw new Error(
-      'File does not have a default export! Ensure a function has export default to use this.'
-    );
+  // If ssr is false, render the island with the clientOnly function
+  if (Component.__HS_ISLAND?.clientOnly) {
+    return Component.__HS_ISLAND.clientOnly(props);
   }
 
-  // Preact render/mount component
-  const fn = matchExport[1];
-  let _mounted = false;
-
-  // Return HTML that will embed this component
-  return (props: any) => {
-    if (!_mounted) {
-      _mounted = true;
-      resultStr += `render(h(${fn}, ${JSON.stringify(props)}), document.getElementById("${jsId}"));`;
-    }
-    return html.raw(
-      `<div id="${jsId}"></div><script type="module" data-source-id="${jsId}">${resultStr}</script>`
-    );
-  };
+  throw new Error(
+    `Module ${Component.name} was not loaded with an island plugin! Did you forget to install an island plugin and add it to the createServer() 'islandPlugins' config?`
+  );
 }

package/src/clientjs/preact.ts

@@ -1,2 +1,3 @@
 export * from 'preact/compat';
-export { h, render } from 'preact';
+export * from 'preact/hooks';
+export { h, render, hydrate } from 'preact';

package/src/server.ts

@@ -15,6 +15,8 @@ const CWD = process.cwd();
  */
 export type THSResponseTypes = HSHtml | Response | string | null;
 export type THSRouteHandler = (context: Context) => THSResponseTypes | Promise<THSResponseTypes>;
+export type THSAPIResponseTypes = Response | Record<any, any> | void;
+export type THSAPIRouteHandler = (context: Context) => THSResponseTypes | Promise<THSResponseTypes>;
 
 export type THSRoute = {
   _kind: 'hsRoute';
@@ -26,6 +28,10 @@ export type THSRoute = {
   run: (method: string, context: Context) => Promise<Response>;
 };
 
+export function createConfig(config: THSServerConfig): THSServerConfig {
+  return config;
+}
+
 /**
  * Define a route that can handle a direct HTTP request.
  * Route handlers should return a HSHtml or Response object
@@ -100,8 +106,8 @@ export function createRoute(handler?: THSRouteHandler): THSRoute {
  * Create new API Route
  * API Route handlers should return a JSON object or a Response
  */
-export function createAPIRoute(handler?: THSRouteHandler): THSRoute {
-  let _handlers: Record<string, THSRouteHandler> = {};
+export function createAPIRoute(handler?: THSAPIRouteHandler): THSRoute {
+  let _handlers: Record<string, THSAPIRouteHandler> = {};
 
   if (handler) {
     _handlers['GET'] = handler;
@@ -109,23 +115,23 @@ export function createAPIRoute(handler?: THSRouteHandler): THSRoute {
 
   const api: THSRoute = {
     _kind: 'hsRoute',
-    get(handler: THSRouteHandler) {
+    get(handler: THSAPIRouteHandler) {
       _handlers['GET'] = handler;
       return api;
     },
-    post(handler: THSRouteHandler) {
+    post(handler: THSAPIRouteHandler) {
       _handlers['POST'] = handler;
       return api;
     },
-    put(handler: THSRouteHandler) {
+    put(handler: THSAPIRouteHandler) {
       _handlers['PUT'] = handler;
       return api;
     },
-    delete(handler: THSRouteHandler) {
+    delete(handler: THSAPIRouteHandler) {
       _handlers['DELETE'] = handler;
       return api;
     },
-    patch(handler: THSRouteHandler) {
+    patch(handler: THSAPIRouteHandler) {
       _handlers['PATCH'] = handler;
       return api;
     },
@@ -202,6 +208,14 @@ export function isRunnableRoute(route: unknown): boolean {
   return typeof route === 'object' && 'run' in route;
 }
 
+/**
+ * Create a layout for a Hyperspan app. Passthrough for now.
+ * Future intent is to be able to conditionally render a layout for full page content vs. partial content.
+ */
+export function createLayout<T>(layout: (props: T) => HSHtml | Promise<HSHtml>) {
+  return layout;
+}
+
 /**
  * Basic error handling
  * @TODO: Should check for and load user-customizeable template with special name (app/__error.ts ?)
@@ -224,6 +238,7 @@ export type THSServerConfig = {
   appDir: string;
   staticFileRoot: string;
   rewrites?: Array<{ source: string; destination: string }>;
+  islandPlugins?: Array<any>; // Loaders for client islands
   // For customizing the routes and adding your own...
   beforeRoutesAdded?: (app: Hono) => void;
   afterRoutesAdded?: (app: Hono) => void;
@@ -242,7 +257,6 @@ const ROUTE_SEGMENT = /(\[[a-zA-Z_\.]+\])/g;
 export async function buildRoutes(config: THSServerConfig): Promise<THSRouteMap[]> {
   // Walk all pages and add them as routes
   const routesDir = join(config.appDir, 'routes');
-  console.log(routesDir);
   const files = await readdir(routesDir, { recursive: true });
   const routes: THSRouteMap[] = [];