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

package/dist/esm/components/navigation/app-level/useMenuUserOrgBehavior.js.map

@@ -1 +1 @@
-{"version":3,"file":"useMenuUserOrgBehavior.js","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/useMenuUserOrgBehavior.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo, useState } from 'react';\nimport { useNavigate } from 'react-router-dom';\n\nimport { ApplicationLevelComponentType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport { HorizontalPlacement, VerticalPlacement } from '@wildo-ai/presets-components-models';\nimport {\n  UserDropdownAvatarDisplay,\n  UserDropdownSection,\n} from '~wildo-frontend-lib/core/config/app-configuration-frontend.schemas';\nimport { HorizontalAlign, type FileMetadata } from '@wildo-ai/zod-decorators';\nimport { PlacementSide } from '@wildo-ai/presets-components-models';\nimport { useLauncherRuntimeAvailabilityContext } from '~wildo-frontend-lib/core/navigation/launcher-runtime-availability';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\nimport { LauncherItemTargetKind } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport { resolveItemRef, type ResolvedNavigationTarget } from '~wildo-frontend-lib/core/navigation/launcher-resolution';\nimport { useLauncherResolutionContext } from '~wildo-frontend-lib/core/navigation/useLauncherResolutionContext';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { buildResourceFileServeBaseUrl, buildFileServeThumbnailUrl } from '~wildo-frontend-lib/core/resources/file-serve-url.frontend.utils';\nimport { useAuthedFileObjectUrl } from '~wildo-frontend-lib/core/resources/useAuthedFileObjectUrl.frontend.hook';\nimport { CoreResourceType } from '@wildo-ai/saas-models';\nimport { envLoader } from '~wildo-frontend-lib/core/runtime/env-variable-loader.frontend.service';\nimport { CommonRoutePaths } from '~wildo-frontend-lib/core/runtime/routes.frontend.definitions';\n\nimport type { MenuUserOrgBehavior } from '~wildo-frontend-lib/core/app-shell/app-shell.schemas';\n\n/** Dropdown config shape extracted from component config (avatarDisplay, sections, etc.). */\ninterface UserDropdownConfiguration {\n  avatarDisplay?: UserDropdownAvatarDisplay;\n  /**\n   * `PREFERENCES` and `SETTINGS` currently affect the same effective settings\n   * block. `PREFERENCES` changes labeling when `SETTINGS` is absent; it does not\n   * introduce a second independent destination.\n   */\n  sections?: UserDropdownSection[];\n  showOrgSwitcher?: boolean;\n  showLogout?: boolean;\n  /**\n   * Settings-hub section refs to surface inline in the dropdown, in order.\n   *\n   * Names the SETTINGS vocabulary directly. The previous design took a SIDEBAR\n   * section ref and string-matched it (`s.ref === settingsSectionRef`), which\n   * made the dropdown's contents a side effect of how the sidebar happened to be\n   * arranged — two separate vocabularies joined by a magic string, so moving a\n   * sidebar section silently emptied the dropdown.\n   *\n   * Empty or omitted renders the single \"Settings\" button that opens the hub.\n   * There is deliberately no separate `mergeSettings` flag: the presence of\n   * entries IS the intent, and a boolean beside a list can only ever disagree\n   * with it.\n   */\n  settingsEntries?: readonly string[];\n}\n\n/**\n * Stable empty entries, shared by both read sites.\n *\n * A literal `?? []` allocates a NEW array on every render, and `settingsTargets`\n * memoizes on this value — so an application that configures `USER_DROPDOWN` as a\n * plain boolean (no config object, so `dropdownConfig` is undefined) would churn\n * the memo, its dependent `settingsTarget`, and every consumer of the returned\n * behavior, forever. The code this replaced depended on a boolean and a string,\n * which are stable by construction; an array is not.\n */\nconst NO_SETTINGS_ENTRIES: readonly string[] = Object.freeze([]);\n\nfunction isUserDropdownConfigObject(config: unknown): config is UserDropdownConfiguration {\n  return typeof config === 'object' && config !== null;\n}\n\nconst DEFAULT_SECTIONS: UserDropdownSection[] = [\n  UserDropdownSection.USER_INFO,\n  UserDropdownSection.ORG_SWITCHER,\n  UserDropdownSection.SETTINGS,\n  UserDropdownSection.LOGOUT,\n];\n\n\n/**\n * Behavior hook for MenuUserOrg — manages user/org data, dropdown config\n * resolution, popup alignment computation, and navigation handlers.\n */\nexport function useMenuUserOrgBehavior(\n  containerType?: ApplicationLevelComponentType,\n  containerPlacement?: HorizontalPlacement | VerticalPlacement\n): MenuUserOrgBehavior {\n  const { appComponentsConfiguration } = useUI();\n  const {\n    user,\n    organizations,\n    getCurrentOrganization,\n    setCurrentOrganization,\n    logout,\n    isAuthenticated,\n  } = useUserOrgs();\n  const { registry } = useResourceRegistry();\n  const resolutionCtx = useLauncherResolutionContext();\n  const routerNavigate = useNavigate();\n  const runtimeAvailabilityContext = useLauncherRuntimeAvailabilityContext();\n\n  const [isOpen, setIsOpen] = useState(false);\n\n  const config = appComponentsConfiguration?.[ApplicationLevelComponentType.USER_DROPDOWN];\n\n  const dropdownConfig = useMemo((): UserDropdownConfiguration | undefined => {\n    const componentConfig = isUserDropdownConfigObject(config) ? config : undefined;\n\n    if (!componentConfig) {\n      return undefined;\n    }\n\n    return {\n      avatarDisplay: componentConfig.avatarDisplay ?? UserDropdownAvatarDisplay.AVATAR_ONLY,\n      sections: componentConfig.sections ?? DEFAULT_SECTIONS,\n      showOrgSwitcher: componentConfig.showOrgSwitcher ?? true,\n      showLogout: componentConfig.showLogout ?? true,\n      settingsEntries: componentConfig.settingsEntries ?? NO_SETTINGS_ENTRIES,\n    };\n  }, [config]);\n\n  const currentOrganization = getCurrentOrganization();\n\n  const sections = dropdownConfig?.sections ?? DEFAULT_SECTIONS;\n  const avatarDisplay = dropdownConfig?.avatarDisplay ?? UserDropdownAvatarDisplay.AVATAR_ONLY;\n  const showOrgSwitcher = dropdownConfig?.showOrgSwitcher !== false;\n  const showLogout = dropdownConfig?.showLogout !== false;\n  const settingsEntries = dropdownConfig?.settingsEntries ?? NO_SETTINGS_ENTRIES;\n  const activeMode = runtimeAvailabilityContext.activeMode;\n  const availableModes = runtimeAvailabilityContext.availableModes;\n  const allScopeValues = runtimeAvailabilityContext.allScopeValues;\n\n  const popupAlignment = useMemo(() => {\n    if (containerType === ApplicationLevelComponentType.MENUBAR) {\n      if (containerPlacement === HorizontalPlacement.END) {\n        return { align: HorizontalAlign.END, side: PlacementSide.BOTTOM };\n      }\n      return { align: HorizontalAlign.START, side: PlacementSide.BOTTOM };\n    }\n\n    if (containerType === ApplicationLevelComponentType.SIDEBAR) {\n      if (containerPlacement === VerticalPlacement.BOTTOM) {\n        return { align: HorizontalAlign.END, side: PlacementSide.END };\n      }\n      return { align: HorizontalAlign.START, side: PlacementSide.END };\n    }\n\n    return { align: HorizontalAlign.END, side: PlacementSide.BOTTOM };\n  }, [containerType, containerPlacement]);\n\n\n  /**\n   * Resolve each authored settings-hub section ref to a navigation target.\n   *\n   * Every entry converges on the unified Settings Hub through the existing\n   * typed `SETTINGS_SECTION` launcher ref, so the dropdown gains no navigation\n   * semantics of its own — it just names sections. An entry the hub does not\n   * declare resolves to nothing and is dropped here; the DEV-startup verifier is\n   * where an author is told about it.\n   */\n  const settingsTargets = useMemo((): ResolvedNavigationTarget[] => {\n    if (!resolutionCtx) return [];\n\n    return settingsEntries.flatMap(sectionRef => {\n      const resolved = resolveItemRef(\n        { kind: LauncherItemTargetKind.SETTINGS_SECTION, sectionRef },\n        resolutionCtx,\n      );\n      return resolved ? [resolved] : [];\n    });\n  }, [resolutionCtx, settingsEntries]);\n\n  const settingsTarget = useMemo((): ResolvedNavigationTarget | null => {\n    if (!resolutionCtx) {\n      return null;\n    }\n\n    const firstAuthored = settingsTargets[0];\n    if (firstAuthored) {\n      return firstAuthored;\n    }\n\n    return resolveItemRef(\n      { kind: LauncherItemTargetKind.SETTINGS_SECTION },\n      resolutionCtx,\n    );\n  }, [resolutionCtx, settingsTargets]);\n\n  const userProfile = user?.userSelfProfile;\n\n  const userInitials = useMemo(() => {\n    if (!userProfile) {\n      return user?.email?.charAt(0).toUpperCase() || '?';\n    }\n    const firstName = userProfile.firstName ?? '';\n    const lastName = userProfile.lastName ?? '';\n    return `${firstName.charAt(0)}${lastName.charAt(0)}`.toUpperCase() || user?.email?.charAt(0).toUpperCase() || '?';\n  }, [user, userProfile]);\n\n  const displayName = useMemo(() => {\n    if (!user) return '';\n    if (userProfile?.firstName && userProfile?.lastName) {\n      return `${userProfile.firstName} ${userProfile.lastName}`;\n    }\n    return user.email ?? '';\n  }, [user, userProfile]);\n\n  const handleLogout = useCallback(() => {\n    setIsOpen(false);\n    logout();\n  }, [logout]);\n\n  const handleSwitchOrg = useCallback((orgId: string) => {\n    setIsOpen(false);\n    setCurrentOrganization(orgId);\n  }, [setCurrentOrganization]);\n\n  const handleNavigateToSettingsTarget = useCallback((target: ResolvedNavigationTarget) => {\n    setIsOpen(false);\n    // Every settings entry converges on the unified Settings Hub. The hub is\n    // URL-driven (`useSettingsHubRouterSync` reconstructs it from `/settings`),\n    // so navigate by URL only — do NOT push content into PRIMARY, which would\n    // double-render the section's panel behind the hub overlay.\n    routerNavigate(target.urlPath || CommonRoutePaths.settings);\n  }, [routerNavigate]);\n\n  // Avatar image for the nav. `avatar` is a `z_file()` ref/metadata carrying `fileId`,\n  // but its bytes live behind the AUTHENTICATED resource-integrated serve route (an\n  // `<img>` can't send the bearer, and the persisted `url`/`thumbnailUrl` are unused).\n  // So build the same serve URL the profile display uses — for the CURRENT user's own\n  // profile: `/user-user-self/{userId}/user-self-profile/{profileId}/files/avatar/{fileId}`\n  // — then fetch the bytes → object URL. Falls back to `undefined` (→ initials) when the\n  // avatar is unset or the route can't be resolved.\n  const avatarFile = userProfile?.avatar as unknown as FileMetadata | undefined;\n  const avatarServeUrl = useMemo<string | null>(() => {\n    const userId = String((userProfile as Record<string, unknown> | undefined)?.userId ?? (user as Record<string, unknown> | undefined)?._id ?? '');\n    const profileId = String((userProfile as Record<string, unknown> | undefined)?._id ?? '');\n    const avatarFileId = avatarFile?.fileId;\n    if (!registry || !userId || !profileId || !avatarFileId) return null;\n    const resourceConfig = registry.resourceConfigurations?.[CoreResourceType.USER_SELF_PROFILES];\n    const readOp = FrontendResourceUtils.resolveSingleResourceReadOperation(CoreResourceType.USER_SELF_PROFILES, registry);\n    if (!resourceConfig || !readOp) return null;\n    const contextResourceIdentifiers = { [CoreResourceType.USER_SELF]: userId };\n    const serveBase = buildResourceFileServeBaseUrl({\n      registry,\n      resourceConfig,\n      operation: readOp,\n      resourceType: CoreResourceType.USER_SELF_PROFILES,\n      fieldName: 'avatar',\n      recordId: profileId,\n      contextResourceIdentifiers,\n      contextualParameters: FrontendResourceUtils.buildContextualParameters(contextResourceIdentifiers, registry),\n      apiBaseUrl: envLoader.getApiUrl(),\n    });\n    if (!serveBase) return null;\n    // The nav avatar is tiny — request the downscaled `?variant=thumbnail` rendition\n    // rather than pulling the original bytes.\n    return buildFileServeThumbnailUrl(`${serveBase}/${encodeURIComponent(avatarFileId)}`);\n  }, [registry, user, userProfile, avatarFile?.fileId]);\n  const avatarUrl = useAuthedFileObjectUrl(avatarServeUrl) ?? undefined;\n  const email = user?.email ?? '';\n\n  return {\n    isOpen,\n    setIsOpen,\n    isUserAuthenticated: isAuthenticated() && !!user,\n    userInitials,\n    displayName,\n    email,\n    avatarUrl,\n    currentOrganization: currentOrganization ? { _id: currentOrganization._id, name: currentOrganization.name } : undefined,\n    organizations: (organizations ?? []).map(org => ({ _id: org._id, name: org.name })),\n    sections,\n    avatarDisplay,\n    showOrgSwitcher,\n    showLogout,\n    settingsTarget,\n    settingsTargets,\n    popupAlignment,\n    handleLogout,\n    handleSwitchOrg,\n    handleNavigateToSettingsTarget,\n  };\n}\n"]}
+{"version":3,"file":"useMenuUserOrgBehavior.js","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/useMenuUserOrgBehavior.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo, useState } from 'react';\nimport { useNavigate } from 'react-router-dom';\n\nimport { ApplicationLevelComponentType } from '~wildo-frontend-lib/core/config/app-level-components.frontend.schemas';\nimport { HorizontalPlacement, VerticalPlacement } from '@wildo-ai/presets-components-models';\nimport {\n  UserDropdownAvatarDisplay,\n  UserDropdownSection,\n} from '~wildo-frontend-lib/core/config/app-configuration-frontend.schemas';\nimport { HorizontalAlign, type FileMetadata } from '@wildo-ai/zod-decorators';\nimport { PlacementSide } from '@wildo-ai/presets-components-models';\nimport { useLauncherRuntimeAvailabilityContext } from '~wildo-frontend-lib/core/navigation/launcher-runtime-availability';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\nimport { LauncherItemTargetKind } from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport { resolveItemRef, type ResolvedNavigationTarget } from '~wildo-frontend-lib/core/navigation/launcher-resolution';\nimport { useLauncherResolutionContext } from '~wildo-frontend-lib/core/navigation/useLauncherResolutionContext';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport { useResourceRegistry } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { FrontendResourceUtils } from '~wildo-frontend-lib/core/resources/frontend-resource.utils';\nimport { buildResourceFileServeBaseUrl, buildFileServeThumbnailUrl } from '~wildo-frontend-lib/core/resources/file-serve-url.frontend.utils';\nimport { useAuthedFileObjectUrl } from '~wildo-frontend-lib/core/resources/useAuthedFileObjectUrl.frontend.hook';\nimport { CoreResourceType, isServiceProviderMembership } from '@wildo-ai/saas-models';\nimport { envLoader } from '~wildo-frontend-lib/core/runtime/env-variable-loader.frontend.service';\nimport { CommonRoutePaths } from '~wildo-frontend-lib/core/runtime/routes.frontend.definitions';\n\nimport type { MenuUserOrgBehavior } from '~wildo-frontend-lib/core/app-shell/app-shell.schemas';\n\n/** Dropdown config shape extracted from component config (avatarDisplay, sections, etc.). */\ninterface UserDropdownConfiguration {\n  avatarDisplay?: UserDropdownAvatarDisplay;\n  /**\n   * `PREFERENCES` and `SETTINGS` currently affect the same effective settings\n   * block. `PREFERENCES` changes labeling when `SETTINGS` is absent; it does not\n   * introduce a second independent destination.\n   */\n  sections?: UserDropdownSection[];\n  showOrgSwitcher?: boolean;\n  showLogout?: boolean;\n  /**\n   * Settings-hub section refs to surface inline in the dropdown, in order.\n   *\n   * Names the SETTINGS vocabulary directly. The previous design took a SIDEBAR\n   * section ref and string-matched it (`s.ref === settingsSectionRef`), which\n   * made the dropdown's contents a side effect of how the sidebar happened to be\n   * arranged — two separate vocabularies joined by a magic string, so moving a\n   * sidebar section silently emptied the dropdown.\n   *\n   * Empty or omitted renders the single \"Settings\" button that opens the hub.\n   * There is deliberately no separate `mergeSettings` flag: the presence of\n   * entries IS the intent, and a boolean beside a list can only ever disagree\n   * with it.\n   */\n  settingsEntries?: readonly string[];\n}\n\n/**\n * Stable empty entries, shared by both read sites.\n *\n * A literal `?? []` allocates a NEW array on every render, and `settingsTargets`\n * memoizes on this value — so an application that configures `USER_DROPDOWN` as a\n * plain boolean (no config object, so `dropdownConfig` is undefined) would churn\n * the memo, its dependent `settingsTarget`, and every consumer of the returned\n * behavior, forever. The code this replaced depended on a boolean and a string,\n * which are stable by construction; an array is not.\n */\nconst NO_SETTINGS_ENTRIES: readonly string[] = Object.freeze([]);\n\nfunction isUserDropdownConfigObject(config: unknown): config is UserDropdownConfiguration {\n  return typeof config === 'object' && config !== null;\n}\n\nconst DEFAULT_SECTIONS: UserDropdownSection[] = [\n  UserDropdownSection.USER_INFO,\n  UserDropdownSection.ORG_SWITCHER,\n  UserDropdownSection.SETTINGS,\n  UserDropdownSection.LOGOUT,\n];\n\n\n/**\n * Behavior hook for MenuUserOrg — manages user/org data, dropdown config\n * resolution, popup alignment computation, and navigation handlers.\n */\nexport function useMenuUserOrgBehavior(\n  containerType?: ApplicationLevelComponentType,\n  containerPlacement?: HorizontalPlacement | VerticalPlacement\n): MenuUserOrgBehavior {\n  const { appComponentsConfiguration } = useUI();\n  const {\n    user,\n    organizations,\n    getCurrentOrganization,\n    setCurrentOrganization,\n    logout,\n    isAuthenticated,\n  } = useUserOrgs();\n  const { registry } = useResourceRegistry();\n  const resolutionCtx = useLauncherResolutionContext();\n  const routerNavigate = useNavigate();\n  const runtimeAvailabilityContext = useLauncherRuntimeAvailabilityContext();\n\n  const [isOpen, setIsOpen] = useState(false);\n\n  const config = appComponentsConfiguration?.[ApplicationLevelComponentType.USER_DROPDOWN];\n\n  const dropdownConfig = useMemo((): UserDropdownConfiguration | undefined => {\n    const componentConfig = isUserDropdownConfigObject(config) ? config : undefined;\n\n    if (!componentConfig) {\n      return undefined;\n    }\n\n    return {\n      avatarDisplay: componentConfig.avatarDisplay ?? UserDropdownAvatarDisplay.AVATAR_ONLY,\n      sections: componentConfig.sections ?? DEFAULT_SECTIONS,\n      showOrgSwitcher: componentConfig.showOrgSwitcher ?? true,\n      showLogout: componentConfig.showLogout ?? true,\n      settingsEntries: componentConfig.settingsEntries ?? NO_SETTINGS_ENTRIES,\n    };\n  }, [config]);\n\n  const currentOrganization = getCurrentOrganization();\n\n  const sections = dropdownConfig?.sections ?? DEFAULT_SECTIONS;\n  const avatarDisplay = dropdownConfig?.avatarDisplay ?? UserDropdownAvatarDisplay.AVATAR_ONLY;\n  const showOrgSwitcher = dropdownConfig?.showOrgSwitcher !== false;\n  const showLogout = dropdownConfig?.showLogout !== false;\n  const settingsEntries = dropdownConfig?.settingsEntries ?? NO_SETTINGS_ENTRIES;\n  const activeMode = runtimeAvailabilityContext.activeMode;\n  const availableModes = runtimeAvailabilityContext.availableModes;\n  const allScopeValues = runtimeAvailabilityContext.allScopeValues;\n\n  const popupAlignment = useMemo(() => {\n    if (containerType === ApplicationLevelComponentType.MENUBAR) {\n      if (containerPlacement === HorizontalPlacement.END) {\n        return { align: HorizontalAlign.END, side: PlacementSide.BOTTOM };\n      }\n      return { align: HorizontalAlign.START, side: PlacementSide.BOTTOM };\n    }\n\n    if (containerType === ApplicationLevelComponentType.SIDEBAR) {\n      if (containerPlacement === VerticalPlacement.BOTTOM) {\n        return { align: HorizontalAlign.END, side: PlacementSide.END };\n      }\n      return { align: HorizontalAlign.START, side: PlacementSide.END };\n    }\n\n    return { align: HorizontalAlign.END, side: PlacementSide.BOTTOM };\n  }, [containerType, containerPlacement]);\n\n\n  /**\n   * Resolve each authored settings-hub section ref to a navigation target.\n   *\n   * Every entry converges on the unified Settings Hub through the existing\n   * typed `SETTINGS_SECTION` launcher ref, so the dropdown gains no navigation\n   * semantics of its own — it just names sections. An entry the hub does not\n   * declare resolves to nothing and is dropped here; the DEV-startup verifier is\n   * where an author is told about it.\n   */\n  const settingsTargets = useMemo((): ResolvedNavigationTarget[] => {\n    if (!resolutionCtx) return [];\n\n    return settingsEntries.flatMap(sectionRef => {\n      const resolved = resolveItemRef(\n        { kind: LauncherItemTargetKind.SETTINGS_SECTION, sectionRef },\n        resolutionCtx,\n      );\n      return resolved ? [resolved] : [];\n    });\n  }, [resolutionCtx, settingsEntries]);\n\n  const settingsTarget = useMemo((): ResolvedNavigationTarget | null => {\n    if (!resolutionCtx) {\n      return null;\n    }\n\n    const firstAuthored = settingsTargets[0];\n    if (firstAuthored) {\n      return firstAuthored;\n    }\n\n    return resolveItemRef(\n      { kind: LauncherItemTargetKind.SETTINGS_SECTION },\n      resolutionCtx,\n    );\n  }, [resolutionCtx, settingsTargets]);\n\n  const userProfile = user?.userSelfProfile;\n\n  const userInitials = useMemo(() => {\n    if (!userProfile) {\n      return user?.email?.charAt(0).toUpperCase() || '?';\n    }\n    const firstName = userProfile.firstName ?? '';\n    const lastName = userProfile.lastName ?? '';\n    return `${firstName.charAt(0)}${lastName.charAt(0)}`.toUpperCase() || user?.email?.charAt(0).toUpperCase() || '?';\n  }, [user, userProfile]);\n\n  const displayName = useMemo(() => {\n    if (!user) return '';\n    if (userProfile?.firstName && userProfile?.lastName) {\n      return `${userProfile.firstName} ${userProfile.lastName}`;\n    }\n    return user.email ?? '';\n  }, [user, userProfile]);\n\n  const handleLogout = useCallback(() => {\n    setIsOpen(false);\n    logout();\n  }, [logout]);\n\n  const handleSwitchOrg = useCallback((orgId: string) => {\n    setIsOpen(false);\n    setCurrentOrganization(orgId);\n  }, [setCurrentOrganization]);\n\n  const handleNavigateToSettingsTarget = useCallback((target: ResolvedNavigationTarget) => {\n    setIsOpen(false);\n    // Every settings entry converges on the unified Settings Hub. The hub is\n    // URL-driven (`useSettingsHubRouterSync` reconstructs it from `/settings`),\n    // so navigate by URL only — do NOT push content into PRIMARY, which would\n    // double-render the section's panel behind the hub overlay.\n    routerNavigate(target.urlPath || CommonRoutePaths.settings);\n  }, [routerNavigate]);\n\n  // Avatar image for the nav. `avatar` is a `z_file()` ref/metadata carrying `fileId`,\n  // but its bytes live behind the AUTHENTICATED resource-integrated serve route (an\n  // `<img>` can't send the bearer, and the persisted `url`/`thumbnailUrl` are unused).\n  // So build the same serve URL the profile display uses — for the CURRENT user's own\n  // profile: `/user-user-self/{userId}/user-self-profile/{profileId}/files/avatar/{fileId}`\n  // — then fetch the bytes → object URL. Falls back to `undefined` (→ initials) when the\n  // avatar is unset or the route can't be resolved.\n  const avatarFile = userProfile?.avatar as unknown as FileMetadata | undefined;\n  const avatarServeUrl = useMemo<string | null>(() => {\n    const userId = String((userProfile as Record<string, unknown> | undefined)?.userId ?? (user as Record<string, unknown> | undefined)?._id ?? '');\n    const profileId = String((userProfile as Record<string, unknown> | undefined)?._id ?? '');\n    const avatarFileId = avatarFile?.fileId;\n    if (!registry || !userId || !profileId || !avatarFileId) return null;\n    const resourceConfig = registry.resourceConfigurations?.[CoreResourceType.USER_SELF_PROFILES];\n    const readOp = FrontendResourceUtils.resolveSingleResourceReadOperation(CoreResourceType.USER_SELF_PROFILES, registry);\n    if (!resourceConfig || !readOp) return null;\n    const contextResourceIdentifiers = { [CoreResourceType.USER_SELF]: userId };\n    const serveBase = buildResourceFileServeBaseUrl({\n      registry,\n      resourceConfig,\n      operation: readOp,\n      resourceType: CoreResourceType.USER_SELF_PROFILES,\n      fieldName: 'avatar',\n      recordId: profileId,\n      contextResourceIdentifiers,\n      contextualParameters: FrontendResourceUtils.buildContextualParameters(contextResourceIdentifiers, registry),\n      apiBaseUrl: envLoader.getApiUrl(),\n    });\n    if (!serveBase) return null;\n    // The nav avatar is tiny — request the downscaled `?variant=thumbnail` rendition\n    // rather than pulling the original bytes.\n    return buildFileServeThumbnailUrl(`${serveBase}/${encodeURIComponent(avatarFileId)}`);\n  }, [registry, user, userProfile, avatarFile?.fileId]);\n  const avatarUrl = useAuthedFileObjectUrl(avatarServeUrl) ?? undefined;\n  const email = user?.email ?? '';\n  // The client organizations this person works in through a service firm (#1597), keyed to the firm's name\n  // the membership recorded. Read from the memberships the user context already carries — no request.\n  const providerNameByOrganizationId = useMemo(() => {\n    const byOrganization = new Map<string, string>();\n    for (const membership of user?.organizationMembers ?? []) {\n      if (!isServiceProviderMembership(membership)) continue;\n      const firmName = (membership as { providerOrganizationName?: unknown }).providerOrganizationName;\n      if (typeof firmName === 'string' && firmName.length > 0) byOrganization.set(String(membership.organizationId), firmName);\n    }\n    return byOrganization;\n  }, [user?.organizationMembers]);\n\n  return {\n    isOpen,\n    setIsOpen,\n    isUserAuthenticated: isAuthenticated() && !!user,\n    userInitials,\n    displayName,\n    email,\n    avatarUrl,\n    currentOrganization: currentOrganization ? { _id: currentOrganization._id, name: currentOrganization.name } : undefined,\n    organizations: (organizations ?? []).map(org => {\n      const viaProviderOrganizationName = providerNameByOrganizationId.get(String(org._id));\n      return { _id: org._id, name: org.name, ...(viaProviderOrganizationName ? { viaProviderOrganizationName } : {}) };\n    }),\n    sections,\n    avatarDisplay,\n    showOrgSwitcher,\n    showLogout,\n    settingsTarget,\n    settingsTargets,\n    popupAlignment,\n    handleLogout,\n    handleSwitchOrg,\n    handleNavigateToSettingsTarget,\n  };\n}\n"]}

