pynect 0.0.0 → 0.2.0

package/dist/native/NativeAddonLoader.js

@@ -0,0 +1,75 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadOrBuildNativeAddon = loadOrBuildNativeAddon;
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const child_process_1 = require("child_process");
+/**
+ * Load an addon built for the selected Python, compiling it through the active
+ * JavaScript runtime when no exact match exists.
+ */
+function loadOrBuildNativeAddon(options) {
+    let initialError = new Error('Native rebuild explicitly requested.');
+    if (process.env['PYNECT_FORCE_BUILD'] !== '1') {
+        try {
+            return loadMatchingLocalAddon(options);
+        }
+        catch (error) {
+            initialError = error;
+        }
+    }
+    const packageRoot = path_1.default.resolve(__dirname, '..', '..');
+    const script = path_1.default.join(packageRoot, 'scripts', 'ensure-native.js');
+    const result = (0, child_process_1.spawnSync)(process.execPath, [script], {
+        cwd: packageRoot,
+        env: {
+            ...process.env,
+            PYNECT_PROJECT_ROOT: options.projectRoot,
+            PYNECT_PYTHON: options.pythonExecutable,
+        },
+        stdio: 'inherit',
+        windowsHide: true,
+    });
+    if (result.error) {
+        throw new Error(`Could not launch the native builder with ${process.execPath}: ${result.error.message}`, { cause: initialError });
+    }
+    if (result.status !== 0) {
+        throw new Error(`Pynect could not load or build its native addon with ${process.execPath}. ` +
+            'Install a C++ toolchain or provide a compatible prebuilt addon.', { cause: initialError });
+    }
+    try {
+        return loadMatchingLocalAddon(options);
+    }
+    catch (error) {
+        throw new Error('Pynect built the native addon, but the active runtime could not load it.', {
+            cause: error,
+        });
+    }
+}
+function loadMatchingLocalAddon(options) {
+    const packageRoot = path_1.default.resolve(__dirname, '..', '..');
+    const metadataPath = path_1.default.join(packageRoot, 'build', 'pynect-python.json');
+    let metadata;
+    try {
+        metadata = JSON.parse(fs_1.default.readFileSync(metadataPath, 'utf8'));
+    }
+    catch (error) {
+        throw new Error(`Native build metadata is unavailable at ${metadataPath}.`, { cause: error });
+    }
+    if (metadata.schemaVersion !== 1 ||
+        normalizePath(metadata.pythonExecutable) !== normalizePath(options.pythonExecutable)) {
+        throw new Error(`Native addon Python ${metadata.pythonExecutable} does not match selected Python ` +
+            `${options.pythonExecutable}.`);
+    }
+    const addonPath = path_1.default.join(packageRoot, 'build', metadata.buildType === 'Debug' ? 'Debug' : 'Release', 'pynect_addon.node');
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    return require(addonPath);
+}
+function normalizePath(value) {
+    const resolved = path_1.default.resolve(value);
+    return process.platform === 'win32' ? resolved.toLowerCase() : resolved;
+}
+//# sourceMappingURL=NativeAddonLoader.js.map

