---
- :description: Show current configuration values
  :procname: show_config
  :short_name: '0'

- :arg_name: BOOL
  :default: true
  :description: Display only blocks of type "bash"
  :env_var: MDE_BASH_ONLY
  :opt_name: bash_only
  :procname: val_as_bool

- :default: "%\\([^\\)]+\\)"
  :env_var: MDE_BLOCK_CALLS_SCAN
  :opt_name: block_calls_scan
  :procname: val_as_str

- :arg_name: NAME
  :compreply: false
  :description: Name of block to execute
  :env_var: MDE_BLOCK_NAME
  :long_name: block-name
  :opt_name: block_name
  :procname: val_as_str
  :short_name: b

- :default: "^-.+-$"
  :description: Pattern for blocks to hide from user-selection
  :env_var: MDE_BLOCK_NAME_HIDDEN_MATCH
  :opt_name: block_name_hidden_match
  :procname: val_as_str

- :default: "^\\(.*\\)$"
  :description: Pattern for blocks to hide from user-selection
  :env_var: MDE_BLOCK_NAME_INCLUDE_MATCH
  :opt_name: block_name_include_match
  :procname: val_as_str

- :default: ":(?<title>\\S+)( |$)"
  :env_var: MDE_BLOCK_NAME_MATCH
  :opt_name: block_name_match
  :procname: val_as_str

- :default: "^\\[.*\\]$"
  :description: Pattern for block nicknames (name is not used in menu)
  :env_var: MDE_BLOCK_NAME_NICK_MATCH
  :opt_name: block_name_nick_match
  :procname: val_as_str

- :default: "^{.+}$"
  :description: Pattern for block names to use as wrappers
  :env_var: MDE_BLOCK_NAME_WRAPPER_MATCH
  :opt_name: block_name_wrapper_match
  :procname: val_as_str

- :default: "\\+\\S+"
  :env_var: MDE_BLOCK_REQUIRED_SCAN
  :opt_name: block_required_scan
  :procname: val_as_str

- :default: "<(?<full>(?<type>\\$)?(?<name>[A-Za-z_\\-\\.\\w]+))"
  :env_var: MDE_BLOCK_STDIN_SCAN
  :opt_name: block_stdin_scan
  :procname: val_as_str

- :default: ">(?<full>(?<type>\\$)?(?<name>[A-Za-z_\\-\\.\\w]+))"
  :description: Match to place block body into a file or a variable
  :env_var: MDE_BLOCK_STDOUT_SCAN
  :opt_name: block_stdout_scan
  :procname: val_as_str

- :default: ": ${%{key}:=%{value}}"
  :env_var: MDE_BLOCK_TYPE_PORT_SET_FORMAT
  :opt_name: block_type_port_set_format
  :procname: val_as_str

- :arg_name: PATH
  :default: "."
  :description: Read configuration file
  :long_name: config
  :procname: path

- :arg_name: BOOL
  :default: true
  :description: debounce_execution
  :env_var: MDE_DEBOUNCE_EXECUTION
  :opt_name: debounce_execution
  :procname: val_as_bool

- :arg_name: BOOL
  :default: false
  :description: Debug output
  :env_var: MDE_DEBUG
  :long_name: debug
  :procname: debug
  :short_name: d

- :arg_name: BOOL
  :default: true
  :description: default_find_select_open
  :env_var: MDE_DEFAULT_FIND_SELECT_OPEN
  :opt_name: default_find_select_open
  :procname: val_as_bool

- :default: "> "
  :env_var: MDE_DISPLAY_LEVEL_XBASE_PREFIX
  :opt_name: display_level_xbase_prefix
  :procname: val_as_str

- :default: "(document_options)"
  :description: Name of Opts block to load with the document
  :env_var: MDE_DOCUMENT_LOAD_OPTS_BLOCK_NAME
  :opt_name: document_load_opts_block_name
  :procname: val_as_str

- :arg_name: GLOB
  :default: "document_configurations/%{document_filename}_*.sh"
  :description: Glob for saved lines for a document
  :env_var: MDE_DOCUMENT_SAVED_LINES_GLOB
  :opt_name: document_saved_lines_glob
  :procname: val_as_str

- :arg_name: BOOL
  :default: true
  :description: Add menu options for saved lines
  :env_var: MDE_MENU_FOR_SAVED_LINES
  :opt_name: menu_for_saved_lines
  :procname: val_as_bool

- :arg_name: BOOL
  :default: true
  :description: Add menu options for history
  :env_var: MDE_menu_for_history
  :opt_name: menu_for_history
  :procname: val_as_bool

- :arg_name: BOOL
  :default: false
  :description: Dump @delegate_object
  :env_var: MDE_DUMP_DELEGATE_OBJECT
  :long_name: dump-delegate-object
  :opt_name: dump_delegate_object
  :procname: val_as_bool

- :arg_name: BOOL
  :default: false
  :description: Dump BlocksInFile (stage 1)
  :env_var: MDE_DUMP_BLOCKS_IN_FILE
  :long_name: dump-blocks-in-file
  :opt_name: dump_blocks_in_file
  :procname: val_as_bool

- :arg_name: BOOL
  :default: false
  :description: Dump inherited block_names
  :env_var: MDE_DUMP_INHERITED_BLOCK_NAMES
  :long_name: dump-inherited-block_names
  :opt_name: dump_inherited_block_names
  :procname: val_as_bool

- :arg_name: BOOL
  :default: false
  :description: Dump inherited dependencies
  :env_var: MDE_DUMP_INHERITED_DEPENDENCIES
  :long_name: dump-inherited-dependencies
  :opt_name: dump_inherited_dependencies
  :procname: val_as_bool

