feat(core): add private flag support to block schemas

Author: eldomagan

packages/core/src/Concerns/IsBlock.php

@@ -120,4 +120,12 @@ public static function presets(): array
     {
         return static::$presets ?? [];
     }
+
+    /**
+     * Check if block is private from static property.
+     */
+    public static function private(): bool
+    {
+        return static::$private ?? false;
+    }
 }

packages/core/src/Contracts/BlockInterface.php

@@ -69,6 +69,12 @@ public static function previewImageUrl(): ?string;
      */
     public static function presets(): array;
 
+    /**
+     * Check if this block is private.
+     * Return true to mark as private, false (default) for public.
+     */
+    public static function private(): bool;
+
     /**
      * Render the block with its current data (and context).
      * Implementation can return HTML string or framework-specific response.

packages/core/src/Data/BlockSchema.php

@@ -34,6 +34,8 @@ class BlockSchema implements JsonSerializable
 
     public array $presets = [];
 
+    public bool $private = false;
+
     public function __construct(
         string $type,
         string $slug,
@@ -46,7 +48,8 @@ public function __construct(
         array $accepts = [],
         ?string $wrapper = null,
         ?string $previewImageUrl = null,
-        array $presets = []
+        array $presets = [],
+        bool $private = false
     ) {
         $this->type = $type;
         $this->slug = $slug;
@@ -60,6 +63,7 @@ public function __construct(
         $this->wrapper = $wrapper;
         $this->previewImageUrl = $previewImageUrl;
         $this->presets = $presets;
+        $this->private = $private;
     }
 
     /**
@@ -88,7 +92,8 @@ class: $blockClass,
             accepts: $blockClass::accepts(),
             wrapper: $blockClass::wrapper(),
             previewImageUrl: $blockClass::previewImageUrl(),
-            presets: $blockClass::presets()
+            presets: $blockClass::presets(),
+            private: $blockClass::private()
         );
     }
 
@@ -114,6 +119,7 @@ public function toArray(): array
             'presets' => array_map(function ($preset) {
                 return $preset instanceof BlockPreset ? $preset->toArray() : $preset;
             }, $this->presets),
+            'private' => $this->private,
         ];
     }
 

tests/core/Data/BlockSchemaTest.php

@@ -304,4 +304,66 @@ public function toArray(): array
         expect($array['presets'][0])->toHaveKey('name', 'Array Preset');
         expect($array['presets'][1])->toHaveKey('name', 'Object Preset');
     });
+
+    it('has private flag that defaults to false', function () {
+        $schema = new BlockSchema('text', 'text', TestBlock::class, 'Text Block');
+
+        expect($schema->private)->toBe(false);
+    });
+
+    it('can be created with private flag set to true', function () {
+        $schema = new BlockSchema(
+            'text',
+            'text',
+            TestBlock::class,
+            'Text Block',
+            private: true
+        );
+
+        expect($schema->private)->toBe(true);
+    });
+
+    it('can be created with private flag set to false explicitly', function () {
+        $schema = new BlockSchema(
+            'text',
+            'text',
+            TestBlock::class,
+            'Text Block',
+            private: false
+        );
+
+        expect($schema->private)->toBe(false);
+    });
+
+    it('includes private flag in toArray output', function () {
+        $publicSchema = new BlockSchema('text', 'text', TestBlock::class, 'Text Block', private: false);
+        $privateSchema = new BlockSchema('text', 'text', TestBlock::class, 'Text Block', private: true);
+
+        $publicArray = $publicSchema->toArray();
+        $privateArray = $privateSchema->toArray();
+
+        expect($publicArray)->toHaveKey('private', false);
+        expect($privateArray)->toHaveKey('private', true);
+    });
+
+    it('includes private flag in JSON serialization', function () {
+        $schema = new BlockSchema('text', 'text', TestBlock::class, 'Text Block', private: true);
+
+        $json = json_encode($schema);
+        $decoded = json_decode($json, true);
+
+        expect($decoded)->toHaveKey('private', true);
+    });
+
+    it('reads private flag from block class using fromClass', function () {
+        $schema = BlockSchema::fromClass(PrivateTestBlock::class);
+
+        expect($schema->private)->toBe(true);
+    });
 });
+
+// Test block with private flag set
+class PrivateTestBlock extends TestBlock
+{
+    protected static bool $private = true;
+}