markdown_exec 3.3.0 → 3.5.0

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

@@ -4,5 +4,5 @@ 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_ 6d 61 72 6b 64 6f 77 6e 5f 65 78 65 63 0a      __With validate and transform, output has no newline._Var1=markdown_exec_ 6d 61 72 6b 64 6f 77 6e 5f 65 78 65 63         __With transform :chomp, output has no newline._Var2=markdown_exec_ 6d 61 72 6b 64 6f 77 6e 5f 65 78 65 63         __With transform :upcase, output is in upper case w/ newline._Var3=MARKDOWN_EXEC_ 4d 41 52 4b 44 4f 57 4e 5f 45 58 45 43 0a      '
+  '_Execution output has a trailing newline._Var0=markdown_exec__ 6d 61 72 6b 64 6f 77 6e 5f 65 78 65 63 0a      __With validate and transform, output has no newline._Var1=markdown_exec_ 6d 61 72 6b 64 6f 77 6e 5f 65 78 65 63         __With transform :chomp, output has no newline._Var2=markdown_exec_ 6d 61 72 6b 64 6f 77 6e 5f 65 78 65 63         __With transform :upcase, output is in upper case w/ newline._Var3=MARKDOWN_EXEC__ 4d 41 52 4b 44 4f 57 4e 5f 45 58 45 43 0a      '
 }

data/bats/command-substitution-options.bats

@@ -5,10 +5,10 @@ load 'test_helper'
 @test 'Operator $' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/command-substitution-options.md \
    'operator_$' \
-   'Command substitution__The current value of environment variable Common_Name_is displayed using two different operators._The command echo $SHLVL is executed via command_substitution, using two different operators.__| Operato | Variable Expansio | Command Substitutio |_| ------- | ----------------- | ------------------- |_| $       | Tapanuli Oranguta | Pongo tapanuliensis |_| @       | @{Common_Name}    | @(echo $Species)    |__Toggle between operators.__operator_$__operator_@'
+   'Command substitution__The current value of environment variable Common_Name_is displayed using two different operators._The command echo $SHLVL is executed via command_substitution, using two different operators.__| Operator | Variable Expansion | Command Substitution |_| -------- | ------------------ | -------------------- |_| $        | Tapanuli Orangutan | Pongo tapanuliensis  |_| @        | @{Common_Name}     | @(echo $Species)     |__Toggle between operators.__operator_$__operator_@'
 }
 
 @test 'Operator @' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/command-substitution-options.md \
-   'Command substitution__The current value of environment variable Common_Name_is displayed using two different operators._The command echo $SHLVL is executed via command_substitution, using two different operators.__| Operato | Variable Expansio | Command Substitutio |_| ------- | ----------------- | ------------------- |_| $       | ${Common_Name}    | $(echo $Species)    |_| @       | Tapanuli Oranguta | Pongo tapanuliensis |__Toggle between operators.__operator_$__operator_@'
+   'Command substitution__The current value of environment variable Common_Name_is displayed using two different operators._The command echo $SHLVL is executed via command_substitution, using two different operators.__| Operator | Variable Expansion | Command Substitution |_| -------- | ------------------ | -------------------- |_| $        | ${Common_Name}     | $(echo $Species)     |_| @        | Tapanuli Orangutan | Pongo tapanuliensis  |__Toggle between operators.__operator_$__operator_@'
 }

data/bats/import-directive-line-continuation.bats

@@ -0,0 +1,9 @@
+#!/usr/bin/env bats
+
+load 'test_helper'
+
+@test '' {
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/import-directive-line-continuation.md \
+   --blocks dname \
+   'Stem: U1_Species: Illacme tobini'
+}

data/bats/import-directive-parameter-symbols.bats

@@ -5,5 +5,5 @@ load 'test_helper'
 @test '' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/import-directive-parameter-symbols.md \
    --blocks dname \
