@h2nguyen/arc42-node-mcp-server 2.0.0 → 2.1.1

package/dist/templates/formats/output-format-registry.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Output Format Registry
+ *
+ * Registry for storing and retrieving output format strategies.
+ * Uses Map for O(1) lookup by normalized format code.
+ *
+ * @module templates/formats/output-format-registry
+ *
+ * S.O.L.I.D Principles:
+ * - SRP (Single Responsibility Principle): Only manages registration and lookup,
+ *   not creation or content generation
+ *
+ * Design Patterns:
+ * - Registry Pattern: Single source of truth for format strategies
+ */
+import type { OutputFormatStrategy, OutputFormatCode } from './output-format-strategy.js';
+/**
+ * Output Format Registry Class
+ *
+ * Manages the collection of output format strategies, providing registration,
+ * lookup, and enumeration capabilities with case-insensitive code handling.
+ *
+ * @example
+ * ```typescript
+ * const registry = new OutputFormatRegistry();
+ * registry.register(markdownStrategy);
+ * registry.register(asciidocStrategy);
+ *
+ * const strategy = registry.get('asciidoc'); // Case-insensitive
+ * const allCodes = registry.getAvailableCodes(); // ['markdown', 'asciidoc']
+ * ```
+ */
+export declare class OutputFormatRegistry {
+    /**
+     * Internal map storing strategies by normalized (lowercase) format code
+     */
+    private readonly strategies;
+    constructor();
+    /**
+     * Normalize a format code for consistent storage and lookup
+     *
+     * @param code - The format code to normalize
+     * @returns Lowercase, trimmed format code
+     */
+    private normalizeCode;
+    /**
+     * Register an output format strategy
+     *
+     * Stores the strategy using its code (normalized to lowercase).
+     * If a strategy with the same code already exists, it will be overwritten.
+     *
+     * @param strategy - The output format strategy to register
+     * @returns This registry instance for method chaining
+     */
+    register(strategy: OutputFormatStrategy): this;
+    /**
+     * Get an output format strategy by code
+     *
+     * Performs case-insensitive lookup.
+     *
+     * @param code - The format code to look up
+     * @returns The output format strategy, or undefined if not found
+     */
+    get(code: string): OutputFormatStrategy | undefined;
+    /**
+     * Get an output format strategy by code, throwing if not found
+     *
+     * Performs case-insensitive lookup and throws a descriptive error
+     * if the requested format is not registered.
+     *
+     * @param code - The format code to look up
+     * @returns The output format strategy
+     * @throws Error if the format code is not registered
+     */
+    getOrThrow(code: string): OutputFormatStrategy;
+    /**
+     * Get all registered output format strategies
+     *
+     * @returns Array of all registered strategies (copy, not the internal collection)
+     */
+    getAll(): OutputFormatStrategy[];
+    /**
+     * Check if a format code is supported
+     *
+     * Performs case-insensitive check.
+     *
+     * @param code - The format code to check
+     * @returns True if the format is registered
+     */
+    isSupported(code: string): boolean;
+    /**
+     * Get all available format codes
+     *
+     * @returns Array of all registered format codes (lowercase)
+     */
+    getAvailableCodes(): OutputFormatCode[];
+    /**
+     * Get the default output format strategy (AsciiDoc)
+     *
+     * @returns The default (AsciiDoc) format strategy, or undefined if not registered
+     */
+    getDefault(): OutputFormatStrategy | undefined;
+    /**
+     * Get the number of registered strategies
+     */
+    get size(): number;
+    /**
+     * Remove all registered strategies
+     *
+     * @returns This registry instance for method chaining
+     */
+    clear(): this;
+}
+//# sourceMappingURL=output-format-registry.d.ts.map

package/dist/templates/formats/output-format-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format-registry.d.ts","sourceRoot":"","sources":["../../../src/templates/formats/output-format-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG1F;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,oBAAoB;IAC/B;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;;IAM/D;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAIrB;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAM9C;;;;;;;OAOG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAKnD;;;;;;;;;OASG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB;IAY9C;;;;OAIG;IACH,MAAM,IAAI,oBAAoB,EAAE;IAIhC;;;;;;;OAOG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAKlC;;;;OAIG;IACH,iBAAiB,IAAI,gBAAgB,EAAE;IAIvC;;;;OAIG;IACH,UAAU,IAAI,oBAAoB,GAAG,SAAS;IAI9C;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/templates/formats/output-format-registry.js

