every-plugin 2.10.1 → 3.0.0-rc.3

package/dist/shared-deps-spec.mjs

@@ -0,0 +1,368 @@
+import { createRequire } from "node:module";
+import { Data } from "effect";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+//#region src/shared-deps-spec.ts
+/**
+* SharedDependencySpec: the one module owning shared-dependency names,
+* criticality, version resolution, and fallback policy across the Module
+* Federation graph. Four consumers derive from it — the rspack config
+* factory (plugin builds), the rsbuild config factory (ui remotes), the
+* runtime mf-config (the every-plugin MF instance), and the host's shared
+* pre-registration — so a name or criticality can never disagree between
+* them, and an unresolved version fails the build loudly instead of
+* silently degrading to "*"/"latest" (which disables the strict-singleton
+* guard).
+*
+* Lists:
+* - core: shared by the host and server-side plugin remotes (every-plugin,
+*   effect, zod, @orpc/*). Effect-critical entries pin the exact installed
+*   version (strictVersion) — the version-check machinery in
+*   runtime/services/shared-identity.ts relies on it.
+* - ui: shared by the core ui provider and ui remotes (react, react-dom,
+*   @orpc/client, @orpc/contract, TanStack, lingui, the everything-dev
+*   session/i18n subpath modules). All strict singletons; consumers add
+*   `import: false`.
+*/
+const require = createRequire(import.meta.url);
+var SharedDependencyResolutionError = class extends Data.TaggedError("SharedDependencyResolutionError") {
+	constructor(packageName, searched) {
+		super({
+			packageName,
+			searched
+		});
+	}
+	get message() {
+		return `Could not resolve shared dependency "${this.packageName}". Looked in:\n` + this.searched.map((location) => `  - ${location}`).join("\n") + "\nUnresolved shared dependencies fail loudly (no \"*\", no \"latest\" fallback) — install the package in the resolving workspace or pin a resolvable version.";
+	}
+};
+const CORE_SHARED_DEPS = [
+	{
+		name: "every-plugin",
+		singleton: true,
+		critical: true,
+		resolution: "self"
+	},
+	{
+		name: "effect",
+		singleton: true,
+		critical: true,
+		resolution: "package"
+	},
+	{
+		name: "zod",
+		singleton: true,
+		critical: false,
+		resolution: "package"
+	},
+	{
+		name: "@orpc/contract",
+		singleton: true,
+		critical: true,
+		resolution: "package"
+	},
+	{
+		name: "@orpc/client",
+		singleton: true,
+		critical: true,
+		resolution: "package"
+	},
+	{
+		name: "@orpc/server",
+		singleton: true,
+		critical: true,
+		resolution: "package"
+	}
+];
+const coreCriticalNames = CORE_SHARED_DEPS.flatMap((spec) => spec.critical ? [spec.name] : []);
+/**
+* Effect-critical shared names, derived from the core list's `critical: true`
+* entries — the one source of criticality (`strictVersion` pinning in the
+* runtime's version-check machinery keys off this list).
+*/
+const EFFECT_CRITICAL_SHARED_DEPS = coreCriticalNames;
+const isEffectCriticalSharedDep = (name) => EFFECT_CRITICAL_SHARED_DEPS.includes(name);
+const UI_SHARED_DEPS = [
+	{
+		name: "react",
+		singleton: true,
+		critical: true,
+		resolution: "package"
+	},
+	{
+		name: "react-dom",
+		singleton: true,
+		critical: true,
+		resolution: "package"
+	},
+	{
+		name: "@orpc/client",
+		singleton: true,
+		critical: true,
+		resolution: "package"
+	},
+	{
+		name: "@orpc/contract",
+		singleton: true,
+		critical: true,
+		resolution: "package"
+	},
+	{
+		name: "@tanstack/react-query",
+		singleton: true,
+		critical: true,
+		resolution: "package"
+	},
+	{
+		name: "@tanstack/react-router",
+		singleton: true,
+		critical: true,
+		resolution: "package"
+	},
+	{
+		name: "@lingui/core",
+		singleton: true,
+		critical: true,
+		resolution: "package"
+	},
+	{
+		name: "@lingui/react",
+		singleton: true,
+		critical: true,
+		resolution: "package"
+	},
+	{
+		name: "everything-dev/ui/auth",
+		singleton: true,
+		critical: true,
+		resolution: "subpath"
+	},
+	{
+		name: "everything-dev/ui/i18n",
+		singleton: true,
+		critical: true,
+		resolution: "subpath"
+	}
+];
+const SHARED_DEP_SPECS = (() => {
+	const byName = /* @__PURE__ */ new Map();
+	for (const spec of [...CORE_SHARED_DEPS, ...UI_SHARED_DEPS]) {
+		const existing = byName.get(spec.name);
+		if (existing) {
+			if (existing.critical !== spec.critical) throw new Error(`Shared dependency spec conflict for "${spec.name}": criticality disagrees between the core and ui lists`);
+			continue;
+		}
+		byName.set(spec.name, spec);
+	}
+	return [...byName.values()];
+})();
+function searchedNote(target) {
+	return `require.resolve("${target}")`;
+}
+function findPackageJsonVersion(startDir, searched) {
+	let currentDir = startDir;
+	for (let i = 0; i < 5; i += 1) {
+		const packageJsonPath = join(currentDir, "package.json");
+		searched.push(packageJsonPath);
+		if (existsSync(packageJsonPath)) try {
+			const version = JSON.parse(readFileSync(packageJsonPath, "utf8")).version;
+			if (version) return version;
+		} catch {}
+		const parent = dirname(currentDir);
+		if (parent === currentDir) break;
+		currentDir = parent;
+	}
+	return null;
+}
+function resolveSubpathVersion(request, workspaceRoot, searched) {
+	if (request.startsWith("@")) throw new Error(`Scoped-package subpath "${request}" is not supported — subpath version resolution handles unscoped specifiers only (the known subpath specs, everything-dev/ui/*, are unscoped).`);
+	const packageName = request.split("/")[0] ?? request;
+	const subpath = request.split("/").slice(1).join("/");
+	const candidates = [];
+	if (workspaceRoot) candidates.push(join(workspaceRoot, "node_modules", packageName, "package.json"));
+	const resolveRequests = [
+		{
+			request: `${packageName}/${subpath}`,
+			...workspaceRoot ? { paths: [workspaceRoot] } : {}
+		},
+		{ request: `${packageName}/${subpath}` },
+		{
+			request: `${packageName}/package.json`,
+			...workspaceRoot ? { paths: [workspaceRoot] } : {}
+		},
+		{ request: `${packageName}/package.json` }
+	];
+	for (const { request: target, paths } of resolveRequests) try {
+		const resolved = require.resolve(target, paths ? { paths } : void 0);
+		searched.push(resolved);
+		candidates.push(resolved.endsWith("package.json") ? resolved : resolve(dirname(resolved), "..", "..", "package.json"));
+	} catch {
+		searched.push(searchedNote(target));
+	}
+	for (const candidate of candidates) {
+		if (!existsSync(candidate)) continue;
+		try {
+			const version = JSON.parse(readFileSync(candidate, "utf8")).version;
+			if (version) return version;
+		} catch {}
+	}
+	return null;
+}
+function resolveSharedVersion(name, options = {}) {
+	const searched = [];
+	const { workspaceRoot, resolution = "package" } = options;
+	if (resolution === "subpath") {
+		const version = resolveSubpathVersion(name, workspaceRoot, searched);
+		if (version) return version;
+		throw new SharedDependencyResolutionError(name, searched);
+	}
+	const roots = workspaceRoot ? [workspaceRoot, void 0] : [void 0];
+	for (const root of roots) try {
+		const resolved = root ? require.resolve(name, { paths: [root] }) : require.resolve(name);
+		searched.push(resolved);
+		const version = findPackageJsonVersion(dirname(resolved), searched);
+		if (version) return version;
+	} catch {
+		searched.push(searchedNote(name));
+	}
+	throw new SharedDependencyResolutionError(name, searched);
+}
+function resolveOwnVersion(searched) {
+	const localPackageJson = join(dirname(fileURLToPath(import.meta.url)), "..", "package.json");
+	searched.push(localPackageJson);
+	if (existsSync(localPackageJson)) try {
+		const version = JSON.parse(readFileSync(localPackageJson, "utf8")).version;
+		if (version) return version;
+	} catch {}
+	try {
+		const resolved = require.resolve("every-plugin/package.json");
+		searched.push(resolved);
+		const version = JSON.parse(readFileSync(resolved, "utf8")).version;
+		if (version) return version;
+	} catch {
+		searched.push(searchedNote("every-plugin/package.json"));
+	}
+	throw new SharedDependencyResolutionError("every-plugin", searched);
+}
+function shareConfigFor(spec, version) {
+	return spec.critical ? {
+		requiredVersion: version,
+		singleton: true,
+		strictVersion: true,
+		eager: false,
+		shareScope: "default"
+	} : {
+		requiredVersion: false,
+		singleton: true,
+		strictVersion: false,
+		eager: false,
+		shareScope: "default"
+	};
+}
+function specVersion(spec, options) {
+	if (spec.resolution === "self") return options.ownVersion ?? resolveOwnVersion([`own package.json of "${spec.name}"`]);
+	return resolveSharedVersion(spec.name, { resolution: spec.resolution === "subpath" ? "subpath" : "package" });
+}
+function getPluginSharedDependencies(options = {}) {
+	return Object.fromEntries(CORE_SHARED_DEPS.map((spec) => {
+		const version = specVersion(spec, options);
+		return [spec.name, {
+			version,
+			...shareConfigFor(spec, version)
+		}];
+	}));
+}
+function toHostSharedEntry(name, config) {
+	const normalized = normalizeSharedConfig(config, name);
+	return {
+		version: normalized.version,
+		shareScope: normalized.shareScope,
+		shareConfig: {
+			singleton: normalized.singleton,
+			requiredVersion: normalized.requiredVersion,
+			strictVersion: normalized.strictVersion,
+			eager: normalized.eager
+		}
+	};
+}
+/**
+* The runtime mf-config's core shared map: the same entries
+* `getPluginSharedDependencies` assembles, shaped through the one host mapper
+* (`toHostSharedEntry`) so both consumers derive from a single entry type.
+*/
+function buildMfCoreSharedDependencies(options = {}) {
+	return Object.fromEntries(Object.entries(getPluginSharedDependencies(options)).map(([name, config]) => [name, toHostSharedEntry(name, config)]));
+}
+function createUiSharedDeps(options = {}) {
+	const deps = {};
+	for (const spec of UI_SHARED_DEPS) {
+		const version = resolveSharedVersion(spec.name, {
+			workspaceRoot: options.workspaceRoot,
+			resolution: spec.resolution === "subpath" ? "subpath" : "package"
+		});
+		const strict = options.strictVersion !== false;
+		deps[spec.name] = {
+			version,
+			requiredVersion: strict ? version : false,
+			singleton: true,
+			strictVersion: strict,
+			eager: false,
+			shareScope: "default",
+			...options.role === "consumer" ? { import: false } : {}
+		};
+	}
+	return deps;
+}
+const UNRESOLVED_VERSIONS = /* @__PURE__ */ new Set([
+	"*",
+	"latest",
+	""
+]);
+function assertResolvedSharedVersion(name, version) {
+	if (typeof version !== "string" || UNRESOLVED_VERSIONS.has(version.trim())) throw new SharedDependencyResolutionError(name, [`declared version ${JSON.stringify(version ?? null)} is not resolvable — "*", "latest", and empty fail loudly instead of disabling the strict-singleton guard`]);
+	return version;
+}
+function normalizeSharedConfig(config, name) {
+	return {
+		version: assertResolvedSharedVersion(name, config.version),
+		requiredVersion: config.requiredVersion ?? false,
+		singleton: config.singleton ?? false,
+		strictVersion: config.strictVersion ?? false,
+		eager: config.eager ?? false,
+		shareScope: config.shareScope ?? "default"
+	};
+}
+function comparableSharedConfig(config) {
+	return {
+		version: config.version,
+		requiredVersion: config.requiredVersion ?? false,
+		singleton: config.singleton ?? false,
+		strictVersion: config.strictVersion ?? false,
+		eager: config.eager ?? false,
+		shareScope: config.shareScope ?? "default"
+	};
+}
+function isSameSharedConfig(a, b) {
+	const left = comparableSharedConfig(a);
+	const right = comparableSharedConfig(b);
+	return left.version === right.version && left.requiredVersion === right.requiredVersion && left.singleton === right.singleton && left.strictVersion === right.strictVersion && left.eager === right.eager && left.shareScope === right.shareScope;
+}
+function mergeSharedMaps(...maps) {
+	const merged = {};
+	for (const map of maps) {
+		if (!map) continue;
+		for (const [name, config] of Object.entries(map)) {
+			const normalized = normalizeSharedConfig(config, name);
+			const existing = merged[name];
+			if (existing && !isSameSharedConfig(existing, normalized)) throw new Error(`Conflicting shared dependency "${name}" in shared dependency configuration`);
+			merged[name] = normalized;
+		}
+	}
+	return merged;
+}
+
+//#endregion
+export { CORE_SHARED_DEPS, EFFECT_CRITICAL_SHARED_DEPS, SHARED_DEP_SPECS, SharedDependencyResolutionError, UI_SHARED_DEPS, assertResolvedSharedVersion, buildMfCoreSharedDependencies, createUiSharedDeps, getPluginSharedDependencies, isEffectCriticalSharedDep, isSameSharedConfig, mergeSharedMaps, normalizeSharedConfig, resolveSharedVersion, shareConfigFor, toHostSharedEntry };
+//# sourceMappingURL=shared-deps-spec.mjs.map

