consently 0.1.0

data/config/locales/en.yml

@@ -0,0 +1,33 @@
+en:
+  consently:
+    banner:
+      message: "We use cookies to run this site, and - with your consent - to understand how it is used and to show you relevant offers."
+      policy_link: "Read our cookie policy."
+      accept_all: "Accept all"
+      reject_all: "Reject all"
+      preferences: "Settings"
+      save: "Save choices"
+      cancel: "Cancel"
+    preferences_link: "Cookie settings"
+    policy:
+      granted: "you agreed"
+      denied: "not agreed"
+      no_tags: "Nothing in this category."
+      no_cookies: "Sets no cookies."
+      cookie_name: "Cookie"
+      cookie_duration: "Kept for"
+      duration_days: "%{count} days"
+      duration_session: "until you close the browser"
+      own_heading: "The consent cookie itself"
+      own_body: "Your choice is kept in one cookie in your browser: the categories you agreed to, the version of this policy and the time. Nothing about you."
+      own_version: "Policy version"
+    categories:
+      necessary:
+        name: "Necessary"
+        description: "Needed for the site to work. They cannot be switched off."
+      analytics:
+        name: "Analytics"
+        description: "Help us see how the site is used, so we can improve it."
+      marketing:
+        name: "Marketing"
+        description: "Let us show you offers that fit what you are interested in."

data/config/locales/es.yml

@@ -0,0 +1,33 @@
+es:
+  consently:
+    banner:
+      message: "Usamos cookies para que este sitio funcione y, con tu consentimiento, para entender cómo se usa y mostrarte ofertas relevantes."
+      policy_link: "Lee nuestra política de cookies."
+      accept_all: "Aceptar todo"
+      reject_all: "Rechazar todo"
+      preferences: "Ajustes"
+      save: "Guardar selección"
+      cancel: "Cancelar"
+    preferences_link: "Ajustes de cookies"
+    policy:
+      granted: "consentido"
+      denied: "sin consentimiento"
+      no_tags: "Nada en esta categoría."
+      no_cookies: "No instala cookies."
+      cookie_name: "Cookie"
+      cookie_duration: "Se conserva"
+      duration_days: "%{count} días"
+      duration_session: "hasta que cierres el navegador"
+      own_heading: "La propia cookie de consentimiento"
+      own_body: "Tu elección se guarda en una cookie de tu navegador: las categorías que aceptaste, la versión de esta política y la hora. Nada sobre ti."
+      own_version: "Versión de la política"
+    categories:
+      necessary:
+        name: "Necesarias"
+        description: "Imprescindibles para que el sitio funcione. No se pueden desactivar."
+      analytics:
+        name: "Analíticas"
+        description: "Nos muestran cómo se usa el sitio para poder mejorarlo."
+      marketing:
+        name: "Marketing"
+        description: "Nos permiten mostrarte ofertas acordes con tus intereses."

data/config/locales/fr.yml

@@ -0,0 +1,33 @@
+fr:
+  consently:
+    banner:
+      message: "Nous utilisons des cookies pour faire fonctionner ce site et, avec votre accord, pour comprendre comment il est utilisé et vous proposer des offres pertinentes."
+      policy_link: "Consulter notre politique de cookies."
+      accept_all: "Tout accepter"
+      reject_all: "Tout refuser"
+      preferences: "Paramètres"
+      save: "Enregistrer mes choix"
+      cancel: "Annuler"
+    preferences_link: "Paramètres des cookies"
+    policy:
+      granted: "accepté"
+      denied: "non accepté"
+      no_tags: "Rien dans cette catégorie."
+      no_cookies: "Ne dépose aucun cookie."
+      cookie_name: "Cookie"
+      cookie_duration: "Conservé"
+      duration_days: "%{count} jours"
+      duration_session: "jusqu'à la fermeture du navigateur"
+      own_heading: "Le cookie de consentement lui-même"
+      own_body: "Votre choix tient dans un cookie de votre navigateur : les catégories acceptées, la version de cette politique et l'heure. Rien sur vous."
+      own_version: "Version de la politique"
+    categories:
+      necessary:
+        name: "Nécessaires"
+        description: "Indispensables au fonctionnement du site. Ils ne peuvent pas être désactivés."
+      analytics:
+        name: "Mesure d'audience"
+        description: "Nous montrent comment le site est utilisé, afin de l'améliorer."
+      marketing:
+        name: "Marketing"
+        description: "Nous permettent de vous proposer des offres correspondant à vos centres d'intérêt."

