` which is used by
8 | //
9 |
10 | ///|
11 | /// sol-nav.js to replace content during navigation.
12 | pub fn outlet(
13 | name~ : String,
14 | children : Array[@luna.Node[Unit]],
15 | id? : String,
16 | class? : String,
17 | style? : String,
18 | attrs? : Array[(String, @luna.Attr[Unit])],
19 | ) -> @luna.Node[Unit] {
20 | let props = build_attrs(id, class, style, attrs)
21 | props.push(("data-sol-outlet", static_attr(name)))
22 | create_element("div", props, children)
23 | }
24 |
25 | ///|
26 | /// Create a template element for fragment response
27 | /// Used internally to wrap outlet content in fragment responses.
28 | pub fn template_outlet(
29 | name~ : String,
30 | children : Array[@luna.Node[Unit]],
31 | ) -> @luna.Node[Unit] {
32 | let props : Array[(String, @luna.Attr[Unit])] = []
33 | props.push(("data-sol-outlet", static_attr(name)))
34 | create_element("template", props, children)
35 | }
36 |
37 | ///|
38 | /// Create a template element for page title in fragment response
39 | pub fn template_title(title : String) -> @luna.Node[Unit] {
40 | let props : Array[(String, @luna.Attr[Unit])] = []
41 | props.push(("data-sol-title", static_attr("")))
42 | create_element("template", props, [text(title)])
43 | }
44 |
--------------------------------------------------------------------------------
/src/stella/README.md:
--------------------------------------------------------------------------------
1 | # Stella
2 |
3 | Island埋め込み用のShard生成モジュール。
4 |
5 | ## 概要
6 |
7 | Shard は Island Architecture における hydration 可能なHTML断片。
8 | `luna:*` 属性でマークアップされ、ローダーがクライアントで検知・hydrate する。
9 |
10 | ## ファイル構成
11 |
12 | | ファイル | 責務 |
13 | |---------|------|
14 | | `types.mbt` | Shard設定・出力の型定義 |
15 | | `html_builder.mbt` | HTML生成ユーティリティ |
16 | | `serializer.mbt` | JSON/HTMLエスケープ処理 |
17 |
18 | ## Shard出力例
19 |
20 | ```html
21 |
25 |
26 |
27 | ```
28 |
29 | ## 主要な型
30 |
31 | ### ShardConfig
32 |
33 | ```moonbit
34 | pub struct ShardConfig {
35 | id : String // コンポーネントID (luna:id)
36 | script_url : String // Hydrationスクリプト (luna:url)
37 | trigger : TriggerType // トリガー (luna:client-trigger)
38 | state : StateConfig // 状態設定
39 | ssr_content : String? // SSR済みHTML
40 | include_loader : Bool // ローダー埋め込み
41 | loader_url : String // ローダーURL
42 | }
43 | ```
44 |
45 | ### StateConfig
46 |
47 | ```moonbit
48 | pub enum StateConfig {
49 | Empty // 状態なし
50 | Inline(String) // luna:state属性に埋め込み
51 | ScriptRef(String) // ` はエスケープ済み
60 | - HTML属性値は適切にクォート
61 |
62 | ## 参照
63 |
64 | - [Luna Core](../luna/README.md) - TriggerType の定義
65 | - [Sol](../sol/README.md) - Island統合の実装
66 |
--------------------------------------------------------------------------------
/js/astra/assets/scripts/toc.js:
--------------------------------------------------------------------------------
1 | (function(){
2 | var observer = null;
3 | var tocLinks = [];
4 | var headings = [];
5 | function initTocSpy() {
6 | if (observer) observer.disconnect();
7 | tocLinks = Array.from(document.querySelectorAll('.toc-item a'));
8 | headings = tocLinks.map(function(link) {
9 | var id = link.getAttribute('href')?.slice(1);
10 | return id ? document.getElementById(id) : null;
11 | }).filter(Boolean);
12 | if (!headings.length) return;
13 | var current = null;
14 | observer = new IntersectionObserver(function(entries) {
15 | entries.forEach(function(entry) {
16 | if (entry.isIntersecting) current = entry.target;
17 | });
18 | if (!current) {
19 | var scrollY = window.scrollY + 100;
20 | for (var i = headings.length - 1; i >= 0; i--) {
21 | if (headings[i].offsetTop <= scrollY) { current = headings[i]; break; }
22 | }
23 | }
24 | tocLinks.forEach(function(link) {
25 | var id = link.getAttribute('href')?.slice(1);
26 | if (current && id === current.id) {
27 | link.classList.add('active');
28 | } else {
29 | link.classList.remove('active');
30 | }
31 | });
32 | }, { rootMargin: '-60px 0px -70% 0px', threshold: 0 });
33 | headings.forEach(function(h) { observer.observe(h); });
34 | }
35 | if (document.readyState === 'loading') {
36 | document.addEventListener('DOMContentLoaded', initTocSpy);
37 | } else {
38 | initTocSpy();
39 | }
40 | window.__ASTRA_INIT_TOC_SPY__ = initTocSpy;
41 | })();
42 |
--------------------------------------------------------------------------------
/src/astra/assets/scripts/toc.js:
--------------------------------------------------------------------------------
1 | (function(){
2 | var observer = null;
3 | var tocLinks = [];
4 | var headings = [];
5 | function initTocSpy() {
6 | if (observer) observer.disconnect();
7 | tocLinks = Array.from(document.querySelectorAll('.toc-item a'));
8 | headings = tocLinks.map(function(link) {
9 | var id = link.getAttribute('href')?.slice(1);
10 | return id ? document.getElementById(id) : null;
11 | }).filter(Boolean);
12 | if (!headings.length) return;
13 | var current = null;
14 | observer = new IntersectionObserver(function(entries) {
15 | entries.forEach(function(entry) {
16 | if (entry.isIntersecting) current = entry.target;
17 | });
18 | if (!current) {
19 | var scrollY = window.scrollY + 100;
20 | for (var i = headings.length - 1; i >= 0; i--) {
21 | if (headings[i].offsetTop <= scrollY) { current = headings[i]; break; }
22 | }
23 | }
24 | tocLinks.forEach(function(link) {
25 | var id = link.getAttribute('href')?.slice(1);
26 | if (current && id === current.id) {
27 | link.classList.add('active');
28 | } else {
29 | link.classList.remove('active');
30 | }
31 | });
32 | }, { rootMargin: '-60px 0px -70% 0px', threshold: 0 });
33 | headings.forEach(function(h) { observer.observe(h); });
34 | }
35 | if (document.readyState === 'loading') {
36 | document.addEventListener('DOMContentLoaded', initTocSpy);
37 | } else {
38 | initTocSpy();
39 | }
40 | window.__ASTRA_INIT_TOC_SPY__ = initTocSpy;
41 | })();
42 |
--------------------------------------------------------------------------------
/js/loader/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "@luna_ui/luna-loader",
3 | "version": "0.1.0",
4 | "description": "Island loader for Luna SSR hydration",
5 | "type": "module",
6 | "main": "./dist/loader.js",
7 | "exports": {
8 | ".": "./dist/loader.js",
9 | "./boot": "./dist/boot/index.js",
10 | "./boot/loader": "./dist/boot/loader.js",
11 | "./boot/router": "./dist/boot/router.js",
12 | "./router": "./dist/router/index.js",
13 | "./router/hybrid": "./dist/router/hybrid.js",
14 | "./router/spa": "./dist/router/spa.js",
15 | "./router/scroll": "./dist/router/scroll.js",
16 | "./wc": "./dist/wc-loader.js",
17 | "./sol-nav": "./dist/sol-nav.js",
18 | "./lib": "./dist/lib.js",
19 | "./src/loader": "./src/loader.ts",
20 | "./src/boot": "./src/boot/index.ts",
21 | "./src/boot/loader": "./src/boot/loader.ts",
22 | "./src/boot/router": "./src/boot/router.ts",
23 | "./src/router": "./src/router/index.ts",
24 | "./src/router/hybrid": "./src/router/hybrid.ts",
25 | "./src/router/spa": "./src/router/spa.ts",
26 | "./src/router/scroll": "./src/router/scroll.ts",
27 | "./src/wc-loader": "./src/wc-loader.ts",
28 | "./src/sol-nav": "./src/sol-nav.ts",
29 | "./src/lib": "./src/lib.ts"
30 | },
31 | "files": [
32 | "dist",
33 | "src"
34 | ],
35 | "scripts": {
36 | "build": "rolldown -c rolldown.config.mjs"
37 | },
38 | "keywords": [
39 | "luna",
40 | "moonbit",
41 | "island",
42 | "ssr",
43 | "hydration",
44 | "web-components"
45 | ],
46 | "author": "mizchi",
47 | "license": "MIT"
48 | }
49 |
--------------------------------------------------------------------------------
/e2e/wc_counter_csr.test.ts:
--------------------------------------------------------------------------------
1 | import { test, expect } from '@playwright/test';
2 |
3 | const DEBUG = process.env.DEBUG === '1';
4 |
5 | test.describe('wc-counter CSR navigation', () => {
6 | test('wc-counter should work after CSR navigation', async ({ page }) => {
7 | // ホームページから開始（baseURLを使用）
8 | await page.goto('/');
9 |
10 | // コンソールログを収集
11 | const logs: string[] = [];
12 | page.on('console', msg => {
13 | logs.push(`[${msg.type()}] ${msg.text()}`);
14 | });
15 |
16 | // ページが読み込まれたことを確認
17 | await expect(page.locator('nav')).toBeVisible();
18 |
19 | // WC Counterリンクをクリック（CSR遷移）
20 | await page.click('a[href="/wc-counter"]');
21 |
22 | // 少し待つ
23 | await page.waitForTimeout(500);
24 |
25 | // URLが変わったことを確認
26 | expect(page.url()).toContain('/wc-counter');
27 |
28 | // wc-counter要素が表示されるか確認
29 | const wcCounter = page.locator('wc-counter');
30 | await expect(wcCounter).toBeVisible({ timeout: 5000 });
31 |
32 | // Shadow DOM内のコンテンツを確認
33 | const countDisplay = wcCounter.locator('.count-display');
34 |
35 | // カウント表示が0であることを確認
36 | await expect(countDisplay).toHaveText('0');
37 |
38 | // インクリメントボタンをクリック
39 | const incButton = wcCounter.locator('.inc');
40 | await incButton.click();
41 |
42 | // カウントが1になることを確認
43 | await expect(countDisplay).toHaveText('1');
44 |
45 | if (DEBUG) {
46 | console.log('Console logs:', logs);
47 | const isHydrated = logs.some(log => log.includes('[wc-counter] Hydrated'));
48 | console.log('Is hydrated:', isHydrated);
49 | }
50 | });
51 | });
52 |
--------------------------------------------------------------------------------
/src/sol/cli/moon.pkg.json:
--------------------------------------------------------------------------------
1 | {
2 | "is-main": true,
3 | "supported-targets": [
4 | "js"
5 | ],
6 | "import": [
7 | "moonbitlang/async",
8 | {
9 | "path": "mizchi/js/web/console",
10 | "alias": "console"
11 | },
12 | {
13 | "path": "mizchi/luna/internal/json_utils",
14 | "alias": "json_utils"
15 | },
16 | {
17 | "path": "mizchi/luna/astra",
18 | "alias": "astra"
19 | },
20 | {
21 | "path": "mizchi/luna/astra/generator",
22 | "alias": "ssg_gen"
23 | },
24 | {
25 | "path": "mizchi/luna/core/ssg",
26 | "alias": "ssg"
27 | },
28 | {
29 | "path": "mizchi/luna/core/env",
30 | "alias": "env"
31 | },
32 | {
33 | "path": "mizchi/luna/platform/js/fs_adapter",
34 | "alias": "fs_adapter"
35 | },
36 | {
37 | "path": "mizchi/js/core",
38 | "alias": "js"
39 | },
40 | {
41 | "path": "mizchi/js/node/process",
42 | "alias": "process"
43 | },
44 | {
45 | "path": "mizchi/js/node/fs",
46 | "alias": "fs"
47 | },
48 | {
49 | "path": "mizchi/js/node/path",
50 | "alias": "path"
51 | },
52 | {
53 | "path": "mizchi/js/node/child_process",
54 | "alias": "child_process"
55 | },
56 | {
57 | "path": "mizchi/js/node/util",
58 | "alias": "util"
59 | },
60 | {
61 | "path": "mizchi/npm_typed/colorette",
62 | "alias": "colorette"
63 | },
64 | {
65 | "path": "mizchi/luna/core/parser",
66 | "alias": "parser"
67 | }
68 | ],
69 | "warn-list": "-27-20"
70 | }
--------------------------------------------------------------------------------
/docs/01_luna/04_tutorial-js/index.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: "Tutorial: JavaScript"
3 | ---
4 |
5 | # JavaScript Tutorial
6 |
7 | Learn Luna UI with JavaScript/TypeScript.
8 |
9 | ## Getting Started
10 |
11 | ```bash
12 | npm install @luna_ui/luna
13 | ```
14 |
15 | ## Introduction
16 |
17 | - [Basics](./introduction_basics/) - Your first reactive component
18 | - [Signals](./introduction_signals/) - Reactive state containers
19 | - [Effects](./introduction_effects/) - Side effects and subscriptions
20 | - [Memos](./introduction_memos/) - Computed/derived values
21 |
22 | ## Reactivity
23 |
24 | - [Batch](./reactivity_batch/) - Batching multiple updates
25 | - [Untrack](./reactivity_untrack/) - Reading without tracking
26 | - [Nested Effects](./reactivity_nested/) - Effect composition
27 |
28 | ## Control Flow
29 |
30 | - [Show](./flow_show/) - Conditional rendering
31 | - [For](./flow_for/) - List rendering
32 | - [Switch](./flow_switch/) - Multi-way branching
33 |
34 | ## Lifecycle
35 |
36 | - [onMount](./lifecycle_onmount/) - Component mount callback
37 | - [onCleanup](./lifecycle_oncleanup/) - Cleanup and disposal
38 |
39 | ## Islands
40 |
41 | - [Basics](./islands_basics/) - Island architecture fundamentals
42 | - [State](./islands_state/) - State management in islands
43 | - [Triggers](./islands_triggers/) - Hydration triggers
44 | - [Web Components](./islands_webcomponents/) - Custom elements integration
45 |
46 | ## See Also
47 |
48 | - [JavaScript API Reference](/luna/api-js/) - API Reference
49 | - [MoonBit Tutorial](/luna/tutorial-moonbit/) - MoonBit version
50 | - [Astra SSG](/astra/) - Static site generation
51 |
--------------------------------------------------------------------------------
/src/astra/README.md:
--------------------------------------------------------------------------------
1 | # Astra
2 |
3 | 静的サイトジェネレーター (SSG)。Markdown → HTML 変換。
4 |
5 | ## 概要
6 |
7 | ドキュメントサイト生成に特化したSSG。
8 | Markdownファイルから多言語対応の静的サイトを生成する。
9 |
10 | ## モジュール構成
11 |
12 | | サブモジュール | 責務 |
13 | |---------------|------|
14 | | `cli/` | CLIエントリポイント |
15 | | `generator/` | HTML生成ロジック |
16 | | `markdown/` | Markdown解析 |
17 | | `routes/` | ルート生成 |
18 | | `shiki/` | シンタックスハイライト (Shiki統合) |
19 | | `config.mbt` | 設定パーサー |
20 | | `types.mbt` | 型定義 |
21 |
22 | ## 設定ファイル (astra.json)
23 |
24 | ```json
25 | {
26 | "docs": "docs",
27 | "output": "dist",
28 | "title": "My Site",
29 | "base": "/",
30 | "trailingSlash": true,
31 | "i18n": {
32 | "defaultLocale": "en",
33 | "locales": [
34 | { "code": "en", "label": "English", "path": "" },
35 | { "code": "ja", "label": "日本語", "path": "ja" }
36 | ]
37 | },
38 | "nav": [...],
39 | "sidebar": "auto"
40 | }
41 | ```
42 |
43 | ## 主要な型
44 |
45 | ### SsgConfig
46 |
47 | ```moonbit
48 | pub struct SsgConfig {
49 | docs_dir : String // ソースディレクトリ
50 | output_dir : String // 出力ディレクトリ
51 | title : String // サイトタイトル
52 | base_url : String // ベースURL
53 | nav : Array[NavItem] // ナビゲーション
54 | sidebar : SidebarConfig // サイドバー設定
55 | i18n : I18nConfig // 多言語設定
56 | // ...
57 | }
58 | ```
59 |
60 | ## 機能
61 |
62 | - Markdownからの静的HTML生成
63 | - 多言語サポート (i18n)
64 | - 自動サイドバー生成
65 | - シンタックスハイライト (Shiki)
66 | - OGP対応
67 |
68 | ## 使用方法
69 |
70 | ```bash
71 | # CLIから実行
72 | moon run src/astra/cli -- build
73 | ```
74 |
75 | ## 参照
76 |
77 | - [Luna Core](../core/README.md) - VNode生成
78 | - [Sol](../sol/README.md) - SSRフレームワーク
79 |
--------------------------------------------------------------------------------
/examples/sol_app/app/__gen__/types/types.mbt:
--------------------------------------------------------------------------------
1 | ///| Auto-generated types for island props
2 | ///| Re-exports Props structs from client packages
3 |
4 | ///| Props type from @client
5 | pub(all) struct CounterProps {
6 | initial_count : Int
7 | } derive(ToJson, FromJson)
8 |
9 | ///| Props type from @client
10 | pub(all) struct ContactFormProps {
11 | action : String
12 | initial_name : String
13 | initial_email : String
14 | } derive(ToJson, FromJson)
15 |
16 | ///| Props type from @client
17 | pub(all) struct WcCounterProps {
18 | initial_count : Int
19 | } derive(ToJson, FromJson)
20 |
21 | // =============================================================================
22 | // ComponentRef Factory Functions
23 | // =============================================================================
24 |
25 | ///|
26 | ///| Create ComponentRef for counter component
27 | pub fn counter(
28 | props : CounterProps,
29 | trigger~ : @luna.Trigger = @luna.Load,
30 | ) -> @luna.ComponentRef[CounterProps] {
31 | { url: "/static/counter.js", props, wc: false, trigger }
32 | }
33 |
34 | ///|
35 | ///| Create ComponentRef for contact_form component
36 | pub fn contact_form(
37 | props : ContactFormProps,
38 | trigger~ : @luna.Trigger = @luna.Load,
39 | ) -> @luna.ComponentRef[ContactFormProps] {
40 | { url: "/static/contact_form.js", props, wc: false, trigger }
41 | }
42 |
43 | ///|
44 | ///| Create ComponentRef for wc_counter component
45 | pub fn wc_counter(
46 | props : WcCounterProps,
47 | trigger~ : @luna.Trigger = @luna.Load,
48 | ) -> @luna.ComponentRef[WcCounterProps] {
49 | { url: "/static/wc_counter.js", props, wc: true, trigger }
50 | }
51 |
52 |
--------------------------------------------------------------------------------
/experiments/view_transition/bar.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
Bar - View Transition Demo
7 |
8 |
9 |
10 |
11 |
17 |
18 |
19 | Bar Page
20 |
21 |
22 |
This is the Bar page.
23 |
Try navigating between pages to see the transition effects.
24 |
27 |
Bar Features
28 |
29 | - Smooth page transitions
30 | - Individual element animations
31 | - Works with browser back/forward
32 |
33 |
46 |
47 |
48 |
--------------------------------------------------------------------------------
/scripts/lib/cov-reporter/parsers/moonbit.ts:
--------------------------------------------------------------------------------
1 | /**
2 | * MoonBit Cobertura coverage parser
3 | */
4 |
5 | import { readFile } from "node:fs/promises";
6 | import { existsSync } from "node:fs";
7 | import { join } from "node:path";
8 | import type { FileCoverage, LineCoverage, CoverageConfig } from "../types.ts";
9 | import { shouldExcludeFile } from "../types.ts";
10 |
11 | export async function parseMoonbitCoverage(
12 | config: CoverageConfig
13 | ): Promise
> {
14 | const coberturaFile = join(config.coverageDir, "moonbit-coverage.xml");
15 | if (!existsSync(coberturaFile)) {
16 | return new Map();
17 | }
18 |
19 | const content = await readFile(coberturaFile, "utf-8");
20 | const files = new Map();
21 |
22 | const classRegex = /]*filename="([^"]+)"[^>]*>([\s\S]*?)<\/class>/g;
23 | let classMatch;
24 |
25 | while ((classMatch = classRegex.exec(content)) !== null) {
26 | const filename = classMatch[1];
27 | const classContent = classMatch[2];
28 |
29 | if (config.include && !config.include.test(filename)) continue;
30 | if (shouldExcludeFile(filename, config)) continue;
31 |
32 | const lines: LineCoverage[] = [];
33 |
34 | const lineRegex = /]*\/>/g;
35 | let lineMatch;
36 | while ((lineMatch = lineRegex.exec(classContent)) !== null) {
37 | lines.push({
38 | line: parseInt(lineMatch[1]),
39 | count: parseInt(lineMatch[2]),
40 | });
41 | }
42 |
43 | if (lines.length > 0) {
44 | files.set(filename, { path: filename, lines });
45 | }
46 | }
47 |
48 | return files;
49 | }
50 |
--------------------------------------------------------------------------------
/experiments/view_transition/foo.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | Foo - View Transition Demo
7 |
8 |
9 |
10 |
11 |
17 |
18 |
19 | Foo Page
20 |
21 |
22 |
This is the Foo page.
23 |
The card and title have view-transition-name, so they animate smoothly.
24 |
27 |
Foo Features
28 |
29 | - Cross-document view transitions
30 | - No JavaScript API call needed for MPA
31 | - CSS @view-transition rule enables it
32 |
33 |
10 | ${name}
11 |
12 | ${count}
13 |
14 |
15 | `;
16 |
17 | const [decBtn, incBtn] = element.querySelectorAll("button");
18 | decBtn.onclick = () => { count--; render(); };
19 | incBtn.onclick = () => { count++; render(); };
20 | };
21 |
22 | render();
23 | }
24 |
25 | export default hydrate;
26 |
--------------------------------------------------------------------------------
/src/platform/server_dom/types.mbt:
--------------------------------------------------------------------------------
1 | // server_dom - Server-side DOM for SSR
2 | //
3 | // This module provides a DOM API for server-side rendering.
4 | // - No event handlers (E = Unit)
5 | // - Document structure elements (html, head, body)
6 | // - Island integration for client components
7 | //
8 |
9 | ///|
10 | /// Render result with HTML and preload URLs
11 | pub struct RenderResult {
12 | html : String
13 | preload_urls : Array[String]
14 | }
15 |
16 | // =============================================================================
17 | // Server Node - Supports both sync and async server components
18 | // =============================================================================
19 |
20 | ///|
21 | /// Server component result type
22 | /// Supports both synchronous and asynchronous server components:
23 | /// - Sync: returns Node[Unit] directly
24 | /// - Async: returns async function that resolves to Node[Unit]
25 | pub enum ServerNode {
26 | Sync(@luna.Node[Unit])
27 | Async(async () -> @luna.Node[Unit])
28 | }
29 |
30 | ///|
31 | /// Create a synchronous ServerNode from a Node
32 | pub fn ServerNode::sync(node : @luna.Node[Unit]) -> ServerNode {
33 | Sync(node)
34 | }
35 |
36 | ///|
37 | /// Create an asynchronous ServerNode from an async function
38 | pub fn ServerNode::async_(render : async () -> @luna.Node[Unit]) -> ServerNode {
39 | Async(render)
40 | }
41 |
42 | ///|
43 | /// Resolve ServerNode to Node (awaits if async)
44 | pub async fn ServerNode::resolve(self : ServerNode) -> @luna.Node[Unit] {
45 | match self {
46 | Sync(node) => node
47 | Async(render) => render()
48 | }
49 | }
50 |
51 | ///|
52 | /// Check if ServerNode is async
53 | pub fn ServerNode::is_async(self : ServerNode) -> Bool {
54 | match self {
55 | Async(_) => true
56 | Sync(_) => false
57 | }
58 | }
59 |
--------------------------------------------------------------------------------
/examples/sol_app/static/loader.js:
--------------------------------------------------------------------------------
1 | import { createLoadedTracker, observeAdditions, onReady, setupTrigger } from "./lib.js";
2 |
3 | //#region js/loader/src/loader.ts
4 | /*! luna loader v1 */
5 | const d = document;
6 | const w = window;
7 | const S = {};
8 | const { loaded, unload, clear } = createLoadedTracker();
9 | const parseState = async (el) => {
10 | const a = el.getAttribute("luna:state");
11 | if (!a) return;
12 | if (a[0] === "#") return JSON.parse(d.getElementById(a.slice(1))?.textContent ?? "null");
13 | try {
14 | return JSON.parse(a);
15 | } catch {}
16 | };
17 | const hydrate = async (el) => {
18 | const id = el.getAttribute("luna:id");
19 | if (!id || loaded.has(id)) return;
20 | loaded.add(id);
21 | const url = el.getAttribute("luna:url");
22 | if (!url) return;
23 | S[id] = await parseState(el);
24 | const mod = await import(url);
25 | const ex = el.getAttribute("luna:export");
26 | (ex ? mod[ex] : mod.hydrate ?? mod.default)?.(el, S[id], id);
27 | };
28 | const setup = (el) => {
29 | setupTrigger(el, el.getAttribute("luna:client-trigger") ?? "load", () => hydrate(el));
30 | };
31 | const scan = () => {
32 | d.querySelectorAll("[luna\\:id]").forEach(setup);
33 | };
34 | d.querySelectorAll("script[type=\"luna/json\"]").forEach((s) => {
35 | if (s.id) S[s.id] = JSON.parse(s.textContent ?? "{}");
36 | });
37 | onReady(scan);
38 | observeAdditions((el) => el.hasAttribute("luna:id"), setup);
39 | const unloadAll = (root = d.body) => {
40 | root.querySelectorAll("[luna\\:id]").forEach((el) => {
41 | const id = el.getAttribute("luna:id");
42 | if (id) loaded.delete(id);
43 | });
44 | };
45 | w.__LUNA_STATE__ = S;
46 | w.__LUNA_HYDRATE__ = hydrate;
47 | w.__LUNA_SCAN__ = scan;
48 | w.__LUNA_UNLOAD__ = unload;
49 | w.__LUNA_UNLOAD_ALL__ = unloadAll;
50 | w.__LUNA_CLEAR_LOADED__ = clear;
51 |
52 | //#endregion
--------------------------------------------------------------------------------
/docs/00_introduction/03_faq/index.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: FAQ
3 | ---
4 |
5 | # Frequently Asked Questions
6 |
7 | ## General
8 |
9 | ### What is Luna?
10 |
11 | Luna is a suite of tools for building modern web applications with MoonBit and JavaScript. It provides:
12 |
13 | - **Luna Core** - Signals, Islands, and fine-grained reactivity
14 | - **Astra** - Static Site Generator for documentation
15 | - **Sol** - Full-stack SSR framework
16 | - **Stella** - Development tools
17 |
18 | ### Why MoonBit?
19 |
20 | MoonBit offers:
21 | - Compile-time type safety (no runtime errors)
22 | - Native speed for SSR (no V8 overhead)
23 | - Guaranteed dead code elimination
24 | - Small, optimized output
25 |
26 | ### Is Luna production-ready?
27 |
28 | Luna is currently experimental. APIs may change. Use in production at your own discretion.
29 |
30 | ## Technical
31 |
32 | ### How does Luna compare to React?
33 |
34 | | Aspect | React | Luna |
35 | |--------|-------|------|
36 | | Update Model | Virtual DOM diffing | Fine-grained signals |
37 | | Hydration | Full page | Partial (islands) |
38 | | Runtime Size | ~42KB | ~3KB |
39 | | Language | JavaScript | MoonBit + JavaScript |
40 |
41 | ### What is Islands Architecture?
42 |
43 | Islands Architecture is a pattern where most of the page is static HTML, with only interactive "islands" loading JavaScript. This results in:
44 |
45 | - Faster initial page load
46 | - Smaller JavaScript bundles
47 | - Better performance on low-end devices
48 |
49 | ### Can I use Luna with existing frameworks?
50 |
51 | Luna is designed as a standalone solution. However, you can embed Luna islands in any HTML page.
52 |
53 | ## Development
54 |
55 | ### How do I report bugs?
56 |
57 | Open an issue on the GitHub repository.
58 |
59 | ### How do I contribute?
60 |
61 | See the contributing guide in the repository.
62 |
--------------------------------------------------------------------------------
/scripts/lib/cov-reporter/types.ts:
--------------------------------------------------------------------------------
1 | /**
2 | * Coverage data types
3 | */
4 |
5 | export interface LineCoverage {
6 | line: number;
7 | count: number;
8 | }
9 |
10 | export interface FileCoverage {
11 | path: string;
12 | lines: LineCoverage[];
13 | source?: string;
14 | }
15 |
16 | export interface CoverageStats {
17 | files: number;
18 | totalLines: number;
19 | coveredLines: number;
20 | rate: number;
21 | }
22 |
23 | export interface DirectoryStats {
24 | covered: number;
25 | total: number;
26 | }
27 |
28 | export interface CoverageConfig {
29 | projectRoot: string;
30 | coverageDir: string;
31 | sourceMapDir: string;
32 | include?: RegExp;
33 | exclude?: RegExp;
34 | /** Additional directories to exclude from coverage reporting */
35 | excludeDirs?: string[];
36 | }
37 |
38 | /**
39 | * Check if a file path should be excluded based on config
40 | */
41 | export function shouldExcludeFile(
42 | filepath: string,
43 | config: CoverageConfig
44 | ): boolean {
45 | // Check regex exclude pattern
46 | if (config.exclude && config.exclude.test(filepath)) {
47 | return true;
48 | }
49 | // Check directory exclusions
50 | if (config.excludeDirs) {
51 | for (const dir of config.excludeDirs) {
52 | if (filepath.startsWith(dir + "/") || filepath === dir) {
53 | return true;
54 | }
55 | }
56 | }
57 | return false;
58 | }
59 |
60 | export function createDefaultConfig(projectRoot: string): CoverageConfig {
61 | return {
62 | projectRoot,
63 | coverageDir: `${projectRoot}/coverage`,
64 | sourceMapDir: `${projectRoot}/target/js/debug/build`,
65 | include: /^src\//,
66 | exclude: /_test\.mbt$/,
67 | // Exclude benchmarks, examples, and test infrastructure
68 | excludeDirs: ["src/_bench", "src/examples", "src/tests"],
69 | };
70 | }
71 |
--------------------------------------------------------------------------------
/demo-src/game/index.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | Luna Benchmark Game
7 |
58 |
59 |
60 |
61 |
62 |
63 |
64 |
--------------------------------------------------------------------------------
/demo-src/wc/index.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 | Luna WC Examples (Web Components)
7 |
21 |
22 |
23 |
24 |
25 |
Luna WC Examples
26 |
A collection of examples demonstrating Web Components with MoonBit.
27 |
28 |
29 |
30 |
31 |
32 |
33 |
34 |
35 |
36 |
37 |
38 |
39 |
40 |
41 |
42 |
43 |
44 |
45 |
46 |
47 |
48 |
49 |
50 |
51 |
52 |
53 |
54 |
Nested Components
55 |
Child components dispatch custom events that bubble through Shadow DOM to parent.
56 |
57 |