@askrjs/askr 0.0.48 → 0.0.50

package/dist/data/mutation-cell.js

@@ -0,0 +1,132 @@
+import { recordReadableRead } from "../runtime/readable.js";
+import { claimHookIndex, getCurrentComponentInstance } from "../runtime/component-scope.js";
+import "../runtime/component.js";
+import { ensureMutationCleanup, getMutationSlotStore, invalidateQueriesForRuntime, resolveDataRuntimeState } from "./data-runtime.js";
+import { createReadableSource, isAbortError, normalizeAsyncDataError, notifySource } from "./shared.js";
+//#region src/data/mutation-cell.ts
+var MutationCell = class {
+	constructor(options, runtimeState) {
+		this.source = createReadableSource();
+		this.controller = null;
+		this.generation = 0;
+		this.state = {
+			status: "idle",
+			error: null,
+			result: null
+		};
+		this.runtimeState = runtimeState;
+		this.action = options.action;
+		this.affects = options.affects;
+		this.afterSuccess = options.afterSuccess;
+	}
+	setOptions(options) {
+		this.action = options.action;
+		this.affects = options.affects;
+		this.afterSuccess = options.afterSuccess;
+	}
+	get status() {
+		recordReadableRead(this.source);
+		return this.state.status;
+	}
+	get pending() {
+		recordReadableRead(this.source);
+		return this.state.status === "pending";
+	}
+	get error() {
+		recordReadableRead(this.source);
+		return this.state.error;
+	}
+	get result() {
+		recordReadableRead(this.source);
+		return this.state.result;
+	}
+	setState(next) {
+		this.state = {
+			...this.state,
+			...next
+		};
+		notifySource(this.source);
+	}
+	async execute(input) {
+		this.generation += 1;
+		const generation = this.generation;
+		this.controller?.abort();
+		const controller = new AbortController();
+		this.controller = controller;
+		this.setState({
+			status: "pending",
+			error: null,
+			result: null
+		});
+		let result;
+		try {
+			result = await this.action(input, { signal: controller.signal });
+		} catch (error) {
+			if (this.generation !== generation || this.controller !== controller) throw error;
+			if (isAbortError(error, controller.signal)) {
+				this.setState({
+					status: "idle",
+					error: null
+				});
+				throw error;
+			}
+			this.setState({
+				status: "error",
+				error: normalizeAsyncDataError(error, "Unknown mutation error")
+			});
+			throw error;
+		}
+		if (this.generation !== generation || this.controller !== controller) return result;
+		this.setState({
+			status: "success",
+			error: null,
+			result
+		});
+		if (this.afterSuccess === "invalidate") {
+			const prefixes = this.affects?.(input, result) ?? [];
+			for (const prefix of new Set(prefixes)) invalidateQueriesForRuntime(this.runtimeState, prefix, true);
+		}
+		return result;
+	}
+	abort() {
+		if (this.state.status !== "pending") return;
+		this.generation += 1;
+		this.controller?.abort();
+		this.controller = null;
+		this.setState({
+			status: "idle",
+			error: null,
+			result: null
+		});
+	}
+	reset() {
+		this.generation += 1;
+		this.controller?.abort();
+		this.controller = null;
+		this.setState({
+			status: "idle",
+			error: null,
+			result: null
+		});
+	}
+};
+function createMutation(options) {
+	const instance = getCurrentComponentInstance();
+	const runtimeState = resolveDataRuntimeState(options.runtime);
+	if (!instance) return new MutationCell(options, runtimeState);
+	const hookIndex = claimHookIndex(instance, "mutation");
+	ensureMutationCleanup(runtimeState, instance);
+	const slotStore = getMutationSlotStore(runtimeState, instance);
+	const existing = slotStore.get(hookIndex);
+	if (existing) {
+		existing.setOptions(options);
+		return existing;
+	}
+	const created = new MutationCell(options, runtimeState);
+	slotStore.set(hookIndex, created);
+	return created;
+}
+//#endregion
+export { MutationCell, createMutation };
+
+//# sourceMappingURL=mutation-cell.js.map

