@antelopejs/dms-frontend 0.3.10 → 0.3.12

package/README.md

@@ -72,7 +72,7 @@ pnpm add -g @antelopejs/core @antelopejs/dms-frontend
 ```
 
 The plugin prints through the output module of `@antelopejs/core`
-(`@antelopejs/core/cli`), so it needs `@antelopejs/core` 1.13.1 or later.
+(`@antelopejs/core/cli`), so it needs `@antelopejs/core` 1.13.2 or later.
 `npm install -g` works too; this repository and every generated workspace use
 pnpm. Inside a package script, `ajs` resolves from `node_modules/.bin`, and the
 `dms` command it delegates to resolves the project-local plugin, so a script
@@ -100,7 +100,7 @@ generated server read, from the environment or the project's `.env`.
 need a backend URL through `-b` or `DMS_API_BASE_URL`, and exit 2 without one.
 `dev` also discovers it from the enclosing antelope project's
 `.antelope/dev.json`, and exits 1 when there is none to discover.
-`verify-source` needs `--layer` instead.
+`verify-source` needs no backend: it runs in the project that installs `@antelopejs/dms`.
 
 `prepare` runs anywhere: when it cannot prepare the workspace it warns on
 stderr and exits 0, so a frontend module's `postinstall` hook never fails an
@@ -463,15 +463,30 @@ Use pnpm for all repository and workspace operations.
 
 ## Verify local frontend modules
 
-Use the packaged source verifier to validate an unpublished DMS frontend package against this exact adapter version. Additional modules and local package bindings are repeatable. All supplied frontend packages are copied into the generated workspace and bound with `workspace:*`.
+Use the packaged source verifier to validate unpublished DMS frontend modules against this exact adapter version. Run it from the project:
+
+```bash
+ajs dms verify-source
+```
+
+The modules are verified on top of the DMS core layer, the `frontend-vue` directory of `@antelopejs/dms`. The verifier finds the `@antelopejs/dms` the project installs the way Node does, from the current directory, and names it before it starts: `Verifying against @antelopejs/dms 0.5.5 (installed in this project)`. When the project does not install it, the verifier stops with the command that adds it as a development dependency (`pnpm add -D @antelopejs/dms`, or the equivalent for the project's package manager).
+
+Without `--module`, the verifier takes the current directory when it is a frontend module (it contains `dms.frontend.ts`), and its `frontend-vue` directory otherwise. `--module` names other ones and is repeatable, as is `--local-package`, which binds a local build of a package into the generated workspace. All supplied frontend packages are copied into the generated workspace and bound with `workspace:*`.
+
+```bash
+ajs dms verify-source --module ./admin-vue --module ./shop-vue
+```
+
+`--layer` is for the DMS core layer's own development: it verifies an unpublished core layer instead of the installed one, here against a local build of `@antelopejs/dms`:
 
 ```bash
 ajs dms verify-source \
   --layer /path/to/dms/frontend-vue \