package/dist/esm/components/navigation/app-level/useSidebarBehavior.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSidebarBehavior.d.ts","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/useSidebarBehavior.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAA8C,MAAM,qCAAqC,CAAC;AAUtH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAoB9D,OAAO,KAAK,EAAyF,eAAe,EAAE,MAAM,sDAAsD,CAAC;AAYnL,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAiBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,OAAO,EACf,iBAAiB,EAAE,kBAAkB,GAAG,SAAS,GAChD,OAAO,CAOT;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAKpD;AAuBD,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,eAAe,CA2pB3F"}
+{"version":3,"file":"useSidebarBehavior.d.ts","sourceRoot":"","sources":["../../../../../../src/components/navigation/app-level/useSidebarBehavior.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAA8C,MAAM,qCAAqC,CAAC;AAUtH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAoB9D,OAAO,KAAK,EAAyF,eAAe,EAAE,MAAM,sDAAsD,CAAC;AAYnL,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAiBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,OAAO,EACf,iBAAiB,EAAE,kBAAkB,GAAG,SAAS,GAChD,OAAO,CAOT;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,OAAO,CAKpD;AAuBD,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,eAAe,CAmrB3F"}

package/dist/esm/components/navigation/app-level/useSidebarBehavior.js

@@ -23,7 +23,7 @@ import { isSidebarConfigObject } from '../../../core/app-shell/app-shell.schemas
 import { resolveHostedComponents } from '../../../core/app-shell/hosted-components.utils.js';
 import { useResourceRegistry } from '../../../core/resources/useResourceRegistry.js';
 import { frontendResourceUtils } from '../../../core/resources/frontend-resource.utils.js';
-import { CoreResourceOperation } from '@wildo-ai/saas-models';
+import { CoreResourceOperation, NavigationTransition } from '@wildo-ai/saas-models';
 const logger = LoggerFrontendService.getLogger();
 const logDebug = logger.debugByType('SidebarBehavior');
 logger.setDebugTypeLogging('SidebarBehavior', false);
@@ -112,7 +112,7 @@ export function useSidebarBehavior(options = {}) {
     const runtimeAvailabilityContext = useLauncherRuntimeAvailabilityContext();
     // --- Config from UI context ---
     const { UIConfig, appComponentsConfiguration, sidebarCompactLabelMode, navigationLayout } = useUI();
-    const { navigate } = useNavigationController();
+    const { navigate, navigateToResource } = useNavigationController();
     const { registry } = useResourceRegistry();
     const config = appComponentsConfiguration?.[ApplicationLevelComponentType.SIDEBAR];
     const sidebarEnabled = config !== false;
@@ -581,12 +581,24 @@ export function useSidebarBehavior(options = {}) {
         setInlineCreateValue('');
     }, []);
     const handleSubmitInlineCreate = useCallback((sectionRef, resourceType) => {
-        if (!inlineCreateValue.trim() || !resourceType)
+        if (!resourceType)
             return;
         const rawSections = isSidebarConfigObject(config)
             ? config.contentSections
             : undefined;
         const section = rawSections?.find(s => s.ref === sectionRef);
+        /*
+         * `DIALOG` collects NOTHING inline — it opens the create form. This handler used to demand a
+         * typed value for both modes and return on an empty one, so every `DIALOG` section's button
+         * submitted `''` and did nothing, with no log. The mode is read off the section, which is
+         * where the author declared it.
+         */
+        // Only a navigation-list section declares an inline-create mode; the narrow is the same one the
+        // field name below already takes.
+        const opensDialog = section?.contentKind === SidebarSectionContentKind.NAVIGATION_LIST
+            && section.inlineCreate === SidebarSectionInlineCreate.DIALOG;
+        if (!opensDialog && !inlineCreateValue.trim())
+            return;
         const fieldName = (section?.contentKind === SidebarSectionContentKind.NAVIGATION_LIST
             ? section.inlineCreateField
             : undefined) ?? 'title';
@@ -599,10 +611,17 @@ export function useSidebarBehavior(options = {}) {
             resourceType,
             operation: createOperation,
             contextResourceIdentifiers: appScope?.buildContextResourceIdentifiers() ?? {},
-            additionalContext: {
-                defaultValuesOverride: { [fieldName]: inlineCreateValue.trim() },
-            },
+            ...(opensDialog ? {} : { additionalContext: { defaultValuesOverride: { [fieldName]: inlineCreateValue.trim() } } }),
         });
+        if (opensDialog) {
+            /*
+             * The section declared a DIALOG, so the form opens as one whatever the layout's app-level map
+             * says for CREATE — otherwise the same button would open a dialog in one application and a
+             * full page in the next.
+             */
+            navigateToResource(resourceContext, NavigationUtils.createAppLevelInitiator(ApplicationLevelComponentType.SIDEBAR), undefined, NavigationTransition.OVERLAY);
+            return;
+        }
         navigate({
             content: {
                 contentType: NavigationContentType.RESOURCE_OPERATION,
@@ -611,7 +630,7 @@ export function useSidebarBehavior(options = {}) {
             initiator: NavigationUtils.createAppLevelInitiator(ApplicationLevelComponentType.SIDEBAR),
         });
         handleCancelInlineCreate();
-    }, [inlineCreateValue, navigate, handleCancelInlineCreate, config, registry, appScope]);
+    }, [inlineCreateValue, navigate, navigateToResource, handleCancelInlineCreate, config, registry, appScope]);
     const isItemCollapsedFn = useCallback((itemId) => collapsedItems[itemId] ?? false, [collapsedItems]);
     // --- Favorites handlers ---
     // Both accept origin items (key = own `id`) and favorites-section copies
