@owdproject/core 3.4.0 → 4.0.0-alpha.3

package/runtime/stores/storeDesktop.ts

@@ -1,71 +0,0 @@
-import { defineStore } from 'pinia'
-import { ref } from 'vue'
-import { DESKTOP_STORE_ID } from './storeIds'
-
-export const useDesktopStore = defineStore(
-  DESKTOP_STORE_ID,
-  () => {
-    const state = ref<{
-      workspace: {
-        overview: boolean
-        active: string
-        list: string[]
-      }
-      volume: {
-        master: number
-      }
-      window: {
-        positionZ: number
-      }
-      defaultApps: Record<string, { applicationId: string; entry: string }>
-      personalization: {
-        windowSurface: 'acrylic' | 'solid'
-        windowTint: string
-        appearance: 'dark' | 'light'
-      }
-    }>({
-      workspace: {
-        overview: false,
-        active: '',
-        list: [],
-      },
-      volume: {
-        master: 100,
-      },
-      window: {
-        positionZ: 0,
-      },
-      defaultApps: {},
-      personalization: {
-        windowSurface: 'acrylic',
-        windowTint: '#2d2d30',
-        appearance: 'dark',
-      },
-    })
-
-    function setWindowSurface(value: 'acrylic' | 'solid') {
-      state.value.personalization.windowSurface = value
-    }
-
-    function setWindowTint(value: string) {
-      state.value.personalization.windowTint = value
-    }
-
-    function setAppearance(value: 'dark' | 'light') {
-      state.value.personalization.appearance = value
-    }
-
-    return {
-      state,
-      setWindowSurface,
-      setWindowTint,
-      setAppearance,
-    }
-  },
-  {
-    // @ts-expect-error
-    persistedState: {
-      persist: true,
-    },
-  },
-)

package/runtime/stores/storeDesktopDefaultApps.ts

@@ -1,54 +0,0 @@
-import { defineStore } from 'pinia'
-import { useDesktopStore } from './storeDesktop'
-import { DESKTOP_DEFAULT_APPS_STORE_ID } from './storeIds'
-
-export const useDesktopDefaultAppsStore = defineStore(
-  DESKTOP_DEFAULT_APPS_STORE_ID,
-  () => {
-    const desktopStore = useDesktopStore()
-
-    /**
-     * Sets a default app for a given feature
-     */
-    function setDefaultApp(
-      feature: string,
-      application: IApplicationController,
-      entry: string,
-    ) {
-      if (!desktopStore.state.hasOwnProperty('defaultApps')) {
-        desktopStore.state.defaultApps = {}
-      }
-
-      desktopStore.state.defaultApps[feature] = {
-        applicationId: application.id,
-        entry,
-      }
-    }
-
-    /**
-     * Gets the default app config for a given feature
-     */
-    function getDefaultApp(feature: string): DefaultAppConfig | undefined {
-      if (!desktopStore.state.hasOwnProperty('defaultApps')) {
-        desktopStore.state.defaultApps = {}
-      }
-
-      return desktopStore.state.defaultApps[feature]
-    }
-
-    /**
-     * Loads default apps from current config
-     */
-    function loadDefaultAppsFromConfig(runtimeConfig) {
-      if (runtimeConfig.public.desktop.defaultApps) {
-        desktopStore.state.defaultApps = runtimeConfig.public.desktop.defaultApps
-      }
-    }
-
-    return {
-      setDefaultApp,
-      getDefaultApp,
-      loadDefaultAppsFromConfig,
-    }
-  },
-)

package/runtime/stores/storeDesktopVolume.ts

@@ -1,19 +0,0 @@
-import { defineStore } from 'pinia'
-import { computed } from 'vue'
-import { useDesktopStore } from './storeDesktop'
-import { DESKTOP_VOLUME_STORE_ID } from './storeIds'
-
-export const useDesktopVolumeStore = defineStore(DESKTOP_VOLUME_STORE_ID, () => {
-  const desktopStore = useDesktopStore()
-
-  const master = computed(() => desktopStore.state.volume.master)
-
-  function setMasterVolume(value: number) {
-    desktopStore.state.volume.master = value
-  }
-
-  return {
-    master,
-    setMasterVolume,
-  }
-})

package/runtime/stores/storeDesktopWindow.ts

