@adobe/data 0.5.2 → 0.5.4

package/dist/blob/blob-handle.d.ts

@@ -0,0 +1,29 @@
+import { FromSchema } from "../schema/schema.js";
+export declare const BlobHandleSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly handle: {
+            readonly type: "string";
+        };
+        readonly expires: {
+            readonly type: "string";
+        };
+        readonly type: {
+            readonly type: "string";
+        };
+        readonly size: {
+            readonly type: "number";
+        };
+        readonly width: {
+            readonly type: "number";
+        };
+        readonly height: {
+            readonly type: "number";
+        };
+        readonly duration: {
+            readonly type: "number";
+        };
+    };
+    readonly required: readonly ["type", "size", "handle"];
+};
+export type BlobHandle = FromSchema<typeof BlobHandleSchema>;

package/dist/blob/blob-handle.js

@@ -0,0 +1,11 @@
+import { BlobMetaSchema } from "./blob-meta.js";
+export const BlobHandleSchema = {
+    type: 'object',
+    properties: {
+        ...BlobMetaSchema.properties,
+        handle: { type: 'string' },
+        expires: { type: 'string' },
+    },
+    required: [...BlobMetaSchema.required, 'handle'],
+};
+//# sourceMappingURL=blob-handle.js.map

package/dist/blob/blob-handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-handle.js","sourceRoot":"","sources":["../../src/blob/blob-handle.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAI1D,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACR,GAAG,cAAc,CAAC,UAAU;QAC5B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC9B;IACD,QAAQ,EAAE,CAAC,GAAG,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC;CACzB,CAAC"}

package/dist/blob/blob-meta.d.ts

@@ -0,0 +1,23 @@
+import { FromSchema } from "../schema/schema.js";
+export declare const BlobMetaSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly type: {
+            readonly type: "string";
+        };
+        readonly size: {
+            readonly type: "number";
+        };
+        readonly width: {
+            readonly type: "number";
+        };
+        readonly height: {
+            readonly type: "number";
+        };
+        readonly duration: {
+            readonly type: "number";
+        };
+    };
+    readonly required: readonly ["type", "size"];
+};
+export type BlobMeta = FromSchema<typeof BlobMetaSchema>;

package/dist/blob/blob-meta.js

@@ -0,0 +1,12 @@
+export const BlobMetaSchema = {
+    type: 'object',
+    properties: {
+        type: { type: 'string' },
+        size: { type: 'number' },
+        width: { type: 'number' },
+        height: { type: 'number' },
+        duration: { type: 'number' },
+    },
+    required: ['type', 'size'],
+};
+//# sourceMappingURL=blob-meta.js.map

package/dist/blob/blob-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-meta.js","sourceRoot":"","sources":["../../src/blob/blob-meta.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACR,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC/B;IACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;CACH,CAAC"}

package/dist/blob/download-handle.d.ts

@@ -0,0 +1,4 @@
+import { BlobHandle } from "./blob-handle.js";
+export type DownloadHandle = BlobHandle & {
+    download: true;
+};

package/dist/blob/download-handle.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=download-handle.js.map

package/dist/blob/download-handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-handle.js","sourceRoot":"","sources":["../../src/blob/download-handle.ts"],"names":[],"mappings":""}

package/dist/blob/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./blob-handle.js";
+export * from "./blob-meta.js";
+export * from "./download-handle.js";
+export * from "./upload-handle.js";

package/dist/blob/index.js

@@ -0,0 +1,5 @@
+export * from "./blob-handle.js";
+export * from "./blob-meta.js";
+export * from "./download-handle.js";
+export * from "./upload-handle.js";
+//# sourceMappingURL=index.js.map

package/dist/blob/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/blob/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC"}

package/dist/blob/upload-handle.d.ts

@@ -0,0 +1,4 @@
+import { BlobHandle } from "./blob-handle.js";
+export type UploadHandle = BlobHandle & {
+    upload: true;
+};

package/dist/blob/upload-handle.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=upload-handle.js.map

