tjs-lang 0.2.0

package/docs/texts/ai-history.txt

@@ -0,0 +1,9 @@
+A Brief History of Artificial Intelligence
+
+The field of artificial intelligence was formally founded at a workshop at Dartmouth College in 1956, where John McCarthy coined the term. Early pioneers believed that human-level AI was just decades away, leading to significant government funding and optimism.
+
+The 1970s and 1980s saw the rise of expert systems, which encoded human knowledge into rule-based programs. Companies like Digital Equipment Corporation saved millions using these systems, but their brittleness and maintenance costs eventually led to the "AI Winter" of the late 1980s.
+
+The modern AI renaissance began around 2012 when deep learning achieved breakthrough results in image recognition. Neural networks, an idea dating back to the 1940s, finally became practical thanks to large datasets, GPU computing, and algorithmic improvements like dropout and batch normalization.
+
+The 2020s brought large language models like GPT and Claude, trained on vast amounts of text data. These models demonstrated surprising emergent capabilities, from code generation to reasoning, sparking both excitement about AI's potential and debates about safety and alignment. The technology continues to advance rapidly, with new architectures and training methods appearing regularly.

package/docs/texts/coffee-origins.txt

@@ -0,0 +1,9 @@
+The Origins of Coffee
+
+Legend has it that coffee was discovered by an Ethiopian goat herder named Kaldi around 850 AD. He noticed his goats became unusually energetic after eating berries from a certain tree. Curious, he tried the berries himself and experienced a similar stimulating effect.
+
+The practice of roasting coffee beans and brewing them as a beverage developed in Yemen during the 15th century. Sufi monks used coffee to stay awake during nighttime devotions, and the drink spread through the Islamic world via trade routes. Coffee houses, called qahveh khaneh, became important social centers in cities like Constantinople, Cairo, and Damascus.
+
+Coffee arrived in Europe in the 17th century, initially meeting resistance from some who called it the "bitter invention of Satan." Pope Clement VIII reportedly settled the matter by tasting the beverage and giving it papal approval. Coffee houses soon proliferated across Europe, becoming hubs for intellectual discussion and business dealings.
+
+Today, coffee is the world's second most traded commodity after oil. Over 2.25 billion cups are consumed daily, supporting the livelihoods of approximately 125 million people worldwide. The specialty coffee movement has transformed the industry, with consumers increasingly interested in origin, processing methods, and sustainable farming practices.

package/docs/texts/renewable-energy.txt

@@ -0,0 +1,9 @@
+Renewable Energy: A Path Forward
+
+The global transition to renewable energy sources represents one of the most significant technological and economic shifts in human history. Solar power capacity has grown exponentially, with costs dropping by over 89% since 2010. Wind energy now provides over 7% of global electricity, with offshore wind farms becoming increasingly viable in deeper waters.
+
+Battery storage technology has emerged as a crucial enabler, with lithium-ion costs falling 97% since 1991. Grid-scale storage projects are now being deployed worldwide, helping to address the intermittency challenges that have historically limited renewable adoption.
+
+Emerging technologies like green hydrogen production, advanced geothermal systems, and next-generation nuclear reactors promise to fill gaps where traditional renewables struggle. Meanwhile, smart grid technology and demand response systems are making energy distribution more efficient and resilient.
+
+The economic case for renewables has become compelling. In most regions, new solar and wind installations are now cheaper than new fossil fuel plants, even without subsidies. This cost advantage, combined with growing climate concerns and energy security considerations, is accelerating the transition across both developed and developing nations.

package/docs/tjs-lang.svg

