@zhin.js/workroom 0.0.0 → 0.0.2

package/lib/portfolio/file-capacity-control-outbox.js

@@ -0,0 +1,113 @@
+import { createHash } from 'node:crypto';
+import { readFile, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { DurableFileStore } from '../workroom/durable-file-store.js';
+import { createPortfolioControlOutboxEvent, replayPortfolioControlOutbox, } from './capacity-control-outbox.js';
+import { canonicalWorkroomJson, deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue as digest, } from '../workroom/canonical-value.js';
+export class FilePortfolioControlOutboxRepository {
+    directory;
+    #store;
+    constructor(directory) {
+        this.directory = directory;
+        this.#store = new DurableFileStore(directory);
+    }
+    async listPortfolioIds() {
+        let names;
+        try {
+            names = (await readdir(this.directory)).filter(name => name.endsWith('.json')).sort();
+        }
+        catch (error) {
+            if (hasCode(error, 'ENOENT'))
+                return Object.freeze([]);
+            throw error;
+        }
+        const ids = new Set();
+        for (const name of names) {
+            const value = JSON.parse(await readFile(join(this.directory, name), 'utf8'));
+            if (typeof value.portfolioId !== 'string' || !value.portfolioId.trim()) {
+                throw new Error('Portfolio Control Outbox segment has no Portfolio identity');
+            }
+            ids.add(value.portfolioId);
+        }
+        for (const portfolioId of ids)
+            await this.read(portfolioId);
+        return Object.freeze([...ids].sort());
+    }
+    async read(portfolioId) {
+        const prefix = filePrefix(portfolioId);
+        let names;
+        try {
+            names = (await readdir(this.directory)).filter(name => name.startsWith(prefix)).sort();
+        }
+        catch (error) {
+            if (hasCode(error, 'ENOENT'))
+                return Object.freeze([]);
+            throw error;
+        }
+        const events = [];
+        for (const [sequence, name] of names.entries()) {
+            if (name !== fileName(portfolioId, sequence))
+                throw new Error('Portfolio Control Outbox segment gap');
+            events.push(parseSegment(await readFile(join(this.directory, name), 'utf8'), portfolioId, sequence).event);
+        }
+        replayPortfolioControlOutbox(portfolioId, events);
+        if (events.length)
+            await this.#store.syncLeaf();
+        return Object.freeze(events);
+    }
+    async append(portfolioId, expectedSequence, draft) {
+        const current = await this.read(portfolioId);
+        if (current.length - 1 !== expectedSequence)
+            throw new Error('Portfolio Control Outbox sequence conflict');
+        const event = createPortfolioControlOutboxEvent(portfolioId, expectedSequence + 1, draft);
+        replayPortfolioControlOutbox(portfolioId, [...current, event]);
+        const body = deepFreeze({
+            version: 1, portfolioId, expectedSequence, event,
+        });
+        const segment = deepFreeze({ ...body, digest: digest(body) });
+        await this.#store.ensureDurableLeaf('Portfolio Control Outbox');
+        const target = join(this.directory, fileName(portfolioId, event.sequence));
+        const result = await this.#store.publishCreateOnly({
+            target, content: canonicalWorkroomJson(segment), createdValue: segment,
+            onConflict: async () => {
+                const existing = parseSegment(await readFile(target, 'utf8'), portfolioId, event.sequence);
+                if (canonicalWorkroomJson(existing) !== canonicalWorkroomJson(segment)) {
+                    throw new Error('Portfolio Control Outbox sequence conflict');
+                }
+                return existing;
+            },
+        });
+        return result.value.event;
+    }
+}
+function parseSegment(serialized, portfolioId, sequence) {
+    const value = JSON.parse(serialized);
+    if (value.version !== 1 || value.portfolioId !== portfolioId
+        || value.expectedSequence !== sequence - 1 || value.event.sequence !== sequence) {
+        throw new Error('Portfolio Control Outbox segment binding drift');
+    }
+    const canonicalEvent = createPortfolioControlOutboxEvent(portfolioId, sequence, {
+        type: value.event.type,
+        payload: value.event.payload,
+    });
+    if (canonicalWorkroomJson(canonicalEvent) !== canonicalWorkroomJson(value.event)) {
+        throw new Error('Portfolio Control Outbox event drift');
+    }
+    const body = deepFreeze({ version: 1, portfolioId, expectedSequence: sequence - 1, event: value.event });
+    const canonical = deepFreeze({ ...body, digest: digest(body) });
+    if (canonicalWorkroomJson(value) !== canonicalWorkroomJson(canonical)) {
+        throw new Error('Portfolio Control Outbox segment digest drift');
+    }
+    return canonical;
+}
+function filePrefix(portfolioId) {
+    return `portfolio-control-${createHash('sha256').update(portfolioId).digest('hex')}-`;
+}
+function fileName(portfolioId, sequence) {
+    return `${filePrefix(portfolioId)}${String(sequence).padStart(16, '0')}.json`;
+}
+function hasCode(error, code) {
+    return Boolean(error && typeof error === 'object' && 'code' in error
+        && error.code === code);
+}
+//# sourceMappingURL=file-capacity-control-outbox.js.map

