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

package/lib/acde-api/config.schema.json

@@ -0,0 +1,563 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/dopame-org/acdert/web/packages/acde-api/config.schema.json",
+  "title": "acde.config.jsonc",
+  "description": "acde 工程的配置: 一个窗口应用 (type app) 或一个桌面 (type desktop); acde build 把它变成包的 package.json 清单",
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "$schema": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string",
+          "description": "包名, 默认 package.json 的 name"
+        },
+        "version": {
+          "type": "string"
+        },
+        "apiLevel": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "契约级别 (SDK 的 API_LEVEL); 不写时 acde build 写入当前级别"
+        },
+        "public": {
+          "type": "string",
+          "description": "原样复制的静态文件目录, 默认 public"
+        },
+        "type": {
+          "const": "app"
+        },
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-]*$"
+        },
+        "label": {
+          "type": "string"
+        },
+        "icon": {
+          "$ref": "#/$defs/icon"
+        },
+        "entry": {
+          "type": "string",
+          "description": "HTML 页面 (默认 index.html) 或默认导出 WindowApp 的模块; 认出框架时不用"
+        },
+        "framework": {
+          "type": "string",
+          "enum": [
+            "auto",
+            "none",
+            "next",
+            "nuxt",
+            "sveltekit",
+            "astro",
+            "react-router",
+            "remix",
+            "angular",
+            "vite",
+            "cra",
+            "script"
+          ],
+          "description": "怎么构建: auto (默认) 按依赖认框架 (Next.js、Nuxt、SvelteKit、Astro、React Router、Remix、Angular、Vite、Create React App, 或 package.json 的 build 脚本) 并用它自己的构建; none 用 acde 自己的打包 (Bun.build, entry 是 HTML 或模块)"
+        },
+        "capabilities": {
+          "type": "object",
+          "properties": {
+            "fs": {
+              "oneOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "roots": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "required": [
+                    "roots"
+                  ]
+                }
+              ]
+            },
+            "terminal": {
+              "type": "boolean"
+            },
+            "office": {
+              "type": "boolean"
+            },
+            "launch": {
+              "type": "boolean"
+            },
+            "slots": {
+              "type": "boolean"
+            },
+            "open": {
+              "oneOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ]
+            },
+            "openFiles": {
+              "type": "boolean"
+            },
+            "session": {
+              "type": "boolean",
+              "description": "acde:session (注销, 语言 …; 外壳模块, 只给系统应用)"
+            },
+            "desktops": {
+              "type": "boolean",
+              "description": "acde:desktops (列出 / 切换桌面; 外壳模块, 只给系统应用)"
+            },
+            "windows": {
+              "type": "boolean",
+              "description": "acde:windows (所有窗口: 列出、聚焦、隐藏、动画; 外壳模块, 只给系统应用)"
+            },
+            "packages": {
+              "type": "boolean",
+              "description": "acde:packages (刷新、安装包, 列出和运行原生程序; 外壳模块, 只给系统应用)"
+            },
+            "inspect": {
+              "type": "boolean",
+              "description": "acde:inspect (看和操作桌面; 外壳模块, 只给系统应用)"
+            },
+            "desktop": {
+              "type": "boolean",
+              "description": "acde:desktop (桌面事件和钉住的面板; 外壳模块, 只给系统应用)"
+            },
+            "setDefault": {
+              "type": "boolean",
+              "description": "acde:setDefault (设默认应用; 外壳模块, 只给系统应用)"
+            },
+            "camera": {
+              "type": "boolean",
+              "description": "navigator.mediaDevices.getUserMedia 的摄像头 (还要系统同意: macOS 隐私设置)"
+            },
+            "microphone": {
+              "type": "boolean",
+              "description": "navigator.mediaDevices.getUserMedia 的麦克风 (还要系统同意: macOS 隐私设置)"
+            }
+          },
+          "additionalProperties": true,
+          "description": "acde 的能力; 别的键是桌面服务的名字"
+        },
+        "optional": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "capabilities 里可以缺的几项 (每项也要写在 capabilities 里); 其余都是必需的, 缺了应用不进列表、启动时被拒"
+        },
+        "services": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "用到的桌面服务名 (照旧 import acde:<名字>); 不能用系统模块的名字"
+        },
+        "heapMb": {
+          "type": "number",
+          "minimum": 32
+        },
+        "size": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "minItems": 2,
+          "maxItems": 2,
+          "description": "窗口页面的初始尺寸 [宽, 高], 逻辑像素, 不含窗框; 默认 800x600. 单应用模式 (acdert app) 里是宿主窗口内容区的初始尺寸 (不超出工作区)"
+        },
+        "multiple": {
+          "type": "boolean"
+        },
+        "frame": {
+          "type": "boolean"
+        },
+        "mimeTypes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "schemes": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9+.-]*$"
+          }
+        },
+        "requests": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]*$"
+          }
+        },
+        "backend": {
+          "oneOf": [
+            {
+              "const": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "entry": {
+                  "type": "string"
+                },
+                "port": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 65535
+                }
+              },
+              "additionalProperties": false
+            }
+          ],
+          "description": "false: 没有后端; 默认找 server.ts 等"
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "properties": {
+        "$schema": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string",
+          "description": "包名, 默认 package.json 的 name"
+        },
+        "version": {
+          "type": "string"
+        },
+        "apiLevel": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "契约级别 (SDK 的 API_LEVEL); 不写时 acde build 写入当前级别"
+        },
+        "public": {
+          "type": "string",
+          "description": "原样复制的静态文件目录, 默认 public"
+        },
+        "type": {
+          "const": "desktop"
+        },
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-]*$"
+        },
+        "label": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "entry": {
+          "type": "string",
+          "description": "桌面页面, 默认 index.html"
+        },
+        "heapMb": {
+          "type": "number",
+          "minimum": 32
+        },
+        "services": {
+          "type": "object",
+          "additionalProperties": {
+            "oneOf": [
+              {
+                "type": "string",
+                "description": "服务的模块文件"
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "module": {
+                    "type": "string",
+                    "description": "服务的模块文件"
+                  },
+                  "modules": {
+                    "type": "array",
+                    "items": {
+                      "enum": [
+                        "windows",
+                        "packages",
+                        "session",
+                        "desktops",
+                        "inspect",
+                        "desktop",
+                        "setDefault",
+                        "permissions"
+                      ]
+                    },
+                    "description": "这个服务能用的外壳模块, 服务里 ctx.import('acde:<名字>') 拿到; acde build 写进桌面清单的 {name, modules}"
+                  }
+                },
+                "required": [
+                  "module"
+                ],
+                "additionalProperties": false
+              }
+            ]
+          },
+          "description": "服务名 → 模块文件, 或 {module, modules} (再列出它能用的外壳模块)"
+        },
+        "apps": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "pattern": "^[a-z0-9][a-z0-9-]*$"
+              },
+              "label": {
+                "type": "string"
+              },
+              "icon": {
+                "$ref": "#/$defs/icon"
+              },
+              "entry": {
+                "type": "string",
+                "description": "HTML 页面 (默认 index.html) 或默认导出 WindowApp 的模块"
+              },
+              "capabilities": {
+                "type": "object",
+                "properties": {
+                  "fs": {
+                    "oneOf": [
+                      {
+                        "type": "boolean"
+                      },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "roots": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          }
+                        },
+                        "required": [
+                          "roots"
+                        ]
+                      }
+                    ]
+                  },
+                  "terminal": {
+                    "type": "boolean"
+                  },
+                  "office": {
+                    "type": "boolean"
+                  },
+                  "launch": {
+                    "type": "boolean"
+                  },
+                  "slots": {
+                    "type": "boolean"
+                  },
+                  "open": {
+                    "oneOf": [
+                      {
+                        "type": "boolean"
+                      },
+                      {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
+                    ]
+                  },
+                  "openFiles": {
+                    "type": "boolean"
+                  },
+                  "session": {
+                    "type": "boolean",
+                    "description": "acde:session (注销, 语言 …; 外壳模块, 只给系统应用)"
+                  },
+                  "desktops": {
+                    "type": "boolean",
+                    "description": "acde:desktops (列出 / 切换桌面; 外壳模块, 只给系统应用)"
+                  },
+                  "windows": {
+                    "type": "boolean",
+                    "description": "acde:windows (所有窗口: 列出、聚焦、隐藏、动画; 外壳模块, 只给系统应用)"
+                  },
+                  "packages": {
+                    "type": "boolean",
+                    "description": "acde:packages (刷新、安装包, 列出和运行原生程序; 外壳模块, 只给系统应用)"
+                  },
+                  "inspect": {
+                    "type": "boolean",
+                    "description": "acde:inspect (看和操作桌面; 外壳模块, 只给系统应用)"
+                  },
+                  "desktop": {
+                    "type": "boolean",
+                    "description": "acde:desktop (桌面事件和钉住的面板; 外壳模块, 只给系统应用)"
+                  },
+                  "setDefault": {
+                    "type": "boolean",
+                    "description": "acde:setDefault (设默认应用; 外壳模块, 只给系统应用)"
+                  },
+                  "camera": {
+                    "type": "boolean",
+                    "description": "navigator.mediaDevices.getUserMedia 的摄像头 (还要系统同意: macOS 隐私设置)"
+                  },
+                  "microphone": {
+                    "type": "boolean",
+                    "description": "navigator.mediaDevices.getUserMedia 的麦克风 (还要系统同意: macOS 隐私设置)"
+                  }
+                },
+                "additionalProperties": true,
+                "description": "acde 的能力; 别的键是桌面服务的名字"
+              },
+              "optional": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "capabilities 里可以缺的几项 (每项也要写在 capabilities 里); 其余都是必需的, 缺了应用不进列表、启动时被拒"
+              },
+              "services": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "用到的桌面服务名 (照旧 import acde:<名字>); 不能用系统模块的名字"
+              },
+              "heapMb": {
+                "type": "number",
+                "minimum": 32
+              },
+              "size": {
+                "type": "array",
+                "items": {
+                  "type": "integer",
+                  "minimum": 1
+                },
+                "minItems": 2,
+                "maxItems": 2,
+                "description": "窗口页面的初始尺寸 [宽, 高], 逻辑像素, 不含窗框; 默认 800x600. 单应用模式 (acdert app) 里是宿主窗口内容区的初始尺寸 (不超出工作区)"
+              },
+              "multiple": {
+                "type": "boolean"
+              },
+              "frame": {
+                "type": "boolean"
+              },
+              "mimeTypes": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "schemes": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "pattern": "^[a-z][a-z0-9+.-]*$"
+                }
+              },
+              "requests": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "pattern": "^[a-z][a-z0-9-]*$"
+                }
+              },
+              "backend": {
+                "oneOf": [
+                  {
+                    "const": false
+                  },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "entry": {
+                        "type": "string"
+                      },
+                      "port": {
+                        "type": "integer",
+                        "minimum": 0,
+                        "maximum": 65535
+                      }
+                    },
+                    "additionalProperties": false
+                  }
+                ],
+                "description": "false: 没有后端; 默认找 server.ts 等"
+              }
+            },
+            "required": [
+              "id",
+              "entry"
+            ],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "additionalProperties": false
+    }
+  ],
+  "$defs": {
+    "icon": {
+      "type": "string",
+      "minLength": 1,
+      "description": "图标: Dopame 的图标名 (@dopame/acde-api/manifest 的 ICON_NAMES 之一: files, browser, editor, office, term, projects, dash, team, dopa, settings, store, app, timer, cards, list, chart, calc, music, video, photo, paint, game, chat, mail, calendar, code, book, map, weather), 或工程里的一张图片 (.svg / .png, 相对工程目录, acde build 拷进包里); 别的值 acde check 警告",
+      "examples": [
+        "files",
+        "browser",
+        "editor",
+        "office",
+        "term",
+        "projects",
+        "dash",
+        "team",
+        "dopa",
+        "settings",
+        "store",
+        "app",
+        "timer",
+        "cards",
+        "list",
+        "chart",
+        "calc",
+        "music",
+        "video",
+        "photo",
+        "paint",
+        "game",
+        "chat",
+        "mail",
+        "calendar",
+        "code",
+        "book",
+        "map",
+        "weather",
+        "icon.svg"
+      ]
+    }
+  }
+}

