@supernal/interface 1.0.0

package/dist/cjs/src/testing/PlaywrightStateHelpers.js

@@ -0,0 +1,254 @@
+"use strict";
+/**
+ * Playwright Test Helpers for Browser State Injection
+ *
+ * Utilities for E2E tests to interact with component state
+ * using the browser state injection system.
+ *
+ * @module PlaywrightStateHelpers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setComponentState = setComponentState;
+exports.getComponentState = getComponentState;
+exports.resetComponentState = resetComponentState;
+exports.waitForComponent = waitForComponent;
+exports.hasComponent = hasComponent;
+exports.setComponentStateFromContract = setComponentStateFromContract;
+exports.assertComponentStateMatches = assertComponentStateMatches;
+exports.getComponentElement = getComponentElement;
+exports.initializeTestState = initializeTestState;
+exports.batchStateOperations = batchStateOperations;
+/**
+ * Set component state in the browser
+ *
+ * @param page - Playwright page object
+ * @param componentName - Component name from @Component decorator
+ * @param state - Partial state to merge
+ *
+ * @example
+ * ```typescript
+ * await setComponentState(page, 'counter', { count: 5 });
+ * ```
+ */
+async function setComponentState(page, componentName, state) {
+    await page.evaluate(({ component, newState }) => {
+        if (!window.__testState__) {
+            throw new Error('Test state manager not initialized. Did you forget to call initializeTestStateManager()?');
+        }
+        window.__testState__.setState(component, newState);
+    }, { component: componentName, newState: state });
+}
+/**
+ * Get component state from the browser
+ *
+ * @param page - Playwright page object
+ * @param componentName - Component name from @Component decorator
+ * @returns Current component state or undefined
+ *
+ * @example
+ * ```typescript
+ * const state = await getComponentState(page, 'counter');
+ * expect(state.count).toBe(5);
+ * ```
+ */
+async function getComponentState(page, componentName) {
+    return await page.evaluate((component) => {
+        if (!window.__testState__) {
+            throw new Error('Test state manager not initialized');
+        }
+        return window.__testState__.getState(component);
+    }, componentName);
+}
+/**
+ * Reset component to initial state
+ *
+ * @param page - Playwright page object
+ * @param componentName - Component name from @Component decorator
+ *
+ * @example
+ * ```typescript
+ * await resetComponentState(page, 'counter');
+ * ```
+ */
+async function resetComponentState(page, componentName) {
+    await page.evaluate((component) => {
+        if (!window.__testState__) {
+            throw new Error('Test state manager not initialized');
+        }
+        window.__testState__.resetState(component);
+    }, componentName);
+}
+/**
+ * Wait for component to be available in the DOM
+ *
+ * @param page - Playwright page object
+ * @param componentName - Component name from @Component decorator
+ * @param timeoutMs - Timeout in milliseconds (default: 5000)
+ *
+ * @example
+ * ```typescript
+ * await waitForComponent(page, 'counter');
+ * ```
+ */
+async function waitForComponent(page, componentName, timeoutMs = 5000) {
+    await page.evaluate(async ({ component, timeout }) => {
+        if (!window.__testState__) {
+            throw new Error('Test state manager not initialized');
+        }
+        await window.__testState__.waitForComponent(component, timeout);
+    }, { component: componentName, timeout: timeoutMs });
+}
+/**
+ * Check if component is available
+ *
+ * @param page - Playwright page object
+ * @param componentName - Component name from @Component decorator
+ * @returns True if component is rendered and available
+ *
+ * @example
+ * ```typescript
+ * const isAvailable = await hasComponent(page, 'counter');
+ * ```
+ */
+async function hasComponent(page, componentName) {
+    return await page.evaluate((component) => {
+        if (!window.__testState__) {
+            return false;
+        }
+        return window.__testState__.hasComponent(component);
+    }, componentName);
+}
+/**
+ * Set component state from a data contract
+ *
+ * @param page - Playwright page object
+ * @param componentName - Component name
+ * @param dataContract - Data contract object (e.g., ExamplesData.counter.state.five)
+ *
+ * @example
+ * ```typescript
+ * import { ExamplesData } from '@supernal-interface/core';
+ *
+ * await setComponentStateFromContract(
+ *   page,
+ *   'counter',
+ *   ExamplesData.counter.state.five
+ * );
+ * ```
+ */
+async function setComponentStateFromContract(page, componentName, dataContract) {
+    await setComponentState(page, componentName, dataContract);
+}
+/**
+ * Assert component state matches data contract
+ *
+ * @param page - Playwright page object
+ * @param componentName - Component name
+ * @param expectedContract - Expected data contract
+ *
+ * @example
+ * ```typescript
+ * await assertComponentStateMatches(
+ *   page,
+ *   'counter',
+ *   ExamplesData.counter.state.five
+ * );
+ * ```
+ */
+async function assertComponentStateMatches(page, componentName, expectedContract) {
+    const actualState = await getComponentState(page, componentName);
+    if (!actualState) {
+        throw new Error(`Component '${componentName}' state is undefined`);
+    }
+    // Deep equality check
+    const actualJson = JSON.stringify(actualState);
+    const expectedJson = JSON.stringify(expectedContract);
+    if (actualJson !== expectedJson) {
+        throw new Error(`Component '${componentName}' state does not match.\n` +
+            `Expected: ${expectedJson}\n` +
+            `Actual: ${actualJson}`);
+    }
+}
+/**
+ * Get component element by name
+ *
+ * @param page - Playwright page object
+ * @param componentName - Component name
+ * @returns Locator for the component element
+ *
+ * @example
+ * ```typescript
+ * const counter = getComponentElement(page, 'counter');
+ * await expect(counter).toBeVisible();
+ * ```
+ */
+function getComponentElement(page, componentName) {
+    return page.locator(`[data-component="${componentName}"]`);
+}
+/**
+ * Initialize test state manager in the browser
+ * Call this in beforeEach or at the start of tests
+ *
+ * @param page - Playwright page object
+ *
+ * @example
+ * ```typescript
+ * test.beforeEach(async ({ page }) => {
+ *   await initializeTestState(page);
+ * });
+ * ```
+ */
+async function initializeTestState(page) {
+    await page.evaluate(() => {
+        // Force initialize test state manager regardless of NODE_ENV
+        if (typeof window !== 'undefined' && !window.__testState__) {
+            // Create a minimal test state manager
+            window.__testState__ = {
+                states: new Map(),
+                getState(component) {
+                    return this.states.get(component);
+                },
+                setState(component, state) {
+                    const current = this.states.get(component) || {};
+                    this.states.set(component, { ...current, ...state });
+                },
+                resetState(component) {
+                    this.states.delete(component);
+                }
+            };
+            console.log('[TEST] Test state manager initialized in browser');
+        }
+    });
+}
+/**
+ * Batch state operations
+ * Useful for setting up complex test scenarios
+ *
+ * @param page - Playwright page object
+ * @param operations - Array of state operations
+ *
+ * @example
+ * ```typescript
+ * await batchStateOperations(page, [
+ *   { type: 'set', component: 'counter', state: { count: 5 } },
+ *   { type: 'set', component: 'chat', state: { messages: [] } },
+ *   { type: 'reset', component: 'form' },
+ * ]);
+ * ```
+ */
+async function batchStateOperations(page, operations) {
+    await page.evaluate((ops) => {
+        if (!window.__testState__) {
+            throw new Error('Test state manager not initialized');
+        }
+        for (const op of ops) {
+            if (op.type === 'set') {
+                window.__testState__.setState(op.component, op.state);
+            }
+            else if (op.type === 'reset') {
+                window.__testState__.resetState(op.component);
+            }
+        }
+    }, operations);
+}
+//# sourceMappingURL=PlaywrightStateHelpers.js.map

