markdown_exec 3.2.0 → 3.4.0

data/lib/menu.yml

@@ -94,6 +94,13 @@
   :env_var: MDE_BLOCK_TYPE_PORT_SET_FORMAT
   :default: ": ${%{key}:=%{value}}"
   :procname: val_as_str
+- :opt_name: blocks
+  :arg_name: MESSAGE
+  :default:
+  :description: List the blocks displayed
+  :env_var: MDE_BLOCKS_LIST_MESSAGE
+  :long_name: blocks
+  :procname: val_as_str
 - :opt_name: clear_screen_for_select_block
   :env_var: MDE_CLEAR_SCREEN_FOR_SELECT_BLOCK
   :description: clear_screen_for_select_block
@@ -121,12 +128,6 @@
   :arg_name: BOOL
   :default: true
   :procname: val_as_bool
-- :opt_name: tables_into_columns
-  :env_var: MDE_TABLES_INTO_COLUMNS
-  :description: Format tables as columns
-  :arg_name: BOOL
-  :default: true
-  :procname: val_as_bool
 - :long_name: debug
   :short_name: d
   :env_var: MDE_DEBUG
@@ -208,15 +209,9 @@
   :arg_name: GLOB
   :default: document_configurations/%{document_filename}_*.sh
   :procname: val_as_str
-- :opt_name: menu_for_saved_lines
-  :env_var: MDE_MENU_FOR_SAVED_LINES
-  :description: Add menu options for saved lines
-  :arg_name: BOOL
-  :default: true
-  :procname: val_as_bool
-- :opt_name: menu_for_history
-  :env_var: MDE_MENU_FOR_HISTORY
-  :description: Add menu options for history
+- :opt_name: document_save_make_directory
+  :env_var: MDE_DOCUMENT_SAVE_MAKE_DIRECTORY
+  :description: Make the directory if it does not exist when saving
   :arg_name: BOOL
   :default: true
   :procname: val_as_bool
@@ -279,7 +274,7 @@
 - :opt_name: exception_color_detail
   :env_var: MDE_EXCEPTION_COLOR_DETAIL
   :description: Color of exception detail
-  :default: fg_rgbh_ff_00_7f
+  :default: fg_rgbh_ff_99_cc
   :procname: val_as_str
 - :opt_name: exception_format_detail
   :env_var: MDE_EXCEPTION_FORMAT_DETAIL
@@ -289,7 +284,7 @@
 - :opt_name: exception_color_name
   :env_var: MDE_EXCEPTION_COLOR_NAME
   :description: Color of exception name
-  :default: fg_rgbh_ff_00_00
+  :default: fg_rgbh_ff_6b_6b
   :procname: val_as_str
 - :opt_name: exception_format_name
   :env_var: MDE_EXCEPTION_FORMAT_NAME
@@ -358,7 +353,7 @@
 - :opt_name: execution_report_preview_frame_color
   :env_var: MDE_EXECUTION_REPORT_PREVIEW_FRAME_COLOR
   :description: execution_report_preview_frame_color
-  :default: fg_rgbh_7f_ff_00
+  :default: fg_rgbh_90_e0_90
   :procname: val_as_str
 - :opt_name: execution_report_preview_head
   :env_var: MDE_EXECUTION_REPORT_PREVIEW_HEAD
@@ -488,10 +483,38 @@
   :env_var: MDE_IMPORT_PATHS
   :default:
   :procname: val_as_str
-- :opt_name: import_pattern
+- :opt_name: import_directive_line_pattern
   :env_var: MDE_IMPORT_PATTERN