@@ -0,0 +1,147 @@
+/**
+ * Output Format Registry
+ *
+ * Registry for storing and retrieving output format strategies.
+ * Uses Map for O(1) lookup by normalized format code.
+ *
+ * @module templates/formats/output-format-registry
+ *
+ * S.O.L.I.D Principles:
+ * - SRP (Single Responsibility Principle): Only manages registration and lookup,
+ *   not creation or content generation
+ *
+ * Design Patterns:
+ * - Registry Pattern: Single source of truth for format strategies
+ */
+import { DEFAULT_OUTPUT_FORMAT } from './output-format-strategy.js';
+/**
+ * Output Format Registry Class
+ *
+ * Manages the collection of output format strategies, providing registration,
+ * lookup, and enumeration capabilities with case-insensitive code handling.
+ *
+ * @example
+ * ```typescript
+ * const registry = new OutputFormatRegistry();
+ * registry.register(markdownStrategy);
+ * registry.register(asciidocStrategy);
+ *
+ * const strategy = registry.get('asciidoc'); // Case-insensitive
+ * const allCodes = registry.getAvailableCodes(); // ['markdown', 'asciidoc']
+ * ```
+ */
+export class OutputFormatRegistry {
+    /**
+     * Internal map storing strategies by normalized (lowercase) format code
+     */
+    strategies;
+    constructor() {
+        this.strategies = new Map();
+    }
+    /**
+     * Normalize a format code for consistent storage and lookup
+     *
+     * @param code - The format code to normalize
+     * @returns Lowercase, trimmed format code
+     */
+    normalizeCode(code) {
+        return code.trim().toLowerCase();
+    }
+    /**
+     * Register an output format strategy
+     *
+     * Stores the strategy using its code (normalized to lowercase).
+     * If a strategy with the same code already exists, it will be overwritten.
+     *
+     * @param strategy - The output format strategy to register
+     * @returns This registry instance for method chaining
+     */
+    register(strategy) {
+        const normalizedCode = this.normalizeCode(strategy.code);
+        this.strategies.set(normalizedCode, strategy);
+        return this;
+    }
+    /**
+     * Get an output format strategy by code
+     *
+     * Performs case-insensitive lookup.
+     *
+     * @param code - The format code to look up
+     * @returns The output format strategy, or undefined if not found
+     */
+    get(code) {
+        const normalizedCode = this.normalizeCode(code);
+        return this.strategies.get(normalizedCode);
+    }
+    /**
+     * Get an output format strategy by code, throwing if not found
+     *
+     * Performs case-insensitive lookup and throws a descriptive error
+     * if the requested format is not registered.
+     *
+     * @param code - The format code to look up
+     * @returns The output format strategy
+     * @throws Error if the format code is not registered
+     */
+    getOrThrow(code) {
+        const strategy = this.get(code);
+        if (!strategy) {
+            const availableCodes = this.getAvailableCodes().join(', ');
+            throw new Error(`Output format "${code.trim().toLowerCase()}" is not registered. ` +
+                `Available formats: ${availableCodes || 'none'}`);
+        }
+        return strategy;
+    }
+    /**
+     * Get all registered output format strategies
+     *
+     * @returns Array of all registered strategies (copy, not the internal collection)
+     */
+    getAll() {
+        return Array.from(this.strategies.values());
+    }
+    /**
+     * Check if a format code is supported
+     *
+     * Performs case-insensitive check.
+     *
+     * @param code - The format code to check
+     * @returns True if the format is registered
+     */
+    isSupported(code) {
+        const normalizedCode = this.normalizeCode(code);
+        return this.strategies.has(normalizedCode);
+    }
+    /**
+     * Get all available format codes
+     *
+     * @returns Array of all registered format codes (lowercase)
+     */
+    getAvailableCodes() {
+        return Array.from(this.strategies.keys());
+    }
+    /**
+     * Get the default output format strategy (AsciiDoc)
+     *
+     * @returns The default (AsciiDoc) format strategy, or undefined if not registered
+     */
+    getDefault() {
+        return this.get(DEFAULT_OUTPUT_FORMAT);
+    }
+    /**
+     * Get the number of registered strategies
+     */
+    get size() {
+        return this.strategies.size;
+    }
+    /**
+     * Remove all registered strategies
+     *
+     * @returns This registry instance for method chaining
+     */
+    clear() {
+        this.strategies.clear();
+        return this;
+    }
+}
+//# sourceMappingURL=output-format-registry.js.map

