@spottoai/types-package 1.0.2-dev1138.1 → 1.0.2-dev1138.3

package/dist/azure/financialChargeCompositionValidation.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectFinancialChargesV1 = exports.isFinancialChargeInclusionPolicyRefV1 = exports.isFinancialChargeCompositionV1 = exports.createFinancialChargeCompositionIdV1 = exports.canonicalizeFinancialChargeCompositionIdentityV1 = void 0;
+const exactDecimal_1 = require("../common/exactDecimal");
+const sha256_1 = require("../common/sha256");
+const financialChargeComposition_1 = require("./financialChargeComposition");
+const financialDataflowValidation_1 = require("./financialDataflowValidation");
+const financialScopeBaselineValidation_1 = require("./financialScopeBaselineValidation");
+const financialValidationPrimitives_1 = require("./financialValidationPrimitives");
+const SOURCES = new Set(['azure-native', 'marketplace', 'unknown']);
+const RECURRENCES = new Set(['one-time', 'recurring', 'usage-based', 'unknown']);
+const CLASSIFICATIONS = new Set(['usage', 'purchase', 'adjustment', 'tax', 'credit', 'refund', 'residual']);
+const COST_BASES = new Set(['billed', 'amortized']);
+const ESTIMATE_LENSES = new Set(['actual-only', 'actual-plus-estimated', 'estimates-only']);
+const isSortedUniqueHashes = (value) => Array.isArray(value) && value.length > 0 && value.length <= 20000 && value.every(financialDataflowValidation_1.isFinancialDataflowHashV1) &&
+    value.every((entry, index) => index === 0 || value[index - 1] < entry);
+const isBucket = (value) => (0, financialDataflowValidation_1.isFinancialDataflowRecordV1)(value) &&
+    (0, financialDataflowValidation_1.hasFinancialDataflowExactFieldsV1)(value, [
+        'chargeSource',
+        'chargeRecurrence',
+        'chargeClassification',
+        'amount',
+        'componentIds',
+        'evidenceRefIds',
+    ]) &&
+    SOURCES.has(value.chargeSource) &&
+    RECURRENCES.has(value.chargeRecurrence) &&
+    CLASSIFICATIONS.has(value.chargeClassification) &&
+    (0, financialValidationPrimitives_1.isCanonicalExactMoney)({ amount: value.amount, currencyCode: 'AUD' }) &&
+    isSortedUniqueHashes(value.componentIds) &&
+    isSortedUniqueHashes(value.evidenceRefIds);
+const isIdentity = (value) => {
+    if (!(0, financialDataflowValidation_1.isFinancialDataflowRecordV1)(value) ||
+        !(0, financialDataflowValidation_1.hasFinancialDataflowExactFieldsV1)(value, [
+            'schemaVersion',
+            'contractVersion',
+            'baselineId',
+            'ownerScopeId',
+            'period',
+            'costBasis',
+            'estimateLens',
+            'accountingCurrencyCode',
+            'buckets',
+            'reconciliation',
+            'algorithmVersion',
+        ]) ||
+        value.schemaVersion !== financialChargeComposition_1.FINANCIAL_CHARGE_COMPOSITION_SCHEMA_VERSION_V1 ||
+        value.contractVersion !== financialChargeComposition_1.FINANCIAL_CHARGE_COMPOSITION_CONTRACT_VERSION_V1 ||
+        !(0, financialDataflowValidation_1.isFinancialDataflowHashV1)(value.baselineId) ||
+        !(0, financialDataflowValidation_1.isFinancialDataflowIdentityV1)(value.ownerScopeId) ||
+        !(0, financialScopeBaselineValidation_1.isFinancialBaselinePeriodV2)(value.period) ||
+        !COST_BASES.has(value.costBasis) ||
+        !ESTIMATE_LENSES.has(value.estimateLens) ||
+        !(0, financialDataflowValidation_1.isFinancialDataflowCurrencyV1)(value.accountingCurrencyCode) ||
+        !Array.isArray(value.buckets) ||
+        value.buckets.length === 0 ||
+        value.buckets.length > 20000 ||
+        !value.buckets.every(isBucket) ||
+        !(0, financialDataflowValidation_1.isFinancialDataflowIdentityV1)(value.algorithmVersion) ||
+        !(0, financialDataflowValidation_1.isFinancialDataflowRecordV1)(value.reconciliation) ||
+        !(0, financialDataflowValidation_1.hasFinancialDataflowExactFieldsV1)(value.reconciliation, ['status', 'bucketTotal', 'sourceTotal', 'difference']) ||
+        value.reconciliation.status !== 'reconciled' ||
+        value.reconciliation.difference !== '0' ||
+        !(0, financialValidationPrimitives_1.isCanonicalExactMoney)({ amount: value.reconciliation.bucketTotal, currencyCode: value.accountingCurrencyCode }) ||
+        !(0, financialValidationPrimitives_1.isCanonicalExactMoney)({ amount: value.reconciliation.sourceTotal, currencyCode: value.accountingCurrencyCode }))
+        return false;
+    const componentIds = value.buckets.flatMap(bucket => bucket.componentIds);
+    if (new Set(componentIds).size !== componentIds.length)
+        return false;
+    const keys = value.buckets.map(bucket => `${bucket.chargeSource}\u0000${bucket.chargeRecurrence}\u0000${bucket.chargeClassification}`);
+    if (!keys.every((key, index) => index === 0 || keys[index - 1] < key))
+        return false;
+    try {
+        const bucketTotal = (0, exactDecimal_1.formatExactDecimalValue)((0, exactDecimal_1.sumCanonicalDecimals)(value.buckets.map(bucket => bucket.amount)));
+        return bucketTotal === value.reconciliation.bucketTotal && bucketTotal === value.reconciliation.sourceTotal;
+    }
+    catch {
+        return false;
+    }
+};
+const canonicalizeFinancialChargeCompositionIdentityV1 = (value) => {
+    if (!(0, financialDataflowValidation_1.isFinancialDataflowValueWithinLimitsV1)(value) || !isIdentity(value)) {
+        throw new TypeError('Invalid FinancialChargeCompositionIdentityPreimageV1.');
+    }
+    return (0, financialDataflowValidation_1.canonicalizeFinancialDataflowJsonV1)(value);
+};
+exports.canonicalizeFinancialChargeCompositionIdentityV1 = canonicalizeFinancialChargeCompositionIdentityV1;
+const createFinancialChargeCompositionIdV1 = (value) => `sha256:${(0, sha256_1.sha256Utf8)((0, exports.canonicalizeFinancialChargeCompositionIdentityV1)(value))}`;
+exports.createFinancialChargeCompositionIdV1 = createFinancialChargeCompositionIdV1;
+const isFinancialChargeCompositionV1 = (value) => {
+    if (!(0, financialDataflowValidation_1.isFinancialDataflowValueWithinLimitsV1)(value) ||
+        !(0, financialDataflowValidation_1.isFinancialDataflowRecordV1)(value) ||
+        !(0, financialDataflowValidation_1.hasFinancialDataflowExactFieldsV1)(value, [
+            'chargeCompositionId',
+            'schemaVersion',
+            'contractVersion',
+            'baselineId',
+            'ownerScopeId',
+            'period',
+            'costBasis',
+            'estimateLens',
+            'accountingCurrencyCode',
+            'buckets',
+            'reconciliation',
+            'algorithmVersion',
+        ]))
+        return false;
+    const { chargeCompositionId, ...identity } = value;
+    return (0, financialDataflowValidation_1.isFinancialDataflowHashV1)(chargeCompositionId) && isIdentity(identity) &&
+        chargeCompositionId === (0, exports.createFinancialChargeCompositionIdV1)(identity);
+};
+exports.isFinancialChargeCompositionV1 = isFinancialChargeCompositionV1;
+const isFinancialChargeInclusionPolicyRefV1 = (value) => (0, financialDataflowValidation_1.isFinancialDataflowRecordV1)(value) &&
+    (0, financialDataflowValidation_1.hasFinancialDataflowExactFieldsV1)(value, ['policyId', 'policyDigest']) &&
+    (0, financialDataflowValidation_1.isFinancialDataflowIdentityV1)(value.policyId) &&
+    (0, financialDataflowValidation_1.isFinancialDataflowHashV1)(value.policyDigest) &&
+    (0, financialChargeComposition_1.resolveFinancialChargeInclusionPolicyV1)(value) !== undefined;
+exports.isFinancialChargeInclusionPolicyRefV1 = isFinancialChargeInclusionPolicyRefV1;
+const sumBuckets = (buckets) => (0, exactDecimal_1.formatExactDecimalValue)((0, exactDecimal_1.sumCanonicalDecimals)(buckets.map(bucket => bucket.amount)));
+const sourcesFor = (policy, role) => role === 'include' ? policy.includeSources : role === 'exclude' ? policy.excludeSources : policy.withholdSources;
+const selectFinancialChargesV1 = (composition, policyRef) => {
+    if (!(0, exports.isFinancialChargeCompositionV1)(composition))
+        throw new TypeError('Invalid financial charge composition.');
+    const policy = (0, financialChargeComposition_1.resolveFinancialChargeInclusionPolicyV1)(policyRef);
+    if (!policy)
+        throw new TypeError('Unregistered financial charge-inclusion policy.');
+    const partition = (role) => composition.buckets.filter(bucket => sourcesFor(policy, role).includes(bucket.chargeSource));
+    const included = partition('include');
+    const excluded = partition('exclude');
+    const withheld = partition('withhold');
+    if (included.length + excluded.length + withheld.length !== composition.buckets.length) {
+        throw new TypeError('Financial charge-inclusion policy does not partition every charge source.');
+    }
+    const includedAmount = sumBuckets(included);
+    const excludedAmount = sumBuckets(excluded);
+    const withheldAmount = sumBuckets(withheld);
+    const forecastEligibleAmount = sumBuckets(included.filter(bucket => bucket.chargeRecurrence === 'recurring' || bucket.chargeRecurrence === 'usage-based'));
+    const oneTimeAmount = sumBuckets(included.filter(bucket => bucket.chargeRecurrence === 'one-time'));
+    const unknownRecurrenceAmount = sumBuckets(included.filter(bucket => bucket.chargeRecurrence === 'unknown'));
+    const reasonCodes = [];
+    if (withheldAmount !== '0')
+        reasonCodes.push('charge-source-unknown');
+    const forecastReasonCodes = [...reasonCodes];
+    if (unknownRecurrenceAmount !== '0')
+        forecastReasonCodes.push('charge-recurrence-unknown');
+    const result = {
+        status: withheldAmount === '0' ? 'available' : 'partial',
+        includedAmount,
+        excludedAmount,
+        withheldAmount,
+        forecastEligibleAmount,
+        oneTimeAmount,
+        unknownRecurrenceAmount,
+        forecastStatus: withheldAmount === '0' && unknownRecurrenceAmount === '0' ? 'available' : 'partial',
+        currencyCode: composition.accountingCurrencyCode,
+        ...(reasonCodes.length === 0 ? {} : { reasonCodes: reasonCodes }),
+        ...(forecastReasonCodes.length === 0
+            ? {}
+            : { forecastReasonCodes: forecastReasonCodes }),
+    };
+    return result;
+};
+exports.selectFinancialChargesV1 = selectFinancialChargesV1;
+//# sourceMappingURL=financialChargeCompositionValidation.js.map

