@smoove/core 0.1.0

package/dist/layout/block.d.ts

@@ -0,0 +1,54 @@
+import Konva from "konva";
+import type { KMLayoutNode, LayoutBox } from "./contract.js";
+import type { EdgeValue, FlexChildProps, FlexProps, SizeValue } from "./flex/types.js";
+export type EdgeColor = string | [string, string] | [string, string, string, string] | {
+    top?: string;
+    right?: string;
+    bottom?: string;
+    left?: string;
+};
+export type GradientStop = [number, string];
+export type GradientBackground = {
+    gradient: {
+        type: "linear" | "radial";
+        stops: GradientStop[];
+        angle?: number;
+    };
+};
+export type BackgroundValue = string | GradientBackground;
+export type ShadowProps = {
+    color?: string;
+    blur?: number;
+    offsetX?: number;
+    offsetY?: number;
+    opacity?: number;
+};
+export type BlockConfig = Omit<Konva.GroupConfig, "width" | "height"> & FlexProps & FlexChildProps & {
+    width?: SizeValue;
+    height?: SizeValue;
+    borderSize?: EdgeValue;
+    borderColor?: EdgeColor;
+    borderStyle?: "solid" | "dashed";
+    shadow?: ShadowProps;
+    background?: BackgroundValue;
+    cornerRadius?: number | number[];
+};
+export declare class Block extends Konva.Group implements KMLayoutNode {
+    readonly _kmRole: "container";
+    private readonly _bg;
+    constructor(config: BlockConfig);
+    /**
+     * Lay this Block out as a standalone Flexily root, sizing it to its children
+     * (hug) or to its explicit width/height, then restyle the background. Called
+     * by Sequence each frame for direct-child Blocks; nested Blocks are laid out
+     * by their parent Flex instead.
+     */
+    computeLayout(): void;
+    /** @internal — {@link KMLayoutNode}: lay self out as a flex root (Sequence calls this). */
+    _kmComputeLayout(): void;
+    /** @internal — {@link KMLayoutNode}: write the computed box back + restyle the background. */
+    _kmPlace(box: LayoutBox): void;
+    /** @internal */
+    _layoutBackground(): void;
+}
+//# sourceMappingURL=block.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../src/layout/block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG7D,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEvF,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,CAAC,MAAM,EAAE,MAAM,CAAC,GAChB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAChC;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAErE,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC5C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE;QACR,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;QAC1B,KAAK,EAAE,YAAY,EAAE,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC;AACF,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,kBAAkB,CAAC;AAE1D,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,OAAO,GAAG,QAAQ,CAAC,GACnE,SAAS,GACT,cAAc,GAAG;IACf,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAClC,CAAC;AAsCJ,qBAAa,KAAM,SAAQ,KAAK,CAAC,KAAM,YAAW,YAAY;IAC5D,QAAQ,CAAC,OAAO,EAAG,WAAW,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;gBAErB,MAAM,EAAE,WAAW;IAuC/B;;;;;OAKG;IACH,aAAa,IAAI,IAAI;IAKrB,2FAA2F;IAC3F,gBAAgB,IAAI,IAAI;IAIxB,8FAA8F;IAC9F,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI;IAQ9B,gBAAgB;IAChB,iBAAiB,IAAI,IAAI;CAmB1B"}

package/dist/layout/block.js

