@my-games/sudoku-core 0.0.0-stage → 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xyj2156
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,21 @@
-# Temporary Holding Version
+# @my-games/sudoku-core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> 数独引擎核心，纯 TypeScript、无框架依赖。**当前为 `0.0.0` 占位版本**，
+> 仅导出占位常量，用于种下 npm 首版并配置 Trusted Publisher。
+
+```bash
+pnpm add @my-games/sudoku-core
+```
+
+```ts
+import { SUDOKU_PACKAGE, SUDOKU_STAGE } from '@my-games/sudoku-core';
+```
+
+真实引擎（`Sudoku` 类 + 求解器 + 生成器 + 存档）将在占位包发布后作为后续提交补入。
+产出 ESM / CJS / UMD / IIFE 四格式；IIFE/UMD 全局名 `SudokuCore`。样式：`@my-games/sudoku-core/style.css`。
+
+完整说明见仓库根 README：<https://github.com/my-gam/sudoku#readme>
+
+## License
+
+MIT.

package/dist/index.cjs

@@ -0,0 +1,21 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+// src/index.ts
+/**
+* @my-games/sudoku-core —— `0.0.0` 占位实现。
+*
+* 这是一个「空包」骨架：目的仅是把 monorepo 的
+* `build → verify:dist → typecheck → test` 门禁与 npm Trusted Publisher 链路跑通，
+* 好让首版（可信发布者无法发某包的第一个版本）能先手工种进 registry。
+*
+* 真实数独引擎 —— 棋盘校验、回溯求解器、唯一解题生成、`Sudoku` 状态机
+* （选格/填数/擦除/笔记/提示/撤销/计时）、注入式存档与最佳用时 —— 已在占位包
+* 发布前按同一三层结构写好并暂存，待 `0.0.0` 上线后作为后续提交补回。
+*/
+/** 包标识占位。 */
+var SUDOKU_PACKAGE = "sudoku-core";
+/** 占位版本，与 package.json 的 version 对齐，便于确认发的是 stage 包。 */
+var SUDOKU_STAGE = "0.0.0";
+exports.SUDOKU_PACKAGE = SUDOKU_PACKAGE;
+exports.SUDOKU_STAGE = SUDOKU_STAGE;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @my-games/sudoku-core —— `0.0.0` 占位实现。\n *\n * 这是一个「空包」骨架：目的仅是把 monorepo 的\n * `build → verify:dist → typecheck → test` 门禁与 npm Trusted Publisher 链路跑通，\n * 好让首版（可信发布者无法发某包的第一个版本）能先手工种进 registry。\n *\n * 真实数独引擎 —— 棋盘校验、回溯求解器、唯一解题生成、`Sudoku` 状态机\n * （选格/填数/擦除/笔记/提示/撤销/计时）、注入式存档与最佳用时 —— 已在占位包\n * 发布前按同一三层结构写好并暂存，待 `0.0.0` 上线后作为后续提交补回。\n */\n\n/** 包标识占位。 */\nexport const SUDOKU_PACKAGE = 'sudoku-core' as const;\n\n/** 占位版本，与 package.json 的 version 对齐，便于确认发的是 stage 包。 */\nexport const SUDOKU_STAGE = '0.0.0' as const;\n"],"mappings":";;;;;;;;;;;;;;AAaA,IAAa,iBAAiB;;AAG9B,IAAa,eAAe"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @my-games/sudoku-core —— `0.0.0` 占位实现。
+ *
+ * 这是一个「空包」骨架：目的仅是把 monorepo 的
+ * `build → verify:dist → typecheck → test` 门禁与 npm Trusted Publisher 链路跑通，
+ * 好让首版（可信发布者无法发某包的第一个版本）能先手工种进 registry。
+ *
+ * 真实数独引擎 —— 棋盘校验、回溯求解器、唯一解题生成、`Sudoku` 状态机
+ * （选格/填数/擦除/笔记/提示/撤销/计时）、注入式存档与最佳用时 —— 已在占位包
+ * 发布前按同一三层结构写好并暂存，待 `0.0.0` 上线后作为后续提交补回。
+ */
+/** 包标识占位。 */
+export declare const SUDOKU_PACKAGE: "sudoku-core";
+/** 占位版本，与 package.json 的 version 对齐，便于确认发的是 stage 包。 */
+export declare const SUDOKU_STAGE: "0.0.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,aAAa;AACb,eAAO,MAAM,cAAc,EAAG,aAAsB,CAAC;AAErD,wDAAwD;AACxD,eAAO,MAAM,YAAY,EAAG,OAAgB,CAAC"}

