@tempots/dom 23.0.2 → 24.0.0-next.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tempots/dom",
-  "version": "23.0.2",
+  "version": "24.0.0-next.1",
   "type": "module",
   "main": "./index.cjs",
   "module": "./index.js",

package/renderable/domnode.d.ts

@@ -1,3 +1,4 @@
+import { BrowserContext } from '../dom/browser-context';
 import { Renderable } from '../types/domain';
 /**
  * Creates a renderable DOM node.
@@ -7,4 +8,4 @@ import { Renderable } from '../types/domain';
  * @returns A function that can be called to remove the rendered node from the DOM.
  * @public
  */
-export declare const DOMNode: (node: Node) => Renderable;
+export declare const DOMNode: (node: Node) => Renderable<BrowserContext>;

package/renderable/element.d.ts

@@ -158,19 +158,19 @@ export declare const input: {
     number: (...children: TNode[]) => Renderable;
     text: (...children: TNode[]) => Renderable;
     color: (...children: TNode[]) => Renderable;
-    image: (...children: TNode[]) => Renderable;
+    hidden: (...children: TNode[]) => Renderable;
     button: (...children: TNode[]) => Renderable;
     search: (...children: TNode[]) => Renderable;
     time: (...children: TNode[]) => Renderable;
+    image: (...children: TNode[]) => Renderable;
+    reset: (...children: TNode[]) => Renderable;
+    submit: (...children: TNode[]) => Renderable;
     checkbox: (...children: TNode[]) => Renderable;
     radio: (...children: TNode[]) => Renderable;
     file: (...children: TNode[]) => Renderable;
     password: (...children: TNode[]) => Renderable;
-    submit: (...children: TNode[]) => Renderable;
-    reset: (...children: TNode[]) => Renderable;
     date: (...children: TNode[]) => Renderable;
     range: (...children: TNode[]) => Renderable;
-    hidden: (...children: TNode[]) => Renderable;
     month: (...children: TNode[]) => Renderable;
     week: (...children: TNode[]) => Renderable;
     email: (...children: TNode[]) => Renderable;

package/renderable/on-browser-ctx.d.ts

@@ -0,0 +1,10 @@
+import { BrowserContext } from '../dom/browser-context';
+import { Clear, Renderable } from '../types/domain';
+/**
+ * Returns a renderable function that executes the given function with the current DOMContext as argument.
+ *
+ * @param fn - The function to be executed with the DOMContext argument.
+ * @returns A Clear function that can be used to clean up any resources associated with the execution.
+ * @public
+ */
+export declare const OnBrowserCtx: (fn: (ctx: BrowserContext) => Clear) => Renderable;

package/renderable/{onunmount.d.ts → on-dispose.d.ts}

@@ -6,4 +6,4 @@ import { DOMContext } from '../dom/dom-context';
  * @returns A renderable function that takes a DOMContext and returns a function that takes a boolean indicating whether to remove the tree.
  * @public
  */
-export declare const OnUnmount: (fn: (removeTree: boolean, ctx: DOMContext) => void) => Renderable;
+export declare const OnDispose: (fn: (removeTree: boolean, ctx: DOMContext) => void) => Renderable;

package/renderable/{onmount.d.ts → on-element.d.ts}

@@ -7,4 +7,4 @@ import { Clear, Renderable } from '../types/domain';
  * @returns - The renderable function.
  * @public
  */
-export declare const OnMount: <T extends Element>(fn: (element: T) => Clear | undefined | void) => Renderable;
+export declare const OnElement: <T extends HTMLElement>(fn: (element: T) => Clear | undefined | void) => Renderable;

package/renderable/on-headless-ctx.d.ts

@@ -0,0 +1,10 @@
+import { HeadlessContext } from '../dom/headless-context';
+import { Clear, Renderable } from '../types/domain';
+/**
+ * Returns a renderable function that executes the given function with the current DOMContext as argument.
+ *
+ * @param fn - The function to be executed with the DOMContext argument.
+ * @returns A Clear function that can be used to clean up any resources associated with the execution.
+ * @public
+ */
+export declare const OnHeadlessCtx: (fn: (ctx: HeadlessContext) => Clear) => Renderable;

package/renderable/probe.d.ts

@@ -0,0 +1,46 @@
+import { Renderable, TNode } from '../types/domain';
+/**
+ * A provider mark for a signal representing the current appearance type.
+ * @public
+ */
+export declare const probeMarker: import('../types/domain').ProviderMark<(identifier: symbol) => void>;
+/**
+ * Provides a child component with a probe, which can be used to trigger a callback when all probes with the same identifier are resolved.
+ * To resolve a probe, call the `done` function passed using the `UseProbe` renderable.
+ *
+ * @param identifier - The identifier for the probe.
+ * @param callback - The callback to be triggered when the probe is no longer needed.
+ * @param child - The child component to be provided with the probe.
+ * @returns The child component with the probe.
+ * @public
+ */
+export declare const ProvideProbe: (identifier: symbol, callback: () => void, child: TNode) => Renderable;
+/**
+ * Uses a probe, which can be used to trigger a callback when all probes with the same identifier are resolved.
+ * To resolve a probe, call the `done` function.
+ *
+ * @param identifier - The identifier for the probe.
+ * @param fn - The callback to be triggered when the probe is no longer needed.
+ * @returns The child component with the probe.
+ * @public
+ */
+export declare const UseProbe: (identifier: symbol, fn: (done: () => void) => TNode) => Renderable;
+/**
+ * Provides a global probe, which can be used to trigger a callback when all probes with the same identifier are resolved.
+ * To resolve a probe, call the `done` function passed using the `UseProbe` renderable.
+ *
+ * @param callback - The callback to be triggered when the probe is no longer needed.
+ * @param child - The child component to be provided with the probe.
+ * @returns The child component with the probe.
+ * @public
+ */
+export declare const ProvideGlobalProbe: (callback: () => void, child: TNode) => Renderable;
+/**
+ * Uses a global probe, which can be used to trigger a callback when all probes with the same identifier are resolved.
+ * To resolve a probe, call the `done` function.
+ *
+ * @param fn - The callback to be triggered when the probe is no longer needed.
+ * @returns The child component with the probe.
+ * @public
+ */
+export declare const UseGlobalProbe: (fn: (done: () => void) => TNode) => Renderable;

package/renderable/render.d.ts

@@ -1,5 +1,7 @@
 import { Renderable } from '../types/domain';
 import { DOMContext } from '../dom/dom-context';
+import { HeadlessPortal } from '../dom/headless-context';
+import { Value } from '../std/value';
 /**
  * Renders the given `renderable` with the provided `ctx` DOM context.
  *
@@ -34,6 +36,14 @@ export type RenderOptions = {
  * @public
  */
 export declare const render: (node: Renderable, parent: Node | string, { doc, clear }?: RenderOptions) => () => void;
+export declare const runHeadless: (makeRenderable: () => Renderable, { startUrl, selector, }?: {
+    startUrl?: Value<string>;
+    selector?: string;
+}) => {
+    clear: () => void;
+    root: HeadlessPortal;
+    currentURL: import('..').Prop<string>;
+};
 /**
  * Represents an error that occurs during rendering.
  * @public

package/types/domain.d.ts

@@ -6,7 +6,7 @@ import { Value } from '../std/value';
  * @returns A function that clears the rendered content.
  * @public
  */
-export type Renderable = (ctx: DOMContext) => Clear;
+export type Renderable<CTX extends DOMContext = DOMContext> = (ctx: CTX) => Clear;
 /**
  * Represents a node in the rendering tree.
  * It can be a renderable element, a string value, undefined, null, or an array of renderable elements.

package/dom/ssr.d.ts

@@ -1,50 +0,0 @@
-import { TNode, Renderable } from '../types/domain';
-import { DOMContext } from './dom-context';
-/**
- * @internal
- */
-export declare const _maybeAddAttributeTracker: (ctx: DOMContext, name: string) => void;
-/**
- * @internal
- */
-export declare const _maybeAddClassTracker: (ctx: DOMContext) => void;
-/**
- * @internal
- */
-export declare const _addNodeTracker: (element: Element) => void;
-/**
- * @internal
- */
-export declare const _maybeAddTextTracker: (ctx: DOMContext) => void;
-export declare const removeTextTrackers: (doc: Document) => void;
-/**
- * @internal
- */
-export declare const _clearSSR: (doc: Document) => void;
-/**
- * Prepares for server-side rendering (SSR) by setting a timeout. The returned
- * promise resolves when all the `useSSRDone` calls have been completed.
- *
- * @param timeoutSeconds - The timeout duration in seconds (default: 30 seconds).
- * @returns A promise that resolves when all useSSRDone calls have been completed.
- * @public
- */
-export declare const prepareSSR: (timeoutSeconds?: number) => Promise<void>;
-/**
- * Provides a way to signal that a renderable has been rendered on the server.
- * Multiple ussSSRDone calls can be made in parallel, and the promise returned
- * by `prepareSSR` will resolve when all the `useSSRDone` calls have been completed.
- *
- * @param child - A function that takes a `done` callback and returns a `TNode`.
- * @returns A renderable value.
- * @public
- */
-export declare const UseSSRDone: (child: (done: () => void) => TNode) => Renderable;
-/**
- * Checks if the code is running on the server-side (SSR - Server-Side Rendering).
- * The flag is set by running the `prepareSSR` function.
- *
- * @returns Returns true if the code is running on the server-side, false otherwise.
- * @public
- */
-export declare const isSSR: () => boolean;