@ya-modbus/driver-loader 0.10.0 → 0.11.1

package/dist/cjs/src/loader.js

@@ -37,11 +37,23 @@ exports.clearDriverCache = clearDriverCache;
 exports.getDriverCacheStats = getDriverCacheStats;
 exports.loadDriver = loadDriver;
 const promises_1 = require("fs/promises");
-const path_1 = require("path");
 const config_validator_js_1 = require("./config-validator.js");
 const driver_import_js_1 = require("./driver-import.js");
 const driver_name_js_1 = require("./driver-name.js");
 const errors_js_1 = require("./errors.js");
+const local_package_js_1 = require("./local-package.js");
+/**
+ * Native `import()`, in the CommonJS build as well
+ *
+ * The CommonJS build compiles `import()` to `require()`, which cannot load a `file:` URL.
+ * Going through `Function` keeps the native `import()`, which also loads ES modules.
+ */
+/* istanbul ignore next */
+const nativeImport = (specifier) => {
+    // eslint-disable-next-line @typescript-eslint/no-implied-eval -- keeps `import()` out of the CommonJS transform
+    const importFn = new Function('specifier', 'return import(specifier)');
+    return importFn(specifier);
+};
 /**
  * Default system dependencies using Node.js built-ins
  */
@@ -50,7 +62,7 @@ const defaultDeps = {
     /* istanbul ignore next */
     readFile: (path, encoding) => (0, promises_1.readFile)(path, encoding),
     /* istanbul ignore next */
-    importModule: (modulePath) => Promise.resolve(`${modulePath}`).then(s => __importStar(require(s))),
+    importModule: (specifier) => specifier.startsWith('file:') ? nativeImport(specifier) : Promise.resolve(`${specifier}`).then(s => __importStar(require(s))),
     /* istanbul ignore next */
     getCwd: () => process.cwd(),
 };
@@ -85,76 +97,24 @@ function getDriverCacheStats() {
         size: driverCache.size,
     };
 }
