@omerdlw/base-framework 1.0.4 → 1.0.6

package/dist/modules/dock/index.js

@@ -423,308 +423,6 @@ function Button({
   );
 }
 Button.displayName = "Button";
-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 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 isHudDescriptor(value) {
-  return isObject(value) && !isValidElement(value) && ("component" in value || "content" in value || "node" in value || "element" in value || "isActive" in value || "id" in value);
-}
-function createDockScheduler(options = {}) {
-  return createScheduler({
-    defaultLabel: "dock-task",
-    ...options
-  });
-}
-
-// src/modules/dock/paths.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}`;
-}
-
-// src/modules/dock/surface/helpers.ts
-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 });
-}
-
-// 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();
-  };
-};
 
 // src/kernel/constants.ts
 var DEFAULT_SOURCE = "dynamic";
@@ -1498,96 +1196,417 @@ function useAppliedRegistryConfig(payload, context, componentSlices) {
       context,
       payload
     };
-  });
-  useIsomorphicLayoutEffect(
-    () => () => {
-      appliedRef.current?.cleanup();
-      appliedRef.current = null;
-    },
-    []
-  );
-}
-function createRegistryApplyContext(actions, {
-  cleanupScope = /* @__PURE__ */ new Map(),
-  instanceId,
-  modules = [],
-  pathname
-}) {
-  const stamp = (queue) => ({
-    register: (type, key, item, sourceOrOptions, optionsArg) => queue.register(
-      type,
-      key,
-      item,
-      ...resolveRegisterArgsWithInstance(
-        instanceId,
-        sourceOrOptions,
-        optionsArg
-      )
-    ),
-    unregister: (type, key, sourceOrOptions) => queue.unregister(
-      type,
-      key,
-      withInstanceIdForUnregister(instanceId, sourceOrOptions)
-    )
-  });
+  });
+  useIsomorphicLayoutEffect(
+    () => () => {
+      appliedRef.current?.cleanup();
+      appliedRef.current = null;
+    },
+    []
+  );
+}
+function createRegistryApplyContext(actions, {
+  cleanupScope = /* @__PURE__ */ new Map(),
+  instanceId,
+  modules = [],
+  pathname
+}) {
+  const stamp = (queue) => ({
+    register: (type, key, item, sourceOrOptions, optionsArg) => queue.register(
+      type,
+      key,
+      item,
+      ...resolveRegisterArgsWithInstance(
+        instanceId,
+        sourceOrOptions,
+        optionsArg
+      )
+    ),
+    unregister: (type, key, sourceOrOptions) => queue.unregister(
+      type,
+      key,
+      withInstanceIdForUnregister(instanceId, sourceOrOptions)
+    )
+  });
+  return {
+    ...stamp(actions),
+    batch: (executor) => typeof executor === "function" ? actions.batch((queue) => executor(stamp(queue))) : 0,
+    cleanupScope,
+    instanceId,
+    modules,
+    pathname
+  };
+}
+function useRegistry(config, metadata) {
+  const { batch, register, unregister } = useRegistryActions();
+  const pathname = usePathname();
+  const modules = useInstalledModules();
+  const instanceId = `registry-instance-${useId()}`;
+  const [cleanupScope] = useState(
+    () => /* @__PURE__ */ new Map()
+  );
+  const context = useMemo(
+    () => createRegistryApplyContext(
+      { batch, register, unregister },
+      {
+        cleanupScope,
+        instanceId,
+        modules,
+        pathname
+      }
+    ),
+    [batch, cleanupScope, instanceId, modules, pathname, register, unregister]
+  );
+  const payload = useMemo(
+    () => config ? createModulePayload(modules, config, metadata) : null,
+    [config, metadata, modules]
+  );
+  const componentSlices = useMemo(
+    () => new Set(
+      modules.filter(
+        (coreModule) => coreModule.registry?.valueKind === "component"
+      ).map((coreModule) => coreModule.id)
+    ),
+    [modules]
+  );
+  useAppliedRegistryConfig(payload, context, componentSlices);
+}
+function defineModule(coreModule) {
+  return Object.freeze({ ...coreModule });
+}
+createStore(void 0);
+
+// src/kernel/adapters.ts
+function useModuleRegistration(id, value, options) {
+  const coreModule = useInstalledModules().find(
+    (candidate) => candidate.id === id
+  );
+  const config = coreModule && options?.enabled !== false && value != null ? { [id]: value } : null;
+  useRegistry(config, pickRegistryMetadata(options));
+}
+function 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 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 isHudDescriptor(value) {
+  return isObject(value) && !isValidElement(value) && ("component" in value || "content" in value || "node" in value || "element" in value || "isActive" in value || "id" in value);
+}
+function createDockScheduler(options = {}) {
+  return createScheduler({
+    defaultLabel: "dock-task",
+    ...options
+  });
+}
+
+// src/modules/dock/paths.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}`;
+}
+
+// src/modules/dock/surface/helpers.ts
+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" && extension.content !== "" || 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 {
-    ...stamp(actions),
-    batch: (executor) => typeof executor === "function" ? actions.batch((queue) => executor(stamp(queue))) : 0,
-    cleanupScope,
-    instanceId,
-    modules,
-    pathname
+    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 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 normalizeSurfaceFlowSnapshot(value) {
+  if (!isPlainObject(value)) return null;
+  return { ...value };
 }