-  :default: '^(?<indention> *)@import +(?<name>\S+)(?<params>(?: +[A-Za-z_]\w*=(?:"[^"]*"|''[^'']*''|\S+))*)
-    *$'
+  :default: '^(?<indention> *)@import +(?<name>\S+)(?<params>(?: +\w+(?::c=|:e=|:q=|:v=|=)(?:"[^"]*"|''[^'']*''|\S+))*)
+    *\\?$'
+  :procname: val_as_str
+- :opt_name: import_directive_parameter_scan
+  :env_var: MDE_IMPORT_PATTERN_SCAN
+  :default: (\w+)(:c=|:e=|:q=|:v=|=)(?:"([^"]*)"|'([^']*)'|(\S+))
+  :procname: val_as_str
+- :opt_name: import_parameter_variable_assignment
+  :env_var: MDE_IMPORT_PARAMETER_VARIABLE_ASSIGNMENT
+  :default: "%{key}=%{value}"
+  :procname: val_as_str
+- :opt_name: import_symbol_command_substitution
+  :env_var: MDE_IMPORT_SYMBOL_COMMAND_SUBSTITUTION
+  :default: ":c="
+  :procname: val_as_str
+- :opt_name: import_symbol_evaluated_expression
+  :env_var: MDE_IMPORT_SYMBOL_EVALUATED_EXPRESSION
+  :default: ":e="
+  :procname: val_as_str
+- :opt_name: import_symbol_raw_literal
+  :env_var: MDE_IMPORT_SYMBOL_RAW_LITERAL
+  :default: "="
+  :procname: val_as_str
+- :opt_name: import_symbol_force_quoted_literal
+  :env_var: MDE_IMPORT_SYMBOL_FORCE_QUOTED_LITERAL
+  :default: ":q="
+  :procname: val_as_str
+- :opt_name: import_symbol_variable_reference
+  :env_var: MDE_IMPORT_SYMBOL_VARIABLE_REFERENCE
+  :default: ":v="
   :procname: val_as_str
 - :opt_name: line_decor_main
   :env_var: MDE_LINE_DECOR_MAIN
@@ -585,7 +608,7 @@
 - :opt_name: local_name_pattern
   :env_var: MDE_LOCAL_NAME_PATTERN
   :description: Pattern for variables not exported in a series of evaluations
-  :default: "^.{1,3}$"
+  :default: "^_\\S{0,12}$"
   :procname: val_as_str
 - :opt_name: logged_stdout_filename_prefix
   :env_var: MDE_LOGGED_STDOUT_FILENAME_PREFIX
@@ -615,7 +638,7 @@
 - :opt_name: menu_bash_color
   :env_var: MDE_MENU_BASH_COLOR
   :description: Color of menu bash
-  :default: fg_rgbh_00_c0_c0
+  :default: fg_rgbh_87_ce_eb
   :procname: val_as_str
 - :opt_name: menu_blocks_with_docname
   :env_var: MDE_MENU_BLOCKS_WITH_DOCNAME
@@ -633,7 +656,7 @@
 - :opt_name: menu_chrome_color
   :env_var: MDE_MENU_CHROME_COLOR
   :description: Color of menu chrome
-  :default: fg_rgbh_40_c0_c0
+  :default: fg_rgbh_b0_b0_b0
   :procname: val_as_str
 - :opt_name: menu_chrome_format
   :env_var: MDE_MENU_CHROME_FORMAT
@@ -653,7 +676,7 @@
 - :opt_name: menu_divider_color
   :env_var: MDE_MENU_DIVIDER_COLOR
   :description: Color of menu divider
-  :default: fg_rgbh_80_d0_c0
+  :default: fg_rgbh_d0_d0_d0
   :procname: val_as_str
 - :opt_name: menu_divider_format
   :env_var: MDE_MENU_DIVIDER_FORMAT
@@ -668,7 +691,7 @@
 - :opt_name: menu_edit_color
   :env_var: MDE_MENU_EDIT_COLOR
   :description: Color of Edit link
-  :default: fg_rgbh_e0_e0_20
+  :default: fg_rgbh_ff_b3_66
   :procname: val_as_str
 - :opt_name: menu_exit_at_top
   :env_var: MDE_MENU_EXIT_AT_TOP
@@ -681,10 +704,22 @@
   :description: closing demarcations for menu
   :default:
     :line: "~~~"
+- :opt_name: menu_for_history
+  :env_var: MDE_MENU_FOR_HISTORY
+  :description: Add menu options for history
+  :arg_name: BOOL
+  :default: true
+  :procname: val_as_bool
+- :opt_name: menu_for_saved_lines
+  :env_var: MDE_MENU_FOR_SAVED_LINES
+  :description: Add menu options for saved lines
+  :arg_name: BOOL
+  :default: true
+  :procname: val_as_bool
 - :opt_name: menu_heading1_color
   :env_var: MDE_MENU_HEADING1_COLOR
   :description: Color for heading 1 in menu
