@rettangoli/sites 1.0.0-rc2 → 1.0.0-rc4

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` (default: `asc`), accepts dot-path keys (for example `data.date`), 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-rc2",
+  "version": "1.0.0-rc4",
   "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,78 @@ function safeDecode(value, decoder) {
   }
 }
 
+function readSortValue(item, key, keyParts) {
+  if (key == null) {
+    return item;
+  }
+
+  if (item == null) {
+    return undefined;
+  }
+
+  if (!keyParts) {
+    return item?.[key];
+  }
+
+  if (Object.prototype.hasOwnProperty.call(item, key)) {
+    return item[key];
+  }
+
+  let current = item;
+  for (const part of keyParts) {
+    if (!part) {
+      return undefined;
+    }
+    current = current?.[part];
+  }
+  return current;
+}
+
+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;
+  const keyParts = typeof key === 'string' && key.includes('.') ? key.split('.') : null;
+
+  return [...value].sort((left, right) => {
+    const leftRaw = readSortValue(left, key, keyParts);
+    const rightRaw = readSortValue(right, key, keyParts);
+
+    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 +155,8 @@ export const builtinTemplateFunctions = {
   jsonStringify,
   formatDate: formatDateImpl,
   now: (format = 'YYYYMMDDHHmmss', useUtc = true) => formatDateImpl(new Date(), format, useUtc),
+  sort: sortImpl,
+  md: mdImpl,
   toQueryString,
 };
 

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` (default: `asc`), accepts dot-path keys (for example `data.date`), and returns a new array.
+`md` returns raw rendered HTML from Markdown for template insertion.
 
 ## Static Files