@slowclap/rezi-core 0.1.0-fork.1

package/dist/layout/constraints.js

@@ -0,0 +1,236 @@
+/**
+ * packages/core/src/layout/constraints.ts — Constraint resolution helpers.
+ *
+ * Why: Converts user-facing constraint values (numbers, "auto"/"full")
+ * into concrete cell sizes for a given parent rectangle.
+ */
+import { isConstraintExpr } from "../constraints/expr.js";
+import { resolveResponsiveValue } from "./responsive.js";
+const I32_MAX = 2147483647;
+/**
+ * Resolve a single size constraint to a concrete cell count relative to `parentSize`.
+ *
+ * - numbers are returned as-is
+ * - "auto" resolves to `NaN` (caller decides meaning)
+ */
+export function resolveConstraint(value, parentSize) {
+    if (value === "auto")
+        return Number.NaN;
+    if (value === "full")
+        return parentSize;
+    if (typeof value === "number")
+        return value;
+    if (isConstraintExpr(value))
+        return Number.NaN;
+    const resolved = resolveResponsiveValue(value);
+    if (typeof resolved === "number" && Number.isFinite(resolved))
+        return resolved;
+    return Number.NaN;
+}
+function resolveOptional(value, parentSize, resolvedValue) {
+    if (typeof resolvedValue === "number" && Number.isFinite(resolvedValue)) {
+        return Math.floor(resolvedValue);
+    }
+    const resolved = resolveResponsiveValue(value);
+    if (resolved === undefined)
+        return null;
+    if (isConstraintExpr(resolved))
+        return null;
+    if (typeof resolved !== "number" && resolved !== "auto" && resolved !== "full")
+        return null;
+    const n = resolveConstraint(resolved, parentSize);
+    return Number.isFinite(n) ? n : null;
+}
+function readOptionalNonNegative(value, resolvedValue) {
+    if (typeof resolvedValue === "number" && Number.isFinite(resolvedValue)) {
+        return Math.max(0, Math.floor(resolvedValue));
+    }
+    const resolved = resolveResponsiveValue(value);
+    if (resolved === undefined)
+        return undefined;
+    if (isConstraintExpr(resolved))
+        return undefined;
+    if (typeof resolved !== "number" || !Number.isFinite(resolved))
+        return undefined;
+    return Math.max(0, Math.floor(resolved));
+}
+function or0(n) {
+    return n === undefined ? 0 : n;
+}
+function orInf(n) {
+    return n === undefined ? Number.POSITIVE_INFINITY : n;
+}
+export function resolveLayoutConstraints(props, parent, mainAxis = "row", resolved) {
+    let width = resolveOptional(props.width, parent.w, resolved?.width);
+    let height = resolveOptional(props.height, parent.h, resolved?.height);
+    const flexShrink = typeof props.flexShrink === "number" &&
+        Number.isFinite(props.flexShrink) &&
+        props.flexShrink >= 0
+        ? props.flexShrink
+        : 0;
+    const flexBasisRaw = props.flexBasis;
+    const flexBasisParent = mainAxis === "row" ? parent.w : parent.h;
+    const flexBasis = resolveOptional(flexBasisRaw, flexBasisParent, resolved?.flexBasis);
+    const aspectRatio = props.aspectRatio === undefined || props.aspectRatio === null ? null : props.aspectRatio;
+    if (aspectRatio !== null && Number.isFinite(aspectRatio) && aspectRatio > 0) {
+        if (width !== null && height === null)
+            height = Math.floor(width / aspectRatio);
+        else if (height !== null && width === null)
+            width = Math.floor(height * aspectRatio);
+    }
+    return {
+        width,
+        height,
+        minWidth: or0(readOptionalNonNegative(props.minWidth, resolved?.minWidth)),
+        maxWidth: orInf(readOptionalNonNegative(props.maxWidth, resolved?.maxWidth)),
+        minHeight: or0(readOptionalNonNegative(props.minHeight, resolved?.minHeight)),
+        maxHeight: orInf(readOptionalNonNegative(props.maxHeight, resolved?.maxHeight)),
+        flex: props.flex === undefined ? 0 : props.flex,
+        flexShrink,
+        flexBasis,
+        aspectRatio,
+    };
+}
+function readFiniteFloor(value) {
+    const resolved = resolveResponsiveValue(value);
+    if (typeof resolved !== "number" || !Number.isFinite(resolved))
+        return null;
+    return Math.floor(resolved);
+}
+function readOptionalSizeConstraintFloor(value, parentSize) {
+    const resolved = resolveResponsiveValue(value);
+    if (resolved === undefined)
+        return null;
+    if (typeof resolved !== "number" && resolved !== "auto" && resolved !== "full")
+        return null;
+    const n = resolveConstraint(resolved, parentSize);
+    if (!Number.isFinite(n))
+        return null;
+    return Math.floor(n);
+}
+/**
+ * Resolve absolute positioning offsets against a parent content rect.
+ */
+export function resolveAbsolutePosition(props, contentRect, naturalSize) {
+    const left = readFiniteFloor(props.left);
+    const right = readFiniteFloor(props.right);
+    const top = readFiniteFloor(props.top);
+    const bottom = readFiniteFloor(props.bottom);
+    const explicitW = readOptionalSizeConstraintFloor(props.width, contentRect.w);
+    const explicitH = readOptionalSizeConstraintFloor(props.height, contentRect.h);
+    const hasLeft = left !== null;
+    const hasRight = right !== null;
+    const hasTop = top !== null;
+    const hasBottom = bottom !== null;
+    const hasExplicitW = explicitW !== null;
+    const hasExplicitH = explicitH !== null;
+    const naturalW = Math.max(0, Math.floor(naturalSize.w));
+    const naturalH = Math.max(0, Math.floor(naturalSize.h));
+    let ax;
+    let aw;
+    if (hasLeft && hasRight && !hasExplicitW) {
+        ax = contentRect.x + (left ?? 0);
+        aw = Math.max(0, contentRect.w - (left ?? 0) - (right ?? 0));
+    }
+    else if (hasLeft) {
+        ax = contentRect.x + (left ?? 0);
+        aw = hasExplicitW ? (explicitW ?? 0) : naturalW;
+    }
+    else if (hasRight) {
+        aw = hasExplicitW ? (explicitW ?? 0) : naturalW;
+        ax = contentRect.x + contentRect.w - (right ?? 0) - aw;
+    }
+    else {
+        ax = contentRect.x;
+        aw = hasExplicitW ? (explicitW ?? 0) : naturalW;
+    }
+    let ay;
+    let ah;
+    if (hasTop && hasBottom && !hasExplicitH) {
+        ay = contentRect.y + (top ?? 0);
+        ah = Math.max(0, contentRect.h - (top ?? 0) - (bottom ?? 0));
+    }
+    else if (hasTop) {
+        ay = contentRect.y + (top ?? 0);
+        ah = hasExplicitH ? (explicitH ?? 0) : naturalH;
+    }
+    else if (hasBottom) {
+        ah = hasExplicitH ? (explicitH ?? 0) : naturalH;
+        ay = contentRect.y + contentRect.h - (bottom ?? 0) - ah;
+    }
+    else {
+        ay = contentRect.y;
+        ah = hasExplicitH ? (explicitH ?? 0) : naturalH;
+    }
+    return {
+        x: Math.floor(ax),
+        y: Math.floor(ay),
+        w: Math.max(0, Math.floor(aw)),
+        h: Math.max(0, Math.floor(ah)),
+    };
+}
+function normalizeOverflow(v) {
+    if (v === "hidden" || v === "scroll")
+        return v;
+    return "visible";
+}
+function normalizeI32NonNegative(v) {
+    if (typeof v !== "number" || !Number.isFinite(v))
+        return 0;
+    const n = Math.trunc(v);
+    if (n <= 0)
+        return 0;
+    return n > I32_MAX ? I32_MAX : n;
+}
+/**
+ * Measure content bounds from laid-out direct children.
+ *
+ * The returned size excludes container padding/border and represents only
+ * the child content footprint measured from the content origin.
+ */
+export function measureContentBounds(children, contentOriginX, contentOriginY) {
+    let hasRenderableChild = false;
+    let maxRight = 0;
+    let maxBottom = 0;
+    for (const child of children) {
+        const { rect } = child;
+        if (rect.w <= 0 && rect.h <= 0)
+            continue;
+        hasRenderableChild = true;
+        maxRight = Math.max(maxRight, rect.x + rect.w - contentOriginX);
+        maxBottom = Math.max(maxBottom, rect.y + rect.h - contentOriginY);
+    }
+    if (!hasRenderableChild) {
+        return { contentWidth: 0, contentHeight: 0 };
+    }
+    return {
+        contentWidth: normalizeI32NonNegative(maxRight),
+        contentHeight: normalizeI32NonNegative(maxBottom),
+    };
+}
+/**
+ * Resolve overflow mode and clamp requested scroll offsets to valid ranges.
+ */
+export function resolveOverflow(props, viewportWidth, viewportHeight, contentWidth, contentHeight) {
+    const overflow = normalizeOverflow(props?.overflow);
+    const viewportW = normalizeI32NonNegative(viewportWidth);
+    const viewportH = normalizeI32NonNegative(viewportHeight);
+    const contentW = normalizeI32NonNegative(contentWidth);
+    const contentH = normalizeI32NonNegative(contentHeight);
+    const requestedScrollX = normalizeI32NonNegative(props?.scrollX);
+    const requestedScrollY = normalizeI32NonNegative(props?.scrollY);
+    const maxScrollX = Math.max(0, contentW - viewportW);
+    const maxScrollY = Math.max(0, contentH - viewportH);
+    return {
+        overflow,
+        metadata: {
+            scrollX: Math.min(requestedScrollX, maxScrollX),
+            scrollY: Math.min(requestedScrollY, maxScrollY),
+            contentWidth: contentW,
+            contentHeight: contentH,
+            viewportWidth: viewportW,
+            viewportHeight: viewportH,
+        },
+    };
+}
+//# sourceMappingURL=constraints.js.map