package/lib/acde-api/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@dopame/acde-api",
+  "version": "0.0.10",
+  "description": "acde SDK: one devDependency makes a web app (React, Vue, Svelte, any Vite / Next.js / Nuxt / SvelteKit / Astro / Angular project) an acde app. Types of acde.config.jsonc, the manifest, the services and the acde:* modules; load() for optional acde:* modules; the Vite plugin (@dopame/acde-api/vite). The checks acdert applies to a manifest (@dopame/acde-api/manifest). The tools are the acde CLI: acde new / check / build / install / dev",
+  "license": "UNLICENSED",
+  "type": "module",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dopame-org/acdert",
+    "directory": "web/packages/acde-api"
+  },
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    },
+    "./app": {
+      "types": "./src/app.d.ts",
+      "default": "./src/index.js"
+    },
+    "./shell": {
+      "types": "./src/shell.d.ts",
+      "default": "./src/index.js"
+    },
+    "./vite": {
+      "types": "./src/vite.d.ts",
+      "default": "./src/vite.js"
+    },
+    "./manifest": {
+      "types": "./src/validate.d.ts",
+      "default": "./src/validate.js"
+    },
+    "./config.schema.json": "./config.schema.json"
+  },
+  "files": [
+    "src",
+    "config.schema.json"
+  ],
+  "peerDependencies": {
+    "vite": ">=5"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

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

@@ -0,0 +1,36 @@
+/// <reference path="./modules/app-modules.d.ts" />
+import type * as Page from './types/page'
+import type { AcdeCapabilities } from './types/capabilities'
+
+export type * from './types/manifest'
+export type * from './types/page'
+export type * from './types/service'
+export type * from './types/config'
+export type * from './types/capabilities'
+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 AppModules {
+  readonly fs: Page.AcdeFs
+  readonly office: Page.AcdeOffice
+  readonly terminal: Page.AcdeTerminals
+  readonly network: Page.AcdeNetwork
+  readonly system: Page.AcdeSystem
+  readonly bluetooth: Page.AcdeBluetooth
+  readonly audio: Page.AcdeAudio
+  readonly devices: Page.AcdeDevices
+  readonly power: Page.AcdePower
+  readonly input: Page.AcdeInput
+  readonly display: Page.AcdeDisplay
+  readonly launch: Page.AcdeLaunch
+  readonly apps: Page.AcdeAppList
+  readonly open: Page.AcdeOpen
+  readonly openPath: Page.AcdeOpenFiles['openPath']
+  readonly handlers: Page.AcdeOpenFiles['handlers']
+  readonly window: Page.AcdeWindow
+  readonly capabilities: AcdeCapabilities
+}
+
+export function load<K extends keyof AppModules>(name: K): Promise<AppModules[K] | null>
+export function load(name: string): Promise<unknown>

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

@@ -0,0 +1,15 @@
+export interface FrameThemeWire {
+    readonly colors: readonly number[];
+    readonly style: number;
+    readonly side: number;
+    readonly align: number;
+    readonly ignored: readonly string[];
+}
+export declare class FrameThemes {
+    #private;
+    static readonly KEYS: readonly ["active", "inactive", "light", "buttonStyle", "buttonSide", "titleAlign"];
+    static readonly STATES: readonly ["active", "inactive"];
+    static readonly COLORS: readonly ["background", "title", "line", "buttons"];
+    static color(text: unknown): number | null;
+    static parse(raw: unknown): FrameThemeWire | string;
+}

package/lib/acde-api/src/frame.js

@@ -0,0 +1 @@
+class i{static KEYS=["active","inactive","light","buttonStyle","buttonSide","titleAlign"];static STATES=["active","inactive"];static COLORS=["background","title","line","buttons"];static#n={buttonStyle:["dots","glyphs"],buttonSide:["left","right"],titleAlign:["center","start"]};static#t=/^#([0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/i;static#r=/^rgba?\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*(?:,\s*(\d*\.?\d+)\s*)?\)$/i;static color(t){if(typeof t!="string")return null;const n=i.#t.exec(t.trim());if(n){const u=n[1].length<=4?[...n[1]].map(f=>f+f).join(""):n[1];return Number.parseInt(u.length===6?`${u}ff`:u,16)}const e=i.#r.exec(t.trim());if(!e)return null;const[l,o,r]=[e[1],e[2],e[3]].map(Number),c=e[4]===void 0?1:Number(e[4]);return[l,o,r].some(u=>u>255)||c>1?null:(l<<24|o<<16|r<<8|Math.round(c*255))>>>0}static parse(t){if(t==null)return{colors:Array(16).fill(-1),style:0,side:0,align:0,ignored:[]};if(typeof t!="object"||Array.isArray(t))return"a frame theme is an object (or null for the runtime look)";const n=t,e=Object.keys(n).filter(s=>!i.KEYS.includes(s)),l=[],o=n.light,r=typeof o!="object"||o===null||Array.isArray(o);if(o!==void 0&&r)return"light is an object with active and inactive colors";const c=o??{};e.push(...Object.keys(c).filter(s=>!i.STATES.includes(s)).map(s=>`light.${s}`));for(const[s,a]of[["",n],["light.",c]])for(const d of i.STATES){const g=i.#e(`${s}${d}`,a[d],e);if(typeof g=="string")return g;l.push(...g)}const u=[];for(const s of["buttonStyle","buttonSide","titleAlign"]){const a=n[s],d=i.#n[s];if(a!==void 0&&!d.includes(a))return`${s} is one of ${d.join(", ")}`;u.push(a===void 0?0:d.indexOf(a)+1)}const[f,b,y]=u;return{colors:l,style:f,side:b,align:y,ignored:e}}static#e(t,n,e){if(n===void 0)return Array(4).fill(-1);if(typeof n!="object"||n===null||Array.isArray(n))return`${t} is an object of colors (${i.COLORS.join(", ")})`;const l=n;e.push(...Object.keys(l).filter(r=>!i.COLORS.includes(r)).map(r=>`${t}.${r}`));const o=[];for(const r of i.COLORS){if(l[r]===void 0){o.push(-1);continue}const c=i.color(l[r]);if(c===null)return`${t}.${r} is not a color (#rgb, #rgba, #rrggbb, #rrggbbaa, rgb() or rgba()): ${JSON.stringify(l[r])}`;o.push(c)}return o}}export{i as FrameThemes};

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

@@ -0,0 +1,11 @@
+/// <reference path="./modules/modules.d.ts" />
+export type * from './types/manifest'
+export type * from './types/page'
+export type * from './types/service'
+export type * from './types/config'
+export type * from './types/capabilities'
+export type { AcdeModules } from './runtime/load'
+export { load } from './runtime/load'
+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'

package/lib/acde-api/src/index.js

@@ -0,0 +1 @@
+import{API_LEVEL as p}from"./runtime/level.js";import{load as f}from"./runtime/load.js";import{SHARED_PLACES as E}from"./runtime/places.js";import{PLATFORM_SUPPORT as S,RUNNING_MODES as e,platformSupport as x}from"./runtime/platforms.js";export{p as API_LEVEL,S as PLATFORM_SUPPORT,e as RUNNING_MODES,E as SHARED_PLACES,f as load,x as platformSupport};