coralite 0.24.0 → 0.26.0

package/bin/coralite.js

@@ -21,6 +21,7 @@ program
   .requiredOption('-o, --output <path>', 'Output directory for the generated site')
   .option('-m, --mode <mode>', 'Build mode: "development" or "production"', 'production')
   .option('-i, --ignore-attribute <key=value...>', 'Ignore elements by attribute name value pair', [])
+  .option('-s, --skip-render-attribute <key...>', 'Parse elements but exclude them from final render output', [])
   .option('-d, --dry-run', 'Run in dry-run mode')
 
 program.parse(process.argv)
@@ -49,6 +50,7 @@ const coraliteOptions = {
   templates: options.templates,
   pages,
   ignoreByAttribute,
+  skipRenderByAttribute: options.skipRenderAttribute,
   mode: options.mode,
   plugins: []
 }

package/dist/lib/coralite.d.ts

@@ -9,7 +9,7 @@
  *  CoraliteCollectionItem,
  *  CoraliteDocumentRoot,
  *  CoraliteCollectionEventSet,
- *  IgnoreByAttribute,
+ *  Attribute,
  *  CoraliteDocumentResult,
  *  CoraliteValues,
  *  InstanceContext} from '../types/index.js'
@@ -26,22 +26,25 @@
  * @param {CoralitePluginInstance[]} [options.plugins=[]]
  * @param {string} options.pages - The path to the directory containing pages that will be rendered using the provided templates.
  * @param {string} [options.mode='production'] - Build mode: "development" or "production"
- * @param {IgnoreByAttribute[]} [options.ignoreByAttribute] - Elements to ignore with attribute name value pair
+ * @param {Attribute[]} [options.ignoreByAttribute] - Elements to ignore with attribute name value pair
+ * @param {string[]} [options.skipRenderByAttribute] - Element attributes to parse but exclude from final render output
  * @example
  * const coralite = new Coralite({
  *   templates: './path/to/templates',
  *   pages: './path/to/pages',
  *   mode: 'development',
  *   plugins: [myPlugin],
- *   ignoreByAttribute: [{ name: 'data-ignore', value: 'true' }]
+ *   ignoreByAttribute: [{ name: 'data-ignore', value: 'true' }],
+ *   skipRenderByAttribute: ['data-skip-render']
  * });
  */
