plotcoder-board 0.1.17 → 0.1.19

package/src/board/reducer.d.ts

@@ -83,6 +83,8 @@ export type BoardNote = {
   payoffBoardId: string | null;
   /** Where the scene happens (R37): a phrase in the writer's words; empty until set. */
   location: string;
+  /** When the scene happens, as the writer says it — "night", "day four, dawn" — printed after the place on the heading (R55). Empty when unsaid. */
+  when: string;
   /** The scene's text in Fountain (R23 b): action, cues, dialogue; empty until written. */
   text: string;
   createdAt: string;
@@ -128,6 +130,8 @@ export type LeftQuestion = {
   /** The question's words when it was left; it comes back when they would differ. */
   text: string;
   since: string;
+  /** The writer's reason, when they gave one. */
+  why?: string;
 };
 
 export type Pose = { id: string; x: number; y: number; rotate: number };
@@ -155,9 +159,10 @@ export type Command =
       characterIds?: string[];
       plants?: boolean;
       location?: string;
+      when?: string;
       text?: string;
     }
-  | { type: "update_note"; id: string; headline?: string; change?: string; location?: string }
+  | { type: "update_note"; id: string; headline?: string; change?: string; location?: string; when?: string }
   | { type: "move_note"; id: string; x: number; y: number }
   | { type: "nudge_notes"; ids: string[]; dx: number; dy: number }
   | { type: "recolor_notes"; ids: string[]; color: NoteColor }
@@ -181,13 +186,14 @@ export type Command =
   | { type: "set_plant"; ids: string[]; plants: boolean }
   | { type: "set_payoff_board"; ids: string[]; boardId: string | null }
   | { type: "set_location"; ids: string[]; location: string }
+  | { type: "set_when"; ids: string[]; when: string }
   | { type: "apply_template"; template: string; beats?: Array<{ name: string; prompt: string; at: number }> }
   | { type: "set_text"; id: string; text: string }
   | { type: "lock_numbers"; order?: string[] }
   | { type: "unlock_numbers" }
   | { type: "start_revision"; name: string; color?: string }
   | { type: "end_revision" }
