From a5faec5abf06ddb223c894120c72f3a69b213ba3 Mon Sep 17 00:00:00 2001
From: commilitia <git.commilitia@commilitia.net>
Date: Tue, 26 May 2026 17:25:34 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E8=A3=9C=20ESM=20`export=20{=20createC?=
 =?UTF-8?q?jkAutospace=20}`?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

下游 Vite / Rollup / TypeScript 靜態 ESM 解析需要真正之 `export`
關鍵字；原 UMD-ish（module.exports + globalThis）對 ESM 消費端
仍須走副作用導入 + globalThis 取值之 workaround。

於檔尾既有 CJS / globalThis 兩塊後再加 `export { createCjkAutospace }；
順序刻意如此，讓串接端（IIFE 函式體內不能有 module-level export）
只需以 `sed '/^export {/d'` 剝最後一行即安全。

four-form export 同時支援：ESM named import / CommonJS require /
globalThis / IIFE 串接（後者需剝 export 行）。README 同步補上。
---
 README.md        | 16 +++++++++++-----
 cjk-autospace.js | 18 +++++++++++++++++-
 2 files changed, 28 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 366afde..9a3abd3 100644
--- a/README.md
+++ b/README.md
@@ -64,12 +64,18 @@ autospace.apply(document.body);
 
 ## 模組形式
 
-UMD-ish：
+四種消費場景並存：
 
-- **ES module / TypeScript**：直接 `import { createCjkAutospace } from "./cjk-autospace.js"`（搭配 `cjk-autospace.d.ts`）
-- **CommonJS / Node**：`module.exports.createCjkAutospace`
-- **Browser global**：`globalThis.createCjkAutospace`
-- **Inline `<script>`**：函式宣告即註冊於 enclosing scope
+- **ES module / TypeScript**：`import { createCjkAutospace } from "./cjk-autospace.js"`（檔尾 `export { createCjkAutospace }`，配 `cjk-autospace.d.ts`）
+- **CommonJS / Node**：`require("./cjk-autospace.js").createCjkAutospace`（檔尾 `module.exports`）
+- **Browser global**：載入後可 `globalThis.createCjkAutospace`
+- **IIFE 串接**：把本檔內容 `cat` 進單一閉包（如 Claude 模板 `build.sh` / Nvim peek build hook）— `export {…}` 為 ESM module-level 語法，串入函式體內會語法錯誤，串接端須剝掉那行：
+
+    ```sh
+    sed '/^export[[:space:]]*{/d' cjk-autospace.js
+    ```
+
+    其餘 `module.exports` / `globalThis` 兩塊在閉包內安全（`typeof` 檢查不會 throw、globalThis 賦值無副作用）。
 
 ## 授權
 
diff --git a/cjk-autospace.js b/cjk-autospace.js
index a2359a8..ec4558d 100644
--- a/cjk-autospace.js
+++ b/cjk-autospace.js
@@ -555,7 +555,22 @@ function createCjkAutospace(options)
     return { apply: apply };
 }
 
-/* ----- UMD-ish export ----- */
+/* ----- 多形 export -----
+ *
+ * 四種消費場景並存：
+ *   ESM（Vite / Rollup / TypeScript）：使用 `export { createCjkAutospace }`，
+ *     可 `import { createCjkAutospace } from "./cjk-autospace.js"`；
+ *   CommonJS（Node `require`）：使用 `module.exports`；
+ *   Browser global / `<script>` 標籤：使用 `globalThis` 賦值；
+ *   IIFE 串接（build.sh / Nvim peek hook 把本檔內容 cat 進單個閉包）：
+ *     `export` 語句屬 ESM 之 module-level 語法，串入函式體內會語法錯誤，
+ *     故串接端須剝掉 `export {` 起始之那行（單行 `sed '/^export {/d'`
+ *     即可）。其餘 module.exports / globalThis 兩塊在閉包內安全（typeof
+ *     檢查不會 throw、globalThis 賦值無副作用）。
+ *
+ * 順序：先 CJS / globalThis（不影響語法解析），最後 ESM `export`，
+ * 讓串接端只需剝最後一塊。
+ */
 if (typeof module !== "undefined" && module.exports)
 {
     module.exports = { createCjkAutospace: createCjkAutospace };
@@ -564,3 +579,4 @@ if (typeof globalThis !== "undefined" && !globalThis.createCjkAutospace)
 {
     globalThis.createCjkAutospace = createCjkAutospace;
 }
+export { createCjkAutospace };