- :arg_name: BOOL
  :default: false
  :description: Dump inherited lines
  :env_var: MDE_DUMP_INHERITED_LINES
  :long_name: dump-inherited-lines
  :opt_name: dump_inherited_lines
  :procname: val_as_bool

- :arg_name: BOOL
  :default: false
  :description: Dump MenuBlocks (stage 2)
  :env_var: MDE_DUMP_MENU_BLOCKS
  :long_name: dump-menu-blocks
  :opt_name: dump_menu_blocks
  :procname: val_as_bool

- :arg_name: BOOL
  :default: false
  :description: Dump selected block
  :env_var: MDE_DUMP_SELECTED_BLOCK
  :long_name: dump-selected-block
  :opt_name: dump_selected_block
  :procname: val_as_bool

- :default: fg_rgbh_ff_00_7f
  :description: Color of exception detail
  :env_var: MDE_EXCEPTION_COLOR_DETAIL
  :opt_name: exception_color_detail
  :procname: val_as_str

- :default: " - %{detail}\n"
  :description: Format for exception detail
  :env_var: MDE_EXCEPTION_FORMAT_DETAIL
  :opt_name: exception_format_detail
  :procname: val_as_str

- :default: fg_rgbh_ff_00_00
  :description: Color of exception name
  :env_var: MDE_EXCEPTION_COLOR_NAME
  :opt_name: exception_color_name
  :procname: val_as_str

- :default: "\n%{name}"
  :description: Format for exception name
  :env_var: MDE_EXCEPTION_FORMAT_NAME
  :opt_name: exception_format_name
  :procname: val_as_str

- :arg_name: REGEX
  :default:
  :description: Exclude blocks with name matching
  :env_var: MDE_EXCLUDE_BY_NAME_REGEX
  :opt_name: exclude_by_name_regex
  :procname: val_as_str

- :arg_name: REGEX
  :default:
  :description: Exclude blocks with shell matching
  :env_var: MDE_EXCLUDE_BY_SHELL_REGEX
  :opt_name: exclude_by_shell_regex
  :procname: val_as_str

- :arg_name: BOOL
  :default: true
  :description: Hide all blocks of type "expect"
  :env_var: MDE_EXCLUDE_EXPECT_BLOCKS
  :opt_name: exclude_expect_blocks
  :procname: val_as_bool

- :default: >
    osascript -e '
      on run argv
          set batch_index to "%{batch_index}"
          set home to "%{home}"
          set output_filespec to "%{output_filespec}"
          set script_filespec to "%{script_filespec}"
          set title to " %{started_at} - %{document_filename} - %{block_name} "

          tell application "iTerm"
              create window with default profile
              tell the first window
                  tell the current session
                      write text "s=" & quoted form of script_filespec & ""
                      write text "o=" & quoted form of output_filespec & ""
                      write text "cd " & quoted form of home & ""
                      write text "echo -ne \"\\033]; " & title & " \\007\""
                      write text "\"$s\" %{rest} 2>&1 | tee -a \"$o\""
                  end tell
              end tell
          end tell
      end run'
  :description: execute_command_format
  :env_var: MDE_EXECUTE_COMMAND_FORMAT
  :opt_name: execute_command_format
  :procname: val_as_str
# execute_command_format using a saved script
# - :default: >
#   osascript scripts/applescript/mde.applescript "%{batch_index}" "%{home}" " %{started_at} - %{document_filename} - %{block_name} " "%{script_filespec}" "%{output_filespec}" %{rest}

- :default: "%T"
  :description: Format for time in window title
  :env_var: MDE_EXECUTE_COMMAND_TITLE_TIME_FORMAT
  :opt_name: execute_command_title_time_format
  :procname: val_as_str

- :arg_name: BOOL
  :default: false
  :description: Execute script in own window
  :env_var: MDE_EXECUTE_IN_OWN_WINDOW
  :long_name: execute_in_own_window
  :opt_name: execute_in_own_window
  :procname: val_as_bool
  :short_name: w

- :default: fg_rgbh_7f_ff_00
  :description: execution_report_preview_frame_color
  :env_var: MDE_EXECUTION_REPORT_PREVIEW_FRAME_COLOR
  :opt_name: execution_report_preview_frame_color
  :procname: val_as_str

- :default: "\n -^-"
  :description: execution_report_preview_head
  :env_var: MDE_EXECUTION_REPORT_PREVIEW_HEAD
  :opt_name: execution_report_preview_head
  :procname: val_as_str

- :default: " -v-"
  :description: execution_report_preview_tail
  :env_var: MDE_EXECUTION_REPORT_PREVIEW_TAIL
  :opt_name: execution_report_preview_tail
  :procname: val_as_str

- :description: Exit app
  :long_name: exit
  :procname: exit
  :short_name: x

## match fenced code indented by spaces
#
- :default: "^(?<indent>[ \t]*)`{3,}"
  :description: Matches the start and end of a fenced code block
  :env_var: MDE_FENCED_START_AND_END_REGEX
  :opt_name: fenced_start_and_end_regex
  :procname: val_as_str

- :default: "^(?<indent>[ \t]*)`{3,}(?<shell>[^`\\s]*) *(:(?<name>[^\\s]*))? *(?<rest>.*) *$"
  :description: Match the start of a fenced block
  :env_var: MDE_FENCED_START_EXTENDED_REGEX
  :opt_name: fenced_start_extended_regex
  :procname: val_as_str

