@stevenvo780/st-lang 3.2.3 → 4.0.1

package/dist/ast/visitor.d.ts

@@ -0,0 +1,95 @@
+import { Statement, Program, LogicDeclNode, AxiomDeclNode, TheoremDeclNode, DeriveCmdNode, CheckValidCmdNode, CheckSatisfiableCmdNode, CheckEquivalentCmdNode, ProveCmdNode, CountermodelCmdNode, TruthTableCmdNode, LetDeclNode, ClaimDeclNode, SupportDeclNode, ConfidenceDeclNode, ContextDeclNode, RenderCmdNode, AnalyzeCmdNode, ExplainCmdNode, ImportDeclNode, ProofBlockNode, TheoryDeclNode, PrintCmdNode, SetCmdNode, IfStmtNode, ForStmtNode, WhileStmtNode, FnDeclNode, ReturnStmtNode, FnCallNode, ExportDeclNode, DefineDeclNode, UnfoldCmdNode, FoldCmdNode, SourceDeclNode, InterpretCmdNode, GlossaryCmdNode } from './nodes';
+export interface ASTVisitor<T> {
+    visitLogicDecl(node: LogicDeclNode): T;
+    visitAxiomDecl(node: AxiomDeclNode): T;
+    visitTheoremDecl(node: TheoremDeclNode): T;
+    visitDeriveCmd(node: DeriveCmdNode): T;
+    visitCheckValidCmd(node: CheckValidCmdNode): T;
+    visitCheckSatisfiableCmd(node: CheckSatisfiableCmdNode): T;
+    visitCheckEquivalentCmd(node: CheckEquivalentCmdNode): T;
+    visitProveCmd(node: ProveCmdNode): T;
+    visitCountermodelCmd(node: CountermodelCmdNode): T;
+    visitTruthTableCmd(node: TruthTableCmdNode): T;
+    visitLetDecl(node: LetDeclNode): T;
+    visitClaimDecl(node: ClaimDeclNode): T;
+    visitSupportDecl(node: SupportDeclNode): T;
+    visitConfidenceDecl(node: ConfidenceDeclNode): T;
+    visitContextDecl(node: ContextDeclNode): T;
+    visitRenderCmd(node: RenderCmdNode): T;
+    visitAnalyzeCmd(node: AnalyzeCmdNode): T;
+    visitExplainCmd(node: ExplainCmdNode): T;
+    visitImportDecl(node: ImportDeclNode): T;
+    visitProofBlock(node: ProofBlockNode): T;
+    visitTheoryDecl(node: TheoryDeclNode): T;
+    visitPrintCmd(node: PrintCmdNode): T;
+    visitSetCmd(node: SetCmdNode): T;
+    visitIfStmt(node: IfStmtNode): T;
+    visitForStmt(node: ForStmtNode): T;
+    visitWhileStmt(node: WhileStmtNode): T;
+    visitFnDecl(node: FnDeclNode): T;
+    visitReturnStmt(node: ReturnStmtNode): T;
+    visitFnCall(node: FnCallNode): T;
+    visitExportDecl(node: ExportDeclNode): T;
+    visitDefineDecl(node: DefineDeclNode): T;
+    visitUnfoldCmd(node: UnfoldCmdNode): T;
+    visitFoldCmd(node: FoldCmdNode): T;
+    visitSourceDecl(node: SourceDeclNode): T;
+    visitInterpretCmd(node: InterpretCmdNode): T;
+    visitGlossaryCmd(node: GlossaryCmdNode): T;
+}
+/**
+ * Dispatch tipado: rutea un `Statement` al metodo correspondiente del visitor.
+ * Exhaustivo por discriminated union — si se agrega un kind nuevo,
+ * TypeScript marca el switch como incompleto.
+ */
+export declare function visit<T>(node: Statement, visitor: ASTVisitor<T>): T;
+/**
+ * Recorre todos los statements de un programa aplicando el visitor.
+ * Devuelve la lista de resultados.
+ */
+export declare function visitProgram<T>(program: Program, visitor: ASTVisitor<T>): T[];
+/**
+ * Visitor base con default a `undefined`. Subclases sobrescriben solo
+ * los metodos que les interesan. Util para herramientas que solo se
+ * preocupan por algunos kinds (ej: linter que solo mira theory_decl).
+ */
+export declare abstract class BaseASTVisitor<T> implements ASTVisitor<T> {
+    protected abstract defaultResult(node: Statement): T;
+    visitLogicDecl(node: LogicDeclNode): T;
+    visitAxiomDecl(node: AxiomDeclNode): T;
+    visitTheoremDecl(node: TheoremDeclNode): T;
+    visitDeriveCmd(node: DeriveCmdNode): T;
+    visitCheckValidCmd(node: CheckValidCmdNode): T;
+    visitCheckSatisfiableCmd(node: CheckSatisfiableCmdNode): T;
+    visitCheckEquivalentCmd(node: CheckEquivalentCmdNode): T;
+    visitProveCmd(node: ProveCmdNode): T;
+    visitCountermodelCmd(node: CountermodelCmdNode): T;
+    visitTruthTableCmd(node: TruthTableCmdNode): T;
+    visitLetDecl(node: LetDeclNode): T;
+    visitClaimDecl(node: ClaimDeclNode): T;
+    visitSupportDecl(node: SupportDeclNode): T;
+    visitConfidenceDecl(node: ConfidenceDeclNode): T;
+    visitContextDecl(node: ContextDeclNode): T;
+    visitRenderCmd(node: RenderCmdNode): T;
+    visitAnalyzeCmd(node: AnalyzeCmdNode): T;
+    visitExplainCmd(node: ExplainCmdNode): T;
+    visitImportDecl(node: ImportDeclNode): T;
+    visitProofBlock(node: ProofBlockNode): T;
+    visitTheoryDecl(node: TheoryDeclNode): T;
+    visitPrintCmd(node: PrintCmdNode): T;
+    visitSetCmd(node: SetCmdNode): T;
+    visitIfStmt(node: IfStmtNode): T;
+    visitForStmt(node: ForStmtNode): T;
+    visitWhileStmt(node: WhileStmtNode): T;
+    visitFnDecl(node: FnDeclNode): T;
+    visitReturnStmt(node: ReturnStmtNode): T;
+    visitFnCall(node: FnCallNode): T;
+    visitExportDecl(node: ExportDeclNode): T;
+    visitDefineDecl(node: DefineDeclNode): T;
+    visitUnfoldCmd(node: UnfoldCmdNode): T;
+    visitFoldCmd(node: FoldCmdNode): T;
+    visitSourceDecl(node: SourceDeclNode): T;
+    visitInterpretCmd(node: InterpretCmdNode): T;
+    visitGlossaryCmd(node: GlossaryCmdNode): T;
+}
+//# sourceMappingURL=visitor.d.ts.map