package/dist/layout/constraints.js.map

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

package/dist/layout/dropdownGeometry.d.ts

@@ -0,0 +1,15 @@
+import type { DropdownProps } from "../widgets/types.js";
+import type { Rect } from "./types.js";
+export type DropdownWindow = Readonly<{
+    startIndex: number;
+    endIndex: number;
+    visibleRows: number;
+    selectedIndex: number;
+    overflow: boolean;
+}>;
+export declare function computeDropdownWindow(itemCount: number, selectedIndex: number, maxVisibleRows: number, previousStartIndex?: number): DropdownWindow;
+export declare function computeDropdownGeometry(props: DropdownProps, anchorRect: Rect | null, viewport: Readonly<{
+    cols: number;
+    rows: number;
+}>): Rect | null;
+//# sourceMappingURL=dropdownGeometry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dropdownGeometry.d.ts","sourceRoot":"","sources":["../../src/layout/dropdownGeometry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC,CAAC;AAUH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,kBAAkB,SAAI,GACrB,cAAc,CA+BhB;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,IAAI,GAAG,IAAI,EACvB,QAAQ,EAAE,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACjD,IAAI,GAAG,IAAI,CAkCb"}

package/dist/layout/dropdownGeometry.js

@@ -0,0 +1,79 @@
+import { calculateAnchorPosition } from "./positioning.js";
+import { measureTextCells } from "./textMeasure.js";
+function clampIndex(value, min, max) {
+    if (!Number.isFinite(value))
+        return min;
+    const truncated = Math.trunc(value);
+    if (truncated <= min)
+        return min;
+    if (truncated >= max)
+        return max;
+    return truncated;
+}
+export function computeDropdownWindow(itemCount, selectedIndex, maxVisibleRows, previousStartIndex = 0) {
+    if (itemCount <= 0 || maxVisibleRows <= 0) {
+        return Object.freeze({
+            startIndex: 0,
+            endIndex: 0,
+            visibleRows: 0,
+            selectedIndex: 0,
+            overflow: false,
+        });
+    }
+    const visibleRows = Math.min(itemCount, Math.max(0, Math.trunc(maxVisibleRows)));
+    const normalizedSelectedIndex = clampIndex(selectedIndex, 0, itemCount - 1);
+    const maxStartIndex = Math.max(0, itemCount - visibleRows);
+    let startIndex = clampIndex(previousStartIndex, 0, maxStartIndex);
+    if (normalizedSelectedIndex < startIndex) {
+        startIndex = normalizedSelectedIndex;
+    }
+    else if (normalizedSelectedIndex >= startIndex + visibleRows) {
+        startIndex = normalizedSelectedIndex - visibleRows + 1;
+    }
+    if (startIndex > maxStartIndex)
+        startIndex = maxStartIndex;
+    return Object.freeze({
+        startIndex,
+        endIndex: startIndex + visibleRows,
+        visibleRows,
+        selectedIndex: normalizedSelectedIndex,
+        overflow: itemCount > visibleRows,
+    });
+}
+export function computeDropdownGeometry(props, anchorRect, viewport) {
+    if (!anchorRect || viewport.cols <= 0 || viewport.rows <= 0)
+        return null;
+    const items = Array.isArray(props.items) ? props.items : [];
+    let maxLabelW = 0;
+    let maxShortcutW = 0;
+    for (const item of items) {
+        if (!item || item.divider)
+            continue;
+        const labelW = measureTextCells(item.label);
+        if (labelW > maxLabelW)
+            maxLabelW = labelW;
+        const shortcut = item.shortcut;
+        if (shortcut && shortcut.length > 0) {
+            const shortcutW = measureTextCells(shortcut);
+            if (shortcutW > maxShortcutW)
+                maxShortcutW = shortcutW;
+        }
+    }
+    const gapW = maxShortcutW > 0 ? 1 : 0;
+    const contentW = Math.max(1, maxLabelW + gapW + maxShortcutW);
+    const totalW = Math.max(2, contentW + 2);
+    const totalH = Math.max(2, items.length + 2);
+    const needsScroll = totalH > viewport.rows;
+    const clampedH = needsScroll ? Math.max(2, viewport.rows) : totalH;
+    const finalW = needsScroll ? Math.max(2, Math.min(viewport.cols, totalW + 1)) : totalW;
+    const pos = calculateAnchorPosition({
+        anchor: anchorRect,
+        overlaySize: { w: finalW, h: clampedH },
+        position: props.position ?? "below-start",
+        viewport: { x: 0, y: 0, width: viewport.cols, height: viewport.rows },
+        gap: 0,
+        flip: true,
+    });
+    return pos.rect;
+}
+//# sourceMappingURL=dropdownGeometry.js.map

