@dopame/acde-linux-x64 0.0.0-stage → 0.0.10

package/lib/acde-api/src/modules/app-modules.d.ts

@@ -0,0 +1,81 @@
+declare module 'acde:fs' {
+  const fs: import('../types/page').AcdeFs
+  export { fs, fs as default }
+}
+declare module 'acde:office' {
+  const office: import('../types/page').AcdeOffice
+  export { office, office as default }
+}
+declare module 'acde:terminal' {
+  const terminal: import('../types/page').AcdeTerminals
+  export { terminal, terminal as default }
+}
+declare module 'acde:power' {
+  const power: import('../types/page').AcdePower
+  export { power, power as default }
+}
+declare module 'acde:input' {
+  const input: import('../types/page').AcdeInput
+  export { input, input as default }
+}
+declare module 'acde:display' {
+  const display: import('../types/page').AcdeDisplay
+  export { display, display as default }
+}
+
+declare module 'acde:devices' {
+  const devices: import('../types/page').AcdeDevices
+  export { devices, devices as default }
+}
+
+declare module 'acde:audio' {
+  const audio: import('../types/page').AcdeAudio
+  export { audio, audio as default }
+}
+
+declare module 'acde:bluetooth' {
+  const bluetooth: import('../types/page').AcdeBluetooth
+  export { bluetooth, bluetooth as default }
+}
+
+declare module 'acde:system' {
+  const system: import('../types/page').AcdeSystem
+  export { system, system as default }
+}
+
+declare module 'acde:network' {
+  const network: import('../types/page').AcdeNetwork
+  export { network, network as default }
+}
+declare module 'acde:launch' {
+  const launch: import('../types/page').AcdeLaunch
+  export { launch, launch as default }
+}
+declare module 'acde:apps' {
+  const apps: import('../types/page').AcdeAppList
+  export { apps, apps as default }
+}
+declare module 'acde:open' {
+  const open: import('../types/page').AcdeOpen
+  export { open, open as default }
+}
+declare module 'acde:openPath' {
+  const openPath: import('../types/page').AcdeOpenFiles['openPath']
+  export { openPath, openPath as default }
+}
+declare module 'acde:handlers' {
+  const handlers: import('../types/page').AcdeOpenFiles['handlers']
+  export { handlers, handlers as default }
+}
+declare module 'acde:window' {
+  const self: import('../types/page').AcdeWindow
+  export { self as window, self as default }
+}
+declare module 'acde:capabilities' {
+  const capabilities: import('../types/capabilities').AcdeCapabilities
+  export { capabilities, capabilities as default }
+}
+declare module 'acde:*' {
+  const service: unknown
+  export default service
+}

package/lib/acde-api/src/modules/modules.d.ts

