apcore-js 0.19.0 → 0.21.0

package/dist/registry/multi-class.js

@@ -0,0 +1,120 @@
+/**
+ * Multi-class module discovery: opt-in scanner, snake_case ID derivation, conflict detection.
+ *
+ * Implements PROTOCOL_SPEC §2.1.1 (Multi-Module Discovery).
+ */
+import { IdTooLongError, InvalidSegmentError, ModuleIdConflictError } from '../errors.js';
+const SEGMENT_RE = /^[a-z][a-z0-9_]*$/;
+const CANONICAL_ID_RE = /^[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)*$/;
+const MAX_MODULE_ID_LEN = 192;
+/**
+ * Convert a class name to a snake_case segment per PROTOCOL_SPEC §2.1.1.
+ *
+ * Algorithm:
+ * 1. Insert boundary at ALLCAPS→CamelCase transitions (HTTPSender → HTTP_Sender).
+ * 2. Insert boundary at lowercase/digit→uppercase transitions (MathOps → Math_Ops).
+ * 3. Replace every non-alphanumeric character with `_`.
+ * 4. Lowercase.
+ * 5. Collapse consecutive `_` to a single `_`.
+ * 6. Strip leading and trailing `_`.
+ */
+export function classNameToSegment(className) {
+    let s = className.replace(/([A-Z]+)([A-Z][a-z])/g, '$1_$2');
+    s = s.replace(/([a-z\d])([A-Z])/g, '$1_$2');
+    s = s.replace(/[^a-zA-Z0-9]/g, '_');
+    s = s.toLowerCase();
+    s = s.replace(/_+/g, '_');
+    return s.replace(/^_+|_+$/g, '');
+}
+function computeBaseId(filePath, extensionsRoot) {
+    const normalized = filePath.replace(/\\/g, '/');
+    const parts = normalized.split('/');
+    const rootIdx = parts.findIndex(p => p === extensionsRoot);
+    const relParts = rootIdx === -1 ? [parts[parts.length - 1]] : parts.slice(rootIdx + 1);
+    // Strip file extension from the last segment
+    relParts[relParts.length - 1] = relParts[relParts.length - 1].replace(/\.[^.]+$/, '');
+    return relParts.join('.');
+}
+/**
+ * Discover module IDs for classes in a single file under multi-class mode.
+ *
+ * Implements the Registry.discover_multi_class contract from PROTOCOL_SPEC §2.1.1.
+ *
+ * When multiClassEnabled is false (the default — multi-class mode is opt-in),
+ * only the first qualifying class is used and the bare base_id is returned.
+ *
+ * When multiClassEnabled is true and exactly one class qualifies:
+ * - If the class segment matches the file's last path segment (class named after
+ *   the file), the bare base_id is returned to preserve existing module IDs.
+ * - Otherwise the class segment is appended: base_id.class_segment.
+ *
+ * @internal Prefer `Registry.discoverMultiClass` (D-15) for the canonical
+ * cross-language API surface; this free function is retained for backwards
+ * compatibility and direct use by the scanner.
+ *
+ * @throws ModuleIdConflictError — two classes produce the same class_segment
+ * @throws InvalidSegmentError   — a segment does not match ^[a-z][a-z0-9_]*$
+ * @throws IdTooLongError        — a derived module_id exceeds 192 characters
+ */
+export function discoverMultiClass(filePath, classes, extensionsRoot = 'extensions', multiClassEnabled = false) {
+    const qualifying = classes.filter(c => c.implementsModule);
+    if (qualifying.length === 0)
+        return [];
+    const baseId = computeBaseId(filePath, extensionsRoot);
+    if (!multiClassEnabled) {
+        return [{ moduleId: baseId, className: qualifying[0].name }];
+    }
+    if (qualifying.length === 1) {
+        const segment = classNameToSegment(qualifying[0].name);
+        const lastBaseSegment = baseId.split('.').pop();
+        // Identity guarantee: when the class segment matches the file's last segment
+        // (class named after the file), preserve the bare base_id so existing IDs
+        // are not broken when multi-class mode is enabled.
+        if (segment === lastBaseSegment) {
+            return [{ moduleId: baseId, className: qualifying[0].name }];
+        }
+        // Class has a distinct name from the file — append the class segment.
+        if (!SEGMENT_RE.test(segment))
+            throw new InvalidSegmentError(filePath, qualifying[0].name, segment);
+        const moduleId = `${baseId}.${segment}`;
+        if (!CANONICAL_ID_RE.test(moduleId))
+            throw new InvalidSegmentError(filePath, qualifying[0].name, segment);
+        if (moduleId.length > MAX_MODULE_ID_LEN)
+            throw new IdTooLongError(filePath, moduleId);
+        return [{ moduleId, className: qualifying[0].name }];
+    }
+    // Multi-class path: derive IDs, detect conflicts, validate
+    const seenSegments = new Map(); // segment → className
+    const results = [];
+    for (const cls of qualifying) {
+        const segment = classNameToSegment(cls.name);
+        if (!SEGMENT_RE.test(segment)) {
+            throw new InvalidSegmentError(filePath, cls.name, segment);
+        }
+        if (seenSegments.has(segment)) {
+            console.warn(`[apcore:multi-class] MODULE_ID_CONFLICT in '${filePath}': ` +
+                `classes '${seenSegments.get(segment)}' and '${cls.name}' both produce segment '${segment}'`);
+            throw new ModuleIdConflictError(filePath, [seenSegments.get(segment), cls.name], segment);
+        }
+        seenSegments.set(segment, cls.name);
+        const moduleId = `${baseId}.${segment}`;
+        if (!CANONICAL_ID_RE.test(moduleId)) {
+            throw new InvalidSegmentError(filePath, cls.name, segment);
+        }
+        if (moduleId.length > MAX_MODULE_ID_LEN) {
+            throw new IdTooLongError(filePath, moduleId);
+        }
+        results.push({ moduleId, className: cls.name });
+    }
+    return results;
+}
+/**
+ * Internal alias of {@link discoverMultiClass}. Use {@link Registry.discoverMultiClass}
+ * instead — this name is preserved so the scanner and other internal callers
+ * have a stable reference that signals the surface is not part of the public
+ * API.
+ *
+ * @internal
+ */
+export const _discoverMultiClass = discoverMultiClass;
+//# sourceMappingURL=multi-class.js.map

