@capsuletech/web-editor-state 0.1.0

package/dist/ids.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Короткий случайный id для нод в дереве. По умолчанию 10 символов —
+ * collision-rate приемлемая для редактора. Не зависит от crypto — работает
+ * в любой среде, включая SSR-сборку.
+ */
+export declare const generateId: (length?: number) => string;
+export declare const ROOT_ID = "root";

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { EditorOpError, addNode, createEmptyTree, moveNode, removeNode, reorderChildren, updateNode, } from './operations';
+export { ROOT_ID, generateId } from './ids';
+export { createEditorSchema } from './schema';
+export type { ICreateEditorSchemaOptions } from './schema';
+export type { IAddNodePayload, IEditorContext, IEditorNode, IEditorTree, IMoveNodePayload, IRemoveNodePayload, IReorderChildrenPayload, IUpdateNodePayload, NodeId, } from './types';

package/dist/index.mjs

@@ -0,0 +1,211 @@
+import { canAcceptChild as w, getManifest as I } from "@capsuletech/manifests";
+const u = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789", y = (n = 10) => {
+  let o = "";
+  for (let t = 0; t < n; t++)
+    o += u[Math.floor(Math.random() * u.length)];
+  return o;
+}, f = "root";
+class c extends Error {
+  constructor(o) {
+    super(o), this.name = "EditorOpError";
+  }
+}
+const x = (n = "ui.Card") => ({
+  root: f,
+  nodes: {
+    [f]: {
+      id: f,
+      type: n,
+      parentId: null,
+      children: [],
+      props: {},
+      meta: {},
+      styles: {}
+    }
+  }
+}), p = (n) => ({
+  ...n,
+  children: [...n.children],
+  props: { ...n.props },
+  meta: { ...n.meta },
+  styles: { ...n.styles }
+}), a = (n, o) => {
+  const t = n.nodes[o];
+  if (!t) throw new c(`node "${o}" not found`);
+  return t;
+}, E = (n, o, t) => {
+  let e = t;
+  for (; e; ) {
+    if (e === o) return !0;
+    e = n.nodes[e]?.parentId ?? null;
+  }
+  return !1;
+}, m = (n, o, t) => t === void 0 || t < 0 || t >= n.length ? [...n, o] : [...n.slice(0, t), o, ...n.slice(t)], N = (n, o) => {
+  const t = a(n, o.parentId);
+  if (!w(t.type, o.type))
+    throw new c(
+      `node type "${t.type}" не принимает "${o.type}" как ребёнка`
+    );
+  const e = I(o.type), s = y(), r = {
+    id: s,
+    type: o.type,
+    parentId: t.id,
+    children: [],
+    props: { ...e?.defaultProps ?? {}, ...o.props ?? {} },
+    meta: { ...o.meta ?? {} },
+    styles: {}
+  }, d = p(t);
+  return d.children = m(d.children, s, o.index), {
+    nodeId: s,
+    tree: {
+      ...n,
+      nodes: {
+        ...n.nodes,
+        [s]: r,
+        [t.id]: d
+      }
+    }
+  };
+}, P = (n, o) => {
+  if (o.nodeId === n.root)
+    throw new c("root cannot be moved");
+  const t = a(n, o.nodeId), e = a(n, o.newParentId);
+  if (E(n, o.nodeId, o.newParentId))
+    throw new c("cannot move a node into its own subtree");
+  if (!w(e.type, t.type))
+    throw new c(
+      `node type "${e.type}" не принимает "${t.type}" как ребёнка`
+    );
+  const s = a(n, t.parentId), r = p(s);
+  r.children = r.children.filter((h) => h !== t.id);
+  const d = s.id === e.id, l = d ? r : p(e);
+  l.children = m(l.children, t.id, o.index);
+  const i = p(t);
+  return i.parentId = e.id, {
+    ...n,
+    nodes: {
+      ...n.nodes,
+      [t.id]: i,
+      [s.id]: r,
+      ...d ? {} : { [e.id]: l }
+    }
+  };
+}, g = (n, o) => {
+  if (o.nodeId === n.root)
+    throw new c("root cannot be removed");
+  const t = a(n, o.nodeId), e = a(n, t.parentId), s = /* @__PURE__ */ new Set(), r = [t.id];
+  for (; r.length; ) {
+    const i = r.pop();
+    if (s.has(i)) continue;
+    s.add(i);
+    const h = n.nodes[i];
+    h && r.push(...h.children);
+  }
+  const d = p(e);
+  d.children = d.children.filter((i) => i !== t.id);
+  const l = {};
+  for (const [i, h] of Object.entries(n.nodes))
+    s.has(i) || (l[i] = h);
+  return l[e.id] = d, { ...n, nodes: l };
+}, O = (n, o) => {
+  const t = a(n, o.nodeId), e = p(t);
+  return o.patch.props && (e.props = { ...e.props, ...o.patch.props }), o.patch.meta && (e.meta = { ...e.meta, ...o.patch.meta }), o.patch.styles && (e.styles = { ...e.styles, ...o.patch.styles }), {
+    ...n,
+    nodes: { ...n.nodes, [t.id]: e }
+  };
+}, v = (n, o) => {
+  const t = a(n, o.parentId), e = new Set(t.children), s = new Set(o.newOrder);
+  if (e.size !== s.size || [...e].some((d) => !s.has(d)))
+    throw new c(
+      "reorderChildren: newOrder должен содержать ровно тех же детей что и parent"
+    );
+  const r = p(t);
+  return r.children = [...o.newOrder], { ...n, nodes: { ...n.nodes, [t.id]: r } };
+}, S = (n = {}) => ({
+  initial: "idle",
+  context: {
+    tree: n.initialTree ?? x(n.rootType),
+    selectedId: null
+  },
+  states: {
+    idle: {
+      addNode: ({ target: t, store: e }) => {
+        const s = t.payload;
+        try {
+          const { tree: r, nodeId: d } = N(e.ctx.tree, s);
+          e.update({ tree: r, selectedId: d });
+        } catch (r) {
+          if (r instanceof c)
+            e.setErrors({ editor: r.message });
+          else
+            throw r;
+        }
+      },
+      moveNode: ({ target: t, store: e }) => {
+        const s = t.payload;
+        try {
+          const r = P(e.ctx.tree, s);
+          e.update({ tree: r });
+        } catch (r) {
+          if (r instanceof c)
+            e.setErrors({ editor: r.message });
+          else
+            throw r;
+        }
+      },
+      removeNode: ({ target: t, store: e }) => {
+        const s = t.payload;
+        try {
+          const r = g(e.ctx.tree, s), d = e.ctx.selectedId === s.nodeId ? null : e.ctx.selectedId;
+          e.update({ tree: r, selectedId: d });
+        } catch (r) {
+          if (r instanceof c)
+            e.setErrors({ editor: r.message });
+          else
+            throw r;
+        }
+      },
+      updateNode: ({ target: t, store: e }) => {
+        const s = t.payload;
+        try {
+          const r = O(e.ctx.tree, s);
+          e.update({ tree: r });
+        } catch (r) {
+          if (r instanceof c)
+            e.setErrors({ editor: r.message });
+          else
+            throw r;
+        }
+      },
+      reorderChildren: ({ target: t, store: e }) => {
+        const s = t.payload;
+        try {
+          const r = v(e.ctx.tree, s);
+          e.update({ tree: r });
+        } catch (r) {
+          if (r instanceof c)
+            e.setErrors({ editor: r.message });
+          else
+            throw r;
+        }
+      },
+      selectNode: ({ target: t, store: e }) => {
+        const s = t.payload;
+        e.update({ selectedId: s });
+      }
+    }
+  }
+});
+export {
+  c as EditorOpError,
+  f as ROOT_ID,
+  N as addNode,
+  S as createEditorSchema,
+  x as createEmptyTree,
+  y as generateId,
+  P as moveNode,
+  g as removeNode,
+  v as reorderChildren,
+  O as updateNode
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/ids.ts","../src/operations.ts","../src/schema.ts"],"sourcesContent":["const ALPHABET = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';\n\n/**\n * Короткий случайный id для нод в дереве. По умолчанию 10 символов —\n * collision-rate приемлемая для редактора. Не зависит от crypto — работает\n * в любой среде, включая SSR-сборку.\n */\nexport const generateId = (length = 10): string => {\n  let id = '';\n  for (let i = 0; i < length; i++) {\n    id += ALPHABET[Math.floor(Math.random() * ALPHABET.length)];\n  }\n  return id;\n};\n\nexport const ROOT_ID = 'root';\n","import { canAcceptChild, getManifest } from '@capsuletech/manifests';\nimport { ROOT_ID, generateId } from './ids';\nimport type {\n  IAddNodePayload,\n  IEditorNode,\n  IEditorTree,\n  IMoveNodePayload,\n  IRemoveNodePayload,\n  IReorderChildrenPayload,\n  IUpdateNodePayload,\n  NodeId,\n} from './types';\n\n/** Ошибка операции с понятным сообщением — Feature/Controller сможет показать юзеру. */\nexport class EditorOpError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'EditorOpError';\n  }\n}\n\n/** Пустое дерево с одним корнем (`Wrapper` или указанный тип). */\nexport const createEmptyTree = (rootType = 'ui.Card'): IEditorTree => ({\n  root: ROOT_ID,\n  nodes: {\n    [ROOT_ID]: {\n      id: ROOT_ID,\n      type: rootType,\n      parentId: null,\n      children: [],\n      props: {},\n      meta: {},\n      styles: {},\n    },\n  },\n});\n\nconst cloneNode = (n: IEditorNode): IEditorNode => ({\n  ...n,\n  children: [...n.children],\n  props: { ...n.props },\n  meta: { ...n.meta },\n  styles: { ...n.styles },\n});\n\nconst requireNode = (tree: IEditorTree, id: NodeId): IEditorNode => {\n  const n = tree.nodes[id];\n  if (!n) throw new EditorOpError(`node \"${id}\" not found`);\n  return n;\n};\n\n/** Глубже ли `descendantId` под `ancestorId`. Включая равенство. */\nconst isDescendantOrSelf = (\n  tree: IEditorTree,\n  ancestorId: NodeId,\n  descendantId: NodeId,\n): boolean => {\n  let cur: NodeId | null = descendantId;\n  while (cur) {\n    if (cur === ancestorId) return true;\n    cur = tree.nodes[cur]?.parentId ?? null;\n  }\n  return false;\n};\n\nconst insertAt = <T>(arr: T[], item: T, index?: number): T[] => {\n  if (index === undefined || index < 0 || index >= arr.length) return [...arr, item];\n  return [...arr.slice(0, index), item, ...arr.slice(index)];\n};\n\n/**\n * Добавить новую ноду к `parentId`. Валидирует:\n *  - parent существует;\n *  - parent не leaf (через манифест);\n *  - parent.accepts(type) (через манифест).\n *\n * Возвращает новое дерево + id созданной ноды.\n */\nexport const addNode = (\n  tree: IEditorTree,\n  payload: IAddNodePayload,\n): { tree: IEditorTree; nodeId: NodeId } => {\n  const parent = requireNode(tree, payload.parentId);\n  if (!canAcceptChild(parent.type, payload.type)) {\n    throw new EditorOpError(\n      `node type \"${parent.type}\" не принимает \"${payload.type}\" как ребёнка`,\n    );\n  }\n  const manifest = getManifest(payload.type);\n  const id = generateId();\n  const node: IEditorNode = {\n    id,\n    type: payload.type,\n    parentId: parent.id,\n    children: [],\n    props: { ...(manifest?.defaultProps ?? {}), ...(payload.props ?? {}) },\n    meta: { ...(payload.meta ?? {}) },\n    styles: {},\n  };\n  const nextParent = cloneNode(parent);\n  nextParent.children = insertAt(nextParent.children, id, payload.index);\n  return {\n    nodeId: id,\n    tree: {\n      ...tree,\n      nodes: {\n        ...tree.nodes,\n        [id]: node,\n        [parent.id]: nextParent,\n      },\n    },\n  };\n};\n\n/**\n * Переместить ноду. Запрещает:\n *  - перемещать root;\n *  - перемещать ноду внутрь себя/своих потомков;\n *  - перемещать в leaf или в parent, который не принимает этот тип.\n */\nexport const moveNode = (tree: IEditorTree, payload: IMoveNodePayload): IEditorTree => {\n  if (payload.nodeId === tree.root) {\n    throw new EditorOpError('root cannot be moved');\n  }\n  const node = requireNode(tree, payload.nodeId);\n  const newParent = requireNode(tree, payload.newParentId);\n  if (isDescendantOrSelf(tree, payload.nodeId, payload.newParentId)) {\n    throw new EditorOpError('cannot move a node into its own subtree');\n  }\n  if (!canAcceptChild(newParent.type, node.type)) {\n    throw new EditorOpError(\n      `node type \"${newParent.type}\" не принимает \"${node.type}\" как ребёнка`,\n    );\n  }\n  const oldParent = requireNode(tree, node.parentId!);\n  const nextOldParent = cloneNode(oldParent);\n  nextOldParent.children = nextOldParent.children.filter((c) => c !== node.id);\n\n  // Если parent тот же — сначала удаляем из старого, потом вставляем в новый\n  // (правильный индекс может «съехать» при том же родителе — calculate accordingly).\n  const isSameParent = oldParent.id === newParent.id;\n  const targetParent = isSameParent ? nextOldParent : cloneNode(newParent);\n  targetParent.children = insertAt(targetParent.children, node.id, payload.index);\n\n  const nextNode = cloneNode(node);\n  nextNode.parentId = newParent.id;\n\n  return {\n    ...tree,\n    nodes: {\n      ...tree.nodes,\n      [node.id]: nextNode,\n      [oldParent.id]: nextOldParent,\n      ...(isSameParent ? {} : { [newParent.id]: targetParent }),\n    },\n  };\n};\n\n/**\n * Удалить ноду и весь её subtree. Root удалить нельзя.\n */\nexport const removeNode = (tree: IEditorTree, payload: IRemoveNodePayload): IEditorTree => {\n  if (payload.nodeId === tree.root) {\n    throw new EditorOpError('root cannot be removed');\n  }\n  const node = requireNode(tree, payload.nodeId);\n  const parent = requireNode(tree, node.parentId!);\n\n  // Собираем все ноды subtree для удаления\n  const toDelete = new Set<NodeId>();\n  const stack: NodeId[] = [node.id];\n  while (stack.length) {\n    const id = stack.pop()!;\n    if (toDelete.has(id)) continue;\n    toDelete.add(id);\n    const n = tree.nodes[id];\n    if (n) stack.push(...n.children);\n  }\n\n  const nextParent = cloneNode(parent);\n  nextParent.children = nextParent.children.filter((c) => c !== node.id);\n\n  const nextNodes: Record<NodeId, IEditorNode> = {};\n  for (const [id, n] of Object.entries(tree.nodes)) {\n    if (!toDelete.has(id)) nextNodes[id] = n;\n  }\n  nextNodes[parent.id] = nextParent;\n\n  return { ...tree, nodes: nextNodes };\n};\n\n/**\n * Patch props/meta/styles конкретной ноды. Не валидирует props против\n * `propsSchema` — это работа инспектора при вводе. Тут только мердж.\n */\nexport const updateNode = (tree: IEditorTree, payload: IUpdateNodePayload): IEditorTree => {\n  const node = requireNode(tree, payload.nodeId);\n  const next = cloneNode(node);\n  if (payload.patch.props) next.props = { ...next.props, ...payload.patch.props };\n  if (payload.patch.meta) next.meta = { ...next.meta, ...payload.patch.meta };\n  if (payload.patch.styles) next.styles = { ...next.styles, ...payload.patch.styles };\n  return {\n    ...tree,\n    nodes: { ...tree.nodes, [node.id]: next },\n  };\n};\n\n/**\n * Переупорядочить детей. `newOrder` должен содержать **те же id**, что и\n * текущие children parent'а — иначе ошибка (это симптом несогласованного\n * обновления и проще упасть, чем тихо потерять/добавить ноды).\n */\nexport const reorderChildren = (\n  tree: IEditorTree,\n  payload: IReorderChildrenPayload,\n): IEditorTree => {\n  const parent = requireNode(tree, payload.parentId);\n  const current = new Set(parent.children);\n  const next = new Set(payload.newOrder);\n  if (current.size !== next.size || [...current].some((id) => !next.has(id))) {\n    throw new EditorOpError(\n      'reorderChildren: newOrder должен содержать ровно тех же детей что и parent',\n    );\n  }\n  const nextParent = cloneNode(parent);\n  nextParent.children = [...payload.newOrder];\n  return { ...tree, nodes: { ...tree.nodes, [parent.id]: nextParent } };\n};\n","import {\n  EditorOpError,\n  addNode,\n  createEmptyTree,\n  moveNode,\n  removeNode,\n  reorderChildren,\n  updateNode,\n} from './operations';\nimport type {\n  IAddNodePayload,\n  IEditorContext,\n  IEditorTree,\n  IMoveNodePayload,\n  IRemoveNodePayload,\n  IReorderChildrenPayload,\n  IUpdateNodePayload,\n  NodeId,\n} from './types';\n\nexport interface ICreateEditorSchemaOptions {\n  /** Стартовое дерево. По умолчанию пустое с корнем `ui.Card`. */\n  initialTree?: IEditorTree;\n  rootType?: string;\n}\n\n/**\n * Возвращает HCA-схему (для `Feature(...)`) с одним стейтом `idle` и набором\n * методов-обработчиков. Каждый метод — pure-операция + commit через\n * `store.update({ tree, selectedId })`.\n *\n * Обёртка над пакетом-операциями — нужна чтобы внутри editor-app можно было:\n * ```ts\n * import { createEditorSchema } from '@capsuletech/editor-state';\n * const State = Feature(() => createEditorSchema());\n * export default State;\n * ```\n *\n * Методы вызываются через `next('addNode')` из дочернего Controller'а с\n * payload в `target.payload`.\n */\nexport const createEditorSchema = (options: ICreateEditorSchemaOptions = {}) => {\n  const initialContext: IEditorContext = {\n    tree: options.initialTree ?? createEmptyTree(options.rootType),\n    selectedId: null,\n  };\n\n  return {\n    initial: 'idle',\n    context: initialContext,\n    states: {\n      idle: {\n        addNode: ({ target, store }: any) => {\n          const payload = target.payload as IAddNodePayload;\n          try {\n            const { tree, nodeId } = addNode(store.ctx.tree, payload);\n            store.update({ tree, selectedId: nodeId });\n          } catch (err) {\n            if (err instanceof EditorOpError) {\n              store.setErrors({ editor: err.message });\n            } else {\n              throw err;\n            }\n          }\n        },\n\n        moveNode: ({ target, store }: any) => {\n          const payload = target.payload as IMoveNodePayload;\n          try {\n            const tree = moveNode(store.ctx.tree, payload);\n            store.update({ tree });\n          } catch (err) {\n            if (err instanceof EditorOpError) {\n              store.setErrors({ editor: err.message });\n            } else {\n              throw err;\n            }\n          }\n        },\n\n        removeNode: ({ target, store }: any) => {\n          const payload = target.payload as IRemoveNodePayload;\n          try {\n            const tree = removeNode(store.ctx.tree, payload);\n            // Если удаляли selected — сбрасываем selection\n            const selectedId =\n              store.ctx.selectedId === payload.nodeId ? null : store.ctx.selectedId;\n            store.update({ tree, selectedId });\n          } catch (err) {\n            if (err instanceof EditorOpError) {\n              store.setErrors({ editor: err.message });\n            } else {\n              throw err;\n            }\n          }\n        },\n\n        updateNode: ({ target, store }: any) => {\n          const payload = target.payload as IUpdateNodePayload;\n          try {\n            const tree = updateNode(store.ctx.tree, payload);\n            store.update({ tree });\n          } catch (err) {\n            if (err instanceof EditorOpError) {\n              store.setErrors({ editor: err.message });\n            } else {\n              throw err;\n            }\n          }\n        },\n\n        reorderChildren: ({ target, store }: any) => {\n          const payload = target.payload as IReorderChildrenPayload;\n          try {\n            const tree = reorderChildren(store.ctx.tree, payload);\n            store.update({ tree });\n          } catch (err) {\n            if (err instanceof EditorOpError) {\n              store.setErrors({ editor: err.message });\n            } else {\n              throw err;\n            }\n          }\n        },\n\n        selectNode: ({ target, store }: any) => {\n          const id = target.payload as NodeId | null;\n          store.update({ selectedId: id });\n        },\n      },\n    },\n  };\n};\n"],"names":["ALPHABET","generateId","length","id","i","ROOT_ID","EditorOpError","message","createEmptyTree","rootType","cloneNode","requireNode","tree","n","isDescendantOrSelf","ancestorId","descendantId","cur","insertAt","arr","item","index","addNode","payload","parent","canAcceptChild","manifest","getManifest","node","nextParent","moveNode","newParent","oldParent","nextOldParent","c","isSameParent","targetParent","nextNode","removeNode","toDelete","stack","nextNodes","updateNode","next","reorderChildren","current","createEditorSchema","options","target","store","nodeId","err","selectedId"],"mappings":"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"}

package/dist/operations.d.ts

@@ -0,0 +1,41 @@
+import { IAddNodePayload, IEditorTree, IMoveNodePayload, IRemoveNodePayload, IReorderChildrenPayload, IUpdateNodePayload, NodeId } from './types';
+/** Ошибка операции с понятным сообщением — Feature/Controller сможет показать юзеру. */
+export declare class EditorOpError extends Error {
+    constructor(message: string);
+}
+/** Пустое дерево с одним корнем (`Wrapper` или указанный тип). */
+export declare const createEmptyTree: (rootType?: string) => IEditorTree;
+/**
+ * Добавить новую ноду к `parentId`. Валидирует:
+ *  - parent существует;
+ *  - parent не leaf (через манифест);
+ *  - parent.accepts(type) (через манифест).
+ *
+ * Возвращает новое дерево + id созданной ноды.
+ */
+export declare const addNode: (tree: IEditorTree, payload: IAddNodePayload) => {
+    tree: IEditorTree;
+    nodeId: NodeId;
+};
+/**
+ * Переместить ноду. Запрещает:
+ *  - перемещать root;
+ *  - перемещать ноду внутрь себя/своих потомков;
+ *  - перемещать в leaf или в parent, который не принимает этот тип.
+ */
+export declare const moveNode: (tree: IEditorTree, payload: IMoveNodePayload) => IEditorTree;
+/**
+ * Удалить ноду и весь её subtree. Root удалить нельзя.
+ */
+export declare const removeNode: (tree: IEditorTree, payload: IRemoveNodePayload) => IEditorTree;
+/**
+ * Patch props/meta/styles конкретной ноды. Не валидирует props против
+ * `propsSchema` — это работа инспектора при вводе. Тут только мердж.
+ */
+export declare const updateNode: (tree: IEditorTree, payload: IUpdateNodePayload) => IEditorTree;
+/**
+ * Переупорядочить детей. `newOrder` должен содержать **те же id**, что и
+ * текущие children parent'а — иначе ошибка (это симптом несогласованного
+ * обновления и проще упасть, чем тихо потерять/добавить ноды).
+ */
+export declare const reorderChildren: (tree: IEditorTree, payload: IReorderChildrenPayload) => IEditorTree;

package/dist/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@capsuletech/web-editor-state",
+  "version": "0.0.17",
+  "type": "module",
+  "main": "./index.mjs",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.mjs",
+      "default": "./index.mjs"
+    }
+  },
+  "dependencies": {
+    "@capsuletech/web-manifests": "workspace:*"
+  },
+  "peerDependencies": {
+    "solid-js": "^1.9.0"
+  }
+}

package/dist/schema.d.ts

@@ -0,0 +1,35 @@
+import { IEditorContext, IEditorTree } from './types';
+export interface ICreateEditorSchemaOptions {
+    /** Стартовое дерево. По умолчанию пустое с корнем `ui.Card`. */
+    initialTree?: IEditorTree;
+    rootType?: string;
+}
+/**
+ * Возвращает HCA-схему (для `Feature(...)`) с одним стейтом `idle` и набором
+ * методов-обработчиков. Каждый метод — pure-операция + commit через
+ * `store.update({ tree, selectedId })`.
+ *
+ * Обёртка над пакетом-операциями — нужна чтобы внутри editor-app можно было:
+ * ```ts
+ * import { createEditorSchema } from '@capsuletech/editor-state';
+ * const State = Feature(() => createEditorSchema());
+ * export default State;
+ * ```
+ *
+ * Методы вызываются через `next('addNode')` из дочернего Controller'а с
+ * payload в `target.payload`.
+ */
+export declare const createEditorSchema: (options?: ICreateEditorSchemaOptions) => {
+    initial: string;
+    context: IEditorContext;
+    states: {
+        idle: {
+            addNode: ({ target, store }: any) => void;
+            moveNode: ({ target, store }: any) => void;
+            removeNode: ({ target, store }: any) => void;
+            updateNode: ({ target, store }: any) => void;
+            reorderChildren: ({ target, store }: any) => void;
+            selectNode: ({ target, store }: any) => void;
+        };
+    };
+};

package/dist/types.d.ts

@@ -0,0 +1,61 @@
+export type NodeId = string;
+/**
+ * Узел дерева редактора. Полностью описывает один JSX-узел в формате,
+ * совместимом с `@capsuletech/renderer` (`ISchema.components.nodes[id]`).
+ *
+ * Никакого UI-state'а (selected/expanded/etc.) — это отдельный концерн
+ * редактора и хранится вне дерева.
+ */
+export interface IEditorNode {
+    id: NodeId;
+    /** Dot-path в registry, напр. `'ui.Button'`. */
+    type: string;
+    parentId: NodeId | null;
+    /** Порядок имеет значение — массив, а не Set. */
+    children: NodeId[];
+    props: Record<string, unknown>;
+    meta: Record<string, unknown>;
+    styles: Record<string, string>;
+}
+export interface IEditorTree {
+    root: NodeId;
+    nodes: Record<NodeId, IEditorNode>;
+}
+/**
+ * Полный контекст редактора. Кроме дерева — UI-state (выбранная нода).
+ * Лежит в XState `context.data` через бридж.
+ */
+export interface IEditorContext {
+    tree: IEditorTree;
+    selectedId: NodeId | null;
+}
+/** Payload'ы для операций — типизированы отдельно для использования в Feature handlers. */
+export interface IAddNodePayload {
+    type: string;
+    parentId: NodeId;
+    /** Куда вставить среди детей родителя. По умолчанию — в конец. */
+    index?: number;
+    /** Опциональный override дефолтных пропсов из манифеста. */
+    props?: Record<string, unknown>;
+    meta?: Record<string, unknown>;
+}
+export interface IMoveNodePayload {
+    nodeId: NodeId;
+    newParentId: NodeId;
+    index?: number;
+}
+export interface IRemoveNodePayload {
+    nodeId: NodeId;
+}
+export interface IUpdateNodePayload {
+    nodeId: NodeId;
+    patch: {
+        props?: Record<string, unknown>;
+        meta?: Record<string, unknown>;
+        styles?: Record<string, string>;
+    };
+}
+export interface IReorderChildrenPayload {
+    parentId: NodeId;
+    newOrder: NodeId[];
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@capsuletech/web-editor-state",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!**/*.tsbuildinfo"
+  ],
+  "dependencies": {
+    "@capsuletech/web-manifests": "0.1.0"
+  },
+  "peerDependencies": {
+    "solid-js": "^1.9.0"
+  },
+  "devDependencies": {
+    "@capsuletech/shared-vite": "0.1.0"
+  },
+  "scripts": {
+    "build": "vite build"
+  }
+}

package/src/ids.ts

@@ -0,0 +1,16 @@
+const ALPHABET = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
+
+/**
+ * Короткий случайный id для нод в дереве. По умолчанию 10 символов —
+ * collision-rate приемлемая для редактора. Не зависит от crypto — работает
+ * в любой среде, включая SSR-сборку.
+ */
+export const generateId = (length = 10): string => {
+  let id = '';
+  for (let i = 0; i < length; i++) {
+    id += ALPHABET[Math.floor(Math.random() * ALPHABET.length)];
+  }
+  return id;
+};
+
+export const ROOT_ID = 'root';

package/src/index.ts

@@ -0,0 +1,23 @@
+export {
+  EditorOpError,
+  addNode,
+  createEmptyTree,
+  moveNode,
+  removeNode,
+  reorderChildren,
+  updateNode,
+} from './operations';
+export { ROOT_ID, generateId } from './ids';
+export { createEditorSchema } from './schema';
+export type { ICreateEditorSchemaOptions } from './schema';
+export type {
+  IAddNodePayload,
+  IEditorContext,
+  IEditorNode,
+  IEditorTree,
+  IMoveNodePayload,
+  IRemoveNodePayload,
+  IReorderChildrenPayload,
+  IUpdateNodePayload,
+  NodeId,
+} from './types';

package/src/operations.ts

@@ -0,0 +1,228 @@
+import { canAcceptChild, getManifest } from '@capsuletech/manifests';
+import { ROOT_ID, generateId } from './ids';
+import type {
+  IAddNodePayload,
+  IEditorNode,
+  IEditorTree,
+  IMoveNodePayload,
+  IRemoveNodePayload,
+  IReorderChildrenPayload,
+  IUpdateNodePayload,
+  NodeId,
+} from './types';
+
+/** Ошибка операции с понятным сообщением — Feature/Controller сможет показать юзеру. */
+export class EditorOpError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'EditorOpError';
+  }
+}
+
+/** Пустое дерево с одним корнем (`Wrapper` или указанный тип). */
+export const createEmptyTree = (rootType = 'ui.Card'): IEditorTree => ({
+  root: ROOT_ID,
+  nodes: {
+    [ROOT_ID]: {
+      id: ROOT_ID,
+      type: rootType,
+      parentId: null,
+      children: [],
+      props: {},
+      meta: {},
+      styles: {},
+    },
+  },
+});
+
+const cloneNode = (n: IEditorNode): IEditorNode => ({
+  ...n,
+  children: [...n.children],
+  props: { ...n.props },
+  meta: { ...n.meta },
+  styles: { ...n.styles },
+});
+
+const requireNode = (tree: IEditorTree, id: NodeId): IEditorNode => {
+  const n = tree.nodes[id];
+  if (!n) throw new EditorOpError(`node "${id}" not found`);
+  return n;
+};
+
+/** Глубже ли `descendantId` под `ancestorId`. Включая равенство. */
+const isDescendantOrSelf = (
+  tree: IEditorTree,
+  ancestorId: NodeId,
+  descendantId: NodeId,
+): boolean => {
+  let cur: NodeId | null = descendantId;
+  while (cur) {
+    if (cur === ancestorId) return true;
+    cur = tree.nodes[cur]?.parentId ?? null;
+  }
+  return false;
+};
+
+const insertAt = <T>(arr: T[], item: T, index?: number): T[] => {
+  if (index === undefined || index < 0 || index >= arr.length) return [...arr, item];
+  return [...arr.slice(0, index), item, ...arr.slice(index)];
+};
+
+/**
+ * Добавить новую ноду к `parentId`. Валидирует:
+ *  - parent существует;
+ *  - parent не leaf (через манифест);
+ *  - parent.accepts(type) (через манифест).
+ *
+ * Возвращает новое дерево + id созданной ноды.
+ */
+export const addNode = (
+  tree: IEditorTree,
+  payload: IAddNodePayload,
+): { tree: IEditorTree; nodeId: NodeId } => {
+  const parent = requireNode(tree, payload.parentId);
+  if (!canAcceptChild(parent.type, payload.type)) {
+    throw new EditorOpError(
+      `node type "${parent.type}" не принимает "${payload.type}" как ребёнка`,
+    );
+  }
+  const manifest = getManifest(payload.type);
+  const id = generateId();
+  const node: IEditorNode = {
+    id,
+    type: payload.type,
+    parentId: parent.id,
+    children: [],
+    props: { ...(manifest?.defaultProps ?? {}), ...(payload.props ?? {}) },
+    meta: { ...(payload.meta ?? {}) },
+    styles: {},
+  };
+  const nextParent = cloneNode(parent);
+  nextParent.children = insertAt(nextParent.children, id, payload.index);
+  return {
+    nodeId: id,
+    tree: {
+      ...tree,
+      nodes: {
+        ...tree.nodes,
+        [id]: node,
+        [parent.id]: nextParent,
+      },
+    },
+  };
+};
+
+/**
+ * Переместить ноду. Запрещает:
+ *  - перемещать root;
+ *  - перемещать ноду внутрь себя/своих потомков;
+ *  - перемещать в leaf или в parent, который не принимает этот тип.
+ */
+export const moveNode = (tree: IEditorTree, payload: IMoveNodePayload): IEditorTree => {
+  if (payload.nodeId === tree.root) {
+    throw new EditorOpError('root cannot be moved');
+  }
+  const node = requireNode(tree, payload.nodeId);
+  const newParent = requireNode(tree, payload.newParentId);
+  if (isDescendantOrSelf(tree, payload.nodeId, payload.newParentId)) {
+    throw new EditorOpError('cannot move a node into its own subtree');
+  }
+  if (!canAcceptChild(newParent.type, node.type)) {
+    throw new EditorOpError(
+      `node type "${newParent.type}" не принимает "${node.type}" как ребёнка`,
+    );
+  }
+  const oldParent = requireNode(tree, node.parentId!);
+  const nextOldParent = cloneNode(oldParent);
+  nextOldParent.children = nextOldParent.children.filter((c) => c !== node.id);
+
+  // Если parent тот же — сначала удаляем из старого, потом вставляем в новый
+  // (правильный индекс может «съехать» при том же родителе — calculate accordingly).
+  const isSameParent = oldParent.id === newParent.id;
+  const targetParent = isSameParent ? nextOldParent : cloneNode(newParent);
+  targetParent.children = insertAt(targetParent.children, node.id, payload.index);
+
+  const nextNode = cloneNode(node);
+  nextNode.parentId = newParent.id;
+
+  return {
+    ...tree,
+    nodes: {
+      ...tree.nodes,
+      [node.id]: nextNode,
+      [oldParent.id]: nextOldParent,
+      ...(isSameParent ? {} : { [newParent.id]: targetParent }),
+    },
+  };
+};
+
+/**
+ * Удалить ноду и весь её subtree. Root удалить нельзя.
+ */
+export const removeNode = (tree: IEditorTree, payload: IRemoveNodePayload): IEditorTree => {
+  if (payload.nodeId === tree.root) {
+    throw new EditorOpError('root cannot be removed');
+  }
+  const node = requireNode(tree, payload.nodeId);
+  const parent = requireNode(tree, node.parentId!);
+
+  // Собираем все ноды subtree для удаления
+  const toDelete = new Set<NodeId>();
+  const stack: NodeId[] = [node.id];
+  while (stack.length) {
+    const id = stack.pop()!;
+    if (toDelete.has(id)) continue;
+    toDelete.add(id);
+    const n = tree.nodes[id];
+    if (n) stack.push(...n.children);
+  }
+
+  const nextParent = cloneNode(parent);
+  nextParent.children = nextParent.children.filter((c) => c !== node.id);
+
+  const nextNodes: Record<NodeId, IEditorNode> = {};
+  for (const [id, n] of Object.entries(tree.nodes)) {
+    if (!toDelete.has(id)) nextNodes[id] = n;
+  }
+  nextNodes[parent.id] = nextParent;
+
+  return { ...tree, nodes: nextNodes };
+};
+
+/**
+ * Patch props/meta/styles конкретной ноды. Не валидирует props против
+ * `propsSchema` — это работа инспектора при вводе. Тут только мердж.
+ */
+export const updateNode = (tree: IEditorTree, payload: IUpdateNodePayload): IEditorTree => {
+  const node = requireNode(tree, payload.nodeId);
+  const next = cloneNode(node);
+  if (payload.patch.props) next.props = { ...next.props, ...payload.patch.props };
+  if (payload.patch.meta) next.meta = { ...next.meta, ...payload.patch.meta };
+  if (payload.patch.styles) next.styles = { ...next.styles, ...payload.patch.styles };
+  return {
+    ...tree,
+    nodes: { ...tree.nodes, [node.id]: next },
+  };
+};
+
+/**
+ * Переупорядочить детей. `newOrder` должен содержать **те же id**, что и
+ * текущие children parent'а — иначе ошибка (это симптом несогласованного
+ * обновления и проще упасть, чем тихо потерять/добавить ноды).
+ */
+export const reorderChildren = (
+  tree: IEditorTree,
+  payload: IReorderChildrenPayload,
+): IEditorTree => {
+  const parent = requireNode(tree, payload.parentId);
+  const current = new Set(parent.children);
+  const next = new Set(payload.newOrder);
+  if (current.size !== next.size || [...current].some((id) => !next.has(id))) {
+    throw new EditorOpError(
+      'reorderChildren: newOrder должен содержать ровно тех же детей что и parent',
+    );
+  }
+  const nextParent = cloneNode(parent);
+  nextParent.children = [...payload.newOrder];
+  return { ...tree, nodes: { ...tree.nodes, [parent.id]: nextParent } };
+};

package/src/schema.ts

@@ -0,0 +1,133 @@
+import {
+  EditorOpError,
+  addNode,
+  createEmptyTree,
+  moveNode,
+  removeNode,
+  reorderChildren,
+  updateNode,
+} from './operations';
+import type {
+  IAddNodePayload,
+  IEditorContext,
+  IEditorTree,
+  IMoveNodePayload,
+  IRemoveNodePayload,
+  IReorderChildrenPayload,
+  IUpdateNodePayload,
+  NodeId,
+} from './types';
+
+export interface ICreateEditorSchemaOptions {
+  /** Стартовое дерево. По умолчанию пустое с корнем `ui.Card`. */
+  initialTree?: IEditorTree;
+  rootType?: string;
+}
+
+/**
+ * Возвращает HCA-схему (для `Feature(...)`) с одним стейтом `idle` и набором
+ * методов-обработчиков. Каждый метод — pure-операция + commit через
+ * `store.update({ tree, selectedId })`.
+ *
+ * Обёртка над пакетом-операциями — нужна чтобы внутри editor-app можно было:
+ * ```ts
+ * import { createEditorSchema } from '@capsuletech/editor-state';
+ * const State = Feature(() => createEditorSchema());
+ * export default State;
+ * ```
+ *
+ * Методы вызываются через `next('addNode')` из дочернего Controller'а с
+ * payload в `target.payload`.
+ */
+export const createEditorSchema = (options: ICreateEditorSchemaOptions = {}) => {
+  const initialContext: IEditorContext = {
+    tree: options.initialTree ?? createEmptyTree(options.rootType),
+    selectedId: null,
+  };
+
+  return {
+    initial: 'idle',
+    context: initialContext,
+    states: {
+      idle: {
+        addNode: ({ target, store }: any) => {
+          const payload = target.payload as IAddNodePayload;
+          try {
+            const { tree, nodeId } = addNode(store.ctx.tree, payload);
+            store.update({ tree, selectedId: nodeId });
+          } catch (err) {
+            if (err instanceof EditorOpError) {
+              store.setErrors({ editor: err.message });
+            } else {
+              throw err;
+            }
+          }
+        },
+
+        moveNode: ({ target, store }: any) => {
+          const payload = target.payload as IMoveNodePayload;
+          try {
+            const tree = moveNode(store.ctx.tree, payload);
+            store.update({ tree });
+          } catch (err) {
+            if (err instanceof EditorOpError) {
+              store.setErrors({ editor: err.message });
+            } else {
+              throw err;
+            }
+          }
+        },
+
+        removeNode: ({ target, store }: any) => {
+          const payload = target.payload as IRemoveNodePayload;
+          try {
+            const tree = removeNode(store.ctx.tree, payload);
+            // Если удаляли selected — сбрасываем selection
+            const selectedId =
+              store.ctx.selectedId === payload.nodeId ? null : store.ctx.selectedId;
+            store.update({ tree, selectedId });
+          } catch (err) {
+            if (err instanceof EditorOpError) {
+              store.setErrors({ editor: err.message });
+            } else {
+              throw err;
+            }
+          }
+        },
+
+        updateNode: ({ target, store }: any) => {
+          const payload = target.payload as IUpdateNodePayload;
+          try {
+            const tree = updateNode(store.ctx.tree, payload);
+            store.update({ tree });
+          } catch (err) {
+            if (err instanceof EditorOpError) {
+              store.setErrors({ editor: err.message });
+            } else {
+              throw err;
+            }
+          }
+        },
+
+        reorderChildren: ({ target, store }: any) => {
+          const payload = target.payload as IReorderChildrenPayload;
+          try {
+            const tree = reorderChildren(store.ctx.tree, payload);
+            store.update({ tree });
+          } catch (err) {
+            if (err instanceof EditorOpError) {
+              store.setErrors({ editor: err.message });
+            } else {
+              throw err;
+            }
+          }
+        },
+
+        selectNode: ({ target, store }: any) => {
+          const id = target.payload as NodeId | null;
+          store.update({ selectedId: id });
+        },
+      },
+    },
+  };
+};

package/src/types.ts

@@ -0,0 +1,69 @@
+export type NodeId = string;
+
+/**
+ * Узел дерева редактора. Полностью описывает один JSX-узел в формате,
+ * совместимом с `@capsuletech/renderer` (`ISchema.components.nodes[id]`).
+ *
+ * Никакого UI-state'а (selected/expanded/etc.) — это отдельный концерн
+ * редактора и хранится вне дерева.
+ */
+export interface IEditorNode {
+  id: NodeId;
+  /** Dot-path в registry, напр. `'ui.Button'`. */
+  type: string;
+  parentId: NodeId | null;
+  /** Порядок имеет значение — массив, а не Set. */
+  children: NodeId[];
+  props: Record<string, unknown>;
+  meta: Record<string, unknown>;
+  styles: Record<string, string>;
+}
+
+export interface IEditorTree {
+  root: NodeId;
+  nodes: Record<NodeId, IEditorNode>;
+}
+
+/**
+ * Полный контекст редактора. Кроме дерева — UI-state (выбранная нода).
+ * Лежит в XState `context.data` через бридж.
+ */
+export interface IEditorContext {
+  tree: IEditorTree;
+  selectedId: NodeId | null;
+}
+
+/** Payload'ы для операций — типизированы отдельно для использования в Feature handlers. */
+export interface IAddNodePayload {
+  type: string;
+  parentId: NodeId;
+  /** Куда вставить среди детей родителя. По умолчанию — в конец. */
+  index?: number;
+  /** Опциональный override дефолтных пропсов из манифеста. */
+  props?: Record<string, unknown>;
+  meta?: Record<string, unknown>;
+}
+
+export interface IMoveNodePayload {
+  nodeId: NodeId;
+  newParentId: NodeId;
+  index?: number;
+}
+
+export interface IRemoveNodePayload {
+  nodeId: NodeId;
+}
+
+export interface IUpdateNodePayload {
+  nodeId: NodeId;
+  patch: {
+    props?: Record<string, unknown>;
+    meta?: Record<string, unknown>;
+    styles?: Record<string, string>;
+  };
+}
+
+export interface IReorderChildrenPayload {
+  parentId: NodeId;
+  newOrder: NodeId[];
+}