package/dist/blob/upload-handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-handle.js","sourceRoot":"","sources":["../../src/blob/upload-handle.ts"],"names":[],"mappings":""}

package/dist/lit/elements/application-element.d.ts

@@ -0,0 +1,9 @@
+import { LitElement } from 'lit';
+import { Service } from '../../service/index.js';
+export declare class ApplicationElement<MainService extends Service> extends LitElement {
+    service: MainService;
+    constructor();
+    connectedCallback(): void;
+    protected findAncestorService(): MainService | void;
+    render(): void;
+}

package/dist/lit/elements/application-element.js

@@ -0,0 +1,62 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { LitElement } from 'lit';
+import { property } from 'lit/decorators.js';
+import { attachDecorator, withHooks } from '../hooks/index.js';
+import { iterateSelfAndAncestors } from '../functions/index.js';
+import { isService } from '../../service/index.js';
+export class ApplicationElement extends LitElement {
+    constructor() {
+        super();
+        attachDecorator(this, 'render', withHooks);
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        if (!this.service) {
+            const service = this.findAncestorService();
+            if (service) {
+                this.service = service;
+            }
+        }
+    }
+    findAncestorService() {
+        for (const element of iterateSelfAndAncestors(this)) {
+            const { service } = element;
+            if (isService(service)) {
+                return service;
+            }
+        }
+    }
+    render() {
+        throw new Error('render function must be overridden');
+    }
+}
+__decorate([
+    property({ type: Object, reflect: false })
+], ApplicationElement.prototype, "service", void 0);
+//# sourceMappingURL=application-element.js.map

package/dist/lit/elements/application-element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-element.js","sourceRoot":"","sources":["../../../src/lit/elements/application-element.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;;;;;;;AAEX,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAW,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,OAAO,kBAAgD,SAAQ,UAAU;IAI7E;QACE,KAAK,EAAE,CAAC;QACR,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,iBAAiB;QACf,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAE1B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC3C,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAES,mBAAmB;QAC3B,KAAK,MAAM,OAAO,IAAI,uBAAuB,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,MAAM,EAAE,OAAO,EAAE,GAAG,OAAmD,CAAC;YACxE,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;gBACvB,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM;QACJ,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;CAEF;AA/BC;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;mDACrB"}

package/dist/lit/elements/service-application.js

@@ -29,6 +29,7 @@ import { html, LitElement } from "lit";
 import { property } from "lit/decorators.js";
 import { provide } from "@lit/context";
 import { serviceContext } from "./service-context.js";
