chore: initialize standalone UPM package

.gitea/workflows/publish.yml

@@ -0,0 +1,49 @@
+name: Publish UPM package
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    env:
+      NODE_AUTH_TOKEN: ${{ secrets.SHRINKSDK_PACKAGE_TOKEN }}
+    steps:
+      - name: Fetch tagged revision
+        shell: bash
+        run: |
+          set -eu
+          ref="${{ gitea.sha }}"
+          test -n "$ref"
+          git init .
+          git remote add origin "https://git.crash.work/ShrinkSDK/ShrinkContext.EventBusAdapter.git"
+          git fetch --depth=1 origin "$ref"
+          git checkout --detach FETCH_HEAD
+
+      - name: Validate immutable release version
+        shell: bash
+        run: |
+          set -eu
+          tag="$(git describe --exact-match --tags HEAD)"
+          version="$(node -p "require('./package.json').version")"
+          test "$tag" = "v$version"
+          npm pack --dry-run
+
+      - name: Publish to ShrinkSDK registry
+        shell: bash
+        run: |
+          set -eu
+          : "${NODE_AUTH_TOKEN:?SHRINKSDK_PACKAGE_TOKEN is required}"
+          npmrc="$HOME/.npmrc"
+          cleanup() { rm -f "$npmrc"; }
+          trap cleanup EXIT
+          printf '%s\n' \
+            'registry=https://git.crash.work/api/packages/ShrinkSDK/npm/' \
+            '//git.crash.work/api/packages/ShrinkSDK/npm/:_authToken=${NODE_AUTH_TOKEN}' > "$npmrc"
+          npm publish --registry=https://git.crash.work/api/packages/ShrinkSDK/npm/

.gitea/workflows/unity-verify.yml

@@ -0,0 +1,39 @@
+name: Verify standalone Unity package
+
+on:
+  workflow_dispatch:
+
+jobs:
+  editmode:
+    runs-on: unity-2022.3.62f3
+    container:
+      image: docker.1panel.live/unityci/editor:ubuntu-2022.3.62f3-windows-mono-3
+      volumes:
+        - /www/dk_project/bt-recovery/gitea/runner/seedskey-unity-license:/root/.local/share/unity3d/Unity
+        - /www/dk_project/bt-recovery/gitea/runner/seedskey-unity-entitlements:/root/.config/unity3d/Unity/licenses
+    steps:
+      - name: Fetch selected revision
+        shell: bash
+        run: |
+          set -eu
+          ref="${{ gitea.sha }}"
+          git init .
+          git remote add origin "https://git.crash.work/ShrinkSDK/ShrinkContext.EventBusAdapter.git"
+          git fetch --depth=1 origin "$ref"
+          git checkout --detach FETCH_HEAD
+
+      - name: Run package EditMode tests
+        shell: bash
+        run: |
+          set -eu
+          unity_bin="$(command -v unity-editor || command -v unity || command -v Unity || true)"
+          test -n "$unity_bin"
+          "$unity_bin" \
+            -batchmode \
+            -nographics \
+            -quit \
+            -projectPath "$PWD/Development~/UnityProject" \
+            -runTests \
+            -testPlatform EditMode \
+            -testResults "$PWD/TestResults/editmode.xml" \
+            -logFile "$PWD/TestResults/unity.log"

.gitignore

@@ -0,0 +1,10 @@
+/Development~/UnityProject/[Ll]ibrary/
+/Development~/UnityProject/[Tt]emp/
+/Development~/UnityProject/[Oo]bj/
+/Development~/UnityProject/[Ll]ogs/
+/Development~/UnityProject/[Uu]ser[Ss]ettings/
+/Development~/UnityProject/TestResults/
+/Tools~/**/[Bb]in/
+/Tools~/**/[Oo]bj/
+*.user
+*.DotSettings.user

.npmignore

@@ -0,0 +1,8 @@
+.git/
+.gitea/
+Development~/
+Tools~/
+*.csproj
+*.sln
+*.user
+*.DotSettings.user

Development~/UnityProject/.gitignore

@@ -0,0 +1,6 @@
+[Ll]ibrary/
+[Tt]emp/
+[Oo]bj/
+[Ll]ogs/
+[Uu]ser[Ss]ettings/
+TestResults/

Development~/UnityProject/Packages/manifest.json

