shirokuma-docs 0.1.0-alpha.1

package/dist/md/utils/config.d.ts

@@ -0,0 +1,10 @@
+import { type Config } from '../types/config.js';
+/**
+ * Load configuration from file
+ */
+export declare function loadConfig(configPath?: string): Promise<Config>;
+/**
+ * Get default configuration
+ */
+export declare function getDefaultConfig(): Partial<Config>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/md/utils/config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;GAEG;AACH,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA2DrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAgClD"}

package/dist/md/utils/config.js

@@ -0,0 +1,99 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import YAML from 'yaml';
+import { ConfigSchema } from '../types/config.js';
+/**
+ * Load configuration from file
+ */
+export async function loadConfig(configPath) {
+    let resolvedPath;
+    if (configPath) {
+        // Use provided path
+        resolvedPath = path.resolve(configPath);
+    }
+    else {
+        // Search for default config files
+        const defaultPaths = [
+            'shirokuma-md.config.yaml',
+            'shirokuma-md.config.json',
+            '.shirokuma-md.yaml',
+            '.shirokuma-md.json',
+        ];
+        let found = false;
+        for (const defaultPath of defaultPaths) {
+            const fullPath = path.resolve(defaultPath);
+            try {
+                await fs.access(fullPath);
+                resolvedPath = fullPath;
+                found = true;
+                break;
+            }
+            catch {
+                // File doesn't exist, continue searching
+            }
+        }
+        if (!found) {
+            throw new Error('No configuration file found. Please create shirokuma-md.config.yaml or specify path with --config');
+        }
+        resolvedPath = resolvedPath;
+    }
+    // Read file
+    const content = await fs.readFile(resolvedPath, 'utf-8');
+    // Parse based on extension
+    let rawConfig;
+    const ext = path.extname(resolvedPath);
+    if (ext === '.yaml' || ext === '.yml') {
+        rawConfig = YAML.parse(content);
+    }
+    else if (ext === '.json') {
+        rawConfig = JSON.parse(content);
+    }
+    else {
+        throw new Error(`Unsupported config file format: ${ext}`);
+    }
+    // Validate with Zod schema
+    try {
+        const config = ConfigSchema.parse(rawConfig);
+        return config;
+    }
+    catch (error) {
+        throw new Error(`Configuration validation failed:\n${error.message}`);
+    }
+}
+/**
+ * Get default configuration
+ */
+export function getDefaultConfig() {
+    return {
+        directories: {
+            source: 'docs/',
+            output: 'dist/',
+            config: '.shirokuma/',
+        },
+        build: {
+            default_output: 'output.md',
+            include: ['**/*.md'],
+            exclude: ['node_modules/**', '**/dist/**'],
+            frontmatter: {
+                strip: true,
+            },
+            toc: {
+                enabled: true,
+                depth: 3,
+                title: 'Table of Contents',
+            },
+            file_separator: '\n\n---\n\n',
+            sort: 'path',
+            strip_section_meta: true,
+            strip_heading_numbers: false,
+        },
+        validation: {
+            required_frontmatter: [],
+            no_internal_links: true,
+        },
+        lint: {
+            builtin_rules: {},
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

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

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

package/dist/md/utils/file-collector.d.ts

@@ -0,0 +1,78 @@
+import type { Config } from '../types/config.js';
+/**
+ * Options for file collection
+ */
+export interface FileCollectionOptions {
+    /**
+     * Override include patterns from config
+     */
+    includePatterns?: string[];
+    /**
+     * Override exclude patterns from config
+     */
+    excludePatterns?: string[];
+    /**
+     * Additional glob options
+     */
+    globOptions?: {
+        nodir?: boolean;
+        dot?: boolean;
+        absolute?: boolean;
+    };
+}
+/**
+ * Utility for collecting markdown files based on configuration
+ *
+ * Eliminates duplicated file collection logic across Builder, Validator, and Linter.
+ *
+ * @example
+ * ```typescript
+ * const collector = new FileCollector(config);
+ * const files = await collector.collect(sourceDir);
+ * ```
+ */
+export declare class FileCollector {
+    private config;
+    constructor(config: Config);
+    /**
+     * Collect all markdown files matching configuration patterns
+     *
+     * @param sourceDir - Base directory to search in
+     * @param options - Override options
+     * @returns Array of absolute file paths
+     */
+    collect(sourceDir: string, options?: FileCollectionOptions): Promise<string[]>;
+    /**
+     * Collect files with custom filter function
+     *
+     * @param sourceDir - Base directory
+     * @param filterFn - Custom filter function
+     * @param options - Collection options
+     * @returns Filtered file paths
+     */
+    collectFiltered(sourceDir: string, filterFn: (filePath: string) => boolean | Promise<boolean>, options?: FileCollectionOptions): Promise<string[]>;
+    /**
+     * Get relative paths from source directory
+     *
+     * @param sourceDir - Base directory
+     * @param options - Collection options
+     * @returns Array of relative file paths
+     */
+    collectRelative(sourceDir: string, options?: FileCollectionOptions): Promise<string[]>;
+    /**
+     * Count total files matching patterns
+     *
+     * @param sourceDir - Base directory
+     * @param options - Collection options
+     * @returns Number of files
+     */
+    count(sourceDir: string, options?: FileCollectionOptions): Promise<number>;
+}
+/**
+ * Helper function to create FileCollector instance
+ *
+ * @param config - Configuration object
+ * @returns FileCollector instance
+ */
+export declare function createFileCollector(config: Config): FileCollector;
+//# sourceMappingURL=file-collector.d.ts.map

package/dist/md/utils/file-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-collector.d.ts","sourceRoot":"","sources":["../../../src/md/utils/file-collector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B;;OAEG;IACH,WAAW,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;CACH;AAED;;;;;;;;;;GAUG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAElC;;;;;;OAMG;IACG,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,MAAM,EAAE,CAAC;IA+BpB;;;;;;;OAOG;IACG,eAAe,CACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAC1D,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,MAAM,EAAE,CAAC;IAcpB;;;;;;OAMG;IACG,eAAe,CACnB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,MAAM,EAAE,CAAC;IAKpB;;;;;;OAMG;IACG,KAAK,CACT,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,MAAM,CAAC;CAInB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAEjE"}

package/dist/md/utils/file-collector.js

@@ -0,0 +1,100 @@
+import { glob } from 'glob';
+import * as path from 'path';
+/**
+ * Utility for collecting markdown files based on configuration
+ *
+ * Eliminates duplicated file collection logic across Builder, Validator, and Linter.
+ *
+ * @example
+ * ```typescript
+ * const collector = new FileCollector(config);
+ * const files = await collector.collect(sourceDir);
+ * ```
+ */
+export class FileCollector {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Collect all markdown files matching configuration patterns
+     *
+     * @param sourceDir - Base directory to search in
+     * @param options - Override options
+     * @returns Array of absolute file paths
+     */
+    async collect(sourceDir, options = {}) {
+        const includePatterns = options.includePatterns || this.config.build.include;
+        const excludePatterns = options.excludePatterns || this.config.build.exclude;
+        const patterns = includePatterns.map((p) => path.join(sourceDir, p));
+        const exclude = excludePatterns.map((p) => path.join(sourceDir, p));
+        const allFiles = [];
+        const seen = new Set();
+        for (const pattern of patterns) {
+            const matches = await glob(pattern, {
+                ignore: exclude,
+                nodir: true,
+                ...options.globOptions,
+            });
+            // Deduplicate files
+            for (const file of matches) {
+                if (!seen.has(file)) {
+                    seen.add(file);
+                    allFiles.push(file);
+                }
+            }
+        }
+        return allFiles;
+    }
+    /**
+     * Collect files with custom filter function
+     *
+     * @param sourceDir - Base directory
+     * @param filterFn - Custom filter function
+     * @param options - Collection options
+     * @returns Filtered file paths
+     */
+    async collectFiltered(sourceDir, filterFn, options = {}) {
+        const allFiles = await this.collect(sourceDir, options);
+        const filtered = [];
+        for (const file of allFiles) {
+            const shouldInclude = await filterFn(file);
+            if (shouldInclude) {
+                filtered.push(file);
+            }
+        }
+        return filtered;
+    }
+    /**
+     * Get relative paths from source directory
+     *
+     * @param sourceDir - Base directory
+     * @param options - Collection options
+     * @returns Array of relative file paths
+     */
+    async collectRelative(sourceDir, options = {}) {
+        const absolutePaths = await this.collect(sourceDir, options);
+        return absolutePaths.map((file) => path.relative(sourceDir, file));
+    }
+    /**
+     * Count total files matching patterns
+     *
+     * @param sourceDir - Base directory
+     * @param options - Collection options
+     * @returns Number of files
+     */
+    async count(sourceDir, options = {}) {
+        const files = await this.collect(sourceDir, options);
+        return files.length;
+    }
+}
+/**
+ * Helper function to create FileCollector instance
+ *
+ * @param config - Configuration object
+ * @returns FileCollector instance
+ */
+export function createFileCollector(config) {
+    return new FileCollector(config);
+}
+//# sourceMappingURL=file-collector.js.map

package/dist/md/utils/file-collector.js.map

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

package/dist/md/utils/markdown.d.ts

@@ -0,0 +1,18 @@
+import type { HeadingNode } from '../types/validation.js';
+/**
+ * Parse markdown content and extract heading structure
+ */
+export declare function parseHeadings(content: string): HeadingNode[];
+/**
+ * Count total number of headings
+ */
+export declare function countHeadings(headings: HeadingNode[]): number;
+/**
+ * Get all headings as flat list
+ */
+export declare function flattenHeadings(headings: HeadingNode[]): HeadingNode[];
+/**
+ * Count lines in content
+ */
+export declare function countLines(content: string): number;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/md/utils/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../src/md/utils/markdown.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAkD5D;AAuBD;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAM7D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAOtE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/md/utils/markdown.js

@@ -0,0 +1,93 @@
+import MarkdownIt from 'markdown-it';
+/**
+ * Parse markdown content and extract heading structure
+ */
+export function parseHeadings(content) {
+    const md = new MarkdownIt();
+    const tokens = md.parse(content, {});
+    const headings = [];
+    const stack = [];
+    let currentLine = 1;
+    for (let i = 0; i < tokens.length; i++) {
+        const token = tokens[i];
+        if (token.type === 'heading_open') {
+            const level = parseInt(token.tag.substring(1)); // h1 -> 1, h2 -> 2, etc.
+            const contentToken = tokens[i + 1];
+            const text = contentToken && contentToken.type === 'inline' ? contentToken.content : '';
+            const heading = {
+                level,
+                text,
+                startLine: token.map ? token.map[0] + 1 : currentLine,
+                endLine: -1, // Will be set later
+                children: [],
+            };
+            // Pop stack until we find a parent with lower level
+            while (stack.length > 0 && stack[stack.length - 1].level >= level) {
+                stack.pop();
+            }
+            if (stack.length === 0) {
+                // Top-level heading
+                headings.push(heading);
+            }
+            else {
+                // Add as child to parent
+                stack[stack.length - 1].children.push(heading);
+            }
+            stack.push(heading);
+        }
+        if (token.map) {
+            currentLine = token.map[1] + 1;
+        }
+    }
+    // Calculate end lines for all headings
+    const contentLines = content.split('\n');
+    calculateEndLines(headings, contentLines.length);
+    return headings;
+}
+/**
+ * Calculate end lines for headings recursively
+ */
+function calculateEndLines(headings, totalLines) {
+    for (let i = 0; i < headings.length; i++) {
+        const heading = headings[i];
+        // End line is either the start of next sibling or parent's end
+        if (i < headings.length - 1) {
+            heading.endLine = headings[i + 1].startLine - 1;
+        }
+        else {
+            heading.endLine = totalLines;
+        }
+        // Recursively calculate for children
+        if (heading.children.length > 0) {
+            calculateEndLines(heading.children, heading.endLine);
+        }
+    }
+}
+/**
+ * Count total number of headings
+ */
+export function countHeadings(headings) {
+    let count = headings.length;
+    for (const heading of headings) {
+        count += countHeadings(heading.children);
+    }
+    return count;
+}
+/**
+ * Get all headings as flat list
+ */
+export function flattenHeadings(headings) {
+    const result = [];
+    for (const heading of headings) {
+        result.push(heading);
+        result.push(...flattenHeadings(heading.children));
+    }
+    return result;
+}
+/**
+ * Count lines in content
+ */
+export function countLines(content) {
+    return content.split('\n').length;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/md/utils/markdown.js.map

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

package/dist/md/utils/remark.d.ts

@@ -0,0 +1,91 @@
+import type { Root } from 'mdast';
+import type { VFile } from 'vfile';
+/**
+ * Options for remark processing
+ */
+export interface RemarkProcessOptions {
+    /**
+     * Enable GitHub Flavored Markdown
+     * @default true
+     */
+    gfm?: boolean;
+    /**
+     * Remark plugins to apply
+     */
+    plugins?: Array<any>;
+}
+/**
+ * Process markdown content with remark
+ *
+ * @param content - Markdown content to process
+ * @param options - Processing options
+ * @returns Processed markdown content
+ *
+ * @example
+ * ```typescript
+ * import { processMarkdown } from './utils/remark.js';
+ * import { remarkNormalizeHeadings } from './plugins/normalize-headings.js';
+ *
+ * const result = await processMarkdown(content, {
+ *   plugins: [remarkNormalizeHeadings({ separator: ' / ' })],
+ * });
+ * ```
+ */
+export declare function processMarkdown(content: string, options?: RemarkProcessOptions): Promise<string>;
+/**
+ * Parse markdown into AST without stringify
+ *
+ * @param content - Markdown content to parse
+ * @param options - Processing options
+ * @returns VFile with AST
+ *
+ * @example
+ * ```typescript
+ * import { parseMarkdown } from './utils/remark.js';
+ *
+ * const file = await parseMarkdown(content);
+ * console.log(file.data); // Access AST
+ * ```
+ */
+export declare function parseMarkdown(content: string, options?: RemarkProcessOptions): Promise<VFile>;
+/**
+ * Get AST from markdown content
+ *
+ * @param content - Markdown content
+ * @returns Markdown AST (Root node)
+ *
+ * @example
+ * ```typescript
+ * import { getAST } from './utils/remark.js';
+ * import { visit } from 'unist-util-visit';
+ *
+ * const ast = await getAST(content);
+ * visit(ast, 'heading', (node) => {
+ *   console.log(node);
+ * });
+ * ```
+ */
+export declare function getAST(content: string): Promise<Root>;
+/**
+ * Stringify AST back to markdown
+ *
+ * @param ast - Markdown AST
+ * @returns Markdown string
+ *
+ * @example
+ * ```typescript
+ * import { getAST, stringifyAST } from './utils/remark.js';
+ * import { visit } from 'unist-util-visit';
+ *
+ * const ast = await getAST(content);
+ *
+ * // Modify AST
+ * visit(ast, 'heading', (node) => {
+ *   // Transform headings
+ * });
+ *
+ * const markdown = await stringifyAST(ast);
+ * ```
+ */
+export declare function stringifyAST(ast: Root): Promise<string>;
+//# sourceMappingURL=remark.d.ts.map

package/dist/md/utils/remark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remark.d.ts","sourceRoot":"","sources":["../../../src/md/utils/remark.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC,CA0BjB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,KAAK,CAAC,CAehB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM3D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAU7D"}

package/dist/md/utils/remark.js

@@ -0,0 +1,125 @@
+import { unified } from 'unified';
+import remarkParse from 'remark-parse';
+import remarkStringify from 'remark-stringify';
+import remarkGfm from 'remark-gfm';
+/**
+ * Process markdown content with remark
+ *
+ * @param content - Markdown content to process
+ * @param options - Processing options
+ * @returns Processed markdown content
+ *
+ * @example
+ * ```typescript
+ * import { processMarkdown } from './utils/remark.js';
+ * import { remarkNormalizeHeadings } from './plugins/normalize-headings.js';
+ *
+ * const result = await processMarkdown(content, {
+ *   plugins: [remarkNormalizeHeadings({ separator: ' / ' })],
+ * });
+ * ```
+ */
+export async function processMarkdown(content, options = {}) {
+    const { gfm = true, plugins = [] } = options;
+    // Use any type for processor to avoid type errors with dynamic plugin loading
+    let processor = unified().use(remarkParse);
+    // Add GitHub Flavored Markdown support
+    if (gfm) {
+        processor = processor.use(remarkGfm);
+    }
+    // Add custom plugins
+    for (const plugin of plugins) {
+        processor = processor.use(plugin);
+    }
+    // Add stringify at the end
+    processor = processor.use(remarkStringify, {
+        bullet: '-',
+        fence: '`',
+        fences: true,
+        incrementListMarker: false,
+    });
+    const result = await processor.process(content);
+    return String(result);
+}
+/**
+ * Parse markdown into AST without stringify
+ *
+ * @param content - Markdown content to parse
+ * @param options - Processing options
+ * @returns VFile with AST
+ *
+ * @example
+ * ```typescript
+ * import { parseMarkdown } from './utils/remark.js';
+ *
+ * const file = await parseMarkdown(content);
+ * console.log(file.data); // Access AST
+ * ```
+ */
+export async function parseMarkdown(content, options = {}) {
+    const { gfm = true, plugins = [] } = options;
+    // Use any type for processor to avoid type errors with dynamic plugin loading
+    let processor = unified().use(remarkParse);
+    if (gfm) {
+        processor = processor.use(remarkGfm);
+    }
+    for (const plugin of plugins) {
+        processor = processor.use(plugin);
+    }
+    return await processor.process(content);
+}
+/**
+ * Get AST from markdown content
+ *
+ * @param content - Markdown content
+ * @returns Markdown AST (Root node)
+ *
+ * @example
+ * ```typescript
+ * import { getAST } from './utils/remark.js';
+ * import { visit } from 'unist-util-visit';
+ *
+ * const ast = await getAST(content);
+ * visit(ast, 'heading', (node) => {
+ *   console.log(node);
+ * });
+ * ```
+ */
+export async function getAST(content) {
+    const processor = unified()
+        .use(remarkParse)
+        .use(remarkGfm);
+    return processor.parse(content);
+}
+/**
+ * Stringify AST back to markdown
+ *
+ * @param ast - Markdown AST
+ * @returns Markdown string
+ *
+ * @example
+ * ```typescript
+ * import { getAST, stringifyAST } from './utils/remark.js';
+ * import { visit } from 'unist-util-visit';
+ *
+ * const ast = await getAST(content);
+ *
+ * // Modify AST
+ * visit(ast, 'heading', (node) => {
+ *   // Transform headings
+ * });
+ *
+ * const markdown = await stringifyAST(ast);
+ * ```
+ */
+export async function stringifyAST(ast) {
+    const processor = unified().use(remarkStringify, {
+        bullet: '-',
+        fence: '`',
+        fences: true,
+        incrementListMarker: false,
+    });
+    const file = await processor.stringify(ast);
+    return String(file);
+}
+//# sourceMappingURL=remark.js.map

package/dist/md/utils/remark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remark.js","sourceRoot":"","sources":["../../../src/md/utils/remark.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,WAAW,MAAM,cAAc,CAAC;AACvC,OAAO,eAAe,MAAM,kBAAkB,CAAC;AAC/C,OAAO,SAAS,MAAM,YAAY,CAAC;AAoBnC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAe,EACf,UAAgC,EAAE;IAElC,MAAM,EAAE,GAAG,GAAG,IAAI,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAE7C,8EAA8E;IAC9E,IAAI,SAAS,GAAQ,OAAO,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAEhD,uCAAuC;IACvC,IAAI,GAAG,EAAE,CAAC;QACR,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED,qBAAqB;IACrB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,2BAA2B;IAC3B,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,eAAe,EAAE;QACzC,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,IAAI;QACZ,mBAAmB,EAAE,KAAK;KAC3B,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,UAAgC,EAAE;IAElC,MAAM,EAAE,GAAG,GAAG,IAAI,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAE7C,8EAA8E;IAC9E,IAAI,SAAS,GAAQ,OAAO,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAEhD,IAAI,GAAG,EAAE,CAAC;QACR,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,MAAM,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAe;IAC1C,MAAM,SAAS,GAAG,OAAO,EAAE;SACxB,GAAG,CAAC,WAAW,CAAC;SAChB,GAAG,CAAC,SAAS,CAAC,CAAC;IAElB,OAAO,SAAS,CAAC,KAAK,CAAC,OAAO,CAAS,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAS;IAC1C,MAAM,SAAS,GAAG,OAAO,EAAE,CAAC,GAAG,CAAC,eAAe,EAAE;QAC/C,MAAM,EAAE,GAAG;QACX,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,IAAI;QACZ,mBAAmB,EAAE,KAAK;KAC3B,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC"}

package/dist/md/utils/tokens.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Estimate token count for text using tiktoken
+ */
+export declare function estimateTokens(text: string, model?: string): number;
+/**
+ * Format token count for display
+ */
+export declare function formatTokenCount(count: number): string;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/md/utils/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../src/md/utils/tokens.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAgB,GAAG,MAAM,CAY5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQtD"}