package/dist/shared-deps-spec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-deps-spec.mjs","names":[],"sources":["../src/shared-deps-spec.ts"],"sourcesContent":["/**\n * SharedDependencySpec: the one module owning shared-dependency names,\n * criticality, version resolution, and fallback policy across the Module\n * Federation graph. Four consumers derive from it — the rspack config\n * factory (plugin builds), the rsbuild config factory (ui remotes), the\n * runtime mf-config (the every-plugin MF instance), and the host's shared\n * pre-registration — so a name or criticality can never disagree between\n * them, and an unresolved version fails the build loudly instead of\n * silently degrading to \"*\"/\"latest\" (which disables the strict-singleton\n * guard).\n *\n * Lists:\n * - core: shared by the host and server-side plugin remotes (every-plugin,\n *   effect, zod, @orpc/*). Effect-critical entries pin the exact installed\n *   version (strictVersion) — the version-check machinery in\n *   runtime/services/shared-identity.ts relies on it.\n * - ui: shared by the core ui provider and ui remotes (react, react-dom,\n *   @orpc/client, @orpc/contract, TanStack, lingui, the everything-dev\n *   session/i18n subpath modules). All strict singletons; consumers add\n *   `import: false`.\n */\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { Data } from \"effect\";\n\nconst require = createRequire(import.meta.url);\n\nexport class SharedDependencyResolutionError extends Data.TaggedError(\n  \"SharedDependencyResolutionError\",\n)<{\n  readonly packageName: string;\n  readonly searched: string[];\n}> {\n  constructor(packageName: string, searched: string[]) {\n    super({\n      packageName,\n      searched,\n    });\n  }\n\n  override get message() {\n    return (\n      `Could not resolve shared dependency \"${this.packageName}\". Looked in:\\n` +\n      this.searched.map((location) => `  - ${location}`).join(\"\\n\") +\n      `\\nUnresolved shared dependencies fail loudly (no \"*\", no \"latest\" fallback) — ` +\n      `install the package in the resolving workspace or pin a resolvable version.`\n    );\n  }\n}\n\nexport type SharedDependencyResolution = \"self\" | \"package\" | \"subpath\";\n\nexport interface SharedDependencySpec {\n  name: string;\n  singleton: true;\n  /** exact-version pin (requiredVersion = resolved version, strictVersion = true) */\n  critical: boolean;\n  resolution: SharedDependencyResolution;\n}\n\nexport const CORE_SHARED_DEPS = [\n  { name: \"every-plugin\", singleton: true, critical: true, resolution: \"self\" },\n  { name: \"effect\", singleton: true, critical: true, resolution: \"package\" },\n  { name: \"zod\", singleton: true, critical: false, resolution: \"package\" },\n  { name: \"@orpc/contract\", singleton: true, critical: true, resolution: \"package\" },\n  { name: \"@orpc/client\", singleton: true, critical: true, resolution: \"package\" },\n  { name: \"@orpc/server\", singleton: true, critical: true, resolution: \"package\" },\n  // v1's proven sharing set, restored: @orpc/openapi, @orpc/experimental-effect,\n  // and @orpc/publisher joined this list in the v2 fleet-spec pass and their\n  // share-scope consumption broke plugin loading at runtime\n  // (__webpack_modules__[r] is not a function — the runtime's import()-based\n  // provides hand the consumer an ESM namespace where a module factory is\n  // expected). They stay declared in each workspace's package.json and are\n  // bundled per workspace instead.\n] as const satisfies readonly SharedDependencySpec[];\n\nexport type CoreSharedDepName = (typeof CORE_SHARED_DEPS)[number][\"name\"];\n\nconst coreCriticalNames = CORE_SHARED_DEPS.flatMap((spec) => (spec.critical ? [spec.name] : []));\n\n/**\n * Effect-critical shared names, derived from the core list's `critical: true`\n * entries — the one source of criticality (`strictVersion` pinning in the\n * runtime's version-check machinery keys off this list).\n */\nexport const EFFECT_CRITICAL_SHARED_DEPS: readonly EffectCriticalSharedDepName[] =\n  coreCriticalNames;\n\nexport type EffectCriticalSharedDepName = (typeof coreCriticalNames)[number];\n\nexport const isEffectCriticalSharedDep = (name: string): boolean =>\n  (EFFECT_CRITICAL_SHARED_DEPS as readonly string[]).includes(name);\n\nexport const UI_SHARED_DEPS = [\n  { name: \"react\", singleton: true, critical: true, resolution: \"package\" },\n  { name: \"react-dom\", singleton: true, critical: true, resolution: \"package\" },\n  { name: \"@orpc/client\", singleton: true, critical: true, resolution: \"package\" },\n  { name: \"@orpc/contract\", singleton: true, critical: true, resolution: \"package\" },\n  { name: \"@tanstack/react-query\", singleton: true, critical: true, resolution: \"package\" },\n  { name: \"@tanstack/react-router\", singleton: true, critical: true, resolution: \"package\" },\n  { name: \"@lingui/core\", singleton: true, critical: true, resolution: \"package\" },\n  { name: \"@lingui/react\", singleton: true, critical: true, resolution: \"package\" },\n  {\n    name: \"everything-dev/ui/auth\",\n    singleton: true,\n    critical: true,\n    resolution: \"subpath\",\n  },\n  {\n    name: \"everything-dev/ui/i18n\",\n    singleton: true,\n    critical: true,\n    resolution: \"subpath\",\n  },\n] as const satisfies readonly SharedDependencySpec[];\n\nexport const SHARED_DEP_SPECS: readonly SharedDependencySpec[] = (() => {\n  const byName = new Map<string, SharedDependencySpec>();\n  for (const spec of [...CORE_SHARED_DEPS, ...UI_SHARED_DEPS]) {\n    const existing = byName.get(spec.name);\n    if (existing) {\n      if (existing.critical !== spec.critical) {\n        throw new Error(\n          `Shared dependency spec conflict for \"${spec.name}\": criticality disagrees between the core and ui lists`,\n        );\n      }\n      continue;\n    }\n    byName.set(spec.name, spec);\n  }\n  return [...byName.values()];\n})();\n\nexport interface SharedDependencyConfig {\n  version: string;\n  requiredVersion: string | false;\n  singleton: boolean;\n  strictVersion: boolean;\n  eager: boolean;\n  shareScope: string;\n}\n\nexport type SharedDependencies = Record<string, SharedDependencyConfig>;\n\nexport type SharedConfigInput = {\n  version: string;\n  requiredVersion?: string | false;\n  singleton?: boolean;\n  strictVersion?: boolean;\n  eager?: boolean;\n  shareScope?: string;\n};\n\nexport interface SharedDependencyResolutionOptions {\n  /** the building workspace to resolve from; default is this module's own location */\n  workspaceRoot?: string;\n  resolution?: \"package\" | \"subpath\";\n}\n\nfunction searchedNote(target: string): string {\n  return `require.resolve(\"${target}\")`;\n}\n\nfunction findPackageJsonVersion(startDir: string, searched: string[]): string | null {\n  let currentDir = startDir;\n  for (let i = 0; i < 5; i += 1) {\n    const packageJsonPath = join(currentDir, \"package.json\");\n    searched.push(packageJsonPath);\n    if (existsSync(packageJsonPath)) {\n      try {\n        const version = (JSON.parse(readFileSync(packageJsonPath, \"utf8\")) as { version?: string })\n          .version;\n        if (version) return version;\n      } catch {}\n    }\n    const parent = dirname(currentDir);\n    if (parent === currentDir) break;\n    currentDir = parent;\n  }\n  return null;\n}\n\nfunction resolveSubpathVersion(\n  request: string,\n  workspaceRoot: string | undefined,\n  searched: string[],\n): string | null {\n  if (request.startsWith(\"@\")) {\n    throw new Error(\n      `Scoped-package subpath \"${request}\" is not supported — subpath version resolution ` +\n        `handles unscoped specifiers only (the known subpath specs, everything-dev/ui/*, are unscoped).`,\n    );\n  }\n  const packageName = request.split(\"/\")[0] ?? request;\n  const subpath = request.split(\"/\").slice(1).join(\"/\");\n  const candidates: string[] = [];\n  if (workspaceRoot) {\n    candidates.push(join(workspaceRoot, \"node_modules\", packageName, \"package.json\"));\n  }\n  const resolveRequests: Array<{ request: string; paths?: string[] }> = [\n    { request: `${packageName}/${subpath}`, ...(workspaceRoot ? { paths: [workspaceRoot] } : {}) },\n    { request: `${packageName}/${subpath}` },\n    {\n      request: `${packageName}/package.json`,\n      ...(workspaceRoot ? { paths: [workspaceRoot] } : {}),\n    },\n    { request: `${packageName}/package.json` },\n  ];\n  for (const { request: target, paths } of resolveRequests) {\n    try {\n      const resolved = require.resolve(target, paths ? { paths } : undefined);\n      searched.push(resolved);\n      candidates.push(\n        resolved.endsWith(\"package.json\")\n          ? resolved\n          : resolve(dirname(resolved), \"..\", \"..\", \"package.json\"),\n      );\n    } catch {\n      searched.push(searchedNote(target));\n    }\n  }\n  for (const candidate of candidates) {\n    if (!existsSync(candidate)) continue;\n    try {\n      const version = (JSON.parse(readFileSync(candidate, \"utf8\")) as { version?: string }).version;\n      if (version) return version;\n    } catch {}\n  }\n  return null;\n}\n\nexport function resolveSharedVersion(\n  name: string,\n  options: SharedDependencyResolutionOptions = {},\n): string {\n  const searched: string[] = [];\n  const { workspaceRoot, resolution = \"package\" } = options;\n\n  if (resolution === \"subpath\") {\n    const version = resolveSubpathVersion(name, workspaceRoot, searched);\n    if (version) return version;\n    throw new SharedDependencyResolutionError(name, searched);\n  }\n\n  const roots: Array<string | undefined> = workspaceRoot ? [workspaceRoot, undefined] : [undefined];\n  for (const root of roots) {\n    try {\n      const resolved = root ? require.resolve(name, { paths: [root] }) : require.resolve(name);\n      searched.push(resolved);\n      const version = findPackageJsonVersion(dirname(resolved), searched);\n      if (version) return version;\n    } catch {\n      searched.push(searchedNote(name));\n    }\n  }\n  throw new SharedDependencyResolutionError(name, searched);\n}\n\nfunction resolveOwnVersion(searched: string[]): string {\n  const localPackageJson = join(dirname(fileURLToPath(import.meta.url)), \"..\", \"package.json\");\n  searched.push(localPackageJson);\n  if (existsSync(localPackageJson)) {\n    try {\n      const version = (JSON.parse(readFileSync(localPackageJson, \"utf8\")) as { version?: string })\n        .version;\n      if (version) return version;\n    } catch {}\n  }\n  try {\n    const resolved = require.resolve(\"every-plugin/package.json\");\n    searched.push(resolved);\n    const version = (JSON.parse(readFileSync(resolved, \"utf8\")) as { version?: string }).version;\n    if (version) return version;\n  } catch {\n    searched.push(searchedNote(\"every-plugin/package.json\"));\n  }\n  throw new SharedDependencyResolutionError(\"every-plugin\", searched);\n}\n\nexport function shareConfigFor(\n  spec: SharedDependencySpec,\n  version: string,\n): Omit<SharedDependencyConfig, \"version\"> {\n  return spec.critical\n    ? {\n        requiredVersion: version,\n        singleton: true,\n        strictVersion: true,\n        eager: false,\n        shareScope: \"default\",\n      }\n    : {\n        requiredVersion: false,\n        singleton: true,\n        strictVersion: false,\n        eager: false,\n        shareScope: \"default\",\n      };\n}\n\nexport interface SharedDepsBuildOptions {\n  /** the every-plugin share version; default resolves the installed package.json */\n  ownVersion?: string;\n}\n\nfunction specVersion(spec: SharedDependencySpec, options: SharedDepsBuildOptions): string {\n  if (spec.resolution === \"self\") {\n    return options.ownVersion ?? resolveOwnVersion([`own package.json of \"${spec.name}\"`]);\n  }\n  return resolveSharedVersion(spec.name, {\n    resolution: spec.resolution === \"subpath\" ? \"subpath\" : \"package\",\n  });\n}\n\nexport function getPluginSharedDependencies(\n  options: SharedDepsBuildOptions = {},\n): SharedDependencies {\n  return Object.fromEntries(\n    CORE_SHARED_DEPS.map((spec) => {\n      const version = specVersion(spec, options);\n      return [spec.name, { version, ...shareConfigFor(spec, version) }];\n    }),\n  );\n}\n\nexport interface HostSharedEntry {\n  version: string;\n  shareScope: string;\n  shareConfig: {\n    singleton: boolean;\n    requiredVersion: string | false;\n    strictVersion: boolean;\n    eager: boolean;\n  };\n}\n\nexport function toHostSharedEntry(name: string, config: SharedConfigInput): HostSharedEntry {\n  const normalized = normalizeSharedConfig(config, name);\n  return {\n    version: normalized.version,\n    shareScope: normalized.shareScope,\n    shareConfig: {\n      singleton: normalized.singleton,\n      requiredVersion: normalized.requiredVersion,\n      strictVersion: normalized.strictVersion,\n      eager: normalized.eager,\n    },\n  };\n}\n\n/**\n * The runtime mf-config's core shared map: the same entries\n * `getPluginSharedDependencies` assembles, shaped through the one host mapper\n * (`toHostSharedEntry`) so both consumers derive from a single entry type.\n */\nexport function buildMfCoreSharedDependencies(\n  options: SharedDepsBuildOptions = {},\n): Record<string, HostSharedEntry> {\n  return Object.fromEntries(\n    Object.entries(getPluginSharedDependencies(options)).map(([name, config]) => [\n      name,\n      toHostSharedEntry(name, config),\n    ]),\n  );\n}\n\nexport interface UiSharedDepEntry {\n  version: string;\n  requiredVersion: string | false;\n  singleton: true;\n  strictVersion: boolean;\n  eager: false;\n  shareScope: \"default\";\n  /** consumer role only: no bundled fallback copy — the provider provides */\n  import?: false;\n}\n\nexport interface UiSharedDepsOptions {\n  /** explicit core-shell parity opt-out; default is the strict singleton */\n  strictVersion?: boolean;\n  role?: \"provider\" | \"consumer\";\n  workspaceRoot?: string;\n}\n\nexport function createUiSharedDeps(\n  options: UiSharedDepsOptions = {},\n): Record<string, UiSharedDepEntry> {\n  const deps: Record<string, UiSharedDepEntry> = {};\n  for (const spec of UI_SHARED_DEPS) {\n    const version = resolveSharedVersion(spec.name, {\n      workspaceRoot: options.workspaceRoot,\n      resolution: spec.resolution === \"subpath\" ? \"subpath\" : \"package\",\n    });\n    const strict = options.strictVersion !== false;\n    deps[spec.name] = {\n      version,\n      requiredVersion: strict ? version : false,\n      singleton: true,\n      strictVersion: strict,\n      eager: false,\n      shareScope: \"default\",\n      ...(options.role === \"consumer\" ? { import: false as const } : {}),\n    };\n  }\n  return deps;\n}\n\nconst UNRESOLVED_VERSIONS = new Set([\"*\", \"latest\", \"\"]);\n\nexport function assertResolvedSharedVersion(name: string, version: unknown): string {\n  if (typeof version !== \"string\" || UNRESOLVED_VERSIONS.has(version.trim())) {\n    throw new SharedDependencyResolutionError(name, [\n      `declared version ${JSON.stringify(version ?? null)} is not resolvable — \"*\", \"latest\", and empty fail loudly instead of disabling the strict-singleton guard`,\n    ]);\n  }\n  return version;\n}\n\nexport function normalizeSharedConfig(\n  config: SharedConfigInput,\n  name: string,\n): SharedDependencyConfig {\n  const version = assertResolvedSharedVersion(name, config.version);\n  return {\n    version,\n    requiredVersion: config.requiredVersion ?? false,\n    singleton: config.singleton ?? false,\n    strictVersion: config.strictVersion ?? false,\n    eager: config.eager ?? false,\n    shareScope: config.shareScope ?? \"default\",\n  };\n}\n\nfunction comparableSharedConfig(config: SharedConfigInput) {\n  return {\n    version: config.version,\n    requiredVersion: config.requiredVersion ?? false,\n    singleton: config.singleton ?? false,\n    strictVersion: config.strictVersion ?? false,\n    eager: config.eager ?? false,\n    shareScope: config.shareScope ?? \"default\",\n  };\n}\n\nexport function isSameSharedConfig(a: SharedConfigInput, b: SharedConfigInput): boolean {\n  const left = comparableSharedConfig(a);\n  const right = comparableSharedConfig(b);\n  return (\n    left.version === right.version &&\n    left.requiredVersion === right.requiredVersion &&\n    left.singleton === right.singleton &&\n    left.strictVersion === right.strictVersion &&\n    left.eager === right.eager &&\n    left.shareScope === right.shareScope\n  );\n}\n\nexport function mergeSharedMaps(\n  ...maps: Array<Record<string, SharedConfigInput> | undefined>\n): Record<string, SharedDependencyConfig> {\n  const merged: Record<string, SharedDependencyConfig> = {};\n  for (const map of maps) {\n    if (!map) continue;\n    for (const [name, config] of Object.entries(map)) {\n      const normalized = normalizeSharedConfig(config, name);\n      const existing = merged[name];\n      if (existing && !isSameSharedConfig(existing, normalized)) {\n        throw new Error(\n          `Conflicting shared dependency \"${name}\" in shared dependency configuration`,\n        );\n      }\n      merged[name] = normalized;\n    }\n  }\n  return merged;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,MAAM,UAAU,cAAc,YAAY,GAAG;AAE7C,IAAa,kCAAb,cAAqD,KAAK,YACxD,iCACF,CAAC,CAGE;CACD,YAAY,aAAqB,UAAoB;EACnD,MAAM;GACJ;GACA;EACF,CAAC;CACH;CAEA,IAAa,UAAU;EACrB,OACE,wCAAwC,KAAK,YAAY,mBACzD,KAAK,SAAS,KAAK,aAAa,OAAO,UAAU,CAAC,CAAC,KAAK,IAAI,IAC5D;CAGJ;AACF;AAYA,MAAa,mBAAmB;CAC9B;EAAE,MAAM;EAAgB,WAAW;EAAM,UAAU;EAAM,YAAY;CAAO;CAC5E;EAAE,MAAM;EAAU,WAAW;EAAM,UAAU;EAAM,YAAY;CAAU;CACzE;EAAE,MAAM;EAAO,WAAW;EAAM,UAAU;EAAO,YAAY;CAAU;CACvE;EAAE,MAAM;EAAkB,WAAW;EAAM,UAAU;EAAM,YAAY;CAAU;CACjF;EAAE,MAAM;EAAgB,WAAW;EAAM,UAAU;EAAM,YAAY;CAAU;CAC/E;EAAE,MAAM;EAAgB,WAAW;EAAM,UAAU;EAAM,YAAY;CAAU;AAQjF;AAIA,MAAM,oBAAoB,iBAAiB,SAAS,SAAU,KAAK,WAAW,CAAC,KAAK,IAAI,IAAI,CAAC,CAAE;;;;;;AAO/F,MAAa,8BACX;AAIF,MAAa,6BAA6B,SACvC,4BAAkD,SAAS,IAAI;AAElE,MAAa,iBAAiB;CAC5B;EAAE,MAAM;EAAS,WAAW;EAAM,UAAU;EAAM,YAAY;CAAU;CACxE;EAAE,MAAM;EAAa,WAAW;EAAM,UAAU;EAAM,YAAY;CAAU;CAC5E;EAAE,MAAM;EAAgB,WAAW;EAAM,UAAU;EAAM,YAAY;CAAU;CAC/E;EAAE,MAAM;EAAkB,WAAW;EAAM,UAAU;EAAM,YAAY;CAAU;CACjF;EAAE,MAAM;EAAyB,WAAW;EAAM,UAAU;EAAM,YAAY;CAAU;CACxF;EAAE,MAAM;EAA0B,WAAW;EAAM,UAAU;EAAM,YAAY;CAAU;CACzF;EAAE,MAAM;EAAgB,WAAW;EAAM,UAAU;EAAM,YAAY;CAAU;CAC/E;EAAE,MAAM;EAAiB,WAAW;EAAM,UAAU;EAAM,YAAY;CAAU;CAChF;EACE,MAAM;EACN,WAAW;EACX,UAAU;EACV,YAAY;CACd;CACA;EACE,MAAM;EACN,WAAW;EACX,UAAU;EACV,YAAY;CACd;AACF;AAEA,MAAa,0BAA2D;CACtE,MAAM,yBAAS,IAAI,IAAkC;CACrD,KAAK,MAAM,QAAQ,CAAC,GAAG,kBAAkB,GAAG,cAAc,GAAG;EAC3D,MAAM,WAAW,OAAO,IAAI,KAAK,IAAI;EACrC,IAAI,UAAU;GACZ,IAAI,SAAS,aAAa,KAAK,UAC7B,MAAM,IAAI,MACR,wCAAwC,KAAK,KAAK,uDACpD;GAEF;EACF;EACA,OAAO,IAAI,KAAK,MAAM,IAAI;CAC5B;CACA,OAAO,CAAC,GAAG,OAAO,OAAO,CAAC;AAC5B,EAAC,CAAE;AA4BH,SAAS,aAAa,QAAwB;CAC5C,OAAO,oBAAoB,OAAO;AACpC;AAEA,SAAS,uBAAuB,UAAkB,UAAmC;CACnF,IAAI,aAAa;CACjB,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG;EAC7B,MAAM,kBAAkB,KAAK,YAAY,cAAc;EACvD,SAAS,KAAK,eAAe;EAC7B,IAAI,WAAW,eAAe,GAC5B,IAAI;GACF,MAAM,UAAW,KAAK,MAAM,aAAa,iBAAiB,MAAM,CAAC,CAAC,CAC/D;GACH,IAAI,SAAS,OAAO;EACtB,QAAQ,CAAC;EAEX,MAAM,SAAS,QAAQ,UAAU;EACjC,IAAI,WAAW,YAAY;EAC3B,aAAa;CACf;CACA,OAAO;AACT;AAEA,SAAS,sBACP,SACA,eACA,UACe;CACf,IAAI,QAAQ,WAAW,GAAG,GACxB,MAAM,IAAI,MACR,2BAA2B,QAAQ,+IAErC;CAEF,MAAM,cAAc,QAAQ,MAAM,GAAG,CAAC,CAAC,MAAM;CAC7C,MAAM,UAAU,QAAQ,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG;CACpD,MAAM,aAAuB,CAAC;CAC9B,IAAI,eACF,WAAW,KAAK,KAAK,eAAe,gBAAgB,aAAa,cAAc,CAAC;CAElF,MAAM,kBAAgE;EACpE;GAAE,SAAS,GAAG,YAAY,GAAG;GAAW,GAAI,gBAAgB,EAAE,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC;EAAG;EAC7F,EAAE,SAAS,GAAG,YAAY,GAAG,UAAU;EACvC;GACE,SAAS,GAAG,YAAY;GACxB,GAAI,gBAAgB,EAAE,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC;EACpD;EACA,EAAE,SAAS,GAAG,YAAY,eAAe;CAC3C;CACA,KAAK,MAAM,EAAE,SAAS,QAAQ,WAAW,iBACvC,IAAI;EACF,MAAM,WAAW,QAAQ,QAAQ,QAAQ,QAAQ,EAAE,MAAM,IAAI,MAAS;EACtE,SAAS,KAAK,QAAQ;EACtB,WAAW,KACT,SAAS,SAAS,cAAc,IAC5B,WACA,QAAQ,QAAQ,QAAQ,GAAG,MAAM,MAAM,cAAc,CAC3D;CACF,QAAQ;EACN,SAAS,KAAK,aAAa,MAAM,CAAC;CACpC;CAEF,KAAK,MAAM,aAAa,YAAY;EAClC,IAAI,CAAC,WAAW,SAAS,GAAG;EAC5B,IAAI;GACF,MAAM,UAAW,KAAK,MAAM,aAAa,WAAW,MAAM,CAAC,CAAC,CAA0B;GACtF,IAAI,SAAS,OAAO;EACtB,QAAQ,CAAC;CACX;CACA,OAAO;AACT;AAEA,SAAgB,qBACd,MACA,UAA6C,CAAC,GACtC;CACR,MAAM,WAAqB,CAAC;CAC5B,MAAM,EAAE,eAAe,aAAa,cAAc;CAElD,IAAI,eAAe,WAAW;EAC5B,MAAM,UAAU,sBAAsB,MAAM,eAAe,QAAQ;EACnE,IAAI,SAAS,OAAO;EACpB,MAAM,IAAI,gCAAgC,MAAM,QAAQ;CAC1D;CAEA,MAAM,QAAmC,gBAAgB,CAAC,eAAe,MAAS,IAAI,CAAC,MAAS;CAChG,KAAK,MAAM,QAAQ,OACjB,IAAI;EACF,MAAM,WAAW,OAAO,QAAQ,QAAQ,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,QAAQ,QAAQ,IAAI;EACvF,SAAS,KAAK,QAAQ;EACtB,MAAM,UAAU,uBAAuB,QAAQ,QAAQ,GAAG,QAAQ;EAClE,IAAI,SAAS,OAAO;CACtB,QAAQ;EACN,SAAS,KAAK,aAAa,IAAI,CAAC;CAClC;CAEF,MAAM,IAAI,gCAAgC,MAAM,QAAQ;AAC1D;AAEA,SAAS,kBAAkB,UAA4B;CACrD,MAAM,mBAAmB,KAAK,QAAQ,cAAc,YAAY,GAAG,CAAC,GAAG,MAAM,cAAc;CAC3F,SAAS,KAAK,gBAAgB;CAC9B,IAAI,WAAW,gBAAgB,GAC7B,IAAI;EACF,MAAM,UAAW,KAAK,MAAM,aAAa,kBAAkB,MAAM,CAAC,CAAC,CAChE;EACH,IAAI,SAAS,OAAO;CACtB,QAAQ,CAAC;CAEX,IAAI;EACF,MAAM,WAAW,QAAQ,QAAQ,2BAA2B;EAC5D,SAAS,KAAK,QAAQ;EACtB,MAAM,UAAW,KAAK,MAAM,aAAa,UAAU,MAAM,CAAC,CAAC,CAA0B;EACrF,IAAI,SAAS,OAAO;CACtB,QAAQ;EACN,SAAS,KAAK,aAAa,2BAA2B,CAAC;CACzD;CACA,MAAM,IAAI,gCAAgC,gBAAgB,QAAQ;AACpE;AAEA,SAAgB,eACd,MACA,SACyC;CACzC,OAAO,KAAK,WACR;EACE,iBAAiB;EACjB,WAAW;EACX,eAAe;EACf,OAAO;EACP,YAAY;CACd,IACA;EACE,iBAAiB;EACjB,WAAW;EACX,eAAe;EACf,OAAO;EACP,YAAY;CACd;AACN;AAOA,SAAS,YAAY,MAA4B,SAAyC;CACxF,IAAI,KAAK,eAAe,QACtB,OAAO,QAAQ,cAAc,kBAAkB,CAAC,wBAAwB,KAAK,KAAK,EAAE,CAAC;CAEvF,OAAO,qBAAqB,KAAK,MAAM,EACrC,YAAY,KAAK,eAAe,YAAY,YAAY,UAC1D,CAAC;AACH;AAEA,SAAgB,4BACd,UAAkC,CAAC,GACf;CACpB,OAAO,OAAO,YACZ,iBAAiB,KAAK,SAAS;EAC7B,MAAM,UAAU,YAAY,MAAM,OAAO;EACzC,OAAO,CAAC,KAAK,MAAM;GAAE;GAAS,GAAG,eAAe,MAAM,OAAO;EAAE,CAAC;CAClE,CAAC,CACH;AACF;AAaA,SAAgB,kBAAkB,MAAc,QAA4C;CAC1F,MAAM,aAAa,sBAAsB,QAAQ,IAAI;CACrD,OAAO;EACL,SAAS,WAAW;EACpB,YAAY,WAAW;EACvB,aAAa;GACX,WAAW,WAAW;GACtB,iBAAiB,WAAW;GAC5B,eAAe,WAAW;GAC1B,OAAO,WAAW;EACpB;CACF;AACF;;;;;;AAOA,SAAgB,8BACd,UAAkC,CAAC,GACF;CACjC,OAAO,OAAO,YACZ,OAAO,QAAQ,4BAA4B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,YAAY,CAC3E,MACA,kBAAkB,MAAM,MAAM,CAChC,CAAC,CACH;AACF;AAoBA,SAAgB,mBACd,UAA+B,CAAC,GACE;CAClC,MAAM,OAAyC,CAAC;CAChD,KAAK,MAAM,QAAQ,gBAAgB;EACjC,MAAM,UAAU,qBAAqB,KAAK,MAAM;GAC9C,eAAe,QAAQ;GACvB,YAAY,KAAK,eAAe,YAAY,YAAY;EAC1D,CAAC;EACD,MAAM,SAAS,QAAQ,kBAAkB;EACzC,KAAK,KAAK,QAAQ;GAChB;GACA,iBAAiB,SAAS,UAAU;GACpC,WAAW;GACX,eAAe;GACf,OAAO;GACP,YAAY;GACZ,GAAI,QAAQ,SAAS,aAAa,EAAE,QAAQ,MAAe,IAAI,CAAC;EAClE;CACF;CACA,OAAO;AACT;AAEA,MAAM,sCAAsB,IAAI,IAAI;CAAC;CAAK;CAAU;AAAE,CAAC;AAEvD,SAAgB,4BAA4B,MAAc,SAA0B;CAClF,IAAI,OAAO,YAAY,YAAY,oBAAoB,IAAI,QAAQ,KAAK,CAAC,GACvE,MAAM,IAAI,gCAAgC,MAAM,CAC9C,oBAAoB,KAAK,UAAU,WAAW,IAAI,EAAE,0GACtD,CAAC;CAEH,OAAO;AACT;AAEA,SAAgB,sBACd,QACA,MACwB;CAExB,OAAO;EACL,SAFc,4BAA4B,MAAM,OAAO,OAEjD;EACN,iBAAiB,OAAO,mBAAmB;EAC3C,WAAW,OAAO,aAAa;EAC/B,eAAe,OAAO,iBAAiB;EACvC,OAAO,OAAO,SAAS;EACvB,YAAY,OAAO,cAAc;CACnC;AACF;AAEA,SAAS,uBAAuB,QAA2B;CACzD,OAAO;EACL,SAAS,OAAO;EAChB,iBAAiB,OAAO,mBAAmB;EAC3C,WAAW,OAAO,aAAa;EAC/B,eAAe,OAAO,iBAAiB;EACvC,OAAO,OAAO,SAAS;EACvB,YAAY,OAAO,cAAc;CACnC;AACF;AAEA,SAAgB,mBAAmB,GAAsB,GAA+B;CACtF,MAAM,OAAO,uBAAuB,CAAC;CACrC,MAAM,QAAQ,uBAAuB,CAAC;CACtC,OACE,KAAK,YAAY,MAAM,WACvB,KAAK,oBAAoB,MAAM,mBAC/B,KAAK,cAAc,MAAM,aACzB,KAAK,kBAAkB,MAAM,iBAC7B,KAAK,UAAU,MAAM,SACrB,KAAK,eAAe,MAAM;AAE9B;AAEA,SAAgB,gBACd,GAAG,MACqC;CACxC,MAAM,SAAiD,CAAC;CACxD,KAAK,MAAM,OAAO,MAAM;EACtB,IAAI,CAAC,KAAK;EACV,KAAK,MAAM,CAAC,MAAM,WAAW,OAAO,QAAQ,GAAG,GAAG;GAChD,MAAM,aAAa,sBAAsB,QAAQ,IAAI;GACrD,MAAM,WAAW,OAAO;GACxB,IAAI,YAAY,CAAC,mBAAmB,UAAU,UAAU,GACtD,MAAM,IAAI,MACR,kCAAkC,KAAK,qCACzC;GAEF,OAAO,QAAQ;EACjB;CACF;CACA,OAAO;AACT"}