data/config/locales/hu.yml

@@ -0,0 +1,33 @@
+hu:
+  consently:
+    banner:
+      message: "Sütiket használunk, hogy az oldal működjön, és - a hozzájárulásoddal - hogy megértsük, hogyan használod, illetve releváns ajánlatokat mutassunk."
+      policy_link: "Olvasd el a süti szabályzatunkat."
+      accept_all: "Összes elfogadása"
+      reject_all: "Összes elutasítása"
+      preferences: "Beállítások"
+      save: "Választás mentése"
+      cancel: "Mégse"
+    preferences_link: "Süti beállítások"
+    policy:
+      granted: "hozzájárultál"
+      denied: "nincs hozzájárulás"
+      no_tags: "Ebben a kategóriában nincs semmi."
+      no_cookies: "Nem helyez el sütit."
+      cookie_name: "Süti"
+      cookie_duration: "Megőrzés"
+      duration_days: "%{count} nap"
+      duration_session: "a böngésző bezárásáig"
+      own_heading: "Maga a hozzájárulási süti"
+      own_body: "A választásod egyetlen sütiben van a böngésződben: az elfogadott kategóriák, e szabályzat verziója és az idő. Rólad semmi."
+      own_version: "Szabályzat verziója"
+    categories:
+      necessary:
+        name: "Szükséges"
+        description: "Az oldal működéséhez kellenek. Nem kapcsolhatók ki."
+      analytics:
+        name: "Statisztikai"
+        description: "Megmutatják, hogyan használod az oldalt, hogy fejleszthessük."
+      marketing:
+        name: "Marketing"
+        description: "Segítenek olyan ajánlatokat mutatni, amelyek érdekelhetnek."

data/config/locales/it.yml

@@ -0,0 +1,33 @@
+it:
+  consently:
+    banner:
+      message: "Usiamo i cookie per far funzionare questo sito e, con il tuo consenso, per capire come viene usato e mostrarti offerte pertinenti."
+      policy_link: "Leggi la nostra cookie policy."
+      accept_all: "Accetta tutto"
+      reject_all: "Rifiuta tutto"
+      preferences: "Impostazioni"
+      save: "Salva le scelte"
+      cancel: "Annulla"
+    preferences_link: "Impostazioni cookie"
+    policy:
+      granted: "consenso dato"
+      denied: "nessun consenso"
+      no_tags: "Niente in questa categoria."
+      no_cookies: "Non imposta cookie."
+      cookie_name: "Cookie"
+      cookie_duration: "Conservato"
+      duration_days: "%{count} giorni"
+      duration_session: "fino alla chiusura del browser"
+      own_heading: "Il cookie di consenso"
+      own_body: "La tua scelta sta in un cookie nel tuo browser: le categorie accettate, la versione di questa policy e l'ora. Nulla su di te."
+      own_version: "Versione della policy"
+    categories:
+      necessary:
+        name: "Necessari"
+        description: "Servono al funzionamento del sito. Non possono essere disattivati."
+      analytics:
+        name: "Statistici"
+        description: "Ci mostrano come viene usato il sito, così possiamo migliorarlo."
+      marketing:
+        name: "Marketing"
+        description: "Ci permettono di mostrarti offerte in linea con i tuoi interessi."

data/config/locales/nl.yml

@@ -0,0 +1,33 @@
+nl:
+  consently:
+    banner:
+      message: "We gebruiken cookies om deze site te laten werken en, met jouw toestemming, om te begrijpen hoe de site gebruikt wordt en je relevante aanbiedingen te tonen."
+      policy_link: "Lees ons cookiebeleid."
+      accept_all: "Alles accepteren"
+      reject_all: "Alles weigeren"
+      preferences: "Instellingen"
+      save: "Keuze opslaan"
+      cancel: "Annuleren"
+    preferences_link: "Cookie-instellingen"
+    policy:
+      granted: "toegestaan"
+      denied: "niet toegestaan"
+      no_tags: "Niets in deze categorie."
+      no_cookies: "Plaatst geen cookies."
+      cookie_name: "Cookie"
+      cookie_duration: "Bewaard"
+      duration_days: "%{count} dagen"
+      duration_session: "tot je de browser sluit"
+      own_heading: "De toestemmingscookie zelf"
+      own_body: "Je keuze staat in één cookie in je browser: de categorieën die je toestond, de versie van dit beleid en het tijdstip. Niets over jou."
+      own_version: "Versie van het beleid"
+    categories:
+      necessary:
+        name: "Noodzakelijk"
+        description: "Nodig om de site te laten werken. Deze kun je niet uitzetten."
+      analytics:
+        name: "Statistieken"
+        description: "Laten ons zien hoe de site gebruikt wordt, zodat we hem kunnen verbeteren."
+      marketing:
+        name: "Marketing"
+        description: "Hiermee kunnen we je aanbiedingen tonen die bij je interesses passen."

