@owlmeans/web-panel 0.1.18-rc.9 → 0.1.18

package/src/permission/i18n/be.json

@@ -0,0 +1,13 @@
+{
+  "title": "Дзеянне адхілена",
+  "description": "Сервер адхіліў дзеянне паводле бягучых правіл доступу. Калі вы чакалі доступу, звярніцеся да адміністратара.",
+  "technical-details": "Тэхнічныя падрабязнасці",
+  "endpoint": "Канцавы пункт",
+  "status": "Статус",
+  "incident": "Ідэнтыфікатар інцыдэнту",
+  "area-title": "Доступ забаронены",
+  "area-description": "Ваш уліковы запіс не можа адкрыць гэты раздзел. Калі вы чакалі доступу, звярніцеся да адміністратара.",
+  "area": "Раздзел",
+  "required-permissions": "Патрэбныя дазволы",
+  "logout": "Выйсці"
+}

package/src/permission/i18n/de.json

@@ -0,0 +1,13 @@
+{
+  "title": "Aktion verweigert",
+  "description": "Der Server hat diese Aktion gemäß den aktuellen Berechtigungen verweigert. Wenn Sie Zugriff erwartet haben, fragen Sie eine Administratorin oder einen Administrator.",
+  "technical-details": "Technische Details",
+  "endpoint": "Endpunkt",
+  "status": "Status",
+  "incident": "Vorfall-ID",
+  "area-title": "Zugriff verweigert",
+  "area-description": "Ihr Konto kann diesen Bereich nicht öffnen. Wenn Sie Zugriff erwartet haben, wenden Sie sich an die Administration.",
+  "area": "Bereich",
+  "required-permissions": "Erforderliche Berechtigungen",
+  "logout": "Abmelden"
+}

package/src/permission/i18n/en.json

@@ -0,0 +1,13 @@
+{
+  "title": "Action denied",
+  "description": "The server denied this action under the current permission rules. If you expected access, ask an administrator.",
+  "technical-details": "Technical details",
+  "endpoint": "Endpoint",
+  "status": "Status",
+  "incident": "Incident ID",
+  "area-title": "Access denied",
+  "area-description": "Your account cannot open this area. Ask an administrator if you expected access.",
+  "area": "Area",
+  "required-permissions": "Required permissions",
+  "logout": "Log out"
+}

package/src/permission/i18n/es.json

@@ -0,0 +1,13 @@
+{
+  "title": "Acción denegada",
+  "description": "El servidor denegó esta acción según las reglas de permisos actuales. Si esperaba tener acceso, consulte a un administrador.",
+  "technical-details": "Detalles técnicos",
+  "endpoint": "Punto de acceso",
+  "status": "Estado",
+  "incident": "ID del incidente",
+  "area-title": "Acceso denegado",
+  "area-description": "Su cuenta no puede abrir esta sección. Si esperaba tener acceso, consulte a un administrador.",
+  "area": "Sección",
+  "required-permissions": "Permisos necesarios",
+  "logout": "Cerrar sesión"
+}

package/src/permission/i18n/fr.json

@@ -0,0 +1,13 @@
+{
+  "title": "Action refusée",
+  "description": "Le serveur a refusé cette action selon les autorisations actuelles. Si vous pensiez avoir accès, contactez un administrateur.",
+  "technical-details": "Détails techniques",
+  "endpoint": "Point de terminaison",
+  "status": "Statut",
+  "incident": "ID de l’incident",
+  "area-title": "Accès refusé",
+  "area-description": "Votre compte ne peut pas ouvrir cette section. Si vous pensiez avoir accès, contactez un administrateur.",
+  "area": "Section",
+  "required-permissions": "Autorisations requises",
+  "logout": "Se déconnecter"
+}

package/src/permission/i18n/pl.json

