react-achievements 3.9.1 → 4.0.0

package/README.md

@@ -1,10 +1,8 @@
 # React Achievements
 
-**Add gamification to your React app in 5 minutes** - Unlock achievements, celebrate milestones, delight users.
+**Add gamification to your React app in minutes** - Track progress, unlock achievements, show badges, and celebrate milestones.
 
-[![Demo video](https://raw.githubusercontent.com/dave-b-b/react-achievements/main/assets/achievements.png)](https://github.com/user-attachments/assets/a33fdae5-439b-4fc9-a388-ccb2f432a3a8)
-
-[📚 Documentation](https://dave-b-b.github.io/react-achievements/) | [🎮 Interactive Demo](https://dave-b-b.github.io/react-achievements/?path=/story/introduction--page) | [📦 npm Package](https://www.npmjs.com/package/react-achievements)
+[📚 Documentation](https://dave-b-b.github.io/react-achievements/) | [📦 npm Package](https://www.npmjs.com/package/react-achievements)
 
 [![npm version](https://img.shields.io/npm/v/react-achievements.svg)](https://www.npmjs.com/package/react-achievements) [![License](https://img.shields.io/badge/license-Dual%20(MIT%20%2B%20Commercial)-blue.svg)](./LICENSE) [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
 
@@ -14,170 +12,219 @@
 npm install react-achievements
 ```
 
-**Requirements:** React 17.0+, Node.js 16+
-
----
+**Requirements:** React 16.8+, Node.js 16+
 
-## Start Here (60 Seconds)
+## Start Here
 
 ```tsx
-import { AchievementProvider, useSimpleAchievements, BadgesButtonWithModal } from 'react-achievements';
+import {
+  AchievementProvider,
+  AchievementsWidget,
+  useSimpleAchievements,
+} from 'react-achievements';
 
 const achievements = {
   score: {
     100: { title: 'Century!', description: 'Score 100 points', icon: '🏆' },
-  }
+  },
 };
 
-function AchievementsUI() {
-  const { track, unlocked } = useSimpleAchievements();
+function Game() {
+  const { track } = useSimpleAchievements();
 
   return (
-    <div>
-      <button onClick={() => track('score', 100)}>Score 100</button>
-      <BadgesButtonWithModal unlockedAchievements={unlocked} />
-    </div>
+    <button onClick={() => track('score', 100)}>
+      Score 100
+    </button>
   );
 }
 
 export default function App() {
   return (
-    <AchievementProvider achievements={achievements} useBuiltInUI={true}>
-      <AchievementsUI />
+    <AchievementProvider achievements={achievements}>
+      <Game />
+      <AchievementsWidget />
     </AchievementProvider>
   );
 }
 ```
 
----
+`AchievementsWidget` reads from context, shows the unlocked count, and opens a modal with locked and unlocked achievements. Use `placement="inline"` to put it in a drawer, sidebar, or navigation area. For an exact visual match, pass `renderTrigger` and use your app's own drawer row, nav item, or profile menu button while the widget still controls the modal.
 
-## Usage
-
-React Achievements supports two tracking patterns:
+```tsx
+<AchievementsWidget
+  placement="inline"
+  renderTrigger={({ buttonProps, unlockedCount, totalCount }) => (
+    <button {...buttonProps} className="drawer-row">
+      Achievements
+      <span>{unlockedCount}/{totalCount}</span>
+    </button>
+  )}
+/>
+```
 
-### Pattern 1: Event-Based Tracking
+## Common Placements
 
-Track achievements using semantic events. Perfect for complex applications or multi-framework projects.
+Use the same context-aware UI in whichever surface already fits your app:
 
 ```tsx
-// achievementEngine.ts
-import { AchievementEngine } from 'react-achievements';
+import { useState } from 'react';
+import {
+  AchievementsList,
+  AchievementsModal,
+  AchievementsWidget,
+} from 'react-achievements';
 
-const achievements = {
-  score: {
-    100: { title: 'Century!', description: 'Score 100 points', icon: '🏆' },
-  }
-};
+// Floating launcher in a corner
+<AchievementsWidget position="bottom-right" />
 
-const eventMapping = {
-  'userScored': (data) => ({ score: data.points }),
-};
+// Inline nav, drawer, sidebar, or profile menu item
+<AchievementsWidget placement="inline" label="Badges" />
 
-export const engine = new AchievementEngine({
-  achievements,
-  eventMapping,
-  storage: 'local'
-});
-```
+// Existing button or drawer row that opens the built-in modal
+const [open, setOpen] = useState(false);
 
-```tsx
-// App.tsx
-import { AchievementProvider } from 'react-achievements';
-import { engine } from './achievementEngine';
+<button onClick={() => setOpen(true)}>View achievements</button>
+<AchievementsModal isOpen={open} onClose={() => setOpen(false)} />
 
-function App() {
-  return (
-    <AchievementProvider engine={engine} useBuiltInUI={true}>
-      <Game />
-    </AchievementProvider>
-  );
-}
+// Inline achievements page, panel, drawer, or settings section
+<AchievementsList showLocked />
 ```
 
-```tsx
-// Game.tsx
-import { useAchievementEngine } from 'react-achievements';
+Storybook includes examples for floating buttons, nav buttons, drawer rows, existing controls that open a modal, dashboard cards, profile menus, and inline lists.
 
-function Game() {
-  const engine = useAchievementEngine();
-  
-  return (
-    <button onClick={() => engine.emit('userScored', { points: 100 })}>
-      Score Points
-    </button>
-  );
-}
+Provider-level icons and UI options are shared across notifications, widgets, modals, and lists:
+
+```tsx
+<AchievementProvider
+  achievements={achievements}
+  icons={{ login: '🔑', streak: '🔥' }}
+  ui={{
+    theme: 'minimal',
+    NotificationComponent: MyNotification,
+    ModalComponent: MyAchievementsModal,
+    ConfettiComponent: MyConfetti,
+  }}
+>
+  <App />
+</AchievementProvider>
 ```
 
-➡️ **[Event-Based Tracking Guide](https://dave-b-b.github.io/react-achievements/docs/guides/event-based-tracking)**
+## Hooks
 
----
+```tsx
+const {
+  track,
+  increment,
+  trackMultiple,
+  unlockedIds,
+  unlockedAchievements,
+  allAchievements,
+  unlockedCount,
+  totalCount,
+} = useSimpleAchievements();
+```
 
-### Pattern 2: Direct Track Updates
+Deprecated aliases from v3, including `unlocked`, remain available until `4.2`.
 
-Update metrics directly in your React components. Perfect for simple applications or quick prototypes.
+## Event-Based Tracking
 
-```tsx
-// achievements.ts
-const achievements = {
-  score: {
-    100: { title: 'Century!', description: 'Score 100 points', icon: '🏆' },
-  }
-};
-```
+For larger apps, create an engine and emit semantic events:
 
 ```tsx
-// App.tsx
-import { AchievementProvider } from 'react-achievements';
+import {
+  AchievementEngine,
+  AchievementProvider,
+  AchievementsWidget,
+  useAchievementEngine,
+} from 'react-achievements';
+
+const engine = new AchievementEngine({
+  achievements,
+  eventMapping: {
+    userScored: (data) => ({ score: data.points }),
+  },
+  storage: 'local',
+});
 
-function App() {
+function Game() {
+  const engine = useAchievementEngine();
+  return <button onClick={() => engine.emit('userScored', { points: 100 })}>Score</button>;
+}
+
+export default function App() {
   return (
-    <AchievementProvider achievements={achievements} useBuiltInUI={true}>
+    <AchievementProvider engine={engine}>
       <Game />
+      <AchievementsWidget />
     </AchievementProvider>
   );
 }
 ```
 
+## Headless Usage
+
+Use the DOM-free entry point when building custom UI or preparing a React Native integration:
+
 ```tsx
-// Game.tsx
-import { useSimpleAchievements, BadgesButtonWithModal } from 'react-achievements';
+import {
+  AchievementProvider,
+  useAchievementState,
+  useSimpleAchievements,
+} from 'react-achievements/headless';
 
-function Game() {
-  const { track, unlocked } = useSimpleAchievements();
+function CustomAchievementsPanel() {
+  const { track } = useSimpleAchievements();
+  const { allAchievements, unlockedCount, totalCount } = useAchievementState();
+
+  return (
+    <section>
+      <button onClick={() => track('score', 100)}>Score 100</button>
+      <p>{unlockedCount} / {totalCount} unlocked</p>
+
+      {allAchievements.map((achievement) => (
+        <div key={achievement.achievementId}>
+          {achievement.isUnlocked ? 'Unlocked' : 'Locked'}: {achievement.achievementTitle}
+        </div>
+      ))}
+    </section>
+  );
+}
 
+export function App() {
   return (
-    <div>
-      <button onClick={() => track('score', 100)}>Score Points</button>
-      <BadgesButtonWithModal unlockedAchievements={unlocked} />
-    </div>
+    <AchievementProvider achievements={achievements}>
+      <CustomAchievementsPanel />
+    </AchievementProvider>
   );
 }
 ```
 
-➡️ **[Direct Updates Guide](https://dave-b-b.github.io/react-achievements/docs/guides/direct-updates)**
+React Native UI components are not included in `4.0`; use `achievements-engine` or the `/headless` React APIs with your own native UI.
 
----
+## Entry Points
 
-## Documentation
+- `react-achievements` - v4 web API with provider, hooks, built-in effects, widget, modal, and list components
+- `react-achievements/web` - explicit web entry point
+- `react-achievements/headless` - provider, hooks, engine, storage, and types without DOM UI
 
-📚 **[Full Documentation](https://dave-b-b.github.io/react-achievements/)** - Complete guides, API reference, and examples
+## Migrating From v3
 
----
+- Built-in UI is now the default; `useBuiltInUI` is a deprecated no-op.
+- `AchievementsWidget` replaces the legacy manual `BadgesButtonWithModal` setup.
+- `useSimpleAchievements()` now returns `unlockedIds`, `unlockedAchievements`, and `allAchievements`.
+- External UI peer dependencies are no longer required.
+- Deprecated v3 component names remain as compatibility wrappers until `4.2`.
 
 ## License
 
-React Achievements is **dual-licensed**:
-
-- **Free for Non-Commercial Use** (MIT License) - Personal projects, education, non-profits, open source
-- **Commercial License Required** - Businesses, SaaS, commercial apps, enterprise
-
-**[Get Commercial License →](https://github.com/sponsors/dave-b-b)** | **[License Details](./LICENSE)** | **[Commercial Terms](./COMMERCIAL-LICENSE.md)**
+React Achievements is dual-licensed:
 
----
+- **Free for Non-Commercial Use** (MIT License)
+- **Commercial License Required** for businesses, SaaS, commercial apps, and enterprise use
 
-**Built with ❤️ by [Dave B](https://github.com/dave-b-b)** | [📚 Documentation](https://dave-b-b.github.io/react-achievements/) | [⭐ Star on GitHub](https://github.com/dave-b-b/react-achievements)
+[Get Commercial License](https://github.com/sponsors/dave-b-b) | [License Details](./LICENSE) | [Commercial Terms](./COMMERCIAL-LICENSE.md)
 
 ## AI Agents
 
-If you're using AI coding agents, see `AGENTS.md` for a concise integration prompt, pitfalls, and the recommended API.
+If you're using AI coding agents, see `AGENTS.md` for the recommended v4 integration prompt.

package/dist/headless.cjs

@@ -0,0 +1,317 @@
+'use strict';
+
+var React = require('react');
+var achievementsEngine = require('achievements-engine');
+
+// Type guard to detect async storage
+function isAsyncStorage(storage) {
+    // Check if methods return Promises
+    const testResult = storage.getMetrics();
+    return testResult && typeof testResult.then === 'function';
+}
+var StorageType;
+(function (StorageType) {
+    StorageType["Local"] = "local";
+    StorageType["Memory"] = "memory";
+    StorageType["IndexedDB"] = "indexeddb";
+    StorageType["RestAPI"] = "restapi"; // Asynchronous REST API storage
+})(StorageType || (StorageType = {}));
+
+const warnedMessages = new Set();
+function warnDeprecation(message) {
+    var _a, _b;
+    const isProduction = typeof globalThis !== 'undefined' &&
+        ((_b = (_a = globalThis.process) === null || _a === void 0 ? void 0 : _a.env) === null || _b === void 0 ? void 0 : _b.NODE_ENV) === 'production';
+    if (isProduction || warnedMessages.has(message)) {
+        return;
+    }
+    warnedMessages.add(message);
+    console.warn(`[react-achievements] ${message}`);
+}
+
+const AchievementContext = React.createContext(undefined);
+const getAllAchievementRecord = (engine) => {
+    return Object.fromEntries(engine.getAllAchievements().map((achievement) => [
+        achievement.achievementId,
+        achievement,
+    ]));
+};
+const AchievementProvider = ({ achievements: achievementsConfig, storage = 'local', children, onError, useBuiltInUI, restApiConfig, engine: externalEngine, eventMapping, icons = {}, }) => {
+    if (useBuiltInUI !== undefined) {
+        warnDeprecation('`useBuiltInUI` is deprecated and is now a no-op because built-in UI is the default. It will be removed in 4.2.');
+    }
+    if (achievementsConfig && externalEngine) {
+        throw new Error('Cannot provide both "achievements" and "engine" props to AchievementProvider.\n\n' +
+            'Choose one pattern:\n' +
+            '1. Direct metric tracking: <AchievementProvider achievements={config}>\n' +
+            '2. Event-based tracking: <AchievementProvider engine={myEngine}>');
+    }
+    const isProviderCreatedEngine = Boolean(achievementsConfig);
+    const [engine] = React.useState(() => {
+        if (externalEngine) {
+            return externalEngine;
+        }
+        if (!achievementsConfig) {
+            throw new Error('AchievementProvider requires either "achievements" or "engine" prop.\n\n' +
+                '1. Direct metric tracking: <AchievementProvider achievements={config}>\n' +
+                '2. Event-based tracking: <AchievementProvider engine={myEngine}>');
+        }
+        return new achievementsEngine.AchievementEngine({
+            achievements: achievementsConfig,
+            storage: storage,
+            restApiConfig,
+            onError: onError,
+            eventMapping,
+        });
+    });
+    const [achievementState, setAchievementState] = React.useState(() => ({
+        unlocked: [...engine.getUnlocked()],
+        all: getAllAchievementRecord(engine),
+    }));
+    const syncAchievementState = React.useCallback(() => {
+        setAchievementState({
+            unlocked: [...engine.getUnlocked()],
+            all: getAllAchievementRecord(engine),
+        });
+    }, [engine]);
+    React.useEffect(() => {
+        return () => {
+            if (!externalEngine) {
+                engine.destroy();
+            }
+        };
+    }, [engine, externalEngine]);
+    React.useEffect(() => {
+        const unsubscribeUnlocked = engine.on('achievement:unlocked', syncAchievementState);
+        const unsubscribeStateChanged = engine.on('state:changed', syncAchievementState);
+        return () => {
+            unsubscribeUnlocked();
+            unsubscribeStateChanged();
+        };
+    }, [engine, syncAchievementState]);
+    const update = (newMetrics) => {
+        engine.update(newMetrics);
+    };
+    const reset = () => {
+        engine.reset();
+        syncAchievementState();
+    };
+    const getState = () => {
+        const metrics = engine.getMetrics();
+        const unlocked = engine.getUnlocked();
+        const metricsInArrayFormat = {};
+        Object.entries(metrics).forEach(([key, value]) => {
+            metricsInArrayFormat[key] = Array.isArray(value) ? value : [value];
+        });
+        return {
+            metrics: metricsInArrayFormat,
+            unlocked: [...unlocked],
+        };
+    };
+    const exportData = () => {
+        return engine.export();
+    };
+    const importData = (jsonString, options) => {
+        const result = engine.import(jsonString, options);
+        syncAchievementState();
+        return result;
+    };
+    const getAllAchievements = () => {
+        return engine.getAllAchievements();
+    };
+    return (React.createElement(AchievementContext.Provider, { value: {
+            update,
+            achievements: achievementState,
+            reset,
+            getState,
+            exportData,
+            importData,
+            getAllAchievements,
+            engine,
+            icons,
+            _isLegacyPattern: isProviderCreatedEngine,
+        } }, children));
+};
+
+const useAchievements = () => {
+    const context = React.useContext(AchievementContext);
+    if (!context) {
+        throw new Error('useAchievements must be used within an AchievementProvider');
+    }
+    return context;
+};
+
+const useAchievementState = () => {
+    const { achievements, getAllAchievements, getState } = useAchievements();
+    const allAchievements = getAllAchievements();
+    const unlockedIds = achievements.unlocked;
+    const unlockedAchievementSet = new Set(unlockedIds);
+    const unlockedAchievements = allAchievements.filter((achievement) => unlockedAchievementSet.has(achievement.achievementId));
+    return {
+        unlockedIds,
+        unlockedAchievements,
+        allAchievements,
+        unlockedCount: unlockedIds.length,
+        totalCount: allAchievements.length,
+        metrics: getState().metrics,
+    };
+};
+
+/**
+ * A simplified hook for achievement tracking.
+ * Provides the v4 happy path for direct metric updates plus explicit state names.
+ */
+const useSimpleAchievements = () => {
+    const { update, reset, getState, exportData, importData } = useAchievements();
+    const achievementState = useAchievementState();
+    const track = (metric, value) => update({ [metric]: value });
+    const increment = (metric, amount = 1) => {
+        const currentState = getState();
+        const currentMetricArray = currentState.metrics[metric] || [0];
+        const currentValue = Array.isArray(currentMetricArray)
+            ? currentMetricArray[0]
+            : currentMetricArray;
+        const newValue = (typeof currentValue === 'number' ? currentValue : 0) + amount;
+        update({ [metric]: newValue });
+    };
+    const trackMultiple = (metrics) => update(metrics);
+    return {
+        track,
+        increment,
+        trackMultiple,
+        unlockedIds: achievementState.unlockedIds,
+        unlockedAchievements: achievementState.unlockedAchievements,
+        allAchievements: achievementState.allAchievements,
+        unlockedCount: achievementState.unlockedCount,
+        totalCount: achievementState.totalCount,
+        metrics: achievementState.metrics,
+        reset,
+        getState,
+        exportData,
+        importData,
+        getAllAchievements: () => achievementState.allAchievements,
+        /**
+         * @deprecated Use `unlockedIds` instead. This alias will be removed in 4.2.
+         */
+        unlocked: achievementState.unlockedIds,
+        /**
+         * @deprecated Use `allAchievements` instead. This alias will be removed in 4.2.
+         */
+        all: achievementState.allAchievements,
+    };
+};
+
+/**
+ * Access the active AchievementEngine instance.
+ *
+ * In v4 this works with both provider-created engines (`achievements` prop) and
+ * injected engines (`engine` prop).
+ */
+const useAchievementEngine = () => {
+    const context = React.useContext(AchievementContext);
+    if (!context) {
+        throw new Error('useAchievementEngine must be used within an AchievementProvider.\n\n' +
+            'Wrap your component tree:\n' +
+            '<AchievementProvider achievements={achievements}>\n' +
+            '  <YourComponent />\n' +
+            '</AchievementProvider>');
+    }
+    return context.engine;
+};
+
+Object.defineProperty(exports, 'AchievementBuilder', {
+    enumerable: true,
+    get: function () { return achievementsEngine.AchievementBuilder; }
+});
+Object.defineProperty(exports, 'AchievementEngine', {
+    enumerable: true,
+    get: function () { return achievementsEngine.AchievementEngine; }
+});
+Object.defineProperty(exports, 'AchievementError', {
+    enumerable: true,
+    get: function () { return achievementsEngine.AchievementError; }
+});
+Object.defineProperty(exports, 'AsyncStorageAdapter', {
+    enumerable: true,
+    get: function () { return achievementsEngine.AsyncStorageAdapter; }
+});
+Object.defineProperty(exports, 'ConfigurationError', {
+    enumerable: true,
+    get: function () { return achievementsEngine.ConfigurationError; }
+});
+Object.defineProperty(exports, 'ImportValidationError', {
+    enumerable: true,
+    get: function () { return achievementsEngine.ImportValidationError; }
+});
+Object.defineProperty(exports, 'IndexedDBStorage', {
+    enumerable: true,
+    get: function () { return achievementsEngine.IndexedDBStorage; }
+});
+Object.defineProperty(exports, 'LocalStorage', {
+    enumerable: true,
+    get: function () { return achievementsEngine.LocalStorage; }
+});
+Object.defineProperty(exports, 'MemoryStorage', {
+    enumerable: true,
+    get: function () { return achievementsEngine.MemoryStorage; }
+});
+Object.defineProperty(exports, 'OfflineQueueStorage', {
+    enumerable: true,
+    get: function () { return achievementsEngine.OfflineQueueStorage; }
+});
+Object.defineProperty(exports, 'RestApiStorage', {
+    enumerable: true,
+    get: function () { return achievementsEngine.RestApiStorage; }
+});
+Object.defineProperty(exports, 'StorageError', {
+    enumerable: true,
+    get: function () { return achievementsEngine.StorageError; }
+});
+Object.defineProperty(exports, 'StorageQuotaError', {
+    enumerable: true,
+    get: function () { return achievementsEngine.StorageQuotaError; }
+});
+Object.defineProperty(exports, 'StorageType', {
+    enumerable: true,
+    get: function () { return achievementsEngine.StorageType; }
+});
+Object.defineProperty(exports, 'SyncError', {
+    enumerable: true,
+    get: function () { return achievementsEngine.SyncError; }
+});
+Object.defineProperty(exports, 'createConfigHash', {
+    enumerable: true,
+    get: function () { return achievementsEngine.createConfigHash; }
+});
+Object.defineProperty(exports, 'exportAchievementData', {
+    enumerable: true,
+    get: function () { return achievementsEngine.exportAchievementData; }
+});
+Object.defineProperty(exports, 'importAchievementData', {
+    enumerable: true,
+    get: function () { return achievementsEngine.importAchievementData; }
+});
+Object.defineProperty(exports, 'isAchievementError', {
+    enumerable: true,
+    get: function () { return achievementsEngine.isAchievementError; }
+});
+Object.defineProperty(exports, 'isRecoverableError', {
+    enumerable: true,
+    get: function () { return achievementsEngine.isRecoverableError; }
+});
+Object.defineProperty(exports, 'isSimpleConfig', {
+    enumerable: true,
+    get: function () { return achievementsEngine.isSimpleConfig; }
+});
+Object.defineProperty(exports, 'normalizeAchievements', {
+    enumerable: true,
+    get: function () { return achievementsEngine.normalizeAchievements; }
+});
+exports.AchievementContext = AchievementContext;
+exports.AchievementProvider = AchievementProvider;
+exports.isAsyncStorage = isAsyncStorage;
+exports.useAchievementEngine = useAchievementEngine;
+exports.useAchievementState = useAchievementState;
+exports.useAchievements = useAchievements;
+exports.useSimpleAchievements = useSimpleAchievements;
+//# sourceMappingURL=headless.cjs.map

package/dist/headless.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless.cjs","sources":["../src/core/types.ts","../src/core/utils/deprecation.ts","../src/providers/AchievementProvider.tsx","../src/hooks/useAchievements.ts","../src/hooks/useAchievementState.ts","../src/hooks/useSimpleAchievements.ts","../src/hooks/useAchievementEngine.ts"],"sourcesContent":[null,null,null,null,null,null,null],"names":["createContext","useState","AchievementEngine","useCallback","useEffect","useContext"],"mappings":";;;;;AAgFA;AACM,SAAU,cAAc,CAAC,OAA8B,EAAA;;AAEzD,IAAA,MAAM,UAAU,GAAI,OAAe,CAAC,UAAU,EAAE,CAAC;IACjD,OAAO,UAAU,IAAI,OAAO,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC;AAC/D,CAAC;AA6DD,IAAY,WAKX,CAAA;AALD,CAAA,UAAY,WAAW,EAAA;AACnB,IAAA,WAAA,CAAA,OAAA,CAAA,GAAA,OAAe,CAAA;AACf,IAAA,WAAA,CAAA,QAAA,CAAA,GAAA,QAAiB,CAAA;AACjB,IAAA,WAAA,CAAA,WAAA,CAAA,GAAA,WAAuB,CAAA;IACvB,WAAmB,CAAA,SAAA,CAAA,GAAA,SAAA,CAAA;AACvB,CAAC,EALW,WAAW,KAAX,WAAW,GAKtB,EAAA,CAAA,CAAA;;ACvJD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;AAEnC,SAAU,eAAe,CAAC,OAAe,EAAA;;AAC7C,IAAA,MAAM,YAAY,GAChB,OAAO,UAAU,KAAK,WAAW;QACjC,CAAA,CAAA,EAAA,GAAA,CAAC,EAAA,GAAA,UAAkB,CAAC,OAAO,MAAE,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,KAAA,CAAA,GAAA,EAAA,CAAA,GAAG,MAAE,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,KAAA,CAAA,GAAA,EAAA,CAAA,QAAQ,MAAK,YAAY,CAAC;IAE9D,IAAI,YAAY,IAAI,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;QAC/C,OAAO;KACR;AAED,IAAA,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC5B,IAAA,OAAO,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAA,CAAE,CAAC,CAAC;AAClD;;MCyBa,kBAAkB,GAAGA,mBAAa,CAAqC,SAAS,EAAE;AAkB/F,MAAM,uBAAuB,GAAG,CAC9B,MAAyB,KACgB;AACzC,IAAA,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,kBAAkB,EAAE,CAAC,GAAG,CAAC,CAAC,WAAW,KAAK;AAC/C,QAAA,WAAW,CAAC,aAAa;QACzB,WAAW;AACZ,KAAA,CAAC,CACH,CAAC;AACJ,CAAC,CAAC;AAEK,MAAM,mBAAmB,GAAuC,CAAC,EACtE,YAAY,EAAE,kBAAkB,EAChC,OAAO,GAAG,OAAO,EACjB,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,aAAa,EACb,MAAM,EAAE,cAAc,EACtB,YAAY,EACZ,KAAK,GAAG,EAAE,GACX,KAAI;AACH,IAAA,IAAI,YAAY,KAAK,SAAS,EAAE;QAC9B,eAAe,CACb,gHAAgH,CACjH,CAAC;KACH;AAED,IAAA,IAAI,kBAAkB,IAAI,cAAc,EAAE;QACxC,MAAM,IAAI,KAAK,CACb,mFAAmF;YACjF,uBAAuB;YACvB,0EAA0E;AAC1E,YAAA,kEAAkE,CACrE,CAAC;KACH;AAED,IAAA,MAAM,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAE5D,IAAA,MAAM,CAAC,MAAM,CAAC,GAAGC,cAAQ,CAAoB,MAAK;QAChD,IAAI,cAAc,EAAE;AAClB,YAAA,OAAO,cAAc,CAAC;SACvB;QAED,IAAI,CAAC,kBAAkB,EAAE;YACvB,MAAM,IAAI,KAAK,CACb,0EAA0E;gBACxE,0EAA0E;AAC1E,gBAAA,kEAAkE,CACrE,CAAC;SACH;QAED,OAAO,IAAIC,oCAAiB,CAAC;AAC3B,YAAA,YAAY,EAAE,kBAAkB;AAChC,YAAA,OAAO,EAAE,OAAc;YACvB,aAAa;AACb,YAAA,OAAO,EAAE,OAA+C;YACxD,YAAY;AACb,SAAA,CAAC,CAAC;AACL,KAAC,CAAC,CAAC;IAEH,MAAM,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,GAAGD,cAAQ,CAGrD,OAAO;AACR,QAAA,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;AACnC,QAAA,GAAG,EAAE,uBAAuB,CAAC,MAAM,CAAC;AACrC,KAAA,CAAC,CAAC,CAAC;AAEJ,IAAA,MAAM,oBAAoB,GAAGE,iBAAW,CAAC,MAAK;AAC5C,QAAA,mBAAmB,CAAC;AAClB,YAAA,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;AACnC,YAAA,GAAG,EAAE,uBAAuB,CAAC,MAAM,CAAC;AACrC,SAAA,CAAC,CAAC;AACL,KAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEbC,eAAS,CAAC,MAAK;AACb,QAAA,OAAO,MAAK;YACV,IAAI,CAAC,cAAc,EAAE;gBACnB,MAAM,CAAC,OAAO,EAAE,CAAC;aAClB;AACH,SAAC,CAAC;AACJ,KAAC,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IAE7BA,eAAS,CAAC,MAAK;QACb,MAAM,mBAAmB,GAAG,MAAM,CAAC,EAAE,CAAC,sBAAsB,EAAE,oBAAoB,CAAC,CAAC;QACpF,MAAM,uBAAuB,GAAG,MAAM,CAAC,EAAE,CAAC,eAAe,EAAE,oBAAoB,CAAC,CAAC;AAEjF,QAAA,OAAO,MAAK;AACV,YAAA,mBAAmB,EAAE,CAAC;AACtB,YAAA,uBAAuB,EAAE,CAAC;AAC5B,SAAC,CAAC;AACJ,KAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;AAEnC,IAAA,MAAM,MAAM,GAAG,CAAC,UAA+B,KAAI;AACjD,QAAA,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AAC5B,KAAC,CAAC;IAEF,MAAM,KAAK,GAAG,MAAK;QACjB,MAAM,CAAC,KAAK,EAAE,CAAC;AACf,QAAA,oBAAoB,EAAE,CAAC;AACzB,KAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAK;AACpB,QAAA,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;AACpC,QAAA,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACtC,MAAM,oBAAoB,GAAwB,EAAE,CAAC;AAErD,QAAA,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAI;YAC/C,oBAAoB,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;AACrE,SAAC,CAAC,CAAC;QAEH,OAAO;AACL,YAAA,OAAO,EAAE,oBAAoB;AAC7B,YAAA,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC;SACxB,CAAC;AACJ,KAAC,CAAC;IAEF,MAAM,UAAU,GAAG,MAAa;AAC9B,QAAA,OAAO,MAAM,CAAC,MAAM,EAAE,CAAC;AACzB,KAAC,CAAC;AAEF,IAAA,MAAM,UAAU,GAAG,CAAC,UAAkB,EAAE,OAAuB,KAAkB;QAC/E,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAClD,QAAA,oBAAoB,EAAE,CAAC;AACvB,QAAA,OAAO,MAAM,CAAC;AAChB,KAAC,CAAC;IAEF,MAAM,kBAAkB,GAAG,MAA8B;AACvD,QAAA,OAAO,MAAM,CAAC,kBAAkB,EAAE,CAAC;AACrC,KAAC,CAAC;AAEF,IAAA,QACE,KAAC,CAAA,aAAA,CAAA,kBAAkB,CAAC,QAAQ,EAAA,EAC1B,KAAK,EAAE;YACL,MAAM;AACN,YAAA,YAAY,EAAE,gBAAgB;YAC9B,KAAK;YACL,QAAQ;YACR,UAAU;YACV,UAAU;YACV,kBAAkB;YAClB,MAAM;YACN,KAAK;AACL,YAAA,gBAAgB,EAAE,uBAAuB;SAC1C,EAEA,EAAA,QAAQ,CACmB,EAC9B;AACJ;;AC3MO,MAAM,eAAe,GAAG,MAAK;AAClC,IAAA,MAAM,OAAO,GAAGC,gBAAU,CAAC,kBAAkB,CAAC,CAAC;IAE/C,IAAI,CAAC,OAAO,EAAE;AACZ,QAAA,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;KAC/E;AAED,IAAA,OAAO,OAAO,CAAC;AACjB;;ACTO,MAAM,mBAAmB,GAAG,MAAK;IACtC,MAAM,EAAE,YAAY,EAAE,kBAAkB,EAAE,QAAQ,EAAE,GAAG,eAAe,EAAE,CAAC;AACzE,IAAA,MAAM,eAAe,GAAG,kBAAkB,EAAE,CAAC;AAC7C,IAAA,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,CAAC;AAC1C,IAAA,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,oBAAoB,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,WAAW,KAC9D,sBAAsB,CAAC,GAAG,CAAC,WAAW,CAAC,aAAa,CAAC,CACtD,CAAC;IAEF,OAAO;QACL,WAAW;QACX,oBAAoB;QACpB,eAAe;QACf,aAAa,EAAE,WAAW,CAAC,MAAM;QACjC,UAAU,EAAE,eAAe,CAAC,MAAM;AAClC,QAAA,OAAO,EAAE,QAAQ,EAAE,CAAC,OAAO;KAC5B,CAAC;AACJ;;AChBA;;;AAGG;AACI,MAAM,qBAAqB,GAAG,MAAK;AACxC,IAAA,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,eAAe,EAAE,CAAC;AAC9E,IAAA,MAAM,gBAAgB,GAAG,mBAAmB,EAAE,CAAC;AAE/C,IAAA,MAAM,KAAK,GAAG,CAAC,MAAc,EAAE,KAAU,KAAK,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC,CAAC;IAE1E,MAAM,SAAS,GAAG,CAAC,MAAc,EAAE,MAAiB,GAAA,CAAC,KAAI;AACvD,QAAA,MAAM,YAAY,GAAG,QAAQ,EAAE,CAAC;AAChC,QAAA,MAAM,kBAAkB,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC/D,QAAA,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC;AACpD,cAAE,kBAAkB,CAAC,CAAC,CAAC;cACrB,kBAAkB,CAAC;AACvB,QAAA,MAAM,QAAQ,GAAG,CAAC,OAAO,YAAY,KAAK,QAAQ,GAAG,YAAY,GAAG,CAAC,IAAI,MAAM,CAAC;QAChF,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC,CAAC;AACjC,KAAC,CAAC;IAEF,MAAM,aAAa,GAAG,CAAC,OAA4B,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC;IAExE,OAAO;QACL,KAAK;QACL,SAAS;QACT,aAAa;QACb,WAAW,EAAE,gBAAgB,CAAC,WAAW;QACzC,oBAAoB,EAAE,gBAAgB,CAAC,oBAAoB;QAC3D,eAAe,EAAE,gBAAgB,CAAC,eAAe;QACjD,aAAa,EAAE,gBAAgB,CAAC,aAAa;QAC7C,UAAU,EAAE,gBAAgB,CAAC,UAAU;QACvC,OAAO,EAAE,gBAAgB,CAAC,OAAO;QACjC,KAAK;QACL,QAAQ;QACR,UAAU;QACV,UAAU;AACV,QAAA,kBAAkB,EAAE,MAAM,gBAAgB,CAAC,eAAe;AAC1D;;AAEG;QACH,QAAQ,EAAE,gBAAgB,CAAC,WAAW;AACtC;;AAEG;QACH,GAAG,EAAE,gBAAgB,CAAC,eAAe;KACtC,CAAC;AACJ;;AC7CA;;;;;AAKG;AACI,MAAM,oBAAoB,GAAG,MAAwB;AAC1D,IAAA,MAAM,OAAO,GAAGA,gBAAU,CAAC,kBAAkB,CAAC,CAAC;IAE/C,IAAI,CAAC,OAAO,EAAE;QACZ,MAAM,IAAI,KAAK,CACb,sEAAsE;YACpE,6BAA6B;YAC7B,qDAAqD;YACrD,uBAAuB;AACvB,YAAA,wBAAwB,CAC3B,CAAC;KACH;IAED,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}