dothtml-interfaces 1.0.0 → 6.0.5

package/package.json

@@ -1,12 +1,21 @@
 {
   "name": "dothtml-interfaces",
-  "version": "1.0.0",
+  "version": "6.0.5",
   "description": "Dependency injection interfaces for DOTHtml.",
   "main": "src/index.ts",
   "types": "src/index.ts",
   "scripts": {},
-  "author": "",
+  "author": "Joshua Sideris",
   "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JSideris/DOThtml.git",
+    "directory": "packages/interfaces"
+  },
+  "homepage": "https://dothtml.org/",
+  "bugs": {
+    "url": "https://github.com/JSideris/DOThtml/issues"
+  },
   "devDependencies": {
     "typescript": "^5.3.2"
   },

package/src/bindings/i-ref.ts

@@ -1,5 +1,9 @@
 import { IWatcher } from "./i-watcher";
+import { DotContent } from "../i-dot";
 
 export interface IRef<T = any> extends IWatcher<T | null> {
 	get element(): T;
+	ready(): Promise<T>;
+	append(content: DotContent): this;
+	prepend(content: DotContent): this;
 }

package/src/i-dot.ts

@@ -8,7 +8,7 @@ import { IWatcher } from "./bindings/i-watcher";
 import IDotcssProp from "./styles/i-css-prop";
 import { IRef } from "./bindings/i-ref";
 
-type DotContentPrimitive = string | number | boolean | undefined | null;
+export type DotContentPrimitive = string | number | boolean | undefined | null;
 type DotContentBasic = DotContentPrimitive | Node | Element | NodeList | IDotComponent | IDotDocument//typeof DotDocument;
 export type DotContent = DotContentBasic | Array<DotContent> | IReactive;//|(()=>DotContent);
 
@@ -37,9 +37,9 @@ export interface IDotDocument {
 	/**
 	 * Cast any document to any other element type. This can be used to access attributes when dotHTML doesn't know the type.
 	 * @example
-	 * dot("#my-input").as(dot.input).value("Hello, world!")
+	 * dot("#my-input").as(dot.input).attr("value", "Hello, world!")
 	 * @example
-	 * dot.h("<a>Click me!</a>").as(dot.a).hRef("https://dothtml.com/")
+	 * dot.h("<a>Click me!</a>").as(dot.a).attr("href", "https://dothtml.com/")
 	*/
 	as<T extends IDotDocument>(dotElement: (...props: any[]) => T): T;
 	/**
@@ -51,19 +51,27 @@ export interface IDotDocument {
 	/**
 	 * Creates a generic HTML node that can render a string, HTML nodes, or dotHTML content.
 	*/
-	html(content: string | number | boolean | IReactive): IDotDocument;
+	html(content: DotContentPrimitive | IReactive): IDotDocument;
 	/**
 	 * Creates a text node that will render as a string, rather than being parsed as markup.
 	*/
-	text(content: string | number | boolean | IReactive): IDotDocument;
+	text(content: DotContentPrimitive | IReactive): IDotDocument;
 	/**
 	 * Creates a text node that will render as a string, rather than being parsed as markup.
 	*/
-	md(content: string | number | boolean | IReactive): IDotDocument;
+	md(content: DotContentPrimitive | IReactive): IDotDocument;
 	/**
-	 * Mounts a component.
+	 * Mounts a component or appends content.
 	 */
-	mount<T extends IDotComponent>(component: T, ...args: any[]): IDotDocument;
+	mount(content: DotContent, ...args: any[]): IDotDocument;
+	/**
+	 * Appends content to the current document.
+	 */
+	append(content: DotContent): this;
+	/**
+	 * Prepends content to the current document.
+	 */
+	prepend(content: DotContent): this;
 	slot(name?: string | any, fallback?: any): IDotDocument;
 	// mount<T extends IComponent>(init: (c: IMountedComponent<T>) => IMountedComponent<T> | void, component: T): IDotDocument;
 	// mount(component: IComponent, init: (init=>IMountedComponent): IMountedComponent|void): IDotDocument;
@@ -87,7 +95,6 @@ export interface IDotDocument {
 	remove(): void;
 
 	style(c: string | ISignal<any> | IBinding<any, any> | IDotCss | ((s: IDotCss) => void)): this;
-	class(name: string, condition?: any): this;
 	attr(name: string, value: any): this;
 	on(event: string, callback: (e: any) => void): this;
 	onEnter(callback: (el: HTMLElement) => void): this;