# Copyright (c) 2023 M.J.N. Corino, The Netherlands
#
# This software is released under the MIT license.


module Wx

  # Namespace for Material Design Art Provider elements.
  module MDAP

    # @api private
    class << self

      private

      # private registry for collected art clients and their art
      def art_registry
        @art_registry ||= {}
      end

      # check the private registry for availability of art for given client and art ids
      def get_art(client_id, art_id)
        return nil unless art_registry.has_key?(client_id)
        art_registry[client_id][:art][art_id]
      end

      # private registry mapping art client groups (FLUENT_UI, FONT_AWESOME etc.) to client ids
      def art_client_groups
        @art_client_groups ||= {}
      end

      # Base Art mapper class
      # Art mapper classes are used for the mapping standard wxRuby3 Art (Client) ids to
      # Material Design ids
      # @api private
      class ArtMapper
        def get_art(_client_id, _art_id)
          nil
        end

        class << self
          def null_mapper
            @null_mapper ||= ArtMapper.new
          end
        end
      end

      # Toplevel standard art mapper
      # @api private
      class StdArtMapper < ArtMapper

        def initialize
          @map = {}
        end

        def get_mapper(client_id)
          @map[client_id] || ArtMapper.null_mapper
        end

        def get_art(client_id, art_id)
          (@map[client_id] || ArtMapper.null_mapper).get_art(client_id, art_id)
        end

        def self.create(&block)
          std_mapper = StdArtMapper.new
          std_mapper.instance_eval(&block) if block_given?
          std_mapper
        end

        private

        def map_art(for_client: , &block)
          @map[for_client] = ArtClientIdMapMapper.create(self, &block)
        end

        def redirect_art(for_client:, to_client:, &block)
          @map[for_client] = ArtClientRedirectMapper.create(self, to_client, &block)
        end

      end

      # A mapper that refers standard art ids to specific Material Design art ids
      # (for a specific Material Design client id)
      # @api private
      class ArtClientIdMapMapper < ArtMapper
        def initialize(base)
          @base = base
          @id_map = ::Hash.new(ArtMapper.null_mapper) #.merge!(id_map)
        end

        def get_art(client_id, art_id)
          @id_map[art_id].get_art(client_id, art_id)
        end

        def self.create(base, &block)
          client_mapper = ArtClientIdMapMapper.new(base)
          client_mapper.instance_eval(&block) if block_given?
          client_mapper
        end

        protected

        def map_art_id(from_art:, to_art:, to_client: nil)
          @id_map[from_art] = ArtIdAlternateMapper.new(@base, to_art, to_client)
        end

      end

      # A mapper that refers a single standard art id to a specific Material Design art id
      # @api private
      class ArtIdAlternateMapper < ArtMapper
        def initialize(base, art_id, client_id=nil)
          @base = base
          @art_id = art_id
          @client_id = client_id
        end

        def get_art(client_id, _art_id)
          Wx::MDAP.__send__(:get_art, @client_id || client_id, @art_id)
        end
      end

      # A mapper that redirects mapping for a Material Design client to the mapper for another
      # Material Design client (with the option of overriding partially)
      # @api private
      class ArtClientRedirectMapper < ArtClientIdMapMapper
        def initialize(base, tgt_client_id)
          super(base)
          @tgt_client_id = tgt_client_id
        end

        def get_art(client_id, art_id)
          super ||
            @base.get_mapper(@tgt_client_id).get_art(client_id, art_id) ||
            @base.get_mapper(@tgt_client_id).get_art(@tgt_client_id, art_id)
        end

        def self.create(base, tgt_client, &block)
          client_redirector = ArtClientRedirectMapper.new(base, tgt_client)
          client_redirector.instance_eval(&block) if block_given?
          client_redirector
        end

      end

      # Returns the standard wxRuby3 Art mappings
      def std_mapper
        @std_mapper ||= StdArtMapper.create do
          map_art for_client: Wx::MDAP::ART_FLUENT_UI_FILLED do
            map_art_id from_art: Wx::ART_ERROR,  to_art: Wx::MDAP::ART_ERROR_CIRCLE
            map_art_id from_art: Wx::ART_QUESTION, to_art: Wx::MDAP::ART_QUESTION
            map_art_id from_art: Wx::ART_WARNING, to_art: Wx::MDAP::ART_WARNING
            map_art_id from_art: Wx::ART_INFORMATION, to_art: Wx::MDAP::ART_INFO
            map_art_id from_art: Wx::ART_ADD_BOOKMARK, to_art: Wx::MDAP::ART_BOOKMARK_ADD
            map_art_id from_art: Wx::ART_DEL_BOOKMARK, to_art: Wx::MDAP::ART_BOOKMARK_OFF
            map_art_id from_art: Wx::ART_HELP_SIDE_PANEL, to_art: Wx::MDAP::ART_PANEL_LEFT_TEXT
            map_art_id from_art: Wx::ART_HELP_SETTINGS, to_art: Wx::MDAP::ART_SETTINGS
            map_art_id from_art: Wx::ART_HELP_BOOK, to_art: Wx::MDAP::ART_BOOK
            map_art_id from_art: Wx::ART_HELP_FOLDER, to_art: Wx::MDAP::ART_BOOK_OPEN
            map_art_id from_art: Wx::ART_HELP_PAGE, to_art: Wx::MDAP::ART_DOCUMENT
            map_art_id from_art: Wx::ART_GO_BACK, to_art: Wx::MDAP::ART_ARROW_LEFT
            map_art_id from_art: Wx::ART_GO_FORWARD, to_art: Wx::MDAP::ART_ARROW_RIGHT
            map_art_id from_art: Wx::ART_GO_UP, to_art: Wx::MDAP::ART_ARROW_UP
            map_art_id from_art: Wx::ART_GO_DOWN, to_art: Wx::MDAP::ART_ARROW_DOWN
            map_art_id from_art: Wx::ART_GO_TO_PARENT, to_art: Wx::MDAP::ART_ARROW_TURN_UP_LEFT
            map_art_id from_art: Wx::ART_GO_HOME, to_art: Wx::MDAP::ART_HOME
            map_art_id from_art: Wx::ART_GOTO_FIRST, to_art: Wx::MDAP::ART_ARROW_PREVIOUS
            map_art_id from_art: Wx::ART_GOTO_LAST, to_art: Wx::MDAP::ART_ARROW_NEXT
            map_art_id from_art: Wx::ART_PRINT, to_art: Wx::MDAP::ART_PRINT
            map_art_id from_art: Wx::ART_HELP, to_art: Wx::MDAP::ART_QUESTION_CIRCLE
            map_art_id from_art: Wx::ART_TIP, to_art: Wx::MDAP::ART_LIGHTBULB
            map_art_id from_art: Wx::ART_REPORT_VIEW, to_art: Wx::MDAP::ART_CONTENT_VIEW
            map_art_id from_art: Wx::ART_LIST_VIEW, to_art: Wx::MDAP::ART_TEXT_BULLET_LIST_SQUARE
            map_art_id from_art: Wx::ART_NEW_DIR, to_art: Wx::MDAP::ART_FOLDER_ADD
            map_art_id from_art: Wx::ART_FOLDER, to_art: Wx::MDAP::ART_FOLDER
            map_art_id from_art: Wx::ART_FOLDER_OPEN, to_art: Wx::MDAP::ART_FOLDER_OPEN
            map_art_id from_art: Wx::ART_GO_DIR_UP, to_art: Wx::MDAP::ART_FOLDER_ARROW_UP
            map_art_id from_art: Wx::ART_EXECUTABLE_FILE, to_art: Wx::MDAP::ART_SETTINGS_COG_MULTIPLE
            map_art_id from_art: Wx::ART_NORMAL_FILE, to_art: Wx::MDAP::ART_DOCUMENT
            map_art_id from_art: Wx::ART_TICK_MARK, to_art: Wx::MDAP::ART_CHECKMARK
            map_art_id from_art: Wx::ART_CROSS_MARK, to_art: Wx::MDAP::ART_DISMISS
            map_art_id from_art: Wx::ART_MISSING_IMAGE, to_art: Wx::MDAP::ART_IMAGE_OFF
            map_art_id from_art: Wx::ART_NEW, to_art: Wx::MDAP::ART_DOCUMENT_ADD
            map_art_id from_art: Wx::ART_FILE_OPEN, to_art: Wx::MDAP::ART_DOCUMENT_FOLDER
            map_art_id from_art: Wx::ART_FILE_SAVE, to_art: Wx::MDAP::ART_SAVE
            map_art_id from_art: Wx::ART_FILE_SAVE_AS, to_art: Wx::MDAP::ART_SAVE_EDIT
            map_art_id from_art: Wx::ART_DELETE, to_art: Wx::MDAP::ART_DELETE
            map_art_id from_art: Wx::ART_COPY, to_art: Wx::MDAP::ART_COPY
            map_art_id from_art: Wx::ART_CUT, to_art: Wx::MDAP::ART_CUT
            map_art_id from_art: Wx::ART_PASTE, to_art: Wx::MDAP::ART_CLIPBOARD_PASTE
            map_art_id from_art: Wx::ART_UNDO, to_art: Wx::MDAP::ART_ARROW_UNDO
            map_art_id from_art: Wx::ART_REDO, to_art: Wx::MDAP::ART_ARROW_UNDO_TEMP_RTL
            map_art_id from_art: Wx::ART_PLUS, to_art: Wx::MDAP::ART_ADD
            map_art_id from_art: Wx::ART_MINUS, to_art: Wx::MDAP::ART_SUBTRACT
            map_art_id from_art: Wx::ART_CLOSE, to_art: Wx::MDAP::ART_DISMISS_CIRCLE
            map_art_id from_art: Wx::ART_QUIT, to_art: Wx::MDAP::ART_ARROW_EXIT
            map_art_id from_art: Wx::ART_FIND, to_art: Wx::MDAP::ART_SEARCH
            map_art_id from_art: Wx::ART_FIND_AND_REPLACE, to_art: Wx::MDAP::ART_FIND_REPLACE, to_client: Wx::MDAP::ART_MATERIAL_DESIGN_FILLED
            map_art_id from_art: Wx::ART_FULL_SCREEN, to_art: Wx::MDAP::ART_FULL_SCREEN_MAXIMIZE
            map_art_id from_art: Wx::ART_EDIT, to_art: Wx::MDAP::ART_EDIT
            map_art_id from_art: Wx::ART_HARDDISK, to_art: Wx::MDAP::ART_HARD_DRIVE
            map_art_id from_art: Wx::ART_FLOPPY, to_art: Wx::MDAP::ART_SAVE
            map_art_id from_art: Wx::ART_CDROM, to_art: Wx::MDAP::ART_CD
            map_art_id from_art: Wx::ART_REMOVABLE, to_art: Wx::MDAP::ART_PLUG_DISCONNECTED
            map_art_id from_art: Wx::ART_STOP, to_art: Wx::MDAP::ART_STOP
            map_art_id from_art: Wx::ART_REFRESH, to_art: Wx::MDAP::ART_ARROW_SYNC
          end

          redirect_art for_client: Wx::MDAP::ART_FLUENT_UI_REGULAR, to_client: Wx::MDAP::ART_FLUENT_UI_FILLED

          map_art for_client: Wx::MDAP::ART_MATERIAL_DESIGN_FILLED do
            map_art_id from_art: Wx::ART_ERROR, to_art: Wx::MDAP::ART_ERROR
            map_art_id from_art: Wx::ART_QUESTION, to_art: Wx::MDAP::ART_QUESTION_MARK
            map_art_id from_art: Wx::ART_WARNING, to_art: Wx::MDAP::ART_WARNING
            map_art_id from_art: Wx::ART_INFORMATION, to_art: Wx::MDAP::ART_INFO
            map_art_id from_art: Wx::ART_ADD_BOOKMARK, to_art: Wx::MDAP::ART_BOOKMARK_ADD
            map_art_id from_art: Wx::ART_DEL_BOOKMARK, to_art: Wx::MDAP::ART_BOOKMARK_REMOVE
            map_art_id from_art: Wx::ART_HELP_SIDE_PANEL, to_art: Wx::MDAP::ART_VERTICAL_SPLIT
            map_art_id from_art: Wx::ART_HELP_SETTINGS, to_art: Wx::MDAP::ART_SETTINGS
            map_art_id from_art: Wx::ART_HELP_BOOK, to_art: Wx::MDAP::ART_BOOK
            map_art_id from_art: Wx::ART_HELP_FOLDER, to_art: Wx::MDAP::ART_FOLDER
            map_art_id from_art: Wx::ART_HELP_PAGE, to_art: Wx::MDAP::ART_TEXT_SNIPPET
            map_art_id from_art: Wx::ART_GO_BACK, to_art: Wx::MDAP::ART_KEYBOARD_ARROW_LEFT
            map_art_id from_art: Wx::ART_GO_FORWARD, to_art: Wx::MDAP::ART_KEYBOARD_ARROW_RIGHT
            map_art_id from_art: Wx::ART_GO_UP, to_art: Wx::MDAP::ART_KEYBOARD_ARROW_UP
            map_art_id from_art: Wx::ART_GO_DOWN, to_art: Wx::MDAP::ART_KEYBOARD_ARROW_DOWN
            map_art_id from_art: Wx::ART_GO_TO_PARENT, to_art: Wx::MDAP::ART_REPLAY
            map_art_id from_art: Wx::ART_GO_HOME, to_art: Wx::MDAP::ART_HOME
            map_art_id from_art: Wx::ART_GOTO_FIRST, to_art: Wx::MDAP::ART_FIRST_PAGE
            map_art_id from_art: Wx::ART_GOTO_LAST, to_art: Wx::MDAP::ART_LAST_PAGE
            map_art_id from_art: Wx::ART_PRINT, to_art: Wx::MDAP::ART_PRINT
            map_art_id from_art: Wx::ART_HELP, to_art: Wx::MDAP::ART_HELP
            map_art_id from_art: Wx::ART_TIP, to_art: Wx::MDAP::ART_LIGHTBULB
            map_art_id from_art: Wx::ART_REPORT_VIEW, to_art: Wx::MDAP::ART_WYSIWYG
            map_art_id from_art: Wx::ART_LIST_VIEW, to_art: Wx::MDAP::ART_VIEW_LIST
            map_art_id from_art: Wx::ART_NEW_DIR, to_art: Wx::MDAP::ART_CREATE_NEW_FOLDER
            map_art_id from_art: Wx::ART_FOLDER, to_art: Wx::MDAP::ART_FOLDER
            map_art_id from_art: Wx::ART_FOLDER_OPEN, to_art: Wx::MDAP::ART_FOLDER_OPEN
            map_art_id from_art: Wx::ART_GO_DIR_UP, to_art: Wx::MDAP::ART_DRIVE_FOLDER_UPLOAD
            map_art_id from_art: Wx::ART_EXECUTABLE_FILE, to_art: Wx::MDAP::ART_MISCELLANEOUS_SERVICES
            map_art_id from_art: Wx::ART_NORMAL_FILE, to_art: Wx::MDAP::ART_INSERT_DRIVE_FILE
            map_art_id from_art: Wx::ART_TICK_MARK, to_art: Wx::MDAP::ART_CHECK
            map_art_id from_art: Wx::ART_CROSS_MARK, to_art: Wx::MDAP::ART_CLEAR
            map_art_id from_art: Wx::ART_MISSING_IMAGE, to_art: Wx::MDAP::ART_IMAGE_NOT_SUPPORTED
            map_art_id from_art: Wx::ART_NEW, to_art: Wx::MDAP::ART_NOTE_ADD
            map_art_id from_art: Wx::ART_FILE_OPEN, to_art: Wx::MDAP::ART_FILE_OPEN
            map_art_id from_art: Wx::ART_FILE_SAVE, to_art: Wx::MDAP::ART_SAVE
            map_art_id from_art: Wx::ART_FILE_SAVE_AS, to_art: Wx::MDAP::ART_SAVE_AS
            map_art_id from_art: Wx::ART_DELETE, to_art: Wx::MDAP::ART_DELETE
            map_art_id from_art: Wx::ART_COPY, to_art: Wx::MDAP::ART_CONTENT_COPY
            map_art_id from_art: Wx::ART_CUT, to_art: Wx::MDAP::ART_CONTENT_CUT
            map_art_id from_art: Wx::ART_PASTE, to_art: Wx::MDAP::ART_CONTENT_PASTE
            map_art_id from_art: Wx::ART_UNDO, to_art: Wx::MDAP::ART_UNDO
            map_art_id from_art: Wx::ART_REDO, to_art: Wx::MDAP::ART_REDO
            map_art_id from_art: Wx::ART_PLUS, to_art: Wx::MDAP::ART_ADD
            map_art_id from_art: Wx::ART_MINUS, to_art: Wx::MDAP::ART_REMOVE
            map_art_id from_art: Wx::ART_CLOSE, to_art: Wx::MDAP::ART_CANCEL
            map_art_id from_art: Wx::ART_QUIT, to_art: Wx::MDAP::ART_EXIT_TO_APP
            map_art_id from_art: Wx::ART_FIND, to_art: Wx::MDAP::ART_SEARCH
            map_art_id from_art: Wx::ART_FIND_AND_REPLACE, to_art: Wx::MDAP::ART_FIND_REPLACE
            map_art_id from_art: Wx::ART_FULL_SCREEN, to_art: Wx::MDAP::ART_FULLSCREEN
            map_art_id from_art: Wx::ART_EDIT, to_art: Wx::MDAP::ART_EDIT
            map_art_id from_art: Wx::ART_HARDDISK, to_art: Wx::MDAP::ART_HARD_DRIVE, to_client: Wx::MDAP::ART_FLUENT_UI_FILLED
            map_art_id from_art: Wx::ART_FLOPPY, to_art: Wx::MDAP::ART_SAVE
            map_art_id from_art: Wx::ART_CDROM, to_art: Wx::MDAP::ART_CD, to_client: Wx::MDAP::ART_FLUENT_UI_FILLED
            map_art_id from_art: Wx::ART_REMOVABLE, to_art: Wx::MDAP::ART_PLUG_DISCONNECTED, to_client: Wx::MDAP::ART_FLUENT_UI_FILLED
            map_art_id from_art: Wx::ART_STOP, to_art: Wx::MDAP::ART_STOP
            map_art_id from_art: Wx::ART_REFRESH, to_art: Wx::MDAP::ART_SYNC
          end

          redirect_art for_client: Wx::MDAP::ART_MATERIAL_DESIGN_OUTLINED, to_client: Wx::MDAP::ART_MATERIAL_DESIGN_FILLED do
            map_art_id from_art: Wx::ART_HARDDISK, to_art: Wx::MDAP::ART_HARD_DRIVE, to_client: Wx::MDAP::ART_FLUENT_UI_REGULAR
            map_art_id from_art: Wx::ART_REMOVABLE, to_art: Wx::MDAP::ART_PLUG_DISCONNECTED, to_client: Wx::MDAP::ART_FLUENT_UI_REGULAR
          end

          redirect_art for_client: Wx::MDAP::ART_MATERIAL_DESIGN_ROUND, to_client: Wx::MDAP::ART_MATERIAL_DESIGN_FILLED

          redirect_art for_client: Wx::MDAP::ART_MATERIAL_DESIGN_SHARP, to_client: Wx::MDAP::ART_MATERIAL_DESIGN_FILLED

          redirect_art for_client: Wx::MDAP::ART_MATERIAL_DESIGN_TWO_TONE, to_client: Wx::MDAP::ART_MATERIAL_DESIGN_FILLED do
            map_art_id from_art: Wx::ART_HARDDISK, to_art: Wx::MDAP::ART_HARD_DRIVE, to_client: Wx::MDAP::ART_FLUENT_UI_REGULAR
            map_art_id from_art: Wx::ART_REMOVABLE, to_art: Wx::MDAP::ART_PLUG_DISCONNECTED, to_client: Wx::MDAP::ART_FLUENT_UI_REGULAR
          end

          map_art for_client: Wx::MDAP::ART_FONT_AWESOME_SOLID do
            map_art_id from_art: Wx::ART_ERROR, to_art: Wx::MDAP::ART_CIRCLE_EXCLAMATION
            map_art_id from_art: Wx::ART_QUESTION, to_art: Wx::MDAP::ART_QUESTION
            map_art_id from_art: Wx::ART_WARNING, to_art: Wx::MDAP::ART_TRIANGLE_EXCLAMATION
            map_art_id from_art: Wx::ART_INFORMATION, to_art: Wx::MDAP::ART_CIRCLE_INFO
            map_art_id from_art: Wx::ART_ADD_BOOKMARK, to_art: Wx::MDAP::ART_BOOKMARK_ADD, to_client: Wx::MDAP::ART_FLUENT_UI_FILLED
            map_art_id from_art: Wx::ART_DEL_BOOKMARK, to_art: Wx::MDAP::ART_BOOKMARK_OFF, to_client: Wx::MDAP::ART_FLUENT_UI_FILLED
            map_art_id from_art: Wx::ART_HELP_SIDE_PANEL, to_art: Wx::MDAP::ART_PANEL_LEFT_TEXT, to_client: Wx::MDAP::ART_FLUENT_UI_FILLED
            map_art_id from_art: Wx::ART_HELP_SETTINGS, to_art: Wx::MDAP::ART_SETTINGS, to_client: Wx::MDAP::ART_FLUENT_UI_FILLED
            map_art_id from_art: Wx::ART_HELP_BOOK, to_art: Wx::MDAP::ART_BOOK
            map_art_id from_art: Wx::ART_HELP_FOLDER, to_art: Wx::MDAP::ART_FOLDER
            map_art_id from_art: Wx::ART_HELP_PAGE, to_art: Wx::MDAP::ART_FILE_LINES
            map_art_id from_art: Wx::ART_GO_BACK, to_art: Wx::MDAP::ART_ANGLE_LEFT
            map_art_id from_art: Wx::ART_GO_FORWARD, to_art: Wx::MDAP::ART_ANGLE_RIGHT
            map_art_id from_art: Wx::ART_GO_UP, to_art: Wx::MDAP::ART_ANGLE_UP
            map_art_id from_art: Wx::ART_GO_DOWN, to_art: Wx::MDAP::ART_ANGLE_DOWN
            map_art_id from_art: Wx::ART_GO_TO_PARENT, to_art: Wx::MDAP::ART_ARROW_TURN_UP
            map_art_id from_art: Wx::ART_GO_HOME, to_art: Wx::MDAP::ART_HOUSE
            map_art_id from_art: Wx::ART_GOTO_FIRST, to_art: Wx::MDAP::ART_ANGLES_LEFT
            map_art_id from_art: Wx::ART_GOTO_LAST, to_art: Wx::MDAP::ART_ANGLES_RIGHT
            map_art_id from_art: Wx::ART_PRINT, to_art: Wx::MDAP::ART_PRINT
            map_art_id from_art: Wx::ART_HELP, to_art: Wx::MDAP::ART_CIRCLE_QUESTION
            map_art_id from_art: Wx::ART_TIP, to_art: Wx::MDAP::ART_LIGHTBULB
            map_art_id from_art: Wx::ART_REPORT_VIEW, to_art: Wx::MDAP::ART_TABLE_COLUMNS
            map_art_id from_art: Wx::ART_LIST_VIEW, to_art: Wx::MDAP::ART_TABLE_LIST
            map_art_id from_art: Wx::ART_NEW_DIR, to_art: Wx::MDAP::ART_FOLDER_PLUS
            map_art_id from_art: Wx::ART_FOLDER, to_art: Wx::MDAP::ART_FOLDER
            map_art_id from_art: Wx::ART_FOLDER_OPEN, to_art: Wx::MDAP::ART_FOLDER_OPEN
            map_art_id from_art: Wx::ART_GO_DIR_UP, to_art: Wx::MDAP::ART_ARROW_TURN_UP
            map_art_id from_art: Wx::ART_EXECUTABLE_FILE, to_art: Wx::MDAP::ART_GEARS
            map_art_id from_art: Wx::ART_NORMAL_FILE, to_art: Wx::MDAP::ART_FILE
            map_art_id from_art: Wx::ART_TICK_MARK, to_art: Wx::MDAP::ART_CHECK
            map_art_id from_art: Wx::ART_CROSS_MARK, to_art: Wx::MDAP::ART_XMARK
            map_art_id from_art: Wx::ART_MISSING_IMAGE, to_art: Wx::MDAP::ART_RECTANGLE_XMARK
            map_art_id from_art: Wx::ART_NEW, to_art: Wx::MDAP::ART_FILE_CIRCLE_PLUS
            map_art_id from_art: Wx::ART_FILE_OPEN, to_art: Wx::MDAP::ART_FILE_ARROW_UP
            map_art_id from_art: Wx::ART_FILE_SAVE, to_art: Wx::MDAP::ART_FILE_ARROW_DOWN
            map_art_id from_art: Wx::ART_FILE_SAVE_AS, to_art: Wx::MDAP::ART_FILE_PEN
            map_art_id from_art: Wx::ART_DELETE, to_art: Wx::MDAP::ART_TRASH_CAN
            map_art_id from_art: Wx::ART_COPY, to_art: Wx::MDAP::ART_COPY
            map_art_id from_art: Wx::ART_CUT, to_art: Wx::MDAP::ART_SCISSORS
            map_art_id from_art: Wx::ART_PASTE, to_art: Wx::MDAP::ART_PASTE
            map_art_id from_art: Wx::ART_UNDO, to_art: Wx::MDAP::ART_ARROW_ROTATE_LEFT
            map_art_id from_art: Wx::ART_REDO, to_art: Wx::MDAP::ART_ARROW_ROTATE_RIGHT
            map_art_id from_art: Wx::ART_PLUS, to_art: Wx::MDAP::ART_PLUS
            map_art_id from_art: Wx::ART_MINUS, to_art: Wx::MDAP::ART_MINUS
            map_art_id from_art: Wx::ART_CLOSE, to_art: Wx::MDAP::ART_CIRCLE_XMARK
            map_art_id from_art: Wx::ART_QUIT, to_art: Wx::MDAP::ART_ARROW_RIGHT_FROM_BRACKET
            map_art_id from_art: Wx::ART_FIND, to_art: Wx::MDAP::ART_MAGNIFYING_GLASS
            map_art_id from_art: Wx::ART_FIND_AND_REPLACE, to_art: Wx::MDAP::ART_FIND_REPLACE, to_client: Wx::MDAP::ART_MATERIAL_DESIGN_FILLED
            map_art_id from_art: Wx::ART_FULL_SCREEN, to_art: Wx::MDAP::ART_EXPAND
            map_art_id from_art: Wx::ART_EDIT, to_art: Wx::MDAP::ART_PEN
            map_art_id from_art: Wx::ART_HARDDISK, to_art: Wx::MDAP::ART_HARD_DRIVE
            map_art_id from_art: Wx::ART_FLOPPY, to_art: Wx::MDAP::ART_FLOPPY_DISK
            map_art_id from_art: Wx::ART_CDROM, to_art: Wx::MDAP::ART_CD, to_client: Wx::MDAP::ART_FLUENT_UI_FILLED
            map_art_id from_art: Wx::ART_REMOVABLE, to_art: Wx::MDAP::ART_PLUG
            map_art_id from_art: Wx::ART_STOP, to_art: Wx::MDAP::ART_STOP
            map_art_id from_art: Wx::ART_REFRESH, to_art: Wx::MDAP::ART_ARROWS_ROTATE
          end

          redirect_art for_client: Wx::MDAP::ART_FONT_AWESOME_REGULAR, to_client: Wx::MDAP::ART_FONT_AWESOME_SOLID do
            map_art_id from_art: Wx::ART_ADD_BOOKMARK, to_art: Wx::MDAP::ART_BOOKMARK_ADD, to_client: Wx::MDAP::ART_FLUENT_UI_REGULAR
            map_art_id from_art: Wx::ART_DEL_BOOKMARK, to_art: Wx::MDAP::ART_BOOKMARK_REMOVE, to_client: Wx::MDAP::ART_FLUENT_UI_REGULAR
            map_art_id from_art: Wx::ART_HELP_SIDE_PANEL, to_art: Wx::MDAP::ART_PANEL_LEFT_TEXT, to_client: Wx::MDAP::ART_FLUENT_UI_REGULAR
            map_art_id from_art: Wx::ART_HELP_SETTINGS, to_art: Wx::MDAP::ART_SETTINGS, to_client: Wx::MDAP::ART_FLUENT_UI_REGULAR
            map_art_id from_art: Wx::ART_FIND_AND_REPLACE, to_art: Wx::MDAP::ART_FIND_REPLACE, to_client: Wx::MDAP::ART_MATERIAL_DESIGN_OUTLINED
            map_art_id from_art: Wx::ART_CDROM, to_art: Wx::MDAP::ART_CD, to_client: Wx::MDAP::ART_FLUENT_UI_REGULAR
          end
        end
      end

      # Collects art from the given collection and auto-creates art client ids and art ids.
      # Registers all art for later retrieval.
      # @param [String] collection name of art collection (folder)
      # @return [void]
      def collect_art_for(collection)
        # recursively iterate the folders and files of the `collection` directory
        # and auto-create Art Client Ids and Art Ids
        art_folder = File.directory?(collection) ? File.expand_path(collection) : File.join(__dir__, 'art', collection)
        art_group = File.basename(art_folder, '.*').upcase.gsub('-', '_')
        raise ArgumentError, "Cannot find art folder #{collection}." unless File.directory?(art_folder)
        art_client_groups[art_group] ||= []
        Dir[File.join(art_folder, '*')].each do |art_client_path|
          if File.directory?(art_client_path)
            # does this folder contain SVG files?
            img_list = Dir[File.join(art_client_path, '*.svg')]
            unless img_list.empty?

              # create ArtClientId constant for this folder and register art client
              art_const = "ART_#{art_group}_#{File.basename(art_client_path, '.*').upcase.gsub('-', '_')}"
              art_client_id = const_set(art_const, "#{art_const}_C")
              art_registry[art_client_id] = { const: art_const.to_sym, art: {} }
              art_client_groups[art_group] << art_const.to_sym

              # create and register ArtId for each image file
              art_id_registry = art_registry[art_client_id][:art]
              img_list.each do |img_file|
                art_id = "ART_#{File.basename(img_file, '.*').upcase.gsub('-', '_')}"
                const_set(art_id, art_id) unless const_defined?(art_id)
                art_id_registry[art_id] = img_file
              end

            end
          end
        end
        nil
      end

      public

      # @api private
      def get_art_client_group_ids
        art_client_groups.keys
      end
      alias :art_client_group_ids :get_art_client_group_ids

      # @api private
      def get_art_client_ids_for_group(grp_id)
        art_client_groups[grp_id] || []
      end
      alias :art_client_ids_for_group :get_art_client_ids_for_group

      # @api private
      def get_art_group_for_client(client)
        grp, _ = art_client_groups.find { |_, grp_clients| grp_clients.include?(client) }
        grp
      end
      alias :art_group_for_client :get_art_group_for_client

      # @api private
      def get_art_ids_for_group(grp_id)
        get_art_client_ids_for_group(grp_id).inject([]) { |list, sym| list |= get_all_art_ids_for(MDAP.const_get(sym)) }.sort
      end
      alias :art_ids_for_group :get_art_ids_for_group

      # Returns the image path for the art for the specified client and id
      # @param [String] client art client id
      # @param [String] id art id
      # @return [String] art path
      # @api private
      def get_art_for(client, id)
        # try to resolve exact match
        art_path = get_art(client, id)
        # if not found and this is a standard wxWidgets Art Id try the std mappers
        if art_path.nil? && id.start_with?('wx')
          art_path = std_mapper.get_art(client, id)
        end
        art_path
      end
      alias :art_for :get_art_for

      # Returns a list op all art client constant names (as symbols).
      # @return [Array<Symbol>] art client constant names
      # @api private
      def get_all_art_clients
        art_registry.values.collect { |clreg| clreg[:const] }
      end
      alias :all_art_clients :get_all_art_clients

      # Returns a list of all art id constant names (as symbols) for the given art client id
      # @param [String] client Art Client Id
      # @return [Array<Symbol>] art id constant names
      # @api private
      def get_all_art_ids_for(client)
        art_registry.has_key?(client) ? art_registry[client][:art].keys.collect { |art_id| art_id.to_sym } : []
      end
      alias :all_art_ids_for :get_all_art_ids_for

      # @api private
      def has_art_client_id?(client)
        art_registry.has_key?(client)
      end

      # @api private
      def has_art_id?(client, id)
        art_registry.has_key?(client) && art_registry[client][:art].has_key?(id)
      end

      # Returns a list of all Material Design art id constant names (as symbols)
      # @return [Array<Symbol>] art id constant names
      # @api private
      def get_all_art_ids
        art_registry.values.collect { |clreg| clreg[:art].keys.collect { |art_id| art_id.to_sym } }.flatten.uniq
      end
      alias :all_art_ids :get_all_art_ids

    end

    collect_art_for('fluent_ui')
    collect_art_for('font_awesome')
    collect_art_for('material_design')
    collect_art_for('simple_icons')

  end

end