@@ -1,38 +0,0 @@
-import type { DesktopWorkAreaRect } from '@owdproject/core'
-import { defineStore } from 'pinia'
-import { computed, readonly, shallowRef } from 'vue'
-import { useDesktopStore } from './storeDesktop'
-import { DESKTOP_WINDOW_STORE_ID } from './storeIds'
-
-export const EMPTY_DESKTOP_WORK_AREA: DesktopWorkAreaRect = {
-  x: 0,
-  y: 0,
-  width: 0,
-  height: 0,
-}
-
-export const useDesktopWindowStore = defineStore(DESKTOP_WINDOW_STORE_ID, () => {
-  const desktopStore = useDesktopStore()
-  const workArea = shallowRef<DesktopWorkAreaRect>({
-    ...EMPTY_DESKTOP_WORK_AREA,
-  })
-
-  const positionZ = computed(() => desktopStore.state.window.positionZ)
-
-  function incrementPositionZ() {
-    desktopStore.state.window.positionZ++
-
-    return desktopStore.state.window.positionZ
-  }
-
-  function setWorkArea(rect: DesktopWorkAreaRect) {
-    workArea.value = { ...rect }
-  }
-
-  return {
-    positionZ,
-    incrementPositionZ,
-    workArea: readonly(workArea),
-    setWorkArea,
-  }
-})

package/runtime/stores/storeDesktopWorkspace.ts

@@ -1,105 +0,0 @@
-import { defineStore } from 'pinia'
-import { computed } from 'vue'
-import { useDesktopStore } from './storeDesktop'
-import { DESKTOP_WORKSPACE_STORE_ID } from './storeIds'
-import { nanoid } from 'nanoid'
-
-export const useDesktopWorkspaceStore = defineStore(
-  DESKTOP_WORKSPACE_STORE_ID,
-  () => {
-    const desktopStore = useDesktopStore()
-
-    const active = computed(() => {
-      return desktopStore.state.workspace.active
-    })
-
-    const overview = computed(() => {
-      return desktopStore.state.workspace.overview
-    })
-
-    const list = computed(() => {
-      return desktopStore.state.workspace.list
-    })
-
-    function setupWorkspaces() {
-      if (desktopStore.state.workspace.list.length === 0) {
-        createWorkspace()
-      }
-
-      if (desktopStore.state.workspace.list.length === 1) {
-        createWorkspace()
-      }
-
-      const list = desktopStore.state.workspace.list
-      const active = desktopStore.state.workspace.active
-      if (!active || !list.includes(active)) {
-        desktopStore.state.workspace.active = list[0] ?? ''
-      }
-    }
-
-    /** Id of the workspace new windows should use (after setupWorkspaces). */
-    function resolveActiveWorkspaceId(): string {
-      setupWorkspaces()
-      return desktopStore.state.workspace.active || desktopStore.state.workspace.list[0] || ''
-    }
-
-    function setOverview(value: boolean) {
-      desktopStore.state.workspace.overview = value
-    }
-
-    function setWorkspace(value: string) {
-      desktopStore.state.workspace.active = value
-    }
-
-    function createWorkspace() {
-      desktopStore.state.workspace.list.push(nanoid(8))
-    }
-
-    /** Last workspace in list excluding the given id (window migration target). */
-    function resolveWorkspaceFallback(workspaceId: string): string | null {
-      const remaining = desktopStore.state.workspace.list.filter(
-        (id) => id !== workspaceId,
-      )
-      return remaining.at(-1) ?? null
-    }
-
-    function removeWorkspace(workspaceId: string): boolean {
-      const list = desktopStore.state.workspace.list
-      if (list.length <= 2) return false
-
-      const index = list.indexOf(workspaceId)
-      if (index === -1) return false
-
-      const fallbackId = resolveWorkspaceFallback(workspaceId)
-      if (!fallbackId) return false
-
-      list.splice(index, 1)
-
-      if (desktopStore.state.workspace.active === workspaceId) {
-        desktopStore.state.workspace.active = fallbackId
-      }
-
-      return true
-    }
-
-    const workspaceActiveIndex = computed(() => {
-      return desktopStore.state.workspace.list.findIndex(
-        (workspace) => workspace === desktopStore.state.workspace.active,
-      )
-    })
-
-    return {
-      active,
-      overview,
-      list,
-      workspaceActiveIndex,
-      setupWorkspaces,
-      resolveActiveWorkspaceId,
-      setOverview,
-      setWorkspace,
-      createWorkspace,
-      resolveWorkspaceFallback,
-      removeWorkspace,
-    }
-  },
-)

package/runtime/stores/storeIds.ts

