Fix TOML table parsing after standalone comments

Standalone TOML comments immediately inside a table/array-table no longer end the table scope, preventing subsequent keys from being flattened to the document root.

pkg/yqlib/toml_test.go

@@ -228,6 +228,14 @@ B = 12
 name = "Tom"  # name comment
 `
 
+// Repro for https://github.com/mikefarah/yq/issues/2588
+// Bug: standalone comments inside a table cause subsequent key-values to be assigned at root.
+var issue2588RustToolchainWithComments = `
+[owner]
+# comment
+name = "Tomer"
+`
+
 var sampleFromWeb = `# This is a TOML document
 title = "TOML Example"
 
@@ -550,6 +558,22 @@ var tomlScenarios = []formatScenario{
 		expected:     rtComments,
 		scenarioType: "roundtrip",
 	},
+	{
+		skipDoc:      true,
+		description:  "Issue #2588: comments inside table must not flatten (.owner.name)",
+		input:        issue2588RustToolchainWithComments,
+		expression:   ".owner.name",
+		expected:     "Tomer\n",
+		scenarioType: "decode",
+	},
+	{
+		skipDoc:      true,
+		description:  "Issue #2588: comments inside table must not flatten (.name)",
+		input:        issue2588RustToolchainWithComments,
+		expression:   ".name",
+		expected:     "null\n",
+		scenarioType: "decode",
+	},
 	{
 		description:  "Roundtrip: sample from web",
 		input:        sampleFromWeb,