package/dist/azure/financialChargeCompositionValidation.js.map

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

package/dist/azure/financialDataflow.d.ts

@@ -1,15 +1,52 @@
 import type { CostBasis, FinancialEstimateLensV1 } from './costComposition';
-import type { FinancialBaselinePeriodV2 } from './financialScopeBaseline';
+import type { FinancialEvidenceIntervalV1 } from './financialScopeEvidence';
+import type { FinancialChargeInclusionPolicyRefV2, FinancialWindowKindV2 } from './financialScopeBaseline';
+import type { FinancialChargeSelectionV1 } from './financialChargeComposition';
 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;
@@ -25,16 +62,19 @@ export interface FinancialDataflowCoordinateV1 {
     providerAccountRefs: [string, ...string[]];
     scope: FinancialDataflowScopeV1;
     periodRole: FinancialDataflowPeriodRoleV1;
-    period: FinancialBaselinePeriodV2;
+    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;
+    /** Registered, digest-bound policy that changes current-spend and downstream result identity. */
+    chargeInclusionPolicyRef: FinancialChargeInclusionPolicyRefV2;
 }
 export interface IncludedCurrentSpendMemberV1 {
     memberScopeId: string;
     baselineId: string;
+    chargeCompositionId: string;
     status: 'included';
     reasonCode?: never;
 }