- :arg_name: RELATIVE_PATH
  :compreply: "."
  :description: Name of the document to load
  :env_var: MDE_FILENAME
  :long_name: filename
  :opt_name: filename
  :procname: val_as_str
  :short_name: f

- :arg_name: FIND
  :default: ''
  :description: Find argument in documents
  :long_name: find
  :procname: find
  :short_name: "?"

- :arg_name: FIND_PATH
  :default: ''
  :description: Path for find (uses PATH if empty)
  :env_var: MDE_FIND_PATH
  :long_name: find-path
  :opt_name: find_path
  :procname: val_as_str

- :default: "^#(?<line>(?!#)(?<indent>[ \t]*)(?<text>.*?)(?<trailing>[ \t]*))?$"
  :env_var: MDE_HEADING1_MATCH
  :opt_name: heading1_match
  :procname: val_as_str

- :default: "^##(?<line>(?!#)(?<indent>[ \t]*)(?<text>.*?)(?<trailing>[ \t]*))?$"
  :env_var: MDE_HEADING2_MATCH
  :opt_name: heading2_match
  :procname: val_as_str

- :default: "^###(?<line>(?<indent>[ \t]*)(?<text>.*?)(?<trailing>[ \t]*))?$"
  :env_var: MDE_HEADING3_MATCH
  :opt_name: heading3_match
  :procname: val_as_str

- :description: App help
  :long_name: help
  :procname: help
  :short_name: h

- :arg_name: BOOL
  :default: true
  :description: |-
    Exclude blocks with name matching expression " \
         "`block_name_hidden_match`
  :env_var: MDE_HIDE_BLOCKS_BY_NAME
  :opt_name: hide_blocks_by_name
  :procname: val_as_bool

- :default: "|"
  :env_var: MDE_HISTORY_DOCUMENT_SEPARATOR
  :opt_name: history_document_separator
  :procname: val_as_str

- :default: "&"
  :env_var: MDE_HISTORY_PROPERTY_SEPARATOR
  :opt_name: history_property_separator
  :procname: val_as_str

- :arg_name: HOW
  :default: ''
  :description: Find keyword in YAML configuration options
  :long_name: how
  :procname: how
  :short_name: "?"

- :default:
  :env_var: MDE_IMPORT_PATHS
  :opt_name: import_paths
  :procname: val_as_str

- :default: "^ *@import +(?<name>.+?) *$"
  :env_var: MDE_IMPORT_PATTERN
  :opt_name: import_pattern
  :procname: val_as_str

- :default:
    - :color_method: :bold_underline
      :pattern: '\*\*_([^_]{0,64})_\*\*'

    - :color_method: :bold_italic
      :pattern: '\*\*~([^~]{0,64})~\*\*'

    - :color_method: :bold
      :pattern: '\*\*([^*]{0,64})\*\*'
    - :color_method: :bold
      :pattern: '__([^_]{0,64})__'

    - :color_method: :underline
      :pattern: '\*([^*]{0,64})\*'

    - :color_method: :underline_italic
      :pattern: '_~([^_]{0,64})~_'

    - :color_method: strikethrough
      :pattern: '~~([^~]{0,64})~~'
  :description: Line-oriented text decoration (Main)
  :env_var: MDE_LINE_DECOR_MAIN
  :opt_name: line_decor_main
  :procname: val_as_str

- :default: []
  :description: Line-oriented text decoration (Post)
  :env_var: MDE_LINE_DECOR_POST
  :opt_name: line_decor_post
  :procname: val_as_str

- :default: []
  :description: Line-oriented text decoration (Pre)
  :env_var: MDE_LINE_DECOR_PRE
  :opt_name: line_decor_pre
  :procname: val_as_str

- :description: List blocks
  :long_name: list-blocks
  :opt_name: list_blocks
  :procname: val_as_bool

- :arg_name: INT.1-
  :default: 32
  :description: Max. items to return in list
  :env_var: MDE_LIST_COUNT
  :long_name: list-count
  :opt_name: list_count
  :procname: val_as_int

- :description: List default configuration as environment variables
  :long_name: list-default-env
  :opt_name: list_default_env

- :description: List default configuration as YAML
  :long_name: list-default-yaml
  :opt_name: list_default_yaml

- :description: List docs in current folder
  :long_name: list-docs
  :opt_name: list_docs
  :procname: val_as_bool

- :description: List recent saved output
  :long_name: list-recent-output
  :opt_name: list_recent_output
  :procname: val_as_bool

- :description: List recent saved scripts
  :long_name: list-recent-scripts
  :opt_name: list_recent_scripts
  :procname: val_as_bool

- :arg_name: PATH
  :default: ''
  :description: Load code
  :env_var: MDE_LOAD_CODE
  :long_name: load-code
  :opt_name: load_code
  :procname: val_as_str
  :short_name: l

- :arg_name: PREFIX
  :default: mde
  :description: Name prefix for stdout files
  :env_var: MDE_LOGGED_STDOUT_FILENAME_PREFIX
  :opt_name: logged_stdout_filename_prefix
  :procname: val_as_str

- :default: "*.[Mm][Dd]"
  :env_var: MDE_MD_FILENAME_GLOB
  :opt_name: md_filename_glob
  :procname: val_as_str

- :default: ".+\\.md"
  :env_var: MDE_MD_FILENAME_MATCH
  :opt_name: md_filename_match
  :procname: val_as_str

- :arg_name: BOOL
  :default: true
  :description: Display Back option at top of menu (vs bottom)
  :env_var: MDE_MENU_BACK_AT_TOP
  :opt_name: menu_back_at_top
  :procname: val_as_bool

