@nielspeter/eess-ts 0.1.0

package/dist/models/arch-call.d.ts

@@ -0,0 +1,83 @@
+import { type CallExpression, type SourceFile, type Node } from 'ts-morph';
+/**
+ * Options for {@link ArchCall.getName}.
+ *
+ * Both fields are opt-in. With no options, `getName()` returns the bare
+ * `${object}.${method}` form (e.g. `app.post`) — the predicate-visible
+ * identity.
+ */
+export interface GetNameOptions {
+    /**
+     * Index of an argument whose source text should be folded into the
+     * returned name. When the indexed argument is a `StringLiteral` or
+     * `NoSubstitutionTemplateLiteral`, the returned name becomes
+     * `` `${callee}(${arg.getText()})` ``. Otherwise the bare name is
+     * returned unchanged (graceful degrade — see plan 0057 edge cases).
+     */
+    readonly withArgument?: number;
+    /**
+     * When `true` and `withArgument` produced an enriched name, elide
+     * the middle of a literal whose `getText()` exceeds 80 characters
+     * with `…`. Uses `slice(0, 38) + '…' + slice(-38)` so the resulting
+     * literal portion is exactly 77 characters.
+     *
+     * Used at violation-message sites to keep CI output scannable.
+     * The element field passes `elide: false` (the default) so exclusion
+     * patterns key on stable, verbatim identities.
+     */
+    readonly elide?: boolean;
+}
+/**
+ * Unified representation of a call expression in the project.
+ *
+ * Wraps a ts-morph CallExpression with precomputed fields for
+ * efficient predicate evaluation.
+ *
+ * Satisfies Named and Located interfaces from identity predicates.
+ * Does NOT satisfy Exportable --- call expressions cannot be exported.
+ */
+export interface ArchCall {
+    /**
+     * Full expression text, e.g. "app.get", "router.post", "db.query".
+     *
+     * With `options.withArgument` set, folds the indexed argument's raw
+     * source text into the name when it's a `StringLiteral` or
+     * `NoSubstitutionTemplateLiteral`. See {@link GetNameOptions}.
+     *
+     * Identity predicates (`haveNameMatching`, etc.) call this with no
+     * arguments and see the bare name — argument enrichment is an
+     * identity/exclusion concern, not a filtering concern. To filter by
+     * argument value, use `withStringArg(i, glob)` or
+     * `withArgMatching(i, pattern)`.
+     */
+    getName(options?: GetNameOptions): string | undefined;
+    /** Source file containing this call expression. */
+    getSourceFile(): SourceFile;
+    /** The object the method is called on, or undefined for bare calls. */
+    getObjectName(): string | undefined;
+    /** The method name, or the function name for bare calls. */
+    getMethodName(): string | undefined;
+    /** The arguments to the call expression. */
+    getArguments(): Node[];
+    /** Underlying ts-morph CallExpression node. */
+    getNode(): CallExpression;
+    /** Start line number in the source file. */
+    getStartLineNumber(): number;
+}
+/**
+ * Create an ArchCall from a CallExpression.
+ *
+ * Precomputes object name and method name from the call expression.
+ * For `app.get(...)`, objectName is "app" and methodName is "get".
+ * For `handleError(...)`, objectName is undefined and methodName is "handleError".
+ */
+export declare function fromCallExpression(expr: CallExpression): ArchCall;
+/**
+ * Scan a source file for all call expressions.
+ *
+ * Walks all descendants of kind CallExpression. This includes
+ * nested calls (e.g., calls inside callbacks), which is intentional ---
+ * users filter with predicates to select the calls they care about.
+ */
+export declare function collectCalls(sourceFile: SourceFile): ArchCall[];
+//# sourceMappingURL=arch-call.d.ts.map

package/dist/models/arch-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arch-call.d.ts","sourceRoot":"","sources":["../../src/models/arch-call.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,IAAI,EAGV,MAAM,UAAU,CAAA;AAEjB;;;;;;GAMG;AAEH,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAE9B;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAAA;IAErD,mDAAmD;IACnD,aAAa,IAAI,UAAU,CAAA;IAE3B,uEAAuE;IACvE,aAAa,IAAI,MAAM,GAAG,SAAS,CAAA;IAEnC,4DAA4D;IAC5D,aAAa,IAAI,MAAM,GAAG,SAAS,CAAA;IAEnC,4CAA4C;IAC5C,YAAY,IAAI,IAAI,EAAE,CAAA;IAEtB,+CAA+C;IAC/C,OAAO,IAAI,cAAc,CAAA;IAEzB,4CAA4C;IAC5C,kBAAkB,IAAI,MAAM,CAAA;CAC7B;AAqCD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,QAAQ,CAmCjE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,EAAE,CAM/D"}

