@sn4p.dev/mucv 0.5.0

package/dist/core/jsx-parser.d.ts

@@ -0,0 +1,22 @@
+/**
+ * MUCV — JSX/TSX Parser
+ * Convierte código JSX/TSX → VisualIR usando Babel AST.
+ *
+ * Estrategia:
+ * 1. Parsea el JSX con @babel/parser
+ * 2. Busca el return statement del primer componente funcional (o el JSX root)
+ * 3. Recorre el JSX AST recursivamente produciendo VisualNode[]
+ *
+ * @see docs/VIR-SPEC.md
+ * @see .claude/agents/parser-dev.md
+ */
+import type { ParseResult } from './parse-result.js';
+export declare const jsxParser: {
+    /**
+     * Parsea JSX/TSX y produce un VisualIR validado.
+     * @param raw — código fuente JSX o TSX
+     * @param sourceId — identificador externo opcional
+     */
+    parse(raw: string, sourceId?: string): ParseResult;
+};
+//# sourceMappingURL=jsx-parser.d.ts.map

package/dist/core/jsx-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-parser.d.ts","sourceRoot":"","sources":["../../src/core/jsx-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAiBH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AASpD,eAAO,MAAM,SAAS;IACpB;;;;OAIG;eACQ,MAAM,aAAa,MAAM,GAAG,WAAW;CAuDnD,CAAA"}

package/dist/core/jsx-parser.js