package/dist/templates/formats/output-format-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format-registry.js","sourceRoot":"","sources":["../../../src/templates/formats/output-format-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,oBAAoB;IAC/B;;OAEG;IACc,UAAU,CAAoC;IAE/D;QACE,IAAI,CAAC,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACK,aAAa,CAAC,IAAY;QAChC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnC,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAA8B;QACrC,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACH,GAAG,CAAC,IAAY;QACd,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;;;OASG;IACH,UAAU,CAAC,IAAY;QACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3D,MAAM,IAAI,KAAK,CACb,kBAAkB,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,uBAAuB;gBAClE,sBAAsB,cAAc,IAAI,MAAM,EAAE,CACjD,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;OAOG;IACH,WAAW,CAAC,IAAY;QACtB,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACH,iBAAiB;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAuB,CAAC;IAClE,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/templates/formats/output-format-strategy.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Output Format Strategy
+ *
+ * Defines the interface for output format strategies that handle
+ * format-specific syntax generation (Markdown, AsciiDoc, etc.).
+ *
+ * @module templates/formats/output-format-strategy
+ *
+ * S.O.L.I.D Principles:
+ * - SRP (Single Responsibility Principle): Each strategy only handles
+ *   format-specific syntax generation
+ * - ISP (Interface Segregation Principle): Focused interface with only
+ *   necessary methods for format conversion
+ *
+ * Design Patterns:
+ * - Strategy Pattern: Interchangeable format implementations
+ */
+/**
+ * Supported output format codes
+ */
+export type OutputFormatCode = 'markdown' | 'asciidoc';
+/**
+ * Array of all supported output format codes
+ */
+export declare const SUPPORTED_OUTPUT_FORMAT_CODES: readonly OutputFormatCode[];
+/**
+ * Alias mappings for format code normalization
+ *
+ * Maps common format aliases to their canonical format codes.
+ * Used by OutputFormatFactory for flexible format specification.
+ */
+export declare const OUTPUT_FORMAT_ALIASES: Record<string, OutputFormatCode>;
+/**
+ * Default output format when not specified
+ *
+ * AsciiDoc is the default format for new projects.
+ */
+export declare const DEFAULT_OUTPUT_FORMAT: OutputFormatCode;
+/**
+ * Output Format Strategy Interface
+ *
+ * Defines the contract for all output format implementations.
+ * Each format strategy converts content to its specific syntax.
+ *
+ * @example
+ * ```typescript
+ * class MarkdownFormatStrategy implements OutputFormatStrategy {
+ *   code = 'markdown' as const;
+ *   name = 'Markdown';
+ *   fileExtension = '.md';
+ *
+ *   formatHeading(text: string, level: number): string {
+ *     return '#'.repeat(level) + ' ' + text;
+ *   }
+ *   // ... other methods
+ * }
+ * ```
+ */
+export interface OutputFormatStrategy {
+    /**
+     * Unique format code identifier
+     */
+    readonly code: OutputFormatCode;
+    /**
+     * Human-readable format name
+     */
+    readonly name: string;
+    /**
+     * File extension for this format (including dot)
+     */
+    readonly fileExtension: string;
+    /**
+     * Format a heading at the specified level
+     *
+     * @param text - The heading text
+     * @param level - Heading level (1-6)
+     * @returns Formatted heading string
+     */
+    formatHeading(text: string, level: number): string;
+    /**
+     * Format text as bold
+     *
+     * @param text - The text to make bold
+     * @returns Bold formatted text
+     */
+    formatBold(text: string): string;
+    /**
+     * Format text as italic
+     *
+     * @param text - The text to make italic
+     * @returns Italic formatted text
+     */
+    formatItalic(text: string): string;
+    /**
+     * Format a code block with optional language
+     *
+     * @param code - The code content
+     * @param language - Optional language identifier for syntax highlighting
+     * @returns Formatted code block
+     */
+    formatCode(code: string, language?: string): string;
+    /**
+     * Format inline code
+     *
+     * @param text - The code text
+     * @returns Inline code formatted text
+     */
+    formatInlineCode(text: string): string;
+    /**
+     * Format an unordered (bulleted) list
+     *
+     * @param items - Array of list items
+     * @returns Formatted unordered list
+     */
+    formatUnorderedList(items: string[]): string;
+    /**
+     * Format an ordered (numbered) list
+     *
+     * @param items - Array of list items
+     * @returns Formatted ordered list
+     */
+    formatOrderedList(items: string[]): string;
+    /**
+     * Format a hyperlink
+     *
+     * @param text - Link display text
+     * @param url - Link URL
+     * @returns Formatted link
+     */
+    formatLink(text: string, url: string): string;
+    /**
+     * Format an image
+     *
+     * @param alt - Alternative text for the image
+     * @param url - Image URL or path
+     * @returns Formatted image reference
+     */
+    formatImage(alt: string, url: string): string;
+    /**
+     * Format a table
+     *
+     * @param headers - Array of column headers
+     * @param rows - 2D array of row data
+     * @returns Formatted table
+     */
+    formatTable(headers: string[], rows: string[][]): string;
+    /**
+     * Format a blockquote
+     *
+     * @param text - The quote text (may contain newlines)
+     * @returns Formatted blockquote
+     */
+    formatBlockquote(text: string): string;
+    /**
+     * Format a horizontal rule/divider
+     *
+     * @returns Formatted horizontal rule
+     */
+    formatHorizontalRule(): string;
+    /**
+     * Format an anchor/bookmark
+     *
+     * @param id - The anchor identifier
+     * @returns Formatted anchor (maybe empty for formats that auto-generate anchors)
+     */
+    formatAnchor(id: string): string;
+    /**
+     * Get the README filename for this format
+     *
+     * @returns README filename (e.g., 'README.md', 'README.adoc')
+     */
+    getReadmeFilename(): string;
+    /**
+     * Get the section filename for a given section
+     *
+     * @param section - The section identifier
+     * @returns Section filename with appropriate extension
+     */
+    getSectionFilename(section: string): string;
+}
+/**
+ * Type guard to check if a string is a valid OutputFormatCode
+ *
+ * @param code - The code to check
+ * @returns True if the code is a valid OutputFormatCode
+ */
+export declare function isOutputFormatCode(code: string): code is OutputFormatCode;
+/**
+ * Normalize a format code string to its canonical form
+ *
+ * @param code - The format code to normalize (case-insensitive)
+ * @returns The normalized format code, or undefined if not recognized
+ */
+export declare function normalizeOutputFormatCode(code: string): OutputFormatCode | undefined;
+//# sourceMappingURL=output-format-strategy.d.ts.map