package/dist/models/arch-call.js

@@ -0,0 +1,90 @@
+import { Node as NodeUtils, SyntaxKind, } from 'ts-morph';
+/**
+ * Build the argument-enriched suffix for `ArchCall.getName`.
+ *
+ * Returns the raw source text of `expr.getArguments()[index]` iff that
+ * argument is a `StringLiteral` or `NoSubstitutionTemplateLiteral`.
+ * Otherwise returns undefined → caller falls back to the bare name.
+ *
+ * Degrade cases (all return undefined):
+ * - Out-of-bounds index
+ * - `AsExpression` (e.g. `'/foo' as const`)
+ * - `ParenthesizedExpression` (e.g. `('/foo')`)
+ * - `TemplateExpression` with substitutions (e.g. `` `/foo/${x}` ``)
+ * - Tagged templates (e.g. `` sql`SELECT ...` ``)
+ * - Identifiers and member expressions
+ * - Spread elements
+ * - Non-string literals (numeric, boolean, etc.)
+ */
+function buildEnrichedSuffix(expr, index, elide) {
+    const args = expr.getArguments();
+    const arg = args[index];
+    if (!arg)
+        return undefined;
+    if (!NodeUtils.isStringLiteral(arg) && !NodeUtils.isNoSubstitutionTemplateLiteral(arg)) {
+        return undefined;
+    }
+    const raw = arg.getText();
+    if (elide && raw.length > 80) {
+        return `${raw.slice(0, 38)}…${raw.slice(-38)}`;
+    }
+    return raw;
+}
+/**
+ * Create an ArchCall from a CallExpression.
+ *
+ * Precomputes object name and method name from the call expression.
+ * For `app.get(...)`, objectName is "app" and methodName is "get".
+ * For `handleError(...)`, objectName is undefined and methodName is "handleError".
+ */
+export function fromCallExpression(expr) {
+    const callExpr = expr.getExpression();
+    let objectName;
+    let methodName;
+    if (NodeUtils.isPropertyAccessExpression(callExpr)) {
+        // app.get(...) => object="app", method="get"
+        // router.route.get(...) => object="router.route", method="get"
+        methodName = callExpr.getName();
+        objectName = callExpr.getExpression().getText();
+    }
+    else if (NodeUtils.isIdentifier(callExpr)) {
+        // handleError(...) => object=undefined, method="handleError"
+        methodName = callExpr.getText();
+    }
+    else {
+        // Computed or other expression, e.g. getHandler()()
+        methodName = callExpr.getText();
+    }
+    const fullName = objectName !== undefined ? `${objectName}.${methodName}` : methodName;
+    return {
+        getName: (options) => {
+            if (options?.withArgument === undefined)
+                return fullName;
+            const suffix = buildEnrichedSuffix(expr, options.withArgument, options.elide ?? false);
+            if (suffix === undefined)
+                return fullName;
+            return `${fullName}(${suffix})`;
+        },
+        getSourceFile: () => expr.getSourceFile(),
+        getObjectName: () => objectName,
+        getMethodName: () => methodName,
+        getArguments: () => expr.getArguments(),
+        getNode: () => expr,
+        getStartLineNumber: () => expr.getStartLineNumber(),
+    };
+}
+/**
+ * Scan a source file for all call expressions.
+ *
+ * Walks all descendants of kind CallExpression. This includes
+ * nested calls (e.g., calls inside callbacks), which is intentional ---
+ * users filter with predicates to select the calls they care about.
+ */
+export function collectCalls(sourceFile) {
+    const calls = [];
+    for (const callExpr of sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression)) {
+        calls.push(fromCallExpression(callExpr));
+    }
+    return calls;
+}
+//# sourceMappingURL=arch-call.js.map

package/dist/models/arch-call.js.map

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

package/dist/models/arch-function.d.ts