-function defineModule(coreModule) {
-  return Object.freeze({ ...coreModule });
+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 });
 }
-createStore(void 0);
 
-// src/kernel/adapters.ts
-function useModuleRegistration(id, value, options) {
-  const coreModule = useInstalledModules().find(
-    (candidate) => candidate.id === id
+// src/modules/dock/surface/context.tsx
+var SurfaceExtensionsContext = getOrCreateGlobalContext("SurfaceExtensionsContext", null);
+var SurfaceItemContext = getOrCreateGlobalContext("SurfaceItemContext", {
+  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]
   );
-  const config = coreModule && options?.enabled !== false && value != null ? { [id]: value } : null;
-  useRegistry(config, pickRegistryMetadata(options));
 }
-
-// src/theme.tsx
+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) : "active";
+    const { actionsBySurface } = this.store.getSnapshot();
+    return actionsBySurface[sId] ?? actionsBySurface.active ?? actionsBySurface.global ?? null;
+  };
+  setAction = (surfaceId, action) => {
+    const sId = surfaceId != null ? String(surfaceId) : "active";
+    const current = this.store.getSnapshot();
+    if (current.actionsBySurface[sId] === action) return;
+    this.store.setState({
+      actionsBySurface: {
+        ...current.actionsBySurface,
+        [sId]: action
+      },
+      version: current.version + 1
+    });
+  };
+  removeAction = (surfaceId) => {
+    const sId = surfaceId != null ? String(surfaceId) : "active";
+    const current = this.store.getSnapshot();
+    if (!(sId in current.actionsBySurface)) return;
+    const { [sId]: _, ...nextActions } = current.actionsBySurface;
+    this.store.setState({
+      actionsBySurface: nextActions,
+      version: current.version + 1
+    });
+  };
+  clearSurface = (surfaceId) => this.removeAction(surfaceId);
+};
+var SurfaceExtensionsStore = class {
+  extensionsBySurface = /* @__PURE__ */ new Map();
+  cachedListBySurface = /* @__PURE__ */ new Map();
+  store = createStore({ version: 0 });
+  get version() {
+    return this.store.getSnapshot().version;
+  }
+  subscribe = (listener) => this.store.subscribe(listener);
+  notify = () => {
+    this.cachedListBySurface.clear();
+    this.store.setState((prev) => ({ version: prev.version + 1 }));
+  };
+  getExtensionsForSurface = (surfaceId) => {
+    const sId = surfaceId != null ? String(surfaceId) : "active";
+    if (this.cachedListBySurface.has(sId))
+      return this.cachedListBySurface.get(sId);
+    const globalExts = this.extensionsBySurface.get("global");
+    const activeExts = this.extensionsBySurface.get("active");
+    const surfaceExts = sId !== "global" && sId !== "active" ? this.extensionsBySurface.get(sId) : void 0;
+    let fallbackExts;
+    if (!globalExts && !activeExts && !surfaceExts && this.extensionsBySurface.size > 0) {
+      for (const map of this.extensionsBySurface.values()) {
+        if (map.size > 0) {
+          fallbackExts = map;
+          break;
+        }
+      }
+    }
+    if (!globalExts && !activeExts && !surfaceExts && !fallbackExts) {
+      const empty = [];
+      this.cachedListBySurface.set(sId, empty);
+      return empty;
+    }
+    const merged = new Map([
+      ...globalExts || [],
+      ...activeExts || [],
+      ...surfaceExts || [],
+      ...fallbackExts || []
+    ]);
+    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) : "active";
+    let surfaceMap = this.extensionsBySurface.get(sId);
+    if (!surfaceMap) {
+      surfaceMap = /* @__PURE__ */ new Map();
+      this.extensionsBySurface.set(sId, surfaceMap);
+    }
+    const prev = surfaceMap.get(normalized.id);
+    if (prev && prev.content === normalized.content && prev.align === normalized.align && prev.order === normalized.order && prev.className === normalized.className && prev.unstyled === normalized.unstyled && prev.component === normalized.component && prev.props === normalized.props)
+      return;
+    surfaceMap.set(normalized.id, normalized);
+    this.notify();
+  };
+  removeExtension = (surfaceId, extensionId) => {
+    if (!extensionId) return;
+    const sId = surfaceId != null ? String(surfaceId) : "active";
+    let removed = false;
+    for (const [key, map] of this.extensionsBySurface.entries()) {
+      if (key === sId || key === "active" || key === "global") {
+        if (map.has(extensionId)) {
+          map.delete(extensionId);
+          if (map.size === 0) this.extensionsBySurface.delete(key);
+          removed = true;
+        }
+      }
+    }
+    if (removed) this.notify();
+  };
+  clearSurface = (surfaceId) => {
+    const sId = surfaceId != null ? String(surfaceId) : "active";
+    this.extensionsBySurface.delete(sId);
+    this.extensionsBySurface.delete("active");
+    this.notify();
+  };
+};
 function defineThemeSpec(id) {
   return Object.freeze({ id });
 }