@@ -0,0 +1,261 @@
+/**
+ * MUCV — JSX/TSX Parser
+ * Convierte código JSX/TSX → VisualIR usando Babel AST.
+ *
+ * Estrategia:
+ * 1. Parsea el JSX con @babel/parser
+ * 2. Busca el return statement del primer componente funcional (o el JSX root)
+ * 3. Recorre el JSX AST recursivamente produciendo VisualNode[]
+ *
+ * @see docs/VIR-SPEC.md
+ * @see .claude/agents/parser-dev.md
+ */
+import { createHash } from 'node:crypto';
+import { parse as babelParse } from '@babel/parser';
+import { VisualIRSchema } from '../schemas/vir.schema.js';
+import { mapJsxElement, HTML_HEADING_LEVEL_MAP } from './mapper.js';
+import { normalizeText } from './normalizer.js';
+import { logger } from '../utils/logger.js';
+import { ParseError, VIRValidationError } from '../utils/errors.js';
+// ─── Parser principal ─────────────────────────────────────────────────────────
+export const jsxParser = {
+    /**
+     * Parsea JSX/TSX y produce un VisualIR validado.
+     * @param raw — código fuente JSX o TSX
+     * @param sourceId — identificador externo opcional
+     */
+    parse(raw, sourceId) {
+        if (typeof raw !== 'string') {
+            throw new ParseError('JSX input debe ser un string', { type: typeof raw });
+        }
+        let ast;
+        try {
+            ast = babelParse(raw, {
+                sourceType: 'module',
+                plugins: ['jsx', 'typescript'],
+                errorRecovery: true,
+            });
+        }
+        catch (err) {
+            throw new ParseError('JSX/TSX no pudo ser parseado por Babel', {
+                error: err instanceof Error ? err.message : String(err),
+                raw: raw.slice(0, 100),
+            });
+        }
+        const jsxRoots = extractJSXRoots(ast);
+        if (jsxRoots.length === 0) {
+            throw new ParseError('No se encontró JSX en el código fuente', {
+                raw: raw.slice(0, 100),
+            });
+        }
+        const root = jsxRoots.map((el, i) => parseJSXElement(el, i))
+            .filter((n) => n !== null);
+        if (root.length === 0) {
+            throw new ParseError('JSX no produjo nodos VIR válidos', {
+                raw: raw.slice(0, 100),
+            });
+        }
+        const virId = generateVIRId({ raw: raw.slice(0, 200), sourceId });
+        const vir = {
+            virVersion: '1.0.0',
+            id: virId,
+            source: {
+                type: 'react',
+                ...(sourceId !== undefined && { sourceId }),
+            },
+            root,
+            createdAt: new Date().toISOString(),
+        };
+        const result = VisualIRSchema.safeParse(vir);
+        if (!result.success) {
+            throw new VIRValidationError(result.error, { sourceType: 'react' });
+        }
+        logger.debug({ nodeCount: root.length, sourceId }, 'JSX VIR parsed');
+        return { vir: result.data, warnings: [] };
+    },
+};
+// ─── Extracción de JSX raíz ───────────────────────────────────────────────────
+function extractJSXRoots(ast) {
+    const roots = [];
+    for (const node of ast.program.body) {
+        // export default function Component() { return <JSX> }
+        // function Component() { return <JSX> }
+        if (node.type === 'ExportDefaultDeclaration' ||
+            node.type === 'FunctionDeclaration' ||
+            node.type === 'ExportNamedDeclaration') {
+            const decl = node.type === 'ExportDefaultDeclaration' ||
+                node.type === 'ExportNamedDeclaration'
+                ? node.declaration
+                : node;
+            if (decl && 'body' in decl && decl.body) {
+                const body = decl.body;
+                const returnStmt = body.body?.find((s) => s.type === 'ReturnStatement');
+                const arg = returnStmt?.argument;
+                if (arg?.type === 'JSXElement') {
+                    roots.push(arg);
+                }
+                else if (arg?.type === 'JSXFragment') {
+                    const frag = arg;
+                    roots.push(...frag.children.filter((c) => c.type === 'JSXElement'));
+                }
+            }
+        }
+        // Expresiones JSX de nivel superior: export default (<div>)
+        if (node.type === 'ExpressionStatement') {
+            const expr = node.expression;
+            if (expr.type === 'JSXElement') {
+                roots.push(expr);
+            }
+        }
+    }
+    return roots;
+}
+// ─── Parseo recursivo JSX ─────────────────────────────────────────────────────
+function parseJSXElement(el, index) {
+    const nameNode = el.openingElement.name;
+    const name = jsxNameToString(nameNode);
+    if (!name)
+        return null;
+    const type = mapJsxElement(name);
+    const nodeId = generateNodeId(`${name}-${index}`, index);
+    const attrs = extractAttributes(el.openingElement.attributes);
+    const content = extractContent(el, name, type, attrs);
+    const children = el.children
+        .filter((c) => c.type === 'JSXElement')
+        .map((child, i) => parseJSXElement(child, i))
+        .filter((n) => n !== null);
+    const meta = {
+        originalType: name,
+        ...(attrs['id'] !== undefined && { originalId: String(attrs['id']) }),
+        ...(attrs['className'] !== undefined && {
+            cssClasses: String(attrs['className']).split(/\s+/).filter(Boolean),
+        }),
+    };
+    const node = {
+        id: nodeId,
+        type,
+        ...(content !== undefined && { content }),
+        ...(children.length > 0 && { children }),
+        meta,
+    };
+    return node;
+}
+// ─── Extracción de atributos JSX ─────────────────────────────────────────────
+function extractAttributes(attrs) {
+    const result = {};
+    for (const attr of attrs) {
+        if (attr.type !== 'JSXAttribute')
+            continue;
+        const jsxAttr = attr;
+        const key = typeof jsxAttr.name === 'object' && 'name' in jsxAttr.name
+            ? String(jsxAttr.name.name)
+            : '';
+        if (!key)
+            continue;
+        const val = jsxAttr.value;
+        if (val === null) {
+            result[key] = true;
+        }
+        else if (val?.type === 'StringLiteral') {
+            result[key] = val.value;
+        }
+        else if (val?.type === 'JSXExpressionContainer') {
+            const expr = val.expression;
+            if (expr.type === 'StringLiteral') {
+                result[key] = expr.value;
+            }
+            else if (expr.type === 'NumericLiteral') {
+                result[key] = expr.value;
+            }
+            else if (expr.type === 'BooleanLiteral') {
+                result[key] = expr.value;
+            }
+        }
+    }
+    return result;
+}
+// ─── Extracción de contenido por tipo ────────────────────────────────────────
+function extractContent(el, name, type, attrs) {
+    const textContent = extractTextContent(el);
+    switch (type) {
+        case 'heading': {
+            const level = HTML_HEADING_LEVEL_MAP[name.toLowerCase()] ?? 2;
+            return { level, ...(textContent !== undefined && { text: textContent }) };
+        }
+        case 'text':
+            return textContent !== undefined ? { text: textContent } : undefined;
+        case 'image': {
+            const src = attrs['src'];
+            const alt = attrs['alt'];
+            if (!src)
+                return undefined;
+            return { src, ...(alt !== undefined && { alt }) };
+        }
+        case 'button': {
+            const href = attrs['href'];
+            const to = attrs['to']; // React Router
+            const label = textContent;
+            const targetAttr = attrs['target'];
+            const target = targetAttr === '_blank' ? '_blank' : '_self';
+            return {
+                ...(label !== undefined && { label }),
+                ...(href !== undefined && { href }),
+                ...(to !== undefined && !href && { href: to }),
+                target,
+            };
+        }
+        case 'list': {
+            const listItems = el.children.filter((c) => c.type === 'JSXElement');
+            const items = listItems.map((li, i) => ({
+                id: generateNodeId(`li-${i}`, i),
+                text: extractTextContent(li) ?? '',
+            }));
+            return items.length > 0 ? { items } : undefined;
+        }
+        default:
+            return undefined;
+    }
+}
+// ─── Texto de un JSXElement ───────────────────────────────────────────────────
+function extractTextContent(el) {
+    const parts = [];
+    for (const child of el.children) {
+        if (child.type === 'JSXText') {
+            const text = child.value.trim();
+            if (text)
+                parts.push(text);
+        }
+        else if (child.type === 'JSXExpressionContainer') {
+            const expr = child.expression;
+            if (expr.type === 'StringLiteral') {
+                parts.push(expr.value);
+            }
+        }
+    }
+    return normalizeText(parts.join(' '));
+}
+// ─── Utilidades ───────────────────────────────────────────────────────────────
+function jsxNameToString(name) {
+    if (name.type === 'JSXIdentifier')
+        return name.name;
+    if (name.type === 'JSXMemberExpression') {
+        const obj = jsxNameToString(name.object);
+        return obj ? `${obj}.${name.property.name}` : null;
+    }
+    return null;
+}
+function generateNodeId(seed, index) {
+    const hash = createHash('sha256')
+        .update(`${seed}-${index}`)
+        .digest('hex')
+        .slice(0, 8);
+    return `node_${hash}`;
+}
+function generateVIRId(content) {
+    const hash = createHash('sha256')
+        .update(JSON.stringify(content))
+        .digest('hex')
+        .slice(0, 8);
+    return `vir_${hash}`;
+}
+//# sourceMappingURL=jsx-parser.js.map

