@gemboss/gem-framework 0.14.0 → 0.15.0

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` | 4 hàm `headless.tsx` được import (`elementOverrides`, `imageSrcSet`, `subscriptionPlans`, `defaultPlan`) | `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` | `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,29 @@ Từ 0.8.2 mỗi module có `.d.ts` cạnh nó (`mount(root?: ParentNode | null,
 
 ## Nhật ký thay đổi
 
+- **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
+  lời khách; 29% store advertorial dẫn đi mua bằng link trong đoạn), mà element `text` / `heading` chỉ đậm được, và ba section
+  của kho mỗi cái chép một bộ đọc dấu riêng.
+  - `…/sections` (và `@gemtheme/gem-sections`): `inlineMarkRuns(chuỗi)` đọc `**đậm**`, `*nghiêng*`, `***đậm nghiêng***`,
+    `__gạch chân__`, `==tô sáng==`, `^^đậm màu nhấn^^`, `!!màu cảnh báo!!`, `[link](url)`, lồng được hai chiều (đậm trong
+    nghiêng, nghiêng trong đậm). Dấu chỉ mở / đóng sát chữ (không sát khoảng trắng), nên dấu câu thường giữ nguyên ("Hurry!!
+    Only 3 left!!", "^^", "a == b"); `__` không mở giữa từ (URL `a__b__c`); `\` giữ ký tự dấu nguyên văn; đọc từng dòng (dấu không
+    vắt qua xuống dòng), một dòng dài hơn 20.000 ký tự vẽ trơn; tuyến tính trên chuỗi xấu (dấu `[` lặp, đậm không đóng). `phraseMarkRuns(chữ,
+    { bold, italic, underline, highlight, accent, alert, links })` là cách của element: chữ vẫn trơn, mỗi dấu là danh sách
+    cụm từ (mỗi dòng một cụm, đặt ở chỗ xuất hiện ĐẦU TIÊN không chồng cụm cùng dấu, đúng luật `bold` đang dùng nên
+    `{ bold }` vẽ y như trước), link là dòng `cụm | url`. Cả hai trả về DỮ LIỆU (đoạn chữ + dấu + href), người gọi tự vẽ
+    `strong` / `em` / `span.gem-mark--…` / `a.gem-mark-link`: gói không kéo React, không chèn HTML; link chỉ giữ http(s),
+    đường dẫn trong site và #neo. `markClassName(marks)`, `inlineMarkText(chuỗi)` (chữ bỏ dấu), `safeMarkHref`.
+  - CSS (`GEM_INLINE_MARK_CSS`, trong `createPrimitiveCss`): `.gem-mark--underline`, `--highlight` (bút dạ: nền
+    `--gem-mark-highlight` #fff1a6, mực `--gem-mark-highlight-ink` #1f1d18, đọc được cả trên băng tối), `--accent`, `--alert`
+    (`--gem-color-danger`) trong `:where()` (độ ưu tiên 0: section muốn dáng riêng tự đè); `.gem-mark-link` (màu nhấn, gạch
+    chân) là một lớp thường, vì `a { color: inherit }` của framework và gemsite thắng mọi thứ trong `:where()`; link nằm
+    trong / chứa tô sáng giữ mực của bút dạ. Sáu lớp khai
+    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"
   (Lily 08/10/2026) mà kho đang chép tay vào từng mục:

package/dist/SOURCE.json

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

package/dist/gem-framework.css

@@ -1123,6 +1123,14 @@ a {
 :where(img[data-gem-bound-img-in][data-gem-img-in-state='loading']) { filter: blur(var(--gem-motion-blur, 8px)); opacity: 0.6; }
 @media (prefers-reduced-motion: no-preference) { :where(img[data-gem-bound-img-in][data-gem-img-in-state='in']) { animation: gem-img-in var(--gem-motion-slow, 260ms) var(--gem-ease-enter, cubic-bezier(.33, 1, .68, 1)); } }
 @keyframes gem-img-in { from { filter: blur(var(--gem-motion-blur, 8px)); opacity: 0.6; } }
+:where(.gem-mark--underline) { text-decoration-line: underline; text-decoration-thickness: from-font; text-underline-offset: 0.18em; }
+:where(.gem-mark--highlight) { background: var(--gem-mark-highlight, #fff1a6); color: var(--gem-mark-highlight-ink, #1f1d18); padding-inline: 0.12em; border-radius: 0.15em; -webkit-box-decoration-break: clone; box-decoration-break: clone; }
+:where(.gem-mark--accent) { color: var(--gem-color-accent); }
+:where(.gem-mark--alert) { color: var(--gem-color-danger, #b42318); }
+:where(.gem-mark--highlight.gem-mark--accent), :where(.gem-mark--highlight.gem-mark--alert) { color: var(--gem-mark-highlight-ink, #1f1d18); }
+.gem-mark-link { color: var(--gem-color-accent); text-decoration-line: underline; text-decoration-thickness: from-font; text-underline-offset: 0.18em; }
+.gem-mark-link:hover { text-decoration-thickness: 2px; }
+.gem-mark-link.gem-mark--highlight, .gem-mark--highlight .gem-mark-link { color: var(--gem-mark-highlight-ink, #1f1d18); }
 @keyframes gem-float { 0%, 100% { transform: translateY(0); } 50% { transform: translateY(calc(-1 * var(--gem-ambient-amp, 7px))); } }
 @keyframes gem-sheen { 0%, 100% { opacity: 0.55; } 50% { opacity: 1; } }
 @keyframes gem-marquee-scroll { from { transform: translateX(0); } to { transform: translateX(-50%); } }

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.14.0";
+var gemFrameworkVersion = "0.15.0";
 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;";
@@ -941,7 +941,15 @@ var gemFrameworkPrimitiveGroups = [
       "gem-pull-quote",
       "gem-byline",
       "gem-disclaimer",
-      "gem-subhead"
+      "gem-subhead",
+      // Nhấn trong câu (gap #39): lớp @gemtheme/gem-sections inline-marks.ts bảo người gọi vẽ, GEM_INLINE_MARK_CSS tô.
+      // Không khai thì section vẽ đúng dấu của framework vẫn bị gem_framework_unknown_gem_class (review #740).
+      "gem-mark",
+      "gem-mark--underline",
+      "gem-mark--highlight",
+      "gem-mark--accent",
+      "gem-mark--alert",
+      "gem-mark-link"
     ]
   },
   {
@@ -1583,6 +1591,19 @@ var GEM_IMG_IN_CSS_LINES = [
   "@keyframes gem-img-in { from { filter: blur(var(--gem-motion-blur, 8px)); opacity: 0.6; } }"
 ];
 var GEM_IMG_IN_CSS = GEM_IMG_IN_CSS_LINES.join("\n");
+var GEM_INLINE_MARK_CSS_LINES = [
+  ":where(.gem-mark--underline) { text-decoration-line: underline; text-decoration-thickness: from-font; text-underline-offset: 0.18em; }",
+  ":where(.gem-mark--highlight) { background: var(--gem-mark-highlight, #fff1a6); color: var(--gem-mark-highlight-ink, #1f1d18); padding-inline: 0.12em; border-radius: 0.15em; -webkit-box-decoration-break: clone; box-decoration-break: clone; }",
+  ":where(.gem-mark--accent) { color: var(--gem-color-accent); }",
+  ":where(.gem-mark--alert) { color: var(--gem-color-danger, #b42318); }",
+  ":where(.gem-mark--highlight.gem-mark--accent), :where(.gem-mark--highlight.gem-mark--alert) { color: var(--gem-mark-highlight-ink, #1f1d18); }",
+  ".gem-mark-link { color: var(--gem-color-accent); text-decoration-line: underline; text-decoration-thickness: from-font; text-underline-offset: 0.18em; }",
+  ".gem-mark-link:hover { text-decoration-thickness: 2px; }",
+  // Bút dạ thắng màu link: chữ trên nền vàng giữ mực đậm, dù span nằm trong link hay link nằm trong span (review #740 đo màu nhấn
+  // trên vàng 4,32:1 ở nền trắng, 2,47:1 trên băng tối, 1,05:1 trên băng màu nhấn).
+  ".gem-mark-link.gem-mark--highlight, .gem-mark--highlight .gem-mark-link { color: var(--gem-mark-highlight-ink, #1f1d18); }"
+];
+var GEM_INLINE_MARK_CSS = GEM_INLINE_MARK_CSS_LINES.join("\n");
 var GEM_AMBIENT_CSS_LINES = [
   "@keyframes gem-float { 0%, 100% { transform: translateY(0); } 50% { transform: translateY(calc(-1 * var(--gem-ambient-amp, 7px))); } }",
   "@keyframes gem-sheen { 0%, 100% { opacity: 0.55; } 50% { opacity: 1; } }",
@@ -2755,6 +2776,7 @@ function createPrimitiveCss() {
     "}",
     ...GEM_REVEAL_CSS_LINES,
     ...GEM_IMG_IN_CSS_LINES,
+    ...GEM_INLINE_MARK_CSS_LINES,
     ...GEM_AMBIENT_CSS_LINES,
     ...GEM_DIVIDER_CSS_LINES,
     ...GEM_CARD_CSS_LINES,
@@ -7412,6 +7434,7 @@ export {
   GEM_GRID_COLUMNS_ROW_KNOB_CSS,
   GEM_HEADING_SIZE_CSS_VARS,
   GEM_IMG_IN_CSS,
+  GEM_INLINE_MARK_CSS,
   GEM_LINE_HEIGHT_TOKEN_KEYS,
   GEM_MOTION_REDUCED,
   GEM_MOTION_SCALE_DEFAULTS,

package/dist/primitives.css

@@ -1032,6 +1032,14 @@ a {
 :where(img[data-gem-bound-img-in][data-gem-img-in-state='loading']) { filter: blur(var(--gem-motion-blur, 8px)); opacity: 0.6; }
 @media (prefers-reduced-motion: no-preference) { :where(img[data-gem-bound-img-in][data-gem-img-in-state='in']) { animation: gem-img-in var(--gem-motion-slow, 260ms) var(--gem-ease-enter, cubic-bezier(.33, 1, .68, 1)); } }
 @keyframes gem-img-in { from { filter: blur(var(--gem-motion-blur, 8px)); opacity: 0.6; } }
+:where(.gem-mark--underline) { text-decoration-line: underline; text-decoration-thickness: from-font; text-underline-offset: 0.18em; }
+:where(.gem-mark--highlight) { background: var(--gem-mark-highlight, #fff1a6); color: var(--gem-mark-highlight-ink, #1f1d18); padding-inline: 0.12em; border-radius: 0.15em; -webkit-box-decoration-break: clone; box-decoration-break: clone; }
+:where(.gem-mark--accent) { color: var(--gem-color-accent); }
+:where(.gem-mark--alert) { color: var(--gem-color-danger, #b42318); }
+:where(.gem-mark--highlight.gem-mark--accent), :where(.gem-mark--highlight.gem-mark--alert) { color: var(--gem-mark-highlight-ink, #1f1d18); }
+.gem-mark-link { color: var(--gem-color-accent); text-decoration-line: underline; text-decoration-thickness: from-font; text-underline-offset: 0.18em; }
+.gem-mark-link:hover { text-decoration-thickness: 2px; }
+.gem-mark-link.gem-mark--highlight, .gem-mark--highlight .gem-mark-link { color: var(--gem-mark-highlight-ink, #1f1d18); }
 @keyframes gem-float { 0%, 100% { transform: translateY(0); } 50% { transform: translateY(calc(-1 * var(--gem-ambient-amp, 7px))); } }
 @keyframes gem-sheen { 0%, 100% { opacity: 0.55; } 50% { opacity: 1; } }
 @keyframes gem-marquee-scroll { from { transform: translateX(0); } to { transform: translateX(-50%); } }

package/dist/section-gate.js

@@ -746,7 +746,15 @@ var gemFrameworkPrimitiveGroups = [
       "gem-pull-quote",
       "gem-byline",
       "gem-disclaimer",
-      "gem-subhead"
+      "gem-subhead",
+      // Nhấn trong câu (gap #39): lớp @gemtheme/gem-sections inline-marks.ts bảo người gọi vẽ, GEM_INLINE_MARK_CSS tô.
+      // Không khai thì section vẽ đúng dấu của framework vẫn bị gem_framework_unknown_gem_class (review #740).
+      "gem-mark",
+      "gem-mark--underline",
+      "gem-mark--highlight",
+      "gem-mark--accent",
+      "gem-mark--alert",
+      "gem-mark-link"
     ]
   },
   {
@@ -1244,6 +1252,19 @@ var GEM_IMG_IN_CSS_LINES = [
   "@keyframes gem-img-in { from { filter: blur(var(--gem-motion-blur, 8px)); opacity: 0.6; } }"
 ];
 var GEM_IMG_IN_CSS = GEM_IMG_IN_CSS_LINES.join("\n");
+var GEM_INLINE_MARK_CSS_LINES = [
+  ":where(.gem-mark--underline) { text-decoration-line: underline; text-decoration-thickness: from-font; text-underline-offset: 0.18em; }",
+  ":where(.gem-mark--highlight) { background: var(--gem-mark-highlight, #fff1a6); color: var(--gem-mark-highlight-ink, #1f1d18); padding-inline: 0.12em; border-radius: 0.15em; -webkit-box-decoration-break: clone; box-decoration-break: clone; }",
+  ":where(.gem-mark--accent) { color: var(--gem-color-accent); }",
+  ":where(.gem-mark--alert) { color: var(--gem-color-danger, #b42318); }",
+  ":where(.gem-mark--highlight.gem-mark--accent), :where(.gem-mark--highlight.gem-mark--alert) { color: var(--gem-mark-highlight-ink, #1f1d18); }",
+  ".gem-mark-link { color: var(--gem-color-accent); text-decoration-line: underline; text-decoration-thickness: from-font; text-underline-offset: 0.18em; }",
+  ".gem-mark-link:hover { text-decoration-thickness: 2px; }",
+  // Bút dạ thắng màu link: chữ trên nền vàng giữ mực đậm, dù span nằm trong link hay link nằm trong span (review #740 đo màu nhấn
+  // trên vàng 4,32:1 ở nền trắng, 2,47:1 trên băng tối, 1,05:1 trên băng màu nhấn).
+  ".gem-mark-link.gem-mark--highlight, .gem-mark--highlight .gem-mark-link { color: var(--gem-mark-highlight-ink, #1f1d18); }"
+];
+var GEM_INLINE_MARK_CSS = GEM_INLINE_MARK_CSS_LINES.join("\n");
 var GEM_AMBIENT_CSS_LINES = [
   "@keyframes gem-float { 0%, 100% { transform: translateY(0); } 50% { transform: translateY(calc(-1 * var(--gem-ambient-amp, 7px))); } }",
   "@keyframes gem-sheen { 0%, 100% { opacity: 0.55; } 50% { opacity: 1; } }",
@@ -2409,6 +2430,7 @@ function createPrimitiveCss() {
     "}",
     ...GEM_REVEAL_CSS_LINES,
     ...GEM_IMG_IN_CSS_LINES,
+    ...GEM_INLINE_MARK_CSS_LINES,
     ...GEM_AMBIENT_CSS_LINES,
     ...GEM_DIVIDER_CSS_LINES,
     ...GEM_CARD_CSS_LINES,

package/dist/sections.js

@@ -104,9 +104,164 @@ function defaultPlan(plans) {
   if (!plans.length) return null;
   return plans.reduce((best, p) => p.amount < best.amount ? p : best, plans[0]);
 }
+
+// ../../packages/gem-sections/src/inline-marks.ts
+var MARK_KINDS = ["bold", "italic", "underline", "highlight", "accent", "alert"];
+var MAX_PHRASES = 12;
+var MAX_PHRASE = 160;
+var MAX_DEPTH = 3;
+var MAX_INLINE = 2e4;
+function safeMarkHref(href) {
+  if (typeof href !== "string") return void 0;
+  const h = href.trim();
+  return /^(https?:\/\/[^\s\\"<>]+|\/(?![/\\])[^\s\\"<>]*|#[^\s\\"<>]*)$/i.test(h) ? h : void 0;
+}
+function markPhrases(value) {
+  const raw = Array.isArray(value) ? value : typeof value === "string" ? value.split("\n") : [];
+  return raw.filter((p) => typeof p === "string").map((p) => p.trim()).filter((p) => p && p.length <= MAX_PHRASE).slice(0, MAX_PHRASES);
+}
+function linkPhrases(value) {
+  const raw = Array.isArray(value) ? value : typeof value === "string" ? value.split("\n") : [];
+  const out = [];
+  for (const item of raw) {
+    let phrase, href;
+    if (typeof item === "string") {
+      const at = item.lastIndexOf("|");
+      if (at < 0) continue;
+      phrase = item.slice(0, at);
+      href = item.slice(at + 1);
+    } else if (item && typeof item === "object") {
+      phrase = item.text;
+      href = item.href;
+    }
+    const p = typeof phrase === "string" ? phrase.trim() : "";
+    const h = safeMarkHref(href);
+    if (p && p.length <= MAX_PHRASE && h) out.push({ phrase: p, href: h });
+    if (out.length >= MAX_PHRASES) break;
+  }
+  return out;
+}
+var sameMarks = (a, b) => a.href === b.href && a.marks.length === b.marks.length && a.marks.every((m, i) => m === b.marks[i]);
+var ordered = (marks) => MARK_KINDS.filter((k) => new Set(marks).has(k));
+function merge(runs) {
+  const out = [];
+  for (const r of runs) {
+    if (!r.text) continue;
+    const last = out[out.length - 1];
+    if (last && sameMarks(last, r)) last.text += r.text;
+    else out.push({ text: r.text, marks: [...r.marks], ...r.href ? { href: r.href } : {} });
+  }
+  return out.length ? out : [{ text: "", marks: [] }];
+}
+function place(text, phrases) {
+  const taken = [];
+  phrases.forEach((phrase, index) => {
+    for (let at = text.indexOf(phrase); at >= 0; at = text.indexOf(phrase, at + 1)) {
+      const end = at + phrase.length;
+      if (!taken.some(([s, e]) => at < e && s < end)) {
+        taken.push([at, end, index]);
+        break;
+      }
+    }
+  });
+  return taken;
+}
+function phraseMarkRuns(text, lists = {}) {
+  const copy = String(text ?? "");
+  const n = copy.length;
+  const marks = Array.from({ length: n });
+  const hrefs = Array.from({ length: n });
+  let any = false;
+  for (const kind of MARK_KINDS) {
+    for (const [s, e] of place(copy, markPhrases(lists[kind]))) {
+      for (let i = s; i < e; i++) (marks[i] ??= /* @__PURE__ */ new Set()).add(kind);
+      any = true;
+    }
+  }
+  const links = linkPhrases(lists.links);
+  for (const [s, e, index] of place(copy, links.map((l) => l.phrase))) {
+    for (let i = s; i < e; i++) hrefs[i] = links[index].href;
+    any = true;
+  }
+  if (!any) return [{ text: copy, marks: [] }];
+  const runs = [];
+  for (let i = 0; i < n; i++) runs.push({ text: copy[i], marks: ordered(marks[i] ?? []), ...hrefs[i] ? { href: hrefs[i] } : {} });
+  return merge(runs);
+}
+var NS = "(?=[^\\s*])";
+var NE = "(?<=[^\\s*])";
+var INLINE = new RegExp(
+  [
+    "\\[[^\\[\\]\\n]+\\]\\((?:[^()\\s]|\\([^()\\s]*\\))+\\)",
+    `\\*\\*\\*${NS}[^*\\n]+?${NE}\\*\\*\\*(?!\\*)`,
+    `\\*\\*${NS}(?:[^*\\n]|\\*\\*\\*[^*\\n]+?\\*\\*\\*|\\*(?!\\*))+?${NE}\\*\\*(?!\\*)|\\*\\*${NS}[^*\\n]*?\\*${NS}[^*\\n]+?${NE}\\*\\*\\*(?!\\*)`,
+    `\\*${NS}(?:[^*\\n]|\\*\\*\\*[^*\\n]+?\\*\\*\\*|\\*\\*[^*\\n]+?\\*\\*)+?${NE}\\*(?!\\*)`,
+    "==(?=[^\\s=])[^=\\n]+?(?<=[^\\s=])==",
+    "(?<![\\p{L}\\p{N}_])__(?=[^\\s_])[^_\\n]+?(?<=[^\\s_])__(?![\\p{L}\\p{N}_])",
+    "!!(?=[^\\s!])[^!\\n]+?(?<=[^\\s!])!!",
+    "\\^\\^(?=[^\\s^])[^\\^\\n]+?(?<=[^\\s^])\\^\\^"
+  ].join("|"),
+  "gu"
+);
+var OPEN = [["***", ["bold", "italic"]], ["**", ["bold"]], ["==", ["highlight"]], ["__", ["underline"]], ["!!", ["alert"]], ["^^", ["bold", "accent"]], ["*", ["italic"]]];
+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]);
+function read(src, inherited, href, depth) {
+  const out = [];
+  const at = (text, marks, h = href) => ({ text, marks: ordered(marks), ...h ? { href: h } : {} });
+  let last = 0;
+  for (const m of src.matchAll(INLINE)) {
+    const i = m.index ?? 0;
+    if (i > last) out.push(at(src.slice(last, i), inherited));
+    const tok = m[0];
+    if (tok.startsWith("[")) {
+      const lm = /^\[([^\]]+)\]\((.+)\)$/.exec(tok);
+      const safe = lm && !href ? safeMarkHref(unescapeMarkers(lm[2])) : void 0;
+      if (lm && safe && depth < MAX_DEPTH) out.push(...read(lm[1], inherited, safe, depth + 1));
+      else out.push(at(lm ? lm[1] : tok, inherited));
+    } else {
+      const [open, add] = OPEN.find(([o]) => tok.startsWith(o) && tok.endsWith(o) && tok.length > 2 * o.length) ?? OPEN.find(([o]) => tok.startsWith(o) && tok.length > 2 * o.length) ?? ["", []];
+      const close = tok.endsWith(open) ? open.length : 0;
+      const inner = open ? tok.slice(open.length, tok.length - close) : tok;
+      const marks = [...inherited, ...add];
+      if (open && depth < MAX_DEPTH) out.push(...read(inner, marks, href, depth + 1));
+      else out.push(at(open ? inner : tok, marks));
+    }
+    last = i + tok.length;
+  }
+  if (last < src.length) out.push(at(src.slice(last), inherited));
+  return out;
+}
+function inlineMarkRuns(src) {
+  const text = String(src ?? "");
+  const escapes = !/[\ue000-\ue009]/.test(text);
+  const runs = [];
+  text.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);
+    runs.push(...escapes ? read1.map((r) => ({ ...r, text: unescapeMarkers(r.text) })) : read1);
+  });
+  return merge(runs);
+}
+function markClassName(marks) {
+  const span = marks.filter((m) => m !== "bold" && m !== "italic");
+  return span.length ? ["gem-mark", ...span.map((m) => `gem-mark--${m}`)].join(" ") : "";
+}
+function inlineMarkText(src) {
+  return inlineMarkRuns(src).map((r) => r.text).join("");
+}
 export {
+  MARK_KINDS,
   defaultPlan,
   elementOverrides,
   imageSrcSet,
+  inlineMarkRuns,
+  inlineMarkText,
+  markClassName,
+  phraseMarkRuns,
+  safeMarkHref,
   subscriptionPlans
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gemboss/gem-framework",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "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",