@alloy-js/python 0.4.0-dev.2 → 0.4.0-dev.5

package/dist/dev/src/symbols/factories.js

@@ -0,0 +1,28 @@
+import { createPythonSymbol } from "../symbol-creation.js";
+import { usePythonScope } from "./scopes.js";
+
+/**
+ * Creates a function symbol in the current scope.
+ */
+export function createFunctionSymbol(name, options = {}) {
+  return createPythonSymbol(name, {
+    instance: false,
+    refkeys: options.refkeys
+  }, "function");
+}
+
+/**
+ * Creates a method symbol in a class. Validates that the current scope is a member scope.
+ */
+export function createMethodSymbol(name, options = {}) {
+  const scope = usePythonScope();
+  if (!scope?.isMemberScope) {
+    const displayName = typeof name === "string" ? name : name.name;
+    throw new Error(`Method "${displayName}" must be declared inside a class (member scope)`);
+  }
+  return createPythonSymbol(name, {
+    instance: true,
+    refkeys: options.refkeys
+  }, "function");
+}
+//# sourceMappingURL=factories.js.map

package/dist/dev/src/symbols/factories.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createPythonSymbol","usePythonScope","createFunctionSymbol","name","options","instance","refkeys","createMethodSymbol","scope","isMemberScope","displayName","Error"],"sources":["../../../../src/symbols/factories.ts"],"sourcesContent":[null],"mappings":"AACA,SAASA,kBAAkB,QAAQ,uBAAuB;AAE1D,SAASC,cAAc,QAAQ,aAAa;;AAE5C;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CAClCC,IAAsB,EACtBC,OAA0B,GAAG,CAAC,CAAC,EACX;EACpB,OAAOJ,kBAAkB,CACvBG,IAAI,EACJ;IAAEE,QAAQ,EAAE,KAAK;IAAEC,OAAO,EAAEF,OAAO,CAACE;EAAQ,CAAC,EAC7C,UACF,CAAC;AACH;;AAEA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAChCJ,IAAsB,EACtBC,OAA0B,GAAG,CAAC,CAAC,EACX;EACpB,MAAMI,KAAK,GAAGP,cAAc,CAAC,CAAC;EAC9B,IAAI,CAACO,KAAK,EAAEC,aAAa,EAAE;IACzB,MAAMC,WAAW,GAAG,OAAOP,IAAI,KAAK,QAAQ,GAAGA,IAAI,GAAGA,IAAI,CAACA,IAAI;IAC/D,MAAM,IAAIQ,KAAK,CACb,WAAWD,WAAW,kDACxB,CAAC;EACH;EACA,OAAOV,kBAAkB,CACvBG,IAAI,EACJ;IAAEE,QAAQ,EAAE,IAAI;IAAEC,OAAO,EAAEF,OAAO,CAACE;EAAQ,CAAC,EAC5C,UACF,CAAC;AACH","ignoreList":[]}

package/dist/dev/src/symbols/index.js

@@ -0,0 +1,8 @@
+export * from "./factories.js";
+export * from "./python-lexical-scope.js";
+export * from "./python-member-scope.js";
+export * from "./python-module-scope.js";
+export * from "./python-output-symbol.js";
+export * from "./reference.js";
+export * from "./scopes.js";
+//# sourceMappingURL=index.js.map

package/dist/dev/src/symbols/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../../../src/symbols/index.ts"],"sourcesContent":[null],"mappings":"AAAA,cAAc,gBAAgB;AAC9B,cAAc,2BAA2B;AACzC,cAAc,0BAA0B;AACxC,cAAc,0BAA0B;AACxC,cAAc,2BAA2B;AACzC,cAAc,gBAAgB;AAC9B,cAAc,aAAa","ignoreList":[]}

package/dist/dev/src/symbols/python-lexical-scope.js

