live-codes · hatemhosny · Nov 8, 2025 · Nov 8, 2025 · Nov 8, 2025 · Nov 8, 2025
diff --git a/.agents/skills/_artifacts/domain_map.yaml b/.agents/skills/_artifacts/domain_map.yaml
@@ -1,13 +1,13 @@
 # domain_map.yaml
 # Generated by skill-domain-discovery
 # Library: livecodes
-# Version: 0.13.0
+# Version: 0.14.1
 # Date: 2025-03-28
 # Status: reviewed
 
 library:
   name: 'livecodes'
-  version: '0.13.0'
+  version: '0.14.1'
   repository: 'https://github.com/live-codes/livecodes'
   description: 'A feature-rich, open-source, client-side code playground that supports 90+ languages/frameworks. Runs entirely in the browser with no server required.'
   primary_framework: 'framework-agnostic'

diff --git a/.agents/skills/_artifacts/skill_tree.yaml b/.agents/skills/_artifacts/skill_tree.yaml
@@ -4,7 +4,7 @@
 
 library:
   name: 'livecodes'
-  version: '0.13.0'
+  version: '0.14.1'
   repository: 'https://github.com/live-codes/livecodes'
   description: 'A feature-rich, open-source, client-side code playground supporting 90+ languages/frameworks with SDK for embedding'
 generated_from:

diff --git a/.agents/skills/livecodes/SKILL.md b/.agents/skills/livecodes/SKILL.md
@@ -6,7 +6,7 @@ description: >-
   LiveCodes skills.
 type: core
 library: livecodes
-library_version: 0.13.0
+library_version: 0.14.1
 ---
 
 # LiveCodes Overview
@@ -24,7 +24,7 @@ LiveCodes is a feature-rich, open-source, client-side code playground that runs
 | Quick start for beginners                        | [livecodes/getting-started/SKILL.md](./getting-started/SKILL.md)           |
 | Create embedded playgrounds                      | [livecodes/sdk-embedding/SKILL.md](./sdk-embedding/SKILL.md)               |
 | Use SDK methods (run, getCode, setConfig, watch) | [livecodes/sdk-methods/SKILL.md](./sdk-methods/SKILL.md)                   |
-| Compress/decompress config utilities         | [livecodes/sdk-embedding/SKILL.md](./sdk-embedding/SKILL.md)               |
+| Compress/decompress config utilities             | [livecodes/sdk-embedding/SKILL.md](./sdk-embedding/SKILL.md)               |
 | Configure via Config object, query params        | [livecodes/configuration/SKILL.md](./configuration/SKILL.md)               |
 | Choose display mode (full, simple, result, etc.) | [livecodes/display-modes/SKILL.md](./display-modes/SKILL.md)               |
 | Run playgrounds without visible UI               | [livecodes/headless-mode/SKILL.md](./headless-mode/SKILL.md)               |

diff --git a/.agents/skills/livecodes/configuration/SKILL.md b/.agents/skills/livecodes/configuration/SKILL.md
@@ -6,7 +6,7 @@ description: >
   when setting up project content, configuring CSS processors, or customizing display.
 type: core
 library: livecodes
-library_version: 0.13.0
+library_version: 0.14.1
 sources:
   - live-codes/livecodes:docs/docs/configuration/configuration-object.mdx
   - live-codes/livecodes:docs/docs/configuration/query-params.mdx

diff --git a/.agents/skills/livecodes/display-modes/SKILL.md b/.agents/skills/livecodes/display-modes/SKILL.md
@@ -6,7 +6,7 @@ description: >
   embeddings, configuring read-only views, or showing only result or editor.
 type: core
 library: livecodes
-library_version: 0.13.0
+library_version: 0.14.1
 requires:
   - configuration
 sources:

diff --git a/.agents/skills/livecodes/framework-wrappers/SKILL.md b/.agents/skills/livecodes/framework-wrappers/SKILL.md
@@ -6,7 +6,7 @@ description: >
   Load this skill when embedding LiveCodes in a framework application.
 type: framework
 library: livecodes
-library_version: 0.13.0
+library_version: 0.14.1
 requires:
   - sdk-embedding
   - sdk-methods