package/dist/templates/formats/output-format-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format-strategy.d.ts","sourceRoot":"","sources":["../../../src/templates/formats/output-format-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,UAAU,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,6BAA6B,EAAE,SAAS,gBAAgB,EAG3D,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAalE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,gBAA6B,CAAC;AAElE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAM/B;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAEnD;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAEjC;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAEnC;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEpD;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAMvC;;;;;OAKG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAE7C;;;;;OAKG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAM3C;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAE9C;;;;;;OAMG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAM9C;;;;;;OAMG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC;IAEzD;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAEvC;;;;OAIG;IACH,oBAAoB,IAAI,MAAM,CAAC;IAE/B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAMjC;;;;OAIG;IACH,iBAAiB,IAAI,MAAM,CAAC;IAE5B;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7C;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,gBAAgB,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAGpF"}

package/dist/templates/formats/output-format-strategy.js

@@ -0,0 +1,69 @@
+/**
+ * Output Format Strategy
+ *
+ * Defines the interface for output format strategies that handle
+ * format-specific syntax generation (Markdown, AsciiDoc, etc.).
+ *
+ * @module templates/formats/output-format-strategy
+ *
+ * S.O.L.I.D Principles:
+ * - SRP (Single Responsibility Principle): Each strategy only handles
+ *   format-specific syntax generation
+ * - ISP (Interface Segregation Principle): Focused interface with only
+ *   necessary methods for format conversion
+ *
+ * Design Patterns:
+ * - Strategy Pattern: Interchangeable format implementations
+ */
+/**
+ * Array of all supported output format codes
+ */
+export const SUPPORTED_OUTPUT_FORMAT_CODES = [
+    'markdown',
+    'asciidoc'
+];
+/**
+ * Alias mappings for format code normalization
+ *
+ * Maps common format aliases to their canonical format codes.
+ * Used by OutputFormatFactory for flexible format specification.
+ */
+export const OUTPUT_FORMAT_ALIASES = {
+    // Markdown aliases
+    'md': 'markdown',
+    'markdown': 'markdown',
+    'mdown': 'markdown',
+    'mkd': 'markdown',
+    // AsciiDoc aliases
+    'adoc': 'asciidoc',
+    'asciidoc': 'asciidoc',
+    'ascii': 'asciidoc',
+    'asciidoctor': 'asciidoc',
+    'asc': 'asciidoc'
+};
+/**
+ * Default output format when not specified
+ *
+ * AsciiDoc is the default format for new projects.
+ */
+export const DEFAULT_OUTPUT_FORMAT = 'asciidoc';
+/**
+ * Type guard to check if a string is a valid OutputFormatCode
+ *
+ * @param code - The code to check
+ * @returns True if the code is a valid OutputFormatCode
+ */
+export function isOutputFormatCode(code) {
+    return SUPPORTED_OUTPUT_FORMAT_CODES.includes(code);
+}
+/**
+ * Normalize a format code string to its canonical form
+ *
+ * @param code - The format code to normalize (case-insensitive)
+ * @returns The normalized format code, or undefined if not recognized
+ */
+export function normalizeOutputFormatCode(code) {
+    const normalized = code.trim().toLowerCase();
+    return OUTPUT_FORMAT_ALIASES[normalized];
+}
+//# sourceMappingURL=output-format-strategy.js.map

