@omerdlw/base-framework 1.0.5 → 2.0.0

package/dist/modules/controls/index.js

@@ -1,1113 +1,7 @@
 "use client";
-import { createContext, isValidElement, createElement, useState, useEffect, useMemo, Fragment, useSyncExternalStore, use, useId, useCallback, useContext, useRef, useLayoutEffect, cloneElement, Children } from 'react';
-import { createPortal } from 'react-dom';
-import { usePathname } from 'next/navigation';
-import { jsx, jsxs, Fragment as Fragment$1 } from 'react/jsx-runtime';
-
-// 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"
-]);
-Object.freeze({
-  [REGISTRY_SOURCES.STATIC]: 100,
-  [REGISTRY_SOURCES.DYNAMIC]: 200,
-  [REGISTRY_SOURCES.USER]: 300
-});
-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"
-});
-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/dom.ts
-var isBrowser = typeof window !== "undefined";
-
-// src/utils/number.ts
-function clamp(value, min, max) {
-  const num = Number(value);
-  const finite = Number.isFinite(num) ? num : min;
-  return Math.min(Math.max(finite, min), max);
-}
-function toFiniteNumber(value, fallback = 0) {
-  const parsed = Number(value);
-  return Number.isFinite(parsed) ? parsed : fallback;
-}
-
-// 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 report(scope, error, level = "error") {
-  if (process.env.NODE_ENV === "production" && typeof window !== "undefined") {
-    return;
-  }
-  console[level](`[${scope}]`, error);
-}
-
-// 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 parseFiniteNumber(value) {
-  const parsed = Number(value);
-  return Number.isFinite(parsed) ? parsed : null;
-}
-function getValidString(value, fallback = null) {
-  return trimToNull(value) ?? fallback;
-}
-
-// src/kernel/schema.ts
-function resolveLifecycle(metadata, fallback) {
-  const lifecycle = metadata?.lifecycle ?? metadata?.cleanup;
-  return lifecycle && REGISTRY_LIFECYCLE_VALUES.has(lifecycle) ? lifecycle : fallback;
-}
-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 normalizeRegistryMetadata(metadata, {
-  defaultCleanupDelayMs = null,
-  defaultLifecycle = null,
-  defaultSource = DEFAULT_SOURCE
-} = {}) {
-  const registryMeta = isObject(metadata) ? metadata : {};
-  const normalizedDefaultDelay = parseFiniteNumber(defaultCleanupDelayMs);
-  const fallbackCleanupDelayMs = normalizedDefaultDelay !== null && normalizedDefaultDelay >= 0 ? normalizedDefaultDelay : null;
-  const fallbackLifecycle = defaultLifecycle && REGISTRY_LIFECYCLE_VALUES.has(defaultLifecycle) ? defaultLifecycle : null;
-  const source = getValidString(registryMeta.source) || getValidString(defaultSource, DEFAULT_SOURCE) || DEFAULT_SOURCE;
-  const scope = getValidString(registryMeta.scope);
-  const priority = parseFiniteNumber(registryMeta.priority);
-  const lifecycle = resolveLifecycle(registryMeta, fallbackLifecycle);
-  const validation = isValidationMode(registryMeta.validation) ? registryMeta.validation : null;
-  const cleanupDelayCandidate = parseFiniteNumber(registryMeta.cleanupDelayMs);
-  let cleanupDelayMs = cleanupDelayCandidate !== null && cleanupDelayCandidate >= 0 ? cleanupDelayCandidate : fallbackCleanupDelayMs;
-  if (lifecycle === REGISTRY_LIFECYCLES.IMMEDIATE) {
-    cleanupDelayMs = 0;
-  } else if ((lifecycle === REGISTRY_LIFECYCLES.GRACEFUL || lifecycle === REGISTRY_LIFECYCLES.ROUTE) && cleanupDelayMs === null) {
-    cleanupDelayMs = fallbackCleanupDelayMs;
-  }
-  return {
-    cleanupDelayMs,
-    lifecycle,
-    priority,
-    registerOptions: {
-      ...priority !== null && { priority },
-      ...validation === REGISTRY_VALIDATION_MODES.STRICT && { validation },
-      ...scope && { scope }
-    },
-    source,
-    ...scope && { scope },
-    ...validation && { validation }
-  };
-}
-function isValidationMode(value) {
-  return Object.values(REGISTRY_VALIDATION_MODES).includes(value);
-}
-function pickRegistryMetadata(options) {
-  if (!isObject(options)) return {};
-  return Object.fromEntries(
-    REGISTRY_METADATA_KEYS.filter((key) => options[key] !== void 0).map(
-      (key) => [key, options[key]]
-    )
-  );
-}
-function useRequiredContext(context, hookName, providerName) {
-  const value = use(context);
-  if (value === null) {
-    throw new Error(`${hookName} must be used within ${providerName}`);
-  }
-  return value;
-}
-var useIsomorphicLayoutEffect = isBrowser ? useLayoutEffect : useEffect;
-var RegistryContext = getOrCreateGlobalContext(
-  "RegistryContext",
-  null
-);
-function useRegistryActions() {
-  return useRequiredContext(
-    RegistryContext,
-    "useRegistryActions",
-    "RegistryProvider"
-  ).actions;
-}
-function useRegistrySubscription() {
-  return useRequiredContext(
-    RegistryContext,
-    "useRegistrySubscription",
-    "RegistryProvider"
-  ).subscription;
-}
-function useRegistryEntries(type) {
-  const { getEntriesSnapshot, subscribe } = useRegistrySubscription();
-  const subscribeToType = useCallback(
-    (listener) => subscribe(type, null, listener),
-    [subscribe, type]
-  );
-  const getEntries = useCallback(
-    () => getEntriesSnapshot(type),
-    [getEntriesSnapshot, type]
-  );
-  return useSyncExternalStore(subscribeToType, getEntries, getEntries);
-}
-var EMPTY_MODULES = Object.freeze([]);
-var ModuleHostContext = getOrCreateGlobalContext("ModuleHostContext", null);
-function selectModuleSlice(coreModule, config) {
-  const slice = coreModule.page?.select ? coreModule.page.select(config) : config[coreModule.id];
-  return slice ?? null;
-}
-function createModulePayload(modules, config, metadata = {}) {
-  const payload = {};
-  let hasSlices = false;
-  for (const coreModule of modules) {
-    if (!coreModule.page?.entries) continue;
-    const slice = selectModuleSlice(coreModule, config);
-    if (slice === null) continue;
-    payload[coreModule.id] = slice;
-    hasSlices = true;
-  }
-  if (!hasSlices) return null;
-  return {
-    ...payload,
-    registry: {
-      ...metadata,
-      ...isObject(config.registry) ? config.registry : {}
-    }
-  };
-}
-function useInstalledModules() {
-  return use(ModuleHostContext)?.modules ?? EMPTY_MODULES;
-}
-
-// src/kernel/handlers.ts
-function isPersistentLifecycle(lifecycle) {
-  return lifecycle === REGISTRY_LIFECYCLES.PERSISTENT;
-}
-function runRegistrationBatch(context, executor) {
-  return typeof context.batch === "function" ? context.batch(executor) : executor(context);
-}
-function createEntryCleanupKey(type, key, source, instanceId, scope) {
-  return JSON.stringify([
-    "entry",
-    type,
-    key,
-    scope ?? null,
-    source,
-    instanceId
-  ]);
-}
-function getCleanupScope(context) {
-  return context?.cleanupScope || /* @__PURE__ */ new Map();
-}
-function clearCleanupTimer(scope, cleanupKey) {
-  const lifecycle = scope.get(cleanupKey);
-  if (!lifecycle) return;
-  lifecycle.cancelled = true;
-  if (lifecycle.timerId !== null) clearTimeout(lifecycle.timerId);
-  scope.delete(cleanupKey);
-}
-function scheduleCleanup(scope, cleanupKey, callback, delayMs) {
-  clearCleanupTimer(scope, cleanupKey);
-  const lifecycle = {
-    cancelled: false,
-    timerId: null
-  };
-  lifecycle.timerId = setTimeout(() => {
-    if (lifecycle.cancelled || scope.get(cleanupKey) !== lifecycle) return;
-    scope.delete(cleanupKey);
-    callback();
-  }, delayMs);
-  scope.set(cleanupKey, lifecycle);
-}
-function collectModuleRegistrations(coreModule, slice, pageMetadata, context) {
-  const definition = coreModule.registry;
-  const toEntries = coreModule.page?.entries;
-  if (!definition || !toEntries || slice == null || slice === false) return [];
-  const type = coreModule.id;
-  const items = Array.isArray(slice) ? slice : [slice];
-  const registrations = [];
-  for (const item of items) {
-    if (item == null || item === false) continue;
-    const itemMetadata = isObject(item) && isObject(item.registry) ? item.registry : {};
-    const metadata = { ...pageMetadata, ...itemMetadata };
-    if (metadata.validation === "strict" && !validateRegistryMetadata(metadata).valid) {
-      continue;
-    }
-    const payload = isObject(item) ? Object.fromEntries(
-      Object.entries(item).filter(([key]) => key !== "registry")
-    ) : item;
-    const { cleanupDelayMs, lifecycle, registerOptions, scope, source } = normalizeRegistryMetadata(metadata, {
-      defaultCleanupDelayMs: definition.cleanupDelayMs ?? null,
-      defaultLifecycle: definition.lifecycle,
-      defaultSource: DEFAULT_SOURCE
-    });
-    for (const { key, value } of toEntries(payload, context) ?? []) {
-      const validation = definition.validate?.(value);
-      if (validation && !validation.valid) {
-        report(`Registry ${type} config is invalid`, validation.issues, "warn");
-        continue;
-      }
-      registrations.push({
-        cleanupDelayMs,
-        cleanupKey: createEntryCleanupKey(
-          type,
-          key,
-          source,
-          context.instanceId,
-          scope
-        ),
-        key,
-        lifecycle,
-        registerOptions,
-        scope,
-        source,
-        type,
-        value
-      });
-    }
-  }
-  return registrations;
-}
-var NO_CLEANUP = () => {
-};
-function applyRegistryConfig(config, context) {
-  const modules = context.modules ?? [];
-  if (!config || modules.length === 0) return NO_CLEANUP;
-  const pageMetadata = isObject(config.registry) ? config.registry : {};
-  const slices = config;
-  const registrations = modules.flatMap((coreModule) => {
-    try {
-      return collectModuleRegistrations(
-        coreModule,
-        slices[coreModule.id],
-        pageMetadata,
-        context
-      );
-    } catch (error) {
-      report(`Registry apply (${coreModule.id})`, error);
-      return [];
-    }
-  });
-  if (registrations.length === 0) return NO_CLEANUP;
-  const cleanupScope = getCleanupScope(context);
-  const owner = (registration) => ({
-    instanceId: context.instanceId,
-    scope: registration.scope,
-    source: registration.source
-  });
-  runRegistrationBatch(context, (queue) => {
-    registrations.forEach(
-      ({ cleanupKey, key, registerOptions, source, type, value }) => {
-        clearCleanupTimer(cleanupScope, cleanupKey);
-        queue.register(type, key, value, source, registerOptions);
-      }
-    );
-  });
-  return () => {
-    const immediate = [];
-    registrations.forEach((registration) => {
-      if (isPersistentLifecycle(registration.lifecycle)) return;
-      const { cleanupDelayMs, cleanupKey, key, type } = registration;
-      if (typeof cleanupDelayMs === "number" && cleanupDelayMs > 0) {
-        scheduleCleanup(
-          cleanupScope,
-          cleanupKey,
-          () => context.unregister(type, key, owner(registration)),
-          cleanupDelayMs
-        );
-      } else {
-        immediate.push(registration);
-      }
-    });
-    if (immediate.length === 0) return;
-    runRegistrationBatch(context, (queue) => {
-      immediate.forEach(
-        (registration) => queue.unregister(
-          registration.type,
-          registration.key,
-          owner(registration)
-        )
-      );
-    });
-  };
-}
-
-// src/kernel/hooks.ts
-function withInstanceId(instanceId, sourceOrOptions, optionsArg) {
-  if (typeof sourceOrOptions === "string") {
-    return {
-      optionsArg: { ...isObject(optionsArg) ? optionsArg : {}, instanceId },
-      sourceOrOptions
-    };
-  }
-  if (isObject(sourceOrOptions)) {
-    return {
-      optionsArg,
-      sourceOrOptions: { ...sourceOrOptions, instanceId }
-    };
-  }
-  return {
-    optionsArg: void 0,
-    sourceOrOptions: {
-      ...isObject(optionsArg) ? optionsArg : {},
-      instanceId
-    }
-  };
-}
-function withInstanceIdForUnregister(instanceId, sourceOrOptions) {
-  if (typeof sourceOrOptions === "string") {
-    return { instanceId, source: sourceOrOptions };
-  }
-  if (isObject(sourceOrOptions)) {
-    return { ...sourceOrOptions, instanceId };
-  }
-  return { instanceId };
-}
-function resolveRegisterArgsWithInstance(instanceId, sourceOrOptions, optionsArg) {
-  const input = withInstanceId(instanceId, sourceOrOptions, optionsArg);
-  return [input.sourceOrOptions, input.optionsArg];
-}
-var MAX_STABILIZATION_DEPTH = 64;
-function createStableFunctionEntry(fn) {
-  const entry = {
-    current: fn,
-    stable(...args) {
-      return entry.current?.apply(this, args);
-    }
-  };
-  return entry;
-}
-function isDirectRegistryComponentPath(path, componentSlices) {
-  const match = /^config\.([^.[]+)\.[^.[]+$/.exec(path);
-  return Boolean(match && componentSlices.has(match[1]));
-}
-function isReactNodeLike(value) {
-  return value === null || value === void 0 || typeof value === "boolean" || typeof value === "string" || typeof value === "number" || isValidElement(value);
-}
-function isStabilizableObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value) && !isValidElement(value);
-}
-function hasSameObjectKeys(previousValue, nextValue) {
-  if (!isStabilizableObject(previousValue) || !isStabilizableObject(nextValue)) {
-    return false;
-  }
-  const previousKeys = Object.keys(previousValue);
-  const nextKeys = Object.keys(nextValue);
-  if (previousKeys.length !== nextKeys.length) return false;
-  return nextKeys.every(
-    (key) => Object.prototype.hasOwnProperty.call(previousValue, key)
-  );
-}
-function stabilizeRegistryValue(value, path, scope, previousValue, seen = /* @__PURE__ */ new WeakSet(), depth = 0) {
-  if (depth > MAX_STABILIZATION_DEPTH) return value;
-  if (typeof value === "function") {
-    const isComponent = value.name && /^[A-Z]/.test(value.name);
-    if (isComponent || isDirectRegistryComponentPath(path, scope.componentSlices)) {
-      return value;
-    }
-    scope.usedPaths.add(path);
-    let entry = scope.functionEntries.get(path);
-    if (!entry) {
-      entry = createStableFunctionEntry(value);
-      scope.functionEntries.set(path, entry);
-    } else {
-      entry.current = value;
-    }
-    return entry.stable;
-  }
-  if (value && typeof value === "object") {
-    if (seen.has(value)) return value;
-    seen.add(value);
-  }
-  if (isValidElement(value)) {
-    const nextProps = stabilizeRegistryValue(
-      value.props,
-      `${path}.props`,
-      scope,
-      isValidElement(previousValue) ? previousValue.props : void 0,
-      seen,
-      depth + 1
-    );
-    if (isValidElement(previousValue) && previousValue.type === value.type && previousValue.key === value.key && previousValue.props === nextProps) {
-      return previousValue;
-    }
-    return cloneElement(value, nextProps);
-  }
-  if (Array.isArray(value)) {
-    const nextValue = value.every(isReactNodeLike) ? Children.toArray(value) : value;
-    const previousArray = Array.isArray(previousValue) ? previousValue : null;
-    let hasChanged2 = !previousArray || previousArray.length !== nextValue.length;
-    const stabilizedValue2 = nextValue.map((item, index) => {
-      const nextItem = stabilizeRegistryValue(
-        item,
-        `${path}[${index}]`,
-        scope,
-        previousArray?.[index],
-        seen,
-        depth + 1
-      );
-      if (!previousArray || nextItem !== previousArray[index]) {
-        hasChanged2 = true;
-      }
-      return nextItem;
-    });
-    return !hasChanged2 ? previousArray : stabilizedValue2;
-  }
-  if (typeof value !== "object" || value === null) {
-    return value;
-  }
-  const source = value;
-  const previousRecord = previousValue;
-  const stabilizedValue = {};
-  const canReusePrevious = hasSameObjectKeys(previousValue, value);
-  let hasChanged = !canReusePrevious;
-  Object.keys(source).forEach((key) => {
-    const nextValue = stabilizeRegistryValue(
-      source[key],
-      `${path}.${key}`,
-      scope,
-      previousRecord?.[key],
-      seen,
-      depth + 1
-    );
-    stabilizedValue[key] = nextValue;
-    if (!canReusePrevious || nextValue !== previousRecord?.[key]) {
-      hasChanged = true;
-    }
-  });
-  return !hasChanged ? previousValue : stabilizedValue;
-}
-function useAppliedRegistryConfig(payload, context, componentSlices) {
-  const functionEntriesRef = useRef(/* @__PURE__ */ new Map());
-  const appliedRef = useRef(null);
-  useIsomorphicLayoutEffect(() => {
-    const previous = appliedRef.current;
-    if (previous && previous.payload === payload && previous.context === context) {
-      return;
-    }
-    const functionEntries = functionEntriesRef.current;
-    const usedPaths = /* @__PURE__ */ new Set();
-    const config = stabilizeRegistryValue(
-      payload,
-      "config",
-      { componentSlices, functionEntries, usedPaths },
-      previous?.config
-    );
-    functionEntries.forEach((_entry, path) => {
-      if (!usedPaths.has(path)) functionEntries.delete(path);
-    });
-    if (previous && previous.config === config && previous.context === context) {
-      previous.payload = payload;
-      return;
-    }
-    previous?.cleanup();
-    appliedRef.current = {
-      cleanup: applyRegistryConfig(config, context),
-      config,
-      context,
-      payload
-    };
-  });
-  useIsomorphicLayoutEffect(
-    () => () => {
-      appliedRef.current?.cleanup();
-      appliedRef.current = null;
-    },
-    []
-  );
-}
-function createRegistryApplyContext(actions, {
-  cleanupScope = /* @__PURE__ */ new Map(),
-  instanceId,
-  modules = [],
-  pathname
-}) {
-  const stamp = (queue) => ({
-    register: (type, key, item, sourceOrOptions, optionsArg) => queue.register(
-      type,
-      key,
-      item,
-      ...resolveRegisterArgsWithInstance(
-        instanceId,
-        sourceOrOptions,
-        optionsArg
-      )
-    ),
-    unregister: (type, key, sourceOrOptions) => queue.unregister(
-      type,
-      key,
-      withInstanceIdForUnregister(instanceId, sourceOrOptions)
-    )
-  });
-  return {
-    ...stamp(actions),
-    batch: (executor) => typeof executor === "function" ? actions.batch((queue) => executor(stamp(queue))) : 0,
-    cleanupScope,
-    instanceId,
-    modules,
-    pathname
-  };
-}
-function useRegistry(config, metadata) {
-  const { batch, register, unregister } = useRegistryActions();
-  const pathname = usePathname();
-  const modules = useInstalledModules();
-  const instanceId = `registry-instance-${useId()}`;
-  const [cleanupScope] = useState(
-    () => /* @__PURE__ */ new Map()
-  );
-  const context = useMemo(
-    () => createRegistryApplyContext(
-      { batch, register, unregister },
-      {
-        cleanupScope,
-        instanceId,
-        modules,
-        pathname
-      }
-    ),
-    [batch, cleanupScope, instanceId, modules, pathname, register, unregister]
-  );
-  const payload = useMemo(
-    () => config ? createModulePayload(modules, config, metadata) : null,
-    [config, metadata, modules]
-  );
-  const componentSlices = useMemo(
-    () => new Set(
-      modules.filter(
-        (coreModule) => coreModule.registry?.valueKind === "component"
-      ).map((coreModule) => coreModule.id)
-    ),
-    [modules]
-  );
-  useAppliedRegistryConfig(payload, context, componentSlices);
-}
-function defineModule(coreModule) {
-  return Object.freeze({ ...coreModule });
-}
-createStore(void 0);
-
-// src/kernel/adapters.ts
-function useModuleRegistration(id, value, options) {
-  const coreModule = useInstalledModules().find(
-    (candidate) => candidate.id === id
-  );
-  const config = coreModule && options?.enabled !== false && value != null ? { [id]: value } : null;
-  useRegistry(config, pickRegistryMetadata(options));
-}
-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/modules/controls/constants.ts
-var CONTROLS_EDGE_INSET = 4;
-var CONTROLS_DOCK_GAP = 8;
-var CONTROLS_DOCK_ELEMENT_ID = "dock-card-stack";
-var CONTROL_SIDE_NAMES = Object.freeze(["left", "right"]);
-var controlsTheme = defineThemeSpec("controls");
-function isControlSide(value) {
-  return CONTROL_SIDE_NAMES.includes(value);
-}
-function hasContent(content) {
-  return content !== void 0 && content !== null && content !== false;
-}
-function isRenderable(value) {
-  if (value === null || value === void 0 || ["boolean", "number", "string"].includes(typeof value) || isValidElement(value)) {
-    return true;
-  }
-  return Array.isArray(value) && value.every(isRenderable);
-}
-function validateControlEntry(entry) {
-  if (!isPlainObject(entry)) {
-    return { issues: ["control must be a plain object"], valid: false };
-  }
-  const issues = [];
-  if (!trimToNull(entry.id)) {
-    issues.push("control id must be a non-empty string");
-  }
-  if (!isControlSide(entry.side)) {
-    issues.push("control side must be left or right");
-  }
-  if (!hasContent(entry.content) || !isRenderable(entry.content)) {
-    issues.push("control content must be renderable");
-  }
-  if (!Number.isFinite(Number(entry.order))) {
-    issues.push("control order must be a finite number");
-  }
-  return { issues, valid: issues.length === 0 };
-}
-function resolveSlot(slot, props) {
-  if (slot == null || slot === false) return null;
-  if (isValidElement(slot)) return slot;
-  if (typeof slot === "function") return createElement(slot, props);
-  return slot;
-}
-function normalizePageControls(controls) {
-  if (!controls) return null;
-  if (Array.isArray(controls)) return controls;
-  if ("side" in controls) return [controls];
-  const { id = "controls", order = 0, path, registry } = controls;
-  return CONTROL_SIDE_NAMES.flatMap((side) => {
-    const content = controls[side];
-    if (!hasContent(content)) return [];
-    return [
-      {
-        ...registry ? { registry } : {},
-        content,
-        id: `${id}-${side}`,
-        order,
-        ...path ? { path } : {},
-        side
-      }
-    ];
-  });
-}
-function resolveControlsPairs(entries, pathname) {
-  const rows = /* @__PURE__ */ new Map();
-  for (const entry of Array.isArray(entries) ? entries : Object.values(entries || {})) {
-    if (entry?.path !== pathname || !isControlSide(entry.side) || !hasContent(entry.content)) {
-      continue;
-    }
-    const order = toFiniteNumber(entry.order);
-    const row = rows.get(order) ?? {};
-    rows.set(order, row);
-    const current = row[entry.side];
-    if (!current || String(entry.id).localeCompare(String(current.id)) < 0) {
-      row[entry.side] = { content: entry.content, id: entry.id };
-    }
-  }
-  const pairs = [...rows].sort(([a], [b]) => a - b).map(([, row]) => row).filter(
-    (row) => Boolean(row.left && row.right)
-  );
-  return {
-    left: pairs.map((row) => row.left),
-    right: pairs.map((row) => row.right)
-  };
-}
-
-// src/modules/controls/layout.ts
-function getControlsLayout(dockRect, viewport) {
-  const { height, width } = viewport;
-  if (!dockRect || width <= 0 || height <= 0) return null;
-  const inset = CONTROLS_EDGE_INSET;
-  const gap = CONTROLS_DOCK_GAP;
-  const dockLeft = clamp(dockRect.left, 0, width);
-  const dockRight = clamp(dockRect.right, dockLeft, width);
-  const dockBottom = clamp(dockRect.bottom, 0, height);
-  return {
-    bottom: Math.max(0, height - dockBottom),
-    height: Math.max(0, dockRect.height) / 2,
-    left: {
-      maxWidth: Math.max(0, dockLeft - inset * 2 - gap),
-      right: Math.max(inset, width - dockLeft + gap)
-    },
-    right: {
-      left: Math.min(width - inset, dockRight + gap),
-      maxWidth: Math.max(0, width - dockRight - inset * 2 - gap)
-    }
-  };
-}
-function areLayoutsEqual(a, b) {
-  if (a === b) return true;
-  if (!a || !b) return false;
-  return a.bottom === b.bottom && a.height === b.height && a.isHidden === b.isHidden && a.left.maxWidth === b.left.maxWidth && a.left.right === b.left.right && a.right.left === b.right.left && a.right.maxWidth === b.right.maxWidth;
-}
-function getDockStackElement() {
-  return document.getElementById(CONTROLS_DOCK_ELEMENT_ID);
-}
-function getDockElement() {
-  return document.querySelector('[data-controls-anchor="true"]') ?? getDockStackElement();
-}
-function measureLayout() {
-  const dockElement = getDockElement();
-  if (!dockElement) return null;
-  const layout = getControlsLayout(dockElement.getBoundingClientRect(), {
-    height: window.innerHeight,
-    width: window.innerWidth
-  });
-  return layout && {
-    ...layout,
-    isHidden: getDockStackElement()?.dataset.controlsHidden === "true"
-  };
-}
-
-// src/modules/controls/hooks.ts
-function useControlsLayout() {
-  const [layout, setLayout] = useState(null);
-  useEffect(() => {
-    let observed;
-    let resizeObserver;
-    const update = () => {
-      const next = measureLayout();
-      setLayout((prev) => areLayoutsEqual(prev, next) ? prev : next);
-    };
-    const observe = () => {
-      const dockElement = getDockElement();
-      if (dockElement !== observed) {
-        observed = dockElement;
-        resizeObserver?.disconnect();
-        mutationObserver.disconnect();
-        if (dockElement) {
-          if (typeof ResizeObserver !== "undefined") {
-            resizeObserver = new ResizeObserver(update);
-            resizeObserver.observe(dockElement);
-          }
-          mutationObserver.observe(dockElement, {
-            attributes: true,
-            attributeFilter: ["data-controls-anchor", "data-controls-hidden"]
-          });
-          if (dockElement.parentElement) {
-            mutationObserver.observe(dockElement.parentElement, {
-              childList: true
-            });
-          }
-        } else {
-          mutationObserver.observe(document.body, {
-            childList: true,
-            subtree: true
-          });
-        }
-      }
-      update();
-    };
-    const mutationObserver = new MutationObserver(observe);
-    observe();
-    window.addEventListener("resize", update);
-    return () => {
-      mutationObserver.disconnect();
-      resizeObserver?.disconnect();
-      window.removeEventListener("resize", update);
-    };
-  }, []);
-  return layout;
-}
-function useControlsRegistration(config, options) {
-  useModuleRegistration("controls", config, options);
-}
-function useControls(config, options) {
-  const pathname = usePathname();
-  const definitionPath = config && "path" in config ? config.path : void 0;
-  const path = options?.path || definitionPath || pathname;
-  const entries = useMemo(() => {
-    if (!config) return null;
-    if (Array.isArray(config) || "side" in config) return config;
-    const { defaultProps = {}, left, right, ...page } = config;
-    const resolved = normalizePageControls({
-      ...page,
-      left: resolveSlot(left, defaultProps),
-      path,
-      right: resolveSlot(right, defaultProps)
-    });
-    return resolved?.length ? resolved : null;
-  }, [config, path]);
-  useControlsRegistration(entries, options);
-  return useControlsLayout();
-}
-var emptySubscribe = () => () => {
-};
-function useControlsModel() {
-  const portalTarget = useSyncExternalStore(
-    emptySubscribe,
-    () => typeof document !== "undefined" ? document.body : null,
-    () => null
-  );
-  const layout = useControlsLayout();
-  const pathname = usePathname();
-  const entries = useRegistryEntries("controls");
-  const { left, right } = useMemo(
-    () => resolveControlsPairs(entries, pathname),
-    [entries, pathname]
-  );
-  const theme = useTheme(controlsTheme);
-  return { portalTarget, layout, left, right, theme };
-}
-function ControlsSide({
-  controls,
-  geometry,
-  side,
-  theme
-}) {
-  if (controls.length === 0 || !geometry.height || !geometry.maxWidth) {
-    return null;
-  }
-  const positionStyle = side === "left" ? {
-    bottom: geometry.bottom,
-    maxWidth: geometry.maxWidth,
-    right: geometry.right
-  } : {
-    bottom: geometry.bottom,
-    left: geometry.left,
-    maxWidth: geometry.maxWidth
-  };
-  return /* @__PURE__ */ jsx(
-    "aside",
-    {
-      "aria-label": `${side === "left" ? "Left" : "Right"} page controls`,
-      className: theme.slots.rail,
-      style: { ...theme.styles.rail, ...positionStyle },
-      children: /* @__PURE__ */ jsx(
-        "div",
-        {
-          "data-side": side,
-          className: theme.slots.stack,
-          style: {
-            ...theme.styles.stack,
-            "--controls-height": `${geometry.height}px`
-          },
-          children: controls.map(({ content, id }, index) => /* @__PURE__ */ jsx(Fragment, { children: content }, id || index))
-        }
-      )
-    }
-  );
-}
-function Controls() {
-  const { portalTarget, layout, left, right, theme } = useControlsModel();
-  if (!portalTarget || !layout || layout.isHidden || left.length === 0) {
-    return null;
-  }
-  return createPortal(
-    /* @__PURE__ */ jsxs(Fragment$1, { children: [
-      /* @__PURE__ */ jsx(
-        ControlsSide,
-        {
-          controls: left,
-          geometry: {
-            ...layout.left,
-            bottom: layout.bottom,
-            height: layout.height
-          },
-          side: "left",
-          theme
-        }
-      ),
-      /* @__PURE__ */ jsx(
-        ControlsSide,
-        {
-          controls: right,
-          geometry: {
-            ...layout.right,
-            bottom: layout.bottom,
-            height: layout.height
-          },
-          side: "right",
-          theme
-        }
-      )
-    ] }),
-    portalTarget
-  );
-}
-function selectPageControls(config) {
-  return normalizePageControls(config.controls);
-}
-function useControlsPage(_slice, page) {
-  return useMemo(
-    () => ({
-      set: (controls) => page.set({ controls })
-    }),
-    [page]
-  );
-}
-function defineControls(definition = {}) {
-  const { id = "controls", order = 0 } = definition;
-  return Object.freeze({
-    config: definition,
-    id,
-    order,
-    use: function useDefinedControls(props = {}, options = {}) {
-      return useControls(
-        {
-          ...definition,
-          defaultProps: { ...definition.defaultProps, ...props }
-        },
-        options
-      );
-    }
-  });
-}
-var controlsModule = defineModule({
-  id: "controls",
-  Overlay: Controls,
-  registry: {
-    keyPolicy: "named",
-    lifecycle: "immediate",
-    validate: validateControlEntry
-  },
-  page: {
-    select: selectPageControls,
-    entries: (entry, { pathname }) => {
-      const path = pathname || "/";
-      return [{ key: `${path}::${entry.id}`, value: { ...entry, path } }];
-    },
-    use: useControlsPage
-  }
-});
-
-export { CONTROLS_DOCK_ELEMENT_ID, CONTROLS_DOCK_GAP, CONTROLS_EDGE_INSET, CONTROL_SIDE_NAMES, Controls, ControlsSide, areLayoutsEqual, controlsModule, controlsTheme, defineControls, getControlsLayout, getDockElement, getDockStackElement, hasContent, isControlSide, measureLayout, normalizePageControls, resolveControlsPairs, resolveSlot, useControls, useControlsLayout, useControlsRegistration, validateControlEntry };
+export { CONTROLS_DOCK_ELEMENT_ID, CONTROLS_DOCK_GAP, CONTROLS_EDGE_INSET, CONTROL_SIDE_NAMES, Controls, ControlsSide, areLayoutsEqual, controlsModule, controlsTheme, defineControls, getControlsLayout, getDockElement, getDockStackElement, hasContent, isControlSide, measureLayout, normalizePageControls, resolveControlsPairs, resolveSlot, useControls, useControlsLayout, useControlsRegistration, validateControlEntry } from '../../chunk-4GMQKD6F.js';
+import '../../chunk-7TAVYJ3A.js';
+import '../../chunk-GF7TUX5I.js';
+import '../../chunk-TV3WEF5G.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map