markdown_exec 3.3.0 → 3.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a1b653c2db50fe8b7a8de3ea448a49d814b0210fd90090f06b829f30465dc313
-  data.tar.gz: e48016ab6903bf7967c575fa5f3c84893bf2ffb7e35b5b00788a59b5de2257e5
+  metadata.gz: ec9a613148346890f4db46f3f5bdcade05b8e2221e92402c431fa9a359556e1e
+  data.tar.gz: 05d16eaf1ac5d433c8da62513da88159313e3b2898d36d7dfa0d71061c83a97b
 SHA512:
-  metadata.gz: 8e34466abddbda4228bb45d6bfb75e18e3bf4f9fc664a38eaa89aed3d93aceb0b042463854f02a4c0bb9ccf51e2d03226247e2a5c247315d1bb65954b3635739
-  data.tar.gz: 77bf12764fe5bf436d270a3d8c1763de469fae4fb6741714dedd1d400bb2e11d1fbeb2811cf062460fdd9cfe05ef2a32e9b6bd83b3e77e3f7f720d808a3472ed
+  metadata.gz: 9dcec89e521fc194eb329b36dc83068a11215186c5e3e5447485000a40c8e75f8bdabd10824af34b9ff90fee3f0899d5bb0f82f76f4ffa3a0a950d213585e6a5
+  data.tar.gz: 06b8fb5443b026e628fd60962bd9c7abbccd78824ea0d0b001f27b4608cc0cb147fff6fa00eac5de3712ed97f76d50296b35368675478992e06b28db06b29dfc

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [3.4.0] - 2025-09-16
+
+### Added
+
+- Accept line continuation for an import directive.
+- Debug methods for block form and direct evaluation
+- Color families indicate related functionality.
+
+### Changed
+
+- Size table columns to fit.
+- Name key is not required for all UX blocks. Display the formatted string if specified. Display the last key in the echo or exec hash otherwise.
+
 ## [3.3.0] - 2025-09-02
 
 ### Added

data/Gemfile.lock

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

data/Rakefile

@@ -146,7 +146,8 @@ task :minitest do
     './lib/saved_assets.rb --verbose',
     './lib/saved_files_matcher.rb --verbose',
     './lib/table_extractor.rb --verbose',
-    './lib/text_analyzer.rb --verbose'
+    './lib/text_analyzer.rb --verbose',
+    './lib/ww.rb --verbose'
   ]
 
   execute_with_error_handling(commands) do |command|

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

@@ -4,5 +4,5 @@ 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'
+   'v1 = _v2 = _v3 = 12_v4 = 21_v5 = markdown_exec__v6 = 31'
 }

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

@@ -4,5 +4,5 @@ load 'test_helper'
 
 @test 'Initial values' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-ux-default.md \
-   'v1 = _v2 = 11_v3 = 12_v4 = 21_v5 = markdown_exec_v6 = 31'
+   'v1 = _v2 = 11_v3 = 12_v4 = 21_v5 = markdown_exec__v6 = 31'
 }

data/bats/block-type-ux-echo-hash.bats

@@ -4,11 +4,11 @@ load 'test_helper'
 
 @test 'an automatic block sets multiple variables' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-ux-echo-hash.md \
-   'BASENAME=markdown_exec_DOCUMENTS=markdown_OPERATION=exec_Load Tapanuli Orangutan_Load Psychedelic Frogfish_| Variable | Value |_| -------- | ----- |_| Species  |       |_| Genus    |       |_| Family   |   |'
+   'BASENAME=markdown_exec_DOCUMENTS=markdown_OPERATION=exec_Load Tapanuli Orangutan_Load Psychedelic Frogfish_| Variable | Value |_| -------- | ----- |_| Species  |   |_| Genus    |       |_| Family   |   |'
 }
 
 @test 'an activated block sets multiple variables' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-ux-echo-hash.md \
    'Load Tapanuli Orangutan' \
-   'BASENAME=markdown_exec_DOCUMENTS=markdown_OPERATION=exec_Load Tapanuli Orangutan_Load Psychedelic Frogfish_| Variable | Value               |_| -------- | ------------------- |_| Species  | Pongo tapanuliensis |_| Genus    | Pongo               |_| Family   | Hominidae       |'
+   'BASENAME=markdown_exec_DOCUMENTS=markdown_OPERATION=exec_Load Tapanuli Orangutan_Load Psychedelic Frogfish_| Variable | Value                   |_| -------- | ----------------------- |_| Species  | Pongo tapanuliensis |_| Genus    | Pongo                   |_| Family   | Hominidae           |'
 }

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

@@ -4,12 +4,12 @@ load 'test_helper'
 
 @test 'automatic' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-ux-exec-hash.md \