-  :default: fg_bg_rgbh_80_80_c0_10_10_20
+  :default: fg_bg_rgbh_70_70_b0_f8_f8_fa
   :procname: val_as_str
 - :opt_name: menu_heading1_format
   :env_var: MDE_MENU_HEADING1_FORMAT
@@ -694,7 +729,7 @@
 - :opt_name: menu_heading2_color
   :env_var: MDE_MENU_HEADING2_COLOR
   :description: Color for heading 2 in menu
-  :default: fg_bg_rgbh_60_60_c0_10_10_20
+  :default: fg_bg_rgbh_60_60_a0_f5_f5_f8
   :procname: val_as_str
 - :opt_name: menu_heading2_format
   :env_var: MDE_MENU_HEADING2_FORMAT
@@ -704,7 +739,7 @@
 - :opt_name: menu_heading3_color
   :env_var: MDE_MENU_HEADING3_COLOR
   :description: Color for heading 3 in menu
-  :default: fg_bg_rgbh_40_40_c0_10_10_20
+  :default: fg_bg_rgbh_50_50_90_f2_f2_f5
   :procname: val_as_str
 - :opt_name: menu_heading3_format
   :env_var: MDE_MENU_HEADING3_FORMAT
@@ -714,7 +749,7 @@
 - :opt_name: menu_history_color
   :env_var: MDE_MENU_HISTORY_COLOR
   :description: Color of History link
-  :default: fg_rgbh_e0_e0_20
+  :default: fg_rgbh_87_ce_eb
   :procname: val_as_str
 - :opt_name: menu_import_level_match
   :env_var: MDE_MENU_IMPORT_LEVEL_MATCH
@@ -731,7 +766,7 @@
   :env_var: MDE_MENU_INCLUDE_IMPORTED_NOTES
   :description: Whether imported blocks should be included in the menu
   :arg_name: BOOL
-  :default: false
+  :default: true
   :procname: val_as_bool
 - :opt_name: menu_inherited_lines_at_top
   :env_var: MDE_MENU_INHERITED_LINES_AT_TOP
@@ -742,7 +777,7 @@
 - :opt_name: menu_inherited_lines_color
   :env_var: MDE_MENU_INHERITED_LINES_COLOR
   :description: Color of inherited lines in menu
-  :default: fg_rgbh_94_00_D3
+  :default: fg_rgbh_b3_9a_d8
   :procname: val_as_str
 - :opt_name: menu_inherited_lines_edit_always
   :env_var: MDE_INHERITED_LINES_EDIT_ALWAYS
@@ -763,7 +798,7 @@
 - :opt_name: menu_link_color
   :env_var: MDE_MENU_LINK_COLOR
   :description: Color of menu link
-  :default: fg_rgbh_e0_e0_20
+  :default: fg_rgbh_90_e0_90
   :procname: val_as_str
 - :opt_name: menu_link_format
   :env_var: MDE_MENU_LINK_FORMAT
@@ -779,7 +814,7 @@
 - :opt_name: menu_load_color
   :env_var: MDE_MENU_LOAD_COLOR
   :description: Color of Load link
-  :default: fg_rgbh_e0_e0_20
+  :default: fg_rgbh_87_ce_eb
   :procname: val_as_str
 - :opt_name: menu_note_color
   :env_var: MDE_MENU_NOTE_COLOR
@@ -839,12 +874,12 @@
 - :opt_name: menu_opts_color
   :env_var: MDE_MENU_OPTS_COLOR
   :description: Color of menu opts
-  :default: fg_rgbh_ff_00_ff
+  :default: fg_rgbh_d8_b3_ff
   :procname: val_as_str
 - :opt_name: menu_opts_set_color
   :env_var: MDE_MENU_OPTS_SET_COLOR
   :description: Color of menu opts
