@dosgato/templating 0.0.19 → 0.0.22

package/dist/apitemplate.d.ts

@@ -1,5 +1,5 @@
-import { PageWithAncestors, ComponentData } from './component';
-import { LinkDefinition } from './links';
+import { PageWithAncestors, ComponentData } from './component.js';
+import { LinkDefinition } from './links.js';
 export declare type APITemplateType = 'page' | 'component' | 'data';
 /**
  * This interface lays out the structure the API needs for each template in the system.
@@ -90,3 +90,15 @@ export interface Migration {
 }
 export declare type LinkGatheringFn = (data: any) => LinkDefinition[];
 export declare type FulltextGatheringFn = (data: any) => string[];
+/**
+ * This function is used by API template definitions to help them identify links inside large blocks
+ * of text and return them for indexing.
+ */
+export declare function extractLinksFromText(text: string): LinkDefinition[];
+/**
+ * This function is used by API template definitions to help them identify all the searchable
+ * words in a large block of text and return them for indexing.
+ */
+export declare function getKeywords(text: string, options?: {
+    stopwords?: boolean;
+}): string[];

package/dist/apitemplate.js

@@ -1,2 +1,21 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+import { stopwords } from './stopwords.js';
+/**
+ * This function is used by API template definitions to help them identify links inside large blocks
+ * of text and return them for indexing.
+ */
+export function extractLinksFromText(text) {
+    const matches = text.matchAll(/{.*"type"\s?:\s+"\w+".*?}/gi);
+    return Array.from(matches).map(m => JSON.parse(m[0]));
+}
+/**
+ * This function is used by API template definitions to help them identify all the searchable
+ * words in a large block of text and return them for indexing.
+ */
+export function getKeywords(text, options) {
+    return Array.from(new Set(text
+        .toLocaleLowerCase()
+        .normalize('NFD').replace(/\p{Diacritic}/gu, '')
+        .split(/[^\w-]+/)
+        .flatMap(word => word.includes('-') ? word.split('-').concat(word.replace('-', '')) : [word])
+        .filter(word => word.length > 2 && (options?.stopwords === false || !stopwords[word]) && isNaN(Number(word)))));
+}

package/dist/component.d.ts

@@ -1,5 +1,6 @@
-import { EditBarOpts } from './editbar';
-import { ResourceProvider } from './provider';
+import { EditBarOpts } from './editbar.js';
+import { LinkDefinition } from './links.js';
+import { ResourceProvider } from './provider.js';
 /**
  * This is the primary templating class to build your templates. Subclass it and provide
  * at least a render function.
@@ -18,6 +19,19 @@ export declare abstract class Component<DataType extends ComponentData = any, Fe
     parent?: Component;
     page?: Page;
     hadError: boolean;
+    /**
+     * This function will be provided by the rendering server and should be used inside your fetch,
+     * 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>;
+    /**
+     * 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
+     * link definitions in the internal dosgato format and clean up tags that were accidentally left
+     * open to protect overall page integrity.
+     */
+    processRich: (text: string) => Promise<string>;
     /**
      * The first phase of rendering a component is the fetch phase. Each component may
      * provide a fetch method that looks up data it needs from external sources. This step
@@ -31,14 +45,14 @@ export declare abstract class Component<DataType extends ComponentData = any, Fe
      */
     fetch(editMode: boolean): Promise<FetchedType>;
     /**
-     * The second phase of rendering a component is the context phase. This step is TOP-DOWN,
-     * each component will receive the parent component's context, modify it as desired,
-     * and then pass context to its children.
+     * 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
+     * NEW context object to its children.
      *
      * This is useful for rendering logic that is sensitive to where the component exists in
      * the hierarchy of the page. For instance, if a parent component has used an h2 header
      * already, it will want to inform its children so that they can use h3 next, and they inform
-     * their children that h4 is next, and so on. (Header level tracking is actually required in
+     * their children that h4 is next, and so on. (Header level tracking is supported by default in
      * dosgato CMS.)
      *
      * This function may return a promise in case you need to do something asynchronous based on

package/dist/component.js

@@ -1,8 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Page = exports.Component = void 0;
-const editbar_1 = require("./editbar");
-const provider_1 = require("./provider");
+import { editBar, newBar } from './editbar.js';
+import { ResourceProvider } from './provider.js';
 /**
  * This is the primary templating class to build your templates. Subclass it and provide
  * at least a render function.
@@ -10,7 +7,7 @@ const provider_1 = require("./provider");
  * During rendering, it will be "hydrated" - placed into a full page structure with its
  * parent and child components linked.
  */
