From 8e501641ac8a769e8e07793b5e50aea30531749c Mon Sep 17 00:00:00 2001
From: "Alex A. Naanou" <alex.nanou@gmail.com>
Date: Thu, 9 Jul 2026 17:56:54 +0300
Subject: [PATCH] notes...

Signed-off-by: Alex A. Naanou <alex.nanou@gmail.com>
---
 v3/pwiki/parser.js | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/v3/pwiki/parser.js b/v3/pwiki/parser.js
index 514dbce..c669ff9 100644
--- a/v3/pwiki/parser.js
+++ b/v3/pwiki/parser.js
@@ -817,8 +817,11 @@ module.BaseParser = {
 
 	// merge stage III...
 	//
-	// XXX FILTER should filters he handled here or in .resolve(..) ???
-	// 		...and how do we handle filters in @include(..)'s???
+	// - ensure the ast is fully resolved
+	// - apply nested stage III handlers
+	// - apply filters on whole ast
+	//
+	//
 	merge: function(page, ast, state={}, nested_handlers={}, wait='wait'){
 		var that = this
 
@@ -852,7 +855,6 @@ module.BaseParser = {
 		return Promise.awaitOrRun(
 			state[wait],
 			function(){
-				//ast = stage3(ast)
 				// NOTE: in an async world where any promised macro can 
 				// 		call .exec(..) / .execNested(..) we can't trust
 				// 		the lack of .unresolved in state...