ref(extension): 切换至独立 Web Runtime

- 由 Client Web 组合 Registry、Module Federation 与 Extension manager
- 通过已发布 tgz 接入 Runtime 0.1.0 并提升 Host SDK 至 0.1.2
- 适配精确 Peer 启停并保留 Twitter setup popup

Author: xiaoland

apps/client-web/package.json

@@ -18,6 +18,7 @@
     "@codemirror/state": "^6.5.2",
     "@codemirror/view": "^6.38.8",
     "@inkcre/core": "workspace:*",
+    "@inkcre/extension-runtime-client-web": "https://github.com/InKCre/ext-reg/releases/download/runtime-client-web-v0.1.0/inkcre-extension-runtime-client-web-0.1.0.tgz",
     "@inkcre/ui-web": "1.4.0",
     "@module-federation/runtime": "^0.21.4",
     "@supabase/postgrest-js": "^2.84.0",

apps/client-web/src/components/extension/extensionCard/extensionCard.spec.ts

@@ -2,7 +2,7 @@
 import { ref, computed, nextTick, shallowRef, watch, type Component } from 'vue'
 import { useI18n } from 'vue-i18n'
 import { InkButton, InkSwitch, InkDialog, InkInput, InkJsonEditor } from '@inkcre/ui-web'
-import { getExtensionHost } from '@/core'
+import { getExtensionHost, getExtensionSetupContribution } from '@/core'
 import { extensionCardProps, extensionCardEmits } from './extensionCard'
 
 const props = defineProps(extensionCardProps)
@@ -14,7 +14,7 @@ const configPopupOpen = ref<boolean | Promise<boolean>>(false)
 const versionPopupOpen = ref<boolean | Promise<boolean>>(false)
 const setupPopupOpen = ref(false)
 const setupComponent = shallowRef<Component | null>(null)
-const setupContribution = shallowRef(getExtensionHost().getSetupContribution(props.extension.name))
+const setupContribution = shallowRef(getExtensionSetupContribution(props.extension.name))
 const togglePromise = ref<Promise<boolean> | null>(null)
 const isUninstalling = ref(false)
 const operationError = ref<string | null>(null)
@@ -51,7 +51,7 @@ const toggleModel = computed({
         operationError.value = error instanceof Error ? error.message : String(error)
         return props.enabled
       } finally {
-        setupContribution.value = getExtensionHost().getSetupContribution(props.extension.name)
+        setupContribution.value = getExtensionSetupContribution(props.extension.name)
         togglePromise.value = null
       }
     })()

apps/client-web/src/components/extension/extensionCard/extensionCard.vue