package/dist/layout/dropdownGeometry.js.map

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

package/dist/layout/engine/bounds.d.ts

@@ -0,0 +1,7 @@
+export declare function isI32(n: number): boolean;
+/** Clamp negative values to 0 (layout dimensions cannot be negative). */
+export declare function clampNonNegative(n: number): number;
+export declare function clampWithin(n: number, min: number, max: number): number;
+export declare function toFiniteMax(n: number, fallback: number): number;
+export declare function isPercentString(v: unknown): v is `${number}%`;
+//# sourceMappingURL=bounds.d.ts.map

package/dist/layout/engine/bounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.d.ts","sourceRoot":"","sources":["../../../src/layout/engine/bounds.ts"],"names":[],"mappings":"AAKA,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAExC;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAKvE;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,GAAG,MAAM,GAAG,CAE7D"}

package/dist/layout/engine/bounds.js

@@ -0,0 +1,25 @@
+/* --- Integer Bounds --- */
+const I32_MIN = -2147483648;
+const I32_MAX = 2147483647;
+export function isI32(n) {
+    return Number.isInteger(n) && n >= I32_MIN && n <= I32_MAX;
+}
+/** Clamp negative values to 0 (layout dimensions cannot be negative). */
+export function clampNonNegative(n) {
+    return n < 0 ? 0 : n;
+}
+export function clampWithin(n, min, max) {
+    let v = n;
+    if (v < min)
+        v = min;
+    if (v > max)
+        v = max;
+    return v;
+}
+export function toFiniteMax(n, fallback) {
+    return Number.isFinite(n) ? n : fallback;
+}
+export function isPercentString(v) {
+    return typeof v === "string" && v.endsWith("%");
+}
+//# sourceMappingURL=bounds.js.map

