@refrakt-md/cli 0.8.5 → 0.9.1

package/dist/lib/meta-audit.js

@@ -0,0 +1,116 @@
+import { readdirSync, readFileSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { createRequire } from 'node:module';
+import postcss from 'postcss';
+/** Walk all rune configs and collect structure entries with metadata annotations */
+export function collectMetadata(config) {
+    const fields = [];
+    const typeCount = {};
+    const rankCount = {};
+    let withSentiment = 0;
+    let withoutSentiment = 0;
+    for (const [runeKey, runeConfig] of Object.entries(config.runes)) {
+        if (!runeConfig.structure)
+            continue;
+        for (const [key, entry] of Object.entries(runeConfig.structure)) {
+            collectFromEntry(entry, key, runeKey, runeConfig.block, fields);
+        }
+    }
+    for (const field of fields) {
+        typeCount[field.metaType] = (typeCount[field.metaType] || 0) + 1;
+        if (field.metaRank) {
+            rankCount[field.metaRank] = (rankCount[field.metaRank] || 0) + 1;
+        }
+        if (field.hasSentiment) {
+            withSentiment++;
+        }
+        else {
+            withoutSentiment++;
+        }
+    }
+    return { fields, typeCount, rankCount, withSentiment, withoutSentiment };
+}
+/** Recursively collect metadata fields from a structure entry and its children */
+function collectFromEntry(entry, key, runeKey, block, fields) {
+    if (entry.metaType) {
+        fields.push({
+            rune: runeKey,
+            block,
+            ref: entry.ref ?? key,
+            metaType: entry.metaType,
+            metaRank: entry.metaRank,
+            hasSentiment: !!entry.sentimentMap,
+            sentimentValues: entry.sentimentMap ? Object.keys(entry.sentimentMap) : undefined,
+        });
+    }
+    if (entry.children) {
+        for (const child of entry.children) {
+            if (typeof child !== 'string') {
+                collectFromEntry(child, child.ref ?? '', runeKey, block, fields);
+            }
+        }
+    }
+}
+const META_ATTR_RE = /\[data-meta-[\w-]+(?:="[^"]*")?\]/g;
+/** Check CSS files for metadata dimension selectors */
+export function checkMetaCss(cssDir) {
+    const selectors = new Map();
+    // Check both runes/ and dimensions/ directories
+    const dirs = [cssDir];
+    const dimensionsDir = join(dirname(cssDir), 'dimensions');
+    if (existsSync(dimensionsDir)) {
+        dirs.push(dimensionsDir);
+    }
+    // Also try resolving from @refrakt-md/lumina
+    try {
+        const require = createRequire(import.meta.url);
+        const luminaPkg = require.resolve('@refrakt-md/lumina/package.json');
+        const luminaDimDir = join(dirname(luminaPkg), 'styles', 'dimensions');
+        if (existsSync(luminaDimDir) && !dirs.includes(luminaDimDir)) {
+            dirs.push(luminaDimDir);
+        }
+    }
+    catch {
+        // Package not found
+    }
+    for (const dir of dirs) {
+        if (!existsSync(dir))
+            continue;
+        const files = readdirSync(dir).filter(f => f.endsWith('.css'));
+        for (const file of files) {
+            const content = readFileSync(join(dir, file), 'utf-8');
+            const root = postcss.parse(content);
+            root.walkRules((rule) => {
+                const line = rule.source?.start?.line ?? 0;
+                for (const m of rule.selector.matchAll(META_ATTR_RE)) {
+                    if (!selectors.has(m[0])) {
+                        selectors.set(m[0], { file, line });
+                    }
+                }
+            });
+        }
+    }
+    const EXPECTED_TYPES = ['status', 'category', 'quantity', 'temporal', 'tag', 'id'];
+    const EXPECTED_SENTIMENTS = ['positive', 'negative', 'caution', 'neutral'];
+    const EXPECTED_RANKS = ['primary', 'secondary'];
+    const types = {};
+    for (const type of EXPECTED_TYPES) {
+        const sel = `[data-meta-type="${type}"]`;
+        const match = selectors.get(sel);
+        types[type] = match ? { styled: true, file: match.file, line: match.line } : { styled: false };
+    }
+    const sentiments = {};
+    for (const sentiment of EXPECTED_SENTIMENTS) {
+        const sel = `[data-meta-sentiment="${sentiment}"]`;
+        const match = selectors.get(sel);
+        sentiments[sentiment] = match ? { styled: true, file: match.file, line: match.line } : { styled: false };
+    }
+    const ranks = {};
+    for (const rank of EXPECTED_RANKS) {
+        const sel = `[data-meta-rank="${rank}"]`;
+        const match = selectors.get(sel);
+        ranks[rank] = match ? { styled: true, file: match.file, line: match.line } : { styled: false };
+    }
+    return { types, sentiments, ranks };
+}
+//# sourceMappingURL=meta-audit.js.map

package/dist/lib/meta-audit.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@refrakt-md/cli",
   "description": "CLI tools for refrakt.md",
-  "version": "0.8.5",
+  "version": "0.9.1",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -25,13 +25,10 @@
   },
   "dependencies": {
     "@markdoc/markdoc": "0.4.0",
-    "@refrakt-md/ai": "0.8.5",
-    "@refrakt-md/editor": "0.8.5",
-    "@refrakt-md/runes": "0.8.5",
-    "@refrakt-md/transform": "0.8.5",
-    "postcss": "^8.4.0",
-    "tree-sitter-wasms": "^0.1.13",
-    "typescript": "^5.4.0",
-    "web-tree-sitter": "^0.24.7"
+    "@refrakt-md/ai": "0.9.1",
+    "@refrakt-md/editor": "0.9.1",
+    "@refrakt-md/runes": "0.9.1",
+    "@refrakt-md/transform": "0.9.1",
+    "postcss": "^8.4.0"
   }
 }

