tywrap 0.1.0

package/dist/config/index.js

@@ -0,0 +1,234 @@
+/**
+ * Configuration system
+ *
+ * Loads configuration from defaults, optional config file and CLI overrides
+ * with basic validation of known options.
+ */
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { dirname, extname, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { getDefaultPythonPath } from '../utils/python.js';
+/**
+ * Default configuration values used when options are not supplied.
+ */
+const DEFAULT_CONFIG = {
+    pythonModules: {},
+    output: { dir: './generated', format: 'esm', declaration: false, sourceMap: false },
+    runtime: { node: { pythonPath: getDefaultPythonPath(), timeout: 30000 } },
+    performance: { caching: false, batching: false, compression: 'none' },
+    development: { hotReload: false, sourceMap: false, validation: 'none' },
+    types: { presets: [] },
+    debug: false,
+};
+/**
+ * Recursively merge two configuration objects. Arrays are overwritten by
+ * overrides instead of concatenated.
+ */
+function isPlainObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function ensureConfigObject(value, configFile) {
+    if (!isPlainObject(value)) {
+        throw new Error(`Configuration file must export an object: ${configFile}`);
+    }
+    return value;
+}
+function merge(base, override) {
+    const result = new Map(Object.entries(base));
+    for (const [key, val] of Object.entries(override)) {
+        if (val === undefined) {
+            continue;
+        }
+        const current = result.get(key);
+        if (isPlainObject(val) && isPlainObject(current)) {
+            result.set(key, merge(current, val));
+        }
+        else {
+            result.set(key, val);
+        }
+    }
+    return Object.fromEntries(result);
+}
+function safeExists(path) {
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- config path is user-controlled and resolved
+    return existsSync(path);
+}
+/**
+ * Validate configuration values and throw user-friendly errors when invalid.
+ */
+function validateConfig(config) {
+    const allowedTopLevel = new Set([
+        'pythonModules',
+        'output',
+        'runtime',
+        'performance',
+        'development',
+        'types',
+        'debug',
+    ]);
+    for (const key of Object.keys(config)) {
+        if (!allowedTopLevel.has(key)) {
+            throw new Error(`Unknown configuration option \"${key}\"`);
+        }
+    }
+    const out = config.output;
+    if (typeof out.dir !== 'string') {
+        throw new Error('output.dir must be a string');
+    }
+    if (!['esm', 'cjs', 'both'].includes(out.format)) {
+        throw new Error('output.format must be one of "esm", "cjs" or "both"');
+    }
+    if (typeof out.declaration !== 'boolean' || typeof out.sourceMap !== 'boolean') {
+        throw new Error('output.declaration and output.sourceMap must be boolean');
+    }
+    const runtime = config.runtime;
+    if (runtime.node) {
+        if (runtime.node.pythonPath !== undefined && typeof runtime.node.pythonPath !== 'string') {
+            throw new Error('runtime.node.pythonPath must be a string');
+        }
+        if (runtime.node.timeout !== undefined) {
+            if (typeof runtime.node.timeout !== 'number' || runtime.node.timeout < 0) {
+                throw new Error('runtime.node.timeout must be a non-negative number');
+            }
+        }
+    }
+    const perf = config.performance;
+    if (typeof perf.caching !== 'boolean') {
+        throw new Error('performance.caching must be a boolean');
+    }
+    if (typeof perf.batching !== 'boolean') {
+        throw new Error('performance.batching must be a boolean');
+    }
+    const validCompression = ['auto', 'gzip', 'brotli', 'none'];
+    if (!validCompression.includes(perf.compression)) {
+        throw new Error(`performance.compression must be one of ${validCompression.join(', ')}`);
+    }
+    const dev = config.development;
+    if (typeof dev.hotReload !== 'boolean') {
+        throw new Error('development.hotReload must be a boolean');
+    }
+    if (typeof dev.sourceMap !== 'boolean') {
+        throw new Error('development.sourceMap must be a boolean');
+    }
+    const validValidation = ['runtime', 'compile', 'both', 'none'];
+    if (!validValidation.includes(dev.validation)) {
+        throw new Error(`development.validation must be one of ${validValidation.join(', ')}`);
+    }
+    if (config.types) {
+        const presets = config.types.presets;
+        const validPresets = new Set(['numpy', 'pandas', 'pydantic', 'stdlib', 'scipy', 'torch', 'sklearn']);
+        if (presets !== undefined) {
+            if (!Array.isArray(presets) || presets.some(p => typeof p !== 'string')) {
+                throw new Error('types.presets must be an array of strings');
+            }
+            for (const preset of presets) {
+                if (!validPresets.has(preset)) {
+                    throw new Error(`types.presets contains invalid value "${preset}". Allowed: ${Array.from(validPresets).join(', ')}`);
+                }
+            }
+        }
+    }
+    if (typeof config.debug !== 'boolean') {
+        throw new Error('debug must be a boolean');
+    }
+}
+/**
+ * Create a configuration object by merging defaults with overrides.
+ *
+ * @param overrides CLI or programmatic overrides
+ */
+export function createConfig(overrides = {}) {
+    const merged = merge(DEFAULT_CONFIG, overrides);
+    validateConfig(merged);
+    return merged;
+}
+/**
+ * Resolve configuration by loading a config file (JSON/JS/TS) and merging
+ * defaults with any overrides.
+ */
+export async function resolveConfig(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const overrides = options.overrides ?? {};
+    const configFile = options.configFile ? resolve(cwd, options.configFile) : undefined;
+    let fileConfig = {};
+    if (configFile) {
+        if (!safeExists(configFile)) {
+            if (options.requireConfig) {
+                throw new Error(`Configuration file not found: ${configFile}`);
+            }
+        }
+        else {
+            fileConfig = await loadConfigFile(configFile);
+        }
+    }
+    const merged = merge(merge(DEFAULT_CONFIG, fileConfig), overrides);
+    validateConfig(merged);
+    return merged;
+}
+/**
+ * Load a tywrap config file. Supports JSON, JS/CJS/ESM, and TS files.
+ */
+export async function loadConfigFile(configFile) {
+    const ext = extname(configFile).toLowerCase();
+    const resolved = resolve(configFile);
+    if (!safeExists(resolved)) {
+        throw new Error(`Configuration file not found: ${resolved}`);
+    }
+    if (ext === '.json') {
+        const txt = await safeReadFileAsync(resolved);
+        try {
+            const parsed = JSON.parse(txt);
+            return ensureConfigObject(parsed, resolved);
+        }
+        catch (err) {
+            throw new Error(`Failed to parse JSON config ${resolved}: ${err.message}`);
+        }
+    }
+    if (ext === '.cjs') {
+        const require = createRequire(import.meta.url);
+        // eslint-disable-next-line security/detect-non-literal-require -- config path is user-controlled and resolved
+        const mod = require(resolved);
+        const loaded = mod.default ?? mod;
+        return ensureConfigObject(loaded ?? {}, resolved);
+    }
+    if (ext === '.js' || ext === '.mjs') {
+        const mod = (await import(pathToFileURL(resolved).href));
+        const loaded = mod.default ?? mod;
+        return ensureConfigObject(loaded ?? {}, resolved);
+    }
+    if (ext === '.ts' || ext === '.mts' || ext === '.cts') {
+        const ts = await import('typescript');
+        const source = await safeReadFileAsync(resolved);
+        const output = ts.transpileModule(source, {
+            compilerOptions: {
+                module: ts.ModuleKind.CommonJS,
+                target: ts.ScriptTarget.ES2020,
+                esModuleInterop: true,
+            },
+            fileName: resolved,
+        });
+        const require = createRequire(import.meta.url);
+        const nodeModule = require('module');
+        const moduleCtor = nodeModule.Module;
+        const mod = new moduleCtor(resolved);
+        mod.filename = resolved;
+        mod.paths = moduleCtor._nodeModulePaths(dirname(resolved));
+        mod._compile(output.outputText, resolved);
+        const loaded = mod.exports.default ?? mod.exports;
+        return ensureConfigObject(loaded ?? {}, resolved);
+    }
+    throw new Error(`Unsupported configuration file extension: ${ext}`);
+}
+async function safeReadFileAsync(path) {
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- config path is user-controlled and resolved
+    return readFile(path, 'utf-8');
+}
+/**
+ * Type helper for authoring tywrap configs with full type inference.
+ */
+export function defineConfig(config) {
+    return config;
+}
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

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

package/dist/core/analyzer.d.ts

@@ -0,0 +1,63 @@
+/**
+ * PyAnalyzer - Python AST analysis and type extraction
+ */
+import type { SyntaxNode } from 'tree-sitter';
+import type { AnalysisResult, PythonFunction, PythonClass, PythonType } from '../types/index.js';
+export declare class PyAnalyzer {
+    private parser;
+    private initialized;
+    constructor();
+    /**
+     * Initialize the tree-sitter parser with Python grammar
+     */
+    initialize(): Promise<void>;
+    /**
+     * Analyze Python module source code and extract structure with caching
+     */
+    analyzePythonModule(source: string, modulePath?: string): Promise<AnalysisResult>;
+    /**
+     * Extract function definitions from AST
+     */
+    extractFunctions(node: SyntaxNode): Promise<PythonFunction[]>;
+    /**
+     * Extract class definitions from AST
+     */
+    extractClasses(node: SyntaxNode): Promise<PythonClass[]>;
+    /**
+     * Extract single function from function_definition node
+     */
+    private extractFunction;
+    /**
+     * Extract single class from class_definition node
+     */
+    private extractClass;
+    /**
+     * Extract function parameters from parameters node
+     */
+    private extractParameters;
+    /**
+     * Parse type annotation node into PythonType
+     */
+    parseTypeAnnotation(node: SyntaxNode): PythonType;
+    private parseGenericType;
+    private parseUnionType;
+    private parseGenericArguments;
+    /**
+     * Extract import statements
+     */
+    private extractImports;
+    /**
+     * Utility methods
+     */
+    private findNodesByType;
+    private extractModuleName;
+    private extractDecorators;
+    private extractDocstring;
+    private containsYield;
+    private extractBases;
+    private extractProperty;
+    private extractExports;
+    private collectSyntaxErrors;
+    private generateStatistics;
+}
+//# sourceMappingURL=analyzer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../src/core/analyzer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9C,OAAO,KAAK,EACV,cAAc,EAKd,cAAc,EACd,WAAW,EAEX,UAAU,EAIX,MAAM,mBAAmB,CAAC;AAQ3B,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;;IAM5B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC;;OAEG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAiFvF;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAiBnE;;OAEG;IACG,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAiB9D;;OAEG;YACW,eAAe;IAyC7B;;OAEG;YACW,YAAY;IA8C1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkHzB;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU;IA0FjD,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,qBAAqB;IAiC7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAwFtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,gBAAgB;IAuBxB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,kBAAkB;CA0B3B"}