@omerdlw/base-framework 1.0.3 → 1.0.5

package/dist/modules/dock/index.js

@@ -1,5 +1,5 @@
 "use client";
-import React, { createContext, memo, createElement, isValidElement, cloneElement, Suspense, useEffect, useState, useCallback, useMemo, use, useSyncExternalStore, useRef, useContext, useLayoutEffect, lazy, useId, useReducer, useInsertionEffect, Children } from 'react';
+import React, { createContext, memo, createElement, isValidElement, cloneElement, Suspense, useEffect, useState, useCallback, useMemo, use, useSyncExternalStore, useRef, useContext, useLayoutEffect, lazy, useId, useReducer, Children } from 'react';
 import { motion, AnimatePresence, useMotionValue, useSpring, useTransform, useDragControls, MotionConfig } from 'motion/react';
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
@@ -423,1585 +423,1392 @@ function Button({
   );
 }
 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"
-]);
-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/kernel/utils.ts
-function parseFiniteNumber(value) {
-  const parsed = Number(value);
-  return Number.isFinite(parsed) ? parsed : null;
+function isValidComponentType(type) {
+  if (typeof type === "function") return true;
+  return Boolean(
+    type != null && typeof type === "object" && !isValidElement(type) && "$$typeof" in type
+  );
 }
-function getValidString(value, fallback = null) {
-  return trimToNull(value) ?? fallback;
+function resolveComponentType(...candidates) {
+  return candidates.find(isValidComponentType) ?? null;
 }
-
-// src/kernel/schema.ts
-function resolveLifecycle(metadata, fallback) {
-  const lifecycle = metadata?.lifecycle ?? metadata?.cleanup;
-  return lifecycle && REGISTRY_LIFECYCLE_VALUES.has(lifecycle) ? lifecycle : fallback;
+function resolveRenderableContent(...candidates) {
+  return candidates.find(
+    (candidate) => candidate !== null && candidate !== void 0
+  ) ?? null;
 }
-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");
+function collectSearchableText(value, visitedObjects) {
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean") {
+    return String(value);
   }
-  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 (Array.isArray(value)) {
+    if (visitedObjects.has(value)) return "";
+    visitedObjects.add(value);
+    const text = value.map((entry) => collectSearchableText(entry, visitedObjects)).join(" ");
+    visitedObjects.delete(value);
+    return text;
   }
-  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(", ")}`
+  if (isValidElement(value)) {
+    if (visitedObjects.has(value)) return "";
+    visitedObjects.add(value);
+    const text = collectSearchableText(
+      value.props?.children,
+      visitedObjects
     );
+    visitedObjects.delete(value);
+    return text;
   }
-  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;
+  if (value && typeof value === "object") {
+    if (visitedObjects.has(value)) return "";
+    visitedObjects.add(value);
+    return Object.values(value).map((entry) => collectSearchableText(entry, visitedObjects)).join(" ");
   }
-  return {
-    cleanupDelayMs,
-    lifecycle,
-    priority,
-    registerOptions: {
-      ...priority !== null && { priority },
-      ...validation === REGISTRY_VALIDATION_MODES.STRICT && { validation },
-      ...scope && { scope }
-    },
-    source,
-    ...scope && { scope },
-    ...validation && { validation }
-  };
+  return "";
 }
-function isValidationMode(value) {
-  return Object.values(REGISTRY_VALIDATION_MODES).includes(value);
+function toSearchableText(value) {
+  return collectSearchableText(value, /* @__PURE__ */ new WeakSet());
 }
-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 normalizeUpper(value) {
+  return String(value || "").trim().toUpperCase();
 }
-function useRequiredContext(context, hookName, providerName) {
-  const value = use(context);
-  if (value === null) {
-    throw new Error(`${hookName} must be used within ${providerName}`);
-  }
-  return value;
+function formatMediaTime(seconds = 0) {
+  const sec = Math.max(0, Math.floor(Number(seconds) || 0));
+  const m = Math.floor(sec / 60);
+  const s = sec % 60;
+  return `${m}:${s < 10 ? "0" : ""}${s}`;
 }
-function useStore(store, selector = (state) => state, isEqual = Object.is) {
-  const cacheRef = useRef({
-    isEqual: null,
-    selected: void 0,
-    selector: null,
-    snapshot: null
+function isHudDescriptor(value) {
+  return isObject(value) && !isValidElement(value) && ("component" in value || "content" in value || "node" in value || "element" in value || "isActive" in value || "id" in value);
+}
+function createDockScheduler(options = {}) {
+  return createScheduler({
+    defaultLabel: "dock-task",
+    ...options
   });
-  const getSelectedSnapshot = useCallback(() => {
-    const snapshot = store.getSnapshot();
-    const cache = cacheRef.current;
-    if (cache.snapshot === snapshot && cache.selector === selector && cache.isEqual === isEqual) {
-      return cache.selected;
-    }
-    const selected = selector(snapshot);
-    if (cache.snapshot !== null && cache.isEqual === isEqual && isEqual(cache.selected, selected)) {
-      cache.snapshot = snapshot;
-      cache.selector = selector;
-      return cache.selected;
-    }
-    cacheRef.current = {
-      isEqual,
-      selected,
-      selector,
-      snapshot
-    };
-    return selected;
-  }, [isEqual, selector, store]);
-  return useSyncExternalStore(
-    store.subscribe,
-    getSelectedSnapshot,
-    getSelectedSnapshot
-  );
 }
-function useClickOutside(ref, callback) {
-  const handlePointer = useCallback(
-    (event) => {
-      if (ref?.current && !ref.current.contains(event.target)) {
-        callback?.(event);
-      }
-    },
-    [callback, ref]
+
+// src/modules/dock/paths.ts
+function isSamePath(left, right) {
+  const normalizedLeft = normalizePath(left);
+  const normalizedRight = normalizePath(right);
+  return Boolean(
+    normalizedLeft && normalizedRight && normalizedLeft === normalizedRight
   );
-  useEffect(() => {
-    document.addEventListener("pointerdown", handlePointer);
-    return () => document.removeEventListener("pointerdown", handlePointer);
-  }, [handlePointer]);
 }
-var useIsomorphicLayoutEffect = isBrowser ? useLayoutEffect : useEffect;
-
-// 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 listeners2 = this.events.get(event) || /* @__PURE__ */ new Set();
-    listeners2.add(callback);
-    this.events.set(event, listeners2);
-    return () => {
-      listeners2.delete(callback);
-      if (listeners2.size === 0) this.events.delete(event);
-    };
-  }
-  emit(event, payload) {
-    const listeners2 = this.events.get(event);
-    if (!listeners2 || listeners2.size === 0) return;
-    const snapshot = Array.from(listeners2);
-    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());
-
-// src/hooks/use-global-event.ts
-function useGlobalEvent(event, callback, options) {
-  const callbackRef = useRef(callback);
-  const debounceTimerRef = useRef(null);
-  useRef(0);
-  const throttleTimerRef = useRef(null);
-  useIsomorphicLayoutEffect(() => {
-    callbackRef.current = callback;
-  });
-  const debounceMs = options?.debounceMs;
-  const throttleMs = options?.throttleMs;
-  useEffect(() => {
-    if (!event) return;
-    const events = Array.isArray(event) ? event.filter(Boolean) : [event];
-    if (events.length === 0) return;
-    const handler = (payload) => {
-      callbackRef.current?.(payload);
-    };
-    const unsubs = events.map((ev) => globalEvents.subscribe(ev, handler));
-    return () => {
-      unsubs.forEach((unsub) => unsub());
-      if (debounceTimerRef.current !== null) {
-        clearTimeout(debounceTimerRef.current);
-        debounceTimerRef.current = null;
-      }
-      if (throttleTimerRef.current !== null) {
-        clearTimeout(throttleTimerRef.current);
-        throttleTimerRef.current = null;
-      }
-    };
-  }, [event, debounceMs, throttleMs]);
+function isPathPrefix(candidatePath, pathname) {
+  const normalizedCandidate = normalizePath(candidatePath);
+  const normalizedPathname = normalizePath(pathname);
+  if (!normalizedCandidate || !normalizedPathname) return false;
+  if (normalizedCandidate === normalizedPathname) return true;
+  if (normalizedCandidate === "/") return normalizedPathname.startsWith("/");
+  return normalizedPathname.startsWith(`${normalizedCandidate}/`);
 }
-var listeners = /* @__PURE__ */ new Set();
-var activeFullscreenStateIds = /* @__PURE__ */ new Set();
-var ACTIVE_FULLSCREEN_ROOT_SELECTOR = '[data-fullscreen-state-root="true"][data-affect-global-state="true"]';
-var domObserver = null;
-var lastSnapshot = false;
-function getDomSnapshot() {
-  if (typeof document === "undefined") {
-    return activeFullscreenStateIds.size > 0;
-  }
-  return document.querySelector(ACTIVE_FULLSCREEN_ROOT_SELECTOR) !== null;
+function isInlineActionPathMatch(path, pathname) {
+  return isSamePath(path, pathname) || path !== "/" && isPathPrefix(path, pathname);
 }
-function emitChange() {
-  listeners.forEach((listener) => listener());
+function isSafeInternalHref(value) {
+  const href = typeof value === "string" ? value.trim() : "";
+  return href.startsWith("/") && !href.startsWith("//");
 }
-function emitIfSnapshotChanged() {
-  const nextSnapshot = getDomSnapshot();
-  if (nextSnapshot === lastSnapshot) {
-    return;
-  }
-  lastSnapshot = nextSnapshot;
-  emitChange();
+function getDockLocationKey({
+  hash = "",
+  pathname = "/",
+  search = ""
+} = {}) {
+  const normalizedPathname = String(pathname || "/").trim() || "/";
+  const normalizedSearch = String(search || "").trim();
+  const normalizedHash = String(hash || "").trim();
+  const query = normalizedSearch ? normalizedSearch.startsWith("?") ? normalizedSearch : `?${normalizedSearch}` : "";
+  const fragment = normalizedHash ? normalizedHash.startsWith("#") ? normalizedHash : `#${normalizedHash}` : "";
+  return `${normalizedPathname}${query}${fragment}`;
 }
-function ensureDomObserver() {
-  if (typeof document === "undefined" || domObserver || listeners.size === 0) {
-    return;
-  }
-  domObserver = new MutationObserver(() => {
-    emitIfSnapshotChanged();
-  });
-  domObserver.observe(document.documentElement, {
-    attributes: true,
-    childList: true,
-    subtree: true,
-    attributeFilter: [
-      "data-fullscreen-state",
-      "data-fullscreen-state-root",
-      "data-affect-global-state"
-    ]
-  });
+
+// src/modules/dock/surface/helpers.ts
+function isSurfaceDescriptor(value) {
+  return value != null && typeof value === "object" && !Array.isArray(value) && !isValidElement(value);
 }
-function releaseDomObserver() {
-  if (listeners.size > 0 || !domObserver) {
-    return;
+var generatedExtensionId = 0;
+function normalizeSurfaceExtension(input) {
+  if (!input) return null;
+  if (isValidElement(input)) {
+    return {
+      align: "left",
+      className: "",
+      component: null,
+      content: input,
+      id: `ext-${++generatedExtensionId}`,
+      order: 0,
+      props: {},
+      unstyled: false
+    };
   }
-  domObserver.disconnect();
-  domObserver = null;
-}
-function subscribe(listener) {
-  listeners.add(listener);
-  ensureDomObserver();
-  emitIfSnapshotChanged();
-  return () => {
-    listeners.delete(listener);
-    releaseDomObserver();
+  if (typeof input !== "object") return null;
+  const extension = input;
+  const component = isValidComponentType(extension.component) ? extension.component : null;
+  const content = isValidElement(extension.content) || typeof extension.content === "string" || typeof extension.content === "number" ? extension.content : null;
+  if (!component && content == null) return null;
+  const align = extension.align === "right" || extension.align === "end" ? "right" : extension.align === "center" ? "center" : "left";
+  return {
+    align,
+    className: typeof extension.className === "string" ? extension.className : "",
+    component,
+    content,
+    id: String(
+      extension.id || extension.key || `ext-${++generatedExtensionId}`
+    ),
+    order: Number.isFinite(Number(extension.order)) ? Number(extension.order) : 0,
+    props: isPlainObject(extension.props) ? extension.props : {},
+    unstyled: Boolean(extension.unstyled)
   };
 }
-function getSnapshot() {
-  return getDomSnapshot();
+function normalizeSurfaceFlowSnapshot(value) {
+  if (!isPlainObject(value)) return null;
+  return { ...value };
 }
-function useIsFullscreenStateActive() {
-  return useSyncExternalStore(subscribe, getSnapshot, () => false);
+function createSurfaceReturnHandshake(input) {
+  const source = typeof input === "string" ? { pathname: input } : input;
+  const pathname = typeof source?.pathname === "string" ? source.pathname.trim() : "";
+  if (!isSafeInternalHref(pathname)) return null;
+  return {
+    focusKey: typeof source?.focusKey === "string" && source.focusKey.trim() ? source.focusKey.trim() : null,
+    pathname,
+    restoreScroll: source?.restoreScroll !== false,
+    returnOnCancel: source?.returnOnCancel === true
+  };
 }
-var RegistryContext = getOrCreateGlobalContext(
-  "RegistryContext",
-  null
-);
-function useRegistryActions() {
-  return useRequiredContext(
-    RegistryContext,
-    "useRegistryActions",
-    "RegistryProvider"
-  ).actions;
+function resolveSurfaceFlowReturnHandshake(definition, input) {
+  const flowInput = input && typeof input === "object" ? input : null;
+  const inputHandshake = flowInput?.returnHandshake ?? (flowInput?.returnTo ? {
+    focusKey: flowInput.returnFocusKey,
+    pathname: flowInput.returnTo,
+    restoreScroll: flowInput.restoreReturnScroll,
+    returnOnCancel: flowInput.returnOnCancel
+  } : null);
+  const baseHandshake = definition?.returnHandshake;
+  if (!baseHandshake && !inputHandshake) return null;
+  return createSurfaceReturnHandshake({ ...baseHandshake, ...inputHandshake });
 }
-function useRegistrySubscription() {
-  return useRequiredContext(
-    RegistryContext,
-    "useRegistrySubscription",
-    "RegistryProvider"
-  ).subscription;
+
+// src/modules/dock/surface/context.tsx
+var SurfaceExtensionsContext = createContext(null);
+var SurfaceItemContext = createContext({
+  id: null,
+  width: null
+});
+function useSurfaceDimensions() {
+  const { width } = use(SurfaceItemContext);
+  return useMemo(() => ({ width }), [width]);
 }
-function useRegistryEntries(type) {
-  const { getEntriesSnapshot, subscribe: subscribe2 } = useRegistrySubscription();
-  const subscribeToType = useCallback(
-    (listener) => subscribe2(type, null, listener),
-    [subscribe2, type]
-  );
-  const getEntries = useCallback(
-    () => getEntriesSnapshot(type),
-    [getEntriesSnapshot, type]
+function useSurfaceId() {
+  return use(SurfaceItemContext).id;
+}
+function useSurfaceHeader() {
+  const store = use(SurfaceExtensionsContext)?.headerActions ?? null;
+  const surfaceId = useSurfaceId();
+  return useCallback(
+    (patch) => {
+      if (!store) return;
+      const data = typeof patch === "function" ? patch({}) : patch;
+      if (data?.headerAction !== void 0)
+        store.setAction(surfaceId, data.headerAction);
+    },
+    [store, surfaceId]
   );
-  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 useSurfaceAction(action) {
+  const store = use(SurfaceExtensionsContext)?.headerActions ?? null;
+  const surfaceId = useSurfaceId();
+  useEffect(() => {
+    if (!store || action === void 0) return;
+    store.setAction(surfaceId, action);
+    return () => store.removeAction(surfaceId);
+  }, [store, surfaceId, action]);
 }
-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;
+var SurfaceHeaderActionStore = class {
+  store = createStore({
+    actionsBySurface: {},
+    version: 0
+  });
+  get version() {
+    return this.store.getSnapshot().version;
   }
-  if (!hasSlices) return null;
-  return {
-    ...payload,
-    registry: {
-      ...metadata,
-      ...isObject(config.registry) ? config.registry : {}
-    }
+  subscribe = (listener) => this.store.subscribe(listener);
+  getAction = (surfaceId) => {
+    const sId = surfaceId != null ? String(surfaceId) : "active";
+    const { actionsBySurface } = this.store.getSnapshot();
+    return actionsBySurface[sId] ?? actionsBySurface.active ?? actionsBySurface.global ?? null;
   };
-}
-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
+  setAction = (surfaceId, action) => {
+    const sId = surfaceId != null ? String(surfaceId) : "active";
+    const current = this.store.getSnapshot();
+    if (current.actionsBySurface[sId] === action) return;
+    this.store.setState({
+      actionsBySurface: {
+        ...current.actionsBySurface,
+        [sId]: action
+      },
+      version: current.version + 1
+    });
   };
-  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
+  removeAction = (surfaceId) => {
+    const sId = surfaceId != null ? String(surfaceId) : "active";
+    const current = this.store.getSnapshot();
+    if (!(sId in current.actionsBySurface)) return;
+    const { [sId]: _, ...nextActions } = current.actionsBySurface;
+    this.store.setState({
+      actionsBySurface: nextActions,
+      version: current.version + 1
     });
-    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;
+  };
+  clearSurface = (surfaceId) => this.removeAction(surfaceId);
+};
+var SurfaceExtensionsStore = class {
+  extensionsBySurface = /* @__PURE__ */ new Map();
+  cachedListBySurface = /* @__PURE__ */ new Map();
+  store = createStore({ version: 0 });
+  get version() {
+    return this.store.getSnapshot().version;
+  }
+  subscribe = (listener) => this.store.subscribe(listener);
+  notify = () => {
+    this.cachedListBySurface.clear();
+    this.store.setState((prev) => ({ version: prev.version + 1 }));
+  };
+  getExtensionsForSurface = (surfaceId) => {
+    const sId = surfaceId != null ? String(surfaceId) : "active";
+    if (this.cachedListBySurface.has(sId))
+      return this.cachedListBySurface.get(sId);
+    const globalExts = this.extensionsBySurface.get("global");
+    const activeExts = this.extensionsBySurface.get("active");
+    const surfaceExts = sId !== "global" && sId !== "active" ? this.extensionsBySurface.get(sId) : void 0;
+    let fallbackExts;
+    if (!globalExts && !activeExts && !surfaceExts && this.extensionsBySurface.size > 0) {
+      for (const map of this.extensionsBySurface.values()) {
+        if (map.size > 0) {
+          fallbackExts = map;
+          break;
+        }
       }
-      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 (!globalExts && !activeExts && !surfaceExts && !fallbackExts) {
+      const empty = [];
+      this.cachedListBySurface.set(sId, empty);
+      return empty;
     }
-  });
-  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);
-      }
+    const merged = new Map([
+      ...globalExts || [],
+      ...activeExts || [],
+      ...surfaceExts || [],
+      ...fallbackExts || []
+    ]);
+    const result = Array.from(merged.values()).sort(
+      (a, b) => a.order - b.order
     );
-  });
-  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)
-        )
-      );
-    });
+    this.cachedListBySurface.set(sId, result);
+    return result;
   };
-}
-
-// 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
+  setExtension = (surfaceId, extension) => {
+    if (!extension) return;
+    const normalized = normalizeSurfaceExtension(extension);
+    if (!normalized) return;
+    const sId = surfaceId != null ? String(surfaceId) : "active";
+    let surfaceMap = this.extensionsBySurface.get(sId);
+    if (!surfaceMap) {
+      surfaceMap = /* @__PURE__ */ new Map();
+      this.extensionsBySurface.set(sId, surfaceMap);
     }
+    const prev = surfaceMap.get(normalized.id);
+    if (prev && prev.content === normalized.content && prev.align === normalized.align && prev.order === normalized.order && prev.className === normalized.className && prev.unstyled === normalized.unstyled && prev.component === normalized.component && prev.props === normalized.props)
+      return;
+    surfaceMap.set(normalized.id, normalized);
+    this.notify();
   };
-}
-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);
+  removeExtension = (surfaceId, extensionId) => {
+    if (!extensionId) return;
+    const sId = surfaceId != null ? String(surfaceId) : "active";
+    let removed = false;
+    for (const [key, map] of this.extensionsBySurface.entries()) {
+      if (key === sId || key === "active" || key === "global") {
+        if (map.has(extensionId)) {
+          map.delete(extensionId);
+          if (map.size === 0) this.extensionsBySurface.delete(key);
+          removed = true;
+        }
+      }
     }
+    if (removed) this.notify();
   };