package/dist/data/mutation-cell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-cell.js","names":[],"sources":["../../src/data/mutation-cell.ts"],"sourcesContent":["import {\n  claimHookIndex,\n  getCurrentComponentInstance,\n} from '../runtime/component';\nimport { recordReadableRead } from '../runtime/readable';\nimport {\n  ensureMutationCleanup,\n  getMutationSlotStore,\n  invalidateQueriesForRuntime,\n  resolveDataRuntimeState,\n  type DataRuntimeState,\n} from './data-runtime';\nimport {\n  createReadableSource,\n  isAbortError,\n  normalizeAsyncDataError,\n  notifySource,\n} from './shared';\nimport type { Mutation, MutationOptions, MutationRecord } from './types';\n\nexport class MutationCell<TInput, TResult> {\n  private readonly source = createReadableSource();\n  private readonly runtimeState: DataRuntimeState;\n  private action: MutationOptions<TInput, TResult>['action'];\n  private affects?: MutationOptions<TInput, TResult>['affects'];\n  private afterSuccess?: MutationOptions<TInput, TResult>['afterSuccess'];\n  private controller: AbortController | null = null;\n  private generation = 0;\n\n  private state: MutationRecord<TResult> = {\n    status: 'idle',\n    error: null,\n    result: null,\n  };\n\n  constructor(\n    options: MutationOptions<TInput, TResult>,\n    runtimeState: DataRuntimeState\n  ) {\n    this.runtimeState = runtimeState;\n    this.action = options.action;\n    this.affects = options.affects;\n    this.afterSuccess = options.afterSuccess;\n  }\n\n  setOptions(options: MutationOptions<TInput, TResult>): void {\n    this.action = options.action;\n    this.affects = options.affects;\n    this.afterSuccess = options.afterSuccess;\n  }\n\n  get status(): 'idle' | 'pending' | 'success' | 'error' {\n    recordReadableRead(this.source);\n    return this.state.status;\n  }\n\n  get pending(): boolean {\n    recordReadableRead(this.source);\n    return this.state.status === 'pending';\n  }\n\n  get error(): {} | null {\n    recordReadableRead(this.source);\n    return this.state.error;\n  }\n\n  get result(): TResult | null {\n    recordReadableRead(this.source);\n    return this.state.result;\n  }\n\n  private setState(next: Partial<MutationRecord<TResult>>): void {\n    this.state = {\n      ...this.state,\n      ...next,\n    };\n    notifySource(this.source);\n  }\n\n  async execute(input: TInput): Promise<TResult> {\n    this.generation += 1;\n    const generation = this.generation;\n\n    this.controller?.abort();\n    const controller = new AbortController();\n    this.controller = controller;\n\n    this.setState({ status: 'pending', error: null, result: null });\n\n    let result: TResult;\n    try {\n      result = await this.action(input, { signal: controller.signal });\n    } catch (error) {\n      if (this.generation !== generation || this.controller !== controller) {\n        throw error;\n      }\n\n      if (isAbortError(error, controller.signal)) {\n        this.setState({ status: 'idle', error: null });\n        throw error;\n      }\n\n      this.setState({\n        status: 'error',\n        error: normalizeAsyncDataError(error, 'Unknown mutation error'),\n      });\n      throw error;\n    }\n\n    if (this.generation !== generation || this.controller !== controller) {\n      return result;\n    }\n\n    this.setState({ status: 'success', error: null, result });\n\n    if (this.afterSuccess === 'invalidate') {\n      const prefixes = this.affects?.(input, result) ?? [];\n      for (const prefix of new Set(prefixes)) {\n        invalidateQueriesForRuntime(this.runtimeState, prefix, true);\n      }\n    }\n\n    return result;\n  }\n\n  abort(): void {\n    if (this.state.status !== 'pending') {\n      return;\n    }\n\n    this.generation += 1;\n    this.controller?.abort();\n    this.controller = null;\n    this.setState({ status: 'idle', error: null, result: null });\n  }\n\n  reset(): void {\n    this.generation += 1;\n    this.controller?.abort();\n    this.controller = null;\n    this.setState({ status: 'idle', error: null, result: null });\n  }\n}\n\nexport function createMutation<TInput, TResult>(\n  options: MutationOptions<TInput, TResult>\n): Mutation<TInput, TResult> {\n  const instance = getCurrentComponentInstance();\n  const runtimeState = resolveDataRuntimeState(options.runtime);\n\n  if (!instance) {\n    return new MutationCell(options, runtimeState) as unknown as Mutation<\n      TInput,\n      TResult\n    >;\n  }\n\n  const hookIndex = claimHookIndex(instance, 'mutation');\n  ensureMutationCleanup(runtimeState, instance);\n\n  const slotStore = getMutationSlotStore(runtimeState, instance);\n  const existing = slotStore.get(hookIndex) as\n    | MutationCell<TInput, TResult>\n    | undefined;\n  if (existing) {\n    existing.setOptions(options);\n    return existing as unknown as Mutation<TInput, TResult>;\n  }\n\n  const created = new MutationCell(options, runtimeState);\n  slotStore.set(hookIndex, created as MutationCell<unknown, unknown>);\n  return created as unknown as Mutation<TInput, TResult>;\n}\n"],"mappings":"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"}

package/dist/data/query-cell.d.ts

@@ -0,0 +1,46 @@
+import { ComponentInstance } from "../runtime/component-internal.js";
+import { Query, QueryOptions, QueryState } from "./types.js";
+
+//#region src/data/query-cell.d.ts
+declare class QueryCell<T> {
+  private readonly source;
+  private readonly key;
+  private readonly cache;
+  private options;
+  private controller;
+  private generation;
+  private startQueued;
+  private pendingRefresh;
+  private pendingRefreshResolve;
+  private reconcileAttemptCount;
+  private destroyed;
+  private ownerCount;
+  private readonly owners;
+  private readonly warnedDefinitionConflictKeys;
+  private state;
+  constructor(options: QueryOptions<T>, key: string, cache: Map<string, QueryCell<unknown>>);
+  attach(instance: ComponentInstance, hookIndex: number): void;
+  detach(instance: ComponentInstance, hookIndex: number): void;
+  warnOnConflictingDefinition(options: QueryOptions<T>): void;
+  private destroy;
+  private getDefinitionConflicts;
+  get data(): T | null;
+  get error(): {} | null;
+  get loading(): boolean;
+  get refreshing(): boolean;
+  get stale(): boolean;
+  get consistency(): QueryState<T>['consistency'];
+  get staleReason(): QueryState<T>['staleReason'];
+  ensureStarted(): void;
+  refresh(): Promise<void>;
+  markPendingWrite(): void;
+  private queueStart;
+  private finishPendingRefresh;
+  private setState;
+  private start;
+  private reconcile;
+}
+declare function createQuery<T extends {}>(options: QueryOptions<T>): Query<T>;
+//#endregion
+export { QueryCell, createQuery };
+//# sourceMappingURL=query-cell.d.ts.map

