add Swift language support

README.md

@@ -13,7 +13,7 @@ A [feature-rich](https://livecodes.io/docs/features/), open-source, **client-sid
 [![LiveCodes: npm version](https://img.shields.io/npm/v/livecodes)](https://www.npmjs.com/package/livecodes)
 [![LiveCodes: npm downloads](https://img.shields.io/npm/dm/livecodes)](https://www.npmjs.com/package/livecodes)
 [![LiveCodes: jsdelivr downloads](https://data.jsdelivr.com/v1/package/npm/livecodes/badge?style=rounded)](https://www.jsdelivr.com/package/npm/livecodes)
-[![LiveCodes: languages](https://img.shields.io/badge/languages-109-blue)](https://livecodes.io/docs/languages/)
+[![LiveCodes: languages](https://img.shields.io/badge/languages-110-blue)](https://livecodes.io/docs/languages/)
 [![LiveCodes: docs](https://img.shields.io/badge/Documentation-575757?logo=gitbook&logoColor=white)](https://livecodes.io/docs/)
 [![LiveCodes: llms.txt](https://img.shields.io/badge/llms.txt-575757?logo=googledocs&logoColor=white)](https://livecodes.io/docs/llms.txt)
 [![LiveCodes: llms-full.txt](https://img.shields.io/badge/llms--full.txt-575757?logo=googledocs&logoColor=white)](https://livecodes.io/docs/llms-full.txt)

docs/docs/languages/swift-wasm.mdx

@@ -0,0 +1,119 @@
+# Swift (Wasm)
+
+[Swift](https://www.swift.org/) is a general-purpose programming language developed by Apple, designed for safety, performance and expressiveness.
+
+In LiveCodes, Swift is compiled to WebAssembly by the Swift compiler itself, running on WebAssembly: `swift-frontend` compiles the source and LLVM's `wasm-ld` links the result, entirely in the browser. No backend is involved.
+
+:::info Note
+
+The native `swiftc` is a driver that spawns the compiler frontend and the linker as separate processes, and WebAssembly cannot spawn processes. Here the two run as separate WebAssembly modules in the same [result page](../features/result.mdx), driven by JavaScript. The toolchain is about 70 MB and is downloaded on the first run, which can take some time.
+
+:::
+
+## Usage
+
+Demo:
+
+import LiveCodes from '../../src/components/LiveCodes.tsx';
+
+export const swiftConfig = {
+  activeEditor: 'script',
+  script: {
+    language: 'swift-wasm',
+    content: `struct Greeting {
+  let name: String
+  var message: String { "Hello, \\(name)!" }
+}\n
+for name in ["World", "LiveCodes", "Swift"] {
+  print(Greeting(name: name).message)
+}`,
+  },
+  mode: 'simple',
+  editor: 'auto',
+  tools: {
+    status: 'full',
+  },
+};
+
+<LiveCodes config={swiftConfig}></LiveCodes>
+
+### Standard I/O
+
+Swift code runs in the context of the [result page](../features/result.mdx). Standard output (e.g. `print`) is captured and displayed in the [console](../features/console.mdx). Standard input is passed by setting the `livecodes.swift.input` property in JavaScript and is read in the Swift code using `readLine()`.
+
+### Communication with JavaScript
+
+The Swift code runs in the context of the result page. A few helper properties and methods are available in the browser global `livecodes.swift` object:
+
+- `livecodes.swift.input`: The standard input passed to the Swift program. It can be set before the initial run, or passed to `run` for subsequent runs.
+- `livecodes.swift.loaded`: A promise that resolves when the Swift environment (compiler, linker and standard library) is fully loaded (and rejects if it fails to load). Other helpers should be used after this promise resolves.
+- `livecodes.swift.ready`: A boolean that is `true` once the environment is loaded and a run has completed.
+- `livecodes.swift.output`: The standard output of the last run.
+- `livecodes.swift.error`: The compiler diagnostics or runtime error of the last run, if any.
+- `livecodes.swift.exitCode`: The exit code of the last run.
+- `livecodes.swift.run(input)`: Runs the code in the editor, optionally passing standard input, and returns a promise that resolves to `{ output, error, exitCode }`.
+
+```js
+await livecodes.swift.loaded;
+const { output, error, exitCode } = await livecodes.swift.run(livecodes.swift.input);
+console.log(output);
+```
+
+## Language Info
+
+### Name
+
+`swift-wasm`
+
+### Aliases / Extensions
+
+`swift`, `swift-wasm`, `wasm.swift`
+
+### Editor
+
+`script`
+
+## Compiler
+
+The [Swift compiler](https://github.com/swiftlang/swift) frontend (`swift-frontend`) and LLVM's `wasm-ld` linker, both compiled to WebAssembly and running in the browser. The build is provided by [`swift-toolchain-wasm`](https://github.com/tothambrus11/swift-toolchain-wasm).
+
+### Version
+
+Swift 6.3.3
+
+## Code Formatting
+
+Not supported.
+
+## Limitations
+
+The compiler runs on WebAssembly, which affects what it can do:
+
+- Programs are single-file.
+- **Macros and compiler plugins are not supported.** Swift runs them as separate processes, and WebAssembly cannot spawn processes.
+- **The Swift-implemented optimizer passes are disabled** because C++ interop is not available for this target. This affects optimization quality, not correctness.
+- **A 4 GiB address space limit applies.** Single-file programs fit comfortably; very large modules may not.
+- The toolchain (about 70 MB) is downloaded on the first run.
+
+## Example Usage
+
+This example passes standard input and runs the code again on each click, using the browser global `livecodes.swift` (also check the code in the HTML editor):
+
+<LiveCodes template="swift-wasm" height="80vh"></LiveCodes>
+
+## Live Reload
+
+By default, new code changes are sent to the result page for re-evaluation without a full page reload, avoiding the need to reinitialize the Swift WebAssembly environment. This behavior can be disabled by adding the code comment `// __livecodes_reload__` to the Swift code, which forces a full page reload.
+
+This comment can be added in the [`hiddenContent` property of the editor](../configuration/configuration-object.mdx#markup) for embedded playgrounds.
+
+## Starter Template
+
+https://livecodes.io/?template=swift-wasm
+
+## Links
+
+- [Swift](https://www.swift.org/)
+- [The Swift Programming Language](https://docs.swift.org/swift-book/)
+- [Swift compiler](https://github.com/swiftlang/swift)
+- [swift-toolchain-wasm](https://github.com/tothambrus11/swift-toolchain-wasm)

docs/src/components/LanguageSliders.tsx

@@ -93,6 +93,7 @@ export default function Sliders() {
       { name: 'objc-wasm', title: 'Objective-C (Wasm)' },
       { name: 'objcpp-wasm', title: 'Objective-C++ (Wasm)' },
       { name: 'rust-wasm', title: 'Rust (Wasm)' },
+      { name: 'swift-wasm', title: 'Swift (Wasm)' },
       { name: 'haskell', title: 'Haskell' },
       { name: 'haskell-wasm', title: 'Haskell (Wasm)' },
       { name: 'zig-wasm', title: 'Zig (Wasm)' },

docs/src/components/TemplateList.tsx

@@ -51,6 +51,7 @@ const templates = [
   { name: 'cpp-wasm', title: 'C++ (Wasm) Starter', thumbnail: 'cpp.svg' },
   { name: 'objc-wasm', title: 'Objective-C (Wasm) Starter', thumbnail: 'objective-c.svg' },
   { name: 'rust-wasm', title: 'Rust (Wasm) Starter', thumbnail: 'rust.svg' },
+  { name: 'swift-wasm', title: 'Swift (Wasm) Starter', thumbnail: 'swift.svg' },
   { name: 'haskell', title: 'Haskell Starter', thumbnail: 'haskell.svg' },
   { name: 'haskell-wasm', title: 'Haskell (Wasm) Starter', thumbnail: 'haskell.svg' },
   { name: 'zig-wasm', title: 'Zig (Wasm) Starter', thumbnail: 'zig.svg' },

e2e/specs/starter.spec.ts

@@ -324,6 +324,35 @@ test.describe('Starter Templates from UI', () => {
     await expect(getResult().locator('text=You clicked')).toHaveText('You clicked 3 times.');
   });
 
+  test('swift-wasm Starter', async ({ page, getTestUrl }) => {
+    // the Swift compiler, the linker and the stdlib sysroot (~70 MB) are downloaded on
+    // the first run
+    test.slow();
+
+    await page.goto(getTestUrl());
+
+    const { app, getResult, waitForResultUpdate } = await getLoadedApp(page);
+
+    await app.click('[aria-label="Project"]');
+    await app.click('text=New');
+    await app.click('text=Swift (Wasm) Starter');
+
+    await waitForEditorFocus(app);
+    await waitForResultUpdate();
+
+    // the counter stays disabled until the toolchain has loaded and run once
+    await expect(getResult().locator('#counter-button')).toBeEnabled({ timeout: 280_000 });
+
+    await getResult().click('text=Click me');
+    await getResult().click('text=Click me');
+    await getResult().click('text=Click me');
+
+    await expect(getResult().locator('h1')).toHaveText('Hello, Swift!');
+    // Each click triggers an asynchronous run, so the counter is asserted with
+    // retries rather than read once.
+    await expect(getResult().locator('text=You clicked')).toHaveText('You clicked 3 times.');
+  });
+
   test('c-wasm Starter', async ({ page, getTestUrl }) => {
     // the compiler, linker and sysroot (~29 MB) are downloaded on the first run
     test.slow();

functions/vendors/templates.js

@@ -51,6 +51,7 @@ export const starterTemplates = {
   "cpp-wasm": "C++ (Wasm) Starter",
   "objc-wasm": "Objective-C (Wasm) Starter",
   "rust-wasm": "Rust (Wasm) Starter",
+  "swift-wasm": "Swift (Wasm) Starter",
   "zig-wasm": "Zig (Wasm) Starter",
   "java": "Java Starter",
   "csharp-wasm": "C# (Wasm) Starter",

scripts/build.js

@@ -265,6 +265,7 @@ const iifeBuild = () =>
       'languages/scss/lang-scss-compiler.ts',
       'languages/solid/lang-solid-compiler.ts',
       'languages/sql/lang-sql-compiler.ts',
+      'languages/swift-wasm/lang-swift-wasm-script.ts',
       'languages/sql/lang-sql-script.ts',
       'languages/svelte/lang-svelte-compiler.ts',
       'languages/tcl/lang-tcl-script.ts',

server/php/inc/starter-templates.json

@@ -51,6 +51,7 @@
   "cpp-wasm": "C++ (Wasm) Starter",
   "objc-wasm": "Objective-C (Wasm) Starter",
   "rust-wasm": "Rust (Wasm) Starter",
+  "swift-wasm": "Swift (Wasm) Starter",
   "zig-wasm": "Zig (Wasm) Starter",
   "java": "Java Starter",
   "csharp-wasm": "C# (Wasm) Starter",

src/livecodes/UI/command-menu-actions.ts

@@ -307,6 +307,7 @@ export const getCommandMenuActions = ({
         'cpp-wasm',
         'objc-wasm',
         'rust-wasm',
+        'swift-wasm',
         'zig-wasm',
         'java',
         'csharp-wasm',

src/livecodes/html/language-info.html

@@ -1433,6 +1433,39 @@ <h3 data-i18n="language-info:rustWasm.name">Rust (Wasm)</h3>
     </li>
   </ul>
 </section>
+<section data-lang="swift-wasm">
+  <h3 data-i18n="language-info:swiftWasm.name">Swift (Wasm)</h3>
+  <div data-i18n="language-info:swiftWasm.desc" data-i18n-prop="innerHTML">
+    Swift is compiled to WebAssembly by the Swift compiler itself: <code>swift-frontend</code> and
+    <code>wasm-ld</code>, both compiled to WebAssembly, run entirely in the browser. No server is
+    involved.
+  </div>
+  <ul data-i18n="language-info:swiftWasm.link" data-i18n-prop="innerHTML">
+    <li>
+      <a href="https://www.swift.org/" target="_blank" rel="noopener">Swift official website</a>
+    </li>
+    <li>
+      <a href="https://docs.swift.org/swift-book/" target="_blank" rel="noopener"
+        >The Swift Programming Language</a
+      >
+    </li>
+    <li>
+      <a href="https://learnxinyminutes.com/swift/" target="_blank" rel="noopener"
+        >Learn X in Y minutes, where X=Swift</a
+      >
+    </li>
+    <li>
+      <a href="{{DOCS_BASE_URL}}languages/swift-wasm" target="_blank" rel="noopener"
+        >LiveCodes Documentation</a
+      >
+    </li>
+    <li>
+      <a href="?template=swift-wasm" class="button" target="_parent" data-template="swift-wasm"
+        >Load starter template</a
+      >
+    </li>
+  </ul>
+</section>
 <section data-lang="twig">
   <h3 data-i18n="language-info:twig.name">Twig</h3>
   <div data-i18n="language-info:twig.desc" data-i18n-prop="innerHTML">

src/livecodes/i18n/locales/ar/language-info.lokalise.json

@@ -804,6 +804,15 @@
   "svelte.name": {
     "translation": "Svelte"
   },
+  "swiftWasm.desc": {
+    "translation": "يتم تجميع Swift إلى WebAssembly بواسطة مُترجم Swift نفسه: <tag-1>swift-frontend</tag-1> و<tag-2>wasm-ld</tag-2>، وكلاهما مُجمَّع إلى WebAssembly ويعمل بالكامل داخل المتصفح. لا يتضمن ذلك أي خادم."
+  },
+  "swiftWasm.link": {
+    "translation": "<tag-1> <tag-2>الموقع الرسمي لـ Swift</tag-2> </tag-1> <tag-3> <tag-4>لغة البرمجة Swift</tag-4> </tag-3> <tag-5> <tag-6>تعلم X في Y دقائق، حيث X = Swift</tag-6> </tag-5> <tag-7> <tag-8>وثائق LiveCodes</tag-8> </tag-7> <tag-9> <tag-10>تحميل قالب البدء</tag-10> </tag-9>"
+  },
+  "swiftWasm.name": {
+    "translation": "Swift (Wasm)"
+  },
   "tcl.desc": {
     "translation": "Tcl يعمل في المتصفح، باستخدام <tag-1>wacl</tag-1>."
   },

src/livecodes/i18n/locales/ar/language-info.ts

@@ -451,6 +451,11 @@ const languageInfo: I18nLangInfoTranslation = {
     link: '<1> <2>الموقع الرسمي لـ Svelte</2> </1> <3> <4>وثائق Svelte</4> </3> <5> <6>تحميل القالب الأولي</6> </5>',
     name: 'Svelte',
   },
+  swiftWasm: {
+    desc: 'يتم تجميع Swift إلى WebAssembly بواسطة مُترجم Swift نفسه: <1>swift-frontend</1> و<2>wasm-ld</2>، وكلاهما مُجمَّع إلى WebAssembly ويعمل بالكامل داخل المتصفح. لا يتضمن ذلك أي خادم.',
+    link: '<1> <2>الموقع الرسمي لـ Swift</2> </1> <3> <4>لغة البرمجة Swift</4> </3> <5> <6>تعلم X في Y دقائق، حيث X = Swift</6> </5> <7> <8>وثائق LiveCodes</8> </7> <9> <10>تحميل قالب البدء</10> </9>',
+    name: 'Swift (Wasm)',
+  },
   tcl: {
     desc: 'Tcl يعمل في المتصفح، باستخدام <1>wacl</1>.',
     link: '<1> <2>الموقع الرسمي لـ Tcl</2> </1> <3> <4>مستودع wacl</4> </3> <5> <6>تعلم X في Y دقائق، حيث X=Tcl</6> </5> <7> <8>تحميل القالب الأولي</8> </7>',

src/livecodes/i18n/locales/ar/translation.lokalise.json

@@ -2127,6 +2127,9 @@
   "templates.starter.svelte": {
     "translation": "قالب Svelte"
   },
+  "templates.starter.swift-wasm": {
+    "translation": "قالب Swift (Wasm)"
+  },
   "templates.starter.tailwindcss": {
     "translation": "قالب Tailwind CSS"
   },

src/livecodes/i18n/locales/ar/translation.ts

@@ -1048,6 +1048,7 @@ const translation: I18nTranslation = {
       sql: 'قالب SQL',
       stencil: 'قالب Stencil',
       svelte: 'قالب Svelte',
+      'swift-wasm': 'قالب Swift (Wasm)',
       tailwindcss: 'قالب Tailwind CSS',
       tcl: 'قالب Tcl',
       teal: 'قالب Teal',

src/livecodes/i18n/locales/bn/language-info.lokalise.json

@@ -804,6 +804,15 @@
   "svelte.name": {
     "translation": "Svelte"
   },
+  "swiftWasm.desc": {
+    "translation": "Swift স্বয়ং Swift কম্পাইলার দ্বারা WebAssembly-তে কম্পাইল করা হয়েছে: <tag-1>swift-frontend</tag-1> এবং <tag-2>wasm-ld</tag-2>, উভয়ই WebAssembly-তে কম্পাইল করা হয়েছে এবং সম্পূর্ণরূপে ব্রাউজারে চলে। কোনো সার্ভার জড়িত নয়।"
+  },
+  "swiftWasm.link": {
+    "translation": "<tag-1> <tag-2>Swift অফিসিয়াল ওয়েবসাইট</tag-2> </tag-1> <tag-3> <tag-4>Swift প্রোগ্রামিং ভাষা</tag-4> </tag-3> <tag-5> <tag-6>Y মিনিটে X শিখুন, যেখানে X=Swift</tag-6> </tag-5> <tag-7> <tag-8>লাইভকোডস ডকুমেন্টেশন</tag-8> </tag-7> <tag-9> <tag-10>স্টার্টার টেমপ্লেট লোড করুন</tag-10> </tag-9>"
+  },
+  "swiftWasm.name": {
+    "translation": "Swift (Wasm)"
+  },
   "tcl.desc": {
     "translation": "<tag-1>wacl</tag-1> ব্যবহার করে ব্রাউজারে চলমান Tcl।"
   },

src/livecodes/i18n/locales/bn/language-info.ts

@@ -453,6 +453,11 @@ const languageInfo: I18nLangInfoTranslation = {
     link: '<1> <2>Svelte অফিসিয়াল ওয়েবসাইট</2> </1> <3> <4>Svelte ডকুমেন্টেশন</4> </3> <5> <6>স্টার্টার টেমপ্লেট লোড করুন</6> </5>',
     name: 'Svelte',
   },
+  swiftWasm: {
+    desc: 'Swift স্বয়ং Swift কম্পাইলার দ্বারা WebAssembly-তে কম্পাইল করা হয়েছে: <1>swift-frontend</1> এবং <2>wasm-ld</2>, উভয়ই WebAssembly-তে কম্পাইল করা হয়েছে এবং সম্পূর্ণরূপে ব্রাউজারে চলে। কোনো সার্ভার জড়িত নয়।',
+    link: '<1> <2>Swift অফিসিয়াল ওয়েবসাইট</2> </1> <3> <4>Swift প্রোগ্রামিং ভাষা</4> </3> <5> <6>Y মিনিটে X শিখুন, যেখানে X=Swift</6> </5> <7> <8>লাইভকোডস ডকুমেন্টেশন</8> </7> <9> <10>স্টার্টার টেমপ্লেট লোড করুন</10> </9>',
+    name: 'Swift (Wasm)',
+  },
   tcl: {
     desc: '<1>wacl</1> ব্যবহার করে ব্রাউজারে চলমান Tcl।',
     link: '<1> <2>Tcl অফিসিয়াল ওয়েবসাইট</2> </1> <3> <4>wacl রেপো</4> </3> <5> <6>Y মিনিটে X শিখুন, যেখানে X=Tcl</6> </5> <7> <8>স্টার্টার টেমপ্লেট লোড করুন</8> </7>',

src/livecodes/i18n/locales/bn/translation.lokalise.json

@@ -2127,6 +2127,9 @@
   "templates.starter.svelte": {
     "translation": "Svelte স্টার্টার"
   },
+  "templates.starter.swift-wasm": {
+    "translation": "Swift (Wasm) স্টার্টার"
+  },
   "templates.starter.tailwindcss": {
     "translation": "Tailwind CSS স্টার্টার"
   },

src/livecodes/i18n/locales/bn/translation.ts

@@ -1048,6 +1048,7 @@ const translation: I18nTranslation = {
       sql: 'SQL স্টার্টার',
       stencil: 'Stencil স্টার্টার',
       svelte: 'Svelte স্টার্টার',
+      'swift-wasm': 'Swift (Wasm) স্টার্টার',
       tailwindcss: 'Tailwind CSS স্টার্টার',
       tcl: 'Tcl স্টার্টার',
       teal: 'Teal স্টার্টার',

src/livecodes/i18n/locales/de/language-info.lokalise.json

@@ -804,6 +804,15 @@
   "svelte.name": {
     "translation": "Svelte"
   },
+  "swiftWasm.desc": {
+    "translation": "Swift wird vom Swift-Compiler selbst zu WebAssembly kompiliert: <tag-1>swift-frontend</tag-1> und <tag-2>wasm-ld</tag-2> sind beide zu WebAssembly kompiliert und laufen vollständig im Browser. Es ist kein Server beteiligt."
+  },
+  "swiftWasm.link": {
+    "translation": "<tag-1> <tag-2>Offizielle Website von Swift</tag-2> </tag-1> <tag-3> <tag-4>Die Swift Programmiersprache</tag-4> </tag-3> <tag-5> <tag-6>Lerne X in Y Minuten, wobei X = Swift</tag-6> </tag-5> <tag-7> <tag-8>LiveCodes-Dokumentation</tag-8> </tag-7> <tag-9> <tag-10>Startervorlage laden</tag-10> </tag-9>"
+  },
+  "swiftWasm.name": {
+    "translation": "Swift (Wasm)"
+  },
   "tcl.desc": {
     "translation": "Tcl läuft im Browser mit <tag-1>wacl</tag-1>."
   },