@barefootjs/hono 0.1.0

package/dist/client-shim.d.ts

@@ -0,0 +1,59 @@
+/**
+ * SSR shim for `@barefootjs/client` when targeting the Hono adapter.
+ *
+ * The compiler rewrites `@barefootjs/client` imports inside SSR templates to
+ * this module. The shim provides:
+ *
+ *   - `useContext` / `provideContext` bridged to Hono's per-render context
+ *     stack, so context values flow through `<Context.Provider value=...>`
+ *     during SSR. The compiler emits provider IR via `provideContextSSR`.
+ *   - Pure helpers (`createContext`, `splitProps`, `forwardProps`, `unwrap`,
+ *     `__slot`) re-exported from `@barefootjs/client`.
+ *   - Reactive primitives (`createSignal`, `createMemo`, etc.) replaced with
+ *     stubs that throw if called — the compiler is expected to rewrite all
+ *     reachable call sites to plain values during SSR codegen.
+ *   - Portal helpers as no-ops; portals are realized at hydration time.
+ */
+import type { Context as HonoContext } from 'hono/jsx';
+import type { Context } from '@barefootjs/client';
+export { createContext, splitProps, forwardProps, unwrap, __slot, } from '@barefootjs/client';
+export type { Context, Reactive, Signal, Memo, CleanupFn, EffectFn, SlotMarker, Portal, PortalChildren, PortalOptions, Renderable, } from '@barefootjs/client';
+/**
+ * Lazily map a BarefootJS Context object to a Hono context. The mapping is
+ * stable (WeakMap keyed by the Context object itself), so providers and
+ * consumers in the same render see the same Hono context.
+ */
+export declare function getHonoContext<T>(bfCtx: Context<T>): HonoContext<T | undefined>;
+/**
+ * SSR `useContext`: read from Hono's per-render stack, falling back to the
+ * BarefootJS Context's default value, then to `undefined`. Mirrors client
+ * semantics — no provider returns `undefined` rather than throwing.
+ */
+export declare function useContext<T>(bfCtx: Context<T>): T;
+/**
+ * SSR `provideContext`: imperative provider calls inside init code are
+ * unreachable from SSR templates (they live in client JS). At SSR, the
+ * `<Context.Provider value=...>` JSX is compiled to `provideContextSSR`
+ * instead, which uses Hono's stack-scoped Provider.
+ */
+export declare function provideContext<T>(_bfCtx: Context<T>, _value: T): void;
+/**
+ * Compiler-emitted helper for `<Context.Provider value=...>{children}</...>`
+ * at SSR. Wraps children with the bridged Hono Provider so that descendants
+ * resolving the same BarefootJS Context via `useContext` see this value.
+ */
+export declare function provideContextSSR<T>(bfCtx: Context<T>, value: T, children: unknown): unknown;
+export declare function createSignal<T>(_initial?: T): never;
+export declare function createMemo<T>(_fn: () => T): never;
+export declare function createEffect(_fn: () => void): never;
+export declare function createDisposableEffect(_fn: () => void): never;
+export declare function createRoot<T>(_fn: (dispose: () => void) => T): never;
+export declare function onMount(_fn: () => void): void;
+export declare function onCleanup(_fn: () => void): void;
+export declare function untrack<T>(fn: () => T): T;
+export declare function batch<T>(fn: () => T): T;
+export declare function createPortal(_children: unknown, _container?: unknown, _options?: unknown): never;
+export declare function isSSRPortal(_element: unknown): boolean;
+export declare function findSiblingSlot(_el: unknown, _slotSelector: string): null;
+export declare function cleanupPortalPlaceholder(_portalId: string): void;
+//# sourceMappingURL=client-shim.d.ts.map

package/dist/client-shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-shim.d.ts","sourceRoot":"","sources":["../src/client-shim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,UAAU,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EACL,aAAa,EACb,UAAU,EACV,YAAY,EACZ,MAAM,EACN,MAAM,GACP,MAAM,oBAAoB,CAAA;AAE3B,YAAY,EACV,OAAO,EACP,QAAQ,EACR,MAAM,EACN,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,UAAU,EACV,MAAM,EACN,cAAc,EACd,aAAa,EACb,UAAU,GACX,MAAM,oBAAoB,CAAA;AAQ3B;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,GAAG,SAAS,CAAC,CAO/E;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAKlD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAErE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EACjB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,OAAO,GAChB,OAAO,CAGT;AAYD,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,GAAG,KAAK,CAEnD;AACD,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,KAAK,CAEjD;AACD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,IAAI,GAAG,KAAK,CAEnD;AACD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,IAAI,GAAG,KAAK,CAE7D;AACD,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,CAEpE;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,IAAI,GAAG,IAAI,CAE7C;AACD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,IAAI,GAAG,IAAI,CAE/C;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEzC;AACD,wBAAgB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEvC;AAMD,wBAAgB,YAAY,CAC1B,SAAS,EAAE,OAAO,EAClB,UAAU,CAAC,EAAE,OAAO,EACpB,QAAQ,CAAC,EAAE,OAAO,GACjB,KAAK,CAEP;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAEzE;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAEhE"}