package/dist/registry/multi-class.js.map

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

package/dist/registry/registry.d.ts

@@ -2,7 +2,17 @@
  * Central module registry for discovering, registering, and querying modules.
  */
 import type { Config } from '../config.js';
+import type { Context } from '../context.js';
+import type { EventEmitter } from '../events/emitter.js';
 import type { ModuleDescriptor } from './types.js';
+/**
+ * Reset the one-shot deprecation flag for the legacy 4-arg
+ * `Registry.discoverMultiClass` overload. Test-only — production callers
+ * never need this.
+ *
+ * @internal
+ */
+export declare function _resetMultiClassEnabledDeprecationWarned(): void;
 /**
  * Standard registry event names.
  */
@@ -28,6 +38,23 @@ export declare const MAX_MODULE_ID_LENGTH = 192;
  * Reserved words that cannot appear as the first segment of a module ID.
  */
 export declare const RESERVED_WORDS: Set<string>;
+/**
+ * Namespace prefix reserved for programmatically-registered modules
+ * synthesized at runtime (PROTOCOL_SPEC §2.5; RFC
+ * `apcore/docs/spec/rfc-ephemeral-modules.md`). IDs in this namespace MUST
+ * be registered through {@link Registry.register} only — the filesystem
+ * discoverer rejects matching IDs because the namespace has no
+ * directory-rooted source of truth, and {@link Registry.registerInternal}
+ * rejects them too so the audit-trail provenance distinction between
+ * framework-emitted (`system.*`) and caller-emitted (`ephemeral.*`)
+ * modules stays clean.
+ *
+ * The trailing dot is required so module IDs whose first segment merely
+ * *starts with* `ephemeral` (e.g. `ephemerals`) are not falsely classified.
+ */
+export declare const EPHEMERAL_NAMESPACE_PREFIX = "ephemeral.";
+/** Return true when `moduleId` belongs to the reserved `ephemeral.*` namespace. */
+export declare function isEphemeralModuleId(moduleId: string): boolean;
 /**
  * Interface for custom module discovery.
  */
