markdown_exec 2.8.0 → 2.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c36bb5c2d9e91eeeae59067f91fc88a3ad8e6b1a27ebfb474ff900903d030042
-  data.tar.gz: b002fc24e78006e830fdc66bb0be4df05fe9df62e6c036965eefbb7047f37ec7
+  metadata.gz: d752af0db5e1c1a770b64f9341c3d08e1e9bc8612230a9cb44ddc7fddc4c3051
+  data.tar.gz: 5ba8524b3323bd8333b82a5d0607fbb9db59a5157a1c7ae0564b3f624f26addd
 SHA512:
-  metadata.gz: 8eedac9012c2c0103afe99a8ea0cd235b26b3ab62618b35d79af6f685a56195818d28ba70588f93d754c76e5c4b3bb524de0ed09fd97864bdc79a424015911a9
-  data.tar.gz: d24b8c56e50416032de644f00d11f6bb81689617e47da57ec1e4b39a693c867dedff268ddd00e023bc134fc40ee9ae9b452a808131d129b378508464ac0793f5
+  metadata.gz: 29b210e56b46a1edf099c02267e2b3c7cdae6701f7ee99d5a946d06eea7272da3534765110ec36a6de017a10d0f4833c9075c27dacb0cec8b050192d3892d748
+  data.tar.gz: e73cd906ce9035c8c78d2e301866af4a76bc7a730c5109fc8cc59ecf64679cb578fb04b324e700df064886d250c394c441f77850b9e21230d346d08bd92a9a5f

data/.rubocop.yml

@@ -97,6 +97,9 @@ Style/GlobalVars:
 Style/IfUnlessModifier: # 2024-08 suggests lines that are too long
   Enabled: false
 
+Style/KeywordParametersOrder:
+  Enabled: false
+
 Style/Lambda:
   Enabled: false
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    markdown_exec (2.8.0)
+    markdown_exec (2.8.1)
       clipboard (~> 1.3.6)
       open3 (~> 0.1.1)
       optparse (~> 0.1.1)

data/bats/block-type-ux-auto.bats

@@ -0,0 +1,8 @@
+#!/usr/bin/env bats
+
+load 'test_helper'
+
+@test 'Initial values' {
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-ux-auto.md \
+   'v1 = _v2 = _v3 = 12_v4 = 21_v5 = markdown_exec_v6 = 31'
+}

data/bats/block-type-ux-exec.bats

@@ -0,0 +1,8 @@
+#!/usr/bin/env bats
+
+load 'test_helper'
+
+@test 'Output of executed commands as initial value' {
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-ux-exec.md \
+   "ux0=_ux1=Unknown_ux2=markdown_exec_ux3=markdown_exec_ux4=Xform: 'markdown'"
+}

data/bats/block-type-ux-row-format.bats

@@ -0,0 +1,8 @@
+#!/usr/bin/env bats
+
+load 'test_helper'
+
+@test 'Row format merges with prior table' {
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-ux-row-format.md \
+   '  | Variable  | Value            | Prompt              |_  | --------- | ---------------- | ------------------- |_  | Species   | Pongo tapanulien | New species?    |_ | Name: Gen | Value: Pongo     | Prompt: New genus? |_  | Family    | Hominidae        | Enter a value:  |'
+}

data/bats/block-type-ux-transform.bats

@@ -0,0 +1,8 @@
+#!/usr/bin/env bats
+
+load 'test_helper'
+
+@test 'Transformed output of executed commands' {
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-ux-transform.md \
+   '_Execution output has a trailing newline._Var0=markdown_exec_00000000  6d 61 72 6b 64 6f 77 6e  5f 65 78 65 63 0a        |markdown_exec.|__With validate and transform, output has no newline._Var1=markdown_exec_00000000  6d 61 72 6b 64 6f 77 6e  5f 65 78 65 63           |markdown_exec|__With transform :chomp, output has no newline._Var2=markdown_exec_00000000  6d 61 72 6b 64 6f 77 6e  5f 65 78 65 63           |markdown_exec|__With transform :upcase, output is in upper case w/ newline._Var3=MARKDOWN_EXEC_00000000  4d 41 52 4b 44 4f 57 4e  5f 45 58 45 43 0a        |MARKDOWN_EXEC.|'
+}

