@rettangoli/sites 1.0.0-rc1 → 1.0.0-rc3

package/README.md

@@ -115,10 +115,14 @@ Available in YAML templates/pages without extra setup:
 - `jsonStringify(value, space = 0)`
 - `formatDate(value, format = "YYYYMMDDHHmmss", useUtc = true)`
 - `now(format = "YYYYMMDDHHmmss", useUtc = true)`
+- `sort(list, key, order = "asc")`
+- `md(content)`
 - `toQueryString(object)`
 
 `formatDate` tokens: `YYYY`, `MM`, `DD`, `HH`, `mm`, `ss`.
 `decodeURI`/`decodeURIComponent` return the original input when decoding fails.
+`sort` supports `order` as `asc` or `desc` and returns a new array.
+`md` returns raw rendered HTML from Markdown for template insertion.
 
 ## Screenshots
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rettangoli/sites",
-  "version": "1.0.0-rc1",
+  "version": "1.0.0-rc3",
   "description": "Generate static sites using Markdown and YAML for docs, blogs, and marketing sites.",
   "author": {
     "name": "Luciano Hanyon Wu",

package/src/builtinTemplateFunctions.js

@@ -1,3 +1,7 @@
+import MarkdownIt from 'markdown-it';
+
+const markdownRenderer = new MarkdownIt();
+
 function toDate(value) {
   if (value instanceof Date) {
     return value;
@@ -71,6 +75,48 @@ function safeDecode(value, decoder) {
   }
 }
 
+function sortImpl(value, key, order = 'asc') {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  const normalizedOrder = String(order ?? 'asc').toLowerCase() === 'desc' ? 'desc' : 'asc';
+  const factor = normalizedOrder === 'asc' ? 1 : -1;
+  return [...value].sort((left, right) => {
+    const leftRaw = key == null ? left : left?.[key];
+    const rightRaw = key == null ? right : right?.[key];
+
+    if (leftRaw == null && rightRaw == null) return 0;
+    if (leftRaw == null) return 1;
+    if (rightRaw == null) return -1;
+
+    const leftDate = Date.parse(String(leftRaw));
+    const rightDate = Date.parse(String(rightRaw));
+    const canCompareAsDate = !Number.isNaN(leftDate) && !Number.isNaN(rightDate);
+
+    if (canCompareAsDate) {
+      if (leftDate === rightDate) return 0;
+      return leftDate > rightDate ? factor : -factor;
+    }
+
+    if (typeof leftRaw === 'number' && typeof rightRaw === 'number') {
+      if (leftRaw === rightRaw) return 0;
+      return leftRaw > rightRaw ? factor : -factor;
+    }
+
+    const leftText = String(leftRaw);
+    const rightText = String(rightRaw);
+    const result = leftText.localeCompare(rightText);
+    if (result === 0) return 0;
+    return result > 0 ? factor : -factor;
+  });
+}
+
+function mdImpl(content) {
+  return {
+    __html: markdownRenderer.render(String(content ?? '')),
+  };
+}
+
 export const builtinTemplateFunctions = {
   encodeURI: (value) => encodeURI(String(value ?? '')),
   encodeURIComponent: (value) => encodeURIComponent(String(value ?? '')),
@@ -79,6 +125,8 @@ export const builtinTemplateFunctions = {
   jsonStringify,
   formatDate: formatDateImpl,
   now: (format = 'YYYYMMDDHHmmss', useUtc = true) => formatDateImpl(new Date(), format, useUtc),
+  sort: sortImpl,
+  md: mdImpl,
   toQueryString,
 };
 

package/src/cli/watch.js

@@ -54,6 +54,25 @@ export function createClientScript(reloadMode = 'body') {
 `;
 }
 
+export function getContentType(ext) {
+  const 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',
+    '.txt': 'text/plain; charset=utf-8',
+    '.md': 'text/plain; charset=utf-8',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.svg': 'image/svg+xml',
+    '.ico': 'image/x-icon',
+    '.webp': 'image/webp'
+  };
+  return types[ext] || 'application/octet-stream';
+}
+
 function createLogger(quiet = false) {
   return {
     log: (...args) => {
@@ -163,7 +182,7 @@ class DevServer {
 
   serveFile(filePath, res) {
     const ext = path.extname(filePath);
-    const contentType = this.getContentType(ext);
+    const contentType = getContentType(ext);
 
     try {
       let content = fs.readFileSync(filePath);
@@ -181,7 +200,11 @@ class DevServer {
         }
       }
 
-      res.writeHead(200, { 'Content-Type': contentType });
+      const headers = { 'Content-Type': contentType };
+      if (ext === '.md' || ext === '.txt') {
+        headers['Content-Disposition'] = 'inline';
+      }
+      res.writeHead(200, headers);
       res.end(content);
     } catch (err) {
       this.logger.error('Error serving file:', err);
@@ -190,21 +213,6 @@ class DevServer {
     }
   }
 
-  getContentType(ext) {
-    const types = {
-      '.html': 'text/html',
-      '.css': 'text/css',
-      '.js': 'application/javascript',
-      '.json': 'application/json',
-      '.png': 'image/png',
-      '.jpg': 'image/jpeg',
-      '.gif': 'image/gif',
-      '.svg': 'image/svg+xml',
-      '.ico': 'image/x-icon'
-    };
-    return types[ext] || 'application/octet-stream';
-  }
-
   reloadAll() {
     // Send a simple reload command to all clients
     const message = JSON.stringify({

package/templates/default/README.md

@@ -227,10 +227,14 @@ Use these directly in `${...}` expressions:
 - `jsonStringify(value, space = 0)`
 - `formatDate(value, format = "YYYYMMDDHHmmss", useUtc = true)`
 - `now(format = "YYYYMMDDHHmmss", useUtc = true)`
+- `sort(list, key, order = "asc")`
+- `md(content)`
 - `toQueryString(object)`
 
 Date format tokens: `YYYY`, `MM`, `DD`, `HH`, `mm`, `ss`.
 `decodeURI`/`decodeURIComponent` return the original input when decoding fails.
+`sort` supports `order` as `asc` or `desc` and returns a new array.
+`md` returns raw rendered HTML from Markdown for template insertion.
 
 ## Static Files