@@ -1,35 +0,0 @@
-export const DESKTOP_STORE_ID = 'desktop'
-export const DESKTOP_WORKSPACE_STORE_ID = 'desktop/workspace'
-export const DESKTOP_WINDOW_STORE_ID = 'desktop/window'
-export const DESKTOP_VOLUME_STORE_ID = 'desktop/volume'
-export const DESKTOP_DEFAULT_APPS_STORE_ID = 'desktop/defaultApps'
-
-export const applicationWindowsStoreId = (appId: string) =>
-  `desktop/application/${appId}/windows`
-
-export const applicationMetaStoreId = (appId: string) =>
-  `desktop/application/${appId}/meta`
-
-export const STORE_ID_MIGRATION_FLAG = 'desktop/store-id-migration/v1'
-
-/** Static legacy Pinia store ids mapped to their 3.4 replacements. */
-export const LEGACY_STORE_ID_MAP: Record<string, string> = {
-  'owd/desktop': DESKTOP_STORE_ID,
-  'owd/desktop/workspace': DESKTOP_WORKSPACE_STORE_ID,
-  'owd/desktop/window': DESKTOP_WINDOW_STORE_ID,
-  'owd/desktop/volume': DESKTOP_VOLUME_STORE_ID,
-  'owd/desktop/defaultApps': DESKTOP_DEFAULT_APPS_STORE_ID,
-}
-
-export const LEGACY_APPLICATION_STORE_PATTERN =
-  /^owd\/application\/([^/]+)\/(windows|meta)$/
-
-export function legacyApplicationStoreIdToNew(
-  legacyId: string,
-): string | null {
-  const match = legacyId.match(LEGACY_APPLICATION_STORE_PATTERN)
-  if (!match) return null
-
-  const [, appId, kind] = match
-  return `desktop/application/${appId}/${kind}`
-}

package/runtime/types/desktopMenu.ts

@@ -1,10 +0,0 @@
-/** Neutral menu model for window chrome (Menubar-compatible shape). */
-export interface DesktopMenuItem {
-  label?: string
-  icon?: string
-  command?: () => void
-  separator?: boolean
-  disabled?: boolean
-  items?: DesktopMenuItem[]
-  [key: string]: unknown
-}

package/runtime/utils/initDesktopShell.ts

@@ -1,80 +0,0 @@
-import { setActivePinia } from 'pinia'
-import type { Pinia } from 'pinia'
-import { useAppConfig, useRuntimeConfig } from 'nuxt/app'
-import { toRaw } from 'vue'
-import { useDesktopManager } from '../composables/useDesktopManager'
-import { useDesktopStore } from '../stores/storeDesktop'
-import { useDesktopWorkspaceStore } from '../stores/storeDesktopWorkspace'
-import { useDesktopDefaultAppsStore } from '../stores/storeDesktopDefaultApps'
-import { registerDesktopPluginPinia } from '../../kit/defineDesktopApp'
-
-/** Bind Nuxt's Pinia instance for store composables outside component setup timing. */
-export function bindDesktopPinia(pinia: Pinia | undefined) {
-  if (pinia) {
-    setActivePinia(pinia)
-    registerDesktopPluginPinia(pinia)
-  }
-}
-
-/** Sync `appConfig.desktop` from runtime when the composable is not ready yet (early client plugins). */
-export function ensureAppConfigDesktop() {
-  const runtimeConfig = useRuntimeConfig()
-  const publicDesktop = runtimeConfig.public?.desktop
-  if (!publicDesktop || typeof publicDesktop !== 'object') return undefined
-
-  let appConfig: ReturnType<typeof useAppConfig> | undefined
-  try {
-    appConfig = useAppConfig()
-  } catch {
-    return publicDesktop as DesktopConfig
-  }
-
-  if (!appConfig) return publicDesktop as DesktopConfig
-
-  if (!appConfig.desktop) {
-    appConfig.desktop = publicDesktop as DesktopConfig
-  }
-
-  return appConfig.desktop as DesktopConfig
-}
-
-function mergeShellKeysOntoAppConfig() {
-  if (import.meta.server) return
-
-  const desktopManager = useDesktopManager()
-  const desktop = ensureAppConfigDesktop()
-  if (!desktop) return
-
-  desktopManager.setConfig({
-    windows: desktop.windows ? toRaw(desktop.windows) : undefined,
-    systemBar: desktop.systemBar ? toRaw(desktop.systemBar) : undefined,
-    dockBar: desktop.dockBar ? toRaw(desktop.dockBar) : undefined,
-    workspaces: desktop.workspaces ? toRaw(desktop.workspaces) : undefined,
-  })
-}
-
-/** Re-run appConfig shell merge when `useAppConfig()` was not ready during early plugins. */
-export function syncDesktopShellAppConfig() {
-  mergeShellKeysOntoAppConfig()
-}
-
-/** Kernel shell bootstrap: workspaces, default apps, merged shell config on appConfig. */
-export function initDesktopShell() {
-  if (import.meta.server) return
-
-  const desktopStore = useDesktopStore()
-  const desktopWorkspaceStore = useDesktopWorkspaceStore()
-  const runtimeConfig = useRuntimeConfig()
-  const desktopDefaultAppsStore = useDesktopDefaultAppsStore()
-
-  if (desktopStore.$persistedState) {
-    desktopStore.$persistedState.isReady().then(() => {
-      desktopWorkspaceStore.setupWorkspaces()
-    })
-  } else {
-    desktopWorkspaceStore.setupWorkspaces()
-  }
-
-  desktopDefaultAppsStore.loadDefaultAppsFromConfig(runtimeConfig)
-  mergeShellKeysOntoAppConfig()
-}