package/dist/index.iife.js

@@ -0,0 +1,24 @@
+var SudokuCore = (function(exports) {
+	Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+	// src/index.ts
+	/**
+	* @my-games/sudoku-core —— `0.0.0` 占位实现。
+	*
+	* 这是一个「空包」骨架：目的仅是把 monorepo 的
+	* `build → verify:dist → typecheck → test` 门禁与 npm Trusted Publisher 链路跑通，
+	* 好让首版（可信发布者无法发某包的第一个版本）能先手工种进 registry。
+	*
+	* 真实数独引擎 —— 棋盘校验、回溯求解器、唯一解题生成、`Sudoku` 状态机
+	* （选格/填数/擦除/笔记/提示/撤销/计时）、注入式存档与最佳用时 —— 已在占位包
+	* 发布前按同一三层结构写好并暂存，待 `0.0.0` 上线后作为后续提交补回。
+	*/
+	/** 包标识占位。 */
+	var SUDOKU_PACKAGE = "sudoku-core";
+	/** 占位版本，与 package.json 的 version 对齐，便于确认发的是 stage 包。 */
+	var SUDOKU_STAGE = "0.0.0";
+	exports.SUDOKU_PACKAGE = SUDOKU_PACKAGE;
+	exports.SUDOKU_STAGE = SUDOKU_STAGE;
+	return exports;
+})({});
+
+//# sourceMappingURL=index.iife.js.map

package/dist/index.iife.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.iife.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @my-games/sudoku-core —— `0.0.0` 占位实现。\n *\n * 这是一个「空包」骨架：目的仅是把 monorepo 的\n * `build → verify:dist → typecheck → test` 门禁与 npm Trusted Publisher 链路跑通，\n * 好让首版（可信发布者无法发某包的第一个版本）能先手工种进 registry。\n *\n * 真实数独引擎 —— 棋盘校验、回溯求解器、唯一解题生成、`Sudoku` 状态机\n * （选格/填数/擦除/笔记/提示/撤销/计时）、注入式存档与最佳用时 —— 已在占位包\n * 发布前按同一三层结构写好并暂存，待 `0.0.0` 上线后作为后续提交补回。\n */\n\n/** 包标识占位。 */\nexport const SUDOKU_PACKAGE = 'sudoku-core' as const;\n\n/** 占位版本，与 package.json 的 version 对齐，便于确认发的是 stage 包。 */\nexport const SUDOKU_STAGE = '0.0.0' as const;\n"],"mappings":";;;;;;;;;;;;;;;CAaA,IAAa,iBAAiB;;CAG9B,IAAa,eAAe"}

package/dist/index.js

