p-dev-harness 0.3.1 → 0.4.0

package/dist/observability/constants.d.ts

@@ -0,0 +1,18 @@
+export declare const OBSERVABILITY_SCHEMA_VERSION: 1;
+export declare const OBSERVABILITY_LOCAL_FILE = ".harness/observability.local.json";
+export declare const P_DEV_OBSERVABILITY_SESSION_ID_ENV = "P_DEV_OBSERVABILITY_SESSION_ID";
+export declare const P_DEV_OBSERVABILITY_NONCE_ENV = "P_DEV_OBSERVABILITY_NONCE";
+export declare const P_DEV_OBSERVABILITY_DISABLED_ENV = "P_DEV_OBSERVABILITY_DISABLED";
+export declare const P_DEV_SENTRY_DISABLED_ENV = "P_DEV_SENTRY_DISABLED";
+export declare const P_DEV_ANALYTICS_DISABLED_ENV = "P_DEV_ANALYTICS_DISABLED";
+export declare const P_DEV_SENTRY_DSN_ENV = "P_DEV_SENTRY_DSN";
+export declare const P_DEV_POSTHOG_PROJECT_TOKEN_ENV = "P_DEV_POSTHOG_PROJECT_TOKEN";
+export declare const P_DEV_POSTHOG_HOST_ENV = "P_DEV_POSTHOG_HOST";
+export declare const P_DEV_SENTRY_ENVIRONMENT_ENV = "P_DEV_SENTRY_ENVIRONMENT";
+export declare const P_DEV_RELEASE_SHA_ENV = "P_DEV_RELEASE_SHA";
+export declare const OBSERVABILITY_PUBLIC_CONFIG_FILENAME = "observability.public.json";
+export declare const TRACKED_OBSERVABILITY_PUBLIC_CONFIG_RELATIVE = "config/observability.public.json";
+export declare const OBSERVABILITY_FLUSH_DEADLINE_MS = 1000;
+export declare const OBSERVABILITY_MAX_QUEUE_SIZE = 32;
+export declare const OBSERVABILITY_REQUEST_MAX_BYTES = 8192;
+//# sourceMappingURL=constants.d.ts.map

package/dist/observability/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/observability/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,EAAG,CAAU,CAAC;AAEvD,eAAO,MAAM,wBAAwB,sCAAsC,CAAC;AAE5E,eAAO,MAAM,kCAAkC,mCACb,CAAC;AACnC,eAAO,MAAM,6BAA6B,8BAA8B,CAAC;AAEzE,eAAO,MAAM,gCAAgC,iCAAiC,CAAC;AAC/E,eAAO,MAAM,yBAAyB,0BAA0B,CAAC;AACjE,eAAO,MAAM,4BAA4B,6BAA6B,CAAC;AAEvE,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AACvD,eAAO,MAAM,+BAA+B,gCAAgC,CAAC;AAC7E,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAC3D,eAAO,MAAM,4BAA4B,6BAA6B,CAAC;AACvE,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AAEzD,eAAO,MAAM,oCAAoC,8BAA8B,CAAC;AAChF,eAAO,MAAM,4CAA4C,qCACrB,CAAC;AAErC,eAAO,MAAM,+BAA+B,OAAQ,CAAC;AACrD,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAC/C,eAAO,MAAM,+BAA+B,OAAQ,CAAC"}

package/dist/observability/constants.js

