@ykurilov/agent-chat-flows 0.75.0 → 0.76.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @ykurilov/agent-chat-flows
 
+## 0.76.0
+
+### Minor Changes
+
+- 6a50705: Общие переходы `anyState` перенесены из служебной ноды в отдельную панель настроек сценария. Шапка, меню телефона и обзор дают явный доступ; правила показывают условие и цель, сохраняют порядок, исключения и все настройки. Холст и мини-карта содержат только реальные состояния; старый `layout["@any"]` сохраняется, но не влияет на место или масштаб. Замечания проверки ведут к разделу и фокусируют правило; `readOnly` оставляет просмотр без изменений.
+  
+  ### Как обновить приложение
+  
+  Обновите используемые пакеты SDK одной версией. `FlowEditor`/`FlowTestChat` с `tandemFlowEditorSkin` не требуют новых пропсов. JSON и runtime не меняются, удалять legacy-раскладку не требуется. Собственный скин может обработать необязательные `FlowHeaderProps.onOpenAnyState` и `FlowExitCardProps.summary`, а существующий слот обзора `sections` должен отображаться. Старый экспорт `FlowAnyStateNode` сохранён, доска его не вызывает. Проверьте компактную шапку, переход из замечаний при закрытом инспекторе и сохранение правил.
+
+### Patch Changes
+
+- @ykurilov/agent-chat-core@0.76.0
+  - @ykurilov/agent-chat-react@0.76.0
+
 ## 0.75.0
 
 ### Patch Changes

package/README.md