package/dist/client-shim.js

@@ -0,0 +1,90 @@
+// src/client-shim.ts
+import { createContext as honoCreateContext, useContext as honoUseContext, jsx } from "hono/jsx";
+import {
+  createContext,
+  splitProps,
+  forwardProps,
+  unwrap,
+  __slot
+} from "@barefootjs/client";
+var honoCtxBridge = new WeakMap;
+function getHonoContext(bfCtx) {
+  let hc = honoCtxBridge.get(bfCtx);
+  if (!hc) {
+    hc = honoCreateContext(bfCtx.defaultValue);
+    honoCtxBridge.set(bfCtx, hc);
+  }
+  return hc;
+}
+function useContext(bfCtx) {
+  const hc = getHonoContext(bfCtx);
+  const v = honoUseContext(hc);
+  if (v !== undefined)
+    return v;
+  return bfCtx.defaultValue;
+}
+function provideContext(_bfCtx, _value) {}
+function provideContextSSR(bfCtx, value, children) {
+  const HonoCtx = getHonoContext(bfCtx);
+  return jsx(HonoCtx.Provider, { value, children });
+}
+function calledAtSSR(name) {
+  throw new Error(`[barefootjs] ${name}() reached SSR. The compiler should have rewritten this call site — please report a bug.`);
+}
+function createSignal(_initial) {
+  return calledAtSSR("createSignal");
+}
+function createMemo(_fn) {
+  return calledAtSSR("createMemo");
+}
+function createEffect(_fn) {
+  return calledAtSSR("createEffect");
+}
+function createDisposableEffect(_fn) {
+  return calledAtSSR("createDisposableEffect");
+}
+function createRoot(_fn) {
+  return calledAtSSR("createRoot");
+}
+function onMount(_fn) {}
+function onCleanup(_fn) {}
+function untrack(fn) {
+  return fn();
+}
+function batch(fn) {
+  return fn();
+}
+function createPortal(_children, _container, _options) {
+  return calledAtSSR("createPortal");
+}
+function isSSRPortal(_element) {
+  return false;
+}
+function findSiblingSlot(_el, _slotSelector) {
+  return null;
+}
+function cleanupPortalPlaceholder(_portalId) {}
+export {
+  useContext,
+  unwrap,
+  untrack,
+  splitProps,
+  provideContextSSR,
+  provideContext,
+  onMount,
+  onCleanup,
+  isSSRPortal,
+  getHonoContext,
+  forwardProps,
+  findSiblingSlot,
+  createSignal,
+  createRoot,
+  createPortal,
+  createMemo,
+  createEffect,
+  createDisposableEffect,
+  createContext,
+  cleanupPortalPlaceholder,
+  batch,
+  __slot
+};

package/dist/dev-worker.d.ts

@@ -0,0 +1,25 @@
+/**
+ * BarefootJS Dev Reloader for Cloudflare Workers / other edge runtimes.
+ *
+ * Unlike `./dev`'s `createDevReloader`, this variant does not watch the local
+ * filesystem — it generates a fresh boot ID on every cold start and relies on
+ * the standard SSE `Last-Event-ID` reconnection protocol to detect restarts:
+ *
+ *   1. First connect       → send `event: hello`, `id: <BOOT_ID>`.
+ *   2. Worker restart      → SSE stream drops, client reconnects with
+ *      `Last-Event-ID: <old BOOT_ID>`.
+ *   3. Server sees mismatch → send `event: reload`, client refreshes.
+ *
+ * Pair with `BfDevReload` from `@barefootjs/hono/dev-reload`.
+ */
+import type { Context } from 'hono';
+export interface CreateDevReloaderOptions {
+    /** Override the dev gate. Defaults to `process.env.NODE_ENV !== 'production'`. */
+    enabled?: boolean;
+}
+/**
+ * Hono route handler that streams Server-Sent Events. Returns 404 in
+ * production (`NODE_ENV=production`) unless `enabled` is set explicitly.
+ */
+export declare function createDevReloader(options?: CreateDevReloaderOptions): (c: Context) => Response | Promise<Response>;
+//# sourceMappingURL=dev-worker.d.ts.map

