@wippy-fe/vue-utils 0.0.35

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Runtime warn-handler that filters `[Vue warn]: Failed to resolve component:`
+ * for tags registered via `customElements.define` (system + dynamic autoload).
+ * Build-time `compilerOptions.isCustomElement` can't enumerate dynamic
+ * registrations; this can. PascalCase typos still pass through.
+ */
+interface VueAppLike {
+    config: {
+        warnHandler?: ((msg: string, instance: unknown, trace: string) => void) | null;
+    };
+}
+declare const VUE_WARN_SUPPRESSOR_INSTALLED_MARKER: unique symbol;
+/**
+ * Installs a Vue warn-handler on `app` that suppresses component-resolution
+ * warnings for kebab-named tags (registered or pending registration).
+ * Call once after `createApp` — typically in your app bootstrap.
+ *
+ * Suppressed warnings do NOT reach `previous`. If you need a telemetry tap
+ * that sees every warning, install it FIRST so it becomes `previous` for
+ * non-suppressed warnings only.
+ */
+declare function installVueWarnSuppressor(app: VueAppLike): void;
+
+export { VUE_WARN_SUPPRESSOR_INSTALLED_MARKER, installVueWarnSuppressor };

package/dist/index.js

@@ -0,0 +1,57 @@
+// src/vue-warn-suppressor.ts
+var FAILED_TO_RESOLVE_RE = /Failed to resolve component:\s*([\w-]+)/;
+var CUSTOM_ELEMENT_NAME_RE = /^[a-z][a-z0-9]*-[a-z0-9-]*$/;
+var VUE_WARN_SUPPRESSOR_INSTALLED_MARKER = /* @__PURE__ */ Symbol.for("@wippy-fe/proxy/vue-warn-suppressor-installed");
+function safeStr(v) {
+  if (typeof v === "string")
+    return v;
+  try {
+    return String(v);
+  } catch {
+    return "<non-serializable warning>";
+  }
+}
+function installVueWarnSuppressor(app) {
+  const cfg = app.config;
+  if (cfg[VUE_WARN_SUPPRESSOR_INSTALLED_MARKER])
+    return;
+  try {
+    cfg[VUE_WARN_SUPPRESSOR_INSTALLED_MARKER] = true;
+  } catch {
+    return;
+  }
+  const previous = app.config.warnHandler;
+  app.config.warnHandler = (rawMsg, instance, rawTrace) => {
+    const msg = safeStr(rawMsg);
+    const trace = safeStr(rawTrace);
+    const match = msg.match(FAILED_TO_RESOLVE_RE);
+    if (match) {
+      const tag = match[1];
+      if (typeof customElements !== "undefined" && customElements.get(tag))
+        return;
+      if (CUSTOM_ELEMENT_NAME_RE.test(tag))
+        return;
+    }
+    if (previous) {
+      try {
+        previous(msg, instance, trace);
+      } catch (err) {
+        if (typeof console !== "undefined")
+          console.error("[wippy-fe/vue-utils] previous warn-handler threw:", err);
+      }
+      return;
+    }
+    if (typeof console !== "undefined") {
+      if (trace)
+        console.warn(`[Vue warn]: ${msg}`, `
+${trace}`);
+      else
+        console.warn(`[Vue warn]: ${msg}`);
+    }
+  };
+}
+export {
+  VUE_WARN_SUPPRESSOR_INSTALLED_MARKER,
+  installVueWarnSuppressor
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vue-warn-suppressor.ts"],"sourcesContent":["/**\n * Runtime warn-handler that filters `[Vue warn]: Failed to resolve component:`\n * for tags registered via `customElements.define` (system + dynamic autoload).\n * Build-time `compilerOptions.isCustomElement` can't enumerate dynamic\n * registrations; this can. PascalCase typos still pass through.\n */\n\ninterface VueAppLike {\n  config: {\n    warnHandler?: ((msg: string, instance: unknown, trace: string) => void) | null\n  }\n}\n\nconst FAILED_TO_RESOLVE_RE = /Failed to resolve component:\\s*([\\w-]+)/\n\n// Mirror in @wippy-fe/vite-plugin's `validateComponentPackage` — keep in sync.\nconst CUSTOM_ELEMENT_NAME_RE = /^[a-z][a-z0-9]*-[a-z0-9-]*$/\n\n// Symbol.for so dual bundle copies share marker identity across realms.\nexport const VUE_WARN_SUPPRESSOR_INSTALLED_MARKER = Symbol.for('@wippy-fe/proxy/vue-warn-suppressor-installed')\n\nfunction safeStr(v: unknown): string {\n  if (typeof v === 'string')\n    return v\n  try {\n    return String(v)\n  }\n  catch {\n    return '<non-serializable warning>'\n  }\n}\n\n/**\n * Installs a Vue warn-handler on `app` that suppresses component-resolution\n * warnings for kebab-named tags (registered or pending registration).\n * Call once after `createApp` — typically in your app bootstrap.\n *\n * Suppressed warnings do NOT reach `previous`. If you need a telemetry tap\n * that sees every warning, install it FIRST so it becomes `previous` for\n * non-suppressed warnings only.\n */\nexport function installVueWarnSuppressor(app: VueAppLike): void {\n  const cfg = app.config as { warnHandler?: VueAppLike['config']['warnHandler'] } & Record<symbol, unknown>\n  if (cfg[VUE_WARN_SUPPRESSOR_INSTALLED_MARKER])\n    return\n  try {\n    cfg[VUE_WARN_SUPPRESSOR_INSTALLED_MARKER] = true\n  }\n  catch {\n    // Frozen config — can't install. Bail without crashing bootstrap.\n    return\n  }\n\n  const previous = app.config.warnHandler\n  app.config.warnHandler = (rawMsg, instance, rawTrace) => {\n    const msg = safeStr(rawMsg)\n    const trace = safeStr(rawTrace)\n    const match = msg.match(FAILED_TO_RESOLVE_RE)\n    if (match) {\n      const tag = match[1]\n      if (typeof customElements !== 'undefined' && customElements.get(tag))\n        return\n      if (CUSTOM_ELEMENT_NAME_RE.test(tag))\n        return\n    }\n    if (previous) {\n      // Isolate previous-handler throws — warnHandler runs inside Vue's\n      // render path, an uncaught throw would surface as a render error.\n      try {\n        previous(msg, instance, trace)\n      }\n      catch (err) {\n        if (typeof console !== 'undefined')\n          console.error('[wippy-fe/vue-utils] previous warn-handler threw:', err)\n      }\n      return\n    }\n    // Vue default: msg + trace as separate args so DevTools formats the stack.\n    // Only pass the trace arg when non-empty — matches Vue's own warn format.\n    if (typeof console !== 'undefined') {\n      if (trace)\n        console.warn(`[Vue warn]: ${msg}`, `\\n${trace}`)\n      else\n        console.warn(`[Vue warn]: ${msg}`)\n    }\n  }\n}\n"],"mappings":";AAaA,IAAM,uBAAuB;AAG7B,IAAM,yBAAyB;AAGxB,IAAM,uCAAuC,uBAAO,IAAI,+CAA+C;AAE9G,SAAS,QAAQ,GAAoB;AACnC,MAAI,OAAO,MAAM;AACf,WAAO;AACT,MAAI;AACF,WAAO,OAAO,CAAC;AAAA,EACjB,QACM;AACJ,WAAO;AAAA,EACT;AACF;AAWO,SAAS,yBAAyB,KAAuB;AAC9D,QAAM,MAAM,IAAI;AAChB,MAAI,IAAI,oCAAoC;AAC1C;AACF,MAAI;AACF,QAAI,oCAAoC,IAAI;AAAA,EAC9C,QACM;AAEJ;AAAA,EACF;AAEA,QAAM,WAAW,IAAI,OAAO;AAC5B,MAAI,OAAO,cAAc,CAAC,QAAQ,UAAU,aAAa;AACvD,UAAM,MAAM,QAAQ,MAAM;AAC1B,UAAM,QAAQ,QAAQ,QAAQ;AAC9B,UAAM,QAAQ,IAAI,MAAM,oBAAoB;AAC5C,QAAI,OAAO;AACT,YAAM,MAAM,MAAM,CAAC;AACnB,UAAI,OAAO,mBAAmB,eAAe,eAAe,IAAI,GAAG;AACjE;AACF,UAAI,uBAAuB,KAAK,GAAG;AACjC;AAAA,IACJ;AACA,QAAI,UAAU;AAGZ,UAAI;AACF,iBAAS,KAAK,UAAU,KAAK;AAAA,MAC/B,SACO,KAAK;AACV,YAAI,OAAO,YAAY;AACrB,kBAAQ,MAAM,qDAAqD,GAAG;AAAA,MAC1E;AACA;AAAA,IACF;AAGA,QAAI,OAAO,YAAY,aAAa;AAClC,UAAI;AACF,gBAAQ,KAAK,eAAe,GAAG,IAAI;AAAA,EAAK,KAAK,EAAE;AAAA;AAE/C,gBAAQ,KAAK,eAAe,GAAG,EAAE;AAAA,IACrC;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@wippy-fe/vue-utils",
+  "version": "0.0.35",
+  "description": "Runtime Vue utilities for Wippy micro-frontend apps — warn suppressor and other opt-in Vue helpers.",
+  "license": "UNLICENSED",
+  "type": "module",
+  "sideEffects": false,
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "package.json",
+    "dist/"
+  ],
+  "scripts": {
+    "build": "tsup"
+  }
+}