@wildo-ai/saas-frontend-lib 1.1.4 → 1.1.6

package/dist/esm/core/mode/AppModeContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppModeContext.js","sourceRoot":"","sources":["../../../../src/core/mode/AppModeContext.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * AppModeContext — manages the active application mode.\n *\n * Modes represent UI activities (explorer, search, admin, etc.) that control\n * which sidebar sections are visible. The `ACTIVITY_BAR` component renders\n * available modes; this context manages the selection state.\n *\n * Mode resolution cascade on mount:\n *   1. localStorage (persisted from last session)\n *   2. validate persisted mode is still available\n *   3. `isDefault` mode\n *   4. first available mode\n *   5. null (no modes configured)\n *\n * Auto-persists `activeMode` in localStorage keyed by `appName`.\n *\n * @see component-taxonomy-deep-review.md §7.3, §7.5\n * @see app-shell-implementation-plan.md Step 6\n */\n\nimport React, { createContext, useContext, useMemo, useState, useCallback, useEffect } from 'react';\nimport type { ReactNode } from 'react';\nimport type { AppModeDefinition } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { useResolvedAuthConfig } from '~wildo-frontend-lib/core/security/useResolvedAuthConfig';\n\n// ════════════════════════════════════════════════════════════════\n// Context Value\n// ════════════════════════════════════════════════════════════════\n\nexport interface AppModeContextValue {\n  /** All declared app modes (before user type filtering). */\n  allModes: AppModeDefinition[];\n  /** Modes available to the current user (after `visibleToUserTypes` filtering). */\n  availableModes: AppModeDefinition[];\n  /** Currently active mode ref, or `null` if no mode system. */\n  activeMode: string | null;\n  /** Switch to a different mode. No-op if ref is not in `availableModes`. */\n  setActiveMode: (modeRef: string) => void;\n  /** Whether the app has any available modes at all. */\n  hasModes: boolean;\n}\n\nconst AppModeContext = createContext<AppModeContextValue | undefined>(undefined);\n\n// ════════════════════════════════════════════════════════════════\n// localStorage Persistence\n// ════════════════════════════════════════════════════════════════\n\nconst STORAGE_KEY_PREFIX = 'wildo:appMode:';\n\nfunction buildStorageKey(appName: string | undefined, userId: string | undefined): string {\n  return `${STORAGE_KEY_PREFIX}${appName ?? 'default'}:${userId ?? 'anon'}`;\n}\n\nfunction readPersistedMode(storageKey: string): string | null {\n  try {\n    return localStorage.getItem(storageKey);\n  } catch {\n    return null;\n  }\n}\n\nfunction persistMode(storageKey: string, modeRef: string): void {\n  try {\n    localStorage.setItem(storageKey, modeRef);\n  } catch {\n    // localStorage may be unavailable (SSR, incognito quota)\n  }\n}\n\n// ════════════════════════════════════════════════════════════════\n// Mode Resolution\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Resolve the initial active mode using the cascade:\n * localStorage → validate → isDefault → first → null\n */\nfunction resolveInitialMode(\n  availableModes: AppModeDefinition[],\n  storageKey: string,\n): string | null {\n  if (availableModes.length === 0) return null;\n\n  const availableRefs = new Set(availableModes.map(m => m.ref));\n\n  // 1. Try persisted mode\n  const persisted = readPersistedMode(storageKey);\n  if (persisted && availableRefs.has(persisted)) {\n    return persisted;\n  }\n\n  // 2. Try isDefault mode\n  const defaultMode = availableModes.find(m => m.isDefault);\n  if (defaultMode) {\n    return defaultMode.ref;\n  }\n\n  // 3. First available\n  return availableModes[0].ref;\n}\n\n// ════════════════════════════════════════════════════════════════\n// Provider\n// ════════════════════════════════════════════════════════════════\n\ninterface AppModeProviderProps {\n  children: ReactNode;\n}\n\nexport const AppModeProvider: React.FC<AppModeProviderProps> = ({ children }) => {\n  const { frontendConfiguration, appConfig } = useApplication();\n  const { resolvedUserType } = useResolvedAuthConfig();\n\n  const allModes: AppModeDefinition[] = useMemo(\n    () => frontendConfiguration?.appModes ?? [],\n    [frontendConfiguration?.appModes],\n  );\n\n  const availableModes: AppModeDefinition[] = useMemo(() => {\n    if (!resolvedUserType) return allModes;\n    return allModes.filter(mode => {\n      if (!mode.visibleToUserTypes || mode.visibleToUserTypes.length === 0) return true;\n      return mode.visibleToUserTypes.includes(resolvedUserType);\n    });\n  }, [allModes, resolvedUserType]);\n\n  const storageKey = useMemo(\n    () => buildStorageKey(\n      appConfig?.appIdentity?.appName,\n      undefined, // userId is not available at this provider level; keyed by appName only\n    ),\n    [appConfig?.appIdentity?.appName],\n  );\n\n  const [activeMode, setActiveModeInternal] = useState<string | null>(() =>\n    resolveInitialMode(availableModes, storageKey),\n  );\n\n  // Re-resolve when available modes change (e.g., user type resolved after async auth)\n  useEffect(() => {\n    if (availableModes.length === 0) {\n      setActiveModeInternal(null);\n      return;\n    }\n    const availableRefs = new Set(availableModes.map(m => m.ref));\n    if (activeMode && availableRefs.has(activeMode)) return;\n    const resolved = resolveInitialMode(availableModes, storageKey);\n    setActiveModeInternal(resolved);\n  }, [availableModes, storageKey]); // eslint-disable-line react-hooks/exhaustive-deps\n\n  const setActiveMode = useCallback((modeRef: string) => {\n    const isValid = availableModes.some(m => m.ref === modeRef);\n    if (!isValid) return;\n    setActiveModeInternal(modeRef);\n    persistMode(storageKey, modeRef);\n  }, [availableModes, storageKey]);\n\n  const contextValue: AppModeContextValue = useMemo(() => ({\n    allModes,\n    availableModes,\n    activeMode,\n    setActiveMode,\n    hasModes: availableModes.length > 0,\n  }), [allModes, availableModes, activeMode, setActiveMode]);\n\n  return (\n    <AppModeContext.Provider value={contextValue}>\n      {children}\n    </AppModeContext.Provider>\n  );\n};\n\n// ════════════════════════════════════════════════════════════════\n// Hooks\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Access the app mode context. Throws if used outside `AppModeProvider`.\n */\nexport function useAppMode(): AppModeContextValue {\n  const ctx = useContext(AppModeContext);\n  if (!ctx) {\n    throw new Error('useAppMode must be used within an AppModeProvider');\n  }\n  return ctx;\n}\n\n/**\n * Access the app mode context without throwing if the provider is missing.\n * Returns `null` when used outside `AppModeProvider`.\n */\nexport function useAppModeSafe(): AppModeContextValue | null {\n  return useContext(AppModeContext) ?? null;\n}\n"]}
+{"version":3,"file":"AppModeContext.js","sourceRoot":"","sources":["../../../../../src/core/mode/AppModeContext.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * AppModeContext — manages the active application mode.\n *\n * Modes represent UI activities (explorer, search, admin, etc.) that control\n * which sidebar sections are visible. The `ACTIVITY_BAR` component renders\n * available modes; this context manages the selection state.\n *\n * Mode resolution cascade on mount:\n *   1. localStorage (persisted from last session)\n *   2. validate persisted mode is still available\n *   3. `isDefault` mode\n *   4. first available mode\n *   5. null (no modes configured)\n *\n * Auto-persists `activeMode` in localStorage keyed by `appName`.\n *\n * @see component-taxonomy-deep-review.md §7.3, §7.5\n * @see app-shell-implementation-plan.md Step 6\n */\n\nimport React, { createContext, useContext, useMemo, useState, useCallback, useEffect } from 'react';\nimport type { ReactNode } from 'react';\nimport type { AppModeDefinition } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { useResolvedAuthConfig } from '~wildo-frontend-lib/core/security/useResolvedAuthConfig';\n\n// ════════════════════════════════════════════════════════════════\n// Context Value\n// ════════════════════════════════════════════════════════════════\n\nexport interface AppModeContextValue {\n  /** All declared app modes (before user type filtering). */\n  allModes: AppModeDefinition[];\n  /** Modes available to the current user (after `visibleToUserTypes` filtering). */\n  availableModes: AppModeDefinition[];\n  /** Currently active mode ref, or `null` if no mode system. */\n  activeMode: string | null;\n  /** Switch to a different mode. No-op if ref is not in `availableModes`. */\n  setActiveMode: (modeRef: string) => void;\n  /** Whether the app has any available modes at all. */\n  hasModes: boolean;\n}\n\nconst AppModeContext = createContext<AppModeContextValue | undefined>(undefined);\n\n// ════════════════════════════════════════════════════════════════\n// localStorage Persistence\n// ════════════════════════════════════════════════════════════════\n\nconst STORAGE_KEY_PREFIX = 'wildo:appMode:';\n\nfunction buildStorageKey(appName: string | undefined, userId: string | undefined): string {\n  return `${STORAGE_KEY_PREFIX}${appName ?? 'default'}:${userId ?? 'anon'}`;\n}\n\nfunction readPersistedMode(storageKey: string): string | null {\n  try {\n    return localStorage.getItem(storageKey);\n  } catch {\n    return null;\n  }\n}\n\nfunction persistMode(storageKey: string, modeRef: string): void {\n  try {\n    localStorage.setItem(storageKey, modeRef);\n  } catch {\n    // localStorage may be unavailable (SSR, incognito quota)\n  }\n}\n\n// ════════════════════════════════════════════════════════════════\n// Mode Resolution\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Resolve the initial active mode using the cascade:\n * localStorage → validate → isDefault → first → null\n */\nfunction resolveInitialMode(\n  availableModes: AppModeDefinition[],\n  storageKey: string,\n): string | null {\n  if (availableModes.length === 0) return null;\n\n  const availableRefs = new Set(availableModes.map(m => m.ref));\n\n  // 1. Try persisted mode\n  const persisted = readPersistedMode(storageKey);\n  if (persisted && availableRefs.has(persisted)) {\n    return persisted;\n  }\n\n  // 2. Try isDefault mode\n  const defaultMode = availableModes.find(m => m.isDefault);\n  if (defaultMode) {\n    return defaultMode.ref;\n  }\n\n  // 3. First available\n  return availableModes[0].ref;\n}\n\n// ════════════════════════════════════════════════════════════════\n// Provider\n// ════════════════════════════════════════════════════════════════\n\ninterface AppModeProviderProps {\n  children: ReactNode;\n}\n\nexport const AppModeProvider: React.FC<AppModeProviderProps> = ({ children }) => {\n  const { frontendConfiguration, appConfig } = useApplication();\n  const { resolvedUserType } = useResolvedAuthConfig();\n\n  const allModes: AppModeDefinition[] = useMemo(\n    () => frontendConfiguration?.appModes ?? [],\n    [frontendConfiguration?.appModes],\n  );\n\n  const availableModes: AppModeDefinition[] = useMemo(() => {\n    if (!resolvedUserType) return allModes;\n    return allModes.filter(mode => {\n      if (!mode.visibleToUserTypes || mode.visibleToUserTypes.length === 0) return true;\n      return mode.visibleToUserTypes.includes(resolvedUserType);\n    });\n  }, [allModes, resolvedUserType]);\n\n  const storageKey = useMemo(\n    () => buildStorageKey(\n      appConfig?.appIdentity?.appName,\n      undefined, // userId is not available at this provider level; keyed by appName only\n    ),\n    [appConfig?.appIdentity?.appName],\n  );\n\n  const [activeMode, setActiveModeInternal] = useState<string | null>(() =>\n    resolveInitialMode(availableModes, storageKey),\n  );\n\n  // Re-resolve when available modes change (e.g., user type resolved after async auth)\n  useEffect(() => {\n    if (availableModes.length === 0) {\n      setActiveModeInternal(null);\n      return;\n    }\n    const availableRefs = new Set(availableModes.map(m => m.ref));\n    if (activeMode && availableRefs.has(activeMode)) return;\n    const resolved = resolveInitialMode(availableModes, storageKey);\n    setActiveModeInternal(resolved);\n  }, [availableModes, storageKey]); // eslint-disable-line react-hooks/exhaustive-deps\n\n  const setActiveMode = useCallback((modeRef: string) => {\n    const isValid = availableModes.some(m => m.ref === modeRef);\n    if (!isValid) return;\n    setActiveModeInternal(modeRef);\n    persistMode(storageKey, modeRef);\n  }, [availableModes, storageKey]);\n\n  const contextValue: AppModeContextValue = useMemo(() => ({\n    allModes,\n    availableModes,\n    activeMode,\n    setActiveMode,\n    hasModes: availableModes.length > 0,\n  }), [allModes, availableModes, activeMode, setActiveMode]);\n\n  return (\n    <AppModeContext.Provider value={contextValue}>\n      {children}\n    </AppModeContext.Provider>\n  );\n};\n\n// ════════════════════════════════════════════════════════════════\n// Hooks\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Access the app mode context. Throws if used outside `AppModeProvider`.\n */\nexport function useAppMode(): AppModeContextValue {\n  const ctx = useContext(AppModeContext);\n  if (!ctx) {\n    throw new Error('useAppMode must be used within an AppModeProvider');\n  }\n  return ctx;\n}\n\n/**\n * Access the app mode context without throwing if the provider is missing.\n * Returns `null` when used outside `AppModeProvider`.\n */\nexport function useAppModeSafe(): AppModeContextValue | null {\n  return useContext(AppModeContext) ?? null;\n}\n"]}

