flexily 0.5.1 → 0.6.0

package/src/constants.ts

@@ -1,82 +0,0 @@
-/**
- * Flexily Constants
- *
- * Yoga-compatible constants for flexbox layout.
- * These match Yoga's enum values exactly for drop-in compatibility.
- */
-
-// Flex Direction
-export const FLEX_DIRECTION_COLUMN = 0
-export const FLEX_DIRECTION_COLUMN_REVERSE = 1
-export const FLEX_DIRECTION_ROW = 2
-export const FLEX_DIRECTION_ROW_REVERSE = 3
-
-// Wrap
-export const WRAP_NO_WRAP = 0
-export const WRAP_WRAP = 1
-export const WRAP_WRAP_REVERSE = 2
-
-// Align
-export const ALIGN_AUTO = 0
-export const ALIGN_FLEX_START = 1
-export const ALIGN_CENTER = 2
-export const ALIGN_FLEX_END = 3
-export const ALIGN_STRETCH = 4
-export const ALIGN_BASELINE = 5
-export const ALIGN_SPACE_BETWEEN = 6
-export const ALIGN_SPACE_AROUND = 7
-export const ALIGN_SPACE_EVENLY = 8
-
-// Justify
-export const JUSTIFY_FLEX_START = 0
-export const JUSTIFY_CENTER = 1
-export const JUSTIFY_FLEX_END = 2
-export const JUSTIFY_SPACE_BETWEEN = 3
-export const JUSTIFY_SPACE_AROUND = 4
-export const JUSTIFY_SPACE_EVENLY = 5
-
-// Edge
-export const EDGE_LEFT = 0
-export const EDGE_TOP = 1
-export const EDGE_RIGHT = 2
-export const EDGE_BOTTOM = 3
-export const EDGE_START = 4
-export const EDGE_END = 5
-export const EDGE_HORIZONTAL = 6
-export const EDGE_VERTICAL = 7
-export const EDGE_ALL = 8
-
-// Gutter
-export const GUTTER_COLUMN = 0
-export const GUTTER_ROW = 1
-export const GUTTER_ALL = 2
-
-// Display
-export const DISPLAY_FLEX = 0
-export const DISPLAY_NONE = 1
-
-// Position Type
-export const POSITION_TYPE_STATIC = 0
-export const POSITION_TYPE_RELATIVE = 1
-export const POSITION_TYPE_ABSOLUTE = 2
-
-// Overflow
-export const OVERFLOW_VISIBLE = 0
-export const OVERFLOW_HIDDEN = 1
-export const OVERFLOW_SCROLL = 2
-
-// Direction (LTR and RTL are both supported)
-export const DIRECTION_INHERIT = 0
-export const DIRECTION_LTR = 1
-export const DIRECTION_RTL = 2
-
-// Measure Mode (for measureFunc)
-export const MEASURE_MODE_UNDEFINED = 0
-export const MEASURE_MODE_EXACTLY = 1
-export const MEASURE_MODE_AT_MOST = 2
-
-// Unit (for internal use)
-export const UNIT_UNDEFINED = 0
-export const UNIT_POINT = 1
-export const UNIT_PERCENT = 2
-export const UNIT_AUTO = 3

package/src/create-flexily.ts