package/dist/native/NativeAddonLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeAddonLoader.js","sourceRoot":"","sources":["../../src/native/NativeAddonLoader.ts"],"names":[],"mappings":";;;;;AAcA,wDA2CC;AAzDD,gDAAwB;AACxB,4CAAoB;AACpB,iDAA0C;AAQ1C;;;GAGG;AACH,SAAgB,sBAAsB,CAAC,OAAgC;IACrE,IAAI,YAAY,GAAY,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC9E,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,KAAK,GAAG,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,OAAO,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAY,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,cAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,cAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,IAAA,yBAAS,EAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;QACnD,GAAG,EAAE,WAAW;QAChB,GAAG,EAAE;YACH,GAAG,OAAO,CAAC,GAAG;YACd,mBAAmB,EAAE,OAAO,CAAC,WAAW;YACxC,aAAa,EAAE,OAAO,CAAC,gBAAgB;SACxC;QACD,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,IAAI;KAClB,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,4CAA4C,OAAO,CAAC,QAAQ,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EACvF,EAAE,KAAK,EAAE,YAAY,EAAE,CACxB,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,wDAAwD,OAAO,CAAC,QAAQ,IAAI;YAC5E,iEAAiE,EACjE,EAAE,KAAK,EAAE,YAAY,EAAE,CACxB,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,OAAO,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,0EAA0E,EAAE;YAC1F,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAQD,SAAS,sBAAsB,CAAC,OAAgC;IAC9D,MAAM,WAAW,GAAG,cAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACxD,MAAM,YAAY,GAAG,cAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC;IAC3E,IAAI,QAA6B,CAAC;IAClC,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAwB,CAAC;IACtF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,2CAA2C,YAAY,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,IACE,QAAQ,CAAC,aAAa,KAAK,CAAC;QAC5B,aAAa,CAAC,QAAQ,CAAC,gBAAgB,CAAC,KAAK,aAAa,CAAC,OAAO,CAAC,gBAAgB,CAAC,EACpF,CAAC;QACD,MAAM,IAAI,KAAK,CACb,uBAAuB,QAAQ,CAAC,gBAAgB,kCAAkC;YAClF,GAAG,OAAO,CAAC,gBAAgB,GAAG,CAC/B,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,cAAI,CAAC,IAAI,CACzB,WAAW,EACX,OAAO,EACP,QAAQ,CAAC,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EACpD,mBAAmB,CACpB,CAAC;IACF,8DAA8D;IAC9D,OAAO,OAAO,CAAC,SAAS,CAAgB,CAAC;AAC3C,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,QAAQ,GAAG,cAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrC,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC1E,CAAC"}

package/dist/plugins/Plugin.interface.d.ts

@@ -0,0 +1,41 @@
+/**
+ * pynect - Plugin Interface
+ *
+ * Every pynect plugin must implement this interface. Plugins can:
+ * - Transform Python object values as they cross the JS boundary
+ * - Register custom type mappings
+ * - Hook into lifecycle events (init, shutdown)
+ * - Add convenience methods to PyProxy instances
+ */
+import type { SerializedValue } from '../types/python';
+export type PythonTypeName = string;
+export interface PluginInitContext {
+    runtimeVersion: string;
+    pythonVersion: {
+        major: number;
+        minor: number;
+        patch: number;
+    };
+    registerTypeHandler(typeName: PythonTypeName, handler: TypeTransformHandler): void;
+}
+export type TypeTransformHandler = (raw: SerializedValue, typeHint: string, metadata: Record<string, unknown>) => unknown | null;
+export interface PynectPlugin {
+    readonly name: string;
+    readonly version: string;
+    readonly supportedModules: readonly string[];
+    readonly handledTypes?: readonly PythonTypeName[];
+    readonly description?: string;
+    readonly homepage?: string;
+    onInit?(ctx: PluginInitContext): Promise<void> | void;
+    onShutdown?(): Promise<void> | void;
+    onModuleImported?(moduleName: string, moduleOid: number): Promise<void> | void;
+    transformResult?: TypeTransformHandler;
+    serializeValue?(value: unknown, targetTypeName?: string): SerializedValue | null;
+}
+export interface PluginRegistration {
+    plugin: PynectPlugin;
+    active: boolean;
+    loadedAt: number;
+    modulesBound: Set<string>;
+}
+//# sourceMappingURL=Plugin.interface.d.ts.map

package/dist/plugins/Plugin.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.interface.d.ts","sourceRoot":"","sources":["../../src/plugins/Plugin.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIvD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,mBAAmB,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;CACpF;AAED,MAAM,MAAM,oBAAoB,GAAG,CACjC,GAAG,EAAO,eAAe,EACzB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,OAAO,GAAG,IAAI,CAAC;AAEpB,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAc,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAW,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,YAAY,CAAC,EAAK,SAAS,cAAc,EAAE,CAAC;IACrD,QAAQ,CAAC,WAAW,CAAC,EAAM,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAS,MAAM,CAAC;IAElC,MAAM,CAAC,CAAC,GAAG,EAAE,iBAAiB,GAAwB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3E,UAAU,CAAC,IAA2C,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3E,gBAAgB,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAE/E,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,cAAc,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAAC;CAClF;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAQ,YAAY,CAAC;IAC3B,MAAM,EAAQ,OAAO,CAAC;IACtB,QAAQ,EAAM,MAAM,CAAC;IACrB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC3B"}

package/dist/plugins/Plugin.interface.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * pynect - Plugin Interface
+ *
+ * Every pynect plugin must implement this interface. Plugins can:
+ * - Transform Python object values as they cross the JS boundary
+ * - Register custom type mappings
+ * - Hook into lifecycle events (init, shutdown)
+ * - Add convenience methods to PyProxy instances
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Plugin.interface.js.map