data/bin/tab_completion.sh

@@ -13,7 +13,7 @@ __filedirs_all()
 }
 
 _mde_echo_version() {
-  echo "2.8.0"
+  echo "2.8.1"
 }
 
 _mde() {

data/docs/dev/block-type-ux-auto.md

@@ -0,0 +1,43 @@
+/ v2025-02-08
+/ name only
+```ux
+name: v1
+```
+/ name and default
+/ transform and validate options not applied to default
+```ux
+default: 11
+name: v2
+```
+/ name and default; auto-load
+/ prompt option is ignored during auto-load
+```ux :[document_ux_v3]
+default: 12
+name: v3
+```
+/ name, default, exec; auto-load static
+```ux :[document_ux_v4]
+default: 21
+exec: basename $(pwd)
+name: v4
+```
+/ name, default, exec; auto-load executed `basename $(pwd)`
+/ allowed is ignored by exec
+```ux :[document_ux_v5]
+default: :exec
+exec: basename $(pwd)
+name: v5
+```
+/ name, default, allowed; auto-load static default
+```ux :[document_ux_v6]
+allowed:
+- 32
+- 33
+default: 31
+name: v6
+```
+@import bats-document-configuration.md
+```opts :(document_opts)
+menu_ux_row_format: '%{name} = ${%{name}}'
+ux_auto_load_force_default: true
+```

data/docs/dev/block-type-ux-exec.md

@@ -0,0 +1,42 @@
+/ auto-load block, does not execute command to calculate
+/ click block to calculate
+```ux :[document_ux0]
+exec: basename $(pwd)
+name: ux0
+```
+/ auto-load block and execute command to calculate
+/ click block to recalculate
+```ux :[document_ux1]
+default: Unknown
+exec: basename $(pwd)
+name: ux1
+```
+/ auto-load block and execute command to calculate
+/ click block to recalculate
+```ux :[document_ux2]
+default: :exec
+exec: basename $(pwd)
+name: ux2
+```
+/ required block defining a function used in exec
+```bash :(bash3)
+# function from bash3
+val () { basename $(pwd) ; }
+```
+```ux :[document_ux3] +(bash3)
+default: :exec
+exec: val
+name: ux3
+```
+/ default is computed
+/ output of execution is validated/parsed
+/ parsing is transformed
+```ux :[document_ux4]
+default: :exec
+exec: basename $(pwd)
+name: ux4
+transform: "Xform: '%{name}'"
+validate: |
+  ^(?<name>.*)(_.*)$
+```
+@import bats-document-configuration.md

data/docs/dev/block-type-ux-row-format.md

@@ -0,0 +1,47 @@
+/ v2025-02-08
+| Variable| Value| Prompt
+| -| -| -
+/ auto-load default value
+/ custom prompt
+/ select list
+/ default value
+```ux :[document_ux_Species]
+allowed:
+- Pongo tapanuliensis
+- Histiophryne psychedelica
+- Phyllopteryx dewysea
+default: Pongo tapanuliensis
+name: Species
+prompt: New species?
+```
+/ auto-load default value
+/ cell text is prefixed Name/Value/Prompt
+/ select list contains additional text
+/ selected value is validated with named groups
+/ selected value is transformed; named capture is prefixed Xform
+```ux :[document_ux_Genus]
+allowed:
+- 1. Pongo
+- 2. Histiophryne
+- 3. Phyllopteryx
+default: Pongo
+menu_format: "| Name: %{name}| Value: ${%{name}}| Prompt: %{prompt}"
+name: Genus
+prompt: New genus?
+transform: "Xform: '%{name}'"
+validate: |
+  ^\d+\. *(?<name>[^ ].*)$
+```
+/ default
+/ auto-load default value
+```ux :[document_ux_Family]
+default: Hominidae
+name: Family
+```
+@import bats-document-configuration.md
+```opts :(document_opts)
+menu_ux_row_format: '| %{name}| ${%{name}}| %{prompt}'
+screen_width: 64
+table_center: true
+ux_auto_load_force_default: true
+```

data/docs/dev/block-type-ux-transform.md

@@ -0,0 +1,41 @@
+:::
+**Execution output has a trailing newline.**
+```ux :[document_ux_transform_0]
+default: :exec
+exec: basename $(pwd)
+name: Var0
+```
+$(echo -n "$Var0" | hexdump -C)
+:::
+**With validate and transform, output has no newline.**
+```ux :[document_ux_transform_1]
+default: :exec
+exec: basename $(pwd)
+name: Var1
+transform: '%{name}'
+validate: (?<name>.+)
+```
+$(echo -n "$Var1" | hexdump -C)
+:::
+**With transform `:chomp`, output has no newline.**
+```ux :[document_ux_transform_2]
+default: :exec
+exec: basename $(pwd)
+name: Var2
+transform: :chomp
+```
+$(echo -n "$Var2" | hexdump -C)
+:::
+**With transform `:upcase`, output is in upper case w/ newline.**
+```ux :[document_ux_transform_3]
+default: :exec
+exec: basename $(pwd)
+name: Var3
+transform: :upcase
+```
+$(echo -n "$Var3" | hexdump -C)
+@import bats-document-configuration.md
+```opts :(document_opts)
+divider4_collapsible: false
+table_center: false
+```

data/lib/constants.rb

@@ -100,8 +100,10 @@ end
 
 # selected block and subsequent menu state
 #
+BlockSelection = Struct.new(:id)
 SelectedBlockMenuState = Struct.new(:block, :source, :state)
 
 class TtyMenu
+  ENABLE = nil
   DISABLE = ''
 end

data/lib/fcb.rb

@@ -56,10 +56,6 @@ module MarkdownExec
         title: '',
         type: ''
       }.merge(options)
