mfeflow 0.4.0 → 0.6.0

package/dist/testing.d.ts

@@ -0,0 +1,82 @@
+import { type MfeflowError } from '@mfeflow/core';
+import type { Io } from './io.js';
+import type { DevHost, DevProcess, DevSpec, WaitPolicy } from './proc.js';
+import type { Prompter } from './prompter.js';
+import type { Runtime } from './runtime.js';
+import { type Run, type System } from './system.js';
+/** The checkout this package lives in; `--local` tests point at it. */
+export declare const REPO: string;
+export interface Recorded {
+    out: string[];
+    err: string[];
+}
+export declare function fakeIo(overrides?: Partial<Io>): Io & Recorded;
+/** Answers prompts in the order they are asked, from `answers`; records the messages. */
+export declare function scriptedPrompter(answers?: readonly unknown[]): Prompter & {
+    asked: string[];
+};
+export interface SystemCalls {
+    installs: {
+        root: string;
+        packageManager: string;
+        verbose: boolean;
+    }[];
+    gitInits: string[];
+    repoInits: string[];
+}
+export declare function fakeSystem(options?: {
+    installError?: Error;
+    gitInit?: boolean;
+}): System & SystemCalls;
+export interface FakeProc extends DevProcess {
+    spec: DevSpec;
+    stopped: boolean;
+    /** What the process prints. */
+    print(text: string): void;
+    /** The process ends by itself. */
+    exit(code: number | null): void;
+}
+export interface FakeDev extends DevHost {
+    procs: FakeProc[];
+    /** Ports `portFree` reports as taken. */
+    busy: Set<number>;
+    watched: string[][];
+    /** The watched files changed. */
+    change(): void;
+    /** Ctrl+C. */
+    interrupt(): void;
+    waitPolicy: WaitPolicy;
+}
+export declare function fakeDev(): FakeDev;
+export type TestRuntime = Runtime & {
+    io: Io & Recorded;
+    system: System & SystemCalls;
+    dev: FakeDev;
+};
+export declare function testRuntime(overrides?: Partial<Pick<Runtime, 'prompter' | 'fetch' | 'roots' | 'configDir'>> & {
+    /** Namespaces trusted for this run, through MFEFLOW_TRUST_REGISTRIES. */
+    trust?: string[];
+}): TestRuntime;
+export declare function tempDir(prefix?: string): Promise<string>;
+export declare function removeDir(dir: string): Promise<void>;
+/** Every file under `dir`, as `/`-separated paths mapped to content. */
+export declare function readTree(dir: string): Promise<Record<string, string>>;
+/** Awaits a promise that must reject with an MfeflowError and returns it. */
+export declare function failure(promise: Promise<unknown>): Promise<MfeflowError>;
+/** Calls `fn`, which must throw an MfeflowError, and returns it. */
+export declare function thrown(fn: () => unknown): MfeflowError;
+/** Where git is installed, from a fixed list of system folders, never from a PATH search. */
+export declare function gitBinary(): string;
+/**
+ * The environment git runs in: no `GIT_*` variable, so git works on the folder it is run in and
+ * nothing else, and a PATH of git's own folder only.
+ */
+export declare function cleanGitEnv(env?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+/** Runs git with a clean environment in `cwd`; returns what it printed. */
+export declare function git(cwd: string, ...args: string[]): string;
+/** A `Run` that runs git by its fixed path in a clean environment, and refuses any other program. */
+export declare const gitRunner: Run;
+/** A system that runs the real `git init` (with a clean environment) and no install. */
+export declare function gitSystem(): System & SystemCalls;
+/** `file` with forward slashes, the way git prints a path on every OS. */
+export declare function posixPath(file: string): string;

package/dist/trust.d.ts

@@ -0,0 +1,4 @@
+import { type Trusted } from '@mfeflow/core';
+import type { Runtime } from './runtime.js';
+/** What this user trusts among `registries`: the trust file, or MFEFLOW_TRUST_REGISTRIES (public hosts only unless pinned to a template). */
+export declare function trustedIn(rt: Runtime, registries: Record<string, string> | undefined): Promise<Trusted>;

package/dist/upgrade.d.ts

@@ -0,0 +1,25 @@
+import { type MfeflowProject, type UpgradeDecisions, type UpgradePlan } from '@mfeflow/core';
+import type { AssetRoots } from './assets.js';
+import type { FetchLike } from '@mfeflow/core';
+export interface UpgradeContext {
+    roots: AssetRoots;
+    fetch: FetchLike;
+    /** Registry namespaces the user trusts to be on loopback or private addresses. */
+    trusted?: ReadonlySet<string>;
+    /** Take registry content that differs from the hash recorded in mfeflow.json: every feature (`true`) or the named ones. */
+    acceptChanged?: boolean | ReadonlySet<string>;
+}
+/** How a registry feature's content compared with the hash recorded for it. */
+export type IntegrityState = 'verified' | 'first-seen' | 'accepted-changed';
+export interface ProjectUpgrade extends UpgradePlan {
+    /** Registry features by name. `first-seen`: no hash was recorded, so the served content could not be checked. */
+    integrity: Record<string, IntegrityState>;
+}
+/** The features `init` would apply for these recorded ones, in its order, `core` and `tsconfig` first. */
+export declare function replayOrder(project: MfeflowProject): string[];
+/**
+ * Plans moving the project at `root` to `toVersion` (default: this CLI) from the templates and
+ * features this CLI ships. A recorded feature that cannot be loaded, or that a registry serves at
+ * another version than the one installed, is left out and named in the plan's warnings.
+ */
+export declare function planProjectUpgrade(ctx: UpgradeContext, root: string, project: MfeflowProject, toVersion?: string, decisions?: UpgradeDecisions): Promise<ProjectUpgrade>;

package/dist/write.d.ts

@@ -10,6 +10,14 @@ export interface WriteRequest {
     project: MfeflowProject;
     /** Runs once the files are written, before the install (`git init` for hooks that need a repo). */
     afterWrite?: () => Promise<void>;
+    /** Install even when the plan adds no dependency, for a plan that moves ranges. */
+    install?: boolean;
+    /** Take `project` as it is: its `cli` is the version being upgraded to, not the one running. */
+    exactProject?: boolean;
+    /** Refuse to write through any symlink on a file's path, checked when the files are written. */
+    refuseSymlinks?: boolean;
+    /** The caller prints the summary and diff itself. */
+    quiet?: boolean;
 }
 export interface WriteOutcome {
     dryRun: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mfeflow",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Create and grow a React micro-frontend platform: mfeflow init, add remote, add <feature>.",
   "keywords": [
     "micro-frontend",
@@ -49,14 +49,15 @@
   },
   "dependencies": {
     "@clack/prompts": "1.8.1",
-    "@mfeflow/contracts": "0.4.0",
-    "@mfeflow/core": "0.4.0",
+    "@mfeflow/contracts": "0.6.0",
+    "@mfeflow/core": "0.6.0",
+    "@mfeflow/registry": "0.6.0",
     "citty": "0.2.2",
     "semver": "7.8.5",
     "yaml": "2.9.1"
   },
   "devDependencies": {
-    "@mfeflow/rsbuild": "0.4.0",
+    "@mfeflow/rsbuild": "0.6.0",
     "@rslib/core": "1.0.5",
     "@types/node": "26.6.6",
     "@types/semver": "7.8.0",