package/dist/cjs/src/testing/PlaywrightStateHelpers.js.map

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

package/dist/cjs/src/testing/TestRunner.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * Test Runner
+ *
+ * Orchestrates test generation and execution.
+ * Basic open-source version (TestGenerator and Story system are enterprise edition).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestRunner = void 0;
+// Enterprise features - not available in open source edition
+// import { TestGenerator } from '../generators/TestGenerator';
+// import { StoryRegistry, StoryExecutor } from '../background/stories';
+const GherkinParser_1 = require("./GherkinParser");
+const ToolRegistry_1 = require("../background/registry/ToolRegistry");
+class TestRunner {
+    /**
+     * Generate all test files
+     *
+     * NOTE: Full test generation is part of @supernal/interface-enterprise
+     * Open source edition includes basic Gherkin parsing only.
+     */
+    static async generateTests(options = {}) {
+        const tests = new Map();
+        // 1. Standard test generation - Enterprise feature
+        // const standardTests = TestGenerator.generateAllTests({...});
+        // Enterprise feature - see https://supernal.ai/enterprise
+        // 2. Generate Gherkin-based tests if requested (basic support)
+        if (options.includeGherkin) {
+            const gherkinTests = this.generateGherkinTests(options);
+            for (const [filename, content] of gherkinTests) {
+                tests.set(filename, content);
+            }
+        }
+        // 3. Story-based tests - Enterprise feature
+        if (options.includeStories) {
+            throw new Error('Story system is part of @supernal/interface-enterprise. ' +
+                'Visit https://supernal.ai/enterprise for more information.');
+        }
+        return tests;
+    }
+    /**
+     * Generate Gherkin feature files and tests
+     */
+    static generateGherkinTests(options) {
+        const files = new Map();
+        // Get tools grouped by category
+        const categories = new Set(ToolRegistry_1.ToolRegistry.getTools().map(t => t.category));
+        for (const category of categories) {
+            if (options.filterByCategory && category !== options.filterByCategory) {
+                continue;
+            }
+            const tools = ToolRegistry_1.ToolRegistry.getToolsByCategory(category);
+            if (tools.length === 0)
+                continue;
+            // Generate feature file
+            const featureName = `${category} Tools`;
+            const feature = GherkinParser_1.GherkinParser.generateFeature(featureName, tools, {
+                description: `Test ${category} tool interactions`,
+                tags: [category.toLowerCase(), 'generated']
+            });
+            files.set(`${category.toLowerCase()}.feature`, feature);
+            // Parse and generate Playwright test
+            const parsedFeature = GherkinParser_1.GherkinParser.parseFeature(feature);
+            const test = GherkinParser_1.GherkinParser.generatePlaywrightTest(parsedFeature);
+            files.set(`${category.toLowerCase()}.gherkin.spec.ts`, test);
+        }
+        return files;
+    }
+    /**
+     * Generate story-based test file
+     *
+     * NOTE: Story system is part of @supernal/interface-enterprise
+     */
+    static generateStoryTests(options) {
+        throw new Error('Story system is part of @supernal/interface-enterprise. ' +
+            'Visit https://supernal.ai/enterprise for more information.');
+    }
+    /**
+     * Generate documentation
+     *
+     * NOTE: Full documentation generation requires ToolPromptGenerator
+     * which is under review for open source vs enterprise.
+     */
+    static generateDocumentation() {
+        const docs = new Map();
+        // Basic registry overview (available in open source)
+        const overview = ToolRegistry_1.ToolRegistry.overview();
+        docs.set('REGISTRY_OVERVIEW.txt', overview);
+        // Advanced documentation - Enterprise feature
+        // const toolDocs = ToolPromptGenerator.generatePrompt('documentation', {...});
+        // const summary = ToolPromptGenerator.generateToolSummary();
+        return docs;
+    }
+    /**
+     * Write files to disk
+     */
+    static async writeFiles(files, outputDir) {
+        const fs = await Promise.resolve().then(() => __importStar(require('fs/promises')));
+        const path = await Promise.resolve().then(() => __importStar(require('path')));
+        // Ensure output directory exists
+        await fs.mkdir(outputDir, { recursive: true });
+        // Write each file
+        for (const [filename, content] of files) {
+            const filePath = path.join(outputDir, filename);
+            // Create subdirectories if needed
+            const dir = path.dirname(filePath);
+            await fs.mkdir(dir, { recursive: true });
+            await fs.writeFile(filePath, content, 'utf8');
+            console.log(`✅ Generated: ${filePath}`);
+        }
+    }
+    /**
+     * Generate and write all tests
+     */
+    static async generateAndWrite(options = {}) {
+        const outputDir = options.outputDir || './tests/generated';
+        console.log(`🔧 Generating tests...`);
+        const tests = await this.generateTests(options);
+        console.log(`📝 Writing ${tests.size} test files to ${outputDir}...`);
+        await this.writeFiles(tests, outputDir);
+        console.log(`✅ Test generation complete!`);
+    }
+}
+exports.TestRunner = TestRunner;
+//# sourceMappingURL=TestRunner.js.map