-      # @attrs[:raw_body] ||= @attrs[:body]
-      # @attrs[:raw_dname] ||= @attrs[:dname]
-      # @attrs[:raw_s0printable] ||= @attrs[:s0printable]
-      # @attrs[:raw_s1decorated] ||= @attrs[:s1decorated]
     end
 
     def code_name_included?(*names)
@@ -92,34 +88,6 @@ module MarkdownExec
                        end
     end
 
-    # def body=(value)
-    #   ww0 'body=', value
-    #   # binding.irb
-    #   @attrs[:raw_body] ||= value
-    #   @attrs[:body] = value
-    # end
-
-    # def dname=(value)
-    #   ww0 'dname=', value
-    #   binding.irb if value == '                                              | Species| Not specified'
-    #   @attrs[:raw_dname] ||= value
-    #   @attrs[:dname] = value
-    # end
-
-    # def s0printable=(value)
-    #   ww0 's0printable=', value
-    #   # binding.irb
-    #   @attrs[:raw_s0printable] ||= value
-    #   @attrs[:s0printable] = value
-    # end
-
-    # def s1decorated=(value)
-    #   ww0 's1decorated=', value
-    #   # binding.irb
-    #   @attrs[:raw_s1decorated] ||= value
-    #   @attrs[:s1decorated] = value
-    # end
-
     # Processes a block to generate its summary, modifying its attributes
     #  based on various matching criteria.
     # It handles special formatting for bash blocks, extracting and setting

data/lib/hash_delegator.rb

@@ -934,7 +934,12 @@ module MarkdownExec
       end
     end
 
-    # private
+    def build_menu_options(exit_option, display_mode_option,
+                           menu_entries, display_format)
+      [exit_option,
+       display_mode_option,
+       *menu_entries.map(&display_format)].compact
+    end
 
     def build_replacement_dictionary(
       commands, link_state,
@@ -1061,7 +1066,8 @@ module MarkdownExec
                   when :exec
                     raise unless export.exec.present?
 
-                    n1 = neval(export.exec, (inherited_code || []) + required[:code])
+                    n1 = neval(export.exec,
+                               (inherited_code || []) + required[:code])
 
                     if export.transform.present?
                       if export.transform.is_a? Symbol
@@ -1167,7 +1173,6 @@ module MarkdownExec
 
     def code_line_safe_assign(name, value, force:)
       if force
-# ww0 value
         "#{name}=#{Shellwords.escape(value)}"
       else
         "[[ -z $#{name} ]] && #{name}=#{Shellwords.escape(value)}"
@@ -1981,19 +1986,23 @@ module MarkdownExec
         block_source: block_source
       )
 
