@antelopejs/dms-frontend 0.10.0 → 0.10.1

package/README.md

@@ -1,20 +1,14 @@
-<div align="center">
+<a href="https://github.com/AntelopeJS/dms"><img data-illustration src="./.github/readme/strip.svg" width="100%" alt="DMS FRONTEND: part of AntelopeJS DMS, the open-source back office. A glowing button reads Star AntelopeJS DMS."></a>
 
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/AntelopeJS/dms/main/packages/dms/frontend-vue/layers/dms-layout/public/images/antelope-logo/dark.svg">
-  <img alt="AntelopeJS DMS" src="https://raw.githubusercontent.com/AntelopeJS/dms/main/packages/dms/frontend-vue/layers/dms-layout/public/images/antelope-logo/light.svg" data-illustration height="72">
-</picture>
+<div align="center">
 
 # `@antelopejs/dms-frontend`
 
-<a href="https://www.npmjs.com/package/@antelopejs/dms-frontend"><img alt="npm" src="https://img.shields.io/npm/v/@antelopejs/dms-frontend?style=for-the-badge&labelColor=000000&color=000000" data-illustration></a>
-<a href="./LICENSE"><img alt="License" src="https://img.shields.io/npm/l/@antelopejs/dms-frontend?style=for-the-badge&labelColor=000000&color=000000" data-illustration></a>
-<a href="https://discord.gg/g4pFt6eXqu"><img alt="Discord" src="https://img.shields.io/badge/Discord-18181B?logo=discord&style=for-the-badge&color=000000" data-illustration></a>
-<a href="https://dms.antelopejs.com/docs/frontend"><img alt="Documentation" src="https://img.shields.io/badge/Docs-18181B?style=for-the-badge&color=000000" data-illustration></a>
+<a href="https://www.npmjs.com/package/@antelopejs/dms-frontend"><img alt="npm" src="https://img.shields.io/npm/v/@antelopejs/dms-frontend?style=for-the-badge&labelColor=000000&color=000000" data-illustration></a> <a href="./LICENSE"><img alt="License" src="https://img.shields.io/npm/l/@antelopejs/dms-frontend?style=for-the-badge&labelColor=000000&color=000000" data-illustration></a> <a href="https://discord.gg/g4pFt6eXqu"><img alt="Discord" src="https://img.shields.io/badge/Discord-18181B?logo=discord&style=for-the-badge&color=000000" data-illustration></a> <a href="https://dms.antelopejs.com/docs/frontend"><img alt="Documentation" src="https://img.shields.io/badge/Docs-18181B?style=for-the-badge&color=000000" data-illustration></a> <a href="https://github.com/AntelopeJS/dms"><img data-illustration alt="Star AntelopeJS DMS" src="https://img.shields.io/github/stars/AntelopeJS/dms?label=Star%20AntelopeJS%20DMS&style=for-the-badge&labelColor=000000&color=000000&logo=github"></a>
 
 **The frontend of the AntelopeJS DMS: the `ajs dms` CLI, the Vue renderer and the frontend-module SDK.**
 
