@ydtb/tk-scope-app 0.14.7

package/dist/src/contexts/navigation/NavigationContext.js

@@ -0,0 +1,294 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useState, useCallback, useEffect, useRef, useMemo, } from "react";
+import { useScopeContext } from "../scope/ScopeContext.js";
+import { useToolsForScope } from "./NavigationRegistryContext.js";
+import { GUEST_BLOCKED_FEATURES, getGuestBlockedFeatures } from "@ydtb/tk-scope-extension/registry";
+import { useCurrentPermissions } from "../../lib/permissions-store.js";
+import { usePreference } from "../../hooks/usePreference.js";
+import { useQuery, useQueryClient } from "@ydtb/tk-scope-query-client";
+import { createDashboardClient } from "../../lib/tool-api-types.js";
+// Dashboard API client — typed with a lightweight interface to avoid coupling
+// to the dashboard tool package while still providing type safety.
+const dashboardApi = createDashboardClient();
+export const NavigationContext = createContext(null);
+const OLD_STORAGE_KEY = "icon-rail-preferences";
+const ID_MIGRATIONS = {
+    files: "media",
+    crm: "contacts",
+};
+function migrateIds(ids) {
+    return ids.map((id) => ID_MIGRATIONS[id] ?? id);
+}
+/**
+ * Determine whether a tool should be visible given the current permission state.
+ *
+ * Rules (evaluated in order):
+ *  1. Guest-tier users cannot see tools whose id is in the guest-blocked set
+ *     (dynamic via `getGuestBlockedFeatures()`, falls back to static `GUEST_BLOCKED_FEATURES`).
+ *  2. Otherwise the tool is visible only if `{toolId}.view` is in effectivePermissions.
+ *
+ * Owner role has all permissions granted (editable: false) in the resolution
+ * engine, so no special-case bypasses are needed here.
+ */
+function isToolPermitted(toolId, permissions, registrations) {
+    // 1. Guest blocked features (dynamic when registrations provided)
+    if (permissions.tier === "guest") {
+        const blocked = registrations ? getGuestBlockedFeatures(registrations) : GUEST_BLOCKED_FEATURES;
+        if (blocked.has(toolId)) {
+            return false;
+        }
+    }
+    // 2. Check for {toolId}.view permission
+    const viewPermission = `${toolId}.view`;
+    return permissions.effectivePermissions.includes(viewPermission);
+}
+/** Remove duplicate IDs, keeping the first occurrence. */
+function deduplicateIds(ids) {
+    const seen = new Set();
+    return ids.filter((id) => {
+        if (seen.has(id))
+            return false;
+        seen.add(id);
+        return true;
+    });
+}
+/** Merge static and dynamic tools, deduplicating by id (static wins). */
+function mergeTools(staticTools, dynamicTools) {
+    const staticIds = new Set(staticTools.map((t) => t.id));
+    const uniqueDynamic = dynamicTools.filter((t) => !staticIds.has(t.id));
+    return [...staticTools, ...uniqueDynamic];
+}
+function getDefaultPrefs(allTools) {
+    const topTools = allTools.filter((t) => t.position !== "bottom");
+    return {
+        order: topTools.map((t) => t.id),
+        hidden: topTools.filter((t) => t.defaultVisible === false).map((t) => t.id),
+    };
+}
+function resolveState(prefs, allTools) {
+    const topTools = allTools.filter((t) => t.position !== "bottom");
+    const validIds = new Set(topTools.map((t) => t.id));
+    const defaultOrder = topTools.map((t) => t.id);
+    const migratedOrder = migrateIds(prefs.order).filter((id) => validIds.has(id));
+    const migratedHidden = migrateIds(prefs.hidden).filter((id) => validIds.has(id));
+    const missingIds = defaultOrder.filter((id) => !migratedOrder.includes(id));
+    const finalOrder = deduplicateIds([...migratedOrder, ...missingIds]);
+    return {
+        order: finalOrder,
+        hidden: new Set(migratedHidden),
+    };
+}
+function sameNavigationState(a, b) {
+    if (a.order.length !== b.order.length)
+        return false;
+    for (let i = 0; i < a.order.length; i += 1) {
+        if (a.order[i] !== b.order[i])
+            return false;
+    }
+    if (a.hidden.size !== b.hidden.size)
+        return false;
+    for (const id of a.hidden) {
+        if (!b.hidden.has(id))
+            return false;
+    }
+    return true;
+}
+export function NavigationProvider({ children }) {
+    const queryClient = useQueryClient();
+    const { scopeType } = useScopeContext();
+    const safeEmptyValue = useMemo(() => ({
+        visibleTopTools: [],
+        hiddenTools: [],
+        bottomTools: [],
+        allTopTools: [],
+        isToolVisible: () => false,
+        toggleVisibility: () => { },
+        moveToolUp: () => { },
+        moveToolDown: () => { },
+        reorderTools: () => { },
+        getOrderedTools: () => [],
+        resetToDefaults: () => { },
+        refetchDynamicTools: () => { },
+    }), []);
+    const staticTools = useToolsForScope(scopeType);
+    const hasDashboardTool = staticTools.some((tool) => tool.id === "dashboard");
+    // Fetch rail-pinned dashboards for the icon rail (scope-aware via headers)
+    const { data: railDashboards } = useQuery({
+        ...dashboardApi.listRail.queryOptions({}),
+        enabled: !!scopeType && hasDashboardTool,
+    });
+    const dynamicTools = useMemo(() => {
+        if (!railDashboards)
+            return [];
+        return railDashboards.map((db) => ({
+            id: `dashboard-${db.id}`,
+            label: db.title,
+            icon: db.icon || "LayoutDashboard",
+            route: `/dashboard/${db.id}`,
+            source: "dynamic",
+            pinned: false,
+            defaultVisible: true,
+        }));
+    }, [railDashboards]);
+    const allTools = useMemo(() => mergeTools(staticTools, dynamicTools), [dynamicTools, staticTools]);
+    const defaultPrefs = useMemo(() => getDefaultPrefs(allTools), [allTools]);
+    const { value: prefs, setValue: setPrefs } = usePreference("nav.scope", defaultPrefs);
+    const [state, setState] = useState(() => resolveState(prefs, allTools));
+    const permissions = useCurrentPermissions();
+    // Re-resolve state when tools or prefs change, but avoid update loops when
+    // callers hand us new object identities with the same logical contents.
+    useEffect(() => {
+        setState((prev) => {
+            const next = resolveState(prefs, allTools);
+            return sameNavigationState(prev, next) ? prev : next;
+        });
+    }, [prefs, allTools]);
+    // One-time migration from old localStorage key
+    const migrated = useRef(false);
+    useEffect(() => {
+        if (migrated.current)
+            return;
+        try {
+            const raw = localStorage.getItem(OLD_STORAGE_KEY);
+            if (raw) {
+                const parsed = JSON.parse(raw);
+                setPrefs(parsed);
+                localStorage.removeItem(OLD_STORAGE_KEY);
+            }
+        }
+        catch {
+            // ignore parse errors
+        }
+        migrated.current = true;
+    }, [setPrefs]);
+    const getOrderedTopTools = useCallback(() => {
+        return state.order
+            .map((id) => allTools.find((t) => t.id === id))
+            .filter((t) => t != null && t.position !== "bottom");
+    }, [state.order, allTools]);
+    const toggleVisibility = useCallback((id) => {
+        const tool = allTools.find((t) => t.id === id);
+        if (tool?.pinned)
+            return;
+        setState((prev) => {
+            const next = new Set(prev.hidden);
+            if (next.has(id)) {
+                next.delete(id);
+            }
+            else {
+                next.add(id);
+            }
+            const newState = { ...prev, hidden: next };
+            setPrefs({
+                order: newState.order,
+                hidden: Array.from(newState.hidden),
+            });
+            return newState;
+        });
+    }, [setPrefs, allTools]);
+    const moveToolUp = useCallback((id) => {
+        setState((prev) => {
+            const idx = prev.order.indexOf(id);
+            if (idx <= 0)
+                return prev;
+            const next = [...prev.order];
+            const a = next[idx - 1];
+            const b = next[idx];
+            if (a === undefined || b === undefined)
+                return prev;
+            next[idx - 1] = b;
+            next[idx] = a;
+            const newState = { ...prev, order: next };
+            setPrefs({
+                order: newState.order,
+                hidden: Array.from(newState.hidden),
+            });
+            return newState;
+        });
+    }, [setPrefs]);
+    const moveToolDown = useCallback((id) => {
+        setState((prev) => {
+            const idx = prev.order.indexOf(id);
+            if (idx < 0 || idx >= prev.order.length - 1)
+                return prev;
+            const next = [...prev.order];
+            const a = next[idx];
+            const b = next[idx + 1];
+            if (a === undefined || b === undefined)
+                return prev;
+            next[idx] = b;
+            next[idx + 1] = a;
+            const newState = { ...prev, order: next };
+            setPrefs({
+                order: newState.order,
+                hidden: Array.from(newState.hidden),
+            });
+            return newState;
+        });
+    }, [setPrefs]);
+    const reorderTools = useCallback((fromIndex, toIndex) => {
+        setState((prev) => {
+            const next = [...prev.order];
+            const [moved] = next.splice(fromIndex, 1);
+            if (moved === undefined)
+                return prev;
+            next.splice(toIndex, 0, moved);
+            const newState = { ...prev, order: next };
+            setPrefs({
+                order: newState.order,
+                hidden: Array.from(newState.hidden),
+            });
+            return newState;
+        });
+    }, [setPrefs]);
+    const isToolVisible = useCallback((id) => {
+        return !state.hidden.has(id);
+    }, [state.hidden]);
+    const resetToDefaults = useCallback(() => {
+        const defaults = getDefaultPrefs(allTools);
+        setPrefs(defaults);
+        setState({
+            order: defaults.order,
+            hidden: new Set(defaults.hidden),
+        });
+    }, [setPrefs, allTools]);
+    const getOrderedTools = useCallback(() => {
+        return getOrderedTopTools();
+    }, [getOrderedTopTools]);
+    // When no scope type, provide empty navigation context
+    if (!scopeType) {
+        return (_jsx(NavigationContext.Provider, { value: safeEmptyValue, children: children }));
+    }
+    const orderedTopTools = getOrderedTopTools();
+    const permittedTopTools = permissions.loaded
+        ? orderedTopTools.filter((t) => isToolPermitted(t.id, permissions))
+        : orderedTopTools;
+    const visibleTopTools = permittedTopTools.filter((t) => !state.hidden.has(t.id));
+    const hiddenTools = permittedTopTools.filter((t) => state.hidden.has(t.id));
+    const bottomTools = allTools.filter((t) => t.position === "bottom");
+    return (_jsx(NavigationContext.Provider, { value: {
+            visibleTopTools,
+            hiddenTools,
+            bottomTools,
+            allTopTools: permittedTopTools,
+            isToolVisible,
+            toggleVisibility,
+            moveToolUp,
+            moveToolDown,
+            reorderTools,
+            getOrderedTools,
+            resetToDefaults,
+            refetchDynamicTools: () => {
+                queryClient.invalidateQueries({
+                    queryKey: dashboardApi.listRail.key(),
+                });
+            },
+        }, children: children }));
+}
+export function useNavigation() {
+    const ctx = useContext(NavigationContext);
+    if (!ctx)
+        throw new Error("useNavigation must be used within NavigationProvider");
+    return ctx;
+}
+//# sourceMappingURL=NavigationContext.js.map