@@ -0,0 +1,15 @@
+{
+  "scopedRegistries": [
+    {
+      "name": "ShrinkSDK",
+      "url": "https://git.crash.work/api/packages/ShrinkSDK/npm/",
+      "scopes": [
+        "com.cneicy"
+      ]
+    }
+  ],
+  "dependencies": {
+    "com.unity.test-framework": "1.1.33",
+    "com.cneicy.shrink-context-eventbus-adapter": "file:../../.."
+  }
+}

Development~/UnityProject/ProjectSettings/ProjectVersion.txt

@@ -0,0 +1,2 @@
+m_EditorVersion: 2022.3.62f3
+m_EditorVersionWithRevision: 2022.3.62f3 (96770f904ca7)

Runtime.meta

@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: edcdd81338c534f4295d12a1db2cb2bc
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Runtime/ShrinkContext.EventBusAdapter.Runtime.asmdef

@@ -0,0 +1,14 @@
+{
+    "name": "ShrinkContext.EventBusAdapter.Runtime",
+    "rootNamespace": "ShrinkContext.EventBusAdapter",
+    "references": [
+        "ShrinkContext.Core.Runtime",
+        "ShrinkEventBus.Runtime",
+        "UniTask"
+    ],
+    "includePlatforms": [],
+    "excludePlatforms": [],
+    "allowUnsafeCode": false,
+    "overrideReferences": false,
+    "autoReferenced": false
+}

Runtime/ShrinkContext.EventBusAdapter.Runtime.asmdef.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: edea41497d7034e4c970a7368a156da4
+AssemblyDefinitionImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Runtime/ShrinkEventBusEffects.cs

@@ -0,0 +1,33 @@
+#nullable enable
+using System;
+using Cysharp.Threading.Tasks;
+using ShrinkContext;
+using ShrinkEventBus;
+
+namespace ShrinkContext.EventBusAdapter
+{
+    /// <summary>
+    /// 把生成的 ShrinkEventBus 绑定包装为可逆效应。
+    /// </summary>
+    public static class ShrinkEventBusEffects
+    {
+        /// <summary>
+        /// 激活生成的 [ShrinkSubscribe] 绑定，并在 Context 回滚时统一释放。
+        /// </summary>
+        public static ShrinkEffectHandle EffectAttach(this ShrinkCtx ctx, object target,
+            ShrinkBusKey? defaultBus = null)
+        {
+            if (ctx == null)
+                throw new ArgumentNullException(nameof(ctx));
+            if (target == null)
+                throw new ArgumentNullException(nameof(target));
+
+            var binding = EventBus.Attach(target, defaultBus);
+            return ctx.EffectInverse(() =>
+            {
+                binding.Dispose();
+                return UniTask.CompletedTask;
+            });
+        }
+    }
+}

Runtime/ShrinkEventBusEffects.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: e897f289a1563c34eb3c992463f66fbc
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Tests.meta

@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 0bede8304f5d8c2488e6c0a4c3fce9a8
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Tests/EventBusEffectTests.cs