@@ -0,0 +1,15 @@
+import { OutputScope } from "@alloy-js/core";
+export class PythonLexicalScope extends OutputScope {
+  static declarationSpaces = ["symbols"];
+  get symbols() {
+    return this.spaceFor("symbols");
+  }
+
+  // Lexical scopes do not have an owner symbol. This ensures that we get the
+  // correct type when using `usePythonScope` (i.e. we don't get the
+  // OutputScope's `OutputSymbol | undefined` type).
+  get ownerSymbol() {
+    return undefined;
+  }
+}
+//# sourceMappingURL=python-lexical-scope.js.map

package/dist/dev/src/symbols/python-lexical-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["OutputScope","PythonLexicalScope","declarationSpaces","symbols","spaceFor","ownerSymbol","undefined"],"sources":["../../../../src/symbols/python-lexical-scope.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,WAAW,QAAQ,gBAAgB;AAE5C,OAAO,MAAMC,kBAAkB,SAASD,WAAW,CAAC;EAClD,OAAuBE,iBAAiB,GAAsB,CAAC,SAAS,CAAC;EAEzE,IAAIC,OAAOA,CAAA,EAAG;IACZ,OAAO,IAAI,CAACC,QAAQ,CAAC,SAAS,CAAC;EACjC;;EAEA;EACA;EACA;EACA,IAAIC,WAAWA,CAAA,EAAc;IAC3B,OAAOC,SAAS;EAClB;AACF","ignoreList":[]}

package/dist/dev/src/symbols/python-member-scope.js

@@ -0,0 +1,7 @@
+import { OutputScope } from "@alloy-js/core";
+export class PythonMemberScope extends OutputScope {
+  get ownerSymbol() {
+    return super.ownerSymbol;
+  }
+}
+//# sourceMappingURL=python-member-scope.js.map

package/dist/dev/src/symbols/python-member-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["OutputScope","PythonMemberScope","ownerSymbol"],"sources":["../../../../src/symbols/python-member-scope.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,WAAW,QAAQ,gBAAgB;AAG5C,OAAO,MAAMC,iBAAiB,SAASD,WAAW,CAAC;EACjD,IAAIE,WAAWA,CAAA,EAAG;IAChB,OAAO,KAAK,CAACA,WAAW;EAC1B;AACF","ignoreList":[]}

package/dist/dev/src/symbols/python-module-scope.js

@@ -0,0 +1,86 @@
+import { createSymbol, reactive, shallowReactive } from "@alloy-js/core";
+import { PythonLexicalScope } from "./python-lexical-scope.js";
+import { PythonOutputSymbol } from "./python-output-symbol.js";
+
+// Internal typing module for TYPE_CHECKING imports
+let _typingModuleScope;
+let _typeCheckingSymbol;
+
+/**
+ * Get the internal typing module scope and TYPE_CHECKING symbol.
+ * Used by addTypeImport() to add TYPE_CHECKING imports without
+ * going through the binder's refkey resolution.
+ */
+function getTypingModuleInternal() {
+  if (!_typingModuleScope) {
+    _typingModuleScope = new PythonModuleScope("typing", undefined);
+    _typeCheckingSymbol = new PythonOutputSymbol("TYPE_CHECKING", _typingModuleScope.symbols, {});
+  }
+  return {
+    scope: _typingModuleScope,
+    TYPE_CHECKING: _typeCheckingSymbol
+  };
+}
+export class ImportedSymbol {
+  constructor(target, local) {
+    this.target = target;
+    this.local = local;
+  }
+  static from(target, local) {
+    return new ImportedSymbol(target, local);
+  }
+}
+export class ImportRecords extends Map {}
+export class PythonModuleScope extends PythonLexicalScope {
+  #importedSymbols = shallowReactive(new Map());
+  get importedSymbols() {
+    return this.#importedSymbols;
+  }
+  #importedModules = reactive(new Map());
+  get importedModules() {
+    return this.#importedModules;
+  }
+  addImport(targetSymbol, targetModule, options) {
+    const existing = this.importedSymbols.get(targetSymbol);
+    if (existing) {
+      // If existing is type-only but now used as value, upgrade it
+      if (!options?.type && existing.isTypeOnly) {
+        existing.markAsValue();
+      }
+      return existing;
+    }
+    if (!this.importedModules.has(targetModule)) {
+      this.importedModules.set(targetModule, {
+        symbols: new Set()
+      });
+    }
+    const localSymbol = createSymbol(PythonOutputSymbol, targetSymbol.name, this.symbols, {
+      binder: this.binder,
+      aliasTarget: targetSymbol,
+      typeOnly: options?.type
+    });
+    this.importedSymbols.set(targetSymbol, localSymbol);
+    this.importedModules.get(targetModule).symbols?.add({
+      local: localSymbol,
+      target: targetSymbol
+    });
+    return localSymbol;
+  }
+
+  /**
+   * Add TYPE_CHECKING import from the typing module.
+   * Returns the local symbol for use in the if block opener.
+   */
+  addTypeImport() {
+    const typing = getTypingModuleInternal();
+    return this.addImport(typing.TYPE_CHECKING, typing.scope);
+  }
+  get debugInfo() {
+    return {
+      ...super.debugInfo,
+      importedSymbolCount: this.#importedSymbols.size,
+      importedModuleCount: this.#importedModules.size
+    };
+  }
+}
+//# sourceMappingURL=python-module-scope.js.map

