@luna_ui/astra 0.2.7 → 0.17.0

package/README.md

@@ -0,0 +1,52 @@
+# @luna_ui/astra
+
+CLI wrapper for **Astra**, the SSG / static-export companion for
+[Sol](../sol/).
+
+This package ships the `astra` command. The MoonBit-side library lives
+in the same repository under `astra/`.
+
+## Install
+
+The **primary** install path is `moon install`; it drops a real binary
+into `$MOON_HOME/bin/`:
+
+```sh
+moon install mizchi/astra/cmd/astra
+```
+
+This npm package is a **secondary** distribution channel for users who
+already have node but not moon:
+
+```sh
+pnpm add -g @luna_ui/astra
+# or
+npm i -g @luna_ui/astra
+```
+
+Either one exposes the same `astra` command with the same surface.
+
+## Usage
+
+```sh
+astra --help
+astra build             # crawl a Sol app and dump every URL to disk
+astra dev               # serve the same crawl at runtime for parity testing
+```
+
+Run `astra <command> --help` for command-specific options.
+
+## What is Astra?
+
+Astra is mountable Mars middleware for static site generation. Point
+it at a Sol-compatible Hono app, declare which routes you want
+materialised, and Astra will walk and snapshot them — verifying that
+build-output and runtime-served HTML stay byte-for-byte identical
+(see `astra/e2e/build_dev_parity.test.js`).
+
+For library use in MoonBit, depend on `mizchi/astra`. For CLI-only
+usage, `moon install mizchi/astra/cmd/astra` is the smaller install.
+
+## License
+
+MIT

package/bin/astra.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+// Workspace dev shim. js/astra/bin/astra.js -> three levels up to
+// workspace root, then into _build/js/release/build/mizchi/astra/cmd/astra/astra.js.
+//
+// Primary install path is `moon install mizchi/astra/cmd/astra`; this
+// npm wrapper exists for users who already have node but not moon.
+// Published npm builds bundle the moonbit CLI output into ./dist/ via
+// js/astra/scripts/build-release.mjs (TODO).
+import "../../../_build/js/release/build/mizchi/astra/cmd/astra/astra.js";

package/package.json

@@ -1,49 +1,24 @@
 {
   "name": "@luna_ui/astra",
-  "version": "0.2.7",
+  "version": "0.17.0",
+  "private": false,
   "type": "module",
-  "description": "MoonBit Island Architecture SSG Framework",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
-  },
   "bin": {
-    "astra": "./bin/astra.mjs"
-  },
-  "scripts": {
-    "prepublishOnly": "pnpm build",
-    "build": "tsdown"
+    "astra": "./bin/astra.js"
   },
+  "main": "./bin/astra.js",
   "files": [
-    "bin",
-    "dist",
-    "assets"
+    "bin/",
+    "README.md"
   ],
-  "keywords": [
-    "luna",
-    "moonbit",
-    "island",
-    "ssg",
-    "astra"
-  ],
-  "author": "mizchi",
+  "description": "Astra — SSG / static-export companion for Sol (CLI wrapper)",
   "license": "MIT",
   "repository": {
-    "directory": "js/astra",
-    "url": "https://github.com/mizchi/luna.mbt"
-  },
-  "dependencies": {
-    "@hono/node-server": "^1.14.0",
-    "colorette": "^2.0.20",
-    "gray-matter": "^4.0.3",
-    "hono": "^4.7.0",
-    "marked": "^15.0.0"
+    "type": "git",
+    "url": "git+https://github.com/mizchi/luna.mbt.git",
+    "directory": "js/astra"
   },
-  "devDependencies": {
-    "tsdown": "^0.18.2"
+  "publishConfig": {
+    "access": "public"
   }
 }

package/assets/scripts/loader.js