@@ -0,0 +1,186 @@
+import Konva from "konva";
+import { normalizeEdges, parseSize } from "./flex/engine.js";
+import { layoutRoot } from "./flex/flex.js";
+const BLOCK_KEYS = [
+    "flexDirection",
+    "justifyContent",
+    "alignItems",
+    "gap",
+    "padding",
+    "flexGrow",
+    "flexShrink",
+    "flexBasis",
+    "alignSelf",
+    "margin",
+    "borderSize",
+    "borderColor",
+    "borderStyle",
+    "shadow",
+    "background",
+];
+function pickKonvaConfig(config) {
+    const out = { ...config };
+    for (const k of BLOCK_KEYS)
+        delete out[k];
+    const w = parseSize(config.width);
+    const h = parseSize(config.height);
+    out.width = w?.kind === "px" ? w.value : undefined;
+    out.height = h?.kind === "px" ? h.value : undefined;
+    out.cornerRadius = undefined;
+    return out;
+}
+function firstColor(c) {
+    if (c === undefined)
+        return undefined;
+    if (typeof c === "string")
+        return c;
+    if (Array.isArray(c))
+        return c[0];
+    return c.top ?? c.right ?? c.bottom ?? c.left;
+}
+export class Block extends Konva.Group {
+    _kmRole = "container";
+    _bg;
+    constructor(config) {
+        super(pickKonvaConfig(config));
+        this._bg = new Konva.Rect({
+            x: 0,
+            y: 0,
+            width: 0,
+            height: 0,
+            listening: false,
+            cornerRadius: config.cornerRadius,
+        });
+        this._bg.setAttr("__blockBg", true);
+        super.add(this._bg);
+        this.setAttrs({
+            flexDirection: config.flexDirection,
+            justifyContent: config.justifyContent,
+            alignItems: config.alignItems,
+            gap: config.gap,
+            padding: config.padding,
+            flexGrow: config.flexGrow,
+            flexShrink: config.flexShrink,
+            flexBasis: config.flexBasis,
+            alignSelf: config.alignSelf,
+            margin: config.margin,
+            borderSize: config.borderSize,
+            borderColor: config.borderColor,
+            borderStyle: config.borderStyle ?? "solid",
+            shadow: config.shadow,
+            background: config.background,
+            cornerRadius: config.cornerRadius,
+            flexWidth: config.width,
+            flexHeight: config.height,
+        });
+        this.on("widthChange heightChange", () => this._layoutBackground());
+        this._layoutBackground();
+    }
+    /**
+     * Lay this Block out as a standalone Flexily root, sizing it to its children
+     * (hug) or to its explicit width/height, then restyle the background. Called
+     * by Sequence each frame for direct-child Blocks; nested Blocks are laid out
+     * by their parent Flex instead.
+     */
+    computeLayout() {
+        layoutRoot(this, true);
+        this._layoutBackground();
+    }
+    /** @internal — {@link KMLayoutNode}: lay self out as a flex root (Sequence calls this). */
+    _kmComputeLayout() {
+        this.computeLayout();
+    }
+    /** @internal — {@link KMLayoutNode}: write the computed box back + restyle the background. */
+    _kmPlace(box) {
+        this.x(box.left);
+        this.y(box.top);
+        this.width(box.width);
+        this.height(box.height);
+        this._layoutBackground();
+    }
+    /** @internal */
+    _layoutBackground() {
+        const w = this.width();
+        const h = this.height();
+        this._bg.x(0);
+        this._bg.y(0);
+        this._bg.width(w);
+        this._bg.height(h);
+        applyBackground(this._bg, this.attrs.background, w, h);
+        applyBorder(this._bg, normalizeEdges(this.attrs.borderSize), this.attrs.borderColor, this.attrs.borderStyle);
+        applyShadow(this._bg, this.attrs.shadow);
+        this._bg.cornerRadius(this.attrs.cornerRadius ?? 0);
+        this._bg.moveToBottom();
+    }
+}
+function applyBackground(rect, bg, w, h) {
+    rect.fill("");
+    rect.fillLinearGradientColorStops([]);
+    rect.fillRadialGradientColorStops([]);
+    if (bg === undefined)
+        return;
+    if (typeof bg === "string") {
+        rect.fill(bg);
+        return;
+    }
+    const g = bg.gradient;
+    if (!g)
+        return;
+    const stops = [];
+    for (const [pos, color] of g.stops) {
+        stops.push(pos, color);
+    }
+    if (g.type === "linear") {
+        const angle = ((g.angle ?? 0) * Math.PI) / 180;
+        const cx = w / 2;
+        const cy = h / 2;
+        const r = Math.max(w, h);
+        const dx = (Math.cos(angle) * r) / 2;
+        const dy = (Math.sin(angle) * r) / 2;
+        rect.fillLinearGradientStartPoint({ x: cx - dx, y: cy - dy });
+        rect.fillLinearGradientEndPoint({ x: cx + dx, y: cy + dy });
+        rect.fillLinearGradientColorStops(stops);
+    }
+    else {
+        rect.fillRadialGradientStartPoint({ x: w / 2, y: h / 2 });
+        rect.fillRadialGradientEndPoint({ x: w / 2, y: h / 2 });
+        rect.fillRadialGradientStartRadius(0);
+        rect.fillRadialGradientEndRadius(Math.max(w, h) / 2);
+        rect.fillRadialGradientColorStops(stops);
+    }
+}
+function applyBorder(rect, edges, color, style) {
+    if (!edges) {
+        rect.strokeWidth(0);
+        rect.stroke("");
+        rect.dashEnabled(false);
+        return;
+    }
+    const width = Math.max(...edges);
+    rect.strokeWidth(width);
+    rect.stroke(firstColor(color) ?? "#000");
+    if (style === "dashed") {
+        rect.dash([Math.max(2, width * 2), Math.max(2, width * 1.5)]);
+        rect.dashEnabled(true);
+    }
+    else {
+        rect.dashEnabled(false);
+    }
+}
+function applyShadow(rect, shadow) {
+    if (!shadow) {
+        rect.shadowEnabled(false);
+        return;
+    }
+    rect.shadowEnabled(true);
+    if (shadow.color !== undefined)
+        rect.shadowColor(shadow.color);
+    if (shadow.blur !== undefined)
+        rect.shadowBlur(shadow.blur);
+    if (shadow.offsetX !== undefined || shadow.offsetY !== undefined) {
+        rect.shadowOffset({ x: shadow.offsetX ?? 0, y: shadow.offsetY ?? 0 });
+    }
+    if (shadow.opacity !== undefined)
+        rect.shadowOpacity(shadow.opacity);
+}
+//# sourceMappingURL=block.js.map

