@spottoai/types-package 1.0.2-beta.99 → 1.0.2-dev1138.2

package/dist/azure/financialDataflow.d.ts

@@ -0,0 +1,123 @@
+import type { CostBasis, FinancialEstimateLensV1 } from './costComposition';
+import type { FinancialEvidenceIntervalV1 } from './financialScopeEvidence';
+import type { FinancialWindowKindV2 } from './financialScopeBaseline';
+export declare const FINANCIAL_DATAFLOW_SCHEMA_VERSION_V1: 1;
+export declare const FINANCIAL_CURRENT_SPEND_COMPOSITION_CONTRACT_VERSION_V1: "current-spend-composition/v1";
+export type FinancialDataflowScopeKindV1 = 'resource' | 'resource-group' | 'subscription' | 'tag-scope' | 'multi-subscription';
+export type FinancialDataflowPeriodRoleV1 = 'current-spend' | 'comparison' | 'analytics-input' | 'projection-target';
+/** Stable period identity. Result-specific observed coverage and gaps live in evidence artifacts, not the coordinate ID. */
+export interface FinancialDataflowPeriodV1 {
+    windowKind: FinancialWindowKindV2;
+    requested: FinancialEvidenceIntervalV1;
+    providerBillingPeriodId?: string;
+}
+export interface FinancialDataflowScopeV1 {
+    kind: FinancialDataflowScopeKindV1;
+    scopeId: string;
+    /** Digest of normalized membership and selector semantics, not a display label. */
+    scopeFingerprint: string;
+}
+/** Stored-byte descriptor shared by immutable financial delivery manifests. */
+export interface FinancialDataflowJsonGzipArtifactDescriptorV1 {
+    path: string;
+    sha256: string;
+    byteCount: number;
+    mediaType: 'application/json';
+    contentEncoding: 'gzip';
+}
+export interface FinancialDataflowTagSelectorV1 {
+    key: string;
+    value: string;
+}
+export type FinancialDataflowScopeSelectorV1 = {
+    kind: 'resource';
+    resourceIds: [string, ...string[]];
+} | {
+    kind: 'resource-group';
+    resourceGroupIds: [string, ...string[]];
+} | {
+    kind: 'subscription';
+    subscriptionIds: [string, ...string[]];
+} | {
+    kind: 'tag-scope';
+    tags: [FinancialDataflowTagSelectorV1, ...FinancialDataflowTagSelectorV1[]];
+    tagMatch: 'any' | 'all';
+} | {
+    kind: 'multi-subscription';
+    subscriptionIds: [string, ...string[]];
+};
+export type FinancialAccountingCurrencyStateV1 = {
+    status: 'resolved';
+    currencyCode: string;
+} | {
+    status: 'unresolved';
+    reasonCode: 'currency-unresolved' | 'currency-conflicting';
+    currencyCode?: never;
+};
+/** Exact identity dimensions shared by current spend, analytics, and policy inputs. */
+export interface FinancialDataflowCoordinateV1 {
+    companyId: string;
+    provider: 'azure';
+    providerAccountRefs: [string, ...string[]];
+    scope: FinancialDataflowScopeV1;
+    periodRole: FinancialDataflowPeriodRoleV1;
+    period: FinancialDataflowPeriodV1;
+    costBasis: CostBasis;
+    estimateLens: FinancialEstimateLensV1;
+    /** Requested presentation currency. A resolved coordinate must resolve to this currency; this never implies FX conversion. */
+    requestedCurrencyCode?: string;
+    accountingCurrency: FinancialAccountingCurrencyStateV1;
+}
+export interface IncludedCurrentSpendMemberV1 {
+    memberScopeId: string;
+    baselineId: string;
+    status: 'included';
+    reasonCode?: never;
+}
+export interface UnavailableCurrentSpendMemberV1 {
+    memberScopeId: string;
+    status: 'unavailable';
+    reasonCode: string;
+    baselineId?: never;
+}
+export type CurrentSpendCompositionMemberV1 = IncludedCurrentSpendMemberV1 | UnavailableCurrentSpendMemberV1;
+interface CurrentSpendCompositionCommonV1 {
+    schemaVersion: typeof FINANCIAL_DATAFLOW_SCHEMA_VERSION_V1;
+    contractVersion: typeof FINANCIAL_CURRENT_SPEND_COMPOSITION_CONTRACT_VERSION_V1;
+    compositionId: string;
+    coordinate: FinancialDataflowCoordinateV1;
+    members: CurrentSpendCompositionMemberV1[];
+    membershipDigest: string;
+    algorithmVersion: string;
+}
+export interface AvailableCurrentSpendCompositionV1 extends CurrentSpendCompositionCommonV1 {
+    amount: {
+        status: 'available';
+        amount: string;
+        currencyCode: string;
+        knownAmount?: never;
+        reasonCodes?: never;
+    };
+}
+export interface PartialCurrentSpendCompositionV1 extends CurrentSpendCompositionCommonV1 {
+    amount: {
+        status: 'partial';
+        knownAmount: string;
+        currencyCode: string;
+        reasonCodes: [string, ...string[]];
+        amount?: never;
+    };
+}
+export interface UnavailableCurrentSpendCompositionV1 extends CurrentSpendCompositionCommonV1 {
+    amount: {
+        status: 'unavailable';
+        reasonCodes: [string, ...string[]];
+        amount?: never;
+        knownAmount?: never;
+        currencyCode?: never;
+    };
+}
+export type CurrentSpendCompositionV1 = AvailableCurrentSpendCompositionV1 | PartialCurrentSpendCompositionV1 | UnavailableCurrentSpendCompositionV1;
+export type CurrentSpendCompositionIdentityPreimageV1 = CurrentSpendCompositionV1 extends infer Composition ? Composition extends CurrentSpendCompositionV1 ? Omit<Composition, 'compositionId'> : never : never;
+export {};
+//# sourceMappingURL=financialDataflow.d.ts.map