package/dist/ast/visitor.d.ts.map

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

package/dist/ast/visitor.js

@@ -0,0 +1,223 @@
+"use strict";
+// ============================================================
+// ST AST — Visitor pattern tipado
+// ============================================================
+//
+// Define `ASTVisitor<T>` y un dispatcher `visit(node, visitor)`
+// para consumir el AST sin escribir un switch enorme cada vez.
+// Es opcional: el interprete actual sigue usando switch directo.
+// Este modulo existe para que consumidores nuevos (linter,
+// formatter, type-checker, etc.) tengan una API uniforme.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseASTVisitor = void 0;
+exports.visit = visit;
+exports.visitProgram = visitProgram;
+/**
+ * Dispatch tipado: rutea un `Statement` al metodo correspondiente del visitor.
+ * Exhaustivo por discriminated union — si se agrega un kind nuevo,
+ * TypeScript marca el switch como incompleto.
+ */
+function visit(node, visitor) {
+    switch (node.kind) {
+        case 'logic_decl':
+            return visitor.visitLogicDecl(node);
+        case 'axiom_decl':
+            return visitor.visitAxiomDecl(node);
+        case 'theorem_decl':
+            return visitor.visitTheoremDecl(node);
+        case 'derive_cmd':
+            return visitor.visitDeriveCmd(node);
+        case 'check_valid_cmd':
+            return visitor.visitCheckValidCmd(node);
+        case 'check_satisfiable_cmd':
+            return visitor.visitCheckSatisfiableCmd(node);
+        case 'check_equivalent_cmd':
+            return visitor.visitCheckEquivalentCmd(node);
+        case 'prove_cmd':
+            return visitor.visitProveCmd(node);
+        case 'countermodel_cmd':
+            return visitor.visitCountermodelCmd(node);
+        case 'truth_table_cmd':
+            return visitor.visitTruthTableCmd(node);
+        case 'let_decl':
+            return visitor.visitLetDecl(node);
+        case 'claim_decl':
+            return visitor.visitClaimDecl(node);
+        case 'support_decl':
+            return visitor.visitSupportDecl(node);
+        case 'confidence_decl':
+            return visitor.visitConfidenceDecl(node);
+        case 'context_decl':
+            return visitor.visitContextDecl(node);
+        case 'render_cmd':
+            return visitor.visitRenderCmd(node);
+        case 'analyze_cmd':
+            return visitor.visitAnalyzeCmd(node);
+        case 'explain_cmd':
+            return visitor.visitExplainCmd(node);
+        case 'import_decl':
+            return visitor.visitImportDecl(node);
+        case 'proof_block':
+            return visitor.visitProofBlock(node);
+        case 'theory_decl':
+            return visitor.visitTheoryDecl(node);
+        case 'print_cmd':
+            return visitor.visitPrintCmd(node);
+        case 'set_cmd':
+            return visitor.visitSetCmd(node);
+        case 'if_stmt':
+            return visitor.visitIfStmt(node);
+        case 'for_stmt':
+            return visitor.visitForStmt(node);
+        case 'while_stmt':
+            return visitor.visitWhileStmt(node);
+        case 'fn_decl':
+            return visitor.visitFnDecl(node);
+        case 'return_stmt':
+            return visitor.visitReturnStmt(node);
+        case 'fn_call':
+            return visitor.visitFnCall(node);
+        case 'export_decl':
+            return visitor.visitExportDecl(node);
+        case 'define_decl':
+            return visitor.visitDefineDecl(node);
+        case 'unfold_cmd':
+            return visitor.visitUnfoldCmd(node);
+        case 'fold_cmd':
+            return visitor.visitFoldCmd(node);
+        case 'source_decl':
+            return visitor.visitSourceDecl(node);
+        case 'interpret_cmd':
+            return visitor.visitInterpretCmd(node);
+        case 'glossary_cmd':
+            return visitor.visitGlossaryCmd(node);
+        default: {
+            const _exhaustive = node;
+            throw new Error(`visit: kind no manejado en switch exhaustivo: ${JSON.stringify(_exhaustive)}`);
+        }
+    }
+}
+/**
+ * Recorre todos los statements de un programa aplicando el visitor.
+ * Devuelve la lista de resultados.
+ */
+function visitProgram(program, visitor) {
+    return program.statements.map((stmt) => visit(stmt, visitor));
+}
+/**
+ * Visitor base con default a `undefined`. Subclases sobrescriben solo
+ * los metodos que les interesan. Util para herramientas que solo se
+ * preocupan por algunos kinds (ej: linter que solo mira theory_decl).
+ */
+class BaseASTVisitor {
+    visitLogicDecl(node) {
+        return this.defaultResult(node);
+    }
+    visitAxiomDecl(node) {
+        return this.defaultResult(node);
+    }
+    visitTheoremDecl(node) {
+        return this.defaultResult(node);
+    }
+    visitDeriveCmd(node) {
+        return this.defaultResult(node);
+    }
+    visitCheckValidCmd(node) {
+        return this.defaultResult(node);
+    }
+    visitCheckSatisfiableCmd(node) {
+        return this.defaultResult(node);
+    }
+    visitCheckEquivalentCmd(node) {
+        return this.defaultResult(node);
+    }
+    visitProveCmd(node) {
+        return this.defaultResult(node);
+    }
+    visitCountermodelCmd(node) {
+        return this.defaultResult(node);
+    }
+    visitTruthTableCmd(node) {
+        return this.defaultResult(node);
+    }
+    visitLetDecl(node) {
+        return this.defaultResult(node);
+    }
+    visitClaimDecl(node) {
+        return this.defaultResult(node);
+    }
+    visitSupportDecl(node) {
+        return this.defaultResult(node);
+    }
+    visitConfidenceDecl(node) {
+        return this.defaultResult(node);
+    }
+    visitContextDecl(node) {
+        return this.defaultResult(node);
+    }
+    visitRenderCmd(node) {
+        return this.defaultResult(node);
+    }
+    visitAnalyzeCmd(node) {
+        return this.defaultResult(node);
+    }
+    visitExplainCmd(node) {
+        return this.defaultResult(node);
+    }
+    visitImportDecl(node) {
+        return this.defaultResult(node);
+    }
+    visitProofBlock(node) {
+        return this.defaultResult(node);
+    }
+    visitTheoryDecl(node) {
+        return this.defaultResult(node);
+    }
+    visitPrintCmd(node) {
+        return this.defaultResult(node);
+    }
+    visitSetCmd(node) {
+        return this.defaultResult(node);
+    }
+    visitIfStmt(node) {
+        return this.defaultResult(node);
+    }
+    visitForStmt(node) {
+        return this.defaultResult(node);
+    }
+    visitWhileStmt(node) {
+        return this.defaultResult(node);
+    }
+    visitFnDecl(node) {
+        return this.defaultResult(node);
+    }
+    visitReturnStmt(node) {
+        return this.defaultResult(node);
+    }
+    visitFnCall(node) {
+        return this.defaultResult(node);
+    }
+    visitExportDecl(node) {
+        return this.defaultResult(node);
+    }
+    visitDefineDecl(node) {
+        return this.defaultResult(node);
+    }
+    visitUnfoldCmd(node) {
+        return this.defaultResult(node);
+    }
+    visitFoldCmd(node) {
+        return this.defaultResult(node);
+    }
+    visitSourceDecl(node) {
+        return this.defaultResult(node);
+    }
+    visitInterpretCmd(node) {
+        return this.defaultResult(node);
+    }
+    visitGlossaryCmd(node) {
+        return this.defaultResult(node);
+    }
+}
+exports.BaseASTVisitor = BaseASTVisitor;
+//# sourceMappingURL=visitor.js.map