package/dist/dev/src/symbols/python-module-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createSymbol","reactive","shallowReactive","PythonLexicalScope","PythonOutputSymbol","_typingModuleScope","_typeCheckingSymbol","getTypingModuleInternal","PythonModuleScope","undefined","symbols","scope","TYPE_CHECKING","ImportedSymbol","constructor","target","local","from","ImportRecords","Map","importedSymbols","importedModules","addImport","targetSymbol","targetModule","options","existing","get","type","isTypeOnly","markAsValue","has","set","Set","localSymbol","name","binder","aliasTarget","typeOnly","add","addTypeImport","typing","debugInfo","importedSymbolCount","size","importedModuleCount"],"sources":["../../../../src/symbols/python-module-scope.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/dev/src/symbols/python-output-symbol.js

@@ -0,0 +1,73 @@
+import { createSymbol, OutputSymbol, track, TrackOpTypes, trigger, TriggerOpTypes } from "@alloy-js/core";
+/**
+ * Represents an 'exported' symbol from a .py file. Class, enum, interface etc.
+ */
+export class PythonOutputSymbol extends OutputSymbol {
+  static memberSpaces = ["static", "instance"];
+  constructor(name, spaces, options) {
+    super(name, spaces, options);
+    this.#module = options.module ?? undefined;
+    this.#typeOnly = options.typeOnly ?? false;
+  }
+
+  // The module in which the symbol is defined
+  #module;
+  get module() {
+    return this.#module;
+  }
+  #typeOnly;
+
+  /**
+   * Returns true if this symbol is only used in type annotation contexts.
+   * Such symbols can be imported inside a TYPE_CHECKING block.
+   */
+  get isTypeOnly() {
+    track(this, TrackOpTypes.GET, "typeOnly");
+    return this.#typeOnly;
+  }
+
+  /**
+   * Mark this symbol as also being used as a value (not just a type).
+   */
+  markAsValue() {
+    if (!this.#typeOnly) {
+      return;
+    }
+    const oldValue = this.#typeOnly;
+    this.#typeOnly = false;
+    trigger(this, TriggerOpTypes.SET, "typeOnly", false, oldValue);
+  }
+  get staticMembers() {
+    return this.memberSpaceFor("static");
+  }
+  get instanceMembers() {
+    return this.memberSpaceFor("instance");
+  }
+  get isStaticMemberSymbol() {
+    return !this.isInstanceMemberSymbol;
+  }
+  get isInstanceMemberSymbol() {
+    return this.spaces.some(s => s.key === "instance");
+  }
+  get debugInfo() {
+    return {
+      ...super.debugInfo,
+      module: this.#module,
+      isStaticMemberSymbol: this.isStaticMemberSymbol,
+      isInstanceMemberSymbol: this.isInstanceMemberSymbol
+    };
+  }
+  copy() {
+    const binder = this.binder;
+    const copy = createSymbol(PythonOutputSymbol, this.name, undefined, {
+      binder,
+      aliasTarget: this.aliasTarget,
+      module: this.module,
+      metadata: this.metadata,
+      typeOnly: this.isTypeOnly
+    });
+    this.initializeCopy(copy);
+    return copy;
+  }
+}
+//# sourceMappingURL=python-output-symbol.js.map

