@intlayer/analytics 9.0.0-canary.16

package/README.md

@@ -0,0 +1,330 @@
+<p align="center">
+  <a href="https://intlayer.org" rel="">
+    <img src="https://raw.githubusercontent.com/aymericzip/intlayer/main/docs/assets/cover.png" width="60%" alt="Intlayer Logo" />
+  </a>
+</p>
+
+<h1 align="center">
+  <strong>Per-component i18n</strong>
+</h1>
+
+<h2 align="center">
+  <strong>AI-powered translation. Visual Editor. Multilingual CMS.</strong>
+</h2>
+
+<br />
+
+<p align="center">
+  <a href="https://intlayer.org/doc/concept/content" rel="">Docs</a> •
+  <a href="https://intlayer.org/doc/environment/nextjs" rel="">Next.js</a> •
+  <a href="https://intlayer.org/doc/environment/vite-and-react" rel="">React + Vite</a> •
+  <a href="https://intlayer.org/doc/concept/cms" rel="">CMS</a> •
+  <a href="https://discord.gg/7uxamYVeCk" rel="noopener noreferrer nofollow">Discord</a>
+</p>
+<p align="center" style="margin-top:15px;">
+  <a href="https://www.npmjs.com/package/intlayer" target="_blank" rel="noopener noreferrer nofollow"><img src="https://img.shields.io/npm/v/intlayer?style=for-the-badge&labelColor=FFFFFF&color=000000&logoColor=FFFFFF" alt="npm version" height="24"/></a>
+  <a href="https://github.com/aymericzip/intlayer/stargazers" target="_blank" rel="noopener noreferrer nofollow"><img src="https://img.shields.io/github/stars/aymericzip/intlayer?style=for-the-badge&labelColor=000000&color=FFFFFF&logo=github&logoColor=FFD700" alt="GitHub Stars" height="24"/></a>
+  <a href="https://www.npmjs.org/package/intlayer" target="_blank" rel="noopener noreferrer nofollow"><img src="https://img.shields.io/npm/dm/intlayer?style=for-the-badge&labelColor=000000&color=FFFFFF&logoColor=000000&cacheSeconds=86400" alt="monthly downloads" height="24"/></a>
+  <a href="https://github.com/aymericzip/intlayer/blob/main/LICENSE" target="_blank" rel="noopener noreferrer nofollow"><img src="https://img.shields.io/github/license/aymericzip/intlayer?style=for-the-badge&labelColor=000000&color=FFFFFF&logoColor=000000&cacheSeconds=86400" alt="license"/></a>
+  <a href="https://github.com/aymericzip/intlayer/commits/main" target="_blank" rel="noopener noreferrer nofollow"><img src="https://img.shields.io/github/last-commit/aymericzip/intlayer?style=for-the-badge&labelColor=000000&color=FFFFFF&logoColor=000000&cacheSeconds=86400" alt="last commit"/>
+  </a>
+</p>
+
+![Watch the video](https://github.com/aymericzip/intlayer/blob/main/docs/assets/demo_video.gif)
+
+<a href="https://intlayer.org/doc/concept/content" rel="">
+  <img src="https://img.shields.io/badge/Get_Started-FFFFFF?style=for-the-badge&logo=rocket&logoColor=black" />
+</a>
+
+## What is Intlayer?
+
+Most i18n libraries are either too complex, too rigid, or not built for modern frameworks.
+
+Intlayer is a **modern i18n solution** for web and mobile apps.  
+It’s framework-agnostic, **AI-powered**, and includes a free **CMS & visual editor**.
+
+With **per-locale content files**, **TypeScript autocompletion**, **tree-shakable dictionaries**, and **CI/CD integration**, Intlayer makes internationalization **faster, cleaner, and smarter**.
+
+## Keys benefits of Intlayer:
+
+| Feature                                                                                                                                             | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| --------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true" alt="Feature" width="700">                          | **Cross-Frameworks Support**<br><br>Intlayer is compatible with all major frameworks and libraries, including Next.js, React, Vite, Vue.js, Nuxt, Preact, Express, and more.                                                                                                                                                                                                                                                                                                |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true" alt="Feature" width="700">       | **JavaScript-Powered Content Management**<br><br>Harness the flexibility of JavaScript to define and manage your content efficiently. <br><br> - [Content declaration](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                                                                            |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true" alt="Feature" width="700"> | **Per-Locale Content Declaration File**<br><br>Speed up your development by declaring your content once, before auto generation.<br><br> - [Per-Locale Content Declaration File](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                                                                                          |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="Feature" width="700">                            | **Compiler**<br><br>The Intlayer Compiler extract automatically the content from the components and generate the dictionary files.<br><br> - [Compiler](https://intlayer.org/doc/compiler)                                                                                                                                                                                                                                                                                  |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true" alt="Feature" width="700">                      | **Type-Safe Environment**<br><br>Leverage TypeScript to ensure your content definitions and code are error-free, while also benefiting from IDE autocompletion.<br><br> - [TypeScript configuration](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                                                                              |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true" alt="Feature" width="700">                         | **Simplified Setup**<br><br>Get up and running quickly with minimal configuration. Adjust settings for internationalization, routing, AI, build, and content handling with ease. <br><br> - [Explore Next.js integration](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                      |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/content_retrieval.png?raw=true" alt="Feature" width="700">                   | **Simplified Content Retrieval**<br><br>No need to call your `t` function for each piece of content. Retrieve all your content directly using a single hook.<br><br> - [React integration](https://intlayer.org/doc/environment/create-react-app)                                                                                                                                                                                                                           |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/server_component.png?raw=true" alt="Feature" width="700">                    | **Consistent Server Component Implementation**<br><br>Perfectly suited for Next.js server components, use the same implementation for both client and server components, no need to pass your `t` function across each server component. <br><br> - [Server Components](https://intlayer.org/doc/environment/nextjs#step-7-utilize-content-in-your-code)                                                                                                                    |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/file_tree.png?raw=true" alt="Feature" width="700">                           | **Organized Codebase**<br><br>Keep your codebase more organized: 1 component = 1 dictionary in the same folder. Translations close to their respective components, enhance maintainability and clarity. <br><br> - [How Intlayer works](https://intlayer.org/doc/concept/how-works-intlayer)                                                                                                                                                                                |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/url_routing.png?raw=true" alt="Feature" width="700">                         | **Enhanced Routing**<br><br>Full support of app routing, adapting seamlessly to complex application structures, for Next.js, React, Vite, Vue.js, etc.<br><br> - [Explore Next.js integration](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                 |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/markdown.png?raw=true" alt="Feature" width="700">                            | **Markdown Support**<br><br>Import and interpret, locale files and remote Markdown for multilingual content like privacy policies, documentation, etc. Interpret and make Markdown metadata accessible in your code.<br><br> - [Content files](https://intlayer.org/doc/concept/content/file)                                                                                                                                                                               |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.png?raw=true" alt="Feature" width="700">                       | **Free Visual Editor & CMS**<br><br>A free visual editor and CMS are available for content writers, removing the need for a localization platform. Keep your content synchronized using Git, or externalize it totally or partially with the CMS.<br><br> - [Intlayer Editor](https://intlayer.org/doc/concept/editor) <br> - [Intlayer CMS](https://intlayer.org/doc/concept/cms)                                                                                          |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/bundle.png?raw=true" alt="Feature" width="700">                              | **Tree-shakable Content**<br><br>Tree-shakable content, reducing the size of the final bundle. Loads content per component, excluding any unused content from your bundle. Supports lazy loading to enhance app loading efficiency. <br><br> - [App build optimization](https://intlayer.org/doc/concept/how-works-intlayer#app-build-optimization)                                                                                                                         |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/static_rendering.png?raw=true" alt="Feature" width="700">                    | **Static Rendering**<br><br>Doesn't block Static Rendering. <br><br> - [Next.js integration](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                                                                                                                                                                                                   |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/AI_translation.png?raw=true" alt="Feature" width="700">                      | **AI-Powered Translation**<br><br>Transform your website into 231 languages with just one click using Intlayer's advanced AI-powered translation tools using your own AI provider / API key. <br><br> - [CI/CD integration](https://intlayer.org/doc/concept/ci-cd) <br> - [Intlayer CLI](https://intlayer.org/doc/concept/cli) <br> - [Auto fill](https://intlayer.org/doc/concept/auto-fill)                                                                              |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/mcp.png?raw=true" alt="Feature" width="700">                                 | **MCP Server Integration**<br><br>Provides an MCP (Model Context Protocol) server for IDE automation, enabling seamless content management and i18n workflows directly within your development environment. <br><br> - [MCP Server](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/mcp_server.md)                                                                                                                                                            |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/vscode_extension.png?raw=true" alt="Feature" width="700">                    | **VSCode Extension**<br><br>Intlayer provides a VSCode extension to help you manage your content and translations, building your dictionaries, translating your content, and more. <br><br> - [VSCode Extension](https://intlayer.org/doc/vs-code-extension)                                                                                                                                                                                                                |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/interoperability.png?raw=true" alt="Feature" width="700">                    | **Interoperability**<br><br>Allow interoperability with react-i18next, next-i18next, next-intl, react-intl, vue-i18n. <br><br> - [Intlayer and react-intl](https://intlayer.org/blog/intlayer-with-react-intl) <br> - [Intlayer and next-intl](https://intlayer.org/blog/intlayer-with-next-intl) <br> - [Intlayer and next-i18next](https://intlayer.org/blog/intlayer-with-next-i18next) <br> - [Intlayer and vue-i18n](https://intlayer.org/blog/intlayer-with-vue-i18n) |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/benchmark.png?raw=true" alt="Feature" width="700">                           | **Performances & Benchmark**<br><br>Uses advanced tree-shaking and dynamic loading to boost performances and keep the solution as light as possible. <br><br> - [Performances & Benchmark](https://intlayer.org/doc/benchmark)                                                                                                                                                                                                                                              |
+
+---
+
+## 📦 Installation
+
+Start your journey with Intlayer today and experience a smoother, more powerful approach to internationalization.
+
+<a href="https://intlayer.org/doc/concept/content" rel="">
+  <img src="https://img.shields.io/badge/Get_Started-FFFFFF?style=for-the-badge&logo=rocket&logoColor=black" />
+</a>
+
+```bash
+npm install intlayer react-intlayer
+```
+
+⚡ Quick Start (Next.js)
+
+```ts
+// intlayer.config.ts
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+export default config;
+```
+
+```ts
+// app/home.content.ts
+import { t, type Dictionary } from "intlayer";
+
+const content = {
+  key: "home",
+  content: {
+    title: t({
+      en: "Home",
+      fr: "Accueil",
+      es: "Inicio",
+    }),
+  },
+} satisfies Dictionary;
+
+export default content;
+```
+
+```tsx
+// app/page.tsx
+import { useIntlayer } from "react-intlayer";
+
+const HomePage = () => {
+  const { title } = useIntlayer("home");
+
+  return <h1>{title}</h1>;
+};
+```
+
+<a href="https://intlayer.org/doc/environment/nextjs"> Get the full guide → </a>
+
+## 🎥 Live tutorial on YouTube
+
+[![How to Internationalize your application using Intlayer](https://i.ytimg.com/vi/e_PPG7PTqGU/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDtyJ4uYotEjl12nZ_gZKZ_kjEgOQ)](https://youtu.be/e_PPG7PTqGU?si=GyU_KpVhr61razRw)
+
+<a href="https://intlayer.org/doc/concept/content" rel="">
+  <img src="https://img.shields.io/badge/Get_Started-FFFFFF?style=for-the-badge&logo=rocket&logoColor=black" />
+</a>
+
+## Table of Contents
+
+Explore our comprehensive documentation to get started with Intlayer and learn how to integrate it into your projects.
+
+<details open>
+<summary style="font-size:16px; font-weight:bold;">📘 Get Started</summary>
+<ul>
+  <li><a href="https://intlayer.org/doc/why" rel=''>Why Intlayer?</a></li>
+  <li><a href="https://intlayer.org/doc" rel=''>Introduction</a></li>
+</ul>
+</details>
+
+<details>
+<summary style="font-size:16px; font-weight:bold;">⚙️ Concept</summary>
+<ul>
+  <li><a href="https://intlayer.org/doc/concept/how-works-intlayer" rel=''>How Intlayer Works</a></li>
+  <li><a href="https://intlayer.org/doc/concept/configuration" rel=''>Configuration</a></li>
+  <li><a href="https://intlayer.org/doc/concept/cli" rel=''>Intlayer CLI</a></li>
+  <li><a href="https://intlayer.org/doc/compiler" rel=''>Compiler</a></li>
+
+  <li><a href="https://intlayer.org/doc/concept/editor" rel=''>Intlayer Editor</a></li>
+  <li><a href="https://intlayer.org/doc/concept/cms" rel=''>Intlayer CMS</a></li>
+  <li><a href="https://intlayer.org/doc/concept/content" rel=''>Dictionary</a>
+    <ul>
+      <li><a href="https://intlayer.org/doc/concept/content/per-locale-file" rel=''>Per-Locale Content Declaration File</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/translation" rel=''>Translation</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/enumeration" rel=''>Enumeration</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/condition" rel=''>Condition</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/nesting" rel=''>Nesting</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/markdown" rel=''>Markdown</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/function-fetching" rel=''>Function Fetching</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/insertion" rel=''>Insertion</a></li>
+      <li><a href="https://intlayer.org/doc/concept/content/file" rel=''>File</a></li>
+    </ul>
+  </li>
+</ul>
+</details>
+
+<details open>
+<summary style="font-size:16px; font-weight:bold;">🌐 Environment</summary>
+<ul>
+  <li><a href="https://intlayer.org/doc/environment/nextjs" rel=''>Intlayer with Next.js 16</a>
+    <ul>
+      <li><a href="https://intlayer.org/doc/environment/nextjs/15" rel=''>Next.js 15</a></li>
+      <li><a href="https://intlayer.org/doc/environment/nextjs/14" rel=''>Next.js 14 (App Router)</a></li>
+      <li><a href="https://intlayer.org/doc/environment/nextjs/next-with-Page-Router" rel=''>Next.js Page Router</a></li>
+      <li><a href="https://intlayer.org/doc/environment/nextjs/compiler" rel=''>Next.js using Compiler</a></li>
+    </ul>
+  </li>
+  <li><a href="https://intlayer.org/doc/environment/create-react-app" rel=''>React CRA</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-react" rel=''>Vite + React</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-react" rel=''>Vite + React using Compiler</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-react/compiler" rel=''>React-router-v7</a></li>
+  <li><a href="https://intlayer.org/doc/environment/tanstack-start" rel=''>Tanstack start</a>
+    <ul>
+      <li><a href="https://intlayer.org/doc/environment/tanstack-start/solid" rel=''>Solid</a></li>
+    </ul>
+  </li>
+  <li><a href="https://intlayer.org/doc/environment/astro" rel=''>Astro</a>
+    <ul>
+      <li><a href="https://intlayer.org/doc/environment/astro/react" rel=''>React</a></li>
+      <li><a href="https://intlayer.org/doc/environment/astro/vue" rel=''>Vue</a></li>
+      <li><a href="https://intlayer.org/doc/environment/astro/svelte" rel=''>Svelte</a></li>
+      <li><a href="https://intlayer.org/doc/environment/astro/solid" rel=''>Solid</a></li>
+      <li><a href="https://intlayer.org/doc/environment/astro/vanilla" rel=''>Vanilla JS</a></li>
+      <li><a href="https://intlayer.org/doc/environment/astro/lit" rel=''>Lit</a></li>
+    </ul>
+  </li>
+
+  <li><a href="https://intlayer.org/doc/environment/react-native-and-expo" rel=''>React Native</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-svelte" rel=''>Vite + Svelte</a></li>
+  <li><a href="https://intlayer.org/doc/environment/sveltekit" rel=''>SvelteKit</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-preact" rel=''>Vite + Preact</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-vue" rel=''>Vite + Vue</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-nuxt" rel=''>Vite + Nuxt</a></li>
+  <li><a href="https://intlayer.org/doc/environment/vite-and-solid" rel=''>Vite + Solid</a></li>
+  <li><a href="https://intlayer.org/doc/environment/angular" rel=''>Angular</a></li>
+  <li>
+     <a href="https://intlayer.org/doc/environment/express" rel=''>Backend</a>
+     <ul>
+      <li><a href="https://intlayer.org/doc/environment/express" rel=''>Express</a></li>
+      <li><a href="https://intlayer.org/doc/environment/nest" rel=''>NestJS</a></li>
+      <li><a href="https://intlayer.org/doc/environment/fastify" rel=''>Fastify</a></li>
+      <li><a href="https://intlayer.org/doc/environment/adonisjs" rel=''>AdonisJS</a></li>
+      <li><a href="https://intlayer.org/doc/environment/hono" rel=''>Hono</a></li>
+    </ul>
+  </li>
+</ul>
+</details>
+
+<details>
+<summary style="font-size:16px; font-weight:bold;">📊 Benchmark</summary>
+<ul>
+  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/nextjs.md" rel=''>Next.js</a></li>
+  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/tanstack.md" rel=''>TanStack Start</a></li>
+  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/vue.md" rel=''>Vue</a></li>
+  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/solid.md" rel=''>Solid</a></li>
+  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/svelte.md" rel=''>Svelte</a></li>
+</ul>
+</details>
+
+<details>
+<summary style="font-size:16px; font-weight:bold;">📰 Blog</summary>
+<ul>
+  <li><a href="https://github.com/aymericzip/intlayer/blob/main/docs/blog/en/what_is_internationalization.md" rel=''>What is i18n</a></li>
+  <li><a href="https://intlayer.org/blog/SEO-and-i18n" rel=''>i18n and SEO</a></li>
+  <li><a href="https://intlayer.org/blog/intlayer-with-next-i18next" rel=''>Intlayer and i18next</a></li>
+  <li><a href="https://intlayer.org/blog/intlayer-with-react-i18next" rel=''>Intlayer and react-intl</a></li>
+  <li><a href="https://intlayer.org/blog/intlayer-with-next-intl" rel=''>Intlayer and next-intl</a></li>
+</ul>
+</details>
+
+## Multilingual content management system
+
+More than an i18n library, Intlayer is a complete **multilingual content management system**. A full CMS is available for free at [app.intlayer.org](https://app.intlayer.org).
+
+Intlayer connects **developers**, **copywriters**, and **AI agents** in one workflow for creating and maintaining multilingual websites effortlessly.Intlayer replaces the following stack in a single solution:
+
+- i18n solutions (e.g. `i18next`, `next-intl`, `vue-i18n`)
+- TMSs (Translation Management Systems) (e.g. Crowdin, Phrase, Lokalise)
+- Feature flags
+- Headless CMSs (e.g. Contentful, Strapi, Sanity)
+
+![CMS Preview](https://github.com/aymericzip/intlayer/blob/main/docs/assets/CMS.png?raw=true)
+
+## 🌐 Readme in other languages
+
+<p align="center">
+  <a href="https://github.com/aymericzip/intlayer/blob/main/readme.md">English</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/readme.md">简体中文</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/readme.md">Русский</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/readme.md">日本語</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/fr/readme.md">Français</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/readme.md">한국어</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/es/readme.md">Español</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/de/readme.md">Deutsch</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/readme.md">العربية</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/readme.md">Italiano</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/en-GB/readme.md">English (UK)</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/readme.md">Português</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/hi/readme.md">हिन्दी</a> •
+  <a href="https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/readme.md">Türkçe</a>
+</p>
+
+## 🤝 Community
+
+Intlayer is built with and for the community and we’d love your input!
+
+- Have a suggestion? [Open an issue](https://github.com/aymericzip/intlayer/issues)
+- Found a bug or improvement? [Submit a PR](https://github.com/aymericzip/intlayer/pulls)
+- Need help or want to connect? [Join our Discord](https://discord.gg/7uxamYVeCk)
+
+You can also follow us on :
+
+  <div>
+    <br/>
+    <p align="center">
+      <a href="https://discord.gg/528mBV4N" target="blank" rel='noopener noreferrer nofollow'><img align="center"
+         src="https://img.shields.io/badge/discord-5865F2.svg?style=for-the-badge&logo=discord&logoColor=white"
+         alt="Intlayer Discord" height="30"/></a>
+      <a href="https://www.linkedin.com/company/intlayerorg" target="blank" rel='noopener noreferrer nofollow'><img align="center"
+         src="https://img.shields.io/badge/linkedin-%231DA1F2.svg?style=for-the-badge&logo=linkedin&logoColor=white"
+         alt="Intlayer LinkedIn" height="30"/></a>
+      <a href="https://www.instagram.com/intlayer/" target="blank" rel='noopener noreferrer nofollow'><img align="center"
+         src="https://img.shields.io/badge/instagram-%23E4405F.svg?style=for-the-badge&logo=Instagram&logoColor=white"
+         alt="Intlayer Instagram" height="30"/></a>
+      <a href="https://x.com/Intlayer183096" target="blank" rel='noopener noreferrer nofollow'><img align="center"
+         src="https://img.shields.io/badge/x-1DA1F2.svg?style=for-the-badge&logo=x&logoColor=white"
+         alt="Intlayer X" height="30"/></a>
+      <a href="https://www.youtube.com/@intlayer" target="blank" rel='noopener noreferrer nofollow'><img align="center"
+         src="https://img.shields.io/badge/youtube-FF0000.svg?style=for-the-badge&logo=youtube&logoColor=white"
+         alt="Intlayer YouTube" height="30"/></a>
+      <a href="https://www.tiktok.com/@intlayer" target="blank" rel='noopener noreferrer nofollow'><img align="center"
+         src="https://img.shields.io/badge/tiktok-000000.svg?style=for-the-badge&logo=tiktok&logoColor=white"
+         alt="Intlayer TikTok" height="30"/></a>
+      <br>
+    </p>
+</div>
+
+### Contribution
+
+For more detailed guidelines on contributing to this project, please refer to the [`CONTRIBUTING.md`](https://github.com/aymericzip/intlayer/blob/main/CONTRIBUTING.md) file. It contains essential information on our development process, commit message conventions, and release procedures. Your contributions are valuable to us, and we appreciate your efforts in making this project better!
+
+Contribute on [GitHub](https://github.com/aymericzip/intlayer), [GitLab](https://gitlab.com/ay.pineau/intlayer), or [Bitbucket](https://bitbucket.org/intlayer/intlayer/).
+
+### Thank You for the Support
+
+If you like Intlayer, give us a ⭐ on GitHub. It helps others discover the project! [See why GitHub Stars matter](https://github.com/aymericzip/intlayer/blob/main/CONTRIBUTING.md#why-github-stars-matter-).
+
+[![Star History Chart](https://api.star-history.com/svg?repos=aymericzip/intlayer&type=Date)](https://star-history.com/#aymericzip/intlayer&Date)

package/dist/cjs/core/AnalyticsClient.cjs

@@ -0,0 +1,182 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_utils_idle = require('../utils/idle.cjs');
+const require_core_abTesting = require('./abTesting.cjs');
+const require_core_eventBuffer = require('./eventBuffer.cjs');
+const require_core_sampling = require('./sampling.cjs');
+const require_core_session = require('./session.cjs');
+const require_core_transport = require('./transport.cjs');
+
+//#region src/core/AnalyticsClient.ts
+/** Default flush cadence — one network request per 20 seconds. */
+const DEFAULT_FLUSH_INTERVAL = 2e4;
+/** Default cap on distinct buffered events before an early flush. */
+const DEFAULT_MAX_BUFFER_SIZE = 500;
+/** Default sampling — keep every session. */
+const DEFAULT_SAMPLE_RATE = 1;
+/**
+* Maximum events per network request. `sendBeacon` and `fetch(keepalive)`
+* reject bodies over ~64KB, so large batches are split into multiple sends.
+*/
+const MAX_EVENTS_PER_SEND = 200;
+/** Identifies the producing SDK in the ingest envelope. */
+const SDK_VERSION = "intlayer-analytics/1";
+/**
+* Reads the current page pathname. Search params are intentionally excluded to
+* avoid capturing anything sensitive.
+*/
+const currentUrl = () => {
+	if (typeof window === "undefined" || !window.location) return "";
+	return window.location.pathname;
+};
+/**
+* Reduces the referrer to its host — never the full URL — for privacy.
+*/
+const referrerHost = () => {
+	if (typeof document === "undefined" || !document.referrer) return void 0;
+	try {
+		return new URL(document.referrer).host;
+	} catch {
+		return;
+	}
+};
+/**
+* Creates an analytics client. Prefer {@link initAnalyticsClient} in application
+* code — it manages a shared singleton so there is only ever one flush timer.
+*
+* @param config - Resolved client configuration.
+* @returns A started-on-demand {@link AnalyticsClient}.
+*/
+const createAnalyticsClient = (config) => {
+	const sessionId = require_core_session.getSessionId();
+	const sampledIn = require_core_sampling.isSampledIn(sessionId, config.sampleRate);
+	const buffer = require_core_eventBuffer.createEventBuffer({ max: config.maxBufferSize });
+	const endpoint = `${config.backendURL.replace(/\/$/, "")}/api/analytics/events`;
+	let ambientLocale = "";
+	let flushTimer = null;
+	let started = false;
+	let detachListeners = null;
+	let seenExposureKeys = /* @__PURE__ */ new Set();
+	const flush = (useBeacon = false) => {
+		const events = buffer.drain();
+		for (let start = 0; start < events.length; start += 200) require_core_transport.sendEvents(endpoint, {
+			clientId: config.clientId,
+			sessionId,
+			sdkVersion: SDK_VERSION,
+			events: events.slice(start, start + 200)
+		}, { useBeacon });
+	};
+	/** Pushes an event and triggers an early flush if the buffer is full. */
+	const enqueue = (event) => {
+		if (buffer.push(event) >= config.maxBufferSize) flush();
+	};
+	const setLocale = (locale) => {
+		ambientLocale = locale;
+	};
+	const trackPageView = (event = {}) => {
+		if (!sampledIn) return;
+		seenExposureKeys = /* @__PURE__ */ new Set();
+		enqueue({
+			type: "page_view",
+			t: Date.now(),
+			url: event.url ?? currentUrl(),
+			locale: event.locale ?? ambientLocale,
+			ref: event.ref ?? referrerHost(),
+			vw: event.vw ?? (typeof window !== "undefined" ? window.innerWidth : void 0),
+			vh: event.vh ?? (typeof window !== "undefined" ? window.innerHeight : void 0),
+			reason: event.reason ?? "initial"
+		});
+	};
+	const trackContentExposure = (event) => {
+		if (!sampledIn) return;
+		const locale = event.locale ?? ambientLocale;
+		const exposureKey = [
+			event.dictionaryKey,
+			event.keyPath,
+			locale,
+			event.experimentKey ?? "",
+			event.variant ?? ""
+		].join("
");
+		if (seenExposureKeys.has(exposureKey)) return;
+		seenExposureKeys.add(exposureKey);
+		enqueue({
+			...event,
+			type: "content_exposure",
+			t: Date.now(),
+			url: currentUrl(),
+			locale
+		});
+	};
+	const trackConversion = (event) => {
+		enqueue({
+			...event,
+			type: "conversion",
+			t: Date.now(),
+			url: currentUrl(),
+			locale: event.locale ?? ambientLocale
+		});
+		flush();
+	};
+	const getVariant = (experimentKey, variants, weights) => require_core_abTesting.assignVariant(sessionId, experimentKey, variants, weights);
+	/** Attaches lifecycle + SPA-navigation listeners without blocking render. */
+	const attachListeners = () => {
+		if (typeof window === "undefined") return;
+		const onHidden = () => {
+			if (document.visibilityState === "hidden") flush(true);
+		};
+		const onPageHide = () => flush(true);
+		const onPopState = () => trackPageView({ reason: "route_change" });
+		document.addEventListener("visibilitychange", onHidden);
+		window.addEventListener("pagehide", onPageHide, { capture: true });
+		window.addEventListener("popstate", onPopState);
+		const history = window.history;
+		const originalPush = history.pushState;
+		const patchedPushState = function patchedPush(...args) {
+			const result = originalPush.apply(this, args);
+			trackPageView({ reason: "route_change" });
+			return result;
+		};
+		history.pushState = patchedPushState;
+		detachListeners = () => {
+			document.removeEventListener("visibilitychange", onHidden);
+			window.removeEventListener("pagehide", onPageHide, { capture: true });
+			window.removeEventListener("popstate", onPopState);
+			if (history.pushState === patchedPushState) history.pushState = originalPush;
+		};
+	};
+	const start = () => {
+		if (started) return;
+		started = true;
+		flushTimer = setInterval(flush, config.flushInterval);
+		flushTimer?.unref?.();
+		require_utils_idle.onIdle(attachListeners);
+	};
+	const stop = () => {
+		if (!started) return;
+		started = false;
+		if (flushTimer) {
+			clearInterval(flushTimer);
+			flushTimer = null;
+		}
+		detachListeners?.();
+		detachListeners = null;
+		flush(true);
+	};
+	return {
+		setLocale,
+		trackPageView,
+		trackContentExposure,
+		trackConversion,
+		getVariant,
+		flush,
+		start,
+		stop
+	};
+};
+
+//#endregion
+exports.DEFAULT_FLUSH_INTERVAL = DEFAULT_FLUSH_INTERVAL;
+exports.DEFAULT_MAX_BUFFER_SIZE = DEFAULT_MAX_BUFFER_SIZE;
+exports.DEFAULT_SAMPLE_RATE = DEFAULT_SAMPLE_RATE;
+exports.MAX_EVENTS_PER_SEND = MAX_EVENTS_PER_SEND;
+exports.createAnalyticsClient = createAnalyticsClient;
+//# sourceMappingURL=AnalyticsClient.cjs.map

package/dist/cjs/core/AnalyticsClient.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsClient.cjs","names":["getSessionId","isSampledIn","createEventBuffer","assignVariant"],"sources":["../../../src/core/AnalyticsClient.ts"],"sourcesContent":["import { onIdle } from '../utils/idle';\nimport { assignVariant } from './abTesting';\nimport { createEventBuffer, type EventBuffer } from './eventBuffer';\nimport { isSampledIn } from './sampling';\nimport { getSessionId } from './session';\nimport { sendEvents } from './transport';\nimport type {\n  AnalyticsClientConfig,\n  AnalyticsEvent,\n  ContentExposureEvent,\n  ConversionEvent,\n  PageViewEvent,\n  TrackableEvent,\n} from './types';\n\n/**\n * Caller-supplied fields for a page view. Everything is optional — the client\n * fills `url`, `locale`, viewport, and referrer from the environment when omitted.\n */\nexport type PageViewInput = {\n  /** Explicit pathname / screen name (native runtimes have no `location`). */\n  url?: string;\n  /** Explicit locale; falls back to the client's ambient locale. */\n  locale?: string;\n  /** Referrer host override. */\n  ref?: string;\n  /** Viewport width override. */\n  vw?: number;\n  /** Viewport height override. */\n  vh?: number;\n  /** Why the view was recorded. */\n  reason?: PageViewEvent['reason'];\n};\n\n/** Default flush cadence — one network request per 20 seconds. */\nexport const DEFAULT_FLUSH_INTERVAL = 20_000;\n/** Default cap on distinct buffered events before an early flush. */\nexport const DEFAULT_MAX_BUFFER_SIZE = 500;\n/** Default sampling — keep every session. */\nexport const DEFAULT_SAMPLE_RATE = 1;\n/**\n * Maximum events per network request. `sendBeacon` and `fetch(keepalive)`\n * reject bodies over ~64KB, so large batches are split into multiple sends.\n */\nexport const MAX_EVENTS_PER_SEND = 200;\n/** Identifies the producing SDK in the ingest envelope. */\nconst SDK_VERSION = 'intlayer-analytics/1';\n\n/**\n * The public surface of the analytics client singleton. Framework bindings hold\n * a reference to this and forward provider/node/conversion signals into it.\n */\nexport type AnalyticsClient = {\n  /** Sets the ambient locale stamped onto subsequent events. */\n  setLocale: (locale: string) => void;\n  /** Records a page/locale view (provider level). */\n  trackPageView: (event?: PageViewInput) => void;\n  /** Records a content exposure (node level). Sampled + deduped per page view. */\n  trackContentExposure: (\n    event: Omit<TrackableEvent<ContentExposureEvent>, 'type'>\n  ) => void;\n  /** Records a conversion tied to an experiment variant. */\n  trackConversion: (\n    event: Omit<TrackableEvent<ConversionEvent>, 'type'>\n  ) => void;\n  /** Deterministically resolves this session's variant for an experiment. */\n  getVariant: (\n    experimentKey: string,\n    variants: string[],\n    weights?: number[]\n  ) => string;\n  /** Sends the buffered batch now. */\n  flush: (useBeacon?: boolean) => void;\n  /** Starts the flush loop and lifecycle listeners (idempotent). */\n  start: () => void;\n  /** Stops timers/listeners and flushes any remaining events. */\n  stop: () => void;\n};\n\n/**\n * Reads the current page pathname. Search params are intentionally excluded to\n * avoid capturing anything sensitive.\n */\nconst currentUrl = (): string => {\n  if (typeof window === 'undefined' || !window.location) return '';\n  return window.location.pathname;\n};\n\n/**\n * Reduces the referrer to its host — never the full URL — for privacy.\n */\nconst referrerHost = (): string | undefined => {\n  if (typeof document === 'undefined' || !document.referrer) return undefined;\n  try {\n    return new URL(document.referrer).host;\n  } catch {\n    return undefined;\n  }\n};\n\n/**\n * Creates an analytics client. Prefer {@link initAnalyticsClient} in application\n * code — it manages a shared singleton so there is only ever one flush timer.\n *\n * @param config - Resolved client configuration.\n * @returns A started-on-demand {@link AnalyticsClient}.\n */\nexport const createAnalyticsClient = (\n  config: AnalyticsClientConfig\n): AnalyticsClient => {\n  const sessionId = getSessionId();\n  const sampledIn = isSampledIn(sessionId, config.sampleRate);\n  const buffer: EventBuffer = createEventBuffer({ max: config.maxBufferSize });\n  const endpoint = `${config.backendURL.replace(/\\/$/, '')}/api/analytics/events`;\n\n  let ambientLocale = '';\n  let flushTimer: ReturnType<typeof setInterval> | null = null;\n  let started = false;\n  let detachListeners: (() => void) | null = null;\n\n  // Exposure keys already recorded for the current page view. React (and other\n  // frameworks) resolve content nodes on every re-render; without this gate a\n  // component re-rendering 60×/s would count 60 exposures per second. The set\n  // is cleared on each page view so the recorded semantic is \"shown at least\n  // once during this page view\".\n  let seenExposureKeys = new Set<string>();\n\n  const flush = (useBeacon = false): void => {\n    const events = buffer.drain();\n\n    // Split into bounded chunks so no single request exceeds transport limits.\n    for (let start = 0; start < events.length; start += MAX_EVENTS_PER_SEND) {\n      sendEvents(\n        endpoint,\n        {\n          clientId: config.clientId,\n          sessionId,\n          sdkVersion: SDK_VERSION,\n          events: events.slice(start, start + MAX_EVENTS_PER_SEND),\n        },\n        { useBeacon }\n      );\n    }\n  };\n\n  /** Pushes an event and triggers an early flush if the buffer is full. */\n  const enqueue = (event: AnalyticsEvent): void => {\n    const size = buffer.push(event);\n    if (size >= config.maxBufferSize) flush();\n  };\n\n  const setLocale = (locale: string): void => {\n    ambientLocale = locale;\n  };\n\n  const trackPageView: AnalyticsClient['trackPageView'] = (event = {}) => {\n    if (!sampledIn) return;\n\n    // A new page view starts a fresh exposure window.\n    seenExposureKeys = new Set<string>();\n\n    enqueue({\n      type: 'page_view',\n      t: Date.now(),\n      url: event.url ?? currentUrl(),\n      locale: event.locale ?? ambientLocale,\n      ref: event.ref ?? referrerHost(),\n      vw:\n        event.vw ??\n        (typeof window !== 'undefined' ? window.innerWidth : undefined),\n      vh:\n        event.vh ??\n        (typeof window !== 'undefined' ? window.innerHeight : undefined),\n      reason: event.reason ?? 'initial',\n    });\n  };\n\n  const trackContentExposure: AnalyticsClient['trackContentExposure'] = (\n    event\n  ) => {\n    if (!sampledIn) return;\n\n    const locale = event.locale ?? ambientLocale;\n    // Joined with \\x01 (never present in content keys) so parts cannot collide.\n    const exposureKey = [\n      event.dictionaryKey,\n      event.keyPath,\n      locale,\n      event.experimentKey ?? '',\n      event.variant ?? '',\n    ].join('\u0001');\n\n    // Deduplicate within the current page view (see `seenExposureKeys`).\n    if (seenExposureKeys.has(exposureKey)) return;\n    seenExposureKeys.add(exposureKey);\n\n    enqueue({\n      ...event,\n      type: 'content_exposure',\n      t: Date.now(),\n      url: currentUrl(),\n      locale,\n    });\n  };\n\n  const trackConversion: AnalyticsClient['trackConversion'] = (event) => {\n    // Conversions are never sampled out — they are rare and decisive for A/B.\n    enqueue({\n      ...event,\n      type: 'conversion',\n      t: Date.now(),\n      url: currentUrl(),\n      locale: event.locale ?? ambientLocale,\n    });\n    // Flush conversions promptly so they are not lost on immediate navigation.\n    flush();\n  };\n\n  const getVariant: AnalyticsClient['getVariant'] = (\n    experimentKey,\n    variants,\n    weights\n  ) => assignVariant(sessionId, experimentKey, variants, weights);\n\n  /** Attaches lifecycle + SPA-navigation listeners without blocking render. */\n  const attachListeners = (): void => {\n    if (typeof window === 'undefined') return;\n\n    const onHidden = (): void => {\n      if (document.visibilityState === 'hidden') flush(true);\n    };\n    const onPageHide = (): void => flush(true);\n    const onPopState = (): void => trackPageView({ reason: 'route_change' });\n\n    document.addEventListener('visibilitychange', onHidden);\n    window.addEventListener('pagehide', onPageHide, { capture: true });\n    window.addEventListener('popstate', onPopState);\n\n    // Patch history.pushState so client-side route changes emit a page view.\n    // `replaceState` is intentionally left untouched: routers use it for\n    // same-page URL sync (scroll, params), which is not a navigation.\n    const history = window.history;\n    const originalPush = history.pushState;\n\n    const patchedPushState = function patchedPush(\n      this: History,\n      ...args: Parameters<History['pushState']>\n    ) {\n      const result = originalPush.apply(this, args);\n      trackPageView({ reason: 'route_change' });\n      return result;\n    };\n    history.pushState = patchedPushState;\n\n    detachListeners = (): void => {\n      document.removeEventListener('visibilitychange', onHidden);\n      window.removeEventListener('pagehide', onPageHide, { capture: true });\n      window.removeEventListener('popstate', onPopState);\n      // Only restore if nothing else re-patched pushState after us; restoring\n      // blindly would clobber another library's wrapper.\n      if (history.pushState === patchedPushState) {\n        history.pushState = originalPush;\n      }\n    };\n  };\n\n  const start = (): void => {\n    if (started) return;\n    started = true;\n\n    flushTimer = setInterval(flush, config.flushInterval);\n    // Some runtimes (Node during SSR) keep the process alive on timers.\n    (flushTimer as { unref?: () => void })?.unref?.();\n\n    onIdle(attachListeners);\n  };\n\n  const stop = (): void => {\n    if (!started) return;\n    started = false;\n\n    if (flushTimer) {\n      clearInterval(flushTimer);\n      flushTimer = null;\n    }\n    detachListeners?.();\n    detachListeners = null;\n    flush(true);\n  };\n\n  return {\n    setLocale,\n    trackPageView,\n    trackContentExposure,\n    trackConversion,\n    getVariant,\n    flush,\n    start,\n    stop,\n  };\n};\n"],"mappings":";;;;;;;;;;AAmCA,MAAa,yBAAyB;;AAEtC,MAAa,0BAA0B;;AAEvC,MAAa,sBAAsB;;;;;AAKnC,MAAa,sBAAsB;;AAEnC,MAAM,cAAc;;;;;AAqCpB,MAAM,mBAA2B;AAC/B,KAAI,OAAO,WAAW,eAAe,CAAC,OAAO,SAAU,QAAO;AAC9D,QAAO,OAAO,SAAS;;;;;AAMzB,MAAM,qBAAyC;AAC7C,KAAI,OAAO,aAAa,eAAe,CAAC,SAAS,SAAU,QAAO;AAClE,KAAI;AACF,SAAO,IAAI,IAAI,SAAS,SAAS,CAAC;SAC5B;AACN;;;;;;;;;;AAWJ,MAAa,yBACX,WACoB;CACpB,MAAM,YAAYA,mCAAc;CAChC,MAAM,YAAYC,kCAAY,WAAW,OAAO,WAAW;CAC3D,MAAM,SAAsBC,2CAAkB,EAAE,KAAK,OAAO,eAAe,CAAC;CAC5E,MAAM,WAAW,GAAG,OAAO,WAAW,QAAQ,OAAO,GAAG,CAAC;CAEzD,IAAI,gBAAgB;CACpB,IAAI,aAAoD;CACxD,IAAI,UAAU;CACd,IAAI,kBAAuC;CAO3C,IAAI,mCAAmB,IAAI,KAAa;CAExC,MAAM,SAAS,YAAY,UAAgB;EACzC,MAAM,SAAS,OAAO,OAAO;AAG7B,OAAK,IAAI,QAAQ,GAAG,QAAQ,OAAO,QAAQ,aACzC,mCACE,UACA;GACE,UAAU,OAAO;GACjB;GACA,YAAY;GACZ,QAAQ,OAAO,MAAM,OAAO,YAA4B;GACzD,EACD,EAAE,WAAW,CACd;;;CAKL,MAAM,WAAW,UAAgC;AAE/C,MADa,OAAO,KAAK,MACjB,IAAI,OAAO,cAAe,QAAO;;CAG3C,MAAM,aAAa,WAAyB;AAC1C,kBAAgB;;CAGlB,MAAM,iBAAmD,QAAQ,EAAE,KAAK;AACtE,MAAI,CAAC,UAAW;AAGhB,qCAAmB,IAAI,KAAa;AAEpC,UAAQ;GACN,MAAM;GACN,GAAG,KAAK,KAAK;GACb,KAAK,MAAM,OAAO,YAAY;GAC9B,QAAQ,MAAM,UAAU;GACxB,KAAK,MAAM,OAAO,cAAc;GAChC,IACE,MAAM,OACL,OAAO,WAAW,cAAc,OAAO,aAAa;GACvD,IACE,MAAM,OACL,OAAO,WAAW,cAAc,OAAO,cAAc;GACxD,QAAQ,MAAM,UAAU;GACzB,CAAC;;CAGJ,MAAM,wBACJ,UACG;AACH,MAAI,CAAC,UAAW;EAEhB,MAAM,SAAS,MAAM,UAAU;EAE/B,MAAM,cAAc;GAClB,MAAM;GACN,MAAM;GACN;GACA,MAAM,iBAAiB;GACvB,MAAM,WAAW;GAClB,CAAC,KAAK,IAAI;AAGX,MAAI,iBAAiB,IAAI,YAAY,CAAE;AACvC,mBAAiB,IAAI,YAAY;AAEjC,UAAQ;GACN,GAAG;GACH,MAAM;GACN,GAAG,KAAK,KAAK;GACb,KAAK,YAAY;GACjB;GACD,CAAC;;CAGJ,MAAM,mBAAuD,UAAU;AAErE,UAAQ;GACN,GAAG;GACH,MAAM;GACN,GAAG,KAAK,KAAK;GACb,KAAK,YAAY;GACjB,QAAQ,MAAM,UAAU;GACzB,CAAC;AAEF,SAAO;;CAGT,MAAM,cACJ,eACA,UACA,YACGC,qCAAc,WAAW,eAAe,UAAU,QAAQ;;CAG/D,MAAM,wBAA8B;AAClC,MAAI,OAAO,WAAW,YAAa;EAEnC,MAAM,iBAAuB;AAC3B,OAAI,SAAS,oBAAoB,SAAU,OAAM,KAAK;;EAExD,MAAM,mBAAyB,MAAM,KAAK;EAC1C,MAAM,mBAAyB,cAAc,EAAE,QAAQ,gBAAgB,CAAC;AAExE,WAAS,iBAAiB,oBAAoB,SAAS;AACvD,SAAO,iBAAiB,YAAY,YAAY,EAAE,SAAS,MAAM,CAAC;AAClE,SAAO,iBAAiB,YAAY,WAAW;EAK/C,MAAM,UAAU,OAAO;EACvB,MAAM,eAAe,QAAQ;EAE7B,MAAM,mBAAmB,SAAS,YAEhC,GAAG,MACH;GACA,MAAM,SAAS,aAAa,MAAM,MAAM,KAAK;AAC7C,iBAAc,EAAE,QAAQ,gBAAgB,CAAC;AACzC,UAAO;;AAET,UAAQ,YAAY;AAEpB,0BAA8B;AAC5B,YAAS,oBAAoB,oBAAoB,SAAS;AAC1D,UAAO,oBAAoB,YAAY,YAAY,EAAE,SAAS,MAAM,CAAC;AACrE,UAAO,oBAAoB,YAAY,WAAW;AAGlD,OAAI,QAAQ,cAAc,iBACxB,SAAQ,YAAY;;;CAK1B,MAAM,cAAoB;AACxB,MAAI,QAAS;AACb,YAAU;AAEV,eAAa,YAAY,OAAO,OAAO,cAAc;AAErD,EAAC,YAAuC,SAAS;AAEjD,4BAAO,gBAAgB;;CAGzB,MAAM,aAAmB;AACvB,MAAI,CAAC,QAAS;AACd,YAAU;AAEV,MAAI,YAAY;AACd,iBAAc,WAAW;AACzB,gBAAa;;AAEf,qBAAmB;AACnB,oBAAkB;AAClB,QAAM,KAAK;;AAGb,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD"}

package/dist/cjs/core/abTesting.cjs

@@ -0,0 +1,44 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_utils_hash = require('../utils/hash.cjs');
+
+//#region src/core/abTesting.ts
+/**
+* Deterministically assigns a variant to a session for a given experiment.
+*
+* The assignment is a pure function of `sessionId` + `experimentKey`, so it is
+* stable for the whole session and requires **no** server round-trip before the
+* first render — avoiding layout shift / content flicker. Optional `weights`
+* bias the split (e.g. `[0.9, 0.1]` for a 90/10 rollout).
+*
+* @param sessionId - The current anonymous session id.
+* @param experimentKey - Unique key identifying the experiment.
+* @param variants - The candidate variant names (at least one).
+* @param weights - Optional relative weights, one per variant.
+* @returns The variant assigned to this session.
+*
+* @example
+* assignVariant('sid-1', 'homepage-hero', ['a', 'b']);          // stable 'a' | 'b'
+* assignVariant('sid-1', 'homepage-hero', ['a', 'b'], [9, 1]);  // ~90% 'a'
+*/
+const assignVariant = (sessionId, experimentKey, variants, weights) => {
+	if (variants.length === 0) throw new Error("assignVariant requires at least one variant");
+	if (variants.length === 1) return variants[0];
+	const bucket = require_utils_hash.hashString(`${sessionId}:${experimentKey}`) / 4294967296;
+	if (!weights || weights.length !== variants.length) {
+		const index = Math.floor(bucket * variants.length);
+		return variants[Math.min(index, variants.length - 1)];
+	}
+	const totalWeight = weights.reduce((sum, weight) => sum + weight, 0);
+	if (totalWeight <= 0) return variants[Math.floor(bucket * variants.length)];
+	let cumulative = 0;
+	const target = bucket * totalWeight;
+	for (let index = 0; index < variants.length; index++) {
+		cumulative += weights[index];
+		if (target < cumulative) return variants[index];
+	}
+	return variants[variants.length - 1];
+};
+
+//#endregion
+exports.assignVariant = assignVariant;
+//# sourceMappingURL=abTesting.cjs.map

package/dist/cjs/core/abTesting.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"abTesting.cjs","names":["hashString"],"sources":["../../../src/core/abTesting.ts"],"sourcesContent":["import { hashString } from '../utils/hash';\n\n/**\n * Deterministically assigns a variant to a session for a given experiment.\n *\n * The assignment is a pure function of `sessionId` + `experimentKey`, so it is\n * stable for the whole session and requires **no** server round-trip before the\n * first render — avoiding layout shift / content flicker. Optional `weights`\n * bias the split (e.g. `[0.9, 0.1]` for a 90/10 rollout).\n *\n * @param sessionId - The current anonymous session id.\n * @param experimentKey - Unique key identifying the experiment.\n * @param variants - The candidate variant names (at least one).\n * @param weights - Optional relative weights, one per variant.\n * @returns The variant assigned to this session.\n *\n * @example\n * assignVariant('sid-1', 'homepage-hero', ['a', 'b']);          // stable 'a' | 'b'\n * assignVariant('sid-1', 'homepage-hero', ['a', 'b'], [9, 1]);  // ~90% 'a'\n */\nexport const assignVariant = (\n  sessionId: string,\n  experimentKey: string,\n  variants: string[],\n  weights?: number[]\n): string => {\n  if (variants.length === 0) {\n    throw new Error('assignVariant requires at least one variant');\n  }\n  if (variants.length === 1) return variants[0]!;\n\n  // Uniform bucket in [0, 1) derived from the session + experiment.\n  const bucket = hashString(`${sessionId}:${experimentKey}`) / 0x100000000;\n\n  if (!weights || weights.length !== variants.length) {\n    const index = Math.floor(bucket * variants.length);\n    return variants[Math.min(index, variants.length - 1)];\n  }\n\n  const totalWeight = weights.reduce((sum, weight) => sum + weight, 0);\n  if (totalWeight <= 0) {\n    return variants[Math.floor(bucket * variants.length)];\n  }\n\n  let cumulative = 0;\n  const target = bucket * totalWeight;\n  for (let index = 0; index < variants.length; index++) {\n    cumulative += weights[index];\n    if (target < cumulative) return variants[index];\n  }\n\n  return variants[variants.length - 1];\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAoBA,MAAa,iBACX,WACA,eACA,UACA,YACW;AACX,KAAI,SAAS,WAAW,EACtB,OAAM,IAAI,MAAM,8CAA8C;AAEhE,KAAI,SAAS,WAAW,EAAG,QAAO,SAAS;CAG3C,MAAM,SAASA,8BAAW,GAAG,UAAU,GAAG,gBAAgB,GAAG;AAE7D,KAAI,CAAC,WAAW,QAAQ,WAAW,SAAS,QAAQ;EAClD,MAAM,QAAQ,KAAK,MAAM,SAAS,SAAS,OAAO;AAClD,SAAO,SAAS,KAAK,IAAI,OAAO,SAAS,SAAS,EAAE;;CAGtD,MAAM,cAAc,QAAQ,QAAQ,KAAK,WAAW,MAAM,QAAQ,EAAE;AACpE,KAAI,eAAe,EACjB,QAAO,SAAS,KAAK,MAAM,SAAS,SAAS,OAAO;CAGtD,IAAI,aAAa;CACjB,MAAM,SAAS,SAAS;AACxB,MAAK,IAAI,QAAQ,GAAG,QAAQ,SAAS,QAAQ,SAAS;AACpD,gBAAc,QAAQ;AACtB,MAAI,SAAS,WAAY,QAAO,SAAS;;AAG3C,QAAO,SAAS,SAAS,SAAS"}