package/dist/ast/visitor.js.map

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

package/dist/citation-reasoning/derive.d.ts

@@ -0,0 +1,31 @@
+import type { CitedClaim, CitationDerivation, CitationDerivationResult } from './types';
+/**
+ * Evaluador externo que el caller provee.
+ * Recibe premisas (en orden: citadas primero, luego locales), el goal y el
+ * perfil lógico dominante; devuelve { valid, proof? }.
+ */
+export type Evaluator = (premises: string[], goal: string, profile: string) => Promise<{
+    valid: boolean;
+    proof?: unknown;
+}>;
+/**
+ * Ejecuta una derivación que combina premisas de documentos externos (citations)
+ * con premisas locales para intentar demostrar `goal`.
+ *
+ * Contrato:
+ * - Las citas se ordenan por `weight` descendente (mayor peso = premisa más
+ *   fuerte primero). Empates se resuelven por `id` lexicográfico.
+ * - El evaluador recibe: [...formulas_citadas_ordenadas, ...localPremises].
+ * - Si no hay citas, la derivación es puramente local.
+ * - La traza incluye un paso por cada citación y uno por cada premisa local,
+ *   más el paso de conclusión.
+ */
+export declare function deriveWithCitations(derivation: CitationDerivation, evaluator: Evaluator): Promise<CitationDerivationResult>;
+/**
+ * Genera una explicación en lenguaje natural de una prueba formal,
+ * referenciando las citas que participaron como premisas.
+ *
+ * Si `proof` es null/undefined devuelve un mensaje genérico.
+ */
+export declare function explainProof(proof: unknown, citations: CitedClaim[]): string;
+//# sourceMappingURL=derive.d.ts.map

