waygraph 0.13.0 → 0.13.1

package/dist/cli.js

@@ -552,6 +552,9 @@ const RING_CSS =
   "#wg-todos .wg-todo-done{color:#6ee7b7;text-decoration:line-through;opacity:.85;}" +
   "#wg-todos .wg-todo-current{color:#fff;}" +
   "#wg-todos .wg-todo-pending{color:#9a7ad1;}" +
+  "#wg-todos[data-wg-todo-style=bullets] .wg-todo-pending," +
+  "#wg-todos[data-wg-todo-style=bullets] .wg-todo-current{color:#e8dcff;}" +
+  "#wg-todos[data-wg-todo-style=bullets] .wg-todo-mark{color:#c9a6ff;}" +
   "#wg-progress{height:4px;background:#2a1650;border-radius:2px;margin:0 0 12px;overflow:hidden;}" +
   "#wg-progress-bar{height:100%;background:#7C3AED;border-radius:2px;transition:width .3s ease;}" +
   // A real tab bar for episodes - the currently-active episode reads as
@@ -1196,21 +1199,39 @@ async function installOverlay(page, title) {
             return id ? ' data-wg-todo-item="' + esc(id) + '"' : "";
           };
           const renderItems = (items, style) => {
-            const st = style === "checklist" ? "checklist" : "sequential";
+            const rawStyle = String(style || "sequential").toLowerCase();
+            const st =
+              rawStyle === "checklist"
+                ? "checklist"
+                : rawStyle === "bullets" ||
+                    rawStyle === "bullet" ||
+                    rawStyle === "list" ||
+                    rawStyle === "ul" ||
+                    rawStyle === "points" ||
+                    rawStyle === "plain"
+                  ? "bullets"
+                  : "sequential";
             return (
               '<ul id="wg-todos" data-wg-todo-style="' +
               st +
               '">' +
               (items || [])
                 .map((t) => {
-                  const cls = t.current
-                    ? "wg-todo-current"
-                    : t.done
-                      ? "wg-todo-done"
-                      : "wg-todo-pending";
+                  const cls =
+                    st === "bullets"
+                      ? t.done
+                        ? "wg-todo-done"
+                        : "wg-todo-pending"
+                      : t.current
+                        ? "wg-todo-current"
+                        : t.done
+                          ? "wg-todo-done"
+                          : "wg-todo-pending";
                   let mark;
                   if (st === "checklist") {
                     mark = t.done ? "\u2611" : "\u2610";
+                  } else if (st === "bullets") {
+                    mark = "\u2022";
                   } else {
                     mark = t.done ? "\u2713" : t.current ? "\u2192" : "\u25CB";
                   }

package/dist/highlights.d.ts

@@ -51,8 +51,9 @@ export type WaygraphTodoInput = string | WaygraphTodoItem;
  * Dock list presentation:
  * - `sequential` - arrow on current, strike done (demo walkthrough)
  * - `checklist` - checkbox done/pending only (no current arrow; independent checks)
+ * - `bullets` - flat bullet list (no arrow/checkbox; open notes / trimmed dock)
  */
-export type TodoListStyle = "sequential" | "checklist";
+export type TodoListStyle = "sequential" | "checklist" | "bullets";
 /** One titled group in the floating todo dock (FR / Scenarios / ACs, etc.). */
 export type WaygraphTodoGroupInput = {
     /** Stable group id -> `data-wg-todo-group`. */
@@ -99,7 +100,7 @@ export type StubPhaseFixtures = {
      * (e.g. Mailhog -> back to app and still find the checklist).
      */
     todoId?: string;
-    /** `sequential` (default) or `checklist`. */
+    /** `sequential` (default), `checklist`, or `bullets`. */
     todoStyle?: TodoListStyle;
     /** Multiple titled lists (FR / Scenarios / ACs). Wins over bare todos when set. */
     todoGroups?: readonly WaygraphTodoGroupInput[];
@@ -280,8 +281,8 @@ export type StubCtx<Out extends Checkpoint<string> = Checkpoint<string>> = {
      */
     todoId(id: string): void;
     /**
-     * Dock presentation: `sequential` (arrow walkthrough) or `checklist`
-     * (independent checkboxes, no current arrow).
+     * Dock presentation: `sequential` (arrow walkthrough), `checklist`
+     * (independent checkboxes), or `bullets` (flat • list, no progress marks).
      */
     todoStyle(style: TodoListStyle): void;
     /**
@@ -510,7 +511,8 @@ export declare function normalizeTodoPos(raw: unknown): "left" | "right" | undef
 export declare function normalizeTodoStyle(raw: unknown): TodoListStyle | undefined;
 /**
  * Normalize checklist rows; apply todoIndex for sequential done/current.
- * In checklist mode, todoIndex is ignored unless items omit explicit done.
+ * In checklist / bullets mode, todoIndex is ignored unless items omit explicit done
+ * (bullets never auto-mark current).
  */
 export declare function normalizeTodos(todos: readonly WaygraphTodoInput[] | undefined, todoIndex?: number, style?: TodoListStyle): WaygraphTodoItem[];
 /** Build the floating dock from bag / phase fields. */
@@ -540,13 +542,13 @@ export declare function applyTodoPhase(prev: TodoDockState | undefined, phase: {
     sync: "set" | "clear" | "keep";
 };
 /**
- * Advance every sequential group to `index` (capped). Checklist groups unchanged.
+ * Advance every sequential group to `index` (capped). Checklist / bullets unchanged.
  * Used while cycling rings / fill/click stubs so the walkthrough moves.
  */
 export declare function advanceTodoDock(dock: TodoDockState | undefined, index: number): TodoDockState | undefined;
 /**
  * Mark sequential groups complete (all done, none current) - e.g. end of step.
- * Checklist groups keep explicit done flags.
+ * Checklist / bullets groups keep explicit done flags.
  */
 export declare function completeSequentialTodoDock(dock: TodoDockState | undefined): TodoDockState | undefined;
 /**

package/dist/highlights.js

@@ -495,11 +495,20 @@ export function normalizeTodoStyle(raw) {
         return "sequential";
     if (s === "checklist" || s === "check" || s === "checks" || s === "box")
         return "checklist";
+    if (s === "bullets" ||
+        s === "bullet" ||
+        s === "list" ||
+        s === "ul" ||
+        s === "points" ||
+        s === "plain") {
+        return "bullets";
+    }
     return undefined;
 }
 /**
  * Normalize checklist rows; apply todoIndex for sequential done/current.
- * In checklist mode, todoIndex is ignored unless items omit explicit done.
+ * In checklist / bullets mode, todoIndex is ignored unless items omit explicit done
+ * (bullets never auto-mark current).
  */
 export function normalizeTodos(todos, todoIndex, style = "sequential") {
     if (!todos || todos.length === 0)
@@ -523,6 +532,11 @@ export function normalizeTodos(todos, todoIndex, style = "sequential") {
             item.current = false;
             return item;
         }
+        if (style === "bullets") {
+            // Flat list: no walkthrough current; keep explicit done if authored.
+            item.current = false;
+            return item;
+        }
         if (idx !== undefined) {
             if (item.done === undefined)
                 item.done = i < idx;
@@ -606,7 +620,7 @@ export function applyTodoPhase(prev, phase) {
     return { dock: prev, sync: "keep" };
 }
 /**
- * Advance every sequential group to `index` (capped). Checklist groups unchanged.
+ * Advance every sequential group to `index` (capped). Checklist / bullets unchanged.
  * Used while cycling rings / fill/click stubs so the walkthrough moves.
  */
 export function advanceTodoDock(dock, index) {
@@ -636,7 +650,7 @@ export function advanceTodoDock(dock, index) {
 }
 /**
  * Mark sequential groups complete (all done, none current) - e.g. end of step.
- * Checklist groups keep explicit done flags.
+ * Checklist / bullets groups keep explicit done flags.
  */
 export function completeSequentialTodoDock(dock) {
     if (!dock)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "waygraph",
-  "version": "0.13.0",
+  "version": "0.13.1",
   "type": "module",
   "description": "A typed graph of reusable Blocks for driving a browser through E2E flows.",
   "license": "MIT",