flexily 0.3.0 → 0.3.1

package/README.md

@@ -71,6 +71,8 @@ Most developers should use a framework built on Flexily, not Flexily directly. F
 npm install flexily
 ```
 
+**Runtimes:** Bun >= 1.0, Node.js >= 18. Pure JavaScript — no native or WASM dependencies.
+
 ## Performance
 
 Flexily and Yoga each win in different scenarios:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "flexily",
-  "version": "0.3.0",
-  "description": "Pure JavaScript flexbox layout engine — Yoga-compatible API, faster initial layout, smaller bundle, no WASM",
+  "version": "0.3.1",
+  "description": "Pure JavaScript flexbox layout engine \u2014 Yoga-compatible API, faster initial layout, smaller bundle, no WASM",
   "keywords": [
     "canvas-ui",
     "css",
@@ -28,20 +28,19 @@
     "url": "https://github.com/beorn/flexily.git"
   },
   "files": [
-    "dist",
     "src"
   ],
   "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "types": "./src/index.ts",
+      "import": "./src/index.ts"
     },
     "./classic": {
-      "types": "./dist/index-classic.d.ts",
-      "import": "./dist/index-classic.js"
+      "types": "./src/classic/index.ts",
+      "import": "./src/classic/index.ts"
     }
   },
   "publishConfig": {
@@ -52,25 +51,18 @@
     "test": "bun test",
     "test:watch": "bun test --watch",
     "bench": "bunx --bun vitest bench",
-    "bench:standalone": "bun bench/run.ts",
-    "bench:compare": "bun bench/compare.ts",
     "typecheck": "tsc --noEmit",
-    "build:docs": "cd docs && bun run docs:build",
-    "ci": "bun run typecheck && bun test",
-    "prepare": "git config core.hooksPath .githooks 2>/dev/null || true"
-  },
-  "dependencies": {
-    "debug": "^4.4.3"
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
   },
   "devDependencies": {
-    "@types/bun": "^1.3.0",
-    "@types/debug": "^4.1.12",
-    "loggily": "github:beorn/loggily",
-    "typescript": "^5.7.3",
+    "typescript": "^5.9.3",
+    "vitepress": "^1.6.3",
+    "vitest": "^3.1.0",
     "yoga-wasm-web": "^0.3.3"
   },
   "engines": {
-    "bun": ">=1.0",
-    "node": ">=18"
+    "node": ">=23.6.0"
   }
-}
+}

package/src/classic/layout.ts

@@ -123,9 +123,9 @@ export function resolveEdgeBorderValue(
 
   // Logical takes precedence if set (NaN = not set)
   if (logicalSlot !== undefined && !Number.isNaN(arr[logicalSlot])) {
-    return arr[logicalSlot]
+    return arr[logicalSlot]!
   }
-  return arr[physicalIndex]
+  return arr[physicalIndex]!
 }
 
 export function markSubtreeLayoutSeen(node: Node): void {

package/src/layout-helpers.ts

@@ -154,7 +154,7 @@ export function resolveEdgeBorderValue(
 
   // Logical takes precedence if set (NaN = not set)
   if (logicalSlot !== undefined && !Number.isNaN(arr[logicalSlot])) {
-    return arr[logicalSlot]
+    return arr[logicalSlot]!
   }
-  return arr[physicalIndex]
+  return arr[physicalIndex]!
 }

package/dist/classic/layout.d.ts

@@ -1,57 +0,0 @@
-/**
- * Flexily Layout Algorithm
- *
- * Core flexbox layout computation extracted from node.ts.
- * Based on Planning-nl/flexbox.js reference implementation.
- */
-import type { Node } from "./node.js";
-import type { Value } from "../types.js";
-/**
- * Check if flex direction is row-oriented (horizontal main axis).
- */
-export declare function isRowDirection(flexDirection: number): boolean;
-/**
- * Check if flex direction is reversed.
- */
-export declare function isReverseDirection(flexDirection: number): boolean;
-/**
- * Resolve logical (START/END) margins/padding to physical values.
- * EDGE_START/EDGE_END always resolve along the inline (horizontal) axis:
- * - LTR: START→left, END→right
- * - RTL: START→right, END→left
- *
- * Physical edges (LEFT/RIGHT/TOP/BOTTOM) are used directly.
- * When both physical and logical are set, logical takes precedence.
- */
-export declare function resolveEdgeValue(arr: [Value, Value, Value, Value, Value, Value], physicalIndex: number, // 0=left, 1=top, 2=right, 3=bottom
-flexDirection: number, availableSize: number, direction?: number): number;
-/**
- * Check if a logical edge margin is set to auto.
- */
-export declare function isEdgeAuto(arr: [Value, Value, Value, Value, Value, Value], physicalIndex: number, flexDirection: number, direction?: number): boolean;
-/**
- * Resolve logical (START/END) border widths to physical values.
- * Border values are plain numbers (always points), so resolution is simpler
- * than for margin/padding. Uses NaN as the "not set" sentinel for logical slots.
- * When both physical and logical are set, logical takes precedence.
- */
-export declare function resolveEdgeBorderValue(arr: [number, number, number, number, number, number], physicalIndex: number, // 0=left, 1=top, 2=right, 3=bottom
-_flexDirection: number, direction?: number): number;
-export declare function markSubtreeLayoutSeen(node: Node): void;
-export declare function countNodes(node: Node): number;
-/**
- * Compute layout for a node tree.
- *
- * @param root - Root node of the tree
- * @param availableWidth - Available width for layout
- * @param availableHeight - Available height for layout
- * @param direction - Text direction (LTR or RTL), affects horizontal edge resolution
- */
-export declare function computeLayout(root: Node, availableWidth: number, availableHeight: number, direction?: number): void;
-export declare let layoutNodeCalls: number;
-export declare let resolveEdgeCalls: number;
-export declare let layoutSizingCalls: number;
-export declare let layoutPositioningCalls: number;
-export declare let layoutCacheHits: number;
-export declare function resetLayoutStats(): void;
-//# sourceMappingURL=layout.d.ts.map

package/dist/classic/layout.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/classic/layout.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAQxC;;GAEG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAEjE;AA4BD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAC/C,aAAa,EAAE,MAAM,EAAE,mCAAmC;AAC1D,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,SAAS,GAAE,MAAwB,GAClC,MAAM,CAUR;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAC/C,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,SAAS,GAAE,MAAwB,GAClC,OAAO,CAUT;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACrD,aAAa,EAAE,MAAM,EAAE,mCAAmC;AAC1D,cAAc,EAAE,MAAM,EACtB,SAAS,GAAE,MAAwB,GAClC,MAAM,CAaR;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAKtD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAM7C;AA6OD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,IAAI,EACV,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,SAAS,GAAE,MAAwB,GAClC,IAAI,CAGN;AAw2CD,eAAO,IAAI,eAAe,QAAI,CAAA;AAC9B,eAAO,IAAI,gBAAgB,QAAI,CAAA;AAC/B,eAAO,IAAI,iBAAiB,QAAI,CAAA;AAChC,eAAO,IAAI,sBAAsB,QAAI,CAAA;AACrC,eAAO,IAAI,eAAe,QAAI,CAAA;AAE9B,wBAAgB,gBAAgB,IAAI,IAAI,CAMvC"}