disaster-broadcast-studio 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,25 @@
+MIT License
+
+Copyright (c) 2026 neuwcodebox
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+Third-party map data, fonts and quoted reference materials retain their
+respective licenses and attribution requirements; see assets/README.md and
+skills/scenario-writing/references/.

package/README.md

@@ -1,3 +1,110 @@
-# Temporary Holding Version
+# 재난방송실 · Disaster Broadcast Studio
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+YAML/JSON 시나리오를 한국형 재난방송 호러 영상으로 만드는 CLI입니다. 문자·뉴스·지도·시계·음향을 텍스트로 연출하고, **1920×1080 · 60fps MP4**로 출력합니다.
+
+![재난방송실 출력 화면 — 허구의 기술 검증용 방송](https://raw.githubusercontent.com/neuwcodebox/disaster-broadcast-studio/main/docs/screenshots/broadcast.png)
+
+## 할 수 있는 일
+
+- **방송 화면:** 최신순 재난문자·정정 이력, 독립 뉴스, 상태 박스, 장문 방송 안내.
+- **지도 연출:** 실제 시도·시군구 경계, 채우기·윤곽선 중첩, 범례·지점·영역·진행선, 카메라 이동·보조 지도.
+- **시간 연출:** 컷 안에서는 실시간으로, 컷 사이에서는 지정한 이야기 시각으로 전환. 임의 프레임에서도 같은 상태를 복원.
+- **음향·효과:** 공통 수신음, 로컬 음원, Tone.js 코드의 WAV 합성, 페이드·침묵·신호 간섭·송출 종료.
+- **텍스트 제작 흐름:** 검증, 렌더 없는 상태 조회, PNG 미리보기, 구간·전체 영상 출력, 게시용 출처 생성.
+
+실제 긴급 서비스에 연결하거나 문자를 발송하지 않습니다. 작품 제목과 필수 허구 고지는 영상 첫 5초에 표시합니다.
+
+## 설치와 시작
+
+**Node.js 22 이상**과 Chromium 실행에 필요한 OS 라이브러리가 필요합니다.
+
+빈 작품 폴더에 npm 패키지를 설치합니다.
+
+```sh
+mkdir my-film
+cd my-film
+npm install disaster-broadcast-studio
+npx dbs init
+```
+
+`init`은 유효한 `scenario.yaml`, 작품용 `README.md`, `audio/`, `audio-code/`를 만듭니다. 기존 파일과 충돌하면 생성 전에 중단합니다. 작품은 엔진 저장소 밖에서 관리합니다.
+
+창작 AI와 함께 제작한다면 [창작 스킬 설치 안내](skills/README.md)를 따르세요. 스킬에는 집필·연출 지침, 공식 문안 참고자료, 음향 코드 예제가 포함되어 있습니다. 사용자 범위에 한 번 설치하며 `dbs init`과 별도로 관리합니다.
+
+## 첫 영상 만들기
+
+`scenario.yaml`의 제목·기관·컷·이벤트를 수정하고 다음 순서로 확인합니다.
+
+```sh
+# 입력·참조·음원·시간 검증
+npx dbs validate scenario.yaml
+
+# 8초 지점의 상태와 화면 확인
+npx dbs inspect scenario.yaml --frame 480
+npx dbs frame scenario.yaml --frame 480 --out preview.png
+
+# 5초 구간을 확인한 뒤 전체 영상 출력
+npx dbs render scenario.yaml --from 300 --to 599 --out clip.mp4
+npx dbs render scenario.yaml --out film.mp4
+```
+
+프레임은 **0부터 시작**하며 구간의 **끝 프레임도 포함**합니다. 300~599는 60fps에서 5초입니다. 컷 안의 시간은 실제 재생 시간과 같고, 컷 경계에서만 시간을 생략할 수 있습니다. 오프닝 이후에 중요한 사건을 배치하고, 읽기 시간 경고가 나오면 문자 사이 간격을 늘리세요.
+
+첫 렌더에서는 Remotion이 Chrome Headless Shell을 다운로드할 수 있습니다. `--browser /path/to/chromium`으로 설치된 브라우저를 지정할 수도 있습니다. 준비 후에는 로컬 지도·글꼴·음원으로 렌더합니다.
+
+Linux에서 소프트웨어 WebGL을 사용하려면 `frame`·`render` 명령에 **`--gl swangle`**을 추가합니다. 기본값은 `--gl angle`, 동시 렌더 수는 `--concurrency 2`입니다. 60fps는 결과 영상 규격이며 렌더 속도는 환경에 따라 달라집니다.
+
+### 결과 파일
+
+| 파일 | 용도 |
+| --- | --- |
+| `film.mp4` | H.264/yuv420p 영상과 AAC 오디오. 음원이 없어도 무음 트랙 포함 |
+| `film.mp4.json` | 작품 정보, 출력 프레임 범위, 자산·출처 기록 |
+| `film.mp4.credits.txt` | 영상 게시 설명란에 넣을 출처 문안 |
+
+PNG 출력에도 `.json`과 `.credits.txt`가 함께 생성됩니다. 기존 결과나 부속 파일이 있으면 중단하며, 교체하려면 `--overwrite`를 지정합니다. 오류는 종료코드 1로 반환합니다.
+
+영상 게시 시 **`.credits.txt` 내용을 설명란 등에 함께 제공**하세요. 기본 지도에는 출처를 상시 표시하지 않습니다. 사용자 지도·음원의 추가 표시 조건은 작품별로 확인합니다.
+
+## 시나리오와 음향 작성
+
+정확한 필드와 이벤트 사용법은 [작품 형식·CLI](skills/scenario-writing/references/format.md)에 정리되어 있습니다. `cuts`는 이야기 시각과 길이, `events`는 문자·뉴스·지도·음향의 시점을 정합니다.
+
+```sh
+npx dbs schema --out scenario.schema.json
+npx dbs regions --search 철원 --json
+npx dbs credits scenario.yaml --out description-credits.txt
+```
+
+문자 수신음은 기본 제공하며 문자별로 끄거나 교체할 수 있습니다. 작품 고유 음향은 사용권이 있는 로컬 파일을 연결하거나, [Tone.js 음향 가이드](skills/scenario-writing/references/audio.md)에 따라 ES 모듈을 작성해 WAV로 합성합니다.
+
+```sh
+npx dbs audio audio-code/sound.mjs --duration 3 --seed 731 --out audio/sound.wav
+```
+
+`audio-code/sound.mjs`는 직접 작성하는 파일입니다. 합성 결과 옆 `.json`에는 시드·음량 통계와 Tone.js·Chromium 버전을 기록합니다. 음원 경로는 시나리오 파일을 기준으로 해석하며, 자산마다 출처와 이용조건을 지정합니다.
+
+## 개발
+
+저장소에서 의존성을 설치하고 검증·빌드합니다.
+
+```sh
+npm ci
+npm test
+npm run typecheck
+npm run build
+npm pack
+```
+
+`npm pack`은 설치 가능한 `.tgz`를 만듭니다. 코드와 배포 자산·창작 스킬을 포함하며 실제 작품은 포함하지 않습니다. 렌더 검증용 입력은 `node scripts/render-fixtures.mjs /tmp/dbs-fixtures`로 저장소 밖에 생성할 수 있습니다.
+
+| 문서 | 다루는 내용 |
+| --- | --- |
+| [SPEC](docs/SPEC.md) | 목표·요구사항 |
+| [TECH](docs/TECH.md) | 구현 구조·설계 근거 |
+| [PLAN](docs/PLAN.md) | 검증 범위·현재 상태·다음 작업 |
+| [창작 스킬](skills/scenario-writing/SKILL.md) | 독립된 창작 AI의 제작 지침 |
+
+## 이용조건
+
+코드는 [MIT](LICENSE)입니다. 지도·글꼴·공통 수신음은 [자산 출처와 이용조건](assets/README.md)을 확인하세요. Remotion에는 [별도 라이선스 조건](https://www.remotion.dev/pricing)이 적용됩니다.

package/assets/FONT-LICENSE.txt

@@ -0,0 +1,93 @@
+Copyright 2018 IBM Corp. All rights reserved. IBMPlexSansKR-ExtraLight.ttf: Copyright 2018 IBM Corp. All rights reserved. IBMPlexSansKR-Light.ttf: Copyright 2018 IBM Corp. All rights reserved. IBMPlexSansKR-Regular.ttf: Copyright 2018 IBM Corp. All rights reserved. IBMPlexSansKR-Medium.ttf: Copyright 2018 IBM Corp. All rights reserved. IBMPlexSansKR-SemiBold.ttf: Copyright 2018 IBM Corp. All rights reserved. IBMPlexSansKR-Bold.ttf: Copyright 2018 IBM Corp. All rights reserved.
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/assets/MONO-FONT-LICENSE.txt

@@ -0,0 +1,93 @@
+Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-ThinItalic.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-ExtraLight.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-ExtraLightItalic.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-Light.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-LightItalic.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-Regular.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-Italic.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-Medium.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-MediumItalic.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-SemiBold.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-SemiBoldItalic.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-Bold.ttf: Copyright 2017 IBM Corp. All rights reserved. IBMPlexMono-BoldItalic.ttf: Copyright 2017 IBM Corp. All rights reserved.
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/assets/NORTH-KOREA-LICENSE.txt

@@ -0,0 +1,25 @@
+North Korea (Democratic People's Republic of Korea) administrative boundary
+
+Source: World Food Programme (WFP), OCHA Regional Office for Asia and the Pacific.
+Dataset represented year: 2018.
+Distribution: geoBoundaries gbOpen PRK ADM0, boundary ID PRK-ADM0-24118357,
+revision 9469f09 (API metadata source update: 2023-01-19).
+
+Original source:
+https://data.humdata.org/dataset/dpr-korea-administrative-boundaries
+Redistributed source geometry:
+https://github.com/wmgeolab/geoBoundaries/blob/9469f09/releaseData/gbOpen/PRK/ADM0/geoBoundaries-PRK-ADM0.geojson
+Source and license metadata:
+https://www.geoboundaries.org/api/current/gbOpen/PRK/ADM0/
+
+License: Creative Commons Attribution 3.0 Intergovernmental Organisations
+(CC BY 3.0 IGO).
+License and legal code:
+https://creativecommons.org/licenses/by/3.0/igo/
+https://creativecommons.org/licenses/by/3.0/igo/legalcode
+
+The original boundary geometry is retained without simplification. Unused
+attributes are replaced by a country name and code, and the geometry is
+combined with separately licensed neighboring-country features and gzipped.
+Maps are produced works; no endorsement by WFP, OCHA or the UN is implied.
+Keep this attribution and the license link when redistributing the data.

package/assets/README.md

@@ -0,0 +1,25 @@
+# 출력 자산
+
+| 파일 | 출처·판본 | 이용조건·가공 |
+| --- | --- | --- |
+| `regions.geojson.gz` | [vuski/admdongkor 2026-07-01 원본](https://github.com/vuski/admdongkor/blob/master/ver20260701/HangJeongDong_ver20260701.geojson), 원자료 통계청 SGIS | SGIS 공공누리 제1유형, 가공 데이터 CC BY 4.0. 행정동을 시군구로 병합하고 원본의 경계 좌표를 유지. `REGION-LICENSE.txt` 참조. |
+| `provinces.geojson.gz` | 위 시군구 경계를 시도 코드로 병합 | 동일 이용조건. 지역 사이 공유 경계를 병합하여 시도 외곽선으로 사용. |
+| `countries.geojson.gz` | [Natural Earth 5.1.2, 1:10m admin 0](https://github.com/nvkelso/natural-earth-vector/blob/v5.1.2/geojson/ne_10m_admin_0_countries.geojson), 북한은 [WFP·OCHA/geoBoundaries PRK ADM0](https://www.geoboundaries.org/api/current/gbOpen/PRK/ADM0/) 2018판, revision `9469f09` | Natural Earth는 [Public domain](https://www.naturalearthdata.com/about/terms-of-use/), 북한은 [CC BY 3.0 IGO](https://creativecommons.org/licenses/by/3.0/igo/). 동아시아 7개국의 원본 경계 좌표를 유지하고 설명 열만 정리. `NORTH-KOREA-LICENSE.txt` 참조. |
+| IBM Plex Sans KR 400/600 | npm `@fontsource/ibm-plex-sans-kr` 5.3.0 | [SIL OFL 1.1](https://github.com/IBM/plex/blob/master/LICENSE.txt). 한글 본문용. `FONT-LICENSE.txt` 참조. |
+| IBM Plex Mono 400 | npm `@fontsource/ibm-plex-mono` 5.3.0 | 동일 OFL. 시각·페이지 수에 고정폭 숫자 사용. `MONO-FONT-LICENSE.txt` 참조. |
+
+지도 자산은 원본 좌표를 단순화하거나 정밀도를 낮추지 않고 gzip으로 압축한다. `scripts/build-map-assets.mjs`로 재생성하며 렌더 중 다운로드하지 않는다. MapLibre의 GeoJSON 단순화도 비활성화한다. 기본 지도에서 대한민국 육지·해안·시군구 강조는 같은 SGIS 폴리곤을 사용한다. 시도 구분선은 그 폴리곤을 병합한 경계다. 배경의 대한민국 도형은 기본 지도에서 제외하여 서로 다른 해안선을 겹치지 않는다.
+
+```sh
+node scripts/build-map-assets.mjs /path/HangJeongDong_ver20260701.geojson /path/ne_10m_admin_0_countries.geojson /path/geoBoundaries-PRK-ADM0.geojson
+```
+
+지도·글꼴은 설치된 패키지와 압축 파일에서 로컬로 로드한다. 지도 위에는 출처를 상시 표시하지 않는다. `attribution.json`의 제공자·원자료·라이선스 링크·가공 내용을 출력 옆 `.credits.txt`와 `.json`에 기록한다. 영상 게시 시 `.credits.txt` 내용을 유튜브 설명란 등 시청자가 접근할 수 있는 곳에 함께 제공한다. 원본 자산과 폰트를 재배포할 때는 동봉 라이선스도 유지한다.
+
+공공누리 1유형은 저작자·출처를 요구하지만 영상 내 고정 위치를 지정하지 않는다. [CC BY 4.0 제3조(a)(2)](https://creativecommons.org/licenses/by/4.0/legalcode)는 매체·상황에 합리적인 방식의 표시와 링크를 허용한다. [CC BY 3.0 IGO 제4조(b)](https://creativecommons.org/licenses/by/3.0/igo/legalcode)도 매체에 합리적인 저작자·출처·가공 표시를 요구하며, 공동 기여자 크레딧을 별도로 넣으면 그 안에서 동등한 비중으로 표시해야 한다. 이 배포물의 기본 지도에는 영상 위 고정 워터마크 의무가 확인되지 않아 공개 설명란 크레딧 방식을 사용한다. 기계 메타데이터만 남기고 게시 출처를 생략하지 않는다. Natural Earth는 public domain이며 OFL은 폰트 파일 재배포 조건이다. 사용자 경계 파일은 WGS84 Polygon/MultiPolygon FeatureCollection이며 `map.attribution`에 필요한 출처표시를 지정한다. 지도는 한반도와 주변 동아시아를 대상으로 한다.
+
+공통 문자 수신음은 직접 합성한 CC0 음원이며 [생성 코드·이용조건](audio/README.md)을 동봉한다. 실제 기관의 경보음을 모방하지 않는다. 작품 고유의 로컬 음원에는 각각 `source`, `license`를 기록한다. 기술 검증 스크립트의 사인파도 직접 생성한 CC0 음원이다.
+
+Remotion은 [사용 주체별 라이선스 조건](https://www.remotion.dev/pricing)이 적용된다. MapLibre GL JS는 BSD-3-Clause, React는 MIT다.
+
+Tone.js 15.1.22는 MIT 라이선스이며 의존성에 해당 라이선스가 포함된다. 창작 스킬의 `examples/receipt.mjs`, `examples/texture.mjs`는 직접 작성한 CC0-1.0 음향 코드다. `dbs audio`는 코드로 만든 소리와 사용자가 제공한 로컬 샘플을 WAV로 출력한다. 샘플 사용권은 작품별 출처에 보존한다.

package/assets/REGION-LICENSE.txt

@@ -0,0 +1,48 @@
+DATA_LICENSE — admdongkor 경계 데이터 / boundary data
+
+이 파일은 admdongkor 저장소의 [데이터](행정동·시군구·시도 경계: geojson, parquet,
+중심점 등)에 적용됩니다. 소스 코드(js/, lib/ 등)는 별도로 MIT License(LICENSE)를 따릅니다.
+
+This file covers the DATA in this repository (administrative boundary files:
+geojson, parquet, centroids). Source code (js/, lib/) is licensed separately
+under the MIT License (see LICENSE).
+
+──────────────────────────────────────────────────────────
+
+1. 가공물 라이선스 / License of this dataset
+
+이 저장소가 추가·가공한 부분(경계 보정, 행정동 변경이력 반영, 코드 매칭 인덱스,
+시계열 데이터 등)은 Creative Commons Attribution 4.0 International (CC BY 4.0)
+으로 제공됩니다.
+  SPDX-License-Identifier: CC-BY-4.0
+  전문(Full text): https://creativecommons.org/licenses/by/4.0/  (국문: .../legalcode.ko)
+
+2. 원자료 조건 / Upstream source condition
+
+경계의 원자료는 통계청 통계지리정보서비스(SGIS)가 공공누리 제1유형(출처표시)으로
+개방한 행정동 경계입니다. 이 출처표시 의무는 가공 여부와 무관하게 유지되므로,
+본 데이터를 이용·재배포할 때 SGIS 출처표시를 반드시 보존해야 합니다.
+  공공누리 제1유형: https://www.kogl.or.kr/info/licenseType1.do
+
+The underlying boundaries originate from Statistics Korea (SGIS), released under
+the Korea Open Government License (KOGL) Type 1 (attribution). This requirement
+persists regardless of modification; SGIS attribution must be preserved.
+
+3. 출처 표기 / Required attribution
+
+본 데이터를 이용할 경우 아래 표기를 유지하시기 바랍니다.
+
+  "본 데이터는 통계청 통계지리정보서비스(SGIS, https://sgis.kostat.go.kr)에서
+   공공누리 제1유형으로 개방한 행정동 경계를 가공한 것이며(가공: vuski/admdongkor,
+   https://github.com/vuski/admdongkor), CC BY 4.0으로 배포됩니다."
+
+  "This data is derived from administrative-dong boundaries released by Statistics
+   Korea SGIS (https://sgis.kostat.go.kr) under KOGL Type 1, modified by
+   vuski/admdongkor (https://github.com/vuski/admdongkor), distributed under CC BY 4.0."
+
+4. 면책 / Disclaimer
+
+본 데이터는 "있는 그대로(as is)" 제공되며 정확성·완전성을 보증하지 않습니다.
+원자료 제공기관(SGIS)은 이 저장소의 가공 과정에서 발생한 오류에 대해 책임지지 않습니다.
+Provided "as is", without warranty. SGIS is not responsible for errors introduced
+by this repository's processing.

package/assets/attribution.json

@@ -0,0 +1,71 @@
+[
+  {
+    "id": "kr-boundaries",
+    "title": "대한민국 행정동 경계 (2026-07-01)",
+    "creator": "통계청 통계지리정보서비스(SGIS); 가공: vuski/admdongkor",
+    "sources": [
+      "https://sgis.kostat.go.kr",
+      "https://github.com/vuski/admdongkor/tree/master/ver20260701"
+    ],
+    "licenses": [
+      {
+        "name": "공공누리 제1유형",
+        "url": "https://www.kogl.or.kr/info/licenseType1.do"
+      },
+      {
+        "name": "CC BY 4.0",
+        "url": "https://creativecommons.org/licenses/by/4.0/"
+      }
+    ],
+    "changes": "원본 경계를 시군구·시도로 병합하고 영상 지도에 맞춰 색상과 표시 범위를 구성했습니다. 경계 좌표를 단순화하지 않았습니다.",
+    "notice": "본 데이터는 통계청 통계지리정보서비스(SGIS, https://sgis.kostat.go.kr)에서 공공누리 제1유형으로 개방한 행정동 경계를 가공한 것이며(가공: vuski/admdongkor, https://github.com/vuski/admdongkor), CC BY 4.0으로 배포됩니다."
+  },
+  {
+    "id": "prk-boundaries",
+    "title": "Democratic People's Republic of Korea administrative boundary (2018)",
+    "creator": "World Food Programme (WFP), OCHA Regional Office for Asia and the Pacific; 배포: geoBoundaries",
+    "sources": [
+      "https://data.humdata.org/dataset/dpr-korea-administrative-boundaries",
+      "https://github.com/wmgeolab/geoBoundaries/tree/9469f09/releaseData/gbOpen/PRK/ADM0"
+    ],
+    "licenses": [
+      {
+        "name": "CC BY 3.0 IGO",
+        "url": "https://creativecommons.org/licenses/by/3.0/igo/"
+      }
+    ],
+    "changes": "경계 좌표를 유지하고 표시용 속성·색상을 정리하여 영상 지도로 구성했습니다."
+  },
+  {
+    "id": "natural-earth",
+    "title": "Natural Earth 1:10m Admin 0 — Countries, version 5.1.2",
+    "creator": "Natural Earth contributors",
+    "sources": [
+      "https://github.com/nvkelso/natural-earth-vector/blob/v5.1.2/geojson/ne_10m_admin_0_countries.geojson"
+    ],
+    "licenses": [
+      {
+        "name": "Public domain",
+        "url": "https://www.naturalearthdata.com/about/terms-of-use/"
+      }
+    ],
+    "changes": "동아시아 주변국의 경계 좌표를 유지하고 영상 지도에 맞춰 속성·색상을 구성했습니다."
+  },
+  {
+    "id": "ibm-plex",
+    "title": "IBM Plex Sans KR / IBM Plex Mono",
+    "creator": "IBM Corp. / IBM Plex contributors",
+    "sources": [
+      "https://github.com/IBM/plex",
+      "https://fontsource.org/fonts/ibm-plex-sans-kr",
+      "https://fontsource.org/fonts/ibm-plex-mono"
+    ],
+    "licenses": [
+      {
+        "name": "SIL Open Font License 1.1",
+        "url": "https://github.com/IBM/plex/blob/master/LICENSE.txt"
+      }
+    ],
+    "changes": "공식 Fontsource 배포본의 글꼴을 변경 없이 오프라인 영상 본문·시각 표시에 사용했습니다."
+  }
+]

package/assets/audio/README.md

@@ -0,0 +1,9 @@
+# 공통 수신음
+
+`notification.wav`는 이 프로젝트가 Tone.js로 직접 합성한 창작 알림음이다. 실제 재난 경보음을 재현하지 않는다. PCM16·48kHz·모노·0.55초. CC0-1.0.
+
+소스는 `notification.mjs`다. 패키지 루트에서 재생성한다.
+
+```sh
+node dist/cli.js audio assets/audio/notification.mjs --duration 0.55 --channels 1 --seed 731 --out assets/audio/notification.wav --overwrite
+```

package/assets/audio/notification.mjs

@@ -0,0 +1,10 @@
+// Original notification sound, CC0-1.0. Not a reproduction of an official alert.
+export default function ({Tone, duration}) {
+  const gain = new Tone.Gain(0).toDestination();
+  gain.gain.setValueAtTime(0, 0);
+  gain.gain.linearRampToValueAtTime(0.42, 0.025);
+  gain.gain.setValueAtTime(0.42, 0.34);
+  gain.gain.linearRampToValueAtTime(0, 0.42);
+  const osc = new Tone.Oscillator(680, 'sine').connect(gain).start(0).stop(duration);
+  osc.frequency.setValueAtTime(510, 0.16);
+}

package/assets/workspace/README.md

@@ -0,0 +1,14 @@
+# 작품 작업공간
+
+`scenario.yaml`에 사건·문안·지도·연출을 작성한다. 창작 AI에게 사용자 범위에 설치한 `scenario-writing` 스킬을 사용하도록 요청한다. 형식과 참고자료는 [GitHub의 창작 스킬](https://github.com/neuwcodebox/disaster-broadcast-studio/tree/main/skills/scenario-writing)에 포함되어 있다. 이 작업공간은 스킬을 별도 복사하지 않는다.
+
+```sh
+npx dbs validate scenario.yaml
+npx dbs regions --search 철원
+npx dbs frame scenario.yaml --frame 600 --out preview.png
+npx dbs render scenario.yaml --out film.mp4
+```
+
+문자 도착 시 엔진의 공통 수신음이 재생된다. `alert.sound: false`로 끄거나 사용자 음원으로 바꾼다. `audio/`는 작품 고유 음원, `audio-code/`는 필요한 합성 코드를 두는 폴더다. [음향 가이드](https://github.com/neuwcodebox/disaster-broadcast-studio/blob/main/skills/scenario-writing/references/audio.md)를 참고한다.
+
+지역·기관·시각·문안을 작품에 맞게 바꾼다. 컷 내부는 실시간이며 시간 도약은 새 컷으로 지정한다. 결과와 함께 생성한 `.credits.txt`를 영상 게시 설명에 포함한다. 초기화는 npm 설치나 영상 게시를 수행하지 않는다.

package/assets/workspace/scenario.yaml

@@ -0,0 +1,34 @@
+version: 1
+title: 새 작품
+fictionNotice: 이 영상은 창작된 재난방송입니다. 실제 사건·재난문자·보도가 아닙니다.
+timezone: Asia/Seoul
+seed: 1
+agencies:
+  city: 가상시
+  news: 가상뉴스
+assets: {}
+map:
+  camera:
+    center: [127.7, 36.0]
+    zoom: 6.2
+cuts:
+  - id: first
+    duration: 30
+    storyTime: '2031-01-01T12:00:00+09:00'
+events:
+  - id: headline-1
+    type: news
+    cut: first
+    at: 5
+    duration: 25
+    source: news
+    headline: 방송 시스템 점검…후속 안내 대기
+  - id: alert-1
+    type: alert
+    cut: first
+    at: 7
+    sender: city
+    level: 안전안내
+    text: 방송 점검 중입니다. 다음 안내를 기다려 주십시오.
+    # dbs regions --search 지역명 으로 실제 코드를 검색한다.
+    regions: []

package/dist/assets.d.ts

@@ -0,0 +1,2 @@
+export declare const packageRoot: string;
+export declare function readBundledJson<T>(name: string): Promise<T>;

package/dist/assets.js

@@ -0,0 +1,9 @@
+import { readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import { gunzipSync } from 'node:zlib';
+import path from 'node:path';
+export const packageRoot = fileURLToPath(new URL('../', import.meta.url));
+export async function readBundledJson(name) {
+    const bytes = await readFile(path.join(packageRoot, 'assets', name));
+    return JSON.parse((name.endsWith('.gz') ? gunzipSync(bytes) : bytes).toString('utf8'));
+}

package/dist/audio/browser.d.ts

@@ -0,0 +1,13 @@
+export type AudioConfig = {
+    duration: number;
+    sampleRate: number;
+    channels: number;
+    seed: number;
+};
+export type AudioProgram = (options: AudioConfig & {
+    Tone: typeof import('tone');
+    context: import('tone').OfflineContext;
+    random: () => number;
+    asset: (relativePath: string) => string;
+}) => void | Promise<void>;
+export declare function registerAudio(program: AudioProgram, config: AudioConfig): void;

package/dist/audio/browser.js

@@ -0,0 +1,30 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import { Artifact, Composition, registerRoot, useDelayRender, cancelRender, staticFile } from 'remotion';
+import { encodeWav, seededRandom } from './wav.js';
+export function registerAudio(program, config) {
+    function OfflineSound() {
+        const { delayRender, continueRender } = useDelayRender();
+        const [handle] = useState(() => delayRender('Synthesizing offline Tone.js audio'));
+        const [result, setResult] = useState(null);
+        useEffect(() => {
+            (async () => {
+                Math.random = seededRandom(config.seed);
+                const Tone = await import('tone');
+                if (typeof program !== 'function')
+                    throw Error('Audio module must default-export a function');
+                const buffer = await Tone.Offline((context) => program({ ...config, Tone, context, random: seededRandom(config.seed), asset: staticFile }), config.duration, config.channels, config.sampleRate);
+                const channels = Array.from({ length: buffer.numberOfChannels }, (_, i) => buffer.getChannelData(i));
+                setResult(encodeWav(channels, config.sampleRate));
+                buffer.dispose();
+            })().catch(cancelRender);
+        }, []);
+        useEffect(() => { if (result)
+            continueRender(handle); }, [result]);
+        if (!result)
+            return null;
+        const { wav, ...stats } = result;
+        return _jsxs(_Fragment, { children: [_jsx(Artifact, { filename: "sound.wav", content: wav }), _jsx(Artifact, { filename: "sound.json", content: JSON.stringify({ ...config, ...stats, browser: navigator.userAgent }) })] });
+    }
+    registerRoot(() => _jsx(Composition, { id: "Sound", component: OfflineSound, width: 16, height: 16, fps: 60, durationInFrames: 1 }));
+}