package/dist/src/contexts/navigation/NavigationContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationContext.js","sourceRoot":"","sources":["../../../../src/contexts/navigation/NavigationContext.tsx"],"names":[],"mappings":"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"}

package/dist/src/contexts/navigation/NavigationRegistryContext.d.ts

@@ -0,0 +1,9 @@
+import { type ReactNode } from "react";
+import type { ScopeRouteGroup } from "@ydtb/tk-scope/client";
+import { type ToolItem } from "../../lib/navigation-tools.ts";
+export declare function NavigationRegistryProvider({ scopeRoutes, children, }: {
+    scopeRoutes?: ScopeRouteGroup;
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useToolsForScope(scope: string | null | undefined): ToolItem[];
+//# sourceMappingURL=NavigationRegistryContext.d.ts.map

package/dist/src/contexts/navigation/NavigationRegistryContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationRegistryContext.d.ts","sourceRoot":"","sources":["../../../../src/contexts/navigation/NavigationRegistryContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAGL,KAAK,QAAQ,EACd,MAAM,+BAA+B,CAAA;AAMtC,wBAAgB,0BAA0B,CAAC,EACzC,WAAW,EACX,QAAQ,GACT,EAAE;IACD,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,QAAQ,EAAE,SAAS,CAAA;CACpB,2CAWA;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,QAAQ,EAAE,CAM7E"}

package/dist/src/contexts/navigation/NavigationRegistryContext.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo } from "react";
+import { buildNavigationByScope, getToolsForScope, } from "../../lib/navigation-tools.js";
+const NavigationRegistryContext = createContext(new Map());
+export function NavigationRegistryProvider({ scopeRoutes, children, }) {
+    const navigationByScope = useMemo(() => (scopeRoutes ? buildNavigationByScope(scopeRoutes) : new Map()), [scopeRoutes]);
+    return (_jsx(NavigationRegistryContext.Provider, { value: navigationByScope, children: children }));
+}
+export function useToolsForScope(scope) {
+    const navigationByScope = useContext(NavigationRegistryContext);
+    return useMemo(() => {
+        if (!scope)
+            return [];
+        return getToolsForScope(navigationByScope, scope);
+    }, [navigationByScope, scope]);
+}
+//# sourceMappingURL=NavigationRegistryContext.js.map

package/dist/src/contexts/navigation/NavigationRegistryContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationRegistryContext.js","sourceRoot":"","sources":["../../../../src/contexts/navigation/NavigationRegistryContext.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAkB,MAAM,OAAO,CAAA;AAE1E,OAAO,EACL,sBAAsB,EACtB,gBAAgB,GAEjB,MAAM,+BAA+B,CAAA;AAItC,MAAM,yBAAyB,GAAG,aAAa,CAAoB,IAAI,GAAG,EAAE,CAAC,CAAA;AAE7E,MAAM,UAAU,0BAA0B,CAAC,EACzC,WAAW,EACX,QAAQ,GAIT;IACC,MAAM,iBAAiB,GAAG,OAAO,CAC/B,GAAG,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAsB,CAAC,EACzF,CAAC,WAAW,CAAC,CACd,CAAA;IAED,OAAO,CACL,KAAC,yBAAyB,CAAC,QAAQ,IAAC,KAAK,EAAE,iBAAiB,YACzD,QAAQ,GAC0B,CACtC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAgC;IAC/D,MAAM,iBAAiB,GAAG,UAAU,CAAC,yBAAyB,CAAC,CAAA;IAC/D,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAA;QACrB,OAAO,gBAAgB,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAA;IACnD,CAAC,EAAE,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC,CAAA;AAChC,CAAC"}

package/dist/src/contexts/scope/ScopeContext.d.ts

@@ -0,0 +1,40 @@
+import { type ReactNode } from "react";
+export interface ScopeEntity {
+    id: string;
+    name: string;
+    slug: string;
+    logo: string | null;
+    metadata: unknown;
+    scope: string;
+    parentScope: string | null;
+    parentScopeId: string | null;
+}
+interface ScopeContextValue {
+    scopeId: string | null;
+    scopeType: string | null;
+    entity: ScopeEntity | null;
+    isPending: boolean;
+    navigateToScope: (scopeId: string, scopeType?: string) => void;
+}
+/**
+ * Provides the current scope (id + type) derived from URL params.
+ *
+ * Also updates the module-level scope ref so the oRPC client
+ * can inject x-scope-id / x-scope-type headers on every request.
+ *
+ * When authenticated with a scopeId, fetches the scope entity data.
+ */
+export declare function ScopeProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Rich app-level scope context — entity, membership, navigation.
+ *
+ * App shell components use this. Tools use useScope() from @ydtb/core-client
+ * which provides only scopeId + scopeType.
+ */
+export declare function useScopeContext(): ScopeContextValue;
+/** Just the scope ID */
+export declare function useScopeId(): string | null;
+export {};
+//# sourceMappingURL=ScopeContext.d.ts.map

package/dist/src/contexts/scope/ScopeContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScopeContext.d.ts","sourceRoot":"","sources":["../../../../src/contexts/scope/ScopeContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAA;AAWd,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,QAAQ,EAAE,OAAO,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,UAAU,iBAAiB;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAA;IAC1B,SAAS,EAAE,OAAO,CAAA;IAClB,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/D;AAYD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,kDAoHlE;AAID;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CAEnD;AAED,wBAAwB;AACxB,wBAAgB,UAAU,IAAI,MAAM,GAAG,IAAI,CAE1C"}

package/dist/src/contexts/scope/ScopeContext.js

@@ -0,0 +1,141 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, } from "react";
+import { useParams, useNavigate, useLocation } from "@tanstack/react-router";
+import { useQuery, useQueryClient } from "@ydtb/tk-scope-query-client";
+import { scopeApi, platformApi } from "../../lib/platform-api.js";
+import { scopeHasUrlScopeId } from "@ydtb/tk-scope/client";
+import { detectScopeFromPath, scopeLink } from "@ydtb/tk-scope/client";
+import { setCurrentScope } from "./scopeRef.js";
+import { useAuth } from "../auth/AuthContext.js";
+const ScopeContext = createContext({
+    scopeId: null,
+    scopeType: null,
+    entity: null,
+    isPending: false,
+    navigateToScope: () => { },
+});
+// ─── Provider ────────────────────────────────────────────────────
+/**
+ * Provides the current scope (id + type) derived from URL params.
+ *
+ * Also updates the module-level scope ref so the oRPC client
+ * can inject x-scope-id / x-scope-type headers on every request.
+ *
+ * When authenticated with a scopeId, fetches the scope entity data.
+ */
+export function ScopeProvider({ children }) {
+    const params = useParams({ strict: false });
+    const navigate = useNavigate();
+    const { session } = useAuth();
+    const location = useLocation();
+    const rawScopeId = params.scopeId ?? null;
+    // Detect scope type from the router's reactive pathname (not window.location)
+    // This ensures scopeType stays in sync with React's render cycle.
+    const scopeType = useMemo(() => {
+        const detected = detectScopeFromPath(location.pathname);
+        return detected?.scope ?? null;
+    }, [location.pathname]);
+    // For singleton scopes without a URL scopeId, fetch the real
+    // root-scope entity ID from the platform setup status endpoint.
+    const needsRootScopeId = !!scopeType && !rawScopeId && !scopeHasUrlScopeId(scopeType);
+    const { data: setupData } = useQuery({
+        ...platformApi.setupStatus.queryOptions({}),
+        enabled: needsRootScopeId,
+        staleTime: Infinity, // Root singleton scope ID never changes
+    });
+    const scopeId = useMemo(() => {
+        if (!scopeType)
+            return rawScopeId;
+        if (rawScopeId)
+            return rawScopeId;
+        if (!scopeHasUrlScopeId(scopeType)) {
+            return setupData?.scopeId ?? null;
+        }
+        return null;
+    }, [setupData?.scopeId, rawScopeId, scopeType]);
+    // Fetch scope entity — only when authenticated AND scopeId present
+    const { data: scopeData, isPending } = useQuery({
+        ...scopeApi.get.queryOptions({ input: { scopeId: scopeId } }),
+        enabled: !!scopeId && !!session,
+    });
+    const entity = scopeData?.scope ?? null;
+    // Keep the module-level ref in sync for oRPC headers.
+    // Set synchronously during render so queries fired by child components
+    // (e.g., useScopePermissions in UnifiedGuard) have scope headers immediately.
+    // The useEffect cleanup handles resetting on unmount.
+    setCurrentScope(scopeId, scopeType);
+    useEffect(() => {
+        return () => setCurrentScope(null, null);
+    }, [scopeId, scopeType]);
+    // Tool-client query keys (built by `createToolClient` in @ydtb/api-client)
+    // do NOT include the active scope — only `[toolId, methodName, input]`.
+    // Without explicit cache invalidation, switching scopes serves stale data
+    // from the previous scope until each query's refetch lands. Tracked at
+    // tk-scope#25; the architecturally clean fix is to bake scope into the
+    // path. Until then, reset the cache on every fully-resolved scope change
+    // so tools re-fetch from the new scope cleanly.
+    //
+    // `resetQueries` (NOT `removeQueries`) is required for SPA-style scope
+    // switches: `removeQueries` cancels in-flight requests and removes the
+    // cache entry, but does not auto-refetch active observers — they're left
+    // with no data and no pending request, stuck on a loading spinner until
+    // a manual refresh re-mounts them. `resetQueries` clears data + triggers
+    // a fresh fetch on every observer.
+    //
+    // Only act when BOTH prev and current are fully resolved (id + type
+    // non-null). During initial mount the URL param + path-detected type can
+    // resolve in different render passes, briefly leaving one null. Treating
+    // those as "scope changed" would reset queries mid-mount before the new
+    // observers had a chance to register, racing the page into a stuck state.
+    const queryClient = useQueryClient();
+    const prevScopeRef = useRef({
+        id: null,
+        type: null,
+    });
+    useEffect(() => {
+        const prev = prevScopeRef.current;
+        const isResolved = scopeId !== null && scopeType !== null;
+        const wasResolved = prev.id !== null && prev.type !== null;
+        if (!isResolved)
+            return;
+        const changed = prev.id !== scopeId || prev.type !== scopeType;
+        prevScopeRef.current = { id: scopeId, type: scopeType };
+        if (wasResolved && changed) {
+            void queryClient.resetQueries();
+        }
+    }, [scopeId, scopeType, queryClient]);
+    const navigateToScope = useCallback((targetScopeId, targetScopeType) => {
+        // ScopeContext renders inside scoped shells which always provide scopeType
+        const scope = targetScopeType ?? scopeType;
+        if (!scope) {
+            throw new Error("navigateToScope requires a scope type");
+        }
+        navigate({
+            to: scopeLink("/dashboard", { scope, scopeId: targetScopeId }),
+        });
+    }, [navigate, scopeType]);
+    const value = useMemo(() => ({ scopeId, scopeType, entity, isPending: !!scopeId && isPending, navigateToScope }), [scopeId, scopeType, entity, isPending, navigateToScope]);
+    // Block rendering until scopeId is resolved — prevents tool queries from
+    // firing with null scope headers (which returns empty results or 403).
+    // This only matters for singleton scopes without a URL scopeId
+    // where the ID is fetched async from setupStatus.
+    if (needsRootScopeId && !scopeId) {
+        return null;
+    }
+    return _jsx(ScopeContext.Provider, { value: value, children: children });
+}
+// ─── Hooks ───────────────────────────────────────────────────────
+/**
+ * Rich app-level scope context — entity, membership, navigation.
+ *
+ * App shell components use this. Tools use useScope() from @ydtb/core-client
+ * which provides only scopeId + scopeType.
+ */
+export function useScopeContext() {
+    return useContext(ScopeContext);
+}
+/** Just the scope ID */
+export function useScopeId() {
+    return useContext(ScopeContext).scopeId;
+}
+//# sourceMappingURL=ScopeContext.js.map

