@eintrek/erp-shell 0.1.74 → 0.1.76

package/README.md

@@ -176,6 +176,56 @@ progress API: `API.md` next to it.
   shell's adapters), `guide-ui.tsx`, `guide-styles.ts`. Tests:
   `src/guide/*.test.ts`.
 
+### 0.1.76
+
+Workflow guides ("พาทำงาน", phase 2; authors: `_claude-work/guides-r4/GUIDE-PAGES.md` §11).
+
+- `GuideSuite.flows?: GuideFlow[]` (`key`, `version`, `title`, `minutes?`,
+  `visible`, `requires`, `startRoute`, `href?`, `transit?`, `offer?`,
+  `allowCommit?`, `steps`): one job across pages, its steps as a mission's
+  (`route`, checkpoints, ทำต่อ). Played as a replay: never in "ไกด์เริ่มต้น
+  n/N" or the welcome, never writing the tour's row.
+- Audience and switch as page guides (every member; `visible`/`requires`;
+  `guides.<app>.pages` not off).
+- "?" → "พาทำงาน" opens the panel's flows section (the flows this person
+  has); on a flow's start page "?" also has "พาทำ · <title>". Offered only
+  in `offer` mode, only flows with `offer: true`, on the start page, after
+  the missions and the page guide's offer, once.
+- One row per flow per person, `<app>.flow.<key>`, written once at the end
+  (finished: completed; exited, left, จบโดยไม่บันทึก: skipped).
+- The chain (start routes + steps' routes and route triggers + `transit`):
+  moving between its pages goes on; leaving it ends the flow silently. A
+  flow in progress survives a refresh in the same tab session (resumed at
+  its checkpoint), never across sessions.
+- Writes: view and click steps only unless `allowCommit: true`, and then
+  every commit step must name its `abort` (else the flow is dropped, with a
+  warning in development).
+
+### 0.1.75
+
+Section guides ("อธิบายส่วนนี้"; authors: `_claude-work/guides-r4/GUIDE-PAGES.md` §10).
+
+- `GuideSuite.sections?: GuideSection[]`: explains one section of a page
+  (a number-heavy card or table) row by row. View steps only (the default
+  kind here); a step may point at a row or cell (`targetId`). Tied to a
+  route and a root anchor: there only while the root is on screen, and it
+  ends when the root goes or the page is left.
+- Live values: the app hands its computed numbers to the guide with
+  `useSectionGuideValues(key, values)` or `<SectionGuideButton guideKey
+  values />`; step `title`/`why` read `ctx.values`. The latest render wins,
+  so a page that re-renders mid-guide never leaves an old number. A step
+  lists what it uses in `needs` and is skipped while one is missing (also
+  when its title comes out empty). `formatBaht`, `thaiMonth`,
+  `thaiMonthYear` for the copy.
+- Entry points: `<SectionGuideButton guideKey />` (a small "?" for the
+  section header, drawn only while the guide is there for this person) and
+  "?" → "อธิบายส่วนนี้ · <title>" for every section guide on screen. Never
+  offered by itself, in any mode; not in the panel's list.
+- Progress: one row per section guide per person, `<app>.section.<key>`,
+  written once, as page rows. Same switch and audience as page guides.
+- Fix: "ขั้นที่ x/y" no longer counts a click step that passes by itself
+  (its outcome already on screen): Plannex's overview said 1/9, then 3/9.
+
 ### 0.1.74
 
 Page guides ("คู่มือหน้านี้", guides round 4; authors: