@gemboss/gem-framework 0.15.0 → 0.16.1

package/README.md

@@ -6,7 +6,7 @@ gem-framework của GemTheme đóng thành package, cho các repo **ngoài** mon
 | Cổng vào | Là gì | Nguồn |
 |---|---|---|
 | `@gemboss/gem-framework` | token, `createGemThemeCss`, runtime, manifest, bộ kiểm framework. Từ 0.3.4 manifest khai họ `gem-cart-line-item` (khối, `__media`, `__details`, `__title`, `__variant`, `__plan`, `__meta`, `__remove`, `__quantity`, `__price`): framework vốn style và adapter Shopify vốn render nó, nên section dùng markup dòng giỏ của framework không còn bị `unknown_gem_class` | `packages/gem-framework/src` |
-| `…/sections` | Các hàm `headless.tsx` được import: `elementOverrides`, `imageSrcSet`, `subscriptionPlans`, `defaultPlan`; từ 0.15.0 thêm bộ đọc nhấn trong câu `inlineMarkRuns`, `phraseMarkRuns`, `markClassName`, `inlineMarkText`, `safeMarkHref`, `MARK_KINDS` | `packages/gem-sections/src` |
+| `…/sections` | Các hàm `headless.tsx` được import: `elementOverrides`, `imageSrcSet`, `subscriptionPlans`, `defaultPlan`; từ 0.15.0 thêm bộ đọc nhấn trong câu `inlineMarkRuns`, `phraseMarkRuns`, `markClassName`, `inlineMarkText`, `safeMarkHref`, `MARK_KINDS`; từ 0.16.0 thêm giá thẻ sản phẩm `cardPrice` (`card-price.ts`: nhiều giá thì "From" + giá thấp nhất, Sale chỉ khi biến thể mua được đang giảm, hết hàng, biến thể mà giá nói tới). `product-card-grid` quick-view-grid và featured từ section-library 1.39.6 import chúng: đồng bộ hai section đó khi đã lên 0.16.0 | `packages/gem-sections/src` |
 | `…/section-gate` | `validateSectionArtifacts`: ĐÚNG bộ kiểm section gemtheme dùng khi duyệt. Từ 0.3.0 thêm ba cổng của thư viện cho MỘT section: `layoutKnobCheck` (+ `LAYOUT_ATTRS`), `slotContractDrift` (+ `slotsReadBy`, `slotSourceFromElementTree`), `cssPairingOrphans` (+ `classesStyledBy`, truyền CSS từ `createGemThemeCss`). Từ 0.3.2 thêm hai cổng pháp lý: `fabricatedProofInSource` / `fabricatedProofInSchema` (điểm, số lượt, người, lời hứa bịa) và `inventedTestimonyIn` (hằng DEMO_*_QUOTE/REVIEW… làm giá trị khi thiếu dữ liệu). Từ 0.3.3 hai cổng này đọc được tiếng Việt ("4,8/5", "đã bán", "miễn phí vận chuyển", "199k", cả chữ NFD), tra giá trị của `DEMO.<key>` ở mọi chỗ đọc nó (`??`, `\|\|`, toán tử ba ngôi, dòng bị Prettier ngắt), và bỏ qua số lượng hiển thị (`reviews_to_show`…). Nâng từ 0.3.2 lên có thể làm đỏ section trước đó xanh: đó là lời khẳng định nằm trong DEMO. Từ 0.3.5 bắt thêm chữ ký người Việt (tên kèm nơi chốn như "Chị Lan, Hà Nội", hoặc họ + Thị/Văn như "Nguyễn Thị Hoa"; tiêu đề viết hoa từng chữ thì không), điểm sao ("4,9 ★"), `rating: 4.9` / `reviewCount: "1.284"` trong mảng sản phẩm mẫu, và hằng demo ở nhánh else của toán tử ba ngôi (`bound ? [] : DEMO_REVIEWS`). Mỗi thứ bịa chỉ báo MỘT lần: tại dòng DEMO nếu dòng đó tự lộ, không thì tại chỗ đọc. "đồng hồ" không còn bị đọc là giá. Từ 0.3.6 bắt lời hứa có thời hạn đứng sau từ khoá ("Dùng thử 30 ngày", "Bảo hành 12 tháng", "Nhận trong 2–4 ngày", "Giao 2 giờ") và "hoàn tiền" không kèm số; "Chính sách hoàn tiền" vẫn là nhãn. Từ 0.3.7 câu hỏi (kết thúc bằng "?") không bao giờ là lời hứa, "không hợp lệ"/số bước/nhịp giao không bị báo, và bắt thêm "trong vòng N ngày", "Giao hàng 2–4 ngày", "Bảo hành 1 đổi 1…", "Try it free for 30 days", "Ships in 24h". Từ 0.3.8 xuất thêm `claimIn` (câu hỏi "một chuỗi này có phải lời khẳng định, người bịa, hay lời hứa?"). Từ 0.3.9 bắt "cancel anytime", "guaranteed delivery", "huỷ bất cứ lúc nào" (chính sách huỷ gói và giao hàng). Từ 0.3.10 lời từ chối ("cannot be canceled", "Không thể hủy") không bị báo, "giao dịch/giao diện" không phải giao hàng, "Delivery not guaranteed" là lời miễn trừ, một chuỗi chỉ gồm con số viết tắt ("199k", "12k+") mang nhãn trung tính "hardcoded figure" (không phân biệt được giá với số đếm), và `stringLiteralsIn(line)` thay cho hằng `STRING_LITERAL` (đã gỡ: một regex `/g` dùng chung rò `lastIndex`; 0 chỗ dùng ở gemboss/gemfactory/gemsite). Từ 0.3.11 "Huỷ bỏ lọc…" và "Hủy đơn, gọi chúng tôi bất cứ lúc nào" không bị đọc là chính sách huỷ; "huỷ đăng ký" là bỏ nhận tin (như "Unsubscribe anytime"); `SOURCE.json` ghi `gemtheme_dirty`, và `npm pack` từ chối khi ĐẦU VÀO của gói (`packages/`, gói này trừ `package.json`, `scripts/lib/`) có thay đổi chưa commit hoặc git không trả lời được. Từ 0.3.12 bắt lời hứa hoàn tiền không có chữ "hoàn tiền" liền nhau ("nhận lại toàn bộ tiền", "Hoàn lại 100% tiền", "Trả lại tiền nếu không hài lòng"); lời từ chối ("Không được hoàn lại tiền") và tiền thừa/thối khi thanh toán không bị bắt Từ 0.4.0: `demoOutsidePreview(tsx)` (chữ mẫu DEMO chỉ hiện trong bản xem trước, tức khi `section.demo === true`; plan xuất bản không bao giờ mang cờ đó) và schema `SectionSpec` khai trường `demo` | `packages/gem-sections/src/section-artifacts.ts`, `section-contract.ts` |
 | `…/settings-schema` | `validateSettingsSchema` | `scripts/lib/settings-schema-contract.mjs` |
 | `…/gem-framework.css`, `…/gem-runtime.js` | CSS token mặc định + runtime mọi plugin, dựng sẵn. `gem-runtime.js` tự chạy khi tải: đăng ký và lên lịch đủ 23 plugin | build |