- :default: fg_rgbh_00_c0_c0
  :description: Color of menu bash
  :env_var: MDE_MENU_BASH_COLOR
  :opt_name: menu_bash_color
  :procname: val_as_str

- :arg_name: BOOL
  :default: false
  :description: Display document name in block selection menu
  :env_var: MDE_MENU_BLOCKS_WITH_DOCNAME
  :opt_name: menu_blocks_with_docname
  :procname: val_as_bool

- :arg_name: BOOL
  :default: true
  :description: Controls whether headings(levels 1,2,3) are displayed in the block selection menu
  :env_var: MDE_MENU_BLOCKS_WITH_HEADINGS
  :opt_name: menu_blocks_with_headings
  :procname: val_as_bool

- :default: fg_rgbh_40_c0_c0
  :description: Color of menu chrome
  :env_var: MDE_MENU_CHROME_COLOR
  :opt_name: menu_chrome_color
  :procname: val_as_str

- :default: "%{line}"
  :description: format for menu chromes
  :env_var: MDE_MENU_CHROME_FORMAT
  :opt_name: menu_chrome_format
  :procname: val_as_str

- :default: fg_rgbh_80_d0_c0
  :description: Color of menu divider
  :env_var: MDE_MENU_DIVIDER_COLOR
  :opt_name: menu_divider_color
  :procname: val_as_str

- :default: "-:=   %{line}   =:-"
  :description: format for menu dividers and demarcations
  :env_var: MDE_MENU_DIVIDER_FORMAT
  :opt_name: menu_divider_format
  :procname: val_as_str

- :default: "^(?<indent>[ \t]*):::(?<line>(?<text>.*?)(?<trailing>[ \t]*))?$"
  :description: Pattern for topics/dividers in block selection menu
  :env_var: MDE_MENU_DIVIDER_MATCH
  :opt_name: menu_divider_match
  :procname: val_as_str

- :default: ">"
  :description: Symbol before each divider
  :env_var: MDE_MENU_DIVIDER_SYMBOL
  :opt_name: menu_divider_symbol
  :procname: val_as_str

- :arg_name: BOOL
  :default: true
  :description: Display Exit option at top of menu (vs bottom)
  :env_var: MDE_MENU_EXIT_AT_TOP
  :opt_name: menu_exit_at_top
  :procname: val_as_bool

- :arg_name: BOOL
  :default: false
  :description: Display Load option at top of menu (vs bottom)
  :env_var: MDE_MENU_LOAD_AT_TOP
  :opt_name: menu_load_at_top
  :procname: val_as_bool

- :default:
    :line: "~~~"
  :description: closing demarcations for menu
  :env_var: MDE_MENU_FINAL_DIVIDER
  :opt_name: menu_final_divider
  :procname: val_as_str

- :default: fg_bg_rgbh_80_80_c0_10_10_20
  :description: Color for heading 1 in menu
  :env_var: MDE_MENU_HEADING1_COLOR
  :opt_name: menu_heading1_color
  :procname: val_as_str

# strip heading tag
- :default: "%{line}"
  :description: format for menu heading1 in menu
  :env_var: MDE_MENU_HEADING1_FORMAT
  :opt_name: menu_heading1_format
  :procname: val_as_str

- :default: fg_bg_rgbh_60_60_c0_10_10_20
  :description: Color for heading 2 in menu
  :env_var: MDE_MENU_HEADING2_COLOR
  :opt_name: menu_heading2_color
  :procname: val_as_str

# strip heading tag
- :default: "%{line}"
  :description: format for menu heading2 in menu
  :env_var: MDE_MENU_HEADING2_FORMAT
  :opt_name: menu_heading2_format
  :procname: val_as_str

- :default: fg_bg_rgbh_40_40_c0_10_10_20
  :description: Color for heading 3 in menu
  :env_var: MDE_MENU_HEADING3_COLOR
  :opt_name: menu_heading3_color
  :procname: val_as_str

# strip heading tag
- :default: "%{line}"
  :description: format for menu heading3 in menu
  :env_var: MDE_MENU_HEADING3_FORMAT
  :opt_name: menu_heading3_format
  :procname: val_as_str

- :default: '0'
  :description: Import levels for blocks to appear in menu. Empty is all.
  :env_var: MDE_MENU_IMPORT_LEVEL_MATCH
  :opt_name: menu_import_level_match
  :procname: val_as_str

- :arg_name: BOOL
  :default: true
  :description: Include imported blocks in menu
  :env_var: MDE_MENU_INCLUDE_IMPORTED_BLOCKS
  :opt_name: menu_include_imported_blocks
  :procname: val_as_bool

- :arg_name: BOOL
  :default: false
  # :description: Include imported notes in menu
  :description: Whether imported blocks should be included in the menu
  :env_var: MDE_MENU_INCLUDE_IMPORTED_NOTES
  :opt_name: menu_include_imported_notes
  :procname: val_as_bool

- :arg_name: BOOL
  :default: true
  :description: Display inherited lines at top of menu (vs bottom)
  :env_var: MDE_MENU_INHERITED_LINES_AT_TOP
  :opt_name: menu_inherited_lines_at_top
  :procname: val_as_bool

- :default: fg_rgbh_94_00_D3
  :description: Color of inherited lines in menu
  :env_var: MDE_MENU_INHERITED_LINES_COLOR
  :opt_name: menu_inherited_lines_color
  :procname: val_as_str

- :default: "%{line}"
  :description: format for inherited lines in menu
  :env_var: MDE_MENU_INHERITED_LINES_FORMAT
  :opt_name: menu_inherited_lines_format
  :procname: val_as_str

