@rettangoli/sites 1.0.0-rc3 → 1.0.0-rc4

package/README.md

@@ -121,7 +121,7 @@ Available in YAML templates/pages without extra setup:
 
 `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.
+`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-rc3",
+  "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

@@ -75,15 +75,45 @@ 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 = key == null ? left : left?.[key];
-    const rightRaw = key == null ? right : right?.[key];
+    const leftRaw = readSortValue(left, key, keyParts);
+    const rightRaw = readSortValue(right, key, keyParts);
 
     if (leftRaw == null && rightRaw == null) return 0;
     if (leftRaw == null) return 1;

package/templates/default/README.md

@@ -233,7 +233,7 @@ Use these directly in `${...}` expressions:
 
 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.
+`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