package/dist/layout/block.js.map

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

package/dist/layout/contract.d.ts

@@ -0,0 +1,41 @@
+import type { Node as FlexilyNode } from "flexily/classic";
+import type Konva from "konva";
+/** A computed layout rectangle, in the parent's local coordinate space. */
+export type LayoutBox = {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+};
+/** Context handed to {@link KMLayoutNode._kmMeasure}. */
+export type MeasureContext = {
+    parentIsColumn: boolean;
+};
+/**
+ * The open contract that lets the flex engine ({@link buildChildren} /
+ * {@link writeBack} in `flex/flex.ts`) handle a node without an `instanceof`
+ * switch. Any wrapper that implements it self-describes how it participates in
+ * layout, so adding a new wrapped Konva element never requires editing the
+ * engine.
+ *
+ * - **container** (Flex/Block): the engine recurses into its children and reads
+ *   its flex-container attrs; it usually also exposes {@link _kmComputeLayout}.
+ * - **leaf** (Image/Text/Video/shapes): the engine asks it to configure its own
+ *   flexily sizing via {@link _kmMeasure}.
+ *
+ * After layout, every node gets {@link _kmPlace} to write the computed geometry
+ * back (position, size, and any internal restyle).
+ */
+export interface KMLayoutNode {
+    readonly _kmRole: "container" | "leaf";
+    /** Leaf-only: configure this node's flexily size + intrinsic measure func. */
+    _kmMeasure?(flexNode: FlexilyNode, ctx: MeasureContext): void;
+    /** Write the computed box back onto the Konva node (+ internal relayout). */
+    _kmPlace(box: LayoutBox): void;
+    /** Container-only: lay self out as a standalone flex root (called by Sequence). */
+    _kmComputeLayout?(): void;
+}
+export declare function isKMLayoutNode(n: Konva.Node): n is Konva.Node & KMLayoutNode;
+/** A container that can lay itself out as a flex root (Flex/Block). */
+export declare function isKMLayoutRoot(n: Konva.Node): n is Konva.Node & Required<Pick<KMLayoutNode, "_kmComputeLayout">>;
+//# sourceMappingURL=contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/layout/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,IAAI,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,2EAA2E;AAC3E,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,yDAAyD;AACzD,MAAM,MAAM,cAAc,GAAG;IAAE,cAAc,EAAE,OAAO,CAAA;CAAE,CAAC;AAEzD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC;IACvC,8EAA8E;IAC9E,UAAU,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9D,6EAA6E;IAC7E,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/B,mFAAmF;IACnF,gBAAgB,CAAC,IAAI,IAAI,CAAC;CAC3B;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,YAAY,CAE5E;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAC5B,CAAC,EAAE,KAAK,CAAC,IAAI,GACZ,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC,CAEpE"}

