@_linked/core 1.0.0 → 1.2.0-next.20260302120536

package/lib/esm/sparql/sparqlUtils.js

@@ -0,0 +1,82 @@
+import { Prefix } from '../utils/Prefix.js';
+import { ulid } from 'ulid';
+/**
+ * Format a URI for SPARQL output.
+ * Returns prefixed form (e.g. `rdf:type`) if a prefix is registered and the
+ * suffix doesn't contain `/`. Otherwise returns `<full-uri>`.
+ */
+export function formatUri(uri) {
+    const prefixed = Prefix.toPrefixed(uri);
+    if (prefixed)
+        return prefixed;
+    return `<${uri}>`;
+}
+/**
+ * Escapes special characters in a string for use inside SPARQL double-quoted literals.
+ * Per SPARQL 1.1 §19.7 (Escape sequences in strings).
+ */
+export function escapeSparqlString(value) {
+    return value
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '\\r')
+        .replace(/\t/g, '\\t');
+}
+/**
+ * Format a literal value for SPARQL output.
+ * Returns a quoted string with optional `^^<datatype>` suffix.
+ * Special characters in the value are escaped per SPARQL spec.
+ */
+export function formatLiteral(value, datatype) {
+    let lexical;
+    if (value instanceof Date) {
+        lexical = value.toISOString();
+    }
+    else {
+        lexical = String(value);
+    }
+    const escaped = escapeSparqlString(lexical);
+    if (datatype) {
+        return `"${escaped}"^^${formatUri(datatype)}`;
+    }
+    return `"${escaped}"`;
+}
+/**
+ * Collect the minimal set of prefix→URI mappings needed for a set of URIs.
+ * Only includes prefixes that are actually used (i.e. `Prefix.toPrefixed`
+ * returns a value for at least one URI in the list).
+ */
+export function collectPrefixes(usedUris) {
+    const result = {};
+    for (const uri of usedUris) {
+        const match = Prefix.findMatch(uri);
+        if (match.length > 0) {
+            const [ontologyUri, prefix, postFix] = match;
+            // Only include if the postfix is actually prefixable (no `/`)
+            if (!postFix.includes('/')) {
+                result[prefix] = ontologyUri;
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Generate a new entity URI for a create mutation.
+ * Format: `{dataRoot}/{lowercaseShapeLabel}_{ulid}`
+ */
+export function generateEntityUri(shape, options) {
+    const dataRoot = (options === null || options === void 0 ? void 0 : options.dataRoot) || process.env.DATA_ROOT || 'http://example.org/data';
+    // Extract the shape label from the full URI (last segment after # or /)
+    let label;
+    const hashIdx = shape.lastIndexOf('#');
+    if (hashIdx >= 0) {
+        label = shape.substring(hashIdx + 1);
+    }
+    else {
+        const slashIdx = shape.lastIndexOf('/');
+        label = slashIdx >= 0 ? shape.substring(slashIdx + 1) : shape;
+    }
+    return `${dataRoot}/${label.toLowerCase()}_${ulid()}`;
+}
+//# sourceMappingURL=sparqlUtils.js.map

package/lib/esm/sparql/sparqlUtils.js.map

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

package/lib/esm/test-helpers/FusekiStore.d.ts

@@ -0,0 +1,29 @@
+import { SparqlStore } from '../sparql/SparqlStore.js';
+import type { SparqlJsonResults } from '../sparql/resultMapping.js';
+import type { SparqlOptions } from '../sparql/sparqlUtils.js';
+/**
+ * Concrete SparqlStore implementation for Apache Jena Fuseki.
+ *
+ * Demonstrates how to extend SparqlStore with a real SPARQL endpoint.
+ * Used by the integration tests to implicitly validate the base class.
+ *
+ * Usage:
+ * ```ts
+ * const store = new FusekiStore('http://localhost:3030', 'my-dataset');
+ * await store.init();
+ * const result = await store.selectQuery(irSelectQuery);
+ * ```
+ */
+export declare class FusekiStore extends SparqlStore {
+    private readonly queryEndpoint;
+    private readonly updateEndpoint;
+    private readonly baseUrl;
+    private readonly dataset;
+    private readonly adminAuth?;
+    constructor(baseUrl: string, dataset: string, options?: SparqlOptions & {
+        adminPassword?: string;
+    });
+    init(): Promise<void>;
+    protected executeSparqlSelect(sparql: string): Promise<SparqlJsonResults>;
+    protected executeSparqlUpdate(sparql: string): Promise<void>;
+}

package/lib/esm/test-helpers/FusekiStore.js

@@ -0,0 +1,78 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { SparqlStore } from '../sparql/SparqlStore.js';
+/**
+ * Concrete SparqlStore implementation for Apache Jena Fuseki.
+ *
+ * Demonstrates how to extend SparqlStore with a real SPARQL endpoint.
+ * Used by the integration tests to implicitly validate the base class.
+ *
+ * Usage:
+ * ```ts
+ * const store = new FusekiStore('http://localhost:3030', 'my-dataset');
+ * await store.init();
+ * const result = await store.selectQuery(irSelectQuery);
+ * ```
+ */
+export class FusekiStore extends SparqlStore {
+    constructor(baseUrl, dataset, options) {
+        super(options);
+        this.baseUrl = baseUrl;
+        this.dataset = dataset;
+        this.queryEndpoint = `${baseUrl}/${dataset}/sparql`;
+        this.updateEndpoint = `${baseUrl}/${dataset}/update`;
+        if (options === null || options === void 0 ? void 0 : options.adminPassword) {
+            this.adminAuth = `Basic ${Buffer.from(`admin:${options.adminPassword}`).toString('base64')}`;
+        }
+    }
+    init() {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Check availability
+            const response = yield fetch(this.baseUrl, {
+                method: 'HEAD',
+                signal: AbortSignal.timeout(2000),
+            });
+            if (response.status !== 200) {
+                throw new Error(`Fuseki not available at ${this.baseUrl}`);
+            }
+        });
+    }
+    executeSparqlSelect(sparql) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield fetch(this.queryEndpoint, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/sparql-query',
+                    Accept: 'application/sparql-results+json',
+                },
+                body: sparql,
+            });
+            if (!response.ok) {
+                const body = yield response.text();
+                throw new Error(`SPARQL query failed: ${response.status} ${response.statusText}\n${sparql}\n${body}`);
+            }
+            return response.json();
+        });
+    }
+    executeSparqlUpdate(sparql) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield fetch(this.updateEndpoint, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/sparql-update' },
+                body: sparql,
+            });
+            if (!response.ok) {
+                const body = yield response.text();
+                throw new Error(`SPARQL update failed: ${response.status} ${response.statusText}\n${sparql}\n${body}`);
+            }
+        });
+    }
+}
+//# sourceMappingURL=FusekiStore.js.map

package/lib/esm/test-helpers/FusekiStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FusekiStore.js","sourceRoot":"","sources":["../../../src/test-helpers/FusekiStore.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,0BAA0B,CAAC;AAIrD;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,WAAY,SAAQ,WAAW;IAO1C,YACE,OAAe,EACf,OAAe,EACf,OAAkD;QAElD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,GAAG,OAAO,IAAI,OAAO,SAAS,CAAC;QACpD,IAAI,CAAC,cAAc,GAAG,GAAG,OAAO,IAAI,OAAO,SAAS,CAAC;QAErD,IAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,aAAa,EAAE,CAAC;YAC3B,IAAI,CAAC,SAAS,GAAG,SAAS,MAAM,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/F,CAAC;IACH,CAAC;IAEK,IAAI;;YACR,qBAAqB;YACrB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE;gBACzC,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;aAClC,CAAC,CAAC;YACH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;KAAA;IAEe,mBAAmB,CACjC,MAAc;;YAEd,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE;gBAC/C,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,0BAA0B;oBAC1C,MAAM,EAAE,iCAAiC;iBAC1C;gBACD,IAAI,EAAE,MAAM;aACb,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CACb,wBAAwB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,KAAK,MAAM,KAAK,IAAI,EAAE,CACrF,CAAC;YACJ,CAAC;YAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;QACzB,CAAC;KAAA;IAEe,mBAAmB,CAAC,MAAc;;YAChD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE;gBAChD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAC,cAAc,EAAE,2BAA2B,EAAC;gBACtD,IAAI,EAAE,MAAM;aACb,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CACb,yBAAyB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,KAAK,MAAM,KAAK,IAAI,EAAE,CACtF,CAAC;YACJ,CAAC;QACH,CAAC;KAAA;CACF"}

package/lib/esm/test-helpers/fuseki-test-store.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Test helper module for Apache Jena Fuseki integration tests.
+ *
+ * Provides utilities to:
+ * - Check if a Fuseki instance is available
+ * - Create / delete an in-memory test dataset
+ * - Load N-Triples data
+ * - Execute SPARQL queries and updates
+ * - Clear all data
+ *
+ * Uses native fetch (Node 18+). No external HTTP libraries.
+ */
+/**
+ * Check whether a Fuseki server is reachable.
+ * Returns true if a HEAD request to the base URL succeeds with status 200.
+ */
+export declare function isFusekiAvailable(): Promise<boolean>;
+/**
+ * Create the in-memory test dataset on Fuseki.
+ * Ignores 409 Conflict (dataset already exists).
+ */
+export declare function createTestDataset(): Promise<void>;
+/**
+ * Delete the test dataset from Fuseki.
+ */
+export declare function deleteTestDataset(): Promise<void>;
+/**
+ * Load N-Triples data into the test dataset.
+ */
+export declare function loadTestData(ntriples: string): Promise<void>;
+/**
+ * Execute a SPARQL SELECT/ASK/CONSTRUCT query against the test dataset.
+ * Returns parsed SPARQL JSON results.
+ */
+export declare function executeSparqlQuery(sparql: string): Promise<any>;
+/**
+ * Execute a SPARQL UPDATE against the test dataset.
+ */
+export declare function executeSparqlUpdate(sparql: string): Promise<void>;
+/**
+ * Remove all triples from the test dataset.
+ */
+export declare function clearAllData(): Promise<void>;