package/dist/plugins/Plugin.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.interface.js","sourceRoot":"","sources":["../../src/plugins/Plugin.interface.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}

package/dist/plugins/PluginManager.d.ts

@@ -0,0 +1,26 @@
+/**
+ * pynect - PluginManager
+ *
+ * Manages registration, lifecycle, and dispatch of pynect plugins.
+ * PyRuntime holds a single PluginManager instance.
+ */
+import type { PynectPlugin, PluginRegistration, PluginInitContext } from './Plugin.interface';
+import type { SerializedValue } from '../types/python';
+export declare class PluginManager {
+    private readonly _plugins;
+    private readonly _typeMap;
+    private readonly _moduleMap;
+    register(plugin: PynectPlugin): this;
+    registerBuiltins(): Promise<void>;
+    initAll(ctx: PluginInitContext): Promise<void>;
+    shutdownAll(): Promise<void>;
+    onModuleImported(moduleName: string, moduleOid: number): Promise<void>;
+    transformResult(value: SerializedValue, typeName: string, metadata?: Record<string, unknown>): unknown | null;
+    serializeValue(value: unknown, targetTypeName?: string): SerializedValue | null;
+    get names(): string[];
+    getPlugin(name: string): PluginRegistration | undefined;
+    get active(): PluginRegistration[];
+    get all(): PluginRegistration[];
+    isActive(name: string): boolean;
+}
+//# sourceMappingURL=PluginManager.d.ts.map

package/dist/plugins/PluginManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginManager.d.ts","sourceRoot":"","sources":["../../src/plugins/PluginManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EAGlB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIvD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2C;IACpE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuD;IAChF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqC;IAIhE,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IA+B9B,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC,OAAO,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB9C,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5E,eAAe,CACb,KAAK,EAAK,eAAe,EACzB,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,OAAO,GAAG,IAAI;IAajB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAe/E,IAAI,KAAK,IAAI,MAAM,EAAE,CAAsC;IAC3D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IACvD,IAAI,MAAM,IAAI,kBAAkB,EAAE,CAAgE;IAClG,IAAI,GAAG,IAAI,kBAAkB,EAAE,CAAwC;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAChC"}

