pelican-engine 0.3.1 → 0.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (11) hide show
  1. package/README.md +2 -2
  2. package/distribution.json +11 -10
  3. package/docs/DECISIONS.md +1 -0
  4. package/docs/STATUS.md +22 -0
  5. package/docs/api/REFERENCE.md +2 -2
  6. package/docs/api/index.json +2 -2
  7. package/docs/npm/DISTRIBUTION.md +2 -2
  8. package/engine.manifest.json +1 -1
  9. package/lib/sdk/index.d.ts +1 -1
  10. package/lib/sdk/index.js +1 -1
  11. package/package.json +1 -1
package/README.md CHANGED
@@ -30,8 +30,8 @@ npx --no-install pelican capture --port 4174 --output capture.png
30
30
  npx --no-install pelican build
31
31
  ```
32
32
 
33
- For an exact-version install use `npm --prefix . i -D --save-exact pelican-engine@0.3.1`,
34
- or substitute the local `pelican-engine-0.3.1.tgz` tarball before registry
33
+ For an exact-version install use `npm --prefix . i -D --save-exact pelican-engine@0.3.3`,
34
+ or substitute the local `pelican-engine-0.3.3.tgz` tarball before registry
35
35
  publication. `pelican create --template minimal` remains available explicitly.
36
36
 
37
37
  Without `--prefix .`, npm may select an ancestor `package.json` or `node_modules`
package/distribution.json CHANGED
@@ -1,22 +1,23 @@
1
1
  {
2
2
  "format": "pelican.npm-distribution",
3
- "version": "0.3.1",
3
+ "version": "0.3.3",
4
4
  "files": {
5
5
  "AGENTS.md": "af63b23d2afdef415c865685aea31dacd365edde17505bde823a757bd46caa5a",
6
6
  "docs/AI-WORKFLOW.md": "aa992686df93f791795f6f3fce01713d812eea6a1b9556f07411ac5847278efa",
7
- "docs/api/index.json": "175271fbd96b76ebe59a5a9fa6e5922d29f8077d1b5571fd3e9c299a210457b3",
8
- "docs/api/REFERENCE.md": "1024b457012f8a256518ea81f3f4271a8e91379d94468e2e312443607bfa3044",
7
+ "docs/api/index.json": "fdb344c9956edf316548487ee0b183847e23cdecffe95eeda7f1f54c0c26b770",
8
+ "docs/api/REFERENCE.md": "dff3868360926651e7986a25d2676283c1e1336d585e070e62313bf89fd2e1be",
9
9
  "docs/ARCHITECTURE.md": "3184b73592d466390e7793b1cf39bbb80d6052b523fba7e7cb377b5207074627",
10
10
  "docs/CAPABILITIES.md": "92950817497d8c63db07830db96dc93c877befa8d038320feed1ae1f1a053cb1",
11
- "docs/DECISIONS.md": "bb12e04f048b54682e844d4aeb1e3fc1d5ab1865d00e63ec153cd8658e9d1403",
11
+ "docs/DECISIONS.md": "f7d287654c1ca4014474c54defbd1a9fb2a7e0d00794a3453f7518dae4490311",
12
12
  "docs/M3-USAGE.md": "39b2b4675840f3700da9ccf81c690cff4c69ee1ed5785a0b430c7c055935c31a",
13
- "docs/npm/DISTRIBUTION.md": "450f5250944706730e1c778e249820814c851de3c084550b5b23698ad886f052",
13
+ "docs/npm/DISTRIBUTION.md": "9312e4e7c4c0ac097793c7d5aeaa9146ec52e64d10caa7b804813ce61ceeaf87",
14
14
  "docs/npm/GAME-AUTHOR.md": "af63b23d2afdef415c865685aea31dacd365edde17505bde823a757bd46caa5a",
15
15
  "docs/PELICAN-MIGRATION.md": "633f4a4fe30bc899ebb01fb63ec9573a931e43f28c199224509db95890806e5f",
16
16
  "docs/RENDER-BACKENDS.md": "de104cca78d734f9a853a2757c6e3d7b832a31224da5df462851ef2cf9768ade",
17
17
  "docs/ROADMAP.md": "29ac1c54f36064e23c17cfe7f549d6860889257a57d1227e322958aa9c281568",
18
+ "docs/STATUS.md": "1e8b85ced94f7b4484773e73363e1cfbd488d8441e6c98e45358486402927c8d",
18
19
  "docs/THIRD-PARTY-NOTICES.md": "58f9b72e2b4dfaaaf2a4c08b9bde9ecef3d2b7e7d65fccd782ed54f39fa76fdc",
19
- "engine.manifest.json": "a0195471f48fa9e77f9b368f34dd5b7159c32e669618177b583b586ce7a3c5a3",
20
+ "engine.manifest.json": "155537b36e7bb1f7a1550817571c08404739d4be3c0caa07a75b5089f8db1be1",
20
21
  "lib/assets/audio.js": "6facdce4e053afd172af5b9407569b035169844ea17b49f93f8b67f72b78895f",
21
22
  "lib/assets/errors.js": "70572678655c6e53179d31920d71f29882d373a0e12d560220bb0fc2cd74f2cc",
22
23
  "lib/assets/glb.js": "b808479a36299c154db97f50c16863a3b5a2c61f725e66bf01d01a5f62a288a5",
@@ -118,8 +119,8 @@
118
119
  "lib/runtime/world.js": "c43621fbaca8bd2b0d6477a96e60e895312f0f7b1eb97614b6e4f9b716129ea1",
119
120
  "lib/schema/index.js": "594429eecb4494c4af2f3d04537be3211f2c9297a1fc555bbba5d028d8627965",
120
121
  "lib/sdk/graph-values.js": "a58c00f127cb82aba5fd2824981942844e06d9a59a88a05e35d1d3df2fc7ed2f",
121
- "lib/sdk/index.d.ts": "2ce8fcc81d32d3afeac66fa1c127a5e325d7d7aed57799f8f17b6c5b7ba4aae8",
122
- "lib/sdk/index.js": "ec04eb99e3fe9f3de1a5d06844f25b858b6b58a3819990167555c77b2d46747e",
122
+ "lib/sdk/index.d.ts": "948449f30fe58d60c6dfd1cf8c9155b46df15f2b273ab830d55b751fd0cad041",
123
+ "lib/sdk/index.js": "113dd48a7f1ebea382dcbe8a7f1e685c71fbfdeb105d00a4b6069ea59485a8f0",
123
124
  "lib/tools/api-index.js": "6aedc153a0ce8eaf18239b0368a76a8ae8e4397bd8e6cdf571889bc39265be5d",
124
125
  "lib/tools/browser-session.js": "1fa7f78d4752d8a59a55dc2283b4d42cd1df230f0d5a5dc80c6d78ade45b4cdb",
125
126
  "lib/tools/cli.js": "ad5e915f046cc2e6bf612edd1a88cc33758b1d2b0ce2f057be50e0a2c4770062",
@@ -190,8 +191,8 @@
190
191
  "licenses/undici-types/LICENSE": "a6db8096b2707bc0102d256917d4d33f298ba36d8c3f25de067a2b5bb379db27",
191
192
  "licenses/uniq/LICENSE": "e67aed7df22dc8031e4fcf5338fe91cb33e3817e5c58a99a2a2802eea9069791",
192
193
  "licenses/vite/LICENSE.md": "a22152baa1aef74402443008e767e7c689a524c0909d19b0431d97f5ab066a13",
193
- "package.json": "7765fdcce4bfe9ddc3c7d646cf1d01f7acccb2ecca60dc8dcf8f029fefac0b50",
194
- "README.md": "450f5250944706730e1c778e249820814c851de3c084550b5b23698ad886f052",
194
+ "package.json": "68d95a497d2ccb17c1cb47be1414f4a26e093cb2262ae34449d3c411bedd7c77",
195
+ "README.md": "9312e4e7c4c0ac097793c7d5aeaa9146ec52e64d10caa7b804813ce61ceeaf87",
195
196
  "web/index.html": "d89d6a5b5be3beae3627a8ed506ac308b165d264fb8696be3afd79fcca2f26ee"
196
197
  }
197
198
  }
package/docs/DECISIONS.md CHANGED
@@ -68,6 +68,7 @@
68
68
  | D52 | 用户要求 npm 包由自动化提交 staged 发布，再由本人以 2FA 手动审核 | npm CI 使用受保护的 `NPM_TOKEN` 提交 staged 包；预发布版本使用 `next` 标签。Staging 成功不等于版本已公开发布，批准须由用户手动完成 2FA。令牌不得写入源码或日志。D50 禁止测试及其他验证的约束仍然有效。 |
69
69
  | D53 | 用户要求每次推送主线自动以无预发布后缀的正式版本发布到 npm `latest`，使用 OIDC，不再人工审批 | 覆盖 D48、D52 的 token/staged/next 方案。GitHub Actions 使用 npm 可信发布，不传长期发布令牌；每次运行生成唯一正式版本，更新 `latest`。发布失败、队列延迟和不可覆盖版本须如实记录。正式版本命名不表示行为、硬件或完整里程碑已验证，D50 仍有效。 |
70
70
  | D54 | 用户要求推送主线即尝试发布 npm，GitHub Release 仅标记里程碑；仓库和 npm 使用相同的简洁版本，移除 `next` | 覆盖 D53 的运行 ID 自动版本方案。版本由仓库显式维护，CI 不自动改号；每次推送使用该版本以 OIDC 发布到 `latest`，版本重复则失败并等待后续版本，不覆盖既有包。移除 `next` 别名但保留历史版本；已有长版本不可重用或抹除。D50 仍有效。 |
71
+ | D55 | 用户要求单线开发时不再堆积变更，提交和推送不等待里程碑 | 工作区只保留下一功能或版本的改动；每次提交围绕一个可说明的功能、修复或版本，完成后及时提交推送。推送前按 D54 明确递增版本，npm 发布失败如实记录。保留历史证据和未确认成果，不将无关内容混入提交；D50 和 D51 继续有效。 |
71
72
 
72
73
  ## 本次变更实施顺序
73
74
 
package/docs/STATUS.md ADDED
@@ -0,0 +1,22 @@
1
+ # 当前研发状态
2
+
3
+ ## 版本与发布
4
+
5
+ - 当前版本以 `package.json`、`engine.manifest.json` 和 SDK 中的相同标准版本号为准。每次需要发布时，在主线显式更新版本；相同版本不能重复发布。
6
+ - 推送主线会通过 GitHub Actions 和 npm 可信发布更新 `latest`；GitHub Release 用于记录里程碑。历史版本和旧标签保持原样，不代表当前源码通过。
7
+ - 当前按用户要求仅允许编译和构建，不运行测试、浏览器、GPU、性能或其他验证。普通版本号不意味着运行行为、硬件或完整引擎已验收。
8
+
9
+ ## 已有基础与缺口
10
+
11
+ - TypeScript SDK、编译器、游戏运行时、渲染器、资源管线和命令行已有实现；游戏开发使用 `pelican-engine` 公开接口。
12
+ - 动态光追、路径追踪、受控图形计算和 WebGL2 回退已有研发实现，但当前源码的完整画质、性能、兼容性和资源生命周期未验证，不能称为完整首发。
13
+ - 刚体首步前删除存在已知缺陷；历史候选存在旧快照兼容及危险历史回放风险，不得通过修改夹具或在主进程回放危险历史掩盖。有关背景与原始证据保留在历史任务文档中。
14
+ - 布料、绳索、软体、流体、连续世界、导航、动画、音频和其他首发能力仍需按各自依赖完成，不能把独立候选或局部实现写成整项完成。
15
+
16
+ ## 单线接续
17
+
18
+ 只在 `main` 的主工作树串行开发。历史独有候选和失败记录在本机 `.pelican/consolidated-worktrees/`、`.pelican/worktree-snapshots/` 或原证据目录中；它们不是活动工作树，未审查前不能删除或声称已合入。其他环境不一定有这些本机目录。
19
+
20
+ 每次工作只积累一个功能、修复或下一版本的相关变更；完成后及时提交并推送，不等待里程碑。推送前同步递增标准版本，以便 npm 使用同一版本发布。历史本机开发报告可由本机 Git 排除配置隐藏，不删除原文件；正式证据和未来新报告不能因此被默认为已提交。
21
+
22
+ 下一步优先分析物理生命周期与旧状态兼容的实现边界，再按依赖逐步集成可用功能。保留真实失败、局限和历史来源；不在禁止验证期间声称修复已通过。
package/docs/api/REFERENCE.md CHANGED
@@ -1,4 +1,4 @@
1
- # pelican 0.3.1 API 索引
1
+ # pelican 0.3.3 API 索引
2
2
 
3
3
  Installed declarations: `lib/sdk/index.d.ts` (relative to the package root).
4
4
  The signatures below come from the same public SDK source as repository games.
@@ -11,7 +11,7 @@ Source-file paths and line numbers are build-time provenance only; TypeScript so
11
11
  来源：`packages/sdk/src/index.ts:2`
12
12
 
13
13
  ```ts