data/config/locales/pl.yml

@@ -0,0 +1,33 @@
+pl:
+  consently:
+    banner:
+      message: "Używamy plików cookie, żeby ta strona działała, a za Twoją zgodą także po to, by rozumieć, jak z niej korzystasz, i pokazywać Ci trafne oferty."
+      policy_link: "Przeczytaj naszą politykę cookies."
+      accept_all: "Akceptuję wszystkie"
+      reject_all: "Odrzuć wszystkie"
+      preferences: "Ustawienia"
+      save: "Zapisz wybór"
+      cancel: "Anuluj"
+    preferences_link: "Ustawienia cookies"
+    policy:
+      granted: "zgoda udzielona"
+      denied: "brak zgody"
+      no_tags: "Nic w tej kategorii."
+      no_cookies: "Nie ustawia ciasteczek."
+      cookie_name: "Ciasteczko"
+      cookie_duration: "Przechowywane"
+      duration_days: "%{count} dni"
+      duration_session: "do zamknięcia przeglądarki"
+      own_heading: "Samo ciasteczko zgody"
+      own_body: "Twój wybór trzymamy w jednym ciasteczku w Twojej przeglądarce: kategorie, na które się zgodziłeś, wersja tej polityki i czas. Nic o Tobie."
+      own_version: "Wersja polityki"
+    categories:
+      necessary:
+        name: "Niezbędne"
+        description: "Potrzebne do działania strony. Nie można ich wyłączyć."
+      analytics:
+        name: "Analityczne"
+        description: "Pokazują nam, jak korzystasz ze strony, dzięki czemu możemy ją ulepszać."
+      marketing:
+        name: "Marketingowe"
+        description: "Pozwalają pokazywać Ci oferty dopasowane do Twoich zainteresowań."

data/config/locales/sk.yml

@@ -0,0 +1,33 @@
+sk:
+  consently:
+    banner:
+      message: "Používame súbory cookie, aby táto stránka fungovala, a s vaším súhlasom aj na to, aby sme rozumeli, ako ju používate, a mohli vám ukazovať relevantné ponuky."
+      policy_link: "Prečítajte si naše zásady cookies."
+      accept_all: "Prijať všetko"
+      reject_all: "Odmietnuť všetko"
+      preferences: "Nastavenia"
+      save: "Uložiť voľbu"
+      cancel: "Zrušiť"
+    preferences_link: "Nastavenia cookies"
+    policy:
+      granted: "súhlas udelený"
+      denied: "bez súhlasu"
+      no_tags: "V tejto kategórii nič nie je."
+      no_cookies: "Nenastavuje žiadne cookies."
+      cookie_name: "Cookie"
+      cookie_duration: "Doba uloženia"
+      duration_days: "%{count} dní"
+      duration_session: "do zatvorenia prehliadača"
+      own_heading: "Samotná cookie so súhlasom"
+      own_body: "Vaša voľba je uložená v jednej cookie vo vašom prehliadači: kategórie, s ktorými ste súhlasili, verzia týchto zásad a čas. Nič o vás."
+      own_version: "Verzia zásad"
+    categories:
+      necessary:
+        name: "Nevyhnutné"
+        description: "Potrebné na fungovanie stránky. Nedajú sa vypnúť."
+      analytics:
+        name: "Analytické"
+        description: "Ukazujú nám, ako stránku používate, aby sme ju mohli zlepšovať."
+      marketing:
+        name: "Marketingové"
+        description: "Umožňujú nám ukazovať vám ponuky, ktoré zodpovedajú vašim záujmom."

data/config/routes.rb

@@ -0,0 +1,5 @@
+Consently::Engine.routes.draw do
+  # Only needed when config.log_consents is on. Mount the engine and the
+  # banner will POST each decision here as proof of consent.
+  resource :consents, only: :create
+end

