@adammcarter/use-cases 0.1.0

package/packages/core/dist/markers/reconcile.d.ts

@@ -0,0 +1,26 @@
+import type { MaterializedRegistry } from "./registry.js";
+import type { ScanResult } from "./scanner.js";
+export interface RowReconciliation {
+    row_id: string;
+    registered_binding_slugs: string[];
+    current_binding_slugs: string[];
+    missing_registered_binding_slugs: string[];
+    unregistered_current_binding_slugs: string[];
+}
+export interface UnregisteredDetection {
+    binding_slug: string;
+    row_id: string;
+    file_path: string;
+    start_line: number;
+}
+export interface MissingDetection {
+    binding_slug: string;
+    row_id: string;
+}
+export interface ReconciliationResult {
+    rows: RowReconciliation[];
+    unregistered: UnregisteredDetection[];
+    missing: MissingDetection[];
+}
+export declare function reconcileRegistryWithScan(registry: MaterializedRegistry, scan: ScanResult): ReconciliationResult;
+//# sourceMappingURL=reconcile.d.ts.map

package/packages/core/dist/markers/reconcile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../src/markers/reconcile.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,gCAAgC,EAAE,MAAM,EAAE,CAAC;IAC3C,kCAAkC,EAAE,MAAM,EAAE,CAAC;CAC9C;AAGD,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAGD,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,iBAAiB,EAAE,CAAC;IAC1B,YAAY,EAAE,qBAAqB,EAAE,CAAC;IACtC,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAMD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,oBAAoB,EAC9B,IAAI,EAAE,UAAU,GACf,oBAAoB,CAsDtB"}

package/packages/core/dist/markers/reconcile.js

@@ -0,0 +1,52 @@
+function sorted(values) {
+    return [...values].sort();
+}
+export function reconcileRegistryWithScan(registry, scan) {
+    // Group current scanned binding slugs by their row id.
+    const currentByRow = new Map();
+    for (const binding of scan.bindings) {
+        let slugs = currentByRow.get(binding.row_id);
+        if (!slugs) {
+            slugs = new Set();
+            currentByRow.set(binding.row_id, slugs);
+        }
+        slugs.add(binding.binding_slug);
+    }
+    // The row set is the union of registered rows and rows seen in the scan, so a
+    // row whose markers were all removed still appears (spec 7.3).
+    const rowIds = new Set([...registry.rowToSlugs.keys(), ...currentByRow.keys()]);
+    const rows = [];
+    const missing = [];
+    for (const rowId of sorted(rowIds)) {
+        const registered = registry.rowToSlugs.get(rowId) ?? new Set();
+        const current = currentByRow.get(rowId) ?? new Set();
+        const missingSlugs = sorted([...registered].filter((slug) => !current.has(slug)));
+        const unregisteredSlugs = sorted([...current].filter((slug) => !registered.has(slug)));
+        for (const slug of missingSlugs) {
+            missing.push({ binding_slug: slug, row_id: rowId });
+        }
+        rows.push({
+            row_id: rowId,
+            registered_binding_slugs: sorted(registered),
+            current_binding_slugs: sorted(current),
+            missing_registered_binding_slugs: missingSlugs,
+            unregistered_current_binding_slugs: unregisteredSlugs
+        });
+    }
+    // Flat unregistered detections, keyed off the actual scanned binding records so
+    // each carries a file path and line for a precise INVALID diagnostic.
+    const unregistered = [];
+    for (const binding of scan.bindings) {
+        const registeredRow = registry.slugToRow.get(binding.binding_slug);
+        if (registeredRow !== binding.row_id) {
+            unregistered.push({
+                binding_slug: binding.binding_slug,
+                row_id: binding.row_id,
+                file_path: binding.file_path,
+                start_line: binding.start_marker.line
+            });
+        }
+    }
+    return { rows, unregistered, missing };
+}
+//# sourceMappingURL=reconcile.js.map

package/packages/core/dist/markers/reconcile.js.map

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

package/packages/core/dist/markers/registry.d.ts

