nodepyx 1.0.0

package/dist/types/PythonTypeMapper.js

@@ -0,0 +1,449 @@
+"use strict";
+/**
+ * nodepyx — PythonTypeMapper
+ * Maps Python type annotation strings → TypeScript type strings.
+ *
+ * Handles:
+ *  - Python built-in types (str, int, float, bool, …)
+ *  - typing module generics (List[X], Dict[K,V], Optional[X], Union[A,B], …)
+ *  - numpy / pandas / torch special types
+ *  - Forward references (strings in quotes)
+ *  - PEP 604 union syntax (X | Y)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PythonTypeMapper = void 0;
+exports.mapType = mapType;
+exports.mapReturnType = mapReturnType;
+exports.mapDefaultValue = mapDefaultValue;
+exports.splitGenericParams = splitGenericParams;
+// ─── Core mapping table ────────────────────────────────────────────────────
+const BUILTIN_MAP = {
+    // ── Primitives ──────────────────────────────────────────────────────────
+    'str': { tsType: 'string' },
+    'int': { tsType: 'number' },
+    'float': { tsType: 'number' },
+    'complex': { tsType: '{ real: number; imag: number }' },
+    'bool': { tsType: 'boolean' },
+    'bytes': { tsType: 'Uint8Array' },
+    'bytearray': { tsType: 'Uint8Array' },
+    'memoryview': { tsType: 'Uint8Array' },
+    // ── None / null-like ────────────────────────────────────────────────────
+    'None': { tsType: 'null' },
+    'NoneType': { tsType: 'null' },
+    'type(None)': { tsType: 'null' },
+    // ── Collections (unparameterized) ───────────────────────────────────────
+    'list': { tsType: 'unknown[]' },
+    'tuple': { tsType: 'readonly unknown[]' },
+    'dict': { tsType: 'Record<string, unknown>' },
+    'set': { tsType: 'Set<unknown>' },
+    'frozenset': { tsType: 'ReadonlySet<unknown>' },
+    // ── typing module ───────────────────────────────────────────────────────
+    'Any': { tsType: 'unknown' },
+    'NoReturn': { tsType: 'never' },
+    'Never': { tsType: 'never' },
+    'ClassVar': { tsType: 'unknown' },
+    'Final': { tsType: 'unknown' },
+    'Literal': { tsType: 'unknown' },
+    // ── IO / streams ────────────────────────────────────────────────────────
+    'IO': { tsType: 'unknown' },
+    'TextIO': { tsType: 'string' },
+    'BinaryIO': { tsType: 'Uint8Array' },
+    // ── Callable ────────────────────────────────────────────────────────────
+    'Callable': { tsType: '(...args: unknown[]) => unknown' },
+    // ── Numeric tower ───────────────────────────────────────────────────────
+    'Number': { tsType: 'number' },
+    'Integer': { tsType: 'number' },
+    'Float': { tsType: 'number' },
+    'Decimal': { tsType: 'number' },
+    'Fraction': { tsType: 'number' },
+    // ── datetime ────────────────────────────────────────────────────────────
+    'datetime': { tsType: 'Date' },
+    'date': { tsType: 'Date' },
+    'time': { tsType: 'Date' },
+    'timedelta': { tsType: 'number' },
+    'datetime.datetime': { tsType: 'Date' },
+    'datetime.date': { tsType: 'Date' },
+    'datetime.time': { tsType: 'Date' },
+    'datetime.timedelta': { tsType: 'number' },
+    // ── pathlib ─────────────────────────────────────────────────────────────
+    'Path': { tsType: 'string' },
+    'PurePath': { tsType: 'string' },
+    'PosixPath': { tsType: 'string' },
+    'WindowsPath': { tsType: 'string' },
+    'pathlib.Path': { tsType: 'string' },
+    // ── uuid ─────────────────────────────────────────────────────────────────
+    'UUID': { tsType: 'string' },
+    'uuid.UUID': { tsType: 'string' },
+    // ── NumPy ────────────────────────────────────────────────────────────────
+    'ndarray': { tsType: 'Float64Array | Float32Array | Int32Array | Uint8Array' },
+    'np.ndarray': { tsType: 'Float64Array | Float32Array | Int32Array | Uint8Array' },
+    'numpy.ndarray': { tsType: 'Float64Array | Float32Array | Int32Array | Uint8Array' },
+    'np.float32': { tsType: 'Float32Array' },
+    'np.float64': { tsType: 'Float64Array' },
+    'np.int32': { tsType: 'Int32Array' },
+    'np.int64': { tsType: 'BigInt64Array' },
+    'np.uint8': { tsType: 'Uint8Array' },
+    'np.uint16': { tsType: 'Uint16Array' },
+    'np.uint32': { tsType: 'Uint32Array' },
+    'np.bool_': { tsType: 'Uint8Array' },
+    'numpy.float64': { tsType: 'number' },
+    'numpy.float32': { tsType: 'number' },
+    'numpy.int64': { tsType: 'number' },
+    'numpy.int32': { tsType: 'number' },
+    // ── Pandas ───────────────────────────────────────────────────────────────
+    'DataFrame': { tsType: 'DataFrameResult' },
+    'pd.DataFrame': { tsType: 'DataFrameResult' },
+    'pandas.DataFrame': { tsType: 'DataFrameResult' },
+    'Series': { tsType: 'SeriesResult' },
+    'pd.Series': { tsType: 'SeriesResult' },
+    'pandas.Series': { tsType: 'SeriesResult' },
+    'Index': { tsType: 'unknown[]' },
+    'pd.Index': { tsType: 'unknown[]' },
+    'MultiIndex': { tsType: 'unknown[][]' },
+    // ── PyTorch ───────────────────────────────────────────────────────────────
+    'Tensor': { tsType: 'Float32Array | Float64Array' },
+    'torch.Tensor': { tsType: 'Float32Array | Float64Array' },
+    'torch.nn.Module': { tsType: 'PyProxy' },
+    'torch.optim.Optimizer': { tsType: 'PyProxy' },
+    // ── sklearn ───────────────────────────────────────────────────────────────
+    'BaseEstimator': { tsType: 'PyProxy' },
+    'ClassifierMixin': { tsType: 'PyProxy' },
+    'RegressorMixin': { tsType: 'PyProxy' },
+    'TransformerMixin': { tsType: 'PyProxy' },
+    // ── fallback ─────────────────────────────────────────────────────────────
+    'object': { tsType: 'unknown' },
+    'type': { tsType: 'PyProxy' },
+    'module': { tsType: 'PyProxy' },
+};
+// ─── Generic type constructors ────────────────────────────────────────────
+/** Patterns for parameterized generics like List[str], Dict[str, int], … */
+const GENERIC_PATTERNS = [
+    // Iterator[T]
+    {
+        re: /^Iterator\[(.+)\]$/i,
+        map: ([inner], ctx) => `AsyncIterator<${mapType(inner, ctx)}>`,
+    },
+    // Set[T]
+    {
+        re: /^Set\[(.+)\]$/i,
+        map: ([inner], ctx) => `Set<${mapType(inner, ctx)}>`,
+    },
+    // FrozenSet[T]
+    {
+        re: /^FrozenSet\[(.+)\]$/i,
+        map: ([inner], ctx) => `ReadonlySet<${mapType(inner, ctx)}>`,
+    },
+    // Generator[YieldType, ...] — handled before the generic catch-all
+    {
+        re: /^Generator\[(.+)\]$/i,
+        map: ([inner], ctx) => {
+            const parts = splitGenericParams(inner);
+            return `AsyncGenerator<${mapType(parts[0], ctx)}>`;
+        },
+    },
+    // List[T] / Sequence[T] / Iterable[T] / MutableSequence[T] / Collection[T] / etc.
+    {
+        re: /^(?:List|Sequence|Iterable|MutableSequence|Collection|AbstractSet|MutableSet|Deque|Queue)\[(.+)\]$/i,
+        map: ([inner], ctx) => `Array<${mapType(inner, ctx)}>`,
+    },
+    // Tuple[A, B, C]
+    {
+        re: /^(?:Tuple)\[(.+)\]$/i,
+        map: ([inner], ctx) => {
+            if (inner === '...') {
+                return `unknown[]`;
+            }
+            const parts = splitGenericParams(inner);
+            if (parts.length === 2 && parts[1] === '...') {
+                return `Array<${mapType(parts[0], ctx)}>`;
+            }
+            return `[${parts.map(p => mapType(p, ctx)).join(', ')}]`;
+        },
+    },
+    // Dict[K, V] / Mapping[K, V] / MutableMapping[K, V]
+    {
+        re: /^(?:Dict|Mapping|MutableMapping|OrderedDict|DefaultDict|ChainMap)\[(.+)\]$/i,
+        map: ([inner], ctx) => {
+            const parts = splitGenericParams(inner);
+            if (parts.length === 2) {
+                return `Record<${mapType(parts[0], ctx)}, ${mapType(parts[1], ctx)}>`;
+            }
+            return `Record<string, unknown>`;
+        },
+    },
+    // Optional[T] → T | null
+    {
+        re: /^Optional\[(.+)\]$/i,
+        map: ([inner], ctx) => `${mapType(inner, ctx)} | null`,
+    },
+    // Union[A, B, C]
+    {
+        re: /^Union\[(.+)\]$/i,
+        map: ([inner], ctx) => {
+            const parts = splitGenericParams(inner);
+            return parts.map(p => mapType(p, ctx)).join(' | ');
+        },
+    },
+    // PEP 604 — A | B | C (raw union)
+    // Note: params[0] is the first capture group; we reconstruct the full string
+    // by combining all capture groups back with ' | ' to split properly.
+    {
+        re: /^(.+)\s*\|\s*(.+)$/,
+        map: (params, ctx) => {
+            // params[0..n] are capture groups; rejoin and re-split at top-level pipes
+            const full = params.join(' | ');
+            const parts = splitPipeUnion(full);
+            return parts.map(p => mapType(p.trim(), ctx)).join(' | ');
+        },
+    },
+    // Callable[[A, B], R]
+    {
+        re: /^Callable\[\[(.*)?\],\s*(.+)\]$/i,
+        map: ([params, ret], ctx) => {
+            if (!params) {
+                return `() => ${mapType(ret, ctx)}`;
+            }
+            const paramTypes = splitGenericParams(params).map((p, i) => `arg${i}: ${mapType(p, ctx)}`);
+            return `(${paramTypes.join(', ')}) => ${mapType(ret, ctx)}`;
+        },
+    },
+    // Type[T] / ClassVar[T] / Final[T]
+    {
+        re: /^(?:Type|ClassVar|Final)\[(.+)\]$/i,
+        map: ([inner], ctx) => mapType(inner, ctx),
+    },
+    // Awaitable[T] / Coroutine[…, T]
+    {
+        re: /^(?:Awaitable|Coroutine)\[.*?,?\s*(.+)\]$/i,
+        map: ([ret], ctx) => `Promise<${mapType(ret, ctx)}>`,
+    },
+    // AsyncIterator[T] / AsyncIterable[T] / AsyncGenerator[T]
+    {
+        re: /^(?:AsyncIterator|AsyncIterable|AsyncGenerator)\[(.+)\]$/i,
+        map: ([inner], ctx) => `AsyncIterable<${mapType(inner, ctx)}>`,
+    },
+];
+// ─── Main mapType function ────────────────────────────────────────────────
+/**
+ * Map a Python type annotation string to a TypeScript type string.
+ *
+ * @example
+ * ```typescript
+ * mapType('List[int]')               // → 'Array<number>'
+ * mapType('Dict[str, float]')        // → 'Record<string, number>'
+ * mapType('Optional[DataFrame]')     // → 'DataFrameResult | null'
+ * mapType('Union[str, int, None]')   // → 'string | number | null'
+ * mapType('Tuple[int, str, bool]')   // → '[number, string, boolean]'
+ * ```
+ */
+function mapType(pythonType, ctx = {}) {
+    if (!pythonType) {
+        return 'unknown';
+    }
+    const trimmed = pythonType.trim();
+    // ── Direct lookup ───────────────────────────────────────────────────────
+    const direct = BUILTIN_MAP[trimmed];
+    if (direct) {
+        return direct.tsType;
+    }
+    // ── Strip module qualifiers for a second lookup ─────────────────────────
+    const unqualified = trimmed.includes('.')
+        ? trimmed.split('.').pop()
+        : trimmed;
+    const unqualLookup = BUILTIN_MAP[unqualified];
+    if (unqualLookup) {
+        return unqualLookup.tsType;
+    }
+    // ── Generic patterns ────────────────────────────────────────────────────
+    for (const pattern of GENERIC_PATTERNS) {
+        const match = trimmed.match(pattern.re);
+        if (match) {
+            const capturedGroups = match.slice(1);
+            // Pass the full raw string for PEP-604 union
+            return pattern.map(capturedGroups, ctx);
+        }
+    }
+    // ── Known class from current module ─────────────────────────────────────
+    if (ctx.knownClasses?.has(trimmed) || ctx.knownClasses?.has(unqualified)) {
+        return 'PyProxy';
+    }
+    // ── String forward reference (PEP 484) ──────────────────────────────────
+    if ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+        (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        return mapType(trimmed.slice(1, -1), ctx);
+    }
+    // ── Fallback ─────────────────────────────────────────────────────────────
+    // Unknown types always map to 'unknown' (not PyProxy) for better type safety
+    return 'unknown';
+}
+// ─── mapReturnType (adds Promise<> wrapping) ────────────────────────────────
+/**
+ * Map a Python return type annotation.
+ * Automatically wraps the result in `Promise<>` since all Python calls
+ * are asynchronous from the JavaScript side.
+ *
+ * Generator / Iterator returns are mapped to `AsyncGenerator`.
+ * None → Promise<void>
+ */
+function mapReturnType(pythonReturnType, ctx = {}) {
+    if (!pythonReturnType || pythonReturnType === 'None' || pythonReturnType === 'NoneType') {
+        return 'Promise<void>';
+    }
+    if (pythonReturnType === 'NoReturn' || pythonReturnType === 'Never') {
+        return 'never';
+    }
+    // Generator → AsyncGenerator
+    if (/^Generator\[/.test(pythonReturnType)) {
+        const inner = pythonReturnType.match(/^Generator\[(.+)\]/)?.[1] ?? 'unknown';
+        const parts = splitGenericParams(inner);
+        return `AsyncGenerator<${mapType(parts[0], ctx)}>`;
+    }
+    // Coroutine / Awaitable → strip wrapper, it becomes the resolved type
+    const awaitMatch = pythonReturnType.match(/^(?:Awaitable|Coroutine)\[.*?,?\s*(.+)\]$/i);
+    if (awaitMatch) {
+        return `Promise<${mapType(awaitMatch[1], ctx)}>`;
+    }
+    const inner = mapType(pythonReturnType, ctx);
+    return `Promise<${inner}>`;
+}
+// ─── Parameter default value helper ──────────────────────────────────────────
+/**
+ * Convert a Python default value representation to a TypeScript literal.
+ */
+function mapDefaultValue(pythonDefault) {
+    if (pythonDefault === 'None') {
+        return 'null';
+    }
+    if (pythonDefault === 'True') {
+        return 'true';
+    }
+    if (pythonDefault === 'False') {
+        return 'false';
+    }
+    if (/^-?\d+(\.\d+)?$/.test(pythonDefault)) {
+        return pythonDefault;
+    }
+    if (pythonDefault.startsWith("'") || pythonDefault.startsWith('"')) {
+        return pythonDefault.replace(/^'|'$/g, '"');
+    }
+    return `undefined /* ${pythonDefault} */`;
+}
+// ─── Splitting helpers ─────────────────────────────────────────────────────
+/**
+ * Split generic parameters at the top level (respects nested brackets).
+ * e.g. "str, Dict[str, int], bool" → ["str", "Dict[str, int]", "bool"]
+ */
+function splitGenericParams(params) {
+    const result = [];
+    let depth = 0;
+    let current = '';
+    for (const ch of params) {
+        if (ch === '[') {
+            depth++;
+            current += ch;
+        }
+        else if (ch === ']') {
+            depth--;
+            current += ch;
+        }
+        else if (ch === ',' && depth === 0) {
+            result.push(current.trim());
+            current = '';
+        }
+        else {
+            current += ch;
+        }
+    }
+    if (current.trim()) {
+        result.push(current.trim());
+    }
+    return result;
+}
+/**
+ * Split a PEP 604 union "A | B | C" at top-level pipes.
+ */
+function splitPipeUnion(type) {
+    const result = [];
+    let depth = 0;
+    let current = '';
+    for (const ch of type) {
+        if (ch === '[') {
+            depth++;
+            current += ch;
+        }
+        else if (ch === ']') {
+            depth--;
+            current += ch;
+        }
+        else if (ch === '|' && depth === 0) {
+            result.push(current.trim());
+            current = '';
+        }
+        else {
+            current += ch;
+        }
+    }
+    if (current.trim()) {
+        result.push(current.trim());
+    }
+    return result;
+}
+// ─── PythonTypeMapper class (stateful, module-aware) ──────────────────────
+/**
+ * Stateful type mapper that accumulates required imports
+ * and knows which class names belong to the current module.
+ *
+ * @example
+ * ```typescript
+ * const mapper = new PythonTypeMapper({ moduleName: 'sklearn.linear_model' });
+ * mapper.registerClass('LinearRegression');
+ *
+ * mapper.map('LinearRegression')  // → 'LinearRegression' (local class ref)
+ * mapper.map('DataFrame')         // → 'DataFrameResult'
+ * ```
+ */
+class PythonTypeMapper {
+    _ctx;
+    _imports = new Map();
+    constructor(ctx = {}) {
+        this._ctx = {
+            ...ctx,
+            knownClasses: ctx.knownClasses ?? new Set(),
+        };
+    }
+    registerClass(name) {
+        this._ctx.knownClasses.add(name);
+    }
+    map(pyType) {
+        const result = mapType(pyType, this._ctx);
+        // Auto-track imports for well-known result types
+        if (result === 'DataFrameResult') {
+            this.addImport('DataFrameResult', 'nodepyx');
+        }
+        else if (result === 'SeriesResult') {
+            this.addImport('SeriesResult', 'nodepyx');
+        }
+        else if (result === 'NumPyArrayResult') {
+            this.addImport('NumPyArrayResult', 'nodepyx');
+        }
+        return result;
+    }
+    mapReturn(pyType) {
+        return mapReturnType(pyType, this._ctx);
+    }
+    addImport(symbol, from) {
+        if (!this._imports.has(from)) {
+            this._imports.set(from, new Set());
+        }
+        this._imports.get(from).add(symbol);
+    }
+    generateImportBlock() {
+        const lines = [];
+        for (const [from, symbols] of this._imports) {
+            lines.push(`import type { ${[...symbols].join(', ')} } from '${from}';`);
+        }
+        return lines.join('\n');
+    }
+}
+exports.PythonTypeMapper = PythonTypeMapper;
+//# sourceMappingURL=PythonTypeMapper.js.map

package/dist/types/PythonTypeMapper.js.map

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

package/dist/types/StubCache.d.ts

@@ -0,0 +1,109 @@
+/**
+ * nodepyx — StubCache
+ * Manages the on-disk cache of generated TypeScript stub files (.d.ts).
+ *
+ * Cache layout on disk (default: <project>/.nodepyx/stubs/):
+ *   <stubsDir>/
+ *     pandas.d.ts           ← generated stub
+ *     numpy.d.ts
+ *     …
+ *     _meta.json            ← cache metadata / timestamps
+ *
+ * A cached stub is considered stale when:
+ *   1. The Python library version changes (checked via pip show).
+ *   2. nodepyx itself is updated (checked via package version hash).
+ *   3. maxAgeMs has elapsed (default: 7 days).
+ *
+ * The cache falls back gracefully when the disk is unavailable (read-only
+ * filesystem, CI environments, etc.).
+ */
+export interface StubCacheOptions {
+    /** Directory where stub files are stored. Default: './.nodepyx/stubs' */
+    stubsDir?: string;
+    /** Time-to-live for cached stubs in ms. Default: 7 days */
+    maxAgeMs?: number;
+    /** Disable the cache entirely (always regenerate). Default: false */
+    disabled?: boolean;
+    /** nodepyx package version string (used in staleness checks) */
+    nodepyxVersion?: string;
+}
+/**
+ * StubCache — read / write TypeScript stubs to the on-disk cache.
+ *
+ * @example
+ * ```typescript
+ * const cache = new StubCache({ stubsDir: './.nodepyx/stubs' });
+ *
+ * // Check if a fresh stub exists
+ * const hit = cache.get('pandas');
+ * if (hit) {
+ *   console.log(hit);  // .d.ts content
+ * } else {
+ *   const dts = await generateStub('pandas');
+ *   cache.set('pandas', dts, { libVersion: '2.1.0' });
+ * }
+ * ```
+ */
+export declare class StubCache {
+    private readonly _stubsDir;
+    private readonly _maxAgeMs;
+    private readonly _disabled;
+    private readonly _nodepyxVersion;
+    private _meta;
+    private _initialized;
+    constructor(options?: StubCacheOptions);
+    /**
+     * Get cached stub content for a module.
+     * Returns null on miss, staleness, or if the cache is disabled.
+     */
+    get(moduleName: string, libVersion?: string): string | null;
+    /**
+     * Store a stub in the cache.
+     */
+    set(moduleName: string, content: string, options?: {
+        libVersion?: string;
+    }): void;
+    /**
+     * Remove a single stub from the cache.
+     */
+    invalidate(moduleName: string): void;
+    /**
+     * Clear all cached stubs.
+     */
+    clear(): void;
+    /**
+     * List all cached module names.
+     */
+    list(): string[];
+    /**
+     * Check whether a fresh stub is cached.
+     */
+    has(moduleName: string, libVersion?: string): boolean;
+    /**
+     * Return the absolute path to the stub file for a module.
+     */
+    stubPath(moduleName: string): string;
+    /**
+     * Return the stubs directory path.
+     */
+    get stubsDir(): string;
+    /**
+     * Copy a pre-built stub from the package's bundled stubs directory
+     * to the project's stub cache.  Pre-built stubs ship inside the nodepyx
+     * package for common libraries (pandas, numpy, sklearn, torch).
+     */
+    copyPrebuilt(moduleName: string): boolean;
+    /**
+     * Pre-populate the cache with all bundled stubs.
+     */
+    initPrebuilts(): void;
+    private _ensureInit;
+    private _ensureDir;
+    private _saveMeta;
+    private _stubPath;
+    private _isStale;
+    private _readnodepyxVersion;
+    /** djb2 hash — fast, not cryptographic */
+    private _hash;
+}
+//# sourceMappingURL=StubCache.d.ts.map

package/dist/types/StubCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StubCache.d.ts","sourceRoot":"","sources":["../../src/types/StubCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AA2BH,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gEAAgE;IAChE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,GAAE,gBAAqB;IAS1C;;;OAGG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAwB3D;;OAEG;IACH,GAAG,CACD,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO,GACpC,IAAI;IAwBP;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAkBpC;;OAEG;IACH,KAAK,IAAI,IAAI;IAmBb;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;IAUhB;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO;IAIrD;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAIpC;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAID;;;;OAIG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAgBzC;;OAEG;IACH,aAAa,IAAI,IAAI;IAWrB,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,mBAAmB;IAa3B,4CAA4C;IAC5C,OAAO,CAAC,KAAK;CAOd"}