@dosgato/templating 0.0.83 → 0.0.85

package/dist/render.d.ts

@@ -1,7 +1,7 @@
 import { ContextBase, DataData, PageData, PageRecord, PageRecordOptionalData } from './component.js';
 import { AssetLink, DataFolderLink, DataLink, LinkDefinition, PageLink } from './links.js';
-export declare function printHeader(ctx: ContextBase, content: string): string;
-export declare function advanceHeader(ctx: ContextBase, content?: string): {
+export declare function printHeader(ctx: ContextBase, content: string | undefined | null, attributes?: Record<string, string>): string;
+export declare function advanceHeader(ctx: ContextBase, content: string | undefined | null): {
     headerLevel: number;
 };
 export interface PictureResize {

package/dist/render.js

@@ -1,13 +1,14 @@
-import { isBlank } from 'txstate-utils';
-export function printHeader(ctx, content) {
+import { htmlEncode, isBlank } from 'txstate-utils';
+export function printHeader(ctx, content, attributes) {
     if (isBlank(content))
         return '';
     const level = (ctx.headerLevel ?? 0) + 1;
+    const attr = attributes ? ' ' + Object.entries(attributes).map(([key, val]) => `${key}="${htmlEncode(val)}"`).join(' ') : '';
     if (level < 1)
-        return `<h1>${content}</h1>`;
+        return `<h1${attr}>${content}</h1>`;
     if (level > 6)
-        return `<h6>${content}</h1>`;
-    return `<h${level}>${content}</h${level}>`;
+        return `<h6${attr}>${content}</h6>`;
+    return `<h${level}${attr}>${content}</h${level}>`;
 }
 export function advanceHeader(ctx, content) {
     const ret = { ...ctx };

package/dist/uitemplate.d.ts

@@ -1,4 +1,4 @@
-import { ComponentData } from './component.js';
+import { ComponentData, PageData } from './component.js';
 interface IconifyIcon {
     body: string;
     rotate?: number;
@@ -26,9 +26,16 @@ export interface UITemplate {
      * - creating: boolean, true when creating component for the first time, false when editing
      * - data: ComponentData, the current data on the page, should not be mutated during editing,
      *   undefined when creating
+     * - page: DialogPageProp, the current page so that you can reference the full page data or
+     *   make a further graphql query based on its id/path. Component dialogs only, page and data
+     *   dialogs do not receive this prop
      * - templateProperties: the template properties for the current page template, so you can make
-     *   things like color pickers that visually match the colors of the current page template
+     *   things like color pickers that visually match the colors of the current page template.
+     *   Data dialogs do not receive this.
      * - environmentConfig: base URLs in case you need to generate a link to the API or something
+     *
+     * In addition to the props, you may import the `dialogQuery` function (see below) to send
+     * requests to the API.
      */
     dialog?: new (...args: any[]) => any;
     /**
@@ -60,4 +67,18 @@ export interface UITemplate {
      */
     icon?: IconOrSVG;
 }
+/**
+ * This is a type for the data that will be passed to dialog Svelte components as
+ * the `page` prop. Note that page template dialogs do NOT receive this prop.
+ */
+export interface DialogPageProp {
+    id: string;
+    path: string;
+    data: PageData;
+}
+/**
+ * A function you may use in your dialogs to make an authenticated graphql request to the DosGato
+ * API.
+ */
+export declare function dialogQuery<T = any>(query: string, variables: any): Promise<T>;
 export {};

package/dist/uitemplate.js

@@ -1 +1,7 @@
-export {};
+/**
+ * A function you may use in your dialogs to make an authenticated graphql request to the DosGato
+ * API.
+ */
+export async function dialogQuery(query, variables) {
+    return await window.api.query(query, variables);
+}

package/package.json

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