@omerdlw/base-framework 1.0.5 → 2.0.0

package/dist/provider.js

@@ -1,1971 +1,9 @@
 "use client";
-import React, { createContext, useContext, useMemo, useState, createElement, Fragment as Fragment$1, useRef, useCallback, useEffect, isValidElement } from 'react';
-import * as TooltipPrimitive from '@radix-ui/react-tooltip';
-import { usePathname } from 'next/navigation';
-import { Icon as Icon$1 } from '@iconify-icon/react';
-import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
-
-// src/error/constants.ts
-var ERROR_MESSAGES = Object.freeze({
-  GLOBAL_TITLE: "Something went wrong",
-  GLOBAL_MSG: "We ran into an unexpected problem. Please try again",
-  MODULE_TITLE: "Something went wrong",
-  MODULE_MSG: "This part of the app isn't working right now. Please try again",
-  COMPONENT_MSG: "This section couldn't be loaded. Please try again",
-  FALLBACK_TITLE: "Something went wrong",
-  FALLBACK_MSG: "This section couldn't be loaded. Please try again"
-});
-var MAX_CONTEXT = 10;
-var MAX_FINGERPRINTS = 100;
-var DEFAULT_DEDUPE_WINDOW = 6e4;
-var ERROR_LISTENER_CONFIG = Object.freeze({
-  maxErrors: 10,
-  throttle: 2e3,
-  ignored: Object.freeze([
-    /ResizeObserver loop/i,
-    /Network request failed/i,
-    /Loading chunk/i,
-    /Unexpected end of input/i,
-    /Failed to fetch/i,
-    /Script error/i,
-    /HTTP\s*404/i
-  ])
-});
-
-// src/error/utils.ts
-var IS_BROWSER = typeof window !== "undefined";
-var HAS_NAVIGATOR = typeof navigator !== "undefined";
-var getRuntimePath = () => typeof window !== "undefined" ? window.location.pathname : null;
-var getUserAgent = () => typeof navigator !== "undefined" ? navigator.userAgent : null;
-function createErrorContext({
-  errorInfo,
-  name,
-  title,
-  variant
-}) {
-  return {
-    componentStack: errorInfo?.componentStack || null,
-    route: getRuntimePath(),
-    userAgent: getUserAgent(),
-    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-    name: name || title || "ErrorBoundary",
-    variant: variant || "default",
-    source: "ErrorBoundary"
-  };
-}
-function normalizeSampleRate(value) {
-  const sampleRate = Number(value);
-  return Number.isFinite(sampleRate) ? Math.min(1, Math.max(0, sampleRate)) : 1;
-}
-function normalizeDedupeWindow(value) {
-  const dedupeWindow = Number(value);
-  return Number.isFinite(dedupeWindow) ? Math.max(0, dedupeWindow) : DEFAULT_DEDUPE_WINDOW;
-}
-function getBrowserEnvironment(route) {
-  return {
-    route: route || (IS_BROWSER ? window.location.pathname : null),
-    userAgent: HAS_NAVIGATOR ? navigator.userAgent : null,
-    platform: HAS_NAVIGATOR ? navigator.platform : null,
-    language: HAS_NAVIGATOR ? navigator.language : null,
-    online: HAS_NAVIGATOR ? navigator.onLine : true,
-    url: IS_BROWSER ? window.location.href : null
-  };
-}
-function fingerprint(error, context = {}) {
-  const stackTop = typeof context.componentStack === "string" ? context.componentStack.split("\n").find(Boolean) || "" : "";
-  const errObj = error;
-  const errorMessage = (errObj?.message || String(error || "")).slice(0, 100);
-  const errorName = errObj?.name || "UnknownError";
-  const route = context.route || "";
-  return [stackTop, errorMessage, errorName, route].filter(Boolean).join("::");
-}
-function createReport(error, {
-  context = {},
-  tags = {}
-} = {}) {
-  const errObj = error;
-  return {
-    error: {
-      message: errObj?.message || String(error),
-      stack: errObj?.stack || null,
-      name: errObj?.name || "UnknownError"
-    },
-    fingerprint: fingerprint(error, context),
-    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-    environment: getBrowserEnvironment(context.route),
-    componentStack: context.componentStack || null,
-    context,
-    tags
-  };
-}
-function getErrorMessage(error) {
-  if (!error) return "";
-  if (typeof error === "string") return error.trim();
-  if (error instanceof Error) return error.message.trim();
-  const errObj = error;
-  return String(errObj?.message || errObj?.toString?.() || error).trim();
-}
-function shouldIgnoreError(error) {
-  if (!error) return true;
-  const errWithNotFound = error;
-  if (typeof errWithNotFound?.isNotFound === "function" && errWithNotFound.isNotFound()) {
-    return true;
-  }
-  const message = getErrorMessage(error);
-  return ERROR_LISTENER_CONFIG.ignored.some((pattern) => pattern.test(message));
-}
-
-// src/error/reporter.ts
-var IS_PRODUCTION = process.env.NODE_ENV === "production";
-var IS_BROWSER2 = typeof window !== "undefined";
-var ErrorReporter = class {
-  handlers = [];
-  context = {};
-  tags = {};
-  seen = /* @__PURE__ */ new Set();
-  enabled;
-  sampleRate;
-  beforeSend;
-  dedupeWindow;
-  constructor(options = {}) {
-    this.enabled = options.enabled ?? true;
-    this.sampleRate = normalizeSampleRate(options.sampleRate ?? 1);
-    this.beforeSend = options.beforeSend || null;
-    this.dedupeWindow = normalizeDedupeWindow(
-      options.deduplicateWindow ?? DEFAULT_DEDUPE_WINDOW
-    );
-  }
-  addHandler(handler) {
-    if (typeof handler?.handle === "function") {
-      this.handlers.push(handler);
-    }
-    return this;
-  }
-  removeHandler(name) {
-    this.handlers = this.handlers.filter((handler) => handler.name !== name);
-    return this;
-  }
-  setContext(key, value) {
-    if (Object.hasOwn(this.context, key) || Object.keys(this.context).length < MAX_CONTEXT) {
-      this.context[key] = value;
-    }
-    return this;
-  }
-  setTag(key, value) {
-    this.tags[key] = String(value);
-    return this;
-  }
-  captureError(error, extraContext = {}) {
-    if (!this.enabled || Math.random() > this.sampleRate) return;
-    this.ensureDefaultHandlers();
-    const context = { ...this.context, ...extraContext };
-    let report2 = createReport(error, { context, tags: { ...this.tags } });
-    const dedupeKey = report2.fingerprint;
-    if (this.seen.has(dedupeKey)) return;
-    if (this.seen.size >= MAX_FINGERPRINTS) {
-      const first = this.seen.keys().next().value;
-      if (first) this.seen.delete(first);
-    }
-    this.seen.add(dedupeKey);
-    setTimeout(() => this.seen.delete(dedupeKey), this.dedupeWindow);
-    if (typeof this.beforeSend === "function") {
-      try {
-        const transformed = this.beforeSend(report2);
-        if (!transformed) return;
-        report2 = transformed;
-      } catch {
-      }
-    }
-    this.handlers.forEach((handler) => {
-      try {
-        handler.handle(report2);
-      } catch {
-      }
-    });
-    return report2;
-  }
-  captureMessage(message, level = "info", context = {}) {
-    const error = new Error(message);
-    error.name = "Message";
-    return this.captureError(error, { ...context, level });
-  }
-  ensureDefaultHandlers() {
-    if (this.handlers.length || !IS_BROWSER2) return;
-    this.handlers.push(createConsoleHandler());
-    if (window.Sentry) {
-      const sentryHandler = createSentryHandler(window.Sentry);
-      if (sentryHandler.name === "sentry") {
-        this.handlers.push(sentryHandler);
-      }
-    }
-  }
-};
-var instance = null;
-function getErrorReporter(options = {}) {
-  if (!instance) {
-    instance = new ErrorReporter(options);
-  }
-  return instance;
-}
-function createConsoleHandler() {
-  return {
-    name: "console",
-    handle(report2) {
-      if (IS_PRODUCTION) return;
-      console.error("[ErrorReporter]", {
-        error: report2.error.message,
-        fingerprint: report2.fingerprint,
-        route: report2.environment.route
-      });
-    }
-  };
-}
-function createSentryHandler(Sentry) {
-  const sentryObj = Sentry;
-  if (!sentryObj || typeof sentryObj.captureException !== "function" || typeof sentryObj.withScope !== "function") {
-    return createConsoleHandler();
-  }
-  return {
-    name: "sentry",
-    handle(report2) {
-      sentryObj.withScope((scope) => {
-        if (report2.fingerprint) scope.setFingerprint([report2.fingerprint]);
-        if (report2.user) scope.setUser(report2.user);
-        if (report2.tags && typeof report2.tags === "object") {
-          Object.entries(report2.tags).forEach(
-            ([key, value]) => scope.setTag(key, String(value))
-          );
-        }
-        if (report2.environment)
-          scope.setContext("environment", report2.environment);
-        if (report2.context) scope.setContext("custom", report2.context);
-        if (report2.componentStack)
-          scope.setExtra("componentStack", report2.componentStack);
-        const error = new Error(report2.error.message);
-        error.name = report2.error.name || "Error";
-        error.stack = report2.error.stack || void 0;
-        sentryObj.captureException(error);
-      });
-    }
-  };
-}
-
-// src/utils/report.ts
-var sink = null;
-function report(scope, error, level = "error") {
-  if (sink) {
-    try {
-      sink(scope, error, level);
-      return;
-    } catch {
-    }
-  }
-  if (process.env.NODE_ENV === "production" && typeof window !== "undefined") {
-    return;
-  }
-  console[level](`[${scope}]`, error);
-}
-function setReportSink(next) {
-  sink = next;
-  return () => {
-    if (sink === next) sink = null;
-  };
-}
-
-// src/events.ts
-var EVENT_TYPES = Object.freeze({
-  API_UNAUTHORIZED: "API_UNAUTHORIZED",
-  STATE_CHANGE: "STATE_CHANGE",
-  API_ERROR: "API_ERROR",
-  APP_ERROR: "APP_ERROR"
-});
-var EventEmitter = class {
-  events = /* @__PURE__ */ new Map();
-  debounceTimers = /* @__PURE__ */ new Map();
-  subscribe(event, callback) {
-    if (typeof event !== "string" || !event || typeof callback !== "function") {
-      return () => {
-      };
-    }
-    const listeners = this.events.get(event) || /* @__PURE__ */ new Set();
-    listeners.add(callback);
-    this.events.set(event, listeners);
-    return () => {
-      listeners.delete(callback);
-      if (listeners.size === 0) this.events.delete(event);
-    };
-  }
-  emit(event, payload) {
-    const listeners = this.events.get(event);
-    if (!listeners || listeners.size === 0) return;
-    const snapshot = Array.from(listeners);
-    for (const callback of snapshot) {
-      try {
-        callback(payload);
-      } catch (error) {
-        report(`Event listener (${String(event)})`, error);
-      }
-    }
-  }
-  emitDebounced(event, payload, waitMs = 100) {
-    const existing = this.debounceTimers.get(event);
-    if (existing) clearTimeout(existing);
-    const timer = setTimeout(() => {
-      this.debounceTimers.delete(event);
-      this.emit(event, payload);
-    }, waitMs);
-    this.debounceTimers.set(event, timer);
-  }
-  cancelDebounced(event) {
-    if (event) {
-      const timer = this.debounceTimers.get(event);
-      if (timer) {
-        clearTimeout(timer);
-        this.debounceTimers.delete(event);
-      }
-    } else {
-      for (const timer of this.debounceTimers.values()) {
-        clearTimeout(timer);
-      }
-      this.debounceTimers.clear();
-    }
-  }
-  unsubscribeAll(event) {
-    this.cancelDebounced(event);
-    if (event) this.events.delete(event);
-    else this.events.clear();
-  }
-  hasListeners(event) {
-    return Boolean(this.events.get(event)?.size);
-  }
-  getListenerCount(event) {
-    return this.events.get(event)?.size || 0;
-  }
-  getAllEvents() {
-    return [...this.events.keys()];
-  }
-};
-var GLOBAL_EVENTS_KEY = /* @__PURE__ */ Symbol.for("__base_framework_global_events__");
-var _global = globalThis;
-var globalEvents = _global[GLOBAL_EVENTS_KEY] ?? (_global[GLOBAL_EVENTS_KEY] = new EventEmitter());
-function Icon({
-  className = "center",
-  color,
-  icon,
-  onClick,
-  size = 20,
-  style,
-  ...props
-}) {
-  return /* @__PURE__ */ jsx(
-    Icon$1,
-    {
-      className,
-      height: size,
-      icon,
-      onClick,
-      style: { color, ...style },
-      width: size,
-      ...props
-    }
-  );
-}
-Icon.displayName = "Icon";
-function Button({
-  ref,
-  children,
-  className,
-  disabled = false,
-  loading = false,
-  type = "button",
-  ...props
-}) {
-  return /* @__PURE__ */ jsx(
-    "button",
-    {
-      ref,
-      type,
-      disabled: disabled || loading,
-      "aria-busy": loading ? true : void 0,
-      className,
-      ...props,
-      children
-    }
-  );
-}
-Button.displayName = "Button";
-
-// src/kernel/constants.ts
-var DEFAULT_SOURCE = "dynamic";
-var REGISTRY_SOURCES = Object.freeze({
-  STATIC: "static",
-  DYNAMIC: "dynamic",
-  USER: "user"
-});
-var REGISTRY_LIFECYCLES = Object.freeze({
-  IMMEDIATE: "immediate",
-  GRACEFUL: "graceful",
-  PERSISTENT: "persistent",
-  ROUTE: "route"
-});
-var REGISTRY_VALIDATION_MODES = Object.freeze({
-  WARN: "warn",
-  STRICT: "strict"
-});
-var REGISTRY_METADATA_KEYS = Object.freeze([
-  "cleanup",
-  "cleanupDelayMs",
-  "instanceId",
-  "lifecycle",
-  "priority",
-  "source",
-  "scope",
-  "validation"
-]);
-var REGISTRY_SOURCE_PRIORITY = Object.freeze({
-  [REGISTRY_SOURCES.STATIC]: 100,
-  [REGISTRY_SOURCES.DYNAMIC]: 200,
-  [REGISTRY_SOURCES.USER]: 300
-});
-var REGISTRY_SOURCE_RANK = Object.freeze({
-  [REGISTRY_SOURCES.STATIC]: 10,
-  [REGISTRY_SOURCES.DYNAMIC]: 20,
-  [REGISTRY_SOURCES.USER]: 30
-});
-var REGISTRY_LIFECYCLE_VALUES = new Set(
-  Object.values(REGISTRY_LIFECYCLES)
-);
-var REGISTRY_METADATA_KEY_SET = new Set(
-  REGISTRY_METADATA_KEYS
-);
-var REGISTRY_SCOPE_KINDS = Object.freeze({
-  APP: "app",
-  SESSION: "session",
-  ROUTE: "route",
-  INSTANCE: "instance",
-  WORKSPACE: "workspace"
-});
-var DEFAULT_REGISTRY_SCOPE = REGISTRY_SCOPE_KINDS.APP;
-function getOrCreateGlobalContext(name, defaultValue) {
-  const sym = /* @__PURE__ */ Symbol.for(`@omerdlw/base-framework/context/${name}`);
-  const store = globalThis;
-  if (!store[sym]) {
-    store[sym] = createContext(defaultValue);
-  }
-  return store[sym];
-}
-
-// src/utils/string.ts
-function trimToNull(value) {
-  if (value === null || value === void 0) return null;
-  const trimmed = String(value).trim();
-  return trimmed.length > 0 ? trimmed : null;
-}
-
-// src/utils/object.ts
-function isObject(value) {
-  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-function isPlainObject(value) {
-  if (!isObject(value)) return false;
-  const proto = Object.getPrototypeOf(value);
-  return proto === Object.prototype || proto === null;
-}
-function shallowEqual(a, b) {
-  if (Object.is(a, b)) return true;
-  if (typeof a !== "object" || a === null || typeof b !== "object" || b === null) {
-    return false;
-  }
-  const keysA = Object.keys(a);
-  const keysB = Object.keys(b);
-  if (keysA.length !== keysB.length) return false;
-  for (const key of keysA) {
-    if (!Object.prototype.hasOwnProperty.call(b, key) || !Object.is(
-      a[key],
-      b[key]
-    )) {
-      return false;
-    }
-  }
-  return true;
-}
-
-// src/utils/user-message.ts
-var USER_MESSAGES = Object.freeze({
-  generic: "Something went wrong. Please try again",
-  network: "You appear to be offline. Check your connection and try again",
-  timeout: "That took too long. Please try again",
-  unauthorized: "Your session has expired. Please sign in again",
-  forbidden: "You don't have permission to do that",
-  notFound: "We couldn't find what you were looking for",
-  rateLimited: "Too many attempts. Please wait a moment and try again",
-  server: "We're having trouble on our end. Please try again in a moment"
-});
-var UserError = class extends Error {
-  status;
-  constructor(message, status) {
-    super(message);
-    this.name = "UserError";
-    this.status = status;
-  }
-};
-var NETWORK_FAILURE = /failed to fetch|network|load failed|fetch failed/i;
-function readField(source, field, type) {
-  const value = source?.[field];
-  return typeof value === type ? value : void 0;
-}
-function readPayloadMessage(error) {
-  const payload = error?.payload;
-  const message = readField(payload, "error", "string")?.trim();
-  return message || void 0;
-}
-function toUserMessage(error, { codes, fallback = USER_MESSAGES.generic } = {}) {
-  if (typeof error === "string") return error.trim() || fallback;
-  if (!error || typeof error !== "object") return fallback;
-  if (error instanceof UserError) {
-    if (error.status === 401) return USER_MESSAGES.unauthorized;
-    return error.message || fallback;
-  }
-  if (error.name === "AbortError") return fallback;
-  const code = readField(error, "code", "string");
-  if (code && codes?.[code]) return codes[code];
-  const status = readField(error, "status", "number");
-  if (status === 401) return USER_MESSAGES.unauthorized;
-  if (status === 429) return USER_MESSAGES.rateLimited;
-  if (status === 408 || status === 504) return USER_MESSAGES.timeout;
-  if (status !== void 0 && status >= 500) return USER_MESSAGES.server;
-  if (status !== void 0 && status >= 400) {
-    const authored = readPayloadMessage(error);
-    if (authored) return authored;
-    if (status === 403) return USER_MESSAGES.forbidden;
-    if (status === 404) return USER_MESSAGES.notFound;
-    return fallback;
-  }
-  const isOffline = typeof navigator !== "undefined" && navigator.onLine === false;
-  if (isOffline || NETWORK_FAILURE.test(error.message ?? "") && (error instanceof TypeError || /fetch/i.test(error.name))) {
-    return USER_MESSAGES.network;
-  }
-  return fallback;
-}
-
-// src/utils/store.ts
-function freezeStoreSnapshot(state) {
-  if (process.env.NODE_ENV === "production" || !state || typeof state !== "object") {
-    return state;
-  }
-  const seen = /* @__PURE__ */ new WeakSet();
-  const freeze = (value) => {
-    if (seen.has(value) || Object.isFrozen(value)) return;
-    seen.add(value);
-    const prototype = Object.getPrototypeOf(value);
-    if (Array.isArray(value) || prototype === Object.prototype || prototype === null) {
-      for (const key of Reflect.ownKeys(value)) {
-        const descriptor = Object.getOwnPropertyDescriptor(value, key);
-        if (descriptor && "value" in descriptor && descriptor.value !== null) {
-          if (typeof descriptor.value === "object") freeze(descriptor.value);
-        }
-      }
-    }
-    Object.freeze(value);
-  };
-  freeze(state);
-  return state;
-}
-function createStore(initialState, { freezeSnapshots = true } = {}) {
-  const listeners = /* @__PURE__ */ new Set();
-  const prepare = freezeSnapshots ? freezeStoreSnapshot : (state) => state;
-  let snapshot = prepare(initialState);
-  const publish = (nextStateOrUpdater) => {
-    const nextState = typeof nextStateOrUpdater === "function" ? nextStateOrUpdater(snapshot) : nextStateOrUpdater;
-    if (Object.is(snapshot, nextState)) return false;
-    snapshot = prepare(nextState);
-    for (const listener of listeners) {
-      try {
-        listener();
-      } catch (error) {
-        report("CoreStore subscriber", error, "warn");
-      }
-    }
-    return true;
-  };
-  const setState = (updater) => {
-    if (typeof updater === "function") {
-      return publish(updater);
-    }
-    if (snapshot && typeof snapshot === "object" && updater && typeof updater === "object") {
-      return publish({ ...snapshot, ...updater });
-    }
-    return publish(updater);
-  };
-  return Object.freeze({
-    getSnapshot() {
-      return snapshot;
-    },
-    publish,
-    setState,
-    subscribe(listener) {
-      if (typeof listener !== "function") return () => {
-      };
-      listeners.add(listener);
-      return () => listeners.delete(listener);
-    }
-  });
-}
-
-// src/kernel/utils.ts
-function hasOwnProperty(target, key) {
-  return Object.prototype.hasOwnProperty.call(target, key);
-}
-function parseFiniteNumber(value) {
-  const parsed = Number(value);
-  return Number.isFinite(parsed) ? parsed : null;
-}
-function getValidString(value, fallback = null) {
-  return trimToNull(value) ?? fallback;
-}
-function resolveInstanceId(value) {
-  return isObject(value) && typeof value.instanceId === "string" ? value.instanceId : null;
-}
-function getSourceRank(source) {
-  return REGISTRY_SOURCE_RANK[source] ?? 0;
-}
-function resolveRegisterInput(sourceOrOptions, optionsArg) {
-  if (typeof sourceOrOptions === "string") {
-    return {
-      source: sourceOrOptions,
-      options: isObject(optionsArg) ? optionsArg : {}
-    };
-  }
-  if (isObject(sourceOrOptions)) {
-    return {
-      source: typeof sourceOrOptions.source === "string" ? sourceOrOptions.source : DEFAULT_SOURCE,
-      options: sourceOrOptions
-    };
-  }
-  return {
-    source: DEFAULT_SOURCE,
-    options: isObject(optionsArg) ? optionsArg : {}
-  };
-}
-function resolveScope(options) {
-  return typeof options?.scope === "string" && options.scope.trim() ? options.scope.trim() : DEFAULT_REGISTRY_SCOPE;
-}
-function resolveUnregisterInput(sourceOrOptions) {
-  if (typeof sourceOrOptions === "string") {
-    return { instanceId: null, scope: null, source: sourceOrOptions };
-  }
-  if (isObject(sourceOrOptions)) {
-    return {
-      instanceId: resolveInstanceId(sourceOrOptions),
-      scope: typeof sourceOrOptions.scope === "string" && sourceOrOptions.scope.trim() ? sourceOrOptions.scope.trim() : null,
-      source: typeof sourceOrOptions.source === "string" ? sourceOrOptions.source : DEFAULT_SOURCE
-    };
-  }
-  return { instanceId: null, scope: null, source: DEFAULT_SOURCE };
-}
-
-// src/kernel/schema.ts
-function validateRegistryMetadata(metadata) {
-  if (metadata === void 0 || metadata === null)
-    return { issues: [], valid: true };
-  if (!isObject(metadata))
-    return { issues: ["registry metadata must be an object"], valid: false };
-  const issues = [];
-  Object.keys(metadata).forEach((key) => {
-    if (!REGISTRY_METADATA_KEY_SET.has(key))
-      issues.push(`unknown registry metadata field: ${key}`);
-  });
-  if (metadata.source !== void 0 && !getValidString(metadata.source))
-    issues.push("source must be a non-empty string");
-  if (metadata.instanceId !== void 0 && !getValidString(metadata.instanceId))
-    issues.push("instanceId must be a non-empty string");
-  if (metadata.scope !== void 0 && !getValidString(metadata.scope))
-    issues.push("scope must be a non-empty string");
-  if (metadata.priority !== void 0 && parseFiniteNumber(metadata.priority) === null)
-    issues.push("priority must be a finite number");
-  if (metadata.cleanupDelayMs !== void 0) {
-    const delay = parseFiniteNumber(metadata.cleanupDelayMs);
-    if (delay === null || delay < 0)
-      issues.push("cleanupDelayMs must be a non-negative finite number");
-  }
-  const lifecycle = metadata.lifecycle ?? metadata.cleanup;
-  if (lifecycle !== void 0 && !REGISTRY_LIFECYCLE_VALUES.has(String(lifecycle))) {
-    issues.push(
-      `lifecycle must be one of: ${[...REGISTRY_LIFECYCLE_VALUES].join(", ")}`
-    );
-  }
-  if (metadata.validation !== void 0 && !Object.values(REGISTRY_VALIDATION_MODES).includes(
-    metadata.validation
-  )) {
-    issues.push(
-      `validation must be one of: ${Object.values(REGISTRY_VALIDATION_MODES).join(", ")}`
-    );
-  }
-  return { issues, valid: issues.length === 0 };
-}
-function validateRegistryKey(type, key, definitions) {
-  const definition = definitions.get(type);
-  const issues = [];
-  if (!definition) issues.push(`unknown registry type: ${String(type)}`);
-  if (!getValidString(key))
-    return {
-      issues: [...issues, "key must be a non-empty string"],
-      valid: false
-    };
-  const normalizedKey = String(key).trim();
-  if (definition?.keyPolicy === "singleton") {
-    const expectedKey = definition.singletonKey;
-    if (expectedKey && normalizedKey !== expectedKey)
-      issues.push(`${type} key must be ${expectedKey}`);
-  } else if (definition?.keyPolicy === "path") {
-    if (!normalizedKey.startsWith("/"))
-      issues.push(`${type} key must be an absolute path`);
-  } else if (definition?.keyPolicy === "route") {
-    if (!normalizedKey.startsWith("/") && !definition.reservedKeys?.includes(normalizedKey)) {
-      issues.push(`${type} key must be a route path or a reserved route key`);
-    }
-  }
-  return { issues, valid: issues.length === 0 };
-}
-function validateRegistryValue(type, key, value, definitions) {
-  const definition = definitions.get(type);
-  const issues = [...validateRegistryKey(type, key, definitions).issues];
-  const valueKind = definition?.valueKind ?? "object";
-  if (definition && valueKind === "object" && !isPlainObject(value)) {
-    issues.push(`${type} values must be plain objects`);
-  }
-  if (definition && valueKind === "component" && typeof value !== "function" && !isPlainObject(value)) {
-    issues.push(
-      `${type} values must be component functions or component objects`
-    );
-  }
-  const validation = definition?.validate?.(value);
-  if (validation && !validation.valid && Array.isArray(validation.issues)) {
-    issues.push(...validation.issues);
-  }
-  return { issues, valid: issues.length === 0 };
-}
-
-// src/kernel/operations.ts
-function createInitialRegistriesFor(definitions) {
-  return Object.fromEntries(
-    Array.from(definitions.keys(), (type) => [type, {}])
-  );
-}
-function buildSourceRecord({
-  source,
-  value,
-  instanceId = null,
-  priority,
-  timestamp,
-  sequence,
-  scope = DEFAULT_REGISTRY_SCOPE
-}) {
-  return {
-    updatedAt: timestamp,
-    sequence: Number.isFinite(sequence) ? sequence : timestamp,
-    instanceId: typeof instanceId === "string" ? instanceId : null,
-    priority,
-    value,
-    source,
-    scope
-  };
-}
-function createRecordKey(source, instanceId = null, scope = DEFAULT_REGISTRY_SCOPE) {
-  if (scope === DEFAULT_REGISTRY_SCOPE) {
-    if (typeof instanceId === "string" && instanceId.length > 0) {
-      return `instance:${JSON.stringify([source, instanceId])}`;
-    }
-    return `source:${JSON.stringify(source)}`;
-  }
-  if (typeof instanceId === "string" && instanceId.length > 0) {
-    return `instance:${JSON.stringify([scope, source, instanceId])}`;
-  }
-  return `source:${JSON.stringify([scope, source])}`;
-}
-function getSourceRecords(entry, source, scope = null) {
-  if (!entry) return [];
-  return Object.entries(entry).map(([recordKey, rawRecord]) => ({
-    recordKey,
-    record: toSourceRecord(rawRecord, recordKey)
-  })).filter(
-    ({ record }) => record?.source === source && (scope === null || record.scope === scope)
-  );
-}
-function getSourceRecord(entry, source, instanceId = null, scope = DEFAULT_REGISTRY_SCOPE) {
-  const recordKey = createRecordKey(source, instanceId, scope);
-  return toSourceRecord(entry?.[recordKey], source);
-}
-function resolveRecordPriority(options, source) {
-  if (isObject(options) && hasOwnProperty(options, "priority")) {
-    const parsedPriority = Number(options.priority);
-    if (Number.isFinite(parsedPriority)) return parsedPriority;
-  }
-  return REGISTRY_SOURCE_PRIORITY[source] ?? 0;
-}
-function toSourceRecord(rawValue, source = DEFAULT_SOURCE) {
-  if (rawValue === void 0) return null;
-  const rawRecord = rawValue;
-  const isWrappedRecord = isObject(rawValue) && hasOwnProperty(rawRecord, "value") && hasOwnProperty(rawRecord, "updatedAt") && hasOwnProperty(rawRecord, "priority") && hasOwnProperty(rawRecord, "source");
-  if (isWrappedRecord) {
-    const parsedPriority = Number(rawRecord.priority);
-    return {
-      updatedAt: Number(rawRecord.updatedAt) || 0,
-      sequence: Number(rawRecord.sequence) || Number(rawRecord.updatedAt) || 0,
-      instanceId: typeof rawRecord.instanceId === "string" ? rawRecord.instanceId : null,
-      priority: Number.isFinite(parsedPriority) ? parsedPriority : REGISTRY_SOURCE_PRIORITY[source] ?? 0,
-      source: typeof rawRecord.source === "string" ? rawRecord.source : source,
-      scope: typeof rawRecord.scope === "string" ? rawRecord.scope : DEFAULT_REGISTRY_SCOPE,
-      value: rawRecord.value
-    };
-  }
-  return {
-    updatedAt: 0,
-    sequence: 0,
-    instanceId: null,
-    priority: REGISTRY_SOURCE_PRIORITY[source] ?? 0,
-    source,
-    scope: DEFAULT_REGISTRY_SCOPE,
-    value: rawValue
-  };
-}
-function compareRecords(a, b) {
-  if (a.priority !== b.priority) return a.priority - b.priority;
-  const rankDiff = getSourceRank(a.source) - getSourceRank(b.source);
-  if (rankDiff !== 0) return rankDiff;
-  return (a.sequence ?? a.updatedAt) - (b.sequence ?? b.updatedAt);
-}
-function recordsHaveSameValue(prevRecord, nextRecord) {
-  if (Object.is(prevRecord?.value, nextRecord?.value)) return true;
-  if (isObject(prevRecord?.value) && isObject(nextRecord?.value)) {
-    return shallowEqual(prevRecord.value, nextRecord.value);
-  }
-  return false;
-}
-function hasRecordChanged(prevRecord, nextRecord) {
-  if (!prevRecord) return true;
-  return prevRecord.priority !== nextRecord.priority || prevRecord.source !== nextRecord.source || prevRecord.instanceId !== nextRecord.instanceId || prevRecord.scope !== nextRecord.scope || !recordsHaveSameValue(prevRecord, nextRecord);
-}
-function hasAnySourceRecord(entry) {
-  return Object.values(entry || {}).some(
-    (rawRecord) => rawRecord !== void 0
-  );
-}
-function setSourceRecord(state, type, key, source, record) {
-  const typeRegistry = state[type] || {};
-  const currentEntry = typeRegistry[key] || {};
-  const recordKey = createRecordKey(source, record.instanceId, record.scope);
-  const prevRecord = toSourceRecord(currentEntry[recordKey], source);
-  if (!hasRecordChanged(prevRecord, record)) {
-    return state;
-  }
-  return {
-    ...state,
-    [type]: {
-      ...typeRegistry,
-      [key]: {
-        ...currentEntry,
-        [recordKey]: record
-      }
-    }
-  };
-}
-function removeSourceRecord(state, type, key, source, instanceId = null, scope = null) {
-  const typeRegistry = state[type];
-  const currentEntry = typeRegistry?.[key];
-  if (!typeRegistry || !currentEntry) return state;
-  let activeRecords = [];
-  if (typeof instanceId === "string" && instanceId.length > 0 && scope !== null) {
-    const safeScope = scope || DEFAULT_REGISTRY_SCOPE;
-    const recordKey = createRecordKey(source, instanceId, safeScope);
-    const record = getSourceRecord(currentEntry, source, instanceId, safeScope);
-    if (record) activeRecords.push({ recordKey, record });
-  } else {
-    activeRecords = getSourceRecords(currentEntry, source, scope).filter(({ record }) => !instanceId || record?.instanceId === instanceId).filter(
-      (entry) => Boolean(entry.record)
-    );
-  }
-  if (activeRecords.length === 0) return state;
-  const nextEntry = { ...currentEntry };
-  activeRecords.forEach(({ recordKey }) => {
-    delete nextEntry[recordKey];
-  });
-  if (!hasAnySourceRecord(nextEntry)) {
-    const nextTypeRegistry = { ...typeRegistry };
-    delete nextTypeRegistry[key];
-    return { ...state, [type]: nextTypeRegistry };
-  }
-  return {
-    ...state,
-    [type]: { ...typeRegistry, [key]: nextEntry }
-  };
-}
-function resolveEntryValueFor(definitions, type, entry, scope = null) {
-  if (!entry) return void 0;
-  const activeRecords = Object.entries(entry).map(([source, rawRecord]) => toSourceRecord(rawRecord, source)).filter(
-    (record) => record !== null && (scope === null || record.scope === scope)
-  );
-  if (activeRecords.length === 0) return void 0;
-  const merge = definitions.get(type)?.merge;
-  if (merge) {
-    const sortedRecords = [...activeRecords].sort(compareRecords);
-    const mergeCandidate = sortedRecords.every(
-      (record) => isObject(record.value)
-    );
-    if (mergeCandidate) {
-      const values = sortedRecords.map(
-        (record) => record.value
-      );
-      return merge(values);
-    }
-    return sortedRecords[sortedRecords.length - 1].value;
-  }
-  return activeRecords.reduce(
-    (winner, current) => compareRecords(current, winner) > 0 ? current : winner
-  ).value;
-}
-function createResolverCacheFor(definitions) {
-  const entryCache = /* @__PURE__ */ new WeakMap();
-  return (type, entry, scope = null) => {
-    if (!entry || typeof entry !== "object") {
-      return resolveEntryValueFor(definitions, type, entry, scope);
-    }
-    let typeCache = entryCache.get(entry);
-    if (!typeCache) {
-      typeCache = /* @__PURE__ */ new Map();
-      entryCache.set(entry, typeCache);
-    }
-    const cacheKey = scope || "default";
-    if (typeCache.has(cacheKey)) return typeCache.get(cacheKey);
-    const value = resolveEntryValueFor(definitions, type, entry, scope);
-    typeCache.set(cacheKey, value);
-    return value;
-  };
-}
-function createRegisterOperation(type, key, item, sourceOrOptions, optionsArg, timestamp, sequence = timestamp) {
-  const { source, options } = resolveRegisterInput(sourceOrOptions, optionsArg);
-  const instanceId = resolveInstanceId(options);
-  const scope = resolveScope(options);
-  return {
-    kind: "register",
-    validation: options.validation,
-    source,
-    scope,
-    record: buildSourceRecord({
-      source,
-      value: item,
-      instanceId,
-      priority: resolveRecordPriority(options, source),
-      scope,
-      timestamp,
-      sequence
-    }),
-    instanceId,
-    type,
-    key: typeof key === "string" ? key.trim() : key
-  };
-}
-function createUnregisterOperation(type, key, sourceOrOptions) {
-  const { scope, source, instanceId } = resolveUnregisterInput(sourceOrOptions);
-  return {
-    kind: "unregister",
-    instanceId,
-    scope,
-    source,
-    type,
-    key: typeof key === "string" ? key.trim() : key
-  };
-}
-function isValidRegistryTargetFor(definitions, type, key) {
-  return validateRegistryKey(type, key, definitions).valid;
-}
-function applyOperationFor(definitions, state, operation) {
-  if (!isValidRegistryTargetFor(definitions, operation?.type, operation?.key))
-    return state;
-  if (operation.kind === "register") {
-    return setSourceRecord(
-      state,
-      operation.type,
-      operation.key,
-      operation.source,
-      operation.record
-    );
-  }
-  if (operation.kind === "unregister") {
-    return removeSourceRecord(
-      state,
-      operation.type,
-      operation.key,
-      operation.source,
-      operation.instanceId,
-      operation.scope
-    );
-  }
-  return state;
-}
-function hasOperationEffectFor(definitions, state, operation) {
-  if (!isValidRegistryTargetFor(definitions, operation?.type, operation?.key))
-    return false;
-  if (operation.kind === "register") {
-    const currentRecord = getSourceRecord(
-      state[operation.type]?.[operation.key],
-      operation.source,
-      operation.instanceId,
-      operation.scope
-    );
-    return hasRecordChanged(currentRecord, operation.record);
-  }
-  if (operation.kind === "unregister") {
-    const entry = state[operation.type]?.[operation.key];
-    if (typeof operation.instanceId === "string" && operation.instanceId.length > 0) {
-      return operation.scope === null ? getSourceRecords(entry, operation.source).some(
-        ({ record }) => record?.instanceId === operation.instanceId
-      ) : Boolean(
-        getSourceRecord(
-          entry,
-          operation.source,
-          operation.instanceId,
-          operation.scope
-        )
-      );
-    }
-    return getSourceRecords(entry, operation.source, operation.scope).length > 0;
-  }
-  return false;
-}
-function resolveEffectiveOperationsFor(definitions, state, operations) {
-  const effectiveOperations = [];
-  let nextState = state;
-  operations.forEach((operation) => {
-    if (!hasOperationEffectFor(definitions, nextState, operation)) return;
-    effectiveOperations.push(operation);
-    nextState = applyOperationFor(definitions, nextState, operation);
-  });
-  return { effectiveOperations, nextState };
-}
-function createRegistryOperations(definitions) {
-  return Object.freeze({
-    applyOperation: (state, operation) => applyOperationFor(definitions, state, operation),
-    createInitialRegistries: () => createInitialRegistriesFor(definitions),
-    createResolverCache: () => createResolverCacheFor(definitions),
-    hasOperationEffect: (state, operation) => hasOperationEffectFor(definitions, state, operation),
-    isRegistryType: (type) => definitions.get(type) !== void 0,
-    isValidRegistryTarget: (type, key) => isValidRegistryTargetFor(definitions, type, key),
-    resolveEffectiveOperations: (state, operations) => resolveEffectiveOperationsFor(definitions, state, operations),
-    resolveEntryValue: (type, entry, scope = null) => resolveEntryValueFor(definitions, type, entry, scope)
-  });
-}
-
-// src/kernel/runtime.ts
-function createRegistryTransaction(store, metadata = {}) {
-  const operations = [];
-  let status = "open";
-  const traceId = metadata.traceId || `tx-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
-  const ensureOpen = () => status === "open";
-  const mergeOptions = (options) => {
-    const baseOpts = options && typeof options === "object" ? options : {};
-    const needsSource = metadata.source && !baseOpts.source;
-    const needsScope = metadata.scope && !baseOpts.scope;
-    if (!needsSource && !needsScope) return baseOpts;
-    return {
-      ...baseOpts,
-      ...needsSource ? { source: metadata.source } : {},
-      ...needsScope ? { scope: metadata.scope } : {}
-    };
-  };
-  const register = (type, key, value, sourceOrOptions, optionsArg) => {
-    if (!ensureOpen()) return { index: -1, status, traceId };
-    const options = typeof sourceOrOptions === "string" ? mergeOptions({ ...optionsArg || {}, source: sourceOrOptions }) : mergeOptions(sourceOrOptions);
-    operations.push({ key, item: value, options, type });
-    return { index: operations.length - 1, status: "queued", traceId };
-  };
-  const unregister = (type, key, sourceOrOptions) => {
-    if (!ensureOpen()) return { index: -1, status, traceId };
-    const options = mergeOptions(
-      typeof sourceOrOptions === "string" ? { source: sourceOrOptions } : sourceOrOptions
-    );
-    operations.push({ key, options, type, unregister: true });
-    return { index: operations.length - 1, status: "queued", traceId };
-  };
-  const rollback = (_reason = "manual") => {
-    if (!ensureOpen()) return { index: -1, status, traceId };
-    status = "rolled-back";
-    operations.length = 0;
-    return { index: -1, status, traceId };
-  };
-  const commit = () => {
-    if (!ensureOpen()) return { status, traceId };
-    status = "committed";
-    const result = store.batch((queue) => {
-      operations.forEach((op) => {
-        if (op.unregister) queue.unregister(op.type, op.key, op.options);
-        else queue.register(op.type, op.key, op.item, op.options);
-      });
-    });
-    const applied = typeof result === "number" && Number.isFinite(result) ? result : 0;
-    return { applied, queued: operations.length, status, traceId };
-  };
-  const run = (executor) => {
-    if (typeof executor !== "function") {
-      rollback("invalid-executor");
-      return { status, traceId };
-    }
-    try {
-      executor({ register, unregister });
-      return commit();
-    } catch (error) {
-      rollback(error instanceof Error ? error.message : String(error));
-      throw error;
-    }
-  };
-  return {
-    commit,
-    get operations() {
-      return operations.slice();
-    },
-    register,
-    rollback,
-    run,
-    get status() {
-      return status;
-    },
-    traceId,
-    unregister
-  };
-}
-
-// src/kernel/store.ts
-var NO_DEFINITIONS = /* @__PURE__ */ new Map();
-function createNoopHandle(status = "rejected", reason = "unknown") {
-  const handle = Object.assign(() => false, {
-    active: false,
-    dispose: () => false,
-    instanceId: null,
-    key: "",
-    priority: 0,
-    reason,
-    source: "",
-    status,
-    type: "",
-    update: () => handle,
-    updatedAt: 0,
-    validation: "warn"
-  });
-  return handle;
-}
-var NOOP_HANDLE = createNoopHandle();
-function isNoopHandle(handle) {
-  return handle === NOOP_HANDLE || handle?.status === "rejected" || handle?.status === "ignored";
-}
-function cloneRegistryValue(value, seen = /* @__PURE__ */ new WeakMap()) {
-  if (value === null || typeof value !== "object" || isValidElement(value)) {
-    return value;
-  }
-  const prototype = Object.getPrototypeOf(value);
-  const isPlainObject2 = !Array.isArray(value) && (prototype === Object.prototype || prototype === null);
-  if (!Array.isArray(value) && !isPlainObject2) return value;
-  if (seen.has(value)) return seen.get(value);
-  const source = value;
-  const clone = Array.isArray(value) ? [] : {};
-  seen.set(value, clone);
-  for (const key in source) {
-    if (Object.prototype.hasOwnProperty.call(source, key)) {
-      clone[key] = cloneRegistryValue(source[key], seen);
-    }
-  }
-  return clone;
-}
-function normalizeInitialEntries(entries) {
-  return (Array.isArray(entries) ? entries : []).filter(
-    (entry) => entry?.type && entry?.items && typeof entry.items === "object"
-  );
-}
-function createInitialState(ops, definitions, entries) {
-  const normalizedEntries = normalizeInitialEntries(entries);
-  if (normalizedEntries.length === 0) return ops.createInitialRegistries();
-  const timestamp = Date.now();
-  let sequence = 0;
-  let state = ops.createInitialRegistries();
-  normalizedEntries.forEach((entry) => {
-    const source = entry.source || REGISTRY_SOURCES.STATIC;
-    const options = {
-      ...entry.options || {},
-      instanceId: entry.instanceId || entry.options?.instanceId || "registry-initial"
-    };
-    Object.entries(entry.items).forEach(([key, value]) => {
-      const validation = validateRegistration(
-        definitions,
-        entry.type,
-        key,
-        value,
-        source,
-        options
-      );
-      if (!validation.valid) return;
-      const operation = createRegisterOperation(
-        entry.type,
-        key,
-        cloneRegistryValue(value),
-        source,
-        options,
-        timestamp,
-        ++sequence
-      );
-      if (ops.hasOperationEffect(state, operation)) {
-        state = ops.applyOperation(state, operation);
-      }
-    });
-  });
-  return state;
-}
-function notifyListeners(listeners) {
-  if (!listeners) return;
-  for (const listener of listeners) {
-    try {
-      listener();
-    } catch (error) {
-      report("Registry listener", error);
-    }
-  }
-}
-function getOrCreateKeyListeners(listenersByType, type, key) {
-  let listeners = listenersByType.get(type);
-  if (!listeners) {
-    listeners = /* @__PURE__ */ new Map();
-    listenersByType.set(type, listeners);
-  }
-  let keyListeners = listeners.get(key);
-  if (!keyListeners) {
-    keyListeners = /* @__PURE__ */ new Set();
-    listeners.set(key, keyListeners);
-  }
-  return keyListeners;
-}
-function resolveRegistrationOptions(sourceOrOptions, optionsArg) {
-  if (sourceOrOptions && typeof sourceOrOptions === "object")
-    return sourceOrOptions;
-  return optionsArg && typeof optionsArg === "object" ? optionsArg : {};
-}
-function validateRegistration(definitions, type, key, value, sourceOrOptions, optionsArg) {
-  const options = resolveRegistrationOptions(sourceOrOptions, optionsArg);
-  const metadataValidation = validateRegistryMetadata(options);
-  const isStrict = options.validation === REGISTRY_VALIDATION_MODES.STRICT;
-  if (!metadataValidation.valid && isStrict) {
-    return {
-      issues: metadataValidation.issues,
-      reason: "invalid-metadata",
-      valid: false
-    };
-  }
-  const validation = validateRegistryValue(type, key, value, definitions);
-  if (validation.valid) return { valid: true };
-  if (!isStrict) {
-    report(`Registry ${type} "${key}" is invalid`, validation.issues, "warn");
-  }
-  return {
-    issues: validation.issues,
-    reason: "invalid-value",
-    valid: !isStrict
-  };
-}
-function createRegistrationHandle(store, operation) {
-  let disposed = false;
-  const dispose = (reason = "manual") => {
-    if (disposed) return false;
-    disposed = true;
-    return store.dispose(operation, reason);
-  };
-  const handle = ((reason) => dispose(reason));
-  handle.dispose = dispose;
-  handle.update = (value, options = {}) => {
-    if (disposed || !store.isCurrent(operation)) return NOOP_HANDLE;
-    const nextHandle = store.register(
-      operation.type,
-      operation.key,
-      value,
-      operation.source,
-      {
-        ...typeof options === "object" ? options : {},
-        instanceId: operation.instanceId,
-        priority: operation.record.priority,
-        ...operation.scope ? { scope: operation.scope } : {},
-        ...operation.validation ? { validation: operation.validation } : {}
-      }
-    );
-    if (isNoopHandle(nextHandle)) return handle;
-    disposed = true;
-    return nextHandle;
-  };
-  Object.defineProperties(handle, {
-    active: {
-      enumerable: true,
-      get: () => !disposed && store.isCurrent(operation)
-    },
-    instanceId: { enumerable: true, value: operation.instanceId },
-    key: { enumerable: true, value: operation.key },
-    priority: { enumerable: true, value: operation.record.priority },
-    source: { enumerable: true, value: operation.source },
-    status: {
-      enumerable: true,
-      get: () => disposed ? "disposed" : store.isCurrent(operation) ? "active" : "superseded"
-    },
-    type: { enumerable: true, value: operation.type },
-    updatedAt: { enumerable: true, value: operation.record.updatedAt },
-    validation: { enumerable: true, value: operation.validation || "warn" }
-  });
-  return handle;
-}
-function prepareRegisterOperation(ops, definitions, type, key, item, sourceOrOptions, optionsArg, timestamp, sequence) {
-  if (!ops.isValidRegistryTarget(type, key)) {
-    return { rejected: createNoopHandle("rejected", "invalid-target") };
-  }
-  const validation = validateRegistration(
-    definitions,
-    type,
-    key,
-    item,
-    sourceOrOptions,
-    optionsArg
-  );
-  if (!validation.valid) {
-    return { rejected: createNoopHandle("rejected", validation.reason) };
-  }
-  return {
-    operation: createRegisterOperation(
-      type,
-      key,
-      cloneRegistryValue(item),
-      sourceOrOptions,
-      optionsArg,
-      timestamp,
-      sequence
-    )
-  };
-}
-function createRegistryStore(initialEntries = [], definitions = NO_DEFINITIONS) {
-  const ops = createRegistryOperations(definitions);
-  let registries = createInitialState(ops, definitions, initialEntries);
-  let sequence = normalizeInitialEntries(initialEntries).reduce(
-    (count, entry) => count + Object.keys(entry.items).length,
-    0
-  );
-  const listenersByType = /* @__PURE__ */ new Map();
-  const entrySnapshots = /* @__PURE__ */ new Map();
-  const valueSnapshots = /* @__PURE__ */ new Map();
-  const resolveCachedValue = ops.createResolverCache();
-  const subscribe = (type, key, listener) => {
-    const keyListeners = getOrCreateKeyListeners(
-      listenersByType,
-      type,
-      key ?? null
-    );
-    keyListeners.add(listener);
-    return () => {
-      keyListeners.delete(listener);
-      if (keyListeners.size > 0) return;
-      const listeners = listenersByType.get(type);
-      if (listeners) {
-        listeners.delete(key ?? null);
-        if (listeners.size === 0) listenersByType.delete(type);
-      }
-    };
-  };
-  const commit = (nextState, operations = []) => {
-    if (registries === nextState) return;
-    const previousState = registries;
-    registries = nextState;
-    const changedKeysByType = /* @__PURE__ */ new Map();
-    for (const operation of operations) {
-      if (!ops.isValidRegistryTarget(operation?.type, operation?.key)) continue;
-      let keys = changedKeysByType.get(operation.type);
-      if (!keys) {
-        keys = /* @__PURE__ */ new Set();
-        changedKeysByType.set(operation.type, keys);
-      }
-      keys.add(operation.key);
-    }
-    for (const [type, changedKeys] of changedKeysByType) {
-      const previousRegistry = previousState[type] || {};
-      const nextRegistry = nextState[type] || {};
-      const typeListeners = listenersByType.get(type);
-      let typeChanged = false;
-      if (!typeListeners) continue;
-      for (const key of changedKeys) {
-        if (previousRegistry[key] === nextRegistry[key]) continue;
-        typeChanged = true;
-        notifyListeners(typeListeners.get(key));
-      }
-      if (typeChanged) {
-        notifyListeners(typeListeners.get(null));
-      }
-    }
-  };
-  const isCurrent = (operation) => {
-    const entry = registries[operation.type]?.[operation.key];
-    const recordKey = createRecordKey(
-      operation.source,
-      operation.instanceId,
-      operation.scope
-    );
-    return entry?.[recordKey] === operation.record;
-  };
-  const dispose = (operation, _reason = "manual") => {
-    if (!isCurrent(operation)) return false;
-    const unregisterOperation = createUnregisterOperation(
-      operation.type,
-      operation.key,
-      {
-        source: operation.source,
-        instanceId: operation.instanceId,
-        scope: operation.scope
-      }
-    );
-    if (!ops.hasOperationEffect(registries, unregisterOperation)) return false;
-    commit(ops.applyOperation(registries, unregisterOperation), [
-      unregisterOperation
-    ]);
-    return true;
-  };
-  const register = (type, key, item, sourceOrOptions = DEFAULT_SOURCE, optionsArg = {}) => {
-    const prepared = prepareRegisterOperation(
-      ops,
-      definitions,
-      type,
-      key,
-      item,
-      sourceOrOptions,
-      optionsArg,
-      Date.now(),
-      ++sequence
-    );
-    if ("rejected" in prepared) return prepared.rejected;
-    const { operation } = prepared;
-    if (!ops.hasOperationEffect(registries, operation)) {
-      return createNoopHandle("ignored", "unchanged");
-    }
-    commit(ops.applyOperation(registries, operation), [operation]);
-    return createRegistrationHandle(store, operation);
-  };
-  const unregister = (type, key, sourceOrOptions = DEFAULT_SOURCE) => {
-    if (!ops.isValidRegistryTarget(type, key)) return;
-    const operation = createUnregisterOperation(type, key, sourceOrOptions);
-    if (!ops.hasOperationEffect(registries, operation)) return;
-    commit(ops.applyOperation(registries, operation), [operation]);
-  };
-  const batch = (executor) => {
-    if (typeof executor !== "function") return 0;
-    const timestamp = Date.now();
-    const operations = [];
-    const queue = {
-      register: (type, key, item, sourceOrOptions = DEFAULT_SOURCE, optionsArg = {}) => {
-        const prepared = prepareRegisterOperation(
-          ops,
-          definitions,
-          type,
-          key,
-          item,
-          sourceOrOptions,
-          optionsArg,
-          timestamp,
-          ++sequence
-        );
-        if ("rejected" in prepared) return prepared.rejected;
-        operations.push(prepared.operation);
-        return createRegistrationHandle(store, prepared.operation);
-      },
-      unregister: (type, key, sourceOrOptions = DEFAULT_SOURCE) => {
-        if (!ops.isValidRegistryTarget(type, key)) return;
-        operations.push(createUnregisterOperation(type, key, sourceOrOptions));
-      }
-    };
-    executor(queue);
-    if (operations.length === 0) return 0;
-    const { effectiveOperations, nextState } = ops.resolveEffectiveOperations(
-      registries,
-      operations
-    );
-    if (effectiveOperations.length === 0) return 0;
-    commit(nextState, effectiveOperations);
-    return effectiveOperations.length;
-  };
-  const getSnapshot = (type, key, scope = null) => {
-    const entry = registries[type]?.[key];
-    let snapshots = valueSnapshots.get(type);
-    if (!snapshots) {
-      snapshots = /* @__PURE__ */ new Map();
-      valueSnapshots.set(type, snapshots);
-    }
-    const cacheKey = scope === null ? key : `${scope}\0${key}`;
-    if (entry === void 0) {
-      snapshots.delete(cacheKey);
-      return void 0;
-    }
-    const cached = snapshots.get(cacheKey);
-    if (cached && cached.entry === entry) return cached.value;
-    const value = resolveCachedValue(type, entry, scope);
-    snapshots.set(cacheKey, { entry, value });
-    return value;
-  };
-  const getEntriesSnapshot = (type, scope = null) => {
-    const typeRegistry = registries[type] || {};
-    const cacheKey = `${type}::${scope ?? "null"}`;
-    const cached = entrySnapshots.get(cacheKey);
-    if (cached?.typeRegistry === typeRegistry) return cached.value;
-    const resolved = {};
-    for (const key in typeRegistry) {
-      if (Object.prototype.hasOwnProperty.call(typeRegistry, key)) {
-        const value = resolveCachedValue(type, typeRegistry[key], scope);
-        if (value !== void 0) resolved[key] = value;
-      }
-    }
-    const finalValue = Object.freeze(resolved);
-    entrySnapshots.set(cacheKey, { typeRegistry, value: finalValue });
-    return finalValue;
-  };
-  const store = {
-    batch,
-    dispose,
-    getEntriesSnapshot,
-    getSnapshot,
-    isCurrent,
-    register,
-    subscribe,
-    transaction: (executor, metadata = {}) => createRegistryTransaction(store, metadata).run(executor),
-    unregister
-  };
-  return store;
-}
-var RegistryContext = getOrCreateGlobalContext(
-  "RegistryContext",
-  null
-);
-function RegistryProvider({
-  children,
-  definitions,
-  initialEntries = []
-}) {
-  const [store] = useState(
-    () => createRegistryStore(initialEntries, definitions)
-  );
-  const contextValue = useMemo(
-    () => ({
-      actions: {
-        batch: store.batch,
-        register: store.register,
-        transaction: store.transaction,
-        unregister: store.unregister
-      },
-      subscription: {
-        getEntriesSnapshot: store.getEntriesSnapshot,
-        getSnapshot: store.getSnapshot,
-        subscribe: store.subscribe
-      }
-    }),
-    [store]
-  );
-  return /* @__PURE__ */ jsx(RegistryContext, { value: contextValue, children });
-}
-var EMPTY_MODULES = Object.freeze([]);
-var PassthroughBoundary = ({ children }) => children;
-var ModuleHostContext = getOrCreateGlobalContext("ModuleHostContext", null);
-var MODULE_ID_PATTERN = /^[a-z][a-zA-Z0-9]*$/;
-function sortModules(modules) {
-  const byId = /* @__PURE__ */ new Map();
-  for (const coreModule of modules) {
-    if (!MODULE_ID_PATTERN.test(coreModule.id)) {
-      throw new Error(
-        `[Core] Invalid module id "${coreModule.id}": use a camelCase name such as "contextMenu".`
-      );
-    }
-    if (byId.has(coreModule.id)) {
-      throw new Error(`[Core] Module "${coreModule.id}" is installed twice.`);
-    }
-    byId.set(coreModule.id, coreModule);
-  }
-  const sorted = [];
-  const state = /* @__PURE__ */ new Map();
-  const visit = (coreModule, path) => {
-    const current = state.get(coreModule.id);
-    if (current === "done") return;
-    if (current === "visiting") {
-      throw new Error(
-        `[Core] Module dependency cycle: ${[...path, coreModule.id].join(" -> ")}`
-      );
-    }
-    state.set(coreModule.id, "visiting");
-    for (const id of coreModule.uses ?? []) {
-      const dependency = byId.get(id);
-      if (dependency) visit(dependency, [...path, coreModule.id]);
-    }
-    state.set(coreModule.id, "done");
-    sorted.push(coreModule);
-  };
-  modules.forEach((coreModule) => visit(coreModule, []));
-  return sorted;
-}
-function createModuleRegistryDefinitions(modules) {
-  const definitions = /* @__PURE__ */ new Map();
-  for (const coreModule of modules) {
-    if (coreModule.registry)
-      definitions.set(coreModule.id, coreModule.registry);
-  }
-  return definitions;
-}
-function createPageControllerStore() {
-  const listeners = /* @__PURE__ */ new Set();
-  let stack = [];
-  const notify = () => {
-    listeners.forEach((listener) => {
-      try {
-        listener();
-      } catch (error) {
-        report("Page controller listener", error);
-      }
-    });
-  };
-  return {
-    getSnapshot() {
-      const top = stack[stack.length - 1];
-      return top?.controllerRef?.current || null;
-    },
-    notify,
-    register(id, controllerRef) {
-      stack = stack.filter((item) => item.id !== id);
-      stack.push({ controllerRef, id });
-      notify();
-    },
-    subscribe(listener) {
-      listeners.add(listener);
-      return () => {
-        listeners.delete(listener);
-      };
-    },
-    unregister(id) {
-      stack = stack.filter((item) => item.id !== id);
-      notify();
-    }
-  };
-}
-var fallbackStandaloneStore = createPageControllerStore();
-getOrCreateGlobalContext(
-  "PageControllerContext",
-  null
-);
-var PageControllerStoreContext = getOrCreateGlobalContext(
-  "PageControllerStoreContext",
-  fallbackStandaloneStore
-);
-function PageControllerProvider({ children }) {
-  const [store] = useState(
-    () => createPageControllerStore()
-  );
-  return /* @__PURE__ */ jsx(PageControllerStoreContext, { value: store, children });
-}
-function warnMissingPeers(modules) {
-  const installed = new Set(modules.map((coreModule) => coreModule.id));
-  for (const { id, uses } of modules) {
-    const missing = (uses ?? []).filter((peer) => !installed.has(peer));
-    if (missing.length > 0) {
-      report(
-        `Module "${id}" runs without its optional peers`,
-        missing.join(", "),
-        "warn"
-      );
-    }
-  }
-}
-function createModuleHost(modules, Boundary) {
-  const sorted = sortModules(modules);
-  if (process.env.NODE_ENV !== "production") warnMissingPeers(sorted);
-  return {
-    Boundary,
-    byId: new Map(sorted.map((coreModule) => [coreModule.id, coreModule])),
-    definitions: createModuleRegistryDefinitions(sorted),
-    modules: Object.freeze(sorted)
-  };
-}
-function ModuleHost({
-  boundary = PassthroughBoundary,
-  children,
-  modules = EMPTY_MODULES,
-  registryEntries
-}) {
-  const [host] = useState(() => createModuleHost(modules, boundary));
-  const { Boundary } = host;
-  const content = /* @__PURE__ */ jsxs(Fragment, { children: [
-    host.modules.map(
-      ({ Backdrop, id }) => Backdrop ? /* @__PURE__ */ jsx(Boundary, { name: id, children: /* @__PURE__ */ jsx(Backdrop, {}) }, id) : null
-    ),
-    children,
-    host.modules.map(
-      ({ Overlay, id }) => Overlay ? /* @__PURE__ */ jsx(Boundary, { name: id, children: /* @__PURE__ */ jsx(Overlay, {}) }, id) : null
-    )
-  ] });
-  const tree = host.modules.reduceRight(
-    (inner, { Provider: Provider2 }) => Provider2 ? /* @__PURE__ */ jsx(Provider2, { children: inner }) : inner,
-    content
-  );
-  return /* @__PURE__ */ jsx(
-    RegistryProvider,
-    {
-      definitions: host.definitions,
-      initialEntries: registryEntries,
-      children: /* @__PURE__ */ jsx(ModuleHostContext, { value: host, children: /* @__PURE__ */ jsx(PageControllerProvider, { children: tree }) })
-    }
-  );
-}
-createStore(void 0);
-function Compose({ providers, children }) {
-  return providers.reduceRight(
-    (acc, entry) => {
-      if (Array.isArray(entry)) {
-        const [Component2, props] = entry;
-        return createElement(Component2, props, acc);
-      }
-      const Component = entry;
-      return createElement(Component, null, acc);
-    },
-    createElement(Fragment$1, null, children)
-  );
-}
-
-// src/theme.tsx
-function defineThemeSpec(id) {
-  return Object.freeze({ id });
-}
-var EMPTY = /* @__PURE__ */ new Map();
-var ThemeContext = getOrCreateGlobalContext("ThemeContext", EMPTY);
-function useTheme(spec) {
-  const config = useContext(ThemeContext).get(spec.id);
-  if (!config) {
-    throw new Error(
-      `Theme "${spec.id}" is missing. Ensure its theme configuration is provided to <ThemeProvider themes={[...]}> (e.g. in src/config/ or your theme setup).`
-    );
-  }
-  return {
-    slots: config.slots,
-    styles: config.styles ?? {}
-  };
-}
-
-// src/error/theme.ts
-var errorTheme = defineThemeSpec("error");
-var ActionButton = Button;
-function DefaultErrorFallback({
-  error,
-  message,
-  resetError,
-  title
-}) {
-  const theme = useTheme(errorTheme);
-  return /* @__PURE__ */ jsxs("div", { className: theme.slots.screen, children: [
-    /* @__PURE__ */ jsx("div", { className: theme.slots.icon, children: /* @__PURE__ */ jsx(Icon, { icon: "solar:danger-circle-bold", size: 30 }) }),
-    /* @__PURE__ */ jsx("h3", { className: theme.slots.title, children: message || toUserMessage(error, { fallback: ERROR_MESSAGES.FALLBACK_MSG }) }),
-    /* @__PURE__ */ jsx(
-      ActionButton,
-      {
-        className: theme.slots.retryButton,
-        onClick: resetError,
-        type: "button",
-        children: "Try again"
-      }
-    )
-  ] });
-}
-var ErrorBoundaryCore = class extends React.Component {
-  constructor(props) {
-    super(props);
-    this.state = {
-      error: null,
-      errorInfo: null,
-      hasError: false,
-      lastResetKey: props.resetKey
-    };
-  }
-  static getDerivedStateFromError(error) {
-    return { error, hasError: true };
-  }
-  static getDerivedStateFromProps(props, state) {
-    if (props.resetKey !== state.lastResetKey) {
-      return {
-        error: null,
-        errorInfo: null,
-        hasError: false,
-        lastResetKey: props.resetKey
-      };
-    }
-    return null;
-  }
-  componentDidCatch(error, errorInfo) {
-    this.setState({ errorInfo });
-    const { message, name, onError, silent, title, variant } = this.props;
-    const context = createErrorContext({ errorInfo, name, title, variant });
-    try {
-      onError?.(error, errorInfo, context);
-    } catch (callbackError) {
-      report("ErrorBoundary onError callback", callbackError, "warn");
-    }
-    if (!silent) {
-      globalEvents.emit(EVENT_TYPES.APP_ERROR, {
-        error,
-        errorInfo,
-        message: message || toUserMessage(error),
-        resetError: this.resetError
-      });
-    }
-    try {
-      const reporter = getErrorReporter();
-      reporter?.captureError?.(error, context);
-    } catch (reportingError) {
-      report("ErrorBoundary reporting", reportingError, "warn");
-    }
-  }
-  resetError = () => {
-    this.setState({
-      error: null,
-      errorInfo: null,
-      hasError: false
-    });
-    this.props.onReset?.();
-  };
-  render() {
-    if (!this.state.hasError) return this.props.children;
-    const { fallback, message, title } = this.props;
-    const { error } = this.state;
-    if (typeof fallback === "function") {
-      return fallback({ error, resetError: this.resetError });
-    }
-    if (fallback) {
-      return fallback;
-    }
-    return /* @__PURE__ */ jsx(
-      DefaultErrorFallback,
-      {
-        error,
-        message,
-        resetError: this.resetError,
-        title
-      }
-    );
-  }
-};
-function GlobalError({ children, fallback, onReset }) {
-  const pathname = usePathname();
-  return /* @__PURE__ */ jsx(
-    ErrorBoundaryCore,
-    {
-      fallback,
-      message: ERROR_MESSAGES.GLOBAL_MSG,
-      onReset,
-      resetKey: pathname,
-      title: ERROR_MESSAGES.GLOBAL_TITLE,
-      variant: "full",
-      children
-    }
-  );
-}
-function ModuleError({
-  children,
-  fallback,
-  name,
-  onReset
-}) {
-  return /* @__PURE__ */ jsx(
-    ErrorBoundaryCore,
-    {
-      fallback,
-      message: ERROR_MESSAGES.MODULE_MSG,
-      name,
-      onReset,
-      title: name ? `${name} Error` : ERROR_MESSAGES.MODULE_TITLE,
-      variant: "module",
-      children
-    }
-  );
-}
-function GlobalErrorListener() {
-  const lastError = useRef(0);
-  const count = useRef(0);
-  const shown = useRef(/* @__PURE__ */ new Set());
-  const handleError = useCallback((error, source = "runtime") => {
-    if (shouldIgnoreError(error)) return;
-    const now = Date.now();
-    if (count.current >= ERROR_LISTENER_CONFIG.maxErrors) return;
-    if (now - lastError.current < ERROR_LISTENER_CONFIG.throttle) return;
-    const message = getErrorMessage(error);
-    const key = message || String(error);
-    if (shown.current.has(key)) return;
-    shown.current.add(key);
-    lastError.current = now;
-    count.current += 1;
-    try {
-      const reporter = getErrorReporter();
-      reporter?.captureError?.(error, {
-        globalListener: true,
-        source
-      });
-    } catch (reportingError) {
-      report("GlobalError reporting", reportingError, "warn");
-    }
-    globalEvents.emit(EVENT_TYPES.APP_ERROR, {
-      error,
-      message: toUserMessage(error)
-    });
-  }, []);
-  useEffect(() => {
-    const removeSink = setReportSink((scope, error, level) => {
-      try {
-        getErrorReporter().captureError(error, { level, scope });
-      } catch {
-      }
-    });
-    const onError = (event) => handleError(event.error || event.message, "window.onerror");
-    const onRejection = (event) => handleError(event.reason, "unhandledrejection");
-    window.addEventListener("error", onError);
-    window.addEventListener("unhandledrejection", onRejection);
-    return () => {
-      removeSink();
-      window.removeEventListener("error", onError);
-      window.removeEventListener("unhandledrejection", onRejection);
-    };
-  }, [handleError]);
-  return null;
-}
-function CoreProvider({
-  children,
-  modules,
-  overlays,
-  providers,
-  registryEntries,
-  slots,
-  tooltip = true
-}) {
-  const tooltipConfig = useMemo(
-    () => tooltip === false ? null : {
-      delayDuration: typeof tooltip === "object" && tooltip.delayDuration || 300,
-      skipDelayDuration: typeof tooltip === "object" && tooltip.skipDelayDuration || 150
-    },
-    [tooltip]
-  );
-  const providerPipeline = useMemo(
-    () => [
-      GlobalError,
-      ...tooltipConfig ? [[TooltipPrimitive.Provider, tooltipConfig]] : [],
-      [ModuleHost, { boundary: ModuleError, modules, registryEntries }],
-      ...providers ?? []
-    ],
-    [modules, providers, registryEntries, tooltipConfig]
-  );
-  return /* @__PURE__ */ jsxs(Compose, { providers: providerPipeline, children: [
-    slots?.beforeContent,
-    children,
-    slots?.afterContent,
-    overlays,
-    slots?.overlays,
-    /* @__PURE__ */ jsx(GlobalErrorListener, {})
-  ] });
-}
-
-export { CoreProvider };
+export { CoreProvider } from './chunk-K676GL7Z.js';
+import './chunk-JELG4JLT.js';
+import './chunk-7TAVYJ3A.js';
+import './chunk-GF7TUX5I.js';
+import './chunk-TV3WEF5G.js';
+import './chunk-3BUP64Q6.js';
 //# sourceMappingURL=provider.js.map
 //# sourceMappingURL=provider.js.map