package/dist/plugins/PluginManager.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * pynect - PluginManager
+ *
+ * Manages registration, lifecycle, and dispatch of pynect plugins.
+ * PyRuntime holds a single PluginManager instance.
+ */
+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.PluginManager = void 0;
+const Logger_1 = require("../utils/Logger");
+const logger = new Logger_1.Logger('PluginManager');
+class PluginManager {
+    _plugins = new Map();
+    _typeMap = new Map();
+    _moduleMap = new Map();
+    // Registration
+    register(plugin) {
+        if (this._plugins.has(plugin.name)) {
+            logger.debug(`Plugin already registered: ${plugin.name}; skipping`);
+            return this;
+        }
+        const entry = {
+            plugin,
+            active: false,
+            loadedAt: Date.now(),
+            modulesBound: new Set(),
+        };
+        this._plugins.set(plugin.name, entry);
+        for (const typeName of plugin.handledTypes ?? []) {
+            const handlers = this._typeMap.get(typeName) ?? [];
+            if (plugin.transformResult) {
+                handlers.push(plugin.transformResult.bind(plugin));
+            }
+            this._typeMap.set(typeName, handlers);
+        }
+        for (const mod of plugin.supportedModules) {
+            const list = this._moduleMap.get(mod) ?? [];
+            list.push(plugin);
+            this._moduleMap.set(mod, list);
+        }
+        logger.debug(`Registered plugin: ${plugin.name} v${plugin.version}`);
+        return this;
+    }
+    async registerBuiltins() {
+        const [{ PandasPlugin }, { NumpyPlugin }, { TorchPlugin }] = await Promise.all([
+            Promise.resolve().then(() => __importStar(require('./builtin/PandasPlugin'))),
+            Promise.resolve().then(() => __importStar(require('./builtin/NumpyPlugin'))),
+            Promise.resolve().then(() => __importStar(require('./builtin/TorchPlugin'))),
+        ]);
+        this.register(new PandasPlugin());
+        this.register(new NumpyPlugin());
+        this.register(new TorchPlugin());
+    }
+    // Lifecycle
+    async initAll(ctx) {
+        const extCtx = {
+            ...ctx,
+            registerTypeHandler: (typeName, handler) => {
+                const handlers = this._typeMap.get(typeName) ?? [];
+                handlers.push(handler);
+                this._typeMap.set(typeName, handlers);
+            },
+        };
+        for (const [name, entry] of this._plugins) {
+            try {
+                await entry.plugin.onInit?.(extCtx);
+                entry.active = true;
+                logger.debug(`Initialised plugin: ${name}`);
+            }
+            catch (err) {
+                logger.warn(`Plugin ${name} init failed (non-fatal): ${err}`);
+            }
+        }
+    }
+    async shutdownAll() {
+        for (const [name, entry] of this._plugins) {
+            if (!entry.active) {
+                continue;
+            }
+            try {
+                await entry.plugin.onShutdown?.();
+                entry.active = false;
+            }
+            catch (err) {
+                logger.warn(`Plugin ${name} shutdown error (non-fatal): ${err}`);
+            }
+        }
+    }
+    async onModuleImported(moduleName, moduleOid) {
+        const plugins = this._moduleMap.get(moduleName) ?? [];
+        for (const plugin of plugins) {
+            try {
+                await plugin.onModuleImported?.(moduleName, moduleOid);
+            }
+            catch (err) {
+                logger.warn(`Plugin ${plugin.name} onModuleImported error: ${err}`);
+            }
+        }
+    }
+    // Transform chain
+    transformResult(value, typeName, metadata = {}) {
+        const handlers = this._typeMap.get(typeName) ?? [];
+        for (const handler of handlers) {
+            try {
+                const result = handler(value, typeName, metadata);
+                if (result !== null) {
+                    return result;
+                }
+            }
+            catch (err) {
+                logger.warn(`Type transform error for ${typeName}: ${err}`);
+            }
+        }
+        return null;
+    }
+    serializeValue(value, targetTypeName) {
+        for (const [, entry] of this._plugins) {
+            if (!entry.active || !entry.plugin.serializeValue) {
+                continue;
+            }
+            try {
+                const result = entry.plugin.serializeValue(value, targetTypeName);
+                if (result !== null) {
+                    return result;
+                }
+            }
+            catch (err) {
+                logger.warn(`Plugin serialize error: ${err}`);
+            }
+        }
+        return null;
+    }
+    // Introspection
+    get names() { return [...this._plugins.keys()]; }
+    getPlugin(name) { return this._plugins.get(name); }
+    get active() { return [...this._plugins.values()].filter((e) => e.active); }
+    get all() { return [...this._plugins.values()]; }
+    isActive(name) { return this._plugins.get(name)?.active === true; }
+}
+exports.PluginManager = PluginManager;
+//# sourceMappingURL=PluginManager.js.map

package/dist/plugins/PluginManager.js.map

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

package/dist/plugins/builtin/NumpyPlugin.d.ts

@@ -0,0 +1,17 @@
+/**
+ * pynect - NumpyPlugin (built-in)
+ * Routes ndarray wire objects through NumpyBridge.
+ */
+import type { PynectPlugin, PluginInitContext } from '../Plugin.interface';
+import type { SerializedValue, NumPyArrayResult } from '../../types/python';
+export declare class NumpyPlugin implements PynectPlugin {
+    readonly name = "numpy";
+    readonly version = "1.0.0";
+    readonly description = "Enhanced NumPy ndarray -> TypedArray mapping";
+    readonly supportedModules: readonly ["numpy", "np"];
+    readonly handledTypes: readonly ["ndarray", "matrix", "MaskedArray"];
+    onInit(ctx: PluginInitContext): void;
+    transformResult(raw: SerializedValue, typeHint: string): NumPyArrayResult | null;
+    private _handle;
+}
+//# sourceMappingURL=NumpyPlugin.d.ts.map

package/dist/plugins/builtin/NumpyPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumpyPlugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/builtin/NumpyPlugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAO5E,qBAAa,WAAY,YAAW,YAAY;IAC9C,QAAQ,CAAC,IAAI,WAAuB;IACpC,QAAQ,CAAC,OAAO,WAAoB;IACpC,QAAQ,CAAC,WAAW,kDAAuD;IAC3E,QAAQ,CAAC,gBAAgB,2BAA4B;IACrD,QAAQ,CAAC,YAAY,gDAAqD;IAE1E,MAAM,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI;IAKpC,eAAe,CAAC,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAKhF,OAAO,CAAC,OAAO;CAIhB"}