package/dist/dev/src/symbols/python-output-symbol.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createSymbol","OutputSymbol","track","TrackOpTypes","trigger","TriggerOpTypes","PythonOutputSymbol","memberSpaces","constructor","name","spaces","options","module","undefined","typeOnly","isTypeOnly","GET","markAsValue","oldValue","SET","staticMembers","memberSpaceFor","instanceMembers","isStaticMemberSymbol","isInstanceMemberSymbol","some","s","key","debugInfo","copy","binder","aliasTarget","metadata","initializeCopy"],"sources":["../../../../src/symbols/python-output-symbol.ts"],"sourcesContent":[null],"mappings":"AAAA,SACEA,YAAY,EAGZC,YAAY,EAEZC,KAAK,EACLC,YAAY,EACZC,OAAO,EACPC,cAAc,QACT,gBAAgB;AAavB;AACA;AACA;AACA,OAAO,MAAMC,kBAAkB,SAASL,YAAY,CAAC;EACnD,OAAgBM,YAAY,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC;EAErDC,WAAWA,CACTC,IAAsB,EACtBC,MAA+C,EAC/CC,OAAkC,EAClC;IACA,KAAK,CAACF,IAAI,EAAEC,MAAM,EAAEC,OAAO,CAAC;IAC5B,IAAI,CAAC,CAACC,MAAM,GAAGD,OAAO,CAACC,MAAM,IAAIC,SAAS;IAC1C,IAAI,CAAC,CAACC,QAAQ,GAAGH,OAAO,CAACG,QAAQ,IAAI,KAAK;EAC5C;;EAEA;EACA,CAACF,MAAM;EAEP,IAAIA,MAAMA,CAAA,EAAG;IACX,OAAO,IAAI,CAAC,CAACA,MAAM;EACrB;EAEA,CAACE,QAAQ;;EAET;AACF;AACA;AACA;EACE,IAAIC,UAAUA,CAAA,EAAG;IACfb,KAAK,CAAC,IAAI,EAAEC,YAAY,CAACa,GAAG,EAAE,UAAU,CAAC;IACzC,OAAO,IAAI,CAAC,CAACF,QAAQ;EACvB;;EAEA;AACF;AACA;EACEG,WAAWA,CAAA,EAAG;IACZ,IAAI,CAAC,IAAI,CAAC,CAACH,QAAQ,EAAE;MACnB;IACF;IACA,MAAMI,QAAQ,GAAG,IAAI,CAAC,CAACJ,QAAQ;IAC/B,IAAI,CAAC,CAACA,QAAQ,GAAG,KAAK;IACtBV,OAAO,CAAC,IAAI,EAAEC,cAAc,CAACc,GAAG,EAAE,UAAU,EAAE,KAAK,EAAED,QAAQ,CAAC;EAChE;EAEA,IAAIE,aAAaA,CAAA,EAAG;IAClB,OAAO,IAAI,CAACC,cAAc,CAAC,QAAQ,CAAC;EACtC;EAEA,IAAIC,eAAeA,CAAA,EAAG;IACpB,OAAO,IAAI,CAACD,cAAc,CAAC,UAAU,CAAC;EACxC;EAEA,IAAIE,oBAAoBA,CAAA,EAAG;IACzB,OAAO,CAAC,IAAI,CAACC,sBAAsB;EACrC;EAEA,IAAIA,sBAAsBA,CAAA,EAAG;IAC3B,OAAO,IAAI,CAACd,MAAM,CAACe,IAAI,CAAEC,CAAC,IAAKA,CAAC,CAACC,GAAG,KAAK,UAAU,CAAC;EACtD;EAEA,IAAaC,SAASA,CAAA,EAA4B;IAChD,OAAO;MACL,GAAG,KAAK,CAACA,SAAS;MAClBhB,MAAM,EAAE,IAAI,CAAC,CAACA,MAAM;MACpBW,oBAAoB,EAAE,IAAI,CAACA,oBAAoB;MAC/CC,sBAAsB,EAAE,IAAI,CAACA;IAC/B,CAAC;EACH;EAEAK,IAAIA,CAAA,EAAG;IACL,MAAMC,MAAM,GAAG,IAAI,CAACA,MAAM;IAC1B,MAAMD,IAAI,GAAG7B,YAAY,CAACM,kBAAkB,EAAE,IAAI,CAACG,IAAI,EAAEI,SAAS,EAAE;MAClEiB,MAAM;MACNC,WAAW,EAAE,IAAI,CAACA,WAAW;MAC7BnB,MAAM,EAAE,IAAI,CAACA,MAAM;MACnBoB,QAAQ,EAAE,IAAI,CAACA,QAAQ;MACvBlB,QAAQ,EAAE,IAAI,CAACC;IACjB,CAAC,CAAC;IAEF,IAAI,CAACkB,cAAc,CAACJ,IAAI,CAAC;IAEzB,OAAOA,IAAI;EACb;AACF","ignoreList":[]}

