@askrjs/askr 0.0.52 → 0.0.53

package/dist/runtime/resource-cell.js

@@ -1,112 +0,0 @@
-import { logger } from "../common/logger.js";
-import { withAsyncResourceContext } from "./context.js";
-import { isPromiseLike } from "../common/promise.js";
-import { brandSnapshotSource } from "./snapshot-source.js";
-import { throwSSRDataMissing } from "../common/render-context.js";
-//#region src/runtime/resource-cell.ts
-/**
-* Pure, component-agnostic ResourceCell state machine.
-* - Holds value/pending/error/generation/controller
-* - Exposes a stable `snapshot` object: { value, pending, error, refresh }
-* - Uses `withAsyncResourceContext` to bind the synchronous execution step
-*   to a captured frame. Continuations after await do not see the frame.
-*/
-var ResourceCell = class {
-	constructor(fn, deps, resourceFrame) {
-		this.value = null;
-		this.pending = true;
-		this.error = null;
-		this.generation = 0;
-		this.controller = null;
-		this.deps = null;
-		this.resourceFrame = null;
-		this.subscribers = /* @__PURE__ */ new Set();
-		this.disposed = false;
-		this.fn = fn;
-		this.deps = deps ? deps.slice() : null;
-		this.resourceFrame = resourceFrame;
-		this.snapshot = brandSnapshotSource({
-			value: null,
-			pending: true,
-			error: null,
-			refresh: () => this.refresh()
-		});
-	}
-	setLoader(fn) {
-		this.fn = fn;
-	}
-	subscribe(cb) {
-		this.subscribers.add(cb);
-		return () => this.subscribers.delete(cb);
-	}
-	notifySubscribers() {
-		this.snapshot.value = this.value;
-		this.snapshot.pending = this.pending;
-		this.snapshot.error = this.error;
-		for (const cb of this.subscribers) cb();
-	}
-	start(ssr = false, notify = true) {
-		if (this.disposed) return;
-		const generation = this.generation;
-		this.controller?.abort();
-		const controller = new AbortController();
-		this.controller = controller;
-		this.pending = true;
-		this.error = null;
-		if (notify) this.notifySubscribers();
-		let result;
-		try {
-			result = withAsyncResourceContext(this.resourceFrame, () => this.fn({ signal: controller.signal }));
-		} catch (err) {
-			this.pending = false;
-			this.error = err instanceof Error ? err : new Error(String(err));
-			if (notify) this.notifySubscribers();
-			return;
-		}
-		if (!isPromiseLike(result)) {
-			this.value = result;
-			this.pending = false;
-			this.error = null;
-			if (notify) this.notifySubscribers();
-			return;
-		}
-		if (ssr) throwSSRDataMissing();
-		Promise.resolve(result).then((val) => {
-			if (this.generation !== generation) return;
-			if (this.controller !== controller) return;
-			if (controller.signal.aborted) return;
-			this.value = val;
-			this.pending = false;
-			this.error = null;
-			this.notifySubscribers();
-		}).catch((err) => {
-			if (this.generation !== generation) return;
-			if (this.controller !== controller) return;
-			if (controller.signal.aborted || err instanceof Error && err.name === "AbortError" || typeof DOMException !== "undefined" && err instanceof DOMException && err.name === "AbortError") return;
-			this.pending = false;
-			this.error = err instanceof Error ? err : new Error(String(err));
-			try {
-				if (this.ownerName) logger.error(`[Askr] Async resource error in ${this.ownerName}:`, err);
-				else logger.error("[Askr] Async resource error:", err);
-			} catch {}
-			this.notifySubscribers();
-		});
-	}
-	refresh() {
-		if (this.disposed) return;
-		this.generation++;
-		this.controller?.abort();
-		this.start();
-	}
-	abort() {
-		this.controller?.abort();
-	}
-	dispose() {
-		if (this.disposed) return;
-		this.disposed = true;
-		this.controller?.abort();
-		this.subscribers.clear();
-	}
-};
-//#endregion
-export { ResourceCell };

package/dist/runtime/resource-operation.d.ts