package/dist/templates/formats/output-format-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format-strategy.js","sourceRoot":"","sources":["../../../src/templates/formats/output-format-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAgC;IACxE,UAAU;IACV,UAAU;CACF,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAqC;IACrE,mBAAmB;IACnB,IAAI,EAAE,UAAU;IAChB,UAAU,EAAE,UAAU;IACtB,OAAO,EAAE,UAAU;IACnB,KAAK,EAAE,UAAU;IAEjB,mBAAmB;IACnB,MAAM,EAAE,UAAU;IAClB,UAAU,EAAE,UAAU;IACtB,OAAO,EAAE,UAAU;IACnB,aAAa,EAAE,UAAU;IACzB,KAAK,EAAE,UAAU;CAClB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAqB,UAAU,CAAC;AAsLlE;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,6BAA6B,CAAC,QAAQ,CAAC,IAAwB,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7C,OAAO,qBAAqB,CAAC,UAAU,CAAC,CAAC;AAC3C,CAAC"}

package/dist/templates/index.d.ts

@@ -8,19 +8,19 @@
  * @module templates
  */
 import { Arc42Section } from '../types.js';
+import type { OutputFormatCode } from './formats/index.js';
 export { ARC42_REFERENCE, Arc42Reference, getArc42ReferenceString, getArc42ReferenceMarkdown, getArc42ReferenceConfig, reloadArc42Reference } from './arc42-reference.js';
 export { type LanguageCode, type SectionTitle, type SectionDescription, type LanguageInfo, type LanguageStrategy, type LocalizedSectionMetadata, SUPPORTED_LANGUAGE_CODES, isLanguageCode, normalizeLanguageCode, getDefaultLanguageCode, isInitialized, LanguageRegistry, LanguageFactory, LocalizedTemplateProvider, languageRegistry, languageFactory, templateProvider, englishStrategy } from './locales/index.js';