package/dist/cjs/src/testing/TestRunner.js.map

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

package/dist/cjs/src/testing/index.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Testing Utilities - Browser State Injection
+ *
+ * Provides complete testing infrastructure for component state management
+ * in E2E and integration tests.
+ *
+ * @module @supernal-interface/core/testing
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testIdEndsWith = exports.testIdStartsWith = exports.testIdContains = exports.tid = exports.testIds = exports.testId = exports.batchStateOperations = exports.initializeTestState = exports.getComponentElement = exports.assertComponentStateMatches = exports.setComponentStateFromContract = exports.hasComponent = exports.waitForComponent = exports.resetComponentState = exports.getComponentState = exports.setComponentState = exports.getTestStateManager = exports.initializeTestStateManager = void 0;
+// Browser-side utilities
+var BrowserStateInjection_1 = require("./BrowserStateInjection");
+Object.defineProperty(exports, "initializeTestStateManager", { enumerable: true, get: function () { return BrowserStateInjection_1.initializeTestStateManager; } });
+Object.defineProperty(exports, "getTestStateManager", { enumerable: true, get: function () { return BrowserStateInjection_1.getTestStateManager; } });
+// React hooks (enterprise feature - not in open source)
+// export {
+//   useTestStateInjection,
+//   useTestStateAttributes,
+//   useTestState,
+//   setupTestStateInjection,
+// } from './useTestStateInjection';
+// Playwright helpers
+var PlaywrightStateHelpers_1 = require("./PlaywrightStateHelpers");
+Object.defineProperty(exports, "setComponentState", { enumerable: true, get: function () { return PlaywrightStateHelpers_1.setComponentState; } });
+Object.defineProperty(exports, "getComponentState", { enumerable: true, get: function () { return PlaywrightStateHelpers_1.getComponentState; } });
+Object.defineProperty(exports, "resetComponentState", { enumerable: true, get: function () { return PlaywrightStateHelpers_1.resetComponentState; } });
+Object.defineProperty(exports, "waitForComponent", { enumerable: true, get: function () { return PlaywrightStateHelpers_1.waitForComponent; } });
+Object.defineProperty(exports, "hasComponent", { enumerable: true, get: function () { return PlaywrightStateHelpers_1.hasComponent; } });
+Object.defineProperty(exports, "setComponentStateFromContract", { enumerable: true, get: function () { return PlaywrightStateHelpers_1.setComponentStateFromContract; } });
+Object.defineProperty(exports, "assertComponentStateMatches", { enumerable: true, get: function () { return PlaywrightStateHelpers_1.assertComponentStateMatches; } });
+Object.defineProperty(exports, "getComponentElement", { enumerable: true, get: function () { return PlaywrightStateHelpers_1.getComponentElement; } });
+Object.defineProperty(exports, "initializeTestState", { enumerable: true, get: function () { return PlaywrightStateHelpers_1.initializeTestState; } });
+Object.defineProperty(exports, "batchStateOperations", { enumerable: true, get: function () { return PlaywrightStateHelpers_1.batchStateOperations; } });
+// Test selectors
+var selectors_1 = require("./selectors");
+Object.defineProperty(exports, "testId", { enumerable: true, get: function () { return selectors_1.testId; } });
+Object.defineProperty(exports, "testIds", { enumerable: true, get: function () { return selectors_1.testIds; } });
+Object.defineProperty(exports, "tid", { enumerable: true, get: function () { return selectors_1.tid; } });
+Object.defineProperty(exports, "testIdContains", { enumerable: true, get: function () { return selectors_1.testIdContains; } });
+Object.defineProperty(exports, "testIdStartsWith", { enumerable: true, get: function () { return selectors_1.testIdStartsWith; } });
+Object.defineProperty(exports, "testIdEndsWith", { enumerable: true, get: function () { return selectors_1.testIdEndsWith; } });
+// NOTE: ComponentStateHelpers are NOT exported here because they import Playwright
+// which cannot be bundled in client code. Import directly in test files:
+// import { assertComponentState } from '@supernal-interface/core/testing/ComponentStateHelpers';
+//# sourceMappingURL=index.js.map

