taffy-js 0.1.2 → 0.1.3

package/taffy_js.d.ts

@@ -81,34 +81,38 @@ export enum AlignItems {
  * How a single item is aligned along the cross axis, overriding `AlignItems`.
  */
 export enum AlignSelf {
+  /**
+   * Auto
+   */
+  Auto = 0,
   /**
    * items are aligned at the start of the cross axis.
    */
-  Start = 0,
+  Start = 1,
   /**
    * Items are aligned at the end of the cross axis.
    */
-  End = 1,
+  End = 2,
   /**
    * Items are aligned at the start of the flex-direction cross axis.
    */
-  FlexStart = 2,
+  FlexStart = 3,
   /**
    * Items are aligned at the end of the flex-direction cross axis.
    */
-  FlexEnd = 3,
+  FlexEnd = 4,
   /**
    * Items are aligned at the center of the cross axis.
    */
-  Center = 4,
+  Center = 5,
   /**
    * Items are aligned based on their baselines.
    */
-  Baseline = 5,
+  Baseline = 6,
   /**
    * Items are stretched to fill the container along the cross axis.
    */
-  Stretch = 6,
+  Stretch = 7,
 }
 
 export class AvailableSpace {
@@ -190,6 +194,21 @@ export enum Display {
   Block = 3,
 }
 
+/**
+ * Start and End are used for logical positioning (e.g. paddingStart).
+ */
+export enum Edge {
+  Left = 0,
+  Right = 1,
+  Top = 2,
+  Bottom = 3,
+  Start = 4,
+  End = 5,
+  Horizontal = 6,
+  Vertical = 7,
+  All = 8,
+}
+
 /**
  * The direction of the main axis for a flex container.
  */
@@ -252,6 +271,12 @@ export enum GridAutoFlow {
   ColumnDense = 3,
 }
 
+export enum Gutter {
+  Column = 0,
+  Row = 1,
+  All = 2,
+}
+
 /**
  * How items are distributed along the main axis.
  */
@@ -675,16 +700,46 @@ export class Style {
 export class TaffyNode {
   free(): void;
   [Symbol.dispose](): void;
-  get_layout(): Layout;
-  remove_child(child: TaffyNode): void;
-  set_children(children: Uint32Array): void;
-  compute_layout(available_space: any): void;
+  getLayout(): Layout;
+  markDirty(): void;
+  setBorder(edge: Edge, value: number): void;
+  setHeight(value: number): void;
+  setMargin(edge: Edge, value: number): void;
+  setDisplay(display: Display): void;
+  setPadding(edge: Edge, value: number): void;
+  insertChild(child: TaffyNode, index: number): void;
+  removeChild(child: TaffyNode): void;
+  setChildren(children: BigUint64Array): void;
+  setFlexGrow(value: number): void;
+  setFlexWrap(wrap: FlexWrap): void;
+  setMinWidth(value: number): void;
+  computeLayout(available_space: any): void;
+  setAlignSelf(align: AlignSelf): void;
+  setFlexBasis(value: number): void;
+  setMinHeight(value: number): void;
+  setWidthAuto(): void;
+  setAlignItems(align: AlignItems): void;
+  setFlexShrink(value: number): void;
+  setHeightAuto(): void;
+  setMarginAuto(edge: Edge): void;
+  setMeasureFunc(js_func: Function): void;
+  setPositionType(position: Position): void;
+  setWidthPercent(value: number): void;
+  setFlexDirection(direction: FlexDirection): void;
+  setHeightPercent(value: number): void;
+  setFlexBasisAuto(): void;
+  setJustifyContent(justify: JustifyContent): void;
+  setMinWidthPercent(value: number): void;
+  setFlexBasisPercent(value: number): void;
+  setMinHeightPercent(value: number): void;
   constructor(style: any);
   free(): void;
   style(): any;
-  add_child(child: TaffyNode): void;
+  setGap(gutter: Gutter, value: number): void;
+  addChild(child: TaffyNode): void;
   set_style(style: any): void;
-  id: number;
+  setWidth(value: number): void;
+  id: bigint;
 }
 
 /**
@@ -754,7 +809,7 @@ export enum TrackUnit {
  *
  * Returns a `JsValue` error if the operation fails (e.g., recursive hierarchy).
  */
-export function add_child(parent: number, child: number): void;
+export function add_child(parent: bigint, child: bigint): void;
 
 /**
  * Auto dimension constant
@@ -762,7 +817,10 @@ export function add_child(parent: number, child: number): void;
 export function auto(): Dimension;
 
 /**
- * Clear all nodes
+ * Clear all nodes from the layout tree.
+ *
+ * This removes all nodes and resets the tree to an empty state.
+ * Any existing node IDs become invalid after this call.
  */
 export function clear(): void;
 
@@ -778,7 +836,7 @@ export function clear(): void;
  *
  * Returns a `JsValue` error if the layout computation fails.
  */
-export function compute_layout(root: number, available_space: any): void;
+export function compute_layout(root: bigint, available_space: any): void;
 
 /**
  * Helper function to create a dimension
@@ -800,7 +858,7 @@ export function dimension(value: number, unit: DimensionUnit): Dimension;
  *
  * Returns a `JsValue` error if the node does not exist.
  */
-export function get_children(parent: number): Uint32Array;
+export function get_children(parent: bigint): BigUint64Array;
 
 /**
  * Retrieves the computed layout information for a specific node.
@@ -817,7 +875,7 @@ export function get_children(parent: number): Uint32Array;
  *
  * Returns a `JsValue` error if the node does not exist or layout information is unavailable.
  */
-export function get_layout(node: number): any;
+export function get_layout(node: bigint): any;
 
 /**
  * Retrieves the parent ID of a given node.
@@ -834,10 +892,13 @@ export function get_layout(node: number): any;
  *
  * Returns a `JsValue` error if internal tree access fails.
  */
-export function get_parent(node: number): number | undefined;
+export function get_parent(node: bigint): bigint | undefined;
 
 /**
- * Initialize console error panic hook
+ * Initialize the WASM module.
+ *
+ * This function is automatically called when the WASM module is loaded.
+ * It sets up the console error panic hook for better error messages in development.
  */
 export function init(): void;
 
@@ -852,7 +913,7 @@ export function init(): void;
  *
  * Returns a `JsValue` error if the node does not exist.
  */
-export function mark_dirty(node: number): void;
+export function mark_dirty(node: bigint): void;
 
 /**
  * Creates a new leaf node with the specified style.
@@ -869,7 +930,7 @@ export function mark_dirty(node: number): void;
  *
  * Returns a `JsValue` error if the style cannot be deserialized or if node creation fails.
  */
-export function new_leaf(style: any): number;
+export function new_leaf(style: any): bigint;
 
 /**
  * Creates a new node with children and the specified style.
@@ -887,10 +948,14 @@ export function new_leaf(style: any): number;
  *
  * Returns a `JsValue` error if the style cannot be deserialized or if node creation fails.
  */
-export function new_with_children(style: any, children: Uint32Array): number;
+export function new_with_children(style: any, children: BigUint64Array): bigint;
 
 /**
- * Get the total number of nodes
+ * Get the total number of nodes currently in the layout tree.
+ *
+ * # Returns
+ *
+ * The total count of all nodes in the tree.
  */
 export function node_count(): number;
 
@@ -916,7 +981,7 @@ export function px(value: number): Dimension;
  *
  * Returns a `JsValue` error if the child is not found in the parent.
  */
-export function remove_child(parent: number, child: number): void;
+export function remove_child(parent: bigint, child: bigint): void;
 
 /**
  * Removes a node from the tree and frees its resources.
@@ -929,7 +994,7 @@ export function remove_child(parent: number, child: number): void;
  *
  * Returns a `JsValue` error if the node does not exist or cannot be removed.
  */
-export function remove_node(node: number): void;
+export function remove_node(node: bigint): void;
 
 /**
  * Sets the children of a node, replacing any existing children.
@@ -943,7 +1008,7 @@ export function remove_node(node: number): void;
  *
  * Returns a `JsValue` error if the operation fails.
  */
-export function set_children(parent: number, children: Uint32Array): void;
+export function set_children(parent: bigint, children: BigUint64Array): void;
 
 /**
  * Updates the style of an existing node.
@@ -957,7 +1022,7 @@ export function set_children(parent: number, children: Uint32Array): void;
  *
  * Returns a `JsValue` error if the style cannot be deserialized or if the node does not exist.
  */
-export function set_style(node: number, style: any): void;
+export function set_style(node: bigint, style: any): void;
 
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 
@@ -1005,7 +1070,7 @@ export interface InitOutput {
   readonly __wbg_get_style_text_align: (a: number) => number;
   readonly __wbg_get_style_top: (a: number) => number;
   readonly __wbg_get_style_width: (a: number) => number;
-  readonly __wbg_get_taffynode_id: (a: number) => number;
+  readonly __wbg_get_taffynode_id: (a: number) => bigint;
   readonly __wbg_get_trackdefinition_unit: (a: number) => number;
   readonly __wbg_line_free: (a: number, b: number) => void;
   readonly __wbg_point_free: (a: number, b: number) => void;
@@ -1049,37 +1114,67 @@ export interface InitOutput {
   readonly __wbg_set_style_text_align: (a: number, b: number) => void;
   readonly __wbg_set_style_top: (a: number, b: number) => void;
   readonly __wbg_set_style_width: (a: number, b: number) => void;
-  readonly __wbg_set_taffynode_id: (a: number, b: number) => void;
+  readonly __wbg_set_taffynode_id: (a: number, b: bigint) => void;
   readonly __wbg_set_trackdefinition_unit: (a: number, b: number) => void;
   readonly __wbg_style_free: (a: number, b: number) => void;
   readonly __wbg_taffynode_free: (a: number, b: number) => void;
   readonly __wbg_trackdefinition_free: (a: number, b: number) => void;
-  readonly add_child: (a: number, b: number) => [number, number];
+  readonly add_child: (a: bigint, b: bigint) => [number, number];
   readonly auto: () => number;
   readonly clear: () => [number, number];
-  readonly compute_layout: (a: number, b: any) => [number, number];
+  readonly compute_layout: (a: bigint, b: any) => [number, number];
   readonly dimension: (a: number, b: number) => number;
-  readonly get_children: (a: number) => [number, number, number, number];
-  readonly get_layout: (a: number) => [number, number, number];
-  readonly get_parent: (a: number) => [number, number, number];
+  readonly get_children: (a: bigint) => [number, number, number, number];
+  readonly get_layout: (a: bigint) => [number, number, number];
+  readonly get_parent: (a: bigint) => [number, bigint, number, number];
   readonly init: () => void;
-  readonly mark_dirty: (a: number) => [number, number];
-  readonly new_leaf: (a: any) => [number, number, number];
-  readonly new_with_children: (a: any, b: number, c: number) => [number, number, number];
+  readonly mark_dirty: (a: bigint) => [number, number];
+  readonly new_leaf: (a: any) => [bigint, number, number];
+  readonly new_with_children: (a: any, b: number, c: number) => [bigint, number, number];
   readonly node_count: () => number;
   readonly percent: (a: number) => number;
   readonly px: (a: number) => number;
-  readonly remove_child: (a: number, b: number) => [number, number];
-  readonly remove_node: (a: number) => [number, number];
-  readonly set_children: (a: number, b: number, c: number) => [number, number];
-  readonly set_style: (a: number, b: any) => [number, number];
-  readonly taffynode_add_child: (a: number, b: number) => [number, number];
-  readonly taffynode_compute_layout: (a: number, b: any) => [number, number];
+  readonly remove_child: (a: bigint, b: bigint) => [number, number];
+  readonly remove_node: (a: bigint) => [number, number];
+  readonly set_children: (a: bigint, b: number, c: number) => [number, number];
+  readonly set_style: (a: bigint, b: any) => [number, number];
+  readonly taffynode_addChild: (a: number, b: number) => [number, number];
+  readonly taffynode_computeLayout: (a: number, b: any) => [number, number];
   readonly taffynode_free: (a: number) => [number, number];
-  readonly taffynode_get_layout: (a: number) => [number, number, number];
+  readonly taffynode_getLayout: (a: number) => [number, number, number];
+  readonly taffynode_insertChild: (a: number, b: number, c: number) => [number, number];
+  readonly taffynode_markDirty: (a: number) => [number, number];
   readonly taffynode_new: (a: any) => [number, number, number];
-  readonly taffynode_remove_child: (a: number, b: number) => [number, number];
-  readonly taffynode_set_children: (a: number, b: number, c: number) => [number, number];
+  readonly taffynode_removeChild: (a: number, b: number) => [number, number];
+  readonly taffynode_setAlignItems: (a: number, b: number) => [number, number];
+  readonly taffynode_setAlignSelf: (a: number, b: number) => [number, number];
+  readonly taffynode_setBorder: (a: number, b: number, c: number) => [number, number];
+  readonly taffynode_setChildren: (a: number, b: number, c: number) => [number, number];
+  readonly taffynode_setDisplay: (a: number, b: number) => [number, number];
+  readonly taffynode_setFlexBasis: (a: number, b: number) => [number, number];
+  readonly taffynode_setFlexBasisAuto: (a: number) => [number, number];
+  readonly taffynode_setFlexBasisPercent: (a: number, b: number) => [number, number];
+  readonly taffynode_setFlexDirection: (a: number, b: number) => [number, number];
+  readonly taffynode_setFlexGrow: (a: number, b: number) => [number, number];
+  readonly taffynode_setFlexShrink: (a: number, b: number) => [number, number];
+  readonly taffynode_setFlexWrap: (a: number, b: number) => [number, number];
+  readonly taffynode_setGap: (a: number, b: number, c: number) => [number, number];
+  readonly taffynode_setHeight: (a: number, b: number) => [number, number];
+  readonly taffynode_setHeightAuto: (a: number) => [number, number];
+  readonly taffynode_setHeightPercent: (a: number, b: number) => [number, number];
+  readonly taffynode_setJustifyContent: (a: number, b: number) => [number, number];
+  readonly taffynode_setMargin: (a: number, b: number, c: number) => [number, number];
+  readonly taffynode_setMarginAuto: (a: number, b: number) => [number, number];
+  readonly taffynode_setMeasureFunc: (a: number, b: any) => [number, number];
+  readonly taffynode_setMinHeight: (a: number, b: number) => [number, number];
+  readonly taffynode_setMinHeightPercent: (a: number, b: number) => [number, number];
+  readonly taffynode_setMinWidth: (a: number, b: number) => [number, number];
+  readonly taffynode_setMinWidthPercent: (a: number, b: number) => [number, number];
+  readonly taffynode_setPadding: (a: number, b: number, c: number) => [number, number];
+  readonly taffynode_setPositionType: (a: number, b: number) => [number, number];
+  readonly taffynode_setWidth: (a: number, b: number) => [number, number];
+  readonly taffynode_setWidthAuto: (a: number) => [number, number];
+  readonly taffynode_setWidthPercent: (a: number, b: number) => [number, number];
   readonly taffynode_set_style: (a: number, b: any) => [number, number];
   readonly taffynode_style: (a: number) => [number, number, number];
   readonly __wbg_set_layout_x: (a: number, b: number) => void;