@uibit/consent-guard 0.1.0 → 0.2.0

package/README.md

@@ -1,7 +1,17 @@
 # Consent Guard
 
+[![NPM Version](https://img.shields.io/npm/v/@uibit/consent-guard.svg?style=flat-square&color=black)](https://www.npmjs.com/package/@uibit/consent-guard)
+
+
 [Interactive Demonstration](https://rawlings.github.io/uibit/components/consent-guard)
 
+## Installation
+
+```bash
+npm install @uibit/consent-guard
+```
+
+
 Consent Guard provides a polished, content-specific consent interface that respects user privacy without interrupting the user experience. By replacing third-party embeddings with clear, informative placeholders, it gives users control over which services load, building trust and meeting compliance requirements.
 
 ## Value Delivery

package/custom-elements.json

@@ -8,7 +8,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Gate any content behind a consent prompt. Shows the `placeholder` slot until\nthe user grants consent, then reveals the default slot.\n\nConsent is triggered by clicking any element with `[data-consent-accept]`\ninside the placeholder slot, or by calling the `accept()` method programmatically.\n\nContent in the default slot is kept `display:none` until consent is granted,\nso iframes with `loading=\"lazy\"` will not make network requests beforehand.",
+          "description": "Gate any content behind a consent prompt. Shows the `placeholder` slot until",
           "name": "ConsentGuard",
           "cssParts": [
             {
@@ -57,6 +57,211 @@
                   }
                 }
               ]
+            },
+            {
+              "kind": "field",
+              "name": "locale",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "BCP 47 locale string for formatting and localization. Defaults to inherited document language.",
+              "attribute": "locale",
+              "inheritedFrom": {
+                "name": "UIBitElement",
+                "module": "../../platform/core/src/element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "resolvedLocale",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Resolves the active locale for formatting and localization.\nChecks the `locale` property first, then traverses up the DOM to find\nthe nearest ancestor with a `lang` attribute, and finally falls back\nto undefined (which defaults to browser locale).",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "UIBitElement",
+                "module": "../../platform/core/src/element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_disposables",
+              "type": {
+                "text": "Set<() => void>"
+              },
+              "privacy": "private",
+              "default": "new Set()",
+              "inheritedFrom": {
+                "name": "UIBitElement",
+                "module": "../../platform/core/src/element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "createProperty",
+              "static": true,
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "PropertyKey"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "PropertyDeclaration"
+                  }
+                }
+              ],
+              "description": "Overrides createProperty to automatically map camelCase property names\nto kebab-case attribute names by default.",
+              "inheritedFrom": {
+                "name": "UIBitElement",
+                "module": "../../platform/core/src/element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "finalizeStyles",
+              "static": true,
+              "return": {
+                "type": {
+                  "text": "Array<any>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "styles",
+                  "optional": true,
+                  "type": {
+                    "text": "CSSResultGroup"
+                  }
+                }
+              ],
+              "description": "Automatically prepends basic layout resets (border-box) to the\ncomponent's final styles.",
+              "inheritedFrom": {
+                "name": "UIBitElement",
+                "module": "../../platform/core/src/element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "dispatchCustomEvent",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "detail",
+                  "optional": true,
+                  "type": {
+                    "text": "T"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "Omit<CustomEventInit<T>, 'detail'>"
+                  }
+                }
+              ],
+              "description": "Helper to dispatch a custom event with standard bubbles and composed options.",
+              "inheritedFrom": {
+                "name": "UIBitElement",
+                "module": "../../platform/core/src/element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getCssPropertyValue",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "propertyName",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Helper to retrieve a computed CSS custom property value from the element.",
+              "inheritedFrom": {
+                "name": "UIBitElement",
+                "module": "../../platform/core/src/element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "registerDisposable",
+              "parameters": [
+                {
+                  "name": "cleanup",
+                  "type": {
+                    "text": "() => void"
+                  }
+                }
+              ],
+              "description": "Register a cleanup function to be executed when the element is disconnected from the DOM.",
+              "inheritedFrom": {
+                "name": "UIBitElement",
+                "module": "../../platform/core/src/element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "listen",
+              "return": {
+                "type": {
+                  "text": "() => void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "target",
+                  "type": {
+                    "text": "EventTarget"
+                  }
+                },
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "K"
+                  }
+                },
+                {
+                  "name": "listener",
+                  "type": {
+                    "text": "(this: EventTarget, ev: HTMLElementEventMap[K]) => any"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "boolean | AddEventListenerOptions"
+                  }
+                }
+              ],
+              "description": "Utility to add an event listener that is automatically cleaned up when the element is disconnected.",
+              "inheritedFrom": {
+                "name": "UIBitElement",
+                "module": "../../platform/core/src/element.ts"
+              }
             }
           ],
           "events": [
@@ -65,12 +270,34 @@
               "name": "consent-accepted"
             }
           ],