package/dist/cjs/src/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/testing/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,yBAAyB;AACzB,iEAMiC;AAL/B,mIAAA,0BAA0B,OAAA;AAC1B,4HAAA,mBAAmB,OAAA;AAMrB,wDAAwD;AACxD,WAAW;AACX,2BAA2B;AAC3B,4BAA4B;AAC5B,kBAAkB;AAClB,6BAA6B;AAC7B,oCAAoC;AAEpC,qBAAqB;AACrB,mEAWkC;AAVhC,2HAAA,iBAAiB,OAAA;AACjB,2HAAA,iBAAiB,OAAA;AACjB,6HAAA,mBAAmB,OAAA;AACnB,0HAAA,gBAAgB,OAAA;AAChB,sHAAA,YAAY,OAAA;AACZ,uIAAA,6BAA6B,OAAA;AAC7B,qIAAA,2BAA2B,OAAA;AAC3B,6HAAA,mBAAmB,OAAA;AACnB,6HAAA,mBAAmB,OAAA;AACnB,8HAAA,oBAAoB,OAAA;AAGtB,iBAAiB;AACjB,yCAOqB;AANnB,mGAAA,MAAM,OAAA;AACN,oGAAA,OAAO,OAAA;AACP,gGAAA,GAAG,OAAA;AACH,2GAAA,cAAc,OAAA;AACd,6GAAA,gBAAgB,OAAA;AAChB,2GAAA,cAAc,OAAA;AAGhB,mFAAmF;AACnF,yEAAyE;AACzE,iGAAiG"}

