@askrjs/askr 0.3.0 → 0.4.0

package/dist/scope-Cq_iYbTR.js

@@ -1,403 +0,0 @@
-//#region src/runtime/ownership/record.ts
-/** One record per lifetime. Render and request revisions belong to execution
-* and requests respectively; neither replaces this identity on a rerender. */
-var OwnershipRecord = class {
-	constructor() {
-		this.identity = this;
-		this.disposed = false;
-		this.mounted = false;
-		this.controller = null;
-		this.hadScopedChildren = false;
-	}
-};
-/** A shared view surface populated only by the public compatibility adapter. */
-const componentRecordPrototype = {};
-const disposedSignal = (() => {
-	const controller = new AbortController();
-	controller.abort();
-	return controller.signal;
-})();
-function getOwnershipSignal(owner) {
-	if (owner.signal) return owner.signal;
-	if (owner.disposed) return disposedSignal;
-	owner.controller ??= new AbortController();
-	return owner.signal = owner.controller.signal;
-}
-function ownCleanup(owner, cleanup) {
-	if (owner.disposed) cleanup();
-	else (owner.cleanups ??= []).push(cleanup);
-}
-const scopedOwners = /* @__PURE__ */ new WeakMap();
-/** Index an existing native lifetime; scopes never receive another owner. */
-function registerScopedOwnership(scope, owner) {
-	owner.scope = scope;
-	scopedOwners.set(scope, owner);
-	if (owner.parent) {
-		owner.parent.hadScopedChildren = true;
-		owner.parent.scopedIndex?.add(scope);
-	}
-}
-function scopedOwnership(child) {
-	let lifetime = scopedOwners.get(child);
-	if (!lifetime) {
-		lifetime = new OwnershipRecord();
-		lifetime.cleanups = [() => child.dispose()];
-		registerScopedOwnership(child, lifetime);
-	}
-	return lifetime;
-}
-function ownChild(owner, child) {
-	attachOwnership(scopedOwnership(child), owner);
-}
-function releaseOwnedChild(owner, child) {
-	const lifetime = scopedOwners.get(child);
-	if (lifetime?.parent === owner) detachOwnership(lifetime);
-}
-function synchronizeScopedIndex(owner) {
-	const index = owner.scopedIndex;
-	for (let child = owner.head; child;) {
-		const next = child.next;
-		if (child.scope && !index?.has(child.scope)) detachOwnership(child);
-		child = next;
-	}
-	if (index) for (const scope of Set.prototype.values.call(index)) ownChild(owner, scope);
-}
-/** Compatibility collections are maintained indexes of the lifetime graph. */
-function getOwnedChildScopes(owner) {
-	if (!owner.hadScopedChildren) return void 0;
-	if (!owner.scopedIndex) {
-		owner.scopedIndex = /* @__PURE__ */ new Set();
-		if (owner.disposed) return owner.scopedIndex;
-		for (let child = owner.head; child; child = child.next) if (child.scope) owner.scopedIndex.add(child.scope);
-	}
-	return owner.scopedIndex;
-}
-function setOwnedChildScopes(owner, scopes) {
-	owner.scopedIndex = scopes;
-	owner.hadScopedChildren = scopes !== void 0;
-	synchronizeScopedIndex(owner);
-}
-function detachOwnedChildren(owner) {
-	while (owner.head) detachOwnership(owner.head);
-}
-/** Drain attachments within a composite cleanup before surfacing its failures. */
-function drainOwnedCleanup(items, cleanup) {
-	const errors = [];
-	for (const item of items) try {
-		cleanup(item);
-	} catch (error) {
-		errors.push(error);
-	}
-	if (errors.length) throw new AggregateError(errors, "Owned cleanup failed");
-}
-/** Detach the exact lifetime, independently of its execution record. */
-function detachOwnership(owner) {
-	const parent = owner.parent;
-	if (!parent) return;
-	if (owner.previous) owner.previous.next = owner.next;
-	else parent.head = owner.next;
-	if (owner.next) owner.next.previous = owner.previous;
-	else parent.tail = owner.previous;
-	if (owner.scope) parent.scopedIndex?.delete(owner.scope);
-	owner.parent = void 0;
-	owner.previous = void 0;
-	owner.next = void 0;
-}
-function attachOwnership(owner, parent) {
-	if (owner.parent === parent || owner.disposed) return;
-	if (parent === owner) throw new Error("[Askr] A lifetime cannot own itself.");
-	if (owner.head) {
-		for (let ancestor = parent; ancestor; ancestor = ancestor.parent) if (ancestor === owner) throw new Error("[Askr] Lifetime ownership cannot contain a cycle.");
-	}
-	detachOwnership(owner);
-	if (!parent) return;
-	if (parent.disposed) {
-		disposeOwnership(owner);
-		return;
-	}
-	linkOwnership(owner, parent);
-}
-function linkOwnership(owner, parent) {
-	owner.parent = parent;
-	owner.previous = parent.tail;
-	if (parent.tail) parent.tail.next = owner;
-	else parent.head = owner;
-	parent.tail = owner;
-	if (owner.scope) {
-		parent.hadScopedChildren = true;
-		parent.scopedIndex?.add(owner.scope);
-	}
-}
-function defaultDisposalPhases() {
-	const errors = [];
-	return {
-		recordError(_message, error) {
-			errors.push(error);
-		},
-		finish() {
-			if (errors.length) throw new AggregateError(errors, "Owned cleanup failed");
-		}
-	};
-}
-function attemptDisposal(frame, message, run) {
-	try {
-		run?.();
-	} catch (error) {
-		try {
-			frame.phases.recordError(message, error);
-		} catch (reportError) {
-			frame.unreported.push(reportError);
-		}
-	}
-}
-function prepareDisposal(owner, phases) {
-	const errors = [];
-	let scopes;
-	try {
-		if (owner.scopedIndex) synchronizeScopedIndex(owner);
-		if (owner.scopedIndex?.size) scopes = Set.prototype.values.call(owner.scopedIndex);
-	} catch (error) {
-		errors.push(error);
-		owner.scopedIndex = void 0;
-	}
-	owner.disposed = true;
-	detachOwnership(owner);
-	try {
-		phases ??= owner.lifecycle?.(owner);
-	} catch (error) {
-		errors.push(error);
-	}
-	const frame = {
-		owner,
-		phases: phases ?? defaultDisposalPhases(),
-		scopes,
-		unreported: errors
-	};
-	if (scopes) owner.scopedIndex = void 0;
-	attemptDisposal(frame, "[Askr] owner preparation threw:", frame.phases.begin);
-	return frame;
-}
-/** One iterative postorder drain for every lifetime, including deep chains. */
-function disposeOwnership(owner, phases) {
-	if (owner.disposed) return;
-	const stack = [prepareDisposal(owner, phases)];
-	while (stack.length) {
-		const frame = stack[stack.length - 1];
-		const current = frame.owner;
-		if (frame.scopes) {
-			const next = frame.scopes.next();
-			if (!next.done) {
-				const child = scopedOwnership(next.value);
-				if (!child.disposed && (!child.parent || child.parent === current)) {
-					if (!child.parent) linkOwnership(child, current);
-					stack.push(prepareDisposal(child));
-				}
-				continue;
-			}
-		}
-		if (current.head) {
-			const child = current.head;
-			if (frame.scopes && child.scope) {
-				detachOwnership(child);
-				continue;
-			}
-			stack.push(prepareDisposal(child));
-			continue;
-		}
-		const attempt = (message, run) => attemptDisposal(frame, message, run);
-		attempt("[Askr] readable subscription cleanup threw:", frame.phases.beforeCleanup);
-		const cleanups = current.cleanups;
-		current.cleanups = void 0;
-		if (cleanups) for (const cleanup of cleanups) attempt("[Askr] cleanup function threw:", cleanup);
-		attempt("[Askr] readable subscription cleanup threw:", frame.phases.afterCleanup);
-		attempt("[Askr] abort controller cleanup threw:", () => {
-			if (current.controller && !current.controller.signal.aborted) current.controller.abort(disposedSignal.reason);
-		});
-		current.controller = null;
-		current.reads = void 0;
-		current.mounted = false;
-		const finalizer = current.finalizer;
-		current.finalizer = void 0;
-		if (finalizer) attempt("[Askr] owner finalization threw:", () => finalizer.release());
-		try {
-			frame.phases.finish?.();
-		} catch (error) {
-			frame.unreported.push(error);
-		}
-		current.scope = void 0;
-		current.subject = void 0;
-		current.lifecycle = void 0;
-		stack.pop();
-		if (frame.unreported.length) {
-			const error = frame.unreported.length === 1 ? frame.unreported[0] : new AggregateError(frame.unreported, "Owned cleanup failed");
-			const parent = stack[stack.length - 1];
-			if (parent) attemptDisposal(parent, "[Askr] child ownership cleanup threw:", () => {
-				throw error;
-			});
-			else throw error;
-		}
-	}
-}
-//#endregion
-//#region src/runtime/component/scope.ts
-let currentInstance = null;
-let currentPortalScope = null;
-let scopedAppRenderRuntime;
-let stateIndex = 0;
-let globalRenderCounter = 0;
-function nextRenderToken() {
-	return ++globalRenderCounter;
-}
-function captureScope() {
-	return {
-		instance: currentInstance,
-		portalScope: currentPortalScope,
-		stateIndex
-	};
-}
-function restoreScope(snapshot) {
-	currentInstance = snapshot.instance;
-	currentPortalScope = snapshot.portalScope;
-	stateIndex = snapshot.stateIndex;
-}
-/**
-* Enter a component scope, returning the snapshot that restores it.
-*
-* The entry describes only what changes; the snapshot always carries all three
-* ambient fields, and `endComponentScope` always restores all three. Callers
-* therefore cannot introduce a variant that saves a subset and leaves the rest
-* pointing at the previous component, which is what the older enter/exit pairs
-* each did differently.
-*
-* Prefer `withComponentScope`. Use this pair directly only where the scope
-* genuinely cannot be expressed as a closure, such as a span across two
-* separately invoked lifecycle phases.
-*/
-function beginComponentScope(entry) {
-	const snapshot = captureScope();
-	if ("instance" in entry) {
-		const instance = entry.instance ?? null;
-		currentInstance = instance;
-		currentPortalScope = instance?.portalScope ?? snapshot.portalScope;
-	}
-	if ("portalScope" in entry) currentPortalScope = entry.portalScope ?? null;
-	if (entry.stateIndex !== void 0) stateIndex = entry.stateIndex;
-	return snapshot;
-}
-/** Restore every ambient scope field captured by `beginComponentScope`. */
-function endComponentScope(snapshot) {
-	restoreScope(snapshot);
-}
-function getCurrentComponentInstance() {
-	return currentInstance;
-}
-function getCurrentAppRenderRuntime() {
-	let instance = currentInstance;
-	while (instance) {
-		if (instance._appRenderRuntime) return instance._appRenderRuntime;
-		instance = instance.parentInstance;
-	}
-	return scopedAppRenderRuntime;
-}
-/** @internal Preserve root ownership without exposing component hook scope. */
-function withAppRenderRuntime(runtime, fn) {
-	const previous = scopedAppRenderRuntime;
-	scopedAppRenderRuntime = runtime;
-	try {
-		return fn();
-	} finally {
-		scopedAppRenderRuntime = previous;
-	}
-}
-function getCurrentPortalScope() {
-	return currentInstance?.portalScope ?? currentPortalScope;
-}
-function getSignalForInstance(instance) {
-	return getOwnershipSignal(instance.owner);
-}
-/**
-* Get the abort signal for the current component.
-*
-* The signal is guaranteed to be aborted when:
-* - Component unmounts
-* - Navigation occurs (different route)
-* - Parent is destroyed
-*/
-function getSignal() {
-	if (!currentInstance) throw new Error("getSignal() can only be called during component render execution. Ensure you are calling this from inside your component function.");
-	return getSignalForInstance(currentInstance);
-}
-function resetRenderState(instance) {
-	instance.stateIndexCheck = -1;
-	for (const state of instance.stateValues ?? []) if (state) state._hasBeenRead = false;
-	instance._pendingReadSources = void 0;
-	instance._pendingReadSourceVersions = void 0;
-}
-function beginRenderTracking(instance) {
-	instance.renderRevision = (instance.renderRevision ?? 0) + 1;
-	instance._currentRenderToken = nextRenderToken();
-	instance._pendingReadSources = void 0;
-	instance._pendingReadSourceVersions = void 0;
-}
-function clearRenderTracking(instance) {
-	instance._pendingReadSources = void 0;
-	instance._pendingReadSourceVersions = void 0;
-	instance._currentRenderToken = void 0;
-}
-function captureInlineRenderTracking(instance) {
-	return {
-		currentRenderToken: instance._currentRenderToken,
-		pendingReadSources: instance._pendingReadSources,
-		pendingReadSourceVersions: instance._pendingReadSourceVersions
-	};
-}
-function restoreInlineRenderTracking(instance, snapshot) {
-	instance._currentRenderToken = snapshot.currentRenderToken;
-	instance._pendingReadSources = snapshot.pendingReadSources;
-	instance._pendingReadSourceVersions = snapshot.pendingReadSourceVersions;
-}
-function enterRenderScopedComponent(instance, startStateIndex) {
-	return beginComponentScope({
-		instance,
-		stateIndex: startStateIndex
-	});
-}
-function captureInlineComponentScope() {
-	return beginComponentScope({});
-}
-function enterComponentExecutionScope(instance) {
-	return beginComponentScope({
-		instance,
-		stateIndex: 0
-	});
-}
-function enterDomCommitScope(instance) {
-	return beginComponentScope({ instance });
-}
-function clearCurrentComponentScope() {
-	return beginComponentScope({
-		instance: null,
-		portalScope: null
-	});
-}
-function getNextStateIndex() {
-	return stateIndex++;
-}
-function hookOrderGuidance(hookName) {
-	return `The render-scoped hook sequence changed between renders. This can happen when ${hookName}() is called conditionally, or when a conditional subtree skips an outer control boundary through a plain if, ternary, && branch, or loop. Keep render-scoped hooks and their outer control boundaries unconditional. Use <Show> or <Case> with <Match> children for conditional branches, and <For> for changing collections.`;
-}
-function claimHookIndex(instance, hookName) {
-	const index = getNextStateIndex();
-	if (index < instance.stateIndexCheck) throw new Error(`Hook index violation: ${hookName}() call at index ${index}, but previously saw index ${instance.stateIndexCheck}. ` + hookOrderGuidance(hookName));
-	instance.stateIndexCheck = index;
-	const expectedStateIndices = instance.expectedStateIndices ??= [];
-	if (instance.firstRenderComplete) {
-		if (expectedStateIndices[index] !== index) throw new Error(`Hook order violation: ${hookName}() called at index ${index}, but this index was not in the first render's sequence [${expectedStateIndices.join(", ")}]. ` + hookOrderGuidance(hookName));
-	} else expectedStateIndices.push(index);
-	return index;
-}
-function getCurrentStateIndex() {
-	return stateIndex;
-}
-//#endregion
-export { releaseOwnedChild as A, disposeOwnership as C, ownChild as D, getOwnershipSignal as E, ownCleanup as O, detachOwnedChildren as S, getOwnedChildScopes as T, restoreInlineRenderTracking as _, clearCurrentComponentScope as a, attachOwnership as b, enterComponentExecutionScope as c, getCurrentAppRenderRuntime as d, getCurrentComponentInstance as f, resetRenderState as g, getSignal as h, claimHookIndex as i, setOwnedChildScopes as j, registerScopedOwnership as k, enterDomCommitScope as l, getCurrentStateIndex as m, captureInlineComponentScope as n, clearRenderTracking as o, getCurrentPortalScope as p, captureInlineRenderTracking as r, endComponentScope as s, beginRenderTracking as t, enterRenderScopedComponent as u, withAppRenderRuntime as v, drainOwnedCleanup as w, componentRecordPrototype as x, OwnershipRecord as y };