/++
  extract native/orig header return associative array<BR>

  the header is passed as text (lopped off top of a sisu markup file until the
  required first heading ^A~), determine whether is a native header or sdlang one
  with a regex check if whether it contains the "native header" required tag/field
  @title: then process accordingly as a "native header" or "sdlang header"
  converting the metadata and make instructions to a common json format used by
  program internally. Moved to associative array.
+/
module sdp.meta.conf_make_meta;
template docHeaderMakeAndMetaTupExtractAndConvertToAA() {
  import
    std.exception,
    std.regex,
    std.stdio,
    std.traits,
    std.typecons,
    std.utf,
    std.conv : to;
  import sdlang;
  import
    sdp.meta.conf_make_meta_native,
    sdp.meta.conf_make_meta_sdlang,
    sdp.meta.rgx;
  mixin SiSUrgxInit;
  mixin SiSUheaderExtractNative;
  mixin SiSUextractSDLang;
  auto rgx = Rgx();
  auto docHeaderMakeAndMetaTupExtractAndConvertToAA(DocMake, Src)(
    DocMake conf_doc_make_aa,
    Src     header_src,
  ) {
    debug(asserts){
      static assert(is(typeof(header_src)       == char[]));
      static assert(is(typeof(conf_doc_make_aa) == string[string][string]));
    }
    auto head_native = HeaderDocMetadataAndMakeNativeToAA();
    auto header_sdlang_tag = (!(header_src.match(rgx.native_header_meta_title)))
    ? extractSDL().docHeaderSDLtagGet(header_src) // sdlang.ast.Tag
    : null;
    auto header_make_and_meta_tuple = (header_src.match(rgx.native_header_meta_title))
    ? (head_native.headerNativeToAA(header_src))
    : (extractSDL().docHeaderSDLtoAA(conf_doc_make_aa, header_sdlang_tag));
    static assert(!isTypeTuple!(header_make_and_meta_tuple));
    static assert(header_make_and_meta_tuple.length==2);
    return header_make_and_meta_tuple;
  }
}