@antelopejs/dms-frontend 0.9.3 → 0.10.0

package/README.md

@@ -2,15 +2,15 @@
 
 <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="Antelope DMS" src="https://raw.githubusercontent.com/AntelopeJS/dms/main/packages/dms/frontend-vue/layers/dms-layout/public/images/antelope-logo/light.svg" height="72">
+  <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>
 
-# @antelopejs/dms-frontend
+# `@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"></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"></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"></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"></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>
 
 **The frontend of the AntelopeJS DMS: the `ajs dms` CLI, the Vue renderer and the frontend-module SDK.**
 
@@ -18,19 +18,19 @@
 
 </div>
 
-![The browser talks to the frontend server, which renders pages, answers module routes and proxies declared backend prefixes to the DMS backend; at build time ajs dms fetches the manifest and writes a workspace](./docs/images/architecture.svg)
+![The browser talks to the frontend server, which renders pages, answers module routes and proxies declared backend prefixes to the DMS backend, while the development and prepare commands fetch the manifest and write a workspace](./docs/images/architecture.svg "illustration")
 
 ## What it does
 
-- Asks a DMS backend which frontend modules it loads, materializes them into a generated workspace, builds it, and runs the frontend server.
-- Renders the dashboard with Vue 3, Vite, Inertia and server-side rendering.
-- Keeps the backend token on the server: the browser only holds a sealed, `HttpOnly` session cookie, and declared backend prefixes are proxied with the session's token.
+- Reads the frontend modules of an AntelopeJS project, materializes them into a generated workspace, builds it, and runs the frontend server.
+- Renders the dashboard with Vue, Vite, Inertia and server-side rendering.
+- Keeps the backend token on the server. The browser only holds a sealed, `HttpOnly` session cookie, and the server adds the session's token to each request it proxies to a declared backend prefix.
 - Lets a module extend the dashboard with pages, components and plugins (`dms.frontend.ts`), server routes (`dms.server.ts`) and build-time declarations (`dms.frontend.build.ts`).
 - Serves development with hot reload, and production with pre-compressed assets.
 
 ## Install
 
-Add the package next to `@antelopejs/core`; the core `ajs` command runs it as `ajs dms`:
+Add the package next to `@antelopejs/core`. The core `ajs` command runs it as `ajs dms`.
 
 ```bash
 pnpm add -D @antelopejs/core @antelopejs/dms-frontend
@@ -38,20 +38,20 @@ pnpm add -D @antelopejs/core @antelopejs/dms-frontend
 
 ## Quick start
 
-In a DMS project started with `ajs project run -w`, serve the dashboard with hot reload:
+In a DMS project started with `ajs project dev -w`, serve the dashboard with hot reload:
 
 ```bash
 pnpm exec ajs dms dev
 ```
 
-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:
+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
 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.
+`ajs dms --help` lists every command, and `ajs dms help environment` lists every environment variable.
 
 ## Compatibility
 
@@ -59,17 +59,11 @@ pnpm exec ajs dms start -b https://api.example.com -p 3001
 
 | Package            | Supported     | Tested with |
 | ------------------ | ------------- | ----------- |
-| `@antelopejs/core` | `>=1.16.0 <2` | `1.16.0`    |
+| `@antelopejs/core` | `>=1.16.0 <2` | `1.20.0`    |
 
 <!-- antelopejs-docs-compat:end -->
 
-| `@antelopejs/dms` | `@antelopejs/dms-frontend` |
-| --- | --- |
-| 0.9.1 and later | `>=0.6.1 <0.7.0` |
-| 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.19 or later and `@antelopejs/core` `>=1.13.2 <2`. The [compatibility table](https://dms.antelopejs.com/docs/frontend/introduction#compatibility) lists every release.
+Each DMS release declares the renderer releases it runs on in `engines["@antelopejs/dms-frontend"]` of its frontend module's `package.json`. The `ajs dms` CLI refuses to build a module whose range excludes the installed renderer. To find the renderer releases that match a DMS release, read that `engines` range in the installed DMS frontend module, as the [Compatibility](https://dms.antelopejs.com/docs/frontend/introduction#compatibility) section of the introduction explains. The renderer needs the `@antelopejs/core` range in the table above, and the `engines` field of its `package.json` sets the Node.js versions it runs on.
 
 ## Documentation
 
@@ -90,12 +84,12 @@ Read [CONTRIBUTING.md](./CONTRIBUTING.md) before opening a pull request.
 ```bash
 pnpm install
 pnpm build
