@cad0p/pi-steering 0.1.0

package/dist/loader.js

@@ -0,0 +1,527 @@
+// SPDX-License-Identifier: MIT
+// Part of pi-steering.
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+/**
+ * TS config loader. Walk up cwd → `$HOME`, find `.pi/steering/index.ts`
+ * or `.pi/steering.ts` per layer, dynamic-import each, merge
+ * inner-first. Per-symbol JSDoc carries the contract; see also the
+ * {@link SteeringDiagnostic} / {@link SteeringDiagnosticKind} JSDoc
+ * for the diagnostic stream.
+ */
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { EVALUATOR_BUILTIN_TRACKERS } from "./evaluator.js";
+import { runMergerPipeline } from "./internal/session-runtime.js";
+import { formatTrackerNameCollisionMessage } from "./plugin-merger.js";
+/**
+ * Minimum Node version that supports native `.ts` import via type
+ * stripping (without a `--experimental-strip-types` flag). Shipped
+ * stable in Node 22.6+. We require 22.x outright to keep the error
+ * message simple.
+ */
+const MIN_NODE_MAJOR = 22;
+/**
+ * Runtime check: throws when Node is older than the minimum required
+ * for native `.ts` import. See README §Install for the supported
+ * Node range.
+ */
+function assertNodeVersion() {
+    const raw = process.versions.node;
+    const major = Number.parseInt(raw.split(".")[0] ?? "0", 10);
+    if (Number.isNaN(major) || major < MIN_NODE_MAJOR) {
+        throw new Error(`pi-steering requires Node >= ${MIN_NODE_MAJOR} ` +
+            `for native .ts loading (found ${raw}). ` +
+            `Upgrade Node, or stay on v1 JSON configs (\`.pi/steering.json\`).`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Discovery
+// ---------------------------------------------------------------------------
+/**
+ * Candidate file paths for a given directory's `.pi/steering/...` slot,
+ * in priority order. First existing file wins.
+ *
+ * Exported for tests — not part of the library's public API.
+ */
+export function configCandidates(dir) {
+    return [
+        join(dir, ".pi", "steering", "index.ts"),
+        join(dir, ".pi", "steering.ts"),
+    ];
+}
+/**
+ * Return the non-`.ts` files that exist under `<dir>/.pi/steering/` so
+ * callers can warn about them. Uses a best-effort fs read: a missing
+ * directory returns an empty list.
+ */
+function unexpectedFilesUnderSteering(dir) {
+    const steeringDir = join(dir, ".pi", "steering");
+    if (!existsSync(steeringDir))
+        return [];
+    try {
+        const entries = readdirSync(steeringDir);
+        const out = [];
+        for (const name of entries) {
+            const full = join(steeringDir, name);
+            try {
+                const st = statSync(full);
+                if (!st.isFile())
+                    continue;
+                if (name === "index.ts")
+                    continue;
+                if (name.endsWith(".ts"))
+                    continue; // allow helpers like `rules.ts`
+                out.push(full);
+            }
+            catch {
+                // skip unreadable entry
+            }
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Walk up from `cwd` to `$HOME` (inclusive, or to the filesystem root
+ * if HOME is unset / outside the cwd's ancestry), returning the list
+ * of directories INNER-FIRST — so `[cwd, cwd/parent, ..., HOME]`.
+ *
+ * Exported for tests.
+ */
+export function ancestorChain(cwd) {
+    const home = process.env["HOME"] ?? "";
+    const out = [];
+    const seen = new Set();
+    let current = resolve(cwd);
+    while (true) {
+        if (seen.has(current))
+            break; // symlink-loop guard
+        seen.add(current);
+        out.push(current);
+        if (current === home || current === "/")
+            break;
+        const parent = dirname(current);
+        if (parent === current)
+            break; // filesystem root
+        current = parent;
+    }
+    return out;
+}
+/**
+ * Find the config file (if any) for a single layer. Returns the
+ * resolved file path and a `layer-form-coexistence` diagnostic when
+ * both `.pi/steering/index.ts` and `.pi/steering.ts` coexist in the
+ * same directory (the directory form wins).
+ *
+ * Exported for tests.
+ */
+export function findConfigFile(dir) {
+    const [indexForm, flatForm] = configCandidates(dir);
+    const indexExists = indexForm !== undefined && existsSync(indexForm);
+    const flatExists = flatForm !== undefined && existsSync(flatForm);
+    let diagnostic = null;
+    if (indexExists && flatExists && indexForm !== undefined) {
+        // `path` points at the directory holding the conflict so the
+        // renderer's `${path}: ${message}` prefix surfaces the parent
+        // once and the message names which two forms coexist. The winning
+        // file path is implicit (the directory form always wins).
+        diagnostic = {
+            type: "warning",
+            kind: "layer-form-coexistence",
+            path: dir,
+            message: "both .pi/steering.ts and .pi/steering/index.ts exist; using " +
+                "directory form. Delete .pi/steering.ts to remove this warning.",
+        };
+    }
+    if (indexExists)
+        return { file: indexForm ?? null, diagnostic };
+    if (flatExists)
+        return { file: flatForm ?? null, diagnostic };
+    return { file: null, diagnostic };
+}
+// ---------------------------------------------------------------------------
+// Loading
+// ---------------------------------------------------------------------------
+/**
+ * Dynamic-import a single config file and return its default export.
+ * The module MUST `export default` a {@link SteeringConfig} object —
+ * the loader does not accept module-namespace imports as a fallback,
+ * to keep the authoring contract unambiguous.
+ *
+ * Throws a scoped error when the import fails, when the module has no
+ * default export, or when the default export isn't a plain object —
+ * the caller surfaces these per-layer without bringing the whole
+ * session down (a single bad layer shouldn't nuke the engine).
+ *
+ * Each call appends a unique `?t=<timestamp>` query string to the
+ * import URL. Node's ESM module map is keyed on URL and persists for
+ * the lifetime of the process, so a plain `await import(url)` returns
+ * the cached module forever — even after `/reload` and even after
+ * the file's content has changed (or, worse, after a previous load
+ * threw, since failed loads are also cached). The cache-bust forces
+ * Node to re-fetch and re-evaluate the file each call. See the
+ * "Hot-reload" section in the README for the limits of this approach
+ * (it does NOT bust transitively-imported plugin packages, which the
+ * user config reaches via static `import` of bare specifiers like
+ * `"pi-steering"` — those still require a full pi restart).
+ */
+async function importConfigFile(path) {
+    const url = pathToFileURL(path).href;
+    /**
+     * Cache-bust query string. `process.hrtime.bigint()` returns
+     * monotonic nanoseconds since an arbitrary process-relative
+     * origin — each call returns a strictly greater value, even
+     * back-to-back within the same millisecond, so no two
+     * `importConfigFile` invocations ever share a URL. If a future
+     * Node version changes the cache-bust contract (e.g. ignores
+     * query strings on `file:` URLs), this will silently revert to
+     * the cached-forever behavior, and the integration tests in
+     * `loader.test.ts` will fail.
+     */
+    const bust = `${url.includes("?") ? "&" : "?"}t=${process.hrtime.bigint()}`;
+    const mod = (await import(__rewriteRelativeImportExtension(url + bust)));
+    if (mod.default === undefined) {
+        // Path is intentionally omitted from the message; the caller wraps
+        // this throw in a `layer-import-failed` diagnostic whose own `path`
+        // field is the single source of truth for the file location.
+        throw new Error("config file must have a default export. Use " +
+            "`export default { ... } satisfies SteeringConfig` or " +
+            "`export default defineConfig({ ... })`.");
+    }
+    const candidate = mod.default;
+    if (candidate === null ||
+        typeof candidate !== "object" ||
+        Array.isArray(candidate)) {
+        throw new Error(`config file default export must be a SteeringConfig object, ` +
+            `got ${Array.isArray(candidate) ? "array" : typeof candidate}.`);
+    }
+    return candidate;
+}
+/**
+ * Walk up from `cwd` collecting config layers. Returns INNER-FIRST
+ * (caller passes to {@link buildConfig}, which expects inner-first so
+ * early entries take precedence on collisions).
+ *
+ * Issues encountered along the way (per-layer import failure, dual
+ * form coexistence, stray non-`.ts` file under `.pi/steering/`)
+ * surface as structured {@link SteeringDiagnostic} entries on the
+ * returned object. The loader does not log to `console.warn` directly
+ * — the bridge runtime owns the policy decision (throw vs. log) once
+ * it has collected diagnostics from every source.
+ *
+ * @throws when Node is older than {@link MIN_NODE_MAJOR}.
+ */
+export async function loadConfigs(cwd) {
+    assertNodeVersion();
+    const dirs = ancestorChain(cwd);
+    const layers = [];
+    const diagnostics = [];
+    for (const dir of dirs) {
+        const { file, diagnostic } = findConfigFile(dir);
+        if (diagnostic !== null)
+            diagnostics.push(diagnostic);
+        if (file === null) {
+            // Surface stray files under `.pi/steering/` that the loader
+            // won't pick up. Only check when the directory exists but has
+            // no `index.ts` — otherwise a project without any steering
+            // directory would emit noise.
+            const steeringDir = join(dir, ".pi", "steering");
+            if (existsSync(steeringDir)) {
+                for (const stray of unexpectedFilesUnderSteering(dir)) {
+                    diagnostics.push({
+                        type: "warning",
+                        kind: "layer-stray-file",
+                        path: stray,
+                        message: "ignoring non-.ts file under .pi/steering/",
+                    });
+                }
+            }
+            continue;
+        }
+        try {
+            layers.push(await importConfigFile(file));
+        }
+        catch (err) {
+            // Use err.message to drop the `Error: ` class prefix; native
+            // runtime errors (jiti syntax errors) may embed their path inside
+            // the message and we accept that duplication.
+            const body = err instanceof Error ? err.message : String(err);
+            diagnostics.push({
+                type: "warning",
+                kind: "layer-import-failed",
+                path: file,
+                message: `failed to import: ${body}`,
+            });
+        }
+    }
+    return { layers, diagnostics };
+}
+// ---------------------------------------------------------------------------
+// Merging
+// ---------------------------------------------------------------------------
+/**
+ * Collect plugins across layers, recording a diagnostic for each
+ * cross-layer duplicate plugin name. First-registered wins (inner
+ * layer is first — matches pi's project-local → global convention).
+ *
+ * The caller is responsible for unioning `config.disabledPlugins`
+ * across layers and passing the result as `disabledPlugins` (see
+ * `buildConfig`). Plugins whose name appears in the supplied set are
+ * still merged into the output (so downstream surfaces like
+ * `pi-steering list` can render them tagged as disabled), but they're
+ * EXEMPT from collision detection. A user resolving a duplicate-plugin
+ * warning by adding the plugin to `disabledPlugins` should see the
+ * warning go away in the same config edit; detect-then-disable would
+ * still surface the warning even though the disable already settled
+ * the conflict.
+ */
+function mergePlugins(layers, disabledPlugins, diagnostics) {
+    const seen = new Set();
+    const out = [];
+    for (const layer of layers) {
+        if (!layer.plugins)
+            continue;
+        for (const plugin of layer.plugins) {
+            if (seen.has(plugin.name)) {
+                if (!disabledPlugins.has(plugin.name)) {
+                    diagnostics.push({
+                        type: "warning",
+                        kind: "plugin-name-collision",
+                        message: `duplicate plugin "${plugin.name}"; keeping first-registered entry.`,
+                    });
+                }
+                continue;
+            }
+            seen.add(plugin.name);
+            out.push(plugin);
+        }
+    }
+    return out;
+}
+/**
+ * Merge rules across layers — inner layer's rule name overrides outer.
+ * Declaration order within a layer is preserved; cross-layer order is
+ * "first layer that mentions a given rule name wins for its slot".
+ *
+ * Records a diagnostic on duplicate names WITHIN a single layer
+ * (authoring mistake) — mirrors {@link mergeObservers}. Cross-layer
+ * collisions stay silent: overriding a rule by name is the documented
+ * customization path.
+ *
+ * Disabled rules are merged but exempt from collision detection (see
+ * {@link mergePlugins} for rationale).
+ */
+function mergeRules(layers, disabledRules, diagnostics) {
+    const byName = new Map();
+    for (const layer of layers) {
+        if (!layer.rules)
+            continue;
+        const seenInLayer = new Set();
+        for (const rule of layer.rules) {
+            if (seenInLayer.has(rule.name)) {
+                if (!disabledRules.has(rule.name)) {
+                    diagnostics.push({
+                        type: "warning",
+                        kind: "rule-name-collision",
+                        message: `duplicate rule "${rule.name}" within single config layer; ` +
+                            "keeping first, dropping subsequent",
+                    });
+                }
+                continue;
+            }
+            seenInLayer.add(rule.name);
+            if (!byName.has(rule.name)) {
+                byName.set(rule.name, rule);
+            }
+        }
+    }
+    return [...byName.values()];
+}
+/**
+ * Merge observers across layers — inner layer's observer name
+ * overrides outer. Records a diagnostic on duplicate names WITHIN a
+ * single layer (authoring mistake); cross-layer overrides are silent
+ * (intentional customization).
+ */
+function mergeObservers(layers, diagnostics) {
+    const byName = new Map();
+    for (const layer of layers) {
+        if (!layer.observers)
+            continue;
+        const seenInLayer = new Set();
+        for (const obs of layer.observers) {
+            if (seenInLayer.has(obs.name)) {
+                diagnostics.push({
+                    type: "warning",
+                    kind: "observer-name-collision",
+                    message: `duplicate observer "${obs.name}"; keeping first-registered entry.`,
+                });
+                continue;
+            }
+            seenInLayer.add(obs.name);
+            if (!byName.has(obs.name)) {
+                byName.set(obs.name, obs);
+            }
+        }
+    }
+    return [...byName.values()];
+}
+/**
+ * Merge simple string-list fields (`disabledRules`, `disabledPlugins`)
+ * as a union across layers. Preserves first-seen order for deterministic
+ * output in tests.
+ */
+function mergeStringUnion(layers, key) {
+    const seen = new Set();
+    let any = false;
+    for (const layer of layers) {
+        const list = layer[key];
+        if (list === undefined)
+            continue;
+        any = true;
+        for (const item of list)
+            seen.add(item);
+    }
+    return any ? [...seen] : undefined;
+}
+/**
+ * Inner-wins boolean merge over walked-up layers. Walks left-to-right
+ * (inner-first); returns the first explicit boolean or `undefined`.
+ * Used by `buildConfig` and the session runtime for the inner-wins
+ * boolean fields. Internal — not in the package's `exports` surface.
+ */
+export function mergeBool(layers, key) {
+    for (const layer of layers) {
+        const v = layer[key];
+        if (typeof v === "boolean")
+            return v;
+    }
+    return undefined;
+}
+/**
+ * Detect plugins registering a tracker under the same name and push
+ * an error-class diagnostic for each collision. Two plugins claiming
+ * the same state dimension is always a bug; the runtime escalates
+ * these to a thrown error regardless of the user's strict-mode
+ * preference.
+ *
+ * Plugins whose name appears in `disabledPlugins` are skipped before
+ * collision detection (mirrors {@link mergePlugins}).
+ */
+function detectTrackerNameCollisions(plugins, disabledPlugins, diagnostics) {
+    const seen = new Map(); // trackerName -> pluginName
+    for (const plugin of plugins) {
+        if (disabledPlugins.has(plugin.name))
+            continue;
+        if (!plugin.trackers)
+            continue;
+        for (const trackerName of Object.keys(plugin.trackers)) {
+            const prior = seen.get(trackerName);
+            if (prior !== undefined) {
+                diagnostics.push({
+                    type: "error",
+                    kind: "tracker-name-collision",
+                    message: formatTrackerNameCollisionMessage(prior, plugin.name, trackerName),
+                });
+                continue;
+            }
+            seen.set(trackerName, plugin.name);
+        }
+    }
+}
+/**
+ * Merge `layers` (inner-first) into a single effective
+ * {@link SteeringConfig}. An optional `defaults` config is treated as
+ * the OUTERMOST layer — its fields apply when no real layer specifies
+ * them, otherwise real layers override.
+ *
+ * Cross-layer plugin name collisions, within-layer rule + observer
+ * name collisions, and cross-layer tracker name collisions surface
+ * as structured {@link SteeringDiagnostic} entries on the returned
+ * object. Predicate-key + tracker-extension collisions are detected
+ * in `resolvePlugins`, not here — buildConfig handles cross-layer and
+ * within-layer name-collision shapes only.
+ */
+export function buildConfig(layers, defaults) {
+    // Build the effective inner-first layer list. `defaults` goes at
+    // the END (outermost position) so inner real layers override it.
+    const effective = [...layers];
+    if (defaults !== undefined)
+        effective.push(defaults);
+    const diagnostics = [];
+    const disabledPluginsList = mergeStringUnion(effective, "disabledPlugins");
+    const disabledRulesList = mergeStringUnion(effective, "disabledRules");
+    const disabledPluginsSet = new Set(disabledPluginsList ?? []);
+    const disabledRulesSet = new Set(disabledRulesList ?? []);
+    // Predicate + tracker-extension collisions are detected in
+    // resolvePlugins, not here. buildConfig handles cross-layer and
+    // within-layer name-collision shapes only.
+    const plugins = mergePlugins(effective, disabledPluginsSet, diagnostics);
+    detectTrackerNameCollisions(plugins, disabledPluginsSet, diagnostics);
+    const rules = mergeRules(effective, disabledRulesSet, diagnostics);
+    const observers = mergeObservers(effective, diagnostics);
+    const out = {};
+    if (plugins.length > 0)
+        out.plugins = plugins;
+    if (rules.length > 0)
+        out.rules = rules;
+    if (observers.length > 0)
+        out.observers = observers;
+    if (disabledRulesList !== undefined)
+        out.disabledRules = disabledRulesList;
+    if (disabledPluginsList !== undefined) {
+        out.disabledPlugins = disabledPluginsList;
+    }
+    const defaultNoOverride = mergeBool(effective, "defaultNoOverride");
+    if (defaultNoOverride !== undefined) {
+        out.defaultNoOverride = defaultNoOverride;
+    }
+    const disableDefaults = mergeBool(effective, "disableDefaults");
+    if (disableDefaults !== undefined)
+        out.disableDefaults = disableDefaults;
+    const failOnWarnings = mergeBool(effective, "failOnWarnings");
+    if (failOnWarnings !== undefined)
+        out.failOnWarnings = failOnWarnings;
+    return { config: out, diagnostics };
+}
+/**
+ * Convenience: load all layers for `cwd`, run the loader-side merge
+ * (`buildConfig`), then the plugin merger (`resolvePlugins`) with
+ * user-config rule + observer name validation between the two passes.
+ * Diagnostics from every surface flow into a single returned array,
+ * so an external embedder writing their own bridge or pre-flight
+ * check sees the SAME diagnostic stream the production runtime sees
+ * — no surface is silently skipped.
+ *
+ * Diagnostics return in declaration order; merge-side errors
+ * short-circuit `resolvePlugins` before its diagnostics are added.
+ *
+ * Production-strictness divergence: `loadSteeringConfig` does NOT
+ * apply the strict-mode `failOnWarnings` throw policy that
+ * `buildSessionRuntime` does. The function never throws on
+ * diagnostics; embedders apply their own throw + warning policy.
+ * See `failOnWarnings` on {@link SteeringConfig} for production-
+ * faithful pre-flight semantics.
+ *
+ * @throws when Node < {@link MIN_NODE_MAJOR} (propagated from
+ * `loadConfigs`).
+ */
+export async function loadSteeringConfig(cwd, defaults) {
+    const { layers, diagnostics: loaderDiagnostics } = await loadConfigs(cwd);
+    const { merged, diagnostics: mergeAndResolveDiagnostics } = runMergerPipeline(layers, defaults, EVALUATOR_BUILTIN_TRACKERS);
+    return {
+        config: merged,
+        diagnostics: [...loaderDiagnostics, ...mergeAndResolveDiagnostics],
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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

package/dist/observer-dispatcher.d.ts

@@ -0,0 +1,69 @@
+/**
+ * v2 observer dispatcher.
+ *
+ * Observers are the `tool_result` side of the steering engine: rules
+ * decide "can this run" pre-execution; observers record "what happened"
+ * post-execution. Typical use is to `appendEntry` into pi's session
+ * JSONL so later predicates can gate on prior turn state (the
+ * "description was read in a PRIOR turn" idiom from the ADR).
+ *
+ * This module merges user-declared observers (from
+ * {@link SteeringConfig.observers}) with plugin-shipped ones (from
+ * {@link ResolvedPluginState.observers}), then on every `tool_result`:
+ *
+ *   1. Applies the observer's `watch` filter (toolName + inputMatches
+ *      + exitCode). No `watch` means "fire on every tool_result".
+ *   2. Calls `observer.onResult(event, observerCtx)`. Awaits if it
+ *      returns a promise.
+ *   3. Catches thrown errors per-observer — one buggy observer does
+ *      NOT prevent the rest from running.
+ *
+ * Observer context (`ObserverContext`) is built fresh per event, using
+ * `appendEntry` and `findEntries` closures shared with the evaluator.
+ * `exec` is deliberately NOT exposed — observers are expected to be
+ * lightweight state-recording hooks. Complex tool_result analysis that
+ * needs to shell out belongs in a separate pi extension hook or in a
+ * rule's `when.condition` pre-execution, not in an observer.
+ *
+ * Wiring (Phase 3c): the extension runtime subscribes to `tool_result`
+ * and forwards the event + current `agentLoopIndex` into `dispatch`.
+ */
+import type { ExtensionContext, ToolResultEvent as PiToolResultEvent } from "@earendil-works/pi-coding-agent";
+import { type EvaluatorHost } from "./evaluator-internals/context.ts";
+import type { ResolvedPluginState } from "./plugin-merger.ts";
+import type { Observer } from "./schema.ts";
+export { matchesWatch } from "./internal/watch-matcher.ts";
+/**
+ * Runtime-facing dispatcher handle. Phase 3c holds an instance per
+ * session and calls {@link dispatch} from the pi `tool_result` listener.
+ */
+export interface ObserverDispatcher {
+    /**
+     * Dispatch a single `tool_result` to every matching observer.
+     *
+     * Resolves when all observer handlers have settled. Handlers that
+     * throw are caught + logged via `console.warn` and do not prevent
+     * subsequent observers from running.
+     */
+    dispatch(event: PiToolResultEvent, ctx: ExtensionContext, agentLoopIndex: number): Promise<void>;
+}
+/**
+ * Construct an {@link ObserverDispatcher}.
+ *
+ * Arguments:
+ *   - `resolved`       — merged plugin state from {@link resolvePlugins}.
+ *                         Source of plugin-shipped observers and the
+ *                         registry used by the evaluator at the same
+ *                         level.
+ *   - `userObservers`  — the user's `config.observers` list (already
+ *                         deduped at the loader level in Phase 2). User
+ *                         observers fire BEFORE plugin observers on the
+ *                         same event; within each group, registration
+ *                         order decides.
+ *   - `host`           — narrow surface exposing pi's `exec` +
+ *                         `appendEntry`. Passed straight through to the
+ *                         per-event observer context.
+ */
+export declare function buildObserverDispatcher(resolved: ResolvedPluginState, userObservers: readonly Observer[], host: EvaluatorHost): ObserverDispatcher;
+export type { EvaluatorHost } from "./evaluator-internals/context.ts";
+//# sourceMappingURL=observer-dispatcher.d.ts.map

package/dist/observer-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-dispatcher.d.ts","sourceRoot":"","sources":["../src/observer-dispatcher.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,IAAI,iBAAiB,EACrC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,kCAAkC,CAAC;AAM1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EACV,QAAQ,EAGT,MAAM,aAAa,CAAC;AAOrB,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAM3D;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,QAAQ,CACN,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,gBAAgB,EACrB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,mBAAmB,EAC7B,aAAa,EAAE,SAAS,QAAQ,EAAE,EAClC,IAAI,EAAE,aAAa,GAClB,kBAAkB,CAwBpB;AA6JD,YAAY,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC"}