@@ -1,12 +0,0 @@
-//#region src/runtime/resource-operation.d.ts
-interface ResourceResult<T> {
-  value: T | null;
-  pending: boolean;
-  error: Error | null;
-  refresh(): void;
-}
-declare function resource<T, const TDeps extends readonly unknown[]>(fn: (opts: {
-  signal: AbortSignal;
-}) => PromiseLike<T> | T, deps: TDeps): ResourceResult<T>;
-//#endregion
-export { ResourceResult, resource };

package/dist/runtime/runtime.js

@@ -1,57 +0,0 @@
-import { globalScheduler } from "./scheduler.js";
-//#region src/runtime/runtime.ts
-function createMissingRendererHost() {
-	const missing = (method) => {
-		throw new Error(`[Askr] renderer host is not configured; cannot call ${method}().`);
-	};
-	return {
-		evaluate() {
-			missing("evaluate");
-		},
-		cleanupInstancesUnder() {
-			missing("cleanupInstancesUnder");
-		},
-		teardownNodeSubtree() {
-			missing("teardownNodeSubtree");
-		},
-		populateKeyMapForElement() {},
-		getKeyMapForElement() {},
-		isKeyedReorderFastPathEligible() {
-			return {
-				useFastPath: false,
-				totalKeyed: 0,
-				totalChildren: 0,
-				currentKeyCount: 0,
-				moveCount: 0,
-				lisLen: 0,
-				hasPropChanges: false,
-				isWholeKeyedList: false
-			};
-		},
-		markReactivePropsDirtySource() {}
-	};
-}
-var AskrRuntime = class {
-	constructor(options = {}) {
-		this.scheduler = options.scheduler ?? globalScheduler;
-		this.rendererHost = options.renderer ?? createMissingRendererHost();
-	}
-	get renderer() {
-		return this.rendererHost;
-	}
-	configureRenderer(renderer) {
-		this.rendererHost = renderer;
-	}
-};
-const defaultRuntime = new AskrRuntime({ scheduler: globalScheduler });
-function createRuntime(options = {}) {
-	return new AskrRuntime(options);
-}
-function getDefaultRuntime() {
-	return defaultRuntime;
-}
-function configureRuntimeRenderer(renderer, runtime = defaultRuntime) {
-	runtime.configureRenderer(renderer);
-}
-//#endregion
-export { AskrRuntime, configureRuntimeRenderer, createRuntime, defaultRuntime, getDefaultRuntime };

package/dist/runtime/selector-store.js

@@ -1,22 +0,0 @@
-import { enqueueRuntimeLane } from "./access.js";
-//#region src/runtime/selector-store.ts
-const dirtySelectorRecords = /* @__PURE__ */ new Set();
-let hasPendingSelectorFlush = false;
-function markDirtySelectorRecord(record, flush) {
-	record._dirty = true;
-	if (record._scheduled) return;
-	record._scheduled = true;
-	dirtySelectorRecords.add(record);
-	if (hasPendingSelectorFlush) return;
-	hasPendingSelectorFlush = true;
-	enqueueRuntimeLane("derived", flush);
-}
-function takeDirtySelectorRecords() {
-	hasPendingSelectorFlush = false;
-	if (dirtySelectorRecords.size === 0) return [];
-	const pending = Array.from(dirtySelectorRecords);
-	dirtySelectorRecords.clear();
-	return pending;
-}
-//#endregion
-export { markDirtySelectorRecord, takeDirtySelectorRecords };

package/dist/runtime/selector.d.ts

@@ -1,10 +0,0 @@
-//#region src/runtime/selector.d.ts
-interface Selector<T> {
-  (candidate: T): boolean;
-}
-type SelectorEquals<T> = {
-  bivarianceHack(a: T, b: T): boolean;
-}['bivarianceHack'];
-declare function selector<T>(source: () => T, equals?: SelectorEquals<T>): Selector<T>;
-//#endregion
-export { Selector, selector };

package/dist/runtime/snapshot-source.d.ts

@@ -1,9 +0,0 @@
-//#region src/runtime/snapshot-source.d.ts
-declare const SNAPSHOT_SOURCE_BRAND: unique symbol;
-type SnapshotSourceBrand = {
-  readonly [SNAPSHOT_SOURCE_BRAND]: true;
-};
-declare function brandSnapshotSource<T extends object>(value: T): T & SnapshotSourceBrand;
-declare function isSnapshotSource(value: unknown): value is SnapshotSourceBrand;
-//#endregion
-export { SNAPSHOT_SOURCE_BRAND, SnapshotSourceBrand };

