@number10/jsx-core 5.0.0

package/dist/layout/types.d.ts

@@ -0,0 +1,134 @@
+import { BackgroundProps, EdgeInsets, LayoutProps, TransformProps } from '../core-props';
+/** Size information for layout calculations */
+export interface LayoutSize {
+    width: number;
+    height: number;
+}
+/** Interface for nodes that can provide their layout dimensions dynamically */
+export interface LayoutSizeProvider {
+    __getLayoutSize: () => LayoutSize;
+}
+/** Computed padding values */
+export interface PaddingValues {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+/** Position for a child element */
+export interface Position {
+    x: number;
+    y: number;
+}
+/** Content area dimensions (container minus padding) */
+export interface ContentArea {
+    width: number;
+    height: number;
+}
+/**
+ * Renderer-neutral interface for any node that participates in layout.
+ *
+ * Any renderer (Phaser, PixiJS, ...) can satisfy this via duck-typing
+ * by attaching __layoutProps, __getLayoutSize, etc. to their node objects.
+ */
+export interface LayoutNode {
+    /** Horizontal position */
+    x?: number;
+    /** Vertical position */
+    y?: number;
+    /** Node width */
+    width?: number;
+    /** Node height */
+    height?: number;
+    /** Visibility flag */
+    visible?: boolean;
+    /** Set position (used by layout engine for child placement) */
+    setPosition?: (x: number, y: number) => void;
+    /** Set size (used by layout engine for child sizing) */
+    setSize?: (width: number, height: number) => void;
+    /** Set visibility of the node. Used by overlay/portal components on container refs. */
+    setVisible?: (visible: boolean) => void;
+    /** Parent container reference (for depth calculation and layout invalidation) */
+    parent?: LayoutContainer;
+    /** Optional logical layout parent when renderer internals use wrapper containers */
+    __layoutParent?: unknown;
+    /** Layout configuration (gap, padding, direction, etc.) */
+    __layoutProps?: Partial<LayoutProps & BackgroundProps & TransformProps>;
+    /** Get current layout-computed size */
+    __getLayoutSize?: () => LayoutSize;
+    /** Cached layout size (for invalidation) */
+    __cachedLayoutSize?: LayoutSize;
+    /** Last logical position assigned by the layout engine */
+    __layoutPosition?: Position;
+    /** Incremented whenever the layout engine assigns a position */
+    __layoutPositionRevision?: number;
+    /** Backup of original __getLayoutSize (for overlay restoration) */
+    __originalGetLayoutSize?: () => LayoutSize;
+    /** Marker: this node renders a background fill */
+    __isBackground?: boolean;
+    /** Background image reference — renderer-specific, typed by each renderer package */
+    __background?: unknown;
+}
+/**
+ * Renderer-neutral interface for container nodes that manage children.
+ * Extends LayoutNode with child-management capabilities.
+ */
+export interface LayoutContainer extends LayoutNode {
+    /** Child nodes list */
+    list?: unknown[];
+}
+/** Prepared child data for layout calculations */
+export interface LayoutChild {
+    child: LayoutContainer;
+    size: LayoutSize;
+    margin: EdgeInsets;
+}
+/** A line of children in a wrapped flex layout */
+export interface LayoutLine {
+    children: LayoutChild[];
+    mainAxisSize: number;
+    crossAxisSize: number;
+}
+/** Parsed size representation */
+export interface ParsedSize {
+    /** Size type: fixed pixels, percentage of parent, viewport units, auto, calc, fill */
+    type: 'fixed' | 'percent' | 'vw' | 'vh' | 'auto' | 'calc' | 'fill';
+    /** Numeric value */
+    value?: number;
+    /** Calc expression data (only for type='calc') */
+    calc?: CalcExpression;
+}
+/** Calc expression representation */
+export interface CalcExpression {
+    left: CalcOperand | CalcExpression;
+    operator: '+' | '-' | '*' | '/';
+    right: CalcOperand | CalcExpression;
+}
+/** Calc operand */
+export interface CalcOperand {
+    type: 'fixed' | 'percent' | 'vw' | 'vh';
+    value: number;
+}
+/** Computed metrics from children analysis */
+export interface ContentMetrics {
+    maxWidth: number;
+    maxHeight: number;
+    totalMainSize: number;
+}
+/** Complete layout context passed to strategies */
+export interface LayoutContext {
+    containerProps: LayoutProps;
+    padding: PaddingValues;
+    contentArea: ContentArea;
+    gap: {
+        horizontal: number;
+        vertical: number;
+    };
+    children: LayoutChild[];
+    /** Parent dimensions for percentage resolution */
+    parentSize?: {
+        width: number;
+        height: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/layout/types.ts"],"names":[],"mappings":"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"}

package/dist/layout/utils/child-utils.cjs

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const devConfig = require("../../dev-config.cjs");
+const sizeResolver = require("./size-resolver.cjs");
+function isLayoutChild(child) {
+  if (child.__isBackground) return false;
+  const displayMode = child.__layoutProps?.visible;
+  if (displayMode === "none") return false;
+  return typeof child.__getLayoutSize === "function";
+}
+function getMargin(child) {
+  const margin = child.__layoutProps?.margin;
+  if (typeof margin === "number") {
+    return { top: margin, right: margin, bottom: margin, left: margin };
+  }
+  return margin ?? {};
+}
+function getHorizontalMargin(margin) {
+  return (margin.left ?? 0) + (margin.right ?? 0);
+}
+function getVerticalMargin(margin) {
+  return (margin.top ?? 0) + (margin.bottom ?? 0);
+}
+function getChildSize(child, parentSize, parentPadding) {
+  if (child.__layoutProps && (child.__layoutProps.width !== void 0 || child.__layoutProps.height !== void 0)) {
+    const layoutWidth = child.__layoutProps.width;
+    const layoutHeight = child.__layoutProps.height;
+    const margin = getMargin(child);
+    const parsedWidth = sizeResolver.parseSize(layoutWidth);
+    let width2 = sizeResolver.resolveSize(
+      parsedWidth,
+      parentSize?.width,
+      child.width ?? 100,
+      parentPadding?.horizontal
+    );
+    if (parsedWidth.type === "fill") {
+      width2 = Math.max(0, width2 - getHorizontalMargin(margin));
+    }
+    const parsedHeight = sizeResolver.parseSize(layoutHeight);
+    let height2 = sizeResolver.resolveSize(
+      parsedHeight,
+      parentSize?.height,
+      child.height ?? 20,
+      parentPadding?.vertical
+    );
+    if (parsedHeight.type === "fill") {
+      height2 = Math.max(0, height2 - getVerticalMargin(margin));
+    }
+    const { minWidth, maxWidth, minHeight, maxHeight } = child.__layoutProps;
+    width2 = sizeResolver.clampSize(
+      width2,
+      minWidth,
+      maxWidth,
+      parentSize?.width,
+      child.width,
+      parentPadding?.horizontal
+    );
+    height2 = sizeResolver.clampSize(
+      height2,
+      minHeight,
+      maxHeight,
+      parentSize?.height,
+      child.height,
+      parentPadding?.vertical
+    );
+    return { width: width2, height: height2 };
+  }
+  if (child.__getLayoutSize) {
+    let size = child.__getLayoutSize();
+    if (child.__layoutProps) {
+      const { minWidth, maxWidth, minHeight, maxHeight } = child.__layoutProps;
+      size = {
+        width: sizeResolver.clampSize(
+          size.width,
+          minWidth,
+          maxWidth,
+          parentSize?.width,
+          child.width,
+          parentPadding?.horizontal
+        ),
+        height: sizeResolver.clampSize(
+          size.height,
+          minHeight,
+          maxHeight,
+          parentSize?.height,
+          child.height,
+          parentPadding?.vertical
+        )
+      };
+    }
+    return size;
+  }
+  let width = child.width ?? 100;
+  let height = child.height ?? 20;
+  if (child.__layoutProps) {
+    const { minWidth, maxWidth, minHeight, maxHeight } = child.__layoutProps;
+    width = sizeResolver.clampSize(
+      width,
+      minWidth,
+      maxWidth,
+      parentSize?.width,
+      child.width,
+      parentPadding?.horizontal
+    );
+    height = sizeResolver.clampSize(
+      height,
+      minHeight,
+      maxHeight,
+      parentSize?.height,
+      child.height,
+      parentPadding?.vertical
+    );
+  }
+  return { width, height };
+}
+function processNestedContainer(child, calculateLayoutFn, parentSize, parentPadding) {
+  if (!("list" in child) || !Array.isArray(child.list)) {
+    return;
+  }
+  const childContainer = child;
+  const childLayoutProps = child.__layoutProps ?? {};
+  devConfig.DebugLogger.log("layout", "Child is a container, calculating nested layout first");
+  calculateLayoutFn(childContainer, childLayoutProps, parentSize, parentPadding);
+}
+exports.getChildSize = getChildSize;
+exports.getMargin = getMargin;
+exports.isLayoutChild = isLayoutChild;
+exports.processNestedContainer = processNestedContainer;
+//# sourceMappingURL=child-utils.cjs.map

package/dist/layout/utils/child-utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-utils.cjs","sources":["../../../src/layout/utils/child-utils.ts"],"sourcesContent":["/**\n * Utility functions for working with layout children.\n * Renderer-neutral — operates on LayoutContainer duck-typing.\n */\nimport type { EdgeInsets, LayoutProps } from '../../core-props'\nimport { DebugLogger } from '../../dev-config'\nimport type { LayoutContainer, LayoutSize } from '../types'\nimport { clampSize, parseSize, resolveSize } from './size-resolver'\n\n/**\n * Check if a child should participate in layout calculations\n * Headless objects participate in layout (for alignment) but report size 0\n * @param child - Child game object\n * @returns True if child should be included in layout\n */\nexport function isLayoutChild(child: LayoutContainer): boolean {\n  // Skip background graphics (special role - defines container dimensions)\n  if (child.__isBackground) return false\n\n  // Check display mode from __layoutProps (visible prop)\n  const displayMode = child.__layoutProps?.visible\n\n  // Skip children with visible=\"none\" - they don't take up space (like CSS display: none)\n  // Note: visible=false / \"invisible\" still occupies space (like CSS visibility: hidden)\n  // Note: alpha=0 is different - it renders transparent but still occupies space\n  if (displayMode === 'none') return false\n\n  // Require __getLayoutSize for layout participation\n  // Note: Headless objects still participate, they just report size 0\n  return typeof child.__getLayoutSize === 'function'\n}\n\n/**\n * Get effective margin for a child\n * Normalizes margin to EdgeInsets (supports number for all sides)\n * Headless objects have no margin (positioned as point)\n * @param child - Child game object\n * @returns Edge insets\n */\nexport function getMargin(child: LayoutContainer): EdgeInsets {\n  const margin = child.__layoutProps?.margin\n  if (typeof margin === 'number') {\n    return { top: margin, right: margin, bottom: margin, left: margin }\n  }\n  return margin ?? {}\n}\n\nfunction getHorizontalMargin(margin: EdgeInsets): number {\n  return (margin.left ?? 0) + (margin.right ?? 0)\n}\n\nfunction getVerticalMargin(margin: EdgeInsets): number {\n  return (margin.top ?? 0) + (margin.bottom ?? 0)\n}\n\n/**\n * Get effective size of a child\n * Calls __getLayoutSize if available, otherwise falls back to layoutProps or default\n * Note: String sizes (percentages) are resolved later with parent context\n * @param child - Child game object\n * @param parentSize - Optional parent dimensions for percentage resolution\n * @param parentPadding - Optional parent padding for 'fill' resolution\n * @returns Width and height in pixels\n */\nexport function getChildSize(\n  child: LayoutContainer,\n  parentSize?: { width: number; height: number },\n  parentPadding?: { horizontal: number; vertical: number }\n): LayoutSize {\n  // For flex children, we still need to calculate their actual size\n  // (especially for cross-axis dimension in row/column layouts)\n  // The main-axis size will be overridden by flex distribution anyway\n\n  // If __layoutProps exists, use it (has priority for explicit layout configuration)\n  if (\n    child.__layoutProps &&\n    (child.__layoutProps.width !== undefined || child.__layoutProps.height !== undefined)\n  ) {\n    const layoutWidth = child.__layoutProps.width\n    const layoutHeight = child.__layoutProps.height\n    const margin = getMargin(child)\n\n    // Resolve width\n    const parsedWidth = parseSize(layoutWidth)\n    let width = resolveSize(\n      parsedWidth,\n      parentSize?.width,\n      child.width ?? 100,\n      parentPadding?.horizontal\n    )\n    if (parsedWidth.type === 'fill') {\n      width = Math.max(0, width - getHorizontalMargin(margin))\n    }\n\n    // Resolve height\n    const parsedHeight = parseSize(layoutHeight)\n    let height = resolveSize(\n      parsedHeight,\n      parentSize?.height,\n      child.height ?? 20,\n      parentPadding?.vertical\n    )\n    if (parsedHeight.type === 'fill') {\n      height = Math.max(0, height - getVerticalMargin(margin))\n    }\n\n    // Apply min/max constraints\n    const { minWidth, maxWidth, minHeight, maxHeight } = child.__layoutProps\n    width = clampSize(\n      width,\n      minWidth,\n      maxWidth,\n      parentSize?.width,\n      child.width,\n      parentPadding?.horizontal\n    )\n    height = clampSize(\n      height,\n      minHeight,\n      maxHeight,\n      parentSize?.height,\n      child.height,\n      parentPadding?.vertical\n    )\n\n    return { width, height }\n  }\n\n  // Use dynamic size provider if available\n  if (child.__getLayoutSize) {\n    let size = child.__getLayoutSize()\n\n    // Apply constraints if layoutProps exist (even without explicit width/height)\n    if (child.__layoutProps) {\n      const { minWidth, maxWidth, minHeight, maxHeight } = child.__layoutProps\n      size = {\n        width: clampSize(\n          size.width,\n          minWidth,\n          maxWidth,\n          parentSize?.width,\n          child.width,\n          parentPadding?.horizontal\n        ),\n        height: clampSize(\n          size.height,\n          minHeight,\n          maxHeight,\n          parentSize?.height,\n          child.height,\n          parentPadding?.vertical\n        ),\n      }\n    }\n\n    return size\n  }\n\n  // Fallback to current dimensions or default\n  let width = child.width ?? 100\n  let height = child.height ?? 20\n\n  // Apply constraints if layoutProps exist\n  if (child.__layoutProps) {\n    const { minWidth, maxWidth, minHeight, maxHeight } = child.__layoutProps\n    width = clampSize(\n      width,\n      minWidth,\n      maxWidth,\n      parentSize?.width,\n      child.width,\n      parentPadding?.horizontal\n    )\n    height = clampSize(\n      height,\n      minHeight,\n      maxHeight,\n      parentSize?.height,\n      child.height,\n      parentPadding?.vertical\n    )\n  }\n\n  return { width, height }\n}\n\n/**\n * Process a child container by recursively calculating its layout\n * @param child - Child game object to process\n * @param calculateLayoutFn - Layout calculation function (passed to avoid circular dependency)\n * @param parentSize - Optional parent dimensions for percentage resolution\n * @param parentPadding - Optional parent padding for 'fill' resolution\n */\nexport function processNestedContainer(\n  child: LayoutContainer,\n  calculateLayoutFn: (\n    container: LayoutContainer,\n    props: LayoutProps,\n    parentSize?: { width: number; height: number },\n    parentPadding?: { horizontal: number; vertical: number }\n  ) => void,\n  parentSize?: { width: number; height: number },\n  parentPadding?: { horizontal: number; vertical: number }\n): void {\n  if (!('list' in child) || !Array.isArray((child as LayoutContainer).list)) {\n    return\n  }\n\n  const childContainer = child as LayoutContainer\n  const childLayoutProps = child.__layoutProps ?? {}\n\n  DebugLogger.log('layout', 'Child is a container, calculating nested layout first')\n\n  calculateLayoutFn(childContainer, childLayoutProps, parentSize, parentPadding)\n}\n"],"names":["parseSize","width","resolveSize","height","clampSize","DebugLogger"],"mappings":"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"}

package/dist/layout/utils/child-utils.d.ts

@@ -0,0 +1,54 @@
+import { EdgeInsets, LayoutProps } from '../../core-props';
+import { LayoutContainer, LayoutSize } from '../types';
+/**
+ * Check if a child should participate in layout calculations
+ * Headless objects participate in layout (for alignment) but report size 0
+ * @param child - Child game object
+ * @returns True if child should be included in layout
+ */
+export declare function isLayoutChild(child: LayoutContainer): boolean;
+/**
+ * Get effective margin for a child
+ * Normalizes margin to EdgeInsets (supports number for all sides)
+ * Headless objects have no margin (positioned as point)
+ * @param child - Child game object
+ * @returns Edge insets
+ */
+export declare function getMargin(child: LayoutContainer): EdgeInsets;
+/**
+ * Get effective size of a child
+ * Calls __getLayoutSize if available, otherwise falls back to layoutProps or default
+ * Note: String sizes (percentages) are resolved later with parent context
+ * @param child - Child game object
+ * @param parentSize - Optional parent dimensions for percentage resolution
+ * @param parentPadding - Optional parent padding for 'fill' resolution
+ * @returns Width and height in pixels
+ */
+export declare function getChildSize(child: LayoutContainer, parentSize?: {
+    width: number;
+    height: number;
+}, parentPadding?: {
+    horizontal: number;
+    vertical: number;
+}): LayoutSize;
+/**
+ * Process a child container by recursively calculating its layout
+ * @param child - Child game object to process
+ * @param calculateLayoutFn - Layout calculation function (passed to avoid circular dependency)
+ * @param parentSize - Optional parent dimensions for percentage resolution
+ * @param parentPadding - Optional parent padding for 'fill' resolution
+ */
+export declare function processNestedContainer(child: LayoutContainer, calculateLayoutFn: (container: LayoutContainer, props: LayoutProps, parentSize?: {
+    width: number;
+    height: number;
+}, parentPadding?: {
+    horizontal: number;
+    vertical: number;
+}) => void, parentSize?: {
+    width: number;
+    height: number;
+}, parentPadding?: {
+    horizontal: number;
+    vertical: number;
+}): void;
+//# sourceMappingURL=child-utils.d.ts.map

package/dist/layout/utils/child-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-utils.d.ts","sourceRoot":"","sources":["../../../src/layout/utils/child-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE/D,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAG3D;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAe7D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CAM5D;AAUD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,eAAe,EACtB,UAAU,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC9C,aAAa,CAAC,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvD,UAAU,CAoHZ;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,eAAe,EACtB,iBAAiB,EAAE,CACjB,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,WAAW,EAClB,UAAU,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC9C,aAAa,CAAC,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,KACrD,IAAI,EACT,UAAU,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC9C,aAAa,CAAC,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvD,IAAI,CAWN"}

package/dist/layout/utils/child-utils.js

@@ -0,0 +1,129 @@
+import { DebugLogger } from "../../dev-config.js";
+import { parseSize, resolveSize, clampSize } from "./size-resolver.js";
+function isLayoutChild(child) {
+  if (child.__isBackground) return false;
+  const displayMode = child.__layoutProps?.visible;
+  if (displayMode === "none") return false;
+  return typeof child.__getLayoutSize === "function";
+}
+function getMargin(child) {
+  const margin = child.__layoutProps?.margin;
+  if (typeof margin === "number") {
+    return { top: margin, right: margin, bottom: margin, left: margin };
+  }
+  return margin ?? {};
+}
+function getHorizontalMargin(margin) {
+  return (margin.left ?? 0) + (margin.right ?? 0);
+}
+function getVerticalMargin(margin) {
+  return (margin.top ?? 0) + (margin.bottom ?? 0);
+}
+function getChildSize(child, parentSize, parentPadding) {
+  if (child.__layoutProps && (child.__layoutProps.width !== void 0 || child.__layoutProps.height !== void 0)) {
+    const layoutWidth = child.__layoutProps.width;
+    const layoutHeight = child.__layoutProps.height;
+    const margin = getMargin(child);
+    const parsedWidth = parseSize(layoutWidth);
+    let width2 = resolveSize(
+      parsedWidth,
+      parentSize?.width,
+      child.width ?? 100,
+      parentPadding?.horizontal
+    );
+    if (parsedWidth.type === "fill") {
+      width2 = Math.max(0, width2 - getHorizontalMargin(margin));
+    }
+    const parsedHeight = parseSize(layoutHeight);
+    let height2 = resolveSize(
+      parsedHeight,
+      parentSize?.height,
+      child.height ?? 20,
+      parentPadding?.vertical
+    );
+    if (parsedHeight.type === "fill") {
+      height2 = Math.max(0, height2 - getVerticalMargin(margin));
+    }
+    const { minWidth, maxWidth, minHeight, maxHeight } = child.__layoutProps;
+    width2 = clampSize(
+      width2,
+      minWidth,
+      maxWidth,
+      parentSize?.width,
+      child.width,
+      parentPadding?.horizontal
+    );
+    height2 = clampSize(
+      height2,
+      minHeight,
+      maxHeight,
+      parentSize?.height,
+      child.height,
+      parentPadding?.vertical
+    );
+    return { width: width2, height: height2 };
+  }
+  if (child.__getLayoutSize) {
+    let size = child.__getLayoutSize();
+    if (child.__layoutProps) {
+      const { minWidth, maxWidth, minHeight, maxHeight } = child.__layoutProps;
+      size = {
+        width: clampSize(
+          size.width,
+          minWidth,
+          maxWidth,
+          parentSize?.width,
+          child.width,
+          parentPadding?.horizontal
+        ),
+        height: clampSize(
+          size.height,
+          minHeight,
+          maxHeight,
+          parentSize?.height,
+          child.height,
+          parentPadding?.vertical
+        )
+      };
+    }
+    return size;
+  }
+  let width = child.width ?? 100;
+  let height = child.height ?? 20;
+  if (child.__layoutProps) {
+    const { minWidth, maxWidth, minHeight, maxHeight } = child.__layoutProps;
+    width = clampSize(
+      width,
+      minWidth,
+      maxWidth,
+      parentSize?.width,
+      child.width,
+      parentPadding?.horizontal
+    );
+    height = clampSize(
+      height,
+      minHeight,
+      maxHeight,
+      parentSize?.height,
+      child.height,
+      parentPadding?.vertical
+    );
+  }
+  return { width, height };
+}
+function processNestedContainer(child, calculateLayoutFn, parentSize, parentPadding) {
+  if (!("list" in child) || !Array.isArray(child.list)) {
+    return;
+  }
+  const childContainer = child;
+  const childLayoutProps = child.__layoutProps ?? {};
+  DebugLogger.log("layout", "Child is a container, calculating nested layout first");
+  calculateLayoutFn(childContainer, childLayoutProps, parentSize, parentPadding);
+}
+export {
+  getChildSize,
+  getMargin,
+  isLayoutChild,
+  processNestedContainer
+};
+//# sourceMappingURL=child-utils.js.map

package/dist/layout/utils/child-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-utils.js","sources":["../../../src/layout/utils/child-utils.ts"],"sourcesContent":["/**\n * Utility functions for working with layout children.\n * Renderer-neutral — operates on LayoutContainer duck-typing.\n */\nimport type { EdgeInsets, LayoutProps } from '../../core-props'\nimport { DebugLogger } from '../../dev-config'\nimport type { LayoutContainer, LayoutSize } from '../types'\nimport { clampSize, parseSize, resolveSize } from './size-resolver'\n\n/**\n * Check if a child should participate in layout calculations\n * Headless objects participate in layout (for alignment) but report size 0\n * @param child - Child game object\n * @returns True if child should be included in layout\n */\nexport function isLayoutChild(child: LayoutContainer): boolean {\n  // Skip background graphics (special role - defines container dimensions)\n  if (child.__isBackground) return false\n\n  // Check display mode from __layoutProps (visible prop)\n  const displayMode = child.__layoutProps?.visible\n\n  // Skip children with visible=\"none\" - they don't take up space (like CSS display: none)\n  // Note: visible=false / \"invisible\" still occupies space (like CSS visibility: hidden)\n  // Note: alpha=0 is different - it renders transparent but still occupies space\n  if (displayMode === 'none') return false\n\n  // Require __getLayoutSize for layout participation\n  // Note: Headless objects still participate, they just report size 0\n  return typeof child.__getLayoutSize === 'function'\n}\n\n/**\n * Get effective margin for a child\n * Normalizes margin to EdgeInsets (supports number for all sides)\n * Headless objects have no margin (positioned as point)\n * @param child - Child game object\n * @returns Edge insets\n */\nexport function getMargin(child: LayoutContainer): EdgeInsets {\n  const margin = child.__layoutProps?.margin\n  if (typeof margin === 'number') {\n    return { top: margin, right: margin, bottom: margin, left: margin }\n  }\n  return margin ?? {}\n}\n\nfunction getHorizontalMargin(margin: EdgeInsets): number {\n  return (margin.left ?? 0) + (margin.right ?? 0)\n}\n\nfunction getVerticalMargin(margin: EdgeInsets): number {\n  return (margin.top ?? 0) + (margin.bottom ?? 0)\n}\n\n/**\n * Get effective size of a child\n * Calls __getLayoutSize if available, otherwise falls back to layoutProps or default\n * Note: String sizes (percentages) are resolved later with parent context\n * @param child - Child game object\n * @param parentSize - Optional parent dimensions for percentage resolution\n * @param parentPadding - Optional parent padding for 'fill' resolution\n * @returns Width and height in pixels\n */\nexport function getChildSize(\n  child: LayoutContainer,\n  parentSize?: { width: number; height: number },\n  parentPadding?: { horizontal: number; vertical: number }\n): LayoutSize {\n  // For flex children, we still need to calculate their actual size\n  // (especially for cross-axis dimension in row/column layouts)\n  // The main-axis size will be overridden by flex distribution anyway\n\n  // If __layoutProps exists, use it (has priority for explicit layout configuration)\n  if (\n    child.__layoutProps &&\n    (child.__layoutProps.width !== undefined || child.__layoutProps.height !== undefined)\n  ) {\n    const layoutWidth = child.__layoutProps.width\n    const layoutHeight = child.__layoutProps.height\n    const margin = getMargin(child)\n\n    // Resolve width\n    const parsedWidth = parseSize(layoutWidth)\n    let width = resolveSize(\n      parsedWidth,\n      parentSize?.width,\n      child.width ?? 100,\n      parentPadding?.horizontal\n    )\n    if (parsedWidth.type === 'fill') {\n      width = Math.max(0, width - getHorizontalMargin(margin))\n    }\n\n    // Resolve height\n    const parsedHeight = parseSize(layoutHeight)\n    let height = resolveSize(\n      parsedHeight,\n      parentSize?.height,\n      child.height ?? 20,\n      parentPadding?.vertical\n    )\n    if (parsedHeight.type === 'fill') {\n      height = Math.max(0, height - getVerticalMargin(margin))\n    }\n\n    // Apply min/max constraints\n    const { minWidth, maxWidth, minHeight, maxHeight } = child.__layoutProps\n    width = clampSize(\n      width,\n      minWidth,\n      maxWidth,\n      parentSize?.width,\n      child.width,\n      parentPadding?.horizontal\n    )\n    height = clampSize(\n      height,\n      minHeight,\n      maxHeight,\n      parentSize?.height,\n      child.height,\n      parentPadding?.vertical\n    )\n\n    return { width, height }\n  }\n\n  // Use dynamic size provider if available\n  if (child.__getLayoutSize) {\n    let size = child.__getLayoutSize()\n\n    // Apply constraints if layoutProps exist (even without explicit width/height)\n    if (child.__layoutProps) {\n      const { minWidth, maxWidth, minHeight, maxHeight } = child.__layoutProps\n      size = {\n        width: clampSize(\n          size.width,\n          minWidth,\n          maxWidth,\n          parentSize?.width,\n          child.width,\n          parentPadding?.horizontal\n        ),\n        height: clampSize(\n          size.height,\n          minHeight,\n          maxHeight,\n          parentSize?.height,\n          child.height,\n          parentPadding?.vertical\n        ),\n      }\n    }\n\n    return size\n  }\n\n  // Fallback to current dimensions or default\n  let width = child.width ?? 100\n  let height = child.height ?? 20\n\n  // Apply constraints if layoutProps exist\n  if (child.__layoutProps) {\n    const { minWidth, maxWidth, minHeight, maxHeight } = child.__layoutProps\n    width = clampSize(\n      width,\n      minWidth,\n      maxWidth,\n      parentSize?.width,\n      child.width,\n      parentPadding?.horizontal\n    )\n    height = clampSize(\n      height,\n      minHeight,\n      maxHeight,\n      parentSize?.height,\n      child.height,\n      parentPadding?.vertical\n    )\n  }\n\n  return { width, height }\n}\n\n/**\n * Process a child container by recursively calculating its layout\n * @param child - Child game object to process\n * @param calculateLayoutFn - Layout calculation function (passed to avoid circular dependency)\n * @param parentSize - Optional parent dimensions for percentage resolution\n * @param parentPadding - Optional parent padding for 'fill' resolution\n */\nexport function processNestedContainer(\n  child: LayoutContainer,\n  calculateLayoutFn: (\n    container: LayoutContainer,\n    props: LayoutProps,\n    parentSize?: { width: number; height: number },\n    parentPadding?: { horizontal: number; vertical: number }\n  ) => void,\n  parentSize?: { width: number; height: number },\n  parentPadding?: { horizontal: number; vertical: number }\n): void {\n  if (!('list' in child) || !Array.isArray((child as LayoutContainer).list)) {\n    return\n  }\n\n  const childContainer = child as LayoutContainer\n  const childLayoutProps = child.__layoutProps ?? {}\n\n  DebugLogger.log('layout', 'Child is a container, calculating nested layout first')\n\n  calculateLayoutFn(childContainer, childLayoutProps, parentSize, parentPadding)\n}\n"],"names":["width","height"],"mappings":"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"}

package/dist/layout/utils/dimension-calculator.cjs

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const sizeResolver = require("./size-resolver.cjs");
+function normalizeMargin(margin) {
+  if (typeof margin === "number") {
+    return {
+      left: margin,
+      top: margin,
+      right: margin,
+      bottom: margin
+    };
+  }
+  return margin ?? {};
+}
+function getHorizontalMargin(margin) {
+  return (margin.left ?? 0) + (margin.right ?? 0);
+}
+function getVerticalMargin(margin) {
+  return (margin.top ?? 0) + (margin.bottom ?? 0);
+}
+function calculateContentDimensions(children, direction) {
+  const FLEX_CHILD_MIN_SIZE = 100;
+  let maxWidth = 0;
+  let maxHeight = 0;
+  let totalMainSize = 0;
+  for (const { size, margin, child } of children) {
+    const marginTop = margin.top ?? 0;
+    const marginBottom = margin.bottom ?? 0;
+    const marginLeft = margin.left ?? 0;
+    const marginRight = margin.right ?? 0;
+    const hasFlex = (child.__layoutProps?.flex ?? 0) > 0;
+    if (direction === "row") {
+      const childWidth = hasFlex ? FLEX_CHILD_MIN_SIZE : size.width;
+      totalMainSize += marginLeft + childWidth + marginRight;
+      const childTotalHeight = marginTop + size.height + marginBottom;
+      maxHeight = Math.max(maxHeight, childTotalHeight);
+    } else if (direction === "column") {
+      const childTotalWidth = marginLeft + size.width + marginRight;
+      maxWidth = Math.max(maxWidth, childTotalWidth);
+      const childHeight = hasFlex ? FLEX_CHILD_MIN_SIZE : size.height;
+      totalMainSize += marginTop + childHeight + marginBottom;
+    } else if (direction === "stack") {
+      const childTotalWidth = marginLeft + size.width + marginRight;
+      const childTotalHeight = marginTop + size.height + marginBottom;
+      maxWidth = Math.max(maxWidth, childTotalWidth);
+      maxHeight = Math.max(maxHeight, childTotalHeight);
+    }
+  }
+  return { maxWidth, maxHeight, totalMainSize };
+}
+function calculateContainerSize(props, metrics, padding, direction, gap, childCount, parentSize, parentPadding) {
+  let totalMainSizeWithGaps = metrics.totalMainSize;
+  if (direction !== "stack" && childCount > 1) {
+    const gapValue = direction === "row" ? gap.horizontal : gap.vertical;
+    totalMainSizeWithGaps += gapValue * (childCount - 1);
+  }
+  const contentWidth = direction === "row" ? totalMainSizeWithGaps + padding.left + padding.right : metrics.maxWidth + padding.left + padding.right;
+  const contentHeight = direction === "row" ? metrics.maxHeight + padding.top + padding.bottom : totalMainSizeWithGaps + padding.top + padding.bottom;
+  const parsedWidth = sizeResolver.parseSize(props.width);
+  let width = sizeResolver.resolveSize(parsedWidth, parentSize?.width, contentWidth, parentPadding?.horizontal);
+  const margin = normalizeMargin(props.margin);
+  if (parsedWidth.type === "fill") {
+    width = Math.max(0, width - getHorizontalMargin(margin));
+  }
+  const parsedHeight = sizeResolver.parseSize(props.height);
+  let height = sizeResolver.resolveSize(parsedHeight, parentSize?.height, contentHeight, parentPadding?.vertical);
+  if (parsedHeight.type === "fill") {
+    height = Math.max(0, height - getVerticalMargin(margin));
+  }
+  width = sizeResolver.clampSize(
+    width,
+    props.minWidth,
+    props.maxWidth,
+    parentSize?.width,
+    contentWidth,
+    void 0
+    // Don't use parentPadding - parentSize is already content-area
+  );
+  height = sizeResolver.clampSize(
+    height,
+    props.minHeight,
+    props.maxHeight,
+    parentSize?.height,
+    contentHeight,
+    void 0
+    // Don't use parentPadding - parentSize is already content-area
+  );
+  return { width, height };
+}
+function normalizePadding(padding) {
+  if (typeof padding === "number") {
+    return {
+      left: padding,
+      top: padding,
+      right: padding,
+      bottom: padding
+    };
+  }
+  return {
+    left: padding?.left ?? 0,
+    top: padding?.top ?? 0,
+    right: padding?.right ?? 0,
+    bottom: padding?.bottom ?? 0
+  };
+}
+exports.calculateContainerSize = calculateContainerSize;
+exports.calculateContentDimensions = calculateContentDimensions;
+exports.normalizePadding = normalizePadding;
+//# sourceMappingURL=dimension-calculator.cjs.map

package/dist/layout/utils/dimension-calculator.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimension-calculator.cjs","sources":["../../../src/layout/utils/dimension-calculator.ts"],"sourcesContent":["/**\n * Dimension calculation utilities for layout system\n * Handles content size tracking and container dimension computation\n */\nimport type { EdgeInsets, LayoutProps } from '../../core-props'\nimport type { LayoutChild } from '../types'\nimport { clampSize, parseSize, resolveSize } from './size-resolver'\n\n/**\n * Content dimension metrics\n */\nexport interface ContentMetrics {\n  maxWidth: number\n  maxHeight: number\n  totalMainSize: number\n}\n\n/**\n * Padding values (normalized)\n */\nexport interface PaddingValues {\n  left: number\n  top: number\n  right: number\n  bottom: number\n}\n\nfunction normalizeMargin(margin?: number | EdgeInsets): EdgeInsets {\n  if (typeof margin === 'number') {\n    return {\n      left: margin,\n      top: margin,\n      right: margin,\n      bottom: margin,\n    }\n  }\n  return margin ?? {}\n}\n\nfunction getHorizontalMargin(margin: EdgeInsets): number {\n  return (margin.left ?? 0) + (margin.right ?? 0)\n}\n\nfunction getVerticalMargin(margin: EdgeInsets): number {\n  return (margin.top ?? 0) + (margin.bottom ?? 0)\n}\n\n/**\n * Calculate content dimensions based on children and layout direction\n * For flex children, uses a minimum default size to avoid chicken-egg sizing issues\n * @param children - Array of layout children with size and margin info\n * @param direction - Layout direction ('row', 'column', or 'stack')\n * @returns Content metrics including max dimensions and total main axis size\n */\nexport function calculateContentDimensions(\n  children: LayoutChild[],\n  direction: 'row' | 'column' | 'stack'\n): ContentMetrics {\n  const FLEX_CHILD_MIN_SIZE = 100 // Minimum size for flex children in content calculation\n  let maxWidth = 0\n  let maxHeight = 0\n  let totalMainSize = 0\n\n  for (const { size, margin, child } of children) {\n    const marginTop = margin.top ?? 0\n    const marginBottom = margin.bottom ?? 0\n    const marginLeft = margin.left ?? 0\n    const marginRight = margin.right ?? 0\n\n    // Check if this child has flex property\n    const hasFlex = (child.__layoutProps?.flex ?? 0) > 0\n\n    if (direction === 'row') {\n      const childWidth = hasFlex ? FLEX_CHILD_MIN_SIZE : size.width\n      totalMainSize += marginLeft + childWidth + marginRight\n      const childTotalHeight = marginTop + size.height + marginBottom\n      maxHeight = Math.max(maxHeight, childTotalHeight)\n    } else if (direction === 'column') {\n      const childTotalWidth = marginLeft + size.width + marginRight\n      maxWidth = Math.max(maxWidth, childTotalWidth)\n      const childHeight = hasFlex ? FLEX_CHILD_MIN_SIZE : size.height\n      totalMainSize += marginTop + childHeight + marginBottom\n    } else if (direction === 'stack') {\n      // For stack, track max dimensions (children overlay)\n      const childTotalWidth = marginLeft + size.width + marginRight\n      const childTotalHeight = marginTop + size.height + marginBottom\n      maxWidth = Math.max(maxWidth, childTotalWidth)\n      maxHeight = Math.max(maxHeight, childTotalHeight)\n    }\n  }\n\n  return { maxWidth, maxHeight, totalMainSize }\n}\n\n/**\n * Calculate final container dimensions\n * @param props - Layout properties\n * @param metrics - Content metrics from calculateContentDimensions\n * @param padding - Normalized padding values\n * @param direction - Layout direction\n * @param gap - Gap between children (horizontal and vertical)\n * @param childCount - Number of children\n * @param parentSize - Parent dimensions for percentage resolution\n * @param parentPadding - Parent padding for 'fill' resolution\n * @returns Container width and height in pixels\n */\nexport function calculateContainerSize(\n  props: LayoutProps,\n  metrics: ContentMetrics,\n  padding: PaddingValues,\n  direction: 'row' | 'column' | 'stack',\n  gap: { horizontal: number; vertical: number },\n  childCount: number,\n  parentSize?: { width: number; height: number },\n  parentPadding?: { horizontal: number; vertical: number }\n): { width: number; height: number } {\n  // Add gaps to total main size (not applicable for stack)\n  let totalMainSizeWithGaps = metrics.totalMainSize\n  if (direction !== 'stack' && childCount > 1) {\n    const gapValue = direction === 'row' ? gap.horizontal : gap.vertical\n    totalMainSizeWithGaps += gapValue * (childCount - 1)\n  }\n\n  // Calculate content-based default sizes\n  const contentWidth =\n    direction === 'row'\n      ? totalMainSizeWithGaps + padding.left + padding.right\n      : metrics.maxWidth + padding.left + padding.right\n\n  const contentHeight =\n    direction === 'row'\n      ? metrics.maxHeight + padding.top + padding.bottom\n      : totalMainSizeWithGaps + padding.top + padding.bottom\n\n  // Resolve width\n  const parsedWidth = parseSize(props.width)\n  let width = resolveSize(parsedWidth, parentSize?.width, contentWidth, parentPadding?.horizontal)\n  const margin = normalizeMargin(props.margin)\n  if (parsedWidth.type === 'fill') {\n    width = Math.max(0, width - getHorizontalMargin(margin))\n  }\n\n  // Resolve height\n  const parsedHeight = parseSize(props.height)\n  let height = resolveSize(parsedHeight, parentSize?.height, contentHeight, parentPadding?.vertical)\n  if (parsedHeight.type === 'fill') {\n    height = Math.max(0, height - getVerticalMargin(margin))\n  }\n\n  // Apply min/max constraints to container size\n  // Note: parentSize is already the content-area of the parent container (after padding),\n  // so we should NOT apply parentPadding again for percentage-based constraints\n  width = clampSize(\n    width,\n    props.minWidth,\n    props.maxWidth,\n    parentSize?.width,\n    contentWidth,\n    undefined // Don't use parentPadding - parentSize is already content-area\n  )\n  height = clampSize(\n    height,\n    props.minHeight,\n    props.maxHeight,\n    parentSize?.height,\n    contentHeight,\n    undefined // Don't use parentPadding - parentSize is already content-area\n  )\n\n  return { width, height }\n}\n\n/**\n * Normalize padding from EdgeInsets or number to PaddingValues\n * @param padding - Edge insets (may be undefined, partial, or a single number for all sides)\n * @returns Normalized padding with all values defined\n */\nexport function normalizePadding(padding?: number | EdgeInsets): PaddingValues {\n  if (typeof padding === 'number') {\n    return {\n      left: padding,\n      top: padding,\n      right: padding,\n      bottom: padding,\n    }\n  }\n  return {\n    left: padding?.left ?? 0,\n    top: padding?.top ?? 0,\n    right: padding?.right ?? 0,\n    bottom: padding?.bottom ?? 0,\n  }\n}\n"],"names":["parseSize","resolveSize","clampSize"],"mappings":"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"}