@@ -0,0 +1,13 @@
+{
+  "title": "Działanie odrzucone",
+  "description": "Serwer odrzucił to działanie zgodnie z obecnymi uprawnieniami. Jeśli oczekujesz dostępu, skontaktuj się z administratorem.",
+  "technical-details": "Szczegóły techniczne",
+  "endpoint": "Punkt końcowy",
+  "status": "Status",
+  "incident": "Identyfikator incydentu",
+  "area-title": "Odmowa dostępu",
+  "area-description": "Twoje konto nie może otworzyć tego obszaru. Jeśli oczekujesz dostępu, skontaktuj się z administratorem.",
+  "area": "Obszar",
+  "required-permissions": "Wymagane uprawnienia",
+  "logout": "Wyloguj się"
+}

package/src/permission/i18n/ru.json

@@ -0,0 +1,13 @@
+{
+  "title": "Действие отклонено",
+  "description": "Сервер отклонил действие согласно текущим правилам доступа. Если вам нужен доступ, обратитесь к администратору.",
+  "technical-details": "Технические подробности",
+  "endpoint": "Конечная точка",
+  "status": "Статус",
+  "incident": "Идентификатор инцидента",
+  "area-title": "Доступ запрещён",
+  "area-description": "Ваша учётная запись не может открыть этот раздел. Если вам нужен доступ, обратитесь к администратору.",
+  "area": "Раздел",
+  "required-permissions": "Необходимые разрешения",
+  "logout": "Выйти"
+}

package/src/permission/i18n/uk.json

@@ -0,0 +1,13 @@
+{
+  "title": "Дію відхилено",
+  "description": "Сервер відхилив цю дію згідно з поточними правилами доступу. Якщо ви очікували доступу, зверніться до адміністратора.",
+  "technical-details": "Технічні подробиці",
+  "endpoint": "Кінцева точка",
+  "status": "Статус",
+  "incident": "Ідентифікатор інциденту",
+  "area-title": "Доступ заборонено",
+  "area-description": "Ваш обліковий запис не може відкрити цей розділ. Якщо ви очікували доступу, зверніться до адміністратора.",
+  "area": "Розділ",
+  "required-permissions": "Потрібні дозволи",
+  "logout": "Вийти"
+}

package/src/permission/i18n.ts

@@ -0,0 +1,13 @@
+import { i18nHelper } from '@owlmeans/i18n'
+import en from './i18n/en.json'
+import pl from './i18n/pl.json'
+import ru from './i18n/ru.json'
+import be from './i18n/be.json'
+import uk from './i18n/uk.json'
+import es from './i18n/es.json'
+import de from './i18n/de.json'
+import fr from './i18n/fr.json'
+
+for (const [language, chunk] of Object.entries({ en, pl, ru, be, uk, es, de, fr })) {
+  i18nHelper.addI18nLib(language, 'permission-denied', chunk)
+}

package/src/permission/index.ts

@@ -0,0 +1,27 @@
+import './i18n.js'
+import { createElement } from 'react'
+import { toast } from 'sonner'
+import type { BasicContext } from '@owlmeans/context'
+import { ensureEntrypointFailureService } from '@owlmeans/client-entrypoint'
+import { apiStatusHelper } from '@owlmeans/api/status'
+import { PermissionDeniedToast } from './toast.js'
+
+export { PermissionDeniedToast } from './toast.js'
+
+/** Opt-in adapter for the context's entrypoint failures; mount one Toaster in the app shell. */
+export const appendPermissionDeniedToast = <T extends BasicContext<any>>(context: T): T => {
+  const seen = new Map<string, number>()
+  ensureEntrypointFailureService(context).registerPlugin({
+    alias: 'web-panel:permission-denied-toast',
+    onFailure: ({ alias, error }) => {
+      if (!apiStatusHelper.isAccessDenied(error)) return
+      const now = Date.now()
+      if (now - (seen.get(alias) ?? 0) < 2000) return
+      seen.set(alias, now)
+      toast.warning(createElement(PermissionDeniedToast, {
+        alias, status: apiStatusHelper.httpStatusOf(error), incidentId: apiStatusHelper.incidentIdOf(error),
+      }))
+    },
+  })
+  return context
+}

package/src/permission/toast.tsx