package/dist/data/query-cell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-cell.d.ts","names":[],"sources":["../../src/data/query-cell.ts"],"mappings":";;;;cA6Ba,SAAA;EAAA,iBACM,MAAA;EAAA,iBACA,GAAA;EAAA,iBACA,KAAA;EAAA,QACT,OAAA;EAAA,QACA,UAAA;EAAA,QACA,UAAA;EAAA,QACA,WAAA;EAAA,QACA,cAAA;EAAA,QACA,qBAAA;EAAA,QACA,qBAAA;EAAA,QACA,SAAA;EAAA,QACA,UAAA;EAAA,iBACS,MAAA;EAAA,iBACA,4BAAA;EAAA,QAET,KAAA;cAWN,OAAA,EAAS,YAAA,CAAa,CAAA,GACtB,GAAA,UACA,KAAA,EAAO,GAAA,SAAY,SAAA;EAOrB,MAAA,CAAO,QAAA,EAAU,iBAAA,EAAmB,SAAA;EAepC,MAAA,CAAO,QAAA,EAAU,iBAAA,EAAmB,SAAA;EAgBpC,2BAAA,CAA4B,OAAA,EAAS,YAAA,CAAa,CAAA;EAAA,QAyB1C,OAAA;EAAA,QAgBA,sBAAA;EAAA,IAoBJ,IAAA,IAAQ,CAAA;EAAA,IAKR,KAAA;EAAA,IAKA,OAAA;EAAA,IAKA,UAAA;EAAA,IAKA,KAAA;EAAA,IAKA,WAAA,IAAe,UAAA,CAAW,CAAA;EAAA,IAK1B,WAAA,IAAe,UAAA,CAAW,CAAA;EAK9B,aAAA;EAaA,OAAA,IAAW,OAAA;EAaX,gBAAA;EAAA,QAmBQ,UAAA;EAAA,QAuBA,oBAAA;EAAA,QAOA,QAAA;EAAA,QAYM,KAAA;EAAA,QA6GA,SAAA;AAAA;AAAA,iBA6BA,WAAA,eAA0B,OAAA,EAAS,YAAA,CAAa,CAAA,IAAK,KAAA,CAAM,CAAA"}

package/dist/data/query-cell.js

