A Rust BSP layout component paired with its browser UI Service for GAMS. Workspaces have independent trees and focus; moving or resizing panels preserves their Views. Floating windows are not implemented in this first slice.
The component exposes individual typed functions through gams:layout2/layout@0.2.0,
not a JSON-string dispatcher. The paired service and component must be updated
together; existing saved version-1 layouts convert on load.
| Item | Source / ZIP entry | Screenshot | License / original work |
|---|---|---|---|
| BSP component | src/*.rs, wit/layout.wit → plugin.layout2.wasm |
Not applicable | Apache-2.0; algorithm reference: TUIOS / Gaurav Gosain, MIT |
| Paired layout UI Service | src/ui-plugins/layout2.js → ui-plugins/layout2.js |
Not yet captured | Apache-2.0, kkgams contributors |
Install Nix and enable direnv, or run commands through nix develop --command.
The local Project uses the built component and local UI Service together, with
pinned released Host, Files View, theme and supporting UI Services.
nix develop --command make test
nix develop --command make openmake open builds the component and launches this checkout's gams.json in
tools/gams.app. It downloads the pinned macOS Apple Silicon GAMS v3.2.0 Host
when absent, verifies its published checksum and keeps the accompanying notices.
Existing downloads are never updated implicitly; macOS security checks remain
in effect. Other systems can load this Project with their installed GAMS Host.
No neighboring checkout is required.
Use the toolbar and workspace tabs, or these Project-configured shortcuts.
mod means Command on macOS and Control elsewhere.
| Shortcut | Action |
|---|---|
mod+alt+Enter / mod+alt+shift+Enter |
New panel to the right / below |
mod+alt+W |
Close focused panel |
mod+alt+Arrow |
Focus in that direction |
mod+alt+shift+Arrow |
Move panel in that direction |
mod+alt+shift+H/J/K/L |
Grow left/down/up/right by 24 pixels |
mod+alt+E |
Equalize split ratios |
mod+alt+G |
Arrange as a grid |
mod+alt+T |
Create and activate a workspace |
mod+alt+[ / mod+alt+] |
Previous / next workspace |
mod+shift+S |
Save Project, including layout and View selection |
Close workspace in the toolbar closes the active workspace and all its panels. It is disabled when only one workspace remains; tabs have no close buttons.
Drag the shared resize handles between panels for live resizing. Escape cancels a drag. Focused handles support arrows (10 pixels, Shift for 1) and Home/End; all resizing respects nested panel minimum sizes without recreating Views.
| Command | Output / behavior |
|---|---|
make build |
build.nosync/plugin.layout2.wasm, with embedded notices |
make test |
Native Rust behavior tests and dependency-free JavaScript checks/tests |
make package |
build.nosync/plugin.layout2.zip and SHA256SUMS |
make open |
Build and open this local Project in the released Host |
make serve-docs DOCS_PORT=8082 |
Independent documentation preview |
make docs / make validate-docs |
Build / validate with pinned justgook/wiki v1.8.0 |
make clean |
Remove declared generated output, downloaded Host and currently configured Unit downloads |
Builds, Cargo caches, temporary files and generated documentation stay under
ignored build.nosync/. Clean refuses tracked files and symlinks in deletion
paths; it preserves authored files and unrelated installed Units.
The ZIP contains the component, ui-plugins/layout2.js, README and licenses.
Install both entries together: the service is not compatible with the old
plugin.layout interface. This repository does not replace either existing Unit.
Local commands do not tag or publish. Release assets use stable names:
plugin.layout2.zip and SHA256SUMS.
See the typed API and document contract. Apache-2.0 for authored code;
TUIOS MIT attribution and original terms are retained in licenses/TUIOS-MIT.txt.