@@ -0,0 +1,18 @@
+export const OBSERVABILITY_SCHEMA_VERSION = 1;
+export const OBSERVABILITY_LOCAL_FILE = ".harness/observability.local.json";
+export const P_DEV_OBSERVABILITY_SESSION_ID_ENV = "P_DEV_OBSERVABILITY_SESSION_ID";
+export const P_DEV_OBSERVABILITY_NONCE_ENV = "P_DEV_OBSERVABILITY_NONCE";
+export const P_DEV_OBSERVABILITY_DISABLED_ENV = "P_DEV_OBSERVABILITY_DISABLED";
+export const P_DEV_SENTRY_DISABLED_ENV = "P_DEV_SENTRY_DISABLED";
+export const P_DEV_ANALYTICS_DISABLED_ENV = "P_DEV_ANALYTICS_DISABLED";
+export const P_DEV_SENTRY_DSN_ENV = "P_DEV_SENTRY_DSN";
+export const P_DEV_POSTHOG_PROJECT_TOKEN_ENV = "P_DEV_POSTHOG_PROJECT_TOKEN";
+export const P_DEV_POSTHOG_HOST_ENV = "P_DEV_POSTHOG_HOST";
+export const P_DEV_SENTRY_ENVIRONMENT_ENV = "P_DEV_SENTRY_ENVIRONMENT";
+export const P_DEV_RELEASE_SHA_ENV = "P_DEV_RELEASE_SHA";
+export const OBSERVABILITY_PUBLIC_CONFIG_FILENAME = "observability.public.json";
+export const TRACKED_OBSERVABILITY_PUBLIC_CONFIG_RELATIVE = "config/observability.public.json";
+export const OBSERVABILITY_FLUSH_DEADLINE_MS = 1_000;
+export const OBSERVABILITY_MAX_QUEUE_SIZE = 32;
+export const OBSERVABILITY_REQUEST_MAX_BYTES = 8_192;
+//# sourceMappingURL=constants.js.map

package/dist/observability/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/observability/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAU,CAAC;AAEvD,MAAM,CAAC,MAAM,wBAAwB,GAAG,mCAAmC,CAAC;AAE5E,MAAM,CAAC,MAAM,kCAAkC,GAC7C,gCAAgC,CAAC;AACnC,MAAM,CAAC,MAAM,6BAA6B,GAAG,2BAA2B,CAAC;AAEzE,MAAM,CAAC,MAAM,gCAAgC,GAAG,8BAA8B,CAAC;AAC/E,MAAM,CAAC,MAAM,yBAAyB,GAAG,uBAAuB,CAAC;AACjE,MAAM,CAAC,MAAM,4BAA4B,GAAG,0BAA0B,CAAC;AAEvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AACvD,MAAM,CAAC,MAAM,+BAA+B,GAAG,6BAA6B,CAAC;AAC7E,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAC3D,MAAM,CAAC,MAAM,4BAA4B,GAAG,0BAA0B,CAAC;AACvE,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;AAEzD,MAAM,CAAC,MAAM,oCAAoC,GAAG,2BAA2B,CAAC;AAChF,MAAM,CAAC,MAAM,4CAA4C,GACvD,kCAAkC,CAAC;AAErC,MAAM,CAAC,MAAM,+BAA+B,GAAG,KAAK,CAAC;AACrD,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAC/C,MAAM,CAAC,MAAM,+BAA+B,GAAG,KAAK,CAAC"}

package/dist/observability/context.d.ts

@@ -0,0 +1,21 @@
+import type { CpuArchFamily, ObservabilityContext, OsFamily, WorkspaceKind } from "./types.js";
+export declare function resolveOsFamily(platform?: NodeJS.Platform): OsFamily;
+export declare function resolveCpuArchFamily(arch?: string): CpuArchFamily;
+export declare function resolveNodeMajorVersion(version?: string): number;
+export declare function validateReleaseSha(value: string | undefined): string | null;
+export declare function readReleaseShaFromPackageRoot(packageRoot: string): string;
+export declare function resolveReleaseSha(input: {
+    env?: NodeJS.ProcessEnv;
+    moduleUrl?: string;
+}): string;
+export declare function resolvePackagedReleaseShaFromPackageRoot(packageRoot: string): string;
+export interface BuildObservabilityContextInput {
+    sessionId: string;
+    installationId?: string;
+    firstLaunchForPDevHome: boolean;
+    workspaceKind?: WorkspaceKind;
+    moduleUrl?: string;
+    env?: NodeJS.ProcessEnv;
+}
+export declare function buildObservabilityContext(input: BuildObservabilityContextInput): ObservabilityContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/observability/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/observability/context.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,QAAQ,EACR,aAAa,EACd,MAAM,YAAY,CAAC;AAIpB,wBAAgB,eAAe,CAAC,QAAQ,kBAAmB,GAAG,QAAQ,CAWrE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,MAAqB,GAAG,aAAa,CAW/E;AAED,wBAAgB,uBAAuB,CACrC,OAAO,SAAwB,GAC9B,MAAM,CAGR;AAID,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAM3E;AAED,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAazE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAqBT;AAED,wBAAgB,wCAAwC,CACtD,WAAW,EAAE,MAAM,GAClB,MAAM,CAUR;AAED,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,OAAO,CAAC;IAChC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,8BAA8B,GACpC,oBAAoB,CA0BtB"}

