@eintrek/erp-shell 0.1.76 → 0.1.78

package/dist/guide/guide-ui.d.ts

@@ -100,6 +100,12 @@ export interface StepLayerProps {
         height: number;
         offsetTop: number;
     };
+    /**
+     * The app's content column (GuideConfig.contentRoot), already cut to the
+     * viewport: the bubble stays inside it (LIFF's 460 px column on a desktop).
+     * Shell ≥ 0.1.77. Omitted: the viewport.
+     */
+    bounds?: Rect | null;
     phone: boolean;
     showHand: boolean;
     bubble: BubbleModel;

package/dist/guide/machine.d.ts

@@ -62,6 +62,11 @@ export type GuideScreen = {
     section?: string;
     /** A flow's step: the flow key (the mission is `flow:<key>`). Shell ≥ 0.1.76. */
     flow?: string;
+    /** "ขั้นที่ no/total" as shown (GuideState.counter): never going down. Shell ≥ 0.1.77. */
+    pos?: {
+        no: number;
+        total: number;
+    };
 }
 /** The first-visit offer of this page's guide: a small card, not modal. */
  | {
@@ -129,6 +134,18 @@ export interface GuideState {
         mission: string;
         steps: number[];
     } | null;
+    /**
+     * The counter of the run being played (shell ≥ 0.1.77): the steps shown so
+     * far, and the total as last worked out and on which page. The total is
+     * worked out when a step is entered on a page it was not worked out on,
+     * and never goes down.
+     */
+    counter: {
+        mission: string;
+        shown: number[];
+        total: number;
+        path: string;
+    } | null;
 }
 /** The page-guide part of the state, from the progress answer. */
 export interface GuidePagesInit {
@@ -291,6 +308,21 @@ export type GuideAction = {
  | {
     type: "back";
 }
+/**
+ * Another tab took over (shell ≥ 0.1.78): stop here, silently — a running
+ * step, an offer, a card or the panel goes, nothing is written.
+ */
+ | {
+    type: "yield";
+}
+/** The server's rows, read again (another tab saved, or this tab took over). */
+ | {
+    type: "refresh";
+    progress: GuideProgress;
+    pages: Record<string, PageRow>;
+    sections?: Record<string, PageRow>;
+    flows?: Record<string, PageRow>;
+}
 /** A page row came back from the server. */
  | {
     type: "pageRow";
@@ -442,6 +474,14 @@ export declare function stepPosition(mission: GuideMission, index: number, env:
     no: number;
     total: number;
 };
+/**
+ * The steps after `index` this person will see, as far as can be known from
+ * here: on this page, everything is read (requires, skipIf, a click whose
+ * outcome already holds); on another page, a step whose showing depends on
+ * what is on that page (`skipIf`, `onMissing: "skip"`) is not counted until
+ * its page is reached.
+ */
+export declare function stepsAhead(mission: GuideMission, index: number, env: GuideEnv, context: Readonly<Record<string, string>>): number;
 /** A step entered now would pass at once: a click or select step whose route or visible outcome holds. */
 export declare function wouldAutoPass(step: GuideStep, env: GuideEnv): boolean;
 /** The steps of this mission that passed by themselves in this run. */
@@ -481,6 +521,14 @@ export declare function firstStepReady(suite: GuideSuite, pageKey: string, env:
  * route, a moment of nothing loading, the primary tab, not hidden.
  */
 export declare function pageOfferDue(state: GuideState, suite: GuideSuite, env: GuideEnv): string | null;
+/**
+ * Whether a row may be written now: none of this version yet, or — once —
+ * a skipped one that the person has now finished (skipped → completed,
+ * shell ≥ 0.1.77). A completed row is final; skipped again changes nothing.
+ */
+export declare function rowWritable(row: PageRow | undefined, version: number, status: "completed" | "skipped"): boolean;
+/** Whether a run should keep its row to write at its end: no row yet, or only a skipped one. */
+export declare function rowStillDue(row: PageRow | undefined, version: number): boolean;
 /** The section guide's row says this person has ended this version of it. */
 export declare function sectionRecorded(state: GuideState, section: {
     key: string;
@@ -517,4 +565,10 @@ export declare function backTarget(mission: GuideMission, index: number, env: Gu
     index: number;
     close: boolean;
 } | null;
+/**
+ * A flow's next step (the next one this person sees) when the person is on
+ * its page and no longer on the current step's: they moved on by
+ * themselves. -1 otherwise (still on this step's page, or elsewhere).
+ */
+export declare function flowStepArrivedAt(mission: GuideMission, index: number, env: GuideEnv, context: Readonly<Record<string, string>>): number;
 export declare function reduceGuide(state: GuideState, action: GuideAction, suite: GuideSuite, env: GuideEnv): GuideResult;

package/dist/guide/progress-sync.d.ts

@@ -13,6 +13,11 @@ import { type GuideProgress, type GuidesAnswer, type PageRow } from "./progress"
 export interface GuideProgressRequest {
     /** The suite's app ("peoplx", "liff"). */
     app: string;
+    /**
+     * fetchProgress only: another tab saved, or this tab is taking over — skip
+     * any cache and ask the server (shell ≥ 0.1.78).
+     */
+    fresh?: boolean;
     /** The suite's key, the row on the server ("liff.first-run"). */
     guideKey: string;
 }
@@ -59,7 +64,7 @@ export declare class GuideProgressConflict extends Error {
     constructor(current: unknown, code?: string);
 }
 /** The GET, parsed for this suite; null (show nothing) on any failure or odd answer. */
-export declare function loadGuides(adapter: GuideProgressAdapter, suite: GuideSuite, signal?: AbortSignal): Promise<GuidesAnswer | null>;
+export declare function loadGuides(adapter: GuideProgressAdapter, suite: GuideSuite, signal?: AbortSignal, fresh?: boolean): Promise<GuidesAnswer | null>;
 /**
  * PUT the whole state. On 409 the server's row comes back: merge (keeping
  * whatever is further along) and try once more with its rev. Returns the

package/dist/guide/types.d.ts

@@ -542,4 +542,10 @@ export interface GuideConfig {
      * `module.accounting` is known). Shell ≥ 0.1.74.
      */
     pagesReady?: boolean;
+    /**
+     * A selector for the app's content column (LIFF's centred 460 px
+     * `MobileShell` on a desktop): bubbles stay inside it. Omitted: the
+     * viewport. Shell ≥ 0.1.77.
+     */
+    contentRoot?: string;
 }

package/dist/guide-core.cjs

@@ -1,7 +1,7 @@
 'use client';
 'use strict';
 
-var format = require('./chunks/format-BVoVc7Yk.cjs');
+var format = require('./chunks/format-BmTSD3DB.cjs');
 require('react/jsx-runtime');
 require('react');
 require('react-dom');

package/dist/guide-core.esm.js

@@ -1,5 +1,5 @@
 'use client';
-export { A as GUIDE_API_EVENT, G as GUIDE_EVENT_PREFIX, a as GUIDE_LAYER_ATTRIBUTE, c as GuideProgressConflict, d as GuideRuntime, S as SectionGuideButton, T as THAI_MONTHS_SHORT, e as apiCallDetail, f as emitGuideEvent, g as fillRoute, h as formatBaht, i as guideAnchor, j as guideMenuItems, k as guideMenuShown, l as loadGuides, m as matchApiPath, n as matchRoute, o as openFlow, p as openFlowsPanel, q as openGuidePanel, r as openPageGuide, s as openPagesPanel, t as openSectionGuide, u as reportApiCall, v as reportApiEvent, w as setSectionGuideValues, x as storeGuides, y as thaiMonth, z as thaiMonthYear, B as useGuideEntry, C as usePageGuideEntry, D as usePageGuides, E as useSectionGuideValues } from './chunks/format-BWUKNKxg.esm.js';
+export { A as GUIDE_API_EVENT, G as GUIDE_EVENT_PREFIX, a as GUIDE_LAYER_ATTRIBUTE, c as GuideProgressConflict, d as GuideRuntime, S as SectionGuideButton, T as THAI_MONTHS_SHORT, e as apiCallDetail, f as emitGuideEvent, g as fillRoute, h as formatBaht, i as guideAnchor, j as guideMenuItems, k as guideMenuShown, l as loadGuides, m as matchApiPath, n as matchRoute, o as openFlow, p as openFlowsPanel, q as openGuidePanel, r as openPageGuide, s as openPagesPanel, t as openSectionGuide, u as reportApiCall, v as reportApiEvent, w as setSectionGuideValues, x as storeGuides, y as thaiMonth, z as thaiMonthYear, B as useGuideEntry, C as usePageGuideEntry, D as usePageGuides, E as useSectionGuideValues } from './chunks/format-Wgj2sKpK.esm.js';
 import 'react/jsx-runtime';
 import 'react';
 import 'react-dom';

package/dist/index.cjs

@@ -14,7 +14,7 @@ var Link = require('next/link');
 var reactDom = require('react-dom');
 var nextThemes = require('next-themes');
 var axios = require('axios');
-var format = require('./chunks/format-BVoVc7Yk.cjs');
+var format = require('./chunks/format-BmTSD3DB.cjs');
 var reactQueryDevtools = require('@tanstack/react-query-devtools');
 require('@floating-ui/dom');
 
@@ -1740,7 +1740,7 @@ function platformApiBase(app) {
  * This package's version, attached to help messages so the back office can
  * tell which shell a report came from. Keep in step with package.json.
  */
-const SHELL_VERSION = "0.1.76";
+const SHELL_VERSION = "0.1.78";
 
 const HELP_APP_LABEL = {
     platform: "แพลตฟอร์ม",
@@ -3658,7 +3658,8 @@ function GuideHostInner({ config, organizationId, code }) {
             fetchProgress: req => client.fetchQuery({
                 queryKey: ["erp-shell", "guides", organizationId, suite.app, suite.key, suite.version],
                 queryFn: ({ signal }) => platform.fetchProgress({ ...req, signal }).catch(() => null),
-                staleTime: 5 * 60000,
+                // Fresh after another tab saved (0.1.78); otherwise kept 5 minutes.
+                staleTime: req.fresh ? 0 : 5 * 60000,
                 gcTime: 30 * 60000,
                 retry: false,
             }),