@@ -0,0 +1,113 @@
+declare module 'acde:fs' {
+  const fs: import('@dopame/acde-api').AcdeModules['fs']
+  export { fs, fs as default }
+}
+declare module 'acde:office' {
+  const office: import('@dopame/acde-api').AcdeModules['office']
+  export { office, office as default }
+}
+declare module 'acde:terminal' {
+  const terminal: import('@dopame/acde-api').AcdeModules['terminal']
+  export { terminal, terminal as default }
+}
+declare module 'acde:power' {
+  const power: import('@dopame/acde-api').AcdeModules['power']
+  export { power, power as default }
+}
+declare module 'acde:input' {
+  const input: import('@dopame/acde-api').AcdeModules['input']
+  export { input, input as default }
+}
+declare module 'acde:display' {
+  const display: import('@dopame/acde-api').AcdeModules['display']
+  export { display, display as default }
+}
+
+declare module 'acde:devices' {
+  const devices: import('@dopame/acde-api').AcdeModules['devices']
+  export { devices, devices as default }
+}
+
+declare module 'acde:audio' {
+  const audio: import('@dopame/acde-api').AcdeModules['audio']
+  export { audio, audio as default }
+}
+
+declare module 'acde:bluetooth' {
+  const bluetooth: import('@dopame/acde-api').AcdeModules['bluetooth']
+  export { bluetooth, bluetooth as default }
+}
+
+declare module 'acde:system' {
+  const system: import('@dopame/acde-api').AcdeModules['system']
+  export { system, system as default }
+}
+
+declare module 'acde:network' {
+  const network: import('@dopame/acde-api').AcdeModules['network']
+  export { network, network as default }
+}
+declare module 'acde:windows' {
+  const windows: import('@dopame/acde-api').AcdeModules['windows']
+  export { windows, windows as default }
+}
+declare module 'acde:launch' {
+  const launch: import('@dopame/acde-api').AcdeModules['launch']
+  export { launch, launch as default }
+}
+declare module 'acde:packages' {
+  const packages: import('@dopame/acde-api').AcdeModules['packages']
+  export { packages, packages as default }
+}
+declare module 'acde:apps' {
+  const apps: import('@dopame/acde-api').AcdeModules['apps']
+  export { apps, apps as default }
+}
+declare module 'acde:desktop' {
+  const desktop: import('@dopame/acde-api').AcdeModules['desktop']
+  export { desktop, desktop as default }
+}
+declare module 'acde:desktops' {
+  const desktops: import('@dopame/acde-api').AcdeModules['desktops']
+  export { desktops, desktops as default }
+}
+declare module 'acde:session' {
+  const session: import('@dopame/acde-api').AcdeModules['session']
+  export { session, session as default }
+}
+declare module 'acde:inspect' {
+  const inspect: import('@dopame/acde-api').AcdeModules['inspect']
+  export { inspect, inspect as default }
+}
+declare module 'acde:open' {
+  const open: import('@dopame/acde-api').AcdeModules['open']
+  export { open, open as default }
+}
+declare module 'acde:openPath' {
+  const openPath: import('@dopame/acde-api').AcdeModules['openPath']
+  export { openPath, openPath as default }
+}
+declare module 'acde:handlers' {
+  const handlers: import('@dopame/acde-api').AcdeModules['handlers']
+  export { handlers, handlers as default }
+}
+declare module 'acde:permissions' {
+  const permissions: import('@dopame/acde-api').AcdeModules['permissions']
+  export { permissions, permissions as default }
+}
+declare module 'acde:setDefault' {
+  const setDefault: import('@dopame/acde-api').AcdeModules['setDefault']
+  export { setDefault, setDefault as default }
+}
+declare module 'acde:window' {
+  const self: import('@dopame/acde-api').AcdeModules['window']
+  export { self as window, self as default }
+}
+declare module 'acde:capabilities' {
+  const capabilities: import('@dopame/acde-api').AcdeModules['capabilities']
+  export { capabilities, capabilities as default }
+}
+declare module 'acde:*' {
+  const service: unknown
+  export default service
+}

package/lib/acde-api/src/modules/shell-modules.d.ts

@@ -0,0 +1,32 @@
+declare module 'acde:windows' {
+  const windows: import('../types/page').AcdeWindows
+  export { windows, windows as default }
+}
+declare module 'acde:packages' {
+  const packages: import('../types/page').AcdePackages
+  export { packages, packages as default }
+}
+declare module 'acde:session' {
+  const session: import('../types/page').AcdeSession
+  export { session, session as default }
+}
+declare module 'acde:desktops' {
+  const desktops: import('../types/page').AcdeDesktops
+  export { desktops, desktops as default }
+}
+declare module 'acde:inspect' {
+  const inspect: import('../types/page').AcdeInspect
+  export { inspect, inspect as default }
+}
+declare module 'acde:desktop' {
+  const desktop: import('../types/page').AcdeDesktop
+  export { desktop, desktop as default }
+}
+declare module 'acde:permissions' {
+  const permissions: import('../types/permissions').AcdePermissions
+  export { permissions, permissions as default }
+}
+declare module 'acde:setDefault' {
+  const setDefault: import('../types/page').AcdeOpenFiles['setDefault']
+  export { setDefault, setDefault as default }
+}

package/lib/acde-api/src/runtime/level.d.ts

@@ -0,0 +1 @@
+export declare const API_LEVEL: 1

package/lib/acde-api/src/runtime/level.js

@@ -0,0 +1 @@
+const o=1;export{o as API_LEVEL};

package/lib/acde-api/src/runtime/load.d.ts

@@ -0,0 +1,8 @@
+import type { AcdePage } from '../types/page'
+
+export type AcdeModules = {
+  readonly [K in keyof AcdePage as string extends K ? never : number extends K ? never : K]-?: NonNullable<AcdePage[K]>
+}
+
+export function load<K extends keyof AcdeModules>(name: K): Promise<AcdeModules[K] | null>
+export function load(name: string): Promise<unknown>

package/lib/acde-api/src/runtime/load.js

@@ -0,0 +1 @@
+function i(e){return import(`acde:${e}`).then(n=>n.default??null,()=>null)}export{i as load};

package/lib/acde-api/src/runtime/places.d.ts

