shirokuma-docs 0.1.0-alpha.1

package/dist/md/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/md/types/config.ts"],"names":[],"mappings":"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"}

package/dist/md/types/config.js

@@ -0,0 +1,156 @@
+import { z } from 'zod';
+/**
+ * Configuration schema for shirokuma-md.config.yaml
+ */
+export const ConfigSchema = z.object({
+    project: z.object({
+        name: z.string(),
+        version: z.string(),
+        description: z.string().optional(),
+    }),
+    directories: z.object({
+        source: z.string().default('docs/'),
+        output: z.string().default('dist/'),
+        config: z.string().default('.shirokuma/'),
+        templates: z.string().optional(),
+        schemas: z.string().optional(),
+    }),
+    build: z.object({
+        default_output: z.string(),
+        include: z.array(z.string()),
+        exclude: z.array(z.string()),
+        frontmatter: z.object({
+            strip: z.boolean().default(true),
+            preserve_fields: z.array(z.string()).optional(),
+        }),
+        toc: z.object({
+            enabled: z.boolean().default(true),
+            depth: z.number().default(3),
+            title: z.string().default('Table of Contents'),
+        }),
+        file_separator: z.string().default('\n\n---\n\n'),
+        sort: z.enum(['path', 'custom']).default('path'),
+        strip_section_meta: z.boolean().default(true),
+        strip_heading_numbers: z.boolean().default(true),
+        optimizations: z.object({
+            // Existing optimizations
+            remove_internal_links: z.boolean().default(false),
+            normalize_whitespace: z.boolean().default(false),
+            // RAG enhancement: Hierarchical heading normalization
+            normalize_headings: z.boolean().default(false),
+            heading_separator: z.string().default(' / '),
+            // Token optimization: Content removal
+            remove_comments: z.boolean().default(false),
+            remove_badges: z.boolean().default(false),
+            remove_duplicates: z.boolean().default(false),
+            remove_blockquotes: z.boolean().default(false),
+        }).optional(),
+    }),
+    sort_order: z
+        .array(z.object({
+        pattern: z.string(),
+    }))
+        .optional(),
+    validation: z.object({
+        required_frontmatter: z.array(z.string()).default([]),
+        custom_types: z.record(z.union([z.string(), z.number(), z.boolean(), z.null(), z.array(z.string())])).optional(),
+        forbidden_patterns: z
+            .array(z.object({
+            pattern: z.string(),
+            message: z.string(),
+            apply_to: z.string().optional(),
+        }))
+            .optional(),
+        no_internal_links: z.boolean().default(true),
+        template_compliance: z
+            .object({
+            enabled: z.boolean().default(false),
+            check_required_sections: z.boolean().default(true),
+            check_variable_substitution: z.boolean().default(true),
+            severity: z.enum(['error', 'warning', 'info']).default('error'),
+        })
+            .optional(),
+    }),
+    lint: z.object({
+        builtin_rules: z.record(z.boolean()),
+        file_naming: z
+            .object({
+            pattern: z.string(),
+            message: z.string().optional(),
+        })
+            .optional(),
+        rules: z
+            .object({
+            consistent_structure: z
+                .object({
+                enabled: z.boolean().default(false),
+                overview_location: z.enum(['inside', 'outside']).default('inside'),
+                directory_threshold: z.number().default(4),
+                overview_naming: z.string().default('overview.md'),
+            })
+                .optional(),
+        })
+            .optional(),
+    }),
+    analyze: z
+        .object({
+        dependency_detection: z.array(z.object({
+            type: z.enum(['frontmatter', 'wiki-link', 'markdown-link']),
+            pattern: z.string().optional(),
+            enabled: z.boolean().default(true),
+        })),
+    })
+        .optional(),
+    plugins: z
+        .array(z.object({
+        module: z.string(),
+        validators: z.array(z.string()).optional(),
+        enabled: z.boolean().optional(),
+        config: z.record(z.unknown()).optional(),
+    }))
+        .optional(),
+    extraction: z
+        .object({
+        patterns: z.record(z.string(), z.record(z.string(), z.object({
+            pattern: z.string(),
+            group: z.number(),
+            type: z.enum(['string', 'integer', 'boolean', 'array']),
+            mapping: z.string().optional(),
+            output_field: z.string().optional(),
+            required: z.boolean().default(false),
+            split: z.string().optional(), // For array types
+        }))),
+        mappings: z.record(z.string(), z.record(z.string(), z.any())),
+        templates: z.record(z.string(), z.record(z.string(), z.any())),
+    })
+        .optional(),
+    list: z
+        .object({
+        default_format: z.enum(['simple', 'tree', 'detailed', 'markdown', 'json']).default('markdown'),
+        include_frontmatter: z.boolean().default(true),
+        include_dependencies: z.boolean().default(true),
+        include_stats: z.boolean().default(true),
+        group_by: z.enum(['layer', 'type', 'category', 'none']).default('layer'),
+        sort_by: z.enum(['path', 'layer', 'title']).default('path'),
+    })
+        .nullable()
+        .default({
+        default_format: 'markdown',
+        include_frontmatter: true,
+        include_dependencies: true,
+        include_stats: true,
+        group_by: 'layer',
+        sort_by: 'path',
+    })
+        .transform((val) => val ?? {
+        default_format: 'markdown',
+        include_frontmatter: true,
+        include_dependencies: true,
+        include_stats: true,
+        group_by: 'layer',
+        sort_by: 'path',
+    }),
+    layer_rules: z.record(z.string(), z.number()).optional(),
+    output_paths: z.record(z.string(), z.string()).optional(),
+});
+//# sourceMappingURL=config.js.map