package/dist/layout/engine/bounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.js","sourceRoot":"","sources":["../../../src/layout/engine/bounds.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAE5B,MAAM,OAAO,GAAG,CAAC,UAAU,CAAC;AAC5B,MAAM,OAAO,GAAG,UAAU,CAAC;AAE3B,MAAM,UAAU,KAAK,CAAC,CAAS;IAC7B,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,OAAO,CAAC;AAC7D,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,gBAAgB,CAAC,CAAS;IACxC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,GAAW,EAAE,GAAW;IAC7D,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,CAAC,GAAG,GAAG;QAAE,CAAC,GAAG,GAAG,CAAC;IACrB,IAAI,CAAC,GAAG,GAAG;QAAE,CAAC,GAAG,GAAG,CAAC;IACrB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,QAAgB;IACrD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAY,CAAC,CAAC,CAAC,QAAQ,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,CAAU;IACxC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAClD,CAAC"}

package/dist/layout/engine/dirtySet.d.ts

@@ -0,0 +1,9 @@
+import type { RuntimeInstance } from "../../runtime/commit.js";
+import type { InstanceId } from "../../runtime/instance.js";
+import type { VNode } from "../../widgets/types.js";
+export declare function computeDirtyLayoutSet(root: RuntimeInstance, mountedIds: readonly InstanceId[], changedIds: readonly InstanceId[]): Set<InstanceId>;
+export declare function instanceDirtySetToVNodeDirtySet(root: RuntimeInstance, dirtyInstanceIds: ReadonlySet<InstanceId>): Set<VNode>;
+export declare function getActiveDirtySet(): Set<VNode> | null;
+export declare function pushDirtySet(dirtySet: Set<VNode> | null): void;
+export declare function popDirtySet(): void;
+//# sourceMappingURL=dirtySet.d.ts.map

