jtlt 0.13.0 → 0.14.0

package/dist/index.d.ts

@@ -36,7 +36,7 @@ export type TemplateObject<T, U, TCtx> = {
 };
 export type TemplateFunction<T, U, TCtx> = (this: TCtx, value: ResultType<U>, cfg?: {
     mode?: string;
-}) => ResultType<T> | void;
+}) => ResultType<T> | void | Promise<ResultType<T> | void>;
 export type JSONPathTemplateObject<T extends "json" | "string" | "dom"> = TemplateObject<T, "json", import('./JSONPathTransformerContext.js').default<T>>;
 export type XPathTemplateObject<T> = TemplateObject<T, "dom", import('./XPathTransformerContext.js').default>;
 export type XPathTemplateArray<T> = (XPathTemplateObject<T> | [
@@ -47,17 +47,50 @@ export type JSONPathTemplateArray<T extends "json" | "string" | "dom"> = JSONPat
     string,
     TemplateFunction<T, "json", import('./JSONPathTransformerContext.js').default>
 ];
-export type JoiningTransformer = (StringJoiningTransformer | DOMJoiningTransformer | JSONJoiningTransformer);
+export type JoiningTransformerContract = {
+    append: (item: unknown) => unknown;
+    get: () => unknown;
+    text?: (txt: string) => unknown;
+    string?: (str: unknown, cb?: () => void) => unknown;
+    number?: (num: unknown) => unknown;
+    object?: (obj: unknown, cb?: unknown, usePropertySets?: unknown, propSets?: unknown) => unknown;
+    array?: (arr: unknown, cb?: unknown) => unknown;
+    element?: (name: string, atts?: unknown, children?: unknown, cb?: unknown, useAttributeSets?: unknown) => unknown;
+    attribute?: (name: string, val: unknown, avoidAttEscape?: unknown) => unknown;
+    comment?: (text: string) => unknown;
+    processingInstruction?: (target: string, data: string) => unknown;
+    plainText?: (str: unknown) => unknown;
+    propValue?: (prop: unknown, val: unknown) => unknown;
+    rawAppend?: (item: unknown) => unknown;
+    namespace?: (prefix: string, namespaceURI: string) => unknown;
+    setContext?: (context: unknown) => unknown;
+    output?: (cfg: unknown) => unknown;
+    mode?: (cfg: unknown) => unknown;
+    stylesheet?: (cfg: unknown) => unknown;
+    function?: (cfg: unknown) => unknown;
+    invokeFunctionByArity?: (name: string, args?: unknown[]) => unknown;
+    characterMap?: (name: string, outputCharacters: unknown) => unknown;
+    attributeSet?: (name: string, attributes: unknown) => unknown;
+    namespaceAlias?: (stylesheetPrefix: string, resultPrefix: string) => unknown;
+};
+export type BuiltinJoiningTransformer = (StringJoiningTransformer | DOMJoiningTransformer | JSONJoiningTransformer);
+export type JoiningTransformer = BuiltinJoiningTransformer | JoiningTransformerContract;
 export type joiningTypes = "json" | "string" | "dom";
-export type ResultType<T, E extends boolean | undefined = false> = T extends "json" ? (E extends true ? any[] : unknown) : T extends "string" ? (E extends true ? string[] : string) : (E extends true ? XMLDocument[] : DocumentFragment | Element);
+export type ResultType<T, E extends boolean | undefined = false> = T extends "json" ? (E extends true ? unknown[] : unknown) : T extends "string" ? (E extends true ? string[] : string) : (E extends true ? XMLDocument[] : DocumentFragment | Element);
 export type BaseJTLTOptions<T, E extends boolean | undefined = false> = {
+    /**
+     * Off by default: the engine awaits any Promise a
+     * template returns (e.g. from `await this.indexedDB(...)`). Set `true` to
+     * forbid asynchrony — a template that returns a Promise then throws.
+     */
+    sync?: boolean;
     /**
      * A callback supplied
      * with a single argument that is the result of this instance's
      * transform() method. When used in TypeScript, this can be made
      * generic as `success<T>(result: T): void`.
      */
-    success: (result: ResultType<T, E>) => ResultType<T, E> | void;
+    success?: (result: ResultType<T, E>) => ResultType<T, E> | void;
     /**
      * A JSON
      * object or DOM document (XPath)
@@ -150,7 +183,7 @@ export type XPathJTLTOptions<T extends "json" | "string" | "dom", E extends bool
     xpathVersion?: 1 | 2 | 3.1;
     outputType?: T;
 };
-export type JTLTOptions<E extends boolean | undefined = any> = JSONPathJTLTOptions<"json", E> | JSONPathJTLTOptions<"string", E> | JSONPathJTLTOptions<"dom", E> | XPathJTLTOptions<"json", E> | XPathJTLTOptions<"string", E> | XPathJTLTOptions<"dom", E>;
+export type JTLTOptions<E extends boolean | undefined = boolean | undefined> = JSONPathJTLTOptions<"json", E> | JSONPathJTLTOptions<"string", E> | JSONPathJTLTOptions<"dom", E> | XPathJTLTOptions<"json", E> | XPathJTLTOptions<"string", E> | XPathJTLTOptions<"dom", E>;
 /**
  * Internal options extension adding private runtime state flags.
  * Not part of the public API surface but used for narrowing casts.
@@ -182,7 +215,7 @@ export type JTLTOptions<E extends boolean | undefined = any> = JSONPathJTLTOptio
  * @typedef {(this: TCtx,
  *   value: ResultType<U>,
  *   cfg?: {mode?: string}
- * ) => ResultType<T>|void} TemplateFunction
+ * ) => ResultType<T>|void|Promise<ResultType<T>|void>} TemplateFunction
  */
 /**
  * @template {"json"|"string"|"dom"} T
@@ -209,11 +242,69 @@ export type JTLTOptions<E extends boolean | undefined = any> = JSONPathJTLTOptio
  * >]} JSONPathTemplateArray
  */
 /**
+ * The output-sink surface a custom `joiningTransformer` may provide. Only
+ * `append` and `get` are required; the rest are optional because the engine
+ * guards each call. The built-in joiners' `append`/`string`/… signatures
+ * diverge (e.g. the DOM joiner also accepts `Node`), so under
+ * `strictFunctionTypes` no single structural type is a supertype of all
+ * three; this contract lists the surface with `unknown` parameters, and
+ * {@link JoiningTransformer} unions it with the concrete classes so real
+ * joiners still type precisely.
+ * @typedef {object} JoiningTransformerContract
+ * @property {(item: unknown) => unknown} append
+ * @property {() => unknown} get
+ * @property {(txt: string) => unknown} [text]
+ * @property {(str: unknown, cb?: () => void) => unknown} [string]
+ * @property {(num: unknown) => unknown} [number]
+ * @property {(
+ *   obj: unknown, cb?: unknown, usePropertySets?: unknown, propSets?: unknown
+ * ) => unknown} [object]
+ * @property {(arr: unknown, cb?: unknown) => unknown} [array]
+ * @property {(
+ *   name: string, atts?: unknown, children?: unknown,
+ *   cb?: unknown, useAttributeSets?: unknown
+ * ) => unknown} [element]
+ * @property {(
+ *   name: string, val: unknown, avoidAttEscape?: unknown
+ * ) => unknown} [attribute]
+ * @property {(text: string) => unknown} [comment]
+ * @property {(
+ *   target: string, data: string
+ * ) => unknown} [processingInstruction]
+ * @property {(str: unknown) => unknown} [plainText]
+ * @property {(prop: unknown, val: unknown) => unknown} [propValue]
+ * @property {(item: unknown) => unknown} [rawAppend]
+ * @property {(prefix: string, namespaceURI: string) => unknown} [namespace]
+ * @property {(context: unknown) => unknown} [setContext]
+ * @property {(cfg: unknown) => unknown} [output]
+ * @property {(cfg: unknown) => unknown} [mode]
+ * @property {(cfg: unknown) => unknown} [stylesheet]
+ * @property {(cfg: unknown) => unknown} [function]
+ * @property {(
+ *   name: string, args?: unknown[]
+ * ) => unknown} [invokeFunctionByArity]
+ * @property {(
+ *   name: string, outputCharacters: unknown
+ * ) => unknown} [characterMap]
+ * @property {(name: string, attributes: unknown) => unknown} [attributeSet]
+ * @property {(
+ *   stylesheetPrefix: string, resultPrefix: string
+ * ) => unknown} [namespaceAlias]
+ */
+/**
+ * One of the three built-in joiners. Used where engine internals rely on
+ * concrete members (e.g. `_modeConfig`).
  * @typedef {(
  *   StringJoiningTransformer|
  *   DOMJoiningTransformer|
  *   JSONJoiningTransformer
- * )} JoiningTransformer
+ * )} BuiltinJoiningTransformer
+ */
+/**
+ * The type accepted for a config `joiningTransformer`: a built-in joiner or
+ * any object implementing {@link JoiningTransformerContract}.
+ * @typedef {BuiltinJoiningTransformer | JoiningTransformerContract
+ * } JoiningTransformer
  */
 /**
  * @typedef {"json"|"string"|"dom"} joiningTypes
@@ -222,7 +313,7 @@ export type JTLTOptions<E extends boolean | undefined = any> = JSONPathJTLTOptio
  * @template T
  * @template {boolean|undefined} [E=false]
  * @typedef {T extends "json" ?
- *   (E extends true ? any[] : unknown) :
+ *   (E extends true ? unknown[] : unknown) :
  *   T extends "string" ?
  *   (E extends true ? string[] : string) :
  *   (E extends true ? XMLDocument[] :
@@ -233,9 +324,12 @@ export type JTLTOptions<E extends boolean | undefined = any> = JSONPathJTLTOptio
  * @template T
  * @template {boolean|undefined} [E=false]
  * @typedef {object} BaseJTLTOptions
+ * @property {boolean} [sync] Off by default: the engine awaits any Promise a
+ *   template returns (e.g. from `await this.indexedDB(...)`). Set `true` to
+ *   forbid asynchrony — a template that returns a Promise then throws.
  * @property {(
  *   result: ResultType<T, E>
- * ) => ResultType<T, E>|void} success A callback supplied
+ * ) => ResultType<T, E>|void} [success] A callback supplied
  *   with a single argument that is the result of this instance's
  *   transform() method. When used in TypeScript, this can be made
  *   generic as `success<T>(result: T): void`.
@@ -322,7 +416,7 @@ export type JTLTOptions<E extends boolean | undefined = any> = JSONPathJTLTOptio
  * }} XPathJTLTOptions
  */
 /**
- * @template {boolean|undefined} [E=any]
+ * @template {boolean|undefined} [E=boolean|undefined]
  * @typedef {JSONPathJTLTOptions<"json", E> |
  *   JSONPathJTLTOptions<"string", E> |
  *   JSONPathJTLTOptions<"dom", E> |

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"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"}

package/dist/indexedDB.d.ts

@@ -0,0 +1,107 @@
+export type OpenDBFunction = typeof import("idb").openDB;
+export type IndexedDBResultType = 'value' | 'key' | 'primaryKey' | 'all';
+export type QueryOptions = {
+    index?: string;
+    range?: {
+        lower?: IDBValidKey;
+        upper?: IDBValidKey;
+        lowerOpen?: boolean;
+        upperOpen?: boolean;
+    };
+    query?: NonNullable<object | string | number>;
+    direction?: 'next' | 'nextunique' | 'prev' | 'prevunique';
+    count?: number;
+    resultType?: IndexedDBResultType;
+};
+export type IdbCursorLike = {
+    key: IDBValidKey;
+    primaryKey: IDBValidKey;
+    value: unknown;
+    continue: () => Promise<IdbCursorLike | null>;
+};
+export type IdbRecord = {
+    key: IDBValidKey;
+    primaryKey: IDBValidKey;
+    value: unknown;
+};
+export type IdbQueryTarget = {
+    openCursor: (range?: IDBKeyRange | null, direction?: IDBCursorDirection) => Promise<IdbCursorLike | null>;
+    openKeyCursor: (range?: IDBKeyRange | null, direction?: IDBCursorDirection) => Promise<IdbCursorLike | null>;
+    getAll: (range?: IDBKeyRange | null, count?: number) => Promise<unknown[]>;
+    getAllKeys: (range?: IDBKeyRange | null, count?: number) => Promise<IDBValidKey[]>;
+    getAllRecords?: ((options?: {
+        query?: IDBKeyRange | null;
+        count?: number;
+        direction?: IDBCursorDirection;
+    }) => Promise<IdbRecord[]>);
+};
+export declare function queryIndexedDB(dbName: string, storeName: string, options: QueryOptions & {
+    resultType: 'all';
+}): Promise<IdbRecord[]>;
+export declare function queryIndexedDB(dbName: string, storeName: string, options: QueryOptions & {
+    resultType: 'key' | 'primaryKey';
+}): Promise<IDBValidKey[]>;
+export declare function queryIndexedDB(dbName: string, storeName: string, options?: QueryOptions): Promise<unknown[]>;
+export type ParsedIndexedDBExpression = {
+    dbName: string;
+    storeName: string;
+    options: QueryOptions | undefined;
+    /**
+     * - A JSONPath segment applied to the fetched
+     * records (e.g. `.*.name` or `[0].name`), with surrounding whitespace
+     * trimmed. Used by the JSONPath engine only; the XPath engine exposes
+     * `indexedDB()` as a registered XPath function instead (see
+     * {@link evaluateXPathWithIndexedDB}).
+     */
+    trailing: string;
+};
+/**
+ * @typedef {object} ParsedIndexedDBExpression
+ * @property {string} dbName
+ * @property {string} storeName
+ * @property {QueryOptions|undefined} options
+ * @property {string} trailing - A JSONPath segment applied to the fetched
+ *   records (e.g. `.*.name` or `[0].name`), with surrounding whitespace
+ *   trimmed. Used by the JSONPath engine only; the XPath engine exposes
+ *   `indexedDB()` as a registered XPath function instead (see
+ *   {@link evaluateXPathWithIndexedDB}).
+ */
+/**
+ * Detect and parse an `indexedDB(...)` call at the start of a selector string.
+ * @param {string} expr
+ * @returns {ParsedIndexedDBExpression|null} `null` when `expr` is not an
+ *   `indexedDB(...)` expression.
+ */
+export declare function parseIndexedDBExpression(expr: string): ParsedIndexedDBExpression | null;
+/**
+ * Fetch the records for a parsed `indexedDB(...)` expression and, when a
+ * trailing JSONPath segment is present (e.g. `.*.name`), evaluate it against
+ * the fetched records. Shared by the JSONPath and XPath engines.
+ * @param {ParsedIndexedDBExpression} parsed
+ * @param {{preventEval?: boolean}} [options]
+ * @returns {Promise<unknown>}
+ */
+export declare function resolveIndexedDBQuery(parsed: ParsedIndexedDBExpression, { preventEval }?: {
+    preventEval?: boolean;
+}): Promise<unknown>;
+/**
+ * Namespace URI backing the predefined `jtlt` prefix under which the XPath
+ * `indexedDB()` function is registered.
+ */
+export declare const JTLT_XPATH_NAMESPACE = "urn:jtlt";
+/**
+ * @param {unknown} expr
+ * @returns {boolean} Whether `expr` calls the `indexedDB()` XPath function
+ */
+export declare function xpathExpressionUsesIndexedDB(expr: unknown): boolean;
+/**
+ * Evaluate an XPath 3.1 expression that may call `jtlt:indexedDB(...)`,
+ * to a string. Because fontoxpath is synchronous, this first evaluates the
+ * expression in "collect" mode to discover every `indexedDB()` call, awaits
+ * those queries, then evaluates again with the records available.
+ * @param {string} selectStr
+ * @param {Node} contextNode
+ * @returns {Promise<string>}
+ */
+export declare function evaluateXPathWithIndexedDB(selectStr: string, contextNode: Node): Promise<string>;
+//# sourceMappingURL=indexedDB.d.ts.map

package/dist/indexedDB.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexedDB.d.ts","sourceRoot":"","sources":["../src/indexedDB.js"],"names":[],"mappings":"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"}

package/dist/maybeAsync.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Iterate over an array, staying fully synchronous while `body` returns
+ * synchronously and only chaining Promises once `body` returns a thenable.
+ *
+ * This lets a nested asynchronous operation (e.g. an
+ * `await this.indexedDB(...)` fetch inside a template) suspend the loop,
+ * without forcing the common synchronous case through microtasks or
+ * breaking DOM-bound consumers.
+ * @template T
+ * @param {T[]} array
+ * @param {(item: T, index: number, arr: T[]) => any} body
+ * @returns {Promise<void>|void}
+ */
+export declare function maybeAsyncLoop<T>(array: T[], body: (item: T, index: number, arr: T[]) => any): Promise<void> | void;
+//# sourceMappingURL=maybeAsync.d.ts.map

package/dist/maybeAsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maybeAsync.d.ts","sourceRoot":"","sources":["../src/maybeAsync.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CALjB,CAAC,EAKkB,KAAK,EAJ1B,CAAC,EAIyB,EAAE,IAAI,EAHhC,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,GAGN,GAF9B,OAAO,CAAC,IAAI,CAAC,GAAC,IAAI,CAgC9B"}

package/docs/API.expanded.md

@@ -4,14 +4,18 @@ This document describes the public API surface of JTLT (JavaScript Template Lang
 
 > Early alpha: APIs may evolve; experimental sections (XPath) can change without major version bumps.
 
-## Core façade: `JTLT`
+## Entry points: `jtlt()` and `JTLT`
 
-High-level entry point for running a transform over JSON data using JSONPath.
+### `jtlt(config)` — recommended
+
+Runs a transform and returns a `Promise` resolving to the result. It takes
+every option below **except `success`**, and does not accept `autostart`
+meaningfully (it always runs).
 
 ```js
-import JTLT from 'jtlt';
+import {jtlt} from 'jtlt';
 
-const out = JTLT.create({
+const out = await jtlt({
   data: {title: 'Hello'},
   outputType: 'string',
   templates: [
@@ -22,31 +26,56 @@ const out = JTLT.create({
         this.string('</h1>');
       }
     }
-  ],
+  ]
+});
+```
+
+### `JTLT` class — lower level
+
+`JTLT.create(config)` (or `new JTLT(config)`) returns a `JTLT` instance. The
+result is delivered through the **required `success` callback**, which is
+also the return value of `.transform(mode?)`:
+
+```js
+import JTLT from 'jtlt';
+
+const inst = JTLT.create({
+  data: {title: 'Hello'},
+  outputType: 'string',
+  templates: [/* … */],
   success: (res) => res
-}).transform('');
+});
+const out = inst.transform('');
 ```
 
-### `new JTLT(config)` or `JTLT.create(config)` options
+By default the constructor runs the transform immediately; pass
+`autostart: false` to defer it to your own `.transform()` call.
+
+### Options
+
+Common to both entry points unless noted.
 
 | Option | Type | Description |
 | ------ | ---- | ----------- |
-| `data` | any | Root JSON/JS object. Required unless `ajaxData` provided. |
+| `data` | object \| primitive | Root JSON/JS value (or DOM `Document`/`Element` for the XPath engine). Required unless `ajaxData` provided. |
 | `ajaxData` | string | URL to fetch JSON (async start). |
-| `templates` | Array<TemplateObject> | Template declarations; see below. |
+| `templates` | Array&lt;TemplateObject&gt; | Template declarations; see below. |
 | `template` | Function \| TemplateObject | Single root template convenience. |
 | `query` | Function | Root template convenience (wrapped as `path: '$'`). |
 | `forQuery` | [select, cb] | One-off query (like FLWOR `for`). Auto-wrapped as root template. |
-| `success` | Function(result) | Required callback; also receives transform return. |
+| `success` | Function(result) | **`JTLT` only** — required callback; also the return of `.transform()`. Not accepted by `jtlt()`. |
 | `mode` | string | Starting mode for template matching. |
-| `outputType` | 'string' \| 'dom' \| 'json' | Chooses joiner. Default 'string'. |
-| `joiningTransformer` | Joiner instance | Custom joiner; skip auto creation. |
+| `outputType` | 'string' \| 'dom' \| 'json' | Chooses joiner. Default `'string'`. |
+| `engineType` | 'jsonpath' \| 'xpath' | Engine to use. Default `'jsonpath'`. |
+| `xpathVersion` | 1 \| 2 \| 3.1 | XPath engine only. `1` native, `2` xpath2.js, `3.1` fontoxpath. Default `1`. |
+| `sync` | boolean | Off by default (async templates are awaited). When `true`, a template that returns a Promise throws; disables `indexedDB()`. |
+| `joiningTransformer` | Joiner | Custom joiner; skip auto creation. Needs `append` and `get` (see `JoiningTransformerContract`). |
 | `joiningConfig` | object | Passed to joiner (e.g., `{xmlElements:true}`). |
 | `unwrapSingleResult` | boolean | For JSON joiner: unwrap single-item root array. |
 | `errorOnEqualPriority` | boolean | Throw when multiple templates share priority on a node. |
-| `specificityPriorityResolver` | fn(path)=>number | Custom resolver for relative priorities. Defaults to XSLT-like JSONPath resolver. |
-| `engine` | fn(config)=>any | Override transform engine (defaults to JSONPathTransformer). |
-| `autostart` | boolean | If `false`, don’t auto-call `transform()` in constructor. |
+| `specificityPriorityResolver` | fn(path)=&gt;number | Custom resolver for relative priorities. Defaults to XSLT-like JSONPath resolver. |
+| `engine` | fn(config)=&gt;result | Override transform engine (defaults to JSONPathTransformer). |
+| `autostart` | boolean | **`JTLT` only** — if `false`, don't auto-call `transform()` in constructor. |
 | `preventEval` | boolean | Disable parenthetical eval portions of JSONPath (security). |
 
 ## Template objects
@@ -123,9 +152,10 @@ const out = engine.transform('');
 ```
 
 Limitations:
-- Versions 2 and 3 (`xpath2.js` and `fontoxpath`) may lack some XPath functions;
-  stick to basic location paths and simple predicates.
-- Namespace resolution not yet exposed (future `namespaceResolver` option).
+- Versions 2 and 3.1 (`xpath2.js` and `fontoxpath`) may lack some XPath
+  functions; stick to basic location paths and simple predicates.
+- A user `namespaceResolver` option is not yet exposed (the XPath 3.1
+  `jtlt:` prefix used by `indexedDB()` is wired in internally).
 
 ## Contexts
 
@@ -144,6 +174,13 @@ Methods (subset):
 - `variable(name, select)` – stores value/array from JSONPath.
 - `callTemplate(name, withParam?)`
 - `key(name, match, use)` / `getKey(name, value)`
+- `indexedDB(dbName, storeName, options?)` – returns a `Promise` of matching
+  IndexedDB records. `options` mirror `jsonpath-plus`'s `resultType`
+  (`'value'` default, `'key'`, `'primaryKey'`, `'all'`) plus `index`,
+  `range`, `query`, `direction`, `count`. A template using it must be
+  `async` (or return the Promise). Throws under `sync: true`. A selector of
+  the form `indexedDB('db', 'store').*.name` in `valueOf()` is intercepted
+  and resolved the same way.
 - Joiner passthrough: `string()`, `text()`, `element()`, `object()`, `array()`, `number()`, `boolean()`, etc.
 \- Cloning helpers:
   - `copy(propertySets?)` — Shallow clone of current context value (object/array). Nested references are preserved. Optional `propertySets` (array of registered names) merge into the top-level clone when object-like.
@@ -163,6 +200,14 @@ Parallels JSONPath context with XPath evaluation:
   current context node; absolute paths (`/`, `//`) target the document root.
 - `variable(name, select)` – always stores node arrays for XPath.
 - `key(name, match, use)` – index by attribute value; `getKey` returns matching Element or context sentinel (`this`).
+- `indexedDB(dbName, storeName, options?)` – same direct helper as the
+  JSONPath context. Additionally, `jtlt:indexedDB('db', 'store')` is
+  registered as an XPath 3.1 function (predefined `jtlt` prefix,
+  `urn:jtlt`), so `valueOf()` selectors such as
+  `string-join(jtlt:indexedDB('db', 'store') ! ?name, ',')` work; options
+  are passed as an XPath map. Since fontoxpath is synchronous, the
+  expression is evaluated in a collect pass, the queries are awaited, then
+  it is re-evaluated with the records. Throws under `sync: true`.
 - Default template rules: root traverses `.`, element traverses `*`, text nodes emit `nodeValue`, scalars emit `valueOf('.')`.
 \- Cloning helpers:
   - `copy()` — Shallow clone of the current context node (`cloneNode(false)`) appended to the joiner.
@@ -456,9 +501,14 @@ See `README.md` for FLWOR-style and join patterns.
 ## Roadmap (selected)
 
 - Namespace support for XPath.
-- Copy helpers (deep/shallow) parity with XSLT.
-- Streaming / async query execution.
 - Schema-aware template targeting.
+- Broader async data sources (async templates and IndexedDB access via
+  `this.indexedDB(...)` already land).
+- Closing remaining `xsl:copy` / `xsl:copy-of` parity gaps: a sequence
+  constructor for `copy()` (shallow-copy the node, then build its content in
+  the same call), `use-attribute-sets` on the XPath `copy()` (the JSONPath
+  one already takes `propertySets`), and `copy-namespaces` /
+  `inherit-namespaces` control over which namespace nodes are carried.
 
 ## Versioning
 

package/docs/API.md

@@ -3,11 +3,15 @@
 For the full reference (engines, contexts, joiners, sorting, keys, variables,
 property sets, defaults, roadmap), see `docs/API.expanded.md`.
 
-## Facade: JTLT
+## Entry points: `jtlt()` and `JTLT`
+
+**`jtlt(config)`** is the recommended entry point. It runs the transform and
+returns a `Promise` that resolves to the result — no `success` callback:
 
 ```js
-import JTLT from 'jtlt';
-JTLT.create({
+import {jtlt} from 'jtlt';
+
+const out = await jtlt({
   data: {title: 'Hi'},
   templates: [
     {path: '$.title', template (v) {
@@ -15,11 +19,32 @@ JTLT.create({
       this.string('</h1>');
     }}
   ],
+  outputType: 'string'
+});
+```
+
+Async templates (e.g. `await this.indexedDB(...)`) are awaited automatically;
+pass `sync: true` to forbid them (a template that returns a Promise then
+throws).
+
+The lower-level **`JTLT`** class (`JTLT.create(config)` / `new JTLT(config)`)
+is for when you need the instance itself, `autostart: false`, or to call
+`.transform(mode)` yourself. It delivers the result through a **required
+`success` callback** (also returned from `.transform()`):
+
+```js
+import JTLT from 'jtlt';
+
+const out = JTLT.create({
+  data: {title: 'Hi'},
+  templates: [/* … */],
   outputType: 'string',
-  success: (out) => out
+  success: (result) => result
 }).transform('');
 ```
 
+`jtlt()` accepts every `JTLT` option except `success`.
+
 ## Engines
 
 - JSONPathTransformer: on JSON with JSONPath selectors; resolves
@@ -33,6 +58,11 @@ JTLT.create({
 `variable(name, select)`, `key(name, match, use)`, `getKey(name, value)`.
 JSONPath variables store values; XPath variables store arrays of nodes.
 
+Async: a template may be `async` and `await` inside it. `this.indexedDB(db,
+store, options?)` resolves to matching IndexedDB records (see
+`docs/API.expanded.md`). Unavailable when JTLT is configured with
+`sync: true`.
+
 Cloning:
 `copy()` (shallow clone current JSON value or DOM node) and
 `copyOf(select?)` (deep clone; optional selector overrides target; scalar

package/docs/TO-DO.md

@@ -76,7 +76,7 @@
     functions (or in XQuery), add equivalents to XSLT's
     `document()` and `unparsed-text()` for allowing non-JSON file
     retrieval (as well as variables/parameters) and also methods for
-    iterating or retrieving IndexedDB, `localStorage`, and cookies
+    iterating or retrieving `localStorage` and cookies
     (names, keys and values).
 
 6. Add `outputType` which uses a DOM joiner but allows specialized
@@ -86,7 +86,7 @@
 
 7. See code for other possible to-dos
 
-8. Promise-based templates; jtlt as templating engine (including zodexy-aware path expressions like @blob() for jsonpath-plus with `copyOf`/`valueOf` `document(...url...)` or our own indexeddb path db/store/key equivalent); work on **schema-driven** search forms too
+8. jtlt as templating engine (including zodexy-aware path expressions like @blob() for jsonpath-plus with `copyOf`/`valueOf` `document(...url...)`; work on **schema-driven** search forms too
 
 9. Consider implementing the following elements from <https://www.w3.org/TR/xslt-30/>
     which are not yet implemented.

package/eslint.config.js

@@ -9,6 +9,14 @@ export default [
       'demo/codemirror.esm.js'
     ]
   },
+  {
+    languageOptions: {
+      ecmaVersion: 'latest',
+      globals: {
+        IDBKeyRange: 'readonly'
+      }
+    }
+  },
   ...ashNazg(['sauron']),
   {
     rules: {
@@ -19,9 +27,6 @@ export default [
       'unicorn/prefer-private-class-fields': 0,
       'unicorn/no-undeclared-class-members': 0,
 
-      // AI was frequently making egregious mistakes here, so make fixable
-      'jsdoc/check-alignment': 'error',
-
       // We frequently use callbacks for nested interactions
       'promise/prefer-await-to-callbacks': 0,
 
@@ -42,6 +47,9 @@ export default [
   {
     files: ['test/**/*.js', 'test.js'],
     rules: {
+      // Reapply rule to testing file as it demonstrates the API
+      'jsdoc/reject-any-type': ['error'],
+
       'unicorn/prefer-https': 0, // Old namespaces
       // Too many are JSON properties called "children"
       'unicorn/better-dom-traversing': 0,