markdown_exec 2.5.0 → 2.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0135d61b6c609e028c84831074894d55ea4af25f2d130f91b2765ce02fe7956e
-  data.tar.gz: 543e32d24b494c4817555957136a5359b891436f3cd0b63e038d6cb2a931aaa5
+  metadata.gz: c8e475323e8db8b8288c18f8d97f1c52552c0a292854c42ab2780620bcdb8aa5
+  data.tar.gz: 254288c200e344c55f49c5fad1717d46550df1892eb526033180ed066f6c449d
 SHA512:
-  metadata.gz: 11d0152dcf05d9483a12d0e9b8b599a3e80494f5be3a902e4a0092c79a2529746aaca5579f1b3031d55a44bf4771e7d0dd397e77afee08db01caf997b44e6a8f
-  data.tar.gz: 1ab1545d4ceb4579287260a5e13d717677056430ee162e1ce6eb0f7b1f4528327d372381e78d48abd59f46e21739fe16ace5f3e0c249f6647f95afa4dfc55316
+  metadata.gz: b5a6372f45da7c45ae20b0c65058347c66fa17b7afffbacb63f0000c52ff0efd99e18a22f826e7803a1f130868a1dcf0b2f59b48279d19bb1326709a2dc3c04a
+  data.tar.gz: 4308b84a0591e44e5e2d317c6f0c5cd7b6d74848f91a65aaf85897058321ca041113ee80889313d2b0c1a31a587796af708879f3cd3b169a976755f6cce879c9

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [2.6.0] - 2024-11-27
+
+### Added
+
+- Ability to collapse and expand sections.
+- Collapsible state configurable per document and per section.
+- User can collapse and expand sections in the UI.
+- Live shell variable expansion in document text and block content.
+- Option for name of function to manage executed scripts.
+
+### Changed
+
+- Tables are indented per the source.
+- BATS test helper functions.
+
 ## [2.5.0] - 2024-10-27
 
 ### Added

data/Gemfile.lock

@@ -1,12 +1,12 @@
 PATH
   remote: .
   specs:
-    markdown_exec (2.5.0)
+    markdown_exec (2.6.0)
       clipboard (~> 1.3.6)
       open3 (~> 0.1.1)
       optparse (~> 0.1.1)
       tty-prompt (~> 0.23.1)
-      yaml (~> 0.2.0)
+      yaml (>= 0.2.0)
 
 GEM
   remote: https://rubygems.org/

data/Rakefile

@@ -79,16 +79,16 @@ task :bats do
   FileList['bats/**/*.bats'].each do |file|
     next if %w[bats/bats.bats bats/fail.bats].include?(file)
 
