@wcstack/devtools 4.10.1 → 4.11.0

package/dist/index.d.ts

@@ -2,7 +2,7 @@
  * bootstrapDevtools.ts
  *
  * `<wcs-devtools>` の登録と自動挿入（devtools-tag-design.md §2）。
- * - 既に定義済みなら再定義しない
+ * - 既に定義済みなら再定義しない（別のコピーが定義していれば 1 回警告する — registerComponents.ts）
  * - ページに `<wcs-devtools>` が無ければ body 末尾に 1 つ挿入
  *   （手動で書かれていれば挿入しない）
  * - SSR では何もしない

package/dist/index.esm.js

@@ -1,3 +1,5 @@
+var pkg = {"name":"@wcstack/devtools","version":"4.11.0"};
+
 /**
  * protocol/types.ts
  *
@@ -2218,16 +2220,86 @@ class WcsDevtools extends HTMLElement {
     }
 }
 
+// ===========================================================================
+// AUTO-GENERATED FILE - DO NOT EDIT.
+// Generated from /protocol/define-element.ts by scripts/sync-protocol-types.mjs.
+// Run `node scripts/sync-protocol-types.mjs` after editing the source.
+// ===========================================================================
+/**
+ * One copy of each package on a page (docs/timing-and-firing-contract.md §24). The first copy the
+ * page evaluates defines the tags and a second one does nothing, so a copy that finds its tag defined
+ * by another copy of the package — not its class, not a subclass of it, not the same version — warns
+ * `[wcs/package-twice]` once per registry, naming both versions. The classes it defines carry
+ * `"<package>@<version>"` under `Symbol.for("wcstack.package")`; a class without it is named
+ * "another copy of <package> that does not name its version" (an older copy, or one loaded through
+ * an entry that does not stamp).
+ */
+/** The static a class defined through this helper carries: `"@wcstack/fetch@<version>"`. */
+const PACKAGE_STAMP = Symbol.for("wcstack.package");
+/** The registries this copy warned about: one warning per package per registry. */
+const warned = new WeakSet();
+/**
+ * Marks `cls` as defined by `pkg` (`"@wcstack/fetch@<version>"`). A subclass inherits the mark, and
+ * `defineProperty` writes it even where a parent's mark is read-only.
+ */
+function stampPackage(cls, pkg) {
+    Object.defineProperty(cls, PACKAGE_STAMP, { value: pkg, configurable: true });
+}
+/**
+ * Warns when `tag` is defined as `existing` by another copy of the package `pkg` names: `existing`
+ * is neither `own` nor a subclass of it (omit `own` when the copy has no class to compare with), and
+ * carries another version or none. Once per registry.
+ */
+function warnIfAnotherCopy(registry, tag, existing, own, pkg) {
+    if (own !== undefined && (existing === own || existing.prototype instanceof own))
+        return;
+    const theirs = existing[PACKAGE_STAMP];
+    if (theirs === pkg || warned.has(registry))
+        return;
+    warned.add(registry);
+    const name = pkg.slice(0, pkg.lastIndexOf("@"));
+    console.warn(`[${name}] [wcs/package-twice] <${tag}> is already defined by ` +
+        `${theirs ?? `another copy of ${name} that does not name its version`}; ` +
+        `this copy, ${pkg}, does nothing. Load each package once.`);
+}
+/**
+ * Defines each `[tag, class]` in `registry` unless the tag is already defined, stamping the class
+ * with `pkg` (`"@wcstack/fetch@<version>"`). A tag another copy of the package defined first is left
+ * as it is, with the warning above.
+ */
+function defineElements(registry, pkg, definitions) {
+    for (const [tag, cls] of definitions) {
+        const existing = registry.get(tag);
+        if (existing === undefined) {
+            stampPackage(cls, pkg);
+            registry.define(tag, cls);
+        }
+        else {
+            warnIfAnotherCopy(registry, tag, existing, cls, pkg);
+        }
+    }
+}
+
+const TAG_NAME = "wcs-devtools";
+/**
+ * `<wcs-devtools>` を `registry` に定義する（定義済みなら何もしない。別のコピーが定義していれば
+ * 版を名指しして 1 回警告する — docs/timing-and-firing-contract.md §24）。
+ */
+function registerComponents(registry = customElements) {
+    defineElements(registry, `${pkg.name}@${pkg.version}`, [
+        [TAG_NAME, WcsDevtools],
+    ]);
+}
+
 /**
  * bootstrapDevtools.ts
  *
  * `<wcs-devtools>` の登録と自動挿入（devtools-tag-design.md §2）。
- * - 既に定義済みなら再定義しない
+ * - 既に定義済みなら再定義しない（別のコピーが定義していれば 1 回警告する — registerComponents.ts）
  * - ページに `<wcs-devtools>` が無ければ body 末尾に 1 つ挿入
  *   （手動で書かれていれば挿入しない）
  * - SSR では何もしない
  */
-const TAG_NAME = "wcs-devtools";
 function insertIfAbsent() {
     if (document.querySelector(TAG_NAME) !== null) {
         return;
@@ -2238,9 +2310,7 @@ function bootstrapDevtools() {
     if (document.documentElement.hasAttribute("data-wcs-server")) {
         return;
     }
-    if (!customElements.get(TAG_NAME)) {
-        customElements.define(TAG_NAME, WcsDevtools);
-    }
+    registerComponents();
     if (document.body !== null) {
         insertIfAbsent();
     }