+export { type OutputFormatStrategy, type OutputFormatCode, SUPPORTED_OUTPUT_FORMAT_CODES, OUTPUT_FORMAT_ALIASES, DEFAULT_OUTPUT_FORMAT, isOutputFormatCode, normalizeOutputFormatCode, isOutputFormatSupported, getSupportedOutputFormatCodes, detectOutputFormatFromExtension, detectOutputFormatFromFilename, OutputFormatRegistry, OutputFormatFactory, MarkdownFormatStrategy, AsciiDocFormatStrategy, outputFormatRegistry, outputFormatFactory, markdownFormatStrategy, asciidocFormatStrategy, getOutputFormatStrategy, getOutputFormatStrategyWithFallback, getDefaultOutputFormatStrategy } from './formats/index.js';
 /**
- * Get template for a specific arc42 section
- *
- * This function maintains backward compatibility with the original API
- * while delegating to the new locales system.
+ * Get template for a specific arc42 section in a specific format
  *
  * @param section - The arc42 section to get the template for
  * @param language - Optional language code (defaults to English)
- * @returns The template content
+ * @param format - Optional output format (defaults to AsciiDoc)
+ * @returns The template content in the specified format
  */
-export declare function getSectionTemplate(section: Arc42Section, language?: string): string;
+export declare function getTemplateForFormat(section: Arc42Section, language?: string, format?: OutputFormatCode): string;
 /**
  * Get localized section metadata
  *
@@ -30,12 +30,13 @@ export declare function getSectionTemplate(section: Arc42Section, language?: str
  */
 export declare function getSectionMetadata(section: Arc42Section, language?: string): import("./locales/template-provider.js").LocalizedSectionMetadata;
 /**
- * Get the workflow guide
+ * Get the workflow guide in a specific format
  *
  * @param language - Optional language code (defaults to English)
+ * @param format - Optional output format (defaults to AsciiDoc)
  * @returns The workflow guide content
  */
-export declare function getWorkflowGuide(language?: string): string;
+export declare function getWorkflowGuideForFormat(language?: string, format?: OutputFormatCode): string;
 /**
  * Get available languages
  *

package/dist/templates/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,OAAO,EACL,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAG7B,wBAAwB,EAGxB,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EAGb,gBAAgB,EAChB,eAAe,EACf,yBAAyB,EAGzB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAGhB,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,qEAE1E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,4DAEpC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE7D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,OAAO,EACL,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAG7B,wBAAwB,EAGxB,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EAGb,gBAAgB,EAChB,eAAe,EACf,yBAAyB,EAGzB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAGhB,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EAGrB,6BAA6B,EAC7B,qBAAqB,EACrB,qBAAqB,EAGrB,kBAAkB,EAClB,yBAAyB,EACzB,uBAAuB,EACvB,6BAA6B,EAC7B,+BAA+B,EAC/B,8BAA8B,EAG9B,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EAGtB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EAGtB,uBAAuB,EACvB,mCAAmC,EACnC,8BAA8B,EAC/B,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,YAAY,EACrB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,gBAAgB,GACxB,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,qEAE1E;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAE9F;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,4DAEpC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE7D"}

package/dist/templates/index.js

@@ -22,18 +22,28 @@ LanguageRegistry, LanguageFactory, LocalizedTemplateProvider,
 languageRegistry, languageFactory, templateProvider, 
 // English strategy
 englishStrategy } from './locales/index.js';
+// Re-export formats module for multi-format support
+export { 
+// Constants
+SUPPORTED_OUTPUT_FORMAT_CODES, OUTPUT_FORMAT_ALIASES, DEFAULT_OUTPUT_FORMAT, 
+// Utility functions
+isOutputFormatCode, normalizeOutputFormatCode, isOutputFormatSupported, getSupportedOutputFormatCodes, detectOutputFormatFromExtension, detectOutputFormatFromFilename, 
+// Classes
+OutputFormatRegistry, OutputFormatFactory, MarkdownFormatStrategy, AsciiDocFormatStrategy, 
+// Singleton instances
+outputFormatRegistry, outputFormatFactory, markdownFormatStrategy, asciidocFormatStrategy, 
+// Convenience functions
+getOutputFormatStrategy, getOutputFormatStrategyWithFallback, getDefaultOutputFormatStrategy } from './formats/index.js';
 /**
- * Get template for a specific arc42 section
- *
- * This function maintains backward compatibility with the original API
- * while delegating to the new locales system.
+ * Get template for a specific arc42 section in a specific format
  *
  * @param section - The arc42 section to get the template for
  * @param language - Optional language code (defaults to English)
- * @returns The template content
+ * @param format - Optional output format (defaults to AsciiDoc)
+ * @returns The template content in the specified format
  */