package/dist/runtime/state.d.ts

@@ -1,54 +0,0 @@
-import { ReadableSource } from "./readable.js";
-
-//#region src/runtime/state.d.ts
-/**
- * State value holder - callable to read, has set method to update
- * @example
- * const count = state(0);
- * count();           // read: 0
- * count.set(1);      // write: triggers re-render
- */
-interface State<T> extends ReadableSource<T> {
-  (): T;
-  set(...args: StateSetterArgs<T>): void;
-  [Symbol.iterator](): IterableIterator<StateTuple<T>[number]>;
-}
-type StateUpdater<T> = (prev: T) => T;
-type StateSetterArgs<T> = [Extract<T, (...args: any[]) => unknown>] extends [never] ? [value: T] | [updater: StateUpdater<T>] : [updater: StateUpdater<T>];
-/**
- * Public setter type for state cells.
- */
-type StateSetter<T> = (...args: StateSetterArgs<T>) => void;
-/**
- * Tuple-first state handle returned by `state()`.
- */
-type StateTuple<T> = [get: State<T>, set: StateSetter<T>] & State<T>;
-/**
- * Creates a local state value for a component
- * Optimized for:
- * - O(1) read performance
- * - Minimal allocation per state
- * - Fast scheduler integration
- *
- * IMPORTANT: state() must be called during component render execution.
- * It captures the current component instance from context.
- * Calling outside a component function will throw an error.
- *
- * @example
- * ```ts
- * // ✅ Correct: called during render
- * export function Counter() {
- *   const [count, setCount] = state(0);
- *   return { type: 'button', children: [count()] };
- * }
- *
- * // ❌ Wrong: called outside component
- * const count = state(0);
- * export function BadComponent() {
- *   return { type: 'div' };
- * }
- * ```
- */
-declare function state<T>(initialValue: T): StateTuple<T>;
-//#endregion
-export { State, StateSetter, StateTuple, state };

package/dist/ssg/batch-render.js

@@ -1,101 +0,0 @@
-import { renderDocument } from "../common/ssr.js";
-import { renderToString } from "../ssr/index-internal.js";
-import "../ssr/index.js";
-import { getOutputFilePath, interpolateRoutePath } from "./route-utils.js";
-import { resolveSsgRouteData } from "./resolve-ssg-data.js";
-//#region src/ssg/batch-render.ts
-/**
-* Batch rendering of multiple routes for SSG
-*/
-/**
-* Render multiple routes in parallel with error handling
-*/
-async function batchRenderRoutes(routes, options = {}) {
-	const { seed = 12345, dataMap = {}, concurrency = 1, document } = options;
-	const workerCount = Math.max(1, Math.min(concurrency, routes.length || 1));
-	const results = [];
-	results.length = routes.length;
-	let nextIndex = 0;
-	const renderOne = async (route) => {
-		const startTime = performance.now();
-		const url = interpolateRoutePath(route.path, route.params);
-		const requestUrl = new URL(url, "http://localhost");
-		const resolvedData = resolveSsgRouteData(dataMap, route.path, url);
-		const baseData = resolvedData.hasData ? resolvedData.data : void 0;
-		const resourceCount = resolvedData.hasData && baseData ? Object.keys(baseData).length : 0;
-		const mergedHandler = route.handler ? route.handler : (params, ctx) => {
-			const component = route.component;
-			return component({
-				...route.props,
-				...params
-			}, ctx);
-		};
-		try {
-			const html = renderToString({
-				url,
-				routes: [{
-					path: route.path,
-					handler: mergedHandler,
-					namespace: route.namespace
-				}],
-				seed,
-				data: baseData,
-				document: document === void 0 ? void 0 : ({ appHtml }) => renderDocument(document, {
-					appHtml,
-					context: {
-						mode: "ssg",
-						url,
-						pathname: requestUrl.pathname,
-						search: requestUrl.search,
-						hash: requestUrl.hash,
-						params: route.params ?? {},
-						data: baseData,
-						seed,
-						route: {
-							path: route.path,
-							namespace: route.namespace
-						}
-					}
-				}, "createStaticGen()")
-			});
-			const duration = performance.now() - startTime;
-			return {
-				path: url,
-				filePath: getOutputFilePath(url),
-				html,
-				fileSize: Buffer.byteLength(html, "utf8"),
-				renderDuration: Math.round(duration),
-				resourceCount,
-				status: "success",
-				reason: "full",
-				written: false
-			};
-		} catch (error) {
-			const duration = performance.now() - startTime;
-			return {
-				path: url,
-				filePath: getOutputFilePath(url),
-				html: "",
-				fileSize: 0,
-				renderDuration: Math.round(duration),
-				resourceCount,
-				status: "error",
-				reason: "full",
-				written: false,
-				error: error instanceof Error ? error.message : String(error)
-			};
-		}
-	};
-	const worker = async () => {
-		while (true) {
-			const current = nextIndex;
-			nextIndex += 1;
-			if (current >= routes.length) return;
-			results[current] = await renderOne(routes[current]);
-		}
-	};
-	await Promise.all(Array.from({ length: workerCount }, () => worker()));
-	return results;
-}
-//#endregion
-export { batchRenderRoutes };

