@askrjs/askr 0.0.52 → 0.0.53

package/dist/ssg/types.d.ts

@@ -1,188 +0,0 @@
-import { DocumentRenderer } from "../common/ssr.js";
-import { RenderableChild } from "../common/vnode.js";
-import { ComponentFunction } from "../common/component.js";
-import { RouteAuthMode, RouteHandler, RoutePathParams, RoutePolicy, RouteRegistry } from "../common/router.js";
-
-//#region src/ssg/types.d.ts
-type SSGMode = 'full' | 'incremental';
-type RouteRenderStatus = 'success' | 'error' | 'skipped' | 'removed';
-type RouteRenderReason = 'full' | 'changed-key' | 'changed-route' | 'new-route' | 'no-keys' | 'unchanged' | 'deleted' | 'runtime-only';
-type RouteConfigParams<Path extends string> = string extends Path ? Record<string, string> : RoutePathParams<Path>;
-type RouteComponentProps<Path extends string> = RouteConfigParams<Path> & Record<string, unknown>;
-type StaticRouteComponent<Path extends string> = (props: RouteComponentProps<Path>, context?: Parameters<ComponentFunction>[1]) => RenderableChild;
-/**
- * Route config accepted by SSG.
- *
- * `handler` is preferred and matches router/SSR naming.
- * `component` is kept for compatibility and is normalized to `handler`.
- */
-interface RouteConfig<Path extends string = string> {
-  /** URL path to generate (e.g., "/blog/post-1", "/") */
-  path: Path;
-  /** Route handler compatible with router/SSR */
-  handler?: RouteHandler;
-  /** Backward-compatible alias for handler */
-  component?: StaticRouteComponent<Path>;
-  /** Optional base props merged with route params during render */
-  props?: Record<string, unknown>;
-  /** Optional namespace for router compatibility */
-  namespace?: string;
-  /** Guest routes remain prerenderable; authenticated routes are runtime-only by default */
-  auth?: RouteAuthMode;
-  /** Role-gated routes are runtime-only by default */
-  role?: string;
-  /** Permission-gated routes are runtime-only by default */
-  permission?: string;
-  /** Advanced runtime access checks disable prerendering by default */
-  policies?: readonly RoutePolicy[];
-  /** Optional path parameter map for template paths like "/blog/{slug}" */
-  params?: RouteConfigParams<Path>;
-  /** Optional explicit invalidation keys for incremental generation */
-  invalidationKeys?: string[];
-  /**
-   * SSG entry generator for parameterized routes.
-   *
-   * Return one param map per page to be generated.  The path template is
-   * expanded with each map to produce a concrete URL, e.g.:
-   *
-   * ```ts
-   * route('/posts/{slug}', PostPage, {
-   *   entries: async () => getPosts().map(p => ({ slug: p.slug })),
-   * });
-   * ```
-   */
-  entries?: () => Array<RouteConfigParams<Path>> | Promise<Array<RouteConfigParams<Path>>>;
-}
-interface SSGBaseOptions {
-  /** Output directory for generated HTML files */
-  outputDir: string;
-  /** Optional seed for deterministic rendering */
-  seed?: number;
-  /** Optional override data for resources (route-keyed) */
-  dataOverrides?: Record<string, unknown>;
-  /** Optional document wrapper for full HTML output */
-  document?: DocumentRenderer;
-  /** Optional concurrency limit for rendering (default: 1) */
-  concurrency?: number;
-  /** Preferred render parallelism. `'auto'` resolves from the host machine. */
-  parallelism?: number | 'auto';
-}
-/** Options for createStaticGen */
-type SSGOptions<TRoutes extends readonly RouteConfig[] = RouteConfig[]> = SSGBaseOptions & ({
-  /** Routes to generate. Prefer `registry` when routes are already defined through the router DSL. */routes: TRoutes;
-  registry?: never;
-} | {
-  /** Explicit route registry captured with `createRouteRegistry()`. */registry: RouteRegistry;
-  routes?: never;
-});
-/** Options for a single generation run */
-interface SSGGenerateOptions {
-  /** Generation mode */
-  mode?: SSGMode;
-  /** Changed invalidation keys for incremental runs */
-  changedKeys?: string[];
-  /** Changed concrete route paths for incremental runs */
-  changedRoutes?: string[];
-  /** Force a full rebuild even when incremental mode was requested */
-  forceFull?: boolean;
-}
-/** Result of rendering a single route */
-interface RouteRenderResult {
-  /** URL path */
-  path: string;
-  /** Output file path relative to outputDir */
-  filePath: string;
-  /** Generated HTML content */
-  html: string;
-  /** File size in bytes */
-  fileSize: number;
-  /** Render duration in milliseconds */
-  renderDuration: number;
-  /** Number of resources discovered and rendered */
-  resourceCount: number;
-  /** Render or generation status */
-  status: RouteRenderStatus;
-  /** Why this route was rendered, skipped, or removed */
-  reason: RouteRenderReason;
-  /** Whether the output file was written during this run */
-  written: boolean;
-  /** Error message if rendering failed */
-  error?: string;
-}
-/** Overall result from SSG generation */
-interface SSGResult {
-  /** ISO timestamp of generation */
-  generatedAt: string;
-  /** Total number of routes processed */
-  totalRoutes: number;
-  /** Number of successfully generated routes */
-  successful: number;
-  /** Number of failed routes */
-  failed: number;
-  /** Total generation duration in milliseconds */
-  totalDuration: number;
-  /** Effective generation mode */
-  mode: SSGMode;
-  /** Number of routes rendered during this run */
-  rebuilt: number;
-  /** Number of current routes skipped as unchanged */
-  skipped: number;
-  /** Number of stale routes removed from output */
-  removed: number;
-  /** Number of rendered routes whose HTML bytes were unchanged */
-  cacheHits: number;
-  /** Invalidation keys applied to this run */
-  invalidatedKeys: string[];
-  /** Concrete route paths applied to this run */
-  invalidatedRoutes: string[];
-  /** Per-route results */
-  routes: RouteRenderResult[];
-}
-/** Metadata to write to metadata.json */
-interface SSGMetadata extends Record<string, unknown> {
-  /** ISO timestamp of generation */
-  generatedAt: string;
-  /** Total number of routes processed */
-  totalRoutes: number;
-  /** Number of successfully generated routes */
-  successful: number;
-  /** Number of failed routes */
-  failed: number;
-  /** Total generation duration in milliseconds */
-  totalDuration: number;
-  /** Effective generation mode */
-  mode: SSGMode;
-  /** Number of routes rendered during this run */
-  rebuilt: number;
-  /** Number of current routes skipped as unchanged */
-  skipped: number;
-  /** Number of stale routes removed from output */
-  removed: number;
-  /** Number of rendered routes whose HTML bytes were unchanged */
-  cacheHits: number;
-  /** Invalidation keys applied to this run */
-  invalidatedKeys: string[];
-  /** Concrete route paths applied to this run */
-  invalidatedRoutes: string[];
-  /** Per-route details */
-  routes: Array<{
-    /** URL path */path: string; /** Output file path relative to outputDir */
-    filePath: string; /** File size in bytes */
-    fileSize: number; /** Render duration in milliseconds */
-    renderDuration: number; /** Number of resources discovered and rendered */
-    resourceCount: number; /** Render or generation status */
-    status: RouteRenderStatus; /** Why this route was rendered, skipped, or removed */
-    reason: RouteRenderReason; /** Whether the output file was written during this run */
-    written: boolean; /** Error message if rendering failed */
-    error?: string;
-  }>;
-}
-/** Resource discovery result for a single route */
-interface DiscoveredResources {
-  [key: string]: {
-    count: number;
-    dependencies: string[];
-  };
-}
-//#endregion
-export { DiscoveredResources, RouteConfig, RouteRenderReason, RouteRenderResult, RouteRenderStatus, SSGGenerateOptions, SSGMetadata, SSGMode, SSGOptions, SSGResult };