-    system "bats #{file}"
+    # temporary clear WW to disable debugging
+    # WW pollutes output expected by BATS tests
+    system "unset WW; bats #{file}"
   end
 end
 
 desc 'minitest'
 task :minitest do
   commands = [
-    './lib/append_to_bash_history.rb',
     './lib/argument_processor.rb',
-    './lib/block_label.rb',
     './lib/cached_nested_file_reader.rb',
     './lib/directory_searcher.rb',
     './lib/evaluate_shell_expressions.rb',

data/bats/block-types.bats

@@ -51,15 +51,14 @@ load 'test_helper'
 
 @test 'Opts block - before' {
   skip 'Fails because command executes after the block is processed'
-  BATS_OUTPUT_FILTER=A
-  spec_mde_args_expect docs/dev/block-type-opts.md --list-blocks-message dname --list-blocks-type 3 --list-blocks \
-   'BEFORE Species menu_note_format: "AFTER %{line}" '
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-opts.md \
+   'BEFORE Species_menu_note_format: "AFTER %{line}" '
 }
 
 @test 'Opts block - after' {
-  BATS_OUTPUT_FILTER=A
-  spec_mde_args_expect docs/dev/block-type-opts.md --list-blocks-message dname --list-blocks-type 3 '[decorate-note]' --list-blocks \
-   'AFTER Species menu_note_format: "AFTER %{line}"'
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-opts.md \
+   '[decorate-note]' \
+   'AFTER Species_menu_note_format: "AFTER %{line}"'
 }
 
 @test 'Opts block - show that menu has changed' {
@@ -85,9 +84,16 @@ load 'test_helper'
 
 # Type: Vars
 
+# includes output from automatic vars block
+@test 'Vars block - auto load' {
+  BATS_OUTPUT_FILTER=A
+  spec_mde_args_expect docs/dev/block-type-vars.md show \
+   'Species = Not specified  Species: Not specified VAULT:'
+}
+
 # includes output from assignment and from shell block
 @test 'Vars block - set variable' {
   BATS_OUTPUT_FILTER=A
   spec_mde_args_expect docs/dev/block-type-vars.md '[set_vault_1]' show \
-   'VAULT = 1  VAULT: 1'
+   'Species = Not specified VAULT = 1  Species: Not specified VAULT: 1'
 }

data/bats/import.bats

@@ -8,3 +8,9 @@ load 'test_helper'
    --list-blocks-message indent --list-blocks \
    '              '
 }
+
+@test 'Directives - import, missing' {
+  BATS_OUTPUT_FILTER=A
+  spec_mde_args_expect docs/dev/import-missing.md \
+   ' Error: CachedNestedFileReader.readlines -- No such file or directory - this-is-missing.md @@ '
+}

data/bats/markup.bats

@@ -5,27 +5,18 @@ load 'test_helper'
 # Text Decoration
 
 @test 'Options - list blocks - 1 plain' {
-  BATS_OUTPUT_FILTER=A \
-  spec_mde_args_expect \
-   docs/dev/text-decoration.md \
-   --list-blocks-message oname \
-   --list-blocks-type 3 \
-   --list-blocks \
-   '- **_Bold-Underline_** - **Bold** - **~Bold-Italic~** - __Underline__ - _~Underline-Italic~_ - `Italic` - ~~Strikethrough~~'
+ spec_mde_xansi_oname_doc_blocks_expect docs/dev/text-decoration.md \
+  '- **_Bold-Underline_**_- **Bold**_- **~Bold-Italic~**_- __Underline___- _~Underline-Italic~__- `Italic`_- ~~Strikethrough~~'
 }
 
 @test 'Options - list blocks - 2 extracts markup' {
-  BATS_OUTPUT_FILTER=A \
-  spec_mde_args_expect \
-   docs/dev/text-decoration.md \
-   --list-blocks-message dname \
-   --list-blocks-type 3 \
-   --list-blocks \
-   '- Bold-Underline - Bold - Bold-Italic - Underline - Underline-Italic - Italic - Strikethrough'
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/text-decoration.md \
+   '- Bold-Underline_- Bold_- Bold-Italic_- Underline_- Underline-Italic_- Italic_- Strikethrough'
 }
 
 @test 'Options - list blocks - 3 decorates' {
-  spec_mde_args_expect docs/dev/text-decoration.md --list-blocks-message dname --list-blocks-type 3 --list-blocks \
+  spec_mde_args_expect docs/dev/text-decoration.md \
+   --list-blocks-message dname --list-blocks-type 3 --list-blocks \
    $'\x1b\x5b\x33\x38\x3b\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x6d\x2d\x20\x1b\x5b\x30\x6d\x1b\x5b\x31\x6d\x1b\x5b\x34\x6d\x42\x6f\x6c\x64\x2d\x55\x6e\x64\x65\x72\x6c\x69\x6e\x65\x1b\x5b\x32\x32\x6d\x1b\x5b\x32\x34\x6d\x0a\x1b\x5b\x33\x38\x3b\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x6d\x2d\x20\x1b\x5b\x30\x6d\x1b\x5b\x31\x6d\x42\x6f\x6c\x64\x1b\x5b\x32\x32\x6d\x0a\x1b\x5b\x33\x38\x3b\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x6d\x2d\x20\x1b\x5b\x30\x6d\x1b\x5b\x31\x6d\x1b\x5b\x33\x6d\x42\x6f\x6c\x64\x2d\x49\x74\x61\x6c\x69\x63\x1b\x5b\x32\x32\x6d\x1b\x5b\x32\x33\x6d\x0a\x1b\x5b\x33\x38\x3b\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x6d\x2d\x20\x1b\x5b\x30\x6d\x1b\x5b\x34\x6d\x55\x6e\x64\x65\x72\x6c\x69\x6e\x65\x1b\x5b\x32\x34\x6d\x0a\x1b\x5b\x33\x38\x3b\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x6d\x2d\x20\x1b\x5b\x30\x6d\x1b\x5b\x34\x6d\x1b\x5b\x33\x6d\x55\x6e\x64\x65\x72\x6c\x69\x6e\x65\x2d\x49\x74\x61\x6c\x69\x63\x1b\x5b\x32\x33\x6d\x1b\x5b\x32\x34\x6d\x0a\x1b\x5b\x33\x38\x3b\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x6d\x2d\x20\x1b\x5b\x30\x6d\x1b\x5b\x33\x6d\x49\x74\x61\x6c\x69\x63\x1b\x5b\x32\x33\x6d\x0a\x1b\x5b\x33\x38\x3b\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x6d\x2d\x20\x1b\x5b\x30\x6d\x1b\x5b\x39\x6d\x53\x74\x72\x69\x6b\x65\x74\x68\x72\x6f\x75\x67\x68\x1b\x5b\x32\x39\x6d'
 }
 

data/bats/options-collapse.bats

@@ -0,0 +1,26 @@
+#!/usr/bin/env bats
+
+load 'test_helper'
+
+@test 'Options - Collapsible - Document options' {
+  spec_mde_xansi_oname_doc_blocks_expect docs/dev/options-collapse.md \
+   'H1.1_L1.1_H2.1_H1.2_H2.2_H1.3_H2.3_L2.3_h3.3_L3.3_D4.3_L4.3'
+}
+
+@test 'Options - Collapsible Heading - Expand' {
+  spec_mde_xansi_oname_doc_blocks_expect docs/dev/options-collapse.md \
+   H2.1 \
+   'H1.1_L1.1_H2.1_L2.1_h3.1_L3.1_D4.1_L4.1_H1.2_L1.2_H2.2_H1.3_H2.3_L2.3_h3.3_L3.3_D4.3_L4.3'
+}
+
+@test 'Options - Collapsible Divider' {
+  spec_mde_xansi_oname_doc_blocks_expect docs/dev/options-collapse.md \
+   D4.3 \
+   'H1.1_L1.1_H2.1_H1.2_H2.2_H1.3_H2.3_L2.3_h3.3_L3.3_D4.3'
+}
+
+@test 'Options - Reveal' {
+  spec_mde_xansi_oname_doc_blocks_expect docs/dev/options-collapse.md \
+   H2.2 h3.2 D4.2 \
+   'H1.1_L1.1_H2.1_H1.2_H2.2_L2.2_h3.2_L3.2_D4.2_L4.2_H1.3_L1.3_H2.3_L2.3_h3.3_L3.3_D4.3_L4.3'
+}

data/bats/options.bats

@@ -91,7 +91,7 @@ load 'test_helper'
 }
 
 @test 'Options - version' {
-  version=$(grep VERSION "$PROJECT_ROOT/lib/markdown_exec/version.rb" | cut -d "'" -f 2)
+  version=$(grep VERSION "lib/markdown_exec/version.rb" | cut -d "'" -f 2)
   spec_mde_args_expect --version \
    "$version"
 }