@@ -0,0 +1,20 @@
+import type { FC } from 'react'
+import { useI18nLib } from '@owlmeans/client-i18n'
+import type { PermissionDeniedToastProps } from './types.js'
+
+/** A refusal is actionable context for the user, with diagnostics outside the explanation. */
+export const PermissionDeniedToast: FC<PermissionDeniedToastProps> = ({ alias, status, incidentId }) => {
+  const t = useI18nLib('permission-denied')
+  return <div className="space-y-2 max-w-sm text-sm">
+    <p className="font-semibold">{t('title')}</p>
+    <p>{t('description')}</p>
+    <details className="text-xs">
+      <summary className="cursor-pointer">{t('technical-details')}</summary>
+      <dl className="mt-2 grid grid-cols-[auto_1fr] gap-x-2 break-all">
+        <dt>{t('endpoint')}</dt><dd>{alias}</dd>
+        {status != null && <><dt>{t('status')}</dt><dd>{status}</dd></>}
+        {incidentId != null && <><dt>{t('incident')}</dt><dd>{incidentId}</dd></>}
+      </dl>
+    </details>
+  </div>
+}

package/src/permission/types.ts

@@ -0,0 +1,5 @@
+export interface PermissionDeniedToastProps {
+  alias: string
+  status: number | null
+  incidentId: string | null
+}

package/src/picker/icons/consts.ts

