@softize/opus 29.0.0 → 31.0.0

package/src/ui/components/patterns/page-heading-context.tsx

@@ -6,9 +6,9 @@ import {
   type ReactNode,
 } from "react";
 
-const PageHeadingPresenceContext = createContext<
-  (() => () => void) | null
->(null);
+const PageHeadingPresenceContext = createContext<(() => () => void) | null>(
+  null,
+);
 
 export function PageHeadingPresenceProvider({
   register,
@@ -25,10 +25,17 @@ export function PageHeadingPresenceProvider({
 }
 
 /** Integração interna para headings que podem nascer dentro de boundaries intermediários. */
-export function usePageHeadingPresence(active = true): void {
+export function usePageHeadingPresence(
+  active = true,
+  source: "page" | "surface" = "page",
+): void {
   const register = useContext(PageHeadingPresenceContext);
   useLayoutEffect(() => {
     if (!active || register === null) return;
     return register();
-  }, [active, register]);
+  }, [active, register, source]);
+  if (active && register !== null && source === "surface")
+    throw new Error(
+      "Page explícito exige exatamente um heading principal em PageHeader ou PageState ativo dentro de PageBody.",
+    );
 }