-  :default: fg_rgbh_7f_00_ff
+  :default: fg_rgbh_c0_9a_ff
   :procname: val_as_str
 - :opt_name: menu_opts_set_format
   :env_var: MDE_MENU_OPTS_SET_FORMAT
@@ -865,17 +900,12 @@
 - :opt_name: menu_save_color
   :env_var: MDE_MENU_SAVE_COLOR
   :description: Color of Save link
-  :default: fg_rgbh_ff_ff_20
-  :procname: val_as_str
-- :opt_name: menu_table_rows_match
-  :env_var: MDE_MENU_TABLE_ROWS_MATCH
-  :description: Pattern for table rows
-  :default: "^(?<indent>[ \\t]*)(?<line>(?<text>\\|.*?)(?<trailing>[ \\t]*))$"
+  :default: fg_rgbh_90_e0_90
   :procname: val_as_str
 - :opt_name: menu_task_color
   :env_var: MDE_MENU_TASK_COLOR
   :description: Color of menu task
-  :default: fg_rgbh_ff_ff_ff
+  :default: fg_rgbh_40_40_40
   :procname: val_as_str
 - :opt_name: menu_task_format
   :env_var: MDE_MENU_TASK_FORMAT
@@ -894,9 +924,34 @@
   :procname: val_as_str
 - :opt_name: menu_ux_color
   :env_var: MDE_MENU_UX_COLOR
-  :description: Color of menu ux
+  :description: Default color of menu ux
   :default: fg_rgbh_df_c0_df
   :procname: val_as_str
+- :opt_name: menu_ux_color_allow
+  :env_var: MDE_MENU_UX_COLOR_ALLOW
+  :description: Color of menu ux when it is allow
+  :default: fg_rgbh_90_e0_90
+  :procname: val_as_str
+- :opt_name: menu_ux_color_echo
+  :env_var: MDE_MENU_UX_COLOR_ECHO
+  :description: Color of menu ux when it is echo
+  :default: fg_rgbh_87_ce_eb
+  :procname: val_as_str
+- :opt_name: menu_ux_color_edit
+  :env_var: MDE_MENU_UX_COLOR_EDIT
+  :description: Color of menu ux when it is edit
+  :default: fg_rgbh_ff_b3_66
+  :procname: val_as_str
+- :opt_name: menu_ux_color_exec
+  :env_var: MDE_MENU_UX_COLOR_EXEC
+  :description: Color of menu ux when it is exec
+  :default: fg_rgbh_ff_6b_6b
+  :procname: val_as_str
+- :opt_name: menu_ux_color_readonly
+  :env_var: MDE_MENU_UX_COLOR_READONLY
+  :description: Color of menu ux when it is read-only
+  :default: fg_rgbh_c0_c0_c0
+  :procname: val_as_str
 - :opt_name: menu_ux_row_format
   :env_var: MDE_MENU_UX_ROW_FORMAT
   :description: Format for UX row
@@ -905,12 +960,12 @@
 - :opt_name: menu_vars_color
   :env_var: MDE_MENU_VARS_COLOR
   :description: Color of menu vars
-  :default: fg_rgbh_ff_a0_ff
+  :default: fg_rgbh_d8_b3_ff
   :procname: val_as_str
 - :opt_name: menu_vars_set_color
   :env_var: MDE_MENU_VARS_SET_COLOR
   :description: Color of menu vars
-  :default: fg_rgbh_00_ff_ff
+  :default: fg_rgbh_a0_e6_e6
   :procname: val_as_str
 - :opt_name: menu_vars_set_format
   :env_var: MDE_MENU_VARS_SET_FORMAT
@@ -1000,12 +1055,12 @@
 - :opt_name: output_execution_label_name_color
   :env_var: MDE_OUTPUT_EXECUTION_LABEL_NAME_COLOR
   :description: Color of output_execution_label_name
-  :default: fg_rgbh_00_ff_00
+  :default: fg_rgbh_70_c0_70
   :procname: val_as_str
 - :opt_name: output_execution_label_value_color
   :env_var: MDE_OUTPUT_EXECUTION_LABEL_VALUE_COLOR
   :description: Color of output_execution_label_value
