diff --git a/.github/workflows/build.yaml b/.github/workflows/build.yaml
index 7505583..2928178 100644
--- a/.github/workflows/build.yaml
+++ b/.github/workflows/build.yaml
@@ -193,7 +193,7 @@ jobs:
dependency-versions: "${{ matrix.dependencies }}"
- name: "Run phpunit"
- run: "composer phpunit"
+ run: "vendor/bin/phpunit --testsuite unit"
integration-tests:
name: "Integration tests (PHP${{ matrix.php-version }} | Deps: ${{ matrix.dependencies }} | SF${{ matrix.symfony }})"
@@ -247,7 +247,75 @@ jobs:
- name: "Validate Doctrine mapping"
run: "(cd tests/Application && bin/console doctrine:schema:validate -vvv)" # The verbose flag will show 'missing' SQL statements, if any
+
+ - name: "Load fixtures"
+ run: "(cd tests/Application && bin/console sylius:fixtures:load default -n && bin/console sylius:fixtures:load loyalty -n)"
+
+ - name: "Run functional tests"
+ run: "vendor/bin/phpunit --testsuite functional"
+ e2e-tests:
+ name: "End-to-end tests (Playwright)"
+
+ runs-on: "ubuntu-latest"
+
+ strategy:
+ matrix:
+ php-version:
+ - "8.3"
+
+ dependencies:
+ - "highest"
+
+ steps:
+ - name: "Start MySQL"
+ run: "sudo /etc/init.d/mysql start"
+
+ - name: "Checkout"
+ uses: "actions/checkout@v5"
+
+ - name: "Setup PHP, with composer and extensions"
+ uses: "shivammathur/setup-php@v2"
+ with:
+ coverage: "none"
+ extensions: "${{ env.PHP_EXTENSIONS }}"
+ php-version: "${{ matrix.php-version }}"
+
+ - name: "Install composer dependencies"
+ uses: "ramsey/composer-install@v3"
+ with:
+ dependency-versions: "${{ matrix.dependencies }}"
+
+ - name: "Setup node"
+ uses: "actions/setup-node@v4"
+ with:
+ node-version-file: "tests/Application/.nvmrc"
+
+ - name: "Build test application assets"
+ run: "(cd tests/Application && yarn install && yarn build && APP_ENV=test bin/console assets:install public)"
+
+ - name: "Create database and schema"
+ run: "(cd tests/Application && APP_ENV=test bin/console doctrine:database:create -n && APP_ENV=test bin/console doctrine:schema:create -n)"
+
+ - name: "Load fixtures"
+ run: "(cd tests/Application && APP_ENV=test bin/console sylius:fixtures:load default -n && APP_ENV=test bin/console sylius:fixtures:load loyalty -n)"
+
+ - name: "Install Playwright"
+ run: "(cd e2e && npm ci && npx playwright install --with-deps chromium)"
+
+ - name: "Run Playwright tests"
+ run: "(cd e2e && npx playwright test)"
+
+ - name: "Upload Playwright report"
+ uses: "actions/upload-artifact@v4"
+ if: "failure()"
+ with:
+ name: "playwright-report"
+ path: |
+ e2e/playwright-report
+ e2e/test-results
+ retention-days: 7
+
mutation-tests:
name: "Mutation tests"
@@ -312,7 +380,7 @@ jobs:
dependency-versions: "${{ matrix.dependencies }}"
- name: "Collect code coverage with pcov and phpunit/phpunit"
- run: "vendor/bin/phpunit --coverage-clover=.build/logs/clover.xml"
+ run: "vendor/bin/phpunit --testsuite unit --coverage-clover=.build/logs/clover.xml"
- name: "Send code coverage report to Codecov.io"
uses: "codecov/codecov-action@v4"
diff --git a/CLAUDE.md b/CLAUDE.md
index 3c7493f..d12ba62 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -4,7 +4,23 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
## Project Overview
-TODO
+`setono/sylius-loyalty-plugin` is a loyalty plugin for Sylius 1.14 (PHP >= 8.1, Symfony ^6.4, Doctrine ORM, MySQL 8). It provides:
+
+- **Points** (Phase 1): event-driven earning on order/payment lifecycle and customer actions, redemption at checkout as a distributed discount adjustment, expiration, and clawback on cancellation/refund — all backed by a strictly **append-only ledger**.
+- **Tiers** (Phase 2): admin-created tiers with configurable qualification bases, earning multipliers (applied after all rules, before rounding), a tier-gated promotion rule checker (`customer_loyalty_tier`), shop progress indicators with a top-tier celebration state, and variant-aware earn hints on product and cart pages (never-overstate filtering via condition evaluability metadata).
+- **Referrals** (Phase 3): lazy Crockford-base32 codes, `/r/{code}` landing + `?ref=` query-param attribution (30-day cookie, last click wins), pending referral at registration, first-post-attribution-order qualification at the award moment, extensible fraud checks, dual rewards via `earn_referral` (idempotent per account+referral), dual clawback on cancel/refund of the qualifying order.
+
+Guiding principles: points are a financial liability, so the ledger is the source of truth and balances are derived caches; all earning is idempotent by construction (DB-level unique constraints); everything is channel-aware; every meaningful action dispatches an event; extension points are tagged services or config-registered event classes. B2C only — no cashback, badges/challenges/leaderboards, B2B accounts, emails, or API Platform endpoints.
+
+## Domain Glossary
+
+- **Loyalty account**: one per (customer, channel). Holds a cached `balance` and `lifetimeEarned` — both derived from the ledger, never hand-edited.
+- **Ledger**: the append-only list of `LoyaltyTransaction` rows (Doctrine single-table inheritance). Rows are never updated or deleted; corrections are new compensating entries.
+- **Lot**: a credit transaction with an optional `expiresAt`. There is no stored "remaining" column — per-lot remainders are **derived** by replay.
+- **Replay**: deterministic processing of an account's ledger in `occurredAt ASC, id ASC` order; debits consume open lots FIFO in consumption order `expiresAt ASC NULLS LAST, occurredAt ASC, id ASC`.
+- **Clawback**: a debit written when an order that earned points is cancelled/refunded, referencing the original earn credit.
+- **Requested vs applied points**: `order.loyaltyPointsRequested` is the customer's persisted intent; on every order recalculation the applied amount is derived as `min(requested, balance, cap)` clamped to a clean multiple of the conversion ratio. The checkout debit is always the **applied** amount.
+- **Dry run**: an earning rule mode that evaluates against live traffic and logs would-be awards to an audit table instead of writing ledger entries.
## Code Standards
@@ -16,54 +32,74 @@ Follow clean code principles and SOLID design patterns when working with this co
- Favor composition over inheritance
- Write code that is easy to test and extend
+Plugin-specific conventions:
+- **Services** are declared in XML under `src/Resources/config/services/`, loaded from `services.xml`. Service ids are FQCNs; every service with an interface gets an interface **alias**, and consumers are wired against the interface id so projects can swap implementations by re-aliasing. No autowiring inside the plugin — explicit `` wiring.
+- **API surface**: all classes `final` except entities; interfaces are the only supported extension contracts; anything not documented as an extension point is `@internal`.
+- **Models** live in `src/Model/` as interface + default implementation, registered under the `setono_sylius_loyalty.resources` config node; Doctrine mappings are XML in `src/Resources/config/doctrine/model/`. Only Doctrine ORM is supported.
+- **Database tables** are prefixed `setono_sylius_loyalty__`.
+- **No Doctrine migrations ship** — the XML mappings are the schema's source of truth; host projects generate their own via `doctrine:migrations:diff`.
+- All ledger writes go through the `LoyaltyLedger` service (pessimistic locking via Doctrine's `LockMode::PESSIMISTIC_WRITE` inside `wrapInTransaction()`); never write transaction rows directly.
+
### Testing Requirements
-- Write unit tests for all new functionality (if it makes sense)
-- Follow the BDD-style naming convention for test methods (e.g., `it_should_do_something_when_condition_is_met`)
+
+Policy: **all code is unit tested; behavior that touches the framework or database is additionally functionally tested; everything with a UI is covered by Playwright.** The levels complement — never substitute for — each other.
+
+- **Unit tests** (`tests/Unit/`, plus `tests/DependencyInjection/`): baseline for every class. BDD-style method names (e.g. `it_awards_points_once_for_a_paid_order`).
- **MUST use Prophecy for mocking** - Use the `ProphecyTrait` and `$this->prophesize()` for all mocks, NOT PHPUnit's `$this->createMock()`
-- **Form testing** - Use Symfony's best practices for form testing as documented at https://symfony.com/doc/current/form/unit_testing.html
- - Extend `Symfony\Component\Form\Test\TypeTestCase` for form type tests
- - Use `$this->factory->create()` to create form instances
- - Test form submission, validation, and data transformation
-- Ensure tests are isolated and don't depend on external state
-- Test both happy path and edge cases
+- **Form testing** - Extend `Symfony\Component\Form\Test\TypeTestCase`, use `$this->factory->create()`, test submission, validation, and data transformation (see https://symfony.com/doc/current/form/unit_testing.html)
+- **Functional tests** (`tests/Functional/`): run against the Sylius test app in `tests/Application/` with MySQL. Extend `Setono\SyliusLoyaltyPlugin\Tests\Functional\FunctionalTestCase`; database state is isolated per test by dama/doctrine-test-bundle. Tests that need real commits (cross-process locking/concurrency) opt out via `StaticDriver` and clean up after themselves.
+- **E2E tests** (`e2e/`): the committed Playwright suite is the acceptance gate for all UI behavior.
+- Ensure tests are isolated and don't depend on external state; test both happy path and edge cases.
### UI Verification
- **All UI changes MUST be verified using the Playwright MCP** - After making any change that affects the rendered UI (templates, forms, styling, layout, flash messages, etc.), use the Playwright MCP to navigate the running test application and confirm the change renders and behaves as expected
-- Run the test application (see [Test Application](#test-application)) and use the Playwright MCP `browser_navigate`, `browser_snapshot`, and `browser_take_screenshot` tools to inspect the affected pages
-- Verify both the visual result and the interactive behavior (e.g. submitting forms, triggering flash messages)
+- Verify both the visual result and the interactive behavior (e.g. submitting forms, triggering flash messages), then lock the behavior in as a committed spec in `e2e/`.
## Development Commands
-Based on the `composer.json` scripts section:
-
### Code Quality & Testing
-- `composer analyse` - Run PHPStan static analysis (level 8)
-- `composer check-style` - Check code style with ECS (Easy Coding Standard)
-- `composer fix-style` - Fix code style issues automatically with ECS
-- `composer phpunit` - Run PHPUnit tests
-
-### Static Analysis
-
-#### PHPStan Configuration
-PHPStan is configured in `phpstan.neon` with:
-- **Analysis Level**: max (strictest)
-- **Extensions**: Auto-loaded via `phpstan/extension-installer`
- - `phpstan/phpstan-symfony` - Symfony framework integration
- - `phpstan/phpstan-doctrine` - Doctrine ORM integration
- - `phpstan/phpstan-phpunit` - PHPUnit test integration
- - `jangregor/phpstan-prophecy` - Prophecy mocking integration
-- **Symfony Integration**: Uses console application loader (`tests/console_application.php`)
-- **Doctrine Integration**: Uses object manager loader (`tests/object_manager.php`)
-- **Exclusions**: Test application directory and Configuration.php
-- **Baseline**: Generate with `composer analyse -- --generate-baseline` to track improvements
+- `composer analyse` - Run PHPStan static analysis (level max)
+- `composer check-style` / `composer fix-style` - Check/fix code style with ECS
+- `vendor/bin/phpunit --testsuite unit` - Run unit tests (no database needed)
+- `vendor/bin/phpunit --testsuite functional` - Run functional tests (needs the test app database, `APP_ENV=test`)
+- `vendor/bin/rector --dry-run` - Rector check (CI runs this)
+- `vendor/bin/infection` - Mutation tests (scoped to the unit suite; MSI thresholds are unset until the plugin is feature-complete)
+- `(cd e2e && npx playwright test)` - Run the e2e suite (needs the test app served with seeded fixtures; the config boots `php -S` itself)
+
+### PHPStan Configuration
+PHPStan runs at **level max** over `src` and `tests` with the Symfony/Doctrine/PHPUnit/Prophecy extensions (auto-loaded via `phpstan/extension-installer`). Loaders live under `tests/PHPStan/` (`console_application.php`, `object_manager.php`); the test application directory is excluded.
### Test Application
-The plugin includes a test Symfony application in `tests/Application/` for development and testing:
-- Navigate to `tests/Application/` directory
-- Run `yarn install && yarn build` to build assets
-- Use standard Symfony commands for the test app
+The plugin includes a Sylius test application in `tests/Application/`:
+- Use **Node 20** (`.nvmrc`; the Sylius UI toolchain is incompatible with Node 22): `nvm use && yarn install && yarn build`
+- Database (MySQL/MariaDB on 127.0.0.1, see `.env`): `APP_ENV=test bin/console doctrine:database:create && APP_ENV=test bin/console doctrine:schema:create && APP_ENV=test bin/console sylius:fixtures:load default -n`
+- Serve with `APP_ENV=test php -S 127.0.0.1:8080 -t public` (or `symfony serve`)
- **Sylius Backend Credentials**: Username: `sylius`, Password: `sylius`
+### Console Commands (shipped by the plugin)
+- `setono:sylius-loyalty:trigger-birthdays` - fires the customer_birthday earning trigger for customers whose birthday is today (cron, daily; source identifier `birthday:` makes re-runs no-ops)
+- `setono:sylius-loyalty:prune-dry-run-results [--days=30]` - prunes dry-run audit rows (cron, daily)
+- `setono:sylius-loyalty:expire-points [--batch-size=100]` - writes expiration entries for lots past expiry, incl. zero-point closers (cron, daily)
+- `setono:sylius-loyalty:verify-ledger [--batch-size=100]` - checks the ledger invariants; non-zero exit on violations, never fixes (cron-able)
+- `setono:sylius-loyalty:recalculate-balances [--batch-size=100] [--force]` - reports balance drift vs the ledger sum; `--force` corrects it
+- `setono:sylius-loyalty:inspect-account [--format=txt|json]` - ledger + replay-derived lot states + invariant check for one account
+- `setono:sylius-loyalty:export-customer-data ` - GDPR JSON export of a customer's loyalty data
+- Also document in host crons: Sylius core's `sylius:cancel-unpaid-orders` (cancellation triggers redemption rollback + clawback)
+
+## Extension Points
+
+Every extension interface is registered for autoconfiguration — implementing the interface is the entire integration surface.
+
+- **Earning condition types**: implement `EarningRule\Checker\ConditionCheckerInterface` (tag `setono_sylius_loyalty.earning_condition`).
+- **Amount types**: implement `EarningRule\Amount\AmountCalculatorInterface` (tag `setono_sylius_loyalty.earning_amount`).
+- **Expression functions**: implement `Expression\Function\ExpressionFunctionInterface` (tag `setono_sylius_loyalty.expression_function`); metadata feeds autocompletion and the reference panel automatically.
+- **Earning triggers**: create an event class extending `Event\Trigger\EarningTriggerEvent`, register it under `setono_sylius_loyalty.triggers`, and fire it with a plain event dispatch. The subclass's public readonly properties become typed expression context. `sourceIdentifier` defaults to the trigger code ("once per account, ever"); repeatable triggers pass their own.
+- **Custom transaction types**: subclass `CreditLoyaltyTransaction`/`DebitLoyaltyTransaction`, implement `getDiscriminator()`, and register the class as a Sylius resource — the discriminator map picks it up automatically.
+- **Channel resolution for triggers**: re-alias `Resolver\TriggerChannelResolverInterface`.
+- **Tier qualification bases**: implement `Tier\QualificationBasis\TierQualificationBasisInterface` (tag `setono_sylius_loyalty.tier_qualification_basis`); the tier form's basis select and unit hint update automatically.
+- **Partial-refund clawback**: call `Ledger\LoyaltyLedgerInterface::clawback(OrderInterface $order, int $points)` from any refund mechanism.
+- **Referral fraud checks**: implement `Referral\FraudCheck\ReferralFraudCheckInterface` (tag `setono_sylius_loyalty.referral_fraud_check`); any returned flag rejects the referral, admins can override.
+
## Bash Tools Recommendations
Use the right tool for the right job when executing bash commands:
@@ -75,22 +111,12 @@ Use the right tool for the right job when executing bash commands:
- **Interacting with JSON?** → Use `jq` (JSON processor)
- **Interacting with YAML or XML?** → Use `yq` (YAML/XML processor)
-Examples:
-- `fd "*.php" | fzf` - Find PHP files and interactively select one
-- `rg "function.*validate" | fzf` - Search for validation functions and select
-- `ast-grep --lang php -p 'class $name extends $parent'` - Find class inheritance patterns
-
## Architecture Overview
### Translations
-The plugin provides multilingual support through translation files in `src/Resources/translations/`:
-
-- **Translation Files**: Available in 10 languages (en, da, de, es, fr, it, nl, no, pl, sv)
-- **Translation Domains**:
- - `messages.*` - General UI translations
- - `flashes.*` - Flash message translations (success/error messages)
+Customer- and admin-facing strings are translatable via `src/Resources/translations/` (domains `messages`, `flashes`, `validators`). English is authored first and is authoritative; the shipped locale set is en, da, sv, no, fi, de, fr, es, it, nl, pl, pt, cs, hu, ro, uk. Generated locale files carry a header comment marking them machine-translated pending native review. Key namespaces: `setono_sylius_loyalty.ui.*`, `setono_sylius_loyalty.form.*`.
-Key translation keys:
-- `setono_sylius_loyalty.ui.*` - UI labels
-- `setono_sylius_loyalty.form.*` - Form field labels
-- `setono_sylius_loyalty.single_message` - A flash message
+### Known deviations from the original specification
+- The product-page earn hint renders via the `sylius.shop.product.show.add_to_cart_form` template event (just above the add-to-cart button) — Sylius 1.14 has no template event directly below the button.
+- The order-payment `pay` transition lives on the `sylius_order_payment` state machine graph (not `sylius_payment`).
+- Doctrine mappings live in `src/Resources/config/doctrine/model/` (the `AbstractResourceBundle` default).
diff --git a/LICENSE b/LICENSE
index e4c0848..84b974a 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,6 +1,6 @@
MIT License
-Copyright (c) 2025 Setono
+Copyright (c) 2026 Setono
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
diff --git a/README.md b/README.md
index aaac84e..63b8c2d 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# Setono SyliusLoyaltyPlugin
+# Sylius Loyalty Plugin
[![Latest Version][ico-version]][link-packagist]
[![Software License][ico-license]](LICENSE)
@@ -6,40 +6,195 @@
[![Code Coverage][ico-code-coverage]][link-code-coverage]
[![Mutation testing][ico-infection]][link-infection]
-[Setono](https://setono.com) have made a bunch of [plugins for Sylius](https://github.com/Setono?q=plugin&sort=stargazers), and we have some guidelines
-which we try to follow when developing plugins. These guidelines are used in this repository, and it gives you a very
-solid base when developing plugins.
-
-Enjoy!
-
-## Quickstart
-
-1. Run
- ```shell
- composer create-project --prefer-source --no-install --remove-vcs setono/sylius-loyalty-plugin:dev-master ProjectName
- ```
- or just click the `Use this template` button at the right corner of this repository.
-2. Run
- ```shell
- cd ProjectName && composer install
- ```
-3. From the plugin skeleton root directory, run the following commands:
-
- ```bash
- php init
- (cd tests/Application && yarn install)
- (cd tests/Application && yarn build)
- (cd tests/Application && bin/console assets:install)
-
- (cd tests/Application && bin/console doctrine:database:create)
- (cd tests/Application && bin/console doctrine:schema:create)
-
- (cd tests/Application && bin/console sylius:fixtures:load -n)
- ```
-
-4. Start your local PHP server: `symfony serve` (see https://symfony.com/doc/current/setup/symfony_server.html for docs)
-
-To be able to set up a plugin's database, remember to configure you database credentials in `tests/Application/.env` and `tests/Application/.env.test`.
+A loyalty program for [Sylius](https://sylius.com): **points** earned on orders and customer actions through a flexible
+rule engine, **redeemed at checkout** as a real discount, with expiration, clawback, and a strictly append-only ledger
+as the source of truth. Tiers (Phase 2) and referrals (Phase 3) build on the same core.
+
+## Highlights
+
+- **Append-only ledger** — points are treated as a financial liability. Every movement is a transaction row; balances
+ are derived caches, verifiable with `setono:sylius-loyalty:verify-ledger`. Nothing is ever updated or deleted;
+ corrections are compensating entries.
+- **Rule engine** — earning rules with triggers (order, registration, review approval, birthday, or your own),
+ conditions, scopes (order / taxon / product with exclusive item claiming), stacking, priorities, dry-run mode, and a
+ sandboxed expression language with an admin code editor (autocompletion, inline linting, reference panel).
+- **Checkout redemption** — customers apply points on the cart; the discount distributes to unit-level adjustments so
+ taxes and promotions compute correctly. The customer's request is persisted and re-clamped on every order change —
+ it grows back automatically when the cart allows it.
+- **Idempotent by construction** — awarding is guarded by database unique constraints, so double event dispatches,
+ message redeliveries, and concurrent processes can never double-credit or overspend (pessimistic locking on every
+ ledger write).
+- **Channel-aware** — one account and one program configuration per (customer, channel).
+- **Operable** — console commands for expiry, ledger verification, balance recalculation, account inspection, and GDPR
+ export; an admin ledger inspector with replay-derived lot states and invariant checks.
+
+## Installation
+
+```bash
+composer require setono/sylius-loyalty-plugin
+```
+
+Register the plugin **before** `SyliusGridBundle` in `config/bundles.php`:
+
+```php
+ ['all' => true],
+ Sylius\Bundle\GridBundle\SyliusGridBundle::class => ['all' => true],
+ // ...
+];
+```
+
+Import the routes in `config/routes/setono_sylius_loyalty.yaml`:
+
+```yaml
+setono_sylius_loyalty_admin:
+ resource: '@SetonoSyliusLoyaltyPlugin/Resources/config/routes/admin.yaml'
+ prefix: /admin
+
+setono_sylius_loyalty_shop:
+ resource: '@SetonoSyliusLoyaltyPlugin/Resources/config/routes/shop.yaml'
+ prefix: /{_locale}
+ requirements:
+ _locale: ^[a-z]{2}(?:_[A-Z]{2})?$
+```
+
+If your shop does not use locale-prefixed URLs, import the shop routes without the `prefix`/`requirements` block.
+
+### Extend your Order entity
+
+The plugin persists the customer's redemption request on the order. Add the trait and interface to your `Order` entity:
+
+```php
+
+ manual_adjustment_reasons: [goodwill, correction, promotion, other]
+
+ # Your own earning trigger event classes (see the cookbook)
+ triggers: []
+
+ # On customer deletion, keep de-identified ledger rows linked to an opaque
+ # token instead of deleting everything (accounting continuity)
+ retain_anonymized_ledger: false
+
+ referral:
+ # The query parameter recognized as a referral code on any shop URL
+ query_parameter: ref
+ # Opt-in registration-IP fraud check (stores a salted hash, purged after 90 days)
+ registration_ip_check: false
+ ip_hash_salt: '%kernel.secret%'
+ # Rewarded referrals per referrer per 30 days before the cap check flags
+ reward_cap: 10
+
+ expression_editor:
+ # The admin expression editor loads CodeMirror as version-pinned ESM
+ # imports from this base URL. Point it at a self-hosted copy for
+ # intranet or strict-CSP environments.
+ cdn_base_url: 'https://esm.sh'
+
+ resources:
+ # every model/repository/factory/form is swappable here
+```
+
+Per-channel program settings (conversion rate, minimum redemption, cap, expiry, clawback policy, award moment,
+earning basis, rounding) live in the admin under **Marketing → Loyalty → Program**.
+
+> **Note:** all point amounts convert against the **channel's base currency**; multi-currency channels convert at
+> display time. Expiring stored value may be subject to consumer-protection law in some jurisdictions — check before
+> enabling `points expire after (days)`.
+
+## Cron jobs
+
+| Command | Suggested schedule | Purpose |
+|---|---|---|
+| `setono:sylius-loyalty:expire-points` | daily, off-peak | writes `expire` debits for lots past their expiry |
+| `setono:sylius-loyalty:trigger-birthdays` | daily | fires the `customer_birthday` trigger (idempotent per year) |
+| `setono:sylius-loyalty:prune-dry-run-results --days=30` | daily | prunes the dry-run audit list |
+| `setono:sylius-loyalty:evaluate-tiers` | nightly | tier reconciliation: downgrades after the grace period |
+| `setono:sylius-loyalty:calculate-liability` | nightly, off-peak | snapshots the outstanding-liability dashboard widget |
+| `setono:sylius-loyalty:expire-referrals` | daily | expires stale pending referrals, purges old IP hashes |
+| `sylius:cancel-unpaid-orders` (Sylius core) | hourly | frees redemptions held by abandoned unpaid orders |
+
+Operational commands (run on demand): `verify-ledger`, `recalculate-balances` (report-only by default),
+`inspect-account `, `export-customer-data ` (GDPR JSON).
+
+## Extension points
+
+Implementing the interface is the entire integration — every extension interface is autoconfigured. See the
+[cookbook](docs/cookbook) for complete recipes:
+
+- [Custom condition type](docs/cookbook/custom-condition-type.md)
+- [Custom amount type](docs/cookbook/custom-amount-type.md)
+- [Custom earning trigger](docs/cookbook/custom-trigger.md)
+- [Custom expression function](docs/cookbook/custom-expression-function.md)
+- [Custom transaction type](docs/cookbook/custom-transaction-type.md)
+- [Intercepting points with pre-events](docs/cookbook/intercepting-pre-events.md)
+- [Rendering the balance anywhere](docs/cookbook/rendering-the-balance.md)
+- [Clawback on partial refunds](docs/cookbook/partial-refund-clawback.md)
+- [Custom tier qualification basis](docs/cookbook/custom-tier-qualification-basis.md)
+- [Custom referral fraud check](docs/cookbook/custom-referral-fraud-check.md)
+
+## Notes for specific setups
+
+- **Birthday trigger**: Sylius collects birthdays only if your registration/profile forms do — the trigger is a silent
+ no-op for customers without one.
+- **Strict CSP / no CDN**: self-host the editor's ESM dependencies and point `expression_editor.cdn_base_url` at them — a relative base makes the editor load plain `.js` shims (`codemirror.js`, `codemirror-language.js`, `codemirror-autocomplete.js`, `codemirror-lint.js`) instead of the CDN's versioned URLs. The plugin's test app ships such a snapshot under `tests/Application/public/vendor/codemirror/` you can copy.
+- **Async awarding**: `AwardOrderPoints` and `ClaimPastOrderPoints` are dispatched through Messenger (sync by
+ default). Route them to any transport — awarding is idempotent, so redeliveries are safe.
+
+## Contributing
+
+```bash
+composer install
+(cd tests/Application && yarn install && yarn build && bin/console doctrine:database:create doctrine:schema:create -e test)
+composer analyse # PHPStan, level max
+composer check-style
+vendor/bin/phpunit --testsuite unit
+vendor/bin/phpunit --testsuite functional # needs the test-app database
+(cd e2e && npx playwright test) # needs seeded fixtures: default + loyalty suites
+```
[ico-version]: https://poser.pugx.org/setono/sylius-loyalty-plugin/v/stable
[ico-license]: https://poser.pugx.org/setono/sylius-loyalty-plugin/license
diff --git a/cart-redemption-widget.png b/cart-redemption-widget.png
new file mode 100644
index 0000000..f85f1f3
Binary files /dev/null and b/cart-redemption-widget.png differ
diff --git a/composer-dependency-analyser.php b/composer-dependency-analyser.php
index 01f48c9..10ffbbc 100644
--- a/composer-dependency-analyser.php
+++ b/composer-dependency-analyser.php
@@ -1,7 +1,32 @@
disableReportingUnmatchedIgnores()
->addPathToExclude(__DIR__ . '/tests')
+ // The Sylius monorepo (sylius/sylius) is installed for development and `replace`s the split
+ // packages this plugin actually depends on (sylius/core-bundle and its components), so class
+ // usages resolve to the monorepo package.
+ ->ignoreErrorsOnPackage('sylius/sylius', [ErrorType::SHADOW_DEPENDENCY])
+ ->ignoreErrorsOnPackage('sylius/core-bundle', [ErrorType::UNUSED_DEPENDENCY])
+ // The split components the plugin directly uses: under the monorepo dev install their
+ // classes resolve to sylius/sylius, so they look unused locally while being real
+ // dependencies of a split-package install.
+ ->ignoreErrorsOnPackages([
+ 'sylius/channel',
+ 'sylius/channel-bundle',
+ 'sylius/core',
+ 'sylius/customer',
+ 'sylius/order',
+ 'sylius/promotion',
+ 'sylius/review',
+ 'sylius/ui-bundle',
+ 'sylius/user',
+ ], [ErrorType::UNUSED_DEPENDENCY])
+ // The bundle base class comes from http-kernel; it is only referenced transitively but is a
+ // real runtime requirement of any Symfony bundle.
+ ->ignoreErrorsOnPackage('symfony/http-kernel', [ErrorType::UNUSED_DEPENDENCY])
;
diff --git a/composer.json b/composer.json
index d01a1e4..3bcbc4a 100644
--- a/composer.json
+++ b/composer.json
@@ -1,23 +1,65 @@
{
"name": "setono/sylius-loyalty-plugin",
- "description": "Setono example plugin for Sylius.",
+ "description": "Loyalty plugin for Sylius: points earning and redemption backed by an append-only ledger, tiers, and referrals.",
"license": "MIT",
"type": "sylius-plugin",
"keywords": [
"sylius",
- "sylius-plugin"
+ "sylius-plugin",
+ "loyalty",
+ "loyalty-program",
+ "points",
+ "tiers",
+ "referrals",
+ "setono"
],
"require": {
"php": ">=8.1",
- "sylius/core-bundle": "^1.0",
+ "ext-mbstring": "*",
+ "doctrine/collections": "^1.8 || ^2.0",
+ "doctrine/dbal": "^3.0",
+ "doctrine/orm": "^2.14",
+ "doctrine/persistence": "^2.0 || ^3.0",
+ "psr/event-dispatcher": "^1.0",
+ "psr/log": "^1.0 || ^2.0 || ^3.0",
+ "setono/composite-compiler-pass": "^1.2",
+ "setono/doctrine-orm-trait": "^1.4",
+ "sylius/channel": "^1.14",
+ "sylius/channel-bundle": "^1.14",
+ "sylius/core": "^1.14",
+ "sylius/core-bundle": "^1.14",
+ "sylius/customer": "^1.14",
+ "sylius/order": "^1.14",
+ "sylius/promotion": "^1.14",
+ "sylius/resource-bundle": "^1.11",
+ "sylius/review": "^1.14",
+ "sylius/ui-bundle": "^1.14",
+ "sylius/user": "^1.14",
"symfony/config": "^6.4",
+ "symfony/console": "^6.4",
"symfony/dependency-injection": "^6.4",
- "symfony/http-kernel": "^6.4"
+ "symfony/event-dispatcher": "^6.4",
+ "symfony/expression-language": "^6.4",
+ "symfony/form": "^6.4",
+ "symfony/http-foundation": "^6.4",
+ "symfony/http-kernel": "^6.4",
+ "symfony/messenger": "^6.4",
+ "symfony/options-resolver": "^6.4",
+ "symfony/routing": "^6.4",
+ "symfony/security-bundle": "^6.4",
+ "symfony/security-csrf": "^6.4",
+ "symfony/translation-contracts": "^2.5 || ^3.0",
+ "symfony/validator": "^6.4",
+ "symfony/workflow": "^6.4",
+ "twig/twig": "^3.10",
+ "webmozart/assert": "^1.11"
},
"require-dev": {
"api-platform/core": "^2.7.16",
"babdev/pagerfanta-bundle": "^3.8",
"behat/behat": "^3.14",
+ "dama/doctrine-test-bundle": "^7.2",
+ "doctrine/data-fixtures": "^1.7",
"doctrine/doctrine-bundle": "^2.11",
"jms/serializer-bundle": "^4.2",
"lexik/jwt-authentication-bundle": "^2.17",
@@ -29,6 +71,7 @@
"symfony/intl": "^6.4",
"symfony/property-info": "^6.4",
"symfony/serializer": "^6.4",
+ "symfony/translation": "^6.4.7",
"symfony/web-profiler-bundle": "^6.4",
"symfony/webpack-encore-bundle": "^1.17.2",
"willdurand/negotiation": "^3.1"
diff --git a/docs/cookbook/custom-amount-type.md b/docs/cookbook/custom-amount-type.md
new file mode 100644
index 0000000..0748140
--- /dev/null
+++ b/docs/cookbook/custom-amount-type.md
@@ -0,0 +1,100 @@
+# Adding a custom amount type
+
+An amount type decides how many points a matched earning rule awards. It is a service
+implementing `Setono\SyliusLoyaltyPlugin\EarningRule\Amount\AmountCalculatorInterface`:
+
+```php
+interface AmountCalculatorInterface
+{
+ public function getType(): string;
+
+ /** A translation key for the rule form's amount type select. */
+ public function getLabel(): string;
+
+ /** @return class-string|null The form type rendering this amount's configuration, or null if it has none. */
+ public function getConfigurationFormType(): ?string;
+
+ /**
+ * Returns the (unrounded) points for the claimed basis. The program's rounding is applied
+ * once on the final total, not per rule.
+ *
+ * @param array $configuration
+ */
+ public function calculate(array $configuration, AmountCalculationInput $input): float;
+}
+```
+
+`calculate()` receives an `Setono\SyliusLoyaltyPlugin\EarningRule\Amount\AmountCalculationInput`
+describing the basis the rule claimed during evaluation:
+
+- `$input->basisAmount` — the eligible amount in minor units of the channel base currency
+- `$input->units` — the number of matching units (order-scoped rules always claim with
+ `units = 1`; item-scoped rules claim the matching items' quantities)
+- `$input->context` — the full `EarningContext` (channel, customer, order, trigger context, ...)
+
+Return a `float` and do not round — the program's rounding mode (floor/round/ceil) is applied
+once on the rule total.
+
+## Example: points per amount, capped
+
+Like the built-in `per_amount` calculator ("X points per Y minor units of claimed basis") but
+with a per-award ceiling:
+
+```php
+basisAmount / $perAmount * (float) $points, (float) $max);
+ }
+}
+```
+
+Implementing the interface is the whole integration: the plugin registers
+`AmountCalculatorInterface` for autoconfiguration, so the service is tagged
+`setono_sylius_loyalty.earning_amount` automatically and the type appears in the amount type
+select of the admin earning rule form (add the translation for your label key). The
+configuration is entered in the rule form and passed to `calculate()` as an array — validate it
+defensively and return `0.0` on invalid shapes.
+
+Only if your project has `autoconfigure: false` do you need to tag manually:
+
+```yaml
+# config/services.yaml
+App\Loyalty\Amount\CappedPerAmountCalculator:
+ tags: ['setono_sylius_loyalty.earning_amount']
+```
diff --git a/docs/cookbook/custom-condition-type.md b/docs/cookbook/custom-condition-type.md
new file mode 100644
index 0000000..ecc2eec
--- /dev/null
+++ b/docs/cookbook/custom-condition-type.md
@@ -0,0 +1,86 @@
+# Adding a custom condition type
+
+Earning rules are made of conditions. A condition type is a service implementing
+`Setono\SyliusLoyaltyPlugin\EarningRule\Checker\ConditionCheckerInterface`:
+
+```php
+interface ConditionCheckerInterface
+{
+ public function getType(): string;
+
+ /** A translation key for the rule form's condition type select. */
+ public function getLabel(): string;
+
+ /** @return class-string|null The form type rendering this condition's configuration, or null if it has none. */
+ public function getConfigurationFormType(): ?string;
+
+ /** @param array $configuration */
+ public function check(array $configuration, EarningContext $context): bool;
+}
+```
+
+`check()` receives the condition's stored configuration and an
+`Setono\SyliusLoyaltyPlugin\EarningRule\EarningContext` exposing everything a rule may look at:
+`$context->channel`, `$context->customer`, `$context->account`, `$context->order` (null for
+action-trigger earning), `$context->itemAmounts` (order item id => eligible amount in minor
+units), `$context->context` (typed trigger context variables), plus `$context->getNow()` and
+`$context->getBasis()`. Use `getNow()` instead of `new \DateTimeImmutable()` so the admin rule
+tester can preview scheduled rules.
+
+## Example: newsletter subscribers only
+
+```php
+customer?->isSubscribedToNewsletter() ?? false;
+ }
+}
+```
+
+That is the whole integration: the plugin registers `ConditionCheckerInterface` for
+autoconfiguration, so any service implementing it is tagged
+`setono_sylius_loyalty.earning_condition` automatically. Add the
+`app.form.earning_rule.condition.newsletter_subscriber` translation and the type appears in the
+condition type select of the admin earning rule form.
+
+If your condition needs configuration (like the built-in `order_total_at_least` checker, which
+reads `$configuration['amount']`), the admin enters it in the rule form's JSON configuration
+field and it arrives in `check()` as an array — validate the shape defensively and return
+`false` on garbage, never throw. `getConfigurationFormType()` is the hook for rendering a
+dedicated configuration form type instead of the JSON field.
+
+Only if your project has `autoconfigure: false` do you need to tag manually:
+
+```yaml
+# config/services.yaml
+App\Loyalty\Checker\NewsletterSubscriberConditionChecker:
+ tags: ['setono_sylius_loyalty.earning_condition']
+```
diff --git a/docs/cookbook/custom-expression-function.md b/docs/cookbook/custom-expression-function.md
new file mode 100644
index 0000000..e7642c1
--- /dev/null
+++ b/docs/cookbook/custom-expression-function.md
@@ -0,0 +1,91 @@
+# Adding a custom expression function
+
+Expression conditions run in a sandboxed expression language with domain functions like
+`orders_count()` and `taxon_total('...')`. A custom function is a service implementing
+`Setono\SyliusLoyaltyPlugin\Expression\Function\ExpressionFunctionInterface`:
+
+```php
+interface ExpressionFunctionInterface
+{
+ public function getName(): string;
+
+ /** E.g. "taxon_total(taxonCode: string): int". */
+ public function getSignature(): string;
+
+ /** A translation key describing the function. */
+ public function getDescription(): string;
+
+ public function evaluate(EarningContext $context, mixed ...$arguments): mixed;
+}
+```
+
+## Example: days since registration
+
+```php
+customer?->getCreatedAt();
+ if (null === $createdAt) {
+ return 0;
+ }
+
+ // Use the context clock so the admin rule tester can preview scheduled rules
+ return $createdAt->diff($context->getNow())->days;
+ }
+}
+```
+
+Implementing the interface is the whole integration: the plugin registers
+`ExpressionFunctionInterface` for autoconfiguration, so the service is tagged
+`setono_sylius_loyalty.expression_function` automatically. The metadata (`getName()`,
+`getSignature()`, `getDescription()`) feeds the admin expression editor's **autocompletion**
+and the generated **reference panel**, so your function shows up in both without further work —
+add the translation for the description key.
+
+An expression like this then validates and evaluates:
+
+```
+days_since_registration() >= 365 and orders_count() >= 3
+```
+
+Guidelines:
+
+- Read state from the `EarningContext` (`channel`, `customer`, `order`, trigger `context`, ...)
+ and return early with a neutral value when a part is missing — action-trigger earning has no
+ order, for example.
+- Use `$context->getNow()` for time, never `new \DateTimeImmutable()`.
+- Validate `$arguments` defensively; expressions are admin-authored.
+
+Only if your project has `autoconfigure: false` do you need to tag manually:
+
+```yaml
+# config/services.yaml
+App\Loyalty\Expression\DaysSinceRegistrationFunction:
+ tags: ['setono_sylius_loyalty.expression_function']
+```
diff --git a/docs/cookbook/custom-referral-fraud-check.md b/docs/cookbook/custom-referral-fraud-check.md
new file mode 100644
index 0000000..73e6238
--- /dev/null
+++ b/docs/cookbook/custom-referral-fraud-check.md
@@ -0,0 +1,86 @@
+# Adding a custom referral fraud check
+
+Referral fraud checks run at qualification, against the referee's qualifying order. A check is a
+service implementing `Setono\SyliusLoyaltyPlugin\Referral\FraudCheck\ReferralFraudCheckInterface`:
+
+```php
+interface ReferralFraudCheckInterface
+{
+ public function check(ReferralInterface $referral, OrderInterface $order): ?FraudFlag;
+}
+```
+
+Return `null` to pass. Return a `FraudFlag` to reject: **any** flag from **any** check rejects
+the referral. All flags are stored on the referral (`ReferralInterface::getFraudFlags()`), so
+admins can see exactly why a referral was rejected — and override the rejection if the flag
+turns out to be a false positive.
+
+`FraudFlag` carries a machine-readable check code and a human-readable detail:
+
+```php
+new FraudFlag('app_disposable_email', 'The referee registered with the disposable email domain "mailinator.com"')
+```
+
+Prefix your check codes (e.g. `app_`) so they cannot collide with the built-in ones.
+
+## Example: reject disposable email domains
+
+```php
+getRefereeCustomer()?->getEmailCanonical();
+ if (null === $email || false === ($atPosition = strrpos($email, '@'))) {
+ return null;
+ }
+
+ $domain = strtolower(substr($email, $atPosition + 1));
+ if (in_array($domain, self::DISPOSABLE_DOMAINS, true)) {
+ return new FraudFlag('app_disposable_email', sprintf('The referee registered with the disposable email domain "%s"', $domain));
+ }
+
+ return null;
+ }
+}
+```
+
+That is the whole integration: the plugin registers `ReferralFraudCheckInterface` for
+autoconfiguration, so any service implementing it is tagged
+`setono_sylius_loyalty.referral_fraud_check` automatically and runs alongside the shipped
+checks on every qualification.
+
+Only if your project has `autoconfigure: false` do you need to tag manually:
+
+```yaml
+# config/services.yaml
+App\Loyalty\FraudCheck\DisposableEmailDomainCheck:
+ tags: ['setono_sylius_loyalty.referral_fraud_check']
+```
+
+## Shipped checks
+
+The plugin ships four checks: **self-referral** (same customer, identically normalized emails,
+or a shared address between referrer and referee), **registration IP** (opt-in; flags a referee
+registering from the same IP as another referee of the same referrer, using salted hashes purged
+after 90 days), **account age** (the referee account existed before the referral was captured),
+and **reward cap** (the referrer exceeded the rewarded-referrals cap for the trailing 30 days,
+default 10).
diff --git a/docs/cookbook/custom-tier-qualification-basis.md b/docs/cookbook/custom-tier-qualification-basis.md
new file mode 100644
index 0000000..2b37f99
--- /dev/null
+++ b/docs/cookbook/custom-tier-qualification-basis.md
@@ -0,0 +1,82 @@
+# Custom tier qualification basis
+
+Tiers qualify on a metric computed by a *qualification basis*. The plugin ships `points_earned`,
+`amount_spent`, and `orders_count`; adding your own makes it appear in the tier form's basis
+select automatically.
+
+Implement `TierQualificationBasisInterface`:
+
+```php
+entityManager->createQueryBuilder()
+ ->select('COUNT(r.id)')
+ ->from(\Sylius\Component\Core\Model\ProductReview::class, 'r')
+ ->andWhere('r.author = :customer')
+ ->andWhere('r.status = :accepted')
+ ->setParameter('customer', $account->getCustomer())
+ ->setParameter('accepted', 'accepted')
+ ;
+
+ // A null window means lifetime. A custom basis may interpret or ignore the window —
+ // that is the escape hatch for exotic windows.
+ if (null !== $window) {
+ $qb->andWhere('r.createdAt >= :start')->setParameter('start', $window->start)
+ ->andWhere('r.createdAt <= :end')->setParameter('end', $window->end);
+ }
+
+ return (int) $qb->getQuery()->getSingleScalarResult();
+ }
+}
+```
+
+With autoconfiguration enabled (the default), implementing the interface is the whole
+integration — the class is tagged `setono_sylius_loyalty.tier_qualification_basis`
+automatically. Without autoconfigure, tag it yourself:
+
+```yaml
+services:
+ App\Loyalty\ReviewsWrittenBasis:
+ tags: ['setono_sylius_loyalty.tier_qualification_basis']
+```
+
+Notes:
+
+- `calculate()` runs inside the ledger transaction on inline upgrades, so keep it a cheap
+ aggregate query — never a replay.
+- The window resolved from the program (`calendar_year` | `rolling_12_months` | `lifetime`)
+ is handed to you; use inclusive bounds (`>= start`, `<= end`) so activity from the very
+ second of the evaluation counts.
+- The unit label shows up as the threshold field's hint in the tier form.
diff --git a/docs/cookbook/custom-transaction-type.md b/docs/cookbook/custom-transaction-type.md
new file mode 100644
index 0000000..bd613f4
--- /dev/null
+++ b/docs/cookbook/custom-transaction-type.md
@@ -0,0 +1,112 @@
+# Adding a custom transaction type
+
+The ledger is a Doctrine single-table-inheritance hierarchy rooted at
+`Setono\SyliusLoyaltyPlugin\Model\LoyaltyTransaction` (table
+`setono_sylius_loyalty__transaction`, discriminator column `type`, length 64). You can add your
+own transaction types — e.g. an imported balance from a legacy program — without touching the
+plugin's mapping.
+
+## 1. The entity
+
+Extend `Setono\SyliusLoyaltyPlugin\Model\CreditLoyaltyTransaction` (credits carry an optional
+`expiresAt` and act as lots) or `Setono\SyliusLoyaltyPlugin\Model\DebitLoyaltyTransaction`:
+
+```php
+legacyReference;
+ }
+
+ public function setLegacyReference(?string $legacyReference): void
+ {
+ $this->legacyReference = $legacyReference;
+ }
+}
+```
+
+## 2. The Doctrine mapping (host-side)
+
+The plugin maps the parent; you map your subclass. Because the hierarchy is single-table, every
+extra column must be nullable:
+
+```xml
+
+
+
+
+
+
+
+
+```
+
+(Attribute mapping works just as well if that is what your project uses.) Generate a migration
+with `doctrine:migrations:diff` — the plugin ships no migrations.
+
+## 3. Register the class as a resource
+
+```yaml
+# config/packages/sylius_resource.yaml
+sylius_resource:
+ resources:
+ app.legacy_import_loyalty_transaction:
+ classes:
+ model: App\Entity\Loyalty\LegacyImportLoyaltyTransaction
+```
+
+The plugin scans the registered resources at metadata load time and adds every model
+extending the transaction root to the discriminator map under its own
+`getDiscriminator()` value, so `legacy_import` becomes a valid `type` value alongside the
+built-ins (`earn_order`, `earn_action`, `earn_referral`, `redeem`, `redeem_rollback`,
+`expire`, `clawback`, `manual_credit`, `manual_debit`).
+
+## All writes still go through the ledger
+
+The ledger is **append-only** and `Setono\SyliusLoyaltyPlugin\Ledger\LoyaltyLedgerInterface` is
+its single write path: every write locks the account row (pessimistic write lock inside a
+transaction), appends the entry, and updates the cached `balance`/`lifetimeEarned` in the same
+transaction. Never `persist()` a transaction row directly, and never update or delete one —
+corrections are new compensating entries.
+
+To actually write your custom type, follow the same pattern the default ledger uses — typically
+by decorating `LoyaltyLedgerInterface` (its service id is the interface FQCN, so re-alias or
+use Symfony service decoration) with a method for your type:
+
+```php
+$this->entityManager->wrapInTransaction(function () use ($accountId, $points): void {
+ $account = $this->entityManager
+ ->getRepository($this->accountClass)
+ ->find($accountId, \Doctrine\DBAL\LockMode::PESSIMISTIC_WRITE);
+
+ $transaction = new LegacyImportLoyaltyTransaction();
+ $transaction->setAccount($account);
+ $transaction->setPoints($points); // credits positive, debits negative
+ $this->entityManager->persist($transaction);
+
+ $account->setBalance($account->getBalance() + $points);
+ $account->setLifetimeEarned($account->getLifetimeEarned() + $points);
+});
+```
+
+Custom rows participate in replay like any other: credits with an `expiresAt` are lots consumed
+FIFO, and `setono:sylius-loyalty:verify-ledger` checks them against the same invariants.
diff --git a/docs/cookbook/custom-trigger.md b/docs/cookbook/custom-trigger.md
new file mode 100644
index 0000000..42bc18d
--- /dev/null
+++ b/docs/cookbook/custom-trigger.md
@@ -0,0 +1,87 @@
+# Adding a custom earning trigger
+
+A trigger *is* an event class: extend
+`Setono\SyliusLoyaltyPlugin\Event\Trigger\EarningTriggerEvent`, register the class under the
+`setono_sylius_loyalty.triggers` config node, and fire it with a plain event dispatch. The
+plugin evaluates the trigger's earning rules and writes the award — you never touch the ledger.
+
+## 1. The event class
+
+```php
+eventDispatcher->dispatch(new SocialShareTriggerEvent($customer, 'instagram'));
+```
+
+## Source identifier semantics
+
+`sourceIdentifier` deduplicates awards per account at the database level (a unique constraint —
+concurrent dispatches and message redeliveries are no-ops by construction):
+
+- **Default** (pass `null` / omit): the source identifier is the trigger code, which means
+ **once per account, ever**. Right for one-shot actions like "completed profile".
+- **Repeatable triggers pass their own**: the built-ins use `review:` and
+ `birthday:`; the example above uses `social_share:`. A dispatch with an
+ already-awarded identifier is a silent no-op, so re-dispatching is always safe.
+
+## Channel
+
+Pass the channel when you know it. When `null`, the plugin resolves it via the
+`TriggerChannelResolver` chain (re-alias
+`Setono\SyliusLoyaltyPlugin\Resolver\TriggerChannelResolverInterface` to customize); an
+unresolvable channel makes the dispatch a logged no-op.
diff --git a/docs/cookbook/intercepting-pre-events.md b/docs/cookbook/intercepting-pre-events.md
new file mode 100644
index 0000000..87fde31
--- /dev/null
+++ b/docs/cookbook/intercepting-pre-events.md
@@ -0,0 +1,89 @@
+# Intercepting ledger writes with pre-events
+
+Right before writing a ledger entry, the ledger dispatches a pre-event — inside the account
+lock, in the same database transaction. Listeners can adjust or cancel the pending write. The
+events are plain objects dispatched by class name (`Setono\SyliusLoyaltyPlugin\Event\...`):
+
+| Event | Adjustable | `cancel()` means |
+|---|---|---|
+| `AwardingPoints` | `setPoints()`, `setExpiresAt()` | No credit is written |
+| `RedeemingPoints` | nothing (the debit must equal the applied points) | Checkout completion aborts with a validation error |
+| `ExpiringPoints` | nothing (points equal the lot's replay-derived remaining) | The lot is deferred and re-selected on the next expiry run |
+| `ClawingBackPoints` | `setPoints()` | No clawback debit is written |
+
+`AwardingPoints` covers both earning paths: `getOrder()` is set for order earning (and
+`getSourceIdentifier()` is null), while action-trigger earning sets `getSourceIdentifier()`
+(and `getOrder()` is null). All four events expose `getAccount()`.
+
+## Example: double points for staff
+
+```php
+getAccount()->getCustomer()?->getEmail();
+ if (null === $email || !str_ends_with($email, '@my-company.com')) {
+ return;
+ }
+
+ $event->setPoints($event->getPoints() * 2);
+ }
+}
+```
+
+No configuration needed: `#[AsEventListener]` is autoconfigured by Symfony, and the events are
+dispatched with the standard event dispatcher (an `EventSubscriberInterface` subscribing to
+`AwardingPoints::class` works the same way).
+
+## Example: a grace period before expiration
+
+Cancelling `ExpiringPoints` writes nothing and leaves the lot open — it is simply re-selected
+on the next `setono:sylius-loyalty:expire-points` run, which makes it the hook for
+project-level grace logic:
+
+```php
+getLot()->getExpiresAt();
+
+ // Give every lot 14 extra days beyond its nominal expiry
+ if (null !== $expiresAt && $expiresAt->modify('+14 days') > new \DateTimeImmutable()) {
+ $event->cancel();
+ }
+ }
+}
+```
+
+Notes:
+
+- Setting `AwardingPoints` points to `0` (or below) has the same effect as `cancel()`.
+- Cancelling `RedeemingPoints` is a hard stop: the ledger throws a `LedgerConflictException`
+ and the checkout `complete` transition is aborted — use it for last-second fraud checks, not
+ for soft adjustments.
+- Listeners run inside the ledger transaction: keep them fast and side-effect free. For
+ reacting *after* a write committed, use the post-commit events instead (`PointsEarned`,
+ `PointsRedeemed`, `PointsExpired`, `PointsClawedBack`, `RedemptionRolledBack`,
+ `ManualAdjustment`).
diff --git a/docs/cookbook/partial-refund-clawback.md b/docs/cookbook/partial-refund-clawback.md
new file mode 100644
index 0000000..96cd1dc
--- /dev/null
+++ b/docs/cookbook/partial-refund-clawback.md
@@ -0,0 +1,81 @@
+# Clawing back points on a partial refund
+
+Full clawback ships built in: when an order that earned points is cancelled, or its payment
+goes through the `refund` transition, the plugin debits the earned points automatically.
+**Partial** refunds are project-specific (Sylius core has no partial-refund flow), so the
+ledger exposes the write as a public extension point:
+
+```php
+// Setono\SyliusLoyaltyPlugin\Ledger\LoyaltyLedgerInterface
+public function clawback(OrderInterface $order, int $points): ?ClawbackLoyaltyTransactionInterface;
+```
+
+`$points` is a positive magnitude (the ledger applies the sign). The earn credit is looked up
+via the order; if the order never earned points, the call is a no-op returning `null`.
+
+## Example: proportional clawback from a refund event
+
+A listener on your refund mechanism's event (Sylius Refund Plugin, a PSP webhook, a custom
+admin action — anything that knows the order and the refunded amount):
+
+```php
+getOrder();
+
+ $earn = $this->transactionRepository->findEarnOrderTransaction($order);
+ if (null === $earn || $order->getTotal() <= 0) {
+ return; // the order never earned points
+ }
+
+ // Claw back the earned points proportionally to the refunded share of the order
+ $points = (int) round($earn->getPoints() * $event->getRefundedAmount() / $order->getTotal());
+ if ($points <= 0) {
+ return;
+ }
+
+ $this->ledger->clawback($order, $points);
+ }
+}
+```
+
+Both `LoyaltyLedgerInterface` and `LoyaltyTransactionRepositoryInterface` are aliased to their
+interface ids, so autowiring works.
+
+## What the ledger does with it
+
+- **Pre-event** — `Setono\SyliusLoyaltyPlugin\Event\ClawingBackPoints` is dispatched first;
+ listeners may adjust the points or cancel the write (then `clawback()` returns `null`).
+- **Clawback policy (clamp)** — with the program's default `clamp_to_zero` policy, the debit is
+ reduced at write time to `min(points, balance)` so the balance lands at exactly zero and
+ never goes negative — the ledger entry records what was actually debited. With the
+ `allow_negative` policy the full amount is debited and the balance may go negative.
+- **Idempotency** — a database unique constraint guarantees each earn credit is clawed back
+ **at most once**. Repeating the call for the same order (event redelivery, concurrent
+ processes) is a silent no-op returning `null`.
+
+That last point has a design consequence: an order supports **one** clawback entry, ever. If
+your flow can refund the same order in several steps, aggregate the refunded amounts and call
+`clawback()` once with the final proportional total — a second call will not write anything.
+For the same reason, once your partial clawback is written, the built-in full clawback on a
+later cancellation/refund of that order becomes a no-op (and vice versa).
diff --git a/docs/cookbook/rendering-the-balance.md b/docs/cookbook/rendering-the-balance.md
new file mode 100644
index 0000000..e823e8e
--- /dev/null
+++ b/docs/cookbook/rendering-the-balance.md
@@ -0,0 +1,82 @@
+# Rendering the balance in your templates
+
+The plugin ships a shop account page and cart/checkout blocks, but the Twig functions behind
+them are public, so you can render loyalty data anywhere (header badge, dashboard, emails):
+
+| Function | Returns |
+|---|---|
+| `setono_sylius_loyalty_accounts(customer)` | The customer's loyalty accounts (one per channel) |
+| `setono_sylius_loyalty_latest_transactions(account, limit = 25)` | The account's latest ledger entries, newest first |
+| `setono_sylius_loyalty_transaction_type(transaction)` | The entry's discriminator value (e.g. `"earn_order"`, `"redeem"`) |
+| `setono_sylius_loyalty_cart_redemption(cart)` | A `CartRedemptionView` for the cart's channel/customer (balance, presets, requested/applied points), or `null` |
+
+## Example: a header points badge with recent activity
+
+```twig
+{# templates/bundles/SyliusShopBundle/_loyalty_badge.html.twig #}
+{% if app.user is not null and app.user.customer is not null %}
+ {% set accounts = setono_sylius_loyalty_accounts(app.user.customer)|filter(
+ account => account.channel is same as(sylius.channel)
+ ) %}
+
+ {% for account in accounts %}
+
+
+ {{ account.balance }} {{ 'setono_sylius_loyalty.ui.points'|trans }}
+
+
+
+
+ {% for transaction in setono_sylius_loyalty_latest_transactions(account, 5) %}
+
+{% endif %}
diff --git a/src/Resources/views/shop/checkout/_redemption_summary.html.twig b/src/Resources/views/shop/checkout/_redemption_summary.html.twig
new file mode 100644
index 0000000..482d2ae
--- /dev/null
+++ b/src/Resources/views/shop/checkout/_redemption_summary.html.twig
@@ -0,0 +1,12 @@
+{% import '@SyliusShop/Common/Macro/money.html.twig' as money %}
+
+{% set redemption = order is defined ? setono_sylius_loyalty_cart_redemption(order) : null %}
+
+{% if redemption is not null and redemption.appliedPoints > 0 %}
+
+{% endif %}
diff --git a/src/Resources/views/shop/product/_earn_hint.html.twig b/src/Resources/views/shop/product/_earn_hint.html.twig
new file mode 100644
index 0000000..48dddda
--- /dev/null
+++ b/src/Resources/views/shop/product/_earn_hint.html.twig
@@ -0,0 +1,24 @@
+{% set hint = setono_sylius_loyalty_product_earn_hint(product) %}
+
+{% if hint is not null %}
+
+
+ {{ 'setono_sylius_loyalty.ui.earn_hint_product'|trans({'%points%': hint.default}) }}
+
+ {# One entry per variant, keyed both by variant code and by option-value data
+ attributes so the map works for choice- and option-based selection alike #}
+
+ {% for variantCode, points in hint.variants %}
+ {% set variant = null %}
+ {% for candidate in product.enabledVariants %}
+ {% if candidate.code == variantCode %}{% set variant = candidate %}{% endif %}
+ {% endfor %}
+
+ {% endfor %}
+
+
+
+{% endif %}
diff --git a/src/SetonoSyliusLoyaltyPlugin.php b/src/SetonoSyliusLoyaltyPlugin.php
index 45b9c9b..a305b05 100644
--- a/src/SetonoSyliusLoyaltyPlugin.php
+++ b/src/SetonoSyliusLoyaltyPlugin.php
@@ -4,10 +4,58 @@
namespace Setono\SyliusLoyaltyPlugin;
+use Setono\CompositeCompilerPass\CompositeCompilerPass;
+use Setono\SyliusLoyaltyPlugin\DependencyInjection\Compiler\RegisterEarningTriggersPass;
+use Setono\SyliusLoyaltyPlugin\EarningRule\Amount\AmountCalculatorRegistry;
+use Setono\SyliusLoyaltyPlugin\EarningRule\Checker\ConditionCheckerRegistry;
+use Setono\SyliusLoyaltyPlugin\Expression\Function\ExpressionFunctionRegistry;
+use Setono\SyliusLoyaltyPlugin\Referral\FraudCheck\CompositeReferralFraudCheck;
+use Setono\SyliusLoyaltyPlugin\Tier\QualificationBasis\TierQualificationBasisRegistry;
use Sylius\Bundle\CoreBundle\Application\SyliusPluginTrait;
-use Symfony\Component\HttpKernel\Bundle\Bundle;
+use Sylius\Bundle\ResourceBundle\AbstractResourceBundle;
+use Sylius\Bundle\ResourceBundle\SyliusResourceBundle;
+use Symfony\Component\DependencyInjection\Compiler\PassConfig;
+use Symfony\Component\DependencyInjection\ContainerBuilder;
-final class SetonoSyliusLoyaltyPlugin extends Bundle
+final class SetonoSyliusLoyaltyPlugin extends AbstractResourceBundle
{
use SyliusPluginTrait;
+
+ public function build(ContainerBuilder $container): void
+ {
+ parent::build($container);
+
+ $container->addCompilerPass(new CompositeCompilerPass(
+ ConditionCheckerRegistry::class,
+ 'setono_sylius_loyalty.earning_condition',
+ ));
+ $container->addCompilerPass(new CompositeCompilerPass(
+ AmountCalculatorRegistry::class,
+ 'setono_sylius_loyalty.earning_amount',
+ ));
+ $container->addCompilerPass(new CompositeCompilerPass(
+ ExpressionFunctionRegistry::class,
+ 'setono_sylius_loyalty.expression_function',
+ ));
+ $container->addCompilerPass(new CompositeCompilerPass(
+ TierQualificationBasisRegistry::class,
+ 'setono_sylius_loyalty.tier_qualification_basis',
+ ));
+ $container->addCompilerPass(new CompositeCompilerPass(
+ CompositeReferralFraudCheck::class,
+ 'setono_sylius_loyalty.referral_fraud_check',
+ ));
+
+ // Must run before Symfony's RegisterListenersPass (same phase, priority 0) so the
+ // trigger listener tags it adds are picked up
+ $container->addCompilerPass(new RegisterEarningTriggersPass(), PassConfig::TYPE_BEFORE_OPTIMIZATION, 10);
+ }
+
+ /**
+ * @return list
+ */
+ public function getSupportedDrivers(): array
+ {
+ return [SyliusResourceBundle::DRIVER_DOCTRINE_ORM];
+ }
}
diff --git a/src/Tier/EvaluationWindowResolver.php b/src/Tier/EvaluationWindowResolver.php
new file mode 100644
index 0000000..dda0201
--- /dev/null
+++ b/src/Tier/EvaluationWindowResolver.php
@@ -0,0 +1,25 @@
+getTierEvaluationWindow()) {
+ LoyaltyProgramInterface::TIER_EVALUATION_WINDOW_LIFETIME => null,
+ LoyaltyProgramInterface::TIER_EVALUATION_WINDOW_CALENDAR_YEAR => new DateRange(
+ $now->modify('first day of january this year')->setTime(0, 0),
+ $now->modify('first day of january next year')->setTime(0, 0),
+ ),
+ default => new DateRange($now->modify('-12 months'), $now),
+ };
+ }
+}
diff --git a/src/Tier/EvaluationWindowResolverInterface.php b/src/Tier/EvaluationWindowResolverInterface.php
new file mode 100644
index 0000000..ebc9b7c
--- /dev/null
+++ b/src/Tier/EvaluationWindowResolverInterface.php
@@ -0,0 +1,16 @@
+entityManager->createQueryBuilder()
+ ->select('COALESCE(SUM(o.total), 0)')
+ ->from($this->orderClass, 'o')
+ ->andWhere('o.customer = :customer')
+ ->andWhere('o.channel = :channel')
+ ->andWhere('o.paymentState = :paymentState')
+ ->setParameter('customer', $account->getCustomer())
+ ->setParameter('channel', $account->getChannel())
+ ->setParameter('paymentState', OrderPaymentStates::STATE_PAID)
+ ;
+
+ if (null !== $window) {
+ $qb->andWhere('o.checkoutCompletedAt >= :start')->setParameter('start', $window->start);
+ $qb->andWhere('o.checkoutCompletedAt <= :end')->setParameter('end', $window->end);
+ }
+
+ return (int) $qb->getQuery()->getSingleScalarResult();
+ }
+}
diff --git a/src/Tier/QualificationBasis/DateRange.php b/src/Tier/QualificationBasis/DateRange.php
new file mode 100644
index 0000000..43216aa
--- /dev/null
+++ b/src/Tier/QualificationBasis/DateRange.php
@@ -0,0 +1,14 @@
+entityManager->createQueryBuilder()
+ ->select('COUNT(o.id)')
+ ->from($this->orderClass, 'o')
+ ->andWhere('o.customer = :customer')
+ ->andWhere('o.channel = :channel')
+ ->andWhere('o.paymentState = :paymentState')
+ ->setParameter('customer', $account->getCustomer())
+ ->setParameter('channel', $account->getChannel())
+ ->setParameter('paymentState', OrderPaymentStates::STATE_PAID)
+ ;
+
+ if (null !== $window) {
+ $qb->andWhere('o.checkoutCompletedAt >= :start')->setParameter('start', $window->start);
+ $qb->andWhere('o.checkoutCompletedAt <= :end')->setParameter('end', $window->end);
+ }
+
+ return (int) $qb->getQuery()->getSingleScalarResult();
+ }
+}
diff --git a/src/Tier/QualificationBasis/PointsEarnedBasis.php b/src/Tier/QualificationBasis/PointsEarnedBasis.php
new file mode 100644
index 0000000..e0384f3
--- /dev/null
+++ b/src/Tier/QualificationBasis/PointsEarnedBasis.php
@@ -0,0 +1,62 @@
+entityManager->createQueryBuilder()
+ ->select('COALESCE(SUM(t.points), 0)')
+ ->from($this->transactionClass, 't')
+ ->andWhere('t.account = :account')
+ ->andWhere('t.points > 0')
+ ->andWhere('t NOT INSTANCE OF :rollback')
+ ->setParameter('account', $account)
+ ->setParameter('rollback', $this->entityManager->getClassMetadata(RedeemRollbackLoyaltyTransaction::class))
+ ;
+
+ if (null !== $window) {
+ $qb->andWhere('t.occurredAt >= :start')->setParameter('start', $window->start);
+ $qb->andWhere('t.occurredAt <= :end')->setParameter('end', $window->end);
+ }
+
+ return (int) $qb->getQuery()->getSingleScalarResult();
+ }
+}
diff --git a/src/Tier/QualificationBasis/TierQualificationBasisInterface.php b/src/Tier/QualificationBasis/TierQualificationBasisInterface.php
new file mode 100644
index 0000000..a5e8c41
--- /dev/null
+++ b/src/Tier/QualificationBasis/TierQualificationBasisInterface.php
@@ -0,0 +1,35 @@
+
+ */
+final class TierQualificationBasisRegistry extends CompositeService implements TierQualificationBasisRegistryInterface
+{
+ public function get(string $code): TierQualificationBasisInterface
+ {
+ $available = [];
+ foreach ($this->services as $basis) {
+ if ($basis->getCode() === $code) {
+ return $basis;
+ }
+ $available[] = $basis->getCode();
+ }
+
+ throw InvalidTierQualificationBasisException::unknown($code, $available);
+ }
+
+ public function all(): array
+ {
+ return $this->services;
+ }
+}
diff --git a/src/Tier/QualificationBasis/TierQualificationBasisRegistryInterface.php b/src/Tier/QualificationBasis/TierQualificationBasisRegistryInterface.php
new file mode 100644
index 0000000..f1266bc
--- /dev/null
+++ b/src/Tier/QualificationBasis/TierQualificationBasisRegistryInterface.php
@@ -0,0 +1,18 @@
+
+ */
+ public function all(): array;
+}
diff --git a/src/Tier/TierEvaluator.php b/src/Tier/TierEvaluator.php
new file mode 100644
index 0000000..93a71c5
--- /dev/null
+++ b/src/Tier/TierEvaluator.php
@@ -0,0 +1,135 @@
+qualifiedTier($account);
+ if (null === $qualified) {
+ return;
+ }
+
+ $current = $account->getTier();
+ if (null !== $current && $qualified->getPosition() <= $current->getPosition()) {
+ return;
+ }
+
+ $this->change($account, $qualified);
+ $account->setTierBelowThresholdSince(null);
+ }
+
+ /**
+ * Nightly reconciliation: upgrades apply, downgrades apply immediately or after the
+ * program's grace period, counted from when the account first evaluated below its tier.
+ */
+ public function reconcile(LoyaltyAccountInterface $account, \DateTimeImmutable $now): void
+ {
+ $qualified = $this->qualifiedTier($account);
+ $current = $account->getTier();
+
+ $qualifiedPosition = $qualified?->getPosition() ?? \PHP_INT_MIN;
+ $currentPosition = null === $current ? \PHP_INT_MIN : $current->getPosition();
+
+ if ($qualifiedPosition === $currentPosition) {
+ $account->setTierBelowThresholdSince(null);
+
+ return;
+ }
+
+ if ($qualifiedPosition > $currentPosition) {
+ $this->change($account, $qualified);
+ $account->setTierBelowThresholdSince(null);
+
+ return;
+ }
+
+ // Below the current tier: start or continue the grace clock
+ $channel = $account->getChannel();
+ \assert($channel instanceof ChannelInterface);
+ $graceDays = $this->programProvider->getByChannel($channel)->getTierDowngradeGraceDays();
+
+ $belowSince = $account->getTierBelowThresholdSince();
+ if (null === $belowSince) {
+ $account->setTierBelowThresholdSince($now);
+ $belowSince = $now;
+ }
+
+ if ($belowSince->modify(sprintf('+%d days', $graceDays)) <= $now) {
+ $this->change($account, $qualified);
+ $account->setTierBelowThresholdSince(null);
+ }
+ }
+
+ /**
+ * The highest enabled tier whose threshold the account meets on that tier's own basis.
+ */
+ private function qualifiedTier(LoyaltyAccountInterface $account): ?TierInterface
+ {
+ $channel = $account->getChannel();
+ if (!$channel instanceof ChannelInterface) {
+ return null;
+ }
+
+ $tiers = $this->tierRepository->findQualifiable($channel);
+ if ([] === $tiers) {
+ return null;
+ }
+
+ $window = $this->windowResolver->resolve($this->programProvider->getByChannel($channel));
+
+ /** @var array $metrics */
+ $metrics = [];
+ foreach ($tiers as $tier) {
+ $basisCode = $tier->getQualificationBasis();
+ $metrics[$basisCode] ??= $this->basisRegistry->get($basisCode)->calculate($account, $window);
+
+ if ($metrics[$basisCode] >= $tier->getThreshold()) {
+ return $tier;
+ }
+ }
+
+ return null;
+ }
+
+ private function change(LoyaltyAccountInterface $account, ?TierInterface $to): void
+ {
+ $from = $account->getTier();
+
+ $changing = new TierChanging($account, $from, $to);
+ $this->eventDispatcher->dispatch($changing);
+ if ($changing->isCancelled()) {
+ return;
+ }
+
+ $account->setTier($to);
+
+ $this->eventDispatcher->dispatch(new TierChanged($account, $from, $to));
+ }
+}
diff --git a/src/Tier/TierEvaluatorInterface.php b/src/Tier/TierEvaluatorInterface.php
new file mode 100644
index 0000000..7edf4ed
--- /dev/null
+++ b/src/Tier/TierEvaluatorInterface.php
@@ -0,0 +1,25 @@
+ $accountClass
+ */
+ public function __construct(
+ private readonly CartRedemptionViewProviderInterface $cartRedemptionViewProvider,
+ private readonly LoyaltyTransactionRepositoryInterface $transactionRepository,
+ private readonly EntityManagerInterface $entityManager,
+ private readonly EarnHintCalculatorInterface $earnHintCalculator,
+ private readonly LoyaltyProgramProviderInterface $programProvider,
+ private readonly ChannelContextInterface $channelContext,
+ private readonly CustomerContextInterface $customerContext,
+ private readonly string $accountClass,
+ ) {
+ }
+
+ public function cartRedemption(OrderInterface $cart): ?CartRedemptionView
+ {
+ return $this->cartRedemptionViewProvider->getView($cart);
+ }
+
+ /**
+ * The transaction's discriminator value (e.g. "earn_order", "redeem").
+ */
+ public function transactionType(LoyaltyTransactionInterface $transaction): string
+ {
+ $discriminator = $this->entityManager->getClassMetadata($transaction::class)->discriminatorValue;
+
+ return is_string($discriminator) ? $discriminator : $transaction::class;
+ }
+
+ /**
+ * @return list
+ */
+ public function accountsOf(CustomerInterface $customer): array
+ {
+ /** @var list $accounts */
+ $accounts = $this->entityManager->getRepository($this->accountClass)->findBy(['customer' => $customer]);
+
+ return $accounts;
+ }
+
+ /**
+ * The account's latest transactions, newest first.
+ *
+ * @return list
+ */
+ public function latestTransactions(LoyaltyAccountInterface $account, int $limit = 25): array
+ {
+ return array_slice(array_reverse($this->transactionRepository->findForReplay($account)), 0, $limit);
+ }
+
+ /**
+ * Per-variant earn hint for the product page, or null when hidden (toggle off, no
+ * applicable rules, disabled account).
+ *
+ * @return array{default: int, variants: array}|null
+ */
+ public function productEarnHint(ProductInterface $product): ?array
+ {
+ $channel = $this->channelContext->getChannel();
+ if (!$channel instanceof ChannelInterface || !$this->programProvider->getByChannel($channel)->isShowEarnableOnProduct()) {
+ return null;
+ }
+
+ $customer = $this->customerContext->getCustomer();
+ $customer = $customer instanceof CustomerInterface ? $customer : null;
+
+ $variants = [];
+ $default = null;
+ foreach ($product->getEnabledVariants() as $variant) {
+ \assert($variant instanceof ProductVariantInterface);
+ $points = $this->earnHintCalculator->forVariant($variant, $channel, $customer);
+ $variants[(string) $variant->getCode()] = $points;
+ $default ??= $points;
+ }
+
+ return null === $default ? null : ['default' => $default, 'variants' => $variants];
+ }
+
+ /**
+ * "This order earns ~N points", or null when hidden.
+ */
+ public function cartEarnHint(OrderInterface $cart): ?int
+ {
+ $channel = $cart->getChannel();
+ if (!$channel instanceof ChannelInterface || !$this->programProvider->getByChannel($channel)->isShowEarnableInCart()) {
+ return null;
+ }
+
+ $customer = $cart->getCustomer();
+
+ return $this->earnHintCalculator->forCart($cart, $customer instanceof CustomerInterface ? $customer : null);
+ }
+}
diff --git a/src/Validator/Constraints/LoyaltyRedemptionValid.php b/src/Validator/Constraints/LoyaltyRedemptionValid.php
new file mode 100644
index 0000000..c0685fa
--- /dev/null
+++ b/src/Validator/Constraints/LoyaltyRedemptionValid.php
@@ -0,0 +1,30 @@
+appliedPointsProvider->getAppliedPoints($value);
+ if ($appliedPoints <= 0) {
+ return;
+ }
+
+ $customer = $value->getCustomer();
+ $channel = $value->getChannel();
+ if (!$customer instanceof CustomerInterface || null === $channel) {
+ return;
+ }
+
+ $account = $this->accountRepository->findOneByCustomerAndChannel($customer, $channel);
+
+ if (null === $account || !$account->isEnabled()) {
+ $this->context->buildViolation($constraint->accountDisabledMessage)->addViolation();
+
+ return;
+ }
+
+ if ($account->getBalance() < $appliedPoints) {
+ $this->context->buildViolation($constraint->insufficientBalanceMessage)->addViolation();
+ }
+ }
+}
diff --git a/tests/Application/.env b/tests/Application/.env
index f4370e8..5ee199a 100644
--- a/tests/Application/.env
+++ b/tests/Application/.env
@@ -23,13 +23,13 @@ APP_SECRET=EDITME
# Format described at https://docs.doctrine-project.org/projects/doctrine-dbal/en/latest/reference/configuration.html#connecting-using-a-url
# For a sqlite database, use: "sqlite:///%kernel.project_dir%/var/data.db"
# Set "serverVersion" to your server version to avoid edge-case exceptions and extra database calls
-DATABASE_URL=mysql://root@127.0.0.1/acme_sylius_skeleton_%kernel.environment%?serverVersion=11.6.2-MariaDB
+DATABASE_URL=mysql://root@127.0.0.1/setono_sylius_loyalty_%kernel.environment%?serverVersion=11.6.2-MariaDB
###< doctrine/doctrine-bundle ###
###> lexik/jwt-authentication-bundle ###
JWT_SECRET_KEY=%kernel.project_dir%/config/jwt/private.pem
JWT_PUBLIC_KEY=%kernel.project_dir%/config/jwt/public.pem
-JWT_PASSPHRASE=acme_plugin_development
+JWT_PASSPHRASE=setono_sylius_loyalty_development
###< lexik/jwt-authentication-bundle ###
###> symfony/messenger ###
diff --git a/tests/Application/Entity/Order.php b/tests/Application/Entity/Order.php
new file mode 100644
index 0000000..ebec709
--- /dev/null
+++ b/tests/Application/Entity/Order.php
@@ -0,0 +1,17 @@
+ ['all' => true],
League\FlysystemBundle\FlysystemBundle::class => ['all' => true],
Symfony\WebpackEncoreBundle\WebpackEncoreBundle::class => ['all' => true],
+ DAMA\DoctrineTestBundle\DAMADoctrineTestBundle::class => ['test' => true],
];
diff --git a/tests/Application/config/packages/doctrine.yaml b/tests/Application/config/packages/doctrine.yaml
index f51ba5a..1b33c51 100644
--- a/tests/Application/config/packages/doctrine.yaml
+++ b/tests/Application/config/packages/doctrine.yaml
@@ -12,3 +12,11 @@ doctrine:
charset: UTF8
url: '%env(resolve:DATABASE_URL)%'
+
+ orm:
+ mappings:
+ TestApplication:
+ is_bundle: false
+ type: attribute
+ dir: '%kernel.project_dir%/Entity'
+ prefix: 'Setono\SyliusLoyaltyPlugin\Tests\Application\Entity'
diff --git a/tests/Application/config/packages/messenger.yaml b/tests/Application/config/packages/messenger.yaml
new file mode 100644
index 0000000..524ea05
--- /dev/null
+++ b/tests/Application/config/packages/messenger.yaml
@@ -0,0 +1,6 @@
+# The loyalty_async transport exists for the async awarding functional test: nothing routes
+# to it by default (awarding stays sync), the test targets it with a TransportNamesStamp.
+framework:
+ messenger:
+ transports:
+ loyalty_async: 'doctrine://default?queue_name=loyalty_test'
diff --git a/tests/Application/config/packages/setono_sylius_loyalty.yaml b/tests/Application/config/packages/setono_sylius_loyalty.yaml
index 78e8885..5bea7d3 100644
--- a/tests/Application/config/packages/setono_sylius_loyalty.yaml
+++ b/tests/Application/config/packages/setono_sylius_loyalty.yaml
@@ -1,2 +1,4 @@
setono_sylius_loyalty:
- option: Option value
+ expression_editor:
+ # Vendored snapshot so CI never depends on CDN reachability
+ cdn_base_url: '/vendor/codemirror'
diff --git a/tests/Application/config/packages/sylius_fixtures_loyalty.yaml b/tests/Application/config/packages/sylius_fixtures_loyalty.yaml
new file mode 100644
index 0000000..bf413b1
--- /dev/null
+++ b/tests/Application/config/packages/sylius_fixtures_loyalty.yaml
@@ -0,0 +1,114 @@
+# The deterministic loyalty seed for functional and e2e tests. Loaded on top of the default
+# suite (no purge listeners): sylius:fixtures:load default && sylius:fixtures:load loyalty
+sylius_fixtures:
+ suites:
+ loyalty:
+ fixtures:
+ setono_sylius_loyalty_program:
+ options:
+ custom:
+ - channel: FASHION_WEB
+ min_redeem_points: 500
+ max_redeem_percent_of_order: 50
+ points_expiry_days: 365
+
+ setono_sylius_loyalty_tier:
+ options:
+ custom:
+ - code: silver
+ name: Silver
+ channel: FASHION_WEB
+ position: 1
+ threshold: 1000
+ earning_multiplier: 1.25
+ color: '#c0c0c0'
+ benefits_description: 'A 25% points bonus on everything you buy.'
+
+ - code: gold
+ name: Gold
+ channel: FASHION_WEB
+ position: 2
+ threshold: 5000
+ earning_multiplier: 1.5
+ color: '#d4af37'
+ benefits_description: 'A 50% points bonus and access to member events.'
+
+ setono_sylius_loyalty_earning_rule:
+ options:
+ custom:
+ - name: 'Base rate: 1 point per 1.00'
+ channel: FASHION_WEB
+ amount_type: per_amount
+ amount_configuration:
+ points: 1
+ per_amount: 100
+
+ - name: 'Weekend double points (dry run)'
+ channel: FASHION_WEB
+ amount_type: multiplier
+ amount_configuration:
+ factor: 2
+ conditions:
+ - type: day_of_week
+ configuration:
+ days: [6, 7]
+ dry_run: true
+
+ - name: 'Registration bonus'
+ channel: FASHION_WEB
+ trigger: customer_registered
+ amount_type: fixed
+ amount_configuration:
+ points: 100
+
+ - name: 'Big-cart expression bonus (dry run)'
+ channel: FASHION_WEB
+ amount_type: expression
+ amount_configuration:
+ expression: 'basis > 50000 ? floor(basis / 50) : floor(basis / 100)'
+ dry_run: true
+
+ setono_sylius_loyalty_account:
+ options:
+ custom:
+ - email: loyalty@example.com
+ channel: FASHION_WEB
+ history:
+ - type: manual_credit
+ points: 2000
+ reason: goodwill
+ note: 'Fixture seed'
+ - type: earn_action
+ points: 300
+ source_identifier: 'fixture:expiring'
+ expires_at: '+10 days'
+ - type: manual_debit
+ points: 150
+ reason: correction
+ note: 'Fixture debit'
+
+ - email: fresh@example.com
+ channel: FASHION_WEB
+ history:
+ - type: manual_credit
+ points: 100
+ reason: goodwill
+ note: 'Below the redemption minimum'
+
+ # Dedicated to the shop dashboard e2e spec — no other spec may
+ # touch this account, so its history stays exact
+ - email: history@example.com
+ channel: FASHION_WEB
+ history:
+ - type: manual_credit
+ points: 2000
+ reason: goodwill
+ note: 'Fixture seed'
+ - type: earn_action
+ points: 300
+ source_identifier: 'fixture:history-expiring'
+ expires_at: '+10 days'
+ - type: manual_debit
+ points: 150
+ reason: correction
+ note: 'Fixture debit'
diff --git a/tests/Application/config/packages/sylius_order_override.yaml b/tests/Application/config/packages/sylius_order_override.yaml
new file mode 100644
index 0000000..9f43f61
--- /dev/null
+++ b/tests/Application/config/packages/sylius_order_override.yaml
@@ -0,0 +1,5 @@
+sylius_order:
+ resources:
+ order:
+ classes:
+ model: Setono\SyliusLoyaltyPlugin\Tests\Application\Entity\Order
diff --git a/tests/Application/public/vendor/codemirror/bundle.js b/tests/Application/public/vendor/codemirror/bundle.js
new file mode 100644
index 0000000..d4c6acb
--- /dev/null
+++ b/tests/Application/public/vendor/codemirror/bundle.js
@@ -0,0 +1,14 @@
+var Fd=Object.defineProperty;var Tn=(n,e)=>{for(var t in e)Fd(n,t,{get:e[t],enumerable:!0})};var Nd={};Tn(Nd,{EditorView:()=>A,basicSetup:()=>jb,minimalSetup:()=>Ub});var yr=[],Ia=[];(()=>{let n="lc,34,7n,7,7b,19,,,,2,,2,,,20,b,1c,l,g,,2t,7,2,6,2,2,,4,z,,u,r,2j,b,1m,9,9,,o,4,,9,,3,,5,17,3,3b,f,,w,1j,,,,4,8,4,,3,7,a,2,t,,1m,,,,2,4,8,,9,,a,2,q,,2,2,1l,,4,2,4,2,2,3,3,,u,2,3,,b,2,1l,,4,5,,2,4,,k,2,m,6,,,1m,,,2,,4,8,,7,3,a,2,u,,1n,,,,c,,9,,14,,3,,1l,3,5,3,,4,7,2,b,2,t,,1m,,2,,2,,3,,5,2,7,2,b,2,s,2,1l,2,,,2,4,8,,9,,a,2,t,,20,,4,,2,3,,,8,,29,,2,7,c,8,2q,,2,9,b,6,22,2,r,,,,,,1j,e,,5,,2,5,b,,10,9,,2u,4,,6,,2,2,2,p,2,4,3,g,4,d,,2,2,6,,f,,jj,3,qa,3,t,3,t,2,u,2,1s,2,,7,8,,2,b,9,,19,3,3b,2,y,,3a,3,4,2,9,,6,3,63,2,2,,1m,,,7,,,,,2,8,6,a,2,,1c,h,1r,4,1c,7,,,5,,14,9,c,2,w,4,2,2,,3,1k,,,2,3,,,3,1m,8,2,2,48,3,,d,,7,4,,6,,3,2,5i,1m,,5,ek,,5f,x,2da,3,3x,,2o,w,fe,6,2x,2,n9w,4,,a,w,2,28,2,7k,,3,,4,,p,2,5,,47,2,q,i,d,,12,8,p,b,1a,3,1c,,2,4,2,2,13,,1v,6,2,2,2,2,c,,8,,1b,,1f,,,3,2,2,5,2,,,16,2,8,,6m,,2,,4,,fn4,,kh,g,g,g,a6,2,gt,,6a,,45,5,1ae,3,,2,5,4,14,3,4,,4l,2,fx,4,ar,2,49,b,4w,,1i,f,1k,3,1d,4,2,2,1x,3,10,5,,8,1q,,c,2,1g,9,a,4,2,,2n,3,2,,,2,6,,4g,,3,8,l,2,1l,2,,,,,m,,e,7,3,5,5f,8,2,3,,,n,,29,,2,6,,,2,,,2,,2,6j,,2,4,6,2,,2,r,2,2d,8,2,,,2,2y,,,,2,6,,,2t,3,2,4,,5,77,9,,2,6t,,a,2,,,4,,40,4,2,2,4,,w,a,14,6,2,4,8,,9,6,2,3,1a,d,,2,ba,7,,6,,,2a,m,2,7,,2,,2,3e,6,3,,,2,,7,,,20,2,3,,,,9n,2,f0b,5,1n,7,t4,,1r,4,29,,f5k,2,43q,,,3,4,5,8,8,2,7,u,4,44,3,1iz,1j,4,1e,8,,e,,m,5,,f,11s,7,,h,2,7,,2,,5,79,7,c5,4,15s,7,31,7,240,5,gx7k,2o,3k,6o".split(",").map(e=>e?parseInt(e,36):1);for(let e=0,t=0;e>1;if(n=Ia[i])e=i+1;else return!0;if(e==t)return!1}}function Ea(n){return n>=127462&&n<=127487}var Ra=8205;function Na(n,e,t=!0,i=!0){return(t?Fa:Wd)(n,e,i)}function Fa(n,e,t){if(e==n.length)return e;e&&Ha(n.charCodeAt(e))&&Wa(n.charCodeAt(e-1))&&e--;let i=gr(n,e);for(e+=Pa(i);e=0&&Ea(gr(n,o));)r++,o-=2;if(r%2==0)break;e+=2}else break}return e}function Wd(n,e,t){for(;e>1;){let i=Fa(n,e-2,t);if(i=56320&&n<57344}function Wa(n){return n>=55296&&n<56320}function Pa(n){return n<65536?1:2}var F=class n{lineAt(e){if(e<0||e>this.length)throw new RangeError(`Invalid position ${e} in document of length ${this.length}`);return this.lineInner(e,!1,1,0)}line(e){if(e<1||e>this.lines)throw new RangeError(`Invalid line number ${e} in ${this.lines}-line document`);return this.lineInner(e,!0,1,0)}replace(e,t,i){[e,t]=ri(this,e,t);let s=[];return this.decompose(0,e,s,2),i.length&&i.decompose(0,i.length,s,3),this.decompose(t,this.length,s,1),ii.from(s,this.length-(t-e)+i.length)}append(e){return this.replace(this.length,this.length,e)}slice(e,t=this.length){[e,t]=ri(this,e,t);let i=[];return this.decompose(e,t,i,0),ii.from(i,t-e)}eq(e){if(e==this)return!0;if(e.length!=this.length||e.lines!=this.lines)return!1;let t=this.scanIdentical(e,1),i=this.length-this.scanIdentical(e,-1),s=new Pt(this),r=new Pt(e);for(let o=t,l=t;;){if(s.next(o),r.next(o),o=0,s.lineBreak!=r.lineBreak||s.done!=r.done||s.value!=r.value)return!1;if(l+=s.value.length,s.done||l>=i)return!0}}iter(e=1){return new Pt(this,e)}iterRange(e,t=this.length){return new En(this,e,t)}iterLines(e,t){let i;if(e==null)i=this.iter();else{t==null&&(t=this.lines+1);let s=this.line(e).from;i=this.iterRange(s,Math.max(s,t==this.lines+1?this.length:t<=1?0:this.line(t-1).to))}return new Rn(i)}toString(){return this.sliceString(0)}toJSON(){let e=[];return this.flatten(e),e}constructor(){}static of(e){if(e.length==0)throw new RangeError("A document must have at least one line");return e.length==1&&!e[0]?n.empty:e.length<=32?new Te(e):ii.from(Te.split(e,[]))}},Te=class n extends F{constructor(e,t=Vd(e)){super(),this.text=e,this.length=t}get lines(){return this.text.length}get children(){return null}lineInner(e,t,i,s){for(let r=0;;r++){let o=this.text[r],l=s+o.length;if((t?i:l)>=e)return new xr(s,l,i,o);s=l+1,i++}}decompose(e,t,i,s){let r=e<=0&&t>=this.length?this:new n(Va(this.text,e,t),Math.min(t,this.length)-Math.max(0,e));if(s&1){let o=i.pop(),l=Ln(r.text,o.text.slice(),0,r.length);if(l.length<=32)i.push(new n(l,o.length+r.length));else{let a=l.length>>1;i.push(new n(l.slice(0,a)),new n(l.slice(a)))}}else i.push(r)}replace(e,t,i){if(!(i instanceof n))return super.replace(e,t,i);[e,t]=ri(this,e,t);let s=Ln(this.text,Ln(i.text,Va(this.text,0,e)),t),r=this.length+i.length-(t-e);return s.length<=32?new n(s,r):ii.from(n.split(s,[]),r)}sliceString(e,t=this.length,i=`
+`){[e,t]=ri(this,e,t);let s="";for(let r=0,o=0;r<=t&&oe&&o&&(s+=i),er&&(s+=l.slice(Math.max(0,e-r),t-r)),r=a+1}return s}flatten(e){for(let t of this.text)e.push(t)}scanIdentical(){return 0}static split(e,t){let i=[],s=-1;for(let r of e)i.push(r),s+=r.length+1,i.length==32&&(t.push(new n(i,s)),i=[],s=-1);return s>-1&&t.push(new n(i,s)),t}},ii=class n extends F{constructor(e,t){super(),this.children=e,this.length=t,this.lines=0;for(let i of e)this.lines+=i.lines}lineInner(e,t,i,s){for(let r=0;;r++){let o=this.children[r],l=s+o.length,a=i+o.lines-1;if((t?a:l)>=e)return o.lineInner(e,t,i,s);s=l+1,i=a+1}}decompose(e,t,i,s){for(let r=0,o=0;o<=t&&r=o){let h=s&((o<=e?1:0)|(a>=t?2:0));o>=e&&a<=t&&!h?i.push(l):l.decompose(e-o,t-o,i,h)}o=a+1}}replace(e,t,i){if([e,t]=ri(this,e,t),i.lines=r&&t<=l){let a=o.replace(e-r,t-r,i),h=this.lines-o.lines+a.lines;if(a.lines>4&&a.lines>h>>6){let c=this.children.slice();return c[s]=a,new n(c,this.length-(t-e)+i.length)}return super.replace(r,l,a)}r=l+1}return super.replace(e,t,i)}sliceString(e,t=this.length,i=`
+`){[e,t]=ri(this,e,t);let s="";for(let r=0,o=0;re&&r&&(s+=i),eo&&(s+=l.sliceString(e-o,t-o,i)),o=a+1}return s}flatten(e){for(let t of this.children)t.flatten(e)}scanIdentical(e,t){if(!(e instanceof n))return 0;let i=0,[s,r,o,l]=t>0?[0,0,this.children.length,e.children.length]:[this.children.length-1,e.children.length-1,-1,-1];for(;;s+=t,r+=t){if(s==o||r==l)return i;let a=this.children[s],h=e.children[r];if(a!=h)return i+a.scanIdentical(h,t);i+=a.length+1}}static from(e,t=e.reduce((i,s)=>i+s.length+1,-1)){let i=0;for(let d of e)i+=d.lines;if(i<32){let d=[];for(let p of e)p.flatten(d);return new Te(d,t)}let s=Math.max(32,i>>5),r=s<<1,o=s>>1,l=[],a=0,h=-1,c=[];function f(d){let p;if(d.lines>r&&d instanceof n)for(let m of d.children)f(m);else d.lines>o&&(a>o||!a)?(u(),l.push(d)):d instanceof Te&&a&&(p=c[c.length-1])instanceof Te&&d.lines+p.lines<=32?(a+=d.lines,h+=d.length+1,c[c.length-1]=new Te(p.text.concat(d.text),p.length+1+d.length)):(a+d.lines>s&&u(),a+=d.lines,h+=d.length+1,c.push(d))}function u(){a!=0&&(l.push(c.length==1?c[0]:n.from(c,h)),h=-1,a=c.length=0)}for(let d of e)f(d);return u(),l.length==1?l[0]:new n(l,t)}};F.empty=new Te([""],0);function Vd(n){let e=-1;for(let t of n)e+=t.length+1;return e}function Ln(n,e,t=0,i=1e9){for(let s=0,r=0,o=!0;r=t&&(a>i&&(l=l.slice(0,i-s)),s0?1:(e instanceof Te?e.text.length:e.children.length)<<1]}nextInner(e,t){for(this.done=this.lineBreak=!1;;){let i=this.nodes.length-1,s=this.nodes[i],r=this.offsets[i],o=r>>1,l=s instanceof Te?s.text.length:s.children.length;if(o==(t>0?l:0)){if(i==0)return this.done=!0,this.value="",this;t>0&&this.offsets[i-1]++,this.nodes.pop(),this.offsets.pop()}else if((r&1)==(t>0?0:1)){if(this.offsets[i]+=t,e==0)return this.lineBreak=!0,this.value=`
+`,this;e--}else if(s instanceof Te){let a=s.text[o+(t<0?-1:0)];if(this.offsets[i]+=t,a.length>Math.max(0,e))return this.value=e==0?a:t>0?a.slice(e):a.slice(0,a.length-e),this;e-=a.length}else{let a=s.children[o+(t<0?-1:0)];e>a.length?(e-=a.length,this.offsets[i]+=t):(t<0&&this.offsets[i]--,this.nodes.push(a),this.offsets.push(t>0?1:(a instanceof Te?a.text.length:a.children.length)<<1))}}}next(e=0){return e<0&&(this.nextInner(-e,-this.dir),e=this.value.length),this.nextInner(e,this.dir)}},En=class{constructor(e,t,i){this.value="",this.done=!1,this.cursor=new Pt(e,t>i?-1:1),this.pos=t>i?e.length:0,this.from=Math.min(t,i),this.to=Math.max(t,i)}nextInner(e,t){if(t<0?this.pos<=this.from:this.pos>=this.to)return this.value="",this.done=!0,this;e+=Math.max(0,t<0?this.pos-this.to:this.from-this.pos);let i=t<0?this.pos-this.from:this.to-this.pos;e>i&&(e=i),i-=e;let{value:s}=this.cursor.next(e);return this.pos+=(s.length+e)*t,this.value=s.length<=i?s:t<0?s.slice(s.length-i):s.slice(0,i),this.done=!this.value,this}next(e=0){return e<0?e=Math.max(e,this.from-this.pos):e>0&&(e=Math.min(e,this.to-this.pos)),this.nextInner(e,this.cursor.dir)}get lineBreak(){return this.cursor.lineBreak&&this.value!=""}},Rn=class{constructor(e){this.inner=e,this.afterBreak=!0,this.value="",this.done=!1}next(e=0){let{done:t,lineBreak:i,value:s}=this.inner.next(e);return t&&this.afterBreak?(this.value="",this.afterBreak=!1):t?(this.done=!0,this.value=""):i?this.afterBreak?this.value="":(this.afterBreak=!0,this.next()):(this.value=s,this.afterBreak=!1),this}get lineBreak(){return!1}};typeof Symbol<"u"&&(F.prototype[Symbol.iterator]=function(){return this.iter()},Pt.prototype[Symbol.iterator]=En.prototype[Symbol.iterator]=Rn.prototype[Symbol.iterator]=function(){return this});var xr=class{constructor(e,t,i,s){this.from=e,this.to=t,this.number=i,this.text=s}get length(){return this.to-this.from}};function ri(n,e,t){return e=Math.max(0,Math.min(n.length,e)),[e,Math.max(e,Math.min(n.length,t))]}function te(n,e,t=!0,i=!0){return Na(n,e,t,i)}function zd(n){return n>=56320&&n<57344}function qd(n){return n>=55296&&n<56320}function he(n,e){let t=n.charCodeAt(e);if(!qd(t)||e+1==n.length)return t;let i=n.charCodeAt(e+1);return zd(i)?(t-55296<<10)+(i-56320)+65536:t}function Ii(n){return n<=65535?String.fromCharCode(n):(n-=65536,String.fromCharCode((n>>10)+55296,(n&1023)+56320))}function De(n){return n<65536?1:2}var wr=/\r\n?|\n/,se=(function(n){return n[n.Simple=0]="Simple",n[n.TrackDel=1]="TrackDel",n[n.TrackBefore=2]="TrackBefore",n[n.TrackAfter=3]="TrackAfter",n})(se||(se={})),rt=class n{constructor(e){this.sections=e}get length(){let e=0;for(let t=0;te)return r+(e-s);r+=l}else{if(i!=se.Simple&&h>=e&&(i==se.TrackDel&&se||i==se.TrackBefore&&se))return null;if(h>e||h==e&&t<0&&!l)return e==s||t<0?r:r+a;r+=a}s=h}if(e>s)throw new RangeError(`Position ${e} is out of range for changeset of length ${s}`);return r}touchesRange(e,t=e){for(let i=0,s=0;i=0&&s<=t&&l>=e)return st?"cover":!0;s=l}return!1}toString(){let e="";for(let t=0;t=0?":"+s:"")}return e}toJSON(){return this.sections}static fromJSON(e){if(!Array.isArray(e)||e.length%2||e.some(t=>typeof t!="number"))throw new RangeError("Invalid JSON representation of ChangeDesc");return new n(e)}static create(e){return new n(e)}},ye=class n extends rt{constructor(e,t){super(e),this.inserted=t}apply(e){if(this.length!=e.length)throw new RangeError("Applying change set to a document with the wrong length");return vr(this,(t,i,s,r,o)=>e=e.replace(s,s+(i-t),o),!1),e}mapDesc(e,t=!1){return kr(this,e,t,!0)}invert(e){let t=this.sections.slice(),i=[];for(let s=0,r=0;s=0){t[s]=l,t[s+1]=o;let a=s>>1;for(;i.length0&>(i,t,r.text),r.forward(c),l+=c}let h=e[o++];for(;l>1].toJSON()))}return e}static of(e,t,i){let s=[],r=[],o=0,l=null;function a(c=!1){if(!c&&!s.length)return;ou||f<0||u>t)throw new RangeError(`Invalid change range ${f} to ${u} (in doc of length ${t})`);let p=d?typeof d=="string"?F.of(d.split(i||wr)):d:F.empty,m=p.length;if(f==u&&m==0)return;fo&&de(s,f-o,-1),de(s,u-f,m),gt(r,s,p),o=u}}return h(e),a(!l),l}static empty(e){return new n(e?[e,-1]:[],[])}static fromJSON(e){if(!Array.isArray(e))throw new RangeError("Invalid JSON representation of ChangeSet");let t=[],i=[];for(let s=0;sl&&typeof o!="string"))throw new RangeError("Invalid JSON representation of ChangeSet");if(r.length==1)t.push(r[0],0);else{for(;i.length=0&&t<=0&&t==n[s+1]?n[s]+=e:s>=0&&e==0&&n[s]==0?n[s+1]+=t:i?(n[s]+=e,n[s+1]+=t):n.push(e,t)}function gt(n,e,t){if(t.length==0)return;let i=e.length-2>>1;if(i>1])),!(t||o==n.sections.length||n.sections[o+1]<0);)l=n.sections[o++],a=n.sections[o++];e(s,h,r,c,f),s=h,r=c}}}function kr(n,e,t,i=!1){let s=[],r=i?[]:null,o=new It(n),l=new It(e);for(let a=-1;;){if(o.done&&l.len||l.done&&o.len)throw new Error("Mismatched change set lengths");if(o.ins==-1&&l.ins==-1){let h=Math.min(o.len,l.len);de(s,h,-1),o.forward(h),l.forward(h)}else if(l.ins>=0&&(o.ins<0||a==o.i||o.off==0&&(l.len=0&&a=0){let h=0,c=o.len;for(;c;)if(l.ins==-1){let f=Math.min(c,l.len);h+=f,c-=f,l.forward(f)}else if(l.ins==0&&l.lena||o.ins>=0&&o.len>a)&&(l||i.length>h),r.forward2(a),o.forward(a)}}}}var It=class{constructor(e){this.set=e,this.i=0,this.next()}next(){let{sections:e}=this.set;this.i>1;return t>=e.length?F.empty:e[t]}textBit(e){let{inserted:t}=this.set,i=this.i-2>>1;return i>=t.length&&!e?F.empty:t[i].slice(this.off,e==null?void 0:this.off+e)}forward(e){e==this.len?this.next():(this.len-=e,this.off+=e)}forward2(e){this.ins==-1?this.forward(e):e==this.ins?this.next():(this.ins-=e,this.off+=e)}},Lt=class n{constructor(e,t,i,s){this.from=e,this.to=t,this.flags=i,this.goalColumn=s}get anchor(){return this.flags&32?this.to:this.from}get head(){return this.flags&32?this.from:this.to}get empty(){return this.from==this.to}get assoc(){return this.flags&8?-1:this.flags&16?1:0}get undirectional(){return(this.flags&64)>0}get bidiLevel(){let e=this.flags&7;return e==7?null:e}map(e,t=-1){let i,s;return this.empty?i=s=e.mapPos(this.from,t):(i=e.mapPos(this.from,1),s=e.mapPos(this.to,-1)),i==this.from&&s==this.to?this:new n(i,s,this.flags,this.goalColumn)}extend(e,t=e,i=0){if(e<=this.anchor&&t>=this.anchor)return b.range(e,t,void 0,void 0,i);let s=Math.abs(e-this.anchor)>Math.abs(t-this.anchor)?e:t;return b.range(this.anchor,s,void 0,void 0,i)}eq(e,t=!1){return this.anchor==e.anchor&&this.head==e.head&&this.goalColumn==e.goalColumn&&(!t||!this.empty||this.assoc==e.assoc)}toJSON(){return{anchor:this.anchor,head:this.head}}static fromJSON(e){if(!e||typeof e.anchor!="number"||typeof e.head!="number")throw new RangeError("Invalid JSON representation for SelectionRange");return b.range(e.anchor,e.head)}static create(e,t,i,s){return new n(e,t,i,s)}},b=class n{constructor(e,t){this.ranges=e,this.mainIndex=t}map(e,t=-1){return e.empty?this:n.create(this.ranges.map(i=>i.map(e,t)),this.mainIndex)}eq(e,t=!1){if(this.ranges.length!=e.ranges.length||this.mainIndex!=e.mainIndex)return!1;for(let i=0;ie.toJSON()),main:this.mainIndex}}static fromJSON(e){if(!e||!Array.isArray(e.ranges)||typeof e.main!="number"||e.main>=e.ranges.length)throw new RangeError("Invalid JSON representation for EditorSelection");return new n(e.ranges.map(t=>Lt.fromJSON(t)),e.main)}static single(e,t=e){return new n([n.range(e,t)],0)}static create(e,t=0){if(e.length==0)throw new RangeError("A selection needs at least one range");for(let i=0,s=0;ss.from-r.from),t=e.indexOf(i);for(let s=1;sr.head?n.range(a,l):n.range(l,a))}}return new n(e,t)}};function Ua(n,e){for(let t of n.ranges)if(t.to>e)throw new RangeError("Selection points outside of document")}var Er=0,C=class n{constructor(e,t,i,s,r){this.combine=e,this.compareInput=t,this.compare=i,this.isStatic=s,this.id=Er++,this.default=e([]),this.extensions=typeof r=="function"?r(this):r}get reader(){return this}static define(e={}){return new n(e.combine||(t=>t),e.compareInput||((t,i)=>t===i),e.compare||(e.combine?(t,i)=>t===i:Rr),!!e.static,e.enables)}of(e){return new ni([],this,0,e)}compute(e,t){if(this.isStatic)throw new Error("Can't compute a static facet");return new ni(e,this,1,t)}computeN(e,t){if(this.isStatic)throw new Error("Can't compute a static facet");return new ni(e,this,2,t)}from(e,t){return t||(t=i=>i),this.compute([e],i=>t(i.field(e)))}};function Rr(n,e){return n==e||n.length==e.length&&n.every((t,i)=>t===e[i])}var ni=class{constructor(e,t,i,s){this.dependencies=e,this.facet=t,this.type=i,this.value=s,this.id=Er++}dynamicSlot(e){var t;let i=this.value,s=this.facet.compareInput,r=this.id,o=e[r]>>1,l=this.type==2,a=!1,h=!1,c=[];for(let f of this.dependencies)f=="doc"?a=!0:f=="selection"?h=!0:(((t=e[f.id])!==null&&t!==void 0?t:1)&1)==0&&c.push(e[f.id]);return{create(f){return f.values[o]=i(f),1},update(f,u){if(a&&u.docChanged||h&&(u.docChanged||u.selection)||Sr(f,c)){let d=i(f);if(l?!za(d,f.values[o],s):!s(d,f.values[o]))return f.values[o]=d,1}return 0},reconfigure:(f,u)=>{let d,p=u.config.address[r];if(p!=null){let m=Fn(u,p);if(this.dependencies.every(g=>g instanceof C?u.facet(g)===f.facet(g):g instanceof J?u.field(g,!1)==f.field(g,!1):!0)||(l?za(d=i(f),m,s):s(d=i(f),m)))return f.values[o]=m,0}else d=i(f);return f.values[o]=d,1}}}get extension(){return this}};function za(n,e,t){if(n.length!=e.length)return!1;for(let i=0;in[a.id]),s=t.map(a=>a.type),r=i.filter(a=>!(a&1)),o=n[e.id]>>1;function l(a){let h=[];for(let c=0;ci===s),e);return e.provide&&(t.provides=e.provide(t)),t}create(e){let t=e.facet(Dn).find(i=>i.field==this);return(t?.create||this.createF)(e)}slot(e){let t=e[this.id]>>1;return{create:i=>(i.values[t]=this.create(i),1),update:(i,s)=>{let r=i.values[t],o=this.updateF(r,s);return this.compareF(r,o)?0:(i.values[t]=o,1)},reconfigure:(i,s)=>{let r=i.facet(Dn),o=s.facet(Dn),l;return(l=r.find(a=>a.field==this))&&l!=o.find(a=>a.field==this)?(i.values[t]=l.create(i),1):s.config.address[this.id]!=null?(i.values[t]=s.field(this),0):(i.values[t]=this.create(i),1)}}}init(e){return[this,Dn.of({field:this,create:e})]}get extension(){return this}},Et={lowest:4,low:3,default:2,high:1,highest:0};function Bi(n){return e=>new Pn(e,n)}var Oe={highest:Bi(Et.highest),high:Bi(Et.high),default:Bi(Et.default),low:Bi(Et.low),lowest:Bi(Et.lowest)},Pn=class{constructor(e,t){this.inner=e,this.prec=t}get extension(){return this}},In=class n{of(e){return new Ei(this,e)}reconfigure(e){return n.reconfigure.of({compartment:this,extension:e})}get(e){return e.config.compartments.get(this)}},Ei=class{constructor(e,t){this.compartment=e,this.inner=t}get extension(){return this}},Nn=class n{constructor(e,t,i,s,r,o){for(this.base=e,this.compartments=t,this.dynamicSlots=i,this.address=s,this.staticValues=r,this.facets=o,this.statusTemplate=[];this.statusTemplate.length>1]}static resolve(e,t,i){let s=[],r=Object.create(null),o=new Map;for(let u of $d(e,t,o))u instanceof J?s.push(u):(r[u.facet.id]||(r[u.facet.id]=[])).push(u);let l=Object.create(null),a=[],h=[];for(let u of s)l[u.id]=h.length<<1,h.push(d=>u.slot(d));let c=i?.config.facets;for(let u in r){let d=r[u],p=d[0].facet,m=c&&c[u]||[];if(d.every(g=>g.type==0))if(l[p.id]=a.length<<1|1,Rr(m,d))a.push(i.facet(p));else{let g=p.combine(d.map(y=>y.value));a.push(i&&p.compare(g,i.facet(p))?i.facet(p):g)}else{for(let g of d)g.type==0?(l[g.id]=a.length<<1|1,a.push(g.value)):(l[g.id]=h.length<<1,h.push(y=>g.dynamicSlot(y)));l[p.id]=h.length<<1,h.push(g=>Kd(g,p,d))}}let f=h.map(u=>u(l));return new n(e,o,f,l,a,r)}};function $d(n,e,t){let i=[[],[],[],[],[]],s=new Map;function r(o,l){let a=s.get(o);if(a!=null){if(a<=l)return;let h=i[a].indexOf(o);h>-1&&i[a].splice(h,1),o instanceof Ei&&t.delete(o.compartment)}if(s.set(o,l),Array.isArray(o))for(let h of o)r(h,l);else if(o instanceof Ei){if(t.has(o.compartment))throw new RangeError("Duplicate use of compartment in extensions");let h=e.get(o.compartment)||o.inner;t.set(o.compartment,h),r(h,l)}else if(o instanceof Pn)r(o.inner,o.prec);else if(o instanceof J)i[l].push(o),o.provides&&r(o.provides,l);else if(o instanceof ni)i[l].push(o),o.facet.extensions&&r(o.facet.extensions,Et.default);else{let h=o.extension;if(!h)throw new Error(`Unrecognized extension value in extension set (${o}).`);if(h==o)throw new Error(`Unrecognized extension value in extension set (${o}). This sometimes happens because multiple instances of @codemirror/state are loaded, breaking instanceof checks.`);r(h,l)}}return r(n,Et.default),i.reduce((o,l)=>o.concat(l))}function Li(n,e){if(e&1)return 2;let t=e>>1,i=n.status[t];if(i==4)throw new Error("Cyclic dependency between fields and/or facets");if(i&2)return i;n.status[t]=4;let s=n.computeSlot(n,n.config.dynamicSlots[t]);return n.status[t]=2|s}function Fn(n,e){return e&1?n.config.staticValues[e>>1]:n.values[e>>1]}var Ga=C.define(),Cr=C.define({combine:n=>n.some(e=>e),static:!0}),_a=C.define({combine:n=>n.length?n[0]:void 0,static:!0}),Ya=C.define(),Ja=C.define(),Xa=C.define(),Qa=C.define({combine:n=>n.length?n[0]:!1}),ke=class{constructor(e,t){this.type=e,this.value=t}static define(){return new Ar}},Ar=class{of(e){return new ke(this,e)}},Mr=class{constructor(e){this.map=e}of(e){return new L(this,e)}},L=class n{constructor(e,t){this.type=e,this.value=t}map(e){let t=this.type.map(this.value,e);return t===void 0?void 0:t==this.value?this:new n(this.type,t)}is(e){return this.type==e}static define(e={}){return new Mr(e.map||(t=>t))}static mapEffects(e,t){if(!e.length)return e;let i=[];for(let s of e){let r=s.map(t);r&&i.push(r)}return i}};L.reconfigure=L.define();L.appendConfig=L.define();var ie=class n{constructor(e,t,i,s,r,o){this.startState=e,this.changes=t,this.selection=i,this.effects=s,this.annotations=r,this.scrollIntoView=o,this._doc=null,this._state=null,i&&Ua(i,t.newLength),r.some(l=>l.type==n.time)||(this.annotations=r.concat(n.time.of(Date.now())))}static create(e,t,i,s,r,o){return new n(e,t,i,s,r,o)}get newDoc(){return this._doc||(this._doc=this.changes.apply(this.startState.doc))}get newSelection(){return this.selection||this.startState.selection.map(this.changes)}get state(){return this._state||this.startState.applyTransaction(this),this._state}annotation(e){for(let t of this.annotations)if(t.type==e)return t.value}get docChanged(){return!this.changes.empty}get reconfigured(){return this.startState.config!=this.state.config}isUserEvent(e){let t=this.annotation(n.userEvent);return!!(t&&(t==e||t.length>e.length&&t.slice(0,e.length)==e&&t[e.length]=="."))}};ie.time=ke.define();ie.userEvent=ke.define();ie.addToHistory=ke.define();ie.remote=ke.define();function jd(n,e){let t=[];for(let i=0,s=0;;){let r,o;if(i=n[i]))r=n[i++],o=n[i++];else if(s=0;s--){let r=i[s](n);r instanceof ie?n=r:Array.isArray(r)&&r.length==1&&r[0]instanceof ie?n=r[0]:n=eh(e,si(r),!1)}return n}function Gd(n){let e=n.startState,t=e.facet(Xa),i=n;for(let s=t.length-1;s>=0;s--){let r=t[s](n);r&&Object.keys(r).length&&(i=Za(i,Tr(e,r,n.changes.newLength),!0))}return i==n?n:ie.create(e,n.changes,n.selection,i.effects,i.annotations,i.scrollIntoView)}var _d=[];function si(n){return n==null?_d:Array.isArray(n)?n:[n]}var K=(function(n){return n[n.Word=0]="Word",n[n.Space=1]="Space",n[n.Other=2]="Other",n})(K||(K={})),Yd=/[\u00df\u0587\u0590-\u05f4\u0600-\u06ff\u3040-\u309f\u30a0-\u30ff\u3400-\u4db5\u4e00-\u9fcc\uac00-\ud7af]/,Dr;try{Dr=new RegExp("[\\p{Alphabetic}\\p{Number}_]","u")}catch{}function Jd(n){if(Dr)return Dr.test(n);for(let e=0;e"\x80"&&(t.toUpperCase()!=t.toLowerCase()||Yd.test(t)))return!0}return!1}function Xd(n){return e=>{if(!/\S/.test(e))return K.Space;if(Jd(e))return K.Word;for(let t=0;t-1)return K.Word;return K.Other}}var j=class n{constructor(e,t,i,s,r,o){this.config=e,this.doc=t,this.selection=i,this.values=s,this.status=e.statusTemplate.slice(),this.computeSlot=r,o&&(o._state=this);for(let l=0;ls.set(h,a)),t=null),s.set(l.value.compartment,l.value.extension)):l.is(L.reconfigure)?(t=null,i=l.value):l.is(L.appendConfig)&&(t=null,i=si(i).concat(l.value));let r;t?r=e.startState.values.slice():(t=Nn.resolve(i,s,this),r=new n(t,this.doc,this.selection,t.dynamicSlots.map(()=>null),(a,h)=>h.reconfigure(a,this),null).values);let o=e.startState.facet(Cr)?e.newSelection:e.newSelection.asSingle();new n(t,e.newDoc,o,r,(l,a)=>a.update(l,e),e)}replaceSelection(e){return typeof e=="string"&&(e=this.toText(e)),this.changeByRange(t=>({changes:{from:t.from,to:t.to,insert:e},range:b.cursor(t.from+e.length)}))}changeByRange(e){let t=this.selection,i=e(t.ranges[0]),s=this.changes(i.changes),r=[i.range],o=si(i.effects);for(let l=1;lo.spec.fromJSON(l,a)))}}return n.create({doc:e.doc,selection:b.fromJSON(e.selection),extensions:t.extensions?s.concat([t.extensions]):s})}static create(e={}){let t=Nn.resolve(e.extensions||[],new Map),i=e.doc instanceof F?e.doc:F.of((e.doc||"").split(t.staticFacet(n.lineSeparator)||wr)),s=e.selection?e.selection instanceof b?e.selection:b.single(e.selection.anchor,e.selection.head):b.single(0);return Ua(s,i.length),t.staticFacet(Cr)||(s=s.asSingle()),new n(t,i,s,t.dynamicSlots.map(()=>null),(r,o)=>o.create(r),null)}get tabSize(){return this.facet(n.tabSize)}get lineBreak(){return this.facet(n.lineSeparator)||`
+`}get readOnly(){return this.facet(Qa)}phrase(e,...t){for(let i of this.facet(n.phrases))if(Object.prototype.hasOwnProperty.call(i,e)){e=i[e];break}return t.length&&(e=e.replace(/\$(\$|\d*)/g,(i,s)=>{if(s=="$")return"$";let r=+(s||1);return!r||r>t.length?i:t[r-1]})),e}languageDataAt(e,t,i=-1){let s=[];for(let r of this.facet(Ga))for(let o of r(this,t,i))Object.prototype.hasOwnProperty.call(o,e)&&s.push(o[e]);return s}charCategorizer(e){let t=this.languageDataAt("wordChars",e);return Xd(t.length?t[0]:"")}wordAt(e){let{text:t,from:i,length:s}=this.doc.lineAt(e),r=this.charCategorizer(e),o=e-i,l=e-i;for(;o>0;){let a=te(t,o,!1);if(r(t.slice(a,o))!=K.Word)break;o=a}for(;ln.length?n[0]:4});j.lineSeparator=_a;j.readOnly=Qa;j.phrases=C.define({compare(n,e){let t=Object.keys(n),i=Object.keys(e);return t.length==i.length&&t.every(s=>n[s]==e[s])}});j.languageData=Ga;j.changeFilter=Ya;j.transactionFilter=Ja;j.transactionExtender=Xa;In.reconfigure=L.define();function ce(n,e,t={}){let i={};for(let s of n)for(let r of Object.keys(s)){let o=s[r],l=i[r];if(l===void 0)i[r]=o;else if(!(l===o||o===void 0))if(Object.hasOwnProperty.call(t,r))i[r]=t[r](l,o);else throw new Error("Config merge conflict for field "+r)}for(let s in e)i[s]===void 0&&(i[s]=e[s]);return i}var Pe=class{eq(e){return this==e}range(e,t=e){return Ri.create(e,t,this)}};Pe.prototype.startSide=Pe.prototype.endSide=0;Pe.prototype.point=!1;Pe.prototype.mapMode=se.TrackDel;function Pr(n,e){return n==e||n.constructor==e.constructor&&n.eq(e)}var Ri=class n{constructor(e,t,i){this.from=e,this.to=t,this.value=i}static create(e,t,i){return new n(e,t,i)}};function Or(n,e){return n.from-e.from||n.value.startSide-e.value.startSide}var Br=class n{constructor(e,t,i,s){this.from=e,this.to=t,this.value=i,this.maxPoint=s}get length(){return this.to[this.to.length-1]}findIndex(e,t,i,s=0){let r=i?this.to:this.from;for(let o=s,l=r.length;;){if(o==l)return o;let a=o+l>>1,h=r[a]-e||(i?this.value[a].endSide:this.value[a].startSide)-t;if(a==o)return h>=0?o:l;h>=0?l=a:o=a+1}}between(e,t,i,s){for(let r=this.findIndex(t,-1e9,!0),o=this.findIndex(i,1e9,!1,r);rd||u==d&&h.startSide>0&&h.endSide<=0)continue;(d-u||h.endSide-h.startSide)<0||(o<0&&(o=u),h.point&&(l=Math.max(l,d-u)),i.push(h),s.push(u-o),r.push(d-o))}return{mapped:i.length?new n(s,r,i,l):null,pos:o}}},I=class n{constructor(e,t,i,s){this.chunkPos=e,this.chunk=t,this.nextLayer=i,this.maxPoint=s}static create(e,t,i,s){return new n(e,t,i,s)}get length(){let e=this.chunk.length-1;return e<0?0:Math.max(this.chunkEnd(e),this.nextLayer.length)}get size(){if(this.isEmpty)return 0;let e=this.nextLayer.size;for(let t of this.chunk)e+=t.value.length;return e}chunkEnd(e){return this.chunkPos[e]+this.chunk[e].length}update(e){let{add:t=[],sort:i=!1,filterFrom:s=0,filterTo:r=this.length}=e,o=e.filter;if(t.length==0&&!o)return this;if(i&&(t=t.slice().sort(Or)),this.isEmpty)return t.length?n.of(t):this;let l=new Hn(this,null,-1).goto(0),a=0,h=[],c=new Se;for(;l.value||a=0){let f=t[a++];c.addInner(f.from,f.to,f.value)||h.push(f)}else l.rangeIndex==1&&l.chunkIndexthis.chunkEnd(l.chunkIndex)||rl.to||r=r&&e<=r+o.length&&o.between(r,e-r,t-r,i)===!1)return}this.nextLayer.between(e,t,i)}}iter(e=0){return Pi.from([this]).goto(e)}get isEmpty(){return this.nextLayer==this}static iter(e,t=0){return Pi.from(e).goto(t)}static compare(e,t,i,s,r=-1){let o=e.filter(f=>f.maxPoint>0||!f.isEmpty&&f.maxPoint>=r),l=t.filter(f=>f.maxPoint>0||!f.isEmpty&&f.maxPoint>=r),a=qa(o,l,i),h=new Rt(o,a,r),c=new Rt(l,a,r);i.iterGaps((f,u,d)=>Ka(h,f,c,u,d,s)),i.empty&&i.length==0&&Ka(h,0,c,0,0,s)}static eq(e,t,i=0,s){s==null&&(s=999999999);let r=e.filter(c=>!c.isEmpty&&t.indexOf(c)<0),o=t.filter(c=>!c.isEmpty&&e.indexOf(c)<0);if(r.length!=o.length)return!1;if(!r.length)return!0;let l=qa(r,o),a=new Rt(r,l,0).goto(i),h=new Rt(o,l,0).goto(i);for(;;){if(a.to!=h.to||!Lr(a.active,h.active)||a.point&&(!h.point||!Pr(a.point,h.point)))return!1;if(a.to>s)return!0;a.next(),h.next()}}static spans(e,t,i,s,r=-1){let o=new Rt(e,null,r).goto(t),l=t,a=o.openStart;for(;;){let h=Math.min(o.to,i);if(o.point){let c=o.activeForPoint(o.to),f=o.pointFroml&&(s.span(l,h,o.active,a),a=o.openEnd(h));if(o.to>i)return a+(o.point&&o.to>i?1:0);l=o.to,o.next()}}static of(e,t=!1){let i=new Se;for(let s of e instanceof Ri?[e]:t?Qd(e):e)i.add(s.from,s.to,s.value);return i.finish()}static join(e){if(!e.length)return n.empty;let t=e[e.length-1];for(let i=e.length-2;i>=0;i--)for(let s=e[i];s!=n.empty;s=s.nextLayer)t=new n(s.chunkPos,s.chunk,t,Math.max(s.maxPoint,t.maxPoint));return t}};I.empty=new I([],[],null,-1);function Qd(n){if(n.length>1)for(let e=n[0],t=1;t0)return n.slice().sort(Or);e=i}return n}I.empty.nextLayer=I.empty;var Se=class n{finishChunk(e){this.chunks.push(new Br(this.from,this.to,this.value,this.maxPoint)),this.chunkPos.push(this.chunkStart),this.chunkStart=-1,this.setMaxPoint=Math.max(this.setMaxPoint,this.maxPoint),this.maxPoint=-1,e&&(this.from=[],this.to=[],this.value=[])}constructor(){this.chunks=[],this.chunkPos=[],this.chunkStart=-1,this.last=null,this.lastFrom=-1e9,this.lastTo=-1e9,this.from=[],this.to=[],this.value=[],this.maxPoint=-1,this.setMaxPoint=-1,this.nextLayer=null}add(e,t,i){this.addInner(e,t,i)||(this.nextLayer||(this.nextLayer=new n)).add(e,t,i)}addInner(e,t,i){let s=e-this.lastTo||i.startSide-this.last.endSide;if(s<=0&&(e-this.lastFrom||i.startSide-this.last.startSide)<0)throw new Error("Ranges must be added sorted by `from` position and `startSide`");return s<0?!1:(this.from.length==250&&this.finishChunk(!0),this.chunkStart<0&&(this.chunkStart=e),this.from.push(e-this.chunkStart),this.to.push(t-this.chunkStart),this.last=i,this.lastFrom=e,this.lastTo=t,this.value.push(i),i.point&&(this.maxPoint=Math.max(this.maxPoint,t-e)),!0)}addChunk(e,t){if((e-this.lastTo||t.value[0].startSide-this.last.endSide)<0)return!1;this.from.length&&this.finishChunk(!0),this.setMaxPoint=Math.max(this.setMaxPoint,t.maxPoint),this.chunks.push(t),this.chunkPos.push(e);let i=t.value.length-1;return this.last=t.value[i],this.lastFrom=t.from[i]+e,this.lastTo=t.to[i]+e,!0}finish(){return this.finishInner(I.empty)}finishInner(e){if(this.from.length&&this.finishChunk(!1),this.chunks.length==0)return e;let t=I.create(this.chunkPos,this.chunks,this.nextLayer?this.nextLayer.finishInner(e):e,this.setMaxPoint);return this.from=null,t}};function qa(n,e,t){let i=new Map;for(let r of n)for(let o=0;o=this.minPoint)break}}setRangeIndex(e){if(e==this.layer.chunk[this.chunkIndex].value.length){if(this.chunkIndex++,this.skip)for(;this.chunkIndex=i&&s.push(new Hn(o,t,i,r));return s.length==1?s[0]:new n(s)}get startSide(){return this.value?this.value.startSide:0}goto(e,t=-1e9){for(let i of this.heap)i.goto(e,t);for(let i=this.heap.length>>1;i>=0;i--)br(this.heap,i);return this.next(),this}forward(e,t){for(let i of this.heap)i.forward(e,t);for(let i=this.heap.length>>1;i>=0;i--)br(this.heap,i);(this.to-e||this.value.endSide-t)<0&&this.next()}next(){if(this.heap.length==0)this.from=this.to=1e9,this.value=null,this.rank=-1;else{let e=this.heap[0];this.from=e.from,this.to=e.to,this.value=e.value,this.rank=e.rank,e.value&&e.next(),br(this.heap,0)}}};function br(n,e){for(let t=n[e];;){let i=(e<<1)+1;if(i>=n.length)break;let s=n[i];if(i+1=0&&(s=n[i+1],i++),t.compare(s)<0)break;n[i]=t,n[e]=s,e=i}}var Rt=class{constructor(e,t,i){this.minPoint=i,this.active=[],this.activeTo=[],this.activeRank=[],this.minActive=-1,this.point=null,this.pointFrom=0,this.pointRank=0,this.to=-1e9,this.endSide=0,this.openStart=-1,this.cursor=Pi.from(e,t,i)}goto(e,t=-1e9){return this.cursor.goto(e,t),this.active.length=this.activeTo.length=this.activeRank.length=0,this.minActive=-1,this.to=e,this.endSide=t,this.openStart=-1,this.next(),this}forward(e,t){for(;this.minActive>-1&&(this.activeTo[this.minActive]-e||this.active[this.minActive].endSide-t)<0;)this.removeActive(this.minActive);this.cursor.forward(e,t)}removeActive(e){On(this.active,e),On(this.activeTo,e),On(this.activeRank,e),this.minActive=$a(this.active,this.activeTo)}addActive(e){let t=0,{value:i,to:s,rank:r}=this.cursor;for(;t0;)t++;Bn(this.active,t,i),Bn(this.activeTo,t,s),Bn(this.activeRank,t,r),e&&Bn(e,t,this.cursor.from),this.minActive=$a(this.active,this.activeTo)}next(){let e=this.to,t=this.point;this.point=null;let i=this.openStart<0?[]:null;for(;;){let s=this.minActive;if(s>-1&&(this.activeTo[s]-this.cursor.from||this.active[s].endSide-this.cursor.startSide)<0){if(this.activeTo[s]>e){this.to=this.activeTo[s],this.endSide=this.active[s].endSide;break}this.removeActive(s),i&&On(i,s)}else if(this.cursor.value)if(this.cursor.from>e){this.to=this.cursor.from,this.endSide=this.cursor.startSide;break}else{let r=this.cursor.value;if(!r.point)this.addActive(i),this.cursor.next();else if(t&&this.cursor.to==this.to&&this.cursor.from=0&&i[s]=0&&!(this.activeRank[i]e||this.activeTo[i]==e&&this.active[i].endSide>=this.point.endSide)&&t.push(this.active[i]);return t.reverse()}openEnd(e){let t=0;for(let i=this.activeTo.length-1;i>=0&&this.activeTo[i]>e;i--)t++;return t}};function Ka(n,e,t,i,s,r){n.goto(e),t.goto(i);let o=i+s,l=i,a=i-e,h=!!r.boundChange;for(let c=!1;;){let f=n.to+a-t.to,u=f||n.endSide-t.endSide,d=u<0?n.to+a:t.to,p=Math.min(d,o);if(n.point||t.point?(n.point&&t.point&&Pr(n.point,t.point)&&Lr(n.activeForPoint(n.to),t.activeForPoint(t.to))||r.comparePoint(l,p,n.point,t.point),c=!1):(c&&r.boundChange(l),p>l&&!Lr(n.active,t.active)&&r.compareRange(l,p,n.active,t.active),h&&po)break;l=d,u<=0&&n.next(),u>=0&&t.next()}}function Lr(n,e){if(n.length!=e.length)return!1;for(let t=0;t=e;i--)n[i+1]=n[i];n[e]=t}function $a(n,e){let t=-1,i=1e9;for(let s=0;s=e)return s;if(s==n.length)break;r+=n.charCodeAt(s)==9?t-r%t:1,s=te(n,s)}return i===!0?-1:n.length}var th=typeof Symbol>"u"?"__\u037C":Symbol.for("\u037C"),Ir=typeof Symbol>"u"?"__styleSet"+Math.floor(Math.random()*1e8):Symbol("styleSet"),ih=typeof globalThis<"u"?globalThis:typeof window<"u"?window:{},Ie=class{constructor(e,t){this.rules=[];let{finish:i}=t||{};function s(o){return/^@/.test(o)?[o]:o.split(/,\s*/)}function r(o,l,a,h){let c=[],f=/^@(\w+)\b/.exec(o[0]),u=f&&f[1]=="keyframes";if(f&&l==null)return a.push(o[0]+";");for(let d in l){let p=l[d];if(/&/.test(d))r(d.split(/,\s*/).map(m=>o.map(g=>m.replace(/&/,g))).reduce((m,g)=>m.concat(g)),p,a);else if(p&&typeof p=="object"){if(!f)throw new RangeError("The value of a property ("+d+") should be a primitive value.");r(s(d),p,c,u)}else p!=null&&c.push(d.replace(/_.*/,"").replace(/[A-Z]/g,m=>"-"+m.toLowerCase())+": "+p+";")}(c.length||u)&&a.push((i&&!f&&!h?o.map(i):o).join(", ")+" {"+c.join(" ")+"}")}for(let o in e)r(s(o),e[o],this.rules)}getRules(){return this.rules.join(`
+`)}static newName(){let e=ih[th]||1;return ih[th]=e+1,"\u037C"+e.toString(36)}static mount(e,t,i){let s=e[Ir],r=i&&i.nonce;s?r&&s.setNonce(r):s=new Nr(e,r),s.mount(Array.isArray(t)?t:[t],e)}},nh=new Map,Nr=class{constructor(e,t){let i=e.ownerDocument||e,s=i.defaultView;if(!e.head&&e.adoptedStyleSheets&&s.CSSStyleSheet){let r=nh.get(i);if(r)return e[Ir]=r;this.sheet=new s.CSSStyleSheet,nh.set(i,this)}else this.styleTag=i.createElement("style"),t&&this.styleTag.setAttribute("nonce",t);this.modules=[],e[Ir]=this}mount(e,t){let i=this.sheet,s=0,r=0;for(let o=0;o-1&&(this.modules.splice(a,1),r--,a=-1),a==-1){if(this.modules.splice(r++,0,l),i)for(let h=0;h",191:"?",192:"~",219:"{",220:"|",221:"}",222:'"'},Zd=typeof navigator<"u"&&/Mac/.test(navigator.platform),ep=typeof navigator<"u"&&/MSIE \d|Trident\/(?:[7-9]|\d{2,})\..*rv:(\d+)/.exec(navigator.userAgent);for(ne=0;ne<10;ne++)lt[48+ne]=lt[96+ne]=String(ne);var ne;for(ne=1;ne<=24;ne++)lt[ne+111]="F"+ne;var ne;for(ne=65;ne<=90;ne++)lt[ne]=String.fromCharCode(ne+32),oi[ne]=String.fromCharCode(ne);var ne;for(Vn in lt)oi.hasOwnProperty(Vn)||(oi[Vn]=lt[Vn]);var Vn;function sh(n){var e=Zd&&n.metaKey&&n.shiftKey&&!n.ctrlKey&&!n.altKey||ep&&n.shiftKey&&n.key&&n.key.length==1||n.key=="Unidentified",t=!e&&n.key||(n.shiftKey?oi:lt)[n.keyCode]||n.key||"Unidentified";return t=="Esc"&&(t="Escape"),t=="Del"&&(t="Delete"),t=="Left"&&(t="ArrowLeft"),t=="Up"&&(t="ArrowUp"),t=="Right"&&(t="ArrowRight"),t=="Down"&&(t="ArrowDown"),t}function W(){var n=arguments[0];typeof n=="string"&&(n=document.createElement(n));var e=1,t=arguments[1];if(t&&typeof t=="object"&&t.nodeType==null&&!Array.isArray(t)){for(var i in t)if(Object.prototype.hasOwnProperty.call(t,i)){var s=t[i];typeof s=="string"?n.setAttribute(i,s):s!=null&&(n[i]=s)}e++}for(;e2),D={mac:ah||/Mac/.test(be.platform),windows:/Win/.test(be.platform),linux:/Linux|X11/.test(be.platform),ie:xs,ie_version:$h?Ur.documentMode||6:_r?+_r[1]:Gr?+Gr[1]:0,gecko:oh,gecko_version:oh?+(/Firefox\/(\d+)/.exec(be.userAgent)||[0,0])[1]:0,chrome:!!Fr,chrome_version:Fr?+Fr[1]:0,ios:ah,android:/Android\b/.test(be.userAgent),webkit:lh,webkit_version:lh?+(/\bAppleWebKit\/(\d+)/.exec(be.userAgent)||[0,0])[1]:0,safari:Yr,safari_version:Yr?+(/\bVersion\/(\d+(\.\d+)?)/.exec(be.userAgent)||[0,0])[1]:0,tabSize:Ur.documentElement.style.tabSize!=null?"tab-size":"-moz-tab-size"};function qo(n,e){for(let t in n)t=="class"&&e.class?e.class+=" "+n.class:t=="style"&&e.style?e.style+=";"+n.style:e[t]=n[t];return e}var ts=Object.create(null);function Ko(n,e,t){if(n==e)return!0;n||(n=ts),e||(e=ts);let i=Object.keys(n),s=Object.keys(e);if(i.length-(t&&i.indexOf(t)>-1?1:0)!=s.length-(t&&s.indexOf(t)>-1?1:0))return!1;for(let r of i)if(r!=t&&(s.indexOf(r)==-1||n[r]!==e[r]))return!1;return!0}function tp(n,e){for(let t=n.attributes.length-1;t>=0;t--){let i=n.attributes[t].name;e[i]==null&&n.removeAttribute(i)}for(let t in e){let i=e[t];t=="style"?n.style.cssText=i:n.getAttribute(t)!=i&&n.setAttribute(t,i)}}function hh(n,e,t){let i=!1;if(e)for(let s in e)t&&s in t||(i=!0,s=="style"?n.style.cssText="":n.removeAttribute(s));if(t)for(let s in t)e&&e[s]==t[s]||(i=!0,s=="style"?n.style.cssText=t[s]:n.setAttribute(s,t[s]));return i}function ip(n){let e=Object.create(null);for(let t=0;t0?3e8:-4e8:t>0?1e8:-1e8,new Wt(e,t,t,i,e.widget||null,!1)}static replace(e){let t=!!e.block,i,s;if(e.isBlockGap)i=-5e8,s=4e8;else{let{start:r,end:o}=jh(e,t);i=(r?t?-3e8:-1:5e8)-1,s=(o?t?2e8:1:-6e8)+1}return new Wt(e,i,s,t,e.widget||null,!0)}static line(e){return new Yi(e)}static set(e,t=!1){return I.of(e,t)}hasHeight(){return this.widget?this.widget.estimatedHeight>-1:!1}};B.none=I.empty;var _i=class n extends B{constructor(e){let{start:t,end:i}=jh(e);super(t?-1:5e8,i?1:-6e8,null,e),this.tagName=e.tagName||"span",this.attrs=e.class&&e.attributes?qo(e.attributes,{class:e.class}):e.class?{class:e.class}:e.attributes||ts}eq(e){return this==e||e instanceof n&&this.tagName==e.tagName&&Ko(this.attrs,e.attrs)}range(e,t=e){if(e>=t)throw new RangeError("Mark decorations may not be empty");return super.range(e,t)}};_i.prototype.point=!1;var Yi=class n extends B{constructor(e){super(-2e8,-2e8,null,e)}eq(e){return e instanceof n&&this.spec.class==e.spec.class&&Ko(this.spec.attributes,e.spec.attributes)}range(e,t=e){if(t!=e)throw new RangeError("Line decoration ranges must be zero-length");return super.range(e,t)}};Yi.prototype.mapMode=se.TrackBefore;Yi.prototype.point=!0;var Wt=class n extends B{constructor(e,t,i,s,r,o){super(t,i,r,e),this.block=s,this.isReplace=o,this.mapMode=s?t<=0?se.TrackBefore:se.TrackAfter:se.TrackDel}get type(){return this.startSide!=this.endSide?fe.WidgetRange:this.startSide<=0?fe.WidgetBefore:fe.WidgetAfter}get heightRelevant(){return this.block||!!this.widget&&(this.widget.estimatedHeight>=5||this.widget.lineBreaks>0)}eq(e){return e instanceof n&&np(this.widget,e.widget)&&this.block==e.block&&this.startSide==e.startSide&&this.endSide==e.endSide}range(e,t=e){if(this.isReplace&&(e>t||e==t&&this.startSide>0&&this.endSide<=0))throw new RangeError("Invalid range for replacement decoration");if(!this.isReplace&&t!=e)throw new RangeError("Widget decorations can only have zero-length ranges");return super.range(e,t)}};Wt.prototype.point=!0;function jh(n,e=!1){let{inclusiveStart:t,inclusiveEnd:i}=n;return t==null&&(t=n.inclusive),i==null&&(i=n.inclusive),{start:t??e,end:i??e}}function np(n,e){return n==e||!!(n&&e&&n.compare(e))}function ui(n,e,t,i=0){let s=t.length-1;s>=0&&t[s]+i>=n?t[s]=Math.max(t[s],e):t.push(n,e)}var is=class n extends Pe{constructor(e,t,i){super(),this.tagName=e,this.attributes=t,this.rank=i}eq(e){return e==this||e instanceof n&&this.tagName==e.tagName&&Ko(this.attributes,e.attributes)}static create(e){return new n(e.tagName,e.attributes||ts,e.rank==null?50:Math.max(0,Math.min(e.rank,100)))}static set(e,t=!1){return I.of(e,t)}};is.prototype.startSide=is.prototype.endSide=-1;function Ji(n){let e;return n.nodeType==11?e=n.getSelection?n:n.ownerDocument:e=n,e.getSelection()}function Jr(n,e){return e?n==e||n.contains(e.nodeType!=1?e.parentNode:e):!1}function Wi(n,e){if(!e.anchorNode)return!1;try{return Jr(n,e.anchorNode)}catch{return!1}}function Jn(n){return n.nodeType==3?Xi(n,0,n.nodeValue.length).getClientRects():n.nodeType==1?n.getClientRects():[]}function Vi(n,e,t,i){return t?ch(n,e,t,i,-1)||ch(n,e,t,i,1):!1}function xt(n){for(var e=0;;e++)if(n=n.previousSibling,!n)return e}function ns(n){return n.nodeType==1&&/^(DIV|P|LI|UL|OL|BLOCKQUOTE|DD|DT|H\d|SECTION|PRE)$/.test(n.nodeName)}function ch(n,e,t,i,s){for(;;){if(n==t&&e==i)return!0;if(e==(s<0?0:ct(n))){if(n.nodeName=="DIV")return!1;let r=n.parentNode;if(!r||r.nodeType!=1)return!1;e=xt(n)+(s<0?0:1),n=r}else if(n.nodeType==1){if(n=n.childNodes[e+(s<0?-1:0)],n.nodeType==1&&n.contentEditable=="false")return!1;e=s<0?ct(n):0}else return!1}}function ct(n){return n.nodeType==3?n.nodeValue.length:n.childNodes.length}function ss(n,e){let{left:t,right:i}=n;if(t==i)return n;let s=e?t:i;return{left:s,right:s,top:n.top,bottom:n.bottom}}function sp(n){let e=n.visualViewport;return e?{left:0,right:e.width,top:0,bottom:e.height}:{left:0,right:n.innerWidth,top:0,bottom:n.innerHeight}}function Uh(n,e){let t=e.width/n.offsetWidth,i=e.height/n.offsetHeight;return(t>.995&&t<1.005||!isFinite(t)||Math.abs(e.width-n.offsetWidth)<1)&&(t=1),(i>.995&&i<1.005||!isFinite(i)||Math.abs(e.height-n.offsetHeight)<1)&&(i=1),{scaleX:t,scaleY:i}}function rp(n,e,t,i,s,r,o,l){let a=n.ownerDocument,h=a.defaultView||window;for(let c=n,f=!1;c&&!f;)if(c.nodeType==1){let u,d=c==a.body,p=1,m=1;if(d)u=sp(h);else{if(/^(fixed|sticky)$/.test(getComputedStyle(c).position)&&(f=!0),c.scrollHeight<=c.clientHeight&&c.scrollWidth<=c.clientWidth){c=c.assignedSlot||c.parentNode;continue}let x=c.getBoundingClientRect();({scaleX:p,scaleY:m}=Uh(c,x)),u={left:x.left,right:x.left+c.clientWidth*p,top:x.top,bottom:x.top+c.clientHeight*m}}let g=0,y=0;if(s=="nearest")e.top0&&e.bottom>u.bottom+y&&(y=e.bottom-u.bottom+o)):e.bottom>u.bottom-o&&(y=e.bottom-u.bottom+o,t<0&&e.top-y0&&e.right>u.right+g&&(g=e.right-u.right+r)):e.right>u.right-r&&(g=e.right-u.right+r,t<0&&e.leftu.bottom||e.leftu.right)&&(e={left:Math.max(e.left,u.left),right:Math.min(e.right,u.right),top:Math.max(e.top,u.top),bottom:Math.min(e.bottom,u.bottom)}),c=c.assignedSlot||c.parentNode}else if(c.nodeType==11)c=c.host;else break}function Gh(n,e=!0){let t=n.ownerDocument,i=null,s=null;for(let r=n.parentNode;r&&!(r==t.body||(!e||i)&&s);)if(r.nodeType==1)!s&&r.scrollHeight>r.clientHeight&&(s=r),e&&!i&&r.scrollWidth>r.clientWidth&&(i=r),r=r.assignedSlot||r.parentNode;else if(r.nodeType==11)r=r.host;else break;return{x:i,y:s}}var Xr=class{constructor(){this.anchorNode=null,this.anchorOffset=0,this.focusNode=null,this.focusOffset=0}eq(e){return this.anchorNode==e.anchorNode&&this.anchorOffset==e.anchorOffset&&this.focusNode==e.focusNode&&this.focusOffset==e.focusOffset}setRange(e){let{anchorNode:t,focusNode:i}=e;this.set(t,Math.min(e.anchorOffset,t?ct(t):0),i,Math.min(e.focusOffset,i?ct(i):0))}set(e,t,i,s){this.anchorNode=e,this.anchorOffset=t,this.focusNode=i,this.focusOffset=s}},Nt=null;D.safari&&D.safari_version>=26&&(Nt=!1);function _h(n){if(n.setActive)return n.setActive();if(Nt)return n.focus(Nt);let e=[];for(let t=n;t&&(e.push(t,t.scrollTop,t.scrollLeft),t!=t.ownerDocument);t=t.parentNode);if(n.focus(Nt==null?{get preventScroll(){return Nt={preventScroll:!0},!0}}:void 0),!Nt){Nt=!1;for(let t=0;tMath.max(0,n.document.documentElement.scrollHeight-n.innerHeight-4):n.scrollTop>Math.max(1,n.scrollHeight-n.clientHeight-4)}function Jh(n,e){for(let t=n,i=e;;){if(t.nodeType==3&&i>0)return{node:t,offset:i};if(t.nodeType==1&&i>0){if(t.contentEditable=="false")return null;t=t.childNodes[i-1],i=ct(t)}else if(t.parentNode&&!ns(t))i=xt(t),t=t.parentNode;else return null}}function Xh(n,e){for(let t=n,i=e;;){if(t.nodeType==3&&i=t){if(l.level==i)return o;(r<0||(s!=0?s<0?l.fromt:e[r].level>l.level))&&(r=o)}}if(r<0)throw new RangeError("Index out of range");return r}};function ec(n,e){if(n.length!=e.length)return!1;for(let t=0;t=0;m-=3)if(Xe[m+1]==-d){let g=Xe[m+2],y=g&2?s:g&4?g&1?r:s:0;y&&(U[f]=U[Xe[m]]=y),l=m;break}}else{if(Xe.length==189)break;Xe[l++]=f,Xe[l++]=u,Xe[l++]=a}else if((p=U[f])==2||p==1){let m=p==s;a=m?0:1;for(let g=l-3;g>=0;g-=3){let y=Xe[g+2];if(y&2)break;if(m)Xe[g+2]|=2;else{if(y&4)break;Xe[g+2]|=4}}}}}function dp(n,e,t,i){for(let s=0,r=i;s<=t.length;s++){let o=s?t[s-1].to:n,l=sa;)p==g&&(p=t[--m].from,g=m?t[m-1].to:n),U[--p]=d;a=c}else r=h,a++}}}function Zr(n,e,t,i,s,r,o){let l=i%2?2:1;if(i%2==s%2)for(let a=e,h=0;aa&&o.push(new He(a,m.from,d));let g=m.direction==Vt!=!(d%2);eo(n,g?i+1:i,s,m.inner,m.from,m.to,o),a=m.to}p=m.to}else{if(p==t||(c?U[p]!=l:U[p]==l))break;p++}u?Zr(n,a,p,i+1,s,u,o):ae;){let c=!0,f=!1;if(!h||a>r[h-1].to){let m=U[a-1];m!=l&&(c=!1,f=m==16)}let u=!c&&l==1?[]:null,d=c?i:i+1,p=a;e:for(;;)if(h&&p==r[h-1].to){if(f)break e;let m=r[--h];if(!c)for(let g=m.from,y=h;;){if(g==e)break e;if(y&&r[y-1].to==g)g=r[--y].from;else{if(U[g-1]==l)break e;break}}if(u)u.push(m);else{m.toU.length;)U[U.length]=256;let i=[],s=e==Vt?0:1;return eo(n,s,s,t,0,n.length,i),i}function tc(n){return[new He(0,n,0)]}var ic="";function mp(n,e,t,i,s){var r;let o=i.head-n.from,l=He.find(e,o,(r=i.bidiLevel)!==null&&r!==void 0?r:-1,i.assoc),a=e[l],h=a.side(s,t);if(o==h){let u=l+=s?1:-1;if(u<0||u>=e.length)return null;a=e[l=u],o=a.side(!s,t),h=a.side(s,t)}let c=te(n.text,o,a.forward(s,t));(ca.to)&&(c=h),ic=n.text.slice(Math.min(o,c),Math.max(o,c));let f=l==(s?e.length-1:0)?null:e[l+(s?1:-1)];return f&&c==h&&f.level+(s?0:1)n.some(e=>e)}),cc=C.define({combine:n=>n.some(e=>e)}),fc=C.define(),zi=class n{constructor(e,t,i,s,r,o=!1){this.range=e,this.y=t,this.x=i,this.yMargin=s,this.xMargin=r,this.isSnapshot=o}map(e){return e.empty?this:new n(this.range.map(e),this.y,this.x,this.yMargin,this.xMargin,this.isSnapshot)}clip(e){return this.range.to<=e.doc.length?this:new n(b.cursor(e.doc.length),this.y,this.x,this.yMargin,this.xMargin,this.isSnapshot)}},zn=L.define({map:(n,e)=>n.map(e)}),uc=L.define();function re(n,e,t){let i=n.facet(oc);i.length?i[0](e):window.onerror&&window.onerror(String(e),t,void 0,void 0,e)||(t?console.error(t+":",e):console.error(e))}var at=C.define({combine:n=>n.length?n[0]:!0}),yp=0,ai=C.define({combine(n){return n.filter((e,t)=>{for(let i=0;i{let a=[];return o&&a.push(ws.of(h=>{let c=h.plugin(l);return c?o(c):B.none})),r&&a.push(r(l)),a})}static fromClass(e,t){return n.define((i,s)=>new e(i,s),t)}},qi=class{constructor(e){this.spec=e,this.mustUpdate=null,this.value=null}get plugin(){return this.spec&&this.spec.plugin}update(e){if(this.value){if(this.mustUpdate){let t=this.mustUpdate;if(this.mustUpdate=null,this.value.update)try{this.value.update(t)}catch(i){if(re(t.state,i,"CodeMirror plugin crashed"),this.value.destroy)try{this.value.destroy()}catch{}this.deactivate()}}}else if(this.spec)try{this.value=this.spec.plugin.create(e,this.spec.arg)}catch(t){re(e.state,t,"CodeMirror plugin crashed"),this.deactivate()}return this}destroy(e){var t;if(!((t=this.value)===null||t===void 0)&&t.destroy)try{this.value.destroy()}catch(i){re(e.state,i,"CodeMirror plugin crashed")}}deactivate(){this.spec=this.value=null}},dc=C.define(),Go=C.define(),ws=C.define(),pc=C.define(),_o=C.define(),Qi=C.define(),mc=C.define();function uh(n,e){let t=n.state.facet(mc);if(!t.length)return t;let i=t.map(r=>r instanceof Function?r(n):r),s=[];return I.spans(i,e.from,e.to,{point(){},span(r,o,l,a){let h=r-e.from,c=o-e.from,f=s;for(let u=l.length-1;u>=0;u--,a--){let d=l[u].spec.bidiIsolate,p;if(d==null&&(d=gp(e.text,h,c)),a>0&&f.length&&(p=f[f.length-1]).to==h&&p.direction==d)p.to=c,f=p.inner;else{let m={from:h,to:c,direction:d,inner:[]};f.push(m),f=m.inner}}}}),s}var gc=C.define();function Yo(n){let e=0,t=0,i=0,s=0;for(let r of n.state.facet(gc)){let o=r(n);o&&(o.left!=null&&(e=Math.max(e,o.left)),o.right!=null&&(t=Math.max(t,o.right)),o.top!=null&&(i=Math.max(i,o.top)),o.bottom!=null&&(s=Math.max(s,o.bottom)))}return{left:e,right:t,top:i,bottom:s}}var Ni=C.define(),Ke=class n{constructor(e,t,i,s){this.fromA=e,this.toA=t,this.fromB=i,this.toB=s}join(e){return new n(Math.min(this.fromA,e.fromA),Math.max(this.toA,e.toA),Math.min(this.fromB,e.fromB),Math.max(this.toB,e.toB))}addToSet(e){let t=e.length,i=this;for(;t>0;t--){let s=e[t-1];if(!(s.fromA>i.toA)){if(s.toAs.push(new Ke(r,o,l,a))),this.changedRanges=s}static create(e,t,i){return new n(e,t,i)}get viewportChanged(){return(this.flags&4)>0}get viewportMoved(){return(this.flags&8)>0}get heightChanged(){return(this.flags&2)>0}get geometryChanged(){return this.docChanged||(this.flags&18)>0}get focusChanged(){return(this.flags&1)>0}get docChanged(){return!this.changes.empty}get selectionSet(){return this.transactions.some(e=>e.selection)}get empty(){return this.flags==0&&this.transactions.length==0}},bp=[],X=class{constructor(e,t,i=0){this.dom=e,this.length=t,this.flags=i,this.parent=null,e.cmTile=this}get breakAfter(){return this.flags&1}get children(){return bp}isWidget(){return!1}get isHidden(){return!1}isComposite(){return!1}isLine(){return!1}isText(){return!1}isBlock(){return!1}get domAttrs(){return null}sync(e){if(this.flags|=2,this.flags&4){this.flags&=-5;let t=this.domAttrs;t&&tp(this.dom,t)}}toString(){return this.constructor.name+(this.children.length?`(${this.children})`:"")+(this.breakAfter?"#":"")}destroy(){this.parent=null}setDOM(e){this.dom=e,e.cmTile=this}get posAtStart(){return this.parent?this.parent.posBefore(this):0}get posAtEnd(){return this.posAtStart+this.length}posBefore(e,t=this.posAtStart){let i=t;for(let s of this.children){if(s==e)return i;i+=s.length+s.breakAfter}throw new RangeError("Invalid child in posBefore")}posAfter(e){return this.posBefore(e)+e.length}covers(e){return!0}coordsIn(e,t,i){return null}domPosFor(e,t){let i=xt(this.dom),s=this.length?e>0:t>0;return new Qe(this.parent.dom,i+(s?1:0),e==0||e==this.length)}markDirty(e){this.flags&=-3,e&&(this.flags|=4),this.parent&&this.parent.flags&2&&this.parent.markDirty(!1)}get overrideDOMText(){return null}get root(){for(let e=this;e;e=e.parent)if(e instanceof mi)return e;return null}static get(e){return e.cmTile}},pi=class extends X{constructor(e){super(e,0),this._children=[]}isComposite(){return!0}get children(){return this._children}get lastChild(){return this.children.length?this.children[this.children.length-1]:null}append(e){this.children.push(e),e.parent=this}sync(e){if(this.flags&2)return;super.sync(e);let t=this.dom,i=null,s,r=e?.node==t?e:null,o=0;for(let l of this.children){if(l.sync(e),o+=l.length+l.breakAfter,s=i?i.nextSibling:t.firstChild,r&&s!=l.dom&&(r.written=!0),l.dom.parentNode==t)for(;s&&s!=l.dom;)s=dh(s);else t.insertBefore(l.dom,s);i=l.dom}for(s=i?i.nextSibling:t.firstChild,r&&s&&(r.written=!0);s;)s=dh(s);this.length=o}};function dh(n){let e=n.nextSibling;return n.parentNode.removeChild(n),e}var mi=class extends pi{constructor(e,t){super(t),this.view=e}owns(e){for(;e;e=e.parent)if(e==this)return!0;return!1}isBlock(){return!0}nearest(e){for(;;){if(!e)return null;let t=X.get(e);if(t&&this.owns(t))return t;e=e.parentNode}}blockTiles(e){for(let t=[],i=this,s=0,r=0;;)if(s==i.children.length){if(!t.length)return;i=i.parent,i.breakAfter&&r++,s=t.pop()}else{let o=i.children[s++];if(o instanceof ht)t.push(s),i=o,s=0;else{let l=r+o.length,a=e(o,r);if(a!==void 0)return a;r=l+o.breakAfter}}}resolveBlock(e,t){let i,s=-1,r,o=-1;if(this.blockTiles((l,a)=>{let h=a+l.length;if(e>=a&&e<=h){if(l.isWidget()&&t>=-1&&t<=1){if(l.flags&32)return!0;l.flags&16&&(i=void 0)}(ae||e==a&&(t>1?l.length:l.covers(-1)))&&(!r||!l.isWidget()&&r.isWidget())&&(r=l,o=e-a)}}),!i&&!r)throw new Error("No tile at position "+e);return i&&t<0||!r?{tile:i,offset:s}:{tile:r,offset:o}}},ht=class n extends pi{constructor(e,t){super(e),this.wrapper=t}isBlock(){return!0}covers(e){return this.children.length?e<0?this.children[0].covers(-1):this.lastChild.covers(1):!1}get domAttrs(){return this.wrapper.attributes}static of(e,t){let i=new n(t||document.createElement(e.tagName),e);return t||(i.flags|=4),i}},gi=class n extends pi{constructor(e,t){super(e),this.attrs=t}isLine(){return!0}static start(e,t,i){let s=new n(t||document.createElement("div"),e);return(!t||!i)&&(s.flags|=4),s}get domAttrs(){return this.attrs}resolveInline(e,t,i){let s=null,r=-1,o=null,l=-1;function a(c,f){for(let u=0,d=0;u=f&&(p.isComposite()?a(p,f-d):(!o||o.isHidden&&(t>0&&!(o.flags&32)||i&&wp(o,p)))&&(m>f||p.flags&32)?(o=p,l=f-d):(ds&&(e=s);let r=e,o=e,l=0;e==0&&t<0||e==s&&t>=0?D.chrome||D.gecko||(e?(r--,l=1):o=0)?0:a.length-1];return D.safari&&!l&&h.width==0&&(h=Array.prototype.find.call(a,c=>c.width)||h),i==null?h:ss(h,(l?l>0:t<0)==i)}static of(e,t){let i=new n(t||document.createTextNode(e),e);return t||(i.flags|=2),i}},zt=class n extends X{constructor(e,t,i,s){super(e,t,s),this.widget=i}isWidget(){return!0}get isHidden(){return this.widget.isHidden}covers(e){return this.flags&48?!1:(this.flags&(e<0?64:128))>0}coordsIn(e,t){return this.coordsInWidget(e,t,!1)}coordsInWidget(e,t,i){let s=this.widget.coordsAt(this.dom,e,t);if(s)return s;if(i)return ss(this.dom.getBoundingClientRect(),this.length?e==0:t<=0);{let r=this.dom.getClientRects(),o=null;if(!r.length)return null;let l=this.flags&16?!0:this.flags&32?!1:e>0;for(let a=l?r.length-1:0;o=r[a],!(e>0?a==0:a==r.length-1||o.top0==i)}},io=class{constructor(e){this.index=0,this.beforeBreak=!1,this.parents=[],this.tile=e}advance(e,t,i){let{tile:s,index:r,beforeBreak:o,parents:l}=this;for(;e||t>0;)if(s.isComposite())if(o){if(!e)break;i&&i.break(),e--,o=!1}else if(r==s.children.length){if(!e&&!l.length)break;i&&i.leave(s),o=!!s.breakAfter,{tile:s,index:r}=l.pop(),r++}else{let a=s.children[r],h=a.breakAfter;(t>0?a.length<=e:a.length=0;l--){let a=t.marks[l],h=s.lastChild;if(h instanceof Ce&&h.mark.eq(a.mark))h.dom!=a.dom&&h.setDOM(Hr(a.dom)),s=h;else{if(this.cache.reused.get(a)){let f=X.get(a.dom);f&&f.setDOM(Hr(a.dom))}let c=Ce.of(a.mark,a.dom);s.append(c),s=c}this.cache.reused.set(a,2)}let r=X.get(e.text);r&&this.cache.reused.set(r,2);let o=new Ft(e.text,e.text.nodeValue);o.flags|=8,this.pos=e.range.toB,s.append(o)}addInlineWidget(e,t,i){let s=this.afterWidget&&e.flags&48&&(this.afterWidget.flags&48)==(e.flags&48);s||this.flushBuffer();let r=this.ensureMarks(t,i);!s&&!(e.flags&16)&&r.append(this.getBuffer(1)),r.append(e),this.pos+=e.length,this.afterWidget=e}addMark(e,t,i){this.flushBuffer(),this.ensureMarks(t,i).append(e),this.pos+=e.length,this.afterWidget=null}addBlockWidget(e){this.getBlockPos().append(e),this.pos+=e.length,this.lastBlock=e,this.endLine()}continueWidget(e){let t=this.afterWidget||this.lastBlock;t.length+=e,this.pos+=e}addLineStart(e,t){var i;e||(e=yc);let s=gi.start(e,t||((i=this.cache.find(gi))===null||i===void 0?void 0:i.dom),!!t);this.getBlockPos().append(this.lastBlock=this.curLine=s)}addLine(e){this.getBlockPos().append(e),this.pos+=e.length,this.lastBlock=e,this.endLine()}addBreak(){this.lastBlock.flags|=1,this.endLine(),this.pos++}addLineStartIfNotCovered(e){this.blockPosCovered()||this.addLineStart(e)}ensureLine(e){this.curLine||this.addLineStart(e)}ensureMarks(e,t){var i;let s=this.curLine;for(let r=e.length-1;r>=0;r--){let o=e[r],l;if(t>0&&(l=s.lastChild)&&l instanceof Ce&&l.mark.eq(o))s=l,t--;else{let a=Ce.of(o,(i=this.cache.find(Ce,h=>h.mark.eq(o)))===null||i===void 0?void 0:i.dom);s.append(a),s=a,t=0}}return s}endLine(){if(this.curLine){this.flushBuffer();let e=this.curLine.lastChild;(!e||!ph(this.curLine,!1)||e.dom.nodeName!="BR"&&e.isWidget()&&!(D.ios&&ph(this.curLine,!0)))&&this.curLine.append(this.cache.findWidget(Wr,0,32)||new zt(Wr.toDOM(),0,Wr,32)),this.curLine=this.afterWidget=null}}updateBlockWrappers(){this.wrapperPos>this.pos+1e4&&(this.blockWrappers.goto(this.pos),this.wrappers.length=0);for(let e=this.wrappers.length-1;e>=0;e--)this.wrappers[e].to=this.pos){let t=e.rank*102+e.value.rank,i=new no(e.from,e.to,e.value,t),s=this.wrappers.length;for(;s>0&&(this.wrappers[s-1].rank-i.rank||this.wrappers[s-1].to-i.to)<0;)s--;this.wrappers.splice(s,0,i)}this.wrapperPos=this.pos}getBlockPos(){var e;this.updateBlockWrappers();let t=this.root;for(let i of this.wrappers){let s=t.lastChild;if(i.fromo.wrapper.eq(i.wrapper)))===null||e===void 0?void 0:e.dom);t.append(r),t=r}}return t}blockPosCovered(){let e=this.lastBlock;return e!=null&&!e.breakAfter&&(!e.isWidget()||(e.flags&160)>0)}getBuffer(e){let t=2|(e<0?16:32),i=this.cache.find(yi,void 0,1);return i&&(i.flags=t),i||new yi(t)}flushBuffer(){this.afterWidget&&!(this.afterWidget.flags&32)&&(this.afterWidget.parent.append(this.getBuffer(-1)),this.afterWidget=null)}},ro=class{constructor(e){this.skipCount=0,this.text="",this.textOff=0,this.cursor=e.iter()}skip(e){this.textOff+e<=this.text.length?this.textOff+=e:(this.skipCount+=e-(this.text.length-this.textOff),this.text="",this.textOff=0)}next(e){if(this.textOff==this.text.length){let{value:s,lineBreak:r,done:o}=this.cursor.next(this.skipCount);if(this.skipCount=0,o)throw new Error("Ran out of text content when drawing inline views");this.text=s;let l=this.textOff=Math.min(e,s.length);return r?null:s.slice(0,l)}let t=Math.min(this.text.length,this.textOff+e),i=this.text.slice(this.textOff,t);return this.textOff=t,i}},os=[zt,gi,Ft,Ce,yi,ht,mi];for(let n=0;n[]),this.index=os.map(()=>0),this.reused=new Map}add(e){let t=e.constructor.bucket,i=this.buckets[t];i.length<6?i.push(e):i[this.index[t]=(this.index[t]+1)%6]=e}find(e,t,i=2){let s=e.bucket,r=this.buckets[s],o=this.index[s];for(let l=0;l{if(this.cache.add(o),o.isComposite())return!1},enter:o=>this.cache.add(o),leave:()=>{},break:()=>{}}}run(e,t){let i=t&&this.getCompositionContext(t.text);for(let s=0,r=0,o=0;;){let l=os){let h=a-s;this.preserve(h,!o,!l),s=a,r+=h}if(!l)break;t&&l.fromA<=t.range.fromA&&l.toA>=t.range.toA?(this.forward(l.fromA,t.range.fromA,t.range.fromA{if(o.isWidget())if(this.openWidget)this.builder.continueWidget(a-l);else{let h=a>0||l{o.isLine()?this.builder.addLineStart(o.attrs,this.cache.maybeReuse(o)):(this.cache.add(o),o instanceof Ce&&s.unshift(o.mark)),this.openWidget=!1},leave:o=>{o.isLine()?s.length&&(s.length=r=0):o instanceof Ce&&(s.shift(),r=Math.min(r,s.length))},break:()=>{this.builder.addBreak(),this.openWidget=!1}}),this.text.skip(e)}emit(e,t){let i=null,s=this.builder,r=-1,o=I.spans(this.decorations,e,t,{point:(l,a,h,c,f,u)=>{if(h instanceof Wt){if(this.disallowBlockEffectsFor[u]){if(h.block)throw new RangeError("Block decorations may not be specified via plugins");if(a>this.view.state.doc.lineAt(l).to)throw new RangeError("Decorations that replace line breaks may not be specified via plugins")}if(r=c.length,f>c.length)s.continueWidget(a-l);else{let d=h.widget||(h.block?wt.block:wt.inline),p=vp(h),m=this.cache.findWidget(d,a-l,p)||zt.of(d,this.view,a-l,p);h.block?(h.startSide>0&&s.addLineStartIfNotCovered(i),s.addBlockWidget(m)):(s.ensureLine(i),s.addInlineWidget(m,c,f))}i=null}else i=kp(i,h);a>l&&this.text.skip(a-l)},span:(l,a,h,c)=>{for(let f=l;f-1&&(this.openWidget=o>r),this.openWidget||s.addLineStartIfNotCovered(i),this.openMarks=o}forward(e,t,i=1){t-e<=10?this.old.advance(t-e,i,this.reuseWalker):(this.old.advance(5,-1,this.reuseWalker),this.old.advance(t-e-10,-1),this.old.advance(5,i,this.reuseWalker))}getCompositionContext(e){let t=[],i=null;for(let s=e.parentNode;;s=s.parentNode){let r=X.get(s);if(s==this.view.contentDOM)break;r instanceof Ce?t.push(r):r?.isLine()?i=r:r instanceof ht||(s.nodeName=="DIV"&&!i&&s!=this.view.contentDOM?i=new gi(s,yc):i||t.push(Ce.of(new _i({tagName:s.nodeName.toLowerCase(),attributes:ip(s)}),s)))}return{line:i,marks:t}}};function ph(n,e){let t=i=>{for(let s of i.children)if((e?s.isText():s.length)||t(s))return!0;return!1};return t(n)}function vp(n){let e=n.isReplace?(n.startSide<0?64:0)|(n.endSide>0?128:0):n.startSide>0?32:16;return n.block&&(e|=256),e}var yc={class:"cm-line"};function kp(n,e){let t=e.spec.attributes,i=e.spec.class;return!t&&!i||(n||(n={class:"cm-line"}),t&&qo(t,n),i&&(n.class+=" "+i)),n}function Sp(n){let e=[];for(let t=n.parents.length;t>1;t--){let i=t==n.parents.length?n.tile:n.parents[t].tile;i instanceof Ce&&e.push(i.mark)}return e}function Hr(n){let e=X.get(n);return e&&e.setDOM(n.cloneNode()),n}var wt=class extends xe{constructor(e){super(),this.tag=e}eq(e){return e.tag==this.tag}toDOM(){return document.createElement(this.tag)}updateDOM(e){return e.nodeName.toLowerCase()==this.tag}get isHidden(){return!0}};wt.inline=new wt("span");wt.block=new wt("div");var Wr=new class extends xe{toDOM(){return document.createElement("br")}get isHidden(){return!0}get editable(){return!0}},ls=class{constructor(e){this.view=e,this.decorations=[],this.blockWrappers=[],this.dynamicDecorationMap=[!1],this.domChanged=null,this.hasComposition=null,this.editContextFormatting=B.none,this.lastCompositionAfterCursor=!1,this.minWidth=0,this.minWidthFrom=0,this.minWidthTo=0,this.impreciseAnchor=null,this.impreciseHead=null,this.forceSelection=!1,this.lastUpdate=Date.now(),this.updateDeco(),this.tile=new mi(e,e.contentDOM),this.updateInner([new Ke(0,0,0,e.state.doc.length)],null)}update(e){var t;let i=e.changedRanges;this.minWidth>0&&i.length&&(i.every(({fromA:c,toA:f})=>fthis.minWidthTo)?(this.minWidthFrom=e.changes.mapPos(this.minWidthFrom,1),this.minWidthTo=e.changes.mapPos(this.minWidthTo,1)):this.minWidth=this.minWidthFrom=this.minWidthTo=0),this.updateEditContextFormatting(e);let s=-1;this.view.inputState.composing>=0&&!this.view.observer.editContext&&(!((t=this.domChanged)===null||t===void 0)&&t.newSel?s=this.domChanged.newSel.head:!Lp(e.changes,this.hasComposition)&&!e.selectionSet&&(s=e.state.selection.main.head));let r=s>-1?Ap(this.view,e.changes,s):null;if(this.domChanged=null,this.hasComposition){let{from:c,to:f}=this.hasComposition;i=new Ke(c,f,e.changes.mapPos(c,-1),e.changes.mapPos(f,1)).addToSet(i.slice())}this.hasComposition=r?{from:r.range.fromB,to:r.range.toB}:null,(D.ie||D.chrome)&&!r&&e&&e.state.doc.lines!=e.startState.doc.lines&&(this.forceSelection=!0);let o=this.decorations,l=this.blockWrappers;this.updateDeco();let a=Dp(o,this.decorations,e.changes);a.length&&(i=Ke.extendWithRanges(i,a));let h=Op(l,this.blockWrappers,e.changes);return h.length&&(i=Ke.extendWithRanges(i,h)),r&&!i.some(c=>c.fromA<=r.range.fromA&&c.toA>=r.range.toA)&&(i=r.range.addToSet(i.slice())),this.tile.flags&2&&i.length==0?!1:(this.updateInner(i,r),e.transactions.length&&(this.lastUpdate=Date.now()),!0)}updateInner(e,t){this.view.viewState.mustMeasureContent=!0;let{observer:i}=this.view;i.ignore(()=>{if(t||e.length){let o=this.tile,l=new lo(this.view,o,this.blockWrappers,this.decorations,this.dynamicDecorationMap);t&&X.get(t.text)&&l.cache.reused.set(X.get(t.text),2),this.tile=l.run(e,t),ao(o,l.cache.reused)}this.tile.dom.style.height=this.view.viewState.contentHeight/this.view.scaleY+"px",this.tile.dom.style.flexBasis=this.minWidth?this.minWidth+"px":"";let r=D.chrome||D.ios?{node:i.selectionRange.focusNode,written:!1}:void 0;this.tile.sync(r),r&&(r.written||i.selectionRange.focusNode!=r.node||!this.tile.dom.contains(r.node))&&(this.forceSelection=!0),this.tile.dom.style.height=""});let s=[];if(this.view.viewport.from||this.view.viewport.to-1)&&Wi(i,this.view.observer.selectionRange)&&!(s&&i.contains(s));if(!(r||t||o))return;let l=this.forceSelection;this.forceSelection=!1;let a=this.view.state.selection.main,h,c;if(a.empty?c=h=this.inlineDOMNearPos(a.anchor,a.assoc||1):(c=this.inlineDOMNearPos(a.head,a.head==a.from?1:-1),h=this.inlineDOMNearPos(a.anchor,a.anchor==a.from?1:-1)),D.gecko&&a.empty&&!this.hasComposition&&Cp(h)){let u=document.createTextNode("");this.view.observer.ignore(()=>h.node.insertBefore(u,h.node.childNodes[h.offset]||null)),h=c=new Qe(u,0),l=!0}let f=this.view.observer.selectionRange;(l||!f.focusNode||(!Vi(h.node,h.offset,f.anchorNode,f.anchorOffset)||!Vi(c.node,c.offset,f.focusNode,f.focusOffset))&&!this.suppressWidgetCursorChange(f,a))&&(this.view.observer.ignore(()=>{D.android&&D.chrome&&i.contains(f.focusNode)&&Bp(f.focusNode,i)&&(i.blur(),i.focus({preventScroll:!0}));let u=Ji(this.view.root);if(u)if(a.empty){if(D.gecko){let d=Mp(h.node,h.offset);if(d&&d!=3){let p=(d==1?Jh:Xh)(h.node,h.offset);p&&(h=new Qe(p.node,p.offset))}}u.collapse(h.node,h.offset),a.bidiLevel!=null&&u.caretBidiLevel!==void 0&&(u.caretBidiLevel=a.bidiLevel)}else if(u.extend){u.collapse(h.node,h.offset);try{u.extend(c.node,c.offset)}catch{}}else{let d=document.createRange();a.anchor>a.head&&([h,c]=[c,h]),d.setEnd(c.node,c.offset),d.setStart(h.node,h.offset),u.removeAllRanges(),u.addRange(d)}o&&this.view.root.activeElement==i&&(i.blur(),s&&s.focus())}),this.view.observer.setSelectionRange(h,c)),this.impreciseAnchor=h.precise?null:new Qe(f.anchorNode,f.anchorOffset),this.impreciseHead=c.precise?null:new Qe(f.focusNode,f.focusOffset)}suppressWidgetCursorChange(e,t){return this.hasComposition&&t.empty&&Vi(e.focusNode,e.focusOffset,e.anchorNode,e.anchorOffset)&&this.posFromDOM(e.focusNode,e.focusOffset)==t.head}enforceCursorAssoc(){if(this.hasComposition)return;let{view:e}=this,t=e.state.selection.main,i=Ji(e.root),{anchorNode:s,anchorOffset:r}=e.observer.selectionRange;if(!i||!t.empty||!t.assoc||!i.modify)return;let o=this.lineAt(t.head,t.assoc);if(!o)return;let l=o.posAtStart;if(t.head==l||t.head==l+o.length)return;let a=this.coordsAt(t.head,-1),h=this.coordsAt(t.head,1);if(!a||!h||a.bottom>h.top)return;let c=this.domAtPos(t.head+t.assoc,t.assoc);i.collapse(c.node,c.offset),i.modify("move",t.assoc<0?"forward":"backward","lineboundary"),e.observer.readSelectionRange();let f=e.observer.selectionRange;e.docView.posFromDOM(f.anchorNode,f.anchorOffset)!=t.from&&i.collapse(s,r)}posFromDOM(e,t){let i=this.tile.nearest(e);if(!i)return this.tile.dom.compareDocumentPosition(e)&2?0:this.view.state.doc.length;let s=i.posAtStart;if(i.isComposite()){let r;if(e==i.dom)r=i.dom.childNodes[t];else{let o=ct(e)==0?0:t==0?-1:1;for(;;){let l=e.parentNode;if(l==i.dom)break;o==0&&l.firstChild!=l.lastChild&&(e==l.firstChild?o=-1:o=1),e=l}o<0?r=e:r=e.nextSibling}if(r==i.dom.firstChild)return s;for(;r&&!X.get(r);)r=r.nextSibling;if(!r)return s+i.length;for(let o=0,l=s;;o++){let a=i.children[o];if(a.dom==r)return l;l+=a.length+a.breakAfter}}else return i.isText()?e==i.dom?s+t:s+(t?i.length:0):s}domAtPos(e,t){let{tile:i,offset:s}=this.tile.resolveBlock(e,t);return i.isWidget()?i.domPosFor(s,t):i.domIn(s,t)}inlineDOMNearPos(e,t){let i,s=-1,r=!1,o,l=-1,a=!1;return this.tile.blockTiles((h,c)=>{if(h.isWidget()){if(h.flags&32&&c>=e)return!0;h.flags&16&&(r=!0)}else{let f=c+h.length;if(c<=e&&(i=h,s=e-c,r=f=e&&!o&&(o=h,l=e-c,a=c>e),c>e&&o)return!0}}),!i&&!o?this.domAtPos(e,t):(r&&o?i=null:a&&i&&(o=null),i&&t<0||!o?i.domIn(s,t):o.domIn(l,t))}coordsAt(e,t,i){let{tile:s,offset:r}=this.tile.resolveBlock(e,t);return s.isWidget()?s.widget instanceof Ki?null:s.coordsInWidget(r,t,!0):s.coordsIn(r,t,i)}lineAt(e,t){let{tile:i}=this.tile.resolveBlock(e,t);return i.isLine()?i:null}coordsForChar(e){let{tile:t,offset:i}=this.tile.resolveBlock(e,1);if(!t.isLine())return null;function s(r,o){if(r.isComposite())for(let l of r.children){if(l.length>=o){let a=s(l,o);if(a)return a}if(o-=l.length,o<0)break}else if(r.isText()&&oMath.max(this.view.scrollDOM.clientWidth,this.minWidth)+1,l=-1,a=this.view.textDirection==V.LTR,h=0,c=(f,u,d)=>{for(let p=0;ps);p++){let m=f.children[p],g=u+m.length,y=m.dom.getBoundingClientRect(),{height:x}=y;if(d&&!p&&(h+=y.top-d.top),m instanceof ht)g>i&&c(m,u,y);else if(u>=i&&(h>0&&t.push(-h),t.push(x+h),h=0,o)){let w=m.dom.lastChild,O=w?Jn(w):[];if(O.length){let v=O[O.length-1],k=a?v.right-y.left:y.right-v.left;k>l&&(l=k,this.minWidth=r,this.minWidthFrom=u,this.minWidthTo=g)}}d&&p==f.children.length-1&&(h+=d.bottom-y.bottom),u=g+m.breakAfter}};return c(this.tile,0,null),t}textDirectionAt(e){let{tile:t}=this.tile.resolveBlock(e,1);return getComputedStyle(t.dom).direction=="rtl"?V.RTL:V.LTR}measureTextSize(){let e=this.tile.blockTiles(o=>{if(o.isLine()&&o.children.length&&o.length<=20){let l=0,a;for(let h of o.children){if(!h.isText()||/[^ -~]/.test(h.text))return;let c=Jn(h.dom);if(c.length!=1)return;l+=c[0].width,a=c[0].height}if(l)return{lineHeight:o.dom.getBoundingClientRect().height,charWidth:l/o.length,textHeight:a}}});if(e)return e;let t=document.createElement("div"),i,s,r;return t.className="cm-line",t.style.width="99999px",t.style.position="absolute",t.textContent="abc def ghi jkl mno pqr stu",this.view.observer.ignore(()=>{this.tile.dom.appendChild(t);let o=Jn(t.firstChild)[0];i=t.getBoundingClientRect().height,s=o&&o.width?o.width/27:7,r=o&&o.height?o.height:i,t.remove()}),{lineHeight:i,charWidth:s,textHeight:r}}computeBlockGapDeco(){let e=[],t=this.view.viewState;for(let i=0,s=0;;s++){let r=s==t.viewports.length?null:t.viewports[s],o=r?r.from-1:this.view.state.doc.length;if(o>i){let l=(t.lineBlockAt(o).bottom-t.lineBlockAt(i).top)/this.view.scaleY;e.push(B.replace({widget:new Ki(l),block:!0,inclusive:!0,isBlockGap:!0}).range(i,o))}if(!r)break;i=r.to+1}return B.set(e)}updateDeco(){let e=1,t=this.view.state.facet(ws).map(r=>(this.dynamicDecorationMap[e++]=typeof r=="function")?r(this.view):r),i=!1,s=this.view.state.facet(_o).map((r,o)=>{let l=typeof r=="function";return l&&(i=!0),l?r(this.view):r});for(s.length&&(this.dynamicDecorationMap[e++]=i,t.push(I.join(s))),this.decorations=[this.editContextFormatting,...t,this.computeBlockGapDeco(),this.view.viewState.lineGapDeco];e