@@ -65,6 +92,16 @@ export declare class Registry {
     private _refCounts;
     private _draining;
     private _drainResolvers;
+    /**
+     * Optional EventEmitter for the ephemeral.* registry-side audit emits
+     * (RFC `apcore/docs/spec/rfc-ephemeral-modules.md` "Audit-event single-emit
+     * rule"). Set via {@link setEventEmitter}; when null, ephemeral audit
+     * events are warn-logged so they never silently disappear.
+     *
+     * Mirrors apcore-python `Registry._event_emitter` /
+     * `Registry.set_event_emitter`.
+     */
+    private _eventEmitter;
     constructor(options?: {
         config?: Config | null;
         extensionsDir?: string | null;
@@ -77,12 +114,63 @@ export declare class Registry {
     setValidator(validator: ModuleValidator): void;
     discover(): Promise<number>;
     private _discoverCustom;
+    /**
+     * Default discovery pipeline (D-32 — 8 canonical stages, mirroring
+     * apcore-rust `default_discoverer.rs`):
+     *
+     *   1. _ensureIdMap            — lazy-load the optional id_map.json
+     *   2. _scanRoots              — walk extension roots
+     *   3. _applyIdMapOverrides    — rewrite canonical IDs from the map
+     *   4. _loadAllMetadata        — load each module's `module.yaml`
+     *   5. _resolveAllEntryPoints  — import the JS/TS entry point
+     *   6. _validateAll            — run module/custom validators
+     *   7. _filterIdConflicts      — batch-drop conflicting / invalid IDs
+     *   8. _resolveLoadOrder + _registerInOrder
+     *                              — topological sort then register.
+     */
     private _discoverDefault;
     private _scanRoots;
+    /**
+     * Reject filesystem-derived IDs that fall in the reserved `ephemeral.*`
+     * namespace.
+     *
+     * Per the apcore ephemeral-modules RFC pilot (`apcore/docs/spec/
+     * rfc-ephemeral-modules.md`), `ephemeral.*` is reserved for
+     * programmatically-registered modules synthesized at runtime. Any
+     * filesystem layout that produces such an ID is a configuration error —
+     * either the directory is misnamed or the namespace prefix is being
+     * misused. We surface this as an `InvalidInputError` so callers cannot
+     * accidentally pollute the registry with filesystem-rooted ephemerals.
+     *
+     * Mirrors apcore-python `Registry._reject_ephemeral_discoveries`.
+     */
+    private _rejectEphemeralDiscoveries;
     private _applyIdMapOverrides;
     private _loadAllMetadata;
     private _resolveAllEntryPoints;
     private _validateAll;
+    /**
+     * Stage 7 (D-32) — batch-drop modules with invalid or conflicting IDs.
+     *
+     * Mirrors apcore-python `_filter_id_conflicts` and apcore-rust
+     * `default_discoverer::filter_id_conflicts`. Two failure modes drop a
+     * module here (warn + skip) rather than aborting the whole batch:
+     *   - PROTOCOL_SPEC §2.7 ID validation (empty / pattern / length /
+     *     reserved-word first segment), and
+     *   - Algorithm A03 conflict detection (duplicate against an existing
+     *     registration, lowercase collision, reserved-word collision).
+     *
+     * Soft-severity conflicts (e.g. case-insensitive match against an
+     * already-registered ID at `warn` level) are NOT dropped here — the
+     * warning is logged and the module flows through to registration so
+     * existing behaviour is preserved. Only `error`-severity conflicts and
+     * invalid IDs are filtered out.
+     *
+     * `rawMetadata` is accepted for cross-language signature parity with
+     * the Rust/Python helpers (which may inspect metadata for additional
+     * checks); the TS implementation reads only the module ID.
+     */
+    private _filterIdConflicts;
     private _resolveLoadOrder;
     private _registerInOrder;
     /**
@@ -91,26 +179,110 @@ export declare class Registry {
      * Validation order (PROTOCOL_SPEC §2.7, aligned with apcore-python and
      * apcore-rust): empty → pattern → length → reserved (per-segment) →
      * duplicate.
+     *
+     * The optional `version` and `metadata` parameters mirror apcore-python's
+     * `Registry.register(module_id, module, version=None, metadata=None)` for
+     * cross-language signature parity (sync finding A-001). Multi-version
+     * coexistence is not yet implemented in this SDK — when supplied, both
+     * fields are merged into the module's metadata so callers can read them
+     * back via `getDefinition()` and `list({tags})`. See PROTOCOL_SPEC §5.4.
      */
-    register(moduleId: string, module: unknown): void;
+    register(moduleId: string, module: unknown, version?: string | null, metadata?: Record<string, unknown> | null, options?: {
+        context?: Context | null;
+    }): void;
     /** Inner registration — no validator, no ID validation. Used by discover() paths that run their own checks. */
     private _registerImpl;
-    unregister(moduleId: string): boolean;
-    get(moduleId: string): unknown | null;
+    unregister(moduleId: string, options?: {
+        context?: Context | null;
+    }): boolean;
+    /**
+     * Look up a registered module by ID.
+     *
+     * @param moduleId - Module identifier (must be non-empty).
+     * @param _versionHint - Optional semver range for multi-version coexistence
+     *   (PROTOCOL_SPEC §5.4). This SDK currently exposes a single-version
+     *   registry, so the hint is accepted for cross-language API parity with
+     *   apcore-python (sync finding A-002) but does NOT participate in
+     *   resolution: the latest registered module for `moduleId` is returned
+     *   regardless of the hint. When multi-version registration lands, this
+     *   parameter will gate semver-range matching.
+     */
+    get(moduleId: string, _versionHint?: string | null): unknown | null;
     has(moduleId: string): boolean;
+    /**
+     * Return sorted list of registered module IDs, optionally filtered by
+     * `prefix` / `tags`.
+     *
+     * Modules whose `ModuleAnnotations.discoverable === false` are excluded
+     * by default per PROTOCOL_SPEC §4.4 (RFC
+     * `apcore/docs/spec/rfc-ephemeral-modules.md`). Pass
+     * `includeHidden: true` to enumerate every registered module — useful
+     * for introspection tools, debug consoles, and tests.
+     */
     list(options?: {
         tags?: string[];
         prefix?: string;
+        includeHidden?: boolean;
     }): string[];
-    iter(): IterableIterator<[string, unknown]>;
+    /**
+     * Iterate `[moduleId, module]` pairs. Hides modules annotated
+     * `discoverable: false` by default; pass `includeHidden: true` to walk
+     * every registered module.
+     */
+    iter(options?: {
+        includeHidden?: boolean;
+    }): IterableIterator<[string, unknown]>;
+    /** Total number of registered modules (includes `discoverable: false`). */
     get count(): number;
+    /**
+     * Sorted list of registered module IDs (excludes
+     * `ModuleAnnotations.discoverable === false` modules). Use
+     * {@link list} with `includeHidden: true` when the full set is required.
+     */
     get moduleIds(): string[];
-    getDefinition(moduleId: string): ModuleDescriptor | null;
+    /**
+     * Return false when the module's annotations declare
+     * `discoverable: false`. Anything else (including missing annotations)
+     * keeps the module visible — the default `true` preserves backward
+     * compatibility.
+     *
+     * Resolution order matches `mergeModuleMetadata`:
+     * 1. The merged `annotations` slot in `_moduleMeta` (which already
+     *    accounts for YAML > code precedence).
+     * 2. The module instance's `annotations` attribute (covers paths that
+     *    bypassed the merge, e.g. `registerInternal`).
+     */
+    private _isDiscoverable;
+    private _readDiscoverable;
+    getDefinition(moduleId: string, _versionHint?: string | null): ModuleDescriptor | null;
     describe(moduleId: string): string;
     on(event: string, callback: EventCallback): void;
     off(event: string, callback: EventCallback): boolean;
     reload(): Promise<number>;
     private _triggerEvent;
+    /**
+     * Watch the configured extension roots for filesystem changes and
+     * unregister any module whose source file is modified or deleted.
+     *
+     * **Cross-language divergence (sync finding A-D-104):** unlike apcore-python
+     * (which re-imports the file via `importlib.reload`) and apcore-rust (which
+     * triggers full rediscovery), the TypeScript SDK is **event-only**. On a
+     * file change the registry:
+     *   1. unregisters the previously-loaded module (calling its `onUnload`),
+     *   2. emits a `'file_changed'` event with `{ filePath }` payload.
+     *
+     * Consumers are expected to subscribe and re-register the module
+     * themselves (e.g. by calling `registry.discover()` or registering a fresh
+     * import). ES module specifiers are immutable in Node — there is no
+     * portable "reload from disk" primitive — so a transparent dynamic
+     * `import()` would silently return the cached old module on every
+     * invocation. A workaround using a cache-busting query (`?v=Date.now()`)
+     * leaks the old module each reload and breaks browser bundlers, so it is
+     * intentionally **not** offered here.
+     *
+     * If your application needs Python-style hot-reload semantics, listen for
+     * `'file_changed'` and re-discover or re-import explicitly.
+     */
     watch(): Promise<void>;
     unwatch(): void;
     private _handleFileChange;
@@ -137,6 +309,35 @@ export declare class Registry {
      */
     exportSchema(moduleId: string, strict?: boolean): Record<string, unknown> | null;
     clearCache(): void;
+    /**
+     * Discover module IDs for the classes in a single file under multi-class
+     * mode (PROTOCOL_SPEC §2.1.1).
+     *
+     * D-15: cross-language alignment with Python `Registry.discover_multi_class`
+     * and the Rust trait method. Internally delegates to the free function
+     * {@link discoverMultiClass} (re-exported as `_discoverMultiClass` for
+     * scanner internals), so behaviour is identical.
+     *
+     * **apcore decision-log D-06**: the per-class `ClassDescriptor.multiClass`
+     * flag is the sole opt-in mechanism for multi-class discovery. When any
+     * qualifying class sets `multiClass: true`, the discovery routine derives
+     * a distinct module ID per class; otherwise whole-file mode is used.
+     *
+     * @param filePath - Source file path (relative to project root).
+     * @param classes - Class descriptors; each may carry `multiClass: true`
+     *   to opt into per-class module ID derivation.
+     * @param extensionsRoot - Extensions root directory (defaults to
+     *   `'extensions'`).
+     *
+     * **Deprecated 4-arg overload**: passing a `multiClassEnabled` boolean as
+     * the fourth argument is retained for backward compatibility through one
+     * minor release and will be removed in v0.22.0. The argument is now
+     * functionally inert — the per-class `multiClass` field is the source of
+     * truth. A one-shot deprecation notice is emitted on first use.
+     */
+    discoverMultiClass(filePath: string, classes: readonly import('./multi-class.js').ClassDescriptor[], extensionsRoot?: string): import('./multi-class.js').MultiClassEntry[];
+    /** @deprecated Pass `multiClass: true` on each `ClassDescriptor` instead. The `multiClassEnabled` argument will be removed in v0.22.0. */
+    discoverMultiClass(filePath: string, classes: readonly import('./multi-class.js').ClassDescriptor[], extensionsRoot: string, multiClassEnabled: boolean): import('./multi-class.js').MultiClassEntry[];
     /**
      * Number of in-flight executions per module.
      */
@@ -186,6 +387,46 @@ export declare class Registry {
      *
      * Returns true if drained cleanly, false if force-unloaded after timeout.
      */
+    /**
+     * Wire an EventEmitter for registry-side audit emits.
+     *
+     * Per the apcore RFC `apcore/docs/spec/rfc-ephemeral-modules.md`
+     * "Audit-event single-emit rule", `ephemeral.*` registrations and
+     * unregistrations emit a single `apcore.registry.module_registered` /
+     * `apcore.registry.module_unregistered` event with the D-35 contextual
+     * payload. When no emitter is wired, the event is logged at INFO so it
+     * never silently disappears — useful for the v1 pilot where most
+     * callers will not have an emitter attached.
+     *
+     * Pilot scope: only `ephemeral.*` registrations trigger registry-side
+     * emits. The pre-existing bridge in
+     * `sys-modules/registration.ts` continues to emit empty-payload events
+     * for non-ephemeral modules and short-circuits for ephemerals so the
+     * single-emit rule holds.
+     */
+    setEventEmitter(emitter: EventEmitter | null): void;
+    /**
+     * Soft-warn when an `ephemeral.*` module is registered without
+     * `requiresApproval: true`. Per the ephemeral-modules RFC pilot,
+     * agent-synthesized modules SHOULD declare `requiresApproval` so a
+     * human gates execution. The registry only warns; it does not refuse
+     * the registration.
+     */
+    private _warnIfMissingApproval;
+    /**
+     * Build the D-35 audit payload (`caller_id` plus optional `identity`
+     * snapshot) for an ephemeral.* register/unregister. Mirrors the shape
+     * `extractAuditIdentity` produces for `system.control.*` events so
+     * subscribers can apply identical redaction rules.
+     */
+    private _buildEphemeralAuditPayload;
+    /**
+     * Emit the canonical ephemeral.* audit event to the wired EventEmitter
+     * (or warn-log if none is wired). The bridge in
+     * `sys-modules/registration.ts` short-circuits on ephemeral.* IDs so
+     * exactly one event lands per registration / unregistration.
+     */
+    private _emitEphemeralAudit;
     safeUnregister(moduleId: string, timeoutMs?: number): Promise<boolean>;
 }
 export {};

package/dist/registry/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/registry/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/registry/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAWtE,OAAO,KAAK,EAAkB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA4DnE;;;;;;GAMG;AACH,wBAAgB,wCAAwC,IAAI,IAAI,CAE/D;AAaD;;GAEG;AACH,eAAO,MAAM,eAAe;;;EAGjB,CAAC;AAEZ;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAA0C,CAAC;AAEzE;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,cAAc,aAA+E,CAAC;AAE3G;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,0BAA0B,eAAe,CAAC;AAEvD,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE7D;AAiDD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CAAC;CACjI;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACzD;AAED,KAAK,aAAa,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AAEjE,qBAAa,QAAQ;IACnB,OAAO,CAAC,eAAe,CAAiC;IACxD,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,WAAW,CAAmD;IACtE,OAAO,CAAC,UAAU,CAGf;IACH,OAAO,CAAC,MAAM,CAA+C;IAC7D,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,YAAY,CAAmD;IACvE,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,SAAS,CAAC,CAA2B;IAC7C,OAAO,CAAC,eAAe,CAAC,CAAsB;IAC9C,OAAO,CAAC,iBAAiB,CAA2B;IACpD,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,YAAY,CAAS;IAG7B,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,eAAe,CAA6C;IAEpE;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa,CAA6B;gBAEtC,OAAO,CAAC,EAAE;QACpB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;QAChE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B;IA0BD,4DAA4D;YAC9C,YAAY;IAM1B,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAI3C,YAAY,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI;IAIxC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;YAOnB,eAAe;IA4E7B;;;;;;;;;;;;;OAaG;YACW,gBAAgB;YAehB,UAAU;IAexB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,2BAA2B;YAerB,oBAAoB;YA4BpB,gBAAgB;YAUhB,sBAAsB;YAiBtB,YAAY;IAe1B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,kBAAkB;IA6C1B,OAAO,CAAC,iBAAiB;IAmCzB,OAAO,CAAC,gBAAgB;IAoCxB;;;;;;;;;;;;;OAaG;IACH,QAAQ,CACN,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,EACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACzC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,GACrC,IAAI;IAwCP,+GAA+G;IAC/G,OAAO,CAAC,aAAa;IA2CrB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,GAAG,OAAO;IA8B7E;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,IAAI;IAOnE,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B;;;;;;;;;OASG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,EAAE;IA8BvF;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,gBAAgB,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAWhF,2EAA2E;IAC3E,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;;OAIG;IACH,IAAI,SAAS,IAAI,MAAM,EAAE,CAIxB;IAED;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,iBAAiB;IAWzB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,gBAAgB,GAAG,IAAI;IAuCtF,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IA2ClC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAUhD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO;IAc9C,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAI/B,OAAO,CAAC,aAAa;IAWrB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyD5B,OAAO,IAAI,IAAI;YAUD,iBAAiB;YA4BjB,mBAAmB;IAejC,OAAO,CAAC,eAAe;IAYvB;;;;;;;;OAQG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IA4DzD;;;;;;;;OAQG;IACH,YAAY,CACV,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,OAAe,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAYjC,UAAU,IAAI,IAAI;IAMlB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,kBAAkB,CAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS,OAAO,kBAAkB,EAAE,eAAe,EAAE,EAC9D,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,kBAAkB,EAAE,eAAe,EAAE;IAC/C,0IAA0I;IAC1I,kBAAkB,CAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS,OAAO,kBAAkB,EAAE,eAAe,EAAE,EAC9D,cAAc,EAAE,MAAM,EACtB,iBAAiB,EAAE,OAAO,GACzB,OAAO,kBAAkB,EAAE,eAAe,EAAE;IAiB/C;;OAEG;IACH,IAAI,QAAQ,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAE1C;IAED;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAYlC;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAgB/B;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIrC;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIlC;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAUhC;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,MAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAyBzE;;;;;;;OAOG;IAGH;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI;IAInD;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAiB9B;;;;;OAKG;IACH,OAAO,CAAC,2BAA2B;IAmBnC;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IA2CrB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,MAAa,GAAG,OAAO,CAAC,OAAO,CAAC;CAiBnF"}