taffy-layout 1.4.0 → 2.0.1

package/README.md

@@ -1,6 +1,6 @@
-# ![Taffy Layout Logo](./taffy.svg) Taffy Layout
+# ![Taffy Layout Logo](docs/taffy.svg) Taffy Layout
 
-[English](README.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja-JP.md)
+[English](README.md) | [简体中文](docs/i18n/zh-CN/README.md) | [日本語](docs/i18n/ja-JP/README.md)
 
 [![npm version](https://badge.fury.io/js/taffy-layout.svg)](https://www.npmjs.com/package/taffy-layout)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -71,10 +71,7 @@ childStyle.height = "auto";
 // Create nodes
 const child1 = tree.newLeaf(childStyle);
 const child2 = tree.newLeaf(childStyle);
-const container = tree.newWithChildren(
-  containerStyle,
-  BigUint64Array.from([child1, child2]),
-);
+const container = tree.newWithChildren(containerStyle, [child1, child2]);
 
 // Compute layout
 tree.computeLayout(container, { width: 300, height: 200 });
@@ -93,6 +90,15 @@ console.log(
 );
 ```
 
+## 📚 Documentation
+
+- [Introduction](docs/intro.md)
+- [Getting Started](docs/getting-started/installation.md)
+- [Core Concepts](docs/core-concepts/overview.md)
+- [Styling Guide](docs/styling/index.md)
+- [Advanced Usage](docs/advanced/index.md)
+- [Cookbook](docs/cookbook/index.md)
+
 ## 📖 API Reference
 
 ### TaffyTree

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taffy-layout",
-  "version": "1.4.0",
+  "version": "2.0.1",
   "description": "WebAssembly bindings for Taffy layout library",
   "keywords": [
     "layout",
@@ -59,10 +59,14 @@
     "@semantic-release/npm": "^13.1.3",
     "@semantic-release/release-notes-generator": "^14.1.0",
     "@types/node": "^22.0.0",
+    "@types/react": "^19.2.9",
+    "@types/react-dom": "^19.2.3",
     "conventional-changelog-conventionalcommits": "^9.1.0",
     "husky": "^9.1.7",
     "lint-staged": "^16.2.7",
     "prettier": "^3.7.4",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
     "semantic-release": "^25.0.2",
     "tsx": "^4.0.0",
     "typedoc": "^0.28.15",

package/pkg/README.md

@@ -1,6 +1,6 @@
-# ![Taffy Layout Logo](./taffy.svg) Taffy Layout
+# ![Taffy Layout Logo](docs/taffy.svg) Taffy Layout
 
-[English](README.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja-JP.md)
+[English](README.md) | [简体中文](docs/i18n/zh-CN/README.md) | [日本語](docs/i18n/ja-JP/README.md)
 
 [![npm version](https://badge.fury.io/js/taffy-layout.svg)](https://www.npmjs.com/package/taffy-layout)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -71,10 +71,7 @@ childStyle.height = "auto";
 // Create nodes
 const child1 = tree.newLeaf(childStyle);
 const child2 = tree.newLeaf(childStyle);
-const container = tree.newWithChildren(
-  containerStyle,
-  BigUint64Array.from([child1, child2]),
-);
+const container = tree.newWithChildren(containerStyle, [child1, child2]);
 
 // Compute layout
 tree.computeLayout(container, { width: 300, height: 200 });
@@ -93,6 +90,15 @@ console.log(
 );
 ```
 
+## 📚 Documentation
+
+- [Introduction](docs/intro.md)
+- [Getting Started](docs/getting-started/installation.md)
+- [Core Concepts](docs/core-concepts/overview.md)
+- [Styling Guide](docs/styling/index.md)
+- [Advanced Usage](docs/advanced/index.md)
+- [Cookbook](docs/cookbook/index.md)
+
 ## 📖 API Reference
 
 ### TaffyTree

package/pkg/taffy_wasm.d.ts

@@ -2294,11 +2294,11 @@ export class TaffyTree {
    * const child1 = tree.newLeaf(new Style());
    * const child2 = tree.newLeaf(new Style());
    * const child3 = tree.newLeaf(new Style());
-   * const children = BigUint64Array.from([child1, child2, child3]);
+   * const children = [child1, child2, child3];
    * tree.setChildren(parentId, children);
    * ```
    */
-  setChildren(parent: bigint, children: BigUint64Array): void;
+  setChildren(parent: bigint, children: bigint[]): void;
   /**
    * Creates a new TaffyTree with pre-allocated capacity
    *
@@ -2455,7 +2455,7 @@ export class TaffyTree {
    * The children must already exist in the tree.
    *
    * @param style - The style configuration for the node
-   * @param children - Array of child node IDs (as BigUint64Array)
+   * @param children - Array of child node IDs (as bigint[])
    *
    * @returns - The node ID (`bigint`)
    *
@@ -2472,11 +2472,11 @@ export class TaffyTree {
    *
    * const container: bigint = tree.newWithChildren(
    *   containerStyle,
-   *   BigUint64Array.from([child1, child2])
+   *   [child1, child2]
    * );
    * ```
    */
-  newWithChildren(style: Style, children: BigUint64Array): bigint;
+  newWithChildren(style: Style, children: bigint[]): bigint;
   /**
    * Gets the child at a specific index
    *
@@ -2598,12 +2598,13 @@ export class TaffyTree {
    * ```typescript
    * const tree = new TaffyTree();
    * const parentId = tree.newLeaf(new Style());
+   * const child0 = tree.newLeaf(new Style());
    * const child1 = tree.newLeaf(new Style());
    * const child2 = tree.newLeaf(new Style());
    * const child3 = tree.newLeaf(new Style());
-   * tree.setChildren(parentId, BigUint64Array.from([child1, child2, child3]));
+   * tree.setChildren(parentId, [child0, child1, child2, child3]);
    *
-   * tree.removeChildrenRange(parentId, 1, 3);
+   * tree.removeChildrenRange(parentId, 1, 3); // Removes child1 and child2
    * ```
    */
   removeChildrenRange(parent: bigint, startIndex: number, endIndex: number): void;
@@ -2681,11 +2682,11 @@ export class TaffyTree {
    * const tree = new TaffyTree();
    * const id1 = tree.newLeaf(new Style());
    * const id2 = tree.newLeaf(new Style());
-   * const nodes = BigUint64Array.from([id1, id2]);
+   * const nodes = [id1, id2];
    * const contexts = tree.getDisjointNodeContextMut(nodes);
    * ```
    */
-  getDisjointNodeContextMut(children: BigUint64Array): any[];
+  getDisjointNodeContextMut(children: bigint[]): any[];
   /**
    * Creates a new empty TaffyTree
    *
@@ -2827,7 +2828,7 @@ export class TaffyTree {
    *
    * @param parent - The parent node ID
    *
-   * @returns - Array of child node IDs (`BigUint64Array`)
+   * @returns - Array of child node IDs
    *
    * @throws `TaffyError` if the parent node does not exist
    *
@@ -2835,10 +2836,10 @@ export class TaffyTree {
    * ```typescript
    * const tree = new TaffyTree();
    * const parentId = tree.newLeaf(new Style());
-   * const children: BigUint64Array = tree.children(parentId);
+   * const children = tree.children(parentId);
    * ```
    */
-  children(parent: bigint): BigUint64Array;
+  children(parent: bigint): bigint[];
   /**
    * Creates a new leaf node with the given style
    *
@@ -3112,7 +3113,7 @@ export interface InitOutput {
   readonly taffyerror_message: (a: number) => [number, number];
   readonly taffytree_addChild: (a: number, b: bigint, c: bigint) => [number, number];
   readonly taffytree_childCount: (a: number, b: bigint) => number;
-  readonly taffytree_children: (a: number, b: bigint) => [number, number, number, number];
+  readonly taffytree_children: (a: number, b: bigint) => [number, number, number];
   readonly taffytree_clear: (a: number) => void;
   readonly taffytree_computeLayout: (a: number, b: bigint, c: any) => [number, number];
   readonly taffytree_computeLayoutWithMeasure: (a: number, b: bigint, c: any, d: any) => [number, number];
@@ -3121,7 +3122,7 @@ export interface InitOutput {
   readonly taffytree_disableRounding: (a: number) => void;
   readonly taffytree_enableRounding: (a: number) => void;
   readonly taffytree_getChildAtIndex: (a: number, b: bigint, c: number) => [bigint, number, number];
-  readonly taffytree_getDisjointNodeContextMut: (a: number, b: number, c: number) => [number, number, number, number];
+  readonly taffytree_getDisjointNodeContextMut: (a: number, b: any) => [number, number, number, number];
   readonly taffytree_getLayout: (a: number, b: bigint) => [number, number, number];
   readonly taffytree_getNodeContext: (a: number, b: bigint) => [number, number, number];
   readonly taffytree_getNodeContextMut: (a: number, b: bigint) => [number, number, number];
@@ -3131,7 +3132,7 @@ export interface InitOutput {
   readonly taffytree_new: () => number;
   readonly taffytree_newLeaf: (a: number, b: number) => [bigint, number, number];
   readonly taffytree_newLeafWithContext: (a: number, b: number, c: any) => [bigint, number, number];
-  readonly taffytree_newWithChildren: (a: number, b: number, c: number, d: number) => [bigint, number, number];
+  readonly taffytree_newWithChildren: (a: number, b: number, c: any) => [bigint, number, number];
   readonly taffytree_parent: (a: number, b: bigint) => [number, bigint];
   readonly taffytree_printTree: (a: number, b: bigint) => [number, number];
   readonly taffytree_remove: (a: number, b: bigint) => [bigint, number, number];
@@ -3139,7 +3140,7 @@ export interface InitOutput {
   readonly taffytree_removeChildAtIndex: (a: number, b: bigint, c: number) => [bigint, number, number];
   readonly taffytree_removeChildrenRange: (a: number, b: bigint, c: number, d: number) => [number, number];
   readonly taffytree_replaceChildAtIndex: (a: number, b: bigint, c: number, d: bigint) => [bigint, number, number];
-  readonly taffytree_setChildren: (a: number, b: bigint, c: number, d: number) => [number, number];
+  readonly taffytree_setChildren: (a: number, b: bigint, c: any) => [number, number];
   readonly taffytree_setNodeContext: (a: number, b: bigint, c: any) => [number, number];
   readonly taffytree_setStyle: (a: number, b: bigint, c: number) => [number, number];
   readonly taffytree_totalNodeCount: (a: number) => number;

package/pkg/taffy_wasm.js

@@ -88,24 +88,11 @@ function getArrayJsValueFromWasm0(ptr, len) {
     return result;
 }
 
-function getArrayU64FromWasm0(ptr, len) {
-    ptr = ptr >>> 0;
-    return getBigUint64ArrayMemory0().subarray(ptr / 8, ptr / 8 + len);
-}
-
 function getArrayU8FromWasm0(ptr, len) {
     ptr = ptr >>> 0;
     return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
 }
 
-let cachedBigUint64ArrayMemory0 = null;
-function getBigUint64ArrayMemory0() {
-    if (cachedBigUint64ArrayMemory0 === null || cachedBigUint64ArrayMemory0.byteLength === 0) {
-        cachedBigUint64ArrayMemory0 = new BigUint64Array(wasm.memory.buffer);
-    }
-    return cachedBigUint64ArrayMemory0;
-}
-
 let cachedDataViewMemory0 = null;
 function getDataViewMemory0() {
     if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
@@ -140,13 +127,6 @@ function isLikeNone(x) {
     return x === undefined || x === null;
 }
 
-function passArray64ToWasm0(arg, malloc) {
-    const ptr = malloc(arg.length * 8, 8) >>> 0;
-    getBigUint64ArrayMemory0().set(arg, ptr / 8);
-    WASM_VECTOR_LEN = arg.length;
-    return ptr;
-}
-
 function passArrayJsValueToWasm0(array, malloc) {
     const ptr = malloc(array.length * 4, 4) >>> 0;
     for (let i = 0; i < array.length; i++) {
@@ -3369,16 +3349,14 @@ export class TaffyTree {
      * const child1 = tree.newLeaf(new Style());
      * const child2 = tree.newLeaf(new Style());
      * const child3 = tree.newLeaf(new Style());
-     * const children = BigUint64Array.from([child1, child2, child3]);
+     * const children = [child1, child2, child3];
      * tree.setChildren(parentId, children);
      * ```
      * @param {bigint} parent
-     * @param {BigUint64Array} children
+     * @param {bigint[]} children
      */
     setChildren(parent, children) {
-        const ptr0 = passArray64ToWasm0(children, wasm.__wbindgen_malloc);
-        const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.taffytree_setChildren(this.__wbg_ptr, parent, ptr0, len0);
+        const ret = wasm.taffytree_setChildren(this.__wbg_ptr, parent, children);
         if (ret[1]) {
             throw takeFromExternrefTable0(ret[0]);
         }
@@ -3579,7 +3557,7 @@ export class TaffyTree {
      * The children must already exist in the tree.
      *
      * @param style - The style configuration for the node
-     * @param children - Array of child node IDs (as BigUint64Array)
+     * @param children - Array of child node IDs (as bigint[])
      *
      * @returns - The node ID (`bigint`)
      *
@@ -3596,18 +3574,16 @@ export class TaffyTree {
      *
      * const container: bigint = tree.newWithChildren(
      *   containerStyle,
-     *   BigUint64Array.from([child1, child2])
+     *   [child1, child2]
      * );
      * ```
      * @param {Style} style
-     * @param {BigUint64Array} children
+     * @param {bigint[]} children
      * @returns {bigint}
      */
     newWithChildren(style, children) {
         _assertClass(style, Style);
-        const ptr0 = passArray64ToWasm0(children, wasm.__wbindgen_malloc);
-        const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.taffytree_newWithChildren(this.__wbg_ptr, style.__wbg_ptr, ptr0, len0);
+        const ret = wasm.taffytree_newWithChildren(this.__wbg_ptr, style.__wbg_ptr, children);
         if (ret[2]) {
             throw takeFromExternrefTable0(ret[1]);
         }
@@ -3786,12 +3762,13 @@ export class TaffyTree {
      * ```typescript
      * const tree = new TaffyTree();
      * const parentId = tree.newLeaf(new Style());
+     * const child0 = tree.newLeaf(new Style());
      * const child1 = tree.newLeaf(new Style());
      * const child2 = tree.newLeaf(new Style());
      * const child3 = tree.newLeaf(new Style());
-     * tree.setChildren(parentId, BigUint64Array.from([child1, child2, child3]));
+     * tree.setChildren(parentId, [child0, child1, child2, child3]);
      *
-     * tree.removeChildrenRange(parentId, 1, 3);
+     * tree.removeChildrenRange(parentId, 1, 3); // Removes child1 and child2
      * ```
      * @param {bigint} parent
      * @param {number} startIndex
@@ -3895,22 +3872,20 @@ export class TaffyTree {
      * const tree = new TaffyTree();
      * const id1 = tree.newLeaf(new Style());
      * const id2 = tree.newLeaf(new Style());
-     * const nodes = BigUint64Array.from([id1, id2]);
+     * const nodes = [id1, id2];
      * const contexts = tree.getDisjointNodeContextMut(nodes);
      * ```
-     * @param {BigUint64Array} children
+     * @param {bigint[]} children
      * @returns {any[]}
      */
     getDisjointNodeContextMut(children) {
-        const ptr0 = passArray64ToWasm0(children, wasm.__wbindgen_malloc);
-        const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.taffytree_getDisjointNodeContextMut(this.__wbg_ptr, ptr0, len0);
+        const ret = wasm.taffytree_getDisjointNodeContextMut(this.__wbg_ptr, children);
         if (ret[3]) {
             throw takeFromExternrefTable0(ret[2]);
         }
-        var v2 = getArrayJsValueFromWasm0(ret[0], ret[1]).slice();
+        var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]).slice();
         wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
-        return v2;
+        return v1;
     }
     /**
      * Creates a new empty TaffyTree
@@ -4097,7 +4072,7 @@ export class TaffyTree {
      *
      * @param parent - The parent node ID
      *
-     * @returns - Array of child node IDs (`BigUint64Array`)
+     * @returns - Array of child node IDs
      *
      * @throws `TaffyError` if the parent node does not exist
      *
@@ -4105,19 +4080,17 @@ export class TaffyTree {
      * ```typescript
      * const tree = new TaffyTree();
      * const parentId = tree.newLeaf(new Style());
-     * const children: BigUint64Array = tree.children(parentId);
+     * const children = tree.children(parentId);
      * ```
      * @param {bigint} parent
-     * @returns {BigUint64Array}
+     * @returns {bigint[]}
      */
     children(parent) {
         const ret = wasm.taffytree_children(this.__wbg_ptr, parent);
-        if (ret[3]) {
-            throw takeFromExternrefTable0(ret[2]);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
         }
-        var v1 = getArrayU64FromWasm0(ret[0], ret[1]).slice();
-        wasm.__wbindgen_free(ret[0], ret[1] * 8, 8);
-        return v1;
+        return takeFromExternrefTable0(ret[0]);
     }
     /**
      * Creates a new leaf node with the given style
@@ -4553,7 +4526,6 @@ function __wbg_get_imports() {
 function __wbg_finalize_init(instance, module) {
     wasm = instance.exports;
     __wbg_init.__wbindgen_wasm_module = module;
-    cachedBigUint64ArrayMemory0 = null;
     cachedDataViewMemory0 = null;
     cachedUint8ArrayMemory0 = null;
 

package/pkg/taffy_wasm_bg.wasm.d.ts

@@ -176,7 +176,7 @@ export const style_width: (a: number) => any;
 export const taffyerror_message: (a: number) => [number, number];
 export const taffytree_addChild: (a: number, b: bigint, c: bigint) => [number, number];
 export const taffytree_childCount: (a: number, b: bigint) => number;
-export const taffytree_children: (a: number, b: bigint) => [number, number, number, number];
+export const taffytree_children: (a: number, b: bigint) => [number, number, number];
 export const taffytree_clear: (a: number) => void;
 export const taffytree_computeLayout: (a: number, b: bigint, c: any) => [number, number];
 export const taffytree_computeLayoutWithMeasure: (a: number, b: bigint, c: any, d: any) => [number, number];
@@ -185,7 +185,7 @@ export const taffytree_dirty: (a: number, b: bigint) => [number, number, number]
 export const taffytree_disableRounding: (a: number) => void;
 export const taffytree_enableRounding: (a: number) => void;
 export const taffytree_getChildAtIndex: (a: number, b: bigint, c: number) => [bigint, number, number];
-export const taffytree_getDisjointNodeContextMut: (a: number, b: number, c: number) => [number, number, number, number];
+export const taffytree_getDisjointNodeContextMut: (a: number, b: any) => [number, number, number, number];
 export const taffytree_getLayout: (a: number, b: bigint) => [number, number, number];
 export const taffytree_getNodeContext: (a: number, b: bigint) => [number, number, number];
 export const taffytree_getNodeContextMut: (a: number, b: bigint) => [number, number, number];
@@ -195,7 +195,7 @@ export const taffytree_markDirty: (a: number, b: bigint) => [number, number];
 export const taffytree_new: () => number;
 export const taffytree_newLeaf: (a: number, b: number) => [bigint, number, number];
 export const taffytree_newLeafWithContext: (a: number, b: number, c: any) => [bigint, number, number];
-export const taffytree_newWithChildren: (a: number, b: number, c: number, d: number) => [bigint, number, number];
+export const taffytree_newWithChildren: (a: number, b: number, c: any) => [bigint, number, number];
 export const taffytree_parent: (a: number, b: bigint) => [number, bigint];
 export const taffytree_printTree: (a: number, b: bigint) => [number, number];
 export const taffytree_remove: (a: number, b: bigint) => [bigint, number, number];
@@ -203,7 +203,7 @@ export const taffytree_removeChild: (a: number, b: bigint, c: bigint) => [bigint
 export const taffytree_removeChildAtIndex: (a: number, b: bigint, c: number) => [bigint, number, number];
 export const taffytree_removeChildrenRange: (a: number, b: bigint, c: number, d: number) => [number, number];
 export const taffytree_replaceChildAtIndex: (a: number, b: bigint, c: number, d: bigint) => [bigint, number, number];
-export const taffytree_setChildren: (a: number, b: bigint, c: number, d: number) => [number, number];
+export const taffytree_setChildren: (a: number, b: bigint, c: any) => [number, number];
 export const taffytree_setNodeContext: (a: number, b: bigint, c: any) => [number, number];
 export const taffytree_setStyle: (a: number, b: bigint, c: number) => [number, number];
 export const taffytree_totalNodeCount: (a: number) => number;

package/README.ja-JP.md

@@ -1,279 +0,0 @@
-# ![Taffy Layout Logo](./taffy.svg) Taffy Layout
-
-[English](README.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja-JP.md)
-
-[![npm version](https://badge.fury.io/js/taffy-layout.svg)](https://www.npmjs.com/package/taffy-layout)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-WebAssembly で高速に動作する [Taffy](https://github.com/DioxusLabs/taffy) レイアウトエンジンの JavaScript バインディング。CSS の Flexbox と Grid をほぼネイティブ性能で利用できます。
-
-## ✨ 特徴
-
-- **🚀 高性能**：WebAssembly によるレイアウト計算
-- **📦 充実の CSS 対応**：Flexbox と CSS Grid を実装
-- **🔧 カスタム計測**：テキスト/コンテンツ計測用コールバックに対応
-- **📝 TypeScript 対応**：型定義を同梱
-- **🌳 ツリー型 API**：複雑な階層構造にも効率的
-- **💡 なじみやすい API**：CSS 風のプロパティ名と値
-
-## 📦 インストール
-
-```bash
-npm install taffy-layout
-```
-
-## 🚀 クイックスタート
-
-```typescript
-import {
-  loadTaffy,
-  TaffyTree,
-  Style,
-  Display,
-  FlexDirection,
-  AlignItems,
-} from "taffy-layout";
-
-// WebAssembly モジュールを初期化
-await loadTaffy();
-
-// レイアウトツリーを作成
-const tree = new TaffyTree();
-
-// コンテナのスタイル
-const containerStyle = new Style();
-containerStyle.display = Display.Flex;
-containerStyle.flexDirection = FlexDirection.Column;
-containerStyle.alignItems = AlignItems.Center;
-
-// size オブジェクトで設定
-containerStyle.size = { width: 300, height: 200 };
-
-// または個別の width/height プロパティを使用
-containerStyle.width = 300;
-containerStyle.height = 200;
-
-// padding オブジェクトで設定
-containerStyle.padding = { left: 10, right: 10, top: 10, bottom: 10 };
-
-// または個別の padding プロパティを使用
-containerStyle.paddingLeft = 10;
-containerStyle.paddingRight = 10;
-containerStyle.paddingTop = 10;
-containerStyle.paddingBottom = 10;
-
-// 子要素のスタイル
-const childStyle = new Style();
-childStyle.flexGrow = 1;
-childStyle.width = "100%";
-childStyle.height = "auto";
-
-// ノードを生成
-const child1 = tree.newLeaf(childStyle);
-const child2 = tree.newLeaf(childStyle);
-const container = tree.newWithChildren(
-  containerStyle,
-  BigUint64Array.from([child1, child2]),
-);
-
-// レイアウト計算
-tree.computeLayout(container, { width: 300, height: 200 });
-
-// 計算結果を取得
-const containerLayout = tree.getLayout(container);
-const child1Layout = tree.getLayout(child1);
-const child2Layout = tree.getLayout(child2);
-
-console.log(`Container: ${containerLayout.width}x${containerLayout.height}`);
-console.log(
-  `Child 1: ${child1Layout.width}x${child1Layout.height} at (${child1Layout.x}, ${child1Layout.y})`,
-);
-console.log(
-  `Child 2: ${child2Layout.width}x${child2Layout.height} at (${child2Layout.x}, ${child2Layout.y})`,
-);
-```
-
-## 📖 API リファレンス
-
-### TaffyTree
-
-レイアウトツリーを管理するメインクラス。
-
-[ドキュメントを見る](./docs/api/classes/TaffyTree.md)
-
-### Style
-
-ノードのレイアウトプロパティを設定するオブジェクト。
-
-[ドキュメントを見る](./docs/api/classes/Style.md)
-
-### Layout
-
-計算後のレイアウト結果 (読み取り専用)。
-
-[ドキュメントを見る](./docs/api/classes/Layout.md)
-
-### 列挙型
-
-[ドキュメントを見る](./docs/api/index.md#enumerations)
-
-### 型エイリアス
-
-[ドキュメントを見る](./docs/api/index.md#type-aliases)
-
-## 📐 カスタムテキスト計測
-
-テキストなど動的な計測が必要な場合は、測定コールバックを渡せます。
-
-```typescript
-const tree = new TaffyTree();
-const textStyle = new Style();
-const rootNode = tree.newLeaf(new Style());
-const measureTextWidth = (text: string) => text.length * 8;
-const measureTextHeight = (text: string, width: number) => 20;
-
-const textNode = tree.newLeafWithContext(textStyle, { text: "Hello, World!" });
-
-tree.computeLayoutWithMeasure(
-  rootNode,
-  { width: 800, height: "max-content" },
-  (known, available, node, context, style) => {
-    if (context?.text) {
-      // ここに独自のテキスト計測ロジックを実装
-      const width = measureTextWidth(context.text);
-      const height = measureTextHeight(context.text, available.width as number);
-      return { width, height };
-    }
-    return { width: 0, height: 0 };
-  },
-);
-```
-
-## 🔧 エラーハンドリング
-
-失敗する可能性のあるメソッドは `TaffyError` をスローします。try-catch で処理してください。
-
-```typescript
-try {
-  const tree = new TaffyTree();
-  const style = new Style();
-  const nodeId = tree.newLeaf(style);
-  console.log("Created node:", nodeId);
-} catch (e) {
-  if (e instanceof TaffyError) {
-    console.error("Error:", e.message);
-  }
-}
-```
-
-## 🌐 ブラウザ対応
-
-WebAssembly をサポートするモダンブラウザで動作します。
-
-- Chrome 57+
-- Firefox 52+
-- Safari 11+
-- Edge 16+
-
-## 📚 サンプル
-
-### Flexbox 行レイアウト
-
-```typescript
-const rowStyle = new Style();
-rowStyle.display = Display.Flex;
-rowStyle.flexDirection = FlexDirection.Row;
-rowStyle.justifyContent = JustifyContent.SpaceBetween;
-rowStyle.gap = { width: 10, height: 0 };
-```
-
-### CSS Grid レイアウト
-
-```typescript
-import { Style, Display, GridAutoFlow } from "taffy-layout";
-
-const gridStyle = new Style();
-gridStyle.display = Display.Grid;
-gridStyle.gridAutoFlow = GridAutoFlow.Row;
-gridStyle.gap = { width: 10, height: 10 };
-
-// グリッドアイテムの配置
-const itemStyle = new Style();
-itemStyle.gridRow = { start: 1, end: 3 }; // 2 行分
-itemStyle.gridColumn = { start: 1, end: { span: 2 } }; // 2 列分
-```
-
-### グリッドテンプレート領域
-
-```typescript
-const gridStyle = new Style();
-gridStyle.display = Display.Grid;
-gridStyle.gridTemplateAreas = [
-  { name: "header", rowStart: 1, rowEnd: 2, columnStart: 1, columnEnd: 4 },
-  { name: "sidebar", rowStart: 2, rowEnd: 4, columnStart: 1, columnEnd: 2 },
-  { name: "main", rowStart: 2, rowEnd: 4, columnStart: 2, columnEnd: 4 },
-  { name: "footer", rowStart: 4, rowEnd: 5, columnStart: 1, columnEnd: 4 },
-];
-
-// 名前付きグリッドライン
-gridStyle.gridTemplateRowNames = [
-  ["header-start"],
-  ["header-end", "content-start"],
-  ["content-end", "footer-start"],
-  ["footer-end"],
-];
-```
-
-### 絶対配置
-
-```typescript
-const absoluteStyle = new Style();
-absoluteStyle.position = Position.Absolute;
-absoluteStyle.inset = { left: 10, top: 10, right: "auto", bottom: "auto" };
-absoluteStyle.size = { width: 100, height: 50 };
-```
-
-### パーセントサイズ
-
-```typescript
-const percentStyle = new Style();
-percentStyle.size = {
-  width: "50%", // 親幅の 50%
-  height: "100%", // 親高の 100%
-};
-```
-
-### 置換要素のブロックレイアウト
-
-```typescript
-const imgStyle = new Style();
-imgStyle.itemIsReplaced = true;
-imgStyle.aspectRatio = 16 / 9; // 16:9
-imgStyle.size = { width: "100%", height: "auto" };
-```
-
-## 🏗️ ソースからのビルド
-
-```bash
-# リポジトリを取得
-git clone https://github.com/ByteLandTechnology/taffy-layout.git
-cd taffy-layout
-
-# 依存関係をインストール
-npm install
-
-# WebAssembly モジュールをビルド
-npm run build
-
-# テストを実行
-npm test
-```
-
-## 📄 ライセンス
-
-MIT License - 詳細は [LICENSE](LICENSE) を参照してください。
-
-## 🙏 謝辞
-
-- [Taffy](https://github.com/DioxusLabs/taffy) - 本プロジェクトがラップしている Rust 製レイアウトエンジン
-- [wasm-bindgen](https://github.com/rustwasm/wasm-bindgen) - Rust/WebAssembly の相互運用を支えるツール

package/README.zh-CN.md

@@ -1,279 +0,0 @@
-# ![Taffy Layout Logo](./taffy.svg) Taffy Layout
-
-[English](README.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja-JP.md)
-
-[![npm version](https://badge.fury.io/js/taffy-layout.svg)](https://www.npmjs.com/package/taffy-layout)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-基于 WebAssembly 的高性能 [Taffy](https://github.com/DioxusLabs/taffy) 布局引擎 JavaScript 绑定，将 CSS Flexbox 和 Grid 布局算法带到前端，接近原生性能。
-
-## ✨ 特性
-
-- **🚀 高性能**：WebAssembly 驱动的布局计算
-- **📦 完整 CSS 支持**：实现 Flexbox 与 CSS Grid
-- **🔧 自定义测量**：支持自定义文本/内容测量回调
-- **📝 TypeScript 友好**：完整类型定义
-- **🌳 基于树的 API**：适合复杂场景的高效树结构
-- **💡 熟悉的 API**：类 CSS 的属性名称与取值
-
-## 📦 安装
-
-```bash
-npm install taffy-layout
-```
-
-## 🚀 快速上手
-
-```typescript
-import {
-  loadTaffy,
-  TaffyTree,
-  Style,
-  Display,
-  FlexDirection,
-  AlignItems,
-} from "taffy-layout";
-
-// 初始化 WebAssembly 模块
-await loadTaffy();
-
-// 创建布局树
-const tree = new TaffyTree();
-
-// 容器样式
-const containerStyle = new Style();
-containerStyle.display = Display.Flex;
-containerStyle.flexDirection = FlexDirection.Column;
-containerStyle.alignItems = AlignItems.Center;
-
-// 可以设置 size 对象
-containerStyle.size = { width: 300, height: 200 };
-
-// 或使用独立的 width/height 属性
-containerStyle.width = 300;
-containerStyle.height = 200;
-
-// 设置 padding 对象
-containerStyle.padding = { left: 10, right: 10, top: 10, bottom: 10 };
-
-// 或使用独立的 padding 属性
-containerStyle.paddingLeft = 10;
-containerStyle.paddingRight = 10;
-containerStyle.paddingTop = 10;
-containerStyle.paddingBottom = 10;
-
-// 子元素样式
-const childStyle = new Style();
-childStyle.flexGrow = 1;
-childStyle.width = "100%";
-childStyle.height = "auto";
-
-// 创建节点
-const child1 = tree.newLeaf(childStyle);
-const child2 = tree.newLeaf(childStyle);
-const container = tree.newWithChildren(
-  containerStyle,
-  BigUint64Array.from([child1, child2]),
-);
-
-// 计算布局
-tree.computeLayout(container, { width: 300, height: 200 });
-
-// 读取结果
-const containerLayout = tree.getLayout(container);
-const child1Layout = tree.getLayout(child1);
-const child2Layout = tree.getLayout(child2);
-
-console.log(`Container: ${containerLayout.width}x${containerLayout.height}`);
-console.log(
-  `Child 1: ${child1Layout.width}x${child1Layout.height} at (${child1Layout.x}, ${child1Layout.y})`,
-);
-console.log(
-  `Child 2: ${child2Layout.width}x${child2Layout.height} at (${child2Layout.x}, ${child2Layout.y})`,
-);
-```
-
-## 📖 API 参考
-
-### TaffyTree
-
-管理布局树的核心类。
-
-[查看文档](./docs/api/classes/TaffyTree.md)
-
-### Style
-
-用于配置节点布局属性的对象。
-
-[查看文档](./docs/api/classes/Style.md)
-
-### Layout
-
-只读的布局计算结果。
-
-[查看文档](./docs/api/classes/Layout.md)
-
-### 枚举
-
-[查看文档](./docs/api/index.md#enumerations)
-
-### 类型别名
-
-[查看文档](./docs/api/index.md#type-aliases)
-
-## 📐 自定义文本测量
-
-对文本节点或需要动态测量的内容，可传入测量回调：
-
-```typescript
-const tree = new TaffyTree();
-const textStyle = new Style();
-const rootNode = tree.newLeaf(new Style());
-const measureTextWidth = (text: string) => text.length * 8;
-const measureTextHeight = (text: string, width: number) => 20;
-
-const textNode = tree.newLeafWithContext(textStyle, { text: "Hello, World!" });
-
-tree.computeLayoutWithMeasure(
-  rootNode,
-  { width: 800, height: "max-content" },
-  (known, available, node, context, style) => {
-    if (context?.text) {
-      // 在这里实现文本测量逻辑
-      const width = measureTextWidth(context.text);
-      const height = measureTextHeight(context.text, available.width as number);
-      return { width, height };
-    }
-    return { width: 0, height: 0 };
-  },
-);
-```
-
-## 🔧 错误处理
-
-可能失败的方法会抛出 `TaffyError`。使用 try-catch 处理：
-
-```typescript
-try {
-  const tree = new TaffyTree();
-  const style = new Style();
-  const nodeId = tree.newLeaf(style);
-  console.log("Created node:", nodeId);
-} catch (e) {
-  if (e instanceof TaffyError) {
-    console.error("Error:", e.message);
-  }
-}
-```
-
-## 🌐 浏览器支持
-
-支持所有具备 WebAssembly 的现代浏览器：
-
-- Chrome 57+
-- Firefox 52+
-- Safari 11+
-- Edge 16+
-
-## 📚 示例
-
-### Flexbox 行布局
-
-```typescript
-const rowStyle = new Style();
-rowStyle.display = Display.Flex;
-rowStyle.flexDirection = FlexDirection.Row;
-rowStyle.justifyContent = JustifyContent.SpaceBetween;
-rowStyle.gap = { width: 10, height: 0 };
-```
-
-### CSS Grid 布局
-
-```typescript
-import { Style, Display, GridAutoFlow } from "taffy-layout";
-
-const gridStyle = new Style();
-gridStyle.display = Display.Grid;
-gridStyle.gridAutoFlow = GridAutoFlow.Row;
-gridStyle.gap = { width: 10, height: 10 };
-
-// 网格项定位
-const itemStyle = new Style();
-itemStyle.gridRow = { start: 1, end: 3 }; // 跨 2 行
-itemStyle.gridColumn = { start: 1, end: { span: 2 } }; // 跨 2 列
-```
-
-### 网格区域模板
-
-```typescript
-const gridStyle = new Style();
-gridStyle.display = Display.Grid;
-gridStyle.gridTemplateAreas = [
-  { name: "header", rowStart: 1, rowEnd: 2, columnStart: 1, columnEnd: 4 },
-  { name: "sidebar", rowStart: 2, rowEnd: 4, columnStart: 1, columnEnd: 2 },
-  { name: "main", rowStart: 2, rowEnd: 4, columnStart: 2, columnEnd: 4 },
-  { name: "footer", rowStart: 4, rowEnd: 5, columnStart: 1, columnEnd: 4 },
-];
-
-// 命名网格线
-gridStyle.gridTemplateRowNames = [
-  ["header-start"],
-  ["header-end", "content-start"],
-  ["content-end", "footer-start"],
-  ["footer-end"],
-];
-```
-
-### 绝对定位
-
-```typescript
-const absoluteStyle = new Style();
-absoluteStyle.position = Position.Absolute;
-absoluteStyle.inset = { left: 10, top: 10, right: "auto", bottom: "auto" };
-absoluteStyle.size = { width: 100, height: 50 };
-```
-
-### 百分比尺寸
-
-```typescript
-const percentStyle = new Style();
-percentStyle.size = {
-  width: "50%", // 父级宽度的 50%
-  height: "100%", // 父级高度的 100%
-};
-```
-
-### 替换元素的块级布局
-
-```typescript
-const imgStyle = new Style();
-imgStyle.itemIsReplaced = true;
-imgStyle.aspectRatio = 16 / 9; // 16:9 宽高比
-imgStyle.size = { width: "100%", height: "auto" };
-```
-
-## 🏗️ 从源码构建
-
-```bash
-# 克隆仓库
-git clone https://github.com/ByteLandTechnology/taffy-layout.git
-cd taffy-layout
-
-# 安装依赖
-npm install
-
-# 构建 WebAssembly 模块
-npm run build
-
-# 运行测试
-npm test
-```
-
-## 📄 许可证
-
-MIT License - 详见 [LICENSE](LICENSE)。
-
-## 🙏 致谢
-
-- [Taffy](https://github.com/DioxusLabs/taffy) - 本项目封装的 Rust 布局引擎
-- [wasm-bindgen](https://github.com/rustwasm/wasm-bindgen) - Rust/WebAssembly 互操作工具