package/dist/types.d.cts

@@ -1,7 +1,8 @@
+import { PluginWarningInfo } from "./runtime/errors.cjs";
 import { Plugin } from "./plugin.cjs";
-import { Scope } from "effect";
+import { ContractedRouter, RouterClient } from "@orpc/server";
+import { Context, Scope } from "effect";
 import { AnyContractRouter, AnySchema, InferSchemaInput, InferSchemaOutput } from "@orpc/contract";
-import { Router, RouterClient } from "@orpc/server";
 //#region src/types.d.ts
 /**
  * Registry bindings interface - populated via module augmentation
@@ -19,7 +20,7 @@ interface RegisteredPlugins {}
 /**
  * Base type for any plugin instance.
  */
-type AnyPlugin = Plugin<AnyContractRouter, AnySchema, AnySchema, AnySchema | undefined, any>;
+type AnyPlugin = Plugin<AnyContractRouter, AnySchema, AnySchema, AnySchema | undefined>;
 /**
  * Loaded plugin constructor with binding information
  */
@@ -93,11 +94,20 @@ type PluginContext<T> = T extends {
  * Extract router type from plugin binding
  * Uses 'any' for context to support nested router compositions
  */
-type PluginRouterType<T> = Router<PluginContract<T>, any>;
+type PluginRouterType<T> = ContractedRouter<PluginContract<T>, any>;
 /**
  * Extract client type from plugin binding
  */
 type PluginClientType<T> = RouterClient<PluginRouterType<T>>;
+/**
+ * Sibling plugin entry passed to `initialize` and `createRouter`.
+ * `client` creates a typed in-process client for the plugin's router;
+ * `router` is the raw implemented router for cross-plugin merging.
+ */
+type PluginServicesEntry<T = any> = {
+  client: (context?: PluginContextInput<T>) => PluginClientType<T>;
+  router: PluginRouterType<T>;
+};
 /**
  * Extract plugin type from registered plugins by key
  * @param K - The plugin key
@@ -110,11 +120,7 @@ type RegisteredPlugin<K extends keyof R, R = RegisteredPlugins> = R[K] extends {
   variables: infer V extends AnySchema;
   secrets: infer S extends AnySchema;
   context: infer TRequestContext extends AnySchema | undefined;
-} ? Plugin<C, V, S, TRequestContext, any> : never : never;
-/**
- * Extract plugin constructor type from registry entry
- */
-type PluginConstructor<K extends keyof R, R = RegisteredPlugins> = RegisteredPlugin<K, R>;
+} ? Plugin<C, V, S, TRequestContext> : never : never;
 /**
  * Extract context input type from plugin binding (for client creation)
  */