package/dist/layout/engine/dirtySet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dirtySet.d.ts","sourceRoot":"","sources":["../../../src/layout/engine/dirtySet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAKpD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,SAAS,UAAU,EAAE,EACjC,UAAU,EAAE,SAAS,UAAU,EAAE,GAChC,GAAG,CAAC,UAAU,CAAC,CAgCjB;AAED,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,eAAe,EACrB,gBAAgB,EAAE,WAAW,CAAC,UAAU,CAAC,GACxC,GAAG,CAAC,KAAK,CAAC,CAiBZ;AAED,wBAAgB,iBAAiB,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAErD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,IAAI,CAG9D;AAED,wBAAgB,WAAW,IAAI,IAAI,CAIlC"}

package/dist/layout/engine/dirtySet.js

@@ -0,0 +1,67 @@
+let activeDirtySet = null;
+const dirtySetStack = [];
+export function computeDirtyLayoutSet(root, mountedIds, changedIds) {
+    const parentById = new Map();
+    const stack = [root];
+    parentById.set(root.instanceId, null);
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (!node)
+            continue;
+        for (let i = node.children.length - 1; i >= 0; i--) {
+            const child = node.children[i];
+            if (!child)
+                continue;
+            parentById.set(child.instanceId, node.instanceId);
+            stack.push(child);
+        }
+    }
+    const dirty = new Set();
+    function addWithAncestors(instanceId) {
+        if (!parentById.has(instanceId))
+            return;
+        let current = instanceId;
+        while (current !== null) {
+            if (dirty.has(current))
+                break;
+            dirty.add(current);
+            current = parentById.get(current) ?? null;
+        }
+    }
+    for (const mountedId of mountedIds)
+        addWithAncestors(mountedId);
+    for (const changedId of changedIds)
+        addWithAncestors(changedId);
+    return dirty;
+}
+export function instanceDirtySetToVNodeDirtySet(root, dirtyInstanceIds) {
+    const dirtyVNodes = new Set();
+    const stack = [root];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (!node)
+            continue;
+        if (dirtyInstanceIds.has(node.instanceId)) {
+            dirtyVNodes.add(node.vnode);
+        }
+        for (let i = node.children.length - 1; i >= 0; i--) {
+            const child = node.children[i];
+            if (child)
+                stack.push(child);
+        }
+    }
+    return dirtyVNodes;
+}
+export function getActiveDirtySet() {
+    return activeDirtySet;
+}
+export function pushDirtySet(dirtySet) {
+    dirtySetStack.push(dirtySet);
+    activeDirtySet = dirtySet;
+}
+export function popDirtySet() {
+    dirtySetStack.pop();
+    activeDirtySet =
+        dirtySetStack.length > 0 ? (dirtySetStack[dirtySetStack.length - 1] ?? null) : null;
+}
+//# sourceMappingURL=dirtySet.js.map

package/dist/layout/engine/dirtySet.js.map

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

package/dist/layout/engine/distributeInteger.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Distribute an integer total across weighted slots deterministically.
+ *
+ * - Uses floor division for base shares.
+ * - Distributes leftover cells by descending fractional part.
+ * - Breaks ties by lower slot index.
+ */
+export declare function distributeInteger(total: number, weights: readonly number[]): number[];
+//# sourceMappingURL=distributeInteger.d.ts.map