-  :default: fg_rgbh_00_ff_00
+  :default: fg_rgbh_90_e0_90
   :procname: val_as_str
 - :opt_name: output_execution_report
   :env_var: MDE_OUTPUT_EXECUTION_REPORT
@@ -1082,7 +1137,7 @@
 - :opt_name: prompt_color_after_script_execution
   :env_var: MDE_PROMPT_COLOR_AFTER_SCRIPT_EXECUTION
   :description: Color of prompt after script execution
-  :default: fg_rgbh_00_ff_00
+  :default: fg_rgbh_70_c0_70
   :procname: val_as_str
 - :opt_name: prompt_debounce
   :env_var: MDE_PROMPT_DEBOUNCE
@@ -1164,13 +1219,6 @@
 
     Choose a file:
   :procname: val_as_str
-- :opt_name: prompt_select_output
-  :env_var: MDE_PROMPT_SELECT_OUTPUT
-  :default: |2-
-
-    Choose a file:
-  :description: Prompt to select a saved file
-  :procname: val_as_str
 - :opt_name: prompt_ux_enter_a_value
   :env_var: MDE_PROMPT_UX_ENTER_A_VALUE
   :description: Prompt to enter a value for UX blocks
@@ -1223,6 +1271,11 @@
 - :opt_name: pwd
   :long_name: pwd
   :description: Print the gem's home directory
+- :opt_name: required_lines_with_source_comments
+  :env_var: MDE_REQUIRED_LINES_WITH_SOURCE_COMMENTS
+  :description: Add comments about source to blocks of required lines
+  :default: false
+  :procname: val_as_bool
 - :opt_name: run_last_script
   :long_name: run-last-script
   :description: Run most recently saved script
@@ -1311,10 +1364,15 @@
   :description: Screen width for document and interface. 0 to use the actual dimension.
   :default: 0
   :procname: val_as_int
+- :opt_name: script_comment_block_name_format
+  :env_var: MDE_SCRIPT_COMMENT_BLOCK_NAME_FORMAT
+  :description: format for block name in script comments
+  :default: "%{block} %{time}"
+  :procname: val_as_str
 - :opt_name: script_execution_frame_color
   :env_var: MDE_SCRIPT_EXECUTION_FRAME_COLOR
   :description: script_execution_frame_color
-  :default: fg_rgbh_00_ff_7f
+  :default: fg_rgbh_80_d0_a0
   :procname: val_as_str
 - :opt_name: script_execution_head
   :env_var: MDE_SCRIPT_EXECUTION_HEAD
@@ -1331,7 +1389,7 @@
 - :opt_name: script_preview_frame_color
   :env_var: MDE_OUTPUT_DIVIDER_COLOR
   :description: Color of output divider
-  :default: fg_rgbh_7f_ff_00
+  :default: fg_rgbh_a0_d0_80
   :procname: val_as_str
 - :opt_name: script_preview_head
   :env_var: MDE_SCRIPT_PREVIEW_HEAD
@@ -1440,10 +1498,36 @@
   :default:
   - fg_bg_rgbh_cf_cf_cf_14_18_1c
   - fg_bg_rgbh_df_df_df_24_24_24
+- :opt_name: table_row_multi_line_delimiter
+  :env_var: MDE_TABLE_ROW_MULTI_LINE_DELIMITER
+  :description: Multi-line-table delimiter
+  :default: "|"
+  :procname: val_as_str
+- :opt_name: table_row_multi_line_match
+  :env_var: MDE_TABLE_ROW_MULTI_LINE_MATCH
+  :description: Pattern for multi-line-table rows
+  :default: "^(?<indent>[ \\t]*)(?<line>(?<text>\\|.*?)(?<trailing>[ \\t]*))$"
+  :procname: val_as_str
+- :opt_name: table_row_single_line_delimiter
+  :env_var: MDE_TABLE_ROW_SINGLE_LINE_DELIMITER
+  :description: Single-line-table delimiter
+  :default: "!"
+  :procname: val_as_str
+- :opt_name: table_row_single_line_match
+  :env_var: MDE_TABLE_ROW_SINGLE_LINE_MATCH
+  :description: Pattern for single-line-table rows
+  :default: "^(?<indent>[ \\t]*)(?<line>(?<text>!.*?)(?<trailing>[ \\t]*))$"
+  :procname: val_as_str
 - :opt_name: table_separator_line_color
   :env_var: MDE_TABLE_SEPARATOR_LINE_COLOR
   :description: Color for table separator line
   :default: fg_bg_rgbh_df_df_00_14_18_1c