@@ -0,0 +1,309 @@
+import type { LucideIcon } from 'lucide-react'
+import {
+  BriefcaseIcon, FolderIcon, FolderOpenIcon, FolderKanbanIcon, FileIcon, FileTextIcon,
+  FilesIcon, ClipboardListIcon, ClipboardCheckIcon, ListChecksIcon, ListTodoIcon, SquareCheckIcon,
+  KanbanIcon, CalendarIcon, CalendarCheckIcon, CalendarDaysIcon, CalendarClockIcon, ClockIcon,
+  TimerIcon, HourglassIcon, TargetIcon, FlagIcon, MilestoneIcon, RocketIcon,
+  LightbulbIcon, BookOpenIcon, NotebookPenIcon, PresentationIcon, LayersIcon, LayoutGridIcon,
+  WorkflowIcon, GoalIcon, TrophyIcon, AwardIcon, PenLineIcon, ArchiveIcon,
+  PaperclipIcon, UserIcon, UserRoundIcon, UserRoundCheckIcon, UserRoundPlusIcon, UserCheckIcon,
+  UserPlusIcon, UsersIcon, UsersRoundIcon, ContactIcon, IdCardIcon, HandshakeIcon,
+  PersonStandingIcon, AccessibilityIcon, FaceSlightlySmilingIcon, HeartHandshakeIcon, GraduationCapIcon, UserCogIcon,
+  CrownIcon, HandIcon, ThumbsUpIcon, MailIcon, MailOpenIcon, InboxIcon,
+  SendIcon, MessageSquareIcon, MessageCircleIcon, MessagesSquareIcon, PhoneIcon, PhoneCallIcon,
+  MegaphoneIcon, BellIcon, BellRingIcon, AtSignIcon, HeadsetIcon, VideoIcon,
+  MicIcon, Share2Icon, ReplyIcon, LanguagesIcon, NewspaperIcon, ShoppingCartIcon,
+  ShoppingBagIcon, StoreIcon, ReceiptIcon, CreditCardIcon, WalletIcon, BanknoteIcon,
+  CoinsIcon, PiggyBankIcon, DollarSignIcon, EuroIcon, PercentIcon, TagIcon,
+  TagsIcon, TicketIcon, GiftIcon, PackageIcon, BadgePercentIcon, TrendingUpIcon,
+  TrendingDownIcon, ScaleIcon, LandmarkIcon, CalculatorIcon, HandCoinsIcon, ChartLineIcon,
+  ChartColumnIcon, ChartPieIcon, WrenchIcon, HammerIcon, SettingsIcon, CogIcon,
+  SlidersHorizontalIcon, FunnelIcon, TruckIcon, WarehouseIcon, FactoryIcon, ContainerIcon,
+  BoxesIcon, PackageCheckIcon, RouteIcon, GaugeIcon, ActivityIcon, SirenIcon,
+  ShieldIcon, ShieldCheckIcon, LockIcon, KeyIcon, HardHatIcon, ConstructionIcon,
+  RecycleIcon, StampIcon, BuildingIcon, BuildingComplexIcon, HouseIcon, HotelIcon,
+  SchoolIcon, HospitalIcon, MapIcon, MapPinIcon, MapPinnedIcon, GlobeIcon,
+  EarthIcon, CompassIcon, NavigationIcon, PlaneIcon, CarIcon, BusIcon,
+  TrainFrontIcon, ShipIcon, BikeIcon, MountainIcon, CodeIcon, TerminalIcon,
+  ServerIcon, DatabaseIcon, CloudIcon, CpuIcon, MonitorIcon, LaptopIcon,
+  SmartphoneIcon, TabletIcon, WifiIcon, BluetoothIcon, PlugIcon, HardDriveIcon,
+  GitBranchIcon, GitPullRequestIcon, BotIcon, BrainIcon, PuzzleIcon, BlocksIcon,
+  BugIcon, WebhookIcon, LinkIcon, QrCodeIcon, KeyboardIcon, PrinterIcon,
+  CircleIcon, CircleCheckIcon, CircleXIcon, CircleAlertIcon, CircleQuestionMarkIcon, CirclePauseIcon,
+  CirclePlayIcon, CircleDotIcon, CircleDashedIcon, TriangleAlertIcon, OctagonAlertIcon, InfoIcon,
+  BanIcon, CheckIcon, XIcon, LoaderIcon, RefreshCwIcon, EyeIcon,
+  EyeOffIcon, FlameIcon, ZapIcon, SparklesIcon, StarIcon, HeartIcon,
+  ThumbsDownIcon, BadgeCheckIcon, ShieldAlertIcon, BookmarkIcon, PinIcon, BookIcon,
+  PenIcon, PencilIcon, PaletteIcon, BrushIcon, CameraIcon, ImageIcon,
+  MusicIcon, HeadphonesIcon, Gamepad2Icon, UmbrellaIcon, ShirtIcon, WatchIcon,
+  CoffeeIcon, UtensilsIcon, LampIcon, ArmchairIcon, BedIcon, ScissorsIcon,
+  RulerIcon, TrashIcon, BoxIcon, MagnetIcon, FlaskConicalIcon, MicroscopeIcon,
+  StethoscopeIcon, PillIcon, DumbbellIcon, LeafIcon, TreePineIcon, TreesIcon,
+  FlowerIcon, Flower2Icon, SproutIcon, SunIcon, MoonIcon, CloudRainIcon,
+  CloudSunIcon, SnowflakeIcon, DropletIcon, WavesHorizontalIcon, WindIcon, MountainSnowIcon,
+  BirdIcon, FishIcon, CatIcon, DogIcon, PawPrintIcon, FeatherIcon,
+  AppleIcon, CarrotIcon,
+} from 'lucide-react'
+
+/**
+ * Every catalogue icon by its stored name, each a statically imported lucide component — so a
+ * bundler keeps exactly these and nothing else, and a target bundle needs no dynamic import. Never
+ * `dynamicIconImports`, `DynamicIcon` or a namespace import: each pulls the whole set (~2,100 icons).
+ * Keys equal `PICKER_ICON_NAMES` (`tests/picker-vocabulary.spec.ts`).
+ */
+export const PICKER_ICONS: Readonly<Record<string, LucideIcon>> = Object.freeze({
+  'briefcase': BriefcaseIcon,
+  'folder': FolderIcon,
+  'folder-open': FolderOpenIcon,
+  'folder-kanban': FolderKanbanIcon,
+  'file': FileIcon,
+  'file-text': FileTextIcon,
+  'files': FilesIcon,
+  'clipboard-list': ClipboardListIcon,
+  'clipboard-check': ClipboardCheckIcon,
+  'list-checks': ListChecksIcon,
+  'list-todo': ListTodoIcon,
+  'square-check': SquareCheckIcon,
+  'kanban': KanbanIcon,
+  'calendar': CalendarIcon,
+  'calendar-check': CalendarCheckIcon,
+  'calendar-days': CalendarDaysIcon,
+  'calendar-clock': CalendarClockIcon,
+  'clock': ClockIcon,
+  'timer': TimerIcon,
+  'hourglass': HourglassIcon,
+  'target': TargetIcon,
+  'flag': FlagIcon,
+  'milestone': MilestoneIcon,
+  'rocket': RocketIcon,
+  'lightbulb': LightbulbIcon,
+  'book-open': BookOpenIcon,
+  'notebook-pen': NotebookPenIcon,
+  'presentation': PresentationIcon,
+  'layers': LayersIcon,
+  'layout-grid': LayoutGridIcon,
+  'workflow': WorkflowIcon,
+  'goal': GoalIcon,
+  'trophy': TrophyIcon,
+  'award': AwardIcon,
+  'pen-line': PenLineIcon,
+  'archive': ArchiveIcon,
+  'paperclip': PaperclipIcon,
+  'user': UserIcon,
+  'user-round': UserRoundIcon,
+  'user-round-check': UserRoundCheckIcon,
+  'user-round-plus': UserRoundPlusIcon,
+  'user-check': UserCheckIcon,
+  'user-plus': UserPlusIcon,
+  'users': UsersIcon,
+  'users-round': UsersRoundIcon,
+  'contact': ContactIcon,
+  'id-card': IdCardIcon,
+  'handshake': HandshakeIcon,
+  'person-standing': PersonStandingIcon,
+  'accessibility': AccessibilityIcon,
+  'face-slightly-smiling': FaceSlightlySmilingIcon,
+  'heart-handshake': HeartHandshakeIcon,
+  'graduation-cap': GraduationCapIcon,
+  'user-cog': UserCogIcon,
+  'crown': CrownIcon,
+  'hand': HandIcon,
+  'thumbs-up': ThumbsUpIcon,
+  'mail': MailIcon,
+  'mail-open': MailOpenIcon,
+  'inbox': InboxIcon,
+  'send': SendIcon,
+  'message-square': MessageSquareIcon,
+  'message-circle': MessageCircleIcon,
+  'messages-square': MessagesSquareIcon,
+  'phone': PhoneIcon,
+  'phone-call': PhoneCallIcon,
+  'megaphone': MegaphoneIcon,
+  'bell': BellIcon,
+  'bell-ring': BellRingIcon,
+  'at-sign': AtSignIcon,
+  'headset': HeadsetIcon,
+  'video': VideoIcon,
+  'mic': MicIcon,
+  'share-2': Share2Icon,
+  'reply': ReplyIcon,
+  'languages': LanguagesIcon,
+  'newspaper': NewspaperIcon,
+  'shopping-cart': ShoppingCartIcon,
+  'shopping-bag': ShoppingBagIcon,
+  'store': StoreIcon,
+  'receipt': ReceiptIcon,
+  'credit-card': CreditCardIcon,
+  'wallet': WalletIcon,
+  'banknote': BanknoteIcon,
+  'coins': CoinsIcon,
+  'piggy-bank': PiggyBankIcon,
+  'dollar-sign': DollarSignIcon,
+  'euro': EuroIcon,
+  'percent': PercentIcon,
+  'tag': TagIcon,
+  'tags': TagsIcon,
+  'ticket': TicketIcon,
+  'gift': GiftIcon,
+  'package': PackageIcon,
+  'badge-percent': BadgePercentIcon,
+  'trending-up': TrendingUpIcon,
+  'trending-down': TrendingDownIcon,
+  'scale': ScaleIcon,
+  'landmark': LandmarkIcon,
+  'calculator': CalculatorIcon,
+  'hand-coins': HandCoinsIcon,
+  'chart-line': ChartLineIcon,
+  'chart-column': ChartColumnIcon,
+  'chart-pie': ChartPieIcon,
+  'wrench': WrenchIcon,
+  'hammer': HammerIcon,
+  'settings': SettingsIcon,
+  'cog': CogIcon,
+  'sliders-horizontal': SlidersHorizontalIcon,
+  'funnel': FunnelIcon,
+  'truck': TruckIcon,
+  'warehouse': WarehouseIcon,
+  'factory': FactoryIcon,
+  'container': ContainerIcon,
+  'boxes': BoxesIcon,
+  'package-check': PackageCheckIcon,
+  'route': RouteIcon,
+  'gauge': GaugeIcon,
+  'activity': ActivityIcon,
+  'siren': SirenIcon,
+  'shield': ShieldIcon,
+  'shield-check': ShieldCheckIcon,
+  'lock': LockIcon,
+  'key': KeyIcon,
+  'hard-hat': HardHatIcon,
+  'construction': ConstructionIcon,
+  'recycle': RecycleIcon,
+  'stamp': StampIcon,
+  'building': BuildingIcon,
+  'building-complex': BuildingComplexIcon,
+  'house': HouseIcon,
+  'hotel': HotelIcon,
+  'school': SchoolIcon,
+  'hospital': HospitalIcon,
+  'map': MapIcon,
+  'map-pin': MapPinIcon,
+  'map-pinned': MapPinnedIcon,
+  'globe': GlobeIcon,
+  'earth': EarthIcon,
+  'compass': CompassIcon,
+  'navigation': NavigationIcon,
+  'plane': PlaneIcon,
+  'car': CarIcon,
+  'bus': BusIcon,
+  'train-front': TrainFrontIcon,
+  'ship': ShipIcon,
+  'bike': BikeIcon,
+  'mountain': MountainIcon,
+  'code': CodeIcon,
+  'terminal': TerminalIcon,
+  'server': ServerIcon,
+  'database': DatabaseIcon,
+  'cloud': CloudIcon,
+  'cpu': CpuIcon,
+  'monitor': MonitorIcon,
+  'laptop': LaptopIcon,
+  'smartphone': SmartphoneIcon,
+  'tablet': TabletIcon,
+  'wifi': WifiIcon,
+  'bluetooth': BluetoothIcon,
+  'plug': PlugIcon,
+  'hard-drive': HardDriveIcon,
+  'git-branch': GitBranchIcon,
+  'git-pull-request': GitPullRequestIcon,
+  'bot': BotIcon,
+  'brain': BrainIcon,
+  'puzzle': PuzzleIcon,
+  'blocks': BlocksIcon,
+  'bug': BugIcon,
+  'webhook': WebhookIcon,
+  'link': LinkIcon,
+  'qr-code': QrCodeIcon,
+  'keyboard': KeyboardIcon,
+  'printer': PrinterIcon,
+  'circle': CircleIcon,
+  'circle-check': CircleCheckIcon,
+  'circle-x': CircleXIcon,
+  'circle-alert': CircleAlertIcon,
+  'circle-question-mark': CircleQuestionMarkIcon,
+  'circle-pause': CirclePauseIcon,
+  'circle-play': CirclePlayIcon,
+  'circle-dot': CircleDotIcon,
+  'circle-dashed': CircleDashedIcon,
+  'triangle-alert': TriangleAlertIcon,
+  'octagon-alert': OctagonAlertIcon,
+  'info': InfoIcon,
+  'ban': BanIcon,
+  'check': CheckIcon,
+  'x': XIcon,
+  'loader': LoaderIcon,
+  'refresh-cw': RefreshCwIcon,
+  'eye': EyeIcon,
+  'eye-off': EyeOffIcon,
+  'flame': FlameIcon,
+  'zap': ZapIcon,
+  'sparkles': SparklesIcon,
+  'star': StarIcon,
+  'heart': HeartIcon,
+  'thumbs-down': ThumbsDownIcon,
+  'badge-check': BadgeCheckIcon,
+  'shield-alert': ShieldAlertIcon,
+  'bookmark': BookmarkIcon,
+  'pin': PinIcon,
+  'book': BookIcon,
+  'pen': PenIcon,
+  'pencil': PencilIcon,
+  'palette': PaletteIcon,
+  'brush': BrushIcon,
+  'camera': CameraIcon,
+  'image': ImageIcon,
+  'music': MusicIcon,
+  'headphones': HeadphonesIcon,
+  'gamepad-2': Gamepad2Icon,
+  'umbrella': UmbrellaIcon,
+  'shirt': ShirtIcon,
+  'watch': WatchIcon,
+  'coffee': CoffeeIcon,
+  'utensils': UtensilsIcon,
+  'lamp': LampIcon,
+  'armchair': ArmchairIcon,
+  'bed': BedIcon,
+  'scissors': ScissorsIcon,
+  'ruler': RulerIcon,
+  'trash': TrashIcon,
+  'box': BoxIcon,
+  'magnet': MagnetIcon,
+  'flask-conical': FlaskConicalIcon,
+  'microscope': MicroscopeIcon,
+  'stethoscope': StethoscopeIcon,
+  'pill': PillIcon,
+  'dumbbell': DumbbellIcon,
+  'leaf': LeafIcon,
+  'tree-pine': TreePineIcon,
+  'trees': TreesIcon,
+  'flower': FlowerIcon,
+  'flower-2': Flower2Icon,
+  'sprout': SproutIcon,
+  'sun': SunIcon,
+  'moon': MoonIcon,
+  'cloud-rain': CloudRainIcon,
+  'cloud-sun': CloudSunIcon,
+  'snowflake': SnowflakeIcon,
+  'droplet': DropletIcon,
+  'waves-horizontal': WavesHorizontalIcon,
+  'wind': WindIcon,
+  'mountain-snow': MountainSnowIcon,
+  'bird': BirdIcon,
+  'fish': FishIcon,
+  'cat': CatIcon,
+  'dog': DogIcon,
+  'paw-print': PawPrintIcon,
+  'feather': FeatherIcon,
+  'apple': AppleIcon,
+  'carrot': CarrotIcon,
+})

