@talex-touch/utils 1.0.42 → 1.0.44

package/renderer/hooks/use-market-sdk.ts

@@ -0,0 +1,16 @@
+import { onUnmounted } from 'vue'
+import { useTuffTransport } from '../../transport'
+import { createDisposableBag } from '../../transport/sdk'
+import { createMarketSdk } from '../../transport/sdk/domains/market'
+
+export function useMarketSdk() {
+  const transport = useTuffTransport()
+  return createMarketSdk(transport)
+}
+
+export function useMarketSdkScope() {
+  const sdk = useMarketSdk()
+  const disposables = createDisposableBag()
+  onUnmounted(() => disposables.dispose())
+  return { sdk, disposables }
+}

package/renderer/hooks/use-notification-sdk.ts

@@ -0,0 +1,7 @@
+import { createNotificationSdk } from '../../transport/sdk/domains/notification'
+import { useTuffTransport } from '../../transport/sdk/index'
+
+export function useNotificationSdk() {
+  const transport = useTuffTransport()
+  return createNotificationSdk(transport)
+}

package/renderer/hooks/use-permission-sdk.ts

@@ -0,0 +1,7 @@
+import { useTuffTransport } from '../../transport'
+import { createPermissionSdk } from '../../transport/sdk/domains/permission'
+
+export function usePermissionSdk() {
+  const transport = useTuffTransport()
+  return createPermissionSdk(transport)
+}

package/renderer/hooks/use-permission.ts

