pa_font 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 hanyongpa
+
+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.

package/README.md

@@ -0,0 +1,112 @@
+# @hanyongpa/pa-font
+
+OpenType 폰트를 polygon, region, point 데이터로 바꿔 쓰기 위한 작은 geometry 라이브러리입니다.
+
+현재 `package.json` 기준 패키지 이름은 `@hanyongpa/pa-font`로 잡아두었습니다. 실제 publish 전에 원하는 scope나 이름이 있으면 이 값만 바꾸면 됩니다.
+
+## Install
+
+```bash
+npm install @hanyongpa/pa-font
+```
+
+## Quick Start
+
+```js
+import PAFont from "@hanyongpa/pa-font";
+
+const font = await PAFont.load("/assets/font.otf");
+
+const shape = font.text("안녕", {
+  x: 0,
+  y: 200,
+  size: 160,
+  flatten: 1,
+});
+
+const regions = shape.toRegions();
+const points = shape.toPoints({ step: 8 });
+```
+
+## Core Flow
+
+1. `PAFont.load(...)`로 폰트를 로드합니다.
+2. `font.text(...)` 또는 `font.glyph(...)`로 `PAShape`를 만듭니다.
+3. `shape.toShape(...)`, `shape.toRegions(...)`, `shape.toPoints(...)` 중 필요한 결과를 꺼냅니다.
+
+## Loading Fonts
+
+브라우저에서 가장 단순한 방식:
+
+```js
+const font = await PAFont.load("/assets/font.otf");
+```
+
+모듈 상대 경로를 기준으로 읽고 싶을 때:
+
+```js
+const font = await PAFont.load("./font.otf", {
+  base: import.meta.url,
+});
+```
+
+Node에서 바이트로 읽어 넘길 때:
+
+```js
+import { readFile } from "node:fs/promises";
+import PAFont from "@hanyongpa/pa-font";
+
+const bytes = await readFile("./fonts/font.otf");
+const font = await PAFont.load(bytes);
+```
+
+## Public API
+
+### `font.text(value, options)`
+
+문자열 전체를 하나의 `PAShape`로 만듭니다.
+
+### `font.glyph(value, options)`
+
+한 글자만 `PAShape`로 만듭니다.
+
+### `font.metrics(value, options)`
+
+텍스트 폭과 bounding box만 빠르게 계산합니다.
+
+### `shape.toShape({ step, openWidth })`
+
+hole 열기와 재샘플링을 적용한 뒤 새 `PAShape`를 반환합니다.
+
+### `shape.toRegions({ step, openWidth })`
+
+최종 도형을 plain polygon data로 반환합니다.
+
+```js
+const regions = font.glyph("영", { size: 160 }).toRegions({
+  step: 8,
+  openWidth: 1,
+});
+```
+
+### `shape.toPoints({ step, openWidth, includeHoles })`
+
+경계를 점 데이터로 샘플링합니다.
+
+### `shape.glyphs()`
+
+문장 shape를 글자별 shape 배열로 분리합니다.
+
+## Build
+
+라이브러리 빌드:
+
+```bash
+npm run build
+```
+
+패키징 확인:
+
+```bash
+npm run pack:check
+```