@wippy-fe/types-global-proxy 0.0.30 → 0.0.31

package/index.d.ts

@@ -284,6 +284,7 @@ interface ApiRoutes {
     };
     components: {
         list: string;
+        byTag: string;
     };
     tools: {
         byName: string;
@@ -553,6 +554,11 @@ interface ProxyConfig {
     };
 }
 
+interface SanitizeOptions {
+    /** Tags + attrs allowed on top of defaults + the runtime allowlist. */
+    extraTags?: Record<string, string[]>;
+}
+
 declare namespace UploadApi {
     interface Meta {
         filename: string;
@@ -1297,6 +1303,28 @@ interface ProxyApiInstance {
     state: StateApi;
     ws: ProxyWsApi;
     loadWebComponent: (componentId: string, tagName?: string) => Promise<void>;
+    /**
+     * Resolve a registered `view.component`'s custom-element tag name to its
+     * module URL via the views API and define it on `customElements`. Use this
+     * instead of hardcoding peer-module URLs from a consumer WC. Idempotent.
+     *
+     * `options.timeoutMs` overrides the default 30s deadline for waiting on
+     * `customElements.define` after the script is appended — useful when a
+     * caller wants a faster failure (e.g. probing whether a component exists).
+     */
+    loadByTagName: (tag: string, options?: {
+        timeoutMs?: number;
+    }) => Promise<void>;
+    /**
+     * Default-allowlisted HTML sanitizer scoped to this runtime. Combines
+     * `defaultAllowedTags` / `defaultAllowedAttributes` with the set of
+     * web-component tags currently registered in this proxy context — so
+     * a child app calling `loadByTagName('w-foo')` and then
+     * `$W.sanitize('<w-foo>...</w-foo>')` gets the tag preserved without
+     * having to re-declare the allowlist. See `SanitizeOptions` for
+     * per-call overrides.
+     */
+    sanitize: (html: string, opts?: SanitizeOptions) => string;
 }
 
 declare global {
@@ -1360,6 +1388,8 @@ declare global {
             state: () => Promise<ProxyApiInstance['state']>;
             ws: () => Promise<ProxyApiInstance['ws']>;
             loadWebComponent: () => Promise<ProxyApiInstance['loadWebComponent']>;
+            loadByTagName: () => Promise<ProxyApiInstance['loadByTagName']>;
+            sanitize: () => Promise<ProxyApiInstance['sanitize']>;
         };
         tailwind?: {
             config: Partial<typeof _default>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wippy-fe/types-global-proxy",
-  "version": "0.0.30",
+  "version": "0.0.31",
   "description": "Global type declarations for Wippy iframe proxy (window.getWippyApi, $W, etc.)",
   "license": "UNLICENSED",
   "types": "index.d.ts"