@eintrek/erp-shell 0.1.73 → 0.1.74

package/README.md

@@ -176,6 +176,44 @@ progress API: `API.md` next to it.
   shell's adapters), `guide-ui.tsx`, `guide-styles.ts`. Tests:
   `src/guide/*.test.ts`.
 
+### 0.1.74
+
+Page guides ("คู่มือหน้านี้", guides round 4; authors:
+`_claude-work/guides-r4/GUIDE-PAGES.md`).
+
+- `GuideSuite.pages?: GuidePage[]`: a read-only walk through one page,
+  `view` and `click` steps only (a page guide with a `commit`, `input` or
+  `select` step is dropped, with a warning in development). It runs as a
+  replay of a synthetic mission `page:<key>`, so it never writes tour
+  progress. `when` names an anchor that must be on screen (sub-screens on
+  one URL); the most specific match wins (`when`, then `?k=v` constraints,
+  then static segments), and only if it is this person's (`visible`,
+  `requires`).
+- Progress: one row per page per user, `<app>.page.<key>`, written once —
+  when the first-visit offer is answered or ignored, or when the guide
+  ends (finished: completed; not now, exited, left: skipped). Opened again
+  from "?", it writes nothing. Read from the same `GET …/guides/me` answer.
+- Switch: platform-api's `pages_mode` (`guides.<app>.pages` = off | menu |
+  offer, default off) and `page_audience` (every member while not off). In
+  `menu` mode nothing is offered by itself; in `offer` mode a small card
+  ("คู่มือหน้านี้ · <title> · n ขั้น", เริ่ม / ไม่ตอนนี้) appears once on a
+  first visit, when nothing else is up and the welcome is not due there. An
+  API without the fields means off.
+- The "?" menu: "คู่มือหน้านี้", "ไกด์เริ่มต้น n/N", "คู่มือทุกหน้า",
+  "ติดต่อทีมช่วยเหลือ", each only when it has something
+  (`guideMenuItems`). The panel gains a second section, "คู่มือแต่ละหน้า"
+  (ดูแล้ว / ใหม่), and shows it alone when the person has no missions.
+- A page guide's bubble: "คู่มือหน้านี้ · <title>", ย้อนกลับ on read steps,
+  "เสร็จ" on the last, "ปิดคู่มือ" to leave (silently, as leaving the page
+  does). Finishing says "จบคู่มือหน้านี้".
+- Missions keep precedence: a mission start ends a page guide, the welcome
+  replaces an offer (unrecorded), a page guide never starts over a step.
+- `config.pagesReady` holds page guides apart from the missions' `ready`.
+- For apps with their own "?" (LIFF): `usePageGuideEntry()` →
+  `{ title, open } | null`, `openPageGuide()`, `openPagesPanel()`,
+  `usePageGuides()`, from both entries.
+- `guideMenuShown(entry, pages?)` is no longer a type guard.
+
 ### 0.1.73
 
 - `GuideStep.status`: a short status line in the bubble while it returns