package/dist/ssg/write-static-files.js

@@ -1,77 +0,0 @@
-import "./route-utils.js";
-import * as fs from "node:fs/promises";
-import * as pathModule from "node:path";
-import * as fsSync from "node:fs";
-//#region src/ssg/write-static-files.ts
-/**
-* File I/O for Static Site Generation
-*
-* Uses Node.js fs/path modules to write rendered HTML files to disk.
-* This module is Node-only and not intended for browser builds.
-*/
-/**
-* Write rendered routes to disk
-* Creates outputDir/{route-path}/index.html structure
-*/
-async function writeStaticFiles(results, outputDir, options = {}, fileOperations = fs) {
-	await fileOperations.mkdir(outputDir, { recursive: true });
-	for (const result of results) {
-		if (result.status !== "removed") continue;
-		const fullPath = pathModule.join(outputDir, result.filePath);
-		if (fsSync.existsSync(fullPath)) {
-			await fileOperations.rm(fullPath, { force: true });
-			await pruneEmptyDirs(pathModule.dirname(fullPath), outputDir, fileOperations);
-		}
-	}
-	const pendingWrites = [];
-	for (let index = 0; index < results.length; index += 1) {
-		const result = results[index];
-		if (result.status === "error") {
-			console.warn(`Skipping failed route: ${result.path} - ${result.error}`);
-			continue;
-		}
-		if (result.status === "success" && result.written) pendingWrites.push(result);
-	}
-	const directories = [];
-	const seenDirectories = /* @__PURE__ */ new Set();
-	for (const result of pendingWrites) {
-		const dir = pathModule.dirname(pathModule.join(outputDir, result.filePath));
-		if (!seenDirectories.has(dir)) {
-			seenDirectories.add(dir);
-			directories.push(dir);
-		}
-	}
-	for (const dir of directories) await fileOperations.mkdir(dir, { recursive: true });
-	const concurrency = Math.max(1, Math.min(options.concurrency ?? 8, pendingWrites.length || 1));
-	let nextIndex = 0;
-	const worker = async () => {
-		while (true) {
-			const current = nextIndex;
-			nextIndex += 1;
-			if (current >= pendingWrites.length) return;
-			const result = pendingWrites[current];
-			const fullPath = pathModule.join(outputDir, result.filePath);
-			const tempPath = pathModule.join(pathModule.dirname(fullPath), `.${pathModule.basename(fullPath)}.askr-${process.pid}-${current}.tmp`);
-			try {
-				await fileOperations.writeFile(tempPath, result.html, "utf8");
-				await fileOperations.rename(tempPath, fullPath);
-			} finally {
-				await fileOperations.rm(tempPath, { force: true });
-			}
-		}
-	};
-	await Promise.all(Array.from({ length: concurrency }, () => worker()));
-}
-async function pruneEmptyDirs(startDir, rootDir, fileOperations) {
-	let current = startDir;
-	const normalizedRoot = pathModule.resolve(rootDir);
-	while (current.startsWith(normalizedRoot)) {
-		if (!fsSync.existsSync(current)) break;
-		if ((await fileOperations.readdir(current)).length > 0) break;
-		await fileOperations.rmdir(current);
-		if (pathModule.resolve(current) === normalizedRoot) break;
-		current = pathModule.dirname(current);
-	}
-}
-//#endregion
-export { writeStaticFiles };