@@ -62,6 +102,7 @@ export interface AvailableCurrentSpendCompositionV1 extends CurrentSpendComposit
         knownAmount?: never;
         reasonCodes?: never;
     };
+    chargeSelection: FinancialChargeSelectionV1;
 }
 export interface PartialCurrentSpendCompositionV1 extends CurrentSpendCompositionCommonV1 {
     amount: {
@@ -71,6 +112,7 @@ export interface PartialCurrentSpendCompositionV1 extends CurrentSpendCompositio
         reasonCodes: [string, ...string[]];
         amount?: never;
     };
+    chargeSelection: FinancialChargeSelectionV1;
 }
 export interface UnavailableCurrentSpendCompositionV1 extends CurrentSpendCompositionCommonV1 {
     amount: {
@@ -80,6 +122,7 @@ export interface UnavailableCurrentSpendCompositionV1 extends CurrentSpendCompos
         knownAmount?: never;
         currencyCode?: never;
     };
+    chargeSelection?: never;
 }
 export type CurrentSpendCompositionV1 = AvailableCurrentSpendCompositionV1 | PartialCurrentSpendCompositionV1 | UnavailableCurrentSpendCompositionV1;
 export type CurrentSpendCompositionIdentityPreimageV1 = CurrentSpendCompositionV1 extends infer Composition ? Composition extends CurrentSpendCompositionV1 ? Omit<Composition, 'compositionId'> : never : never;

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

