@maz-ui/node 5.2.0-beta.0 → 5.3.0

package/README.md

@@ -370,7 +370,7 @@ All logger methods automatically handle error objects using `getErrorMessage` ut
 
 ## Requirements
 
-- Node.js >= 22.12.0
+- Node.js 22.23.4+, 24.22.1+ or 26.12.1+ (the releases with the October 2026 security fixes)
 - TypeScript support included
 
 ## Contributing

package/dist/agents.d.mts

@@ -0,0 +1,198 @@
+/**
+ * AI coding agents supported by `setupAgents`.
+ *
+ * - `claude`: Claude Code rule (`.claude/rules/<tool>.md`) and MCP server (`.mcp.json`)
+ * - `agents-md`: section in `AGENTS.md` (Codex, Cursor, Copilot, Windsurf, Zed, Gemini...)
+ * - `cursor`: MCP server in `.cursor/mcp.json` (rules come from `AGENTS.md`)
+ * - `vscode`: MCP server in `.vscode/mcp.json` for GitHub Copilot (rules come from `AGENTS.md`)
+ */
+type AgentTarget = 'claude' | 'agents-md' | 'cursor' | 'vscode';
+declare const AGENT_TARGETS: AgentTarget[];
+interface SetupAgentsOptions {
+    /** Root of the project (where `AGENTS.md`, `.claude/`, `.mcp.json` live) */
+    rootDir: string;
+    /** Agents to configure. Default: the agents detected in the project */
+    targets?: AgentTarget[];
+    /** Write the rules of the tool (Claude Code rule, `AGENTS.md` section). Default `true` */
+    rules?: boolean;
+    /** Register the MCP server of the tool. Default `true` */
+    mcp?: boolean;
+    /** Compute the changes without writing anything */
+    dryRun?: boolean;
+    /** Remove everything `setupAgents` added */
+    remove?: boolean;
+    /** Folder of the maz-ui agent docs. Default: `docs/` of the maz-ui package installed in `rootDir` */
+    docsDir?: string;
+    /** Command used to start the MCP server. Default: `mcpServerCommand(rootDir, mcpVersion, tool)` */
+    mcpServer?: McpServerCommand;
+    /** Version of the MCP package pinned in the `npx -y` command, when the project does not install it. Default `latest` */
+    mcpVersion?: string;
+    /** Tool whose agents are configured. Default: maz-ui (`MAZ_UI_AGENTS_TOOL`) */
+    tool?: AgentsTool;
+    /** Rules of the tool, required with another `tool` than maz-ui. Default: the maz-ui agent docs of `docsDir` */
+    agentDocs?: AgentDocs;
+    /**
+     * Scope of the Claude Code rule, written as a `paths:` frontmatter so that Claude Code only loads it
+     * when it reads or edits a matching file, instead of at every session:
+     * - `'auto'` (default): the files of the workspaces whose `package.json` depends on one of `tool.packages`
+     *   (e.g. `apps/pwa/**\/*.vue`), else the files of the project. No scope when the tool declares no `packages`
+     * - `'all'`: no scope, the rule is always loaded
+     * - globs, relative to `rootDir`: used as is
+     */
+    paths?: 'auto' | 'all' | string[];
+}
+interface McpServerCommand {
+    command: string;
+    args: string[];
+}
+type SetupAgentsAction = 'create' | 'update' | 'remove' | 'unchanged' | 'skip';
+interface SetupAgentsChange {
+    /** Path relative to `rootDir` */
+    file: string;
+    action: SetupAgentsAction;
+    reason?: string;
+}
+interface SetupAgentsResult {
+    targets: AgentTarget[];
+    version: string;
+    changes: SetupAgentsChange[];
+    /** Command registered in the MCP config files */
+    mcpServer: McpServerCommand;
+    /** `false` when the server runs through `npx -y` because the project does not install the MCP package */
+    localMcpServer: boolean;
+    /** Globs the Claude Code rule is scoped to (`paths:` frontmatter). `undefined`: the rule is always loaded, or not written */
+    claudeRulePaths?: string[];
+}
+declare const MANAGED_MARKER = "Managed by maz-ui";
+declare const AGENTS_MD_BEGIN = "<!-- BEGIN:maz-ui -->";
+declare const AGENTS_MD_END = "<!-- END:maz-ui -->";
+declare const MCP_SERVER_NAME = "maz-ui";
+declare const DEFAULT_MCP_SERVER: McpServerCommand;
+/**
+ * A tool whose AI agents are configured by `setupAgents`: maz-ui by default,
+ * or another package that ships its own MCP server and rules.
+ */
+interface AgentsTool {
+    /** Name of the tool: key of its MCP server, `.claude/rules/<name>.md` and markers of the generated content */
+    name: string;
+    /** Package that ships the MCP server */
+    mcpPackage: string;
+    /** Bin of `mcpPackage` that starts the MCP server */
+    mcpBin: string;
+    /** Arguments of `mcpBin` that start the MCP server (e.g. `['mcp']`). Default `[]` */
+    mcpArgs?: string[];
+    /** What generates the rules, written in their header (markdown, e.g. `` `npx relizy mcp init` ``) */
+    generatedBy: string;
+    /** Marker of the generated content, written in its header and used to recognize the files the tool owns. Default `Managed by <name>` */
+    marker?: string;
+    /**
+     * Line written under the title of the rules, `false` to write none.
+     * Default: `> <name> <version> is installed: these rules match this version.`
+     */
+    versionNote?: ((version: string) => string) | false;
+    /**
+     * Packages (or bins) of former MCP servers of the tool: an entry of the MCP config files that references one of
+     * them, when the tool has no entry yet, is replaced by the entry of the tool. Default: none
+     */
+    legacyMcpPackages?: string[];
+    /**
+     * Packages whose presence in the `dependencies`, `devDependencies`, `peerDependencies` or `optionalDependencies`
+     * of a `package.json` ties the files of its project to the tool (e.g. `['maz-ui', '@maz-ui/themes']`). Used by
+     * the `'auto'` scope of the Claude Code rule. Default: none, the rule is always loaded
+     */
+    packages?: string[];
+    /**
+     * Files of a project the rule applies to, relative to its folder. Default `['**\/*']` (the whole project).
+     * With `packages`, applied to each workspace that depends on one of them
+     */
+    ruleGlobs?: string[];
+}
+declare const MAZ_UI_AGENTS_TOOL: AgentsTool;
+type PackageManager = 'pnpm' | 'yarn' | 'bun' | 'npm';
+/** `true` when the `package.json` of the project declares the MCP package of the tool (`@maz-ui/mcp` by default) */
+declare function installsMcpPackage(rootDir: string, tool?: AgentsTool): boolean;
+/** Package manager of a project: the `packageManager` field, else its lockfile */
+declare function detectPackageManager(rootDir: string): PackageManager;
+/**
+ * Command of the MCP server of a tool (maz-ui by default) for a project. When
+ * the project installs its package, the package manager starts the installed
+ * version in about a second, at the version of the lockfile. Otherwise
+ * `npx -y` downloads it, pinned to `version`: a dist-tag (`latest`) makes npx
+ * query the registry at every start, which can exceed the start timeout of the
+ * agents behind a slow registry.
+ */
+declare function mcpServerCommand(rootDir: string, version?: string, tool?: AgentsTool): McpServerCommand;
+/**
+ * `true` when generated rules were edited by hand since they were written:
+ * they are kept, a newer version of the rules would overwrite the edits.
+ * The checksum covers what follows the managed header, and also what precedes
+ * it (the `paths:` frontmatter), so an edit of the frontmatter is kept too. A
+ * checksum of the body alone is still accepted: rules written without
+ * frontmatter (header on the first line), or before the frontmatter was part
+ * of the checksum, are checked against it.
+ */
+declare function isEditedManagedContent(content: string | undefined, tool?: AgentsTool): boolean;
+/** Detects the AI agents configured in a project */
+declare function detectAgentTargets(rootDir: string): AgentTarget[];
+interface AgentDocs {
+    directory: string;
+    version: string;
+    claudeRule: string;
+    agentsMdSection: string;
+}
+/**
+ * Finds `node_modules/<name>` from a directory up to the filesystem root, like
+ * the Node resolution but without the global folders (`NODE_PATH`), so only a
+ * package installed for the project is found.
+ */
+declare function findInstalledPackage(fromDir: string, name: string): string | undefined;
+/** Version of an installed package, read from its `package.json` */
+declare function readPackageVersion(packageDir: string): string | undefined;
+/**
+ * Workspace patterns of a monorepo: the `packages` of `pnpm-workspace.yaml`,
+ * else the `workspaces` of `package.json` (npm, yarn, bun), else `apps/*` and
+ * `packages/*`. Negated patterns are ignored.
+ */
+declare function readWorkspacePatterns(rootDir: string): string[];
+/** Folders of the workspaces of a monorepo, in the order of the patterns. Only the fixed part of each pattern is read (`apps/*` reads `apps`) */
+declare function findWorkspaceDirs(rootDir: string): string[];
+/**
+ * Finds a package installed in a project: in the `node_modules` of the
+ * project root and of its workspaces (monorepos without hoisting), then in
+ * the parent folders.
+ */
+declare function findProjectPackage(rootDir: string, name: string): string | undefined;
+/** Reads the agent files shipped in `maz-ui/docs/agents` */
+declare function readAgentDocs(rootDir: string, docsDir?: string): AgentDocs;
+/**
+ * Writes a temporary file then renames it: a concurrent reader (several Nuxt
+ * apps of a monorepo starting together) sees the old or the new file, never a
+ * truncated one.
+ */
+declare function writeFileAtomic(path: string, content: string): void;
+/** Compares two semver versions: negative when `a < b`, positive when `a > b`, `0` when equal */
+declare function compareVersions(a: string, b: string): number;
+/** Version of the tool (maz-ui by default) that generated a managed content, read from its header */
+declare function readManagedVersion(content: string | undefined, tool?: AgentsTool): string | undefined;
+/**
+ * Folders (relative to `rootDir`, `''` for the root) whose `package.json` depends on one of the packages: the
+ * workspaces of a monorepo, or the root of a single package project. The workspaces excluded by a negated pattern
+ * (`!apps/legacy`) are left out, with the folders below them
+ */
+declare function findWorkspacesUsing(rootDir: string, packages: string[]): string[];
+/**
+ * Globs the Claude Code rule is scoped to, `undefined` when it must always be loaded. The root of the project
+ * depending on the tool (single package project), or no dependency found (the tool is used from elsewhere), apply
+ * the files of the tool to the whole project, since no folder is more relevant than another.
+ */
+declare function resolveRulePaths(rootDir: string, tool: AgentsTool, option?: SetupAgentsOptions['paths']): string[] | undefined;
+/**
+ * Configures the AI coding agents of a project to use a tool, maz-ui by
+ * default: rules (version matched with the installed tool) and its MCP server.
+ * Idempotent and conservative: it only writes files it owns, a delimited
+ * section of `AGENTS.md` and its own entry of the MCP config files.
+ */
+declare function setupAgents(options: SetupAgentsOptions): SetupAgentsResult;
+
+export { AGENTS_MD_BEGIN, AGENTS_MD_END, AGENT_TARGETS, DEFAULT_MCP_SERVER, MANAGED_MARKER, MAZ_UI_AGENTS_TOOL, MCP_SERVER_NAME, compareVersions, detectAgentTargets, detectPackageManager, findInstalledPackage, findProjectPackage, findWorkspaceDirs, findWorkspacesUsing, installsMcpPackage, isEditedManagedContent, mcpServerCommand, readAgentDocs, readManagedVersion, readPackageVersion, readWorkspacePatterns, resolveRulePaths, setupAgents, writeFileAtomic };
+export type { AgentDocs, AgentTarget, AgentsTool, McpServerCommand, PackageManager, SetupAgentsAction, SetupAgentsChange, SetupAgentsOptions, SetupAgentsResult };

