@lovalingo/lovalingo 0.0.11

package/LICENSE

@@ -0,0 +1,148 @@
+LOVALINGO COMMERCIAL LICENSE
+
+Copyright (c) 2025 Mertens Advies. All rights reserved.
+
+NOTICE: This software and associated documentation files (the "Software") are the
+proprietary and confidential information of Mertens Advies.
+
+The Software is licensed, not sold. This license grants you the following rights:
+
+====================================================================================
+1. PERMITTED USES
+====================================================================================
+
+Subject to the terms of this license, you are granted a non-exclusive right to:
+
+   ✓ USE the Software as a translation library in your applications and websites
+
+   ✓ INTEGRATE the Software into client projects if you are a development agency,
+     freelancer, or service provider
+
+   ✓ DEPLOY compiled/bundled versions of the Software in client applications
+
+   ✓ CHARGE CLIENTS for integration, development, and consulting services related
+     to implementing the Software
+
+   ✓ PROVIDE END CLIENTS with usage rights to the Software as part of delivered
+     applications (end clients receive usage rights through the integrating party)
+
+   ✓ INSTALL the Software via package managers (npm, yarn, etc.) for development
+     and production use
+
+====================================================================================
+2. PROHIBITED USES
+====================================================================================
+
+You may NOT:
+
+   ✗ RESELL OR WHITE-LABEL the Software as your own standalone product or service
+
+   ✗ REDISTRIBUTE the source code or provide clients with access to modify the
+     Software's source code
+
+   ✗ REVERSE ENGINEER, decompile, disassemble, or attempt to derive the source
+     code except as compiled in standard application builds
+
+   ✗ BUILD COMPETING PRODUCTS using the Software's code, algorithms, or concepts
+
+   ✗ SUBLICENSE the Software to third parties as a standalone product
+
+   ✗ REMOVE OR ALTER any proprietary notices, labels, or copyright information
+
+   ✗ EXTRACT OR REUSE portions of the source code for purposes other than using
+     the Software as intended
+
+   ✗ USE THE SOFTWARE in any manner that violates applicable laws or regulations
+
+====================================================================================
+3. AGENCY & CLIENT DEPLOYMENT CLARIFICATION
+====================================================================================
+
+FOR AGENCIES/DEVELOPERS:
+   - You may integrate Lovalingo into unlimited client projects
+   - You may charge clients for your development and integration services
+   - Compiled code (node_modules, build artifacts) may be deployed to client servers
+   - You may not give clients the ability to modify the Software's source code
+
+FOR END CLIENTS:
+   - Receive usage rights through their agency/developer
+   - May run and operate applications containing the Software
+   - May not redistribute, modify, or extract the Software
+   - Each production deployment should use a valid Lovalingo API key
+
+====================================================================================
+4. API KEY REQUIREMENT
+====================================================================================
+
+Production use of the Software requires a valid API key obtained from Mertens Advies.
+Usage is subject to the terms of service associated with your API key subscription.
+
+====================================================================================
+5. INTELLECTUAL PROPERTY
+====================================================================================
+
+This Software is the exclusive intellectual property of Mertens Advies.
+All rights, title, and interest in and to the Software, including all
+intellectual property rights, patents, trademarks, copyrights, and trade secrets,
+remain the sole property of Mertens Advies.
+
+====================================================================================
+6. NOT OPEN SOURCE
+====================================================================================
+
+This Software is NOT open source. No part of this Software may be used, copied,
+modified, or distributed under any open source license terms. This is proprietary,
+commercial software.
+
+====================================================================================
+7. TERMINATION
+====================================================================================
+
+This license is effective until terminated. Your rights under this license will
+terminate automatically without notice if you fail to comply with any term of
+this agreement.
+
+Upon termination:
+   - You must cease all use of the Software
+   - Remove the Software from all systems and applications
+   - Destroy all copies in your possession
+
+====================================================================================
+8. DISCLAIMER OF WARRANTY
+====================================================================================
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE, AND NONINFRINGEMENT. MERTENS ADVIES DOES NOT WARRANT THAT THE
+SOFTWARE WILL BE ERROR-FREE OR UNINTERRUPTED.
+
+====================================================================================
+9. LIMITATION OF LIABILITY
+====================================================================================
+
+IN NO EVENT SHALL MERTENS ADVIES BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+IN ANY WAY OUT OF THE USE OF THE SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGE.
+
+====================================================================================
+10. GOVERNING LAW
+====================================================================================
+
+This license shall be governed by and construed in accordance with the laws of
+the jurisdiction in which Mertens Advies operates, without regard to its conflict
+of law provisions.
+
+====================================================================================
+
+For licensing inquiries, enterprise licensing, or questions about permitted use,
+please contact Mertens Advies.
+
+MERTENS ADVIES
+Lovalingo Translation Platform
+© 2025 All Rights Reserved
+
+Website: [Contact Mertens Advies for licensing information]