-   'A single named variable is set automatically as the_output of the exec string._Common_Name=Yeti Crab_Common_Name=Yeti Crab_ Y  e  t  i     C  r  a  b  _ _ 59 65 74 69 20 43 72 61 62 0A__Multiple variables are set automatically as the_output of each exec string._One variable is temporary/not stored to inherited lines_but available for calculations within the block._Domain=ukaryota____D=_Domain=ukaryota_ u  k  a  r  y  o  t  a  _   _ _ 75 6B 61 72 79 6F 74 61 0A 0A__A single named variable is set interactively as the_output of the exec string._Year_Discovered=_Year_Discovered=_$(hexdump_format "$Year_Discovered")__Multiple variables are set interactively as the_output of the exec string._Genus=_Species=_$(hexdump_format "$Species")_Genus=_$(hexdump_format "$Genus")__A single named variable is set automatically as the_first line of the output of the first element in the echo_hash._Kingdom=Animalia_Kingdom=Animalia_ A  n  i  m  a  l  i  a_ 41 6E 69 6D 61 6C 69 61__A single named variable is set automatically as the_first line of the output of the first element in the exec_hash._Class=Malacostraca_Class=Malacostraca_ M  a  l  a  c  o  s  t  r  a  c  a_ 4D 61 6C 61 63 6F 73 74 72 61 63 61'
+   'A single named variable is set automatically as the_output of the exec string._Common_Name=Yeti Crab__Common_Name=Yeti Crab_ Y  e  t  i     C  r  a  b  _ _ 59 65 74 69 20 43 72 61 62 0A__Multiple variables are set automatically as the_output of each exec string._One variable is temporary/not stored to inherited lines_but available for calculations within the block._Domain=ukaryota_____D=_Domain=ukaryota_ u  k  a  r  y  o  t  a  _   _ _ 75 6B 61 72 79 6F 74 61 0A 0A__A single named variable is set interactively as the_output of the exec string._Year_Discovered=_Year_Discovered=_$(hexdump_format "$Year_Discovered")__Multiple variables are set interactively as the_output of the exec string._Genus=_Species=_$(hexdump_format "$Species")_Genus=_$(hexdump_format "$Genus")__A single named variable is set automatically as the_first line of the output of the first element in the echo_hash._Kingdom=Animalia_Kingdom=Animalia_ A  n  i  m  a  l  i  a_ 41 6E 69 6D 61 6C 69 61__A single named variable is set automatically as the_first line of the output of the first element in the exec_hash._Class=Malacostraca_Class=Malacostraca_ M  a  l  a  c  o  s  t  r  a  c  a_ 4D 61 6C 61 63 6F 73 74 72 61 63 61'
 }
 
 @test 'interactive' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-ux-exec-hash.md \
    '[Year_Discovered]' \
    '[Genus]' \
-   'A single named variable is set automatically as the_output of the exec string._Common_Name=Yeti Crab_Common_Name=Yeti Crab_ Y  e  t  i     C  r  a  b  _ _ 59 65 74 69 20 43 72 61 62 0A__Multiple variables are set automatically as the_output of each exec string._One variable is temporary/not stored to inherited lines_but available for calculations within the block._Domain=ukaryota____D=_Domain=ukaryota_ u  k  a  r  y  o  t  a  _   _ _ 75 6B 61 72 79 6F 74 61 0A 0A__A single named variable is set interactively as the_output of the exec string._Year_Discovered=2005_Year_Discovered=2005_ 2  0  0  5  _ _ 32 30 30 35 0A__Multiple variables are set interactively as the_output of the exec string._Genus=Kiwa__Species=Kiwa hirsuta_ K  i  w  a     h  i  r  s  u  t  a  _ _ 4B 69 77 61 20 68 69 72 73 75 74 61 0A_Genus=Kiwa_ K  i  w  a  _   _ _ 4B 69 77 61 0A 0A__A single named variable is set automatically as the_first line of the output of the first element in the echo_hash._Kingdom=Animalia_Kingdom=Animalia_ A  n  i  m  a  l  i  a_ 41 6E 69 6D 61 6C 69 61__A single named variable is set automatically as the_first line of the output of the first element in the exec_hash._Class=Malacostraca_Class=Malacostraca_ M  a  l  a  c  o  s  t  r  a  c  a_ 4D 61 6C 61 63 6F 73 74 72 61 63 61'
+   'A single named variable is set automatically as the_output of the exec string._Common_Name=Yeti Crab__Common_Name=Yeti Crab_ Y  e  t  i     C  r  a  b  _ _ 59 65 74 69 20 43 72 61 62 0A__Multiple variables are set automatically as the_output of each exec string._One variable is temporary/not stored to inherited lines_but available for calculations within the block._Domain=ukaryota_____D=_Domain=ukaryota_ u  k  a  r  y  o  t  a  _   _ _ 75 6B 61 72 79 6F 74 61 0A 0A__A single named variable is set interactively as the_output of the exec string._Year_Discovered=2005__Year_Discovered=2005_ 2  0  0  5  _ _ 32 30 30 35 0A__Multiple variables are set interactively as the_output of the exec string._Genus=Kiwa___Species=Kiwa hirsuta_ K  i  w  a     h  i  r  s  u  t  a  _ _ 4B 69 77 61 20 68 69 72 73 75 74 61 0A_Genus=Kiwa_ K  i  w  a  _   _ _ 4B 69 77 61 0A 0A__A single named variable is set automatically as the_first line of the output of the first element in the echo_hash._Kingdom=Animalia_Kingdom=Animalia_ A  n  i  m  a  l  i  a_ 41 6E 69 6D 61 6C 69 61__A single named variable is set automatically as the_first line of the output of the first element in the exec_hash._Class=Malacostraca_Class=Malacostraca_ M  a  l  a  c  o  s  t  r  a  c  a_ 4D 61 6C 61 63 6F 73 74 72 61 63 61'
 }

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

