npm - @nexa-stack/framework - Versions diffs - 1.0.0 - Mend

@nexa-stack/framework 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (81) hide show

package/.env.example +46 -0
package/LICENSE +21 -0
package/README.md +72 -0
package/bin/nexa.mjs +41 -0
package/bin/nexa.ts +334 -0
package/docs/AI.md +69 -0
package/docs/ARCHITECTURE.md +74 -0
package/docs/EXAMPLES.md +114 -0
package/docs/FRAMEWORK.md +226 -0
package/docs/LANGUAGE.md +39 -0
package/docs/README.md +7 -0
package/docs/READY.md +51 -0
package/docs/REFERENCE.md +255 -0
package/docs/START.md +98 -0
package/docs/advanced.md +97 -0
package/docs/authentication.md +54 -0
package/docs/cli.md +15 -0
package/docs/compare.md +51 -0
package/docs/configuration.md +65 -0
package/docs/database.md +396 -0
package/docs/installation.md +57 -0
package/docs/localization.md +47 -0
package/docs/resources.md +75 -0
package/docs/routing.md +59 -0
package/docs/seeding.md +33 -0
package/docs/services.md +146 -0
package/package.json +77 -0
package/packages/auth/src/auth.test.ts +23 -0
package/packages/auth/src/auth.ts +287 -0
package/packages/auth/src/index.ts +17 -0
package/packages/cache/src/index.ts +203 -0
package/packages/client/src/index.ts +49 -0
package/packages/core/src/app.ts +97 -0
package/packages/core/src/config.ts +55 -0
package/packages/core/src/dev.ts +104 -0
package/packages/core/src/fields.test.ts +81 -0
package/packages/core/src/fields.ts +309 -0
package/packages/core/src/index.ts +60 -0
package/packages/core/src/lang.ts +79 -0
package/packages/core/src/loader.ts +42 -0
package/packages/core/src/migrate.ts +91 -0
package/packages/core/src/policy.ts +36 -0
package/packages/core/src/registry.ts +17 -0
package/packages/core/src/reload.ts +92 -0
package/packages/core/src/resource.test.ts +32 -0
package/packages/core/src/resource.ts +87 -0
package/packages/core/src/routes.ts +22 -0
package/packages/core/src/runtime.ts +11 -0
package/packages/database/src/builder.ts +266 -0
package/packages/database/src/database.ts +252 -0
package/packages/database/src/dialect.ts +186 -0
package/packages/database/src/index.ts +6 -0
package/packages/database/src/mysql.ts +114 -0
package/packages/database/src/postgres.ts +117 -0
package/packages/database/src/query.ts +115 -0
package/packages/database/src/sqlite.ts +216 -0
package/packages/database/src/types.ts +104 -0
package/packages/events/src/index.ts +17 -0
package/packages/export/src/index.ts +36 -0
package/packages/log/src/index.ts +38 -0
package/packages/mail/src/index.ts +130 -0
package/packages/notifications/src/index.ts +84 -0
package/packages/plugins/src/index.ts +39 -0
package/packages/queue/src/index.ts +185 -0
package/packages/queue/src/jobs.ts +9 -0
package/packages/schedule/src/index.ts +64 -0
package/packages/server/src/index.ts +1 -0
package/packages/server/src/middleware.ts +143 -0
package/packages/server/src/query.ts +40 -0
package/packages/server/src/router.ts +813 -0
package/packages/sms/src/index.ts +33 -0
package/packages/storage/src/upload.ts +36 -0
package/packages/testing/src/index.ts +67 -0
package/packages/validation/src/index.ts +1 -0
package/packages/validation/src/validate.test.ts +35 -0
package/packages/validation/src/validate.ts +112 -0
package/public/admin.html +369 -0
package/public/compare.html +66 -0
package/public/dev-bar.js +213 -0
package/public/docs.html +315 -0
package/public/index.html +66 -0