@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="utf-8"?>
+<svg x="0pt" y="0pt" width="48pt" height="48pt" viewBox="0 0 48 48" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <!--Generated by AMDN-->
+  <g id="Layer_1">
+    <g id="Layer_1-1">
+      <g id="Layer_1_1">
+        <g id="Group">
+          <path id="Path" style="fill:#ff1c24;fill-opacity:1;fill-rule:evenodd;opacity:1;stroke:none;" d="M1,9 C1,4.58172,4.58172,1,9,1 C9,1,39,1,39,1 C43.4183,1,47,4.58172,47,9 C47,9,47,39,47,39 C47,43.4183,43.4183,47,39,47 C39,47,9,47,9,47 C4.58172,47,1,43.4183,1,39 C1,39,1,9,1,9 z"/>
+          <g id="Group_1">
+            <path id="Path_1" style="fill:#9e9e9e;fill-opacity:1;fill-rule:nonzero;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M16,29 C16,29,10,31,10,35 C10,39,16,39,16,39"/>
+            <path id="Path_Copy" style="fill:#9e9e9e;fill-opacity:1;fill-rule:nonzero;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M32.0002,29 C32.0002,29,38.0002,31,38.0002,35 C38.0002,39,32.0002,39,32.0002,39"/>
+            <path id="Path_2" style="fill:#ffffff;fill-opacity:1;fill-rule:evenodd;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M9,10.1818 C9,7.87226,10.7909,6,13,6 C13,6,35,6,35,6 C37.2091,6,39,7.87226,39,10.1818 C39,10.1818,39,24.8182,39,24.8182 C39,27.1277,37.2091,29,35,29 C35,29,13,29,13,29 C10.7909,29,9,27.1277,9,24.8182 C9,24.8182,9,10.1818,9,10.1818 z"/>
+            <path id="Path_3" style="fill:#ffffff;fill-opacity:1;fill-rule:nonzero;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M24,11 C24,11,24,23,24,23"/>
+            <path id="Path_4" style="fill:#ffffff;fill-opacity:1;fill-rule:nonzero;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M28,15 C28,15,28,17,28,17"/>
+            <path id="Path_Copy_1" style="fill:#ffffff;fill-opacity:1;fill-rule:nonzero;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M20,15 C20,15,20,17,20,17"/>
+            <path id="Path_5" style="fill:none;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M32,43 C32,43,30,41,30,41 C30,41,28,43,28,43"/>
+            <path id="Path_Copy_2" style="fill:none;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M20,43 C20,43,18,41,18,41 C18,41,16,43,16,43"/>
+            <path id="Path_6" style="fill:#e4e4e4;fill-opacity:1;fill-rule:evenodd;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M16,29 C16,29,32,29,32,29 C32,29,32,39,32,39 C32,39,16,39,16,39 C16,39,16,29,16,29 z"/>
+          </g>
+        </g>
+      </g>
+    </g>
+    <path id="Path-1" style="fill:#006736;fill-opacity:1;fill-rule:evenodd;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M27,17 C27,17,34,17,34,17 C34,17,34,22,34,22 C34,22,27,22,27,22 C27,22,27,17,27,17 z"/>
+    <path id="Path-2" style="fill:none;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M21,19 C21,19,21,19,21,19 C21,17.8954,21.8954,17,23,17 C23,17,25,17,25,17 C26.1046,17,27,17.8954,27,19 C27,19,27,19,27,19"/>
+    <path id="Path_Copy-1" style="fill:#006736;fill-opacity:1;fill-rule:evenodd;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M14,17 C14,17,21,17,21,17 C21,17,21,22,21,22 C21,22,14,22,14,22 C14,22,14,17,14,17 z"/>
+    <path id="Path_Copy-2" style="fill:#8e7f6d;fill-opacity:1;fill-rule:nonzero;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M7.31734,20.5867 C7.14208,19.7104,7.71038,18.8579,8.58668,18.6827 C8.58668,18.6827,10.4133,18.3173,10.4133,18.3173 C11.2896,18.1421,12.1421,18.7104,12.3173,19.5867 C12.3173,19.5867,12.6405,21.2026,12.6405,21.2026 C12.8314,22.157,13.8156,22.7281,14.7389,22.4204 C14.7389,22.4204,15.1785,22.2738,15.1785,22.2738 C15.6917,22.1028,16.2565,22.1995,16.6836,22.5317 C16.6836,22.5317,24.3753,28.5141,24.3753,28.5141 C24.7695,28.8207,25,29.2921,25,29.7914 C25,29.7914,25,40.3298,25,40.3298 C25,40.7589,24.8295,41.1705,24.5261,41.4739 C24.5261,41.4739,23.4739,42.5261,23.4739,42.5261 C23.1705,42.8295,22.7589,43,22.3298,43 C22.3298,43,9,43,9,43 C7.34315,43,6,41.6569,6,40 C6,40,6,26,6,26 C6,25.3871,6.3463,24.8268,6.89452,24.5527 C6.89452,24.5527,6.89452,24.5527,6.89452,24.5527 C7.5472,24.2264,7.90073,23.5036,7.75762,22.7881 C7.75762,22.7881,7.31734,20.5867,7.31734,20.5867 z"/>
+    <path id="Compound_Group" style="fill:#c6b199;fill-opacity:1;fill-rule:evenodd;opacity:1;stroke:#000000;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M21.118,26.0132 C21.118,26.0132,29.4076,27.8928,29.4076,27.8928 C30.2155,28.076,30.722,28.8794,30.5388,29.6874 C30.5388,29.6874,28.3275,39.4398,28.3275,39.4398 C28.1443,40.2477,27.3409,40.7542,26.5329,40.571 C26.5329,40.571,10.929,37.0329,10.929,37.0329 C10.1211,36.8498,9.61466,36.0463,9.79785,35.2384 C9.79785,35.2384,12.2302,24.5107,12.2302,24.5107 C12.2302,24.5107,12.6725,22.5602,12.6725,22.5602 C12.8557,21.7523,13.6591,21.2458,14.4671,21.429 C14.4671,21.429,20.3185,22.7558,20.3185,22.7558 C21.1264,22.939,21.6329,23.7424,21.4497,24.5503 C21.4497,24.5503,21.118,26.0132,21.118,26.0132 z"/>
+    <path id="Path-3" style="fill:#8e7f6d;fill-opacity:1;fill-rule:nonzero;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M41,19 C41,19,36,18,36,18 C36,18,35,23,35,23 C35,23,32,22,32,22 C32,22,23,29,23,29 C23,29,23,41,23,41 C23,41,25,43,25,43 C25,43,39,43,39,43 C40.6569,43,42,41.6569,42,40 C42,40,42,25,42,25 C42,25,40,24,40,24 C40,24,41,19,41,19 z"/>
+    <path id="Path-4" style="fill:#8e7f6d;fill-opacity:1;fill-rule:nonzero;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M13.2766,3.05029 C13.1062,3.01931,12.9326,3.08429,12.8244,3.21952 C12.8244,3.21952,9,8,9,8 C9,8,6.05462,8.58908,6.05462,8.58908 C5.56174,8.68765,5.54512,9.38628,6.03275,9.50819 C6.03275,9.50819,24,14,24,14 C24,14,41.9672,9.50819,41.9672,9.50819 C42.4549,9.38628,42.4383,8.68765,41.9454,8.58908 C41.9454,8.58908,39,8,39,8 C39,8,35.1756,3.21952,35.1756,3.21952 C35.0674,3.08429,34.8938,3.01931,34.7234,3.05029 C34.7234,3.05029,24,5,24,5 C24,5,13.2766,3.05029,13.2766,3.05029 z"/>
+  </g>
+</svg>