package/dist/layout/contract.js

@@ -0,0 +1,8 @@
+export function isKMLayoutNode(n) {
+    return typeof n._kmPlace === "function";
+}
+/** A container that can lay itself out as a flex root (Flex/Block). */
+export function isKMLayoutRoot(n) {
+    return typeof n._kmComputeLayout === "function";
+}
+//# sourceMappingURL=contract.js.map

package/dist/layout/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/layout/contract.ts"],"names":[],"mappings":"AAkCA,MAAM,UAAU,cAAc,CAAC,CAAa;IAC1C,OAAO,OAAQ,CAA2B,CAAC,QAAQ,KAAK,UAAU,CAAC;AACrE,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,cAAc,CAC5B,CAAa;IAEb,OAAO,OAAQ,CAA2B,CAAC,gBAAgB,KAAK,UAAU,CAAC;AAC7E,CAAC"}

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

@@ -0,0 +1,31 @@
+import { Node as FlexilyNode } from "flexily/classic";
+import type Konva from "konva";
+import type { EdgeValue, FlexChildProps, FlexProps, SizeValue } from "./types.js";
+export type Edges = [number, number, number, number];
+export declare function normalizeEdges(v: EdgeValue | undefined): Edges | null;
+export declare function parseSize(v: SizeValue | undefined): {
+    kind: "px";
+    value: number;
+} | {
+    kind: "pct";
+    value: number;
+} | null;
+export declare function applyEdges(node: FlexilyNode, edges: Edges | null, setter: "setPadding" | "setMargin" | "setBorder"): void;
+export declare function applySize(node: FlexilyNode, w: SizeValue | undefined, h: SizeValue | undefined): void;
+export declare function applyContainerProps(node: FlexilyNode, props: FlexProps): void;
+export declare function applyChildProps(node: FlexilyNode, props: FlexChildProps): void;
+export declare function setTextMeasure(node: FlexilyNode, text: Konva.Text, parentIsColumn: boolean): void;
+/**
+ * Structural view of the `Text` wrapper — typed here (rather than imported)
+ * so this leaf module stays free of a cycle through `text.ts`.
+ */
+type TextWrapper = {
+    _measureForFlex: (avail: number) => {
+        width: number;
+        height: number;
+    };
+};
+export declare function setTextWrapperMeasure(node: FlexilyNode, wrapper: TextWrapper, parentIsColumn: boolean): void;
+export declare function setImageMeasure(node: FlexilyNode, image: Konva.Image): void;
+export { FlexilyNode };
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/layout/flex/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAcL,IAAI,IAAI,WAAW,EAQpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAGV,SAAS,EACT,cAAc,EAEd,SAAS,EAET,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAErD,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,KAAK,GAAG,IAAI,CAUrE;AAED,wBAAgB,SAAS,CACvB,CAAC,EAAE,SAAS,GAAG,SAAS,GACvB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAMvE;AAmDD,wBAAgB,UAAU,CACxB,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,KAAK,GAAG,IAAI,EACnB,MAAM,EAAE,YAAY,GAAG,WAAW,GAAG,WAAW,GAC/C,IAAI,CAON;AAED,wBAAgB,SAAS,CACvB,IAAI,EAAE,WAAW,EACjB,CAAC,EAAE,SAAS,GAAG,SAAS,EACxB,CAAC,EAAE,SAAS,GAAG,SAAS,GACvB,IAAI,CAWN;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAM7E;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAM9E;AAOD,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,GAAG,IAAI,CAgCjG;AAED;;;GAGG;AACH,KAAK,WAAW,GAAG;IACjB,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACvE,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,WAAW,EACpB,cAAc,EAAE,OAAO,GACtB,IAAI,CAeN;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,CAc3E;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/layout/flex/engine.js