@@ -126,10 +132,6 @@ type PluginConfigInput<T> = {
   variables: InferSchemaInput<PluginVariables<T>>;
   secrets: InferSchemaInput<PluginSecrets<T>>;
 };
-/**
- * Extract deps context type from plugin instance (used for initialization)
- */
-type ContextOf<T extends AnyPlugin> = T extends Plugin<AnyContractRouter, AnySchema, AnySchema, AnySchema | undefined, infer TDeps> ? TDeps : never;
 /**
  * Plugin metadata for remote loading
  */
@@ -142,10 +144,6 @@ type PluginMetadata = {
  * Runtime registry configuration supporting both module and remote entries
  */
 type PluginRegistry = Record<string, PluginRegistryEntry>;
-/**
- * Legacy metadata-only registry (for backwards compatibility)
- */
-type PluginMetadataRegistry = Record<string, PluginMetadata>;
 /**
  * Configuration for secrets injection.
  * Secrets are hydrated into plugin configs using template replacement.
@@ -177,8 +175,15 @@ interface InitializedPlugin<T extends AnyPlugin = AnyPlugin> {
     variables: InferSchemaOutput<T["configSchema"]["variables"]>;
     secrets: InferSchemaOutput<T["configSchema"]["secrets"]>;
   };
-  readonly context: ContextOf<T>;
-  readonly scope: Scope.CloseableScope;
+  /**
+   * Built Effect context from the plugin's initialize Layer. Provided to
+   * handlers as `effect/context` — `.effect()` handlers `yield* Tag`,
+   * plain handlers use `Context.get(context["effect/context"], Tag)`.
+   */
+  readonly effectContext: Context.Context<any>;
+  readonly scope: Scope.Closeable;
+  /** Non-fatal config warnings collected during initialization (empty when none). */
+  readonly warnings: PluginWarningInfo[];
 }
 /**
  * Helper type to detect type errors when looking up RegisteredPlugins
@@ -202,17 +207,6 @@ type UsePluginResult<K extends keyof R, R = RegisteredPlugins> = VerifyPluginBin
   readonly metadata: PluginMetadata;
   readonly initialized: InitializedPlugin<RegisteredPlugin<K, R>>;
 } : VerifyPluginBinding<K, R>;
-/**
- * Runtime options
- */
-interface RuntimeOptions {
-  isolation?: "strict" | "shared" | "none";
-  memoryLimit?: string;
-  concurrency?: number;
-  resourceTimeout?: string;
-  debug?: boolean;
-  metrics?: boolean;
-}
 /**
  * Extract registry type from runtime instance or use type directly
  * This allows EveryPlugin.Infer to work with both:
@@ -251,17 +245,7 @@ declare namespace EveryPlugin {
 interface PluginRuntimeConfig<R extends Record<string, PluginRegistryEntry> = Record<string, PluginRegistryEntry>> {
   registry: R;
   secrets?: SecretsConfig;
-  options?: RuntimeOptions;
-}
-/**
- * Legacy plugin runtime configuration (metadata-only registry)
- * @deprecated Use PluginRuntimeConfig with module/remote entries instead
- */
-interface LegacyPluginRuntimeConfig {
-  registry: PluginMetadataRegistry;
-  secrets?: SecretsConfig;
-  options?: RuntimeOptions;
 }
 //#endregion
