@antelopejs/dms-frontend 0.9.3 → 0.10.1

package/dist/verify-source-runner.js

@@ -37,90 +37,29 @@ const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const cli_1 = require("@antelopejs/core/cli");
 const child_output_1 = require("./child-output");
+const ensure_1 = require("./internal/ensure");
+const guards_1 = require("./internal/guards");
+const vite_manifest_1 = require("./internal/vite-manifest");
 const common_1 = require("./common");
 const output_1 = require("./output");
 const temporary_workspace_1 = require("./temporary-workspace");
+const verify_source_workspace_1 = require("./verify-source-workspace");
+const verify_source_client_bundle_1 = require("./verify-source-client-bundle");
 const verify_source_build_1 = require("./verify-source-build");
 const verify_source_result_1 = require("./verify-source-result");
 const verify_source_sources_1 = require("./verify-source-sources");
 const vite_output_1 = require("./vite-output");
 const EMAIL_BUILD_SIZE_CEILING_BYTES = 256 * 1024;
 const NON_EMAIL_RUNTIME_PATTERN = /DisplayRichText|ApexCharts|Tiptap|FlowCanvas|app\/.*table|components\/table/i;
-const LAZY_LIBRARIES = [
-    { name: "ApexCharts", pattern: /ApexCharts/ },
-    { name: "Tiptap", pattern: /tiptap/i },
-];
-const RUNTIME_MARKERS = ["auth/login", "DefaultLayout", "error.500.title"];
-function readJson(path) {
-    return JSON.parse((0, node_fs_1.readFileSync)(path, "utf8"));
-}
-function ensure(condition, title, reason) {
-    if (!condition)
-        throw new cli_1.CliError({ title, reason });
-}
-function removeDevelopmentDependencies(root) {
-    const packagePath = (0, node_path_1.join)(root, "package.json");
-    if (!(0, node_fs_1.existsSync)(packagePath))
-        return;
-    const packageData = readJson(packagePath);
-    delete packageData.devDependencies;
-    (0, node_fs_1.writeFileSync)(packagePath, `${JSON.stringify(packageData, null, 2)}\n`);
-}
-function materializeWorkspace(workspace, layers, localPackages) {
-    const templateRoot = (0, node_path_1.join)((0, common_1.getPackageRoot)(), "templates", "vue");
-    const templateFiles = (0, node_fs_1.readdirSync)(templateRoot).filter((file) => !file.startsWith("npmrc"));
-    for (const file of templateFiles)
-        (0, node_fs_1.cpSync)((0, node_path_1.join)(templateRoot, file), (0, node_path_1.join)(workspace, file), {
-            recursive: true,
-        });
-    (0, common_1.materializeLayers)(workspace, layers);
-    const registry = (0, common_1.createFrontendModuleRegistry)(workspace, layers);
-    registry.modules.forEach((module) => {
-        removeDevelopmentDependencies(module.root);
-    });
-    (0, common_1.writeFrontendModuleRegistry)(workspace, layers);
-    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(workspace, "dms-main.css"), '@import "tailwindcss";\n@import "@nuxt/ui";\n');
-    (0, common_1.writeWorkspacePackageJson)(workspace, layers);
-    const packagePath = (0, node_path_1.join)(workspace, "package.json");
-    const workspacePackage = readJson(packagePath);
-    workspacePackage.pnpm = {
-        overrides: {
-            ...Object.fromEntries(layers.map((layer) => [layer.packageName, "workspace:*"])),
-            ...Object.fromEntries(Object.entries(localPackages).map(([name, path]) => [
-                name,
-                `link:${(0, node_path_1.resolve)(path)}`,
-            ])),
-        },
-    };
-    (0, node_fs_1.writeFileSync)(packagePath, `${JSON.stringify(workspacePackage, null, 2)}\n`);
-}
-function checkClientBundle(workspace) {
-    const clientRoot = (0, node_path_1.join)(workspace, "dist", "client");
-    const manifest = readJson((0, node_path_1.join)(clientRoot, ".vite", "manifest.json"));
-    const mainEntry = Object.values(manifest).find((entry) => entry.isEntry);
-    ensure(mainEntry !== undefined, "The Vite manifest names no entry chunk");
-    const mainJavascript = (0, node_fs_1.readFileSync)((0, node_path_1.join)(clientRoot, mainEntry.file), "utf8");
-    const javascript = (0, node_fs_1.readdirSync)((0, node_path_1.join)(clientRoot, "assets"))
-        .filter((file) => file.endsWith(".js"))
-        .map((file) => (0, node_fs_1.readFileSync)((0, node_path_1.join)(clientRoot, "assets", file), "utf8"))
-        .join("\n");
-    for (const { name, pattern } of LAZY_LIBRARIES) {
-        ensure(!pattern.test(mainJavascript), `The main chunk bundles ${name}`, "It must stay in a lazily loaded chunk.");
-        ensure(pattern.test(javascript), `No client chunk bundles ${name}`);
-    }
-    ensure(Object.keys(manifest).some((source) => source.endsWith("/kpi/KpiCard.vue")), "DmsKpiCard is not reachable at runtime");
-    for (const marker of RUNTIME_MARKERS)
-        ensure(javascript.includes(marker), `${marker} is not reachable at runtime`);
-}
 async function checkServerModulesBundle(workspace) {
     const root = (0, node_path_1.join)(workspace, "dist", "server-modules");
     const javascript = (0, node_fs_1.readdirSync)(root, { recursive: true, encoding: "utf8" })
         .filter((file) => file.endsWith(".js"))
         .map((file) => (0, node_fs_1.readFileSync)((0, node_path_1.join)(root, file), "utf8"))
         .join("\n");
-    ensure(!/\.vue["'?]|createApp\(|DefaultLayout/.test(javascript), "The server modules bundle loads application code", "A dms.server.ts imports server code only, never .vue files or dms.frontend.ts.");
-    const { serverModules } = await Promise.resolve(`${(0, node_path_1.join)(root, "server-modules.generated.js")}`).then(s => __importStar(require(s)));
-    ensure(Array.isArray(serverModules), "The server modules bundle exports none");
+    (0, ensure_1.ensure)(!/\.vue["'?]|createApp\(|DefaultLayout/.test(javascript), "The server modules bundle loads application code", "A dms.server.ts imports server code only, never .vue files or dms.frontend.ts.");
+    const serverModules = (await Promise.resolve(`${(0, node_path_1.join)(root, "server-modules.generated.js")}`).then(s => __importStar(require(s)))).serverModules;
+    (0, ensure_1.ensure)(Array.isArray(serverModules), "The server modules bundle exports none");
     return `${(0, cli_1.pluralize)(serverModules.length, "server module")}, ${(0, output_1.formatSize)(Buffer.byteLength(javascript))} JS`;
 }
 const EMAIL_CASES = [
@@ -177,19 +116,19 @@ const EMAIL_CASES = [
 ];
 const BROWSER_ONLY_REASON = "It must not load rich text, charts, tables or flows.";
 function checkLayoutEmail(html) {
-    ensure(/<meta charset="utf-8"/.test(html), "EmailLayout declares no UTF-8 charset");
-    ensure(/images\/antelope-logo\/light\.svg/.test(html), "EmailLayout renders no logo");
-    ensure(!/<h1[^>]*\bas=/.test(html), "EmailLayout leaks an `as` attribute onto its heading");
+    (0, ensure_1.ensure)(/<meta charset="utf-8"/.test(html), "EmailLayout declares no UTF-8 charset");
+    (0, ensure_1.ensure)(/images\/antelope-logo\/light\.svg/.test(html), "EmailLayout renders no logo");
+    (0, ensure_1.ensure)(!/<h1[^>]*\bas=/.test(html), "EmailLayout leaks an `as` attribute onto its heading");
 }
 async function checkEmailContracts(workspace) {
     const emailRoot = (0, node_path_1.join)(workspace, "dist", "server");
     const emailManifestContent = (0, node_fs_1.readFileSync)((0, node_path_1.join)(emailRoot, ".vite", "manifest.json"), "utf8");
-    ensure(!NON_EMAIL_RUNTIME_PATTERN.test(emailManifestContent), "The e-mail manifest references browser-only modules", BROWSER_ONLY_REASON);
-    const emailManifest = JSON.parse(emailManifestContent);
+    (0, ensure_1.ensure)(!NON_EMAIL_RUNTIME_PATTERN.test(emailManifestContent), "The e-mail manifest references browser-only modules", BROWSER_ONLY_REASON);
+    const emailManifest = (0, vite_manifest_1.parseViteManifest)(emailManifestContent, "e-mail build manifest");
     const emailJavascriptFiles = [
         ...new Set([
             "email-renderer.js",
-            ...Object.values(emailManifest)
+            ...emailManifest
                 .map((entry) => entry.file)
                 .filter((file) => file.endsWith(".js")),
         ]),
@@ -197,18 +136,18 @@ async function checkEmailContracts(workspace) {
     const emailJavascript = emailJavascriptFiles
         .map((file) => (0, node_fs_1.readFileSync)((0, node_path_1.join)(emailRoot, file), "utf8"))
         .join("\n");
-    ensure(!NON_EMAIL_RUNTIME_PATTERN.test(emailJavascript), "The e-mail bundle loads browser-only modules", BROWSER_ONLY_REASON);
+    (0, ensure_1.ensure)(!NON_EMAIL_RUNTIME_PATTERN.test(emailJavascript), "The e-mail bundle loads browser-only modules", BROWSER_ONLY_REASON);
     const emailBuildSize = Buffer.byteLength(emailJavascript);
     const emailLocaleBytes = (0, node_fs_1.readdirSync)((0, node_path_1.join)(emailRoot, "locales")).reduce((total, file) => total + (0, node_fs_1.readFileSync)((0, node_path_1.join)(emailRoot, "locales", file)).byteLength, 0);
     const limit = (0, output_1.formatSize)(EMAIL_BUILD_SIZE_CEILING_BYTES);
-    ensure(emailBuildSize <= EMAIL_BUILD_SIZE_CEILING_BYTES, `The e-mail bundle is ${(0, output_1.formatSize)(emailBuildSize)} of JavaScript`, `The limit is ${limit}.`);
+    (0, ensure_1.ensure)(emailBuildSize <= EMAIL_BUILD_SIZE_CEILING_BYTES, `The e-mail bundle is ${(0, output_1.formatSize)(emailBuildSize)} of JavaScript`, `The limit is ${limit}.`);
     const { renderEmail } = await Promise.resolve(`${(0, node_path_1.join)(emailRoot, "email-renderer.js")}`).then(s => __importStar(require(s)));
     for (const emailCase of EMAIL_CASES) {
         const html = await renderEmail(emailCase.name, emailCase.props);
-        ensure(html.startsWith("<!doctype html>"), `${emailCase.name} does not render a full HTML document`);
+        (0, ensure_1.ensure)((0, guards_1.isText)(html) && html.startsWith("<!doctype html>"), `${emailCase.name} does not render a full HTML document`);
         if (emailCase.name === "EmailLayout")
             checkLayoutEmail(html);
-        ensure(html.includes(emailCase.marker), `${emailCase.name} does not render its props`, `Its HTML lacks ${emailCase.marker}.`);
+        (0, ensure_1.ensure)(html.includes(emailCase.marker), `${emailCase.name} does not render its props`, `Its HTML lacks ${emailCase.marker}.`);
     }
     return [
         "E-mail contracts hold",
@@ -219,18 +158,6 @@ async function checkEmailContracts(workspace) {
 }
 const LINE_BREAK = /\r?\n/;
 const STACK_TRACE_HINT = "Run with --verbose for the full trace.";
-function describeError(error, isVerbose) {
-    if (error instanceof cli_1.CliError)
-        return error.problem;
-    if (!(error instanceof Error))
-        return { title: String(error) };
-    const [title] = error.message.split(LINE_BREAK);
-    const stack = (error.stack ?? "").split(LINE_BREAK);
-    return {
-        title: title || error.name,
-        details: isVerbose ? stack : [STACK_TRACE_HINT],
-    };
-}
 async function verifySources() {
     const options = (0, verify_source_sources_1.readSourceOptions)();
     const { layers, coreLayer } = (0, verify_source_sources_1.readSources)(options);
@@ -247,11 +174,11 @@ async function verifySources() {
         env: { ...process.env, [vite_output_1.VITE_LOG_LEVEL_VARIABLE]: (0, vite_output_1.viteLogLevel)(isVerbose) },
     };
     const tasks = (0, cli_1.getProcessTasks)();
-    await tasks.run(`Materializing ${(0, cli_1.pluralize)(layers.length, "module")}`, async () => materializeWorkspace(workspace, layers, options.localPackages), { done: `Materialized ${(0, cli_1.pluralize)(layers.length, "module")}` });
+    await tasks.run(`Materializing ${(0, cli_1.pluralize)(layers.length, "module")}`, async () => (0, verify_source_workspace_1.materializeWorkspace)(workspace, layers, options.localPackages), { done: `Materialized ${(0, cli_1.pluralize)(layers.length, "module")}` });
     await (0, common_1.installDeps)(workspace, context.mapLine, ["--ignore-scripts"]);
     await (0, verify_source_build_1.prepareTypes)(context);
     await (0, verify_source_build_1.buildAndTypeCheck)(context);
-    await tasks.run("Checking the client bundle", async () => checkClientBundle(workspace), { done: "Client bundle checked", failed: "Client bundle check failed" });
+    await tasks.run("Checking the client bundle", async () => (0, verify_source_client_bundle_1.checkClientBundle)(workspace), { done: "Client bundle checked", failed: "Client bundle check failed" });
     await tasks.run("Checking the e-mail contracts", async () => checkEmailContracts(workspace), { done: (line) => line, failed: "E-mail contracts failed" });
     await tasks.run("Checking the server modules", async () => checkServerModulesBundle(workspace), { done: (line) => line, failed: "Server modules check failed" });
     return { ok: true, modules: layers.length };
@@ -276,7 +203,22 @@ async function main() {
             process.exitCode = error.exitCode;
             return;
         }
-        result = { ok: false, problem: describeError(error, (0, cli_1.isVerboseRun)()) };
+        let problem;
+        if (error instanceof cli_1.CliError) {
+            problem = error.problem;
+        }
+        else if (error instanceof Error) {
+            const [title] = error.message.split(LINE_BREAK);
+            const stack = (error.stack ?? "").split(LINE_BREAK);
+            problem = {
+                title: title || error.name,
+                details: (0, cli_1.isVerboseRun)() ? stack : [STACK_TRACE_HINT],
+            };
+        }
+        else {
+            problem = { title: String(error) };
+        }
+        result = { ok: false, problem };
     }
     if (process.send) {
         process.exitCode = result.ok ? 0 : 1;

package/dist/verify-source-sources.js

@@ -5,18 +5,20 @@ exports.readSources = readSources;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const common_1 = require("./common");
+const guards_1 = require("./internal/guards");
+const plain_object_1 = require("./internal/plain-object");
 const output_1 = require("./output");
 const verify_source_result_1 = require("./verify-source-result");
 const DMS_PACKAGE = "@antelopejs/dms";
 const DMS_CORE_LAYER_PACKAGE = "@antelopejs/dms-frontend-vue";
 const CORE_LAYER_DIRECTORY = "frontend-vue";
 const FRONTEND_ENTRY = "dms.frontend.ts";
-const ADD_DEV_DEPENDENCY = {
-    pnpm: "pnpm add -D",
-    npm: "npm install -D",
-    yarn: "yarn add -D",
-    bun: "bun add -d",
-};
+const ADD_DEV_DEPENDENCY = new Map([
+    ["pnpm", "pnpm add -D"],
+    ["npm", "npm install -D"],
+    ["yarn", "yarn add -D"],
+    ["bun", "bun add -d"],
+]);
 const LOCKFILES = [
     ["pnpm-lock.yaml", "pnpm"],
     ["package-lock.json", "npm"],
@@ -24,16 +26,46 @@ const LOCKFILES = [
     ["bun.lock", "bun"],
     ["bun.lockb", "bun"],
 ];
+function malformedVariable(variable, expected) {
+    return new common_1.UsageError({
+        title: `${variable} is not ${expected}`,
+        reason: `\`ajs dms verify-source\` starts the runner with ${variable} set to ${expected}.`,
+    });
+}
+function readTextList(variable) {
+    const value = JSON.parse(process.env[variable] ?? "[]");
+    if (Array.isArray(value) && value.every(guards_1.isText))
+        return value;
+    throw malformedVariable(variable, "a JSON list of paths");
+}
+function readTextRecord(variable) {
+    const value = JSON.parse(process.env[variable] ?? "{}");
+    if ((0, plain_object_1.isPlainObject)(value)) {
+        const entries = Object.entries(value);
+        if (entries.every((entry) => (0, guards_1.isText)(entry[1]))) {
+            return Object.fromEntries(entries);
+        }
+    }
+    throw malformedVariable(variable, "a JSON record of paths by package name");
+}
 function readSourceOptions() {
     return {
         projectDir: process.cwd(),
         layerSource: process.env.DMS_LAYER_SOURCE || undefined,
-        moduleSources: JSON.parse(process.env.DMS_MODULE_SOURCES ?? "[]"),
-        localPackages: JSON.parse(process.env.DMS_LOCAL_PACKAGES ?? "{}"),
+        moduleSources: readTextList("DMS_MODULE_SOURCES"),
+        localPackages: readTextRecord("DMS_LOCAL_PACKAGES"),
     };
 }
 function readManifest(packagePath) {
-    return JSON.parse((0, node_fs_1.readFileSync)(packagePath, "utf8"));
+    const parsed = JSON.parse((0, node_fs_1.readFileSync)(packagePath, "utf8"));
+    if (!(0, plain_object_1.isPlainObject)(parsed))
+        return {};
+    const { name, version, packageManager } = parsed;
+    return {
+        name: (0, guards_1.isText)(name) ? name : undefined,
+        version: (0, guards_1.isText)(version) ? version : undefined,
+        packageManager: (0, guards_1.isText)(packageManager) ? packageManager : undefined,
+    };
 }
 function readLayer(root) {
     const packagePath = (0, node_path_1.join)(root, "package.json");
@@ -68,7 +100,7 @@ function packageManager(projectDir) {
         const packagePath = (0, node_path_1.join)(directory, "package.json");
         if ((0, node_fs_1.existsSync)(packagePath)) {
             const [name] = (readManifest(packagePath).packageManager ?? "").split("@");
-            if (name && ADD_DEV_DEPENDENCY[name])
+            if (name && ADD_DEV_DEPENDENCY.has(name))
                 return name;
             const lockfile = LOCKFILES.find(([file]) => (0, node_fs_1.existsSync)((0, node_path_1.join)(directory, file)));
             if (lockfile)
@@ -79,7 +111,7 @@ function packageManager(projectDir) {
     }
 }
 function addDmsCommand(projectDir, version = "") {
-    return `${ADD_DEV_DEPENDENCY[packageManager(projectDir)]} ${DMS_PACKAGE}${version}`;
+    return `${ADD_DEV_DEPENDENCY.get(packageManager(projectDir))} ${DMS_PACKAGE}${version}`;
 }
 function describeDirectory(directory) {
     return (0, node_path_1.resolve)(directory) === process.cwd()
@@ -107,6 +139,12 @@ function installedCoreLayer(projectDir) {
             ],
         });
     const { version } = readManifest(packagePath);
+    if (version === undefined)
+        throw new common_1.UsageError({
+            title: `${DMS_PACKAGE} has no text "version" in its package.json`,
+            reason: `${(0, output_1.showPath)(packagePath)} has no "version" that is text, and the verification names the installed ${DMS_PACKAGE} by it.`,
+            fixes: [`Reinstall it: ${addDmsCommand(projectDir, "@latest")}`],
+        });
     const root = (0, node_path_1.join)((0, node_path_1.dirname)(packagePath), CORE_LAYER_DIRECTORY);
     const layer = (0, node_fs_1.existsSync)((0, node_path_1.join)(root, "package.json"))
         ? readLayer(root)

package/dist/verify-source-workspace.d.ts

@@ -0,0 +1,2 @@
+import { type ResolvedLayer } from "./common";
+export declare function materializeWorkspace(workspace: string, layers: ResolvedLayer[], localPackages: Record<string, string>): void;

package/dist/verify-source-workspace.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.materializeWorkspace = materializeWorkspace;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const yaml_1 = require("yaml");
+const common_1 = require("./common");
+const ensure_1 = require("./internal/ensure");
+const guards_1 = require("./internal/guards");
+const plain_object_1 = require("./internal/plain-object");
+const output_1 = require("./output");
+function removeDevelopmentDependencies(root) {
+    const packagePath = (0, node_path_1.join)(root, "package.json");
+    if (!(0, node_fs_1.existsSync)(packagePath))
+        return;
+    const packageData = JSON.parse((0, node_fs_1.readFileSync)(packagePath, "utf8"));
+    if (!(0, plain_object_1.isPlainObject)(packageData))
+        return;
+    delete packageData.devDependencies;
+    (0, node_fs_1.writeFileSync)(packagePath, `${JSON.stringify(packageData, null, 2)}\n`);
+}
+const PATH_PROTOCOLS = ["file:", "link:"];
+const WORKSPACE_PROTOCOL = "workspace:";
+const LOCKFILE = "pnpm-lock.yaml";
+const WORKSPACE_FILE = "pnpm-workspace.yaml";
+const OWN_LOCKFILES = /^\s*shared-workspace-lockfile\s*=\s*false\s*$/m;
+function findUp(directory, file) {
+    if ((0, node_fs_1.existsSync)((0, node_path_1.join)(directory, file)))
+        return directory;
+    const parent = (0, node_path_1.dirname)(directory);
+    return parent === directory ? undefined : findUp(parent, file);
+}
+function sharesLockfile(root) {
+    const npmrc = (0, node_path_1.join)(root, ".npmrc");
+    if ((0, node_fs_1.existsSync)(npmrc) && OWN_LOCKFILES.test((0, node_fs_1.readFileSync)(npmrc, "utf8")))
+        return false;
+    const settings = (0, yaml_1.parse)((0, node_fs_1.readFileSync)((0, node_path_1.join)(root, WORKSPACE_FILE), "utf8"));
+    return !((0, plain_object_1.isPlainObject)(settings) && settings.sharedWorkspaceLockfile === false);
+}
+function findLockfile(directory) {
+    const workspaceRoot = findUp(directory, WORKSPACE_FILE);
+    const lockfileRoot = workspaceRoot && sharesLockfile(workspaceRoot)
+        ? workspaceRoot
+        : findUp(directory, LOCKFILE);
+    if (!lockfileRoot)
+        return undefined;
+    const lockfile = (0, node_path_1.join)(lockfileRoot, LOCKFILE);
+    const outsideWorkspace = workspaceRoot !== undefined &&
+        (0, node_path_1.relative)(workspaceRoot, lockfileRoot).startsWith("..");
+    return (0, node_fs_1.existsSync)(lockfile) && !outsideWorkspace ? lockfile : undefined;
+}
+function readLayerOverrides(layer) {
+    const lockfile = findLockfile(layer.path);
+    if (!lockfile)
+        return [];
+    const root = (0, node_path_1.dirname)(lockfile);
+    const overrides = [];
+    for (const document of (0, yaml_1.parseAllDocuments)((0, node_fs_1.readFileSync)(lockfile, "utf8"))) {
+        const [error] = document.errors;
+        (0, ensure_1.ensure)(error === undefined, `${(0, output_1.showPath)(lockfile)} is not a pnpm lockfile`, error?.message);
+        const lock = document.toJS();
+        if (!(0, plain_object_1.isPlainObject)(lock) || !(0, plain_object_1.isPlainObject)(lock.overrides))
+            continue;
+        for (const [name, spec] of Object.entries(lock.overrides)) {
+            if (!(0, guards_1.isText)(spec) || spec.startsWith(WORKSPACE_PROTOCOL))
+                continue;
+            overrides.push([name, resolveSpec(root, spec)]);
+        }
+    }
+    return overrides;
+}
+function resolveSpec(root, spec) {
+    const protocol = PATH_PROTOCOLS.find((prefix) => spec.startsWith(prefix));
+    if (!protocol)
+        return spec;
+    const path = spec.slice(protocol.length);
+    return (0, node_path_1.isAbsolute)(path) ? spec : `${protocol}${(0, node_path_1.resolve)(root, path)}`;
+}
+function materializeWorkspace(workspace, layers, localPackages) {
+    const templateRoot = (0, node_path_1.join)((0, common_1.getPackageRoot)(), "templates", "vue");
+    const templateFiles = (0, node_fs_1.readdirSync)(templateRoot).filter((file) => !file.startsWith("npmrc"));
+    for (const file of templateFiles)
+        (0, node_fs_1.cpSync)((0, node_path_1.join)(templateRoot, file), (0, node_path_1.join)(workspace, file), {
+            recursive: true,
+        });
+    (0, common_1.materializeLayers)(workspace, layers);
+    const registry = (0, common_1.createFrontendModuleRegistry)(workspace, layers);
+    registry.modules.forEach((module) => {
+        removeDevelopmentDependencies(module.root);
+    });
+    (0, common_1.writeFrontendModuleRegistry)(workspace, layers);
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(workspace, "dms-main.css"), '@import "tailwindcss";\n@import "@nuxt/ui";\n');
+    (0, common_1.writeWorkspacePackageJson)(workspace, layers);
+    const packagePath = (0, node_path_1.join)(workspace, "package.json");
+    const workspacePackage = JSON.parse((0, node_fs_1.readFileSync)(packagePath, "utf8"));
+    (0, ensure_1.ensure)((0, plain_object_1.isPlainObject)(workspacePackage), "The workspace package.json is not a JSON object");
+    workspacePackage.pnpm = {
+        overrides: {
+            ...Object.fromEntries(layers.flatMap(readLayerOverrides)),
+            ...Object.fromEntries(layers.map((layer) => [
+                String(layer.packageName),
+                "workspace:*",
+            ])),
+            ...Object.fromEntries(Object.entries(localPackages).map(([name, path]) => [
+                name,
+                `link:${(0, node_path_1.resolve)(path)}`,
+            ])),
+        },
+    };
+    (0, node_fs_1.writeFileSync)(packagePath, `${JSON.stringify(workspacePackage, null, 2)}\n`);
+}

package/dist/workspace-setup.d.ts

@@ -31,6 +31,7 @@ export interface SetupWorkspaceOptions {
     workspaceDir?: string;
     project?: ProjectModulesOptions;
     beforeInstall?: () => Promise<void>;
+    install?: boolean;
 }
 export interface SetupWorkspaceResult {
     workspaceDir: string;

package/dist/workspace-setup.js

@@ -95,7 +95,7 @@ async function installDeps(workspaceDir, mapLine, extraArgs = []) {
         task.succeed(progress.doneLabel);
     }
     catch (error) {
-        (0, output_1.endInterruptedTask)(task, error, "Dependency install stopped");
+        (0, output_1.endInterruptedTask)(task, error instanceof cancellation_1.CancelledError ? error : undefined, "Dependency install stopped");
         throw error;
     }
 }
@@ -299,7 +299,8 @@ async function setupWorkspace(opts) {
     writeDerivedOutputs(workspaceDir, layers);
     (0, materialize_1.writeDmsMainCss)(workspaceDir, layers);
     const layerPaths = layers.map((layer) => layer.path);
-    const shouldInstall = needsInstall(workspaceDir, layerPaths, opts.force);
+    const shouldInstall = opts.install !== false &&
+        needsInstall(workspaceDir, layerPaths, opts.force);
     if (shouldInstall) {
         await opts.beforeInstall?.();
         await installDeps(workspaceDir, (0, child_output_1.createPathMapper)(workspaceDir, layers));
@@ -321,6 +322,6 @@ function writeDerivedOutputs(workspaceDir, layers) {
         if (!(error instanceof locale_files_1.InvalidLocaleFileError))
             throw error;
         const showSource = (0, child_output_1.createPathMapper)(workspaceDir, layers);
-        throw new locale_files_1.InvalidLocaleFileError(showSource(error.path), error.reason);
+        throw new locale_files_1.InvalidLocaleFileError(showSource(error.path), error.reason, error.details);
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antelopejs/dms-frontend",
-  "version": "0.9.3",
+  "version": "0.10.1",
   "description": "Frontend-agnostic loader for AntelopeJS DMS, shipping the Vue 3 renderer (Vite, Inertia, SSR)",
   "keywords": [
     "antelope",
@@ -66,7 +66,7 @@
     "test:real-source": "pnpm run build && node dist/verify-source-runner.js",
     "format": "oxfmt .",
     "lint": "oxlint && antelopejs-check-interface-ranges && pnpm run docs:reference:check && pnpm run source-checks",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc --noEmit && tsx scripts/typecheck-projects.ts tsconfig.templates.json tsconfig.tests.json",
     "lint:fix": "oxlint --fix --max-warnings=1000000 && oxfmt .",
     "knip": "knip --dependencies",
     "knip:all": "knip",
@@ -76,9 +76,7 @@
     "prepare": "if git rev-parse --is-inside-work-tree >/dev/null 2>&1 && command -v lefthook >/dev/null 2>&1; then lefthook install; fi",
     "checks": "antelopejs-checks",
     "size": "antelopejs-check-size",
-    "ratchet": "antelopejs-ratchet",
     "sync": "antelopejs-sync",
-    "ratchet:update": "antelopejs-ratchet --update",
     "sync:check": "antelopejs-sync --check",
     "format:check": "oxfmt --check .",
     "suppressions": "antelopejs-suppressions",
@@ -89,11 +87,13 @@
     "chokidar": "^4.0.3",
     "commander": "^13.1.0",
     "ignore": "^7.0.5",
-    "semver": "^7.7.4"
+    "semver": "^7.7.4",
+    "yaml": "^2.9.1"
   },
   "devDependencies": {
-    "@antelopejs/core": "^1.16.0",
-    "@antelopejs/tooling-configs": "^0.2.17",
+    "@antelopejs/core": "^1.21.0",
+    "@antelopejs/interface-dms": "^0.10.0",
+    "@antelopejs/tooling-configs": "^0.3.3",
     "@iconify/utils": "^3.1.0",
     "@iconify/vue": "^5.0.1",
     "@inertiajs/vue3": "^3.7.1",
@@ -105,6 +105,7 @@
     "@vueuse/core": "14.4.0",
     "defu": "^6.1.4",
     "devalue": "^5.9.4",
+    "fast-check": "^4.10.2",
     "knip": "^6.34.0",
     "lefthook": "^2.2.2",
     "ofetch": "^1.5.1",
@@ -141,6 +142,9 @@
     }
   },
   "antelopeJs": {
+    "docs": {
+      "standard": true
+    },
     "skills": [
       "./skills"
     ]

package/skills/dms-frontend/SKILL.md

@@ -40,7 +40,7 @@ tags: [frontend, cli, renderer, vue, inertia, ssr, deployment, dms-module]
 
 | Task | Page |
 | --- | --- |
-| Compatibility with DMS releases | `/docs/frontend/introduction#compatibility` |
+| Where to read the renderer releases a DMS release runs on | `/docs/frontend/introduction#compatibility` |
 | One command in depth | `/docs/frontend/cli/<command>` |
 | Variables and secrets | `/docs/frontend/configuration` |
 | Module files and SDK | `/docs/frontend/frontend-modules/anatomy`, then `server-routes`, `sessions-and-sign-in`, `route-rules`, `emails` |

package/templates/vue/app-runtime.ts

@@ -9,7 +9,6 @@ import { useHead } from "@unhead/vue";
 import type { VueHeadClient } from "@unhead/vue/types";
 import type { IconifyIcon } from "@iconify/vue";
 import { parse } from "devalue";
-import type { FetchOptions } from "ofetch";
 import {
   type App,
   type Component,
@@ -28,6 +27,7 @@ import {
   type DmsLocaleLoader,
   type DmsPageProps,
   type DmsPayload,
+  type DmsServerFetch,
   type DmsUser,
   createDmsFrontendRuntime,
   dmsPageSuspenseProps,
@@ -107,11 +107,6 @@ export interface DmsConfiguredApp {
   runtime: ReturnType<typeof createDmsFrontendRuntime>;
 }
 
-export type DmsServerFetch = (
-  request: string,
-  options?: FetchOptions,
-) => Promise<unknown>;
-
 export const DMS_PAYLOAD_ID = "dms-payload";
 export const SSR_ASYNC_COMPONENTS_ID = "dms-ssr-async-components";
 const DEFAULT_LOCALE = "en";
@@ -156,9 +151,7 @@ drawLoadedIconsAtOnce();
 function createBrowserRuntime(
   serverFetch?: DmsServerFetch,
 ): DmsConfiguredApp["runtime"] {
-  const runtime = createDmsFrontendRuntime(
-    serverFetch as typeof import("ofetch").ofetch,
-  );
+  const runtime = createDmsFrontendRuntime(serverFetch);
   // Nothing when the server did not render the page: no hydration then.
   const payload = readServerRendered<DmsPayload | undefined>(
     DMS_PAYLOAD_ID,