package/dist/commands/extract.d.ts

@@ -1,10 +0,0 @@
-export interface ExtractOptions {
-    input: string;
-    output: string;
-    lang?: 'typescript' | 'python';
-    validate?: boolean;
-    sourceUrl?: string;
-    title?: string;
-}
-export declare function extractCommand(opts: ExtractOptions): Promise<void>;
-//# sourceMappingURL=extract.d.ts.map

package/dist/commands/extract.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/commands/extract.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AA8DD,wBAAsB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA2GxE"}

package/dist/commands/extract.js

@@ -1,161 +0,0 @@
-import { resolve, join, relative, dirname } from 'node:path';
-import { writeFileSync, readFileSync, existsSync, mkdirSync, readdirSync, statSync } from 'node:fs';
-import { loadExtractor } from '../extractors/index.js';
-import { generateSymbolMarkdown, toSlug } from '../lib/symbol-generator.js';
-import { generateLayoutMarkdown } from '../lib/layout-generator.js';
-function detectLanguage(inputPath) {
-    const abs = resolve(inputPath);
-    // Check if input is a single file
-    if (existsSync(abs) && statSync(abs).isFile()) {
-        if (abs.endsWith('.ts') || abs.endsWith('.tsx'))
-            return 'typescript';
-        if (abs.endsWith('.py'))
-            return 'python';
-    }
-    // Check for tsconfig.json
-    if (existsSync(join(abs, 'tsconfig.json')) ||
-        existsSync(join(dirname(abs), 'tsconfig.json'))) {
-        return 'typescript';
-    }
-    // Check directory contents
-    if (existsSync(abs) && statSync(abs).isDirectory()) {
-        try {
-            const files = readdirSync(abs);
-            if (files.some(f => f.endsWith('.ts') || f.endsWith('.tsx')))
-                return 'typescript';
-            if (files.some(f => f.endsWith('.py')))
-                return 'python';
-        }
-        catch {
-            // fall through
-        }
-    }
-    return 'typescript';
-}
-function findSourceFiles(inputPath, lang) {
-    const abs = resolve(inputPath);
-    if (!existsSync(abs))
-        return [];
-    const stat = statSync(abs);
-    if (stat.isFile())
-        return [abs];
-    const ext = lang === 'typescript' ? /\.tsx?$/ : /\.py$/;
-    return walkFiles(abs, ext);
-}
-function walkFiles(dir, ext) {
-    const files = [];
-    const entries = readdirSync(dir);
-    for (const entry of entries) {
-        if (entry === 'node_modules' || entry === '__pycache__' || entry.startsWith('.'))
-            continue;
-        const fullPath = resolve(dir, entry);
-        const stat = statSync(fullPath);
-        if (stat.isDirectory()) {
-            files.push(...walkFiles(fullPath, ext));
-        }
-        else if (ext.test(entry)
-            && !entry.endsWith('.d.ts') && !entry.endsWith('.test.ts') && !entry.endsWith('.spec.ts')
-            && !entry.startsWith('test_') && !entry.endsWith('_test.py')
-            && entry !== 'conftest.py' && entry !== 'setup.py') {
-            files.push(fullPath);
-        }
-    }
-    return files;
-}
-export async function extractCommand(opts) {
-    const inputPath = resolve(opts.input);
-    const outputPath = resolve(opts.output);
-    const lang = opts.lang ?? detectLanguage(inputPath);
-    if (!existsSync(inputPath)) {
-        console.error(`Error: Input path does not exist: ${inputPath}`);
-        process.exit(1);
-    }
-    // Use the directory as rootDir for the extractor (even if input is a single file)
-    const extractorRoot = statSync(inputPath).isDirectory() ? inputPath : dirname(inputPath);
-    // Load the appropriate extractor
-    const extractor = await loadExtractor(lang, extractorRoot, opts.sourceUrl);
-    // Find all source files
-    const sourceFiles = findSourceFiles(inputPath, lang);
-    if (sourceFiles.length === 0) {
-        console.error(`No ${lang} source files found in ${inputPath}`);
-        process.exit(1);
-    }
-    // Extract symbols from all files
-    const allSymbols = [];
-    for (const file of sourceFiles) {
-        const result = extractor.extractFile(file);
-        allSymbols.push(...result.symbols);
-    }
-    if (allSymbols.length === 0) {
-        console.log('No exported symbols found.');
-        return;
-    }
-    console.log(`Found ${allSymbols.length} symbols in ${sourceFiles.length} files`);
-    // Detect slug collisions and resolve them
-    const slugMap = new Map();
-    for (const doc of allSymbols) {
-        const slug = toSlug(doc.name);
-        const existing = slugMap.get(slug) ?? [];
-        existing.push(doc);
-        slugMap.set(slug, existing);
-    }
-    // Generate Markdown for each symbol
-    const generated = new Map();
-    for (const [slug, docs] of slugMap) {
-        if (docs.length === 1) {
-            const filePath = join(outputPath, `${slug}.md`);
-            generated.set(filePath, generateSymbolMarkdown(docs[0], { lang }));
-        }
-        else {
-            // Resolve collisions by appending kind
-            for (const doc of docs) {
-                const uniqueSlug = `${slug}-${doc.kind}`;
-                const filePath = join(outputPath, `${uniqueSlug}.md`);
-                generated.set(filePath, generateSymbolMarkdown(doc, { lang }));
-            }
-        }
-    }
-    // Generate _layout.md
-    const layoutPath = join(outputPath, '_layout.md');
-    const layoutContent = generateLayoutMarkdown(allSymbols, { title: opts.title });
-    generated.set(layoutPath, layoutContent);
-    // Validate mode: compare generated to existing
-    if (opts.validate) {
-        let stale = false;
-        for (const [filePath, content] of generated) {
-            if (!existsSync(filePath)) {
-                console.error(`MISSING: ${relative(process.cwd(), filePath)}`);
-                stale = true;
-            }
-            else {
-                const existing = readFileSync(filePath, 'utf-8');
-                if (existing !== content) {
-                    console.error(`STALE: ${relative(process.cwd(), filePath)}`);
-                    stale = true;
-                }
-            }
-        }
-        if (stale) {
-            console.error('\nAPI reference is out of date. Run `refrakt extract` to regenerate.');
-            process.exit(1);
-        }
-        else {
-            console.log(`OK: ${generated.size} files up to date (${allSymbols.length} symbols)`);
-        }
-        return;
-    }
-    // Write mode
-    if (!existsSync(outputPath)) {
-        mkdirSync(outputPath, { recursive: true });
-    }
-    let written = 0;
-    for (const [filePath, content] of generated) {
-        const dir = dirname(filePath);
-        if (!existsSync(dir))
-            mkdirSync(dir, { recursive: true });
-        writeFileSync(filePath, content);
-        written++;
-    }
-    console.log(`Written ${written} files to ${relative(process.cwd(), outputPath)}`);
-}
-//# sourceMappingURL=extract.js.map