14
- SDK_VERSION = "0.3.1"
14
+ SDK_VERSION = "0.3.3"
15
15
  ```
16
16
 
17
17
  ## Vec2
package/docs/api/index.json CHANGED
@@ -1,14 +1,14 @@
1
1
  {
2
2
  "format": "pelican.api-index",
3
3
  "version": 1,
4
- "engineVersion": "0.3.1",
4
+ "engineVersion": "0.3.3",
5
5
  "entry": "pelican-engine",
6
6
  "source": "packages/sdk/src/index.ts",
7
7
  "symbols": [
8
8
  {
9
9
  "name": "SDK_VERSION",
10
10
  "kind": "constant",
11
- "signature": "SDK_VERSION = \"0.3.1\"",
11
+ "signature": "SDK_VERSION = \"0.3.3\"",
12
12
  "line": 2
13
13
  },
14
14
  {
package/docs/npm/DISTRIBUTION.md CHANGED
@@ -30,8 +30,8 @@ npx --no-install pelican capture --port 4174 --output capture.png
30
30
  npx --no-install pelican build
31
31
  ```
32
32
 
33
- For an exact-version install use `npm --prefix . i -D --save-exact pelican-engine@0.3.1`,
34
- or substitute the local `pelican-engine-0.3.1.tgz` tarball before registry
33
+ For an exact-version install use `npm --prefix . i -D --save-exact pelican-engine@0.3.3`,
34
+ or substitute the local `pelican-engine-0.3.3.tgz` tarball before registry
35
35
  publication. `pelican create --template minimal` remains available explicitly.
