@tavora/create-module 0.0.0-stage → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+What changed in `@tavora/create-module`, newest first.
+
+## 0.1.1
+
+- Asks with arrow keys: where the project goes (the empty folder you are in, or a new folder in it) and which template.
+- The next steps say to leave `npm run dev` running and which folder to add in Tavora under Settings > Development; a folder with several projects works too (Tavora 0.17.20).
+
+## 0.1.0
+
+- First release on npm: `npm create @tavora/module` makes a vanilla TypeScript, Vue or React module project.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wellbrained
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,22 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @tavora/create-module
+
+Makes a new [Tavora](https://mytavora.app) module project.
+
+```sh
+npm create @tavora/module
+# or
+pnpm create @tavora/module
+```
+
+It asks where the project goes (the empty folder you are in, or a new folder in it), the module's name, its id (`publisher.module-name`) and a template: **vanilla** TypeScript, **vue** or **react**, picked with the arrow keys. Give them up front to skip the questions:
+
+```sh
+npm create @tavora/module raid-timer -- --template vue --id example.raid-timer --name "Raid Timer"
+pnpm create @tavora/module raid-timer --template vue --id example.raid-timer --name "Raid Timer"
+```
+
+`--yes` takes the suggestions for anything not given.
+
+The project builds with Vite, has a `dev` script that rebuilds on every change (add the folder in Tavora under **Settings > Development > Add a development folder…**; a folder with several projects in it works too), and a `zip` script that packs and signs it with `@tavora/pack`. Its manifest sets `minTavora` to the oldest Tavora that has everything the SDK it starts with offers. The project's README says the rest.
+
+More in the [developer docs](https://docs.mytavora.app/guide/getting-started).

package/dist/create.d.ts

@@ -0,0 +1,29 @@
+export declare const TEMPLATES: readonly ["vanilla", "vue", "react"];
+export type Template = (typeof TEMPLATES)[number];
+export interface ModuleOptions {
+    /** The project folder to make; it must not exist yet, or be empty. */
+    dir: string;
+    /** The module id, publisher.module-name. */
+    id: string;
+    /** The name players see. */
+    name: string;
+    template: Template;
+    /** The package manager the commands in the README use. */
+    packageManager?: "npm" | "pnpm" | "yarn";
+}
+export declare class CreateError extends Error {
+}
+/** A folder name as a lowercase slug: letters, digits and dashes, starting with a letter. */
+export declare function slugOf(folder: string): string;
+/** What the starter offers when nothing was given: a name and an id from the folder's name. */
+export declare function defaultsFor(folder: string): {
+    id: string;
+    name: string;
+};
+/** Why an id cannot be used, or null. */
+export declare function idProblem(id: string): string | null;
+/** Why a name cannot be used, or null. */
+export declare function nameProblem(name: string): string | null;
+/** Makes the project and answers with the files it wrote, relative to `dir`. */
+export declare function createModule(options: ModuleOptions): Promise<string[]>;
+//# sourceMappingURL=create.d.ts.map

package/dist/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../src/create.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,SAAS,sCAAuC,CAAC;AAC9D,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,0DAA0D;IAC1D,cAAc,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;CAC1C;AAED,qBAAa,WAAY,SAAQ,KAAK;CAAG;AAKzC,6FAA6F;AAC7F,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAO7C;AAED,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAQxE;AAED,yCAAyC;AACzC,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAInD;AAED,0CAA0C;AAC1C,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEvD;AAyBD,gFAAgF;AAChF,wBAAsB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgC5E"}

package/dist/create.js

@@ -0,0 +1,104 @@
+import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { isModuleId } from "@tavora/module-schema";
+import { VERSIONS } from "./versions.js";
+// Makes a new module project from a template: the shared files (manifest, README, styles,
+// .gitignore) and the template's own (package.json, build config, page and code). Only the
+// placeholders listed here are filled in; anything else in braces (such as Vue's own {{ }}) is
+// left as it is.
+export const TEMPLATES = ["vanilla", "vue", "react"];
+export class CreateError extends Error {
+}
+/** The templates folder, next to dist/ (built) and src/ (in Tavora's repository). */
+const TEMPLATES_DIR = fileURLToPath(new URL("../templates/", import.meta.url));
+/** A folder name as a lowercase slug: letters, digits and dashes, starting with a letter. */
+export function slugOf(folder) {
+    const slug = path
+        .basename(path.resolve(folder))
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return /^[a-z]/.test(slug) ? slug.slice(0, 60) : `module-${slug}`.replace(/-+$/, "").slice(0, 60);
+}
+/** What the starter offers when nothing was given: a name and an id from the folder's name. */
+export function defaultsFor(folder) {
+    const slug = slugOf(folder);
+    const name = slug
+        .split("-")
+        .filter(Boolean)
+        .map((word) => word[0].toUpperCase() + word.slice(1))
+        .join(" ");
+    return { id: `my.${slug}`, name: name || "My Module" };
+}
+/** Why an id cannot be used, or null. */
+export function idProblem(id) {
+    if (!isModuleId(id))
+        return "an id looks like publisher.module-name: 2 to 5 parts of lowercase letters, digits and dashes, separated by dots, each starting with a letter";
+    if (id.startsWith("tavora."))
+        return "ids starting with tavora. are Tavora's own";
+    return null;
+}
+/** Why a name cannot be used, or null. */
+export function nameProblem(name) {
+    return name.trim() === "" || name.length > 80 ? "a name is 1 to 80 characters" : null;
+}
+const run = (manager) => (manager === "pnpm" ? "pnpm" : manager === "yarn" ? "yarn" : "npm run");
+const exec = (manager) => (manager === "pnpm" ? "pnpm exec" : manager === "yarn" ? "yarn" : "npx");
+/** Fills the placeholders of one file, escaped for where they stand. */
+function fill(text, file, values) {
+    const escape = file.endsWith(".json")
+        ? (value) => JSON.stringify(value).slice(1, -1)
+        : file.endsWith(".html")
+            ? (value) => value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;")
+            : (value) => value;
+    return text.replace(/\{\{(\w+)\}\}/g, (match, key) => (key in values ? escape(values[key]) : match));
+}
+async function files(root, prefix = "") {
+    const found = [];
+    for (const entry of await readdir(path.join(root, prefix), { withFileTypes: true })) {
+        const relative = path.join(prefix, entry.name);
+        if (entry.isDirectory())
+            found.push(...(await files(root, relative)));
+        else
+            found.push(relative);
+    }
+    return found;
+}
+/** Makes the project and answers with the files it wrote, relative to `dir`. */
+export async function createModule(options) {
+    const problem = idProblem(options.id) ?? nameProblem(options.name);
+    if (problem)
+        throw new CreateError(problem);
+    if (!TEMPLATES.includes(options.template))
+        throw new CreateError(`the template is one of ${TEMPLATES.join(", ")}`);
+    const dir = path.resolve(options.dir);
+    const existing = await readdir(dir).catch(() => null);
+    if (existing && existing.length > 0)
+        throw new CreateError(`${dir} is not empty`);
+    const values = {
+        id: options.id,
+        name: options.name.trim(),
+        description: `${options.name.trim()}, a Tavora module.`,
+        package: slugOf(dir),
+        sdkVersion: VERSIONS.sdk,
+        packVersion: VERSIONS.pack,
+        minTavora: VERSIONS.minTavora,
+        run: run(options.packageManager),
+        exec: exec(options.packageManager),
+    };
+    const written = [];
+    for (const source of ["shared", options.template]) {
+        const root = path.join(TEMPLATES_DIR, source);
+        for (const file of await files(root)) {
+            // npm drops .gitignore from published packages, so it travels as gitignore.
+            const target = file === "gitignore" ? ".gitignore" : file;
+            const text = await readFile(path.join(root, file), "utf8");
+            await mkdir(path.dirname(path.join(dir, target)), { recursive: true });
+            await writeFile(path.join(dir, target), fill(text, target, values));
+            written.push(target.split(path.sep).join("/"));
+        }
+    }
+    return written.sort();
+}
+//# sourceMappingURL=create.js.map

package/dist/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../src/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,0FAA0F;AAC1F,2FAA2F;AAC3F,+FAA+F;AAC/F,iBAAiB;AAEjB,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAU,CAAC;AAe9D,MAAM,OAAO,WAAY,SAAQ,KAAK;CAAG;AAEzC,qFAAqF;AACrF,MAAM,aAAa,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/E,6FAA6F;AAC7F,MAAM,UAAU,MAAM,CAAC,MAAc;IACnC,MAAM,IAAI,GAAG,IAAI;SACd,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;SAC9B,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACpG,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI;SACd,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACrD,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,OAAO,EAAE,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,IAAI,WAAW,EAAE,CAAC;AACzD,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAAE,OAAO,8IAA8I,CAAC;IAC3K,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,4CAA4C,CAAC;IAClF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,IAAI,CAAC;AACxF,CAAC;AAED,MAAM,GAAG,GAAG,CAAC,OAAwC,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAClI,MAAM,IAAI,GAAG,CAAC,OAAwC,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAEpI,wEAAwE;AACxE,SAAS,IAAI,CAAC,IAAY,EAAE,IAAY,EAAE,MAA8B;IACtE,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QACnC,CAAC,CAAC,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YACtB,CAAC,CAAC,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;YACrH,CAAC,CAAC,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC;IAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AAChH,CAAC;AAED,KAAK,UAAU,KAAK,CAAC,IAAY,EAAE,MAAM,GAAG,EAAE;IAC5C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACpF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,KAAK,CAAC,WAAW,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;;YACjE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAsB;IACvD,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,IAAI,OAAO;QAAE,MAAM,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,WAAW,CAAC,0BAA0B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,WAAW,CAAC,GAAG,GAAG,eAAe,CAAC,CAAC;IAElF,MAAM,MAAM,GAA2B;QACrC,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE;QACzB,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,oBAAoB;QACvD,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC;QACpB,UAAU,EAAE,QAAQ,CAAC,GAAG;QACxB,WAAW,EAAE,QAAQ,CAAC,IAAI;QAC1B,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC;QAChC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC;KACnC,CAAC;IACF,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAC9C,KAAK,MAAM,IAAI,IAAI,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,4EAA4E;YAC5E,MAAM,MAAM,GAAG,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;YAC1D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;YAC3D,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACvE,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;AACxB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+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":""}

package/dist/index.js

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+// npm create @tavora/module [folder] -- [--template vanilla|vue|react] [--id publisher.name] [--name "Name"] [--yes]
+// pnpm create @tavora/module [folder] [--template ...]
+// Makes a new Tavora module project. Asks for what was not given, unless --yes (or no terminal):
+// where (this empty folder or a new one in it) and the template are picked with the arrow keys.
+import { readdir } from "node:fs/promises";
+import path from "node:path";
+import { parseArgs } from "node:util";
+import { cancel, intro, isCancel, note, outro, select, text } from "@clack/prompts";
+import { createModule, CreateError, defaultsFor, idProblem, nameProblem, TEMPLATES } from "./create.js";
+const USAGE = "usage: npm create @tavora/module [folder] -- [--template vanilla|vue|react] [--id publisher.module-name] [--name \"Module name\"] [--yes]";
+const TEMPLATE_LABELS = { vanilla: "Vanilla TypeScript", vue: "Vue", react: "React" };
+/** The package manager that ran the starter, so the printed commands fit. */
+function packageManager() {
+    const agent = process.env.npm_config_user_agent ?? "";
+    return agent.startsWith("pnpm") ? "pnpm" : agent.startsWith("yarn") ? "yarn" : "npm";
+}
+/** Thrown when the developer pressed Ctrl+C or Esc in a question. */
+class Cancelled extends Error {
+}
+function answer(value) {
+    if (isCancel(value))
+        throw new Cancelled();
+    return value;
+}
+async function isEmptyFolder(dir) {
+    return ((await readdir(dir).catch(() => null))?.length ?? -1) === 0;
+}
+async function main() {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            allowPositionals: true,
+            options: { template: { type: "string", short: "t" }, id: { type: "string" }, name: { type: "string" }, yes: { type: "boolean", short: "y" }, help: { type: "boolean", short: "h" } },
+        });
+    }
+    catch (error) {
+        console.error(`${error.message}\n${USAGE}`);
+        return 2;
+    }
+    const { values, positionals } = parsed;
+    if (values.help || positionals.length > 1) {
+        console.log(USAGE);
+        return values.help ? 0 : 2;
+    }
+    if (values.template !== undefined && !TEMPLATES.includes(values.template)) {
+        console.error(`create-module: the template is one of ${TEMPLATES.join(", ")}`);
+        return 2;
+    }
+    const interactive = !values.yes && process.stdin.isTTY === true;
+    const here = process.cwd();
+    const emptyHere = await isEmptyFolder(here);
+    try {
+        if (interactive)
+            intro("A new Tavora module");
+        // Where: the empty folder the developer is in, or a new folder in it.
+        let folder = positionals[0];
+        if (folder === undefined && interactive) {
+            const where = emptyHere
+                ? answer(await select({
+                    message: "Where should the project go?",
+                    options: [
+                        { value: ".", label: `This folder (${path.basename(here)})`, hint: "it is empty" },
+                        { value: "new", label: "A new folder in it" },
+                    ],
+                }))
+                : "new";
+            folder =
+                where === "."
+                    ? "."
+                    : answer(await text({
+                        message: "Folder name for the project",
+                        placeholder: "my-tavora-module",
+                        defaultValue: "my-tavora-module",
+                        validate: (value) => (value && /[\\/:*?"<>|]/.test(value) ? "a folder name, without \\ / : * ? \" < > |" : undefined),
+                    }));
+        }
+        folder ??= emptyHere ? "." : "my-tavora-module";
+        const defaults = defaultsFor(folder);
+        const name = values.name ??
+            (interactive
+                ? answer(await text({ message: "Module name", placeholder: defaults.name, defaultValue: defaults.name, validate: (value) => (value ? (nameProblem(value) ?? undefined) : undefined) }))
+                : defaults.name);
+        const id = values.id ??
+            (interactive
+                ? answer(await text({
+                    message: "Module id (publisher.module-name)",
+                    placeholder: defaults.id,
+                    defaultValue: defaults.id,
+                    validate: (value) => (value ? (idProblem(value) ?? undefined) : undefined),
+                }))
+                : defaults.id);
+        const template = (values.template ??
+            (interactive
+                ? answer(await select({ message: "Template", options: TEMPLATES.map((value) => ({ value, label: TEMPLATE_LABELS[value] })), initialValue: "vanilla" }))
+                : "vanilla"));
+        const manager = packageManager();
+        await createModule({ dir: folder, id, name, template, packageManager: manager });
+        const run = manager === "npm" ? "npm run" : manager;
+        const project = path.resolve(folder);
+        const steps = [
+            ...(folder === "." ? [] : [`cd ${folder}`]),
+            `${manager} install`,
+            `${run} dev        # builds, then rebuilds on every change: leave it running`,
+            "",
+            "Then in Tavora: Settings > Development > Add a development folder…",
+            `and pick ${project}`,
+            ...(folder === "." ? [] : [`(or ${here}, to load every module project you keep in it)`]),
+        ];
+        if (interactive) {
+            note(steps.join("\n"), "Next");
+            outro(`Made ${name} (${id}). The README says how to share it and show your name on it.`);
+        }
+        else {
+            console.log(`\nMade ${name} (${id}) in ${project}.\n\nNext:\n${steps.map((line) => (line ? `  ${line}` : "")).join("\n")}\n`);
+            console.log("The README says how to share the module and show your name on it.");
+        }
+        return 0;
+    }
+    catch (error) {
+        if (error instanceof Cancelled) {
+            cancel("Nothing was made.");
+            return 1;
+        }
+        if (error instanceof CreateError) {
+            console.error(`create-module: ${error.message}`);
+            return 1;
+        }
+        throw error;
+    }
+}
+main().then((code) => (process.exitCode = code), (error) => {
+    console.error(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/versions.d.ts

@@ -0,0 +1,6 @@
+export declare const VERSIONS: {
+    readonly sdk: "0.2.5";
+    readonly pack: "0.1.0";
+    readonly minTavora: "0.17.19";
+};
+//# sourceMappingURL=versions.d.ts.map

package/dist/versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../src/versions.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,QAAQ;;;;CAIX,CAAC"}

package/dist/versions.js

@@ -0,0 +1,9 @@
+// What a new module starts with: the SDK and pack versions released together with this starter,
+// and the oldest Tavora that has everything that SDK offers (its MIN_TAVORA). A test keeps these
+// equal to the packages in Tavora's repository, so a release never ships an old starter.
+export const VERSIONS = {
+    sdk: "0.2.5",
+    pack: "0.1.0",
+    minTavora: "0.17.19",
+};
+//# sourceMappingURL=versions.js.map

package/dist/versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.js","sourceRoot":"","sources":["../src/versions.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,iGAAiG;AACjG,yFAAyF;AACzF,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,GAAG,EAAE,OAAO;IACZ,IAAI,EAAE,OAAO;IACb,SAAS,EAAE,SAAS;CACZ,CAAC"}

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "@tavora/create-module",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Makes a new Tavora module project: npm create @tavora/module.",
+  "type": "module",
+  "keywords": [
+    "tavora",
+    "module",
+    "create",
+    "starter",
+    "template"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wellbrained/tavora.git",
+    "directory": "packages/create-module"
+  },
+  "homepage": "https://docs.mytavora.app/guide/getting-started",
+  "bugs": "https://github.com/wellbrained/tavora/issues",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "create-module": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=22.12"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.8.1",
+    "@tavora/module-schema": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.5",
+    "@tavora/sdk": "0.2.5"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit -p ."
+  }
 }

package/templates/react/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "{{package}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "vite build",
+    "zip": "tavora-pack ."
+  },
+  "dependencies": {
+    "@tavora/sdk": "^{{sdkVersion}}",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0"
+  },
+  "devDependencies": {
+    "@tavora/pack": "^{{packVersion}}",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "@vitejs/plugin-react": "^6.1.2",
+    "typescript": "^5.9.3",
+    "vite": "^8.3.4"
+  }
+}

