sqlparser-rs 0.60.0-rc1

package/dist/cjs/dialects.js

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * SQL Dialects
+ *
+ * Each dialect class represents a specific SQL dialect supported by the parser.
+ * These are thin wrappers that provide type safety and a clean API.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUPPORTED_DIALECTS = exports.HiveDialect = exports.DatabricksDialect = exports.DuckDbDialect = exports.BigQueryDialect = exports.ClickHouseDialect = exports.MsSqlDialect = exports.RedshiftDialect = exports.SnowflakeDialect = exports.SQLiteDialect = exports.PostgreSqlDialect = exports.MySqlDialect = exports.AnsiDialect = exports.GenericDialect = void 0;
+exports.dialectFromString = dialectFromString;
+/**
+ * Generic SQL dialect - accepts most SQL syntax
+ */
+class GenericDialect {
+    constructor() {
+        this.name = 'generic';
+    }
+}
+exports.GenericDialect = GenericDialect;
+/**
+ * ANSI SQL standard dialect
+ */
+class AnsiDialect {
+    constructor() {
+        this.name = 'ansi';
+    }
+}
+exports.AnsiDialect = AnsiDialect;
+/**
+ * MySQL dialect
+ */
+class MySqlDialect {
+    constructor() {
+        this.name = 'mysql';
+    }
+}
+exports.MySqlDialect = MySqlDialect;
+/**
+ * PostgreSQL dialect
+ */
+class PostgreSqlDialect {
+    constructor() {
+        this.name = 'postgresql';
+    }
+}
+exports.PostgreSqlDialect = PostgreSqlDialect;
+/**
+ * SQLite dialect
+ */
+class SQLiteDialect {
+    constructor() {
+        this.name = 'sqlite';
+    }
+}
+exports.SQLiteDialect = SQLiteDialect;
+/**
+ * Snowflake dialect
+ */
+class SnowflakeDialect {
+    constructor() {
+        this.name = 'snowflake';
+    }
+}
+exports.SnowflakeDialect = SnowflakeDialect;
+/**
+ * Amazon Redshift dialect
+ */
+class RedshiftDialect {
+    constructor() {
+        this.name = 'redshift';
+    }
+}
+exports.RedshiftDialect = RedshiftDialect;
+/**
+ * Microsoft SQL Server dialect
+ */
+class MsSqlDialect {
+    constructor() {
+        this.name = 'mssql';
+    }
+}
+exports.MsSqlDialect = MsSqlDialect;
+/**
+ * ClickHouse dialect
+ */
+class ClickHouseDialect {
+    constructor() {
+        this.name = 'clickhouse';
+    }
+}
+exports.ClickHouseDialect = ClickHouseDialect;
+/**
+ * Google BigQuery dialect
+ */
+class BigQueryDialect {
+    constructor() {
+        this.name = 'bigquery';
+    }
+}
+exports.BigQueryDialect = BigQueryDialect;
+/**
+ * DuckDB dialect
+ */
+class DuckDbDialect {
+    constructor() {
+        this.name = 'duckdb';
+    }
+}
+exports.DuckDbDialect = DuckDbDialect;
+/**
+ * Databricks dialect
+ */
+class DatabricksDialect {
+    constructor() {
+        this.name = 'databricks';
+    }
+}
+exports.DatabricksDialect = DatabricksDialect;
+/**
+ * Apache Hive dialect
+ */
+class HiveDialect {
+    constructor() {
+        this.name = 'hive';
+    }
+}
+exports.HiveDialect = HiveDialect;
+/**
+ * All supported dialect names
+ */
+exports.SUPPORTED_DIALECTS = [
+    'generic',
+    'ansi',
+    'mysql',
+    'postgresql',
+    'sqlite',
+    'snowflake',
+    'redshift',
+    'mssql',
+    'clickhouse',
+    'bigquery',
+    'duckdb',
+    'databricks',
+    'hive',
+];
+/**
+ * Map of dialect names to dialect classes
+ */
+const DIALECT_MAP = {
+    generic: GenericDialect,
+    ansi: AnsiDialect,
+    mysql: MySqlDialect,
+    postgresql: PostgreSqlDialect,
+    sqlite: SQLiteDialect,
+    snowflake: SnowflakeDialect,
+    redshift: RedshiftDialect,
+    mssql: MsSqlDialect,
+    clickhouse: ClickHouseDialect,
+    bigquery: BigQueryDialect,
+    duckdb: DuckDbDialect,
+    databricks: DatabricksDialect,
+    hive: HiveDialect,
+};
+/**
+ * Create a dialect instance from a string name
+ *
+ * @param name - The name of the dialect (case-insensitive)
+ * @returns A dialect instance, or undefined if the dialect is not recognized
+ *
+ * @example
+ * ```typescript
+ * const dialect = dialectFromString('postgresql');
+ * if (dialect) {
+ *   const ast = Parser.parse('SELECT 1', dialect);
+ * }
+ * ```
+ */
+function dialectFromString(name) {
+    const normalized = name.toLowerCase();
+    // Handle common aliases
+    const aliasMap = {
+        postgres: 'postgresql',
+        pg: 'postgresql',
+        sqlserver: 'mssql',
+        duck: 'duckdb',
+    };
+    const dialectName = aliasMap[normalized] ?? normalized;
+    const DialectClass = DIALECT_MAP[dialectName];
+    return DialectClass ? new DialectClass() : undefined;
+}
+//# sourceMappingURL=dialects.js.map