@@ -0,0 +1,290 @@
+import { logger } from "../dev/logger.js";
+import { enqueueRuntimeTask } from "../runtime/access.js";
+import { recordReadableRead } from "../runtime/readable.js";
+import { claimHookIndex, getCurrentComponentInstance } from "../runtime/component-scope.js";
+import "../runtime/component.js";
+import { ensureQueryCleanup, getQuerySlotStore, resolveDataRuntimeState } from "./data-runtime.js";
+import { createReadableSource, isAbortError, normalizeAsyncDataError, notifySource } from "./shared.js";
+//#region src/data/query-cell.ts
+const RECONCILE_MAX_ATTEMPTS = 3;
+const RECONCILE_RETRY_DELAY_MS = 25;
+var QueryCell = class {
+	constructor(options, key, cache) {
+		this.source = createReadableSource();
+		this.controller = null;
+		this.generation = 0;
+		this.startQueued = false;
+		this.pendingRefresh = null;
+		this.pendingRefreshResolve = null;
+		this.reconcileAttemptCount = 0;
+		this.destroyed = false;
+		this.ownerCount = 0;
+		this.owners = /* @__PURE__ */ new Map();
+		this.warnedDefinitionConflictKeys = /* @__PURE__ */ new Set();
+		this.state = {
+			data: null,
+			error: null,
+			loading: true,
+			refreshing: false,
+			stale: false,
+			consistency: "fresh",
+			staleReason: null
+		};
+		this.options = options;
+		this.key = key;
+		this.cache = cache;
+	}
+	attach(instance, hookIndex) {
+		let hooks = this.owners.get(instance);
+		if (!hooks) {
+			hooks = /* @__PURE__ */ new Set();
+			this.owners.set(instance, hooks);
+		}
+		if (hooks.has(hookIndex)) return;
+		hooks.add(hookIndex);
+		this.ownerCount += 1;
+	}
+	detach(instance, hookIndex) {
+		const hooks = this.owners.get(instance);
+		if (!hooks || !hooks.delete(hookIndex)) return;
+		this.ownerCount -= 1;
+		if (hooks.size === 0) this.owners.delete(instance);
+		if (this.ownerCount <= 0) this.destroy();
+	}
+	warnOnConflictingDefinition(options) {
+		const conflicts = this.getDefinitionConflicts(options);
+		if (conflicts.length === 0) return;
+		const conflictKey = conflicts.join(",");
+		if (this.warnedDefinitionConflictKeys.has(conflictKey)) return;
+		this.warnedDefinitionConflictKeys.add(conflictKey);
+		const callbackLabel = conflicts.length === 1 ? `callback \`${conflicts[0]}\`` : `callbacks ${conflicts.map((field) => `\`${field}\``).join(", ")}`;
+		logger.warn(`[askr] Conflicting shared query definition for key "${this.key}". Shared queries are canonical by key, so reuse the same ${callbackLabel} for every reader of that key.`);
+	}
+	destroy() {
+		if (this.destroyed) return;
+		this.destroyed = true;
+		this.controller?.abort();
+		this.controller = null;
+		this.startQueued = false;
+		this.reconcileAttemptCount = 0;
+		this.ownerCount = 0;
+		this.owners.clear();
+		this.cache.delete(this.key);
+		this.finishPendingRefresh();
+	}
+	getDefinitionConflicts(options) {
+		const conflicts = [];
+		if (this.options.fetch !== options.fetch) conflicts.push("fetch");
+		if (this.options.isConsistent !== options.isConsistent) conflicts.push("isConsistent");
+		if (this.options.reconcile !== options.reconcile) conflicts.push("reconcile");
+		return conflicts;
+	}
+	get data() {
+		recordReadableRead(this.source);
+		return this.state.data;
+	}
+	get error() {
+		recordReadableRead(this.source);
+		return this.state.error;
+	}
+	get loading() {
+		recordReadableRead(this.source);
+		return this.state.loading;
+	}
+	get refreshing() {
+		recordReadableRead(this.source);
+		return this.state.refreshing;
+	}
+	get stale() {
+		recordReadableRead(this.source);
+		return this.state.stale;
+	}
+	get consistency() {
+		recordReadableRead(this.source);
+		return this.state.consistency;
+	}
+	get staleReason() {
+		recordReadableRead(this.source);
+		return this.state.staleReason;
+	}
+	ensureStarted() {
+		if (this.destroyed || this.state.data !== null || this.pendingRefresh || this.startQueued) return;
+		this.queueStart("initial");
+	}
+	refresh() {
+		if (this.destroyed) return Promise.resolve();
+		if (this.pendingRefresh) return this.pendingRefresh;
+		this.queueStart("manual");
+		return this.pendingRefresh ?? Promise.resolve();
+	}
+	markPendingWrite() {
+		if (this.destroyed) return;
+		if (this.state.data === null) return;
+		this.setState({
+			loading: false,
+			error: null,
+			refreshing: true,
+			stale: true,
+			consistency: "pending-write",
+			staleReason: null
+		});
+	}
+	queueStart(reason) {
+		if (this.destroyed) return;
+		this.startQueued = true;
+		this.pendingRefresh = new Promise((resolve) => {
+			this.pendingRefreshResolve = resolve;
+			enqueueRuntimeTask(() => {
+				this.startQueued = false;
+				if (this.destroyed) {
+					this.finishPendingRefresh();
+					return;
+				}
+				this.start(reason).finally(() => {
+					this.finishPendingRefresh();
+				});
+			});
+		});
+	}
+	finishPendingRefresh() {
+		const resolve = this.pendingRefreshResolve;
+		this.pendingRefresh = null;
+		this.pendingRefreshResolve = null;
+		resolve?.();
+	}
+	setState(next) {
+		if (this.destroyed) return;
+		this.state = {
+			...this.state,
+			...next
+		};
+		notifySource(this.source);
+	}
+	async start(reason) {
+		if (this.destroyed) return;
+		this.generation += 1;
+		const generation = this.generation;
+		this.controller?.abort();
+		const controller = new AbortController();
+		this.controller = controller;
+		const hasData = this.state.data !== null;
+		this.setState({
+			loading: !hasData,
+			refreshing: hasData,
+			stale: hasData,
+			consistency: reason === "pending-write" ? "pending-write" : hasData ? "refreshing" : "fresh",
+			error: null,
+			staleReason: null
+		});
+		let nextData;
+		try {
+			nextData = await this.options.fetch({ signal: controller.signal });
+		} catch (error) {
+			if (this.destroyed || this.generation !== generation || this.controller !== controller) return;
+			if (isAbortError(error, controller.signal)) {
+				this.setState(hasData ? {
+					loading: false,
+					refreshing: false,
+					stale: true,
+					consistency: "stale",
+					error: null,
+					staleReason: "aborted"
+				} : {
+					loading: true,
+					refreshing: false,
+					stale: false,
+					consistency: "fresh",
+					error: null,
+					staleReason: null
+				});
+				return;
+			}
+			this.setState({
+				loading: false,
+				refreshing: false,
+				stale: true,
+				consistency: "stale",
+				error: normalizeAsyncDataError(error, "Unknown query error"),
+				staleReason: "error"
+			});
+			return;
+		}
+		if (this.destroyed || this.generation !== generation || this.controller !== controller) return;
+		if (!(this.options.isConsistent?.(nextData) ?? true)) {
+			this.setState({
+				data: nextData,
+				loading: false,
+				refreshing: false,
+				stale: true,
+				consistency: "stale",
+				staleReason: "inconsistent"
+			});
+			await this.reconcile(nextData);
+			return;
+		}
+		this.reconcileAttemptCount = 0;
+		this.setState({
+			data: nextData,
+			loading: false,
+			refreshing: false,
+			stale: false,
+			consistency: "fresh",
+			error: null,
+			staleReason: null
+		});
+	}
+	async reconcile(data) {
+		if (!(this.options.reconcile?.(data, { key: this.options.key }) ?? false) || this.destroyed) return;
+		this.reconcileAttemptCount += 1;
+		if (this.reconcileAttemptCount > RECONCILE_MAX_ATTEMPTS) {
+			this.setState({
+				consistency: "stale",
+				refreshing: false,
+				staleReason: "inconsistent"
+			});
+			return;
+		}
+		await new Promise((resolve) => setTimeout(resolve, RECONCILE_RETRY_DELAY_MS));
+		if (this.destroyed || this.state.consistency === "fresh") return;
+		await this.refresh();
+	}
+};
+function createQuery(options) {
+	const instance = getCurrentComponentInstance();
+	const runtimeState = resolveDataRuntimeState(options.runtime);
+	const cache = runtimeState.queryCache;
+	if (!instance) {
+		let cell = cache.get(options.key);
+		if (!cell) {
+			cell = new QueryCell(options, options.key, cache);
+			cache.set(options.key, cell);
+			cell.ensureStarted();
+		} else cell.warnOnConflictingDefinition(options);
+		return cell;
+	}
+	const hookIndex = claimHookIndex(instance, "query");
+	ensureQueryCleanup(runtimeState, instance);
+	const slotStore = getQuerySlotStore(runtimeState, instance);
+	const existingSlot = slotStore.get(hookIndex);
+	if (existingSlot && existingSlot.key === options.key) {
+		existingSlot.cell.warnOnConflictingDefinition(options);
+		return existingSlot.cell;
+	}
+	if (existingSlot) existingSlot.cell.detach(instance, hookIndex);
+	let cell = cache.get(options.key);
+	if (!cell) {
+		cell = new QueryCell(options, options.key, cache);
+		cache.set(options.key, cell);
+		cell.ensureStarted();
+	} else cell.warnOnConflictingDefinition(options);
+	slotStore.set(hookIndex, {
+		key: options.key,
+		cell
+	});
+	cell.attach(instance, hookIndex);
+	return cell;
+}
+//#endregion
+export { QueryCell, createQuery };
+
+//# sourceMappingURL=query-cell.js.map

package/dist/data/query-cell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-cell.js","names":[],"sources":["../../src/data/query-cell.ts"],"sourcesContent":["import { logger } from '../dev/logger';\nimport { enqueueRuntimeTask } from '../runtime/access';\nimport {\n  claimHookIndex,\n  getCurrentComponentInstance,\n  type ComponentInstance,\n} from '../runtime/component';\nimport { recordReadableRead } from '../runtime/readable';\nimport {\n  ensureQueryCleanup,\n  getQuerySlotStore,\n  resolveDataRuntimeState,\n} from './data-runtime';\nimport {\n  createReadableSource,\n  isAbortError,\n  normalizeAsyncDataError,\n  notifySource,\n} from './shared';\nimport type {\n  Query,\n  QueryDefinitionField,\n  QueryOptions,\n  QueryState,\n} from './types';\n\nconst RECONCILE_MAX_ATTEMPTS = 3;\nconst RECONCILE_RETRY_DELAY_MS = 25;\n\nexport class QueryCell<T> {\n  private readonly source = createReadableSource();\n  private readonly key: string;\n  private readonly cache: Map<string, QueryCell<unknown>>;\n  private options: QueryOptions<T>;\n  private controller: AbortController | null = null;\n  private generation = 0;\n  private startQueued = false;\n  private pendingRefresh: Promise<void> | null = null;\n  private pendingRefreshResolve: (() => void) | null = null;\n  private reconcileAttemptCount = 0;\n  private destroyed = false;\n  private ownerCount = 0;\n  private readonly owners = new Map<ComponentInstance, Set<number>>();\n  private readonly warnedDefinitionConflictKeys = new Set<string>();\n\n  private state: QueryState<T> = {\n    data: null,\n    error: null,\n    loading: true,\n    refreshing: false,\n    stale: false,\n    consistency: 'fresh',\n    staleReason: null,\n  };\n\n  constructor(\n    options: QueryOptions<T>,\n    key: string,\n    cache: Map<string, QueryCell<unknown>>\n  ) {\n    this.options = options;\n    this.key = key;\n    this.cache = cache;\n  }\n\n  attach(instance: ComponentInstance, hookIndex: number): void {\n    let hooks = this.owners.get(instance);\n    if (!hooks) {\n      hooks = new Set();\n      this.owners.set(instance, hooks);\n    }\n\n    if (hooks.has(hookIndex)) {\n      return;\n    }\n\n    hooks.add(hookIndex);\n    this.ownerCount += 1;\n  }\n\n  detach(instance: ComponentInstance, hookIndex: number): void {\n    const hooks = this.owners.get(instance);\n    if (!hooks || !hooks.delete(hookIndex)) {\n      return;\n    }\n\n    this.ownerCount -= 1;\n    if (hooks.size === 0) {\n      this.owners.delete(instance);\n    }\n\n    if (this.ownerCount <= 0) {\n      this.destroy();\n    }\n  }\n\n  warnOnConflictingDefinition(options: QueryOptions<T>): void {\n    const conflicts = this.getDefinitionConflicts(options);\n    if (conflicts.length === 0) {\n      return;\n    }\n\n    const conflictKey = conflicts.join(',');\n    if (this.warnedDefinitionConflictKeys.has(conflictKey)) {\n      return;\n    }\n\n    this.warnedDefinitionConflictKeys.add(conflictKey);\n\n    const callbackLabel =\n      conflicts.length === 1\n        ? `callback \\`${conflicts[0]}\\``\n        : `callbacks ${conflicts.map((field) => `\\`${field}\\``).join(', ')}`;\n\n    logger.warn(\n      `[askr] Conflicting shared query definition for key \"${this.key}\". ` +\n        `Shared queries are canonical by key, so reuse the same ${callbackLabel} ` +\n        'for every reader of that key.'\n    );\n  }\n\n  private destroy(): void {\n    if (this.destroyed) {\n      return;\n    }\n\n    this.destroyed = true;\n    this.controller?.abort();\n    this.controller = null;\n    this.startQueued = false;\n    this.reconcileAttemptCount = 0;\n    this.ownerCount = 0;\n    this.owners.clear();\n    this.cache.delete(this.key);\n    this.finishPendingRefresh();\n  }\n\n  private getDefinitionConflicts(\n    options: QueryOptions<T>\n  ): QueryDefinitionField[] {\n    const conflicts: QueryDefinitionField[] = [];\n\n    if (this.options.fetch !== options.fetch) {\n      conflicts.push('fetch');\n    }\n\n    if (this.options.isConsistent !== options.isConsistent) {\n      conflicts.push('isConsistent');\n    }\n\n    if (this.options.reconcile !== options.reconcile) {\n      conflicts.push('reconcile');\n    }\n\n    return conflicts;\n  }\n\n  get data(): T | null {\n    recordReadableRead(this.source);\n    return this.state.data;\n  }\n\n  get error(): {} | null {\n    recordReadableRead(this.source);\n    return this.state.error;\n  }\n\n  get loading(): boolean {\n    recordReadableRead(this.source);\n    return this.state.loading;\n  }\n\n  get refreshing(): boolean {\n    recordReadableRead(this.source);\n    return this.state.refreshing;\n  }\n\n  get stale(): boolean {\n    recordReadableRead(this.source);\n    return this.state.stale;\n  }\n\n  get consistency(): QueryState<T>['consistency'] {\n    recordReadableRead(this.source);\n    return this.state.consistency;\n  }\n\n  get staleReason(): QueryState<T>['staleReason'] {\n    recordReadableRead(this.source);\n    return this.state.staleReason;\n  }\n\n  ensureStarted(): void {\n    if (\n      this.destroyed ||\n      this.state.data !== null ||\n      this.pendingRefresh ||\n      this.startQueued\n    ) {\n      return;\n    }\n\n    this.queueStart('initial');\n  }\n\n  refresh(): Promise<void> {\n    if (this.destroyed) {\n      return Promise.resolve();\n    }\n\n    if (this.pendingRefresh) {\n      return this.pendingRefresh;\n    }\n\n    this.queueStart('manual');\n    return this.pendingRefresh ?? Promise.resolve();\n  }\n\n  markPendingWrite(): void {\n    if (this.destroyed) {\n      return;\n    }\n\n    if (this.state.data === null) {\n      return;\n    }\n\n    this.setState({\n      loading: false,\n      error: null,\n      refreshing: true,\n      stale: true,\n      consistency: 'pending-write',\n      staleReason: null,\n    });\n  }\n\n  private queueStart(\n    reason: 'initial' | 'manual' | 'invalidate' | 'pending-write'\n  ): void {\n    if (this.destroyed) {\n      return;\n    }\n\n    this.startQueued = true;\n    this.pendingRefresh = new Promise<void>((resolve) => {\n      this.pendingRefreshResolve = resolve;\n      enqueueRuntimeTask(() => {\n        this.startQueued = false;\n        if (this.destroyed) {\n          this.finishPendingRefresh();\n          return;\n        }\n        void this.start(reason).finally(() => {\n          this.finishPendingRefresh();\n        });\n      });\n    });\n  }\n\n  private finishPendingRefresh(): void {\n    const resolve = this.pendingRefreshResolve;\n    this.pendingRefresh = null;\n    this.pendingRefreshResolve = null;\n    resolve?.();\n  }\n\n  private setState(next: Partial<QueryState<T>>): void {\n    if (this.destroyed) {\n      return;\n    }\n\n    this.state = {\n      ...this.state,\n      ...next,\n    };\n    notifySource(this.source);\n  }\n\n  private async start(\n    reason: 'initial' | 'manual' | 'invalidate' | 'pending-write'\n  ): Promise<void> {\n    if (this.destroyed) {\n      return;\n    }\n\n    this.generation += 1;\n    const generation = this.generation;\n\n    this.controller?.abort();\n    const controller = new AbortController();\n    this.controller = controller;\n\n    const hasData = this.state.data !== null;\n    this.setState({\n      loading: !hasData,\n      refreshing: hasData,\n      stale: hasData,\n      consistency:\n        reason === 'pending-write'\n          ? 'pending-write'\n          : hasData\n            ? 'refreshing'\n            : 'fresh',\n      error: null,\n      staleReason: null,\n    });\n\n    let nextData: T;\n    try {\n      nextData = await this.options.fetch({ signal: controller.signal });\n    } catch (error) {\n      if (\n        this.destroyed ||\n        this.generation !== generation ||\n        this.controller !== controller\n      ) {\n        return;\n      }\n\n      if (isAbortError(error, controller.signal)) {\n        this.setState(\n          hasData\n            ? {\n                loading: false,\n                refreshing: false,\n                stale: true,\n                consistency: 'stale',\n                error: null,\n                staleReason: 'aborted',\n              }\n            : {\n                loading: true,\n                refreshing: false,\n                stale: false,\n                consistency: 'fresh',\n                error: null,\n                staleReason: null,\n              }\n        );\n        return;\n      }\n\n      this.setState({\n        loading: false,\n        refreshing: false,\n        stale: true,\n        consistency: 'stale',\n        error: normalizeAsyncDataError(error, 'Unknown query error'),\n        staleReason: 'error',\n      });\n      return;\n    }\n\n    if (\n      this.destroyed ||\n      this.generation !== generation ||\n      this.controller !== controller\n    ) {\n      return;\n    }\n\n    const isConsistent = this.options.isConsistent?.(nextData) ?? true;\n    if (!isConsistent) {\n      this.setState({\n        data: nextData,\n        loading: false,\n        refreshing: false,\n        stale: true,\n        consistency: 'stale',\n        staleReason: 'inconsistent',\n      });\n      await this.reconcile(nextData);\n      return;\n    }\n\n    this.reconcileAttemptCount = 0;\n    this.setState({\n      data: nextData,\n      loading: false,\n      refreshing: false,\n      stale: false,\n      consistency: 'fresh',\n      error: null,\n      staleReason: null,\n    });\n  }\n\n  private async reconcile(data: T): Promise<void> {\n    const shouldRetry =\n      this.options.reconcile?.(data, { key: this.options.key }) ?? false;\n\n    if (!shouldRetry || this.destroyed) {\n      return;\n    }\n\n    this.reconcileAttemptCount += 1;\n    if (this.reconcileAttemptCount > RECONCILE_MAX_ATTEMPTS) {\n      this.setState({\n        consistency: 'stale',\n        refreshing: false,\n        staleReason: 'inconsistent',\n      });\n      return;\n    }\n\n    await new Promise<void>((resolve) =>\n      setTimeout(resolve, RECONCILE_RETRY_DELAY_MS)\n    );\n    if (this.destroyed || this.state.consistency === 'fresh') {\n      return;\n    }\n\n    await this.refresh();\n  }\n}\n\nexport function createQuery<T extends {}>(options: QueryOptions<T>): Query<T> {\n  const instance = getCurrentComponentInstance();\n  const runtimeState = resolveDataRuntimeState(options.runtime);\n  const cache = runtimeState.queryCache;\n  if (!instance) {\n    let cell = cache.get(options.key) as QueryCell<T> | undefined;\n    if (!cell) {\n      cell = new QueryCell(options, options.key, cache);\n      cache.set(options.key, cell as QueryCell<unknown>);\n      cell.ensureStarted();\n    } else {\n      cell.warnOnConflictingDefinition(options);\n    }\n    return cell as unknown as Query<T>;\n  }\n\n  const hookIndex = claimHookIndex(instance, 'query');\n  ensureQueryCleanup(runtimeState, instance);\n\n  const slotStore = getQuerySlotStore(runtimeState, instance);\n  const existingSlot = slotStore.get(hookIndex);\n  if (existingSlot && existingSlot.key === options.key) {\n    (existingSlot.cell as QueryCell<T>).warnOnConflictingDefinition(options);\n    return existingSlot.cell as unknown as Query<T>;\n  }\n\n  if (existingSlot) {\n    existingSlot.cell.detach(instance, hookIndex);\n  }\n\n  let cell = cache.get(options.key) as QueryCell<T> | undefined;\n  if (!cell) {\n    cell = new QueryCell(options, options.key, cache);\n    cache.set(options.key, cell as QueryCell<unknown>);\n    cell.ensureStarted();\n  } else {\n    cell.warnOnConflictingDefinition(options);\n  }\n\n  slotStore.set(hookIndex, {\n    key: options.key,\n    cell: cell as QueryCell<unknown>,\n  });\n  cell.attach(instance, hookIndex);\n  return cell as unknown as Query<T>;\n}\n"],"mappings":"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"}

