native ESM 対応、およびテスト・ビルドの設定最新化 (#13)

* build: publish対象のfilesを修正

* docs: update AGENTS.md

* chore: update fontkit

* chore: relative import path にファイル拡張子を付与

* build: update tsconfig

* chore: use type-only exports

* chore: update package.json types and exports

* build: CJS形式のビルドを廃止

* test: Jestのモジュール解決が失敗するようになったのを解消

* build: 各種 preset shaper クラスを露出

* chore: install vitest

* fix: UPNGのimportが失敗するケースに対する暫定措置

* test: relative import path にファイル拡張子を付与、かつJestからvitestに移行

* chore: uninstall Jest

* docs: update AGENTS.md

* test: apps下のテストコードを更新

* build: ビルド結果の es, umd を dist ディレクトリー下に移動

* test: refactor fontkit import

* docs: 古いドキュメントに注意書きを追加

* test: apps系のテストを最新化

* docs: update changelog

* style: run lint fix

* test: fix import paths in scratchpad

* ci: fix pipelines

* ci: improve npm scripts

* test: minor fix

* ci: テスト・ビルド用の npm scripts および tsconfig を全体的に整理

* chore: add "engines" in package.json

* docs: update AGENTS.md

---------

Co-authored-by: FAL <contact@fal-works.com>

Author: falworks-dy

.github/workflows/npm-publish-github-packages.yml

@@ -27,9 +27,7 @@ jobs:
         with:
           name: build-output
           path: |
-            cjs/
-            es/
-            umd/
+            dist/
 
   publish-gpr:
     needs: build

.github/workflows/test.yml

@@ -33,7 +33,8 @@ jobs:
           NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
       - run: yarn dev:prep
-
       - run: yarn typecheck
       - run: yarn lint
       - run: yarn test
+      - run: yarn build
+      - run: yarn apps:typecheck

.gitignore

@@ -3,7 +3,6 @@ apps/node-build/
 node_modules/
 coverage/
 ts3.4/
-build/
 umd/
 cjs/
 es/

AGENTS.md

@@ -2,26 +2,32 @@
 
 ## Mission & Purpose
 - `@denkiyagi/pdf-lib` extends the upstream `pdf-lib` to power PDF generation for `yagisan-reports`, a PDF report generation engine.
-- Current focus areas: richer custom font handling via `@denkiyagi/fontkit`, groundwork for improved error handling, adding PDF encryption support, and fixing upstream bugs.
+- Current focus areas: richer custom font handling via `@denkiyagi/fontkit`, improved error handling, adding PDF encryption support, native ESM support, and fixing upstream bugs.
 - Keep the fork aligned with upstream quality while preserving `yagisan-reports`-specific behaviors; prefer additive changes and call out intentional divergences in `MODIFICATIONS.md` or `MODIFICATION-DEVELOPMENT.md`.
 
 ## Project Orientation
 - `src/` – Primary TypeScript source for the library; exports must remain framework-agnostic and compatible with browsers and Node.
-- `tests/` – Jest-powered regression coverage.
+- `tests/` – vitest-powered unit tests.
 - `apps/` – Example and manual-test harnesses used to validate real-world document flows.
+- `dist/` – Build outputs (`dist/es` ESM + typings, `dist/umd` UMD bundle).
 - `assets/` – Sample PDFs, fonts, and images consumed by docs and tests; treat as fixtures when updating expectations.
-- `build/`, `rollup.config.mjs`, `tsconfig.json`, `jest.json` – Tooling scaffolding for bundling, type emission, and tests.
-- `docs/` – Markdown/docs site material mirrored from upstream; update only when behavior changes.
+- `tsconfig.json`, `tsconfig.build.json`, `rollup.config.mjs`, `vitest.config.ts` – Tooling scaffolding for bundling, type emission, and tests.
+- `docs/` – Markdown/docs site material mirrored from upstream. CAUTION: do not rely on them; they may be outdated.
 - `scratchpad/` – Throwaway experiments; do not rely on contents for production logic.
 
 ## Tech Stack
 - Node.js 20+ runtime, Yarn package manager.
-- TypeScript 4.x across source and typings.
+- TypeScript 5.x across source and typings.
+- Native ES modules both for source and build outputs.
+- vitest for unit testing.
 - Critical dependency: `@denkiyagi/fontkit` (our fork) powers font parsing, embedding, and subsetting.
 
 ## Common Commands
-- `yarn typecheck` – Checks TypeScript types across the codebase.
-- `yarn lint` – Runs the lint rules expected by CI; fix warnings locally to avoid pipeline noise.
+- `yarn typecheck` – Checks TypeScript types across `src/` and `tests/`.
+- `yarn lint` – Runs and fixes the lint rules expected by CI.
+- `yarn test` – Runs the full test suite once.
+- `yarn build` – Builds the library into `dist/` (uses `tsconfig.build.json`).
+- `yarn apps:typecheck` – Checks TypeScript types across `apps/` (requires a prior build).
 
 ## Helpful References
 - Change log: `MODIFICATIONS.md` (what differs from upstream).

MODIFICATIONS.md

@@ -1,5 +1,11 @@
 # Modifications
 
+## [Unreleased]
+
+- Native ESM everywhere: all src/tests/apps use `.js`-suffixed local imports; Jest replaced with vitest; CJS build removed.
+- Build outputs relocated to `dist/`: `dist/es` (native ESM + typings) and `dist/umd` (bundled).
+- Package now uses conditional exports; consumers must import via the published entry points (`import`/`exports` map) rather than deep-linking files.
+
 ## [1.17.1-mod.2025.8]
 
 ### Feature Removals

apps/node/index.ts

@@ -4,26 +4,26 @@ import os from 'os';
 import { sep } from 'path';
 import readline from 'readline';
 
-import test1 from './tests/test1';
-import test2 from './tests/test2';
-import test3 from './tests/test3';
-import test4 from './tests/test4';
-import test5 from './tests/test5';
-import test6 from './tests/test6';
-import test7 from './tests/test7';
-import test8 from './tests/test8';
-import test9 from './tests/test9';
-import test10 from './tests/test10';
-import test11 from './tests/test11';
-import test12 from './tests/test12';
-import test13 from './tests/test13';
-import test14 from './tests/test14';
-import test15 from './tests/test15';
-import test16 from './tests/test16';
-import test17 from './tests/test17';
-import test18 from './tests/test18';
-import test19 from './tests/test19';
-import test20 from './tests/test20';
+import test1 from './tests/test1.js';
+import test2 from './tests/test2.js';
+import test3 from './tests/test3.js';
+import test4 from './tests/test4.js';
+import test5 from './tests/test5.js';
+import test6 from './tests/test6.js';
+import test7 from './tests/test7.js';
+import test8 from './tests/test8.js';
+import test9 from './tests/test9.js';
+import test10 from './tests/test10.js';
+import test11 from './tests/test11.js';
+import test12 from './tests/test12.js';
+import test13 from './tests/test13.js';
+import test14 from './tests/test14.js';
+import test15 from './tests/test15.js';
+import test16 from './tests/test16.js';
+import test17 from './tests/test17.js';
+import test18 from './tests/test18.js';
+import test19 from './tests/test19.js';
+import test20 from './tests/test20.js';
 
 const cli = readline.createInterface({
   input: process.stdin,

apps/node/tests/test1.ts

@@ -1,4 +1,4 @@
-import { Assets } from '..';
+import { Assets } from '../index.js';
 import {
   clip,
   clipEvenOdd,
@@ -18,9 +18,9 @@ import {
   rgb,
   setLineJoin,
   StandardFonts,
-} from '../../..';
-import { AFRelationship } from '../../../cjs/core';
-import { typedArrayFor } from '../../../cjs/utils';
+} from '../../../dist/es/index.js';
+import { AFRelationship } from '../../../dist/es/core/index.js';
+import { typedArrayFor } from '../../../dist/es/utils/index.js';
 
 const ipsumLines = [
   'Eligendi est pariatur quidem in non excepturi et.',

apps/node/tests/test10.ts

@@ -1,5 +1,5 @@
-import { Assets } from '..';
-import { PDFDocument, StandardFonts, PDFFont } from '../../..';
+import { Assets } from '../index.js';
+import { PDFDocument, StandardFonts, PDFFont } from '../../../dist/es/index.js';
 
 // prettier-ignore
 const winAnsiCodePoints = [

apps/node/tests/test11.ts

@@ -1,6 +1,6 @@
-import { Assets } from '..';
-import { PDFDocument, PDFFont, StandardFonts } from '../../..';
-import { charAtIndex, last } from '../../../cjs/utils';
+import { Assets } from '../index.js';
+import { PDFDocument, PDFFont, StandardFonts } from '../../../dist/es/index.js';
+import { charAtIndex, last } from '../../../dist/es/utils/index.js';
 
 const breakTextIntoLines = (
   text: string,

apps/node/tests/test12.ts

@@ -1,4 +1,4 @@
-import { Assets } from '..';
+import { Assets } from '../index.js';
 import {
   PageSizes,
   PDFDocument,
@@ -8,8 +8,8 @@ import {
   degrees,
   rgb,
   grayscale,
-} from '../../..';
-import { values } from '../../../cjs/utils';
+} from '../../../dist/es/index.js';
+import { values } from '../../../dist/es/utils/index.js';
 
 const inchToPt = (inches: number) => Math.round(inches * 72);