@dosgato/templating 0.0.5 → 0.0.6

package/dist/provider.d.ts

@@ -1,3 +1,20 @@
+export interface CSSBlock {
+    css?: string;
+    path?: string;
+    version?: string;
+    defer?: boolean;
+}
+export interface JSBlock {
+    js?: string;
+    path?: string;
+    version?: string;
+    defer?: boolean;
+}
+export interface FileDeclaration {
+    path: string;
+    version?: string;
+    mime: string;
+}
 /**
  * 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
@@ -20,22 +37,23 @@ export declare abstract class ResourceProvider {
      * version number of any given name will be used. Other versions of that name will be ignored.
      *
      * For convenience you can either provide the `css` property with the CSS as a string, or the
-     * `path` property with the full server path to a CSS file (node's __dirname function will
+     * `path` property with the full server path (NOT URL) to a CSS file (node's __dirname function will
      * help you determine it). You MUST provide one or the other.
+     *
+     * You may also set `defer` to true if a css block is not needed for the initial render of
+     * the page. For instance, if your component has a modal that the user can trigger, you can
+     * defer the CSS for that modal since it will not be needed until the page has gone interactive
+     * and the user has clicked something.
      */
-    static cssBlocks: Map<string, {
-        css?: string;
-        path?: string;
-        version?: string;
-    }>;
+    static cssBlocks: Map<string, CSSBlock>;
     /**
      * Same as cssBlocks() but for javascript.
+     *
+     * In this case `defer` is much more useful, as most javascript is interactive and could run
+     * after the page renders. Any code that adds event observers or the like should be marked with
+     * defer to improve the initial render time.
      */
-    static jsBlocks: Map<string, {
-        js?: string;
-        path?: string;
-        version?: string;
-    }>;
+    static jsBlocks: Map<string, JSBlock>;
     /**
      * If your template needs to serve any files, like fonts or images, you can provide
      * a filesystem path in this static property and the files will be served by the rendering
@@ -58,11 +76,7 @@ export declare abstract class ResourceProvider {
      * DO NOT change the mime type without changing the name. Other templates could end up with
      * the wrong file extension.
      */
-    static files: Map<string, {
-        path: string;
-        version?: string;
-        mime: string;
-    }>;
+    static files: Map<string, FileDeclaration>;
     /**
      * Template code will need to generate HTML and CSS that points at the static files
      * provided above. In order to do so, we need information from the template registry (since

package/dist/provider.js

@@ -27,12 +27,21 @@ exports.ResourceProvider = ResourceProvider;
  * version number of any given name will be used. Other versions of that name will be ignored.
  *
  * For convenience you can either provide the `css` property with the CSS as a string, or the
- * `path` property with the full server path to a CSS file (node's __dirname function will
+ * `path` property with the full server path (NOT URL) to a CSS file (node's __dirname function will
  * help you determine it). You MUST provide one or the other.
+ *
+ * You may also set `defer` to true if a css block is not needed for the initial render of
+ * the page. For instance, if your component has a modal that the user can trigger, you can
+ * defer the CSS for that modal since it will not be needed until the page has gone interactive
+ * and the user has clicked something.
  */
 ResourceProvider.cssBlocks = new Map();
 /**
  * Same as cssBlocks() but for javascript.
+ *
+ * In this case `defer` is much more useful, as most javascript is interactive and could run
+ * after the page renders. Any code that adds event observers or the like should be marked with
+ * defer to improve the initial render time.
  */
 ResourceProvider.jsBlocks = new Map();
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dosgato/templating",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "A library to support building templates for dosgato CMS.",
   "exports": {
     "require": "./dist/index.js",