Phyx Blockly

upstream Blockly에 최소 패치를 적용해 @cp949/phyx-blockly로 npm 배포하는 저장소입니다.

현재 패치: JavaScript procedure generator를 async/await 기반으로 변경

한 줄 요약

src/ 패치 파일  →  build.sh로 blockly-src에 적용 및 빌드  →  dist/ 생성  →  release.sh로 배포

주요 파일

| 파일 | 역할 | | ---- | ---- | | UPSTREAM_REF.txt | 빌드할 upstream Blockly 태그/hash | | src/ | 로컬 패치 파일 (upstream과 동일한 경로 구조) | | build.sh | 패치 적용 + 빌드 + dist/ 생성 | | build-and-test.sh | build.sh + 앞뒤 테스트 | | release.sh | 테스트 + npm publish | | scripts/ | 내부 헬퍼 (직접 호출 불필요) |

워크플로우

평소 작업

# 1. src/ 패치 파일 수정
# 2. 빌드 및 테스트
npm run build:test

# 3. dist/ 확인 후 배포
npm run release

upstream 버전 업그레이드

# 1. UPSTREAM_REF.txt 수정
echo "blockly-v13.0.0" > UPSTREAM_REF.txt

# 2. 새 버전으로 먼저 테스트
npm run build -- --ref blockly-v13.0.0

# 3. 문제 없으면 package.json 버전도 올리고 배포
npm run release

처음 설정

npm install
git submodule update --init --recursive

버전 규칙

upstream 버전 뒤에 -pN 접미사:

upstream 12.5.1  →  package 12.5.1-p1, 12.5.1-p2, ...

package.json의 버전만 올리면 됩니다.

현재 패치 위치

src/packages/blockly/generators/javascript/procedures.ts

• function → async function
• foo() → await foo()
• Order.FUNCTION_CALL → Order.AWAIT

upstream 업데이트 시 이 파일 먼저 확인.