The recommended installation method is using Composer.
In your project root just run:
composer req bavix/laravel-wallet-swapWe need a simple model with the ability to work multi-wallets.
use Bavix\\Wallet\\Interfaces\\Wallet;
-use Bavix\\Wallet\\Traits\\HasWallets;
-use Bavix\\Wallet\\Traits\\HasWallet;
-
-class User extends Model implements Wallet
-{
- use HasWallet, HasWallets;
-}Let's create wallets with currency:
$usd = $user->createWallet([
- 'name' => 'My Dollars',
- 'slug' => 'usd',
- 'meta' => ['currency' => 'USD'],
-]);
-
-$rub = $user->createWallet([
- 'name' => 'My Ruble',
- 'slug' => 'rub',
- 'meta' => ['currency' => 'RUB'],
-]);Find wallets and exchange from one to another.
$rub = $user->getWallet('rub');
-$usd = $user->getWallet('usd');
-
-$usd->balance; // 200
-$rub->balance; // 0
-
-$usd->exchange($rub, 10);
-$usd->balance; // 190
-$rub->balance; // 622It's simple!
`,14),t=[h];function p(e,k,r,d,E,g){return a(),i("div",null,t)}const c=s(n,[["render",p]]);export{F as __pageData,c as default}; diff --git a/docs/.vitepress/dist/assets/guide_additions_swap.md.CkbQXJmg.lean.js b/docs/.vitepress/dist/assets/guide_additions_swap.md.CkbQXJmg.lean.js deleted file mode 100644 index 7ad8a722f..000000000 --- a/docs/.vitepress/dist/assets/guide_additions_swap.md.CkbQXJmg.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as l}from"./chunks/framework.OdeEVNy0.js";const F=JSON.parse('{"title":"Laravel Wallet Swap","description":"","frontmatter":{},"headers":[],"relativePath":"guide/additions/swap.md","filePath":"guide/additions/swap.md"}'),n={name:"guide/additions/swap.md"},h=l("",14),t=[h];function p(e,k,r,d,E,g){return a(),i("div",null,t)}const c=s(n,[["render",p]]);export{F as __pageData,c as default}; diff --git a/docs/.vitepress/dist/assets/guide_additions_uuid.md.BXhPbgHs.js b/docs/.vitepress/dist/assets/guide_additions_uuid.md.BXhPbgHs.js deleted file mode 100644 index eac4abb15..000000000 --- a/docs/.vitepress/dist/assets/guide_additions_uuid.md.BXhPbgHs.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as e,c as a,o as t,a3 as i}from"./chunks/framework.OdeEVNy0.js";const g=JSON.parse('{"title":"Laravel Wallet UUID","description":"","frontmatter":{},"headers":[],"relativePath":"guide/additions/uuid.md","filePath":"guide/additions/uuid.md"}'),s={name:"guide/additions/uuid.md"},o=i('Using uuid greatly reduces package performance. We recommend using int.
Often there is a need to store an identifier in uuid/ulid. Since version 9.0 laravel-wallet supports string identifiers, you only need to perform the migration.
To simplify the process, you can use a ready-made package.
Attention! It will not work to use UUID instead of ID in wallet models; there is a special uuid field for this.
The recommended installation method is using Composer.
In your project root just run:
composer req bavix/laravel-wallet-uuidNow you need to migrate!
After migration, you can use the UUID in your models.
You can find implementation examples in the package tests: https://github.com/bavix/laravel-wallet-uuid/tree/master/tests
It's simple!
',13),r=[o];function l(n,p,d,u,c,h){return t(),a("div",null,r)}const _=e(s,[["render",l]]);export{g as __pageData,_ as default}; diff --git a/docs/.vitepress/dist/assets/guide_additions_uuid.md.BXhPbgHs.lean.js b/docs/.vitepress/dist/assets/guide_additions_uuid.md.BXhPbgHs.lean.js deleted file mode 100644 index cb633c738..000000000 --- a/docs/.vitepress/dist/assets/guide_additions_uuid.md.BXhPbgHs.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as e,c as a,o as t,a3 as i}from"./chunks/framework.OdeEVNy0.js";const g=JSON.parse('{"title":"Laravel Wallet UUID","description":"","frontmatter":{},"headers":[],"relativePath":"guide/additions/uuid.md","filePath":"guide/additions/uuid.md"}'),s={name:"guide/additions/uuid.md"},o=i("",13),r=[o];function l(n,p,d,u,c,h){return t(),a("div",null,r)}const _=e(s,[["render",l]]);export{g as __pageData,_ as default}; diff --git a/docs/.vitepress/dist/assets/guide_cqrs_create-wallet.md.CKR5iFPX.js b/docs/.vitepress/dist/assets/guide_cqrs_create-wallet.md.CKR5iFPX.js deleted file mode 100644 index c1ddb190c..000000000 --- a/docs/.vitepress/dist/assets/guide_cqrs_create-wallet.md.CKR5iFPX.js +++ /dev/null @@ -1,29 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const c=JSON.parse('{"title":"Asynchronous wallet creation","description":"","frontmatter":{},"headers":[],"relativePath":"guide/cqrs/create-wallet.md","filePath":"guide/cqrs/create-wallet.md"}'),e={name:"guide/cqrs/create-wallet.md"},t=n(`The idea is based on the division into teams for creating wallets, transactions, etc. The creation of a wallet can be accelerated if the client "generates a wallet himself".
Add the HasWallet, HasWallets trait's and Wallet interface to model.
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Traits\\HasWallets;
-use Bavix\\Wallet\\Interfaces\\Wallet;
-
-class User extends Model implements Wallet
-{
- use HasWallet, HasWallets;
-}use Illuminate\\Http\\Request;
-use Illuminate\\Http\\Response;
-use Illuminate\\Support\\Facades\\Response as ResponseFactory;
-...
-
-public function __invoke(User $user, Request $request): Response
-{
- $name = $request->get('wallet_name');
- $uuid = $request->get('wallet_uuid');
-
- $message = new CreateWalletCommandMessage($user, $name, $uuid);
- dispatch($message);
-
- return ResponseFactory::json([], 202);
-}public function __invoke(CreateWalletCommandMessage $message): void
-{
- $user = $message->getUser();
- $user->createWallet([
- 'uuid' => $message->getWalletUuid(),
- 'name' => $message->getWalletName(),
- ]);
-}You receive requests to create a wallet on the backend, and you create them asynchronously. UUID4 is generated on the client side and the client already knows it. You will not be able to create two wallets with one uuid, because the column in the database is unique.
The user no longer needs to wait for the creation of a wallet, it is enough to know the uuid. You get the most stable application.
It's simple!
`,13),l=[t];function h(p,k,r,d,E,g){return a(),i("div",null,l)}const y=s(e,[["render",h]]);export{c as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_cqrs_create-wallet.md.CKR5iFPX.lean.js b/docs/.vitepress/dist/assets/guide_cqrs_create-wallet.md.CKR5iFPX.lean.js deleted file mode 100644 index d6f865d89..000000000 --- a/docs/.vitepress/dist/assets/guide_cqrs_create-wallet.md.CKR5iFPX.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const c=JSON.parse('{"title":"Asynchronous wallet creation","description":"","frontmatter":{},"headers":[],"relativePath":"guide/cqrs/create-wallet.md","filePath":"guide/cqrs/create-wallet.md"}'),e={name:"guide/cqrs/create-wallet.md"},t=n("",13),l=[t];function h(p,k,r,d,E,g){return a(),i("div",null,l)}const y=s(e,[["render",h]]);export{c as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_db_atomic-service.md.D5TpnOT6.js b/docs/.vitepress/dist/assets/guide_db_atomic-service.md.D5TpnOT6.js deleted file mode 100644 index 6bf8c40ec..000000000 --- a/docs/.vitepress/dist/assets/guide_db_atomic-service.md.D5TpnOT6.js +++ /dev/null @@ -1,11 +0,0 @@ -import{_ as s,c as i,o as a,a3 as t}from"./chunks/framework.OdeEVNy0.js";const g=JSON.parse('{"title":"Atomic Service","description":"","frontmatter":{},"headers":[],"relativePath":"guide/db/atomic-service.md","filePath":"guide/db/atomic-service.md"}'),e={name:"guide/db/atomic-service.md"},n=t(`Working with atomic wallet operations.
Before you start working with atomicity, you need to study the "Race Condition" section and configure the lock.
Sometimes it is necessary to apply actions to the user and the wallet atomically. For example, you want to raise an ad in the search and withdraw money from your wallet. You need an Atomic Service Interface.
use Bavix\\Wallet\\Services\\AtomicServiceInterface;
-
-app(AtomicServiceInterface::class)->block($wallet, function () use ($wallet, $entity) {
- $entity->increaseSales(); // update entity set sort_at=NOW() where id=123;
- $wallet->withdraw(100);
-});What's going on here? We block the wallet and raise the ad in the transaction (yes, atomic immediately starts the transaction - this is the main difference from LockServiceInterface). We raise the ad and deduct the amount from the wallet. If there are not enough funds to raise the ad, the error will complete the atomic operation and the transaction will roll back, and the lock on the wallet will be removed.
There is also an opportunity to block a lot of wallets. The operation is expensive, it generates N requests to the lock service. Maybe I'll optimize it in the future, but that's not for sure.
For example, we need to debit from two wallets at the same time. Then let's use the "blocks" method.
use Bavix\\Wallet\\Services\\AtomicServiceInterface;
-
-app(AtomicServiceInterface::class)->blocks([$wallet1, $wallet2], function () use ($wallet1, $wallet2) {
- $wallet1->withdraw(100);
- $wallet2->withdraw(100);
-});In this case, we blocked both wallets and started the process of debiting funds. Debiting from both wallets will be considered a successful operation. If there are not enough funds on some wallet, the operation is canceled.
It's simple!
`,12),l=[n];function h(p,k,r,o,d,c){return a(),i("div",null,l)}const y=s(e,[["render",h]]);export{g as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_db_atomic-service.md.D5TpnOT6.lean.js b/docs/.vitepress/dist/assets/guide_db_atomic-service.md.D5TpnOT6.lean.js deleted file mode 100644 index a45e5b18e..000000000 --- a/docs/.vitepress/dist/assets/guide_db_atomic-service.md.D5TpnOT6.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as t}from"./chunks/framework.OdeEVNy0.js";const g=JSON.parse('{"title":"Atomic Service","description":"","frontmatter":{},"headers":[],"relativePath":"guide/db/atomic-service.md","filePath":"guide/db/atomic-service.md"}'),e={name:"guide/db/atomic-service.md"},n=t("",12),l=[n];function h(p,k,r,o,d,c){return a(),i("div",null,l)}const y=s(e,[["render",h]]);export{g as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_db_race-condition.md.D79_peqX.js b/docs/.vitepress/dist/assets/guide_db_race-condition.md.D79_peqX.js deleted file mode 100644 index c7780d748..000000000 --- a/docs/.vitepress/dist/assets/guide_db_race-condition.md.D79_peqX.js +++ /dev/null @@ -1,10 +0,0 @@ -import{_ as s,c as i,o as a,a3 as e}from"./chunks/framework.OdeEVNy0.js";const u=JSON.parse('{"title":"Race Condition","description":"","frontmatter":{},"headers":[],"relativePath":"guide/db/race-condition.md","filePath":"guide/db/race-condition.md"}'),t={name:"guide/db/race-condition.md"},n=e(`A common issue in the issue is about race conditions.
If you have not yet imported the config into the project, then you need to do this.
php artisan vendor:publish --tag=laravel-wallet-configPreviously, there was a vacuum package, but now it is a part of the core. You just need to configure the lock service and the cache service in the package configuration wallet.php.
/**
- * A system for dealing with race conditions.
- */
- 'lock' => [
- 'driver' => 'array',
- 'seconds' => 1,
- ],To enable the fight against race conditions, you need to select a provider that supports work with locks. I recommend redis.
There is a setting for storing the state of the wallet, I recommend choosing redis here too.
/**
- * Storage of the state of the balance of wallets.
- */
- 'cache' => ['driver' => 'array'],You need redis-server and php-redis.
Redis is recommended but not required. You can choose whatever the framework offers you.
It's simple!
`,12),p=[n];function h(o,l,d,r,c,k){return a(),i("div",null,p)}const y=s(t,[["render",h]]);export{u as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_db_race-condition.md.D79_peqX.lean.js b/docs/.vitepress/dist/assets/guide_db_race-condition.md.D79_peqX.lean.js deleted file mode 100644 index c65c399b3..000000000 --- a/docs/.vitepress/dist/assets/guide_db_race-condition.md.D79_peqX.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as e}from"./chunks/framework.OdeEVNy0.js";const u=JSON.parse('{"title":"Race Condition","description":"","frontmatter":{},"headers":[],"relativePath":"guide/db/race-condition.md","filePath":"guide/db/race-condition.md"}'),t={name:"guide/db/race-condition.md"},n=e("",12),p=[n];function h(o,l,d,r,c,k){return a(),i("div",null,p)}const y=s(t,[["render",h]]);export{u as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_db_transaction.md.Buy64iJm.js b/docs/.vitepress/dist/assets/guide_db_transaction.md.Buy64iJm.js deleted file mode 100644 index 5e4134619..000000000 --- a/docs/.vitepress/dist/assets/guide_db_transaction.md.Buy64iJm.js +++ /dev/null @@ -1,6 +0,0 @@ -import{_ as s,c as i,o as a,a3 as t}from"./chunks/framework.OdeEVNy0.js";const m=JSON.parse('{"title":"Transaction","description":"","frontmatter":{},"headers":[],"relativePath":"guide/db/transaction.md","filePath":"guide/db/transaction.md"}'),n={name:"guide/db/transaction.md"},e=t(`You definitely need to know the feature of transactions. The wallet is automatically blocked from the moment it is used until the end of the transaction. Therefore, it is necessary to use the wallet closer to the end of the transaction.
Very important! Almost all wallet transactions are blocking.
use Illuminate\\Support\\Facades\\DB;
-
-DB::beginTransaction();
-$wallet->balanceInt; // now the wallet is blocked
-doingMagic(); // running for a long time.
-DB::commit(); // here will unlock the walletThe point is that you need to minimize operations within transactions as much as possible. The longer the transaction, the longer the wallet lock. The maximum wallet blocking time is set in the configuration. The longer the transaction takes, the more likely it is to get a race for the wallet.
It's simple!
`,7),l=[e];function h(o,p,r,k,c,d){return a(),i("div",null,l)}const u=s(n,[["render",h]]);export{m as __pageData,u as default}; diff --git a/docs/.vitepress/dist/assets/guide_db_transaction.md.Buy64iJm.lean.js b/docs/.vitepress/dist/assets/guide_db_transaction.md.Buy64iJm.lean.js deleted file mode 100644 index 6a75cb407..000000000 --- a/docs/.vitepress/dist/assets/guide_db_transaction.md.Buy64iJm.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as t}from"./chunks/framework.OdeEVNy0.js";const m=JSON.parse('{"title":"Transaction","description":"","frontmatter":{},"headers":[],"relativePath":"guide/db/transaction.md","filePath":"guide/db/transaction.md"}'),n={name:"guide/db/transaction.md"},e=t("",7),l=[e];function h(o,p,r,k,c,d){return a(),i("div",null,l)}const u=s(n,[["render",h]]);export{m as __pageData,u as default}; diff --git a/docs/.vitepress/dist/assets/guide_events_balance-updated-event.md.Bnwm6_qe.js b/docs/.vitepress/dist/assets/guide_events_balance-updated-event.md.Bnwm6_qe.js deleted file mode 100644 index 307c95ad6..000000000 --- a/docs/.vitepress/dist/assets/guide_events_balance-updated-event.md.Bnwm6_qe.js +++ /dev/null @@ -1,15 +0,0 @@ -import{_ as s,c as a,o as i,a3 as n}from"./chunks/framework.OdeEVNy0.js";const E=JSON.parse('{"title":"Tracking balance changes","description":"","frontmatter":{},"headers":[],"relativePath":"guide/events/balance-updated-event.md","filePath":"guide/events/balance-updated-event.md"}'),e={name:"guide/events/balance-updated-event.md"},t=n(`There are tasks when you urgently need to do something when the user's balance changes. A frequent case of transferring data via websockets to the front-end.
Version 7.2 introduces an interface to which you can subscribe. This is done using standard Laravel methods. More information in the documentation.
use Bavix\\Wallet\\Internal\\Events\\BalanceUpdatedEventInterface;
-
-protected $listen = [
- BalanceUpdatedEventInterface::class => [
- MyBalanceUpdatedListener::class,
- ],
-];And then we create a listener.
use Bavix\\Wallet\\Internal\\Events\\BalanceUpdatedEventInterface;
-
-class MyBalanceUpdatedListener
-{
- public function handle(BalanceUpdatedEventInterface $event): void
- {
- // And then the implementation...
- }
-}It's simple!
`,7),l=[t];function p(h,k,d,r,c,o){return i(),a("div",null,l)}const y=s(e,[["render",p]]);export{E as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_events_balance-updated-event.md.Bnwm6_qe.lean.js b/docs/.vitepress/dist/assets/guide_events_balance-updated-event.md.Bnwm6_qe.lean.js deleted file mode 100644 index 1abd5c516..000000000 --- a/docs/.vitepress/dist/assets/guide_events_balance-updated-event.md.Bnwm6_qe.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as a,o as i,a3 as n}from"./chunks/framework.OdeEVNy0.js";const E=JSON.parse('{"title":"Tracking balance changes","description":"","frontmatter":{},"headers":[],"relativePath":"guide/events/balance-updated-event.md","filePath":"guide/events/balance-updated-event.md"}'),e={name:"guide/events/balance-updated-event.md"},t=n("",7),l=[t];function p(h,k,d,r,c,o){return i(),a("div",null,l)}const y=s(e,[["render",p]]);export{E as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_events_customize.md.C_oxTANW.js b/docs/.vitepress/dist/assets/guide_events_customize.md.C_oxTANW.js deleted file mode 100644 index adfeb987b..000000000 --- a/docs/.vitepress/dist/assets/guide_events_customize.md.C_oxTANW.js +++ /dev/null @@ -1,44 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const c=JSON.parse('{"title":"Customizing events","description":"","frontmatter":{},"headers":[],"relativePath":"guide/events/customize.md","filePath":"guide/events/customize.md"}'),t={name:"guide/events/customize.md"},l=n(`Sometimes you want to modify the standard events of a package. This is done quite simply.
Let's add broadcast support? We need to implement our event from the interface.
use Bavix\\Wallet\\Internal\\Events\\BalanceUpdatedEventInterface;
-use Illuminate\\Contracts\\Broadcasting\\ShouldBroadcast;
-
-final class MyUpdatedEvent implements BalanceUpdatedEventInterface, ShouldBroadcast
-{
- public function __construct(
- private \\Bavix\\Wallet\\Models\\Wallet $wallet,
- private DateTimeImmutable $updatedAt,
- ) {}
-
- public function getWalletId(): int { return $this->wallet->getKey(); }
- public function getWalletUuid(): string { return $this->wallet->uuid; }
- public function getBalance(): string { return $this->wallet->balanceInt; }
- public function getUpdatedAt(): DateTimeImmutable { return $this->updatedAt; }
-
- public function broadcastOn(): array
- {
- return $this->wallet->getAttributes();
- }
-}The event is ready, but that's not all. Now you need to implement your assembler class, which will create an event inside the package.
use Bavix\\Wallet\\Internal\\Assembler\\BalanceUpdatedEventAssemblerInterface;
-
-class MyUpdatedEventAssembler implements BalanceUpdatedEventAssemblerInterface
-{
- public function create(\\Bavix\\Wallet\\Models\\Wallet $wallet) : \\Bavix\\Wallet\\Internal\\Events\\BalanceUpdatedEventInterface
- {
- return new MyUpdatedEvent($wallet, new DateTimeImmutable());
- }
-}Next, go to the package settings (wallet.php). We change the event to a new one.
'assemblers' => [
- 'balance_updated_event' => MyUpdatedEventAssembler::class,
- ],Then everything is the same as with the standard events of the package.
use Bavix\\Wallet\\Internal\\Events\\BalanceUpdatedEventInterface;
-
-protected $listen = [
- BalanceUpdatedEventInterface::class => [
- MyBalanceUpdatedListener::class,
- ],
-];And then we create a listener.
use Bavix\\Wallet\\Internal\\Events\\BalanceUpdatedEventInterface;
-
-class MyBalanceUpdatedListener
-{
- public function handle(BalanceUpdatedEventInterface $event): void
- {
- // And then the implementation...
- }
-}It's simple!
`,13),h=[l];function e(p,k,d,r,E,g){return a(),i("div",null,h)}const F=s(t,[["render",e]]);export{c as __pageData,F as default}; diff --git a/docs/.vitepress/dist/assets/guide_events_customize.md.C_oxTANW.lean.js b/docs/.vitepress/dist/assets/guide_events_customize.md.C_oxTANW.lean.js deleted file mode 100644 index 187997b79..000000000 --- a/docs/.vitepress/dist/assets/guide_events_customize.md.C_oxTANW.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const c=JSON.parse('{"title":"Customizing events","description":"","frontmatter":{},"headers":[],"relativePath":"guide/events/customize.md","filePath":"guide/events/customize.md"}'),t={name:"guide/events/customize.md"},l=n("",13),h=[l];function e(p,k,d,r,E,g){return a(),i("div",null,h)}const F=s(t,[["render",e]]);export{c as __pageData,F as default}; diff --git a/docs/.vitepress/dist/assets/guide_events_transaction-created-event.md.D2KSbfEY.js b/docs/.vitepress/dist/assets/guide_events_transaction-created-event.md.D2KSbfEY.js deleted file mode 100644 index e5baa3554..000000000 --- a/docs/.vitepress/dist/assets/guide_events_transaction-created-event.md.D2KSbfEY.js +++ /dev/null @@ -1,15 +0,0 @@ -import{_ as s,c as a,o as i,a3 as n}from"./chunks/framework.OdeEVNy0.js";const g=JSON.parse('{"title":"Tracking the creation of wallet transactions","description":"","frontmatter":{},"headers":[],"relativePath":"guide/events/transaction-created-event.md","filePath":"guide/events/transaction-created-event.md"}'),t={name:"guide/events/transaction-created-event.md"},e=n(`The events are similar to the events for updating the balance, only for the creation of a wallet. A frequent case of transferring data via websockets to the front-end.
Version 9.1 introduces an interface to which you can subscribe. This is done using standard Laravel methods. More information in the documentation.
use Bavix\\Wallet\\Internal\\Events\\TransactionCreatedEventInterface;
-
-protected $listen = [
- TransactionCreatedEventInterface::class => [
- MyWalletTransactionCreatedListener::class,
- ],
-];And then we create a listener.
use Bavix\\Wallet\\Internal\\Events\\TransactionCreatedEventInterface;
-
-class MyWalletTransactionCreatedListener
-{
- public function handle(TransactionCreatedEventInterface $event): void
- {
- // And then the implementation...
- }
-}It's simple!
`,7),l=[e];function h(p,r,k,c,d,o){return i(),a("div",null,l)}const y=s(t,[["render",h]]);export{g as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_events_transaction-created-event.md.D2KSbfEY.lean.js b/docs/.vitepress/dist/assets/guide_events_transaction-created-event.md.D2KSbfEY.lean.js deleted file mode 100644 index f04055d8c..000000000 --- a/docs/.vitepress/dist/assets/guide_events_transaction-created-event.md.D2KSbfEY.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as a,o as i,a3 as n}from"./chunks/framework.OdeEVNy0.js";const g=JSON.parse('{"title":"Tracking the creation of wallet transactions","description":"","frontmatter":{},"headers":[],"relativePath":"guide/events/transaction-created-event.md","filePath":"guide/events/transaction-created-event.md"}'),t={name:"guide/events/transaction-created-event.md"},e=n("",7),l=[e];function h(p,r,k,c,d,o){return i(),a("div",null,l)}const y=s(t,[["render",h]]);export{g as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_events_wallet-created-event.md.BSjxjF9u.js b/docs/.vitepress/dist/assets/guide_events_wallet-created-event.md.BSjxjF9u.js deleted file mode 100644 index acd1b9c2f..000000000 --- a/docs/.vitepress/dist/assets/guide_events_wallet-created-event.md.BSjxjF9u.js +++ /dev/null @@ -1,15 +0,0 @@ -import{_ as s,c as a,o as i,a3 as e}from"./chunks/framework.OdeEVNy0.js";const g=JSON.parse('{"title":"Tracking the creation of wallets","description":"","frontmatter":{},"headers":[],"relativePath":"guide/events/wallet-created-event.md","filePath":"guide/events/wallet-created-event.md"}'),n={name:"guide/events/wallet-created-event.md"},t=e(`The events are similar to the events for updating the balance, only for the creation of a wallet. A frequent case of transferring data via websockets to the front-end.
Version 7.3 introduces an interface to which you can subscribe. This is done using standard Laravel methods. More information in the documentation.
use Bavix\\Wallet\\Internal\\Events\\WalletCreatedEventInterface;
-
-protected $listen = [
- WalletCreatedEventInterface::class => [
- MyWalletCreatedListener::class,
- ],
-];And then we create a listener.
use Bavix\\Wallet\\Internal\\Events\\WalletCreatedEventInterface;
-
-class MyWalletCreatedListener
-{
- public function handle(WalletCreatedEventInterface $event): void
- {
- // And then the implementation...
- }
-}It's simple!
`,7),l=[t];function h(p,r,k,d,c,o){return i(),a("div",null,l)}const y=s(n,[["render",h]]);export{g as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_events_wallet-created-event.md.BSjxjF9u.lean.js b/docs/.vitepress/dist/assets/guide_events_wallet-created-event.md.BSjxjF9u.lean.js deleted file mode 100644 index e10a61d03..000000000 --- a/docs/.vitepress/dist/assets/guide_events_wallet-created-event.md.BSjxjF9u.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as a,o as i,a3 as e}from"./chunks/framework.OdeEVNy0.js";const g=JSON.parse('{"title":"Tracking the creation of wallets","description":"","frontmatter":{},"headers":[],"relativePath":"guide/events/wallet-created-event.md","filePath":"guide/events/wallet-created-event.md"}'),n={name:"guide/events/wallet-created-event.md"},t=e("",7),l=[t];function h(p,r,k,d,c,o){return i(),a("div",null,l)}const y=s(n,[["render",h]]);export{g as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_fractional_deposit.md.BWPIoLWk.js b/docs/.vitepress/dist/assets/guide_fractional_deposit.md.BWPIoLWk.js deleted file mode 100644 index 18aa91503..000000000 --- a/docs/.vitepress/dist/assets/guide_fractional_deposit.md.BWPIoLWk.js +++ /dev/null @@ -1,12 +0,0 @@ -import{_ as s,c as i,o as a,a3 as e}from"./chunks/framework.OdeEVNy0.js";const E=JSON.parse('{"title":"Deposit float","description":"","frontmatter":{},"headers":[],"relativePath":"guide/fractional/deposit.md","filePath":"guide/fractional/deposit.md"}'),t={name:"guide/fractional/deposit.md"},l=e(`A deposit is a sum of money which is part of the full price of something, and which you pay when you agree to buy it.
In this case, the Deposit is the replenishment of the wallet.
It is necessary to expand the model that will have the wallet. This is done in two stages:
Wallet interface;HasWalletFloat trait;Let's get started.
use Bavix\\Wallet\\Traits\\HasWalletFloat;
-use Bavix\\Wallet\\Interfaces\\Wallet;
-
-class User extends Model implements Wallet
-{
- use HasWalletFloat;
-}The model is prepared to work with a wallet.
Find user:
$user = User::first();As the user uses HasWalletFloat, he will have balance property. Check the user's balance.
$user->balance; // 0
-$user->balanceInt; // 0
-$user->balanceFloatNum; // 0The balance is zero, which is what we expected.
$user->depositFloat(10.1);
-$user->balance; // 1010
-$user->balanceInt; // 1010
-$user->balanceFloatNum; // 10.1Wow!
`,17),n=[l];function h(p,k,d,r,o,c){return a(),i("div",null,n)}const y=s(t,[["render",h]]);export{E as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_fractional_deposit.md.BWPIoLWk.lean.js b/docs/.vitepress/dist/assets/guide_fractional_deposit.md.BWPIoLWk.lean.js deleted file mode 100644 index 487007d72..000000000 --- a/docs/.vitepress/dist/assets/guide_fractional_deposit.md.BWPIoLWk.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as e}from"./chunks/framework.OdeEVNy0.js";const E=JSON.parse('{"title":"Deposit float","description":"","frontmatter":{},"headers":[],"relativePath":"guide/fractional/deposit.md","filePath":"guide/fractional/deposit.md"}'),t={name:"guide/fractional/deposit.md"},l=e("",17),n=[l];function h(p,k,d,r,o,c){return a(),i("div",null,n)}const y=s(t,[["render",h]]);export{E as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_fractional_transfer.md.B0rpt3xh.js b/docs/.vitepress/dist/assets/guide_fractional_transfer.md.B0rpt3xh.js deleted file mode 100644 index 47b78e344..000000000 --- a/docs/.vitepress/dist/assets/guide_fractional_transfer.md.B0rpt3xh.js +++ /dev/null @@ -1,26 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const o=JSON.parse('{"title":"Transfer","description":"","frontmatter":{},"headers":[],"relativePath":"guide/fractional/transfer.md","filePath":"guide/fractional/transfer.md"}'),t={name:"guide/fractional/transfer.md"},h=n(`Transfer in our system are two well-known Deposit and Withdraw operations that are performed in one transaction.
The transfer takes place between wallets.
$transfer = $user1->transferFloat(
- $user2,
- 5.11,
- new Extra(
- deposit: [
- 'type' => 'extra-deposit',
- ],
- withdraw: new Option(
- [
- 'type' => 'extra-withdraw',
- ],
- false // confirmed
- ),
- extra: [
- 'msg' => 'hello world',
- ],
- )
-);Find user:
$first = User::first();
-$last = User::orderBy('id', 'desc')->first(); // last user
-$first->getKey() !== $last->getKey(); // trueAs the user uses HasWalletFloat, he will have balance property. Check the user's balance.
$fist->balanceFloatNum; // 100.00
-$last->balanceFloatNum; // 0The transfer will be from the first user to the second.
$first->transferFloat($last, 5);
-$first->balanceFloatNum; // 95
-$last->balanceFloatNum; // 5It's simple!
Check the user's balance.
$first->balanceFloatNum; // 100
-$last->balanceFloatNum; // 0The transfer will be from the first user to the second.
$first->forceTransferFloat($last, 500);
-$first->balanceFloatNum; // -400
-$last->balanceFloatNum; // 500It's simple!
`,20),l=[h];function e(p,k,r,d,E,g){return a(),i("div",null,l)}const y=s(t,[["render",e]]);export{o as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_fractional_transfer.md.B0rpt3xh.lean.js b/docs/.vitepress/dist/assets/guide_fractional_transfer.md.B0rpt3xh.lean.js deleted file mode 100644 index e24ab68b1..000000000 --- a/docs/.vitepress/dist/assets/guide_fractional_transfer.md.B0rpt3xh.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const o=JSON.parse('{"title":"Transfer","description":"","frontmatter":{},"headers":[],"relativePath":"guide/fractional/transfer.md","filePath":"guide/fractional/transfer.md"}'),t={name:"guide/fractional/transfer.md"},h=n("",20),l=[h];function e(p,k,r,d,E,g){return a(),i("div",null,l)}const y=s(t,[["render",e]]);export{o as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_fractional_withdraw.md.B7oZ_OTi.js b/docs/.vitepress/dist/assets/guide_fractional_withdraw.md.B7oZ_OTi.js deleted file mode 100644 index b90b26a1e..000000000 --- a/docs/.vitepress/dist/assets/guide_fractional_withdraw.md.B7oZ_OTi.js +++ /dev/null @@ -1,8 +0,0 @@ -import{_ as s,c as a,o as i,a3 as e}from"./chunks/framework.OdeEVNy0.js";const g=JSON.parse('{"title":"Withdraw","description":"","frontmatter":{},"headers":[],"relativePath":"guide/fractional/withdraw.md","filePath":"guide/fractional/withdraw.md"}'),t={name:"guide/fractional/withdraw.md"},h=e(`When there is enough money in the account, you can transfer/withdraw it or buy something in the system.
Since the currency is virtual, you can buy any services on your website. For example, priority in search results.
Find user:
$user = User::first();As the user uses HasWalletFloat, he will have balance property. Check the user's balance.
$user->balance; // 10000
-$user->balanceInt; // 10000
-$user->balanceFloatNum; // 100.00The balance is not empty, so you can withdraw funds.
$user->withdrawFloat(10);
-$user->balance; // 9000
-$user->balanceInt; // 9000
-$user->balanceFloatNum; // 90.00It's simple!
Forced withdrawal is necessary for those cases when the user has no funds. For example, a fine for spam.
$user->balanceFloatNum; // 90.00
-$user->forceWithdrawFloat(101);
-$user->balanceFloatNum; // -11.00There can be two situations:
Bavix\\Wallet\\Exceptions\\BalanceIsEmptyBavix\\Wallet\\Exceptions\\InsufficientFundsSometimes you need to convert the balance to some format. A small and simple helper has appeared that will simplify the process a little.
app(FormatterServiceInterface::class)->floatValue('12345', 2); // 123.45
-app(FormatterServiceInterface::class)->floatValue('12345', 3); // 12.345app(FormatterServiceInterface::class)->intValue('12.345', 3); // 12345
-app(FormatterServiceInterface::class)->intValue('123.45', 2); // 12345It's simple!
`,8),l=[e];function n(p,k,r,d,o,E){return a(),i("div",null,l)}const F=s(h,[["render",n]]);export{c as __pageData,F as default}; diff --git a/docs/.vitepress/dist/assets/guide_helpers_formatter.md.D75UEgM0.lean.js b/docs/.vitepress/dist/assets/guide_helpers_formatter.md.D75UEgM0.lean.js deleted file mode 100644 index 687880571..000000000 --- a/docs/.vitepress/dist/assets/guide_helpers_formatter.md.D75UEgM0.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as t}from"./chunks/framework.OdeEVNy0.js";const c=JSON.parse('{"title":"Formatter","description":"","frontmatter":{},"headers":[],"relativePath":"guide/helpers/formatter.md","filePath":"guide/helpers/formatter.md"}'),h={name:"guide/helpers/formatter.md"},e=t("",8),l=[e];function n(p,k,r,d,o,E){return a(),i("div",null,l)}const F=s(h,[["render",n]]);export{c as __pageData,F as default}; diff --git a/docs/.vitepress/dist/assets/guide_high-performance_batch-transactions.md.CmHigNAE.js b/docs/.vitepress/dist/assets/guide_high-performance_batch-transactions.md.CmHigNAE.js deleted file mode 100644 index ea1516bea..000000000 --- a/docs/.vitepress/dist/assets/guide_high-performance_batch-transactions.md.CmHigNAE.js +++ /dev/null @@ -1,59 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const c=JSON.parse('{"title":"Batch Transactions","description":"","frontmatter":{},"headers":[],"relativePath":"guide/high-performance/batch-transactions.md","filePath":"guide/high-performance/batch-transactions.md"}'),t={name:"guide/high-performance/batch-transactions.md"},h=n(`Sometimes situations arise when there is a need to make multiple changes to wallets. For example, we need to change the balance of many wallets at once. For example, the system administrator accrues a bonus for participating in some promotion. Previously, the code would look like this:
use Bavix\\Wallet\\Services\\AtomicServiceInterface;
-
-app(AtomicServiceInterface::class)->blocks($wallets, function () use ($amount, $wallets) {
- foreach ($wallets as $wallet) {
- $wallet->deposit($amount);
- }
-});The code is working and everything works correctly. But what happens under the hood? Nothing good. For 5 users it will look like this. 
Since the operations inside an atomic operation can depend on each other, we will not be able to combine insert queries into a batch. But there is an opportunity to reduce the number of update queries and improve application performance out of the blue.
After small things, the situation will look like this.
As you can see, things are getting better. Still, I would like to be able to tell the package that the changes are independent of each other. In this case, the package will be able to collapse all insert queries into a single query and insert in a batch.
Here new api handles can help us:
// For multiple transactions.
-interface TransactionQueryHandlerInterface
-{
- /**
- * @param non-empty-array<TransactionQuery> $objects
- * @return non-empty-array<string, Transaction>
- * @throws ExceptionInterface
- */
- public function apply(array $objects): array;
-}
-
-// For multiple transfers of funds.
-interface TransferQueryHandlerInterface
-{
- /**
- * @param non-empty-array<TransferQuery> $objects
- * @return non-empty-array<string, Transfer>
- * @throws ExceptionInterface
- */
- public function apply(array $objects): array;
-}Let's use the API handle.
use Bavix\\Wallet\\External\\Api\\TransactionQuery;
-use Bavix\\Wallet\\External\\Api\\TransactionQueryHandlerInterface;
-
-app(TransactionQueryHandlerInterface::class)->apply(
- array_map(
- static fn (Wallet $wallet) => TransactionQuery::createDeposit($wallet, $amount, null),
- $wallets
- )
-);And now look at the result and it is impressive. 
But it is worth noting that these are highly efficient api handles and they do not check the balance of the wallet before making changes. If you need it, then you have to do something like this.
use Bavix\\Wallet\\External\\Api\\TransactionQuery;
-use Bavix\\Wallet\\External\\Api\\TransactionQueryHandlerInterface;
-use Bavix\\Wallet\\Services\\AtomicServiceInterface;
-use Bavix\\Wallet\\Services\\ConsistencyServiceInterface;
-
-app(AtomicServiceInterface::class)->blocks($wallets, function () use ($wallets, $amount) {
- foreach ($wallets as $wallet) {
- app(ConsistencyServiceInterface::class)->checkPotential($wallet, $amount);
- }
-
- app(TransactionQueryHandlerInterface::class)->apply(
- array_map(
- static fn (Wallet $wallet) => TransactionQuery::createWithdraw($wallet, $amount, null),
- $wallets
- )
- );
-});In version 10.x, it became possible to create transactions with a given uuid (generate on the client side). The main thing is to keep uniqueness.
use Bavix\\Wallet\\External\\Api\\TransactionQuery;
-
-// int version
-TransactionQuery::createDeposit($wallet, $amount, null, uuid: '5f7820d1-1e82-4d03-9414-05d0c44da9a1');
-TransactionQuery::createWithdraw($wallet, $amount, null, uuid: '6e87dbf2-7be7-48c2-b688-f46ba4e25786');
-
-// float version
-TransactionFloatQuery::createDeposit($wallet, $amountFloat, null, uuid: '5f7820d1-1e82-4d03-9414-05d0c44da9a1');
-TransactionFloatQuery::createWithdraw($wallet, $amountFloat, null, uuid: '6e87dbf2-7be7-48c2-b688-f46ba4e25786');It's simple!
`,20),l=[h];function p(e,k,r,d,E,g){return a(),i("div",null,l)}const o=s(t,[["render",p]]);export{c as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_high-performance_batch-transactions.md.CmHigNAE.lean.js b/docs/.vitepress/dist/assets/guide_high-performance_batch-transactions.md.CmHigNAE.lean.js deleted file mode 100644 index eba2bc7dc..000000000 --- a/docs/.vitepress/dist/assets/guide_high-performance_batch-transactions.md.CmHigNAE.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const c=JSON.parse('{"title":"Batch Transactions","description":"","frontmatter":{},"headers":[],"relativePath":"guide/high-performance/batch-transactions.md","filePath":"guide/high-performance/batch-transactions.md"}'),t={name:"guide/high-performance/batch-transactions.md"},h=n("",20),l=[h];function p(e,k,r,d,E,g){return a(),i("div",null,l)}const o=s(t,[["render",p]]);export{c as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_high-performance_batch-transfers.md.DnEd7m-y.js b/docs/.vitepress/dist/assets/guide_high-performance_batch-transfers.md.DnEd7m-y.js deleted file mode 100644 index a3847035b..000000000 --- a/docs/.vitepress/dist/assets/guide_high-performance_batch-transfers.md.DnEd7m-y.js +++ /dev/null @@ -1,43 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const c=JSON.parse('{"title":"Batch Transfers","description":"","frontmatter":{},"headers":[],"relativePath":"guide/high-performance/batch-transfers.md","filePath":"guide/high-performance/batch-transfers.md"}'),t={name:"guide/high-performance/batch-transfers.md"},h=n(`If you need multiple transfers between wallets, you can use a high-performance handle. It is worth remembering that the pen does not check the balance of the wallet before transferring, you need to take care of this yourself.
Previously, you would have written the following code:
use Bavix\\Wallet\\Services\\AtomicServiceInterface;
-
-app(AtomicServiceInterface::class)->block($from, function () use ($amount, $from, $wallets) {
- foreach ($wallets as $wallet) {
- $from->forceTransfer($wallet, $amount);
- }
-});This would lead to the generation of a huge number of requests to the database and cache, because. the package does not know that the response from forceTransfer is not used by you at all inside AtomicService. Now, you can report it:
use Bavix\\Wallet\\External\\Api\\TransferQuery;
-use Bavix\\Wallet\\External\\Api\\TransferQueryHandlerInterface;
-
-app(TransferQueryHandlerInterface::class)->apply(
- array_map(
- static fn (Wallet $wallet) => new TransferQuery($from, $wallet, $amount, null),
- $wallets
- )
-);The package will optimize queries and execute them in a single transaction. I strongly advise against creating large packs, because. this can lead to a large increase in request queuing.
In version 10.x, it became possible to create transactions&transfers with a given uuid (generate on the client side). The main thing is to keep uniqueness.
use Bavix\\Wallet\\External\\Api\\TransferQuery;
-
-// int version
-new TransferQuery($from, $wallet, $amount, new \\Bavix\\Wallet\\External\\Dto\\Extra(
- deposit: new \\Bavix\\Wallet\\External\\Dto\\Option(
- null,
- uuid: '71cecafe-da10-464f-9e00-c80437bb4c3e', // deposit transaction
- ),
- withdraw: new \\Bavix\\Wallet\\External\\Dto\\Option(
- null,
- uuid: '3805730b-39a1-419d-8715-0b7cc3f1ffc2', // withdraw transaction
- ),
- uuid: 'f8becf81-3993-43d7-81f1-7a725c72e976', // transfer uuid
- extra: ['info' => 'fast deposit'], // metadata in the table transfers
-));
-
-// float version
-new TransferFloatQuery($from, $wallet, $amountFlaot, new \\Bavix\\Wallet\\External\\Dto\\Extra(
- deposit: new \\Bavix\\Wallet\\External\\Dto\\Option(
- null,
- uuid: '71cecafe-da10-464f-9e00-c80437bb4c3e', // deposit transaction
- ),
- withdraw: new \\Bavix\\Wallet\\External\\Dto\\Option(
- null,
- uuid: '3805730b-39a1-419d-8715-0b7cc3f1ffc2', // withdraw transaction
- ),
- uuid: 'f8becf81-3993-43d7-81f1-7a725c72e976', // transfer uuid
- extra: ['info' => 'fast deposit'], // metadata in the table transfers
-));It's simple!
`,12),l=[h];function e(p,k,r,E,d,g){return a(),i("div",null,l)}const o=s(t,[["render",e]]);export{c as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_high-performance_batch-transfers.md.DnEd7m-y.lean.js b/docs/.vitepress/dist/assets/guide_high-performance_batch-transfers.md.DnEd7m-y.lean.js deleted file mode 100644 index 67e1f8545..000000000 --- a/docs/.vitepress/dist/assets/guide_high-performance_batch-transfers.md.DnEd7m-y.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const c=JSON.parse('{"title":"Batch Transfers","description":"","frontmatter":{},"headers":[],"relativePath":"guide/high-performance/batch-transfers.md","filePath":"guide/high-performance/batch-transfers.md"}'),t={name:"guide/high-performance/batch-transfers.md"},h=n("",12),l=[h];function e(p,k,r,E,d,g){return a(),i("div",null,l)}const o=s(t,[["render",e]]);export{c as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_introduction_basic-usage.md.8BCaXADC.js b/docs/.vitepress/dist/assets/guide_introduction_basic-usage.md.8BCaXADC.js deleted file mode 100644 index 506395100..000000000 --- a/docs/.vitepress/dist/assets/guide_introduction_basic-usage.md.8BCaXADC.js +++ /dev/null @@ -1,118 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const c=JSON.parse('{"title":"Basic Usage","description":"","frontmatter":{},"headers":[],"relativePath":"guide/introduction/basic-usage.md","filePath":"guide/introduction/basic-usage.md"}'),l={name:"guide/introduction/basic-usage.md"},t=n(`It is necessary to expand the model that will have the wallet. This is done in two stages:
Wallet interface;HasWallet trait;Let's get started.
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Wallet;
-
-class User extends Model implements Wallet
-{
- use HasWallet;
-}The model is prepared to work with a wallet.
The package is built on simple transactions:
Consider an example:
$user = User::first();
-$user->balance; // 0
-
-$user->deposit(10);
-$user->balance; // 10
-
-$user->withdraw(1);
-$user->balance; // 9
-
-$user->forceWithdraw(200, ['description' => 'payment of taxes']);
-$user->balance; // -191Add the CanPay trait and Customer interface to your User model.
The trait
CanPayalready inheritsHasWallet, reuse will cause an error.
use Bavix\\Wallet\\Traits\\CanPay;
-use Bavix\\Wallet\\Interfaces\\Customer;
-
-class User extends Model implements Customer
-{
- use CanPay;
-}Add the HasWallet trait and interface to Item model.
Starting from version 9.x there are two product interfaces:
ProductInterface);ProductLimitedInterface);An example with an unlimited number of products:
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Customer;
-use Bavix\\Wallet\\Interfaces\\ProductInterface;
-
-class Item extends Model implements ProductInterface
-{
- use HasWallet;
-
- public function getAmountProduct(Customer $customer): int|string
- {
- return 100;
- }
-
- public function getMetaProduct(): ?array
- {
- return [
- 'title' => $this->title,
- 'description' => 'Purchase of Product #' . $this->id,
- ];
- }
-}Example with a limited number of products:
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Customer;
-use Bavix\\Wallet\\Interfaces\\ProductLimitedInterface;
-
-class Item extends Model implements ProductLimitedInterface
-{
- use HasWallet;
-
- public function canBuy(Customer $customer, int $quantity = 1, bool $force = false): bool
- {
- /**
- * This is where you implement the constraint logic.
- *
- * If the service can be purchased once, then
- * return !$customer->paid($this);
- */
- return true;
- }
-
- public function getAmountProduct(Customer $customer): int|string
- {
- return 100;
- }
-
- public function getMetaProduct(): ?array
- {
- return [
- 'title' => $this->title,
- 'description' => 'Purchase of Product #' . $this->id,
- ];
- }
-}I do not recommend using the limited interface when working with a shopping cart. If you are working with a shopping cart, then you should override the PurchaseServiceInterface interface. With it, you can check the availability of all products with one request, there will be no N-queries in the database.
Proceed to purchase.
$user = User::first();
-$user->balance; // 100
-
-$item = Item::first();
-$user->pay($item); // If you do not have enough money, throw an exception
-var_dump($user->balance); // 0
-
-if ($user->safePay($item)) {
- // try to buy again )
-}
-
-var_dump((bool)$user->paid($item)); // bool(true)
-
-var_dump($user->refund($item)); // bool(true)
-var_dump((bool)$user->paid($item)); // bool(false)When accessing Eloquent relationships as properties, the relationship data is "lazy loaded". This means the relationship data is not actually loaded until you first access the property. However, Eloquent can "eager load" relationships at the time you query the parent model. Eager loading alleviates the N + 1 query problem. To illustrate the N + 1 query problem, consider a Wallet model that is related to User:
Add the HasWallet trait and Wallet interface to model.
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Wallet;
-
-class User extends Model implements Wallet
-{
- use HasWallet; // public function wallet(): MorphOne...
-}Now, let's retrieve all wallets and their users:
$users = User::all();
-
-foreach ($users as $user) {
- // echo $user->wallet->balance;
- echo $user->balance; // Abbreviated notation
-}This loop will execute 1 query to retrieve all of the users on the table, then another query for each user to retrieve the wallet. So, if we have 25 users, the code above would run 26 queries: 1 for the original user, and 25 additional queries to retrieve the wallet of each user.
Thankfully, we can use eager loading to reduce this operation to just 2 queries. When querying, you may specify which relationships should be eager loaded using the with method:
$users = User::with('wallet')->all();
-
-foreach ($users as $user) {
- // echo $user->wallet->balance;
- echo $user->balance; // Abbreviated notation
-}For this operation, only two queries will be executed.
Add the HasWalletFloat trait and WalletFloat interface to model.
use Bavix\\Wallet\\Traits\\HasWalletFloat;
-use Bavix\\Wallet\\Interfaces\\WalletFloat;
-use Bavix\\Wallet\\Interfaces\\Wallet;
-
-class User extends Model implements Wallet, WalletFloat
-{
- use HasWalletFloat;
-}Now we make transactions.
$user = User::first();
-$user->balance; // 100
-$user->balanceFloat; // 1.00
-
-$user->depositFloat(1.37);
-$user->balance; // 237
-$user->balanceFloat; // 2.37You can get the float amount by accessing the amountFloat attribute on the transaction model
$transaction->amount; // 137
-$transaction->amountFloat; // 1.37Though this package is crafted to suit most of your needs by default, you can edit the configuration file to suit certain demands.
| Name | Description | Default |
|---|---|---|
WALLET_MATH_SCALE | Select mathematical precision | 64 |
WALLET_CACHE_DRIVER | Cache for wallet balance | array |
WALLET_CACHE_TTL | Cache TTL for wallet balance | 24h |
WALLET_LOCK_DRIVER | Lock for wallets | array |
WALLET_LOCK_TTL | Lock TTL for wallets | 1s |
WALLET_TRANSACTION_TABLE_NAME | Transaction table name | transactions |
WALLET_TRANSFER_TABLE_NAME | Transfer table name | transfers |
WALLET_WALLET_TABLE_NAME | Wallet table name | wallets |
WALLET_DEFAULT_WALLET_NAME | Default wallet name | Default Wallet |
WALLET_DEFAULT_WALLET_SLUG | Default wallet slug | default |
Customize name,slug and meta of default wallet.
config/wallet.php:
'default' => [
- 'name' => 'Ethereum',
- 'slug' => 'ETH',
- 'meta' => [],
-],You can extend base Wallet model by creating a new class that extends Bavix\\Wallet\\Models\\Wallet and registering the new class in config/wallet.php. Example MyWallet.php
App/Models/MyWallet.php:
use Bavix\\Wallet\\Models\\Wallet as WalletBase;
-
-class MyWallet extends WalletBase {
- public function helloWorld(): string { return "hello world"; }
-}config/wallet.php:
'wallet' => [
- 'table' => 'wallets',
- 'model' => MyWallet::class,
- 'creating' => [],
- 'default' => [
- 'name' => 'Default Wallet',
- 'slug' => 'default',
- 'meta' => [],
- ],
-],echo $user->wallet->helloWorld();This same method above, can be used to extend the base Transfer and Transaction models and registering the extended models in the configuration file.
You can change the default wallet decimal places, in wallet config file. This can be useful when working with fractional numbers.
config/wallet.php:
/**
- * Base model 'wallet'.
- */
-'wallet' => [
- ....
- 'creating' => [
- 'decimal_places' => 18,
- ],
- ....
-],
laravel-wallet - Easy work with virtual wallet.
Please ask questions on the Github issues page.
',6),n=[i];function s(c,d,l,u,p,_){return a(),t("div",null,n)}const m=e(r,[["render",s]]);export{f as __pageData,m as default}; diff --git a/docs/.vitepress/dist/assets/guide_introduction_index.md.OLZq5yD4.lean.js b/docs/.vitepress/dist/assets/guide_introduction_index.md.OLZq5yD4.lean.js deleted file mode 100644 index 2fd7977e0..000000000 --- a/docs/.vitepress/dist/assets/guide_introduction_index.md.OLZq5yD4.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as e,c as t,o as a,a3 as o}from"./chunks/framework.OdeEVNy0.js";const f=JSON.parse('{"title":"Introduction","description":"","frontmatter":{},"headers":[],"relativePath":"guide/introduction/index.md","filePath":"guide/introduction/index.md"}'),r={name:"guide/introduction/index.md"},i=o("",6),n=[i];function s(c,d,l,u,p,_){return a(),t("div",null,n)}const m=e(r,[["render",s]]);export{f as __pageData,m as default}; diff --git a/docs/.vitepress/dist/assets/guide_introduction_installation.md.BJr2yk7p.js b/docs/.vitepress/dist/assets/guide_introduction_installation.md.BJr2yk7p.js deleted file mode 100644 index 1888aaa5b..000000000 --- a/docs/.vitepress/dist/assets/guide_introduction_installation.md.BJr2yk7p.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as a,c as i,o as t,a3 as s}from"./chunks/framework.OdeEVNy0.js";const k=JSON.parse('{"title":"Installation","description":"","frontmatter":{},"headers":[],"relativePath":"guide/introduction/installation.md","filePath":"guide/introduction/installation.md"}'),e={name:"guide/introduction/installation.md"},n=s('The recommended installation method is using Composer.
In your project root just run:
composer req bavix/laravel-walletEnsure that you’ve set up your project to autoload Composer-installed packages.
Sometimes it is useful...
Publish the migrations with this artisan command:
php artisan vendor:publish --tag=laravel-wallet-migrationsYou can publish the config file with this artisan command:
php artisan vendor:publish --tag=laravel-wallet-configAfter installing the package, you can proceed to use it or configure it to suit your needs.
',15),o=[n];function l(r,h,p,d,c,u){return t(),i("div",null,o)}const m=a(e,[["render",l]]);export{k as __pageData,m as default}; diff --git a/docs/.vitepress/dist/assets/guide_introduction_installation.md.BJr2yk7p.lean.js b/docs/.vitepress/dist/assets/guide_introduction_installation.md.BJr2yk7p.lean.js deleted file mode 100644 index 15bdf996c..000000000 --- a/docs/.vitepress/dist/assets/guide_introduction_installation.md.BJr2yk7p.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as a,c as i,o as t,a3 as s}from"./chunks/framework.OdeEVNy0.js";const k=JSON.parse('{"title":"Installation","description":"","frontmatter":{},"headers":[],"relativePath":"guide/introduction/installation.md","filePath":"guide/introduction/installation.md"}'),e={name:"guide/introduction/installation.md"},n=s("",15),o=[n];function l(r,h,p,d,c,u){return t(),i("div",null,o)}const m=a(e,[["render",l]]);export{k as __pageData,m as default}; diff --git a/docs/.vitepress/dist/assets/guide_introduction_upgrade.md.CWeACiVZ.js b/docs/.vitepress/dist/assets/guide_introduction_upgrade.md.CWeACiVZ.js deleted file mode 100644 index 3ad9cda3a..000000000 --- a/docs/.vitepress/dist/assets/guide_introduction_upgrade.md.CWeACiVZ.js +++ /dev/null @@ -1,58 +0,0 @@ -import{_ as s,c as i,o as a,a3 as e}from"./chunks/framework.OdeEVNy0.js";const E=JSON.parse('{"title":"Upgrade Guide","description":"","frontmatter":{},"headers":[],"relativePath":"guide/introduction/upgrade.md","filePath":"guide/introduction/upgrade.md"}'),t={name:"guide/introduction/upgrade.md"},n=e(`Replace ::with('balance') to ::with('wallet')
Replace CanBePaid to CanPay.
Replace CanBePaidFloat to CanPayFloat.
Replace calculateBalance to refreshBalance
Replace path bavix.wallet::transaction to Bavix\\Wallet\\Models\\Transaction::class
Replace path bavix.wallet::transfer to Bavix\\Wallet\\Models\\Transfer::class
Replace path bavix.wallet::wallet to Bavix\\Wallet\\Models\\Wallet::class
// old
-app('bavix.wallet::transaction');
-// new
-app(Bavix\\Wallet\\Models\\Transaction::class);Add the $quantity parameter to the canBuy method.
// old
-public function canBuy(Customer $customer, bool $force = false): bool
-// new
-public function canBuy(Customer $customer, int $quantity = 1, bool $force = false): boolAdd method getUniqueId to Interface Product
class Item extends Model implements Product
-{
-
- // Your method
-
- public function getUniqueId(): string
- {
- return (string)$this->getKey();
- }
-
-}Replace Taxing to Taxable.
If you are using php 7.1, then version 4.0 is not available to you. You need to update php.
Removed support for older versions of laravel/cashier. We support 7+.
You must add the argument Customer $customer to the getAmountProduct method of your model.
Your code on 3.x:
public function getAmountProduct(): int
- {
- return $this->price;
- }Your code on 4.x:
public function getAmountProduct(Customer $customer): int
- {
- return $this->price;
- }By updating the library from 4.x to 5.x you lose strong typing. This solution was necessary to support APM (Arbitrary Precision Mathematics).
In your goods:
Your code on 4.x:
public function getAmountProduct(Customer $customer): int { ... }
-
- public function getFeePercent(): float { ... }
-
- public function getMinimalFee(): int { ... }Your code on 5.x:
public function getAmountProduct(Customer $customer) { ... }
-
- public function getFeePercent() { ... }
-
- public function getMinimalFee() { ... }In the exchange rate processing service:
Your code on 4.x:
protected function rate(Wallet $wallet): float { ... }
-
- public function convertTo(Wallet $wallet): float { ... }Your code on 5.x:
protected function rate(Wallet $wallet) { ... }
-
- public function convertTo(Wallet $wallet) { ... }Go to config/wallet.php file (if you have it) and edit it.
Removing unnecessary code.
$bcLoaded = extension_loaded('bcmath');
-$mathClass = Math::class;
-switch (true) {
- case class_exists(BigDecimal::class):
- $mathClass = BrickMath::class;
- break;
- case $bcLoaded:
- $mathClass = BCMath::class;
- break;
-}Replace your math class ($mathClass) with brick/math.
Your code on 5.x:
'mathable' => $mathClass,Your code on 6.x:
'mathable' => BrickMath::class,You need to update to the latest version for all migrations to appear.
Update config/wallet.php
The config/wallet.php config has changed a lot, if you have it in your project, then replace it run.
php artisan vendor:publish --tag=laravel-wallet-config --forceThen return your settings. The package configuration has changed globally and there is no point in describing each key 🔑
UUID for wallet
The uuid field has been added to the wallet table, which is now actively used. If you have a highload, then I recommend that you add the field yourself and mark the migration (UpdateWalletsUuidTable) completed. If you have mysql, it is better to do this via pt-online-schema-change.
If you have a small project and a small wallet base, then the migration will be applied automatically.
That's it, you can use all 7.x functions to the fullest. The contract did not change globally, added more stringency and toned down the performance of the package. On a basket of 150 products, the acceleration is a whopping 24x.
All changes can be found in the pull request. The kernel has changed globally, I would not recommend switching to version 7.0.0 at the very beginning, there may be bugs. I advise you should at least 7.0.1.
Nothing needs to be done.
Replace getAvailableBalance to getAvailableBalanceAttribute (method) or available_balance (property).
Cart methods now support fluent-dto. It is necessary to replace the old code with a new one, for example:
// old
-$cart = app(\\Bavix\\Wallet\\Objects\\Cart::class)
- ->addItems($products)
- ->addItem($product)
- ->setMeta(['hello' => 'world']);
-
-$cart->addItem($product);
-
-// new. fluent
-$cart = app(\\Bavix\\Wallet\\Objects\\Cart::class)
- ->withItems($products)
- ->withItem($product)
- ->withMeta(['hello' => 'world']);
-
-$cart = $cart->withItem($product);The logic of storing transfers between accounts has changed. Previously, money could be credited to the user directly, but starting from version nine, all transactions go strictly between wallets. Thanks to this approach, finally, there will be full-fledged work with uuid identifiers in the project.
To migrate to the correct structure, you need to run the command:
artisan bx:transfer:fixIf the command fails, then the command must be restarted. Continue until the command starts executing immediately (no bad entries left).
The product has been divided into two interfaces:
ProductLimitedInterface. Needed to create limited goods;ProductInterface. Needed for an infinite number of products;The old Product interface should be replaced with one of these.
Replace Bavix\\Wallet\\Interfaces\\Product to Bavix\\Wallet\\Interfaces\\ProductLimitedInterface.
from_type, to_type in the transfers table have been physically removed. Make sure you don't use them;extra column has been added to the transfers table. Don't forget to apply all new migrations;Bavix\\Wallet\\Interfaces\\Wallet contract has been extended with the receivedTransfers method. If you overridden the implementation, then implement the new method;You can create an unlimited number of wallets, but the slug for each wallet should be unique.
Add the HasWallets trait's and Wallet interface to model.
use Bavix\\Wallet\\Traits\\HasWallets;
-use Bavix\\Wallet\\Interfaces\\Wallet;
-
-class User extends Model implements Wallet
-{
- use HasWallets;
-}Find user:
$user = User::first();Create a new wallet.
$user->hasWallet('my-wallet'); // bool(false)
-$wallet = $user->createWallet([
- 'name' => 'New Wallet',
- 'slug' => 'my-wallet',
-]);
-
-$user->hasWallet('my-wallet'); // bool(true)
-
-$wallet->deposit(100);
-$wallet->balance; // 100
-$wallet->balanceFloatNum; // 1.00$myWallet = $user->getWallet('my-wallet');
-$myWallet->balance; // 100
-$myWallet->balanceFloatNum; // 1.00Is it possible to use the default wallet and multi-wallets at the same time? Yes.
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Traits\\HasWallets;
-use Bavix\\Wallet\\Interfaces\\Wallet;
-
-class User extends Model implements Wallet
-{
- use HasWallet, HasWallets;
-}How to get the default wallet?
$wallet = $user->wallet;
-$wallet->balance; // 10
-$wallet->balanceFloatNum; // 0.10It's simple!
`,18),n=[e];function h(p,k,d,r,E,g){return a(),i("div",null,n)}const o=s(t,[["render",h]]);export{c as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_multi_new-wallet.md.DLsWaElB.lean.js b/docs/.vitepress/dist/assets/guide_multi_new-wallet.md.DLsWaElB.lean.js deleted file mode 100644 index ac80db75f..000000000 --- a/docs/.vitepress/dist/assets/guide_multi_new-wallet.md.DLsWaElB.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as l}from"./chunks/framework.OdeEVNy0.js";const c=JSON.parse('{"title":"New Wallet","description":"","frontmatter":{},"headers":[],"relativePath":"guide/multi/new-wallet.md","filePath":"guide/multi/new-wallet.md"}'),t={name:"guide/multi/new-wallet.md"},e=l("",18),n=[e];function h(p,k,d,r,E,g){return a(),i("div",null,n)}const o=s(t,[["render",h]]);export{c as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_multi_transaction-filter.md.MMWDhaAo.js b/docs/.vitepress/dist/assets/guide_multi_transaction-filter.md.MMWDhaAo.js deleted file mode 100644 index f2ee55e07..000000000 --- a/docs/.vitepress/dist/assets/guide_multi_transaction-filter.md.MMWDhaAo.js +++ /dev/null @@ -1,28 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const F=JSON.parse('{"title":"Transaction Filter","description":"","frontmatter":{},"headers":[],"relativePath":"guide/multi/transaction-filter.md","filePath":"guide/multi/transaction-filter.md"}'),t={name:"guide/multi/transaction-filter.md"},h=n(`Often developers ask me about the transactions method. Yes, this method displays ALL transactions for the wallet owner. If you only need to filter one wallet at a time, now you can use the walletTransactions method.
/** @var \\Bavix\\Wallet\\Models\\Wallet $wallet */
-
-$query = $wallet->walletTransactions();Let's take a look at a livelier code example:
$user->transactions()->count(); // 0
-
-// Multi wallets and default wallet can be used together
-// default wallet
-$user->deposit(100);
-$user->wallet->deposit(200);
-$user->wallet->withdraw(1);
-
-// usd
-$usd = $user->createWallet(['name' => 'USD']);
-$usd->deposit(100);
-
-// eur
-$eur = $user->createWallet(['name' => 'EUR']);
-$eur->deposit(100);
-
-$user->transactions()->count(); // 5
-$user->wallet->transactions()->count(); // 5
-$usd->transactions()->count(); // 5
-$eur->transactions()->count(); // 5
-// the transactions method returns data relative to the owner of the wallet, for all transactions
-
-$user->walletTransactions()->count(); // 3. we get the default wallet
-$user->wallet->walletTransactions()->count(); // 3
-$usd->walletTransactions()->count(); // 1
-$eur->walletTransactions()->count(); // 1It's simple!
`,6),l=[h];function k(p,e,r,E,d,g){return a(),i("div",null,l)}const c=s(t,[["render",k]]);export{F as __pageData,c as default}; diff --git a/docs/.vitepress/dist/assets/guide_multi_transaction-filter.md.MMWDhaAo.lean.js b/docs/.vitepress/dist/assets/guide_multi_transaction-filter.md.MMWDhaAo.lean.js deleted file mode 100644 index d3321e35d..000000000 --- a/docs/.vitepress/dist/assets/guide_multi_transaction-filter.md.MMWDhaAo.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const F=JSON.parse('{"title":"Transaction Filter","description":"","frontmatter":{},"headers":[],"relativePath":"guide/multi/transaction-filter.md","filePath":"guide/multi/transaction-filter.md"}'),t={name:"guide/multi/transaction-filter.md"},h=n("",6),l=[h];function k(p,e,r,E,d,g){return a(),i("div",null,l)}const c=s(t,[["render",k]]);export{F as __pageData,c as default}; diff --git a/docs/.vitepress/dist/assets/guide_multi_transfer.md.I6fyOpJ7.js b/docs/.vitepress/dist/assets/guide_multi_transfer.md.I6fyOpJ7.js deleted file mode 100644 index 17289c39c..000000000 --- a/docs/.vitepress/dist/assets/guide_multi_transfer.md.I6fyOpJ7.js +++ /dev/null @@ -1,36 +0,0 @@ -import{_ as s,c as i,o as a,a3 as t}from"./chunks/framework.OdeEVNy0.js";const c=JSON.parse('{"title":"Transfer between wallets","description":"","frontmatter":{},"headers":[],"relativePath":"guide/multi/transfer.md","filePath":"guide/multi/transfer.md"}'),n={name:"guide/multi/transfer.md"},h=t(`Transfer in our system are two well-known Deposit and Withdraw operations that are performed in one transaction.
The transfer takes place between wallets.
Prepare the model, add the HasWallets trait's and Wallet interface.
use Bavix\\Wallet\\Traits\\HasWallets;
-use Bavix\\Wallet\\Interfaces\\Wallet;
-
-class User extends Model implements Wallet
-{
- use HasWallets;
-}Find user:
$first = User::first();
-$last = User::orderBy('id', 'desc')->first(); // last user
-$first->getKey() !== $last->getKey(); // trueCreate new wallets for users.
$firstWallet = $first->createWallet(['name' => 'First User Wallet']);
-$lastWallet = $last->createWallet(['name' => 'Second User Wallet']);
-
-$firstWallet->deposit(100);
-$firstWallet->balance; // 100
-$lastWallet->balance; // 0The transfer will be from the first user to the last.
$firstWallet->transfer($lastWallet, 5);
-$firstWallet->balance; // 95
-$lastWallet->balance; // 5It's simple!
Check the user's balance.
$firstWallet->balance; // 100
-$lastWallet->balance; // 0The transfer will be from the first user to the second.
$firstWallet->forceTransfer($lastWallet, 500);
-$firstWallet->balance; // -400
-$lastWallet->balance; // 500It worked!
Check the user's balance.
$firstWallet->balanceInt; // 1_000
-$secondWallet->balanceInt; // 0We will execute the transfer, but without confirmation of the withdrawal of funds.
use Bavix\\Wallet\\External\\Dto\\Extra;
-use Bavix\\Wallet\\External\\Dto\\Option;
-
-/** @var $firstWallet \\Bavix\\Wallet\\Interfaces\\Wallet */
-$transfer = $firstWallet->transfer($secondWallet, 500, new Extra(
- deposit: ['message' => 'Hello, secondWallet!'],
- withdraw: new Option(meta: ['something' => 'anything'], confirmed: false)
-));
-
-$transfer->withdraw->meta; // ['something' => 'anything']
-$transfer->withdraw->confirmed; // false
-
-$transfer->deposit->meta; // ['message' => 'Hello, secondWallet!']
-$transfer->deposit->confirmed; // true
-
-$firstWallet->balanceInt; // 1_000
-$secondWallet->balanceInt; // 500It's simple!
`,26),l=[h];function e(p,k,r,E,d,g){return a(),i("div",null,l)}const o=s(n,[["render",e]]);export{c as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_multi_transfer.md.I6fyOpJ7.lean.js b/docs/.vitepress/dist/assets/guide_multi_transfer.md.I6fyOpJ7.lean.js deleted file mode 100644 index 7d77fa7d3..000000000 --- a/docs/.vitepress/dist/assets/guide_multi_transfer.md.I6fyOpJ7.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as t}from"./chunks/framework.OdeEVNy0.js";const c=JSON.parse('{"title":"Transfer between wallets","description":"","frontmatter":{},"headers":[],"relativePath":"guide/multi/transfer.md","filePath":"guide/multi/transfer.md"}'),n={name:"guide/multi/transfer.md"},h=t("",26),l=[h];function e(p,k,r,E,d,g){return a(),i("div",null,l)}const o=s(n,[["render",e]]);export{c as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_purchases_cart.md.BQuTJc6v.js b/docs/.vitepress/dist/assets/guide_purchases_cart.md.BQuTJc6v.js deleted file mode 100644 index 5cc4666eb..000000000 --- a/docs/.vitepress/dist/assets/guide_purchases_cart.md.BQuTJc6v.js +++ /dev/null @@ -1,86 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const c=JSON.parse('{"title":"Cart","description":"","frontmatter":{},"headers":[],"relativePath":"guide/purchases/cart.md","filePath":"guide/purchases/cart.md"}'),h={name:"guide/purchases/cart.md"},t=n(`Buying goods one at a time is, of course, good. But it’s more convenient to buy in a pack, right? In laravel wallet you can buy a basket of goods at once.
Add the CanPay trait and Customer interface to your User model.
The trait
CanPayalready inheritsHasWallet, reuse will cause an error.
use Bavix\\Wallet\\Traits\\CanPay;
-use Bavix\\Wallet\\Interfaces\\Customer;
-
-class User extends Model implements Customer
-{
- use CanPay;
-}Add the HasWallet trait and interface to Item model.
Starting from version 9.x there are two product interfaces:
ProductInterface);ProductLimitedInterface);An example with an unlimited number of products:
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Customer;
-use Bavix\\Wallet\\Interfaces\\ProductInterface;
-
-class Item extends Model implements ProductInterface
-{
- use HasWallet;
-
- public function getAmountProduct(Customer $customer): int|string
- {
- return round($this->price * 100);
- }
-
- public function getMetaProduct(): ?array
- {
- return [
- 'title' => $this->title,
- 'description' => 'Purchase of Product #' . $this->id,
- ];
- }
-}Example with a limited number of products:
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Customer;
-use Bavix\\Wallet\\Interfaces\\ProductLimitedInterface;
-
-class Item extends Model implements ProductLimitedInterface
-{
- use HasWallet;
-
- public function canBuy(Customer $customer, int $quantity = 1, bool $force = false): bool
- {
- /**
- * This is where you implement the constraint logic.
- *
- * If the service can be purchased once, then
- * return !$customer->paid($this);
- */
- return true;
- }
-
- public function getAmountProduct(Customer $customer): int|string
- {
- return round($this->price * 100);
- }
-
- public function getMetaProduct(): ?array
- {
- return [
- 'title' => $this->title,
- 'description' => 'Purchase of Product #' . $this->id,
- ];
- }
-}I do not recommend using the limited interface when working with a shopping cart. If you are working with a shopping cart, then you should override the PurchaseServiceInterface interface. With it, you can check the availability of all products with one request, there will be no N-queries in the database.
Find the user and check the balance.
$user = User::first();
-$user->balance; // 0Let's start shopping.
use Bavix\\Wallet\\Objects\\Cart;
-
-$list = [
- 'potato' => 3,
- 'carrot' => 10,
-];
-
-$products = Item::query()
- ->whereIn('slug', ['potato', 'carrot'])
- ->get();
-
-$cart = app(Cart::class);
-foreach ($products as $product) {
- $cart = $cart->withItem($product, quantity: $list[$product->slug]);
-}
-
-$cartTotal = $cart->getTotal($user); // 15127
-$user->deposit($cartTotal);
-$user->balanceInt; // 15127
-$user->balanceFloat; // 151.27
-
-$cart = $cart->withItem(current($products), pricePerItem: 500); // 15127+500
-$user->deposit(500);
-$user->balanceInt; // 15627
-$user->balanceFloat; // 156.27
-
-(bool)$user->payCart($cart); // true
-$user->balanceFloat; // 0It's simple!
`,21),l=[t];function k(p,e,r,d,E,g){return a(),i("div",null,l)}const F=s(h,[["render",k]]);export{c as __pageData,F as default}; diff --git a/docs/.vitepress/dist/assets/guide_purchases_cart.md.BQuTJc6v.lean.js b/docs/.vitepress/dist/assets/guide_purchases_cart.md.BQuTJc6v.lean.js deleted file mode 100644 index 9e5b4d742..000000000 --- a/docs/.vitepress/dist/assets/guide_purchases_cart.md.BQuTJc6v.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const c=JSON.parse('{"title":"Cart","description":"","frontmatter":{},"headers":[],"relativePath":"guide/purchases/cart.md","filePath":"guide/purchases/cart.md"}'),h={name:"guide/purchases/cart.md"},t=n("",21),l=[t];function k(p,e,r,d,E,g){return a(),i("div",null,l)}const F=s(h,[["render",k]]);export{c as __pageData,F as default}; diff --git a/docs/.vitepress/dist/assets/guide_purchases_commissions.md.CMGOeeZc.js b/docs/.vitepress/dist/assets/guide_purchases_commissions.md.CMGOeeZc.js deleted file mode 100644 index 91d8b6cbe..000000000 --- a/docs/.vitepress/dist/assets/guide_purchases_commissions.md.CMGOeeZc.js +++ /dev/null @@ -1,82 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const y=JSON.parse('{"title":"Commissions","description":"","frontmatter":{},"headers":[],"relativePath":"guide/purchases/commissions.md","filePath":"guide/purchases/commissions.md"}'),h={name:"guide/purchases/commissions.md"},t=n(`Commissions are part of purchasing goods. The commission is debited from the buyer's account and is not credited for the product. This amount is lost along the way. The commission amount can always be found in the fee column.
Add the CanPay trait and Customer interface to your User model.
The trait
CanPayalready inheritsHasWallet, reuse will cause an error.
use Bavix\\Wallet\\Traits\\CanPay;
-use Bavix\\Wallet\\Interfaces\\Customer;
-
-class User extends Model implements Customer
-{
- use CanPay;
-}Add the HasWallet trait and ProductInterface (or ProductLimitedInterface) interface to Item model.
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Customer;
-use Bavix\\Wallet\\Interfaces\\Taxable;
-use Bavix\\Wallet\\Interfaces\\ProductLimitedInterface;
-
-class Item extends Model implements ProductLimitedInterface, Taxable
-{
- use HasWallet;
-
- public function canBuy(Customer $customer, int $quantity = 1, bool $force = false): bool
- {
- /**
- * If the service can be purchased once, then
- * return !$customer->paid($this);
- */
- return true;
- }
-
- public function getAmountProduct(Customer $customer): int|string
- {
- return 100;
- }
-
- public function getMetaProduct(): ?array
- {
- return [
- 'title' => $this->title,
- 'description' => 'Purchase of Product #' . $this->id,
- ];
- }
-
- public function getFeePercent()
- {
- return 0.03; // 3%
- }
-}Find the user and check the balance.
$user = User::first();
-$user->balance; // 103Find the goods and check the cost.
$item = Item::first();
-$item->getAmountProduct($user); // 100The user can buy a product, buy...
$user->pay($item); // success, 100 (product) + 3 (fee) = 103
-$user->balance; // 0Add interface MinimalTaxable (or MaximalTaxable) in class Item.
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Customer;
-use Bavix\\Wallet\\Interfaces\\MinimalTaxable;
-use Bavix\\Wallet\\Interfaces\\ProductInterface;
-
-class Item extends Model implements ProductInterface, MinimalTaxable
-{
- use HasWallet;
-
- public function getAmountProduct(Customer $customer): int|string
- {
- return 100;
- }
-
- public function getMetaProduct(): ?array
- {
- return [
- 'title' => $this->title,
- 'description' => 'Purchase of Product #' . $this->id,
- ];
- }
-
- public function getFeePercent()
- {
- return 0.03; // 3%
- }
-
- public function getMinimalFee()
- {
- return 5; // 3%, minimum 5
- }
-}Find the user and check the balance.
$user = User::first();
-$user->balance; // 105Find the goods and check the cost.
$item = Item::first();
-$item->getAmountProduct($user); // 100The user can buy a product, buy...
$user->pay($item); // success, 100 (product) + 5 (minimal fee) = 105
-$user->balance; // 0Find the user and check the balance.
$user = User::first();
-$user->balance; // 103Find the goods and check the cost.
$item = Item::first();
-$item->getAmountProduct($user); // 100The user can buy a product, buy...
$user->safePay($item); // failed, 100 (product) + 5 (minimal fee) = 105
-$user->balance; // 103It's simple!
`,34),l=[t];function p(e,k,d,r,E,g){return a(),i("div",null,l)}const o=s(h,[["render",p]]);export{y as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_purchases_commissions.md.CMGOeeZc.lean.js b/docs/.vitepress/dist/assets/guide_purchases_commissions.md.CMGOeeZc.lean.js deleted file mode 100644 index cd5933970..000000000 --- a/docs/.vitepress/dist/assets/guide_purchases_commissions.md.CMGOeeZc.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const y=JSON.parse('{"title":"Commissions","description":"","frontmatter":{},"headers":[],"relativePath":"guide/purchases/commissions.md","filePath":"guide/purchases/commissions.md"}'),h={name:"guide/purchases/commissions.md"},t=n("",34),l=[t];function p(e,k,d,r,E,g){return a(),i("div",null,l)}const o=s(h,[["render",p]]);export{y as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_purchases_gift.md.C_bxgDhS.js b/docs/.vitepress/dist/assets/guide_purchases_gift.md.C_bxgDhS.js deleted file mode 100644 index 9bd698fb1..000000000 --- a/docs/.vitepress/dist/assets/guide_purchases_gift.md.C_bxgDhS.js +++ /dev/null @@ -1,69 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const c=JSON.parse('{"title":"Gift","description":"","frontmatter":{},"headers":[],"relativePath":"guide/purchases/gift.md","filePath":"guide/purchases/gift.md"}'),t={name:"guide/purchases/gift.md"},h=n(`Gifts are a purchase with someone else's wallet attached. The peculiarity of gifts is that when the gift is returned, the money is returned to the person who bought it, and not to the person to whom it was given. This functionality is usually used to reward users by the administration.
Add the CanPay trait and Customer interface to your User model.
The trait
CanPayalready inheritsHasWallet, reuse will cause an error.
use Bavix\\Wallet\\Traits\\CanPay;
-use Bavix\\Wallet\\Interfaces\\Customer;
-
-class User extends Model implements Customer
-{
- use CanPay;
-}Add the HasWallet trait and interface to Item model.
Starting from version 9.x there are two product interfaces:
ProductInterface);ProductLimitedInterface);An example with an unlimited number of products:
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Customer;
-use Bavix\\Wallet\\Interfaces\\ProductInterface;
-
-class Item extends Model implements ProductInterface
-{
- use HasWallet;
-
- public function getAmountProduct(Customer $customer): int|string
- {
- return 100;
- }
-
- public function getMetaProduct(): ?array
- {
- return [
- 'title' => $this->title,
- 'description' => 'Purchase of Product #' . $this->id,
- ];
- }
-}Example with a limited number of products:
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Customer;
-use Bavix\\Wallet\\Interfaces\\ProductLimitedInterface;
-
-class Item extends Model implements ProductLimitedInterface
-{
- use HasWallet;
-
- public function canBuy(Customer $customer, int $quantity = 1, bool $force = false): bool
- {
- /**
- * This is where you implement the constraint logic.
- *
- * If the service can be purchased once, then
- * return !$customer->paid($this);
- */
- return true;
- }
-
- public function getAmountProduct(Customer $customer): int|string
- {
- return 100;
- }
-
- public function getMetaProduct(): ?array
- {
- return [
- 'title' => $this->title,
- 'description' => 'Purchase of Product #' . $this->id,
- ];
- }
-}I do not recommend using the limited interface when working with a shopping cart. If you are working with a shopping cart, then you should override the PurchaseServiceInterface interface. With it, you can check the availability of all products with one request, there will be no N-queries in the database.
Find the user's and check the balance.
$first = User::first();
-$last = User::orderBy('id', 'desc')->first(); // last user
-$first->getKey() !== $last->getKey(); // true
-
-$first->balance; // 115
-$last->balance; // 0One user wants to give a gift to another. Find the product.
$item = Item::first();
-$item->getAmountProduct($first); // 100
-$item->balance; // 0The first user buys the product and gives it.
If the product uses the
Taxableinterface, then Santa will pay tax
$first->gift($last, $item);
-(bool)$last->paid($item, true); // bool(true)
-$first->balance; // 15
-$last->balance; // 0
-$item->balance; // 100It's simple!
`,24),l=[h];function p(e,k,r,d,E,g){return a(),i("div",null,l)}const o=s(t,[["render",p]]);export{c as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_purchases_gift.md.C_bxgDhS.lean.js b/docs/.vitepress/dist/assets/guide_purchases_gift.md.C_bxgDhS.lean.js deleted file mode 100644 index f5552b6fa..000000000 --- a/docs/.vitepress/dist/assets/guide_purchases_gift.md.C_bxgDhS.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const c=JSON.parse('{"title":"Gift","description":"","frontmatter":{},"headers":[],"relativePath":"guide/purchases/gift.md","filePath":"guide/purchases/gift.md"}'),t={name:"guide/purchases/gift.md"},h=n("",24),l=[h];function p(e,k,r,d,E,g){return a(),i("div",null,l)}const o=s(t,[["render",p]]);export{c as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_purchases_payment-free.md.Orz9kaX-.js b/docs/.vitepress/dist/assets/guide_purchases_payment-free.md.Orz9kaX-.js deleted file mode 100644 index bfd6bec98..000000000 --- a/docs/.vitepress/dist/assets/guide_purchases_payment-free.md.Orz9kaX-.js +++ /dev/null @@ -1,64 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const y=JSON.parse('{"title":"Payment Free","description":"","frontmatter":{},"headers":[],"relativePath":"guide/purchases/payment-free.md","filePath":"guide/purchases/payment-free.md"}'),t={name:"guide/purchases/payment-free.md"},h=n(`Payments as part of e-commerce are an important part. This section is about payment for goods.
Add the CanPay trait and Customer interface to your User model.
The trait
CanPayalready inheritsHasWallet, reuse will cause an error.
use Bavix\\Wallet\\Traits\\CanPay;
-use Bavix\\Wallet\\Interfaces\\Customer;
-
-class User extends Model implements Customer
-{
- use CanPay;
-}Add the HasWallet trait and interface to Item model.
Starting from version 9.x there are two product interfaces:
ProductInterface);ProductLimitedInterface);An example with an unlimited number of products:
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Customer;
-use Bavix\\Wallet\\Interfaces\\ProductInterface;
-
-class Item extends Model implements ProductInterface
-{
- use HasWallet;
-
- public function getAmountProduct(Customer $customer): int|string
- {
- return 100;
- }
-
- public function getMetaProduct(): ?array
- {
- return [
- 'title' => $this->title,
- 'description' => 'Purchase of Product #' . $this->id,
- ];
- }
-}Example with a limited number of products:
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Customer;
-use Bavix\\Wallet\\Interfaces\\ProductLimitedInterface;
-
-class Item extends Model implements ProductLimitedInterface
-{
- use HasWallet;
-
- public function canBuy(Customer $customer, int $quantity = 1, bool $force = false): bool
- {
- /**
- * This is where you implement the constraint logic.
- *
- * If the service can be purchased once, then
- * return !$customer->paid($this);
- */
- return true;
- }
-
- public function getAmountProduct(Customer $customer): int|string
- {
- return 100;
- }
-
- public function getMetaProduct(): ?array
- {
- return [
- 'title' => $this->title,
- 'description' => 'Purchase of Product #' . $this->id,
- ];
- }
-}I do not recommend using the limited interface when working with a shopping cart. If you are working with a shopping cart, then you should override the PurchaseServiceInterface interface. With it, you can check the availability of all products with one request, there will be no N-queries in the database.
Find the user and check the balance.
$user = User::first();
-$user->balance; // 100Find the goods and check the cost.
$item = Item::first();
-$item->getAmountProduct($user); // 100
-$item->balance; // 0Purchase!
$user->payFree($item);
-(bool)$user->paid($item); // bool(true)
-$user->balance; // 100
-$item->balance; // 0It's simple!
`,23),l=[h];function e(p,k,r,d,E,g){return a(),i("div",null,l)}const o=s(t,[["render",e]]);export{y as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_purchases_payment-free.md.Orz9kaX-.lean.js b/docs/.vitepress/dist/assets/guide_purchases_payment-free.md.Orz9kaX-.lean.js deleted file mode 100644 index 63c4c66ea..000000000 --- a/docs/.vitepress/dist/assets/guide_purchases_payment-free.md.Orz9kaX-.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const y=JSON.parse('{"title":"Payment Free","description":"","frontmatter":{},"headers":[],"relativePath":"guide/purchases/payment-free.md","filePath":"guide/purchases/payment-free.md"}'),t={name:"guide/purchases/payment-free.md"},h=n("",23),l=[h];function e(p,k,r,d,E,g){return a(),i("div",null,l)}const o=s(t,[["render",e]]);export{y as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_purchases_payment.md.CzAQICFL.js b/docs/.vitepress/dist/assets/guide_purchases_payment.md.CzAQICFL.js deleted file mode 100644 index b6a8880fe..000000000 --- a/docs/.vitepress/dist/assets/guide_purchases_payment.md.CzAQICFL.js +++ /dev/null @@ -1,65 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const o=JSON.parse('{"title":"Payment","description":"","frontmatter":{},"headers":[],"relativePath":"guide/purchases/payment.md","filePath":"guide/purchases/payment.md"}'),t={name:"guide/purchases/payment.md"},h=n(`Payments as part of e-commerce are an important part. This section is about payment for goods.
Add the CanPay trait and Customer interface to your User model.
The trait
CanPayalready inheritsHasWallet, reuse will cause an error.
use Bavix\\Wallet\\Traits\\CanPay;
-use Bavix\\Wallet\\Interfaces\\Customer;
-
-class User extends Model implements Customer
-{
- use CanPay;
-}Add the HasWallet trait and interface to Item model.
Starting from version 9.x there are two product interfaces:
ProductInterface);ProductLimitedInterface);An example with an unlimited number of products:
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Customer;
-use Bavix\\Wallet\\Interfaces\\ProductInterface;
-
-class Item extends Model implements ProductInterface
-{
- use HasWallet;
-
- public function getAmountProduct(Customer $customer): int|string
- {
- return 100;
- }
-
- public function getMetaProduct(): ?array
- {
- return [
- 'title' => $this->title,
- 'description' => 'Purchase of Product #' . $this->id,
- ];
- }
-}Example with a limited number of products:
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Customer;
-use Bavix\\Wallet\\Interfaces\\ProductLimitedInterface;
-
-class Item extends Model implements ProductLimitedInterface
-{
- use HasWallet;
-
- public function canBuy(Customer $customer, int $quantity = 1, bool $force = false): bool
- {
- /**
- * This is where you implement the constraint logic.
- *
- * If the service can be purchased once, then
- * return !$customer->paid($this);
- */
- return true;
- }
-
- public function getAmountProduct(Customer $customer): int|string
- {
- return 100;
- }
-
- public function getMetaProduct(): ?array
- {
- return [
- 'title' => $this->title,
- 'description' => 'Purchase of Product #' . $this->id,
- ];
- }
-}I do not recommend using the limited interface when working with a shopping cart. If you are working with a shopping cart, then you should override the PurchaseServiceInterface interface. With it, you can check the availability of all products with one request, there will be no N-queries in the database.
Find the user and check the balance.
$user = User::first();
-$user->balance; // 100Find the goods and check the cost.
$item = Item::first();
-$item->getAmountProduct($user); // 100The user can buy a product, buy...
$user->pay($item);
-$user->balance; // 0What happens if the user does not have the funds? The same as with the withdrawal.
$user->balance; // 0
-$user->pay($item);
-// throw an exceptionThe question arises, how do you know that the product is purchased?
(bool)$user->paid($item); // bool(true)To not write try and catch use safePay method.
if ($user->safePay($item)) {
- // try to buy again )
-}It's simple!
`,30),e=[h];function p(l,k,r,d,E,g){return a(),i("div",null,e)}const y=s(t,[["render",p]]);export{o as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_purchases_payment.md.CzAQICFL.lean.js b/docs/.vitepress/dist/assets/guide_purchases_payment.md.CzAQICFL.lean.js deleted file mode 100644 index 5ebd1d25b..000000000 --- a/docs/.vitepress/dist/assets/guide_purchases_payment.md.CzAQICFL.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const o=JSON.parse('{"title":"Payment","description":"","frontmatter":{},"headers":[],"relativePath":"guide/purchases/payment.md","filePath":"guide/purchases/payment.md"}'),t={name:"guide/purchases/payment.md"},h=n("",30),e=[h];function p(l,k,r,d,E,g){return a(),i("div",null,e)}const y=s(t,[["render",p]]);export{o as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_purchases_receiving.md.CCQHkWGv.js b/docs/.vitepress/dist/assets/guide_purchases_receiving.md.CCQHkWGv.js deleted file mode 100644 index 684eb39d8..000000000 --- a/docs/.vitepress/dist/assets/guide_purchases_receiving.md.CCQHkWGv.js +++ /dev/null @@ -1,70 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const y=JSON.parse('{"title":"Payment. Customize receiving","description":"","frontmatter":{},"headers":[],"relativePath":"guide/purchases/receiving.md","filePath":"guide/purchases/receiving.md"}'),t={name:"guide/purchases/receiving.md"},h=n(`The architecture of laravel wallet is designed in such a way that when purchasing goods, wallets are created and all money is credited to them, but it happens that this is not necessary. In this case, this functionality will help. You specify the wallet for depositing funds and the buyer will transfer money to this wallet when purchasing a product. This is convenient for marketplaces.
Add the CanPay trait and Customer interface to your User model.
The trait
CanPayalready inheritsHasWallet, reuse will cause an error.
use Bavix\\Wallet\\Traits\\CanPay;
-use Bavix\\Wallet\\Interfaces\\Customer;
-
-class User extends Model implements Customer
-{
- use CanPay;
-}Add the HasWallet trait and interface to Item model. If we want to achieve multi wallets for a product, then we need to add HasWallets.
Starting from version 9.x there are two product interfaces:
ProductInterface);ProductLimitedInterface);An example with an unlimited number of products:
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Traits\\HasWallets;
-use Bavix\\Wallet\\Interfaces\\Customer;
-use Bavix\\Wallet\\Interfaces\\ProductInterface;
-
-class Item extends Model implements ProductInterface
-{
- use HasWallet, HasWallets;
-
- public function getAmountProduct(Customer $customer): int|string
- {
- return 100;
- }
-
- public function getMetaProduct(): ?array
- {
- return [
- 'title' => $this->title,
- 'description' => 'Purchase of Product #' . $this->id,
- ];
- }
-}Example with a limited number of products:
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Traits\\HasWallets;
-use Bavix\\Wallet\\Interfaces\\Customer;
-use Bavix\\Wallet\\Interfaces\\ProductLimitedInterface;
-
-class Item extends Model implements ProductLimitedInterface
-{
- use HasWallet, HasWallets;
-
- public function canBuy(Customer $customer, int $quantity = 1, bool $force = false): bool
- {
- return true;
- }
-
- public function getAmountProduct(Customer $customer): int|string
- {
- return 100;
- }
-
- public function getMetaProduct(): ?array
- {
- return [
- 'title' => $this->title,
- 'description' => 'Purchase of Product #' . $this->id,
- ];
- }
-}I do not recommend using the limited interface when working with a shopping cart. If you are working with a shopping cart, then you should override the PurchaseServiceInterface interface. With it, you can check the availability of all products with one request, there will be no N-queries in the database.
Find the user and check the balance.
$user = User::first();
-$user->balance; // 100Find the goods and check the cost.
$item = Item::first();
-$item->getAmountProduct($user); // 100
-
-$receiving = $item->createWallet([
- 'name' => 'Dollar',
- 'meta' => [
- 'currency' => 'USD',
- ],
-]);The user can buy a product, buy...
$cart = app(Cart::class)
- ->withItem($item, receiving: $receiving)
-;
-
-$user->payCart($cart);
-$user->balance; // 0
-
-$receiving->balanceInt; // $100It's simple!
`,23),l=[h];function e(p,k,r,d,E,g){return a(),i("div",null,l)}const o=s(t,[["render",e]]);export{y as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_purchases_receiving.md.CCQHkWGv.lean.js b/docs/.vitepress/dist/assets/guide_purchases_receiving.md.CCQHkWGv.lean.js deleted file mode 100644 index e574868a3..000000000 --- a/docs/.vitepress/dist/assets/guide_purchases_receiving.md.CCQHkWGv.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const y=JSON.parse('{"title":"Payment. Customize receiving","description":"","frontmatter":{},"headers":[],"relativePath":"guide/purchases/receiving.md","filePath":"guide/purchases/receiving.md"}'),t={name:"guide/purchases/receiving.md"},h=n("",23),l=[h];function e(p,k,r,d,E,g){return a(),i("div",null,l)}const o=s(t,[["render",e]]);export{y as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_purchases_refund.md.C91GQMAb.js b/docs/.vitepress/dist/assets/guide_purchases_refund.md.C91GQMAb.js deleted file mode 100644 index c9d921878..000000000 --- a/docs/.vitepress/dist/assets/guide_purchases_refund.md.C91GQMAb.js +++ /dev/null @@ -1,63 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const y=JSON.parse('{"title":"Refund","description":"","frontmatter":{},"headers":[],"relativePath":"guide/purchases/refund.md","filePath":"guide/purchases/refund.md"}'),t={name:"guide/purchases/refund.md"},h=n(`We already know how to buy, but what about returns? But they exist and you can use them.
Add the CanPay trait and Customer interface to your User model.
The trait
CanPayalready inheritsHasWallet, reuse will cause an error.
use Bavix\\Wallet\\Traits\\CanPay;
-use Bavix\\Wallet\\Interfaces\\Customer;
-
-class User extends Model implements Customer
-{
- use CanPay;
-}Add the HasWallet trait and interface to Item model.
Starting from version 9.x there are two product interfaces:
ProductInterface);ProductLimitedInterface);An example with an unlimited number of products:
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Customer;
-use Bavix\\Wallet\\Interfaces\\ProductInterface;
-
-class Item extends Model implements ProductInterface
-{
- use HasWallet;
-
- public function getAmountProduct(Customer $customer): int|string
- {
- return 100;
- }
-
- public function getMetaProduct(): ?array
- {
- return [
- 'title' => $this->title,
- 'description' => 'Purchase of Product #' . $this->id,
- ];
- }
-}Example with a limited number of products:
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Customer;
-use Bavix\\Wallet\\Interfaces\\ProductLimitedInterface;
-
-class Item extends Model implements ProductLimitedInterface
-{
- use HasWallet;
-
- public function canBuy(Customer $customer, int $quantity = 1, bool $force = false): bool
- {
- /**
- * This is where you implement the constraint logic.
- *
- * If the service can be purchased once, then
- * return !$customer->paid($this);
- */
- return true;
- }
-
- public function getAmountProduct(Customer $customer): int|string
- {
- return 100;
- }
-
- public function getMetaProduct(): ?array
- {
- return [
- 'title' => $this->title,
- 'description' => 'Purchase of Product #' . $this->id,
- ];
- }
-}I do not recommend using the limited interface when working with a shopping cart. If you are working with a shopping cart, then you should override the PurchaseServiceInterface interface. With it, you can check the availability of all products with one request, there will be no N-queries in the database.
Find the user and check the balance.
$user = User::first();
-$user->balance; // 0Find the goods and check the balance.
$item = Item::first();
-$item->balance; // 100Return of funds!
(bool)$user->paid($item); // bool(true)
-(bool)$user->refund($item); // bool(true)
-$item->balance; // 0
-$user->balance; // 100It's simple!
`,23),l=[h];function p(e,k,r,d,E,g){return a(),i("div",null,l)}const o=s(t,[["render",p]]);export{y as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_purchases_refund.md.C91GQMAb.lean.js b/docs/.vitepress/dist/assets/guide_purchases_refund.md.C91GQMAb.lean.js deleted file mode 100644 index c4ccb792d..000000000 --- a/docs/.vitepress/dist/assets/guide_purchases_refund.md.C91GQMAb.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const y=JSON.parse('{"title":"Refund","description":"","frontmatter":{},"headers":[],"relativePath":"guide/purchases/refund.md","filePath":"guide/purchases/refund.md"}'),t={name:"guide/purchases/refund.md"},h=n("",23),l=[h];function p(e,k,r,d,E,g){return a(),i("div",null,l)}const o=s(t,[["render",p]]);export{y as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_single_cancel.md.RROKg7vE.js b/docs/.vitepress/dist/assets/guide_single_cancel.md.RROKg7vE.js deleted file mode 100644 index e85832026..000000000 --- a/docs/.vitepress/dist/assets/guide_single_cancel.md.RROKg7vE.js +++ /dev/null @@ -1,17 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const g=JSON.parse('{"title":"Cancel Transaction","description":"","frontmatter":{},"headers":[],"relativePath":"guide/single/cancel.md","filePath":"guide/single/cancel.md"}'),e={name:"guide/single/cancel.md"},t=n(`Sometimes you need to cancel a confirmed transaction. For example, money was received or debited by mistake. You can reset the confirmation of a specific transaction.
Add the CanConfirm trait and Confirmable interface to your User model.
use Bavix\\Wallet\\Interfaces\\Confirmable;
-use Bavix\\Wallet\\Interfaces\\Wallet;
-use Bavix\\Wallet\\Traits\\CanConfirm;
-use Bavix\\Wallet\\Traits\\HasWallet;
-
-class UserConfirm extends Model implements Wallet, Confirmable
-{
- use HasWallet, CanConfirm;
-}You can only cancel the transaction with the wallet you paid with.
Created a transaction, and after resetting its confirmation.
$user->balance; // 0
-$transaction = $user->deposit(100); // confirmed transaction
-$transaction->confirmed; // bool(true)
-$user->balance; // 100
-
-$user->resetConfirm($transaction); // bool(true)
-$transaction->confirmed; // bool(false)
-
-$user->balance; // 0It's simple!
`,11),l=[t];function h(p,k,r,d,c,o){return a(),i("div",null,l)}const y=s(e,[["render",h]]);export{g as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_single_cancel.md.RROKg7vE.lean.js b/docs/.vitepress/dist/assets/guide_single_cancel.md.RROKg7vE.lean.js deleted file mode 100644 index ca71be429..000000000 --- a/docs/.vitepress/dist/assets/guide_single_cancel.md.RROKg7vE.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const g=JSON.parse('{"title":"Cancel Transaction","description":"","frontmatter":{},"headers":[],"relativePath":"guide/single/cancel.md","filePath":"guide/single/cancel.md"}'),e={name:"guide/single/cancel.md"},t=n("",11),l=[t];function h(p,k,r,d,c,o){return a(),i("div",null,l)}const y=s(e,[["render",h]]);export{g as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_single_confirm.md.C4zP6Jx7.js b/docs/.vitepress/dist/assets/guide_single_confirm.md.C4zP6Jx7.js deleted file mode 100644 index 6bf0ac8dc..000000000 --- a/docs/.vitepress/dist/assets/guide_single_confirm.md.C4zP6Jx7.js +++ /dev/null @@ -1,17 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const g=JSON.parse('{"title":"Confirm Transaction","description":"","frontmatter":{},"headers":[],"relativePath":"guide/single/confirm.md","filePath":"guide/single/confirm.md"}'),t={name:"guide/single/confirm.md"},e=n(`There are situations when it is necessary to create a transaction without crediting to the wallet or debiting. Laravel-wallet has such a mode of unconfirmed transactions.
You create a transaction without confirmation, and a little later you confirm it.
Add the CanConfirm trait and Confirmable interface to your User model.
use Bavix\\Wallet\\Interfaces\\Confirmable;
-use Bavix\\Wallet\\Interfaces\\Wallet;
-use Bavix\\Wallet\\Traits\\CanConfirm;
-use Bavix\\Wallet\\Traits\\HasWallet;
-
-class UserConfirm extends Model implements Wallet, Confirmable
-{
- use HasWallet, CanConfirm;
-}You can only confirm the transaction with the wallet you paid with.
Sometimes you need to create an operation and confirm its field. That is what this trey does.
$user->balance; // 0
-$transaction = $user->deposit(100, null, false); // not confirm
-$transaction->confirmed; // bool(false)
-$user->balance; // 0
-
-$user->confirm($transaction); // bool(true)
-$transaction->confirmed; // bool(true)
-
-$user->balance; // 100It's simple!
`,12),l=[e];function h(p,k,r,o,d,c){return a(),i("div",null,l)}const y=s(t,[["render",h]]);export{g as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_single_confirm.md.C4zP6Jx7.lean.js b/docs/.vitepress/dist/assets/guide_single_confirm.md.C4zP6Jx7.lean.js deleted file mode 100644 index d33bc816c..000000000 --- a/docs/.vitepress/dist/assets/guide_single_confirm.md.C4zP6Jx7.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const g=JSON.parse('{"title":"Confirm Transaction","description":"","frontmatter":{},"headers":[],"relativePath":"guide/single/confirm.md","filePath":"guide/single/confirm.md"}'),t={name:"guide/single/confirm.md"},e=n("",12),l=[e];function h(p,k,r,o,d,c){return a(),i("div",null,l)}const y=s(t,[["render",h]]);export{g as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_single_credit-limits.md.DlXxFDrQ.js b/docs/.vitepress/dist/assets/guide_single_credit-limits.md.DlXxFDrQ.js deleted file mode 100644 index a7764c37b..000000000 --- a/docs/.vitepress/dist/assets/guide_single_credit-limits.md.DlXxFDrQ.js +++ /dev/null @@ -1,18 +0,0 @@ -import{_ as s,c as i,o as a,a3 as t}from"./chunks/framework.OdeEVNy0.js";const y=JSON.parse('{"title":"Credit Limits","description":"","frontmatter":{},"headers":[],"relativePath":"guide/single/credit-limits.md","filePath":"guide/single/credit-limits.md"}'),n={name:"guide/single/credit-limits.md"},l=t(`If you need the ability to have wallets have a credit limit, then this functionality is for you.
The functionality does nothing, it only allows you not to use "force" for most of the operations within the credit limit. You should write the logic for collecting interest, notifications on debts, etc.
By default, the credit limit is zero.
An example of working with a credit limit:
/**
- * @var \\Bavix\\Wallet\\Interfaces\\Customer $customer
- * @var \\Bavix\\Wallet\\Models\\Wallet $wallet
- * @var \\Bavix\\Wallet\\Interfaces\\ProductInterface $product
- */
-$wallet = $customer->wallet; // get default wallet
-$wallet->meta['credit'] = 10000; // credit limit
-$wallet->save(); // update credit limit
-
-$wallet->balanceInt; // 0
-$product->getAmountProduct($customer); // 500
-
-$wallet->pay($product); // success
-$wallet->balanceInt; // -500For multi-wallets when creating:
/** @var \\Bavix\\Wallet\\Traits\\HasWallets $user */
-$wallet = $user->createWallet([
- 'name' => 'My Wallet',
- 'meta' => ['credit' => 500],
-]);It's simple!
`,9),h=[l];function e(p,k,r,d,g,E){return a(),i("div",null,h)}const o=s(n,[["render",e]]);export{y as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_single_credit-limits.md.DlXxFDrQ.lean.js b/docs/.vitepress/dist/assets/guide_single_credit-limits.md.DlXxFDrQ.lean.js deleted file mode 100644 index baeee4086..000000000 --- a/docs/.vitepress/dist/assets/guide_single_credit-limits.md.DlXxFDrQ.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as t}from"./chunks/framework.OdeEVNy0.js";const y=JSON.parse('{"title":"Credit Limits","description":"","frontmatter":{},"headers":[],"relativePath":"guide/single/credit-limits.md","filePath":"guide/single/credit-limits.md"}'),n={name:"guide/single/credit-limits.md"},l=t("",9),h=[l];function e(p,k,r,d,g,E){return a(),i("div",null,h)}const o=s(n,[["render",e]]);export{y as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_single_deposit.md.BcsDGgfM.js b/docs/.vitepress/dist/assets/guide_single_deposit.md.BcsDGgfM.js deleted file mode 100644 index 20869252f..000000000 --- a/docs/.vitepress/dist/assets/guide_single_deposit.md.BcsDGgfM.js +++ /dev/null @@ -1,10 +0,0 @@ -import{_ as s,c as i,o as a,a3 as e}from"./chunks/framework.OdeEVNy0.js";const E=JSON.parse('{"title":"Deposit","description":"","frontmatter":{},"headers":[],"relativePath":"guide/single/deposit.md","filePath":"guide/single/deposit.md"}'),t={name:"guide/single/deposit.md"},n=e(`A deposit is a sum of money which is part of the full price of something, and which you pay when you agree to buy it.
In this case, the Deposit is the replenishment of the wallet.
It is necessary to expand the model that will have the wallet. This is done in two stages:
Wallet interface;HasWallet trait;Let's get started.
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Wallet;
-
-class User extends Model implements Wallet
-{
- use HasWallet;
-}The model is prepared to work with a wallet.
Find user:
$user = User::first();As the user uses HasWallet, he will have balance property. Check the user's balance.
$user->balance; // 0
-$user->balanceInt; // 0The balance is zero, which is what we expected. Put it on his 10 cents account.
$user->deposit(10);
-$user->balance; // 10
-$user->balanceInt; // 10Wow! The balance is 10 cents, the money is credited.
`,17),l=[n];function h(p,k,d,r,o,c){return a(),i("div",null,l)}const y=s(t,[["render",h]]);export{E as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_single_deposit.md.BcsDGgfM.lean.js b/docs/.vitepress/dist/assets/guide_single_deposit.md.BcsDGgfM.lean.js deleted file mode 100644 index 43aec7428..000000000 --- a/docs/.vitepress/dist/assets/guide_single_deposit.md.BcsDGgfM.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as e}from"./chunks/framework.OdeEVNy0.js";const E=JSON.parse('{"title":"Deposit","description":"","frontmatter":{},"headers":[],"relativePath":"guide/single/deposit.md","filePath":"guide/single/deposit.md"}'),t={name:"guide/single/deposit.md"},n=e("",17),l=[n];function h(p,k,d,r,o,c){return a(),i("div",null,l)}const y=s(t,[["render",h]]);export{E as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_single_exchange.md.B2DS6fIk.js b/docs/.vitepress/dist/assets/guide_single_exchange.md.B2DS6fIk.js deleted file mode 100644 index ba89c7111..000000000 --- a/docs/.vitepress/dist/assets/guide_single_exchange.md.B2DS6fIk.js +++ /dev/null @@ -1,54 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const c=JSON.parse('{"title":"Exchange","description":"","frontmatter":{},"headers":[],"relativePath":"guide/single/exchange.md","filePath":"guide/single/exchange.md"}'),h={name:"guide/single/exchange.md"},t=n(`Everyone’s tasks are different and with the help of this functionality you can add exchange rates to your wallets.
The wallet currency is set via meta. Example:
$user->createWallet([
- 'name' => 'My USD Wallet',
- 'meta' => ['currency' => 'USD'],
-]);Service for working with currencies you need to write yourself or use library.
We will write a simple service. We will take the data from the array, and not from the database.
use Bavix\\Wallet\\Internal\\Service\\MathServiceInterface;
-use Bavix\\Wallet\\Services\\ExchangeServiceInterface;
-
-class MyExchangeService implements ExchangeServiceInterface
-{
- private array $rates = [
- 'USD' => [
- 'RUB' => 67.61,
- ],
- ];
-
- private MathServiceInterface $mathService;
-
- public function __construct(MathServiceInterface $mathService)
- {
- $this->mathService = $mathService;
-
- foreach ($this->rates as $from => $rates) {
- foreach ($rates as $to => $rate) {
- if (empty($this->rates[$to][$from])) {
- $this->rates[$to][$from] = $this->mathService->div(1, $rate);
- }
- }
- }
- }
-
- /** @param float|int|string $amount */
- public function convertTo(string $fromCurrency, string $toCurrency, $amount): string
- {
- return $this->mathService->mul($amount, $this->rates[$fromCurrency][$toCurrency] ?? 1);
- }
-}The service you wrote must be registered, this is done in the file config/wallet.php.
return [
- // ...
- 'services' => [
- 'exchange' => MyExchangeService::class,
- // ...
- ],
- // ...
-];Create two wallets.
$usd = $user->createWallet([
- 'name' => 'My Dollars',
- 'meta' => ['currency' => 'USD'],
-]);
-
-$rub = $user->createWallet([
- 'name' => 'My Ruble',
- 'meta' => ['currency' => 'RUB'],
-]);We replenish the ruble wallet with 100 rubles.
$rub->deposit(10000);We will exchange rubles into dollars.
$transfer = $rub->exchange($usd, 10000);
-$rub->balance; // 0
-$usd->balance; // 147, это $1.47Unfortunately, the world is not perfect. You will not get back your 100 rubles.
$transfer = $usd->exchange($rub, $usd->balance);
-$usd->balance; // 0
-$rub->balance; // 9938Due to conversion and mathematical rounding, you lost 62 kopecks. You have 99 rubles 38 kopecks left.
It's simple!
`,23),l=[t];function p(k,e,r,E,g,d){return a(),i("div",null,l)}const F=s(h,[["render",p]]);export{c as __pageData,F as default}; diff --git a/docs/.vitepress/dist/assets/guide_single_exchange.md.B2DS6fIk.lean.js b/docs/.vitepress/dist/assets/guide_single_exchange.md.B2DS6fIk.lean.js deleted file mode 100644 index 542c953ff..000000000 --- a/docs/.vitepress/dist/assets/guide_single_exchange.md.B2DS6fIk.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const c=JSON.parse('{"title":"Exchange","description":"","frontmatter":{},"headers":[],"relativePath":"guide/single/exchange.md","filePath":"guide/single/exchange.md"}'),h={name:"guide/single/exchange.md"},t=n("",23),l=[t];function p(k,e,r,E,g,d){return a(),i("div",null,l)}const F=s(h,[["render",p]]);export{c as __pageData,F as default}; diff --git a/docs/.vitepress/dist/assets/guide_single_refresh.md.DyIzlukO.js b/docs/.vitepress/dist/assets/guide_single_refresh.md.DyIzlukO.js deleted file mode 100644 index cb98293d3..000000000 --- a/docs/.vitepress/dist/assets/guide_single_refresh.md.DyIzlukO.js +++ /dev/null @@ -1,15 +0,0 @@ -import{_ as s,c as i,o as a,a3 as e}from"./chunks/framework.OdeEVNy0.js";const E=JSON.parse('{"title":"To refresh the balance","description":"","frontmatter":{},"headers":[],"relativePath":"guide/single/refresh.md","filePath":"guide/single/refresh.md"}'),t={name:"guide/single/refresh.md"},n=e(`There are situations when you create a lot of unconfirmed operations, and then abruptly confirm everything. In this case, the user's balance will not change. You must be forced to refresh the balance.
It is necessary to expand the model that will have the wallet. This is done in two stages:
Wallet interface;HasWallet trait;Let's get started.
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Wallet;
-
-class User extends Model implements Wallet
-{
- use HasWallet;
-}The model is prepared to work with a wallet.
Let's say the user's balance
$user->id; // 5
-$user->balance; // 27And he has unconfirmed transactions. Confirm all transactions.
update transactions
-set confirmed=1
-where confirmed=0 and
- payable_type='App\\Models\\User' and
- payable_id=5;
--- 212 rows affected in 54 msRefresh the balance.
$user->balance; // 27
-$user->wallet->refreshBalance();
-$user->balance; // 42It's simple!
`,16),l=[n];function h(p,k,r,d,c,o){return a(),i("div",null,l)}const y=s(t,[["render",h]]);export{E as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_single_refresh.md.DyIzlukO.lean.js b/docs/.vitepress/dist/assets/guide_single_refresh.md.DyIzlukO.lean.js deleted file mode 100644 index 36f5cbe88..000000000 --- a/docs/.vitepress/dist/assets/guide_single_refresh.md.DyIzlukO.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as e}from"./chunks/framework.OdeEVNy0.js";const E=JSON.parse('{"title":"To refresh the balance","description":"","frontmatter":{},"headers":[],"relativePath":"guide/single/refresh.md","filePath":"guide/single/refresh.md"}'),t={name:"guide/single/refresh.md"},n=e("",16),l=[n];function h(p,k,r,d,c,o){return a(),i("div",null,l)}const y=s(t,[["render",h]]);export{E as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/guide_single_transfer.md.C3u-1njA.js b/docs/.vitepress/dist/assets/guide_single_transfer.md.C3u-1njA.js deleted file mode 100644 index cb2dfd876..000000000 --- a/docs/.vitepress/dist/assets/guide_single_transfer.md.C3u-1njA.js +++ /dev/null @@ -1,32 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const y=JSON.parse('{"title":"Transfer","description":"","frontmatter":{},"headers":[],"relativePath":"guide/single/transfer.md","filePath":"guide/single/transfer.md"}'),t={name:"guide/single/transfer.md"},h=n(`Transfer in our system are two well-known Deposit and Withdraw operations that are performed in one transaction.
The transfer takes place between wallets.
It is necessary to expand the model that will have the wallet. This is done in two stages:
Wallet interface;HasWallet trait;Let's get started.
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Wallet;
-
-class User extends Model implements Wallet
-{
- use HasWallet;
-}The model is prepared to work with a wallet.
$transfer = $user1->transfer(
- $user2,
- 511,
- new Extra(
- deposit: [
- 'type' => 'extra-deposit',
- ],
- withdraw: new Option(
- [
- 'type' => 'extra-withdraw',
- ],
- false // confirmed
- ),
- extra: [
- 'msg' => 'hello world',
- ],
- )
-);Find user:
$first = User::first();
-$last = User::orderBy('id', 'desc')->first(); // last user
-$first->getKey() !== $last->getKey(); // trueAs the user uses HasWallet, he will have balance property. Check the user's balance.
$first->balance; // 100
-$last->balance; // 0The transfer will be from the first user to the second.
$first->transfer($last, 5);
-$first->balance; // 95
-$last->balance; // 5It's simple!
Check the user's balance.
$first->balance; // 100
-$last->balance; // 0The transfer will be from the first user to the second.
$first->forceTransfer($last, 500);
-$first->balance; // -400
-$last->balance; // 500It's simple!
`,25),e=[h];function l(p,k,r,d,E,g){return a(),i("div",null,e)}const o=s(t,[["render",l]]);export{y as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_single_transfer.md.C3u-1njA.lean.js b/docs/.vitepress/dist/assets/guide_single_transfer.md.C3u-1njA.lean.js deleted file mode 100644 index e3afef8f9..000000000 --- a/docs/.vitepress/dist/assets/guide_single_transfer.md.C3u-1njA.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as n}from"./chunks/framework.OdeEVNy0.js";const y=JSON.parse('{"title":"Transfer","description":"","frontmatter":{},"headers":[],"relativePath":"guide/single/transfer.md","filePath":"guide/single/transfer.md"}'),t={name:"guide/single/transfer.md"},h=n("",25),e=[h];function l(p,k,r,d,E,g){return a(),i("div",null,e)}const o=s(t,[["render",l]]);export{y as __pageData,o as default}; diff --git a/docs/.vitepress/dist/assets/guide_single_withdraw.md.DOQOK6kp.js b/docs/.vitepress/dist/assets/guide_single_withdraw.md.DOQOK6kp.js deleted file mode 100644 index 4575c1ff2..000000000 --- a/docs/.vitepress/dist/assets/guide_single_withdraw.md.DOQOK6kp.js +++ /dev/null @@ -1,14 +0,0 @@ -import{_ as s,c as i,o as a,a3 as e}from"./chunks/framework.OdeEVNy0.js";const E=JSON.parse('{"title":"Withdraw","description":"","frontmatter":{},"headers":[],"relativePath":"guide/single/withdraw.md","filePath":"guide/single/withdraw.md"}'),t={name:"guide/single/withdraw.md"},n=e(`When there is enough money in the account, you can transfer/withdraw it or buy something in the system.
Since the currency is virtual, you can buy any services on your website. For example, priority in search results.
It is necessary to expand the model that will have the wallet. This is done in two stages:
Wallet interface;HasWallet trait;Let's get started.
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Wallet;
-
-class User extends Model implements Wallet
-{
- use HasWallet;
-}The model is prepared to work with a wallet.
Find user:
$user = User::first();As the user uses HasWallet, he will have balance property. Check the user's balance.
$user->balance; // 100
-$user->balanceInt; // 100The balance is not empty, so you can withdraw funds.
$user->withdraw(10);
-$user->balance; // 90
-$user->balanceInt; // 90It's simple!
Forced withdrawal is necessary for those cases when the user has no funds. For example, a fine for spam.
$user->balance; // 100
-$user->balanceInt; // 100
-$user->forceWithdraw(101);
-$user->balance; // -1
-$user->balanceInt; // -1There can be two situations:
Bavix\\Wallet\\Exceptions\\BalanceIsEmptyBavix\\Wallet\\Exceptions\\InsufficientFundsThe recommended installation method is using Composer.
In your project root just run:
composer req bavix/laravel-walletEnsure that you’ve set up your project to autoload Composer-installed packages.
',5),i=[r];function n(p,c,l,d,h,_){return s(),a("div",null,i)}const g=e(t,[["render",n]]);export{u as __pageData,g as default}; diff --git a/docs/.vitepress/dist/assets/include_composer.md.Bahh6vzC.lean.js b/docs/.vitepress/dist/assets/include_composer.md.Bahh6vzC.lean.js deleted file mode 100644 index 2d0aa95a1..000000000 --- a/docs/.vitepress/dist/assets/include_composer.md.Bahh6vzC.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as e,c as a,o as s,a3 as o}from"./chunks/framework.OdeEVNy0.js";const u=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"_include/composer.md","filePath":"_include/composer.md"}'),t={name:"_include/composer.md"},r=o("",5),i=[r];function n(p,c,l,d,h,_){return s(),a("div",null,i)}const g=e(t,[["render",n]]);export{u as __pageData,g as default}; diff --git a/docs/.vitepress/dist/assets/include_eager_loading.md.DEcAtRed.js b/docs/.vitepress/dist/assets/include_eager_loading.md.DEcAtRed.js deleted file mode 100644 index 6a08e4c8a..000000000 --- a/docs/.vitepress/dist/assets/include_eager_loading.md.DEcAtRed.js +++ /dev/null @@ -1,17 +0,0 @@ -import{_ as s,c as i,o as a,a3 as e}from"./chunks/framework.OdeEVNy0.js";const E=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"_include/eager_loading.md","filePath":"_include/eager_loading.md"}'),t={name:"_include/eager_loading.md"},n=e(`When accessing Eloquent relationships as properties, the relationship data is "lazy loaded". This means the relationship data is not actually loaded until you first access the property. However, Eloquent can "eager load" relationships at the time you query the parent model. Eager loading alleviates the N + 1 query problem. To illustrate the N + 1 query problem, consider a Wallet model that is related to User:
Add the HasWallet trait and Wallet interface to model.
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Wallet;
-
-class User extends Model implements Wallet
-{
- use HasWallet; // public function wallet(): MorphOne...
-}Now, let's retrieve all wallets and their users:
$users = User::all();
-
-foreach ($users as $user) {
- // echo $user->wallet->balance;
- echo $user->balance; // Abbreviated notation
-}This loop will execute 1 query to retrieve all of the users on the table, then another query for each user to retrieve the wallet. So, if we have 25 users, the code above would run 26 queries: 1 for the original user, and 25 additional queries to retrieve the wallet of each user.
Thankfully, we can use eager loading to reduce this operation to just 2 queries. When querying, you may specify which relationships should be eager loaded using the with method:
$users = User::with('wallet')->all();
-
-foreach ($users as $user) {
- // echo $user->wallet->balance;
- echo $user->balance; // Abbreviated notation
-}For this operation, only two queries will be executed.
`,10),l=[n];function h(p,k,r,d,o,g){return a(),i("div",null,l)}const y=s(t,[["render",h]]);export{E as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/include_eager_loading.md.DEcAtRed.lean.js b/docs/.vitepress/dist/assets/include_eager_loading.md.DEcAtRed.lean.js deleted file mode 100644 index baeea10a5..000000000 --- a/docs/.vitepress/dist/assets/include_eager_loading.md.DEcAtRed.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as e}from"./chunks/framework.OdeEVNy0.js";const E=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"_include/eager_loading.md","filePath":"_include/eager_loading.md"}'),t={name:"_include/eager_loading.md"},n=e("",10),l=[n];function h(p,k,r,d,o,g){return a(),i("div",null,l)}const y=s(t,[["render",h]]);export{E as __pageData,y as default}; diff --git a/docs/.vitepress/dist/assets/include_models_user_simple.md.DWW_tdne.js b/docs/.vitepress/dist/assets/include_models_user_simple.md.DWW_tdne.js deleted file mode 100644 index 7d62b0d11..000000000 --- a/docs/.vitepress/dist/assets/include_models_user_simple.md.DWW_tdne.js +++ /dev/null @@ -1,7 +0,0 @@ -import{_ as s,c as i,o as a,a3 as e}from"./chunks/framework.OdeEVNy0.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"_include/models/user_simple.md","filePath":"_include/models/user_simple.md"}'),t={name:"_include/models/user_simple.md"},l=e(`It is necessary to expand the model that will have the wallet. This is done in two stages:
Wallet interface;HasWallet trait;Let's get started.
use Bavix\\Wallet\\Traits\\HasWallet;
-use Bavix\\Wallet\\Interfaces\\Wallet;
-
-class User extends Model implements Wallet
-{
- use HasWallet;
-}The model is prepared to work with a wallet.
`,5),n=[l];function p(h,d,k,r,c,o){return a(),i("div",null,n)}const m=s(t,[["render",p]]);export{g as __pageData,m as default}; diff --git a/docs/.vitepress/dist/assets/include_models_user_simple.md.DWW_tdne.lean.js b/docs/.vitepress/dist/assets/include_models_user_simple.md.DWW_tdne.lean.js deleted file mode 100644 index fb733cf7d..000000000 --- a/docs/.vitepress/dist/assets/include_models_user_simple.md.DWW_tdne.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as i,o as a,a3 as e}from"./chunks/framework.OdeEVNy0.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"_include/models/user_simple.md","filePath":"_include/models/user_simple.md"}'),t={name:"_include/models/user_simple.md"},l=e("",5),n=[l];function p(h,d,k,r,c,o){return a(),i("div",null,n)}const m=s(t,[["render",p]]);export{g as __pageData,m as default}; diff --git a/docs/.vitepress/dist/assets/include_models_user_simple_float.md.BHKtZpXH.js b/docs/.vitepress/dist/assets/include_models_user_simple_float.md.BHKtZpXH.js deleted file mode 100644 index 0be2656a3..000000000 --- a/docs/.vitepress/dist/assets/include_models_user_simple_float.md.BHKtZpXH.js +++ /dev/null @@ -1,7 +0,0 @@ -import{_ as s,c as a,o as i,a3 as e}from"./chunks/framework.OdeEVNy0.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"_include/models/user_simple_float.md","filePath":"_include/models/user_simple_float.md"}'),t={name:"_include/models/user_simple_float.md"},l=e(`It is necessary to expand the model that will have the wallet. This is done in two stages:
Wallet interface;HasWalletFloat trait;Let's get started.
use Bavix\\Wallet\\Traits\\HasWalletFloat;
-use Bavix\\Wallet\\Interfaces\\Wallet;
-
-class User extends Model implements Wallet
-{
- use HasWalletFloat;
-}The model is prepared to work with a wallet.
`,5),n=[l];function p(h,d,k,r,o,c){return i(),a("div",null,n)}const m=s(t,[["render",p]]);export{g as __pageData,m as default}; diff --git a/docs/.vitepress/dist/assets/include_models_user_simple_float.md.BHKtZpXH.lean.js b/docs/.vitepress/dist/assets/include_models_user_simple_float.md.BHKtZpXH.lean.js deleted file mode 100644 index 439ac566a..000000000 --- a/docs/.vitepress/dist/assets/include_models_user_simple_float.md.BHKtZpXH.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as s,c as a,o as i,a3 as e}from"./chunks/framework.OdeEVNy0.js";const g=JSON.parse('{"title":"","description":"","frontmatter":{},"headers":[],"relativePath":"_include/models/user_simple_float.md","filePath":"_include/models/user_simple_float.md"}'),t={name:"_include/models/user_simple_float.md"},l=e("",5),n=[l];function p(h,d,k,r,o,c){return i(),a("div",null,n)}const m=s(t,[["render",p]]);export{g as __pageData,m as default}; diff --git a/docs/.vitepress/dist/assets/index.md.BjhejX_F.js b/docs/.vitepress/dist/assets/index.md.BjhejX_F.js deleted file mode 100644 index 3cc779586..000000000 --- a/docs/.vitepress/dist/assets/index.md.BjhejX_F.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as e,c as t,o as a}from"./chunks/framework.OdeEVNy0.js";const m=JSON.parse(`{"title":"","description":"","frontmatter":{"layout":"home","hero":{"name":"Laravel Wallet","text":"It's simple!","tagline":"Easy work with virtual wallet","image":{"src":"https://github.com/bavix/laravel-wallet/assets/5111255/24cf424a-0177-4712-b74c-52b4ba88c428","alt":"Laravel Wallet"},"actions":[{"theme":"brand","text":"Getting started","link":"/guide/introduction/"},{"theme":"alt","text":"Upgrade Guide","link":"/guide/introduction/upgrade"}]},"features":[{"title":"Default Wallet","details":"For simple projects when there is no need for multiple wallets.","icon":"💰"},{"title":"Multi wallets","details":"Many wallets for one model. Easy API.","icon":"🎒"},{"title":"Purchases","details":"E-commerce. Create goods and buy them using wallets. There are also shopping carts, availability, taxes and fees.","icon":"🛍️"},{"title":"Exchanges","details":"Exchanges between wallets. Convert currency from one wallet to another.","icon":"💱"},{"title":"Support UUID","details":"Models with UUID are supported.","icon":"❄️"},{"title":"Events","details":"For more complex projects there are events and high performance API.","icon":"📻"}]},"headers":[],"relativePath":"index.md","filePath":"index.md"}`),l={name:"index.md"};function i(o,r,s,n,c,d){return a(),t("div")}const h=e(l,[["render",i]]);export{m as __pageData,h as default}; diff --git a/docs/.vitepress/dist/assets/index.md.BjhejX_F.lean.js b/docs/.vitepress/dist/assets/index.md.BjhejX_F.lean.js deleted file mode 100644 index 3cc779586..000000000 --- a/docs/.vitepress/dist/assets/index.md.BjhejX_F.lean.js +++ /dev/null @@ -1 +0,0 @@ -import{_ as e,c as t,o as a}from"./chunks/framework.OdeEVNy0.js";const m=JSON.parse(`{"title":"","description":"","frontmatter":{"layout":"home","hero":{"name":"Laravel Wallet","text":"It's simple!","tagline":"Easy work with virtual wallet","image":{"src":"https://github.com/bavix/laravel-wallet/assets/5111255/24cf424a-0177-4712-b74c-52b4ba88c428","alt":"Laravel Wallet"},"actions":[{"theme":"brand","text":"Getting started","link":"/guide/introduction/"},{"theme":"alt","text":"Upgrade Guide","link":"/guide/introduction/upgrade"}]},"features":[{"title":"Default Wallet","details":"For simple projects when there is no need for multiple wallets.","icon":"💰"},{"title":"Multi wallets","details":"Many wallets for one model. Easy API.","icon":"🎒"},{"title":"Purchases","details":"E-commerce. Create goods and buy them using wallets. There are also shopping carts, availability, taxes and fees.","icon":"🛍️"},{"title":"Exchanges","details":"Exchanges between wallets. Convert currency from one wallet to another.","icon":"💱"},{"title":"Support UUID","details":"Models with UUID are supported.","icon":"❄️"},{"title":"Events","details":"For more complex projects there are events and high performance API.","icon":"📻"}]},"headers":[],"relativePath":"index.md","filePath":"index.md"}`),l={name:"index.md"};function i(o,r,s,n,c,d){return a(),t("div")}const h=e(l,[["render",i]]);export{m as __pageData,h as default}; diff --git a/docs/.vitepress/dist/assets/inter-italic-cyrillic-ext.r48I6akx.woff2 b/docs/.vitepress/dist/assets/inter-italic-cyrillic-ext.r48I6akx.woff2 deleted file mode 100644 index b6b603d59..000000000 Binary files a/docs/.vitepress/dist/assets/inter-italic-cyrillic-ext.r48I6akx.woff2 and /dev/null differ diff --git a/docs/.vitepress/dist/assets/inter-italic-cyrillic.By2_1cv3.woff2 b/docs/.vitepress/dist/assets/inter-italic-cyrillic.By2_1cv3.woff2 deleted file mode 100644 index def40a4f6..000000000 Binary files a/docs/.vitepress/dist/assets/inter-italic-cyrillic.By2_1cv3.woff2 and /dev/null differ diff --git a/docs/.vitepress/dist/assets/inter-italic-greek-ext.1u6EdAuj.woff2 b/docs/.vitepress/dist/assets/inter-italic-greek-ext.1u6EdAuj.woff2 deleted file mode 100644 index e070c3d30..000000000 Binary files a/docs/.vitepress/dist/assets/inter-italic-greek-ext.1u6EdAuj.woff2 and /dev/null differ diff --git a/docs/.vitepress/dist/assets/inter-italic-greek.DJ8dCoTZ.woff2 b/docs/.vitepress/dist/assets/inter-italic-greek.DJ8dCoTZ.woff2 deleted file mode 100644 index a3c16ca40..000000000 Binary files a/docs/.vitepress/dist/assets/inter-italic-greek.DJ8dCoTZ.woff2 and /dev/null differ diff --git a/docs/.vitepress/dist/assets/inter-italic-latin-ext.CN1xVJS-.woff2 b/docs/.vitepress/dist/assets/inter-italic-latin-ext.CN1xVJS-.woff2 deleted file mode 100644 index 2210a899e..000000000 Binary files a/docs/.vitepress/dist/assets/inter-italic-latin-ext.CN1xVJS-.woff2 and /dev/null differ diff --git a/docs/.vitepress/dist/assets/inter-italic-latin.C2AdPX0b.woff2 b/docs/.vitepress/dist/assets/inter-italic-latin.C2AdPX0b.woff2 deleted file mode 100644 index 790d62dc7..000000000 Binary files a/docs/.vitepress/dist/assets/inter-italic-latin.C2AdPX0b.woff2 and /dev/null differ diff --git a/docs/.vitepress/dist/assets/inter-italic-vietnamese.BSbpV94h.woff2 b/docs/.vitepress/dist/assets/inter-italic-vietnamese.BSbpV94h.woff2 deleted file mode 100644 index 1eec0775a..000000000 Binary files a/docs/.vitepress/dist/assets/inter-italic-vietnamese.BSbpV94h.woff2 and /dev/null differ diff --git a/docs/.vitepress/dist/assets/inter-roman-cyrillic-ext.BBPuwvHQ.woff2 b/docs/.vitepress/dist/assets/inter-roman-cyrillic-ext.BBPuwvHQ.woff2 deleted file mode 100644 index 2cfe61536..000000000 Binary files a/docs/.vitepress/dist/assets/inter-roman-cyrillic-ext.BBPuwvHQ.woff2 and /dev/null differ diff --git a/docs/.vitepress/dist/assets/inter-roman-cyrillic.C5lxZ8CY.woff2 b/docs/.vitepress/dist/assets/inter-roman-cyrillic.C5lxZ8CY.woff2 deleted file mode 100644 index e3886dd14..000000000 Binary files a/docs/.vitepress/dist/assets/inter-roman-cyrillic.C5lxZ8CY.woff2 and /dev/null differ diff --git a/docs/.vitepress/dist/assets/inter-roman-greek-ext.CqjqNYQ-.woff2 b/docs/.vitepress/dist/assets/inter-roman-greek-ext.CqjqNYQ-.woff2 deleted file mode 100644 index 36d67487d..000000000 Binary files a/docs/.vitepress/dist/assets/inter-roman-greek-ext.CqjqNYQ-.woff2 and /dev/null differ diff --git a/docs/.vitepress/dist/assets/inter-roman-greek.BBVDIX6e.woff2 b/docs/.vitepress/dist/assets/inter-roman-greek.BBVDIX6e.woff2 deleted file mode 100644 index 2bed1e85e..000000000 Binary files a/docs/.vitepress/dist/assets/inter-roman-greek.BBVDIX6e.woff2 and /dev/null differ diff --git a/docs/.vitepress/dist/assets/inter-roman-latin-ext.4ZJIpNVo.woff2 b/docs/.vitepress/dist/assets/inter-roman-latin-ext.4ZJIpNVo.woff2 deleted file mode 100644 index 9a8d1e2b5..000000000 Binary files a/docs/.vitepress/dist/assets/inter-roman-latin-ext.4ZJIpNVo.woff2 and /dev/null differ diff --git a/docs/.vitepress/dist/assets/inter-roman-latin.Di8DUHzh.woff2 b/docs/.vitepress/dist/assets/inter-roman-latin.Di8DUHzh.woff2 deleted file mode 100644 index 07d3c53ae..000000000 Binary files a/docs/.vitepress/dist/assets/inter-roman-latin.Di8DUHzh.woff2 and /dev/null differ diff --git a/docs/.vitepress/dist/assets/inter-roman-vietnamese.BjW4sHH5.woff2 b/docs/.vitepress/dist/assets/inter-roman-vietnamese.BjW4sHH5.woff2 deleted file mode 100644 index 57bdc22ae..000000000 Binary files a/docs/.vitepress/dist/assets/inter-roman-vietnamese.BjW4sHH5.woff2 and /dev/null differ diff --git a/docs/.vitepress/dist/assets/style.A34_PHSu.css b/docs/.vitepress/dist/assets/style.A34_PHSu.css deleted file mode 100644 index 6726cdf24..000000000 --- a/docs/.vitepress/dist/assets/style.A34_PHSu.css +++ /dev/null @@ -1 +0,0 @@ -@font-face{font-family:Inter;font-style:normal;font-weight:100 900;font-display:swap;src:url(/laravel-wallet/assets/inter-roman-cyrillic-ext.BBPuwvHQ.woff2) format("woff2");unicode-range:U+0460-052F,U+1C80-1C88,U+20B4,U+2DE0-2DFF,U+A640-A69F,U+FE2E-FE2F}@font-face{font-family:Inter;font-style:normal;font-weight:100 900;font-display:swap;src:url(/laravel-wallet/assets/inter-roman-cyrillic.C5lxZ8CY.woff2) format("woff2");unicode-range:U+0301,U+0400-045F,U+0490-0491,U+04B0-04B1,U+2116}@font-face{font-family:Inter;font-style:normal;font-weight:100 900;font-display:swap;src:url(/laravel-wallet/assets/inter-roman-greek-ext.CqjqNYQ-.woff2) format("woff2");unicode-range:U+1F00-1FFF}@font-face{font-family:Inter;font-style:normal;font-weight:100 900;font-display:swap;src:url(/laravel-wallet/assets/inter-roman-greek.BBVDIX6e.woff2) format("woff2");unicode-range:U+0370-0377,U+037A-037F,U+0384-038A,U+038C,U+038E-03A1,U+03A3-03FF}@font-face{font-family:Inter;font-style:normal;font-weight:100 900;font-display:swap;src:url(/laravel-wallet/assets/inter-roman-vietnamese.BjW4sHH5.woff2) format("woff2");unicode-range:U+0102-0103,U+0110-0111,U+0128-0129,U+0168-0169,U+01A0-01A1,U+01AF-01B0,U+0300-0301,U+0303-0304,U+0308-0309,U+0323,U+0329,U+1EA0-1EF9,U+20AB}@font-face{font-family:Inter;font-style:normal;font-weight:100 900;font-display:swap;src:url(/laravel-wallet/assets/inter-roman-latin-ext.4ZJIpNVo.woff2) format("woff2");unicode-range:U+0100-02AF,U+0304,U+0308,U+0329,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF}@font-face{font-family:Inter;font-style:normal;font-weight:100 900;font-display:swap;src:url(/laravel-wallet/assets/inter-roman-latin.Di8DUHzh.woff2) format("woff2");unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+2074,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD}@font-face{font-family:Inter;font-style:italic;font-weight:100 900;font-display:swap;src:url(/laravel-wallet/assets/inter-italic-cyrillic-ext.r48I6akx.woff2) format("woff2");unicode-range:U+0460-052F,U+1C80-1C88,U+20B4,U+2DE0-2DFF,U+A640-A69F,U+FE2E-FE2F}@font-face{font-family:Inter;font-style:italic;font-weight:100 900;font-display:swap;src:url(/laravel-wallet/assets/inter-italic-cyrillic.By2_1cv3.woff2) format("woff2");unicode-range:U+0301,U+0400-045F,U+0490-0491,U+04B0-04B1,U+2116}@font-face{font-family:Inter;font-style:italic;font-weight:100 900;font-display:swap;src:url(/laravel-wallet/assets/inter-italic-greek-ext.1u6EdAuj.woff2) format("woff2");unicode-range:U+1F00-1FFF}@font-face{font-family:Inter;font-style:italic;font-weight:100 900;font-display:swap;src:url(/laravel-wallet/assets/inter-italic-greek.DJ8dCoTZ.woff2) format("woff2");unicode-range:U+0370-0377,U+037A-037F,U+0384-038A,U+038C,U+038E-03A1,U+03A3-03FF}@font-face{font-family:Inter;font-style:italic;font-weight:100 900;font-display:swap;src:url(/laravel-wallet/assets/inter-italic-vietnamese.BSbpV94h.woff2) format("woff2");unicode-range:U+0102-0103,U+0110-0111,U+0128-0129,U+0168-0169,U+01A0-01A1,U+01AF-01B0,U+0300-0301,U+0303-0304,U+0308-0309,U+0323,U+0329,U+1EA0-1EF9,U+20AB}@font-face{font-family:Inter;font-style:italic;font-weight:100 900;font-display:swap;src:url(/laravel-wallet/assets/inter-italic-latin-ext.CN1xVJS-.woff2) format("woff2");unicode-range:U+0100-02AF,U+0304,U+0308,U+0329,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF}@font-face{font-family:Inter;font-style:italic;font-weight:100 900;font-display:swap;src:url(/laravel-wallet/assets/inter-italic-latin.C2AdPX0b.woff2) format("woff2");unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+2074,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD}@font-face{font-family:Punctuation SC;font-weight:400;src:local("PingFang SC Regular"),local("Noto Sans CJK SC"),local("Microsoft YaHei");unicode-range:U+201C,U+201D,U+2018,U+2019,U+2E3A,U+2014,U+2013,U+2026,U+00B7,U+007E,U+002F}@font-face{font-family:Punctuation SC;font-weight:500;src:local("PingFang SC Medium"),local("Noto Sans CJK SC"),local("Microsoft YaHei");unicode-range:U+201C,U+201D,U+2018,U+2019,U+2E3A,U+2014,U+2013,U+2026,U+00B7,U+007E,U+002F}@font-face{font-family:Punctuation SC;font-weight:600;src:local("PingFang SC Semibold"),local("Noto Sans CJK SC Bold"),local("Microsoft YaHei Bold");unicode-range:U+201C,U+201D,U+2018,U+2019,U+2E3A,U+2014,U+2013,U+2026,U+00B7,U+007E,U+002F}@font-face{font-family:Punctuation SC;font-weight:700;src:local("PingFang SC Semibold"),local("Noto Sans CJK SC Bold"),local("Microsoft YaHei Bold");unicode-range:U+201C,U+201D,U+2018,U+2019,U+2E3A,U+2014,U+2013,U+2026,U+00B7,U+007E,U+002F}:root{--vp-c-white: #ffffff;--vp-c-black: #000000;--vp-c-neutral: var(--vp-c-black);--vp-c-neutral-inverse: var(--vp-c-white)}.dark{--vp-c-neutral: var(--vp-c-white);--vp-c-neutral-inverse: var(--vp-c-black)}:root{--vp-c-gray-1: #dddde3;--vp-c-gray-2: #e4e4e9;--vp-c-gray-3: #ebebef;--vp-c-gray-soft: rgba(142, 150, 170, .14);--vp-c-indigo-1: #3451b2;--vp-c-indigo-2: #3a5ccc;--vp-c-indigo-3: #5672cd;--vp-c-indigo-soft: rgba(100, 108, 255, .14);--vp-c-purple-1: #6f42c1;--vp-c-purple-2: #7e4cc9;--vp-c-purple-3: #8e5cd9;--vp-c-purple-soft: rgba(159, 122, 234, .14);--vp-c-green-1: #18794e;--vp-c-green-2: #299764;--vp-c-green-3: #30a46c;--vp-c-green-soft: rgba(16, 185, 129, .14);--vp-c-yellow-1: #915930;--vp-c-yellow-2: #946300;--vp-c-yellow-3: #9f6a00;--vp-c-yellow-soft: rgba(234, 179, 8, .14);--vp-c-red-1: #b8272c;--vp-c-red-2: #d5393e;--vp-c-red-3: #e0575b;--vp-c-red-soft: rgba(244, 63, 94, .14);--vp-c-sponsor: #db2777}.dark{--vp-c-gray-1: #515c67;--vp-c-gray-2: #414853;--vp-c-gray-3: #32363f;--vp-c-gray-soft: rgba(101, 117, 133, .16);--vp-c-indigo-1: #a8b1ff;--vp-c-indigo-2: #5c73e7;--vp-c-indigo-3: #3e63dd;--vp-c-indigo-soft: rgba(100, 108, 255, .16);--vp-c-purple-1: #c8abfa;--vp-c-purple-2: #a879e6;--vp-c-purple-3: #8e5cd9;--vp-c-purple-soft: rgba(159, 122, 234, .16);--vp-c-green-1: #3dd68c;--vp-c-green-2: #30a46c;--vp-c-green-3: #298459;--vp-c-green-soft: rgba(16, 185, 129, .16);--vp-c-yellow-1: #f9b44e;--vp-c-yellow-2: #da8b17;--vp-c-yellow-3: #a46a0a;--vp-c-yellow-soft: rgba(234, 179, 8, .16);--vp-c-red-1: #f66f81;--vp-c-red-2: #f14158;--vp-c-red-3: #b62a3c;--vp-c-red-soft: rgba(244, 63, 94, .16)}:root{--vp-c-bg: #ffffff;--vp-c-bg-alt: #f6f6f7;--vp-c-bg-elv: #ffffff;--vp-c-bg-soft: #f6f6f7}.dark{--vp-c-bg: #1b1b1f;--vp-c-bg-alt: #161618;--vp-c-bg-elv: #202127;--vp-c-bg-soft: #202127}:root{--vp-c-border: #c2c2c4;--vp-c-divider: #e2e2e3;--vp-c-gutter: #e2e2e3}.dark{--vp-c-border: #3c3f44;--vp-c-divider: #2e2e32;--vp-c-gutter: #000000}:root{--vp-c-text-1: rgba(60, 60, 67);--vp-c-text-2: rgba(60, 60, 67, .78);--vp-c-text-3: rgba(60, 60, 67, .56)}.dark{--vp-c-text-1: rgba(255, 255, 245, .86);--vp-c-text-2: rgba(235, 235, 245, .6);--vp-c-text-3: rgba(235, 235, 245, .38)}:root{--vp-c-default-1: var(--vp-c-gray-1);--vp-c-default-2: var(--vp-c-gray-2);--vp-c-default-3: var(--vp-c-gray-3);--vp-c-default-soft: var(--vp-c-gray-soft);--vp-c-brand-1: var(--vp-c-indigo-1);--vp-c-brand-2: var(--vp-c-indigo-2);--vp-c-brand-3: var(--vp-c-indigo-3);--vp-c-brand-soft: var(--vp-c-indigo-soft);--vp-c-brand: var(--vp-c-brand-1);--vp-c-tip-1: var(--vp-c-brand-1);--vp-c-tip-2: var(--vp-c-brand-2);--vp-c-tip-3: var(--vp-c-brand-3);--vp-c-tip-soft: var(--vp-c-brand-soft);--vp-c-note-1: var(--vp-c-brand-1);--vp-c-note-2: var(--vp-c-brand-2);--vp-c-note-3: var(--vp-c-brand-3);--vp-c-note-soft: var(--vp-c-brand-soft);--vp-c-success-1: var(--vp-c-green-1);--vp-c-success-2: var(--vp-c-green-2);--vp-c-success-3: var(--vp-c-green-3);--vp-c-success-soft: var(--vp-c-green-soft);--vp-c-important-1: var(--vp-c-purple-1);--vp-c-important-2: var(--vp-c-purple-2);--vp-c-important-3: var(--vp-c-purple-3);--vp-c-important-soft: var(--vp-c-purple-soft);--vp-c-warning-1: var(--vp-c-yellow-1);--vp-c-warning-2: var(--vp-c-yellow-2);--vp-c-warning-3: var(--vp-c-yellow-3);--vp-c-warning-soft: var(--vp-c-yellow-soft);--vp-c-danger-1: var(--vp-c-red-1);--vp-c-danger-2: var(--vp-c-red-2);--vp-c-danger-3: var(--vp-c-red-3);--vp-c-danger-soft: var(--vp-c-red-soft);--vp-c-caution-1: var(--vp-c-red-1);--vp-c-caution-2: var(--vp-c-red-2);--vp-c-caution-3: var(--vp-c-red-3);--vp-c-caution-soft: var(--vp-c-red-soft)}:root{--vp-font-family-base: "Inter", ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";--vp-font-family-mono: ui-monospace, "Menlo", "Monaco", "Consolas", "Liberation Mono", "Courier New", monospace;font-optical-sizing:auto}:root:where(:lang(zh)){--vp-font-family-base: "Punctuation SC", "Inter", ui-sans-serif, system-ui, "PingFang SC", "Noto Sans CJK SC", "Noto Sans SC", "Heiti SC", "Microsoft YaHei", "DengXian", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"}:root{--vp-shadow-1: 0 1px 2px rgba(0, 0, 0, .04), 0 1px 2px rgba(0, 0, 0, .06);--vp-shadow-2: 0 3px 12px rgba(0, 0, 0, .07), 0 1px 4px rgba(0, 0, 0, .07);--vp-shadow-3: 0 12px 32px rgba(0, 0, 0, .1), 0 2px 6px rgba(0, 0, 0, .08);--vp-shadow-4: 0 14px 44px rgba(0, 0, 0, .12), 0 3px 9px rgba(0, 0, 0, .12);--vp-shadow-5: 0 18px 56px rgba(0, 0, 0, .16), 0 4px 12px rgba(0, 0, 0, .16)}:root{--vp-z-index-footer: 10;--vp-z-index-local-nav: 20;--vp-z-index-nav: 30;--vp-z-index-layout-top: 40;--vp-z-index-backdrop: 50;--vp-z-index-sidebar: 60}@media (min-width: 960px){:root{--vp-z-index-sidebar: 25}}:root{--vp-layout-max-width: 1440px}:root{--vp-header-anchor-symbol: "#"}:root{--vp-code-line-height: 1.7;--vp-code-font-size: .875em;--vp-code-color: var(--vp-c-brand-1);--vp-code-link-color: var(--vp-c-brand-1);--vp-code-link-hover-color: var(--vp-c-brand-2);--vp-code-bg: var(--vp-c-default-soft);--vp-code-block-color: var(--vp-c-text-2);--vp-code-block-bg: var(--vp-c-bg-alt);--vp-code-block-divider-color: var(--vp-c-gutter);--vp-code-lang-color: var(--vp-c-text-3);--vp-code-line-highlight-color: var(--vp-c-default-soft);--vp-code-line-number-color: var(--vp-c-text-3);--vp-code-line-diff-add-color: var(--vp-c-success-soft);--vp-code-line-diff-add-symbol-color: var(--vp-c-success-1);--vp-code-line-diff-remove-color: var(--vp-c-danger-soft);--vp-code-line-diff-remove-symbol-color: var(--vp-c-danger-1);--vp-code-line-warning-color: var(--vp-c-warning-soft);--vp-code-line-error-color: var(--vp-c-danger-soft);--vp-code-copy-code-border-color: var(--vp-c-divider);--vp-code-copy-code-bg: var(--vp-c-bg-soft);--vp-code-copy-code-hover-border-color: var(--vp-c-divider);--vp-code-copy-code-hover-bg: var(--vp-c-bg);--vp-code-copy-code-active-text: var(--vp-c-text-2);--vp-code-copy-copied-text-content: "Copied";--vp-code-tab-divider: var(--vp-code-block-divider-color);--vp-code-tab-text-color: var(--vp-c-text-2);--vp-code-tab-bg: var(--vp-code-block-bg);--vp-code-tab-hover-text-color: var(--vp-c-text-1);--vp-code-tab-active-text-color: var(--vp-c-text-1);--vp-code-tab-active-bar-color: var(--vp-c-brand-1)}:root{--vp-button-brand-border: transparent;--vp-button-brand-text: var(--vp-c-white);--vp-button-brand-bg: var(--vp-c-brand-3);--vp-button-brand-hover-border: transparent;--vp-button-brand-hover-text: var(--vp-c-white);--vp-button-brand-hover-bg: var(--vp-c-brand-2);--vp-button-brand-active-border: transparent;--vp-button-brand-active-text: var(--vp-c-white);--vp-button-brand-active-bg: var(--vp-c-brand-1);--vp-button-alt-border: transparent;--vp-button-alt-text: var(--vp-c-text-1);--vp-button-alt-bg: var(--vp-c-default-3);--vp-button-alt-hover-border: transparent;--vp-button-alt-hover-text: var(--vp-c-text-1);--vp-button-alt-hover-bg: var(--vp-c-default-2);--vp-button-alt-active-border: transparent;--vp-button-alt-active-text: var(--vp-c-text-1);--vp-button-alt-active-bg: var(--vp-c-default-1);--vp-button-sponsor-border: var(--vp-c-text-2);--vp-button-sponsor-text: var(--vp-c-text-2);--vp-button-sponsor-bg: transparent;--vp-button-sponsor-hover-border: var(--vp-c-sponsor);--vp-button-sponsor-hover-text: var(--vp-c-sponsor);--vp-button-sponsor-hover-bg: transparent;--vp-button-sponsor-active-border: var(--vp-c-sponsor);--vp-button-sponsor-active-text: var(--vp-c-sponsor);--vp-button-sponsor-active-bg: transparent}:root{--vp-custom-block-font-size: 14px;--vp-custom-block-code-font-size: 13px;--vp-custom-block-info-border: transparent;--vp-custom-block-info-text: var(--vp-c-text-1);--vp-custom-block-info-bg: var(--vp-c-default-soft);--vp-custom-block-info-code-bg: var(--vp-c-default-soft);--vp-custom-block-note-border: transparent;--vp-custom-block-note-text: var(--vp-c-text-1);--vp-custom-block-note-bg: var(--vp-c-default-soft);--vp-custom-block-note-code-bg: var(--vp-c-default-soft);--vp-custom-block-tip-border: transparent;--vp-custom-block-tip-text: var(--vp-c-text-1);--vp-custom-block-tip-bg: var(--vp-c-tip-soft);--vp-custom-block-tip-code-bg: var(--vp-c-tip-soft);--vp-custom-block-important-border: transparent;--vp-custom-block-important-text: var(--vp-c-text-1);--vp-custom-block-important-bg: var(--vp-c-important-soft);--vp-custom-block-important-code-bg: var(--vp-c-important-soft);--vp-custom-block-warning-border: transparent;--vp-custom-block-warning-text: var(--vp-c-text-1);--vp-custom-block-warning-bg: var(--vp-c-warning-soft);--vp-custom-block-warning-code-bg: var(--vp-c-warning-soft);--vp-custom-block-danger-border: transparent;--vp-custom-block-danger-text: var(--vp-c-text-1);--vp-custom-block-danger-bg: var(--vp-c-danger-soft);--vp-custom-block-danger-code-bg: var(--vp-c-danger-soft);--vp-custom-block-caution-border: transparent;--vp-custom-block-caution-text: var(--vp-c-text-1);--vp-custom-block-caution-bg: var(--vp-c-caution-soft);--vp-custom-block-caution-code-bg: var(--vp-c-caution-soft);--vp-custom-block-details-border: var(--vp-custom-block-info-border);--vp-custom-block-details-text: var(--vp-custom-block-info-text);--vp-custom-block-details-bg: var(--vp-custom-block-info-bg);--vp-custom-block-details-code-bg: var(--vp-custom-block-info-code-bg)}:root{--vp-input-border-color: var(--vp-c-border);--vp-input-bg-color: var(--vp-c-bg-alt);--vp-input-switch-bg-color: var(--vp-c-default-soft)}:root{--vp-nav-height: 64px;--vp-nav-bg-color: var(--vp-c-bg);--vp-nav-screen-bg-color: var(--vp-c-bg);--vp-nav-logo-height: 24px}.hide-nav{--vp-nav-height: 0px}.hide-nav .VPSidebar{--vp-nav-height: 22px}:root{--vp-local-nav-bg-color: var(--vp-c-bg)}:root{--vp-sidebar-width: 272px;--vp-sidebar-bg-color: var(--vp-c-bg-alt)}:root{--vp-backdrop-bg-color: rgba(0, 0, 0, .6)}:root{--vp-home-hero-name-color: var(--vp-c-brand-1);--vp-home-hero-name-background: transparent;--vp-home-hero-image-background-image: none;--vp-home-hero-image-filter: none}:root{--vp-badge-info-border: transparent;--vp-badge-info-text: var(--vp-c-text-2);--vp-badge-info-bg: var(--vp-c-default-soft);--vp-badge-tip-border: transparent;--vp-badge-tip-text: var(--vp-c-tip-1);--vp-badge-tip-bg: var(--vp-c-tip-soft);--vp-badge-warning-border: transparent;--vp-badge-warning-text: var(--vp-c-warning-1);--vp-badge-warning-bg: var(--vp-c-warning-soft);--vp-badge-danger-border: transparent;--vp-badge-danger-text: var(--vp-c-danger-1);--vp-badge-danger-bg: var(--vp-c-danger-soft)}:root{--vp-carbon-ads-text-color: var(--vp-c-text-1);--vp-carbon-ads-poweredby-color: var(--vp-c-text-2);--vp-carbon-ads-bg-color: var(--vp-c-bg-soft);--vp-carbon-ads-hover-text-color: var(--vp-c-brand-1);--vp-carbon-ads-hover-poweredby-color: var(--vp-c-text-1)}:root{--vp-local-search-bg: var(--vp-c-bg);--vp-local-search-result-bg: var(--vp-c-bg);--vp-local-search-result-border: var(--vp-c-divider);--vp-local-search-result-selected-bg: var(--vp-c-bg);--vp-local-search-result-selected-border: var(--vp-c-brand-1);--vp-local-search-highlight-bg: var(--vp-c-brand-1);--vp-local-search-highlight-text: var(--vp-c-neutral-inverse)}@media (prefers-reduced-motion: reduce){*,:before,:after{animation-delay:-1ms!important;animation-duration:1ms!important;animation-iteration-count:1!important;background-attachment:initial!important;scroll-behavior:auto!important;transition-duration:0s!important;transition-delay:0s!important}}*,:before,:after{box-sizing:border-box}html{line-height:1.4;font-size:16px;-webkit-text-size-adjust:100%}html.dark{color-scheme:dark}body{margin:0;width:100%;min-width:320px;min-height:100vh;line-height:24px;font-family:var(--vp-font-family-base);font-size:16px;font-weight:400;color:var(--vp-c-text-1);background-color:var(--vp-c-bg);font-synthesis:style;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}main{display:block}h1,h2,h3,h4,h5,h6{margin:0;line-height:24px;font-size:16px;font-weight:400}p{margin:0}strong,b{font-weight:600}a,area,button,[role=button],input,label,select,summary,textarea{touch-action:manipulation}a{color:inherit;text-decoration:inherit}ol,ul{list-style:none;margin:0;padding:0}blockquote{margin:0}pre,code,kbd,samp{font-family:var(--vp-font-family-mono)}img,svg,video,canvas,audio,iframe,embed,object{display:block}figure{margin:0}img,video{max-width:100%;height:auto}button,input,optgroup,select,textarea{border:0;padding:0;line-height:inherit;color:inherit}button{padding:0;font-family:inherit;background-color:transparent;background-image:none}button:enabled,[role=button]:enabled{cursor:pointer}button:focus,button:focus-visible{outline:1px dotted;outline:4px auto -webkit-focus-ring-color}button:focus:not(:focus-visible){outline:none!important}input:focus,textarea:focus,select:focus{outline:none}table{border-collapse:collapse}input{background-color:transparent}input:-ms-input-placeholder,textarea:-ms-input-placeholder{color:var(--vp-c-text-3)}input::-ms-input-placeholder,textarea::-ms-input-placeholder{color:var(--vp-c-text-3)}input::placeholder,textarea::placeholder{color:var(--vp-c-text-3)}input::-webkit-outer-spin-button,input::-webkit-inner-spin-button{-webkit-appearance:none;margin:0}input[type=number]{-moz-appearance:textfield}textarea{resize:vertical}select{-webkit-appearance:none}fieldset{margin:0;padding:0}h1,h2,h3,h4,h5,h6,li,p{overflow-wrap:break-word}vite-error-overlay{z-index:9999}mjx-container{overflow-x:auto}mjx-container>svg{display:inline-block;margin:auto}[class^=vpi-],[class*=" vpi-"],.vp-icon{width:1em;height:1em}[class^=vpi-].bg,[class*=" vpi-"].bg,.vp-icon.bg{background-size:100% 100%;background-color:transparent}[class^=vpi-]:not(.bg),[class*=" vpi-"]:not(.bg),.vp-icon:not(.bg){-webkit-mask:var(--icon) no-repeat;mask:var(--icon) no-repeat;-webkit-mask-size:100% 100%;mask-size:100% 100%;background-color:currentColor;color:inherit}.vpi-align-left{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M21 6H3M15 12H3M17 18H3'/%3E%3C/svg%3E")}.vpi-arrow-right,.vpi-arrow-down,.vpi-arrow-left,.vpi-arrow-up{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M5 12h14M12 5l7 7-7 7'/%3E%3C/svg%3E")}.vpi-chevron-right,.vpi-chevron-down,.vpi-chevron-left,.vpi-chevron-up{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='m9 18 6-6-6-6'/%3E%3C/svg%3E")}.vpi-chevron-down,.vpi-arrow-down{transform:rotate(90deg)}.vpi-chevron-left,.vpi-arrow-left{transform:rotate(180deg)}.vpi-chevron-up,.vpi-arrow-up{transform:rotate(-90deg)}.vpi-square-pen{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M12 3H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7'/%3E%3Cpath d='M18.375 2.625a2.121 2.121 0 1 1 3 3L12 15l-4 1 1-4Z'/%3E%3C/svg%3E")}.vpi-plus{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M5 12h14M12 5v14'/%3E%3C/svg%3E")}.vpi-sun{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Ccircle cx='12' cy='12' r='4'/%3E%3Cpath d='M12 2v2M12 20v2M4.93 4.93l1.41 1.41M17.66 17.66l1.41 1.41M2 12h2M20 12h2M6.34 17.66l-1.41 1.41M19.07 4.93l-1.41 1.41'/%3E%3C/svg%3E")}.vpi-moon{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M12 3a6 6 0 0 0 9 9 9 9 0 1 1-9-9Z'/%3E%3C/svg%3E")}.vpi-more-horizontal{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Ccircle cx='12' cy='12' r='1'/%3E%3Ccircle cx='19' cy='12' r='1'/%3E%3Ccircle cx='5' cy='12' r='1'/%3E%3C/svg%3E")}.vpi-languages{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='m5 8 6 6M4 14l6-6 2-3M2 5h12M7 2h1M22 22l-5-10-5 10M14 18h6'/%3E%3C/svg%3E")}.vpi-heart{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M19 14c1.49-1.46 3-3.21 3-5.5A5.5 5.5 0 0 0 16.5 3c-1.76 0-3 .5-4.5 2-1.5-1.5-2.74-2-4.5-2A5.5 5.5 0 0 0 2 8.5c0 2.3 1.5 4.05 3 5.5l7 7Z'/%3E%3C/svg%3E")}.vpi-search{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Ccircle cx='11' cy='11' r='8'/%3E%3Cpath d='m21 21-4.3-4.3'/%3E%3C/svg%3E")}.vpi-layout-list{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Crect width='7' height='7' x='3' y='3' rx='1'/%3E%3Crect width='7' height='7' x='3' y='14' rx='1'/%3E%3Cpath d='M14 4h7M14 9h7M14 15h7M14 20h7'/%3E%3C/svg%3E")}.vpi-delete{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='M20 5H9l-7 7 7 7h11a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2ZM18 9l-6 6M12 9l6 6'/%3E%3C/svg%3E")}.vpi-corner-down-left{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Cpath d='m9 10-5 5 5 5'/%3E%3Cpath d='M20 4v7a4 4 0 0 1-4 4H4'/%3E%3C/svg%3E")}:root{--vp-icon-copy: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='rgba(128,128,128,1)' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Crect width='8' height='4' x='8' y='2' rx='1' ry='1'/%3E%3Cpath d='M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2'/%3E%3C/svg%3E");--vp-icon-copied: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='rgba(128,128,128,1)' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' viewBox='0 0 24 24'%3E%3Crect width='8' height='4' x='8' y='2' rx='1' ry='1'/%3E%3Cpath d='M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2'/%3E%3Cpath d='m9 14 2 2 4-4'/%3E%3C/svg%3E")}.vpi-social-discord{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M20.317 4.37a19.791 19.791 0 0 0-4.885-1.515.074.074 0 0 0-.079.037c-.21.375-.444.864-.608 1.25a18.27 18.27 0 0 0-5.487 0 12.64 12.64 0 0 0-.617-1.25.077.077 0 0 0-.079-.037A19.736 19.736 0 0 0 3.677 4.37a.07.07 0 0 0-.032.027C.533 9.046-.32 13.58.099 18.057a.082.082 0 0 0 .031.057 19.9 19.9 0 0 0 5.993 3.03.078.078 0 0 0 .084-.028c.462-.63.874-1.295 1.226-1.994a.076.076 0 0 0-.041-.106 13.107 13.107 0 0 1-1.872-.892.077.077 0 0 1-.008-.128 10.2 10.2 0 0 0 .372-.292.074.074 0 0 1 .077-.01c3.928 1.793 8.18 1.793 12.062 0a.074.074 0 0 1 .078.01c.12.098.246.198.373.292a.077.077 0 0 1-.006.127 12.299 12.299 0 0 1-1.873.892.077.077 0 0 0-.041.107c.36.698.772 1.362 1.225 1.993a.076.076 0 0 0 .084.028 19.839 19.839 0 0 0 6.002-3.03.077.077 0 0 0 .032-.054c.5-5.177-.838-9.674-3.549-13.66a.061.061 0 0 0-.031-.03zM8.02 15.33c-1.183 0-2.157-1.085-2.157-2.419 0-1.333.956-2.419 2.157-2.419 1.21 0 2.176 1.096 2.157 2.42 0 1.333-.956 2.418-2.157 2.418zm7.975 0c-1.183 0-2.157-1.085-2.157-2.419 0-1.333.955-2.419 2.157-2.419 1.21 0 2.176 1.096 2.157 2.42 0 1.333-.946 2.418-2.157 2.418Z'/%3E%3C/svg%3E")}.vpi-social-facebook{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M9.101 23.691v-7.98H6.627v-3.667h2.474v-1.58c0-4.085 1.848-5.978 5.858-5.978.401 0 .955.042 1.468.103a8.68 8.68 0 0 1 1.141.195v3.325a8.623 8.623 0 0 0-.653-.036 26.805 26.805 0 0 0-.733-.009c-.707 0-1.259.096-1.675.309a1.686 1.686 0 0 0-.679.622c-.258.42-.374.995-.374 1.752v1.297h3.919l-.386 2.103-.287 1.564h-3.246v8.245C19.396 23.238 24 18.179 24 12.044c0-6.627-5.373-12-12-12s-12 5.373-12 12c0 5.628 3.874 10.35 9.101 11.647Z'/%3E%3C/svg%3E")}.vpi-social-github{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12'/%3E%3C/svg%3E")}.vpi-social-instagram{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M7.03.084c-1.277.06-2.149.264-2.91.563a5.874 5.874 0 0 0-2.124 1.388 5.878 5.878 0 0 0-1.38 2.127C.321 4.926.12 5.8.064 7.076.008 8.354-.005 8.764.001 12.023c.007 3.259.021 3.667.083 4.947.061 1.277.264 2.149.563 2.911.308.789.72 1.457 1.388 2.123a5.872 5.872 0 0 0 2.129 1.38c.763.295 1.636.496 2.913.552 1.278.056 1.689.069 4.947.063 3.257-.007 3.668-.021 4.947-.082 1.28-.06 2.147-.265 2.91-.563a5.881 5.881 0 0 0 2.123-1.388 5.881 5.881 0 0 0 1.38-2.129c.295-.763.496-1.636.551-2.912.056-1.28.07-1.69.063-4.948-.006-3.258-.02-3.667-.081-4.947-.06-1.28-.264-2.148-.564-2.911a5.892 5.892 0 0 0-1.387-2.123 5.857 5.857 0 0 0-2.128-1.38C19.074.322 18.202.12 16.924.066 15.647.009 15.236-.006 11.977 0 8.718.008 8.31.021 7.03.084m.14 21.693c-1.17-.05-1.805-.245-2.228-.408a3.736 3.736 0 0 1-1.382-.895 3.695 3.695 0 0 1-.9-1.378c-.165-.423-.363-1.058-.417-2.228-.06-1.264-.072-1.644-.08-4.848-.006-3.204.006-3.583.061-4.848.05-1.169.246-1.805.408-2.228.216-.561.477-.96.895-1.382a3.705 3.705 0 0 1 1.379-.9c.423-.165 1.057-.361 2.227-.417 1.265-.06 1.644-.072 4.848-.08 3.203-.006 3.583.006 4.85.062 1.168.05 1.804.244 2.227.408.56.216.96.475 1.382.895.421.42.681.817.9 1.378.165.422.362 1.056.417 2.227.06 1.265.074 1.645.08 4.848.005 3.203-.006 3.583-.061 4.848-.051 1.17-.245 1.805-.408 2.23-.216.56-.477.96-.896 1.38a3.705 3.705 0 0 1-1.378.9c-.422.165-1.058.362-2.226.418-1.266.06-1.645.072-4.85.079-3.204.007-3.582-.006-4.848-.06m9.783-16.192a1.44 1.44 0 1 0 1.437-1.442 1.44 1.44 0 0 0-1.437 1.442M5.839 12.012a6.161 6.161 0 1 0 12.323-.024 6.162 6.162 0 0 0-12.323.024M8 12.008A4 4 0 1 1 12.008 16 4 4 0 0 1 8 12.008'/%3E%3C/svg%3E")}.vpi-social-linkedin{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M20.447 20.452h-3.554v-5.569c0-1.328-.027-3.037-1.852-3.037-1.853 0-2.136 1.445-2.136 2.939v5.667H9.351V9h3.414v1.561h.046c.477-.9 1.637-1.85 3.37-1.85 3.601 0 4.267 2.37 4.267 5.455v6.286zM5.337 7.433a2.062 2.062 0 0 1-2.063-2.065 2.064 2.064 0 1 1 2.063 2.065zm1.782 13.019H3.555V9h3.564v11.452zM22.225 0H1.771C.792 0 0 .774 0 1.729v20.542C0 23.227.792 24 1.771 24h20.451C23.2 24 24 23.227 24 22.271V1.729C24 .774 23.2 0 22.222 0h.003z'/%3E%3C/svg%3E")}.vpi-social-mastodon{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M23.268 5.313c-.35-2.578-2.617-4.61-5.304-5.004C17.51.242 15.792 0 11.813 0h-.03c-3.98 0-4.835.242-5.288.309C3.882.692 1.496 2.518.917 5.127.64 6.412.61 7.837.661 9.143c.074 1.874.088 3.745.26 5.611.118 1.24.325 2.47.62 3.68.55 2.237 2.777 4.098 4.96 4.857 2.336.792 4.849.923 7.256.38.265-.061.527-.132.786-.213.585-.184 1.27-.39 1.774-.753a.057.057 0 0 0 .023-.043v-1.809a.052.052 0 0 0-.02-.041.053.053 0 0 0-.046-.01 20.282 20.282 0 0 1-4.709.545c-2.73 0-3.463-1.284-3.674-1.818a5.593 5.593 0 0 1-.319-1.433.053.053 0 0 1 .066-.054c1.517.363 3.072.546 4.632.546.376 0 .75 0 1.125-.01 1.57-.044 3.224-.124 4.768-.422.038-.008.077-.015.11-.024 2.435-.464 4.753-1.92 4.989-5.604.008-.145.03-1.52.03-1.67.002-.512.167-3.63-.024-5.545zm-3.748 9.195h-2.561V8.29c0-1.309-.55-1.976-1.67-1.976-1.23 0-1.846.79-1.846 2.35v3.403h-2.546V8.663c0-1.56-.617-2.35-1.848-2.35-1.112 0-1.668.668-1.67 1.977v6.218H4.822V8.102c0-1.31.337-2.35 1.011-3.12.696-.77 1.608-1.164 2.74-1.164 1.311 0 2.302.5 2.962 1.498l.638 1.06.638-1.06c.66-.999 1.65-1.498 2.96-1.498 1.13 0 2.043.395 2.74 1.164.675.77 1.012 1.81 1.012 3.12z'/%3E%3C/svg%3E")}.vpi-social-npm{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M1.763 0C.786 0 0 .786 0 1.763v20.474C0 23.214.786 24 1.763 24h20.474c.977 0 1.763-.786 1.763-1.763V1.763C24 .786 23.214 0 22.237 0zM5.13 5.323l13.837.019-.009 13.836h-3.464l.01-10.382h-3.456L12.04 19.17H5.113z'/%3E%3C/svg%3E")}.vpi-social-slack{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M5.042 15.165a2.528 2.528 0 0 1-2.52 2.523A2.528 2.528 0 0 1 0 15.165a2.527 2.527 0 0 1 2.522-2.52h2.52v2.52zm1.271 0a2.527 2.527 0 0 1 2.521-2.52 2.527 2.527 0 0 1 2.521 2.52v6.313A2.528 2.528 0 0 1 8.834 24a2.528 2.528 0 0 1-2.521-2.522v-6.313zM8.834 5.042a2.528 2.528 0 0 1-2.521-2.52A2.528 2.528 0 0 1 8.834 0a2.528 2.528 0 0 1 2.521 2.522v2.52H8.834zm0 1.271a2.528 2.528 0 0 1 2.521 2.521 2.528 2.528 0 0 1-2.521 2.521H2.522A2.528 2.528 0 0 1 0 8.834a2.528 2.528 0 0 1 2.522-2.521h6.312zm10.122 2.521a2.528 2.528 0 0 1 2.522-2.521A2.528 2.528 0 0 1 24 8.834a2.528 2.528 0 0 1-2.522 2.521h-2.522V8.834zm-1.268 0a2.528 2.528 0 0 1-2.523 2.521 2.527 2.527 0 0 1-2.52-2.521V2.522A2.527 2.527 0 0 1 15.165 0a2.528 2.528 0 0 1 2.523 2.522v6.312zm-2.523 10.122a2.528 2.528 0 0 1 2.523 2.522A2.528 2.528 0 0 1 15.165 24a2.527 2.527 0 0 1-2.52-2.522v-2.522h2.52zm0-1.268a2.527 2.527 0 0 1-2.52-2.523 2.526 2.526 0 0 1 2.52-2.52h6.313A2.527 2.527 0 0 1 24 15.165a2.528 2.528 0 0 1-2.522 2.523h-6.313z'/%3E%3C/svg%3E")}.vpi-social-twitter,.vpi-social-x{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M18.901 1.153h3.68l-8.04 9.19L24 22.846h-7.406l-5.8-7.584-6.638 7.584H.474l8.6-9.83L0 1.154h7.594l5.243 6.932ZM17.61 20.644h2.039L6.486 3.24H4.298Z'/%3E%3C/svg%3E")}.vpi-social-youtube{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M23.498 6.186a3.016 3.016 0 0 0-2.122-2.136C19.505 3.545 12 3.545 12 3.545s-7.505 0-9.377.505A3.017 3.017 0 0 0 .502 6.186C0 8.07 0 12 0 12s0 3.93.502 5.814a3.016 3.016 0 0 0 2.122 2.136c1.871.505 9.376.505 9.376.505s7.505 0 9.377-.505a3.015 3.015 0 0 0 2.122-2.136C24 15.93 24 12 24 12s0-3.93-.502-5.814zM9.545 15.568V8.432L15.818 12l-6.273 3.568z'/%3E%3C/svg%3E")}.visually-hidden{position:absolute;width:1px;height:1px;white-space:nowrap;clip:rect(0 0 0 0);clip-path:inset(50%);overflow:hidden}.custom-block{border:1px solid transparent;border-radius:8px;padding:16px 16px 8px;line-height:24px;font-size:var(--vp-custom-block-font-size);color:var(--vp-c-text-2)}.custom-block.info{border-color:var(--vp-custom-block-info-border);color:var(--vp-custom-block-info-text);background-color:var(--vp-custom-block-info-bg)}.custom-block.info a,.custom-block.info code{color:var(--vp-c-brand-1)}.custom-block.info a:hover,.custom-block.info a:hover>code{color:var(--vp-c-brand-2)}.custom-block.info code{background-color:var(--vp-custom-block-info-code-bg)}.custom-block.note{border-color:var(--vp-custom-block-note-border);color:var(--vp-custom-block-note-text);background-color:var(--vp-custom-block-note-bg)}.custom-block.note a,.custom-block.note code{color:var(--vp-c-brand-1)}.custom-block.note a:hover,.custom-block.note a:hover>code{color:var(--vp-c-brand-2)}.custom-block.note code{background-color:var(--vp-custom-block-note-code-bg)}.custom-block.tip{border-color:var(--vp-custom-block-tip-border);color:var(--vp-custom-block-tip-text);background-color:var(--vp-custom-block-tip-bg)}.custom-block.tip a,.custom-block.tip code{color:var(--vp-c-tip-1)}.custom-block.tip a:hover,.custom-block.tip a:hover>code{color:var(--vp-c-tip-2)}.custom-block.tip code{background-color:var(--vp-custom-block-tip-code-bg)}.custom-block.important{border-color:var(--vp-custom-block-important-border);color:var(--vp-custom-block-important-text);background-color:var(--vp-custom-block-important-bg)}.custom-block.important a,.custom-block.important code{color:var(--vp-c-important-1)}.custom-block.important a:hover,.custom-block.important a:hover>code{color:var(--vp-c-important-2)}.custom-block.important code{background-color:var(--vp-custom-block-important-code-bg)}.custom-block.warning{border-color:var(--vp-custom-block-warning-border);color:var(--vp-custom-block-warning-text);background-color:var(--vp-custom-block-warning-bg)}.custom-block.warning a,.custom-block.warning code{color:var(--vp-c-warning-1)}.custom-block.warning a:hover,.custom-block.warning a:hover>code{color:var(--vp-c-warning-2)}.custom-block.warning code{background-color:var(--vp-custom-block-warning-code-bg)}.custom-block.danger{border-color:var(--vp-custom-block-danger-border);color:var(--vp-custom-block-danger-text);background-color:var(--vp-custom-block-danger-bg)}.custom-block.danger a,.custom-block.danger code{color:var(--vp-c-danger-1)}.custom-block.danger a:hover,.custom-block.danger a:hover>code{color:var(--vp-c-danger-2)}.custom-block.danger code{background-color:var(--vp-custom-block-danger-code-bg)}.custom-block.caution{border-color:var(--vp-custom-block-caution-border);color:var(--vp-custom-block-caution-text);background-color:var(--vp-custom-block-caution-bg)}.custom-block.caution a,.custom-block.caution code{color:var(--vp-c-caution-1)}.custom-block.caution a:hover,.custom-block.caution a:hover>code{color:var(--vp-c-caution-2)}.custom-block.caution code{background-color:var(--vp-custom-block-caution-code-bg)}.custom-block.details{border-color:var(--vp-custom-block-details-border);color:var(--vp-custom-block-details-text);background-color:var(--vp-custom-block-details-bg)}.custom-block.details a{color:var(--vp-c-brand-1)}.custom-block.details a:hover,.custom-block.details a:hover>code{color:var(--vp-c-brand-2)}.custom-block.details code{background-color:var(--vp-custom-block-details-code-bg)}.custom-block-title{font-weight:600}.custom-block p+p{margin:8px 0}.custom-block.details summary{margin:0 0 8px;font-weight:700;cursor:pointer;-webkit-user-select:none;user-select:none}.custom-block.details summary+p{margin:8px 0}.custom-block a{color:inherit;font-weight:600;text-decoration:underline;text-underline-offset:2px;transition:opacity .25s}.custom-block a:hover{opacity:.75}.custom-block code{font-size:var(--vp-custom-block-code-font-size)}.custom-block.custom-block th,.custom-block.custom-block blockquote>p{font-size:var(--vp-custom-block-font-size);color:inherit}.dark .vp-code span{color:var(--shiki-dark, inherit)}html:not(.dark) .vp-code span{color:var(--shiki-light, inherit)}.vp-code-group{margin-top:16px}.vp-code-group .tabs{position:relative;display:flex;margin-right:-24px;margin-left:-24px;padding:0 12px;background-color:var(--vp-code-tab-bg);overflow-x:auto;overflow-y:hidden;box-shadow:inset 0 -1px var(--vp-code-tab-divider)}@media (min-width: 640px){.vp-code-group .tabs{margin-right:0;margin-left:0;border-radius:8px 8px 0 0}}.vp-code-group .tabs input{position:fixed;opacity:0;pointer-events:none}.vp-code-group .tabs label{position:relative;display:inline-block;border-bottom:1px solid transparent;padding:0 12px;line-height:48px;font-size:14px;font-weight:500;color:var(--vp-code-tab-text-color);white-space:nowrap;cursor:pointer;transition:color .25s}.vp-code-group .tabs label:after{position:absolute;right:8px;bottom:-1px;left:8px;z-index:1;height:2px;border-radius:2px;content:"";background-color:transparent;transition:background-color .25s}.vp-code-group label:hover{color:var(--vp-code-tab-hover-text-color)}.vp-code-group input:checked+label{color:var(--vp-code-tab-active-text-color)}.vp-code-group input:checked+label:after{background-color:var(--vp-code-tab-active-bar-color)}.vp-code-group div[class*=language-],.vp-block{display:none;margin-top:0!important;border-top-left-radius:0!important;border-top-right-radius:0!important}.vp-code-group div[class*=language-].active,.vp-block.active{display:block}.vp-block{padding:20px 24px}.vp-doc h1,.vp-doc h2,.vp-doc h3,.vp-doc h4,.vp-doc h5,.vp-doc h6{position:relative;font-weight:600;outline:none}.vp-doc h1{letter-spacing:-.02em;line-height:40px;font-size:28px}.vp-doc h2{margin:48px 0 16px;border-top:1px solid var(--vp-c-divider);padding-top:24px;letter-spacing:-.02em;line-height:32px;font-size:24px}.vp-doc h3{margin:32px 0 0;letter-spacing:-.01em;line-height:28px;font-size:20px}.vp-doc .header-anchor{position:absolute;top:0;left:0;margin-left:-.87em;font-weight:500;-webkit-user-select:none;user-select:none;opacity:0;text-decoration:none;transition:color .25s,opacity .25s}.vp-doc .header-anchor:before{content:var(--vp-header-anchor-symbol)}.vp-doc h1:hover .header-anchor,.vp-doc h1 .header-anchor:focus,.vp-doc h2:hover .header-anchor,.vp-doc h2 .header-anchor:focus,.vp-doc h3:hover .header-anchor,.vp-doc h3 .header-anchor:focus,.vp-doc h4:hover .header-anchor,.vp-doc h4 .header-anchor:focus,.vp-doc h5:hover .header-anchor,.vp-doc h5 .header-anchor:focus,.vp-doc h6:hover .header-anchor,.vp-doc h6 .header-anchor:focus{opacity:1}@media (min-width: 768px){.vp-doc h1{letter-spacing:-.02em;line-height:40px;font-size:32px}}.vp-doc h2 .header-anchor{top:24px}.vp-doc p,.vp-doc summary{margin:16px 0}.vp-doc p{line-height:28px}.vp-doc blockquote{margin:16px 0;border-left:2px solid var(--vp-c-divider);padding-left:16px;transition:border-color .5s}.vp-doc blockquote>p{margin:0;font-size:16px;color:var(--vp-c-text-2);transition:color .5s}.vp-doc a{font-weight:500;color:var(--vp-c-brand-1);text-decoration:underline;text-underline-offset:2px;transition:color .25s,opacity .25s}.vp-doc a:hover{color:var(--vp-c-brand-2)}.vp-doc strong{font-weight:600}.vp-doc ul,.vp-doc ol{padding-left:1.25rem;margin:16px 0}.vp-doc ul{list-style:disc}.vp-doc ol{list-style:decimal}.vp-doc li+li{margin-top:8px}.vp-doc li>ol,.vp-doc li>ul{margin:8px 0 0}.vp-doc table{display:block;border-collapse:collapse;margin:20px 0;overflow-x:auto}.vp-doc tr{background-color:var(--vp-c-bg);border-top:1px solid var(--vp-c-divider);transition:background-color .5s}.vp-doc tr:nth-child(2n){background-color:var(--vp-c-bg-soft)}.vp-doc th,.vp-doc td{border:1px solid var(--vp-c-divider);padding:8px 16px}.vp-doc th{text-align:left;font-size:14px;font-weight:600;color:var(--vp-c-text-2);background-color:var(--vp-c-bg-soft)}.vp-doc td{font-size:14px}.vp-doc hr{margin:16px 0;border:none;border-top:1px solid var(--vp-c-divider)}.vp-doc .custom-block{margin:16px 0}.vp-doc .custom-block p{margin:8px 0;line-height:24px}.vp-doc .custom-block p:first-child{margin:0}.vp-doc .custom-block div[class*=language-]{margin:8px 0;border-radius:8px}.vp-doc .custom-block div[class*=language-] code{font-weight:400;background-color:transparent}.vp-doc .custom-block .vp-code-group .tabs{margin:0;border-radius:8px 8px 0 0}.vp-doc :not(pre,h1,h2,h3,h4,h5,h6)>code{font-size:var(--vp-code-font-size);color:var(--vp-code-color)}.vp-doc :not(pre)>code{border-radius:4px;padding:3px 6px;background-color:var(--vp-code-bg);transition:color .25s,background-color .5s}.vp-doc a>code{color:var(--vp-code-link-color)}.vp-doc a:hover>code{color:var(--vp-code-link-hover-color)}.vp-doc h1>code,.vp-doc h2>code,.vp-doc h3>code{font-size:.9em}.vp-doc div[class*=language-],.vp-block{position:relative;margin:16px -24px;background-color:var(--vp-code-block-bg);overflow-x:auto;transition:background-color .5s}@media (min-width: 640px){.vp-doc div[class*=language-],.vp-block{border-radius:8px;margin:16px 0}}@media (max-width: 639px){.vp-doc li div[class*=language-]{border-radius:8px 0 0 8px}}.vp-doc div[class*=language-]+div[class*=language-],.vp-doc div[class$=-api]+div[class*=language-],.vp-doc div[class*=language-]+div[class$=-api]>div[class*=language-]{margin-top:-8px}.vp-doc [class*=language-] pre,.vp-doc [class*=language-] code{direction:ltr;text-align:left;white-space:pre;word-spacing:normal;word-break:normal;word-wrap:normal;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-hyphens:none;-moz-hyphens:none;-ms-hyphens:none;hyphens:none}.vp-doc [class*=language-] pre{position:relative;z-index:1;margin:0;padding:20px 0;background:transparent;overflow-x:auto}.vp-doc [class*=language-] code{display:block;padding:0 24px;width:fit-content;min-width:100%;line-height:var(--vp-code-line-height);font-size:var(--vp-code-font-size);color:var(--vp-code-block-color);transition:color .5s}.vp-doc [class*=language-] code .highlighted{background-color:var(--vp-code-line-highlight-color);transition:background-color .5s;margin:0 -24px;padding:0 24px;width:calc(100% + 48px);display:inline-block}.vp-doc [class*=language-] code .highlighted.error{background-color:var(--vp-code-line-error-color)}.vp-doc [class*=language-] code .highlighted.warning{background-color:var(--vp-code-line-warning-color)}.vp-doc [class*=language-] code .diff{transition:background-color .5s;margin:0 -24px;padding:0 24px;width:calc(100% + 48px);display:inline-block}.vp-doc [class*=language-] code .diff:before{position:absolute;left:10px}.vp-doc [class*=language-] .has-focused-lines .line:not(.has-focus){filter:blur(.095rem);opacity:.4;transition:filter .35s,opacity .35s}.vp-doc [class*=language-] .has-focused-lines .line:not(.has-focus){opacity:.7;transition:filter .35s,opacity .35s}.vp-doc [class*=language-]:hover .has-focused-lines .line:not(.has-focus){filter:blur(0);opacity:1}.vp-doc [class*=language-] code .diff.remove{background-color:var(--vp-code-line-diff-remove-color);opacity:.7}.vp-doc [class*=language-] code .diff.remove:before{content:"-";color:var(--vp-code-line-diff-remove-symbol-color)}.vp-doc [class*=language-] code .diff.add{background-color:var(--vp-code-line-diff-add-color)}.vp-doc [class*=language-] code .diff.add:before{content:"+";color:var(--vp-code-line-diff-add-symbol-color)}.vp-doc div[class*=language-].line-numbers-mode{padding-left:32px}.vp-doc .line-numbers-wrapper{position:absolute;top:0;bottom:0;left:0;z-index:3;border-right:1px solid var(--vp-code-block-divider-color);padding-top:20px;width:32px;text-align:center;font-family:var(--vp-font-family-mono);line-height:var(--vp-code-line-height);font-size:var(--vp-code-font-size);color:var(--vp-code-line-number-color);transition:border-color .5s,color .5s}.vp-doc [class*=language-]>button.copy{direction:ltr;position:absolute;top:12px;right:12px;z-index:3;border:1px solid var(--vp-code-copy-code-border-color);border-radius:4px;width:40px;height:40px;background-color:var(--vp-code-copy-code-bg);opacity:0;cursor:pointer;background-image:var(--vp-icon-copy);background-position:50%;background-size:20px;background-repeat:no-repeat;transition:border-color .25s,background-color .25s,opacity .25s}.vp-doc [class*=language-]:hover>button.copy,.vp-doc [class*=language-]>button.copy:focus{opacity:1}.vp-doc [class*=language-]>button.copy:hover,.vp-doc [class*=language-]>button.copy.copied{border-color:var(--vp-code-copy-code-hover-border-color);background-color:var(--vp-code-copy-code-hover-bg)}.vp-doc [class*=language-]>button.copy.copied,.vp-doc [class*=language-]>button.copy:hover.copied{border-radius:0 4px 4px 0;background-color:var(--vp-code-copy-code-hover-bg);background-image:var(--vp-icon-copied)}.vp-doc [class*=language-]>button.copy.copied:before,.vp-doc [class*=language-]>button.copy:hover.copied:before{position:relative;top:-1px;transform:translate(calc(-100% - 1px));display:flex;justify-content:center;align-items:center;border:1px solid var(--vp-code-copy-code-hover-border-color);border-right:0;border-radius:4px 0 0 4px;padding:0 10px;width:fit-content;height:40px;text-align:center;font-size:12px;font-weight:500;color:var(--vp-code-copy-code-active-text);background-color:var(--vp-code-copy-code-hover-bg);white-space:nowrap;content:var(--vp-code-copy-copied-text-content)}.vp-doc [class*=language-]>span.lang{position:absolute;top:2px;right:8px;z-index:2;font-size:12px;font-weight:500;color:var(--vp-code-lang-color);transition:color .4s,opacity .4s}.vp-doc [class*=language-]:hover>button.copy+span.lang,.vp-doc [class*=language-]>button.copy:focus+span.lang{opacity:0}.vp-doc .VPTeamMembers{margin-top:24px}.vp-doc .VPTeamMembers.small.count-1 .container{margin:0!important;max-width:calc((100% - 24px)/2)!important}.vp-doc .VPTeamMembers.small.count-2 .container,.vp-doc .VPTeamMembers.small.count-3 .container{max-width:100%!important}.vp-doc .VPTeamMembers.medium.count-1 .container{margin:0!important;max-width:calc((100% - 24px)/2)!important}:is(.vp-external-link-icon,.vp-doc a[href*="://"],.vp-doc a[target=_blank]):not(.no-icon):after{display:inline-block;margin-top:-1px;margin-left:4px;width:11px;height:11px;background:currentColor;color:var(--vp-c-text-3);flex-shrink:0;--icon: url("data:image/svg+xml, %3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' %3E%3Cpath d='M0 0h24v24H0V0z' fill='none' /%3E%3Cpath d='M9 5v2h6.59L4 18.59 5.41 20 17 8.41V15h2V5H9z' /%3E%3C/svg%3E");-webkit-mask-image:var(--icon);mask-image:var(--icon)}.vp-external-link-icon:after{content:""}.external-link-icon-enabled :is(.vp-doc a[href*="://"],.vp-doc a[target=_blank]):after{content:"";color:currentColor}.vp-sponsor{border-radius:16px;overflow:hidden}.vp-sponsor.aside{border-radius:12px}.vp-sponsor-section+.vp-sponsor-section{margin-top:4px}.vp-sponsor-tier{margin:0 0 4px!important;text-align:center;letter-spacing:1px!important;line-height:24px;width:100%;font-weight:600;color:var(--vp-c-text-2);background-color:var(--vp-c-bg-soft)}.vp-sponsor.normal .vp-sponsor-tier{padding:13px 0 11px;font-size:14px}.vp-sponsor.aside .vp-sponsor-tier{padding:9px 0 7px;font-size:12px}.vp-sponsor-grid+.vp-sponsor-tier{margin-top:4px}.vp-sponsor-grid{display:flex;flex-wrap:wrap;gap:4px}.vp-sponsor-grid.xmini .vp-sponsor-grid-link{height:64px}.vp-sponsor-grid.xmini .vp-sponsor-grid-image{max-width:64px;max-height:22px}.vp-sponsor-grid.mini .vp-sponsor-grid-link{height:72px}.vp-sponsor-grid.mini .vp-sponsor-grid-image{max-width:96px;max-height:24px}.vp-sponsor-grid.small .vp-sponsor-grid-link{height:96px}.vp-sponsor-grid.small .vp-sponsor-grid-image{max-width:96px;max-height:24px}.vp-sponsor-grid.medium .vp-sponsor-grid-link{height:112px}.vp-sponsor-grid.medium .vp-sponsor-grid-image{max-width:120px;max-height:36px}.vp-sponsor-grid.big .vp-sponsor-grid-link{height:184px}.vp-sponsor-grid.big .vp-sponsor-grid-image{max-width:192px;max-height:56px}.vp-sponsor-grid[data-vp-grid="2"] .vp-sponsor-grid-item{width:calc((100% - 4px)/2)}.vp-sponsor-grid[data-vp-grid="3"] .vp-sponsor-grid-item{width:calc((100% - 4px * 2) / 3)}.vp-sponsor-grid[data-vp-grid="4"] .vp-sponsor-grid-item{width:calc((100% - 12px)/4)}.vp-sponsor-grid[data-vp-grid="5"] .vp-sponsor-grid-item{width:calc((100% - 16px)/5)}.vp-sponsor-grid[data-vp-grid="6"] .vp-sponsor-grid-item{width:calc((100% - 4px * 5) / 6)}.vp-sponsor-grid-item{flex-shrink:0;width:100%;background-color:var(--vp-c-bg-soft);transition:background-color .25s}.vp-sponsor-grid-item:hover{background-color:var(--vp-c-default-soft)}.vp-sponsor-grid-item:hover .vp-sponsor-grid-image{filter:grayscale(0) invert(0)}.vp-sponsor-grid-item.empty:hover{background-color:var(--vp-c-bg-soft)}.dark .vp-sponsor-grid-item:hover{background-color:var(--vp-c-white)}.dark .vp-sponsor-grid-item.empty:hover{background-color:var(--vp-c-bg-soft)}.vp-sponsor-grid-link{display:flex}.vp-sponsor-grid-box{display:flex;justify-content:center;align-items:center;width:100%}.vp-sponsor-grid-image{max-width:100%;filter:grayscale(1);transition:filter .25s}.dark .vp-sponsor-grid-image{filter:grayscale(1) invert(1)}.VPBadge{display:inline-block;margin-left:2px;border:1px solid transparent;border-radius:12px;padding:0 10px;line-height:22px;font-size:12px;font-weight:500;transform:translateY(-2px)}.VPBadge.small{padding:0 6px;line-height:18px;font-size:10px;transform:translateY(-8px)}.VPDocFooter .VPBadge{display:none}.vp-doc h1>.VPBadge{margin-top:4px;vertical-align:top}.vp-doc h2>.VPBadge{margin-top:3px;padding:0 8px;vertical-align:top}.vp-doc h3>.VPBadge{vertical-align:middle}.vp-doc h4>.VPBadge,.vp-doc h5>.VPBadge,.vp-doc h6>.VPBadge{vertical-align:middle;line-height:18px}.VPBadge.info{border-color:var(--vp-badge-info-border);color:var(--vp-badge-info-text);background-color:var(--vp-badge-info-bg)}.VPBadge.tip{border-color:var(--vp-badge-tip-border);color:var(--vp-badge-tip-text);background-color:var(--vp-badge-tip-bg)}.VPBadge.warning{border-color:var(--vp-badge-warning-border);color:var(--vp-badge-warning-text);background-color:var(--vp-badge-warning-bg)}.VPBadge.danger{border-color:var(--vp-badge-danger-border);color:var(--vp-badge-danger-text);background-color:var(--vp-badge-danger-bg)}.VPBackdrop[data-v-c79a1216]{position:fixed;top:0;right:0;bottom:0;left:0;z-index:var(--vp-z-index-backdrop);background:var(--vp-backdrop-bg-color);transition:opacity .5s}.VPBackdrop.fade-enter-from[data-v-c79a1216],.VPBackdrop.fade-leave-to[data-v-c79a1216]{opacity:0}.VPBackdrop.fade-leave-active[data-v-c79a1216]{transition-duration:.25s}@media (min-width: 1280px){.VPBackdrop[data-v-c79a1216]{display:none}}.NotFound[data-v-d6be1790]{padding:64px 24px 96px;text-align:center}@media (min-width: 768px){.NotFound[data-v-d6be1790]{padding:96px 32px 168px}}.code[data-v-d6be1790]{line-height:64px;font-size:64px;font-weight:600}.title[data-v-d6be1790]{padding-top:12px;letter-spacing:2px;line-height:20px;font-size:20px;font-weight:700}.divider[data-v-d6be1790]{margin:24px auto 18px;width:64px;height:1px;background-color:var(--vp-c-divider)}.quote[data-v-d6be1790]{margin:0 auto;max-width:256px;font-size:14px;font-weight:500;color:var(--vp-c-text-2)}.action[data-v-d6be1790]{padding-top:20px}.link[data-v-d6be1790]{display:inline-block;border:1px solid var(--vp-c-brand-1);border-radius:16px;padding:3px 16px;font-size:14px;font-weight:500;color:var(--vp-c-brand-1);transition:border-color .25s,color .25s}.link[data-v-d6be1790]:hover{border-color:var(--vp-c-brand-2);color:var(--vp-c-brand-2)}.root[data-v-b933a997]{position:relative;z-index:1}.nested[data-v-b933a997]{padding-right:16px;padding-left:16px}.outline-link[data-v-b933a997]{display:block;line-height:32px;font-size:14px;font-weight:400;color:var(--vp-c-text-2);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;transition:color .5s}.outline-link[data-v-b933a997]:hover,.outline-link.active[data-v-b933a997]{color:var(--vp-c-text-1);transition:color .25s}.outline-link.nested[data-v-b933a997]{padding-left:13px}.VPDocAsideOutline[data-v-a5bbad30]{display:none}.VPDocAsideOutline.has-outline[data-v-a5bbad30]{display:block}.content[data-v-a5bbad30]{position:relative;border-left:1px solid var(--vp-c-divider);padding-left:16px;font-size:13px;font-weight:500}.outline-marker[data-v-a5bbad30]{position:absolute;top:32px;left:-1px;z-index:0;opacity:0;width:2px;border-radius:2px;height:18px;background-color:var(--vp-c-brand-1);transition:top .25s cubic-bezier(0,1,.5,1),background-color .5s,opacity .25s}.outline-title[data-v-a5bbad30]{line-height:32px;font-size:14px;font-weight:600}.VPDocAside[data-v-3f215769]{display:flex;flex-direction:column;flex-grow:1}.spacer[data-v-3f215769]{flex-grow:1}.VPDocAside[data-v-3f215769] .spacer+.VPDocAsideSponsors,.VPDocAside[data-v-3f215769] .spacer+.VPDocAsideCarbonAds{margin-top:24px}.VPDocAside[data-v-3f215769] .VPDocAsideSponsors+.VPDocAsideCarbonAds{margin-top:16px}.VPLastUpdated[data-v-7e05ebdb]{line-height:24px;font-size:14px;font-weight:500;color:var(--vp-c-text-2)}@media (min-width: 640px){.VPLastUpdated[data-v-7e05ebdb]{line-height:32px;font-size:14px;font-weight:500}}.VPDocFooter[data-v-d4a0bba5]{margin-top:64px}.edit-info[data-v-d4a0bba5]{padding-bottom:18px}@media (min-width: 640px){.edit-info[data-v-d4a0bba5]{display:flex;justify-content:space-between;align-items:center;padding-bottom:14px}}.edit-link-button[data-v-d4a0bba5]{display:flex;align-items:center;border:0;line-height:32px;font-size:14px;font-weight:500;color:var(--vp-c-brand-1);transition:color .25s}.edit-link-button[data-v-d4a0bba5]:hover{color:var(--vp-c-brand-2)}.edit-link-icon[data-v-d4a0bba5]{margin-right:8px}.prev-next[data-v-d4a0bba5]{border-top:1px solid var(--vp-c-divider);padding-top:24px;display:grid;grid-row-gap:8px}@media (min-width: 640px){.prev-next[data-v-d4a0bba5]{grid-template-columns:repeat(2,1fr);grid-column-gap:16px}}.pager-link[data-v-d4a0bba5]{display:block;border:1px solid var(--vp-c-divider);border-radius:8px;padding:11px 16px 13px;width:100%;height:100%;transition:border-color .25s}.pager-link[data-v-d4a0bba5]:hover{border-color:var(--vp-c-brand-1)}.pager-link.next[data-v-d4a0bba5]{margin-left:auto;text-align:right}.desc[data-v-d4a0bba5]{display:block;line-height:20px;font-size:12px;font-weight:500;color:var(--vp-c-text-2)}.title[data-v-d4a0bba5]{display:block;line-height:20px;font-size:14px;font-weight:500;color:var(--vp-c-brand-1);transition:color .25s}.VPDoc[data-v-39a288b8]{padding:32px 24px 96px;width:100%}@media (min-width: 768px){.VPDoc[data-v-39a288b8]{padding:48px 32px 128px}}@media (min-width: 960px){.VPDoc[data-v-39a288b8]{padding:48px 32px 0}.VPDoc:not(.has-sidebar) .container[data-v-39a288b8]{display:flex;justify-content:center;max-width:992px}.VPDoc:not(.has-sidebar) .content[data-v-39a288b8]{max-width:752px}}@media (min-width: 1280px){.VPDoc .container[data-v-39a288b8]{display:flex;justify-content:center}.VPDoc .aside[data-v-39a288b8]{display:block}}@media (min-width: 1440px){.VPDoc:not(.has-sidebar) .content[data-v-39a288b8]{max-width:784px}.VPDoc:not(.has-sidebar) .container[data-v-39a288b8]{max-width:1104px}}.container[data-v-39a288b8]{margin:0 auto;width:100%}.aside[data-v-39a288b8]{position:relative;display:none;order:2;flex-grow:1;padding-left:32px;width:100%;max-width:256px}.left-aside[data-v-39a288b8]{order:1;padding-left:unset;padding-right:32px}.aside-container[data-v-39a288b8]{position:fixed;top:0;padding-top:calc(var(--vp-nav-height) + var(--vp-layout-top-height, 0px) + var(--vp-doc-top-height, 0px) + 48px);width:224px;height:100vh;overflow-x:hidden;overflow-y:auto;scrollbar-width:none}.aside-container[data-v-39a288b8]::-webkit-scrollbar{display:none}.aside-curtain[data-v-39a288b8]{position:fixed;bottom:0;z-index:10;width:224px;height:32px;background:linear-gradient(transparent,var(--vp-c-bg) 70%)}.aside-content[data-v-39a288b8]{display:flex;flex-direction:column;min-height:calc(100vh - (var(--vp-nav-height) + var(--vp-layout-top-height, 0px) + 48px));padding-bottom:32px}.content[data-v-39a288b8]{position:relative;margin:0 auto;width:100%}@media (min-width: 960px){.content[data-v-39a288b8]{padding:0 32px 128px}}@media (min-width: 1280px){.content[data-v-39a288b8]{order:1;margin:0;min-width:640px}}.content-container[data-v-39a288b8]{margin:0 auto}.VPDoc.has-aside .content-container[data-v-39a288b8]{max-width:688px}.VPButton[data-v-cad61b99]{display:inline-block;border:1px solid transparent;text-align:center;font-weight:600;white-space:nowrap;transition:color .25s,border-color .25s,background-color .25s}.VPButton[data-v-cad61b99]:active{transition:color .1s,border-color .1s,background-color .1s}.VPButton.medium[data-v-cad61b99]{border-radius:20px;padding:0 20px;line-height:38px;font-size:14px}.VPButton.big[data-v-cad61b99]{border-radius:24px;padding:0 24px;line-height:46px;font-size:16px}.VPButton.brand[data-v-cad61b99]{border-color:var(--vp-button-brand-border);color:var(--vp-button-brand-text);background-color:var(--vp-button-brand-bg)}.VPButton.brand[data-v-cad61b99]:hover{border-color:var(--vp-button-brand-hover-border);color:var(--vp-button-brand-hover-text);background-color:var(--vp-button-brand-hover-bg)}.VPButton.brand[data-v-cad61b99]:active{border-color:var(--vp-button-brand-active-border);color:var(--vp-button-brand-active-text);background-color:var(--vp-button-brand-active-bg)}.VPButton.alt[data-v-cad61b99]{border-color:var(--vp-button-alt-border);color:var(--vp-button-alt-text);background-color:var(--vp-button-alt-bg)}.VPButton.alt[data-v-cad61b99]:hover{border-color:var(--vp-button-alt-hover-border);color:var(--vp-button-alt-hover-text);background-color:var(--vp-button-alt-hover-bg)}.VPButton.alt[data-v-cad61b99]:active{border-color:var(--vp-button-alt-active-border);color:var(--vp-button-alt-active-text);background-color:var(--vp-button-alt-active-bg)}.VPButton.sponsor[data-v-cad61b99]{border-color:var(--vp-button-sponsor-border);color:var(--vp-button-sponsor-text);background-color:var(--vp-button-sponsor-bg)}.VPButton.sponsor[data-v-cad61b99]:hover{border-color:var(--vp-button-sponsor-hover-border);color:var(--vp-button-sponsor-hover-text);background-color:var(--vp-button-sponsor-hover-bg)}.VPButton.sponsor[data-v-cad61b99]:active{border-color:var(--vp-button-sponsor-active-border);color:var(--vp-button-sponsor-active-text);background-color:var(--vp-button-sponsor-active-bg)}html:not(.dark) .VPImage.dark[data-v-8426fc1a]{display:none}.dark .VPImage.light[data-v-8426fc1a]{display:none}.VPHero[data-v-303bb580]{margin-top:calc((var(--vp-nav-height) + var(--vp-layout-top-height, 0px)) * -1);padding:calc(var(--vp-nav-height) + var(--vp-layout-top-height, 0px) + 48px) 24px 48px}@media (min-width: 640px){.VPHero[data-v-303bb580]{padding:calc(var(--vp-nav-height) + var(--vp-layout-top-height, 0px) + 80px) 48px 64px}}@media (min-width: 960px){.VPHero[data-v-303bb580]{padding:calc(var(--vp-nav-height) + var(--vp-layout-top-height, 0px) + 80px) 64px 64px}}.container[data-v-303bb580]{display:flex;flex-direction:column;margin:0 auto;max-width:1152px}@media (min-width: 960px){.container[data-v-303bb580]{flex-direction:row}}.main[data-v-303bb580]{position:relative;z-index:10;order:2;flex-grow:1;flex-shrink:0}.VPHero.has-image .container[data-v-303bb580]{text-align:center}@media (min-width: 960px){.VPHero.has-image .container[data-v-303bb580]{text-align:left}}@media (min-width: 960px){.main[data-v-303bb580]{order:1;width:calc((100% / 3) * 2)}.VPHero.has-image .main[data-v-303bb580]{max-width:592px}}.name[data-v-303bb580],.text[data-v-303bb580]{max-width:392px;letter-spacing:-.4px;line-height:40px;font-size:32px;font-weight:700;white-space:pre-wrap}.VPHero.has-image .name[data-v-303bb580],.VPHero.has-image .text[data-v-303bb580]{margin:0 auto}.name[data-v-303bb580]{color:var(--vp-home-hero-name-color)}.clip[data-v-303bb580]{background:var(--vp-home-hero-name-background);-webkit-background-clip:text;background-clip:text;-webkit-text-fill-color:var(--vp-home-hero-name-color)}@media (min-width: 640px){.name[data-v-303bb580],.text[data-v-303bb580]{max-width:576px;line-height:56px;font-size:48px}}@media (min-width: 960px){.name[data-v-303bb580],.text[data-v-303bb580]{line-height:64px;font-size:56px}.VPHero.has-image .name[data-v-303bb580],.VPHero.has-image .text[data-v-303bb580]{margin:0}}.tagline[data-v-303bb580]{padding-top:8px;max-width:392px;line-height:28px;font-size:18px;font-weight:500;white-space:pre-wrap;color:var(--vp-c-text-2)}.VPHero.has-image .tagline[data-v-303bb580]{margin:0 auto}@media (min-width: 640px){.tagline[data-v-303bb580]{padding-top:12px;max-width:576px;line-height:32px;font-size:20px}}@media (min-width: 960px){.tagline[data-v-303bb580]{line-height:36px;font-size:24px}.VPHero.has-image .tagline[data-v-303bb580]{margin:0}}.actions[data-v-303bb580]{display:flex;flex-wrap:wrap;margin:-6px;padding-top:24px}.VPHero.has-image .actions[data-v-303bb580]{justify-content:center}@media (min-width: 640px){.actions[data-v-303bb580]{padding-top:32px}}@media (min-width: 960px){.VPHero.has-image .actions[data-v-303bb580]{justify-content:flex-start}}.action[data-v-303bb580]{flex-shrink:0;padding:6px}.image[data-v-303bb580]{order:1;margin:-76px -24px -48px}@media (min-width: 640px){.image[data-v-303bb580]{margin:-108px -24px -48px}}@media (min-width: 960px){.image[data-v-303bb580]{flex-grow:1;order:2;margin:0;min-height:100%}}.image-container[data-v-303bb580]{position:relative;margin:0 auto;width:320px;height:320px}@media (min-width: 640px){.image-container[data-v-303bb580]{width:392px;height:392px}}@media (min-width: 960px){.image-container[data-v-303bb580]{display:flex;justify-content:center;align-items:center;width:100%;height:100%;transform:translate(-32px,-32px)}}.image-bg[data-v-303bb580]{position:absolute;top:50%;left:50%;border-radius:50%;width:192px;height:192px;background-image:var(--vp-home-hero-image-background-image);filter:var(--vp-home-hero-image-filter);transform:translate(-50%,-50%)}@media (min-width: 640px){.image-bg[data-v-303bb580]{width:256px;height:256px}}@media (min-width: 960px){.image-bg[data-v-303bb580]{width:320px;height:320px}}[data-v-303bb580] .image-src{position:absolute;top:50%;left:50%;max-width:192px;max-height:192px;transform:translate(-50%,-50%)}@media (min-width: 640px){[data-v-303bb580] .image-src{max-width:256px;max-height:256px}}@media (min-width: 960px){[data-v-303bb580] .image-src{max-width:320px;max-height:320px}}.VPFeature[data-v-a3976bdc]{display:block;border:1px solid var(--vp-c-bg-soft);border-radius:12px;height:100%;background-color:var(--vp-c-bg-soft);transition:border-color .25s,background-color .25s}.VPFeature.link[data-v-a3976bdc]:hover{border-color:var(--vp-c-brand-1)}.box[data-v-a3976bdc]{display:flex;flex-direction:column;padding:24px;height:100%}.box[data-v-a3976bdc]>.VPImage{margin-bottom:20px}.icon[data-v-a3976bdc]{display:flex;justify-content:center;align-items:center;margin-bottom:20px;border-radius:6px;background-color:var(--vp-c-default-soft);width:48px;height:48px;font-size:24px;transition:background-color .25s}.title[data-v-a3976bdc]{line-height:24px;font-size:16px;font-weight:600}.details[data-v-a3976bdc]{flex-grow:1;padding-top:8px;line-height:24px;font-size:14px;font-weight:500;color:var(--vp-c-text-2)}.link-text[data-v-a3976bdc]{padding-top:8px}.link-text-value[data-v-a3976bdc]{display:flex;align-items:center;font-size:14px;font-weight:500;color:var(--vp-c-brand-1)}.link-text-icon[data-v-a3976bdc]{margin-left:6px}.VPFeatures[data-v-a6181336]{position:relative;padding:0 24px}@media (min-width: 640px){.VPFeatures[data-v-a6181336]{padding:0 48px}}@media (min-width: 960px){.VPFeatures[data-v-a6181336]{padding:0 64px}}.container[data-v-a6181336]{margin:0 auto;max-width:1152px}.items[data-v-a6181336]{display:flex;flex-wrap:wrap;margin:-8px}.item[data-v-a6181336]{padding:8px;width:100%}@media (min-width: 640px){.item.grid-2[data-v-a6181336],.item.grid-4[data-v-a6181336],.item.grid-6[data-v-a6181336]{width:50%}}@media (min-width: 768px){.item.grid-2[data-v-a6181336],.item.grid-4[data-v-a6181336]{width:50%}.item.grid-3[data-v-a6181336],.item.grid-6[data-v-a6181336]{width:calc(100% / 3)}}@media (min-width: 960px){.item.grid-4[data-v-a6181336]{width:25%}}.container[data-v-8e2d4988]{margin:auto;width:100%;max-width:1280px;padding:0 24px}@media (min-width: 640px){.container[data-v-8e2d4988]{padding:0 48px}}@media (min-width: 960px){.container[data-v-8e2d4988]{width:100%;padding:0 64px}}.vp-doc[data-v-8e2d4988] .VPHomeSponsors,.vp-doc[data-v-8e2d4988] .VPTeamPage{margin-left:var(--vp-offset, calc(50% - 50vw) );margin-right:var(--vp-offset, calc(50% - 50vw) )}.vp-doc[data-v-8e2d4988] .VPHomeSponsors h2{border-top:none;letter-spacing:normal}.vp-doc[data-v-8e2d4988] .VPHomeSponsors a,.vp-doc[data-v-8e2d4988] .VPTeamPage a{text-decoration:none}.VPHome[data-v-686f80a6]{margin-bottom:96px}@media (min-width: 768px){.VPHome[data-v-686f80a6]{margin-bottom:128px}}.VPContent[data-v-1428d186]{flex-grow:1;flex-shrink:0;margin:var(--vp-layout-top-height, 0px) auto 0;width:100%}.VPContent.is-home[data-v-1428d186]{width:100%;max-width:100%}.VPContent.has-sidebar[data-v-1428d186]{margin:0}@media (min-width: 960px){.VPContent[data-v-1428d186]{padding-top:var(--vp-nav-height)}.VPContent.has-sidebar[data-v-1428d186]{margin:var(--vp-layout-top-height, 0px) 0 0;padding-left:var(--vp-sidebar-width)}}@media (min-width: 1440px){.VPContent.has-sidebar[data-v-1428d186]{padding-right:calc((100vw - var(--vp-layout-max-width)) / 2);padding-left:calc((100vw - var(--vp-layout-max-width)) / 2 + var(--vp-sidebar-width))}}.VPFooter[data-v-e315a0ad]{position:relative;z-index:var(--vp-z-index-footer);border-top:1px solid var(--vp-c-gutter);padding:32px 24px;background-color:var(--vp-c-bg)}.VPFooter.has-sidebar[data-v-e315a0ad]{display:none}.VPFooter[data-v-e315a0ad] a{text-decoration-line:underline;text-underline-offset:2px;transition:color .25s}.VPFooter[data-v-e315a0ad] a:hover{color:var(--vp-c-text-1)}@media (min-width: 768px){.VPFooter[data-v-e315a0ad]{padding:32px}}.container[data-v-e315a0ad]{margin:0 auto;max-width:var(--vp-layout-max-width);text-align:center}.message[data-v-e315a0ad],.copyright[data-v-e315a0ad]{line-height:24px;font-size:14px;font-weight:500;color:var(--vp-c-text-2)}.VPLocalNavOutlineDropdown[data-v-17a5e62e]{padding:12px 20px 11px}@media (min-width: 960px){.VPLocalNavOutlineDropdown[data-v-17a5e62e]{padding:12px 36px 11px}}.VPLocalNavOutlineDropdown button[data-v-17a5e62e]{display:block;font-size:12px;font-weight:500;line-height:24px;color:var(--vp-c-text-2);transition:color .5s;position:relative}.VPLocalNavOutlineDropdown button[data-v-17a5e62e]:hover{color:var(--vp-c-text-1);transition:color .25s}.VPLocalNavOutlineDropdown button.open[data-v-17a5e62e]{color:var(--vp-c-text-1)}.icon[data-v-17a5e62e]{display:inline-block;vertical-align:middle;margin-left:2px;font-size:14px;transform:rotate(0);transition:transform .25s}@media (min-width: 960px){.VPLocalNavOutlineDropdown button[data-v-17a5e62e]{font-size:14px}.icon[data-v-17a5e62e]{font-size:16px}}.open>.icon[data-v-17a5e62e]{transform:rotate(90deg)}.items[data-v-17a5e62e]{position:absolute;top:40px;right:16px;left:16px;display:grid;gap:1px;border:1px solid var(--vp-c-border);border-radius:8px;background-color:var(--vp-c-gutter);max-height:calc(var(--vp-vh, 100vh) - 86px);overflow:hidden auto;box-shadow:var(--vp-shadow-3)}@media (min-width: 960px){.items[data-v-17a5e62e]{right:auto;left:calc(var(--vp-sidebar-width) + 32px);width:320px}}.header[data-v-17a5e62e]{background-color:var(--vp-c-bg-soft)}.top-link[data-v-17a5e62e]{display:block;padding:0 16px;line-height:48px;font-size:14px;font-weight:500;color:var(--vp-c-brand-1)}.outline[data-v-17a5e62e]{padding:8px 0;background-color:var(--vp-c-bg-soft)}.flyout-enter-active[data-v-17a5e62e]{transition:all .2s ease-out}.flyout-leave-active[data-v-17a5e62e]{transition:all .15s ease-in}.flyout-enter-from[data-v-17a5e62e],.flyout-leave-to[data-v-17a5e62e]{opacity:0;transform:translateY(-16px)}.VPLocalNav[data-v-a6f0e41e]{position:sticky;top:0;left:0;z-index:var(--vp-z-index-local-nav);border-bottom:1px solid var(--vp-c-gutter);padding-top:var(--vp-layout-top-height, 0px);width:100%;background-color:var(--vp-local-nav-bg-color)}.VPLocalNav.fixed[data-v-a6f0e41e]{position:fixed}@media (min-width: 960px){.VPLocalNav[data-v-a6f0e41e]{top:var(--vp-nav-height)}.VPLocalNav.has-sidebar[data-v-a6f0e41e]{padding-left:var(--vp-sidebar-width)}.VPLocalNav.empty[data-v-a6f0e41e]{display:none}}@media (min-width: 1280px){.VPLocalNav[data-v-a6f0e41e]{display:none}}@media (min-width: 1440px){.VPLocalNav.has-sidebar[data-v-a6f0e41e]{padding-left:calc((100vw - var(--vp-layout-max-width)) / 2 + var(--vp-sidebar-width))}}.container[data-v-a6f0e41e]{display:flex;justify-content:space-between;align-items:center}.menu[data-v-a6f0e41e]{display:flex;align-items:center;padding:12px 24px 11px;line-height:24px;font-size:12px;font-weight:500;color:var(--vp-c-text-2);transition:color .5s}.menu[data-v-a6f0e41e]:hover{color:var(--vp-c-text-1);transition:color .25s}@media (min-width: 768px){.menu[data-v-a6f0e41e]{padding:0 32px}}@media (min-width: 960px){.menu[data-v-a6f0e41e]{display:none}}.menu-icon[data-v-a6f0e41e]{margin-right:8px;font-size:14px}.VPOutlineDropdown[data-v-a6f0e41e]{padding:12px 24px 11px}@media (min-width: 768px){.VPOutlineDropdown[data-v-a6f0e41e]{padding:12px 32px 11px}}.VPSwitch[data-v-1d5665e3]{position:relative;border-radius:11px;display:block;width:40px;height:22px;flex-shrink:0;border:1px solid var(--vp-input-border-color);background-color:var(--vp-input-switch-bg-color);transition:border-color .25s!important}.VPSwitch[data-v-1d5665e3]:hover{border-color:var(--vp-c-brand-1)}.check[data-v-1d5665e3]{position:absolute;top:1px;left:1px;width:18px;height:18px;border-radius:50%;background-color:var(--vp-c-neutral-inverse);box-shadow:var(--vp-shadow-1);transition:transform .25s!important}.icon[data-v-1d5665e3]{position:relative;display:block;width:18px;height:18px;border-radius:50%;overflow:hidden}.icon[data-v-1d5665e3] [class^=vpi-]{position:absolute;top:3px;left:3px;width:12px;height:12px;color:var(--vp-c-text-2)}.dark .icon[data-v-1d5665e3] [class^=vpi-]{color:var(--vp-c-text-1);transition:opacity .25s!important}.sun[data-v-d1f28634]{opacity:1}.moon[data-v-d1f28634],.dark .sun[data-v-d1f28634]{opacity:0}.dark .moon[data-v-d1f28634]{opacity:1}.dark .VPSwitchAppearance[data-v-d1f28634] .check{transform:translate(18px)}.VPNavBarAppearance[data-v-e6aabb21]{display:none}@media (min-width: 1280px){.VPNavBarAppearance[data-v-e6aabb21]{display:flex;align-items:center}}.VPMenuGroup+.VPMenuLink[data-v-43f1e123]{margin:12px -12px 0;border-top:1px solid var(--vp-c-divider);padding:12px 12px 0}.link[data-v-43f1e123]{display:block;border-radius:6px;padding:0 12px;line-height:32px;font-size:14px;font-weight:500;color:var(--vp-c-text-1);white-space:nowrap;transition:background-color .25s,color .25s}.link[data-v-43f1e123]:hover{color:var(--vp-c-brand-1);background-color:var(--vp-c-default-soft)}.link.active[data-v-43f1e123]{color:var(--vp-c-brand-1)}.VPMenuGroup[data-v-69e747b5]{margin:12px -12px 0;border-top:1px solid var(--vp-c-divider);padding:12px 12px 0}.VPMenuGroup[data-v-69e747b5]:first-child{margin-top:0;border-top:0;padding-top:0}.VPMenuGroup+.VPMenuGroup[data-v-69e747b5]{margin-top:12px;border-top:1px solid var(--vp-c-divider)}.title[data-v-69e747b5]{padding:0 12px;line-height:32px;font-size:14px;font-weight:600;color:var(--vp-c-text-2);white-space:nowrap;transition:color .25s}.VPMenu[data-v-e7ea1737]{border-radius:12px;padding:12px;min-width:128px;border:1px solid var(--vp-c-divider);background-color:var(--vp-c-bg-elv);box-shadow:var(--vp-shadow-3);transition:background-color .5s;max-height:calc(100vh - var(--vp-nav-height));overflow-y:auto}.VPMenu[data-v-e7ea1737] .group{margin:0 -12px;padding:0 12px 12px}.VPMenu[data-v-e7ea1737] .group+.group{border-top:1px solid var(--vp-c-divider);padding:11px 12px 12px}.VPMenu[data-v-e7ea1737] .group:last-child{padding-bottom:0}.VPMenu[data-v-e7ea1737] .group+.item{border-top:1px solid var(--vp-c-divider);padding:11px 16px 0}.VPMenu[data-v-e7ea1737] .item{padding:0 16px;white-space:nowrap}.VPMenu[data-v-e7ea1737] .label{flex-grow:1;line-height:28px;font-size:12px;font-weight:500;color:var(--vp-c-text-2);transition:color .5s}.VPMenu[data-v-e7ea1737] .action{padding-left:24px}.VPFlyout[data-v-b6c34ac9]{position:relative}.VPFlyout[data-v-b6c34ac9]:hover{color:var(--vp-c-brand-1);transition:color .25s}.VPFlyout:hover .text[data-v-b6c34ac9]{color:var(--vp-c-text-2)}.VPFlyout:hover .icon[data-v-b6c34ac9]{fill:var(--vp-c-text-2)}.VPFlyout.active .text[data-v-b6c34ac9]{color:var(--vp-c-brand-1)}.VPFlyout.active:hover .text[data-v-b6c34ac9]{color:var(--vp-c-brand-2)}.VPFlyout:hover .menu[data-v-b6c34ac9],.button[aria-expanded=true]+.menu[data-v-b6c34ac9]{opacity:1;visibility:visible;transform:translateY(0)}.button[aria-expanded=false]+.menu[data-v-b6c34ac9]{opacity:0;visibility:hidden;transform:translateY(0)}.button[data-v-b6c34ac9]{display:flex;align-items:center;padding:0 12px;height:var(--vp-nav-height);color:var(--vp-c-text-1);transition:color .5s}.text[data-v-b6c34ac9]{display:flex;align-items:center;line-height:var(--vp-nav-height);font-size:14px;font-weight:500;color:var(--vp-c-text-1);transition:color .25s}.option-icon[data-v-b6c34ac9]{margin-right:0;font-size:16px}.text-icon[data-v-b6c34ac9]{margin-left:4px;font-size:14px}.icon[data-v-b6c34ac9]{font-size:20px;transition:fill .25s}.menu[data-v-b6c34ac9]{position:absolute;top:calc(var(--vp-nav-height) / 2 + 20px);right:0;opacity:0;visibility:hidden;transition:opacity .25s,visibility .25s,transform .25s}.VPSocialLink[data-v-eee4e7cb]{display:flex;justify-content:center;align-items:center;width:36px;height:36px;color:var(--vp-c-text-2);transition:color .5s}.VPSocialLink[data-v-eee4e7cb]:hover{color:var(--vp-c-text-1);transition:color .25s}.VPSocialLink[data-v-eee4e7cb]>svg,.VPSocialLink[data-v-eee4e7cb]>[class^=vpi-social-]{width:20px;height:20px;fill:currentColor}.VPSocialLinks[data-v-7bc22406]{display:flex;justify-content:center}.VPNavBarExtra[data-v-d0bd9dde]{display:none;margin-right:-12px}@media (min-width: 768px){.VPNavBarExtra[data-v-d0bd9dde]{display:block}}@media (min-width: 1280px){.VPNavBarExtra[data-v-d0bd9dde]{display:none}}.trans-title[data-v-d0bd9dde]{padding:0 24px 0 12px;line-height:32px;font-size:14px;font-weight:700;color:var(--vp-c-text-1)}.item.appearance[data-v-d0bd9dde],.item.social-links[data-v-d0bd9dde]{display:flex;align-items:center;padding:0 12px}.item.appearance[data-v-d0bd9dde]{min-width:176px}.appearance-action[data-v-d0bd9dde]{margin-right:-2px}.social-links-list[data-v-d0bd9dde]{margin:-4px -8px}.VPNavBarHamburger[data-v-e5dd9c1c]{display:flex;justify-content:center;align-items:center;width:48px;height:var(--vp-nav-height)}@media (min-width: 768px){.VPNavBarHamburger[data-v-e5dd9c1c]{display:none}}.container[data-v-e5dd9c1c]{position:relative;width:16px;height:14px;overflow:hidden}.VPNavBarHamburger:hover .top[data-v-e5dd9c1c]{top:0;left:0;transform:translate(4px)}.VPNavBarHamburger:hover .middle[data-v-e5dd9c1c]{top:6px;left:0;transform:translate(0)}.VPNavBarHamburger:hover .bottom[data-v-e5dd9c1c]{top:12px;left:0;transform:translate(8px)}.VPNavBarHamburger.active .top[data-v-e5dd9c1c]{top:6px;transform:translate(0) rotate(225deg)}.VPNavBarHamburger.active .middle[data-v-e5dd9c1c]{top:6px;transform:translate(16px)}.VPNavBarHamburger.active .bottom[data-v-e5dd9c1c]{top:6px;transform:translate(0) rotate(135deg)}.VPNavBarHamburger.active:hover .top[data-v-e5dd9c1c],.VPNavBarHamburger.active:hover .middle[data-v-e5dd9c1c],.VPNavBarHamburger.active:hover .bottom[data-v-e5dd9c1c]{background-color:var(--vp-c-text-2);transition:top .25s,background-color .25s,transform .25s}.top[data-v-e5dd9c1c],.middle[data-v-e5dd9c1c],.bottom[data-v-e5dd9c1c]{position:absolute;width:16px;height:2px;background-color:var(--vp-c-text-1);transition:top .25s,background-color .5s,transform .25s}.top[data-v-e5dd9c1c]{top:0;left:0;transform:translate(0)}.middle[data-v-e5dd9c1c]{top:6px;left:0;transform:translate(8px)}.bottom[data-v-e5dd9c1c]{top:12px;left:0;transform:translate(4px)}.VPNavBarMenuLink[data-v-9c663999]{display:flex;align-items:center;padding:0 12px;line-height:var(--vp-nav-height);font-size:14px;font-weight:500;color:var(--vp-c-text-1);transition:color .25s}.VPNavBarMenuLink.active[data-v-9c663999],.VPNavBarMenuLink[data-v-9c663999]:hover{color:var(--vp-c-brand-1)}.VPNavBarMenu[data-v-7f418b0f]{display:none}@media (min-width: 768px){.VPNavBarMenu[data-v-7f418b0f]{display:flex}}/*! @docsearch/css 3.6.0 | MIT License | © Algolia, Inc. and contributors | https://docsearch.algolia.com */:root{--docsearch-primary-color:#5468ff;--docsearch-text-color:#1c1e21;--docsearch-spacing:12px;--docsearch-icon-stroke-width:1.4;--docsearch-highlight-color:var(--docsearch-primary-color);--docsearch-muted-color:#969faf;--docsearch-container-background:rgba(101,108,133,.8);--docsearch-logo-color:#5468ff;--docsearch-modal-width:560px;--docsearch-modal-height:600px;--docsearch-modal-background:#f5f6f7;--docsearch-modal-shadow:inset 1px 1px 0 0 hsla(0,0%,100%,.5),0 3px 8px 0 #555a64;--docsearch-searchbox-height:56px;--docsearch-searchbox-background:#ebedf0;--docsearch-searchbox-focus-background:#fff;--docsearch-searchbox-shadow:inset 0 0 0 2px var(--docsearch-primary-color);--docsearch-hit-height:56px;--docsearch-hit-color:#444950;--docsearch-hit-active-color:#fff;--docsearch-hit-background:#fff;--docsearch-hit-shadow:0 1px 3px 0 #d4d9e1;--docsearch-key-gradient:linear-gradient(-225deg,#d5dbe4,#f8f8f8);--docsearch-key-shadow:inset 0 -2px 0 0 #cdcde6,inset 0 0 1px 1px #fff,0 1px 2px 1px rgba(30,35,90,.4);--docsearch-key-pressed-shadow:inset 0 -2px 0 0 #cdcde6,inset 0 0 1px 1px #fff,0 1px 1px 0 rgba(30,35,90,.4);--docsearch-footer-height:44px;--docsearch-footer-background:#fff;--docsearch-footer-shadow:0 -1px 0 0 #e0e3e8,0 -3px 6px 0 rgba(69,98,155,.12)}html[data-theme=dark]{--docsearch-text-color:#f5f6f7;--docsearch-container-background:rgba(9,10,17,.8);--docsearch-modal-background:#15172a;--docsearch-modal-shadow:inset 1px 1px 0 0 #2c2e40,0 3px 8px 0 #000309;--docsearch-searchbox-background:#090a11;--docsearch-searchbox-focus-background:#000;--docsearch-hit-color:#bec3c9;--docsearch-hit-shadow:none;--docsearch-hit-background:#090a11;--docsearch-key-gradient:linear-gradient(-26.5deg,#565872,#31355b);--docsearch-key-shadow:inset 0 -2px 0 0 #282d55,inset 0 0 1px 1px #51577d,0 2px 2px 0 rgba(3,4,9,.3);--docsearch-key-pressed-shadow:inset 0 -2px 0 0 #282d55,inset 0 0 1px 1px #51577d,0 1px 1px 0 rgba(3,4,9,.30196078431372547);--docsearch-footer-background:#1e2136;--docsearch-footer-shadow:inset 0 1px 0 0 rgba(73,76,106,.5),0 -4px 8px 0 rgba(0,0,0,.2);--docsearch-logo-color:#fff;--docsearch-muted-color:#7f8497}.DocSearch-Button{align-items:center;background:var(--docsearch-searchbox-background);border:0;border-radius:40px;color:var(--docsearch-muted-color);cursor:pointer;display:flex;font-weight:500;height:36px;justify-content:space-between;margin:0 0 0 16px;padding:0 8px;-webkit-user-select:none;user-select:none}.DocSearch-Button:active,.DocSearch-Button:focus,.DocSearch-Button:hover{background:var(--docsearch-searchbox-focus-background);box-shadow:var(--docsearch-searchbox-shadow);color:var(--docsearch-text-color);outline:none}.DocSearch-Button-Container{align-items:center;display:flex}.DocSearch-Search-Icon{stroke-width:1.6}.DocSearch-Button .DocSearch-Search-Icon{color:var(--docsearch-text-color)}.DocSearch-Button-Placeholder{font-size:1rem;padding:0 12px 0 6px}.DocSearch-Button-Keys{display:flex;min-width:calc(40px + .8em)}.DocSearch-Button-Key{align-items:center;background:var(--docsearch-key-gradient);border-radius:3px;box-shadow:var(--docsearch-key-shadow);color:var(--docsearch-muted-color);display:flex;height:18px;justify-content:center;margin-right:.4em;position:relative;padding:0 0 2px;border:0;top:-1px;width:20px}.DocSearch-Button-Key--pressed{transform:translate3d(0,1px,0);box-shadow:var(--docsearch-key-pressed-shadow)}@media (max-width:768px){.DocSearch-Button-Keys,.DocSearch-Button-Placeholder{display:none}}.DocSearch--active{overflow:hidden!important}.DocSearch-Container,.DocSearch-Container *{box-sizing:border-box}.DocSearch-Container{background-color:var(--docsearch-container-background);height:100vh;left:0;position:fixed;top:0;width:100vw;z-index:200}.DocSearch-Container a{text-decoration:none}.DocSearch-Link{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;color:var(--docsearch-highlight-color);cursor:pointer;font:inherit;margin:0;padding:0}.DocSearch-Modal{background:var(--docsearch-modal-background);border-radius:6px;box-shadow:var(--docsearch-modal-shadow);flex-direction:column;margin:60px auto auto;max-width:var(--docsearch-modal-width);position:relative}.DocSearch-SearchBar{display:flex;padding:var(--docsearch-spacing) var(--docsearch-spacing) 0}.DocSearch-Form{align-items:center;background:var(--docsearch-searchbox-focus-background);border-radius:4px;box-shadow:var(--docsearch-searchbox-shadow);display:flex;height:var(--docsearch-searchbox-height);margin:0;padding:0 var(--docsearch-spacing);position:relative;width:100%}.DocSearch-Input{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:transparent;border:0;color:var(--docsearch-text-color);flex:1;font:inherit;font-size:1.2em;height:100%;outline:none;padding:0 0 0 8px;width:80%}.DocSearch-Input::placeholder{color:var(--docsearch-muted-color);opacity:1}.DocSearch-Input::-webkit-search-cancel-button,.DocSearch-Input::-webkit-search-decoration,.DocSearch-Input::-webkit-search-results-button,.DocSearch-Input::-webkit-search-results-decoration{display:none}.DocSearch-LoadingIndicator,.DocSearch-MagnifierLabel,.DocSearch-Reset{margin:0;padding:0}.DocSearch-MagnifierLabel,.DocSearch-Reset{align-items:center;color:var(--docsearch-highlight-color);display:flex;justify-content:center}.DocSearch-Container--Stalled .DocSearch-MagnifierLabel,.DocSearch-LoadingIndicator{display:none}.DocSearch-Container--Stalled .DocSearch-LoadingIndicator{align-items:center;color:var(--docsearch-highlight-color);display:flex;justify-content:center}@media screen and (prefers-reduced-motion:reduce){.DocSearch-Reset{animation:none;-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;border-radius:50%;color:var(--docsearch-icon-color);cursor:pointer;right:0;stroke-width:var(--docsearch-icon-stroke-width)}}.DocSearch-Reset{animation:fade-in .1s ease-in forwards;-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;border-radius:50%;color:var(--docsearch-icon-color);cursor:pointer;padding:2px;right:0;stroke-width:var(--docsearch-icon-stroke-width)}.DocSearch-Reset[hidden]{display:none}.DocSearch-Reset:hover{color:var(--docsearch-highlight-color)}.DocSearch-LoadingIndicator svg,.DocSearch-MagnifierLabel svg{height:24px;width:24px}.DocSearch-Cancel{display:none}.DocSearch-Dropdown{max-height:calc(var(--docsearch-modal-height) - var(--docsearch-searchbox-height) - var(--docsearch-spacing) - var(--docsearch-footer-height));min-height:var(--docsearch-spacing);overflow-y:auto;overflow-y:overlay;padding:0 var(--docsearch-spacing);scrollbar-color:var(--docsearch-muted-color) var(--docsearch-modal-background);scrollbar-width:thin}.DocSearch-Dropdown::-webkit-scrollbar{width:12px}.DocSearch-Dropdown::-webkit-scrollbar-track{background:transparent}.DocSearch-Dropdown::-webkit-scrollbar-thumb{background-color:var(--docsearch-muted-color);border:3px solid var(--docsearch-modal-background);border-radius:20px}.DocSearch-Dropdown ul{list-style:none;margin:0;padding:0}.DocSearch-Label{font-size:.75em;line-height:1.6em}.DocSearch-Help,.DocSearch-Label{color:var(--docsearch-muted-color)}.DocSearch-Help{font-size:.9em;margin:0;-webkit-user-select:none;user-select:none}.DocSearch-Title{font-size:1.2em}.DocSearch-Logo a{display:flex}.DocSearch-Logo svg{color:var(--docsearch-logo-color);margin-left:8px}.DocSearch-Hits:last-of-type{margin-bottom:24px}.DocSearch-Hits mark{background:none;color:var(--docsearch-highlight-color)}.DocSearch-HitsFooter{color:var(--docsearch-muted-color);display:flex;font-size:.85em;justify-content:center;margin-bottom:var(--docsearch-spacing);padding:var(--docsearch-spacing)}.DocSearch-HitsFooter a{border-bottom:1px solid;color:inherit}.DocSearch-Hit{border-radius:4px;display:flex;padding-bottom:4px;position:relative}@media screen and (prefers-reduced-motion:reduce){.DocSearch-Hit--deleting{transition:none}}.DocSearch-Hit--deleting{opacity:0;transition:all .25s linear}@media screen and (prefers-reduced-motion:reduce){.DocSearch-Hit--favoriting{transition:none}}.DocSearch-Hit--favoriting{transform:scale(0);transform-origin:top center;transition:all .25s linear;transition-delay:.25s}.DocSearch-Hit a{background:var(--docsearch-hit-background);border-radius:4px;box-shadow:var(--docsearch-hit-shadow);display:block;padding-left:var(--docsearch-spacing);width:100%}.DocSearch-Hit-source{background:var(--docsearch-modal-background);color:var(--docsearch-highlight-color);font-size:.85em;font-weight:600;line-height:32px;margin:0 -4px;padding:8px 4px 0;position:sticky;top:0;z-index:10}.DocSearch-Hit-Tree{color:var(--docsearch-muted-color);height:var(--docsearch-hit-height);opacity:.5;stroke-width:var(--docsearch-icon-stroke-width);width:24px}.DocSearch-Hit[aria-selected=true] a{background-color:var(--docsearch-highlight-color)}.DocSearch-Hit[aria-selected=true] mark{text-decoration:underline}.DocSearch-Hit-Container{align-items:center;color:var(--docsearch-hit-color);display:flex;flex-direction:row;height:var(--docsearch-hit-height);padding:0 var(--docsearch-spacing) 0 0}.DocSearch-Hit-icon{height:20px;width:20px}.DocSearch-Hit-action,.DocSearch-Hit-icon{color:var(--docsearch-muted-color);stroke-width:var(--docsearch-icon-stroke-width)}.DocSearch-Hit-action{align-items:center;display:flex;height:22px;width:22px}.DocSearch-Hit-action svg{display:block;height:18px;width:18px}.DocSearch-Hit-action+.DocSearch-Hit-action{margin-left:6px}.DocSearch-Hit-action-button{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;border-radius:50%;color:inherit;cursor:pointer;padding:2px}svg.DocSearch-Hit-Select-Icon{display:none}.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-Select-Icon{display:block}.DocSearch-Hit-action-button:focus,.DocSearch-Hit-action-button:hover{background:#0003;transition:background-color .1s ease-in}@media screen and (prefers-reduced-motion:reduce){.DocSearch-Hit-action-button:focus,.DocSearch-Hit-action-button:hover{transition:none}}.DocSearch-Hit-action-button:focus path,.DocSearch-Hit-action-button:hover path{fill:#fff}.DocSearch-Hit-content-wrapper{display:flex;flex:1 1 auto;flex-direction:column;font-weight:500;justify-content:center;line-height:1.2em;margin:0 8px;overflow-x:hidden;position:relative;text-overflow:ellipsis;white-space:nowrap;width:80%}.DocSearch-Hit-title{font-size:.9em}.DocSearch-Hit-path{color:var(--docsearch-muted-color);font-size:.75em}.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-action,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-icon,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-path,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-text,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-title,.DocSearch-Hit[aria-selected=true] .DocSearch-Hit-Tree,.DocSearch-Hit[aria-selected=true] mark{color:var(--docsearch-hit-active-color)!important}@media screen and (prefers-reduced-motion:reduce){.DocSearch-Hit-action-button:focus,.DocSearch-Hit-action-button:hover{background:#0003;transition:none}}.DocSearch-ErrorScreen,.DocSearch-NoResults,.DocSearch-StartScreen{font-size:.9em;margin:0 auto;padding:36px 0;text-align:center;width:80%}.DocSearch-Screen-Icon{color:var(--docsearch-muted-color);padding-bottom:12px}.DocSearch-NoResults-Prefill-List{display:inline-block;padding-bottom:24px;text-align:left}.DocSearch-NoResults-Prefill-List ul{display:inline-block;padding:8px 0 0}.DocSearch-NoResults-Prefill-List li{list-style-position:inside;list-style-type:"» "}.DocSearch-Prefill{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;border-radius:1em;color:var(--docsearch-highlight-color);cursor:pointer;display:inline-block;font-size:1em;font-weight:700;padding:0}.DocSearch-Prefill:focus,.DocSearch-Prefill:hover{outline:none;text-decoration:underline}.DocSearch-Footer{align-items:center;background:var(--docsearch-footer-background);border-radius:0 0 8px 8px;box-shadow:var(--docsearch-footer-shadow);display:flex;flex-direction:row-reverse;flex-shrink:0;height:var(--docsearch-footer-height);justify-content:space-between;padding:0 var(--docsearch-spacing);position:relative;-webkit-user-select:none;user-select:none;width:100%;z-index:300}.DocSearch-Commands{color:var(--docsearch-muted-color);display:flex;list-style:none;margin:0;padding:0}.DocSearch-Commands li{align-items:center;display:flex}.DocSearch-Commands li:not(:last-of-type){margin-right:.8em}.DocSearch-Commands-Key{align-items:center;background:var(--docsearch-key-gradient);border-radius:2px;box-shadow:var(--docsearch-key-shadow);display:flex;height:18px;justify-content:center;margin-right:.4em;padding:0 0 1px;color:var(--docsearch-muted-color);border:0;width:20px}.DocSearch-VisuallyHiddenForAccessibility{clip:rect(0 0 0 0);clip-path:inset(50%);height:1px;overflow:hidden;position:absolute;white-space:nowrap;width:1px}@media (max-width:768px){:root{--docsearch-spacing:10px;--docsearch-footer-height:40px}.DocSearch-Dropdown{height:100%}.DocSearch-Container{height:100vh;height:-webkit-fill-available;height:calc(var(--docsearch-vh, 1vh)*100);position:absolute}.DocSearch-Footer{border-radius:0;bottom:0;position:absolute}.DocSearch-Hit-content-wrapper{display:flex;position:relative;width:80%}.DocSearch-Modal{border-radius:0;box-shadow:none;height:100vh;height:-webkit-fill-available;height:calc(var(--docsearch-vh, 1vh)*100);margin:0;max-width:100%;width:100%}.DocSearch-Dropdown{max-height:calc(var(--docsearch-vh, 1vh)*100 - var(--docsearch-searchbox-height) - var(--docsearch-spacing) - var(--docsearch-footer-height))}.DocSearch-Cancel{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:none;border:0;color:var(--docsearch-highlight-color);cursor:pointer;display:inline-block;flex:none;font:inherit;font-size:1em;font-weight:500;margin-left:var(--docsearch-spacing);outline:none;overflow:hidden;padding:0;-webkit-user-select:none;user-select:none;white-space:nowrap}.DocSearch-Commands,.DocSearch-Hit-Tree{display:none}}@keyframes fade-in{0%{opacity:0}to{opacity:1}}[class*=DocSearch]{--docsearch-primary-color: var(--vp-c-brand-1);--docsearch-highlight-color: var(--docsearch-primary-color);--docsearch-text-color: var(--vp-c-text-1);--docsearch-muted-color: var(--vp-c-text-2);--docsearch-searchbox-shadow: none;--docsearch-searchbox-background: transparent;--docsearch-searchbox-focus-background: transparent;--docsearch-key-gradient: transparent;--docsearch-key-shadow: none;--docsearch-modal-background: var(--vp-c-bg-soft);--docsearch-footer-background: var(--vp-c-bg)}.dark [class*=DocSearch]{--docsearch-modal-shadow: none;--docsearch-footer-shadow: none;--docsearch-logo-color: var(--vp-c-text-2);--docsearch-hit-background: var(--vp-c-default-soft);--docsearch-hit-color: var(--vp-c-text-2);--docsearch-hit-shadow: none}.DocSearch-Button{display:flex;justify-content:center;align-items:center;margin:0;padding:0;width:48px;height:55px;background:transparent;transition:border-color .25s}.DocSearch-Button:hover{background:transparent}.DocSearch-Button:focus{outline:1px dotted;outline:5px auto -webkit-focus-ring-color}.DocSearch-Button-Key--pressed{transform:none;box-shadow:none}.DocSearch-Button:focus:not(:focus-visible){outline:none!important}@media (min-width: 768px){.DocSearch-Button{justify-content:flex-start;border:1px solid transparent;border-radius:8px;padding:0 10px 0 12px;width:100%;height:40px;background-color:var(--vp-c-bg-alt)}.DocSearch-Button:hover{border-color:var(--vp-c-brand-1);background:var(--vp-c-bg-alt)}}.DocSearch-Button .DocSearch-Button-Container{display:flex;align-items:center}.DocSearch-Button .DocSearch-Search-Icon{position:relative;width:16px;height:16px;color:var(--vp-c-text-1);fill:currentColor;transition:color .5s}.DocSearch-Button:hover .DocSearch-Search-Icon{color:var(--vp-c-text-1)}@media (min-width: 768px){.DocSearch-Button .DocSearch-Search-Icon{top:1px;margin-right:8px;width:14px;height:14px;color:var(--vp-c-text-2)}}.DocSearch-Button .DocSearch-Button-Placeholder{display:none;margin-top:2px;padding:0 16px 0 0;font-size:13px;font-weight:500;color:var(--vp-c-text-2);transition:color .5s}.DocSearch-Button:hover .DocSearch-Button-Placeholder{color:var(--vp-c-text-1)}@media (min-width: 768px){.DocSearch-Button .DocSearch-Button-Placeholder{display:inline-block}}.DocSearch-Button .DocSearch-Button-Keys{direction:ltr;display:none;min-width:auto}@media (min-width: 768px){.DocSearch-Button .DocSearch-Button-Keys{display:flex;align-items:center}}.DocSearch-Button .DocSearch-Button-Key{display:block;margin:2px 0 0;border:1px solid var(--vp-c-divider);border-right:none;border-radius:4px 0 0 4px;padding-left:6px;min-width:0;width:auto;height:22px;line-height:22px;font-family:var(--vp-font-family-base);font-size:12px;font-weight:500;transition:color .5s,border-color .5s}.DocSearch-Button .DocSearch-Button-Key+.DocSearch-Button-Key{border-right:1px solid var(--vp-c-divider);border-left:none;border-radius:0 4px 4px 0;padding-left:2px;padding-right:6px}.DocSearch-Button .DocSearch-Button-Key:first-child{font-size:0!important}.DocSearch-Button .DocSearch-Button-Key:first-child:after{content:"Ctrl";font-size:12px;letter-spacing:normal;color:var(--docsearch-muted-color)}.mac .DocSearch-Button .DocSearch-Button-Key:first-child:after{content:"⌘"}.DocSearch-Button .DocSearch-Button-Key:first-child>*{display:none}.DocSearch-Search-Icon{--icon: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' stroke-width='1.6' viewBox='0 0 20 20'%3E%3Cpath fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' d='m14.386 14.386 4.088 4.088-4.088-4.088A7.533 7.533 0 1 1 3.733 3.733a7.533 7.533 0 0 1 10.653 10.653z'/%3E%3C/svg%3E")}.VPNavBarSearch{display:flex;align-items:center}@media (min-width: 768px){.VPNavBarSearch{flex-grow:1;padding-left:24px}}@media (min-width: 960px){.VPNavBarSearch{padding-left:32px}}.dark .DocSearch-Footer{border-top:1px solid var(--vp-c-divider)}.DocSearch-Form{border:1px solid var(--vp-c-brand-1);background-color:var(--vp-c-white)}.dark .DocSearch-Form{background-color:var(--vp-c-default-soft)}.DocSearch-Screen-Icon>svg{margin:auto}.VPNavBarSocialLinks[data-v-0394ad82]{display:none}@media (min-width: 1280px){.VPNavBarSocialLinks[data-v-0394ad82]{display:flex;align-items:center}}.title[data-v-ab179fa1]{display:flex;align-items:center;border-bottom:1px solid transparent;width:100%;height:var(--vp-nav-height);font-size:16px;font-weight:600;color:var(--vp-c-text-1);transition:opacity .25s}@media (min-width: 960px){.title[data-v-ab179fa1]{flex-shrink:0}.VPNavBarTitle.has-sidebar .title[data-v-ab179fa1]{border-bottom-color:var(--vp-c-divider)}}[data-v-ab179fa1] .logo{margin-right:8px;height:var(--vp-nav-logo-height)}.VPNavBarTranslations[data-v-88af2de4]{display:none}@media (min-width: 1280px){.VPNavBarTranslations[data-v-88af2de4]{display:flex;align-items:center}}.title[data-v-88af2de4]{padding:0 24px 0 12px;line-height:32px;font-size:14px;font-weight:700;color:var(--vp-c-text-1)}.VPNavBar[data-v-ccf7ddec]{position:relative;height:var(--vp-nav-height);pointer-events:none;white-space:nowrap;transition:background-color .5s}.VPNavBar[data-v-ccf7ddec]:not(.home){background-color:var(--vp-nav-bg-color)}@media (min-width: 960px){.VPNavBar[data-v-ccf7ddec]:not(.home){background-color:transparent}.VPNavBar[data-v-ccf7ddec]:not(.has-sidebar):not(.home.top){background-color:var(--vp-nav-bg-color)}}.wrapper[data-v-ccf7ddec]{padding:0 8px 0 24px}@media (min-width: 768px){.wrapper[data-v-ccf7ddec]{padding:0 32px}}@media (min-width: 960px){.VPNavBar.has-sidebar .wrapper[data-v-ccf7ddec]{padding:0}}.container[data-v-ccf7ddec]{display:flex;justify-content:space-between;margin:0 auto;max-width:calc(var(--vp-layout-max-width) - 64px);height:var(--vp-nav-height);pointer-events:none}.container>.title[data-v-ccf7ddec],.container>.content[data-v-ccf7ddec]{pointer-events:none}.container[data-v-ccf7ddec] *{pointer-events:auto}@media (min-width: 960px){.VPNavBar.has-sidebar .container[data-v-ccf7ddec]{max-width:100%}}.title[data-v-ccf7ddec]{flex-shrink:0;height:calc(var(--vp-nav-height) - 1px);transition:background-color .5s}@media (min-width: 960px){.VPNavBar.has-sidebar .title[data-v-ccf7ddec]{position:absolute;top:0;left:0;z-index:2;padding:0 32px;width:var(--vp-sidebar-width);height:var(--vp-nav-height);background-color:transparent}}@media (min-width: 1440px){.VPNavBar.has-sidebar .title[data-v-ccf7ddec]{padding-left:max(32px,calc((100% - (var(--vp-layout-max-width) - 64px)) / 2));width:calc((100% - (var(--vp-layout-max-width) - 64px)) / 2 + var(--vp-sidebar-width) - 32px)}}.content[data-v-ccf7ddec]{flex-grow:1}@media (min-width: 960px){.VPNavBar.has-sidebar .content[data-v-ccf7ddec]{position:relative;z-index:1;padding-right:32px;padding-left:var(--vp-sidebar-width)}}@media (min-width: 1440px){.VPNavBar.has-sidebar .content[data-v-ccf7ddec]{padding-right:calc((100vw - var(--vp-layout-max-width)) / 2 + 32px);padding-left:calc((100vw - var(--vp-layout-max-width)) / 2 + var(--vp-sidebar-width))}}.content-body[data-v-ccf7ddec]{display:flex;justify-content:flex-end;align-items:center;height:var(--vp-nav-height);transition:background-color .5s}@media (min-width: 960px){.VPNavBar:not(.home.top) .content-body[data-v-ccf7ddec]{position:relative;background-color:var(--vp-nav-bg-color)}.VPNavBar:not(.has-sidebar):not(.home.top) .content-body[data-v-ccf7ddec]{background-color:transparent}}@media (max-width: 767px){.content-body[data-v-ccf7ddec]{column-gap:.5rem}}.menu+.translations[data-v-ccf7ddec]:before,.menu+.appearance[data-v-ccf7ddec]:before,.menu+.social-links[data-v-ccf7ddec]:before,.translations+.appearance[data-v-ccf7ddec]:before,.appearance+.social-links[data-v-ccf7ddec]:before{margin-right:8px;margin-left:8px;width:1px;height:24px;background-color:var(--vp-c-divider);content:""}.menu+.appearance[data-v-ccf7ddec]:before,.translations+.appearance[data-v-ccf7ddec]:before{margin-right:16px}.appearance+.social-links[data-v-ccf7ddec]:before{margin-left:16px}.social-links[data-v-ccf7ddec]{margin-right:-8px}.divider[data-v-ccf7ddec]{width:100%;height:1px}@media (min-width: 960px){.VPNavBar.has-sidebar .divider[data-v-ccf7ddec]{padding-left:var(--vp-sidebar-width)}}@media (min-width: 1440px){.VPNavBar.has-sidebar .divider[data-v-ccf7ddec]{padding-left:calc((100vw - var(--vp-layout-max-width)) / 2 + var(--vp-sidebar-width))}}.divider-line[data-v-ccf7ddec]{width:100%;height:1px;transition:background-color .5s}.VPNavBar:not(.home) .divider-line[data-v-ccf7ddec]{background-color:var(--vp-c-gutter)}@media (min-width: 960px){.VPNavBar:not(.home.top) .divider-line[data-v-ccf7ddec]{background-color:var(--vp-c-gutter)}.VPNavBar:not(.has-sidebar):not(.home.top) .divider[data-v-ccf7ddec]{background-color:var(--vp-c-gutter)}}.VPNavScreenAppearance[data-v-2d7af913]{display:flex;justify-content:space-between;align-items:center;border-radius:8px;padding:12px 14px 12px 16px;background-color:var(--vp-c-bg-soft)}.text[data-v-2d7af913]{line-height:24px;font-size:12px;font-weight:500;color:var(--vp-c-text-2)}.VPNavScreenMenuLink[data-v-7f31e1f6]{display:block;border-bottom:1px solid var(--vp-c-divider);padding:12px 0 11px;line-height:24px;font-size:14px;font-weight:500;color:var(--vp-c-text-1);transition:border-color .25s,color .25s}.VPNavScreenMenuLink[data-v-7f31e1f6]:hover{color:var(--vp-c-brand-1)}.VPNavScreenMenuGroupLink[data-v-19976ae1]{display:block;margin-left:12px;line-height:32px;font-size:14px;font-weight:400;color:var(--vp-c-text-1);transition:color .25s}.VPNavScreenMenuGroupLink[data-v-19976ae1]:hover{color:var(--vp-c-brand-1)}.VPNavScreenMenuGroupSection[data-v-8133b170]{display:block}.title[data-v-8133b170]{line-height:32px;font-size:13px;font-weight:700;color:var(--vp-c-text-2);transition:color .25s}.VPNavScreenMenuGroup[data-v-ff6087d4]{border-bottom:1px solid var(--vp-c-divider);height:48px;overflow:hidden;transition:border-color .5s}.VPNavScreenMenuGroup .items[data-v-ff6087d4]{visibility:hidden}.VPNavScreenMenuGroup.open .items[data-v-ff6087d4]{visibility:visible}.VPNavScreenMenuGroup.open[data-v-ff6087d4]{padding-bottom:10px;height:auto}.VPNavScreenMenuGroup.open .button[data-v-ff6087d4]{padding-bottom:6px;color:var(--vp-c-brand-1)}.VPNavScreenMenuGroup.open .button-icon[data-v-ff6087d4]{transform:rotate(45deg)}.button[data-v-ff6087d4]{display:flex;justify-content:space-between;align-items:center;padding:12px 4px 11px 0;width:100%;line-height:24px;font-size:14px;font-weight:500;color:var(--vp-c-text-1);transition:color .25s}.button[data-v-ff6087d4]:hover{color:var(--vp-c-brand-1)}.button-icon[data-v-ff6087d4]{transition:transform .25s}.group[data-v-ff6087d4]:first-child{padding-top:0}.group+.group[data-v-ff6087d4],.group+.item[data-v-ff6087d4]{padding-top:4px}.VPNavScreenTranslations[data-v-858fe1a4]{height:24px;overflow:hidden}.VPNavScreenTranslations.open[data-v-858fe1a4]{height:auto}.title[data-v-858fe1a4]{display:flex;align-items:center;font-size:14px;font-weight:500;color:var(--vp-c-text-1)}.icon[data-v-858fe1a4]{font-size:16px}.icon.lang[data-v-858fe1a4]{margin-right:8px}.icon.chevron[data-v-858fe1a4]{margin-left:4px}.list[data-v-858fe1a4]{padding:4px 0 0 24px}.link[data-v-858fe1a4]{line-height:32px;font-size:13px;color:var(--vp-c-text-1)}.VPNavScreen[data-v-cc5739dd]{position:fixed;top:calc(var(--vp-nav-height) + var(--vp-layout-top-height, 0px) + 1px);right:0;bottom:0;left:0;padding:0 32px;width:100%;background-color:var(--vp-nav-screen-bg-color);overflow-y:auto;transition:background-color .5s;pointer-events:auto}.VPNavScreen.fade-enter-active[data-v-cc5739dd],.VPNavScreen.fade-leave-active[data-v-cc5739dd]{transition:opacity .25s}.VPNavScreen.fade-enter-active .container[data-v-cc5739dd],.VPNavScreen.fade-leave-active .container[data-v-cc5739dd]{transition:transform .25s ease}.VPNavScreen.fade-enter-from[data-v-cc5739dd],.VPNavScreen.fade-leave-to[data-v-cc5739dd]{opacity:0}.VPNavScreen.fade-enter-from .container[data-v-cc5739dd],.VPNavScreen.fade-leave-to .container[data-v-cc5739dd]{transform:translateY(-8px)}@media (min-width: 768px){.VPNavScreen[data-v-cc5739dd]{display:none}}.container[data-v-cc5739dd]{margin:0 auto;padding:24px 0 96px;max-width:288px}.menu+.translations[data-v-cc5739dd],.menu+.appearance[data-v-cc5739dd],.translations+.appearance[data-v-cc5739dd]{margin-top:24px}.menu+.social-links[data-v-cc5739dd]{margin-top:16px}.appearance+.social-links[data-v-cc5739dd]{margin-top:16px}.VPNav[data-v-ae24b3ad]{position:relative;top:var(--vp-layout-top-height, 0px);left:0;z-index:var(--vp-z-index-nav);width:100%;pointer-events:none;transition:background-color .5s}@media (min-width: 960px){.VPNav[data-v-ae24b3ad]{position:fixed}}.VPSidebarItem.level-0[data-v-b8d55f3b]{padding-bottom:24px}.VPSidebarItem.collapsed.level-0[data-v-b8d55f3b]{padding-bottom:10px}.item[data-v-b8d55f3b]{position:relative;display:flex;width:100%}.VPSidebarItem.collapsible>.item[data-v-b8d55f3b]{cursor:pointer}.indicator[data-v-b8d55f3b]{position:absolute;top:6px;bottom:6px;left:-17px;width:2px;border-radius:2px;transition:background-color .25s}.VPSidebarItem.level-2.is-active>.item>.indicator[data-v-b8d55f3b],.VPSidebarItem.level-3.is-active>.item>.indicator[data-v-b8d55f3b],.VPSidebarItem.level-4.is-active>.item>.indicator[data-v-b8d55f3b],.VPSidebarItem.level-5.is-active>.item>.indicator[data-v-b8d55f3b]{background-color:var(--vp-c-brand-1)}.link[data-v-b8d55f3b]{display:flex;align-items:center;flex-grow:1}.text[data-v-b8d55f3b]{flex-grow:1;padding:4px 0;line-height:24px;font-size:14px;transition:color .25s}.VPSidebarItem.level-0 .text[data-v-b8d55f3b]{font-weight:700;color:var(--vp-c-text-1)}.VPSidebarItem.level-1 .text[data-v-b8d55f3b],.VPSidebarItem.level-2 .text[data-v-b8d55f3b],.VPSidebarItem.level-3 .text[data-v-b8d55f3b],.VPSidebarItem.level-4 .text[data-v-b8d55f3b],.VPSidebarItem.level-5 .text[data-v-b8d55f3b]{font-weight:500;color:var(--vp-c-text-2)}.VPSidebarItem.level-0.is-link>.item>.link:hover .text[data-v-b8d55f3b],.VPSidebarItem.level-1.is-link>.item>.link:hover .text[data-v-b8d55f3b],.VPSidebarItem.level-2.is-link>.item>.link:hover .text[data-v-b8d55f3b],.VPSidebarItem.level-3.is-link>.item>.link:hover .text[data-v-b8d55f3b],.VPSidebarItem.level-4.is-link>.item>.link:hover .text[data-v-b8d55f3b],.VPSidebarItem.level-5.is-link>.item>.link:hover .text[data-v-b8d55f3b]{color:var(--vp-c-brand-1)}.VPSidebarItem.level-0.has-active>.item>.text[data-v-b8d55f3b],.VPSidebarItem.level-1.has-active>.item>.text[data-v-b8d55f3b],.VPSidebarItem.level-2.has-active>.item>.text[data-v-b8d55f3b],.VPSidebarItem.level-3.has-active>.item>.text[data-v-b8d55f3b],.VPSidebarItem.level-4.has-active>.item>.text[data-v-b8d55f3b],.VPSidebarItem.level-5.has-active>.item>.text[data-v-b8d55f3b],.VPSidebarItem.level-0.has-active>.item>.link>.text[data-v-b8d55f3b],.VPSidebarItem.level-1.has-active>.item>.link>.text[data-v-b8d55f3b],.VPSidebarItem.level-2.has-active>.item>.link>.text[data-v-b8d55f3b],.VPSidebarItem.level-3.has-active>.item>.link>.text[data-v-b8d55f3b],.VPSidebarItem.level-4.has-active>.item>.link>.text[data-v-b8d55f3b],.VPSidebarItem.level-5.has-active>.item>.link>.text[data-v-b8d55f3b]{color:var(--vp-c-text-1)}.VPSidebarItem.level-0.is-active>.item .link>.text[data-v-b8d55f3b],.VPSidebarItem.level-1.is-active>.item .link>.text[data-v-b8d55f3b],.VPSidebarItem.level-2.is-active>.item .link>.text[data-v-b8d55f3b],.VPSidebarItem.level-3.is-active>.item .link>.text[data-v-b8d55f3b],.VPSidebarItem.level-4.is-active>.item .link>.text[data-v-b8d55f3b],.VPSidebarItem.level-5.is-active>.item .link>.text[data-v-b8d55f3b]{color:var(--vp-c-brand-1)}.caret[data-v-b8d55f3b]{display:flex;justify-content:center;align-items:center;margin-right:-7px;width:32px;height:32px;color:var(--vp-c-text-3);cursor:pointer;transition:color .25s;flex-shrink:0}.item:hover .caret[data-v-b8d55f3b]{color:var(--vp-c-text-2)}.item:hover .caret[data-v-b8d55f3b]:hover{color:var(--vp-c-text-1)}.caret-icon[data-v-b8d55f3b]{font-size:18px;transform:rotate(90deg);transition:transform .25s}.VPSidebarItem.collapsed .caret-icon[data-v-b8d55f3b]{transform:rotate(0)}.VPSidebarItem.level-1 .items[data-v-b8d55f3b],.VPSidebarItem.level-2 .items[data-v-b8d55f3b],.VPSidebarItem.level-3 .items[data-v-b8d55f3b],.VPSidebarItem.level-4 .items[data-v-b8d55f3b],.VPSidebarItem.level-5 .items[data-v-b8d55f3b]{border-left:1px solid var(--vp-c-divider);padding-left:16px}.VPSidebarItem.collapsed .items[data-v-b8d55f3b]{display:none}.VPSidebar[data-v-575e6a36]{position:fixed;top:var(--vp-layout-top-height, 0px);bottom:0;left:0;z-index:var(--vp-z-index-sidebar);padding:32px 32px 96px;width:calc(100vw - 64px);max-width:320px;background-color:var(--vp-sidebar-bg-color);opacity:0;box-shadow:var(--vp-c-shadow-3);overflow-x:hidden;overflow-y:auto;transform:translate(-100%);transition:opacity .5s,transform .25s ease;overscroll-behavior:contain}.VPSidebar.open[data-v-575e6a36]{opacity:1;visibility:visible;transform:translate(0);transition:opacity .25s,transform .5s cubic-bezier(.19,1,.22,1)}.dark .VPSidebar[data-v-575e6a36]{box-shadow:var(--vp-shadow-1)}@media (min-width: 960px){.VPSidebar[data-v-575e6a36]{padding-top:var(--vp-nav-height);width:var(--vp-sidebar-width);max-width:100%;background-color:var(--vp-sidebar-bg-color);opacity:1;visibility:visible;box-shadow:none;transform:translate(0)}}@media (min-width: 1440px){.VPSidebar[data-v-575e6a36]{padding-left:max(32px,calc((100% - (var(--vp-layout-max-width) - 64px)) / 2));width:calc((100% - (var(--vp-layout-max-width) - 64px)) / 2 + var(--vp-sidebar-width) - 32px)}}@media (min-width: 960px){.curtain[data-v-575e6a36]{position:sticky;top:-64px;left:0;z-index:1;margin-top:calc(var(--vp-nav-height) * -1);margin-right:-32px;margin-left:-32px;height:var(--vp-nav-height);background-color:var(--vp-sidebar-bg-color)}}.nav[data-v-575e6a36]{outline:0}.group+.group[data-v-575e6a36]{border-top:1px solid var(--vp-c-divider);padding-top:10px}@media (min-width: 960px){.group[data-v-575e6a36]{padding-top:10px;width:calc(var(--vp-sidebar-width) - 64px)}}.VPSkipLink[data-v-0f60ec36]{top:8px;left:8px;padding:8px 16px;z-index:999;border-radius:8px;font-size:12px;font-weight:700;text-decoration:none;color:var(--vp-c-brand-1);box-shadow:var(--vp-shadow-3);background-color:var(--vp-c-bg)}.VPSkipLink[data-v-0f60ec36]:focus{height:auto;width:auto;clip:auto;clip-path:none}@media (min-width: 1280px){.VPSkipLink[data-v-0f60ec36]{top:14px;left:16px}}.Layout[data-v-5d98c3a5]{display:flex;flex-direction:column;min-height:100vh}.VPHomeSponsors[data-v-3d121b4a]{border-top:1px solid var(--vp-c-gutter);padding-top:88px!important}.VPHomeSponsors[data-v-3d121b4a]{margin:96px 0}@media (min-width: 768px){.VPHomeSponsors[data-v-3d121b4a]{margin:128px 0}}.VPHomeSponsors[data-v-3d121b4a]{padding:0 24px}@media (min-width: 768px){.VPHomeSponsors[data-v-3d121b4a]{padding:0 48px}}@media (min-width: 960px){.VPHomeSponsors[data-v-3d121b4a]{padding:0 64px}}.container[data-v-3d121b4a]{margin:0 auto;max-width:1152px}.love[data-v-3d121b4a]{margin:0 auto;width:fit-content;font-size:28px;color:var(--vp-c-text-3)}.icon[data-v-3d121b4a]{display:inline-block}.message[data-v-3d121b4a]{margin:0 auto;padding-top:10px;max-width:320px;text-align:center;line-height:24px;font-size:16px;font-weight:500;color:var(--vp-c-text-2)}.sponsors[data-v-3d121b4a]{padding-top:32px}.action[data-v-3d121b4a]{padding-top:40px;text-align:center}.VPTeamPage[data-v-7c57f839]{margin:96px 0}@media (min-width: 768px){.VPTeamPage[data-v-7c57f839]{margin:128px 0}}.VPHome .VPTeamPageTitle[data-v-7c57f839-s]{border-top:1px solid var(--vp-c-gutter);padding-top:88px!important}.VPTeamPageSection+.VPTeamPageSection[data-v-7c57f839-s],.VPTeamMembers+.VPTeamPageSection[data-v-7c57f839-s]{margin-top:64px}.VPTeamMembers+.VPTeamMembers[data-v-7c57f839-s]{margin-top:24px}@media (min-width: 768px){.VPTeamPageTitle+.VPTeamPageSection[data-v-7c57f839-s]{margin-top:16px}.VPTeamPageSection+.VPTeamPageSection[data-v-7c57f839-s],.VPTeamMembers+.VPTeamPageSection[data-v-7c57f839-s]{margin-top:96px}}.VPTeamMembers[data-v-7c57f839-s]{padding:0 24px}@media (min-width: 768px){.VPTeamMembers[data-v-7c57f839-s]{padding:0 48px}}@media (min-width: 960px){.VPTeamMembers[data-v-7c57f839-s]{padding:0 64px}}.VPTeamPageTitle[data-v-bf2cbdac]{padding:48px 32px;text-align:center}@media (min-width: 768px){.VPTeamPageTitle[data-v-bf2cbdac]{padding:64px 48px 48px}}@media (min-width: 960px){.VPTeamPageTitle[data-v-bf2cbdac]{padding:80px 64px 48px}}.title[data-v-bf2cbdac]{letter-spacing:0;line-height:44px;font-size:36px;font-weight:500}@media (min-width: 768px){.title[data-v-bf2cbdac]{letter-spacing:-.5px;line-height:56px;font-size:48px}}.lead[data-v-bf2cbdac]{margin:0 auto;max-width:512px;padding-top:12px;line-height:24px;font-size:16px;font-weight:500;color:var(--vp-c-text-2)}@media (min-width: 768px){.lead[data-v-bf2cbdac]{max-width:592px;letter-spacing:.15px;line-height:28px;font-size:20px}}.VPTeamPageSection[data-v-b1a88750]{padding:0 32px}@media (min-width: 768px){.VPTeamPageSection[data-v-b1a88750]{padding:0 48px}}@media (min-width: 960px){.VPTeamPageSection[data-v-b1a88750]{padding:0 64px}}.title[data-v-b1a88750]{position:relative;margin:0 auto;max-width:1152px;text-align:center;color:var(--vp-c-text-2)}.title-line[data-v-b1a88750]{position:absolute;top:16px;left:0;width:100%;height:1px;background-color:var(--vp-c-divider)}.title-text[data-v-b1a88750]{position:relative;display:inline-block;padding:0 24px;letter-spacing:0;line-height:32px;font-size:20px;font-weight:500;background-color:var(--vp-c-bg)}.lead[data-v-b1a88750]{margin:0 auto;max-width:480px;padding-top:12px;text-align:center;line-height:24px;font-size:16px;font-weight:500;color:var(--vp-c-text-2)}.members[data-v-b1a88750]{padding-top:40px}.VPTeamMembersItem[data-v-f3fa364a]{display:flex;flex-direction:column;gap:2px;border-radius:12px;width:100%;height:100%;overflow:hidden}.VPTeamMembersItem.small .profile[data-v-f3fa364a]{padding:32px}.VPTeamMembersItem.small .data[data-v-f3fa364a]{padding-top:20px}.VPTeamMembersItem.small .avatar[data-v-f3fa364a]{width:64px;height:64px}.VPTeamMembersItem.small .name[data-v-f3fa364a]{line-height:24px;font-size:16px}.VPTeamMembersItem.small .affiliation[data-v-f3fa364a]{padding-top:4px;line-height:20px;font-size:14px}.VPTeamMembersItem.small .desc[data-v-f3fa364a]{padding-top:12px;line-height:20px;font-size:14px}.VPTeamMembersItem.small .links[data-v-f3fa364a]{margin:0 -16px -20px;padding:10px 0 0}.VPTeamMembersItem.medium .profile[data-v-f3fa364a]{padding:48px 32px}.VPTeamMembersItem.medium .data[data-v-f3fa364a]{padding-top:24px;text-align:center}.VPTeamMembersItem.medium .avatar[data-v-f3fa364a]{width:96px;height:96px}.VPTeamMembersItem.medium .name[data-v-f3fa364a]{letter-spacing:.15px;line-height:28px;font-size:20px}.VPTeamMembersItem.medium .affiliation[data-v-f3fa364a]{padding-top:4px;font-size:16px}.VPTeamMembersItem.medium .desc[data-v-f3fa364a]{padding-top:16px;max-width:288px;font-size:16px}.VPTeamMembersItem.medium .links[data-v-f3fa364a]{margin:0 -16px -12px;padding:16px 12px 0}.profile[data-v-f3fa364a]{flex-grow:1;background-color:var(--vp-c-bg-soft)}.data[data-v-f3fa364a]{text-align:center}.avatar[data-v-f3fa364a]{position:relative;flex-shrink:0;margin:0 auto;border-radius:50%;box-shadow:var(--vp-shadow-3)}.avatar-img[data-v-f3fa364a]{position:absolute;top:0;right:0;bottom:0;left:0;border-radius:50%;object-fit:cover}.name[data-v-f3fa364a]{margin:0;font-weight:600}.affiliation[data-v-f3fa364a]{margin:0;font-weight:500;color:var(--vp-c-text-2)}.org.link[data-v-f3fa364a]{color:var(--vp-c-text-2);transition:color .25s}.org.link[data-v-f3fa364a]:hover{color:var(--vp-c-brand-1)}.desc[data-v-f3fa364a]{margin:0 auto}.desc[data-v-f3fa364a] a{font-weight:500;color:var(--vp-c-brand-1);text-decoration-style:dotted;transition:color .25s}.links[data-v-f3fa364a]{display:flex;justify-content:center;height:56px}.sp-link[data-v-f3fa364a]{display:flex;justify-content:center;align-items:center;text-align:center;padding:16px;font-size:14px;font-weight:500;color:var(--vp-c-sponsor);background-color:var(--vp-c-bg-soft);transition:color .25s,background-color .25s}.sp .sp-link.link[data-v-f3fa364a]:hover,.sp .sp-link.link[data-v-f3fa364a]:focus{outline:none;color:var(--vp-c-white);background-color:var(--vp-c-sponsor)}.sp-icon[data-v-f3fa364a]{margin-right:8px;font-size:16px}.VPTeamMembers.small .container[data-v-6cb0dbc4]{grid-template-columns:repeat(auto-fit,minmax(224px,1fr))}.VPTeamMembers.small.count-1 .container[data-v-6cb0dbc4]{max-width:276px}.VPTeamMembers.small.count-2 .container[data-v-6cb0dbc4]{max-width:576px}.VPTeamMembers.small.count-3 .container[data-v-6cb0dbc4]{max-width:876px}.VPTeamMembers.medium .container[data-v-6cb0dbc4]{grid-template-columns:repeat(auto-fit,minmax(256px,1fr))}@media (min-width: 375px){.VPTeamMembers.medium .container[data-v-6cb0dbc4]{grid-template-columns:repeat(auto-fit,minmax(288px,1fr))}}.VPTeamMembers.medium.count-1 .container[data-v-6cb0dbc4]{max-width:368px}.VPTeamMembers.medium.count-2 .container[data-v-6cb0dbc4]{max-width:760px}.container[data-v-6cb0dbc4]{display:grid;gap:24px;margin:0 auto;max-width:1152px}.VPLocalSearchBox[data-v-639d7ab9]{position:fixed;z-index:100;top:0;right:0;bottom:0;left:0;display:flex}.backdrop[data-v-639d7ab9]{position:absolute;top:0;right:0;bottom:0;left:0;background:var(--vp-backdrop-bg-color);transition:opacity .5s}.shell[data-v-639d7ab9]{position:relative;padding:12px;margin:64px auto;display:flex;flex-direction:column;gap:16px;background:var(--vp-local-search-bg);width:min(100vw - 60px,900px);height:min-content;max-height:min(100vh - 128px,900px);border-radius:6px}@media (max-width: 767px){.shell[data-v-639d7ab9]{margin:0;width:100vw;height:100vh;max-height:none;border-radius:0}}.search-bar[data-v-639d7ab9]{border:1px solid var(--vp-c-divider);border-radius:4px;display:flex;align-items:center;padding:0 12px;cursor:text}@media (max-width: 767px){.search-bar[data-v-639d7ab9]{padding:0 8px}}.search-bar[data-v-639d7ab9]:focus-within{border-color:var(--vp-c-brand-1)}.local-search-icon[data-v-639d7ab9]{display:block;font-size:18px}.navigate-icon[data-v-639d7ab9]{display:block;font-size:14px}.search-icon[data-v-639d7ab9]{margin:8px}@media (max-width: 767px){.search-icon[data-v-639d7ab9]{display:none}}.search-input[data-v-639d7ab9]{padding:6px 12px;font-size:inherit;width:100%}@media (max-width: 767px){.search-input[data-v-639d7ab9]{padding:6px 4px}}.search-actions[data-v-639d7ab9]{display:flex;gap:4px}@media (any-pointer: coarse){.search-actions[data-v-639d7ab9]{gap:8px}}@media (min-width: 769px){.search-actions.before[data-v-639d7ab9]{display:none}}.search-actions button[data-v-639d7ab9]{padding:8px}.search-actions button[data-v-639d7ab9]:not([disabled]):hover,.toggle-layout-button.detailed-list[data-v-639d7ab9]{color:var(--vp-c-brand-1)}.search-actions button.clear-button[data-v-639d7ab9]:disabled{opacity:.37}.search-keyboard-shortcuts[data-v-639d7ab9]{font-size:.8rem;opacity:75%;display:flex;flex-wrap:wrap;gap:16px;line-height:14px}.search-keyboard-shortcuts span[data-v-639d7ab9]{display:flex;align-items:center;gap:4px}@media (max-width: 767px){.search-keyboard-shortcuts[data-v-639d7ab9]{display:none}}.search-keyboard-shortcuts kbd[data-v-639d7ab9]{background:#8080801a;border-radius:4px;padding:3px 6px;min-width:24px;display:inline-block;text-align:center;vertical-align:middle;border:1px solid rgba(128,128,128,.15);box-shadow:0 2px 2px #0000001a}.results[data-v-639d7ab9]{display:flex;flex-direction:column;gap:6px;overflow-x:hidden;overflow-y:auto;overscroll-behavior:contain}.result[data-v-639d7ab9]{display:flex;align-items:center;gap:8px;border-radius:4px;transition:none;line-height:1rem;border:solid 2px var(--vp-local-search-result-border);outline:none}.result>div[data-v-639d7ab9]{margin:12px;width:100%;overflow:hidden}@media (max-width: 767px){.result>div[data-v-639d7ab9]{margin:8px}}.titles[data-v-639d7ab9]{display:flex;flex-wrap:wrap;gap:4px;position:relative;z-index:1001;padding:2px 0}.title[data-v-639d7ab9]{display:flex;align-items:center;gap:4px}.title.main[data-v-639d7ab9]{font-weight:500}.title-icon[data-v-639d7ab9]{opacity:.5;font-weight:500;color:var(--vp-c-brand-1)}.title svg[data-v-639d7ab9]{opacity:.5}.result.selected[data-v-639d7ab9]{--vp-local-search-result-bg: var(--vp-local-search-result-selected-bg);border-color:var(--vp-local-search-result-selected-border)}.excerpt-wrapper[data-v-639d7ab9]{position:relative}.excerpt[data-v-639d7ab9]{opacity:75%;pointer-events:none;max-height:140px;overflow:hidden;position:relative;opacity:.5;margin-top:4px}.result.selected .excerpt[data-v-639d7ab9]{opacity:1}.excerpt[data-v-639d7ab9] *{font-size:.8rem!important;line-height:130%!important}.titles[data-v-639d7ab9] mark,.excerpt[data-v-639d7ab9] mark{background-color:var(--vp-local-search-highlight-bg);color:var(--vp-local-search-highlight-text);border-radius:2px;padding:0 2px}.excerpt[data-v-639d7ab9] .vp-code-group .tabs{display:none}.excerpt[data-v-639d7ab9] .vp-code-group div[class*=language-]{border-radius:8px!important}.excerpt-gradient-bottom[data-v-639d7ab9]{position:absolute;bottom:-1px;left:0;width:100%;height:8px;background:linear-gradient(transparent,var(--vp-local-search-result-bg));z-index:1000}.excerpt-gradient-top[data-v-639d7ab9]{position:absolute;top:-1px;left:0;width:100%;height:8px;background:linear-gradient(var(--vp-local-search-result-bg),transparent);z-index:1000}.result.selected .titles[data-v-639d7ab9],.result.selected .title-icon[data-v-639d7ab9]{color:var(--vp-c-brand-1)!important}.no-results[data-v-639d7ab9]{font-size:.9rem;text-align:center;padding:12px}svg[data-v-639d7ab9]{flex:none} diff --git a/docs/.vitepress/dist/guide/additions/swap.html b/docs/.vitepress/dist/guide/additions/swap.html deleted file mode 100644 index 9d8d391d1..000000000 --- a/docs/.vitepress/dist/guide/additions/swap.html +++ /dev/null @@ -1,52 +0,0 @@ - - - - - -Sometimes situations arise when there is a need to make multiple changes to wallets. For example, we need to change the balance of many wallets at once. For example, the system administrator accrues a bonus for participating in some promotion. Previously, the code would look like this:
use Bavix\Wallet\Services\AtomicServiceInterface;
-
-app(AtomicServiceInterface::class)->blocks($wallets, function () use ($amount, $wallets) {
- foreach ($wallets as $wallet) {
- $wallet->deposit($amount);
- }
-});The code is working and everything works correctly. But what happens under the hood? Nothing good. For 5 users it will look like this.
Since the operations inside an atomic operation can depend on each other, we will not be able to combine insert queries into a batch. But there is an opportunity to reduce the number of update queries and improve application performance out of the blue.
After small things, the situation will look like this.
As you can see, things are getting better. Still, I would like to be able to tell the package that the changes are independent of each other. In this case, the package will be able to collapse all insert queries into a single query and insert in a batch.
Here new api handles can help us:
// For multiple transactions.
-interface TransactionQueryHandlerInterface
-{
- /**
- * @param non-empty-array<TransactionQuery> $objects
- * @return non-empty-array<string, Transaction>
- * @throws ExceptionInterface
- */
- public function apply(array $objects): array;
-}
-
-// For multiple transfers of funds.
-interface TransferQueryHandlerInterface
-{
- /**
- * @param non-empty-array<TransferQuery> $objects
- * @return non-empty-array<string, Transfer>
- * @throws ExceptionInterface
- */
- public function apply(array $objects): array;
-}Let's use the API handle.
use Bavix\Wallet\External\Api\TransactionQuery;
-use Bavix\Wallet\External\Api\TransactionQueryHandlerInterface;
-
-app(TransactionQueryHandlerInterface::class)->apply(
- array_map(
- static fn (Wallet $wallet) => TransactionQuery::createDeposit($wallet, $amount, null),
- $wallets
- )
-);And now look at the result and it is impressive.
But it is worth noting that these are highly efficient api handles and they do not check the balance of the wallet before making changes. If you need it, then you have to do something like this.
use Bavix\Wallet\External\Api\TransactionQuery;
-use Bavix\Wallet\External\Api\TransactionQueryHandlerInterface;
-use Bavix\Wallet\Services\AtomicServiceInterface;
-use Bavix\Wallet\Services\ConsistencyServiceInterface;
-
-app(AtomicServiceInterface::class)->blocks($wallets, function () use ($wallets, $amount) {
- foreach ($wallets as $wallet) {
- app(ConsistencyServiceInterface::class)->checkPotential($wallet, $amount);
- }
-
- app(TransactionQueryHandlerInterface::class)->apply(
- array_map(
- static fn (Wallet $wallet) => TransactionQuery::createWithdraw($wallet, $amount, null),
- $wallets
- )
- );
-});In version 10.x, it became possible to create transactions with a given uuid (generate on the client side). The main thing is to keep uniqueness.
use Bavix\Wallet\External\Api\TransactionQuery;
-
-// int version
-TransactionQuery::createDeposit($wallet, $amount, null, uuid: '5f7820d1-1e82-4d03-9414-05d0c44da9a1');
-TransactionQuery::createWithdraw($wallet, $amount, null, uuid: '6e87dbf2-7be7-48c2-b688-f46ba4e25786');
-
-// float version
-TransactionFloatQuery::createDeposit($wallet, $amountFloat, null, uuid: '5f7820d1-1e82-4d03-9414-05d0c44da9a1');
-TransactionFloatQuery::createWithdraw($wallet, $amountFloat, null, uuid: '6e87dbf2-7be7-48c2-b688-f46ba4e25786');It's simple!
laravel-wallet - Easy work with virtual wallet.
Please ask questions on the Github issues page.