@ghini/xstart 26.1.5151139 → 26.1.5160940

package/README.md

@@ -1,34 +1,22 @@
 # 一个标准 TypeScript 2026 的 npm 库脚手架
 
-### 开发
-
-```bash
-pnpm tsc --watch
-pnpm type-check  # 类型检查（不生成文件）
-pnpm build       # 编译 TypeScript + 打包 + 更新版本号
-```
+2026 版现代 TS 脚手架：基于 Node 24 原生 ESM，利用“源码直连”实现免 build 实时调试；通过 esbuild 抹除后缀并配合 publishConfig，兼顾开发爽感与发布标准，是极致紧凑的 npm 库闭环模板。
 
 ### 发布
 
 ```bash
+pnpm build       # 编译 TypeScript + 打包 + 更新版本号
+pnpm checkpub    # 检查发布内容
 pnpm pub         # 构建 + 发布到 npm + 提交 git
 ```
 
-## 🔧 TypeScript 配置亮点
-
-- `moduleResolution: "bundler"` - 2025 最新模块解析策略
-- `verbatimModuleSyntax: true` - 严格 ESM 语法
-- `strict: true` - 全部严格类型检查
-- `declaration: true` - 自动生成类型声明
-
-如果需要 pnpm 迁移：
+## 🔧 如果需要 pnpm 迁移：
 
 ```ps1
 pnpm import
 Remove-Item -Recurse -Force node_modules
 Remove-Item package-lock.json
 pnpm i
-pnpm tsc --watch
 ```
 
 ## 📦 创建新库
@@ -36,6 +24,8 @@ pnpm tsc --watch
 全文件替换 `xstart` 为新库名：
 
 ```bash
+git clone -b xstart git@github.com:xghini/mynpm.git
+rm -rf .git
 Remove-Item -Recurse -Force .git
 git init
 git add .
@@ -45,3 +35,12 @@ git remote add origin git@github.com:xghini/mynpm.git
 git push -u origin xstart
 pnpm pub
 ```
+
+💡 核心设计说明
+源码直连：package.json 中的 exports 在开发态指向 src/\*.ts，配合 Node.js 24 --experimental-strip-types 实现保存即生效，告别 tsc --watch。
+
+双模切换：利用 publishConfig 在发布时自动将入口切回 dist/\*.js，确保用户侧的兼容性。
+
+自动版本：build.js 内部集成日期版本算法（如 26.1.5161805），无需手动维护版本号。
+
+esbuild 抹除：构建阶段自动处理 .ts 后缀映射，生成的单文件 ESM 产物极其紧凑。

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export * from "./start.js";
+export * from './start.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,3 +1,8 @@
-// src/index.ts
-export * from "./start.js";
-//# sourceMappingURL=index.js.map
+// src/start.ts
+function start() {
+  console.log("Hello Ghini use ts");
+}
+export {
+  start
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1,7 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,cAAc,YAAY,CAAC"}
+{
+  "version": 3,
+  "sources": ["../src/start.ts"],
+  "sourcesContent": ["// start.ts\nexport { start };\n\nfunction start(): void {\n  console.log(\"Hello Ghini use ts\");\n}\n"],
+  "mappings": ";AAGA,SAAS,QAAc;AACrB,UAAQ,IAAI,oBAAoB;AAClC;",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghini/xstart",
-  "version": "26.1.5151139",
+  "version": "26.1.5160940",
   "type": "module",
   "author": "Ghini",
   "license": "MIT",
@@ -19,6 +19,7 @@
   ],
   "devDependencies": {
     "@types/node": "^25.0.3",
+    "esbuild": "^0.27.2",
     "typescript": "^5.9.3"
   },
   "scripts": {

package/src/index.ts

@@ -1,2 +1,2 @@
 // src/index.ts
-export * from "./start.js";
+export * from './start.ts';

package/dist/lib/index.d.ts

@@ -1,2 +0,0 @@
-export * from "../start.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/lib/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/lib/index.js

@@ -1,2 +0,0 @@
-export * from "../start.js";
-//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/lib/start.d.ts

@@ -1,3 +0,0 @@
-export { start };
-declare function start(): void;
-//# sourceMappingURL=start.d.ts.map

package/dist/lib/start.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/lib/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,CAAC;AAEjB,iBAAS,KAAK,IAAI,IAAI,CAErB"}

package/dist/lib/start.js

@@ -1,5 +0,0 @@
-export { start };
-function start() {
-    console.log("Hello Ghini use ts");
-}
-//# sourceMappingURL=start.js.map

package/dist/lib/start.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"start.js","sourceRoot":"","sources":["../../src/lib/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,CAAC;AAEjB,SAAS,KAAK;IACZ,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AACpC,CAAC"}

package/dist/main.d.ts

@@ -1,4 +0,0 @@
-declare const _default: any;
-export default _default;
-export * from "./lib/index.js";
-//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,wBAEC;AACD,cAAc,gBAAgB,CAAC"}

package/dist/main.js

@@ -1,6 +0,0 @@
-import * as index from "./lib/index.js";
-export default {
-    ...index,
-};
-export * from "./lib/index.js";
-//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,eAAe;IACb,GAAG,KAAK;CACT,CAAA;AACD,cAAc,gBAAgB,CAAC"}

package/dist/start.js

@@ -1,6 +0,0 @@
-// start.ts
-export { start };
-function start() {
-    console.log("Hello Ghini use ts");
-}
-//# sourceMappingURL=start.js.map

package/dist/start.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,OAAO,EAAE,KAAK,EAAE,CAAC;AAEjB,SAAS,KAAK;IACZ,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AACpC,CAAC"}