@forsion/calendar 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+## 0.1.0 — 2026-10-21
+
+- 新增独立待办 Space，Calendar 右栏及 Mini 共用同一个紧凑待办视图，原生左栏可按今天、计划、全部及来源切换。
+- 待办可连续快速添加，日期可选；无可写清单时直接创建普通多维表。失败保留输入，中文输入法回车不误提交。
+- 完成待办提供即时视觉反馈、短暂停留与撤销。原生移动端支持可关闭的系统轻触反馈，撤销和同步不触发震动。
+- 补齐现有事件菜单、复制粘贴、条件撤销与重做及移动端事件抽屉。记录正文和关联由宿主公共记录操作保留。
+- 日历显示菜单统一字号与间距，时间刻度合并为一行，以「紧凑／标准／舒展」替代像素数值。
+- 最低宿主版本为 2.13.6，避免旧宿主把新的插件更新为不完整的日历。
+
+- 从 Genesis 内置日历一比一搬出:日历、右栏待办、小月历与日历设置、迷你待办;数据与设置走 ctx.databases / ctx.noteTasks / ctx.calendar,
+  事件浮卡的字段走 ctx.ui.mountRecord,撤销提示走带按钮的 ctx.notify。
+
+### English
+
+- A dedicated Tasks Space shares the compact task view with Calendar’s right panel and Mini. The native sidebar filters by Today, Planned, All and source.
+- Capture tasks continuously with optional dates. When no writable list exists, create an ordinary database with the first task. Failed writes retain the input; IME confirmation does not submit.
+- Completion provides immediate visual feedback, a short in-place pause and Undo. Native mobile hosts request one optional system tick; undo and synchronization stay silent.
+- Event menus, copy/paste, conditional undo/redo and the mobile event drawer use the host’s public record APIs, preserving record bodies and references.
+- Display options use a compact menu with one semantic time-scale row and one week-start row.
+- Requires Forsion 2.13.6. Calendar keeps its stable native Space identity and saved layouts while its renderer becomes a core npm plugin.

package/README.md

@@ -1,3 +1,20 @@
-# Temporary Holding Version
+# Forsion Calendar and tasks
 
-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.
+`@forsion/calendar` is Forsion’s core Calendar and Tasks plugin. Source repository access is private; the npm package contains the bundled renderer, Space recipes and notices. Requires Forsion **2.13.6 or later** with the public calendar record APIs.
+
+- Calendar keeps its existing native Space identity, saved layout, calendar settings and right-side task list. A dedicated Tasks Space uses the same task view and the native workspace sidebar. Mini uses the same renderer.
+- Capture a task with Enter and keep typing. Dates are optional; text such as “tomorrow 3pm” supplies a date. Without a writable list, the first add explicitly creates an ordinary database under the plugin’s working folder. There is no separate task database format or parallel task store.
+- Completion gives immediate visual feedback, a short in-place pause and an eight-second Undo action. Native mobile hosts request one system tick for an accepted completion; undo and data refreshes stay silent. Touch feedback can be turned off in the task menu. System preferences still apply. Desktop and browser hosts do not pretend to vibrate.
+- Event menus, record copy/paste, conditional undo/redo and complete note/record copies use the host’s public `calendar.events` API. Field editing uses the real `ui.mountRecord` editor. Calendar/Todo data comes from `databases`, `noteTasks` and `calendar`; no host runtime imports are used.
+- The host pins the npm version in `desktop/package.json`, seeds it through `builtinBundles.json`, classifies it through `CORE_BUNDLE_IDS` and checks npm updates through the existing core updater. Android bundles the same npm renderer; a newer compatible installed version takes precedence. It is not a marketplace entry.
+
+## Development
+
+```bash
+npm ci
+npm run typecheck
+npm test            # 先 build,再跑单测(含按宿主装法跑 main.js 的入口测试)
+npm run install:dev # 装进 ~/.forsion-dev/plugins/forsion-calendar
+```
+
+`npm pack --pack-destination artifacts` prepares the release archive. Publishing to npm requires explicit approval of the package version. Preparing an archive or pushing a feature branch does not publish it.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,155 @@
+# Third-party notices
+
+main.js bundles the following packages, each used under the MIT license.
+
+## react 19.2.7 (MIT)
+
+```
+MIT License
+
+Copyright (c) Meta Platforms, Inc. and affiliates.
+
+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.
+```
+
+## react-dom 19.2.7 (MIT)
+
+```
+MIT License
+
+Copyright (c) Meta Platforms, Inc. and affiliates.
+
+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.
+```
+
+## scheduler 0.27.0 (MIT)
+
+```
+MIT License
+
+Copyright (c) Meta Platforms, Inc. and affiliates.
+
+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.
+```
+
+## lucide-react 1.21.0 (ISC)
+
+```
+ISC License
+
+Copyright (c) 2026 Lucide Icons and Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+---
+
+The following Lucide icons are derived from the Feather project:
+
+airplay, alert-circle, alert-octagon, alert-triangle, aperture, arrow-down-circle, arrow-down-left, arrow-down-right, arrow-down, arrow-left-circle, arrow-left, arrow-right-circle, arrow-right, arrow-up-circle, arrow-up-left, arrow-up-right, arrow-up, at-sign, calendar, cast, check, chevron-down, chevron-left, chevron-right, chevron-up, chevrons-down, chevrons-left, chevrons-right, chevrons-up, circle, clipboard, clock, code, columns, command, compass, corner-down-left, corner-down-right, corner-left-down, corner-left-up, corner-right-down, corner-right-up, corner-up-left, corner-up-right, crosshair, database, divide-circle, divide-square, dollar-sign, download, external-link, feather, frown, hash, headphones, help-circle, info, italic, key, layout, life-buoy, link-2, link, loader, lock, log-in, log-out, maximize, meh, minimize, minimize-2, minus-circle, minus-square, minus, monitor, moon, more-horizontal, more-vertical, move, music, navigation-2, navigation, octagon, pause-circle, percent, plus-circle, plus-square, plus, power, radio, rss, search, server, share, shopping-bag, sidebar, smartphone, smile, square, table-2, tablet, target, terminal, trash-2, trash, triangle, tv, type, upload, x-circle, x-octagon, x-square, x, zoom-in, zoom-out
+
+The MIT License (MIT) (for the icons listed above)
+
+Copyright (c) 2013-present Cole Bemis
+
+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.
+```
+
+## zustand 5.0.14 (MIT)
+
+```
+MIT License
+
+Copyright (c) 2019 Paul Henschel
+
+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.
+```