package/dist/md/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/md/types/config.ts"],"names":[],"mappings":"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"}

package/dist/md/types/document.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Document frontmatter structure
+ */
+export interface DocumentFrontmatter {
+    version?: string;
+    layer?: string;
+    category?: string;
+    last_updated?: string;
+    dependencies?: string[];
+    tags?: string[];
+    schema?: string;
+    [key: string]: any;
+}
+/**
+ * Document structure
+ */
+export interface Document {
+    path: string;
+    frontmatter: DocumentFrontmatter;
+    content: string;
+    sections: Section[];
+}
+/**
+ * Section structure
+ */
+export interface Section {
+    level: number;
+    title: string;
+    content: string;
+    subsections: Section[];
+    meta?: Record<string, any>;
+}
+/**
+ * Section metadata (re-exported from parser)
+ */
+export type { SectionMeta, SectionMetaExtractionResult } from '../parser/section-meta.js';
+//# sourceMappingURL=document.d.ts.map

package/dist/md/types/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/md/types/document.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,mBAAmB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B;AAED;;GAEG;AACH,YAAY,EAAE,WAAW,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/md/types/document.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=document.js.map

package/dist/md/types/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../../src/md/types/document.ts"],"names":[],"mappings":""}

package/dist/md/types/validation.d.ts