@@ -0,0 +1,53 @@
+export interface RegistryEvent {
+    schema: string;
+    event_type: string;
+    event_id: string;
+    created_at: string;
+    created_by: {
+        tool: string;
+        command: string;
+        version: string;
+    };
+    row_id: string;
+    binding_slug: string;
+    reason: string;
+}
+export declare const RegistryErrorCode: Readonly<{
+    readonly JSON_PARSE_ERROR: "JSON_PARSE_ERROR";
+    readonly REGISTRY_SCHEMA_INVALID: "REGISTRY_SCHEMA_INVALID";
+    readonly SLUG_PREFIX_MISMATCH: "SLUG_PREFIX_MISMATCH";
+    readonly REGISTRY_ROW_MISSING: "REGISTRY_ROW_MISSING";
+    readonly DUPLICATE_REGISTRATION: "DUPLICATE_REGISTRATION";
+    readonly SLUG_ROW_CONFLICT: "SLUG_ROW_CONFLICT";
+}>;
+export type RegistryErrorCode = (typeof RegistryErrorCode)[keyof typeof RegistryErrorCode];
+export interface RegistryError {
+    code: RegistryErrorCode;
+    line: number | null;
+    message: string;
+    binding_slug?: string;
+    row_id?: string;
+}
+export interface RegistryLine {
+    line: number;
+    value: unknown;
+}
+export interface ReadRegistryResult {
+    lines: RegistryLine[];
+    errors: RegistryError[];
+}
+export interface MaterializedRegistry {
+    rowToSlugs: Map<string, Set<string>>;
+    slugToRow: Map<string, string>;
+}
+export interface RegistryValidationResult {
+    ok: boolean;
+    errors: RegistryError[];
+    events: RegistryEvent[];
+    registry: MaterializedRegistry;
+}
+export declare function readBindingsJsonl(text: string): ReadRegistryResult;
+export declare function validateRegistryEvents(read: ReadRegistryResult, yamlRowIds: ReadonlySet<string>): RegistryValidationResult;
+export declare function validateBindingsJsonl(text: string, yamlRowIds: ReadonlySet<string>): RegistryValidationResult;
+export declare function materializeRegistry(events: ReadonlyArray<RegistryEvent>): MaterializedRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/packages/core/dist/markers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/markers/registry.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAGD,eAAO,MAAM,iBAAiB;;;;;;;EAOnB,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAE3F,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAGD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAGD,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACrC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,QAAQ,EAAE,oBAAoB,CAAC;CAChC;AAQD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAqBlE;AAUD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,kBAAkB,EACxB,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAC9B,wBAAwB,CAyF1B;AAGD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAC9B,wBAAwB,CAE1B;AAID,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,oBAAoB,CAa9F"}

package/packages/core/dist/markers/registry.js