@@ -123,3 +123,7 @@ checks })`. Поля приложения для карточки и попут
 
 С 0.55 к версии 2 добавился таймер «наступил день N программы» (`{ "type": "timer", "from": "program_day", "day": 3 }`):
 выход в начале дня N, когда бы человек ни пришёл в ноду. SDK до 0.55 такой сценарий не откроет.
+
+### Общие переходы в редакторе
+
+С 0.76.0 `anyState` редактируется в панели «Общие переходы» рядом с холстом, а не отдельной нодой. В компактной шапке и на телефоне вход доступен через действия редактора. Порядок, условия, цели и исключения сохраняются в прежнем JSON; runtime не меняется. `readOnly` оставляет просмотр. Собственному скину доступны необязательные `FlowHeaderProps.onOpenAnyState` и `FlowExitCardProps.summary`; старый экспорт `FlowAnyStateNode` сохранён, но доской не используется.

package/dist/react.js

@@ -722,7 +722,7 @@ function useFlowLabels() {
 }
 
 // src/react/editor/flow-editor.tsx
-import { useMemo as useMemo4, useState as useState4 } from "react";
+import { useEffect as useEffect3, useMemo as useMemo4, useRef as useRef3, useState as useState4 } from "react";
 
 // src/react/editor/editor-model.ts
 function freeId(prefix, taken) {
@@ -884,7 +884,7 @@ function removeField(flow, list, fieldId) {
   };
 }
 function freeSpot(flow) {
-  const points = Object.values(flow.layout);
+  const points = flow.states.flatMap((state) => flow.layout[state.id] ? [flow.layout[state.id]] : []);
   if (points.length === 0) return { x: 80, y: 80 };
   return { x: Math.min(...points.map((point) => point.x)), y: Math.max(...points.map((point) => point.y)) + 240 };
 }
@@ -1036,6 +1036,10 @@ function useBoardSpace(props, editor) {
       toggleMinimap: () => remember("minimap", !minimapOpen),
       inspectorOpen,
       inspectorToggleable: !needed,
+      showInspector: () => {
+        if (inspector === "collapsible") setFollowed(true);
+        else remember("inspector", true);
+      },
       toggleInspector: () => {
         if (needed) return;
         if (inspector === "collapsible") setFollowed(!inspectorOpen);
@@ -1476,25 +1480,17 @@ function StateNodeView({ data }) {
     data.draggable ? /* @__PURE__ */ jsx(Handle, { type: "source", position: Position.Right, id: NEW_EXIT_HANDLE, className: "flow-board__new-exit" }) : null
   ] });
 }
-function AnyNodeView({ data }) {
-  const skin = useSkin();
-  return /* @__PURE__ */ jsxs(Fragment, { children: [
-    /* @__PURE__ */ jsx(skin.FlowAnyStateNode, { ...data.view, renderExitHandle: (exitId) => exitHandle(exitId, data.draggable) }),
-    data.draggable ? /* @__PURE__ */ jsx(Handle, { type: "source", position: Position.Right, id: NEW_EXIT_HANDLE, className: "flow-board__new-exit" }) : null
-  ] });
-}
 function EdgeView({ id, sourceX, sourceY, targetX, targetY, sourcePosition, targetPosition, data }) {
   const skin = useSkin();
   const [path, labelX, labelY] = getBezierPath({ sourceX, sourceY, sourcePosition, targetX, targetY, targetPosition });
   if (!data) return null;
   return /* @__PURE__ */ jsx(skin.FlowEdge, { ...data, edgeId: id, path, labelX, labelY });
 }
-var nodeTypes = { state: StateNodeView, any: AnyNodeView };
+var nodeTypes = { state: StateNodeView };
 var edgeTypes = { flow: EdgeView };
 function nodePosition(flow, nodeId, index) {
   const saved = flow.layout[nodeId];
   if (saved) return saved;
-  if (nodeId === ANY_STATE_LAYOUT_KEY) return { x: 40, y: -220 };
   return { x: 40 + index % 4 * 330, y: 40 + Math.floor(index / 4) * 260 };
 }
 function countFor(issues, match) {
@@ -1554,27 +1550,7 @@ function useBoardModel(editor) {
         }
       }
     }));
-    if (flow.anyState.exits.length > 0 || flow.anyState.except.length > 0 || flow.layout[ANY_STATE_LAYOUT_KEY]) {
-      nodes.push({
-        id: ANY_STATE_LAYOUT_KEY,
-        type: "any",
-        position: nodePosition(flow, ANY_STATE_LAYOUT_KEY, 0),
-        draggable: editable,
-        data: {
-          draggable: editable,
-          view: {
-            except: flow.anyState.except.map((id) => stateById(flow, id)?.title ?? id),
-            exits: exitRows(flow, catalog, flow.anyState.exits, issues, labels),
-            selected: selection.kind === "any",
-            dimmed: marks !== null,
-            issues: countFor(issues, (issue) => !issue.place.stateId && flow.anyState.exits.some((exit) => exit.id === issue.place.exitId)),
-            onSelect: () => selectable && select({ kind: "any" })
-          }
-        }
-      });
-    }
     const owners = [
-      { nodeId: ANY_STATE_LAYOUT_KEY, exits: flow.anyState.exits },
       ...flow.states.map((state) => ({ nodeId: state.id, exits: state.exits }))
     ];
     const edges = owners.flatMap(
@@ -1930,7 +1906,8 @@ function useFlowEditor(options) {
   );
   const goToIssue = useCallback3((issue) => {
     const { stateId, exitId, fieldId, sideTaskId } = issue.place;
-    if (stateId && flow.states.some((state) => state.id === stateId)) setSelection({ kind: "state", stateId, ...exitId ? { exitId } : {} });
+    if (issue.code === "unknown_except_state") setSelection({ kind: "any" });
+    else if (stateId && flow.states.some((state) => state.id === stateId)) setSelection({ kind: "state", stateId, ...exitId ? { exitId } : {} });
     else if (exitId && flow.anyState.exits.some((exit) => exit.id === exitId)) setSelection({ kind: "any", exitId });
     else if (sideTaskId) setSelection({ kind: "overview", sideTaskId });
     else if (fieldId) setSelection({ kind: "card" });
@@ -2098,6 +2075,10 @@ function FlowEditor({ skin, className, style, header: headerMode, legend, minima
       issues: editor.issueCount,
       onAddState: () => editor.addState(freeSpot(flow)),
       onOpenCard: () => editor.select({ kind: "card" }),
+      onOpenAnyState: () => {
+        editor.select({ kind: "any" });
+        space.showInspector();
+      },
       onOpenJson: editor.openJson,
       ...options.onSave && !editor.readOnly ? { onSave: () => void editor.save() } : {},
       saving: editor.saving,
@@ -2121,7 +2102,7 @@ function FlowEditor({ skin, className, style, header: headerMode, legend, minima
         {
           header,
           board: /* @__PURE__ */ jsx2(FlowBoard, { editor, skin, space }),
-          panel: space.inspectorOpen ? /* @__PURE__ */ jsx2(EditorPanel, { editor, skin, labels }) : null,
+          panel: space.inspectorOpen ? /* @__PURE__ */ jsx2(EditorPanel, { editor, skin, labels, onNavigate: space.showInspector }) : null,
           dialog: /* @__PURE__ */ jsx2(EditorDialog, { editor, skin }),
           ...space.header === "compact" ? { compact: true } : {},
           ...space.fullscreen ? { style: { height: "100%", minHeight: 0 } } : { ...className !== void 0 ? { className } : {}, ...style !== void 0 ? { style } : {} }
@@ -2171,10 +2152,12 @@ function ExitCards({ editor, skin, labels, owner }) {
   const targets = targetOptions(flow, labels, owner !== null);
   return /* @__PURE__ */ jsx2(Fragment2, { children: exits.map((exit, index) => {
     const fieldType = exit.when.type === "data" ? fieldById(flow, exit.when.field)?.field.type : void 0;
-    return /* @__PURE__ */ jsx2(
+    const summary = `${conditionText(flow, exit.when, labels, editor.catalog)} \u2192 ${targetTitle(flow, exit.to, labels) ?? labels.board.noTarget}`;
+    return /* @__PURE__ */ jsx2(ExitFocus, { label: summary, exitId: exit.id, selection: editor.selection, owner, children: /* @__PURE__ */ jsx2(
       skin.FlowExitCard,
       {
         exitId: exit.id,
+        ...owner === null ? { summary } : {},
         when: exit.when,
         to: exit.to,
         fields,
@@ -2189,11 +2172,20 @@ function ExitCards({ editor, skin, labels, owner }) {
         onMoveUp: () => editor.edit((current) => moveExit(current, owner, exit.id, -1)),
         onMoveDown: () => editor.edit((current) => moveExit(current, owner, exit.id, 1)),
         onDelete: () => editor.edit((current) => removeExit(current, owner, exit.id))
-      },
-      exit.id
-    );
+      }
+    ) }, exit.id);
   }) });
 }
+function ExitFocus({ label, exitId, selection, owner, children }) {
+  const ref = useRef3(null);
+  const focused = (selection.kind === "any" && owner === null || selection.kind === "state" && selection.stateId === owner) && selection.exitId === exitId;
+  useEffect3(() => {
+    if (!focused || !ref.current) return;
+    ref.current.scrollIntoView?.({ block: "nearest" });
+    ref.current.focus({ preventScroll: true });
+  }, [focused, selection]);
+  return /* @__PURE__ */ jsx2("div", { ref, role: "group", "aria-label": label, tabIndex: focused ? -1 : void 0, "data-flow-exit-focus": exitId, children });
+}
 function FieldRows({ editor, skin, list }) {
   const fields = editor.flow[list];
   return /* @__PURE__ */ jsx2(Fragment2, { children: fields.map((field, index) => /* @__PURE__ */ jsx2(
@@ -2212,15 +2204,18 @@ function FieldRows({ editor, skin, list }) {
     field.id
   )) });
 }
-function EditorPanel({ editor, skin, labels }) {
-  const panel = /* @__PURE__ */ jsx2(EditablePanel, { editor, skin, labels });
+function EditorPanel({ editor, skin, labels, onNavigate }) {
+  const panel = /* @__PURE__ */ jsx2(EditablePanel, { editor, skin, labels, onNavigate });
   if (!editor.readOnly || editor.mode !== "edit") return panel;
   return /* @__PURE__ */ jsx2("fieldset", { disabled: true, "data-flow-read-only": "", className: "m-0 flex min-h-0 min-w-0 flex-1 flex-col border-0 p-0", children: panel });
 }
-function EditablePanel({ editor, skin, labels }) {
+function EditablePanel({ editor, skin, labels, onNavigate }) {
   const { flow, selection } = editor;
   if (editor.mode === "check") {
-    return /* @__PURE__ */ jsx2(skin.FlowCheckPanel, { issues: editor.issues.map((issue) => ({ ...issue, onGo: () => editor.goToIssue(issue) })) });
+    return /* @__PURE__ */ jsx2(skin.FlowCheckPanel, { issues: editor.issues.map((issue) => ({ ...issue, onGo: () => {
+      editor.goToIssue(issue);
+      onNavigate();
+    } })) });
   }
   if (editor.mode === "run" && editor.simulation) return /* @__PURE__ */ jsx2(RunPanel, { editor, skin, labels });
   if (selection.kind === "state") {
@@ -2261,18 +2256,7 @@ function EditablePanel({ editor, skin, labels }) {
       state.id
     );
   }
-  if (selection.kind === "any") {
-    return /* @__PURE__ */ jsx2(
-      skin.FlowAnyStatePanel,
-      {
-        except: flow.anyState.except,
-        states: stateLinks(editor),
-        onExceptChange: (except) => editor.edit((current) => setExcept(current, except)),
-        exits: /* @__PURE__ */ jsx2(ExitCards, { editor, skin, labels, owner: null }),
-        onAddExit: (kind) => editor.edit((current) => addExit(current, null, kind).flow)
-      }
-    );
-  }
+  if (selection.kind === "any") return /* @__PURE__ */ jsx2(AnyStateSettings, { editor, skin, labels });
   if (selection.kind === "card") {
     return /* @__PURE__ */ jsx2(
       skin.FlowCardPanel,
@@ -2305,12 +2289,25 @@ function EditablePanel({ editor, skin, labels }) {
       states: stateLinks(editor),
       issues: editor.issueCount,
       sections: /* @__PURE__ */ jsxs2(Fragment2, { children: [
+        /* @__PURE__ */ jsx2("div", { style: { flex: "none" }, children: /* @__PURE__ */ jsx2(AnyStateSettings, { editor, skin, labels }) }),
         /* @__PURE__ */ jsx2(ScheduleSection, { editor, skin, labels }),
         /* @__PURE__ */ jsx2(SideTasksSection, { editor, skin, focused: selection.kind === "overview" ? selection.sideTaskId : void 0 })
       ] })
     }
   );
 }
+function AnyStateSettings({ editor, skin, labels }) {
+  return /* @__PURE__ */ jsx2(
+    skin.FlowAnyStatePanel,
+    {
+      except: editor.flow.anyState.except,
+      states: stateLinks(editor),
+      onExceptChange: (except) => editor.edit((current) => setExcept(current, except)),
+      exits: /* @__PURE__ */ jsx2(ExitCards, { editor, skin, labels, owner: null }),
+      onAddExit: (kind) => editor.edit((current) => addExit(current, null, kind).flow)
+    }
+  );
+}
 var SCHEDULE_ISSUES = /* @__PURE__ */ new Set(["night_before_day_start", "unknown_deadline_state", "day_frame_soft_after_hard"]);
 var isScheduleIssue = (issue) => SCHEDULE_ISSUES.has(issue.code) || issue.code === "empty_nudges" && !issue.place.stateId;
 function NudgesEditor({ skin, nudges, optional, onChange }) {
@@ -2502,15 +2499,15 @@ function EditorDialog({ editor, skin }) {
 }
 
 // src/react/client-card/use-client-card.ts
-import { useCallback as useCallback4, useEffect as useEffect3, useRef as useRef3, useState as useState5 } from "react";
+import { useCallback as useCallback4, useEffect as useEffect4, useRef as useRef4, useState as useState5 } from "react";
 function useClientCard(options) {
-  const latest = useRef3(options);
+  const latest = useRef4(options);
   latest.current = options;
   const [state, setState] = useState5("loading");
   const [entries, setEntries] = useState5([]);
   const [busy, setBusy] = useState5(/* @__PURE__ */ new Set());
   const [forgettingAll, setForgettingAll] = useState5(false);
-  const alive = useRef3(true);
+  const alive = useRef4(true);
   const load = useCallback4(async () => {
     setState("loading");
     try {
@@ -2522,7 +2519,7 @@ function useClientCard(options) {
       if (alive.current) setState("failed");
     }
   }, []);
-  useEffect3(() => {
+  useEffect4(() => {
     alive.current = true;
     void load();
     return () => {
@@ -2667,7 +2664,7 @@ function durationText2(ms, labels) {
 }
 
 // src/react/test-chat/use-flow-test-chat.ts
-import { useCallback as useCallback5, useEffect as useEffect4, useRef as useRef4, useState as useState6 } from "react";
+import { useCallback as useCallback5, useEffect as useEffect5, useRef as useRef5, useState as useState6 } from "react";
 var RUN_POLL_MS = 1e3;
 function runOf(run) {
   if (!run || typeof run.state !== "string") return null;
@@ -2685,7 +2682,7 @@ function useFlowTestChat(connection, flow) {
   const [failed, setFailed] = useState6(false);
   const [nothingScheduled, setNothingScheduled] = useState6(false);
   const [run, setRun] = useState6(null);
-  const latest = useRef4({ connection, flow, chatId });
+  const latest = useRef5({ connection, flow, chatId });
   latest.current = { connection, flow, chatId };
   const refresh = useCallback5(async (id) => {
     try {
@@ -2695,7 +2692,7 @@ function useFlowTestChat(connection, flow) {
       console.error("[flow] test chat: run not read", error);
     }
   }, []);
-  useEffect4(() => {
+  useEffect5(() => {
     if (!opened || chatId === null) return;
     void refresh(chatId);
     const timer = setInterval(() => void refresh(chatId), RUN_POLL_MS);
@@ -2793,7 +2790,18 @@ function useTestChatView() {
 function withTestChat(skin) {
   function Header(props) {
     const { controller } = useTestChatView();
-    return /* @__PURE__ */ jsx4(skin.FlowHeader, { ...props, onOpenTestChat: controller.open });
+    const openAnyState = props.onOpenAnyState;
+    return /* @__PURE__ */ jsx4(
+      skin.FlowHeader,
+      {
+        ...props,
+        onOpenTestChat: controller.open,
+        ...openAnyState ? { onOpenAnyState: () => {
+          controller.close();
+          openAnyState();
+        } } : {}
+      }
+    );
   }
   function Frame(props) {
     const { panel } = useTestChatView();