@bquery/bquery 1.2.0 → 1.3.0

package/dist/view/index.d.ts

@@ -101,99 +101,9 @@
  * });
  * ```
  */
-/**
- * Context object passed to binding expressions.
- */
-export type BindingContext = Record<string, unknown>;
-/**
- * Configuration options for mount.
- */
-export type MountOptions = {
-    /** Prefix for directive attributes (default: 'bq') */
-    prefix?: string;
-    /** Whether to sanitize bq-html content (default: true) */
-    sanitize?: boolean;
-};
-/**
- * Mounted view instance.
- */
-export type View = {
-    /** The root element */
-    el: Element;
-    /** The binding context */
-    context: BindingContext;
-    /** Update the context and re-render */
-    update: (newContext: Partial<BindingContext>) => void;
-    /** Destroy the view and cleanup effects */
-    destroy: () => void;
-};
-/**
- * Mounts a reactive view to an element.
- *
- * @param selector - CSS selector or Element
- * @param context - Binding context with signals, computed, and functions
- * @param options - Mount options
- * @returns The mounted View instance
- *
- * @security **WARNING:** Directive expressions (bq-text, bq-if, bq-on, etc.) are evaluated
- * using `new Function()` at runtime. This means:
- * - Template attributes must come from trusted sources only
- * - NEVER load templates containing bq-* attributes from user input or untrusted APIs
- * - If you must use external templates, validate/sanitize attribute values first
- *
- * @example
- * ```ts
- * import { mount } from 'bquery/view';
- * import { signal, computed } from 'bquery/reactive';
- *
- * const name = signal('World');
- * const greeting = computed(() => `Hello, ${name.value}!`);
- * const items = signal([
- *   { id: 1, text: 'Item 1' },
- *   { id: 2, text: 'Item 2' },
- * ]);
- *
- * const view = mount('#app', {
- *   name,
- *   greeting,
- *   items,
- *   addItem: () => {
- *     items.value = [...items.value, { id: Date.now(), text: 'New Item' }];
- *   },
- * });
- *
- * // Later, cleanup
- * view.destroy();
- * ```
- */
-export declare const mount: (selector: string | Element, context: BindingContext, options?: MountOptions) => View;
-/**
- * Creates a reactive template function.
- *
- * @param template - HTML template string
- * @returns A function that creates a mounted element with the given context
- *
- * @example
- * ```ts
- * import { createTemplate } from 'bquery/view';
- * import { signal } from 'bquery/reactive';
- *
- * const TodoItem = createTemplate(`
- *   <li bq-class="{ completed: done }">
- *     <input type="checkbox" bq-model="done" />
- *     <span bq-text="text"></span>
- *   </li>
- * `);
- *
- * const item = TodoItem({
- *   done: signal(false),
- *   text: 'Buy groceries',
- * });
- *
- * document.querySelector('#list').append(item.el);
- * ```
- */
-export declare const createTemplate: (template: string, options?: MountOptions) => ((context: BindingContext) => View);
+export { clearExpressionCache } from './evaluate';
+export { createTemplate, mount } from './mount';
+export type { BindingContext, MountOptions, View } from './types';
 /**
  * Re-export reactive primitives for convenience.
  */

package/dist/view/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/view/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsGG;AASH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG;IACjB,uBAAuB;IACvB,EAAE,EAAE,OAAO,CAAC;IACZ,0BAA0B;IAC1B,OAAO,EAAE,cAAc,CAAC;IACxB,uCAAuC;IACvC,MAAM,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;IACtD,2CAA2C;IAC3C,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAywBF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,KAAK,GAChB,UAAU,MAAM,GAAG,OAAO,EAC1B,SAAS,cAAc,EACvB,UAAS,YAAiB,KACzB,IA8BF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,cAAc,GACzB,UAAU,MAAM,EAChB,UAAS,YAAiB,KACzB,CAAC,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAYpC,CAAC;AAMF;;GAEG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/view/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAElE;;GAEG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/view/mount.d.ts

@@ -0,0 +1,69 @@
+import type { BindingContext, MountOptions, View } from './types';
+/**
+ * Mounts a reactive view to an element.
+ *
+ * @param selector - CSS selector or Element
+ * @param context - Binding context with signals, computed, and functions
+ * @param options - Mount options
+ * @returns The mounted View instance
+ *
+ * @security **WARNING:** Directive expressions (bq-text, bq-if, bq-on, etc.) are evaluated
+ * using `new Function()` at runtime. This means:
+ * - Template attributes must come from trusted sources only
+ * - NEVER load templates containing bq-* attributes from user input or untrusted APIs
+ * - If you must use external templates, validate/sanitize attribute values first
+ *
+ * @example
+ * ```ts
+ * import { mount } from 'bquery/view';
+ * import { signal, computed } from 'bquery/reactive';
+ *
+ * const name = signal('World');
+ * const greeting = computed(() => `Hello, ${name.value}!`);
+ * const items = signal([
+ *   { id: 1, text: 'Item 1' },
+ *   { id: 2, text: 'Item 2' },
+ * ]);
+ *
+ * const view = mount('#app', {
+ *   name,
+ *   greeting,
+ *   items,
+ *   addItem: () => {
+ *     items.value = [...items.value, { id: Date.now(), text: 'New Item' }];
+ *   },
+ * });
+ *
+ * // Later, cleanup
+ * view.destroy();
+ * ```
+ */
+export declare const mount: (selector: string | Element, context: BindingContext, options?: MountOptions) => View;
+/**
+ * Creates a reactive template function.
+ *
+ * @param template - HTML template string
+ * @returns A function that creates a mounted element with the given context
+ *
+ * @example
+ * ```ts
+ * import { createTemplate } from 'bquery/view';
+ * import { signal } from 'bquery/reactive';
+ *
+ * const TodoItem = createTemplate(`
+ *   <li bq-class="{ completed: done }">
+ *     <input type="checkbox" bq-model="done" />
+ *     <span bq-text="text"></span>
+ *   </li>
+ * `);
+ *
+ * const item = TodoItem({
+ *   done: signal(false),
+ *   text: 'Buy groceries',
+ * });
+ *
+ * document.querySelector('#list').append(item.el);
+ * ```
+ */
+export declare const createTemplate: (template: string, options?: MountOptions) => ((context: BindingContext) => View);
+//# sourceMappingURL=mount.d.ts.map

package/dist/view/mount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../src/view/mount.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,KAAK,GAChB,UAAU,MAAM,GAAG,OAAO,EAC1B,SAAS,cAAc,EACvB,UAAS,YAAiB,KACzB,IA2EF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,cAAc,GACzB,UAAU,MAAM,EAChB,UAAS,YAAiB,KACzB,CAAC,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAiCpC,CAAC"}

package/dist/view/process.d.ts

@@ -0,0 +1,26 @@
+import type { CleanupFn } from '../reactive/index';
+import type { BindingContext, DirectiveHandler } from './types';
+export type DirectiveHandlers = {
+    text: DirectiveHandler;
+    html: DirectiveHandler;
+    if: DirectiveHandler;
+    show: DirectiveHandler;
+    class: DirectiveHandler;
+    style: DirectiveHandler;
+    model: DirectiveHandler;
+    ref: DirectiveHandler;
+    for: DirectiveHandler;
+    bind: (attrName: string) => DirectiveHandler;
+    on: (eventName: string) => DirectiveHandler;
+};
+/**
+ * Processes a single element for directives.
+ * @internal
+ */
+export declare const processElement: (el: Element, context: BindingContext, prefix: string, cleanups: CleanupFn[], handlers: DirectiveHandlers) => void;
+/**
+ * Recursively processes children of an element.
+ * @internal
+ */
+export declare const processChildren: (el: Element, context: BindingContext, prefix: string, cleanups: CleanupFn[], handlers: DirectiveHandlers) => void;
+//# sourceMappingURL=process.d.ts.map

package/dist/view/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/view/process.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,gBAAgB,CAAC;IACvB,EAAE,EAAE,gBAAgB,CAAC;IACrB,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,EAAE,gBAAgB,CAAC;IACxB,GAAG,EAAE,gBAAgB,CAAC;IACtB,GAAG,EAAE,gBAAgB,CAAC;IACtB,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,gBAAgB,CAAC;IAC7C,EAAE,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,gBAAgB,CAAC;CAC7C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GACzB,IAAI,OAAO,EACX,SAAS,cAAc,EACvB,QAAQ,MAAM,EACd,UAAU,SAAS,EAAE,EACrB,UAAU,iBAAiB,KAC1B,IAyCF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,IAAI,OAAO,EACX,SAAS,cAAc,EACvB,QAAQ,MAAM,EACd,UAAU,SAAS,EAAE,EACrB,UAAU,iBAAiB,KAC1B,IAWF,CAAC"}

package/dist/view/types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Public types for the view module.
+ */
+import type { CleanupFn } from '../reactive/index';
+/**
+ * Context object passed to binding expressions.
+ */
+export type BindingContext = Record<string, unknown>;
+/**
+ * Configuration options for mount.
+ */
+export type MountOptions = {
+    /** Prefix for directive attributes (default: 'bq') */
+    prefix?: string;
+    /** Whether to sanitize bq-html content (default: true) */
+    sanitize?: boolean;
+};
+/**
+ * Mounted view instance.
+ */
+export type View = {
+    /** The root element */
+    el: Element;
+    /** The binding context */
+    context: BindingContext;
+    /** Update the context object. Note: this only mutates the context; reactive re-rendering happens automatically when signals/computed values change. */
+    update: (newContext: Partial<BindingContext>) => void;
+    /** Destroy the view and cleanup effects */
+    destroy: () => void;
+};
+/**
+ * Internal directive handler type.
+ * @internal
+ */
+export type DirectiveHandler = (el: Element, expression: string, context: BindingContext, cleanups: CleanupFn[]) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/view/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/view/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG;IACjB,uBAAuB;IACvB,EAAE,EAAE,OAAO,CAAC;IACZ,0BAA0B;IAC1B,OAAO,EAAE,cAAc,CAAC;IACxB,uJAAuJ;IACvJ,MAAM,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;IACtD,2CAA2C;IAC3C,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,EAAE,EAAE,OAAO,EACX,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,SAAS,EAAE,KAClB,IAAI,CAAC"}