@@ -1,153 +0,0 @@
-/**
- * Composable Flexily engine — createFlexily, createBareFlexily, pipe.
- *
- * FlexilyNode = Node + { setTextContent, getTextContent }.
- * No wrapper — text methods are mixed directly onto the Node instance.
- */
-
-import { Node } from "./node-zero.js"
-import { DIRECTION_LTR, MEASURE_MODE_UNDEFINED, MEASURE_MODE_AT_MOST } from "./constants.js"
-import type { TextLayoutService, ResolvedTextStyle, PreparedText } from "./text-layout.js"
-import { createMonospaceMeasurer } from "./monospace-measurer.js"
-
-// ============================================================================
-// FlexilyNode — Node + text content mixin
-// ============================================================================
-
-/** A Node with text content methods. */
-export interface FlexilyNode extends Node {
-  setTextContent(text: string, style?: Partial<ResolvedTextStyle>): void
-  getTextContent(): string | null
-}
-
-const DEFAULT_TEXT_STYLE: ResolvedTextStyle = {
-  fontShorthand: "1ch monospace",
-  fontFamily: "monospace",
-  fontSize: 1,
-  fontWeight: 400,
-  fontStyle: "normal",
-  lineHeight: 1,
-}
-
-/** Mix text content methods onto a Node. Returns the same node typed as FlexilyNode. */
-function mixTextContent(node: Node, engine: FlexilyEngine): FlexilyNode {
-  let textContent: string | null = null
-  let prepared: PreparedText | null = null
-
-  // Save originals before overriding — setTextContent needs to call the
-  // original setMeasureFunc without triggering text state clearing.
-  const origSetMeasure = node.setMeasureFunc.bind(node)
-  const origUnsetMeasure = node.unsetMeasureFunc.bind(node)
-
-  const flexNode = node as FlexilyNode
-
-  flexNode.setTextContent = function (text: string, style?: Partial<ResolvedTextStyle>): void {
-    if (!engine.textLayout) {
-      throw new Error("No TextLayoutService. Add a text plugin (withMonospace, withPretext, withTestMeasurer).")
-    }
-
-    textContent = text
-    const resolved: ResolvedTextStyle = { ...DEFAULT_TEXT_STYLE, ...style }
-    prepared = engine.textLayout.prepare({ text, style: resolved })
-
-    // Install a MeasureFunc via original (bypasses text-clearing override)
-    const p = prepared
-    origSetMeasure((width, widthMode) => {
-      if (widthMode === MEASURE_MODE_UNDEFINED) {
-        const sizes = p.intrinsicSizes()
-        const result = p.layout({ maxWidth: sizes.maxContentWidth })
-        return { width: result.width, height: result.height }
-      }
-      const result = p.layout({ maxWidth: width })
-      const usedWidth = widthMode === MEASURE_MODE_AT_MOST ? Math.min(width, result.width) : width
-      return { width: usedWidth, height: result.height }
-    })
-  }
-
-  flexNode.getTextContent = function (): string | null {
-    return textContent
-  }
-
-  // Override setMeasureFunc/unsetMeasureFunc to clear text state when
-  // the user explicitly sets a custom measure function.
-  flexNode.setMeasureFunc = function (fn) {
-    textContent = null
-    prepared = null
-    origSetMeasure(fn)
-  }
-
-  flexNode.unsetMeasureFunc = function () {
-    textContent = null
-    prepared = null
-    origUnsetMeasure()
-  }
-
-  return flexNode
-}
-
-// ============================================================================
-// Engine
-// ============================================================================
-
-/** The composable Flexily engine. */
-export interface FlexilyEngine {
-  createNode(): FlexilyNode
-  calculateLayout(root: FlexilyNode, width?: number, height?: number, direction?: number): void
-  textLayout?: TextLayoutService
-}
-
-/** A plugin that extends or configures the engine. */
-export type FlexilyPlugin = (engine: FlexilyEngine) => FlexilyEngine
-
-/**
- * Create a bare Flexily engine — no plugins, just nodes and layout.
- * Add plugins via pipe() for text measurement.
- */
-export function createBareFlexily(): FlexilyEngine {
-  const engine: FlexilyEngine = {
-    createNode(): FlexilyNode {
-      return mixTextContent(Node.create(), engine)
-    },
-    calculateLayout(root: FlexilyNode, width?: number, height?: number, direction?: number): void {
-      root.calculateLayout(width, height, direction ?? DIRECTION_LTR)
-    },
-  }
-  return engine
-}
-
-/**
- * Apply plugins to an engine, left to right.
- *
- * @example
- * ```typescript
- * const flex = pipe(createBareFlexily(), withMonospace(), withTestMeasurer())
- * ```
- */
-export function pipe(engine: FlexilyEngine, ...plugins: FlexilyPlugin[]): FlexilyEngine {
-  let result = engine
-  for (const plugin of plugins) {
-    result = plugin(result)
-  }
-  return result
-}
-
-/**
- * Create a batteries-included Flexily engine.
- *
- * Includes monospace text measurement (1 char = charWidth units).
- * For terminal UIs, the default charWidth/charHeight of 1 maps to terminal cells.
- *
- * @example
- * ```typescript
- * import { createFlexily } from "flexily"
- * const flex = createFlexily()
- * const node = flex.createNode()
- * node.setTextContent("Hello world")
- * flex.calculateLayout(node, 80, 24)
- * ```
- */
-export function createFlexily(options?: { charWidth?: number; charHeight?: number }): FlexilyEngine {
-  const engine = createBareFlexily()
-  engine.textLayout = createMonospaceMeasurer(options?.charWidth ?? 1, options?.charHeight ?? 1)
-  return engine
-}