@@ -0,0 +1,106 @@
+#nullable enable
+using System.Collections.Generic;
+using Cysharp.Threading.Tasks;
+using NUnit.Framework;
+using ShrinkContext;
+using ShrinkEventBus;
+using UnityEngine;
+
+namespace ShrinkContext.EventBusAdapter.Tests
+{
+    public sealed class PingEvent : IShrinkEvent
+    {
+        public int Value { get; set; }
+    }
+
+    /// <summary>
+    /// EventBus 订阅/注册即效应：组件停用时自动退订，无需手写卸载路径。
+    /// </summary>
+    public class EventBusEffectTests
+    {
+        private ShrinkContextRuntime _runtime = null!;
+        private ShrinkCtx _ctx = null!;
+
+        [SetUp]
+        public void SetUp()
+        {
+            _runtime = new ShrinkContextRuntime();
+            _ctx = _runtime.RootContext;
+        }
+
+        [TearDown]
+        public void TearDown()
+        {
+            _runtime.ShutdownAsync().GetAwaiter().GetResult();
+        }
+
+        [Test]
+        public void EffectAttach_ReceivesEvents_AndAutoUnsubscribesOnContextDispose()
+        {
+            var received = new List<int>();
+            var subscriber = new InstanceSubscriber(received);
+            _ctx.EffectAttach(subscriber);
+
+            EventBus.Post(new PingEvent { Value = 1 });
+            EventBus.Post(new PingEvent { Value = 2 });
+            CollectionAssert.AreEqual(new[] { 1, 2 }, received);
+
+            _ctx.DisposeAsync().GetAwaiter().GetResult();
+
+            EventBus.Post(new PingEvent { Value = 3 });
+            CollectionAssert.AreEqual(new[] { 1, 2 }, received,
+                "上下文回滚后 EventBus binding 必须通过 IDisposable.Dispose 自动退订");
+        }
+
+        [Test]
+        public void EffectAttach_ManualDispose_OnlyUnsubscribesOwn()
+        {
+            var first = new List<int>();
+            var second = new List<int>();
+            _ctx.EffectAttach(new InstanceSubscriber(first));
+            var handle = _ctx.EffectAttach(new InstanceSubscriber(second));
+
+            handle.DisposeAsync().GetAwaiter().GetResult();
+
+            EventBus.Post(new PingEvent { Value = 7 });
+            CollectionAssert.AreEqual(new[] { 7 }, first, "手动退订只影响自己的订阅");
+            Assert.IsEmpty(second);
+        }
+
+        [Test]
+        public void EffectAttach_ObjectSubscribers_AutoUnregisterOnContextDispose()
+        {
+            var values = new List<int>();
+            var subscriber = new InstanceSubscriber(values);
+            _ctx.EffectAttach(subscriber);
+
+            EventBus.Post(new PingEvent { Value = 5 });
+            Assert.AreEqual(5, subscriber.LastValue);
+
+            _ctx.DisposeAsync().GetAwaiter().GetResult();
+
+            EventBus.Post(new PingEvent { Value = 6 });
+            Assert.AreEqual(5, subscriber.LastValue, "实例注册随上下文回滚自动注销");
+        }
+
+        [ShrinkEventSubscriber(DefaultBus = "game")]
+        private sealed class InstanceSubscriber
+        {
+            private readonly List<int> _values;
+
+            public InstanceSubscriber(List<int> values)
+            {
+                _values = values;
+            }
+
+            public int LastValue { get; private set; }
+
+            [ShrinkSubscribe]
+            public void OnPing(PingEvent e)
+            {
+                LastValue = e.Value;
+                _values.Add(e.Value);
+            }
+        }
+    }
+}

Tests/EventBusEffectTests.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 675a7f1a5e7d2974d81a29504efd1367
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Tests/ShrinkContext.EventBusAdapter.Tests.asmdef

@@ -0,0 +1,24 @@
+{
+    "name": "ShrinkContext.EventBusAdapter.Tests",
+    "rootNamespace": "ShrinkContext.EventBusAdapter.Tests",
+    "references": [
+        "ShrinkContext.EventBusAdapter.Runtime",
+        "ShrinkContext.Core.Runtime",
+        "ShrinkEventBus.Runtime",
+        "UniTask",
+        "UnityEngine.TestRunner",
+        "UnityEditor.TestRunner"
+    ],
+    "includePlatforms": [
+        "Editor"
+    ],
+    "excludePlatforms": [],
+    "allowUnsafeCode": false,
+    "overrideReferences": false,
+    "autoReferenced": false,
+    "defineConstraints": [
+        "UNITY_INCLUDE_TESTS"
+    ],
+    "versionDefines": [],
+    "noEngineReferences": false
+}

Tests/ShrinkContext.EventBusAdapter.Tests.asmdef.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: ca6bd51b2cb359840a7d8cc5ceb8831b
+AssemblyDefinitionImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package.json

@@ -0,0 +1,23 @@
+{
+  "name": "com.cneicy.shrink-context-eventbus-adapter",
+  "version": "0.1.0",
+  "displayName": "ShrinkContext - EventBus Adapter",
+  "description": "把 ShrinkEventBus 订阅/注册包装为 ShrinkContext 可逆效应：订阅即效应，停用自动退订。",
+  "unity": "2022.3",
+  "dependencies": {
+    "com.cneicy.shrink-context-core": "0.1.0",
+    "com.cneicy.shrink-eventbus": "2.0.0",
+    "com.cysharp.unitask": "2.5.10"
+  },
+  "keywords": [
+    "context",
+    "cordis",
+    "eventbus",
+    "effect"
+  ],
+  "author": {
+    "name": "cneicy",
+    "url": "https://git.crash.work/ShrinkSDK"
+  },
+  "documentationUrl": "https://git.crash.work/ShrinkSDK/ShrinkContext.EventBusAdapter"
+}

package.json.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 3da06949de60a124e8b50d3ed14401ed
+TextScriptImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: