From 7cbceeec2ab87952dc46146ebed78f65602beec9 Mon Sep 17 00:00:00 2001
From: 8lurry <sharifmehedi24@outlook.com>
Date: Fri, 14 Nov 2025 21:59:28 +0600
Subject: [PATCH] refactor(block): clarify container formatting

- Add runtime guard and explicit error when parent.format is missing
- Small clarity fixes in BlockBlot constructor/format logic
---
 src/blot/block.ts | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/src/blot/block.ts b/src/blot/block.ts
index a9de389..6d60679 100644
--- a/src/blot/block.ts
+++ b/src/blot/block.ts
@@ -41,12 +41,47 @@ class BlockBlot extends ParentBlot implements Formattable {
 
   protected attributes: AttributorStore;
 
+  // Required container blot names — used to filter formats that belong to a parent container
+  requiredContainersNames: string[];
+
   constructor(scroll: Root, domNode: Node) {
     super(scroll, domNode);
     this.attributes = new AttributorStore(this.domNode);
+    let rc = this.statics.requiredContainer;
+    const parentNames: string[] = [];
+    while (rc != null) {
+      parentNames.push(rc.blotName);
+      rc = (rc as any).requiredContainer;
+    }
+    this.requiredContainersNames = parentNames;
   }
 
   public format(name: string, value: any): void {
+    if (this.requiredContainersNames.includes(name)) {
+      let parentContainer = this.statics.requiredContainer,
+        parent = this.parent;
+      while (parentContainer != null) {
+        // Parent containers may not be initialized yet — they'll be ready after optimize(), so later call to format will succeed.
+        if (!(parent instanceof parentContainer)) {
+          break;
+        }
+        if (name == parentContainer.blotName) {
+          // @ts-expect-error - parent may not declare format in its type
+          if (typeof parent.format !== 'function') {
+            throw new Error(
+              `Parent blot ${(parent.constructor as BlotConstructor).blotName} missing 'format' method`,
+            );
+          }
+          // @ts-expect-error - here we are already safe, hack with typescript
+          parent.format(name, value);
+          break;
+        }
+        parentContainer = (parentContainer as BlotConstructor)
+          .requiredContainer;
+        parent = parent.parent;
+      }
+      return;
+    }
     const format = this.scroll.query(name, Scope.BLOCK);
     if (format == null) {
       return;