@@ -8,11 +8,7 @@
 import {
   configStore,
   ExtensionRegistryOriginResolver,
-  getMFImplementation,
   localStorageAdapter,
-  PostgrestExtensionStatePort,
-  RegistryExtensionReleaseReader,
-  setMFImplementation,
   registerCoreResolvers,
   TextResolver,
   AudioResolver,
@@ -26,10 +22,15 @@ import {
   PeerManager,
   WebPeerRuntime,
   JobManager,
-  WebExtensionHost,
-  type ExtensionStatePort,
+  type ExtensionModule,
+  type ExtensionSetupContribution,
 } from '@inkcre/core'
-import { createInstance } from '@module-federation/enhanced/runtime'
+import { createInstance } from '@module-federation/runtime'
+import {
+  ExtensionManager,
+  RegistryReleaseReader,
+  type WebExtensionModule,
+} from '@inkcre/extension-runtime-client-web'
 import * as InKCreCore from '@inkcre/core'
 import * as Zod from 'zod'
 import * as Vue from 'vue'
@@ -80,50 +81,53 @@ export function setupResolvers(): void {
 // Configuration
 // ============================================================================
 
-let extensionHost: WebExtensionHost | null = null
+type ClientExtensionModule = WebExtensionModule & ExtensionModule
+type ClientExtensionManager = ExtensionManager<ClientExtensionModule>
+
+let extensionHost: ClientExtensionManager | null = null
 let extensionHostStartup: Promise<void> | null = null
-let extensionState: ExtensionStatePort | null = null
+let moduleFederation: ReturnType<typeof createInstance> | null = null
 let webPeerRuntime: WebPeerRuntime | null = null
 
-export function initializeExtensionHost(state: ExtensionStatePort): WebExtensionHost {
+export function initializeExtensionHost(): ClientExtensionManager {
   extensionHostStartup = null
-  extensionState = state
   const registryOrigin = new ExtensionRegistryOriginResolver(
     () => configStore.peerConfig.extension_registry_url
   )
-  extensionHost = new WebExtensionHost({
-    state,
-    releases: new RegistryExtensionReleaseReader(() => registryOrigin.resolve()),
-    moduleFederation: getMFImplementation,
-    currentPeerId: () => configStore.metaConfig.INKCRE_PEER_ID,
-    hostSdkVersion: corePackageJson.version,
+  if (!moduleFederation) throw new Error('Module Federation has not been initialized.')
+  extensionHost = new ExtensionManager<ClientExtensionModule>({
+    releases: new RegistryReleaseReader({
+      registryOrigin: () => registryOrigin.resolve(),
+      hostSdk: { name: '@inkcre/core', version: corePackageJson.version },
+    }),
+    moduleFederation,
   })
   return extensionHost
 }
 
-export function getExtensionState(): ExtensionStatePort {
-  if (!extensionState) throw new Error('Web Extension state port has not been initialized.')
-  return extensionState
-}
-
 /** Share one initial runtime restore across the app shell and management view. */
 export function startExtensionHost(): Promise<void> {
   if (extensionHostStartup) return extensionHostStartup
-  const startup = getExtensionHost().startup()
+  const startup = getExtensionHost().startup(configStore.metaConfig.INKCRE_PEER_ID)
   extensionHostStartup = startup.catch((error: unknown) => {
     extensionHostStartup = null
     throw error
   })
   return extensionHostStartup
 }
 
-export function getExtensionHost(): WebExtensionHost {
+export function getExtensionHost(): ClientExtensionManager {
   if (!extensionHost) {
     throw new Error('Web Extension Host state port has not been initialized.')
   }
   return extensionHost
 }
 
+/** Project the running native module into the Client-owned setup popup contract. */
+export function getExtensionSetupContribution(name: string): ExtensionSetupContribution | null {
+  return getExtensionHost().getModule(name)?.setup ?? null
+}
+
 /** Replace the browser-owned lease runtime after a validated Settings cutover. */
 export function adoptWebPeerRuntime(runtime: WebPeerRuntime): void {
   webPeerRuntime?.stop()
@@ -154,10 +158,10 @@ export async function startConfiguredWebPeerRuntime(): Promise<void> {
 
 /**
  * Initialize Module Federation runtime.
- * Creates the MF instance and injects it into core.
+ * Creates the MF instance consumed by the application-owned Extension manager.
  */
 export function initializeModuleFederation(): void {
-  const mfInstance = createInstance({
+  moduleFederation = createInstance({
     name: 'host',
     remotes: [],
     shared: {
@@ -212,21 +216,6 @@ export function initializeModuleFederation(): void {
     },
   })
 
-  // Inject MF implementation into core
-  const mfImpl = {
-    registerRemotes: (
-      remotes: Array<{ name: string; entry: string; type?: 'module' | 'script' }>,
-      options?: { force?: boolean }
-    ) => {
-      mfInstance.registerRemotes(remotes, options)
-    },
-    loadRemote: async <T>(remoteName: string): Promise<T | null> => {
-      return mfInstance.loadRemote<T>(remoteName)
-    },
-  }
-
-  setMFImplementation(mfImpl)
-
   console.log('[Core] Module Federation initialized')
 }
 
@@ -266,7 +255,7 @@ export async function initializeCore(options: { loadPeerConfig?: boolean } = {})
   JobManager.startWorker()
   setupResolvers()
   initializeModuleFederation()
-  initializeExtensionHost(new PostgrestExtensionStatePort())
+  initializeExtensionHost()
   if (webPeerRuntime) await webPeerRuntime.start()
   console.log('[Core] Initialization complete')
 }