package/dist/plugins/builtin/NumpyPlugin.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * pynect - NumpyPlugin (built-in)
+ * Routes ndarray wire objects through NumpyBridge.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NumpyPlugin = void 0;
+const NumpyBridge_1 = require("../../serialization/NumpyBridge");
+const Logger_1 = require("../../utils/Logger");
+const logger = new Logger_1.Logger('NumpyPlugin');
+const bridge = new NumpyBridge_1.NumpyBridge();
+class NumpyPlugin {
+    name = 'numpy';
+    version = '1.0.0';
+    description = 'Enhanced NumPy ndarray -> TypedArray mapping';
+    supportedModules = ['numpy', 'np'];
+    handledTypes = ['ndarray', 'matrix', 'MaskedArray'];
+    onInit(ctx) {
+        for (const t of this.handledTypes) {
+            ctx.registerTypeHandler(t, this._handle.bind(this));
+        }
+        logger.debug('NumpyPlugin initialised');
+    }
+    transformResult(raw, typeHint) {
+        if (this.handledTypes.includes(typeHint)) {
+            return this._handle(raw, typeHint, {});
+        }
+        return null;
+    }
+    _handle(raw, _type, _meta) {
+        try {
+            return bridge.deserialize(raw);
+        }
+        catch (err) {
+            logger.warn(`ndarray deserialization error: ${err}`);
+            return null;
+        }
+    }
+}
+exports.NumpyPlugin = NumpyPlugin;
+//# sourceMappingURL=NumpyPlugin.js.map

package/dist/plugins/builtin/NumpyPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumpyPlugin.js","sourceRoot":"","sources":["../../../src/plugins/builtin/NumpyPlugin.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH,iEAA8D;AAC9D,+CAA4C;AAE5C,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,aAAa,CAAC,CAAC;AACzC,MAAM,MAAM,GAAG,IAAI,yBAAW,EAAE,CAAC;AAEjC,MAAa,WAAW;IACb,IAAI,GAAe,OAAO,CAAC;IAC3B,OAAO,GAAY,OAAO,CAAC;IAC3B,WAAW,GAAQ,8CAA8C,CAAC;IAClE,gBAAgB,GAAG,CAAC,OAAO,EAAE,IAAI,CAAU,CAAC;IAC5C,YAAY,GAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,aAAa,CAAU,CAAC;IAE1E,MAAM,CAAC,GAAsB;QAC3B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAAA,GAAG,CAAC,mBAAmB,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAAA,CAAC;QACzF,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC1C,CAAC;IAED,eAAe,CAAC,GAAoB,EAAE,QAAgB;QACpD,IAAK,IAAI,CAAC,YAAkC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAA,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;QAAA,CAAC;QAC1G,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,OAAO,CAAC,GAAoB,EAAE,KAAc,EAAE,KAA+B;QACnF,IAAI,CAAC;YAAC,OAAO,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QACvC,OAAO,GAAG,EAAE,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,kCAAkC,GAAG,EAAE,CAAC,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;IACpF,CAAC;CACF;AArBD,kCAqBC"}

package/dist/plugins/builtin/PandasPlugin.d.ts

@@ -0,0 +1,19 @@
+/**
+ * pynect - PandasPlugin (built-in)
+ * Intercepts DataFrame/Series wire objects and routes through DataFrameBridge.
+ */
+import type { PynectPlugin, PluginInitContext } from '../Plugin.interface';
+import type { SerializedValue, DataFrameResult, SeriesResult } from '../../types/python';
+export declare class PandasPlugin implements PynectPlugin {
+    readonly name = "pandas";
+    readonly version = "1.0.0";
+    readonly description = "Enhanced pandas DataFrame and Series support";
+    readonly supportedModules: readonly ["pandas", "pd"];
+    readonly handledTypes: readonly ["DataFrame", "Series", "DataFrameGroupBy", "SeriesGroupBy"];
+    onInit(ctx: PluginInitContext): void;
+    onModuleImported(moduleName: string): void;
+    transformResult(raw: SerializedValue, typeHint: string): DataFrameResult | SeriesResult | null;
+    private _handleDF;
+    private _handleSeries;
+}
+//# sourceMappingURL=PandasPlugin.d.ts.map