package/dist/core/jsx-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-parser.js","sourceRoot":"","sources":["../../src/core/jsx-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,KAAK,IAAI,UAAU,EAAE,MAAM,eAAe,CAAA;AAenD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAEnE,iFAAiF;AAEjF,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB;;;;OAIG;IACH,KAAK,CAAC,GAAW,EAAE,QAAiB;QAClC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,UAAU,CAAC,8BAA8B,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,EAAE,CAAC,CAAA;QAC5E,CAAC;QAED,IAAI,GAAS,CAAA;QACb,IAAI,CAAC;YACH,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE;gBACpB,UAAU,EAAE,QAAQ;gBACpB,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC;gBAC9B,aAAa,EAAE,IAAI;aACpB,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,UAAU,CAAC,wCAAwC,EAAE;gBAC7D,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;gBACvD,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;aACvB,CAAC,CAAA;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,CAAA;QACrC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,UAAU,CAAC,wCAAwC,EAAE;gBAC7D,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;aACvB,CAAC,CAAA;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;aACzD,MAAM,CAAC,CAAC,CAAC,EAAmB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAA;QAE7C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,UAAU,CAAC,kCAAkC,EAAE;gBACvD,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;aACvB,CAAC,CAAA;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,aAAa,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;QACjE,MAAM,GAAG,GAAa;YACpB,UAAU,EAAE,OAAO;YACnB,EAAE,EAAE,KAAK;YACT,MAAM,EAAE;gBACN,IAAI,EAAE,OAAO;gBACb,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;aAC5C;YACD,IAAI;YACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAA;QAED,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;QAC5C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,kBAAkB,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAA;QACrE,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,gBAAgB,CAAC,CAAA;QACpE,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,IAAgB,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAA;IACvD,CAAC;CACF,CAAA;AAED,iFAAiF;AAEjF,SAAS,eAAe,CAAC,GAAS;IAChC,MAAM,KAAK,GAAiB,EAAE,CAAA;IAE9B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACpC,uDAAuD;QACvD,wCAAwC;QACxC,IACE,IAAI,CAAC,IAAI,KAAK,0BAA0B;YACxC,IAAI,CAAC,IAAI,KAAK,qBAAqB;YACnC,IAAI,CAAC,IAAI,KAAK,wBAAwB,EACtC,CAAC;YACD,MAAM,IAAI,GACR,IAAI,CAAC,IAAI,KAAK,0BAA0B;gBACxC,IAAI,CAAC,IAAI,KAAK,wBAAwB;gBACpC,CAAC,CAAE,IAA+B,CAAC,WAAW;gBAC9C,CAAC,CAAC,IAAI,CAAA;YAEV,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACxC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAyB,CAAA;gBAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAEzD,CAAA;gBACb,MAAM,GAAG,GAAG,UAAU,EAAE,QAAQ,CAAA;gBAChC,IAAI,GAAG,EAAE,IAAI,KAAK,YAAY,EAAE,CAAC;oBAC/B,KAAK,CAAC,IAAI,CAAC,GAAiB,CAAC,CAAA;gBAC/B,CAAC;qBAAM,IAAI,GAAG,EAAE,IAAI,KAAK,aAAa,EAAE,CAAC;oBACvC,MAAM,IAAI,GAAG,GAAkB,CAAA;oBAC/B,KAAK,CAAC,IAAI,CACR,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAmB,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CACzE,CAAA;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,4DAA4D;QAC5D,IAAI,IAAI,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;YACxC,MAAM,IAAI,GAAI,IAA6B,CAAC,UAAU,CAAA;YACtD,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC/B,KAAK,CAAC,IAAI,CAAC,IAAkB,CAAC,CAAA;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED,iFAAiF;AAEjF,SAAS,eAAe,CAAC,EAAc,EAAE,KAAa;IACpD,MAAM,QAAQ,GAAG,EAAE,CAAC,cAAc,CAAC,IAAI,CAAA;IACvC,MAAM,IAAI,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAA;IACtC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IAEtB,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;IAChC,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,EAAE,KAAK,CAAC,CAAA;IAExD,MAAM,KAAK,GAAG,iBAAiB,CAAC,EAAE,CAAC,cAAc,CAAC,UAAU,CAAC,CAAA;IAC7D,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;IAErD,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ;SACzB,MAAM,CAAC,CAAC,CAAC,EAAmB,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC;SACvD,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;SAC5C,MAAM,CAAC,CAAC,CAAC,EAAmB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAA;IAE7C,MAAM,IAAI,GAAa;QACrB,YAAY,EAAE,IAAI;QAClB,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACrE,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,SAAS,IAAI;YACtC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;SACpE,CAAC;KACH,CAAA;IAED,MAAM,IAAI,GAAe;QACvB,EAAE,EAAE,MAAM;QACV,IAAI;QACJ,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,CAAC;QACzC,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;QACxC,IAAI;KACL,CAAA;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED,gFAAgF;AAEhF,SAAS,iBAAiB,CACxB,KAAiD;IAEjD,MAAM,MAAM,GAA4B,EAAE,CAAA;IAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc;YAAE,SAAQ;QAC1C,MAAM,OAAO,GAAG,IAAoB,CAAA;QACpC,MAAM,GAAG,GAAG,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,IAAI,OAAO,CAAC,IAAI;YACpE,CAAC,CAAC,MAAM,CAAE,OAAO,CAAC,IAAsB,CAAC,IAAI,CAAC;YAC9C,CAAC,CAAC,EAAE,CAAA;QACN,IAAI,CAAC,GAAG;YAAE,SAAQ;QAElB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAA;QACzB,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;QACpB,CAAC;aAAM,IAAI,GAAG,EAAE,IAAI,KAAK,eAAe,EAAE,CAAC;YACzC,MAAM,CAAC,GAAG,CAAC,GAAI,GAAqB,CAAC,KAAK,CAAA;QAC5C,CAAC;aAAM,IAAI,GAAG,EAAE,IAAI,KAAK,wBAAwB,EAAE,CAAC;YAClD,MAAM,IAAI,GAAI,GAA8B,CAAC,UAAU,CAAA;YACvD,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBAClC,MAAM,CAAC,GAAG,CAAC,GAAI,IAAsB,CAAC,KAAK,CAAA;YAC7C,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBAC1C,MAAM,CAAC,GAAG,CAAC,GAAI,IAA0B,CAAC,KAAK,CAAA;YACjD,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBAC1C,MAAM,CAAC,GAAG,CAAC,GAAI,IAA2B,CAAC,KAAK,CAAA;YAClD,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,gFAAgF;AAEhF,SAAS,cAAc,CACrB,EAAc,EACd,IAAY,EACZ,IAAwB,EACxB,KAA8B;IAE9B,MAAM,WAAW,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAA;IAE1C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAA;YAC7D,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,CAAA;QAC3E,CAAC;QAED,KAAK,MAAM;YACT,OAAO,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;QAEtE,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAuB,CAAA;YAC9C,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAuB,CAAA;YAC9C,IAAI,CAAC,GAAG;gBAAE,OAAO,SAAS,CAAA;YAC1B,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAA;QACnD,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAuB,CAAA;YAChD,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAuB,CAAA,CAAC,eAAe;YAC5D,MAAM,KAAK,GAAG,WAAW,CAAA;YACzB,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAuB,CAAA;YACxD,MAAM,MAAM,GAAG,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAA;YAC3D,OAAO;gBACL,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC;gBACrC,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,CAAC;gBACnC,GAAG,CAAC,EAAE,KAAK,SAAS,IAAI,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;gBAC9C,MAAM;aACP,CAAA;QACH,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,SAAS,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAClC,CAAC,CAAC,EAAmB,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAChD,CAAA;YACD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBACtC,EAAE,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;gBAChC,IAAI,EAAE,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE;aACnC,CAAC,CAAC,CAAA;YACH,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;QACjD,CAAC;QAED;YACE,OAAO,SAAS,CAAA;IACpB,CAAC;AACH,CAAC;AAED,iFAAiF;AAEjF,SAAS,kBAAkB,CAAC,EAAc;IACxC,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAI,KAA2B,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;YACtD,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5B,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,wBAAwB,EAAE,CAAC;YACnD,MAAM,IAAI,GAAI,KAAgC,CAAC,UAAU,CAAA;YACzD,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBAClC,KAAK,CAAC,IAAI,CAAE,IAAsB,CAAC,KAAK,CAAC,CAAA;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AACvC,CAAC;AAED,iFAAiF;AAEjF,SAAS,eAAe,CACtB,IAA6D;IAE7D,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe;QAAE,OAAO,IAAI,CAAC,IAAI,CAAA;IACnD,IAAI,IAAI,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACxC,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IACpD,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,KAAa;IACjD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC;SAC9B,MAAM,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC;SAC1B,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACd,OAAO,QAAQ,IAAI,EAAE,CAAA;AACvB,CAAC;AAED,SAAS,aAAa,CAAC,OAAgB;IACrC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC;SAC9B,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;SAC/B,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACd,OAAO,OAAO,IAAI,EAAE,CAAA;AACtB,CAAC"}

