promptex-js 1.1.0 → 1.1.1-rc.2

package/dist/cli/main.js

@@ -153,7 +153,7 @@ function writeHuman(text) {
     if (STRUCTURED_OUTPUT)
         console.error(text);
     else
-        console.log(text);
+        writeStructuredLine(text);
 }
 /**
  * 用法字串。以函式承載而非模組層常數：語系在旗標解析完才設定（見下方 `setLocale`
@@ -751,7 +751,7 @@ function present(request) {
         if (toStderr)
             console.error(line.text);
         else
-            console.log(line.text);
+            writeStructuredLine(line.text);
     }
 }
 /**
@@ -781,7 +781,7 @@ function printManifestQuery({ platform, unit, installRoot, supported, nodes = []
     if (STRUCTURED_OUTPUT)
         console.error(query);
     else
-        console.log(query);
+        writeStructuredLine(query);
 }
 /**
  * 內建平台各寫入模式的結果。逐行清單由核心給，查詢指令的 JSON 另行組裝：後者
@@ -1375,7 +1375,7 @@ function printNotices(notices) {
         if (notice.stream === 'err' || STRUCTURED_OUTPUT)
             console.error(notice.text);
         else
-            console.log(notice.text);
+            writeStructuredLine(notice.text);
     }
 }
 /**

package/dist/cli/stdout.js

@@ -9,6 +9,10 @@
 // 改以 `writeSync` 直接寫檔案描述子並寫到全部送出。`process.stdout` 一旦初始化，
 // 描述子會被設成非阻塞：`writeSync` 可能只寫進一部分就返回，也可能在緩衝區
 // 滿時拋 `EAGAIN`，所以要依回傳的位元組數續寫，遇到 `EAGAIN` 稍等再試。
+//
+// 讀端提早關閉管線（`promptex build . | head -1`）時 `writeSync` 拋 `EPIPE`。
+// `console.log` 在這種情形會安靜結束，所以這裡也直接以 0 結束行程：沒有讀者，
+// 後面的輸出寫了也沒人收，往上拋只會在終端機印一份堆疊。
 import { writeSync } from 'node:fs';
 const STDOUT_FD = 1;
 /** `EAGAIN` 時的等待：`Atomics.wait` 是同步程式裡唯一不空轉的睡眠。 */
@@ -22,7 +26,10 @@ export function writeStructuredLine(text) {
             offset += writeSync(STDOUT_FD, bytes, offset);
         }
         catch (error) {
-            if (error.code !== 'EAGAIN')
+            const code = error.code;
+            if (code === 'EPIPE')
+                process.exit(0);
+            if (code !== 'EAGAIN')
                 throw error;
             Atomics.wait(pause, 0, 0, 1);
         }

package/dist/version.d.ts

@@ -6,10 +6,16 @@ interface SemVer {
     readonly patch: number;
 }
 export interface VersionRange {
-    readonly floor: SemVer;
+    /** 宣告的版本；宣告帶預發布識別（如 `^1.1.1-rc.1`）時，預發布識別放在選填的 `pre`。 */
+    readonly floor: SemVer & {
+        readonly pre?: readonly string[];
+    };
     readonly ceiling: SemVer;
 }