package/dist/ssg/create-static-gen.d.ts

@@ -1,66 +0,0 @@
-import { RouteRegistry } from "../common/router.js";
-import { RouteConfig, SSGGenerateOptions, SSGOptions, SSGResult } from "./types.js";
-import * as fs from "node:fs/promises";
-
-//#region src/ssg/create-static-gen.d.ts
-type AnyRouteConfig = RouteConfig<string>;
-type StrictRouteConfig<TRoute extends AnyRouteConfig> = Omit<TRoute, 'params' | 'entries'> & {
-  params?: RouteConfig<TRoute['path']>['params'];
-  entries?: RouteConfig<TRoute['path']>['entries'];
-};
-type StrictRouteConfigs<TRoutes extends readonly AnyRouteConfig[]> = { [TIndex in keyof TRoutes]: TRoutes[TIndex] extends AnyRouteConfig ? StrictRouteConfig<TRoutes[TIndex]> : never };
-type StaticGenRouteSource<TRoutes extends readonly AnyRouteConfig[]> = {
-  routes: TRoutes & StrictRouteConfigs<TRoutes>;
-  registry?: never;
-} | {
-  registry: RouteRegistry;
-  routes?: never;
-};
-type OutputDirectoryFileOperations = Pick<typeof fs, 'rename' | 'rm'>;
-declare function replaceOutputDirectory(stagingDir: string, outputDir: string, fileOperations?: OutputDirectoryFileOperations): Promise<void>;
-/**
- * Create a Static Site Generator
- *
- * Usage:
- * ```ts
- * const ssg = createStaticGen({
- *   routes: [
- *     { path: '/', component: HomePage },
- *     { path: '/about', component: AboutPage },
- *   ],
- *   outputDir: './dist',
- *   dataOverrides: {
- *     '/api/posts': { posts: [...] }
- *   }
- * });
- *
- * const result = await ssg.generate();
- * console.log(`Generated ${result.successful}/${result.totalRoutes} routes`);
- * ```
- */
-declare function createStaticGen<const TRoutes extends readonly AnyRouteConfig[]>(options: Omit<SSGOptions<TRoutes>, 'routes' | 'registry'> & StaticGenRouteSource<TRoutes>): {
-  /**
-   * Generate static HTML for all routes
-   * Writes to outputDir with metadata.json
-   * Returns detailed results
-   */
-  generate(generateOptions?: SSGGenerateOptions): Promise<SSGResult>;
-  /**
-   * Get effective config in a serializable form for diagnostics.
-   */
-  getConfig(): {
-    routeCount: number;
-    outputDir: string;
-    seed: number;
-    concurrency: number;
-    parallelism: number;
-    hasDataOverrides: boolean;
-  };
-  /**
-   * Get the last generation result
-   * Returns null if generate() hasn't been called
-   */
-  getResult(): SSGResult | null;
-};
-//#endregion
-export { createStaticGen };