package/lib/portfolio/file-capacity-control-outbox.js.map

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

package/lib/portfolio/file-portfolio-journal.d.ts

@@ -0,0 +1,11 @@
+import { type PortfolioFact, type PortfolioFactDraft, type PortfolioJournalRepository } from './portfolio-journal.js';
+/** Crash-durable immutable-segment adapter for the Portfolio Journal contract. */
+export declare class FilePortfolioJournalRepository implements PortfolioJournalRepository {
+    #private;
+    readonly directory: string;
+    constructor(directory: string);
+    listPortfolioIds(): Promise<readonly string[]>;
+    read(portfolioId: string): Promise<readonly PortfolioFact[]>;
+    append(portfolioId: string, expectedSequence: number, drafts: readonly PortfolioFactDraft[]): Promise<readonly PortfolioFact[]>;
+}
+//# sourceMappingURL=file-portfolio-journal.d.ts.map

package/lib/portfolio/file-portfolio-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-portfolio-journal.d.ts","sourceRoot":"","sources":["../../src/portfolio/file-portfolio-journal.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAChC,MAAM,wBAAwB,CAAC;AAmBhC,kFAAkF;AAClF,qBAAa,8BAA+B,YAAW,0BAA0B;;IAGnE,QAAQ,CAAC,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;IAIhC,gBAAgB,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC;IAsB9C,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC;IAuC5D,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,SAAS,kBAAkB,EAAE,GACpC,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC;CA4BrC"}

package/lib/portfolio/file-portfolio-journal.js

