sheetnext 0.2.4 → 0.2.7

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 (22) hide show
  1. package/README.md +22 -15
  2. package/README_CN.md +22 -14
  3. package/dist/sheetnext.css +1 -1
  4. package/dist/sheetnext.es.js +3 -3
  5. package/dist/sheetnext.locale.zh-CN.es.js +3 -3
  6. package/dist/sheetnext.locale.zh-CN.umd.js +3 -3
  7. package/dist/sheetnext.umd.js +3 -3
  8. package/docs/skill/sheetnext-dev/GENERATION.md +18 -0
  9. package/docs/skill/sheetnext-dev/README.md +44 -0
  10. package/docs/skill/sheetnext-dev/SKILL.md +58 -0
  11. package/docs/skill/sheetnext-dev/adapters/chatgpt.md +22 -0
  12. package/docs/skill/sheetnext-dev/adapters/claude.md +21 -0
  13. package/docs/skill/sheetnext-dev/adapters/codex.md +21 -0
  14. package/docs/skill/sheetnext-dev/adapters/copilot.md +15 -0
  15. package/docs/skill/sheetnext-dev/adapters/cursor.md +17 -0
  16. package/docs/{core-api.md → skill/sheetnext-dev/references/core-api.md} +236 -63
  17. package/docs/{enums.md → skill/sheetnext-dev/references/enums.md} +1 -1
  18. package/docs/{events.md → skill/sheetnext-dev/references/events.md} +16 -6
  19. package/docs/skill/sheetnext-dev/references/recipes.md +56 -0
  20. package/package.json +2 -1
  21. /package/docs/{ai-relay.md → skill/sheetnext-dev/references/ai-relay.md} +0 -0
  22. /package/docs/{json-format.md → skill/sheetnext-dev/references/json-format.md} +0 -0
package/README.md CHANGED
@@ -68,11 +68,11 @@ const SN = new SheetNext(document.querySelector('#SNContainer'));
68
68
  <meta charset="UTF-8">
69
69
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
70
70
  <title>SheetNext Demo</title>
71
- <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/sheetnext@0.2.0/dist/sheetnext.css">
71
+ <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/sheetnext/dist/sheetnext.css">
72
72
  </head>
73
73
  <body>
74
74
  <div id="SNContainer" style="width:100vw;height:100vh;padding:0 7px 7px"></div>
75
- <script src="https://cdn.jsdelivr.net/npm/sheetnext@0.2.0/dist/sheetnext.umd.js"></script>
75
+ <script src="https://cdn.jsdelivr.net/npm/sheetnext/dist/sheetnext.umd.js"></script>
76
76
  <script>
77
77
  const SN = new SheetNext(document.querySelector('#SNContainer'));
78
78
  </script>
@@ -100,8 +100,8 @@ const SN = new SheetNext(document.querySelector('#SNContainer'), {
100
100
  Import locale via CDN:
101
101
 
102
102
  ```html
103
- <script src="https://cdn.jsdelivr.net/npm/sheetnext@0.2.0/dist/sheetnext.umd.js"></script>
104
- <script src="https://cdn.jsdelivr.net/npm/sheetnext@0.2.0/dist/sheetnext.locale.zh-CN.umd.js"></script>
103
+ <script src="https://cdn.jsdelivr.net/npm/sheetnext/dist/sheetnext.umd.js"></script>
104
+ <script src="https://cdn.jsdelivr.net/npm/sheetnext/dist/sheetnext.locale.zh-CN.umd.js"></script>
105
105
  <script>
106
106
  const SN = new SheetNext(document.querySelector('#SNContainer'), {
107
107
  locale: 'zh-CN'
@@ -111,23 +111,30 @@ Import locale via CDN:
111
111
 
112
112
  ### Option 2: AI-Driven Development (Recommended)
113
113
 
114
- #### Step 1: Download the AI Development Reference
115
-
116
- - Open `docs/detail/` in the repository.
117
- - The core references are `docs/detail/core-api.md`, `docs/detail/events.md`, and `docs/detail/enums.md`.
118
- - Protocol supplements are `docs/detail/ai-relay.md` and `docs/detail/json-format.md`.
119
-
120
- #### Step 2: Feed `docs/detail` to Your AI Tool
121
-
122
- Use Cursor / Claude / ChatGPT / Copilot or any AI coding assistant. Provide the `docs/detail/` reference set first, then describe your requirements.
114
+ #### Step 1: Download the AI Development Reference
115
+
116
+ - For Codex Skills, use the ready-to-install skill directory: `docs/skill/sheetnext-dev/`.
117
+ - For other AI tools, open `docs/skill/sheetnext-dev/references/` in the repository.
118
+ - The core references are `docs/skill/sheetnext-dev/references/core-api.md`, `docs/skill/sheetnext-dev/references/events.md`, and `docs/skill/sheetnext-dev/references/enums.md`.
119
+ - Protocol supplements are `docs/skill/sheetnext-dev/references/ai-relay.md` and `docs/skill/sheetnext-dev/references/json-format.md`.
120
+
121
+ #### Step 2: Use the Skill or Feed `references` to Your AI Tool
122
+
123
+ For Codex, copy the generated skill into your Codex skills directory, then restart Codex:
124
+
125
+ ```powershell
126
+ Copy-Item -Recurse -Force .\docs\skill\sheetnext-dev "$env:USERPROFILE\.codex\skills\sheetnext-dev"
127
+ ```
128
+
129
+ For Cursor / Claude / ChatGPT / Copilot or any AI coding assistant, provide the `docs/skill/sheetnext-dev/references/` reference set first, then describe your requirements.
123
130
 
124
131
  Recommended prompt template:
125
132
 
126
133
  ```text
127
134
  You are a senior SheetNext AI development expert. Please read and understand the documentation I provide, then give a directly implementable solution.
128
135
  Execution order:
129
- 1) Read: docs/detail/core-api.md
130
- 2) Read as needed: docs/detail/events.md, docs/detail/enums.md, docs/detail/ai-relay.md, and docs/detail/json-format.md
136
+ 1) Read: docs/skill/sheetnext-dev/references/core-api.md
137
+ 2) Read as needed: docs/skill/sheetnext-dev/references/events.md, docs/skill/sheetnext-dev/references/enums.md, docs/skill/sheetnext-dev/references/ai-relay.md, and docs/skill/sheetnext-dev/references/json-format.md
131
138
  3) Identify user goals (business goals + technical goals)