package/dist/core/mapper.d.ts

@@ -0,0 +1,52 @@
+/**
+ * MUCV — Tablas de mapeo source-type → VisualNodeType
+ * Cada parser usa estas tablas para convertir tipos de su formato
+ * al vocabulario universal del VIR.
+ *
+ * @see docs/VIR-SPEC.md §2
+ */
+import type { VisualNodeType } from './vir.js';
+/**
+ * Mapeo de `elType` de Elementor → VisualNodeType.
+ * Aplica a section, column y container (Elementor v3.6+).
+ */
+export declare const ELEMENTOR_ELTYPE_MAP: Readonly<Record<string, VisualNodeType>>;
+/**
+ * Mapeo de `widgetType` de Elementor → VisualNodeType.
+ * Aplica únicamente cuando `elType === 'widget'`.
+ */
+export declare const ELEMENTOR_WIDGET_MAP: Readonly<Record<string, VisualNodeType>>;
+/**
+ * Resuelve el VisualNodeType para un elemento Elementor.
+ * @param elType — valor de la propiedad `elType`
+ * @param widgetType — valor de la propiedad `widgetType` (solo si elType === 'widget')
+ */
+export declare function mapElementorType(elType: string, widgetType?: string): VisualNodeType;
+/**
+ * Mapeo de etiqueta HTML → VisualNodeType.
+ * Las etiquetas en minúsculas según el estándar HTML.
+ */
+export declare const HTML_TAG_MAP: Readonly<Record<string, VisualNodeType>>;
+/** Etiquetas que representan encabezados con nivel numérico. */
+export declare const HTML_HEADING_TAGS: Set<string>;
+/** Mapeo de etiqueta HTML → nivel de heading (1-6). */
+export declare const HTML_HEADING_LEVEL_MAP: Readonly<Record<string, 1 | 2 | 3 | 4 | 5 | 6>>;
+/**
+ * Resuelve el VisualNodeType para una etiqueta HTML.
+ * Tiene en cuenta el `display` CSS para detectar flex/grid.
+ * @param tag — etiqueta HTML en minúsculas
+ * @param cssDisplay — valor del atributo style display, si existe
+ */
+export declare function mapHtmlTag(tag: string, cssDisplay?: string): VisualNodeType;
+/**
+ * Mapeo de nombre de componente JSX (PascalCase o etiqueta nativa) → VisualNodeType.
+ * Los elementos JSX nativos siguen las mismas reglas que HTML.
+ * Los componentes PascalCase se tratan por nombre de componente.
+ */
+export declare const JSX_COMPONENT_MAP: Readonly<Record<string, VisualNodeType>>;
+/**
+ * Resuelve el VisualNodeType para un elemento JSX.
+ * Primero intenta los componentes PascalCase, luego las etiquetas nativas (lowercase).
+ */
+export declare function mapJsxElement(name: string): VisualNodeType;
+//# sourceMappingURL=mapper.d.ts.map