-  | { type: "leave_question"; kind: string; ids: string[]; text: string }
+  | { type: "leave_question"; kind: string; ids: string[]; text: string; why?: string }
   | { type: "ask_again"; kind: string; ids?: string[] };
 
 export type CommandResult = {

package/src/board/reducer.js

@@ -245,6 +245,7 @@ export function seedState(now = nowIso()) {
     lengthEighths: null,
     characterIds,
     location: "",
+    when: "",
     text: "",
     plants: false,
     // A fold that pays off on another board — a later episode — names it here;
@@ -347,6 +348,8 @@ export function normalizeState(value) {
     const payoffBoardId = plants && typeof note?.payoffBoardId === "string" && note.payoffBoardId ? note.payoffBoardId : null;
     // Cards written before R37 have no place; a scene is nowhere until it is.
     const location = typeof note?.location === "string" ? note.location : "";
+    // Cards written before R55 have no when; a scene is at no time until it is.
+    const when = typeof note?.when === "string" ? note.when : "";
     // Cards written before pages (R23 b) have no text; a scene is unwritten until it is.
     const text = typeof note?.text === "string" ? note.text : "";
     if (
@@ -358,12 +361,13 @@ export function normalizeState(value) {
       note.plants === plants &&
       note.payoffBoardId === payoffBoardId &&
       note.location === location &&
+      note.when === when &&
       note.text === text
     ) {
       return note;
     }
     patched = true;
-    return { ...note, rank, lengthEighths, characterIds, plants, payoffBoardId, location, text };
+    return { ...note, rank, lengthEighths, characterIds, plants, payoffBoardId, location, when, text };
   });
 
   // Boards written before the production half (Roadmap 2, item 8) have no
@@ -414,6 +418,11 @@ function bump(note, patch, now) {
   return { ...note, ...patch, updatedAt: now };
 }
 
+/** A when as the writer typed it, one line, spaces collapsed. */
+function cleanWhen(value) {
+  return typeof value === "string" ? value.trim().replace(/\s+/g, " ") : "";
+}
+
 function pruneGroups(groups) {
   return groups.filter((group) => group.noteIds.length >= 2);
 }
@@ -445,6 +454,7 @@ export function applyCommand(state, command, now = nowIso()) {
         plants: command.plants === true,
         payoffBoardId: null,
         location: cleanPlace(command.location),
+        when: cleanWhen(command.when),
         text: typeof command.text === "string" ? command.text : "",
         z: maxZ(state.notes) + 1,
         createdAt: now,
@@ -465,6 +475,7 @@ export function applyCommand(state, command, now = nowIso()) {
         if (command.headline !== undefined) patch.headline = command.headline;
         if (command.change !== undefined) patch.change = command.change;
         if (command.location !== undefined) patch.location = cleanPlace(command.location);
+        if (command.when !== undefined) patch.when = cleanWhen(command.when);
         updated = bump(note, patch, now);
         return updated;
       });
@@ -581,7 +592,17 @@ export function applyCommand(state, command, now = nowIso()) {
       const headlineOf = (id) => state.notes.find((note) => note.id === id)?.headline ?? id;
       const notes = state.notes.filter((note) => note.id !== command.id);
       const taken = state.arrows.filter((arrow) => arrow.from === command.id || arrow.to === command.id);
-      const arrows = state.arrows.filter((arrow) => !taken.includes(arrow));
+      let arrows = state.arrows.filter((arrow) => !taken.includes(arrow));
+      // A card wired into a chain — one follows in, one follows out — leaves
+      // the chain joined behind it, as move_scene does; undo takes the join
+      // back with the card (round fourteen, entry 20).
+      const ins = taken.filter((arrow) => arrow.kind !== "setup" && arrow.to === command.id);
+      const outs = taken.filter((arrow) => arrow.kind !== "setup" && arrow.from === command.id);
+      let joined = null;
+      if (ins.length === 1 && outs.length === 1 && ins[0].from !== outs[0].to && !arrows.some((arrow) => arrow.from === ins[0].from && arrow.to === outs[0].to)) {
+        joined = { id: newId(), from: ins[0].from, to: outs[0].to, kind: "follows" };
+        arrows = [...arrows, joined];
+      }
       const left = [];
       const groups = pruneGroups(
         state.groups.map((group) => {
@@ -600,6 +621,7 @@ export function applyCommand(state, command, now = nowIso()) {
           id: command.id,
           headline: gone.headline,
           arrows: taken.map((arrow) => ({ ...arrow, fromHeadline: headlineOf(arrow.from), toHeadline: headlineOf(arrow.to) })),
+          joined: joined ? { ...joined, fromHeadline: headlineOf(joined.from), toHeadline: headlineOf(joined.to) } : null,
           groups: left,
         },
       };
@@ -608,13 +630,17 @@ export function applyCommand(state, command, now = nowIso()) {
     case "apply_poses": {
       const byId = new Map(command.poses.map((pose) => [pose.id, pose]));
       if (byId.size === 0) return { state, changed: false };
+      // Only a card that actually moves is touched, so a tidy that leaves a
+      // card where it was does not stamp it (round fourteen, entry 43).
+      let moved = 0;
       const notes = state.notes.map((note) => {
         const pose = byId.get(note.id);
-        return pose
-          ? bump(note, { x: pose.x, y: pose.y, rotate: pose.rotate }, now)
-          : note;
+        if (!pose || (note.x === pose.x && note.y === pose.y && note.rotate === pose.rotate)) return note;
+        moved += 1;
+        return bump(note, { x: pose.x, y: pose.y, rotate: pose.rotate }, now);
       });
-      return { state: { ...state, notes }, changed: true };
+      if (moved === 0) return { state, changed: false };
+      return { state: { ...state, notes }, changed: true, result: { moved } };
     }
 
     case "settle_note": {
@@ -880,6 +906,7 @@ export function applyCommand(state, command, now = nowIso()) {
         plants: false,
         payoffBoardId: null,
         location: "",
+        when: "",
         text: "",
         createdAt: now,
         updatedAt: now,
@@ -949,7 +976,8 @@ export function applyCommand(state, command, now = nowIso()) {
       const ids = Array.isArray(command.ids) ? command.ids.filter((id) => typeof id === "string") : [];
       const text = typeof command.text === "string" ? command.text : "";
       if (!kind || !text) return { state, changed: false };
-      const entry = { kind, ids, text, since: now };
+      const why = typeof command.why === "string" ? command.why.trim() : "";
+      const entry = why ? { kind, ids, text, since: now, why } : { kind, ids, text, since: now };
       const rest = (state.left ?? []).filter((item) => !(item.kind === kind && sameIds(item.ids, ids)));
       return { state: { ...state, left: [...rest, entry] }, changed: true, result: entry };
     }
@@ -980,6 +1008,23 @@ export function applyCommand(state, command, now = nowIso()) {
       return { state: { ...state, notes }, changed: true, result: touched };
     }
 
+    // When a scene happens (R55): "night", "day four, dawn" — the writer's
+    // phrase, printed after the place on the scene heading; empty clears it.
+    case "set_when": {
+      const ids = new Set(command.ids);
+      if (ids.size === 0) return { state, changed: false };
+      const when = cleanWhen(command.when);
+      const touched = [];
+      const notes = state.notes.map((note) => {
+        if (!ids.has(note.id) || note.when === when) return note;
+        const next = bump(note, { when }, now);
+        touched.push(next);
+        return next;
+      });
+      if (touched.length === 0) return { state, changed: false };
+      return { state: { ...state, notes }, changed: true, result: touched };
+    }
+
     // Fold the corner (R31): this card plants something. A claim about the
     // card, like rank, so it never moves it and never touches its arrows.
     case "set_plant": {

package/src/board/words.js

@@ -165,7 +165,7 @@ export const WORD_GROUPS = [
       {
         id: "revisions",
         name: "Locked numbers, revisions",
-        sentence: "Once a draft goes out, scene numbers stop moving and changes print in a colour; a scene added after the lock keeps its own letter, 2A after 2. For after the writing.",
+        sentence: "Once a draft goes out, scene numbers stop moving and changes print in a colour with a star, on the page and in every export; a scene added after the lock has a letter, 2A after 2, that is its place between locked scenes and follows it if it moves. For after the writing.",
       },
     ],
   },

package/src/board/workflows.js

@@ -28,7 +28,7 @@ export const WORKFLOWS = [
       { question: "Which scenes are the turns?", hint: "Name them, or say \"propose them and I will strike\".", tool: "set_rank" },
       { question: "Does it have acts?", hint: "If so, where does each break fall?", tool: "create_group" },
       { question: "Where does each scene happen?", hint: "In your own words. A scene that moves through one location is still one place.", tool: "set_location" },
-      { question: "When does a scene happen, where that matters?", hint: "That night; the fourth of October. It goes in the headline for now.", tool: "the headline" },
+      { question: "When does a scene happen, where that matters?", hint: "That night; the fourth of October. It goes beside the place, never in the headline.", tool: "set_when" },
       { question: "Who is in each scene, and what do we call them?", hint: "A full name, or a role for someone unnamed — the man in 42. And who is only spoken of, never in a scene? They go in someone's notes, not the cast.", tool: "add_character, cast, update_character" },
       { question: "What is planted, and where does it pay off?", hint: "Name the episode when it pays off outside this one, so the fold is deliberate and the wall knows where to look.", tool: "set_plant with later, create_arrow" },
       { question: "Which scenes do you already know run long or short?", hint: "A day in the story is not a page count; leave the rest unsized.", tool: "set_length" },