@gridlock/orchestrator 0.1.0

package/dist/investigation/FactLedger.js

@@ -0,0 +1,185 @@
+/**
+ * Investigation Layer — Fact Ledger
+ *
+ * The Fact Ledger is the structured investigation memory for a single run.
+ * It stores FactRecords derived from evidence-layer outputs (artifacts,
+ * dialogue, validator findings) and organizes them for player-facing tools.
+ *
+ * Architectural boundary:
+ * - The Evidence Layer (Facts, Validators, Findings) produces truth.
+ * - The Fact Ledger records and organizes that truth.
+ * - The Fact Ledger never modifies validator outcomes or evidence-layer state.
+ */
+export class FactLedger {
+    records = [];
+    /**
+     * Add a new FactRecord to the ledger.
+     * Duplicates are detected by (sourceType + sourceId + subject + statement).
+     * Returns true if the record was added, false if it was a duplicate.
+     */
+    add(record) {
+        if (this._isDuplicate(record)) {
+            return false;
+        }
+        this.records.push(record);
+        return true;
+    }
+    /**
+     * Retrieve a record by its unique id.
+     */
+    getById(id) {
+        return this.records.find(r => r.id === id);
+    }
+    /**
+     * Retrieve all records for a given subject.
+     */
+    getBySubject(subject) {
+        return this.records.filter(r => r.subject === subject);
+    }
+    /**
+     * Retrieve all records with a given status.
+     */
+    getByStatus(status) {
+        return this.records.filter(r => r.status === status);
+    }
+    /**
+     * Retrieve all records from a given source type.
+     */
+    getBySourceType(sourceType) {
+        return this.records.filter(r => r.sourceType === sourceType);
+    }
+    /**
+     * Update the status and optionally the confidence of a record.
+     */
+    updateStatus(id, status, confidence) {
+        const record = this.getById(id);
+        if (!record)
+            return;
+        record.status = status;
+        if (confidence !== undefined) {
+            record.confidence = confidence;
+        }
+        record.updatedAt = new Date().toISOString();
+    }
+    /**
+     * Retrieve a record by its original case-schema fact ID.
+     * Bridges FactLedger identity ↔ Evidence Graph node identity.
+     */
+    getByOriginFactId(originFactId) {
+        return this.records.find(r => r.originFactId === originFactId);
+    }
+    /**
+     * Add a related fact link to a record.
+     */
+    addRelatedFact(id, relatedFactId) {
+        const record = this.getById(id);
+        if (!record)
+            return;
+        if (!record.relatedFactIds.includes(relatedFactId)) {
+            record.relatedFactIds.push(relatedFactId);
+            record.updatedAt = new Date().toISOString();
+        }
+    }
+    /**
+     * Update the reliability (confidence) of a record without changing its status. (#229)
+     */
+    updateReliability(id, confidence) {
+        const record = this.getById(id);
+        if (!record)
+            return;
+        record.confidence = confidence;
+        record.updatedAt = new Date().toISOString();
+    }
+    // --- Query methods (#232) ---
+    /**
+     * Retrieve all records mentioning an entity (via relatedEntities, entityRefs, or legacy fields).
+     */
+    getByEntity(entityId) {
+        return this.records.filter(r => r.relatedEntities?.some(e => e.id === entityId) ||
+            r.entityRefs?.includes(entityId) ||
+            r.relatedCharacterIds.includes(entityId) ||
+            r.relatedArtifactIds.includes(entityId) ||
+            r.subject === entityId);
+    }
+    /**
+     * Retrieve all records from a given discovery method (sourceType alias).
+     */
+    getByMethod(method) {
+        return this.records.filter(r => r.sourceType === method);
+    }
+    /**
+     * Retrieve all records at a given reliability (confidence) level.
+     */
+    getByReliability(level) {
+        return this.records.filter(r => r.confidence === level);
+    }
+    /**
+     * Retrieve the full transitive chain of related facts starting from a given fact.
+     * Follows relatedFactIds links recursively, avoiding cycles.
+     */
+    getRelatedFacts(factId) {
+        const visited = new Set();
+        const result = [];
+        const walk = (id) => {
+            if (visited.has(id))
+                return;
+            visited.add(id);
+            const record = this.getById(id);
+            if (!record)
+                return;
+            if (id !== factId)
+                result.push(record);
+            for (const relId of record.relatedFactIds) {
+                walk(relId);
+            }
+        };
+        walk(factId);
+        return result;
+    }
+    /**
+     * Trace back to the root source of a fact via relatedFactIds.
+     * Returns the chain from the given fact to the earliest ancestor.
+     */
+    getProvenanceChain(factId) {
+        const chain = [];
+        const visited = new Set();
+        let currentId = factId;
+        while (currentId && !visited.has(currentId)) {
+            visited.add(currentId);
+            const record = this.getById(currentId);
+            if (!record)
+                break;
+            if (currentId !== factId)
+                chain.push(record);
+            const olderRelated = record.relatedFactIds.find(relId => {
+                const rel = this.getById(relId);
+                return rel && !visited.has(relId) && rel.discoveredAt <= record.discoveredAt;
+            });
+            currentId = olderRelated;
+        }
+        return chain;
+    }
+    /**
+     * Get all records in the ledger.
+     */
+    getAll() {
+        return [...this.records];
+    }
+    /**
+     * Get the total number of records.
+     */
+    get size() {
+        return this.records.length;
+    }
+    /**
+     * Duplicate detection using stable identity:
+     * sourceType + sourceId + subject + statement
+     */
+    _isDuplicate(record) {
+        return this.records.some(r => r.sourceType === record.sourceType &&
+            r.sourceId === record.sourceId &&
+            r.subject === record.subject &&
+            r.statement === record.statement);
+    }
+}
+//# sourceMappingURL=FactLedger.js.map