package/dist/dev/src/symbols/reference.js

@@ -0,0 +1,87 @@
+import { createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { memo, resolve, unresolvedRefkey, untrack, useContext } from "@alloy-js/core";
+import { MemberExpression } from "../components/MemberExpression.js";
+import { PythonSourceFileContext } from "../components/SourceFile.js";
+import { PythonModuleScope } from "./python-module-scope.js";
+export function ref(refkey, options) {
+  const sourceFile = useContext(PythonSourceFileContext);
+  const resolveResult = resolve(refkey);
+  return memo(() => {
+    if (resolveResult.value === undefined) {
+      return [unresolvedRefkey(refkey), undefined];
+    }
+    const {
+      commonScope,
+      lexicalDeclaration,
+      symbol,
+      pathDown,
+      memberPath
+    } = resolveResult.value;
+
+    // Where the target declaration is relative to the referencing scope.
+    // * module: target symbol is in a different module
+    // * local: target symbol is within the current module
+    const targetLocation = pathDown[0] instanceof PythonModuleScope ? "module" : "local";
+    let localSymbol;
+    if (targetLocation === "module") {
+      localSymbol = untrack(() => sourceFile.scope.addImport(lexicalDeclaration, pathDown[0], {
+        type: options?.type
+      }));
+    }
+    const parts = [];
+    if (commonScope && commonScope.isMemberScope) {
+      // we are referencing a member of a type we are inside
+      if (lexicalDeclaration.isInstanceMemberSymbol) {
+        parts.push(_$createComponent(MemberExpression.Part, {
+          id: "self"
+        }, {
+          fileName: import.meta.url,
+          lineNumber: 63,
+          columnNumber: 20
+        }));
+      } else {
+        parts.push(_$createComponent(MemberExpression.Part, {
+          get symbol() {
+            return commonScope.ownerSymbol;
+          }
+        }, {
+          fileName: import.meta.url,
+          lineNumber: 65,
+          columnNumber: 20
+        }));
+      }
+      parts.push(_$createComponent(MemberExpression.Part, {
+        symbol: lexicalDeclaration
+      }, {
+        fileName: import.meta.url,
+        lineNumber: 67,
+        columnNumber: 18
+      }));
+    } else {
+      parts.push(_$createComponent(MemberExpression.Part, {
+        symbol: localSymbol ?? lexicalDeclaration
+      }, {
+        fileName: import.meta.url,
+        lineNumber: 70,
+        columnNumber: 9
+      }));
+    }
+    for (const part of memberPath) {
+      parts.push(_$createComponent(MemberExpression.Part, {
+        symbol: part
+      }, {
+        fileName: import.meta.url,
+        lineNumber: 74,
+        columnNumber: 18
+      }));
+    }
+    return [_$createComponent(MemberExpression, {
+      children: parts
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 77,
+      columnNumber: 13
+    }), localSymbol ?? symbol];
+  });
+}
+//# sourceMappingURL=reference.js.map

package/dist/dev/src/symbols/reference.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["memo","resolve","unresolvedRefkey","untrack","useContext","MemberExpression","PythonSourceFileContext","PythonModuleScope","ref","refkey","options","sourceFile","resolveResult","value","undefined","commonScope","lexicalDeclaration","symbol","pathDown","memberPath","targetLocation","localSymbol","scope","addImport","type","parts","isMemberScope","isInstanceMemberSymbol","push","_$createComponent","Part","id","fileName","import","meta","url","lineNumber","columnNumber","ownerSymbol","part","children"],"sources":["../../../../src/symbols/reference.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/dev/src/symbols/scopes.js

@@ -0,0 +1,13 @@
+import { useScope } from "@alloy-js/core";
+import { PythonLexicalScope } from "./python-lexical-scope.js";
+export function usePythonScope() {
+  return useScope();
+}
+export function usePythonLexicalScope() {
+  const scope = usePythonScope();
+  if (!(scope instanceof PythonLexicalScope)) {
+    throw new Error("Expected a PythonLexicalScope, but got " + scope.constructor.name);
+  }
+  return scope;
+}
+//# sourceMappingURL=scopes.js.map

package/dist/dev/src/symbols/scopes.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useScope","PythonLexicalScope","usePythonScope","usePythonLexicalScope","scope","Error","constructor","name"],"sources":["../../../../src/symbols/scopes.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,QAAQ,QAAQ,gBAAgB;AACzC,SAASC,kBAAkB,QAAQ,2BAA2B;AAS9D,OAAO,SAASC,cAAcA,CAAA,EAAG;EAC/B,OAAOF,QAAQ,CAAC,CAAC;AACnB;AAEA,OAAO,SAASG,qBAAqBA,CAAA,EAAG;EACtC,MAAMC,KAAK,GAAGF,cAAc,CAAC,CAAC;EAC9B,IAAI,EAAEE,KAAK,YAAYH,kBAAkB,CAAC,EAAE;IAC1C,MAAM,IAAII,KAAK,CACb,yCAAyC,GAAGD,KAAK,CAACE,WAAW,CAACC,IAChE,CAAC;EACH;EACA,OAAOH,KAAK;AACd","ignoreList":[]}

package/dist/dev/src/utils.js

@@ -0,0 +1,13 @@
+import { defaultProps, splitProps } from "@alloy-js/core";
+/**
+ * Extract only the call signature props from a props object which extends
+ * `CallSignatureProps`. You can provide default values for the props.
+ */
+export function getCallSignatureProps(props, defaults) {
+  const [callSignatureProps] = splitProps(props, ["parameters", "typeParameters", "args", "kwargs", "returnType"]);
+  if (!defaults) {
+    return callSignatureProps;
+  }
+  return defaultProps(callSignatureProps, defaults);
+}
+//# sourceMappingURL=utils.js.map

package/dist/dev/src/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["defaultProps","splitProps","getCallSignatureProps","props","defaults","callSignatureProps"],"sources":["../../../src/utils.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,YAAY,EAAEC,UAAU,QAAQ,gBAAgB;AAGzD;AACA;AACA;AACA;AACA,OAAO,SAASC,qBAAqBA,CACnCC,KAAyB,EACzBC,QAAsC,EACtC;EACA,MAAM,CAACC,kBAAkB,CAAC,GAAGJ,UAAU,CAACE,KAAK,EAAE,CAC7C,YAAY,EACZ,gBAAgB,EAChB,MAAM,EACN,QAAQ,EACR,YAAY,CACb,CAAC;EAEF,IAAI,CAACC,QAAQ,EAAE;IACb,OAAOC,kBAAkB;EAC3B;EAEA,OAAOL,YAAY,CAACK,kBAAkB,EAAED,QAAQ,CAAC;AACnD","ignoreList":[]}