@sigil-dev/grimoire 0.3.0

package/.grimoire/_routes.dom.js

@@ -0,0 +1,4 @@
+
+export const routes = {
+
+};

package/.grimoire/_routes.hydrate.js

@@ -0,0 +1,4 @@
+
+export const routes = {
+
+};

package/.grimoire/_routes.ts

@@ -0,0 +1,4 @@
+
+export const routes: Record<string, (props: any) => any> = {
+
+};

package/.grimoire/tsconfig.generated.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "rootDirs": [
+      "..",
+      "./types"
+    ]
+  },
+  "include": [
+    "types/**/*.d.ts"
+  ]
+}

package/.grimoire/types/ambient.d.ts

@@ -0,0 +1,6 @@
+// Auto-generated by @sigil-dev/grimoire — do not edit
+
+declare namespace App {
+  // Extend this interface in your app's src/app.d.ts to add typed locals
+  interface Locals extends Record<string, unknown> {}
+}

package/.grimoire/types/api/hello/$types.d.ts

@@ -0,0 +1,29 @@
+// Auto-generated by @sigil-dev/grimoire — do not edit
+
+export type Params = {};
+
+export type PageData = Record<string, never>;
+export type PageProps = { params: Params };
+export type PageServerLoad = never;
+export type Actions = Record<string, never>;
+
+export type LayoutData = Record<string, never>;
+export type LayoutProps = LayoutData & { params: Params; children?: unknown };
+export type LayoutServerLoad = (ctx: {
+  params: Params;
+  request: Request;
+  url: URL;
+  locals: App.Locals;
+}) => Record<string, unknown> | Promise<Record<string, unknown>>;
+
+type _SRV = typeof import("C:/Users/Cane1712/AppData/Local/Temp/grimoire-server-1780500535824/api/hello/+server.js");
+type _HttpMethods = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+type _ServerKeys = Extract<keyof _SRV, _HttpMethods>;
+export type ServerHandlers = {
+  [K in _ServerKeys]: (ctx: {
+    params: Params;
+    request: Request;
+    url: URL;
+    locals: App.Locals;
+  }) => Response | Promise<Response>;
+};

package/README.md

@@ -0,0 +1 @@
+Grimoire Implementation

package/index.ts

@@ -0,0 +1,22 @@
+export type { RouteFile, RouteTree } from "./src/scanner";
+export { scanRoutes } from "./src/scanner";
+export { createServer } from "./src/server";
+export { fail, isFailResult } from "./src/fail";
+export type { FailResult } from "./src/fail";
+export { redirect, isRedirectResult } from "./src/redirect";
+export type { RedirectResult } from "./src/redirect";
+export { error, isErrorResult } from "./src/error";
+export type { ErrorResult } from "./src/error";
+export type { Handle, RequestEvent, Cookies, CookieOptions, ResolveFunction } from "./src/hooks";
+export { sequence, createHooks } from "./src/hooks";
+export type { TypegenConfig } from "./src/typegen";
+export { generateTypes } from "./src/typegen";
+export type {
+	GrimoireConfig,
+	GrimoirePlugin,
+	LoadContext,
+	RenderContext,
+	RouteInfo,
+	TypedLoadContext,
+} from "./src/types";
+export { defineConfig } from "./src/types";

package/package.json

@@ -0,0 +1,36 @@
+{
+	"name": "@sigil-dev/grimoire",
+	"module": "index.ts",
+	"type": "module",
+	"private": false,
+	"version": "0.3.0",
+	"devDependencies": {
+		"@types/bun": "latest"
+	},
+	"exports": {
+		".": "./index.ts",
+		"./client": "./src/enhance.ts",
+		"./headers": "./src/headers.ts",
+		"./hooks": "./src/hooks.ts",
+		"./vite": "./src/vite-plugin.ts"
+	},
+	"bin": {
+		"grimoire": "src/sync.ts"
+	},
+	"scripts": {
+		"sync": "bun src/sync.ts",
+		"test": "bun test"
+	},
+	"dependencies": {
+		"@babel/core": "^8.0.0-rc.6",
+		"@babel/plugin-syntax-jsx": "^8.0.0-rc.6",
+		"@babel/plugin-syntax-typescript": "^8.0.0-rc.6",
+		"@babel/types": "^8.0.0-rc.6",
+		"@sigil-dev/compiler": "0.3.0",
+		"@sigil-dev/runtime": "0.3.0",
+		"vite": "^8.0.16"
+	},
+	"peerDependencies": {
+		"typescript": "^5"
+	}
+}

