elegance-js 1.0.0

package/dist/server/server.mjs

@@ -0,0 +1,184 @@
+// src/server/server.ts
+import { createServer as createHttpServer } from "http";
+import { promises as fs } from "fs";
+import { join, normalize, extname, dirname } from "path";
+import { pathToFileURL } from "url";
+var MIME_TYPES = {
+  ".html": "text/html; charset=utf-8",
+  ".css": "text/css; charset=utf-8",
+  ".js": "application/javascript; charset=utf-8",
+  ".json": "application/json; charset=utf-8",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".svg": "image/svg+xml",
+  ".ico": "image/x-icon",
+  ".txt": "text/plain; charset=utf-8"
+};
+function startServer({ root, port = 3e3, host = "0.0.0.0", environment = "production" }) {
+  if (!root) throw new Error("Root directory must be specified.");
+  const requestHandler = async (req, res) => {
+    try {
+      if (!req.url) {
+        res.writeHead(400, { "Content-Type": "text/plain; charset=utf-8" });
+        res.end("Bad Request");
+        return;
+      }
+      res.setHeader("Access-Control-Allow-Origin", "*");
+      res.setHeader("Access-Control-Allow-Methods", "GET,POST,PUT,DELETE,OPTIONS");
+      res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization");
+      if (req.method === "OPTIONS") {
+        res.writeHead(204);
+        res.end();
+        if (environment === "development") {
+          console.log(req.method, "::", req.url, "-", res.statusCode);
+        }
+        return;
+      }
+      const url = new URL(req.url, `https://${req.headers.host}`);
+      if (url.pathname.startsWith("/api/")) {
+        await handleApiRequest(root, url.pathname, req, res);
+      } else {
+        await handleStaticRequest(root, url.pathname, res);
+      }
+      if (environment === "development") {
+        console.log(req.method, "::", req.url, "-", res.statusCode);
+      }
+    } catch (err) {
+      console.error(err);
+      res.writeHead(500, { "Content-Type": "text/plain; charset=utf-8" });
+      res.end("Internal Server Error");
+    }
+  };
+  let server = createHttpServer(requestHandler);
+  server.listen(port, host, () => {
+    console.log(`Server running at https://${host}:${port}/`);
+  });
+  return server;
+}
+async function handleStaticRequest(root, pathname, res) {
+  let filePath = normalize(join(root, decodeURIComponent(pathname)));
+  root = normalize(root);
+  if (!filePath.startsWith(root)) {
+    res.writeHead(403, { "Content-Type": "text/plain; charset=utf-8" });
+    res.end("Forbidden");
+    return;
+  }
+  try {
+    const stats = await fs.stat(filePath);
+    if (stats.isDirectory()) {
+      filePath = join(filePath, "index.html");
+    }
+  } catch {
+  }
+  try {
+    const ext = extname(filePath).toLowerCase();
+    const contentType = MIME_TYPES[ext] || "application/octet-stream";
+    const data = await fs.readFile(filePath);
+    res.writeHead(200, { "Content-Type": contentType });
+    res.end(data);
+  } catch {
+    await respondWithErrorPage(root, pathname, 404, res);
+  }
+}
+async function handleApiRequest(root, pathname, req, res) {
+  const routePath = join(root, pathname, "route.js");
+  try {
+    await fs.access(routePath);
+  } catch {
+    res.writeHead(404, { "Content-Type": "application/json; charset=utf-8" });
+    res.end(JSON.stringify({ error: "Not found" }));
+    return;
+  }
+  try {
+    const moduleUrl = pathToFileURL(routePath).href;
+    const { GET, HEAD, POST, PUT, PATCH, DELETE, OPTIONS, TRACE, CONNECT } = await import(moduleUrl);
+    let fn;
+    switch (req.method) {
+      case "GET":
+        fn = GET;
+        break;
+      case "HEAD":
+        fn = HEAD;
+        break;
+      case "POST":
+        fn = POST;
+        break;
+      case "PUT":
+        fn = PUT;
+        break;
+      case "PATCH":
+        fn = PATCH;
+        break;
+      case "DELETE":
+        fn = DELETE;
+        break;
+      case "OPTIONS":
+        fn = OPTIONS;
+        break;
+      case "TRACE":
+        fn = TRACE;
+        break;
+      case "CONNECT":
+        fn = CONNECT;
+        break;
+      default:
+        fn = null;
+        return;
+    }
+    if (fn === null) {
+      res.writeHead(404, { "Content-Type": "application/json; charset=utf-8" });
+      res.end(JSON.stringify({ error: "Unsupported method for route." }));
+      return;
+    }
+    if (typeof fn !== "function") {
+      throw new Error('API route module must export a "route" function.');
+    }
+    await fn(req, res);
+  } catch {
+    await respondWithErrorPage(root, pathname, 404, res);
+  }
+}
+async function respondWithErrorPage(root, pathname, code, res) {
+  let currentPath = normalize(join(root, decodeURIComponent(pathname)));
+  let tried = /* @__PURE__ */ new Set();
+  let errorFilePath = null;
+  while (currentPath.startsWith(root)) {
+    const candidate = join(currentPath, `${code}.html`);
+    if (!tried.has(candidate)) {
+      try {
+        await fs.access(candidate);
+        errorFilePath = candidate;
+        break;
+      } catch {
+      }
+      tried.add(candidate);
+    }
+    const parent = dirname(currentPath);
+    if (parent === currentPath) break;
+    currentPath = parent;
+  }
+  if (!errorFilePath) {
+    const fallback = join(root, `${code}.html`);
+    try {
+      await fs.access(fallback);
+      errorFilePath = fallback;
+    } catch {
+    }
+  }
+  if (errorFilePath) {
+    try {
+      const html = await fs.readFile(errorFilePath);
+      res.writeHead(code, { "Content-Type": "text/html; charset=utf-8" });
+      res.end(html);
+      return;
+    } catch {
+    }
+  }
+  res.writeHead(code, { "Content-Type": "text/plain; charset=utf-8" });
+  res.end(`${code} Error`);
+}
+export {
+  startServer
+};