-pnpm lint          # oxlint, oxfmt, interface ranges and the docs reference check
+pnpm lint          # oxlint, interface ranges, the docs reference check and the source checks
 pnpm typecheck
 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.
+`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.
 
 ## License
 

package/dist/commands/build-action.js

@@ -12,6 +12,7 @@ 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");
+const node_options_1 = require("../node-options");
 exports.DEFAULT_WORKSPACE_DIR = ".dms-frontend";
 function productionWorkspace(options) {
     return options.workspace ?? (0, node_path_1.join)(options.project, exports.DEFAULT_WORKSPACE_DIR);
@@ -87,7 +88,7 @@ async function runBuildStep(step, context) {
         });
     }
     catch (error) {
-        (0, output_1.endInterruptedTask)(task, error, step.stopped);
+        (0, output_1.endInterruptedTask)(task, error instanceof common_1.CancelledError ? error : undefined, step.stopped);
         throw error;
     }
     if (result.code !== 0) {
@@ -130,7 +131,7 @@ async function buildProduction(options, startedAt) {
         nameFile: (0, child_output_1.createFileNamer)(layers),
         env: {
             ...process.env,
-            NODE_OPTIONS: "--max-old-space-size=4096",
+            NODE_OPTIONS: (0, node_options_1.serverNodeOptions)(process.env.NODE_OPTIONS),
             NODE_PATH: (0, node_path_1.join)(workspaceDir, "node_modules"),
             [vite_output_1.VITE_LOG_LEVEL_VARIABLE]: (0, vite_output_1.viteLogLevel)(isVerbose),
         },

package/dist/commands/dev-action.js

@@ -14,6 +14,7 @@ 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 node_options_1 = require("../node-options");
 const BASE_ENVIRONMENT = "default";
 function clientHost() {
     const host = process.env.HOST?.trim();
@@ -175,7 +176,7 @@ function runDevServer(session, setup, stopSignal) {
             DMS_BOOTSTRAP_SECRET: session.bootstrapSecret,
             DMS_SESSION_SECRET: session.sessionSecret,
             ...secrets.env,
-            NODE_OPTIONS: "--max-old-space-size=4096",
+            NODE_OPTIONS: (0, node_options_1.serverNodeOptions)(process.env.NODE_OPTIONS),
             NODE_PATH: nodeModulesDir,
         },
         onReady: (address) => {

package/dist/commands/prepare-action.js

@@ -44,7 +44,7 @@ async function runPrepare(options) {
     catch (err) {
         if (err instanceof common_1.CancelledError || strict)
             throw err;
-        const [title, ...details] = (0, output_1.failureDetails)(err, ui);
+        const [title, ...details] = (0, output_1.failureDetails)((0, output_1.classifyFailure)(err), ui);
         const outcome = isSkip(err) ? "Skipped prepare" : "Prepare failed";
         ui.message("warn", `${outcome}: ${title}`, {
             details: [...details, NOT_GENERATED, STRICT_HINT],

package/dist/commands/start-action.js

@@ -11,22 +11,13 @@ const server_process_1 = require("../server-process");
 const update_check_1 = require("../update-check");
 const module_set_1 = require("../module-set");
 const project_modules_1 = require("../project-modules");
-const config_1 = require("../config");
+const built_workspace_1 = require("../internal/built-workspace");
 const manifest_secrets_1 = require("../manifest-secrets");
 const private_values_1 = require("../private-values");
 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"));
-        return modules ?? {};
-    }
-    catch {
-        return {};
-    }
-}
 function reportUnfilledPrivateValues(workspaceDir) {
-    const unfilled = (0, private_values_1.unfilledPrivateValues)(builtPrivateOptions(workspaceDir), (0, private_values_1.parsePrivateOptions)(process.env[private_values_1.PRIVATE_OPTIONS_VARIABLE]), Object.values(manifest_secrets_1.MANIFEST_SECRET_ENV));
+    const unfilled = (0, private_values_1.unfilledPrivateValues)((0, built_workspace_1.readBuiltPrivateOptions)(workspaceDir), (0, private_values_1.parsePrivateOptions)(process.env[private_values_1.PRIVATE_OPTIONS_VARIABLE]), Object.values(manifest_secrets_1.MANIFEST_SECRET_ENV));
     const ui = (0, cli_1.getProcessUi)();
     unfilled.forEach(({ module, path }, index) => {
         const isLast = index === unfilled.length - 1;
@@ -61,18 +52,6 @@ function publicOptionsById(modules) {
         ];
     }));
 }
-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,
-        }));
-    }
-    catch {
-        return [];
-    }
-}
 function reportModuleSetDrift(built, modules) {
     const builtNames = new Set(built.map(({ name }) => name));
     const currentNames = new Set(modules.map(({ layer }) => layer.name ?? layer.path));
@@ -145,7 +124,7 @@ async function runStart(options) {
         projectDir: options.project,
         environment: options.env,
     });
-    const built = builtModules(workspaceDir);
+    const built = (0, built_workspace_1.readBuiltModules)(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`);