@@ -4304,7 +4323,7 @@ function useDockSurfaceControlsModel({
   const phase = propSurfacePhase ?? activeItem?.surfacePhase;
   const isBodyVisible = phase ? phase === DOCK_SURFACE_PHASE.EXPANDING_BODY || phase === DOCK_SURFACE_PHASE.OPEN : true;
   const actionStore = use(SurfaceExtensionsContext)?.headerActions ?? null;
-  const surfaceId = activeItem?.surfaceId || "global";
+  const surfaceId = activeItem?.surfaceId || "active";
   const subscribeAction = useCallback(
     (onStoreChange) => actionStore ? actionStore.subscribe(onStoreChange) : () => {
     },
@@ -4334,34 +4353,47 @@ function useDockSurfaceExtension({
   align = "left",
   children,
   className = "",
+  component,
   id,
   order = 0,
+  props: extensionProps,
   unstyled = false
 }) {
   const store = use(SurfaceExtensionsContext)?.extensions ?? null;
   const surfaceId = useSurfaceId();
   const generatedId = useId();
   const effectiveId = id || `dock-surface-ext-${generatedId}`;
-  useEffect(() => {
+  useIsomorphicLayoutEffect(() => {
     if (!store) return;
-    store.setExtension(surfaceId, {
+    const extension = {
       align,
       className,
+      component: component ?? null,
       content: children,
       id: effectiveId,
       order,
+      props: extensionProps ?? {},
       unstyled
-    });
+    };
+    store.setExtension(surfaceId, extension);
+    if (surfaceId && surfaceId !== "active") {
+      store.setExtension("active", extension);
+    }
   });
-  useEffect(() => {
+  useIsomorphicLayoutEffect(() => {
     return () => {
-      if (store) store.removeExtension(surfaceId, effectiveId);
+      if (store) {
+        store.removeExtension(surfaceId, effectiveId);
+        if (surfaceId && surfaceId !== "active") {
+          store.removeExtension("active", effectiveId);
+        }
+      }
     };
   }, [store, surfaceId, effectiveId]);
 }
 function useIsSurfaceExtensionsVisible(activeItem) {
   const store = use(SurfaceExtensionsContext)?.extensions ?? null;
-  const surfaceId = activeItem?.surfaceId || "global";
+  const surfaceId = activeItem?.surfaceId || "active";
   const isSurface = Boolean(activeItem?.isSurface);
   const phase = activeItem?.surfacePhase;
   const isBodyVisible = phase === DOCK_SURFACE_PHASE.EXPANDING_BODY || phase === DOCK_SURFACE_PHASE.OPEN;
@@ -4380,14 +4412,14 @@ function useIsSurfaceExtensionsVisible(activeItem) {
     return Array.isArray(raw) ? raw.length : 0;
   }, [activeItem?.surfaceExtensions, activeItem?.extensions]);
   return Boolean(
-    isSurface && isBodyVisible && (dynamicCount > 0 || descriptorCount > 0)
+    isSurface && (isBodyVisible && dynamicCount > 0 || descriptorCount > 0)
   );
 }
 function useDockSurfaceExtensionsBarModel({
   activeItem
 }) {
   const store = use(SurfaceExtensionsContext)?.extensions ?? null;
-  const surfaceId = activeItem?.surfaceId || "global";
+  const surfaceId = activeItem?.surfaceId || "active";
   const subscribe2 = useCallback(
     (onStoreChange) => store ? store.subscribe(onStoreChange) : () => {
     },