package/dist/layout/engine/distributeInteger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distributeInteger.d.ts","sourceRoot":"","sources":["../../../src/layout/engine/distributeInteger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAoDrF"}

package/dist/layout/engine/distributeInteger.js

@@ -0,0 +1,62 @@
+/**
+ * Distribute an integer total across weighted slots deterministically.
+ *
+ * - Uses floor division for base shares.
+ * - Distributes leftover cells by descending fractional part.
+ * - Breaks ties by lower slot index.
+ */
+export function distributeInteger(total, weights) {
+    const slotCount = weights.length;
+    const out = new Array(slotCount).fill(0);
+    if (slotCount === 0)
+        return out;
+    const target = Number.isFinite(total) ? Math.max(0, Math.floor(total)) : 0;
+    if (target <= 0)
+        return out;
+    const normalizedWeights = new Array(slotCount).fill(0);
+    let totalWeight = 0;
+    for (let i = 0; i < slotCount; i++) {
+        const raw = weights[i];
+        const w = typeof raw === "number" && Number.isFinite(raw) && raw > 0 ? raw : 0;
+        normalizedWeights[i] = w;
+        totalWeight += w;
+    }
+    if (totalWeight <= 0)
+        return out;
+    const fracs = new Array(slotCount).fill(0);
+    let baseSum = 0;
+    for (let i = 0; i < slotCount; i++) {
+        const w = normalizedWeights[i] ?? 0;
+        if (w <= 0)
+            continue;
+        const raw = (target * w) / totalWeight;
+        const base = Math.floor(raw);
+        out[i] = base;
+        fracs[i] = raw - base;
+        baseSum += base;
+    }
+    let remainder = target - baseSum;
+    if (remainder <= 0)
+        return out;
+    const order = [];
+    for (let i = 0; i < slotCount; i++) {
+        if ((normalizedWeights[i] ?? 0) > 0)
+            order.push(i);
+    }
+    order.sort((a, b) => {
+        const af = fracs[a] ?? 0;
+        const bf = fracs[b] ?? 0;
+        if (bf !== af)
+            return bf - af;
+        return a - b;
+    });
+    for (let i = 0; i < order.length && remainder > 0; i++) {
+        const slot = order[i] ?? -1;
+        if (slot < 0)
+            continue;
+        out[slot] = (out[slot] ?? 0) + 1;
+        remainder--;
+    }
+    return out;
+}
+//# sourceMappingURL=distributeInteger.js.map

package/dist/layout/engine/distributeInteger.js.map

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

package/dist/layout/engine/flex.d.ts

@@ -0,0 +1,25 @@
+export type FlexItem = Readonly<{
+    index: number;
+    flex: number;
+    shrink: number;
+    basis: number;
+    min: number;
+    max: number;
+}>;
+export declare function distributeFlex(remaining: number, items: readonly FlexItem[]): number[];
+/**
+ * Shrink items proportionally when their total basis exceeds available space.
+ * Matches CSS Flexbox shrink algorithm:
+ *   scaledShrink[i] = item.shrink * item.basis
+ *   reduction[i] = overflow * scaledShrink[i] / sum(scaledShrink)
+ *   Floor each item at item.min.
+ *   Iterate if any item hits min floor (redistribute to non-floored items).
+ *
+ * Returns an array of final sizes (basis - reduction) per item slot.
+ * Items with shrink=0 keep their full basis.
+ */
+export declare function shrinkFlex(available: number, items: readonly FlexItem[]): number[];
+export type Justify = "start" | "end" | "center" | "between" | "around" | "evenly";
+export declare function computeJustifyStartOffset(justify: Justify, extra: number, itemCount: number): number;
+export declare function computeJustifyExtraGap(justify: Justify, extra: number, itemCount: number, boundary: number): number;
+//# sourceMappingURL=flex.d.ts.map

package/dist/layout/engine/flex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flex.d.ts","sourceRoot":"","sources":["../../../src/layout/engine/flex.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb,CAAC,CAAC;AAeH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,EAAE,CAyHtF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,EAAE,CAmHlF;AAED,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AASnF,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,CAOR;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,MAAM,CAkBR"}