package/dist/citation-reasoning/derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../../src/citation-reasoning/derive.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,wBAAwB,EAEzB,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,CACtB,QAAQ,EAAE,MAAM,EAAE,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,KACZ,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAoBlD;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,kBAAkB,EAC9B,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,wBAAwB,CAAC,CAiDnC;AAuED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,MAAM,CAmC5E"}

package/dist/citation-reasoning/derive.js

@@ -0,0 +1,157 @@
+"use strict";
+// ============================================================
+// ST Citation Reasoning — deriveWithCitations + explainProof
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveWithCitations = deriveWithCitations;
+exports.explainProof = explainProof;
+/**
+ * Escoge el perfil dominante de la derivación.
+ * Si todas las citas comparten el mismo perfil, se usa ese.
+ * Si hay mezcla (o no hay citas), se cae a 'classical.propositional'.
+ */
+function dominantProfile(citations, localFallback = 'classical.propositional') {
+    if (citations.length === 0)
+        return localFallback;
+    const profiles = new Set(citations.map((c) => c.profile));
+    if (profiles.size === 1) {
+        const first = citations[0];
+        return first !== undefined ? first.profile : localFallback;
+    }
+    return localFallback;
+}
+/**
+ * Ejecuta una derivación que combina premisas de documentos externos (citations)
+ * con premisas locales para intentar demostrar `goal`.
+ *
+ * Contrato:
+ * - Las citas se ordenan por `weight` descendente (mayor peso = premisa más
+ *   fuerte primero). Empates se resuelven por `id` lexicográfico.
+ * - El evaluador recibe: [...formulas_citadas_ordenadas, ...localPremises].
+ * - Si no hay citas, la derivación es puramente local.
+ * - La traza incluye un paso por cada citación y uno por cada premisa local,
+ *   más el paso de conclusión.
+ */
+async function deriveWithCitations(derivation, evaluator) {
+    const { goal, citations, localPremises } = derivation;
+    // Ordenar citas: peso descendente, desempate por id ascendente.
+    const sortedCitations = [...citations].sort((a, b) => {
+        const wa = a.weight ?? 1;
+        const wb = b.weight ?? 1;
+        if (wb !== wa)
+            return wb - wa;
+        return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+    });
+    const profile = dominantProfile(sortedCitations);
+    const allPremises = [...sortedCitations.map((c) => c.formula), ...localPremises];
+    // Construir traza antes de llamar al evaluador.
+    const trace = [];
+    for (const c of sortedCitations) {
+        trace.push({
+            step: `premisa citada: ${c.formula}`,
+            cite: `${c.docId}#${c.id}`,
+        });
+    }
+    for (const p of localPremises) {
+        trace.push({ step: `premisa local: ${p}` });
+    }
+    const evalResult = await evaluator(allPremises, goal, profile);
+    const valid = evalResult.valid;
+    const proof = evalResult.proof;
+    // Paso de conclusión.
+    trace.push({
+        step: valid
+            ? `conclusión: ${goal} (válida)`
+            : `conclusión: ${goal} (no derivable con las premisas dadas)`,
+    });
+    const explanation = buildExplanation({
+        valid,
+        goal,
+        sortedCitations,
+        localPremises,
+        profile,
+        proof,
+    });
+    return { valid, trace, explanation };
+}
+function buildExplanation(ctx) {
+    const { valid, goal, sortedCitations, localPremises, profile, proof } = ctx;
+    const parts = [];
+    if (sortedCitations.length === 0 && localPremises.length === 0) {
+        parts.push(`No se proveyeron premisas (ni citadas ni locales). No es posible derivar "${goal}".`);
+        return parts.join(' ');
+    }
+    if (sortedCitations.length > 0) {
+        const citeDesc = sortedCitations
+            .map((c) => `"${c.formula}" (de ${c.docId}#${c.id})`)
+            .join(', ');
+        parts.push(`Premisas citadas: ${citeDesc}.`);
+    }
+    else {
+        parts.push('Sin premisas citadas; derivación puramente local.');
+    }
+    if (localPremises.length > 0) {
+        parts.push(`Premisas locales: ${localPremises.join(', ')}.`);
+    }
+    parts.push(`Perfil lógico utilizado: ${profile}.`);
+    parts.push(`Objetivo: "${goal}".`);
+    if (valid) {
+        const proofNote = proof !== undefined ? ' Prueba formal disponible.' : '';
+        parts.push(`Resultado: VÁLIDO.${proofNote}`);
+    }
+    else {
+        parts.push(`Resultado: NO VÁLIDO. El objetivo no es derivable desde las premisas proporcionadas.`);
+        // Si hay citas sin peso o con weight=0, advertir.
+        const unweighted = sortedCitations.filter((c) => (c.weight ?? 1) === 0);
+        if (unweighted.length > 0) {
+            const ids = unweighted.map((c) => `${c.docId}#${c.id}`).join(', ');
+            parts.push(`ADVERTENCIA: las siguientes citas tienen peso 0 y pueden no aportar fuerza epistémica: ${ids}.`);
+        }
+        // Advertir citas que individualmente no son válidas según el proof.
+        if (sortedCitations.length > 0) {
+            parts.push('ADVERTENCIA: una o más premisas citadas pueden no estar probadas en su contexto original.');
+        }
+    }
+    return parts.join(' ');
+}
+/**
+ * Genera una explicación en lenguaje natural de una prueba formal,
+ * referenciando las citas que participaron como premisas.
+ *
+ * Si `proof` es null/undefined devuelve un mensaje genérico.
+ */
+function explainProof(proof, citations) {
+    if (proof === null || proof === undefined) {
+        return 'No hay prueba formal disponible para explicar.';
+    }
+    const parts = ['Resumen de la prueba:'];
+    if (citations.length > 0) {
+        const citeSummary = citations
+            .map((c) => `  - [${c.docId}#${c.id}] "${c.formula}" (perfil: ${c.profile})`)
+            .join('\n');
+        parts.push(`Premisas externas utilizadas:\n${citeSummary}`);
+    }
+    else {
+        parts.push('No se utilizaron premisas externas (derivación local).');
+    }
+    // Intentar mostrar pasos si el proof tiene forma conocida.
+    if (typeof proof === 'object' && proof !== null && 'steps' in proof) {
+        const steps = proof.steps;
+        if (Array.isArray(steps) && steps.length > 0) {
+            const stepsDesc = steps
+                .map((s, i) => {
+                if (typeof s === 'object' && s !== null && 'formula' in s) {
+                    return `  ${i + 1}. ${String(s.formula)}`;
+                }
+                return `  ${i + 1}. ${String(s)}`;
+            })
+                .join('\n');
+            parts.push(`Pasos formales:\n${stepsDesc}`);
+        }
+    }
+    else {
+        parts.push(`Datos de la prueba: ${JSON.stringify(proof)}`);
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=derive.js.map

package/dist/citation-reasoning/derive.js.map

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

package/dist/citation-reasoning/index.d.ts

@@ -0,0 +1,4 @@
+export type { CitedClaim, CitationDerivation, CitationDerivationResult, DerivationStep, } from './types';
+export { deriveWithCitations, explainProof } from './derive';
+export type { Evaluator } from './derive';
+//# sourceMappingURL=index.d.ts.map

package/dist/citation-reasoning/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/citation-reasoning/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,UAAU,EACV,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7D,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}

package/dist/citation-reasoning/index.js

@@ -0,0 +1,10 @@
+"use strict";
+// ============================================================
+// ST Citation Reasoning — Punto de entrada público
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.explainProof = exports.deriveWithCitations = void 0;
+var derive_1 = require("./derive");
+Object.defineProperty(exports, "deriveWithCitations", { enumerable: true, get: function () { return derive_1.deriveWithCitations; } });
+Object.defineProperty(exports, "explainProof", { enumerable: true, get: function () { return derive_1.explainProof; } });
+//# sourceMappingURL=index.js.map

package/dist/citation-reasoning/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/citation-reasoning/index.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,mDAAmD;AACnD,+DAA+D;;;AAQ/D,mCAA6D;AAApD,6GAAA,mBAAmB,OAAA;AAAE,sGAAA,YAAY,OAAA"}

package/dist/citation-reasoning/types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Premisa externa extraída de otro documento (cross-doc citation).
+ * Representa un teorema, axioma o claim citado desde docId.
+ */
+export interface CitedClaim {
+    id: string;
+    docId: string;
+    formula: string;
+    profile: string;
+    weight?: number;
+}
+/**
+ * Descripción de una derivación que combina premisas locales
+ * con premisas citadas de documentos externos.
+ */
+export interface CitationDerivation {
+    goal: string;
+    citations: CitedClaim[];
+    localPremises: string[];
+}
+/**
+ * Un paso individual en la traza de la derivación.
+ */
+export interface DerivationStep {
+    step: string;
+    cite?: string;
+}
+/**
+ * Resultado de deriveWithCitations.
+ */
+export interface CitationDerivationResult {
+    valid: boolean;
+    trace: DerivationStep[];
+    explanation: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/citation-reasoning/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/citation-reasoning/types.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,UAAU,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/citation-reasoning/types.js

@@ -0,0 +1,6 @@
+"use strict";
+// ============================================================
+// ST Citation Reasoning — Tipos base
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/citation-reasoning/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/citation-reasoning/types.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,qCAAqC;AACrC,+DAA+D"}

package/dist/educational/checker.d.ts

@@ -0,0 +1,3 @@
+import { AnswerResult, Exercise, StudentAnswer } from './types';
+export declare function checkAnswer(exercise: Exercise, studentAnswer: StudentAnswer): AnswerResult;
+//# sourceMappingURL=checker.d.ts.map

package/dist/educational/checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checker.d.ts","sourceRoot":"","sources":["../../src/educational/checker.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAgB,aAAa,EAAuB,MAAM,SAAS,CAAC;AA8NnG,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,GAAG,YAAY,CAoB1F"}