package/runtime/utils/migratePersistedStoreIds.ts

@@ -1,57 +0,0 @@
-import {
-  LEGACY_STORE_ID_MAP,
-  STORE_ID_MIGRATION_FLAG,
-  legacyApplicationStoreIdToNew,
-} from '../stores/storeIds'
-
-function migrateStorageKey(
-  storage: Storage,
-  legacyId: string,
-  newId: string,
-) {
-  const legacyValue = storage.getItem(legacyId)
-  if (legacyValue === null) return
-
-  if (storage.getItem(newId) !== null) {
-    storage.removeItem(legacyId)
-    return
-  }
-
-  storage.setItem(newId, legacyValue)
-  storage.removeItem(legacyId)
-}
-
-function collectLegacyApplicationKeys(storage: Storage) {
-  const keys: string[] = []
-
-  for (let index = 0; index < storage.length; index++) {
-    const key = storage.key(index)
-    if (key && legacyApplicationStoreIdToNew(key)) {
-      keys.push(key)
-    }
-  }
-
-  return keys
-}
-
-/**
- * One-shot migration of persisted Pinia state from legacy `owd/*` store ids
- * to `desktop/*`. Runs before shell init so module-persistence hydrates new keys.
- */
-export function migratePersistedStoreIds(storage: Storage = localStorage) {
-  if (typeof storage?.getItem !== 'function') return
-  if (storage.getItem(STORE_ID_MIGRATION_FLAG) === 'done') return
-
-  for (const [legacyId, newId] of Object.entries(LEGACY_STORE_ID_MAP)) {
-    migrateStorageKey(storage, legacyId, newId)
-  }
-
-  for (const legacyId of collectLegacyApplicationKeys(storage)) {
-    const newId = legacyApplicationStoreIdToNew(legacyId)
-    if (newId) {
-      migrateStorageKey(storage, legacyId, newId)
-    }
-  }
-
-  storage.setItem(STORE_ID_MIGRATION_FLAG, 'done')
-}

package/runtime/utils/utilApp.ts

@@ -1,25 +0,0 @@
-export function normalizeApplicationConfig(
-  config: ApplicationConfig,
-): ApplicationConfig {
-  const normalizedEntries: Record<string, ApplicationEntry> = {}
-
-  if (config.entries) {
-    for (const [key, entry] of Object.entries(config.entries)) {
-      normalizedEntries[key] = {
-        ...entry,
-        title: entry.title ?? config.title,
-        icon: entry.icon ?? config.icon,
-        category: entry.category ?? config.category,
-        visibility: entry.visibility ?? 'primary',
-      }
-    }
-  }
-
-  return {
-    ...config,
-    version: config.version ?? 'unknown',
-    description: config.description ?? '',
-    category: config.category ?? 'other',
-    entries: normalizedEntries,
-  }
-}

package/runtime/utils/utilCaptureElementToCanvas.ts

@@ -1,21 +0,0 @@
-/**
- * Renders a DOM subtree to a canvas via html2canvas (optional dependency).
- * Used for workspace overview thumbnails; returns null if capture fails or html2canvas is missing.
- */
-export async function captureElementToCanvas(
-  element: HTMLElement | null | undefined,
-  options?: Record<string, unknown>,
-): Promise<HTMLCanvasElement | null> {
-  if (!element || typeof window === 'undefined') {
-    return null
-  }
-  try {
-    const { default: html2canvas } = await import('html2canvas')
-    return await html2canvas(element, {
-      allowTaint: true,
-      ...(options as object),
-    })
-  } catch {
-    return null
-  }
-}

package/runtime/utils/utilCommon.ts

