mirror of https://github.com/carbon-language/carbon-lang.git synced 2026-09-24 22:02:23 +01:00

Files

T

Chandler Carruth 8be274cf60 Replace :! binding syntax with phase keywords and contextual defaults (#7479 )

Implement the toolchain side of proposal #7254, removing the `:!`
binding
syntax for generic and template parameters in favor of the keywords
`generic`,
`template`, and `runtime` plus contextual defaults for phase.

For valid programs this is semantics-preserving: each binding resolves
to the
same phase, and produces the same SemIR, as it did under `:!`/`:`. The
parser
derives a binding's phase from its syntactic context plus any explicit
phase
keyword; new diagnostics and error recovery for misused keywords are
described
below.

Implementation details for each component:

- Lexer: remove the `:!` (`ColonExclaim`) token, move its virtual
parse-node
  budget onto `:`, and add the `generic` and `runtime` keywords.
- Parser: thread a `BindingContext` (`ExplicitParam`, `DeducedParam`, or
`CompileTimeEntityParam`) from declaration introducers down through
parameter
lists to each binding pattern, using a one-token lookahead to
distinguish a
name-qualifier parameter list from a declaration's own final list.
Parameters
of a compile-time entity (`class`, `interface`, `constraint`, `choice`,
`alias`, `export`, `namespace`) and deduced `[]` parameters default to
checked
generic; explicit function parameters and local bindings default to
runtime.
`HandleBindingPattern` resolves the phase from that context plus the
keyword: a
`generic` keyword needs no node of its own (the phase is carried by the
  binding's node kind), while a `runtime` keyword is preserved as a
`RuntimeBindingName` node so `check` can name it in a diagnostic. A
phase
keyword that is merely redundant with the contextual default is
diagnosed
  here, without invalidating the parse tree.
- Check: a phase keyword that is invalid for its context (for example
`runtime`
on a checked-generic parameter) is diagnosed here, and recovers by
building an
error binding that still introduces the name so that later uses of it do
not
  produce cascading errors.

The removed `:!` syntax is now rejected as an ordinary parse error.

The `form`/`:?`/`->?` ("extended types") portion of proposal #7254 is
left for a
separate change.

Assisted-by: Claude Code

2026-07-11 01:22:44 +00:00

.vscode

Update the vscode language server setup (#4663 )

2024-12-16 16:05:17 +00:00

images

Update icons for slightly better sizing (#5013 )

2025-02-27 00:00:55 +00:00

src

vscode: don't use carbon LSP for testdata files (#7420 )

2026-06-25 21:24:25 +00:00

.gitignore

Update the vscode language server setup (#4663 )

2024-12-16 16:05:17 +00:00

.vscodeignore

Update the vscode language server setup (#4663 )

2024-12-16 16:05:17 +00:00

BUILD

Use C++ formatting for C++ splits in testdata files. (#7385 )

2026-06-18 14:47:34 +00:00

carbon-testdata.tmLanguage.json

Use C++ formatting for C++ splits in testdata files. (#7385 )

2026-06-18 14:47:34 +00:00

carbon.tmLanguage.json

Replace :! binding syntax with phase keywords and contextual defaults (#7479 )

2026-07-11 01:22:44 +00:00

development.md

Update to latest rumdl release and enable another option (#7483 )

2026-07-10 16:16:28 +00:00

esbuild.js

Update the vscode language server setup (#4663 )

2024-12-16 16:05:17 +00:00

eslint.config.mjs

Update the vscode language server setup (#4663 )

2024-12-16 16:05:17 +00:00

language-configuration.json

Get the VS Code extension working again. (#4037 )

2024-06-06 23:27:33 +00:00

LICENSE

Add basic VS Code extension using textmate syntax (#2969 )

2023-07-19 03:30:41 +00:00

package-lock.json

Bump undici from 7.25.0 to 7.28.0 in /utils/vscode in the npm_and_yarn group across 1 directory (#7387 )

2026-06-18 15:55:08 +00:00

package.json

Use C++ formatting for C++ splits in testdata files. (#7385 )

2026-06-18 14:47:34 +00:00

README.md

Update to latest rumdl release and enable another option (#7483 )

2026-07-10 16:16:28 +00:00

semir.tmLanguage.json

Add syntax highlighting for SemIR. (#6958 )

2026-03-31 18:49:02 +00:00

tsconfig.json

Update the vscode language server setup (#4663 )

2024-12-16 16:05:17 +00:00

README.md

Carbon Language

This extension provides support for the Carbon Language.

This extension is currently experimental, and being developed alongside Carbon.

Quickstart

Download and install a carbon release.
- By default, the extension will look for carbon under ./bazel-bin. This is for developers actively working on Carbon and running VS Code inside a carbon-lang clone.
Install the Carbon Language extension.
Configure the installed path to carbon.

Configuration

The configuration is under carbon.*. At present, the only configuration is the path to the carbon binary. This looks like:

"carbon.carbonPath": "/path/to/carbon"

Communication

See Carbon's collaboration systems. We're most active on Discord and have a #editor-integrations channel. We'll also respond to questions on GitHub Discussions.

Documentation

Carbon currently only has project-level documentation. See the GitHub repository.