GeoLeaf Core API - v3.0.0
    Preparing search index...
    • Resolves the icon/sprite config of a profile.

      The served profile.json does NOT inline an icons block — since the taxonomy-v3 migration it lives at the root of the file referenced by Files.modules.taxonomy (config/plugins/taxonomy.json), and is exposed at runtime as modules.taxonomy.icons. This helper returns profile.icons when already present (forward-compat with an inlined block), otherwise fetches the referenced file. It never throws: any failure resolves to null.

      Mirrors the runtime gate of GeoLeaf.Taxonomy.getIcons() (capabilities/taxonomy/public-api.ts): a capability disabled with enabled: false loads no sprite, so there is nothing to cache either. enabled absent means enabled (opt-out), matching getTaxonomyConfig().

      Parameters

      • profile: ProfileWithIcons | null | undefined

        Parsed profile.json object.

      • profileId: string

        Active profile id.

      • profilesBasePath: string

        Base path for profiles (caller's convention).

      • opts: ResolveIconsOptions = {}

        Path/guard options matching the caller's fetch convention.

      Returns Promise<IconsLike | null>

      The icons block, or null when absent/disabled/unreachable.