package/dist/plugins/builtin/PandasPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PandasPlugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/builtin/PandasPlugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOzF,qBAAa,YAAa,YAAW,YAAY;IAC/C,QAAQ,CAAC,IAAI,YAAwB;IACrC,QAAQ,CAAC,OAAO,WAAoB;IACpC,QAAQ,CAAC,WAAW,kDAAuD;IAC3E,QAAQ,CAAC,gBAAgB,4BAA6B;IACtD,QAAQ,CAAC,YAAY,wEAA6E;IAElG,MAAM,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI;IAQpC,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAI1C,eAAe,CAAC,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,YAAY,GAAG,IAAI;IAM9F,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,aAAa;CAItB"}

package/dist/plugins/builtin/PandasPlugin.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * pynect - PandasPlugin (built-in)
+ * Intercepts DataFrame/Series wire objects and routes through DataFrameBridge.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PandasPlugin = void 0;
+const DataFrameBridge_1 = require("../../serialization/DataFrameBridge");
+const Logger_1 = require("../../utils/Logger");
+const logger = new Logger_1.Logger('PandasPlugin');
+const bridge = new DataFrameBridge_1.DataFrameBridge();
+class PandasPlugin {
+    name = 'pandas';
+    version = '1.0.0';
+    description = 'Enhanced pandas DataFrame and Series support';
+    supportedModules = ['pandas', 'pd'];
+    handledTypes = ['DataFrame', 'Series', 'DataFrameGroupBy', 'SeriesGroupBy'];
+    onInit(ctx) {
+        ctx.registerTypeHandler('DataFrame', this._handleDF.bind(this));
+        ctx.registerTypeHandler('DataFrameGroupBy', this._handleDF.bind(this));
+        ctx.registerTypeHandler('Series', this._handleSeries.bind(this));
+        ctx.registerTypeHandler('SeriesGroupBy', this._handleSeries.bind(this));
+        logger.debug('PandasPlugin initialised');
+    }
+    onModuleImported(moduleName) {
+        logger.debug(`pandas module imported: ${moduleName}`);
+    }
+    transformResult(raw, typeHint) {
+        if (typeHint === 'DataFrame' || typeHint === 'DataFrameGroupBy') {
+            return this._handleDF(raw, typeHint, {});
+        }
+        if (typeHint === 'Series' || typeHint === 'SeriesGroupBy') {
+            return this._handleSeries(raw, typeHint, {});
+        }
+        return null;
+    }
+    _handleDF(raw, _typeHint, _meta) {
+        try {
+            return bridge.deserializeDataFrame(raw);
+        }
+        catch (err) {
+            logger.warn(`DataFrame deserialization error: ${err}`);
+            return null;
+        }
+    }
+    _handleSeries(raw, _typeHint, _meta) {
+        try {
+            return bridge.deserializeSeries(raw);
+        }
+        catch (err) {
+            logger.warn(`Series deserialization error: ${err}`);
+            return null;
+        }
+    }
+}
+exports.PandasPlugin = PandasPlugin;
+//# sourceMappingURL=PandasPlugin.js.map

package/dist/plugins/builtin/PandasPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PandasPlugin.js","sourceRoot":"","sources":["../../../src/plugins/builtin/PandasPlugin.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH,yEAAsE;AACtE,+CAA4C;AAE5C,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,cAAc,CAAC,CAAC;AAC1C,MAAM,MAAM,GAAG,IAAI,iCAAe,EAAE,CAAC;AAErC,MAAa,YAAY;IACd,IAAI,GAAe,QAAQ,CAAC;IAC5B,OAAO,GAAY,OAAO,CAAC;IAC3B,WAAW,GAAQ,8CAA8C,CAAC;IAClE,gBAAgB,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAU,CAAC;IAC7C,YAAY,GAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,kBAAkB,EAAE,eAAe,CAAU,CAAC;IAElG,MAAM,CAAC,GAAsB;QAC3B,GAAG,CAAC,mBAAmB,CAAC,WAAW,EAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACvE,GAAG,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACvE,GAAG,CAAC,mBAAmB,CAAC,QAAQ,EAAY,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3E,GAAG,CAAC,mBAAmB,CAAC,eAAe,EAAK,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3E,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC3C,CAAC;IAED,gBAAgB,CAAC,UAAkB;QACjC,MAAM,CAAC,KAAK,CAAC,2BAA2B,UAAU,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,eAAe,CAAC,GAAoB,EAAE,QAAgB;QACpD,IAAI,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,kBAAkB,EAAE,CAAC;YAAA,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;QAAA,CAAC;QAC5G,IAAI,QAAQ,KAAK,QAAQ,IAAM,QAAQ,KAAK,eAAe,EAAK,CAAC;YAAA,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;QAAA,CAAC;QAC/G,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,SAAS,CAAC,GAAoB,EAAE,SAAkB,EAAE,KAA+B;QACzF,IAAI,CAAC;YAAC,OAAO,MAAM,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAChD,OAAO,GAAG,EAAE,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,oCAAoC,GAAG,EAAE,CAAC,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;IACtF,CAAC;IAEO,aAAa,CAAC,GAAoB,EAAE,SAAkB,EAAE,KAA+B;QAC7F,IAAI,CAAC;YAAC,OAAO,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAC7C,OAAO,GAAG,EAAE,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;IACnF,CAAC;CACF;AAlCD,oCAkCC"}

