Actionbook 문서의 프레임워크 독립적 코어 라이브러리.

Tiptap/ProseMirror에 종속되지 않는 자체 AST 모델, 마크다운 파서/시리얼라이저, Jinja 조건식 평가기, 그리고 구조적 편집 Operation 시스템을 제공합니다.

기존 Actionbook 에디터의 문서 모델은 ProseMirror 스키마에 강하게 결합되어 있어서:

• 서버 사이드에서 문서를 파싱/검증할 수 없음
• 에디터를 교체하려면 데이터 모델까지 함께 바꿔야 함
• Jinja 프리뷰 등 부가 기능이 에디터 DOM에 의존

이 라이브러리는 순수 TypeScript로 작성되어 브라우저, Node.js, 서버리스 환경 어디서든 동작합니다.

import {
  parseMarkdown,
  serializeToMarkdown,
  fromProseMirrorJSON,
  validate,
  doc, paragraph, text, bold, resourceTag, jumpPoint,
} from '@sb/actionbook-core';

// 마크다운 파싱
const ast = parseMarkdown('# Title\n\nUse {{tool:t1:My Tool}} at ^START^');

// 빌더로 직접 생성
const manual = doc(
  paragraph(text('Hello '), text('bold', [bold()]), resourceTag('tool', 't1', 'Tool')),
);

// 스키마 검증
const errors = validate(ast); // [] 이면 정상

// 마크다운 출력
const md = serializeToMarkdown(ast);

// ProseMirror JSON 변환 (기존 editor_data 호환)
const ast2 = fromProseMirrorJSON(existingEditorData);

cd libs/actionbook-core
npx vitest run

12개 파일, 206개 테스트. 커버리지: AST 빌더/순회, 마크다운 roundtrip, ProseMirror 호환, 스키마 검증, Jinja 평가기 보안 케이스, Operation 타입 안전성, 역직렬화 경계, URL 새니타이제이션.

이 라이브러리는 신뢰되지 않는 입력(사용자가 편집한 마크다운, 외부에서 전달된 editor_data)을 처리하도록 설계되었습니다.

이 라이브러리는 독립 모듈로 동일성 테스트만 완료된 상태입니다. 기존 에디터 코드를 실제로 교체하는 작업은 아직 수행되지 않았으며, 점진적으로 진행할 계획입니다.

교체 대상:

• converters.ts → actionbookToAST()
• processResourceTags.ts → 파서가 직접 노드 생성하므로 삭제 가능
• editorConverter.ts → parseMarkdown() + serializeToMarkdown()
• JinjaPreview/ → jinja/ 모듈

기존: tiptap-markdown (markdown-it 기반) → 이 라이브러리: mdast (micromark 기반)

대부분의 마크다운에서 동일한 결과를 내지만, edge case에서 차이가 발생할 수 있습니다:

• Loose/tight list 판단: 빈 줄이 포함된 리스트의 처리 방식이 다를 수 있음
• 리스트 들여쓰기: 2칸 vs 4칸 인식 차이
• HTML 인라인: 이 라이브러리는 HTML을 지원하지 않음 (설계 의도)

완화 방안: 실제 프로덕션 데이터에서 추출한 마크다운 fixture를 추가하여 차이를 조기에 발견해야 합니다.

안전성을 위해 재귀 하강 파서를 사용하므로, Jinja2의 전체 표현식 문법을 지원하지 않습니다.

지원됨: ==, !=, <, >, <=, >=, and, or, not, in, is, is not, 괄호, 문자열/숫자/불리언/None 리터럴, 점 표기법 변수

미지원:

• 필터 (value | upper, items | length)
• 함수 호출 (len(items), range(10))
• 리스트/딕셔너리 리터럴 ([1, 2], {"k": "v"})
• 삼항 ("a" if cond else "b")
• not in 연산자
• 슬라이싱 (items[0])

실제 Actionbook에서 사용 중인 조건식이 이 범위를 넘는다면 evaluator 확장이 필요합니다.

• 노드 단위 편집만 가능: 텍스트 노드 내부의 문자 레벨 편집(split/merge)은 미지원
• 동시성 미지원: CRDT/OT 변환 로직 없음. NodePath + Transaction 구조가 확장 포인트로 설계되어 있지만 실제 conflict resolution은 없음
• 빈 컨테이너 허용: 모든 listItem을 삭제한 후 빈 bulletList가 남는 등의 의미적 무결성은 검증하지 않음 (schema validation에서는 잡힘)

micromark + mdast-util 생태계 의존성이 추가됨. 루트 프로젝트가 이미 remark-gfm을 쓰고 있어 중복은 적을 것으로 예상하지만, 실제 tree-shaking 후 번들 크기 측정은 아직 하지 않았습니다.

1. 프로덕션 fixture 확보: 실제 고객 Actionbook 데이터에서 마크다운 + PM JSON 쌍을 추출하여 동일성 테스트 보강
2. 기존 코드 점진적 교체: 가장 리스크가 낮은 읽기 전용 경로(프리뷰, 내보내기)부터 이 라이브러리로 전환
3. 번들 크기 측정: Vite 빌드에서의 실제 기여도 확인

4. actionbook-renderer: 자체 AST를 입력으로 받는 React 읽기 전용 렌더러. 프리뷰에 먼저 적용
5. Jinja evaluator 확장: 필터, not in, 리스트 리터럴 등 실제 사용되는 패턴 추가
6. 서버 사이드 검증: Node.js 서버에서 마크다운 파싱/Jinja 변수 추출 수행

7. actionbook-editor: 자체 AST + Operation 기반의 편집 가능한 에디터
8. CRDT 협업 편집: Operation 모델 위에 Yjs/Automerge 어댑터
9. History 시스템: Transaction + invertOperation() 기반 undo/redo 스택