-      # if the same menu is being displayed, collect the display name
-      #  of the selected menu item for use as the default item
-      [lfls.link_state,
-       lfls.load_file == LoadFile::LOAD ? nil : selected.dname,
-       # 2024-08-22 true to quit
-       lfls.load_file == LoadFile::EXIT]
+      # dname is not fixed for some block types, use block id
+      if lfls.load_file != LoadFile::LOAD &&
+         [BlockType::HEADING, BlockType::TEXT,
+          BlockType::UX].include?(selected.type)
+        block_selection = BlockSelection.new(selected.id)
+      end
+
+      { link_state: lfls.link_state,
+        block_selection: block_selection,
+        quit: lfls.load_file == LoadFile::EXIT }
     end
 
     def execute_block_in_state(block_name)
       @dml_block_state = block_state_for_name_from_cli(block_name)
       dump_and_warn_block_state(name: block_name,
                                 selected: @dml_block_state.block)
-      @dml_link_state, @dml_menu_default_dname, quit =
+      next_block_state =
         execute_block_for_state_and_name(
           selected: @dml_block_state.block,
           mdoc: @dml_mdoc,
@@ -2005,7 +2014,10 @@ module MarkdownExec
             )
           }
         )
-      :break if quit
+
+      @dml_link_state = next_block_state[:link_state]
+      @dml_block_selection = next_block_state[:block_selection]
+      :break if next_block_state[:quit]
     end
 
     def execute_block_type_history_ux(
@@ -2152,6 +2164,7 @@ module MarkdownExec
           block_data['glob'] || glob
         )
       )
+      dirs.sort_by! { |f| File.mtime(f) }.reverse!
 
       if !contains_glob?(block_data['directory']) &&
          !contains_glob?(block_data['glob'])