package/dist/plugins/builtin/TorchPlugin.d.ts

@@ -0,0 +1,23 @@
+/**
+ * pynect - TorchPlugin (built-in)
+ * Handles PyTorch Tensor objects - delegates to NumpyBridge (tensors are NumPy-compatible).
+ */
+import type { PynectPlugin, PluginInitContext } from '../Plugin.interface';
+import type { SerializedValue, NumPyArrayResult } from '../../types/python';
+export type TensorResult = NumPyArrayResult & {
+    requiresGrad: boolean;
+    isCuda: boolean;
+    device: string;
+    gradFn: string | null;
+};
+export declare class TorchPlugin implements PynectPlugin {
+    readonly name = "torch";
+    readonly version = "1.0.0";
+    readonly description = "Enhanced PyTorch Tensor support";
+    readonly supportedModules: readonly ["torch"];
+    readonly handledTypes: readonly ["Tensor"];
+    onInit(ctx: PluginInitContext): void;
+    transformResult(raw: SerializedValue, typeHint: string, meta: Record<string, unknown>): TensorResult | null;
+    private _handle;
+}
+//# sourceMappingURL=TorchPlugin.d.ts.map

package/dist/plugins/builtin/TorchPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TorchPlugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/builtin/TorchPlugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAO5E,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG;IAC5C,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAQ,OAAO,CAAC;IACtB,MAAM,EAAQ,MAAM,CAAC;IACrB,MAAM,EAAQ,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAA;AAED,qBAAa,WAAY,YAAW,YAAY;IAC9C,QAAQ,CAAC,IAAI,WAAuB;IACpC,QAAQ,CAAC,OAAO,WAAoB;IACpC,QAAQ,CAAC,WAAW,qCAA0C;IAC9D,QAAQ,CAAC,gBAAgB,qBAAsB;IAC/C,QAAQ,CAAC,YAAY,sBAA2B;IAEhD,MAAM,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI;IAKpC,eAAe,CAAC,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,GAAG,IAAI;IAI3G,OAAO,CAAC,OAAO;CAkBhB"}

package/dist/plugins/builtin/TorchPlugin.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * pynect - TorchPlugin (built-in)
+ * Handles PyTorch Tensor objects - delegates to NumpyBridge (tensors are NumPy-compatible).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TorchPlugin = void 0;
+const NumpyBridge_1 = require("../../serialization/NumpyBridge");
+const Logger_1 = require("../../utils/Logger");
+const logger = new Logger_1.Logger('TorchPlugin');
+const bridge = new NumpyBridge_1.NumpyBridge();
+class TorchPlugin {
+    name = 'torch';
+    version = '1.0.0';
+    description = 'Enhanced PyTorch Tensor support';
+    supportedModules = ['torch'];
+    handledTypes = ['Tensor'];
+    onInit(ctx) {
+        ctx.registerTypeHandler('Tensor', this._handle.bind(this));
+        logger.debug('TorchPlugin initialised');
+    }
+    transformResult(raw, typeHint, meta) {
+        return typeHint === 'Tensor' ? this._handle(raw, typeHint, meta) : null;
+    }
+    _handle(raw, _t, meta) {
+        try {
+            const base = bridge.deserialize(raw);
+            if (!base) {
+                return null;
+            }
+            const isCuda = Boolean(meta?.['isCuda']);
+            if (isCuda) {
+                logger.warn('CUDA Tensor: data was copied to CPU for transfer.');
+            }
+            return {
+                ...base,
+                requiresGrad: Boolean(meta?.['requiresGrad']),
+                isCuda,
+                device: String(meta?.['device'] ?? 'cpu'),
+                gradFn: meta?.['gradFn'] !== null && meta?.['gradFn'] !== undefined ? String(meta?.['gradFn']) : null,
+            };
+        }
+        catch (err) {
+            logger.warn(`Tensor deserialization error: ${err}`);
+            return null;
+        }
+    }
+}
+exports.TorchPlugin = TorchPlugin;
+//# sourceMappingURL=TorchPlugin.js.map

