@repobit/dex-store-elements 1.2.4 → 1.2.5

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.2.5](https://github.com/bitdefender/dex-core/compare/@repobit/dex-store-elements@1.2.4...@repobit/dex-store-elements@1.2.5) (2025-10-28)
+
+**Note:** Version bump only for package @repobit/dex-store-elements
+
+
+
+
+
 ## [1.2.4](https://github.com/bitdefender/dex-core/compare/@repobit/dex-store-elements@1.2.3...@repobit/dex-store-elements@1.2.4) (2025-10-20)
 
 

package/README.md

@@ -54,11 +54,11 @@ Peer dependencies are resolved automatically by npm; no extra install command is
       <div data-store-render data-store-price="discounted || full"></div>
       <a data-store-render data-store-buy-link>Buy</a>
       <!-- Eta template (text) -->
-      <p>Now at only {{= it.option.discountedPrice }}!</p>
+      <p>Now at only {{= it.option.price.discounted }}!</p>
       <!-- Eta template (attribute, implicit) -->
       <div title="Devices {{= it.option.devices }}"></div>
       <!-- Hide via DSL using merged context -->
-      <div data-store-render data-store-hide="!it.option.discountedPrice">
+      <div data-store-render data-store-hide="!it.option.price.discounted">
         Hidden when discounted price doesn't exists
       </div>
       <!-- Actions -->
@@ -162,8 +162,8 @@ Notes
     - `it.state.*` aggregated min/max data (also available under `it.ctx`)
     - any keys returned from your `root.derived`
   - Examples:
-    - `data-store-hide="it.option.discountedPrice === 0"`
-    - `data-store-hide="(it.state.price.min > 100) && (it.product.campaign === 'test')"`
+    - `data-store-hide="!it.option.price.discounted"` (hide when no discounted price)
+    - `data-store-hide="it.product.campaign === 'test'"`
 
 ## Eta templates
 - Text/HTML: any element that is not a provider and doesn’t contain nested providers is treated as a whole-template; `innerHTML` is compiled once and morphed via nanomorph. This preserves existing DOM event listeners and state.
@@ -176,12 +176,69 @@ Notes
   - your derived overlay merged at top-level (see below)
 
 ## Derived variables/functions
-- Provide a function at the root: `root.derived = async ({ option, product, state, store }) => ({ ... })`
+- Provide a function at the root: `root.derived = async ({ option, product, state }) => ({ ... })`
 - The returned object is merged into the Eta/DSL context:
-  - Example: `({ mails: (p) => (option.getDevices()/p)*100, option: { someVar: state.discount.value.min } })`
+  - Example: `({ mails: (p) => (option?.getDevices?.()/p)*100, option: { someVar: state.discount.value.min } })`
   - Use it in Eta: `{{= it.mails(10) }}` or `{{= it.option.someVar }}`
   - Use it in hide: `data-store-hide="it.mails(10) >= 50"`
 
+## DSL context reference
+The DSL and Eta contexts use Eta’s default variable name `it`. The following keys are available:
+
+- it.option
+  - price
+    - full: formatted full price (string)
+    - discounted: formatted discounted price (string)
+    - fullMonthly: formatted monthly full price (string)
+    - discountedMonthly: formatted monthly discounted price (string)
+  - discount
+    - value: formatted discount amount (string)
+    - percentage: formatted percentage discount with symbol (string)
+    - valueMonthly: formatted monthly discount amount (string)
+    - percentageMonthly: formatted monthly percentage with symbol (string)
+  - links
+    - buy: buy URL (string)
+    - trial: trial URL if available (string)
+  - devices: number
+  - subscription: number
+
+- it.product
+  - id: string
+  - campaign: string
+  - name: string
+
+- it.state (also available as `it.ctx`)
+  - price
+    - full
+      - min: formatted string
+      - max: formatted string
+      - monthly
+        - min: formatted string
+        - max: formatted string
+    - discounted
+      - min: formatted string
+      - max: formatted string
+      - monthly
+        - min: formatted string
+        - max: formatted string
+  - discount
+    - percentage
+      - min: formatted string
+      - max: formatted string
+      - monthly
+        - min: formatted string
+        - max: formatted string
+    - value
+      - min: formatted string
+      - max: formatted string
+      - monthly
+        - min: formatted string
+        - max: formatted string
+
+Notes
+- All price/discount values in the DSL are formatted strings (currency-aware). Do not perform numeric comparisons on them. Prefer truthiness checks (e.g., `!it.option.price.discounted`).
+- `it.ctx` is an alias of `it.state` for convenience.
+
 ## Actions
 - Add `data-store-action` to elements to emit store events.
   - Set absolute values: `data-store-set-devices`, `data-store-set-subscription`, `data-store-set-id`, `data-store-set-campaign`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@repobit/dex-store-elements",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "description": "HTML elements layer for pricings",
   "author": "Buga Adrian Alexandru <abuga@bitdefender.com>",
   "homepage": "https://github.com/bitdefender/dex-core#readme",
@@ -62,5 +62,5 @@
       ]
     }
   },
-  "gitHead": "c38f5d5676fedc5a6adc0b1248803ac5ad376f86"
+  "gitHead": "9994983ec6b6d8140dbb2cfb2c11a6935943381e"
 }