package/dist/src/contexts/scope/ScopeContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScopeContext.js","sourceRoot":"","sources":["../../../../src/contexts/scope/ScopeContext.tsx"],"names":[],"mappings":"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"}

package/dist/src/contexts/scope/index.d.ts

@@ -0,0 +1,3 @@
+export { ScopeProvider, useScopeContext, useScopeId, type ScopeEntity } from "./ScopeContext.tsx";
+export { getCurrentScope, setCurrentScope } from "./scopeRef.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/contexts/scope/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/contexts/scope/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACjG,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA"}

package/dist/src/contexts/scope/index.js

@@ -0,0 +1,3 @@
+export { ScopeProvider, useScopeContext, useScopeId } from "./ScopeContext.js";
+export { getCurrentScope, setCurrentScope } from "./scopeRef.js";
+//# sourceMappingURL=index.js.map

package/dist/src/contexts/scope/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/contexts/scope/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAoB,MAAM,mBAAoB,CAAA;AACjG,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA"}

package/dist/src/contexts/scope/scopeRef.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Module-level scope ref — re-exported from @ydtb/api-client.
+ *
+ * Both ScopeProvider (scoped routes) and tool portal layouts
+ * import from @ydtb/api-client to share the same module instance.
+ * This file re-exports for backward compatibility with existing
+ * app-level imports.
+ */
+export { setCurrentScope, getCurrentScope } from "@ydtb/tk-scope-api-client";
+//# sourceMappingURL=scopeRef.d.ts.map

