@eintrek/erp-shell 0.1.72 → 0.1.74

package/README.md

@@ -176,6 +176,60 @@ 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
+  text, read again on every page change. A select step names a wrong pick
+  ("ยังไม่ใช่ชื่อคุณ") instead of waiting in silence (owner, 3 Nov 2026:
+  Plannex's managers step, someone else picked, nothing moved).
+- In a replay (ทบทวน), a select step offers ถัดไป when the next step's target
+  is already on the page (a form's save button), so a review never has to
+  change a real record to go on. Not while the next target needs the pick
+  (Plannex's save shows only once the user is a manager). First runs are
+  unchanged.
+- The "?" button opens the help dialog straight away, without the
+  "ไกด์เริ่มต้น 0/0" row, when every mission is hidden for this user
+  (`guideMenuShown`). `useGuideEntry()` still answers `{ done, total }`;
+  an app's own entry row should hide at `total === 0` too.
+
 ### 0.1.72
 
 - "ขั้นที่ x/y" counts only the steps this person will see: a step whose