package/dist/esm/core/mode/section-visibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"section-visibility.d.ts","sourceRoot":"","sources":["../../../../src/core/mode/section-visibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,iEAAiE,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uDAAuD,CAAC;AAO3F;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,oBAAoB,EAAE,oBAAoB,GACzC,OAAO,CAmBT;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,cAAc,EAAE,EAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,oBAAoB,EAAE,oBAAoB,EAC1C,aAAa,GAAE,OAAe,GAC7B,cAAc,EAAE,CAwBlB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAC7C,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,cAAc,EAAE,iBAAiB,EAAE,GAClC,oBAAoB,CAMtB;AAgBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,EAAE,EAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,oBAAoB,EAAE,oBAAoB,GACzC,IAAI,CAwCN"}
+{"version":3,"file":"section-visibility.d.ts","sourceRoot":"","sources":["../../../../../src/core/mode/section-visibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,iEAAiE,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uDAAuD,CAAC;AAO3F;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,oBAAoB,EAAE,oBAAoB,GACzC,OAAO,CAmBT;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,cAAc,EAAE,EAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,oBAAoB,EAAE,oBAAoB,EAC1C,aAAa,GAAE,OAAe,GAC7B,cAAc,EAAE,CAwBlB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAC7C,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,cAAc,EAAE,iBAAiB,EAAE,GAClC,oBAAoB,CAMtB;AAgBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,EAAE,EAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,oBAAoB,EAAE,oBAAoB,GACzC,IAAI,CAwCN"}

package/dist/esm/core/mode/section-visibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"section-visibility.js","sourceRoot":"","sources":["../../../../src/core/mode/section-visibility.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Section Visibility Logic\n *\n * Pure functions for evaluating whether a sidebar section should be visible\n * based on the current mode and scope state. Also provides a DEV-mode\n * visibility debugger that logs a console table showing each section's\n * filter results.\n *\n * @see component-taxonomy-deep-review.md §7.6\n * @see app-shell-implementation-plan.md Steps 6, 8\n */\n\nimport type {\n  SidebarSection,\n  ScopeConditionParams,\n  AppModeDefinition,\n} from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport type { AppScopeValue } from '~wildo-frontend-lib/core/scope/scope.frontend.schemas';\nimport { SidebarSectionContentKind } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\n\n// ════════════════════════════════════════════════════════════════\n// Section Visibility Evaluation\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Determines whether a sidebar section should be visible given the\n * current mode and scope state.\n *\n * Evaluation order:\n *   1. `visibleInModes` — if set, section is only visible when\n *      `activeMode` is in the list. If the list is empty or absent,\n *      the section is visible in all modes.\n *   2. `scopeCondition` — if set, the predicate is called with\n *      the current scope parameters. Must return `true` for the\n *      section to be visible.\n *   3. Both must pass for the section to be visible.\n */\nexport function isSectionVisible(\n  section: SidebarSection,\n  activeMode: string | null,\n  scopeConditionParams: ScopeConditionParams,\n): boolean {\n  // Mode filter\n  if (section.visibleInModes && section.visibleInModes.length > 0) {\n    if (!activeMode || !section.visibleInModes.includes(activeMode)) {\n      return false;\n    }\n  }\n\n  // Scope condition\n  if (section.scopeCondition) {\n    try {\n      return section.scopeCondition(scopeConditionParams);\n    } catch {\n      // Defensive: malformed scopeCondition should not crash the sidebar\n      return false;\n    }\n  }\n\n  return true;\n}\n\n/**\n * Filters a list of sidebar sections to only those visible in the\n * current mode and scope state.\n *\n * Also includes a DEV-mode warning if all sections are hidden and\n * no `GUIDANCE_WIDGET` covers the empty state.\n */\nexport function filterVisibleSections(\n  sections: SidebarSection[],\n  activeMode: string | null,\n  scopeConditionParams: ScopeConditionParams,\n  isDevelopment: boolean = false,\n): SidebarSection[] {\n  const visible = sections.filter(s =>\n    isSectionVisible(s, activeMode, scopeConditionParams),\n  );\n\n  if (isDevelopment && visible.length === 0 && sections.length > 0) {\n    // Only suppress the warning if a GUIDANCE_WIDGET exists that could actually\n    // render — i.e., one without mode restrictions (always visible regardless of\n    // which mode hides the other sections).\n    const hasUnconditionalGuidance = sections.some(\n      s => s.contentKind === SidebarSectionContentKind.GUIDANCE_WIDGET &&\n           (!s.visibleInModes || s.visibleInModes.length === 0),\n    );\n    if (!hasUnconditionalGuidance) {\n      console.warn(\n        '[AppMode] All sidebar sections are hidden and no unconditionally-visible ' +\n        'GUIDANCE_WIDGET section covers the empty state. Consider adding a ' +\n        'GUIDANCE_WIDGET section without visibleInModes restrictions and a ' +\n        'scopeCondition that activates when other sections are hidden.',\n      );\n    }\n  }\n\n  return visible;\n}\n\n/**\n * Builds `ScopeConditionParams` from the current app state.\n * Used by `useSidebarBehavior` to construct the params for `isSectionVisible`.\n */\nexport function buildScopeConditionParams(\n  appScopeValues: Record<string, AppScopeValue>,\n  activeMode: string | null,\n  availableModes: AppModeDefinition[],\n): ScopeConditionParams {\n  return {\n    appScopeValues,\n    activeMode,\n    availableModes,\n  };\n}\n\n// ════════════════════════════════════════════════════════════════\n// DEV Visibility Debugger\n// ════════════════════════════════════════════════════════════════\n\ninterface SectionVisibilityDebugRow {\n  ref: string;\n  contentKind: string;\n  modeFilter: string;\n  modeMatch: boolean | 'N/A';\n  hasScopeCondition: boolean;\n  scopeMatch: boolean | 'N/A';\n  visible: boolean;\n}\n\n/**\n * Logs a console table showing each sidebar section's visibility state.\n * Useful for diagnosing why sections are hidden/shown.\n *\n * Call from browser DevTools or wire into a debug flag:\n * ```typescript\n * if (window.__WILDO_DEBUG_SIDEBAR__) {\n *   debugSectionVisibility(sections, activeMode, scopeParams);\n * }\n * ```\n *\n * @see app-shell-implementation-plan.md Step 8.3\n */\nexport function debugSectionVisibility(\n  sections: SidebarSection[],\n  activeMode: string | null,\n  scopeConditionParams: ScopeConditionParams,\n): void {\n  const rows: SectionVisibilityDebugRow[] = sections.map(section => {\n    const hasModeFilter = !!(section.visibleInModes && section.visibleInModes.length > 0);\n    let modeMatch: boolean | 'N/A' = 'N/A';\n\n    if (hasModeFilter) {\n      modeMatch = !!activeMode && section.visibleInModes!.includes(activeMode);\n    }\n\n    const hasScopeCondition = !!section.scopeCondition;\n    let scopeMatch: boolean | 'N/A' = 'N/A';\n\n    if (hasScopeCondition) {\n      try {\n        scopeMatch = section.scopeCondition!(scopeConditionParams);\n      } catch {\n        scopeMatch = false;\n      }\n    }\n\n    const visible = isSectionVisible(section, activeMode, scopeConditionParams);\n\n    return {\n      ref: section.ref,\n      contentKind: section.contentKind,\n      modeFilter: hasModeFilter ? section.visibleInModes!.join(', ') : '(all)',\n      modeMatch,\n      hasScopeCondition,\n      scopeMatch,\n      visible,\n    };\n  });\n\n  console.group(\n    `[SidebarVisibility] activeMode=\"${activeMode ?? 'none'}\" | ` +\n    `${rows.filter(r => r.visible).length}/${rows.length} sections visible`,\n  );\n  console.table(rows);\n  console.log('Scope params:', scopeConditionParams);\n  console.groupEnd();\n}\n"]}
+{"version":3,"file":"section-visibility.js","sourceRoot":"","sources":["../../../../../src/core/mode/section-visibility.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Section Visibility Logic\n *\n * Pure functions for evaluating whether a sidebar section should be visible\n * based on the current mode and scope state. Also provides a DEV-mode\n * visibility debugger that logs a console table showing each section's\n * filter results.\n *\n * @see component-taxonomy-deep-review.md §7.6\n * @see app-shell-implementation-plan.md Steps 6, 8\n */\n\nimport type {\n  SidebarSection,\n  ScopeConditionParams,\n  AppModeDefinition,\n} from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport type { AppScopeValue } from '~wildo-frontend-lib/core/scope/scope.frontend.schemas';\nimport { SidebarSectionContentKind } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\n\n// ════════════════════════════════════════════════════════════════\n// Section Visibility Evaluation\n// ════════════════════════════════════════════════════════════════\n\n/**\n * Determines whether a sidebar section should be visible given the\n * current mode and scope state.\n *\n * Evaluation order:\n *   1. `visibleInModes` — if set, section is only visible when\n *      `activeMode` is in the list. If the list is empty or absent,\n *      the section is visible in all modes.\n *   2. `scopeCondition` — if set, the predicate is called with\n *      the current scope parameters. Must return `true` for the\n *      section to be visible.\n *   3. Both must pass for the section to be visible.\n */\nexport function isSectionVisible(\n  section: SidebarSection,\n  activeMode: string | null,\n  scopeConditionParams: ScopeConditionParams,\n): boolean {\n  // Mode filter\n  if (section.visibleInModes && section.visibleInModes.length > 0) {\n    if (!activeMode || !section.visibleInModes.includes(activeMode)) {\n      return false;\n    }\n  }\n\n  // Scope condition\n  if (section.scopeCondition) {\n    try {\n      return section.scopeCondition(scopeConditionParams);\n    } catch {\n      // Defensive: malformed scopeCondition should not crash the sidebar\n      return false;\n    }\n  }\n\n  return true;\n}\n\n/**\n * Filters a list of sidebar sections to only those visible in the\n * current mode and scope state.\n *\n * Also includes a DEV-mode warning if all sections are hidden and\n * no `GUIDANCE_WIDGET` covers the empty state.\n */\nexport function filterVisibleSections(\n  sections: SidebarSection[],\n  activeMode: string | null,\n  scopeConditionParams: ScopeConditionParams,\n  isDevelopment: boolean = false,\n): SidebarSection[] {\n  const visible = sections.filter(s =>\n    isSectionVisible(s, activeMode, scopeConditionParams),\n  );\n\n  if (isDevelopment && visible.length === 0 && sections.length > 0) {\n    // Only suppress the warning if a GUIDANCE_WIDGET exists that could actually\n    // render — i.e., one without mode restrictions (always visible regardless of\n    // which mode hides the other sections).\n    const hasUnconditionalGuidance = sections.some(\n      s => s.contentKind === SidebarSectionContentKind.GUIDANCE_WIDGET &&\n           (!s.visibleInModes || s.visibleInModes.length === 0),\n    );\n    if (!hasUnconditionalGuidance) {\n      console.warn(\n        '[AppMode] All sidebar sections are hidden and no unconditionally-visible ' +\n        'GUIDANCE_WIDGET section covers the empty state. Consider adding a ' +\n        'GUIDANCE_WIDGET section without visibleInModes restrictions and a ' +\n        'scopeCondition that activates when other sections are hidden.',\n      );\n    }\n  }\n\n  return visible;\n}\n\n/**\n * Builds `ScopeConditionParams` from the current app state.\n * Used by `useSidebarBehavior` to construct the params for `isSectionVisible`.\n */\nexport function buildScopeConditionParams(\n  appScopeValues: Record<string, AppScopeValue>,\n  activeMode: string | null,\n  availableModes: AppModeDefinition[],\n): ScopeConditionParams {\n  return {\n    appScopeValues,\n    activeMode,\n    availableModes,\n  };\n}\n\n// ════════════════════════════════════════════════════════════════\n// DEV Visibility Debugger\n// ════════════════════════════════════════════════════════════════\n\ninterface SectionVisibilityDebugRow {\n  ref: string;\n  contentKind: string;\n  modeFilter: string;\n  modeMatch: boolean | 'N/A';\n  hasScopeCondition: boolean;\n  scopeMatch: boolean | 'N/A';\n  visible: boolean;\n}\n\n/**\n * Logs a console table showing each sidebar section's visibility state.\n * Useful for diagnosing why sections are hidden/shown.\n *\n * Call from browser DevTools or wire into a debug flag:\n * ```typescript\n * if (window.__WILDO_DEBUG_SIDEBAR__) {\n *   debugSectionVisibility(sections, activeMode, scopeParams);\n * }\n * ```\n *\n * @see app-shell-implementation-plan.md Step 8.3\n */\nexport function debugSectionVisibility(\n  sections: SidebarSection[],\n  activeMode: string | null,\n  scopeConditionParams: ScopeConditionParams,\n): void {\n  const rows: SectionVisibilityDebugRow[] = sections.map(section => {\n    const hasModeFilter = !!(section.visibleInModes && section.visibleInModes.length > 0);\n    let modeMatch: boolean | 'N/A' = 'N/A';\n\n    if (hasModeFilter) {\n      modeMatch = !!activeMode && section.visibleInModes!.includes(activeMode);\n    }\n\n    const hasScopeCondition = !!section.scopeCondition;\n    let scopeMatch: boolean | 'N/A' = 'N/A';\n\n    if (hasScopeCondition) {\n      try {\n        scopeMatch = section.scopeCondition!(scopeConditionParams);\n      } catch {\n        scopeMatch = false;\n      }\n    }\n\n    const visible = isSectionVisible(section, activeMode, scopeConditionParams);\n\n    return {\n      ref: section.ref,\n      contentKind: section.contentKind,\n      modeFilter: hasModeFilter ? section.visibleInModes!.join(', ') : '(all)',\n      modeMatch,\n      hasScopeCondition,\n      scopeMatch,\n      visible,\n    };\n  });\n\n  console.group(\n    `[SidebarVisibility] activeMode=\"${activeMode ?? 'none'}\" | ` +\n    `${rows.filter(r => r.visible).length}/${rows.length} sections visible`,\n  );\n  console.table(rows);\n  console.log('Scope params:', scopeConditionParams);\n  console.groupEnd();\n}\n"]}