package/dist/cjs/src/testing/selectors.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * Testing Selector Helpers
+ *
+ * Utilities for converting component name contracts to test selectors.
+ * Reduces boilerplate and ensures consistency across test files.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tid = void 0;
+exports.testId = testId;
+exports.testIds = testIds;
+exports.testIdContains = testIdContains;
+exports.testIdStartsWith = testIdStartsWith;
+exports.testIdEndsWith = testIdEndsWith;
+/**
+ * Convert a component name (from name contracts) to a data-testid selector
+ *
+ * @example
+ * ```typescript
+ * import { Chat } from '../architecture/DemoComponentNames';
+ * import { testId } from '@supernal-interface/core/testing';
+ *
+ * const input = page.locator(testId(Chat.input));
+ * // Equivalent to: page.locator('[data-testid="chat-input"]')
+ * ```
+ */
+function testId(componentId) {
+    return `[data-testid="${componentId}"]`;
+}
+/**
+ * Create multiple selectors at once
+ *
+ * @example
+ * ```typescript
+ * const selectors = testIds({
+ *   input: Chat.input,
+ *   button: Chat.sendButton
+ * });
+ *
+ * await page.locator(selectors.input).fill('hello');
+ * await page.locator(selectors.button).click();
+ * ```
+ */
+function testIds(ids) {
+    return Object.entries(ids).reduce((acc, [key, value]) => {
+        acc[key] = testId(value);
+        return acc;
+    }, {});
+}
+/**
+ * Alias for testId - shorter for repetitive use
+ */
+exports.tid = testId;
+/**
+ * Create a selector for elements with partial testid match
+ *
+ * @example
+ * ```typescript
+ * // Find all chat messages
+ * const messages = page.locator(testIdContains('chat-message'));
+ * ```
+ */
+function testIdContains(partial) {
+    return `[data-testid*="${partial}"]`;
+}
+/**
+ * Create a selector for elements with testid starting with prefix
+ *
+ * @example
+ * ```typescript
+ * // Find all navigation elements
+ * const navElements = page.locator(testIdStartsWith('nav-'));
+ * ```
+ */
+function testIdStartsWith(prefix) {
+    return `[data-testid^="${prefix}"]`;
+}
+/**
+ * Create a selector for elements with testid ending with suffix
+ */
+function testIdEndsWith(suffix) {
+    return `[data-testid$="${suffix}"]`;
+}
+//# sourceMappingURL=selectors.js.map

package/dist/cjs/src/testing/selectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.js","sourceRoot":"","sources":["../../../../src/testing/selectors.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAcH,wBAEC;AAgBD,0BAOC;AAgBD,wCAEC;AAWD,4CAEC;AAKD,wCAEC;AA3ED;;;;;;;;;;;GAWG;AACH,SAAgB,MAAM,CAAC,WAAmB;IACxC,OAAO,iBAAiB,WAAW,IAAI,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,OAAO,CACrB,GAAM;IAEN,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACtD,GAAG,CAAC,GAAc,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QACpC,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAgC,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACU,QAAA,GAAG,GAAG,MAAM,CAAC;AAE1B;;;;;;;;GAQG;AACH,SAAgB,cAAc,CAAC,OAAe;IAC5C,OAAO,kBAAkB,OAAO,IAAI,CAAC;AACvC,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,gBAAgB,CAAC,MAAc;IAC7C,OAAO,kBAAkB,MAAM,IAAI,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,MAAc;IAC3C,OAAO,kBAAkB,MAAM,IAAI,CAAC;AACtC,CAAC"}