-  return entry;
-}
-function isDirectRegistryComponentPath(path, componentSlices) {
-  const match = /^config\.([^.[]+)\.[^.[]+$/.exec(path);
-  return Boolean(match && componentSlices.has(match[1]));
+  clearSurface = (surfaceId) => {
+    const sId = surfaceId != null ? String(surfaceId) : "active";
+    this.extensionsBySurface.delete(sId);
+    this.extensionsBySurface.delete("active");
+    this.notify();
+  };
+};
+
+// 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];
 }
-function isReactNodeLike(value) {
-  return value === null || value === void 0 || typeof value === "boolean" || typeof value === "string" || typeof value === "number" || isValidElement(value);
+
+// src/kernel/utils.ts
+function parseFiniteNumber(value) {
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : null;
 }
-function isStabilizableObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value) && !isValidElement(value);
+function getValidString(value, fallback = null) {
+  return trimToNull(value) ?? fallback;
 }
-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)
-  );
+
+// src/kernel/schema.ts
+function resolveLifecycle(metadata, fallback) {
+  const lifecycle = metadata?.lifecycle ?? metadata?.cleanup;
+  return lifecycle && REGISTRY_LIFECYCLE_VALUES.has(lifecycle) ? lifecycle : fallback;
 }
-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);
+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");
   }