data/lib/consently/configuration.rb

@@ -0,0 +1,150 @@
+module Consently
+  # Everything the host application sets in config/initializers/consently.rb.
+  class Configuration
+    DEFAULT_CATEGORIES = %i[necessary analytics marketing].freeze
+
+    # Where the visitor's choice is kept. It is read by JavaScript, so it is a
+    # plain cookie rather than a signed one.
+    attr_accessor :cookie_name, :cookie_max_age, :cookie_path
+
+    # Bump this whenever the policy changes: an older consent stops counting
+    # and the banner asks again.
+    attr_accessor :consent_version
+
+    # true, false, or a callable taking the request - e.g.
+    #   c.enabled = ->(request) { Rails.env.production? }
+    attr_accessor :enabled
+
+    # Emits Google's consent mode v2 defaults (everything denied) before any
+    # Google tag, and updates them when the visitor chooses. Leave it on if
+    # you use any Google product.
+    attr_accessor :google_consent_mode
+
+    # Store a row per decision, as proof of consent. Needs the engine mounted
+    # and the migration from `rails g consently:consent_log`.
+    attr_accessor :log_consents
+
+    # Whether consently_tags links the banner's stylesheet. Turn it off if
+    # you have taken the views over and styled them yourself.
+    attr_accessor :stylesheet
+
+    # Honour the browser's Do Not Track header as a rejection. Off by default:
+    # DNT is advisory and widely ignored, so treating it as a legal signal is
+    # your call, not the gem's.
+    attr_accessor :respect_do_not_track
+
+    # Global Privacy Control, which - unlike DNT - is a binding opt-out signal
+    # in California and Colorado. On by default, and a visitor who sends it is
+    # never shown the banner: their answer already arrived.
+    attr_accessor :respect_global_privacy_control
+
+    # Whether this visitor has to be asked at all. false means no banner and
+    # everything runs - the answer for traffic outside the EU when your legal
+    # advice says so:
+    #
+    #   c.consent_required = ->(request) { EU_COUNTRIES.include?(request.headers["CF-IPCountry"]) }
+    #
+    # Careful: this switches tags on without asking, so it is opt-in.
+    attr_accessor :consent_required
+
+    # Reload the page once a choice is made. Off by default - releasing the
+    # blocked tags in place is the whole point, and a reload throws away
+    # whatever the visitor was doing. Turn it on when the page itself renders
+    # differently depending on consent (an embedded map, a video, a status
+    # list) and you would rather let the server decide again.
+    attr_accessor :reload_after_choice
+
+    # Who made the decision, for the consent log. A callable taking the
+    # request; return anything that identifies the visitor in your own system
+    # (a global id, "User#42", an account number). Left nil the log stays
+    # anonymous, which is the right default for a public site.
+    attr_accessor :consent_subject
+
+    # Where the cookie policy lives. A string, or a callable taking the view
+    # context - handy when the URL is locale dependent.
+    attr_accessor :policy_url
+
+    # Which scope a request belongs to, e.g. ->(request) { request.host }.
+    # Nil means every request sees the default configuration.
+    attr_accessor :scope_resolver
+
+    attr_reader :categories
+
+    def initialize
+      @cookie_name = "consently"
+      @cookie_max_age = 60 * 60 * 24 * 180 # six months, the usual guidance
+      @cookie_path = "/"
+      @consent_version = 1
+      @enabled = true
+      @google_consent_mode = true
+      @stylesheet = true
+      @log_consents = false
+      @respect_do_not_track = false
+      @respect_global_privacy_control = true
+      @consent_required = true
+      @reload_after_choice = false
+      @consent_subject = nil
+      @policy_url = nil
+      @scope_resolver = nil
+      @categories = DEFAULT_CATEGORIES.dup
+      @scopes = {}
+    end
+
+    # A category of your own, shown in the preferences panel alongside the
+    # built-in ones. Give it a name in your locale file.
+    def category(name)
+      name = name.to_sym
+      @categories << name unless @categories.include?(name)
+      name
+    end
+
+    def optional_categories
+      categories - [ Consent::NECESSARY ]
+    end
+
+    # c.tag :google_analytics, id: "G-XXXX"
+    def tag(key, **options)
+      default_scope.tag(key, **options)
+    end
+
+    # Tags for one shop, host or whatever your scope_resolver returns. Falls
+    # back to the tags declared outside any scope, and may override them by
+    # declaring the same provider again.
+    #
+    #   c.scope "trixbrix" do |s|
+    #     s.tag :google_analytics, id: "G-TRIX"
+    #   end
+    def scope(name)
+      scope = (@scopes[name.to_s] ||= Scope.new)
+      yield scope if block_given?
+      scope
+    end
+
+    def tags_for(scope_name = nil)
+      tags = default_scope.tags.dup
+      tags.merge!(@scopes[scope_name.to_s].tags) if scope_name && @scopes.key?(scope_name.to_s)
+      tags.values
+    end
+
+    def default_scope
+      @default_scope ||= Scope.new
+    end
+
+    # A named bundle of tags. Same API as the top-level `tag`, which is what
+    # makes the block form read the way it does.
+    class Scope
+      def initialize
+        @tags = {}
+      end
+
+      def tag(key, **options)
+        provider = Providers::Base.build(key, **options)
+        @tags[provider.key] = provider
+      end
+
+      def tags
+        @tags
+      end
+    end
+  end
+end