@@ -0,0 +1,76 @@
+import { type FunctionDeclaration, type VariableDeclaration, type MethodDeclaration, type SourceFile, type ParameterDeclaration, type Type, type Node } from 'ts-morph';
+/**
+ * Unified representation of a TypeScript function.
+ *
+ * Wraps both FunctionDeclaration (`function foo() {}`) and
+ * VariableDeclaration with ArrowFunction initializer (`const foo = () => {}`).
+ *
+ * Satisfies Named, Located, and Exportable interfaces from identity predicates.
+ */
+export interface ArchFunction {
+    /** Function name, or undefined for anonymous functions. */
+    getName(): string | undefined;
+    /** Source file containing this function. */
+    getSourceFile(): SourceFile;
+    /** Whether this function is exported from its module. */
+    isExported(): boolean;
+    /** Whether this function is declared async. */
+    isAsync(): boolean;
+    /** Parameter declarations of this function. */
+    getParameters(): ParameterDeclaration[];
+    /** Return type of this function (resolved by the type checker). */
+    getReturnType(): Type;
+    /** Function body node, for body analysis (plan 0011). */
+    getBody(): Node | undefined;
+    /**
+     * Underlying ts-morph node for violation reporting.
+     * FunctionDeclaration or VariableDeclaration.
+     */
+    getNode(): Node;
+    /**
+     * Start line number in the source file.
+     * Used for violation reporting.
+     */
+    getStartLineNumber(): number;
+    /**
+     * Visibility scope of this function.
+     *
+     * - Standalone functions and arrow functions are always `'public'` (module-level).
+     * - Class methods return their actual modifier (`public`, `protected`, or `private`).
+     *   Methods with no explicit modifier default to `'public'`.
+     */
+    getScope(): 'public' | 'protected' | 'private';
+}
+/**
+ * Create an ArchFunction from a FunctionDeclaration.
+ */
+export declare function fromFunctionDeclaration(decl: FunctionDeclaration): ArchFunction;
+/**
+ * Create an ArchFunction from a VariableDeclaration whose initializer
+ * is an ArrowFunction.
+ *
+ * Precondition: caller must verify the initializer is an ArrowFunction.
+ */
+export declare function fromArrowVariableDeclaration(decl: VariableDeclaration): ArchFunction;
+/**
+ * Create an ArchFunction from a class MethodDeclaration.
+ *
+ * Method name is prefixed with the class name for clarity in violation messages:
+ * "Space.getWebhooks" instead of just "getWebhooks".
+ */
+export declare function fromMethodDeclaration(method: MethodDeclaration): ArchFunction;
+/**
+ * Scan a source file for all functions.
+ *
+ * Returns ArchFunction wrappers for:
+ * 1. FunctionDeclarations — `function foo() {}`
+ * 2. VariableDeclarations with ArrowFunction initializer — `const foo = () => {}`
+ * 3. Class MethodDeclarations — `class Foo { bar() {} }` (when includeMethods is true)
+ *
+ * @param sourceFile - The source file to scan
+ * @param options - Set `includeMethods: true` to include class methods (default: true)
+ */
+export declare function collectFunctions(sourceFile: SourceFile, options?: {
+    includeMethods?: boolean;
+}): ArchFunction[];
+//# sourceMappingURL=arch-function.d.ts.map

package/dist/models/arch-function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arch-function.d.ts","sourceRoot":"","sources":["../../src/models/arch-function.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,oBAAoB,EACzB,KAAK,IAAI,EACT,KAAK,IAAI,EAIV,MAAM,UAAU,CAAA;AAEjB;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,OAAO,IAAI,MAAM,GAAG,SAAS,CAAA;IAE7B,4CAA4C;IAC5C,aAAa,IAAI,UAAU,CAAA;IAE3B,yDAAyD;IACzD,UAAU,IAAI,OAAO,CAAA;IAErB,+CAA+C;IAC/C,OAAO,IAAI,OAAO,CAAA;IAElB,+CAA+C;IAC/C,aAAa,IAAI,oBAAoB,EAAE,CAAA;IAEvC,mEAAmE;IACnE,aAAa,IAAI,IAAI,CAAA;IAErB,yDAAyD;IACzD,OAAO,IAAI,IAAI,GAAG,SAAS,CAAA;IAE3B;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAA;IAEf;;;OAGG;IACH,kBAAkB,IAAI,MAAM,CAAA;IAE5B;;;;;;OAMG;IACH,QAAQ,IAAI,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAA;CAC/C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,mBAAmB,GAAG,YAAY,CAa/E;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,mBAAmB,GAAG,YAAY,CAoBpF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,YAAY,CAgC7E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GACrC,YAAY,EAAE,CA0BhB"}

package/dist/models/arch-function.js