@@ -1 +0,0 @@
-(function(){function setupTrigger(e,t,n){if(t==="load")document.readyState==="loading"?document.addEventListener("DOMContentLoaded",()=>n(),{once:true}):n();else if(t==="idle")requestIdleCallback(()=>n());else if(t[0]==="v")new IntersectionObserver((r,o)=>{r.some(i=>i.isIntersecting)&&(o.disconnect(),n())},{rootMargin:"50px"}).observe(e);else if(t[0]==="m"){const r=matchMedia(t.slice(6)),o=()=>{r.matches&&(r.removeEventListener("change",o),n())};r.matches?n():r.addEventListener("change",o)}}function onReady(e){document.readyState==="loading"?document.addEventListener("DOMContentLoaded",e,{once:true}):e()}function observeAdditions(e,t){new MutationObserver(n=>n.forEach(r=>r.addedNodes.forEach(o=>{o.nodeType===1&&e(o)&&t(o)}))).observe(document.body??document.documentElement,{childList:true,subtree:true})}function createLoadedTracker(){const e=new Set;return{loaded:e,unload:t=>e.delete(t),clear:()=>e.clear()}}const d=document,w=window,S={},{loaded,unload,clear}=createLoadedTracker(),parseState=async e=>{const t=e.getAttribute("luna:state");if(t){if(t[0]==="#")return JSON.parse(d.getElementById(t.slice(1))?.textContent??"null");try{return JSON.parse(t)}catch{}}},hydrate=async e=>{const t=e.getAttribute("luna:id");if(!t||loaded.has(t))return;loaded.add(t);const n=e.getAttribute("luna:url");if(!n)return;S[t]=await parseState(e);const r=await import(n),o=e.getAttribute("luna:export");(o?r[o]:r.hydrate??r.default)?.(e,S[t],t)},setup=e=>{setupTrigger(e,e.getAttribute("luna:client-trigger")??"load",()=>hydrate(e))},scan=()=>{d.querySelectorAll("[luna\\:id]").forEach(setup)};d.querySelectorAll('script[type="luna/json"]').forEach(e=>{e.id&&(S[e.id]=JSON.parse(e.textContent??"{}"))});onReady(scan);observeAdditions(e=>e.hasAttribute("luna:id"),setup);const unloadAll=(e=d.body)=>{e.querySelectorAll("[luna\\:id]").forEach(t=>{const n=t.getAttribute("luna:id");n&&loaded.delete(n)})};w.__LUNA_STATE__=S;w.__LUNA_HYDRATE__=hydrate;w.__LUNA_SCAN__=scan;w.__LUNA_UNLOAD__=unload;w.__LUNA_UNLOAD_ALL__=unloadAll;w.__LUNA_CLEAR_LOADED__=clear})();

package/assets/scripts/sidebar.js

@@ -1,29 +0,0 @@
-(function(){
-  var STORAGE_KEY = 'astra-sidebar-state';
-  function loadState() {
-    try { return JSON.parse(localStorage.getItem(STORAGE_KEY)) || {}; } catch { return {}; }
-  }
-  function saveState(state) {
-    try { localStorage.setItem(STORAGE_KEY, JSON.stringify(state)); } catch {}
-  }
-  function initSidebar() {
-    var state = loadState();
-    document.querySelectorAll('[data-sidebar-group]').forEach(function(el) {
-      var key = el.dataset.sidebarGroup;
-      if (key && state[key] !== undefined) {
-        el.open = state[key];
-      }
-      el.addEventListener('toggle', function() {
-        var s = loadState();
-        s[key] = el.open;
-        saveState(s);
-      });
-    });
-  }
-  if (document.readyState === 'loading') {
-    document.addEventListener('DOMContentLoaded', initSidebar);
-  } else {
-    initSidebar();
-  }
-  window.__ASTRA_INIT_SIDEBAR__ = initSidebar;
-})();

package/assets/scripts/theme.js