+- :opt_name: tables_into_columns
+  :env_var: MDE_TABLES_INTO_COLUMNS
+  :description: Format tables as columns
+  :arg_name: BOOL
+  :default: true
+  :procname: val_as_bool
 - :opt_name: user_must_approve
   :long_name: user-must-approve
   :short_name: q
@@ -1486,7 +1570,7 @@
 - :opt_name: warning_color
   :env_var: MDE_WARNING_COLOR
   :description: Color of warning message
-  :default: fg_rgbh_ff_7f_00
+  :default: fg_rgbh_ff_b3_66
   :procname: val_as_str
 - :opt_name: warning_format
   :env_var: MDE_WARNING_FORMAT

data/lib/string_util.rb

@@ -29,3 +29,83 @@ class String
     end
   end
 end
+
+# String.delete_even_chars / String.delete_even_chars!
+#
+# Class methods that remove the 2nd, 4th, 6th, ... characters from a string.
+#
+# Behavior
+# - Operates on Unicode grapheme clusters via /\X/ to avoid splitting emoji
+#   and combining sequences—“user-visible characters” are treated as units.
+# - .delete_even_chars(str) returns a new string consisting of the 1st, 3rd,
+#   5th, ... clusters from +str+.
+# - .delete_even_chars!(str) modifies +str+ in place using #replace and
+#   returns it (raises FrozenError if +str+ is frozen).
+#
+# Examples
+#   String.delete_even_chars("abcdef")      # => "ace"
+#   String.delete_even_chars("áb̂c̆")        # keeps 1st, 3rd, ... clusters intact
+#   s = "👨‍👩‍👧‍👦🙂x"; String.delete_even_chars!(s)  # modifies s
+#
+class String
+  def delete_even_chars
+    clusters = scan(/\X/)
+    return dup if clusters.length <= 1
+
+    clusters.each_with_index
+            .select { |_, i| i.even? } # keep 1st, 3rd, 5th... (0-based even)
+            .map(&:first)
+            .join
+  end
+
+  def delete_even_chars!
+    replace(delete_even_chars)
+  end
+end
+
+# String#sort_chars / String#sort_chars!
+#
+# Adds methods to order a string's user-visible characters (Unicode grapheme
+# clusters) and return the joined result.
+#
+# Behavior
+# - Sorts by Ruby’s default ordering of the grapheme cluster strings.
+# - Preserves emoji and combining sequences by splitting on /\X/.
+# - Optional case-insensitive key and reverse ordering.
+# - Optional custom comparator block; if given, it takes precedence.
+#
+# API
+#   String#sort_chars(reverse: false, casefold: false) { |a, b| ... } -> String
+#   String#sort_chars!(reverse: false, casefold: false) { |a, b| ... } -> self
+#
+# Examples
+#   "cba".sort_chars                     #=> "abc"
+#   "Baß".sort_chars(casefold: true)     #=> "aBß"
+#   "👩‍💻🚀a".sort_chars                  #=> "a👩‍💻🚀" (clusters kept intact)
+#   "bca".sort_chars { |a,b| b <=> a }   #=> "cba" (custom comparator)
+#
+# Notes
+# - For locale-aware collation, integrate a collator and use the block form.
+#
+class String
+  def sort_chars(reverse: false, casefold: false, &block)
+    clusters = scan(/\X/)
+    return self if clusters.length <= 1
+
+    sorted =
+      if block
+        clusters.sort(&block)
+      elsif casefold
+        clusters.sort_by(&:downcase)
+      else
+        clusters.sort
+      end
+
+    sorted.reverse! if reverse
+    sorted.join
+  end
+
+  def sort_chars!(reverse: false, casefold: false, &block)
+    replace(sort_chars(reverse: reverse, casefold: casefold, &block))
+  end
+end