Implemented prop when. Tagged missing prop commands

KaruroChori · KaruroChori · commit ab0c2bc4becd · 2025-01-03T15:53:50.000Z
diff --git a/RELEASE.md b/RELEASE.md
@@ -3,6 +3,10 @@
 Just a quick corrective version over v0.3.7 to fix the behaviour of several untested features, like the newly added filters of `for` loops.  
 This release also introduces few more meta-expression operators to allow escaping, and a realistic example emitting HTML to complement the rest of the docs.
 
+### New features
+
+- `when` as a prop command for the conditional rendering of the owner.
+
 ### Breaking changes
 
 - `sort-by` and `order-by` will now use `|` in place `,` to split multiple options.
diff --git a/TODO.md b/TODO.md
@@ -27,8 +27,7 @@ This is a list of commands which are currently supported:
 - [ ] for-prop (mostly a copy & paste from `for`)
 - [ ] value
 - [ ] prop (dual of element)
-- [ ] calc
-- [ ] log to add entries to the logging data
+- [x] when
 
 ## Missing features
 
@@ -49,7 +48,7 @@ Just a corrective versions.
 
 ## `v0.3.11`
 
-- [ ] Add support for props-based commands.
+- [ ] Add support for all props-based commands.
 - [x] Complete more of the repl vm operator to cover specs.
 
 ## `v0.3.13`
diff --git a/docs/releases/v0.3.5.md b/docs/releases/v0.3.5.md
@@ -1,4 +1,4 @@
-## `v0.3.5`
+## v0.3.5
 
 Technical release, only for the sake of fully testing workflows.
 
diff --git a/docs/releases/v0.3.9.md b/docs/releases/v0.3.9.md
@@ -0,0 +1,13 @@
+## v0.3.9
+
+Just a quick corrective version over v0.3.7 to fix the behaviour of several untested features, like the newly added filters of `for` loops.  
+This release also introduces few more meta-expression operators to allow escaping, and a realistic example emitting HTML to complement the rest of the docs.
+
+### New features
+
+- `when` as a prop command for the conditional rendering of the owner.
+
+### Breaking changes
+
+- `sort-by` and `order-by` will now use `|` in place `,` to split multiple options.
+- `when`/`is` fully replaced. The older syntax was dreadful but necessary without the RPN virtual machine, but now that we have... say hello to `test`/`case`.
diff --git a/docs/syntax.md b/docs/syntax.md
@@ -2,6 +2,10 @@
 title: Full Syntax reference
 ---
 
+> [!WARNING]  
+> This documentation reflects the expected functionality for v0.5.0.  
+> Some features are still missing, progress is tracked in the repository and on the todo file in root.
+
 `vs.templ` uses special elements and attributes to define which actions the preprocessor should perform.  
 These XML entities are scoped under the namespace `s` by default, but the user can set up a custom one as well.  
 Please, notice that pugixml on which vs.templ is based does not have a full understanding of XML and namespaces are not covered.  
@@ -102,7 +106,7 @@ The symbol `$$` gets loaded with the entry number while iterating, so that it is
 
 To introduce the result of a (meta) expression in the tree.  
 Numbers are serialized and added, strings are introduced as they are, attributes as strings and nodes are just appended as children.  
-It accepts a an expression `src` as argument, by default set to `$`.
+It accepts an expression `src` as argument, by default set to `$`.
 
 ### `element`
 
diff --git a/examples/html/template.xhtml5 b/examples/html/template.xhtml5
@@ -13,6 +13,8 @@
 
 <body>
     <main class="container">
+        <!--TODO: once more operations are defined add a more complex test for when-->
+        <h1 s:when=": false">Hello!</h1>
         <table>
             <thead>
                 <tr>
@@ -25,7 +27,7 @@
                 <s:for src="/entry" sort-by="$~name|$~surname" filter=": true">
                     <s:item>
                         <tr>
-                            <td><img s:eval.src="$~pic" /></td>
+                            <td><img s:value.src="$~pic" /></td>
                             <td>
                                 <s:value src=": `$~surname` `$~name` `# ` join" />
                             </td>
diff --git a/meson.build b/meson.build
@@ -1,7 +1,7 @@
 project(
   'vs-templ',
   ['cpp'],
-  version: '0.3.8',
+  version: '0.3.9',
   meson_version: '>= 1.1',
   default_options: ['cpp_std=c++20'],
 )
diff --git a/src/vs-templ.cpp b/src/vs-templ.cpp
@@ -648,11 +648,22 @@ void preprocessor::_parse(std::optional<pugi::xml_node_iterator> stop_at){
                         int offset = get_or<int>(resolve_expr(current_template.first->attribute("offset").as_string("0")).value_or(0),0);
                         
                         auto expr = resolve_expr(in);
-
+                        log(log_t::ERROR, std::format("static operation `{}` not yet implemented",attr.name()));
+                    }
+                    else if(cexpr_strneqv(attr.name()+ns_prefix.length(),"for-props.src.")){
+                        log(log_t::ERROR, std::format("static operation `{}` not yet implemented",attr.name()));
+                    }
+                    else if(cexpr_strneqv(attr.name()+ns_prefix.length(),"prop.")){
+                        log(log_t::ERROR, std::format("static operation `{}` not yet implemented",attr.name()));
+                    }
+                    else if(cexpr_strneqv(attr.name()+ns_prefix.length(),"value.")){
+                        log(log_t::ERROR, std::format("static operation `{}` not yet implemented",attr.name()));
+                    }
+                    else if(cexpr_strneqv(attr.name()+ns_prefix.length(),"when")){
+                        auto test  = get_or<int>(resolve_expr(attr.value()).value_or(false),false);
+                        if(!test)last.parent().remove_child(last);
+                        break;
                     }
-                    else if(cexpr_strneqv(attr.name()+ns_prefix.length(),"for-props.src.")){}
-                    else if(cexpr_strneqv(attr.name()+ns_prefix.length(),"use.src.")){}
-                    else if(cexpr_strneqv(attr.name()+ns_prefix.length(),"value.")){}
                     else {log(log_t::ERROR, std::format("unrecognized static operation `{}`",attr.name()));}
                 }
                 else last.append_attribute(attr.name()).set_value(attr.value());

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		-## `v0.3.5`
	`1`	`+## v0.3.5`
`2`	`2`
`3`	`3`	`Technical release, only for the sake of fully testing workflows.`
`4`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`project(`
`2`	`2`	`'vs-templ',`
`3`	`3`	`['cpp'],`
`4`		`- version: '0.3.8',`
	`4`	`+ version: '0.3.9',`
`5`	`5`	`meson_version: '>= 1.1',`
`6`	`6`	`default_options: ['cpp_std=c++20'],`
`7`	`7`	`)`