36
36
 
37
37
  Without `--prefix .`, npm may select an ancestor `package.json` or `node_modules`
package/engine.manifest.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pelican-engine",
3
- "version": "0.3.1",
3
+ "version": "0.3.3",
4
4
  "milestone": "M3",
5
5
  "stage": "advanced-rendering-development",
6
6
  "license": "MIT",
package/lib/sdk/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  /** Pelican Engine public API. No renderer or GPU implementation types escape this module. */
2
- export declare const SDK_VERSION = "0.3.1";
2
+ export declare const SDK_VERSION = "0.3.3";
3
3
  export type Vec2 = readonly [number, number];
4
4
  export type Vec3 = readonly [number, number, number];
5
5
  export type Vec4 = readonly [number, number, number, number];
package/lib/sdk/index.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /** Pelican Engine public API. No renderer or GPU implementation types escape this module. */
2
- export const SDK_VERSION = "0.3.1";
2
+ export const SDK_VERSION = "0.3.3";
3
3
  export const SYSTEM_PHASES = [
4
4
  "input",
5
5
  "prePhysics",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pelican-engine",
3
- "version": "0.3.1",
3
+ "version": "0.3.3",
4
4
  "description": "Pelican Engine public SDK and offline development CLI",
5
5
  "type": "module",
6
6
  "license": "MIT",