package/templates/react/src/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>{{name}}</title>
+    <link rel="stylesheet" href="./style.css" />
+    <script type="module" src="./main.tsx"></script>
+  </head>
+  <body>
+    <div id="app"></div>
+  </body>
+</html>

package/templates/react/src/main.tsx

@@ -0,0 +1,67 @@
+import { connect, type TavoraSDK, type TavoraTheme } from "@tavora/sdk";
+import { useEffect, useState } from "react";
+import { createRoot } from "react-dom/client";
+
+// This page runs inside a Tavora panel; in a normal browser connect() fails. Build it and add this
+// folder in Tavora (Settings > Development > Add a development folder) to see it.
+
+/** Your texts in English and German; Tavora says which language the player uses. */
+const TEXTS = {
+  en: { connecting: "Connecting to Tavora…", playing: "Playing {game}.", clicked: "Clicked {count} times in this game." },
+  de: { connecting: "Verbinde mit Tavora …", playing: "Du spielst {game}.", clicked: "{count}-mal in diesem Spiel geklickt." },
+};
+type Language = keyof typeof TEXTS;
+const text = (language: Language, key: keyof (typeof TEXTS)["en"], params: Record<string, string | number> = {}) =>
+  TEXTS[language][key].replace(/\{(\w+)\}/g, (match, name: string) => String(params[name] ?? match));
+
+/** Tavora's theme as CSS variables (--background, --foreground, --primary, ...), so the module looks like Tavora. */
+function applyTheme(theme: TavoraTheme) {
+  const root = document.documentElement;
+  for (const [name, value] of Object.entries(theme.tokens)) root.style.setProperty(`--${name}`, value);
+  root.style.setProperty("--radius", `${theme.radius}px`);
+  root.style.colorScheme = theme.mode;
+}
+
+function App() {
+  const [tavora, setTavora] = useState<TavoraSDK | null>(null);
+  const [language, setLanguage] = useState<Language>("en");
+  const [game, setGame] = useState("");
+  const [count, setCount] = useState(0);
+  const [failed, setFailed] = useState<string | null>(null);
+
+  useEffect(() => {
+    const pick = (code: string): Language => (code.startsWith("de") ? "de" : "en");
+    connect().then(
+      async (sdk) => {
+        applyTheme(await sdk.ui.getTheme());
+        sdk.ui.onThemeChange(applyTheme);
+        setLanguage(pick(await sdk.ui.getLanguage()));
+        sdk.ui.onLanguageChange((code) => setLanguage(pick(code)));
+        setGame((await sdk.game.getCurrent()).displayName);
+        // storage keeps small settings for this module in the current game.
+        setCount((await sdk.storage.get<number>("count")) ?? 0);
+        setTavora(sdk);
+      },
+      (error: unknown) => setFailed(`Not connected to Tavora: ${error instanceof Error ? error.message : String(error)}`),
+    );
+  }, []);
+
+  const add = () => {
+    const next = count + 1;
+    setCount(next);
+    void tavora?.storage.set("count", next);
+  };
+
+  const status = failed ?? (tavora ? `${text(language, "playing", { game })} ${text(language, "clicked", { count })}` : text(language, "connecting"));
+  return (
+    <main>
+      <h1>{document.title}</h1>
+      <p id="status">{status}</p>
+      <button type="button" disabled={!tavora} onClick={add}>
+        +1
+      </button>
+    </main>
+  );
+}
+
+createRoot(document.getElementById("app")!).render(<App />);