@@ -1,26 +0,0 @@
-export function deepClone<T>(obj: T): T {
-  return JSON.parse(JSON.stringify(obj))
-}
-
-export function deepEqual(obj1: any, obj2: any) {
-  const keys1 = Object.keys(obj1)
-  const keys2 = Object.keys(obj2)
-  if (keys1.length !== keys2.length) {
-    return false
-  }
-  for (const key of keys1) {
-    if (!obj2.hasOwnProperty(key)) {
-      return false
-    }
-    if (typeof obj1[key] === 'object' && typeof obj2[key] === 'object') {
-      if (!deepEqual(obj1[key], obj2[key])) {
-        return false
-      }
-    } else {
-      if (obj1[key] !== obj2[key]) {
-        return false
-      }
-    }
-  }
-  return true
-}

package/runtime/utils/utilDebug.ts

@@ -1,30 +0,0 @@
-export function isDebugMode() {
-  return import.meta.env.MODE === 'development'
-}
-
-export function debugLog(...messages: any[]) {
-  if (!isDebugMode()) {
-    return false
-  }
-
-  console.log('[OWD]', ...messages)
-  return true
-}
-
-export function debugWarn(...messages: any[]) {
-  if (!isDebugMode()) {
-    return false
-  }
-
-  console.warn('[OWD]', ...messages)
-  return true
-}
-
-export function debugError(...messages: any[]) {
-  if (!isDebugMode()) {
-    return false
-  }
-
-  console.error('[OWD]', ...messages)
-  return true
-}

package/runtime/utils/utilDetectSnapZone.ts

@@ -1,57 +0,0 @@
-import type { DesktopWorkAreaRect, WindowLayout } from '@owdproject/core'
-import {
-  WINDOW_SNAP_EDGE_PX,
-  WORKSPACE_EDGE_DROP_PX,
-} from '../constants/shellLayout'
-import { workAreaBottom, workAreaRight } from './utilWindowLayout'
-
-export type SnapZoneHint = Exclude<WindowLayout, 'normal'>
-
-export type DetectSnapZoneOptions = {
-  edgePx?: number
-  /** When true, left/right half snap is suppressed in the outer workspace-edge band. */
-  deferSideSnapForWorkspaceEdge?: boolean
-}
-
-/**
- * Resolve snap zone from pointer position and shell work area.
- * Returns null when the pointer is not in a snap band.
- */
-export function detectSnapZone(
-  clientX: number,
-  clientY: number,
-  workArea: DesktopWorkAreaRect,
-  options?: DetectSnapZoneOptions,
-): SnapZoneHint | null {
-  const edge = options?.edgePx ?? WINDOW_SNAP_EDGE_PX
-  const { x, y, width, height } = workArea
-
-  if (width <= 0 || height <= 0) {
-    return null
-  }
-
-  const bottom = workAreaBottom(workArea)
-  const right = workAreaRight(workArea)
-
-  const nearTop = clientY <= y + edge
-  const nearBottom = clientY >= bottom - edge
-  const nearLeft = clientX <= x + edge
-  const nearRight = clientX >= right - edge
-
-  const inWorkspaceEdgeBand =
-    options?.deferSideSnapForWorkspaceEdge === true &&
-    typeof globalThis !== 'undefined' &&
-    (clientX <= WORKSPACE_EDGE_DROP_PX ||
-      clientX >= globalThis.innerWidth - WORKSPACE_EDGE_DROP_PX)
-
-  if (nearTop && nearLeft) return 'top-left'
-  if (nearTop && nearRight) return 'top-right'
-  if (nearBottom && nearLeft) return 'bottom-left'
-  if (nearBottom && nearRight) return 'bottom-right'
-  if (nearTop) return 'maximize'
-  if (nearBottom) return 'bottom-half'
-  if (nearLeft && !inWorkspaceEdgeBand) return 'left-half'
-  if (nearRight && !inWorkspaceEdgeBand) return 'right-half'
-
-  return null
-}

package/runtime/utils/utilTerminal.ts

@@ -1,6 +0,0 @@
-export function shellEscape(str: string): string {
-  if (str === '') {
-    return "''";
-  }
-  return `${str.replace(/'/g, `'\\''`)}`;
-}

package/runtime/utils/utilWindowControllerAdapter.ts

@@ -1,15 +0,0 @@
-// support for controller-less windows
-// (for example: dummy windows in docs)
-export function handleWindowControllerProps(windowController: any) {
-  if (windowController.instanced) {
-    return windowController
-  }
-
-  return {
-    ...windowController,
-    ...windowController.config,
-    state: {
-      ...windowController.config,
-    },
-  }
-}