package/dist/ssr/attrs.js

@@ -1,92 +0,0 @@
-import { getPublicAttributeName } from "../common/attr-names.js";
-import { escapeAttr, needsEscapeAttr, styleObjToCss } from "./escape.js";
-//#region src/ssr/attrs.ts
-const ESCAPED_ATTR_VALUE_CACHE_LIMIT = 512;
-const escapedAttrValueCache = /* @__PURE__ */ new Map();
-function isEventHandler(key) {
-	return key.length >= 3 && key.charCodeAt(0) === 111 && key.charCodeAt(1) === 110 && key.charCodeAt(2) >= 65 && key.charCodeAt(2) <= 90;
-}
-function getEscapedAttrValue(value) {
-	if (value.length > 64) return escapeAttr(value);
-	const cached = escapedAttrValueCache.get(value);
-	if (cached !== void 0) return cached;
-	const escaped = escapeAttr(value);
-	if (escaped === value) return value;
-	if (escapedAttrValueCache.size >= ESCAPED_ATTR_VALUE_CACHE_LIMIT) escapedAttrValueCache.clear();
-	escapedAttrValueCache.set(value, escaped);
-	return escaped;
-}
-/**
-* Render attributes directly to a sink without intermediate string allocations.
-* This is the hot path for streaming SSR.
-*/
-function renderAttrsDirect(props, sink) {
-	if (!props || typeof props !== "object") return;
-	const propsObj = props;
-	for (const key in propsObj) {
-		const value = propsObj[key];
-		if (key === "children" || key === "key" || key === "ref" || key === "dangerouslySetInnerHTML") continue;
-		if (isEventHandler(key)) continue;
-		if (key.charCodeAt(0) === 95) continue;
-		const attrName = getPublicAttributeName(key);
-		if (attrName === "style") {
-			const css = typeof value === "string" ? value : styleObjToCss(value);
-			if (!css) continue;
-			sink.write(" style=\"");
-			if (needsEscapeAttr(css)) sink.write(getEscapedAttrValue(css));
-			else sink.write(css);
-			sink.write("\"");
-			continue;
-		}
-		if (value === true) {
-			sink.write(" ");
-			sink.write(attrName);
-			continue;
-		}
-		if (value === false || value === null || value === void 0) continue;
-		const strValue = String(value);
-		sink.write(" ");
-		sink.write(attrName);
-		sink.write("=\"");
-		sink.write(getEscapedAttrValue(strValue));
-		sink.write("\"");
-	}
-}
-function renderAttrs(props, opts) {
-	if (!props || typeof props !== "object") return opts?.returnDangerousHtml ? { attrs: "" } : "";
-	const attrParts = [];
-	let dangerousHtml;
-	const propsObj = props;
-	for (const key in propsObj) {
-		const value = propsObj[key];
-		if (key === "children") continue;
-		if (key === "key" || key === "ref") continue;
-		if (key === "dangerouslySetInnerHTML") {
-			if (value && typeof value === "object" && "__html" in value) dangerousHtml = String(value.__html);
-			continue;
-		}
-		if (isEventHandler(key)) continue;
-		if (key.charCodeAt(0) === 95) continue;
-		const attrName = key === "class" ? "class" : getPublicAttributeName(key);
-		if (attrName === "style") {
-			const css = typeof value === "string" ? value : styleObjToCss(value);
-			if (css === null || css === "") continue;
-			attrParts.push(` style="${getEscapedAttrValue(css)}"`);
-			continue;
-		}
-		if (value === true) attrParts.push(` ${attrName}`);
-		else if (value === false || value === null || value === void 0) continue;
-		else {
-			const strValue = String(value);
-			attrParts.push(` ${attrName}="${getEscapedAttrValue(strValue)}"`);
-		}
-	}
-	const result = attrParts.join("");
-	if (opts?.returnDangerousHtml) return {
-		attrs: result,
-		dangerousHtml
-	};
-	return result;
-}
-//#endregion
-export { renderAttrs, renderAttrsDirect };