@@ -0,0 +1,19 @@
+// src/index.ts
+/**
+* @my-games/sudoku-core —— `0.0.0` 占位实现。
+*
+* 这是一个「空包」骨架：目的仅是把 monorepo 的
+* `build → verify:dist → typecheck → test` 门禁与 npm Trusted Publisher 链路跑通，
+* 好让首版（可信发布者无法发某包的第一个版本）能先手工种进 registry。
+*
+* 真实数独引擎 —— 棋盘校验、回溯求解器、唯一解题生成、`Sudoku` 状态机
+* （选格/填数/擦除/笔记/提示/撤销/计时）、注入式存档与最佳用时 —— 已在占位包
+* 发布前按同一三层结构写好并暂存，待 `0.0.0` 上线后作为后续提交补回。
+*/
+/** 包标识占位。 */
+var SUDOKU_PACKAGE = "sudoku-core";
+/** 占位版本，与 package.json 的 version 对齐，便于确认发的是 stage 包。 */
+var SUDOKU_STAGE = "0.0.0";
+export { SUDOKU_PACKAGE, SUDOKU_STAGE };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @my-games/sudoku-core —— `0.0.0` 占位实现。\n *\n * 这是一个「空包」骨架：目的仅是把 monorepo 的\n * `build → verify:dist → typecheck → test` 门禁与 npm Trusted Publisher 链路跑通，\n * 好让首版（可信发布者无法发某包的第一个版本）能先手工种进 registry。\n *\n * 真实数独引擎 —— 棋盘校验、回溯求解器、唯一解题生成、`Sudoku` 状态机\n * （选格/填数/擦除/笔记/提示/撤销/计时）、注入式存档与最佳用时 —— 已在占位包\n * 发布前按同一三层结构写好并暂存，待 `0.0.0` 上线后作为后续提交补回。\n */\n\n/** 包标识占位。 */\nexport const SUDOKU_PACKAGE = 'sudoku-core' as const;\n\n/** 占位版本，与 package.json 的 version 对齐，便于确认发的是 stage 包。 */\nexport const SUDOKU_STAGE = '0.0.0' as const;\n"],"mappings":";;;;;;;;;;;;;AAaA,IAAa,iBAAiB;;AAG9B,IAAa,eAAe"}

package/dist/index.umd.js

@@ -0,0 +1,25 @@
+(function(global, factory) {
+	typeof exports === "object" && typeof module !== "undefined" ? factory(exports) : typeof define === "function" && define.amd ? define(["exports"], factory) : (global = typeof globalThis !== "undefined" ? globalThis : global || self, factory(global.SudokuCore = {}));
+})(this, function(exports) {
+	Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+	// src/index.ts
+	/**
+	* @my-games/sudoku-core —— `0.0.0` 占位实现。
+	*
+	* 这是一个「空包」骨架：目的仅是把 monorepo 的
+	* `build → verify:dist → typecheck → test` 门禁与 npm Trusted Publisher 链路跑通，
+	* 好让首版（可信发布者无法发某包的第一个版本）能先手工种进 registry。
+	*
+	* 真实数独引擎 —— 棋盘校验、回溯求解器、唯一解题生成、`Sudoku` 状态机
+	* （选格/填数/擦除/笔记/提示/撤销/计时）、注入式存档与最佳用时 —— 已在占位包
+	* 发布前按同一三层结构写好并暂存，待 `0.0.0` 上线后作为后续提交补回。
+	*/
+	/** 包标识占位。 */
+	var SUDOKU_PACKAGE = "sudoku-core";
+	/** 占位版本，与 package.json 的 version 对齐，便于确认发的是 stage 包。 */
+	var SUDOKU_STAGE = "0.0.0";
+	exports.SUDOKU_PACKAGE = SUDOKU_PACKAGE;
+	exports.SUDOKU_STAGE = SUDOKU_STAGE;
+});
+
+//# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.umd.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @my-games/sudoku-core —— `0.0.0` 占位实现。\n *\n * 这是一个「空包」骨架：目的仅是把 monorepo 的\n * `build → verify:dist → typecheck → test` 门禁与 npm Trusted Publisher 链路跑通，\n * 好让首版（可信发布者无法发某包的第一个版本）能先手工种进 registry。\n *\n * 真实数独引擎 —— 棋盘校验、回溯求解器、唯一解题生成、`Sudoku` 状态机\n * （选格/填数/擦除/笔记/提示/撤销/计时）、注入式存档与最佳用时 —— 已在占位包\n * 发布前按同一三层结构写好并暂存，待 `0.0.0` 上线后作为后续提交补回。\n */\n\n/** 包标识占位。 */\nexport const SUDOKU_PACKAGE = 'sudoku-core' as const;\n\n/** 占位版本，与 package.json 的 version 对齐，便于确认发的是 stage 包。 */\nexport const SUDOKU_STAGE = '0.0.0' as const;\n"],"mappings":";;;;;;;;;;;;;;;;;CAaA,IAAa,iBAAiB;;CAG9B,IAAa,eAAe"}