package/docs/tosijs-agent.svg

@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="utf-8"?>
+<svg x="0pt" y="0pt" width="48pt" height="48pt" viewBox="0 0 48 48" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <!--Generated by AMDN-->
+  <g id="Layer_1">
+    <g id="Layer_1-1">
+      <g id="Layer_1_1">
+        <g id="Group">
+          <path id="Path" style="fill:#ff1c24;fill-opacity:1;fill-rule:evenodd;opacity:1;stroke:none;" d="M1,9 C1,4.58172,4.58172,1,9,1 C9,1,39,1,39,1 C43.4183,1,47,4.58172,47,9 C47,9,47,39,47,39 C47,43.4183,43.4183,47,39,47 C39,47,9,47,9,47 C4.58172,47,1,43.4183,1,39 C1,39,1,9,1,9 z"/>
+          <g id="Group_1">
+            <path id="Path_1" style="fill:#9e9e9e;fill-opacity:1;fill-rule:nonzero;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M16,29 C16,29,10,31,10,35 C10,39,16,39,16,39"/>
+            <path id="Path_Copy" style="fill:#9e9e9e;fill-opacity:1;fill-rule:nonzero;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M32.0002,29 C32.0002,29,38.0002,31,38.0002,35 C38.0002,39,32.0002,39,32.0002,39"/>
+            <path id="Path_2" style="fill:#ffffff;fill-opacity:1;fill-rule:evenodd;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M9,10.1818 C9,7.87226,10.7909,6,13,6 C13,6,35,6,35,6 C37.2091,6,39,7.87226,39,10.1818 C39,10.1818,39,24.8182,39,24.8182 C39,27.1277,37.2091,29,35,29 C35,29,13,29,13,29 C10.7909,29,9,27.1277,9,24.8182 C9,24.8182,9,10.1818,9,10.1818 z"/>
+            <path id="Path_3" style="fill:#ffffff;fill-opacity:1;fill-rule:nonzero;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M24,11 C24,11,24,23,24,23"/>
+            <path id="Path_4" style="fill:#ffffff;fill-opacity:1;fill-rule:nonzero;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M28,15 C28,15,28,17,28,17"/>
+            <path id="Path_Copy_1" style="fill:#ffffff;fill-opacity:1;fill-rule:nonzero;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M20,15 C20,15,20,17,20,17"/>
+            <path id="Path_5" style="fill:none;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M32,43 C32,43,30,41,30,41 C30,41,28,43,28,43"/>
+            <path id="Path_Copy_2" style="fill:none;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M20,43 C20,43,18,41,18,41 C18,41,16,43,16,43"/>
+            <path id="Path_6" style="fill:#e4e4e4;fill-opacity:1;fill-rule:evenodd;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M16,29 C16,29,32,29,32,29 C32,29,32,39,32,39 C32,39,16,39,16,39 C16,39,16,29,16,29 z"/>
+          </g>
+        </g>
+      </g>
+    </g>
+    <path id="Path-1" style="fill:#006736;fill-opacity:1;fill-rule:evenodd;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M27,17 C27,17,34,17,34,17 C34,17,34,22,34,22 C34,22,27,22,27,22 C27,22,27,17,27,17 z"/>
+    <path id="Path-2" style="fill:none;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M21,19 C21,19,21,19,21,19 C21,17.8954,21.8954,17,23,17 C23,17,25,17,25,17 C26.1046,17,27,17.8954,27,19 C27,19,27,19,27,19"/>
+    <path id="Path_Copy-1" style="fill:#006736;fill-opacity:1;fill-rule:evenodd;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M14,17 C14,17,21,17,21,17 C21,17,21,22,21,22 C21,22,14,22,14,22 C14,22,14,17,14,17 z"/>
+    <path id="Path_Copy-2" style="fill:#8e7f6d;fill-opacity:1;fill-rule:nonzero;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M7.31734,20.5867 C7.14208,19.7104,7.71038,18.8579,8.58668,18.6827 C8.58668,18.6827,10.4133,18.3173,10.4133,18.3173 C11.2896,18.1421,12.1421,18.7104,12.3173,19.5867 C12.3173,19.5867,12.6405,21.2026,12.6405,21.2026 C12.8314,22.157,13.8156,22.7281,14.7389,22.4204 C14.7389,22.4204,15.1785,22.2738,15.1785,22.2738 C15.6917,22.1028,16.2565,22.1995,16.6836,22.5317 C16.6836,22.5317,24.3753,28.5141,24.3753,28.5141 C24.7695,28.8207,25,29.2921,25,29.7914 C25,29.7914,25,40.3298,25,40.3298 C25,40.7589,24.8295,41.1705,24.5261,41.4739 C24.5261,41.4739,23.4739,42.5261,23.4739,42.5261 C23.1705,42.8295,22.7589,43,22.3298,43 C22.3298,43,9,43,9,43 C7.34315,43,6,41.6569,6,40 C6,40,6,26,6,26 C6,25.3871,6.3463,24.8268,6.89452,24.5527 C6.89452,24.5527,6.89452,24.5527,6.89452,24.5527 C7.5472,24.2264,7.90073,23.5036,7.75762,22.7881 C7.75762,22.7881,7.31734,20.5867,7.31734,20.5867 z"/>
+    <path id="Compound_Group" style="fill:#c6b199;fill-opacity:1;fill-rule:evenodd;opacity:1;stroke:#000000;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M21.118,26.0132 C21.118,26.0132,29.4076,27.8928,29.4076,27.8928 C30.2155,28.076,30.722,28.8794,30.5388,29.6874 C30.5388,29.6874,28.3275,39.4398,28.3275,39.4398 C28.1443,40.2477,27.3409,40.7542,26.5329,40.571 C26.5329,40.571,10.929,37.0329,10.929,37.0329 C10.1211,36.8498,9.61466,36.0463,9.79785,35.2384 C9.79785,35.2384,12.2302,24.5107,12.2302,24.5107 C12.2302,24.5107,12.6725,22.5602,12.6725,22.5602 C12.8557,21.7523,13.6591,21.2458,14.4671,21.429 C14.4671,21.429,20.3185,22.7558,20.3185,22.7558 C21.1264,22.939,21.6329,23.7424,21.4497,24.5503 C21.4497,24.5503,21.118,26.0132,21.118,26.0132 z"/>
+    <path id="Path-3" style="fill:#8e7f6d;fill-opacity:1;fill-rule:nonzero;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M41,19 C41,19,36,18,36,18 C36,18,35,23,35,23 C35,23,32,22,32,22 C32,22,23,29,23,29 C23,29,23,41,23,41 C23,41,25,43,25,43 C25,43,39,43,39,43 C40.6569,43,42,41.6569,42,40 C42,40,42,25,42,25 C42,25,40,24,40,24 C40,24,41,19,41,19 z"/>
+    <path id="Path-4" style="fill:#8e7f6d;fill-opacity:1;fill-rule:nonzero;opacity:1;stroke:#000000;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-opacity:1;stroke-width:2;" d="M13.2766,3.05029 C13.1062,3.01931,12.9326,3.08429,12.8244,3.21952 C12.8244,3.21952,9,8,9,8 C9,8,6.05462,8.58908,6.05462,8.58908 C5.56174,8.68765,5.54512,9.38628,6.03275,9.50819 C6.03275,9.50819,24,14,24,14 C24,14,41.9672,9.50819,41.9672,9.50819 C42.4549,9.38628,42.4383,8.68765,41.9454,8.58908 C41.9454,8.58908,39,8,39,8 C39,8,35.1756,3.21952,35.1756,3.21952 C35.0674,3.08429,34.8938,3.01931,34.7234,3.05029 C34.7234,3.05029,24,5,24,5 C24,5,13.2766,3.05029,13.2766,3.05029 z"/>
+  </g>
+</svg>

