coralite 0.6.0 → 0.6.1

package/README.md

@@ -2,7 +2,11 @@
 
 coralite is a static site generator library built around the emerging [HTML modules proposal](https://github.com/WICG/webcomponents/blob/gh-pages/proposals/html-modules-explainer.md).
 
-[Getting started: Basic templating](./docs/basic-templating.md)
+- Getting started
+  [Basic templating](./docs/basic-templating.md)
+- Reference
+  [Coralite CLI](./docs/coralite-cli.md)
+  [Coralite](./docs/coralite.md)
 
 ## Installation
 
@@ -15,6 +19,7 @@ yarn global add coralite
 # or
 pnpm add -g coralite
 ```
+
 You can also install coralite as a development dependency:
 
 ```bash
@@ -32,6 +37,7 @@ Coralite uses **ECMAScript Modules** which requires to run Node.js with the **`-
 ```bash
 node --experimental-vm-modules node_modules/coralite/bin/coralite.js [options]
 ```
+
 or using NODE_OPTIONS
 
 ```bash
@@ -64,10 +70,10 @@ coralite --templates ./src/templates --pages ./src/pages --output ./dist
 
 ## Optional Options
 
-### -d or --dry
+### -d or --dry-run
 
 Run the CLI in dry-run mode to preview the actions that would be performed without actually generating the website. This is useful for debugging or when you want to check potential issues before committing changes:
 
 ```bash
-coralite --templates ./src/templates --pages ./src/pages --output ./dist --dry
+coralite --templates ./src/templates --pages ./src/pages --output ./dist --dry-run
 ```

package/lib/coralite.js

@@ -7,7 +7,8 @@ import render from 'dom-serializer'
  *  CoraliteTextNode,
  *  CoraliteAggregateTemplate,
  *  CoraliteAnyNode,
- *  CoraliteModule } from '#types'
+ *  CoraliteModule,
+ *  CoraliteResult} from '#types'
  */
 
 /**
@@ -53,9 +54,26 @@ export async function aggregate (options) {
 
 /**
  * @param {Object} options
- * @param {string} options.templates
- * @param {string} options.pages
- * @param {Array<string[]>} [options.ignoreByAttribute]
+ * @param {string} options.templates - The path to the directory containing Coralite templates.
+ * @param {string} options.pages - The path to the directory containing pages that will be rendered using the provided templates.
+ * @param {[string, string][]} [options.ignoreByAttribute] - Elements to ignore with attribute name value pair
+ *
+ * @return {Promise<Array<CoraliteResult>>} - An array of objects containing the document and HTML content for each page in pages directory with their respective render times.
+ * @example
+ * ```
+ * coralite({
+ *   templates: './path/to/templates',
+ *   pages: './path/to/pages'
+ *   ignoreByAttribute: [['data-dev', 'true']]
+ * })
+ * .then((documents) => {
+ *   documents.forEach(({ document, html, duration }) => {
+ *     console.log(`Rendered ${document.title} in ${duration}ms.`);
+ *     console.log(html);
+ *   });
+ * })
+ * .catch(console.error);
+ * ```
  */
 export async function coralite ({
   templates,
@@ -74,6 +92,7 @@ export async function coralite ({
 
   /** @type {Object.<string, CoraliteModule>} */
   const coraliteModules = {}
+  /** @type {CoraliteResult[]} */
   const documents = []
 
   // create templates

package/lib/parse.js

@@ -694,7 +694,7 @@ export async function parseScript (component, values, element, components, docum
               }
 
               // compute slot nodes
-              const result = computedSlot(slotContent)
+              const result = computedSlot(slotContent) || slotContent
 
               // append new slot nodes
               for (let index = 0; index < result.length; index++) {
@@ -776,8 +776,26 @@ async function moduleLinker (specifier, referencingModule) {
       export default { tokens, defineComponent, aggregate };
     `, { context: referencingModule.context })
   }
+  const module = await import(specifier)
+  let exportModule = ''
 
-  throw new Error(`Unable to resolve dependency: ${specifier}`)
+  for (const key in module) {
+    if (Object.prototype.hasOwnProperty.call(module, key)) {
+      const name = 'globalThis["'+ specifier + '"].'
+
+      if (key === 'default') {
+        exportModule += 'export default ' + name + key + ';\n'
+      } else {
+        exportModule += 'export const '+ key + ' = ' + name + key + ';\n'
+      }
+    }
+
+    referencingModule.context[specifier] = module
+  }
+
+  return new vm.SourceTextModule(exportModule, {
+    context: referencingModule.context
+  })
 }
 
 /**

package/package.json

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

package/types/index.js

@@ -129,3 +129,10 @@
  * @typedef {Object} CoraliteAggregateTemplate - Templates used to display the result
  * @property {string} item - Unique identifier for the component used for each document
  */
+
+/**
+ * @typedef {Object} CoraliteResult
+ * @property {CoraliteDocument} item - The document object from the rendering process
+ * @property {string} html - Raw HTML content of the render process as a string
+ * @property {number} duration - The duration of the render process in milliseconds
+ */