@citolab/qti-components 7.14.3 → 7.15.0

package/dist/chunk-2ZEJ3RR5.js

@@ -0,0 +1,89 @@
+// ../lit-utilities/src/decorators/watch.ts
+function watch(propertyName, options) {
+  const resolvedOptions = {
+    waitUntilFirstUpdate: false,
+    ...options
+  };
+  return (proto, decoratedFnName) => {
+    const { update } = proto;
+    const watchedProperties = Array.isArray(propertyName) ? propertyName : [propertyName];
+    proto.update = function(changedProps) {
+      watchedProperties.forEach((property) => {
+        const key = property;
+        if (changedProps.has(key)) {
+          const oldValue = changedProps.get(key);
+          const newValue = this[key];
+          if (oldValue !== newValue) {
+            if (!resolvedOptions.waitUntilFirstUpdate || this.hasUpdated) {
+              this[decoratedFnName](oldValue, newValue);
+            }
+          }
+        }
+      });
+      update.call(this, changedProps);
+    };
+  };
+}
+
+// ../lit-utilities/src/decorators/live-query.ts
+function liveQuery(querySelector, options) {
+  return (proto, decoratedFnName) => {
+    const { connectedCallback, disconnectedCallback } = proto;
+    proto.connectedCallback = function() {
+      connectedCallback.call(this);
+      const handler = this[decoratedFnName];
+      const callback = (mutationList) => {
+        const added = [];
+        const removed = [];
+        for (const m of mutationList) {
+          if (m.type !== "childList") continue;
+          m.addedNodes.forEach((n2) => {
+            if (n2.nodeType !== 1) return;
+            const el = n2;
+            if (el.matches?.(querySelector)) added.push(el);
+            added.push(...el.querySelectorAll?.(querySelector) ?? []);
+          });
+          m.removedNodes.forEach((n2) => {
+            if (n2.nodeType !== 1) return;
+            const el = n2;
+            if (el.matches?.(querySelector)) removed.push(el);
+            removed.push(...el.querySelectorAll?.(querySelector) ?? []);
+          });
+        }
+        const dedupe = (arr) => Array.from(new Set(arr));
+        const A = dedupe(added);
+        const R = dedupe(removed);
+        if (A.length || R.length) {
+          handler.call(this, A, R);
+        }
+      };
+      const obsLight = new MutationObserver(callback);
+      obsLight.observe(this, { childList: true, subtree: true });
+      const obsShadow = this.shadowRoot ? new MutationObserver(callback) : null;
+      obsShadow?.observe(this.shadowRoot, { childList: true, subtree: true });
+      this.__lqObservers = [obsLight, obsShadow].filter((o) => !!o);
+      const fireInitial = async () => {
+        if (options?.waitUntilFirstUpdate && "updateComplete" in this) {
+          await this.updateComplete;
+        }
+        const initial = [
+          ...this.querySelectorAll(querySelector),
+          ...this.shadowRoot?.querySelectorAll(querySelector) ?? []
+        ];
+        if (initial.length) handler.call(this, initial, []);
+      };
+      void fireInitial();
+    };
+    proto.disconnectedCallback = function() {
+      disconnectedCallback.call(this);
+      this.__lqObservers?.forEach((o) => o.disconnect());
+      this.__lqObservers = void 0;
+    };
+  };
+}
+
+export {
+  liveQuery,
+  watch
+};
+//# sourceMappingURL=chunk-2ZEJ3RR5.js.map

