@bardway/trpg-notebook-native 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lex
+
+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/NOTICE

@@ -0,0 +1,10 @@
+MingriAgency TRPG Engine
+Copyright (c) 2026 Lex
+
+Portions extracted and adapted from MingriAgencyCOC,
+Copyright (c) 2025 Lex, licensed under the MIT License.
+Source: https://github.com/bardway/mingriAgency_COC
+The complete source attribution and extraction mapping are maintained in
+docs/architecture and docs/guidance in the Engine repository.
+
+Third-party dependencies retain their own licenses and copyright notices.

package/README.md

@@ -1,3 +1,34 @@
-# Temporary Holding Version
+# @bardway/trpg-notebook-native
 
-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.
+Android 笔记 SQLite、WebView 阅读器及存储驱动适配。
+
+初始版本 `0.1.0`，提供 ESM JavaScript 和 TypeScript 声明。
+
+## 安装
+
+```sh
+npm install --save-exact @bardway/trpg-notebook-native@0.1.0
+```
+
+需要对应 Expo/React Native peer 和 `/app.plugin` 配置。SQLite 与 Reader 原生模块提供 Android 实现；宿主配置实际字体资源。iOS 需要独立适配。
+
+## 公开入口
+
+- `@bardway/trpg-notebook-native`
+- `@bardway/trpg-notebook-native/storage-drivers`
+- `@bardway/trpg-notebook-native/chunked-secure`
+- `@bardway/trpg-notebook-native/app.plugin`
+
+## 平台依赖
+
+- `expo@~55.0.0`
+- `expo-document-picker@~55.0.17`
+- `expo-file-system@~55.0.26`
+- `react@19.2.0`
+- `react-native@0.83.10`
+- `react-native-webview@13.16.0`
+- `@expo/config-plugins@55.0.11`（按使用入口安装）
+
+完整配置、示例和平台限制见[使用说明](https://github.com/bardway/mingriAgency_TRPGEngine/blob/main/docs/guidance/package-usage.md)。
+
+MIT。保留随包分发的 LICENSE、NOTICE 和第三方许可。

package/android/build.gradle

@@ -0,0 +1,22 @@
+plugins {
+  id 'com.android.library'
+  id 'expo-module-gradle-plugin'
+}
+
+group = 'expo.modules.notebookstorage'
+version = '0.1.0'
+
+android {
+  namespace 'expo.modules.notebookstorage'
+  defaultConfig {
+    versionCode 1
+    versionName '0.1.0'
+    testInstrumentationRunner 'android.test.InstrumentationTestRunner'
+    testApplicationId 'org.bardway.trpg.notebook.tests'
+  }
+}
+
+dependencies {
+  // Android's built-in test APIs are optional SDK libraries on API 28+.
+  androidTestCompileOnly files("${android.sdkDirectory}/platforms/android-${android.compileSdk}/optional/android.test.base.jar")
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" />

package/android/src/main/java/expo/modules/notebookstorage/NotebookStorageModule.kt

@@ -0,0 +1,51 @@
+package expo.modules.notebookstorage
+
+import android.database.sqlite.SQLiteFullException
+import android.database.sqlite.SQLiteDiskIOException
+import android.database.sqlite.SQLiteReadOnlyDatabaseException
+import android.database.sqlite.SQLiteCantOpenDatabaseException
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.SupervisorJob
+import kotlinx.coroutines.asCoroutineDispatcher
+import java.util.concurrent.Executors
+
+class NotebookStorageModule : Module() {
+  private val executor = Executors.newSingleThreadExecutor()
+  private val dispatcher = executor.asCoroutineDispatcher()
+  private val scope = CoroutineScope(SupervisorJob() + dispatcher)
+  private val storeDelegate = lazy {
+    NotebookStore(requireNotNull(appContext.reactContext).applicationContext)
+  }
+  private val store get() = storeDelegate.value
+  private fun safeCall(block: () -> String): String = try { block() } catch (_: SQLiteFullException) {
+    throw IllegalStateException("设备存储空间不足，未提交的手记仍可重试")
+  } catch (_: SQLiteDiskIOException) {
+    throw IllegalStateException("设备存储读写失败，原有手记已保留，请重试")
+  } catch (_: SQLiteReadOnlyDatabaseException) {
+    throw IllegalStateException("手记本地存储不可写，未提交内容仍可重试")
+  } catch (_: SQLiteCantOpenDatabaseException) {
+    throw IllegalStateException("无法打开本地手记，请检查设备存储后重试")
+  }
+
+  override fun definition() = ModuleDefinition {
+    Name("NotebookStorage")
+    AsyncFunction("capabilities") { safeCall { store.capabilities() } }.runOnQueue(scope)
+    AsyncFunction("ensureWorkspace") { payload: String -> safeCall { store.ensureWorkspace(payload) } }.runOnQueue(scope)
+    AsyncFunction("readDocument") { payload: String -> safeCall { store.readDocument(payload) } }.runOnQueue(scope)
+    AsyncFunction("initializeMemoTemplate") { payload: String -> safeCall { store.initializeMemoTemplate(payload) } }.runOnQueue(scope)
+    AsyncFunction("importDocument") { payload: String -> safeCall { store.importDocument(payload) } }.runOnQueue(scope)
+    AsyncFunction("commitOperation") { payload: String -> safeCall { store.commitOperation(payload) } }.runOnQueue(scope)
+    AsyncFunction("saveViewport") { payload: String -> safeCall { store.saveViewport(payload) } }.runOnQueue(scope)
+    AsyncFunction("saveLayoutProfile") { payload: String -> safeCall { store.saveLayoutProfile(payload) } }.runOnQueue(scope)
+    AsyncFunction("setActiveDocument") { payload: String -> safeCall { store.setActiveDocument(payload) } }.runOnQueue(scope)
+    AsyncFunction("deleteSession") { payload: String -> safeCall { store.deleteSession(payload) } }.runOnQueue(scope)
+    AsyncFunction("readImport") { payload: String -> safeCall { store.readImport(payload) } }.runOnQueue(scope)
+    AsyncFunction("flush") { safeCall { store.flush() } }.runOnQueue(scope)
+    OnDestroy {
+      executor.execute { if (storeDelegate.isInitialized()) store.close() }
+      executor.shutdown()
+    }
+  }
+}