Skip to content

Landscape: strips, divided into cells by dimensions - #43

Merged
mindsocket merged 2 commits into
mainfrom
landscape-strips
Nov 18, 2026
Merged

mindsocket merged 2 commits into
mainfrom
landscape-strips

Conversation

@mindsocket

Copy link
Copy Markdown
Owner

A landscape is now one or more strips, each with its own grouping levels. A dimension divides strips into cells: the layout's dimension divides every strip alike, so they line up, and a strip's own dimension divides that strip further. This covers swimlanes (one dimension), grids (two), blueprints (a second strip reached through via) and independent swimlanes, in one layout.

layout: {
  type: 'landscape',
  dimension: { type: 'Stage' },
  strips: [
    { dimension: { type: 'Actor', edge: { field: 'actors' } }, group: [{ type: 'Step' }] },
    { group: [{ type: 'Tool', via: ['Step'] }] },
  ],
}
  • Format change: group moves into strips: [{ group }]. A plain landscape is one strip and renders byte-identically to before (compared on five fixture landscapes, keys included).
  • showUngrouped (default true) per strip.
  • buildLandscape returns one shape, { dimension?, strips }.
  • A synthetic delivery fixture (tests/fixtures/ai-delivery) backs the new tests.
  • Docs: landscape section of docs/layouts.md defines strip, dimension and cell. AGENTS.md gains two principles: terms of one layout live in that layout's docs section, and a setting is a boolean for on/off or an enum naming each behaviour.

Loose parts are marked PROTOTYPE: (dimension groups in space order; a dimension's edge on the last hop of a via chain; grid track sizes, scrolling headings, no connectors). Untested: a field level first with a dimension, breadcrumbs under a dimension, a dimension type with no nodes. Showing nodes that have a place in only one dimension is left open.

Checks: bun test 139 pass, typecheck, lint (1 existing warning), test:package, bun run build.

A landscape is one or more strips laid out one after the other. Each
strip has its own grouping levels (`group`) and nests them as before.

A dimension divides strips into cells, one per group: a group for every
node of a type, or for every value of a field. The layout's `dimension`
divides every strip alike, so strips line up; a strip's own `dimension`
divides that strip further. A strip's first level is joined to a
dimension's node the way a level is joined to the level above, so `via`
and `edge` apply there.

`showUngrouped` (default true) draws, or hides, the nodes of a strip that
no cell or container reached. `orientation` decides which way the layout
dimension runs; the direction is chosen in one place in the component.

`buildLandscape` returns one shape, `{ dimension?, strips }`. A plain
landscape is one strip with one cell and no dimension, and renders as
nested containers with no grid.

The synthetic AI-assisted delivery fixture exercises dimensions, a swimlane
and strips joined through `via`.
@mindsocket
mindsocket merged commit b96097b into main Nov 18, 2026
1 check passed
@mindsocket
mindsocket deleted the landscape-strips branch November 18, 2026 05:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant