@grimoirelabs/core 0.1.0

package/dist/compiler/grimoire/ast.d.ts

@@ -0,0 +1,450 @@
+/**
+ * AST node types for the Grimoire syntax
+ */
+import type { SourceSpan } from "./errors.js";
+/** Base AST node with location info */
+export interface ASTNode {
+    span?: SourceSpan;
+}
+/** Complete spell AST */
+export interface SpellAST extends ASTNode {
+    kind: "spell";
+    name: string;
+    sections: SectionNode[];
+    triggers: TriggerHandler[];
+    imports: ImportNode[];
+    blocks: BlockDef[];
+}
+/** Section node types */
+export type SectionNode = VersionSection | DescriptionSection | AssetsSection | ParamsSection | LimitsSection | VenuesSection | StateSection | SkillsSection | AdvisorsSection | GuardsSection;
+/** Version declaration */
+export interface VersionSection extends ASTNode {
+    kind: "version";
+    value: string;
+}
+/** Description section */
+export interface DescriptionSection extends ASTNode {
+    kind: "description";
+    value: string;
+}
+/** Assets section: assets: [USDC, USDT, DAI] or assets: { ... } */
+export interface AssetsSection extends ASTNode {
+    kind: "assets";
+    items: AssetItem[];
+}
+export interface AssetItem extends ASTNode {
+    symbol: string;
+    chain?: number;
+    address?: string;
+    decimals?: number;
+}
+/** Params section */
+export interface ParamsSection extends ASTNode {
+    kind: "params";
+    items: ParamItem[];
+}
+export interface ParamItem extends ASTNode {
+    name: string;
+    value?: ExpressionNode;
+    type?: "number" | "bool" | "address" | "asset" | "string" | "amount" | "bps" | "duration";
+    asset?: string;
+    min?: number;
+    max?: number;
+}
+/** Limits section */
+export interface LimitsSection extends ASTNode {
+    kind: "limits";
+    items: LimitItem[];
+}
+export interface LimitItem extends ASTNode {
+    name: string;
+    value: ExpressionNode;
+}
+/** Venues section */
+export interface VenuesSection extends ASTNode {
+    kind: "venues";
+    groups: VenueGroup[];
+}
+export interface VenueGroup extends ASTNode {
+    name: string;
+    venues: VenueRef[];
+}
+/** Venue reference: @aave_v3 */
+export interface VenueRef extends ASTNode {
+    kind: "venue_ref";
+    name: string;
+    chain?: number;
+    address?: string;
+}
+/** State section */
+export interface StateSection extends ASTNode {
+    kind: "state";
+    persistent: StateItem[];
+    ephemeral: StateItem[];
+}
+export interface StateItem extends ASTNode {
+    name: string;
+    initialValue: ExpressionNode;
+}
+/** Skills section */
+export interface SkillsSection extends ASTNode {
+    kind: "skills";
+    items: SkillItem[];
+}
+export interface SkillItem extends ASTNode {
+    name: string;
+    type: "swap" | "yield" | "lending" | "staking" | "bridge";
+    adapters: string[];
+    defaultConstraints?: {
+        maxSlippage?: ExpressionNode;
+    };
+}
+/** Advisors section */
+export interface AdvisorsSection extends ASTNode {
+    kind: "advisors";
+    items: AdvisorItem[];
+}
+export interface AdvisorItem extends ASTNode {
+    name: string;
+    model: string;
+    systemPrompt?: string;
+    skills?: string[];
+    allowedTools?: string[];
+    mcp?: string[];
+    timeout?: number;
+    fallback?: boolean;
+    maxPerRun?: number;
+    maxPerHour?: number;
+}
+/** Guards section */
+export interface GuardsSection extends ASTNode {
+    kind: "guards";
+    items: GuardItem[];
+}
+export interface GuardItem extends ASTNode {
+    id: string;
+    check: ExpressionNode | AdvisoryExpr;
+    severity: "warn" | "revert" | "halt" | "pause";
+    message?: string;
+    fallback?: boolean;
+}
+/** Trigger types */
+export type TriggerType = {
+    kind: "manual";
+} | {
+    kind: "schedule";
+    cron: string;
+} | {
+    kind: "hourly";
+} | {
+    kind: "daily";
+} | {
+    kind: "condition";
+    expression: ExpressionNode;
+    pollInterval?: number;
+} | {
+    kind: "event";
+    event: string;
+    filter?: ExpressionNode;
+};
+/** Trigger handler: on manual: / on hourly: etc */
+export interface TriggerHandler extends ASTNode {
+    kind: "trigger_handler";
+    trigger: TriggerType;
+    body: StatementNode[];
+}
+/** Statement node types */
+export type StatementNode = AssignmentNode | DoNode | IfNode | ForNode | RepeatNode | UntilNode | TryNode | ParallelNode | PipelineNode | AdviseNode | AtomicNode | MethodCallNode | EmitNode | HaltNode | WaitNode | AdvisoryNode | PassNode;
+/** Import declaration */
+export interface ImportNode extends ASTNode {
+    kind: "import";
+    path: string;
+    alias?: string;
+}
+/** Block definition */
+export interface BlockDef extends ASTNode {
+    kind: "block";
+    name: string;
+    params: string[];
+    body: StatementNode[];
+}
+/** Do (block invocation) */
+export interface DoNode extends ASTNode {
+    kind: "do";
+    name: string;
+    args: ExpressionNode[];
+}
+/** Repeat loop: repeat N: ... */
+export interface RepeatNode extends ASTNode {
+    kind: "repeat";
+    count: ExpressionNode;
+    body: StatementNode[];
+}
+/** Until loop: loop until <expr> max N: ... */
+export interface UntilNode extends ASTNode {
+    kind: "until";
+    condition: ExpressionNode;
+    maxIterations?: number;
+    body: StatementNode[];
+}
+/** Try/catch/finally */
+export interface TryNode extends ASTNode {
+    kind: "try";
+    tryBody: StatementNode[];
+    catches: CatchNode[];
+    finallyBody?: StatementNode[];
+}
+export interface CatchNode extends ASTNode {
+    kind: "catch";
+    error: string;
+    action?: "skip" | "halt" | "revert";
+    retry?: RetrySpec;
+    body: StatementNode[];
+}
+export interface RetrySpec extends ASTNode {
+    kind: "retry";
+    maxAttempts: number;
+    backoff: "none" | "linear" | "exponential";
+    backoffBase?: number;
+    maxBackoff?: number;
+}
+/** Parallel execution */
+export interface ParallelNode extends ASTNode {
+    kind: "parallel";
+    join?: ParallelJoinNode;
+    onFail?: "abort" | "continue";
+    branches: ParallelBranchNode[];
+}
+export interface ParallelBranchNode extends ASTNode {
+    kind: "parallel_branch";
+    name: string;
+    body: StatementNode[];
+}
+export interface ParallelJoinNode extends ASTNode {
+    kind: "parallel_join";
+    type: "all" | "first" | "best" | "any" | "majority";
+    metric?: ExpressionNode;
+    order?: "max" | "min";
+    count?: number;
+}
+/** Pipeline operations */
+export interface PipelineNode extends ASTNode {
+    kind: "pipeline";
+    source: ExpressionNode;
+    stages: PipelineStageNode[];
+    outputBinding?: string;
+}
+export interface PipelineStageNode extends ASTNode {
+    kind: "pipeline_stage";
+    op: "map" | "filter" | "reduce" | "where" | "take" | "skip" | "sort" | "pmap";
+    step: StatementNode;
+    initial?: ExpressionNode;
+    count?: number;
+    order?: "asc" | "desc";
+    by?: ExpressionNode;
+}
+/** Advisory call statement: x = advise advisor: "prompt" ... */
+export interface AdviseNode extends ASTNode {
+    kind: "advise";
+    target: string;
+    advisor: string;
+    prompt: string;
+    outputSchema: AdvisoryOutputSchemaNode;
+    timeout: number;
+    fallback: ExpressionNode;
+}
+export interface AdvisoryOutputSchemaNode extends ASTNode {
+    kind: "advisory_output_schema";
+    type: "boolean" | "number" | "enum" | "string" | "object" | "array";
+    values?: string[];
+    min?: number;
+    max?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    fields?: Record<string, AdvisoryOutputSchemaNode>;
+    items?: AdvisoryOutputSchemaNode;
+}
+/** Assignment: x = expr [with key=value, ...] */
+export interface AssignmentNode extends ASTNode {
+    kind: "assignment";
+    target: string;
+    value: ExpressionNode;
+    constraints?: ConstraintClause;
+    skill?: string;
+}
+/** If statement: if cond: ... elif cond: ... else: ... */
+export interface IfNode extends ASTNode {
+    kind: "if";
+    condition: ExpressionNode;
+    thenBody: StatementNode[];
+    elifs: Array<{
+        condition: ExpressionNode;
+        body: StatementNode[];
+    }>;
+    elseBody: StatementNode[];
+}
+/** For loop: for x in items: ... */
+export interface ForNode extends ASTNode {
+    kind: "for";
+    variable: string;
+    iterable: ExpressionNode;
+    body: StatementNode[];
+    maxIterations?: number;
+}
+/** Atomic block: atomic: ... (transaction grouping) */
+export interface AtomicNode extends ASTNode {
+    kind: "atomic";
+    body: StatementNode[];
+    onFailure?: "revert" | "skip" | "halt";
+}
+/** Method call: venue.deposit(asset, amount) [with key=value, ...] */
+export interface MethodCallNode extends ASTNode {
+    kind: "method_call";
+    object: ExpressionNode;
+    method: string;
+    args: ExpressionNode[];
+    outputBinding?: string;
+    constraints?: ConstraintClause;
+    skill?: string;
+}
+/** Emit statement: emit event_name(key=value, ...) */
+export interface EmitNode extends ASTNode {
+    kind: "emit";
+    event: string;
+    data: Array<{
+        key: string;
+        value: ExpressionNode;
+    }>;
+}
+/** Halt statement: halt "reason" */
+export interface HaltNode extends ASTNode {
+    kind: "halt";
+    reason: string;
+}
+/** Wait statement: wait 10s / wait 1h */
+export interface WaitNode extends ASTNode {
+    kind: "wait";
+    duration: number;
+}
+/** Advisory statement: if **prompt**: ... */
+export interface AdvisoryNode extends ASTNode {
+    kind: "advisory";
+    advisor?: string;
+    prompt: string;
+    thenBody: StatementNode[];
+    elseBody: StatementNode[];
+    timeout?: number;
+    fallback?: boolean;
+}
+/** Pass statement (no-op) */
+export interface PassNode extends ASTNode {
+    kind: "pass";
+}
+/** Constraint clause: with slippage=50, deadline=300 */
+export interface ConstraintClause extends ASTNode {
+    kind: "constraint_clause";
+    constraints: Array<{
+        key: string;
+        value: ExpressionNode;
+    }>;
+}
+/** Expression node types */
+export type ExpressionNode = LiteralNode | UnitLiteralNode | IdentifierNode | VenueRefExpr | AdvisoryExpr | PercentageExpr | BinaryExprNode | UnaryExprNode | TernaryExprNode | CallExprNode | PropertyAccessNode | ArrayAccessNode | ArrayLiteralNode | ObjectLiteralNode;
+/** Literal value */
+export interface LiteralNode extends ASTNode {
+    kind: "literal";
+    value: string | number | boolean;
+    literalType: "string" | "number" | "boolean" | "address";
+}
+/** Unit literal: 1.5 USDC, 50 bps */
+export interface UnitLiteralNode extends ASTNode {
+    kind: "unit_literal";
+    value: number;
+    unit: string;
+}
+/** Identifier reference */
+export interface IdentifierNode extends ASTNode {
+    kind: "identifier";
+    name: string;
+}
+/** Venue reference expression: @aave_v3 */
+export interface VenueRefExpr extends ASTNode {
+    kind: "venue_ref_expr";
+    name: string;
+}
+/** Advisory expression: **prompt text** */
+export interface AdvisoryExpr extends ASTNode {
+    kind: "advisory_expr";
+    prompt: string;
+    advisor?: string;
+}
+/** Percentage literal: 50% */
+export interface PercentageExpr extends ASTNode {
+    kind: "percentage";
+    value: number;
+}
+/** Binary operation */
+export interface BinaryExprNode extends ASTNode {
+    kind: "binary";
+    op: BinaryOperator;
+    left: ExpressionNode;
+    right: ExpressionNode;
+}
+export type BinaryOperator = "+" | "-" | "*" | "/" | "%" | "==" | "!=" | "<" | ">" | "<=" | ">=" | "and" | "or";
+/** Unary operation */
+export interface UnaryExprNode extends ASTNode {
+    kind: "unary";
+    op: UnaryOperator;
+    arg: ExpressionNode;
+}
+export type UnaryOperator = "not" | "-";
+/** Ternary expression */
+export interface TernaryExprNode extends ASTNode {
+    kind: "ternary";
+    condition: ExpressionNode;
+    thenExpr: ExpressionNode;
+    elseExpr: ExpressionNode;
+}
+/** Function/method call */
+export interface CallExprNode extends ASTNode {
+    kind: "call";
+    callee: ExpressionNode;
+    args: ExpressionNode[];
+    kwargs?: Array<{
+        key: string;
+        value: ExpressionNode;
+    }>;
+}
+/** Property access: obj.prop */
+export interface PropertyAccessNode extends ASTNode {
+    kind: "property_access";
+    object: ExpressionNode;
+    property: string;
+}
+/** Array access: arr[index] */
+export interface ArrayAccessNode extends ASTNode {
+    kind: "array_access";
+    array: ExpressionNode;
+    index: ExpressionNode;
+}
+/** Array literal: [a, b, c] */
+export interface ArrayLiteralNode extends ASTNode {
+    kind: "array_literal";
+    elements: ExpressionNode[];
+}
+/** Object literal: {key: value, ...} */
+export interface ObjectLiteralNode extends ASTNode {
+    kind: "object_literal";
+    entries: Array<{
+        key: string;
+        value: ExpressionNode;
+    }>;
+}
+/** Check if expression is advisory */
+export declare function isAdvisoryExpr(node: ExpressionNode): node is AdvisoryExpr;
+/** Check if expression is venue ref */
+export declare function isVenueRef(node: ExpressionNode): node is VenueRefExpr;
+/** Check if expression is percentage */
+export declare function isPercentage(node: ExpressionNode): node is PercentageExpr;
+//# sourceMappingURL=ast.d.ts.map

