@simon-says-build/demo-player 0.13.2 → 0.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simon-says-build/demo-player",
-  "version": "0.13.2",
+  "version": "0.14.0",
   "description": "SimonSays mobile demo player: walks a preview's viewer through a job's change, inside the app. Renders nothing unless the bundle carries a demo.",
   "repository": {
     "type": "git",

package/src/DemoHost.js

@@ -15,7 +15,7 @@
 import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { Linking, NativeModules, Platform, Settings, Pressable, ScrollView, StyleSheet, Text, TextInput, View, useWindowDimensions } from 'react-native';
 import { pageName } from './page-name.js';
-import { OVERLAY_ID, cardBox, pinnedBox, setTuckedDemo, overlayAnnounced, tapInside, currentDemo, demoConfig, findTarget, handlerFor, introBody, introOf, onDemo, phoneSteps, playDemo, releaseOf, reviewChangesOf, scalePoint, rescueNote, screenCandidates, stepTitle, targetOfKey } from './core.js';
+import { OVERLAY_ID, chapterOf, cardBox, pinnedBox, setTuckedDemo, overlayAnnounced, tapInside, currentDemo, demoConfig, findTarget, handlerFor, introBody, introOf, onDemo, phoneSteps, playDemo, releaseOf, reviewChangesOf, scalePoint, rescueNote, screenCandidates, stepTitle, targetOfKey } from './core.js';
 import { demoApi, tourOf } from './api.js';
 import { signInFirst, openInApp } from './signin.js';
 import { runEvent, fillStep } from './events.js';
@@ -311,6 +311,21 @@ function Player({ config, router, insets, onClose, children }) {
         actions: signIn ? [{ label: 'Hide', onPress: () => setTucked(true) }, { label: 'Try again', onPress: () => setSignInTry((n) => n + 1), primary: true }] : [],
       });
     }
+    // A PART'S TITLE CARD (0.14.0): the review moving to a different thing —
+    // its title, one line, centred, nothing ringed; Next carries on.
+    if (step.kind === 'chapter') {
+      const part = chapterOf(steps, index);
+      return h(Card, {
+        at: null, screen, insets, card, setCard, onCollapse: () => setTucked(true),
+        title: part ? `Part ${part.n} of ${part.of} · ${step.title}` : step.title,
+        body: step.caption,
+        actions: [
+          { label: 'Hide', onPress: () => setTucked(true) },
+          index > 0 && steps[index - 1].kind !== 'signin' ? { label: 'Back', onPress: () => setIndex(index - 1) } : null,
+          { label: index + 1 >= steps.length ? 'Finish' : 'Next', onPress: next, primary: true },
+        ].filter(Boolean),
+      });
+    }
     if (step.kind === 'try') {
       return h(React.Fragment, null,
         rect ? h(View, { pointerEvents: 'none', style: [s.ring, s.tryRing, { left: rect.left - 6, top: rect.top - 6, width: rect.width + 12, height: rect.height + 12 }] }) : null,

package/src/core.js

@@ -10,7 +10,7 @@ import { bubbleBox } from './step-place.js';
 // What this player is, said when the app registers for "Ready to see"
 // (packages/ssb-overlay sends it; functions/in-app-notify.mjs clientOf). Kept
 // equal to package.json by test/core.test.mjs.
-export const PLAYER_VERSION = '0.13.2';
+export const PLAYER_VERSION = '0.14.0';
 
 export const HOST = 5;
 export const TEXT = 6;
@@ -21,7 +21,7 @@ export const RECORDED_SCREEN = { width: 393, height: 852 };
 // What a phone can perform. `press` (a keyboard key), `select` (a web
 // <select>) and `run` (a terminal demo) have no phone equivalent. `signin` is
 // the player's own (tourOf, 0.6.0): sign this person in by link.
-const PHONE_KINDS = new Set(['say', 'goto', 'show', 'click', 'fill', 'signin', 'event', 'try']);
+const PHONE_KINDS = new Set(['say', 'goto', 'show', 'click', 'fill', 'signin', 'event', 'try', 'chapter']);
 
 const lower = (s) => String(s ?? '').trim().toLowerCase();
 const hiddenHost = (f) => {
@@ -153,6 +153,17 @@ export function scalePoint(point, screen, from = RECORDED_SCREEN) {
 }
 
 /** A step card's title: where it is in the demo, and whether SSB only set it up (a best-effort step: the state seeded and the screen opened, the change not driven). */
+/**
+ * Which part a step belongs to (0.14.0): parts start at each `chapter` step.
+ * → { n, of } (1-based) for a chapter step, or null when the tour has none. Pure.
+ */
+export function chapterOf(steps = [], index = 0) {
+  const at = steps.map((s, i) => (s?.kind === 'chapter' ? i : -1)).filter((i) => i >= 0);
+  if (!at.length) return null;
+  const n = at.filter((i) => i <= index).length;
+  return n ? { n, of: at.length } : null;
+}
+
 export function stepTitle(step, index, total) {
   return `${index + 1} of ${total}${step?.bestEffort === true ? ' · set up by SSB' : ''}`;
 }
@@ -210,7 +221,11 @@ let tuck = null;
 let overlayHere = false;
 export function setTuckedDemo(resume) { tuck = typeof resume === 'function' ? resume : null; }
 export const tuckedDemo = () => tuck;
-export function announceOverlay() { overlayHere = true; }
+// `on` (0.13.3): the overlay says so only while its button is DRAWN — it draws
+// none for a login SSB does not show it to (a review copy's cast), and a
+// collapsed review with no button and no pill could not be brought back
+// (Connie Ho's review on SSB's simulator, 2026-11-06).
+export function announceOverlay(on = true) { overlayHere = !!on; }
 export const overlayAnnounced = () => overlayHere;
 
 // A DEMO STARTED AT RUN TIME (2026-10-20, the in-app overlay's ▶ Demo, "Ready