package/dist/investigation/FactLedger.js.map

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

package/dist/investigation/InvestigationTimeline.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Investigation Timeline (#247, #249, #250)
+ *
+ * Dual timeline: story time (in-world chronology) vs investigation time
+ * (player discovery order). Supports gap detection and overlap analysis.
+ *
+ * Engine-generic: operates on FactRecords from the DiscoveryLayer,
+ * not on product-specific scenario types. Time extraction uses
+ * regex patterns on fact statements and an optional structured-fact
+ * lookup callback for products that carry structured time data.
+ *
+ * No product vocabulary: no suspect, crime, case, accusation,
+ * investigation, contradiction.
+ *
+ * MS-28 #887 — Phase 1.2 — Orchestrator migration step 5.9.
+ */
+import type { DiscoveryLayer } from './DiscoveryLayer.js';
+export interface TimelineEntry {
+    factId: string;
+    subject: string;
+    statement: string;
+    /** In-world time (e.g., "14:00") — extracted from fact. Undefined if no time data. */
+    storyTime?: string;
+    /** ISO timestamp of when the player discovered this fact. */
+    discoveryTime: string;
+    sourceType: string;
+    sourceId: string;
+}
+/**
+ * A temporal gap — an unaccounted-for time window for an entity (#249).
+ */
+export interface TemporalGap {
+    entityId: string;
+    gapStart: string;
+    gapEnd: string;
+}
+/**
+ * A temporal overlap — two entities with intersecting time windows (#250).
+ */
+export interface TemporalOverlap {
+    entityA: string;
+    entityB: string;
+    overlapStart: string;
+    overlapEnd: string;
+    factIdA: string;
+    factIdB: string;
+}
+/**
+ * Optional callback for structured time extraction.
+ *
+ * Products that carry structured fact data (e.g. typed timestamp/time-window
+ * facts) can supply a lookup function that extracts start/end times from
+ * the original fact object. This is more reliable than regex on statements.
+ */
+export interface StructuredTimeLookup {
+    /** Extract the start / primary time for a given fact ID. */
+    getStoryTime(factId: string): string | undefined;
+    /** Extract the end time for a given fact ID (for time-window facts). */
+    getEndTime(factId: string): string | undefined;
+}
+export declare class InvestigationTimeline {
+    private discoveryLayer;
+    private timeLookup?;
+    constructor(discoveryLayer: DiscoveryLayer, timeLookup?: StructuredTimeLookup | undefined);
+    /**
+     * Events ordered by in-world chronology (#247).
+     * Only facts with parseable time data are included.
+     */
+    getStoryTimeline(): TimelineEntry[];
+    /**
+     * Events ordered by player discovery time (#247).
+     */
+    getDiscoveryTimeline(): TimelineEntry[];
+    /**
+     * Entity-specific chronology (#247).
+     */
+    getTimelineForEntity(entityId: string): TimelineEntry[];
+    /**
+     * Events within a story time window (#247).
+     */
+    getTimelineRange(start: string, end: string): TimelineEntry[];
+    /**
+     * Identify temporal gaps for an entity (#249).
+     * Returns unaccounted-for time windows between known events.
+     */
+    getTemporalGaps(entityId: string): TemporalGap[];
+    /**
+     * Detect temporal overlaps between entities (#250).
+     * Finds pairs of entities with intersecting time windows.
+     */
+    getOverlaps(): TemporalOverlap[];
+    private _buildEntries;
+    private _extractStoryTime;
+    private _extractEndTime;
+    private _extractTimePoints;
+    private _timeDiffMinutes;
+}
+//# sourceMappingURL=InvestigationTimeline.d.ts.map

package/dist/investigation/InvestigationTimeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvestigationTimeline.d.ts","sourceRoot":"","sources":["../../src/investigation/InvestigationTimeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAM1D,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACjD,wEAAwE;IACxE,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAChD;AAMD,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,UAAU,CAAC;gBADX,cAAc,EAAE,cAAc,EAC9B,UAAU,CAAC,EAAE,oBAAoB,YAAA;IAG3C;;;OAGG;IACH,gBAAgB,IAAI,aAAa,EAAE;IAMnC;;OAEG;IACH,oBAAoB,IAAI,aAAa,EAAE;IAKvC;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE;IAMvD;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE;IAO7D;;;OAGG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE;IA4BhD;;;OAGG;IACH,WAAW,IAAI,eAAe,EAAE;IA4ChC,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,gBAAgB;CAKzB"}

package/dist/investigation/InvestigationTimeline.js

@@ -0,0 +1,178 @@
+/**
+ * Investigation Timeline (#247, #249, #250)
+ *
+ * Dual timeline: story time (in-world chronology) vs investigation time
+ * (player discovery order). Supports gap detection and overlap analysis.
+ *
+ * Engine-generic: operates on FactRecords from the DiscoveryLayer,
+ * not on product-specific scenario types. Time extraction uses
+ * regex patterns on fact statements and an optional structured-fact
+ * lookup callback for products that carry structured time data.
+ *
+ * No product vocabulary: no suspect, crime, case, accusation,
+ * investigation, contradiction.
+ *
+ * MS-28 #887 — Phase 1.2 — Orchestrator migration step 5.9.
+ */
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+export class InvestigationTimeline {
+    discoveryLayer;
+    timeLookup;
+    constructor(discoveryLayer, timeLookup) {
+        this.discoveryLayer = discoveryLayer;
+        this.timeLookup = timeLookup;
+    }
+    /**
+     * Events ordered by in-world chronology (#247).
+     * Only facts with parseable time data are included.
+     */
+    getStoryTimeline() {
+        return this._buildEntries()
+            .filter(e => e.storyTime !== undefined)
+            .sort((a, b) => a.storyTime.localeCompare(b.storyTime));
+    }
+    /**
+     * Events ordered by player discovery time (#247).
+     */
+    getDiscoveryTimeline() {
+        return this._buildEntries()
+            .sort((a, b) => a.discoveryTime.localeCompare(b.discoveryTime));
+    }
+    /**
+     * Entity-specific chronology (#247).
+     */
+    getTimelineForEntity(entityId) {
+        return this._buildEntries()
+            .filter(e => e.subject === entityId)
+            .sort((a, b) => (a.storyTime ?? '').localeCompare(b.storyTime ?? ''));
+    }
+    /**
+     * Events within a story time window (#247).
+     */
+    getTimelineRange(start, end) {
+        return this.getStoryTimeline().filter(e => {
+            if (!e.storyTime)
+                return false;
+            return e.storyTime >= start && e.storyTime <= end;
+        });
+    }
+    /**
+     * Identify temporal gaps for an entity (#249).
+     * Returns unaccounted-for time windows between known events.
+     */
+    getTemporalGaps(entityId) {
+        const entries = this.getTimelineForEntity(entityId)
+            .filter(e => e.storyTime !== undefined);
+        if (entries.length < 2)
+            return [];
+        const timePoints = this._extractTimePoints(entries);
+        if (timePoints.length < 2)
+            return [];
+        timePoints.sort((a, b) => a.localeCompare(b));
+        const gaps = [];
+        for (let i = 0; i < timePoints.length - 1; i++) {
+            const current = timePoints[i];
+            const next = timePoints[i + 1];
+            if (this._timeDiffMinutes(current, next) > 60) {
+                gaps.push({
+                    entityId,
+                    gapStart: current,
+                    gapEnd: next,
+                });
+            }
+        }
+        return gaps;
+    }
+    /**
+     * Detect temporal overlaps between entities (#250).
+     * Finds pairs of entities with intersecting time windows.
+     */
+    getOverlaps() {
+        const facts = this.discoveryLayer.getDiscoveredFacts();
+        const overlaps = [];
+        const windows = [];
+        for (const fact of facts) {
+            const storyTime = this._extractStoryTime(fact);
+            if (!storyTime)
+                continue;
+            const endTime = this._extractEndTime(fact);
+            if (endTime) {
+                windows.push({ entityId: fact.subject, start: storyTime, end: endTime, factId: fact.id });
+            }
+        }
+        for (let i = 0; i < windows.length; i++) {
+            for (let j = i + 1; j < windows.length; j++) {
+                const a = windows[i];
+                const b = windows[j];
+                if (a.entityId === b.entityId)
+                    continue;
+                const overlapStart = a.start > b.start ? a.start : b.start;
+                const overlapEnd = a.end < b.end ? a.end : b.end;
+                if (overlapStart < overlapEnd) {
+                    overlaps.push({
+                        entityA: a.entityId,
+                        entityB: b.entityId,
+                        overlapStart,
+                        overlapEnd,
+                        factIdA: a.factId,
+                        factIdB: b.factId,
+                    });
+                }
+            }
+        }
+        return overlaps;
+    }
+    // --- Private helpers ---
+    _buildEntries() {
+        return this.discoveryLayer.getDiscoveredFacts().map(r => ({
+            factId: r.id,
+            subject: r.subject,
+            statement: r.statement,
+            storyTime: this._extractStoryTime(r),
+            discoveryTime: r.discoveredAt,
+            sourceType: r.sourceType,
+            sourceId: r.sourceId,
+        }));
+    }
+    _extractStoryTime(record) {
+        // Prefer structured fact data via lookup
+        if (this.timeLookup && record.originFactId) {
+            const time = this.timeLookup.getStoryTime(record.originFactId);
+            if (time)
+                return time;
+        }
+        // Fallback to regex for records without structured data
+        const match = record.statement.match(/(\d{1,2}:\d{2})/);
+        return match ? match[1] : undefined;
+    }
+    _extractEndTime(record) {
+        // Prefer structured fact data via lookup
+        if (this.timeLookup && record.originFactId) {
+            const time = this.timeLookup.getEndTime(record.originFactId);
+            if (time)
+                return time;
+        }
+        // Fallback to regex
+        const match = record.statement.match(/to\s+(\d{1,2}:\d{2})/);
+        return match ? match[1] : undefined;
+    }
+    _extractTimePoints(entries) {
+        const points = [];
+        for (const e of entries) {
+            if (e.storyTime)
+                points.push(e.storyTime);
+            const endMatch = e.statement.match(/to\s+(\d{1,2}:\d{2})/);
+            if (endMatch)
+                points.push(endMatch[1]);
+        }
+        return [...new Set(points)];
+    }
+    _timeDiffMinutes(a, b) {
+        const [aH, aM] = a.split(':').map(Number);
+        const [bH, bM] = b.split(':').map(Number);
+        return (bH * 60 + bM) - (aH * 60 + aM);
+    }
+}
+//# sourceMappingURL=InvestigationTimeline.js.map

package/dist/investigation/InvestigationTimeline.js.map

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

package/dist/investigation/ProfileEngine.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Profile Engine (#242, #243, #245, #246)
+ *
+ * Computes dynamic entity profiles from discovered evidence.
+ * Profiles are NEVER stored — always computed from DiscoveryLayer.
+ *
+ * Engine-generic: operates on FactRecords and Findings, not on
+ * product-specific scenario types. No product vocabulary.
+ *
+ * MS-28 #887 — Phase 1.2 — Orchestrator migration step 5.9.
+ */
+import type { FactRecord } from './types.js';
+import type { DiscoveryLayer } from './DiscoveryLayer.js';
+import type { Finding } from '@gridlock/validators';
+export interface ProfileRelationship {
+    targetEntity: string;
+    relationshipType: string;
+    evidenceBasis: string[];
+    strength: 'weak' | 'moderate' | 'strong';
+}
+export type ProfileDepth = 'shallow' | 'developing' | 'detailed' | 'comprehensive';
+export interface EntityProfile {
+    entityId: string;
+    entityType: string;
+    knownFacts: FactRecord[];
+    contradictions: Finding[];
+    findings: Finding[];
+    aggregateReliability: 'low' | 'medium' | 'high';
+    discoveryDepth: ProfileDepth;
+    relationships: ProfileRelationship[];
+}
+/**
+ * Delta between two profile snapshots (#243).
+ */
+export interface ProfileDelta {
+    entityId: string;
+    newFacts: FactRecord[];
+    newContradictions: Finding[];
+    depthChange: {
+        from: ProfileDepth;
+        to: ProfileDepth;
+    } | null;
+}
+/**
+ * Comparison between two entity profiles (#246).
+ */
+export interface ProfileComparison {
+    entityA: string;
+    entityB: string;
+    sharedFacts: FactRecord[];
+    interEntityContradictions: Finding[];
+    overlappingRelationships: string[];
+}
+export declare class ProfileEngine {
+    private discoveryLayer;
+    private findings;
+    private lastSeenProfiles;
+    constructor(discoveryLayer: DiscoveryLayer, findings: Finding[], lastSeen?: Map<string, EntityProfile>);
+    /**
+     * Get the last-seen profiles map (for state preservation across recreations).
+     */
+    getLastSeenProfiles(): Map<string, EntityProfile>;
+    /**
+     * Build a dynamic profile for an entity (#242).
+     */
+    buildProfile(entityId: string): EntityProfile;
+    /**
+     * Compute delta vs last-seen profile (#243).
+     */
+    computeDelta(entityId: string): ProfileDelta;
+    /**
+     * Mark the current profile as "seen" by the player (#243).
+     */
+    markSeen(entityId: string): void;
+    /**
+     * Compare two entity profiles (#246).
+     */
+    compareProfiles(entityA: string, entityB: string): ProfileComparison;
+    private _inferEntityType;
+    private _computeAggregateReliability;
+    private _computeDepth;
+    private _buildRelationships;
+}
+//# sourceMappingURL=ProfileEngine.d.ts.map

package/dist/investigation/ProfileEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProfileEngine.d.ts","sourceRoot":"","sources":["../../src/investigation/ProfileEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAOpD,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;CAC1C;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,eAAe,CAAC;AAEnF,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB,cAAc,EAAE,OAAO,EAAE,CAAC;IAC1B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,oBAAoB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAChD,cAAc,EAAE,YAAY,CAAC;IAC7B,aAAa,EAAE,mBAAmB,EAAE,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,iBAAiB,EAAE,OAAO,EAAE,CAAC;IAC7B,WAAW,EAAE;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,EAAE,EAAE,YAAY,CAAA;KAAE,GAAG,IAAI,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,yBAAyB,EAAE,OAAO,EAAE,CAAC;IACrC,wBAAwB,EAAE,MAAM,EAAE,CAAC;CACpC;AAMD,qBAAa,aAAa;IAItB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,QAAQ;IAJlB,OAAO,CAAC,gBAAgB,CAA6B;gBAG3C,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,OAAO,EAAE,EAC3B,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC;IAKvC;;OAEG;IACH,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC;IAIjD;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa;IA0B7C;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IA0B5C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIhC;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB;IA6BpE,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,4BAA4B;IAQpC,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,mBAAmB;CA+B5B"}