package/dist/data/query-key.js

@@ -0,0 +1,42 @@
+//#region src/data/query-key.ts
+function serializeQueryKeyNumber(part) {
+	if (Number.isNaN(part)) return "NaN";
+	if (Object.is(part, -0)) return "-0";
+	if (part === Infinity) return "Infinity";
+	if (part === -Infinity) return "-Infinity";
+	return String(part);
+}
+function serializeQueryKeyPart(part) {
+	if (typeof part === "symbol") throw new Error("[Askr] queryScope() key parts cannot be symbols.");
+	if (part === null) return "null";
+	if (part === void 0) return "undefined";
+	switch (typeof part) {
+		case "string": return `s=${encodeURIComponent(part)}`;
+		case "number": return `n=${serializeQueryKeyNumber(part)}`;
+		case "boolean": return `b=${part ? "1" : "0"}`;
+		case "object":
+			if (Array.isArray(part)) return `a[${part.map((item) => serializeQueryKeyPart(item)).join(",")}]`;
+			const objectPart = part;
+			return `o{${Object.keys(objectPart).sort().map((key) => `${encodeURIComponent(key)}=${serializeQueryKeyPart(objectPart[key])}`).join(",")}}`;
+		default: return String(part);
+	}
+}
+function createQueryScope(namespace, invalidate) {
+	if (typeof namespace !== "string" || namespace.trim().length === 0) throw new Error("[Askr] queryScope() requires a non-empty namespace string.");
+	const build = (parts) => [namespace, ...parts].map(serializeQueryKeyPart).join(":") + ":";
+	return {
+		key(...parts) {
+			return build(parts);
+		},
+		prefix(...parts) {
+			return build(parts);
+		},
+		invalidate(parts, options) {
+			invalidate(build(parts), options);
+		}
+	};
+}
+//#endregion
+export { createQueryScope };
+
+//# sourceMappingURL=query-key.js.map