package/dist/ssr/boundaries.js

@@ -1,124 +0,0 @@
-import { __CONTROL_BOUNDARY__ } from "../common/control.js";
-import { ELEMENT_TYPE } from "../common/jsx.js";
-import { evaluateCaseState, evaluateShowState } from "../runtime/control.js";
-import { commitForStateTransaction, evaluateForState, rollbackForStateTransaction } from "../runtime/for-internal.js";
-import "../runtime/index.js";
-import "../jsx/index.js";
-//#region src/ssr/boundaries.ts
-function normalizeRenderableChildren(value) {
-	if (value === null || value === void 0 || value === false) return [];
-	return Array.isArray(value) ? value : [value];
-}
-function getRenderableChildren(node) {
-	if (Array.isArray(node.children)) return node.children;
-	if (Array.isArray(node.props?.children)) return node.props.children;
-	if (node.props?.children !== void 0 && node.props.children !== null && node.props.children !== false) return [node.props.children];
-}
-function getErrorBoundaryState(node) {
-	return node.__instance?.errorBoundaryState ?? null;
-}
-function resetErrorBoundaryState(node) {
-	const state = node.__instance?.errorBoundaryState;
-	if (state) {
-		state.error = null;
-		state.notified = false;
-	}
-}
-function createErrorBoundaryReset(node) {
-	return () => resetErrorBoundaryState(node);
-}
-function createDefaultErrorBoundaryFallbackVNode(error) {
-	const message = error instanceof Error ? error.stack || error.message || error.name : typeof error === "string" ? error : (() => {
-		try {
-			return JSON.stringify(error);
-		} catch {
-			return String(error);
-		}
-	})();
-	return {
-		$$typeof: ELEMENT_TYPE,
-		type: "div",
-		props: {
-			role: "alert",
-			"data-askr-error-boundary": "true",
-			style: {
-				boxSizing: "border-box",
-				padding: "1rem",
-				border: "1px solid currentColor",
-				borderRadius: "0.75rem",
-				display: "grid",
-				gap: "0.75rem",
-				maxWidth: "100%"
-			},
-			children: [
-				{
-					$$typeof: ELEMENT_TYPE,
-					type: "strong",
-					props: { children: ["Something went wrong while rendering this view."] }
-				},
-				{
-					$$typeof: ELEMENT_TYPE,
-					type: "p",
-					props: {
-						style: { margin: "0" },
-						children: ["The app recovered into a visible fallback so the error is not hidden in the console."]
-					}
-				},
-				{
-					$$typeof: ELEMENT_TYPE,
-					type: "details",
-					props: {
-						open: false,
-						children: [{
-							$$typeof: ELEMENT_TYPE,
-							type: "summary",
-							props: { children: ["Error details"] }
-						}, {
-							$$typeof: ELEMENT_TYPE,
-							type: "pre",
-							props: {
-								style: {
-									margin: "0",
-									whiteSpace: "pre-wrap",
-									wordBreak: "break-word"
-								},
-								children: [message]
-							}
-						}]
-					}
-				}
-			]
-		},
-		key: null
-	};
-}
-function resolveErrorBoundaryFallbackNode(fallback, error, reset) {
-	return typeof fallback === "function" ? fallback(error, reset) : fallback !== void 0 ? fallback : createDefaultErrorBoundaryFallbackVNode(error);
-}
-function getControlBoundaryState(node) {
-	const boundaryNode = node;
-	return boundaryNode._controlState ?? boundaryNode._forState ?? null;
-}
-function evaluateControlBoundaryChildren(node) {
-	if (node.type !== __CONTROL_BOUNDARY__) return;
-	const controlState = getControlBoundaryState(node);
-	if (!controlState) return [];
-	if (controlState.kind === "for") return evaluateForState(controlState);
-	if (controlState.kind === "show") return evaluateShowState(controlState);
-	return evaluateCaseState(controlState);
-}
-function withControlBoundaryChildren(node, render) {
-	const controlState = getControlBoundaryState(node);
-	if (!controlState || controlState.kind !== "for") return render(evaluateControlBoundaryChildren(node));
-	const children = evaluateForState(controlState);
-	try {
-		const result = render(children);
-		commitForStateTransaction(controlState);
-		return result;
-	} catch (error) {
-		rollbackForStateTransaction(controlState);
-		throw error;
-	}
-}
-//#endregion
-export { createErrorBoundaryReset, evaluateControlBoundaryChildren, getControlBoundaryState, getErrorBoundaryState, getRenderableChildren, normalizeRenderableChildren, resetErrorBoundaryState, resolveErrorBoundaryFallbackNode, withControlBoundaryChildren };