package/dist/shared/bindServerElements.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/shared/bindServerElements.mjs

@@ -0,0 +1,145 @@
+// src/shared/serverElements.ts
+var createBuildableElement = (tag) => {
+  return (options, ...children) => ({
+    tag,
+    options: options || {},
+    children
+  });
+};
+var createChildrenlessBuildableElement = (tag) => {
+  return (options) => ({
+    tag,
+    options: options || {},
+    children: null
+  });
+};
+var childrenlessElementTags = [
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "source",
+  "track",
+  "path",
+  "rect"
+];
+var elementTags = [
+  "a",
+  "address",
+  "article",
+  "aside",
+  "audio",
+  "blockquote",
+  "body",
+  "button",
+  "canvas",
+  "caption",
+  "colgroup",
+  "data",
+  "datalist",
+  "dd",
+  "del",
+  "details",
+  "dialog",
+  "div",
+  "dl",
+  "dt",
+  "fieldset",
+  "figcaption",
+  "figure",
+  "footer",
+  "form",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  "head",
+  "header",
+  "hgroup",
+  "html",
+  "iframe",
+  "ins",
+  "label",
+  "legend",
+  "li",
+  "main",
+  "map",
+  "meter",
+  "nav",
+  "noscript",
+  "object",
+  "ol",
+  "optgroup",
+  "option",
+  "output",
+  "p",
+  "picture",
+  "pre",
+  "progress",
+  "q",
+  "section",
+  "select",
+  "summary",
+  "table",
+  "tbody",
+  "td",
+  "template",
+  "textarea",
+  "tfoot",
+  "th",
+  "thead",
+  "time",
+  "tr",
+  "ul",
+  "video",
+  "span",
+  "script",
+  "abbr",
+  "b",
+  "bdi",
+  "bdo",
+  "cite",
+  "code",
+  "dfn",
+  "em",
+  "i",
+  "kbd",
+  "mark",
+  "rp",
+  "rt",
+  "ruby",
+  "s",
+  "samp",
+  "small",
+  "strong",
+  "sub",
+  "sup",
+  "u",
+  "wbr",
+  "title",
+  "svg"
+];
+var elements = {};
+var childrenlessElements = {};
+for (const element of elementTags) {
+  elements[element] = createBuildableElement(element);
+}
+for (const element of childrenlessElementTags) {
+  childrenlessElements[element] = createChildrenlessBuildableElement(element);
+}
+var allElements = {
+  ...elements,
+  ...childrenlessElements
+};
+
+// src/shared/bindServerElements.ts
+Object.assign(globalThis, elements);
+Object.assign(globalThis, childrenlessElements);