package/dist/commands/extract.js.map

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

package/dist/extractors/index.d.ts

@@ -1,3 +0,0 @@
-export type { SymbolDoc, SymbolExtractor, ExtractorResult, SymbolKind, SymbolParameter, SymbolReturn, SymbolThrows, SymbolMemberDoc, SymbolGroupDoc, } from './types.js';
-export declare function loadExtractor(lang: 'typescript' | 'python', rootDir: string, sourceUrl?: string): Promise<import('./types.js').SymbolExtractor>;
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extractors/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EACvD,eAAe,EAAE,YAAY,EAAE,YAAY,EAC3C,eAAe,EAAE,cAAc,GAC/B,MAAM,YAAY,CAAC;AAEpB,wBAAsB,aAAa,CAClC,IAAI,EAAE,YAAY,GAAG,QAAQ,EAC7B,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,YAAY,EAAE,eAAe,CAAC,CAe/C"}

package/dist/extractors/index.js

@@ -1,17 +0,0 @@
-export async function loadExtractor(lang, rootDir, sourceUrl) {
-    switch (lang) {
-        case 'typescript': {
-            const { TypeScriptExtractor } = await import('./typescript.js');
-            return new TypeScriptExtractor(rootDir, sourceUrl);
-        }
-        case 'python': {
-            const { PythonExtractor } = await import('./python.js');
-            const extractor = new PythonExtractor(rootDir, sourceUrl);
-            await extractor.init();
-            return extractor;
-        }
-        default:
-            throw new Error(`Unsupported language: ${lang}`);
-    }
-}
-//# sourceMappingURL=index.js.map