package/dist/azure/financialDataflow.d.ts.map

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

package/dist/azure/financialDataflow.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FINANCIAL_CURRENT_SPEND_COMPOSITION_CONTRACT_VERSION_V1 = exports.FINANCIAL_DATAFLOW_SCHEMA_VERSION_V1 = void 0;
+exports.FINANCIAL_DATAFLOW_SCHEMA_VERSION_V1 = 1;
+exports.FINANCIAL_CURRENT_SPEND_COMPOSITION_CONTRACT_VERSION_V1 = 'current-spend-composition/v1';
+//# sourceMappingURL=financialDataflow.js.map

package/dist/azure/financialDataflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"financialDataflow.js","sourceRoot":"","sources":["../../src/azure/financialDataflow.ts"],"names":[],"mappings":";;;AAIa,QAAA,oCAAoC,GAAG,CAAU,CAAC;AAClD,QAAA,uDAAuD,GAAG,8BAAuC,CAAC"}

package/dist/azure/financialDataflowKernel.d.ts

@@ -0,0 +1,29 @@
+import { type CurrentSpendCompositionV1, type FinancialDataflowCoordinateV1 } from './financialDataflow';
+import { type FinancialScopeBaselineEnvelopeV2 } from './financialScopeBaseline';
+export declare const CURRENT_SPEND_COMPOSITION_ALGORITHM_VERSION_V1: "current-spend-composition/shared-v1";
+export interface CurrentSpendCompositionKernelRequestV1 {
+    coordinate: FinancialDataflowCoordinateV1;
+    baselines: FinancialScopeBaselineEnvelopeV2[];
+    algorithmVersion?: string;
+}
+export type FinancialExactTrendComparisonV1 = {
+    status: 'unavailable';
+} | {
+    status: 'available';
+    direction: 'increasing' | 'decreasing' | 'flat';
+    changeAmount: string;
+    /** Present only when the exact ratio has a canonical representation at six or fewer decimal places. */
+    percentChange?: string;
+};
+/**
+ * Shared exact current-versus-comparison semantics for display composition.
+ * Canonical analytics projections use the same direction/change/percentage
+ * rules; this helper does not create or impersonate an analytics authority.
+ */
+export declare const compareFinancialExactAmountsV1: (request: {
+    currentAmount?: string;
+    comparisonAmount?: string;
+}) => FinancialExactTrendComparisonV1;
+/** Portable exact-decimal composition kernel shared by Cloud and browser runtimes. */
+export declare const composeCurrentSpendV1: (request: CurrentSpendCompositionKernelRequestV1) => CurrentSpendCompositionV1;
+//# sourceMappingURL=financialDataflowKernel.d.ts.map