@@ -4,5 +4,5 @@ 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'"
+   "ux0=_ux1=Unknown_ux2=markdown_exec__ux3=markdown_exec__ux4=Xform: 'markdown'"
 }

data/bats/block-type-ux-no-name.bats

@@ -0,0 +1,8 @@
+#!/usr/bin/env bats
+
+load 'test_helper'
+
+@test 'displays last key in hash' {
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-ux-no-name.md \
+   'OPERATION1=exec_OPERATION2=exec__'
+}

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

@@ -4,5 +4,5 @@ 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 tapanuliensis   | New species?       |_   | Name: Genus | Value: Xform: 'Pongo' | Prompt: New genus? |_   | Family      | Hominidae             | Enter a value: |"
+   "   | Variable    | Value                 | Prompt                 |_   | ----------- | --------------------- | ---------------------- |_   | Species     | Pongo tapanuliensis   | New species?       |_   | Name: Genus | Value: Xform: 'Pongo' | Prompt: New genus? |_   | Family      | Hominidae             | Enter a value:     |"
 }

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_Genus: Illacme'
+}

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/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-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-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,6 @@
+@import ./import/parameter-symbols.md \
+        __PS_STEM_SPECIES:q='Illacme tobini' \
+        __PS_STEM_GENUS:q=Illacme \
+        PS_STEM=U1
+Genus: ${__U1_GENUS}
+@import bats-document-configuration.md

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/lib/cached_nested_file_reader.rb

@@ -89,10 +89,22 @@ 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
+        Regexp.new(@import_directive_line_pattern) =~ line
         name_strip = $~[:name].strip
         params_string = $~[:params] || ''
         import_indention = indention + $~[:indention]
@@ -101,9 +113,9 @@ class CachedNestedFileReader
         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 +173,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)

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'],
@@ -394,7 +402,7 @@ module MarkdownExec
         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

data/lib/format_table.rb

@@ -142,10 +142,10 @@ module MarkdownTableFormatter
 
   def format_table__hs(
     column_count:,
+    decorate: nil,
     lines:,
+    max_table_width: nil,
     table:,
-    decorate: nil,
-    table_width: nil,
     truncate: true
   )
     unless column_count.positive?
@@ -162,13 +162,26 @@ module MarkdownTableFormatter
     alignment_indicators, column_widths =
       calculate_column_alignment_and_widths(rows, column_count)
 
-    unless table_width.nil?
-      sum_column_widths = column_widths.sum + ((column_count * 3) + 5)
-      if sum_column_widths > table_width
-        ratio = table_width.to_f / sum_column_widths
+    unless max_table_width.nil?
+      # each column has a frame width of 3 characters
+      # border and space before and after each and 1 final border
+      borders_width = (column_count * 3) + 1
+
+      full_column_table_width = column_widths.sum + borders_width
+
+      if full_column_table_width > max_table_width
+        text_width_sum = full_column_table_width - borders_width
+        available_text_width = max_table_width - borders_width
+        ratio = available_text_width.to_f / text_width_sum
+
+        # distribute the width across the columns
         column_widths.each_with_index do |width, i|
           column_widths[i] = (width * ratio).to_i
         end
+
+        # the last column fills the remaining width
+        column_widths[column_widths.count - 1] =
+          available_text_width - column_widths.sum + column_widths.last
       end
     end
 
@@ -238,6 +251,7 @@ end
 return if $PROGRAM_NAME != __FILE__
 
 require 'minitest/autorun'
+require_relative 'ww'
 
 class TestMarkdownTableFormatter < Minitest::Test
   def setup
@@ -377,7 +391,8 @@ class TestFormatTable < Minitest::Test
   #     "| A | B | C ",
   #     "| 1 | 2 | 3 "
   #   ]
-  #   assert_equal expected, MarkdownTableFormatter.format_table(lines, column_count)
+  #   assert_equal expected,
+  #    MarkdownTableFormatter.format_table(lines, column_count)
   # end
 
   def test_empty_input

data/lib/hash_delegator.rb

@@ -325,8 +325,8 @@ module HashDelegatorSelf
           separator_line: delegate_object[:table_separator_line_color]
         },
         lines: lines,
+        max_table_width: screen_width_for_table,
         table: table,
-        table_width: screen_width_for_table,
         truncate: $table_cell_truncate
       )
 

data/lib/markdown_exec/version.rb

@@ -8,5 +8,5 @@ module MarkdownExec
   BIN_NAME = 'mde'
   GEM_NAME = 'markdown_exec'
   TAP_DEBUG = 'MDE_DEBUG'
-  VERSION = '3.3.0'
+  VERSION = '3.4.0'
 end