-class Component extends provider_1.ResourceProvider {
+export class Component extends ResourceProvider {
     // the constructor is part of the recursive hydration mechanism: constructing
     // a Component will also construct/hydrate all its child components
     constructor(data, path, parent) {
@@ -45,14 +42,14 @@ class Component extends provider_1.ResourceProvider {
         return undefined;
     }
     /**
-     * The second phase of rendering a component is the context phase. This step is TOP-DOWN,
-     * each component will receive the parent component's context, modify it as desired,
-     * and then pass context to its children.
+     * 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
+     * NEW context object to its children.
      *
      * This is useful for rendering logic that is sensitive to where the component exists in
      * the hierarchy of the page. For instance, if a parent component has used an h2 header
      * already, it will want to inform its children so that they can use h3 next, and they inform
-     * their children that h4 is next, and so on. (Header level tracking is actually required in
+     * their children that h4 is next, and so on. (Header level tracking is supported by default in
      * dosgato CMS.)
      *
      * This function may return a promise in case you need to do something asynchronous based on
@@ -150,7 +147,7 @@ class Component extends provider_1.ResourceProvider {
     editBar(opts = {}) {
         opts.label ?? (opts.label = this.editLabel());
         opts.extraClass ?? (opts.extraClass = this.editClass());
-        return (0, editbar_1.editBar)(this.path, opts);
+        return editBar(this.path, opts);
     }
     /**
      * Components may override this function to provide a custom new bar
@@ -160,11 +157,10 @@ class Component extends provider_1.ResourceProvider {
     newBar(areaName, opts = {}) {
         opts.label ?? (opts.label = this.newLabel(areaName));
         opts.extraClass ?? (opts.extraClass = this.newClass(areaName));
-        return (0, editbar_1.newBar)(this.path + '.' + areaName, opts);
+        return newBar(this.path + '.' + areaName, opts);
     }
 }
-exports.Component = Component;
-class Page extends Component {
+export class Page extends Component {
     constructor(page) {
         super(page.data, '/', undefined);
         this.pagePath = page.path;
@@ -174,4 +170,3 @@ class Page extends Component {
         console.warn(`Recoverable issue occured during render of ${this.pagePath}. Component at ${path} threw the following error:`, e);
     }
 }
-exports.Page = Page;

package/dist/editbar.js

@@ -1,28 +1,23 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.newBar = exports.editBar = void 0;
-const txstate_utils_1 = require("txstate-utils");
-function editBar(path, opts) {
+import { htmlEncode, randomid } from 'txstate-utils';
+export function editBar(path, opts) {
     if (!opts.editMode)
         return '';
-    const id = (0, txstate_utils_1.randomid)();
+    const id = randomid();
     return `
-<div class="dg-edit-bar ${opts.extraClass ?? ''}" data-path="${(0, txstate_utils_1.htmlEncode)(path)}" draggable="true" ondragstart="window.dgEditing.drag(event)" ondragover="window.dgEditing.over(event)" ondragend="window.dgEditing.drop(event)">
-  <span id="${id}" class="dg-edit-bar-label">${(0, txstate_utils_1.htmlEncode)(opts.label)}</span>
+<div class="dg-edit-bar ${opts.extraClass ?? ''}" data-path="${htmlEncode(path)}" draggable="true" ondragstart="window.dgEditing.drag(event)" ondragover="window.dgEditing.over(event)" ondragend="window.dgEditing.drop(event)">
+  <span id="${id}" class="dg-edit-bar-label">${htmlEncode(opts.label)}</span>
   <button onclick="window.dgEditing.edit(event)" aria-describedby="${id}">Edit</button>
   <button onclick="window.dgEditing.move(event)" aria-describedby="${id}">Move</button>
   <button onclick="window.dgEditing.del(event)" aria-describedby="${id}">Trash</button>
 </div>
   `.trim();
 }
-exports.editBar = editBar;
-function newBar(path, opts) {
+export function newBar(path, opts) {
     if (!opts.editMode)
         return '';
     return `
-<div role="button" onclick="window.dgEditing.create(event)" class="dg-new-bar ${opts.extraClass ?? ''}" data-path="${(0, txstate_utils_1.htmlEncode)(path)}">
-  ${(0, txstate_utils_1.htmlEncode)(opts.label)}
+<div role="button" onclick="window.dgEditing.create(event)" class="dg-new-bar ${opts.extraClass ?? ''}" data-path="${htmlEncode(path)}">
+  ${htmlEncode(opts.label)}
 </div>
   `.trim();
 }
-exports.newBar = newBar;

package/dist/index.d.ts

@@ -1,5 +1,7 @@
-export * from './apitemplate';
-export * from './component';
-export * from './links';
-export * from './provider';
-export * from './uitemplate';
+export * from './apitemplate.js';
+export * from './component.js';
+export * from './links.js';
+export * from './provider.js';
+export * from './render.js';
+export * from './stopwords.js';
+export * from './uitemplate.js';

package/dist/index.js

@@ -1,21 +1,7 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./apitemplate"), exports);
-__exportStar(require("./component"), exports);
-__exportStar(require("./links"), exports);
-__exportStar(require("./provider"), exports);
-__exportStar(require("./uitemplate"), exports);
+export * from './apitemplate.js';
+export * from './component.js';
+export * from './links.js';
+export * from './provider.js';
+export * from './render.js';
+export * from './stopwords.js';
+export * from './uitemplate.js';

package/dist/links.d.ts

@@ -63,15 +63,3 @@ export interface DataFolderLink {
     path: string;
 }
 export declare type LinkDefinition = AssetLink | AssetFolderLink | PageLink | WebLink | DataLink | DataFolderLink;
-/**
- * This function is used by API template definitions to help them identify links inside large blocks
- * of text and return them for indexing.
- */
-export declare function extractLinksFromText(text: string): LinkDefinition[];
-/**
- * This function is used by API template definitions to help them identify all the searchable
- * words in a large block of text and return them for indexing.
- */
-export declare function getKeywords(text: string, options?: {
-    stopwords?: boolean;
-}): string[];

package/dist/links.js

@@ -1,26 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getKeywords = exports.extractLinksFromText = void 0;
-const stopwords_1 = require("./stopwords");
-/**
- * This function is used by API template definitions to help them identify links inside large blocks
- * of text and return them for indexing.
- */
-function extractLinksFromText(text) {
-    const matches = text.matchAll(/{.*"type"\s?:\s+"\w+".*?}/gi);
-    return Array.from(matches).map(m => JSON.parse(m[0]));
-}
-exports.extractLinksFromText = extractLinksFromText;
-/**
- * This function is used by API template definitions to help them identify all the searchable
- * words in a large block of text and return them for indexing.
- */
-function getKeywords(text, options) {
-    return Array.from(new Set(text
-        .toLocaleLowerCase()
-        .normalize('NFD').replace(/\p{Diacritic}/gu, '')
-        .split(/[^\w-]+/)
-        .flatMap(word => word.includes('-') ? word.split('-').concat(word.replace('-', '')) : [word])
-        .filter(word => word.length > 2 && (options?.stopwords === false || !stopwords_1.stopwords[word]) && isNaN(Number(word)))));
-}
-exports.getKeywords = getKeywords;
+export {};

package/dist/provider.js

@@ -1,7 +1,4 @@
-"use strict";
 /* eslint-disable @typescript-eslint/no-extraneous-class */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ResourceProvider = void 0;
 /**
  * This class is a parent class for Component, but it can also be used as a standalone
  * if you are creating a set of templates with shared resources. This will be fairly
@@ -11,10 +8,9 @@ exports.ResourceProvider = void 0;
  *
  * 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); }
 }
-exports.ResourceProvider = ResourceProvider;
 /**
  * Each template should provide a map of CSS blocks where the map key is the unique name for
  * the CSS and the value is the CSS itself. For instance, if a template needs CSS from a

package/dist/render.d.ts

@@ -0,0 +1,5 @@
+import { ContextBase } from './component.js';
+export declare function printHeader(ctx: ContextBase, content: string): string;
+export declare function advanceHeader(ctx: ContextBase, content?: string): {
+    headerLevel: number;
+};

package/dist/render.js

@@ -0,0 +1,17 @@
+import { isBlank } from 'txstate-utils';
+export function printHeader(ctx, content) {
+    if (isBlank(content))
+        return '';
+    const level = (ctx.headerLevel ?? 0) + 1;
+    if (level < 1)
+        return `<h1>${content}</h1>`;
+    if (level > 6)
+        return `<h6>${content}</h1>`;
+    return `<h${level}>${content}</h${level}>`;
+}
+export function advanceHeader(ctx, content) {
+    const ret = { ...ctx };
+    if (!isBlank(content))
+        ret.headerLevel = (ret.headerLevel ?? 0) + 1;
+    return ret;
+}

package/dist/stopwords.js

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.stopwords = void 0;
-exports.stopwords = {
+export const stopwords = {
     myself: true,
     our: true,
     ours: true,

package/dist/uitemplate.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@dosgato/templating",
-  "version": "0.0.19",
+  "version": "0.0.22",
   "description": "A library to support building templates for dosgato CMS.",
+  "type": "module",
   "exports": {
-    "require": "./dist/index.js",
-    "import": "./dist-esm/index.js"
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
   },
   "types": "dist/index.d.ts",
   "scripts": {
@@ -36,6 +37,6 @@
   },
   "homepage": "https://github.com/txstate-etc/dosgato-templating#readme",
   "files": [
-    "dist", "dist-esm"
+    "dist"
   ]
 }

package/dist-esm/index.js

@@ -1,7 +0,0 @@
-import all from '../dist/index.js'
-
-export const ResourceProvider = all.ResourceProvider
-export const Component = all.Component
-export const Page = all.Page
-export const extractLinksFromText = all.extractLinksFromText
-export const getKeywords = all.getKeywords

package/dist-esm/package.json

@@ -1,3 +0,0 @@
-{
-  "type": "module"
-}