data/lib/consently/consent.rb

@@ -0,0 +1,62 @@
+module Consently
+  # What the visitor has agreed to, as read from the cookie.
+  #
+  # The cookie is deliberately tiny and readable by JavaScript - the banner
+  # writes it in the browser and the server only reads it, so a page rendered
+  # after the choice can emit the real tags instead of blocked ones.
+  #
+  #   {"v":1,"c":["analytics"],"t":"2026-08-12T10:00:00Z"}
+  class Consent
+    NECESSARY = :necessary
+
+    attr_reader :categories, :version, :recorded_at
+
+    def self.none
+      new(given: false)
+    end
+
+    # Never raises: a cookie can be truncated, hand-edited or left over from an
+    # older format, and none of that should take a page down.
+    def self.from_cookie(raw, version:)
+      return none if raw.blank?
+
+      data = begin
+        JSON.parse(raw.to_s)
+      rescue JSON::ParserError
+        nil
+      end
+      return none unless data.is_a?(Hash)
+
+      # A consent given against an older policy version counts as no consent:
+      # the banner asks again and nothing runs in the meantime.
+      return none unless data["v"].to_s == version.to_s
+
+      new(
+        categories: Array(data["c"]).map { |category| category.to_s.to_sym },
+        version: data["v"],
+        recorded_at: data["t"]
+      )
+    end
+
+    def initialize(categories: [], version: nil, recorded_at: nil, given: true)
+      @categories = Array(categories).map(&:to_sym).freeze
+      @version = version
+      @recorded_at = recorded_at
+      @given = given
+    end
+
+    def given?
+      @given
+    end
+
+    # Necessary tags are the ones the site cannot work without, so they never
+    # wait for a click.
+    def granted?(category)
+      category.to_sym == NECESSARY || categories.include?(category.to_sym)
+    end
+
+    def to_h
+      { "v" => version, "c" => categories.map(&:to_s), "t" => recorded_at }
+    end
+  end
+end

data/lib/consently/cookie.rb

@@ -0,0 +1,12 @@
+module Consently
+  # One cookie a tag is known to set. A cookie policy has to name them and say
+  # how long they last, which is exactly the part everyone copies from a
+  # competitor's site and gets wrong.
+  #
+  # `days` is nil for a session cookie.
+  Cookie = Struct.new(:name, :days, :provider, keyword_init: true) do
+    def session?
+      days.nil?
+    end
+  end
+end

data/lib/consently/engine.rb

@@ -0,0 +1,33 @@
+module Consently
+  class Engine < ::Rails::Engine
+    isolate_namespace Consently
+
+    initializer "consently.helpers" do
+      ActiveSupport.on_load(:action_view) do
+        include Consently::TagsHelper
+      end
+    end
+
+    # The engine's app/assets comes along on its own; app/javascript does not,
+    # and Sprockets needs the two entries named before it will compile them.
+    initializer "consently.assets" do |app|
+      if app.config.respond_to?(:assets)
+        app.config.assets.paths << root.join("app/javascript")
+        if app.config.assets.respond_to?(:precompile)
+          app.config.assets.precompile += %w[consently.css consently/banner_controller.js]
+        end
+      end
+    end
+
+    # The banner controller gets pinned for the host application, so
+    # `import "consently/banner_controller"` resolves without anyone editing
+    # config/importmap.rb. Our paths have to be in place before importmap-rails
+    # draws them, hence `before:`.
+    initializer "consently.importmap", before: "importmap" do |app|
+      if app.config.respond_to?(:importmap)
+        app.config.importmap.paths << root.join("config/importmap.rb")
+        app.config.importmap.cache_sweepers << root.join("app/javascript")
+      end
+    end
+  end
+end