+          "cssStates": [
+            {
+              "name": "accepted",
+              "description": "Active when the user has accepted cookie/tracking terms."
+            }
+          ],
           "superclass": {
             "name": "UIBitElement",
             "package": "@uibit/core"
           },
+          "summary": "A cookie and privacy consent guard wrapping third-party embedded resources.\nthe user grants consent, then reveals the default slot.\n\nConsent is triggered by clicking any element with `[data-consent-accept]`\ninside the placeholder slot, or by calling the `accept()` method programmatically.\n\nContent in the default slot is kept `display:none` until consent is granted,\nso iframes with `loading=\"lazy\"` will not make network requests beforehand.",
           "tagName": "uibit-consent-guard",
-          "customElement": true
+          "customElement": true,
+          "attributes": [
+            {
+              "name": "locale",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "BCP 47 locale string for formatting and localization. Defaults to inherited document language.",
+              "fieldName": "locale",
+              "inheritedFrom": {
+                "name": "UIBitElement",
+                "module": "../../platform/core/src/element.ts"
+              }
+            }
+          ]
         }
       ],
       "exports": [
@@ -144,6 +371,250 @@
       "path": "src/types.ts",
       "declarations": [],
       "exports": []
+    },
+    {
+      "kind": "javascript-module",
+      "path": "../../platform/core/src/element.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A foundational base class for all UIBit web components.\nProvides custom event helpers, default kebab-case attribute mapping,\nautomatic cleanup/disposable tracking, and auto-injected reset styles.",
+          "name": "UIBitElement",
+          "members": [
+            {
+              "kind": "field",
+              "name": "locale",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "BCP 47 locale string for formatting and localization. Defaults to inherited document language.",
+              "attribute": "locale"
+            },
+            {
+              "kind": "field",
+              "name": "resolvedLocale",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Resolves the active locale for formatting and localization.\nChecks the `locale` property first, then traverses up the DOM to find\nthe nearest ancestor with a `lang` attribute, and finally falls back\nto undefined (which defaults to browser locale).",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_disposables",
+              "type": {
+                "text": "Set<() => void>"
+              },
+              "privacy": "private",
+              "default": "new Set()"
+            },
+            {
+              "kind": "method",
+              "name": "createProperty",
+              "static": true,
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "PropertyKey"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "PropertyDeclaration"
+                  }
+                }
+              ],
+              "description": "Overrides createProperty to automatically map camelCase property names\nto kebab-case attribute names by default."
+            },
+            {
+              "kind": "method",
+              "name": "finalizeStyles",
+              "static": true,
+              "return": {
+                "type": {
+                  "text": "Array<any>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "styles",
+                  "optional": true,
+                  "type": {
+                    "text": "CSSResultGroup"
+                  }
+                }
+              ],
+              "description": "Automatically prepends basic layout resets (border-box) to the\ncomponent's final styles."
+            },
+            {
+              "kind": "method",
+              "name": "dispatchCustomEvent",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "detail",
+                  "optional": true,
+                  "type": {
+                    "text": "T"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "Omit<CustomEventInit<T>, 'detail'>"
+                  }
+                }
+              ],
+              "description": "Helper to dispatch a custom event with standard bubbles and composed options."
+            },
+            {
+              "kind": "method",
+              "name": "getCssPropertyValue",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "propertyName",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Helper to retrieve a computed CSS custom property value from the element."
+            },
+            {
+              "kind": "method",
+              "name": "registerDisposable",
+              "parameters": [
+                {
+                  "name": "cleanup",
+                  "type": {
+                    "text": "() => void"
+                  }
+                }
+              ],
+              "description": "Register a cleanup function to be executed when the element is disconnected from the DOM."
+            },
+            {
+              "kind": "method",
+              "name": "listen",
+              "return": {
+                "type": {
+                  "text": "() => void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "target",
+                  "type": {
+                    "text": "EventTarget"
+                  }
+                },
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "K"
+                  }
+                },
+                {
+                  "name": "listener",
+                  "type": {
+                    "text": "(this: EventTarget, ev: HTMLElementEventMap[K]) => any"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "boolean | AddEventListenerOptions"
+                  }
+                }
+              ],
+              "description": "Utility to add an event listener that is automatically cleaned up when the element is disconnected."
+            },
+            {
+              "kind": "method",
+              "name": "listen",
+              "return": {
+                "type": {
+                  "text": "() => void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "target",
+                  "type": {
+                    "text": "EventTarget"
+                  }
+                },
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "listener",
+                  "type": {
+                    "text": "EventListenerOrEventListenerObject"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "boolean | AddEventListenerOptions"
+                  }
+                }
+              ]
+            }
+          ],
+          "attributes": [
+            {
+              "name": "locale",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "BCP 47 locale string for formatting and localization. Defaults to inherited document language.",
+              "fieldName": "locale"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "UIBitElement",
+          "declaration": {
+            "name": "UIBitElement",
+            "module": "../../platform/core/src/element.ts"
+          }
+        }
+      ]
     }
   ]
 }

