@dosgato/templating 1.0.9 → 1.1.0

package/dist/apitemplate.d.ts

@@ -34,15 +34,27 @@ export interface PageExtras {
     linkId?: string;
     /** The name the page has or will have. NOTE: looking the page up by name will not work during page creation. */
     name: string;
+    /**
+     * The full page data before the validation/migration in case validating depends on the previous
+     * state of the page.
+     *
+     * Will be undefined during page creations, and equal to the data already being passed to a migration.
+     */
+    page?: PageData;
 }
 export interface ComponentExtras extends PageExtras {
+    /** The path within the page data to the component currently being evaluated. */
+    path: string;
     /**
-     * The full page data in case validating or migrating a component depends on state
+     * The full page data before the validation/migration in case validating depends on state
      * elsewhere in the page.
      */
     page: PageData;
-    /** The path within the page data to the component currently being evaluated. */
-    path: string;
+    /**
+     * The component data before validation. Will be present during migration but equal to the
+     * data already being passed to the migration.
+     */
+    currentData: ComponentData;
 }
 export interface DataExtras {
     /** A function for executing a graphql query to acquire more information than is already at hand. */

package/dist/component.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 import type { IncomingHttpHeaders } from 'http';
 import type { ParsedUrlQuery } from 'querystring';
 import { ResourceProvider } from './provider.js';
@@ -89,7 +87,7 @@ export declare abstract class Component<DataType extends ComponentData = any, Fe
      * The extension will NOT include the preceding dot. In the case of an extended extension like
      * '.js.map', you should receive 'js.map'.
      */
-    shouldFetchVariation(extension: string): boolean;
+    shouldFetchVariation(extension: string): extension is "html";
     /**
      * Some components may be inheritable to subpages within the same site. For instance, a site's
      * social media links may appear on every page's footer. To accomplish this in your template,
@@ -280,6 +278,11 @@ export declare abstract class Component<DataType extends ComponentData = any, Fe
      * Its edit bar will not have a pencil icon.
      */
     noData: boolean;
+    /**
+     * Override with `true` to indicate that this template renders its own edit bar
+     * so that the parent component will avoid rendering it
+     */
+    renderIncludesEditBar: boolean;
     /**
      * Components may override this function to give their new bars a custom
      * label

package/dist/component.js

@@ -122,11 +122,13 @@ export class Component extends ResourceProvider {
                 return opts.skipContent ? '' : wrap({ ...c, content: c.output, bar: '', indexInArea, siblings });
             }
             else {
-                const bar = c.component.editBar({
-                    ...opts?.editBarOpts,
-                    label: typeof opts?.editBarOpts?.label === 'function' ? opts.editBarOpts.label(c.component) : opts?.editBarOpts?.label,
-                    extraClass: typeof opts?.editBarOpts?.extraClass === 'function' ? opts.editBarOpts.extraClass(c.component) : opts?.editBarOpts?.extraClass
-                });
+                const bar = c.component.renderIncludesEditBar
+                    ? ''
+                    : c.component.editBar({
+                        ...opts?.editBarOpts,
+                        label: typeof opts?.editBarOpts?.label === 'function' ? opts.editBarOpts.label(c.component) : opts?.editBarOpts?.label,
+                        extraClass: typeof opts?.editBarOpts?.extraClass === 'function' ? opts.editBarOpts.extraClass(c.component) : opts?.editBarOpts?.extraClass
+                    });
                 const content = opts?.skipContent ? '' : c.output;
                 return wrap({ output: bar + content, content, bar, component: c.component, indexInArea, siblings });
             }
@@ -245,6 +247,11 @@ export class Component extends ResourceProvider {
          * Its edit bar will not have a pencil icon.
          */
         this.noData = false;
+        /**
+         * Override with `true` to indicate that this template renders its own edit bar
+         * so that the parent component will avoid rendering it
+         */
+        this.renderIncludesEditBar = false;
         // Properties provided during the rendering process. You do not have to provide these when
         // building a template, but you can use them in the functions you do provide
         this.areas = new Map(); // a Map of area names and the array of hydrated components in each

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dosgato/templating",
-  "version": "1.0.9",
+  "version": "1.1.0",
   "description": "A library to support building templates for dosgato CMS.",
   "type": "module",
   "exports": {