@agimon-ai/doompi-core 0.0.1-alpha.100

package/dist/transitionClassifier.cjs

@@ -0,0 +1,112 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/services/transitionClassifier/index.ts
+function sameStrings(left, right) {
+	return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+function copySnapshot(snapshot) {
+	return {
+		...snapshot,
+		domains: [...snapshot.domains],
+		layers: [...snapshot.layers],
+		...snapshot.parentActivation ? { parentActivation: [...snapshot.parentActivation] } : {},
+		...snapshot.childActivation ? { childActivation: [...snapshot.childActivation] } : {}
+	};
+}
+function plan(request, disposition, previous, candidate, diagnostic, strategy) {
+	return {
+		operationId: request.operationId,
+		axis: request.target.axis,
+		disposition,
+		...strategy ? { strategy } : {},
+		previous,
+		candidate,
+		diagnostics: [diagnostic],
+		reloadHandoffRequired: disposition === "reload" || disposition === "relaunch",
+		externalRelaunchRequired: disposition === "relaunch"
+	};
+}
+function withComposition(candidate, context) {
+	const composition = context.resolveComposition?.(candidate);
+	if (!composition) return candidate;
+	return {
+		...candidate,
+		compositionFingerprint: composition.fingerprint,
+		parentActivation: [...composition.parentActivation],
+		childActivation: [...composition.childActivation]
+	};
+}
+function launcherNeedsRelaunch(extensionLayers, previous, candidate) {
+	if (previous.parentActivation && candidate.parentActivation) return !sameStrings(previous.parentActivation, candidate.parentActivation);
+	return !sameStrings(extensionLayers(previous.layers), extensionLayers(candidate.layers));
+}
+function majorModeDisposition(extensionLayers, previous, candidate, synchronization) {
+	if (synchronization.kind === "launcher-composed") return {
+		disposition: "reload",
+		diagnostic: "transition.reload.major-mode",
+		strategy: "pi-reload"
+	};
+	if (synchronization.kind === "synchronized") {
+		if (!synchronization.resolutionAvailable || !candidate.compositionFingerprint) return {
+			disposition: "sync-required",
+			diagnostic: "transition.sync-required.resolution"
+		};
+		if (!synchronization.availableCompositionFingerprints.includes(candidate.compositionFingerprint)) return {
+			disposition: "sync-required",
+			diagnostic: "transition.sync-required.artifact"
+		};
+		return {
+			disposition: "reload",
+			diagnostic: "transition.reload.major-mode",
+			strategy: "pi-reload"
+		};
+	}
+	return launcherNeedsRelaunch(extensionLayers, previous, candidate) ? {
+		disposition: "relaunch",
+		diagnostic: "transition.relaunch.extension-closure",
+		strategy: "process-relaunch"
+	} : {
+		disposition: "reload",
+		diagnostic: "transition.reload.major-mode",
+		strategy: "pi-reload"
+	};
+}
+function classifyTransition(request, context) {
+	const previous = copySnapshot(context.current);
+	switch (request.target.axis) {
+		case "live": return plan(request, "live", previous, copySnapshot(previous), "transition.live.capability");
+		case "domains": {
+			const candidate = {
+				...copySnapshot(previous),
+				domains: [...request.target.domains]
+			};
+			if (sameStrings(previous.domains, candidate.domains)) return plan(request, "live", previous, candidate, "transition.no-change");
+			return plan(request, "reload", previous, candidate, "transition.reload.domains", "pi-reload");
+		}
+		case "profile": {
+			const candidate = {
+				...copySnapshot(previous),
+				profile: request.target.profile
+			};
+			if (previous.profile === candidate.profile) return plan(request, "live", previous, candidate, "transition.no-change");
+			return plan(request, "reload", previous, candidate, "transition.reload.profile", "pi-reload");
+		}
+		case "major-mode": {
+			const candidateLayers = context.resolveLayers(request.target.majorMode);
+			const candidate = withComposition({
+				...copySnapshot(previous),
+				majorMode: request.target.majorMode,
+				layers: candidateLayers,
+				compositionFingerprint: void 0,
+				parentActivation: void 0,
+				childActivation: void 0
+			}, context);
+			if (previous.majorMode === candidate.majorMode && sameStrings(previous.layers, candidate.layers) || previous.compositionFingerprint !== void 0 && previous.compositionFingerprint === candidate.compositionFingerprint) return plan(request, "live", previous, candidate, "transition.no-change");
+			const classification = majorModeDisposition(context.extensionLayers, previous, candidate, context.synchronization);
+			return plan(request, classification.disposition, previous, candidate, classification.diagnostic, classification.strategy);
+		}
+	}
+}
+//#endregion
+exports.classifyTransition = classifyTransition;
+
+//# sourceMappingURL=transitionClassifier.cjs.map

package/dist/transitionClassifier.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transitionClassifier.cjs","names":[],"sources":["../src/services/transitionClassifier/index.ts"],"sourcesContent":["import type {\n  DoomTransitionPlan,\n  DoomTransitionRequest,\n  TransitionDiagnosticCode,\n  TransitionDisposition,\n  TransitionExecutionStrategy,\n  TransitionSelectionSnapshot,\n  TransitionSynchronization,\n} from '../../exports/transition';\n\nexport interface TransitionCompositionResolution {\n  readonly fingerprint: string;\n  readonly parentActivation: readonly string[];\n  readonly childActivation: readonly string[];\n}\n\nexport interface TransitionClassifierContext {\n  readonly current: TransitionSelectionSnapshot;\n  readonly resolveLayers: (majorMode: string) => readonly string[];\n  readonly extensionLayers: (layers: readonly string[]) => readonly string[];\n  readonly synchronization: TransitionSynchronization;\n  readonly resolveComposition?: (selection: TransitionSelectionSnapshot) => TransitionCompositionResolution | undefined;\n}\n\nfunction sameStrings(left: readonly string[], right: readonly string[]): boolean {\n  return left.length === right.length && left.every((value, index) => value === right[index]);\n}\n\nfunction copySnapshot(snapshot: TransitionSelectionSnapshot): TransitionSelectionSnapshot {\n  return {\n    ...snapshot,\n    domains: [...snapshot.domains],\n    layers: [...snapshot.layers],\n    ...(snapshot.parentActivation ? { parentActivation: [...snapshot.parentActivation] } : {}),\n    ...(snapshot.childActivation ? { childActivation: [...snapshot.childActivation] } : {}),\n  };\n}\n\nfunction plan(\n  request: DoomTransitionRequest,\n  disposition: TransitionDisposition,\n  previous: TransitionSelectionSnapshot,\n  candidate: TransitionSelectionSnapshot,\n  diagnostic: TransitionDiagnosticCode,\n  strategy?: TransitionExecutionStrategy,\n): DoomTransitionPlan {\n  return {\n    operationId: request.operationId,\n    axis: request.target.axis,\n    disposition,\n    ...(strategy ? { strategy } : {}),\n    previous,\n    candidate,\n    diagnostics: [diagnostic],\n    reloadHandoffRequired: disposition === 'reload' || disposition === 'relaunch',\n    externalRelaunchRequired: disposition === 'relaunch',\n  };\n}\n\nfunction withComposition(\n  candidate: TransitionSelectionSnapshot,\n  context: TransitionClassifierContext,\n): TransitionSelectionSnapshot {\n  const composition = context.resolveComposition?.(candidate);\n  if (!composition) return candidate;\n  return {\n    ...candidate,\n    compositionFingerprint: composition.fingerprint,\n    parentActivation: [...composition.parentActivation],\n    childActivation: [...composition.childActivation],\n  };\n}\n\nfunction launcherNeedsRelaunch(\n  extensionLayers: TransitionClassifierContext['extensionLayers'],\n  previous: TransitionSelectionSnapshot,\n  candidate: TransitionSelectionSnapshot,\n): boolean {\n  if (previous.parentActivation && candidate.parentActivation) {\n    return !sameStrings(previous.parentActivation, candidate.parentActivation);\n  }\n  return !sameStrings(extensionLayers(previous.layers), extensionLayers(candidate.layers));\n}\n\nfunction majorModeDisposition(\n  extensionLayers: TransitionClassifierContext['extensionLayers'],\n  previous: TransitionSelectionSnapshot,\n  candidate: TransitionSelectionSnapshot,\n  synchronization: TransitionSynchronization,\n): {\n  disposition: TransitionDisposition;\n  diagnostic: TransitionDiagnosticCode;\n  strategy?: TransitionExecutionStrategy;\n} {\n  // The entry composes from live selection on every load, so any candidate is\n  // reachable: a built aggregate when one exists, the individual entries when\n  // it does not. Nothing here can be sync-required.\n  if (synchronization.kind === 'launcher-composed') {\n    return { disposition: 'reload', diagnostic: 'transition.reload.major-mode', strategy: 'pi-reload' };\n  }\n  if (synchronization.kind === 'synchronized') {\n    if (!synchronization.resolutionAvailable || !candidate.compositionFingerprint) {\n      return {\n        disposition: 'sync-required',\n        diagnostic: 'transition.sync-required.resolution',\n      };\n    }\n    if (!synchronization.availableCompositionFingerprints.includes(candidate.compositionFingerprint)) {\n      return {\n        disposition: 'sync-required',\n        diagnostic: 'transition.sync-required.artifact',\n      };\n    }\n    return {\n      disposition: 'reload',\n      diagnostic: 'transition.reload.major-mode',\n      strategy: 'pi-reload',\n    };\n  }\n  return launcherNeedsRelaunch(extensionLayers, previous, candidate)\n    ? {\n        disposition: 'relaunch',\n        diagnostic: 'transition.relaunch.extension-closure',\n        strategy: 'process-relaunch',\n      }\n    : { disposition: 'reload', diagnostic: 'transition.reload.major-mode', strategy: 'pi-reload' };\n}\n\nexport function classifyTransition(\n  request: DoomTransitionRequest,\n  context: TransitionClassifierContext,\n): DoomTransitionPlan {\n  const previous = copySnapshot(context.current);\n\n  switch (request.target.axis) {\n    case 'live':\n      return plan(request, 'live', previous, copySnapshot(previous), 'transition.live.capability');\n    case 'domains': {\n      const candidate = { ...copySnapshot(previous), domains: [...request.target.domains] };\n      if (sameStrings(previous.domains, candidate.domains)) {\n        return plan(request, 'live', previous, candidate, 'transition.no-change');\n      }\n      return plan(request, 'reload', previous, candidate, 'transition.reload.domains', 'pi-reload');\n    }\n    case 'profile': {\n      const candidate = { ...copySnapshot(previous), profile: request.target.profile };\n      if (previous.profile === candidate.profile) {\n        return plan(request, 'live', previous, candidate, 'transition.no-change');\n      }\n      return plan(request, 'reload', previous, candidate, 'transition.reload.profile', 'pi-reload');\n    }\n    case 'major-mode': {\n      const candidateLayers = context.resolveLayers(request.target.majorMode);\n      const candidate = withComposition(\n        {\n          ...copySnapshot(previous),\n          majorMode: request.target.majorMode,\n          layers: candidateLayers,\n          compositionFingerprint: undefined,\n          parentActivation: undefined,\n          childActivation: undefined,\n        },\n        context,\n      );\n      if (\n        (previous.majorMode === candidate.majorMode && sameStrings(previous.layers, candidate.layers)) ||\n        (previous.compositionFingerprint !== undefined &&\n          previous.compositionFingerprint === candidate.compositionFingerprint)\n      ) {\n        return plan(request, 'live', previous, candidate, 'transition.no-change');\n      }\n      const classification = majorModeDisposition(\n        context.extensionLayers,\n        previous,\n        candidate,\n        context.synchronization,\n      );\n      return plan(\n        request,\n        classification.disposition,\n        previous,\n        candidate,\n        classification.diagnostic,\n        classification.strategy,\n      );\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/transitionClassifier.d.mts

@@ -0,0 +1,18 @@
+import { DoomTransitionPlan, DoomTransitionRequest, TransitionSelectionSnapshot, TransitionSynchronization } from "./runtimeTransition.mjs";
+import "./transition.mjs";
+//#region src/services/transitionClassifier/index.d.ts
+export interface TransitionCompositionResolution {
+  readonly fingerprint: string;
+  readonly parentActivation: readonly string[];
+  readonly childActivation: readonly string[];
+}
+export interface TransitionClassifierContext {
+  readonly current: TransitionSelectionSnapshot;
+  readonly resolveLayers: (majorMode: string) => readonly string[];
+  readonly extensionLayers: (layers: readonly string[]) => readonly string[];
+  readonly synchronization: TransitionSynchronization;
+  readonly resolveComposition?: (selection: TransitionSelectionSnapshot) => TransitionCompositionResolution | undefined;
+}
+export declare function classifyTransition(request: DoomTransitionRequest, context: TransitionClassifierContext): DoomTransitionPlan;
+//#endregion
+//# sourceMappingURL=transitionClassifier.d.mts.map

package/dist/transitionClassifier.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transitionClassifier.d.mts","names":[],"sources":["../src/services/transitionClassifier/index.ts"],"mappings":";;;iBAUiB;WACN;WACA;WACA;;iBAGM;WACN,SAAS;WACT,gBAAgB;WAChB,kBAAkB;WAClB,iBAAiB;WACjB,sBAAsB,WAAW,gCAAgC;;wBA2G5D,mBACd,SAAS,uBACT,SAAS,8BACR"}

package/dist/transitionClassifier.mjs

@@ -0,0 +1,111 @@
+//#region src/services/transitionClassifier/index.ts
+function sameStrings(left, right) {
+	return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+function copySnapshot(snapshot) {
+	return {
+		...snapshot,
+		domains: [...snapshot.domains],
+		layers: [...snapshot.layers],
+		...snapshot.parentActivation ? { parentActivation: [...snapshot.parentActivation] } : {},
+		...snapshot.childActivation ? { childActivation: [...snapshot.childActivation] } : {}
+	};
+}
+function plan(request, disposition, previous, candidate, diagnostic, strategy) {
+	return {
+		operationId: request.operationId,
+		axis: request.target.axis,
+		disposition,
+		...strategy ? { strategy } : {},
+		previous,
+		candidate,
+		diagnostics: [diagnostic],
+		reloadHandoffRequired: disposition === "reload" || disposition === "relaunch",
+		externalRelaunchRequired: disposition === "relaunch"
+	};
+}
+function withComposition(candidate, context) {
+	const composition = context.resolveComposition?.(candidate);
+	if (!composition) return candidate;
+	return {
+		...candidate,
+		compositionFingerprint: composition.fingerprint,
+		parentActivation: [...composition.parentActivation],
+		childActivation: [...composition.childActivation]
+	};
+}
+function launcherNeedsRelaunch(extensionLayers, previous, candidate) {
+	if (previous.parentActivation && candidate.parentActivation) return !sameStrings(previous.parentActivation, candidate.parentActivation);
+	return !sameStrings(extensionLayers(previous.layers), extensionLayers(candidate.layers));
+}
+function majorModeDisposition(extensionLayers, previous, candidate, synchronization) {
+	if (synchronization.kind === "launcher-composed") return {
+		disposition: "reload",
+		diagnostic: "transition.reload.major-mode",
+		strategy: "pi-reload"
+	};
+	if (synchronization.kind === "synchronized") {
+		if (!synchronization.resolutionAvailable || !candidate.compositionFingerprint) return {
+			disposition: "sync-required",
+			diagnostic: "transition.sync-required.resolution"
+		};
+		if (!synchronization.availableCompositionFingerprints.includes(candidate.compositionFingerprint)) return {
+			disposition: "sync-required",
+			diagnostic: "transition.sync-required.artifact"
+		};
+		return {
+			disposition: "reload",
+			diagnostic: "transition.reload.major-mode",
+			strategy: "pi-reload"
+		};
+	}
+	return launcherNeedsRelaunch(extensionLayers, previous, candidate) ? {
+		disposition: "relaunch",
+		diagnostic: "transition.relaunch.extension-closure",
+		strategy: "process-relaunch"
+	} : {
+		disposition: "reload",
+		diagnostic: "transition.reload.major-mode",
+		strategy: "pi-reload"
+	};
+}
+function classifyTransition(request, context) {
+	const previous = copySnapshot(context.current);
+	switch (request.target.axis) {
+		case "live": return plan(request, "live", previous, copySnapshot(previous), "transition.live.capability");
+		case "domains": {
+			const candidate = {
+				...copySnapshot(previous),
+				domains: [...request.target.domains]
+			};
+			if (sameStrings(previous.domains, candidate.domains)) return plan(request, "live", previous, candidate, "transition.no-change");
+			return plan(request, "reload", previous, candidate, "transition.reload.domains", "pi-reload");
+		}
+		case "profile": {
+			const candidate = {
+				...copySnapshot(previous),
+				profile: request.target.profile
+			};
+			if (previous.profile === candidate.profile) return plan(request, "live", previous, candidate, "transition.no-change");
+			return plan(request, "reload", previous, candidate, "transition.reload.profile", "pi-reload");
+		}
+		case "major-mode": {
+			const candidateLayers = context.resolveLayers(request.target.majorMode);
+			const candidate = withComposition({
+				...copySnapshot(previous),
+				majorMode: request.target.majorMode,
+				layers: candidateLayers,
+				compositionFingerprint: void 0,
+				parentActivation: void 0,
+				childActivation: void 0
+			}, context);
+			if (previous.majorMode === candidate.majorMode && sameStrings(previous.layers, candidate.layers) || previous.compositionFingerprint !== void 0 && previous.compositionFingerprint === candidate.compositionFingerprint) return plan(request, "live", previous, candidate, "transition.no-change");
+			const classification = majorModeDisposition(context.extensionLayers, previous, candidate, context.synchronization);
+			return plan(request, classification.disposition, previous, candidate, classification.diagnostic, classification.strategy);
+		}
+	}
+}
+//#endregion
+export { classifyTransition };
+
+//# sourceMappingURL=transitionClassifier.mjs.map

package/dist/transitionClassifier.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transitionClassifier.mjs","names":[],"sources":["../src/services/transitionClassifier/index.ts"],"sourcesContent":["import type {\n  DoomTransitionPlan,\n  DoomTransitionRequest,\n  TransitionDiagnosticCode,\n  TransitionDisposition,\n  TransitionExecutionStrategy,\n  TransitionSelectionSnapshot,\n  TransitionSynchronization,\n} from '../../exports/transition';\n\nexport interface TransitionCompositionResolution {\n  readonly fingerprint: string;\n  readonly parentActivation: readonly string[];\n  readonly childActivation: readonly string[];\n}\n\nexport interface TransitionClassifierContext {\n  readonly current: TransitionSelectionSnapshot;\n  readonly resolveLayers: (majorMode: string) => readonly string[];\n  readonly extensionLayers: (layers: readonly string[]) => readonly string[];\n  readonly synchronization: TransitionSynchronization;\n  readonly resolveComposition?: (selection: TransitionSelectionSnapshot) => TransitionCompositionResolution | undefined;\n}\n\nfunction sameStrings(left: readonly string[], right: readonly string[]): boolean {\n  return left.length === right.length && left.every((value, index) => value === right[index]);\n}\n\nfunction copySnapshot(snapshot: TransitionSelectionSnapshot): TransitionSelectionSnapshot {\n  return {\n    ...snapshot,\n    domains: [...snapshot.domains],\n    layers: [...snapshot.layers],\n    ...(snapshot.parentActivation ? { parentActivation: [...snapshot.parentActivation] } : {}),\n    ...(snapshot.childActivation ? { childActivation: [...snapshot.childActivation] } : {}),\n  };\n}\n\nfunction plan(\n  request: DoomTransitionRequest,\n  disposition: TransitionDisposition,\n  previous: TransitionSelectionSnapshot,\n  candidate: TransitionSelectionSnapshot,\n  diagnostic: TransitionDiagnosticCode,\n  strategy?: TransitionExecutionStrategy,\n): DoomTransitionPlan {\n  return {\n    operationId: request.operationId,\n    axis: request.target.axis,\n    disposition,\n    ...(strategy ? { strategy } : {}),\n    previous,\n    candidate,\n    diagnostics: [diagnostic],\n    reloadHandoffRequired: disposition === 'reload' || disposition === 'relaunch',\n    externalRelaunchRequired: disposition === 'relaunch',\n  };\n}\n\nfunction withComposition(\n  candidate: TransitionSelectionSnapshot,\n  context: TransitionClassifierContext,\n): TransitionSelectionSnapshot {\n  const composition = context.resolveComposition?.(candidate);\n  if (!composition) return candidate;\n  return {\n    ...candidate,\n    compositionFingerprint: composition.fingerprint,\n    parentActivation: [...composition.parentActivation],\n    childActivation: [...composition.childActivation],\n  };\n}\n\nfunction launcherNeedsRelaunch(\n  extensionLayers: TransitionClassifierContext['extensionLayers'],\n  previous: TransitionSelectionSnapshot,\n  candidate: TransitionSelectionSnapshot,\n): boolean {\n  if (previous.parentActivation && candidate.parentActivation) {\n    return !sameStrings(previous.parentActivation, candidate.parentActivation);\n  }\n  return !sameStrings(extensionLayers(previous.layers), extensionLayers(candidate.layers));\n}\n\nfunction majorModeDisposition(\n  extensionLayers: TransitionClassifierContext['extensionLayers'],\n  previous: TransitionSelectionSnapshot,\n  candidate: TransitionSelectionSnapshot,\n  synchronization: TransitionSynchronization,\n): {\n  disposition: TransitionDisposition;\n  diagnostic: TransitionDiagnosticCode;\n  strategy?: TransitionExecutionStrategy;\n} {\n  // The entry composes from live selection on every load, so any candidate is\n  // reachable: a built aggregate when one exists, the individual entries when\n  // it does not. Nothing here can be sync-required.\n  if (synchronization.kind === 'launcher-composed') {\n    return { disposition: 'reload', diagnostic: 'transition.reload.major-mode', strategy: 'pi-reload' };\n  }\n  if (synchronization.kind === 'synchronized') {\n    if (!synchronization.resolutionAvailable || !candidate.compositionFingerprint) {\n      return {\n        disposition: 'sync-required',\n        diagnostic: 'transition.sync-required.resolution',\n      };\n    }\n    if (!synchronization.availableCompositionFingerprints.includes(candidate.compositionFingerprint)) {\n      return {\n        disposition: 'sync-required',\n        diagnostic: 'transition.sync-required.artifact',\n      };\n    }\n    return {\n      disposition: 'reload',\n      diagnostic: 'transition.reload.major-mode',\n      strategy: 'pi-reload',\n    };\n  }\n  return launcherNeedsRelaunch(extensionLayers, previous, candidate)\n    ? {\n        disposition: 'relaunch',\n        diagnostic: 'transition.relaunch.extension-closure',\n        strategy: 'process-relaunch',\n      }\n    : { disposition: 'reload', diagnostic: 'transition.reload.major-mode', strategy: 'pi-reload' };\n}\n\nexport function classifyTransition(\n  request: DoomTransitionRequest,\n  context: TransitionClassifierContext,\n): DoomTransitionPlan {\n  const previous = copySnapshot(context.current);\n\n  switch (request.target.axis) {\n    case 'live':\n      return plan(request, 'live', previous, copySnapshot(previous), 'transition.live.capability');\n    case 'domains': {\n      const candidate = { ...copySnapshot(previous), domains: [...request.target.domains] };\n      if (sameStrings(previous.domains, candidate.domains)) {\n        return plan(request, 'live', previous, candidate, 'transition.no-change');\n      }\n      return plan(request, 'reload', previous, candidate, 'transition.reload.domains', 'pi-reload');\n    }\n    case 'profile': {\n      const candidate = { ...copySnapshot(previous), profile: request.target.profile };\n      if (previous.profile === candidate.profile) {\n        return plan(request, 'live', previous, candidate, 'transition.no-change');\n      }\n      return plan(request, 'reload', previous, candidate, 'transition.reload.profile', 'pi-reload');\n    }\n    case 'major-mode': {\n      const candidateLayers = context.resolveLayers(request.target.majorMode);\n      const candidate = withComposition(\n        {\n          ...copySnapshot(previous),\n          majorMode: request.target.majorMode,\n          layers: candidateLayers,\n          compositionFingerprint: undefined,\n          parentActivation: undefined,\n          childActivation: undefined,\n        },\n        context,\n      );\n      if (\n        (previous.majorMode === candidate.majorMode && sameStrings(previous.layers, candidate.layers)) ||\n        (previous.compositionFingerprint !== undefined &&\n          previous.compositionFingerprint === candidate.compositionFingerprint)\n      ) {\n        return plan(request, 'live', previous, candidate, 'transition.no-change');\n      }\n      const classification = majorModeDisposition(\n        context.extensionLayers,\n        previous,\n        candidate,\n        context.synchronization,\n      );\n      return plan(\n        request,\n        classification.disposition,\n        previous,\n        candidate,\n        classification.diagnostic,\n        classification.strategy,\n      );\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/transitionCoordinator.cjs

@@ -0,0 +1,131 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_transitionClassifier = require("./transitionClassifier.cjs");
+//#region src/services/transitionCoordinator/index.ts
+const LIVE_AXIS = "live";
+const STALE_SESSION_DIAGNOSTIC = "transition.stale.session";
+const STALE_GENERATION_DIAGNOSTIC = "transition.stale.generation";
+const ABORTED_DIAGNOSTIC = "transition.rejected.aborted";
+const EXECUTION_DIAGNOSTIC = "transition.rejected.execution";
+const NO_CHANGE_DIAGNOSTIC = "transition.no-change";
+function result(plan, outcome, diagnostic) {
+	return {
+		...plan,
+		outcome,
+		diagnostics: diagnostic ? [...plan.diagnostics, diagnostic] : plan.diagnostics
+	};
+}
+function defaultGeneration(sessionId, hostGeneration) {
+	return {
+		sessionId,
+		hostGeneration
+	};
+}
+function generationDiagnostic(expected, current) {
+	if (expected.sessionId !== current.sessionId) return STALE_SESSION_DIAGNOSTIC;
+	if (expected.hostGeneration !== current.hostGeneration) return STALE_GENERATION_DIAGNOSTIC;
+	if (expected.configGeneration !== current.configGeneration) return "transition.stale.config";
+}
+function createDoomTransitionCoordinator(options) {
+	const hostGeneration = options.hostGeneration ?? `doom-transition:${crypto.randomUUID()}`;
+	const readGeneration = options.generation ?? (() => defaultGeneration(options.sessionId, hostGeneration));
+	const operationIds = /* @__PURE__ */ new Set();
+	let committedSelection;
+	let structuralTail = Promise.resolve();
+	let structuralPending = 0;
+	let disposed = false;
+	const plan = (request) => {
+		const context = options.classifierContext();
+		const current = { ...committedSelection ?? context.current };
+		return require_transitionClassifier.classifyTransition(request, {
+			...context,
+			current
+		});
+	};
+	const requestDiagnostic = (request) => {
+		if (request.sessionId !== options.sessionId) return STALE_SESSION_DIAGNOSTIC;
+		if (request.hostGeneration !== hostGeneration) return STALE_GENERATION_DIAGNOSTIC;
+		if (disposed || request.signal?.aborted) return ABORTED_DIAGNOSTIC;
+		if (request.target.axis !== LIVE_AXIS && operationIds.has(request.operationId)) return "transition.rejected.duplicate";
+	};
+	const executeLive = async (request, transitionPlan, execution, expectedGeneration) => {
+		if (request.target.axis !== LIVE_AXIS) return result(transitionPlan, "rejected", EXECUTION_DIAGNOSTIC);
+		if (!execution) return result(transitionPlan, "rejected", "transition.rejected.unavailable");
+		const before = generationDiagnostic(expectedGeneration, readGeneration());
+		if (before) return result(transitionPlan, "stale", before);
+		try {
+			{
+				const outcome = await execution(request, transitionPlan);
+				const currentGeneration = readGeneration();
+				const after = generationDiagnostic(expectedGeneration, currentGeneration);
+				if (after && !options.acceptGenerationChange?.(expectedGeneration, currentGeneration, transitionPlan)) return result(transitionPlan, "stale", after);
+				return result(transitionPlan, outcome);
+			}
+		} catch {
+			return result(transitionPlan, "rejected", EXECUTION_DIAGNOSTIC);
+		}
+	};
+	const executeStructural = async (request, transitionPlan, execution, expectedGeneration) => {
+		if (disposed || request.signal?.aborted) return result(transitionPlan, "rejected", ABORTED_DIAGNOSTIC);
+		const stale = generationDiagnostic(expectedGeneration, readGeneration());
+		if (stale) return result(transitionPlan, "stale", stale);
+		if (transitionPlan.disposition === "sync-required") return result(transitionPlan, "rejected");
+		const selectedExecution = execution ?? options.executeStructural;
+		if (!selectedExecution) {
+			const outcome = transitionPlan.disposition === "live" ? "applied" : "queued";
+			if (outcome === "applied") committedSelection = transitionPlan.candidate;
+			return result(transitionPlan, outcome);
+		}
+		const outcome = await selectedExecution(request, transitionPlan);
+		const currentGeneration = readGeneration();
+		const after = generationDiagnostic(expectedGeneration, currentGeneration);
+		if (after && !options.acceptGenerationChange?.(expectedGeneration, currentGeneration, transitionPlan)) return result(transitionPlan, "stale", after);
+		if (outcome === "applied") committedSelection = transitionPlan.candidate;
+		return result(transitionPlan, outcome);
+	};
+	return {
+		sessionId: options.sessionId,
+		hostGeneration,
+		plan,
+		async execute(request, execution) {
+			const admission = requestDiagnostic(request);
+			if (admission) {
+				const outcome = admission.startsWith("transition.rejected.") ? "rejected" : "stale";
+				return result(plan(request), outcome, admission);
+			}
+			const expectedGeneration = readGeneration();
+			if (expectedGeneration.sessionId !== options.sessionId) return result(plan(request), "stale", STALE_SESSION_DIAGNOSTIC);
+			if (expectedGeneration.hostGeneration !== hostGeneration) return result(plan(request), "stale", STALE_GENERATION_DIAGNOSTIC);
+			if (request.target.axis !== LIVE_AXIS) operationIds.add(request.operationId);
+			if (request.target.axis === LIVE_AXIS) {
+				const transitionPlan = plan(request);
+				if (transitionPlan.diagnostics.includes(NO_CHANGE_DIAGNOSTIC)) return result(transitionPlan, "unchanged");
+				return executeLive(request, transitionPlan, execution, expectedGeneration);
+			}
+			structuralPending += 1;
+			const queued = structuralTail.then(async () => {
+				const transitionPlan = plan(request);
+				const stale = generationDiagnostic(expectedGeneration, readGeneration());
+				if (stale) return result(transitionPlan, "stale", stale);
+				if (transitionPlan.diagnostics.includes(NO_CHANGE_DIAGNOSTIC)) return result(transitionPlan, "unchanged");
+				return executeStructural(request, transitionPlan, execution, expectedGeneration);
+			});
+			structuralTail = queued.then(() => void 0, () => void 0);
+			try {
+				return await queued;
+			} finally {
+				structuralPending -= 1;
+			}
+		},
+		dispose() {
+			if (disposed) return;
+			disposed = true;
+			committedSelection = void 0;
+			operationIds.clear();
+			if (structuralPending === 0) structuralTail = Promise.resolve();
+		}
+	};
+}
+//#endregion
+exports.createDoomTransitionCoordinator = createDoomTransitionCoordinator;
+
+//# sourceMappingURL=transitionCoordinator.cjs.map

package/dist/transitionCoordinator.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transitionCoordinator.cjs","names":["classifyTransition"],"sources":["../src/services/transitionCoordinator/index.ts"],"sourcesContent":["import type {\n  DoomTransitionCoordinator,\n  DoomTransitionPlan,\n  DoomTransitionRequest,\n  DoomTransitionResult,\n  StructuralTransitionExecution,\n  TransitionDiagnosticCode,\n  TransitionGeneration,\n  TransitionOutcome,\n} from '../../exports/transition';\nimport { classifyTransition, type TransitionClassifierContext } from '../transitionClassifier';\n\nconst LIVE_AXIS = 'live';\nconst STALE_SESSION_DIAGNOSTIC: TransitionDiagnosticCode = 'transition.stale.session';\nconst STALE_GENERATION_DIAGNOSTIC: TransitionDiagnosticCode = 'transition.stale.generation';\nconst ABORTED_DIAGNOSTIC: TransitionDiagnosticCode = 'transition.rejected.aborted';\nconst EXECUTION_DIAGNOSTIC: TransitionDiagnosticCode = 'transition.rejected.execution';\nconst NO_CHANGE_DIAGNOSTIC: TransitionDiagnosticCode = 'transition.no-change';\n\nexport interface TransitionCoordinatorOptions {\n  readonly sessionId: string;\n  readonly hostGeneration?: string;\n  readonly classifierContext: () => TransitionClassifierContext;\n  /** Captures identities that must remain stable while a transition is queued. */\n  readonly generation?: () => TransitionGeneration;\n  readonly acceptGenerationChange?: (\n    before: TransitionGeneration,\n    after: TransitionGeneration,\n    plan: DoomTransitionPlan,\n  ) => boolean;\n  readonly executeStructural?: (request: DoomTransitionRequest, plan: DoomTransitionPlan) => Promise<TransitionOutcome>;\n}\n\nfunction result(\n  plan: DoomTransitionPlan,\n  outcome: TransitionOutcome,\n  diagnostic?: TransitionDiagnosticCode,\n): DoomTransitionResult {\n  return {\n    ...plan,\n    outcome,\n    diagnostics: diagnostic ? [...plan.diagnostics, diagnostic] : plan.diagnostics,\n  };\n}\n\nfunction defaultGeneration(sessionId: string, hostGeneration: string): TransitionGeneration {\n  return { sessionId, hostGeneration };\n}\n\nfunction generationDiagnostic(\n  expected: TransitionGeneration,\n  current: TransitionGeneration,\n): TransitionDiagnosticCode | undefined {\n  if (expected.sessionId !== current.sessionId) return STALE_SESSION_DIAGNOSTIC;\n  if (expected.hostGeneration !== current.hostGeneration) return STALE_GENERATION_DIAGNOSTIC;\n  if (expected.configGeneration !== current.configGeneration) return 'transition.stale.config';\n  return undefined;\n}\n\nexport function createDoomTransitionCoordinator(options: TransitionCoordinatorOptions): DoomTransitionCoordinator {\n  const hostGeneration = options.hostGeneration ?? `doom-transition:${crypto.randomUUID()}`;\n  const readGeneration = options.generation ?? (() => defaultGeneration(options.sessionId, hostGeneration));\n  const operationIds = new Set<string>();\n  let committedSelection: DoomTransitionPlan['candidate'] | undefined;\n  let structuralTail: Promise<void> = Promise.resolve();\n  let structuralPending = 0;\n  let disposed = false;\n\n  const plan = (request: DoomTransitionRequest): DoomTransitionPlan => {\n    const context = options.classifierContext();\n    const current = {\n      ...(committedSelection ?? context.current),\n    };\n    return classifyTransition(request, { ...context, current });\n  };\n\n  const requestDiagnostic = (request: DoomTransitionRequest): TransitionDiagnosticCode | undefined => {\n    if (request.sessionId !== options.sessionId) return STALE_SESSION_DIAGNOSTIC;\n    if (request.hostGeneration !== hostGeneration) return STALE_GENERATION_DIAGNOSTIC;\n    if (disposed || request.signal?.aborted) return ABORTED_DIAGNOSTIC;\n    if (request.target.axis !== LIVE_AXIS && operationIds.has(request.operationId)) {\n      return 'transition.rejected.duplicate';\n    }\n    return undefined;\n  };\n\n  const executeLive = async (\n    request: DoomTransitionRequest,\n    transitionPlan: DoomTransitionPlan,\n    execution: StructuralTransitionExecution | undefined,\n    expectedGeneration: TransitionGeneration,\n  ): Promise<DoomTransitionResult> => {\n    if (request.target.axis !== LIVE_AXIS) {\n      return result(transitionPlan, 'rejected', EXECUTION_DIAGNOSTIC);\n    }\n    if (!execution) return result(transitionPlan, 'rejected', 'transition.rejected.unavailable');\n    const before = generationDiagnostic(expectedGeneration, readGeneration());\n    if (before) return result(transitionPlan, 'stale', before);\n    try {\n      {\n        const outcome = await execution(request, transitionPlan);\n        const currentGeneration = readGeneration();\n        const after = generationDiagnostic(expectedGeneration, currentGeneration);\n        if (after && !options.acceptGenerationChange?.(expectedGeneration, currentGeneration, transitionPlan)) {\n          return result(transitionPlan, 'stale', after);\n        }\n        return result(transitionPlan, outcome);\n      }\n    } catch {\n      return result(transitionPlan, 'rejected', EXECUTION_DIAGNOSTIC);\n    }\n  };\n\n  const executeStructural = async (\n    request: DoomTransitionRequest,\n    transitionPlan: DoomTransitionPlan,\n    execution: StructuralTransitionExecution | undefined,\n    expectedGeneration: TransitionGeneration,\n  ): Promise<DoomTransitionResult> => {\n    if (disposed || request.signal?.aborted) {\n      return result(transitionPlan, 'rejected', ABORTED_DIAGNOSTIC);\n    }\n    const stale = generationDiagnostic(expectedGeneration, readGeneration());\n    if (stale) return result(transitionPlan, 'stale', stale);\n    if (transitionPlan.disposition === 'sync-required') {\n      return result(transitionPlan, 'rejected');\n    }\n    const selectedExecution = execution ?? options.executeStructural;\n    if (!selectedExecution) {\n      const outcome = transitionPlan.disposition === 'live' ? 'applied' : 'queued';\n      if (outcome === 'applied') committedSelection = transitionPlan.candidate;\n      return result(transitionPlan, outcome);\n    }\n    const outcome = await selectedExecution(request, transitionPlan);\n    const currentGeneration = readGeneration();\n    const after = generationDiagnostic(expectedGeneration, currentGeneration);\n    if (after && !options.acceptGenerationChange?.(expectedGeneration, currentGeneration, transitionPlan)) {\n      return result(transitionPlan, 'stale', after);\n    }\n    if (outcome === 'applied') committedSelection = transitionPlan.candidate;\n    return result(transitionPlan, outcome);\n  };\n\n  return {\n    sessionId: options.sessionId,\n    hostGeneration,\n    plan,\n    async execute(request, execution) {\n      const admission = requestDiagnostic(request);\n      if (admission) {\n        const outcome = admission.startsWith('transition.rejected.') ? 'rejected' : 'stale';\n        return result(plan(request), outcome, admission);\n      }\n      const expectedGeneration = readGeneration();\n      if (expectedGeneration.sessionId !== options.sessionId) {\n        return result(plan(request), 'stale', STALE_SESSION_DIAGNOSTIC);\n      }\n      if (expectedGeneration.hostGeneration !== hostGeneration) {\n        return result(plan(request), 'stale', STALE_GENERATION_DIAGNOSTIC);\n      }\n      if (request.target.axis !== LIVE_AXIS) operationIds.add(request.operationId);\n\n      if (request.target.axis === LIVE_AXIS) {\n        const transitionPlan = plan(request);\n        if (transitionPlan.diagnostics.includes(NO_CHANGE_DIAGNOSTIC)) return result(transitionPlan, 'unchanged');\n        return executeLive(request, transitionPlan, execution, expectedGeneration);\n      }\n\n      structuralPending += 1;\n      const queued = structuralTail.then(async () => {\n        const transitionPlan = plan(request);\n        const stale = generationDiagnostic(expectedGeneration, readGeneration());\n        if (stale) return result(transitionPlan, 'stale', stale);\n        if (transitionPlan.diagnostics.includes(NO_CHANGE_DIAGNOSTIC)) return result(transitionPlan, 'unchanged');\n        return executeStructural(request, transitionPlan, execution, expectedGeneration);\n      });\n      structuralTail = queued.then(\n        () => undefined,\n        () => undefined,\n      );\n      try {\n        return await queued;\n      } finally {\n        structuralPending -= 1;\n      }\n    },\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      committedSelection = undefined;\n      operationIds.clear();\n      if (structuralPending === 0) structuralTail = Promise.resolve();\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/transitionCoordinator.d.mts

@@ -0,0 +1,16 @@
+import { DoomTransitionCoordinator, DoomTransitionPlan, DoomTransitionRequest, TransitionGeneration, TransitionOutcome } from "./runtimeTransition.mjs";
+import "./transition.mjs";
+import { TransitionClassifierContext } from "./transitionClassifier.mjs";
+//#region src/services/transitionCoordinator/index.d.ts
+export interface TransitionCoordinatorOptions {
+  readonly sessionId: string;
+  readonly hostGeneration?: string;
+  readonly classifierContext: () => TransitionClassifierContext;
+  /** Captures identities that must remain stable while a transition is queued. */
+  readonly generation?: () => TransitionGeneration;
+  readonly acceptGenerationChange?: (before: TransitionGeneration, after: TransitionGeneration, plan: DoomTransitionPlan) => boolean;
+  readonly executeStructural?: (request: DoomTransitionRequest, plan: DoomTransitionPlan) => Promise<TransitionOutcome>;
+}
+export declare function createDoomTransitionCoordinator(options: TransitionCoordinatorOptions): DoomTransitionCoordinator;
+//#endregion
+//# sourceMappingURL=transitionCoordinator.d.mts.map

package/dist/transitionCoordinator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transitionCoordinator.d.mts","names":[],"sources":["../src/services/transitionCoordinator/index.ts"],"mappings":";;;;iBAmBiB;WACN;WACA;WACA,yBAAyB;;WAEzB,mBAAmB;WACnB,0BACP,QAAQ,sBACR,OAAO,sBACP,MAAM;WAEC,qBAAqB,SAAS,uBAAuB,MAAM,uBAAuB,QAAQ;;wBA6BrF,gCAAgC,SAAS,+BAA+B"}

package/dist/transitionCoordinator.mjs

@@ -0,0 +1,130 @@
+import { classifyTransition } from "./transitionClassifier.mjs";
+//#region src/services/transitionCoordinator/index.ts
+const LIVE_AXIS = "live";
+const STALE_SESSION_DIAGNOSTIC = "transition.stale.session";
+const STALE_GENERATION_DIAGNOSTIC = "transition.stale.generation";
+const ABORTED_DIAGNOSTIC = "transition.rejected.aborted";
+const EXECUTION_DIAGNOSTIC = "transition.rejected.execution";
+const NO_CHANGE_DIAGNOSTIC = "transition.no-change";
+function result(plan, outcome, diagnostic) {
+	return {
+		...plan,
+		outcome,
+		diagnostics: diagnostic ? [...plan.diagnostics, diagnostic] : plan.diagnostics
+	};
+}
+function defaultGeneration(sessionId, hostGeneration) {
+	return {
+		sessionId,
+		hostGeneration
+	};
+}
+function generationDiagnostic(expected, current) {
+	if (expected.sessionId !== current.sessionId) return STALE_SESSION_DIAGNOSTIC;
+	if (expected.hostGeneration !== current.hostGeneration) return STALE_GENERATION_DIAGNOSTIC;
+	if (expected.configGeneration !== current.configGeneration) return "transition.stale.config";
+}
+function createDoomTransitionCoordinator(options) {
+	const hostGeneration = options.hostGeneration ?? `doom-transition:${crypto.randomUUID()}`;
+	const readGeneration = options.generation ?? (() => defaultGeneration(options.sessionId, hostGeneration));
+	const operationIds = /* @__PURE__ */ new Set();
+	let committedSelection;
+	let structuralTail = Promise.resolve();
+	let structuralPending = 0;
+	let disposed = false;
+	const plan = (request) => {
+		const context = options.classifierContext();
+		const current = { ...committedSelection ?? context.current };
+		return classifyTransition(request, {
+			...context,
+			current
+		});
+	};
+	const requestDiagnostic = (request) => {
+		if (request.sessionId !== options.sessionId) return STALE_SESSION_DIAGNOSTIC;
+		if (request.hostGeneration !== hostGeneration) return STALE_GENERATION_DIAGNOSTIC;
+		if (disposed || request.signal?.aborted) return ABORTED_DIAGNOSTIC;
+		if (request.target.axis !== LIVE_AXIS && operationIds.has(request.operationId)) return "transition.rejected.duplicate";
+	};
+	const executeLive = async (request, transitionPlan, execution, expectedGeneration) => {
+		if (request.target.axis !== LIVE_AXIS) return result(transitionPlan, "rejected", EXECUTION_DIAGNOSTIC);
+		if (!execution) return result(transitionPlan, "rejected", "transition.rejected.unavailable");
+		const before = generationDiagnostic(expectedGeneration, readGeneration());
+		if (before) return result(transitionPlan, "stale", before);
+		try {
+			{
+				const outcome = await execution(request, transitionPlan);
+				const currentGeneration = readGeneration();
+				const after = generationDiagnostic(expectedGeneration, currentGeneration);
+				if (after && !options.acceptGenerationChange?.(expectedGeneration, currentGeneration, transitionPlan)) return result(transitionPlan, "stale", after);
+				return result(transitionPlan, outcome);
+			}
+		} catch {
+			return result(transitionPlan, "rejected", EXECUTION_DIAGNOSTIC);
+		}
+	};
+	const executeStructural = async (request, transitionPlan, execution, expectedGeneration) => {
+		if (disposed || request.signal?.aborted) return result(transitionPlan, "rejected", ABORTED_DIAGNOSTIC);
+		const stale = generationDiagnostic(expectedGeneration, readGeneration());
+		if (stale) return result(transitionPlan, "stale", stale);
+		if (transitionPlan.disposition === "sync-required") return result(transitionPlan, "rejected");
+		const selectedExecution = execution ?? options.executeStructural;
+		if (!selectedExecution) {
+			const outcome = transitionPlan.disposition === "live" ? "applied" : "queued";
+			if (outcome === "applied") committedSelection = transitionPlan.candidate;
+			return result(transitionPlan, outcome);
+		}
+		const outcome = await selectedExecution(request, transitionPlan);
+		const currentGeneration = readGeneration();
+		const after = generationDiagnostic(expectedGeneration, currentGeneration);
+		if (after && !options.acceptGenerationChange?.(expectedGeneration, currentGeneration, transitionPlan)) return result(transitionPlan, "stale", after);
+		if (outcome === "applied") committedSelection = transitionPlan.candidate;
+		return result(transitionPlan, outcome);
+	};
+	return {
+		sessionId: options.sessionId,
+		hostGeneration,
+		plan,
+		async execute(request, execution) {
+			const admission = requestDiagnostic(request);
+			if (admission) {
+				const outcome = admission.startsWith("transition.rejected.") ? "rejected" : "stale";
+				return result(plan(request), outcome, admission);
+			}
+			const expectedGeneration = readGeneration();
+			if (expectedGeneration.sessionId !== options.sessionId) return result(plan(request), "stale", STALE_SESSION_DIAGNOSTIC);
+			if (expectedGeneration.hostGeneration !== hostGeneration) return result(plan(request), "stale", STALE_GENERATION_DIAGNOSTIC);
+			if (request.target.axis !== LIVE_AXIS) operationIds.add(request.operationId);
+			if (request.target.axis === LIVE_AXIS) {
+				const transitionPlan = plan(request);
+				if (transitionPlan.diagnostics.includes(NO_CHANGE_DIAGNOSTIC)) return result(transitionPlan, "unchanged");
+				return executeLive(request, transitionPlan, execution, expectedGeneration);
+			}
+			structuralPending += 1;
+			const queued = structuralTail.then(async () => {
+				const transitionPlan = plan(request);
+				const stale = generationDiagnostic(expectedGeneration, readGeneration());
+				if (stale) return result(transitionPlan, "stale", stale);
+				if (transitionPlan.diagnostics.includes(NO_CHANGE_DIAGNOSTIC)) return result(transitionPlan, "unchanged");
+				return executeStructural(request, transitionPlan, execution, expectedGeneration);
+			});
+			structuralTail = queued.then(() => void 0, () => void 0);
+			try {
+				return await queued;
+			} finally {
+				structuralPending -= 1;
+			}
+		},
+		dispose() {
+			if (disposed) return;
+			disposed = true;
+			committedSelection = void 0;
+			operationIds.clear();
+			if (structuralPending === 0) structuralTail = Promise.resolve();
+		}
+	};
+}
+//#endregion
+export { createDoomTransitionCoordinator };
+
+//# sourceMappingURL=transitionCoordinator.mjs.map

package/dist/transitionCoordinator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transitionCoordinator.mjs","names":[],"sources":["../src/services/transitionCoordinator/index.ts"],"sourcesContent":["import type {\n  DoomTransitionCoordinator,\n  DoomTransitionPlan,\n  DoomTransitionRequest,\n  DoomTransitionResult,\n  StructuralTransitionExecution,\n  TransitionDiagnosticCode,\n  TransitionGeneration,\n  TransitionOutcome,\n} from '../../exports/transition';\nimport { classifyTransition, type TransitionClassifierContext } from '../transitionClassifier';\n\nconst LIVE_AXIS = 'live';\nconst STALE_SESSION_DIAGNOSTIC: TransitionDiagnosticCode = 'transition.stale.session';\nconst STALE_GENERATION_DIAGNOSTIC: TransitionDiagnosticCode = 'transition.stale.generation';\nconst ABORTED_DIAGNOSTIC: TransitionDiagnosticCode = 'transition.rejected.aborted';\nconst EXECUTION_DIAGNOSTIC: TransitionDiagnosticCode = 'transition.rejected.execution';\nconst NO_CHANGE_DIAGNOSTIC: TransitionDiagnosticCode = 'transition.no-change';\n\nexport interface TransitionCoordinatorOptions {\n  readonly sessionId: string;\n  readonly hostGeneration?: string;\n  readonly classifierContext: () => TransitionClassifierContext;\n  /** Captures identities that must remain stable while a transition is queued. */\n  readonly generation?: () => TransitionGeneration;\n  readonly acceptGenerationChange?: (\n    before: TransitionGeneration,\n    after: TransitionGeneration,\n    plan: DoomTransitionPlan,\n  ) => boolean;\n  readonly executeStructural?: (request: DoomTransitionRequest, plan: DoomTransitionPlan) => Promise<TransitionOutcome>;\n}\n\nfunction result(\n  plan: DoomTransitionPlan,\n  outcome: TransitionOutcome,\n  diagnostic?: TransitionDiagnosticCode,\n): DoomTransitionResult {\n  return {\n    ...plan,\n    outcome,\n    diagnostics: diagnostic ? [...plan.diagnostics, diagnostic] : plan.diagnostics,\n  };\n}\n\nfunction defaultGeneration(sessionId: string, hostGeneration: string): TransitionGeneration {\n  return { sessionId, hostGeneration };\n}\n\nfunction generationDiagnostic(\n  expected: TransitionGeneration,\n  current: TransitionGeneration,\n): TransitionDiagnosticCode | undefined {\n  if (expected.sessionId !== current.sessionId) return STALE_SESSION_DIAGNOSTIC;\n  if (expected.hostGeneration !== current.hostGeneration) return STALE_GENERATION_DIAGNOSTIC;\n  if (expected.configGeneration !== current.configGeneration) return 'transition.stale.config';\n  return undefined;\n}\n\nexport function createDoomTransitionCoordinator(options: TransitionCoordinatorOptions): DoomTransitionCoordinator {\n  const hostGeneration = options.hostGeneration ?? `doom-transition:${crypto.randomUUID()}`;\n  const readGeneration = options.generation ?? (() => defaultGeneration(options.sessionId, hostGeneration));\n  const operationIds = new Set<string>();\n  let committedSelection: DoomTransitionPlan['candidate'] | undefined;\n  let structuralTail: Promise<void> = Promise.resolve();\n  let structuralPending = 0;\n  let disposed = false;\n\n  const plan = (request: DoomTransitionRequest): DoomTransitionPlan => {\n    const context = options.classifierContext();\n    const current = {\n      ...(committedSelection ?? context.current),\n    };\n    return classifyTransition(request, { ...context, current });\n  };\n\n  const requestDiagnostic = (request: DoomTransitionRequest): TransitionDiagnosticCode | undefined => {\n    if (request.sessionId !== options.sessionId) return STALE_SESSION_DIAGNOSTIC;\n    if (request.hostGeneration !== hostGeneration) return STALE_GENERATION_DIAGNOSTIC;\n    if (disposed || request.signal?.aborted) return ABORTED_DIAGNOSTIC;\n    if (request.target.axis !== LIVE_AXIS && operationIds.has(request.operationId)) {\n      return 'transition.rejected.duplicate';\n    }\n    return undefined;\n  };\n\n  const executeLive = async (\n    request: DoomTransitionRequest,\n    transitionPlan: DoomTransitionPlan,\n    execution: StructuralTransitionExecution | undefined,\n    expectedGeneration: TransitionGeneration,\n  ): Promise<DoomTransitionResult> => {\n    if (request.target.axis !== LIVE_AXIS) {\n      return result(transitionPlan, 'rejected', EXECUTION_DIAGNOSTIC);\n    }\n    if (!execution) return result(transitionPlan, 'rejected', 'transition.rejected.unavailable');\n    const before = generationDiagnostic(expectedGeneration, readGeneration());\n    if (before) return result(transitionPlan, 'stale', before);\n    try {\n      {\n        const outcome = await execution(request, transitionPlan);\n        const currentGeneration = readGeneration();\n        const after = generationDiagnostic(expectedGeneration, currentGeneration);\n        if (after && !options.acceptGenerationChange?.(expectedGeneration, currentGeneration, transitionPlan)) {\n          return result(transitionPlan, 'stale', after);\n        }\n        return result(transitionPlan, outcome);\n      }\n    } catch {\n      return result(transitionPlan, 'rejected', EXECUTION_DIAGNOSTIC);\n    }\n  };\n\n  const executeStructural = async (\n    request: DoomTransitionRequest,\n    transitionPlan: DoomTransitionPlan,\n    execution: StructuralTransitionExecution | undefined,\n    expectedGeneration: TransitionGeneration,\n  ): Promise<DoomTransitionResult> => {\n    if (disposed || request.signal?.aborted) {\n      return result(transitionPlan, 'rejected', ABORTED_DIAGNOSTIC);\n    }\n    const stale = generationDiagnostic(expectedGeneration, readGeneration());\n    if (stale) return result(transitionPlan, 'stale', stale);\n    if (transitionPlan.disposition === 'sync-required') {\n      return result(transitionPlan, 'rejected');\n    }\n    const selectedExecution = execution ?? options.executeStructural;\n    if (!selectedExecution) {\n      const outcome = transitionPlan.disposition === 'live' ? 'applied' : 'queued';\n      if (outcome === 'applied') committedSelection = transitionPlan.candidate;\n      return result(transitionPlan, outcome);\n    }\n    const outcome = await selectedExecution(request, transitionPlan);\n    const currentGeneration = readGeneration();\n    const after = generationDiagnostic(expectedGeneration, currentGeneration);\n    if (after && !options.acceptGenerationChange?.(expectedGeneration, currentGeneration, transitionPlan)) {\n      return result(transitionPlan, 'stale', after);\n    }\n    if (outcome === 'applied') committedSelection = transitionPlan.candidate;\n    return result(transitionPlan, outcome);\n  };\n\n  return {\n    sessionId: options.sessionId,\n    hostGeneration,\n    plan,\n    async execute(request, execution) {\n      const admission = requestDiagnostic(request);\n      if (admission) {\n        const outcome = admission.startsWith('transition.rejected.') ? 'rejected' : 'stale';\n        return result(plan(request), outcome, admission);\n      }\n      const expectedGeneration = readGeneration();\n      if (expectedGeneration.sessionId !== options.sessionId) {\n        return result(plan(request), 'stale', STALE_SESSION_DIAGNOSTIC);\n      }\n      if (expectedGeneration.hostGeneration !== hostGeneration) {\n        return result(plan(request), 'stale', STALE_GENERATION_DIAGNOSTIC);\n      }\n      if (request.target.axis !== LIVE_AXIS) operationIds.add(request.operationId);\n\n      if (request.target.axis === LIVE_AXIS) {\n        const transitionPlan = plan(request);\n        if (transitionPlan.diagnostics.includes(NO_CHANGE_DIAGNOSTIC)) return result(transitionPlan, 'unchanged');\n        return executeLive(request, transitionPlan, execution, expectedGeneration);\n      }\n\n      structuralPending += 1;\n      const queued = structuralTail.then(async () => {\n        const transitionPlan = plan(request);\n        const stale = generationDiagnostic(expectedGeneration, readGeneration());\n        if (stale) return result(transitionPlan, 'stale', stale);\n        if (transitionPlan.diagnostics.includes(NO_CHANGE_DIAGNOSTIC)) return result(transitionPlan, 'unchanged');\n        return executeStructural(request, transitionPlan, execution, expectedGeneration);\n      });\n      structuralTail = queued.then(\n        () => undefined,\n        () => undefined,\n      );\n      try {\n        return await queued;\n      } finally {\n        structuralPending -= 1;\n      }\n    },\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      committedSelection = undefined;\n      operationIds.clear();\n      if (structuralPending === 0) structuralTail = Promise.resolve();\n    },\n  };\n}\n"],"mappings":";;AAYA,MAAM,YAAY;AAClB,MAAM,2BAAqD;AAC3D,MAAM,8BAAwD;AAC9D,MAAM,qBAA+C;AACrD,MAAM,uBAAiD;AACvD,MAAM,uBAAiD;AAgBvD,SAAS,OACP,MACA,SACA,YACsB;CACtB,OAAO;EACL,GAAG;EACH;EACA,aAAa,aAAa,CAAC,GAAG,KAAK,aAAa,UAAU,IAAI,KAAK;CACrE;AACF;AAEA,SAAS,kBAAkB,WAAmB,gBAA8C;CAC1F,OAAO;EAAE;EAAW;CAAe;AACrC;AAEA,SAAS,qBACP,UACA,SACsC;CACtC,IAAI,SAAS,cAAc,QAAQ,WAAW,OAAO;CACrD,IAAI,SAAS,mBAAmB,QAAQ,gBAAgB,OAAO;CAC/D,IAAI,SAAS,qBAAqB,QAAQ,kBAAkB,OAAO;AAErE;AAEA,SAAgB,gCAAgC,SAAkE;CAChH,MAAM,iBAAiB,QAAQ,kBAAkB,mBAAmB,OAAO,WAAW;CACtF,MAAM,iBAAiB,QAAQ,qBAAqB,kBAAkB,QAAQ,WAAW,cAAc;CACvG,MAAM,+BAAe,IAAI,IAAY;CACrC,IAAI;CACJ,IAAI,iBAAgC,QAAQ,QAAQ;CACpD,IAAI,oBAAoB;CACxB,IAAI,WAAW;CAEf,MAAM,QAAQ,YAAuD;EACnE,MAAM,UAAU,QAAQ,kBAAkB;EAC1C,MAAM,UAAU,EACd,GAAI,sBAAsB,QAAQ,QACpC;EACA,OAAO,mBAAmB,SAAS;GAAE,GAAG;GAAS;EAAQ,CAAC;CAC5D;CAEA,MAAM,qBAAqB,YAAyE;EAClG,IAAI,QAAQ,cAAc,QAAQ,WAAW,OAAO;EACpD,IAAI,QAAQ,mBAAmB,gBAAgB,OAAO;EACtD,IAAI,YAAY,QAAQ,QAAQ,SAAS,OAAO;EAChD,IAAI,QAAQ,OAAO,SAAS,aAAa,aAAa,IAAI,QAAQ,WAAW,GAC3E,OAAO;CAGX;CAEA,MAAM,cAAc,OAClB,SACA,gBACA,WACA,uBACkC;EAClC,IAAI,QAAQ,OAAO,SAAS,WAC1B,OAAO,OAAO,gBAAgB,YAAY,oBAAoB;EAEhE,IAAI,CAAC,WAAW,OAAO,OAAO,gBAAgB,YAAY,iCAAiC;EAC3F,MAAM,SAAS,qBAAqB,oBAAoB,eAAe,CAAC;EACxE,IAAI,QAAQ,OAAO,OAAO,gBAAgB,SAAS,MAAM;EACzD,IAAI;GACF;IACE,MAAM,UAAU,MAAM,UAAU,SAAS,cAAc;IACvD,MAAM,oBAAoB,eAAe;IACzC,MAAM,QAAQ,qBAAqB,oBAAoB,iBAAiB;IACxE,IAAI,SAAS,CAAC,QAAQ,yBAAyB,oBAAoB,mBAAmB,cAAc,GAClG,OAAO,OAAO,gBAAgB,SAAS,KAAK;IAE9C,OAAO,OAAO,gBAAgB,OAAO;GACvC;EACF,QAAQ;GACN,OAAO,OAAO,gBAAgB,YAAY,oBAAoB;EAChE;CACF;CAEA,MAAM,oBAAoB,OACxB,SACA,gBACA,WACA,uBACkC;EAClC,IAAI,YAAY,QAAQ,QAAQ,SAC9B,OAAO,OAAO,gBAAgB,YAAY,kBAAkB;EAE9D,MAAM,QAAQ,qBAAqB,oBAAoB,eAAe,CAAC;EACvE,IAAI,OAAO,OAAO,OAAO,gBAAgB,SAAS,KAAK;EACvD,IAAI,eAAe,gBAAgB,iBACjC,OAAO,OAAO,gBAAgB,UAAU;EAE1C,MAAM,oBAAoB,aAAa,QAAQ;EAC/C,IAAI,CAAC,mBAAmB;GACtB,MAAM,UAAU,eAAe,gBAAgB,SAAS,YAAY;GACpE,IAAI,YAAY,WAAW,qBAAqB,eAAe;GAC/D,OAAO,OAAO,gBAAgB,OAAO;EACvC;EACA,MAAM,UAAU,MAAM,kBAAkB,SAAS,cAAc;EAC/D,MAAM,oBAAoB,eAAe;EACzC,MAAM,QAAQ,qBAAqB,oBAAoB,iBAAiB;EACxE,IAAI,SAAS,CAAC,QAAQ,yBAAyB,oBAAoB,mBAAmB,cAAc,GAClG,OAAO,OAAO,gBAAgB,SAAS,KAAK;EAE9C,IAAI,YAAY,WAAW,qBAAqB,eAAe;EAC/D,OAAO,OAAO,gBAAgB,OAAO;CACvC;CAEA,OAAO;EACL,WAAW,QAAQ;EACnB;EACA;EACA,MAAM,QAAQ,SAAS,WAAW;GAChC,MAAM,YAAY,kBAAkB,OAAO;GAC3C,IAAI,WAAW;IACb,MAAM,UAAU,UAAU,WAAW,sBAAsB,IAAI,aAAa;IAC5E,OAAO,OAAO,KAAK,OAAO,GAAG,SAAS,SAAS;GACjD;GACA,MAAM,qBAAqB,eAAe;GAC1C,IAAI,mBAAmB,cAAc,QAAQ,WAC3C,OAAO,OAAO,KAAK,OAAO,GAAG,SAAS,wBAAwB;GAEhE,IAAI,mBAAmB,mBAAmB,gBACxC,OAAO,OAAO,KAAK,OAAO,GAAG,SAAS,2BAA2B;GAEnE,IAAI,QAAQ,OAAO,SAAS,WAAW,aAAa,IAAI,QAAQ,WAAW;GAE3E,IAAI,QAAQ,OAAO,SAAS,WAAW;IACrC,MAAM,iBAAiB,KAAK,OAAO;IACnC,IAAI,eAAe,YAAY,SAAS,oBAAoB,GAAG,OAAO,OAAO,gBAAgB,WAAW;IACxG,OAAO,YAAY,SAAS,gBAAgB,WAAW,kBAAkB;GAC3E;GAEA,qBAAqB;GACrB,MAAM,SAAS,eAAe,KAAK,YAAY;IAC7C,MAAM,iBAAiB,KAAK,OAAO;IACnC,MAAM,QAAQ,qBAAqB,oBAAoB,eAAe,CAAC;IACvE,IAAI,OAAO,OAAO,OAAO,gBAAgB,SAAS,KAAK;IACvD,IAAI,eAAe,YAAY,SAAS,oBAAoB,GAAG,OAAO,OAAO,gBAAgB,WAAW;IACxG,OAAO,kBAAkB,SAAS,gBAAgB,WAAW,kBAAkB;GACjF,CAAC;GACD,iBAAiB,OAAO,WAChB,KAAA,SACA,KAAA,CACR;GACA,IAAI;IACF,OAAO,MAAM;GACf,UAAU;IACR,qBAAqB;GACvB;EACF;EACA,UAAU;GACR,IAAI,UAAU;GACd,WAAW;GACX,qBAAqB,KAAA;GACrB,aAAa,MAAM;GACnB,IAAI,sBAAsB,GAAG,iBAAiB,QAAQ,QAAQ;EAChE;CACF;AACF"}