Arcade Language Support / Support du langage Arcade

🇬🇧 English version
🇫🇷 Version française

Français

Un support complet pour le langage ArcGIS Arcade dans Visual Studio Code — conçu pour les développeurs SIG exigeants.

Sommaire

• Fonctionnalités
• Pourquoi cette extension ?
• Type de fichiers reconnus
• Thèmes inclus

Fonctionnalités

• 🎨 Coloration syntaxique avancée pour toutes les fonctions Arcade, opérateurs, mots-clés et structures de contrôle
• 🌗 Deux thèmes personnalisés :
  • Arcade Dark pour les environnements sombres
  • Arcade Light pour une lisibilité optimale en plein jour
• 📄 Reconnaissance des fichiers .cal & .lxp
• 🔍 Pliage de code, auto-closing des délimiteurs, et configuration des commentaires
• ⚡ Optimisé pour les expressions Arcade dans ArcGIS Pro, ArcGIS Online et ArcGIS Enterprise
• ✨ Snippets pour les fonctions courantes
• 🆚 Compatible avec Arcade version 1.34 (Octobre 2025)

🧠 Pourquoi cette extension ?

Arcade est un langage puissant qui mérite un environnement moderne et adapté.
Cette extension offre une expérience fluide, esthétique et pensée pour les workflows SIG.
Que vous écriviez des expressions de symbologie, des filtres dynamiques ou des calculs géométriques, vous profitez d’un cadre clair et productif.

📁 Type de fichiers reconnus

• .cal Formule Arcade de calcul de champ
• .lxp Formule Arcade d'étiquette

🎨 Thèmes inclus

⚙️ Commandes : arcade.enableAssoc, arcade.disableAssoc & arcade.openDoc

Ces commandes permettent de gérer automatiquement les associations de fichiers Arcade dans Windows.

• arcade.enableAssoc : associe les fichiers portant les extensions .cal et .lxp à Visual Studio Code, afin qu’ils soient ouverts directement avec l’éditeur et reconnus comme du code Arcade.
• arcade.disableAssoc : supprime ces associations et restaure le comportement par défaut de Windows.
• arcade.openDoc : ouvre la documentation officielle Esri Arcade dans le navigateur par défaut.

📌 Utilité

• Plus besoin de choisir manuellement VS Code à chaque ouverture de fichier Arcade.
• Les fichiers .cal (calculs de champs) et .lxp (étiquettes) sont immédiatement liés à l’extension Arcade Language Support.
• Cela garantit que la coloration syntaxique, l’autocomplétion et les thèmes Arcade sont actifs dès l’ouverture.
• Vous gardez le contrôle : vous pouvez activer ou désactiver l’association à tout moment.

🚀 Comment l’utiliser

1. Ouvrez la palette de commandes VS Code (Ctrl+Shift+P ou F1).
2. Tapez :
   • Arcade: Activer les extensions Arcade pour Windows
   • ou Arcade: Désactiver les extensions Arcade pour Windows
3. Validez : les associations de fichiers sont configurées (ou supprimées) automatiquement dans le registre Windows.
4. Vous pouvez aussi utiliser le bouton dans la barre d’état pour activer/désactiver rapidement l’association :

🔒 Remarque

• Cette commande agit uniquement sur Windows (elle utilise un script PowerShell).
• Sur macOS et Linux, les fichiers Arcade sont reconnus par VS Code via l’extension, mais l’association système doit être faite manuellement.

English

A complete support for the ArcGIS Arcade language in Visual Studio Code — designed for demanding GIS developers.

Table of Contents

• Features
• Why this extension?
• Recognized file types
• Included themes

Features

• 🎨 Advanced syntax highlighting for all Arcade functions, operators, keywords, and control structures
• 🌗 Two custom themes:
  • Arcade Dark for dark environments
  • Arcade Light for optimal readability in daylight
• 📄 Recognition of .cal & .lxp files
• 🔍 Code folding, auto-closing delimiters, and comment configuration
• ⚡ Optimized for Arcade expressions in ArcGIS Pro, ArcGIS Online and ArcGIS Enterprise
• ✨ Snippets for common functions
• 🆚 Compatible with Arcade version 1.34 (October 2025)

🧠 Why this extension?

Arcade is a powerful language that deserves a modern, well‑integrated environment.
This extension provides a smooth, aesthetic experience tailored to GIS workflows.
Whether you are writing symbology expressions, dynamic filters, or geometric calculations, you benefit from a clear and productive workspace.

📁 Recognized file types

• .cal Arcade formula for field calculation
• .lxp Arcade formula for labeling

🎨 Included themes

⚙️ Commands: arcade.enableAssoc, arcade.disableAssoc & arcade.openDoc

These commands automatically manage Arcade file associations in Windows.

• arcade.enableAssoc: associates files with the .cal and .lxp extensions to Visual Studio Code, so they open directly in the editor and are recognized as Arcade code.
• arcade.disableAssoc: removes these associations and restores Windows default behavior.
• arcade.openDoc : opens the official Esri Arcade documentation in the default browser.

📌 Purpose

• No need to manually choose VS Code every time you open an Arcade file.
• .cal files (field calculations) and .lxp files (labels) are immediately linked to the Arcade Language Support extension.
• This ensures that syntax highlighting, autocomplete, and Arcade themes are active as soon as the file is opened.
• You stay in control: enable or disable the association at any time.

🚀 How to use

1. Open the VS Code Command Palette (Ctrl+Shift+P or F1).
2. Type:
   • Arcade: Enable Arcade extensions for Windows
   • or Arcade: Disable Arcade extensions for Windows
3. Confirm: file associations are automatically configured (or removed) in the Windows registry.
4. You can also use the status bar button to quickly enable/disable the association:

🔒 Note

• This command only works on Windows (it relies on a PowerShell script).
• On macOS and Linux, Arcade files are recognized by VS Code through the extension, but system‑level file associations must be set manually.