@xrkseek/harness 0.4.8 → 0.4.9

package/node_modules/@xrkseek/cordis/src/registry.js

@@ -0,0 +1,218 @@
+import { defineProperty } from '@xrkseek/cosmokit';
+import { Fiber } from "./fiber.js";
+import { buildOuterStack, DisposableList, symbols, withProps } from "./utils.js";
+function isApplicable(object) {
+    return object && typeof object === 'object' && typeof object.apply === 'function';
+}
+/**
+ * Decorator for declaring service dependencies on classes or class methods.
+ *
+ * On classes it contributes to the plugin's static `inject` map. On methods it
+ * delays the method call until the declared services are available.
+ */
+/**
+ * @param name — the required service name.
+ * @param config — optional intercept config applied for that service.
+ * @returns the class or method decorator.
+ */
+export function Inject(name, config) {
+    return function (value, decorator) {
+        if (decorator.kind === 'class') {
+            if (!Object.hasOwn(value, 'inject')) {
+                defineProperty(value, 'inject', Object.create(Object.getPrototypeOf(value).inject ?? null));
+                defineProperty(value.inject, symbols.checkProto, true);
+            }
+            value.inject[name] = config;
+        }
+        else if (decorator.kind === 'method') {
+            const inject = (value[symbols.metadata] ??= {}).inject ??= Object.create(null);
+            inject[name] = config;
+            decorator.addInitializer(function () {
+                const property = this[symbols.tracker]?.property;
+                (this[symbols.initHooks] ??= []).push(() => {
+                    this.ctx.inject(inject, (ctx) => {
+                        return value.call(property ? withProps(this, { [property]: ctx }) : this);
+                    });
+                });
+            });
+        }
+        else {
+            throw new Error('@Inject() can only be used on class or class methods');
+        }
+    };
+}
+/** Utilities for normalizing plugin dependency declarations. */
+(function (Inject) {
+    /**
+     * Convert array/object/class-inherited inject metadata into a plain map.
+     *
+     * @param inject — the declaration to normalize; `null`/`undefined` add nothing.
+     * @param result — the map to fill (service name → intercept config or `null`).
+     * @returns `result`.
+     */
+    function resolve(inject, result = Object.create(null)) {
+        if (!inject)
+            return result;
+        if (Array.isArray(inject)) {
+            for (const name of inject) {
+                result[name] = null;
+            }
+        }
+        else if (Reflect.has(inject, symbols.checkProto)) {
+            Object.assign(result, resolve(Object.getPrototypeOf(inject)));
+            for (const name of Object.keys(inject)) {
+                result[name] = inject[name] ?? null;
+            }
+        }
+        else {
+            for (const name of Object.keys(inject)) {
+                result[name] = inject[name] ?? null;
+            }
+        }
+        return result;
+    }
+    Inject.resolve = resolve;
+})(Inject || (Inject = {}));
+/**
+ * Plugin registry installed as `ctx.registry` and mixed into every context.
+ *
+ * It normalizes plugin shapes, tracks plugin runtimes, starts fibers, and
+ * exposes map-like inspection over active plugin callbacks.
+ */
+export class RegistryService {
+    ctx;
+    _counter = 0;
+    _internal = new Map();
+    constructor(ctx) {
+        this.ctx = ctx;
+        defineProperty(this, symbols.tracker, {
+            property: 'ctx',
+            noShadow: true,
+        });
+    }
+    /** Allocate the next fiber uid (increments on every read). */
+    get counter() {
+        return ++this._counter;
+    }
+    /** Number of registered plugin runtimes. */
+    get size() {
+        return this._internal.size;
+    }
+    /**
+     * Resolve a supported plugin shape to its executable callback.
+     *
+     * @param plugin — a function, class, or `{ apply }` object plugin.
+     * @returns the callback identifying the plugin, or `undefined` if invalid.
+     */
+    resolve(plugin) {
+        // plugin.apply may throw
+        try {
+            if (typeof plugin === 'function')
+                return plugin;
+            if (isApplicable(plugin))
+                return plugin.apply;
+        }
+        catch { }
+    }
+    /**
+     * Look up the runtime record for a plugin.
+     *
+     * @param plugin — any supported plugin shape.
+     * @returns the runtime, or `undefined` when the plugin is not registered.
+     */
+    get(plugin) {
+        const key = this.resolve(plugin);
+        return key && this._internal.get(key);
+    }
+    /**
+     * Check whether a plugin has a registered runtime.
+     *
+     * @param plugin — any supported plugin shape.
+     * @returns `true` when at least one fiber of the plugin exists.
+     */
+    has(plugin) {
+        const key = this.resolve(plugin);
+        return !!key && this._internal.has(key);
+    }
+    /**
+     * Dispose every running fiber for a plugin and remove its runtime record.
+     *
+     * @param plugin — any supported plugin shape.
+     * @returns the removed runtime, or `undefined` when none was registered.
+     */
+    delete(plugin) {
+        const key = this.resolve(plugin);
+        const runtime = key && this._internal.get(key);
+        if (!runtime)
+            return;
+        this._internal.delete(key);
+        for (const fiber of runtime.fibers) {
+            fiber.dispose();
+        }
+        return runtime;
+    }
+    /** Iterate the registered plugin callbacks. */
+    keys() {
+        return this._internal.keys();
+    }
+    /** Iterate the registered plugin runtimes. */
+    values() {
+        return this._internal.values();
+    }
+    /** Iterate `[callback, runtime]` pairs. */
+    entries() {
+        return this._internal.entries();
+    }
+    /**
+     * Visit every registered runtime.
+     *
+     * @param callback — receives each runtime and its identifying callback.
+     */
+    forEach(callback) {
+        return this._internal.forEach(callback);
+    }
+    /**
+     * Start a callback once the requested dependencies are available.
+     *
+     * @param inject — required services, as an array or a name → config map.
+     * @param callback — plugin body called with `(ctx, config)`.
+     * @returns the fiber; awaiting it settles once loading finished.
+     */
+    inject(inject, callback) {
+        return this.plugin({ inject, apply: callback, name: callback.name });
+    }
+    /**
+     * Start a plugin in the current context and return its fiber.
+     *
+     * Creates (or reuses) the plugin's runtime record, then starts a new fiber
+     * under the current context. Throws if `plugin` is not a supported shape or
+     * if the current fiber is already disposed.
+     *
+     * @param plugin — a function, class, or `{ apply }` object plugin.
+     * @param config — the plugin config, validated against its `Config` schema.
+     * @param getOuterStack — captures the caller stack for effect diagnostics.
+     * @returns the fiber; awaiting it settles once loading finished.
+     */
+    plugin(plugin, config, getOuterStack = buildOuterStack()) {
+        // check if it's a valid plugin
+        const callback = this.resolve(plugin);
+        if (!callback)
+            throw new Error('invalid plugin, expect function or object with an "apply" method, received ' + typeof plugin);
+        this.ctx.fiber.assertActive();
+        let runtime = this._internal.get(callback);
+        if (!runtime) {
+            let name = plugin.name;
+            if (name === 'apply')
+                name = undefined;
+            runtime = { name, callback, fibers: new DisposableList(), Config: plugin.Config };
+            this._internal.set(callback, runtime);
+        }
+        const fiber = new Fiber(this.ctx, config, Inject.resolve(plugin.inject), runtime, getOuterStack);
+        const wrapped = Object.create(fiber);
+        wrapped.then = (onFulfilled, onRejected) => {
+            return fiber.await().then(onFulfilled, onRejected);
+        };
+        return wrapped;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/node_modules/@xrkseek/cordis/src/registry.js.map

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

package/node_modules/@xrkseek/cordis/src/registry.ts

@@ -0,0 +1,337 @@
+import { defineProperty } from '@xrkseek/cosmokit'
+import type { Dict } from '@xrkseek/cosmokit'
+import type { StandardSchemaV1 } from '@standard-schema/spec'
+import { Context } from './context.ts'
+import { Fiber } from './fiber.ts'
+import { buildOuterStack, DisposableList, symbols, withProps } from './utils.ts'
+
+function isApplicable(object: Plugin) {
+  return object && typeof object === 'object' && typeof object.apply === 'function'
+}
+
+/**
+ * Service dependency declaration accepted by plugins and the `@Inject`
+ * decorator.
+ *
+ * Array form requests services without intercept config. Object form maps each
+ * service name to optional intercept config for the plugin context.
+ */
+export type Inject<M = Dict> = (keyof M)[] | { [K in keyof M]?: M[K] }
+
+/** Context keys that correspond to services with typed intercept config. */
+export type InjectKey = keyof {
+  [K in keyof Context & string as Context[K] extends { [symbols.config]: any } ? K : never]: any
+}
+
+/**
+ * Decorator for declaring service dependencies on classes or class methods.
+ *
+ * On classes it contributes to the plugin's static `inject` map. On methods it
+ * delays the method call until the declared services are available.
+ */
+/**
+ * @param name — the required service name.
+ * @param config — optional intercept config applied for that service.
+ * @returns the class or method decorator.
+ */
+export function Inject<K extends InjectKey>(name: K, config?: Context[K] extends { [symbols.config]: infer T } ? T : never) {
+  return function (value: any, decorator: ClassDecoratorContext<any> | ClassMethodDecoratorContext<any>) {
+    if (decorator.kind === 'class') {
+      if (!Object.hasOwn(value, 'inject')) {
+        defineProperty(value, 'inject', Object.create(Object.getPrototypeOf(value).inject ?? null))
+        defineProperty(value.inject, symbols.checkProto, true)
+      }
+      value.inject[name] = config
+    } else if (decorator.kind === 'method') {
+      const inject = (value[symbols.metadata] ??= {}).inject ??= Object.create(null)
+      inject[name] = config
+      decorator.addInitializer(function () {
+        const property = this[symbols.tracker]?.property
+        ;(this[symbols.initHooks] ??= []).push(() => {
+          (this.ctx as Context).inject(inject, (ctx) => {
+            return value.call(property ? withProps(this, { [property]: ctx }) : this)
+          })
+        })
+      })
+    } else {
+      throw new Error('@Inject() can only be used on class or class methods')
+    }
+  }
+}
+
+/** Utilities for normalizing plugin dependency declarations. */
+export namespace Inject {
+  /**
+   * Convert array/object/class-inherited inject metadata into a plain map.
+   *
+   * @param inject — the declaration to normalize; `null`/`undefined` add nothing.
+   * @param result — the map to fill (service name → intercept config or `null`).
+   * @returns `result`.
+   */
+  export function resolve(inject: Inject | null | undefined, result: Dict = Object.create(null)) {
+    if (!inject) return result
+    if (Array.isArray(inject)) {
+      for (const name of inject) {
+        result[name] = null
+      }
+    } else if (Reflect.has(inject, symbols.checkProto)) {
+      Object.assign(result, resolve(Object.getPrototypeOf(inject)))
+      for (const name of Object.keys(inject)) {
+        result[name] = inject[name] ?? null
+      }
+    } else {
+      for (const name of Object.keys(inject)) {
+        result[name] = inject[name] ?? null
+      }
+    }
+    return result
+  }
+}
+
+/** Supported plugin entrypoint shapes. */
+export type Plugin<T = any> =
+  | Plugin.Function<T>
+  | Plugin.Constructor<T>
+  | Plugin.Object<T>
+
+/** Types associated with plugin entrypoints and runtime records. */
+export namespace Plugin {
+  /** Shared metadata understood by the plugin registry and related tooling. */
+  export interface Base<T = any> {
+    /** Display name used for fiber diagnostics and logger names. */
+    name?: string
+    /** Standard-schema validator applied to config before the plugin starts. */
+    Config?: StandardSchemaV1<any, T>
+    /** Services the plugin requires; it only loads while all are available. */
+    inject?: Inject
+    /** Service name(s) the plugin provides (read by `Service` and by loaders). */
+    provide?: string | string[]
+    /** Service names whose intercept config the plugin declares it consumes. */
+    intercept?: Dict<boolean>
+  }
+
+  export interface Transform<S, T> {
+    /** Marks the transform object as a schema/config transform. */
+    schema?: true
+    /** Convert user-facing config to runtime config. */
+    Config: (config: S) => T
+  }
+
+  /** Function plugin called with `(ctx, config)`. */
+  export interface Function<T = any> extends Base<T> {
+    (ctx: Context, config: T): any
+  }
+
+  /** Class plugin constructed with `(ctx, config)`. */
+  export interface Constructor<T = any> extends Base<T> {
+    new (ctx: Context, config: T): any
+  }
+
+  /** Object plugin with an `apply(ctx, config)` method. */
+  export interface Object<T = any> extends Base<T> {
+    apply(ctx: Context, config: T): any
+  }
+
+  /** Mutable registry record shared by all fibers of one plugin callback. */
+  export interface Runtime {
+    /** Display name copied from the first registered plugin shape. */
+    name?: string
+    /** Every live fiber of this plugin (one per `ctx.plugin()` call). */
+    fibers: DisposableList<Fiber>
+    /** The executable entrypoint all fibers share (registry identity key). */
+    callback: globalThis.Function
+    /** Standard-schema validator applied to each fiber's config. */
+    Config?: StandardSchemaV1
+  }
+}
+
+type Spread<T> = undefined extends T ? [config?: T] : [config: T]
+
+type GetPluginParameters<P> =
+  | P extends (ctx: Context, ...args: infer R) => any
+  ? R
+  : P extends new (ctx: Context, ...args: infer R) => any
+  ? R
+  : P extends { apply(ctx: Context, ...args: infer R): any }
+  ? R
+  : never
+
+type GetPluginConfig<P> =
+  | P extends Plugin.Transform<infer S, any>
+  ? S
+  : GetPluginParameters<P>[0]
+
+declare module './context.ts' {
+  export interface Context {
+    /**
+     * Run a callback once the requested services are available.
+     *
+     * Shorthand for `ctx.plugin({ inject, apply: callback })`: the callback
+     * is unloaded and re-run whenever a required service changes.
+     *
+     * @param deps — required services, as an array or a name → config map.
+     * @param callback — plugin body called with `(ctx, config)`.
+     * @returns the fiber; awaiting it settles once loading finished.
+     */
+    inject(deps: Inject, callback: Plugin.Function<void>): Fiber & PromiseLike<Fiber>
+    /**
+     * Load a plugin in the current context.
+     *
+     * @param plugin — a function, class, or `{ apply }` object plugin.
+     * @param args — the plugin config, validated against its `Config` schema.
+     * @returns the fiber; awaiting it settles once loading finished
+     * (rejecting on config or startup errors).
+     */
+    plugin<P extends Plugin>(plugin: P, ...args: Spread<GetPluginConfig<P>>): Fiber & PromiseLike<Fiber>
+  }
+}
+
+/**
+ * Plugin registry installed as `ctx.registry` and mixed into every context.
+ *
+ * It normalizes plugin shapes, tracks plugin runtimes, starts fibers, and
+ * exposes map-like inspection over active plugin callbacks.
+ */
+export class RegistryService {
+  private _counter = 0
+  private _internal = new Map<Function, Plugin.Runtime>()
+
+  constructor(public ctx: Context) {
+    defineProperty(this, symbols.tracker, {
+      property: 'ctx',
+      noShadow: true,
+    })
+  }
+
+  /** Allocate the next fiber uid (increments on every read). */
+  get counter() {
+    return ++this._counter
+  }
+
+  /** Number of registered plugin runtimes. */
+  get size() {
+    return this._internal.size
+  }
+
+  /**
+   * Resolve a supported plugin shape to its executable callback.
+   *
+   * @param plugin — a function, class, or `{ apply }` object plugin.
+   * @returns the callback identifying the plugin, or `undefined` if invalid.
+   */
+  resolve(plugin: Plugin): Function | undefined {
+    // plugin.apply may throw
+    try {
+      if (typeof plugin === 'function') return plugin
+      if (isApplicable(plugin)) return plugin.apply
+    } catch {}
+  }
+
+  /**
+   * Look up the runtime record for a plugin.
+   *
+   * @param plugin — any supported plugin shape.
+   * @returns the runtime, or `undefined` when the plugin is not registered.
+   */
+  get(plugin: Plugin) {
+    const key = this.resolve(plugin)
+    return key && this._internal.get(key)
+  }
+
+  /**
+   * Check whether a plugin has a registered runtime.
+   *
+   * @param plugin — any supported plugin shape.
+   * @returns `true` when at least one fiber of the plugin exists.
+   */
+  has(plugin: Plugin) {
+    const key = this.resolve(plugin)
+    return !!key && this._internal.has(key)
+  }
+
+  /**
+   * Dispose every running fiber for a plugin and remove its runtime record.
+   *
+   * @param plugin — any supported plugin shape.
+   * @returns the removed runtime, or `undefined` when none was registered.
+   */
+  delete(plugin: Plugin) {
+    const key = this.resolve(plugin)
+    const runtime = key && this._internal.get(key)
+    if (!runtime) return
+    this._internal.delete(key)
+    for (const fiber of runtime.fibers) {
+      fiber.dispose()
+    }
+    return runtime
+  }
+
+  /** Iterate the registered plugin callbacks. */
+  keys() {
+    return this._internal.keys()
+  }
+
+  /** Iterate the registered plugin runtimes. */
+  values() {
+    return this._internal.values()
+  }
+
+  /** Iterate `[callback, runtime]` pairs. */
+  entries() {
+    return this._internal.entries()
+  }
+
+  /**
+   * Visit every registered runtime.
+   *
+   * @param callback — receives each runtime and its identifying callback.
+   */
+  forEach(callback: (value: Plugin.Runtime, key: Function) => void) {
+    return this._internal.forEach(callback)
+  }
+
+  /**
+   * Start a callback once the requested dependencies are available.
+   *
+   * @param inject — required services, as an array or a name → config map.
+   * @param callback — plugin body called with `(ctx, config)`.
+   * @returns the fiber; awaiting it settles once loading finished.
+   */
+  inject(inject: Inject, callback: Plugin.Function<void>) {
+    return this.plugin({ inject, apply: callback, name: callback.name })
+  }
+
+  /**
+   * Start a plugin in the current context and return its fiber.
+   *
+   * Creates (or reuses) the plugin's runtime record, then starts a new fiber
+   * under the current context. Throws if `plugin` is not a supported shape or
+   * if the current fiber is already disposed.
+   *
+   * @param plugin — a function, class, or `{ apply }` object plugin.
+   * @param config — the plugin config, validated against its `Config` schema.
+   * @param getOuterStack — captures the caller stack for effect diagnostics.
+   * @returns the fiber; awaiting it settles once loading finished.
+   */
+  plugin(plugin: Plugin, config?: any, getOuterStack = buildOuterStack()) {
+    // check if it's a valid plugin
+    const callback = this.resolve(plugin)
+    if (!callback) throw new Error('invalid plugin, expect function or object with an "apply" method, received ' + typeof plugin)
+    this.ctx.fiber.assertActive()
+
+    let runtime = this._internal.get(callback)
+    if (!runtime) {
+      let name = plugin.name
+      if (name === 'apply') name = undefined
+      runtime = { name, callback, fibers: new DisposableList(), Config: plugin.Config }
+      this._internal.set(callback, runtime)
+    }
+
+    const fiber = new Fiber(this.ctx, config, Inject.resolve(plugin.inject), runtime, getOuterStack)
+    const wrapped = Object.create(fiber) as Fiber & PromiseLike<Fiber>
+    wrapped.then = (onFulfilled, onRejected) => {
+      return fiber.await().then(onFulfilled, onRejected)
+    }
+    return wrapped
+  }
+}

package/node_modules/@xrkseek/cordis/src/service.d.ts

@@ -0,0 +1,55 @@
+import { Context } from './context.ts';
+import { symbols } from './utils.ts';
+/**
+ * Base class for services that expose a named API on `ctx`.
+ *
+ * Subclasses call `super(ctx, name)` from their constructor. The service is
+ * registered immediately and is automatically removed with the owning fiber.
+ */
+export declare abstract class Service<out T = never> {
+    protected ctx: Context;
+    /** Symbol key of an instance method run after construction (class plugins). */
+    static readonly init: unique symbol;
+    /** Symbol key of the availability predicate passed to `ctx.provide()`. */
+    static readonly check: unique symbol;
+    /** Symbol key of the phantom intercept-config type parameter. */
+    static readonly config: unique symbol;
+    /** Symbol key of the call body making a service callable (e.g. `ctx.logger()`). */
+    static readonly invoke: unique symbol;
+    /** Symbol key of the helper deriving an extended service instance. */
+    static readonly extend: unique symbol;
+    /** Symbol key of the tracker metadata used for context tracing. */
+    static readonly tracker: unique symbol;
+    /** Symbol key of the intercept-config resolution helper below. */
+    static readonly resolveConfig: unique symbol;
+    [symbols.config]: T;
+    /** The service name this instance is registered under. */
+    name: string;
+    /**
+     * Register this instance as `name` in the current context.
+     *
+     * Calls `ctx.reflect.provide(name, this, this[Service.check])`, so the
+     * service is unregistered automatically when the owning fiber unloads.
+     * Services with a `[Service.invoke]` body return a callable instance.
+     *
+     * @param ctx — the context to register in (stored as `this.ctx`).
+     * @param name — the service name; defaults to the static `provide` field.
+     */
+    constructor(ctx: Context, name: string);
+    protected [symbols.filter](ctx: Context): boolean;
+    protected [symbols.extend](props?: any): any;
+    /**
+     * Merge intercept config from ancestors with optional base and head values.
+     *
+     * Entries added closer to the root apply first; `base` is prepended and
+     * `head` appended. Uses `Config.merge` when the service declares one,
+     * otherwise a shallow `Object.assign`.
+     *
+     * @param base — lowest-precedence config merged before all intercepts.
+     * @param head — highest-precedence config merged after all intercepts.
+     * @returns the merged config.
+     */
+    [symbols.resolveConfig](base?: T, head?: T): T;
+    static [Symbol.hasInstance](instance: any): boolean;
+}
+//# sourceMappingURL=service.d.ts.map

package/node_modules/@xrkseek/cordis/src/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAiC,OAAO,EAAgB,MAAM,YAAY,CAAA;AAEjF;;;;;GAKG;AACH,8BAAsB,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK;IA+B7B,SAAS,CAAC,GAAG,EAAE,OAAO;IA9BlC,+EAA+E;IAC/E,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,MAAM,CAAe;IAClD,0EAA0E;IAC1E,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,MAAM,CAAgB;IACpD,iEAAiE;IACjE,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,MAAM,CAAiB;IACtD,mFAAmF;IACnF,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,MAAM,CAAiB;IACtD,sEAAsE;IACtE,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,MAAM,CAAiB;IACtD,mEAAmE;IACnE,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,MAAM,CAAkB;IACxD,kEAAkE;IAClE,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,MAAM,CAAwB;IAE5D,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAE3B,0DAA0D;IACnD,IAAI,EAAG,MAAM,CAAA;IAEpB;;;;;;;;;OASG;gBACmB,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM;IAmBhD,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO;IAIvC,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG;IAUtC;;;;;;;;;;OAUG;IACH,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC;IAkB9C,MAAM,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE,GAAG;CAW1C"}