@dosgato/templating 0.0.77 → 0.0.79

package/dist/component.d.ts

@@ -73,7 +73,37 @@ export declare abstract class Component<DataType extends ComponentData = any, Fe
      * The inherited components will be added to the appropriate area's array in the renderedAreas
      * parameter of your render function.
      */
-    registerInherited: (area: string, components: ComponentData[], fromPageId: string, top?: true) => void;
+    registerInherited: (
+    /**
+     * The area in which to place the inherited components. It doesn't matter where you found them.
+     */
+    area: string, 
+    /**
+     * An array of components to add to the area.
+     */
+    components: ComponentData[], 
+    /**
+     * The page id of the page these components came from.
+     *
+     * If you are providing components from different pages, you may pass an array
+     * that corresponds index-for-index with the components array you provided.
+     *
+     * Generally you would only need to do this when you are using 'replace' mode, as with
+     * 'top' or 'bottom' you could just call registerInherited once per page you're
+     * inheriting from.
+     */
+    fromPageId: string | string[], 
+    /**
+     * How to place the inherited components into the area.
+     *
+     * 'top' to place these inherited components at the top of the area.
+     * 'bottom' to place them at the bottom of the area.
+     * 'replace' to remove all existing components (inherited or not) in the area and
+     * use these instead.
+     *
+     * Default is 'top'.
+     */
+    mode?: 'top' | 'bottom' | 'replace') => void;
     /**
      * The second phase of rendering a component is the context phase. This step is TOP-DOWN and
      * NON-MUTATING. Each component will receive the parent component's context and then pass a

package/dist/render.d.ts

@@ -129,16 +129,45 @@ export interface APIClient {
      * Get a hierarchical tree of pages suitable for generating a navigation
      * UI for your template.
      *
-     * Returns the root page. Subpages are inside the `children` property.
-     *
-     * "extra" is a list of dot-separated paths to page data that you need to help you build
-     * your interface. For example, ['hideInNav'] would fill page.extra with { hideInNav: true }.
+     * Returns the root page(s). Subpages are inside the `children` property.
      */
-    getNavigation: ({ depth, extra, absolute }: {
+    getNavigation: ({ beneath, depth, extra, absolute }: {
+        /**
+         * Return pages beneath this path
+         *
+         * For instance, if you set this to '/site1' you will get back ['/site1/about',
+         * '/site1/history', '/site1/history/traditions', ...etc]
+         *
+         * If you do not set `beneath`, you will get back an array that contains only
+         * the root page of the pagetree you are in.
+         */
+        beneath?: string;
+        /**
+         * Return pages to the given depth
+         *
+         * This is relative to `beneath`, so if `beneath` is '/site1' and `depth` is 0 you
+         * will get '/site1/history' and not '/site1/history/traditions'
+         *
+         * If you do not provide a `beneath`, `depth` 0 will get you the root page, 1 will get
+         * you the root page and one level of subpages, etc.
+         */
         depth?: number;
+        /**
+         * Get extra data from the page data
+         *
+         * Returning the full page data for a whole tree of pages would be an extreme amount of
+         * transfer, but if you need some of the data, you can specify an array of dot-separated
+         * paths to retrieve from it.
+         *
+         * For example, ['hideInNav'] would get you { extra: { hideInNav: tru } } in each returned
+         * page record.
+         */
         extra?: string[];
+        /**
+         * The `href` property in the returned records should be an absolute URL.
+         */
         absolute?: boolean;
-    }) => Promise<PageForNavigation>;
+    }) => Promise<PageForNavigation[]>;
     /**
      * Get data entries by link or folder link
      *

package/package.json

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