package/dist/commands/workspace-task.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setUpWorkspace = setUpWorkspace;
 const cli_1 = require("@antelopejs/core/cli");
+const cancellation_1 = require("../cancellation");
 const common_1 = require("../common");
 const output_1 = require("../output");
 async function setUpWorkspace(options) {
@@ -20,7 +21,7 @@ async function setUpWorkspace(options) {
         return result;
     }
     catch (error) {
-        (0, output_1.endInterruptedTask)(task, error, "Workspace setup stopped");
+        (0, output_1.endInterruptedTask)(task, error instanceof cancellation_1.CancelledError ? error : undefined, "Workspace setup stopped");
         throw error;
     }
 }

package/dist/derived-outputs.js

@@ -140,16 +140,16 @@ function discoverAssets(registry, directory, extensions) {
 const LOCALE_DIRECTORY = "i18n/locales";
 function readLocaleMessages(assets, registry) {
     const roots = new Map(registry.modules.map((module) => [module.id, module.root]));
-    const messages = {};
+    const messages = new Map();
     for (const asset of assets) {
         const locale = asset.relativePath.match(/(?:^|[/-])([a-z]{2})-[A-Z]{2}\.json$/)?.[1];
         const root = roots.get(asset.moduleId);
         if (!locale || !root)
             continue;
         const value = (0, locale_files_1.readLocaleFile)((0, node_path_1.join)(root, asset.relativePath));
-        messages[locale] = (0, locale_catalogs_1.mergeLocaleMessages)(value, messages[locale] ?? {});
+        messages.set(locale, (0, locale_catalogs_1.mergeLocaleMessages)(value, messages.get(locale) ?? {}));
     }
-    return messages;
+    return Object.fromEntries(messages);
 }
 function affectsLocaleMessages(relativePath) {
     return (0, asset_roots_1.affectsAssetDirectory)(LOCALE_DIRECTORY, relativePath);

package/dist/discovery.js

@@ -10,6 +10,7 @@ const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const output_1 = require("./output");
 const guards_1 = require("./internal/guards");
+const plain_object_1 = require("./internal/plain-object");
 exports.DEV_REGISTRY_RELATIVE_PATH = (0, node_path_1.join)(".antelope", "dev.json");
 function isPidAlive(pid) {
     if (!Number.isInteger(pid) || pid <= 0)
@@ -22,13 +23,23 @@ function isPidAlive(pid) {
         return err?.code === "EPERM";
     }
 }
+function isEndpoint(value) {
+    return ((0, plain_object_1.isPlainObject)(value) &&
+        (0, guards_1.isText)(value.protocol) &&
+        (0, guards_1.isText)(value.host) &&
+        (0, guards_1.isNumber)(value.port));
+}
+function isServer(value) {
+    return ((0, plain_object_1.isPlainObject)(value) &&
+        Array.isArray(value.endpoints) &&
+        value.endpoints.every(isEndpoint));
+}
 function isDevRegistry(value) {
-    return ((0, guards_1.isObjectLike)(value) &&
-        "pid" in value &&
-        typeof value.pid === "number" &&
-        "servers" in value &&
-        typeof value.servers === "object" &&
-        value.servers !== null);
+    return ((0, plain_object_1.isPlainObject)(value) &&
+        (0, guards_1.isNumber)(value.pid) &&
+        (value.startedAt === undefined || (0, guards_1.isText)(value.startedAt)) &&
+        (0, plain_object_1.isPlainObject)(value.servers) &&
+        Object.values(value.servers).every(isServer));
 }
 function parseRegistry(file) {
     try {

package/dist/entry-weight.js

@@ -10,6 +10,8 @@ const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const node_zlib_1 = require("node:zlib");
 const cli_1 = require("@antelopejs/core/cli");
+const guards_1 = require("./internal/guards");
+const plain_object_1 = require("./internal/plain-object");
 const output_1 = require("./output");
 exports.ENTRY_WEIGHT_VARIABLE = "DMS_ENTRY_WEIGHT_WARNING";
 exports.DEFAULT_ENTRY_WEIGHT_WARNING_KB = 50;
@@ -18,6 +20,14 @@ const SHARED_OWNER = "shared";
 const TRANSLATIONS_OWNER = "translations";
 const NON_MODULE_OWNERS = new Set([SHARED_OWNER, TRANSLATIONS_OWNER]);
 const BYTES_PER_KB = 1024;
+function isRecordedEntryWeight(value) {
+    return ((0, plain_object_1.isPlainObject)(value) &&
+        Array.isArray(value.files) &&
+        value.files.every(guards_1.isText) &&
+        (0, guards_1.isNumber)(value.bytes) &&
+        (0, plain_object_1.isPlainObject)(value.owners) &&
+        Object.values(value.owners).every(guards_1.isNumber));
+}
 function brotliSize(file) {
     const compressed = `${file}.br`;
     if ((0, node_fs_1.existsSync)(compressed))
@@ -31,6 +41,11 @@ function readEntryWeight(workspaceDir) {
     if (!(0, node_fs_1.existsSync)(path))
         return undefined;
     const recorded = JSON.parse((0, node_fs_1.readFileSync)(path, "utf8"));
+    if (!isRecordedEntryWeight(recorded))
+        throw new cli_1.CliError({
+            title: "The client build recorded an entry weight this CLI cannot read",
+            fixes: ["Build again"],
+        });
     const brotli = recorded.files.reduce((sum, file) => sum + brotliSize((0, node_path_1.join)(workspaceDir, "dist", "client", file)), 0);
     const ratio = recorded.bytes ? brotli / recorded.bytes : 0;
     const shares = Object.entries(recorded.owners)

package/dist/fs-sync.js

@@ -18,6 +18,7 @@ const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const ignore_1 = __importDefault(require("ignore"));
 const config_1 = require("./config");
+const plain_object_1 = require("./internal/plain-object");
 function stripExtendedLengthPrefix(p) {
     return p.replace(/^\\\\\?\\/, "");
 }
@@ -32,10 +33,12 @@ function isBlocklistedCopyPath(src, srcPath) {
 }
 function sanitizedPackageContent(raw) {
     const pkg = JSON.parse(raw);
-    delete pkg.devDependencies;
-    if (pkg.scripts) {
-        for (const name of config_1.PNPM_LIFECYCLE_SCRIPTS) {
-            delete pkg.scripts[name];
+    if ((0, plain_object_1.isPlainObject)(pkg)) {
+        delete pkg.devDependencies;
+        if ((0, plain_object_1.isPlainObject)(pkg.scripts)) {
+            for (const name of config_1.PNPM_LIFECYCLE_SCRIPTS) {
+                delete pkg.scripts[name];
+            }
         }
     }
     return `${JSON.stringify(pkg, null, 2)}\n`;

package/dist/index.js

@@ -12,10 +12,11 @@ const start_1 = require("./commands/start");
 const verify_source_1 = require("./commands/verify-source");
 const workspaces_1 = require("./commands/workspaces");
 const env_file_1 = require("./env-file");
+const own_release_1 = require("./internal/own-release");
 const help_1 = require("./help");
 const output_1 = require("./output");
 const update_check_1 = require("./update-check");
-const { version } = require("../package.json");
+const { version } = own_release_1.ownRelease;
 const QUIET_FLAGS = ["-q", "--quiet"];
 const GLOBAL_FLAGS = ["--no-color", ...QUIET_FLAGS];
 const VERBOSE_FLAG = "--verbose";

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

@@ -0,0 +1,4 @@
+import type { ServedModule } from "../module-set";
+import type { FrontendModuleOptions } from "../workspace";
+export declare function readBuiltPrivateOptions(workspaceDir: string): Record<string, FrontendModuleOptions>;
+export declare function readBuiltModules(workspaceDir: string): ServedModule[];

package/dist/internal/built-workspace.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readBuiltPrivateOptions = readBuiltPrivateOptions;
+exports.readBuiltModules = readBuiltModules;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const config_1 = require("../config");
+const guards_1 = require("./guards");
+const manifest_decoder_1 = require("./manifest-decoder");
+const plain_object_1 = require("./plain-object");
+function isOptionsById(value) {
+    return (0, plain_object_1.isPlainObject)(value) && Object.values(value).every(manifest_decoder_1.isModuleOptions);
+}
+function readBuiltPrivateOptions(workspaceDir) {
+    try {
+        const parsed = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(workspaceDir, config_1.SERVER_OPTIONS_FILE), "utf8"));
+        const modules = (0, plain_object_1.isPlainObject)(parsed) ? parsed.modules : undefined;
+        return isOptionsById(modules) ? modules : {};
+    }
+    catch {
+        return {};
+    }
+}
+function readBuiltModules(workspaceDir) {
+    try {
+        const parsed = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(workspaceDir, "generated-frontend-modules.json"), "utf8"));
+        const modules = (0, plain_object_1.isPlainObject)(parsed) ? parsed.modules : undefined;
+        if (!Array.isArray(modules))
+            return [];
+        const listed = modules;
+        return listed.flatMap((module) => (0, plain_object_1.isPlainObject)(module) && (0, guards_1.isText)(module.id)
+            ? [
+                {
+                    name: (0, guards_1.isText)(module.name) ? module.name : module.id,
+                    version: (0, guards_1.isText)(module.version) ? module.version : undefined,
+                },
+            ]
+            : []);
+    }
+    catch {
+        return [];
+    }
+}

package/dist/internal/ensure.d.ts

@@ -0,0 +1 @@
+export declare function ensure(condition: boolean, title: string, reason?: string): asserts condition;

package/dist/internal/ensure.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensure = ensure;
+const cli_1 = require("@antelopejs/core/cli");
+function ensure(condition, title, reason) {
+    if (!condition)
+        throw new cli_1.CliError({ title, reason });
+}

package/dist/internal/locale-catalogs.d.ts

@@ -1,6 +1,11 @@
-export declare function isRecord(value: unknown): value is Record<string, unknown>;
-export declare function mergeLocaleMessages(source: Record<string, unknown>, existing: Record<string, unknown>): Record<string, unknown>;
+export type LocaleValue = string | number | boolean | null | LocaleValue[] | LocaleMessages;
+export interface LocaleMessages {
+    [key: string]: LocaleValue;
+}
+export declare function isLocaleValue(value: unknown): value is LocaleValue;
+export declare function isMessageGroup(value: LocaleValue): value is LocaleMessages;
+export declare function mergeLocaleMessages(source: LocaleMessages, existing: LocaleMessages): LocaleMessages;
 export declare const FALLBACK_LOCALE = "en";
 export declare const RENDERER_TRANSLATED_KEYS: string[];
-export declare function withoutMessage(messages: Record<string, unknown>, key: string): Record<string, unknown>;
+export declare function withoutMessage(messages: LocaleMessages, key: string): LocaleMessages;
 export declare function localeModuleSource(supportedLocales: string[]): string;

package/dist/internal/locale-catalogs.js

@@ -1,19 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RENDERER_TRANSLATED_KEYS = exports.FALLBACK_LOCALE = void 0;
-exports.isRecord = isRecord;
+exports.isLocaleValue = isLocaleValue;
+exports.isMessageGroup = isMessageGroup;
 exports.mergeLocaleMessages = mergeLocaleMessages;
 exports.withoutMessage = withoutMessage;
 exports.localeModuleSource = localeModuleSource;
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
+const guards_1 = require("./guards");
+function isLocaleValue(value) {
+    if (value === null || (0, guards_1.isText)(value) || (0, guards_1.isNumber)(value) || (0, guards_1.isFlag)(value)) {
+        return true;
+    }
+    if (Array.isArray(value))
+        return value.every(isLocaleValue);
+    return (0, guards_1.isObjectLike)(value) && Object.values(value).every(isLocaleValue);
+}
+function isMessageGroup(value) {
+    return (0, guards_1.isObjectLike)(value) && !Array.isArray(value);
 }
 function mergeLocaleMessages(source, existing) {
     const merged = { ...source };
     for (const [key, value] of Object.entries(existing)) {
         const sourceValue = merged[key];
         merged[key] =
-            isRecord(sourceValue) && isRecord(value)
+            isMessageGroup(sourceValue) && isMessageGroup(value)
                 ? mergeLocaleMessages(sourceValue, value)
                 : value;
     }
@@ -23,12 +33,12 @@ exports.FALLBACK_LOCALE = "en";
 exports.RENDERER_TRANSLATED_KEYS = ["error.network"];
 function withoutMessage(messages, key) {
     const [head, ...rest] = key.split(".");
-    if (!(head in messages))
+    if (!Object.prototype.hasOwnProperty.call(messages, head))
         return messages;
     const { [head]: value, ...others } = messages;
     if (!rest.length)
         return others;
-    if (!isRecord(value))
+    if (!isMessageGroup(value))
         return messages;
     const remaining = withoutMessage(value, rest.join("."));
     return Object.keys(remaining).length

package/dist/internal/manifest-decoder.d.ts

@@ -0,0 +1,7 @@
+import type { FrontendModuleOptions, Manifest, ManifestModule } from "../workspace";
+export declare function isModuleOptions(value: unknown): value is FrontendModuleOptions;
+export declare function isManifestModule(value: unknown): value is ManifestModule;
+export declare function isManifest(value: unknown): value is Manifest;
+export declare function hasManifestVersion(value: unknown): value is {
+    version: number;
+};

package/dist/internal/manifest-decoder.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isModuleOptions = isModuleOptions;
+exports.isManifestModule = isManifestModule;
+exports.isManifest = isManifest;
+exports.hasManifestVersion = hasManifestVersion;
+const guards_1 = require("./guards");
+const plain_object_1 = require("./plain-object");
+function isList(value) {
+    return Array.isArray(value);
+}
+function isTextList(value) {
+    return isList(value) && value.every(guards_1.isText);
+}
+function isModuleValue(value) {
+    if (value === null || (0, guards_1.isText)(value) || (0, guards_1.isNumber)(value) || (0, guards_1.isFlag)(value))
+        return true;
+    return isList(value) ? value.every(isModuleValue) : isModuleOptions(value);
+}
+function isModuleOptions(value) {
+    return (0, plain_object_1.isPlainObject)(value) && Object.values(value).every(isModuleValue);
+}
+function isPublicEndpoint(value) {
+    return ((0, plain_object_1.isPlainObject)(value) &&
+        (0, guards_1.isText)(value.path) &&
+        (value.methods === undefined || isTextList(value.methods)) &&
+        (value.headers === undefined || isTextList(value.headers)));
+}
+function isBackendProxy(value) {
+    return ((0, plain_object_1.isPlainObject)(value) &&
+        (0, guards_1.isText)(value.path) &&
+        (value.auth === undefined ||
+            value.auth === "session" ||
+            value.auth === "none") &&
+        (value.maxBodyBytes === undefined || (0, guards_1.isNumber)(value.maxBodyBytes)));
+}
+function isRenderer(value) {
+    return (0, plain_object_1.isPlainObject)(value) && (0, guards_1.isText)(value.name) && (0, guards_1.isText)(value.version);
+}
+function hasOptionalFields(value) {
+    return ((0, plain_object_1.isPlainObject)(value) &&
+        (value.renderer === undefined || isRenderer(value.renderer)) &&
+        (value.path === undefined || (0, guards_1.isText)(value.path)) &&
+        (value.options === undefined || isModuleOptions(value.options)) &&
+        (value.privateOptions === undefined ||
+            isModuleOptions(value.privateOptions)) &&
+        (value.configKey === undefined || (0, guards_1.isText)(value.configKey)));
+}
+function hasOptionalLists(value) {
+    return ((0, plain_object_1.isPlainObject)(value) &&
+        (value.authEstablishEndpoints === undefined ||
+            isTextList(value.authEstablishEndpoints)) &&
+        (value.publicEndpoints === undefined ||
+            (isList(value.publicEndpoints) &&
+                value.publicEndpoints.every(isPublicEndpoint))) &&
+        (value.backendProxies === undefined ||
+            (isList(value.backendProxies) &&
+                value.backendProxies.every(isBackendProxy))));
+}
+function isManifestModule(value) {
+    return ((0, plain_object_1.isPlainObject)(value) &&
+        (0, guards_1.isText)(value.name) &&
+        (0, guards_1.isNumber)(value.priority) &&
+        hasOptionalFields(value) &&
+        hasOptionalLists(value));
+}
+function isOriginRewrite(value) {
+    return (0, plain_object_1.isPlainObject)(value) && (0, guards_1.isText)(value.from) && (0, guards_1.isText)(value.to);
+}
+function isManifest(value) {
+    return ((0, plain_object_1.isPlainObject)(value) &&
+        isList(value.modules) &&
+        value.modules.every(isManifestModule) &&
+        (value.settling === undefined || (0, guards_1.isFlag)(value.settling)) &&
+        (value.originRewrites === undefined ||
+            (isList(value.originRewrites) &&
+                value.originRewrites.every(isOriginRewrite))));
+}
+function hasManifestVersion(value) {
+    return (0, plain_object_1.isPlainObject)(value) && (0, guards_1.isNumber)(value.version);
+}

package/dist/internal/own-release.d.ts

@@ -0,0 +1,5 @@
+export interface OwnRelease {
+    name: string;
+    version: string;
+}
+export declare const ownRelease: OwnRelease;

package/dist/internal/own-release.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ownRelease = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const guards_1 = require("./guards");
+function isOwnRelease(value) {
+    return ((0, guards_1.isObjectLike)(value) &&
+        "name" in value &&
+        (0, guards_1.isText)(value.name) &&
+        "version" in value &&
+        (0, guards_1.isText)(value.version));
+}
+function readOwnRelease() {
+    const manifest = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(__dirname, "..", "..", "package.json"), "utf8"));
+    if (!isOwnRelease(manifest))
+        throw new Error("The package.json of dms-frontend has no name or version");
+    return manifest;
+}
+exports.ownRelease = readOwnRelease();

package/dist/internal/plain-object.d.ts

@@ -0,0 +1 @@
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;

package/dist/internal/plain-object.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPlainObject = isPlainObject;
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}

package/dist/internal/text-list.d.ts

@@ -0,0 +1 @@
+export declare function isTextList(value: unknown): value is string[];

package/dist/internal/text-list.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTextList = isTextList;
+const guards_1 = require("./guards");
+function isTextList(value) {
+    if (!Array.isArray(value))
+        return false;
+    const items = value;
+    return items.every(guards_1.isText);
+}