@@ -0,0 +1,3 @@
+export declare const SHARED_PLACES: readonly ['desktop', 'documents', 'downloads', 'music', 'pictures', 'videos']
+export type SharedPlace = (typeof SHARED_PLACES)[number]
+export type PlaceCapability = `fs.${SharedPlace}`

package/lib/acde-api/src/runtime/places.js

@@ -0,0 +1 @@
+const e=Object.freeze(["desktop","documents","downloads","music","pictures","videos"]);export{e as SHARED_PLACES};

package/lib/acde-api/src/runtime/platforms.d.ts

@@ -0,0 +1,5 @@
+import type { Platform, PlatformSupport, RunningMode } from '../types/capabilities'
+
+export declare const RUNNING_MODES: readonly RunningMode[]
+export declare const PLATFORM_SUPPORT: Readonly<Record<Platform, Partial<Readonly<Record<RunningMode, PlatformSupport>>>>>
+export declare function platformSupport(platform: string, mode: RunningMode): PlatformSupport | null

package/lib/acde-api/src/runtime/platforms.js

@@ -0,0 +1 @@
+const n=["slots"],t=["network","system","bluetooth","audio","devices","power","input","display","idleDetection","office","camera","microphone",...n],e=["network","system","bluetooth","audio","devices","power","input","display","idleDetection","office",...n],o={backdrop:"full"},i=["session","desktop","standalone"],p={linux:{session:{unsupported:[],window:o},desktop:{unsupported:n,window:o},standalone:{unsupported:n,window:o}},win32:{desktop:{unsupported:t,window:o},standalone:{unsupported:[...t,"notifications"],window:o}},darwin:{desktop:{unsupported:e,window:o},standalone:{unsupported:e,window:o}}};function u(s,d){return p[s]?.[d]??null}export{p as PLATFORM_SUPPORT,i as RUNNING_MODES,u as platformSupport};

package/lib/acde-api/src/shell.d.ts

@@ -0,0 +1,14 @@
+/// <reference path="./modules/app-modules.d.ts" />
+/// <reference path="./modules/shell-modules.d.ts" />
+import type * as Page from './types/page'
+import type { AppModules } from './app'
+
+export type * from './app'
+export { API_LEVEL } from './runtime/level'
+export { PLATFORM_SUPPORT, RUNNING_MODES, platformSupport } from './runtime/platforms'
+export { SHARED_PLACES, type PlaceCapability, type SharedPlace } from './runtime/places'
+
+export interface ShellModules extends AppModules, Page.ShellModuleTypes {}
+
+export function load<K extends keyof ShellModules>(name: K): Promise<ShellModules[K] | null>
+export function load(name: string): Promise<unknown>

package/lib/acde-api/src/types/capabilities.d.ts

@@ -0,0 +1,34 @@
+export type Platform = 'linux' | 'win32' | 'darwin'
+
+export type RunningMode = 'session' | 'desktop' | 'standalone'
+
+export type FeatureSupport = 'full' | 'approximated' | 'unsupported'
+
+export interface WindowFeatures {
+  readonly backdrop: FeatureSupport
+}
+
+export interface PlatformSupport {
+  readonly unsupported: readonly string[]
+  readonly window: WindowFeatures
+}
+
+export type CapabilityState = 'available' | 'not-asked' | 'asking' | 'denied' | 'not-declared' | 'unsupported' | 'service-not-running' | 'shell-only'
+
+export interface CapabilityStatus {
+  readonly name: string
+  readonly kind: 'system' | 'service'
+  readonly state: CapabilityState
+  readonly reason: string
+  readonly optional: boolean
+}
+
+export interface AcdeCapabilities {
+  readonly level: number
+  readonly platform: Platform
+  readonly mode: RunningMode
+  readonly window: WindowFeatures
+  get(name: string): CapabilityStatus
+  list(): CapabilityStatus[]
+  request(name: string): Promise<CapabilityStatus>
+}

package/lib/acde-api/src/types/config.d.ts