package/dist/data/query-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-key.js","names":[],"sources":["../../src/data/query-key.ts"],"sourcesContent":["import type { InvalidateOptions, QueryKeyPart, QueryScope } from './types';\n\ntype InvalidateQueryPrefix = (\n  prefix: string,\n  options?: InvalidateOptions\n) => void;\n\nfunction serializeQueryKeyNumber(part: number): string {\n  if (Number.isNaN(part)) {\n    return 'NaN';\n  }\n\n  if (Object.is(part, -0)) {\n    return '-0';\n  }\n\n  if (part === Infinity) {\n    return 'Infinity';\n  }\n\n  if (part === -Infinity) {\n    return '-Infinity';\n  }\n\n  return String(part);\n}\n\nfunction serializeQueryKeyPart(part: QueryKeyPart): string {\n  if (typeof (part as unknown) === 'symbol') {\n    throw new Error('[Askr] queryScope() key parts cannot be symbols.');\n  }\n\n  if (part === null) {\n    return 'null';\n  }\n\n  if (part === undefined) {\n    return 'undefined';\n  }\n\n  switch (typeof part) {\n    case 'string':\n      return `s=${encodeURIComponent(part)}`;\n    case 'number':\n      return `n=${serializeQueryKeyNumber(part)}`;\n    case 'boolean':\n      return `b=${part ? '1' : '0'}`;\n    case 'object':\n      if (Array.isArray(part)) {\n        return `a[${part.map((item) => serializeQueryKeyPart(item)).join(',')}]`;\n      }\n\n      const objectPart = part as { readonly [key: string]: QueryKeyPart };\n      return `o{${Object.keys(objectPart)\n        .sort()\n        .map(\n          (key) =>\n            `${encodeURIComponent(key)}=${serializeQueryKeyPart(objectPart[key])}`\n        )\n        .join(',')}}`;\n    default:\n      return String(part);\n  }\n}\n\nexport function createQueryScope(\n  namespace: string,\n  invalidate: InvalidateQueryPrefix\n): QueryScope {\n  if (typeof namespace !== 'string' || namespace.trim().length === 0) {\n    throw new Error(\n      '[Askr] queryScope() requires a non-empty namespace string.'\n    );\n  }\n\n  const build = (parts: readonly QueryKeyPart[]): string =>\n    [namespace, ...parts].map(serializeQueryKeyPart).join(':') + ':';\n\n  return {\n    key(...parts) {\n      return build(parts);\n    },\n\n    prefix(...parts) {\n      return build(parts);\n    },\n\n    invalidate(parts, options) {\n      invalidate(build(parts), options);\n    },\n  };\n}\n"],"mappings":";AAOA,SAAS,wBAAwB,MAAsB;CACrD,IAAI,OAAO,MAAM,IAAI,GACnB,OAAO;CAGT,IAAI,OAAO,GAAG,MAAM,EAAE,GACpB,OAAO;CAGT,IAAI,SAAS,UACX,OAAO;CAGT,IAAI,SAAS,WACX,OAAO;CAGT,OAAO,OAAO,IAAI;AACpB;AAEA,SAAS,sBAAsB,MAA4B;CACzD,IAAI,OAAQ,SAAqB,UAC/B,MAAM,IAAI,MAAM,kDAAkD;CAGpE,IAAI,SAAS,MACX,OAAO;CAGT,IAAI,SAAS,QACX,OAAO;CAGT,QAAQ,OAAO,MAAf;EACE,KAAK,UACH,OAAO,KAAK,mBAAmB,IAAI;EACrC,KAAK,UACH,OAAO,KAAK,wBAAwB,IAAI;EAC1C,KAAK,WACH,OAAO,KAAK,OAAO,MAAM;EAC3B,KAAK;GACH,IAAI,MAAM,QAAQ,IAAI,GACpB,OAAO,KAAK,KAAK,KAAK,SAAS,sBAAsB,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE;GAGxE,MAAM,aAAa;GACnB,OAAO,KAAK,OAAO,KAAK,UAAU,CAAC,CAChC,KAAK,CAAC,CACN,KACE,QACC,GAAG,mBAAmB,GAAG,EAAE,GAAG,sBAAsB,WAAW,IAAI,GACvE,CAAC,CACA,KAAK,GAAG,EAAE;EACf,SACE,OAAO,OAAO,IAAI;CACtB;AACF;AAEA,SAAgB,iBACd,WACA,YACY;CACZ,IAAI,OAAO,cAAc,YAAY,UAAU,KAAK,CAAC,CAAC,WAAW,GAC/D,MAAM,IAAI,MACR,4DACF;CAGF,MAAM,SAAS,UACb,CAAC,WAAW,GAAG,KAAK,CAAC,CAAC,IAAI,qBAAqB,CAAC,CAAC,KAAK,GAAG,IAAI;CAE/D,OAAO;EACL,IAAI,GAAG,OAAO;GACZ,OAAO,MAAM,KAAK;EACpB;EAEA,OAAO,GAAG,OAAO;GACf,OAAO,MAAM,KAAK;EACpB;EAEA,WAAW,OAAO,SAAS;GACzB,WAAW,MAAM,KAAK,GAAG,OAAO;EAClC;CACF;AACF"}