132
139
  4) Output a minimum viable implementation (get it running first, then optimize)
133
140
  5) All APIs and code must strictly follow the documentation
package/README_CN.md CHANGED
@@ -68,11 +68,11 @@ const SN = new SheetNext(document.querySelector('#SNContainer'));
68
68
  <meta charset="UTF-8">
69
69
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
70
70
  <title>SheetNext Demo</title>
71
- <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/sheetnext@0.2.0/dist/sheetnext.css">
71
+ <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/sheetnext/dist/sheetnext.css">
72
72
  </head>
73
73
  <body>
74
74
  <div id="SNContainer" style="width:100vw;height:100vh;padding:0 7px 7px"></div>
75
- <script src="https://cdn.jsdelivr.net/npm/sheetnext@0.2.0/dist/sheetnext.umd.js"></script>
75
+ <script src="https://cdn.jsdelivr.net/npm/sheetnext/dist/sheetnext.umd.js"></script>
76
76
  <script>
77
77
  const SN = new SheetNext(document.querySelector('#SNContainer'));
78
78
  </script>
@@ -100,8 +100,8 @@ const SN = new SheetNext(document.querySelector('#SNContainer'), {
100
100
  CDN 方式引入语言包：
101
101
 
102
102
  ```html
103
- <script src="https://cdn.jsdelivr.net/npm/sheetnext@0.2.0/dist/sheetnext.umd.js"></script>
104
- <script src="https://cdn.jsdelivr.net/npm/sheetnext@0.2.0/dist/sheetnext.locale.zh-CN.umd.js"></script>
103
+ <script src="https://cdn.jsdelivr.net/npm/sheetnext/dist/sheetnext.umd.js"></script>
104
+ <script src="https://cdn.jsdelivr.net/npm/sheetnext/dist/sheetnext.locale.zh-CN.umd.js"></script>
105
105
  <script>
106
106
  const SN = new SheetNext(document.querySelector('#SNContainer'), {
107
107
  locale: 'zh-CN'
@@ -111,22 +111,30 @@ CDN 方式引入语言包：
111
111
 
112
112
  ### 方案二：AI 驱动开发（推荐）
113
113
 
114
- #### Step 1：下载 AI 开发资料
115
-
116
- - 打开仓库中的 `docs/detail/` 目录。
117
- - 核心参考文档为 `docs/detail/core-api.md`、`docs/detail/events.md`、`docs/detail/enums.md`。
118
-
119
- #### Step 2：把 `docs/detail` 交给 AI
120
-
121
- 可使用 Cursor / Claude / ChatGPT / Copilot 等工具，先喂 `docs/detail/` 这组资料再提需求。
114
+ #### Step 1：下载 AI 开发资料
115
+
116
+ - 如果使用 Codex Skills，可直接使用已生成的 skill 目录：`docs/skill/sheetnext-dev/`。
117
+ - 如果使用其他 AI 工具，打开仓库中的 `docs/skill/sheetnext-dev/references/` 目录。
118
+ - 核心参考文档为 `docs/skill/sheetnext-dev/references/core-api.md`、`docs/skill/sheetnext-dev/references/events.md`、`docs/skill/sheetnext-dev/references/enums.md`。
119
+ - 协议补充文档为 `docs/skill/sheetnext-dev/references/ai-relay.md`、`docs/skill/sheetnext-dev/references/json-format.md`。
120
+
121
+ #### Step 2：使用 Skill 或把 `references` 交给 AI
122
+
123
+ Codex 用户可把生成的 skill 复制到 Codex skills 目录，然后重启 Codex：
124
+
125
+ ```powershell
126
+ Copy-Item -Recurse -Force .\docs\skill\sheetnext-dev "$env:USERPROFILE\.codex\skills\sheetnext-dev"
127
+ ```
128
+
129
+ Cursor / Claude / ChatGPT / Copilot 等工具，可先喂 `docs/skill/sheetnext-dev/references/` 这组资料再提需求。
122
130
 
123
131
  推荐指令模板：
124
132
 
125
133
  ```text
126
134
  你是资深 SheetNext AI 开发专家，请先阅读并理解我提供的文档，再给出可直接落地的方案。
127
135
  执行顺序：
128
- 1) 先阅读：docs/detail/core-api.md
129
- 2) 再按需阅读：docs/detail/events.md、docs/detail/enums.md
136
+ 1) 先阅读：docs/skill/sheetnext-dev/references/core-api.md
137
+ 2) 再按需阅读：docs/skill/sheetnext-dev/references/events.md、docs/skill/sheetnext-dev/references/enums.md、docs/skill/sheetnext-dev/references/ai-relay.md、docs/skill/sheetnext-dev/references/json-format.md
130
138
  3) 识别用户目标（业务目标 + 技术目标）
131
139
  4) 输出最小可行实现（先能跑，再优化）
132
140
  5) 所有 API 与代码写法必须严格对齐文档