coralite 0.5.0 → 0.5.1

package/lib/coralite.js

@@ -1,5 +1,5 @@
 /**
- * @import { CoraliteElement, CoraliteTextNode } from '#types'
+ * @import { CoraliteElement, CoraliteTextNode, CoraliteAggregateTemplate } from '#types'
  */
 
 /**
@@ -30,7 +30,7 @@ export async function defineComponent (options) {
  * Aggregates HTML content from specified paths into a single collection of components.
  *
  * @param {Object} options - Configuration object for the aggregation process
- * @param {string} options.componentId - Unique identifier for the component used for each document
+ * @param {CoraliteAggregateTemplate | string} options.template - Templates used to display the result
  * @param {string} options.path - The path to aggregate, relative to pages directory
  * @returns {Promise<(CoraliteElement | CoraliteTextNode)[]>}
  */

package/lib/html-module.js

@@ -11,7 +11,8 @@ import { createComponent, parseHTMLMeta } from './parse.js'
  *
  * @param {Object} options - Configuration object for the aggregation process
  * @param {string} options.path - The path to aggregate, relative to pages directory
- * @param {string} options.componentId - Unique identifier for the component
+ * @param {Object} options.template - Templates used to display the result
+ * @param {string} options.template.item - Unique identifier for the component used for each document
  * @param {boolean} [options.recursive] - Whether to recursively search subdirectories
  * @param {CoraliteTokenOptions} [options.tokens] - Token configuration options
  * @param {CoraliteModuleValues} values - Default token values
@@ -24,7 +25,7 @@ import { createComponent, parseHTMLMeta } from './parse.js'
  * aggregate({
  *   path: 'button',
  *   recursive: true,
- *   componentId: 'my-component'
+ *   template: { item: 'my-component' }
  * }, {
  *   className: 'btn'
  * }, components, document);
@@ -62,7 +63,7 @@ export async function aggregate (options, values, components, document) {
     }
 
     const component = await createComponent({
-      id: options.componentId,
+      id: options.template.item,
       values: pageValues,
       components,
       document

package/lib/parse.js

@@ -18,6 +18,7 @@ import { invalidCustomTags, validTags } from './tags.js'
  *  CoraliteDocumentRoot,
  *  CoraliteContentNode,
  *  CoraliteModuleValues,
+ *  CoraliteAggregateTemplate
  * } from '#types'
  */
 
@@ -625,6 +626,7 @@ export async function createComponent ({
  */
 export async function parseScript (component, values, element, components, document) {
   const contextifiedObject = vm.createContext({
+    crypto,
     coralite: {
       tokens: values,
       /**
@@ -692,15 +694,31 @@ export async function parseScript (component, values, element, components, docum
         return values
       },
       /**
+       * @overload
        * @param {Object} options
-       * @param {string} options.componentId
+       * @param {string} options.template - Templates used to display the result
+       * @param {string} options.path
+       */
+
+      /**
+       * @param {Object} options
+       * @param {CoraliteAggregateTemplate} options.template - Templates used to display the result
        * @param {string} options.path
        */
       async aggregate (options) {
-        const component = components[options.componentId]
+        /** @type {string} */
+        let templateId
+
+        if (typeof options.template === 'string') {
+          templateId = options.template
+        } else {
+          templateId = options.template.item
+        }
+
+        const component = components[templateId]
 
         if (!component) {
-          throw new Error('Aggregate: no component found by the id: ' + options.componentId)
+          throw new Error('Aggregate: no template found by the id: ' + templateId)
         }
 
         return await aggregate(options, values, components, document)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coralite",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "HTML modules static site generator",
   "main": "./lib/coralite.js",
   "type": "module",

package/types/index.js

@@ -123,3 +123,8 @@
  * @property {CoraliteElement[]} customElements - Custom elements defined in the document
  * @property {CoralitePath} path - Document's file path
  */
+
+/**
+ * @typedef {Object} CoraliteAggregateTemplate - Templates used to display the result
+ * @property {string} item - Unique identifier for the component used for each document
+ */