@dosgato/templating 0.0.48 → 0.0.51

package/dist/apitemplate.d.ts

@@ -20,10 +20,10 @@ export interface ValidationFeedback {
 export interface PageExtras {
     /** A function for executing a graphql query to acquire more information than is already at hand. */
     query: GraphQLQueryFn;
-    /** The site id in which the page lives or is being created. */
-    siteId: string;
-    /** The pagetree id in which the page lives or is being created. */
-    pagetreeId: string;
+    /** The site id in which the page lives or is being created. Null if we are validating creation of a site. */
+    siteId?: string;
+    /** The pagetree id in which the page lives or is being created. Null if we are validating creation of a site or pagetree. */
+    pagetreeId?: string;
     /** The page id of the page's parent or parent-to-be. Null if it is the root page of a pagetree. */
     parentId?: string;
     /** The page's id, presumably to be used in graphql queries. NOTE: will be null during page creation. */
@@ -73,13 +73,13 @@ export interface APITemplate {
      * can be indexed. Only fields that are links need to be returned. Links inside rich editor
      * text will be extracted automatically from any text returned by getFulltext (see below)
      */
-    getLinks: LinkGatheringFn;
+    getLinks?: LinkGatheringFn;
     /**
      * Each template must provide the text from any text or rich editor data it possesses, so that
      * the text can be decomposed into words and indexed for fulltext searches. Any text returned
      * by this function will also be scanned for links.
      */
-    getFulltext: FulltextGatheringFn;
+    getFulltext?: FulltextGatheringFn;
 }
 export interface APIComponentTemplate extends APITemplate {
     type: 'component';
@@ -113,19 +113,19 @@ export interface APIComponentTemplate extends APITemplate {
      * Typically this will start as an empty array and migrations will be added as the template
      * gets refactored.
      */
-    migrations: ComponentMigration[];
+    migrations?: ComponentMigration[];
 }
 export interface APIPageTemplate extends APITemplate {
     type: 'page';
     /**
      * Page areas are the same as components but are required.
      */
-    areas: Record<string, string[]>;
+    areas?: Record<string, string[]>;
     /**
      * Page template implementations do not receive a path like component templates do.
      */
     validate?: (data: PageData, extras: PageExtras) => Promise<ValidationFeedback[]>;
-    migrations: PageMigration[];
+    migrations?: PageMigration[];
     /**
      * Hard-coded properties that may be set on page templates to influence the rendering of
      * components on the page. For instance, a set of color choices that are customized for
@@ -145,7 +145,7 @@ export interface APIDataTemplate extends APITemplate {
      * null when it is a creation operation.
      */
     validate?: (data: ComponentData, extras: DataExtras) => Promise<ValidationFeedback[]>;
-    migrations: DataMigration[];
+    migrations?: DataMigration[];
 }
 export declare type APIAnyTemplate = APIComponentTemplate | APIPageTemplate | APIDataTemplate;
 /**

package/dist/render.d.ts

@@ -46,7 +46,10 @@ export interface APIClient {
      * method to convert a link, as input by a user, into a URL suitable for an href, or optionally
      * an absolute URL suitable for a backend http request or non-HTML document like an RSS feed.
      */
-    resolveLink: (link: string | LinkDefinition, absolute?: boolean) => Promise<string>;
+    resolveLink: (lnk: string | LinkDefinition, opts?: {
+        absolute?: boolean;
+        extension?: string;
+    }) => Promise<string>;
     /**
      * This function will be provided by the rendering server and should be used inside your fetch
      * method to prepare editor-provided HTML for rendering. It will do things like find and resolve

package/package.json

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