package/dist/observability/context.js

@@ -0,0 +1,105 @@
+import os from "node:os";
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { OBSERVABILITY_SCHEMA_VERSION, P_DEV_RELEASE_SHA_ENV, } from "./constants.js";
+import { resolveHarnessPackageVersion } from "../p-dev/package-version.js";
+import { resolvePackageRootFromModule } from "../p-dev/package-paths.js";
+export function resolveOsFamily(platform = process.platform) {
+    if (platform === "darwin") {
+        return "macos";
+    }
+    if (platform === "linux") {
+        return "linux";
+    }
+    if (platform === "win32") {
+        return "windows";
+    }
+    return "unknown";
+}
+export function resolveCpuArchFamily(arch = process.arch) {
+    if (arch === "arm64") {
+        return "arm64";
+    }
+    if (arch === "x64") {
+        return "x64";
+    }
+    if (arch) {
+        return "other";
+    }
+    return "unknown";
+}
+export function resolveNodeMajorVersion(version = process.versions.node) {
+    const major = Number.parseInt(version.split(".")[0] ?? "", 10);
+    return Number.isFinite(major) ? major : 0;
+}
+const RELEASE_SHA_PATTERN = /^[0-9a-f]{40}$/;
+export function validateReleaseSha(value) {
+    const normalized = value?.trim().toLowerCase();
+    if (!normalized || !RELEASE_SHA_PATTERN.test(normalized)) {
+        return null;
+    }
+    return normalized;
+}
+export function readReleaseShaFromPackageRoot(packageRoot) {
+    const manifestPath = path.join(packageRoot, "workspace-snapshot", "manifest.json");
+    try {
+        const raw = readFileSync(manifestPath, "utf8");
+        const parsed = JSON.parse(raw);
+        return validateReleaseSha(parsed.sourceCommit) ?? "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
+export function resolveReleaseSha(input) {
+    const env = input.env ?? process.env;
+    const handoff = validateReleaseSha(env[P_DEV_RELEASE_SHA_ENV]);
+    if (handoff) {
+        return handoff;
+    }
+    const moduleUrl = input.moduleUrl ?? import.meta.url;
+    try {
+        const packageRoot = resolvePackageRootFromModule(moduleUrl);
+        const fromManifest = validateReleaseSha(readReleaseShaFromPackageRoot(packageRoot));
+        if (fromManifest) {
+            return fromManifest;
+        }
+    }
+    catch {
+        // fall through to unknown
+    }
+    return "unknown";
+}
+export function resolvePackagedReleaseShaFromPackageRoot(packageRoot) {
+    const releaseSha = validateReleaseSha(readReleaseShaFromPackageRoot(packageRoot));
+    if (!releaseSha) {
+        throw new Error("Packaged workspace snapshot manifest is missing a valid sourceCommit.");
+    }
+    return releaseSha;
+}
+export function buildObservabilityContext(input) {
+    const env = input.env ?? process.env;
+    const moduleUrl = input.moduleUrl ?? import.meta.url;
+    let packageVersion;
+    try {
+        packageVersion = resolveHarnessPackageVersion(env, moduleUrl);
+    }
+    catch {
+        packageVersion = env.P_DEV_PACKAGE_VERSION?.trim() || "0.0.0";
+    }
+    const releaseSha = resolveReleaseSha({ env, moduleUrl });
+    return {
+        observabilitySchemaVersion: OBSERVABILITY_SCHEMA_VERSION,
+        packageVersion,
+        releaseSha,
+        runtimeMode: "packaged",
+        osFamily: resolveOsFamily(os.platform()),
+        cpuArchFamily: resolveCpuArchFamily(os.arch()),
+        nodeMajorVersion: resolveNodeMajorVersion(),
+        sessionId: input.sessionId,
+        installationId: input.installationId,
+        firstLaunchForPDevHome: input.firstLaunchForPDevHome,
+        workspaceKind: input.workspaceKind ?? "unknown",
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/observability/context.js.map

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

package/dist/observability/facade-runtime-state.d.ts

@@ -0,0 +1,17 @@
+import type { GuidedDisplayStepId } from "./analytics-schemas.js";
+import type { ObservabilitySession } from "./facade.js";
+import { type CategoryTransportLifecycle } from "./transport-lifecycle.js";
+import type { AnalyticsTransport, ErrorTransport, FakeTransportRecorder } from "./types.js";
+export interface FacadeRuntimeState {
+    activeSession: ObservabilitySession | null;
+    analyticsLifecycle: CategoryTransportLifecycle<AnalyticsTransport>;
+    errorLifecycle: CategoryTransportLifecycle<ErrorTransport>;
+    runtimeEligible: boolean;
+    activeFakeRecorder: FakeTransportRecorder | undefined;
+    parentOwnershipReleased: boolean;
+    displayedConfigureStepId: GuidedDisplayStepId | null;
+    activeProvisioningOperationId: string | null;
+}
+export declare function getFacadeRuntimeState(): FacadeRuntimeState;
+export declare function resetFacadeRuntimeState(): void;
+//# sourceMappingURL=facade-runtime-state.d.ts.map

package/dist/observability/facade-runtime-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facade-runtime-state.d.ts","sourceRoot":"","sources":["../../src/observability/facade-runtime-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC3C,kBAAkB,EAAE,0BAA0B,CAAC,kBAAkB,CAAC,CAAC;IACnE,cAAc,EAAE,0BAA0B,CAAC,cAAc,CAAC,CAAC;IAC3D,eAAe,EAAE,OAAO,CAAC;IACzB,kBAAkB,EAAE,qBAAqB,GAAG,SAAS,CAAC;IACtD,uBAAuB,EAAE,OAAO,CAAC;IACjC,wBAAwB,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACrD,6BAA6B,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9C;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,CAe1D;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C"}

package/dist/observability/facade-runtime-state.js

@@ -0,0 +1,23 @@
+import { createAnalyticsLifecycle, createErrorLifecycle, } from "./transport-lifecycle.js";
+const STATE_KEY = Symbol.for("@harness/observability/facade-runtime");
+export function getFacadeRuntimeState() {
+    const globalState = globalThis;
+    if (!globalState[STATE_KEY]) {
+        globalState[STATE_KEY] = {
+            activeSession: null,
+            analyticsLifecycle: createAnalyticsLifecycle(),
+            errorLifecycle: createErrorLifecycle(),
+            runtimeEligible: false,
+            activeFakeRecorder: undefined,
+            parentOwnershipReleased: false,
+            displayedConfigureStepId: null,
+            activeProvisioningOperationId: null,
+        };
+    }
+    return globalState[STATE_KEY];
+}
+export function resetFacadeRuntimeState() {
+    const globalState = globalThis;
+    delete globalState[STATE_KEY];
+}
+//# sourceMappingURL=facade-runtime-state.js.map

package/dist/observability/facade-runtime-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facade-runtime-state.js","sourceRoot":"","sources":["../../src/observability/facade-runtime-state.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,wBAAwB,EACxB,oBAAoB,GAErB,MAAM,0BAA0B,CAAC;AAOlC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;AAatE,MAAM,UAAU,qBAAqB;IACnC,MAAM,WAAW,GAAG,UAA4D,CAAC;IACjF,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,WAAW,CAAC,SAAS,CAAC,GAAG;YACvB,aAAa,EAAE,IAAI;YACnB,kBAAkB,EAAE,wBAAwB,EAAE;YAC9C,cAAc,EAAE,oBAAoB,EAAE;YACtC,eAAe,EAAE,KAAK;YACtB,kBAAkB,EAAE,SAAS;YAC7B,uBAAuB,EAAE,KAAK;YAC9B,wBAAwB,EAAE,IAAI;YAC9B,6BAA6B,EAAE,IAAI;SACpC,CAAC;IACJ,CAAC;IACD,OAAO,WAAW,CAAC,SAAS,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,MAAM,WAAW,GAAG,UAA4D,CAAC;IACjF,OAAO,WAAW,CAAC,SAAS,CAAC,CAAC;AAChC,CAAC"}

package/dist/observability/facade.d.ts

@@ -0,0 +1,44 @@
+import { type UpdateObservabilityPreferencesInput } from "./local-state.js";
+import { type GuidedDisplayStepId } from "./analytics-schemas.js";
+import type { AnalyticsEvent, AnalyticsTransport, EffectiveConsent, ErrorTransport, FakeTransportRecorder, ObservabilityContext, ObservabilityLocalState, ProductErrorCaptureInput, TypedBreadcrumb, WorkspaceKind } from "./types.js";
+export interface BeginObservabilitySessionInput {
+    workspaceDir: string;
+    workspaceKind?: WorkspaceKind;
+    moduleUrl?: string;
+    env?: NodeJS.ProcessEnv;
+    fakeRecorder?: FakeTransportRecorder;
+}
+export interface ObservabilitySession {
+    workspaceDir: string;
+    sessionId: string;
+    nonce: string;
+    context: ObservabilityContext;
+    consent: EffectiveConsent;
+    localState: ObservabilityLocalState;
+    moduleUrl?: string;
+}
+export declare function registerAnalyticsAdapterFactory(factory: () => AnalyticsTransport): void;
+export declare function registerErrorAdapterFactory(factory: (input: {
+    context: ObservabilityContext;
+    moduleUrl?: string;
+    env?: NodeJS.ProcessEnv;
+}) => ErrorTransport): void;
+export declare function registerDisplayedConfigureStep(stepId: GuidedDisplayStepId): void;
+export declare function registerProvisioningOperationId(operationId: string): void;
+export declare function isAnalyticsCaptureEnabled(): boolean;
+export declare function isErrorReportingCaptureEnabled(): boolean;
+export declare function beginObservabilitySession(input: BeginObservabilitySessionInput): Promise<ObservabilitySession | null>;
+export declare function getActiveObservabilitySession(): ObservabilitySession | null;
+export declare function getObservabilityNonce(): string | null;
+export declare function readObservabilityPreferences(workspaceDir: string): Promise<ObservabilityLocalState>;
+export declare function writeObservabilityPreferences(workspaceDir: string, input: UpdateObservabilityPreferencesInput): Promise<ObservabilitySession | null>;
+export declare function resetObservabilityState(workspaceDir: string): Promise<void>;
+export declare function releaseParentObservabilityOwnership(): Promise<void>;
+export declare function captureAnalyticsEvent(event: AnalyticsEvent): void;
+export declare function captureProductError(input: ProductErrorCaptureInput): void;
+export declare function addObservabilityBreadcrumb(breadcrumb: TypedBreadcrumb): void;
+export declare function flushObservability(deadlineMs?: number): Promise<void>;
+export declare function shutdownObservability(deadlineMs?: number): Promise<void>;
+export declare function createObservabilityTestRecorder(): FakeTransportRecorder;
+export declare function installObservabilityUncaughtHandlers(): () => void;
+//# sourceMappingURL=facade.d.ts.map

package/dist/observability/facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facade.d.ts","sourceRoot":"","sources":["../../src/observability/facade.ts"],"names":[],"mappings":"AAOA,OAAO,EAKL,KAAK,mCAAmC,EACzC,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AAUhC,OAAO,KAAK,EAEV,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,wBAAwB,EAExB,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AAepB,MAAM,WAAW,8BAA8B;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACtC;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,oBAAoB,CAAC;IAC9B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,UAAU,EAAE,uBAAuB,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAWD,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,kBAAkB,GAChC,IAAI,CAEN;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,CAAC,KAAK,EAAE;IACf,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,KAAK,cAAc,GACnB,IAAI,CAEN;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAEhF;AAED,wBAAgB,+BAA+B,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAEzE;AAED,wBAAgB,yBAAyB,IAAI,OAAO,CAQnD;AAED,wBAAgB,8BAA8B,IAAI,OAAO,CAQxD;AAmMD,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CA8DtC;AAED,wBAAgB,6BAA6B,IAAI,oBAAoB,GAAG,IAAI,CAE3E;AAED,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAOrD;AAED,wBAAsB,4BAA4B,CAChD,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,uBAAuB,CAAC,CAElC;AAED,wBAAsB,6BAA6B,CACjD,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,mCAAmC,GACzC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAyEtC;AAED,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,wBAAsB,mCAAmC,IAAI,OAAO,CAAC,IAAI,CAAC,CAWzE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAyCjE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAezE;AAED,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAS5E;AAED,wBAAsB,kBAAkB,CACtC,UAAU,SAAkC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,qBAAqB,CACzC,UAAU,SAAkC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,wBAAgB,+BAA+B,IAAI,qBAAqB,CAEvE;AAED,wBAAgB,oCAAoC,IAAI,MAAM,IAAI,CAEjE"}