package/editors/README.md

@@ -0,0 +1,325 @@
+# Editor Integration for AsyncJS
+
+This directory contains syntax highlighting definitions for AsyncJS (the JavaScript subset used by tjs-lang).
+
+## Quick Install
+
+After installing `tjs-lang`, run one of these commands:
+
+```bash
+# VS Code
+npx ajs-install-vscode
+
+# Cursor
+npx ajs-install-cursor
+```
+
+If npx has issues resolving paths, run directly from node_modules:
+
+```bash
+./node_modules/tjs-lang/bin/install-vscode.sh
+./node_modules/tjs-lang/bin/install-cursor.sh
+```
+
+Then restart your editor.
+
+## VS Code / Cursor Extension
+
+The `vscode/` directory contains an extension that provides:
+
+- Syntax highlighting for `.ajs` files
+- Embedded highlighting in `ajs`...`` template literals within TypeScript/JavaScript files
+- Red squiggly highlighting for forbidden syntax (`new`, `class`, `async`, etc.)
+
+### Manual Installation
+
+1. Open VS Code / Cursor
+2. Press `Ctrl+Shift+P` / `Cmd+Shift+P`
+3. Type "Developer: Install Extension from Location..."
+4. Select the `editors/vscode` directory
+
+### Features
+
+**Forbidden syntax is highlighted as an error:**
+
+```javascript
+// These will show red squiggles
+new Date() // Use Date.now() or Date.parse()
+class Foo {} // Use functions and objects
+async function x() {} // Not needed, all calls are implicitly async
+```
+
+**Template literal injection:**
+
+When you write `ajs`...`` in a TypeScript file, the content gets AsyncJS highlighting:
+
+```typescript
+import { ajs } from 'tjs-lang'
+
+const agent = ajs`
+  function search(query: 'string', limit = 10) {
+    let results = storeSearch({ query })
+    return { results }
+  }
+`
+```
+
+## Monaco Editor (Web)
+
+The `monaco/` directory contains Monarch tokenizer definitions for the Monaco Editor (used in VS Code Web, CodeSandbox, etc.).
+
+### Usage (TypeScript)
+
+```typescript
+import * as monaco from 'monaco-editor'
+import { registerAjsLanguage } from 'tjs-lang/editors/monaco/ajs-monarch'
+
+// Register the language
+registerAjsLanguage(monaco)
+
+// Create an editor with AsyncJS
+monaco.editor.create(document.getElementById('container'), {
+  value: `function agent(topic: 'string') {
+  let results = storeSearch({ query: topic })
+  return { results }
+}`,
+  language: 'ajs',
+})
+```
+
+### Usage (Browser)
+
+```html
+<script src="https://unpkg.com/monaco-editor/min/vs/loader.js"></script>
+<script src="path/to/ajs-monarch.js"></script>
+<script>
+  require(['vs/editor/editor.main'], function () {
+    registerAjsLanguage(monaco)
+    monaco.editor.create(document.getElementById('container'), {
+      value: 'function agent(topic: "string") { ... }',
+      language: 'ajs',
+    })
+  })
+</script>
+```
+
+## Syntax Highlighting Rules
+
+### Keywords (blue/purple)
+
+```
+function, return, if, else, while, for, of, in,
+try, catch, finally, throw, let, const
+```
+
+### Literals (orange/green)
+
+```
+true, false, null, numbers, strings
+```
+
+### Forbidden (red/error)
+
+These are JavaScript features not allowed in AsyncJS:
+
+```
+new, class, async, await, var, this, super,
+extends, implements, interface, type, yield,
+import, export, require
+```
+
+### Type Constructors (teal)
+
+Used as factories, not with `new`:
+
+```
+Date, Set, Map, Array, Object
+```
+
+## CodeMirror 6 (Web)
+
+The `codemirror/` directory extends CodeMirror's JavaScript language with AsyncJS error highlighting.
+
+### Usage (TypeScript)
+
+```typescript
+import { EditorState } from '@codemirror/state'
+import { EditorView, basicSetup } from 'codemirror'
+import { ajs } from 'tjs-lang/editors/codemirror/ajs-language'
+
+new EditorView({
+  state: EditorState.create({
+    doc: `function agent(topic: 'string') {
+  let results = storeSearch({ query: topic })
+  return { results }
+}`,
+    extensions: [basicSetup, ajs()],
+  }),
+  parent: document.getElementById('editor'),
+})
+```
+
+### How It Works
+
+CodeMirror 6 uses Lezer grammars (compiled parsers). Rather than creating a full AsyncJS grammar, we:
+
+1. Use the standard JavaScript language
+2. Add a view plugin that marks forbidden keywords as errors
+3. Apply custom styling to show red squiggly underlines
+
+This gives you full JS syntax highlighting with AsyncJS-specific error marking.
+
+## Ace Editor (Web)
+
+The `ace/` directory contains a custom mode for the Ace Editor.
+
+### Usage (ES Module)
+
+```typescript
+import ace from 'ace-builds'
+import { registerAjsMode } from 'tjs-lang/editors/ace/ajs-mode'
+
+// Register the mode
+registerAjsMode(ace)
+
+// Create an editor with AsyncJS
+const editor = ace.edit('editor')
+editor.session.setMode('ace/mode/ajs')
+editor.setValue(`function agent(topic: 'string') {
+  let results = storeSearch({ query: topic })
+  return { results }
+}`)
+```
+
+### Usage (Browser CDN)
+
+```html
+<script src="https://cdnjs.cloudflare.com/ajax/libs/ace/1.32.2/ace.js"></script>
+<script src="path/to/ajs-mode.js"></script>
+<script>
+  // Mode auto-registers when ace is global
+  const editor = ace.edit('editor')
+  editor.session.setMode('ace/mode/ajs')
+</script>
+```
+
+### Features
+
+- Full JavaScript syntax highlighting
+- Forbidden keywords (`new`, `class`, `async`, etc.) highlighted as errors
+- Template literal support with embedded expression highlighting
+- Auto-indent and brace matching
+- Code folding
+
+## Tree-sitter Editors (Zed, Nova, Helix)
+
+These editors use Tree-sitter grammars, which require compiled C/WASM parsers. Since AsyncJS is a JavaScript subset, we recommend:
+
+### Option 1: Use JavaScript Mode
+
+Associate `.ajs` files with JavaScript syntax:
+
+**Zed** (`~/.config/zed/settings.json`):
+
+```json
+{
+  "file_types": {
+    "JavaScript": ["ajs"]
+  }
+}
+```
+
+**Nova**: In Preferences → Languages, add `.ajs` to JavaScript extensions.
+
+**Helix** (`~/.config/helix/languages.toml`):
+
+```toml
+[[language]]
+name = "javascript"
+file-types = ["js", "mjs", "cjs", "ajs"]
+```
+
+### Option 2: Custom Highlighting Queries (Advanced)
+
+If you want forbidden keywords highlighted as errors, you can override the JavaScript highlights query. This varies by editor and requires knowledge of Tree-sitter queries.
+
+Example query addition for `highlights.scm`:
+
+```scheme
+; Mark forbidden keywords as errors
+((identifier) @error
+ (#match? @error "^(new|class|async|await|var|this|super)$"))
+```
+
+### Why Not a Full Tree-sitter Grammar?
+
+Tree-sitter grammars require:
+
+- Writing a grammar DSL that compiles to C
+- Building WASM binaries for web editors
+- Maintaining compatibility with each editor's Tree-sitter version
+- Complex injection queries for template literals
+
+Since AsyncJS is JavaScript with restrictions (not additions), the effort doesn't pay off. The JavaScript grammar already parses everything correctly—we just want to mark certain constructs as errors, which is better done at the linting/transpiler level.
+
+## Syntax Highlighting Rules
+
+### Keywords (blue/purple)
+
+```
+function, return, if, else, while, for, of, in,
+try, catch, finally, throw, let, const
+```
+
+### Literals (orange/green)
+
+```
+true, false, null, numbers, strings
+```
+
+### Forbidden (red/error)
+
+These are JavaScript features not allowed in AsyncJS:
+
+```
+new, class, async, await, var, this, super,
+extends, implements, interface, type, yield,
+import, export, require
+```
+
+### Type Constructors (teal)
+
+Used as factories, not with `new`:
+
+```
+Date, Set, Map, Array, Object
+```
+
+## Contributing
+
+The grammars are defined in:
+
+- `vscode/syntaxes/ajs-injection.tmLanguage.json` - TextMate injection grammar (VS Code, Cursor)
+- `vscode/syntaxes/ajs.tmLanguage.json` - Standalone .ajs file grammar
+- `monaco/ajs-monarch.ts` - Monarch tokenizer (Monaco Editor)
+- `codemirror/ajs-language.ts` - CodeMirror 6 extension
+
+### Keeping Grammars in Sync
+
+When modifying AsyncJS syntax, update **all** grammar files:
+
+1. **Forbidden keywords** - If you add/remove keywords from the transpiler's forbidden list, update:
+
+   - `vscode/syntaxes/ajs-injection.tmLanguage.json` → `forbidden` pattern
+   - `monaco/ajs-monarch.ts` → `forbidden` array
+   - `codemirror/ajs-language.ts` → `FORBIDDEN_KEYWORDS` set
+
+2. **New syntax** - If you add new syntax constructs, add corresponding patterns to each grammar.
+
+3. **Test after changes** - Reinstall the VS Code extension and verify highlighting works.
+
+### Testing Changes
+
+1. VS Code: Use "Developer: Inspect TM Scopes" to debug token scopes
+2. Monaco: Use the [Monaco Playground](https://microsoft.github.io/monaco-editor/playground.html)
+3. CodeMirror: Use the [CodeMirror Try](https://codemirror.net/try/) page