@dosgato/templating 0.0.143 → 0.0.144

package/dist/apitemplate.d.ts

@@ -91,6 +91,16 @@ export interface APITemplate<DataType> {
      * can be done by the routine that calls `getFulltext`.
      */
     getFulltext?: FulltextGatheringFn<DataType>;
+    /**
+     * Extra filters for this template
+     *
+     * Use this function to return arbitrary tags for your template. These tags will be indexed
+     * and may be used later as a search filter.
+     *
+     * For example, pages may set a 'shownInNav' tag and this could be passed to the getNavigation
+     * function during rendering to return a smaller set of pages for navigation.
+     */
+    getTags?: FulltextGatheringFn<DataType>;
     /**
      * The available component list in the main content area can get very long, among others. Therefore, each
      * template may set a displayCategory and any templates that share a displayCategory will be grouped together

package/dist/provider.js

@@ -8,7 +8,7 @@
  *
  * If you do this, don't forget to register the provider along with your templates!
  */
-class ResourceProvider {
+export class ResourceProvider {
     static webpath(name) { return this.webpaths.get(name); }
 }
 /**
@@ -86,4 +86,3 @@ ResourceProvider.files = new Map();
  * `<img src="${TemplateClass.webpath('keyname')}">`
  */
 ResourceProvider.webpaths = new Map();
-export { ResourceProvider };

package/dist/render.d.ts

@@ -282,6 +282,29 @@ export interface APIClient {
          * The `href` property in the returned records should be an absolute URL.
          */
         absolute?: boolean;
+        /**
+         * Set a filter to use while building the navigation tree, to limit the amount of pages
+         * returned.
+         *
+         * For example, if pages have a `hideInNav` property, you could check that here to avoid
+         * returning pages that are supposed to be hidden.
+         *
+         * You could always do this yourself after getting the full results, but it will improve
+         * performance to do it earlier.
+         */
+        filter?: (page: PageForNavigation) => boolean | undefined;
+        /**
+         * Filter for a specific tag as returned by the template's getTags function in the API
+         * template definition.
+         */
+        tagsAny?: string[];
+        /**
+         * Set a maximum number of children to be displayed in the menu per page.
+         *
+         * For instance, if you set it to 8, no page returned will have more than 8 children. Page
+         * order will determine which 8 make the cut.
+         */
+        maxChildren?: number;
     }) => Promise<PageForNavigation[]>;
     /**
      * Get data entries by link or folder link

package/package.json

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