package/dist/consent-guard.d.ts

@@ -1,6 +1,8 @@
 import { UIBitElement } from '@uibit/core';
 /**
  * Gate any content behind a consent prompt. Shows the `placeholder` slot until
+
+ * @summary A cookie and privacy consent guard wrapping third-party embedded resources.
  * the user grants consent, then reveals the default slot.
  *
  * Consent is triggered by clicking any element with `[data-consent-accept]`
@@ -17,7 +19,8 @@ import { UIBitElement } from '@uibit/core';
  *
  * @csspart placeholder - Wrapper around the placeholder slot
  * @csspart content - Wrapper around the default slot
- */
+ 
+ * @cssstate accepted - Active when the user has accepted cookie/tracking terms.*/
 export declare class ConsentGuard extends UIBitElement {
     static styles: import("lit").CSSResult;
     private _consented;

package/dist/consent-guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consent-guard.d.ts","sourceRoot":"","sources":["../src/consent-guard.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,YAAY,EAAE,MAAM,aAAa,CAAC;AAG1D;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBACa,YAAa,SAAQ,YAAY;IAC5C,MAAM,CAAC,MAAM,0BAsBX;IAEO,OAAO,CAAC,UAAU,CAAS;IAEpC,sCAAsC;IACtC,MAAM,SAKL;IAED,OAAO,CAAC,mBAAmB;IAO3B,MAAM,oCASL;CACF;eAEc,YAAY"}
+{"version":3,"file":"consent-guard.d.ts","sourceRoot":"","sources":["../src/consent-guard.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,YAAY,EAAE,MAAM,aAAa,CAAC;AAG1D;;;;;;;;;;;;;;;;;;;;;kFAqBkF;AAClF,qBACa,YAAa,SAAQ,YAAY;IAC5C,MAAM,CAAC,MAAM,0BAsBX;IAEO,OAAO,CAAC,UAAU,CAAS;IAEpC,sCAAsC;IACtC,MAAM,SAKL;IAED,OAAO,CAAC,mBAAmB;IAO3B,MAAM,oCASL;CACF;eAEc,YAAY"}

package/dist/consent-guard.js

@@ -9,6 +9,8 @@ import { customElement, UIBitElement } from '@uibit/core';
 import { state } from 'lit/decorators.js';
 /**
  * Gate any content behind a consent prompt. Shows the `placeholder` slot until
+
+ * @summary A cookie and privacy consent guard wrapping third-party embedded resources.
  * the user grants consent, then reveals the default slot.
  *
  * Consent is triggered by clicking any element with `[data-consent-accept]`
@@ -25,7 +27,8 @@ import { state } from 'lit/decorators.js';
  *
  * @csspart placeholder - Wrapper around the placeholder slot
  * @csspart content - Wrapper around the default slot
- */
+ 
+ * @cssstate accepted - Active when the user has accepted cookie/tracking terms.*/
 let ConsentGuard = class ConsentGuard extends UIBitElement {
     constructor() {
         super(...arguments);

package/dist/consent-guard.js.map

@@ -1 +1 @@
-{"version":3,"file":"consent-guard.js","sourceRoot":"","sources":["../src/consent-guard.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C;;;;;;;;;;;;;;;;;;GAkBG;AAEI,IAAM,YAAY,GAAlB,MAAM,YAAa,SAAQ,YAAY;IAAvC;;QAyBY,eAAU,GAAG,KAAK,CAAC;IA2BtC,CAAC;aAnDQ,WAAM,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;GAsBlB,AAtBY,CAsBX;IAIF,sCAAsC;IACtC,MAAM;QACJ,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO;QAC5B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,CAAC;IAC/C,CAAC;IAEO,mBAAmB,CAAC,CAAQ;QAClC,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,EAAe,CAAC;QAC3C,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,YAAY,WAAW,IAAI,EAAE,CAAC,YAAY,CAAC,qBAAqB,CAAC,CAAC,EAAE,CAAC;YACzF,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAA;2DAC4C,IAAI,CAAC,mBAAmB;;;;;;KAM9E,CAAC;IACJ,CAAC;CACF,CAAA;AA3BkB;IAAhB,KAAK,EAAE;gDAA4B;AAzBzB,YAAY;IADxB,aAAa,CAAC,qBAAqB,CAAC;GACxB,YAAY,CAoDxB;;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"consent-guard.js","sourceRoot":"","sources":["../src/consent-guard.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;kFAqBkF;AAE3E,IAAM,YAAY,GAAlB,MAAM,YAAa,SAAQ,YAAY;IAAvC;;QAyBY,eAAU,GAAG,KAAK,CAAC;IA2BtC,CAAC;aAnDQ,WAAM,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;GAsBlB,AAtBY,CAsBX;IAIF,sCAAsC;IACtC,MAAM;QACJ,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO;QAC5B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,CAAC;IAC/C,CAAC;IAEO,mBAAmB,CAAC,CAAQ;QAClC,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,EAAe,CAAC;QAC3C,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,YAAY,WAAW,IAAI,EAAE,CAAC,YAAY,CAAC,qBAAqB,CAAC,CAAC,EAAE,CAAC;YACzF,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAA;2DAC4C,IAAI,CAAC,mBAAmB;;;;;;KAM9E,CAAC;IACJ,CAAC;CACF,CAAA;AA3BkB;IAAhB,KAAK,EAAE;gDAA4B;AAzBzB,YAAY;IADxB,aAAa,CAAC,qBAAqB,CAAC;GACxB,YAAY,CAoDxB;;AAED,eAAe,YAAY,CAAC"}

package/dist/frameworks/angular/index.ts

@@ -1,20 +1,23 @@
-import { Component, ChangeDetectionStrategy, ElementRef, output } from '@angular/core';
+import { Component, ChangeDetectionStrategy, ElementRef, input, effect, output } from '@angular/core';
 import '@uibit/consent-guard';
 import type { ConsentGuard as HTMLElementClass } from '@uibit/consent-guard';
-
 @Component({
-  selector: 'uibit-consent-guard',
-  template: '<ng-content></ng-content>',
-  changeDetection: ChangeDetectionStrategy.OnPush,
-  standalone: true,
-  host: {
-    '(consent-accepted)': 'consentAccepted.emit($event)'
-  }
+    selector: 'uibit-consent-guard',
+    template: '<ng-content></ng-content>',
+    changeDetection: ChangeDetectionStrategy.OnPush,
+    standalone: true,
+    host: {
+        '(consent-accepted)': 'consentAccepted.emit($event)'
+    }
 })
 export class NgxConsentGuard {
-  constructor(private el: ElementRef<HTMLElementClass>) {
-
-  }
-
-  readonly consentAccepted = output<CustomEvent<any>>();
+    constructor(private el: ElementRef<HTMLElementClass>){
+        effect(()=>{
+            if (this.el.nativeElement) {
+                this.el.nativeElement.locale = this.locale();
+            }
+        });
+    }
+    readonly locale = input<string>('');
+    readonly consentAccepted = output<CustomEvent<any>>();
 }

package/dist/frameworks/astro/index.d.ts

@@ -4,7 +4,10 @@ import '@uibit/consent-guard';
 declare global {
   namespace astroHTML.JSX {
     interface IntrinsicElements {
-      'uibit-consent-guard': Partial<HTMLElementClass> & astroHTML.JSX.HTMLAttributes;
+      'uibit-consent-guard': Partial<HTMLElementClass> & astroHTML.JSX.HTMLAttributes & {
+      locale?: string;
+      "on:consent-accepted"?: (event: Event) => void;
+      };
     }
   }
 }

package/dist/frameworks/preact/index.d.ts

@@ -6,7 +6,9 @@ declare module 'preact' {
   namespace JSX {
     interface IntrinsicElements {
       'uibit-consent-guard': JSX.HTMLAttributes<HTMLElementClass> & {
-
+      locale?: string;
+      onConsentAccepted?: (event: Event) => void;
+      "on:consent-accepted"?: (event: Event) => void;
       };
     }
   }

package/dist/frameworks/react/index.ts

@@ -0,0 +1,66 @@
+import React, { useRef, useEffect, useLayoutEffect, useImperativeHandle } from 'react';
+import type { ConsentGuard as HTMLElementClass } from '@uibit/consent-guard';
+import '@uibit/consent-guard';
+const useTypeOfLayoutEffect = typeof window !== 'undefined' ? useLayoutEffect : useEffect;
+export interface ConsentGuardProps extends Omit<React.HTMLAttributes<HTMLElementClass>, 'locale' | 'onConsentAccepted'> {
+    children?: React.ReactNode;
+    locale?: string;
+    onConsentAccepted?: (event: Event) => void;
+}
+export const ConsentGuard = ({ ref, children, ...props }: ConsentGuardProps & {
+    ref?: React.Ref<HTMLElementClass>;
+})=>{
+    const innerRef = useRef<HTMLElementClass>(null);
+    const propsRef = useRef(props);
+    propsRef.current = props;
+    useImperativeHandle(ref, ()=>innerRef.current!);
+    useTypeOfLayoutEffect(()=>{
+        const element = innerRef.current;
+        if (element && props.locale !== undefined) {
+            (element as any).locale = props.locale;
+        }
+    }, [
+        props.locale
+    ]);
+    useTypeOfLayoutEffect(()=>{
+        const element = innerRef.current;
+        if (!element) return;
+        const handleEvent = (event: Event)=>{
+            if (propsRef.current.onConsentAccepted) {
+                propsRef.current.onConsentAccepted(event as any);
+            }
+        };
+        element.addEventListener('consent-accepted', handleEvent);
+        return ()=>{
+            element.removeEventListener('consent-accepted', handleEvent);
+        };
+    }, []);
+    const domProps = {
+        ...props
+    };
+    const customPropNames = [
+        'locale',
+        'onConsentAccepted'
+    ];
+    for (const key of customPropNames){
+        delete (domProps as any)[key];
+    }
+    return React.createElement('uibit-consent-guard', {
+        ref: innerRef,
+        ...domProps
+    }, children);
+};
+declare global {
+    namespace React {
+        namespace JSX {
+            interface IntrinsicElements {
+                'uibit-consent-guard': React.ClassAttributes<HTMLElementClass> & React.HTMLAttributes<HTMLElementClass> & {
+                    children?: React.ReactNode;
+                    class?: string;
+                    locale?: string;
+                    onConsentAccepted?: (event: CustomEvent<any>) => void;
+                };
+            }
+        }
+    }
+}

package/dist/frameworks/solid/index.d.ts

@@ -6,8 +6,8 @@ declare module 'solid-js' {
   namespace JSX {
     interface IntrinsicElements {
       'uibit-consent-guard': Partial<HTMLElementClass> & JSX.HTMLAttributes<HTMLElementClass> & {
-        
-      "on:consent-accepted"?: (event: CustomEvent) => void;
+              locale?: string;
+      "on:consent-accepted"?: (event: Event) => void;
       };
     }
   }

package/dist/frameworks/stencil/index.d.ts

@@ -5,7 +5,9 @@ declare module '@stencil/core' {
   export namespace JSX {
     interface IntrinsicElements {
       'uibit-consent-guard': HTMLElementClass & {
-
+    locale?: string;
+    onConsentAccepted?: (event: Event) => void;
+    "on:consent-accepted"?: (event: Event) => void;
       };
     }
   }

package/dist/frameworks/svelte/index.svelte

@@ -1,27 +1,53 @@
 <script lang="ts">
   import '@uibit/consent-guard';
   import type { ConsentGuard as HTMLElementClass } from '@uibit/consent-guard';
-  
-  let {
+
+let {
+    locale = $bindable(),
     placeholder = undefined,
-      (default) = undefined,
-      children
+    (default) = undefined,
+    children,
+    ...restProps
   } = $props<{
-    children?: any;
-  
+    children?: import('svelte').Snippet;
+    locale?: string;
     placeholder?: import('svelte').Snippet;
     (default)?: import('svelte').Snippet;
+    [key: string]: any;
   }>();
-  
-  let elementRef: HTMLElementClass | null = $state(null);
-  
-  $effect(() => {
-  
+
+let elementRef: HTMLElementClass | null = $state(null);
+
+$effect(() => {
+    if (elementRef && locale !== undefined && elementRef.locale !== locale) {
+      elementRef.locale = locale;
+    }
+  });
+
+$effect(() => {
+    const element = elementRef;
+    if (!element) return;
+
+    const handleEvent = () => {
+      if (locale !== element.locale) {
+        locale = element.locale as any;
+      }
+    };
+
+    const events = ['change', 'input', 'consent-accepted'];
+    for (const event of events) {
+      element.addEventListener(event, handleEvent);
+    }
+    return () => {
+      for (const event of events) {
+        element.removeEventListener(event, handleEvent);
+      }
+    };
   });
-  
+
 </script>
 
-<uibit-consent-guard bind:this={elementRef} {...$$restProps}>
+<uibit-consent-guard bind:this={elementRef} {...restProps}>
   {#if placeholder}
     <div slot="placeholder">
       {@render placeholder()}

package/dist/frameworks/vue/index.ts

@@ -1,24 +1,55 @@
-import { defineComponent, h } from 'vue';
+import { defineComponent, h, ref, watch } from 'vue';
 import type { ConsentGuard as HTMLElementClass } from '@uibit/consent-guard';
 import '@uibit/consent-guard';
-
 export const ConsentGuard = defineComponent({
-  name: 'ConsentGuard',
-  props: {
-
-  },
-  emits: ['consent-accepted'],
-  setup(props, { slots, emit }) {
-    return () => {
-      const eventListeners: Record<string, any> = {};
-      eventListeners['onConsent-accepted'] = (event: Event) => {
-        emit('consent-accepted', event);
-      };
-
-      return h('uibit-consent-guard', {
-        ...props,
-        ...eventListeners
-      }, slots.default?.());
-    };
-  }
+    name: 'ConsentGuard',
+    props: {
+        locale: {
+            type: [
+                String,
+                Number,
+                Boolean,
+                Array,
+                Object
+            ] as any
+        }
+    },
+    emits: [
+        'consent-accepted'
+    ],
+    setup (props, { slots, emit }) {
+        const elementRef = ref<HTMLElementClass | null>(null);
+        if (false) {
+            watch(()=>props.modelValue, (newVal)=>{
+                if (elementRef.value && newVal !== undefined && elementRef.value.value !== newVal) {
+                    elementRef.value.value = newVal;
+                }
+            });
+            watch(()=>props.value, (newVal)=>{
+                if (elementRef.value && newVal !== undefined && elementRef.value.value !== newVal) {
+                    elementRef.value.value = newVal;
+                }
+            });
+        }
+        watch(()=>props.locale, (newVal)=>{
+            if (elementRef.value && newVal !== undefined) {
+                (elementRef.value as any).locale = newVal;
+            }
+        });
+        return ()=>{
+            const eventListeners: Record<string, any> = {};
+            eventListeners['onConsent-accepted'] = (event: Event)=>{
+                emit('consent-accepted', event);
+            };
+            const mergedProps = {
+                ...props,
+                ...eventListeners,
+                ref: elementRef
+            };
+            if (false && props.modelValue !== undefined) {
+                (mergedProps as any).value = props.modelValue;
+            }
+            return h('uibit-consent-guard', mergedProps, slots.default?.());
+        };
+    }
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uibit/consent-guard",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Gate any third-party content behind a consent prompt. The component manages show/hide state only — you provide both the placeholder UI and the content, keeping it composable and unbiased.",
   "type": "module",
   "main": "./dist/index.js",
@@ -12,7 +12,7 @@
     },
     "./consent-guard.css": "./dist/consent-guard.css",
     "./custom-elements.json": "./custom-elements.json",
-    "./react": "./dist/frameworks/react/index.d.ts",
+    "./react": "./dist/frameworks/react/index.ts",
     "./vue": "./dist/frameworks/vue/index.ts",
     "./svelte": "./dist/frameworks/svelte/index.svelte",
     "./angular": "./dist/frameworks/angular/index.ts",
@@ -47,13 +47,13 @@
     "directory": "packages/components/consent-guard"
   },
   "dependencies": {
-    "@uibit/core": "0.1.0"
+    "@uibit/core": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^20.19.43",
     "lit": "^3.3.3",
     "typescript": "7.0.2",
-    "@uibit/codegen": "0.1.0"
+    "@uibit/codegen": "0.2.0"
   },
   "peerDependencies": {
     "lit": "^3.0.0",
@@ -84,9 +84,9 @@
     "tagName": "uibit-consent-guard"
   },
   "scripts": {
-    "build": "cem analyze --globs 'src/**/*.ts' --litelement && uibit-codegen --package . && tsc",
-    "dev": "concurrently \"cem analyze --globs 'src/**/*.ts' --litelement --watch\" \"tsc --watch\"",
-    "analyze": "cem analyze --globs 'src/**/*.ts' --litelement",
+    "build": "cem analyze --config ../custom-elements-manifest.config.js && uibit-codegen --package . && tsc",
+    "dev": "concurrently \"cem analyze --config ../custom-elements-manifest.config.js --watch\" \"tsc --watch\"",
+    "analyze": "cem analyze --config ../custom-elements-manifest.config.js",
     "typecheck": "tsc --noEmit"
   }
 }

package/dist/frameworks/react/index.d.ts

@@ -1,18 +0,0 @@
-import type { HTMLAttributes, ClassAttributes } from 'react';
-import type { ConsentGuard as HTMLElementClass } from '@uibit/consent-guard';
-import '@uibit/consent-guard';
-
-declare global {
-  namespace React {
-    namespace JSX {
-      interface IntrinsicElements {
-        'uibit-consent-guard': ClassAttributes<HTMLElementClass> & HTMLAttributes<HTMLElementClass> & {
-          children?: React.ReactNode;
-          class?: string;
-
-      onConsentAccepted?: (event: any) => void;
-        };
-      }
-    }
-  }
-}