package/public/__grimoire__/client.js

@@ -0,0 +1,86 @@
+// .grimoire/_routes.dom.js
+var routes = {};
+
+// src/scope.ts
+function withEffectScope(fn) {
+  const prev = globalThis.__sigilEffectScope;
+  const disposers = [];
+  globalThis.__sigilEffectScope = disposers;
+  try {
+    fn();
+  } finally {
+    globalThis.__sigilEffectScope = prev;
+  }
+  return () => {
+    for (const d of disposers)
+      d();
+    disposers.length = 0;
+  };
+}
+
+// src/client-router.ts
+var routeMap = {};
+var disposeCurrentPage = null;
+async function navigate(path) {
+  const res = await fetch(path, { headers: { "x-grimoire-navigate": "1" } });
+  const json = await res.json();
+  const { data, params, pattern, head } = json;
+  const Page = routeMap[pattern];
+  if (!Page) {
+    window.location.href = path;
+    return;
+  }
+  disposeCurrentPage?.();
+  disposeCurrentPage = null;
+  globalThis.__nodes = [];
+  let node;
+  disposeCurrentPage = withEffectScope(() => {
+    node = Page({ ...data, params });
+  });
+  const slot = document.getElementById("grimoire-page");
+  if (!slot)
+    return;
+  slot.replaceChildren(node);
+  updateHead(head);
+  history.pushState({}, "", path);
+  currentPath = path;
+  window.scrollTo(0, 0);
+}
+var currentPath = location.pathname;
+function initRouter(routes2, initialDispose) {
+  routeMap = routes2;
+  disposeCurrentPage = initialDispose ?? null;
+  document.addEventListener("click", handleClick);
+  window.addEventListener("popstate", () => {
+    if (location.pathname !== currentPath) {
+      currentPath = location.pathname;
+      navigate(location.pathname);
+    }
+  });
+}
+function updateHead(headHtml) {
+  document.querySelectorAll("[data-grimoire-head]").forEach((el) => el.remove());
+  if (!headHtml)
+    return;
+  const tmp = document.createElement("head");
+  tmp.innerHTML = headHtml;
+  for (const el of Array.from(tmp.children)) {
+    el.dataset.grimoireHead = "1";
+    document.head.appendChild(el);
+  }
+}
+function handleClick(e) {
+  const a = e.target.closest("a");
+  if (!a)
+    return;
+  const href = a.getAttribute("href");
+  if (!href)
+    return;
+  if (/^(https?:\/\/|\/\/|#|mailto:|tel:)/.test(href))
+    return;
+  e.preventDefault();
+  navigate(href);
+}
+
+// src/client.ts
+initRouter(routes);

package/public/__grimoire__/hydrate.js

@@ -0,0 +1,101 @@
+// .grimoire/_routes.hydrate.js
+var routes = {};
+
+// src/scope.ts
+function withEffectScope(fn) {
+  const prev = globalThis.__sigilEffectScope;
+  const disposers = [];
+  globalThis.__sigilEffectScope = disposers;
+  try {
+    fn();
+  } finally {
+    globalThis.__sigilEffectScope = prev;
+  }
+  return () => {
+    for (const d of disposers)
+      d();
+    disposers.length = 0;
+  };
+}
+
+// src/client-router.ts
+var routeMap = {};
+var disposeCurrentPage = null;
+async function navigate(path) {
+  const res = await fetch(path, { headers: { "x-grimoire-navigate": "1" } });
+  const json = await res.json();
+  const { data, params, pattern, head } = json;
+  const Page = routeMap[pattern];
+  if (!Page) {
+    window.location.href = path;
+    return;
+  }
+  disposeCurrentPage?.();
+  disposeCurrentPage = null;
+  globalThis.__nodes = [];
+  let node;
+  disposeCurrentPage = withEffectScope(() => {
+    node = Page({ ...data, params });
+  });
+  const slot = document.getElementById("grimoire-page");
+  if (!slot)
+    return;
+  slot.replaceChildren(node);
+  updateHead(head);
+  history.pushState({}, "", path);
+  currentPath = path;
+  window.scrollTo(0, 0);
+}
+var currentPath = location.pathname;
+function initRouter(routes2, initialDispose) {
+  routeMap = routes2;
+  disposeCurrentPage = initialDispose ?? null;
+  document.addEventListener("click", handleClick);
+  window.addEventListener("popstate", () => {
+    if (location.pathname !== currentPath) {
+      currentPath = location.pathname;
+      navigate(location.pathname);
+    }
+  });
+}
+function updateHead(headHtml) {
+  document.querySelectorAll("[data-grimoire-head]").forEach((el) => el.remove());
+  if (!headHtml)
+    return;
+  const tmp = document.createElement("head");
+  tmp.innerHTML = headHtml;
+  for (const el of Array.from(tmp.children)) {
+    el.dataset.grimoireHead = "1";
+    document.head.appendChild(el);
+  }
+}
+function handleClick(e) {
+  const a = e.target.closest("a");
+  if (!a)
+    return;
+  const href = a.getAttribute("href");
+  if (!href)
+    return;
+  if (/^(https?:\/\/|\/\/|#|mailto:|tel:)/.test(href))
+    return;
+  e.preventDefault();
+  navigate(href);
+}
+
+// src/hydrate.ts
+var stateEl = document.getElementById("__grimoire_state__");
+var initialDispose;
+if (stateEl) {
+  const state = JSON.parse(stateEl.textContent);
+  const Page = routes[state.pattern];
+  if (Page) {
+    const slot = document.getElementById("grimoire-page");
+    if (slot) {
+      globalThis.__nodes = Array.from(slot.childNodes);
+      initialDispose = withEffectScope(() => {
+        Page({ ...state.data, params: state.params });
+      });
+    }
+  }
+}
+initRouter(routes, initialDispose);

package/src/client-router.ts

@@ -0,0 +1,77 @@
+import { withEffectScope } from "./scope.ts";
+
+let routeMap: Record<string, (props: any) => any> = {};
+let disposeCurrentPage: (() => void) | null = null;
+
+async function navigate(path: string) {
+	const res = await fetch(path, { headers: { "x-grimoire-navigate": "1" } });
+	const json = await res.json();
+	const { data, params, pattern, head } = json;
+
+	const Page = routeMap[pattern];
+	if (!Page) {
+		window.location.href = path;
+		return;
+	}
+
+	// Tear down all effects from the previous page before mounting the next one.
+	disposeCurrentPage?.();
+	disposeCurrentPage = null;
+
+	// SPA navigation has no SSR nodes to claim — start with an empty pool so
+	// the hydrate-compiled components create fresh DOM instead of recycling stale nodes.
+	(globalThis as any).__nodes = [];
+
+	let node: any;
+	disposeCurrentPage = withEffectScope(() => {
+		node = Page({ ...data, params });
+	});
+
+	const slot = document.getElementById("grimoire-page");
+	if (!slot) return;
+	slot.replaceChildren(node);
+	updateHead(head);
+	history.pushState({}, "", path);
+	currentPath = path;
+	window.scrollTo(0, 0);
+}
+
+let currentPath = location.pathname;
+
+export function initRouter(
+	routes: Record<string, (props: any) => any>,
+	initialDispose?: () => void,
+) {
+	routeMap = routes;
+	disposeCurrentPage = initialDispose ?? null;
+	document.addEventListener("click", handleClick);
+	window.addEventListener("popstate", () => {
+		if (location.pathname !== currentPath) {
+			currentPath = location.pathname;
+			navigate(location.pathname);
+		}
+	});
+}
+
+function updateHead(headHtml: string) {
+	document
+		.querySelectorAll("[data-grimoire-head]")
+		.forEach((el) => el.remove());
+	if (!headHtml) return;
+	const tmp = document.createElement("head");
+	tmp.innerHTML = headHtml;
+	for (const el of Array.from(tmp.children)) {
+		(el as HTMLElement).dataset.grimoireHead = "1";
+		document.head.appendChild(el);
+	}
+}
+
+function handleClick(e: MouseEvent) {
+	const a = (e.target as Element).closest("a");
+	if (!a) return;
+	const href = a.getAttribute("href");
+	if (!href) return;
+	if (/^(https?:\/\/|\/\/|#|mailto:|tel:)/.test(href)) return;
+	e.preventDefault();
+	navigate(href);
+}

package/src/client.ts

@@ -0,0 +1,4 @@
+import { routes } from "#grimoire-routes";
+import { initRouter } from "./client-router.ts";
+
+initRouter(routes);

package/src/context.ts

@@ -0,0 +1,10 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { __setStoreProvider } from "@sigil-dev/runtime";
+
+const storage = new AsyncLocalStorage<Map<symbol, unknown>>();
+
+__setStoreProvider(() => storage.getStore() ?? new Map());
+
+export function runWithContext<T>(fn: () => Promise<T>): Promise<T> {
+	return storage.run(new Map(), fn);
+}

package/src/cookie-utils.ts

@@ -0,0 +1,66 @@
+/**
+ * Parse cookies from a Cookie header string.
+ */
+export function parseCookies(cookieHeader: string): Map<string, string> {
+	const map = new Map<string, string>();
+	if (!cookieHeader) return map;
+	for (const pair of cookieHeader.split(";")) {
+		const [name, ...rest] = pair.split("=");
+		if (name) map.set(name.trim(), rest.join("=").trim());
+	}
+	return map;
+}
+
+/**
+ * Build a Set-Cookie header from name, value, and options.
+ */
+export function serializeCookie(
+	name: string,
+	value: string,
+	options?: {
+		path?: string;
+		domain?: string;
+		maxAge?: number;
+		expires?: Date;
+		httpOnly?: boolean;
+		secure?: boolean;
+		sameSite?: "strict" | "lax" | "none";
+	},
+): string {
+	let cookie = `${name}=${encodeURIComponent(value)}`;
+	if (options?.path) cookie += `; Path=${options.path}`;
+	if (options?.domain) cookie += `; Domain=${options.domain}`;
+	if (options?.maxAge != null) cookie += `; Max-Age=${options.maxAge}`;
+	if (options?.expires) cookie += `; Expires=${options.expires.toUTCString()}`;
+	if (options?.httpOnly) cookie += "; HttpOnly";
+	if (options?.secure) cookie += "; Secure";
+	if (options?.sameSite) cookie += `; SameSite=${options.sameSite}`;
+	return cookie;
+}
+
+/**
+ * Create a Cookies helper from a Cookie header string.
+ */
+export function createCookies(
+	cookieHeader: string,
+): import("./hooks").Cookies & { toHeaders(): string[] } {
+	const store = parseCookies(cookieHeader);
+	const pending: string[] = [];
+
+	return {
+		get(name: string) {
+			return store.get(name);
+		},
+		set(name: string, value: string, options?: any) {
+			store.set(name, value);
+			pending.push(serializeCookie(name, value, options));
+		},
+		delete(name: string) {
+			store.delete(name);
+			pending.push(serializeCookie(name, "", { maxAge: 0 }));
+		},
+		toHeaders() {
+			return pending;
+		},
+	};
+}

package/src/enhance.ts

@@ -0,0 +1,97 @@
+/**
+ * Client-side form action handler.
+ * Wraps form submission with fetch, handles fail() responses, and updates state.
+ *
+ * Usage in +page.tsx:
+ *
+ *   import { enhance } from "@sigil-dev/grimoire/client";
+ *   import { createSignal } from "@sigil-dev/runtime";
+ *
+ *   const [errors, setErrors] = createSignal({});
+ *
+ *   <form use:enhance={{ action: "/api/login", onSuccess: () => { ... }, onFail: (data) => setErrors(data) }}>
+ *     ...
+ *   </form>
+ */
+export interface EnhanceOptions {
+	/** URL to submit to (defaults to form's action) */
+	action?: string;
+	/** Called on successful submission (303 redirect) */
+	onSuccess?: (result: { redirect: string }) => void;
+	/** Called when server returns fail() with validation data */
+	onFail?: (data: Record<string, unknown>) => void;
+	/** Called on network or unexpected errors */
+	onError?: (error: Error) => void;
+	/** Whether to reset the form on success (default: true) */
+	reset?: boolean;
+}
+
+/**
+ * use:enhance directive for progressive form enhancement.
+ * Attaches to a <form> element and intercepts submit events.
+ *
+ * Returns a cleanup function.
+ */
+export function enhance(
+	form: HTMLFormElement,
+	options: EnhanceOptions = {},
+): () => void {
+	const { action, onSuccess, onFail, onError, reset = true } = options;
+
+	async function handleSubmit(e: Event) {
+		e.preventDefault();
+
+		const formData = new FormData(form);
+		const url = action ?? form.getAttribute("action") ?? window.location.pathname;
+
+		try {
+			const res = await fetch(url, {
+				method: "POST",
+				headers: {
+					"X-Grimoire-Form": "1",
+				},
+				body: formData,
+			});
+
+			const contentType = res.headers.get("content-type") ?? "";
+
+			if (contentType.includes("application/json")) {
+				const json = await res.json();
+
+				if (json.fail) {
+					// fail() response — validation errors
+					onFail?.(json.data);
+					return;
+				}
+
+				// Regular JSON response (API route)
+				onSuccess?.(json);
+				return;
+			}
+
+			// Non-JSON response (303 redirect or other)
+			if (res.status === 303) {
+				const location = res.headers.get("location") ?? "/";
+				if (reset) form.reset();
+				onSuccess?.({ redirect: location });
+				// Navigate to the redirect target
+				window.history.pushState({}, "", location);
+				window.dispatchEvent(new PopStateEvent("popstate"));
+				return;
+			}
+
+			// Other response
+			if (res.ok) {
+				if (reset) form.reset();
+				onSuccess?.({ redirect: window.location.pathname });
+			} else {
+				onError?.(new Error(`Form submission failed: ${res.status}`));
+			}
+		} catch (err) {
+			onError?.(err instanceof Error ? err : new Error(String(err)));
+		}
+	}
+
+	form.addEventListener("submit", handleSubmit);
+	return () => form.removeEventListener("submit", handleSubmit);
+}

package/src/error.ts

@@ -0,0 +1,52 @@
+/**
+ * Throw an error from a load function or form action.
+ * The server catches it and returns an error response.
+ *
+ * Usage in +page.server.ts:
+ *
+ *   import { error } from "@sigil-dev/grimoire";
+ *
+ *   export async function load({ params }) {
+ *     const item = await db.find(params.id);
+ *     if (!item) throw error(404, "Not found");
+ *     return { item };
+ *   }
+ *
+ *   export async function POST({ request }) {
+ *     const session = await getSession(request);
+ *     if (!session) throw error(401, "Unauthorized");
+ *     // ...
+ *   }
+ *
+ * The server:
+ *   - Returns JSON { error: true, status, message } for API requests
+ *   - Renders +error.tsx page if one exists for the route
+ *   - Falls back to a plain text error response
+ */
+export interface ErrorResult {
+	__error: true;
+	status: number;
+	message: string;
+}
+
+export function error(status: number, message: string): never;
+export function error(status: number, data: Record<string, unknown>): never;
+export function error(
+	status: number,
+	messageOrData: string | Record<string, unknown>,
+): never {
+	const message =
+		typeof messageOrData === "string"
+			? messageOrData
+			: JSON.stringify(messageOrData);
+
+	throw { __error: true, status, message } as ErrorResult;
+}
+
+export function isErrorResult(value: unknown): value is ErrorResult {
+	return (
+		typeof value === "object" &&
+		value !== null &&
+		(value as any).__error === true
+	);
+}

package/src/fail.ts

@@ -0,0 +1,41 @@
+/**
+ * Return validation errors from a server form action.
+ * Instead of redirecting, the server sends a JSON response with the error data.
+ *
+ * Usage in +page.server.ts:
+ *
+ *   import { fail } from "@sigil-dev/grimoire";
+ *
+ *   export async function POST({ request }) {
+ *     const form = await request.formData();
+ *     const name = form.get("name")?.toString() ?? "";
+ *
+ *     if (!name) {
+ *       return fail(400, { name, errors: { name: "Name is required" } });
+ *     }
+ *
+ *     // success — redirect
+ *     return { redirect: "/dashboard" };
+ *   }
+ */
+export function fail<T extends Record<string, unknown>>(
+	status: number,
+	data: T,
+): FailResult<T> {
+	return { __fail: true as const, status, data };
+}
+
+export interface FailResult<T = Record<string, unknown>> {
+	__fail: true;
+	status: number;
+	data: T;
+}
+
+export function isFailResult(value: unknown): value is FailResult {
+	return (
+		typeof value === "object" &&
+		value !== null &&
+		 "__fail" in value &&
+		(value as any).__fail === true
+	);
+}