-/**
- * Auto-detect local driver package from package.json
- *
- * @param deps - System dependencies
- * @returns Package name if valid driver package
- * @throws Error if not a valid driver package
- */
-async function detectLocalPackage(deps) {
-    try {
-        const packageJsonPath = (0, path_1.join)(deps.getCwd(), 'package.json');
-        const packageJsonContent = await deps.readFile(packageJsonPath, 'utf-8');
-        const packageJson = JSON.parse(packageJsonContent);
-        const keywords = packageJson.keywords ?? [];
-        if (!keywords.includes('ya-modbus-driver')) {
-            throw new errors_js_1.PackageJsonError('Current package is not a ya-modbus driver. ' +
-                'Add "ya-modbus-driver" to keywords in package.json');
-        }
-        const name = packageJson.name;
-        if (!name) {
-            throw new errors_js_1.PackageJsonError('package.json must have a "name" field');
-        }
-        return name;
-    }
-    catch (error) {
-        if (error.code === 'ENOENT') {
-            throw new errors_js_1.PackageJsonError('package.json not found in current directory. ' +
-                'Run this command from a driver package directory or specify --driver');
-        }
-        if (error instanceof SyntaxError) {
-            throw new errors_js_1.PackageJsonError('Failed to parse package.json: invalid JSON');
-        }
-        throw error;
-    }
-}
-/**
- * Try to import a module with multiple path attempts
- *
- * @param paths - Array of module paths to try
- * @param deps - System dependencies
- * @returns Imported module
- * @throws Error if all paths fail
- */
-async function tryImport(paths, deps) {
-    const errors = [];
-    for (const path of paths) {
-        try {
-            return await deps.importModule(path);
-        }
-        catch (error) {
-            errors.push(error);
-        }
-    }
-    const lastError = errors[errors.length - 1];
-    throw new Error(`Failed to import module from any path. Tried: ${paths.join(', ')}\nLast error: ${lastError?.message}`, { cause: lastError });
-}
 /**
  * Load a driver package dynamically
  *
  * Supports two modes:
- * 1. Explicit package: `loadDriver({ driverPackage: 'ya-modbus-driver-xymd1' })`
+ * 1. Explicit package: `loadDriver({ driverPackage: '@ya-modbus/driver-xymd1' })`
  * 2. Auto-detect from cwd: `loadDriver({})` - reads package.json from current directory
  *
- * Auto-detection checks for `ya-modbus-driver` keyword in package.json keywords.
+ * Auto-detection checks for `ya-modbus-driver` keyword in package.json keywords and loads
+ * the entry file that `import` of the package resolves to (`exports["."]`, else `main`,
+ * else `index.js`). The driver must be built: the entry file is JavaScript, or TypeScript
+ * that Node can run itself.
  *
  * @example
  * // Auto-detect from current directory
  * const driver = await loadDriver({})
  *
  * // Load explicit package
- * const driver = await loadDriver({ driverPackage: 'ya-modbus-driver-xymd1' })
+ * const driver = await loadDriver({ driverPackage: '@ya-modbus/driver-xymd1' })
  *
  * @param options - Loading options (defaults to local package detection)
  * @param deps - System dependencies (for testing, uses Node.js built-ins by default)
@@ -181,21 +141,15 @@ async function loadDriver(options = {}, deps = defaultDeps) {
             driverModule = imported.driverModule;
         }
         else {
-            packageName = await detectLocalPackage(deps);
+            const localPackage = await (0, local_package_js_1.detectLocalPackage)(deps);
+            packageName = localPackage.name;
             const cached = driverCache.get(packageName);
             if (cached) {
                 cacheStats.hits++;
                 return cached;
             }
             cacheStats.misses++;
-            const cwd = deps.getCwd();
-            const importPaths = [
-                (0, path_1.join)(cwd, 'src', 'index.js'),
-                (0, path_1.join)(cwd, 'src', 'index.ts'),
-                (0, path_1.join)(cwd, 'dist', 'index.js'),
-                packageName,
-            ];
-            driverModule = await tryImport(importPaths, deps);
+            driverModule = await (0, driver_import_js_1.importLocalDriver)(packageName, localPackage.entryPoint, deps);
         }
         if (!driverModule || typeof driverModule !== 'object') {
             throw new errors_js_1.ValidationError('Driver package must export a createDriver function', 'createDriver');
@@ -231,6 +185,7 @@ async function loadDriver(options = {}, deps = defaultDeps) {
     catch (error) {
         if (error instanceof errors_js_1.ValidationError ||
             error instanceof errors_js_1.DriverNotFoundError ||
+            error instanceof errors_js_1.DriverNotBuiltError ||
             error instanceof errors_js_1.PackageJsonError) {
             throw error;
         }

package/dist/cjs/src/loader.js.map

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

package/dist/cjs/src/local-package.d.ts

@@ -0,0 +1,19 @@
+import type { SystemDependencies } from './loader.js';
+/**
+ * A driver package found in the current directory
+ */
+export interface LocalPackage {
+    /** Name from package.json */
+    name: string;
+    /** Absolute path of the file that importing the package loads */
+    entryPoint: string;
+}
+/**
+ * Auto-detect local driver package from package.json
+ *
+ * @param deps - System dependencies
+ * @returns Package name and entry file if valid driver package
+ * @throws Error if not a valid driver package
+ */
+export declare function detectLocalPackage(deps: Pick<SystemDependencies, 'getCwd' | 'readFile'>): Promise<LocalPackage>;
+//# sourceMappingURL=local-package.d.ts.map

package/dist/cjs/src/local-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-package.d.ts","sourceRoot":"","sources":["../../../src/local-package.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,GAAG,UAAU,CAAC,GACpD,OAAO,CAAC,YAAY,CAAC,CAkDvB"}