-  if (isValidElement(value)) {
-    const nextProps = stabilizeRegistryValue(
-      value.props,
-      `${path}.props`,
-      scope,
-      isValidElement(previousValue) ? previousValue.props : void 0,
-      seen,
-      depth + 1
+  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 (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;
+  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(", ")}`
+    );
   }
-  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;
-    },
-    []
-  );
+  return { issues, valid: issues.length === 0 };
 }
-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)
-    )
-  });
+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 {
-    ...stamp(actions),
-    batch: (executor) => typeof executor === "function" ? actions.batch((queue) => executor(stamp(queue))) : 0,
-    cleanupScope,
-    instanceId,
-    modules,
-    pathname
+    cleanupDelayMs,
+    lifecycle,
+    priority,
+    registerOptions: {
+      ...priority !== null && { priority },
+      ...validation === REGISTRY_VALIDATION_MODES.STRICT && { validation },
+      ...scope && { scope }
+    },
+    source,
+    ...scope && { scope },
+    ...validation && { validation }
   };
 }
-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]
+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]]
+    )
   );
-  useAppliedRegistryConfig(payload, context, componentSlices);
 }
-function defineModule(coreModule) {
-  return Object.freeze({ ...coreModule });
+function useRequiredContext(context, hookName, providerName) {
+  const value = use(context);
+  if (value === null) {
+    throw new Error(`${hookName} must be used within ${providerName}`);
+  }
+  return value;
 }
-createStore(void 0);
-
-// src/kernel/adapters.ts
-function useModuleRegistration(id, value, options) {
-  const coreModule = useInstalledModules().find(
-    (candidate) => candidate.id === id
+function useStore(store, selector = (state) => state, isEqual = Object.is) {
+  const cacheRef = useRef({
+    isEqual: null,
+    selected: void 0,
+    selector: null,
+    snapshot: null
+  });
+  const getSelectedSnapshot = useCallback(() => {
+    const snapshot = store.getSnapshot();
+    const cache = cacheRef.current;
+    if (cache.snapshot === snapshot && cache.selector === selector && cache.isEqual === isEqual) {
+      return cache.selected;
+    }
+    const selected = selector(snapshot);
+    if (cache.snapshot !== null && cache.isEqual === isEqual && isEqual(cache.selected, selected)) {
+      cache.snapshot = snapshot;
+      cache.selector = selector;
+      return cache.selected;
+    }
+    cacheRef.current = {
+      isEqual,
+      selected,
+      selector,
+      snapshot
+    };
+    return selected;
+  }, [isEqual, selector, store]);
+  return useSyncExternalStore(
+    store.subscribe,
+    getSelectedSnapshot,
+    getSelectedSnapshot
   );
-  const config = coreModule && options?.enabled !== false && value != null ? { [id]: value } : null;
-  useRegistry(config, pickRegistryMetadata(options));
-}
-
-// 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 ?? {}
-  };
+function useClickOutside(ref, callback) {
+  const handlePointer = useCallback(
+    (event) => {
+      if (ref?.current && !ref.current.contains(event.target)) {
+        callback?.(event);
+      }
+    },
+    [callback, ref]
+  );
+  useEffect(() => {
+    document.addEventListener("pointerdown", handlePointer);
+    return () => document.removeEventListener("pointerdown", handlePointer);
+  }, [handlePointer]);
 }
+var useIsomorphicLayoutEffect = isBrowser ? useLayoutEffect : useEffect;
 
-// src/modules/dock/constants.ts
-var DOCK_STYLE_SECTIONS = Object.freeze([
-  "card",
-  "icon",
-  "title",
-  "description"
-]);
-var DOCK_EVENTS = Object.freeze({
-  NAVIGATE_START: "DOCK_NAVIGATE_START",
-  NAVIGATE_END: "DOCK_NAVIGATE_END",
-  UPDATE_BADGE: "DOCK_UPDATE_BADGE",
-  NAVIGATE: "DOCK_NAVIGATE",
-  GUARD: "DOCK_GUARD",
-  NOT_FOUND: "DOCK_NOT_FOUND",
-  STATUS_SET: "DOCK_STATUS_SET",
-  STATUS_CLEAR: "DOCK_STATUS_CLEAR"
-});
-var DOCK_HUD_RENDER_MODE = Object.freeze({
-  COMPONENT: "component",
-  NODE: "node"
-});
-var DOCK_HUD_VARIANT = Object.freeze({
-  EXPANDED: "expanded",
-  PROGRESS: "progress",
-  CUSTOM: "custom"
-});
-var DOCK_HUD_PRIORITY = Object.freeze({
-  TASK_PROGRESS: 30,
-  CONTEXTUAL: 10,
-  SELECTION: 20,
-  CRITICAL: 50,
-  DEFAULT: 0,
-  MEDIA: 15
-});
-var DOCK_ATTENTION_KIND = Object.freeze({
-  SURFACE: "surface",
-  OPERATION: "operation",
-  LOADING: "loading",
-  STATUS: "status",
-  ROUTE: "route",
-  HUD: "hud"
-});
-var DOCK_ATTENTION_PRIORITY = Object.freeze({
-  STATUS_OVERLAY: 300,
-  SURFACE: 400,
-  OPERATION: 250,
-  LOADING: 100,
-  STATUS: 75,
-  ROUTE: 0,
-  HUD: 200
-});
-var DOCK_ATTENTION_PRIORITY_OFFSET_MAX = 99;
-var DOCK_SURFACE_RENDER_MODE = Object.freeze({
-  COMPONENT: "component",
-  NODE: "node"
-});
-var DOCK_SURFACE_FLOW_STATUS = Object.freeze({
-  OPEN: "open",
-  COMPLETED: "completed",
-  CANCELLED: "cancelled"
-});
-var DOCK_SURFACE_PHASE = Object.freeze({
-  IDLE: "idle",
-  DISMISSING_ACTION: "dismissing_action",
-  EXPANDING_BODY: "expanding_body",
-  OPEN: "open",
-  CLOSING_ANTICIPATION: "closing_anticipation",
-  COLLAPSING_BODY: "collapsing_body",
-  RESTORING_HEADER: "restoring_header"
-});
-var VIEWPORT_MARGIN = 24;
-var DOCK_CARD_DIMENSIONS = Object.freeze({
-  expandedY: -72,
-  chromeHeight: 20,
-  collapsedY: -10,
-  extensionShelfY: -42,
-  extensionShelfScale: 0.94,
-  extensionShelfHeight: 45,
-  hudHeight: 52,
-  actionGap: 10,
-  height: 68
-});
-var DOCK_CARD_LAYOUT = Object.freeze({
-  collapsed: Object.freeze({
-    offsetY: DOCK_CARD_DIMENSIONS.collapsedY,
-    scale: 0.88
-  }),
-  expanded: Object.freeze({
-    offsetY: DOCK_CARD_DIMENSIONS.expandedY,
-    scale: 1
-  }),
-  extensionShelfY: DOCK_CARD_DIMENSIONS.extensionShelfY,
-  extensionShelfScale: DOCK_CARD_DIMENSIONS.extensionShelfScale,
-  extensionShelfHeight: DOCK_CARD_DIMENSIONS.extensionShelfHeight,
-  chromeHeight: DOCK_CARD_DIMENSIONS.chromeHeight,
-  hudHeight: DOCK_CARD_DIMENSIONS.hudHeight,
-  actionGap: DOCK_CARD_DIMENSIONS.actionGap,
-  baseHeight: DOCK_CARD_DIMENSIONS.height
-});
-var DOCK_TRANSACTION_EVENTS = Object.freeze({
-  START: "START",
-  COMPLETE: "COMPLETE",
-  CANCEL: "CANCEL",
-  FAIL: "FAIL",
-  TIME_OUT: "TIME_OUT"
-});
-var DOCK_TRANSACTION_STATUS = Object.freeze({
-  PENDING: "pending",
-  COMPLETED: "completed",
-  CANCELLED: "cancelled",
-  FAILED: "failed",
-  TIMED_OUT: "timed-out"
-});
-var DOCK_TRANSACTION_REASON = Object.freeze({
-  GUARD: "guard",
-  SUPERSEDED: "superseded",
-  TIME_OUT: "time-out"
-});
-var DOCK_TRANSACTION_TIMEOUT_MS = 15e3;
-var DOCK_PREFETCH_INTENT_DELAY_MS = 90;
-var DOCK_CONTINUITY_EVENTS = Object.freeze({
-  CLEAR: "CLEAR",
-  CONSUME_RETURN: "CONSUME_RETURN",
-  DELIVER_RETURN: "DELIVER_RETURN",
-  RECORD: "RECORD",
-  REMOVE: "REMOVE"
-});
-var DOCK_CONTINUITY_MAX_ENTRIES = 32;
-var DOCK_SURFACE_RETURN_MAX_ENTRIES = 16;
-var DOCK_OPERATION_EVENTS = Object.freeze({
-  CANCEL: "CANCEL",
-  CLEAR: "CLEAR",
-  COMPLETE: "COMPLETE",
-  START: "START",
-  UPDATE: "UPDATE"
-});
-var DOCK_OPERATION_STATUS = Object.freeze({
-  CANCELLED: "cancelled",
-  COMPLETED: "completed",
-  PENDING: "pending"
-});
-var DOCK_OPERATION_MAX_ENTRIES = 24;
-var DOCK_FOCUSABLE_SELECTOR = 'a[href],button:not([disabled]),input:not([disabled]),select:not([disabled]),textarea:not([disabled]),[tabindex]:not([tabindex="-1"])';
-var DOCK_FOCUS_RESTORE_BLOCKED_REASONS = Object.freeze([
-  "browser-back",
-  "dock",
-  "unmount"
-]);
-var DOCK_LIFECYCLE = Object.freeze({
-  CLOSING: "closing",
-  OPENING: "opening",
-  IDLE: "idle",
-  OPEN: "open"
-});
-var PLAYBACK_RATES = Object.freeze([1, 1.25, 1.5, 2]);
-var STATUS_PRIORITY = Object.freeze({
-  GUARD: 120,
-  ACCOUNT_DELETE: 115,
-  APP_ERROR: 100,
-  API_ERROR: 95,
-  NOT_FOUND: 97,
-  OFFLINE: 90,
-  LOGOUT: 110,
-  SIGNUP: 110,
-  LOGIN: 110,
-  ONLINE: 10
+// 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 ERROR_STATUS_TYPES = /* @__PURE__ */ new Set([
-  "GUARD",
-  "ACCOUNT_DELETE",
-  "APP_ERROR",
-  "API_ERROR",
-  "NOT_FOUND"
-]);
-var OVERLAY_STATUS_STORAGE_KEY = "dock_overlay_status";
-var OVERLAY_STATUS_CLEAR_DURATION = 3e3;
-var STATUS_CLEAR_DURATION = 4500;
-var API_ERROR_BATCH_DELAY = 300;
-var DOCK_HEIGHT_BUFFER = 16;
-var HEIGHT_EPSILON = 0.5;
-var MAX_VISIBLE_STACKED_CARDS = 3;
-var dockTheme = defineThemeSpec("dock");
-
-// src/modules/dock/utils.ts
-function isSamePath(left, right) {
-  const normalizedLeft = normalizePath(left);
-  const normalizedRight = normalizePath(right);
-  return Boolean(
-    normalizedLeft && normalizedRight && normalizedLeft === normalizedRight
-  );
-}
-function isPathPrefix(candidatePath, pathname) {
-  const normalizedCandidate = normalizePath(candidatePath);
-  const normalizedPathname = normalizePath(pathname);
-  if (!normalizedCandidate || !normalizedPathname) return false;
-  if (normalizedCandidate === normalizedPathname) return true;
-  if (normalizedCandidate === "/") return normalizedPathname.startsWith("/");
-  return normalizedPathname.startsWith(`${normalizedCandidate}/`);
-}
-function isInlineActionPathMatch(path, pathname) {
-  return isSamePath(path, pathname) || path !== "/" && isPathPrefix(path, pathname);
-}
-function isSafeInternalHref(value) {
-  const href = typeof value === "string" ? value.trim() : "";
-  return href.startsWith("/") && !href.startsWith("//");
-}
-function getDockLocationKey({
-  hash = "",
-  pathname = "/",
-  search = ""
-} = {}) {
-  const normalizedPathname = String(pathname || "/").trim() || "/";
-  const normalizedSearch = String(search || "").trim();
-  const normalizedHash = String(hash || "").trim();
-  const query = normalizedSearch ? normalizedSearch.startsWith("?") ? normalizedSearch : `?${normalizedSearch}` : "";
-  const fragment = normalizedHash ? normalizedHash.startsWith("#") ? normalizedHash : `#${normalizedHash}` : "";
-  return `${normalizedPathname}${query}${fragment}`;
-}
-function formatMediaTime(seconds = 0) {
-  const sec = Math.max(0, Math.floor(Number(seconds) || 0));
-  const m = Math.floor(sec / 60);
-  const s = sec % 60;
-  return `${m}:${s < 10 ? "0" : ""}${s}`;
-}
-function isValidBannerUrl(banner) {
-  const value = trimToNull(banner);
-  if (!value) return false;
-  return /^(https?:\/\/|\/|data:image\/)/.test(value);
-}
-function toObject(value) {
-  return isObject(value) ? value : {};
-}
-function isValidComponentType(type) {
-  if (typeof type === "function") return true;
-  return Boolean(
-    type != null && typeof type === "object" && !isValidElement(type) && "$$typeof" in type
-  );
-}
-function resolveComponentType(...candidates) {
-  return candidates.find(isValidComponentType) ?? null;
-}
-function resolveRenderableContent(...candidates) {
-  return candidates.find(
-    (candidate) => candidate !== null && candidate !== void 0
-  ) ?? null;
-}
-function collectSearchableText(value, visitedObjects) {
-  if (typeof value === "string") return value;
-  if (typeof value === "number" || typeof value === "boolean")
-    return String(value);
-  if (Array.isArray(value)) {
-    if (visitedObjects.has(value)) return "";
-    visitedObjects.add(value);
-    const text = value.map((entry) => collectSearchableText(entry, visitedObjects)).join(" ");
-    visitedObjects.delete(value);
-    return text;
+var EventEmitter = class {
+  events = /* @__PURE__ */ new Map();
+  debounceTimers = /* @__PURE__ */ new Map();
+  subscribe(event, callback) {
+    if (typeof event !== "string" || !event || typeof callback !== "function") {
+      return () => {
+      };
+    }
+    const listeners2 = this.events.get(event) || /* @__PURE__ */ new Set();
+    listeners2.add(callback);
+    this.events.set(event, listeners2);
+    return () => {
+      listeners2.delete(callback);
+      if (listeners2.size === 0) this.events.delete(event);
+    };
   }
-  if (isValidElement(value)) {
-    if (visitedObjects.has(value)) return "";
-    visitedObjects.add(value);
-    const text = collectSearchableText(
-      value.props?.children,
-      visitedObjects
-    );
-    visitedObjects.delete(value);
-    return text;
+  emit(event, payload) {
+    const listeners2 = this.events.get(event);
+    if (!listeners2 || listeners2.size === 0) return;
+    const snapshot = Array.from(listeners2);
+    for (const callback of snapshot) {
+      try {
+        callback(payload);
+      } catch (error) {
+        report(`Event listener (${String(event)})`, error);
+      }
+    }
   }
-  if (value && typeof value === "object") {
-    if (visitedObjects.has(value)) return "";
-    visitedObjects.add(value);
-    return Object.values(value).map((entry) => collectSearchableText(entry, visitedObjects)).join(" ");
+  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);
   }
-  return "";
+  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());
+
+// src/hooks/use-global-event.ts
+function useGlobalEvent(event, callback, options) {
+  const callbackRef = useRef(callback);
+  const debounceTimerRef = useRef(null);
+  useRef(0);
+  const throttleTimerRef = useRef(null);
+  useIsomorphicLayoutEffect(() => {
+    callbackRef.current = callback;
+  });
+  const debounceMs = options?.debounceMs;
+  const throttleMs = options?.throttleMs;
+  useEffect(() => {
+    if (!event) return;
+    const events = Array.isArray(event) ? event.filter(Boolean) : [event];
+    if (events.length === 0) return;
+    const handler = (payload) => {
+      callbackRef.current?.(payload);
+    };
+    const unsubs = events.map((ev) => globalEvents.subscribe(ev, handler));
+    return () => {
+      unsubs.forEach((unsub) => unsub());
+      if (debounceTimerRef.current !== null) {
+        clearTimeout(debounceTimerRef.current);
+        debounceTimerRef.current = null;
+      }
+      if (throttleTimerRef.current !== null) {
+        clearTimeout(throttleTimerRef.current);
+        throttleTimerRef.current = null;
+      }
+    };
+  }, [event, debounceMs, throttleMs]);
 }
-function toSearchableText(value) {
-  return collectSearchableText(value, /* @__PURE__ */ new WeakSet());
+var listeners = /* @__PURE__ */ new Set();
+var activeFullscreenStateIds = /* @__PURE__ */ new Set();
+var ACTIVE_FULLSCREEN_ROOT_SELECTOR = '[data-fullscreen-state-root="true"][data-affect-global-state="true"]';
+var domObserver = null;
+var lastSnapshot = false;
+function getDomSnapshot() {
+  if (typeof document === "undefined") {
+    return activeFullscreenStateIds.size > 0;
+  }
+  return document.querySelector(ACTIVE_FULLSCREEN_ROOT_SELECTOR) !== null;
 }
-function normalizeUpper(value) {
-  return String(value || "").trim().toUpperCase();
+function emitChange() {
+  listeners.forEach((listener) => listener());
 }
-function splitStyle(style = {}) {
-  const { className, ...inlineStyle } = style;
-  return {
-    className,
-    inlineStyle
-  };
+function emitIfSnapshotChanged() {
+  const nextSnapshot = getDomSnapshot();
+  if (nextSnapshot === lastSnapshot) {
+    return;
+  }
+  lastSnapshot = nextSnapshot;
+  emitChange();
 }
-function getLineClampStyle(maxLines, style) {
-  if (Number(maxLines) <= 1) return style;
-  return {
-    WebkitBoxOrient: "vertical",
-    WebkitLineClamp: maxLines,
-    display: "-webkit-box",
-    overflow: "hidden",
-    ...style
-  };
+function ensureDomObserver() {
+  if (typeof document === "undefined" || domObserver || listeners.size === 0) {
+    return;
+  }
+  domObserver = new MutationObserver(() => {
+    emitIfSnapshotChanged();
+  });
+  domObserver.observe(document.documentElement, {
+    attributes: true,
+    childList: true,
+    subtree: true,
+    attributeFilter: [
+      "data-fullscreen-state",
+      "data-fullscreen-state-root",
+      "data-affect-global-state"
+    ]
+  });
 }
-function getImageIconStyle(style, icon) {
-  const nextStyle = {
-    ...style
-  };
-  delete nextStyle.background;
-  delete nextStyle.backgroundImage;
-  return {
-    ...nextStyle,
-    backgroundImage: `url(${icon})`
-  };
+function releaseDomObserver() {
+  if (listeners.size > 0 || !domObserver) {
+    return;
+  }
+  domObserver.disconnect();
+  domObserver = null;
 }
-function resolveDockActionClass(slots, {
-  className = "",
-  button = "",
-  isActive = false,
-  variant = "",
-  tone = "",
-  base,
-  cn: classNamesFn
-} = {}) {
-  const resolve = classNamesFn || cn;
-  const toneClasses = {
-    muted: slots.actionMuted,
-    active: slots.actionActive
+function subscribe(listener) {
+  listeners.add(listener);
+  ensureDomObserver();
+  emitIfSnapshotChanged();
+  return () => {
+    listeners.delete(listener);
+    releaseDomObserver();
   };
-  if (button && !className && base === void 0) {
-    if (tone) {
-      const toneClass = toneClasses[tone] || slots.actionSurface || slots.actionMuted;
-      return resolve(button, toneClass);
-    }
-    const stateToken = isActive ? slots.actionActive : slots.actionMuted;
-    return resolve(button, stateToken);
-  }
-  const elementClass = className || button;
-  const resolvedBase = base !== void 0 ? base : slots.action;
-  const stateClass = variant || tone && (toneClasses[tone] || slots.actionSurface) || (isActive ? slots.actionActive : slots.actionMuted);
-  return resolve(stateClass, resolvedBase, elementClass);
 }
-function blurActiveElement() {
-  if (typeof document === "undefined") return;
-  const activeElement = document.activeElement;
-  if (activeElement && typeof activeElement.blur === "function") {
-    activeElement.blur();
-  }
+function getSnapshot() {
+  return getDomSnapshot();
 }
-function closestMatches(target, selector) {
-  const element = target;
-  return Boolean(
-    element && typeof element.closest === "function" && element.closest(selector)
-  );
+function useIsFullscreenStateActive() {
+  return useSyncExternalStore(subscribe, getSnapshot, () => false);
 }
-function isInteractiveTarget(target) {
-  return closestMatches(
-    target,
-    'button, a, input, textarea, select, [role="button"], [tabindex]:not([tabindex="-1"])'
-  );
+var RegistryContext = getOrCreateGlobalContext(
+  "RegistryContext",
+  null
+);
+function useRegistryActions() {
+  return useRequiredContext(
+    RegistryContext,
+    "useRegistryActions",
+    "RegistryProvider"
+  ).actions;
 }
-function isEditableDockTarget(target) {
-  return closestMatches(
-    target,
-    'input, textarea, select, [contenteditable="true"]'
-  );
+function useRegistrySubscription() {
+  return useRequiredContext(
+    RegistryContext,
+    "useRegistrySubscription",
+    "RegistryProvider"
+  ).subscription;
 }
-function getDockFocusableElements(container) {
-  if (!container || typeof container.querySelectorAll !== "function") return [];
-  return Array.from(
-    container.querySelectorAll(DOCK_FOCUSABLE_SELECTOR)
-  ).filter((element) => {
-    if (!element || element.getAttribute("aria-hidden") === "true")
-      return false;
-    const style = typeof window !== "undefined" ? window.getComputedStyle(element) : null;
-    return style?.display !== "none" && style?.visibility !== "hidden" && style?.pointerEvents !== "none";
-  });
+function useRegistryEntries(type) {
+  const { getEntriesSnapshot, subscribe: subscribe2 } = useRegistrySubscription();
+  const subscribeToType = useCallback(
+    (listener) => subscribe2(type, null, listener),
+    [subscribe2, type]
+  );
+  const getEntries = useCallback(
+    () => getEntriesSnapshot(type),
+    [getEntriesSnapshot, type]
+  );
+  return useSyncExternalStore(subscribeToType, getEntries, getEntries);
 }
-function focusDockElement(element) {
-  if (!element || typeof element.focus !== "function") return false;
-  try {
-    element.focus({ preventScroll: true });
-    return document.activeElement === element;
-  } catch {
-    return false;
+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 shouldRestoreDockFocus(result) {
-  const blockedReason = result?.blockedReason;
-  return !result || !DOCK_FOCUS_RESTORE_BLOCKED_REASONS.includes(
-    blockedReason
-  );
+function useInstalledModules() {
+  return use(ModuleHostContext)?.modules ?? EMPTY_MODULES;
 }
-function isSameDockItem(item, candidate) {
-  return Boolean(
-    item?.path && item.path === candidate?.path || item?.name && item.name === candidate?.name
-  );
+
+// src/kernel/handlers.ts
+function isPersistentLifecycle(lifecycle) {
+  return lifecycle === REGISTRY_LIFECYCLES.PERSISTENT;
 }
-var isSameItem = isSameDockItem;
-function getItemKey(link, index = 0) {
-  const identity = link?.id ?? link?.path ?? link?.name ?? link?.type;
-  return `dock-card:${identity == null ? `slot-${index}` : String(identity)}`;
+function runRegistrationBatch(context, executor) {
+  return typeof context.batch === "function" ? context.batch(executor) : executor(context);
 }
-function getItemMeasurementKey({
-  link,
-  expanded,
-  isHud = false
-}) {
-  const state = isHud ? "hud" : link.isLoading ? "loading" : link.isSurface ? `surface-${link.surfacePhase ?? "open"}` : "standard";
-  return `${link.path || link.name || "item"}:${state}:${expanded ? "expanded" : "collapsed"}`;
+function createEntryCleanupKey(type, key, source, instanceId, scope) {
+  return JSON.stringify([
+    "entry",
+    type,
+    key,
+    scope ?? null,
+    source,
+    instanceId
+  ]);
 }
-function getRouteMeasurementKey(pathname, key) {
-  return `${pathname || ""}:${key}`;
+function getCleanupScope(context) {
+  return context?.cleanupScope || /* @__PURE__ */ new Map();
 }
-function resolveDockHeaderKey({
-  link,
-  description = "",
-  showVideoIcon = false
-}) {
-  const statusPart = link?.isStatus ? `status:${link.statusType || link.type || "status"}` : "standard";
-  const identityPart = link?.path || link?.name || link?.id || "item";
-  const titlePart = link?.title || link?.name || "";
-  const descPart = description || "";
-  const iconPart = showVideoIcon ? "video" : link?.icon || "no-icon";
-  return `${statusPart}:${identityPart}:${iconPart}:${titlePart}:${descPart}`;
+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 findDockItemIndex(dockItems, activeItem, pathname) {
-  const normalizedPathname = normalizePath(pathname);
-  const selectedDataSourceIndex = dockItems.findIndex(
-    (item) => item.isDataSource && item.isSelected
-  );
-  if (selectedDataSourceIndex !== -1) return selectedDataSourceIndex;
-  if (activeItem) {
-    const matchedActiveIndex = dockItems.findIndex(
-      (item) => item.path && isSamePath(item.path, activeItem.path) || item.name && item.name === activeItem.name
-    );
-    if (matchedActiveIndex !== -1) return matchedActiveIndex;
-  }
-  return dockItems.findIndex(
-    (item) => isSamePath(item.path, normalizedPathname) || item.targetPath && isSamePath(item.targetPath, normalizedPathname)
-  );
+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 resolveActiveIndex({
-  dockItems,
-  activeItem,
-  pathname
-}) {
-  return Math.max(0, findDockItemIndex(dockItems, activeItem, pathname));
+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;
 }
-function shouldKeepAncestorItem(item, activePath) {
-  const policy = item?.keepWhenDescendant;
-  if (typeof policy === "function") {
+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 Boolean(policy(activePath, item));
-    } catch {
-      return false;
+      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 policy === true;
+  return {
+    optionsArg: void 0,
+    sourceOrOptions: {
+      ...isObject(optionsArg) ? optionsArg : {},
+      instanceId
+    }
+  };
 }
-function isAncestorPath(item, activePath) {
-  const candidatePath = item?.path;
-  if (!candidatePath || candidatePath === "/" || candidatePath === activePath)
-    return false;
-  return isPathPrefix(candidatePath, activePath) && !shouldKeepAncestorItem(item, activePath);
+function withInstanceIdForUnregister(instanceId, sourceOrOptions) {
+  if (typeof sourceOrOptions === "string") {
+    return { instanceId, source: sourceOrOptions };
+  }
+  if (isObject(sourceOrOptions)) {
+    return { ...sourceOrOptions, instanceId };
+  }
+  return { instanceId };
 }
-function removeAncestorDuplicates(items = []) {
-  if (!Array.isArray(items) || items.length <= 1) return items;
-  const activePath = items[0]?.path;
-  if (!activePath) return items;
-  return items.filter(
-    (item, index) => index === 0 || !isAncestorPath(item, activePath)
-  );
+function resolveRegisterArgsWithInstance(instanceId, sourceOrOptions, optionsArg) {
+  const input = withInstanceId(instanceId, sourceOrOptions, optionsArg);
+  return [input.sourceOrOptions, input.optionsArg];
 }
-function replaceActiveItem(items, activeIndex, activeItem) {
-  if (activeIndex === -1 || !activeItem) return items;
-  const nextItems = [...items];
-  nextItems[activeIndex] = activeItem;
-  return nextItems;
+var MAX_STABILIZATION_DEPTH = 64;
+function createStableFunctionEntry(fn) {
+  const entry = {
+    current: fn,
+    stable(...args) {
+      return entry.current?.apply(this, args);
+    }
+  };
+  return entry;
 }
-function removeInactiveLoadingItems(items = [], activeItem = null) {
-  if (!Array.isArray(items) || items.length === 0) return items;
-  return items.filter(
-    (item) => !item?.isLoading || isSameItem(item, activeItem)
-  );
+function isDirectRegistryComponentPath(path, componentSlices) {
+  const match = /^config\.([^.[]+)\.[^.[]+$/.exec(path);
+  return Boolean(match && componentSlices.has(match[1]));
 }
-function reorderItemsWithActiveFirst(items, activeIndex) {
-  if (activeIndex === -1) return items;
-  const active = items[activeIndex];
-  const rest = [
-    ...items.slice(0, activeIndex),
-    ...items.slice(activeIndex + 1)
-  ];
-  rest.sort((a, b) => a.path === "/" ? 1 : b.path === "/" ? -1 : 0);
-  return [active, ...rest];
+function isReactNodeLike(value) {
+  return value === null || value === void 0 || typeof value === "boolean" || typeof value === "string" || typeof value === "number" || isValidElement(value);
 }
-function isHudDescriptor(value) {
-  return isObject(value) && !isValidElement(value) && ("component" in value || "content" in value || "node" in value || "element" in value || "isActive" in value || "id" in value);
+function isStabilizableObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) && !isValidElement(value);
 }
-function isSurfaceDescriptor(value) {
-  return value != null && typeof value === "object" && !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)
+  );
 }
-var generatedExtensionId = 0;
-function normalizeSurfaceExtension(input) {
-  if (!input) return null;
-  if (isValidElement(input)) {
-    return {
-      align: "left",
-      className: "",
-      component: null,
-      content: input,
-      id: `ext-${++generatedExtensionId}`,
-      order: 0,
-      props: {},
-      unstyled: false
-    };
+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 (typeof input !== "object") return null;
-  const extension = input;
-  const component = isValidComponentType(extension.component) ? extension.component : null;
-  const content = isValidElement(extension.content) || typeof extension.content === "string" || typeof extension.content === "number" ? extension.content : null;
-  if (!component && content == null) return null;
-  const align = extension.align === "right" || extension.align === "end" ? "right" : extension.align === "center" ? "center" : "left";
-  return {
-    align,
-    className: typeof extension.className === "string" ? extension.className : "",
-    component,
-    content,
-    id: String(
-      extension.id || extension.key || `ext-${++generatedExtensionId}`
-    ),
-    order: Number.isFinite(Number(extension.order)) ? Number(extension.order) : 0,
-    props: isPlainObject(extension.props) ? extension.props : {},
-    unstyled: Boolean(extension.unstyled)
-  };
+  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 normalizeSurfaceFlowSnapshot(value) {
-  if (!isPlainObject(value)) return null;
-  return { ...value };
+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 createSurfaceReturnHandshake(input) {
-  const source = typeof input === "string" ? { pathname: input } : input;
-  const pathname = typeof source?.pathname === "string" ? source.pathname.trim() : "";
-  if (!isSafeInternalHref(pathname)) return 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 {
-    focusKey: typeof source?.focusKey === "string" && source.focusKey.trim() ? source.focusKey.trim() : null,
-    pathname,
-    restoreScroll: source?.restoreScroll !== false,
-    returnOnCancel: source?.returnOnCancel === true
+    ...stamp(actions),
+    batch: (executor) => typeof executor === "function" ? actions.batch((queue) => executor(stamp(queue))) : 0,
+    cleanupScope,
+    instanceId,
+    modules,
+    pathname
   };
 }
-function resolveSurfaceFlowReturnHandshake(definition, input) {
-  const flowInput = input && typeof input === "object" ? input : null;
-  const inputHandshake = flowInput?.returnHandshake ?? (flowInput?.returnTo ? {
-    focusKey: flowInput.returnFocusKey,
-    pathname: flowInput.returnTo,
-    restoreScroll: flowInput.restoreReturnScroll,
-    returnOnCancel: flowInput.returnOnCancel
-  } : null);
-  const baseHandshake = definition?.returnHandshake;
-  if (!baseHandshake && !inputHandshake) return null;
-  return createSurfaceReturnHandshake({ ...baseHandshake, ...inputHandshake });
+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 createDockScheduler(options = {}) {
-  return createScheduler({
-    defaultLabel: "dock-task",
-    ...options
-  });
+function defineModule(coreModule) {
+  return Object.freeze({ ...coreModule });
 }
+createStore(void 0);
 
-// src/modules/dock/surface/context.tsx
-var SurfaceExtensionsContext = createContext(null);
-var SurfaceItemContext = createContext({
-  id: null,
-  width: null
-});
-function useSurfaceDimensions() {
-  const { width } = use(SurfaceItemContext);
-  return useMemo(() => ({ width }), [width]);
-}
-function useSurfaceId() {
-  return use(SurfaceItemContext).id;
-}
-function useSurfaceHeader() {
-  const store = use(SurfaceExtensionsContext)?.headerActions ?? null;
-  const surfaceId = useSurfaceId();
-  return useCallback(
-    (patch) => {
-      if (!store) return;
-      const data = typeof patch === "function" ? patch({}) : patch;
-      if (data?.headerAction !== void 0)
-        store.setAction(surfaceId, data.headerAction);
-    },
-    [store, surfaceId]
+// 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 useSurfaceAction(action) {
-  const store = use(SurfaceExtensionsContext)?.headerActions ?? null;
-  const surfaceId = useSurfaceId();
-  useEffect(() => {
-    if (!store || action === void 0) return;
-    store.setAction(surfaceId, action);
-    return () => store.removeAction(surfaceId);
-  }, [store, surfaceId, action]);
+
+// src/theme.tsx
+function defineThemeSpec(id) {
+  return Object.freeze({ id });
 }
-var SurfaceHeaderActionStore = class {
-  store = createStore({
-    actionsBySurface: {},
-    version: 0
-  });
-  get version() {
-    return this.store.getSnapshot().version;
-  }
-  subscribe = (listener) => this.store.subscribe(listener);
-  getAction = (surfaceId) => {
-    const sId = surfaceId != null ? String(surfaceId) : "global";
-    const { actionsBySurface } = this.store.getSnapshot();
-    return actionsBySurface[sId] ?? actionsBySurface.global ?? null;
-  };
-  setAction = (surfaceId, action) => {
-    const sId = surfaceId != null ? String(surfaceId) : "global";
-    const current = this.store.getSnapshot();
-    if (current.actionsBySurface[sId] === action) return;
-    this.store.setState({
-      actionsBySurface: {
-        ...current.actionsBySurface,
-        [sId]: action
-      },
-      version: current.version + 1
-    });
-  };
-  removeAction = (surfaceId) => {
-    const sId = surfaceId != null ? String(surfaceId) : "global";
-    const current = this.store.getSnapshot();
-    if (!(sId in current.actionsBySurface)) return;
-    const { [sId]: _, ...nextActions } = current.actionsBySurface;
-    this.store.setState({
-      actionsBySurface: nextActions,
-      version: current.version + 1
-    });
-  };
-  clearSurface = (surfaceId) => this.removeAction(surfaceId);
-};
-var SurfaceExtensionsStore = class {
-  extensionsBySurface = /* @__PURE__ */ new Map();
-  cachedListBySurface = /* @__PURE__ */ new Map();
-  store = createStore({ version: 0 });
-  get version() {
-    return this.store.getSnapshot().version;
-  }
-  subscribe = (listener) => this.store.subscribe(listener);
-  notify = () => {
-    this.cachedListBySurface.clear();
-    this.store.setState((prev) => ({ version: prev.version + 1 }));
-  };
-  getExtensionsForSurface = (surfaceId) => {
-    const sId = surfaceId != null ? String(surfaceId) : "global";
-    if (this.cachedListBySurface.has(sId))
-      return this.cachedListBySurface.get(sId);
-    const globalExts = this.extensionsBySurface.get("global");
-    const surfaceExts = this.extensionsBySurface.get(sId);
-    if (!globalExts && !surfaceExts) {
-      const empty = [];
-      this.cachedListBySurface.set(sId, empty);
-      return empty;
-    }
-    const merged = new Map([...globalExts || [], ...surfaceExts || []]);
-    const result = Array.from(merged.values()).sort(
-      (a, b) => a.order - b.order
+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).`
     );
-    this.cachedListBySurface.set(sId, result);
-    return result;
-  };
-  setExtension = (surfaceId, extension) => {
-    if (!extension) return;
-    const normalized = normalizeSurfaceExtension(extension);
-    if (!normalized) return;
-    const sId = surfaceId != null ? String(surfaceId) : "global";
-    let surfaceMap = this.extensionsBySurface.get(sId);
-    if (!surfaceMap) {
-      surfaceMap = /* @__PURE__ */ new Map();
-      this.extensionsBySurface.set(sId, surfaceMap);
-    }
-    const prev = surfaceMap.get(normalized.id);
-    if (prev && prev.content === normalized.content && prev.align === normalized.align && prev.order === normalized.order && prev.className === normalized.className && prev.unstyled === normalized.unstyled && prev.component === normalized.component && prev.props === normalized.props)
-      return;
-    surfaceMap.set(normalized.id, normalized);
-    this.notify();
-  };
-  removeExtension = (surfaceId, extensionId) => {
-    if (!extensionId) return;
-    const sId = surfaceId != null ? String(surfaceId) : "global";
-    const surfaceMap = this.extensionsBySurface.get(sId);
-    if (!surfaceMap || !surfaceMap.has(extensionId)) return;
-    surfaceMap.delete(extensionId);
-    if (surfaceMap.size === 0) this.extensionsBySurface.delete(sId);
-    this.notify();
-  };
-  clearSurface = (surfaceId) => {
-    const sId = surfaceId != null ? String(surfaceId) : "global";
-    if (!this.extensionsBySurface.has(sId)) return;
-    this.extensionsBySurface.delete(sId);
-    this.notify();
+  }
+  return {
+    slots: config.slots,
+    styles: config.styles ?? {}
   };
-};
+}
+
+// src/modules/dock/constants.ts
+var DOCK_STYLE_SECTIONS = Object.freeze([
+  "card",
+  "icon",
+  "title",
+  "description"
+]);
+var DOCK_EVENTS = Object.freeze({
+  NAVIGATE_START: "DOCK_NAVIGATE_START",
+  NAVIGATE_END: "DOCK_NAVIGATE_END",
+  UPDATE_BADGE: "DOCK_UPDATE_BADGE",
+  NAVIGATE: "DOCK_NAVIGATE",
+  GUARD: "DOCK_GUARD",
+  NOT_FOUND: "DOCK_NOT_FOUND",
+  STATUS_SET: "DOCK_STATUS_SET",
+  STATUS_CLEAR: "DOCK_STATUS_CLEAR"
+});
+var DOCK_HUD_RENDER_MODE = Object.freeze({
+  COMPONENT: "component",
+  NODE: "node"
+});
+var DOCK_HUD_VARIANT = Object.freeze({
+  EXPANDED: "expanded",
+  PROGRESS: "progress",
+  CUSTOM: "custom"
+});
+var DOCK_HUD_PRIORITY = Object.freeze({
+  TASK_PROGRESS: 30,
+  CONTEXTUAL: 10,
+  SELECTION: 20,
+  CRITICAL: 50,
+  DEFAULT: 0,
+  MEDIA: 15
+});
+var DOCK_ATTENTION_KIND = Object.freeze({
+  SURFACE: "surface",
+  OPERATION: "operation",
+  LOADING: "loading",
+  STATUS: "status",
+  ROUTE: "route",
+  HUD: "hud"
+});
+var DOCK_ATTENTION_PRIORITY = Object.freeze({
+  STATUS_OVERLAY: 300,
+  SURFACE: 400,
+  OPERATION: 250,
+  LOADING: 100,
+  STATUS: 75,
+  ROUTE: 0,
+  HUD: 200
+});
+var DOCK_ATTENTION_PRIORITY_OFFSET_MAX = 99;
+var DOCK_SURFACE_RENDER_MODE = Object.freeze({
+  COMPONENT: "component",
+  NODE: "node"
+});
+var DOCK_SURFACE_FLOW_STATUS = Object.freeze({
+  OPEN: "open",
+  COMPLETED: "completed",
+  CANCELLED: "cancelled"
+});
+var DOCK_SURFACE_PHASE = Object.freeze({
+  IDLE: "idle",
+  DISMISSING_ACTION: "dismissing_action",
+  EXPANDING_BODY: "expanding_body",
+  OPEN: "open",
+  CLOSING_ANTICIPATION: "closing_anticipation",
+  COLLAPSING_BODY: "collapsing_body",
+  RESTORING_HEADER: "restoring_header"
+});
+var VIEWPORT_MARGIN = 24;
+var DOCK_CARD_DIMENSIONS = Object.freeze({
+  expandedY: -72,
+  chromeHeight: 20,
+  collapsedY: -10,
+  extensionShelfY: -42,
+  extensionShelfScale: 0.94,
+  extensionShelfHeight: 45,
+  hudHeight: 52,
+  actionGap: 10,
+  height: 68
+});
+var DOCK_CARD_LAYOUT = Object.freeze({
+  collapsed: Object.freeze({
+    offsetY: DOCK_CARD_DIMENSIONS.collapsedY,
+    scale: 0.88
+  }),
+  expanded: Object.freeze({
+    offsetY: DOCK_CARD_DIMENSIONS.expandedY,
+    scale: 1
+  }),
+  extensionShelfY: DOCK_CARD_DIMENSIONS.extensionShelfY,
+  extensionShelfScale: DOCK_CARD_DIMENSIONS.extensionShelfScale,
+  extensionShelfHeight: DOCK_CARD_DIMENSIONS.extensionShelfHeight,
+  chromeHeight: DOCK_CARD_DIMENSIONS.chromeHeight,
+  hudHeight: DOCK_CARD_DIMENSIONS.hudHeight,
+  actionGap: DOCK_CARD_DIMENSIONS.actionGap,
+  baseHeight: DOCK_CARD_DIMENSIONS.height
+});
+var DOCK_TRANSACTION_EVENTS = Object.freeze({
+  START: "START",
+  COMPLETE: "COMPLETE",
+  CANCEL: "CANCEL",
+  FAIL: "FAIL",
+  TIME_OUT: "TIME_OUT"
+});
+var DOCK_TRANSACTION_STATUS = Object.freeze({
+  PENDING: "pending",
+  COMPLETED: "completed",
+  CANCELLED: "cancelled",
+  FAILED: "failed",
+  TIMED_OUT: "timed-out"
+});
+var DOCK_TRANSACTION_REASON = Object.freeze({
+  GUARD: "guard",
+  SUPERSEDED: "superseded",
+  TIME_OUT: "time-out"
+});
+var DOCK_TRANSACTION_TIMEOUT_MS = 15e3;
+var DOCK_PREFETCH_INTENT_DELAY_MS = 90;
+var DOCK_CONTINUITY_EVENTS = Object.freeze({
+  CLEAR: "CLEAR",
+  CONSUME_RETURN: "CONSUME_RETURN",
+  DELIVER_RETURN: "DELIVER_RETURN",
+  RECORD: "RECORD",
+  REMOVE: "REMOVE"
+});
+var DOCK_CONTINUITY_MAX_ENTRIES = 32;
+var DOCK_SURFACE_RETURN_MAX_ENTRIES = 16;
+var DOCK_OPERATION_EVENTS = Object.freeze({
+  CANCEL: "CANCEL",
+  CLEAR: "CLEAR",
+  COMPLETE: "COMPLETE",
+  START: "START",
+  UPDATE: "UPDATE"
+});
+var DOCK_OPERATION_STATUS = Object.freeze({
+  CANCELLED: "cancelled",
+  COMPLETED: "completed",
+  PENDING: "pending"
+});
+var DOCK_OPERATION_MAX_ENTRIES = 24;
+var DOCK_FOCUSABLE_SELECTOR = 'a[href],button:not([disabled]),input:not([disabled]),select:not([disabled]),textarea:not([disabled]),[tabindex]:not([tabindex="-1"])';
+var DOCK_FOCUS_RESTORE_BLOCKED_REASONS = Object.freeze([
+  "browser-back",
+  "dock",
+  "unmount"
+]);
+var DOCK_LIFECYCLE = Object.freeze({
+  CLOSING: "closing",
+  OPENING: "opening",
+  IDLE: "idle",
+  OPEN: "open"
+});
+var PLAYBACK_RATES = Object.freeze([1, 1.25, 1.5, 2]);
+var STATUS_PRIORITY = Object.freeze({
+  GUARD: 120,
+  ACCOUNT_DELETE: 115,
+  APP_ERROR: 100,
+  API_ERROR: 95,
+  NOT_FOUND: 97,
+  OFFLINE: 90,
+  LOGOUT: 110,
+  SIGNUP: 110,
+  LOGIN: 110,
+  ONLINE: 10
+});
+var ERROR_STATUS_TYPES = /* @__PURE__ */ new Set([
+  "GUARD",
+  "ACCOUNT_DELETE",
+  "APP_ERROR",
+  "API_ERROR",
+  "NOT_FOUND"
+]);
+var OVERLAY_STATUS_STORAGE_KEY = "dock_overlay_status";
+var OVERLAY_STATUS_CLEAR_DURATION = 3e3;
+var STATUS_CLEAR_DURATION = 4500;
+var API_ERROR_BATCH_DELAY = 300;
+var DOCK_HEIGHT_BUFFER = 16;
+var HEIGHT_EPSILON = 0.5;
+var MAX_VISIBLE_STACKED_CARDS = 3;
+var dockTheme = defineThemeSpec("dock");
 
 // src/modules/media/constants.ts
 var DEFAULT_MEDIA_STATE = Object.freeze({
@@ -2070,6 +1877,8 @@ var LoadingContext = getOrCreateGlobalContext("LoadingContext", null);
 var NOOP_LOADING_STORE = createStore(
   DEFAULT_LOADING_STATE_WITH_PAGE
 );
+
+// src/modules/loading/hooks.ts
 function useOptionalLoadingState(selector, isEqual) {
   const ctx = useContext(LoadingContext);
   return useStore(
@@ -4073,126 +3882,55 @@ function runSurfaceTransition({
     }
   });
 }
-function useDockTheme() {
-  return useTheme(dockTheme);
+function blurActiveElement() {
+  if (typeof document === "undefined") return;
+  const activeElement = document.activeElement;
+  if (activeElement && typeof activeElement.blur === "function") {
+    activeElement.blur();
+  }
 }
-function useDockActionClass() {
-  const { slots } = useDockTheme();
-  return useCallback(
-    (options) => resolveDockActionClass(slots, options),
-    [slots]
+function closestMatches(target, selector) {
+  const element = target;
+  return Boolean(
+    element && typeof element.closest === "function" && element.closest(selector)
   );
 }
-function useDockRegistration(config, options) {
-  useModuleRegistration("dock", config, options);
-}
-function useDockBanner(banner, options) {
-  const position = options?.position;
-  const size = options?.size;
-  const opacity = options?.opacity;
-  const repeat = options?.repeat;
-  const targetPath = options?.path;
-  const config = useMemo(() => {
-    if (!banner) return null;
-    if (typeof banner === "string") {
-      return {
-        bannerUrl: banner,
-        ...position ? { bannerPosition: position } : {},
-        ...size ? { bannerSize: size } : {},
-        ...opacity !== void 0 ? { bannerOpacity: opacity } : {},
-        ...repeat ? { bannerRepeat: repeat } : {},
-        ...targetPath ? { path: targetPath } : {}
-      };
-    }
-    if (typeof banner === "object") {
-      return {
-        bannerUrl: banner.url || banner.bannerUrl,
-        bannerPosition: banner.position || banner.bannerPosition || position,
-        bannerSize: banner.size || banner.bannerSize || size,
-        bannerOpacity: banner.opacity ?? banner.bannerOpacity ?? opacity,
-        bannerRepeat: banner.repeat || banner.bannerRepeat || repeat,
-        ...targetPath ? { path: targetPath } : {}
-      };
-    }
-    return null;
-  }, [banner, position, size, opacity, repeat, targetPath]);
-  useDockRegistration(config, options);
-}
-var EMPTY_DOCK_STATE_STORE = createStore(EMPTY_DOCK_STATE);
-function selectDockConfigState(state) {
-  return {
-    activeItem: state.activeItem,
-    dockHeight: state.dockHeight,
-    expanded: state.expanded,
-    pathname: state.pathname
-  };
-}
-function useDockConfig(configOrTitle, options) {
-  const normalizedConfig = useMemo(() => {
-    if (!configOrTitle) return null;
-    if (typeof configOrTitle === "string") return { title: configOrTitle };
-    return configOrTitle;
-  }, [configOrTitle]);
-  useDockRegistration(normalizedConfig, options);
-  const dockContext = use(DockContext);
-  const actions = dockContext?.actions;
-  const state = useStore(
-    dockContext?.store ?? EMPTY_DOCK_STATE_STORE,
-    selectDockConfigState,
-    shallowEqual
-  );
-  return useMemo(
-    () => ({
-      activeItem: state.activeItem,
-      clearHud: actions?.clearHud ?? (() => {
-      }),
-      closeAllSurfaces: actions?.closeAllSurfaces ?? (() => {
-      }),
-      closeSurface: actions?.closeSurface ?? (() => {
-      }),
-      expanded: state.expanded,
-      dockHeight: state.dockHeight,
-      navigate: actions?.navigate ?? (async () => false),
-      openSurface: actions?.openSurface ?? (() => void 0),
-      pathname: state.pathname,
-      setExpanded: actions?.setExpanded ?? (() => {
-      }),
-      setHud: actions?.setHud ?? (() => {
-      }),
-      setSearchQuery: actions?.setSearchQuery ?? (() => {
-      })
-    }),
-    [actions, state]
+function isInteractiveTarget(target) {
+  return closestMatches(
+    target,
+    'button, a, input, textarea, select, [role="button"], [tabindex]:not([tabindex="-1"])'
   );
 }
-function useDockDimensions() {
-  const { dockHeight } = useDockHeight();
-  const activeItem = useDockSelector((state) => state.activeItem);
-  return {
-    height: dockHeight,
-    width: activeItem?.width ?? null,
-    isSurface: Boolean(activeItem?.isSurface)
-  };
-}
-function useSurfaceReturn() {
-  const pathname = usePathname();
-  const { continuity } = useDockActions();
-  const dockReturnHandoffs = useDockSelector(
-    (state) => state.dockReturnHandoffs
-  );
-  const entries = useMemo(
-    () => (dockReturnHandoffs || []).filter(
-      (handoff) => isSamePath(handoff.path, pathname)
-    ),
-    [dockReturnHandoffs, pathname]
-  );
-  const consume = useCallback(
-    (handoffId = null) => continuity.consumeReturn(pathname, handoffId),
-    [continuity, pathname]
+function isEditableDockTarget(target) {
+  return closestMatches(
+    target,
+    'input, textarea, select, [contenteditable="true"]'
   );
-  return useMemo(
-    () => ({ consume, entries, peek: () => entries[0] || null }),
-    [consume, entries]
+}
+function getDockFocusableElements(container) {
+  if (!container || typeof container.querySelectorAll !== "function") return [];
+  return Array.from(
+    container.querySelectorAll(DOCK_FOCUSABLE_SELECTOR)
+  ).filter((element) => {
+    if (!element || element.getAttribute("aria-hidden") === "true")
+      return false;
+    const style = typeof window !== "undefined" ? window.getComputedStyle(element) : null;
+    return style?.display !== "none" && style?.visibility !== "hidden" && style?.pointerEvents !== "none";
+  });
+}
+function focusDockElement(element) {
+  if (!element || typeof element.focus !== "function") return false;
+  try {
+    element.focus({ preventScroll: true });
+    return document.activeElement === element;
+  } catch {
+    return false;
+  }
+}
+function shouldRestoreDockFocus(result) {
+  const blockedReason = result?.blockedReason;
+  return !result || !DOCK_FOCUS_RESTORE_BLOCKED_REASONS.includes(
+    blockedReason
   );
 }
 function useDockFocusTrap({
@@ -4269,8 +4007,9 @@ function useDockKeyboard({
 }) {
   const handleKeyDown = useCallback(
     (event) => {
-      if (isEditableDockTarget(event.target) || isInteractiveTarget(event.target))
+      if (isEditableDockTarget(event.target) || isInteractiveTarget(event.target)) {
         return;
+      }
       if (isOverlayActive || !expanded) return;
       const { key } = event;
       if (key === "Escape") {
@@ -4281,8 +4020,9 @@ function useDockKeyboard({
       if (key === "Enter" && focusedIndex !== -1) {
         event.preventDefault();
         const focusedItem = dockItems[focusedIndex];
-        if (focusedItem?.path)
+        if (focusedItem?.path) {
           navigate(focusedItem.path, { item: focusedItem });
+        }
         return;
       }
       if (dockItems.length === 0) return;
@@ -4310,814 +4050,1119 @@ function useDockKeyboard({
       setFocusedIndex
     ]
   );
-  useEffect(() => {
-    if (!expanded) return;
-    window.addEventListener("keydown", handleKeyDown);
-    return () => window.removeEventListener("keydown", handleKeyDown);
-  }, [expanded, handleKeyDown]);
+  useEffect(() => {
+    if (!expanded) return;
+    window.addEventListener("keydown", handleKeyDown);
+    return () => window.removeEventListener("keydown", handleKeyDown);
+  }, [expanded, handleKeyDown]);
+}
+function useDockRouteReset(pathname, onRouteChange) {
+  const previousPathRef = useRef(pathname);
+  useEffect(() => {
+    if (previousPathRef.current === pathname) return;
+    previousPathRef.current = pathname;
+    onRouteChange?.(pathname);
+  }, [onRouteChange, pathname]);
+}
+function useSurfaceFlows({
+  closeSurface,
+  openSurface,
+  refs,
+  syncSurfaceStack
+}) {
+  const updateSurfaceFlow = useCallback(
+    (flowId, snapshot) => {
+      const surfaceId = refs.flowIndex.get(flowId);
+      if (!surfaceId) return false;
+      const record = refs.records.get(surfaceId);
+      if (!record?.flow) return false;
+      const nextSession = updateSurfaceFlowSession(record.flow, snapshot);
+      if (!nextSession) return false;
+      const nextSurfaceEntry = {
+        ...record.entry,
+        flow: toSurfaceFlowState(nextSession)
+      };
+      record.flow = nextSession;
+      record.entry = nextSurfaceEntry;
+      syncSurfaceFlowUrlState(nextSurfaceEntry, record.urlState);
+      syncSurfaceStack(
+        updateSurfaceStackEntry(
+          refs.stackRef.current,
+          surfaceId,
+          () => nextSurfaceEntry
+        )
+      );
+      return true;
+    },
+    [syncSurfaceStack, refs]
+  );
+  const completeSurfaceFlow = useCallback(
+    (flowId, data = null) => {
+      const surfaceId = refs.flowIndex.get(flowId);
+      if (!surfaceId) return false;
+      const record = refs.records.get(surfaceId);
+      if (record?.flow)
+        record.flow = {
+          ...record.flow,
+          status: DOCK_SURFACE_FLOW_STATUS.COMPLETED
+        };
+      closeSurface({ data, success: true }, surfaceId);
+      return true;
+    },
+    [closeSurface, refs]
+  );
+  const cancelSurfaceFlow = useCallback(
+    (flowId, data = null) => {
+      const surfaceId = refs.flowIndex.get(flowId);
+      if (!surfaceId) return false;
+      const record = refs.records.get(surfaceId);
+      if (record?.flow)
+        record.flow = {
+          ...record.flow,
+          status: DOCK_SURFACE_FLOW_STATUS.CANCELLED
+        };
+      closeSurface(
+        { cancelled: true, data, reason: "flow-cancelled", success: false },
+        surfaceId
+      );
+      return true;
+    },
+    [closeSurface, refs]
+  );
+  const getSurfaceFlow = useCallback(
+    (flowId) => {
+      const surfaceId = refs.flowIndex.get(flowId);
+      const session = surfaceId ? refs.records.get(surfaceId)?.flow : null;
+      if (!session) return null;
+      return {
+        cancel: (data = null) => cancelSurfaceFlow(flowId, data),
+        complete: (data = null) => completeSurfaceFlow(flowId, data),
+        flowId,
+        isOpen: session.status === DOCK_SURFACE_FLOW_STATUS.OPEN,
+        snapshot: session.snapshot,
+        status: session.status,
+        update: (snapshot) => updateSurfaceFlow(flowId, snapshot)
+      };
+    },
+    [cancelSurfaceFlow, completeSurfaceFlow, updateSurfaceFlow, refs]
+  );
+  const openSurfaceFlow = useCallback(
+    (input, flowInput = null, {
+      preserveUrl = false,
+      snapshot
+    } = {}) => {
+      const definition = createSurfaceFlowDefinition(input);
+      if (!definition) {
+        const error = createSurfaceError(
+          "DOCK_SURFACE_FLOW_INVALID_DEFINITION",
+          "Dock surface flow definition is invalid"
+        );
+        report("Dock surface flow definition", error);
+        return Promise.resolve({ success: false, error });
+      }
+      const existingSurfaceId = refs.flowIndex.get(definition.id);
+      if (definition.singleton && existingSurfaceId) {
+        return refs.records.get(existingSurfaceId)?.promise ?? Promise.resolve({
+          success: false,
+          error: createSurfaceError(
+            "DOCK_SURFACE_FLOW_ORPHANED",
+            "Dock surface flow is orphaned"
+          )
+        });
+      }
+      const flowSession = createSurfaceFlowSession(definition, {
+        input: flowInput,
+        snapshot
+      });
+      try {
+        const surfaceInput = definition.createSurface({
+          flowId: definition.id,
+          input: flowInput,
+          snapshot: flowSession?.snapshot
+        });
+        return openSurface(surfaceInput, { flowSession, preserveUrl });
+      } catch (error) {
+        report("Dock surface flow factory", error);
+        return Promise.resolve({ success: false, error });
+      }
+    },
+    [openSurface, refs]
+  );
+  const restoreSurfaceFlow = useCallback(
+    (input) => {
+      const definition = createSurfaceFlowDefinition(input);
+      const snapshot = getRestorableSurfaceFlowSnapshot(definition);
+      if (!definition || snapshot === void 0) return Promise.resolve(null);
+      return openSurfaceFlow(definition, null, { preserveUrl: true, snapshot });
+    },
+    [openSurfaceFlow]
+  );
+  return {
+    cancelSurfaceFlow,
+    completeSurfaceFlow,
+    getSurfaceFlow,
+    openSurfaceFlow,
+    restoreSurfaceFlow,
+    updateSurfaceFlow
+  };
+}
+function useSurfaceLifecycleEffects({
+  clearChoreographyTimers,
+  closeAllSurfaces,
+  focusRestoreFrameRef,
+  refs,
+  runtimeScheduler
+}) {
+  useEffect(() => {
+    if (!IS_BROWSER) return;
+    const handlePopState = () => {
+      const activeEntry = refs.stackRef.current[refs.stackRef.current.length - 1];
+      if (!activeEntry?.syncWithUrl && !activeEntry?.urlKey) return;
+      if (new URL(window.location.href).searchParams.get("surface") === getSurfaceUrlValue(activeEntry))
+        return;
+      closeAllSurfaces({
+        success: false,
+        cancelled: true,
+        reason: "browser-back"
+      });
+    };
+    window.addEventListener("popstate", handlePopState);
+    return () => window.removeEventListener("popstate", handlePopState);
+  }, [closeAllSurfaces, refs]);
+  useEffect(() => {
+    return () => {
+      clearChoreographyTimers();
+      if (focusRestoreFrameRef.current !== null) {
+        runtimeScheduler.cancel(focusRestoreFrameRef.current);
+        focusRestoreFrameRef.current = null;
+      }
+      const result = { cancelled: true, reason: "unmount", success: false };
+      refs.stackRef.current.forEach(
+        ({ id }) => releaseSurfaceResources({ refs, result, surfaceId: id })
+      );
+      refs.stackRef.current = [];
+      refs.payloads.clear();
+      refs.records.clear();
+      refs.flowIndex.clear();
+    };
+  }, [clearChoreographyTimers, focusRestoreFrameRef, refs, runtimeScheduler]);
+}
+var SurfaceFlowContext = createContext(null);
+function SurfaceFlowProvider({
+  children,
+  value
+}) {
+  return /* @__PURE__ */ jsx(SurfaceFlowContext, { value, children });
+}
+function useSurfaceFlow(input) {
+  const context = use(SurfaceFlowContext);
+  const definition = useMemo(() => createSurfaceFlowDefinition(input), [input]);
+  const restoredFlowIdsRef = useRef(/* @__PURE__ */ new Set());
+  const flowId = definition?.id ?? null;
+  const activeFlow = useMemo(() => {
+    if (!flowId) return null;
+    return context?.surfaceState?.surfaceStack?.map((s) => s.flow).find((f) => f?.flowId === flowId) ?? null;
+  }, [context?.surfaceState?.surfaceStack, flowId]);
+  useEffect(() => {
+    if (!definition || !context?.restoreSurfaceFlow || restoredFlowIdsRef.current.has(definition.id))
+      return;
+    restoredFlowIdsRef.current.add(definition.id);
+    void context.restoreSurfaceFlow(definition);
+  }, [context, definition]);
+  const open = useCallback(
+    (flowInput = null) => {
+      if (!definition || !context?.openSurfaceFlow) {
+        return Promise.resolve({
+          success: false,
+          error: createSurfaceError(
+            "DOCK_SURFACE_FLOW_UNAVAILABLE",
+            "Dock surface flow is unavailable"
+          )
+        });
+      }
+      return context.openSurfaceFlow(definition, flowInput);
+    },
+    [context, definition]
+  );
+  return useMemo(
+    () => ({
+      activeFlow,
+      cancel: (result = null) => flowId ? context?.cancelSurfaceFlow?.(flowId, result) : void 0,
+      complete: (result = null) => flowId ? context?.completeSurfaceFlow?.(flowId, result) : void 0,
+      flowId,
+      isOpen: activeFlow?.status === DOCK_SURFACE_FLOW_STATUS.OPEN,
+      open,
+      snapshot: activeFlow?.snapshot ?? definition?.initialSnapshot ?? null,
+      update: (snapshot) => flowId ? context?.updateSurfaceFlow?.(flowId, snapshot) : void 0
+    }),
+    [activeFlow, context, definition?.initialSnapshot, flowId, open]
+  );
 }
-function useDockRouteReset(pathname, onRouteChange) {
-  const previousPathRef = useRef(pathname);
-  useEffect(() => {
-    if (previousPathRef.current === pathname) return;
-    previousPathRef.current = pathname;
-    onRouteChange?.(pathname);
-  }, [onRouteChange, pathname]);
+var DockSurfaceHeaderRadiusContext = createContext(
+  null
+);
+function useDockSurfaceHeaderButtonModel({
+  children,
+  className = "",
+  disabled = false,
+  onClick,
+  ariaLabel,
+  icon = null
+}) {
+  const contextRadius = use(DockSurfaceHeaderRadiusContext);
+  return { contextRadius };
 }
-function getDockItemCardProps({
-  cardScale,
-  cardStyle,
-  expanded,
+function useDockSurfaceControlsModel({
+  activeItem = null,
   hasExtensions = false,
-  isAnchoredToBottom,
-  position,
-  theme,
-  visibleCount = 3
+  onClose = null,
+  onBack = null,
+  closeLabel = null,
+  backLabel = null,
+  className = "",
+  surfacePhase: propSurfacePhase
 }) {
-  const { offsetY: collapsedOffsetY, scale: collapsedScale } = DOCK_CARD_LAYOUT.collapsed;
-  const { offsetY: expandedOffsetY } = DOCK_CARD_LAYOUT.expanded;
-  const safeCardStyle = { ...cardStyle };
-  delete safeCardStyle.scale;
-  delete safeCardStyle.className;
-  const isTop = position === 0;
-  const isShelf = !expanded && position === 1 && hasExtensions;
-  const isHeavyBlur = position < visibleCount || expanded || isShelf;
-  const collapsedScaleValue = collapsedScale ** position;
-  const y = expanded ? position * expandedOffsetY : isShelf ? DOCK_CARD_LAYOUT.extensionShelfY : position * collapsedOffsetY;
-  const shelfScale = DOCK_CARD_LAYOUT.extensionShelfScale ?? 0.94;
-  const scale = expanded ? cardScale || 1 : isShelf ? shelfScale : collapsedScaleValue;
-  const collapsedOpacity = Math.max(0.1, +(1 - position * 0.2).toFixed(2));
-  const opacity = expanded || isShelf ? 1 : position < visibleCount ? collapsedOpacity : 0;
-  return {
-    className: cn(theme.slots.card, cardStyle?.className),
-    data: {
-      "data-anchored": isAnchoredToBottom,
-      "data-blur": isHeavyBlur ? "heavy" : "light",
-      "data-placement": isTop ? "top" : isAnchoredToBottom ? "bottom" : "float",
-      "data-shelf": isShelf
-    },
-    style: {
-      ...theme.styles.card,
-      ...safeCardStyle,
-      willChange: "transform, opacity",
-      transformOrigin: isAnchoredToBottom ? "bottom center" : "top center",
-      zIndex: Z_INDEX.DOCK_CARD_STACK_BASE - position,
-      WebkitPerspective: 1e3,
-      perspective: 1e3,
-      WebkitBackfaceVisibility: "hidden",
-      backfaceVisibility: "hidden",
-      WebkitFontSmoothing: "antialiased",
-      transform: "translateZ(0)",
-      ...isTop ? { height: "100%" } : {},
-      pointerEvents: expanded || position < visibleCount ? void 0 : "none"
+  const phase = propSurfacePhase ?? activeItem?.surfacePhase;
+  const isBodyVisible = phase ? phase === DOCK_SURFACE_PHASE.EXPANDING_BODY || phase === DOCK_SURFACE_PHASE.OPEN : true;
+  const actionStore = use(SurfaceExtensionsContext)?.headerActions ?? null;
+  const surfaceId = activeItem?.surfaceId || "active";
+  const subscribeAction = useCallback(
+    (onStoreChange) => actionStore ? actionStore.subscribe(onStoreChange) : () => {
     },
-    motionValues: { y, scale, opacity }
-  };
-}
-function getViewportMaxHeight() {
-  if (typeof window === "undefined") return Infinity;
-  return window.innerHeight - VIEWPORT_MARGIN;
-}
-function getContainerHeight({
-  cardContentHeight,
-  isHud = false
-}) {
-  const chromeHeight = DOCK_CARD_LAYOUT.chromeHeight;
-  const minCardHeight = isHud ? DOCK_CARD_LAYOUT.hudHeight : DOCK_CARD_LAYOUT.baseHeight;
-  const numericContentHeight = Number(cardContentHeight);
-  const nextCardHeight = Math.max(
-    minCardHeight,
-    (Number.isFinite(numericContentHeight) ? numericContentHeight : 0) + chromeHeight
+    [actionStore]
   );
-  return Math.min(nextCardHeight, getViewportMaxHeight());
-}
-function getDockCardWidth({
-  width
-} = {}) {
-  if (typeof window === "undefined") return width ? Number(width) || 460 : 460;
-  const windowWidth = window.innerWidth;
-  const isDesktop = windowWidth >= 640;
-  const targetWidth = Number(width);
-  if (Number.isFinite(targetWidth) && targetWidth > 0) {
-    return Math.min(
-      targetWidth,
-      Math.max(windowWidth - (isDesktop ? 32 : 16), 0)
-    );
-  }
-  return Math.min(460, Math.max(windowWidth - 16, 0));
-}
-function getObservedHeight(entry, element) {
-  const rawBorderBoxSize = entry?.borderBoxSize;
-  const borderBoxSize = Array.isArray(rawBorderBoxSize) ? rawBorderBoxSize[0] : rawBorderBoxSize;
-  if (borderBoxSize?.blockSize != null)
-    return Math.round(borderBoxSize.blockSize);
-  if (entry?.contentRect?.height != null)
-    return Math.round(entry.contentRect.height);
-  return Math.round(element?.offsetHeight || 0);
+  const getActionSnapshot = useCallback(
+    () => actionStore ? actionStore.getAction(surfaceId) : null,
+    [actionStore, surfaceId]
+  );
+  const dynamicAction = useSyncExternalStore(
+    subscribeAction,
+    getActionSnapshot,
+    () => null
+  );
+  return { isBodyVisible, dynamicAction };
 }
-function hasMeaningfulHeightChange(previousHeight, nextHeight) {
-  return Math.abs(Math.round(nextHeight) - Math.round(previousHeight)) > HEIGHT_EPSILON;
+function SurfaceExtensionsProvider({
+  children
+}) {
+  const [value] = useState(() => ({
+    extensions: new SurfaceExtensionsStore(),
+    headerActions: new SurfaceHeaderActionStore()
+  }));
+  return /* @__PURE__ */ jsx(SurfaceExtensionsContext, { value, children });
 }
-function useElementHeight(onHeightChange, elementRef, shouldMeasure, dependencyKey = null) {
-  const lastHeightRef = useRef(0);
-  const rafRef = useRef(null);
-  const callbackRef = useRef(onHeightChange);
-  useIsomorphicLayoutEffect(() => {
-    callbackRef.current = onHeightChange;
-  }, [onHeightChange]);
+function useDockSurfaceExtension({
+  align = "left",
+  children,
+  className = "",
+  id,
+  order = 0,
+  unstyled = false
+}) {
+  const store = use(SurfaceExtensionsContext)?.extensions ?? null;
+  const surfaceId = useSurfaceId();
+  const generatedId = useId();
+  const effectiveId = id || `dock-surface-ext-${generatedId}`;
   useIsomorphicLayoutEffect(() => {
-    if (rafRef.current !== null) {
-      cancelAnimationFrame(rafRef.current);
-      rafRef.current = null;
-    }
-    lastHeightRef.current = -1;
-    if (!callbackRef.current) return;
-    if (!shouldMeasure) {
-      if (hasMeaningfulHeightChange(lastHeightRef.current, 0)) {
-        lastHeightRef.current = 0;
-        callbackRef.current(0);
-      }
-      return;
-    }
-    const element = elementRef?.current;
-    if (!element) return;
-    function publishHeight(nextHeight) {
-      if (!hasMeaningfulHeightChange(lastHeightRef.current, nextHeight)) return;
-      lastHeightRef.current = nextHeight;
-      callbackRef.current?.(nextHeight);
-    }
-    let pendingHeight = null;
-    function flushPendingHeight() {
-      rafRef.current = null;
-      if (pendingHeight == null) return;
-      const heightToPublish = pendingHeight;
-      pendingHeight = null;
-      publishHeight(heightToPublish);
-    }
-    function scheduleMeasurement(nextHeight) {
-      pendingHeight = nextHeight;
-      if (rafRef.current !== null) return;
-      rafRef.current = requestAnimationFrame(flushPendingHeight);
-    }
-    publishHeight(element.offsetHeight || 0);
-    const observer = new ResizeObserver((entries) => {
-      for (const entry of entries) {
-        scheduleMeasurement(getObservedHeight(entry, element));
-      }
-    });
-    observer.observe(element);
-    const handlePageShow = () => scheduleMeasurement(element.offsetHeight || 0);
-    const handleVisibilityChange = () => {
-      if (document.visibilityState === "visible") handlePageShow();
+    if (!store) return;
+    const extension = {
+      align,
+      className,
+      content: children,
+      id: effectiveId,
+      order,
+      unstyled
     };
-    window.addEventListener("pageshow", handlePageShow);
-    document.addEventListener("visibilitychange", handleVisibilityChange);
+    store.setExtension(surfaceId, extension);
+    if (surfaceId && surfaceId !== "active") {
+      store.setExtension("active", extension);
+    }
+  });
+  useEffect(() => {
     return () => {
-      observer.disconnect();
-      window.removeEventListener("pageshow", handlePageShow);
-      document.removeEventListener("visibilitychange", handleVisibilityChange);
-      if (rafRef.current !== null) {
-        cancelAnimationFrame(rafRef.current);
-        rafRef.current = null;
+      if (store) {
+        store.removeExtension(surfaceId, effectiveId);
+        if (surfaceId && surfaceId !== "active") {
+          store.removeExtension("active", effectiveId);
+        }
       }
     };
-  }, [dependencyKey, elementRef, shouldMeasure]);
+  }, [store, surfaceId, effectiveId]);
 }
-function publishDockHeightCssVar(heightPx) {
-  if (typeof document === "undefined") return;
-  document.documentElement.style.setProperty(
-    "--dock-h",
-    `${Math.round(heightPx)}px`
+function useIsSurfaceExtensionsVisible(activeItem) {
+  const store = use(SurfaceExtensionsContext)?.extensions ?? null;
+  const surfaceId = activeItem?.surfaceId || "active";
+  const isSurface = Boolean(activeItem?.isSurface);
+  const phase = activeItem?.surfacePhase;
+  const isBodyVisible = phase === DOCK_SURFACE_PHASE.EXPANDING_BODY || phase === DOCK_SURFACE_PHASE.OPEN;
+  const subscribe2 = useCallback(
+    (onStoreChange) => store ? store.subscribe(onStoreChange) : () => {
+    },
+    [store]
+  );
+  const getSnapshot2 = useCallback(
+    () => store ? store.getExtensionsForSurface(surfaceId).length : 0,
+    [store, surfaceId]
+  );
+  const dynamicCount = useSyncExternalStore(subscribe2, getSnapshot2, () => 0);
+  const descriptorCount = useMemo(() => {
+    const raw = activeItem?.surfaceExtensions || activeItem?.extensions || [];
+    return Array.isArray(raw) ? raw.length : 0;
+  }, [activeItem?.surfaceExtensions, activeItem?.extensions]);
+  return Boolean(
+    isSurface && isBodyVisible && (dynamicCount > 0 || descriptorCount > 0)
   );
 }
-function useDockHeightController({
-  contentKey = null,
-  isHud = false,
-  setDockHeight,
-  surfacePhase = DOCK_SURFACE_PHASE.IDLE
+function useDockSurfaceExtensionsBarModel({
+  activeItem
 }) {
-  const [containerHeight, setContainerHeight] = useState(
-    isHud ? DOCK_CARD_LAYOUT.hudHeight : DOCK_CARD_LAYOUT.baseHeight
+  const store = use(SurfaceExtensionsContext)?.extensions ?? null;
+  const surfaceId = activeItem?.surfaceId || "active";
+  const subscribe2 = useCallback(
+    (onStoreChange) => store ? store.subscribe(onStoreChange) : () => {
+    },
+    [store]
   );
-  const heightRef = useRef({ content: 0 });
-  const rafRef = useRef(null);
-  const isHudRef = useRef(isHud);
-  const surfacePhaseRef = useRef(surfacePhase);
-  const lastAppliedContainerHeightRef = useRef(
-    isHud ? DOCK_CARD_LAYOUT.hudHeight : DOCK_CARD_LAYOUT.baseHeight
+  const getSnapshot2 = useCallback(
+    () => store ? store.getExtensionsForSurface(surfaceId) : [],
+    [store, surfaceId]
   );
-  const lastAppliedSpacerHeightRef = useRef(
-    (isHud ? DOCK_CARD_LAYOUT.hudHeight : DOCK_CARD_LAYOUT.baseHeight) + DOCK_HEIGHT_BUFFER
+  const dynamicExtensions = useSyncExternalStore(
+    subscribe2,
+    getSnapshot2,
+    () => []
   );
-  useInsertionEffect(() => {
-    isHudRef.current = isHud;
-    surfacePhaseRef.current = surfacePhase;
-  }, [isHud, surfacePhase]);
-  const applyHeight = useCallback(() => {
-    if (rafRef.current !== null) {
-      cancelAnimationFrame(rafRef.current);
-      rafRef.current = null;
-    }
-    const { content } = heightRef.current;
-    const currentPhase = surfacePhaseRef.current;
-    const isLockedToBaseHeight = currentPhase === DOCK_SURFACE_PHASE.DISMISSING_ACTION || currentPhase === DOCK_SURFACE_PHASE.COLLAPSING_BODY || currentPhase === DOCK_SURFACE_PHASE.RESTORING_HEADER;
-    const computedContentHeight = isLockedToBaseHeight ? 0 : content;
-    const height = getContainerHeight({
-      cardContentHeight: computedContentHeight,
-      isHud: isHudRef.current
-    });
-    const totalSpacerHeight = height + DOCK_HEIGHT_BUFFER;
-    if (Math.abs(height - lastAppliedContainerHeightRef.current) > 0.5) {
-      lastAppliedContainerHeightRef.current = height;
-      setContainerHeight(height);
-    }
-    if (Math.abs(totalSpacerHeight - lastAppliedSpacerHeightRef.current) > 0.5) {
-      lastAppliedSpacerHeightRef.current = totalSpacerHeight;
-      publishDockHeightCssVar(totalSpacerHeight);
-      setDockHeight(totalSpacerHeight);
+  const descriptorExtensions = useMemo(() => {
+    const raw = activeItem?.surfaceExtensions || activeItem?.extensions || [];
+    return Array.isArray(raw) ? raw.map(normalizeSurfaceExtension).filter((ext) => ext !== null) : [];
+  }, [activeItem?.surfaceExtensions, activeItem?.extensions]);
+  const allExtensions = useMemo(() => {
+    const map = /* @__PURE__ */ new Map();
+    descriptorExtensions.forEach((ext) => map.set(ext.id, ext));
+    dynamicExtensions.forEach((ext) => map.set(ext.id, ext));
+    return Array.from(map.values()).sort((a, b) => a.order - b.order);
+  }, [descriptorExtensions, dynamicExtensions]);
+  return { allExtensions };
+}
+var DRAG_RANGE = [...DOCK_SURFACE_DRAG_INTERPOLATION.DRAG_RANGE];
+var OPACITY_RANGE = [...DOCK_SURFACE_DRAG_INTERPOLATION.OPACITY_RANGE];
+var SCALE_RANGE = [...DOCK_SURFACE_DRAG_INTERPOLATION.SCALE_RANGE];
+function useDockSurfaceShellModel({
+  ref,
+  title = "",
+  onClose = null,
+  onBack = null,
+  allowSwipeDismiss = true,
+  closeLabel = "Close surface",
+  backLabel = "Previous step",
+  showControls = false,
+  className = "",
+  contentClassName = "",
+  children,
+  onAnimationComplete = null,
+  isActive = true,
+  surfaceId = null,
+  surfacePhase = DOCK_SURFACE_PHASE.OPEN,
+  surfaceWidth = null
+}) {
+  const surfaceElementRef = useRef(null);
+  const setSurfaceElementRef = useCallback(
+    (node) => {
+      surfaceElementRef.current = node;
+      if (typeof ref === "function") ref(node);
+      else if (ref) ref.current = node;
+    },
+    [ref]
+  );
+  const isFullyOpen = surfacePhase === DOCK_SURFACE_PHASE.OPEN;
+  const titleId = surfaceId == null ? void 0 : `dock-surface-title-${surfaceId}`;
+  const dragY = useMotionValue(0);
+  const dragOpacity = useTransform(dragY, DRAG_RANGE, OPACITY_RANGE);
+  const dragScale = useTransform(dragY, DRAG_RANGE, SCALE_RANGE);
+  useDockFocusTrap({
+    containerRef: surfaceElementRef,
+    enabled: isActive && isFullyOpen,
+    onDismiss: typeof onClose === "function" ? onClose : null
+  });
+  const handleDragEnd = (_event, info) => {
+    if (!isActive || !allowSwipeDismiss || typeof onClose !== "function" || !isFullyOpen)
+      return;
+    if (info.offset.y > DOCK_SURFACE_DRAG_THRESHOLDS.DISMISS_OFFSET_Y || info.velocity.y > DOCK_SURFACE_DRAG_THRESHOLDS.DISMISS_VELOCITY_Y) {
+      onClose();
     }
-  }, [setDockHeight]);
-  const handleContentHeightChange = useCallback(
-    (height) => {
-      const numericHeight = Number(height);
-      heightRef.current.content = Number.isFinite(numericHeight) ? Math.max(0, numericHeight) : 0;
-      applyHeight();
+  };
+  const dragControls = useDragControls();
+  const canDragDismiss = Boolean(
+    isActive && allowSwipeDismiss && typeof onClose === "function" && isFullyOpen
+  );
+  const handleSurfacePointerDown = useCallback(
+    (event) => {
+      if (!canDragDismiss) return;
+      const target = event.target;
+      if (target?.closest?.(
+        'input, textarea, select, [role="slider"], [data-no-surface-drag], [data-lenis-prevent]'
+      )) {
+        return;
+      }
+      dragControls.start(event);
     },
-    [applyHeight]
+    [canDragDismiss, dragControls]
   );
-  useEffect(() => {
-    return () => {
-      if (rafRef.current !== null) cancelAnimationFrame(rafRef.current);
-    };
-  }, []);
-  useIsomorphicLayoutEffect(() => applyHeight(), [applyHeight, contentKey]);
-  useIsomorphicLayoutEffect(() => applyHeight(), [applyHeight, surfacePhase]);
-  useIsomorphicLayoutEffect(() => applyHeight(), [applyHeight, isHud]);
-  return { containerHeight, handleContentHeightChange };
-}
-function isSurfaceShapePhase(phase) {
-  return phase === DOCK_SURFACE_PHASE.EXPANDING_BODY || phase === DOCK_SURFACE_PHASE.OPEN || phase === DOCK_SURFACE_PHASE.CLOSING_ANTICIPATION;
-}
-function getTargetItemWidth(activeItem) {
-  if (!activeItem?.isSurface || isSurfaceShapePhase(activeItem.surfacePhase))
-    return activeItem?.width;
-  return activeItem.restingWidth;
+  const isBodyVisible = surfacePhase === DOCK_SURFACE_PHASE.EXPANDING_BODY || surfacePhase === DOCK_SURFACE_PHASE.OPEN;
+  const resolvedSurfaceId = surfaceId || "active";
+  const bodyVariants = useMemo(
+    () => ({
+      hidden: dockSurfaceBodyRole.hidden,
+      visible: {
+        ...dockSurfaceBodyRole.visible,
+        transition: surfacePhase === DOCK_SURFACE_PHASE.EXPANDING_BODY ? DOCK_SURFACE_BODY_ENTER_TRANSITION : DOCK_SURFACE_BODY_STEP_TRANSITION
+      },
+      exit: {
+        ...dockSurfaceBodyRole.exit,
+        transition: DOCK_SURFACE_BODY_EXIT_TRANSITION
+      }
+    }),
+    [surfacePhase]
+  );
+  const surfaceItemValue = useMemo(
+    () => ({ id: resolvedSurfaceId, width: surfaceWidth }),
+    [resolvedSurfaceId, surfaceWidth]
+  );
+  return {
+    setSurfaceElementRef,
+    titleId,
+    dragY,
+    dragOpacity,
+    dragScale,
+    handleDragEnd,
+    dragControls,
+    canDragDismiss,
+    handleSurfacePointerDown,
+    isBodyVisible,
+    bodyVariants,
+    surfaceItemValue
+  };
 }
-function useDockViewport(activeItem = null) {
-  const targetWidth = getTargetItemWidth(activeItem);
-  const [, setViewportRevision] = useState(0);
-  const [portalTarget, setPortalTarget] = useState(null);
-  const stackWidth = getDockCardWidth({ width: targetWidth });
-  useIsomorphicLayoutEffect(() => {
-    if (typeof document !== "undefined") setPortalTarget(document.body);
-  }, []);
-  useEffect(() => {
-    if (typeof window === "undefined") return void 0;
-    let resizeFrameId = null;
-    const handleResize = () => {
-      if (resizeFrameId !== null) return;
-      resizeFrameId = window.requestAnimationFrame(() => {
-        resizeFrameId = null;
-        setViewportRevision((revision) => revision + 1);
-      });
-    };
-    window.addEventListener("resize", handleResize, { passive: true });
-    return () => {
-      window.removeEventListener("resize", handleResize);
-      if (resizeFrameId !== null) window.cancelAnimationFrame(resizeFrameId);
-    };
-  }, []);
-  return { portalTarget, stackWidth };
+
+// src/modules/dock/styles.ts
+function isValidBannerUrl(banner) {
+  const value = trimToNull(banner);
+  if (!value) return false;
+  return /^(https?:\/\/|\/|data:image\/)/.test(value);
 }
-function pickCardSurfaceStyle(style) {
-  const cardSurfaceStyle = {};
-  if (style?.background != null) cardSurfaceStyle.background = style.background;
-  if (style?.borderColor != null)
-    cardSurfaceStyle.borderColor = style.borderColor;
-  return cardSurfaceStyle;
+function splitStyle(style = {}) {
+  const { className, ...inlineStyle } = style;
+  return {
+    className,
+    inlineStyle
+  };
 }
-function toStyleSections(value) {
-  return toObject(value);
+function getLineClampStyle(maxLines, style) {
+  if (Number(maxLines) <= 1) return style;
+  return {
+    WebkitBoxOrient: "vertical",
+    WebkitLineClamp: maxLines,
+    display: "-webkit-box",
+    overflow: "hidden",
+    ...style
+  };
 }
-function mergeStyleSection(baseStyle, stateStyle, hoverStyle, section) {
+function getImageIconStyle(style, icon) {
+  const nextStyle = {
+    ...style
+  };
+  delete nextStyle.background;
+  delete nextStyle.backgroundImage;
   return {
-    ...toObject(baseStyle?.[section]),
-    ...toObject(stateStyle?.[section]),
-    ...toObject(hoverStyle?.[section])
+    ...nextStyle,
+    backgroundImage: `url(${icon})`
   };
 }
-function resolveDockVisualStyle(style, {
+function resolveDockActionClass(slots, {
+  className = "",
+  button = "",
   isActive = false,
-  isHovered = false
+  variant = "",
+  tone = "",
+  base,
+  cn: classNamesFn
 } = {}) {
-  const baseStyle = toObject(style);
-  const stateStyle = isActive ? toStyleSections(baseStyle.active) : toStyleSections(baseStyle.inactive);
-  const hoverStyle = isHovered ? toStyleSections(baseStyle.hover) : {};
-  const sections = {
-    card: {},
-    icon: {},
-    title: {},
-    description: {}
+  const resolve = classNamesFn || cn;
+  const toneClasses = {
+    muted: slots.actionMuted,
+    active: slots.actionActive
   };
-  for (const section of DOCK_STYLE_SECTIONS) {
-    sections[section] = mergeStyleSection(
-      baseStyle,
-      stateStyle,
-      hoverStyle,
-      section
-    );
+  if (button && !className && base === void 0) {
+    if (tone) {
+      const toneClass = toneClasses[tone] || slots.actionSurface || slots.actionMuted;
+      return resolve(button, toneClass);
+    }
+    const stateToken = isActive ? slots.actionActive : slots.actionMuted;
+    return resolve(button, stateToken);
   }
-  sections.card = { ...pickCardSurfaceStyle(baseStyle), ...sections.card };
+  const elementClass = className || button;
+  const resolvedBase = base !== void 0 ? base : slots.action;
+  const stateClass = variant || tone && (toneClasses[tone] || slots.actionSurface) || (isActive ? slots.actionActive : slots.actionMuted);
+  return resolve(stateClass, resolvedBase, elementClass);
+}
+function getDockItemCardProps({
+  cardScale,
+  cardStyle,
+  expanded,
+  hasExtensions = false,
+  isAnchoredToBottom,
+  position,
+  theme,
+  visibleCount = 3
+}) {
+  const { offsetY: collapsedOffsetY, scale: collapsedScale } = DOCK_CARD_LAYOUT.collapsed;
+  const { offsetY: expandedOffsetY } = DOCK_CARD_LAYOUT.expanded;
+  const safeCardStyle = { ...cardStyle };
+  delete safeCardStyle.scale;
+  delete safeCardStyle.className;
+  const isTop = position === 0;
+  const isShelf = !expanded && position === 1 && hasExtensions;
+  const isHeavyBlur = position < visibleCount || expanded || isShelf;
+  const collapsedScaleValue = collapsedScale ** position;
+  const y = expanded ? position * expandedOffsetY : isShelf ? DOCK_CARD_LAYOUT.extensionShelfY : position * collapsedOffsetY;
+  const shelfScale = DOCK_CARD_LAYOUT.extensionShelfScale ?? 0.94;
+  const scale = expanded ? cardScale || 1 : isShelf ? shelfScale : collapsedScaleValue;
+  const collapsedOpacity = Math.max(0.1, +(1 - position * 0.2).toFixed(2));
+  const opacity = expanded || isShelf ? 1 : position < visibleCount ? collapsedOpacity : 0;
   return {
-    ...sections,
-    scale: hoverStyle?.card?.scale ?? stateStyle?.card?.scale ?? baseStyle?.scale
+    className: cn(theme.slots.card, cardStyle?.className),
+    data: {
+      "data-anchored": isAnchoredToBottom,
+      "data-blur": isHeavyBlur ? "heavy" : "light",
+      "data-placement": isTop ? "top" : isAnchoredToBottom ? "bottom" : "float",
+      "data-shelf": isShelf
+    },
+    style: {
+      ...theme.styles.card,
+      ...safeCardStyle,
+      willChange: "transform, opacity",
+      transformOrigin: isAnchoredToBottom ? "bottom center" : "top center",
+      zIndex: Z_INDEX.DOCK_CARD_STACK_BASE - position,
+      WebkitPerspective: 1e3,
+      perspective: 1e3,
+      WebkitBackfaceVisibility: "hidden",
+      backfaceVisibility: "hidden",
+      WebkitFontSmoothing: "antialiased",
+      transform: "translateZ(0)",
+      ...isTop ? { height: "100%" } : {},
+      pointerEvents: expanded || position < visibleCount ? void 0 : "none"
+    },
+    motionValues: { y, scale, opacity }
   };
 }
-function shouldRenderInlineAction({
-  action,
-  isLoading,
-  isOverlay,
-  path
-}, pathname) {
-  return Boolean(action) && !isLoading && (isOverlay || !path || isInlineActionPathMatch(path, pathname));
+function toObject(value) {
+  return isObject(value) ? value : {};
 }
-function getIsItemActive(link, activeItem) {
-  if (!link || !activeItem) return false;
-  if (link.path && activeItem.path && isSamePath(link.path, activeItem.path))
-    return true;
-  if (link.targetPath && activeItem.targetPath && isSamePath(link.targetPath, activeItem.targetPath))
-    return true;
-  return Boolean(link.name && activeItem.name && link.name === activeItem.name);
+function pickCardSurfaceStyle(style) {
+  const cardSurfaceStyle = {};
+  if (style?.background != null) cardSurfaceStyle.background = style.background;
+  if (style?.borderColor != null)
+    cardSurfaceStyle.borderColor = style.borderColor;
+  return cardSurfaceStyle;
 }
-function useSurfaceFlows({
-  closeSurface,
-  openSurface,
-  refs,
-  syncSurfaceStack
-}) {
-  const updateSurfaceFlow = useCallback(
-    (flowId, snapshot) => {
-      const surfaceId = refs.flowIndex.get(flowId);
-      if (!surfaceId) return false;
-      const record = refs.records.get(surfaceId);
-      if (!record?.flow) return false;
-      const nextSession = updateSurfaceFlowSession(record.flow, snapshot);
-      if (!nextSession) return false;
-      const nextSurfaceEntry = {
-        ...record.entry,
-        flow: toSurfaceFlowState(nextSession)
-      };
-      record.flow = nextSession;
-      record.entry = nextSurfaceEntry;
-      syncSurfaceFlowUrlState(nextSurfaceEntry, record.urlState);
-      syncSurfaceStack(
-        updateSurfaceStackEntry(
-          refs.stackRef.current,
-          surfaceId,
-          () => nextSurfaceEntry
-        )
-      );
-      return true;
-    },
-    [syncSurfaceStack, refs]
-  );
-  const completeSurfaceFlow = useCallback(
-    (flowId, data = null) => {
-      const surfaceId = refs.flowIndex.get(flowId);
-      if (!surfaceId) return false;
-      const record = refs.records.get(surfaceId);
-      if (record?.flow)
-        record.flow = {
-          ...record.flow,
-          status: DOCK_SURFACE_FLOW_STATUS.COMPLETED
-        };
-      closeSurface({ data, success: true }, surfaceId);
-      return true;
-    },
-    [closeSurface, refs]
-  );
-  const cancelSurfaceFlow = useCallback(
-    (flowId, data = null) => {
-      const surfaceId = refs.flowIndex.get(flowId);
-      if (!surfaceId) return false;
-      const record = refs.records.get(surfaceId);
-      if (record?.flow)
-        record.flow = {
-          ...record.flow,
-          status: DOCK_SURFACE_FLOW_STATUS.CANCELLED
-        };
-      closeSurface(
-        { cancelled: true, data, reason: "flow-cancelled", success: false },
-        surfaceId
-      );
-      return true;
-    },
-    [closeSurface, refs]
-  );
-  const getSurfaceFlow = useCallback(
-    (flowId) => {
-      const surfaceId = refs.flowIndex.get(flowId);
-      const session = surfaceId ? refs.records.get(surfaceId)?.flow : null;
-      if (!session) return null;
-      return {
-        cancel: (data = null) => cancelSurfaceFlow(flowId, data),
-        complete: (data = null) => completeSurfaceFlow(flowId, data),
-        flowId,
-        isOpen: session.status === DOCK_SURFACE_FLOW_STATUS.OPEN,
-        snapshot: session.snapshot,
-        status: session.status,
-        update: (snapshot) => updateSurfaceFlow(flowId, snapshot)
-      };
-    },
-    [cancelSurfaceFlow, completeSurfaceFlow, updateSurfaceFlow, refs]
-  );
-  const openSurfaceFlow = useCallback(
-    (input, flowInput = null, {
-      preserveUrl = false,
-      snapshot
-    } = {}) => {
-      const definition = createSurfaceFlowDefinition(input);
-      if (!definition) {
-        const error = createSurfaceError(
-          "DOCK_SURFACE_FLOW_INVALID_DEFINITION",
-          "Dock surface flow definition is invalid"
-        );
-        report("Dock surface flow definition", error);
-        return Promise.resolve({ success: false, error });
-      }
-      const existingSurfaceId = refs.flowIndex.get(definition.id);
-      if (definition.singleton && existingSurfaceId) {
-        return refs.records.get(existingSurfaceId)?.promise ?? Promise.resolve({
-          success: false,
-          error: createSurfaceError(
-            "DOCK_SURFACE_FLOW_ORPHANED",
-            "Dock surface flow is orphaned"
-          )
-        });
-      }
-      const flowSession = createSurfaceFlowSession(definition, {
-        input: flowInput,
-        snapshot
-      });
-      try {
-        const surfaceInput = definition.createSurface({
-          flowId: definition.id,
-          input: flowInput,
-          snapshot: flowSession?.snapshot
-        });
-        return openSurface(surfaceInput, { flowSession, preserveUrl });
-      } catch (error) {
-        report("Dock surface flow factory", error);
-        return Promise.resolve({ success: false, error });
-      }
-    },
-    [openSurface, refs]
-  );
-  const restoreSurfaceFlow = useCallback(
-    (input) => {
-      const definition = createSurfaceFlowDefinition(input);
-      const snapshot = getRestorableSurfaceFlowSnapshot(definition);
-      if (!definition || snapshot === void 0) return Promise.resolve(null);
-      return openSurfaceFlow(definition, null, { preserveUrl: true, snapshot });
-    },
-    [openSurfaceFlow]
-  );
+function toStyleSections(value) {
+  return toObject(value);
+}
+function mergeStyleSection(baseStyle, stateStyle, hoverStyle, section) {
   return {
-    cancelSurfaceFlow,
-    completeSurfaceFlow,
-    getSurfaceFlow,
-    openSurfaceFlow,
-    restoreSurfaceFlow,
-    updateSurfaceFlow
+    ...toObject(baseStyle?.[section]),
+    ...toObject(stateStyle?.[section]),
+    ...toObject(hoverStyle?.[section])
   };
 }
-function useSurfaceLifecycleEffects({
-  clearChoreographyTimers,
-  closeAllSurfaces,
-  focusRestoreFrameRef,
-  refs,
-  runtimeScheduler
-}) {
-  useEffect(() => {
-    if (!IS_BROWSER) return;
-    const handlePopState = () => {
-      const activeEntry = refs.stackRef.current[refs.stackRef.current.length - 1];
-      if (!activeEntry?.syncWithUrl && !activeEntry?.urlKey) return;
-      if (new URL(window.location.href).searchParams.get("surface") === getSurfaceUrlValue(activeEntry))
-        return;
-      closeAllSurfaces({
-        success: false,
-        cancelled: true,
-        reason: "browser-back"
-      });
-    };
-    window.addEventListener("popstate", handlePopState);
-    return () => window.removeEventListener("popstate", handlePopState);
-  }, [closeAllSurfaces, refs]);
-  useEffect(() => {
-    return () => {
-      clearChoreographyTimers();
-      if (focusRestoreFrameRef.current !== null) {
-        runtimeScheduler.cancel(focusRestoreFrameRef.current);
-        focusRestoreFrameRef.current = null;
-      }
-      const result = { cancelled: true, reason: "unmount", success: false };
-      refs.stackRef.current.forEach(
-        ({ id }) => releaseSurfaceResources({ refs, result, surfaceId: id })
-      );
-      refs.stackRef.current = [];
-      refs.payloads.clear();
-      refs.records.clear();
-      refs.flowIndex.clear();
-    };
-  }, [clearChoreographyTimers, focusRestoreFrameRef, refs, runtimeScheduler]);
+function resolveDockVisualStyle(style, {
+  isActive = false,
+  isHovered = false
+} = {}) {
+  const baseStyle = toObject(style);
+  const stateStyle = isActive ? toStyleSections(baseStyle.active) : toStyleSections(baseStyle.inactive);
+  const hoverStyle = isHovered ? toStyleSections(baseStyle.hover) : {};
+  const sections = {
+    card: {},
+    icon: {},
+    title: {},
+    description: {}
+  };
+  for (const section of DOCK_STYLE_SECTIONS) {
+    sections[section] = mergeStyleSection(
+      baseStyle,
+      stateStyle,
+      hoverStyle,
+      section
+    );
+  }
+  sections.card = { ...pickCardSurfaceStyle(baseStyle), ...sections.card };
+  return {
+    ...sections,
+    scale: hoverStyle?.card?.scale ?? stateStyle?.card?.scale ?? baseStyle?.scale
+  };
 }
-var SurfaceFlowContext = createContext(null);
-function SurfaceFlowProvider({
-  children,
-  value
-}) {
-  return /* @__PURE__ */ jsx(SurfaceFlowContext, { value, children });
+function useDockTheme() {
+  return useTheme(dockTheme);
 }
-function useSurfaceFlow(input) {
-  const context = use(SurfaceFlowContext);
-  const definition = useMemo(() => createSurfaceFlowDefinition(input), [input]);
-  const restoredFlowIdsRef = useRef(/* @__PURE__ */ new Set());
-  const flowId = definition?.id ?? null;
-  const activeFlow = useMemo(() => {
-    if (!flowId) return null;
-    return context?.surfaceState?.surfaceStack?.map((s) => s.flow).find((f) => f?.flowId === flowId) ?? null;
-  }, [context?.surfaceState?.surfaceStack, flowId]);
-  useEffect(() => {
-    if (!definition || !context?.restoreSurfaceFlow || restoredFlowIdsRef.current.has(definition.id))
-      return;
-    restoredFlowIdsRef.current.add(definition.id);
-    void context.restoreSurfaceFlow(definition);
-  }, [context, definition]);
-  const open = useCallback(
-    (flowInput = null) => {
-      if (!definition || !context?.openSurfaceFlow) {
-        return Promise.resolve({
-          success: false,
-          error: createSurfaceError(
-            "DOCK_SURFACE_FLOW_UNAVAILABLE",
-            "Dock surface flow is unavailable"
-          )
-        });
-      }
-      return context.openSurfaceFlow(definition, flowInput);
-    },
-    [context, definition]
+function useDockActionClass() {
+  const { slots } = useDockTheme();
+  return useCallback(
+    (options) => resolveDockActionClass(slots, options),
+    [slots]
+  );
+}
+function useDockRegistration(config, options) {
+  useModuleRegistration("dock", config, options);
+}
+function useDockBanner(banner, options) {
+  const position = options?.position;
+  const size = options?.size;
+  const opacity = options?.opacity;
+  const repeat = options?.repeat;
+  const targetPath = options?.path;
+  const config = useMemo(() => {
+    if (!banner) return null;
+    if (typeof banner === "string") {
+      return {
+        bannerUrl: banner,
+        ...position ? { bannerPosition: position } : {},
+        ...size ? { bannerSize: size } : {},
+        ...opacity !== void 0 ? { bannerOpacity: opacity } : {},
+        ...repeat ? { bannerRepeat: repeat } : {},
+        ...targetPath ? { path: targetPath } : {}
+      };
+    }
+    if (typeof banner === "object") {
+      return {
+        bannerUrl: banner.url || banner.bannerUrl,
+        bannerPosition: banner.position || banner.bannerPosition || position,
+        bannerSize: banner.size || banner.bannerSize || size,
+        bannerOpacity: banner.opacity ?? banner.bannerOpacity ?? opacity,
+        bannerRepeat: banner.repeat || banner.bannerRepeat || repeat,
+        ...targetPath ? { path: targetPath } : {}
+      };
+    }
+    return null;
+  }, [banner, position, size, opacity, repeat, targetPath]);
+  useDockRegistration(config, options);
+}
+var EMPTY_DOCK_STATE_STORE = createStore(EMPTY_DOCK_STATE);
+function selectDockConfigState(state) {
+  return {
+    activeItem: state.activeItem,
+    dockHeight: state.dockHeight,
+    expanded: state.expanded,
+    pathname: state.pathname
+  };
+}
+function useDockConfig(configOrTitle, options) {
+  const normalizedConfig = useMemo(() => {
+    if (!configOrTitle) return null;
+    if (typeof configOrTitle === "string") return { title: configOrTitle };
+    return configOrTitle;
+  }, [configOrTitle]);
+  useDockRegistration(normalizedConfig, options);
+  const dockContext = use(DockContext);
+  const actions = dockContext?.actions;
+  const state = useStore(
+    dockContext?.store ?? EMPTY_DOCK_STATE_STORE,
+    selectDockConfigState,
+    shallowEqual
   );
   return useMemo(
     () => ({
-      activeFlow,
-      cancel: (result = null) => flowId ? context?.cancelSurfaceFlow?.(flowId, result) : void 0,
-      complete: (result = null) => flowId ? context?.completeSurfaceFlow?.(flowId, result) : void 0,
-      flowId,
-      isOpen: activeFlow?.status === DOCK_SURFACE_FLOW_STATUS.OPEN,
-      open,
-      snapshot: activeFlow?.snapshot ?? definition?.initialSnapshot ?? null,
-      update: (snapshot) => flowId ? context?.updateSurfaceFlow?.(flowId, snapshot) : void 0
+      activeItem: state.activeItem,
+      clearHud: actions?.clearHud ?? (() => {
+      }),
+      closeAllSurfaces: actions?.closeAllSurfaces ?? (() => {
+      }),
+      closeSurface: actions?.closeSurface ?? (() => {
+      }),
+      expanded: state.expanded,
+      dockHeight: state.dockHeight,
+      navigate: actions?.navigate ?? (async () => false),
+      openSurface: actions?.openSurface ?? (() => void 0),
+      pathname: state.pathname,
+      setExpanded: actions?.setExpanded ?? (() => {
+      }),
+      setHud: actions?.setHud ?? (() => {
+      }),
+      setSearchQuery: actions?.setSearchQuery ?? (() => {
+      })
     }),
-    [activeFlow, context, definition?.initialSnapshot, flowId, open]
+    [actions, state]
+  );
+}
+function useDockDimensions() {
+  const { dockHeight } = useDockHeight();
+  const activeItem = useDockSelector((state) => state.activeItem);
+  return {
+    height: dockHeight,
+    width: activeItem?.width ?? null,
+    isSurface: Boolean(activeItem?.isSurface)
+  };
+}
+function useSurfaceReturn() {
+  const pathname = usePathname();
+  const { continuity } = useDockActions();
+  const dockReturnHandoffs = useDockSelector(
+    (state) => state.dockReturnHandoffs
+  );
+  const entries = useMemo(
+    () => (dockReturnHandoffs || []).filter(
+      (handoff) => isSamePath(handoff.path, pathname)
+    ),
+    [dockReturnHandoffs, pathname]
+  );
+  const consume = useCallback(
+    (handoffId = null) => continuity.consumeReturn(pathname, handoffId),
+    [continuity, pathname]
+  );
+  return useMemo(
+    () => ({ consume, entries, peek: () => entries[0] || null }),
+    [consume, entries]
+  );
+}
+
+// src/modules/dock/runtime/pipeline.ts
+function isSameDockItem(item, candidate) {
+  return Boolean(
+    item?.path && item.path === candidate?.path || item?.name && item.name === candidate?.name
+  );
+}
+var isSameItem = isSameDockItem;
+function getItemKey(link, index = 0) {
+  const identity = link?.id ?? link?.path ?? link?.name ?? link?.type;
+  return `dock-card:${identity == null ? `slot-${index}` : String(identity)}`;
+}
+function resolveDockHeaderKey({
+  link,
+  description = "",
+  showVideoIcon = false
+}) {
+  const statusPart = link?.isStatus ? `status:${link.statusType || link.type || "status"}` : "standard";
+  const identityPart = link?.path || link?.name || link?.id || "item";
+  const titlePart = link?.title || link?.name || "";
+  const descPart = description || "";
+  const iconPart = showVideoIcon ? "video" : link?.icon || "no-icon";
+  return `${statusPart}:${identityPart}:${iconPart}:${titlePart}:${descPart}`;
+}
+function findDockItemIndex(dockItems, activeItem, pathname) {
+  const normalizedPathname = normalizePath(pathname);
+  const selectedDataSourceIndex = dockItems.findIndex(
+    (item) => item.isDataSource && item.isSelected
+  );
+  if (selectedDataSourceIndex !== -1) return selectedDataSourceIndex;
+  if (activeItem) {
+    const matchedActiveIndex = dockItems.findIndex(
+      (item) => item.path && isSamePath(item.path, activeItem.path) || item.name && item.name === activeItem.name
+    );
+    if (matchedActiveIndex !== -1) return matchedActiveIndex;
+  }
+  return dockItems.findIndex(
+    (item) => isSamePath(item.path, normalizedPathname) || item.targetPath && isSamePath(item.targetPath, normalizedPathname)
   );
 }
-var DockSurfaceHeaderRadiusContext = createContext(
-  null
-);
-function useDockSurfaceHeaderButtonModel({
-  children,
-  className = "",
-  disabled = false,
-  onClick,
-  ariaLabel,
-  icon = null
+function resolveActiveIndex({
+  dockItems,
+  activeItem,
+  pathname
 }) {
-  const contextRadius = use(DockSurfaceHeaderRadiusContext);
-  return { contextRadius };
+  return Math.max(0, findDockItemIndex(dockItems, activeItem, pathname));
 }
-function useDockSurfaceControlsModel({
-  activeItem = null,
-  hasExtensions = false,
-  onClose = null,
-  onBack = null,
-  closeLabel = null,
-  backLabel = null,
-  className = "",
-  surfacePhase: propSurfacePhase
-}) {
-  const phase = propSurfacePhase ?? activeItem?.surfacePhase;
-  const isBodyVisible = phase ? phase === DOCK_SURFACE_PHASE.EXPANDING_BODY || phase === DOCK_SURFACE_PHASE.OPEN : true;
-  const actionStore = use(SurfaceExtensionsContext)?.headerActions ?? null;
-  const surfaceId = activeItem?.surfaceId || "global";
-  const subscribeAction = useCallback(
-    (onStoreChange) => actionStore ? actionStore.subscribe(onStoreChange) : () => {
-    },
-    [actionStore]
-  );
-  const getActionSnapshot = useCallback(
-    () => actionStore ? actionStore.getAction(surfaceId) : null,
-    [actionStore, surfaceId]
+function shouldKeepAncestorItem(item, activePath) {
+  const policy = item?.keepWhenDescendant;
+  if (typeof policy === "function") {
+    try {
+      return Boolean(policy(activePath, item));
+    } catch {
+      return false;
+    }
+  }
+  return policy === true;
+}
+function isAncestorPath(item, activePath) {
+  const candidatePath = item?.path;
+  if (!candidatePath || candidatePath === "/" || candidatePath === activePath) {
+    return false;
+  }
+  return isPathPrefix(candidatePath, activePath) && !shouldKeepAncestorItem(item, activePath);
+}
+function removeAncestorDuplicates(items = []) {
+  if (!Array.isArray(items) || items.length <= 1) return items;
+  const activePath = items[0]?.path;
+  if (!activePath) return items;
+  return items.filter(
+    (item, index) => index === 0 || !isAncestorPath(item, activePath)
   );
-  const dynamicAction = useSyncExternalStore(
-    subscribeAction,
-    getActionSnapshot,
-    () => null
+}
+function replaceActiveItem(items, activeIndex, activeItem) {
+  if (activeIndex === -1 || !activeItem) return items;
+  const nextItems = [...items];
+  nextItems[activeIndex] = activeItem;
+  return nextItems;
+}
+function removeInactiveLoadingItems(items = [], activeItem = null) {
+  if (!Array.isArray(items) || items.length === 0) return items;
+  return items.filter(
+    (item) => !item?.isLoading || isSameItem(item, activeItem)
   );
-  return { isBodyVisible, dynamicAction };
 }
-function SurfaceExtensionsProvider({
-  children
-}) {
-  const [value] = useState(() => ({
-    extensions: new SurfaceExtensionsStore(),
-    headerActions: new SurfaceHeaderActionStore()
-  }));
-  return /* @__PURE__ */ jsx(SurfaceExtensionsContext, { value, children });
+function reorderItemsWithActiveFirst(items, activeIndex) {
+  if (activeIndex === -1) return items;
+  const active = items[activeIndex];
+  const rest = [
+    ...items.slice(0, activeIndex),
+    ...items.slice(activeIndex + 1)
+  ];
+  rest.sort((a, b) => a.path === "/" ? 1 : b.path === "/" ? -1 : 0);
+  return [active, ...rest];
 }
-function useDockSurfaceExtension({
-  align = "left",
-  children,
-  className = "",
-  id,
-  order = 0,
-  unstyled = false
+function shouldRenderInlineAction({
+  action,
+  isLoading,
+  isOverlay,
+  path
+}, pathname) {
+  return Boolean(action) && !isLoading && (isOverlay || !path || isInlineActionPathMatch(path, pathname));
+}
+function getIsItemActive(link, activeItem) {
+  if (!link || !activeItem) return false;
+  if (link.path && activeItem.path && isSamePath(link.path, activeItem.path))
+    return true;
+  if (link.targetPath && activeItem.targetPath && isSamePath(link.targetPath, activeItem.targetPath))
+    return true;
+  return Boolean(link.name && activeItem.name && link.name === activeItem.name);
+}
+function getViewportMaxHeight() {
+  if (typeof window === "undefined") return Infinity;
+  return window.innerHeight - VIEWPORT_MARGIN;
+}
+function getContainerHeight({
+  cardContentHeight,
+  isHud = false
 }) {
-  const store = use(SurfaceExtensionsContext)?.extensions ?? null;
-  const surfaceId = useSurfaceId();
-  const generatedId = useId();
-  const effectiveId = id || `dock-surface-ext-${generatedId}`;
-  useEffect(() => {
-    if (!store) return;
-    store.setExtension(surfaceId, {
-      align,
-      className,
-      content: children,
-      id: effectiveId,
-      order,
-      unstyled
+  const chromeHeight = DOCK_CARD_LAYOUT.chromeHeight;
+  const minCardHeight = isHud ? DOCK_CARD_LAYOUT.hudHeight : DOCK_CARD_LAYOUT.baseHeight;
+  const numericContentHeight = Number(cardContentHeight);
+  const nextCardHeight = Math.max(
+    minCardHeight,
+    (Number.isFinite(numericContentHeight) ? numericContentHeight : 0) + chromeHeight
+  );
+  return Math.min(nextCardHeight, getViewportMaxHeight());
+}
+function getDockCardWidth({
+  width
+} = {}) {
+  if (typeof window === "undefined") return width ? Number(width) || 460 : 460;
+  const windowWidth = window.innerWidth;
+  const isDesktop = windowWidth >= 640;
+  const targetWidth = Number(width);
+  if (Number.isFinite(targetWidth) && targetWidth > 0) {
+    return Math.min(
+      targetWidth,
+      Math.max(windowWidth - (isDesktop ? 32 : 16), 0)
+    );
+  }
+  return Math.min(460, Math.max(windowWidth - 16, 0));
+}
+function getObservedHeight(entry, element) {
+  const rawBorderBoxSize = entry?.borderBoxSize;
+  const borderBoxSize = Array.isArray(rawBorderBoxSize) ? rawBorderBoxSize[0] : rawBorderBoxSize;
+  if (borderBoxSize?.blockSize != null) {
+    return Math.round(borderBoxSize.blockSize);
+  }
+  if (entry?.contentRect?.height != null) {
+    return Math.round(entry.contentRect.height);
+  }
+  return Math.round(element?.offsetHeight || 0);
+}
+function hasMeaningfulHeightChange(previousHeight, nextHeight) {
+  return Math.abs(Math.round(nextHeight) - Math.round(previousHeight)) > HEIGHT_EPSILON;
+}
+function useElementHeight(onHeightChange, elementRef, shouldMeasure, dependencyKey = null) {
+  const lastHeightRef = useRef(0);
+  const rafRef = useRef(null);
+  const callbackRef = useRef(onHeightChange);
+  useIsomorphicLayoutEffect(() => {
+    callbackRef.current = onHeightChange;
+  }, [onHeightChange]);
+  useIsomorphicLayoutEffect(() => {
+    if (rafRef.current !== null) {
+      cancelAnimationFrame(rafRef.current);
+      rafRef.current = null;
+    }
+    lastHeightRef.current = -1;
+    if (!callbackRef.current) return;
+    if (!shouldMeasure) {
+      if (hasMeaningfulHeightChange(lastHeightRef.current, 0)) {
+        lastHeightRef.current = 0;
+        callbackRef.current(0);
+      }
+      return;
+    }
+    const element = elementRef?.current;
+    if (!element) return;
+    function publishHeight(nextHeight) {
+      if (!hasMeaningfulHeightChange(lastHeightRef.current, nextHeight)) return;
+      lastHeightRef.current = nextHeight;
+      callbackRef.current?.(nextHeight);
+    }
+    let pendingHeight = null;
+    function flushPendingHeight() {
+      rafRef.current = null;
+      if (pendingHeight == null) return;
+      const heightToPublish = pendingHeight;
+      pendingHeight = null;
+      publishHeight(heightToPublish);
+    }
+    function scheduleMeasurement(nextHeight) {
+      pendingHeight = nextHeight;
+      if (rafRef.current !== null) return;
+      rafRef.current = requestAnimationFrame(flushPendingHeight);
+    }
+    publishHeight(element.offsetHeight || 0);
+    const observer = new ResizeObserver((entries) => {
+      for (const entry of entries) {
+        scheduleMeasurement(getObservedHeight(entry, element));
+      }
     });
-  });
-  useEffect(() => {
+    observer.observe(element);
+    const handlePageShow = () => scheduleMeasurement(element.offsetHeight || 0);
+    const handleVisibilityChange = () => {
+      if (document.visibilityState === "visible") handlePageShow();
+    };
+    window.addEventListener("pageshow", handlePageShow);
+    document.addEventListener("visibilitychange", handleVisibilityChange);
     return () => {
-      if (store) store.removeExtension(surfaceId, effectiveId);
+      observer.disconnect();
+      window.removeEventListener("pageshow", handlePageShow);
+      document.removeEventListener("visibilitychange", handleVisibilityChange);
+      if (rafRef.current !== null) {
+        cancelAnimationFrame(rafRef.current);
+        rafRef.current = null;
+      }
     };
-  }, [store, surfaceId, effectiveId]);
+  }, [dependencyKey, elementRef, shouldMeasure]);
 }
-function useIsSurfaceExtensionsVisible(activeItem) {
-  const store = use(SurfaceExtensionsContext)?.extensions ?? null;
-  const surfaceId = activeItem?.surfaceId || "global";
-  const isSurface = Boolean(activeItem?.isSurface);
-  const phase = activeItem?.surfacePhase;
-  const isBodyVisible = phase === DOCK_SURFACE_PHASE.EXPANDING_BODY || phase === DOCK_SURFACE_PHASE.OPEN;
-  const subscribe2 = useCallback(
-    (onStoreChange) => store ? store.subscribe(onStoreChange) : () => {
-    },
-    [store]
-  );
-  const getSnapshot2 = useCallback(
-    () => store ? store.getExtensionsForSurface(surfaceId).length : 0,
-    [store, surfaceId]
-  );
-  const dynamicCount = useSyncExternalStore(subscribe2, getSnapshot2, () => 0);
-  const descriptorCount = useMemo(() => {
-    const raw = activeItem?.surfaceExtensions || activeItem?.extensions || [];
-    return Array.isArray(raw) ? raw.length : 0;
-  }, [activeItem?.surfaceExtensions, activeItem?.extensions]);
-  return Boolean(
-    isSurface && isBodyVisible && (dynamicCount > 0 || descriptorCount > 0)
+function publishDockHeightCssVar(heightPx) {
+  if (typeof document === "undefined") return;
+  document.documentElement.style.setProperty(
+    "--dock-h",
+    `${Math.round(heightPx)}px`
   );
 }
-function useDockSurfaceExtensionsBarModel({
-  activeItem
+function useDockHeightController({
+  contentKey = null,
+  isHud = false,
+  setDockHeight,
+  surfacePhase = DOCK_SURFACE_PHASE.IDLE
 }) {
-  const store = use(SurfaceExtensionsContext)?.extensions ?? null;
-  const surfaceId = activeItem?.surfaceId || "global";
-  const subscribe2 = useCallback(
-    (onStoreChange) => store ? store.subscribe(onStoreChange) : () => {
-    },
-    [store]
-  );
-  const getSnapshot2 = useCallback(
-    () => store ? store.getExtensionsForSurface(surfaceId) : [],
-    [store, surfaceId]
+  const [containerHeight, setContainerHeight] = useState(
+    isHud ? DOCK_CARD_LAYOUT.hudHeight : DOCK_CARD_LAYOUT.baseHeight
   );
-  const dynamicExtensions = useSyncExternalStore(
-    subscribe2,
-    getSnapshot2,
-    () => []
+  const heightRef = useRef({ content: 0 });
+  const rafRef = useRef(null);
+  const isHudRef = useRef(isHud);
+  const surfacePhaseRef = useRef(surfacePhase);
+  const lastAppliedContainerHeightRef = useRef(
+    isHud ? DOCK_CARD_LAYOUT.hudHeight : DOCK_CARD_LAYOUT.baseHeight
   );
-  const descriptorExtensions = useMemo(() => {
-    const raw = activeItem?.surfaceExtensions || activeItem?.extensions || [];
-    return Array.isArray(raw) ? raw.map(normalizeSurfaceExtension).filter((ext) => ext !== null) : [];
-  }, [activeItem?.surfaceExtensions, activeItem?.extensions]);
-  const allExtensions = useMemo(() => {
-    const map = /* @__PURE__ */ new Map();
-    descriptorExtensions.forEach((ext) => map.set(ext.id, ext));
-    dynamicExtensions.forEach((ext) => map.set(ext.id, ext));
-    return Array.from(map.values()).sort((a, b) => a.order - b.order);
-  }, [descriptorExtensions, dynamicExtensions]);
-  return { allExtensions };
-}
-var DRAG_RANGE = [...DOCK_SURFACE_DRAG_INTERPOLATION.DRAG_RANGE];
-var OPACITY_RANGE = [...DOCK_SURFACE_DRAG_INTERPOLATION.OPACITY_RANGE];
-var SCALE_RANGE = [...DOCK_SURFACE_DRAG_INTERPOLATION.SCALE_RANGE];
-function useDockSurfaceShellModel({
-  ref,
-  title = "",
-  onClose = null,
-  onBack = null,
-  allowSwipeDismiss = true,
-  closeLabel = "Close surface",
-  backLabel = "Previous step",
-  showControls = false,
-  className = "",
-  contentClassName = "",
-  children,
-  onAnimationComplete = null,
-  isActive = true,
-  surfaceId = null,
-  surfacePhase = DOCK_SURFACE_PHASE.OPEN,
-  surfaceWidth = null
-}) {
-  const surfaceElementRef = useRef(null);
-  const setSurfaceElementRef = useCallback(
-    (node) => {
-      surfaceElementRef.current = node;
-      if (typeof ref === "function") ref(node);
-      else if (ref) ref.current = node;
-    },
-    [ref]
+  const lastAppliedSpacerHeightRef = useRef(
+    (isHud ? DOCK_CARD_LAYOUT.hudHeight : DOCK_CARD_LAYOUT.baseHeight) + DOCK_HEIGHT_BUFFER
   );
-  const isFullyOpen = surfacePhase === DOCK_SURFACE_PHASE.OPEN;
-  const titleId = surfaceId == null ? void 0 : `dock-surface-title-${surfaceId}`;
-  const dragY = useMotionValue(0);
-  const dragOpacity = useTransform(dragY, DRAG_RANGE, OPACITY_RANGE);
-  const dragScale = useTransform(dragY, DRAG_RANGE, SCALE_RANGE);
-  useDockFocusTrap({
-    containerRef: surfaceElementRef,
-    enabled: isActive && isFullyOpen,
-    onDismiss: typeof onClose === "function" ? onClose : null
-  });
-  const handleDragEnd = (_event, info) => {
-    if (!isActive || !allowSwipeDismiss || typeof onClose !== "function" || !isFullyOpen)
-      return;
-    if (info.offset.y > DOCK_SURFACE_DRAG_THRESHOLDS.DISMISS_OFFSET_Y || info.velocity.y > DOCK_SURFACE_DRAG_THRESHOLDS.DISMISS_VELOCITY_Y) {
-      onClose();
+  useIsomorphicLayoutEffect(() => {
+    isHudRef.current = isHud;
+    surfacePhaseRef.current = surfacePhase;
+  }, [isHud, surfacePhase]);
+  const applyHeight = useCallback(() => {
+    if (rafRef.current !== null) {
+      cancelAnimationFrame(rafRef.current);
+      rafRef.current = null;
     }
-  };
-  const dragControls = useDragControls();
-  const canDragDismiss = Boolean(
-    isActive && allowSwipeDismiss && typeof onClose === "function" && isFullyOpen
-  );
-  const handleSurfacePointerDown = useCallback(
-    (event) => {
-      if (!canDragDismiss) return;
-      const target = event.target;
-      if (target?.closest?.(
-        'input, textarea, select, [role="slider"], [data-no-surface-drag], [data-lenis-prevent]'
-      )) {
-        return;
-      }
-      dragControls.start(event);
+    const { content } = heightRef.current;
+    const currentPhase = surfacePhaseRef.current;
+    const isLockedToBaseHeight = currentPhase === DOCK_SURFACE_PHASE.DISMISSING_ACTION || currentPhase === DOCK_SURFACE_PHASE.COLLAPSING_BODY || currentPhase === DOCK_SURFACE_PHASE.RESTORING_HEADER;
+    const computedContentHeight = isLockedToBaseHeight ? 0 : content;
+    const height = getContainerHeight({
+      cardContentHeight: computedContentHeight,
+      isHud: isHudRef.current
+    });
+    const totalSpacerHeight = height + DOCK_HEIGHT_BUFFER;
+    if (Math.abs(height - lastAppliedContainerHeightRef.current) > 0.5) {
+      lastAppliedContainerHeightRef.current = height;
+      setContainerHeight(height);
+    }
+    if (Math.abs(totalSpacerHeight - lastAppliedSpacerHeightRef.current) > 0.5) {
+      lastAppliedSpacerHeightRef.current = totalSpacerHeight;
+      publishDockHeightCssVar(totalSpacerHeight);
+      setDockHeight(totalSpacerHeight);
+    }
+  }, [setDockHeight]);
+  const handleContentHeightChange = useCallback(
+    (height) => {
+      const numericHeight = Number(height);
+      heightRef.current.content = Number.isFinite(numericHeight) ? Math.max(0, numericHeight) : 0;
+      applyHeight();
     },
-    [canDragDismiss, dragControls]
-  );
-  const isBodyVisible = surfacePhase === DOCK_SURFACE_PHASE.EXPANDING_BODY || surfacePhase === DOCK_SURFACE_PHASE.OPEN;
-  const resolvedSurfaceId = surfaceId || "active";
-  const bodyVariants = useMemo(
-    () => ({
-      hidden: dockSurfaceBodyRole.hidden,
-      visible: {
-        ...dockSurfaceBodyRole.visible,
-        transition: surfacePhase === DOCK_SURFACE_PHASE.EXPANDING_BODY ? DOCK_SURFACE_BODY_ENTER_TRANSITION : DOCK_SURFACE_BODY_STEP_TRANSITION
-      },
-      exit: {
-        ...dockSurfaceBodyRole.exit,
-        transition: DOCK_SURFACE_BODY_EXIT_TRANSITION
-      }
-    }),
-    [surfacePhase]
-  );
-  const surfaceItemValue = useMemo(
-    () => ({ id: resolvedSurfaceId, width: surfaceWidth }),
-    [resolvedSurfaceId, surfaceWidth]
+    [applyHeight]
   );
-  return {
-    setSurfaceElementRef,
-    titleId,
-    dragY,
-    dragOpacity,
-    dragScale,
-    handleDragEnd,
-    dragControls,
-    canDragDismiss,
-    handleSurfacePointerDown,
-    isBodyVisible,
-    bodyVariants,
-    surfaceItemValue
-  };
+  useEffect(() => {
+    return () => {
+      if (rafRef.current !== null) cancelAnimationFrame(rafRef.current);
+    };
+  }, []);
+  useIsomorphicLayoutEffect(() => applyHeight(), [applyHeight, contentKey]);
+  useIsomorphicLayoutEffect(() => applyHeight(), [applyHeight, surfacePhase]);
+  useIsomorphicLayoutEffect(() => applyHeight(), [applyHeight, isHud]);
+  return { containerHeight, handleContentHeightChange };
+}
+function isSurfaceShapePhase(phase) {
+  return phase === DOCK_SURFACE_PHASE.EXPANDING_BODY || phase === DOCK_SURFACE_PHASE.OPEN || phase === DOCK_SURFACE_PHASE.CLOSING_ANTICIPATION;
+}
+function getTargetItemWidth(activeItem) {
+  if (!activeItem?.isSurface || isSurfaceShapePhase(activeItem.surfacePhase)) {
+    return activeItem?.width;
+  }
+  return activeItem.restingWidth;
+}
+function useDockViewport(activeItem = null) {
+  const targetWidth = getTargetItemWidth(activeItem);
+  const [, setViewportRevision] = useState(0);
+  const [portalTarget, setPortalTarget] = useState(null);
+  const stackWidth = getDockCardWidth({ width: targetWidth });
+  useIsomorphicLayoutEffect(() => {
+    if (typeof document !== "undefined") setPortalTarget(document.body);
+  }, []);
+  useEffect(() => {
+    if (typeof window === "undefined") return void 0;
+    let resizeFrameId = null;
+    const handleResize = () => {
+      if (resizeFrameId !== null) return;
+      resizeFrameId = window.requestAnimationFrame(() => {
+        resizeFrameId = null;
+        setViewportRevision((revision) => revision + 1);
+      });
+    };
+    window.addEventListener("resize", handleResize, { passive: true });
+    return () => {
+      window.removeEventListener("resize", handleResize);
+      if (resizeFrameId !== null) window.cancelAnimationFrame(resizeFrameId);
+    };
+  }, []);
+  return { portalTarget, stackWidth };
+}
+function getItemMeasurementKey({
+  link,
+  expanded,
+  isHud = false
+}) {
+  const state = isHud ? "hud" : link.isLoading ? "loading" : link.isSurface ? `surface-${link.surfacePhase ?? "open"}` : "standard";
+  return `${link.path || link.name || "item"}:${state}:${expanded ? "expanded" : "collapsed"}`;
+}
+function getRouteMeasurementKey(pathname, key) {
+  return `${pathname || ""}:${key}`;
 }
 function createDockGuardRegistry() {
   const guards = /* @__PURE__ */ new Map();
@@ -8687,7 +8732,7 @@ function useDockOperationState() {
   );
   const operationIdRef = useRef(0);
   const operationStateRef = useRef(operationState);
-  useInsertionEffect(() => {
+  useIsomorphicLayoutEffect(() => {
     operationStateRef.current = operationState;
   }, [operationState]);
   const start = useCallback((input = {}) => {
@@ -8752,13 +8797,10 @@ function useDockOperationState() {
     [operationState.entries]
   );
   const operationHud = useMemo(
-    () => (
-      // eslint-disable-next-line react-hooks/refs
-      createDockOperationHud(activeOperation, {
-        onCancel: cancel,
-        pendingCount
-      })
-    ),
+    () => createDockOperationHud(activeOperation, {
+      onCancel: cancel,
+      pendingCount
+    }),
     [activeOperation, cancel, pendingCount]
   );
   return { activeOperation, operationActions, operationHud, operationState };
@@ -11149,7 +11191,7 @@ function useSurfaceStack({
   const surfacePhaseRef = useRef(DOCK_SURFACE_PHASE.IDLE);
   const transitionRunnerRef = useRef(null);
   const onSurfaceFlowSettledRef = useRef(onSurfaceFlowSettled);
-  useInsertionEffect(() => {
+  useIsomorphicLayoutEffect(() => {
     onSurfaceFlowSettledRef.current = onSurfaceFlowSettled;
   }, [onSurfaceFlowSettled]);
   const clearChoreographyTimers = useCallback(() => {
@@ -12045,7 +12087,7 @@ function useDockPage(slice, page) {
   useDockGuard(slice?.guard ?? NO_GUARD);
   useDockContextActions(slice?.actions ?? NO_ACTIONS);
   const surfacesRef = useRef(slice?.surfaces);
-  useInsertionEffect(() => {
+  useIsomorphicLayoutEffect(() => {
     surfacesRef.current = slice?.surfaces;
   }, [slice?.surfaces]);
   return useMemo(
@@ -12086,6 +12128,6 @@ var dockModule = defineModule({
   }
 });
 
-export { DOCK_EVENTS, DOCK_FADE_TRANSITION, DOCK_HUD_PRIORITY, DOCK_HUD_RENDER_MODE, DOCK_HUD_VARIANT, Dock, DockCardBanner, DockCardHeader, DockDescription, DockIcon, DockProvider, DockSurfaceAction, DockSurfaceExtension, DockSurfaceHeaderButton, DockTitle, ErrorActions, GuardActions, createDockGuardRegistry, createErrorStatus, createGuardStatus, createInlineSurfaceEntry, createSurfaceEntryDefinition, createSurfaceFlowBuilder, defineBreadcrumb, defineDockAction, defineHud, defineStepSurface, defineSurface, dockFadeVariants, dockListItemVariants, dockModule, dockTheme, isValidBannerUrl, textCrossfadeVariants, useDock, useDockActionClass, useDockActions, useDockBanner, useDockConfig, useDockContextActions, useDockDimensions, useDockGuard, useDockHeight, useDockHud, useDockRegistration, useDockSelector, useDockState, useHud, useOptionalDockActions, useOptionalDockState, useSurface, useSurfaceAction, useSurfaceDimensions, useSurfaceFlow, useSurfaceHeader, useSurfaceId, useSurfaceReturn, useSurfaceStep };
+export { DOCK_EVENTS, DOCK_FADE_TRANSITION, DOCK_HUD_PRIORITY, DOCK_HUD_RENDER_MODE, DOCK_HUD_VARIANT, Dock, DockCardBanner, DockCardHeader, DockDescription, DockIcon, DockProvider, DockSurfaceAction, DockSurfaceExtension, DockSurfaceHeaderButton, DockTitle, ErrorActions, GuardActions, createDockGuardRegistry, createErrorStatus, createGuardStatus, createInlineSurfaceEntry, createSurfaceEntryDefinition, createSurfaceFlowBuilder, defineBreadcrumb, defineDockAction, defineHud, defineStepSurface, defineSurface, dockFadeVariants, dockListItemVariants, dockModule, dockTheme, isValidBannerUrl, textCrossfadeVariants, useDock, useDockActionClass, useDockActions, useDockBanner, useDockConfig, useDockContextActions, useDockDimensions, useDockGuard, useDockHeight, useDockHud, useDockRegistration, useDockSelector, useDockState, useDockTheme, useHud, useOptionalDockActions, useOptionalDockState, useSurface, useSurfaceAction, useSurfaceDimensions, useSurfaceFlow, useSurfaceHeader, useSurfaceId, useSurfaceReturn, useSurfaceStep };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map