-export function Coralite({ templates, pages, plugins, ignoreByAttribute, mode }: {
+export function Coralite({ templates, pages, plugins, ignoreByAttribute, skipRenderByAttribute, mode }: {
     templates: string;
     plugins?: CoralitePluginInstance[];
     pages: string;
     mode?: string;
-    ignoreByAttribute?: IgnoreByAttribute[];
+    ignoreByAttribute?: Attribute[];
+    skipRenderByAttribute?: string[];
 }): void;
 export class Coralite {
     /**
@@ -55,7 +58,7 @@ export class Coralite {
      *  CoraliteCollectionItem,
      *  CoraliteDocumentRoot,
      *  CoraliteCollectionEventSet,
-     *  IgnoreByAttribute,
+     *  Attribute,
      *  CoraliteDocumentResult,
      *  CoraliteValues,
      *  InstanceContext} from '../types/index.js'
@@ -72,28 +75,32 @@ export class Coralite {
      * @param {CoralitePluginInstance[]} [options.plugins=[]]
      * @param {string} options.pages - The path to the directory containing pages that will be rendered using the provided templates.
      * @param {string} [options.mode='production'] - Build mode: "development" or "production"
-     * @param {IgnoreByAttribute[]} [options.ignoreByAttribute] - Elements to ignore with attribute name value pair
+     * @param {Attribute[]} [options.ignoreByAttribute] - Elements to ignore with attribute name value pair
+     * @param {string[]} [options.skipRenderByAttribute] - Element attributes to parse but exclude from final render output
      * @example
      * const coralite = new Coralite({
      *   templates: './path/to/templates',
      *   pages: './path/to/pages',
      *   mode: 'development',
      *   plugins: [myPlugin],
-     *   ignoreByAttribute: [{ name: 'data-ignore', value: 'true' }]
+     *   ignoreByAttribute: [{ name: 'data-ignore', value: 'true' }],
+     *   skipRenderByAttribute: ['data-skip-render']
      * });
      */
-    constructor({ templates, pages, plugins, ignoreByAttribute, mode }: {
+    constructor({ templates, pages, plugins, ignoreByAttribute, skipRenderByAttribute, mode }: {
         templates: string;
         plugins?: CoralitePluginInstance[];
         pages: string;
         mode?: string;
-        ignoreByAttribute?: IgnoreByAttribute[];
+        ignoreByAttribute?: Attribute[];
+        skipRenderByAttribute?: string[];
     });
     options: {
         templates: string;
         pages: string;
         plugins: CoralitePluginInstance[];
-        ignoreByAttribute: import("../types/document.js").IgnoreByAttribute[];
+        ignoreByAttribute: import("../types/document.js").Attribute[];
+        skipRenderByAttribute: string[];
         mode: string;
         path: {
             templates: string;
@@ -111,8 +118,10 @@ export class Coralite {
             onTemplateSet: any[];
             onTemplateUpdate: any[];
             onTemplateDelete: any[];
+            onBeforePageRender: any[];
             onAfterPageRender: any[];
-            onBuildComplete: any[];
+            onBeforeBuild: any[];
+            onAfterBuild: any[];
         };
     };
     _scriptManager: ScriptManager;
@@ -132,7 +141,7 @@ export class Coralite {
                 templates: string;
                 pages: string;
             };
-            excludeByAttribute: import("../types/document.js").IgnoreByAttribute[];
+            excludeByAttribute: import("../types/document.js").Attribute[];
             templates: CoraliteCollection;
             pages: CoraliteCollection;
         };
@@ -558,25 +567,25 @@ export class Coralite {
      *
      * @internal
      *
-     * @param {'onPageSet'|'onPageUpdate'|'onPageDelete'|'onTemplateSet'|'onTemplateUpdate'|'onTemplateDelete'|'onAfterPageRender'|'onBuildComplete'} name - The name of the hook to trigger.
+     * @param {'onPageSet'|'onPageUpdate'|'onPageDelete'|'onTemplateSet'|'onTemplateUpdate'|'onTemplateDelete'|'onBeforePageRender'|'onAfterPageRender'|'onBeforeBuild'|'onAfterBuild'} name - The name of the hook to trigger.
      * @param {T} data - Data to pass to each callback function.
      * @return {Promise<Array<T>>} A promise that resolves to an array of results from all callbacks.
      */
-    _triggerPluginHook<T extends unknown>(name: "onPageSet" | "onPageUpdate" | "onPageDelete" | "onTemplateSet" | "onTemplateUpdate" | "onTemplateDelete" | "onAfterPageRender" | "onBuildComplete", data: T): Promise<Array<T>>;
+    _triggerPluginHook<T extends unknown>(name: "onPageSet" | "onPageUpdate" | "onPageDelete" | "onTemplateSet" | "onTemplateUpdate" | "onTemplateDelete" | "onBeforePageRender" | "onAfterPageRender" | "onBeforeBuild" | "onAfterBuild", data: T): Promise<Array<T>>;
     /**
      * Registers a callback function under the specified hook name.
      *
      * @internal
      *
-     * @param {'onPageSet'|'onPageUpdate'|'onPageDelete'|'onTemplateSet'|'onTemplateUpdate'|'onTemplateDelete'|'onAfterPageRender'|'onBuildComplete'} name - The name of the hook to register the callback with.
+     * @param {'onPageSet'|'onPageUpdate'|'onPageDelete'|'onTemplateSet'|'onTemplateUpdate'|'onTemplateDelete'|'onBeforePageRender'|'onAfterPageRender'|'onBeforeBuild'|'onAfterBuild'} name - The name of the hook to register the callback with.
      * @param {Function} callback - The callback function to be executed when the hook is triggered.
      */
-    _addPluginHook(name: "onPageSet" | "onPageUpdate" | "onPageDelete" | "onTemplateSet" | "onTemplateUpdate" | "onTemplateDelete" | "onAfterPageRender" | "onBuildComplete", callback: Function): void;
+    _addPluginHook(name: "onPageSet" | "onPageUpdate" | "onPageDelete" | "onTemplateSet" | "onTemplateUpdate" | "onTemplateDelete" | "onBeforePageRender" | "onAfterPageRender" | "onBeforeBuild" | "onAfterBuild", callback: Function): void;
 }
 export default Coralite;
 export type BuildPageHandler = (result: CoraliteResult) => Promise<any> | any;
 import type { CoralitePluginInstance } from '../types/plugin.js';
-import type { IgnoreByAttribute } from '../types/index.js';
+import type { Attribute } from '../types/index.js';
 import type { CoraliteCollectionItem } from '../types/index.js';
 import { ScriptManager } from './script-manager.js';
 import { parseHTML } from './parse.js';

package/dist/lib/coralite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coralite.d.ts","sourceRoot":"","sources":["../../lib/coralite.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"coralite.d.ts","sourceRoot":"","sources":["../../lib/coralite.js"],"names":[],"mappings":"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"}

package/dist/lib/index.js

@@ -6136,12 +6136,14 @@ function cloneDocumentInstance(originalDocument) {
   const newRoot = cloneNode(nodeMap, originalDocument.root, null);
   const newCustomElements = originalDocument.customElements.map((el) => nodeMap.get(el));
   const newTempElements = originalDocument.tempElements ? originalDocument.tempElements.map((el) => nodeMap.get(el)) : [];
+  const newSkipRenderElements = originalDocument.skipRenderElements ? originalDocument.skipRenderElements.map((el) => nodeMap.get(el)) : [];
   return {
     ...originalDocument,
     values: { ...originalDocument.values },
     root: newRoot,
     customElements: newCustomElements,
-    tempElements: newTempElements
+    tempElements: newTempElements,
+    skipRenderElements: newSkipRenderElements
   };
 }
 function findAndExtractScript(code) {
@@ -8766,7 +8768,7 @@ function isValidCustomElementName(name, maxLength = 100) {
 }
 
 // lib/parse.js
-function parseHTML(string, ignoreByAttribute) {
+function parseHTML(string, ignoreByAttribute, skipRenderByAttribute) {
   const root = createCoraliteDocument({
     type: "root",
     children: []
@@ -8774,6 +8776,7 @@ function parseHTML(string, ignoreByAttribute) {
   const stack = [root];
   const customElements = [];
   const tempElements = [];
+  const skipRenderElements = [];
   const ignoreAttributeMap = getIgnoreAttributeMap(ignoreByAttribute);
   const parser = new Parser3({
     onprocessinginstruction(name, data2) {
@@ -8792,6 +8795,14 @@ function parseHTML(string, ignoreByAttribute) {
         parent,
         ignoreByAttribute: ignoreAttributeMap
       });
+      if (skipRenderByAttribute && skipRenderByAttribute.length > 0) {
+        for (let i = 0; i < skipRenderByAttribute.length; i++) {
+          if (Object.prototype.hasOwnProperty.call(attributes, skipRenderByAttribute[i])) {
+            element.skipRender = true;
+            break;
+          }
+        }
+      }
       if (element.slots) {
         customElements.push(element);
       }
@@ -8803,8 +8814,12 @@ function parseHTML(string, ignoreByAttribute) {
     },
     onclosetag() {
       const element = stack[stack.length - 1];
-      if (element.type === "tag" && element.remove) {
-        tempElements.push(element.parent.children[element.parent.children.length - 1]);
+      if (element.type === "tag") {
+        if (element.remove) {
+          tempElements.push(element.parent.children[element.parent.children.length - 1]);
+        } else if (element.skipRender) {
+          skipRenderElements.push(element.parent.children[element.parent.children.length - 1]);
+        }
       }
       stack.pop();
     },
@@ -8823,7 +8838,8 @@ function parseHTML(string, ignoreByAttribute) {
   return {
     root,
     customElements,
-    tempElements
+    tempElements,
+    skipRenderElements
   };
 }
 function sortSlottedChildren(elements) {
@@ -8843,7 +8859,7 @@ function sortSlottedChildren(elements) {
     }
   }
 }
-function parseModule(string, { ignoreByAttribute }) {
+function parseModule(string, { ignoreByAttribute, skipRenderByAttribute }) {
   const root = createCoraliteDocument({
     type: "root",
     children: []
@@ -8872,6 +8888,14 @@ function parseModule(string, { ignoreByAttribute }) {
         parent,
         ignoreByAttribute: ignoreAttributeMap
       });
+      if (skipRenderByAttribute && skipRenderByAttribute.length > 0) {
+        for (let i = 0; i < skipRenderByAttribute.length; i++) {
+          if (Object.prototype.hasOwnProperty.call(attributes, skipRenderByAttribute[i])) {
+            element.skipRender = true;
+            break;
+          }
+        }
+      }
       if (element.slots) {
         customElements.push(element);
       }
@@ -9218,10 +9242,7 @@ function ScriptManager() {
   this.scriptModules = [];
 }
 ScriptManager.prototype.use = async function(plugin) {
-  if (plugin && typeof plugin.setup === "function") {
-    plugin.setup(this);
-  }
-  if (plugin && typeof plugin !== "function" && (plugin.helpers || plugin.imports)) {
+  if (plugin && typeof plugin !== "function" && (plugin.helpers || plugin.imports || typeof plugin.setup === "function")) {
     this.scriptModules.push(plugin);
   }
   this.plugins.push(plugin);
@@ -9266,11 +9287,11 @@ ScriptManager.prototype.compileAllInstances = async function(instances, mode) {
   const entryCodeParts = [];
   const moduleNamespace = "coralite-script-module:";
   for (let i = 0; i < this.scriptModules.length; i++) {
-    entryCodeParts.push(`import scriptModule_${i} from "${moduleNamespace}${i}";
+    entryCodeParts.push(`import { helpers as helpers_${i}, runSetup as runSetup_${i} } from "${moduleNamespace}${i}";
 `);
   }
   const helperParts = [
-    ...this.scriptModules.map((_, i) => `...scriptModule_${i}`),
+    ...this.scriptModules.map((_, i) => `...helpers_${i}`),
     this.getHelpersContent()
   ].filter(Boolean).join(",\n");
   entryCodeParts.push(`const coraliteTemplateScriptHelpers = {
@@ -9284,6 +9305,23 @@ ScriptManager.prototype.compileAllInstances = async function(instances, mode) {
     }
     return helpers
   }
+`);
+  entryCodeParts.push(`const getSetups = async (context) => {
+    const values = {};
+    const results = await Promise.all([
+      ${this.scriptModules.map((_, i) => `runSetup_${i}(context)`).join(",\n      ")}
+    ]);
+    for (const res of results) {
+      if (res && typeof res === 'object') {
+        Object.assign(values, res);
+      }
+    }
+    return values;
+  }
+`);
+  entryCodeParts.push(`const globalContext = {};
+`);
+  entryCodeParts.push(`const globalSetupValuesPromise = getSetups(globalContext);
 `);
   const instanceValues = Object.entries(instances);
   const processedTemplates = {};
@@ -9332,10 +9370,12 @@ ScriptManager.prototype.compileAllInstances = async function(instances, mode) {
     };
     entryCodeParts.push(";(async() => {\n");
     entryCodeParts.push("const context = " + serialize(context) + ";\n");
-    entryCodeParts.push("const helpers = getHelpers(context);\n");
     entryCodeParts.push(`const imports = coraliteComponentImports["${context.templateId}"] || {};
 `);
     entryCodeParts.push("context.imports = imports;\n");
+    entryCodeParts.push("const setupValues = await globalSetupValuesPromise;\n");
+    entryCodeParts.push("context.values = { ...context.values, ...setupValues };\n");
+    entryCodeParts.push("const helpers = getHelpers(context);\n");
     entryCodeParts.push("context.helpers = helpers;\n");
     entryCodeParts.push(`
 // Instance: ${instanceId}
@@ -9355,7 +9395,8 @@ ScriptManager.prototype.compileAllInstances = async function(instances, mode) {
     treeShaking: true,
     sourcemap: mode === "production" ? false : "inline",
     minify: mode === "production",
-    format: "iife",
+    format: "esm",
+    external: ["http://*", "https://*"],
     sourceRoot: pathToFileURL(process.cwd()).href,
     plugins: [
       {
@@ -9487,7 +9528,19 @@ ScriptManager.prototype.compileAllInstances = async function(instances, mode) {
             contents += importsObjContent + "\n";
             const configContent = module.config ? `const pluginConfig = ${JSON.stringify(module.config)};` : "const pluginConfig = {};";
             contents += configContent + "\n";
-            contents += "const helpers = {\n";
+            const setupFn = module.setup ? normalizeFunction(module.setup) : "null";
+            contents += `export const runSetup = async (context) => {
+              const setup = ${setupFn};
+              if (!setup) return {};
+              const ctx = {
+                imports: pluginImports,
+                config: pluginConfig,
+                ...context
+              };
+              return await setup(ctx);
+            };
+`;
+            contents += "export const helpers = {\n";
             if (module.helpers) {
               for (const key in module.helpers) {
                 if (Object.hasOwn(module.helpers, key)) {
@@ -9503,7 +9556,6 @@ ScriptManager.prototype.compileAllInstances = async function(instances, mode) {
               }
             }
             contents += "};\n";
-            contents += "export default helpers;";
             return {
               contents,
               loader: "js",
@@ -9702,7 +9754,7 @@ var defineComponent = createPlugin({
 // plugins/refs.js
 var refsPlugin = createPlugin({
   name: "refs",
-  script: {
+  client: {
     helpers: {
       /**
        * Creates a ref resolver function that maps IDs to DOM elements.
@@ -9843,6 +9895,7 @@ function Coralite({
   pages,
   plugins,
   ignoreByAttribute,
+  skipRenderByAttribute,
   mode = "production"
 }) {
   if (!templates && typeof templates !== "string") {
@@ -9863,6 +9916,7 @@ function Coralite({
     pages,
     plugins,
     ignoreByAttribute,
+    skipRenderByAttribute,
     mode,
     path: path2
   };
@@ -9876,8 +9930,10 @@ function Coralite({
       onTemplateSet: [],
       onTemplateUpdate: [],
       onTemplateDelete: [],
+      onBeforePageRender: [],
       onAfterPageRender: [],
-      onBuildComplete: []
+      onBeforeBuild: [],
+      onAfterBuild: []
     }
   };
   this._scriptManager = new ScriptManager();
@@ -9933,14 +9989,20 @@ function Coralite({
     if (plugin.onTemplateUpdate) {
       this._addPluginHook("onTemplateUpdate", plugin.onTemplateUpdate);
     }
+    if (plugin.onBeforePageRender) {
+      this._addPluginHook("onBeforePageRender", plugin.onBeforePageRender);
+    }
     if (plugin.onAfterPageRender) {
       this._addPluginHook("onAfterPageRender", plugin.onAfterPageRender);
     }
-    if (plugin.onBuildComplete) {
-      this._addPluginHook("onBuildComplete", plugin.onBuildComplete);
+    if (plugin.onBeforeBuild) {
+      this._addPluginHook("onBeforeBuild", plugin.onBeforeBuild);
+    }
+    if (plugin.onAfterBuild) {
+      this._addPluginHook("onAfterBuild", plugin.onAfterBuild);
     }
-    if (plugin.script) {
-      this._scriptManager.use(plugin.script);
+    if (plugin.client) {
+      this._scriptManager.use(plugin.client);
     }
   }
   source.contextModules.defineComponent = source.context.plugins.defineComponent;
@@ -10003,7 +10065,7 @@ Coralite.prototype.initialise = async function() {
   this._pageCustomElements = pageCustomElements;
   this._childCustomElements = childCustomElements;
   const onFileSet = async (data2) => {
-    const elements = parseHTML(data2.content, this.options.ignoreByAttribute);
+    const elements = parseHTML(data2.content, this.options.ignoreByAttribute, this.options.skipRenderByAttribute);
     for (let i = 0; i < elements.customElements.length; i++) {
       const customElement = elements.customElements[i];
       const name = customElement.name;
@@ -10056,7 +10118,8 @@ Coralite.prototype.initialise = async function() {
         path: data2.path,
         root: elements.root,
         customElements: elements.customElements,
-        tempElements: elements.tempElements
+        tempElements: elements.tempElements,
+        skipRenderElements: elements.skipRenderElements
       }
     };
   };
@@ -10183,6 +10246,11 @@ Coralite.prototype._generatePages = async function* (path2, values = {}) {
       Object.assign(document2.values, values);
       const renderContext = this._createRenderContext(buildId);
       renderContext.mode = this.options.mode;
+      await this._triggerPluginHook("onBeforePageRender", {
+        document: document2,
+        values,
+        renderContext
+      });
       if (document2.tempElements) {
         for (const element of document2.tempElements) {
           if (element.parent && element.parent.children) {
@@ -10305,6 +10373,15 @@ ${css}
         }));
         bodyElement.children.push(scriptElement);
       }
+      if (document2.skipRenderElements) {
+        for (const element of document2.skipRenderElements) {
+          if (element.parent && element.parent.children) {
+            element.parent.children = element.parent.children.filter(
+              (child) => child !== element
+            );
+          }
+        }
+      }
       let rawHTML = "";
       rawHTML = this.transform(document2.root);
       yield {
@@ -10331,6 +10408,13 @@ Coralite.prototype.build = async function(...args) {
     options = args[1];
     callback = args[2];
   }
+  if (!options) {
+    options = {};
+  }
+  await this._triggerPluginHook("onBeforeBuild", {
+    path: path2,
+    options
+  });
   const signal = options?.signal;
   const maxConcurrent = options?.maxConcurrent || availableParallelism();
   const variables = options?.variables;
@@ -10400,7 +10484,7 @@ Coralite.prototype.build = async function(...args) {
     throw finalError;
   } finally {
     const duration = performance.now() - startTime;
-    await this._triggerPluginHook("onBuildComplete", {
+    await this._triggerPluginHook("onAfterBuild", {
       results,
       error: buildError,
       duration
@@ -11041,9 +11125,11 @@ function createPlugin({
   onTemplateSet,
   onTemplateUpdate,
   onTemplateDelete,
+  onBeforePageRender,
   onAfterPageRender,
-  onBuildComplete,
-  script,
+  onBeforeBuild,
+  onAfterBuild,
+  client,
   server
 }) {
   validateNonEmptyString(name, "name");
@@ -11054,32 +11140,34 @@ function createPlugin({
   validateOptionalFunction(onTemplateSet, "onTemplateSet");
   validateOptionalFunction(onTemplateUpdate, "onTemplateUpdate");
   validateOptionalFunction(onTemplateDelete, "onTemplateDelete");
+  validateOptionalFunction(onBeforePageRender, "onBeforePageRender");
   validateOptionalFunction(onAfterPageRender, "onAfterPageRender");
-  validateOptionalFunction(onBuildComplete, "onBuildComplete");
+  validateOptionalFunction(onBeforeBuild, "onBeforeBuild");
+  validateOptionalFunction(onAfterBuild, "onAfterBuild");
   validateOptionalFunction(server, "server");
   validateStringArray(templates, "templates");
-  if (script != null) {
-    if (typeof script !== "object") {
+  if (client != null) {
+    if (typeof client !== "object") {
       throw new Error(
-        `Coralite plugin validation failed: "scriptPlugin" must be an object, received ${typeof script}`
+        `Coralite plugin validation failed: "client" must be an object, received ${typeof client}`
       );
     }
-    if (script.setup != null && typeof script.setup !== "function") {
+    if (client.setup != null && typeof client.setup !== "function") {
       throw new Error(
-        `Coralite plugin validation failed: "scriptPlugin.setup" must be a function, received ${typeof script.setup}`
+        `Coralite plugin validation failed: "client.setup" must be a function, received ${typeof client.setup}`
       );
     }
-    if (script.helpers != null && typeof script.helpers !== "object") {
+    if (client.helpers != null && typeof client.helpers !== "object") {
       throw new Error(
-        `Coralite plugin validation failed: "scriptPlugin.helpers" must be an object, received ${typeof script.helpers}`
+        `Coralite plugin validation failed: "client.helpers" must be an object, received ${typeof client.helpers}`
       );
     }
-    if (script.imports != null) {
-      validateImportArray(script.imports, "scriptPlugin.imports");
+    if (client.imports != null) {
+      validateImportArray(client.imports, "client.imports");
     }
-    if (script.config != null && typeof script.config !== "object") {
+    if (client.config != null && typeof client.config !== "object") {
       throw new Error(
-        `Coralite plugin validation failed: "scriptPlugin.config" must be an object, received ${typeof script.config}`
+        `Coralite plugin validation failed: "client.config" must be an object, received ${typeof client.config}`
       );
     }
   }
@@ -11106,9 +11194,11 @@ function createPlugin({
     onTemplateSet,
     onTemplateUpdate,
     onTemplateDelete,
+    onBeforePageRender,
     onAfterPageRender,
-    onBuildComplete,
-    script,
+    onBeforeBuild,
+    onAfterBuild,
+    client,
     server
   };
 }