package/public/compare.html ADDED Viewed

@@ -0,0 +1,66 @@
+<!DOCTYPE html>
+<html lang="en" dir="ltr">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>Nexa vs Laravel</title>
+  <link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@400;600;700&family=IBM+Plex+Mono:wght@400&display=swap" rel="stylesheet" />
+  <style>
+    :root { --bg:#f4f1eb; --ink:#161614; --muted:#5e5b54; --nexa:#0f5c4c; --laravel:#c2410c; --panel:#fffcf7; --line:#d9d3c6; }
+    * { box-sizing: border-box; }
+    body { margin:0; font-family:"IBM Plex Sans",system-ui,sans-serif; background:var(--bg); color:var(--ink); padding:2rem 1.25rem 4rem; }
+    .wrap { max-width:820px; margin:0 auto; }
+    a { color:var(--nexa); }
+    .nav { display:flex; gap:.6rem; margin-bottom:1.5rem; flex-wrap:wrap; }
+    .nav a { text-decoration:none; border:1px solid var(--line); background:var(--panel); padding:.35rem .8rem; border-radius:6px; font-size:.88rem; }
+    h1 { font-size:1.8rem; margin:0 0 .5rem; }
+    .lead { color:var(--muted); margin:0 0 2rem; }
+    h2 { font-size:1.1rem; margin:2rem 0 .75rem; }
+    table { width:100%; border-collapse:collapse; background:var(--panel); border:1px solid var(--line); border-radius:10px; overflow:hidden; font-size:.92rem; }
+    th,td { padding:.7rem .85rem; text-align:left; border-bottom:1px solid var(--line); }
+    th { background:#efeae1; }
+    tr:last-child td { border-bottom:none; }
+    code { font-family:"IBM Plex Mono",monospace; font-size:.82em; direction:ltr; display:inline-block; }
+    .n { color:var(--nexa); font-weight:600; }
+    .l { color:var(--laravel); font-weight:600; }
+    pre { background:#1c1c1a; color:#e8e4dc; padding:1rem; border-radius:8px; direction:ltr; text-align:left; overflow:auto; font-size:.85rem; font-family:"IBM Plex Mono",monospace; }
+  </style>
+</head>
+<body>
+  <div class="wrap">
+    <div class="nav">
+      <a href="/docs">Docs</a>
+      <a href="/compare">Compare</a>
+      <a href="/admin">Admin</a>
+    </div>
+    <h1>Nexa vs Laravel — same jobs, less code</h1>
+    <p class="lead">Ship a full backend in hours, not weeks.</p>
+    <h2>Commands</h2>
+    <table>
+      <tr><th>Task</th><th class="l">Laravel</th><th class="n">Nexa</th></tr>
+      <tr><td>Serve</td><td><code>php artisan serve</code></td><td><code>nexa serve</code></td></tr>
+      <tr><td>New table</td><td><code>make:model -mcr</code></td><td><code>resource(...)</code></td></tr>
+      <tr><td>New project</td><td><code>composer create-project</code></td><td><code>nexa new my-app</code></td></tr>
+    </table>
+    <h2>Data definition</h2>
+    <p class="l">Laravel = Migration + Model + Controller + Route</p>
+    <p class="n">Nexa = just this:</p>
+    <pre>resource("posts", {
+  title: string().required(),
+}).admin();</pre>
+    <h2>Services (same idea)</h2>
+    <table>
+      <tr><th></th><th class="l">Laravel</th><th class="n">Nexa</th></tr>
+      <tr><td>Mail</td><td><code>Mail::</code></td><td><code>mail()</code></td></tr>
+      <tr><td>Cache</td><td><code>Cache::</code></td><td><code>cache</code></td></tr>
+      <tr><td>Log</td><td><code>Log::</code></td><td><code>log</code></td></tr>
+      <tr><td>Queue</td><td><code>dispatch()</code></td><td><code>dispatch()</code></td></tr>
+    </table>
+    <p style="margin-top:2rem;color:var(--muted)">Start at <a href="/docs#/START">/docs</a> — full backend in hours.<br/>Admin login: <code>admin@nexa.dev</code> / <code>123456</code></p>
+  </div>
+</body>
+</html>

package/public/dev-bar.js ADDED Viewed

@@ -0,0 +1,213 @@
+(() => {
+  if (window.__NEXA_DEV_BAR__) return;
+  window.__NEXA_DEV_BAR__ = true;
+  const GROUP_COLORS = {
+    resource: "#38bdf8",
+    custom: "#a78bfa",
+    auth: "#fbbf24",
+    notifications: "#34d399",
+    probe: "#94a3b8",
+    dev: "#f472b6",
+    api: "#64748b",
+  };
+  const STATUS_COLORS = (s) =>
+    s >= 500 ? "#f87171" : s >= 400 ? "#fbbf24" : s >= 300 ? "#94a3b8" : "#4ade80";
+  const style = document.createElement("style");
+  style.textContent = `
+    body.nexa-dev-open { padding-bottom: 320px !important; }
+    body.nexa-dev-bar { padding-bottom: 40px !important; }
+    #nexa-dev-bar {
+      position: fixed; left: 0; right: 0; bottom: 0; z-index: 99999;
+      font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+      font-size: 12px; color: #e2e8f0; pointer-events: auto;
+    }
+    #nexa-dev-bar * { box-sizing: border-box; }
+    #nexa-dev-strip {
+      display: flex; align-items: center; gap: 12px; height: 36px;
+      padding: 0 14px; background: #0f172a; border-top: 1px solid #334155;
+      cursor: pointer; user-select: none;
+    }
+    #nexa-dev-strip:hover { background: #1e293b; }
+    #nexa-dev-badge {
+      background: linear-gradient(135deg, #0f5c4c, #2563eb);
+      color: #fff; font-weight: 700; padding: 2px 8px; border-radius: 4px;
+      letter-spacing: 0.04em;
+    }
+    #nexa-dev-meta { display: flex; gap: 14px; flex: 1; flex-wrap: wrap; align-items: center; }
+    #nexa-dev-meta span { color: #94a3b8; }
+    #nexa-dev-meta b { color: #f8fafc; font-weight: 600; }
+    #nexa-dev-last { color: #64748b; max-width: 40vw; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+    #nexa-dev-chevron { color: #64748b; transition: transform .2s; }
+    #nexa-dev-bar.open #nexa-dev-chevron { transform: rotate(180deg); }
+    #nexa-dev-panel {
+      display: none; height: 280px; background: #1e293b; border-top: 1px solid #334155;
+      grid-template-columns: 1fr 1fr; gap: 0;
+    }
+    #nexa-dev-bar.open #nexa-dev-panel { display: grid; }
+    .nexa-dev-col { overflow: hidden; display: flex; flex-direction: column; border-left: 1px solid #334155; }
+    .nexa-dev-col:first-child { border-left: none; }
+    .nexa-dev-col h3 {
+      margin: 0; padding: 8px 12px; font-size: 11px; text-transform: uppercase;
+      letter-spacing: 0.08em; color: #64748b; background: #0f172a;
+    }
+    .nexa-dev-scroll { overflow: auto; flex: 1; padding: 6px 0; }
+    .nexa-dev-row {
+      display: flex; align-items: center; gap: 8px; padding: 4px 12px;
+      border-bottom: 1px solid #33415522;
+    }
+    .nexa-dev-row:hover { background: #33415544; }
+    .nexa-dev-method {
+      min-width: 44px; font-weight: 700; font-size: 10px;
+    }
+    .nexa-dev-path { flex: 1; color: #cbd5e1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+    .nexa-dev-tag {
+      font-size: 9px; padding: 1px 5px; border-radius: 3px; text-transform: uppercase;
+      background: #334155; color: #94a3b8;
+    }
+    .nexa-dev-ms { color: #64748b; min-width: 36px; text-align: left; }
+    .nexa-dev-status { min-width: 28px; font-weight: 700; text-align: center; }
+    #nexa-dev-reload-ok { color: #4ade80; }
+    #nexa-dev-reload-err { color: #f87171; }
+    #nexa-dev-links a { color: #38bdf8; text-decoration: none; margin-left: 8px; }
+    #nexa-dev-links a:hover { text-decoration: underline; }
+  `;
+  document.head.appendChild(style);
+  document.body.classList.add("nexa-dev-bar");
+  const root = document.createElement("div");
+  root.id = "nexa-dev-bar";
+  root.innerHTML = `
+    <div id="nexa-dev-panel">
+      <div class="nexa-dev-col">
+        <h3>Routes</h3>
+        <div class="nexa-dev-scroll" id="nexa-dev-routes"></div>
+      </div>
+      <div class="nexa-dev-col">
+        <h3>Recent requests</h3>
+        <div class="nexa-dev-scroll" id="nexa-dev-requests"></div>
+      </div>
+    </div>
+    <div id="nexa-dev-strip">
+      <span id="nexa-dev-badge">NEXA</span>
+      <div id="nexa-dev-meta"></div>
+      <span id="nexa-dev-last"></span>
+      <span id="nexa-dev-links">
+        <a href="/api/dev/routes" target="_blank" rel="noopener" onclick="event.stopPropagation()">JSON</a>
+        <a href="/api" target="_blank" rel="noopener" onclick="event.stopPropagation()">/api</a>
+      </span>
+      <span id="nexa-dev-chevron">▲</span>
+    </div>
+  `;
+  document.body.appendChild(root);
+  const meta = document.getElementById("nexa-dev-meta");
+  const lastEl = document.getElementById("nexa-dev-last");
+  const routesListEl = document.getElementById("nexa-dev-routes");
+  const requestsEl = document.getElementById("nexa-dev-requests");
+  let routesLoaded = false;
+  let open = false;
+  root.querySelector("#nexa-dev-strip").addEventListener("click", () => {
+    open = !open;
+    root.classList.toggle("open", open);
+    document.body.classList.toggle("nexa-dev-open", open);
+    document.body.classList.toggle("nexa-dev-bar", !open);
+    if (open && !routesLoaded) loadRoutes();
+  });
+  function renderRoutes(routes) {
+    routesListEl.innerHTML = routes
+      .map((r) => {
+        const color = GROUP_COLORS[r.group] || GROUP_COLORS.api;
+        return `<div class="nexa-dev-row">
+          <span class="nexa-dev-method" style="color:${color}">${r.method}</span>
+          <span class="nexa-dev-path" title="${r.path}">${r.path}</span>
+          <span class="nexa-dev-tag" style="color:${color}">${r.group}</span>
+        </div>`;
+      })
+      .join("");
+  }
+  function renderRequests(requests) {
+    if (!requests?.length) {
+      requestsEl.innerHTML = `<div class="nexa-dev-row"><span class="nexa-dev-path">No requests yet — use the app.</span></div>`;
+      return;
+    }
+    requestsEl.innerHTML = requests
+      .map((r) => {
+        const sc = STATUS_COLORS(r.status);
+        return `<div class="nexa-dev-row">
+          <span class="nexa-dev-method" style="color:${sc}">${r.method}</span>
+          <span class="nexa-dev-path" title="${r.path}">${r.path}</span>
+          <span class="nexa-dev-status" style="color:${sc}">${r.status}</span>
+          <span class="nexa-dev-ms">${r.ms}ms</span>
+        </div>`;
+      })
+      .join("");
+  }
+  function renderStatus(d) {
+    const reload = d.last_reload_at
+      ? d.last_reload_error
+        ? `<span id="nexa-dev-reload-err">reload failed</span>`
+        : `<span id="nexa-dev-reload-ok">reload ${timeAgo(d.last_reload_at)}</span>`
+      : `<span>no reload yet</span>`;
+    meta.innerHTML = `
+      <span>port <b>${d.port}</b></span>
+      <span><b>${d.resources}</b> resources</span>
+      <span><b>${d.routes}</b> routes</span>
+      <span>hot reload <b>${d.hot_reload ? "ON" : "OFF"}</b></span>
+      <span>${reload}</span>
+    `;
+    const last = d.recent_requests?.[0];
+    lastEl.textContent = last
+      ? `${last.method} ${last.path} → ${last.status} (${last.ms}ms)`
+      : "waiting for requests…";
+    renderRequests(d.recent_requests);
+  }
+  function timeAgo(iso) {
+    const sec = Math.round((Date.now() - new Date(iso).getTime()) / 1000);
+    if (sec < 5) return "just now";
+    if (sec < 60) return `${sec}s ago`;
+    return `${Math.round(sec / 60)}m ago`;
+  }
+  async function loadRoutes() {
+    try {
+      const res = await fetch("/api/dev/routes");
+      if (!res.ok) return;
+      const { data } = await res.json();
+      renderRoutes(data.routes || []);
+      routesLoaded = true;
+    } catch {
+      routesListEl.innerHTML = `<div class="nexa-dev-row"><span class="nexa-dev-path">Could not load routes.</span></div>`;
+    }
+  }
+  async function poll() {
+    try {
+      const res = await fetch("/api/dev/status");
+      if (res.status === 404) {
+        root.remove();
+        document.body.classList.remove("nexa-dev-bar", "nexa-dev-open");
+        return;
+      }
+      if (!res.ok) return;
+      const { data } = await res.json();
+      renderStatus(data);
+    } catch {
+      /* server starting */
+    }
+  }
+  poll();
+  setInterval(poll, 2500);
+})();

package/public/docs.html ADDED Viewed

@@ -0,0 +1,315 @@
+<!DOCTYPE html>
+<html lang="en" dir="ltr">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>Nexa Docs</title>
+  <link rel="preconnect" href="https://fonts.googleapis.com" />
+  <link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@400;500;600;700&family=IBM+Plex+Mono:wght@400;500&display=swap" rel="stylesheet" />
+  <style>
+    :root {
+      --bg: #f6f3ee;
+      --ink: #1a1a18;
+      --muted: #5c5a55;
+      --line: #ddd8ce;
+      --panel: #fffdf9;
+      --accent: #0f5c4c;
+      --code-bg: #1e1e1c;
+      --code-fg: #e8e4dc;
+    }
+    * { box-sizing: border-box; }
+    body {
+      margin: 0;
+      font-family: "IBM Plex Sans", system-ui, sans-serif;
+      background:
+        radial-gradient(ellipse 80% 50% at 10% -10%, #dfece7 0%, transparent 55%),
+        var(--bg);
+      color: var(--ink);
+      min-height: 100vh;
+    }
+    .layout {
+      display: grid;
+      grid-template-columns: 260px 1fr;
+      min-height: 100vh;
+    }
+    aside {
+      border-right: 1px solid var(--line);
+      background: var(--panel);
+      padding: 1.5rem 1rem 2rem;
+      position: sticky;
+      top: 0;
+      height: 100vh;
+      overflow: auto;
+    }
+    .brand {
+      font-size: 1.35rem;
+      font-weight: 700;
+      color: var(--accent);
+      text-decoration: none;
+      display: block;
+      margin-bottom: 0.25rem;
+    }
+    .brand-sub {
+      font-size: 0.8rem;
+      color: var(--muted);
+      margin-bottom: 1.5rem;
+    }
+    nav a {
+      display: block;
+      padding: 0.45rem 0.7rem;
+      border-radius: 6px;
+      color: var(--ink);
+      text-decoration: none;
+      font-size: 0.92rem;
+      margin-bottom: 2px;
+    }
+    nav a:hover { background: #efeae2; }
+    nav a.active {
+      background: var(--accent);
+      color: #fff;
+      font-weight: 600;
+    }
+    nav .group {
+      font-size: 0.7rem;
+      text-transform: uppercase;
+      letter-spacing: 0.06em;
+      color: var(--muted);
+      margin: 1rem 0.7rem 0.35rem;
+      font-weight: 600;
+    }
+    main {
+      padding: 2rem 2.5rem 4rem;
+      max-width: 820px;
+    }
+    .top {
+      display: flex;
+      gap: 0.75rem;
+      align-items: center;
+      margin-bottom: 1.5rem;
+      flex-wrap: wrap;
+    }
+    .top a.btn {
+      font-size: 0.85rem;
+      color: var(--accent);
+      text-decoration: none;
+      border: 1px solid var(--line);
+      padding: 0.35rem 0.75rem;
+      border-radius: 6px;
+      background: var(--panel);
+    }
+    article h1 { font-size: 1.85rem; margin: 0 0 1rem; line-height: 1.3; }
+    article h2 { font-size: 1.25rem; margin: 2rem 0 0.75rem; border-bottom: 1px solid var(--line); padding-bottom: 0.35rem; }
+    article h3 { font-size: 1.05rem; margin: 1.4rem 0 0.5rem; }
+    article p, article li { line-height: 1.7; color: var(--ink); }
+    article p { margin: 0.65rem 0; }
+    article a { color: var(--accent); }
+    article code {
+      font-family: "IBM Plex Mono", ui-monospace, monospace;
+      font-size: 0.86em;
+      background: #efeae2;
+      padding: 0.1em 0.35em;
+      border-radius: 4px;
+    }
+    article pre {
+      background: var(--code-bg);
+      color: var(--code-fg);
+      padding: 1rem 1.1rem;
+      border-radius: 8px;
+      overflow: auto;
+      font-size: 0.84rem;
+      line-height: 1.55;
+      direction: ltr;
+      text-align: left;
+    }
+    article pre code { background: none; padding: 0; color: inherit; }
+    article table {
+      width: 100%;
+      border-collapse: collapse;
+      margin: 1rem 0;
+      font-size: 0.92rem;
+    }
+    article th, article td {
+      border: 1px solid var(--line);
+      padding: 0.5rem 0.65rem;
+      text-align: left;
+    }
+    article th { background: #efeae2; }
+    article blockquote {
+      margin: 1rem 0;
+      padding: 0.6rem 1rem;
+      border-left: 3px solid var(--accent);
+      background: #e8f2ef;
+      color: var(--muted);
+    }
+    .loading, .error { color: var(--muted); padding: 2rem 0; }
+    @media (max-width: 800px) {
+      .layout { grid-template-columns: 1fr; }
+      aside {
+        position: relative;
+        height: auto;
+        border-left: none;
+        border-bottom: 1px solid var(--line);
+      }
+      main { padding: 1.25rem; }
+    }
+  </style>
+</head>
+<body>
+  <div class="layout">
+    <aside>
+      <a class="brand" href="/docs">Nexa</a>
+      <div class="brand-sub">Docs · v1.0.0</div>
+      <nav id="nav"></nav>
+    </aside>
+    <main>
+      <div class="top">
+        <a class="btn" href="/admin">Admin</a>
+        <a class="btn" href="/compare">Why Nexa?</a>
+        <a class="btn" href="/api" target="_blank">API</a>
+      </div>
+      <article id="content" class="loading">Loading…</article>
+    </main>
+  </div>
+  <script>
+    const CHAPTERS = [
+      { group: "Start here", items: [
+        { id: "START", title: "★ Quick start" },
+        { id: "REFERENCE", title: "★ API reference" },
+        { id: "compare", title: "Why Nexa?" },
+      ]},
+      { group: "Guides", items: [
+        { id: "resources", title: "Resources" },
+        { id: "authentication", title: "Authentication" },
+        { id: "database", title: "Database" },
+        { id: "services", title: "Services" },
+        { id: "advanced", title: "Advanced" },
+        { id: "cli", title: "CLI" },
+      ]},
+      { group: "Reference", items: [
+        { id: "FRAMEWORK", title: "Framework reference" },
+        { id: "READY", title: "Ready checklist" },
+      ]},
+    ];
+    function slugFromHash() {
+      const h = location.hash.replace(/^#\/?/, "") || "START";
+      return h.replace(/\.md$/, "");
+    }
+    function renderNav(active) {
+      const nav = document.getElementById("nav");
+      nav.innerHTML = CHAPTERS.map((g) => {
+        const links = g.items.map((i) =>
+          `<a href="#/${i.id}" class="${i.id === active ? "active" : ""}">${i.title}</a>`
+        ).join("");
+        return `<div class="group">${g.group}</div>${links}`;
+      }).join("");
+    }
+    function escapeHtml(s) {
+      return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+    }
+    function mdToHtml(md) {
+      const lines = md.replace(/\r\n/g, "\n").split("\n");
+      let html = "";
+      let inCode = false;
+      let codeLang = "";
+      let codeBuf = [];
+      let inTable = false;
+      let tableRows = [];
+      let inList = false;
+      function flushList() {
+        if (inList) { html += "</ul>"; inList = false; }
+      }
+      function flushTable() {
+        if (!inTable) return;
+        const rows = tableRows.filter((r) => !/^\s*\|?\s*-+/.test(r));
+        html += "<table>";
+        rows.forEach((row, idx) => {
+          const cells = row.replace(/^\|/, "").replace(/\|$/, "").split("|").map((c) => c.trim());
+          const tag = idx === 0 ? "th" : "td";
+          html += "<tr>" + cells.map((c) => `<${tag}>${inline(c)}</${tag}>`).join("") + "</tr>";
+        });
+        html += "</table>";
+        inTable = false;
+        tableRows = [];
+      }
+      function inline(t) {
+        return escapeHtml(t)
+          .replace(/`([^`]+)`/g, "<code>$1</code>")
+          .replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>")
+          .replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2">$1</a>');
+      }
+      for (const line of lines) {
+        if (line.startsWith("```")) {
+          flushList(); flushTable();
+          if (!inCode) {
+            inCode = true;
+            codeLang = line.slice(3).trim();
+            codeBuf = [];
+          } else {
+            html += `<pre><code>${escapeHtml(codeBuf.join("\n"))}</code></pre>`;
+            inCode = false;
+          }
+          continue;
+        }
+        if (inCode) { codeBuf.push(line); continue; }
+        if (line.trim().startsWith("|")) {
+          flushList();
+          inTable = true;
+          tableRows.push(line);
+          continue;
+        } else {
+          flushTable();
+        }
+        if (/^### /.test(line)) { flushList(); html += `<h3>${inline(line.slice(4))}</h3>`; continue; }
+        if (/^## /.test(line)) { flushList(); html += `<h2>${inline(line.slice(3))}</h2>`; continue; }
+        if (/^# /.test(line)) { flushList(); html += `<h1>${inline(line.slice(2))}</h1>`; continue; }
+        if (/^[-*] /.test(line)) {
+          if (!inList) { html += "<ul>"; inList = true; }
+          html += `<li>${inline(line.slice(2))}</li>`;
+          continue;
+        }
+        if (/^\d+\. /.test(line)) {
+          flushList();
+          html += `<p>${inline(line)}</p>`;
+          continue;
+        }
+        if (line.trim() === "") { flushList(); continue; }
+        flushList();
+        html += `<p>${inline(line)}</p>`;
+      }
+      flushList(); flushTable();
+      if (inCode) html += `<pre><code>${escapeHtml(codeBuf.join("\n"))}</code></pre>`;
+      return html;
+    }
+    async function load(id) {
+      renderNav(id);
+      const el = document.getElementById("content");
+      el.className = "loading";
+      el.textContent = "Loading…";
+      try {
+        const res = await fetch(`/api/docs/${id}`);
+        if (!res.ok) throw new Error("not found");
+        const data = await res.json();
+        el.className = "";
+        el.innerHTML = mdToHtml(data.content);
+        document.title = `${data.title || id} · Nexa Docs`;
+      } catch {
+        el.className = "error";
+        el.textContent = "Page not found.";
+      }
+    }
+    window.addEventListener("hashchange", () => load(slugFromHash()));
+    load(slugFromHash());
+  </script>
+</body>
+</html>

package/public/index.html ADDED Viewed

@@ -0,0 +1,66 @@
+<!DOCTYPE html>
+<html lang="en" dir="ltr">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>Nexa</title>
+  <link rel="preconnect" href="https://fonts.googleapis.com" />
+  <link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:wght@400;600;700&family=IBM+Plex+Mono:wght@400;500&display=swap" rel="stylesheet" />
+  <style>
+    :root {
+      --ink: #121410;
+      --muted: #5a5f56;
+      --panel: rgba(255, 252, 247, 0.88);
+      --line: rgba(18, 20, 16, 0.12);
+      --accent: #0d5c4c;
+    }
+    * { box-sizing: border-box; margin: 0; padding: 0; }
+    body {
+      min-height: 100vh;
+      font-family: "IBM Plex Sans", system-ui, sans-serif;
+      color: var(--ink);
+      background:
+        radial-gradient(ellipse 80% 60% at 10% 20%, rgba(13, 92, 76, 0.18), transparent 55%),
+        linear-gradient(165deg, #f3efe6 0%, #e7efe9 45%, #f6f1ea 100%);
+      display: grid;
+      place-items: center;
+      padding: 2rem 1.25rem;
+    }
+    .shell {
+      width: min(720px, 100%);
+      background: var(--panel);
+      border: 1px solid var(--line);
+      border-radius: 20px;
+      padding: clamp(1.75rem, 4vw, 2.75rem);
+    }
+    .brand { font-size: clamp(2rem, 5vw, 2.75rem); font-weight: 700; color: var(--accent); }
+    h1 { font-size: 1.35rem; margin: 1rem 0 0.5rem; font-weight: 600; }
+    p { color: var(--muted); line-height: 1.6; margin-bottom: 1.25rem; }
+    .actions { display: flex; flex-wrap: wrap; gap: 0.75rem; }
+    a.btn {
+      display: inline-block; padding: 0.7rem 1.1rem; border-radius: 10px;
+      text-decoration: none; font-weight: 600; font-size: 0.95rem;
+    }
+    a.btn.primary { background: var(--accent); color: #fff; }
+    a.btn.ghost { border: 1px solid var(--line); color: var(--ink); }
+    code { font-family: "IBM Plex Mono", monospace; font-size: 0.85em; background: #efeae2; padding: 0.1em 0.35em; border-radius: 4px; }
+  </style>
+</head>
+<body>
+  <div class="shell">
+    <div class="brand">Nexa</div>
+    <h1>Backend framework for Node.js</h1>
+    <p>
+      Define a <code>resource</code> and get a database table, REST API, auth, and admin panel.
+      Default language is English — set <code>APP_LOCALE=ar</code> for Arabic UI.
+    </p>
+    <div class="actions">
+      <a class="btn primary" href="/admin">Admin</a>
+      <a class="btn ghost" href="/docs">Docs</a>
+    </div>
+    <p style="margin-top:1.5rem;font-size:0.85rem">
+      Default login: <code>admin@nexa.dev</code> / <code>123456</code>
+    </p>
+  </div>
+</body>
+</html>