typekro 0.28.0 → 0.29.0

package/dist/core/planning/types.d.ts

@@ -0,0 +1,441 @@
+import type { AnyAspectDefinition } from '../aspects/types.js';
+import type { KubernetesResource } from '../types/kubernetes.js';
+/** Version of the experimental semantic planning DTOs. */
+export declare const SEMANTIC_PLAN_VERSION: 1;
+/** Stable JSON-compatible primitive. */
+export type PlanPrimitive = string | number | boolean | null;
+/** Source location attached to a planning diagnostic when available. */
+export interface PlanSourceLocation {
+    readonly file?: string;
+    readonly line?: number;
+    readonly column?: number;
+}
+/** Structured diagnostic returned by inspection, planning, and canonicalization. */
+export interface PlanDiagnostic {
+    readonly code: string;
+    readonly severity: 'info' | 'warning' | 'error';
+    readonly message: string;
+    readonly path?: string;
+    readonly location?: PlanSourceLocation;
+    readonly details?: Readonly<Record<string, PlanPrimitive>>;
+}
+/** Reference captured by portable expression IR. */
+export interface ExpressionReferenceIR {
+    readonly source: 'spec' | 'resource';
+    readonly resourceId?: string;
+    readonly fieldPath: string;
+}
+/**
+ * Canonical expression accepted by the Gate B compatibility frontend.
+ *
+ * Natural TypeScript, computed expressions, and explicit CEL all lower to this
+ * representation before direct evaluation or KRO emission. Raw CEL remains
+ * explicitly target-constrained.
+ */
+export interface ExpressionIR {
+    readonly version: 1;
+    readonly language: 'portable-cel' | 'raw-cel';
+    readonly expression: string;
+    readonly references: readonly ExpressionReferenceIR[];
+    readonly sensitivity: 'public' | 'sensitive';
+    readonly sourceLocation?: PlanSourceLocation;
+}
+export interface PlanLiteralValue {
+    readonly kind: 'literal';
+    readonly value: PlanPrimitive;
+}
+export interface PlanArrayValue {
+    readonly kind: 'array';
+    readonly items: readonly PlanValue[];
+}
+export interface PlanObjectEntry {
+    readonly key: string;
+    readonly value: PlanValue;
+}
+export interface PlanObjectValue {
+    readonly kind: 'object';
+    readonly entries: readonly PlanObjectEntry[];
+}
+export interface PlanReferenceValue {
+    readonly kind: 'reference';
+    readonly source: 'spec' | 'resource';
+    readonly resourceId?: string;
+    readonly fieldPath: string;
+    /** Absence is a valid value and omits the containing materialized field. */
+    readonly optional?: true;
+    /** The producer is a flattened composition boundary, not a Kubernetes child. */
+    readonly nestedComposition?: true;
+}
+export interface PlanExpressionValue {
+    readonly kind: 'expression';
+    readonly expression: ExpressionIR;
+}
+export type PlanTemplateSegment = {
+    readonly kind: 'literal';
+    readonly value: string;
+} | {
+    readonly kind: 'expression';
+    readonly expression: ExpressionIR;
+} | {
+    readonly kind: 'reference';
+    readonly source: 'spec' | 'resource';
+    readonly resourceId?: string;
+    readonly fieldPath: string;
+    /** Absence omits the complete containing template value. */
+    readonly optional?: true;
+    /** The producer is a flattened composition boundary, not a Kubernetes child. */
+    readonly nestedComposition?: true;
+};
+/** String template with references preserved as typed segments. */
+export interface PlanTemplateValue {
+    readonly kind: 'template';
+    readonly segments: readonly PlanTemplateSegment[];
+}
+export interface PlanOmittedValue {
+    readonly kind: 'omitted';
+}
+export interface SensitiveValueRef {
+    readonly kind: 'sensitive-binding';
+    readonly binding: string;
+    readonly version?: string;
+}
+/**
+ * A symbolic or derived value whose materialized result is sensitive.
+ *
+ * The wrapped value must itself be safe to serialize. In particular, this is
+ * used for spec/resource references and portable expressions that feed a
+ * Kubernetes Secret; it is never a container for inline plaintext bytes.
+ */
+export interface PlanSensitiveValue {
+    readonly kind: 'sensitive-value';
+    readonly value: PlanValue;
+}
+export interface ExternalInputRef {
+    readonly kind: 'external-input';
+    readonly name: string;
+}
+export interface ArtifactOutputRef {
+    readonly kind: 'artifact-output';
+    readonly requirementId: string;
+    readonly output: string;
+}
+/** Canonical, unambiguous value tree used by semantic plans. */
+export type PlanValue = PlanLiteralValue | PlanArrayValue | PlanObjectValue | PlanReferenceValue | PlanExpressionValue | PlanTemplateValue | PlanOmittedValue | SensitiveValueRef | PlanSensitiveValue | ExternalInputRef | ArtifactOutputRef;
+/** Result of lowering a runtime authoring value into canonical plan form. */
+export interface PlanValueLoweringResult {
+    readonly value: PlanValue;
+    readonly diagnostics: readonly PlanDiagnostic[];
+    readonly sensitivity: 'public' | 'sensitive';
+}
+export interface SchemaPropertyIR {
+    readonly name: string;
+    readonly required: boolean;
+    readonly schema: SchemaNodeIR;
+    readonly defaultValue?: PlanValue;
+}
+/** Canonical constraint values supported by the portable schema profile. */
+export type SchemaConstraintValue = PlanPrimitive | readonly PlanPrimitive[];
+export type SchemaNodeIR = {
+    readonly kind: 'primitive';
+    readonly type: 'string' | 'number' | 'boolean' | 'null' | 'unknown';
+    readonly constraints?: Readonly<Record<string, SchemaConstraintValue>>;
+} | {
+    readonly kind: 'literal';
+    readonly value: PlanPrimitive;
+} | {
+    readonly kind: 'array';
+    readonly items: SchemaNodeIR;
+} | {
+    readonly kind: 'object';
+    readonly properties: readonly SchemaPropertyIR[];
+} | {
+    readonly kind: 'union';
+    readonly variants: readonly SchemaNodeIR[];
+} | {
+    readonly kind: 'unsupported';
+    readonly description: string;
+    readonly raw: PlanValue;
+};
+/** Versioned canonical schema representation derived from ArkType JSON. */
+export interface SchemaIR {
+    readonly version: 1;
+    readonly root: SchemaNodeIR;
+    readonly digest: string;
+    readonly diagnostics: readonly PlanDiagnostic[];
+}
+export type CompositionIdentity = {
+    readonly name: string;
+    readonly apiVersion: string;
+    readonly kind: string;
+    readonly stability: 'stable';
+    readonly revision: {
+        readonly kind: 'version';
+        readonly value: string;
+    } | {
+        readonly kind: 'bundle-digest';
+        readonly value: string;
+    };
+    readonly diagnosticSourceDigest?: string;
+} | {
+    readonly name: string;
+    readonly apiVersion: string;
+    readonly kind: string;
+    readonly stability: 'preview-unstable';
+    readonly diagnosticSourceDigest: string;
+};
+export interface CapabilityRequirement {
+    readonly id: string;
+    readonly version: number;
+    /** Deployment representation required by this capability. */
+    readonly target?: 'direct' | 'kro';
+    /** Execution host required to satisfy this capability. */
+    readonly host?: 'standalone' | 'alchemy';
+    /** Output form required to satisfy this capability. */
+    readonly output?: 'live' | 'static';
+    readonly nodeId?: string;
+}
+export interface StatusProjection {
+    readonly path: string;
+    readonly source: 'live-resource' | 'desired-spec' | 'static' | 'derived' | 'client-only';
+    readonly mode: 'auto' | 'native' | 'relay' | 'client-only';
+    readonly persistedPath?: string;
+    readonly value?: PlanValue;
+}
+export interface StatusContract {
+    readonly persistedSchema: SchemaIR;
+    readonly hydratedSchema: SchemaIR;
+    readonly projections: readonly StatusProjection[];
+}
+export interface AspectManifestEntry {
+    readonly id: string;
+    readonly revision: string;
+    readonly configuration: PlanValue;
+    readonly order: number;
+}
+export interface OrdinaryInputBinding {
+    readonly kind: 'ordinary';
+    readonly value: unknown;
+}
+export interface SensitiveInputBinding {
+    readonly kind: 'sensitive';
+    readonly binding: string;
+    readonly version?: string;
+}
+export interface ArtifactInputBinding {
+    readonly kind: 'artifact';
+    readonly requirement: ArtifactRequirement;
+}
+export type DeclaredInputBinding = OrdinaryInputBinding | SensitiveInputBinding | ArtifactInputBinding;
+export type DeclaredInputManifestEntry = {
+    readonly name: string;
+    readonly kind: 'ordinary';
+    readonly value: PlanValue;
+} | {
+    readonly name: string;
+    readonly kind: 'sensitive';
+    readonly binding: string;
+    readonly version?: string;
+} | {
+    readonly name: string;
+    readonly kind: 'artifact';
+    readonly requirement: ArtifactRequirement;
+};
+export interface ArtifactRequirement {
+    readonly kind: string;
+    readonly id: string;
+    readonly descriptor: PlanValue;
+    readonly outputs: readonly string[];
+}
+/** One artifact output consumed by a compiled operation. */
+export interface ArtifactOutputUse {
+    readonly requirementId: string;
+    readonly output: string;
+    /** The output flows through a sensitive-value boundary and must be redacted in host state. */
+    readonly sensitive: boolean;
+}
+export interface RepresentationRequirement {
+    readonly target: 'direct' | 'kro';
+    readonly kind: string;
+    readonly extension: string;
+    readonly version: number;
+    readonly inputs: PlanValue;
+    readonly sourceNodeId?: string;
+    readonly factoryName?: string;
+}
+export interface CanonicalizerManifestEntry {
+    readonly id: string;
+    readonly revision: string;
+    readonly stage: 'desired';
+    /** Factory registration whose resource caused this canonicalizer to run. */
+    readonly factoryName?: string;
+}
+export interface PlanOptions {
+    readonly aspects?: readonly AnyAspectDefinition[];
+    readonly inputs?: Readonly<Record<string, DeclaredInputBinding>>;
+    readonly strict?: boolean;
+}
+export interface CompositionInspection {
+    readonly version: 1;
+    readonly composition: CompositionIdentity;
+    readonly specSchema: SchemaIR;
+    readonly status: StatusContract;
+    readonly potentialCapabilities: readonly CapabilityRequirement[];
+    readonly diagnostics: readonly PlanDiagnostic[];
+}
+export interface LogicalInstanceIdentity {
+    readonly composition: string;
+    readonly name: PlanValue;
+}
+export interface KubernetesIdentity {
+    readonly apiVersion: string;
+    readonly kind: string;
+    readonly name: PlanValue;
+    readonly namespace?: PlanValue;
+    readonly scope: 'cluster' | 'namespaced';
+}
+export interface UnusedEvidence {
+    readonly provider: string;
+    readonly version: number;
+    readonly inputs: PlanValue;
+}
+export interface LifecyclePolicy {
+    readonly creation: 'create' | 'adopt' | 'require-existing';
+    readonly management: 'authoritative' | 'cooperative' | 'reference-only';
+    readonly deletion: 'delete' | 'retain' | 'delete-when-unused';
+    readonly instancing: {
+        readonly kind: 'per-instance';
+    } | {
+        readonly kind: 'per-scope';
+        readonly key: PlanValue;
+    } | {
+        readonly kind: 'per-cluster';
+    };
+    readonly sharing: 'exclusive' | 'shareable';
+    readonly unusedEvidence?: UnusedEvidence;
+}
+/** Serializable identity for the client-side strategy used to evaluate readiness. */
+export interface RuntimeReadinessClassification {
+    readonly reason: 'ambient-clock' | 'ambient-state' | 'host-callback' | 'opaque-code' | 'unclassified-evaluator';
+    readonly description?: string;
+}
+export type ReadinessStrategyIdentity = {
+    readonly kind: 'registered';
+    readonly id: string;
+    readonly revision: string;
+    readonly configuration?: PlanValue;
+} | {
+    readonly kind: 'runtime-binding';
+    readonly binding: string;
+    readonly version: 1;
+    /**
+     * Why this evaluator cannot be reconstructed from canonical artifact data.
+     * Optional only for decoding persisted experimental records created before
+     * runtime readiness classification was introduced.
+     */
+    readonly classification?: RuntimeReadinessClassification;
+};
+export interface PlanTemplateOverride {
+    readonly propertyPath: string;
+    readonly value: PlanValue;
+}
+/** One analyzer-proven collection dimension shared by direct and KRO lowering. */
+export interface PlanIterationDimension {
+    /** Stable source-level iterator variable used by portable collection expressions. */
+    readonly variable: string;
+    /** Portable expression that evaluates to the collection for this dimension. */
+    readonly collection: PlanValue;
+    /** Canonical schema-proxy path whose `$item` sentinel is bound by this dimension. */
+    readonly itemPath: string;
+}
+export interface PlanNode {
+    readonly id: string;
+    readonly type: 'kubernetes-resource' | 'compatibility-closure';
+    readonly identity?: KubernetesIdentity;
+    readonly desired?: PlanValue;
+    readonly lifecycle: LifecyclePolicy;
+    readonly activation: readonly PlanValue[];
+    readonly readiness: readonly PlanValue[];
+    readonly readinessStrategy?: ReadinessStrategyIdentity;
+    /** Analyzer-proven collection dimensions retained for both target compilers. */
+    readonly iteration?: readonly PlanIterationDimension[];
+    /** Analyzer-produced property replacements applied after template lowering. */
+    readonly templateOverrides?: readonly PlanTemplateOverride[];
+    readonly requiredCapabilities: readonly CapabilityRequirement[];
+}
+export type PlanEdge = {
+    readonly kind: 'output';
+    readonly producer: string;
+    readonly consumer: string;
+    readonly output: string;
+} | {
+    readonly kind: 'existence' | 'ready';
+    readonly prerequisite: string;
+    readonly dependent: string;
+} | {
+    readonly kind: 'ownership';
+    readonly owner: string;
+    readonly child: string;
+} | {
+    readonly kind: 'delete-after';
+    readonly resource: string;
+    readonly blocker: string;
+};
+export interface DesiredStatePlan {
+    readonly version: 1;
+    readonly composition: CompositionIdentity;
+    readonly schemas: {
+        readonly irVersion: 1;
+        readonly spec: SchemaIR;
+        readonly specDigest: string;
+        readonly persistedStatusDigest: string;
+        readonly hydratedStatusDigest: string;
+    };
+    readonly status: StatusContract;
+    readonly instance: LogicalInstanceIdentity;
+    readonly spec: PlanValue;
+    readonly nodes: readonly PlanNode[];
+    readonly edges: readonly PlanEdge[];
+    readonly outputs: Readonly<Record<string, PlanValue>>;
+    readonly inputs: readonly DeclaredInputManifestEntry[];
+    readonly aspects: readonly AspectManifestEntry[];
+    readonly representationRequirements: readonly RepresentationRequirement[];
+    readonly provenance: {
+        readonly canonicalizers: readonly CanonicalizerManifestEntry[];
+    };
+    readonly requiredCapabilities: readonly CapabilityRequirement[];
+    readonly durability: {
+        readonly cacheEligible: boolean;
+        readonly provenanceEligible: boolean;
+        readonly reasons: readonly PlanDiagnostic[];
+    };
+    readonly inputDigest: string;
+    readonly aspectDigest: string;
+    readonly semanticContentDigest: string;
+    readonly planIdentityDigest: string;
+    readonly diagnostics: readonly PlanDiagnostic[];
+}
+/** Internal capture shared by inspection and planning. */
+export interface CapturedCompositionIR {
+    readonly version: 1;
+    readonly definition: {
+        readonly name: string;
+        readonly apiVersion: string;
+        readonly kind: string;
+        readonly group?: string;
+        readonly revision?: string;
+        readonly specSchema: {
+            readonly json?: unknown;
+        };
+        readonly statusSchema: {
+            readonly json?: unknown;
+        };
+    };
+    readonly resources: Readonly<Record<string, KubernetesResource>>;
+    readonly statusMappings: Readonly<Record<string, unknown>>;
+    /** Flattened nested-composition outputs used to classify virtual status references. */
+    readonly nestedStatusMappings: Readonly<Record<string, string>>;
+    readonly compatibilityClosures: readonly string[];
+    readonly potentialCapabilities: readonly CapabilityRequirement[];
+    readonly canonicalizers: readonly CanonicalizerManifestEntry[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/planning/types.d.ts.map

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

package/dist/core/planning/types.js

@@ -0,0 +1,3 @@
+/** Version of the experimental semantic planning DTOs. */
+export const SEMANTIC_PLAN_VERSION = 1;
+//# sourceMappingURL=types.js.map

package/dist/core/planning/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/planning/types.ts"],"names":[],"mappings":"AAGA,0DAA0D;AAC1D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAU,CAAC"}

package/dist/core/planning/values.d.ts

@@ -0,0 +1,76 @@
+import type { CelEvaluationContext } from '../types/references.js';
+import type { ArtifactOutputRef, ArtifactOutputUse, ExpressionIR, ExpressionReferenceIR, ExternalInputRef, PlanSourceLocation, PlanValue, PlanValueLoweringResult, SchemaIR, SensitiveValueRef } from './types.js';
+declare const SENSITIVE_INPUT_BRAND: unique symbol;
+declare const EXTERNAL_INPUT_BRAND: unique symbol;
+declare const ARTIFACT_OUTPUT_BRAND: unique symbol;
+declare const PLAN_EXPRESSION_BRAND: unique symbol;
+type SensitiveValueInput = SensitiveValueRef & {
+    readonly [SENSITIVE_INPUT_BRAND]: true;
+};
+type ExternalInput = ExternalInputRef & {
+    readonly [EXTERNAL_INPUT_BRAND]: true;
+};
+type ArtifactOutput<T> = ArtifactOutputRef & T & {
+    readonly [ARTIFACT_OUTPUT_BRAND]: true;
+};
+type ExpressionValueInput = {
+    readonly kind: 'expression';
+    readonly expression: ExpressionIR;
+    readonly [PLAN_EXPRESSION_BRAND]: true;
+};
+/** Detect an explicit planning value embedded in an otherwise ordinary value tree. */
+export declare function containsExplicitPlanValue(value: unknown, seen?: WeakSet<object>): boolean;
+/** Declare an opaque sensitive binding without embedding its plaintext value. */
+export declare function sensitiveValue(binding: string, version?: string): SensitiveValueInput;
+/** Reference a declared external planning input from a value tree. */
+export declare function externalInput(name: string): ExternalInput;
+/**
+ * Reference an output of a declared artifact requirement.
+ *
+ * Artifact producers most commonly return strings such as image digests, so the authoring value
+ * defaults to `string`. Callers may select another direct-mode value type explicitly.
+ */
+export declare function artifactOutput<T = string>(requirementId: string, output: string): ArtifactOutput<T>;
+/**
+ * KRO root-spec field reserved for TypeKro's per-installation provider bindings.
+ *
+ * This is intentionally stable because persisted Alchemy state and generated
+ * custom resources must agree on the field name. KRO compilation rejects user
+ * schemas and instance specs that claim it.
+ */
+export declare const KRO_ARTIFACT_BINDINGS_SPEC_FIELD = "typekroArtifactBindings";
+/** Stable KRO instance-spec field for one artifact requirement. */
+export declare function kroArtifactRequirementField(requirementId: string): string;
+/** Stable KRO instance-spec field for one artifact output. */
+export declare function kroArtifactOutputField(output: string): string;
+/**
+ * Find every cross-provider artifact output used by a canonical value or artifact DTO.
+ * Sensitivity follows the nearest `sensitive-value` envelope so durable hosts can redact
+ * only the outputs that actually carry secret material.
+ */
+export declare function collectArtifactOutputUses(value: unknown): readonly ArtifactOutputUse[];
+/** Embed a portable or target-constrained expression in a PlanValue tree. */
+export declare function planExpression(expression: ExpressionIR): ExpressionValueInput;
+/** Create canonical expression IR from emitted CEL. */
+export declare function expressionIR(expression: string, options?: {
+    readonly language?: ExpressionIR['language'];
+    readonly sensitivity?: ExpressionIR['sensitivity'];
+    readonly references?: readonly ExpressionReferenceIR[];
+    readonly sourceLocation?: PlanSourceLocation;
+}): ExpressionIR;
+/** Lower an authoring/runtime value into canonical PlanValue form. */
+export declare function lowerPlanValue(value: unknown, options?: {
+    readonly expressionLanguage?: ExpressionIR['language'];
+    readonly specSchema?: SchemaIR;
+    readonly strict?: boolean;
+}): PlanValueLoweringResult;
+/** Canonically encode a PlanValue. */
+export declare function encodePlanValue(value: PlanValue): string;
+/** Decode and structurally validate a PlanValue. */
+export declare function decodePlanValue(encoded: string): PlanValue;
+/** Emit the canonical CEL source consumed by the KRO frontend. */
+export declare function emitExpressionCel(expression: ExpressionIR): string;
+/** Evaluate portable expression IR through the same CEL evaluator used by direct mode. */
+export declare function evaluateExpressionIR(expression: ExpressionIR, context: CelEvaluationContext): Promise<unknown>;
+export {};
+//# sourceMappingURL=values.d.ts.map

package/dist/core/planning/values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../../src/core/planning/values.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAGnE,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,EACrB,gBAAgB,EAEhB,kBAAkB,EAElB,SAAS,EACT,uBAAuB,EACvB,QAAQ,EAER,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,QAAA,MAAM,qBAAqB,eAAiD,CAAC;AAC7E,QAAA,MAAM,oBAAoB,eAAgD,CAAC;AAC3E,QAAA,MAAM,qBAAqB,eAAiD,CAAC;AAC7E,QAAA,MAAM,qBAAqB,eAA4C,CAAC;AAExE,KAAK,mBAAmB,GAAG,iBAAiB,GAAG;IAAE,QAAQ,CAAC,CAAC,qBAAqB,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAC1F,KAAK,aAAa,GAAG,gBAAgB,GAAG;IAAE,QAAQ,CAAC,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAClF,KAAK,cAAc,CAAC,CAAC,IAAI,iBAAiB,GAAG,CAAC,GAAG;IAAE,QAAQ,CAAC,CAAC,qBAAqB,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAC5F,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;IAClC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,EAAE,IAAI,CAAC;CACxC,CAAC;AAEF,sFAAsF;AACtF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,kBAAwB,GAAG,OAAO,CAe/F;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAarF;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAYzD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,GAAG,MAAM,EACvC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,cAAc,CAAC,CAAC,CAAC,CAanB;AAMD;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC,4BAA4B,CAAC;AAE1E,mEAAmE;AACnE,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,8DAA8D;AAC9D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,iBAAiB,EAAE,CAiCtF;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,UAAU,EAAE,YAAY,GAAG,oBAAoB,CAM7E;AAqFD,uDAAuD;AACvD,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IACP,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC;IACnD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACvD,QAAQ,CAAC,cAAc,CAAC,EAAE,kBAAkB,CAAC;CACzC,GACL,YAAY,CAoBd;AA0ZD,sEAAsE;AACtE,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE;IACP,QAAQ,CAAC,kBAAkB,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACvD,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CACtB,GACL,uBAAuB,CAsBzB;AAyRD,sCAAsC;AACtC,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAExD;AAED,oDAAoD;AACpD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAI1D;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,YAAY,GAAG,MAAM,CAElE;AAED,0FAA0F;AAC1F,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,YAAY,EACxB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAYlB"}