package/dist/azure/financialDataflowKernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"financialDataflowKernel.d.ts","sourceRoot":"","sources":["../../src/azure/financialDataflowKernel.ts"],"names":[],"mappings":"AAOA,OAAO,EAKL,KAAK,yBAAyB,EAC9B,KAAK,6BAA6B,EACnC,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EAAuC,KAAK,gCAAgC,EAAE,MAAM,0BAA0B,CAAC;AAEtH,eAAO,MAAM,8CAA8C,EAAG,qCAA8C,CAAC;AAE7G,MAAM,WAAW,sCAAsC;IACrD,UAAU,EAAE,6BAA6B,CAAC;IAC1C,SAAS,EAAE,gCAAgC,EAAE,CAAC;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,+BAA+B,GACvC;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,GACzB;IACE,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,YAAY,GAAG,YAAY,GAAG,MAAM,CAAC;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,uGAAuG;IACvG,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAeN;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,GAAI,SAAS;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,KAAG,+BAuBH,CAAC;AAQF,sFAAsF;AACtF,eAAO,MAAM,qBAAqB,GAAI,SAAS,sCAAsC,KAAG,yBA2DvF,CAAC"}

package/dist/azure/financialDataflowKernel.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.composeCurrentSpendV1 = exports.compareFinancialExactAmountsV1 = exports.CURRENT_SPEND_COMPOSITION_ALGORITHM_VERSION_V1 = void 0;
+const exactDecimal_1 = require("../common/exactDecimal");
+const financialDataflow_1 = require("./financialDataflow");
+const financialDataflowValidation_1 = require("./financialDataflowValidation");
+const financialScopeBaseline_1 = require("./financialScopeBaseline");
+exports.CURRENT_SPEND_COMPOSITION_ALGORITHM_VERSION_V1 = 'current-spend-composition/shared-v1';
+const exactPercentAtSixDecimalPlaces = (change, comparison) => {
+    if (comparison.coefficient === 0n)
+        return undefined;
+    const numerator = change.coefficient * 100n * 10n ** BigInt(comparison.scale);
+    const denominator = comparison.coefficient * 10n ** BigInt(change.scale);
+    for (let scale = 0; scale <= 6; scale += 1) {
+        const scaledNumerator = numerator * 10n ** BigInt(scale);
+        if (scaledNumerator % denominator === 0n) {
+            return (0, exactDecimal_1.formatExactDecimalValue)({ coefficient: scaledNumerator / denominator, scale });
+        }
+    }
+    return undefined;
+};
+/**
+ * Shared exact current-versus-comparison semantics for display composition.
+ * Canonical analytics projections use the same direction/change/percentage
+ * rules; this helper does not create or impersonate an analytics authority.
+ */
+const compareFinancialExactAmountsV1 = (request) => {
+    if (request.currentAmount === undefined || request.comparisonAmount === undefined)
+        return { status: 'unavailable' };
+    try {
+        const current = (0, exactDecimal_1.parseCanonicalDecimal)(request.currentAmount);
+        const comparison = (0, exactDecimal_1.parseCanonicalDecimal)(request.comparisonAmount);
+        if ((0, exactDecimal_1.formatExactDecimalValue)(current) !== request.currentAmount ||
+            (0, exactDecimal_1.formatExactDecimalValue)(comparison) !== request.comparisonAmount) {
+            return { status: 'unavailable' };
+        }
+        const change = (0, exactDecimal_1.subtractExactDecimalValues)(current, comparison);
+        const direction = change.coefficient === 0n ? 'flat' : change.coefficient > 0n ? 'increasing' : 'decreasing';
+        const percentChange = exactPercentAtSixDecimalPlaces(change, comparison);
+        return {
+            status: 'available',
+            direction,
+            changeAmount: (0, exactDecimal_1.formatExactDecimalValue)(change),
+            ...(percentChange === undefined ? {} : { percentChange }),
+        };
+    }
+    catch {
+        return { status: 'unavailable' };
+    }
+};
+exports.compareFinancialExactAmountsV1 = compareFinancialExactAmountsV1;
+const uniqueSorted = (values) => {
+    const result = Array.from(new Set(values)).sort();
+    if (result.length === 0)
+        throw new TypeError('Current-spend unavailable state requires at least one reason code.');
+    return result;
+};
+/** Portable exact-decimal composition kernel shared by Cloud and browser runtimes. */
+const composeCurrentSpendV1 = (request) => {
+    if (request.coordinate.periodRole !== 'current-spend' && request.coordinate.periodRole !== 'comparison') {
+        throw new TypeError('Current-spend composition requires a current-spend or comparison coordinate.');
+    }
+    if (request.baselines.length === 0)
+        throw new TypeError('Current-spend composition requires an authoritative baseline member.');
+    const sortedBaselines = [...request.baselines].sort((left, right) => left.scopeId.localeCompare(right.scopeId));
+    if (new Set(sortedBaselines.map(baseline => baseline.scopeId)).size !== sortedBaselines.length) {
+        throw new TypeError('Current-spend composition cannot contain duplicate member scopes.');
+    }
+    const members = sortedBaselines.map(baseline => baseline.status === 'available'
+        ? { memberScopeId: baseline.scopeId, baselineId: baseline.baselineId, status: 'included' }
+        : { memberScopeId: baseline.scopeId, status: 'unavailable', reasonCode: baseline.unavailableReason });
+    const available = sortedBaselines.filter((baseline) => baseline.status === 'available');
+    const unavailableReasons = new Set(sortedBaselines
+        .filter((baseline) => baseline.status === 'unavailable')
+        .map(baseline => baseline.unavailableReason));
+    if (available.some(baseline => !(0, financialScopeBaseline_1.isCompleteFinancialBaselinePeriodV2)(baseline.period)))
+        unavailableReasons.add('coverage-incomplete');
+    if (request.coordinate.accountingCurrency.status === 'unresolved') {
+        unavailableReasons.add(request.coordinate.accountingCurrency.reasonCode);
+    }
+    const common = {
+        schemaVersion: financialDataflow_1.FINANCIAL_DATAFLOW_SCHEMA_VERSION_V1,
+        contractVersion: financialDataflow_1.FINANCIAL_CURRENT_SPEND_COMPOSITION_CONTRACT_VERSION_V1,
+        coordinate: request.coordinate,
+        members,
+        membershipDigest: (0, financialDataflowValidation_1.createCurrentSpendMembershipDigestV1)(members),
+        algorithmVersion: request.algorithmVersion ?? exports.CURRENT_SPEND_COMPOSITION_ALGORITHM_VERSION_V1,
+    };
+    const currency = request.coordinate.accountingCurrency.status === 'resolved' ? request.coordinate.accountingCurrency.currencyCode : undefined;
+    let identity;
+    if (!currency || available.length === 0) {
+        identity = {
+            ...common,
+            amount: {
+                status: 'unavailable',
+                reasonCodes: uniqueSorted(unavailableReasons.size > 0 ? unavailableReasons : ['evidence-unavailable']),
+            },
+        };
+    }
+    else {
+        const knownAmount = (0, exactDecimal_1.formatExactDecimalValue)((0, exactDecimal_1.sumCanonicalDecimals)(available.map(baseline => baseline.total.amount)));
+        identity =
+            unavailableReasons.size === 0
+                ? { ...common, amount: { status: 'available', amount: knownAmount, currencyCode: currency } }
+                : {
+                    ...common,
+                    amount: { status: 'partial', knownAmount, currencyCode: currency, reasonCodes: uniqueSorted(unavailableReasons) },
+                };
+    }
+    const composition = { ...identity, compositionId: (0, financialDataflowValidation_1.createCurrentSpendCompositionIdV1)(identity) };
+    if (!(0, financialDataflowValidation_1.isCurrentSpendCompositionCompatibleV1)(composition, sortedBaselines)) {
+        throw new TypeError('Current-spend composition does not reconcile to its authoritative baseline members.');
+    }
+    return composition;
+};
+exports.composeCurrentSpendV1 = composeCurrentSpendV1;
+//# sourceMappingURL=financialDataflowKernel.js.map

