@niujiajie/freespec 0.0.0-stage → 1.15.0

package/dist/core/command-generation/adapters/roocode.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Zoo Code Command Adapter
+ *
+ * Formats commands for Zoo Code following its workflow specification.
+ * Zoo Code uses markdown headers instead of YAML frontmatter.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Zoo Code adapter for command generation.
+ * File path: .roo/commands/freespec-<id>.md
+ * Format: Markdown header with description
+ */
+export declare const roocodeAdapter: ToolCommandAdapter;
+//# sourceMappingURL=roocode.d.ts.map

package/dist/core/command-generation/adapters/roocode.js

@@ -0,0 +1,27 @@
+/**
+ * Zoo Code Command Adapter
+ *
+ * Formats commands for Zoo Code following its workflow specification.
+ * Zoo Code uses markdown headers instead of YAML frontmatter.
+ */
+import path from 'path';
+/**
+ * Zoo Code adapter for command generation.
+ * File path: .roo/commands/freespec-<id>.md
+ * Format: Markdown header with description
+ */
+export const roocodeAdapter = {
+    toolId: 'roocode',
+    getFilePath(commandId) {
+        return path.join('.roo', 'commands', `freespec-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `# ${content.name}
+
+${content.description}
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=roocode.js.map

package/dist/core/command-generation/adapters/trae.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Trae Command Adapter
+ *
+ * Formats commands for Trae IDE following its command specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Trae adapter for command generation.
+ * File path: .trae/commands/freespec-<id>.md
+ * Frontmatter: name, description
+ */
+export declare const traeAdapter: ToolCommandAdapter;
+//# sourceMappingURL=trae.d.ts.map

package/dist/core/command-generation/adapters/trae.js

@@ -0,0 +1,28 @@
+/**
+ * Trae Command Adapter
+ *
+ * Formats commands for Trae IDE following its command specification.
+ */
+import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
+/**
+ * Trae adapter for command generation.
+ * File path: .trae/commands/freespec-<id>.md
+ * Frontmatter: name, description
+ */
+export const traeAdapter = {
+    toolId: 'trae',
+    getFilePath(commandId) {
+        return path.join('.trae', 'commands', `freespec-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+name: ${escapeYamlValue(content.name)}
+description: ${escapeYamlValue(content.description)}
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=trae.js.map

package/dist/core/command-generation/adapters/zcode.d.ts

@@ -0,0 +1,16 @@
+/**
+ * ZCode Command Adapter
+ *
+ * Formats commands for ZCode following its frontmatter specification.
+ * ZCode shares Claude Code's command format conventions.
+ * File path: .zcode/commands/freespec/<id>.md
+ * Frontmatter: name, description, category, tags
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * ZCode adapter for command generation.
+ * File path: .zcode/commands/freespec/<id>.md
+ * Frontmatter: name, description, category, tags
+ */
+export declare const zcodeAdapter: ToolCommandAdapter;
+//# sourceMappingURL=zcode.d.ts.map

package/dist/core/command-generation/adapters/zcode.js

@@ -0,0 +1,33 @@
+/**
+ * ZCode Command Adapter
+ *
+ * Formats commands for ZCode following its frontmatter specification.
+ * ZCode shares Claude Code's command format conventions.
+ * File path: .zcode/commands/freespec/<id>.md
+ * Frontmatter: name, description, category, tags
+ */
+import path from 'path';
+import { escapeYamlValue, formatTagsArray } from '../yaml.js';
+/**
+ * ZCode adapter for command generation.
+ * File path: .zcode/commands/freespec/<id>.md
+ * Frontmatter: name, description, category, tags
+ */
+export const zcodeAdapter = {
+    toolId: 'zcode',
+    getFilePath(commandId) {
+        return path.join('.zcode', 'commands', 'freespec', `${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+name: ${escapeYamlValue(content.name)}
+description: ${escapeYamlValue(content.description)}
+category: ${escapeYamlValue(content.category)}
+tags: ${formatTagsArray(content.tags)}
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=zcode.js.map

package/dist/core/command-generation/generator.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Command Generator
+ *
+ * Functions for generating command files using tool adapters.
+ */
+import type { CommandContent, ToolCommandAdapter, GeneratedCommand } from './types.js';
+/**
+ * Generate a single command file using the provided adapter.
+ *
+ * Command bodies are authored with `/freespec:<id>` references. Tools whose command
+ * files are invoked by filename register `/freespec-<id>` instead, and Amazon Q
+ * surfaces them in its prompt library as `@freespec-<id>`, so the body is rewritten
+ * to the form that tool answers to before the adapter formats it. Doing it here
+ * rather than per adapter keeps every tool in step (#727, #1307); adapters stay
+ * pure formatters.
+ *
+ * @param content - The tool-agnostic command content
+ * @param adapter - The tool-specific adapter
+ * @returns Generated command with path and file content
+ */
+export declare function generateCommand(content: CommandContent, adapter: ToolCommandAdapter): GeneratedCommand;
+/**
+ * Generate multiple command files using the provided adapter.
+ * @param contents - Array of tool-agnostic command contents
+ * @param adapter - The tool-specific adapter
+ * @returns Array of generated commands with paths and file contents
+ */
+export declare function generateCommands(contents: CommandContent[], adapter: ToolCommandAdapter): GeneratedCommand[];
+//# sourceMappingURL=generator.d.ts.map

package/dist/core/command-generation/generator.js

@@ -0,0 +1,43 @@
+/**
+ * Command Generator
+ *
+ * Functions for generating command files using tool adapters.
+ */
+import { getInvocationForAdapter, needsInvocationRewrite } from './invocation.js';
+import { transformCommandInvocations } from '../../utils/command-references.js';
+import { assertWorkflowConditionalsResolved } from '../templates/optional-workflow.js';
+/**
+ * Generate a single command file using the provided adapter.
+ *
+ * Command bodies are authored with `/freespec:<id>` references. Tools whose command
+ * files are invoked by filename register `/freespec-<id>` instead, and Amazon Q
+ * surfaces them in its prompt library as `@freespec-<id>`, so the body is rewritten
+ * to the form that tool answers to before the adapter formats it. Doing it here
+ * rather than per adapter keeps every tool in step (#727, #1307); adapters stay
+ * pure formatters.
+ *
+ * @param content - The tool-agnostic command content
+ * @param adapter - The tool-specific adapter
+ * @returns Generated command with path and file content
+ */
+export function generateCommand(content, adapter) {
+    assertWorkflowConditionalsResolved(content.body, `Command '${content.id}' was generated without resolving its optional-workflow blocks`);
+    const invocation = getInvocationForAdapter(adapter);
+    const formatted = needsInvocationRewrite(invocation)
+        ? { ...content, body: transformCommandInvocations(content.body, invocation) }
+        : content;
+    return {
+        path: adapter.getFilePath(content.id),
+        fileContent: adapter.formatFile(formatted),
+    };
+}
+/**
+ * Generate multiple command files using the provided adapter.
+ * @param contents - Array of tool-agnostic command contents
+ * @param adapter - The tool-specific adapter
+ * @returns Array of generated commands with paths and file contents
+ */
+export function generateCommands(contents, adapter) {
+    return contents.map((content) => generateCommand(content, adapter));
+}
+//# sourceMappingURL=generator.js.map

package/dist/core/command-generation/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Command Generation Module
+ *
+ * Generic command generation system with tool-specific adapters.
+ *
+ * Usage:
+ * ```typescript
+ * import { generateCommands, CommandAdapterRegistry, type CommandContent } from './command-generation/index.js';
+ *
+ * const contents: CommandContent[] = [...];
+ * const adapter = CommandAdapterRegistry.get('cursor');
+ * if (adapter) {
+ *   const commands = generateCommands(contents, adapter);
+ *   // Write commands to disk
+ * }
+ * ```
+ */
+export type { CommandContent, ToolCommandAdapter, GeneratedCommand, } from './types.js';
+export { CommandAdapterRegistry } from './registry.js';
+export { generateCommand, generateCommands } from './generator.js';
+export { claudeAdapter, cursorAdapter, devinAdapter } from './adapters/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/command-generation/index.js

@@ -0,0 +1,24 @@
+/**
+ * Command Generation Module
+ *
+ * Generic command generation system with tool-specific adapters.
+ *
+ * Usage:
+ * ```typescript
+ * import { generateCommands, CommandAdapterRegistry, type CommandContent } from './command-generation/index.js';
+ *
+ * const contents: CommandContent[] = [...];
+ * const adapter = CommandAdapterRegistry.get('cursor');
+ * if (adapter) {
+ *   const commands = generateCommands(contents, adapter);
+ *   // Write commands to disk
+ * }
+ * ```
+ */
+// Registry
+export { CommandAdapterRegistry } from './registry.js';
+// Generator functions
+export { generateCommand, generateCommands } from './generator.js';
+// Adapters (for direct access if needed)
+export { claudeAdapter, cursorAdapter, devinAdapter } from './adapters/index.js';
+//# sourceMappingURL=index.js.map

package/dist/core/command-generation/invocation.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Command Invocation
+ *
+ * How a tool spells a FreeSpec command has two parts, and only one of them
+ * can be read off the file the adapter writes:
+ *
+ * - The *name* comes from the file. `.../commands/freespec/<id>.md` is namespaced
+ *   by its directory, so the tool registers `freespec:<id>` (Claude Code, Gemini,
+ *   Crush, ...). `.../commands/freespec-<id>.md` names the command with the
+ *   filename, so the tool registers `freespec-<id>` (Cursor, GitHub Copilot,
+ *   OpenCode, ...).
+ * - The *prefix* is the tool's own and cannot be derived. Almost every tool
+ *   uses `/`; Amazon Q loads these files into its prompt library, which is
+ *   invoked with `@` (`@freespec-propose`), so its adapter declares that prefix.
+ *
+ * Deriving the name from `getFilePath` keeps generated cross-references and
+ * onboarding hints in step with the files FreeSpec actually writes. A
+ * hand-maintained list drifted before: only OpenCode was rewritten when the
+ * hyphen form was introduced (#727), and Cursor still advertised `/freespec:`
+ * commands its palette never registered (#1307). Carrying the prefix as
+ * adapter metadata rather than inferring it keeps the one tool that does not
+ * use a slash from being advertised as if it did.
+ */
+import type { ToolCommandAdapter } from './types.js';
+export type CommandInvocationStyle = 'namespaced' | 'flat';
+/**
+ * Everything needed to spell one of a tool's FreeSpec commands.
+ */
+export interface CommandInvocation {
+    /** How the command file names the command. */
+    style: CommandInvocationStyle;
+    /** What the user types before the name, e.g. `/` or Amazon Q's `@`. */
+    prefix: string;
+}
+/** The form these docs, command bodies, and skill templates are authored in. */
+export declare const CANONICAL_INVOCATION: CommandInvocation;
+/**
+ * Classifies a generated command file by the name the tool will answer to.
+ *
+ * The test is the filename, not the directory: an `freespec-` prefix means the
+ * filename is the command. Every other shape is treated as namespaced, which
+ * is what all seven `freespec/<id>.*` adapters need. An adapter that neither
+ * prefixes the filename nor nests under `freespec/` would land here too — none
+ * does, and the registry-wide test in invocation.test.ts fails if one appears.
+ *
+ * @param commandFilePath - Path returned by an adapter's `getFilePath`
+ * @returns 'flat' when the filename carries the `freespec-` prefix, otherwise
+ *          'namespaced'
+ */
+export declare function getInvocationStyleForPath(commandFilePath: string): CommandInvocationStyle;
+/**
+ * Resolves how a tool's generated commands are invoked: the name from the
+ * files its adapter writes, the prefix from the adapter's own declaration.
+ *
+ * @param adapter - The tool-specific command adapter
+ * @returns The invocation shared by every command that adapter generates
+ */
+export declare function getInvocationForAdapter(adapter: ToolCommandAdapter): CommandInvocation;
+/**
+ * Spells one command the way the tool registers it.
+ *
+ * @param invocation - The tool's invocation, from getInvocationForAdapter()
+ * @param commandId - The command identifier (e.g. 'apply')
+ * @returns What the user types, e.g. `/freespec:apply`, `/freespec-apply`, `@freespec-apply`
+ */
+export declare function formatCommandInvocation(invocation: CommandInvocation, commandId: string): string;
+/**
+ * Whether a tool's invocation differs from the canonical `/freespec:<id>` that
+ * command bodies and skill templates are authored in — that is, whether
+ * generated text has to be rewritten for that tool at all.
+ */
+export declare function needsInvocationRewrite(invocation: CommandInvocation): boolean;
+//# sourceMappingURL=invocation.d.ts.map

package/dist/core/command-generation/invocation.js

@@ -0,0 +1,77 @@
+/**
+ * Command Invocation
+ *
+ * How a tool spells a FreeSpec command has two parts, and only one of them
+ * can be read off the file the adapter writes:
+ *
+ * - The *name* comes from the file. `.../commands/freespec/<id>.md` is namespaced
+ *   by its directory, so the tool registers `freespec:<id>` (Claude Code, Gemini,
+ *   Crush, ...). `.../commands/freespec-<id>.md` names the command with the
+ *   filename, so the tool registers `freespec-<id>` (Cursor, GitHub Copilot,
+ *   OpenCode, ...).
+ * - The *prefix* is the tool's own and cannot be derived. Almost every tool
+ *   uses `/`; Amazon Q loads these files into its prompt library, which is
+ *   invoked with `@` (`@freespec-propose`), so its adapter declares that prefix.
+ *
+ * Deriving the name from `getFilePath` keeps generated cross-references and
+ * onboarding hints in step with the files FreeSpec actually writes. A
+ * hand-maintained list drifted before: only OpenCode was rewritten when the
+ * hyphen form was introduced (#727), and Cursor still advertised `/freespec:`
+ * commands its palette never registered (#1307). Carrying the prefix as
+ * adapter metadata rather than inferring it keeps the one tool that does not
+ * use a slash from being advertised as if it did.
+ */
+import path from 'path';
+/** The form these docs, command bodies, and skill templates are authored in. */
+export const CANONICAL_INVOCATION = { style: 'namespaced', prefix: '/' };
+/**
+ * Classifies a generated command file by the name the tool will answer to.
+ *
+ * The test is the filename, not the directory: an `freespec-` prefix means the
+ * filename is the command. Every other shape is treated as namespaced, which
+ * is what all seven `freespec/<id>.*` adapters need. An adapter that neither
+ * prefixes the filename nor nests under `freespec/` would land here too — none
+ * does, and the registry-wide test in invocation.test.ts fails if one appears.
+ *
+ * @param commandFilePath - Path returned by an adapter's `getFilePath`
+ * @returns 'flat' when the filename carries the `freespec-` prefix, otherwise
+ *          'namespaced'
+ */
+export function getInvocationStyleForPath(commandFilePath) {
+    return path.basename(commandFilePath).startsWith('freespec-') ? 'flat' : 'namespaced';
+}
+/**
+ * Resolves how a tool's generated commands are invoked: the name from the
+ * files its adapter writes, the prefix from the adapter's own declaration.
+ *
+ * @param adapter - The tool-specific command adapter
+ * @returns The invocation shared by every command that adapter generates
+ */
+export function getInvocationForAdapter(adapter) {
+    return {
+        // Any command id works: every adapter applies one naming rule to all of them.
+        style: getInvocationStyleForPath(adapter.getFilePath('explore')),
+        prefix: adapter.invocationPrefix ?? CANONICAL_INVOCATION.prefix,
+    };
+}
+/**
+ * Spells one command the way the tool registers it.
+ *
+ * @param invocation - The tool's invocation, from getInvocationForAdapter()
+ * @param commandId - The command identifier (e.g. 'apply')
+ * @returns What the user types, e.g. `/freespec:apply`, `/freespec-apply`, `@freespec-apply`
+ */
+export function formatCommandInvocation(invocation, commandId) {
+    const separator = invocation.style === 'namespaced' ? ':' : '-';
+    return `${invocation.prefix}freespec${separator}${commandId}`;
+}
+/**
+ * Whether a tool's invocation differs from the canonical `/freespec:<id>` that
+ * command bodies and skill templates are authored in — that is, whether
+ * generated text has to be rewritten for that tool at all.
+ */
+export function needsInvocationRewrite(invocation) {
+    return (invocation.style !== CANONICAL_INVOCATION.style ||
+        invocation.prefix !== CANONICAL_INVOCATION.prefix);
+}
+//# sourceMappingURL=invocation.js.map

package/dist/core/command-generation/registry.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Command Adapter Registry
+ *
+ * Centralized registry for tool command adapters.
+ * Similar pattern to existing SlashCommandRegistry in the codebase.
+ */
+import type { ToolCommandAdapter } from './types.js';
+/**
+ * Registry for looking up tool command adapters.
+ */
+export declare class CommandAdapterRegistry {
+    private static adapters;
+    /**
+     * Register a tool command adapter.
+     * @param adapter - The adapter to register
+     */
+    static register(adapter: ToolCommandAdapter): void;
+    /**
+     * Get an adapter by tool ID.
+     * @param toolId - The tool identifier (e.g., 'claude', 'cursor')
+     * @returns The adapter or undefined if not registered
+     */
+    static get(toolId: string): ToolCommandAdapter | undefined;
+    /**
+     * Get all registered adapters.
+     * @returns Array of all registered adapters
+     */
+    static getAll(): ToolCommandAdapter[];
+    /**
+     * Check if an adapter is registered for a tool.
+     * @param toolId - The tool identifier
+     * @returns True if an adapter exists
+     */
+    static has(toolId: string): boolean;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/command-generation/registry.js

@@ -0,0 +1,114 @@
+/**
+ * Command Adapter Registry
+ *
+ * Centralized registry for tool command adapters.
+ * Similar pattern to existing SlashCommandRegistry in the codebase.
+ */
+import { amazonQAdapter } from './adapters/amazon-q.js';
+import { antigravityAdapter } from './adapters/antigravity.js';
+import { atomcodeAdapter } from './adapters/atomcode.js';
+import { auggieAdapter } from './adapters/auggie.js';
+import { bobAdapter } from './adapters/bob.js';
+import { claudeAdapter } from './adapters/claude.js';
+import { clineAdapter } from './adapters/cline.js';
+import { commandCodeAdapter } from './adapters/command-code.js';
+import { devinAdapter } from './adapters/devin.js';
+import { codebuddyAdapter } from './adapters/codebuddy.js';
+import { codeStudioAdapter } from './adapters/codestudio.js';
+import { continueAdapter } from './adapters/continue.js';
+import { costrictAdapter } from './adapters/costrict.js';
+import { crushAdapter } from './adapters/crush.js';
+import { cursorAdapter } from './adapters/cursor.js';
+import { easycodeAdapter } from './adapters/easycode.js';
+import { factoryAdapter } from './adapters/factory.js';
+import { geminiAdapter } from './adapters/gemini.js';
+import { githubCopilotAdapter } from './adapters/github-copilot.js';
+import { gigacodeAdapter } from './adapters/gigacode.js';
+import { iflowAdapter } from './adapters/iflow.js';
+import { junieAdapter } from './adapters/junie.js';
+import { kilocodeAdapter } from './adapters/kilocode.js';
+import { kiroAdapter } from './adapters/kiro.js';
+import { ohMyPiAdapter } from './adapters/oh-my-pi.js';
+import { opencodeAdapter } from './adapters/opencode.js';
+import { piAdapter } from './adapters/pi.js';
+import { codeassistantAdapter } from './adapters/codeassistant.js';
+import { qoderAdapter } from './adapters/qoder.js';
+import { lingmaAdapter } from './adapters/lingma.js';
+import { qwenAdapter } from './adapters/qwen.js';
+import { roocodeAdapter } from './adapters/roocode.js';
+import { traeAdapter } from './adapters/trae.js';
+import { zcodeAdapter } from './adapters/zcode.js';
+/**
+ * Registry for looking up tool command adapters.
+ */
+export class CommandAdapterRegistry {
+    static adapters = new Map();
+    // Static initializer - register built-in adapters
+    static {
+        CommandAdapterRegistry.register(amazonQAdapter);
+        CommandAdapterRegistry.register(antigravityAdapter);
+        CommandAdapterRegistry.register(atomcodeAdapter);
+        CommandAdapterRegistry.register(auggieAdapter);
+        CommandAdapterRegistry.register(bobAdapter);
+        CommandAdapterRegistry.register(claudeAdapter);
+        CommandAdapterRegistry.register(clineAdapter);
+        CommandAdapterRegistry.register(commandCodeAdapter);
+        CommandAdapterRegistry.register(devinAdapter);
+        CommandAdapterRegistry.register(codebuddyAdapter);
+        CommandAdapterRegistry.register(codeStudioAdapter);
+        CommandAdapterRegistry.register(continueAdapter);
+        CommandAdapterRegistry.register(costrictAdapter);
+        CommandAdapterRegistry.register(crushAdapter);
+        CommandAdapterRegistry.register(cursorAdapter);
+        CommandAdapterRegistry.register(easycodeAdapter);
+        CommandAdapterRegistry.register(factoryAdapter);
+        CommandAdapterRegistry.register(geminiAdapter);
+        CommandAdapterRegistry.register(githubCopilotAdapter);
+        CommandAdapterRegistry.register(gigacodeAdapter);
+        CommandAdapterRegistry.register(iflowAdapter);
+        CommandAdapterRegistry.register(junieAdapter);
+        CommandAdapterRegistry.register(kilocodeAdapter);
+        CommandAdapterRegistry.register(kiroAdapter);
+        CommandAdapterRegistry.register(ohMyPiAdapter);
+        CommandAdapterRegistry.register(opencodeAdapter);
+        CommandAdapterRegistry.register(piAdapter);
+        CommandAdapterRegistry.register(codeassistantAdapter);
+        CommandAdapterRegistry.register(qoderAdapter);
+        CommandAdapterRegistry.register(lingmaAdapter);
+        CommandAdapterRegistry.register(qwenAdapter);
+        CommandAdapterRegistry.register(roocodeAdapter);
+        CommandAdapterRegistry.register(traeAdapter);
+        CommandAdapterRegistry.register(zcodeAdapter);
+    }
+    /**
+     * Register a tool command adapter.
+     * @param adapter - The adapter to register
+     */
+    static register(adapter) {
+        CommandAdapterRegistry.adapters.set(adapter.toolId, adapter);
+    }
+    /**
+     * Get an adapter by tool ID.
+     * @param toolId - The tool identifier (e.g., 'claude', 'cursor')
+     * @returns The adapter or undefined if not registered
+     */
+    static get(toolId) {
+        return CommandAdapterRegistry.adapters.get(toolId);
+    }
+    /**
+     * Get all registered adapters.
+     * @returns Array of all registered adapters
+     */
+    static getAll() {
+        return Array.from(CommandAdapterRegistry.adapters.values());
+    }
+    /**
+     * Check if an adapter is registered for a tool.
+     * @param toolId - The tool identifier
+     * @returns True if an adapter exists
+     */
+    static has(toolId) {
+        return CommandAdapterRegistry.adapters.has(toolId);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/command-generation/toml.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared TOML string escaping for command adapters.
+ */
+/**
+ * TOML basic strings are escape-active: a backslash or double quote in the
+ * value breaks the file if written raw. Newlines cannot appear in a
+ * single-line basic string at all, so they are escaped too.
+ */
+export declare function escapeTomlBasicString(value: string): string;
+/**
+ * Multiline basic strings keep raw newlines and tabs, but backslashes are
+ * still escape-active, any run of three quotes would end the string, and the
+ * same control characters are invalid as in single-line basic strings — a
+ * lone carriage return included (only LF and CRLF may appear raw; CRLF is
+ * normalized away so the emitted file is single-convention). Escapes are
+ * introduced after backslash-doubling so they are not re-doubled.
+ */
+export declare function escapeTomlMultilineBasicString(value: string): string;
+//# sourceMappingURL=toml.d.ts.map

package/dist/core/command-generation/toml.js

@@ -0,0 +1,39 @@
+/**
+ * Shared TOML string escaping for command adapters.
+ */
+/**
+ * Control characters (C0 except tab/newline/carriage return, plus DEL) are
+ * invalid inside TOML strings and must be written as escapes.
+ */
+const TOML_CONTROL_CHARS = new RegExp('[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]', 'g');
+/**
+ * TOML basic strings are escape-active: a backslash or double quote in the
+ * value breaks the file if written raw. Newlines cannot appear in a
+ * single-line basic string at all, so they are escaped too.
+ */
+export function escapeTomlBasicString(value) {
+    return value
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '\\r')
+        .replace(/\t/g, '\\t')
+        .replace(TOML_CONTROL_CHARS, (c) => `\\u${c.charCodeAt(0).toString(16).padStart(4, '0')}`);
+}
+/**
+ * Multiline basic strings keep raw newlines and tabs, but backslashes are
+ * still escape-active, any run of three quotes would end the string, and the
+ * same control characters are invalid as in single-line basic strings — a
+ * lone carriage return included (only LF and CRLF may appear raw; CRLF is
+ * normalized away so the emitted file is single-convention). Escapes are
+ * introduced after backslash-doubling so they are not re-doubled.
+ */
+export function escapeTomlMultilineBasicString(value) {
+    return value
+        .replace(/\r\n/g, '\n')
+        .replace(/\\/g, '\\\\')
+        .replace(/"""/g, '""\\"')
+        .replace(/\r/g, '\\r')
+        .replace(TOML_CONTROL_CHARS, (c) => `\\u${c.charCodeAt(0).toString(16).padStart(4, '0')}`);
+}
+//# sourceMappingURL=toml.js.map