@@ -0,0 +1,55 @@
+import type { Capabilities, IconName, ShellModule } from './manifest'
+
+export type AcdeConfig = AppConfig | DesktopConfig
+
+export interface ConfigCommon {
+  readonly $schema?: string
+  readonly name?: string
+  readonly version?: string
+  readonly apiLevel?: number
+  readonly public?: string
+}
+
+export interface WindowAppConfig {
+  readonly id?: string
+  readonly label?: string
+  readonly icon?: IconName | (string & {})
+  readonly entry?: string
+  readonly capabilities?: Capabilities
+  readonly optional?: readonly string[]
+  readonly services?: readonly string[]
+  readonly heapMb?: number
+  readonly size?: readonly [number, number]
+  readonly multiple?: boolean
+  readonly frame?: boolean
+  readonly mimeTypes?: readonly string[]
+  readonly backend?: false | BackendConfig
+}
+
+export interface BackendConfig {
+  readonly entry?: string
+  readonly port?: number
+}
+
+export interface ServiceConfig {
+  readonly module: string
+  readonly modules?: readonly ShellModule[]
+}
+
+export type Framework = 'auto' | 'none' | 'next' | 'nuxt' | 'sveltekit' | 'astro' | 'react-router' | 'remix' | 'angular' | 'vite' | 'cra' | 'script'
+
+export interface AppConfig extends ConfigCommon, WindowAppConfig {
+  readonly type: 'app'
+  readonly framework?: Framework
+}
+
+export interface DesktopConfig extends ConfigCommon {
+  readonly type: 'desktop'
+  readonly id?: string
+  readonly label?: string
+  readonly description?: string
+  readonly entry?: string
+  readonly heapMb?: number
+  readonly services?: Readonly<Record<string, string | ServiceConfig>>
+  readonly apps?: readonly (WindowAppConfig & { readonly id: string; readonly entry: string })[]
+}

package/lib/acde-api/src/types/events.d.ts

@@ -0,0 +1,151 @@
+import type { DesktopApp, WindowState } from './page'
+
+interface WindowsEventOf<T extends string> {
+  readonly type: T
+  readonly window: number
+}
+
+export interface WindowOpenEvent extends WindowsEventOf<'windowopen'> {
+  readonly appId?: string | null
+  readonly title?: string | null
+  readonly web?: true
+  readonly icon?: string
+}
+
+export interface WindowTitleEvent extends WindowsEventOf<'windowtitle'> {
+  readonly appId?: string | null
+  readonly title?: string | null
+}
+
+export interface WindowsStateEvent extends WindowsEventOf<'windowstate'> {
+  readonly state: WindowState
+  readonly previous: WindowState
+}
+
+export interface WindowMinSizeEvent extends WindowsEventOf<'windowminsize'> {
+  readonly width: number
+  readonly height: number
+}
+
+export interface WindowParentEvent extends WindowsEventOf<'windowparent'> {
+  readonly parent?: number
+}
+
+export interface WindowMenuItem {
+  readonly id: string
+  readonly label: string
+  readonly shortcut?: string
+  readonly checked?: boolean
+  readonly disabled?: boolean
+  readonly action: boolean
+}
+
+export interface WindowMenu {
+  readonly id: string
+  readonly label: string
+  readonly items: readonly ({ readonly type: 'separator' } | WindowMenuItem)[]
+}
+
+export interface WindowMenusEvent extends WindowsEventOf<'windowmenus'> {
+  readonly menus: readonly WindowMenu[]
+}
+
+export interface WindowCrashEvent extends WindowsEventOf<'windowcrash'> {
+  readonly reason: string
+}
+
+export interface WindowsEventMap {
+  readonly open: WindowOpenEvent
+  readonly close: WindowsEventOf<'windowclose'>
+  readonly title: WindowTitleEvent
+  readonly state: WindowsStateEvent
+  readonly activate: WindowsEventOf<'windowactivate'>
+  readonly minsize: WindowMinSizeEvent
+  readonly parent: WindowParentEvent
+  readonly menus: WindowMenusEvent
+  readonly crash: WindowCrashEvent
+  readonly hang: WindowsEventOf<'windowhang'>
+  readonly responsive: WindowsEventOf<'windowresponsive'>
+  readonly attention: WindowsEventOf<'windowattention'>
+  readonly ready: WindowsEventOf<'windowready'>
+  readonly show: WindowsEventOf<'windowshow'>
+  readonly animated: WindowsEventOf<'windowanimated'>
+}
+
+export type WindowsEventType = keyof WindowsEventMap
+
+export type WindowsEvent = WindowsEventMap[WindowsEventType]
+
+export interface WindowsEvents {
+  on<K extends WindowsEventType>(type: K, handler: (event: WindowsEventMap[K]) => void): () => boolean
+}
+
+export interface AppsChangedEvent {
+  readonly type: 'appschanged'
+  readonly apps: readonly DesktopApp[]
+}
+
+export interface NotificationEvent {
+  readonly type: 'notification'
+  readonly window: number
+  readonly app: string | null
+  readonly label: string | null
+  readonly title: string
+  readonly body: string
+  readonly icon: string
+  readonly tag: string
+}
+
+export interface DownloadEvent {
+  readonly type: 'download'
+  readonly window: number
+  readonly app: string | null
+  readonly path: string
+  readonly name: string
+  readonly size: number
+}
+
+export type ScreenshotEvent =
+  | { readonly type: 'screenshot'; readonly path: string; readonly width: number; readonly height: number }
+  | { readonly type: 'screenshot'; readonly path: string; readonly error: string }
+
+export type ShortcutScope = 'session' | 'desktop' | 'app'
+
+export interface ShortcutEvent {
+  readonly type: 'shortcut'
+  readonly window: number
+  readonly key: string
+  readonly title: ShortcutScope
+}
+
+export type ScreenEdge = 'top' | 'right' | 'bottom' | 'left'
+
+export interface ScreenEdgeEvent {
+  readonly type: 'screenedge'
+  readonly edge: ScreenEdge
+  readonly entered: boolean
+  readonly output: string
+}
+
+export interface DesktopEventMap {
+  readonly download: DownloadEvent
+  readonly edge: ScreenEdgeEvent
+  readonly notification: NotificationEvent
+  readonly screenshot: ScreenshotEvent
+  readonly shortcut: ShortcutEvent
+}
+
+export type TerminalEvent =
+  | { readonly type: 'output'; readonly data: string }
+  | { readonly type: 'cwd'; readonly path: string }
+  | { readonly type: 'exit'; readonly code: number | null; readonly signal: number | null }
+
+export interface WindowGrabEvent {
+  readonly kind: 'pointer' | 'keyboard'
+  readonly granted: boolean
+}
+
+export interface WindowGrabLostEvent {
+  readonly kind: 'lost'
+  readonly reason: 'esc' | 'other_window' | 'focus_lost' | 'denied'
+}

