@static-pages/core 2.0.2 → 3.0.1

package/README.md

@@ -32,10 +32,10 @@ This project targets small and medium sized projects. The rendering process trie
 __Readers__ provides an iterable list of page data. __Controllers__ can manipulate and extend each data object. __Writers__ render the final output for you.
 
 ```js
-const staticPages = require("@static-pages/core").default;
-const markdownReader = require("@static-pages/markdown-reader").default;
-const yamlReader = require("@static-pages/yaml-reader").default;
-const twigWriter = require("@static-pages/twig-writer").default;
+import staticPages from '@static-pages/core';
+import markdownReader from '@static-pages/markdown-reader';
+import yamlReader from '@static-pages/yaml-reader';
+import twigWriter from '@static-pages/twig-writer';
 
 staticPages([{
     from: markdownReader({
@@ -66,40 +66,20 @@ staticPages([{
 }]).catch(console.error);
 ```
 
-## Options of `staticPages()`
+## `staticPages(options: Options)`
 The `staticPages()` function expects one parameter which must be an array.
 Each item should contain `from`, `to` and optionally a `controller` property matching the definition below.
 
 ```ts
+type Data = Record<string, unknown>;
 type Options = {
     from: Iterable<Data> | AsyncIterable<Data>;
     to: (data: Data) => void | Promise<void>;
     controller?: (data: Data) => undefined | Data | Data[] | Promise<undefined | Data | Data[]>;
-    variables?: Record<string, unknown>;
 }[];
-
-// Where `Data` is:
-type Data = Record<string, unknown>;
-// Or the same definition in a more known form:
-type Data = { [k: string]: unknown };
 ```
 
-## Custom options for the controller
-You can pass additional configuration options to your controller under the `variables` property.
-These variables are accessible through the `this` context variable of the controller.
-
-```js
-require("@static-pages/core").default([{
-    from: ...,
-    to: ...,
-    controller: function(data) {
-        this.myProp; // <-- 123
-    },
-    variables: {
-        myProp: 123,
-    },
-}]);
-```
+> Additionally, when `Options` is not passed as an array, it is wrapped into an array.
 
 ## Missing a feature?
 Create an issue describing your needs. If it fits the scope of the project I will implement it or you can implement it your own and submit a pull request.

package/cjs/index.d.ts

@@ -4,7 +4,6 @@ export declare type Route = {
     from: Iterable<Data> | AsyncIterable<Data>;
     to: (data: Data) => void | Promise<void>;
     controller?: Controller;
-    variables?: Record<string, unknown>;
 };
-declare const _default: (routes: Route | Route[]) => Promise<void>;
-export default _default;
+export declare const staticPages: (routes: Route | Route[]) => Promise<void>;
+export default staticPages;

package/cjs/index.js

@@ -1,15 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.staticPages = void 0;
 const getType = (x) => typeof x === 'object' ? (x ? 'object' : 'null') : typeof x;
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 const isIterable = (x) => typeof (x === null || x === void 0 ? void 0 : x[Symbol.iterator]) === 'function';
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 const isAsyncIterable = (x) => typeof (x === null || x === void 0 ? void 0 : x[Symbol.asyncIterator]) === 'function';
-exports.default = async (routes) => {
+const staticPages = async (routes) => {
     for (const route of Array.isArray(routes) ? routes : [routes]) {
         if (typeof route !== 'object' || !route)
             throw new Error(`Route type mismatch, expected 'object', got '${getType(route)}'.`);
-        const { from, to, controller, variables } = route;
+        const { from, to, controller } = route;
         if (!isIterable(from) && !isAsyncIterable(from))
             throw new Error('Route \'from\' is not an \'iterable\' or an \'asyncIterable\'.');
         if (typeof to !== 'function')
@@ -18,7 +19,7 @@ exports.default = async (routes) => {
             throw new Error(`Route 'controller' type mismatch, expected 'function', got '${getType(controller)}'.`);
         const isController = typeof controller === 'function';
         for await (const data of from) {
-            const results = isController ? await controller.call(variables, data) : data;
+            const results = isController ? await controller(data) : data;
             if (typeof results === 'object' && results) {
                 if (Array.isArray(results)) {
                     for (const result of results) {
@@ -32,3 +33,5 @@ exports.default = async (routes) => {
         }
     }
 };
+exports.staticPages = staticPages;
+exports.default = exports.staticPages;

package/esm/index.d.ts

@@ -4,7 +4,6 @@ export declare type Route = {
     from: Iterable<Data> | AsyncIterable<Data>;
     to: (data: Data) => void | Promise<void>;
     controller?: Controller;
-    variables?: Record<string, unknown>;
 };
-declare const _default: (routes: Route | Route[]) => Promise<void>;
-export default _default;
+export declare const staticPages: (routes: Route | Route[]) => Promise<void>;
+export default staticPages;

package/esm/index.js

@@ -3,11 +3,11 @@ const getType = (x) => typeof x === 'object' ? (x ? 'object' : 'null') : typeof
 const isIterable = (x) => typeof (x === null || x === void 0 ? void 0 : x[Symbol.iterator]) === 'function';
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 const isAsyncIterable = (x) => typeof (x === null || x === void 0 ? void 0 : x[Symbol.asyncIterator]) === 'function';
-export default async (routes) => {
+export const staticPages = async (routes) => {
     for (const route of Array.isArray(routes) ? routes : [routes]) {
         if (typeof route !== 'object' || !route)
             throw new Error(`Route type mismatch, expected 'object', got '${getType(route)}'.`);
-        const { from, to, controller, variables } = route;
+        const { from, to, controller } = route;
         if (!isIterable(from) && !isAsyncIterable(from))
             throw new Error('Route \'from\' is not an \'iterable\' or an \'asyncIterable\'.');
         if (typeof to !== 'function')
@@ -16,7 +16,7 @@ export default async (routes) => {
             throw new Error(`Route 'controller' type mismatch, expected 'function', got '${getType(controller)}'.`);
         const isController = typeof controller === 'function';
         for await (const data of from) {
-            const results = isController ? await controller.call(variables, data) : data;
+            const results = isController ? await controller(data) : data;
             if (typeof results === 'object' && results) {
                 if (Array.isArray(results)) {
                     for (const result of results) {
@@ -30,3 +30,4 @@ export default async (routes) => {
         }
     }
 };
+export default staticPages;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@static-pages/core",
-  "version": "2.0.2",
+  "version": "3.0.1",
   "description": "General purpose static pages renderer.",
   "type": "module",
   "main": "./cjs/index.js",