- :default:
    :line: ''
  :description: opening demarcation for menu
  :env_var: MDE_MENU_INITIAL_DIVIDER
  :opt_name: menu_initial_divider
  :procname: val_as_str

- :default: fg_rgbh_e0_e0_20
  :description: Color of menu link
  :env_var: MDE_MENU_LINK_COLOR
  :opt_name: menu_link_color
  :procname: val_as_str

- :default: "%{line}"
  :description: format for menu link
  :env_var: MDE_MENU_LINK_FORMAT
  :opt_name: menu_link_format
  :procname: val_as_str

- :default: fg_rgbh_c0_c0_c0
  :description: Color of menu note
  :env_var: MDE_MENU_NOTE_COLOR
  :opt_name: menu_note_color
  :procname: val_as_str

- :default: "%{line}"
  :description: format for menu notes
  :env_var: MDE_MENU_NOTE_FORMAT
  :opt_name: menu_note_format
  :procname: val_as_str

## lines that start with "/" are comments (hidden), not notes (visible)
# - :default: "^(?<indent>[ \t]*)(?<line>(?!/)(?<text>.*?)(?<trailing>[ \t]*))?$"
- :default: "^(?<line>(?![ \t]*/)(?<text>.*?)(?<trailing>[ \t]*))?$"
  :description: Pattern for notes in block selection menu
  :env_var: MDE_MENU_NOTE_MATCH
  :opt_name: menu_note_match
  :procname: val_as_str

- :default:
    :line: "* Back"
  :description: Text for Back option
  :env_var: MDE_MENU_OPTION_BACK_NAME
  :opt_name: menu_option_back_name
  :procname: val_as_str

- :default:
    :line: "* Edit"
  :description: Text for Edit option
  :env_var: MDE_MENU_OPTION_EDIT_NAME
  :opt_name: menu_option_edit_name
  :procname: val_as_str

- :default:
    :line: "* Exit"
  :description: Text for Exit option
  :env_var: MDE_MENU_OPTION_EXIT_NAME
  :opt_name: menu_option_exit_name
  :procname: val_as_str

- :default:
    :line: "* History"
  :description: Text for History option
  :env_var: MDE_MENU_OPTION_HISTORY_NAME
  :opt_name: menu_option_history_name
  :procname: val_as_str

- :default:
    :line: "* Load"
  :description: Text for Load option
  :env_var: MDE_MENU_OPTION_LOAD_NAME
  :opt_name: menu_option_load_name
  :procname: val_as_str

- :default:
    :line: "* Save"
  :description: Text for Save option
  :env_var: MDE_MENU_OPTION_SAVE_NAME
  :opt_name: menu_option_save_name
  :procname: val_as_str

- :default:
    :line: "! Shell"
  :description: Text for Shell option
  :env_var: MDE_MENU_OPTION_SHELL_NAME
  :opt_name: menu_option_shell_name
  :procname: val_as_str

- :default:
    :line: "* View"
  :description: Text for View option
  :env_var: MDE_MENU_OPTION_VIEW_NAME
  :opt_name: menu_option_view_name
  :procname: val_as_str

- :default: fg_rgbh_ff_00_ff
  :description: Color of menu opts
  :env_var: MDE_MENU_OPTS_COLOR
  :opt_name: menu_opts_color
  :procname: val_as_str

- :default: fg_rgbh_7f_00_ff
  :description: Color of menu opts
  :env_var: MDE_MENU_OPTS_SET_COLOR
  :opt_name: menu_opts_set_color
  :procname: val_as_str

- :default: "%{key} = %{value}\n"
  :description: format for menu opts output
  :env_var: MDE_MENU_OPTS_SET_FORMAT
  :opt_name: menu_opts_set_format
  :procname: val_as_str

- :default: "."
  :description: Block name to display menu
  :env_var: MDE_MENU_PERSIST_BLOCK_NAME
  :opt_name: menu_persist_block_name
  :procname: val_as_str

- :arg_name: BOOL
  :default: true
  :description: Resize terminal when displaying menu.
  :env_var: MDE_MENU_RESIZE_TERMINAL
  :opt_name: menu_resize_terminal
  :procname: val_as_bool

- :default: fg_rgbh_ff_ff_ff
  :description: Color of menu task
  :env_var: MDE_MENU_TASK_COLOR
  :opt_name: menu_task_color
  :procname: val_as_str

- :default: "%{name} [%{status}]"
  :description: format for menu tasks and demarcations
  :env_var: MDE_MENU_TASK_FORMAT
  :opt_name: menu_task_format
  :procname: val_as_str

- :default: "^ *\\[(?<status>.{1,4})\\] *(?<name>.*) *$"
  :description: Pattern for tasks
  :env_var: MDE_MENU_TASK_MATCH
  :opt_name: menu_task_match
  :procname: val_as_str

- :default: ">"
  :description: Symbol before each task
  :env_var: MDE_MENU_TASK_SYMBOL
  :opt_name: menu_task_symbol
  :procname: val_as_str

- :default: fg_rgbh_ff_a0_ff
  :description: Color of menu vars
  :env_var: MDE_MENU_VARS_COLOR
  :opt_name: menu_vars_color
  :procname: val_as_str

- :default: fg_rgbh_00_ff_ff
  :description: Color of menu vars
  :env_var: MDE_MENU_VARS_SET_COLOR
  :opt_name: menu_vars_set_color
  :procname: val_as_str