@@ -0,0 +1,107 @@
+import type { Document } from './document.js';
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: Issue[];
+    warnings: Issue[];
+    info: Issue[];
+}
+/**
+ * Issue structure
+ */
+export interface Issue {
+    severity: 'error' | 'warning' | 'info';
+    message: string;
+    file: string;
+    line?: number;
+    column?: number;
+    rule: string;
+}
+/**
+ * Validator interface
+ */
+export interface Validator {
+    name: string;
+    validate(document: Document): Promise<Issue[]>;
+}
+/**
+ * Linter interface
+ */
+export interface Linter {
+    name: string;
+    lint(document: Document): Promise<Issue[]>;
+    fix?(document: Document): Promise<Document>;
+}
+/**
+ * Analyzer interface
+ */
+export interface Analyzer {
+    name: string;
+    analyze(documents: Document[]): Promise<AnalysisResult>;
+}
+/**
+ * Heading node in document structure
+ */
+export interface HeadingNode {
+    level: number;
+    text: string;
+    startLine: number;
+    endLine: number;
+    children: HeadingNode[];
+}
+/**
+ * File metrics
+ */
+export interface FileMetrics {
+    file: string;
+    size: number;
+    lines: number;
+    tokens: number;
+    headings: HeadingNode[];
+    topLevelSections: number;
+}
+/**
+ * Split suggestion for a file
+ */
+export interface SplitSuggestion {
+    file: string;
+    reason: string;
+    currentSize: number;
+    currentTokens: number;
+    suggestedSplits: Array<{
+        heading: string;
+        level: number;
+        startLine: number;
+        endLine: number;
+        estimatedLines: number;
+        estimatedTokens: number;
+    }>;
+}
+/**
+ * Analysis result
+ */
+export interface AnalysisResult {
+    totalFiles: number;
+    dependencies: DependencyEdge[];
+    orphans: string[];
+    cycles: string[][];
+    mostReferenced: Array<{
+        file: string;
+        count: number;
+    }>;
+    fileMetrics?: FileMetrics[];
+    splitSuggestions?: SplitSuggestion[];
+    totalTokens?: number;
+    averageTokensPerFile?: number;
+}
+/**
+ * Dependency edge
+ */
+export interface DependencyEdge {
+    from: string;
+    to: string;
+    type: 'frontmatter' | 'wiki-link' | 'markdown-link';
+}
+//# sourceMappingURL=validation.d.ts.map

package/dist/md/types/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/md/types/validation.ts"],"names":[],"mappings":"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"}

package/dist/md/types/validation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validation.js.map

package/dist/md/types/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/md/types/validation.ts"],"names":[],"mappings":""}

package/dist/md/utils/code-blocks.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Code block detection and handling utilities
+ * Extracted to eliminate duplicated logic across Linter, Parser, and Validator
+ */
+/**
+ * Represents a code block's position in content
+ */
+export interface CodeBlock {
+    /**
+     * Start line number (1-based)
+     */
+    startLine: number;
+    /**
+     * End line number (1-based)
+     */
+    endLine: number;
+    /**
+     * Language identifier (e.g., 'typescript', 'mermaid')
+     */
+    language?: string;
+    /**
+     * Code block content (excluding fences)
+     */
+    content: string;
+}
+/**
+ * Simple line-by-line code block tracker
+ * Use this for processing content line-by-line
+ *
+ * @example
+ * ```typescript
+ * const tracker = new CodeBlockTracker();
+ * for (const line of lines) {
+ *   tracker.processLine(line);
+ *   if (!tracker.isInCodeBlock()) {
+ *     // Process non-code-block content
+ *   }
+ * }
+ * ```
+ */
+export declare class CodeBlockTracker {
+    private inCodeBlock;
+    /**
+     * Process a line and update code block state
+     * @param line - Line to process
+     */
+    processLine(line: string): void;
+    /**
+     * Check if currently inside a code block
+     * @returns True if inside code block
+     */
+    isInCodeBlock(): boolean;
+    /**
+     * Reset tracker state
+     */
+    reset(): void;
+}
+/**
+ * Extract all code blocks from markdown content
+ * Returns detailed information about each code block
+ *
+ * @param content - Markdown content
+ * @returns Array of code blocks with positions and metadata
+ *
+ * @example
+ * ```typescript
+ * const blocks = extractCodeBlocks(content);
+ * for (const block of blocks) {
+ *   console.log(`Code block at lines ${block.startLine}-${block.endLine}`);
+ *   console.log(`Language: ${block.language || 'none'}`);
+ * }
+ * ```
+ */
+export declare function extractCodeBlocks(content: string): CodeBlock[];
+/**
+ * Check if a specific line number is inside a code block
+ *
+ * @param lineNumber - Line number to check (1-based)
+ * @param codeBlocks - Array of code blocks
+ * @returns True if line is inside a code block
+ *
+ * @example
+ * ```typescript
+ * const blocks = extractCodeBlocks(content);
+ * if (isLineInCodeBlock(42, blocks)) {
+ *   console.log('Line 42 is inside a code block');
+ * }
+ * ```
+ */
+export declare function isLineInCodeBlock(lineNumber: number, codeBlocks: CodeBlock[]): boolean;
+/**
+ * Extract code blocks and replace them with placeholders
+ * Useful for safe regex operations on markdown content
+ *
+ * @param content - Markdown content
+ * @returns Object with modified content and extracted blocks
+ *
+ * @example
+ * ```typescript
+ * const { content: safe, blocks } = extractAndReplace(markdown);
+ * // Perform regex operations on 'safe' content
+ * const modified = safe.replace(/pattern/g, 'replacement');
+ * // Restore code blocks
+ * const final = restoreCodeBlocks(modified, blocks);
+ * ```
+ */
+export declare function extractAndReplace(content: string): {
+    content: string;
+    blocks: string[];
+    placeholder: string;
+};
+/**
+ * Restore code blocks from placeholders
+ *
+ * @param content - Content with placeholders
+ * @param blocks - Array of original code blocks
+ * @param placeholder - Placeholder string used
+ * @returns Content with restored code blocks
+ */
+export declare function restoreCodeBlocks(content: string, blocks: string[], placeholder?: string): string;
+/**
+ * Process content with a transformation function, excluding code blocks
+ *
+ * @param content - Markdown content
+ * @param transform - Transformation function to apply
+ * @returns Transformed content with code blocks preserved
+ *
+ * @example
+ * ```typescript
+ * const result = processExcludingCodeBlocks(content, (text) => {
+ *   return text.replace(/pattern/g, 'replacement');
+ * });
+ * ```
+ */
+export declare function processExcludingCodeBlocks(content: string, transform: (content: string) => string): string;
+//# sourceMappingURL=code-blocks.d.ts.map