@@ -0,0 +1,161 @@
+// Append-only binding registry: reader, validator, materializer (spec section 4).
+//
+// The registry (`.use-cases/bindings.jsonl`) is an append-only log of
+// `binding_registered` events (amendment 2). This module turns that JSONL text
+// into validated events and a materialized map, enforcing the spec 4.3
+// validation rules with precise, stable error codes. Everything here is pure:
+// callers pass the file text and the set of YAML row ids; no filesystem or git
+// access happens in this module (the git base-ref read lives in appendOnly.ts).
+import { validateBindingRegistryEvent } from "./validators.js";
+import { splitSlug } from "./markerLine.js";
+// Stable error codes for every way the registry can be invalid (spec 4.3 / 7.1).
+export const RegistryErrorCode = Object.freeze({
+    JSON_PARSE_ERROR: "JSON_PARSE_ERROR",
+    REGISTRY_SCHEMA_INVALID: "REGISTRY_SCHEMA_INVALID",
+    SLUG_PREFIX_MISMATCH: "SLUG_PREFIX_MISMATCH",
+    REGISTRY_ROW_MISSING: "REGISTRY_ROW_MISSING",
+    DUPLICATE_REGISTRATION: "DUPLICATE_REGISTRATION",
+    SLUG_ROW_CONFLICT: "SLUG_ROW_CONFLICT"
+});
+// Read JSONL text into one parsed value per line (spec 4.3 rule 1).
+//
+// A trailing newline is tolerated; whitespace-only lines are skipped so an empty
+// or newline-terminated file reads cleanly. Any line that fails JSON.parse is
+// reported as a JSON_PARSE_ERROR carrying its 1-based line number; the remaining
+// lines are still read.
+export function readBindingsJsonl(text) {
+    const lines = [];
+    const errors = [];
+    const rawLines = text.split("\n");
+    for (let i = 0; i < rawLines.length; i += 1) {
+        const raw = rawLines[i];
+        if (raw.trim() === "") {
+            continue; // tolerate trailing newline / blank separators
+        }
+        const lineNo = i + 1;
+        try {
+            lines.push({ line: lineNo, value: JSON.parse(raw) });
+        }
+        catch (error) {
+            errors.push({
+                code: RegistryErrorCode.JSON_PARSE_ERROR,
+                line: lineNo,
+                message: `line ${lineNo} is not valid JSON: ${error.message}`
+            });
+        }
+    }
+    return { lines, errors };
+}
+function rowPrefixOf(bindingSlug) {
+    const parts = splitSlug(bindingSlug);
+    return parts ? parts.row_id : null;
+}
+// Validate parsed registry lines against the schema and spec 4.3 rules, folding
+// the accepted events into a materialized registry. Validation is order-sensitive
+// (duplicate/conflict detection depends on the first registration of a slug).
+export function validateRegistryEvents(read, yamlRowIds) {
+    const errors = [...read.errors];
+    const events = [];
+    const rowToSlugs = new Map();
+    const slugToRow = new Map();
+    for (const { line, value } of read.lines) {
+        // Rule 1-3: schema (covers event_type === "binding_registered" via const).
+        const schemaResult = validateBindingRegistryEvent(value);
+        if (!schemaResult.ok) {
+            errors.push({
+                code: RegistryErrorCode.REGISTRY_SCHEMA_INVALID,
+                line,
+                message: `registry event failed schema: ${schemaResult.errors
+                    .map((e) => `${e.instance_path} ${e.message}`.trim())
+                    .join("; ")}`
+            });
+            continue;
+        }
+        const event = value;
+        const slug = event.binding_slug;
+        const row = event.row_id;
+        // Rule 4: binding_slug row prefix must equal row_id.
+        const prefix = rowPrefixOf(slug);
+        if (prefix !== row) {
+            errors.push({
+                code: RegistryErrorCode.SLUG_PREFIX_MISMATCH,
+                line,
+                message: `binding_slug ${slug} has row prefix ${prefix ?? "<invalid>"} but row_id is ${row}`,
+                binding_slug: slug,
+                row_id: row
+            });
+            continue;
+        }
+        // Rule 5: row_id must exist in YAML rows.
+        if (!yamlRowIds.has(row)) {
+            errors.push({
+                code: RegistryErrorCode.REGISTRY_ROW_MISSING,
+                line,
+                message: `row_id ${row} is not a known YAML row`,
+                binding_slug: slug,
+                row_id: row
+            });
+            continue;
+        }
+        // Rules 6/8 + v1 simplification ("do not allow duplicate registration at
+        // all"): a slug may be registered exactly once. Re-registering to a
+        // different row is the more specific SLUG_ROW_CONFLICT.
+        const existingRow = slugToRow.get(slug);
+        if (existingRow !== undefined) {
+            if (existingRow !== row) {
+                errors.push({
+                    code: RegistryErrorCode.SLUG_ROW_CONFLICT,
+                    line,
+                    message: `binding_slug ${slug} already registered to ${existingRow}; cannot reassign to ${row}`,
+                    binding_slug: slug,
+                    row_id: row
+                });
+            }
+            else {
+                errors.push({
+                    code: RegistryErrorCode.DUPLICATE_REGISTRATION,
+                    line,
+                    message: `binding_slug ${slug} is already registered`,
+                    binding_slug: slug,
+                    row_id: row
+                });
+            }
+            continue;
+        }
+        slugToRow.set(slug, row);
+        let slugs = rowToSlugs.get(row);
+        if (!slugs) {
+            slugs = new Set();
+            rowToSlugs.set(row, slugs);
+        }
+        slugs.add(slug);
+        events.push(event);
+    }
+    return {
+        ok: errors.length === 0,
+        errors,
+        events,
+        registry: { rowToSlugs, slugToRow }
+    };
+}
+// Convenience: read then validate bindings.jsonl text in one call.
+export function validateBindingsJsonl(text, yamlRowIds) {
+    return validateRegistryEvents(readBindingsJsonl(text), yamlRowIds);
+}
+// Fold already-validated events into a materialized registry (spec 4.3). Assumes
+// the events passed validation (no conflict checks are repeated here).
+export function materializeRegistry(events) {
+    const rowToSlugs = new Map();
+    const slugToRow = new Map();
+    for (const event of events) {
+        slugToRow.set(event.binding_slug, event.row_id);
+        let slugs = rowToSlugs.get(event.row_id);
+        if (!slugs) {
+            slugs = new Set();
+            rowToSlugs.set(event.row_id, slugs);
+        }
+        slugs.add(event.binding_slug);
+    }
+    return { rowToSlugs, slugToRow };
+}
+//# sourceMappingURL=registry.js.map