package/dist/src/contexts/scope/scopeRef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopeRef.d.ts","sourceRoot":"","sources":["../../../../src/contexts/scope/scopeRef.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/src/contexts/scope/scopeRef.js

@@ -0,0 +1,10 @@
+/**
+ * Module-level scope ref — re-exported from @ydtb/api-client.
+ *
+ * Both ScopeProvider (scoped routes) and tool portal layouts
+ * import from @ydtb/api-client to share the same module instance.
+ * This file re-exports for backward compatibility with existing
+ * app-level imports.
+ */
+export { setCurrentScope, getCurrentScope } from "@ydtb/tk-scope-api-client";
+//# sourceMappingURL=scopeRef.js.map

package/dist/src/contexts/scope/scopeRef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopeRef.js","sourceRoot":"","sources":["../../../../src/contexts/scope/scopeRef.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/src/contexts/sidebar/use-sidebar.d.ts

@@ -0,0 +1,2 @@
+export { SidebarProvider, useSidebar } from "@ydtb/tk-scope-shell";
+//# sourceMappingURL=use-sidebar.d.ts.map

package/dist/src/contexts/sidebar/use-sidebar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sidebar.d.ts","sourceRoot":"","sources":["../../../../src/contexts/sidebar/use-sidebar.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/src/contexts/sidebar/use-sidebar.js