package/src/index-classic.ts

@@ -1,110 +0,0 @@
-/**
- * Flexily Classic - Allocating Layout Engine
- *
- * The classic (allocating) variant of Flexily. Use for debugging, comparison,
- * or when you need reentrancy (concurrent layouts).
- *
- * The main export 'flexily' uses the faster zero-allocation algorithm.
- *
- * @example
- * ```typescript
- * import { Node, FLEX_DIRECTION_ROW, DIRECTION_LTR } from 'flexily/classic';
- *
- * const root = Node.create();
- * root.setWidth(80);
- * root.setFlexDirection(FLEX_DIRECTION_ROW);
- *
- * const child = Node.create();
- * child.setFlexGrow(1);
- * root.insertChild(child, 0);
- *
- * root.calculateLayout(80, 24, DIRECTION_LTR);
- * console.log(child.getComputedWidth()); // 80
- * ```
- */
-
-// Node class (classic allocating variant)
-export { Node } from "./classic/node.js"
-
-// All constants (Yoga-compatible)
-export {
-  // Flex Direction
-  FLEX_DIRECTION_COLUMN,
-  FLEX_DIRECTION_COLUMN_REVERSE,
-  FLEX_DIRECTION_ROW,
-  FLEX_DIRECTION_ROW_REVERSE,
-  // Wrap
-  WRAP_NO_WRAP,
-  WRAP_WRAP,
-  WRAP_WRAP_REVERSE,
-  // Align
-  ALIGN_AUTO,
-  ALIGN_FLEX_START,
-  ALIGN_CENTER,
-  ALIGN_FLEX_END,
-  ALIGN_STRETCH,
-  ALIGN_BASELINE,
-  ALIGN_SPACE_BETWEEN,
-  ALIGN_SPACE_AROUND,
-  ALIGN_SPACE_EVENLY,
-  // Justify
-  JUSTIFY_FLEX_START,
-  JUSTIFY_CENTER,
-  JUSTIFY_FLEX_END,
-  JUSTIFY_SPACE_BETWEEN,
-  JUSTIFY_SPACE_AROUND,
-  JUSTIFY_SPACE_EVENLY,
-  // Edge
-  EDGE_LEFT,
-  EDGE_TOP,
-  EDGE_RIGHT,
-  EDGE_BOTTOM,
-  EDGE_START,
-  EDGE_END,
-  EDGE_HORIZONTAL,
-  EDGE_VERTICAL,
-  EDGE_ALL,
-  // Gutter
-  GUTTER_COLUMN,
-  GUTTER_ROW,
-  GUTTER_ALL,
-  // Display
-  DISPLAY_FLEX,
-  DISPLAY_NONE,
-  // Position Type
-  POSITION_TYPE_STATIC,
-  POSITION_TYPE_RELATIVE,
-  POSITION_TYPE_ABSOLUTE,
-  // Overflow
-  OVERFLOW_VISIBLE,
-  OVERFLOW_HIDDEN,
-  OVERFLOW_SCROLL,
-  // Direction
-  DIRECTION_INHERIT,
-  DIRECTION_LTR,
-  DIRECTION_RTL,
-  // Measure Mode
-  MEASURE_MODE_UNDEFINED,
-  MEASURE_MODE_EXACTLY,
-  MEASURE_MODE_AT_MOST,
-  // Unit (internal, but exported for advanced use)
-  UNIT_UNDEFINED,
-  UNIT_POINT,
-  UNIT_PERCENT,
-  UNIT_AUTO,
-} from "./constants.js"
-
-// Types
-export type { BaselineFunc, Layout, MeasureFunc, Style, Value } from "./types.js"
-
-// Utility functions
-export { createDefaultStyle, createValue } from "./types.js"
-
-// Layout stats (for debugging/benchmarking)
-export {
-  layoutNodeCalls,
-  layoutSizingCalls,
-  layoutPositioningCalls,
-  layoutCacheHits,
-  resetLayoutStats,
-} from "./classic/layout.js"

package/src/index.ts