-/** 解析單一 caret 前綴範圍（如 `^2.0.0`）；缺前綴或版本格式不符回傳 null。 */
+/**
+ * 解析單一 caret 前綴範圍（如 `^2.0.0`）；缺前綴或版本格式不符回傳 null。
+ * 宣告帶預發布識別時，`floor.pre` 列出各段（正式版沒有這個欄位）。
+ */
 export declare function parseCaretRange(raw: string): VersionRange | null;
 export type VersionCheckResult = {
     readonly compatible: true;
@@ -28,6 +34,10 @@ export type VersionCheckResult = {
  * 需要升級：`framework-too-old`（已安裝版本低於範圍下限）或
  * `extension-too-old`（已安裝版本達到或超過範圍上限，擴充尚未宣告支援）。
  *
+ * 兩端的版本都可帶預發布識別（如 `1.1.1-rc.1`），比較照 SemVer 2.0.0 優先序：
+ * 預發布小於同核心的正式版。範圍的 floor 保留預發布，ceiling 不帶預發布，
+ * 所以 `2.0.0-rc.1` 對 `^1.1.1-rc.1` 判為相容（它小於 ceiling `2.0.0`）。
+ *
  * `frameworkVersion` 恆為 SDK 自身 `package.json` 的 `version` 欄位（呼叫端
  * 內部提供，非使用者輸入），格式不符視為框架自身的不變式被打破，直接拋出
  * 而非收斂為 Diagnostic；`declaredRange` 才是擴充作者的輸入，格式不符時

package/dist/version.js

@@ -9,33 +9,86 @@
 // 重造一個小型 semver 引擎；單一 caret 前綴涵蓋「擴充相容從某版本起、同主
 // 版本全部釋出」這個絕大多數情境，規則一句話能講完，可預測性優先於表達力。
 import { t } from './i18n.js';
-/** 解析 `MAJOR.MINOR.PATCH`（不含前綴），格式不符回傳 null。 */
+const NUMERIC = /^[0-9]+$/;
+const PRE_ID = /^[0-9A-Za-z-]+$/;
+const CORE = /^([0-9]+)\.([0-9]+)\.([0-9]+)$/;
+function isValidPreId(id) {
+    if (!PRE_ID.test(id))
+        return false;
+    // 純數字段不得有前導零（單獨的 "0" 合法）。
+    return !(NUMERIC.test(id) && id.length > 1 && id.startsWith('0'));
+}
+/**
+ * 解析 `MAJOR.MINOR.PATCH` 加選填的 `-<預發布識別>`（不含前綴），格式不符回傳
+ * null。預發布識別照 SemVer 2.0.0：以 `.` 分段，每段非空、只含 `[0-9A-Za-z-]`，
+ * 純數字段不得有前導零。build metadata（`+...`）不接受。
+ */
 function parseVersion(raw) {
-    const match = /^(\d+)\.(\d+)\.(\d+)$/.exec(raw.trim());
+    const text = raw.trim();
+    const dash = text.indexOf('-');
+    const corePart = dash === -1 ? text : text.slice(0, dash);
+    const match = CORE.exec(corePart);
     if (!match)
         return null;
-    return { major: Number(match[1]), minor: Number(match[2]), patch: Number(match[3]) };
+    const pre = dash === -1 ? [] : text.slice(dash + 1).split('.');
+    if (!pre.every(isValidPreId))
+        return null;
+    return { major: Number(match[1]), minor: Number(match[2]), patch: Number(match[3]), pre };
 }
+/** 預發布單段比較：數字段小於英數段；數字段先比長度再逐字（無前導零時等於數值比），英數段以 ASCII 字典序。 */
+function comparePreId(a, b) {
+    const aNumeric = NUMERIC.test(a);
+    const bNumeric = NUMERIC.test(b);
+    if (aNumeric && bNumeric) {
+        if (a.length !== b.length)
+            return a.length - b.length;
+        return a < b ? -1 : a > b ? 1 : 0;
+    }
+    if (aNumeric)
+        return -1;
+    if (bNumeric)
+        return 1;
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+/**
+ * SemVer 2.0.0 §11 優先序：先比核心；核心相同時，有預發布者小於沒有者；
+ * 兩者都有預發布時逐段比，前段全同則段數少者較小。
+ */
 function compare(a, b) {
     if (a.major !== b.major)
         return a.major - b.major;
     if (a.minor !== b.minor)
         return a.minor - b.minor;
-    return a.patch - b.patch;
+    if (a.patch !== b.patch)
+        return a.patch - b.patch;
+    if (a.pre.length === 0 && b.pre.length === 0)
+        return 0;
+    if (a.pre.length === 0)
+        return 1;
+    if (b.pre.length === 0)
+        return -1;
+    const shared = Math.min(a.pre.length, b.pre.length);
+    for (let i = 0; i < shared; i += 1) {
+        const order = comparePreId(a.pre[i], b.pre[i]);
+        if (order !== 0)
+            return order;
+    }
+    return a.pre.length - b.pre.length;
 }
 /**
  * caret 範圍的相容區間 ［floor, ceiling)：與 npm 語意一致，floor 即宣告本身，
  * ceiling 是「下一個可能引入不相容變動的版本」──主版本非 0 時為下一個主
  * 版本，主版本為 0 時退化為下一個副版本（0.x 系列慣例上副版本即可能不
- * 相容，之下的每個版本都當作獨立的相容單元）。
+ * 相容，之下的每個版本都當作獨立的相容單元）。ceiling 不帶預發布，所以
+ * 預發布的下一主版本（如 `2.0.0-rc.1`）小於 ceiling，仍判為相容。
  */
 function caretCeiling(floor) {
     if (floor.major > 0)
-        return { major: floor.major + 1, minor: 0, patch: 0 };
-    return { major: 0, minor: floor.minor + 1, patch: 0 };
+        return { major: floor.major + 1, minor: 0, patch: 0, pre: [] };
+    return { major: 0, minor: floor.minor + 1, patch: 0, pre: [] };
 }
-/** 解析單一 caret 前綴範圍（如 `^2.0.0`）；缺前綴或版本格式不符回傳 null。 */
-export function parseCaretRange(raw) {
+/** 內部用的範圍：floor 與 ceiling 都是完整的 ParsedVersion，floor 保留預發布。 */
+function parseRange(raw) {
     if (!raw.startsWith('^'))
         return null;
     const floor = parseVersion(raw.slice(1));
@@ -43,18 +96,34 @@ export function parseCaretRange(raw) {
         return null;
     return { floor, ceiling: caretCeiling(floor) };
 }
+/**
+ * 解析單一 caret 前綴範圍（如 `^2.0.0`）；缺前綴或版本格式不符回傳 null。
+ * 宣告帶預發布識別時，`floor.pre` 列出各段（正式版沒有這個欄位）。
+ */
+export function parseCaretRange(raw) {
+    const range = parseRange(raw);
+    if (!range)
+        return null;
+    const { pre, ...core } = range.floor;
+    const { major, minor, patch } = range.ceiling;
+    return { floor: pre.length > 0 ? { ...core, pre } : core, ceiling: { major, minor, patch } };
+}
 /**
  * 已安裝框架版本是否落在擴充宣告的相容範圍內；不相容時 `reason` 指出哪一方
  * 需要升級：`framework-too-old`（已安裝版本低於範圍下限）或
  * `extension-too-old`（已安裝版本達到或超過範圍上限，擴充尚未宣告支援）。
  *
+ * 兩端的版本都可帶預發布識別（如 `1.1.1-rc.1`），比較照 SemVer 2.0.0 優先序：
+ * 預發布小於同核心的正式版。範圍的 floor 保留預發布，ceiling 不帶預發布，
+ * 所以 `2.0.0-rc.1` 對 `^1.1.1-rc.1` 判為相容（它小於 ceiling `2.0.0`）。
+ *
  * `frameworkVersion` 恆為 SDK 自身 `package.json` 的 `version` 欄位（呼叫端
  * 內部提供，非使用者輸入），格式不符視為框架自身的不變式被打破，直接拋出
  * 而非收斂為 Diagnostic；`declaredRange` 才是擴充作者的輸入，格式不符時
  * 回傳 `malformed-range` 供呼叫端轉為使用者可見的診斷。
  */
 export function checkVersionCompatibility(frameworkVersion, declaredRange) {
-    const range = parseCaretRange(declaredRange);
+    const range = parseRange(declaredRange);
     if (!range)
         return { compatible: false, reason: 'malformed-range' };
     const framework = parseVersion(frameworkVersion);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "promptex-js",
-  "version": "1.1.0",
+  "version": "1.1.1-rc.2",
   "description": "TypeScript SDK、核心的預編譯二進位綁定與命令列工具，三者為同一次發布產出",
   "license": "MIT OR Apache-2.0",
   "author": "promptex-ai",
@@ -74,11 +74,11 @@
     "vitest": "^4.1.11"
   },
   "optionalDependencies": {
-    "promptex-js-darwin-arm64": "1.1.0",
-    "promptex-js-darwin-x64": "1.1.0",
-    "promptex-js-linux-arm64-gnu": "1.1.0",
-    "promptex-js-linux-x64-gnu": "1.1.0",
-    "promptex-js-win32-arm64-msvc": "1.1.0",
-    "promptex-js-win32-x64-msvc": "1.1.0"
+    "promptex-js-darwin-arm64": "1.1.1-rc.2",
+    "promptex-js-darwin-x64": "1.1.1-rc.2",
+    "promptex-js-linux-arm64-gnu": "1.1.1-rc.2",
+    "promptex-js-linux-x64-gnu": "1.1.1-rc.2",
+    "promptex-js-win32-arm64-msvc": "1.1.1-rc.2",
+    "promptex-js-win32-x64-msvc": "1.1.1-rc.2"
   }
 }