package/package.json

@@ -1,6 +1,83 @@
 {
   "name": "@my-games/sudoku-core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.1",
+  "description": "Framework-agnostic Sudoku game engine with a backtracking solver and unique-puzzle generator; ships ESM, CJS, UMD and IIFE builds. 无框架依赖的数独引擎，四格式产出。",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "browser": "./dist/index.iife.js",
+  "types": "./dist/index.d.ts",
+  "unpkg": "./dist/index.iife.js",
+  "jsdelivr": "./dist/index.iife.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./umd": "./dist/index.umd.js",
+    "./iife": "./dist/index.iife.js",
+    "./style.css": "./src/style.css",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "sideEffects": [
+    "./src/style.css"
+  ],
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "vite": "^8.3.5",
+    "vite-plugin-dts": "^5.1.2",
+    "vitest": "^5.0.5"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "sudoku",
+    "game",
+    "game-engine",
+    "puzzle",
+    "core",
+    "solver",
+    "generator",
+    "backtracking",
+    "typescript",
+    "esm",
+    "cjs",
+    "umd",
+    "iife",
+    "browser",
+    "h5",
+    "mobile-web",
+    "zero-dependencies",
+    "cross-framework"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "xyj2156"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/my-gam/sudoku.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/my-gam/sudoku/tree/main/packages/core#readme",
+  "bugs": {
+    "url": "https://github.com/my-gam/sudoku/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vite build --mode lib",
+    "dev": "vite build --mode lib --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  }
 }

package/src/index.ts

@@ -0,0 +1,17 @@
+/**
+ * @my-games/sudoku-core —— `0.0.0` 占位实现。
+ *
+ * 这是一个「空包」骨架：目的仅是把 monorepo 的
+ * `build → verify:dist → typecheck → test` 门禁与 npm Trusted Publisher 链路跑通，
+ * 好让首版（可信发布者无法发某包的第一个版本）能先手工种进 registry。
+ *
+ * 真实数独引擎 —— 棋盘校验、回溯求解器、唯一解题生成、`Sudoku` 状态机
+ * （选格/填数/擦除/笔记/提示/撤销/计时）、注入式存档与最佳用时 —— 已在占位包
+ * 发布前按同一三层结构写好并暂存，待 `0.0.0` 上线后作为后续提交补回。
+ */
+
+/** 包标识占位。 */
+export const SUDOKU_PACKAGE = 'sudoku-core' as const;
+
+/** 占位版本，与 package.json 的 version 对齐，便于确认发的是 stage 包。 */
+export const SUDOKU_STAGE = '0.0.0' as const;

package/src/style.css

@@ -0,0 +1,17 @@
+/*
+ * @my-games/sudoku-core —— 0.0.0 占位样式表（单数命名 ./style.css）。
+ *
+ * 空骨架阶段只放最小基类，保证三包各自构建能产出非空 dist/index.css
+ * （verify:dist 守卫要求 vue/react 的 index.css 存在且非 0 字节）。
+ * 真实棋盘样式（3×3 宫格布局、题面/用户/冲突配色、铅笔笔记迷你格）随引擎补入。
+ */
+
+.game-sudoku {
+  display: inline-flex;
+  flex-direction: column;
+  gap: 8px;
+  font-family: 'Segoe UI', system-ui, -apple-system, sans-serif;
+  color: #1f2d3d;
+  user-select: none;
+  -webkit-tap-highlight-color: transparent;
+}