Mar Language Support (VS Code)

This extension adds syntax highlighting, snippets/autocomplete, and LSP features for .mar files.

Mar has a built-in User entity in every app, and entity operations are protected by default. The extension reflects that model in snippets and editor support.

Features

• Syntax highlighting for:
• Mar declarations (app, port, database, entity, auth, type alias)
• Public assets config (public, dir, mount, spa_fallback)
• System config (system, request_logs_buffer, http_max_request_body_mb, auth rate limits, security headers like security_frame_policy/security_referrer_policy/security_content_type_nosniff, and sqlite_* options like sqlite_mmap_size_mb and sqlite_cache_size_kb)
• Rule/authz keywords (rule, expect, when, authorize)
• Action syntax (action <name> { input: Alias ... create Entity { ... } })
• Auth config keys (code_ttl_minutes, session_ttl_hours, email_transport, etc.)
• Built-in User entity support and auth-aware snippets
• Field modifiers (primary, auto, optional)
• Built-in types (Int, String, Bool, Float)
• Built-in functions (contains, startsWith, endsWith, len, matches, isRole)
• Context variables (input, input.field, auth_authenticated, auth_email, auth_user_id, auth_role)
• Comments (--), strings, numbers, booleans, null, operators, and punctuation
• Snippets/autocomplete (examples):
• app
• entity
• field
• rule
• authorize
• auth
• User
• public
• system
• authzcrud
• typealias
• action
• create
• actioncreate
• Database path tip:
• Use database "app.db" for a simple relative path.
• Relative paths are resolved from the process working directory.
• LSP (via mar lsp):
• Parse diagnostics while editing
• Keyword completions
• Go to definition
• Find references
• Rename symbol
• Hover documentation
• Document symbols (Outline)
• Quick fixes (code actions)
• Format document support

Install in VSCode

1. Open Extensions in VSCode.
2. Search for Mar Language Support.
3. Click Install.

If needed, set mar.languageServer.path in VSCode settings (examples: mar, /abs/path/to/mar).

Format on Save

1. Open VS Code settings (settings.json) and configure:

{
  "[mar]": {
    "editor.defaultFormatter": "mar-lang.mar-language-support",
    "editor.formatOnSave": true
  }
}

2. Save a .mar file to apply Mar formatting automatically.

Notes

• Keep mar available in your PATH so the extension can start LSP and formatting.
• User is built into every Mar app. Use entity User { ... } only to extend it with extra fields, rules, or authorization.
• Entity CRUD is deny-by-default. Add explicit authorize rules for every operation you want to expose.
• Admin always has read-only access to the built-in User entity, even without explicit authorize rules.
• authorize all when ... is available as a shorthand for applying the same rule to list, get, create, update, and delete.