@@ -1,25 +0,0 @@
-(function(){
-  var theme = localStorage.getItem('theme');
-  var prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
-  var isDark = theme === 'dark' || (theme !== 'light' && prefersDark);
-  if (isDark) {
-    document.documentElement.classList.add('dark');
-    document.documentElement.classList.remove('light');
-  } else {
-    document.documentElement.classList.add('light');
-    document.documentElement.classList.remove('dark');
-  }
-  window.toggleTheme = function() {
-    var html = document.documentElement;
-    var wasDark = html.classList.contains('dark');
-    if (wasDark) {
-      html.classList.remove('dark');
-      html.classList.add('light');
-      localStorage.setItem('theme', 'light');
-    } else {
-      html.classList.add('dark');
-      html.classList.remove('light');
-      localStorage.setItem('theme', 'dark');
-    }
-  };
-})();

package/assets/scripts/toc.js

@@ -1,41 +0,0 @@
-(function(){
-  var observer = null;
-  var tocLinks = [];
-  var headings = [];
-  function initTocSpy() {
-    if (observer) observer.disconnect();
-    tocLinks = Array.from(document.querySelectorAll('.toc-item a'));
-    headings = tocLinks.map(function(link) {
-      var id = link.getAttribute('href')?.slice(1);
-      return id ? document.getElementById(id) : null;
-    }).filter(Boolean);
-    if (!headings.length) return;
-    var current = null;
-    observer = new IntersectionObserver(function(entries) {
-      entries.forEach(function(entry) {
-        if (entry.isIntersecting) current = entry.target;
-      });
-      if (!current) {
-        var scrollY = window.scrollY + 100;
-        for (var i = headings.length - 1; i >= 0; i--) {
-          if (headings[i].offsetTop <= scrollY) { current = headings[i]; break; }
-        }
-      }
-      tocLinks.forEach(function(link) {
-        var id = link.getAttribute('href')?.slice(1);
-        if (current && id === current.id) {
-          link.classList.add('active');
-        } else {
-          link.classList.remove('active');
-        }
-      });
-    }, { rootMargin: '-60px 0px -70% 0px', threshold: 0 });
-    headings.forEach(function(h) { observer.observe(h); });
-  }
-  if (document.readyState === 'loading') {
-    document.addEventListener('DOMContentLoaded', initTocSpy);
-  } else {
-    initTocSpy();
-  }
-  window.__ASTRA_INIT_TOC_SPY__ = initTocSpy;
-})();

package/assets/scripts/wc-loader.js

@@ -1,28 +0,0 @@
-(function(){
-  function setupTrigger(el, t, cb) {
-    if (t === 'load') document.readyState === 'loading' ? document.addEventListener('DOMContentLoaded', cb, {once:true}) : cb();
-    else if (t === 'idle') requestIdleCallback(cb);
-    else if (t[0] === 'v') new IntersectionObserver((e,o) => { if(e.some(x=>x.isIntersecting)){o.disconnect();cb();}}, {rootMargin:'50px'}).observe(el);
-    else if (t[0] === 'm') { var mq = matchMedia(t.slice(6)); var h = () => { if(mq.matches){mq.removeEventListener('change',h);cb();}}; mq.matches ? cb() : mq.addEventListener('change',h);}
-  }
-  var loaded = new Set();
-  async function hydrate(el) {
-    var name = el.tagName.toLowerCase();
-    if (loaded.has(name)) return;
-    var url = el.getAttribute('luna:wc-url');
-    if (!url) return;
-    loaded.add(name);
-    try {
-      var mod = await import(url);
-      var fn = mod.hydrate || mod.default;
-      if (typeof fn === 'function') fn(el, {}, name);
-    } catch(e) { console.error('[wc] Failed:', name, e); }
-  }
-  function setup(el) { setupTrigger(el, el.getAttribute('luna:wc-trigger') || 'load', () => hydrate(el)); }
-  function scan() { document.querySelectorAll('[luna\\:wc-url]').forEach(setup); }
-  if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', scan, {once:true});
-  else scan();
-  new MutationObserver(m => m.forEach(x => x.addedNodes.forEach(n => { if(n.nodeType === 1 && n.hasAttribute('luna:wc-url')) setup(n); }))).observe(document.body || document.documentElement, {childList:true,subtree:true});
-  window.__LUNA_WC_SCAN__ = scan;
-  window.__LUNA_WC_CLEAR_LOADED__ = () => loaded.clear();
-})();