package/src/picker/icons/types.ts

@@ -0,0 +1,18 @@
+import type { LucideIcon } from 'lucide-react'
+import type { PickerIconCategory, PickerIconEntry } from '../vocabulary/types.js'
+
+/** Looks icons up and searches the catalogue. */
+export interface PickerIconHelper {
+  /** The component for a stored name; unknown, empty or absent → the fallback icon (`circle`). */
+  iconOf: (name?: string | null) => LucideIcon
+  /** Whether a value names a catalogue icon. */
+  has: (name: unknown) => name is string
+  /**
+   * Catalogue entries matching a query — every word must start a word of the name, a search word or
+   * the category; the closest names first. An empty query lists them all. `names` narrows the
+   * catalogue and sets the order (an application's own icon list).
+   */
+  search: (query: string, names?: readonly string[]) => PickerIconEntry[]
+  /** The entries of one category, in catalogue order (or `names`' order). */
+  byCategory: (category: PickerIconCategory, names?: readonly string[]) => PickerIconEntry[]
+}

package/src/picker/icons.ts

@@ -0,0 +1,70 @@
+import type { LucideIcon } from 'lucide-react'
+import { PICKER_ICONS } from './icons/consts.js'
+import type { PickerIconHelper } from './icons/types.js'
+import { PICKER_FALLBACK_ICON, PICKER_ICON_ENTRIES } from './vocabulary/consts.js'
+import type { PickerIconCategory, PickerIconEntry } from './vocabulary/types.js'
+
+export const createPickerIconHelper = (): PickerIconHelper => {
+  const wordsOf = (text: string): string[] => text.toLowerCase().split(/[\s,-]+/).filter(word => word !== '')
+  const byName = new Map(PICKER_ICON_ENTRIES.map(entry => [entry.name, entry]))
+  // Each entry's words split once: its name's and its search words'.
+  const words = new Map(PICKER_ICON_ENTRIES.map(entry => [entry.name, {
+    name: wordsOf(entry.name), search: entry.keywords.flatMap(wordsOf),
+  }]))
+  const fallback = PICKER_ICONS[PICKER_FALLBACK_ICON]
+
+  const has = (name: unknown): name is string =>
+    typeof name === 'string' && Object.prototype.hasOwnProperty.call(PICKER_ICONS, name)
+
+  const iconOf = (name?: string | null): LucideIcon => has(name) ? PICKER_ICONS[name] : fallback
+
+  const scope = (names?: readonly string[]): PickerIconEntry[] => names == null
+    ? [...PICKER_ICON_ENTRIES]
+    : names.flatMap(name => {
+      const entry = byName.get(name)
+
+      return entry != null ? [entry] : []
+    })
+
+  /** 0 exact name, 1 name prefix, 2 a name word, 3 a search word, 4 the category; -1 no match. */
+  const rank = (entry: PickerIconEntry, query: string, terms: string[]): number => {
+    if (entry.name === query) {
+      return 0
+    }
+    const own = words.get(entry.name) ?? { name: [], search: [] }
+    const starts = (pool: string[]) => terms.every(term => pool.some(word => word.startsWith(term)))
+    if (!starts([...own.name, ...own.search, entry.category])) {
+      return -1
+    }
+    if (entry.name.startsWith(query.replace(/\s+/g, '-'))) {
+      return 1
+    }
+    if (starts(own.name)) {
+      return 2
+    }
+
+    return starts([...own.name, ...own.search]) ? 3 : 4
+  }
+
+  const search = (query: string, names?: readonly string[]): PickerIconEntry[] => {
+    const entries = scope(names)
+    const normalized = query.trim().toLowerCase().replace(/\s+/g, ' ')
+    if (normalized === '') {
+      return entries
+    }
+    const terms = wordsOf(normalized)
+
+    return entries
+      .map((entry, order) => ({ entry, order, score: rank(entry, normalized, terms) }))
+      .filter(hit => hit.score >= 0)
+      .sort((a, b) => a.score - b.score || a.order - b.order)
+      .map(hit => hit.entry)
+  }
+
+  const byCategory = (category: PickerIconCategory, names?: readonly string[]): PickerIconEntry[] =>
+    scope(names).filter(entry => entry.category === category)
+
+  return { iconOf, has, search, byCategory }
+}
+
+export const pickerIconHelper = createPickerIconHelper()