@@ -0,0 +1,325 @@
+/**
+ * usePermission - Permission management hooks for renderer process
+ */
+
+import type {
+  PermissionDefinition,
+  PermissionGrant,
+  PluginPermissionStatus,
+} from '../../permission/types'
+import { computed, onMounted, onUnmounted, ref } from 'vue'
+import { usePermissionSdk } from './use-permission-sdk'
+
+/**
+ * Hook for managing plugin permissions
+ */
+/**
+ * @deprecated 请优先使用 usePermissionSdk()，该 hook 仅保留兼容壳。
+ */
+
+export function usePermission(pluginId: string) {
+  const permissionSdk = usePermissionSdk()
+  const permissions = ref<PermissionGrant[]>([])
+  const loading = ref(true)
+  const error = ref<string | null>(null)
+
+  /**
+   * Refresh permissions from main process
+   */
+  async function refresh(): Promise<void> {
+    loading.value = true
+    error.value = null
+    try {
+      const result = await permissionSdk.getPlugin({ pluginId })
+      permissions.value = result || []
+    }
+    catch (e) {
+      error.value = (e as Error).message
+    }
+    finally {
+      loading.value = false
+    }
+  }
+
+  /**
+   * Grant a permission
+   */
+  async function grant(permissionId: string): Promise<boolean> {
+    try {
+      const result = await permissionSdk.grant({
+        pluginId,
+        permissionId,
+        grantedBy: 'user',
+      })
+      if (result?.success) {
+        await refresh()
+      }
+      return result?.success || false
+    }
+    catch {
+      return false
+    }
+  }
+
+  /**
+   * Revoke a permission
+   */
+  async function revoke(permissionId: string): Promise<boolean> {
+    try {
+      const result = await permissionSdk.revoke({
+        pluginId,
+        permissionId,
+      })
+      if (result?.success) {
+        await refresh()
+      }
+      return result?.success || false
+    }
+    catch {
+      return false
+    }
+  }
+
+  /**
+   * Grant multiple permissions
+   */
+  async function grantMultiple(permissionIds: string[]): Promise<boolean> {
+    try {
+      const result = await permissionSdk.grantMultiple({
+        pluginId,
+        permissionIds,
+        grantedBy: 'user',
+      })
+      if (result?.success) {
+        await refresh()
+      }
+      return result?.success || false
+    }
+    catch {
+      return false
+    }
+  }
+
+  /**
+   * Revoke all permissions
+   */
+  async function revokeAll(): Promise<boolean> {
+    try {
+      const result = await permissionSdk.revokeAll({
+        pluginId,
+      })
+      if (result?.success) {
+        await refresh()
+      }
+      return result?.success || false
+    }
+    catch {
+      return false
+    }
+  }
+
+  /**
+   * Check if a permission is granted
+   */
+  function isGranted(permissionId: string): boolean {
+    return permissions.value.some(p => p.permissionId === permissionId)
+  }
+
+  /**
+   * Get granted permission IDs
+   */
+  const grantedIds = computed(() => permissions.value.map(p => p.permissionId))
+
+  // Listen for permission updates
+  let unsubscribe: (() => void) | null = null
+
+  onMounted(() => {
+    refresh()
+    unsubscribe = permissionSdk.onUpdated((payload) => {
+      if (payload?.pluginId === pluginId) {
+        refresh()
+      }
+    })
+  })
+
+  onUnmounted(() => {
+    unsubscribe?.()
+  })
+
+  return {
+    permissions,
+    loading,
+    error,
+    refresh,
+    grant,
+    revoke,
+    grantMultiple,
+    revokeAll,
+    isGranted,
+    grantedIds,
+  }
+}
+
+/**
+ * Hook for getting plugin permission status
+ */
+/**
+ * @deprecated 请优先使用 usePermissionSdk().getStatus()，该 hook 仅保留兼容壳。
+ */
+
+export function usePermissionStatus(
+  pluginId: string,
+  sdkapi: number | undefined,
+  declared: { required: string[], optional: string[] },
+) {
+  const permissionSdk = usePermissionSdk()
+  const status = ref<PluginPermissionStatus | null>(null)
+  const loading = ref(true)
+
+  async function refresh(): Promise<void> {
+    loading.value = true
+    try {
+      const result = await permissionSdk.getStatus({
+        pluginId,
+        sdkapi,
+        required: declared.required,
+        optional: declared.optional,
+      })
+      status.value = result
+    }
+    catch {
+      status.value = null
+    }
+    finally {
+      loading.value = false
+    }
+  }
+
+  // Computed helpers
+  const enforcePermissions = computed(() => status.value?.enforcePermissions ?? false)
+  const missingRequired = computed(() => status.value?.missingRequired ?? [])
+  const hasWarning = computed(() => !!status.value?.warning)
+  const warning = computed(() => status.value?.warning)
+
+  onMounted(() => {
+    refresh()
+  })
+
+  return {
+    status,
+    loading,
+    refresh,
+    enforcePermissions,
+    missingRequired,
+    hasWarning,
+    warning,
+  }
+}
+
+/**
+ * Hook for getting permission registry (all available permissions)
+ */
+/**
+ * @deprecated 请优先使用 usePermissionSdk().getRegistry()，该 hook 仅保留兼容壳。
+ */
+
+export function usePermissionRegistry() {
+  const permissionSdk = usePermissionSdk()
+  const registry = ref<PermissionDefinition[]>([])
+  const loading = ref(true)
+
+  async function refresh(): Promise<void> {
+    loading.value = true
+    try {
+      const result = await permissionSdk.getRegistry()
+      registry.value = result || []
+    }
+    catch {
+      registry.value = []
+    }
+    finally {
+      loading.value = false
+    }
+  }
+
+  /**
+   * Get permission by ID
+   */
+  function getPermission(id: string): PermissionDefinition | undefined {
+    return registry.value.find(p => p.id === id)
+  }
+
+  /**
+   * Get permissions by category
+   */
+  function byCategory(category: string): PermissionDefinition[] {
+    return registry.value.filter(p => p.category === category)
+  }
+
+  /**
+   * Get permissions by risk level
+   */
+  function byRisk(risk: string): PermissionDefinition[] {
+    return registry.value.filter(p => p.risk === risk)
+  }
+
+  onMounted(() => {
+    refresh()
+  })
+
+  return {
+    registry,
+    loading,
+    refresh,
+    getPermission,
+    byCategory,
+    byRisk,
+  }
+}
+
+/**
+ * Hook for getting all plugin permissions
+ */
+/**
+ * @deprecated 请优先使用 usePermissionSdk().getAll()，该 hook 仅保留兼容壳。
+ */
+
+export function useAllPluginPermissions() {
+  const permissionSdk = usePermissionSdk()
+  const permissions = ref<Record<string, PermissionGrant[]>>({})
+  const loading = ref(true)
+
+  async function refresh(): Promise<void> {
+    loading.value = true
+    try {
+      const result = await permissionSdk.getAll()
+      permissions.value = result || {}
+    }
+    catch {
+      permissions.value = {}
+    }
+    finally {
+      loading.value = false
+    }
+  }
+
+  // Listen for permission updates
+  let unsubscribe: (() => void) | null = null
+
+  onMounted(() => {
+    refresh()
+    unsubscribe = permissionSdk.onUpdated(() => {
+      refresh()
+    })
+  })
+
+  onUnmounted(() => {
+    unsubscribe?.()
+  })
+
+  return {
+    permissions,
+    loading,
+    refresh,
+  }
+}