package/lib/esm/test-helpers/fuseki-test-store.js

@@ -0,0 +1,135 @@
+/**
+ * Test helper module for Apache Jena Fuseki integration tests.
+ *
+ * Provides utilities to:
+ * - Check if a Fuseki instance is available
+ * - Create / delete an in-memory test dataset
+ * - Load N-Triples data
+ * - Execute SPARQL queries and updates
+ * - Clear all data
+ *
+ * Uses native fetch (Node 18+). No external HTTP libraries.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+const FUSEKI_BASE_URL = process.env.FUSEKI_BASE_URL || 'http://localhost:3030';
+const FUSEKI_ADMIN_PASSWORD = process.env.FUSEKI_ADMIN_PASSWORD || 'admin';
+const DATASET_NAME = 'nashville-test';
+const adminAuth = `Basic ${Buffer.from(`admin:${FUSEKI_ADMIN_PASSWORD}`).toString('base64')}`;
+/**
+ * Check whether a Fuseki server is reachable.
+ * Returns true if a HEAD request to the base URL succeeds with status 200.
+ */
+export function isFusekiAvailable() {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const response = yield fetch(FUSEKI_BASE_URL, {
+                method: 'HEAD',
+                signal: AbortSignal.timeout(2000),
+            });
+            return response.status === 200;
+        }
+        catch (_a) {
+            return false;
+        }
+    });
+}
+/**
+ * Create the in-memory test dataset on Fuseki.
+ * Ignores 409 Conflict (dataset already exists).
+ */
+export function createTestDataset() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const response = yield fetch(`${FUSEKI_BASE_URL}/$/datasets`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/x-www-form-urlencoded',
+                Authorization: adminAuth,
+            },
+            body: `dbName=${DATASET_NAME}&dbType=mem`,
+        });
+        if (!response.ok && response.status !== 409) {
+            throw new Error(`Failed to create test dataset: ${response.status} ${response.statusText}`);
+        }
+    });
+}
+/**
+ * Delete the test dataset from Fuseki.
+ */
+export function deleteTestDataset() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const response = yield fetch(`${FUSEKI_BASE_URL}/$/datasets/${DATASET_NAME}`, { method: 'DELETE', headers: { Authorization: adminAuth } });
+        if (!response.ok && response.status !== 404) {
+            throw new Error(`Failed to delete test dataset: ${response.status} ${response.statusText}`);
+        }
+    });
+}
+/**
+ * Load N-Triples data into the test dataset.
+ */
+export function loadTestData(ntriples) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const response = yield fetch(`${FUSEKI_BASE_URL}/${DATASET_NAME}`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/n-triples' },
+            body: ntriples,
+        });
+        if (!response.ok) {
+            const body = yield response.text();
+            throw new Error(`Failed to load test data: ${response.status} ${response.statusText}\n${body}`);
+        }
+    });
+}
+/**
+ * Execute a SPARQL SELECT/ASK/CONSTRUCT query against the test dataset.
+ * Returns parsed SPARQL JSON results.
+ */
+export function executeSparqlQuery(sparql) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const response = yield fetch(`${FUSEKI_BASE_URL}/${DATASET_NAME}/sparql`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/sparql-query',
+                Accept: 'application/sparql-results+json',
+            },
+            body: sparql,
+        });
+        if (!response.ok) {
+            const body = yield response.text();
+            throw new Error(`SPARQL query failed: ${response.status} ${response.statusText}\n${sparql}\n${body}`);
+        }
+        return response.json();
+    });
+}
+/**
+ * Execute a SPARQL UPDATE against the test dataset.
+ */
+export function executeSparqlUpdate(sparql) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const response = yield fetch(`${FUSEKI_BASE_URL}/${DATASET_NAME}/update`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/sparql-update' },
+            body: sparql,
+        });
+        if (!response.ok) {
+            const body = yield response.text();
+            throw new Error(`SPARQL update failed: ${response.status} ${response.statusText}\n${sparql}\n${body}`);
+        }
+    });
+}
+/**
+ * Remove all triples from the test dataset.
+ */
+export function clearAllData() {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield executeSparqlUpdate('DELETE WHERE { ?s ?p ?o }');
+    });
+}
+//# sourceMappingURL=fuseki-test-store.js.map