package/dist/agents.d.ts

@@ -0,0 +1,198 @@
+/**
+ * AI coding agents supported by `setupAgents`.
+ *
+ * - `claude`: Claude Code rule (`.claude/rules/<tool>.md`) and MCP server (`.mcp.json`)
+ * - `agents-md`: section in `AGENTS.md` (Codex, Cursor, Copilot, Windsurf, Zed, Gemini...)
+ * - `cursor`: MCP server in `.cursor/mcp.json` (rules come from `AGENTS.md`)
+ * - `vscode`: MCP server in `.vscode/mcp.json` for GitHub Copilot (rules come from `AGENTS.md`)
+ */
+type AgentTarget = 'claude' | 'agents-md' | 'cursor' | 'vscode';
+declare const AGENT_TARGETS: AgentTarget[];
+interface SetupAgentsOptions {
+    /** Root of the project (where `AGENTS.md`, `.claude/`, `.mcp.json` live) */
+    rootDir: string;
+    /** Agents to configure. Default: the agents detected in the project */
+    targets?: AgentTarget[];
+    /** Write the rules of the tool (Claude Code rule, `AGENTS.md` section). Default `true` */
+    rules?: boolean;
+    /** Register the MCP server of the tool. Default `true` */
+    mcp?: boolean;
+    /** Compute the changes without writing anything */
+    dryRun?: boolean;
+    /** Remove everything `setupAgents` added */
+    remove?: boolean;
+    /** Folder of the maz-ui agent docs. Default: `docs/` of the maz-ui package installed in `rootDir` */
+    docsDir?: string;
+    /** Command used to start the MCP server. Default: `mcpServerCommand(rootDir, mcpVersion, tool)` */
+    mcpServer?: McpServerCommand;
+    /** Version of the MCP package pinned in the `npx -y` command, when the project does not install it. Default `latest` */
+    mcpVersion?: string;
+    /** Tool whose agents are configured. Default: maz-ui (`MAZ_UI_AGENTS_TOOL`) */
+    tool?: AgentsTool;
+    /** Rules of the tool, required with another `tool` than maz-ui. Default: the maz-ui agent docs of `docsDir` */
+    agentDocs?: AgentDocs;
+    /**
+     * Scope of the Claude Code rule, written as a `paths:` frontmatter so that Claude Code only loads it
+     * when it reads or edits a matching file, instead of at every session:
+     * - `'auto'` (default): the files of the workspaces whose `package.json` depends on one of `tool.packages`
+     *   (e.g. `apps/pwa/**\/*.vue`), else the files of the project. No scope when the tool declares no `packages`
+     * - `'all'`: no scope, the rule is always loaded
+     * - globs, relative to `rootDir`: used as is
+     */
+    paths?: 'auto' | 'all' | string[];
+}
+interface McpServerCommand {
+    command: string;
+    args: string[];
+}
+type SetupAgentsAction = 'create' | 'update' | 'remove' | 'unchanged' | 'skip';
+interface SetupAgentsChange {
+    /** Path relative to `rootDir` */
+    file: string;
+    action: SetupAgentsAction;
+    reason?: string;
+}
+interface SetupAgentsResult {
+    targets: AgentTarget[];
+    version: string;
+    changes: SetupAgentsChange[];
+    /** Command registered in the MCP config files */
+    mcpServer: McpServerCommand;
+    /** `false` when the server runs through `npx -y` because the project does not install the MCP package */
+    localMcpServer: boolean;
+    /** Globs the Claude Code rule is scoped to (`paths:` frontmatter). `undefined`: the rule is always loaded, or not written */
+    claudeRulePaths?: string[];
+}
+declare const MANAGED_MARKER = "Managed by maz-ui";
+declare const AGENTS_MD_BEGIN = "<!-- BEGIN:maz-ui -->";
+declare const AGENTS_MD_END = "<!-- END:maz-ui -->";
+declare const MCP_SERVER_NAME = "maz-ui";
+declare const DEFAULT_MCP_SERVER: McpServerCommand;
+/**
+ * A tool whose AI agents are configured by `setupAgents`: maz-ui by default,
+ * or another package that ships its own MCP server and rules.
+ */
+interface AgentsTool {
+    /** Name of the tool: key of its MCP server, `.claude/rules/<name>.md` and markers of the generated content */
+    name: string;
+    /** Package that ships the MCP server */
+    mcpPackage: string;
+    /** Bin of `mcpPackage` that starts the MCP server */
+    mcpBin: string;
+    /** Arguments of `mcpBin` that start the MCP server (e.g. `['mcp']`). Default `[]` */
+    mcpArgs?: string[];
+    /** What generates the rules, written in their header (markdown, e.g. `` `npx relizy mcp init` ``) */
+    generatedBy: string;
+    /** Marker of the generated content, written in its header and used to recognize the files the tool owns. Default `Managed by <name>` */
+    marker?: string;
+    /**
+     * Line written under the title of the rules, `false` to write none.
+     * Default: `> <name> <version> is installed: these rules match this version.`
+     */
+    versionNote?: ((version: string) => string) | false;
+    /**
+     * Packages (or bins) of former MCP servers of the tool: an entry of the MCP config files that references one of
+     * them, when the tool has no entry yet, is replaced by the entry of the tool. Default: none
+     */
+    legacyMcpPackages?: string[];
+    /**
+     * Packages whose presence in the `dependencies`, `devDependencies`, `peerDependencies` or `optionalDependencies`
+     * of a `package.json` ties the files of its project to the tool (e.g. `['maz-ui', '@maz-ui/themes']`). Used by
+     * the `'auto'` scope of the Claude Code rule. Default: none, the rule is always loaded
+     */
+    packages?: string[];
+    /**
+     * Files of a project the rule applies to, relative to its folder. Default `['**\/*']` (the whole project).
+     * With `packages`, applied to each workspace that depends on one of them
+     */
+    ruleGlobs?: string[];
+}
+declare const MAZ_UI_AGENTS_TOOL: AgentsTool;
+type PackageManager = 'pnpm' | 'yarn' | 'bun' | 'npm';
+/** `true` when the `package.json` of the project declares the MCP package of the tool (`@maz-ui/mcp` by default) */
+declare function installsMcpPackage(rootDir: string, tool?: AgentsTool): boolean;
+/** Package manager of a project: the `packageManager` field, else its lockfile */
+declare function detectPackageManager(rootDir: string): PackageManager;
+/**
+ * Command of the MCP server of a tool (maz-ui by default) for a project. When
+ * the project installs its package, the package manager starts the installed
+ * version in about a second, at the version of the lockfile. Otherwise
+ * `npx -y` downloads it, pinned to `version`: a dist-tag (`latest`) makes npx
+ * query the registry at every start, which can exceed the start timeout of the
+ * agents behind a slow registry.
+ */
+declare function mcpServerCommand(rootDir: string, version?: string, tool?: AgentsTool): McpServerCommand;
+/**
+ * `true` when generated rules were edited by hand since they were written:
+ * they are kept, a newer version of the rules would overwrite the edits.
+ * The checksum covers what follows the managed header, and also what precedes
+ * it (the `paths:` frontmatter), so an edit of the frontmatter is kept too. A
+ * checksum of the body alone is still accepted: rules written without
+ * frontmatter (header on the first line), or before the frontmatter was part
+ * of the checksum, are checked against it.
+ */
+declare function isEditedManagedContent(content: string | undefined, tool?: AgentsTool): boolean;
+/** Detects the AI agents configured in a project */
+declare function detectAgentTargets(rootDir: string): AgentTarget[];
+interface AgentDocs {
+    directory: string;
+    version: string;
+    claudeRule: string;
+    agentsMdSection: string;
+}
+/**
+ * Finds `node_modules/<name>` from a directory up to the filesystem root, like
+ * the Node resolution but without the global folders (`NODE_PATH`), so only a
+ * package installed for the project is found.
+ */
+declare function findInstalledPackage(fromDir: string, name: string): string | undefined;
+/** Version of an installed package, read from its `package.json` */
+declare function readPackageVersion(packageDir: string): string | undefined;
+/**
+ * Workspace patterns of a monorepo: the `packages` of `pnpm-workspace.yaml`,
+ * else the `workspaces` of `package.json` (npm, yarn, bun), else `apps/*` and
+ * `packages/*`. Negated patterns are ignored.
+ */
+declare function readWorkspacePatterns(rootDir: string): string[];
+/** Folders of the workspaces of a monorepo, in the order of the patterns. Only the fixed part of each pattern is read (`apps/*` reads `apps`) */
+declare function findWorkspaceDirs(rootDir: string): string[];
+/**
+ * Finds a package installed in a project: in the `node_modules` of the
+ * project root and of its workspaces (monorepos without hoisting), then in
+ * the parent folders.
+ */
+declare function findProjectPackage(rootDir: string, name: string): string | undefined;
+/** Reads the agent files shipped in `maz-ui/docs/agents` */
+declare function readAgentDocs(rootDir: string, docsDir?: string): AgentDocs;
+/**
+ * Writes a temporary file then renames it: a concurrent reader (several Nuxt
+ * apps of a monorepo starting together) sees the old or the new file, never a
+ * truncated one.
+ */
+declare function writeFileAtomic(path: string, content: string): void;
+/** Compares two semver versions: negative when `a < b`, positive when `a > b`, `0` when equal */
+declare function compareVersions(a: string, b: string): number;
+/** Version of the tool (maz-ui by default) that generated a managed content, read from its header */
+declare function readManagedVersion(content: string | undefined, tool?: AgentsTool): string | undefined;
+/**
+ * Folders (relative to `rootDir`, `''` for the root) whose `package.json` depends on one of the packages: the
+ * workspaces of a monorepo, or the root of a single package project. The workspaces excluded by a negated pattern
+ * (`!apps/legacy`) are left out, with the folders below them
+ */
+declare function findWorkspacesUsing(rootDir: string, packages: string[]): string[];
+/**
+ * Globs the Claude Code rule is scoped to, `undefined` when it must always be loaded. The root of the project
+ * depending on the tool (single package project), or no dependency found (the tool is used from elsewhere), apply
+ * the files of the tool to the whole project, since no folder is more relevant than another.
+ */
+declare function resolveRulePaths(rootDir: string, tool: AgentsTool, option?: SetupAgentsOptions['paths']): string[] | undefined;
+/**
+ * Configures the AI coding agents of a project to use a tool, maz-ui by
+ * default: rules (version matched with the installed tool) and its MCP server.
+ * Idempotent and conservative: it only writes files it owns, a delimited
+ * section of `AGENTS.md` and its own entry of the MCP config files.
+ */
+declare function setupAgents(options: SetupAgentsOptions): SetupAgentsResult;
+
+export { AGENTS_MD_BEGIN, AGENTS_MD_END, AGENT_TARGETS, DEFAULT_MCP_SERVER, MANAGED_MARKER, MAZ_UI_AGENTS_TOOL, MCP_SERVER_NAME, compareVersions, detectAgentTargets, detectPackageManager, findInstalledPackage, findProjectPackage, findWorkspaceDirs, findWorkspacesUsing, installsMcpPackage, isEditedManagedContent, mcpServerCommand, readAgentDocs, readManagedVersion, readPackageVersion, readWorkspacePatterns, resolveRulePaths, setupAgents, writeFileAtomic };
+export type { AgentDocs, AgentTarget, AgentsTool, McpServerCommand, PackageManager, SetupAgentsAction, SetupAgentsChange, SetupAgentsOptions, SetupAgentsResult };