package/lib/acde-api/src/types/manifest.d.ts

@@ -0,0 +1,83 @@
+import type { SharedPlace } from '../runtime/places'
+import type { IconName, ShellModule } from '../validate'
+
+export type { IconName, ShellModule }
+
+export interface PackageManifest {
+  readonly apiLevel?: number
+  readonly desktops?: readonly DesktopManifest[]
+  readonly apps?: readonly AppManifest[]
+  readonly assets?: Readonly<Record<string, readonly string[]>>
+  readonly services?: readonly ServiceManifest[]
+}
+
+export interface DesktopManifest {
+  readonly id: string
+  readonly name: string
+  readonly description?: string
+  readonly entry: string
+  readonly services?: readonly (string | DesktopService)[]
+  readonly heapMb?: number
+}
+
+export interface DesktopService {
+  readonly name: string
+  readonly modules?: readonly ShellModule[]
+}
+
+export interface AppManifest {
+  readonly id: string
+  readonly label: string
+  readonly icon: IconName | (string & {})
+  readonly entry: string
+  readonly capabilities?: Capabilities
+  readonly heapMb?: number
+  readonly size?: readonly [number, number]
+  readonly multiple?: boolean
+  readonly frame?: boolean
+  readonly mimeTypes?: readonly string[]
+  readonly schemes?: readonly string[]
+  readonly requests?: readonly string[]
+  readonly backend?: AppBackend
+  readonly optional?: readonly string[]
+  readonly services?: readonly string[]
+}
+
+export interface AppBackend {
+  readonly entry: string
+  readonly port?: number
+}
+
+export interface Capabilities {
+  readonly fs?: boolean | { readonly roots: readonly SharedPlace[] }
+  readonly terminal?: boolean
+  readonly network?: boolean
+  readonly system?: boolean
+  readonly bluetooth?: boolean
+  readonly audio?: boolean
+  readonly devices?: boolean
+  readonly power?: boolean
+  readonly input?: boolean
+  readonly display?: boolean
+  readonly idleDetection?: boolean
+  readonly office?: boolean
+  readonly launch?: boolean
+  readonly slots?: boolean
+  readonly open?: boolean | readonly string[]
+  readonly openFiles?: boolean
+  readonly windows?: boolean
+  readonly packages?: boolean
+  readonly session?: boolean
+  readonly desktops?: boolean
+  readonly inspect?: boolean
+  readonly desktop?: boolean
+  readonly setDefault?: boolean
+  readonly camera?: boolean
+  readonly microphone?: boolean
+  readonly [service: string]: unknown
+}
+
+export interface ServiceManifest {
+  readonly name: string
+  readonly module: string
+}