@omerdlw/base-framework 1.0.1 → 1.0.3

package/dist/modules/dock/index.js

@@ -14,9 +14,6 @@ function cn(...inputs) {
   return twMerge(clsx(inputs));
 }
 
-// src/utils/dom.ts
-var isBrowser = typeof window !== "undefined";
-
 // src/utils/string.ts
 function trimToNull(value) {
   if (value === null || value === void 0) return null;
@@ -37,6 +34,9 @@ function isImageIconSource(icon) {
   return typeof icon === "string" && (icon.startsWith("http://") || icon.startsWith("https://") || icon.startsWith("/") || icon.startsWith("data:image/"));
 }
 
+// src/utils/dom.ts
+var isBrowser = typeof window !== "undefined";
+
 // src/utils/number.ts
 function clamp(value, min, max) {
   const num = Number(value);
@@ -423,68 +423,58 @@ function Button({
   );
 }
 Button.displayName = "Button";
-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 emitChange() {
-  listeners.forEach((listener) => listener());
-}
-function emitIfSnapshotChanged() {
-  const nextSnapshot = getDomSnapshot();
-  if (nextSnapshot === lastSnapshot) {
-    return;
-  }
-  lastSnapshot = nextSnapshot;
-  emitChange();
-}
-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 releaseDomObserver() {
-  if (listeners.size > 0 || !domObserver) {
-    return;
-  }
-  domObserver.disconnect();
-  domObserver = null;
-}
-function subscribe(listener) {
-  listeners.add(listener);
-  ensureDomObserver();
-  emitIfSnapshotChanged();
-  return () => {
-    listeners.delete(listener);
-    releaseDomObserver();
-  };
-}
-function getSnapshot() {
-  return getDomSnapshot();
-}
-function useIsFullscreenStateActive() {
-  return useSyncExternalStore(subscribe, getSnapshot, () => false);
-}
+
+// 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;
@@ -494,723 +484,104 @@ function getOrCreateGlobalContext(name, defaultValue) {
   return store[sym];
 }
 
-// src/theme.tsx
-function defineThemeSpec(id) {
-  return Object.freeze({ id });
+// src/kernel/utils.ts
+function parseFiniteNumber(value) {
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : null;
 }
-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. Add its theme file to src/config/ and list it in src/config/index.ts.`
+function getValidString(value, fallback = null) {
+  return trimToNull(value) ?? fallback;
+}
+
+// src/kernel/schema.ts
+function resolveLifecycle(metadata, fallback) {
+  const lifecycle = metadata?.lifecycle ?? metadata?.cleanup;
+  return lifecycle && REGISTRY_LIFECYCLE_VALUES.has(lifecycle) ? lifecycle : fallback;
+}
+function validateRegistryMetadata(metadata) {
+  if (metadata === void 0 || metadata === null)
+    return { issues: [], valid: true };
+  if (!isObject(metadata))
+    return { issues: ["registry metadata must be an object"], valid: false };
+  const issues = [];
+  Object.keys(metadata).forEach((key) => {
+    if (!REGISTRY_METADATA_KEY_SET.has(key))
+      issues.push(`unknown registry metadata field: ${key}`);
+  });
+  if (metadata.source !== void 0 && !getValidString(metadata.source))
+    issues.push("source must be a non-empty string");
+  if (metadata.instanceId !== void 0 && !getValidString(metadata.instanceId))
+    issues.push("instanceId must be a non-empty string");
+  if (metadata.scope !== void 0 && !getValidString(metadata.scope))
+    issues.push("scope must be a non-empty string");
+  if (metadata.priority !== void 0 && parseFiniteNumber(metadata.priority) === null)
+    issues.push("priority must be a finite number");
+  if (metadata.cleanupDelayMs !== void 0) {
+    const delay = parseFiniteNumber(metadata.cleanupDelayMs);
+    if (delay === null || delay < 0)
+      issues.push("cleanupDelayMs must be a non-negative finite number");
+  }
+  const lifecycle = metadata.lifecycle ?? metadata.cleanup;
+  if (lifecycle !== void 0 && !REGISTRY_LIFECYCLE_VALUES.has(String(lifecycle))) {
+    issues.push(
+      `lifecycle must be one of: ${[...REGISTRY_LIFECYCLE_VALUES].join(", ")}`
+    );
+  }
+  if (metadata.validation !== void 0 && !Object.values(REGISTRY_VALIDATION_MODES).includes(
+    metadata.validation
+  )) {
+    issues.push(
+      `validation must be one of: ${Object.values(REGISTRY_VALIDATION_MODES).join(", ")}`
     );
   }
+  return { issues, valid: issues.length === 0 };
+}
+function normalizeRegistryMetadata(metadata, {
+  defaultCleanupDelayMs = null,
+  defaultLifecycle = null,
+  defaultSource = DEFAULT_SOURCE
+} = {}) {
+  const registryMeta = isObject(metadata) ? metadata : {};
+  const normalizedDefaultDelay = parseFiniteNumber(defaultCleanupDelayMs);
+  const fallbackCleanupDelayMs = normalizedDefaultDelay !== null && normalizedDefaultDelay >= 0 ? normalizedDefaultDelay : null;
+  const fallbackLifecycle = defaultLifecycle && REGISTRY_LIFECYCLE_VALUES.has(defaultLifecycle) ? defaultLifecycle : null;
+  const source = getValidString(registryMeta.source) || getValidString(defaultSource, DEFAULT_SOURCE) || DEFAULT_SOURCE;
+  const scope = getValidString(registryMeta.scope);
+  const priority = parseFiniteNumber(registryMeta.priority);
+  const lifecycle = resolveLifecycle(registryMeta, fallbackLifecycle);
+  const validation = isValidationMode(registryMeta.validation) ? registryMeta.validation : null;
+  const cleanupDelayCandidate = parseFiniteNumber(registryMeta.cleanupDelayMs);
+  let cleanupDelayMs = cleanupDelayCandidate !== null && cleanupDelayCandidate >= 0 ? cleanupDelayCandidate : fallbackCleanupDelayMs;
+  if (lifecycle === REGISTRY_LIFECYCLES.IMMEDIATE) {
+    cleanupDelayMs = 0;
+  } else if ((lifecycle === REGISTRY_LIFECYCLES.GRACEFUL || lifecycle === REGISTRY_LIFECYCLES.ROUTE) && cleanupDelayMs === null) {
+    cleanupDelayMs = fallbackCleanupDelayMs;
+  }
   return {
-    slots: config.slots,
-    styles: config.styles ?? {}
+    cleanupDelayMs,
+    lifecycle,
+    priority,
+    registerOptions: {
+      ...priority !== null && { priority },
+      ...validation === REGISTRY_VALIDATION_MODES.STRICT && { validation },
+      ...scope && { scope }
+    },
+    source,
+    ...scope && { scope },
+    ...validation && { validation }
   };
 }
-
-// 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/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;
-  }
-  if (isValidElement(value)) {
-    if (visitedObjects.has(value)) return "";
-    visitedObjects.add(value);
-    const text = collectSearchableText(
-      value.props?.children,
-      visitedObjects
-    );
-    visitedObjects.delete(value);
-    return text;
-  }
-  if (value && typeof value === "object") {
-    if (visitedObjects.has(value)) return "";
-    visitedObjects.add(value);
-    return Object.values(value).map((entry) => collectSearchableText(entry, visitedObjects)).join(" ");
-  }
-  return "";
-}
-function toSearchableText(value) {
-  return collectSearchableText(value, /* @__PURE__ */ new WeakSet());
-}
-function normalizeUpper(value) {
-  return String(value || "").trim().toUpperCase();
-}
-function splitStyle(style = {}) {
-  const { className, ...inlineStyle } = style;
-  return {
-    className,
-    inlineStyle
-  };
-}
-function getLineClampStyle(maxLines, style) {
-  if (Number(maxLines) <= 1) return style;
-  return {
-    WebkitBoxOrient: "vertical",
-    WebkitLineClamp: maxLines,
-    display: "-webkit-box",
-    overflow: "hidden",
-    ...style
-  };
-}
-function getImageIconStyle(style, icon) {
-  const nextStyle = {
-    ...style
-  };
-  delete nextStyle.background;
-  delete nextStyle.backgroundImage;
-  return {
-    ...nextStyle,
-    backgroundImage: `url(${icon})`
-  };
-}
-function resolveDockActionClass(slots, {
-  className = "",
-  button = "",
-  isActive = false,
-  variant = "",
-  tone = "",
-  base,
-  cn: classNamesFn
-} = {}) {
-  const resolve = classNamesFn || cn;
-  const toneClasses = {
-    muted: slots.actionMuted,
-    active: slots.actionActive
-  };
-  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 closestMatches(target, selector) {
-  const element = target;
-  return Boolean(
-    element && typeof element.closest === "function" && element.closest(selector)
-  );
-}
-function isInteractiveTarget(target) {
-  return closestMatches(
-    target,
-    'button, a, input, textarea, select, [role="button"], [tabindex]:not([tabindex="-1"])'
-  );
-}
-function isEditableDockTarget(target) {
-  return closestMatches(
-    target,
-    'input, textarea, select, [contenteditable="true"]'
-  );
-}
-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 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 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 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)
-  );
-}
-function resolveActiveIndex({
-  dockItems,
-  activeItem,
-  pathname
-}) {
-  return Math.max(0, findDockItemIndex(dockItems, activeItem, pathname));
-}
-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)
-  );
-}
-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)
-  );
-}
-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 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 isSurfaceDescriptor(value) {
-  return value != null && typeof value === "object" && !Array.isArray(value) && !isValidElement(value);
-}
-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
-    };
-  }
-  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 normalizeSurfaceFlowSnapshot(value) {
-  if (!isPlainObject(value)) return null;
-  return { ...value };
-}
-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
-  };
-}
-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 createDockScheduler(options = {}) {
-  return createScheduler({
-    defaultLabel: "dock-task",
-    ...options
-  });
-}
-
-// 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]
-  );
-}
-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]);
-}
-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
-    );
-    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();
-  };
-};
+function isValidationMode(value) {
+  return Object.values(REGISTRY_VALIDATION_MODES).includes(value);
+}
+function pickRegistryMetadata(options) {
+  if (!isObject(options)) return {};
+  return Object.fromEntries(
+    REGISTRY_METADATA_KEYS.filter((key) => options[key] !== void 0).map(
+      (key) => [key, options[key]]
+    )
+  );
+}
 function useRequiredContext(context, hookName, providerName) {
   const value = use(context);
   if (value === null) {
@@ -1301,1233 +672,1439 @@ var EventEmitter = class {
         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);
+  }
+  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]);
+}
+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 emitChange() {
+  listeners.forEach((listener) => listener());
+}
+function emitIfSnapshotChanged() {
+  const nextSnapshot = getDomSnapshot();
+  if (nextSnapshot === lastSnapshot) {
+    return;
+  }
+  lastSnapshot = nextSnapshot;
+  emitChange();
+}
+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 releaseDomObserver() {
+  if (listeners.size > 0 || !domObserver) {
+    return;
+  }
+  domObserver.disconnect();
+  domObserver = null;
+}
+function subscribe(listener) {
+  listeners.add(listener);
+  ensureDomObserver();
+  emitIfSnapshotChanged();
+  return () => {
+    listeners.delete(listener);
+    releaseDomObserver();
+  };
+}
+function getSnapshot() {
+  return getDomSnapshot();
+}
+function useIsFullscreenStateActive() {
+  return useSyncExternalStore(subscribe, getSnapshot, () => false);
+}
+var RegistryContext = getOrCreateGlobalContext(
+  "RegistryContext",
+  null
+);
+function useRegistryActions() {
+  return useRequiredContext(
+    RegistryContext,
+    "useRegistryActions",
+    "RegistryProvider"
+  ).actions;
+}
+function useRegistrySubscription() {
+  return useRequiredContext(
+    RegistryContext,
+    "useRegistrySubscription",
+    "RegistryProvider"
+  ).subscription;
+}
+function useRegistryEntries(type) {
+  const { getEntriesSnapshot, subscribe: subscribe2 } = useRegistrySubscription();
+  const subscribeToType = useCallback(
+    (listener) => subscribe2(type, null, listener),
+    [subscribe2, type]
+  );
+  const getEntries = useCallback(
+    () => getEntriesSnapshot(type),
+    [getEntriesSnapshot, type]
+  );
+  return useSyncExternalStore(subscribeToType, getEntries, getEntries);
+}
+var EMPTY_MODULES = Object.freeze([]);
+var ModuleHostContext = getOrCreateGlobalContext("ModuleHostContext", null);
+function selectModuleSlice(coreModule, config) {
+  const slice = coreModule.page?.select ? coreModule.page.select(config) : config[coreModule.id];
+  return slice ?? null;
+}
+function createModulePayload(modules, config, metadata = {}) {
+  const payload = {};
+  let hasSlices = false;
+  for (const coreModule of modules) {
+    if (!coreModule.page?.entries) continue;
+    const slice = selectModuleSlice(coreModule, config);
+    if (slice === null) continue;
+    payload[coreModule.id] = slice;
+    hasSlices = true;
+  }
+  if (!hasSlices) return null;
+  return {
+    ...payload,
+    registry: {
+      ...metadata,
+      ...isObject(config.registry) ? config.registry : {}
+    }
+  };
+}
+function useInstalledModules() {
+  return use(ModuleHostContext)?.modules ?? EMPTY_MODULES;
+}
+
+// src/kernel/handlers.ts
+function isPersistentLifecycle(lifecycle) {
+  return lifecycle === REGISTRY_LIFECYCLES.PERSISTENT;
+}
+function runRegistrationBatch(context, executor) {
+  return typeof context.batch === "function" ? context.batch(executor) : executor(context);
+}
+function createEntryCleanupKey(type, key, source, instanceId, scope) {
+  return JSON.stringify([
+    "entry",
+    type,
+    key,
+    scope ?? null,
+    source,
+    instanceId
+  ]);
+}
+function getCleanupScope(context) {
+  return context?.cleanupScope || /* @__PURE__ */ new Map();
+}
+function clearCleanupTimer(scope, cleanupKey) {
+  const lifecycle = scope.get(cleanupKey);
+  if (!lifecycle) return;
+  lifecycle.cancelled = true;
+  if (lifecycle.timerId !== null) clearTimeout(lifecycle.timerId);
+  scope.delete(cleanupKey);
+}
+function scheduleCleanup(scope, cleanupKey, callback, delayMs) {
+  clearCleanupTimer(scope, cleanupKey);
+  const lifecycle = {
+    cancelled: false,
+    timerId: null
+  };
+  lifecycle.timerId = setTimeout(() => {
+    if (lifecycle.cancelled || scope.get(cleanupKey) !== lifecycle) return;
+    scope.delete(cleanupKey);
+    callback();
+  }, delayMs);
+  scope.set(cleanupKey, lifecycle);
+}
+function collectModuleRegistrations(coreModule, slice, pageMetadata, context) {
+  const definition = coreModule.registry;
+  const toEntries = coreModule.page?.entries;
+  if (!definition || !toEntries || slice == null || slice === false) return [];
+  const type = coreModule.id;
+  const items = Array.isArray(slice) ? slice : [slice];
+  const registrations = [];
+  for (const item of items) {
+    if (item == null || item === false) continue;
+    const itemMetadata = isObject(item) && isObject(item.registry) ? item.registry : {};
+    const metadata = { ...pageMetadata, ...itemMetadata };
+    if (metadata.validation === "strict" && !validateRegistryMetadata(metadata).valid) {
+      continue;
+    }
+    const payload = isObject(item) ? Object.fromEntries(
+      Object.entries(item).filter(([key]) => key !== "registry")
+    ) : item;
+    const { cleanupDelayMs, lifecycle, registerOptions, scope, source } = normalizeRegistryMetadata(metadata, {
+      defaultCleanupDelayMs: definition.cleanupDelayMs ?? null,
+      defaultLifecycle: definition.lifecycle,
+      defaultSource: DEFAULT_SOURCE
+    });
+    for (const { key, value } of toEntries(payload, context) ?? []) {
+      const validation = definition.validate?.(value);
+      if (validation && !validation.valid) {
+        report(`Registry ${type} config is invalid`, validation.issues, "warn");
+        continue;
       }
-      this.debounceTimers.clear();
+      registrations.push({
+        cleanupDelayMs,
+        cleanupKey: createEntryCleanupKey(
+          type,
+          key,
+          source,
+          context.instanceId,
+          scope
+        ),
+        key,
+        lifecycle,
+        registerOptions,
+        scope,
+        source,
+        type,
+        value
+      });
     }
   }
-  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()];
-  }
+  return registrations;
+}
+var NO_CLEANUP = () => {
 };
-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;
+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 [];
+    }
   });
-  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 (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);
       }
-      if (throttleTimerRef.current !== null) {
-        clearTimeout(throttleTimerRef.current);
-        throttleTimerRef.current = null;
+    );
+  });
+  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);
       }
-    };
-  }, [event, debounceMs, throttleMs]);
+    });
+    if (immediate.length === 0) return;
+    runRegistrationBatch(context, (queue) => {
+      immediate.forEach(
+        (registration) => queue.unregister(
+          registration.type,
+          registration.key,
+          owner(registration)
+        )
+      );
+    });
+  };
 }
 
-// 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;
-
-// src/kernel/utils.ts
-function parseFiniteNumber(value) {
-  const parsed = Number(value);
-  return Number.isFinite(parsed) ? parsed : null;
+// src/kernel/hooks.ts
+function withInstanceId(instanceId, sourceOrOptions, optionsArg) {
+  if (typeof sourceOrOptions === "string") {
+    return {
+      optionsArg: { ...isObject(optionsArg) ? optionsArg : {}, instanceId },
+      sourceOrOptions
+    };
+  }
+  if (isObject(sourceOrOptions)) {
+    return {
+      optionsArg,
+      sourceOrOptions: { ...sourceOrOptions, instanceId }
+    };
+  }
+  return {
+    optionsArg: void 0,
+    sourceOrOptions: {
+      ...isObject(optionsArg) ? optionsArg : {},
+      instanceId
+    }
+  };
 }
-function getValidString(value, fallback = null) {
-  return trimToNull(value) ?? fallback;
+function withInstanceIdForUnregister(instanceId, sourceOrOptions) {
+  if (typeof sourceOrOptions === "string") {
+    return { instanceId, source: sourceOrOptions };
+  }
+  if (isObject(sourceOrOptions)) {
+    return { ...sourceOrOptions, instanceId };
+  }
+  return { instanceId };
 }
-
-// src/kernel/schema.ts
-function resolveLifecycle(metadata, fallback) {
-  const lifecycle = metadata?.lifecycle ?? metadata?.cleanup;
-  return lifecycle && REGISTRY_LIFECYCLE_VALUES.has(lifecycle) ? lifecycle : fallback;
+function resolveRegisterArgsWithInstance(instanceId, sourceOrOptions, optionsArg) {
+  const input = withInstanceId(instanceId, sourceOrOptions, optionsArg);
+  return [input.sourceOrOptions, input.optionsArg];
 }
-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");
+var MAX_STABILIZATION_DEPTH = 64;
+function createStableFunctionEntry(fn) {
+  const entry = {
+    current: fn,
+    stable(...args) {
+      return entry.current?.apply(this, args);
+    }
+  };
+  return entry;
+}
+function isDirectRegistryComponentPath(path, componentSlices) {
+  const match = /^config\.([^.[]+)\.[^.[]+$/.exec(path);
+  return Boolean(match && componentSlices.has(match[1]));
+}
+function isReactNodeLike(value) {
+  return value === null || value === void 0 || typeof value === "boolean" || typeof value === "string" || typeof value === "number" || isValidElement(value);
+}
+function isStabilizableObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) && !isValidElement(value);
+}
+function hasSameObjectKeys(previousValue, nextValue) {
+  if (!isStabilizableObject(previousValue) || !isStabilizableObject(nextValue)) {
+    return false;
   }
-  const 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(", ")}`
-    );
+  const previousKeys = Object.keys(previousValue);
+  const nextKeys = Object.keys(nextValue);
+  if (previousKeys.length !== nextKeys.length) return false;
+  return nextKeys.every(
+    (key) => Object.prototype.hasOwnProperty.call(previousValue, key)
+  );
+}
+function stabilizeRegistryValue(value, path, scope, previousValue, seen = /* @__PURE__ */ new WeakSet(), depth = 0) {
+  if (depth > MAX_STABILIZATION_DEPTH) return value;
+  if (typeof value === "function") {
+    const isComponent = value.name && /^[A-Z]/.test(value.name);
+    if (isComponent || isDirectRegistryComponentPath(path, scope.componentSlices)) {
+      return value;
+    }
+    scope.usedPaths.add(path);
+    let entry = scope.functionEntries.get(path);
+    if (!entry) {
+      entry = createStableFunctionEntry(value);
+      scope.functionEntries.set(path, entry);
+    } else {
+      entry.current = value;
+    }
+    return entry.stable;
   }
-  if (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 (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);
   }
-  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 (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;
   }
-  return {
-    cleanupDelayMs,
-    lifecycle,
-    priority,
-    registerOptions: {
-      ...priority !== null && { priority },
-      ...validation === REGISTRY_VALIDATION_MODES.STRICT && { validation },
-      ...scope && { scope }
-    },
-    source,
-    ...scope && { scope },
-    ...validation && { validation }
-  };
+  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 isValidationMode(value) {
-  return Object.values(REGISTRY_VALIDATION_MODES).includes(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 pickRegistryMetadata(options) {
-  if (!isObject(options)) return {};
-  return Object.fromEntries(
-    REGISTRY_METADATA_KEYS.filter((key) => options[key] !== void 0).map(
-      (key) => [key, options[key]]
+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 createNoopHandle(status = "rejected", reason = "unknown") {
-  const handle = Object.assign(() => false, {
-    active: false,
-    dispose: () => false,
-    instanceId: null,
-    key: "",
-    priority: 0,
-    reason,
-    source: "",
-    status,
-    type: "",
-    update: () => handle,
-    updatedAt: 0,
-    validation: "warn"
   });
-  return handle;
+  return {
+    ...stamp(actions),
+    batch: (executor) => typeof executor === "function" ? actions.batch((queue) => executor(stamp(queue))) : 0,
+    cleanupScope,
+    instanceId,
+    modules,
+    pathname
+  };
 }
-createNoopHandle();
-var RegistryContext = getOrCreateGlobalContext(
-  "RegistryContext",
-  null
-);
-function useRegistryActions() {
-  return useRequiredContext(
-    RegistryContext,
-    "useRegistryActions",
-    "RegistryProvider"
-  ).actions;
+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 useRegistrySubscription() {
-  return useRequiredContext(
-    RegistryContext,
-    "useRegistrySubscription",
-    "RegistryProvider"
-  ).subscription;
+function defineModule(coreModule) {
+  return Object.freeze({ ...coreModule });
 }
-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]
+createStore(void 0);
+
+// src/kernel/adapters.ts
+function useModuleRegistration(id, value, options) {
+  const coreModule = useInstalledModules().find(
+    (candidate) => candidate.id === id
   );
-  return useSyncExternalStore(subscribeToType, getEntries, getEntries);
+  const config = coreModule && options?.enabled !== false && value != null ? { [id]: value } : null;
+  useRegistry(config, pickRegistryMetadata(options));
 }
-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;
+
+// src/theme.tsx
+function defineThemeSpec(id) {
+  return Object.freeze({ id });
 }
-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 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).`
+    );
   }
-  if (!hasSlices) return null;
   return {
-    ...payload,
-    registry: {
-      ...metadata,
-      ...isObject(config.registry) ? config.registry : {}
-    }
+    slots: config.slots,
+    styles: config.styles ?? {}
   };
 }
-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);
+// 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/dock/utils.ts
+function isSamePath(left, right) {
+  const normalizedLeft = normalizePath(left);
+  const normalizedRight = normalizePath(right);
+  return Boolean(
+    normalizedLeft && normalizedRight && normalizedLeft === normalizedRight
+  );
 }
-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 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 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 isInlineActionPathMatch(path, pathname) {
+  return isSamePath(path, pathname) || path !== "/" && isPathPrefix(path, pathname);
 }
-var NO_CLEANUP = () => {
-};
-function applyRegistryConfig(config, context) {
-  const modules = context.modules ?? [];
-  if (!config || modules.length === 0) return NO_CLEANUP;
-  const pageMetadata = isObject(config.registry) ? config.registry : {};
-  const slices = config;
-  const registrations = modules.flatMap((coreModule) => {
-    try {
-      return collectModuleRegistrations(
-        coreModule,
-        slices[coreModule.id],
-        pageMetadata,
-        context
-      );
-    } catch (error) {
-      report(`Registry apply (${coreModule.id})`, error);
-      return [];
-    }
-  });
-  if (registrations.length === 0) return NO_CLEANUP;
-  const cleanupScope = getCleanupScope(context);
-  const owner = (registration) => ({
-    instanceId: context.instanceId,
-    scope: registration.scope,
-    source: registration.source
-  });
-  runRegistrationBatch(context, (queue) => {
-    registrations.forEach(
-      ({ cleanupKey, key, registerOptions, source, type, value }) => {
-        clearCleanupTimer(cleanupScope, cleanupKey);
-        queue.register(type, key, value, source, registerOptions);
-      }
-    );
-  });
-  return () => {
-    const immediate = [];
-    registrations.forEach((registration) => {
-      if (isPersistentLifecycle(registration.lifecycle)) return;
-      const { cleanupDelayMs, cleanupKey, key, type } = registration;
-      if (typeof cleanupDelayMs === "number" && cleanupDelayMs > 0) {
-        scheduleCleanup(
-          cleanupScope,
-          cleanupKey,
-          () => context.unregister(type, key, owner(registration)),
-          cleanupDelayMs
-        );
-      } else {
-        immediate.push(registration);
-      }
-    });
-    if (immediate.length === 0) return;
-    runRegistrationBatch(context, (queue) => {
-      immediate.forEach(
-        (registration) => queue.unregister(
-          registration.type,
-          registration.key,
-          owner(registration)
-        )
-      );
-    });
-  };
+function isSafeInternalHref(value) {
+  const href = typeof value === "string" ? value.trim() : "";
+  return href.startsWith("/") && !href.startsWith("//");
 }
-
-// src/kernel/hooks.ts
-function withInstanceId(instanceId, sourceOrOptions, optionsArg) {
-  if (typeof sourceOrOptions === "string") {
-    return {
-      optionsArg: { ...isObject(optionsArg) ? optionsArg : {}, instanceId },
-      sourceOrOptions
-    };
-  }
-  if (isObject(sourceOrOptions)) {
-    return {
-      optionsArg,
-      sourceOrOptions: { ...sourceOrOptions, instanceId }
-    };
-  }
-  return {
-    optionsArg: void 0,
-    sourceOrOptions: {
-      ...isObject(optionsArg) ? optionsArg : {},
-      instanceId
-    }
-  };
+function 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 withInstanceIdForUnregister(instanceId, sourceOrOptions) {
-  if (typeof sourceOrOptions === "string") {
-    return { instanceId, source: sourceOrOptions };
-  }
-  if (isObject(sourceOrOptions)) {
-    return { ...sourceOrOptions, instanceId };
-  }
-  return { instanceId };
+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 resolveRegisterArgsWithInstance(instanceId, sourceOrOptions, optionsArg) {
-  const input = withInstanceId(instanceId, sourceOrOptions, optionsArg);
-  return [input.sourceOrOptions, input.optionsArg];
+function isValidBannerUrl(banner) {
+  const value = trimToNull(banner);
+  if (!value) return false;
+  return /^(https?:\/\/|\/|data:image\/)/.test(value);
 }
-var MAX_STABILIZATION_DEPTH = 64;
-function createStableFunctionEntry(fn) {
-  const entry = {
-    current: fn,
-    stable(...args) {
-      return entry.current?.apply(this, args);
-    }
-  };
-  return entry;
+function toObject(value) {
+  return isObject(value) ? value : {};
 }
-function isDirectRegistryComponentPath(path, componentSlices) {
-  const match = /^config\.([^.[]+)\.[^.[]+$/.exec(path);
-  return Boolean(match && componentSlices.has(match[1]));
+function isValidComponentType(type) {
+  if (typeof type === "function") return true;
+  return Boolean(
+    type != null && typeof type === "object" && !isValidElement(type) && "$$typeof" in type
+  );
 }
-function isReactNodeLike(value) {
-  return value === null || value === void 0 || typeof value === "boolean" || typeof value === "string" || typeof value === "number" || isValidElement(value);
+function resolveComponentType(...candidates) {
+  return candidates.find(isValidComponentType) ?? null;
 }
-function isStabilizableObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value) && !isValidElement(value);
+function resolveRenderableContent(...candidates) {
+  return candidates.find(
+    (candidate) => candidate !== null && candidate !== void 0
+  ) ?? null;
 }
-function hasSameObjectKeys(previousValue, nextValue) {
-  if (!isStabilizableObject(previousValue) || !isStabilizableObject(nextValue)) {
-    return false;
+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;
   }
-  const previousKeys = Object.keys(previousValue);
-  const nextKeys = Object.keys(nextValue);
-  if (previousKeys.length !== nextKeys.length) return false;
-  return nextKeys.every(
-    (key) => Object.prototype.hasOwnProperty.call(previousValue, key)
-  );
-}
-function stabilizeRegistryValue(value, path, scope, previousValue, seen = /* @__PURE__ */ new WeakSet(), depth = 0) {
-  if (depth > MAX_STABILIZATION_DEPTH) return value;
-  if (typeof value === "function") {
-    const isComponent = value.name && /^[A-Z]/.test(value.name);
-    if (isComponent || isDirectRegistryComponentPath(path, scope.componentSlices)) {
-      return value;
-    }
-    scope.usedPaths.add(path);
-    let entry = scope.functionEntries.get(path);
-    if (!entry) {
-      entry = createStableFunctionEntry(value);
-      scope.functionEntries.set(path, entry);
-    } else {
-      entry.current = value;
-    }
-    return entry.stable;
+  if (isValidElement(value)) {
+    if (visitedObjects.has(value)) return "";
+    visitedObjects.add(value);
+    const text = collectSearchableText(
+      value.props?.children,
+      visitedObjects
+    );
+    visitedObjects.delete(value);
+    return text;
   }
   if (value && typeof value === "object") {
-    if (seen.has(value)) return value;
-    seen.add(value);
+    if (visitedObjects.has(value)) return "";
+    visitedObjects.add(value);
+    return Object.values(value).map((entry) => collectSearchableText(entry, visitedObjects)).join(" ");
   }
-  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 "";
+}
+function toSearchableText(value) {
+  return collectSearchableText(value, /* @__PURE__ */ new WeakSet());
+}
+function normalizeUpper(value) {
+  return String(value || "").trim().toUpperCase();
+}
+function splitStyle(style = {}) {
+  const { className, ...inlineStyle } = style;
+  return {
+    className,
+    inlineStyle
+  };
+}
+function getLineClampStyle(maxLines, style) {
+  if (Number(maxLines) <= 1) return style;
+  return {
+    WebkitBoxOrient: "vertical",
+    WebkitLineClamp: maxLines,
+    display: "-webkit-box",
+    overflow: "hidden",
+    ...style
+  };
+}
+function getImageIconStyle(style, icon) {
+  const nextStyle = {
+    ...style
+  };
+  delete nextStyle.background;
+  delete nextStyle.backgroundImage;
+  return {
+    ...nextStyle,
+    backgroundImage: `url(${icon})`
+  };
+}
+function resolveDockActionClass(slots, {
+  className = "",
+  button = "",
+  isActive = false,
+  variant = "",
+  tone = "",
+  base,
+  cn: classNamesFn
+} = {}) {
+  const resolve = classNamesFn || cn;
+  const toneClasses = {
+    muted: slots.actionMuted,
+    active: slots.actionActive
+  };
+  if (button && !className && base === void 0) {
+    if (tone) {
+      const toneClass = toneClasses[tone] || slots.actionSurface || slots.actionMuted;
+      return resolve(button, toneClass);
     }
-    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;
+    const stateToken = isActive ? slots.actionActive : slots.actionMuted;
+    return resolve(button, stateToken);
   }
-  if (typeof value !== "object" || value === null) {
-    return value;
+  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();
   }
-  const source = value;
-  const previousRecord = previousValue;
-  const stabilizedValue = {};
-  const canReusePrevious = hasSameObjectKeys(previousValue, value);
-  let hasChanged = !canReusePrevious;
-  Object.keys(source).forEach((key) => {
-    const nextValue = stabilizeRegistryValue(
-      source[key],
-      `${path}.${key}`,
-      scope,
-      previousRecord?.[key],
-      seen,
-      depth + 1
-    );
-    stabilizedValue[key] = nextValue;
-    if (!canReusePrevious || nextValue !== previousRecord?.[key]) {
-      hasChanged = true;
-    }
-  });
-  return !hasChanged ? previousValue : stabilizedValue;
 }
-function useAppliedRegistryConfig(payload, context, componentSlices) {
-  const functionEntriesRef = useRef(/* @__PURE__ */ new Map());
-  const appliedRef = useRef(null);
-  useIsomorphicLayoutEffect(() => {
-    const previous = appliedRef.current;
-    if (previous && previous.payload === payload && previous.context === context) {
-      return;
-    }
-    const functionEntries = functionEntriesRef.current;
-    const usedPaths = /* @__PURE__ */ new Set();
-    const config = stabilizeRegistryValue(
-      payload,
-      "config",
-      { componentSlices, functionEntries, usedPaths },
-      previous?.config
-    );
-    functionEntries.forEach((_entry, path) => {
-      if (!usedPaths.has(path)) functionEntries.delete(path);
-    });
-    if (previous && previous.config === config && previous.context === context) {
-      previous.payload = payload;
-      return;
-    }
-    previous?.cleanup();
-    appliedRef.current = {
-      cleanup: applyRegistryConfig(config, context),
-      config,
-      context,
-      payload
-    };
-  });
-  useIsomorphicLayoutEffect(
-    () => () => {
-      appliedRef.current?.cleanup();
-      appliedRef.current = null;
-    },
-    []
+function closestMatches(target, selector) {
+  const element = target;
+  return Boolean(
+    element && typeof element.closest === "function" && element.closest(selector)
+  );
+}
+function isInteractiveTarget(target) {
+  return closestMatches(
+    target,
+    'button, a, input, textarea, select, [role="button"], [tabindex]:not([tabindex="-1"])'
+  );
+}
+function isEditableDockTarget(target) {
+  return closestMatches(
+    target,
+    'input, textarea, select, [contenteditable="true"]'
   );
 }
-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 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";
   });
-  return {
-    ...stamp(actions),
-    batch: (executor) => typeof executor === "function" ? actions.batch((queue) => executor(stamp(queue))) : 0,
-    cleanupScope,
-    instanceId,
-    modules,
-    pathname
-  };
 }
-function useRegistry(config, metadata) {
-  const { batch, register, unregister } = useRegistryActions();
-  const pathname = usePathname();
-  const modules = useInstalledModules();
-  const instanceId = `registry-instance-${useId()}`;
-  const [cleanupScope] = useState(
-    () => /* @__PURE__ */ new Map()
+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
   );
-  const context = useMemo(
-    () => createRegistryApplyContext(
-      { batch, register, unregister },
-      {
-        cleanupScope,
-        instanceId,
-        modules,
-        pathname
-      }
-    ),
-    [batch, cleanupScope, instanceId, modules, pathname, register, unregister]
+}
+function isSameDockItem(item, candidate) {
+  return Boolean(
+    item?.path && item.path === candidate?.path || item?.name && item.name === candidate?.name
   );
-  const payload = useMemo(
-    () => config ? createModulePayload(modules, config, metadata) : null,
-    [config, metadata, modules]
+}
+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 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 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
   );
-  const componentSlices = useMemo(
-    () => new Set(
-      modules.filter(
-        (coreModule) => coreModule.registry?.valueKind === "component"
-      ).map((coreModule) => coreModule.id)
-    ),
-    [modules]
+  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)
   );
-  useAppliedRegistryConfig(payload, context, componentSlices);
 }
-function createPageControllerStore() {
-  const listeners2 = /* @__PURE__ */ new Set();
-  let stack = [];
-  const notify = () => {
-    listeners2.forEach((listener) => {
-      try {
-        listener();
-      } catch (error) {
-        report("Page controller listener", error);
-      }
-    });
-  };
-  return {
-    getSnapshot() {
-      const top = stack[stack.length - 1];
-      return top?.controllerRef?.current || null;
-    },
-    notify,
-    register(id, controllerRef) {
-      stack = stack.filter((item) => item.id !== id);
-      stack.push({ controllerRef, id });
-      notify();
-    },
-    subscribe(listener) {
-      listeners2.add(listener);
-      return () => {
-        listeners2.delete(listener);
-      };
-    },
-    unregister(id) {
-      stack = stack.filter((item) => item.id !== id);
-      notify();
+function resolveActiveIndex({
+  dockItems,
+  activeItem,
+  pathname
+}) {
+  return Math.max(0, findDockItemIndex(dockItems, activeItem, pathname));
+}
+function shouldKeepAncestorItem(item, activePath) {
+  const policy = item?.keepWhenDescendant;
+  if (typeof policy === "function") {
+    try {
+      return Boolean(policy(activePath, item));
+    } catch {
+      return false;
     }
-  };
+  }
+  return policy === true;
 }
-var fallbackStandaloneStore = createPageControllerStore();
-getOrCreateGlobalContext(
-  "PageControllerContext",
-  null
-);
-getOrCreateGlobalContext(
-  "PageControllerStoreContext",
-  fallbackStandaloneStore
-);
-function defineModule(coreModule) {
-  return Object.freeze({ ...coreModule });
+function isAncestorPath(item, activePath) {
+  const candidatePath = item?.path;
+  if (!candidatePath || candidatePath === "/" || candidatePath === activePath)
+    return false;
+  return isPathPrefix(candidatePath, activePath) && !shouldKeepAncestorItem(item, activePath);
 }
-function useModule(id) {
-  const coreModule = use(ModuleHostContext)?.byId.get(id);
-  return coreModule?.context ? use(coreModule.context) ?? null : null;
+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 definePeer(id, inert) {
-  const useRuntime = () => useModule(id) ?? inert;
-  return {
-    useRuntime,
-    useActions: () => useRuntime().actions,
-    useState: (selector, isEqual) => useStore(
-      useRuntime().store,
-      selector,
-      isEqual
-    )
-  };
+function replaceActiveItem(items, activeIndex, activeItem) {
+  if (activeIndex === -1 || !activeItem) return items;
+  const nextItems = [...items];
+  nextItems[activeIndex] = activeItem;
+  return nextItems;
 }
-createStore(void 0);
-
-// src/kernel/adapters.tsx
-function useModuleRegistration(id, value, options) {
-  const coreModule = useInstalledModules().find(
-    (candidate) => candidate.id === id
+function removeInactiveLoadingItems(items = [], activeItem = null) {
+  if (!Array.isArray(items) || items.length === 0) return items;
+  return items.filter(
+    (item) => !item?.isLoading || isSameItem(item, activeItem)
   );
-  const config = coreModule && options?.enabled !== false && value != null ? { [id]: value } : null;
-  useRegistry(config, pickRegistryMetadata(options));
 }
-
-// src/modules/dock/context.ts
-var DockContext = getOrCreateGlobalContext(
-  "DockContext",
-  null
-);
-function useDockState() {
-  const { store } = useRequiredContext(
-    DockContext,
-    "useDockState",
-    "DockProvider"
-  );
-  return useStore(store);
+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 useDockSelector(selector, isEqual = Object.is) {
-  const { store } = useRequiredContext(
-    DockContext,
-    "useDockSelector",
-    "DockProvider"
-  );
-  return useStore(store, selector, isEqual);
+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 isSurfaceDescriptor(value) {
+  return value != null && typeof value === "object" && !Array.isArray(value) && !isValidElement(value);
+}
+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
+    };
+  }
+  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 useDockActions() {
-  return useRequiredContext(DockContext, "useDockActions", "DockProvider").actions;
+function normalizeSurfaceFlowSnapshot(value) {
+  if (!isPlainObject(value)) return null;
+  return { ...value };
 }
-function useDockHeight() {
-  const dockHeight = useDockSelector((state) => state.dockHeight);
-  return { dockHeight, padding: { paddingBottom: `${dockHeight}px` } };
+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 EMPTY_DOCK_STATE = Object.freeze({
-  activeItem: null,
-  activeOperation: null,
-  activeSurfaceEntry: null,
-  activeSurfaceId: null,
-  contextActions: [],
-  dockContinuity: [],
-  dockHeight: 0,
-  dockReturnHandoffs: [],
-  expanded: false,
-  hud: null,
-  hudEntries: [],
-  isHudActive: false,
-  isSurfaceOpen: false,
-  locationKey: "",
-  operations: [],
-  pathname: "",
-  searchQuery: "",
-  selectionMode: null,
-  surfaceLifecycle: "",
-  surfacePhase: "",
-  surfaceStack: []
-});
-var mediaPeer = definePeer("media", {
-  actions: Object.freeze({
-    removeSource: () => {
-    },
-    setMuted: () => {
-    },
-    toggle: () => {
-    },
-    toggleLoop: () => {
-    },
-    upsertSource: () => {
-    }
-  }),
-  store: createStore({
-    audibleElement: null,
-    element: null,
-    hasMedia: false,
-    isPlaying: false,
-    kind: null,
-    loop: false,
-    sourceId: null
-  })
-});
-function useDockMedia() {
-  return mediaPeer.useState((state) => state, shallowEqual);
+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 });
 }
-var selectHasMedia = (state) => state.hasMedia;
-function useDockHasMedia() {
-  return mediaPeer.useState(selectHasMedia);
+function createDockScheduler(options = {}) {
+  return createScheduler({
+    defaultLabel: "dock-task",
+    ...options
+  });
 }
-var useDockMediaActions = mediaPeer.useActions;
-var loadingPeer = definePeer("loading", {
-  actions: {
-    setLoading: () => {
-    },
-    setSkeleton: () => {
-    },
-    startLoading: () => {
-    },
-    stopLoading: () => {
-    },
-    withLoading: async (task) => typeof task === "function" ? task() : task
-  },
-  store: createStore({
-    isLoading: false,
-    isPageLoading: false,
-    message: null,
-    minDuration: 0,
-    showOverlay: false,
-    skeleton: null
-  })
+
+// src/modules/dock/surface/context.tsx
+var SurfaceExtensionsContext = createContext(null);
+var SurfaceItemContext = createContext({
+  id: null,
+  width: null
 });
-function useDockLoadingState() {
-  return loadingPeer.useState((state) => state);
+function useSurfaceDimensions() {
+  const { width } = use(SurfaceItemContext);
+  return useMemo(() => ({ width }), [width]);
 }
-var useDockLoadingActions = loadingPeer.useActions;
-var notificationPeer = definePeer("notification", {
-  actions: {
-    dismissAllNotifications: () => {
-    },
-    dismissNotification: () => {
+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);
     },
-    showNotification: () => null
-  },
-  store: createStore({ notifications: {} })
-});
-function useDockNotificationVisible() {
-  return notificationPeer.useState(
-    ({ notifications }) => Object.keys(notifications).length > 0
+    [store, surfaceId]
   );
 }
-var statusActionDefaults = { error: null, guard: null };
-
-// src/modules/dock/surface/definition.ts
-var isNormalizedExtension = (extension) => extension !== null;
-function normalizeExtensions(raw) {
-  if (!raw) return [];
-  return (Array.isArray(raw) ? raw : [raw]).map(normalizeSurfaceExtension).filter(isNormalizedExtension);
+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 normalizeSurfaceDefinition(input, config = {}, {
-  allowPrimitiveContent = false,
-  defaultShowAction = false
-} = {}) {
-  const descriptor = isSurfaceDescriptor(input) && (isValidComponentType(input.component) || typeof input.loader === "function" || "content" in input || "node" in input || "element" in input || Array.isArray(input.steps) && input.steps.length > 0) ? input : null;
-  const configuredSteps = descriptor?.steps ?? config?.steps;
-  const steps = Array.isArray(configuredSteps) && configuredSteps.length > 0 ? configuredSteps : null;
-  const firstStep = steps?.[0] ?? null;
-  const rawComponent = resolveComponentType(
-    descriptor?.component,
-    descriptor ? null : input,
-    firstStep?.component,
-    firstStep
-  );
-  const component = rawComponent ?? (typeof descriptor?.loader === "function" ? lazy(descriptor.loader) : typeof firstStep?.loader === "function" ? lazy(firstStep.loader) : null);
-  const explicitContent = resolveRenderableContent(
-    descriptor?.content,
-    descriptor?.node,
-    descriptor?.element,
-    firstStep?.content,
-    firstStep?.node,
-    firstStep?.element
-  );
-  const fallbackContent = !descriptor && !component && (isValidElement(input) || allowPrimitiveContent && input != null) ? input : null;
-  const content = explicitContent ?? fallbackContent;
-  if (!component && content == null && !steps) return null;
-  const directComponentInput = !descriptor && isValidComponentType(input);
-  const extensions = normalizeExtensions(
-    descriptor?.extensions ?? config?.extensions
-  );
-  return {
-    renderMode: component ? DOCK_SURFACE_RENDER_MODE.COMPONENT : DOCK_SURFACE_RENDER_MODE.NODE,
-    component,
-    content: component ? null : content ?? input,
-    props: component ? isPlainObject(descriptor?.props) ? descriptor.props : directComponentInput ? config : {} : {},
-    action: descriptor?.action ?? config?.action ?? null,
-    showAction: descriptor?.showAction ?? config?.showAction ?? defaultShowAction,
-    dismissible: descriptor?.dismissible ?? config?.dismissible ?? true,
-    onClose: descriptor?.onClose ?? config?.onClose ?? null,
-    icon: descriptor?.icon ?? descriptor?.header?.icon ?? config?.icon ?? config?.header?.icon ?? null,
-    title: descriptor?.title ?? descriptor?.header?.title ?? config?.title ?? config?.header?.title ?? null,
-    description: descriptor?.description ?? descriptor?.header?.description ?? config?.description ?? config?.header?.description ?? null,
-    descriptionMaxLines: descriptor?.descriptionMaxLines ?? config?.descriptionMaxLines ?? 2,
-    trailing: descriptor?.trailing ?? config?.trailing ?? null,
-    headerAction: descriptor?.headerAction ?? config?.headerAction ?? null,
-    closeLabel: descriptor?.closeLabel ?? config?.closeLabel ?? null,
-    width: descriptor?.width ?? config?.width ?? null,
-    allowSwipeDismiss: descriptor?.allowSwipeDismiss ?? config?.allowSwipeDismiss ?? true,
-    skipActionDismiss: descriptor?.skipActionDismiss ?? config?.skipActionDismiss ?? true,
-    steps,
-    currentStepIndex: descriptor?.currentStepIndex ?? config?.currentStepIndex ?? 0,
-    syncWithUrl: descriptor?.syncWithUrl ?? config?.syncWithUrl ?? false,
-    urlKey: descriptor?.urlKey ?? config?.urlKey ?? null,
-    badge: descriptor?.badge ?? config?.badge ?? null,
-    extensions
+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;
   };
-}
-function createSurfaceEntryDefinition(input, config = {}) {
-  return normalizeSurfaceDefinition(input, config);
-}
-function createSurfaceFlowBuilder(definition = {}) {
-  const {
-    action = null,
-    allowSwipeDismiss = true,
-    badge = null,
-    closeLabel = null,
-    component = null,
-    loader,
-    defaultProps = {},
-    description = null,
-    descriptionMaxLines = 2,
-    dismissible = true,
-    extensions = [],
-    headerAction = null,
-    icon = null,
-    id = null,
-    onClose = null,
-    showAction = null,
-    syncWithUrl = false,
-    title = null,
-    trailing = null,
-    urlKey = null,
-    width = null,
-    ...extraConfig
-  } = definition;
-  const resolvedComponent = component ?? (typeof loader === "function" ? lazy(loader) : null);
-  const createEntry = function surfaceEntryFactory2(props = {}, overrides = {}) {
-    const mergedProps = { ...defaultProps, ...props };
-    const resolvedTitle = typeof title === "function" ? title(mergedProps) : title;
-    const resolvedDescription = typeof description === "function" ? description(mergedProps) : description;
-    const resolvedIcon = typeof icon === "function" ? icon(mergedProps) : icon;
-    return {
-      id: overrides.id ?? id,
-      component: overrides.component ?? resolvedComponent,
-      loader: overrides.loader ?? loader,
-      props: mergedProps,
-      title: resolvedTitle,
-      description: resolvedDescription,
-      icon: resolvedIcon,
-      action,
-      allowSwipeDismiss,
-      badge,
-      closeLabel,
-      descriptionMaxLines,
-      dismissible,
-      extensions,
-      headerAction,
-      onClose,
-      showAction,
-      syncWithUrl,
-      trailing,
-      urlKey,
-      width,
-      ...extraConfig,
-      ...overrides
-    };
+  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
+    });
   };
-  const surfaceEntryFactory = Object.assign(
-    createEntry,
-    {
-      component: resolvedComponent,
-      id,
-      isSurfaceFactory: true,
-      open: (openSurfaceFn, props = {}, overrides = {}) => {
-        if (typeof openSurfaceFn === "function") {
-          return openSurfaceFn(createEntry(props, overrides));
-        }
-      }
+  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;
     }
-  );
-  return surfaceEntryFactory;
-}
-function createInlineSurfaceEntry(surface) {
-  return normalizeSurfaceDefinition(
-    surface,
-    {},
-    { allowPrimitiveContent: true, defaultShowAction: null }
-  );
-}
-var EMPTY_SURFACE_STACK = [];
-function useSurface(surfaceDefinition) {
-  const { closeAllSurfaces, closeSurface, openSurface } = useDockActions();
-  const rawSurfaceStack = useDockSelector(
-    (s) => s.surfaceStack
-  );
-  const surfaceStack = rawSurfaceStack || EMPTY_SURFACE_STACK;
-  const specificSurface = useMemo(() => {
-    if (!surfaceDefinition) return null;
-    const targetComponent = typeof surfaceDefinition === "string" ? null : typeof surfaceDefinition === "function" ? surfaceDefinition.component || surfaceDefinition : surfaceDefinition.component || null;
-    const matchingEntry = surfaceStack.find(
-      (entry) => targetComponent && entry.component === targetComponent
-    ) ?? null;
-    const isThisSurfaceOpen = Boolean(matchingEntry);
-    const open = (props, overrides) => {
-      const entry = typeof surfaceDefinition === "function" ? surfaceDefinition(props, overrides) : typeof surfaceDefinition === "string" ? { id: surfaceDefinition, props, ...overrides } : {
-        ...surfaceDefinition,
-        props: { ...surfaceDefinition.props || {}, ...props },
-        ...overrides
-      };
-      return openSurface(entry);
-    };
-    const close = (res) => closeSurface(res, matchingEntry?.id ?? null);
-    const result = [
-      open,
-      {
-        close,
-        closeAll: closeAllSurfaces,
-        isOpen: isThisSurfaceOpen,
-        surfaceStack
-      }
-    ];
-    result.open = open;
-    result.close = close;
-    result.closeAll = closeAllSurfaces;
-    result.isOpen = isThisSurfaceOpen;
-    result.surfaceStack = surfaceStack;
+    const merged = new Map([...globalExts || [], ...surfaceExts || []]);
+    const result = Array.from(merged.values()).sort(
+      (a, b) => a.order - b.order
+    );
+    this.cachedListBySurface.set(sId, result);
     return result;
-  }, [
-    closeAllSurfaces,
-    closeSurface,
-    openSurface,
-    surfaceDefinition,
-    surfaceStack
-  ]);
-  const generalSurface = useMemo(
-    () => ({
-      closeAllSurfaces,
-      closeSurface,
-      openSurface,
-      surfaceStack
-    }),
-    [closeAllSurfaces, closeSurface, openSurface, surfaceStack]
-  );
-  return surfaceDefinition ? specificSurface : generalSurface;
-}
-function defineSurface(definition = {}) {
-  const factory = createSurfaceFlowBuilder(definition);
-  factory.config = definition;
-  factory.use = function useDefinedSurface() {
-    return useSurface(factory);
   };
-  return factory;
-}
-function defineStepSurface(definition = {}) {
-  const {
-    currentStepIndex = 0,
-    defaultProps = {},
-    id = "wizard-surface",
-    steps = [],
-    title = null,
-    width = null,
-    ...extraConfig
-  } = definition;
-  const stepSurfaceFactory = function stepSurfaceFactory2(props = {}, overrides = {}) {
-    const mergedProps = { ...defaultProps, ...props };
-    const resolvedTitle = typeof title === "function" ? title(mergedProps) : title;
-    const resolvedSteps = typeof steps === "function" ? steps(mergedProps) : steps;
-    return {
-      id: overrides.id ?? id,
-      title: overrides.title ?? resolvedTitle,
-      steps: resolvedSteps,
-      currentStepIndex: overrides.currentStepIndex ?? currentStepIndex,
-      props: mergedProps,
-      width: overrides.width ?? width,
-      ...extraConfig,
-      ...overrides
-    };
+  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();
   };
-  stepSurfaceFactory.id = id;
-  stepSurfaceFactory.config = {
-    currentStepIndex,
-    defaultProps,
-    id,
-    steps,
-    title,
-    width,
-    ...extraConfig
+  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();
   };
-  stepSurfaceFactory.use = function useDefinedStepSurface() {
-    return useSurface(stepSurfaceFactory);
+  clearSurface = (surfaceId) => {
+    const sId = surfaceId != null ? String(surfaceId) : "global";
+    if (!this.extensionsBySurface.has(sId)) return;
+    this.extensionsBySurface.delete(sId);
+    this.notify();
   };
-  return stepSurfaceFactory;
-}
-function useSurfaceStep() {
-  const { closeSurface, goToStep, popStep, pushStep } = useDockActions();
-  const surfaceStack = useDockSelector((s) => s.surfaceStack) || EMPTY_SURFACE_STACK;
-  const activeEntry = surfaceStack[surfaceStack.length - 1] || null;
-  const steps = Array.isArray(activeEntry?.steps) ? activeEntry.steps : [];
-  const stepIndex = Number(activeEntry?.currentStepIndex || 0);
-  const stepsTotal = steps.length;
-  const currentStep = steps[stepIndex] || null;
-  const isFirst = stepIndex <= 0;
-  const isLast = stepsTotal > 0 && stepIndex >= stepsTotal - 1;
-  const next = useCallback(() => {
-    if (!isLast) goToStep(stepIndex + 1);
-  }, [goToStep, isLast, stepIndex]);
-  const prev = useCallback(() => {
-    if (!isFirst) popStep();
-  }, [isFirst, popStep]);
-  const goTo = useCallback(
-    (idx) => {
-      goToStep(idx);
-    },
-    [goToStep]
-  );
-  const push = useCallback(
-    (step) => {
-      pushStep(step);
-    },
-    [pushStep]
+};
+
+// src/modules/media/constants.ts
+var DEFAULT_MEDIA_STATE = Object.freeze({
+  audibleElement: null,
+  element: null,
+  hasMedia: false,
+  isPlaying: false,
+  kind: null,
+  loop: false,
+  sourceId: null
+});
+var INERT_MEDIA_ACTIONS = Object.freeze({
+  removeSource: () => {
+  },
+  setMuted: () => {
+  },
+  toggle: () => {
+  },
+  toggleLoop: () => {
+  },
+  upsertSource: () => {
+  }
+});
+var MediaContext = getOrCreateGlobalContext(
+  "MediaContext",
+  null
+);
+var NOOP_MEDIA_STORE = createStore(DEFAULT_MEDIA_STATE);
+function useOptionalMediaState(selector, isEqual) {
+  const ctx = useContext(MediaContext);
+  return useStore(
+    ctx?.store ?? NOOP_MEDIA_STORE,
+    selector,
+    isEqual
   );
-  return {
-    close: closeSurface,
-    currentStep,
-    goTo,
-    isFirst,
-    isLast,
-    next,
-    prev,
-    push,
-    stepIndex,
-    steps,
-    stepsTotal
-  };
 }
-function createSurfaceError(code, message) {
-  const error = new Error(message);
-  error.code = code;
-  return error;
+function useOptionalMediaActions() {
+  const ctx = useContext(MediaContext);
+  return ctx?.actions ?? INERT_MEDIA_ACTIONS;
+}
+
+// src/modules/loading/constants.ts
+var DEFAULT_LOADING_STATE = Object.freeze({
+  isLoading: false,
+  skeleton: null,
+  minDuration: 0,
+  showOverlay: true,
+  message: null
+});
+var DEFAULT_LOADING_STATE_WITH_PAGE = Object.freeze({
+  ...DEFAULT_LOADING_STATE,
+  isPageLoading: false
+});
+var INERT_LOADING_ACTIONS = Object.freeze({
+  setLoading: () => {
+  },
+  setSkeleton: () => {
+  },
+  startLoading: () => {
+  },
+  stopLoading: () => {
+  },
+  withLoading: async (task) => typeof task === "function" ? task() : task
+});
+var LoadingContext = getOrCreateGlobalContext("LoadingContext", null);
+var NOOP_LOADING_STORE = createStore(
+  DEFAULT_LOADING_STATE_WITH_PAGE
+);
+function useOptionalLoadingState(selector, isEqual) {
+  const ctx = useContext(LoadingContext);
+  return useStore(
+    ctx?.store ?? NOOP_LOADING_STORE,
+    selector,
+    isEqual
+  );
 }
-function createSurfaceFlowDefinition(input) {
-  const id = typeof input?.id === "string" ? input.id.trim() : "";
-  if (!id || typeof input?.createSurface !== "function") return null;
-  return {
-    createSurface: input.createSurface,
-    id,
-    initialSnapshot: normalizeSurfaceFlowSnapshot(input.initialSnapshot),
-    returnHandshake: createSurfaceReturnHandshake(
-      input.returnHandshake ?? ("returnTo" in input ? input.returnTo : void 0)
-    ),
-    restoreFromUrl: input.restoreFromUrl !== false,
-    singleton: input.singleton !== false
-  };
+function useOptionalLoadingActions() {
+  const ctx = useContext(LoadingContext);
+  return ctx?.actions ?? INERT_LOADING_ACTIONS;
 }
-function createSurfaceFlowSession(definition, { input = null, snapshot } = {}) {
-  if (!definition?.id) return null;
-  return {
-    flowId: definition.id,
-    input,
-    returnHandshake: resolveSurfaceFlowReturnHandshake(definition, input),
-    snapshot: snapshot === void 0 ? definition.initialSnapshot : normalizeSurfaceFlowSnapshot(snapshot),
-    status: DOCK_SURFACE_FLOW_STATUS.OPEN
-  };
+USER_MESSAGES.unauthorized;
+var INITIAL_NOTIFICATION_STATE = Object.freeze({
+  notifications: {}
+});
+var NotificationContext = getOrCreateGlobalContext(
+  "NotificationContext",
+  null
+);
+var NOOP_NOTIFICATION_STORE = createStore(
+  INITIAL_NOTIFICATION_STATE
+);
+function useOptionalNotificationState(selector, isEqual) {
+  const ctx = useContext(NotificationContext);
+  return useStore(
+    ctx?.store ?? NOOP_NOTIFICATION_STORE,
+    selector,
+    isEqual
+  );
 }
-function updateSurfaceFlowSession(session, snapshot) {
-  if (!session?.flowId) return null;
-  return { ...session, snapshot: normalizeSurfaceFlowSnapshot(snapshot) };
+function useNotificationVisible() {
+  return useOptionalNotificationState(
+    ({ notifications }) => Object.keys(notifications).length > 0
+  );
 }
 
 // src/tokens/tokens.ts
@@ -2637,190 +2214,593 @@ Object.freeze({
   duration: DURATION_TOKENS.INSTANT,
   ease: "linear"
 });
-var TAP_SCALE_SUBTLE = 0.97;
-function tween(duration, ease) {
-  return Object.freeze({ type: "tween", duration, ease });
+var TAP_SCALE_SUBTLE = 0.97;
+function tween(duration, ease) {
+  return Object.freeze({ type: "tween", duration, ease });
+}
+function safeNumber(value, fallback) {
+  const source = value && typeof value === "object" && "get" in value && typeof value.get === "function" ? value.get() : value;
+  const number = Number.parseFloat(String(source));
+  return Number.isFinite(number) ? number : fallback;
+}
+function gpuTransform(y = 0, scale = 1, x = 0) {
+  const translateY = Math.round(safeNumber(y, 0));
+  const translateX = Math.round(safeNumber(x, 0));
+  const scaleValue = Math.round(safeNumber(scale, 1) * 1e3) / 1e3;
+  return `translate3d(${translateX}px, ${translateY}px, 0) scale(${scaleValue})`;
+}
+function durationForDistance(distancePx, {
+  base = DURATION_TOKENS.FAST,
+  min = DURATION_TOKENS.MICRO,
+  max = DURATION_TOKENS.SLOW,
+  reference = 320,
+  gain = 0.22
+} = {}) {
+  const distance = Math.abs(Number(distancePx) || 0);
+  const safeMin = Math.max(0, min);
+  const safeMax = Math.max(safeMin, max);
+  const safeReference = Math.max(1, reference);
+  const duration = base + Math.sqrt(distance / safeReference) * gain;
+  return Math.min(safeMax, Math.max(safeMin, duration));
+}
+function surfaceResizeTransition(distancePx, {
+  base = DURATION_TOKENS.FAST,
+  min = DURATION_TOKENS.MICRO,
+  max = DURATION_TOKENS.SLOW,
+  reference = 320,
+  gain = 0.22,
+  ease = EASING_CURVES.IN_OUT_CUBIC
+} = {}) {
+  return tween(
+    durationForDistance(distancePx, { base, min, max, reference, gain }),
+    ease
+  );
+}
+function contentSwapTransitions({
+  duration = DURATION_TOKENS.FAST,
+  exitDuration = DURATION_TOKENS.MICRO,
+  enterEase = EASING_CURVES.OUT_EXPO,
+  exitEase = EASING_CURVES.IN_CUBIC
+} = {}) {
+  return Object.freeze({
+    enter: tween(duration, enterEase),
+    exit: tween(exitDuration, exitEase)
+  });
+}
+function contentSwap({
+  travel = 6,
+  exitTravel = travel * 0.7,
+  enterScale = 0.99,
+  exitScale = 0.99,
+  ...transitionOptions
+} = {}) {
+  const transitions = contentSwapTransitions(transitionOptions);
+  return Object.freeze({
+    hidden: Object.freeze({
+      opacity: 0,
+      transform: gpuTransform(travel, enterScale)
+    }),
+    visible: Object.freeze({
+      opacity: 1,
+      transform: gpuTransform(0),
+      transition: transitions.enter
+    }),
+    exit: Object.freeze({
+      opacity: 0,
+      transform: gpuTransform(-exitTravel, exitScale),
+      transition: transitions.exit
+    })
+  });
+}
+function overlaySurface({
+  travel = 16,
+  exitTravel = travel * 0.5,
+  enterScale = 0.97,
+  exitScale = 0.985,
+  distance,
+  duration,
+  exitDuration,
+  enterEase = EASING_CURVES.OUT_EXPO,
+  exitEase = EASING_CURVES.IN_CUBIC
+} = {}) {
+  const enterDuration = duration ?? (distance === void 0 ? DURATION_TOKENS.BASE : durationForDistance(distance));
+  const transitions = contentSwapTransitions({
+    duration: enterDuration,
+    exitDuration: exitDuration ?? enterDuration * 0.68,
+    enterEase,
+    exitEase
+  });
+  return Object.freeze({
+    hidden: Object.freeze({
+      opacity: 0,
+      transform: gpuTransform(travel, enterScale)
+    }),
+    visible: Object.freeze({
+      opacity: 1,
+      transform: gpuTransform(0),
+      transition: transitions.enter
+    }),
+    exit: Object.freeze({
+      opacity: 0,
+      transform: gpuTransform(exitTravel, exitScale),
+      transition: transitions.exit
+    })
+  });
+}
+function staggerDelay(index, { base = 0.028, cap = 0.16, exponent = 0.82 } = {}) {
+  const safeIndex = Math.max(0, Number(index) || 0);
+  return Math.min(cap, base * Math.pow(safeIndex, exponent));
+}
+function staggerItem({
+  base = 0.028,
+  cap = 0.16,
+  duration = DURATION_TOKENS.BASE,
+  travel = 10,
+  enterEase = EASING_CURVES.OUT_EXPO,
+  exitDuration = DURATION_TOKENS.MICRO,
+  exitEase = EASING_CURVES.IN_CUBIC
+} = {}) {
+  return Object.freeze({
+    hidden: Object.freeze({
+      opacity: 0,
+      transform: gpuTransform(travel, 0.985)
+    }),
+    visible: (index = 0) => ({
+      opacity: 1,
+      transform: gpuTransform(0),
+      transition: Object.freeze({
+        ...tween(duration, enterEase),
+        delay: staggerDelay(index, { base, cap })
+      })
+    }),
+    exit: Object.freeze({
+      opacity: 0,
+      transform: gpuTransform(-travel * 0.6, 0.99),
+      transition: tween(exitDuration, exitEase)
+    })
+  });
+}
+function chip({
+  duration = DURATION_TOKENS.FAST,
+  exitDuration = DURATION_TOKENS.MICRO,
+  enterEase = EASING_CURVES.IN_OUT_CUBIC,
+  exitEase = EASING_CURVES.IN_CUBIC
+} = {}) {
+  const transitions = contentSwapTransitions({
+    duration,
+    exitDuration,
+    enterEase,
+    exitEase
+  });
+  return Object.freeze({
+    hidden: Object.freeze({ opacity: 0, transform: gpuTransform(0, 0.96) }),
+    visible: Object.freeze({
+      opacity: 1,
+      transform: gpuTransform(0),
+      transition: transitions.enter
+    }),
+    exit: Object.freeze({
+      opacity: 0,
+      transform: gpuTransform(0, 0.96),
+      transition: transitions.exit
+    })
+  });
+}
+function press({
+  tapScale = TAP_SCALE_SUBTLE,
+  spring = SPRING_PRESETS.MICRO
+} = {}) {
+  return Object.freeze({
+    variants: Object.freeze({
+      idle: Object.freeze({ transform: gpuTransform(0, 1) }),
+      hover: Object.freeze({ transform: gpuTransform(0, 1) }),
+      tap: Object.freeze({ transform: gpuTransform(0, tapScale) })
+    }),
+    transition: Object.freeze({ type: "spring", ...spring })
+  });
+}
+
+// src/modules/dock/context.ts
+var DockContext = getOrCreateGlobalContext(
+  "DockContext",
+  null
+);
+function useDockState() {
+  const { store } = useRequiredContext(
+    DockContext,
+    "useDockState",
+    "DockProvider"
+  );
+  return useStore(store);
+}
+function useDockSelector(selector, isEqual = Object.is) {
+  const { store } = useRequiredContext(
+    DockContext,
+    "useDockSelector",
+    "DockProvider"
+  );
+  return useStore(store, selector, isEqual);
+}
+function useDockActions() {
+  return useRequiredContext(DockContext, "useDockActions", "DockProvider").actions;
+}
+function useDockHeight() {
+  const dockHeight = useDockSelector((state) => state.dockHeight);
+  return { dockHeight, padding: { paddingBottom: `${dockHeight}px` } };
+}
+var EMPTY_DOCK_STATE = Object.freeze({
+  activeItem: null,
+  activeOperation: null,
+  activeSurfaceEntry: null,
+  activeSurfaceId: null,
+  contextActions: [],
+  dockContinuity: [],
+  dockHeight: 0,
+  dockReturnHandoffs: [],
+  expanded: false,
+  hud: null,
+  hudEntries: [],
+  isHudActive: false,
+  isSurfaceOpen: false,
+  locationKey: "",
+  operations: [],
+  pathname: "",
+  searchQuery: "",
+  selectionMode: null,
+  surfaceLifecycle: "",
+  surfacePhase: "",
+  surfaceStack: []
+});
+var NOOP_DOCK_STORE = createStore(EMPTY_DOCK_STATE);
+function useOptionalDockState(selector, isEqual) {
+  const ctx = useContext(DockContext);
+  return useStore(
+    ctx?.store ?? NOOP_DOCK_STORE,
+    selector,
+    isEqual
+  );
 }
-function safeNumber(value, fallback) {
-  const source = value && typeof value === "object" && "get" in value && typeof value.get === "function" ? value.get() : value;
-  const number = Number.parseFloat(String(source));
-  return Number.isFinite(number) ? number : fallback;
+function useOptionalDockActions() {
+  const ctx = useContext(DockContext);
+  return ctx?.actions ?? null;
 }
-function gpuTransform(y = 0, scale = 1, x = 0) {
-  const translateY = Math.round(safeNumber(y, 0));
-  const translateX = Math.round(safeNumber(x, 0));
-  const scaleValue = Math.round(safeNumber(scale, 1) * 1e3) / 1e3;
-  return `translate3d(${translateX}px, ${translateY}px, 0) scale(${scaleValue})`;
+function useDockMedia() {
+  return useOptionalMediaState((state) => state, shallowEqual);
 }
-function durationForDistance(distancePx, {
-  base = DURATION_TOKENS.FAST,
-  min = DURATION_TOKENS.MICRO,
-  max = DURATION_TOKENS.SLOW,
-  reference = 320,
-  gain = 0.22
-} = {}) {
-  const distance = Math.abs(Number(distancePx) || 0);
-  const safeMin = Math.max(0, min);
-  const safeMax = Math.max(safeMin, max);
-  const safeReference = Math.max(1, reference);
-  const duration = base + Math.sqrt(distance / safeReference) * gain;
-  return Math.min(safeMax, Math.max(safeMin, duration));
+function useDockHasMedia() {
+  return useOptionalMediaState((state) => state.hasMedia);
 }
-function surfaceResizeTransition(distancePx, {
-  base = DURATION_TOKENS.FAST,
-  min = DURATION_TOKENS.MICRO,
-  max = DURATION_TOKENS.SLOW,
-  reference = 320,
-  gain = 0.22,
-  ease = EASING_CURVES.IN_OUT_CUBIC
+var useDockMediaActions = useOptionalMediaActions;
+function useDockLoadingState() {
+  return useOptionalLoadingState();
+}
+var useDockLoadingActions = useOptionalLoadingActions;
+var useDockNotificationVisible = useNotificationVisible;
+var statusActionDefaults = { error: null, guard: null };
+
+// src/modules/dock/surface/definition.ts
+var isNormalizedExtension = (extension) => extension !== null;
+function normalizeExtensions(raw) {
+  if (!raw) return [];
+  return (Array.isArray(raw) ? raw : [raw]).map(normalizeSurfaceExtension).filter(isNormalizedExtension);
+}
+function normalizeSurfaceDefinition(input, config = {}, {
+  allowPrimitiveContent = false,
+  defaultShowAction = false
 } = {}) {
-  return tween(
-    durationForDistance(distancePx, { base, min, max, reference, gain }),
-    ease
+  const descriptor = isSurfaceDescriptor(input) && (isValidComponentType(input.component) || typeof input.loader === "function" || "content" in input || "node" in input || "element" in input || Array.isArray(input.steps) && input.steps.length > 0) ? input : null;
+  const configuredSteps = descriptor?.steps ?? config?.steps;
+  const steps = Array.isArray(configuredSteps) && configuredSteps.length > 0 ? configuredSteps : null;
+  const firstStep = steps?.[0] ?? null;
+  const rawComponent = resolveComponentType(
+    descriptor?.component,
+    descriptor ? null : input,
+    firstStep?.component,
+    firstStep
+  );
+  const component = rawComponent ?? (typeof descriptor?.loader === "function" ? lazy(descriptor.loader) : typeof firstStep?.loader === "function" ? lazy(firstStep.loader) : null);
+  const explicitContent = resolveRenderableContent(
+    descriptor?.content,
+    descriptor?.node,
+    descriptor?.element,
+    firstStep?.content,
+    firstStep?.node,
+    firstStep?.element
+  );
+  const fallbackContent = !descriptor && !component && (isValidElement(input) || allowPrimitiveContent && input != null) ? input : null;
+  const content = explicitContent ?? fallbackContent;
+  if (!component && content == null && !steps) return null;
+  const directComponentInput = !descriptor && isValidComponentType(input);
+  const extensions = normalizeExtensions(
+    descriptor?.extensions ?? config?.extensions
+  );
+  return {
+    renderMode: component ? DOCK_SURFACE_RENDER_MODE.COMPONENT : DOCK_SURFACE_RENDER_MODE.NODE,
+    component,
+    content: component ? null : content ?? input,
+    props: component ? isPlainObject(descriptor?.props) ? descriptor.props : directComponentInput ? config : {} : {},
+    action: descriptor?.action ?? config?.action ?? null,
+    showAction: descriptor?.showAction ?? config?.showAction ?? defaultShowAction,
+    dismissible: descriptor?.dismissible ?? config?.dismissible ?? true,
+    onClose: descriptor?.onClose ?? config?.onClose ?? null,
+    icon: descriptor?.icon ?? descriptor?.header?.icon ?? config?.icon ?? config?.header?.icon ?? null,
+    title: descriptor?.title ?? descriptor?.header?.title ?? config?.title ?? config?.header?.title ?? null,
+    description: descriptor?.description ?? descriptor?.header?.description ?? config?.description ?? config?.header?.description ?? null,
+    descriptionMaxLines: descriptor?.descriptionMaxLines ?? config?.descriptionMaxLines ?? 2,
+    trailing: descriptor?.trailing ?? config?.trailing ?? null,
+    headerAction: descriptor?.headerAction ?? config?.headerAction ?? null,
+    closeLabel: descriptor?.closeLabel ?? config?.closeLabel ?? null,
+    width: descriptor?.width ?? config?.width ?? null,
+    allowSwipeDismiss: descriptor?.allowSwipeDismiss ?? config?.allowSwipeDismiss ?? true,
+    skipActionDismiss: descriptor?.skipActionDismiss ?? config?.skipActionDismiss ?? true,
+    steps,
+    currentStepIndex: descriptor?.currentStepIndex ?? config?.currentStepIndex ?? 0,
+    syncWithUrl: descriptor?.syncWithUrl ?? config?.syncWithUrl ?? false,
+    urlKey: descriptor?.urlKey ?? config?.urlKey ?? null,
+    badge: descriptor?.badge ?? config?.badge ?? null,
+    extensions
+  };
+}
+function createSurfaceEntryDefinition(input, config = {}) {
+  return normalizeSurfaceDefinition(input, config);
+}
+function createSurfaceFlowBuilder(definition = {}) {
+  const {
+    action = null,
+    allowSwipeDismiss = true,
+    badge = null,
+    closeLabel = null,
+    component = null,
+    loader,
+    defaultProps = {},
+    description = null,
+    descriptionMaxLines = 2,
+    dismissible = true,
+    extensions = [],
+    headerAction = null,
+    icon = null,
+    id = null,
+    onClose = null,
+    showAction = null,
+    syncWithUrl = false,
+    title = null,
+    trailing = null,
+    urlKey = null,
+    width = null,
+    ...extraConfig
+  } = definition;
+  const resolvedComponent = component ?? (typeof loader === "function" ? lazy(loader) : null);
+  const createEntry = function surfaceEntryFactory2(props = {}, overrides = {}) {
+    const mergedProps = { ...defaultProps, ...props };
+    const resolvedTitle = typeof title === "function" ? title(mergedProps) : title;
+    const resolvedDescription = typeof description === "function" ? description(mergedProps) : description;
+    const resolvedIcon = typeof icon === "function" ? icon(mergedProps) : icon;
+    return {
+      id: overrides.id ?? id,
+      component: overrides.component ?? resolvedComponent,
+      loader: overrides.loader ?? loader,
+      props: mergedProps,
+      title: resolvedTitle,
+      description: resolvedDescription,
+      icon: resolvedIcon,
+      action,
+      allowSwipeDismiss,
+      badge,
+      closeLabel,
+      descriptionMaxLines,
+      dismissible,
+      extensions,
+      headerAction,
+      onClose,
+      showAction,
+      syncWithUrl,
+      trailing,
+      urlKey,
+      width,
+      ...extraConfig,
+      ...overrides
+    };
+  };
+  const surfaceEntryFactory = Object.assign(
+    createEntry,
+    {
+      component: resolvedComponent,
+      id,
+      isSurfaceFactory: true,
+      open: (openSurfaceFn, props = {}, overrides = {}) => {
+        if (typeof openSurfaceFn === "function") {
+          return openSurfaceFn(createEntry(props, overrides));
+        }
+      }
+    }
+  );
+  return surfaceEntryFactory;
+}
+function createInlineSurfaceEntry(surface) {
+  return normalizeSurfaceDefinition(
+    surface,
+    {},
+    { allowPrimitiveContent: true, defaultShowAction: null }
+  );
+}
+var EMPTY_SURFACE_STACK = [];
+function useSurface(surfaceDefinition) {
+  const { closeAllSurfaces, closeSurface, openSurface } = useDockActions();
+  const rawSurfaceStack = useDockSelector(
+    (s) => s.surfaceStack
+  );
+  const surfaceStack = rawSurfaceStack || EMPTY_SURFACE_STACK;
+  const specificSurface = useMemo(() => {
+    if (!surfaceDefinition) return null;
+    const targetComponent = typeof surfaceDefinition === "string" ? null : typeof surfaceDefinition === "function" ? surfaceDefinition.component || surfaceDefinition : surfaceDefinition.component || null;
+    const matchingEntry = surfaceStack.find(
+      (entry) => targetComponent && entry.component === targetComponent
+    ) ?? null;
+    const isThisSurfaceOpen = Boolean(matchingEntry);
+    const open = (props, overrides) => {
+      const entry = typeof surfaceDefinition === "function" ? surfaceDefinition(props, overrides) : typeof surfaceDefinition === "string" ? { id: surfaceDefinition, props, ...overrides } : {
+        ...surfaceDefinition,
+        props: { ...surfaceDefinition.props || {}, ...props },
+        ...overrides
+      };
+      return openSurface(entry);
+    };
+    const close = (res) => closeSurface(res, matchingEntry?.id ?? null);
+    const result = [
+      open,
+      {
+        close,
+        closeAll: closeAllSurfaces,
+        isOpen: isThisSurfaceOpen,
+        surfaceStack
+      }
+    ];
+    result.open = open;
+    result.close = close;
+    result.closeAll = closeAllSurfaces;
+    result.isOpen = isThisSurfaceOpen;
+    result.surfaceStack = surfaceStack;
+    return result;
+  }, [
+    closeAllSurfaces,
+    closeSurface,
+    openSurface,
+    surfaceDefinition,
+    surfaceStack
+  ]);
+  const generalSurface = useMemo(
+    () => ({
+      closeAllSurfaces,
+      closeSurface,
+      openSurface,
+      surfaceStack
+    }),
+    [closeAllSurfaces, closeSurface, openSurface, surfaceStack]
   );
+  return surfaceDefinition ? specificSurface : generalSurface;
 }
-function contentSwapTransitions({
-  duration = DURATION_TOKENS.FAST,
-  exitDuration = DURATION_TOKENS.MICRO,
-  enterEase = EASING_CURVES.OUT_EXPO,
-  exitEase = EASING_CURVES.IN_CUBIC
-} = {}) {
-  return Object.freeze({
-    enter: tween(duration, enterEase),
-    exit: tween(exitDuration, exitEase)
-  });
+function defineSurface(definition = {}) {
+  const factory = createSurfaceFlowBuilder(definition);
+  factory.config = definition;
+  factory.use = function useDefinedSurface() {
+    return useSurface(factory);
+  };
+  return factory;
 }
-function contentSwap({
-  travel = 6,
-  exitTravel = travel * 0.7,
-  enterScale = 0.99,
-  exitScale = 0.99,
-  ...transitionOptions
-} = {}) {
-  const transitions = contentSwapTransitions(transitionOptions);
-  return Object.freeze({
-    hidden: Object.freeze({
-      opacity: 0,
-      transform: gpuTransform(travel, enterScale)
-    }),
-    visible: Object.freeze({
-      opacity: 1,
-      transform: gpuTransform(0),
-      transition: transitions.enter
-    }),
-    exit: Object.freeze({
-      opacity: 0,
-      transform: gpuTransform(-exitTravel, exitScale),
-      transition: transitions.exit
-    })
-  });
+function defineStepSurface(definition = {}) {
+  const {
+    currentStepIndex = 0,
+    defaultProps = {},
+    id = "wizard-surface",
+    steps = [],
+    title = null,
+    width = null,
+    ...extraConfig
+  } = definition;
+  const stepSurfaceFactory = function stepSurfaceFactory2(props = {}, overrides = {}) {
+    const mergedProps = { ...defaultProps, ...props };
+    const resolvedTitle = typeof title === "function" ? title(mergedProps) : title;
+    const resolvedSteps = typeof steps === "function" ? steps(mergedProps) : steps;
+    return {
+      id: overrides.id ?? id,
+      title: overrides.title ?? resolvedTitle,
+      steps: resolvedSteps,
+      currentStepIndex: overrides.currentStepIndex ?? currentStepIndex,
+      props: mergedProps,
+      width: overrides.width ?? width,
+      ...extraConfig,
+      ...overrides
+    };
+  };
+  stepSurfaceFactory.id = id;
+  stepSurfaceFactory.config = {
+    currentStepIndex,
+    defaultProps,
+    id,
+    steps,
+    title,
+    width,
+    ...extraConfig
+  };
+  stepSurfaceFactory.use = function useDefinedStepSurface() {
+    return useSurface(stepSurfaceFactory);
+  };
+  return stepSurfaceFactory;
 }
-function overlaySurface({
-  travel = 16,
-  exitTravel = travel * 0.5,
-  enterScale = 0.97,
-  exitScale = 0.985,
-  distance,
-  duration,
-  exitDuration,
-  enterEase = EASING_CURVES.OUT_EXPO,
-  exitEase = EASING_CURVES.IN_CUBIC
-} = {}) {
-  const enterDuration = duration ?? (distance === void 0 ? DURATION_TOKENS.BASE : durationForDistance(distance));
-  const transitions = contentSwapTransitions({
-    duration: enterDuration,
-    exitDuration: exitDuration ?? enterDuration * 0.68,
-    enterEase,
-    exitEase
-  });
-  return Object.freeze({
-    hidden: Object.freeze({
-      opacity: 0,
-      transform: gpuTransform(travel, enterScale)
-    }),
-    visible: Object.freeze({
-      opacity: 1,
-      transform: gpuTransform(0),
-      transition: transitions.enter
-    }),
-    exit: Object.freeze({
-      opacity: 0,
-      transform: gpuTransform(exitTravel, exitScale),
-      transition: transitions.exit
-    })
-  });
+function useSurfaceStep() {
+  const { closeSurface, goToStep, popStep, pushStep } = useDockActions();
+  const surfaceStack = useDockSelector((s) => s.surfaceStack) || EMPTY_SURFACE_STACK;
+  const activeEntry = surfaceStack[surfaceStack.length - 1] || null;
+  const steps = Array.isArray(activeEntry?.steps) ? activeEntry.steps : [];
+  const stepIndex = Number(activeEntry?.currentStepIndex || 0);
+  const stepsTotal = steps.length;
+  const currentStep = steps[stepIndex] || null;
+  const isFirst = stepIndex <= 0;
+  const isLast = stepsTotal > 0 && stepIndex >= stepsTotal - 1;
+  const next = useCallback(() => {
+    if (!isLast) goToStep(stepIndex + 1);
+  }, [goToStep, isLast, stepIndex]);
+  const prev = useCallback(() => {
+    if (!isFirst) popStep();
+  }, [isFirst, popStep]);
+  const goTo = useCallback(
+    (idx) => {
+      goToStep(idx);
+    },
+    [goToStep]
+  );
+  const push = useCallback(
+    (step) => {
+      pushStep(step);
+    },
+    [pushStep]
+  );
+  return {
+    close: closeSurface,
+    currentStep,
+    goTo,
+    isFirst,
+    isLast,
+    next,
+    prev,
+    push,
+    stepIndex,
+    steps,
+    stepsTotal
+  };
 }
-function staggerDelay(index, { base = 0.028, cap = 0.16, exponent = 0.82 } = {}) {
-  const safeIndex = Math.max(0, Number(index) || 0);
-  return Math.min(cap, base * Math.pow(safeIndex, exponent));
+function createSurfaceError(code, message) {
+  const error = new Error(message);
+  error.code = code;
+  return error;
 }
-function staggerItem({
-  base = 0.028,
-  cap = 0.16,
-  duration = DURATION_TOKENS.BASE,
-  travel = 10,
-  enterEase = EASING_CURVES.OUT_EXPO,
-  exitDuration = DURATION_TOKENS.MICRO,
-  exitEase = EASING_CURVES.IN_CUBIC
-} = {}) {
-  return Object.freeze({
-    hidden: Object.freeze({
-      opacity: 0,
-      transform: gpuTransform(travel, 0.985)
-    }),
-    visible: (index = 0) => ({
-      opacity: 1,
-      transform: gpuTransform(0),
-      transition: Object.freeze({
-        ...tween(duration, enterEase),
-        delay: staggerDelay(index, { base, cap })
-      })
-    }),
-    exit: Object.freeze({
-      opacity: 0,
-      transform: gpuTransform(-travel * 0.6, 0.99),
-      transition: tween(exitDuration, exitEase)
-    })
-  });
+function createSurfaceFlowDefinition(input) {
+  const id = typeof input?.id === "string" ? input.id.trim() : "";
+  if (!id || typeof input?.createSurface !== "function") return null;
+  return {
+    createSurface: input.createSurface,
+    id,
+    initialSnapshot: normalizeSurfaceFlowSnapshot(input.initialSnapshot),
+    returnHandshake: createSurfaceReturnHandshake(
+      input.returnHandshake ?? ("returnTo" in input ? input.returnTo : void 0)
+    ),
+    restoreFromUrl: input.restoreFromUrl !== false,
+    singleton: input.singleton !== false
+  };
 }
-function chip({
-  duration = DURATION_TOKENS.FAST,
-  exitDuration = DURATION_TOKENS.MICRO,
-  enterEase = EASING_CURVES.IN_OUT_CUBIC,
-  exitEase = EASING_CURVES.IN_CUBIC
-} = {}) {
-  const transitions = contentSwapTransitions({
-    duration,
-    exitDuration,
-    enterEase,
-    exitEase
-  });
-  return Object.freeze({
-    hidden: Object.freeze({ opacity: 0, transform: gpuTransform(0, 0.96) }),
-    visible: Object.freeze({
-      opacity: 1,
-      transform: gpuTransform(0),
-      transition: transitions.enter
-    }),
-    exit: Object.freeze({
-      opacity: 0,
-      transform: gpuTransform(0, 0.96),
-      transition: transitions.exit
-    })
-  });
+function createSurfaceFlowSession(definition, { input = null, snapshot } = {}) {
+  if (!definition?.id) return null;
+  return {
+    flowId: definition.id,
+    input,
+    returnHandshake: resolveSurfaceFlowReturnHandshake(definition, input),
+    snapshot: snapshot === void 0 ? definition.initialSnapshot : normalizeSurfaceFlowSnapshot(snapshot),
+    status: DOCK_SURFACE_FLOW_STATUS.OPEN
+  };
 }
-function press({
-  tapScale = TAP_SCALE_SUBTLE,
-  spring = SPRING_PRESETS.MICRO
-} = {}) {
-  return Object.freeze({
-    variants: Object.freeze({
-      idle: Object.freeze({ transform: gpuTransform(0, 1) }),
-      hover: Object.freeze({ transform: gpuTransform(0, 1) }),
-      tap: Object.freeze({ transform: gpuTransform(0, tapScale) })
-    }),
-    transition: Object.freeze({ type: "spring", ...spring })
-  });
+function updateSurfaceFlowSession(session, snapshot) {
+  if (!session?.flowId) return null;
+  return { ...session, snapshot: normalizeSurfaceFlowSnapshot(snapshot) };
 }
 
 // src/modules/dock/motion.ts
@@ -12106,6 +12086,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, 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, useHud, useOptionalDockActions, useOptionalDockState, useSurface, useSurfaceAction, useSurfaceDimensions, useSurfaceFlow, useSurfaceHeader, useSurfaceId, useSurfaceReturn, useSurfaceStep };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map