package/dist/plugins/builtin/TorchPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TorchPlugin.js","sourceRoot":"","sources":["../../../src/plugins/builtin/TorchPlugin.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH,iEAA8D;AAC9D,+CAA4C;AAE5C,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,aAAa,CAAC,CAAC;AACzC,MAAM,MAAM,GAAG,IAAI,yBAAW,EAAE,CAAC;AASjC,MAAa,WAAW;IACb,IAAI,GAAe,OAAO,CAAC;IAC3B,OAAO,GAAY,OAAO,CAAC;IAC3B,WAAW,GAAQ,iCAAiC,CAAC;IACrD,gBAAgB,GAAG,CAAC,OAAO,CAAU,CAAC;IACtC,YAAY,GAAO,CAAC,QAAQ,CAAU,CAAC;IAEhD,MAAM,CAAC,GAAsB;QAC3B,GAAG,CAAC,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3D,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC1C,CAAC;IAED,eAAe,CAAC,GAAoB,EAAE,QAAgB,EAAE,IAA6B;QACnF,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1E,CAAC;IAEO,OAAO,CAAC,GAAoB,EAAE,EAAW,EAAE,IAA8B;QAC/E,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAAA,OAAO,IAAI,CAAC;YAAA,CAAC;YACzB,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YACzC,IAAI,MAAM,EAAE,CAAC;gBAAA,MAAM,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;YAAA,CAAC;YAC/E,OAAO;gBACL,GAAG,IAAI;gBACP,YAAY,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,cAAc,CAAC,CAAC;gBAC7C,MAAM;gBACN,MAAM,EAAG,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC;gBAC1C,MAAM,EAAG,IAAI,EAAE,CAAC,QAAQ,CAAC,KAAK,IAAI,IAAI,IAAI,EAAE,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;aACvF,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAC;YACpD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAlCD,kCAkCC"}

package/dist/plugins/index.d.ts

@@ -0,0 +1,7 @@
+export type { PynectPlugin, PluginRegistration, PluginInitContext, TypeTransformHandler, PythonTypeName } from './Plugin.interface';
+export { PluginManager } from './PluginManager';
+export { PandasPlugin } from './builtin/PandasPlugin';
+export { NumpyPlugin } from './builtin/NumpyPlugin';
+export { TorchPlugin } from './builtin/TorchPlugin';
+export type { TensorResult } from './builtin/TorchPlugin';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpI,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAO,uBAAuB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAO,uBAAuB,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/plugins/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TorchPlugin = exports.NumpyPlugin = exports.PandasPlugin = exports.PluginManager = void 0;
+var PluginManager_1 = require("./PluginManager");
+Object.defineProperty(exports, "PluginManager", { enumerable: true, get: function () { return PluginManager_1.PluginManager; } });
+var PandasPlugin_1 = require("./builtin/PandasPlugin");
+Object.defineProperty(exports, "PandasPlugin", { enumerable: true, get: function () { return PandasPlugin_1.PandasPlugin; } });
+var NumpyPlugin_1 = require("./builtin/NumpyPlugin");
+Object.defineProperty(exports, "NumpyPlugin", { enumerable: true, get: function () { return NumpyPlugin_1.NumpyPlugin; } });
+var TorchPlugin_1 = require("./builtin/TorchPlugin");
+Object.defineProperty(exports, "TorchPlugin", { enumerable: true, get: function () { return TorchPlugin_1.TorchPlugin; } });
+//# sourceMappingURL=index.js.map

package/dist/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":";;;AACA,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,uDAAsD;AAA7C,4GAAA,YAAY,OAAA;AACrB,qDAAqD;AAA5C,0GAAA,WAAW,OAAA;AACpB,qDAAqD;AAA5C,0GAAA,WAAW,OAAA"}