-[Documentation](https://dms.antelopejs.com/docs/frontend) · [DMS](https://github.com/AntelopeJS/dms) · [Modules](https://dms.antelopejs.com/docs/modules)
+[Documentation](https://dms.antelopejs.com/docs/frontend) · [All modules](https://github.com/AntelopeJS/dms#modules)
 
 </div>
 
@@ -59,7 +53,7 @@ pnpm exec ajs dms start -b https://api.example.com -p 3001
 
 | Package            | Supported     | Tested with |
 | ------------------ | ------------- | ----------- |
-| `@antelopejs/core` | `>=1.16.0 <2` | `1.20.0`    |
+| `@antelopejs/core` | `>=1.16.0 <2` | `1.21.0`    |
 
 <!-- antelopejs-docs-compat:end -->
 
@@ -91,6 +85,35 @@ pnpm test
 
 `pnpm docs:reference` regenerates the environment-variable table of `docs/4.configuration.md` from the list `ajs dms help environment` prints. `pnpm lint` fails when the table is stale.
 
+## Part of AntelopeJS DMS
+
+This package is the frontend of [AntelopeJS DMS](https://github.com/AntelopeJS/dms), the open-source back office. It renders the dashboard that every module adds its pages to, behind the same sign-in and roles.
+
+<!-- antelopejs-dms-modules:start -->
+
+| Module                                                           | What it adds                                                                             |
+| ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| [`dms-builder`](https://github.com/AntelopeJS/dms-builder)       | Edit pages, tables and data sources by clicking, as TypeScript that compiles             |
+| [`dms-ai`](https://github.com/AntelopeJS/dms-ai)                 | An assistant chat in the dashboard, on your own Claude Code or Codex                     |
+| [`dms-database`](https://github.com/AntelopeJS/dms-database)     | Schemas, relation diagrams, a data browser and a query console                           |
+| [`dms-api`](https://github.com/AntelopeJS/dms-api)               | API health, request logs, per-route statistics and a request tester                      |
+| [`dms-automation`](https://github.com/AntelopeJS/dms-automation) | Node-graph automations on schedules, webhooks and DMS events, with a trace for every run |
+| [`dms-mailing`](https://github.com/AntelopeJS/dms-mailing)       | E-mail templates in a block editor, versions, a send log and delivery metrics            |
+| [`dms-lang`](https://github.com/AntelopeJS/dms-lang)             | Translation coverage, a translation matrix and a translation queue                       |
+| [`dms-media`](https://github.com/AntelopeJS/dms-media)           | A media library with folders, per-folder permissions, image sizes and light editing      |
+| [`dms-saas`](https://github.com/AntelopeJS/dms-saas)             | Self-service sign-up, plans that gate features, and Stripe billing                       |
+| [`dms-marketing`](https://github.com/AntelopeJS/dms-marketing)   | Traffic, conversion funnels with A/B splits and click heatmaps, without cookies          |
+| [`dms-frontend`](https://github.com/AntelopeJS/dms-frontend)     | The `ajs dms` CLI, the Vue renderer and the SDK every frontend module builds on          |
+
+<!-- antelopejs-dms-modules:end -->
+
 ## License
 
 [Apache-2.0](./LICENSE)
+
+## Requirements
+
+<!-- antelopejs-docs-node:start -->
+
+This package requires Node.js `>=20.19.0`.
+<!-- antelopejs-docs-node:end -->

package/dist/commands/build-action.d.ts

@@ -5,6 +5,9 @@ export interface BuildOptions {
     env: string;
     workspace?: string;
     force?: boolean;
+    setupOnly?: boolean;
+    install?: boolean;
+    prepared?: boolean;
 }
 export declare const DEFAULT_WORKSPACE_DIR = ".dms-frontend";
 export declare function productionWorkspace(options: {

package/dist/commands/build-action.js

@@ -6,6 +6,8 @@ exports.buildStepFailure = buildStepFailure;
 exports.runBuild = runBuild;
 const node_path_1 = require("node:path");
 const cli_1 = require("@antelopejs/core/cli");
+const config_1 = require("../config");
+const prepared_workspace_1 = require("../internal/prepared-workspace");
 const child_output_1 = require("../child-output");
 const common_1 = require("../common");
 const output_1 = require("../output");
@@ -13,6 +15,68 @@ const vite_output_1 = require("../vite-output");
 const entry_weight_1 = require("../entry-weight");
 const workspace_task_1 = require("./workspace-task");
 const node_options_1 = require("../node-options");
+const NOT_PREPARED_EXIT_CODE = 3;
+function buildPlan(options) {
+    const install = options.install !== false;
+    if (options.setupOnly)
+        return { kind: "setup", install };
+    if (!install)
+        throw new config_1.UsageError({
+            title: "--no-install needs --setup-only",
+            fixes: ["Run ajs dms build --setup-only --no-install"],
+        });
+    return options.prepared ? { kind: "prepared" } : { kind: "full" };
+}
+function workspaceFlag(options) {
+    return options.workspace ? ` --workspace ${options.workspace}` : "";
+}
+async function setUpProductionWorkspace(options, workspace, install) {
+    (0, prepared_workspace_1.forgetPreparedLayers)(workspace);
+    const { workspaceDir, layers } = await (0, workspace_task_1.setUpWorkspace)({
+        force: !!options.force,
+        mode: "build",
+        workspaceDir: workspace,
+        project: { projectDir: options.project, environment: options.env },
+        install,
+    });
+    (0, prepared_workspace_1.recordPreparedLayers)(workspaceDir, layers);
+    return { workspaceDir, layers };
+}
+function setupSummary(options, install, workspaceDir, startedAt) {
+    const flag = workspaceFlag(options);
+    return {
+        headline: install
+            ? "Set up the production workspace"
+            : "Wrote the production workspace without installing it",
+        artifact: (0, output_1.showWorkspace)(workspaceDir),
+        durationMs: Date.now() - startedAt,
+        nextSteps: [
+            install
+                ? {
+                    command: `ajs dms build --prepared${flag}`,
+                    description: "builds this workspace as it is",
+                }
+                : {
+                    command: `ajs dms build --setup-only${flag}`,
+                    description: "installs its dependencies",
+                },
+        ],
+    };
+}
+function preparedProductionWorkspace(options, workspace) {
+    const workspaceDir = (0, node_path_1.resolve)(workspace);
+    const found = (0, prepared_workspace_1.readPreparedWorkspace)(workspaceDir);
+    if (found.prepared)
+        return { workspaceDir, layers: found.layers };
+    throw new cli_1.CliError({
+        title: `${(0, output_1.showWorkspace)(workspaceDir)} is not prepared`,
+        reason: found.reason,
+        fixes: [
+            `Run ajs dms build --setup-only${workspaceFlag(options)} first, or build without --prepared`,
+        ],
+        exitCode: NOT_PREPARED_EXIT_CODE,
+    });
+}
 exports.DEFAULT_WORKSPACE_DIR = ".dms-frontend";
 function productionWorkspace(options) {
     return options.workspace ?? (0, node_path_1.join)(options.project, exports.DEFAULT_WORKSPACE_DIR);
@@ -109,16 +173,20 @@ async function runBuild(options) {
     }
 }
 async function buildProduction(options, startedAt) {
+    const plan = buildPlan(options);
     (0, entry_weight_1.entryWeightThreshold)(process.env);
     const ui = (0, cli_1.getProcessUi)();
     const workspace = productionWorkspace(options);
     (0, output_1.writeHeader)("build", [options.project, options.env]);
-    const { workspaceDir, layers } = await (0, workspace_task_1.setUpWorkspace)({
-        force: !!options.force,
-        mode: "build",
-        workspaceDir: workspace,
-        project: { projectDir: options.project, environment: options.env },
-    });
+    if (plan.kind === "setup") {
+        const { workspaceDir } = await setUpProductionWorkspace(options, workspace, plan.install);
+        (0, output_1.writeBlankLine)();
+        ui.summary(setupSummary(options, plan.install, workspaceDir, startedAt));
+        return;
+    }
+    const { workspaceDir, layers } = plan.kind === "prepared"
+        ? preparedProductionWorkspace(options, workspace)
+        : await setUpProductionWorkspace(options, workspace, true);
     ui.message("info", "Building for production", {
         detail: `Workspace  ${(0, output_1.showWorkspace)(workspaceDir)}`,
     });

package/dist/commands/build.js

@@ -46,6 +46,10 @@ const BUILD_EXAMPLES = [
         description: "With another environment's configuration, into a directory",
         command: "ajs dms build -e staging --workspace /srv/dms-frontend",
     },
+    {
+        description: "Set the workspace up and install it, then build it later as it is",
+        command: "ajs dms build --setup-only && ajs dms build --prepared",
+    },
 ];
 function cmdBuild() {
     const command = new commander_1.Command("build")
@@ -55,6 +59,9 @@ function cmdBuild() {
         .addOption(config_1.Options.env)
         .addOption(config_1.Options.workspace("Build into this directory instead of <project>/.dms-frontend"))
         .addOption(config_1.Options.force("Reinstall the workspace dependencies"))
+        .addOption(new commander_1.Option("--setup-only", "Set the workspace up and install its dependencies, then stop before the bundles"))
+        .addOption(new commander_1.Option("--no-install", "With --setup-only, write the workspace without installing its dependencies"))
+        .addOption(new commander_1.Option("--prepared", "Build the workspace --setup-only set up, as it is, without setting it up again; exit 3 when it is not prepared").conflicts(["setupOnly", "force"]))
         .action(async (options) => (await Promise.resolve().then(() => __importStar(require("./build-action")))).runBuild(options));
     return (0, cli_1.withExamples)(command, BUILD_EXAMPLES);
 }

package/dist/commands/clean-action.js

@@ -79,7 +79,7 @@ async function runClean(options) {
             title: "Nothing to clean: pass -b <url> or --all",
             reason: "clean never uses DMS_API_BASE_URL from the environment or ./.env.",
             fixes: [
-                "Remove the workspace build, start and dev -b share for a URL: ajs dms clean -b <url>",
+                "Remove the workspace dev -b and prepare use for a URL: ajs dms clean -b <url>",
                 "Remove every workspace, including those dev created without -b: ajs dms clean --all",
                 "List the workspaces: ajs dms workspaces",
             ],

package/dist/commands/clean.js

@@ -38,7 +38,7 @@ const commander_1 = require("commander");
 const cli_1 = require("@antelopejs/core/cli");
 const CLEAN_EXAMPLES = [
     {
-        description: "The workspace build, start and dev -b share for a backend",
+        description: "The workspace dev -b and prepare use for a backend",
         command: "ajs dms clean -b https://dms.example.com",
     },
     {

package/dist/commands/dev-action.js

@@ -66,7 +66,7 @@ async function runDev(options) {
         bootstrapSecret,
         project,
     });
-    if (port !== requestedPort) {
+    if (reserved.isFallback) {
         ui.message("warn", `Port ${requestedPort} is busy, using ${port}`);
     }
     if (manifestFromCache) {
@@ -120,7 +120,7 @@ function backendModuleSet(setup) {
 function reportServed(session, setup) {
     return (0, module_set_1.reportFrontendReady)(session.backendUrl, setup.layers.map((layer) => ({
         name: layer.name ?? layer.path,
-        version: (0, project_modules_1.readShippingVersion)(layer.path),
+        version: (0, project_modules_1.readShippingPackage)(layer.path).version,
     })), session.bootstrapSecret);
 }
 async function serveWorkspace(session, setup) {

package/dist/commands/dev.js

@@ -43,7 +43,7 @@ const DEV_EXAMPLES = [
         command: "ajs dms dev",
     },
     {
-        description: "Share one workspace with build and start",
+        description: "Run in the workspace prepare uses for that backend",
         command: "ajs dms dev -b http://localhost:5010 -p 3001",
     },
 ];

package/dist/config.js

@@ -67,6 +67,7 @@ exports.TEMPLATE_FILES = [
     ["head-order.mjs", "head-order.mjs"],
     ["client-chunking.mjs", "client-chunking.mjs"],
     ["entry-weight.mjs", "entry-weight.mjs"],
+    ["backend-boundary.mjs", "backend-boundary.mjs"],
     ["client-server-guard.mjs", "client-server-guard.mjs"],
     ["ui-inertia-page.mjs", "ui-inertia-page.mjs"],
     ["ui-request-state.mjs", "ui-request-state.mjs"],

package/dist/derived-outputs.d.ts

@@ -4,6 +4,7 @@ export interface FrontendModuleRegistryEntry {
     name?: string;
     packageName?: string;
     version?: string;
+    backendPackage?: string;
     root: string;
     priority: number;
     entry?: string;

package/dist/derived-outputs.js

@@ -41,11 +41,13 @@ function createFrontendModuleRegistry(workspaceDir, layers) {
         const buildEntry = (0, node_path_1.join)(layer.path, config_1.FRONTEND_BUILD_ENTRY);
         const serverEntry = (0, node_path_1.join)(layer.path, config_1.SERVER_MODULE_ENTRY);
         const options = layer.options ?? {};
+        const shipping = (0, project_modules_1.readShippingPackage)(layer.sourcePath ?? layer.path);
         return {
             id: (0, layers_1.getLayerSafeName)(layer),
             name: layer.name ?? layer.packageName,
             packageName: layer.packageName,
-            version: (0, project_modules_1.readShippingVersion)(layer.sourcePath ?? layer.path),
+            version: shipping.version,
+            backendPackage: shipping.name,
             root: (0, layers_1.getLayerWorkspacePath)(workspaceDir, layer),
             priority: layer.priority ?? 0,
             entry: (0, node_fs_1.existsSync)(sourceEntry) ? config_1.FRONTEND_MODULE_ENTRY : undefined,

package/dist/help.js

@@ -81,7 +81,7 @@ exports.ENVIRONMENT_VARIABLES = [
 ];
 const ENVIRONMENT_NOTES = [
     "A variable set in the shell wins over both files, and .env.local wins over .env. Only the current directory is read: the generated workspace never loads a .env of its own.",
-    "Workspaces live in ~/.antelopejs/dms-frontend, one per backend URL. dev without -b keys its own on the project directory instead; pass -b to share one with build and start. ajs dms workspaces lists them.",
+    "dev and prepare keep their workspaces in ~/.antelopejs/dms-frontend, one per backend URL, and ajs dms workspaces lists them. dev without -b keys its own on the project directory instead. build and start use <project>/.dms-frontend, or --workspace.",
 ];
 function subcommandTerm(command) {
     const args = command.registeredArguments.map((argument) => argument.required ? `<${argument.name()}>` : `[${argument.name()}]`);

package/dist/internal/prepared-workspace.d.ts

@@ -0,0 +1,12 @@
+import type { ResolvedLayer } from "../workspace";
+export type RecordedLayer = Pick<ResolvedLayer, "path" | "name" | "sourcePath" | "packageName">;
+export type PreparedWorkspace = {
+    prepared: true;
+    layers: RecordedLayer[];
+} | {
+    prepared: false;
+    reason: string;
+};
+export declare function forgetPreparedLayers(workspaceDir: string): void;
+export declare function recordPreparedLayers(workspaceDir: string, layers: readonly ResolvedLayer[]): void;
+export declare function readPreparedWorkspace(workspaceDir: string): PreparedWorkspace;

package/dist/internal/prepared-workspace.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.forgetPreparedLayers = forgetPreparedLayers;
+exports.recordPreparedLayers = recordPreparedLayers;
+exports.readPreparedWorkspace = readPreparedWorkspace;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const config_1 = require("../config");
+const workspace_setup_1 = require("../workspace-setup");
+const guards_1 = require("./guards");
+const plain_object_1 = require("./plain-object");
+const PREPARED_LAYERS_FILE = ".dms-build-layers.json";
+const OPTIONAL_TEXT_KEYS = ["name", "sourcePath", "packageName"];
+function isRecordedLayer(value) {
+    return ((0, plain_object_1.isPlainObject)(value) &&
+        Object.prototype.hasOwnProperty.call(value, "path") &&
+        (0, guards_1.isText)(value.path) &&
+        OPTIONAL_TEXT_KEYS.every((key) => !Object.prototype.hasOwnProperty.call(value, key) || (0, guards_1.isText)(value[key])));
+}
+function readRecord(workspaceDir) {
+    let parsed;
+    try {
+        parsed = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(workspaceDir, PREPARED_LAYERS_FILE), "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+    if (!(0, plain_object_1.isPlainObject)(parsed) ||
+        !Object.prototype.hasOwnProperty.call(parsed, "installed"))
+        return undefined;
+    const { installed } = parsed;
+    if (!(0, guards_1.isFlag)(installed) ||
+        !Object.prototype.hasOwnProperty.call(parsed, "layers"))
+        return undefined;
+    const { layers } = parsed;
+    if (!Array.isArray(layers))
+        return undefined;
+    const listed = layers;
+    return listed.every(isRecordedLayer)
+        ? { installed, layers: listed }
+        : undefined;
+}
+function forgetPreparedLayers(workspaceDir) {
+    (0, node_fs_1.rmSync)((0, node_path_1.join)(workspaceDir, PREPARED_LAYERS_FILE), { force: true });
+}
+function recordPreparedLayers(workspaceDir, layers) {
+    const record = {
+        installed: !(0, workspace_setup_1.needsInstall)(workspaceDir, layers.map((layer) => layer.path), false),
+        layers: layers.map(({ path, name, sourcePath, packageName }) => ({
+            path,
+            name,
+            sourcePath,
+            packageName,
+        })),
+    };
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(workspaceDir, PREPARED_LAYERS_FILE), `${JSON.stringify(record, null, 2)}\n`);
+}
+function readPreparedWorkspace(workspaceDir) {
+    const record = readRecord(workspaceDir);
+    if (!record)
+        return {
+            prepared: false,
+            reason: "No production setup finished in it.",
+        };
+    const installed = record.installed &&
+        (0, node_fs_1.existsSync)((0, node_path_1.join)(workspaceDir, config_1.DEPS_HASH_FILE)) &&
+        (0, node_fs_1.existsSync)((0, node_path_1.join)(workspaceDir, "node_modules"));
+    if (!installed)
+        return {
+            prepared: false,
+            reason: "Its dependencies are not installed, or changed since they were.",
+        };
+    return { prepared: true, layers: record.layers };
+}

package/dist/layer-watch.js

@@ -172,7 +172,7 @@ function createDerivedOutputRefresher(workspaceDir, layers, reporter) {
                 const file = reporter.show(err.path);
                 fail(output, {
                     text: `${file} is not a valid locale file`,
-                    options: { details: [...err.reason.split("\n"), kept] },
+                    options: { details: [err.reason, ...err.details, kept] },
                     fixed: [`${file} fixed`, `${output.name} regenerated`].join((0, cli_1.getProcessUi)().symbols.separator),
                 });
             }

package/dist/locale-files.d.ts

@@ -1,7 +1,9 @@
+import { CliError } from "@antelopejs/core/cli";
 import { type LocaleMessages } from "./internal/locale-catalogs";
-export declare class InvalidLocaleFileError extends Error {
+export declare class InvalidLocaleFileError extends CliError {
     readonly path: string;
     readonly reason: string;
-    constructor(path: string, reason: string);
+    readonly details: readonly string[];
+    constructor(path: string, reason: string, details?: readonly string[]);
 }
 export declare function readLocaleFile(path: string): LocaleMessages;

package/dist/locale-files.js

@@ -3,18 +3,24 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.InvalidLocaleFileError = void 0;
 exports.readLocaleFile = readLocaleFile;
 const node_fs_1 = require("node:fs");
+const cli_1 = require("@antelopejs/core/cli");
 const message_compiler_1 = require("@intlify/message-compiler");
 const guards_1 = require("./internal/guards");
 const locale_catalogs_1 = require("./internal/locale-catalogs");
-class InvalidLocaleFileError extends Error {
-    constructor(path, reason) {
-        super(`Invalid locale file ${path}: ${reason}`);
+class InvalidLocaleFileError extends cli_1.CliError {
+    constructor(path, reason, details = []) {
+        super({
+            title: `Invalid locale file ${path}: ${reason}`,
+            details: [...details],
+        });
         this.path = path;
         this.reason = reason;
+        this.details = details;
         this.name = "InvalidLocaleFileError";
     }
 }
 exports.InvalidLocaleFileError = InvalidLocaleFileError;
+const LINE_BREAKS = /\r?\n/g;
 const LITERAL_ESCAPES = {
     "@": "{'@'}",
     "{": "{'{'}",
@@ -67,18 +73,14 @@ function readLocaleFile(path) {
     }
     catch (error) {
         const reason = error instanceof Error ? error.message : String(error);
-        throw new InvalidLocaleFileError(path, reason);
+        throw new InvalidLocaleFileError(path, reason.replace(LINE_BREAKS, "\\n"));
     }
     if (!(0, locale_catalogs_1.isLocaleValue)(value) || !(0, locale_catalogs_1.isMessageGroup)(value)) {
         throw new InvalidLocaleFileError(path, "a locale file must hold a JSON object of messages");
     }
     const problems = messageProblems(value, "");
     if (problems.length) {
-        const reason = [
-            `${problems.length} message(s) vue-i18n cannot compile:`,
-            ...problems.map(describeProblem),
-        ].join("\n");
-        throw new InvalidLocaleFileError(path, reason);
+        throw new InvalidLocaleFileError(path, `${problems.length} message(s) vue-i18n cannot compile:`, problems.map(describeProblem));
     }
     return value;
 }

package/dist/manifest.js

@@ -86,7 +86,8 @@ function displayUrl(url) {
 }
 function backendEndpoint(backendUrl, path) {
     try {
-        return new URL(`${(0, config_1.parseBackendUrl)(backendUrl)}${path}`);
+        const base = (0, config_1.parseBackendUrl)(backendUrl).replace(/\/+$/, "");
+        return new URL(`${base}${path}`);
     }
     catch (err) {
         if (!(err instanceof config_1.UsageError))

package/dist/ports.d.ts

@@ -4,5 +4,7 @@ export interface ReservedPort {
     port: number;
     release: () => Promise<void>;
 }
-export declare function reserveFreePort(preferred: number, range?: number): Promise<ReservedPort>;
+export declare function reserveFreePort(preferred: number, range?: number): Promise<ReservedPort & {
+    isFallback: boolean;
+}>;
 export declare function reservePort(port: number): Promise<ReservedPort | undefined>;

package/dist/ports.js

@@ -21,7 +21,7 @@ async function reserveFreePort(preferred, range = exports.PORT_FALLBACK_RANGE) {
     for (let port = preferred; port <= end; port++) {
         const reserved = await reservePort(port);
         if (reserved)
-            return reserved;
+            return { ...reserved, isFallback: port !== preferred };
     }
     throw new cli_1.CliError({
         title: `No free port found between ${preferred} and ${end}`,

package/dist/project-modules.d.ts

@@ -42,6 +42,10 @@ export interface ProjectModulesOptions {
     dev?: boolean;
 }
 export declare function loadProjectConfig(projectDir: string, environment: string): Promise<ProjectConfig>;
-export declare function readShippingVersion(sourcePath: string): string | undefined;
+export interface ShippingPackage {
+    name?: string;
+    version?: string;
+}
+export declare function readShippingPackage(sourcePath: string): ShippingPackage;
 export declare function readProjectFrontendModules(options: ProjectModulesOptions): Promise<ProjectFrontendModule[]>;
 export {};

package/dist/project-modules.js

@@ -35,7 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FRONTEND_DECLARATION_FIELD = void 0;
 exports.loadProjectConfig = loadProjectConfig;
-exports.readShippingVersion = readShippingVersion;
+exports.readShippingPackage = readShippingPackage;
 exports.readProjectFrontendModules = readProjectFrontendModules;
 const node_fs_1 = require("node:fs");
 const fsPromises = __importStar(require("node:fs/promises"));
@@ -191,15 +191,18 @@ function moduleFolder(projectDir, cacheFolder, source) {
             : [];
     return candidates.find((folder) => (0, node_fs_1.existsSync)((0, node_path_1.join)(folder, "package.json")));
 }
-function readShippingVersion(sourcePath) {
+function readShippingPackage(sourcePath) {
     try {
         const pkg = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)((0, node_path_1.dirname)(sourcePath), "package.json"), "utf-8"));
-        return (0, guards_1.isObjectLike)(pkg) && "version" in pkg && (0, guards_1.isText)(pkg.version)
-            ? pkg.version
-            : undefined;
+        if (!(0, guards_1.isObjectLike)(pkg))
+            return {};
+        return {
+            name: "name" in pkg && (0, guards_1.isText)(pkg.name) ? pkg.name : undefined,
+            version: "version" in pkg && (0, guards_1.isText)(pkg.version) ? pkg.version : undefined,
+        };
     }
     catch {
-        return undefined;
+        return {};
     }
 }
 function toLayer(registration) {
@@ -274,6 +277,6 @@ async function readProjectFrontendModules(options) {
         .sort((left, right) => (right.priority ?? 0) - (left.priority ?? 0))
         .map((registration) => ({
         layer: toLayer(registration),
-        version: readShippingVersion(registration.sourcePath),
+        version: readShippingPackage(registration.sourcePath).version,
     }));
 }

package/dist/verify-source-runner.js

@@ -39,11 +39,11 @@ 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 plain_object_1 = require("./internal/plain-object");
 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");
@@ -51,48 +51,6 @@ 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;
-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`);
-}
-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.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`);
-}
 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" })
@@ -216,7 +174,7 @@ 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);

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;