package/templates/react/tsconfig.json

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

package/templates/react/vite.config.ts

@@ -0,0 +1,15 @@
+import react from "@vitejs/plugin-react";
+import { defineConfig } from "vite";
+
+// A module ships as one self-contained folder: relative paths, nothing loaded from the internet.
+export default defineConfig({
+  root: "src",
+  base: "./",
+  plugins: [react()],
+  build: {
+    outDir: "../dist",
+    emptyOutDir: true,
+    target: "chrome130",
+    modulePreload: { polyfill: false },
+  },
+});

package/templates/shared/README.md

@@ -0,0 +1,36 @@
+# {{name}}
+
+A [Tavora](https://mytavora.app) module, made with `@tavora/create-module`. Tavora shows it in a panel next to a game; it talks to Tavora through [`@tavora/sdk`](https://docs.mytavora.app/api/).
+
+## Develop
+
+```sh
+{{run}} install
+{{run}} dev
+```
+
+`dev` builds the module into `dist/` and builds it again on every change. Leave it running. In Tavora, open **Settings > Development > Add a development folder…** and choose this folder, or the folder you keep all your module projects in. Add the module to a game with **Add module**; its panels reload by themselves after every build.
+
+- `tavora.module.json` is the manifest: its id, name, the panel's smallest size, and what it asks the player for (websites to reach, connectors). See the [manifest reference](https://docs.mytavora.app/reference/manifest).
+- `minTavora` is the oldest Tavora the module works with. Raise it when you use something newer from the SDK (the [changelog](https://docs.mytavora.app/reference/changelog) says which Tavora added what).
+
+## Share
+
+```sh
+{{run}} build
+{{run}} zip
+```
+
+`zip` packs the built module into `{{id}}-0.1.0.zip`, signed with your publisher key. The first run makes the key in `~/.tavora/publisher-key.pem`. **Back it up and never share it**: the data your module saves for players belongs to that key, so a new key means a new publisher. Players install the zip with **Settings > Modules > Install from zip**; a newer zip signed with the same key updates it.
+
+## Show your name instead of a fingerprint
+
+In Tavora, sign in under **Settings > Account**, choose a developer name under **Module developer** and press **Link a publisher key**. Then run the command it shows here, for example:
+
+```sh
+{{exec}} tavora-pack link ABCD-EFGH
+```
+
+Players then see your modules as "by" your name.
+
+More in the [developer docs](https://docs.mytavora.app/).

package/templates/shared/gitignore

@@ -0,0 +1,4 @@
+node_modules
+dist
+*.zip
+*.pem

package/templates/shared/src/style.css

@@ -0,0 +1,17 @@
+/* Tavora gives the page its fonts and the look of buttons and fields. The colours come from
+   Tavora's theme as CSS variables (main.ts sets them), so the module matches every theme. */
+body {
+  margin: 0;
+  background: var(--background);
+  color: var(--foreground);
+}
+main {
+  padding: 16px;
+}
+h1 {
+  margin: 0 0 8px;
+  font-size: 16px;
+}
+#status {
+  color: var(--muted-foreground);
+}

package/templates/shared/tavora.module.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://docs.mytavora.app/schema/tavora.module.schema.json",
+  "id": "{{id}}",
+  "name": "{{name}}",
+  "description": "{{description}}",
+  "version": "0.1.0",
+  "apiVersion": "1",
+  "minTavora": "{{minTavora}}",
+  "entry": "dist/index.html",
+  "games": [],
+  "viewport": { "minWidth": 240, "minHeight": 160 },
+  "permissions": { "network": [] }
+}

package/templates/vanilla/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "{{package}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "vite build",
+    "zip": "tavora-pack ."
+  },
+  "dependencies": {
+    "@tavora/sdk": "^{{sdkVersion}}"
+  },
+  "devDependencies": {
+    "@tavora/pack": "^{{packVersion}}",
+    "typescript": "^5.9.3",
+    "vite": "^8.3.4"
+  }
+}