- :default: "%{key} = %{value}\n"
  :description: format for menu vars output
  :env_var: MDE_MENU_VARS_SET_FORMAT
  :opt_name: menu_vars_set_format
  :procname: val_as_str

- :arg_name: BOOL
  :default: true
  :description: Display Back option in menu
  :env_var: MDE_MENU_WITH_BACK
  :opt_name: menu_with_back
  :procname: val_as_bool

- :arg_name: BOOL
  :default: true
  :description: Display Exit option in menu
  :env_var: MDE_MENU_WITH_EXIT
  :opt_name: menu_with_exit
  :procname: val_as_bool

- :arg_name: BOOL
  :default: false
  :description: Display inherited lines in menu
  :env_var: MDE_MENU_WITH_INHERITED_LINES
  :opt_name: menu_with_inherited_lines
  :procname: val_as_bool

- :arg_name: BOOL
  :default: true
  :description: Display Shell option in menu
  :env_var: MDE_MENU_WITH_SHELL
  :opt_name: menu_with_shell
  :procname: val_as_bool

- :arg_name: BOOL
  :default: false
  :description: Hide decorative menu entries
  :env_var: MDE_NO_CHROME
  :opt_name: no_chrome
  :procname: val_as_bool

- :arg_name: OPEN
  :default: ''
  :description: Find argument in documents, present list, and open user selection
  :long_name: open
  :procname: open
  :short_name: o

- :default:
  :description: Expression to match to start collecting lines
  :env_var: MDE_OUTPUT_ASSIGNMENT_BEGIN
  :opt_name: output_assignment_begin
  :procname: val_as_str

- :default:
  :description: Expression to match to stop collecting lines
  :env_var: MDE_OUTPUT_ASSIGNMENT_END
  :opt_name: output_assignment_end
  :procname: val_as_str

- :default: "%{line}"
  :description: Format for assignments from output
  :env_var: MDE_OUTPUT_ASSIGNMENT_FORMAT
  :opt_name: output_assignment_format
  :procname: val_as_str

- :default: "^ *(?<line>\\w+=.*?) *$"
  :description: Pattern for assignments from output
  :env_var: MDE_OUTPUT_ASSIGNMENT_MATCH
  :opt_name: output_assignment_match
  :procname: val_as_str

- :arg_name: BOOL
  :default: false
  :description: Display summary for execution
  :env_var: MDE_OUTPUT_EXECUTION_SUMMARY
  :opt_name: output_execution_summary
  :procname: val_as_bool

- :default: "%{name}: %{value}"
  :description: format for menu dividers and demarcations
  :env_var: MDE_OUTPUT_EXECUTION_LABEL_FORMAT
  :opt_name: output_execution_label_format
  :procname: val_as_str

- :default: fg_rgbh_00_ff_00
  :description: Color of output_execution_label_name
  :env_var: MDE_OUTPUT_EXECUTION_LABEL_NAME_COLOR
  :opt_name: output_execution_label_name_color
  :procname: val_as_str

- :default: fg_rgbh_00_ff_00
  :description: Color of output_execution_label_value
  :env_var: MDE_OUTPUT_EXECUTION_LABEL_VALUE_COLOR
  :opt_name: output_execution_label_value_color
  :procname: val_as_str

- :arg_name: BOOL
  :default: true
  :description: Output execution report at end of execution
  :env_var: MDE_OUTPUT_EXECUTION_REPORT
  :opt_name: output_execution_report
  :procname: val_as_bool

- :arg_name: BOOL
  :default: false
  :description: Output saved script filename at end of execution
  :env_var: MDE_OUTPUT_SAVED_SCRIPT_FILENAME
  :opt_name: output_saved_script_filename
  :procname: val_as_bool

- :arg_name: BOOL
  :default: false
  :description: Display script prior to execution
  :env_var: MDE_OUTPUT_SCRIPT
  :long_name: output-script
  :opt_name: output_script
  :procname: val_as_bool

- :arg_name: BOOL
  :default: true
  :description: Whether standard output from execution is displayed
  :env_var: MDE_OUTPUT_STDOUT
  :long_name: output-stdout
  :opt_name: output_stdout
  :procname: val_as_bool

- :description: Options for viewing saved output file
  :env_var: MDE_OUTPUT_VIEWER_OPTIONS
  :opt_name: output_viewer_options
  :procname: val_as_str

- :arg_name: RELATIVE_PATH
  :default: "."
  :description: Path to documents
  :env_var: MDE_PATH
  :long_name: path
  :opt_name: path
  :procname: val_as_str
  :short_name: p

- :arg_name: BOOL
  :default: false
  :description: Whether to pause after manually executing a block and the next menu
  :env_var: MDE_PAUSE_AFTER_SCRIPT_EXECUTION
  :opt_name: pause_after_script_execution
  :procname: val_as_bool

- :default: "\nContinue?"
  :description: Prompt after manually executing a block and the next menu
  :env_var: MDE_PROMPT_AFTER_SCRIPT_EXECUTION
  :opt_name: prompt_after_script_execution
  :procname: val_as_str

- :default: "\nProcess?"
  :description: Prompt to approve a block
  :env_var: MDE_PROMPT_APPROVE_BLOCK
  :opt_name: prompt_approve_block
  :procname: val_as_str

- :default: fg_rgbh_00_ff_00
  :description: Color of prompt after script execution
  :env_var: MDE_PROMPT_COLOR_AFTER_SCRIPT_EXECUTION
  :opt_name: prompt_color_after_script_execution
  :procname: val_as_str

