dalila 1.9.2 → 1.9.4

package/dist/runtime/bind.d.ts

@@ -6,6 +6,7 @@
  *
  * @module dalila/runtime
  */
+import type { Component } from './component.js';
 export interface BindOptions {
     /**
      * Event types to bind (default: click, input, change, submit, keydown, keyup)
@@ -25,6 +26,10 @@ export interface BindOptions {
         /** Time-to-live (ms) per plan, refreshed on hit (0 disables cache). */
         ttlMs?: number;
     };
+    /** Component registry — accepts map `{ tag: component }` or array `[component]` */
+    components?: Record<string, Component> | Component[];
+    /** Error policy for component `ctx.onMount()` callbacks. Default: 'log'. */
+    onMountError?: 'log' | 'throw';
     /**
      * Internal flag — set by fromHtml for router/template rendering.
      * Skips HMR context registration but KEEPS d-ready/d-loading lifecycle.
@@ -41,7 +46,36 @@ export interface BindOptions {
 export interface BindContext {
     [key: string]: unknown;
 }
+/**
+ * Convenience alias: any object whose values are `unknown`.
+ * Use the generic parameter on `bind<T>()` / `autoBind<T>()` / `fromHtml<T>()`
+ * to preserve the concrete type at call sites while still satisfying internal
+ * look-ups that index by string key.
+ */
+export type BindData<T extends Record<string, unknown> = Record<string, unknown>> = T;
 export type DisposeFunction = () => void;
+export interface BindHandle {
+    (): void;
+    getRef(name: string): Element | null;
+    getRefs(): Readonly<Record<string, Element>>;
+}
+/**
+ * Set global defaults for all `bind()` / `mount()` calls.
+ *
+ * Options set here are merged with per-call options (per-call wins).
+ * Call with an empty object to reset.
+ *
+ * @example
+ * ```ts
+ * import { configure } from 'dalila/runtime';
+ *
+ * configure({
+ *   components: [FruitPicker],
+ *   onMountError: 'log',
+ * });
+ * ```
+ */
+export declare function configure(config: BindOptions): void;
 /**
  * Bind a DOM tree to a reactive context.
  *
@@ -65,7 +99,7 @@ export type DisposeFunction = () => void;
  * dispose();
  * ```
  */
-export declare function bind(root: Element, ctx: BindContext, options?: BindOptions): DisposeFunction;
+export declare function bind<T extends Record<string, unknown> = BindContext>(root: Element | string, ctx: T, options?: BindOptions): BindHandle;
 /**
  * Automatically bind when DOM is ready.
  * Useful for simple pages without a build step.
@@ -78,4 +112,15 @@ export declare function bind(root: Element, ctx: BindContext, options?: BindOpti
  * </script>
  * ```
  */
-export declare function autoBind(selector: string, ctx: BindContext, options?: BindOptions): Promise<DisposeFunction>;
+export declare function autoBind<T extends Record<string, unknown> = BindContext>(selector: string, ctx: T, options?: BindOptions): Promise<BindHandle>;
+/**
+ * Mount a component imperatively, or bind a selector to a view-model.
+ *
+ * Overload 1 — `mount(selector, vm, options?)`:
+ *   Shorthand for `bind(selector, vm, options)`.
+ *
+ * Overload 2 — `mount(component, target, props?)`:
+ *   Mount a component created with defineComponent() into a target element.
+ */
+export declare function mount<T extends object>(selector: string, vm: T, options?: BindOptions): BindHandle;
+export declare function mount(component: Component, target: Element, props?: Record<string, unknown>): BindHandle;