akanjs 3.0.0-beta.20 → 3.0.0-beta.21

package/vendor/@akanjs/native/packages/cli/src/platforms/linux.ts

@@ -0,0 +1,52 @@
+
+
+import { cpSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import type { ParsedArgs } from "../lib/args.ts";
+import { iconArt, windowIcon } from "../lib/icons.ts";
+import type { Launched, LaunchOptions } from "../lib/launch.ts";
+import { dim, log } from "../lib/log.ts";
+import type { BuildContext } from "../lib/prepare.ts";
+import {
+  buildNativeLibrary,
+  compileExecutable,
+  folderSize,
+  launchExecutable,
+  NATIVE_LIB,
+  requireHost,
+  resourcesOf,
+  runExecutable,
+  writeDesktopResources,
+} from "./desktop.ts";
+
+const exePath = (ctx: BuildContext, dir: string) => join(dir, ctx.project.config.app.fileName);
+
+export async function buildLinux(ctx: BuildContext): Promise<string> {
+  requireHost("linux");
+  const { outDir } = ctx;
+  const { config } = ctx.project;
+  const lib = await buildNativeLibrary("linux", !ctx.dev);
+
+  const dir = join(outDir, config.app.fileName);
+  rmSync(outDir, { recursive: true, force: true });
+  mkdirSync(join(dir, "lib"), { recursive: true });
+
+  await compileExecutable(ctx, exePath(ctx, dir));
+  cpSync(lib, join(dir, "lib", NATIVE_LIB.linux));
+
+  const resources = resourcesOf("linux", dir);
+  writeDesktopResources(ctx, resources, "linux");
+  const art = iconArt(config);
+  if (art) writeFileSync(join(resources, "icon.rgba"), windowIcon(art.master));
+  const size = await folderSize(dir);
+  if (size) log.info(dim(`size ${size}`));
+  return dir;
+}
+
+export async function launchLinux(ctx: BuildContext, dir: string, opts: LaunchOptions): Promise<Launched> {
+  return launchExecutable(exePath(ctx, dir), opts);
+}
+
+export async function runLinux(ctx: BuildContext, dir: string, args: ParsedArgs): Promise<number> {
+  return runExecutable(exePath(ctx, dir), dir, args);
+}

package/vendor/@akanjs/native/packages/cli/src/platforms/macos.ts

@@ -0,0 +1,97 @@
+
+
+import { cpSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import type { ParsedArgs } from "../lib/args.ts";
+import { execOrThrow } from "../lib/exec.ts";
+import { icns, iconArt, macosIconImage } from "../lib/icons.ts";
+import type { Launched, LaunchOptions } from "../lib/launch.ts";
+import { dim, log } from "../lib/log.ts";
+import { permissionPlist } from "../lib/permissions.ts";
+import { type PlistValue, toPlist } from "../lib/plist.ts";
+import type { BuildContext } from "../lib/prepare.ts";
+import { devIdentity } from "../lib/signing.ts";
+import {
+  buildNativeLibrary,
+  compileExecutable,
+  folderSize,
+  launchExecutable,
+  NATIVE_LIB,
+  requireHost,
+  runExecutable,
+  writeDesktopResources,
+} from "./desktop.ts";
+
+export const MACOS_MIN = "26.0";
+
+export async function buildMacos(ctx: BuildContext): Promise<string> {
+  requireHost("macos");
+  const { project, outDir } = ctx;
+  const { config } = project;
+  const lib = await buildNativeLibrary("macos", !ctx.dev);
+
+  const appPath = join(outDir, `${config.app.name}.app`);
+  const contents = join(appPath, "Contents");
+  const exe = config.app.fileName;
+  rmSync(outDir, { recursive: true, force: true });
+  for (const dir of ["MacOS", "Frameworks", "Resources"]) mkdirSync(join(contents, dir), { recursive: true });
+
+  await compileExecutable(ctx, join(contents, "MacOS", exe));
+  cpSync(lib, join(contents, "Frameworks", NATIVE_LIB.macos));
+
+  const resources = join(contents, "Resources");
+
+  const identity = await devIdentity();
+  writeDesktopResources(ctx, resources, "macos", { signing: identity ? "identity" : "adhoc" });
+
+  const art = iconArt(config);
+  if (art) writeFileSync(join(resources, "AppIcon.icns"), icns(macosIconImage(art)));
+
+  const usage: Record<string, PlistValue> = {};
+  for (const plugin of project.plugins) Object.assign(usage, plugin.manifest.macos?.infoPlist ?? {});
+  Object.assign(usage, permissionPlist(config.permissions, "macos")); 
+  for (const key of Object.keys(usage)) if (config.usageDescriptions[key]) usage[key] = config.usageDescriptions[key]!;
+  writeFileSync(
+    join(contents, "Info.plist"),
+    toPlist({
+      CFBundleDevelopmentRegion: "en",
+      CFBundleExecutable: exe,
+      CFBundleIdentifier: config.app.id,
+      CFBundleName: config.app.name,
+      CFBundleDisplayName: config.app.name,
+      CFBundlePackageType: "APPL",
+      CFBundleShortVersionString: config.app.version,
+      CFBundleVersion: String(config.app.build),
+      CFBundleInfoDictionaryVersion: "6.0",
+      LSMinimumSystemVersion: MACOS_MIN,
+      NSHighResolutionCapable: true,
+      NSSupportsAutomaticGraphicsSwitching: true,
+      ...(art ? { CFBundleIconFile: "AppIcon" } : {}),
+      ...(config.deepLinks.schemes.length
+        ? { CFBundleURLTypes: [{ CFBundleURLName: config.app.id, CFBundleURLSchemes: config.deepLinks.schemes }] }
+        : {}),
+      ...usage,
+    }),
+  );
+
+  const sign = identity?.hash ?? "-";
+  log.step(`sign: ${identity ? identity.name : "ad-hoc"}`);
+  
+  await execOrThrow(["xattr", "-cr", appPath], { echo: false });
+  await execOrThrow(["codesign", "--force", "--sign", sign, join(contents, "Frameworks", NATIVE_LIB.macos)], {
+    echo: false,
+  });
+  await execOrThrow(["codesign", "--force", "--sign", sign, appPath], { echo: false });
+  const size = await folderSize(appPath);
+  if (size) log.info(dim(`size ${size}`));
+  return appPath;
+}
+
+export async function launchMacos(ctx: BuildContext, appPath: string, opts: LaunchOptions): Promise<Launched> {
+  
+  return launchExecutable(join(appPath, "Contents", "MacOS", ctx.project.config.app.fileName), opts);
+}
+
+export async function runMacos(ctx: BuildContext, appPath: string, args: ParsedArgs): Promise<number> {
+  return runExecutable(join(appPath, "Contents", "MacOS", ctx.project.config.app.fileName), appPath, args);
+}

package/vendor/@akanjs/native/packages/cli/src/platforms/targets.ts

@@ -0,0 +1,12 @@
+
+
+export type TargetPlatform = "web" | "macos" | "windows" | "linux" | "ios" | "android";
+export const TARGETS: readonly TargetPlatform[] = ["web", "macos", "windows", "linux", "ios", "android"];
+
+/** What `all` means on this machine: desktop apps and iOS build only on their own OS. */
+export function hostTargets(host: NodeJS.Platform = process.platform): TargetPlatform[] {
+  if (host === "darwin") return ["web", "macos", "ios", "android"];
+  if (host === "win32") return ["web", "windows"];
+  if (host === "linux") return ["web", "linux"];
+  return ["web"];
+}

package/vendor/@akanjs/native/packages/cli/src/platforms/web-run.ts

@@ -0,0 +1,69 @@
+import { renderInitScript } from "../../../core/src/protocol.ts";
+import { type ParsedArgs, stringFlag } from "../lib/args.ts";
+import { makeBoot } from "../lib/boot.ts";
+import { openHeadless } from "../lib/chrome.ts";
+import { envFromProcess, follow, type Launched, type LaunchOptions, printLine } from "../lib/launch.ts";
+import { bold, log } from "../lib/log.ts";
+import type { BuildContext } from "../lib/prepare.ts";
+import { type LiveReload, serveApp } from "../lib/serve.ts";
+
+export interface WebLaunchOptions extends LaunchOptions {
+  port?: number;
+  hostname?: string;
+  /** Called with the server URL once it listens. */
+  onReady?: (url: string) => void;
+  liveReload?: LiveReload;
+}
+
+/** The web platform's /__akan_native/init.js with runtime env overrides (AKAN_NATIVE_PUBLIC_X → PUBLIC_X), as the native dev hosts do (§3.1). */
+export function webInitScript(ctx: BuildContext, env: Record<string, string>): string {
+  const overrides = Object.fromEntries(Object.entries(env).map(([k, v]) => [k.replace(/^AKAN_NATIVE_/, ""), v]));
+  const plugins = Object.fromEntries(
+    ctx.project.plugins.filter((p) => p.manifest.web).map((p) => [p.manifest.id, "web" as const]),
+  );
+  return renderInitScript(
+    JSON.stringify(makeBoot(ctx.project.config, "web", plugins, ctx.dev, ctx.project)),
+    JSON.stringify({ ...ctx.env, ...overrides }),
+  );
+}
+
+export async function launchWeb(ctx: BuildContext, outDir: string, opts: WebLaunchOptions): Promise<Launched> {
+  
+  const initScript = Object.keys(opts.env).length ? () => webInitScript(ctx, opts.env) : undefined;
+
+  const server = serveApp({
+    dir: outDir,
+    port: opts.port ?? 4173,
+    hostname: opts.hostname ?? "localhost",
+    initScript,
+    liveReload: opts.liveReload,
+  });
+  opts.onReady?.(server.url.href);
+  let resolveExit!: (code: number) => void;
+  const exited = new Promise<number>((resolve) => (resolveExit = resolve));
+  let browser: Awaited<ReturnType<typeof openHeadless>> | null = null;
+  if (opts.headless) browser = await openHeadless(server.url.href, opts.onLine ?? printLine);
+  return {
+    exited,
+    stop() {
+      browser?.stop();
+      server.stop(true);
+      resolveExit(0);
+    },
+  };
+}
+
+export async function runWeb(ctx: BuildContext, outDir: string, args: ParsedArgs): Promise<number> {
+  const app = await launchWeb(ctx, outDir, {
+    env: envFromProcess(),
+    headless: false,
+    port: Number(stringFlag(args, "port") ?? 4173),
+    hostname: stringFlag(args, "host"),
+    onReady(url) {
+      log.ok(`serving ${outDir}`);
+      log.info(bold(`→ ${url}`));
+      if (args.flags.open) Bun.spawn(["open", url]);
+    },
+  });
+  return follow(app);
+}

package/vendor/@akanjs/native/packages/cli/src/platforms/web.ts

@@ -0,0 +1,28 @@
+
+
+import { cpSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import type { PluginDecl } from "../../../core/src/index.ts";
+import { makeBoot, renderInitScript } from "../lib/boot.ts";
+import type { BuildContext } from "../lib/prepare.ts";
+
+export async function buildWeb(ctx: BuildContext): Promise<string> {
+  const { outDir, webDir, project } = ctx;
+  rmSync(outDir, { recursive: true, force: true });
+  mkdirSync(outDir, { recursive: true });
+  cpSync(webDir, outDir, { recursive: true });
+  writeFileSync(join(outDir, "index.html"), ctx.html);
+
+  const plugins: Record<string, PluginDecl> = {};
+  for (const plugin of project.plugins) {
+    if (plugin.manifest.web) plugins[plugin.manifest.id] = "web";
+  }
+  const boot = makeBoot(project.config, "web", plugins, ctx.dev, project);
+  mkdirSync(join(outDir, "__akan_native"), { recursive: true });
+  
+  writeFileSync(
+    join(outDir, "__akan_native", "init.js"),
+    renderInitScript(JSON.stringify(boot), JSON.stringify(ctx.env, null, 2)),
+  );
+  return outDir;
+}

package/vendor/@akanjs/native/packages/cli/src/platforms/windows.ts

@@ -0,0 +1,82 @@
+
+
+import { cpSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import type { ParsedArgs } from "../lib/args.ts";
+import { ico, iconArt, windowIcon } from "../lib/icons.ts";
+import type { Launched, LaunchOptions } from "../lib/launch.ts";
+import { log } from "../lib/log.ts";
+import type { BuildContext } from "../lib/prepare.ts";
+import {
+  buildNativeLibrary,
+  compileExecutable,
+  launchExecutable,
+  NATIVE_LIB,
+  requireHost,
+  resourcesOf,
+  runExecutable,
+  writeDesktopResources,
+} from "./desktop.ts";
+
+/** Characters left for the app id under C:\Users\<name>\AppData\Local\ before WebView2's own paths reach MAX_PATH. */
+const WEBVIEW2_ID_BUDGET = 40;
+
+/** The version resource wants four numbers: major.minor.patch.build. */
+export function windowsVersion(version: string, build: number): string {
+  const parts = version
+    .split(/[.+-]/)
+    .map((p) => Number.parseInt(p, 10))
+    .filter((n) => Number.isFinite(n) && n >= 0)
+    .slice(0, 3);
+  while (parts.length < 3) parts.push(0);
+  return [...parts, Math.max(0, Math.floor(build))].join(".");
+}
+
+const exePath = (ctx: BuildContext, dir: string) => join(dir, `${ctx.project.config.app.fileName}.exe`);
+
+export async function buildWindows(ctx: BuildContext): Promise<string> {
+  requireHost("windows");
+  const { outDir } = ctx;
+  const { config } = ctx.project;
+  const lib = await buildNativeLibrary("windows", !ctx.dev);
+
+  if (config.app.id.length > WEBVIEW2_ID_BUDGET) {
+    log.warn(
+      `app.id is ${config.app.id.length} characters: WebView2's deepest paths under %LOCALAPPDATA%\\${config.app.id} may pass Windows' 260-character limit (keep it under ${WEBVIEW2_ID_BUDGET + 1})`,
+    );
+  }
+
+  const dir = join(outDir, config.app.name);
+  rmSync(outDir, { recursive: true, force: true });
+  mkdirSync(dir, { recursive: true });
+
+  const art = iconArt(config);
+  const flags = [
+    
+    "--windows-hide-console",
+    `--windows-title=${config.app.name}`,
+    `--windows-description=${config.app.name}`,
+    `--windows-version=${windowsVersion(config.app.version, config.app.build)}`,
+  ];
+  if (art) {
+    const icon = join(outDir, "gen", "app.ico");
+    mkdirSync(join(outDir, "gen"), { recursive: true });
+    writeFileSync(icon, ico(art.master));
+    flags.push(`--windows-icon=${icon}`);
+  }
+  await compileExecutable(ctx, exePath(ctx, dir), flags);
+  cpSync(lib, join(dir, NATIVE_LIB.windows));
+
+  const resources = resourcesOf("windows", dir);
+  writeDesktopResources(ctx, resources, "windows");
+  if (art) writeFileSync(join(resources, "icon.rgba"), windowIcon(art.master));
+  return dir;
+}
+
+export async function launchWindows(ctx: BuildContext, dir: string, opts: LaunchOptions): Promise<Launched> {
+  return launchExecutable(exePath(ctx, dir), opts);
+}
+
+export async function runWindows(ctx: BuildContext, dir: string, args: ParsedArgs): Promise<number> {
+  return runExecutable(exePath(ctx, dir), dir, args);
+}

package/vendor/@akanjs/native/packages/core/contract.json

@@ -0,0 +1,96 @@
+{
+  "about": "Tables and constants every akan-native host shares (docs/architecture.md §5). scripts/contract.ts writes them into packages/core/src/contract.ts, native/desktop/src/contract.rs, native/ios/Sources/AkanNativeContract.swift and native/android/src/com/akanjs/runtime/AkanNativeContract.kt; bun test fails when those are stale. Algorithms are not generated: each language implements them and must pass packages/core/vectors.",
+  "errorCodes": ["UNSUPPORTED", "PERMISSION_DENIED", "CANCELLED", "TIMEOUT", "INVALID_ARGS", "NOT_FOUND", "NOT_ALLOWED", "INTERNAL"],
+  "mime": {
+    "html": "text/html",
+    "htm": "text/html",
+    "js": "text/javascript",
+    "mjs": "text/javascript",
+    "css": "text/css",
+    "json": "application/json",
+    "map": "application/json",
+    "webmanifest": "application/manifest+json",
+    "txt": "text/plain",
+    "text": "text/plain",
+    "log": "text/plain",
+    "md": "text/markdown",
+    "csv": "text/csv",
+    "tsv": "text/tab-separated-values",
+    "xml": "application/xml",
+    "yaml": "application/yaml",
+    "yml": "application/yaml",
+    "ics": "text/calendar",
+    "vcf": "text/vcard",
+    "pdf": "application/pdf",
+    "rtf": "application/rtf",
+    "zip": "application/zip",
+    "gz": "application/gzip",
+    "tar": "application/x-tar",
+    "wasm": "application/wasm",
+    "epub": "application/epub+zip",
+    "doc": "application/msword",
+    "docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    "xls": "application/vnd.ms-excel",
+    "xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    "ppt": "application/vnd.ms-powerpoint",
+    "pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    "png": "image/png",
+    "jpg": "image/jpeg",
+    "jpeg": "image/jpeg",
+    "gif": "image/gif",
+    "webp": "image/webp",
+    "avif": "image/avif",
+    "heic": "image/heic",
+    "heif": "image/heif",
+    "bmp": "image/bmp",
+    "svg": "image/svg+xml",
+    "ico": "image/x-icon",
+    "tif": "image/tiff",
+    "tiff": "image/tiff",
+    "mp3": "audio/mpeg",
+    "m4a": "audio/mp4",
+    "aac": "audio/aac",
+    "wav": "audio/wav",
+    "ogg": "audio/ogg",
+    "flac": "audio/flac",
+    "mp4": "video/mp4",
+    "m4v": "video/mp4",
+    "mov": "video/quicktime",
+    "webm": "video/webm",
+    "ttf": "font/ttf",
+    "otf": "font/otf",
+    "woff": "font/woff",
+    "woff2": "font/woff2",
+    "glb": "model/gltf-binary",
+    "gltf": "model/gltf+json"
+  },
+  "mimeUtf8": {
+    "about": "Assets of these types are served with charset=utf-8: every text/* type, and these.",
+    "types": ["application/json", "application/manifest+json", "application/xml", "application/yaml", "image/svg+xml", "model/gltf+json"]
+  },
+  "ids": {
+    "about": "Characters, lengths and extensions of the ids hosts accept. Lengths count ASCII characters.",
+    "fileRef": { "chars": "A-Za-z0-9_-", "min": 1, "max": 128, "extChars": "A-Za-z0-9", "extMax": 8 },
+    "bundle": { "chars": "A-Za-z0-9_.-", "min": 1, "max": 80, "notFirst": "." },
+    "document": { "chars": "A-Za-z0-9_-", "min": 8, "max": 64 },
+    "name": { "first": "$A-Za-z", "chars": "A-Za-z0-9_.-", "min": 1, "max": 64 }
+  },
+  "schemes": {
+    "external": ["http", "https", "mailto", "tel"],
+    "frames": ["http", "https", "data", "blob", "about"],
+    "neverExternal": ["javascript", "vbscript", "file", "data", "blob", "about", "content", "intent", "app"],
+    "about": "external: what the shell may hand to the OS (links, window.open, opener); the app may add schemes (security.shell.externalSchemes) except neverExternal. frames: what an iframe may load."
+  },
+  "routes": {
+    "root": "__akan_native",
+    "init": "init.js",
+    "ipc": "ipc",
+    "hello": "hello",
+    "file": "file"
+  },
+  "initPrefix": "window.__AKAN_NATIVE__=(function(o,b,e){for(var k in b)o[k]=b[k];o.env=e;return o})(window.__AKAN_NATIVE__||{},",
+  "initSuffix": ");\n",
+  "maxRangeBytes": 1024000,
+  "externalOpensPerSecond": 1,
+  "maxRetainedEvents": 16
+}