@betteroffice/fonts-cjk 0.3.0 → 0.4.1

package/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2026 The OpenOOXML contributors
+   Copyright 2026 Elia Hilse, The OpenOOXML Project
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -1,23 +1,27 @@
 # @betteroffice/fonts-cjk
 
-Optional CJK font binaries for [`@betteroffice/fonts`](https://www.npmjs.com/package/@betteroffice/fonts). Install it alongside the base package when your documents contain Chinese, Japanese or Korean text:
+Chinese, Japanese and Korean faces for [`@betteroffice/fonts`](https://www.npmjs.com/package/@betteroffice/fonts).
+The five faces add 33 MB, so they ship as a separate, optional package.
 
-```sh
-npm install @betteroffice/fonts @betteroffice/fonts-cjk
+## Install
+
+```bash
+bun add @betteroffice/fonts @betteroffice/fonts-cjk
 ```
 
-Then hand the base module to the engine once, before any editor mounts — `configureDefaultFonts({ fonts })` from `@betteroffice/docx/layout`, as the [`@betteroffice/fonts` README](https://www.npmjs.com/package/@betteroffice/fonts) shows. `@betteroffice/fonts` picks these faces up through an optional dynamic import, so once the base package is configured the CJK script-fallback chain resolves as soon as this one is present.
+## Usage
 
-## Why a separate package
+No import from this package is needed. Install it next to `@betteroffice/fonts` and configure that
+package once; it loads these faces through an optional dynamic import.
 
-A separate package makes CJK binaries an explicit installation choice.
+```ts
+import { configureDefaultFonts } from '@betteroffice/docx/layout';
+import * as fonts from '@betteroffice/fonts';
 
-| Package                   | Faces | Size on disk |
-| ------------------------- | ----- | ------------ |
-| `@betteroffice/fonts`     | 65    | 14.2 MB      |
-| `@betteroffice/fonts-cjk` | 5     | 33 MB        |
+configureDefaultFonts({ fonts });
+```
 
-The overwhelming majority of documents need only the base package. Measured over 100 real-world English documents, Calibri appears in 91%, Times New Roman in 79%, Arial in 56% and Cambria in 52% — all covered by the base package's metric-compatible Latin set.
+The `@betteroffice/fonts/cdn` entry loads the CJK faces from a CDN without installing this package.
 
 ## Contents
 
@@ -29,22 +33,24 @@ The overwhelming majority of documents need only the base package. Measured over
 | Noto Sans JP   | MS (P)Gothic, MS (P)Mincho, Meiryo, Yu Gothic, Yu Mincho (ＭＳ ゴシック, ＭＳ 明朝, メイリオ, 游ゴシック, 游明朝) | `cjk-jp`      | OFL 1.1 | 2.004   |
 | Noto Sans KR   | Malgun Gothic, Gulim, Dotum, Batang, Gungsuh (맑은 고딕, 굴림, 돋움, 바탕, 궁서)                                  | `cjk-kr`      | OFL 1.1 | 2.004   |
 
-Notes:
-
-- These Noto faces provide Chinese, Japanese and Korean glyph coverage.
-- Each face ships Regular. Ming, Mincho and Batang families map to regional Noto Sans faces.
-- These are noto-cjk's static `SubsetOTF` Regulars, so browser and Rust measurement read identical advances.
+Each face ships Regular. Ming, Mincho and Batang families map to the regional Noto Sans faces. The
+files are noto-cjk's static `SubsetOTF` Regulars, so the browser and the engine measure the same
+advances.
 
 ## API
 
-You do not normally import this package. `@betteroffice/fonts` resolves it on its own; the single export exists so bundlers emit the assets.
-
 ```ts
 import { CJK_FONT_ASSET_URLS } from '@betteroffice/fonts-cjk';
 ```
 
-`CJK_FONT_ASSET_URLS` maps an asset filename to a `() => URL` resolver, keyed exactly as `@betteroffice/fonts`' face manifest names the files.
+`CJK_FONT_ASSET_URLS` maps each asset filename, as named in the `@betteroffice/fonts` manifest, to a
+`() => URL` resolver. It exists so bundlers emit the assets; hosts do not normally import it.
+
+## Documentation
+
+- [`@betteroffice/fonts`](https://www.npmjs.com/package/@betteroffice/fonts)
+- [Packages and fonts](https://docs.betteroffice.dev/docs/packages#fonts)
 
 ## Licensing
 
-The loader code is Apache-2.0 (see `LICENSE`). The font binaries are licensed under the SIL Open Font License 1.1; `LICENSES/OFL-NotoCJK.txt` carries the full licence text preceded by the copyright notices it applies to — Copyright 2014-2021 Adobe for Noto Sans SC/TC/JP/KR, and Copyright 2017-2024 Adobe for Noto Serif SC, both with Reserved Font Name "Source". Static `SubsetOTF` Regulars vendored from [notofonts/noto-cjk](https://github.com/notofonts/noto-cjk) at commit `f8d157532fbfaeda587e826d4cd5b21a49186f7c` (`Sans/SubsetOTF/{SC,TC,JP,KR}/`, `Serif/SubsetOTF/SC/`).
+The loader code is Apache-2.0 (see `LICENSE`). The font binaries are licensed under the SIL Open Font License 1.1; `LICENSES/OFL-NotoCJK.txt` carries the full license text preceded by the copyright notices it applies to. Notices: Copyright 2014-2021 Adobe for Noto Sans SC/TC/JP/KR, and Copyright 2017-2024 Adobe for Noto Serif SC, both with Reserved Font Name "Source". Static `SubsetOTF` Regulars vendored from [notofonts/noto-cjk](https://github.com/notofonts/noto-cjk) at commit `f8d157532fbfaeda587e826d4cd5b21a49186f7c` (`Sans/SubsetOTF/{SC,TC,JP,KR}/`, `Serif/SubsetOTF/SC/`).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@betteroffice/fonts-cjk",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Optional CJK font binaries for @betteroffice/fonts: Noto Sans SC/TC/JP/KR and Noto Serif SC coverage faces for Chinese, Japanese and Korean documents.",
   "sideEffects": false,
   "type": "module",
@@ -47,6 +47,9 @@
     "url": "https://github.com/openooxml/betteroffice.git",
     "directory": "packages/fonts-cjk"
   },
+  "bugs": {
+    "url": "https://github.com/openooxml/betteroffice/issues"
+  },
   "publishConfig": {
     "access": "public"
   }