package/lib/esm/test-helpers/fuseki-test-store.js.map

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

package/lib/esm/test-helpers/query-capture-store.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Execute a query-producing callback and return whatever
+ * the capture intercepted.
+ */
+export declare const captureQuery: (runner: () => Promise<unknown>) => Promise<any>;

package/lib/esm/test-helpers/query-capture-store.js

@@ -0,0 +1,55 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { jest } from '@jest/globals';
+import { QueryParser } from '../queries/QueryParser';
+import { UpdateQueryFactory } from '../queries/UpdateQuery';
+import { CreateQueryFactory } from '../queries/CreateQuery';
+import { DeleteQueryFactory } from '../queries/DeleteQuery';
+/**
+ * Test utility that intercepts QueryParser methods via jest.spyOn and captures
+ * the query object for inspection by test assertions.
+ *
+ * For select queries, captures the RawSelectInput (pipeline input format).
+ * For mutations, captures the IR (canonical format).
+ *
+ * Import this module and call `captureQuery(runner)` to execute a DSL
+ * call (e.g. Person.select(...)) and retrieve the captured query.
+ */
+let _lastQuery;
+jest.spyOn(QueryParser, 'selectQuery').mockImplementation((query) => __awaiter(void 0, void 0, void 0, function* () {
+    _lastQuery = query.toRawInput();
+    return [];
+}));
+jest.spyOn(QueryParser, 'createQuery').mockImplementation((updateObjectOrFn, shapeClass) => __awaiter(void 0, void 0, void 0, function* () {
+    const factory = new CreateQueryFactory(shapeClass, updateObjectOrFn);
+    _lastQuery = factory.build();
+    return {};
+}));
+jest.spyOn(QueryParser, 'updateQuery').mockImplementation((id, updateObjectOrFn, shapeClass) => __awaiter(void 0, void 0, void 0, function* () {
+    const factory = new UpdateQueryFactory(shapeClass, id, updateObjectOrFn);
+    _lastQuery = factory.build();
+    return {};
+}));
+jest.spyOn(QueryParser, 'deleteQuery').mockImplementation((id, shapeClass) => __awaiter(void 0, void 0, void 0, function* () {
+    const ids = (Array.isArray(id) ? id : [id]);
+    const factory = new DeleteQueryFactory(shapeClass, ids);
+    _lastQuery = factory.build();
+    return { deleted: [], count: 0 };
+}));
+/**
+ * Execute a query-producing callback and return whatever
+ * the capture intercepted.
+ */
+export const captureQuery = (runner) => __awaiter(void 0, void 0, void 0, function* () {
+    _lastQuery = undefined;
+    yield runner();
+    return _lastQuery;
+});
+//# sourceMappingURL=query-capture-store.js.map

package/lib/esm/test-helpers/query-capture-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-capture-store.js","sourceRoot":"","sources":["../../../src/test-helpers/query-capture-store.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,eAAe,CAAC;AACnC,OAAO,EAAC,WAAW,EAAC,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAC,kBAAkB,EAAC,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAC,kBAAkB,EAAC,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAC,kBAAkB,EAAC,MAAM,wBAAwB,CAAC;AAG1D;;;;;;;;;GASG;AACH,IAAI,UAAe,CAAC;AAEpB,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,kBAAkB,CAAC,CAAO,KAAU,EAAE,EAAE;IAC7E,UAAU,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;IAChC,OAAO,EAAS,CAAC;AACnB,CAAC,CAAA,CAAC,CAAC;AAEH,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,kBAAkB,CACvD,CAAO,gBAAqB,EAAE,UAAe,EAAE,EAAE;IAC/C,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IACrE,UAAU,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAC7B,OAAO,EAAS,CAAC;AACnB,CAAC,CAAA,CACF,CAAC;AAEF,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,kBAAkB,CACvD,CAAO,EAAO,EAAE,gBAAqB,EAAE,UAAe,EAAE,EAAE;IACxD,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,UAAU,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC;IACzE,UAAU,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAC7B,OAAO,EAAS,CAAC;AACnB,CAAC,CAAA,CACF,CAAC;AAEF,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC,kBAAkB,CACvD,CAAO,EAAO,EAAE,UAAe,EAAE,EAAE;IACjC,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAa,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACxD,UAAU,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAC7B,OAAO,EAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAC,CAAC;AACjC,CAAC,CAAA,CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,MAA8B,EAC9B,EAAE;IACF,UAAU,GAAG,SAAS,CAAC;IACvB,MAAM,MAAM,EAAE,CAAC;IACf,OAAO,UAAU,CAAC;AACpB,CAAC,CAAA,CAAC"}