package/dist/data/shared.js

@@ -0,0 +1,20 @@
+import { markReactivePropsDirtySource, markReadableDerivedSubscribersDirty, notifyReadableReaders } from "../runtime/readable.js";
+//#region src/data/shared.ts
+function createReadableSource() {
+	return (() => void 0);
+}
+function notifySource(source) {
+	markReadableDerivedSubscribersDirty(source);
+	markReactivePropsDirtySource(source);
+	notifyReadableReaders(source);
+}
+function isAbortError(error, signal) {
+	return signal.aborted || error instanceof Error && error.name === "AbortError" || typeof DOMException !== "undefined" && error instanceof DOMException && error.name === "AbortError";
+}
+function normalizeAsyncDataError(error, fallbackMessage) {
+	return error ?? new Error(fallbackMessage);
+}
+//#endregion
+export { createReadableSource, isAbortError, normalizeAsyncDataError, notifySource };
+
+//# sourceMappingURL=shared.js.map

package/dist/data/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","names":[],"sources":["../../src/data/shared.ts"],"sourcesContent":["import {\n  markReadableDerivedSubscribersDirty,\n  markReactivePropsDirtySource,\n  notifyReadableReaders,\n  type ReadableSource,\n} from '../runtime/readable';\n\nexport function createReadableSource(): ReadableSource<unknown> {\n  return (() => undefined) as ReadableSource<unknown>;\n}\n\nexport function notifySource(source: ReadableSource<unknown>): void {\n  markReadableDerivedSubscribersDirty(source);\n  markReactivePropsDirtySource(source);\n  notifyReadableReaders(source);\n}\n\nexport function isAbortError(error: unknown, signal: AbortSignal): boolean {\n  return (\n    signal.aborted ||\n    (error instanceof Error && error.name === 'AbortError') ||\n    (typeof DOMException !== 'undefined' &&\n      error instanceof DOMException &&\n      error.name === 'AbortError')\n  );\n}\n\nexport function normalizeAsyncDataError(\n  error: unknown,\n  fallbackMessage: string\n): {} {\n  return error ?? new Error(fallbackMessage);\n}\n"],"mappings":";;AAOA,SAAgB,uBAAgD;CAC9D,cAAc;AAChB;AAEA,SAAgB,aAAa,QAAuC;CAClE,oCAAoC,MAAM;CAC1C,6BAA6B,MAAM;CACnC,sBAAsB,MAAM;AAC9B;AAEA,SAAgB,aAAa,OAAgB,QAA8B;CACzE,OACE,OAAO,WACN,iBAAiB,SAAS,MAAM,SAAS,gBACzC,OAAO,iBAAiB,eACvB,iBAAiB,gBACjB,MAAM,SAAS;AAErB;AAEA,SAAgB,wBACd,OACA,iBACI;CACJ,OAAO,SAAS,IAAI,MAAM,eAAe;AAC3C"}