package/dist/azure/financialDataflowKernel.js.map

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

package/dist/azure/financialDataflowValidation.d.ts

@@ -0,0 +1,39 @@
+import { type CurrentSpendCompositionIdentityPreimageV1, type CurrentSpendCompositionMemberV1, type CurrentSpendCompositionV1, type FinancialDataflowCoordinateV1, type FinancialDataflowJsonGzipArtifactDescriptorV1, type FinancialDataflowPeriodV1, type FinancialDataflowScopeSelectorV1, type FinancialDataflowScopeV1 } from './financialDataflow';
+export type FinancialDataflowJsonRecordV1 = Record<string, unknown>;
+export declare const FINANCIAL_DATAFLOW_LIMITS_V1: {
+    readonly maximumIdentifierLength: 2048;
+    readonly maximumProviderAccounts: 256;
+    readonly maximumMembers: 20000;
+    readonly maximumReasonCodes: 64;
+    readonly maximumJsonBytes: 5242880;
+    readonly maximumJsonDepth: 64;
+    readonly maximumJsonNodes: 200000;
+};
+export declare const isFinancialDataflowRecordV1: (value: unknown) => value is FinancialDataflowJsonRecordV1;
+export declare const hasFinancialDataflowExactFieldsV1: (value: FinancialDataflowJsonRecordV1, required: readonly string[], optional?: readonly string[]) => boolean;
+/** Applies the same aggregate byte/node/depth envelope to already-parsed public validator inputs. */
+export declare const isFinancialDataflowValueWithinLimitsV1: (value: unknown) => boolean;
+export declare const isFinancialDataflowIdentityV1: (value: unknown) => value is string;
+export declare const isFinancialDataflowHashV1: (value: unknown) => value is string;
+export declare const isFinancialDataflowCurrencyV1: (value: unknown) => value is string;
+export declare const isFinancialDataflowIsoInstantV1: (value: unknown) => value is string;
+export declare const isFinancialDataflowJsonGzipArtifactDescriptorV1: (value: unknown) => value is FinancialDataflowJsonGzipArtifactDescriptorV1;
+export declare const isFinancialDataflowCalendarDateV1: (value: unknown) => value is string;
+export declare const isFinancialDataflowSortedUniqueStringsV1: (value: unknown, maximum: number, validate?: (entry: unknown) => entry is string) => value is string[];
+export declare const canonicalizeFinancialDataflowJsonV1: (value: unknown) => string;
+/** Parses bounded JSON while rejecting duplicate and prototype-sensitive object keys. */
+export declare const parseFinancialDataflowJsonV1: (text: string) => unknown;
+export declare const isFinancialDataflowScopeV1: (value: unknown) => value is FinancialDataflowScopeV1;
+export declare const isFinancialDataflowPeriodV1: (value: unknown) => value is FinancialDataflowPeriodV1;
+export declare const isFinancialDataflowScopeSelectorV1: (value: unknown) => value is FinancialDataflowScopeSelectorV1;
+export declare const isFinancialDataflowCoordinateV1: (value: unknown) => value is FinancialDataflowCoordinateV1;
+export declare const canonicalizeFinancialDataflowCoordinateV1: (value: FinancialDataflowCoordinateV1) => string;
+export declare const createFinancialDataflowCoordinateIdV1: (value: FinancialDataflowCoordinateV1) => string;
+export declare const canonicalizeCurrentSpendMembershipV1: (members: readonly CurrentSpendCompositionMemberV1[]) => string;
+export declare const createCurrentSpendMembershipDigestV1: (members: readonly CurrentSpendCompositionMemberV1[]) => string;
+export declare const canonicalizeCurrentSpendCompositionIdentityV1: (value: CurrentSpendCompositionIdentityPreimageV1) => string;
+export declare const createCurrentSpendCompositionIdV1: (value: CurrentSpendCompositionIdentityPreimageV1) => string;
+export declare const isCurrentSpendCompositionV1: (value: unknown) => value is CurrentSpendCompositionV1;
+/** Proves that composition membership and money reconcile to exact V2 baseline envelopes. */
+export declare const isCurrentSpendCompositionCompatibleV1: (composition: unknown, baselines: unknown) => boolean;
+//# sourceMappingURL=financialDataflowValidation.d.ts.map