package/renderer/hooks/use-platform-sdk.ts

@@ -0,0 +1,7 @@
+import { useTuffTransport } from '../../transport'
+import { createPlatformSdk } from '../../transport/sdk/domains/platform'
+
+export function usePlatformSdk() {
+  const transport = useTuffTransport()
+  return createPlatformSdk(transport)
+}

package/renderer/hooks/use-plugin-sdk.ts

@@ -0,0 +1,16 @@
+import { onUnmounted } from 'vue'
+import { useTuffTransport } from '../../transport'
+import { createDisposableBag } from '../../transport/sdk'
+import { createPluginSdk } from '../../transport/sdk/domains/plugin'
+
+export function usePluginSdk() {
+  const transport = useTuffTransport()
+  return createPluginSdk(transport)
+}
+
+export function usePluginSdkScope() {
+  const sdk = usePluginSdk()
+  const disposables = createDisposableBag()
+  onUnmounted(() => disposables.dispose())
+  return { sdk, disposables }
+}

package/renderer/hooks/use-settings-sdk.ts

@@ -0,0 +1,7 @@
+import { useTuffTransport } from '../../transport'
+import { createSettingsSdk } from '../../transport/sdk/domains/settings'
+
+export function useSettingsSdk() {
+  const transport = useTuffTransport()
+  return createSettingsSdk(transport)
+}

package/renderer/hooks/use-update-sdk.ts

@@ -0,0 +1,21 @@
+import { onUnmounted } from 'vue'
+import { useTuffTransport } from '../../transport'
+import { createDisposableBag } from '../../transport/sdk'
+import { createUpdateSdk } from '../../transport/sdk/domains/update'
+
+export function useUpdateSdk() {
+  const transport = useTuffTransport()
+  return createUpdateSdk(transport)
+}
+
+export function useUpdateSdkScope() {
+  const sdk = useUpdateSdk()
+  const disposables = createDisposableBag()
+  const register = (dispose: () => void) => {
+    disposables.add(dispose)
+    return dispose
+  }
+
+  onUnmounted(() => disposables.dispose())
+  return { sdk, disposables, register }
+}

package/renderer/index.ts

@@ -8,3 +8,4 @@ export * from './storage'
 
 export * from './touch-sdk'
 export * from './touch-sdk/utils'
+export * from './shared'

package/renderer/ref.ts

@@ -1,38 +1,47 @@
+import type { WritableComputedRef } from 'vue'
 import { computed, customRef } from 'vue'
 