@@ -0,0 +1,122 @@
+import { Node as NodeClass, Scope, SyntaxKind, } from 'ts-morph';
+/**
+ * Create an ArchFunction from a FunctionDeclaration.
+ */
+export function fromFunctionDeclaration(decl) {
+    return {
+        getName: () => decl.getName(),
+        getSourceFile: () => decl.getSourceFile(),
+        isExported: () => decl.isExported(),
+        isAsync: () => decl.isAsync(),
+        getParameters: () => decl.getParameters(),
+        getReturnType: () => decl.getReturnType(),
+        getBody: () => decl.getBody(),
+        getNode: () => decl,
+        getStartLineNumber: () => decl.getStartLineNumber(),
+        getScope: () => 'public',
+    };
+}
+/**
+ * Create an ArchFunction from a VariableDeclaration whose initializer
+ * is an ArrowFunction.
+ *
+ * Precondition: caller must verify the initializer is an ArrowFunction.
+ */
+export function fromArrowVariableDeclaration(decl) {
+    const arrow = decl.getInitializerIfKind(SyntaxKind.ArrowFunction);
+    if (!arrow)
+        throw new Error('Expected arrow function initializer');
+    return {
+        getName: () => decl.getName(),
+        getSourceFile: () => decl.getSourceFile(),
+        isExported: () => {
+            // VariableDeclaration itself doesn't have isExported —
+            // check the parent VariableStatement.
+            const varStatement = decl.getVariableStatement();
+            return varStatement?.isExported() ?? false;
+        },
+        isAsync: () => arrow.isAsync(),
+        getParameters: () => arrow.getParameters(),
+        getReturnType: () => arrow.getReturnType(),
+        getBody: () => arrow.getBody(),
+        getNode: () => decl,
+        getStartLineNumber: () => decl.getStartLineNumber(),
+        getScope: () => 'public',
+    };
+}
+/**
+ * Create an ArchFunction from a class MethodDeclaration.
+ *
+ * Method name is prefixed with the class name for clarity in violation messages:
+ * "Space.getWebhooks" instead of just "getWebhooks".
+ */
+export function fromMethodDeclaration(method) {
+    const parent = method.getParent();
+    const className = NodeClass.isClassDeclaration(parent)
+        ? (parent.getName() ?? '<anonymous>')
+        : '<anonymous>';
+    return {
+        getName: () => {
+            const methodName = method.getName();
+            return `${className}.${methodName}`;
+        },
+        getSourceFile: () => method.getSourceFile(),
+        isExported: () => {
+            // A method is "exported" if its class is exported (ADR-005: use type guard)
+            const cls = method.getParent();
+            if (NodeClass.isClassDeclaration(cls)) {
+                return cls.isExported();
+            }
+            return false;
+        },
+        isAsync: () => method.isAsync(),
+        getParameters: () => method.getParameters(),
+        getReturnType: () => method.getReturnType(),
+        getBody: () => method.getBody(),
+        getNode: () => method,
+        getStartLineNumber: () => method.getStartLineNumber(),
+        getScope: () => {
+            const scope = method.getScope();
+            if (scope === Scope.Protected)
+                return 'protected';
+            if (scope === Scope.Private)
+                return 'private';
+            return 'public';
+        },
+    };
+}
+/**
+ * Scan a source file for all functions.
+ *
+ * Returns ArchFunction wrappers for:
+ * 1. FunctionDeclarations — `function foo() {}`
+ * 2. VariableDeclarations with ArrowFunction initializer — `const foo = () => {}`
+ * 3. Class MethodDeclarations — `class Foo { bar() {} }` (when includeMethods is true)
+ *
+ * @param sourceFile - The source file to scan
+ * @param options - Set `includeMethods: true` to include class methods (default: true)
+ */
+export function collectFunctions(sourceFile, options) {
+    const includeMethods = options?.includeMethods ?? true;
+    const functions = [];
+    // Pattern 1: FunctionDeclarations
+    for (const fn of sourceFile.getFunctions()) {
+        functions.push(fromFunctionDeclaration(fn));
+    }
+    // Pattern 2: const arrow functions
+    for (const varDecl of sourceFile.getVariableDeclarations()) {
+        if (varDecl.getInitializerIfKind(SyntaxKind.ArrowFunction)) {
+            functions.push(fromArrowVariableDeclaration(varDecl));
+        }
+    }
+    // Pattern 3: class methods
+    if (includeMethods) {
+        for (const cls of sourceFile.getClasses()) {
+            for (const method of cls.getMethods()) {
+                functions.push(fromMethodDeclaration(method));
+            }
+        }
+    }
+    return functions;
+}
+//# sourceMappingURL=arch-function.js.map

package/dist/models/arch-function.js.map

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

package/dist/models/arch-jsx-element.d.ts