package/dist/ssr/component-runtime.js

@@ -1,85 +0,0 @@
-import { ELEMENT_TYPE, Fragment } from "../common/jsx.js";
-import { getCurrentComponentInstance, setCurrentComponentInstance } from "../runtime/component-scope.js";
-import { cleanupComponent } from "../runtime/component-cleanup.js";
-import { isPromiseLike } from "../common/promise.js";
-import { createComponentInstance } from "../runtime/component-internal.js";
-import { DefaultPortal, disposeDefaultPortalScope } from "../runtime/portal.js";
-import "../runtime/index.js";
-import "../jsx/index.js";
-import { throwSSRDataMissing } from "./context.js";
-function executeComponentSync(component, props, ctx) {
-	try {
-		const prev = getCurrentComponentInstance();
-		const temp = createComponentInstance("ssr-temp", component, props || {}, null);
-		temp.ssr = true;
-		temp.portalScope = temp;
-		ctx.ssrCleanupFns.push(() => {
-			let cleanupError = null;
-			try {
-				cleanupComponent(temp);
-			} catch (error) {
-				cleanupError = error;
-			}
-			try {
-				disposeDefaultPortalScope(temp);
-			} catch (error) {
-				if (cleanupError) throw new AggregateError([cleanupError, error], "SSR temporary owner cleanup failed");
-				throw error;
-			}
-			if (cleanupError) throw cleanupError;
-		});
-		setCurrentComponentInstance(temp);
-		try {
-			const result = component(props || {}, { ssr: ctx });
-			if (isPromiseLike(result)) throwSSRDataMissing();
-			if (typeof result === "string" || typeof result === "number" || typeof result === "boolean" || result === null || result === void 0) {
-				const inner = result === null || result === void 0 || result === false ? "" : String(result);
-				return {
-					$$typeof: ELEMENT_TYPE,
-					type: Fragment,
-					props: { children: inner ? [inner] : [] }
-				};
-			}
-			return result;
-		} finally {
-			setCurrentComponentInstance(prev);
-		}
-	} finally {}
-}
-function disposeSSRTemporaryOwners(ctx) {
-	const cleanupFns = ctx.ssrCleanupFns;
-	ctx.ssrCleanupFns = [];
-	const cleanupErrors = [];
-	for (let index = cleanupFns.length - 1; index >= 0; index -= 1) try {
-		cleanupFns[index]();
-	} catch (error) {
-		cleanupErrors.push(error);
-	}
-	if (cleanupErrors.length === 1) throw cleanupErrors[0];
-	if (cleanupErrors.length > 1) throw new AggregateError(cleanupErrors, "SSR temporary owner cleanup failed");
-}
-function wrapWithDefaultPortal(out) {
-	if (isPromiseLike(out)) throwSSRDataMissing();
-	const portalVNode = {
-		$$typeof: ELEMENT_TYPE,
-		type: DefaultPortal,
-		props: { __askrAutoDefaultPortal: true },
-		key: "__default_portal"
-	};
-	if (out == null) return {
-		$$typeof: ELEMENT_TYPE,
-		type: Fragment,
-		props: { children: [portalVNode] }
-	};
-	return {
-		$$typeof: ELEMENT_TYPE,
-		type: Fragment,
-		props: { children: [out, portalVNode] }
-	};
-}
-function renderSyncComponentRoot(component, props, ctx) {
-	const wrapped = (p, c) => wrapWithDefaultPortal(component(p ?? {}, c));
-	return executeComponentSync(wrapped, props || {}, ctx);
-}
-//#endregion
-export { disposeSSRTemporaryOwners, executeComponentSync, renderSyncComponentRoot };