data/lib/consently/providers/base.rb

@@ -0,0 +1,95 @@
+module Consently
+  module Providers
+    # A tag vendor: what scripts it needs and which consent category it falls
+    # under. Subclasses describe the snippet as data (see Consently::Script)
+    # so the view can render it live or blocked from the same description.
+    class Base
+      # Ids are interpolated straight into JavaScript, so they are held to a
+      # shape that cannot carry a quote or a bracket out of the string.
+      SAFE_OPTION = /\A[\w\-.:\/]+\z/
+
+      class << self
+        def registry
+          @@registry ||= {}
+        end
+
+        def register(key, klass)
+          registry[key.to_sym] = klass
+        end
+
+        def build(key, **options)
+          klass = registry[key.to_sym] or raise UnknownProvider, key
+          klass.new(**options)
+        end
+
+        # Set by each subclass; where a vendor is unambiguous (Plausible does
+        # not touch cookies) it can say :necessary and load right away.
+        attr_accessor :default_category
+
+        def provider_key
+          @provider_key
+        end
+
+        def provider_key=(key)
+          @provider_key = key.to_sym
+          register(@provider_key, self)
+        end
+
+        # What this vendor stores in the visitor's browser, for the policy
+        # page. `days: nil` means a session cookie.
+        def cookie(name, days: nil)
+          cookie_manifest << { name: name, days: days }
+        end
+
+        def cookie_manifest
+          @cookie_manifest ||= []
+        end
+      end
+
+      attr_reader :options, :category, :key
+
+      def initialize(**options)
+        @options = options
+        @category = (options[:category] || self.class.default_category).to_sym
+        @key = (options[:as] || self.class.provider_key).to_sym
+        validate!
+      end
+
+      # Array<Consently::Script>
+      def scripts
+        []
+      end
+
+      # Array<Consently::Cookie> - what this tag leaves in the browser.
+      def cookies
+        self.class.cookie_manifest.map { |attributes| Cookie.new(**attributes, provider: key) }
+      end
+
+      # Rendered inside <body>, for vendors that still ship a <noscript>
+      # fallback (Google Tag Manager, Meta). HTML string or nil.
+      def noscript
+        nil
+      end
+
+      def to_s
+        "#{key} (#{category})"
+      end
+
+      private
+
+      def validate!
+        # Subclasses call require_option for what they cannot work without.
+      end
+
+      def require_option(name)
+        value = options[name]
+        raise MissingOption, "Consently: #{self.class.provider_key} needs a #{name}:" if value.blank?
+        unless value.to_s.match?(SAFE_OPTION)
+          raise MissingOption, "Consently: #{name}: #{value.inspect} for #{self.class.provider_key} contains characters that are not allowed in a tag id"
+        end
+
+        value.to_s
+      end
+    end
+  end
+end

data/lib/consently/providers/clarity.rb

@@ -0,0 +1,34 @@
+module Consently
+  module Providers
+    # Microsoft Clarity: session recordings and heatmaps.
+    class Clarity < Base
+      self.provider_key = :clarity
+      self.default_category = :analytics
+
+      cookie "_clck", days: 365
+      cookie "_clsk", days: 1
+      cookie "CLID", days: 365
+      cookie "MUID", days: 390
+      cookie "ANONCHK", days: nil
+
+      def scripts
+        [ Script.new(inline: <<~JS.strip) ]
+          (function(c,l,a,r,i,t,y){c[a]=c[a]||function(){(c[a].q=c[a].q||[]).push(arguments)};
+          t=l.createElement(r);t.async=1;t.src="https://www.clarity.ms/tag/"+i;
+          y=l.getElementsByTagName(r)[0];y.parentNode.insertBefore(t,y);
+          })(window, document, "clarity", "script", "#{id}");
+        JS
+      end
+
+      private
+
+      def id
+        @id ||= require_option(:id)
+      end
+
+      def validate!
+        id
+      end
+    end
+  end
+end