package/dist/core/mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../src/core/mapper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAI9C;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAIzE,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAWzE,CAAA;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,GAClB,cAAc,CAQhB;AAID;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAuBjE,CAAA;AAED,gEAAgE;AAChE,eAAO,MAAM,iBAAiB,aAAgD,CAAA;AAE9E,uDAAuD;AACvD,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAOlF,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,CAI3E;AAID;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAqBtE,CAAA;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAO1D"}

package/dist/core/mapper.js

@@ -0,0 +1,141 @@
+/**
+ * MUCV — Tablas de mapeo source-type → VisualNodeType
+ * Cada parser usa estas tablas para convertir tipos de su formato
+ * al vocabulario universal del VIR.
+ *
+ * @see docs/VIR-SPEC.md §2
+ */
+// ─── Elementor ────────────────────────────────────────────────────────────────
+/**
+ * Mapeo de `elType` de Elementor → VisualNodeType.
+ * Aplica a section, column y container (Elementor v3.6+).
+ */
+export const ELEMENTOR_ELTYPE_MAP = {
+    section: 'section',
+    column: 'container',
+    container: 'container',
+};
+/**
+ * Mapeo de `widgetType` de Elementor → VisualNodeType.
+ * Aplica únicamente cuando `elType === 'widget'`.
+ */
+export const ELEMENTOR_WIDGET_MAP = {
+    heading: 'heading',
+    'text-editor': 'text',
+    image: 'image',
+    button: 'button',
+    'icon-list': 'list',
+    video: 'custom',
+    spacer: 'custom',
+    divider: 'custom',
+    'wp-widget-recent-posts': 'list',
+    'wp-widget-categories': 'list',
+};
+/**
+ * Resuelve el VisualNodeType para un elemento Elementor.
+ * @param elType — valor de la propiedad `elType`
+ * @param widgetType — valor de la propiedad `widgetType` (solo si elType === 'widget')
+ */
+export function mapElementorType(elType, widgetType) {
+    if (elType !== 'widget') {
+        return ELEMENTOR_ELTYPE_MAP[elType] ?? 'custom';
+    }
+    if (widgetType !== undefined) {
+        return ELEMENTOR_WIDGET_MAP[widgetType] ?? 'custom';
+    }
+    return 'custom';
+}
+// ─── HTML ─────────────────────────────────────────────────────────────────────
+/**
+ * Mapeo de etiqueta HTML → VisualNodeType.
+ * Las etiquetas en minúsculas según el estándar HTML.
+ */
+export const HTML_TAG_MAP = {
+    section: 'section',
+    article: 'section',
+    main: 'section',
+    header: 'section',
+    footer: 'section',
+    nav: 'container',
+    div: 'container',
+    h1: 'heading',
+    h2: 'heading',
+    h3: 'heading',
+    h4: 'heading',
+    h5: 'heading',
+    h6: 'heading',
+    p: 'text',
+    span: 'text',
+    blockquote: 'text',
+    img: 'image',
+    picture: 'image',
+    a: 'button',
+    button: 'button',
+    ul: 'list',
+    ol: 'list',
+};
+/** Etiquetas que representan encabezados con nivel numérico. */
+export const HTML_HEADING_TAGS = new Set(['h1', 'h2', 'h3', 'h4', 'h5', 'h6']);
+/** Mapeo de etiqueta HTML → nivel de heading (1-6). */
+export const HTML_HEADING_LEVEL_MAP = {
+    h1: 1,
+    h2: 2,
+    h3: 3,
+    h4: 4,
+    h5: 5,
+    h6: 6,
+};
+/**
+ * Resuelve el VisualNodeType para una etiqueta HTML.
+ * Tiene en cuenta el `display` CSS para detectar flex/grid.
+ * @param tag — etiqueta HTML en minúsculas
+ * @param cssDisplay — valor del atributo style display, si existe
+ */
+export function mapHtmlTag(tag, cssDisplay) {
+    if (cssDisplay === 'flex')
+        return 'flex';
+    if (cssDisplay === 'grid')
+        return 'grid';
+    return HTML_TAG_MAP[tag.toLowerCase()] ?? 'custom';
+}
+// ─── JSX ─────────────────────────────────────────────────────────────────────
+/**
+ * Mapeo de nombre de componente JSX (PascalCase o etiqueta nativa) → VisualNodeType.
+ * Los elementos JSX nativos siguen las mismas reglas que HTML.
+ * Los componentes PascalCase se tratan por nombre de componente.
+ */
+export const JSX_COMPONENT_MAP = {
+    Section: 'section',
+    Hero: 'section',
+    Header: 'section',
+    Footer: 'section',
+    Article: 'section',
+    Container: 'container',
+    Wrapper: 'container',
+    Box: 'container',
+    Flex: 'flex',
+    Grid: 'grid',
+    Heading: 'heading',
+    Title: 'heading',
+    Text: 'text',
+    Paragraph: 'text',
+    Image: 'image',
+    Img: 'image',
+    Button: 'button',
+    Link: 'button',
+    List: 'list',
+    ListItem: 'custom',
+};
+/**
+ * Resuelve el VisualNodeType para un elemento JSX.
+ * Primero intenta los componentes PascalCase, luego las etiquetas nativas (lowercase).
+ */
+export function mapJsxElement(name) {
+    // Componente PascalCase
+    if (name[0] === name[0]?.toUpperCase() && name[0] !== name[0]?.toLowerCase()) {
+        return JSX_COMPONENT_MAP[name] ?? 'custom';
+    }
+    // Etiqueta nativa HTML
+    return HTML_TAG_MAP[name.toLowerCase()] ?? 'custom';
+}
+//# sourceMappingURL=mapper.js.map