package/dist/ssr/context.d.ts

@@ -1,49 +0,0 @@
-import { SSRData } from "../common/ssr.js";
-import { Route, RouteAuthOptions } from "../common/router.js";
-import { SSRDataMissingError } from "../common/ssr-errors.js";
-//#region src/ssr/context.d.ts
-interface RenderContext {
-  url: string;
-  seed: number;
-  data?: SSRData;
-  params?: Record<string, string>;
-  routes?: readonly Route[];
-  routeAuth?: RouteAuthOptions;
-  signal?: AbortSignal;
-  dataRuntime?: unknown;
-  queryCache?: Map<string, unknown>;
-  ssrCleanupFns: Array<() => void>;
-  keyCounter: number;
-  renderData: Record<string, unknown> | null;
-}
-type SSRContext = RenderContext;
-declare function createRenderContext(seed?: number, opts?: {
-  url?: string;
-  data?: SSRData;
-  params?: Record<string, string>;
-  routes?: readonly Route[];
-  routeAuth?: RouteAuthOptions;
-  signal?: AbortSignal;
-  dataRuntime?: unknown;
-}): RenderContext;
-/**
- * Run a function with the given render context.
- * Concurrency-safe in Node.js via AsyncLocalStorage.
- */
-declare function withRenderContext<T>(ctx: RenderContext, fn: () => T): T;
-/**
- * Get the current render context.
- * Returns null if not inside a render.
- */
-declare function getRenderContext(): RenderContext | null;
-declare const getSSRContext: typeof getRenderContext;
-declare const withSSRContext: typeof withRenderContext;
-declare const getCurrentSSRContext: typeof getRenderContext;
-declare function runWithSSRContext<T>(ctx: RenderContext, fn: () => T): T;
-/**
- * Centralized SSR enforcement helper — throws a consistent error when async
- * data is encountered during synchronous SSR.
- */
-declare function throwSSRDataMissing(): never;
-//#endregion
-export { RenderContext, type SSRData, SSRDataMissingError, getRenderContext, withRenderContext };