@@ -1 +1 @@
-{"version":3,"file":"financialDataflow.d.ts","sourceRoot":"","sources":["../../src/azure/financialDataflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAE1E,eAAO,MAAM,oCAAoC,EAAG,CAAU,CAAC;AAC/D,eAAO,MAAM,uDAAuD,EAAG,8BAAuC,CAAC;AAE/G,MAAM,MAAM,4BAA4B,GAAG,UAAU,GAAG,gBAAgB,GAAG,cAAc,GAAG,WAAW,GAAG,oBAAoB,CAAC;AAC/H,MAAM,MAAM,6BAA6B,GAAG,eAAe,GAAG,YAAY,GAAG,iBAAiB,GAAG,mBAAmB,CAAC;AAErH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,kCAAkC,GAC1C;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,qBAAqB,GAAG,sBAAsB,CAAC;IAAC,YAAY,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAE/G,uFAAuF;AACvF,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,mBAAmB,EAAE,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAC3C,KAAK,EAAE,wBAAwB,CAAC;IAChC,UAAU,EAAE,6BAA6B,CAAC;IAC1C,MAAM,EAAE,yBAAyB,CAAC;IAClC,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,uBAAuB,CAAC;IACtC,8HAA8H;IAC9H,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,EAAE,kCAAkC,CAAC;CACxD;AAED,MAAM,WAAW,4BAA4B;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,KAAK,CAAC;CACpB;AAED,MAAM,WAAW,+BAA+B;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,KAAK,CAAC;CACpB;AAED,MAAM,MAAM,+BAA+B,GAAG,4BAA4B,GAAG,+BAA+B,CAAC;AAE7G,UAAU,+BAA+B;IACvC,aAAa,EAAE,OAAO,oCAAoC,CAAC;IAC3D,eAAe,EAAE,OAAO,uDAAuD,CAAC;IAChF,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,6BAA6B,CAAC;IAC1C,OAAO,EAAE,+BAA+B,EAAE,CAAC;IAC3C,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kCAAmC,SAAQ,+BAA+B;IACzF,MAAM,EAAE;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,KAAK,CAAC;QAAC,WAAW,CAAC,EAAE,KAAK,CAAA;KAAE,CAAC;CACjH;AAED,MAAM,WAAW,gCAAiC,SAAQ,+BAA+B;IACvF,MAAM,EAAE;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,KAAK,CAAA;KAAE,CAAC;CAC9H;AAED,MAAM,WAAW,oCAAqC,SAAQ,+BAA+B;IAC3F,MAAM,EAAE;QACN,MAAM,EAAE,aAAa,CAAC;QACtB,WAAW,EAAE,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QACnC,MAAM,CAAC,EAAE,KAAK,CAAC;QACf,WAAW,CAAC,EAAE,KAAK,CAAC;QACpB,YAAY,CAAC,EAAE,KAAK,CAAC;KACtB,CAAC;CACH;AAED,MAAM,MAAM,yBAAyB,GAAG,kCAAkC,GAAG,gCAAgC,GAAG,oCAAoC,CAAC;AAErJ,MAAM,MAAM,yCAAyC,GAAG,yBAAyB,SAAS,MAAM,WAAW,GACvG,WAAW,SAAS,yBAAyB,GAC3C,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,GAClC,KAAK,GACP,KAAK,CAAC"}
+{"version":3,"file":"financialDataflow.d.ts","sourceRoot":"","sources":["../../src/azure/financialDataflow.ts"],"names":[],"mappings":"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"}

package/dist/azure/financialDataflow.js.map

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

package/dist/azure/financialDataflowKernel.d.ts

@@ -0,0 +1,31 @@
+import { type CurrentSpendCompositionV1, type FinancialDataflowCoordinateV1 } from './financialDataflow';
+import type { FinancialChargeCompositionV1 } from './financialChargeComposition';
+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[];
+    chargeCompositions: FinancialChargeCompositionV1[];
+    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;AAC7B,OAAO,KAAK,EAAE,4BAA4B,EAA8B,MAAM,8BAA8B,CAAC;AAO7G,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,kBAAkB,EAAE,4BAA4B,EAAE,CAAC;IACnD,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,yBAsHvF,CAAC"}

package/dist/azure/financialDataflowKernel.js

@@ -0,0 +1,169 @@
+"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 financialChargeCompositionValidation_1 = require("./financialChargeCompositionValidation");
+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.');
+    if (request.chargeCompositions.length > request.baselines.length) {
+        throw new TypeError('Current-spend composition has more charge compositions than baseline members.');
+    }
+    const chargeCompositionByBaselineId = new Map(request.chargeCompositions.map(composition => [composition.baselineId, composition]));
+    if (chargeCompositionByBaselineId.size !== request.chargeCompositions.length) {
+        throw new TypeError('Current-spend composition cannot contain duplicate charge compositions.');
+    }
+    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 selections = new Map();
+    const members = sortedBaselines.map(baseline => {
+        if (baseline.status === 'unavailable') {
+            return { memberScopeId: baseline.scopeId, status: 'unavailable', reasonCode: baseline.unavailableReason };
+        }
+        if (baseline.baselineKind !== 'owner') {
+            return { memberScopeId: baseline.scopeId, status: 'unavailable', reasonCode: 'charge-composition-requires-owner-baseline' };
+        }
+        const chargeComposition = chargeCompositionByBaselineId.get(baseline.baselineId);
+        if (!chargeComposition || chargeComposition.ownerScopeId !== baseline.scopeId) {
+            return { memberScopeId: baseline.scopeId, status: 'unavailable', reasonCode: 'charge-composition-unavailable' };
+        }
+        const selection = (0, financialChargeCompositionValidation_1.selectFinancialChargesV1)(chargeComposition, request.coordinate.chargeInclusionPolicyRef);
+        selections.set(baseline.baselineId, selection);
+        return {
+            memberScopeId: baseline.scopeId,
+            baselineId: baseline.baselineId,
+            chargeCompositionId: chargeComposition.chargeCompositionId,
+            status: 'included',
+        };
+    });
+    const available = sortedBaselines.filter((baseline) => baseline.status === 'available');
+    const includedBaselines = available.filter(baseline => members.some(member => member.status === 'included' && member.baselineId === baseline.baselineId));
+    const unavailableReasons = new Set(sortedBaselines
+        .filter((baseline) => baseline.status === 'unavailable')
+        .map(baseline => baseline.unavailableReason));
+    members.filter(member => member.status === 'unavailable').forEach(member => unavailableReasons.add(member.reasonCode));
+    const selectionReasonCodes = new Set();
+    selections.forEach(selection => selection.reasonCodes?.forEach(reason => {
+        selectionReasonCodes.add(reason);
+        unavailableReasons.add(reason);
+    }));
+    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 || includedBaselines.length === 0) {
+        identity = {
+            ...common,
+            amount: {
+                status: 'unavailable',
+                reasonCodes: uniqueSorted(unavailableReasons.size > 0 ? unavailableReasons : ['evidence-unavailable']),
+            },
+        };
+    }
+    else {
+        const includedSelections = members.flatMap(member => member.status === 'included' ? [selections.get(member.baselineId)] : []);
+        const aggregateSelection = {
+            status: includedSelections.some(selection => selection.status === 'partial') ? 'partial' : 'available',
+            includedAmount: (0, exactDecimal_1.formatExactDecimalValue)((0, exactDecimal_1.sumCanonicalDecimals)(includedSelections.map(selection => selection.includedAmount))),
+            excludedAmount: (0, exactDecimal_1.formatExactDecimalValue)((0, exactDecimal_1.sumCanonicalDecimals)(includedSelections.map(selection => selection.excludedAmount))),
+            withheldAmount: (0, exactDecimal_1.formatExactDecimalValue)((0, exactDecimal_1.sumCanonicalDecimals)(includedSelections.map(selection => selection.withheldAmount))),
+            forecastEligibleAmount: (0, exactDecimal_1.formatExactDecimalValue)((0, exactDecimal_1.sumCanonicalDecimals)(includedSelections.map(selection => selection.forecastEligibleAmount))),
+            oneTimeAmount: (0, exactDecimal_1.formatExactDecimalValue)((0, exactDecimal_1.sumCanonicalDecimals)(includedSelections.map(selection => selection.oneTimeAmount))),
+            unknownRecurrenceAmount: (0, exactDecimal_1.formatExactDecimalValue)((0, exactDecimal_1.sumCanonicalDecimals)(includedSelections.map(selection => selection.unknownRecurrenceAmount))),
+            forecastStatus: includedSelections.some(selection => selection.forecastStatus === 'partial') ? 'partial' : 'available',
+            currencyCode: currency,
+            ...(selectionReasonCodes.size === 0 ? {} : { reasonCodes: uniqueSorted(selectionReasonCodes) }),
+            ...(includedSelections.every(selection => selection.forecastReasonCodes === undefined)
+                ? {}
+                : {
+                    forecastReasonCodes: uniqueSorted(includedSelections.flatMap(selection => selection.forecastReasonCodes ?? [])),
+                }),
+        };
+        const knownAmount = aggregateSelection.includedAmount;
+        identity =
+            unavailableReasons.size === 0
+                ? { ...common, amount: { status: 'available', amount: knownAmount, currencyCode: currency }, chargeSelection: aggregateSelection }
+                : {
+                    ...common,
+                    amount: { status: 'partial', knownAmount, currencyCode: currency, reasonCodes: uniqueSorted(unavailableReasons) },
+                    chargeSelection: aggregateSelection,
+                };
+    }
+    const composition = { ...identity, compositionId: (0, financialDataflowValidation_1.createCurrentSpendCompositionIdV1)(identity) };
+    if (!(0, financialDataflowValidation_1.isCurrentSpendCompositionCompatibleV1)(composition, sortedBaselines, request.chargeCompositions)) {
+        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

@@ -1,4 +1,4 @@
-import { type CurrentSpendCompositionIdentityPreimageV1, type CurrentSpendCompositionMemberV1, type CurrentSpendCompositionV1, type FinancialDataflowCoordinateV1, type FinancialDataflowScopeV1 } from './financialDataflow';
+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;
@@ -17,12 +17,15 @@ export declare const isFinancialDataflowIdentityV1: (value: unknown) => value is
 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;
@@ -32,5 +35,5 @@ export declare const canonicalizeCurrentSpendCompositionIdentityV1: (value: Curr
 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;
+export declare const isCurrentSpendCompositionCompatibleV1: (composition: unknown, baselines: unknown, chargeCompositions: unknown) => boolean;
 //# sourceMappingURL=financialDataflowValidation.d.ts.map

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

@@ -1 +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,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,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,+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,OA+DhG,CAAC"}
+{"version":3,"file":"financialDataflowValidation.d.ts","sourceRoot":"","sources":["../../src/azure/financialDataflowValidation.ts"],"names":[],"mappings":"AAaA,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,6BAsDzE,CAAC;AAEF,eAAO,MAAM,yCAAyC,GAAI,OAAO,6BAA6B,KAAG,MAGhG,CAAC;AAEF,eAAO,MAAM,qCAAqC,GAAI,OAAO,6BAA6B,KAAG,MACnB,CAAC;AAyB3E,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;AAuGxE,eAAO,MAAM,6CAA6C,GAAI,OAAO,yCAAyC,KAAG,MA2BhH,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,GAChD,aAAa,OAAO,EACpB,WAAW,OAAO,EAClB,oBAAoB,OAAO,KAC1B,OAqHF,CAAC"}