package/dist/esm/core/monitoring/analytics/AnalyticsContext.d.ts

@@ -5,7 +5,6 @@
  * consent gating, and provider lifecycle management.
  */
 import React from 'react';
-import type { IAnalyticsProvider } from './analytics-provider.frontend.interface';
 export interface AnalyticsContextValue {
     /** Track a custom event (app-custom usage) */
     track: (name: string, properties?: Record<string, unknown>) => void;
@@ -18,7 +17,7 @@ export interface AnalyticsContextValue {
     /** Set of achieved value moment identifiers (scope-aware, persisted) */
     achievedMoments: Set<string>;
     /** Mark a value moment as achieved (persists to localStorage + backend sync) */
-    markMomentAchieved: (identifier: string) => void;
+    markMomentAchieved: (identifier: string) => boolean | Promise<boolean>;
     /**
      * Internal: ref for track() call interception (used by AnalyticsEventBridge).
      * The bridge registers a callback on mount to evaluate CUSTOM_EVENT and
@@ -28,9 +27,31 @@ export interface AnalyticsContextValue {
     _onTrackRef: React.MutableRefObject<((name: string, properties?: Record<string, unknown>) => void) | null>;
 }
 export declare const AnalyticsContext: React.Context<AnalyticsContextValue>;
+/** Identity snapshots come from the mounted AppScope owner, never a decoded token or a late event. */
+export interface AnalyticsIdentity {
+    userId: string | null;
+    organizationId: string | null;
+    applicationId: string | null;
+    anonymousUserId: string | null;
+}
+export declare const AnalyticsIdentityPublisherContext: React.Context<(identity: AnalyticsIdentity) => () => void>;
 export interface AnalyticsContextProviderProps {
     children: React.ReactNode;
-    customProviders?: IAnalyticsProvider[];
 }
+/**
+ * Two kinds of destination, and only ONE of them is a vendor (#1704).
+ *
+ * - The ENGINE's own destinations (`console`, `backend_proxy`), selected by `analytics.providers`. They send
+ *   nothing to a third party (the proxy posts to the application's own backend), and they keep the gate
+ *   below: `analytics.enabled`, then `analytics.requiresConsent` / the ANALYTICS grant.
+ * - VENDORS (PostHog, …) arrive as `FRONTEND_PRODUCT_ANALYTICS` provider modules. They are started by the
+ *   consent-based activation consumer once the person grants what they rest on, and stopped on withdrawal
+ *   or sign-out; this context only dispatches to the sinks that are running. That replaced an
+ *   `analyticsProviders` / `customProviders` door which let an application pass a vendor client here,
+ *   behind a second consent gate and outside the CSP footprint — two gates for one decision.
+ *
+ * `analytics.enabled` stays the master switch for both: with it off, a `FRONTEND_PRODUCT_ANALYTICS` vendor is not
+ * even loaded (the consent-based consumer skips it), and any sink that is running receives nothing.
+ */
 export declare const AnalyticsContextProvider: React.FC<AnalyticsContextProviderProps>;
 //# sourceMappingURL=AnalyticsContext.d.ts.map

package/dist/esm/core/monitoring/analytics/AnalyticsContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnalyticsContext.d.ts","sourceRoot":"","sources":["../../../../../src/core/monitoring/analytics/AnalyticsContext.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAuF,MAAM,OAAO,CAAC;AAE5G,OAAO,KAAK,EAAE,kBAAkB,EAAkB,MAAM,yCAAyC,CAAC;AAUlG,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACpE,wBAAwB;IACxB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACnE,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,CAAC;IAClB,qDAAqD;IACrD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,wEAAwE;IACxE,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,gFAAgF;IAChF,kBAAkB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD;;;;;OAKG;IACH,WAAW,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;CAC5G;AAKD,eAAO,MAAM,gBAAgB,sCAAoD,CAAC;AAkBlF,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,eAAe,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACxC;AAED,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC,EAAE,CAAC,6BAA6B,CAwO5E,CAAC"}
+{"version":3,"file":"AnalyticsContext.d.ts","sourceRoot":"","sources":["../../../../../../src/core/monitoring/analytics/AnalyticsContext.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAuF,MAAM,OAAO,CAAC;AAe5G,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACpE,wBAAwB;IACxB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACnE,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,CAAC;IAClB,qDAAqD;IACrD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,wEAAwE;IACxE,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,gFAAgF;IAChF,kBAAkB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvE;;;;;OAKG;IACH,WAAW,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;CAC5G;AAKD,eAAO,MAAM,gBAAgB,sCAAoD,CAAC;AAElF,sGAAsG;AACtG,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AACD,eAAO,MAAM,iCAAiC,2BAA6B,iBAAiB,KAAK,MAAM,IAAI,CAAe,CAAC;AAuB3H,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC,EAAE,CAAC,6BAA6B,CAmb5E,CAAC"}