package/packages/core/dist/markers/registry.js.map

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

package/packages/core/dist/markers/rowHash.d.ts

@@ -0,0 +1,2 @@
+export declare function computeRowHash(row: unknown): string;
+//# sourceMappingURL=rowHash.d.ts.map

package/packages/core/dist/markers/rowHash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowHash.d.ts","sourceRoot":"","sources":["../../src/markers/rowHash.ts"],"names":[],"mappings":"AAOA,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAEnD"}

package/packages/core/dist/markers/rowHash.js

@@ -0,0 +1,10 @@
+import { computeSemanticHash } from "../schema/index.js";
+// Row hash adapter.
+//
+// Reuses the existing semantic-hash algorithm (computeSemanticHash) rather than
+// reinventing one, so a row's freshness hash stays consistent with the rest of
+// the system. Returns "sha256:<hex>".
+export function computeRowHash(row) {
+    return computeSemanticHash(row);
+}
+//# sourceMappingURL=rowHash.js.map

package/packages/core/dist/markers/rowHash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowHash.js","sourceRoot":"","sources":["../../src/markers/rowHash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,oBAAoB;AACpB,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,sCAAsC;AACtC,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC"}

package/packages/core/dist/markers/scanner.d.ts

@@ -0,0 +1,67 @@
+import { MarkerErrorCode } from "./markerLine.js";
+import { type CommentPrefixConfig } from "./commentPrefix.js";
+import { SwiftFuncErrorCode } from "./swiftFuncRecognizer.js";
+export type ScanErrorCode = MarkerErrorCode | SwiftFuncErrorCode;
+export interface MarkerError {
+    code: ScanErrorCode;
+    message: string;
+    file_path: string;
+    line: number;
+    slug?: string;
+}
+export interface ExplicitBindingDiagnostic {
+    inferred: false;
+}
+export interface InferredBindingDiagnostic {
+    symbol_kind: "swift_func";
+    symbol_name: string;
+    inferred: true;
+}
+export interface CurrentBindingRecord {
+    binding_slug: string;
+    row_id: string;
+    suffix: string | null;
+    file_path: string;
+    comment_prefix: string;
+    extent_kind: "explicit" | "swift_func_inferred";
+    recognizer_id: string;
+    span_canon_id: string;
+    start_marker: {
+        line: number;
+        column: number;
+    };
+    end_marker: {
+        line: number;
+        column: number;
+    } | null;
+    span: {
+        start_line: number;
+        end_line: number;
+        start_byte: number;
+        end_byte: number;
+        sha256: string;
+    };
+    diagnostic: ExplicitBindingDiagnostic | InferredBindingDiagnostic;
+}
+export interface ScanFileResult {
+    file_path: string;
+    comment_prefix: string | null;
+    bindings: CurrentBindingRecord[];
+    errors: MarkerError[];
+}
+export interface ScanResult {
+    files: ScanFileResult[];
+    bindings: CurrentBindingRecord[];
+    errors: MarkerError[];
+}
+export interface ScannerOptions {
+    config?: CommentPrefixConfig;
+}
+export interface ScanInput {
+    file_path: string;
+    contents: string;
+}
+export declare function scanFileForMarkers(filePath: string, contents: string, options?: ScannerOptions): ScanFileResult;
+export declare function scanFiles(inputs: ReadonlyArray<ScanInput>, options?: ScannerOptions): ScanResult;
+export declare function formatInferredSwiftSpanReport(binding: CurrentBindingRecord): string | null;
+//# sourceMappingURL=scanner.d.ts.map

package/packages/core/dist/markers/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/markers/scanner.ts"],"names":[],"mappings":"AAoBA,OAAO,EACL,eAAe,EAIhB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAEL,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAIlC,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,kBAAkB,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,KAAK,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,YAAY,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,IAAI,CAAC;CAChB;AAGD,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,UAAU,GAAG,qBAAqB,CAAC;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACpD,IAAI,EAAE;QACJ,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,UAAU,EAAE,yBAAyB,GAAG,yBAAyB,CAAC;CACnE;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA2ID,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,cAAc,CAgIhB;AAID,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CA0BhG;AAID,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI,CAa1F"}