package/dist/agents.mjs

@@ -0,0 +1,5 @@
+export { A as AGENTS_MD_BEGIN, a as AGENTS_MD_END, b as AGENT_TARGETS, D as DEFAULT_MCP_SERVER, M as MANAGED_MARKER, c as MAZ_UI_AGENTS_TOOL, d as MCP_SERVER_NAME, e as compareVersions, f as detectAgentTargets, g as detectPackageManager, h as findInstalledPackage, i as findProjectPackage, j as findWorkspaceDirs, k as findWorkspacesUsing, l as installsMcpPackage, m as isEditedManagedContent, n as mcpServerCommand, r as readAgentDocs, o as readManagedVersion, p as readPackageVersion, q as readWorkspacePatterns, s as resolveRulePaths, t as setupAgents, w as writeFileAtomic } from './shared/node.rmAtZA9U.mjs';
+import 'node:crypto';
+import 'node:fs';
+import 'node:path';
+import 'jsonc-parser';

package/dist/index.d.mts

@@ -3,6 +3,7 @@ import * as consola from 'consola';
 import { ConsolaOptions, InputLogObject, ConsolaReporter, ConsolaInstance } from 'consola';
 export { ConsolaOptions } from 'consola';
 import { FigletOptions } from 'figlet/node';
+export { AGENTS_MD_BEGIN, AGENTS_MD_END, AGENT_TARGETS, AgentDocs, AgentTarget, AgentsTool, DEFAULT_MCP_SERVER, MANAGED_MARKER, MAZ_UI_AGENTS_TOOL, MCP_SERVER_NAME, McpServerCommand, PackageManager, SetupAgentsAction, SetupAgentsChange, SetupAgentsOptions, SetupAgentsResult, compareVersions, detectAgentTargets, detectPackageManager, findInstalledPackage, findProjectPackage, findWorkspaceDirs, findWorkspacesUsing, installsMcpPackage, isEditedManagedContent, mcpServerCommand, readAgentDocs, readManagedVersion, readPackageVersion, readWorkspacePatterns, resolveRulePaths, setupAgents, writeFileAtomic } from './agents.mjs';
 
 declare const LogLevelMap: {
     silent: number;
@@ -168,152 +169,5 @@ declare function redactSecrets(input: string): string;
  */
 declare function redactError<T>(error: T): T;
 
-/**
- * AI coding agents supported by `setupAgents`.
- *
- * - `claude`: Claude Code rule (`.claude/rules/<tool>.md`) and MCP server (`.mcp.json`)
- * - `agents-md`: section in `AGENTS.md` (Codex, Cursor, Copilot, Windsurf, Zed, Gemini...)
- * - `cursor`: MCP server in `.cursor/mcp.json` (rules come from `AGENTS.md`)
- * - `vscode`: MCP server in `.vscode/mcp.json` for GitHub Copilot (rules come from `AGENTS.md`)
- */
-type AgentTarget = 'claude' | 'agents-md' | 'cursor' | 'vscode';
-declare const AGENT_TARGETS: AgentTarget[];
-interface SetupAgentsOptions {
-    /** Root of the project (where `AGENTS.md`, `.claude/`, `.mcp.json` live) */
-    rootDir: string;
-    /** Agents to configure. Default: the agents detected in the project */
-    targets?: AgentTarget[];
-    /** Write the rules of the tool (Claude Code rule, `AGENTS.md` section). Default `true` */
-    rules?: boolean;
-    /** Register the MCP server of the tool. Default `true` */
-    mcp?: boolean;
-    /** Compute the changes without writing anything */
-    dryRun?: boolean;
-    /** Remove everything `setupAgents` added */
-    remove?: boolean;
-    /** Folder of the maz-ui agent docs. Default: `docs/` of the maz-ui package installed in `rootDir` */
-    docsDir?: string;
-    /** Command used to start the MCP server. Default: `mcpServerCommand(rootDir, mcpVersion, tool)` */
-    mcpServer?: McpServerCommand;
-    /** Version of the MCP package pinned in the `npx -y` command, when the project does not install it. Default `latest` */
-    mcpVersion?: string;
-    /** Tool whose agents are configured. Default: maz-ui (`MAZ_UI_AGENTS_TOOL`) */
-    tool?: AgentsTool;
-    /** Rules of the tool, required with another `tool` than maz-ui. Default: the maz-ui agent docs of `docsDir` */
-    agentDocs?: AgentDocs;
-}
-interface McpServerCommand {
-    command: string;
-    args: string[];
-}
-type SetupAgentsAction = 'create' | 'update' | 'remove' | 'unchanged' | 'skip';
-interface SetupAgentsChange {
-    /** Path relative to `rootDir` */
-    file: string;
-    action: SetupAgentsAction;
-    reason?: string;
-}
-interface SetupAgentsResult {
-    targets: AgentTarget[];
-    version: string;
-    changes: SetupAgentsChange[];
-    /** Command registered in the MCP config files */
-    mcpServer: McpServerCommand;
-    /** `false` when the server runs through `npx -y` because the project does not install the MCP package */
-    localMcpServer: boolean;
-}
-declare const MANAGED_MARKER = "Managed by maz-ui";
-declare const AGENTS_MD_BEGIN = "<!-- BEGIN:maz-ui -->";
-declare const AGENTS_MD_END = "<!-- END:maz-ui -->";
-declare const MCP_SERVER_NAME = "maz-ui";
-declare const DEFAULT_MCP_SERVER: McpServerCommand;
-/**
- * A tool whose AI agents are configured by `setupAgents`: maz-ui by default,
- * or another package that ships its own MCP server and rules.
- */
-interface AgentsTool {
-    /** Name of the tool: key of its MCP server, `.claude/rules/<name>.md` and markers of the generated content */
-    name: string;
-    /** Package that ships the MCP server */
-    mcpPackage: string;
-    /** Bin of `mcpPackage` that starts the MCP server */
-    mcpBin: string;
-    /** Arguments of `mcpBin` that start the MCP server (e.g. `['mcp']`). Default `[]` */
-    mcpArgs?: string[];
-    /** What generates the rules, written in their header (markdown, e.g. `` `npx relizy mcp init` ``) */
-    generatedBy: string;
-    /** Line written under the title of the rules. Default: `> <name> <version> is installed: these rules match this version.` */
-    versionNote?: (version: string) => string;
-}
-declare const MAZ_UI_AGENTS_TOOL: AgentsTool;
-type PackageManager = 'pnpm' | 'yarn' | 'bun' | 'npm';
-/** `true` when the `package.json` of the project declares the MCP package of the tool (`@maz-ui/mcp` by default) */
-declare function installsMcpPackage(rootDir: string, tool?: AgentsTool): boolean;
-/** Package manager of a project: the `packageManager` field, else its lockfile */
-declare function detectPackageManager(rootDir: string): PackageManager;
-/**
- * Command of the MCP server of a tool (maz-ui by default) for a project. When
- * the project installs its package, the package manager starts the installed
- * version in about a second, at the version of the lockfile. Otherwise
- * `npx -y` downloads it, pinned to `version`: a dist-tag (`latest`) makes npx
- * query the registry at every start, which can exceed the start timeout of the
- * agents behind a slow registry.
- */
-declare function mcpServerCommand(rootDir: string, version?: string, tool?: AgentsTool): McpServerCommand;
-/**
- * `true` when generated rules were edited by hand since they were written:
- * they are kept, a newer version of the rules would overwrite the edits.
- */
-declare function isEditedManagedContent(content: string | undefined, tool?: AgentsTool): boolean;
-/** Detects the AI agents configured in a project */
-declare function detectAgentTargets(rootDir: string): AgentTarget[];
-interface AgentDocs {
-    directory: string;
-    version: string;
-    claudeRule: string;
-    agentsMdSection: string;
-}
-/**
- * Finds `node_modules/<name>` from a directory up to the filesystem root, like
- * the Node resolution but without the global folders (`NODE_PATH`), so only a
- * package installed for the project is found.
- */
-declare function findInstalledPackage(fromDir: string, name: string): string | undefined;
-/** Version of an installed package, read from its `package.json` */
-declare function readPackageVersion(packageDir: string): string | undefined;
-/**
- * Workspace patterns of a monorepo: the `packages` of `pnpm-workspace.yaml`,
- * else the `workspaces` of `package.json` (npm, yarn, bun), else `apps/*` and
- * `packages/*`. Negated patterns are ignored.
- */
-declare function readWorkspacePatterns(rootDir: string): string[];
-/** Folders of the workspaces of a monorepo, in the order of the patterns. Only the fixed part of each pattern is read (`apps/*` reads `apps`) */
-declare function findWorkspaceDirs(rootDir: string): string[];
-/**
- * Finds a package installed in a project: in the `node_modules` of the
- * project root and of its workspaces (monorepos without hoisting), then in
- * the parent folders.
- */
-declare function findProjectPackage(rootDir: string, name: string): string | undefined;
-/** Reads the agent files shipped in `maz-ui/docs/agents` */
-declare function readAgentDocs(rootDir: string, docsDir?: string): AgentDocs;
-/**
- * Writes a temporary file then renames it: a concurrent reader (several Nuxt
- * apps of a monorepo starting together) sees the old or the new file, never a
- * truncated one.
- */
-declare function writeFileAtomic(path: string, content: string): void;
-/** Compares two semver versions: negative when `a < b`, positive when `a > b`, `0` when equal */
-declare function compareVersions(a: string, b: string): number;
-/** Version of the tool (maz-ui by default) that generated a managed content, read from its header */
-declare function readManagedVersion(content: string | undefined, tool?: AgentsTool): string | undefined;
-/**
- * Configures the AI coding agents of a project to use a tool, maz-ui by
- * default: rules (version matched with the installed tool) and its MCP server.
- * Idempotent and conservative: it only writes files it owns, a delimited
- * section of `AGENTS.md` and its own entry of the MCP config files.
- */
-declare function setupAgents(options: SetupAgentsOptions): SetupAgentsResult;
-
-export { AGENTS_MD_BEGIN, AGENTS_MD_END, AGENT_TARGETS, DEFAULT_MCP_SERVER, MANAGED_MARKER, MAZ_UI_AGENTS_TOOL, MCP_SERVER_NAME, compareVersions, createLogger, detectAgentTargets, detectPackageManager, execPromise, findInstalledPackage, findProjectPackage, findWorkspaceDirs, installsMcpPackage, isEditedManagedContent, logger, mcpServerCommand, printBanner, readAgentDocs, readManagedVersion, readPackageVersion, readWorkspacePatterns, redactError, redactSecrets, setupAgents, writeFileAtomic };
-export type { AgentDocs, AgentTarget, AgentsTool, ExecPromiseOptions, LogLevel, Logger, LoggerOptions, McpServerCommand, PackageManager, SetupAgentsAction, SetupAgentsChange, SetupAgentsOptions, SetupAgentsResult };
+export { createLogger, execPromise, logger, printBanner, redactError, redactSecrets };
+export type { ExecPromiseOptions, LogLevel, Logger, LoggerOptions };