package/dist/azure/financialDataflowValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"financialDataflowValidation.d.ts","sourceRoot":"","sources":["../../src/azure/financialDataflowValidation.ts"],"names":[],"mappings":"AAMA,OAAO,EAGL,KAAK,yCAAyC,EAC9C,KAAK,+BAA+B,EACpC,KAAK,yBAAyB,EAC9B,KAAK,6BAA6B,EAClC,KAAK,6CAA6C,EAClD,KAAK,yBAAyB,EAC9B,KAAK,gCAAgC,EACrC,KAAK,wBAAwB,EAC9B,MAAM,qBAAqB,CAAC;AAG7B,MAAM,MAAM,6BAA6B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpE,eAAO,MAAM,4BAA4B;;;;;;;;CAQ/B,CAAC;AAoDX,eAAO,MAAM,2BAA2B,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,6BAIrE,CAAC;AAEF,eAAO,MAAM,iCAAiC,GAC5C,OAAO,6BAA6B,EACpC,UAAU,SAAS,MAAM,EAAE,EAC3B,WAAU,SAAS,MAAM,EAAO,KAC/B,OAIF,CAAC;AAEF,qGAAqG;AACrG,eAAO,MAAM,sCAAsC,GAAI,OAAO,OAAO,KAAG,OAkDvE,CAAC;AAEF,eAAO,MAAM,6BAA6B,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MACyE,CAAC;AAElJ,eAAO,MAAM,yBAAyB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAA4D,CAAC;AAEjI,eAAO,MAAM,6BAA6B,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAA2D,CAAC;AAEpI,eAAO,MAAM,+BAA+B,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAC2D,CAAC;AAEtI,eAAO,MAAM,+CAA+C,GAC1D,OAAO,OAAO,KACb,KAAK,IAAI,6CAQsB,CAAC;AAEnC,eAAO,MAAM,iCAAiC,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAI3E,CAAC;AAEF,eAAO,MAAM,wCAAwC,GACnD,OAAO,OAAO,EACd,SAAS,MAAM,EACf,WAAU,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,MAAsC,KAC5E,KAAK,IAAI,MAAM,EAI8D,CAAC;AAEjF,eAAO,MAAM,mCAAmC,GAAI,OAAO,OAAO,KAAG,MAcpE,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,4BAA4B,GAAI,MAAM,MAAM,KAAG,OAwH3D,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,wBAMlB,CAAC;AAEpD,eAAO,MAAM,2BAA2B,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,yBAGH,CAAC;AAEpE,eAAO,MAAM,kCAAkC,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,gCA6C5E,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,6BAsCzE,CAAC;AAEF,eAAO,MAAM,yCAAyC,GAAI,OAAO,6BAA6B,KAAG,MAGhG,CAAC;AAEF,eAAO,MAAM,qCAAqC,GAAI,OAAO,6BAA6B,KAAG,MACnB,CAAC;AAqB3E,eAAO,MAAM,oCAAoC,GAAI,SAAS,SAAS,+BAA+B,EAAE,KAAG,MAU1G,CAAC;AAEF,eAAO,MAAM,oCAAoC,GAAI,SAAS,SAAS,+BAA+B,EAAE,KAAG,MACpC,CAAC;AA4DxE,eAAO,MAAM,6CAA6C,GAAI,OAAO,yCAAyC,KAAG,MAchH,CAAC;AAEF,eAAO,MAAM,iCAAiC,GAAI,OAAO,yCAAyC,KAAG,MACvB,CAAC;AAE/E,eAAO,MAAM,2BAA2B,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,yBAmBrE,CAAC;AAYF,6FAA6F;AAC7F,eAAO,MAAM,qCAAqC,GAAI,aAAa,OAAO,EAAE,WAAW,OAAO,KAAG,OAkEhG,CAAC"}