-export function getSectionTemplate(section, language) {
-    return templateProvider.getTemplate(section, language);
+export function getTemplateForFormat(section, language, format) {
+    return templateProvider.getTemplateForFormat(section, language, format);
 }
 /**
  * Get localized section metadata
@@ -46,13 +56,14 @@ export function getSectionMetadata(section, language) {
     return templateProvider.getSectionMetadata(section, language);
 }
 /**
- * Get the workflow guide
+ * Get the workflow guide in a specific format
  *
  * @param language - Optional language code (defaults to English)
+ * @param format - Optional output format (defaults to AsciiDoc)
  * @returns The workflow guide content
  */
-export function getWorkflowGuide(language) {
-    return templateProvider.getWorkflowGuide(language);
+export function getWorkflowGuideForFormat(language, format) {
+    return templateProvider.getWorkflowGuideForFormat(language, format);
 }
 /**
  * Get available languages

package/dist/templates/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,wCAAwC;AACxC,OAAO,EACL,eAAe,EAEf,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAE9B,sDAAsD;AACtD,OAAO;AASL,YAAY;AACZ,wBAAwB;AAExB,oBAAoB;AACpB,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,aAAa;AAEb,UAAU;AACV,gBAAgB,EAChB,eAAe,EACf,yBAAyB;AAEzB,sBAAsB;AACtB,gBAAgB,EAChB,eAAe,EACf,gBAAgB;AAEhB,mBAAmB;AACnB,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAqB,EAAE,QAAiB;IACzE,OAAO,gBAAgB,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAqB,EAAE,QAAiB;IACzE,OAAO,gBAAgB,CAAC,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAiB;IAChD,OAAO,gBAAgB,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,gBAAgB,CAAC,qBAAqB,EAAE,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO,gBAAgB,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;AAChD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,wCAAwC;AACxC,OAAO,EACL,eAAe,EAEf,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAE9B,sDAAsD;AACtD,OAAO;AASL,YAAY;AACZ,wBAAwB;AAExB,oBAAoB;AACpB,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,aAAa;AAEb,UAAU;AACV,gBAAgB,EAChB,eAAe,EACf,yBAAyB;AAEzB,sBAAsB;AACtB,gBAAgB,EAChB,eAAe,EACf,gBAAgB;AAEhB,mBAAmB;AACnB,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAE5B,oDAAoD;AACpD,OAAO;AAKL,YAAY;AACZ,6BAA6B,EAC7B,qBAAqB,EACrB,qBAAqB;AAErB,oBAAoB;AACpB,kBAAkB,EAClB,yBAAyB,EACzB,uBAAuB,EACvB,6BAA6B,EAC7B,+BAA+B,EAC/B,8BAA8B;AAE9B,UAAU;AACV,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB;AAEtB,sBAAsB;AACtB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB;AAEtB,wBAAwB;AACxB,uBAAuB,EACvB,mCAAmC,EACnC,8BAA8B,EAC/B,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAqB,EACrB,QAAiB,EACjB,MAAyB;IAEzB,OAAO,gBAAgB,CAAC,oBAAoB,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAqB,EAAE,QAAiB;IACzE,OAAO,gBAAgB,CAAC,kBAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAiB,EAAE,MAAyB;IACpF,OAAO,gBAAgB,CAAC,yBAAyB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AACtE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,gBAAgB,CAAC,qBAAqB,EAAE,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO,gBAAgB,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;AAChD,CAAC"}