-export function useModelWrapper(props: any, emit: any, name = 'modelValue') {
+export function useModelWrapper<
+  P extends Record<string, unknown>,
+  K extends string = 'modelValue'
+>(
+  props: P,
+  emit: (event: `update:${K}`, value: P[K]) => void,
+  name?: K
+): WritableComputedRef<P[K]> {
+  const key = (name ?? 'modelValue') as K
   return computed({
-    get: () => props[name],
-    set: value => emit(`update:${name}`, value),
+    get: () => props[key] as P[K],
+    set: value => emit(`update:${key}` as `update:${K}`, value),
   })
 }
 
-export function throttleRef(value: any, time: number) {
+export function throttleRef<T>(value: T, time: number) {
   let ts = 0
 
-  return customRef((track, trigger) => {
+  return customRef<T>((track, trigger) => {
     return {
       get() {
         track()
         return value
       },
       set(newValue) {
-        if (new Date().getTime() - ts < time)
+        if (Date.now() - ts < time)
           return
 
         value = newValue
         track()
         trigger()
-        ts = new Date().getTime()
+        ts = Date.now()
       },
     }
   })
 }
 
-export function debounceRef(value: any, delay: number) {
-  let timer: any
+export function debounceRef<T>(value: T, delay: number) {
+  let timer: ReturnType<typeof setTimeout> | undefined
 
-  return customRef((track, trigger) => {
+  return customRef<T>((track, trigger) => {
     return {
       get() {
         track()

package/renderer/shared/components/SharedPluginDetailContent.vue

@@ -0,0 +1,84 @@
+<script setup lang="ts">
+import type { SharedPluginDetail } from '../plugin-detail'
+import { computed } from 'vue'
+import SharedPluginDetailHeader from './SharedPluginDetailHeader.vue'
+import SharedPluginDetailMetaList from './SharedPluginDetailMetaList.vue'
+import SharedPluginDetailReadme from './SharedPluginDetailReadme.vue'
+import SharedPluginDetailVersions from './SharedPluginDetailVersions.vue'
+
+interface Props {
+  detail: SharedPluginDetail
+  showMeta?: boolean
+  showReadme?: boolean
+  showVersions?: boolean
+  readmeTitle?: string
+  versionsTitle?: string
+  metaTitle?: string
+  emptyReadmeText?: string
+  emptyVersionsText?: string
+  renderMarkdown?: (markdown: string) => string
+  formatDate?: (value: string | number | Date) => string
+  formatNumber?: (value: number) => string
+  formatSize?: (value: number) => string
+  installsText?: string
+  versionText?: string
+  updatedText?: string
+  officialLabel?: string
+  installsLabel?: string
+  versionLabel?: string
+  updatedLabel?: string
+}
+
+const props = withDefaults(defineProps<Props>(), {
+  showMeta: true,
+  showReadme: true,
+  showVersions: true,
+  readmeTitle: 'README',
+  versionsTitle: 'Versions',
+  metaTitle: '',
+  emptyReadmeText: 'No README',
+  emptyVersionsText: 'No versions'
+})
+
+const hasMeta = computed(() => (props.detail.metaItems?.length ?? 0) > 0)
+</script>
+
+<template>
+  <div class="space-y-6">
+    <SharedPluginDetailHeader
+      :detail="detail"
+      :format-date="formatDate"
+      :format-number="formatNumber"
+      :installs-text="installsText"
+      :version-text="versionText"
+      :updated-text="updatedText"
+      :official-label="officialLabel"
+      :installs-label="installsLabel"
+      :version-label="versionLabel"
+      :updated-label="updatedLabel"
+    />
+
+    <div class="flex flex-col gap-6 lg:flex-row">
+      <div class="min-w-0 flex-1 space-y-6">
+        <SharedPluginDetailReadme
+          v-if="showReadme"
+          :readme="detail.readme"
+          :title="readmeTitle"
+          :empty-text="emptyReadmeText"
+          :render-markdown="renderMarkdown"
+        />
+        <SharedPluginDetailVersions
+          v-if="showVersions"
+          :versions="detail.versions"
+          :title="versionsTitle"
+          :empty-text="emptyVersionsText"
+          :format-date="formatDate"
+          :format-size="formatSize"
+        />
+      </div>
+      <aside v-if="showMeta && hasMeta" class="w-full lg:w-64">
+        <SharedPluginDetailMetaList :items="detail.metaItems" :title="metaTitle" />
+      </aside>
+    </div>
+  </div>
+</template>

package/renderer/shared/components/SharedPluginDetailHeader.vue

@@ -0,0 +1,116 @@
+<script setup lang="ts">
+import type { SharedPluginDetail } from '../plugin-detail'
+import { computed } from 'vue'
+
+interface Props {
+  detail: SharedPluginDetail
+  formatDate?: (value: string | number | Date) => string
+  formatNumber?: (value: number) => string
+  installsText?: string
+  versionText?: string
+  updatedText?: string
+  officialLabel?: string
+  installsLabel?: string
+  versionLabel?: string
+  updatedLabel?: string
+}
+
+const props = withDefaults(defineProps<Props>(), {
+  officialLabel: 'Official',
+  installsLabel: 'Installs',
+  versionLabel: 'Version',
+  updatedLabel: 'Updated'
+})
+
+const displayInstalls = computed(() => {
+  if (props.detail.installs === undefined || props.detail.installs === null) {
+    return ''
+  }
+  return props.formatNumber ? props.formatNumber(props.detail.installs) : `${props.detail.installs}`
+})
+
+const installsPillText = computed(() => {
+  if (props.installsText) return props.installsText
+  if (!displayInstalls.value) return ''
+  return `${props.installsLabel} · ${displayInstalls.value}`
+})
+
+const updatedAtValue = computed(() => {
+  return props.detail.updatedAt ?? props.detail.latestVersion?.createdAt
+})
+
+const displayUpdatedAt = computed(() => {
+  if (!updatedAtValue.value) return ''
+  if (props.formatDate) return props.formatDate(updatedAtValue.value)
+  const date = new Date(updatedAtValue.value as any)
+  return Number.isNaN(date.valueOf()) ? `${updatedAtValue.value}` : date.toLocaleDateString()
+})
+
+const displayVersion = computed(() => props.detail.latestVersion?.version ?? '')
+
+const isOfficial = computed(() => props.detail.official || props.detail.trustLevel === 'official')
+
+const versionPillText = computed(() => {
+  if (props.versionText) return props.versionText
+  if (!displayVersion.value) return ''
+  return `${props.versionLabel} · v${displayVersion.value}`
+})
+
+const updatedPillText = computed(() => {
+  if (props.updatedText) return props.updatedText
+  if (!displayUpdatedAt.value) return ''
+  return `${props.updatedLabel} · ${displayUpdatedAt.value}`
+})
+</script>
+
+<template>
+  <header class="space-y-3">
+    <div class="flex flex-wrap items-center gap-2">
+      <h2 class="text-2xl font-semibold">
+        {{ detail.name }}
+      </h2>
+      <span
+        v-if="isOfficial"
+        class="inline-flex items-center rounded-full bg-emerald-100 px-2 py-0.5 text-xs text-emerald-700"
+      >
+        {{ officialLabel }}
+      </span>
+      <span
+        v-if="detail.category?.label"
+        class="inline-flex items-center rounded-full bg-black/5 px-2 py-0.5 text-xs text-black/70"
+      >
+        {{ detail.category.label }}
+      </span>
+    </div>
+
+    <p v-if="detail.summary" class="text-sm text-black/70">
+      {{ detail.summary }}
+    </p>
+
+    <p v-if="detail.author?.name" class="text-xs text-black/50">
+      {{ detail.author.name }}
+    </p>
+
+    <div class="flex flex-wrap gap-2 text-xs text-black/60">
+      <span v-if="installsPillText" class="inline-flex items-center rounded-full bg-black/5 px-2 py-0.5">
+        {{ installsPillText }}
+      </span>
+      <span v-if="versionPillText" class="inline-flex items-center rounded-full bg-black/5 px-2 py-0.5">
+        {{ versionPillText }}
+      </span>
+      <span v-if="updatedPillText" class="inline-flex items-center rounded-full bg-black/5 px-2 py-0.5">
+        {{ updatedPillText }}
+      </span>
+    </div>
+
+    <div v-if="detail.badges?.length" class="flex flex-wrap gap-2">
+      <span
+        v-for="badge in detail.badges"
+        :key="badge"
+        class="inline-flex items-center rounded-full bg-black/5 px-2 py-0.5 text-xs text-black/70"
+      >
+        {{ badge }}
+      </span>
+    </div>
+  </header>
+</template>