-export { AnyPlugin, AnyPluginConstructor, ContextOf, EveryPlugin, ExtractPluginType, InferRegistryFromEntries, InitializedPlugin, LegacyPluginRuntimeConfig, LoadedPlugin, PluginClientType, PluginConfigInput, PluginConstructor, PluginContext, PluginContextInput, PluginContract, PluginInstance, PluginMetadata, PluginMetadataRegistry, PluginRegistry, PluginRegistryEntry, PluginRouterType, PluginRuntimeConfig, PluginSecrets, PluginVariables, RegisteredPlugin, RegisteredPlugins, RuntimeOptions, SecretsConfig, UsePluginResult };
+export { AnyPlugin, AnyPluginConstructor, EveryPlugin, ExtractPluginType, InferRegistryFromEntries, InitializedPlugin, LoadedPlugin, PluginClientType, PluginConfigInput, PluginContext, PluginContextInput, PluginContract, PluginInstance, PluginMetadata, PluginRegistry, PluginRegistryEntry, PluginRouterType, PluginRuntimeConfig, PluginSecrets, PluginServicesEntry, PluginVariables, RegisteredPlugin, RegisteredPlugins, SecretsConfig, UsePluginResult };
 //# sourceMappingURL=types.d.cts.map

package/dist/types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;;;;;;;;;;;;;UAuBiB;;;;KAKL,YAAY,OAAO,mBAAmB,WAAW,WAAW;;;;KAK5D;UACF;EACR;IACE,UAAU;IACV,WAAW;IACX,SAAS;IACT,SAAS;;;;;;KAOD;EACN,QAAQ;EAAsB;EAAiB;EAAkB;;EACjE;EAAgB;EAAkB;;;;;KAK5B,kBAAkB,KAAK;EAAY,cAAc;IAAM;;;;KAKvD,yBAAyB,UAAU,eAAe,2BAC3D,WAAW,IAAI,EAAE;EAAa,cAAc;IACzC,IACA,gBAAgB,oBACd,kBAAkB;;;;KAOd,eAAe,KAAK;EAC9B;IAAW,gBAAgB,UAAU;;IAEnC;;;;KAMQ,gBAAgB,KAAK;EAAY;IAAW,iBAAiB,UAAU;;IAC/E;;;;KAMQ,cAAc,KAAK;EAAY;IAAW,eAAe,UAAU;;IAC3E;;;;KAMQ,cAAc,KAAK;EAC7B;IAAW,eAAe,UAAU;;IAElC;;;;;KAOQ,iBAAiB,KAAK,OAAO,eAAe;;;;KAK5C,iBAAiB,KAAK,aAAa,iBAAiB;;;;;;KAOpD,iBAAiB,gBAAgB,GAAG,IAAI,qBAAqB,EAAE;EACzE,eAAe;IAEb;EACE,gBAAgB,UAAU;EAC1B,iBAAiB,UAAU;EAC3B,eAAe,UAAU;EACzB,eAAe,wBAAwB;IAEvC,OAAO,GAAG,GAAG,GAAG;;;;KAOV,kBAAkB,gBAAgB,GAAG,IAAI,qBAAqB,iBAAiB,GAAG;;;;KAKlF,mBAAmB,KAC7B,cAAc,WAAW,YAAY,iBAAiB,cAAc;;;;KAK1D,kBAAkB;EAC5B,WAAW,iBAAiB,gBAAgB;EAC5C,SAAS,iBAAiB,cAAc;;;;;KAM9B,UAAU,UAAU,aAC9B,UAAU,OAAO,mBAAmB,WAAW,WAAW,6BAA6B,SACnF;;;;KAMM;WACD;WACA;WACA;;;;;KAMC,iBAAiB,eAAe;;;;KAKhC,yBAAyB,eAAe;;;;;UAMnC;GACd;;;;;UAMc,aAAa,UAAU,YAAY;WACzC,gBAAgB;WAChB,UAAU;;;;;UAMJ,eAAe,UAAU,YAAY;WAC3C,QAAQ;WACR,UAAU;;;;;UAMJ,kBAAkB,UAAU,YAAY;WAC9C,QAAQ;WACR,UAAU;WACV;IACP,WAAW,kBAAkB;IAC7B,SAAS,kBAAkB;;WAEpB,SAAS,UAAU;WACnB,OAAO,MAAM;;;;;KAMnB,oBAAoB,gBAAgB,GAAG,IAAI,qBAAqB,EAAE;EACrE,eAAe;IAEb;EACE,UAAU;EACV,WAAW;EACX,SAAS;EACT,SAAS;wBAGI,4IACF;;;;;;KAOL,gBAAgB,gBAAgB,GAAG,IAAI,qBACjD,oBAAoB,GAAG;WAER,eAAe,UAAU,mBAAmB,EAAE,QAAQ,iBAAiB,EAAE;WACzE,QAAQ,iBAAiB,EAAE;WAC3B,UAAU;WACV,aAAa,kBAAkB,iBAAiB,GAAG;IAE9D,oBAAoB,GAAG;;;;UAKZ;EACf;EACA;EACA;EACA;EACA;EACA;;;;;;;;KASG,WAAW,KAAK;EAAY,uBAAuB;IAAM,IAAI;;;;kBAKjD;;;;;;;;;;;;;;;;;;OAkBH,MACV,kBACA,SAAS,qBACP,gBAAgB,WAAW,UAAU,gBAAgB,GAAG,WAAW;;;;;UAMxD,oBACf,UAAU,eAAe,uBAAuB,eAAe;EAE/D,UAAU;EACV,UAAU;EACV,UAAU;;;;;;UAOK;EACf,UAAU;EACV,UAAU;EACV,UAAU"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;;;;;;;;;;;;;;UAwBiB;;;;KAKL,YAAY,OAAO,mBAAmB,WAAW,WAAW;;;;KAK5D;UACF;EACR;IACE,UAAU;IACV,WAAW;IACX,SAAS;IACT,SAAS;;;;;;KAOD;EACN,QAAQ;EAAsB;EAAiB;EAAkB;;EACjE;EAAgB;EAAkB;;;;;KAK5B,kBAAkB,KAAK;EAAY,cAAc;IAAM;;;;KAKvD,yBAAyB,UAAU,eAAe,2BAC3D,WAAW,IAAI,EAAE;EAAa,cAAc;IACzC,IACA,gBAAgB,oBACd,kBAAkB;;;;KAOd,eAAe,KAAK;EAC9B;IAAW,gBAAgB,UAAU;;IAEnC;;;;KAMQ,gBAAgB,KAAK;EAAY;IAAW,iBAAiB,UAAU;;IAC/E;;;;KAMQ,cAAc,KAAK;EAAY;IAAW,eAAe,UAAU;;IAC3E;;;;KAMQ,cAAc,KAAK;EAC7B;IAAW,eAAe,UAAU;;IAElC;;;;;KAOQ,iBAAiB,KAAK,iBAAiB,eAAe;;;;KAKtD,iBAAiB,KAAK,aAAa,iBAAiB;;;;;;KAOpD,oBAAoB;EAC9B,SAAS,UAAU,mBAAmB,OAAO,iBAAiB;EAC9D,QAAQ,iBAAiB;;;;;;;KAQf,iBAAiB,gBAAgB,GAAG,IAAI,qBAAqB,EAAE;EACzE,eAAe;IAEb;EACE,gBAAgB,UAAU;EAC1B,iBAAiB,UAAU;EAC3B,eAAe,UAAU;EACzB,eAAe,wBAAwB;IAEvC,OAAO,GAAG,GAAG,GAAG;;;;KAOV,mBAAmB,KAC7B,cAAc,WAAW,YAAY,iBAAiB,cAAc;;;;KAK1D,kBAAkB;EAC5B,WAAW,iBAAiB,gBAAgB;EAC5C,SAAS,iBAAiB,cAAc;;;;;KAM9B;WACD;WACA;WACA;;;;;KAMC,iBAAiB,eAAe;;;;;UAM3B;GACd;;;;;UAMc,aAAa,UAAU,YAAY;WACzC,gBAAgB;WAChB,UAAU;;;;;UAMJ,eAAe,UAAU,YAAY;WAC3C,QAAQ;WACR,UAAU;;;;;UAMJ,kBAAkB,UAAU,YAAY;WAC9C,QAAQ;WACR,UAAU;WACV;IACP,WAAW,kBAAkB;IAC7B,SAAS,kBAAkB;;;;;;;WAOpB,eAAe,QAAQ;WACvB,OAAO,MAAM;;WAEb,UAAU;;;;;KAMhB,oBAAoB,gBAAgB,GAAG,IAAI,qBAAqB,EAAE;EACrE,eAAe;IAEb;EACE,UAAU;EACV,WAAW;EACX,SAAS;EACT,SAAS;wBAGI,4IACF;;;;;;KAOL,gBAAgB,gBAAgB,GAAG,IAAI,qBACjD,oBAAoB,GAAG;WAER,eAAe,UAAU,mBAAmB,EAAE,QAAQ,iBAAiB,EAAE;WACzE,QAAQ,iBAAiB,EAAE;WAC3B,UAAU;WACV,aAAa,kBAAkB,iBAAiB,GAAG;IAE9D,oBAAoB,GAAG;;;;;;;KAQxB,WAAW,KAAK;EAAY,uBAAuB;IAAM,IAAI;;;;kBAKjD;;;;;;;;;;;;;;;;;;OAkBH,MACV,kBACA,SAAS,qBACP,gBAAgB,WAAW,UAAU,gBAAgB,GAAG,WAAW;;;;;UAMxD,oBACf,UAAU,eAAe,uBAAuB,eAAe;EAE/D,UAAU;EACV,UAAU"}