Authoring support for TopoScript, the DSL used by TopoNavi indoor topology maps.

Features

TopoScript language registration.
Syntax highlighting for maps, transports, configuration files, constraints, core expressions, comments, strings, numbers, and operators.
Bracket, quote, and comment editing configuration.
Diagnostics on open and save.
Optional debounced validation while typing.
TopoScript: Preview Local Topology graph preview for:
- topo-map nodes, atomic-path, and linear-path edges.
- transport stations and station ordering.
- building-includes submaps and vehicles.

Recognized Files

The extension recognizes:

*.topo
*.toposcript
configuration
root
Extensionless files whose first line starts with topo-map, transport, building-includes, or root.

The upstream examples currently use extensionless files such as Floor1, MainElevator, and configuration.

Diagnostics

Set toposcript.compiler.command to run an external compiler/analyzer. The current file path is appended to the command, and stdout should be normalized JSON:

{
  "diagnostics": [],
  "graph": {
    "nodes": [],
    "edges": []
  }
}

When no external command is configured, the extension uses a local fallback analyzer. It catches common authoring issues such as mismatched delimiters, unclosed strings, duplicate topo-node declarations, and unknown local node references in atomic-path and linear-path.

Settings

toposcript.compiler.command: external analyzer command.
toposcript.validation.onChange: run debounced validation during edits.
toposcript.validation.debounceMs: edit validation delay.
toposcript.preview.layout: circle or grid.

Development

npm install
npm run compile

Open this folder in VS Code and press F5 to launch an Extension Development Host.

Package a VSIX:

npm run package

Known Limitations

This MVP is not an LSP implementation.
The built-in analyzer is intentionally lightweight and does not replace the project compiler.
Cross-file semantic checks depend on an external analyzer.
The preview is a local topology aid, not the full TopoNavi renderer.