@oddkin/workbench 0.0.0-stage → 1.0.0-beta.1

package/dist/protocol/index.d.ts

@@ -0,0 +1,222 @@
+/** DOM-free message contracts shared by the Workbench host and preview frames. */
+export declare const FRAME_PROTOCOL = "oddkin.frame";
+export declare const FRAME_PROTOCOL_VERSION = 1;
+export type JsonValue = null | boolean | number | string | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+export type ExampleId = `example:${string}/${string}`;
+export type EventId = `event:${string}#${string}`;
+export type PropertyId = `property:${string}#${string}`;
+export interface FrameIdentity {
+    readonly frame: string;
+    readonly generation: number;
+}
+export interface FrameSettings {
+    readonly viewport?: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly container?: {
+        readonly width: number;
+        readonly height?: number;
+    };
+    readonly direction?: 'ltr' | 'rtl';
+    readonly mode?: 'light' | 'dark';
+    readonly density?: string;
+    readonly product?: string;
+    readonly profile?: string;
+}
+export interface FrameMountPayload {
+    readonly tag: string;
+    readonly registration: string;
+    readonly example: ExampleId;
+    readonly properties?: Readonly<Record<string, JsonValue>>;
+    readonly attributes?: Readonly<Record<string, string | null>>;
+    readonly slots?: Readonly<Record<string, string>>;
+    readonly events?: readonly string[];
+    /**
+     * Declared property ↔ event sync pairs (metadata `syncPairs`). After such an event the frame
+     * reports the property's value in a `state` notification (`{ property, value }`); nothing is
+     * inferred from event names.
+     */
+    readonly sync?: readonly {
+        readonly property: string;
+        readonly event: string;
+    }[];
+    /** CSS custom property values set on the element (`style.setProperty`); names start with `--`. */
+    readonly styles?: Readonly<Record<string, string>>;
+    /**
+     * URL of the example module (a `defineExamples` default export) whose fixture for `example`
+     * runs after the element is connected, as `mountExample` runs it in tests.
+     */
+    readonly fixture?: string;
+    readonly settings?: FrameSettings;
+}
+/**
+ * One write: a property (a value, or `unset`), an attribute (a string, or `null` to remove it), or
+ * a CSS custom property on the element's style (a value, or `null` to remove it).
+ */
+export interface FrameSetPayload {
+    readonly property?: string;
+    readonly value?: JsonValue;
+    readonly unset?: boolean;
+    readonly attribute?: string;
+    readonly attributeValue?: string | null;
+    readonly cssProperty?: string;
+    readonly cssValue?: string | null;
+}
+export interface FrameSlotPayload {
+    readonly name: string;
+    readonly text: string;
+}
+/** One element per preview role, mounted together (Theme Studio specimens). */
+export interface FrameSpecimenItem extends FrameMountPayload {
+    /** The preview role this element plays, e.g. `primaryAction`. */
+    readonly role: string;
+    /** Visible caption naming the role. */
+    readonly label: string;
+}
+export interface FrameSpecimenPayload {
+    readonly items: readonly FrameSpecimenItem[];
+    readonly settings?: FrameSettings;
+}
+export interface FrameThemePayload {
+    readonly cssText: string;
+}
+export interface InspectPreviewRequest {
+    /** Stable example id, e.g. `example:odd-button/primary`. */
+    readonly example: ExampleId;
+    readonly settings?: FrameSettings;
+    readonly properties?: Readonly<Record<string, JsonValue>>;
+    readonly slots?: Readonly<Record<string, string>>;
+    readonly interactions?: readonly {
+        readonly id: EventId;
+        readonly event: string;
+        readonly target?: string;
+    }[];
+    readonly limits?: {
+        readonly errors?: number;
+        readonly events?: number;
+        readonly state?: number;
+        readonly checks?: number;
+    };
+}
+export interface InspectPreviewResponse {
+    readonly errors: readonly {
+        readonly id: EventId;
+        readonly phase: string;
+        readonly message: string;
+    }[];
+    readonly events: readonly {
+        readonly id: EventId;
+        readonly name: string;
+        readonly time: number;
+        readonly bubbles: boolean;
+        readonly composed: boolean;
+        readonly cancelable: boolean;
+        readonly detail?: JsonValue;
+    }[];
+    readonly state: readonly {
+        readonly id: PropertyId;
+        readonly value: JsonValue;
+    }[];
+    readonly checks: readonly {
+        readonly id: string;
+        readonly status: 'pass' | 'fail' | 'skip';
+        readonly engine: string;
+        readonly version: string;
+        readonly configuration: JsonValue;
+        readonly verification: string;
+    }[];
+    readonly conditions: JsonValue;
+    readonly engine: string;
+    readonly version: string;
+    readonly configuration: JsonValue;
+    readonly truncated: {
+        readonly errors: boolean;
+        readonly events: boolean;
+        readonly state: boolean;
+        readonly checks: boolean;
+    };
+}
+interface Envelope extends FrameIdentity {
+    readonly protocol: typeof FRAME_PROTOCOL;
+    readonly version: number;
+}
+export interface FrameHello extends Envelope {
+    readonly kind: 'hello';
+}
+export interface FrameConnect extends Envelope {
+    readonly kind: 'connect';
+}
+export type FrameRequest = (Envelope & {
+    readonly kind: 'mount';
+    readonly id: number;
+    readonly payload: FrameMountPayload;
+}) | (Envelope & {
+    readonly kind: 'specimen';
+    readonly id: number;
+    readonly payload: FrameSpecimenPayload;
+}) | (Envelope & {
+    readonly kind: 'set';
+    readonly id: number;
+    readonly payload: FrameSetPayload;
+}) | (Envelope & {
+    readonly kind: 'slot';
+    readonly id: number;
+    readonly payload: FrameSlotPayload;
+}) | (Envelope & {
+    readonly kind: 'reset';
+    readonly id: number;
+}) | (Envelope & {
+    readonly kind: 'dispose';
+    readonly id: number;
+}) | (Envelope & {
+    readonly kind: 'theme';
+    readonly id: number;
+    readonly payload: FrameThemePayload;
+}) | (Envelope & {
+    readonly kind: 'settings';
+    readonly id: number;
+    readonly payload: FrameSettings;
+}) | (Envelope & {
+    readonly kind: 'inspect';
+    readonly id: number;
+    readonly payload: InspectPreviewRequest;
+});
+export interface FrameReply extends Envelope {
+    readonly kind: 'reply';
+    readonly replyTo: number;
+    readonly payload?: JsonValue;
+    readonly error?: {
+        readonly code: string;
+        readonly message: string;
+    };
+}
+export interface FrameNotification extends Envelope {
+    readonly kind: 'event' | 'error' | 'state' | 'size';
+    readonly payload?: JsonValue;
+}
+export type FrameRequestPayload = Extract<FrameRequest, {
+    readonly payload: unknown;
+}>['payload'];
+export type FrameMessage = FrameHello | FrameConnect | FrameRequest | FrameReply | FrameNotification;
+/** True only for finite, acyclic data that can be transferred as plain JSON without coercion. */
+export declare function isJsonValue(value: unknown): value is JsonValue;
+/** A CSS custom property name: `--` and at least one more character, no spaces or colons. */
+export declare const isCustomPropertyName: (value: unknown) => value is string;
+export declare const isExampleId: (value: unknown) => value is ExampleId;
+export declare function isFrameMountPayload(value: unknown): value is FrameMountPayload;
+export declare function isFrameSpecimenPayload(value: unknown): value is FrameSpecimenPayload;
+/** Validates the common envelope and its JSON payload, without accepting a specific version. */
+export declare function isFrameMessage(value: unknown): value is FrameMessage;
+export declare function isCompatibleFrameMessage(value: unknown): value is FrameMessage;
+export declare const isFrameHello: (value: unknown) => value is FrameHello;
+export declare function isInspectPreviewRequest(value: unknown): value is InspectPreviewRequest;
+export declare function isFrameRequest(value: unknown): value is FrameRequest;
+export declare const isFrameReply: (value: unknown) => value is FrameReply;
+export declare function frameEnvelope<T extends FrameMessage['kind']>(identity: FrameIdentity, kind: T): Envelope & {
+    readonly kind: T;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/protocol/index.d.ts.map

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

package/dist/protocol/index.js

@@ -0,0 +1,272 @@
+/** DOM-free message contracts shared by the Workbench host and preview frames. */
+export const FRAME_PROTOCOL = 'oddkin.frame';
+export const FRAME_PROTOCOL_VERSION = 1;
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/** True only for finite, acyclic data that can be transferred as plain JSON without coercion. */
+export function isJsonValue(value) {
+    const active = new WeakSet();
+    const stack = [{ value, exit: false }];
+    while (stack.length) {
+        const item = stack.pop();
+        const current = item.value;
+        if (current === null ||
+            typeof current === 'string' ||
+            typeof current === 'boolean' ||
+            (typeof current === 'number' && Number.isFinite(current)))
+            continue;
+        if (typeof current !== 'object')
+            return false;
+        if (item.exit) {
+            active.delete(current);
+            continue;
+        }
+        if (active.has(current))
+            return false;
+        const array = Array.isArray(current);
+        if (array ? Object.getPrototypeOf(current) !== Array.prototype : !isRecord(current))
+            return false;
+        if (!array) {
+            const prototype = Object.getPrototypeOf(current);
+            if (prototype !== Object.prototype && prototype !== null)
+                return false;
+        }
+        active.add(current);
+        stack.push({ value: current, exit: true });
+        const keys = Reflect.ownKeys(current);
+        if (array) {
+            const list = current;
+            if (keys.length !== list.length + 1 || !keys.includes('length'))
+                return false;
+            for (let i = 0; i < list.length; i++) {
+                const descriptor = Object.getOwnPropertyDescriptor(list, String(i));
+                if (!descriptor?.enumerable || !('value' in descriptor))
+                    return false;
+                stack.push({ value: descriptor.value, exit: false });
+            }
+            continue;
+        }
+        for (const key of keys) {
+            if (typeof key !== 'string')
+                return false;
+            const descriptor = Object.getOwnPropertyDescriptor(current, key);
+            if (!descriptor?.enumerable || !('value' in descriptor))
+                return false;
+            stack.push({ value: descriptor.value, exit: false });
+        }
+    }
+    return true;
+}
+const isPositiveInteger = (value) => typeof value === 'number' && Number.isSafeInteger(value) && value > 0;
+const isStringRecord = (value) => isRecord(value) && Object.values(value).every((item) => typeof item === 'string');
+/** A CSS custom property name: `--` and at least one more character, no spaces or colons. */
+export const isCustomPropertyName = (value) => typeof value === 'string' && /^--[^\s:;{}]+$/.test(value);
+export const isExampleId = (value) => typeof value === 'string' && /^example:[^/]+\/[^/]+$/.test(value);
+const isEventId = (value) => typeof value === 'string' && /^event:[^#]+#[^#]+$/.test(value);
+function isFrameSettings(value) {
+    if (!isRecord(value))
+        return false;
+    if (value['direction'] !== undefined &&
+        value['direction'] !== 'ltr' &&
+        value['direction'] !== 'rtl')
+        return false;
+    if (value['mode'] !== undefined && value['mode'] !== 'light' && value['mode'] !== 'dark')
+        return false;
+    for (const key of ['density', 'product', 'profile'])
+        if (value[key] !== undefined && typeof value[key] !== 'string')
+            return false;
+    for (const key of ['viewport', 'container']) {
+        const size = value[key];
+        if (size === undefined)
+            continue;
+        if (!isRecord(size) ||
+            typeof size['width'] !== 'number' ||
+            !Number.isFinite(size['width']) ||
+            size['width'] <= 0)
+            return false;
+        if (size['height'] !== undefined &&
+            (typeof size['height'] !== 'number' ||
+                !Number.isFinite(size['height']) ||
+                size['height'] <= 0))
+            return false;
+    }
+    return true;
+}
+export function isFrameMountPayload(value) {
+    if (!isRecord(value) ||
+        typeof value['tag'] !== 'string' ||
+        typeof value['registration'] !== 'string' ||
+        !/^[a-z][a-z0-9]*(?:-[a-z0-9]+)+$/.test(value['tag']) ||
+        !isExampleId(value['example']) ||
+        !value['example'].startsWith(`example:${value['tag']}/`))
+        return false;
+    if (value['properties'] !== undefined && !isJsonValue(value['properties']))
+        return false;
+    if (value['attributes'] !== undefined) {
+        const attributes = value['attributes'];
+        if (!isRecord(attributes) ||
+            !Object.values(attributes).every((item) => item === null || typeof item === 'string'))
+            return false;
+    }
+    if (value['slots'] !== undefined && !isStringRecord(value['slots']))
+        return false;
+    if (value['fixture'] !== undefined && typeof value['fixture'] !== 'string')
+        return false;
+    if (value['styles'] !== undefined &&
+        (!isStringRecord(value['styles']) || !Object.keys(value['styles']).every(isCustomPropertyName)))
+        return false;
+    if (value['events'] !== undefined &&
+        (!Array.isArray(value['events']) || !value['events'].every((item) => typeof item === 'string')))
+        return false;
+    if (value['sync'] !== undefined &&
+        (!Array.isArray(value['sync']) ||
+            !value['sync'].every((pair) => isRecord(pair) &&
+                typeof pair['property'] === 'string' &&
+                typeof pair['event'] === 'string')))
+        return false;
+    return value['settings'] === undefined || isFrameSettings(value['settings']);
+}
+export function isFrameSpecimenPayload(value) {
+    return (isRecord(value) &&
+        Array.isArray(value['items']) &&
+        value['items'].every((item) => isFrameMountPayload(item) &&
+            typeof item['role'] === 'string' &&
+            typeof item['label'] === 'string') &&
+        (value['settings'] === undefined || isFrameSettings(value['settings'])));
+}
+/** Validates the common envelope and its JSON payload, without accepting a specific version. */
+export function isFrameMessage(value) {
+    if (!isRecord(value))
+        return false;
+    if (value['protocol'] !== FRAME_PROTOCOL ||
+        !Number.isSafeInteger(value['version']) ||
+        typeof value['frame'] !== 'string' ||
+        value['frame'].length === 0 ||
+        !isPositiveInteger(value['generation']) ||
+        typeof value['kind'] !== 'string')
+        return false;
+    const hasPayload = Object.hasOwn(value, 'payload');
+    if (hasPayload && !isJsonValue(value['payload']))
+        return false;
+    switch (value['kind']) {
+        case 'hello':
+        case 'connect':
+            return !Object.hasOwn(value, 'id') && !Object.hasOwn(value, 'replyTo');
+        case 'mount':
+        case 'specimen':
+        case 'set':
+        case 'slot':
+        case 'reset':
+        case 'theme':
+        case 'settings':
+        case 'dispose':
+        case 'inspect':
+            return isPositiveInteger(value['id']) && !Object.hasOwn(value, 'replyTo');
+        case 'reply':
+            return (isPositiveInteger(value['replyTo']) &&
+                !(Object.hasOwn(value, 'payload') && Object.hasOwn(value, 'error')) &&
+                (!Object.hasOwn(value, 'error') ||
+                    (isRecord(value['error']) &&
+                        typeof value['error']['code'] === 'string' &&
+                        typeof value['error']['message'] === 'string')));
+        case 'event':
+        case 'error':
+        case 'state':
+        case 'size':
+            return !Object.hasOwn(value, 'id') && !Object.hasOwn(value, 'replyTo');
+        default:
+            return false;
+    }
+}
+export function isCompatibleFrameMessage(value) {
+    return isFrameMessage(value) && value.version === FRAME_PROTOCOL_VERSION;
+}
+export const isFrameHello = (value) => isCompatibleFrameMessage(value) && value.kind === 'hello';
+export function isInspectPreviewRequest(value) {
+    if (!isRecord(value) || !isExampleId(value['example']))
+        return false;
+    if ((value['settings'] !== undefined && !isFrameSettings(value['settings'])) ||
+        (value['properties'] !== undefined && !isJsonValue(value['properties'])) ||
+        (value['slots'] !== undefined && !isStringRecord(value['slots'])))
+        return false;
+    const limits = value['limits'];
+    if (limits !== undefined &&
+        (!isRecord(limits) ||
+            !['errors', 'events', 'state', 'checks'].every((key) => {
+                const limit = limits[key];
+                return (limit === undefined ||
+                    (typeof limit === 'number' && Number.isSafeInteger(limit) && limit >= 0));
+            })))
+        return false;
+    const interactions = value['interactions'];
+    return (interactions === undefined ||
+        (Array.isArray(interactions) &&
+            interactions.every((item) => isRecord(item) &&
+                isEventId(item['id']) &&
+                typeof item['event'] === 'string' &&
+                (item['target'] === undefined || typeof item['target'] === 'string'))));
+}
+export function isFrameRequest(value) {
+    if (!isCompatibleFrameMessage(value))
+        return false;
+    if (![
+        'mount',
+        'specimen',
+        'set',
+        'slot',
+        'reset',
+        'theme',
+        'settings',
+        'dispose',
+        'inspect',
+    ].includes(value.kind))
+        return false;
+    const request = value;
+    switch (request.kind) {
+        case 'mount':
+            return isFrameMountPayload(request.payload);
+        case 'specimen':
+            return isFrameSpecimenPayload(request.payload);
+        case 'set': {
+            if (!isRecord(request.payload))
+                return false;
+            const hasProperty = typeof request.payload['property'] === 'string';
+            const hasAttribute = typeof request.payload['attribute'] === 'string';
+            const hasCss = request.payload['cssProperty'] !== undefined;
+            if (Number(hasProperty) + Number(hasAttribute) + Number(hasCss) !== 1)
+                return false;
+            if (hasCss)
+                return (isCustomPropertyName(request.payload['cssProperty']) &&
+                    (request.payload['cssValue'] === null || typeof request.payload['cssValue'] === 'string'));
+            return hasProperty
+                ? (request.payload['unset'] === true ||
+                    (Object.hasOwn(request.payload, 'value') && isJsonValue(request.payload['value']))) &&
+                    (request.payload['unset'] !== true || !Object.hasOwn(request.payload, 'value'))
+                : request.payload['attributeValue'] === null ||
+                    typeof request.payload['attributeValue'] === 'string';
+        }
+        case 'slot':
+            return (isRecord(request.payload) &&
+                typeof request.payload['name'] === 'string' &&
+                typeof request.payload['text'] === 'string');
+        case 'reset':
+        case 'dispose':
+            return !Object.hasOwn(request, 'payload');
+        case 'theme':
+            return isRecord(request.payload) && typeof request.payload['cssText'] === 'string';
+        case 'settings':
+            return isFrameSettings(request.payload);
+        case 'inspect':
+            return isInspectPreviewRequest(request.payload);
+    }
+}
+export const isFrameReply = (value) => isCompatibleFrameMessage(value) && value.kind === 'reply';
+export function frameEnvelope(identity, kind) {
+    return {
+        protocol: FRAME_PROTOCOL,
+        version: FRAME_PROTOCOL_VERSION,
+        frame: identity.frame,
+        generation: identity.generation,
+        kind,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/protocol/index.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * `@oddkin/workbench/testing` — run examples and conformance suites inside the project's own
+ * browser test runner. The runner's `expect` and user-input API are passed in, so this entry
+ * depends on no test framework. Contract: change-impact-and-verification.md §3.
+ */
+import { type Scope } from '@oddkin/core/scope';
+import type { Adapter, ConformanceResult, ConformanceSuite, Expect, UserInput } from '../conformance/index.js';
+import { type ExampleSet } from '../examples/index.js';
+/** Default adapter: anatomy roles are named parts (`part~="role"`) in the shadow root. */
+export declare const partAdapter: Adapter;
+export interface RunConformanceOptions {
+    /** Tag of a registered implementation. */
+    readonly tag: string;
+    readonly expect: Expect;
+    readonly user: UserInput;
+    readonly adapter?: Adapter;
+    /** Recorded with the result (theme, product, density, …). */
+    readonly configuration?: Readonly<Record<string, string>>;
+    readonly implementation?: {
+        readonly package?: string;
+        readonly definition?: string;
+    };
+    /** Run only these case ids; the others are reported `not-executed`. */
+    readonly only?: readonly string[];
+}
+/**
+ * Run every case of `suite` against `options.tag`. Each case gets a fresh container that is
+ * removed afterwards. Failures are recorded, not thrown.
+ */
+export declare function runConformance(suite: ConformanceSuite, options: RunConformanceOptions): Promise<ConformanceResult>;
+export interface MountedExample<E extends Element> {
+    /** The example's element. */
+    readonly element: E;
+    /** Holds the element and everything the fixture mounted; `data-example` is the example id. */
+    readonly root: HTMLElement;
+    /** The scope passed to the fixture. */
+    readonly scope: Scope;
+    /** Dispose the fixture's scope and templates and remove the root. */
+    dispose(): void;
+}
+/**
+ * Mount one authored example the way a preview frame does: create the registered element, set
+ * its attributes, properties, and slot text, connect it, then run its fixture. The tag (and any
+ * element the fixture uses) must already be registered.
+ */
+export declare function mountExample<E extends Element>(set: ExampleSet<E>, name: string, container?: HTMLElement): Promise<MountedExample<E>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAA2B,KAAK,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEzE,OAAO,KAAK,EACV,OAAO,EAGP,iBAAiB,EACjB,gBAAgB,EAChB,MAAM,EAEN,SAAS,EACV,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElE,0FAA0F;AAC1F,eAAO,MAAM,WAAW,EAAE,OAKzB,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,0CAA0C;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D,QAAQ,CAAC,cAAc,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtF,uEAAuE;IACvE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CA0D5B;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,OAAO;IAC/C,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,8FAA8F;IAC9F,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,qEAAqE;IACrE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,SAAS,OAAO,EAClD,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,EAClB,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,WAA2B,GACrC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAqD5B"}