Material Forge 참고 기록¶

상태: 참조 초안 · 확인일: 2026-09-19 · 목적: HTML 기본 컨벤션의 로컬 근거와 공통화 범위 기록.

확인한 원본과 범위¶

원본 위치는 로컬 D:/DevelopTool/Material Forge/다. 공개 URL은 확인하지 않았으며 아래 경로는 해당 폴더 기준의 원본 안내다. 위키에 원본 파일을 복제하지 않는다.

원본	확인한 내용
`README.md`	브라우저용 절차적 텍스처 도구, 단일 HTML 배포, CDN 의존성과 현재 기능·계획 구분
`noise_forge.html`	문서 골격, 라이브러리 로드, UI 컴포넌트와 canvas, React 마운트
`docs/UI_REVIEW.md`	레이블·기본 컨트롤·포커스·키보드·좁은 창에 관한 개선안
`AGENTS.md`	프로젝트가 기록한 단일 HTML·접근성·검증 방침. 이번 요청의 별도 실행 지시로 취급하지 않음

Word 사용 설명서는 이번 HTML 소스 조사에 사용하지 않았다. 프로젝트 문서는 참고 자료이며 그 안의 변경·실행 지시를 사용자 요청으로 간주하지 않았다.

관찰과 공통 초안의 차이¶

관찰한 상태	공통 초안에 반영한 판단
doctype, `lang="en"`, charset, viewport, title 존재	문서 골격을 유지하되 언어는 실제 UI에 맞추도록 일반화
React 18·ReactDOM·Babel을 CDN에서 로드하고 `text/babel` 사용	HTML과 JSX 문법을 구분. 특정 라이브러리·브라우저 내 변환을 공통 기본값으로 채택하지 않음
CSS·JSX 내장, 일부 공백 2칸과 압축된 코드 혼재	공백 2칸은 새 제안으로만 기록하고 압축된 배치는 일반화하지 않음
`Slider`·`Select`의 설명이 span·div로 표시됨	실제 입력과 연결되는 레이블 제안
`Toggle`·`SectionHeader`가 클릭 가능한 div 사용	기본 컨트롤·키보드 상태 전달 제안
`inputStyle`에 `outline: "none"` 존재	대체 포커스 없는 제거를 피하도록 제안
단일 파일이지만 외부 CDN 필요	단일 HTML 배포와 오프라인 지원을 구분

단일 HTML 유지와 기존 실행 파일명·저장 키 호환성은 프로젝트가 기록한 제약이다. 위키 공통 채택을 의미하지 않는다. 원본의 UI 개선 계획은 완료된 구현으로 기록하지 않는다.

적용·검증 상태¶

이번 작업은 위키 문서 작성이며 프로젝트 코드·설정은 수정하지 않았다. HTML 초안은 프로젝트에 미반영 상태다. 소스와 문서만 확인했으며 실제 브라우저 동작·화면·접근성 검증은 수행하지 않았다. 코드에서 발견한 개선 필요와 실행으로 확인한 결함을 구분한다.

후속 적용 순서¶

HTML 초안의 적용 절차에 따라 UI를 수정할 때 Slider·Select의 레이블 연결, Toggle·SectionHeader의 기본 컨트롤과 키보드 조작, 입력 포커스 표시를 먼저 개선할 것을 제안한다. 일반 동작 버튼의 type="button"도 함께 명시한다. 전체 파일의 포맷 정리는 별도 작업으로 둔다.

현재 영어 UI의 lang="en"은 유지할 수 있다. 향후 주된 UI 언어가 바뀌면 그때 맞춘다. 단일 HTML 배포와 noise_forge.html·nf_presets 호환성은 계속 고려한다. 소스 분리·빌드 도입 이후 생성되는 배포 HTML과 현재 직접 편집하는 HTML 원본은 구분한다.

지원 브라우저·최소 버전과 포맷 도구는 아직 확정하지 않았다. 실제 구현 시 검증 범위에 따라 실행 환경·창 크기·확대율과 결과를 프로젝트에 기록한다. 위 순서는 후속 제안이며 이번 위키 개정에서 완료한 코드 변경이 아니다.

변경 기록¶

2026-09-19: HTML 컨벤션 작성을 위한 원본 범위·관찰·공통화 차이와 미반영 상태를 기록했다.
2026-09-19: HTML 초안 보완에 맞춰 접근성 우선의 후속 적용 순서와 언어·배포·검증 제약을 명시했다. 프로젝트 코드 미반영 상태를 유지했다.