@@ -93,6 +93,26 @@ Từ 0.8.2 mỗi module có `.d.ts` cạnh nó (`mount(root?: ParentNode | null,
 
 ## Nhật ký thay đổi
 
+- **0.16.1** (12/10/2026): SỬA cổng slot-contract (`slotsReadBy`, `…/section-gate`), gap #42 của GemFactory + review #758. Tên túi
+  slot chỉ tính khi đứng ĐẦU một biểu thức: không sau chữ, `$`, `-`, `.`, `/` hay dấu nháy. Nên id `…reward-slots.v1`,
+  `delivery-picker.slots.v1`, `gift.timeslots.v1`, chuỗi `"./slots.ts"` và `item.content.title` (tên alias làm thuộc tính của thứ
+  khác) không còn sinh slot giả. `content_slots` là tên duy nhất được đứng sau `.` (`section.content_slots.heading` vẫn là lượt
+  đọc). Thêm: `slots?.x`, `slots?.["x"]`, alias có khai kiểu (`const c: T = …`) và alias qua `section?.content_slots` /
+  `props.section.content_slots`. Đánh đổi có chủ ý: phép trừ không cách `total -slots.count` không còn tính. Script
+  `audit-slot-key-drift.mjs` dùng chung `slotsReadBy` (chạy bằng `npx tsx`). Thư viện giữ baseline (57/91 sạch). Đối chứng âm:
+  bỏ phần lookbehind mới thì 2 ca đỏ. Chuỗi merge: GemFactory nâng lên 0.16.1 thì gỡ (hoặc hạ) cảnh báo `variant_name_slots_trap`,
+  vì cổng không còn đọc nhầm.
+- **0.16.0** (12/10/2026): CHỈ THÊM. **Giá thẻ sản phẩm**: `…/sections` (và `@gemtheme/gem-sections`) thêm `cardPrice(product,
+  fromLabel?)`, MỘT luật giá cho mọi section thẻ sản phẩm gọi nó. `product-card-grid` quick-view-grid và featured giữ hai bản riêng, sửa
+  một bản thì bản kia giữ lỗi, nên cùng một sản phẩm ra hai giá ở hai lưới (gemtheme #754). Trả về:
+  - `text` (dòng giá) và `from`: nhiều giá thì "From" + giá THẤP NHẤT (min của priceRange, không thì biến thể rẻ nhất), như Dawn;
+  - `compareAt` (có ⇔ có Sale): biến thể MUA ĐƯỢC ở giá đang hiện đang giảm, hoặc giá gạch của chính người bán khi so được là lớn hơn;
+  - `soldOut`: cờ curated, `availableForSale` của sản phẩm, hoặc mọi biến thể hết;
+  - `variant`: biến thể thêm giỏ được (mua được, có id, đúng giá đang hiện);
+  - `amount`: số cho `data-gem-product-price`.
+
+  Section-library 1.39.6 import nó: GemFactory đồng bộ hai section `product-card-grid` đó khi đã lên 0.16.0, không thì
+  `cardPrice is not a function`.
 - **0.15.0** (11/10/2026): CHỈ THÊM, store đang chạy không đổi pixel nào (chưa trang nào mang các lớp mới). Gap #39: **nhấn
   trong câu**. Chữ advertorial sống nhờ cách nhấn (kho GemFactory `research/advertorial-blocks-2026-10-10`: souleora 84 cụm đậm,
   5 nghiêng, 4 đổi màu, 1 gạch chân trong 152 đoạn; 28pilates chốt thẻ "đừng mua" bằng câu đỏ, tô màu nhấn cụm kết quả trong
@@ -116,8 +136,18 @@ Từ 0.8.2 mỗi module có `.d.ts` cạnh nó (`mount(root?: ParentNode | null,
     trong manifest (nhóm content), nên section vẽ chúng không bị `unknown_gem_class`.
   - Người dùng: gemboss phải thêm các tên mới vào requireShim của bản xem trước section; gemsite chép `inline-marks.ts`
     byte-identical (cặp kiểm của `check-elements-copied-from-gemtheme`) rồi vẽ dấu cho element `text` / `heading`.
-- **0.14.0** (11/10/2026): CHỈ THÊM, store đang chạy không đổi pixel nào (không section nào của gemtheme, gemsite, gemboss
-  đọc các tên dưới đây; 30 mục kho GemFactory tự khai thang dùng tên riêng theo mục). Hai gap của bộ interaction "Gọn"
+- **0.14.0** (11/10/2026): thêm thang và plugin (không đổi gì sẵn có), trừ hai chỗ dưới. Không section nào của gemtheme hay
+  gemboss đọc các tên mới (đo `git grep -nE -e '--gem-motion-(fast|base|slow|distance|distance-lg|stagger|blur)[^a-z-]' -e
+  '--gem-ease-(enter|exit)[^a-z-]'`; ĐỪNG dùng `\b`: git của Apple 2.39.5 không hiểu nó và ra 0 im lặng). Kho GemFactory: 209
+  mục tự khai thang bằng tên riêng theo mục, đếm bằng cổng `motion_scale_self_declared` ngày 11/10/2026 trên 259 section; 0 mục
+  khai lại biến của gói, 0 mục đọc thiếu số dự phòng. *Sửa 11/10/2026, bản đầu ghi "store đang chạy không đổi pixel nào":*
+  (a) gemsite `app/globals.css` có 3 luật họ hero-split (`.gem-hero-split__option`, `__option-arrow`, `__playpause`) đọc
+  `var(--gem-motion-fast, 0.2s)`. Từ gemsite #854 (thang vào `:root` của store) transition của chúng (hover, nền, viền, và nhấn
+  `:active` của nút play) chạy 100ms thay 200ms, và 1ms khi người xem giảm chuyển động hoặc preset `motion_level: "none"`.
+  Component phát ba lớp đó (24 hero của gemsite #150) đã xoá ở gemsite #688, nên ba luật là CSS chết: đề xuất xoá.
+  (b) Bí danh motion tra theo slug: plan viết `easing_soft` / `ambient_slow` / `Enter` trước đây ra biến không ai đọc, nay ra
+  `--gem-ease-soft` / `--gem-ambient-slow` / `--gem-ease-enter` mà luật `[data-gem-ambient]` đọc, tức là có tác dụng. Chưa plan
+  nào trong các repo viết kiểu đó. Hai gap của bộ interaction "Gọn"
   (Lily 08/10/2026) mà kho đang chép tay vào từng mục:
   (1) **Thang chuyển động (#32).** `createGemTokenCss` luôn phát `--gem-motion-fast` 100ms, `-base` 180ms, `-slow` 260ms,
   `--gem-ease-enter` / `--gem-ease-exit`, `--gem-motion-distance` 8px, `-distance-lg` 16px, `-stagger` 30ms, `-blur` 8px

package/dist/SOURCE.json

@@ -1,7 +1,7 @@
 {
   "package": "@gemboss/gem-framework",
-  "version": "0.15.0",
-  "gemtheme_sha": "c69c7c6e8d2c2dcf1543170990f6a644805c4dd8",
+  "version": "0.16.1",
+  "gemtheme_sha": "d9398bcf426b33f3c3b8b0cd4865d4f051b2c358",
   "gemtheme_dirty": false,
-  "framework_version": "0.15.0"
+  "framework_version": "0.16.1"
 }

package/dist/index.js

@@ -280,7 +280,7 @@ function gemButtonGradientEndCss(accent = "var(--gem-color-accent)", accentText
 }
 
 // ../../packages/gem-framework/src/tokens.ts
-var gemFrameworkVersion = "0.15.0";
+var gemFrameworkVersion = "0.16.1";
 var GEM_FOCUS_RING_CSS_VAR = "--gem-focus-ring: 2px solid var(--gem-color-accent);";
 var GEM_TAP_MIN_CSS_VAR = "--gem-tap-min: 44px;";
 var GEM_FOCUS_OFFSET_CSS_VAR = "--gem-focus-offset: 3px;";

package/dist/section-gate.js

@@ -4813,14 +4813,15 @@ function layoutKnobCheck(tsx, knobExempt = /* @__PURE__ */ new Set()) {
 }
 function slotsReadBy(raw) {
   const source = raw.replace(/\/\*[\s\S]*?\*\//g, " ").replace(/(^|[^:])\/\/.*$/gm, "$1 ");
-  const names = /* @__PURE__ */ new Set(["slots"]);
-  for (const m of source.matchAll(/(?:const|let|var)\s+([A-Za-z_$][\w$]*)\s*=\s*(?:section\.)?content_slots\b/g)) names.add(m[1]);
-  const alt = [...names].map((n) => n.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|");
+  const aliases = /* @__PURE__ */ new Set(["slots"]);
+  for (const m of source.matchAll(/(?:const|let|var)\s+([A-Za-z_$][\w$]*)\s*(?::[^=;]+)?=\s*(?:[A-Za-z_$][\w$]*\??\.)*content_slots\b/g)) aliases.add(m[1]);
+  const esc = (n) => n.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const bag = `(?:(?<![\\w$.\\-/"'\`])(?:${[...aliases].map(esc).join("|")})|(?<![\\w$\\-/"'\`])content_slots)`;
   const keys = /* @__PURE__ */ new Set();
-  for (const m of source.matchAll(new RegExp(`(?:${alt})\\.([A-Za-z_][A-Za-z0-9_]*)`, "g"))) keys.add(m[1]);
-  for (const m of source.matchAll(new RegExp(`(?:${alt})\\[["']([^"']+)["']\\]`, "g"))) keys.add(m[1]);
+  for (const m of source.matchAll(new RegExp(`${bag}\\??\\.([A-Za-z_][A-Za-z0-9_]*)`, "g"))) keys.add(m[1]);
+  for (const m of source.matchAll(new RegExp(`${bag}\\??\\.?\\[["']([^"']+)["']\\]`, "g"))) keys.add(m[1]);
   const prefixes = [];
-  for (const m of source.matchAll(new RegExp("(?:" + alt + ")\\[`([^`]*)`\\]", "g"))) {
+  for (const m of source.matchAll(new RegExp(`${bag}\\??\\.?\\[\`([^\`]*)\`\\]`, "g"))) {
     const literal = m[1].split("${")[0];
     if (literal.length >= 3) prefixes.push(literal);
   }

package/dist/sections.js

@@ -82,8 +82,8 @@ function subscriptionPlans(allocations, basePrice) {
     if (!id || seen.has(id)) continue;
     const adjustments = Array.isArray(row?.priceAdjustments) ? row.priceAdjustments.filter(Boolean) : [];
     const first = adjustments[0];
-    const money = first?.perDeliveryPrice ?? first?.price ?? null;
-    const amount = adjustments.length ? num(money?.amount) : base > 0 ? base : null;
+    const money2 = first?.perDeliveryPrice ?? first?.price ?? null;
+    const amount = adjustments.length ? num(money2?.amount) : base > 0 ? base : null;
     if (amount === null) continue;
     seen.add(id);
     const cheaper = base > 0 && amount < base;
@@ -92,7 +92,7 @@ function subscriptionPlans(allocations, basePrice) {
       id,
       name: typeof row?.sellingPlan?.name === "string" && row.sellingPlan.name.trim() || "Subscription",
       amount,
-      currencyCode: typeof money?.currencyCode === "string" && money.currencyCode || void 0,
+      currencyCode: typeof money2?.currencyCode === "string" && money2.currencyCode || void 0,
       savingPct: Math.round(discountPct),
       discountPct,
       introOnly: adjustments.length > 1
@@ -153,10 +153,10 @@ function merge(runs) {
   }
   return out.length ? out : [{ text: "", marks: [] }];
 }
-function place(text, phrases) {
+function place(text2, phrases) {
   const taken = [];
   phrases.forEach((phrase, index) => {
-    for (let at = text.indexOf(phrase); at >= 0; at = text.indexOf(phrase, at + 1)) {
+    for (let at = text2.indexOf(phrase); at >= 0; at = text2.indexOf(phrase, at + 1)) {
       const end = at + phrase.length;
       if (!taken.some(([s, e]) => at < e && s < end)) {
         taken.push([at, end, index]);
@@ -166,8 +166,8 @@ function place(text, phrases) {
   });
   return taken;
 }
-function phraseMarkRuns(text, lists = {}) {
-  const copy = String(text ?? "");
+function phraseMarkRuns(text2, lists = {}) {
+  const copy = String(text2 ?? "");
   const n = copy.length;
   const marks = Array.from({ length: n });
   const hrefs = Array.from({ length: n });
@@ -207,10 +207,10 @@ var OPEN = [["***", ["bold", "italic"]], ["**", ["bold"]], ["==", ["highlight"]]
 var ESCAPABLE = "*_=!^[]()\\";
 var STAND_IN = 57344;
 var escapeMarkers = (src) => src.replace(/\\([*_=!^[\]()\\])/g, (_, c) => String.fromCharCode(STAND_IN + ESCAPABLE.indexOf(c)));
-var unescapeMarkers = (text) => text.replace(/[-]/g, (c) => ESCAPABLE[c.charCodeAt(0) - STAND_IN]);
+var unescapeMarkers = (text2) => text2.replace(/[-]/g, (c) => ESCAPABLE[c.charCodeAt(0) - STAND_IN]);
 function read(src, inherited, href, depth) {
   const out = [];
-  const at = (text, marks, h = href) => ({ text, marks: ordered(marks), ...h ? { href: h } : {} });
+  const at = (text2, marks, h = href) => ({ text: text2, marks: ordered(marks), ...h ? { href: h } : {} });
   let last = 0;
   for (const m of src.matchAll(INLINE)) {
     const i = m.index ?? 0;
@@ -235,10 +235,10 @@ function read(src, inherited, href, depth) {
   return out;
 }
 function inlineMarkRuns(src) {
-  const text = String(src ?? "");
-  const escapes = !/[\ue000-\ue009]/.test(text);
+  const text2 = String(src ?? "");
+  const escapes = !/[\ue000-\ue009]/.test(text2);
   const runs = [];
-  text.split("\n").forEach((line, i) => {
+  text2.split("\n").forEach((line, i) => {
     if (i) runs.push({ text: "\n", marks: [] });
     if (line.length > MAX_INLINE) return void runs.push({ text: line, marks: [] });
     const read1 = read(escapes ? escapeMarkers(line) : line, [], void 0, 0);
@@ -253,8 +253,118 @@ function markClassName(marks) {
 function inlineMarkText(src) {
   return inlineMarkRuns(src).map((r) => r.text).join("");
 }
+
+// ../../packages/gem-sections/src/card-price.ts
+function priceAmount(m) {
+  const a = m?.amount;
+  if (a == null || typeof a === "string" && !a.trim()) return NaN;
+  return typeof a === "number" || typeof a === "string" ? Number(a) : NaN;
+}
+var text = (v) => typeof v === "string" && v.trim() ? v : void 0;
+var finite = (n) => typeof n === "number" && Number.isFinite(n) ? n : void 0;
+var MONEY = /* @__PURE__ */ new Map();
+function money(n, currency) {
+  if (!Number.isFinite(n) || !currency) return void 0;
+  let format = MONEY.get(currency);
+  if (format === void 0) {
+    try {
+      format = new Intl.NumberFormat(void 0, { style: "currency", currency });
+    } catch {
+      format = null;
+    }
+    if (MONEY.size < 64) MONEY.set(currency, format);
+  }
+  return format ? format.format(n) : `${n.toFixed(2)} ${currency}`;
+}
+var WHOLE;
+var CENTS;
+function plain(n, cents = !Number.isInteger(n)) {
+  if (!Number.isFinite(n)) return void 0;
+  if (!cents) {
+    if (!WHOLE) WHOLE = new Intl.NumberFormat(void 0, { maximumFractionDigits: 0 });
+    return WHOLE.format(n);
+  }
+  if (!CENTS) CENTS = new Intl.NumberFormat(void 0, { minimumFractionDigits: 2, maximumFractionDigits: 2 });
+  return CENTS.format(n);
+}
+var SEP = "[,'\u2019 \\u00a0\\u2009\\u202f]";
+var SEPS = new RegExp(SEP, "g");
+var ONE_NUMBER = new RegExp(`^(\\D*)(\\d{1,3}(?:(?:${SEP}\\d{2})*(?:${SEP}\\d{3})+)?|\\d+)(\\.\\d{1,2})?(\\D*)$`);
+var MULTIPLIER = /^\s*(?:k|tr|triệu|nghìn|ngàn|m|mn|mio|b|bn)(?!\p{L})/iu;
+function priceTextAmount(value) {
+  const m = value ? ONE_NUMBER.exec(value.trim()) : null;
+  if (!m || /[.,]$/.test(m[1]) || new Set(m[2].replace(/\d/g, "")).size > 1 || MULTIPLIER.test(m[4])) return void 0;
+  return Number(m[2].replace(SEPS, "") + (m[3] ?? ""));
+}
+function startsWithFrom(value, label) {
+  if (typeof value !== "string") return false;
+  const head = value.trim().normalize("NFC").toLowerCase();
+  return [label, "from", "t\u1EEB"].some((w) => {
+    const t = String(w ?? "").trim().normalize("NFC").toLowerCase();
+    return Boolean(t) && head.startsWith(t) && !/^\p{L}/u.test(head.slice(t.length));
+  });
+}
+var NUMBER_RUN = /\d(?:[\d.,'’    ]*\d)?/g;
+function readAlike(value) {
+  const runs = value.trim().match(NUMBER_RUN);
+  if (!runs || runs.length !== 1) return void 0;
+  const run = runs[0];
+  const tail = /^(.*)[.,](\d{1,2})$/.exec(run);
+  const n = Number(tail ? `${tail[1].replace(/\D/g, "")}.${tail[2]}` : run.replace(/\D/g, ""));
+  return Number.isFinite(n) ? { n, frame: value.trim().replace(run, "#") } : void 0;
+}
+function struckAbove(price, struck) {
+  const a = readAlike(price), b = readAlike(struck);
+  return a != null && b != null && a.frame === b.frame && b.n > a.n;
+}
+function cardPrice(product, fromLabel = "From") {
+  const p = product ?? {};
+  const seller = text(p.price);
+  const nodes = (Array.isArray(p.variants?.nodes) ? p.variants.nodes : []).filter((v) => v != null && typeof v === "object");
+  const sel = p.selectedVariant != null && typeof p.selectedVariant === "object" ? p.selectedVariant : void 0;
+  const at = sel ? nodes.findIndex((v) => sel.id != null && v.id === sel.id || nodes.length === 1 && (v.id == null || sel.id == null)) : -1;
+  const variants = at >= 0 ? nodes.map((v, i) => i === at ? { ...sel, ...v } : v) : sel ? [sel, ...nodes] : nodes;
+  const priced = variants.filter((v) => Number.isFinite(priceAmount(v.price)));
+  const amounts = priced.map((v) => priceAmount(v.price));
+  const min = p.priceRange?.minVariantPrice;
+  const minAmount = priceAmount(min);
+  const maxAmount = priceAmount(p.priceRange?.maxVariantPrice);
+  const lowest = Number.isFinite(minAmount) ? minAmount : amounts.length ? Math.min(...amounts) : finite(p.price) ?? NaN;
+  const code = (v) => text(v)?.trim();
+  const currency = code(min?.currencyCode) ?? priced.map((v) => code(v.price?.currencyCode)).find(Boolean);
+  const varies = p.priceVaries === true || Number.isFinite(lowest) && (amounts.some((a) => a !== lowest) || Number.isFinite(maxAmount) && maxAmount !== lowest);
+  const amount = finite(lowest) ?? priceTextAmount(seller);
+  const soldOut = p.soldOut === true || p.availableForSale === false || p.availableForSale !== true && variants.length > 0 && variants.every((v) => v.availableForSale === false);
+  const buyable = soldOut ? [] : variants.filter((v) => v.availableForSale !== false);
+  const atLowest = buyable.filter((v) => priceAmount(v.price) === lowest);
+  const discounted = atLowest.find((v) => priceAmount(v.compareAtPrice) > lowest);
+  const withId = (list) => list.find((v) => v.id != null);
+  const anyBuyable = priced.length === 0 ? withId(buyable) : void 0;
+  const base = { varies, amount, soldOut };
+  const formatted = money(lowest, currency);
+  if (formatted || Number.isFinite(lowest) && !seller) {
+    const cmp = discounted ? priceAmount(discounted.compareAtPrice) : NaN;
+    const cents = !Number.isInteger(lowest) || Number.isFinite(cmp) && !Number.isInteger(cmp);
+    const show = (n) => money(n, currency) ?? plain(n, cents);
+    const variant = discounted ? discounted.id != null ? discounted : void 0 : withId(atLowest) ?? anyBuyable;
+    return { text: show(lowest), from: varies, compareAt: discounted ? show(cmp) : void 0, variant, ...base };
+  }
+  if (seller) {
+    const named = priceTextAmount(seller) === lowest ? withId(atLowest) : void 0;
+    const struck = text(p.compareAtPrice);
+    return {
+      text: seller,
+      from: p.priceVaries === true && !startsWithFrom(seller, fromLabel),
+      compareAt: !soldOut && struck && struckAbove(seller, struck) ? struck : void 0,
+      variant: named ?? anyBuyable,
+      ...base
+    };
+  }
+  return { from: false, variant: anyBuyable, ...base };
+}
 export {
   MARK_KINDS,
+  cardPrice,
   defaultPlan,
   elementOverrides,
   imageSrcSet,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gemboss/gem-framework",
-  "version": "0.15.0",
+  "version": "0.16.1",
   "description": "gem-framework của GemTheme (CSS, runtime, token, bộ kiểm) cộng đúng bộ kiểm section gemtheme dùng khi duyệt. Build từ gemtheme, không sửa ở đây.",
   "type": "module",
   "main": "./dist/index.js",