package/dist/md/utils/code-blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-blocks.d.ts","sourceRoot":"","sources":["../../../src/md/utils/code-blocks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,WAAW,CAAS;IAE5B;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM/B;;;OAGG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAuC9D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,SAAS,EAAE,GACtB,OAAO,CAIT;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,CAWA;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EAAE,EAChB,WAAW,GAAE,MAAuC,GACnD,MAAM,CASR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GACrC,MAAM,CAIR"}

package/dist/md/utils/code-blocks.js

@@ -0,0 +1,178 @@
+/**
+ * Code block detection and handling utilities
+ * Extracted to eliminate duplicated logic across Linter, Parser, and Validator
+ */
+/**
+ * Simple line-by-line code block tracker
+ * Use this for processing content line-by-line
+ *
+ * @example
+ * ```typescript
+ * const tracker = new CodeBlockTracker();
+ * for (const line of lines) {
+ *   tracker.processLine(line);
+ *   if (!tracker.isInCodeBlock()) {
+ *     // Process non-code-block content
+ *   }
+ * }
+ * ```
+ */
+export class CodeBlockTracker {
+    inCodeBlock = false;
+    /**
+     * Process a line and update code block state
+     * @param line - Line to process
+     */
+    processLine(line) {
+        if (line.trim().startsWith('```')) {
+            this.inCodeBlock = !this.inCodeBlock;
+        }
+    }
+    /**
+     * Check if currently inside a code block
+     * @returns True if inside code block
+     */
+    isInCodeBlock() {
+        return this.inCodeBlock;
+    }
+    /**
+     * Reset tracker state
+     */
+    reset() {
+        this.inCodeBlock = false;
+    }
+}
+/**
+ * Extract all code blocks from markdown content
+ * Returns detailed information about each code block
+ *
+ * @param content - Markdown content
+ * @returns Array of code blocks with positions and metadata
+ *
+ * @example
+ * ```typescript
+ * const blocks = extractCodeBlocks(content);
+ * for (const block of blocks) {
+ *   console.log(`Code block at lines ${block.startLine}-${block.endLine}`);
+ *   console.log(`Language: ${block.language || 'none'}`);
+ * }
+ * ```
+ */
+export function extractCodeBlocks(content) {
+    const lines = content.split('\n');
+    const blocks = [];
+    let inCodeBlock = false;
+    let currentBlock = null;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (!line && line !== '')
+            continue;
+        const lineNum = i + 1;
+        if (line.trim().startsWith('```')) {
+            if (!inCodeBlock) {
+                // Start of code block
+                const language = line.trim().substring(3).trim();
+                currentBlock = {
+                    startLine: lineNum,
+                    language: language || undefined,
+                    content: '',
+                };
+                inCodeBlock = true;
+            }
+            else {
+                // End of code block
+                if (currentBlock) {
+                    currentBlock.endLine = lineNum;
+                    blocks.push(currentBlock);
+                }
+                currentBlock = null;
+                inCodeBlock = false;
+            }
+        }
+        else if (inCodeBlock && currentBlock) {
+            // Accumulate code block content
+            currentBlock.content += (currentBlock.content ? '\n' : '') + line;
+        }
+    }
+    return blocks;
+}
+/**
+ * Check if a specific line number is inside a code block
+ *
+ * @param lineNumber - Line number to check (1-based)
+ * @param codeBlocks - Array of code blocks
+ * @returns True if line is inside a code block
+ *
+ * @example
+ * ```typescript
+ * const blocks = extractCodeBlocks(content);
+ * if (isLineInCodeBlock(42, blocks)) {
+ *   console.log('Line 42 is inside a code block');
+ * }
+ * ```
+ */
+export function isLineInCodeBlock(lineNumber, codeBlocks) {
+    return codeBlocks.some(block => lineNumber >= block.startLine && lineNumber <= block.endLine);
+}
+/**
+ * Extract code blocks and replace them with placeholders
+ * Useful for safe regex operations on markdown content
+ *
+ * @param content - Markdown content
+ * @returns Object with modified content and extracted blocks
+ *
+ * @example
+ * ```typescript
+ * const { content: safe, blocks } = extractAndReplace(markdown);
+ * // Perform regex operations on 'safe' content
+ * const modified = safe.replace(/pattern/g, 'replacement');
+ * // Restore code blocks
+ * const final = restoreCodeBlocks(modified, blocks);
+ * ```
+ */
+export function extractAndReplace(content) {
+    const blocks = [];
+    const placeholder = '___CODE_BLOCK_PLACEHOLDER___';
+    const regex = /```[\s\S]*?```/g;
+    const modified = content.replace(regex, (match) => {
+        blocks.push(match);
+        return `${placeholder}${blocks.length - 1}${placeholder}`;
+    });
+    return { content: modified, blocks, placeholder };
+}
+/**
+ * Restore code blocks from placeholders
+ *
+ * @param content - Content with placeholders
+ * @param blocks - Array of original code blocks
+ * @param placeholder - Placeholder string used
+ * @returns Content with restored code blocks
+ */
+export function restoreCodeBlocks(content, blocks, placeholder = '___CODE_BLOCK_PLACEHOLDER___') {
+    let restored = content;
+    blocks.forEach((block, index) => {
+        const placeholderPattern = `${placeholder}${index}${placeholder}`;
+        restored = restored.replace(placeholderPattern, block);
+    });
+    return restored;
+}
+/**
+ * Process content with a transformation function, excluding code blocks
+ *
+ * @param content - Markdown content
+ * @param transform - Transformation function to apply
+ * @returns Transformed content with code blocks preserved
+ *
+ * @example
+ * ```typescript
+ * const result = processExcludingCodeBlocks(content, (text) => {
+ *   return text.replace(/pattern/g, 'replacement');
+ * });
+ * ```
+ */
+export function processExcludingCodeBlocks(content, transform) {
+    const { content: safe, blocks, placeholder } = extractAndReplace(content);
+    const transformed = transform(safe);
+    return restoreCodeBlocks(transformed, blocks, placeholder);
+}
+//# sourceMappingURL=code-blocks.js.map

package/dist/md/utils/code-blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-blocks.js","sourceRoot":"","sources":["../../../src/md/utils/code-blocks.ts"],"names":[],"mappings":"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"}