@@ -0,0 +1,186 @@
+import { ALIGN_AUTO, ALIGN_CENTER, ALIGN_FLEX_END, ALIGN_FLEX_START, ALIGN_STRETCH, EDGE_BOTTOM, EDGE_LEFT, EDGE_RIGHT, EDGE_TOP, FLEX_DIRECTION_COLUMN, FLEX_DIRECTION_COLUMN_REVERSE, FLEX_DIRECTION_ROW, FLEX_DIRECTION_ROW_REVERSE, Node as FlexilyNode, GUTTER_ALL, JUSTIFY_CENTER, JUSTIFY_FLEX_END, JUSTIFY_FLEX_START, JUSTIFY_SPACE_AROUND, JUSTIFY_SPACE_BETWEEN, JUSTIFY_SPACE_EVENLY, } from "flexily/classic";
+export function normalizeEdges(v) {
+    if (v === undefined)
+        return null;
+    if (typeof v === "number")
+        return [v, v, v, v];
+    if (Array.isArray(v)) {
+        if (v.length === 2)
+            return [v[0], v[1], v[0], v[1]];
+        if (v.length === 4)
+            return [v[0], v[1], v[2], v[3]];
+    }
+    else {
+        return [v.top ?? 0, v.right ?? 0, v.bottom ?? 0, v.left ?? 0];
+    }
+    return null;
+}
+export function parseSize(v) {
+    if (v === undefined)
+        return null;
+    if (typeof v === "number")
+        return { kind: "px", value: v };
+    const m = /^(-?\d+(?:\.\d+)?)%$/.exec(v);
+    if (m)
+        return { kind: "pct", value: Number.parseFloat(m[1] ?? "0") };
+    return null;
+}
+function flexDirection(v) {
+    switch (v) {
+        case "row":
+            return FLEX_DIRECTION_ROW;
+        case "column":
+            return FLEX_DIRECTION_COLUMN;
+        case "row-reverse":
+            return FLEX_DIRECTION_ROW_REVERSE;
+        case "column-reverse":
+            return FLEX_DIRECTION_COLUMN_REVERSE;
+    }
+}
+function justifyContent(v) {
+    switch (v) {
+        case "flex-start":
+            return JUSTIFY_FLEX_START;
+        case "center":
+            return JUSTIFY_CENTER;
+        case "flex-end":
+            return JUSTIFY_FLEX_END;
+        case "space-between":
+            return JUSTIFY_SPACE_BETWEEN;
+        case "space-around":
+            return JUSTIFY_SPACE_AROUND;
+        case "space-evenly":
+            return JUSTIFY_SPACE_EVENLY;
+    }
+}
+function alignItems(v) {
+    switch (v) {
+        case "flex-start":
+            return ALIGN_FLEX_START;
+        case "center":
+            return ALIGN_CENTER;
+        case "flex-end":
+            return ALIGN_FLEX_END;
+        case "stretch":
+            return ALIGN_STRETCH;
+    }
+}
+function alignSelfValue(v) {
+    return v === "auto" ? ALIGN_AUTO : alignItems(v);
+}
+const EDGE_BY_INDEX = [EDGE_TOP, EDGE_RIGHT, EDGE_BOTTOM, EDGE_LEFT];
+export function applyEdges(node, edges, setter) {
+    if (!edges)
+        return;
+    for (let i = 0; i < 4; i++) {
+        const e = EDGE_BY_INDEX[i];
+        const val = edges[i];
+        if (e !== undefined && val !== undefined)
+            node[setter](e, val);
+    }
+}
+export function applySize(node, w, h) {
+    const pw = parseSize(w);
+    const ph = parseSize(h);
+    if (pw) {
+        if (pw.kind === "px")
+            node.setWidth(pw.value);
+        else
+            node.setWidthPercent(pw.value);
+    }
+    if (ph) {
+        if (ph.kind === "px")
+            node.setHeight(ph.value);
+        else
+            node.setHeightPercent(ph.value);
+    }
+}
+export function applyContainerProps(node, props) {
+    node.setFlexDirection(flexDirection(props.flexDirection ?? "row"));
+    if (props.justifyContent)
+        node.setJustifyContent(justifyContent(props.justifyContent));
+    if (props.alignItems)
+        node.setAlignItems(alignItems(props.alignItems));
+    if (props.gap !== undefined)
+        node.setGap(GUTTER_ALL, props.gap);
+    applyEdges(node, normalizeEdges(props.padding), "setPadding");
+}
+export function applyChildProps(node, props) {
+    if (props.flexGrow !== undefined)
+        node.setFlexGrow(props.flexGrow);
+    if (props.flexShrink !== undefined)
+        node.setFlexShrink(props.flexShrink);
+    if (props.flexBasis !== undefined)
+        node.setFlexBasis(props.flexBasis);
+    if (props.alignSelf !== undefined)
+        node.setAlignSelf(alignSelfValue(props.alignSelf));
+    applyEdges(node, normalizeEdges(props.margin), "setMargin");
+}
+export function setTextMeasure(node, text, parentIsColumn) {
+    if (text.attrs.wrap === undefined)
+        text.wrap("word");
+    node.setMeasureFunc((arg0, _wMode, arg2) => {
+        // flexily quirk: from the flex-basis path, args are (mainAxis, mainMode, crossAxis, crossMode).
+        // For a column parent, the cross-axis (width we want to wrap to) is the THIRD arg.
+        const widthCandidates = parentIsColumn ? [arg2, arg0] : [arg0, arg2];
+        let avail = 0;
+        for (const c of widthCandidates) {
+            if (Number.isFinite(c) && c > 0) {
+                avail = c;
+                break;
+            }
+        }
+        const w = avail > 0 ? avail : 1e9;
+        const prevWidth = text.attrs.width;
+        text.width(w);
+        const ti = text;
+        ti._setTextData();
+        const lines = ti.textArr.length || 1;
+        const fontSize = text.fontSize();
+        const lineHeight = text.lineHeight();
+        const padding = text.padding() ?? 0;
+        const longest = ti.textArr.reduce((m, l) => Math.max(m, l.width), 0);
+        // Konva's per-line width (a sum of word widths) can fall a subpixel short of
+        // the width actually needed to render that line without wrapping. Writing the
+        // measured width back verbatim would then force a spurious extra wrap (e.g. a
+        // short label spilling its last word onto a second line), so round up.
+        const measuredW = Math.ceil(longest) + padding * 2 + 1;
+        const measuredH = lines * fontSize * lineHeight + padding * 2;
+        text.setAttr("width", prevWidth);
+        return { width: Math.min(measuredW, w), height: measuredH };
+    });
+}
+export function setTextWrapperMeasure(node, wrapper, parentIsColumn) {
+    node.setMeasureFunc((arg0, _wMode, arg2) => {
+        // Same flexily arg quirk as setTextMeasure: for a column parent the wrap
+        // width is the cross-axis (third) arg.
+        const widthCandidates = parentIsColumn ? [arg2, arg0] : [arg0, arg2];
+        let avail = 0;
+        for (const c of widthCandidates) {
+            if (Number.isFinite(c) && c > 0) {
+                avail = c;
+                break;
+            }
+        }
+        const { width, height } = wrapper._measureForFlex(avail > 0 ? avail : 1e9);
+        return { width: avail > 0 ? Math.min(width, avail) : width, height };
+    });
+}
+export function setImageMeasure(node, image) {
+    const src = image.image();
+    let w = 0;
+    let h = 0;
+    if (src && "naturalWidth" in src) {
+        w = src.naturalWidth;
+        h = src.naturalHeight;
+    }
+    else if (src) {
+        w = src.width;
+        h = src.height;
+    }
+    if (w > 0 && h > 0) {
+        node.setMeasureFunc(() => ({ width: w, height: h }));
+    }
+}
+export { FlexilyNode };
+//# sourceMappingURL=engine.js.map

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

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

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