-  --module /path/to/module/frontend-vue \
   --local-package @antelopejs/dms=/path/to/dms
 ```
 
-A supplied package whose declared range excludes this adapter version is refused before anything is installed (see [Declaring the loader releases a module supports](#declaring-the-loader-releases-a-module-supports)). The verifier generates a temporary workspace, installs it, builds client, SSR, and email bundles, checks what the client bundle loads, runs `vue-tsc`, renders eight DMS email templates, and checks that the email bundle excludes browser-only modules. Each check is one line that ends in ✔ or ✖, and the run ends with `Verified <n> modules` and its duration, or with the first failure: a type or Vite error points at the file in the package you passed (`./frontend-vue/app/components/Callout.vue:17:7`), not at its copy in the workspace, and the command exits 1. `--verbose` streams the pnpm, Vite and `vue-tsc` output. The workspace is removed when the run ends. It does not start a backend or publish packages. Repository development can invoke the same runner with `DMS_LAYER_SOURCE` through `pnpm test:real-source`.
+The checks look for what the core layer ships: its lazily loaded chart and rich-text libraries, the pages every DMS serves and its e-mail templates. A `--layer` that holds no core layer, such as a project's own `frontend-vue`, is refused before anything is installed, with exit code 2 and the command that verifies the same folder with `--module` instead.
+
+A supplied package whose declared range excludes this adapter version is refused before anything is installed (see [Declaring the loader releases a module supports](#declaring-the-loader-releases-a-module-supports)). The verifier generates a temporary workspace, installs it, builds client, SSR, and email bundles, checks what the client bundle loads, runs `vue-tsc`, renders eight DMS email templates, and checks that the email bundle excludes browser-only modules. Each check is one line that ends in ✔ or ✖, and the run ends with `Verified <n> modules` and its duration, or with the first failure: a type or Vite error points at the file in the package you passed (`./frontend-vue/app/components/Callout.vue:17:7`), not at its copy in the workspace, and the command exits 1. `--verbose` streams the pnpm, Vite and `vue-tsc` output. The workspace is removed when the run ends. It does not start a backend or publish packages. Repository development can invoke the same runner through `pnpm test:real-source`, with `DMS_LAYER_SOURCE` set to a core layer root and `DMS_MODULE_SOURCES` to a JSON array of module roots.
 
 Refresh rotation is single-flight within one frontend process. Horizontally scaled deployments must use sticky routing so a browser reaches the same process, or replace this process-local behavior with an external session adapter. It does not provide a distributed rotation guarantee.

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

@@ -4,5 +4,5 @@ export interface CleanOptions {
     all?: boolean;
     yes?: boolean;
 }
-export declare function describeWorkspaces(records: WorkspaceRecord[], isTerminal: boolean): string[];
+export declare function describeWorkspaces(records: WorkspaceRecord[], isTerminal: boolean, columns?: number): string[];
 export declare function runClean(options: CleanOptions): Promise<void>;

package/dist/commands/clean-action.js

@@ -11,25 +11,30 @@ const CLEAN_ALL_COMMAND = "ajs dms clean --all";
 const YES_FLAG = "--yes";
 const COLUMN_GAP = "  ";
 const ROW_INDENT = "  ";
-function describeWorkspaces(records, isTerminal) {
+function describeWorkspaces(records, isTerminal, columns) {
     const rows = records.map((record) => [
         (0, output_1.workspaceId)(record.dir, isTerminal),
         record.backendUrl,
         (0, workspaces_action_1.describeKey)(record),
     ]);
     const widths = rows[0].map((_, column) => Math.max(...rows.map((row) => row[column].length)));
-    return rows.map((row) => row
-        .map((cell, column) => cell.padEnd(widths[column]))
+    return rows.flatMap(([id, ...rest]) => (0, output_1.wrapAfter)(`${id.padEnd(widths[0])}${COLUMN_GAP}`, rest
+        .map((cell, column) => cell.padEnd(widths[column + 1]))
         .join(COLUMN_GAP)
-        .trimEnd());
+        .trimEnd(), columns).map((line) => line.trimEnd()));
+}
+function writeWorkspaces(records, isTerminal, write, paint = (line) => line) {
+    const columns = (0, output_1.feedbackColumns)();
+    const width = columns === undefined ? undefined : columns - ROW_INDENT.length;
+    for (const line of describeWorkspaces(records, isTerminal, width)) {
+        write(`${ROW_INDENT}${paint(line)}`);
+    }
 }
 async function confirmCleanAll(records, totalBytes, options) {
     const prompter = (0, cli_1.createPrompter)({ command: CLEAN_ALL_COMMAND });
     if (!options.yes && prompter.isInteractive) {
         (0, output_1.writeFeedback)(`Remove ${(0, cli_1.pluralize)(records.length, "workspace")} (${(0, output_1.formatSize)(totalBytes)})?`);
-        for (const line of describeWorkspaces(records, true)) {
-            (0, output_1.writeFeedback)(`${ROW_INDENT}${line}`);
-        }
+        writeWorkspaces(records, true, output_1.writeFeedback);
     }
     return prompter.confirm({
         message: "Continue?",
@@ -57,11 +62,10 @@ async function cleanAll(options) {
     ui.message("success", [
         `Removed ${(0, cli_1.pluralize)(records.length, "workspace")}`,
         `freed ${(0, output_1.formatSize)(totalBytes)}`,
-    ].join(ui.symbols.separator), {
-        details: options.yes
-            ? describeWorkspaces(records, (0, output_1.isTerminalFeedback)())
-            : [],
-    });
+    ].join(ui.symbols.separator));
+    if (options.yes) {
+        writeWorkspaces(records, (0, output_1.isTerminalFeedback)(), output_1.writeInfo, ui.palette().dim);
+    }
     (0, workspaces_action_1.reportSkipped)(ui, skipped);
 }
 async function runClean(options) {

package/dist/commands/verify-source-action.js

@@ -9,8 +9,6 @@ const node_path_1 = require("node:path");
 const cli_1 = require("@antelopejs/core/cli");
 const common_1 = require("../common");
 const verify_source_result_1 = require("../verify-source-result");
-const COMMAND_PATH = "ajs dms verify-source";
-const LAYER_OPTION = "-l, --layer <path>";
 function localPackageSeparator(value) {
     const separator = value.indexOf("=");
     return separator <= 0 || separator === value.length - 1 ? -1 : separator;
@@ -37,15 +35,10 @@ function directoryProblem(path, label) {
         return undefined;
     return { title: `${label} not found: ${path}`, fixes: [verify_source_result_1.LAYER_PATH_FIX] };
 }
-const MISSING_LAYER = {
-    title: `Required option '${LAYER_OPTION}' not specified`,
-    reason: `Usage: ${COMMAND_PATH} [options]`,
-    fixes: [`Run ${COMMAND_PATH} --help for usage`],
-};
 function usageProblems(options) {
     const problems = [
         options.layer === undefined
-            ? MISSING_LAYER
+            ? undefined
             : directoryProblem(options.layer, "Layer path"),
         ...(options.module ?? []).map((path) => directoryProblem(path, "Module path")),
         ...(options.localPackage ?? []).map(localPackageProblem),
@@ -71,7 +64,6 @@ function channelClosed(child) {
 async function runVerifySource(options) {
     const startedAt = Date.now();
     assertValidUsage(usageProblems(options));
-    const layer = options.layer ?? "";
     const modules = options.module ?? [];
     const localPackages = parseLocalPackages(options.localPackage ?? []);
     const runner = (0, node_path_1.join)(__dirname, "..", `verify-source-runner${(0, node_path_1.extname)(__filename)}`);
@@ -83,7 +75,7 @@ async function runVerifySource(options) {
         stdio: ["inherit", "inherit", "inherit", "ipc"],
         env: {
             ...process.env,
-            DMS_LAYER_SOURCE: (0, node_path_1.resolve)(layer),
+            DMS_LAYER_SOURCE: options.layer === undefined ? undefined : (0, node_path_1.resolve)(options.layer),
             DMS_MODULE_SOURCES: JSON.stringify(modules.map((path) => (0, node_path_1.resolve)(path))),
             DMS_LOCAL_PACKAGES: JSON.stringify(localPackages),
         },

package/dist/commands/verify-source.js

@@ -41,20 +41,24 @@ function collectOption(value, values = []) {
 }
 const VERIFY_SOURCE_EXAMPLES = [
     {
-        description: "A frontend package and a module that uses it",
-        command: "ajs dms verify-source -l ../dms/frontend-vue -m ./frontend-vue",
+        description: "The project's frontend module: the current directory or ./frontend-vue",
+        command: "ajs dms verify-source",
     },
     {
-        description: "With a local build of a package it depends on",
-        command: "ajs dms verify-source -l . --local-package @antelopejs/dms=../dms",
+        description: "Frontend modules in other directories",
+        command: "ajs dms verify-source -m ./admin-vue -m ./shop-vue",
+    },
+    {
+        description: "An unpublished DMS core layer, with a local build of @antelopejs/dms",
+        command: "ajs dms verify-source -l . --local-package @antelopejs/dms=..",
     },
 ];
 function cmdVerifySource() {
     const command = new commander_1.Command("verify-source")
         .summary("Build and type-check unpublished frontend sources")
-        .description("Build and type-check unpublished DMS frontend sources against this loader version, in a temporary workspace removed when the run ends. Starts no backend.")
-        .option("-l, --layer <path>", "Root of the DMS frontend package to verify (required)")
-        .option("-m, --module <path>", "Root of another frontend package to verify with it (repeatable)", collectOption)
+        .description("Build and type-check unpublished DMS frontend modules against this loader version, on top of the DMS core layer of the @antelopejs/dms installed in the project. Runs in a temporary workspace removed when the run ends, and starts no backend.")
+        .option("-l, --layer <path>", "Root of an unpublished DMS core layer to verify instead of the installed one")
+        .option("-m, --module <path>", "Root of a frontend module to verify (repeatable); without -l or -m, the current directory or ./frontend-vue", collectOption)
         .option("--local-package <name=path>", "Bind a local package into the generated workspace (repeatable)", collectOption)
         .action(async (options) => (await Promise.resolve().then(() => __importStar(require("./verify-source-action")))).runVerifySource(options));
     return (0, cli_1.withExamples)(command, VERIFY_SOURCE_EXAMPLES);

package/dist/layer-watch.d.ts

@@ -1,3 +1,3 @@
 import { type Ui } from "@antelopejs/core/cli";
 import { ResolvedLayer } from "./workspace";
-export declare function startLayerWatchers(workspaceDir: string, layers: ResolvedLayer[], ui?: Ui, write?: (text: string) => void): () => Promise<void>;
+export declare function startLayerWatchers(workspaceDir: string, layers: ResolvedLayer[], ui?: Ui, write?: (text: string) => void, isQuiet?: boolean): () => Promise<void>;

package/dist/layer-watch.js

@@ -272,11 +272,14 @@ function createDerivedOutputRefresher(workspaceDir, layers, reporter) {
         },
     };
 }
-function startLayerWatchers(workspaceDir, layers, ui = (0, cli_1.getProcessUi)(), write = output_1.writeFeedback) {
+function startLayerWatchers(workspaceDir, layers, ui = (0, cli_1.getProcessUi)(), write = output_1.writeFeedback, isQuiet = (0, cli_1.isQuietRun)()) {
     const mapPath = (0, child_output_1.createPathMapper)(workspaceDir, layers.map((layer) => ({ ...layer, sourcePath: layer.path })));
     const reporter = {
         warn: (text, options) => write((0, output_1.formatTimedMessage)("warn", text, options, ui)),
-        succeed: (text) => write((0, output_1.formatTimedMessage)("success", text, {}, ui)),
+        succeed: (text) => {
+            if (!isQuiet)
+                write((0, output_1.formatTimedMessage)("success", text, {}, ui));
+        },
         describe: (error) => (0, output_1.failureDetails)(error, ui).map((line) => mapPath(line)),
         show: (path) => {
             const mapped = mapPath(path);

package/dist/output.d.ts

@@ -3,6 +3,8 @@ import { CancelledError } from "./cancellation";
 export declare function exitOnBrokenPipe(stream?: NodeJS.WriteStream): void;
 export declare function isTerminalFeedback(): boolean;
 export declare function isTerminalResult(): boolean;
+export declare function feedbackColumns(): number | undefined;
+export declare function wrapAfter(prefix: string, text: string, columns: number | undefined, paint?: (line: string) => string): string[];
 export declare function writeFeedback(line: string): void;
 export declare function writeInfo(line: string): void;
 export declare function writeHeader(command: string, context: string[], ui?: Ui): void;
@@ -27,7 +29,7 @@ export interface ReadyBlock {
     lines: ReadyLine[];
     footer: string;
 }
-export declare function formatReadyBlock(block: ReadyBlock, ui?: Ui, isQuiet?: boolean): string[];
+export declare function formatReadyBlock(block: ReadyBlock, ui?: Ui, isQuiet?: boolean, columns?: number | undefined): string[];
 export declare function writeReadyBlock(block: ReadyBlock, ui?: Ui): void;
 declare const TIMED_LEVEL_COLORS: {
     readonly success: "green";
@@ -38,6 +40,7 @@ type TimedLevel = keyof typeof TIMED_LEVEL_COLORS;
 export interface TimedMessageOptions {
     details?: readonly string[];
     fixes?: readonly string[];
+    columns?: number;
 }
 export declare function formatTimedMessage(level: TimedLevel, text: string, options?: TimedMessageOptions, ui?: Ui, now?: Date): string;
 export {};

package/dist/output.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.exitOnBrokenPipe = exitOnBrokenPipe;
 exports.isTerminalFeedback = isTerminalFeedback;
 exports.isTerminalResult = isTerminalResult;
+exports.feedbackColumns = feedbackColumns;
+exports.wrapAfter = wrapAfter;
 exports.writeFeedback = writeFeedback;
 exports.writeInfo = writeInfo;
 exports.writeHeader = writeHeader;
@@ -21,6 +23,7 @@ exports.writeReadyBlock = writeReadyBlock;
 exports.formatTimedMessage = formatTimedMessage;
 const node_os_1 = require("node:os");
 const node_path_1 = require("node:path");
+const node_util_1 = require("node:util");
 const cli_1 = require("@antelopejs/core/cli");
 const cancellation_1 = require("./cancellation");
 const HOME_PREFIX = "~";
@@ -34,6 +37,8 @@ const BLOCK_INDENT = "  ";
 const LINK_GAP = "  ";
 const LABEL_SUFFIX = ":";
 const TIME_LENGTH = 8;
+const MIN_WRAP_WIDTH = 20;
+const LEADING_SPACES = /^ */;
 const BYTES_PER_UNIT = 1024;
 const SIZE_UNITS = ["B", "KB", "MB", "GB", "TB"];
 const DECIMAL_SIZE_LIMIT = 10;
@@ -56,6 +61,17 @@ function isTerminalFeedback() {
 function isTerminalResult() {
     return (0, cli_1.detectCapabilities)((0, cli_1.processCapabilityContext)()).terminals.result;
 }
+function feedbackColumns() {
+    return isTerminalFeedback() ? process.stderr.columns || undefined : undefined;
+}
+function wrapAfter(prefix, text, columns, paint = (line) => line) {
+    const indent = " ".repeat((0, node_util_1.stripVTControlCharacters)(prefix).length);
+    const leading = LEADING_SPACES.exec(text)?.[0] ?? "";
+    const lines = columns === undefined
+        ? [text]
+        : (0, cli_1.wrapText)(text.slice(leading.length), Math.max(MIN_WRAP_WIDTH, columns - indent.length - leading.length)).map((line) => `${leading}${line}`);
+    return lines.map((line, index) => `${index === 0 ? prefix : indent}${paint(line)}`);
+}
 function writeFeedback(line) {
     (0, cli_1.getProcessTasks)().write(process.stderr, `${line}\n`);
 }
@@ -65,7 +81,10 @@ function writeInfo(line) {
 }
 function writeHeader(command, context, ui = (0, cli_1.getProcessUi)()) {
     const title = ui.palette().bold(`ajs dms ${command}`);
-    writeInfo(`${title}  ${context.join(ui.symbols.separator)}`);
+    const text = context.join(ui.symbols.separator);
+    for (const line of wrapAfter(`${title}  `, text, feedbackColumns())) {
+        writeInfo(line);
+    }
 }
 function writeBlankLine() {
     writeInfo("");
@@ -163,9 +182,11 @@ function reportStopped(stop, ui = (0, cli_1.getProcessUi)()) {
         ? STOPPED_SYMBOLS.unicode
         : STOPPED_SYMBOLS.ascii;
     const text = [stop.stopped, ...stop.context].join(ui.symbols.separator);
-    writeFeedback(`${lineStart}${ui.palette().red(symbol)} ${text}`);
+    const symbolPrefix = `${ui.palette().red(symbol)} `;
+    const lines = wrapAfter(symbolPrefix, text, feedbackColumns());
+    writeFeedback(`${lineStart}${lines.join("\n")}`);
 }
-function formatReadyBlock(block, ui = (0, cli_1.getProcessUi)(), isQuiet = (0, cli_1.isQuietRun)()) {
+function formatReadyBlock(block, ui = (0, cli_1.getProcessUi)(), isQuiet = (0, cli_1.isQuietRun)(), columns = feedbackColumns()) {
     const palette = ui.palette();
     const arrow = isUnicode(ui) ? LINK_SYMBOLS.unicode : LINK_SYMBOLS.ascii;
     const shown = isQuiet
@@ -173,18 +194,17 @@ function formatReadyBlock(block, ui = (0, cli_1.getProcessUi)(), isQuiet = (0, c
         : block.lines;
     const width = Math.max(...shown.map(({ label }) => label.length + LABEL_SUFFIX.length));
     const lead = (isLink) => `${BLOCK_INDENT}${isLink ? palette.cyan(arrow) : " ".repeat(arrow.length)}${LINK_GAP}`;
-    const lines = shown.map(({ label, value, isLink }) => {
+    const lines = shown.flatMap(({ label, value, isLink }) => {
         const shownLabel = `${label}${LABEL_SUFFIX}`.padEnd(width);
-        const shownValue = isLink ? palette.cyan(value) : value;
-        return `${lead(isLink)}${palette.dim(shownLabel)} ${shownValue}`;
+        return wrapAfter(`${lead(isLink)}${palette.dim(shownLabel)} `, value, columns, isLink ? palette.cyan : undefined);
     });
     if (isQuiet)
         return lines;
     return [
-        `${palette.green(ui.symbols.levels.success)} ${block.title}`,
+        ...wrapAfter(`${palette.green(ui.symbols.levels.success)} `, block.title, columns),
         "",
         ...lines,
-        `${lead()}${palette.dim(block.footer)}`,
+        ...wrapAfter(lead(), block.footer, columns, palette.dim),
     ];
 }
 function writeReadyBlock(block, ui = (0, cli_1.getProcessUi)()) {
@@ -201,14 +221,14 @@ function clockTime(date) {
     return date.toTimeString().slice(0, TIME_LENGTH);
 }
 function formatTimedMessage(level, text, options = {}, ui = (0, cli_1.getProcessUi)(), now = new Date()) {
-    const { details = [], fixes = [] } = options;
+    const { details = [], fixes = [], columns = feedbackColumns() } = options;
     const palette = ui.palette();
     const paint = palette[TIMED_LEVEL_COLORS[level]];
     const hint = palette.cyan(ui.symbols.levels.hint);
     const indent = " ".repeat(TIME_LENGTH + 1) + BLOCK_INDENT;
     return [
-        `${palette.dim(clockTime(now))} ${paint(ui.symbols.levels[level])} ${text}`,
-        ...details.map((detail) => `${indent}${palette.dim(detail)}`),
-        ...fixes.map((fix) => `${indent}${hint} ${fix}`),
+        ...wrapAfter(`${palette.dim(clockTime(now))} ${paint(ui.symbols.levels[level])} `, text, columns),
+        ...details.flatMap((detail) => wrapAfter(indent, detail, columns, palette.dim)),
+        ...fixes.flatMap((fix) => wrapAfter(`${indent}${hint} `, fix, columns)),
     ].join("\n");
 }

package/dist/update-check.d.ts

@@ -14,6 +14,7 @@ export interface UpdateCheckOptions {
     fetchLatestVersion?: (packageName: string) => Promise<string | undefined>;
     ui?: Ui;
     write?: (line: string) => void;
+    columns?: number;
 }
 export interface UpdateNoticeOptions {
     isFollowed?: boolean;

package/dist/update-check.js

@@ -182,11 +182,11 @@ function fetchLatestVersionFromRegistry(packageName, registryUrl = DEFAULT_REGIS
         }
     });
 }
-function formatNotice(currentVersion, latestVersion, ui) {
+function formatNotice(currentVersion, latestVersion, ui, columns) {
     const palette = ui.palette("feedback");
     const { info, hint } = ui.symbols.levels;
-    return (`${palette.blue(info)} ajs dms ${latestVersion} is available ` +
-        `(you have ${currentVersion}) ${palette.cyan(`${hint} ${UPDATE_COMMAND}`)}`);
+    return (0, output_1.wrapAfter)(`${palette.blue(info)} `, `ajs dms ${latestVersion} is available (you have ${currentVersion}) ` +
+        palette.cyan(`${hint} ${UPDATE_COMMAND}`), columns);
 }
 async function isNewer(currentVersion, latestVersion) {
     if (currentVersion === latestVersion)
@@ -200,7 +200,7 @@ async function isNewer(currentVersion, latestVersion) {
 }
 function startUpdateCheck(options) {
     try {
-        const { currentVersion, argv = process.argv.slice(2), env = process.env, isTerminal = (0, output_1.isTerminalFeedback)(), now = Date.now, cacheFile = updateCheckCacheFile(), fetchLatestVersion = fetchLatestVersionFromRegistry, ui = (0, cli_1.getProcessUi)(), write = output_1.writeFeedback, } = options;
+        const { currentVersion, argv = process.argv.slice(2), env = process.env, isTerminal = (0, output_1.isTerminalFeedback)(), now = Date.now, cacheFile = updateCheckCacheFile(), fetchLatestVersion = fetchLatestVersionFromRegistry, ui = (0, cli_1.getProcessUi)(), write = output_1.writeFeedback, columns = (0, output_1.feedbackColumns)(), } = options;
         if (!isTerminal || !isUpdateCheckEnabled(argv, env))
             return undefined;
         const cached = readCache(cacheFile);
@@ -230,8 +230,10 @@ function startUpdateCheck(options) {
             const known = latestVersion;
             if (!known || !(await isNewer(currentVersion, known)))
                 return;
-            const line = formatNotice(currentVersion, known, ui);
-            for (const text of placement.isFollowed ? [line, ""] : ["", line]) {
+            const lines = formatNotice(currentVersion, known, ui, columns);
+            for (const text of placement.isFollowed
+                ? [...lines, ""]
+                : ["", ...lines]) {
                 write(text);
             }
         };

package/dist/verify-source-runner.js

@@ -43,6 +43,7 @@ const output_1 = require("./output");
 const temporary_workspace_1 = require("./temporary-workspace");
 const typecheck_output_1 = require("./typecheck-output");
 const verify_source_result_1 = require("./verify-source-result");
+const verify_source_sources_1 = require("./verify-source-sources");
 const vite_output_1 = require("./vite-output");
 const EMAIL_BUILD_SIZE_CEILING_BYTES = 256 * 1024;
 const NON_EMAIL_RUNTIME_PATTERN = /DisplayRichText|ApexCharts|Tiptap|FlowCanvas|app\/.*table|components\/table/i;
@@ -58,44 +59,6 @@ function ensure(condition, title, reason) {
     if (!condition)
         throw new cli_1.CliError({ title, reason });
 }
-function readLayer(root) {
-    const packagePath = (0, node_path_1.join)(root, "package.json");
-    if (!(0, node_fs_1.existsSync)(packagePath))
-        throw new common_1.UsageError({
-            title: `No package.json in ${(0, output_1.showPath)(root)}`,
-            fixes: [verify_source_result_1.LAYER_PATH_FIX],
-        });
-    const { name } = readJson(packagePath);
-    return { path: root, sourcePath: root, packageName: name };
-}
-function readSources() {
-    const layerSource = process.env.DMS_LAYER_SOURCE;
-    if (!layerSource)
-        throw new common_1.UsageError({
-            title: "DMS_LAYER_SOURCE is not set",
-            fixes: [
-                `Set it to the root of a DMS frontend package, or run ${verify_source_result_1.VERIFY_SOURCE_COMMAND} -l <path>`,
-            ],
-        });
-    const sourceRoot = (0, node_path_1.resolve)(layerSource);
-    if (!(0, node_fs_1.statSync)(sourceRoot, { throwIfNoEntry: false })?.isDirectory())
-        throw new common_1.UsageError({
-            title: `Layer path not found: ${(0, output_1.showPath)(sourceRoot)}`,
-            fixes: [verify_source_result_1.LAYER_PATH_FIX],
-        });
-    const extraSources = JSON.parse(process.env.DMS_MODULE_SOURCES ?? "[]");
-    const layerRoots = (0, node_fs_1.existsSync)((0, node_path_1.join)(sourceRoot, "dms.frontend.ts"))
-        ? [sourceRoot]
-        : (0, node_fs_1.readdirSync)(sourceRoot, { withFileTypes: true })
-            .filter((entry) => entry.isDirectory())
-            .map((entry) => (0, node_path_1.join)(sourceRoot, entry.name));
-    if (layerRoots.length === 0)
-        throw new common_1.UsageError({
-            title: `No frontend package in ${(0, output_1.showPath)(sourceRoot)}`,
-            fixes: [verify_source_result_1.LAYER_PATH_FIX],
-        });
-    return [...layerRoots, ...extraSources.map((root) => (0, node_path_1.resolve)(root))].map(readLayer);
-}
 function removeDevelopmentDependencies(root) {
     const packagePath = (0, node_path_1.join)(root, "package.json");
     if (!(0, node_fs_1.existsSync)(packagePath))
@@ -104,7 +67,7 @@ function removeDevelopmentDependencies(root) {
     delete packageData.devDependencies;
     (0, node_fs_1.writeFileSync)(packagePath, `${JSON.stringify(packageData, null, 2)}\n`);
 }
-function materializeWorkspace(workspace, layers) {
+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)
@@ -121,7 +84,6 @@ function materializeWorkspace(workspace, layers) {
     (0, common_1.writeWorkspacePackageJson)(workspace, layers);
     const packagePath = (0, node_path_1.join)(workspace, "package.json");
     const workspacePackage = readJson(packagePath);
-    const localPackages = JSON.parse(process.env.DMS_LOCAL_PACKAGES ?? "{}");
     workspacePackage.pnpm = {
         overrides: {
             ...Object.fromEntries(layers.map((layer) => [layer.packageName, "workspace:*"])),
@@ -314,8 +276,10 @@ function describeError(error, isVerbose) {
     };
 }
 async function verifySources() {
-    const layers = readSources();
+    const options = (0, verify_source_sources_1.readSourceOptions)();
+    const { layers, coreLayer } = (0, verify_source_sources_1.readSources)(options);
     (0, output_1.writeHeader)("verify-source", [(0, cli_1.pluralize)(layers.length, "module")]);
+    (0, cli_1.getProcessUi)().message("info", `Verifying against ${coreLayer}`);
     (0, common_1.assertLayersSupportRenderer)(layers);
     const workspace = (0, temporary_workspace_1.createTemporaryWorkspace)("dms-frontend-real-source-");
     const isVerbose = (0, cli_1.isVerboseRun)();
@@ -327,7 +291,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), { done: `Materialized ${(0, cli_1.pluralize)(layers.length, "module")}` });
+    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 (0, common_1.installDeps)(workspace, context.mapLine, ["--ignore-scripts"]);
     await buildBundles(context);
     await tasks.run("Checking the client bundle", async () => checkClientBundle(workspace), { done: "Client bundle checked", failed: "Client bundle check failed" });

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

@@ -0,0 +1,13 @@
+import { type ResolvedLayer } from "./common";
+export interface SourceOptions {
+    projectDir: string;
+    layerSource?: string;
+    moduleSources: string[];
+    localPackages: Record<string, string>;
+}
+export interface Sources {
+    layers: ResolvedLayer[];
+    coreLayer: string;
+}
+export declare function readSourceOptions(): SourceOptions;
+export declare function readSources(options: SourceOptions): Sources;

package/dist/verify-source-sources.js

@@ -0,0 +1,189 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readSourceOptions = readSourceOptions;
+exports.readSources = readSources;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const common_1 = require("./common");
+const output_1 = require("./output");
+const verify_source_result_1 = require("./verify-source-result");
+const DMS_PACKAGE = "@antelopejs/dms";
+const DMS_CORE_LAYER_PACKAGE = "@antelopejs/dms-frontend-vue";
+const CORE_LAYER_DIRECTORY = "frontend-vue";
+const FRONTEND_ENTRY = "dms.frontend.ts";
+const ADD_DEV_DEPENDENCY = {
+    pnpm: "pnpm add -D",
+    npm: "npm install -D",
+    yarn: "yarn add -D",
+    bun: "bun add -d",
+};
+const LOCKFILES = [
+    ["pnpm-lock.yaml", "pnpm"],
+    ["package-lock.json", "npm"],
+    ["yarn.lock", "yarn"],
+    ["bun.lock", "bun"],
+    ["bun.lockb", "bun"],
+];
+function readSourceOptions() {
+    return {
+        projectDir: process.cwd(),
+        layerSource: process.env.DMS_LAYER_SOURCE || undefined,
+        moduleSources: JSON.parse(process.env.DMS_MODULE_SOURCES ?? "[]"),
+        localPackages: JSON.parse(process.env.DMS_LOCAL_PACKAGES ?? "{}"),
+    };
+}
+function readManifest(packagePath) {
+    return JSON.parse((0, node_fs_1.readFileSync)(packagePath, "utf8"));
+}
+function readLayer(root) {
+    const packagePath = (0, node_path_1.join)(root, "package.json");
+    if (!(0, node_fs_1.existsSync)(packagePath))
+        throw new common_1.UsageError({
+            title: `No package.json in ${(0, output_1.showPath)(root)}`,
+            fixes: [verify_source_result_1.LAYER_PATH_FIX],
+        });
+    const { name } = readManifest(packagePath);
+    return { path: root, sourcePath: root, packageName: name };
+}
+function isCoreLayer(layer) {
+    return layer.packageName === DMS_CORE_LAYER_PACKAGE;
+}
+function shellArgument(path) {
+    return /^[\w@%+=:,./~-]+$/.test(path) ? path : JSON.stringify(path);
+}
+function defaultModuleRoot(projectDir) {
+    const root = [projectDir, (0, node_path_1.join)(projectDir, CORE_LAYER_DIRECTORY)].find((candidate) => (0, node_fs_1.existsSync)((0, node_path_1.join)(candidate, FRONTEND_ENTRY)));
+    if (root)
+        return root;
+    throw new common_1.UsageError({
+        title: "No frontend module to verify",
+        reason: `Neither ${(0, output_1.showPath)(projectDir)} nor its ${CORE_LAYER_DIRECTORY} directory contains ${FRONTEND_ENTRY}.`,
+        fixes: [
+            `Run the command from the frontend module, or pass its root with -m`,
+        ],
+    });
+}
+function packageManager(projectDir) {
+    for (let directory = projectDir;; directory = (0, node_path_1.dirname)(directory)) {
+        const packagePath = (0, node_path_1.join)(directory, "package.json");
+        if ((0, node_fs_1.existsSync)(packagePath)) {
+            const [name] = (readManifest(packagePath).packageManager ?? "").split("@");
+            if (name && ADD_DEV_DEPENDENCY[name])
+                return name;
+            const lockfile = LOCKFILES.find(([file]) => (0, node_fs_1.existsSync)((0, node_path_1.join)(directory, file)));
+            if (lockfile)
+                return lockfile[1];
+        }
+        if ((0, node_path_1.dirname)(directory) === directory)
+            return "pnpm";
+    }
+}
+function addDmsCommand(projectDir, version = "") {
+    return `${ADD_DEV_DEPENDENCY[packageManager(projectDir)]} ${DMS_PACKAGE}${version}`;
+}
+function describeDirectory(directory) {
+    return (0, node_path_1.resolve)(directory) === process.cwd()
+        ? "the current directory"
+        : (0, output_1.showPath)(directory);
+}
+function resolveDmsPackage(projectDir) {
+    try {
+        return require.resolve(`${DMS_PACKAGE}/package.json`, {
+            paths: [projectDir],
+        });
+    }
+    catch {
+        return undefined;
+    }
+}
+function installedCoreLayer(projectDir) {
+    const packagePath = resolveDmsPackage(projectDir);
+    if (!packagePath)
+        throw new common_1.UsageError({
+            title: `${DMS_PACKAGE} is not installed in this project`,
+            reason: `Frontend modules are verified on top of the DMS core layer that ${DMS_PACKAGE} ships, and Node finds no ${DMS_PACKAGE} from ${describeDirectory(projectDir)}.`,
+            fixes: [
+                `Add it as a development dependency: ${addDmsCommand(projectDir)}`,
+            ],
+        });
+    const { version } = readManifest(packagePath);
+    const root = (0, node_path_1.join)((0, node_path_1.dirname)(packagePath), CORE_LAYER_DIRECTORY);
+    const layer = (0, node_fs_1.existsSync)((0, node_path_1.join)(root, "package.json"))
+        ? readLayer(root)
+        : undefined;
+    if (!layer || !isCoreLayer(layer))
+        throw new common_1.UsageError({
+            title: `${DMS_PACKAGE} ${version} ships no DMS core layer`,
+            reason: `${(0, output_1.showPath)((0, node_path_1.dirname)(packagePath))} has no ${CORE_LAYER_DIRECTORY} directory holding ${DMS_CORE_LAYER_PACKAGE}.`,
+            fixes: [`Update it: ${addDmsCommand(projectDir, "@latest")}`],
+        });
+    return {
+        layers: [layer],
+        coreLayer: `${DMS_PACKAGE} ${version} (installed in this project)`,
+    };
+}
+function notCoreLayer(sourceRoot, layers, modules, localPackages) {
+    const command = [
+        verify_source_result_1.VERIFY_SOURCE_COMMAND,
+        ...[...layers, ...modules].flatMap((layer) => [
+            "-m",
+            shellArgument((0, output_1.showPath)(layer.path)),
+        ]),
+        ...Object.entries(localPackages).flatMap(([name, path]) => [
+            "--local-package",
+            shellArgument(`${name}=${(0, output_1.showPath)(path)}`),
+        ]),
+    ].join(" ");
+    const names = layers
+        .map((layer) => layer.packageName ?? "a package without a name")
+        .join(", ");
+    const shown = (0, output_1.showPath)(sourceRoot);
+    return {
+        title: `${shown} is not the DMS core layer`,
+        reason: `--layer is for verifying an unpublished DMS core layer, ${DMS_CORE_LAYER_PACKAGE}, and ${shown} holds ${names}. ` +
+            `Without it, frontend modules are verified on the core layer of the ${DMS_PACKAGE} installed in the project.`,
+        fixes: [`Drop -l and pass the folder with -m: ${command}`],
+    };
+}
+function readLayerSource(layerSource) {
+    const sourceRoot = (0, node_path_1.resolve)(layerSource);
+    if (!(0, node_fs_1.statSync)(sourceRoot, { throwIfNoEntry: false })?.isDirectory())
+        throw new common_1.UsageError({
+            title: `Layer path not found: ${(0, output_1.showPath)(sourceRoot)}`,
+            fixes: [verify_source_result_1.LAYER_PATH_FIX],
+        });
+    const roots = (0, node_fs_1.existsSync)((0, node_path_1.join)(sourceRoot, FRONTEND_ENTRY))
+        ? [sourceRoot]
+        : (0, node_fs_1.readdirSync)(sourceRoot, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => (0, node_path_1.join)(sourceRoot, entry.name));
+    if (roots.length === 0)
+        throw new common_1.UsageError({
+            title: `No frontend package in ${(0, output_1.showPath)(sourceRoot)}`,
+            fixes: [verify_source_result_1.LAYER_PATH_FIX],
+        });
+    return { sourceRoot, layers: roots.map(readLayer) };
+}
+function readSources(options) {
+    const { projectDir, layerSource, localPackages } = options;
+    const modules = (options.moduleSources.length > 0 || layerSource
+        ? options.moduleSources.map((root) => (0, node_path_1.resolve)(root))
+        : [defaultModuleRoot(projectDir)]).map(readLayer);
+    if (layerSource) {
+        const { sourceRoot, layers } = readLayerSource(layerSource);
+        if (!layers.some(isCoreLayer))
+            throw new common_1.UsageError(notCoreLayer(sourceRoot, layers, modules, localPackages));
+        return {
+            layers: [...layers, ...modules],
+            coreLayer: `the DMS core layer in ${(0, output_1.showPath)(sourceRoot)}`,
+        };
+    }
+    const passedCore = modules.find(isCoreLayer);
+    if (passedCore)
+        return {
+            layers: [passedCore, ...modules.filter((layer) => layer !== passedCore)],
+            coreLayer: `the DMS core layer in ${(0, output_1.showPath)(passedCore.path)}`,
+        };
+    const installed = installedCoreLayer(projectDir);
+    return { ...installed, layers: [...installed.layers, ...modules] };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antelopejs/dms-frontend",
-  "version": "0.3.10",
+  "version": "0.3.12",
   "description": "Frontend-agnostic loader for AntelopeJS DMS, shipping the Vue 3 renderer (Vite, Inertia, SSR)",
   "keywords": [
     "antelope",
@@ -73,7 +73,7 @@
     "unzipper": "^0.12.3"
   },
   "devDependencies": {
-    "@antelopejs/core": "^1.13.1",
+    "@antelopejs/core": "^1.13.2",
     "@antelopejs/tooling-configs": ">=0.0.7 <1.0.0",
     "@iconify/utils": "^3.1.0",
     "@iconify/vue": "^5.0.1",
@@ -101,7 +101,7 @@
     "vue-i18n": "^11.2.7"
   },
   "peerDependencies": {
-    "@antelopejs/core": ">=1.13.1 <2"
+    "@antelopejs/core": ">=1.13.2 <2"
   },
   "optionalDependencies": {
     "@oxc-parser/binding-darwin-arm64": "^0.95.0",