- :default: "\nRepeat this block?"
  :description: Prompt to debounce
  :env_var: MDE_PROMPT_DEBOUNCE
  :opt_name: prompt_debounce
  :procname: val_as_str

- :default: 'Name? '
  :description: Prompt to enter a filespec
  :env_var: MDE_PROMPT_ENTER_FILESPEC
  :opt_name: prompt_enter_filespec
  :procname: val_as_str

- :default: Exit
  :description: Prompt to exit app
  :env_var: MDE_PROMPT_EXIT
  :opt_name: prompt_exit
  :procname: val_as_str

- :default: Back
  :description: User wants out of menu
  :env_var: MDE_PROMPT_FILESPEC_BACK
  :opt_name: prompt_filespec_back
  :procname: val_as_str

- :default: Facet
  :description: User wants to tailor the menu
  :env_var: MDE_PROMPT_FILESPEC_FACET
  :opt_name: prompt_filespec_facet
  :procname: val_as_str

- :default: Other
  :description: User wants a custom file name
  :env_var: MDE_PROMPT_FILESPEC_OTHER
  :opt_name: prompt_filespec_other
  :procname: val_as_str

- :default: 'No'
  :description: Prompt for no
  :env_var: MDE_PROMPT_NO
  :opt_name: prompt_no
  :procname: val_as_str

- :default: Save script
  :description: Prompt to save script
  :env_var: MDE_PROMPT_SAVE_SCRIPT
  :opt_name: prompt_save_script
  :procname: val_as_str

- :default: Copy script to clipboard
  :description: Prompt to copy script to clipboard
  :env_var: MDE_PROMPT_SCRIPT_TO_CLIPBOARD
  :opt_name: prompt_script_to_clipboard
  :procname: val_as_str

- :default: "\nChoose a block:"
  :description: Prompt to select a block
  :env_var: MDE_PROMPT_SELECT_BLOCK
  :opt_name: prompt_select_block
  :procname: val_as_str

- :default: "\nChoose a file:"
  :description: Prompt to select a file with inherited lines
  :env_var: MDE_PROMPT_SELECT_CODE_FILE
  :opt_name: prompt_select_code_file
  :procname: val_as_str

- :default: "\nView file:"
  :description: Prompt to select a saved asset
  :env_var: MDE_PROMPT_SELECT_HISTORY_FILE
  :opt_name: prompt_select_history_file
  :procname: val_as_str

- :default: "\nChoose a file:"
  :description: Prompt to select a markdown document
  :env_var: MDE_PROMPT_SELECT_MD
  :opt_name: prompt_select_md
  :procname: val_as_str

- :default: "\nChoose a file:"
  :description: Prompt to select a saved file
  :env_var: MDE_PROMPT_SELECT_OUTPUT
  :opt_name: prompt_select_output
  :procname: val_as_str

- :default: 'Expr: %{expr}'
  :description: prompt_show_expr_format
  :env_var: MDE_PROMPT_SHOW_EXPR_FORMAT
  :opt_name: prompt_show_expr_format
  :procname: val_as_str

- :default: Uninterrupted
  :description: Uninterrupted execution
  :env_var: MDE_PROMPT_UNINTERRUPTED
  :opt_name: prompt_uninterrupted
  :procname: val_as_str

- :default: 'Yes'
  :description: Prompt for yes
  :env_var: MDE_PROMPT_YES
  :opt_name: prompt_yes
  :procname: val_as_str

- :description: Print the gem's home directory
  :long_name: pwd
  :opt_name: pwd
  :procname: val_as_bool

- :description: Run most recently saved script
  :long_name: run-last-script
  :opt_name: run_last_script
  :procname: val_as_bool

- :default: 1
  :description: Runtime exception error level (warn if < 0, ignore if 0, abort if > 0)
  :env_var: MDE_RUNTIME_EXCEPTION_ERROR_LEVEL
  :opt_name: runtime_exception_error_level
  :procname: val_as_int

- :default: '%{prefix}%{join}%{time}%{join}%{filename}%{join}%{mark}%{join}%{blockname}%{join}%{exts}'
  :description: Format for script and log file names
  :env_var: MDE_SAVED_ASSET_FORMAT
  :opt_name: saved_asset_format
  :procname: val_as_str

- :default: "^(?<prefix>.+)(?<join>_)(?<time>[0-9\\-]+)\\g'join'(?<filename>.+)\\g'join'(?<mark>~)\\g'join'(?<blockname>.+)\\g'join'(?<exts>\\..+)$"
  :description: Regexp for script and log file names
  :env_var: MDE_SAVED_ASSET_MATCH
  :opt_name: saved_asset_match
  :procname: val_as_str

- :arg_name: BOOL
  :default: false
  :description: Whether to save an executed script
  :env_var: MDE_SAVE_EXECUTED_SCRIPT
  :opt_name: save_executed_script
  :procname: val_as_bool

- :arg_name: BOOL
  :default: false
  :description: Save standard output of the executed script
  :env_var: MDE_SAVE_EXECUTION_OUTPUT
  :opt_name: save_execution_output
  :procname: val_as_bool

- :default: "/"
  :description: Pattern to replace in file names
  :env_var: MDE_SAVED_FILENAME_PATTERN
  :opt_name: saved_filename_pattern
  :procname: val_as_str

- :default: ",~"
  :description: Replacement for pattern in file names
  :env_var: MDE_SAVED_FILENAME_REPLACEMENT
  :opt_name: saved_filename_replacement
  :procname: val_as_str

- :default: '%{time}  %{blockname}  %{exts}'
  :description: Format for each row displayed in history
  :env_var: MDE_SAVED_HISTORY_FORMAT
  :opt_name: saved_history_format
  :procname: val_as_str