@@ -0,0 +1,31 @@
+import Konva from "konva";
+import { type KMLayoutNode, type LayoutBox } from "../contract.js";
+import { FlexilyNode } from "./engine.js";
+import type { FlexConfig } from "./types.js";
+export declare class Flex extends Konva.Group implements KMLayoutNode {
+    readonly _kmRole: "container";
+    constructor(config: FlexConfig);
+    computeLayout(): void;
+    /** @internal — {@link KMLayoutNode}: lay self out as a flex root (Sequence calls this). */
+    _kmComputeLayout(): void;
+    /** @internal — {@link KMLayoutNode}: write the computed box back (nested in a parent flex). */
+    _kmPlace(box: LayoutBox): void;
+}
+/**
+ * Lay out a Konva.Group as a Flexily root: build the layout tree from the
+ * group's attrs + children, compute, and write positions/sizes back.
+ *
+ * When `alwaysSetSize` is true the group's own width/height are always pulled
+ * from the computed content size — needed for a hug-content root that draws a
+ * background (Block) so the background isn't 0×0. Flex passes false, preserving
+ * its behavior of only writing self-size when an explicit px size is given.
+ */
+export declare function layoutRoot(group: Konva.Group, alwaysSetSize: boolean): void;
+type Pair = {
+    konva: Konva.Node;
+    flex: ReturnType<typeof FlexilyNode.create>;
+};
+export declare function buildChildren(children: readonly Konva.Node[], parentFlex: ReturnType<typeof FlexilyNode.create>, pairs: Pair[], parentDirection?: string): void;
+export declare function writeBack(pairs: Pair[]): void;
+export {};
+//# sourceMappingURL=flex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flex.d.ts","sourceRoot":"","sources":["../../../src/layout/flex/flex.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAkB,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAIL,WAAW,EAIZ,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAkB,UAAU,EAAwB,MAAM,YAAY,CAAC;AAyBnF,qBAAa,IAAK,SAAQ,KAAK,CAAC,KAAM,YAAW,YAAY;IAC3D,QAAQ,CAAC,OAAO,EAAG,WAAW,CAAU;gBAE5B,MAAM,EAAE,UAAU;IAkB9B,aAAa,IAAI,IAAI;IAIrB,2FAA2F;IAC3F,gBAAgB,IAAI,IAAI;IAIxB,+FAA+F;IAC/F,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI;CAM/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,GAAG,IAAI,CAkB3E;AAED,KAAK,IAAI,GAAG;IACV,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC;IAClB,IAAI,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;CAC7C,CAAC;AAWF,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,KAAK,CAAC,IAAI,EAAE,EAC/B,UAAU,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,MAAM,CAAC,EACjD,KAAK,EAAE,IAAI,EAAE,EACb,eAAe,SAAQ,GACtB,IAAI,CA+CN;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CA2B7C"}