mikel-press 0.27.1 → 0.29.0

package/README.md

@@ -162,6 +162,20 @@ This plugin loads additional files (aka assets) and includes them in the build f
 
 This plugin processes and parses the frontmatter in each file. The parsed frontmatter content will be available in `page.attributes` field.
 
+### `press.TransformPlugin(options)`
+
+A generic transform plugin that will execute the provided `options.transform` function with the `context` and the current `node` object. Example:
+
+```javascript
+press.TransformPlugin({
+    transform: node => {
+        if (node.label === press.LABEL_PAGE && node.content && path.extname(node.source) === ".md") {
+            node.content = `{{#markdown}}\n\n${node.content}\n\n{{/markdown}}\n`;
+        }
+    },
+});
+```
+
 ### `press.ContentPagePlugin()`
 
 This plugin processes each page using the mikel templating.

package/index.js

@@ -39,6 +39,7 @@ press.createContext = (config = {}) => {
             ...plugins,
         ],
         nodes: [],
+        actions: {},
     });
     getPlugins(context, "init").forEach(plugin => {
         return plugin.init(context);
@@ -59,7 +60,15 @@ press.createContext = (config = {}) => {
 
 // @description build the provided context
 press.buildContext = (context, nodesToBuild = null) => {
-    const nodes = Array.isArray(nodesToBuild) ? nodesToBuild : context.nodes;
+    const nodes = (Array.isArray(nodesToBuild) ? nodesToBuild : context.nodes).slice();
+    const createNode = (nodeLabel, nodeObject = {}) => {
+        nodes.push({ label: nodeLabel, content: "", ...nodeObject });
+    };
+    // 0. assign actions to context
+    Object.assign(context.actions, {
+        createPage: pageObject => createNode(press.LABEL_PAGE, pageObject),
+        createAsset: assetObject => createNode(press.LABEL_ASSET, assetObject),
+    });
     // 1. transform nodes
     getPlugins(context, "transform").forEach(plugin => {
         // special hook to initialize the transform plugin
@@ -247,6 +256,14 @@ press.LayoutsPlugin = (options = {}) => {
     });
 };
 
+// @description generic transform plugin
+press.TransformPlugin = (options = {}) => {
+    const transformFn = typeof options?.transform === "function" ? options.transform : options;
+    return {
+        transform: (context, node) => transformFn(node, context),
+    };
+};
+
 // @description frontmatter plugin
 press.FrontmatterPlugin = () => {
     return {

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "mikel-press",
     "description": "A tiny and fast static site generator based on mikel templating",
-    "version": "0.27.1",
+    "version": "0.29.0",
     "type": "module",
     "license": "MIT",
     "author": {