package/dist/compiler/grimoire/ast.d.ts.map

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

package/dist/compiler/grimoire/ast.js

@@ -0,0 +1,19 @@
+/**
+ * AST node types for the Grimoire syntax
+ */
+// =============================================================================
+// HELPERS
+// =============================================================================
+/** Check if expression is advisory */
+export function isAdvisoryExpr(node) {
+    return node.kind === "advisory_expr";
+}
+/** Check if expression is venue ref */
+export function isVenueRef(node) {
+    return node.kind === "venue_ref_expr";
+}
+/** Check if expression is percentage */
+export function isPercentage(node) {
+    return node.kind === "percentage";
+}
+//# sourceMappingURL=ast.js.map

package/dist/compiler/grimoire/ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../../../src/compiler/grimoire/ast.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmjBH,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,sCAAsC;AACtC,MAAM,UAAU,cAAc,CAAC,IAAoB;IACjD,OAAO,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC;AACvC,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,UAAU,CAAC,IAAoB;IAC7C,OAAO,IAAI,CAAC,IAAI,KAAK,gBAAgB,CAAC;AACxC,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,YAAY,CAAC,IAAoB;IAC/C,OAAO,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC;AACpC,CAAC"}

package/dist/compiler/grimoire/errors.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Error types and formatting for Grimoire parser
+ */
+/** Source location for error reporting */
+export interface SourceLocation {
+    line: number;
+    column: number;
+    offset: number;
+}
+/** Source span (start to end) */
+export interface SourceSpan {
+    start: SourceLocation;
+    end: SourceLocation;
+}
+/** Base error class for Grimoire parsing */
+export declare class GrimoireError extends Error {
+    readonly code: string;
+    readonly location?: SourceLocation;
+    readonly span?: SourceSpan;
+    readonly source?: string;
+    constructor(code: string, message: string, options?: {
+        location?: SourceLocation;
+        span?: SourceSpan;
+        source?: string;
+    });
+    /** Format error with source context */
+    format(): string;
+}
+/** Tokenization error */
+export declare class TokenizeError extends GrimoireError {
+    constructor(message: string, options?: {
+        location?: SourceLocation;
+        source?: string;
+    });
+}
+/** Parse error */
+export declare class ParseError extends GrimoireError {
+    constructor(message: string, options?: {
+        location?: SourceLocation;
+        span?: SourceSpan;
+        source?: string;
+    });
+}
+/** Indentation error */
+export declare class IndentationError extends GrimoireError {
+    constructor(message: string, options?: {
+        location?: SourceLocation;
+        source?: string;
+    });
+}
+/** Transform error (AST to SpellSource) */
+export declare class TransformError extends GrimoireError {
+    constructor(message: string, options?: {
+        location?: SourceLocation;
+        span?: SourceSpan;
+        source?: string;
+    });
+}
+/** Create a source location from line, column, offset */
+export declare function loc(line: number, column: number, offset: number): SourceLocation;
+/** Create a source span from start and end locations */
+export declare function span(start: SourceLocation, end: SourceLocation): SourceSpan;
+/** Format multiple errors */
+export declare function formatErrors(errors: GrimoireError[]): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/compiler/grimoire/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/compiler/grimoire/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,iCAAiC;AACjC,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,cAAc,CAAC;IACtB,GAAG,EAAE,cAAc,CAAC;CACrB;AAED,4CAA4C;AAC5C,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAGvB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,cAAc,CAAC;QAC1B,IAAI,CAAC,EAAE,UAAU,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAUH,uCAAuC;IACvC,MAAM,IAAI,MAAM;CA+BjB;AAED,yBAAyB;AACzB,qBAAa,aAAc,SAAQ,aAAa;gBAE5C,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,cAAc,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;CAKJ;AAED,kBAAkB;AAClB,qBAAa,UAAW,SAAQ,aAAa;gBAEzC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,cAAc,CAAC;QAC1B,IAAI,CAAC,EAAE,UAAU,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;CAKJ;AAED,wBAAwB;AACxB,qBAAa,gBAAiB,SAAQ,aAAa;gBAE/C,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,cAAc,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;CAKJ;AAED,2CAA2C;AAC3C,qBAAa,cAAe,SAAQ,aAAa;gBAE7C,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,cAAc,CAAC;QAC1B,IAAI,CAAC,EAAE,UAAU,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;CAKJ;AAED,yDAAyD;AACzD,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAEhF;AAED,wDAAwD;AACxD,wBAAgB,IAAI,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,cAAc,GAAG,UAAU,CAE3E;AAED,6BAA6B;AAC7B,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAE5D"}

