@vantail/create 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * `npm create @vantail my-app`
+ *
+ * Copies a template, fills in the two things that are actually specific to a
+ * project - its name and its bundle identifier - and gets out of the way.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,189 @@
+#!/usr/bin/env node
+/**
+ * `npm create @vantail my-app`
+ *
+ * Copies a template, fills in the two things that are actually specific to a
+ * project - its name and its bundle identifier - and gets out of the way.
+ */
+import { cp, readFile, readdir, rename, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { createInterface } from "node:readline/promises";
+import { basename, dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { suggestIdentifier, toPackageName } from "./naming.js";
+const TEMPLATES = [
+    { id: "react-ts", label: "React + TypeScript" },
+    { id: "svelte-ts", label: "Svelte + TypeScript" },
+    { id: "vue-ts", label: "Vue + TypeScript" },
+    { id: "vanilla-ts", label: "Vanilla TypeScript" },
+];
+const templatesRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..", "templates");
+async function main() {
+    const argv = process.argv.slice(2);
+    const flags = new Map();
+    const positional = [];
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (arg.startsWith("--")) {
+            const [name, inline] = splitFlag(arg.slice(2));
+            const next = argv[index + 1];
+            if (inline !== undefined) {
+                flags.set(name, inline);
+            }
+            else if (next !== undefined && !next.startsWith("-")) {
+                flags.set(name, next);
+                index += 1;
+            }
+            else {
+                flags.set(name, "true");
+            }
+            continue;
+        }
+        positional.push(arg);
+    }
+    const interactive = process.stdin.isTTY === true && flags.get("yes") !== "true";
+    const rl = interactive
+        ? createInterface({ input: process.stdin, output: process.stdout })
+        : null;
+    try {
+        // Only ask when the directory was not given on the command line.
+        const asked = positional[0] ??
+            (rl ? (await rl.question("Project directory: ")).trim() : "");
+        const directory = asked === "" ? "vantail-app" : asked;
+        const target = resolve(process.cwd(), directory);
+        if (existsSync(target) && (await readdir(target)).length > 0) {
+            console.error(`${directory} already exists and is not empty.`);
+            return 1;
+        }
+        const template = await chooseTemplate(flags.get("template"), rl);
+        const name = flags.get("name") ?? basename(target);
+        const identifier = flags.get("identifier") ?? suggestIdentifier(name);
+        await scaffold({ template, target, name, identifier });
+        // Nothing is published to npm yet, so a project scaffolded from a checkout
+        // has to point back at it or `npm install` cannot resolve anything.
+        const root = flags.get("no-link") === "true" ? undefined : checkout();
+        const linked = root ? await linkToCheckout(target, root) : [];
+        console.log(`
+Created ${name} in ${directory}
+
+  cd ${directory}
+  npm install
+  npm run dev
+`);
+        if (linked.length > 0) {
+            console.log(`${linked.join(" and ")} point at ${root}.`);
+            console.log(`Build them there first: pnpm install && pnpm build && pnpm build:runtime\n`);
+        }
+        return 0;
+    }
+    finally {
+        rl?.close();
+    }
+}
+async function scaffold(input) {
+    await cp(join(templatesRoot, input.template), input.target, {
+        recursive: true,
+    });
+    // npm refuses to publish a file called `.gitignore`, so templates ship it
+    // under a placeholder name.
+    const placeholder = join(input.target, "_gitignore");
+    if (existsSync(placeholder)) {
+        await rename(placeholder, join(input.target, ".gitignore"));
+    }
+    await substitute(join(input.target, "package.json"), input);
+    await substitute(join(input.target, "vantail.config.ts"), input);
+    await substitute(join(input.target, "index.html"), input);
+    await substitute(join(input.target, "README.md"), input);
+}
+/**
+ * The Vantail checkout this scaffolder is running out of, if it is running out
+ * of one rather than an installed package.
+ */
+function checkout() {
+    let dir = templatesRoot;
+    for (;;) {
+        if (existsSync(join(dir, "runtime", "Cargo.toml")) &&
+            existsSync(join(dir, "packages"))) {
+            return dir;
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+/**
+ * Point the `@vantail/*` dependencies at a local checkout.
+ *
+ * npm links a `file:` dependency rather than copying it, which is what makes
+ * this work end to end: the runtime resolver walks up from the linked package
+ * and finds the `cargo build` in the checkout's `target/`, so a scaffolded app
+ * runs against a locally built runtime with nothing else configured.
+ *
+ * Returns the packages it rewrote.
+ */
+async function linkToCheckout(target, root) {
+    const path = join(target, "package.json");
+    const manifest = JSON.parse(await readFile(path, "utf8"));
+    const linked = [];
+    for (const group of ["dependencies", "devDependencies"]) {
+        const deps = manifest[group];
+        if (!deps)
+            continue;
+        for (const name of Object.keys(deps)) {
+            if (!name.startsWith("@vantail/"))
+                continue;
+            const local = join(root, "packages", name.slice("@vantail/".length));
+            if (!existsSync(local))
+                continue;
+            deps[name] = `file:${local}`;
+            linked.push(name);
+        }
+    }
+    await writeFile(path, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+    return linked;
+}
+/** Replace the two tokens templates are allowed to contain. */
+async function substitute(path, input) {
+    if (!existsSync(path))
+        return;
+    const source = await readFile(path, "utf8");
+    const replaced = source
+        .replaceAll("__APP_NAME__", input.name)
+        .replaceAll("__PACKAGE_NAME__", toPackageName(input.name))
+        .replaceAll("__APP_IDENTIFIER__", input.identifier);
+    await writeFile(path, replaced, "utf8");
+}
+async function chooseTemplate(requested, rl) {
+    if (requested) {
+        const match = TEMPLATES.find((template) => template.id === requested);
+        if (!match) {
+            throw new Error(`Unknown template "${requested}". Available: ${TEMPLATES.map((t) => t.id).join(", ")}`);
+        }
+        return match.id;
+    }
+    if (!rl)
+        return "react-ts";
+    console.log("\nTemplate:");
+    TEMPLATES.forEach((template, index) => {
+        console.log(`  ${index + 1}. ${template.label}`);
+    });
+    const answer = (await rl.question("Choose [1]: ")).trim();
+    const index = answer === "" ? 0 : Number(answer) - 1;
+    return TEMPLATES[index]?.id ?? "react-ts";
+}
+function splitFlag(body) {
+    const equals = body.indexOf("=");
+    return equals === -1
+        ? [body, undefined]
+        : [body.slice(0, equals), body.slice(equals + 1)];
+}
+main()
+    .then((code) => {
+    process.exitCode = code;
+})
+    .catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/naming.d.ts

@@ -0,0 +1,6 @@
+/** Turning a project name into the identifiers a template needs. */
+/** `My Notes` becomes `com.example.mynotes` - a starting point, not a decree. */
+export declare function suggestIdentifier(name: string): string;
+/** A name npm will accept in `package.json`. */
+export declare function toPackageName(name: string): string;
+//# sourceMappingURL=naming.d.ts.map

package/dist/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD"}

package/dist/naming.js

@@ -0,0 +1,18 @@
+/** Turning a project name into the identifiers a template needs. */
+/** `My Notes` becomes `com.example.mynotes` - a starting point, not a decree. */
+export function suggestIdentifier(name) {
+    const slug = name
+        .toLowerCase()
+        .replace(/[^a-z0-9]/g, "")
+        .slice(0, 32);
+    return `com.example.${slug || "app"}`;
+}
+/** A name npm will accept in `package.json`. */
+export function toPackageName(name) {
+    const slug = name
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return slug || "vantail-app";
+}
+//# sourceMappingURL=naming.js.map

package/dist/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,IAAI,GAAG,IAAI;SACd,WAAW,EAAE;SACb,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;SACzB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,OAAO,eAAe,IAAI,IAAI,KAAK,EAAE,CAAC;AACxC,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,IAAI,GAAG,IAAI;SACd,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,OAAO,IAAI,IAAI,aAAa,CAAC;AAC/B,CAAC"}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@vantail/create",
+  "version": "0.1.0",
+  "description": "Scaffold a Vantail application.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Vantail/vantail.git",
+    "directory": "packages/create"
+  },
+  "homepage": "https://github.com/Vantail/vantail",
+  "type": "module",
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "bin": {
+    "vantail-create": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "devDependencies": {
+    "@vantail/shared": "^0.1.0"
+  }
+}

package/templates/react-ts/README.md

@@ -0,0 +1,34 @@
+# __APP_NAME__
+
+Built with [Vantail](https://github.com/jeroenvanwissen/vantail).
+
+```bash
+npm install
+npm run dev       # native window against the Vite dev server
+npm run build     # build the web assets
+npm run package   # produce a distributable application
+npm run doctor    # check that everything needed is installed
+```
+
+There is no Node.js in this app. `node:fs` and friends do not exist - use
+`@vantail/api` instead:
+
+```ts
+import { dialog, filesystem } from "@vantail/api";
+
+const path = await dialog.openFile();
+if (path) console.log(await filesystem.readText(path));
+```
+
+Native access is denied by default and granted in `vantail.config.ts`. The same
+file also describes the application menu, and can add a tray icon and a
+self-updater.
+
+More windows are labels, opened at runtime:
+
+```ts
+import { app, createWindow } from "@vantail/api";
+
+const settings = await createWindow("settings", { url: "settings.html" });
+await app.emit("hello", { from: "main" }, { to: "settings" });
+```

package/templates/react-ts/_gitignore

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+.vantail/
+build/
+.DS_Store

package/templates/react-ts/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>__APP_NAME__</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/react-ts/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "__PACKAGE_NAME__",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vantail dev",
+    "build": "vantail build",
+    "package": "vantail package",
+    "doctor": "vantail doctor"
+  },
+  "dependencies": {
+    "@vantail/api": "^0.1.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  },
+  "devDependencies": {
+    "@vantail/cli": "^0.1.0",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "@vitejs/plugin-react": "^6.0.0",
+    "typescript": "^5.9.0",
+    "vite": "^8.0.0"
+  }
+}

package/templates/react-ts/src/App.tsx

@@ -0,0 +1,39 @@
+import { useState } from "react";
+
+import { app, dialog, filesystem, VantailError } from "@vantail/api";
+
+export function App() {
+  const [contents, setContents] = useState<string | null>(null);
+  const [path, setPath] = useState<string | null>(null);
+  const [error, setError] = useState<string | null>(null);
+
+  const info = app.infoSync();
+
+  async function open() {
+    setError(null);
+    try {
+      const picked = await dialog.openFile({ title: "Open a text file" });
+      if (!picked) return;
+
+      // Picking the file in the dialog is what grants access to it - the
+      // config above never mentions this path.
+      setPath(picked);
+      setContents(await filesystem.readText(picked));
+    } catch (cause) {
+      setError(VantailError.is(cause) ? `${cause.code}: ${cause.message}` : String(cause));
+    }
+  }
+
+  return (
+    <main>
+      <h1>{info?.name ?? "Vantail"}</h1>
+      <p className="meta">v{info?.version}</p>
+
+      <button onClick={() => void open()}>Select file</button>
+
+      {error ? <p className="error">{error}</p> : null}
+      {path ? <p className="meta">{path}</p> : null}
+      {contents !== null ? <pre>{contents}</pre> : <p className="meta">No file open.</p>}
+    </main>
+  );
+}

package/templates/react-ts/src/main.tsx

@@ -0,0 +1,14 @@
+import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+
+import { App } from "./App.js";
+import "./style.css";
+
+const container = document.getElementById("root");
+if (!container) throw new Error("index.html is missing #root");
+
+createRoot(container).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+);

package/templates/react-ts/src/style.css

@@ -0,0 +1,60 @@
+:root {
+  color-scheme: light dark;
+  font-family: ui-sans-serif, -apple-system, "Segoe UI", system-ui, sans-serif;
+  font-size: 14px;
+}
+
+body {
+  margin: 0;
+}
+
+main {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  padding: 24px;
+  min-height: 100vh;
+  box-sizing: border-box;
+}
+
+h1 {
+  margin: 0;
+  font-size: 18px;
+}
+
+.meta {
+  margin: 0;
+  opacity: 0.6;
+  font-size: 12px;
+  overflow-wrap: anywhere;
+}
+
+.error {
+  margin: 0;
+  color: #d43b3b;
+  font-size: 13px;
+}
+
+button {
+  align-self: flex-start;
+  padding: 6px 12px;
+  border-radius: 7px;
+  border: 1px solid currentColor;
+  background: transparent;
+  color: inherit;
+  font: inherit;
+  cursor: pointer;
+}
+
+pre {
+  flex: 1;
+  margin: 0;
+  padding: 12px;
+  overflow: auto;
+  border-radius: 8px;
+  background: color-mix(in srgb, currentColor 8%, transparent);
+  font-family: ui-monospace, Menlo, monospace;
+  font-size: 12px;
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+}

package/templates/react-ts/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "types": ["vite/client"]
+  },
+  "include": ["src", "vantail.config.ts", "vite.config.ts"]
+}

package/templates/react-ts/vantail.config.ts

@@ -0,0 +1,60 @@
+import { defineConfig } from "@vantail/cli";
+
+export default defineConfig({
+  app: {
+    name: "__APP_NAME__",
+    identifier: "__APP_IDENTIFIER__",
+    version: "0.1.0",
+    // A square PNG. Every size each platform asks for is scaled down from it.
+    icon: "icon.png",
+  },
+
+  window: {
+    title: "__APP_NAME__",
+    width: 900,
+    height: 640,
+    minWidth: 480,
+    minHeight: 360,
+  },
+
+  // On macOS this is not decoration: without these predefined items in the
+  // menu, Cmd-C, Cmd-V and Cmd-Z do not work anywhere in the application.
+  // Add your own submenus alongside them.
+  menu: [
+    {
+      type: "submenu",
+      label: "__APP_NAME__",
+      items: [
+        { type: "predefined", item: "about" },
+        { type: "separator" },
+        { type: "predefined", item: "hide" },
+        { type: "predefined", item: "quit" },
+      ],
+    },
+    {
+      type: "submenu",
+      label: "Edit",
+      items: [
+        { type: "predefined", item: "undo" },
+        { type: "predefined", item: "redo" },
+        { type: "separator" },
+        { type: "predefined", item: "cut" },
+        { type: "predefined", item: "copy" },
+        { type: "predefined", item: "paste" },
+        { type: "predefined", item: "selectAll" },
+      ],
+    },
+  ],
+
+  // Everything is denied until you ask for it. Start small: `dialog` plus the
+  // default `grantFromDialog` is enough to open any file the user picks,
+  // without granting standing access to their disk.
+  permissions: {
+    dialog: true,
+    clipboard: true,
+    menu: true,
+    filesystem: {
+      write: ["$APPDATA/**"],
+    },
+  },
+});

package/templates/react-ts/vite.config.ts

@@ -0,0 +1,8 @@
+import react from "@vitejs/plugin-react";
+import { defineConfig } from "vite";
+
+// `vantail dev` adds the Vantail plugin itself - this file is only for what
+// your interface needs.
+export default defineConfig({
+  plugins: [react()],
+});

package/templates/svelte-ts/README.md

@@ -0,0 +1,34 @@
+# __APP_NAME__
+
+Built with [Vantail](https://github.com/jeroenvanwissen/vantail).
+
+```bash
+npm install
+npm run dev       # native window against the Vite dev server
+npm run build     # build the web assets
+npm run package   # produce a distributable application
+npm run doctor    # check that everything needed is installed
+```
+
+There is no Node.js in this app. `node:fs` and friends do not exist - use
+`@vantail/api` instead:
+
+```ts
+import { dialog, filesystem } from "@vantail/api";
+
+const path = await dialog.openFile();
+if (path) console.log(await filesystem.readText(path));
+```
+
+Native access is denied by default and granted in `vantail.config.ts`. The same
+file also describes the application menu, and can add a tray icon and a
+self-updater.
+
+More windows are labels, opened at runtime:
+
+```ts
+import { app, createWindow } from "@vantail/api";
+
+const settings = await createWindow("settings", { url: "settings.html" });
+await app.emit("hello", { from: "main" }, { to: "settings" });
+```

package/templates/svelte-ts/_gitignore

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+.vantail/
+build/
+.DS_Store

package/templates/svelte-ts/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>__APP_NAME__</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/templates/svelte-ts/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "__PACKAGE_NAME__",
+  "private": true,
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vantail dev",
+    "build": "vantail build",
+    "package": "vantail package",
+    "doctor": "vantail doctor"
+  },
+  "dependencies": {
+    "@vantail/api": "^0.1.0"
+  },
+  "devDependencies": {
+    "@vantail/cli": "^0.1.0",
+    "@sveltejs/vite-plugin-svelte": "^7.3.0",
+    "svelte": "^5.56.10",
+    "typescript": "^5.9.0",
+    "vite": "^8.0.0"
+  }
+}