itmar-block-packages 1.7.0 → 1.7.1

package/README.md

@@ -14,6 +14,10 @@ import {関数名又はコンポーネント名} from "itmar-block-packages"
 npm i @wordpress/scripts@^27.6.0 --save-dev
 
 ## 更新履歴
+= 1.7.1 =  
+- serializeBlockTree,createBlockTreeをblockStore.jsに加えた。
+- BlockPlace.jsでdesign-groupがフレックス要素の場合は主軸の大きさの設定がflex-grow,flex-shrink,flex-basisとなるよう修正した加えた。
+
 = 1.7.0 =  
 - バリデーションチェック用の関数を集めるためのvalidationCheck.jsを新設し、URLの形式をチェックするisValidUrlWithUrlApiを加えた。
 
@@ -1071,6 +1075,103 @@ const flattenBlocks = (blocks) => {
 
 ---
 
+### `serializeBlockTree`
+
+指定された Gutenberg ブロックオブジェクトを、**ネスト構造を保ったままプレーンな JSON 形式に変換（保存用）**します。
+
+#### ✅ 使い方
+
+```js
+import { serializeBlockTree } from '@your-scope/block-tree-utils';
+
+const json = serializeBlockTree(block);
+```
+
+#### 📥 入力
+
+- `block`: Gutenberg ブロックオブジェクト（`name`, `attributes`, `innerBlocks` を含む）
+
+#### 📤 出力
+
+```json
+{
+  "blockName": "core/group",
+  "attributes": { ... },
+  "innerBlocks": [
+    {
+      "blockName": "core/paragraph",
+      "attributes": { ... },
+      "innerBlocks": []
+    }
+  ]
+}
+```
+
+---
+
+### `createBlockTree`
+
+`serializeBlockTree` によって得られた JSON 構造を、**`createBlock()` に渡せる Gutenberg ブロックオブジェクトに再構築**します。
+
+#### ✅ 使い方
+
+```js
+import { createBlockTree } from '@your-scope/block-tree-utils';
+import { createBlock } from '@wordpress/blocks';
+
+const wpBlock = createBlockTree(savedJson);
+```
+
+#### 📥 入力
+
+- `savedJson`: `serializeBlockTree` で生成されたブロックデータ
+
+#### 📤 出力
+
+- `createBlock(name, attributes, innerBlocks)` の形で再帰的に構成された WP ブロックオブジェクト
+
+---
+
+### `flattenBlocks`
+
+Gutenberg のネストされたブロック配列を、**1階層の配列としてフラットに展開**します。  
+ブロック構成内にあるすべてのブロック（ネスト含む）を一括走査する際に便利です。
+
+#### ✅ 使い方
+
+```js
+import { flattenBlocks } from '@your-scope/block-tree-utils';
+
+const flat = flattenBlocks(innerBlocks);
+```
+
+#### 📥 入力
+
+- `innerBlocks`: Gutenberg のブロック配列（`innerBlocks` を含む構造）
+
+#### 📤 出力
+
+- 平坦化されたブロック配列（元の構造は保持しない）
+
+---
+
+## 🧪 使用例
+
+```js
+import {
+  serializeBlockTree,
+  createBlockTree,
+  flattenBlocks,
+} from '@your-scope/block-tree-utils';
+
+const savedData = blocks.map(serializeBlockTree);
+const restored = savedData.map(createBlockTree);
+const flatList = flattenBlocks(restored);
+```
+
+---  
+
+
 ## 日本郵便番号から住所を取得するユーティリティ関数
 ### `fetchZipToAddress`
 `fetchZipToAddress` は、[zipcloud](https://zipcloud.ibsnet.co.jp) API を使用して、日本の郵便番号から都道府県・市区町村・町域の住所を非同期で取得する JavaScript 関数です。  

package/build/index.asset.php

@@ -1 +1 @@
-<?php return array('dependencies' => array('react', 'react-dom', 'wp-api-fetch', 'wp-block-editor', 'wp-blocks', 'wp-components', 'wp-data', 'wp-element', 'wp-i18n', 'wp-primitives'), 'version' => '931e44cdfd81bd73cb51');
+<?php return array('dependencies' => array('react', 'react-dom', 'wp-api-fetch', 'wp-block-editor', 'wp-blocks', 'wp-components', 'wp-data', 'wp-element', 'wp-i18n', 'wp-primitives'), 'version' => 'bfb1de347aca75e8028f');