package/dist/core/mapper.js.map

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

package/dist/core/normalizer.d.ts

@@ -0,0 +1,57 @@
+/**
+ * MUCV — Normalizer
+ * Funciones de normalización de estilos y contenido.
+ * Los parsers las usan para producir StyleConfig y ContentConfig
+ * compatibles con el schema Zod del VIR.
+ *
+ * @see docs/VIR-SPEC.md §3
+ */
+import type { BoxModel, StyleConfig, TypographyConfig, BackgroundConfig } from './vir.js';
+/**
+ * Normaliza un valor de tamaño de Elementor `{ size, unit }` a string CSS.
+ * @example normalizeSizeValue({ size: 48, unit: 'px' }) → "48px"
+ */
+export declare function normalizeSizeValue(raw: unknown): string | undefined;
+/**
+ * Normaliza un objeto de Elementor con propiedades top/right/bottom/left a BoxModel.
+ * Soporta el formato `{ top, right, bottom, left, unit }` de Elementor.
+ */
+export declare function normalizeBoxModel(raw: unknown): BoxModel | undefined;
+/**
+ * Normaliza un valor de color a string CSS.
+ * Acepta: hex (#fff, #ffffff), rgb(), rgba(), nombres CSS, variables CSS.
+ * Expande hex corto #fff → #ffffff.
+ */
+export declare function normalizeColor(raw: unknown): string | undefined;
+/**
+ * Extrae y normaliza la configuración tipográfica de los settings de Elementor.
+ */
+export declare function normalizeTypographyFromElementor(settings: Record<string, unknown>): TypographyConfig | undefined;
+/**
+ * Extrae y normaliza el background de los settings de Elementor.
+ */
+export declare function normalizeBackgroundFromElementor(settings: Record<string, unknown>): BackgroundConfig | undefined;
+/**
+ * Extrae padding de los settings de Elementor.
+ * Soporta `padding` (objeto) y `_padding` (nombre alternativo).
+ */
+export declare function normalizePaddingFromElementor(settings: Record<string, unknown>): BoxModel | undefined;
+/**
+ * Extrae margin de los settings de Elementor.
+ */
+export declare function normalizeMarginFromElementor(settings: Record<string, unknown>): BoxModel | undefined;
+/**
+ * Construye un StyleConfig desde los settings de Elementor.
+ * Solo incluye propiedades que tienen valor definido.
+ */
+export declare function buildStyleFromElementor(settings: Record<string, unknown>): StyleConfig | undefined;
+/**
+ * Construye un StyleConfig desde atributos de un elemento HTML.
+ * Parsea el atributo `style` inline y clases para detectar layout.
+ */
+export declare function buildStyleFromHtml(inlineStyle: string | undefined, _classNames: string[]): StyleConfig | undefined;
+/** Elimina etiquetas HTML de un string de texto. */
+export declare function stripHtmlTags(raw: string): string;
+/** Limpia y normaliza un string de texto plano. */
+export declare function normalizeText(raw: unknown): string | undefined;
+//# sourceMappingURL=normalizer.d.ts.map

package/dist/core/normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../src/core/normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,UAAU,CAAA;AAIjB;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,GACX,MAAM,GAAG,SAAS,CAcpB;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,GACX,QAAQ,GAAG,SAAS,CAmCtB;AAID;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAmB/D;AAID;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,gBAAgB,GAAG,SAAS,CA2B9B;AAkCD;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,gBAAgB,GAAG,SAAS,CAY9B;AAID;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,QAAQ,GAAG,SAAS,CAEtB;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,QAAQ,GAAG,SAAS,CAEtB;AAID;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW,GAAG,SAAS,CAkBzB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,WAAW,EAAE,MAAM,EAAE,GACpB,WAAW,GAAG,SAAS,CA2CzB;AAID,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,mDAAmD;AACnD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI9D"}