@the-cascade-protocol/cli 0.2.0

package/dist/lib/output.js

@@ -0,0 +1,64 @@
+/**
+ * Output formatting utilities for consistent CLI output.
+ *
+ * Supports both human-readable text and machine-readable JSON output modes.
+ */
+/**
+ * Format data for output in either JSON or human-readable text mode.
+ */
+export function formatOutput(data, opts) {
+    if (opts.json) {
+        return JSON.stringify(data, null, 2);
+    }
+    if (typeof data === 'string') {
+        return data;
+    }
+    if (Array.isArray(data)) {
+        return data.map((item) => formatSingleItem(item)).join('\n');
+    }
+    return formatSingleItem(data);
+}
+/**
+ * Format a single item for human-readable output.
+ */
+function formatSingleItem(item) {
+    if (typeof item === 'string') {
+        return item;
+    }
+    if (typeof item === 'object' && item !== null) {
+        const entries = Object.entries(item);
+        return entries.map(([key, value]) => `  ${key}: ${String(value)}`).join('\n');
+    }
+    return String(item);
+}
+/**
+ * Print result data to stdout.
+ */
+export function printResult(data, opts) {
+    console.log(formatOutput(data, opts));
+}
+/**
+ * Print an error message to stderr.
+ */
+export function printError(message, opts) {
+    if (opts.json) {
+        console.error(JSON.stringify({ error: message }));
+    }
+    else {
+        console.error(`ERROR: ${message}`);
+    }
+}
+/**
+ * Print a verbose/debug message (only if verbose mode is enabled).
+ */
+export function printVerbose(message, opts) {
+    if (opts.verbose) {
+        if (opts.json) {
+            console.error(JSON.stringify({ debug: message }));
+        }
+        else {
+            console.error(`[verbose] ${message}`);
+        }
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/lib/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAa,EAAE,IAAmB;IAC7D,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,IAAa;IACrC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAA+B,CAAC,CAAC;QAChE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChF,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAa,EAAE,IAAmB;IAC5D,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,IAAmB;IAC7D,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IACpD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,IAAmB;IAC/D,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,aAAa,OAAO,EAAE,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/lib/shacl-validator.d.ts

@@ -0,0 +1,53 @@
+/**
+ * SHACL validation utilities.
+ *
+ * Wraps rdf-validate-shacl to validate RDF data against
+ * Cascade Protocol SHACL shapes.
+ */
+import { Store } from 'n3';
+import type { ParseResult } from './turtle-parser.js';
+export interface ValidationResult {
+    valid: boolean;
+    file: string;
+    results: ValidationIssue[];
+    shapesUsed: string[];
+    quadCount: number;
+    subjects: Array<{
+        uri: string;
+        types: string[];
+    }>;
+}
+export interface ValidationIssue {
+    severity: 'violation' | 'warning' | 'info';
+    shape: string;
+    property: string;
+    message: string;
+    focusNode?: string;
+    value?: string;
+    specLink?: string;
+}
+/**
+ * Load all bundled SHACL shapes from the shapes directory into a single store.
+ * If a custom shapes path is provided, load from there instead.
+ */
+export declare function loadShapes(customShapesPath?: string): {
+    store: Store;
+    shapeFiles: string[];
+};
+/**
+ * Validate an already-parsed Turtle file against SHACL shapes.
+ */
+export declare function validateParsed(parseResult: ParseResult, shapesStore: Store, shapeFiles: string[], filePath: string): ValidationResult;
+/**
+ * Validate a Turtle string against SHACL shapes.
+ */
+export declare function validateTurtle(turtleContent: string, shapesStore: Store, shapeFiles: string[], filePath: string): ValidationResult;
+/**
+ * Validate a Turtle file against SHACL shapes.
+ */
+export declare function validateFile(filePath: string, shapesStore: Store, shapeFiles: string[]): ValidationResult;
+/**
+ * Recursively find all .ttl files in a directory.
+ */
+export declare function findTurtleFiles(dirPath: string): string[];
+//# sourceMappingURL=shacl-validator.d.ts.map

package/dist/lib/shacl-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shacl-validator.d.ts","sourceRoot":"","sources":["../../src/lib/shacl-validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAU,KAAK,EAAE,MAAM,IAAI,CAAC;AAGnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA6CD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAsC5F;AAqDD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,KAAK,EAClB,UAAU,EAAE,MAAM,EAAE,EACpB,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAmElB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,KAAK,EAClB,UAAU,EAAE,MAAM,EAAE,EACpB,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAGlB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,KAAK,EAClB,UAAU,EAAE,MAAM,EAAE,GACnB,gBAAgB,CAmBlB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAoBzD"}

package/dist/lib/shacl-validator.js

@@ -0,0 +1,245 @@
+/**
+ * SHACL validation utilities.
+ *
+ * Wraps rdf-validate-shacl to validate RDF data against
+ * Cascade Protocol SHACL shapes.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Parser, Store } from 'n3';
+import SHACLValidator from 'rdf-validate-shacl';
+import { parseTurtle, detectVocabularies, CASCADE_NAMESPACES } from './turtle-parser.js';
+/** Mapping from shape file prefixes to their documentation base URLs */
+const SPEC_BASE_URLS = {
+    core: 'https://cascadeprotocol.org/docs/core/v1',
+    health: 'https://cascadeprotocol.org/docs/health/v1',
+    clinical: 'https://cascadeprotocol.org/docs/clinical/v1',
+    pots: 'https://cascadeprotocol.org/docs/pots/v1',
+    checkup: 'https://cascadeprotocol.org/docs/checkup/v1',
+    coverage: 'https://cascadeprotocol.org/docs/coverage/v1',
+};
+/**
+ * Resolve the bundled shapes directory.
+ * Works from both src/ (dev via tsx) and dist/ (built).
+ */
+function getShapesDir() {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    // When running from dist/lib/, shapes are at dist/shapes/
+    // When running from src/lib/ (dev), shapes are at src/shapes/
+    const shapesDir = path.resolve(__dirname, '..', 'shapes');
+    if (!fs.existsSync(shapesDir)) {
+        throw new Error(`Shapes directory not found at ${shapesDir}. ` +
+            'Run "npm run build" to bundle shapes.');
+    }
+    return shapesDir;
+}
+/**
+ * Load and parse a Turtle file into an N3 Store.
+ */
+function loadTurtleFile(filePath) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const parser = new Parser({ baseIRI: '' });
+    const store = new Store();
+    const quads = parser.parse(content);
+    store.addQuads(quads);
+    return store;
+}
+/**
+ * Load all bundled SHACL shapes from the shapes directory into a single store.
+ * If a custom shapes path is provided, load from there instead.
+ */
+export function loadShapes(customShapesPath) {
+    const shapesDir = customShapesPath ?? getShapesDir();
+    const store = new Store();
+    const shapeFiles = [];
+    if (!fs.existsSync(shapesDir)) {
+        throw new Error(`Shapes directory not found: ${shapesDir}`);
+    }
+    const files = fs.readdirSync(shapesDir).filter((f) => f.endsWith('.shapes.ttl'));
+    if (files.length === 0) {
+        throw new Error(`No SHACL shape files (*.shapes.ttl) found in ${shapesDir}`);
+    }
+    for (const file of files) {
+        const filePath = path.join(shapesDir, file);
+        const fileStore = loadTurtleFile(filePath);
+        for (const quad of fileStore) {
+            store.addQuad(quad);
+        }
+        shapeFiles.push(file);
+    }
+    // Also load vocabulary/ontology files so the validator knows about class hierarchies
+    const vocabFiles = fs.readdirSync(shapesDir).filter((f) => f.endsWith('.ttl') && !f.endsWith('.shapes.ttl'));
+    for (const file of vocabFiles) {
+        const filePath = path.join(shapesDir, file);
+        const fileStore = loadTurtleFile(filePath);
+        for (const quad of fileStore) {
+            store.addQuad(quad);
+        }
+    }
+    return { store, shapeFiles };
+}
+/**
+ * Generate a spec link from a shape URI.
+ *
+ * Examples:
+ *   https://ns.cascadeprotocol.org/clinical/v1#MedicationShape
+ *     -> https://cascadeprotocol.org/docs/clinical/v1#Medication
+ *   https://ns.cascadeprotocol.org/health/v1#SelfReportShape
+ *     -> https://cascadeprotocol.org/docs/health/v1#SelfReport
+ */
+function generateSpecLink(shapeUri) {
+    for (const [vocab, ns] of Object.entries(CASCADE_NAMESPACES)) {
+        if (shapeUri.startsWith(ns)) {
+            const localName = shapeUri.slice(ns.length);
+            // Remove "Shape" suffix for the spec link
+            const className = localName.replace(/Shape$/, '');
+            const baseUrl = SPEC_BASE_URLS[vocab];
+            if (baseUrl) {
+                return `${baseUrl}#${className}`;
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Map SHACL severity URI to our severity level.
+ */
+function mapSeverity(severityUri) {
+    if (severityUri.endsWith('#Violation') || severityUri.endsWith('Violation')) {
+        return 'violation';
+    }
+    if (severityUri.endsWith('#Warning') || severityUri.endsWith('Warning')) {
+        return 'warning';
+    }
+    if (severityUri.endsWith('#Info') || severityUri.endsWith('Info')) {
+        return 'info';
+    }
+    // Default to violation for unknown severity
+    return 'violation';
+}
+/**
+ * Extract a human-readable name from a URI by taking the fragment or last path segment.
+ */
+function uriToName(uri) {
+    if (uri.includes('#')) {
+        return uri.split('#').pop() ?? uri;
+    }
+    return uri.split('/').pop() ?? uri;
+}
+/**
+ * Validate an already-parsed Turtle file against SHACL shapes.
+ */
+export function validateParsed(parseResult, shapesStore, shapeFiles, filePath) {
+    if (!parseResult.success) {
+        return {
+            valid: false,
+            file: filePath,
+            results: parseResult.errors.map((err) => ({
+                severity: 'violation',
+                shape: '',
+                property: '',
+                message: `Parse error: ${err}`,
+            })),
+            shapesUsed: [],
+            quadCount: 0,
+            subjects: [],
+        };
+    }
+    // Detect vocabularies used so we can report which shapes apply
+    const vocabsUsed = detectVocabularies(parseResult);
+    const shapesUsed = shapeFiles.filter((f) => {
+        const vocabName = f.replace('.shapes.ttl', '');
+        return vocabsUsed.includes(vocabName);
+    });
+    // Run SHACL validation
+    const validator = new SHACLValidator(shapesStore, { allowNamedNodeInList: true });
+    const report = validator.validate(parseResult.store);
+    // Map results to our interface
+    const issues = [];
+    for (const result of report.results) {
+        const severityUri = result.severity?.value ?? '';
+        const severity = mapSeverity(severityUri);
+        const shapeUri = result.sourceShape?.value ?? '';
+        const pathUri = result.path?.value ?? '';
+        const focusNodeUri = result.focusNode?.value ?? '';
+        const valueStr = result.value?.value;
+        // Get the message - result.message is an array of Terms
+        const messages = result.message ?? [];
+        const messageText = messages.length > 0
+            ? messages.map((m) => m.value).join('; ')
+            : `Constraint violation on ${uriToName(pathUri)} of ${uriToName(shapeUri)}`;
+        const specLink = generateSpecLink(shapeUri);
+        issues.push({
+            severity,
+            shape: uriToName(shapeUri),
+            property: uriToName(pathUri),
+            message: messageText,
+            focusNode: focusNodeUri || undefined,
+            value: valueStr,
+            specLink,
+        });
+    }
+    return {
+        valid: report.conforms,
+        file: filePath,
+        results: issues,
+        shapesUsed,
+        quadCount: parseResult.quadCount,
+        subjects: parseResult.subjects,
+    };
+}
+/**
+ * Validate a Turtle string against SHACL shapes.
+ */
+export function validateTurtle(turtleContent, shapesStore, shapeFiles, filePath) {
+    const parseResult = parseTurtle(turtleContent);
+    return validateParsed(parseResult, shapesStore, shapeFiles, filePath);
+}
+/**
+ * Validate a Turtle file against SHACL shapes.
+ */
+export function validateFile(filePath, shapesStore, shapeFiles) {
+    if (!fs.existsSync(filePath)) {
+        return {
+            valid: false,
+            file: filePath,
+            results: [{
+                    severity: 'violation',
+                    shape: '',
+                    property: '',
+                    message: `File not found: ${filePath}`,
+                }],
+            shapesUsed: [],
+            quadCount: 0,
+            subjects: [],
+        };
+    }
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return validateTurtle(content, shapesStore, shapeFiles, filePath);
+}
+/**
+ * Recursively find all .ttl files in a directory.
+ */
+export function findTurtleFiles(dirPath) {
+    const results = [];
+    function walk(dir) {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                // Skip hidden directories and node_modules
+                if (!entry.name.startsWith('.') && entry.name !== 'node_modules') {
+                    walk(fullPath);
+                }
+            }
+            else if (entry.isFile() && entry.name.endsWith('.ttl')) {
+                results.push(fullPath);
+            }
+        }
+    }
+    walk(dirPath);
+    return results.sort();
+}
+//# sourceMappingURL=shacl-validator.js.map

package/dist/lib/shacl-validator.js.map

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

package/dist/lib/turtle-parser.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Turtle parsing utilities.
+ *
+ * Wraps the n3 library to provide Cascade-specific Turtle parsing
+ * with support for Cascade Protocol namespaces.
+ */
+import { Store } from 'n3';
+import type { Quad } from 'n3';
+/** Known Cascade Protocol namespace prefixes */
+export declare const CASCADE_NAMESPACES: Record<string, string>;
+export interface ParseResult {
+    success: boolean;
+    quads: Quad[];
+    store: Store;
+    quadCount: number;
+    prefixes: Record<string, string>;
+    errors: string[];
+    subjects: SubjectInfo[];
+}
+export interface SubjectInfo {
+    uri: string;
+    types: string[];
+}
+/**
+ * Parse a Turtle string into quads and a Store.
+ */
+export declare function parseTurtle(input: string, baseIRI?: string): ParseResult;
+/**
+ * Detect which Cascade Protocol vocabularies are used in a parsed Turtle file
+ * based on prefixes and type URIs.
+ */
+export declare function detectVocabularies(result: ParseResult): string[];
+/**
+ * Parse a Turtle file from disk.
+ */
+export declare function parseTurtleFile(filePath: string): Promise<ParseResult>;
+/**
+ * Return all subject URIs that have rdf:type matching the given type IRI.
+ */
+export declare function getSubjectsByType(store: Store, rdfType: string): string[];
+/**
+ * Return all predicate-value pairs for a given subject.
+ * Returns a map of predicate IRI -> array of object values.
+ */
+export declare function getProperties(store: Store, subject: string): Record<string, string[]>;
+/**
+ * Count subjects of a given rdf:type.
+ */
+export declare function countSubjectsByType(store: Store, rdfType: string): number;
+/**
+ * Get all unique rdf:type values in the store.
+ */
+export declare function getAllTypes(store: Store): string[];
+/**
+ * Shorten a full IRI using known Cascade namespace prefixes.
+ * Returns the prefixed form (e.g., "health:MedicationRecord") or the full IRI if no match.
+ */
+export declare function shortenIRI(iri: string, prefixes?: Record<string, string>): string;
+/**
+ * Extract a human-readable label for a record from its properties.
+ * Tries common name predicates in order of preference.
+ */
+export declare function extractLabel(props: Record<string, string[]>): string | undefined;
+//# sourceMappingURL=turtle-parser.d.ts.map

package/dist/lib/turtle-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turtle-parser.d.ts","sourceRoot":"","sources":["../../src/lib/turtle-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAU,KAAK,EAAe,MAAM,IAAI,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAQ/B,gDAAgD;AAChD,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQ5C,CAAC;AAoBX,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,CAqCxE;AAqBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,CAoChE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAgB5E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAGzE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAarF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,CAOlD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAajF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,GAAG,SAAS,CAuBhF"}