package/dist/chunk-2ZEJ3RR5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../lit-utilities/src/decorators/watch.ts","../../lit-utilities/src/decorators/live-query.ts"],"sourcesContent":["import type { LitElement } from 'lit';\n\ntype UpdateHandler = (prev?: unknown, next?: unknown) => void;\n\ntype NonUndefined<A> = A extends undefined ? never : A;\n\nexport type UpdateHandlerFunctionKeys<T extends object> = {\n  [K in keyof T]-?: NonUndefined<T[K]> extends UpdateHandler ? K : never;\n}[keyof T];\n\ninterface WatchOptions {\n  /**\n   * If true, will only start watching after the initial update/render\n   */\n  waitUntilFirstUpdate?: boolean;\n}\n\n/**\n * Runs when observed properties change, e.g. @property or @state, but before the component updates. To wait for an\n * update to complete after a change occurs, use `await this.updateComplete` in the handler. To start watching after the\n * initial update/render, use `{ waitUntilFirstUpdate: true }` or `this.hasUpdated` in the handler.\n *\n * Usage:\n *\n * @watch('propName')\n * handlePropChange(oldValue, newValue) {\n *   ...\n * }\n */\nexport function watch(propertyName: string | string[], options?: WatchOptions) {\n  const resolvedOptions: Required<WatchOptions> = {\n    waitUntilFirstUpdate: false,\n    ...options\n  };\n  return <ElemClass extends LitElement>(\n    proto: ElemClass,\n    decoratedFnName: UpdateHandlerFunctionKeys<ElemClass> | any\n  ) => {\n    // @ts-expect-error - update is a protected property\n    const { update } = proto;\n    const watchedProperties = Array.isArray(propertyName) ? propertyName : [propertyName];\n\n    // @ts-expect-error - update is a protected property\n    proto.update = function (this: ElemClass, changedProps: Map<keyof ElemClass, ElemClass[keyof ElemClass]>) {\n      watchedProperties.forEach(property => {\n        const key = property as keyof ElemClass;\n        if (changedProps.has(key)) {\n          const oldValue = changedProps.get(key);\n          const newValue = this[key];\n\n          if (oldValue !== newValue) {\n            if (!resolvedOptions.waitUntilFirstUpdate || this.hasUpdated) {\n              ((this as any)[decoratedFnName] as unknown as UpdateHandler)(oldValue, newValue);\n            }\n          }\n        }\n      });\n\n      update.call(this, changedProps);\n    };\n  };\n}\n","import type { LitElement } from 'lit';\n\ntype LiveQueryHandler = (added: Element[], removed: Element[]) => void;\ntype LiveQueryHandlerKeys<T extends object> = {\n  [K in keyof T]-?: T[K] extends LiveQueryHandler ? K : never;\n}[keyof T];\n\ninterface LiveQueryOptions {\n  /**\n   * If true, will only start watching after the initial update/render\n   */\n  waitUntilFirstUpdate?: boolean;\n}\n\nexport function liveQuery(querySelector: string, options?: LiveQueryOptions) {\n  return <ElemClass extends LitElement>(proto: ElemClass, decoratedFnName: LiveQueryHandlerKeys<ElemClass>): void => {\n    const { connectedCallback, disconnectedCallback } = proto;\n\n    proto.connectedCallback = function (this: ElemClass) {\n      connectedCallback.call(this);\n\n      const handler = this[decoratedFnName] as unknown as LiveQueryHandler;\n\n      const callback = (mutationList: MutationRecord[]) => {\n        const added: Element[] = [];\n        const removed: Element[] = [];\n\n        for (const m of mutationList) {\n          if (m.type !== 'childList') continue;\n\n          m.addedNodes.forEach(n => {\n            if (n.nodeType !== 1) return;\n            const el = n as Element;\n            if (el.matches?.(querySelector)) added.push(el);\n            added.push(...(el.querySelectorAll?.(querySelector) ?? []));\n          });\n\n          m.removedNodes.forEach(n => {\n            if (n.nodeType !== 1) return;\n            const el = n as Element;\n            if (el.matches?.(querySelector)) removed.push(el);\n            removed.push(...(el.querySelectorAll?.(querySelector) ?? []));\n          });\n        }\n\n        // deduplicate added and removed (might be multiples since we observe both light and shadow DOM)\n        const dedupe = (arr: Element[]) => Array.from(new Set(arr));\n        const A = dedupe(added);\n        const R = dedupe(removed);\n\n        if (A.length || R.length) {\n          handler.call(this, A, R);\n        }\n      };\n\n      // observe both light and shadow DOM\n      const obsLight = new MutationObserver(callback);\n      obsLight.observe(this, { childList: true, subtree: true });\n\n      const obsShadow = this.shadowRoot ? new MutationObserver(callback) : null;\n      obsShadow?.observe(this.shadowRoot, { childList: true, subtree: true });\n\n      (this as any).__lqObservers = [obsLight, obsShadow].filter((o): o is MutationObserver => !!o);\n\n      const fireInitial = async () => {\n        if (options?.waitUntilFirstUpdate && 'updateComplete' in this) {\n          await (this as any).updateComplete;\n        }\n        const initial = [\n          ...this.querySelectorAll(querySelector),\n          ...(this.shadowRoot?.querySelectorAll(querySelector) ?? [])\n        ] as Element[];\n        if (initial.length) handler.call(this, initial, []);\n      };\n\n      void fireInitial();\n    };\n\n    proto.disconnectedCallback = function (this: ElemClass) {\n      disconnectedCallback.call(this);\n      (this as any).__lqObservers?.forEach((o: MutationObserver) => o.disconnect());\n      (this as any).__lqObservers = undefined;\n    };\n  };\n}\n"],"mappings":"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","names":["n"]}