@@ -0,0 +1,2 @@
+export { SidebarProvider, useSidebar } from "@ydtb/tk-scope-shell";
+//# sourceMappingURL=use-sidebar.js.map

package/dist/src/contexts/sidebar/use-sidebar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sidebar.js","sourceRoot":"","sources":["../../../../src/contexts/sidebar/use-sidebar.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/src/contexts/theme/ThemeContext.d.ts

@@ -0,0 +1,21 @@
+import { type ReactNode } from "react";
+export type Appearance = "light" | "dark" | "auto";
+export type AccentColor = "zinc" | "slate" | "stone" | "gray" | "neutral" | "red" | "rose" | "orange" | "green" | "blue" | "yellow" | "violet";
+export type BackgroundPattern = "none" | "dots" | "grid" | "graph";
+interface ThemeSettings {
+    appearance: Appearance;
+    accent: AccentColor;
+    pattern: BackgroundPattern;
+}
+interface ThemeContextValue extends ThemeSettings {
+    resolvedMode: "light" | "dark";
+    setAppearance: (appearance: Appearance) => void;
+    setAccent: (accent: AccentColor) => void;
+    setPattern: (pattern: BackgroundPattern) => void;
+}
+export declare function ThemeProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useTheme(): ThemeContextValue;
+export {};
+//# sourceMappingURL=ThemeContext.d.ts.map

package/dist/src/contexts/theme/ThemeContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeContext.d.ts","sourceRoot":"","sources":["../../../../src/contexts/theme/ThemeContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAA;AAGd,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;AAClD,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,OAAO,GACP,OAAO,GACP,MAAM,GACN,SAAS,GACT,KAAK,GACL,MAAM,GACN,QAAQ,GACR,OAAO,GACP,MAAM,GACN,QAAQ,GACR,QAAQ,CAAA;AACZ,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAElE,UAAU,aAAa;IACrB,UAAU,EAAE,UAAU,CAAA;IACtB,MAAM,EAAE,WAAW,CAAA;IACnB,OAAO,EAAE,iBAAiB,CAAA;CAC3B;AAED,UAAU,iBAAkB,SAAQ,aAAa;IAC/C,YAAY,EAAE,OAAO,GAAG,MAAM,CAAA;IAC9B,aAAa,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAA;IAC/C,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;IACxC,UAAU,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAA;CACjD;AAmBD,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CAiFlE;AAED,wBAAgB,QAAQ,sBAIvB"}