@@ -704,7 +723,22 @@ function mapResolvedSectionToSectionGroup(resolved, index) {
                 isPrimary: resolved.isPrimary ?? false,
                 ...(resolved.isPrimary ? { showLabel: false, collapsible: false } : {}),
             };
-            const items = resolved.items.map(item => mapResolvedItemToHierarchical(item));
+            /*
+             * The null filter is NOT optional, and `strict: false` will not tell you so.
+             *
+             * `mapResolvedItemToHierarchical` drops a malformed item of a known kind by answering `null`.
+             * The nested `children` map filtered those out; this one did not, and under
+             * `engine/tsconfig.common.json`'s `"strict": false` a `(T | null)[]` assigns to `T[]` with no
+             * diagnostic — so the typecheck said nothing. `renderHierarchicalItem` then reads
+             * `item.children` off `null` and takes the WHOLE SIDEBAR down.
+             *
+             * That is worse than the defect the drop was added for: before it, a malformed ENGINE_PAGE
+             * degraded into a view link that resolved to nothing. Introduced and caught the same day
+             * (2026-09-25), by a review pass over the change that introduced it.
+             */
+            const items = resolved.items
+                .map(item => mapResolvedItemToHierarchical(item))
+                .filter((item) => item !== null);
             return {
                 section: sectionProps,
                 items,
@@ -752,6 +786,19 @@ function mapResolvedSectionToSectionGroup(resolved, index) {
  * Dispatches on presence of `operation`/`resourceContext` to build a
  * `ResourceNavigationItem`, otherwise builds a `ViewNavigationItem`.
  */
+/**
+ * Report a navigation item that declares a KNOWN kind and lacks what that kind requires.
+ *
+ * Through the logger rather than `console.warn`, and outside `isDevelopment()`, because a dropped
+ * sidebar entry is a defect an operator should see wherever the application runs — the pre-existing
+ * RESOURCE diagnostics beside it are dev-only, which is why the ENGINE_PAGE case went unreported for
+ * as long as it existed.
+ */
+function logMalformedNavigationItem(item, problem) {
+    logger.warn(`Navigation item "${item.id}" ${problem} — dropped from the sidebar`, {
+        itemId: item.id, ref: item.ref, contentType: item.contentType,
+    });
+}
 function mapResolvedItemToHierarchical(item) {
     const base = {
         id: item.id,
@@ -761,7 +808,9 @@ function mapResolvedItemToHierarchical(item) {
         icon: item.icon,
         displayPolicy: item.displayPolicy,
         notificationBadgeRef: item.notificationBadgeRef,
-        children: item.children?.map(mapResolvedItemToHierarchical),
+        children: item.children
+            ?.map(mapResolvedItemToHierarchical)
+            .filter((child) => child !== null),
     };
     if (item.operation && item.resourceContext) {
         if (envLoader.isDevelopment()) {
@@ -779,7 +828,21 @@ function mapResolvedItemToHierarchical(item) {
             resourceContext: item.resourceContext,
         };
     }
-    if (item.contentType === NavigationContentType.ENGINE_PAGE && item.pageRef) {
+    if (item.contentType === NavigationContentType.ENGINE_PAGE) {
+        /*
+         * The `pageRef` guard used to be part of this condition (`&& item.pageRef`), so an ENGINE_PAGE
+         * item that declared no `pageRef` fell through every branch below into the terminal VIEW
+         * fallback — emitting a VIEW item that carries `contentType: ENGINE_PAGE` and a `viewRef` taken
+         * from the item's own ref. The sidebar entry then navigated to a view reference that resolves to
+         * nothing, silently: the dev-mode diagnostics below exist only for the RESOURCE branch.
+         *
+         * A malformed item of a KNOWN content type is a declaration defect, not a view. It is reported
+         * and dropped rather than degraded into a different kind of thing.
+         */
+        if (!item.pageRef) {
+            logMalformedNavigationItem(item, 'declares contentType ENGINE_PAGE with no `pageRef`');
+            return null;
+        }
         return {
             ...base,
             itemType: NavigationItemType.ENGINE_PAGE,
@@ -801,6 +864,15 @@ function mapResolvedItemToHierarchical(item) {
             contextResourceIdentifiers: item.contextResourceIdentifiers,
         };
     }
+    /*
+     * The terminal fallback is the VIEW FAMILY — a composite view, a chart, an execution, a flows
+     * actors view, a full custom view. It is reached by an item whose contentType is one of those, or
+     * by one that declares none at all.
+     *
+     * It is NOT a place for an item of a different known kind to land. Each branch above now reports
+     * and drops a malformed item of its own kind rather than letting it arrive here wearing a
+     * `viewRef` that resolves to nothing.
+     */
     return {
         ...base,
         itemType: NavigationItemType.VIEW,