-   'Stem: U1_Species: Illacme tobini_Genus: Illacme_Stem: U2_Species: Hydrodynastes bicinctus_Genus: Hydrodynastes'
+   'Stem: U1_Species: Illacme tobini_Stem: U2_Species: Hydrodynastes bicinctus'
 }

data/bats/import-parameter-symbols.bats

@@ -4,5 +4,5 @@ load 'test_helper'
 
 @test 'Initial values' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/import-parameter-symbols.md \
-   'COMMON_NAME=Tapanuli Orangutan_Command substitution: Tapanuli Orangutan_echo "Command substitution: ${NAMEC}"__Evaluated expression: Tapanuli Orangutan_echo "Evaluated expression: ${NAMEE}"__Raw literal: Tapanuli Orangutan_echo "Raw literal: Tapanuli Orangutan"__Force-quoted literal: Tapanuli Orangutan_echo "Force-quoted literal: ${NAMEQ}"__Variable reference: Tapanuli Orangutan_echo "Variable reference: ${COMMON_NAME}"'
+   'COMMON_NAME=Tapanuli Orangutan_Evaluated expression: Tapanuli Orangutan_echo "Evaluated expression: $(printf %s "$COMMON_NAME")"__Raw literal: Tapanuli Orangutan_echo "Raw literal: Tapanuli Orangutan"__Force-quoted literal: Tapanuli Orangutan_echo "Force-quoted literal: Tapanuli Orangutan"__Variable reference: Tapanuli Orangutan_echo "Variable reference: ${COMMON_NAME}"'
 }

data/bats/option-expansion.bats

@@ -4,5 +4,5 @@ load 'test_helper'
 
 @test '' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/option-expansion.md \
-   '_| Optio | Description                      | Value | Va | Def |_| ----- | -------------------------------- | ----- | -- | --- |_| scree | Screen width for document and in | 2     | 64 | 0   |_| table |                                  | 5     | fa | tru |'
+   '_| Opti | Description                  | Valu | Va | Defau |_| ---- | ---------------------------- | ---- | -- | ----- |_| scre | Screen width for document an | 2    | 64 | 0     |_| tabl |                              | 5    | fa | true  |'
 }

data/bats/options.bats

@@ -30,13 +30,13 @@ load 'test_helper'
 @test 'Options - list blocks' {
   BATS_OUTPUT_FILTER=A
   spec_mde_args_expect --list-blocks-message oname --list-blocks-type 0 examples/colors.md --list-blocks \
-   'load_colors load_colors2  Bash1 Edit1 History1 Link1 Load1 Opts1 Port1 Save1 Vars1'
+   'load_colors load_colors2 Unspecified1 Unknown1 Bash1 Edit-inherited-blocks History1 Link1 Load1 Opts1 Port1 Save1  Vars1'
 }
 
 @test 'Options - list blocks, eval' {
   BATS_OUTPUT_FILTER=A
   spec_mde_args_expect --list-blocks-eval block.oname examples/colors.md --list-blocks \
-   'load_colors load_colors2  Bash1 Edit1 History1 Link1 Load1 Opts1 Port1 Save1 Vars1'
+   'load_colors load_colors2 Unspecified1 Unknown1 Bash1 Edit-inherited-blocks History1 Link1 Load1 Opts1 Port1 Save1  Vars1'
 }
 
 @test 'Options - how' {

data/bats/table-column-truncate.bats

@@ -4,5 +4,5 @@ load 'test_helper'
 
 @test 'Tables - truncate columns' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/table-column-truncate.md \
-   'DEMONSTRATE TRUNCATION OF TEXT IN TABLE CELLS__| Common Name  | Species      | Genus |  Family | Year Di |_| ------------ | ------------ | ----- | ------- | ------- |_| Tapanuli Ora | Pongo tapanu | Pongo | Hominid |  2017   |_| Psychedelic  | Histiophryne | Histi | Antenna |  2009   |_| Ruby Seadrag | Phyllopteryx | Phyll | Syngnat |  2015   |_| Illacme tobi | Illacme tobi | Illac | Siphono |  2016   |_| Spiny Dandel | Taraxacum ja | Tarax | Asterac |  2022   |_'
+   'DEMONSTRATE TRUNCATION OF TEXT IN TABLE CELLS__| Common Name         | Species            | Genus    |      Family | Year Discover |_| ------------------- | ------------------ | -------- | ----------- | ------------- |_| Tapanuli Orangutan  | Pongo tapanuliensi | Pongo    |   Hominidae |     2017      |_| Psychedelic Frogfis | Histiophryne psych | Histioph | Antennariid |     2009      |_| Ruby Seadragon      | Phyllopteryx dewys | Phyllopt | Syngnathida |     2015      |_| Illacme tobini (Mil | Illacme tobini     | Illacme  | Siphonorhin |     2016      |_| Spiny Dandelion     | Taraxacum japonicu | Taraxacu |  Asteraceae |     2022      |_'
 }

