@adobe/data-lit 0.9.83 → 0.9.84

package/dist/elements/database-element.d.ts

@@ -12,6 +12,15 @@ export declare abstract class DatabaseElement<P extends Database.Plugin> extends
      */
     set service(db: Database.Plugin.ToDatabase<P>);
     get service(): UIService.FromService<Database.Plugin.ToDatabase<P>>;
+    /**
+     * The full, unrestricted database — for imperative-rendering subclasses
+     * (a canvas / WebGL draw loop that reads columns synchronously each frame,
+     * where the reactive `observe` surface can't help because systems mutate
+     * columns in place without firing observers). Presentations and external
+     * callers still receive only the restricted {@link service}; this privileged
+     * read path is confined to container element authors via `protected`.
+     */
+    protected get database(): Database.Plugin.ToDatabase<P>;
     constructor();
     abstract get plugin(): P;
     connectedCallback(): void;

package/dist/elements/database-element.js

@@ -5,7 +5,8 @@ import { Database } from '@adobe/data/ecs';
 import { UIService } from '@adobe/data/service';
 import { attachDecorator, withHooks } from '../index.js';
 export class DatabaseElement extends LitElement {
-    /** Full database, hard-private — invisible to subclasses and external callers. */
+    /** Full database, hard-private. Exposed to subclasses only through the
+     *  restricted {@link service} getter and the {@link database} accessor. */
     #database;
     /**
      * The element's database surface.
@@ -22,17 +23,50 @@ export class DatabaseElement extends LitElement {
     get service() {
         return UIService.restrict(this.#database);
     }
+    /**
+     * The full, unrestricted database — for imperative-rendering subclasses
+     * (a canvas / WebGL draw loop that reads columns synchronously each frame,
+     * where the reactive `observe` surface can't help because systems mutate
+     * columns in place without firing observers). Presentations and external
+     * callers still receive only the restricted {@link service}; this privileged
+     * read path is confined to container element authors via `protected`.
+     */
+    get database() {
+        return this.#database;
+    }
     constructor() {
         super();
         attachDecorator(this, 'render', withHooks);
     }
     connectedCallback() {
+        this.#upgradeServiceProperty();
         if (!this.#database) {
             const ancestor = this.findAncestorService();
             this.service = ancestor?.extend(this.plugin) ?? Database.create(this.plugin);
         }
         super.connectedCallback();
     }
+    /**
+     * A lazy wrapper binds `.service` *before* this element's class is upgraded
+     * (the element module is dynamically imported), so the value lands as an own
+     * data property that shadows the `service` accessor: `set service` never runs
+     * (`#database` stays unset, `database` reads `undefined`) and `get service`
+     * returns the raw injected database instead of the restricted view. Reassign
+     * the shadowed value through the accessor so the setter runs — `#database` is
+     * populated and the UI restriction is actually enforced.
+     */
+    #upgradeServiceProperty() {
+        if (!Object.prototype.hasOwnProperty.call(this, "service"))
+            return;
+        // The own property was bound by the wrapper as the full database (DI); the
+        // `service` accessor's declared type hides that, hence the widening view.
+        const self = this;
+        const injected = self.service;
+        delete self.service;
+        if (injected !== undefined) {
+            this.service = injected;
+        }
+    }
     findAncestorService() {
         for (const element of iterateSelfAndAncestors(this)) {
             // Read each ancestor's `service`. A DatabaseElement returns its full

package/dist/elements/database-element.js.map

@@ -1 +1 @@
-{"version":3,"file":"database-element.js","sourceRoot":"","sources":["../../src/elements/database-element.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,OAAgB,eAA2C,SAAQ,UAAU;IAEjF,kFAAkF;IAClF,SAAS,CAAiC;IAE1C;;;;;;OAMG;IACH,IAAI,OAAO,CAAC,EAAiC;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,OAAO;QACT,OAAO,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;QACE,KAAK,EAAE,CAAC;QACR,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC7C,CAAC;IAID,iBAAiB;QACf,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC5C,IAAI,CAAC,OAAO,GAAG,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/E,CAAC;QACD,KAAK,CAAC,iBAAiB,EAAE,CAAC;IAC5B,CAAC;IAES,mBAAmB;QAC3B,KAAK,MAAM,OAAO,IAAI,uBAAuB,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,qEAAqE;YACrE,uEAAuE;YACvE,wEAAwE;YACxE,wEAAwE;YACxE,qEAAqE;YACrE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAgC,CAAC;YACrD,IAAI,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC;gBAAE,OAAO,OAAO,CAAC;QAC3C,CAAC;IACH,CAAC;IAEe,MAAM;QACpB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;CAEF"}
+{"version":3,"file":"database-element.js","sourceRoot":"","sources":["../../src/elements/database-element.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,OAAgB,eAA2C,SAAQ,UAAU;IAEjF;+EAC2E;IAC3E,SAAS,CAAiC;IAE1C;;;;;;OAMG;IACH,IAAI,OAAO,CAAC,EAAiC;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,OAAO;QACT,OAAO,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;OAOG;IACH,IAAc,QAAQ;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;QACE,KAAK,EAAE,CAAC;QACR,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC7C,CAAC;IAID,iBAAiB;QACf,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC5C,IAAI,CAAC,OAAO,GAAG,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/E,CAAC;QACD,KAAK,CAAC,iBAAiB,EAAE,CAAC;IAC5B,CAAC;IAED;;;;;;;;OAQG;IACH,uBAAuB;QACrB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;YAAE,OAAO;QACnE,2EAA2E;QAC3E,0EAA0E;QAC1E,MAAM,IAAI,GAAG,IAA8D,CAAC;QAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC;QACpB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC;QAC1B,CAAC;IACH,CAAC;IAES,mBAAmB;QAC3B,KAAK,MAAM,OAAO,IAAI,uBAAuB,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,qEAAqE;YACrE,uEAAuE;YACvE,wEAAwE;YACxE,wEAAwE;YACxE,qEAAqE;YACrE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAgC,CAAC;YACrD,IAAI,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC;gBAAE,OAAO,OAAO,CAAC;QAC3C,CAAC;IACH,CAAC;IAEe,MAAM;QACpB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;CAEF"}

package/dist/elements/database-element.type-test.js

@@ -19,6 +19,9 @@ const plugin = Database.Plugin.create({
         increment: (t) => {
             t.resources.count = t.resources.count + 1;
         },
+        setCount: (t, input) => {
+            t.resources.count = input.value;
+        },
     },
 });
 class _CountElement extends DatabaseElement {
@@ -44,4 +47,7 @@ const _noPublicDatabaseProperty = (el) => {
     // @ts-expect-error `database` no longer exists; the full db is hard-private
     void el.database;
 };
+const _setCountDrivable = null;
+// The plain-args (fire-and-forget) overload also survives, still returning void.
+const _setCountCommit = null;
 //# sourceMappingURL=database-element.type-test.js.map

package/dist/elements/database-element.type-test.js.map

@@ -1 +1 @@
-{"version":3,"file":"database-element.type-test.js","sourceRoot":"","sources":["../../src/elements/database-element.type-test.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD;;;;;;;;GAQG;AAEH,sDAAsD;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG3C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACpC,SAAS,EAAE;QACT,KAAK,EAAE,EAAE,OAAO,EAAE,CAAW,EAAE;KAChC;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;YACf,CAAC,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC;QAC5C,CAAC;KACF;CACF,CAAC,CAAC;AAEH,MAAM,aAAc,SAAQ,eAA8B;IACxD,IAAI,MAAM;QACR,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAKD,iFAAiF;AACjF,2EAA2E;AAC3E,yDAAyD;AACzD,MAAM,mBAAmB,GAAG,CAAC,EAAiB,EAAE,EAAe,EAAQ,EAAE;IACvE,EAAE,CAAC,OAAO,GAAG,EAAE,CAAC;AAClB,CAAC,CAAC;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,MAAM,2BAA2B,GAAG,CAAC,EAAiB,EAAQ,EAAE;IAC9D,+EAA+E;IAC/E,EAAE,CAAC,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;AAC1B,CAAC,CAAC;AAEF,gFAAgF;AAChF,0EAA0E;AAC1E,MAAM,yBAAyB,GAAG,CAAC,EAAiB,EAAQ,EAAE;IAC5D,4EAA4E;IAC5E,KAAK,EAAE,CAAC,QAAQ,CAAC;AACnB,CAAC,CAAC"}
+{"version":3,"file":"database-element.type-test.js","sourceRoot":"","sources":["../../src/elements/database-element.type-test.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD;;;;;;;;GAQG;AAEH,sDAAsD;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAI3C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACpC,SAAS,EAAE;QACT,KAAK,EAAE,EAAE,OAAO,EAAE,CAAW,EAAE;KAChC;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;YACf,CAAC,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC;QAC5C,CAAC;QACD,QAAQ,EAAE,CAAC,CAAC,EAAE,KAAiC,EAAE,EAAE;YACjD,CAAC,CAAC,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QAClC,CAAC;KACF;CACF,CAAC,CAAC;AAEH,MAAM,aAAc,SAAQ,eAA8B;IACxD,IAAI,MAAM;QACR,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAKD,iFAAiF;AACjF,2EAA2E;AAC3E,yDAAyD;AACzD,MAAM,mBAAmB,GAAG,CAAC,EAAiB,EAAE,EAAe,EAAQ,EAAE;IACvE,EAAE,CAAC,OAAO,GAAG,EAAE,CAAC;AAClB,CAAC,CAAC;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,MAAM,2BAA2B,GAAG,CAAC,EAAiB,EAAQ,EAAE;IAC9D,+EAA+E;IAC/E,EAAE,CAAC,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;AAC1B,CAAC,CAAC;AAEF,gFAAgF;AAChF,0EAA0E;AAC1E,MAAM,yBAAyB,GAAG,CAAC,EAAiB,EAAQ,EAAE;IAC5D,4EAA4E;IAC5E,KAAK,EAAE,CAAC,QAAQ,CAAC;AACnB,CAAC,CAAC;AA8CF,MAAM,iBAAiB,GACrB,IAA0D,CAAC;AAC7D,iFAAiF;AACjF,MAAM,eAAe,GACnB,IAA0D,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./hooks/index.js";
 export * from "./elements/index.js";
 export * from "./decorators/index.js";
+export { Template } from "./testing/template/template.js";
 export type { Vec2 } from "@adobe/data/math";

package/dist/index.js

@@ -2,4 +2,5 @@
 export * from "./hooks/index.js";
 export * from "./elements/index.js";
 export * from "./decorators/index.js";
+export { Template } from "./testing/template/template.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/testing/template/from.d.ts

@@ -0,0 +1,7 @@
+import type { Query } from "./query.js";
+/**
+ * Wrap a presentation's `render(props)` output in a {@link Query} for DOM-free
+ * assertions. Throws if given something that isn't a `TemplateResult`, so a
+ * presentation that returns `nothing`/`undefined` fails loudly at the call site.
+ */
+export declare const from: (result: unknown) => Query;

package/dist/testing/template/from.js

@@ -0,0 +1,90 @@
+// Duck-typed, DOM-free check for a Lit TemplateResult (or a nested one).
+const isTemplate = (value) => typeof value === "object" &&
+    value !== null &&
+    Array.isArray(value.strings) &&
+    Array.isArray(value.values);
+// Static markup + interpolated primitives, concatenated (recursive). Symbols
+// (e.g. `nothing`), null/undefined, booleans and functions contribute no text.
+const collectText = (value) => {
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "bigint")
+        return String(value);
+    if (Array.isArray(value))
+        return value.map(collectText).join("");
+    if (isTemplate(value)) {
+        let out = "";
+        for (let i = 0; i < value.strings.length; i++) {
+            out += value.strings[i];
+            if (i < value.values.length)
+                out += collectText(value.values[i]);
+        }
+        return out;
+    }
+    return "";
+};
+// Every leaf binding value, flattened; nested templates are recursed into but
+// not themselves pushed (those are exposed as `children`).
+const collectValues = (value, into) => {
+    if (isTemplate(value)) {
+        for (const v of value.values)
+            collectValues(v, into);
+    }
+    else if (Array.isArray(value)) {
+        for (const v of value)
+            collectValues(v, into);
+    }
+    else {
+        into.push(value);
+    }
+};
+// The interpolated child templates directly inside `result` (flattening arrays,
+// but not descending through other templates — `find` handles depth).
+const collectChildren = (result) => {
+    const children = [];
+    const visit = (value) => {
+        if (isTemplate(value))
+            children.push(build(value));
+        else if (Array.isArray(value))
+            value.forEach(visit);
+    };
+    for (const v of result.values)
+        visit(v);
+    return children;
+};
+const build = (result) => {
+    const text = collectText(result);
+    const values = [];
+    for (const v of result.values)
+        collectValues(v, values);
+    const children = collectChildren(result);
+    const find = (fragment) => {
+        for (const child of children) {
+            if (child.text.includes(fragment))
+                return child;
+            const deep = child.find(fragment);
+            if (deep)
+                return deep;
+        }
+        return undefined;
+    };
+    return {
+        text,
+        values,
+        children,
+        has: (fragment) => text.includes(fragment),
+        find,
+    };
+};
+/**
+ * Wrap a presentation's `render(props)` output in a {@link Query} for DOM-free
+ * assertions. Throws if given something that isn't a `TemplateResult`, so a
+ * presentation that returns `nothing`/`undefined` fails loudly at the call site.
+ */
+export const from = (result) => {
+    if (!isTemplate(result)) {
+        throw new TypeError("Template.from expects a Lit TemplateResult");
+    }
+    return build(result);
+};
+//# sourceMappingURL=from.js.map

package/dist/testing/template/from.js.map

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

package/dist/testing/template/from.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/testing/template/from.test.js

@@ -0,0 +1,41 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { describe, it, expect } from "vitest";
+import { html, nothing } from "lit";
+import { Template } from "./template.js";
+describe("Template.from", () => {
+    it("collects static markup and interpolated primitives into text", () => {
+        const q = Template.from(html `<sp-toast>${"Saved!"} (${3})</sp-toast>`);
+        expect(q.has("<sp-toast")).toBe(true);
+        expect(q.text).toContain("Saved!");
+        expect(q.text).toContain("(3)");
+    });
+    it("exposes leaf binding values for identity checks (callbacks, nothing, booleans)", () => {
+        const onClick = () => { };
+        const q = Template.from(html `<sp-button @click=${onClick} ?disabled=${true}>${nothing}</sp-button>`);
+        expect(q.values).toContain(onClick);
+        expect(q.values).toContain(true);
+        expect(q.values).toContain(nothing);
+    });
+    it("finds interpolated child templates by fragment, recursively", () => {
+        const label = "Undo";
+        const q = Template.from(html `
+      <div>${html `<section>${html `<sp-button>${label}</sp-button>`}</section>`}</div>
+    `);
+        const button = q.find("<sp-button");
+        expect(button).toBeDefined();
+        expect(button?.has("Undo")).toBe(true);
+    });
+    it("flattens values from nested templates and arrays", () => {
+        const a = () => { };
+        const b = () => { };
+        const q = Template.from(html `<ul>${[html `<li @x=${a}></li>`, html `<li @x=${b}></li>`]}</ul>`);
+        expect(q.values).toContain(a);
+        expect(q.values).toContain(b);
+        expect(q.children).toHaveLength(2);
+    });
+    it("throws when given something that is not a TemplateResult", () => {
+        expect(() => Template.from(nothing)).toThrow(TypeError);
+        expect(() => Template.from(undefined)).toThrow(TypeError);
+    });
+});
+//# sourceMappingURL=from.test.js.map

package/dist/testing/template/from.test.js.map

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

package/dist/testing/template/public.d.ts

@@ -0,0 +1,2 @@
+export { from } from "./from.js";
+export type { Query } from "./query.js";

package/dist/testing/template/public.js

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export { from } from "./from.js";
+//# sourceMappingURL=public.js.map

package/dist/testing/template/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/testing/template/public.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/testing/template/query.d.ts

@@ -0,0 +1,25 @@
+/**
+ * A DOM-free view over a Lit `TemplateResult`, for asserting on what a pure
+ * `render(props)` presentation *declares* — without mounting anything. Built by
+ * `Template.from`.
+ *
+ * - `text` — all static markup plus interpolated primitives, concatenated
+ *   (recursive). Use for presence: `q.has("<sp-toast")`, `q.text`.
+ * - `values` — every leaf binding value, flattened across nested templates in
+ *   source order (nested templates themselves are excluded — they live in
+ *   `children`). Use identity checks rather than positions:
+ *   `expect(q.values).toContain(onClick)`, `.toContain(nothing)`.
+ * - `children` — the interpolated child templates (`${html`…`}`), each wrapped.
+ * - `has` / `find` — presence sugar and a recursive lookup of the first child
+ *   template whose `text` includes a fragment.
+ *
+ * Note: `find` only sees *interpolated* sub-templates; elements written inline
+ * in a single `html` literal are part of `text`, not `children`.
+ */
+export type Query = {
+    readonly text: string;
+    readonly values: readonly unknown[];
+    readonly children: readonly Query[];
+    has(fragment: string): boolean;
+    find(fragment: string): Query | undefined;
+};

package/dist/testing/template/query.js

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export {};
+//# sourceMappingURL=query.js.map

package/dist/testing/template/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/testing/template/query.ts"],"names":[],"mappings":"AAAA,uDAAuD"}

package/dist/testing/template/template.d.ts

@@ -0,0 +1 @@
+export * as Template from "./public.js";

package/dist/testing/template/template.js

@@ -0,0 +1,5 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+// DOM-free querying of a Lit `TemplateResult` for presentation unit tests.
+// Pure (no side effects) so it tree-shakes out of production bundles.
+export * as Template from "./public.js";
+//# sourceMappingURL=template.js.map

package/dist/testing/template/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../src/testing/template/template.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,2EAA2E;AAC3E,sEAAsE;AACtE,OAAO,KAAK,QAAQ,MAAM,aAAa,CAAC"}

package/package.json

@@ -1,15 +1,18 @@
 {
   "name": "@adobe/data-lit",
-  "version": "0.9.83",
+  "version": "0.9.84",
   "description": "Adobe data Lit bindings - hooks, elements, decorators",
   "type": "module",
   "private": false,
+  "sideEffects": [
+    "**/application-host.js"
+  ],
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
   "dependencies": {
-    "@adobe/data": "0.9.83"
+    "@adobe/data": "0.9.84"
   },
   "peerDependencies": {
     "lit": "^3.3.1"
@@ -30,6 +33,7 @@
     "dev": "tsc -b -w",
     "link": "pnpm build && pnpm link --global",
     "test": "vitest --run --passWithNoTests",
-    "publish-public": "pnpm build && pnpm publish --no-git-checks --access public"
+    "publish-public": "pnpm build && pnpm publish --no-git-checks --access public",
+    "typecheck": "tsc -b"
   }
 }

package/src/elements/database-element.ts

@@ -8,7 +8,8 @@ import { attachDecorator, withHooks } from '../index.js';
 
 export abstract class DatabaseElement<P extends Database.Plugin> extends LitElement {
 
-  /** Full database, hard-private — invisible to subclasses and external callers. */
+  /** Full database, hard-private. Exposed to subclasses only through the
+   *  restricted {@link service} getter and the {@link database} accessor. */
   #database!: Database.Plugin.ToDatabase<P>;
 
   /**
@@ -27,6 +28,18 @@ export abstract class DatabaseElement<P extends Database.Plugin> extends LitElem
     return UIService.restrict(this.#database);
   }
 
+  /**
+   * The full, unrestricted database — for imperative-rendering subclasses
+   * (a canvas / WebGL draw loop that reads columns synchronously each frame,
+   * where the reactive `observe` surface can't help because systems mutate
+   * columns in place without firing observers). Presentations and external
+   * callers still receive only the restricted {@link service}; this privileged
+   * read path is confined to container element authors via `protected`.
+   */
+  protected get database(): Database.Plugin.ToDatabase<P> {
+    return this.#database;
+  }
+
   constructor() {
     super();
     attachDecorator(this, 'render', withHooks);
@@ -35,6 +48,7 @@ export abstract class DatabaseElement<P extends Database.Plugin> extends LitElem
   abstract get plugin(): P;
 
   connectedCallback(): void {
+    this.#upgradeServiceProperty();
     if (!this.#database) {
       const ancestor = this.findAncestorService();
       this.service = ancestor?.extend(this.plugin) ?? Database.create(this.plugin);
@@ -42,6 +56,27 @@ export abstract class DatabaseElement<P extends Database.Plugin> extends LitElem
     super.connectedCallback();
   }
 
+  /**
+   * A lazy wrapper binds `.service` *before* this element's class is upgraded
+   * (the element module is dynamically imported), so the value lands as an own
+   * data property that shadows the `service` accessor: `set service` never runs
+   * (`#database` stays unset, `database` reads `undefined`) and `get service`
+   * returns the raw injected database instead of the restricted view. Reassign
+   * the shadowed value through the accessor so the setter runs — `#database` is
+   * populated and the UI restriction is actually enforced.
+   */
+  #upgradeServiceProperty(): void {
+    if (!Object.prototype.hasOwnProperty.call(this, "service")) return;
+    // The own property was bound by the wrapper as the full database (DI); the
+    // `service` accessor's declared type hides that, hence the widening view.
+    const self = this as unknown as { service?: Database.Plugin.ToDatabase<P> };
+    const injected = self.service;
+    delete self.service;
+    if (injected !== undefined) {
+      this.service = injected;
+    }
+  }
+
   protected findAncestorService(): Database | void {
     for (const element of iterateSelfAndAncestors(this)) {
       // Read each ancestor's `service`. A DatabaseElement returns its full

package/src/elements/database-element.type-test.ts

@@ -13,6 +13,7 @@
 /* eslint-disable @typescript-eslint/no-unused-vars */
 
 import { Database } from "@adobe/data/ecs";
+import type { AsyncArgsProvider } from "@adobe/data/ecs";
 import { Observe } from "@adobe/data/observe";
 import { UIService } from "@adobe/data/service";
 import { DatabaseElement } from "./database-element.js";
@@ -25,6 +26,9 @@ const plugin = Database.Plugin.create({
     increment: (t) => {
       t.resources.count = t.resources.count + 1;
     },
+    setCount: (t, input: { readonly value: number }) => {
+      t.resources.count = input.value;
+    },
   },
 });
 
@@ -94,6 +98,22 @@ type _CheckIncrementReturnsVoid = Assert<
   Equal<ReturnType<ServiceType["transactions"]["increment"]>, void>
 >;
 
+// 7. A transaction with input is exposed as an overload pair. The restriction
+//    must preserve the AsyncArgsProvider overload (return rewritten to void) so
+//    a UI element can drive a live, single-commit gesture through its
+//    restricted `service` — this is exactly what `useDragTransaction`
+//    consumes: `(asyncArgs: AsyncArgsProvider<T>) => void`. Regression guard
+//    for the overload-erasure bug in UIService's RestrictProperty.
+type DragConsumer<T> = (asyncArgs: AsyncArgsProvider<T>) => void;
+const _setCountDrivable: DragConsumer<{ readonly value: number }> =
+  null as unknown as ServiceType["transactions"]["setCount"];
+// The plain-args (fire-and-forget) overload also survives, still returning void.
+const _setCountCommit: (arg: { readonly value: number }) => void =
+  null as unknown as ServiceType["transactions"]["setCount"];
+type _CheckSetCountAsyncVoid = Assert<
+  Equal<ReturnType<ServiceType["transactions"]["setCount"]>, void>
+>;
+
 // ----------------------------------------------------------------------------
 // Local helpers (kept inline so this file stays a self-contained type test).
 // ----------------------------------------------------------------------------

package/src/index.ts

@@ -3,4 +3,5 @@
 export * from "./hooks/index.js";
 export * from "./elements/index.js";
 export * from "./decorators/index.js";
+export { Template } from "./testing/template/template.js";
 export type { Vec2 } from "@adobe/data/math";

package/src/testing/template/from.test.ts

@@ -0,0 +1,47 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { describe, it, expect } from "vitest";
+import { html, nothing } from "lit";
+import { Template } from "./template.js";
+
+describe("Template.from", () => {
+  it("collects static markup and interpolated primitives into text", () => {
+    const q = Template.from(html`<sp-toast>${"Saved!"} (${3})</sp-toast>`);
+    expect(q.has("<sp-toast")).toBe(true);
+    expect(q.text).toContain("Saved!");
+    expect(q.text).toContain("(3)");
+  });
+
+  it("exposes leaf binding values for identity checks (callbacks, nothing, booleans)", () => {
+    const onClick = () => {};
+    const q = Template.from(
+      html`<sp-button @click=${onClick} ?disabled=${true}>${nothing}</sp-button>`,
+    );
+    expect(q.values).toContain(onClick);
+    expect(q.values).toContain(true);
+    expect(q.values).toContain(nothing);
+  });
+
+  it("finds interpolated child templates by fragment, recursively", () => {
+    const label = "Undo";
+    const q = Template.from(html`
+      <div>${html`<section>${html`<sp-button>${label}</sp-button>`}</section>`}</div>
+    `);
+    const button = q.find("<sp-button");
+    expect(button).toBeDefined();
+    expect(button?.has("Undo")).toBe(true);
+  });
+
+  it("flattens values from nested templates and arrays", () => {
+    const a = () => {};
+    const b = () => {};
+    const q = Template.from(html`<ul>${[html`<li @x=${a}></li>`, html`<li @x=${b}></li>`]}</ul>`);
+    expect(q.values).toContain(a);
+    expect(q.values).toContain(b);
+    expect(q.children).toHaveLength(2);
+  });
+
+  it("throws when given something that is not a TemplateResult", () => {
+    expect(() => Template.from(nothing)).toThrow(TypeError);
+    expect(() => Template.from(undefined)).toThrow(TypeError);
+  });
+});

package/src/testing/template/from.ts

@@ -0,0 +1,86 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import type { Query } from "./query.js";
+
+type TemplateLike = { readonly strings: readonly string[]; readonly values: readonly unknown[] };
+
+// Duck-typed, DOM-free check for a Lit TemplateResult (or a nested one).
+const isTemplate = (value: unknown): value is TemplateLike =>
+  typeof value === "object" &&
+  value !== null &&
+  Array.isArray((value as { strings?: unknown }).strings) &&
+  Array.isArray((value as { values?: unknown }).values);
+
+// Static markup + interpolated primitives, concatenated (recursive). Symbols
+// (e.g. `nothing`), null/undefined, booleans and functions contribute no text.
+const collectText = (value: unknown): string => {
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "bigint") return String(value);
+  if (Array.isArray(value)) return value.map(collectText).join("");
+  if (isTemplate(value)) {
+    let out = "";
+    for (let i = 0; i < value.strings.length; i++) {
+      out += value.strings[i];
+      if (i < value.values.length) out += collectText(value.values[i]);
+    }
+    return out;
+  }
+  return "";
+};
+
+// Every leaf binding value, flattened; nested templates are recursed into but
+// not themselves pushed (those are exposed as `children`).
+const collectValues = (value: unknown, into: unknown[]): void => {
+  if (isTemplate(value)) {
+    for (const v of value.values) collectValues(v, into);
+  } else if (Array.isArray(value)) {
+    for (const v of value) collectValues(v, into);
+  } else {
+    into.push(value);
+  }
+};
+
+// The interpolated child templates directly inside `result` (flattening arrays,
+// but not descending through other templates — `find` handles depth).
+const collectChildren = (result: TemplateLike): Query[] => {
+  const children: Query[] = [];
+  const visit = (value: unknown): void => {
+    if (isTemplate(value)) children.push(build(value));
+    else if (Array.isArray(value)) value.forEach(visit);
+  };
+  for (const v of result.values) visit(v);
+  return children;
+};
+
+const build = (result: TemplateLike): Query => {
+  const text = collectText(result);
+  const values: unknown[] = [];
+  for (const v of result.values) collectValues(v, values);
+  const children = collectChildren(result);
+  const find = (fragment: string): Query | undefined => {
+    for (const child of children) {
+      if (child.text.includes(fragment)) return child;
+      const deep = child.find(fragment);
+      if (deep) return deep;
+    }
+    return undefined;
+  };
+  return {
+    text,
+    values,
+    children,
+    has: (fragment) => text.includes(fragment),
+    find,
+  };
+};
+
+/**
+ * Wrap a presentation's `render(props)` output in a {@link Query} for DOM-free
+ * assertions. Throws if given something that isn't a `TemplateResult`, so a
+ * presentation that returns `nothing`/`undefined` fails loudly at the call site.
+ */
+export const from = (result: unknown): Query => {
+  if (!isTemplate(result)) {
+    throw new TypeError("Template.from expects a Lit TemplateResult");
+  }
+  return build(result);
+};

package/src/testing/template/public.ts

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export { from } from "./from.js";
+export type { Query } from "./query.js";