+import { isDisposable } from "../../service/disposable.js";
 export class ServiceApplication extends LitElement {
     async updated(changedProperties) {
         super.updated(changedProperties);
@@ -36,7 +37,9 @@ export class ServiceApplication extends LitElement {
     }
     disconnectedCallback() {
         super.disconnectedCallback();
-        this.service?.dispose?.();
+        if (isDisposable(this.service)) {
+            this.service.dispose();
+        }
         this.service = null;
     }
     render() {

package/dist/lit/elements/service-application.js.map

@@ -1 +1 @@
-{"version":3,"file":"service-application.js","sourceRoot":"","sources":["../../../src/lit/elements/service-application.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;;;;;;;AAEX,OAAO,EAAE,IAAI,EAAE,UAAU,EAAkB,MAAM,KAAK,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,MAAM,OAAgB,kBAAsC,SAAQ,UAAU;IAQjE,KAAK,CAAC,OAAO,CAAC,iBAAiC;QACpD,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,KAAK,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IAChD,CAAC;IAEQ,oBAAoB;QACzB,KAAK,CAAC,oBAAoB,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,IAAW,CAAC;IAC/B,CAAC;IAEQ,MAAM;QACX,OAAO,IAAI,CAAA;;SAEV,CAAC;IACN,CAAC;CACJ;AApBa;IAFT,OAAO,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IACpC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;mDACL"}
+{"version":3,"file":"service-application.js","sourceRoot":"","sources":["../../../src/lit/elements/service-application.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;;;;;;;AAEX,OAAO,EAAE,IAAI,EAAE,UAAU,EAAkB,MAAM,KAAK,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,MAAM,OAAgB,kBAAsC,SAAQ,UAAU;IAQjE,KAAK,CAAC,OAAO,CAAC,iBAAiC;QACpD,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,KAAK,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IAChD,CAAC;IAEQ,oBAAoB;QACzB,KAAK,CAAC,oBAAoB,EAAE,CAAC;QAC7B,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAW,CAAC;IAC/B,CAAC;IAEQ,MAAM;QACX,OAAO,IAAI,CAAA;;SAEV,CAAC;IACN,CAAC;CACJ;AAtBa;IAFT,OAAO,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IACpC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;mDACL"}

package/dist/lit/functions/index.d.ts

@@ -0,0 +1 @@
+export * from "./iterate-self-and-ancestors.js";

package/dist/{ecs/action-ecs → lit/functions}/index.js

@@ -19,5 +19,5 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.*/
-export * from "./action-ecs.js";
+export * from "./iterate-self-and-ancestors.js";
 //# sourceMappingURL=index.js.map

package/dist/lit/functions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lit/functions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,cAAc,iCAAiC,CAAC"}

package/dist/lit/functions/iterate-self-and-ancestors.d.ts

@@ -0,0 +1 @@
+export declare function iterateSelfAndAncestors(element: Element): IterableIterator<Element>;

package/dist/{core/functions/array-equals.js → lit/functions/iterate-self-and-ancestors.js}

@@ -19,16 +19,26 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.*/
-export function arrayEquals(a, b) {
-    const length = a.length;
-    if (length !== b.length) {
-        return false;
-    }
-    for (let i = 0; i < length; i++) {
-        if (a[i] !== b[i]) {
-            return false;
+export function* iterateSelfAndAncestors(element) {
+    let current = element;
+    while (current) {
+        yield current;
+        if (current instanceof HTMLSlotElement && current.assignedSlot) {
+            // Move to the slot's parent if the current element is assigned to a slot
+            current = current.assignedSlot;
+        }
+        else if (current.parentNode instanceof Element) {
+            // Move up to the parent node if it is an element
+            current = current.parentNode;
+        }
+        else if (current.getRootNode().host) {
+            // Move to the host element if we're at a shadow root
+            current = current.getRootNode().host;
+        }
+        else {
+            // If no more ancestors, stop the iteration
+            current = null;
         }
     }
-    return true;
 }
-//# sourceMappingURL=array-equals.js.map
+//# sourceMappingURL=iterate-self-and-ancestors.js.map

package/dist/lit/functions/iterate-self-and-ancestors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterate-self-and-ancestors.js","sourceRoot":"","sources":["../../../src/lit/functions/iterate-self-and-ancestors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,MAAM,SAAS,CAAC,CAAC,uBAAuB,CAAC,OAAgB;IACrD,IAAI,OAAO,GAAmB,OAAO,CAAC;IAEtC,OAAO,OAAO,EAAE,CAAC;QACb,MAAM,OAAO,CAAC;QAEd,IAAI,OAAO,YAAY,eAAe,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YAC7D,yEAAyE;YACzE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;QACnC,CAAC;aAAM,IAAI,OAAO,CAAC,UAAU,YAAY,OAAO,EAAE,CAAC;YAC/C,iDAAiD;YACjD,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;QACjC,CAAC;aAAM,IAAK,OAAO,CAAC,WAAW,EAAiB,CAAC,IAAI,EAAE,CAAC;YACpD,qDAAqD;YACrD,OAAO,GAAI,OAAO,CAAC,WAAW,EAAiB,CAAC,IAAI,CAAC;QACzD,CAAC;aAAM,CAAC;YACJ,2CAA2C;YAC3C,OAAO,GAAG,IAAI,CAAC;QACnB,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/lit/hooks/attach-decorator.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Attacheds a decorator to a method on an object and reassigns the resulting value back to the object.
+ */
+export declare function attachDecorator<T, K extends keyof T>(obj: T, property: K, decorator: (target: any, propertyKey: string, descriptor: TypedPropertyDescriptor<T[K]>) => PropertyDescriptor): void;

package/dist/{service/sequential-action.js → lit/hooks/attach-decorator.js}

@@ -20,26 +20,27 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.*/
 /**
- * Executes a sequential action using an async iterable iterator that provides the arguments.
- * @param action - The action to execute.
- * @param argProvider - An async iterable iterator of arguments to pass to the action.
+ * Attacheds a decorator to a method on an object and reassigns the resulting value back to the object.
  */
-export async function executeSequentialAction(action, argProvider) {
-    let sequence;
-    try {
-        //  get the next arguments from the arg provider
-        for await (const arg of argProvider) {
-            //  then write them into the multiframe transaction (persisting this set of updates into database)
-            sequence = (sequence?.update ?? action)(arg);
+export function attachDecorator(obj, property, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- This is a generic type
+decorator) {
+    // Get the descriptor of the property
+    let descriptor = Object.getOwnPropertyDescriptor(obj, property);
+    if (!descriptor) {
+        if (!obj[property]) {
+            throw new Error(`Property ${property.toString()} does not exist on object`);
         }
-        //  everything succeeded, finalize this transaction.
-        sequence?.commit();
-    }
-    catch (e) {
-        //  cancel the sequence
-        sequence?.cancel();
-        //  allow the async iterable iterator to finalize and close any open resources
-        argProvider.throw?.(e);
+        descriptor = {
+            value: obj[property],
+            writable: true,
+            enumerable: true,
+            configurable: true,
+        };
     }
+    // Apply the decorator to the descriptor
+    const decoratedDescriptor = decorator(obj, String(property), descriptor);
+    // Reassign the decorated method back to the object
+    obj[property] = decoratedDescriptor.value;
 }
-//# sourceMappingURL=sequential-action.js.map
+//# sourceMappingURL=attach-decorator.js.map

package/dist/lit/hooks/attach-decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach-decorator.js","sourceRoot":"","sources":["../../../src/lit/hooks/attach-decorator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX;;GAEG;AACH,MAAM,UAAU,eAAe,CAC3B,GAAM,EACN,QAAW;AACX,wFAAwF;AACxF,SAA8G;IAE9G,qCAAqC;IACrC,IAAI,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAEhE,IAAI,CAAC,UAAU,EAAE,CAAC;QACd,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,YAAY,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC,CAAC;QAChF,CAAC;QACD,UAAU,GAAG;YACT,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC;YACpB,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,IAAI;SACrB,CAAC;IACN,CAAC;IAED,wCAAwC;IACxC,MAAM,mBAAmB,GAAG,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC;IAEzE,mDAAmD;IACnD,GAAG,CAAC,QAAQ,CAAC,GAAG,mBAAmB,CAAC,KAAK,CAAC;AAC9C,CAAC"}

package/dist/lit/hooks/index.d.ts

@@ -11,3 +11,4 @@ export * from "./use-window-event.js";
 export * from "./use-resize-observer.js";
 export * from "./use-element.js";
 export * from "./with-hooks.js";
+export * from "./attach-decorator.js";

package/dist/lit/hooks/index.js

@@ -32,4 +32,5 @@ export * from "./use-window-event.js";
 export * from "./use-resize-observer.js";
 export * from "./use-element.js";
 export * from "./with-hooks.js";
+export * from "./attach-decorator.js";
 //# sourceMappingURL=index.js.map

package/dist/lit/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lit/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lit/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"}

package/dist/lit/hooks/use-drag-observe.d.ts

@@ -0,0 +1,22 @@
+import { DraggableProps, Vector2 } from './use-draggable.js';
+export type DragObserveProps = Pick<DraggableProps, 'minDragDistance' | 'dragCursor' | 'addPlaceholder' | 'stopPropagation'>;
+export type DragStart = {
+    readonly type: 'start' | 'cancel';
+};
+export type DragMove = {
+    readonly type: 'move';
+    readonly delta: Vector2;
+    readonly position: Vector2;
+};
+export type DragEnd = {
+    readonly type: 'end';
+    readonly position: Vector2;
+};
+export type DragState = DragStart | DragMove | DragEnd;
+/**
+ * This hook creates a drag observe function that can be used to observe the drag state of an element.
+ * This is normally not used directly, but rather through the `useDragTransaction` hook.
+ * @param props
+ * @returns
+ */
+export declare function useDragObserve(props: DragObserveProps, dependencies: unknown[]): import("@adobe/data/observe").Observe<DragState>;

package/dist/{ecs/entity-location-table/register-entity-location-table-codec.js → lit/hooks/use-drag-observe.js}

@@ -19,24 +19,37 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.*/
-import { registerCodec } from "../../functions/serialization/codec.js";
-import { restoreEntityLocationTable } from "./create-entity-location-table.js";
-function isEntityLocationTable(value) {
-    return value !== null && typeof value === "object" && "create" in value && "update" in value && "delete" in value && "locate" in value && "serialize" in value;
-}
-export function registerEntityLocationTableCodec() {
-    registerCodec({
-        name: "entity-location-table",
-        predicate: isEntityLocationTable,
-        serialize: (data) => {
-            return data.serialize();
+import { useDraggable } from './use-draggable.js';
+import { useElement } from './use-element.js';
+import { createObservableEvent } from '@adobe/data/observe';
+/**
+ * This hook creates a drag observe function that can be used to observe the drag state of an element.
+ * This is normally not used directly, but rather through the `useDragTransaction` hook.
+ * @param props
+ * @returns
+ */
+export function useDragObserve(props, dependencies) {
+    const [dragState, setDragState] = createObservableEvent();
+    const element = useElement();
+    useDraggable(element, () => ({
+        ...props,
+        onDragStart: _e => {
+            setDragState({ type: 'start' });
         },
-        deserialize: ({ json, binary }) => {
-            return restoreEntityLocationTable({
-                json: json ?? {},
-                binary: binary ?? []
+        onDrag: (_e, position, delta) => {
+            setDragState({
+                type: 'move',
+                position,
+                delta,
             });
         },
-    });
+        onDragEnd: (_e, position) => {
+            setDragState({ type: 'end', position });
+        },
+        onDragCancel: () => {
+            setDragState({ type: 'cancel' });
+        },
+    }), dependencies);
+    return dragState;
 }
-//# sourceMappingURL=register-entity-location-table-codec.js.map
+//# sourceMappingURL=use-drag-observe.js.map

package/dist/lit/hooks/use-drag-observe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-drag-observe.js","sourceRoot":"","sources":["../../../src/lit/hooks/use-drag-observe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,OAAO,EAA2B,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAoB5D;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAuB,EAAE,YAAuB;IAC3E,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,qBAAqB,EAAa,CAAC;IACrE,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,YAAY,CAAC,OAAO,EAChB,GAAG,EAAE,CAAC,CAAC;QACH,GAAG,KAAK;QACR,WAAW,EAAE,EAAE,CAAC,EAAE;YACd,YAAY,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACpC,CAAC;QACD,MAAM,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;YAC5B,YAAY,CAAC;gBACT,IAAI,EAAE,MAAM;gBACZ,QAAQ;gBACR,KAAK;aACR,CAAC,CAAC;QACP,CAAC;QACD,SAAS,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE;YACxB,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,YAAY,EAAE,GAAG,EAAE;YACf,YAAY,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrC,CAAC;KACJ,CAAC,EACF,YAAY,CACf,CAAC;IACF,OAAO,SAAS,CAAC;AACrB,CAAC"}

package/dist/lit/hooks/use-drag-transaction.d.ts

@@ -0,0 +1,8 @@
+import { DragEnd, DragMove, DragObserveProps } from './use-drag-observe.js';
+import { AsyncArgsProvider } from '@adobe/data/ecs';
+export type DragTransactionProps<T> = DragObserveProps & {
+    transaction: (asyncArgs: AsyncArgsProvider<T>) => void;
+    update: (drag: DragMove) => T;
+    finish: (drag: DragEnd) => T;
+};
+export declare function useDragTransaction<T>(propsFactory: () => DragTransactionProps<T>, dependencies: unknown[]): void;

package/dist/lit/hooks/use-drag-transaction.js

@@ -0,0 +1,56 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+import { useDragObserve } from './use-drag-observe.js';
+import { useEffect } from "./use-effect.js";
+import { toAsyncGenerator, withFilter } from '@adobe/data/observe';
+export function useDragTransaction(propsFactory, dependencies) {
+    const props = propsFactory();
+    const { transaction, update, finish } = props;
+    const dragObserve = useDragObserve(props, dependencies);
+    const startDragTransaction = () => {
+        let done = false;
+        // we start the transaction by calling it with an async generator that will yield the args asynchronously
+        transaction(
+        // we create the async generator by mapping the dragObserve state changes to transaction args
+        () => toAsyncGenerator(
+        // this uses the withMap function and the provided update and finish functions
+        // any type 'start' will just be ignored and filtered out
+        withFilter(dragObserve, value => {
+            if (value.type === 'end') {
+                done = true;
+                return finish(value);
+            }
+            if (value.type === 'move') {
+                return update(value);
+            }
+        }), _value => done));
+    };
+    // now we will observe the drag state and start a new transaction whenever a drag starts
+    useEffect(() => {
+        return dragObserve(value => {
+            if (value.type === 'start') {
+                startDragTransaction();
+            }
+        });
+    }, dependencies);
+}
+//# sourceMappingURL=use-drag-transaction.js.map

package/dist/lit/hooks/use-drag-transaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-drag-transaction.js","sourceRoot":"","sources":["../../../src/lit/hooks/use-drag-transaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,OAAO,EAAuC,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAQnE,MAAM,UAAU,kBAAkB,CAAI,YAA2C,EAAE,YAAuB;IACtG,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;IAC7B,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAC9C,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IACxD,MAAM,oBAAoB,GAAG,GAAG,EAAE;QAC9B,IAAI,IAAI,GAAG,KAAK,CAAC;QACjB,yGAAyG;QACzG,WAAW;QACP,6FAA6F;QAC7F,GAAG,EAAE,CACD,gBAAgB;QACZ,8EAA8E;QAC9E,yDAAyD;QACzD,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE;YAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBACvB,IAAI,GAAG,IAAI,CAAC;gBACZ,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACxB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;QACL,CAAC,CAAC,EACF,MAAM,CAAC,EAAE,CAAC,IAAI,CACjB,CACR,CAAC;IACN,CAAC,CAAC;IACF,wFAAwF;IACxF,SAAS,CAAC,GAAG,EAAE;QACX,OAAO,WAAW,CAAC,KAAK,CAAC,EAAE;YACvB,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACzB,oBAAoB,EAAE,CAAC;YAC3B,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC,EAAE,YAAY,CAAC,CAAC;AACrB,CAAC"}

package/dist/lit/hooks/use-draggable.d.ts

@@ -0,0 +1,16 @@
+export type Vector2 = readonly [number, number];
+export interface DraggableProps {
+    onDragStart: (e: PointerEvent) => Vector2 | void;
+    onDrag: (e: PointerEvent, newPosition: Vector2, delta: Vector2) => void;
+    onDragEnd?: (e: PointerEvent, newPosition: Vector2) => void;
+    /**
+     * Called if this hook is destroyed before the drag is completed.
+     */
+    onDragCancel?: () => void;
+    initialDownPosition?: Vector2;
+    minDragDistance?: number;
+    dragCursor?: string;
+    addPlaceholder?: boolean;
+    stopPropagation?: boolean;
+}
+export declare function useDraggable(element: HTMLElement, propsFunction: () => DraggableProps, dependencies: unknown[]): void;