@antelopejs/dms-frontend 0.7.1 → 0.9.0

package/README.md

@@ -44,11 +44,11 @@ In a DMS project started with `ajs project run -w`, serve the dashboard with hot
 pnpm exec ajs dms dev
 ```
 
-For production, build against the backend, then start the frontend server, with `DMS_SESSION_SECRET` and `DMS_BOOTSTRAP_SECRET` set:
+For production, build from the project root, without the backend, then start the frontend server with `DMS_SESSION_SECRET` and the backend's secrets set:
 
 ```bash
-pnpm exec ajs dms build -b https://dms.example.com
-pnpm exec ajs dms start -b https://dms.example.com -p 3001
+pnpm exec ajs dms build
+pnpm exec ajs dms start -b https://api.example.com -p 3001
 ```
 
 `ajs dms --help` lists every command, and `ajs dms help environment` every environment variable.
@@ -61,7 +61,7 @@ pnpm exec ajs dms start -b https://dms.example.com -p 3001
 | 0.9.0 | `>=0.6.0 <0.7.0` |
 | 0.6.0 – 0.8.3 | 0.5 (exact floor per release in the full table) |
 
-The 0.6 line needs Node.js 20.12 or later and `@antelopejs/core` `>=1.13.2 <2`. The [compatibility table](https://dms.antelopejs.com/docs/frontend/introduction#compatibility) lists every release.
+The 0.6 line needs Node.js 20.19 or later and `@antelopejs/core` `>=1.13.2 <2`. The [compatibility table](https://dms.antelopejs.com/docs/frontend/introduction#compatibility) lists every release.
 
 ## Documentation
 

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

@@ -1,13 +1,16 @@
 import { CliError } from "@antelopejs/core/cli";
 import { type FramedCommandResult } from "../common";
 export interface BuildOptions {
-    backendUrl?: string;
-    force?: boolean;
-    offline?: boolean;
-    bootstrapSecret?: string;
-    from?: string;
+    project: string;
+    env: string;
     workspace?: string;
+    force?: boolean;
 }
+export declare const DEFAULT_WORKSPACE_DIR = ".dms-frontend";
+export declare function productionWorkspace(options: {
+    project: string;
+    workspace?: string;
+}): string;
 interface BuildStep {
     script: string;
     name: string;

package/dist/commands/build-action.js

@@ -1,34 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BUILD_STEPS = void 0;
+exports.BUILD_STEPS = exports.DEFAULT_WORKSPACE_DIR = void 0;
+exports.productionWorkspace = productionWorkspace;
 exports.buildStepFailure = buildStepFailure;
 exports.runBuild = runBuild;
 const node_path_1 = require("node:path");
 const cli_1 = require("@antelopejs/core/cli");
 const child_output_1 = require("../child-output");
 const common_1 = require("../common");
-const snapshot_1 = require("../snapshot");
 const output_1 = require("../output");
 const vite_output_1 = require("../vite-output");
+const entry_weight_1 = require("../entry-weight");
 const workspace_task_1 = require("./workspace-task");
-function buildSource(options) {
-    if (!options.from) {
-        return { backendUrl: (0, common_1.requireBackendUrl)(options.backendUrl) };
-    }
-    if (options.offline) {
-        throw new cli_1.CliError({
-            title: "--from and --offline cannot be combined",
-            reason: "A snapshot build never asks the backend already.",
-            fixes: ["Drop --offline"],
-        });
-    }
-    const snapshot = (0, snapshot_1.readSnapshot)(options.from);
-    return {
-        backendUrl: options.backendUrl
-            ? (0, common_1.parseBackendUrl)(options.backendUrl)
-            : snapshot.backendUrl,
-        snapshot: { dir: options.from, snapshot },
-    };
+exports.DEFAULT_WORKSPACE_DIR = ".dms-frontend";
+function productionWorkspace(options) {
+    return options.workspace ?? (0, node_path_1.join)(options.project, exports.DEFAULT_WORKSPACE_DIR);
 }
 exports.BUILD_STEPS = [
     {
@@ -122,27 +108,16 @@ async function runBuild(options) {
     }
 }
 async function buildProduction(options, startedAt) {
-    const { backendUrl, snapshot } = buildSource(options);
-    const bootstrapSecret = snapshot
-        ? undefined
-        : (0, common_1.normalizeBootstrapSecret)(options.bootstrapSecret);
+    (0, entry_weight_1.entryWeightThreshold)(process.env);
     const ui = (0, cli_1.getProcessUi)();
-    (0, output_1.writeHeader)("build", [backendUrl, "production"]);
-    const { workspaceDir, layers, manifestFromCache, manifestFetchedAt, buildOrigin, } = await (0, workspace_task_1.setUpWorkspace)({
-        backendUrl,
+    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",
-        offline: snapshot ? false : (0, common_1.flagOrEnv)(options.offline, "DMS_OFFLINE"),
-        bootstrapSecret,
-        workspaceDir: options.workspace,
-        snapshot,
+        workspaceDir: workspace,
+        project: { projectDir: options.project, environment: options.env },
     });
-    if (snapshot) {
-        ui.message("info", `Building from the snapshot of ${snapshot.snapshot.backendUrl}${(0, output_1.cachedAge)(snapshot.snapshot.takenAt)}`, { detail: `Modules digest ${snapshot.snapshot.digest}` });
-    }
-    else if (manifestFromCache) {
-        ui.message("warn", `Building from the manifest and layers archive${(0, output_1.cachedAge)(manifestFetchedAt)}`, { detail: "The output may not match the current backend." });
-    }
     ui.message("info", "Building for production", {
         detail: `Workspace  ${(0, output_1.showWorkspace)(workspaceDir)}`,
     });
@@ -162,8 +137,8 @@ async function buildProduction(options, startedAt) {
     };
     for (const step of exports.BUILD_STEPS)
         await runBuildStep(step, context);
-    (0, snapshot_1.writeBuildOrigin)(workspaceDir, buildOrigin);
     (0, vite_output_1.reportViteWarnings)(context.warnings, isVerbose, ui);
+    (0, entry_weight_1.reportEntryWeight)(ui, workspaceDir, process.env);
     (0, output_1.writeBlankLine)();
     ui.summary({
         headline: "Built the production frontend",
@@ -172,9 +147,9 @@ async function buildProduction(options, startedAt) {
         nextSteps: [
             {
                 command: options.workspace
-                    ? `ajs dms start -b ${backendUrl} --workspace ${options.workspace}`
-                    : `ajs dms start -b ${backendUrl}`,
-                description: "with DMS_SESSION_SECRET and the server's secrets in its environment",
+                    ? `ajs dms start -b <backend> --workspace ${options.workspace}`
+                    : "ajs dms start -b <backend>",
+                description: "from the project, with DMS_SESSION_SECRET, the server's secrets and the deployment's variables in its environment",
             },
         ],
     });

package/dist/commands/build.js

@@ -39,28 +39,22 @@ const config_1 = require("../config");
 const cli_1 = require("@antelopejs/core/cli");
 const BUILD_EXAMPLES = [
     {
-        description: "With DMS_BOOTSTRAP_SECRET set in the environment or ./.env",
-        command: "ajs dms build -b https://dms.example.com",
+        description: "From the project root, into .dms-frontend: no backend, no secret, no network",
+        command: "ajs dms build",
     },
     {
-        description: "From a snapshot, without the backend or any secret, into the project (a container image)",
-        command: "ajs dms build --from dms-snapshot --workspace .dms-frontend",
-    },
-    {
-        description: "Rebuild from the cache while the backend is down",
-        command: "ajs dms build -b https://dms.example.com --offline",
+        description: "With another environment's configuration, into a directory",
+        command: "ajs dms build -e staging --workspace /srv/dms-frontend",
     },
 ];
 function cmdBuild() {
     const command = new commander_1.Command("build")
         .summary("Build the production frontend")
-        .description("Build the production frontend from the manifest and layers archive the backend serves, or from a snapshot of them, into the workspace's dist directory. The build holds no secret: the server reads its own from its environment when it starts.")
-        .addOption(config_1.Options.backendUrl("Backend URL to build for; required, as -b or the variable, unless --from names a snapshot"))
-        .addOption(new commander_1.Option("--from <dir>", "Build from the snapshot in this directory (ajs dms snapshot), without the backend"))
-        .addOption(config_1.Options.workspace("Build into this directory instead of the workspace under ~/.antelopejs, to ship it with the project"))
-        .addOption(config_1.Options.force("Extract the layers archive from scratch and reinstall the workspace dependencies"))
-        .addOption(config_1.Options.offline("Build from the last cached manifest and layers archive, without the backend"))
-        .addOption(config_1.Options.bootstrapSecret())
+        .description("Build the production frontend from the AntelopeJS project itself: its antelope.config.ts, evaluated for the environment, and the frontend of each installed module that declares one (dmsFrontend in its package.json). No backend is asked. The build holds no secret, and start computes the modules' options again from the deployment's variables.")
+        .addOption(config_1.Options.project)
+        .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"))
         .action(async (options) => (await Promise.resolve().then(() => __importStar(require("./build-action")))).runBuild(options));
     return (0, cli_1.withExamples)(command, BUILD_EXAMPLES);
 }

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

@@ -4,5 +4,7 @@ export interface DevOptions {
     force?: boolean;
     offline?: boolean;
     bootstrapSecret?: string;
+    project?: string;
+    env?: string;
 }
 export declare function runDev(options: DevOptions): Promise<void>;

package/dist/commands/dev-action.js

@@ -12,7 +12,9 @@ const server_process_1 = require("../server-process");
 const update_check_1 = require("../update-check");
 const manifest_1 = require("../manifest");
 const module_set_1 = require("../module-set");
+const project_modules_1 = require("../project-modules");
 const workspace_task_1 = require("./workspace-task");
+const BASE_ENVIRONMENT = "default";
 function clientHost() {
     const host = process.env.HOST?.trim();
     if (!host || host === "0.0.0.0" || host === "::" || host === "[::]") {
@@ -40,6 +42,10 @@ async function runDev(options) {
     const offline = (0, common_1.flagOrEnv)(options.offline, "DMS_OFFLINE");
     const sessionSecret = (0, common_1.resolveSessionSecret)("dev");
     const { backendUrl, workspaceKey, projectDir } = resolveBackend(options);
+    const project = {
+        projectDir: options.project ?? projectDir ?? process.cwd(),
+        environment: options.env ?? BASE_ENVIRONMENT,
+    };
     const bootstrapSecret = (0, common_1.resolveBootstrapSecret)(options.bootstrapSecret, backendUrl);
     const ui = (0, cli_1.getProcessUi)();
     (0, output_1.writeHeader)("dev", [backendUrl, "development"]);
@@ -57,6 +63,7 @@ async function runDev(options) {
         clientUrl,
         workspaceKey,
         bootstrapSecret,
+        project,
     });
     if (port !== requestedPort) {
         ui.message("warn", `Port ${requestedPort} is busy, using ${port}`);
@@ -102,14 +109,18 @@ async function runDev(options) {
             clientUrl,
             workspaceKey,
             bootstrapSecret: session.bootstrapSecret,
+            project,
         });
     }
 }
-function servedModules(setup) {
+function backendModuleSet(setup) {
     return (0, manifest_1.readCachedManifest)(setup.workspaceDir)?.manifest.modules ?? [];
 }
 function reportServed(session, setup) {
-    return (0, module_set_1.reportFrontendReady)(session.backendUrl, servedModules(setup).map((module) => module.name), session.bootstrapSecret);
+    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),
+    })), session.bootstrapSecret);
 }
 async function serveWorkspace(session, setup) {
     const restart = new AbortController();
@@ -122,7 +133,7 @@ async function serveWorkspace(session, setup) {
                 session.bootstrapSecret = session.refreshBootstrapSecret();
                 return session.bootstrapSecret;
             },
-            fingerprint: (0, module_set_1.moduleSetFingerprint)(servedModules(setup)),
+            fingerprint: (0, module_set_1.moduleSetFingerprint)(backendModuleSet(setup)),
             onChange: () => restart.abort(),
             onUnchanged: () => void reportServed(session, setup),
         });

package/dist/commands/dev.js

@@ -50,8 +50,10 @@ const DEV_EXAMPLES = [
 function cmdDev() {
     const command = new commander_1.Command("dev")
         .summary("Run the dev server against a local backend, with hot reload")
-        .description("Run the dev server with hot reload. It reads the frontend modules in place, from the backend's own directories, so the backend runs on this machine.")
+        .description("Run the dev server with hot reload. It reads the frontend modules from the AntelopeJS project as build does, each module's frontendModule called with dev: true, and serves them in place from their sources. The backend, on this machine, gives the secrets it holds and says when the module store changes its modules.")
         .addOption(config_1.Options.backendUrl("Backend URL; when omitted, discovered from the enclosing antelope project's .antelope/dev.json"))
+        .addOption(new commander_1.Option("--project <dir>", "The AntelopeJS project the modules are read from (default: the discovered backend's, else the current directory)"))
+        .addOption(new commander_1.Option("-e, --env <environment>", "The AntelopeJS environment the backend runs, as ajs project dev -e (default: the base configuration)").env("ANTELOPEJS_LAUNCH_ENV"))
         .addOption(config_1.Options.port)
         .addOption(config_1.Options.force("Reinstall the workspace dependencies"))
         .addOption(config_1.Options.offline("Reuse the last cached manifest instead of fetching it"))

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

@@ -1,6 +1,8 @@
 export interface StartOptions {
     backendUrl?: string;
     port: string;
+    project: string;
+    env: string;
     workspace?: string;
 }
 export declare function runStart(options: StartOptions): Promise<void>;

package/dist/commands/start-action.js

@@ -10,11 +10,12 @@ const ports_1 = require("../ports");
 const server_process_1 = require("../server-process");
 const update_check_1 = require("../update-check");
 const module_set_1 = require("../module-set");
-const snapshot_1 = require("../snapshot");
+const project_modules_1 = require("../project-modules");
 const config_1 = require("../config");
 const manifest_secrets_1 = require("../manifest-secrets");
 const private_values_1 = require("../private-values");
-const BUILD_TIME_MANIFEST = "the build-time manifest";
+const build_action_1 = require("./build-action");
+const PUBLIC_OPTIONS_VARIABLE = "DMS_PUBLIC_OPTIONS";
 function builtPrivateOptions(workspaceDir) {
     try {
         const { modules } = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(workspaceDir, config_1.SERVER_OPTIONS_FILE), "utf8"));
@@ -51,72 +52,83 @@ function serverNodeEnv() {
     }
     return nodeEnv;
 }
-async function reportDrift(backendUrl, origin) {
-    const ui = (0, cli_1.getProcessUi)();
-    const bootstrapSecret = process.env.DMS_BOOTSTRAP_SECRET?.trim();
-    if (!origin)
-        return;
-    if (origin.authenticated === false) {
-        ui.message("info", `Built from modules ${origin.digest}; not compared with the backend`, {
-            detail: "The build read the manifest without DMS_BOOTSTRAP_SECRET, which leaves out the backend proxies.",
-        });
-        return;
+function publicOptionsById(modules) {
+    return Object.fromEntries(modules.map(({ layer }) => {
+        const options = layer.options ?? {};
+        return [
+            (0, common_1.getLayerSafeName)(layer),
+            layer.configKey ? { [layer.configKey]: options } : options,
+        ];
+    }));
+}
+function builtModules(workspaceDir) {
+    try {
+        const { modules } = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(workspaceDir, "generated-frontend-modules.json"), "utf8"));
+        return (modules ?? []).map((module) => ({
+            name: module.name ?? module.id,
+            version: module.version,
+        }));
     }
-    if (!bootstrapSecret) {
-        ui.message("info", `Built from modules ${origin.digest}; not compared with the backend`, { detail: "Set DMS_BOOTSTRAP_SECRET to have start compare them." });
-        return;
+    catch {
+        return [];
     }
-    const drift = await (0, module_set_1.compareWithBackend)(backendUrl, origin.digest, snapshot_1.manifestDigest, bootstrapSecret);
-    if (drift.status === "matches") {
-        ui.message("info", `The backend serves the modules ${origin.digest} this build was made from`);
+}
+function reportModuleSetDrift(built, modules) {
+    const builtNames = new Set(built.map(({ name }) => name));
+    const currentNames = new Set(modules.map(({ layer }) => layer.name ?? layer.path));
+    const added = [...currentNames].filter((name) => !builtNames.has(name));
+    const removed = [...builtNames].filter((name) => !currentNames.has(name));
+    if (added.length === 0 && removed.length === 0)
         return;
-    }
-    if (drift.status === "unknown") {
-        ui.message("info", `Built from modules ${origin.digest}; not compared with the backend: ${drift.reason}`);
+    const ui = (0, cli_1.getProcessUi)();
+    ui.message("warn", "The project's modules differ from the ones the build serves: rebuild to apply them", {
+        details: [
+            ...(added.length > 0
+                ? [`Not in the build: ${added.sort().join(", ")}`]
+                : []),
+            ...(removed.length > 0
+                ? [`Built, no longer in the project: ${removed.sort().join(", ")}`]
+                : []),
+            `${ui.symbols.levels.hint} Build again with the deployment's variables: ajs dms build`,
+        ],
+    });
+}
+async function reportServedModules(backendUrl, modules) {
+    const isTaken = await (0, module_set_1.reportFrontendReadyOnceAnswered)(backendUrl, modules, process.env.DMS_BOOTSTRAP_SECRET);
+    const ui = (0, cli_1.getProcessUi)();
+    if (isTaken) {
+        ui.message("info", `[DMS] Reported ${modules.length} modules to the backend (dms-frontend ${module_set_1.OWN_RELEASE.version})`);
         return;
     }
-    const refresh = origin.source === "snapshot"
-        ? `Refresh the snapshot and rebuild: ajs dms snapshot -b ${backendUrl} -o <dir>, then ajs dms build --from <dir>`
-        : `Rebuild: ajs dms build -b ${backendUrl}`;
-    ui.message("warn", `The backend serves modules ${drift.served}; this build was made from ${origin.digest} (${origin.source}${(0, output_1.cachedAge)(origin.takenAt)})`, {
+    ui.message("warn", "[DMS] The backend refused the ready report: it cannot check this build's module versions", {
         details: [
-            "Pages of modules added or removed since, or whose routes changed, are missing or stale.",
-            `${ui.symbols.levels.hint} ${refresh}`,
+            `${ui.symbols.levels.hint} Set DMS_BOOTSTRAP_SECRET to the backend's frontend.bootstrapSecret`,
         ],
     });
 }
 async function runStart(options) {
     const startedAt = Date.now();
-    const explicitWorkspace = options.workspace
-        ? (0, node_path_1.resolve)(options.workspace)
-        : undefined;
-    const origin = explicitWorkspace
-        ? (0, snapshot_1.readBuildOrigin)(explicitWorkspace)
-        : undefined;
-    const backendUrl = (0, common_1.requireBackendUrl)(options.backendUrl ?? origin?.backendUrl);
+    const workspaceDir = (0, node_path_1.resolve)((0, build_action_1.productionWorkspace)(options));
+    const backendUrl = (0, common_1.requireBackendUrl)(options.backendUrl);
     const requestedPort = (0, common_1.parsePort)(options.port);
     const sessionSecret = (0, common_1.resolveSessionSecret)("start");
-    const workspaceDir = explicitWorkspace ?? (0, common_1.getWorkspaceDir)(backendUrl);
     const serverPath = (0, node_path_1.join)(workspaceDir, "server.mjs");
     const clientPath = (0, node_path_1.join)(workspaceDir, "dist", "client", "index.html");
     if (!(0, node_fs_1.existsSync)(serverPath) || !(0, node_fs_1.existsSync)(clientPath)) {
         throw new cli_1.CliError({
-            title: `No production build for ${backendUrl}`,
+            title: "No production build to serve",
             reason: `${(0, output_1.showWorkspace)(workspaceDir)} has no built server or client.`,
             fixes: [
-                explicitWorkspace
-                    ? `Build it first: ajs dms build --from <snapshot> --workspace ${options.workspace}`
-                    : `Build it first: ajs dms build -b ${backendUrl}`,
+                options.workspace
+                    ? `Build it first: ajs dms build --workspace ${options.workspace}`
+                    : "Build it first: ajs dms build",
             ],
         });
     }
-    if (!explicitWorkspace) {
-        (0, common_1.writeWorkspaceMeta)(workspaceDir, backendUrl, (0, common_1.canonicalizeBackendUrl)(backendUrl));
-    }
     const builtAt = (0, node_fs_1.statSync)(clientPath).mtime.toISOString();
     (0, output_1.writeHeader)("start", [
         backendUrl,
-        "production",
+        options.env,
         `built ${(0, output_1.formatAge)(builtAt)}`,
     ]);
     const reserved = await (0, ports_1.reservePort)(requestedPort);
@@ -129,10 +141,16 @@ async function runStart(options) {
         });
     }
     const port = reserved.port;
-    const secrets = (0, common_1.resolveManifestSecrets)((0, common_1.collectManifestSecrets)((0, common_1.readCachedManifest)(workspaceDir)?.manifest.modules ?? []));
+    const modules = await (0, project_modules_1.readProjectFrontendModules)({
+        projectDir: options.project,
+        environment: options.env,
+    });
+    const built = builtModules(workspaceDir);
+    reportModuleSetDrift(built, modules);
+    const secrets = (0, common_1.resolveManifestSecrets)({ published: {}, conflicts: [] });
     (0, common_1.reportManifestSecrets)(secrets, (count) => `Set ${count === 1 ? "it" : "them"} in the server's environment, with the value${count === 1 ? "" : "s"} the backend uses`);
     reportUnfilledPrivateValues(workspaceDir);
-    const secretSources = (0, common_1.describeSecretSources)(secrets.sources, BUILD_TIME_MANIFEST);
+    const secretSources = (0, common_1.describeSecretSources)(secrets.sources);
     const nodeEnv = serverNodeEnv();
     await reserved.release();
     const code = await (0, server_process_1.runServer)({
@@ -145,6 +163,7 @@ async function runStart(options) {
             PORT: String(port),
             DMS_API_BASE_URL: backendUrl,
             DMS_SESSION_SECRET: sessionSecret,
+            [PUBLIC_OPTIONS_VARIABLE]: JSON.stringify(publicOptionsById(modules)),
             ...secrets.env,
             DMS_COOKIE_SECURE: process.env.DMS_COOKIE_SECURE ?? "true",
         },
@@ -160,9 +179,8 @@ async function runStart(options) {
                 ]),
                 footer: "Ctrl+C to stop",
             });