package/templates/vanilla/src/index.html

@@ -0,0 +1,16 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>{{name}}</title>
+    <link rel="stylesheet" href="./style.css" />
+    <script type="module" src="./main.ts"></script>
+  </head>
+  <body>
+    <main>
+      <h1>{{name}}</h1>
+      <p id="status">Connecting to Tavora…</p>
+      <button type="button" id="counter" disabled>+1</button>
+    </main>
+  </body>
+</html>

package/templates/vanilla/src/main.ts

@@ -0,0 +1,54 @@
+import { connect, type TavoraSDK, type TavoraTheme } from "@tavora/sdk";
+
+// This page runs inside a Tavora panel; in a normal browser connect() fails. Build it and add this
+// folder in Tavora (Settings > Development > Add a development folder) to see it.
+
+const status = document.querySelector<HTMLParagraphElement>("#status")!;
+const counter = document.querySelector<HTMLButtonElement>("#counter")!;
+
+/** Your texts in English and German; Tavora says which language the player uses. */
+const TEXTS = {
+  en: { playing: "Playing {game}.", clicked: "Clicked {count} times in this game." },
+  de: { playing: "Du spielst {game}.", clicked: "{count}-mal in diesem Spiel geklickt." },
+};
+let language: keyof typeof TEXTS = "en";
+const text = (key: keyof (typeof TEXTS)["en"], params: Record<string, string | number>) =>
+  TEXTS[language][key].replace(/\{(\w+)\}/g, (match, name: string) => String(params[name] ?? match));
+
+/** Tavora's theme as CSS variables (--background, --foreground, --primary, ...), so the module looks like Tavora. */
+function applyTheme(theme: TavoraTheme) {
+  const root = document.documentElement;
+  for (const [name, value] of Object.entries(theme.tokens)) root.style.setProperty(`--${name}`, value);
+  root.style.setProperty("--radius", `${theme.radius}px`);
+  root.style.colorScheme = theme.mode;
+}
+
+async function start(tavora: TavoraSDK) {
+  applyTheme(await tavora.ui.getTheme());
+  tavora.ui.onThemeChange(applyTheme);
+  const setLanguage = (code: string) => (language = code.startsWith("de") ? "de" : "en");
+  setLanguage(await tavora.ui.getLanguage());
+
+  const game = await tavora.game.getCurrent();
+  // storage keeps small settings for this module in the current game.
+  let count = (await tavora.storage.get<number>("count")) ?? 0;
+  const render = () => {
+    status.textContent = `${text("playing", { game: game.displayName })} ${text("clicked", { count })}`;
+  };
+  tavora.ui.onLanguageChange((code) => {
+    setLanguage(code);
+    render();
+  });
+  render();
+
+  counter.disabled = false;
+  counter.addEventListener("click", async () => {
+    count += 1;
+    render();
+    await tavora.storage.set("count", count);
+  });
+}
+
+connect().then(start, (error: unknown) => {
+  status.textContent = `Not connected to Tavora: ${error instanceof Error ? error.message : String(error)}`;
+});

