@humjs/core 0.0.0-stage → 0.0.2

package/README.md

@@ -1,3 +1,6 @@
-# Temporary Holding Version
+# @humjs/core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Hum's core framework package for server-rendered Preact applications.
+
+Documentation, source code, and issue tracking are available in the
+[Hum repository](https://github.com/oaly2000/hum).

package/dist/app.d.ts

@@ -0,0 +1,40 @@
+import { type Env, Hono, type Schema } from "hono";
+import { BuildCache, type ProdManifest } from "./build_cache.js";
+import { type HumConfig, type ResolvedConfig } from "./config.js";
+import { ModuleLoader } from "./loader.js";
+import { type ResolvedNotFound, type ResolvedRoute } from "./routing/fs_routes.js";
+import type { HumManifest } from "./types.js";
+export interface HumVariables {
+    /** The route Hum matched for this request. */
+    humRoute?: ResolvedRoute;
+    [key: string]: unknown;
+}
+export type HumApp = Hono<{
+    Variables: HumVariables;
+}> & {
+    hum: HumInternals;
+};
+export type MountedHumApp<E extends Env, S extends Schema, P extends string> = Hono<E, S, P> & {
+    hum: HumInternals;
+};
+export interface HumInternals {
+    config: ResolvedConfig;
+    manifest: HumManifest;
+    prodManifest: ProdManifest | null;
+    buildCache: BuildCache;
+    loader: ModuleLoader;
+    routes: ResolvedRoute[];
+    notFound: ResolvedNotFound[];
+    /** Reloads island and route modules. No-op in production. */
+    refresh(): Promise<void>;
+}
+/**
+ * Mounts Hum's file routes, static assets, 404 handling, and runtime state onto
+ * an existing Hono application.
+ *
+ * Application middleware registered before this call also wraps Hum routes.
+ */
+export declare function mountHum<E extends Env, S extends Schema, P extends string>(app: Hono<E, S, P>, config: HumConfig): Promise<MountedHumApp<E, S, P>>;
+/** Creates a standalone Hono app with Hum mounted on it. */
+export declare function createApp(config: HumConfig): Promise<HumApp>;
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,GAAG,EAAE,IAAI,EAA0B,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AAG3E,OAAO,EACL,UAAU,EAEV,KAAK,YAAY,EAElB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,KAAK,SAAS,EAEd,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAa3C,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAGnB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAEV,WAAW,EAIZ,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC;IAAE,SAAS,EAAE,YAAY,CAAA;CAAE,CAAC,GAAG;IAAE,GAAG,EAAE,YAAY,CAAA;CAAE,CAAC;AAC/E,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IACvE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GACb;IAAE,GAAG,EAAE,YAAY,CAAA;CAAE,CAAC;AAE1B,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,WAAW,CAAC;IACtB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,6DAA6D;IAC7D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAkFD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,CAAC,SAAS,GAAG,EACb,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,EAEhB,GAAG,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAClB,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAwGjC;AAED,4DAA4D;AAC5D,wBAAsB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAGlE"}

package/dist/app.js

@@ -0,0 +1,230 @@
+import { pathToFileURL } from "node:url";
+import { Hono } from "hono";
+import { BuildCache, manifestPath, readProdManifest, } from "./build_cache.js";
+import { defaultLogger, resolveConfig, } from "./config.js";
+import { crawlProject } from "./discovery/fs_crawl.js";
+import { ModuleLoader } from "./loader.js";
+import { runWithRequestContext, } from "./request_context.js";
+import { findNotFound, renderError, renderNotFound, renderRoute, } from "./render.js";
+import { dirOf, resolveRoutes, unmatchedRoute, } from "./routing/fs_routes.js";
+import { staticAssetHandler } from "./static.js";
+function htmlResponse(c, outcome) {
+    if (outcome.links.length > 0) {
+        c.header("Link", outcome.links.map((url) => `<${url}>; rel=modulepreload`).join(", "));
+    }
+    if (typeof outcome.body === "string") {
+        return c.html(outcome.body, outcome.status);
+    }
+    return c.body(outcome.body, outcome.status, { "Content-Type": "text/html; charset=UTF-8" });
+}
+function pickHandler(handlers, method) {
+    if (handlers === undefined)
+        return undefined;
+    if (method === "HEAD" && handlers.HEAD === undefined) {
+        return handlers.GET;
+    }
+    const byMethod = handlers;
+    return byMethod[method];
+}
+/**
+ * Runs the middleware a route module exports. Mirrors Hono's semantics:
+ * returning a `Response` short circuits, and a middleware that never calls
+ * `next()` continues the chain so that simple middlewares stay ergonomic.
+ */
+async function runRouteMiddleware(list, c, terminal) {
+    const dispatch = async (index) => {
+        if (index >= list.length)
+            return await terminal();
+        const fn = list[index];
+        let downstream;
+        let called = false;
+        const next = async () => {
+            if (called)
+                throw new Error("next() called multiple times");
+            called = true;
+            downstream = await dispatch(index + 1);
+        };
+        const result = await fn(c, next);
+        if (result instanceof Response) {
+            c.res = result;
+            return result;
+        }
+        if (called && downstream !== undefined)
+            return downstream;
+        return await dispatch(index + 1);
+    };
+    return await dispatch(0);
+}
+function middlewareArray(middleware) {
+    if (middleware === undefined)
+        return [];
+    return Array.isArray(middleware) ? middleware : [middleware];
+}
+/**
+ * Mounts Hum's file routes, static assets, 404 handling, and runtime state onto
+ * an existing Hono application.
+ *
+ * Application middleware registered before this call also wraps Hum routes.
+ */
+export async function mountHum(app, config) {
+    const manifest = config.manifest ??
+        await crawlToManifest(config);
+    const root = config.root ?? process.cwd();
+    const outDir = config.outDir ?? "_hum";
+    const prodManifest = await readProdManifest(manifestPath(root, outDir));
+    const dev = config.dev ?? prodManifest === null;
+    const resolved = resolveConfig({
+        ...config,
+        dev,
+        // The manifest knows the URL the build is served from, which is what keeps
+        // the client asset URLs stable when the output directory is renamed.
+        assetsBase: config.assetsBase ?? prodManifest?.assetsBase,
+    }, manifest);
+    const buildCache = new BuildCache(dev);
+    await buildCache.load(manifest, prodManifest, resolved.logger);
+    const { routes, notFound } = resolveRoutes(manifest.routes, resolved.routesDir);
+    const loader = new ModuleLoader(dev);
+    if (!resolved.dev && prodManifest === null) {
+        resolved.logger.error(`hum: no build manifest found at ${manifestPath(root, outDir)}. ` +
+            `Client islands and styles cannot be served; run the production ` +
+            `build, or point \`outDir\` at the deployed output directory.`);
+    }
+    // Serve the production build output. In dev Vite handles these requests
+    // before the Hum handler, so this branch stays inert.
+    app.use(`${resolved.assetsBase}/*`, staticAssetHandler(resolved));
+    const internals = {
+        config: resolved,
+        manifest,
+        prodManifest,
+        buildCache,
+        loader,
+        routes,
+        notFound,
+        async refresh() {
+            if (!resolved.dev)
+                return;
+            await buildCache.load(manifest, prodManifest, resolved.logger);
+        },
+    };
+    // Hono's variadic `HandlerInterface` overloads cannot be satisfied by a
+    // dynamically built middleware chain, so registration goes through a
+    // narrow, explicitly typed funnel. The handlers themselves stay typed.
+    const register = app.all.bind(app);
+    for (const route of routes) {
+        const chain = routeHandler(route, internals, notFound);
+        for (const pattern of route.honoPatterns) {
+            register(pattern, chain);
+        }
+    }
+    app.notFound(async (c) => {
+        const url = new URL(c.req.url);
+        const found = findNotFound(notFound, url.pathname);
+        const dir = found === undefined
+            ? ""
+            : dirOf(found.file.file, resolved.routesDir);
+        const input = {
+            config: resolved,
+            buildCache,
+            loader,
+            route: unmatchedRoute(manifest.routes, resolved.routesDir, dir, url.pathname),
+            url,
+            params: {},
+            state: c.var,
+            notFound,
+        };
+        try {
+            await internals.refresh();
+            return htmlResponse(c, await renderNotFound(input, url.pathname));
+        }
+        catch (err) {
+            return htmlResponse(c, await renderError(input, err));
+        }
+    });
+    return Object.assign(app, { hum: internals });
+}
+/** Creates a standalone Hono app with Hum mounted on it. */
+export async function createApp(config) {
+    const app = new Hono();
+    return await mountHum(app, config);
+}
+function routeHandler(route, internals, notFound) {
+    return async (c) => {
+        const url = new URL(c.req.url);
+        const method = c.req.method.toUpperCase();
+        const params = c.req.param();
+        const context = c;
+        context.set("humRoute", route);
+        const input = {
+            config: internals.config,
+            buildCache: internals.buildCache,
+            loader: internals.loader,
+            route,
+            url,
+            params,
+            state: c.var,
+            notFound,
+        };
+        try {
+            await internals.refresh();
+            const mod = (await internals.loader.load(route.file));
+            const routeMiddleware = [];
+            for (const spec of route.middlewares) {
+                const middlewareModule = await internals.loader.load(spec);
+                const middleware = (middlewareModule.default ??
+                    middlewareModule.middleware);
+                if (typeof middleware !== "function") {
+                    internals.config.logger.warn(`hum: ${spec.file} does not export a middleware as its default ` +
+                        `export. Skipping it.`);
+                    continue;
+                }
+                routeMiddleware.push(middleware);
+            }
+            routeMiddleware.push(...middlewareArray(mod.middleware));
+            const terminal = async () => {
+                const handler = pickHandler(mod.handlers, method);
+                if (handler !== undefined) {
+                    const requestContext = {
+                        page: async (data, options) => htmlResponse(context, await renderRoute(input, data, options)),
+                    };
+                    const res = await runWithRequestContext(requestContext, () => handler(context));
+                    if (res instanceof Response)
+                        return res;
+                }
+                else if (mod.handlers !== undefined && method !== "GET" && method !== "HEAD") {
+                    return context.text("Method Not Allowed", 405);
+                }
+                return htmlResponse(context, await renderRoute(input));
+            };
+            return await runRouteMiddleware(routeMiddleware, context, terminal);
+        }
+        catch (err) {
+            if (route.error === undefined) {
+                internals.config.logger.error(`hum: unhandled error while handling ${context.req.method} ${url.pathname}`, err);
+            }
+            return htmlResponse(context, await renderError(input, err));
+        }
+    };
+}
+/** Fallback discovery used when the bundler did not supply a manifest. */
+async function crawlToManifest(config) {
+    const root = config.root ?? process.cwd();
+    const crawled = await crawlProject({
+        root,
+        routesDir: config.routesDir,
+        islandsDir: config.islandsDir,
+        logger: config.logger,
+    });
+    return {
+        routes: crawled.routes.map((spec) => ({
+            ...spec,
+            // The path is only known at runtime; Vite must not try to resolve it.
+            load: () => import(/* @vite-ignore */ pathToFileURL(spec.absPath).href),
+        })),
+        islands: crawled.islands.map((spec) => ({
+            ...spec,
+            // The path is only known at runtime; Vite must not try to resolve it.
+            load: () => import(/* @vite-ignore */ pathToFileURL(spec.absPath).href),
+        })),
+    };
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"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"}

package/dist/build_cache.d.ts

@@ -0,0 +1,56 @@
+import type { HumManifest, Island, Logger } from "./types.js";
+/** URL the dev server serves the client runtime from. */
+export declare const CLIENT_ENTRY_DEV = "/_hum/runtime.js";
+/** Name of the manifest the production build writes into the out dir. */
+export declare const MANIFEST_FILE = "manifest.json";
+export interface ProdIslandEntry {
+    /** Island chunk path, relative to the output directory. */
+    file: string;
+    /** Island stylesheet paths, relative to the output directory. */
+    css?: string[];
+}
+export interface ProdManifest {
+    buildId: string;
+    /**
+     * URL the output directory is served from, e.g. `/_hum`. The assets are
+     * addressed through it, while the directory itself is located next to the
+     * server bundle, so the built app keeps working when the output directory is
+     * renamed or moved on the deploy machine.
+     */
+    assetsBase: string;
+    /** Client runtime chunk path, relative to the output directory. */
+    clientEntry: string;
+    islands: Record<string, ProdIslandEntry>;
+    /** Client entry stylesheet paths, relative to the output directory. */
+    entryAssets?: string[];
+}
+export declare function manifestPath(root: string, outDir: string): string;
+/** Reads the production manifest, or `null` when the app runs in dev. */
+export declare function readProdManifest(path: string): Promise<ProdManifest | null>;
+/**
+ * Maps island components to their client side module URLs, and keeps the
+ * bookkeeping the renderer needs (`islandRegistry`, entry assets, build id).
+ *
+ * Island modules are loaded through the bundler supplied thunks, so the same
+ * cache implementation works for the Vite dev module runner and for the
+ * bundled production output.
+ */
+export declare class BuildCache {
+    #private;
+    /** Islands by name. */
+    readonly islands: Map<string, Island>;
+    /** Islands by component reference, used to detect islands while rendering. */
+    readonly islandRegistry: Map<unknown, Island>;
+    /** URL of the client runtime entry, imported by the boot script. */
+    clientEntry: string;
+    /** Stylesheets that belong to the client entry itself. */
+    entryAssets: string[];
+    buildId: string;
+    readonly dev: boolean;
+    constructor(dev: boolean);
+    /** Loads every island module and (re)builds the registries. */
+    load(manifest: HumManifest, prod: ProdManifest | null, logger?: Logger): Promise<void>;
+    getIsland(name: string): Island | undefined;
+    get prodManifest(): ProdManifest | null;
+}
+//# sourceMappingURL=build_cache.d.ts.map

package/dist/build_cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build_cache.d.ts","sourceRoot":"","sources":["../src/build_cache.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAE9D,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAEnD,yEAAyE;AACzE,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACzC,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,yEAAyE;AACzE,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAO9B;AAED;;;;;;;GAOG;AACH,qBAAa,UAAU;;IACrB,uBAAuB;IACvB,QAAQ,CAAC,OAAO,sBAA6B;IAC7C,8EAA8E;IAC9E,QAAQ,CAAC,cAAc,uBAA8B;IACrD,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,EAAE,CAAM;IAC3B,OAAO,SAAS;IAChB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IAKtB,YAAY,GAAG,EAAE,OAAO,EAGvB;IAED,+DAA+D;IACzD,IAAI,CACR,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,YAAY,GAAG,IAAI,EACzB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAuDf;IAUD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1C;IAED,IAAI,YAAY,IAAI,YAAY,GAAG,IAAI,CAEtC;CACF"}

package/dist/build_cache.js

@@ -0,0 +1,108 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { setBuildId } from "./runtime/shared_internal.js";
+/** URL the dev server serves the client runtime from. */
+export const CLIENT_ENTRY_DEV = "/_hum/runtime.js";
+/** Name of the manifest the production build writes into the out dir. */
+export const MANIFEST_FILE = "manifest.json";
+export function manifestPath(root, outDir) {
+    return join(root, outDir, MANIFEST_FILE);
+}
+/** Reads the production manifest, or `null` when the app runs in dev. */
+export async function readProdManifest(path) {
+    try {
+        const raw = await readFile(path, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Maps island components to their client side module URLs, and keeps the
+ * bookkeeping the renderer needs (`islandRegistry`, entry assets, build id).
+ *
+ * Island modules are loaded through the bundler supplied thunks, so the same
+ * cache implementation works for the Vite dev module runner and for the
+ * bundled production output.
+ */
+export class BuildCache {
+    /** Islands by name. */
+    islands = new Map();
+    /** Islands by component reference, used to detect islands while rendering. */
+    islandRegistry = new Map();
+    /** URL of the client runtime entry, imported by the boot script. */
+    clientEntry;
+    /** Stylesheets that belong to the client entry itself. */
+    entryAssets = [];
+    buildId = "dev";
+    dev;
+    #prod = null;
+    /** URL prefix the production output directory is served from. */
+    #assetsBase = "";
+    constructor(dev) {
+        this.dev = dev;
+        this.clientEntry = dev ? CLIENT_ENTRY_DEV : "";
+    }
+    /** Loads every island module and (re)builds the registries. */
+    async load(manifest, prod, logger) {
+        this.#prod = prod;
+        this.islands.clear();
+        this.islandRegistry.clear();
+        this.#assetsBase = this.dev || prod === null
+            ? ""
+            : (prod.assetsBase ?? "").replace(/\/+$/, "");
+        for (const spec of manifest.islands) {
+            let component;
+            try {
+                const mod = await spec.load();
+                component = mod[spec.exportName];
+            }
+            catch (err) {
+                logger?.error(`hum: failed to load island "${spec.name}" from ${spec.file}:`, err);
+                continue;
+            }
+            if (component === undefined) {
+                logger?.warn(`hum: island "${spec.name}" (${spec.file}) has no ` +
+                    `"${spec.exportName}" export. Add a default export to make it ` +
+                    `interactive.`);
+                continue;
+            }
+            // In dev the modules are served straight from Vite, so a leftover
+            // production manifest must never win over the dev URLs.
+            const prodInfo = this.dev ? undefined : prod?.islands[spec.name];
+            const island = {
+                name: spec.name,
+                exportName: spec.exportName,
+                file: spec.file,
+                clientUrl: prodInfo === undefined
+                    ? `/${spec.file}`
+                    : this.#assetUrl(prodInfo.file),
+                css: (prodInfo?.css ?? []).map((css) => this.#assetUrl(css)),
+            };
+            this.islands.set(island.name, island);
+            this.islandRegistry.set(component, island);
+        }
+        if (!this.dev && prod !== null) {
+            this.clientEntry = this.#assetUrl(prod.clientEntry);
+            this.entryAssets = (prod.entryAssets ?? []).map((asset) => this.#assetUrl(asset));
+            this.buildId = prod.buildId;
+            setBuildId(prod.buildId);
+        }
+    }
+    /** Turns a path relative to the output directory into a public URL. */
+    #assetUrl(file) {
+        // Manifests written by an older plugin stored absolute URLs; keep those
+        // working instead of prefixing them a second time.
+        if (file.startsWith("/"))
+            return file;
+        return `${this.#assetsBase}/${file}`;
+    }
+    getIsland(name) {
+        return this.islands.get(name);
+    }
+    get prodManifest() {
+        return this.#prod;
+    }
+}
+//# sourceMappingURL=build_cache.js.map

package/dist/build_cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build_cache.js","sourceRoot":"","sources":["../src/build_cache.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,47 @@
+import type { HumManifest, Logger } from "./types.js";
+export interface HumConfig {
+    /**
+     * Project root. Defaults to `process.cwd()`.
+     */
+    root?: string;
+    /** Routes directory, relative to the root. Defaults to `routes`. */
+    routesDir?: string;
+    /** Islands directory, relative to the root. Defaults to `islands`. */
+    islandsDir?: string;
+    /** Output directory of the production build. Defaults to `_hum`. */
+    outDir?: string;
+    /**
+     * URL the production build output is served from. The build manifest carries
+     * it, so it is normally read from there; the fallback is `/<outDir>`.
+     */
+    assetsBase?: string;
+    /** Base path the app is served from. Defaults to `/`. */
+    basePath?: string;
+    /**
+     * Run in development mode: modules are re-imported per request so edits show
+     * up without a restart, and islands are served straight from Vite.
+     * Defaults to `true` when no production manifest exists.
+     */
+    dev?: boolean;
+    /**
+     * Route and island modules generated by the bundler. The Vite plugin
+     * generates this; when omitted, Hum discovers the files on disk (useful for
+     * tests and programmatic use).
+     */
+    manifest?: HumManifest;
+    logger?: Logger;
+}
+export interface ResolvedConfig {
+    root: string;
+    routesDir: string;
+    islandsDir: string;
+    outDir: string;
+    assetsBase: string;
+    basePath: string;
+    dev: boolean;
+    manifest: HumManifest;
+    logger: Logger;
+}
+export declare const defaultLogger: Logger;
+export declare function resolveConfig(config: HumConfig, manifest: HumManifest): ResolvedConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,aAAa,EAAE,MAO3B,CAAC;AAYF,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,GAAG,cAAc,CAqBtF"}

package/dist/config.js

@@ -0,0 +1,41 @@
+import { resolve } from "node:path";
+export const defaultLogger = {
+    info: (...args) => console.log("hum:", ...args),
+    warn: (...args) => console.warn("hum:", ...args),
+    error: (...args) => console.error("hum:", ...args),
+    debug: (...args) => {
+        if (process.env.HUM_DEBUG)
+            console.log("hum:", ...args);
+    },
+};
+/**
+ * Normalizes an absolute URL prefix: it always starts with `/` and never ends
+ * with one, so callers can append `/<path>` unconditionally.
+ */
+function normalizeAssetsBase(value) {
+    const trimmed = value.trim().replace(/\\/g, "/");
+    const withLeadingSlash = trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+    return withLeadingSlash.replace(/\/+$/, "");
+}
+export function resolveConfig(config, manifest) {
+    const root = resolve(config.root ?? process.cwd());
+    let basePath = config.basePath ?? "/";
+    if (basePath !== "/" && basePath.endsWith("/")) {
+        basePath = basePath.slice(0, -1);
+    }
+    if (basePath === "/")
+        basePath = "";
+    const outDir = config.outDir ?? "_hum";
+    return {
+        root,
+        routesDir: config.routesDir ?? "routes",
+        islandsDir: config.islandsDir ?? "islands",
+        outDir,
+        assetsBase: normalizeAssetsBase(config.assetsBase ?? `/${outDir}`),
+        basePath,
+        dev: config.dev ?? true,
+        manifest,
+        logger: config.logger ?? defaultLogger,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiDpC,MAAM,CAAC,MAAM,aAAa,GAAW;IACnC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;IAC/C,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;IAClD,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE;QACjB,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1D,CAAC;CACF,CAAC;AAEF;;;GAGG;AACH,SAAS,mBAAmB,CAAC,KAAa;IACxC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACjD,MAAM,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;IAC3E,OAAO,gBAAgB,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAiB,EAAE,QAAqB;IACpE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACnD,IAAI,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,GAAG,CAAC;IACtC,IAAI,QAAQ,KAAK,GAAG,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,QAAQ,KAAK,GAAG;QAAE,QAAQ,GAAG,EAAE,CAAC;IAEpC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC;IAEvC,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,QAAQ;QACvC,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,SAAS;QAC1C,MAAM;QACN,UAAU,EAAE,mBAAmB,CAAC,MAAM,CAAC,UAAU,IAAI,IAAI,MAAM,EAAE,CAAC;QAClE,QAAQ;QACR,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,IAAI;QACvB,QAAQ;QACR,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,aAAa;KACvC,CAAC;AACJ,CAAC"}

package/dist/define.d.ts

@@ -0,0 +1,44 @@
+import type { ComponentType } from "preact";
+import type { AppModule, ErrorModule, Handlers, HeadExport, HumMiddleware, LayoutModule, PageViewProps, RouteConfig, RouteModule, RouteProps } from "./types.js";
+/**
+ * Type helpers for route modules. They add no runtime behaviour, they only
+ * make the exports of a route file type checked:
+ *
+ * ```ts
+ * import { define, page } from "@humjs/core";
+ *
+ * export const handlers = define.handlers({
+ *   GET: async (c) => page({ post: await load(c.req.param("id")) }),
+ *   POST: async (c) => c.redirect("/thanks"),
+ * });
+ *
+ * export default define.page<{ post: Post }>(({ data }) => (
+ *   <h1>{data.post.title}</h1>
+ * ));
+ * ```
+ *
+ * `define.page<Data>()` types a route's view. The handler passes business data
+ * with `page(data)`, and the view receives it under `data`.
+ *
+ * Use `define.head()` for static or route-aware head content, and
+ * `define.config()` for route rendering options:
+ *
+ * ```ts
+ * export const head = define.head(({ params }) => <title>Post {params.id}</title>);
+ * export const config = define.config({ skipInheritedLayouts: true });
+ * ```
+ */
+export interface Define<State = Record<string, unknown>> {
+    route(module: RouteModule<State>): RouteModule<State>;
+    head(head: HeadExport<State>): HeadExport<State>;
+    config(config: RouteConfig): RouteConfig;
+    page<Data>(component: ComponentType<RouteProps<State> & PageViewProps<Data>>): ComponentType<RouteProps<State> & PageViewProps<Data>>;
+    app(module: AppModule<State>): AppModule<State>;
+    layout(module: LayoutModule<State>): LayoutModule<State>;
+    error(module: ErrorModule<State>): ErrorModule<State>;
+    handlers(handlers: Handlers): Handlers;
+    middleware(middleware: HumMiddleware | HumMiddleware[]): HumMiddleware | HumMiddleware[];
+}
+export declare function createDefine<State = Record<string, unknown>>(): Define<State>;
+export declare const define: Define<Record<string, unknown>>;
+//# sourceMappingURL=define.d.ts.map

package/dist/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,QAAQ,EACR,UAAU,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrD,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACtD,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAAC;IACzC,IAAI,CAAC,IAAI,EACP,SAAS,EAAE,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,GAChE,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACzD,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACvC,UAAU,CACR,UAAU,EAAE,aAAa,GAAG,aAAa,EAAE,GAC1C,aAAa,GAAG,aAAa,EAAE,CAAC;CACpC;AAED,wBAAgB,YAAY,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,CAY7E;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAkB,CAAC"}

package/dist/define.js

@@ -0,0 +1,15 @@
+export function createDefine() {
+    return {
+        route: (module) => module,
+        head: (head) => head,
+        config: (config) => config,
+        page: (component) => component,
+        app: (module) => module,
+        layout: (module) => module,
+        error: (module) => module,
+        handlers: (handlers) => handlers,
+        middleware: (middleware) => middleware,
+    };
+}
+export const define = createDefine();
+//# sourceMappingURL=define.js.map

package/dist/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AA2DA,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM;QACzB,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI;QACpB,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM;QAC1B,IAAI,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS;QAC9B,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM;QACvB,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM;QAC1B,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM;QACzB,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ;QAChC,UAAU,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU;KACvC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAoC,YAAY,EAAE,CAAC"}