package/dist/cjs/dialects.js.map

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

package/dist/cjs/index.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * sqlparser-rs - SQL Parser for JavaScript/TypeScript
+ *
+ * This package wraps the Rust sqlparser crate via WebAssembly, providing
+ * a fast and accurate SQL parser for JavaScript and TypeScript.
+ *
+ * @example
+ * ```typescript
+ * import { Parser, GenericDialect, PostgreSqlDialect } from 'sqlparser-rs';
+ *
+ * // Simple parsing
+ * const statements = await Parser.parse('SELECT * FROM users', new GenericDialect());
+ *
+ * // With specific dialect
+ * const pgStatements = await Parser.parse(
+ *   'SELECT * FROM users WHERE id = $1',
+ *   new PostgreSqlDialect()
+ * );
+ *
+ * // Builder pattern with options
+ * const parser = new Parser(new PostgreSqlDialect())
+ *   .withRecursionLimit(50)
+ *   .withOptions({ trailingCommas: true });
+ *
+ * const ast = await parser.parseAsync('SELECT * FROM users');
+ *
+ * // Format SQL
+ * const formatted = await Parser.format('select * from users', new GenericDialect());
+ * // Returns: "SELECT * FROM users"
+ *
+ * // Validate SQL
+ * try {
+ *   await Parser.validate('SELECT * FRO users', new GenericDialect());
+ * } catch (e) {
+ *   console.log('Invalid SQL:', e.message);
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUPPORTED_DIALECTS = exports.dialectFromString = exports.HiveDialect = exports.DatabricksDialect = exports.DuckDbDialect = exports.BigQueryDialect = exports.ClickHouseDialect = exports.MsSqlDialect = exports.RedshiftDialect = exports.SnowflakeDialect = exports.SQLiteDialect = exports.PostgreSqlDialect = exports.MySqlDialect = exports.AnsiDialect = exports.GenericDialect = exports.initWasm = exports.Parser = void 0;
+// Parser
+var parser_1 = require("./parser");
+Object.defineProperty(exports, "Parser", { enumerable: true, get: function () { return parser_1.Parser; } });
+Object.defineProperty(exports, "initWasm", { enumerable: true, get: function () { return parser_1.initWasm; } });
+// Dialects
+var dialects_1 = require("./dialects");
+Object.defineProperty(exports, "GenericDialect", { enumerable: true, get: function () { return dialects_1.GenericDialect; } });
+Object.defineProperty(exports, "AnsiDialect", { enumerable: true, get: function () { return dialects_1.AnsiDialect; } });
+Object.defineProperty(exports, "MySqlDialect", { enumerable: true, get: function () { return dialects_1.MySqlDialect; } });
+Object.defineProperty(exports, "PostgreSqlDialect", { enumerable: true, get: function () { return dialects_1.PostgreSqlDialect; } });
+Object.defineProperty(exports, "SQLiteDialect", { enumerable: true, get: function () { return dialects_1.SQLiteDialect; } });
+Object.defineProperty(exports, "SnowflakeDialect", { enumerable: true, get: function () { return dialects_1.SnowflakeDialect; } });
+Object.defineProperty(exports, "RedshiftDialect", { enumerable: true, get: function () { return dialects_1.RedshiftDialect; } });
+Object.defineProperty(exports, "MsSqlDialect", { enumerable: true, get: function () { return dialects_1.MsSqlDialect; } });
+Object.defineProperty(exports, "ClickHouseDialect", { enumerable: true, get: function () { return dialects_1.ClickHouseDialect; } });
+Object.defineProperty(exports, "BigQueryDialect", { enumerable: true, get: function () { return dialects_1.BigQueryDialect; } });
+Object.defineProperty(exports, "DuckDbDialect", { enumerable: true, get: function () { return dialects_1.DuckDbDialect; } });
+Object.defineProperty(exports, "DatabricksDialect", { enumerable: true, get: function () { return dialects_1.DatabricksDialect; } });
+Object.defineProperty(exports, "HiveDialect", { enumerable: true, get: function () { return dialects_1.HiveDialect; } });
+Object.defineProperty(exports, "dialectFromString", { enumerable: true, get: function () { return dialects_1.dialectFromString; } });
+Object.defineProperty(exports, "SUPPORTED_DIALECTS", { enumerable: true, get: function () { return dialects_1.SUPPORTED_DIALECTS; } });
+// Types
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;;;;;;;;;;;;;;;;;AAEH,SAAS;AACT,mCAA4C;AAAnC,gGAAA,MAAM,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAGzB,WAAW;AACX,uCAgBoB;AAflB,0GAAA,cAAc,OAAA;AACd,uGAAA,WAAW,OAAA;AACX,wGAAA,YAAY,OAAA;AACZ,6GAAA,iBAAiB,OAAA;AACjB,yGAAA,aAAa,OAAA;AACb,4GAAA,gBAAgB,OAAA;AAChB,2GAAA,eAAe,OAAA;AACf,wGAAA,YAAY,OAAA;AACZ,6GAAA,iBAAiB,OAAA;AACjB,2GAAA,eAAe,OAAA;AACf,yGAAA,aAAa,OAAA;AACb,6GAAA,iBAAiB,OAAA;AACjB,uGAAA,WAAW,OAAA;AACX,6GAAA,iBAAiB,OAAA;AACjB,8GAAA,kBAAkB,OAAA;AAIpB,QAAQ;AACR,0CAAwB"}

package/dist/cjs/parser.js

@@ -0,0 +1,264 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Parser = void 0;
+exports.initWasm = initWasm;
+const dialects_1 = require("./dialects");
+const errors_1 = require("./types/errors");
+// Global WASM module instance
+let wasmModule = null;
+let wasmInitPromise = null;
+/**
+ * Initialize the WASM module
+ * This is called automatically when needed, but can be called manually for eager loading
+ */
+async function initWasm() {
+    await getWasmModule();
+}
+/**
+ * Get or initialize the WASM module
+ */
+async function getWasmModule() {
+    if (wasmModule) {
+        return wasmModule;
+    }
+    if (wasmInitPromise) {
+        return wasmInitPromise;
+    }
+    wasmInitPromise = (async () => {
+        try {
+            // Try to load the WASM module
+            // Use dynamic path to avoid TypeScript path resolution issues
+            // The path is relative to the compiled output in dist/cjs or dist/esm
+            const wasmPath = '../../wasm/sqlparser_rs_wasm.js';
+            const wasm = await Promise.resolve(`${wasmPath}`).then(s => __importStar(require(s)));
+            wasmModule = wasm;
+            return wasmModule;
+        }
+        catch (error) {
+            throw new errors_1.WasmInitError(`Failed to initialize WASM module: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    })();
+    return wasmInitPromise;
+}
+/**
+ * Get the WASM module synchronously (throws if not initialized)
+ */
+function getWasmModuleSync() {
+    if (!wasmModule) {
+        throw new errors_1.WasmInitError('WASM module not initialized. Call initWasm() first or use async methods.');
+    }
+    return wasmModule;
+}
+/**
+ * SQL Parser
+ *
+ * Parses SQL statements into an Abstract Syntax Tree (AST).
+ *
+ * @example
+ * ```typescript
+ * import { Parser, PostgreSqlDialect } from 'sqlparser-rs';
+ *
+ * // Simple parsing
+ * const statements = await Parser.parse('SELECT * FROM users', new PostgreSqlDialect());
+ *
+ * // With builder pattern
+ * const parser = new Parser(new PostgreSqlDialect())
+ *   .withRecursionLimit(50)
+ *   .withOptions({ trailingCommas: true });
+ *
+ * const ast = await parser.parseAsync('SELECT * FROM users');
+ * ```
+ */
+class Parser {
+    /**
+     * Create a new parser instance
+     *
+     * @param dialect - The SQL dialect to use (defaults to GenericDialect)
+     */
+    constructor(dialect = new dialects_1.GenericDialect()) {
+        this.dialect = dialect;
+        this.options = {};
+    }
+    /**
+     * Set the recursion limit for parsing nested expressions
+     *
+     * @param limit - Maximum recursion depth
+     * @returns This parser instance for chaining
+     */
+    withRecursionLimit(limit) {
+        this.options.recursionLimit = limit;
+        return this;
+    }
+    /**
+     * Set parser options
+     *
+     * @param options - Parser options
+     * @returns This parser instance for chaining
+     */
+    withOptions(options) {
+        this.options = { ...this.options, ...options };
+        return this;
+    }
+    /**
+     * Parse SQL statements asynchronously
+     *
+     * @param sql - SQL string to parse
+     * @returns Array of parsed statements
+     */
+    async parseAsync(sql) {
+        const wasm = await getWasmModule();
+        return this.parseWithWasm(wasm, sql);
+    }
+    /**
+     * Parse SQL statements synchronously
+     * Requires WASM module to be initialized first via initWasm()
+     *
+     * @param sql - SQL string to parse
+     * @returns Array of parsed statements
+     */
+    parseSync(sql) {
+        const wasm = getWasmModuleSync();
+        return this.parseWithWasm(wasm, sql);
+    }
+    parseWithWasm(wasm, sql) {
+        try {
+            const hasOptions = Object.keys(this.options).length > 0;
+            if (hasOptions) {
+                const result = wasm.parse_sql_with_options(this.dialect.name, sql, this.options);
+                return result;
+            }
+            else {
+                const result = wasm.parse_sql(this.dialect.name, sql);
+                return result;
+            }
+        }
+        catch (error) {
+            throw errors_1.ParserError.fromWasmError(error);
+        }
+    }
+    // ============================================================================
+    // Static methods for simple one-off parsing
+    // ============================================================================
+    /**
+     * Parse SQL statements (async)
+     *
+     * @param sql - SQL string to parse
+     * @param dialect - SQL dialect to use
+     * @returns Array of parsed statements
+     *
+     * @example
+     * ```typescript
+     * const statements = await Parser.parse('SELECT 1', new GenericDialect());
+     * ```
+     */
+    static async parse(sql, dialect = new dialects_1.GenericDialect()) {
+        const parser = new Parser(dialect);
+        return parser.parseAsync(sql);
+    }
+    /**
+     * Parse SQL and return the AST as a JSON string (async)
+     *
+     * @param sql - SQL string to parse
+     * @param dialect - SQL dialect to use
+     * @returns JSON string representation of the AST
+     */
+    static async parseToJson(sql, dialect = new dialects_1.GenericDialect()) {
+        const wasm = await getWasmModule();
+        try {
+            return wasm.parse_sql_to_json_string(dialect.name, sql);
+        }
+        catch (error) {
+            throw errors_1.ParserError.fromWasmError(error);
+        }
+    }
+    /**
+     * Parse SQL and return a formatted string representation (async)
+     *
+     * @param sql - SQL string to parse
+     * @param dialect - SQL dialect to use
+     * @returns String representation of the parsed SQL
+     */
+    static async parseToString(sql, dialect = new dialects_1.GenericDialect()) {
+        const wasm = await getWasmModule();
+        try {
+            return wasm.parse_sql_to_string(dialect.name, sql);
+        }
+        catch (error) {
+            throw errors_1.ParserError.fromWasmError(error);
+        }
+    }
+    /**
+     * Format SQL by parsing and regenerating it (round-trip)
+     *
+     * @param sql - SQL string to format
+     * @param dialect - SQL dialect to use
+     * @returns Formatted SQL string
+     */
+    static async format(sql, dialect = new dialects_1.GenericDialect()) {
+        const wasm = await getWasmModule();
+        try {
+            return wasm.format_sql(dialect.name, sql);
+        }
+        catch (error) {
+            throw errors_1.ParserError.fromWasmError(error);
+        }
+    }
+    /**
+     * Validate SQL syntax without returning the full AST
+     *
+     * @param sql - SQL string to validate
+     * @param dialect - SQL dialect to use
+     * @returns true if valid, throws ParserError if invalid
+     */
+    static async validate(sql, dialect = new dialects_1.GenericDialect()) {
+        const wasm = await getWasmModule();
+        try {
+            return wasm.validate_sql(dialect.name, sql);
+        }
+        catch (error) {
+            throw errors_1.ParserError.fromWasmError(error);
+        }
+    }
+    /**
+     * Get the list of supported dialect names
+     */
+    static async getSupportedDialects() {
+        const wasm = await getWasmModule();
+        return wasm.get_supported_dialects();
+    }
+}
+exports.Parser = Parser;
+//# sourceMappingURL=parser.js.map

