Files
TREK/client/src/components/Map/pluginPoiIcons.ts
T
Maurice 1727732841 feat(plugins): plugins can add POI categories to the map and answer them
A new manifest capability poiCategories (up to 4, icon from an allow-list,
strict #rrggbb color) and the hook poiCategoryProvider.getPois behind the
hook:poi-category-provider permission. GET /api/plugin-pois in the plugin
contributions module answers them in the /api/maps/pois shape, with
search_plugin_pois as the MCP twin. plugin: ids no longer count as Google
place ids. SDK 1.8.0 carries the types, validation and docs.

On the map, one hook merges the built-in categories with the ones active
plugins declare, and the pill shows the plugin chips after a divider on
desktop and phone, scrolling sideways instead of shrinking a chip below
its touch target. A plugin chip searches through a repo that refuses
offline and parses the answer strictly. Its pins, on Leaflet and GL, use
the category's own icon and color, both checked again before they reach
any markup, and the hover card lists the plugin's details as escaped
text. A plugin POI can be added as a place like any other. The admin
panels on desktop and phone show a chip for the new permission and the
categories a plugin would add, from one shared module.

Addresses discussion #1781.
2026-09-25 01:24:55 +00:00

57 lines
1.8 KiB
TypeScript

import {
Accessibility, Bath, Bike, Droplet, Droplets, Footprints, Heart, Info, Landmark, MapPin,
Mountain, MountainSnow, PlugZap, Signpost, Star, Tent, TentTree, Trees, Waves, Zap,
type LucideIcon,
} from 'lucide-react'
import { isPluginPoiColor, isPluginPoiIcon, type PluginPoiIcon } from '@trek/shared'
/**
* How a plugin POI category (#1781) looks: its icon and its colour, resolved in one
* place for everything that draws one (the explore pill, the Leaflet and GL markers,
* the hover card and the admin panel).
*
* The icon table is keyed by the shared allow-list, so a name added to
* PLUGIN_POI_ICONS without a component here is a type error rather than a chip
* without a glyph. Imported one by one, unlike resolvePluginIcon's lookup over the
* whole lucide module: a plugin names one of twenty shapes, never an arbitrary export.
*/
const PLUGIN_POI_ICON_COMPONENTS: Record<PluginPoiIcon, LucideIcon> = {
Footprints,
Mountain,
MountainSnow,
Signpost,
Trees,
TentTree,
Tent,
Accessibility,
Droplet,
Droplets,
PlugZap,
Zap,
Bath,
Bike,
Waves,
Landmark,
MapPin,
Star,
Heart,
Info,
}
/** The grey an unknown POI category has always been drawn in. */
export const POI_DEFAULT_COLOR = '#6b7280'
/** The lucide component for an allow-listed icon name; MapPin for anything else. */
export function resolvePluginPoiIcon(name: unknown): LucideIcon {
return isPluginPoiIcon(name) ? PLUGIN_POI_ICON_COMPONENTS[name] : MapPin
}
/**
* The colour to draw, checked again even though the server already did: it ends up
* inside marker markup and a CSS background, so only a strict `#rrggbb` gets through
* and anything else is the default grey.
*/
export function pluginPoiColor(value: unknown): string {
return isPluginPoiColor(value) ? value : POI_DEFAULT_COLOR
}