-            void (0, module_set_1.reportFrontendReady)(backendUrl, ((0, common_1.readCachedManifest)(workspaceDir)?.manifest.modules ?? []).map((module) => module.name), process.env.DMS_BOOTSTRAP_SECRET);
+            void reportServedModules(backendUrl, built);
             void (0, update_check_1.reportAvailableUpdate)({ isFollowed: true });
-            void reportDrift(backendUrl, origin ?? (0, snapshot_1.readBuildOrigin)(workspaceDir));
         },
     });
     process.exitCode = code;

package/dist/commands/start.js

@@ -39,21 +39,23 @@ const config_1 = require("../config");
 const cli_1 = require("@antelopejs/core/cli");
 const START_EXAMPLES = [
     {
-        description: "After ajs dms build -b https://dms.example.com",
-        command: "ajs dms start -b https://dms.example.com -p 3001",
+        description: "From the project root, after ajs dms build",
+        command: "ajs dms start -b https://api.example.com -p 3001",
     },
     {
-        description: "From a build shipped with the project, in a read-only container",
+        description: "In a read-only container holding the project and its build",
         command: "ajs dms start --workspace .dms-frontend -p 3000",
     },
 ];
 function cmdStart() {
     const command = new commander_1.Command("start")
         .summary("Serve the production build")
-        .description("Serve the production frontend ajs dms build made for the same backend URL, or the one in --workspace. Reads DMS_SESSION_SECRET and the server's secrets (DMS_HTML_RENDER_SECRET, DMS_OAUTH_RELAY_SECRET) from its environment, and says once ready whether the backend still serves the modules the build was made from.")
-        .addOption(config_1.Options.backendUrl("Backend URL to serve; required, as -b or the variable, unless --workspace holds a build that records it"))
+        .description("Serve the production frontend ajs dms build made from the project. The modules' public options are computed again from the project's configuration and the current environment variables, so a deployment's variables need no rebuild. Reads DMS_SESSION_SECRET and the server's secrets (DMS_HTML_RENDER_SECRET, DMS_OAUTH_RELAY_SECRET) from its environment, and tells the backend once ready which module versions it serves.")
+        .addOption(config_1.Options.backendUrl("Backend URL to serve; required"))
         .addOption(config_1.Options.port)
-        .addOption(config_1.Options.workspace("Serve the build in this directory (ajs dms build --workspace); start writes nothing into it"))
+        .addOption(config_1.Options.project)
+        .addOption(config_1.Options.env)
+        .addOption(config_1.Options.workspace("Serve the build in this directory instead of <project>/.dms-frontend; start writes nothing into it"))
         .action(async (options) => (await Promise.resolve().then(() => __importStar(require("./start-action")))).runStart(options));
     return (0, cli_1.withExamples)(command, START_EXAMPLES);
 }