diff --git a/.agents/skills/livecodes/getting-started/SKILL.md b/.agents/skills/livecodes/getting-started/SKILL.md
@@ -5,7 +5,7 @@ description: >
   and self-hosting basics. Load this skill for initial setup and basic usage patterns.
 type: lifecycle
 library: livecodes
-library_version: 0.13.0
+library_version: 0.14.1
 sources:
   - live-codes/livecodes:README.md
   - live-codes/livecodes:docs/docs/getting-started.mdx
@@ -132,7 +132,7 @@ createPlayground('#container', {
 });
 
 // SDK version pinning
-import { createPlayground } from 'https://cdn.jsdelivr.net/npm/livecodes@0.13.0';
+import { createPlayground } from 'https://cdn.jsdelivr.net/npm/livecodes@0.14.1';
 ```
 
 ## Common Patterns by Use Case

diff --git a/.agents/skills/livecodes/gh-action/SKILL.md b/.agents/skills/livecodes/gh-action/SKILL.md
@@ -5,7 +5,7 @@ description: >
   for pull request code changes. Automates playground creation and PR comments.
 type: composition
 library: livecodes
-library_version: 0.13.0
+library_version: 0.14.1
 requires: []
 sources:
   - live-codes/preview-in-livecodes:README.md

diff --git a/.agents/skills/livecodes/headless-mode/SKILL.md b/.agents/skills/livecodes/headless-mode/SKILL.md
@@ -6,7 +6,7 @@ description: >
   output without display.
 type: core
 library: livecodes
-library_version: 0.13.0
+library_version: 0.14.1
 requires:
   - sdk-embedding
   - sdk-methods

diff --git a/.agents/skills/livecodes/import-export/SKILL.md b/.agents/skills/livecodes/import-export/SKILL.md
@@ -6,7 +6,7 @@ description: >
   when loading projects from external sources or exporting project state.
 type: core
 library: livecodes
-library_version: 0.13.0
+library_version: 0.14.1
 sources:
   - live-codes/livecodes:docs/docs/features/import.mdx
   - live-codes/livecodes:docs/docs/features/export.mdx

diff --git a/.agents/skills/livecodes/language-support/SKILL.md b/.agents/skills/livecodes/language-support/SKILL.md
@@ -7,7 +7,7 @@ description: >
   Python, Ruby, or Go.
 type: core
 library: livecodes
-library_version: 0.13.0
+library_version: 0.14.1
 sources:
   - live-codes/livecodes:docs/docs/languages/index.mdx
   - live-codes/livecodes:docs/docs/languages/_template.mdx

diff --git a/.agents/skills/livecodes/markdown-integration/SKILL.md b/.agents/skills/livecodes/markdown-integration/SKILL.md
@@ -6,7 +6,7 @@ description: >
   Docusaurus, Astro, VitePress, Next.js, and Storybook.
 type: composition
 library: livecodes
-library_version: 0.13.0
+library_version: 0.14.1
 requires:
   - sdk-embedding
 sources:

diff --git a/.agents/skills/livecodes/module-resolution/SKILL.md b/.agents/skills/livecodes/module-resolution/SKILL.md
@@ -7,7 +7,7 @@ description: >
   or resolving import conflicts.
 type: core
 library: livecodes
-library_version: 0.13.0
+library_version: 0.14.1
 sources:
   - live-codes/livecodes:docs/docs/features/module-resolution.mdx
   - live-codes/livecodes:src/livecodes/compiler/import-map.ts

diff --git a/.agents/skills/livecodes/sdk-embedding/SKILL.md b/.agents/skills/livecodes/sdk-embedding/SKILL.md
@@ -7,7 +7,7 @@ description: >
   containers, or setting up SDK integration.
 type: core
 library: livecodes
-library_version: 0.13.0
+library_version: 0.14.1
 sources:
   - live-codes/livecodes:docs/docs/sdk/js-ts.mdx
   - live-codes/livecodes:src/sdk/index.ts

diff --git a/.agents/skills/livecodes/sdk-methods/SKILL.md b/.agents/skills/livecodes/sdk-methods/SKILL.md
@@ -7,7 +7,7 @@ description: >
   or retrieving compiled output.
 type: core
 library: livecodes
-library_version: 0.13.0
+library_version: 0.14.1
 requires:
   - sdk-embedding
 sources:

diff --git a/.agents/skills/livecodes/self-hosting/SKILL.md b/.agents/skills/livecodes/self-hosting/SKILL.md
@@ -6,7 +6,7 @@ description: >
   when self-hosting LiveCodes or using a custom app URL.
 type: composition
 library: livecodes
-library_version: 0.13.0
+library_version: 0.14.1
 requires:
   - sdk-embedding
 sources:
@@ -152,9 +152,9 @@ createPlayground('#container', {
 });
 
 // Pin SDK version
-import { createPlayground } from 'livecodes@0.13.0';
+import { createPlayground } from 'livecodes@0.14.1';
 // or
-import { createPlayground } from 'https://cdn.jsdelivr.net/npm/livecodes@0.13.0';
+import { createPlayground } from 'https://cdn.jsdelivr.net/npm/livecodes@0.14.1';
 ```
 
 Permanent URLs format: `https://v{VERSION}.livecodes.io`