package/dist/dev-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-worker.d.ts","sourceRoot":"","sources":["../src/dev-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,MAAM,WAAW,wBAAwB;IACvC,kFAAkF;IAClF,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAoBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,wBAA6B,GACrC,CAAC,CAAC,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CA8C9C"}

package/dist/dev-worker.js

@@ -0,0 +1,65 @@
+// src/dev-worker.ts
+var HEARTBEAT_MS = 5000;
+var BOOT_ID = generateBootId();
+function generateBootId() {
+  try {
+    return crypto.randomUUID();
+  } catch {
+    return Date.now().toString(36) + Math.random().toString(36).slice(2, 10);
+  }
+}
+function isDevDefault() {
+  return true;
+}
+function createDevReloader(options = {}) {
+  const { enabled = isDevDefault() } = options;
+  return (c) => {
+    if (!enabled)
+      return c.notFound();
+    const lastEventId = (c.req.header("Last-Event-ID") ?? "").trim();
+    const signal = c.req.raw.signal;
+    const stream = new ReadableStream({
+      start(controller) {
+        const encoder = new TextEncoder;
+        const send = (chunk) => {
+          try {
+            controller.enqueue(encoder.encode(chunk));
+          } catch {}
+        };
+        send(`retry: 1000
+
+`);
+        const event = lastEventId && lastEventId !== BOOT_ID ? "reload" : "hello";
+        send(`event: ${event}
+id: ${BOOT_ID}
+data: ${BOOT_ID}
+
+`);
+        const heartbeat = setInterval(() => send(`: hb
+
+`), HEARTBEAT_MS);
+        const onAbort = () => {
+          clearInterval(heartbeat);
+          try {
+            controller.close();
+          } catch {}
+        };
+        if (signal.aborted)
+          onAbort();
+        else
+          signal.addEventListener("abort", onAbort, { once: true });
+      }
+    });
+    return new Response(stream, {
+      headers: {
+        "Content-Type": "text/event-stream",
+        "Cache-Control": "no-cache, no-transform",
+        Connection: "keep-alive",
+        "X-Accel-Buffering": "no"
+      }
+    });
+  };
+}
+export {
+  createDevReloader
+};

package/dist/dev.d.ts

@@ -0,0 +1,36 @@
+/**
+ * BarefootJS Dev Reloader (Hono, Node-side)
+ *
+ * `createDevReloader` turns `bf build --watch`'s sentinel file
+ * (`<distDir>/.dev/build-id`) into an SSE stream:
+ *
+ *   [bf build --watch] → writes `<distDir>/.dev/build-id` after each successful build
+ *   [createDevReloader]      → watches that file, streams SSE `event: reload`
+ *
+ * Mount it on a Hono route in the generated app; the matching browser-
+ * side subscriber (`<DevReload />`) lives in the project itself (see
+ * the hono-node scaffold's `dev-reload.tsx`) so its endpoint URL and
+ * reconnect behavior are an in-tree edit.
+ *
+ * ```ts
+ * // factory.ts
+ * import { createDevReloader } from '@barefootjs/hono/dev'
+ * app.get('/_bf/reload', createDevReloader({ distDir: './dist' }))
+ * ```
+ *
+ * Disabled (404) when `NODE_ENV === 'production'` unless `enabled: true`
+ * is passed explicitly.
+ */
+import type { Context } from 'hono';
+export interface CreateDevReloaderOptions {
+    /** Directory that `bf build` writes output into (contains `.dev/build-id`). */
+    distDir: string;
+    /** Override the dev gate. Defaults to `process.env.NODE_ENV !== 'production'`. */
+    enabled?: boolean;
+}
+/**
+ * Hono route handler that streams Server-Sent Events and emits `reload` every
+ * time `<distDir>/.dev/build-id` is written. Disabled (404) in production.
+ */
+export declare function createDevReloader(options: CreateDevReloaderOptions): (c: Context) => Response | Promise<Response>;
+//# sourceMappingURL=dev.d.ts.map

package/dist/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../src/dev.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAInC,MAAM,WAAW,wBAAwB;IACvC,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAA;IACf,kFAAkF;IAClF,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAmBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,CAAC,CAAC,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsF9C"}