@@ -0,0 +1,196 @@
+import { createHash } from 'node:crypto';
+import { readFile, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { InMemoryPortfolioJournalRepository, parsePortfolioFactDraft, } from './portfolio-journal.js';
+import { canonicalWorkroomJson, deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue as digest, } from '../workroom/canonical-value.js';
+import { DurableFileStore } from '../workroom/durable-file-store.js';
+/** Crash-durable immutable-segment adapter for the Portfolio Journal contract. */
+export class FilePortfolioJournalRepository {
+    directory;
+    #store;
+    constructor(directory) {
+        this.directory = directory;
+        this.#store = new DurableFileStore(directory);
+    }
+    async listPortfolioIds() {
+        let names;
+        try {
+            names = await readdir(this.directory);
+        }
+        catch (error) {
+            if (hasCode(error, 'ENOENT'))
+                return Object.freeze([]);
+            throw error;
+        }
+        if (names.some(name => name.endsWith('.json') && !isSegmentName(name))) {
+            throw new Error('Invalid Portfolio Journal segment name');
+        }
+        const ids = new Set();
+        for (const name of names.filter(isSegmentName).sort()) {
+            ids.add((await parseSegment(await readFile(join(this.directory, name), 'utf8'), name)).portfolioId);
+        }
+        if (ids.size > 0)
+            await this.#store.syncLeaf();
+        return Object.freeze([...ids].sort());
+    }
+    async read(portfolioId) {
+        const id = identifier(portfolioId, 'portfolioId');
+        const prefix = `${hashId(id)}.`;
+        let names;
+        try {
+            names = await readdir(this.directory);
+        }
+        catch (error) {
+            if (hasCode(error, 'ENOENT'))
+                return Object.freeze([]);
+            throw error;
+        }
+        const candidates = names.filter(name => name.startsWith(prefix) && name.endsWith('.json'));
+        if (candidates.some(name => !isSegmentName(name))) {
+            throw new Error('Invalid Portfolio Journal segment name');
+        }
+        const segments = await Promise.all(candidates.sort().map(async (name) => await parseSegment(await readFile(join(this.directory, name), 'utf8'), name)));
+        if (segments.some(segment => segment.portfolioId !== id)) {
+            throw new Error('Portfolio Journal identifier digest collision');
+        }
+        const validator = new InMemoryPortfolioJournalRepository();
+        const events = [];
+        for (const segment of segments) {
+            if (segment.expectedSequence !== events.length - 1) {
+                throw new Error('Portfolio Journal segment sequence is not contiguous');
+            }
+            const appended = await validator.append(id, segment.expectedSequence, segment.events.map(toDraft));
+            if (canonicalWorkroomJson(appended) !== canonicalWorkroomJson(segment.events)) {
+                throw new Error('Portfolio Journal segment replay drift');
+            }
+            events.push(...appended);
+        }
+        if (events.length > 0)
+            await this.#store.syncLeaf();
+        return deepFreeze(events);
+    }
+    async append(portfolioId, expectedSequence, drafts) {
+        const id = identifier(portfolioId, 'portfolioId');
+        const current = await this.read(id);
+        const validator = await seed(id, current);
+        const appended = await validator.append(id, expectedSequence, drafts);
+        if (appended.length === 0 || appended.every(event => event.sequence <= (current.at(-1)?.sequence ?? -1))) {
+            return appended;
+        }
+        const payload = deepFreeze({
+            version: 1,
+            portfolioId: id,
+            expectedSequence,
+            events: appended,
+        });
+        const segment = deepFreeze({ ...payload, payloadDigest: digest(payload) });
+        await this.#store.ensureDurableLeaf('Portfolio Journal');
+        const target = join(this.directory, segmentName(id, appended[0].sequence));
+        const published = await this.#store.publishCreateOnly({
+            target,
+            content: canonicalWorkroomJson(segment),
+            createdValue: appended,
+            onConflict: async () => {
+                const winner = await this.read(id);
+                return await (await seed(id, winner)).append(id, expectedSequence, drafts);
+            },
+        });
+        return published.value;
+    }
+}
+async function seed(portfolioId, events) {
+    const repository = new InMemoryPortfolioJournalRepository();
+    for (const event of events) {
+        await repository.append(portfolioId, event.sequence - 1, [toDraft(event)]);
+    }
+    return repository;
+}
+function toDraft(event) {
+    return deepFreeze({
+        eventId: event.eventId,
+        occurredAt: event.occurredAt,
+        type: event.type,
+        payload: event.payload,
+    });
+}
+async function parseSegment(serialized, name) {
+    let value;
+    try {
+        value = JSON.parse(serialized);
+    }
+    catch (error) {
+        throw new Error('Portfolio Journal segment is not valid JSON', { cause: error });
+    }
+    if (!isRecord(value) || value.version !== 1 || typeof value.portfolioId !== 'string'
+        || !Number.isSafeInteger(value.expectedSequence) || Number(value.expectedSequence) < -1
+        || !Array.isArray(value.events) || value.events.length === 0
+        || typeof value.payloadDigest !== 'string') {
+        throw new Error('Invalid Portfolio Journal segment');
+    }
+    const segment = value;
+    const expectedSequence = Number(value.expectedSequence);
+    const events = normalizeSegmentEvents(value.events, value.portfolioId, expectedSequence);
+    const payload = {
+        version: 1,
+        portfolioId: identifier(segment.portfolioId, 'portfolioId'),
+        expectedSequence,
+        events,
+    };
+    if (segment.payloadDigest !== digest(payload)) {
+        throw new Error('Portfolio Journal segment payload digest mismatch');
+    }
+    if (name !== segmentName(payload.portfolioId, payload.expectedSequence + 1)) {
+        throw new Error('Portfolio Journal segment first sequence does not match its filename');
+    }
+    return deepFreeze({ ...payload, payloadDigest: segment.payloadDigest });
+}
+function normalizeSegmentEvents(values, portfolioId, expectedSequence) {
+    return deepFreeze(values.map((value, index) => {
+        if (!isRecord(value) || value.version !== 1 || value.portfolioId !== portfolioId
+            || value.sequence !== expectedSequence + index + 1
+            || typeof value.eventId !== 'string' || !value.eventId.trim()
+            || typeof value.occurredAt !== 'number' || !Number.isFinite(value.occurredAt)
+            || typeof value.type !== 'string' || !isRecord(value.payload)) {
+            throw new Error('Invalid Portfolio Journal segment event');
+        }
+        const draft = parsePortfolioFactDraft({
+            eventId: value.eventId,
+            occurredAt: value.occurredAt,
+            type: value.type,
+            payload: value.payload,
+        });
+        const normalized = deepFreeze({
+            version: 1,
+            portfolioId,
+            sequence: value.sequence,
+            ...draft,
+        });
+        if (canonicalWorkroomJson(normalized) !== canonicalWorkroomJson(value)) {
+            throw new Error('Portfolio Journal segment event materialization drift');
+        }
+        return normalized;
+    }));
+}
+function segmentName(portfolioId, firstSequence) {
+    return `${hashId(portfolioId)}.${String(firstSequence).padStart(16, '0')}.json`;
+}
+function hashId(value) {
+    return createHash('sha256').update(value).digest('hex');
+}
+function isSegmentName(name) {
+    return /^[a-f0-9]{64}\.[0-9]{16}\.json$/u.test(name);
+}
+function identifier(value, label) {
+    if (typeof value !== 'string' || !value.trim() || value !== value.trim()) {
+        throw new Error(`Invalid Portfolio ${label}`);
+    }
+    return value;
+}
+function isRecord(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+function hasCode(error, code) {
+    return Boolean(error && typeof error === 'object' && 'code' in error
+        && error.code === code);
+}
+//# sourceMappingURL=file-portfolio-journal.js.map

package/lib/portfolio/file-portfolio-journal.js.map

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

package/lib/portfolio/portfolio-admission.d.ts

@@ -0,0 +1,95 @@
+import { type PortfolioCapacityGrant, type PortfolioCapacityReclaim, type PortfolioCapacityRequest, type PortfolioFact, type PortfolioGovernanceProof, type PortfolioGrantAssignmentFailureReason, type PortfolioJournalRepository, type PortfolioKernelCommandAuthority, type PortfolioPolicySnapshot, type PortfolioPriorityOverride, type PortfolioProjectPolicy, type PortfolioClockAuthority, type PortfolioUsageGatewayAuthority, type PortfolioValidatedBundleAuthority } from './portfolio-journal.js';
+export interface PortfolioRequestState {
+    readonly request: PortfolioCapacityRequest;
+    readonly bundleAuthority: PortfolioValidatedBundleAuthority;
+    readonly requestedAt: number;
+    readonly requestedSequence: number;
+}
+export interface PortfolioAdmissionState {
+    readonly portfolioId: string;
+    readonly sequence: number;
+    readonly now: number;
+    readonly clockSequence: number;
+    readonly clockDigest?: string;
+    readonly usageSettlementCursor: number;
+    readonly policy?: PortfolioPolicySnapshot;
+    readonly requests: Readonly<Record<string, PortfolioRequestState>>;
+    readonly grants: Readonly<Record<string, PortfolioCapacityGrant>>;
+    readonly reclaims: Readonly<Record<string, PortfolioCapacityReclaim>>;
+    readonly overrides: Readonly<Record<string, PortfolioPriorityOverride>>;
+    readonly normalizedService: Readonly<Record<string, number>>;
+    readonly normalizedAtSequence: number;
+}
+export interface PortfolioAdmissionApplicationOptions {
+    readonly portfolioId: string;
+    readonly repository: PortfolioJournalRepository;
+    readonly ids: Readonly<{
+        eventId(type: PortfolioFact['type'], identity: string): string;
+    }>;
+    readonly maxCasAttempts?: number;
+}
+/** Journal-backed Portfolio resource authority. It never writes Workroom facts. */
+export declare class PortfolioAdmissionApplication {
+    #private;
+    readonly options: PortfolioAdmissionApplicationOptions;
+    constructor(options: PortfolioAdmissionApplicationOptions);
+    read(): Promise<PortfolioAdmissionState>;
+    pinPolicy(policy: PortfolioPolicySnapshot, governance: PortfolioGovernanceProof): Promise<void>;
+    updateProjectPolicy(policy: PortfolioProjectPolicy, governance: PortfolioGovernanceProof): Promise<void>;
+    updateProjectPolicies(policies: readonly PortfolioProjectPolicy[], governance: Readonly<Record<string, PortfolioGovernanceProof>>): Promise<void>;
+    setPriorityOverride(override: PortfolioPriorityOverride, governance: PortfolioGovernanceProof): Promise<void>;
+    submit(request: PortfolioCapacityRequest, bundleAuthority: PortfolioValidatedBundleAuthority): Promise<void>;
+    decideAdmission(): Promise<PortfolioCapacityGrant | null>;
+    consume(input: Readonly<{
+        grantId: string;
+        projectId: string;
+        fence: number;
+        assignmentRef: string;
+    }>, authority: PortfolioKernelCommandAuthority): Promise<void>;
+    failAssignment(input: Readonly<{
+        grantId: string;
+        projectId: string;
+        fence: number;
+        assignmentRef: string;
+        reason: PortfolioGrantAssignmentFailureReason;
+        kernelSequence: number;
+        kernelFactDigest: string;
+    }>, authority: PortfolioKernelCommandAuthority): Promise<void>;
+    renewLease(input: Readonly<{
+        grantId: string;
+        projectId: string;
+        fence: number;
+        assignmentRef: string;
+        heartbeatSequence: number;
+    }>, authority: PortfolioKernelCommandAuthority): Promise<void>;
+    acknowledgeReclaim(input: Readonly<{
+        reclaimId: string;
+        projectId: string;
+        fence: number;
+        outcome: 'checkpointed' | 'declined';
+        checkpointRef?: string;
+        checkpointDigest?: string;
+    }>, authority: PortfolioKernelCommandAuthority): Promise<void>;
+    settleUsage(authority: PortfolioUsageGatewayAuthority): Promise<void>;
+    advanceClock(authority: PortfolioClockAuthority): Promise<void>;
+    normalizeService(divisor: number): Promise<void>;
+}
+export declare function replayPortfolioAdmission(portfolioId: string, facts: readonly PortfolioFact[]): PortfolioAdmissionState;
+export declare function portfolioRequestStatus(state: PortfolioAdmissionState, requestId: string): 'pending' | 'granted' | 'usage_blocked' | 'settled';
+export declare function portfolioProjectBudget(state: PortfolioAdmissionState, projectId: string): {
+    limitMicros: number;
+    spentMicros: number;
+    reservedMicros: number;
+    availableMicros: number;
+};
+export declare function portfolioRequestBlockers(state: PortfolioAdmissionState, requestId: string): readonly string[];
+export declare function portfolioCapacityRequestDigest(request: PortfolioCapacityRequest): string;
+export declare function portfolioValidatedBundleDigest(authority: Omit<PortfolioValidatedBundleAuthority, 'validatedBundleDigest'> | PortfolioValidatedBundleAuthority): string;
+type KernelAuthorityClaims = Omit<PortfolioKernelCommandAuthority, 'commandDigest' | 'authorizedBy'>;
+type UsageAuthorityClaims = Omit<PortfolioUsageGatewayAuthority, 'receiptDigest' | 'authenticatedBy'>;
+type ClockAuthorityClaims = Omit<PortfolioClockAuthority, 'clockDigest' | 'authorizedBy'>;
+export declare function portfolioKernelCommandDigest(claims: KernelAuthorityClaims): string;
+export declare function portfolioUsageReceiptDigest(claims: UsageAuthorityClaims): string;
+export declare function portfolioClockDigest(claims: ClockAuthorityClaims): string;
+export {};
+//# sourceMappingURL=portfolio-admission.d.ts.map

package/lib/portfolio/portfolio-admission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portfolio-admission.d.ts","sourceRoot":"","sources":["../../src/portfolio/portfolio-admission.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,aAAa,EAElB,KAAK,wBAAwB,EAC7B,KAAK,qCAAqC,EAC1C,KAAK,0BAA0B,EAC/B,KAAK,+BAA+B,EAEpC,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACnC,KAAK,iCAAiC,EACvC,MAAM,wBAAwB,CAAC;AAQhC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,iCAAiC,CAAC;IAC5D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC;IACnE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC;IAClE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAAC;IACtE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC,CAAC;IACxE,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7D,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,0BAA0B,CAAC;IAChD,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;QAAE,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3F,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAYD,mFAAmF;AACnF,qBAAa,6BAA6B;;IAG5B,QAAQ,CAAC,OAAO,EAAE,oCAAoC;gBAA7C,OAAO,EAAE,oCAAoC;IAI5D,IAAI,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAMxC,SAAS,CAAC,MAAM,EAAE,uBAAuB,EAAE,UAAU,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/F,mBAAmB,CACvB,MAAM,EAAE,sBAAsB,EAC9B,UAAU,EAAE,wBAAwB,GACnC,OAAO,CAAC,IAAI,CAAC;IAIV,qBAAqB,CACzB,QAAQ,EAAE,SAAS,sBAAsB,EAAE,EAC3C,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC,GAC7D,OAAO,CAAC,IAAI,CAAC;IA6BV,mBAAmB,CACvB,QAAQ,EAAE,yBAAyB,EACnC,UAAU,EAAE,wBAAwB,GACnC,OAAO,CAAC,IAAI,CAAC;IA0BV,MAAM,CACV,OAAO,EAAE,wBAAwB,EACjC,eAAe,EAAE,iCAAiC,GACjD,OAAO,CAAC,IAAI,CAAC;IA8BV,eAAe,IAAI,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAmBzD,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;QAC5B,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;KAC1E,CAAC,EAAE,SAAS,EAAE,+BAA+B,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BxD,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC;QACnC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QACzE,MAAM,EAAE,qCAAqC,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC;KACjG,CAAC,EAAE,SAAS,EAAE,+BAA+B,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BxD,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC;QAC/B,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAC;KACrG,CAAC,EAAE,SAAS,EAAE,+BAA+B,GAAG,OAAO,CAAC,IAAI,CAAC;IA8DxD,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC;QACvC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QACpD,OAAO,EAAE,cAAc,GAAG,UAAU,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;KACzF,CAAC,EAAE,SAAS,EAAE,+BAA+B,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CxD,WAAW,CAAC,SAAS,EAAE,8BAA8B,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BrE,YAAY,CAAC,SAAS,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B/D,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA4CvD;AAED,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,SAAS,aAAa,EAAE,GAC9B,uBAAuB,CAczB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,uBAAuB,EAC9B,SAAS,EAAE,MAAM,GAChB,SAAS,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,CAYrD;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM;;;;;EAcvF;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,uBAAuB,EAC9B,SAAS,EAAE,MAAM,GAChB,SAAS,MAAM,EAAE,CAEnB;AAqeD,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CAExF;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,IAAI,CAAC,iCAAiC,EAAE,uBAAuB,CAAC,GAAG,iCAAiC,GAC9G,MAAM,CAGR;AA0BD,KAAK,qBAAqB,GAAG,IAAI,CAAC,+BAA+B,EAAE,eAAe,GAAG,cAAc,CAAC,CAAC;AACrG,KAAK,oBAAoB,GAAG,IAAI,CAAC,8BAA8B,EAAE,eAAe,GAAG,iBAAiB,CAAC,CAAC;AACtG,KAAK,oBAAoB,GAAG,IAAI,CAAC,uBAAuB,EAAE,aAAa,GAAG,cAAc,CAAC,CAAC;AAE1F,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAElF;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAEhF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAEzE"}