package/templates/vanilla/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "strict": true,
+    "noEmit": true,
+    "isolatedModules": true,
+    "skipLibCheck": true
+  },
+  "include": ["src", "vite.config.ts"]
+}

package/templates/vanilla/vite.config.ts

@@ -0,0 +1,13 @@
+import { defineConfig } from "vite";
+
+// A module ships as one self-contained folder: relative paths, nothing loaded from the internet.
+export default defineConfig({
+  root: "src",
+  base: "./",
+  build: {
+    outDir: "../dist",
+    emptyOutDir: true,
+    target: "chrome130",
+    modulePreload: { polyfill: false },
+  },
+});

package/templates/vue/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "{{package}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "vite build",
+    "zip": "tavora-pack ."
+  },
+  "dependencies": {
+    "@tavora/sdk": "^{{sdkVersion}}",
+    "vue": "^3.5.43"
+  },
+  "devDependencies": {
+    "@tavora/pack": "^{{packVersion}}",
+    "@vitejs/plugin-vue": "^6.0.9",
+    "typescript": "^5.9.3",
+    "vite": "^8.3.4"
+  }
+}

package/templates/vue/src/App.vue

@@ -0,0 +1,60 @@
+<script setup lang="ts">
+// This page runs inside a Tavora panel; in a normal browser connect() fails. Build it and add this
+// folder in Tavora (Settings > Development > Add a development folder) to see it.
+import { connect, type TavoraSDK, type TavoraTheme } from "@tavora/sdk";
+import { computed, onMounted, ref, shallowRef } from "vue";
+
+/** Your texts in English and German; Tavora says which language the player uses. */
+const TEXTS = {
+  en: { connecting: "Connecting to Tavora…", playing: "Playing {game}.", clicked: "Clicked {count} times in this game." },
+  de: { connecting: "Verbinde mit Tavora …", playing: "Du spielst {game}.", clicked: "{count}-mal in diesem Spiel geklickt." },
+};
+const language = ref<keyof typeof TEXTS>("en");
+const text = (key: keyof (typeof TEXTS)["en"], params: Record<string, string | number> = {}) =>
+  TEXTS[language.value][key].replace(/\{(\w+)\}/g, (match, name: string) => String(params[name] ?? match));
+
+const title = document.title;
+const tavora = shallowRef<TavoraSDK | null>(null);
+const game = ref("");
+const count = ref(0);
+const failed = ref<string | null>(null);
+const status = computed(() => (failed.value ? failed.value : tavora.value ? `${text("playing", { game: game.value })} ${text("clicked", { count: count.value })}` : text("connecting")));
+
+/** Tavora's theme as CSS variables (--background, --foreground, --primary, ...), so the module looks like Tavora. */
+function applyTheme(theme: TavoraTheme) {
+  const root = document.documentElement;
+  for (const [name, value] of Object.entries(theme.tokens)) root.style.setProperty(`--${name}`, value);
+  root.style.setProperty("--radius", `${theme.radius}px`);
+  root.style.colorScheme = theme.mode;
+}
+
+onMounted(async () => {
+  try {
+    const sdk = await connect();
+    applyTheme(await sdk.ui.getTheme());
+    sdk.ui.onThemeChange(applyTheme);
+    const setLanguage = (code: string) => (language.value = code.startsWith("de") ? "de" : "en");
+    setLanguage(await sdk.ui.getLanguage());
+    sdk.ui.onLanguageChange(setLanguage);
+    game.value = (await sdk.game.getCurrent()).displayName;
+    // storage keeps small settings for this module in the current game.
+    count.value = (await sdk.storage.get<number>("count")) ?? 0;
+    tavora.value = sdk;
+  } catch (error) {
+    failed.value = `Not connected to Tavora: ${error instanceof Error ? error.message : String(error)}`;
+  }
+});
+
+async function add() {
+  count.value += 1;
+  await tavora.value?.storage.set("count", count.value);
+}
+</script>
+
+<template>
+  <main>
+    <h1>{{ title }}</h1>
+    <p id="status">{{ status }}</p>
+    <button type="button" :disabled="!tavora" @click="add">+1</button>
+  </main>
+</template>