package/dist/cjs/parser.js.map

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

package/dist/cjs/types/ast.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * TypeScript type definitions for sqlparser-rs AST
+ *
+ * These types mirror the Rust AST structure from the sqlparser crate.
+ * The AST is serialized as JSON from Rust, so these types represent
+ * the JSON structure.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ast.js.map

package/dist/cjs/types/ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../../../src/types/ast.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/dist/cjs/types/errors.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WasmInitError = exports.ParserError = void 0;
+/**
+ * Error thrown when SQL parsing fails
+ */
+class ParserError extends Error {
+    constructor(message, location) {
+        super(message);
+        this.name = 'ParserError';
+        this.location = location;
+        // Maintain proper stack trace in V8 environments
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ParserError);
+        }
+    }
+    /**
+     * Create a ParserError from a WASM error object
+     */
+    static fromWasmError(error) {
+        if (typeof error === 'string') {
+            return new ParserError(error);
+        }
+        if (error && typeof error === 'object') {
+            const err = error;
+            const message = typeof err.message === 'string' ? err.message : String(error);
+            const location = typeof err.line === 'number' && typeof err.column === 'number'
+                ? { line: err.line, column: err.column }
+                : undefined;
+            return new ParserError(message, location);
+        }
+        return new ParserError(String(error));
+    }
+}
+exports.ParserError = ParserError;
+/**
+ * Error thrown when WASM module fails to initialize
+ */
+class WasmInitError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'WasmInitError';
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, WasmInitError);
+        }
+    }
+}
+exports.WasmInitError = WasmInitError;
+//# sourceMappingURL=errors.js.map

package/dist/cjs/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/types/errors.ts"],"names":[],"mappings":";;;AAQA;;GAEG;AACH,MAAa,WAAY,SAAQ,KAAK;IAGpC,YAAY,OAAe,EAAE,QAAwB;QACnD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,iDAAiD;QACjD,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAc;QACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,GAAG,GAAG,KAAgC,CAAC;YAC7C,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9E,MAAM,QAAQ,GACZ,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;gBAC5D,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE;gBACxC,CAAC,CAAC,SAAS,CAAC;YAChB,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,CAAC;CACF;AAlCD,kCAkCC;AAED;;GAEG;AACH,MAAa,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAE5B,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;CACF;AATD,sCASC"}

package/dist/cjs/types/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ast"), exports);
+__exportStar(require("./errors"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB;AACtB,2CAAyB"}