data/bats/table.bats

@@ -4,7 +4,7 @@ load 'test_helper'
 
 @test 'Tables - indented' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/table-indent.md \
-   'DEMONSTRATE TABLE INDENTATION__Table flush at left._Centered columns._|    Common Name     |        Species         |   Genus    |   Family    | Year Discover |_| ------------------ | ---------------------- | ---------- | ----------- | ------------- |_| Tapanuli Orangutan |  Pongo tapanuliensis   |   Pongo    |  Hominidae  |     2017      |_| Psychedelic Frogfi | Histiophryne psychedel | Histiophry | Antennariid |     2009      |_|   Ruby Seadragon   |  Phyllopteryx dewysea  | Phyllopter | Syngnathida |     2015      |__  Table indented with two spaces._  Left-justified columns._  | Common Name               | Species       | Genus  | Family         | Year Discovere |_  | ------------------------- | ------------- | ------ | -------------- | -------------- |_  | Illacme tobini (Millipede | Illacme tobin | Illacm | Siphonorhinida | 2016           |__    Table indented with one tab._    Right-justified columns._    |     Common Name |             Species |     Genus |     Family | Year Discovered |_    | --------------- | ------------------- | --------- | ---------- | --------------- |_    | Spiny Dandelion | Taraxacum japonicum | Taraxacum | Asteraceae |            2022 |'
+   'DEMONSTRATE TABLE INDENTATION__Table flush at left._Centered columns._|    Common Name     |         Species         |    Genus    |    Family    | Year Discovered |_| ------------------ | ----------------------- | ----------- | ------------ | --------------- |_| Tapanuli Orangutan |   Pongo tapanuliensis   |    Pongo    |  Hominidae   |      2017       |_| Psychedelic Frogfi | Histiophryne psychedeli | Histiophryn | Antennariida |      2009       |_|   Ruby Seadragon   |  Phyllopteryx dewysea   | Phylloptery | Syngnathidae |      2015       |__  Table indented with two spaces._  Left-justified columns._  | Common Name                | Species        | Genus   | Family          | Year Discovered |_  | -------------------------- | -------------- | ------- | --------------- | --------------- |_  | Illacme tobini (Millipede) | Illacme tobini | Illacme | Siphonorhinidae | 2016            |__    Table indented with one tab._    Right-justified columns._    |     Common Name |             Species |     Genus |     Family | Year Discovered |_    | --------------- | ------------------- | --------- | ---------- | --------------- |_    | Spiny Dandelion | Taraxacum japonicum | Taraxacum | Asteraceae |            2022 |'
 }
 
 @test 'Tables - invalid' {

data/bats/test_helper.bash

@@ -7,6 +7,7 @@ EXIT_MENU=__Exit # name of menu Exit option
 #     • expected byte (0xHEX) and printable character (or “.”)
 #     • actual   byte (0xHEX) and printable character (or “.”)
 compare_bytes () {
+  readonly line_count=16
   set +e
   local mode="$1"; shift
   if [[ "$mode" == "--file" ]]; then
@@ -19,13 +20,13 @@ compare_bytes () {
     # feed the two strings into cmp via process-substitution
     cmp --verbose <(printf '%s' "$live") <(printf '%s' "$expect")
   fi |
-  head -n 3 |
+  head -n $line_count |
   gawk '{
     live = strtonum(0 $2)
     expect = strtonum(0 $3)
     offset = $1 - 1
-    printf "Offset 0x%X (%4d): output \"%c\" 0x%02X (%3d) vs expect \"%c\" 0x%02X (%3d)\n", \
-           offset, offset, live, live, live, expect, expect, expect
+    printf "Offset 0x%X (%4d): expect \"%c\" 0x%02X (%3d) vs output \"%c\" 0x%02X (%3d)\n", \
+           offset, offset, expect, expect, expect, live, live, live
   }'
   set -e
 }

data/docs/dev/block-type-shell-require-ux.md

@@ -0,0 +1,18 @@
+/ No blocks are evaluated at initialization.
+/ When the shell block is activated, the UX block is required.
+```bash :require-a-UX-block +[ux1]
+ENTITY='Mythical Monkey'
+```
+/ Display variables set in the UX block.
+${FIRST}
+${LAST}
+/ Parse and copy the name into variables.
+```ux :[ux1]
+echo:
+  FIRST: '${ENTITY%% *}'
+  LAST: '${ENTITY##* }'
+  FULL_NAME: '$ENTITY'
+init: false
+readonly: true
+```
+@import bats-document-configuration.md

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

@@ -0,0 +1,10 @@
+/ v2025-06-28
+/ Demonstrate using a format key does not inhibit activation of the same block
+/
+```ux
+act: :echo
+echo: '`date`'
+format: 'Date: ${DATE}'
+name: DATE
+```
+@import bats-document-configuration.md

data/docs/dev/block-type-ux-no-name.md

@@ -0,0 +1,17 @@
+/ This automatic block sets multiple variables and displays the first variable.
+```ux
+echo:
+  BASENAME1: "$(basename `pwd`)"
+  DOCUMENTS1: "${BASENAME1%%_*}"
+  OPERATION1: "${BASENAME1##*_}"
+```
+```ux
+exec:
+  BASENAME2: >-
+    basename `pwd`
+  DOCUMENTS2: >-
+    echo "${BASENAME2%%_*}"
+  OPERATION2: >-
+    echo "${BASENAME2##*_}"
+```
+@import bats-document-configuration.md

data/docs/dev/block-type-ux-require-context.md

@@ -0,0 +1,32 @@
+/ Neither block is evaluated at initialization.
+/ When the first UX block is activated, it is evaluated.
+/ The variable set in the first UX block is available to the second,
+/ which is required by the first, resulting in its evaluation.
+```ux :[ux1] +[ux2] +(ENTITY)
+act: :echo
+echo:
+  UX1: '$ENTITY'
+format: |-
+  Get the common name...
+init: false
+```
+/ The shell required code and the first evaluated UX block are the context
+/ when the the `echo` expressions are being evaluated in the second UX block.
+/ The first evaluated UX block is the context when the `format` value is being expanded.
+```ux :[ux2]
+act: :echo
+echo:
+  UX2: '$UX1'
+  ENTITY2: '$ENTITY'
+format: |-
+  Entity: ${ENTITY}
+  ENTITY2: ${ENTITY2}
+  UX1: ${UX1}
+  Common name: ${UX2}
+init: false
+readonly: true
+```
+```bash :(ENTITY)
+ENTITY='Mythical Monkey'
+```
+@import bats-document-configuration.md

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

@@ -1,7 +1,3 @@
-/ This is an hidden shell block that is required by UX blocks.
-``` :(shell)
-ENTITY='Pongo tapanuliensis,Pongo'
-```
 ```ux +(shell)
 echo: "${ENTITY%%,*}"
 force: true
@@ -24,6 +20,14 @@ echo: "$NAME"
 force: true
 name: NAME2
 ```
+/
+/ This is a hidden shell block that is required by a UX block.
+/ All shell blocks required by a UX block are collected in a sequence
+/ that is the context for the evaluation of the expressions in the UX block.
+``` :(shell)
+ENTITY='Pongo tapanuliensis,Pongo'
+```
+/
 / This block is not visible. Execute to display the inherited lines for testing.
 ```opts :(menu_with_inherited_lines)
 menu_with_inherited_lines: true

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

@@ -40,7 +40,7 @@ name: Family
 @import bats-document-configuration.md
 ```opts :(document_opts)
 menu_ux_row_format: '| %{name}| ${%{name}}| %{prompt}'
-screen_width: 72
+screen_width: 76
 table_center: true
 ux_auto_load_force_default: true
 ```

data/docs/dev/import-directive-line-continuation.md

@@ -0,0 +1,5 @@
+@import ./import/parameter-symbols.md \
+        __PS_STEM_SPECIES:q='Illacme tobini' \
+        __PS_STEM_GENUS:q=Illacme \
+        PS_STEM=U1
+@import bats-document-configuration.md

data/docs/dev/import-directive-parameter-symbols.md

@@ -1,9 +1,7 @@
 / use MDE 3.3.0 import parameter symbols
 /
 @import ./import/parameter-symbols.md   __PS_STEM_SPECIES:q='Illacme tobini'   __PS_STEM_GENUS:q=Illacme   PS_STEM=U1
-Genus: ${__U1_GENUS}
 /
 @import ./import/parameter-symbols.md   __PS_STEM_SPECIES:q='Hydrodynastes bicinctus'   __PS_STEM_GENUS:q=Hydrodynastes   PS_STEM=U2
-Genus: ${__U2_GENUS}
 /
 @import ./bats-document-configuration.md

data/docs/dev/import-parameter-symbols-template.md

@@ -1,8 +1,10 @@
-**Command substitution:** `NAMEC`
-```bash
-echo "Command substitution: NAMEC"
-```
-
+/ 2025-11-13 the name of the variable generated
+/ changes on every load is not predictable
+/**Command substitution:** `NAMEC`
+/```bash
+/echo "Command substitution: NAMEC"
+/```
+/
 **Evaluated expression:** `NAMEE`
 ```bash
 echo "Evaluated expression: NAMEE"

data/docs/dev/import-parameter-symbols.md

@@ -2,5 +2,13 @@
 echo: Tapanuli Orangutan
 name: COMMON_NAME
 ```
-@import import-parameter-symbols-template.md   NAMEC:c='printf %s "$COMMON_NAME"'   NAMEE:e=$COMMON_NAME   NAMEL="Tapanuli Orangutan"   NAMEQ:q="Tapanuli Orangutan"   NAMEV:v=COMMON_NAME
-@import bats-document-configuration.md
+@import import-parameter-symbols-template.md \
+  NAMEC:cq='printf %s "$COMMON_NAME"' \
+  NAMEE:eq=$COMMON_NAME \
+  NAMEL="Tapanuli Orangutan" \
+  NAMEQ:qq="Tapanuli Orangutan" \
+  NAMEV:vq=COMMON_NAME
+@import bats-document-configuration.md
+```opts :(document_opts)
+dump_inherited_lines: false
+```

data/docs/dev/table-column-truncate.md

@@ -12,6 +12,6 @@
 @import bats-document-configuration.md
 ```opts :(document_opts)
 heading1_center: false
-screen_width: 60
+screen_width: 90
 table_center: false
 ```

data/examples/colors.md

@@ -1,27 +1,19 @@
 # Demo configuring options
-
+/ v2025-09-30
 ::: These Opts blocks set the color for all elements.
-
-<https://en.wikipedia.org/wiki/Complementary_colors#/media/File:RGB_color_wheel.svg>
-
-/ ff0000 red - exception text
-/ ff7f00 orange - warning text
-/ ffff00 yellow - notification text
-/ 7fff00 chartreuse green - output frame
-/ 00ff00 green - prompt
-/ 00ff7f spring green - input frame
-/ 00ffff cyan - menu text
-/ 007fff azure - menu frame
-/ 0000ff blue
-/ 7f00ff violet - opts frame
-/ ff00ff magenta - opts text
-/ ff007f rose - exception frame
-
+/ blue    fg_rgbh_00_00_FF
+/ green   fg_rgbh_00_FF_00
+/ indigo  fg_rgbh_4B_00_82
+/ orange  fg_rgbh_FF_7F_00
+/ red     fg_rgbh_FF_00_00
+/ violet  fg_rgbh_94_00_D3
+/ yellow  fg_rgbh_FF_FF_00
 ```opts :load_colors
 exception_color_detail: fg_rgbh_1f_00_7f
 exception_color_name: fg_rgbh_1f_00_00
 execution_report_preview_frame_color: fg_rgbh_7f_1f_00
 menu_bash_color: fg_rgbh_00_c0_c0
+menu_block_color: fg_rgbh_47_ce_eb
 menu_chrome_color: fg_rgbh_40_c0_c0
 menu_divider_color: fg_rgbh_80_d0_c0
 menu_edit_color: fg_rgbh_e0_e0_20
@@ -44,11 +36,13 @@ script_preview_frame_color: fg_rgbh_7f_1f_00
 warning_color: fg_rgbh_1f_7f_00
 ```
 
+/ more green, less blue
 ```opts :load_colors2
 exception_color_detail: fg_rgbh_ff_00_7f
 exception_color_name: fg_rgbh_ff_00_00
 execution_report_preview_frame_color: fg_rgbh_7f_ff_00
 menu_bash_color: fg_rgbh_00_c0_c0
+menu_block_color: fg_rgbh_47_fe_bb
 menu_chrome_color: fg_rgbh_40_c0_c0
 menu_divider_color: fg_rgbh_80_d0_c0
 menu_edit_color: fg_rgbh_e2_e2_20
@@ -72,12 +66,18 @@ script_preview_frame_color: fg_rgbh_7f_ff_00
 warning_color: fg_rgbh_ff_7f_00
 ```
 
-::: Example blocks
+::: Divider color
+
+::: Fenced code blocks of different types
+Each block has a name. Its name is decorated according to the type of the block.
+``` :Unspecified1
 ```
+```unknown :Unknown1
 ```
 ```bash :Bash1
 ```
-```edit :Edit1
+/ Chrome decoration
+```edit :Edit-inherited-blocks
 ```
 ```history :History1
 ```
@@ -85,20 +85,22 @@ warning_color: fg_rgbh_ff_7f_00
 ```
 ```load :Load1
 ```
+/ Note decoration
+A Note
+/ Opts decoration
 ```opts :Opts1
 ```
 ```port :Port1
 ```
+/ Save decoration
 ```save :Save1
 ```
-```vars :Vars1
+/ Task decoration
+[ ] Task
+/ UX decoration
+```ux
+format: UX-1
 ```
-[ ] Task1
-
-/ blue;    fg_rgbh_00_00_FF
-/ green;   fg_rgbh_00_FF_00
-/ indigo;  fg_rgbh_4B_00_82
-/ orange;  fg_rgbh_FF_7F_00
-/ red;     fg_rgbh_FF_00_00
-/ violet;  fg_rgbh_94_00_D3
-/ yellow;  fg_rgbh_FF_FF_00
+/ Vars decoration
+```vars :Vars1
+```

data/lib/cached_nested_file_reader.rb

@@ -89,21 +89,38 @@ class CachedNestedFileReader
 
     directory_path = File.dirname(filename)
     processed_lines = []
-    File.readlines(filename, chomp: true).each.with_index do |line, ind|
+    continued_line = nil # continued import directive
+    File.readlines(filename, chomp: true).each.with_index do |segment, ind|
       wwt :readline, 'depth:', depth, 'filename:', filename, 'ind:', ind,
-          'line:', line
-      if Regexp.new(@import_directive_line_pattern) =~ line
+          'segment:', segment
+
+      if continued_line || (Regexp.new(@import_directive_line_pattern) =~ segment)
+        line = (continued_line || '') + segment
+        # if segment ends in a continuation, prepend to next line
+        if line.end_with?('\\')
+          continued_line = line.chomp('\\')
+          next
+        end
+
+        continued_line = nil
+
+        # apply substitutions to the @import line
+        line_sub1 = apply_line_substitutions(line, substitutions,
+                                                    use_template_delimiters)
+
+        # parse the @import line
+        Regexp.new(@import_directive_line_pattern) =~ line_sub1
         name_strip = $~[:name].strip
         params_string = $~[:params] || ''
         import_indention = indention + $~[:indention]
-
         # Parse parameters for text substitution
         import_substitutions, add_code = parse_import_params(params_string)
+
         if add_code
           # strings as NestedLines
-          add_lines = add_code.map.with_index do |line, ind2|
+          add_lines = add_code.map.with_index do |line2, ind2|
             nested_line = NestedLine.new(
-              line,
+              line2,
               depth + 1,
               import_indention,
               filename,
@@ -161,7 +178,7 @@ class CachedNestedFileReader
         processed_lines += processed_imported_lines
       else
         # Apply substitutions to the current line
-        substituted_line = apply_line_substitutions(line, substitutions,
+        substituted_line = apply_line_substitutions(segment, substitutions,
                                                     use_template_delimiters)
         nested_line = NestedLine.new(substituted_line, depth, indention,
                                      filename, ind)
@@ -175,6 +192,8 @@ class CachedNestedFileReader
   rescue Errno::ENOENT => err
     warn_format('readlines', "#{err} @@ #{context}",
                 { abort: true })
+  rescue StandardError
+    wwe $!
   end
 
   private
@@ -208,53 +227,14 @@ class CachedNestedFileReader
     scanned_params.each do |key, op, value|
       wwt :import, 'key:', key, 'op:', op, 'value:', value
 
-      # adjust key for current stem value
-      varname = key
-      case op
-      when @symbol_command_substitution,
-           @symbol_evaluated_expression,
-           @symbol_force_quoted_literal,
-           @symbol_variable_reference
-        # perform all substitutions per equal_op_params
-        equal_op_params.each do |equal_key, _equal_op, equal_value|
-          varname = varname.gsub(equal_key, equal_value)
-        end
-        wwt :import_key, 'varname:', varname
-      end
+      require_relative 'parameter_expansion'
+      expansion, new_var = ParameterExpansion.expand_parameter(key, op[1..-2], value)
+      value = expansion
 
-      case op
-      when @symbol_raw_literal
-        # skip replacement of equal values otherwise,
-        # the text is not available for other substitutions
-        next unless key != value
-
-        # replace the literal below
-      when @symbol_command_substitution
-        # add code to set the variable to the value of the parameter
-        add_code += shell_code_block_for_assignment(
-          varname, %($(#{value}))
-        )
-        # replace key with expansion of the added variable
-        value = "${#{varname}}"
-      when @symbol_evaluated_expression
-        # add code to set the variable to the value of the parameter
-        add_code += shell_code_block_for_assignment(
-          varname, %("#{value}")
-        )
-        # replace key with expansion of the added variable
-        value = "${#{varname}}"
-      when @symbol_force_quoted_literal
-        # add code to set the variable to the value of the parameter
+      unless new_var.nil?
         add_code += shell_code_block_for_assignment(
-          varname, Shellwords.escape(value)
+          new_var.name, Shellwords.escape(new_var.assignment_code)
         )
-        # replace key with expansion of the added variable
-        value = "${#{varname}}"
-      when @symbol_variable_reference
-        # variable exists
-        value = "${#{value}}"
-      else
-        wwe "Invalid op '#{op}'"
       end
 
       params[key] = value

data/lib/command_result.rb

@@ -33,11 +33,11 @@ class CommandResult
     exit_status.zero?
   end
 
-  # def new_lines
-  #   value = @attributes[:new_lines]
-  #   ww caller.deref[0..4], value
-  #   value
-  # end
+  def new_lines
+    value = @attributes[:new_lines] || []
+    ww caller.deref[0..4], value
+    value
+  end
 
   # # trap assignment to new_lines
   # def new_lines=(value)

data/lib/constants.rb

@@ -35,7 +35,9 @@ BLOCK_TYPE_COLOR_OPTIONS = {
     :readonly => :menu_ux_color_readonly,
     true => :menu_ux_color
   },
-  BlockType::VARS => :menu_vars_color
+  BlockType::VARS => :menu_vars_color,
+  # default for remaining block types
+  true => :menu_block_color
 }.freeze
 
 COLLAPSIBLE_SYMBOL_COLLAPSED = '⬢' # '<+>' # '∆'

data/lib/fcb.rb

@@ -7,15 +7,23 @@ require_relative 'namer'
 BT_UX_FLD_REQUIRED = 'required'
 def parse_yaml_of_ux_block(
   data,
-  menu_format: nil,
   prompt: nil,
   validate: nil
 )
-  export = data['export']
-  export = data if export.nil?
-  name = export['name']
+  export = data if (export = data['export']).nil?
 
-  raise "Name is missing in UX block: #{data.inspect}" unless name.present?
+  # a single variable name is required to display a single value
+  menu_format = export['format'] || export['menu_format']
+  name = export['name']
+  # if name is missing, use the last key in the echo or exec hashes
+  if !name&.present?
+    name = if export['echo'].is_a? Hash
+             export['echo'].keys.last
+           elsif export['exec'].is_a? Hash
+             export['exec'].keys.last
+           end
+  end
+  raise "Name is missing in UX block: #{data.inspect}" unless name.present? || menu_format.present?
 
   OpenStruct.new(
     act: export['act'],
@@ -25,7 +33,7 @@ def parse_yaml_of_ux_block(
     exec: export['exec'],
     force: export['force'],
     init: export['init'],
-    menu_format: export['format'] || export['menu_format'], # || menu_format,####
+    menu_format: menu_format,
     name: name,
     prompt: export['prompt'] || prompt,
     readonly: export['readonly'].nil? ? false : export['readonly'],
@@ -47,6 +55,7 @@ module MarkdownExec
   class FCB
     def initialize(options = {})
       @attrs = {
+        block: nil,
         body: nil,
         call: nil,
         dname: nil,
@@ -66,6 +75,10 @@ module MarkdownExec
       }.merge(options)
     end
 
+    def append_block_line(line)
+      @attrs[:block].push line
+    end
+
     def pub_name(**kwargs)
       self.class.pub_name(@attrs, **kwargs)
     end
@@ -388,13 +401,13 @@ module MarkdownExec
 
     # calc the decoration sybol for the current block
     def option_to_decorate_ux_block
-      symbol_or_hash = BLOCK_TYPE_COLOR_OPTIONS[@attrs[:type]]
+      symbol_or_hash = BLOCK_TYPE_COLOR_OPTIONS[@attrs[:type]] || BLOCK_TYPE_COLOR_OPTIONS[true]
       if @attrs[:type] == BlockType::UX
         # only UX blocks accept a symbol or a hash
         if symbol_or_hash.is_a? Hash
           # default to the first symbol
           symbol = symbol_or_hash.first.last
-          symbol_or_hash.keys.each do |key|
+          symbol_or_hash.each_key do |key|
             if key == true
               symbol = symbol_or_hash[key]
               break
@@ -518,6 +531,7 @@ if $PROGRAM_NAME == __FILE__
   class FCBTest < Minitest::Test
     def setup
       @fcb_data = {
+        block: nil,
         body: 'Sample body',
         call: 'Sample call',
         dname: 'Sample name',