package/templates/vue/src/env.d.ts

@@ -0,0 +1,5 @@
+declare module "*.vue" {
+  import type { DefineComponent } from "vue";
+  const component: DefineComponent;
+  export default component;
+}

package/templates/vue/src/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>{{name}}</title>
+    <link rel="stylesheet" href="./style.css" />
+    <script type="module" src="./main.ts"></script>
+  </head>
+  <body>
+    <div id="app"></div>
+  </body>
+</html>

package/templates/vue/src/main.ts

@@ -0,0 +1,4 @@
+import { createApp } from "vue";
+import App from "./App.vue";
+
+createApp(App).mount("#app");

package/templates/vue/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "jsx": "preserve",
+    "strict": true,
+    "noEmit": true,
+    "isolatedModules": true,
+    "skipLibCheck": true
+  },
+  "include": ["src", "vite.config.ts"]
+}

package/templates/vue/vite.config.ts

@@ -0,0 +1,15 @@
+import vue from "@vitejs/plugin-vue";
+import { defineConfig } from "vite";
+
+// A module ships as one self-contained folder: relative paths, nothing loaded from the internet.
+export default defineConfig({
+  root: "src",
+  base: "./",
+  plugins: [vue()],
+  build: {
+    outDir: "../dist",
+    emptyOutDir: true,
+    target: "chrome130",
+    modulePreload: { polyfill: false },
+  },
+});