package/dist/shared/serverElements.d.ts

@@ -0,0 +1,11 @@
+declare const createElementOptions: (obj: Record<string, any>) => () => Record<string, any>;
+declare const elements: {
+    [key: string]: EleganceElement<ElementTags>;
+};
+declare const childrenlessElements: {
+    [key: string]: EleganceChildrenlessElement<ChildrenlessElementTags>;
+};
+declare const allElements: {
+    [x: string]: EleganceElement<ElementTags> | EleganceChildrenlessElement<ChildrenlessElementTags>;
+};
+export { elements, childrenlessElements, createElementOptions, allElements };

package/dist/shared/serverElements.mjs

@@ -0,0 +1,165 @@
+// src/shared/serverElements.ts
+var createElementOptions = (obj) => {
+  return function() {
+    const reevaluatedObj = {};
+    for (const key of Object.keys(obj)) {
+      const value = obj[key];
+      if (typeof value === "function") {
+        if (key.startsWith("on")) {
+          reevaluatedObj[key] = value;
+        } else {
+          reevaluatedObj[key] = value();
+        }
+      } else {
+        reevaluatedObj[key] = value;
+      }
+    }
+    return reevaluatedObj;
+  };
+};
+var createBuildableElement = (tag) => {
+  return (options, ...children) => ({
+    tag,
+    options: options || {},
+    children
+  });
+};
+var createChildrenlessBuildableElement = (tag) => {
+  return (options) => ({
+    tag,
+    options: options || {},
+    children: null
+  });
+};
+var childrenlessElementTags = [
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "source",
+  "track",
+  "path",
+  "rect"
+];
+var elementTags = [
+  "a",
+  "address",
+  "article",
+  "aside",
+  "audio",
+  "blockquote",
+  "body",
+  "button",
+  "canvas",
+  "caption",
+  "colgroup",
+  "data",
+  "datalist",
+  "dd",
+  "del",
+  "details",
+  "dialog",
+  "div",
+  "dl",
+  "dt",
+  "fieldset",
+  "figcaption",
+  "figure",
+  "footer",
+  "form",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  "head",
+  "header",
+  "hgroup",
+  "html",
+  "iframe",
+  "ins",
+  "label",
+  "legend",
+  "li",
+  "main",
+  "map",
+  "meter",
+  "nav",
+  "noscript",
+  "object",
+  "ol",
+  "optgroup",
+  "option",
+  "output",
+  "p",
+  "picture",
+  "pre",
+  "progress",
+  "q",
+  "section",
+  "select",
+  "summary",
+  "table",
+  "tbody",
+  "td",
+  "template",
+  "textarea",
+  "tfoot",
+  "th",
+  "thead",
+  "time",
+  "tr",
+  "ul",
+  "video",
+  "span",
+  "script",
+  "abbr",
+  "b",
+  "bdi",
+  "bdo",
+  "cite",
+  "code",
+  "dfn",
+  "em",
+  "i",
+  "kbd",
+  "mark",
+  "rp",
+  "rt",
+  "ruby",
+  "s",
+  "samp",
+  "small",
+  "strong",
+  "sub",
+  "sup",
+  "u",
+  "wbr",
+  "title",
+  "svg"
+];
+var elements = {};
+var childrenlessElements = {};
+for (const element of elementTags) {
+  elements[element] = createBuildableElement(element);
+}
+for (const element of childrenlessElementTags) {
+  childrenlessElements[element] = createChildrenlessBuildableElement(element);
+}
+var allElements = {
+  ...elements,
+  ...childrenlessElements
+};
+export {
+  allElements,
+  childrenlessElements,
+  createElementOptions,
+  elements
+};

package/dist/types/Metadata.d.ts