package/src/picker/index.ts

@@ -0,0 +1,11 @@
+/**
+ * `@owlmeans/web-panel/picker` — the standard icon + colour picker and the parts it is made of,
+ * plus everything of `./picker/vocabulary`. Not re-exported by the package root: only a bundle that
+ * imports this subpath carries the icon catalogue.
+ */
+
+export * from './vocabulary.js'
+export { PICKER_ICONS } from './icons/consts.js'
+export { pickerIconHelper, createPickerIconHelper } from './icons.js'
+export type * from './icons/types.js'
+export * from '../components/picker/index.js'

package/src/picker/utils/color/types.ts

@@ -0,0 +1,37 @@
+/** An sRGB colour, each channel 0..1. */
+export interface Rgb {
+  r: number
+  g: number
+  b: number
+}
+
+/** A colour in OKLCH: lightness 0..1, chroma, hue in radians. */
+export interface Oklch {
+  l: number
+  c: number
+  h: number
+}
+
+/** The four mode-dependent values a custom colour needs, each a lowercase `#rrggbb`. */
+export interface DerivedColor {
+  ink: string
+  soft: string
+  inkDark: string
+  softDark: string
+}
+
+/** Colour arithmetic for custom colours: parsing, WCAG contrast and OKLCH with gamut fitting. */
+export interface ColorUtils {
+  /** A six-digit `#rrggbb` (any case) → channels; anything else → `null`. */
+  parse: (hex: string) => Rgb | null
+  /** Channels → lowercase `#rrggbb`, clamped and rounded. */
+  hex: (rgb: Rgb) => string
+  /** WCAG 2 contrast ratio of two six-digit hex colours, 1..21. */
+  contrast: (a: string, b: string) => number
+  /**
+   * The ink and ground a custom colour renders with in both modes: grounds in the colour's hue,
+   * inks moved only as far in lightness as it takes to keep 4.5:1 on the ground and on the page
+   * (white, black). A colour that already reads well keeps its own value as the light ink.
+   */
+  derive: (hex: string) => DerivedColor
+}