package/README.md

@@ -0,0 +1,376 @@
+# @aixyte/Lovalingo
+
+Seamless website translation for React and Next.js applications with **zero-flash rendering** and **automatic language routing**.
+
+## Installation
+
+```bash
+npm install @aixyte/Lovalingo react-router-dom
+```
+
+## Quick Start
+
+### Option 1: Path Mode (Recommended - Automatic Language URLs)
+
+**One-line setup** that automatically handles language routing like `/en/pricing`, `/fr/pricing`, `/de/pricing`:
+
+```tsx
+import { LangRouter, LovalingoProvider } from '@aixyte/Lovalingo';
+import { Routes, Route } from 'react-router-dom';
+import { useRef } from 'react';
+
+function App() {
+  const navigateRef = useRef();
+
+  return (
+    <LangRouter defaultLang="en" langs={['en', 'fr', 'de', 'es']} navigateRef={navigateRef}>
+      <LovalingoProvider
+        apiKey="aix_your_api_key"
+        defaultLocale="en"
+        locales={['en', 'fr', 'de', 'es']}
+        routing="path"
+        navigateRef={navigateRef}
+      >
+        <Routes>
+          {/* No language prefix needed! */}
+          <Route path="/" element={<Home />} />
+          <Route path="home" element={<Home />} />
+          <Route path="pricing" element={<Pricing />} />
+          <Route path="about" element={<About />} />
+        </Routes>
+      </LovalingoProvider>
+    </LangRouter>
+  );
+}
+```
+
+**Important:** Pass the same `navigateRef` to both `<LangRouter>` and `<LovalingoProvider>` for proper URL synchronization.
+
+URLs automatically work as:
+- `/en/`, `/en/home`, `/en/pricing`, `/en/about`
+- `/fr/`, `/fr/home`, `/fr/pricing`, `/fr/about`
+- `/de/`, `/de/home`, `/de/pricing`, `/de/about`
+
+### Option 2: Query Mode (Simple - Query Parameters)
+
+Use query parameters like `/pricing?t=fr`:
+
+```tsx
+import { LovalingoProvider } from '@aixyte/Lovalingo';
+import { BrowserRouter } from 'react-router-dom';
+
+function App() {
+  return (
+    <BrowserRouter>
+      <LovalingoProvider
+        apiKey="aix_your_api_key"
+        defaultLocale="en"
+        locales={['en', 'de', 'fr', 'es']}
+        routing="query"
+      >
+        <YourApp />
+      </LovalingoProvider>
+    </BrowserRouter>
+  );
+}
+```
+
+### Next.js
+
+```tsx
+// app/layout.tsx
+import { LovalingoProvider } from '@aixyte/Lovalingo';
+
+export default function RootLayout({ children }) {
+  return (
+    <html>
+      <body>
+        <LovalingoProvider
+          apiKey="aix_your_api_key"
+          defaultLocale="en"
+          locales={['en', 'de', 'fr', 'es']}
+        >
+          {children}
+        </LovalingoProvider>
+      </body>
+    </html>
+  );
+}
+```
+
+## Configuration
+
+```tsx
+<LovalingoProvider
+  apiKey="aix_xxx"                    // Required: Your Lovalingo API key
+  defaultLocale="en"                  // Required: Source language
+  locales={['en', 'de', 'fr']}        // Required: Supported languages
+  apiBase="https://..."               // Optional: Custom API endpoint
+  routing="query"                     // Optional: 'query' | 'path' (default: 'query')
+  switcherPosition="bottom-right"     // Optional: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left'
+  switcherOffsetY={20}                // Optional: Vertical offset in pixels
+  editMode={false}                    // Optional: Enable edit mode
+  editKey="KeyE"                      // Optional: Keyboard shortcut for edit mode
+  mode="dom"                          // Optional: 'dom' | 'context' (default: 'dom')
+  sitemap={true}                      // Optional: Auto-inject sitemap link (default: true) - NEW in v4.2.2
+>
+  {children}
+</LovalingoProvider>
+```
+
+### Routing Modes
+
+- **`query`** (default): Language in query parameter `/pricing?t=fr`
+  - Use with standard React Router setup
+  - No URL structure changes needed
+
+- **`path`**: Language in URL path `/fr/pricing`
+  - Use with `<LangRouter>` wrapper
+  - Automatic language routing
+  - SEO-optimized URLs
+  - See [PATH_EXAMPLES.md](./PATH_EXAMPLES.md) for detailed examples
+
+## Path Mode Helpers (v4.2+)
+
+### LangLink - Language-Aware Links
+
+```tsx
+import { LangLink } from '@aixyte/Lovalingo';
+
+function Navigation() {
+  return (
+    <nav>
+      {/* Automatically becomes /en/pricing or /fr/pricing */}
+      <LangLink to="pricing">Pricing</LangLink>
+      <LangLink to="about">About</LangLink>
+    </nav>
+  );
+}
+```
+
+### useLang - Get Current Language
+
+```tsx
+import { useLang } from '@aixyte/Lovalingo';
+
+function MyComponent() {
+  const lang = useLang(); // 'en', 'fr', 'de', etc.
+  return <div>Current language: {lang}</div>;
+}
+```
+
+### useLangNavigate - Programmatic Navigation
+
+```tsx
+import { useLangNavigate } from '@aixyte/Lovalingo';
+
+function MyComponent() {
+  const navigate = useLangNavigate();
+
+  const goToPricing = () => {
+    navigate('pricing'); // Goes to /en/pricing or /fr/pricing automatically
+  };
+
+  return <button onClick={goToPricing}>View Pricing</button>;
+}
+```
+
+## Core Hooks
+
+### useLovalingo
+
+Access locale state and switching:
+
+```tsx
+import { useLovalingo } from '@aixyte/Lovalingo';
+
+function MyComponent() {
+  const { locale, setLocale, isLoading, config } = useLovalingo();
+
+  return (
+    <button onClick={() => setLocale('de')}>
+      Switch to German
+    </button>
+  );
+}
+```
+
+### useLovalingoTranslate
+
+Manual translation control:
+
+```tsx
+import { useLovalingoTranslate } from '@aixyte/Lovalingo';
+
+function MyComponent() {
+  const { translateElement, translateDOM } = useLovalingoTranslate();
+  
+  const handleDynamicContent = () => {
+    // Translate specific element
+    const el = document.getElementById('dynamic-content');
+    if (el) translateElement(el);
+    
+    // Or translate entire DOM
+    translateDOM();
+  };
+  
+  return <button onClick={handleDynamicContent}>Load Content</button>;
+}
+```
+
+### useLovalingoEdit
+
+Edit mode for excluding elements:
+
+```tsx
+import { useLovalingoEdit } from '@aixyte/Lovalingo';
+
+function MyComponent() {
+  const { editMode, toggleEditMode, excludeElement } = useLovalingoEdit();
+  
+  return (
+    <button onClick={toggleEditMode}>
+      {editMode ? 'Exit Edit Mode' : 'Edit Exclusions'}
+    </button>
+  );
+}
+```
+
+## Features
+
+- ✅ Zero-flash translations (rendered before browser paint)
+- ✅ Automatic route change detection
+- ✅ MutationObserver for dynamic content
+- ✅ Customizable language switcher
+- ✅ TypeScript support
+- ✅ Works with React Router and Next.js
+- ✅ Edit mode for managing exclusions
+- ✅ Automatic translation miss detection
+- ✅ **Automatic multilingual sitemap generation (v4.2.2+)**
+
+## Automatic Sitemap (v4.2.2+)
+
+Your multilingual sitemap is **automatically generated** with zero configuration. Just install `@aixyte/Lovalingo` and it works!
+
+### Zero Configuration
+
+```tsx
+<LovalingoProvider
+  apiKey="aix_xxx"
+  defaultLocale="en"
+  locales={['en', 'de', 'fr', 'es']}
+>
+  <App />
+</LovalingoProvider>
+
+// ✅ That's it! Sitemap exists automatically at:
+// https://mvbumiwzjytmxswfjgzn.supabase.co/functions/v1/generate-sitemap/aix_xxx
+```
+
+### Features
+
+- ✅ **Auto-discovery**: Pages automatically added as visitors browse
+- ✅ **Multilingual**: All language variants included
+- ✅ **SEO-optimized**: Proper hreflang tags for all locales
+- ✅ **Always up-to-date**: No manual regeneration needed
+- ✅ **Cached**: 1-hour cache for performance
+- ✅ **Zero maintenance**: Completely automatic
+
+### How It Works
+
+1. **Page tracking**: LovalingoProvider tracks every visited page
+2. **Link injection**: `<link rel="sitemap">` tag automatically added to `<head>`
+3. **XML generation**: Edge function generates sitemap from discovered pages
+4. **Google discovers**: Search engines find sitemap via link tag
+
+### Disable Sitemap (Optional)
+
+```tsx
+<LovalingoProvider
+  apiKey="aix_xxx"
+  defaultLocale="en"
+  locales={['en', 'de', 'fr']}
+  sitemap={false}  // Disable automatic sitemap
+>
+  <App />
+</LovalingoProvider>
+```
+
+### Serve from Your Domain (Optional)
+
+#### Netlify
+
+```toml
+# netlify.toml
+[[redirects]]
+  from = "/sitemap.xml"
+  to = "https://mvbumiwzjytmxswfjgzn.supabase.co/functions/v1/generate-sitemap/YOUR_API_KEY"
+  status = 200
+```
+
+#### Vercel
+
+```json
+{
+  "rewrites": [{
+    "source": "/sitemap.xml",
+    "destination": "https://mvbumiwzjytmxswfjgzn.supabase.co/functions/v1/generate-sitemap/YOUR_API_KEY"
+  }]
+}
+```
+
+#### Next.js
+
+```tsx
+// app/sitemap.xml/route.ts
+export async function GET() {
+  const res = await fetch(
+    'https://mvbumiwzjytmxswfjgzn.supabase.co/functions/v1/generate-sitemap/YOUR_API_KEY'
+  );
+  return new Response(await res.text(), {
+    headers: { 'Content-Type': 'application/xml' }
+  });
+}
+```
+
+## How It Works
+
+1. **Wrap your app** with `<LovalingoProvider>`
+2. **Locale detection** from URL path or query params
+3. **Translations loaded** from Lovalingo API
+4. **DOM translated** before React paints
+5. **MutationObserver** catches dynamic content
+6. **Language switcher** appears for easy switching
+
+## License
+
+**COMMERCIAL LICENSE - NOT OPEN SOURCE**
+
+Copyright (c) 2025 Mertens Advies. All rights reserved.
+
+### For Agencies & Developers
+
+✅ **You MAY:**
+- Use Lovalingo in unlimited client projects
+- Charge clients for integration and development services
+- Deploy compiled code to client applications
+- Install via npm/yarn for development and production
+
+❌ **You MAY NOT:**
+- Resell or white-label Lovalingo as your own product
+- Redistribute source code or allow client modifications
+- Build competing translation products
+- Extract code for other purposes
+
+### For End Clients
+
+End clients receive usage rights through their agency/developer and may operate
+applications containing Lovalingo, but may not modify, redistribute, or extract the software.
+
+### License
+
+This software is licensed under the **Lovalingo Commercial License**.
+This is NOT open source software. All intellectual property rights remain the
+exclusive property of Mertens Advies.
+
+See LICENSE file for complete terms and conditions.

package/dist/components/AixsterProvider.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { LovalingoConfig } from '../types';
+interface LovalingoProviderProps extends LovalingoConfig {
+    children: React.ReactNode;
+    sitemap?: boolean;
+    navigateRef?: React.MutableRefObject<((path: string) => void) | undefined>;
+}
+export declare const LovalingoProvider: React.FC<LovalingoProviderProps>;
+export {};