@@ -0,0 +1,19 @@
+export declare enum GenerateMetadata {
+    /**
+     *
+     * <head> element and subsequent elements
+     * tagged with SEO, are generated at build-time, on the server.
+     *
+     */
+    ON_BUILD = 1,
+    /**
+     * <head> element and subsequent elements
+     * tagged with SEO, are generated per-request, on the server.
+     *
+     */
+    PER_REQUEST = 2
+}
+export declare enum CacheSSRResultHTML {
+    NO = 0,
+    YES = 1
+}

package/dist/types/Metadata.mjs

@@ -0,0 +1,15 @@
+// src/types/Metadata.ts
+var GenerateMetadata = /* @__PURE__ */ ((GenerateMetadata2) => {
+  GenerateMetadata2[GenerateMetadata2["ON_BUILD"] = 1] = "ON_BUILD";
+  GenerateMetadata2[GenerateMetadata2["PER_REQUEST"] = 2] = "PER_REQUEST";
+  return GenerateMetadata2;
+})(GenerateMetadata || {});
+var CacheSSRResultHTML = /* @__PURE__ */ ((CacheSSRResultHTML2) => {
+  CacheSSRResultHTML2[CacheSSRResultHTML2["NO"] = 0] = "NO";
+  CacheSSRResultHTML2[CacheSSRResultHTML2["YES"] = 1] = "YES";
+  return CacheSSRResultHTML2;
+})(CacheSSRResultHTML || {});
+export {
+  CacheSSRResultHTML,
+  GenerateMetadata
+};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "elegance-js",
+  "version": "1.0.0",
+  "description": "Web-Framework",
+  "type": "module",
+  "bin": {
+    "dev": "./scripts/dev.js",
+    "prod": "./scripts/prod.js",
+    "static": "./scripts/export.js"
+  },
+  "scripts": {
+    "build": "esbuild --format=esm --platform=node --bundle --outdir=./dist --platform=node --external:esbuild --out-extension:.js=.mjs \"./src/**/*.ts\" && tsc",
+    "compile-docs": "node ./dist/compile_docs.mjs --environment=development",
+    "compile-docs-bun": "bun run ./dist/compile_docs.mjs --environment=development",
+    "prepare": "npm run build && node ./dist/compile_docs.mjs --environment=production"
+  },
+  "exports": {
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.mjs",
+      "require": "./dist/*.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "author": "vqldemar",
+  "license": "MIT",
+  "dependencies": {
+    "esbuild": "^0.25.9"
+  },
+  "devDependencies": {
+    "@tailwindcss/cli": "^4.0.3",
+    "@types/node": "^22.9.1",
+    "tailwindcss": "^4.0.3",
+    "typescript": "^5.8.2"
+  }
+}

package/scripts/dev.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+
+import { compile } from "elegance-js/build"
+import { exec, execSync } from "node:child_process";
+
+compile({
+    environment: "development",
+    outputDirectory: ".elegance",
+    pagesDirectory: "./pages",
+    publicDirectory: {
+        method:"recursive-copy",
+        path: "./public",
+    },
+    hotReload: {
+        port: 3001,
+        hostname: "localhost",
+    },
+    server: {
+        runServer: true,
+        port: 3000,
+    },
+    postCompile: () => {
+        exec("npx @tailwindcss/cli -i ./pages/index.css -o .elegance/dist/index.css --watch")
+    },
+})

package/scripts/export.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+
+import { compile } from "elegance-js/build"
+import { exec, execSync } from "node:child_process";
+
+compile({
+    environment: "production",
+    outputDirectory: ".elegance",
+    pagesDirectory: "./pages",
+    publicDirectory: {
+        method: "recursive-copy",
+        path: "./public",
+    },
+    server: {
+        runServer: false,
+    },
+    postCompile: () => {
+        exec("npx @tailwindcss/cli -i ./pages/index.css -o .elegance/dist/index.css --minify=true")
+    },
+})

package/scripts/prod.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+
+import { compile } from "elegance-js/build"
+import { exec, execSync } from "node:child_process";
+
+compile({
+    environment: "production",
+    outputDirectory: ".elegance",
+    pagesDirectory: "./pages",
+    publicDirectory: {
+        method: "recursive-copy",
+        path: "./public",
+    },
+    server: {
+        runServer: true,
+        port: 3000,
+    },
+    postCompile: () => {
+        exec("npx @tailwindcss/cli -i ./pages/index.css -o .elegance/dist/index.css --minify=true")
+    },
+})