@@ -1,133 +0,0 @@
-/**
- * Flexily - Pure JavaScript Flexbox Layout Engine
- *
- * A Yoga-compatible layout engine for terminal UIs and other environments
- * where WebAssembly is not available or desirable.
- *
- * Two API levels:
- *
- * 1. Composable (recommended):
- * ```typescript
- * import { createFlexily } from "flexily"
- * const flex = createFlexily()
- * const node = flex.createNode()
- * node.setTextContent("Hello world")
- * flex.calculateLayout(node, 80, 24)
- * ```
- *
- * 2. Low-level (Yoga-compatible):
- * ```typescript
- * import { Node, DIRECTION_LTR } from "flexily"
- * const root = Node.create()
- * root.setWidth(80)
- * root.calculateLayout(80, 24, DIRECTION_LTR)
- * ```
- */
-
-// Composable API
-export { createFlexily, createBareFlexily, pipe } from "./create-flexily.js"
-export type { FlexilyEngine, FlexilyNode, FlexilyPlugin } from "./create-flexily.js"
-
-// Text measurement plugins
-export { createMonospaceMeasurer, withMonospace } from "./monospace-measurer.js"
-export { createTestMeasurer, withTestMeasurer } from "./test-measurer.js"
-export { createPretextMeasurer, withPretext } from "./pretext-measurer.js"
-export type { PretextAPI, PretextPrepared, PretextLayout } from "./pretext-measurer.js"
-
-// Text layout service types
-export type {
-  TextLayoutService,
-  PreparedText,
-  TextLayout,
-  TextLine,
-  TextConstraints,
-  IntrinsicSizes,
-  ResolvedTextStyle,
-  TextPrepareInput,
-} from "./text-layout.js"
-
-// Node class (zero-alloc version) — low-level Yoga-compatible API
-export { Node } from "./node-zero.js"
-
-// All constants (Yoga-compatible)
-export {
-  // Flex Direction
-  FLEX_DIRECTION_COLUMN,
-  FLEX_DIRECTION_COLUMN_REVERSE,
-  FLEX_DIRECTION_ROW,
-  FLEX_DIRECTION_ROW_REVERSE,
-  // Wrap
-  WRAP_NO_WRAP,
-  WRAP_WRAP,
-  WRAP_WRAP_REVERSE,
-  // Align
-  ALIGN_AUTO,
-  ALIGN_FLEX_START,
-  ALIGN_CENTER,
-  ALIGN_FLEX_END,
-  ALIGN_STRETCH,
-  ALIGN_BASELINE,
-  ALIGN_SPACE_BETWEEN,
-  ALIGN_SPACE_AROUND,
-  ALIGN_SPACE_EVENLY,
-  // Justify
-  JUSTIFY_FLEX_START,
-  JUSTIFY_CENTER,
-  JUSTIFY_FLEX_END,
-  JUSTIFY_SPACE_BETWEEN,
-  JUSTIFY_SPACE_AROUND,
-  JUSTIFY_SPACE_EVENLY,
-  // Edge
-  EDGE_LEFT,
-  EDGE_TOP,
-  EDGE_RIGHT,
-  EDGE_BOTTOM,
-  EDGE_START,
-  EDGE_END,
-  EDGE_HORIZONTAL,
-  EDGE_VERTICAL,
-  EDGE_ALL,
-  // Gutter
-  GUTTER_COLUMN,
-  GUTTER_ROW,
-  GUTTER_ALL,
-  // Display
-  DISPLAY_FLEX,
-  DISPLAY_NONE,
-  // Position Type
-  POSITION_TYPE_STATIC,
-  POSITION_TYPE_RELATIVE,
-  POSITION_TYPE_ABSOLUTE,
-  // Overflow
-  OVERFLOW_VISIBLE,
-  OVERFLOW_HIDDEN,
-  OVERFLOW_SCROLL,
-  // Direction
-  DIRECTION_INHERIT,
-  DIRECTION_LTR,
-  DIRECTION_RTL,
-  // Measure Mode
-  MEASURE_MODE_UNDEFINED,
-  MEASURE_MODE_EXACTLY,
-  MEASURE_MODE_AT_MOST,
-  // Unit (internal, but exported for advanced use)
-  UNIT_UNDEFINED,
-  UNIT_POINT,
-  UNIT_PERCENT,
-  UNIT_AUTO,
-} from "./constants.js"
-
-// Types
-export type { BaselineFunc, Layout, MeasureFunc, Style, Value } from "./types.js"
-
-// Utility functions
-export { createDefaultStyle, createValue } from "./types.js"
-
-// Layout stats (for debugging/benchmarking)
-export {
-  layoutNodeCalls,
-  layoutSizingCalls,
-  layoutPositioningCalls,
-  layoutCacheHits,
-  resetLayoutStats,
-} from "./layout-zero.js"