@@ -0,0 +1,75 @@
+import { type JsxElement, type JsxSelfClosingElement, type SourceFile } from 'ts-morph';
+/**
+ * Standard HTML tag names per the WHATWG HTML Living Standard.
+ * Use with `areHtmlElements(...STANDARD_HTML_TAGS)`
+ * for unambiguous "all standard HTML elements" matching (excludes custom
+ * elements like `<my-widget>`).
+ */
+export declare const STANDARD_HTML_TAGS: readonly string[];
+/**
+ * Unified representation of a JSX element in the project.
+ *
+ * Wraps both JsxElement (has children) and JsxSelfClosingElement (no children)
+ * with a uniform interface for predicate/condition evaluation.
+ *
+ * Satisfies Named (getName) and Located (getSourceFile) interfaces from
+ * identity predicates.
+ */
+export interface ArchJsxElement {
+    /** Tag name: 'div', 'Button', 'Icons.Check', etc. */
+    getName(): string;
+    /** Source file containing this element. */
+    getSourceFile(): SourceFile;
+    /**
+     * Whether this is an HTML intrinsic element (lowercase first char, no dot).
+     * Dot-notation tags (e.g. `motion.div`) are always classified as components.
+     */
+    isHtmlElement(): boolean;
+    /**
+     * Whether this is a component element (uppercase first char or dot-notation).
+     */
+    isComponent(): boolean;
+    /**
+     * Get attribute value by name. Returns undefined if absent or valueless.
+     * For valueless attributes (`<input disabled />`), returns undefined —
+     * use `hasAttribute('disabled')` for presence checks.
+     * For expression attributes (`onClick={() => {}}`), returns the raw
+     * initializer text including braces (e.g. `{() => {}}`).
+     *
+     * Only checks named JsxAttribute nodes — spread attributes are not inspected.
+     */
+    getAttribute(name: string): string | undefined;
+    /**
+     * Check whether a named attribute exists (including valueless like `disabled`).
+     * Spread attributes (`{...props}`) are not inspected.
+     */
+    hasAttribute(name: string): boolean;
+    /**
+     * Get all named attribute names. Spread attributes are excluded.
+     */
+    getAttributeNames(): string[];
+    /** Whether this element has children (JsxElement vs JsxSelfClosingElement). */
+    hasChildren(): boolean;
+    /** Underlying ts-morph node. */
+    getNode(): JsxElement | JsxSelfClosingElement;
+    /** Start line number in the source file. */
+    getStartLineNumber(): number;
+}
+/**
+ * Create an ArchJsxElement from a JsxElement (has opening + closing tags).
+ */
+export declare function fromJsxElement(el: JsxElement): ArchJsxElement;
+/**
+ * Create an ArchJsxElement from a JsxSelfClosingElement (no children).
+ */
+export declare function fromJsxSelfClosingElement(el: JsxSelfClosingElement): ArchJsxElement;
+/**
+ * Scan a source file for all JSX elements.
+ *
+ * Short-circuits on non-.tsx/.jsx files. Uses single-pass traversal.
+ * Collects both JsxElement (has children) and JsxSelfClosingElement (no children).
+ * JsxFragment nodes are intentionally excluded — they have no tag name or attributes.
+ * Nested JSX elements ARE collected (consistent with collectCalls).
+ */
+export declare function collectJsxElements(sourceFile: SourceFile): ArchJsxElement[];
+//# sourceMappingURL=arch-jsx-element.d.ts.map

package/dist/models/arch-jsx-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arch-jsx-element.d.ts","sourceRoot":"","sources":["../../src/models/arch-jsx-element.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,qBAAqB,EAE1B,KAAK,UAAU,EAGhB,MAAM,UAAU,CAAA;AAEjB;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAiHtC,CAAA;AAEV;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,OAAO,IAAI,MAAM,CAAA;IAEjB,2CAA2C;IAC3C,aAAa,IAAI,UAAU,CAAA;IAE3B;;;OAGG;IACH,aAAa,IAAI,OAAO,CAAA;IAExB;;OAEG;IACH,WAAW,IAAI,OAAO,CAAA;IAEtB;;;;;;;;OAQG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAE9C;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IAEnC;;OAEG;IACH,iBAAiB,IAAI,MAAM,EAAE,CAAA;IAE7B,+EAA+E;IAC/E,WAAW,IAAI,OAAO,CAAA;IAEtB,gCAAgC;IAChC,OAAO,IAAI,UAAU,GAAG,qBAAqB,CAAA;IAE7C,4CAA4C;IAC5C,kBAAkB,IAAI,MAAM,CAAA;CAC7B;AAiDD;;GAEG;AAEH,wBAAgB,cAAc,CAAC,EAAE,EAAE,UAAU,GAAG,cAAc,CAgB7D;AAED;;GAEG;AAEH,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,qBAAqB,GAAG,cAAc,CAenF;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,cAAc,EAAE,CAa3E"}