package/dist/cjs/src/local-package.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectLocalPackage = detectLocalPackage;
+const node_path_1 = require("node:path");
+const entry_point_js_1 = require("./entry-point.js");
+const errors_js_1 = require("./errors.js");
+/**
+ * Auto-detect local driver package from package.json
+ *
+ * @param deps - System dependencies
+ * @returns Package name and entry file if valid driver package
+ * @throws Error if not a valid driver package
+ */
+async function detectLocalPackage(deps) {
+    try {
+        const cwd = deps.getCwd();
+        const packageJsonContent = await deps.readFile((0, node_path_1.join)(cwd, 'package.json'), 'utf-8');
+        const packageJson = JSON.parse(packageJsonContent);
+        const keywords = packageJson.keywords ?? [];
+        if (!keywords.includes('ya-modbus-driver')) {
+            throw new errors_js_1.PackageJsonError('Current package is not a ya-modbus driver. ' +
+                'Add "ya-modbus-driver" to keywords in package.json');
+        }
+        const name = packageJson.name;
+        if (!name) {
+            throw new errors_js_1.PackageJsonError('package.json must have a "name" field');
+        }
+        const entry = (0, entry_point_js_1.resolvePackageEntry)(packageJson);
+        if (entry === undefined) {
+            throw new errors_js_1.PackageJsonError('package.json "exports" has no entry for "." that can be imported. ' +
+                'Add an "import" or "default" condition to exports["."]');
+        }
+        if ((0, node_path_1.extname)(entry) === '') {
+            throw new errors_js_1.PackageJsonError(`The entry point "${entry}" in package.json has no file extension. ` +
+                'Name the built file, for example "./dist/index.js"');
+        }
+        return { name, entryPoint: (0, node_path_1.join)(cwd, entry) };
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new errors_js_1.PackageJsonError('package.json not found in current directory. ' +
+                'Run this command from a driver package directory or specify --driver');
+        }
+        if (error instanceof SyntaxError) {
+            throw new errors_js_1.PackageJsonError('Failed to parse package.json: invalid JSON');
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=local-package.js.map

package/dist/cjs/src/local-package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-package.js","sourceRoot":"","sources":["../../../src/local-package.ts"],"names":[],"mappings":";;AAuBA,gDAoDC;AA3ED,yCAAyC;AAEzC,qDAA+E;AAC/E,2CAA8C;AAa9C;;;;;;GAMG;AACI,KAAK,UAAU,kBAAkB,CACtC,IAAqD;IAErD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;QACzB,MAAM,kBAAkB,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAA;QAClF,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAGhD,CAAA;QAED,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,IAAI,EAAE,CAAA;QAC3C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,4BAAgB,CACxB,6CAA6C;gBAC3C,oDAAoD,CACvD,CAAA;QACH,CAAC;QAED,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAA;QAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,4BAAgB,CAAC,uCAAuC,CAAC,CAAA;QACrE,CAAC;QAED,MAAM,KAAK,GAAG,IAAA,oCAAmB,EAAC,WAAW,CAAC,CAAA;QAC9C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,4BAAgB,CACxB,oEAAoE;gBAClE,wDAAwD,CAC3D,CAAA;QACH,CAAC;QAED,IAAI,IAAA,mBAAO,EAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;YAC1B,MAAM,IAAI,4BAAgB,CACxB,oBAAoB,KAAK,2CAA2C;gBAClE,oDAAoD,CACvD,CAAA;QACH,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAA,gBAAI,EAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAA;IAC/C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,MAAM,IAAI,4BAAgB,CACxB,+CAA+C;gBAC7C,sEAAsE,CACzE,CAAA;QACH,CAAC;QACD,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;YACjC,MAAM,IAAI,4BAAgB,CAAC,4CAA4C,CAAC,CAAA;QAC1E,CAAC;QACD,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/cjs/src/module-errors.d.ts

@@ -6,4 +6,28 @@
  * Node names the package in quotes, in both the ESM and the CommonJS wording.
  */
 export declare function isMissingPackageError(error: unknown, packageName: string): boolean;
+/** Why a driver cannot be loaded as built JavaScript */
+export type NotBuiltCause = 
+/** A file of the driver is missing, such as the entry file when there is no `dist` directory */
+'missing-file'
+/** The driver is TypeScript source and Node does not run it, because it is too old or has type stripping off */
+ | 'typescript'
+/** Node strips types, but the TypeScript uses syntax or imports that type stripping cannot run */
+ | 'typescript-unsupported'
+/** Node does not run TypeScript from `node_modules` */
+ | 'typescript-in-node-modules';
+/**
+ * Find out if an import failed because the driver is not built
+ *
+ * A missing file counts when Node names it by its absolute path. A package that is not
+ * installed, or a missing dependency, is named by its package name, so neither matches.
+ * With `entryPoint` (a local driver) only the entry file itself counts. Another missing
+ * file of a built driver is a bug in the driver, which building does not fix, unless
+ * TypeScript source asks for it (importing `./x.js` when only `x.ts` exists).
+ *
+ * @param error - What the import threw
+ * @param entryPoint - Absolute path of the entry file, if it is known
+ * @returns The cause, or undefined if the error is about something else
+ */
+export declare function getNotBuiltCause(error: unknown, entryPoint?: string): NotBuiltCause | undefined;
 //# sourceMappingURL=module-errors.d.ts.map

package/dist/cjs/src/module-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-errors.d.ts","sourceRoot":"","sources":["../../../src/module-errors.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAYlF"}
+{"version":3,"file":"module-errors.d.ts","sourceRoot":"","sources":["../../../src/module-errors.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAYlF;AAED,wDAAwD;AACxD,MAAM,MAAM,aAAa;AACvB,gGAAgG;AAC9F,cAAc;AAChB,gHAAgH;GAC9G,YAAY;AACd,kGAAkG;GAChG,wBAAwB;AAC1B,uDAAuD;GACrD,4BAA4B,CAAA;AAEhC;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAiC/F"}

package/dist/cjs/src/module-errors.js

@@ -1,7 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isMissingPackageError = isMissingPackageError;
+exports.getNotBuiltCause = getNotBuiltCause;
 const NOT_FOUND_CODES = new Set(['ERR_MODULE_NOT_FOUND', 'MODULE_NOT_FOUND']);
+/** Node does not know TypeScript files: too old, or type stripping is off */
+const UNKNOWN_TYPESCRIPT = /Unknown file extension "\.[cm]?ts"/;
+/**
+ * What Node could not find (a package name, or the absolute path of a file on POSIX or
+ * Windows), and the file that wanted it (not in the CommonJS wording)
+ */
+const MISSING_TARGET = /Cannot find (?:module|package) '([^']+)'(?: imported from ([^\n]+))?/;
+const ABSOLUTE_PATH = /^(?:[/\\]|[A-Za-z]:)/;
+const TYPESCRIPT_FILE = /\.[cm]?tsx?$/;
 /**
  * Check if an import failed because the package itself is not installed
  *
@@ -19,4 +29,49 @@ function isMissingPackageError(error, packageName) {
         typeof message === 'string' &&
         message.includes(`'${packageName}'`));
 }
+/**
+ * Find out if an import failed because the driver is not built
+ *
+ * A missing file counts when Node names it by its absolute path. A package that is not
+ * installed, or a missing dependency, is named by its package name, so neither matches.
+ * With `entryPoint` (a local driver) only the entry file itself counts. Another missing
+ * file of a built driver is a bug in the driver, which building does not fix, unless
+ * TypeScript source asks for it (importing `./x.js` when only `x.ts` exists).
+ *
+ * @param error - What the import threw
+ * @param entryPoint - Absolute path of the entry file, if it is known
+ * @returns The cause, or undefined if the error is about something else
+ */
+function getNotBuiltCause(error, entryPoint) {
+    if (typeof error !== 'object' || error === null) {
+        return undefined;
+    }
+    const { code, message } = error;
+    if (code === 'ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING') {
+        return 'typescript-in-node-modules';
+    }
+    if (code === 'ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX') {
+        return 'typescript-unsupported';
+    }
+    if (typeof code !== 'string' || typeof message !== 'string') {
+        return undefined;
+    }
+    if (code === 'ERR_UNKNOWN_FILE_EXTENSION') {
+        if (!UNKNOWN_TYPESCRIPT.test(message)) {
+            return undefined;
+        }
+        return message.includes('node_modules') ? 'typescript-in-node-modules' : 'typescript';
+    }
+    if (!NOT_FOUND_CODES.has(code)) {
+        return undefined;
+    }
+    const [, missing, importer = ''] = MISSING_TARGET.exec(message) ?? [];
+    if (missing === undefined || !ABSOLUTE_PATH.test(missing)) {
+        return undefined;
+    }
+    if (TYPESCRIPT_FILE.test(importer)) {
+        return 'typescript-unsupported';
+    }
+    return entryPoint === undefined || missing === entryPoint ? 'missing-file' : undefined;
+}
 //# sourceMappingURL=module-errors.js.map

package/dist/cjs/src/module-errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"module-errors.js","sourceRoot":"","sources":["../../../src/module-errors.ts"],"names":[],"mappings":";;AASA,sDAYC;AArBD,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,sBAAsB,EAAE,kBAAkB,CAAC,CAAC,CAAA;AAE7E;;;;;;GAMG;AACH,SAAgB,qBAAqB,CAAC,KAAc,EAAE,WAAmB;IACvE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAA8C,CAAA;IACxE,OAAO,CACL,OAAO,IAAI,KAAK,QAAQ;QACxB,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;QACzB,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,WAAW,GAAG,CAAC,CACrC,CAAA;AACH,CAAC"}
+{"version":3,"file":"module-errors.js","sourceRoot":"","sources":["../../../src/module-errors.ts"],"names":[],"mappings":";;AAoBA,sDAYC;AA0BD,4CAiCC;AA3FD,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,sBAAsB,EAAE,kBAAkB,CAAC,CAAC,CAAA;AAE7E,6EAA6E;AAC7E,MAAM,kBAAkB,GAAG,oCAAoC,CAAA;AAE/D;;;GAGG;AACH,MAAM,cAAc,GAAG,sEAAsE,CAAA;AAC7F,MAAM,aAAa,GAAG,sBAAsB,CAAA;AAC5C,MAAM,eAAe,GAAG,cAAc,CAAA;AAEtC;;;;;;GAMG;AACH,SAAgB,qBAAqB,CAAC,KAAc,EAAE,WAAmB;IACvE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAA8C,CAAA;IACxE,OAAO,CACL,OAAO,IAAI,KAAK,QAAQ;QACxB,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;QACzB,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,WAAW,GAAG,CAAC,CACrC,CAAA;AACH,CAAC;AAaD;;;;;;;;;;;;GAYG;AACH,SAAgB,gBAAgB,CAAC,KAAc,EAAE,UAAmB;IAClE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAA8C,CAAA;IACxE,IAAI,IAAI,KAAK,6CAA6C,EAAE,CAAC;QAC3D,OAAO,4BAA4B,CAAA;IACrC,CAAC;IACD,IAAI,IAAI,KAAK,mCAAmC,EAAE,CAAC;QACjD,OAAO,wBAAwB,CAAA;IACjC,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5D,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,IAAI,KAAK,4BAA4B,EAAE,CAAC;QAC1C,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACtC,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,OAAO,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,YAAY,CAAA;IACvF,CAAC;IACD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,GAAG,EAAE,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;IACrE,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1D,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,OAAO,wBAAwB,CAAA;IACjC,CAAC;IACD,OAAO,UAAU,KAAK,SAAS,IAAI,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAA;AACxF,CAAC"}