package/dist/common.d.ts

@@ -8,6 +8,7 @@ export * from "./manifest-secrets";
 export * from "./layer-watch";
 export * from "./materialize";
 export * from "./derived-outputs";
+export * from "./locale-files";
 export * from "./app-configs";
 export * from "./renderer-range";
 export * from "./workspace";

package/dist/common.js

@@ -24,6 +24,7 @@ __exportStar(require("./manifest-secrets"), exports);
 __exportStar(require("./layer-watch"), exports);
 __exportStar(require("./materialize"), exports);
 __exportStar(require("./derived-outputs"), exports);
+__exportStar(require("./locale-files"), exports);
 __exportStar(require("./app-configs"), exports);
 __exportStar(require("./renderer-range"), exports);
 __exportStar(require("./workspace"), exports);

package/dist/config.d.ts

@@ -33,6 +33,8 @@ export declare const Options: {
     offline(description: string): Option;
     strict: Option;
     workspace(description: string): Option;
+    project: Option;
+    env: Option;
     bootstrapSecret(discovery?: string): Option;
 };
 export interface BootstrapDiscoveryOptions extends DiscoveryOptions {

package/dist/config.js

@@ -62,15 +62,20 @@ exports.TEMPLATE_FILES = [
     ["globals.d.ts", "globals.d.ts"],
     ["compress-assets.mjs", "compress-assets.mjs"],
     ["head-order.mjs", "head-order.mjs"],
+    ["client-chunking.mjs", "client-chunking.mjs"],
+    ["entry-weight.mjs", "entry-weight.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"],
+    ["sfc-global-types.mjs", "sfc-global-types.mjs"],
     ["icon-api.mjs", "icon-api.mjs"],
     ["icon-scan.mjs", "icon-scan.mjs"],
+    ["ui-kbd.mjs", "ui-kbd.mjs"],
     ["email-renderer.ts", "email-renderer.ts"],
     ["email-runtime.ts", "email-runtime.ts"],
     ["email-locales.ts", "email-locales.ts"],
     ["email-markup.ts", "email-markup.ts"],
+    ["public-options.ts", "public-options.ts"],
     ["tsconfig.json", "tsconfig.json"],
     ["typecheck-loader.mjs", "typecheck-loader.mjs"],
     ["prepare-types.mjs", "prepare-types.mjs"],
@@ -185,6 +190,10 @@ exports.Options = {
     workspace(description) {
         return new commander_1.Option("--workspace <dir>", description).env("DMS_WORKSPACE_DIR");
     },
+    project: new commander_1.Option("--project <dir>", "The AntelopeJS project whose antelope.config.ts and installed modules make the frontend").default("."),
+    env: new commander_1.Option("-e, --env <environment>", "The AntelopeJS environment whose configuration applies, as ajs project start -e")
+        .default("production")
+        .env("ANTELOPEJS_LAUNCH_ENV"),
     bootstrapSecret(discovery) {
         return new commander_1.Option("--bootstrap-secret <secret>", discovery
             ? `${BOOTSTRAP_SECRET_DESCRIPTION}. ${discovery}`

package/dist/derived-outputs.d.ts

@@ -3,6 +3,7 @@ export interface FrontendModuleRegistryEntry {
     id: string;
     name?: string;
     packageName?: string;
+    version?: string;
     root: string;
     priority: number;
     entry?: string;
@@ -14,11 +15,6 @@ export interface FrontendModuleRegistry {
     modules: FrontendModuleRegistryEntry[];
 }
 export declare function createFrontendModuleRegistry(workspaceDir: string, layers: ResolvedLayer[]): FrontendModuleRegistry;
-export declare class InvalidLocaleFileError extends Error {
-    readonly path: string;
-    readonly reason: string;
-    constructor(path: string, reason: string);
-}
 export declare function affectsLocaleMessages(relativePath: string): boolean;
 export declare function writeLocaleMessages(workspaceDir: string, registry: FrontendModuleRegistry): boolean;
 export interface DerivedOutput {