- :arg_name: INT
  :default: 493
  :description: chmod for saved scripts
  :env_var: MDE_SAVED_SCRIPT_CHMOD
  :opt_name: saved_script_chmod
  :procname: val_as_int

- :arg_name: PREFIX
  :default: mde
  :description: Name prefix for saved scripts
  :env_var: MDE_SAVED_SCRIPT_FILENAME_PREFIX
  :opt_name: saved_script_filename_prefix
  :procname: val_as_str

- :arg_name: RELATIVE_PATH
  :default: logs
  :description: Folder where saved scripts are stored
  :env_var: MDE_SAVED_SCRIPT_FOLDER
  :opt_name: saved_script_folder
  :procname: val_as_str

- :arg_name: GLOB
  :default: mde_*.sh
  :description: Glob matching saved scripts
  :env_var: MDE_SAVED_SCRIPT_GLOB
  :opt_name: saved_script_glob
  :procname: val_as_str

- :arg_name: RELATIVE_PATH
  :default: logs
  :description: Saved stdout folder
  :env_var: MDE_SAVED_STDOUT_FOLDER
  :opt_name: saved_stdout_folder
  :procname: val_as_str

- :arg_name: GLOB
  :default: mde_*.out.txt
  :description: Glob matching saved outputs
  :env_var: MDE_SAVED_STDOUT_GLOB
  :opt_name: saved_stdout_glob
  :procname: val_as_str

- :default: fg_rgbh_00_ff_7f
  :description: script_execution_frame_color
  :env_var: MDE_SCRIPT_EXECUTION_FRAME_COLOR
  :opt_name: script_execution_frame_color
  :procname: val_as_str

- :default: "\n -^-"
  :description: script_execution_head
  :env_var: MDE_SCRIPT_EXECUTION_HEAD
  :opt_name: script_execution_head
  :procname: val_as_str

- :default: " -v-\n"
  :description: script_execution_tail
  :env_var: MDE_SCRIPT_EXECUTION_TAIL
  :opt_name: script_execution_tail
  :procname: val_as_str

- :default: fg_rgbh_7f_ff_00
  :description: Color of output divider
  :env_var: MDE_OUTPUT_DIVIDER_COLOR
  :opt_name: script_preview_frame_color
  :procname: val_as_str

- :default: "\n -^-"
  :description: script_preview_head
  :env_var: MDE_SCRIPT_PREVIEW_HEAD
  :opt_name: script_preview_head
  :procname: val_as_str

- :default: " -v-\n"
  :description: script_preview_tail
  :env_var: MDE_SCRIPT_PREVIEW_TAIL
  :opt_name: script_preview_tail
  :procname: val_as_str

- :arg_name: REGEX
  :default:
  :description: Select blocks with name matching
  :env_var: MDE_SELECT_BY_NAME_REGEX
  :opt_name: select_by_name_regex
  :procname: val_as_str

- :arg_name: REGEX
  :default:
  :description: Select blocks with shell matching
  :env_var: MDE_SELECT_BY_SHELL_REGEX
  :opt_name: select_by_shell_regex
  :procname: val_as_str

- :default: 0
  :description: 'Maximum # of rows in select list. Detects current limit if not specified.'
  :env_var: MDE_SELECT_PAGE_HEIGHT
  :opt_name: select_page_height
  :procname: val_as_int

- :default: "#!/usr/bin/env"
  :description: Shebang for saved scripts
  :env_var: MDE_SHEBANG
  :opt_name: shebang
  :procname: val_as_str

- :default: bash
  :description: Shell for launched scripts
  :env_var: MDE_SHELL
  :opt_name: shell
  :procname: val_as_str

- :default: "#  -^-"
  :description: shell_code_label_format_above
  :env_var: MDE_SHELL_CODE_LABEL_FORMAT_ABOVE
  :opt_name: shell_code_label_format_above
  :procname: val_as_str

- :default: "#  -v-  +%{block_name}  -o-  %{document_filename}  -o-  %{time_now_date}  -v-"
  :description: shell_code_label_format_below
  :env_var: MDE_SHELL_CODE_LABEL_FORMAT_BELOW
  :opt_name: shell_code_label_format_below
  :procname: val_as_str

- :default: "%FT%TZ"
  :description: Format for time in code lael
  :env_var: MDE_SHELL_CODE_LABEL_TIME_FORMAT
  :opt_name: shell_code_label_time_format
  :procname: val_as_str

- :arg_name: BOOL
  :default: true
  :description: Whether saved file names include shell parameter expansion
  :env_var: MDE_SHELL_PARAMETER_EXPANSION
  :opt_name: shell_parameter_expansion
  :procname: val_as_bool

- :description: List tab completions
  :long_name: tab-completions
  :opt_name: tab_completions
  :procname: val_as_bool

- :arg_name: BOOL
  :default: false
  :description: Requires user approval before executing a script
  :env_var: MDE_USER_MUST_APPROVE
  :long_name: user-must-approve
  :opt_name: user_must_approve
  :procname: val_as_bool
  :short_name: q

- :description: Print the gem's version
  :long_name: version
  :procname: version
  :short_name: v

- :default: fg_rgbh_ff_7f_00
  :description: Color of warning message
  :env_var: MDE_WARNING_COLOR
  :opt_name: warning_color
  :procname: val_as_str

- :default: 'Error: %{error}'
  :description: Format of warning message
  :env_var: MDE_WARNING_FORMAT
  :opt_name: warning_format
  :procname: val_as_str