package/dist/extractors/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/extractors/index.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,IAA6B,EAC7B,OAAe,EACf,SAAkB;IAElB,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,YAAY,CAAC,CAAC,CAAC;YACnB,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YAChE,OAAO,IAAI,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACpD,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACf,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YACxD,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAC1D,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;YACvB,OAAO,SAAS,CAAC;QAClB,CAAC;QACD;YACC,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;AACF,CAAC"}

package/dist/extractors/python-docstring.d.ts

@@ -1,26 +0,0 @@
-/**
- * Python docstring parser — supports Google, NumPy, and Sphinx (reST) conventions.
- * Auto-detects the format and extracts parameters, returns, raises, since, and deprecated.
- */
-export interface DocstringParam {
-    type: string;
-    description: string;
-}
-export interface DocstringInfo {
-    description: string;
-    params: Map<string, DocstringParam>;
-    returns?: {
-        type: string;
-        description: string;
-    };
-    raises: Array<{
-        type: string;
-        description: string;
-    }>;
-    since?: string;
-    deprecated?: string;
-}
-export type DocstringStyle = 'google' | 'numpy' | 'sphinx' | 'plain';
-export declare function detectStyle(raw: string): DocstringStyle;
-export declare function parseDocstring(raw: string): DocstringInfo;
-//# sourceMappingURL=python-docstring.d.ts.map

package/dist/extractors/python-docstring.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"python-docstring.d.ts","sourceRoot":"","sources":["../../src/extractors/python-docstring.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAQrE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAMvD;AAID,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAazD"}