diff --git a/.agents/skills/livecodes/testing/SKILL.md b/.agents/skills/livecodes/testing/SKILL.md
@@ -6,7 +6,7 @@ description: >
   Load this skill when writing tests for playground code or running tests via SDK.
 type: core
 library: livecodes
-library_version: 0.13.0
+library_version: 0.14.1
 sources:
   - live-codes/livecodes:docs/docs/features/tests.mdx
 ---

diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -25,7 +25,8 @@
     "services",
     "CommandMenu",
     "Accessibility",
-    "self-hosting"
+    "self-hosting",
+    "Sidebar"
   ],
   "html.customData": ["./.vscode/html.html-data.json"]
 }
diff --git a/README.md b/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-98-blue)](https://livecodes.io/docs/languages/)
+[![LiveCodes: languages](https://img.shields.io/badge/languages-100-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)

diff --git a/docs/docs/configuration/configuration-object.mdx b/docs/docs/configuration/configuration-object.mdx
@@ -141,6 +141,12 @@ An object that configures the language and content of the markup editor. This ca
   A URL to load `content` from. It has to be a valid URL that is CORS-enabled.
   The URL is only fetched if `content` property had no value.
 
+- `hidden`:
+  Type: [`boolean | undefined`](../api/interfaces/Config.md#hidden)
+  Default: `""`
+  If `true`, the title of the code editor is hidden, however its code is still evaluated.
+  This can be useful in embedded playgrounds (e.g. for hiding unnecessary code).
+
 - `hiddenContent`:
   Type: [`string | undefined`](../api/interfaces/Config.md#hiddencontent)
   Default: `undefined`
@@ -153,18 +159,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: `""`
   If set, this is used as the title of the editor in the UI, overriding the default title set to the language name (e.g. "Python" can be used instead of "Py (Wasm)").
 
-- `hideTitle`:
+- `hideTitle` (**deprecated**, use `hidden` instead):
   Type: [`boolean | undefined`](../api/interfaces/Config.md#hidetitle)
   Default: `""`
   If `true`, the title of the code editor is hidden, however its code is still evaluated.
@@ -186,6 +186,12 @@ An object that configures the language and content of the markup editor. This ca
   The initial position of the cursor in the code editor.
   Example: `{lineNumber: 5, column: 10}`
 
+- `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.
+
 ### `style`
 
 Type: [`Editor`](../api/interfaces/Config.md#style)

diff --git a/docs/docs/contribution/README.md b/docs/docs/contribution/README.md
@@ -23,11 +23,11 @@ This directory contains comprehensive documentation for contributors working on
 
 ### Editor & UI
 
-| Document                                             | Description                                                   |
-| ---------------------------------------------------- | ------------------------------------------------------------- |
-| [editor-system.mdx](./editor-system.mdx)             | Multi-editor support (Monaco, CodeMirror, CodeJar) and themes |
-| [ui-design-system.mdx](./ui-design-system.mdx)       | UI components, styling, theming, and responsive design        |
-| [tools-pane-system.mdx](./tools-pane-system.mdx)     | Console, compiled code viewer, and test runner                |
+| Document                                              | Description                                                   |
+| ----------------------------------------------------- | ------------------------------------------------------------- |
+| [editor-system.mdx](./editor-system.mdx)              | Multi-editor support (Monaco, CodeMirror, CodeJar) and themes |
+| [ui-design-system.mdx](./ui-design-system.mdx)        | UI components, styling, theming, and responsive design        |
+| [tools-pane-system.mdx](./tools-pane-system.mdx)      | Console, compiled code viewer, and test runner                |
 | [notifications-system.md](./notifications-system.mdx) | Toast notification system                                     |
 
 ### Language Support
@@ -40,12 +40,13 @@ This directory contains comprehensive documentation for contributors working on
 
 ### Features
 
-| Document                                                   | Description                                               |
-| ---------------------------------------------------------- | --------------------------------------------------------- |
-| [import-system.mdx](./import-system.mdx)                   | Import from GitHub, GitLab, files, URLs, and more         |
-| [export-system.mdx](./export-system.mdx)                   | Export to JSON, ZIP, HTML, CodePen, JSFiddle, GitHub Gist |
-| [result-page.mdx](./result-page.mdx)                       | Result iframe generation and sandbox creation             |
-| [code-formatting-system.mdx](./code-formatting-system.mdx) | Prettier integration and custom formatters                |
+| Document                                                                     | Description                                               |
+| ---------------------------------------------------------------------------- | --------------------------------------------------------- |
+| [import-system.mdx](./import-system.mdx)                                     | Import from GitHub, GitLab, files, URLs, and more         |
+| [export-system.mdx](./export-system.mdx)                                     | Export to JSON, ZIP, HTML, CodePen, JSFiddle, GitHub Gist |
+| [result-page.mdx](./result-page.mdx)                                         | Result iframe generation and sandbox creation             |
+| [sourcemaps-console-line-numbers.mdx](./sourcemaps-console-line-numbers.mdx) | Console log/error line mapping via source maps            |
+| [code-formatting-system.mdx](./code-formatting-system.mdx)                   | Prettier integration and custom formatters                |
 
 ### Services & Infrastructure
 
@@ -80,8 +81,8 @@ This directory contains comprehensive documentation for contributors working on
 
 ### Deployment
 
-| Document                           | Description                                   |
-| ---------------------------------- | --------------------------------------------- |
+| Document                           | Description                                    |
+| ---------------------------------- | ---------------------------------------------- |
 | [deployment.mdx](./deployment.mdx) | GitHub Actions deployment workflows and guards |
 
 ## Code Style

diff --git a/docs/docs/contribution/compiler-system.mdx b/docs/docs/contribution/compiler-system.mdx
@@ -34,7 +34,7 @@ graph TD
         A --> L[compiler-utils.ts]
         A --> M[utils.ts]
     end
-    
+
     B["Type definitions"]
     C["Main compiler factory"]
     D["Compiler instance getter"]
@@ -158,9 +158,14 @@ interface CompileInfo {
   importedContent?: string;
   imports?: Record<string, string>;
   errors?: string[];
+  sourceMaps?: Record<string, string>;
 }
 ```
 
+Compiled languages can populate `sourceMaps` (a record keyed by filename) used to map
+runtime console logs/errors back to source lines; see
+[Source Maps & Console Line Numbers](./sourcemaps-console-line-numbers.mdx).
+
 ## Compilation Flow
 
 ### Main Thread Flow
@@ -314,13 +319,13 @@ Workers and main thread communicate via typed messages:
 sequenceDiagram
     participant Main as Main Thread
     participant Worker as Worker
-    
+
     Main->>Worker: init (config)
     Worker->>Main: init-success
-    
+
     Main->>Worker: load (typescript)
     Worker->>Main: loaded (typescript)
-    
+
     Main->>Worker: compile (code, language)
     Worker->>Main: compiled (result)
 ```

diff --git a/docs/docs/contribution/result-page.mdx b/docs/docs/contribution/result-page.mdx
@@ -256,6 +256,10 @@ handleResize()
 handleScrollPosition()
 ```
 
+`proxyConsole()` computes the caller's source and line before forwarding each message; see
+[Source Maps & Console Line Numbers](./sourcemaps-console-line-numbers.mdx) for how logs and
+errors are mapped back to the source file and line.
+
 ---
 
 ## Import Resolution Flow