package/dist/compiler/grimoire/errors.js

@@ -0,0 +1,86 @@
+/**
+ * Error types and formatting for Grimoire parser
+ */
+/** Base error class for Grimoire parsing */
+export class GrimoireError extends Error {
+    code;
+    location;
+    span;
+    source;
+    constructor(code, message, options) {
+        super(message);
+        this.name = "GrimoireError";
+        this.code = code;
+        this.location = options?.location;
+        this.span = options?.span;
+        this.source = options?.source;
+    }
+    /** Format error with source context */
+    format() {
+        const lines = [];
+        // Error header
+        const loc = this.location;
+        if (loc) {
+            lines.push(`Error [${this.code}] at line ${loc.line}, column ${loc.column}:`);
+        }
+        else {
+            lines.push(`Error [${this.code}]:`);
+        }
+        lines.push(`  ${this.message}`);
+        // Source context
+        if (this.source && this.location) {
+            const sourceLines = this.source.split("\n");
+            const lineIdx = this.location.line - 1;
+            if (lineIdx >= 0 && lineIdx < sourceLines.length) {
+                lines.push("");
+                lines.push(`  ${this.location.line} | ${sourceLines[lineIdx]}`);
+                // Pointer to error location
+                const padding = " ".repeat(String(this.location.line).length + 3);
+                const pointer = `${" ".repeat(this.location.column - 1)}^`;
+                lines.push(`  ${padding}${pointer}`);
+            }
+        }
+        return lines.join("\n");
+    }
+}
+/** Tokenization error */
+export class TokenizeError extends GrimoireError {
+    constructor(message, options) {
+        super("TOKENIZE_ERROR", message, options);
+        this.name = "TokenizeError";
+    }
+}
+/** Parse error */
+export class ParseError extends GrimoireError {
+    constructor(message, options) {
+        super("PARSE_ERROR", message, options);
+        this.name = "ParseError";
+    }
+}
+/** Indentation error */
+export class IndentationError extends GrimoireError {
+    constructor(message, options) {
+        super("INDENTATION_ERROR", message, options);
+        this.name = "IndentationError";
+    }
+}
+/** Transform error (AST to SpellSource) */
+export class TransformError extends GrimoireError {
+    constructor(message, options) {
+        super("TRANSFORM_ERROR", message, options);
+        this.name = "TransformError";
+    }
+}
+/** Create a source location from line, column, offset */
+export function loc(line, column, offset) {
+    return { line, column, offset };
+}
+/** Create a source span from start and end locations */
+export function span(start, end) {
+    return { start, end };
+}
+/** Format multiple errors */
+export function formatErrors(errors) {
+    return errors.map((e) => e.format()).join("\n\n");
+}
+//# sourceMappingURL=errors.js.map

package/dist/compiler/grimoire/errors.js.map

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

package/dist/compiler/grimoire/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Grimoire syntax compiler
+ *
+ * This module provides the new Python-like syntax for spell definitions.
+ */
+export * from "./errors.js";
+export * from "./tokenizer.js";
+export * from "./ast.js";
+export { Parser, parse } from "./parser.js";
+export { Transformer, transform } from "./transformer.js";
+import type { CompilationResult, SpellSource } from "../../types/ir.js";
+/**
+ * Parse Grimoire source to SpellSource
+ */
+export declare function parseGrimoire(source: string, options?: {
+    filePath?: string;
+}): SpellSource;
+/**
+ * Compile Grimoire source to IR
+ */
+export declare function compileGrimoire(source: string, options?: {
+    filePath?: string;
+}): CompilationResult;
+//# sourceMappingURL=index.d.ts.map