data/bats/table.bats

@@ -0,0 +1,8 @@
+#!/usr/bin/env bats
+
+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 Discovered |_| -------------------- | ------------------------- | ------------ | ------------- | --------------- |_|  Tapanuli Orangutan  |    Pongo tapanuliensis    |    Pongo     |   Hominidae   |      2017       |_| Psychedelic Frogfish | Histiophryne psychedelica | Histiophryne | Antennariidae |      2009       |_|    Ruby Seadragon    |   Phyllopteryx dewysea    | Phyllopteryx | 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 |'
+}

data/bats/test_helper.bash

@@ -1,7 +1,5 @@
 # facilitate execution of program, comparison of output
 
-export PROJECT_ROOT="/Users/fareed/Documents/dev/ruby/markdown_exec"
-
 date_from_history_file_name () {
   basename "$1" | sed -E 's/.*([0-9]{4}-[0-9]{2}-[0-9]{2}).*/\1/'
 }
@@ -10,6 +8,41 @@ echo_hexdump () {
   echo -en "$1" | hexdump -C
 }
 
+echo_hexdump_expected_output_filter () {
+  local expected="$1"
+  local output="$2"
+  local filter="$3"
+
+  echo -e "- output_$(echo "$output" | wc -l)_$(echo -n "$output" | wc -c):\n$output"
+  if [[ $filter == A ]]; then
+    echo -e "- converted_$(echo "$output" | wc -l)_$(echo -n "$output" | wc -c):"
+    echo "$(remove_ansi_escape_sequences "$output")"
+  fi
+  echo -e "- expected_$(echo "$expected" | wc -l)_$(echo -n "$expected" | wc -c):\n$expected"
+
+  if [[ $filter == A ]]; then
+    echo "- output"
+    echo_hexdump "$output"
+    echo "- converted"
+    echo_hexdump "$(remove_ansi_escape_sequences "$output")"
+    echo "- expected"
+    echo_hexdump "$expected"
+  fi
+} 
+
+echo_xansi_command_expected_output_filter () {
+  local command="$1"
+  local expected="$2"
+  local output="$3"
+  local filter="$4"
+
+  echo -e "- command: $command"
+  echo -e "- expected:\n$expected"
+  echo_hexdump "$expected"
+  echo -e "- output:\n$(text_filter_ansi "$output" "$filter")"
+  echo_hexdump "$output"
+}
+
 exec_mde () {
   echo "bin/bmde "$1" "${@:2}""
   run bin/bmde "$1" ${@:2}
@@ -30,6 +63,21 @@ expect_equal_with_conversion () {
   [[ "$expected" == "$actual" ]]
 }
 
+hex_dump () {
+  local separator=" --- "
+  local output=""
+  
+  echo -en "$@" >&2
+  for arg in "$@"; do
+    output+="${arg}${separator}"
+  done
+  
+  output="${output%$separator}"  # Remove the trailing separator
+  echo "output: $output"
+  echo ":"
+  echo -en "$output" | hexdump -C >&2
+}
+
 most_recent_history_file_name () {
   ls -f logs/*examples_save_md* | tail -n 1
 }
@@ -73,11 +121,7 @@ run_mde_specs_md_args_expect_xansi () {
 
   filter="${BATS_OUTPUT_FILTER:-A}"
   if ( ! expect_equal_with_conversion "$expected" "$output" "$filter" ); then
-    echo -e "- command: ${@:1:$#-1}"
-    echo -e "- expected:\n$expected"
-    echo_hexdump "$expected"
-    echo -e "- output:\n$(text_filter_ansi "$output" "$filter")"
-    echo_hexdump "$output"
+    echo_xansi_command_expected_output_filter "${@:1:$#-1}" "$expected" "$output" "$filter"
   fi
 
   expect_equal_with_conversion "$expected" "$output" "$filter"
@@ -123,38 +167,6 @@ spec_mde_args_expect () {
    "${args[@]: -1}"
 }
 
-hex_dump () {
-  local separator=" --- "
-  local output=""
-  
-  echo -en "$@" >&2
-  for arg in "$@"; do
-    output+="${arg}${separator}"
-  done
-  
-  output="${output%$separator}"  # Remove the trailing separator
-  echo "output: $output"
-  echo ":"
-  echo -en "$output" | hexdump -C >&2
-}
-
-spec_mde_args_grep_filter_expect_ok () {
-  # Capturing arguments
-  local remaining=("${@:1:$(($#-3))}")
-  local pattern="${@: -3:1}"
-  local filter="${@: -2:1}"
-  local expected="${@: -1}"
-  local STATUS="${BATS_STATUS:-0}"
-  local EXE="${BATS_EXE:-silence_ww bin/bmde}"
-
-  # Print the command being run for debugging
-  echo >&2 $EXE "${remaining[@]}"
-
-  # Pass the exact arguments including empty and space-containing ones
-  run $EXE "${remaining[@]}"
-}
-
-
 spec_mde_args_grep_filter_expect () {
   # Capturing arguments
   local remaining=("${@:1:$(($#-3))}")
@@ -190,22 +202,35 @@ spec_mde_args_grep_filter_expect () {
   fi
 
   if ( ! expect_equal_with_conversion "$expected" "$output" "$filter"); then
-    echo -e "- output_$(echo "$output" | wc -l)_$(echo -n "$output" | wc -c):\n$output"
-    [[ $filter == A ]] && echo_hexdump "$output"
-
-    if [[ $filter == A ]]; then
-      echo -e "- converted_$(echo "$output" | wc -l)_$(echo -n "$output" | wc -c):"
-      echo "$(remove_ansi_escape_sequences "$output")"
-      echo_hexdump "$(remove_ansi_escape_sequences "$output")"
-    fi
-    echo -e "- expected_$(echo "$expected" | wc -l)_$(echo -n "$expected" | wc -c):\n$expected"
-    [[ $filter == A ]] && echo_hexdump "$expected"
+    echo_hexdump_expected_output_filter "$expected" "$output" "$filter"
   fi
   expect_equal_with_conversion "$expected" "$output" "$filter"
   [[ -n $status ]] && echo "- status: $status"
   [[ -n $status ]]
 }
 
+spec_mde_xansi_dname_doc_blocks_expect () {
+  BATS_OUTPUT_FILTER=A
+  BATS_SAFE=_
+  spec_mde_args_expect "$1" \
+   "${@:2:$(($#-2))}" \
+   --list-blocks-message dname \
+   --list-blocks-type 3 \
+   --list-blocks \
+  "${!#}"
+}
+
+spec_mde_xansi_oname_doc_blocks_expect () {
+  BATS_OUTPUT_FILTER=A
+  BATS_SAFE=_
+  spec_mde_args_expect "$1" \
+   "${@:2:$(($#-2))}" \
+   --list-blocks-message oname \
+   --list-blocks-type 3 \
+   --list-blocks \
+  "${!#}"
+}
+
 text_filter_ansi () {
   if [[ $# -eq 2 ]]; then
     remove_ansi_escape_sequences "$1"

data/bats/variable-expansion.bats

@@ -0,0 +1,46 @@
+#!/usr/bin/env bats
+
+load 'test_helper'
+
+@test 'Variable expansion - default' {
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/variable-expansion.md \
+   ' EVIDENCE_ SOURCE is: ${SOURCE}_SOURCE is: ${SOURCE}_SOURCE is: ${SOURCE}_| SOURCE    |_| --------- |_| ${SOURCE} |_name_with_${SOURCE}_in_name_load: file_${SOURCE}.sh_ SOURCES'
+}
+
+@test 'Variable expansion - LINK_LOAD_SOURCE' {
+  echo "SOURCE='Loaded file'" > temp_variable_expansion.sh
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/variable-expansion.md \
+   '(LINK_LOAD_SOURCE)' \
+   ' EVIDENCE_ SOURCE is: Loaded file_SOURCE is: Loaded file_SOURCE is: Loaded file_| SOURCE      |_| ----------- |_| Loaded file |_name_with_${SOURCE}_in_name_load: file_Loaded file.sh_ SOURCES'
+  rm temp_variable_expansion.sh
+}
+
+@test 'Variable expansion - LINK_VARS_SOURCE' {
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/variable-expansion.md \
+   '(LINK_VARS_SOURCE)' \
+   ' EVIDENCE_ SOURCE is: Link block_SOURCE is: Link block_SOURCE is: Link block_| SOURCE     |_| ---------- |_| Link block |_name_with_${SOURCE}_in_name_load: file_Link block.sh_ SOURCES'
+}
+
+@test 'Variable expansion - VARS_SOURCE' {
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/variable-expansion.md \
+   '(VARS_SOURCE)' \
+   ' EVIDENCE_ SOURCE is: Vars block_SOURCE is: Vars block_SOURCE is: Vars block_| SOURCE     |_| ---------- |_| Vars block |_name_with_${SOURCE}_in_name_load: file_Vars block.sh_ SOURCES'
+}
+
+### Load source
+
+@test 'Variable expansion - in block body' {
+  BATS_OUTPUT_FILTER=A
+  spec_mde_args_expect docs/dev/variable-expansion.md \(VARS_SOURCE\) \
+   --list-blocks --list-blocks-type 3 \
+   --list-blocks-eval "block.body&.first&.start_with?(\"load: \") ? block.body : nil" \
+   'load: file_Vars block.sh'
+}
+
+@test 'Variable expansion - in block dname' {
+  BATS_OUTPUT_FILTER=A
+  spec_mde_args_expect docs/dev/variable-expansion.md \(VARS_SOURCE\) \
+   --list-blocks --list-blocks-type 3 \
+   --list-blocks-eval "block.body&.first&.start_with?(\"load: \") ? block.dname : nil" \
+   'load: file_Vars block.sh'
+}

data/bin/tab_completion.sh

@@ -13,7 +13,7 @@ __filedirs_all()
 }
 
 _mde_echo_version() {
-  echo "2.5.0"
+  echo "2.6.0"
 }
 
 _mde() {

data/docs/dev/bats-document-configuration.md

@@ -1,4 +1,6 @@
-```opts :(document_options)
+```opts :(document_opts)
+divider4_center: false
+
 dump_blocks_in_file: false     # Dump BlocksInFile (stage 1)
 dump_delegate_object: false    # Dump @delegate_object
 dump_inherited_lines: false    # Dump inherited lines
@@ -7,6 +9,11 @@ dump_selected_block: false     # Dump selected block
 
 execute_in_own_window: false
 
+menu_divider_format:
+menu_with_back: false
+menu_with_exit: false
+menu_with_shell: false
+
 output_execution_report: false
 output_execution_summary: false
 

data/docs/dev/block-type-bash.md

@@ -83,6 +83,6 @@ This block has no (shell) type. It will execute as the default shell type.
 	It will not appear if `bash_only` is `true`.
 
 @import bats-document-configuration.md
-```opts :(document_options)
+```opts :(document_opts)
 bash_only: false
 ```

data/docs/dev/block-type-opts.md

@@ -3,13 +3,9 @@ Species
 menu_note_format: "AFTER %{line}"
 ```
 @import bats-document-configuration.md
-```opts :(document_options)
-menu_divider_format:
+```opts :(document_opts)
 menu_final_divider:
 menu_for_saved_lines: false
 menu_initial_divider:
 menu_note_format: "BEFORE %{line}"
-menu_with_back: false
-menu_with_exit: false
-menu_with_shell: false
 ```

data/docs/dev/block-type-vars.md

@@ -2,6 +2,10 @@
 VAULT: 1
 ```
 ```bash :show
+echo "Species: $Species"
 echo "VAULT: $VAULT"
 ```
 @import bats-document-configuration.md
+```vars :(document_vars)
+Species: Not specified
+```

data/docs/dev/import-missing.md

@@ -0,0 +1,2 @@
+Demonstrate a missing import file.
+@import this-is-missing.md

data/docs/dev/menu-cli.md

@@ -11,6 +11,6 @@ echo "Sh block"
 echo "Unspecified shell type"
 ```
 @import bats-document-configuration.md
-```opts :(document_options)
+```opts :(document_opts)
 bash_only: false
 ```

data/docs/dev/options-collapse.md

@@ -0,0 +1,47 @@
+/ All are collapsible
+/ Only H2 is collapsed by default
+# H1.1
+L1.1
+## H2.1
+L2.1
+### H3.1
+L3.1
+::: D4.1
+L4.1
+/ Collapse all
+#+ H1.2
+L1.2
+##+ H2.2
+L2.2
+###+ H3.2
+L3.2
+:::+ D4.2
+L4.2
+/ Expand all
+#- H1.3
+L1.3
+##- H2.3
+L2.3
+###- H3.3
+L3.3
+:::- D4.3
+L4.3
+@import bats-document-configuration.md
+```opts :(document_opts)
+divider4_center: false
+divider4_collapse: false
+divider4_collapsible: true
+heading1_center: false
+heading1_collapse: false
+heading1_collapsible: false
+heading2_center: false
+heading2_collapse: true
+heading2_collapsible: true
+heading3_center: false
+heading3_collapse: false
+heading3_collapsible: true
+
+heading1_match: "^#(?<line>(?!#)(?<collapse>[+-~]?)(?<indent>[ \t]*)(?<text>.*?)(?<trailing>[ \t]*))?$"
+menu_collapsible_symbol_collapsed: '(+)'
+menu_collapsible_symbol_expanded: '(-)'
+```

data/docs/dev/requiring-blocks.md

@@ -19,3 +19,6 @@ ARG1=37
 echo "ARG1: $ARG1"
 ```
 @import bats-document-configuration.md
+```opts :(document_opts)
+menu_with_exit: true
+```

data/docs/dev/specs.md

@@ -77,7 +77,8 @@ dump_menu_blocks: false
 ```
 
 @import bats-document-configuration.md
-```opts :(document_options) +(disable_dump_*)
+```opts :(document_opts) +(disable_dump_*)
 menu_note_color: 'plain'
+menu_with_exit: true
 menu_with_inherited_lines: false
 ```

data/docs/dev/table-crash.md

@@ -0,0 +1,39 @@
+/ The lines below are an invalid table
+| Region| VPC ID| VPC Name
+-
+# Demonstrate Tables
+
+Table flush at left.
+Centered columns.
+| Common Name| Species| Genus| Family| Year Discovered
+|:-:|:-:|:-:|:-:|:-:
+| Tapanuli Orangutan| Pongo tapanuliensis| Pongo| Hominidae| 2017
+| Psychedelic Frogfish| Histiophryne psychedelica| Histiophryne| Antennariidae| 2009
+| Ruby Seadragon| Phyllopteryx dewysea| Phyllopteryx| 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
+  | Cappuccino Snake| Hydrodynastes bicinctus| Hydrodynastes| Colubridae| 2021
+  | Homo luzonensis| Homo luzonensis| Homo| Hominidae| 2019
+
+	Table indented with one tab.
+	Right-justified columns.
+	| Common Name| Species| Genus| Family| Year Discovered
+	|-:|-:|-:|-:|-:
+	| Spiny Dandelion| Taraxacum japonicum| Taraxacum| Asteraceae| 2022
+	| Mythical Monkey| Cercopithecus lomamiensis| Cercopithecus| Cercopithecidae| 2012
+	| Yeti Crab| Kiwa hirsuta| Kiwa| Kiwaidae| 2005
+
+## Non-table text is not modified
+1. |
+2. ||
+    |
+    ||
+
+## markup with table
+| Common Name| Species| Genus| Family| Year Discovered
+|:-:|:-:|:-:|:-:|:-:
+| `Tapanuli Orangutan`| **Pongo tapanuliensis**| __Pongo__| Hominidae| 2017

data/docs/dev/table-indent.md

@@ -0,0 +1,26 @@
+# Demonstrate Table Indentation
+
+Table flush at left.
+Centered columns.
+| Common Name| Species| Genus| Family| Year Discovered
+|:-:|:-:|:-:|:-:|:-:
+| Tapanuli Orangutan| Pongo tapanuliensis| Pongo| Hominidae| 2017
+| Psychedelic Frogfish| Histiophryne psychedelica| Histiophryne| Antennariidae| 2009
+| Ruby Seadragon| Phyllopteryx dewysea| Phyllopteryx| 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
+@import bats-document-configuration.md
+```opts :(document_opts)
+heading1_center: false
+table_center: false
+```

data/docs/dev/text-decoration.md

@@ -5,11 +5,8 @@
 - _~Underline-Italic~_
 - `Italic`
 - ~~Strikethrough~~
-```opts :(document_options)
-menu_final_divider:
+@import bats-document-configuration.md
+```opts :(document_opts)
 menu_for_saved_lines: false
 menu_initial_divider:
-menu_with_back: false
-menu_with_exit: false
-menu_with_shell: false
 ```

data/docs/dev/variable-expansion.md

@@ -24,7 +24,7 @@ vars:
 SOURCE: Vars block
 ```
 @import bats-document-configuration.md
-```opts :(document_options)
+```opts :(document_opts)
 heading1_center: false
 heading2_center: false
 heading3_center: false
@@ -32,7 +32,5 @@ menu_final_divider:
 menu_for_saved_lines: false
 menu_initial_divider:
 menu_vars_set_format:
-menu_with_back: false
-menu_with_exit: false
-menu_with_shell: false
+table_center: false
 ```