@kawaijs/parser 0.1.0

package/dist/compiler.d.ts

@@ -0,0 +1,14 @@
+import type { ProgramNode, StoryPackage } from '@kawaijs/ast';
+export interface CompilerOptions {
+    validateLabels?: boolean;
+}
+export declare class Compiler {
+    private readonly program;
+    private readonly options;
+    private anonymousLabelCounter;
+    constructor(program: ProgramNode, options?: CompilerOptions);
+    compile(): StoryPackage;
+    private compileBlock;
+    private validateLabelReferences;
+}
+//# sourceMappingURL=compiler.d.ts.map

package/dist/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,WAAW,EAEX,YAAY,EACb,MAAM,cAAc,CAAC;AAGtB,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,qBAAqB,CAAK;gBAEtB,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE,eAA0C;IAK9E,OAAO,IAAI,YAAY;IAyC9B,OAAO,CAAC,YAAY;IA4JpB,OAAO,CAAC,uBAAuB;CAiBhC"}

package/dist/compiler.js

@@ -0,0 +1,198 @@
+import { KawaError } from './diagnostic.js';
+export class Compiler {
+    program;
+    options;
+    anonymousLabelCounter = 0;
+    constructor(program, options = { validateLabels: true }) {
+        this.program = program;
+        this.options = options;
+    }
+    compile() {
+        const characters = {};
+        const labels = {};
+        // 1. First pass: Collect character declarations and label bodies
+        for (const stmt of this.program.statements) {
+            if (stmt.type === 'CharacterDecl') {
+                characters[stmt.id] = {
+                    id: stmt.id,
+                    name: stmt.displayName,
+                    color: stmt.color
+                };
+            }
+            else if (stmt.type === 'LabelDecl') {
+                if (labels[stmt.name]) {
+                    throw new KawaError({
+                        code: 'E0201',
+                        message: `Duplicate label declaration '${stmt.name}'`,
+                        severity: 'error',
+                        loc: stmt.loc
+                    });
+                }
+                labels[stmt.name] = this.compileBlock(stmt.name, stmt.body, labels);
+            }
+        }
+        // 2. Validate label references if enabled
+        if (this.options.validateLabels) {
+            this.validateLabelReferences(labels);
+        }
+        return {
+            meta: {
+                title: 'Kawaijs Visual Novel',
+                version: '0.1.0',
+                startLabel: labels['start'] ? 'start' : Object.keys(labels)[0]
+            },
+            characters,
+            labels
+        };
+    }
+    compileBlock(currentLabel, statements, labels) {
+        const instructions = [];
+        for (const stmt of statements) {
+            switch (stmt.type) {
+                case 'SceneStmt':
+                    instructions.push({
+                        type: 'scene',
+                        background: stmt.background,
+                        transition: stmt.transition,
+                        loc: stmt.loc
+                    });
+                    break;
+                case 'ShowStmt':
+                    instructions.push({
+                        type: 'show',
+                        character: stmt.character,
+                        expression: stmt.expression,
+                        position: stmt.position,
+                        transition: stmt.transition,
+                        loc: stmt.loc
+                    });
+                    break;
+                case 'HideStmt':
+                    instructions.push({
+                        type: 'hide',
+                        character: stmt.character,
+                        transition: stmt.transition,
+                        loc: stmt.loc
+                    });
+                    break;
+                case 'DialogueStmt':
+                    instructions.push({
+                        type: 'dialogue',
+                        speaker: stmt.speaker,
+                        text: stmt.text,
+                        loc: stmt.loc
+                    });
+                    break;
+                case 'MenuStmt': {
+                    const choiceOptions = [];
+                    for (const choice of stmt.choices) {
+                        this.anonymousLabelCounter += 1;
+                        const syntheticLabel = `__choice_${currentLabel}_${this.anonymousLabelCounter}`;
+                        // Compile choice body into its own synthetic label block
+                        const choiceInstructions = this.compileBlock(syntheticLabel, choice.body, labels);
+                        labels[syntheticLabel] = choiceInstructions;
+                        choiceOptions.push({
+                            text: choice.text,
+                            targetLabel: syntheticLabel,
+                            condition: choice.condition
+                        });
+                    }
+                    instructions.push({
+                        type: 'choice',
+                        prompt: stmt.prompt,
+                        choices: choiceOptions,
+                        loc: stmt.loc
+                    });
+                    break;
+                }
+                case 'JumpStmt':
+                    instructions.push({
+                        type: 'jump',
+                        targetLabel: stmt.targetLabel,
+                        loc: stmt.loc
+                    });
+                    break;
+                case 'ReturnStmt':
+                    instructions.push({
+                        type: 'return',
+                        loc: stmt.loc
+                    });
+                    break;
+                case 'SetStmt':
+                    instructions.push({
+                        type: 'set',
+                        variable: stmt.variable,
+                        value: stmt.value,
+                        loc: stmt.loc
+                    });
+                    break;
+                case 'IfStmt': {
+                    this.anonymousLabelCounter += 1;
+                    const thenLabel = `__if_then_${currentLabel}_${this.anonymousLabelCounter}`;
+                    const mergeLabel = `__if_merge_${currentLabel}_${this.anonymousLabelCounter}`;
+                    const thenInstructions = this.compileBlock(thenLabel, stmt.thenBranch, labels);
+                    // If thenBranch doesn't end with jump or return, fall through to mergeLabel
+                    thenInstructions.push({ type: 'jump', targetLabel: mergeLabel });
+                    labels[thenLabel] = thenInstructions;
+                    let elseLabel;
+                    if (stmt.elseBranch) {
+                        elseLabel = `__if_else_${currentLabel}_${this.anonymousLabelCounter}`;
+                        const elseInstructions = this.compileBlock(elseLabel, stmt.elseBranch.body, labels);
+                        elseInstructions.push({ type: 'jump', targetLabel: mergeLabel });
+                        labels[elseLabel] = elseInstructions;
+                    }
+                    else {
+                        elseLabel = mergeLabel;
+                    }
+                    instructions.push({
+                        type: 'branch',
+                        condition: stmt.condition,
+                        thenLabel,
+                        elseLabel,
+                        loc: stmt.loc
+                    });
+                    // Create merge block for following instructions
+                    labels[mergeLabel] = [];
+                    // Switch compiling remainder of statements into mergeLabel if needed
+                    break;
+                }
+                case 'PlayStmt':
+                    instructions.push({
+                        type: 'play_audio',
+                        channel: stmt.channel,
+                        track: stmt.track,
+                        fade: stmt.fade,
+                        loop: stmt.loop,
+                        loc: stmt.loc
+                    });
+                    break;
+                case 'StopStmt':
+                    instructions.push({
+                        type: 'stop_audio',
+                        channel: stmt.channel,
+                        fade: stmt.fade,
+                        loc: stmt.loc
+                    });
+                    break;
+            }
+        }
+        return instructions;
+    }
+    validateLabelReferences(labels) {
+        const knownLabels = new Set(Object.keys(labels));
+        for (const [labelName, instructions] of Object.entries(labels)) {
+            for (const inst of instructions) {
+                if (inst.type === 'jump' && !knownLabels.has(inst.targetLabel)) {
+                    throw new KawaError({
+                        code: 'E0202',
+                        message: `Unknown label '${inst.targetLabel}' referenced in '${labelName}'`,
+                        severity: 'error',
+                        loc: inst.loc,
+                        hint: `Available labels: ${Array.from(knownLabels).filter(l => !l.startsWith('__')).join(', ')}`
+                    });
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=compiler.js.map

package/dist/compiler.js.map

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

package/dist/diagnostic.d.ts

@@ -0,0 +1,18 @@
+import type { SourceLocation } from '@kawaijs/ast';
+export type DiagnosticSeverity = 'error' | 'warning' | 'info';
+export interface KawaDiagnostic {
+    readonly code: string;
+    readonly message: string;
+    readonly severity: DiagnosticSeverity;
+    readonly loc?: SourceLocation;
+    readonly hint?: string;
+}
+export declare class KawaError extends Error {
+    readonly diagnostic: KawaDiagnostic;
+    constructor(diagnostic: KawaDiagnostic);
+}
+/**
+ * Formats a diagnostic into a human-friendly compiler error message with code frames.
+ */
+export declare function formatDiagnostic(diagnostic: KawaDiagnostic, sourceText?: string): string;
+//# sourceMappingURL=diagnostic.d.ts.map

package/dist/diagnostic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic.d.ts","sourceRoot":"","sources":["../src/diagnostic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;gBAExB,UAAU,EAAE,cAAc;CAKvC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAiCxF"}

package/dist/diagnostic.js

@@ -0,0 +1,37 @@
+export class KawaError extends Error {
+    diagnostic;
+    constructor(diagnostic) {
+        super(diagnostic.message);
+        this.name = 'KawaError';
+        this.diagnostic = diagnostic;
+    }
+}
+/**
+ * Formats a diagnostic into a human-friendly compiler error message with code frames.
+ */
+export function formatDiagnostic(diagnostic, sourceText) {
+    const prefix = `[Kawa ${diagnostic.severity.toUpperCase()}] ${diagnostic.code}: ${diagnostic.message}`;
+    if (!diagnostic.loc) {
+        return prefix;
+    }
+    const { file, start, end } = diagnostic.loc;
+    const locationHeader = ` --> ${file}:${start.line}:${start.column}`;
+    if (!sourceText) {
+        return `${prefix}\n${locationHeader}`;
+    }
+    const lines = sourceText.split(/\r?\n/);
+    const targetLineIdx = start.line - 1;
+    const lineContent = lines[targetLineIdx] ?? '';
+    const lineNumStr = String(start.line);
+    const padding = ' '.repeat(lineNumStr.length);
+    const startCol = Math.max(1, start.column);
+    const endCol = (end.line === start.line && end.column > start.column) ? end.column : startCol + 1;
+    const underlineLen = Math.max(1, endCol - startCol);
+    const caretLine = ' '.repeat(startCol - 1) + '^'.repeat(underlineLen);
+    let frame = `${prefix}\n${locationHeader}\n${padding} |\n${lineNumStr} | ${lineContent}\n${padding} | ${caretLine}`;
+    if (diagnostic.hint) {
+        frame += `\n${padding} =\n${padding} = Hint: ${diagnostic.hint}`;
+    }
+    return frame;
+}
+//# sourceMappingURL=diagnostic.js.map

package/dist/diagnostic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic.js","sourceRoot":"","sources":["../src/diagnostic.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,UAAU,CAAiB;IAEpC,YAAY,UAA0B;QACpC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAA0B,EAAE,UAAmB;IAC9E,MAAM,MAAM,GAAG,SAAS,UAAU,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC;IAEvG,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC;IAC5C,MAAM,cAAc,GAAG,QAAQ,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;IAEpE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,GAAG,MAAM,KAAK,cAAc,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;IACrC,MAAM,WAAW,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;IAE/C,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAE9C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;IAClG,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAEtE,IAAI,KAAK,GAAG,GAAG,MAAM,KAAK,cAAc,KAAK,OAAO,OAAO,UAAU,MAAM,WAAW,KAAK,OAAO,MAAM,SAAS,EAAE,CAAC;IAEpH,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,IAAI,KAAK,OAAO,OAAO,OAAO,YAAY,UAAU,CAAC,IAAI,EAAE,CAAC;IACnE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+import type { StoryPackage } from '@kawaijs/ast';
+import { type LexerOptions } from './lexer.js';
+import { type CompilerOptions } from './compiler.js';
+export * from './token.js';
+export * from './diagnostic.js';
+export * from './lexer.js';
+export * from './parser.js';
+export * from './compiler.js';
+/**
+ * Convenience helper to compile a raw Kawa Script string directly into a StoryPackage IR.
+ */
+export declare function compileScript(source: string, file?: string, options?: LexerOptions & CompilerOptions): StoryPackage;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAE/D,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAE9B;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,SAAgB,EACpB,OAAO,CAAC,EAAE,YAAY,GAAG,eAAe,GACvC,YAAY,CAOd"}

package/dist/index.js

@@ -0,0 +1,20 @@
+import { Lexer } from './lexer.js';
+import { Parser } from './parser.js';
+import { Compiler } from './compiler.js';
+export * from './token.js';
+export * from './diagnostic.js';
+export * from './lexer.js';
+export * from './parser.js';
+export * from './compiler.js';
+/**
+ * Convenience helper to compile a raw Kawa Script string directly into a StoryPackage IR.
+ */
+export function compileScript(source, file = 'script.kawa', options) {
+    const lexer = new Lexer(source, file, options);
+    const tokens = lexer.tokenize();
+    const parser = new Parser(tokens, file);
+    const ast = parser.parse();
+    const compiler = new Compiler(ast, options);
+    return compiler.compile();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAqB,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAwB,MAAM,eAAe,CAAC;AAE/D,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAE9B;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAc,EACd,IAAI,GAAG,aAAa,EACpB,OAAwC;IAExC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,QAAQ,CAAC,OAAO,EAAE,CAAC;AAC5B,CAAC"}

package/dist/lexer.d.ts

@@ -0,0 +1,32 @@
+import { type Token } from './token.js';
+export interface LexerOptions {
+    tabSize?: number;
+}
+export declare class Lexer {
+    private readonly source;
+    private readonly file;
+    private readonly tabSize;
+    private cursor;
+    private line;
+    private column;
+    private indentStack;
+    private pendingTokens;
+    private isAtLineStart;
+    private hasTokensOnCurrentLine;
+    constructor(source: string, file?: string, options?: LexerOptions);
+    tokenize(): Token[];
+    nextToken(): Token;
+    private handleIndentation;
+    private readString;
+    private readNumber;
+    private readIdentifier;
+    private skipComment;
+    private peek;
+    private advance;
+    private isEof;
+    private isDigit;
+    private isAlpha;
+    private isAlphaNumeric;
+    private getCurrentPosition;
+}
+//# sourceMappingURL=lexer.d.ts.map

package/dist/lexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lexer.d.ts","sourceRoot":"","sources":["../src/lexer.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAGlD,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;IAEnB,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,sBAAsB,CAAS;gBAE3B,MAAM,EAAE,MAAM,EAAE,IAAI,SAAgB,EAAE,OAAO,GAAE,YAAiB;IAMrE,QAAQ,IAAI,KAAK,EAAE;IAYnB,SAAS,IAAI,KAAK;IAmIzB,OAAO,CAAC,iBAAiB;IA2DzB,OAAO,CAAC,UAAU;IAoDlB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,kBAAkB;CAG3B"}