VS Code · 0.1.0-preview.1

Bring Hime-san into the editor.

The first installable VSIX adds visible .sando highlighting and connects trusted workspaces to Hime-san Beta 2's reusable Language Server Protocol implementation.

Preview boundary: this exact VSIX is available only as a Gitea prerelease while classroom and community feedback is gathered. It is not yet published to Visual Studio Marketplace or Open VSX.

Install the compiler separately

The extension never downloads, installs, or upgrades Hime-san. Install the runtime required by your application first, then the Beta 2 development compiler:

go get gamertan.com/sandwich-hime/sando@v1.0.0-beta.1
go install gamertan.com/sandwich-hime/cmd/himesan@v1.0.0-beta.2
himesan version --json

The version response must advertise "features":["lsp-stdio"]. WSL, SSH, and container workspaces resolve the compiler inside their own extension-host environment rather than reaching back to a host installation.

Verify and install the VSIX

Download it from the canonical Gitea prerelease. The exact file has SHA-256:

32b3a5e515299d75478959598d554857dea13c10b96b296590729015503cff57  sandwich-hime-0.1.0-preview.1.vsix
curl -fL https://gitea.speelman.ca/attachments/9d952e41-681b-403c-8aa0-a0219ddf9c87 \
  -o sandwich-hime-0.1.0-preview.1.vsix
printf '%s  %s\n' \
  '32b3a5e515299d75478959598d554857dea13c10b96b296590729015503cff57' \
  'sandwich-hime-0.1.0-preview.1.vsix' | sha256sum -c -
code --install-extension sandwich-hime-0.1.0-preview.1.vsix

The release also includes a CycloneDX SBOM and a signed checksum manifest. I signed that manifest with my release SSH key, fingerprint SHA256:3+M1Mkhg2FL5VJVPd3HQTZpZbo2HSPgblHzvDMQUhbs.

What the preview provides

  • TextMate highlighting, indentation, brackets, folding, comments, and snippets for every Hime-san delimiter.
  • Live diagnostics for open unsaved templates.
  • Hover help for tags, output contexts, component signatures, and trusted-output boundaries.
  • Document symbols, same-package and imported-component completion, and go-to-definition.
  • Explicit commands to check, generate, start the visible local supervisor, restart the language server, show versions, and open the tutorial.

Beta 2 deliberately excludes general Go or HTML completion, formatting, rename, references, automatic imports, browser preview, and LSP-generated-file freshness notices. Use the normal himesan check, Go tools, and gopls alongside it.

Syntax without trust; processes only with trust

Highlighting remains available in an untrusted workspace. Every executable feature stays disabled until the workspace is trusted. The extension makes no network requests, sends no telemetry, never generates on open or save, and starts himesan dev only in a visible user-owned terminal.

Set sandwichHime.himesanPath only to an absolute compiler path. When it is unset, the extension uses himesan from the extension host's PATH, verifies version --json, and requires the lsp-stdio feature before launching the server.

Help shape the registry release

Please report installation results, diagnostics that helped or distracted, component completion and definition accuracy, workspace-trust behavior, and process cleanup through the canonical Gitea issue tracker. Security-sensitive findings belong at security@sandwichhime.com.