@@ -2162,7 +2175,7 @@ module MarkdownExec
         end
       elsif selected_option = select_option_with_metadata(
         prompt_title,
-        [exit_prompt] + dirs.sort.map do |file|
+        [exit_prompt] + dirs.map do |file|
           { name: format(
             block_data['view'] || view,
             NamedCaptureExtractor.extract_named_group_match_data(
@@ -2326,41 +2339,25 @@ module MarkdownExec
     )
       # repeat select+display until user exits
 
-      pause_now = false
-      row_attrib = :row
-      loop do
-        if pause_now && (prompt_select_continue == MenuState::EXIT)
-          break
-        end
-
-        # menu with Back and Facet options at top
-        case (name = prompt_select_code_filename(
-          [exit_prompt,
-           @delegate_object[:prompt_filespec_facet]] +
-           files_table_rows.map(&row_attrib),
-          string: @delegate_object[:prompt_select_history_file],
-          color_sym: :prompt_color_after_script_execution
-        ))
-        when exit_prompt
-          break
-        when @delegate_object[:prompt_filespec_facet]
-          row_attrib = row_attrib == :row ? :file : :row
-          pause_now = false
-        else
-          file = files_table_rows.select { |ftr| ftr.row == name }&.first
-          info = file_info(file.file)
-          stream.puts "#{file.file} - #{info[:lines]} lines / " \
-                      "#{info[:size]} bytes"
-          stream.puts(
-            File.readlines(file.file,
-                           chomp: false).map.with_index do |line, ind|
-              format(' %s.  %s',
-                     AnsiString.new(format('% 4d', ind + 1)).send(:violet),
-                     line)
-            end
-          )
-          pause_now = pause_refresh
-        end
+      interactive_menu_with_display_modes(
+        files_table_rows,
+        display_formats: [:row, :file],
+        display_mode_option: @delegate_object[:prompt_filespec_facet],
+        exit_option: exit_prompt,
+        menu_title: @delegate_object[:prompt_select_history_file],
+        pause_after_selection: pause_refresh
+      ) do |file|
+        info = file_info(file.file)
+        stream.puts "#{file.file} - #{info[:lines]} lines / " \
+                    "#{info[:size]} bytes"
+        stream.puts(
+          File.readlines(file.file,
+                         chomp: false).map.with_index do |line, ind|
+            format(' %s.  %s',
+                   AnsiString.new(format('% 4d', ind + 1)).send(:violet),
+                   line)
+          end
+        )
       end
     end
 
@@ -2679,6 +2676,56 @@ module MarkdownExec
       }
     end
 
+    def interactive_menu_with_display_modes(
+      menu_entries,
+      display_formats:,
+      display_mode_option:,
+      exit_option:,
+      menu_title:,
+      pause_after_selection:
+    )
+      pause_menu = false
+      current_display_format = display_formats.first
+
+      loop do
+        break if pause_menu && (prompt_select_continue == MenuState::EXIT)
+
+        menu_options = build_menu_options(
+          exit_option, display_mode_option,
+          menu_entries, current_display_format
+        )
+
+        selection = prompt_select_code_filename(
+          menu_options,
+          string: menu_title,
+          color_sym: :prompt_color_after_script_execution
+        )
+
+        case selection
+        when exit_option
+          break
+        when display_mode_option
+          current_display_format = next_item(
+            display_formats, current_display_format
+          )
+          pause_menu = false
+        else
+          handle_selection(menu_entries, selection,
+                           current_display_format) do |item|
+            yield item if block_given?
+          end
+          pause_menu = pause_after_selection
+        end
+      end
+    end
+
+    def handle_selection(menu_entries, selection, current_display_format)
+      selected_item = menu_entries.find do |entry|
+        entry.send(current_display_format) == selection
+      end
+      yield selected_item if selected_item
+    end
+
     # Iterates through blocks in a file, applying the provided block to each line.
     # The iteration only occurs if the file exists.
     # @yield [Symbol] :filter Yields to obtain selected messages for processing.
@@ -3209,6 +3256,13 @@ module MarkdownExec
       end
     end
 
+    def next_item(list, current_item)
+      index = list.index(current_item)
+      return nil unless index # Return nil if the item is not in the list
+
+      list[(index + 1) % list.size] # Get the next item, wrap around if at the end
+    end
+
     def next_state_append_code(selected, link_state, code_lines)
       next_state_set_code(
         selected,
@@ -4111,7 +4165,7 @@ module MarkdownExec
       disabled = if fcb_title_groups.fetch(:type, '') == BlockType::YAML
                    TtyMenu::DISABLE
                  else
-                   nil
+                   TtyMenu::ENABLE
                  end
 
       MarkdownExec::FCB.new(
@@ -4237,11 +4291,11 @@ module MarkdownExec
       @delegate_object.merge!(options)
     end
 
-    def vux_await_user_selection
+    def vux_await_user_selection(prior_answer: @dml_block_selection)
       @dml_block_state = load_cli_or_user_selected_block(
         all_blocks: @dml_blocks_in_file,
         menu_blocks: @dml_menu_blocks,
-        prior_answer: @dml_menu_default_dname
+        prior_answer: prior_answer
       )
       if !@dml_block_state
         # HashDelegator.error_handler('block_state missing', { abort: true })
@@ -4395,7 +4449,7 @@ module MarkdownExec
         @dml_link_state.block_name.present?
       @cli_block_name = @dml_link_state.block_name
       @dml_now_using_cli = @run_state.source.block_name_from_cli
-      @dml_menu_default_dname = nil
+      @dml_block_selection = nil
       @dml_block_state = SelectedBlockMenuState.new
       @doc_saved_lines_files = []
 
@@ -4713,7 +4767,9 @@ module MarkdownExec
       else
         # puts "? - Select a block to execute (or type #{$texit}
         #  to exit):"
-        return :break if vux_await_user_selection == :break
+        return :break if vux_await_user_selection(
+          prior_answer: @dml_block_selection
+        ) == :break
         return :break if @dml_block_state.block.nil? # no block matched
       end
       # puts "! - Executing block: #{data}"
@@ -4763,7 +4819,13 @@ module MarkdownExec
                             block.dname.include?(prior_answer)
                           end&.name
                         when Struct
-                          prior_answer.index || prior_answer.name
+                          if prior_answer.id
+                            menu_items.find_index do |block|
+                              block[:id] == prior_answer.id
+                            end + 1
+                          else
+                            prior_answer.index || prior_answer.name
+                          end
                         end
       # prior_answer value may not match if color is different from
       # originating menu (opts changed while processing)

data/lib/markdown_exec/version.rb

@@ -7,5 +7,5 @@ module MarkdownExec
   BIN_NAME = 'mde'
   GEM_NAME = 'markdown_exec'
   TAP_DEBUG = 'MDE_DEBUG'
-  VERSION = '2.8.0'
+  VERSION = '2.8.1'
 end

data/lib/mdoc.rb

@@ -85,14 +85,17 @@ module MarkdownExec
 
       dependencies = collect_dependencies(nickname)
       # !!t dependencies.count
-      all_dependency_names = collect_unique_names(dependencies).push(nickname).uniq
+      all_dependency_names =
+        collect_unique_names(dependencies).push(nickname).uniq
       # !!t all_dependency_names.count
 
       # select blocks in order of appearance in source documents
       #
       blocks = @table.select do |fcb|
         # 2024-08-04 match nickname
-        all_dependency_names.include?(fcb.pub_name) || all_dependency_names.include?(fcb.nickname) || all_dependency_names.include?(fcb.oname)
+        all_dependency_names.include?(fcb.pub_name) ||
+          all_dependency_names.include?(fcb.nickname) ||
+          all_dependency_names.include?(fcb.oname)
       end
       # !!t blocks.count
 
@@ -102,7 +105,10 @@ module MarkdownExec
       blocks = blocks.map do |fcb|
         # 2024-08-04 match oname for long block names
         # 2024-08-04 match nickname
-        unmet_dependencies.delete(fcb.pub_name) || unmet_dependencies.delete(fcb.nickname) || unmet_dependencies.delete(fcb.oname) # may not exist if block name is duplicated
+        # may not exist if block name is duplicated
+        unmet_dependencies.delete(fcb.pub_name) ||
+          unmet_dependencies.delete(fcb.nickname) ||
+          unmet_dependencies.delete(fcb.oname)
         if (call = fcb.call)
           fcb1 = get_block_by_anyname("[#{call.match(/^%\((\S+) |\)/)[1]}]")
           fcb1.cann = call
@@ -124,8 +130,10 @@ module MarkdownExec
     # @param name [String] The name of the code block to start the collection from.
     # @return [Array<String>] An array of strings containing the collected code blocks.
     #
-    def collect_recursively_required_code(anyname:, block_source:, label_body: true, label_format_above: nil,
-                                          label_format_below: nil)
+    def collect_recursively_required_code(
+      anyname:, block_source:,
+      label_body: true, label_format_above: nil, label_format_below: nil
+    )
       block_search = collect_block_dependencies(anyname: anyname)
       if block_search[:blocks]
         blocks = collect_wrapped_blocks(block_search[:blocks])
@@ -150,8 +158,10 @@ module MarkdownExec
               elsif fcb.type == BlockType::PORT
                 generate_env_variable_shell_commands(fcb)
               elsif label_body
-                generate_label_body_code(fcb, block_source, label_format_above,
-                                         label_format_below)
+                generate_label_body_code(
+                  fcb, block_source,
+                  label_format_above, label_format_below
+                )
               else # raw body
                 fcb.body
               end
@@ -230,9 +240,14 @@ module MarkdownExec
         initialize: opts[:compressed_ids].nil?
       ) do |fcb, _hide, _collapsed_level|
         # update fcb per state
-        if fcb.collapsible
-          fcb.s1decorated = fcb.s1decorated + ' ' + (fcb.collapse ? opts[:menu_collapsible_symbol_collapsed] : opts[:menu_collapsible_symbol_expanded])
-        end
+        next unless fcb.collapsible
+
+        fcb.s1decorated = fcb.s1decorated + ' ' +
+                          (if fcb.collapse
+                             opts[:menu_collapsible_symbol_collapsed]
+                           else
+                             opts[:menu_collapsible_symbol_expanded]
+                           end)
       end
       opts[:compressed_ids] = collapser.compress_ids
       opts[:expanded_ids] = collapser.expand_ids
@@ -240,7 +255,9 @@ module MarkdownExec
       # remove
       # . empty chrome between code; edges are same as blanks
       #
-      select_elements_with_neighbor_conditions(selrows) do |prev_element, current, next_element|
+      select_elements_with_neighbor_conditions(selrows) do |prev_element,
+                                                            current,
+                                                            next_element|
         !(current[:chrome] && !current.oname.present?) ||
           !(!prev_element.nil? &&
             prev_element.shell.present? &&
@@ -291,13 +308,17 @@ module MarkdownExec
 
       label_above = if label_format_above.present?
                       format(label_format_above,
-                             block_source.merge({ block_name: block_name_for_bash_comment }))
+                             block_source.merge(
+                               { block_name: block_name_for_bash_comment }
+                             ))
                     else
                       nil
                     end
       label_below = if label_format_below.present?
                       format(label_format_below,
-                             block_source.merge({ block_name: block_name_for_bash_comment }))
+                             block_source.merge(
+                               { block_name: block_name_for_bash_comment }
+                             ))
                     else
                       nil
                     end
@@ -415,8 +436,11 @@ module MarkdownExec
       memo
     end
 
-    def select_elements_with_neighbor_conditions(array,
-                                                 last_selected_placeholder = nil, next_selected_placeholder = nil)
+    def select_elements_with_neighbor_conditions(
+      array,
+      last_selected_placeholder = nil,
+      next_selected_placeholder = nil
+    )
       selected_elements = []
       last_selected = last_selected_placeholder
 
@@ -463,8 +487,10 @@ if $PROGRAM_NAME == __FILE__
       end if false
 
       def test_collect_dependencies_with_valid_source
-        @mdoc.stubs(:get_block_by_anyname).with('source1').returns(OpenStruct.new(reqs: ['source2']))
-        @mdoc.stubs(:get_block_by_anyname).with('source2').returns(OpenStruct.new(reqs: []))
+        @mdoc.stubs(:get_block_by_anyname)
+             .with('source1').returns(OpenStruct.new(reqs: ['source2']))
+        @mdoc.stubs(:get_block_by_anyname)
+             .with('source2').returns(OpenStruct.new(reqs: []))
 
         expected = { 'source1' => ['source2'], 'source2' => [] }
         assert_equal expected, @mdoc.collect_dependencies('source1')
@@ -535,14 +561,17 @@ if $PROGRAM_NAME == __FILE__
       end
 
       def test_fcbs_per_options
-        opts = { hide_blocks_by_name: true, block_name_hidden_match: 'block1' }
+        opts = { hide_blocks_by_name: true,
+                 block_name_hidden_match: 'block1' }
         result = @doc.fcbs_per_options(opts)
         assert_equal [@table[1], @table[2]], result
       end if false ### broken test
 
       def test_recursively_required
         result = @doc.recursively_required_hash('block3')
-        assert_equal ({ 'block3' => ['block1'], 'block1' => ['block2'], 'block2' => nil }),
+        assert_equal ({ 'block3' => ['block1'],
+                        'block1' => ['block2'],
+                        'block2' => nil }),
                      result
 
         result_no_reqs = @doc.recursively_required_hash(nil)
@@ -585,8 +614,9 @@ if $PROGRAM_NAME == __FILE__
         # Test case 3: blocks with missing wraps
         assert_equal(
           %w[block4],
-          @mdoc.collect_wrapped_blocks([OpenStruct.new(oname: 'block4',
-                                                       wraps: ['wrap4'])]).map(&:oname)
+          @mdoc.collect_wrapped_blocks(
+            [OpenStruct.new(oname: 'block4', wraps: ['wrap4'])]
+          ).map(&:oname)
         )
       end
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: markdown_exec
 version: !ruby/object:Gem::Version
-  version: 2.8.0
+  version: 2.8.1
 platform: ruby
 authors:
 - Fareed Stevenson
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-10 00:00:00.000000000 Z
+date: 2025-02-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: clipboard
@@ -108,6 +108,10 @@ files:
 - assets/select_a_file.png
 - bats/bats.bats
 - bats/block-type-opts.bats
+- bats/block-type-ux-auto.bats
+- bats/block-type-ux-exec.bats
+- bats/block-type-ux-row-format.bats
+- bats/block-type-ux-transform.bats
 - bats/block-type-vars.bats
 - bats/block-types.bats
 - bats/border.bats
@@ -139,6 +143,10 @@ files:
 - docs/dev/block-type-bash.md
 - docs/dev/block-type-opts.md
 - docs/dev/block-type-port.md
+- docs/dev/block-type-ux-auto.md
+- docs/dev/block-type-ux-exec.md
+- docs/dev/block-type-ux-row-format.md
+- docs/dev/block-type-ux-transform.md
 - docs/dev/block-type-vars.md
 - docs/dev/border.md
 - docs/dev/command-substitution.md