Merge pull request #791 from live-codes/develop

release sdk-v0.9.1

Author: hatemhosny

CHANGELOG.md

@@ -4,7 +4,23 @@ All notable changes to this project will be documented in this file. See [standa
 
 ---
 
-## [v43](https://github.com/live-codes/livecodes/compare/sdk-v0.9.0...0.0.0) (2025-03-15)
+## [sdk-v0.9.1](https://github.com/live-codes/livecodes/compare/v43...sdk-v0.9.1) (2025-04-10)
+
+### Features
+
+- **Editor:** allow folding lines and regions ([984c913](https://github.com/live-codes/livecodes/commit/984c913bcebcc8d0a2f872df1076311d039e65a1))
+
+  A new config option `foldRegions` was added. When set to `true`, regions marked by `#region` and `#endregion` comments are folded when the project is loaded.
+
+  In addition, editor configurations (`config.markup`, `config.style`, `config.script`) have a new property `foldLines` that accepts an array of objects (e.g. `[{ from: 1, to: 5 }]`) that indicates which lines to fold. This can be useful for less relevant code in embedded playgrounds.
+
+* **Config:** add the value `"auto"` to `config.editor` options ([0f62de8](https://github.com/live-codes/livecodes/commit/0f62de8891ca221c035a2a0e8e3cbfcc9133f2a0))
+
+  If set to `auto`, Monaco editor is used on desktop and CodeMirror is used on mobile regardless of other settings. This can be useful in `"simple"` mode.
+
+---
+
+## [v43](https://github.com/live-codes/livecodes/compare/sdk-v0.9.0...v43) (2025-03-15)
 
 ### Highlights for this release
 

README.md

@@ -22,6 +22,7 @@ A [feature-rich](https://livecodes.io/docs/features/), open-source, **client-sid
 [![Lokalise: UI languages](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/live-codes/lokalise-badge/main/badges/languages.json)](https://app.lokalise.com/public/34958094667a72e9454592.95108106/)
 [![license - MIT](https://img.shields.io/github/license/live-codes/livecodes)](https://github.com/live-codes/livecodes/blob/develop/LICENSE)
 [![LiveCodes: GitHub repo](https://img.shields.io/github/stars/live-codes/livecodes?style=flat&logo=github)](https://github.com/live-codes/livecodes)
+[![LiveCodes: GitHub repo](https://img.shields.io/github/forks/live-codes/livecodes?style=flat&logo=github)](https://github.com/live-codes/livecodes)
 [![Follow us on X (formerly Twitter)](https://img.shields.io/badge/Follow%20@livecodes__io-575757?logo=x)](https://x.com/livecodes_io)
 
 [Try it now on livecodes.io](https://livecodes.io)

docs/docs/configuration/configuration-object.mdx

@@ -153,6 +153,12 @@ An object that configures the language and content of the markup editor. This ca
   A URL to load `hiddenContent` from. It has to be a valid URL that is CORS-enabled.
   The URL is only fetched if `hiddenContent` property had no value.
 
+- `foldedLines`:
+  Type: [`Array<{ from: number; to: number }> | undefined`](../api/interfaces/Config.md#foldedlines)
+  Default: `undefined`
+  Lines that get folded when the editor loads. The code can be unfolded by clicking on arrow beside the line.
+  This can be useful for less relevant code in embedded playgrounds.
+
 - `title`:
   Type: [`string | undefined`](../api/interfaces/Config.md#title)
   Default: `""`
@@ -594,13 +600,18 @@ Enables [showing element spacing](../features/result.mdx#show-spacings) in the r
 
 ### `editor`
 
-Type: [`"monaco" | "codemirror" | "codejar" | undefined`](../api/interfaces/Config.md#editor)
+Type: [`"monaco" | "codemirror" | "codejar" | "auto" | undefined`](../api/interfaces/Config.md#editor)
 
 Default: `undefined`
 
 Selects the [code editor](../features/editor-settings.mdx#code-editor) to use.
 
-If `undefined` (the default), Monaco editor is used on desktop, CodeMirror is used on mobile and CodeJar is used in [codeblocks](../features/display-modes.mdx#codeblock), in [lite mode](../features/lite.mdx) and in [readonly](#readonly) playgrounds.
+If `undefined` (the default):<br />
+Monaco editor is used on desktop,<br />
+CodeMirror is used on mobile and in `simple` mode,<br />
+while CodeJar is used in [`codeblock` mode](../features/display-modes.mdx#codeblock), in [`lite` mode](../features/lite.mdx) and in [`readonly`](#readonly) playgrounds.
+
+If set to `auto`, Monaco editor is used on desktop and CodeMirror is used on mobile regardless of other settings.
 
 ### `fontFamily`
 
@@ -661,6 +672,14 @@ Default: `true`
 
 Use auto-complete to close brackets and quotes.
 
+### `foldRegions`
+
+Type: [`boolean`](../api/interfaces/Config.md#foldregions)
+
+Default: `false`
+
+When set to `true`, regions marked by `#region` and `#endregion` comments are folded when the project is loaded.
+
 ### `emmet`
 
 Type: [`boolean`](../api/interfaces/Config.md#emmet)

docs/docs/features/editor-settings.mdx

@@ -46,6 +46,7 @@ These include:
 - [Line numbers](../configuration/configuration-object.mdx#linenumbers)
 - [Word-wrap](../configuration/configuration-object.mdx#wordwrap)
 - [Auto-close brackets and quotes](../configuration/configuration-object.mdx#closebrackets)
+- [Fold (collapse) regions](../configuration/configuration-object.mdx#foldregions)
 
 ### Emmet
 

docs/docs/getting-started.mdx

@@ -27,8 +27,8 @@ LiveCodes [<abbr title="Software Development Kit">SDK</abbr>](./sdk/index.mdx) i
 
 Install from npm.
 
-```shell
-npm i livecodes
+```bash npm2yarn
+npm install livecodes
 ```
 
 then you can use it like that:

docs/docs/languages/coffeescript.mdx

@@ -1,3 +1,47 @@
 # CoffeeScript
 
-TODO...
+[CoffeeScript](https://coffeescript.org/) is a little language that compiles into JavaScript.
+
+## Usage
+
+import LiveCodes from '../../src/components/LiveCodes.tsx';
+
+This example demonstrates usage in LiveCodes:
+
+<LiveCodes template="coffeescript" height="80vh"></LiveCodes>
+
+## Language Info
+
+### Name
+
+`coffeescript`
+
+### Extensions
+
+`.coffee`
+
+### Aliases
+
+`coffee`, `coffeescript`
+
+### Editor
+
+`script`
+
+## Compiler
+
+The official [CoffeeScript compiler](https://www.npmjs.com/package/coffeescript).
+
+### Version
+
+`coffeescript`: v2.7.0
+
+## Starter Template
+
+https://livecodes.io/?template=coffeescript
+
+## Links
+
+- [Official website](https://coffeescript.org/)
+- [Language Reference](https://coffeescript.org/#language)
+- [CoffeeScript on GitHub](https://github.com/jashkenas/coffeescript)

docs/docs/languages/commonlisp.mdx

@@ -1,3 +1,62 @@
 # Common Lisp
 
-TODO...
+[Common Lisp](https://common-lisp.net/) is a dialect of the Lisp programming language.
+
+In LiveCodes, Common Lisp code runs in the browser using [JSCL](https://github.com/jscl-project/jscl), a Common Lisp to JavaScript compiler.
+
+:::info Note
+
+Lisp language family supported in LiveCodes includes [Common Lisp](./commonlisp.mdx), [Scheme](./scheme.mdx), [ClojureScript](./clojurescript.mdx) and [Fennel](./fennel.mdx).
+
+:::
+
+## Usage
+
+LiveCodes runs Common Lisp code in the browser. JSCL implements a subset of Common Lisp, but covers enough functionality to write practical code.
+
+import LiveCodes from '../../src/components/LiveCodes.tsx';
+
+This example demonstrates basic Common Lisp syntax and functionality:
+
+<LiveCodes template="commonlisp" height="80vh"></LiveCodes>
+
+### JS Interoperability
+
+Please see [JSCL docs](https://github.com/jscl-project/jscl/wiki/JSCL-and-manipulations-with-JS-objects)
+
+## Language Info
+
+### Name
+
+`commonlisp`
+
+### Aliases/Extensions
+
+`common-lisp`, `lisp`
+
+### Editor
+
+`script`
+
+## Compiler
+
+[JSCL](https://github.com/jscl-project/jscl) - Common Lisp to JavaScript compiler
+
+## Code Formatting
+
+Using [Parinfer](https://shaunlebron.github.io/parinfer/).
+
+## Limitations
+
+Since JSCL is a subset of Common Lisp, it doesn't implement all Common Lisp features. See the [JSCL documentation](https://github.com/jscl-project/jscl#status) for more information.
+
+## Starter Template
+
+https://livecodes.io/?template=commonlisp
+
+## Links
+
+- [Common Lisp](https://common-lisp.net/)
+- [JSCL](https://github.com/jscl-project/jscl)
+- [Common Lisp: A Gentle Introduction to Symbolic Computation](https://www.cs.cmu.edu/~dst/LispBook/)
+- [Practical Common Lisp](http://www.gigamonkeys.com/book/)

docs/docs/languages/cssmodules.mdx

@@ -183,7 +183,7 @@ The CSS Modules processor is provided using [postcss-modules](https://github.com
 
 ### Version
 
-`postcss-modules`: v6.0.0
+`postcss-modules`: v6.0.1
 
 ## Custom Settings
 

docs/docs/languages/react-native.mdx

@@ -32,6 +32,10 @@ For usage and examples, see documentation for [JSX](./jsx.mdx).
 
 [TypeScript compiler](./typescript.mdx) and [React Native for Web](https://necolas.github.io/react-native-web/)
 
+### Version
+
+`react-native-web`: v0.20.0
+
 ## Code Formatting
 
 Using [Prettier](https://prettier.io/).

docs/docs/languages/react.mdx

@@ -254,6 +254,10 @@ export const styledComponentsDemo = {
 
 [React compiler](https://react.dev/learn/react-compiler), which is a [babel](./babel.mdx) plugin ([babel-plugin-react-compiler](https://www.npmjs.com/package/babel-plugin-react-compiler)).
 
+### Version
+
+`babel-plugin-react-compiler`: v19.0.0-beta-e993439-20250405
+
 ## Code Formatting
 
 Using [Prettier](https://prettier.io/).