@askrjs/askr 0.0.42 → 0.0.43

package/dist/testing/index.js

@@ -0,0 +1,172 @@
+import { parseSegments } from "../router/match.js";
+import { computeRouteActivityMatches } from "../router/route.js";
+import { addInvalidationListener } from "../data/invalidation-listeners.js";
+//#region src/testing/index.ts
+function normalizeRefresh(options) {
+	return async () => {
+		await options?.refresh?.();
+	};
+}
+function makeQuery(state, options) {
+	return {
+		...state,
+		refresh: normalizeRefresh(options)
+	};
+}
+function createFreshQuery(data, options) {
+	return makeQuery({
+		data,
+		error: null,
+		loading: false,
+		refreshing: false,
+		stale: false,
+		consistency: "fresh",
+		staleReason: null
+	}, options);
+}
+const mockQuery = Object.assign(createFreshQuery, {
+	loading(options) {
+		return makeQuery({
+			data: null,
+			error: null,
+			loading: true,
+			refreshing: false,
+			stale: false,
+			consistency: "fresh",
+			staleReason: null
+		}, options);
+	},
+	error(error, previousData, options) {
+		return makeQuery({
+			data: previousData ?? null,
+			error,
+			loading: false,
+			refreshing: false,
+			stale: true,
+			consistency: "stale",
+			staleReason: "error"
+		}, options);
+	},
+	refreshing(data, options) {
+		return makeQuery({
+			data,
+			error: null,
+			loading: false,
+			refreshing: true,
+			stale: true,
+			consistency: "refreshing",
+			staleReason: null
+		}, options);
+	},
+	stale(data, reason = "inconsistent", options) {
+		return makeQuery({
+			data,
+			error: null,
+			loading: false,
+			refreshing: false,
+			stale: true,
+			consistency: "stale",
+			staleReason: reason
+		}, options);
+	},
+	pendingWrite(data, options) {
+		return makeQuery({
+			data,
+			error: null,
+			loading: false,
+			refreshing: true,
+			stale: true,
+			consistency: "pending-write",
+			staleReason: null
+		}, options);
+	}
+});
+const queryState = {
+	fresh: createFreshQuery,
+	loading: mockQuery.loading,
+	error: mockQuery.error,
+	refreshing: mockQuery.refreshing,
+	stale: mockQuery.stale,
+	pendingWrite: mockQuery.pendingWrite
+};
+function createInvalidationRecorder() {
+	const records = [];
+	let active = true;
+	const unsubscribe = addInvalidationListener((event) => {
+		records.push({
+			prefix: event.prefix,
+			markPendingWrite: event.markPendingWrite
+		});
+	});
+	return {
+		get calls() {
+			return records.slice();
+		},
+		get prefixes() {
+			return records.map((record) => record.prefix);
+		},
+		clear() {
+			records.length = 0;
+		},
+		stop() {
+			if (!active) return;
+			active = false;
+			unsubscribe();
+		}
+	};
+}
+function matchRoute(path, options = {}) {
+	return computeRouteActivityMatches(path, options)[0] ?? null;
+}
+function getRoutePatternRecords(options) {
+	if (options.manifest) return options.manifest.records.map((record) => ({
+		path: record.path,
+		segments: record.segments,
+		namespace: record.options.namespace
+	}));
+	return (options.routes ?? []).map((route) => ({
+		path: route.path,
+		segments: parseSegments(route.path),
+		namespace: route.namespace
+	}));
+}
+function routePrefixMatches(splatPrefix, routeSegments) {
+	if (routeSegments.length <= splatPrefix.length) return false;
+	for (let index = 0; index < splatPrefix.length; index++) {
+		const splatSegment = splatPrefix[index];
+		const routeSegment = routeSegments[index];
+		if (splatSegment.kind === "static" && routeSegment.kind === "static" && splatSegment.value !== routeSegment.value) return false;
+	}
+	return true;
+}
+function getRouteWarnings(options = {}) {
+	const records = getRoutePatternRecords(options);
+	const warnings = [];
+	for (const record of records) {
+		const splatIndex = record.segments.findIndex((segment) => segment.kind === "splat");
+		if (splatIndex === -1) continue;
+		const splatPrefix = record.segments.slice(0, splatIndex);
+		for (const candidate of records) {
+			if (candidate === record || candidate.namespace !== record.namespace || !routePrefixMatches(splatPrefix, candidate.segments)) continue;
+			const reservedSegment = candidate.segments[splatIndex];
+			if (reservedSegment?.kind !== "static") continue;
+			warnings.push({
+				kind: "route-collision",
+				path: record.path,
+				conflictingPath: candidate.path,
+				segment: reservedSegment.value,
+				namespace: record.namespace,
+				message: `Route "${candidate.path}" reserves segment "${reservedSegment.value}" under named splat route "${record.path}".`
+			});
+		}
+	}
+	return warnings.sort((left, right) => {
+		const pathOrder = left.path.localeCompare(right.path);
+		if (pathOrder !== 0) return pathOrder;
+		return left.conflictingPath.localeCompare(right.conflictingPath);
+	});
+}
+//#endregion
+export { createInvalidationRecorder, getRouteWarnings, matchRoute, mockQuery, queryState };
+
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/testing/index.ts"],"sourcesContent":["import type { Query, QueryStaleReason } from '../data';\nimport { parseSegments } from '../router/match';\nimport { computeRouteActivityMatches } from '../router/route';\nimport type {\n  ParsedSegment,\n  Route,\n  RouteManifest,\n  RouteMatch,\n  RouteRecord,\n} from '../common/router';\nimport {\n  addInvalidationListener,\n  type InvalidationEvent,\n} from '../data/invalidation-listeners';\n\nexport type MockRefresh = () => void | Promise<void>;\n\nexport interface MockQueryOptions {\n  refresh?: MockRefresh;\n}\n\nexport interface InvalidationRecord {\n  prefix: string;\n  markPendingWrite: boolean;\n}\n\nexport interface InvalidationRecorder {\n  readonly calls: readonly InvalidationRecord[];\n  readonly prefixes: readonly string[];\n  clear(): void;\n  stop(): void;\n}\n\ninterface MatchRouteOptions {\n  manifest?: RouteManifest;\n  routes?: readonly Route[];\n}\n\nexport interface RoutePatternWarning {\n  kind: 'route-collision';\n  path: string;\n  conflictingPath: string;\n  segment: string;\n  namespace: string | undefined;\n  message: string;\n}\n\ntype StaleValueReason = Exclude<QueryStaleReason, 'error'>;\n\nfunction normalizeRefresh(options?: MockQueryOptions): () => Promise<void> {\n  return async () => {\n    await options?.refresh?.();\n  };\n}\n\nfunction makeQuery<T extends {}>(\n  state: Omit<Query<T>, 'refresh'>,\n  options?: MockQueryOptions\n): Query<T> {\n  return {\n    ...state,\n    refresh: normalizeRefresh(options),\n  } as Query<T>;\n}\n\nfunction createFreshQuery<T extends {}>(\n  data: T,\n  options?: MockQueryOptions\n): Query<T> {\n  return makeQuery(\n    {\n      data,\n      error: null,\n      loading: false,\n      refreshing: false,\n      stale: false,\n      consistency: 'fresh',\n      staleReason: null,\n    },\n    options\n  );\n}\n\nexport const mockQuery = Object.assign(createFreshQuery, {\n  loading<T extends {} = {}>(options?: MockQueryOptions): Query<T> {\n    return makeQuery(\n      {\n        data: null,\n        error: null,\n        loading: true,\n        refreshing: false,\n        stale: false,\n        consistency: 'fresh',\n        staleReason: null,\n      },\n      options\n    );\n  },\n\n  error<T extends {} = {}>(\n    error: {},\n    previousData?: T,\n    options?: MockQueryOptions\n  ): Query<T> {\n    return makeQuery(\n      {\n        data: previousData ?? null,\n        error,\n        loading: false,\n        refreshing: false,\n        stale: true,\n        consistency: 'stale',\n        staleReason: 'error',\n      } as Omit<Query<T>, 'refresh'>,\n      options\n    );\n  },\n\n  refreshing<T extends {}>(data: T, options?: MockQueryOptions): Query<T> {\n    return makeQuery(\n      {\n        data,\n        error: null,\n        loading: false,\n        refreshing: true,\n        stale: true,\n        consistency: 'refreshing',\n        staleReason: null,\n      },\n      options\n    );\n  },\n\n  stale<T extends {}>(\n    data: T,\n    reason: StaleValueReason = 'inconsistent',\n    options?: MockQueryOptions\n  ): Query<T> {\n    return makeQuery(\n      {\n        data,\n        error: null,\n        loading: false,\n        refreshing: false,\n        stale: true,\n        consistency: 'stale',\n        staleReason: reason,\n      },\n      options\n    );\n  },\n\n  pendingWrite<T extends {}>(data: T, options?: MockQueryOptions): Query<T> {\n    return makeQuery(\n      {\n        data,\n        error: null,\n        loading: false,\n        refreshing: true,\n        stale: true,\n        consistency: 'pending-write',\n        staleReason: null,\n      },\n      options\n    );\n  },\n});\n\nexport const queryState = {\n  fresh: createFreshQuery,\n  loading: mockQuery.loading,\n  error: mockQuery.error,\n  refreshing: mockQuery.refreshing,\n  stale: mockQuery.stale,\n  pendingWrite: mockQuery.pendingWrite,\n};\n\nexport function createInvalidationRecorder(): InvalidationRecorder {\n  const records: InvalidationRecord[] = [];\n  let active = true;\n\n  const unsubscribe = addInvalidationListener((event: InvalidationEvent) => {\n    records.push({\n      prefix: event.prefix,\n      markPendingWrite: event.markPendingWrite,\n    });\n  });\n\n  return {\n    get calls() {\n      return records.slice();\n    },\n\n    get prefixes() {\n      return records.map((record) => record.prefix);\n    },\n\n    clear() {\n      records.length = 0;\n    },\n\n    stop() {\n      if (!active) {\n        return;\n      }\n\n      active = false;\n      unsubscribe();\n    },\n  };\n}\n\nexport function matchRoute(\n  path: string,\n  options: MatchRouteOptions = {}\n): RouteMatch | null {\n  return computeRouteActivityMatches(path, options)[0] ?? null;\n}\n\ntype RoutePatternRecord = {\n  path: string;\n  segments: ParsedSegment[];\n  namespace: string | undefined;\n};\n\nfunction getRoutePatternRecords(\n  options: MatchRouteOptions\n): RoutePatternRecord[] {\n  if (options.manifest) {\n    return options.manifest.records.map((record: RouteRecord) => ({\n      path: record.path,\n      segments: record.segments,\n      namespace: record.options.namespace,\n    }));\n  }\n\n  return (options.routes ?? []).map((route) => ({\n    path: route.path,\n    segments: parseSegments(route.path),\n    namespace: route.namespace,\n  }));\n}\n\nfunction routePrefixMatches(\n  splatPrefix: readonly ParsedSegment[],\n  routeSegments: readonly ParsedSegment[]\n): boolean {\n  if (routeSegments.length <= splatPrefix.length) {\n    return false;\n  }\n\n  for (let index = 0; index < splatPrefix.length; index++) {\n    const splatSegment = splatPrefix[index];\n    const routeSegment = routeSegments[index];\n\n    if (\n      splatSegment.kind === 'static' &&\n      routeSegment.kind === 'static' &&\n      splatSegment.value !== routeSegment.value\n    ) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nexport function getRouteWarnings(\n  options: MatchRouteOptions = {}\n): RoutePatternWarning[] {\n  const records = getRoutePatternRecords(options);\n  const warnings: RoutePatternWarning[] = [];\n\n  for (const record of records) {\n    const splatIndex = record.segments.findIndex(\n      (segment) => segment.kind === 'splat'\n    );\n    if (splatIndex === -1) {\n      continue;\n    }\n\n    const splatPrefix = record.segments.slice(0, splatIndex);\n    for (const candidate of records) {\n      if (\n        candidate === record ||\n        candidate.namespace !== record.namespace ||\n        !routePrefixMatches(splatPrefix, candidate.segments)\n      ) {\n        continue;\n      }\n\n      const reservedSegment = candidate.segments[splatIndex];\n      if (reservedSegment?.kind !== 'static') {\n        continue;\n      }\n\n      warnings.push({\n        kind: 'route-collision',\n        path: record.path,\n        conflictingPath: candidate.path,\n        segment: reservedSegment.value,\n        namespace: record.namespace,\n        message: `Route \"${candidate.path}\" reserves segment \"${reservedSegment.value}\" under named splat route \"${record.path}\".`,\n      });\n    }\n  }\n\n  return warnings.sort((left, right) => {\n    const pathOrder = left.path.localeCompare(right.path);\n    if (pathOrder !== 0) {\n      return pathOrder;\n    }\n    return left.conflictingPath.localeCompare(right.conflictingPath);\n  });\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askrjs/askr",
-  "version": "0.0.42",
+  "version": "0.0.43",
   "description": "Actor-backed deterministic UI framework",
   "keywords": [
     "askr",
@@ -80,6 +80,10 @@
       "import": "./dist/data/index.js",
       "types": "./dist/data/index.d.ts"
     },
+    "./testing": {
+      "import": "./dist/testing/index.js",
+      "types": "./dist/testing/index.d.ts"
+    },
     "./fx": {
       "import": "./dist/fx/index.js",
       "types": "./dist/fx/index.d.ts"
@@ -127,7 +131,7 @@
     "bench:tier4": "cross-env NODE_ENV=production vp test bench --run --reporter=default --config vitest.bench.tier4.config.ts"
   },
   "devDependencies": {
-    "@types/node": "^25.9.2",
+    "@types/node": "^25.9.3",
     "cross-env": "^10.1.0",
     "jsdom": "^29.1.1",
     "playwright": "^1.60.0",
@@ -145,5 +149,9 @@
   "engines": {
     "node": ">=18"
   },
-  "packageManager": "npm@11.16.0"
+  "packageManager": "npm@11.17.0",
+  "allowScripts": {
+    "fsevents@2.3.3": true,
+    "fsevents@2.3.2": true
+  }
 }