bento

Import

Import

import * as api from "@fungi.computer/maosaico/bento";

Exports

Kind	Export	Description
Ttype alias	BentoColumns	Host-selected responsive grid; Maosaico does not select breakpoints.
Ttype alias	BentoPlacement	A caller-owned tile in integer grid cells. IDs are unique within a grid.
Ttype alias	BentoOp	Intent proposed by the interaction binding and accepted by the host.
Ttype alias	BentoGeometry	Container-relative pixel geometry supplied by the measured host.
fnfunction	resolveBento()	Normalize cells and push collisions downward, preserving caller identity/order.
fnfunction	arrangeBento()	Reflow spans and compact vertical gaps while retaining stable tile identity/order.
fnfunction	applyBentoOps()	Apply intents in order, reorder downward past occupants, then compact every tile.
fnfunction	bentoRowOffset()	Pixel origin of an integer row, shared by frames and pointer snapping.
fnfunction	bentoRowAt()	Nearest row boundary for a pointer; remaining rows use the uniform stride.
fnfunction	bentoFrames()	Map cells to frames; content and scrolling remain with the host.

BentoColumnsTtype alias

Signature

type BentoColumns = 1 | 2 | 4;

Host-selected responsive grid; Maosaico does not select breakpoints.

---

BentoPlacementTtype alias

Signature

type BentoPlacement = Readonly<{
  id: string;
  col: number;
  row: number;
  w: number;
  h: number;
}>;

A caller-owned tile in integer grid cells. IDs are unique within a grid.

---

BentoOpTtype alias

Signature

type BentoOp =
  | Readonly<{
      kind: "move";
      id: string;
      col: number;
      row: number;
    }>
  | Readonly<{
      kind: "resize";
      id: string;
      w: number;
      h: number;
    }>;

Intent proposed by the interaction binding and accepted by the host.

---

BentoGeometryTtype alias

Signature

type BentoGeometry = Readonly<{
  columns: BentoColumns;
  width: number;
  rowHeight: number;
  rowHeights?: readonly number[];
  gap: number;
}>;

Container-relative pixel geometry supplied by the measured host.

resolveBento()fnfunction

Signature

function resolveBento(
  placements,
  columns,
  priority?,
): readonly Readonly<{
  id: string;
  col: number;
  row: number;
  w: number;
  h: number;
}>[];

Normalize cells and push collisions downward, preserving caller identity/order.

Parameters

Parameter	Type
placements	readonly Readonly<{ id: string; col: number; row: number; w: number; h: number; }>[]
columns	BentoColumns
priority?	string

Returns

readonly Readonly<{ id: string; col: number; row: number; w: number; h: number; }>[]

---

arrangeBento()fnfunction

Signature

function arrangeBento(
  placements,
  columns,
): readonly Readonly<{
  id: string;
  col: number;
  row: number;
  w: number;
  h: number;
}>[];

Reflow spans and compact vertical gaps while retaining stable tile identity/order.

Parameters

Parameter	Type
placements	readonly Readonly<{ id: string; col: number; row: number; w: number; h: number; }>[]
columns	BentoColumns

Returns

readonly Readonly<{ id: string; col: number; row: number; w: number; h: number; }>[]

---

applyBentoOps()fnfunction

Signature

function applyBentoOps(
  placements,
  ops,
  columns,
): readonly Readonly<{
  id: string;
  col: number;
  row: number;
  w: number;
  h: number;
}>[];

Apply intents in order, reorder downward past occupants, then compact every tile.

Parameters

Parameter	Type
placements	readonly Readonly<{ id: string; col: number; row: number; w: number; h: number; }>[]
ops	readonly BentoOp[]
columns	BentoColumns

Returns

readonly Readonly<{ id: string; col: number; row: number; w: number; h: number; }>[]

---

bentoRowOffset()fnfunction

Signature

function bentoRowOffset(row, geometry): number;

Pixel origin of an integer row, shared by frames and pointer snapping.

Parameters

Parameter	Type
row	number
geometry	BentoGeometry

Returns

number

---

bentoRowAt()fnfunction

Signature

function bentoRowAt(y, geometry): number;

Nearest row boundary for a pointer; remaining rows use the uniform stride.

Parameters

Parameter	Type
y	number
geometry	BentoGeometry

Returns

number

---

bentoFrames()fnfunction

Signature

function bentoFrames(placements, geometry): ReadonlyMap<string, Frame>;

Map cells to frames; content and scrolling remain with the host.

Parameters

Parameter	Type
placements	readonly Readonly<{ id: string; col: number; row: number; w: number; h: number; }>[]
geometry	BentoGeometry

Returns

ReadonlyMap<string, Frame>