Repository navigation
feat: edge labels, neighbourhood and graph layouts, map views for any schema - #40
Merged
Merged
Conversation
mindsocket
commented
Nov 16, 2026
mindsocket
commented
Nov 16, 2026
mindsocket
left a comment
Owner
Author
There was a problem hiding this comment.
A couple more notes. Reply to open comments when addressing
mindsocket
commented
Nov 16, 2026
Tree and XY connectors can show the field the relationship is declared in, so typed relationships read at a glance. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019XphpcKhuNyHcNArHFELR4
Adds the compass layout with a bundled knowledge wiki neighbourhood view. Selecting a neighbour moves the focus; hosts can set it with focus. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019XphpcKhuNyHcNArHFELR4
Adds the graph layout (d3-force) and makes a definition's schema optional; without one it applies to every schema. Bundles graph, neighbourhood and tree views for any schema. Renames compass to neighbourhood. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019XphpcKhuNyHcNArHFELR4
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019XphpcKhuNyHcNArHFELR4
…md, trimmed docs and tests Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019XphpcKhuNyHcNArHFELR4
…a/ for the shared format, no barrel Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019XphpcKhuNyHcNArHFELR4
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019XphpcKhuNyHcNArHFELR4
…into core/layouts/helpers.ts Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019XphpcKhuNyHcNArHFELR4
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019XphpcKhuNyHcNArHFELR4
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019XphpcKhuNyHcNArHFELR4
… graph - Rename src/layouts to src/components, and EdgeOverlay to ConnectorOverlay: an edge is a reference in the space graph, a connector is a drawn line. The projections share one Connector type in place of a link type each. - A projection is optional: a layout has one only when deciding what is shown takes logic of its own. The graph layout has none; its component reads the space graph and runs d3-force itself. - Graph layout: each hierarchy level settles in a band, hierarchy nodes gather in the middle, relationship connectors are dashed, and nodes with no edge shown sit in a grid underneath. - Neighbourhood layout: a hierarchy root shows the other roots of its type, so the reader can move between them. - Stop exporting types that one file uses, and use structured-context's NodeId in place of local aliases. - AGENTS.md: principles for naming, exports, comments and docs, and what adding a layout involves. Docs no longer enumerate what the code lists.
mindsocket
force-pushed
the
claude/project-thread-iv62tw
branch
from
November 16, 2026 09:24
b20bf12 to
cf8ef1c
Compare
…blings right - By default hierarchy parents sit above the focus and hierarchy children below, relationship edges in either direction to the left, and siblings in a column at the far right. With no hierarchy, every edge runs down the page. - The role settings are overrides: a listed field goes to that role in either direction. The `around` role is gone, as every edge has a default place. - Zones wrap (three across above and below, six down at the sides), so a large zone doesn't push the focus off screen. - The focus is marked with an accent ring.
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019XphpcKhuNyHcNArHFELR4
mindsocket
marked this pull request as ready for review
November 16, 2026 10:13
core/layouts/schemas.ts holds the layout schemas and the checks a schema can't express. The schema list, the definition types and the layout branch of the definition schema are derived from it, and the per-layout config aliases give way to LayoutConfig<'name'>.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Requested by Rog · project thread
What
edges.labels(parameterisable boolean, defaultfalse): connectors show the field the relationship is declared in.neighbourhoodlayout: one focus node and its neighbours. Hierarchy parents go above and children below, relationship edges to the left, and siblings (or, for a hierarchy root, the other roots of its type) in a column at the far right. With no hierarchy, every edge runs down the page. Theabove,below,leftandrightsettings override the defaults by field. Selecting a neighbour moves the focus.MapViewtakesfocusandonFocusChange, and the navigator keeps the focus in?focus=.graphlayout: every node and edge as a network, settled byd3-force. Where the schema has a hierarchy, each level settles in a band below the one above and relationship edges are dashed. Nodes with no edge shown sit in a grid underneath. It needs no hierarchy.schemais optional. Without one it applies to every schema, andmapViewsForSchemaincludes it.graph,neighbourhoodandtree. The tree shows a message for a schema with no hierarchy.strategy-treestays as the view for the strategy schema.Structure
src/layoutsis nowsrc/components, andEdgeOverlayisConnectorOverlay(an edge is a reference in the space graph, a connector is a drawn line).core/layouts/<name>/with itsschema.ts, plus aprojection.tsonly when deciding what is shown takes logic of its own. The graph layout has none: its component runsd3-forceitself.core/layouts/schemas.tslists the layouts once, and the schema list, definition types andlayoutbranch of the definition schema derive from it.core/layouts/helpers.ts. The shared definition schemas moved fromcore/formattocore/schema.MapViewfinds a layout's component through one registry, and the components sharecomponents/layout.ts.d3-forceis a dependency, external to the library build likeajv. Schema files stay out of theprojectionchunk.docs/layouts.mdis the one place layouts are described.AGENTS.mdis rewritten as principles plus "Adding a layout".concepts.md,architecture.md,definitions.md,api.mdand the READMEs follow, and thelatestschemas and bundled definitions are regenerated.Also in this branch
These are unrelated to the layouts:
preversionscript now build the library first, because the plugin's tests import the builthtmlentry.ViewerProps,Fetched,LoadMapViewDefinitionsOptions). The first two were not part ofsrc/index.ts.LoadMapViewDefinitionsOptionswas exported by the/nodeentry, whoseloadMapViewDefinitionsnow takes{ configDir?: string }inline, so a host that imports the type breaks.Checks
bun test, typecheck and biome pass locally, and CI passes on the head commit. I did not runtest:packagelocally.focus, and connector labels can overlap where connectors cross.🤖 Generated with Claude Code
https://claude.ai/code/session_019XphpcKhuNyHcNArHFELR4