@kumwe/studio-core 0.1.0-alpha.2

package/dist/schema-profile.js

@@ -0,0 +1,387 @@
+import { Ajv2020 } from 'ajv/dist/2020.js';
+const DRAFT_2020_12 = 'https://json-schema.org/draft/2020-12/schema';
+const MAX_ALTERNATIVES = 64;
+const MAX_ENUM_MEMBERS = 1_024;
+const MAX_JSON_DEPTH = 64;
+const MAX_JSON_ITEMS = 10_000;
+const MAX_JSON_PROPERTIES = 1_000;
+const MAX_REFERENCES = 128;
+const MAX_SCHEMA_BYTES = 262_144;
+const MAX_SCHEMA_DEPTH = 32;
+const MAX_SCHEMA_MAP_PROPERTIES = 512;
+const MAX_SCHEMA_NODES = 1_024;
+const MAX_OBJECT_KEY_LENGTH = 200;
+/**
+ * The published complexity limits of the Studio Schema Profile. The
+ * machine-readable meta-schema (`schema-profile.schema.json`) carries the
+ * same values; a parity test keeps the two from drifting.
+ */
+export const STUDIO_SCHEMA_PROFILE_LIMITS = Object.freeze({
+    maxAlternatives: MAX_ALTERNATIVES,
+    maxEnumMembers: MAX_ENUM_MEMBERS,
+    maxJsonDepth: MAX_JSON_DEPTH,
+    maxJsonItems: MAX_JSON_ITEMS,
+    maxJsonProperties: MAX_JSON_PROPERTIES,
+    maxObjectKeyLength: MAX_OBJECT_KEY_LENGTH,
+    maxReferences: MAX_REFERENCES,
+    maxSchemaBytes: MAX_SCHEMA_BYTES,
+    maxSchemaDepth: MAX_SCHEMA_DEPTH,
+    maxSchemaMapProperties: MAX_SCHEMA_MAP_PROPERTIES,
+    maxSchemaNodes: MAX_SCHEMA_NODES,
+});
+const allowedKeywords = new Set([
+    '$defs',
+    '$ref',
+    '$schema',
+    'additionalProperties',
+    'allOf',
+    'anyOf',
+    'const',
+    'default',
+    'dependentRequired',
+    'description',
+    'else',
+    'enum',
+    'examples',
+    'exclusiveMaximum',
+    'exclusiveMinimum',
+    'if',
+    'items',
+    'maxItems',
+    'maxLength',
+    'maxProperties',
+    'maximum',
+    'minItems',
+    'minLength',
+    'minProperties',
+    'minimum',
+    'multipleOf',
+    'not',
+    'oneOf',
+    'prefixItems',
+    'properties',
+    'propertyNames',
+    'readOnly',
+    'required',
+    'then',
+    'title',
+    'type',
+    'uniqueItems',
+    'writeOnly',
+]);
+export function assertStudioPropertySchema(schema) {
+    const state = { references: 0, schemaNodes: 0, seen: new WeakSet() };
+    visitSchema(schema, '$', 1, state);
+    assertNonRecursiveSchema(schema);
+    let serialized;
+    try {
+        serialized = JSON.stringify(schema);
+    }
+    catch (error) {
+        throw new TypeError('Studio property schema must be an acyclic JSON document.', {
+            cause: error,
+        });
+    }
+    if (utf8ByteLength(serialized) > MAX_SCHEMA_BYTES) {
+        throw new RangeError(`Studio property schema exceeds ${MAX_SCHEMA_BYTES} bytes.`);
+    }
+    try {
+        new Ajv2020({ addUsedSchema: false, allErrors: true, strict: true }).compile(schema);
+    }
+    catch (error) {
+        throw new TypeError('Studio property schema does not compile under the strict profile.', {
+            cause: error,
+        });
+    }
+}
+function visitSchema(value, path, depth, state) {
+    if (!isRecord(value)) {
+        throw new TypeError(`${path} must be a JSON Schema object.`);
+    }
+    trackObject(value, path, state);
+    if (depth > MAX_SCHEMA_DEPTH) {
+        throw new RangeError(`${path} exceeds the Studio Schema Profile depth limit.`);
+    }
+    state.schemaNodes += 1;
+    if (state.schemaNodes > MAX_SCHEMA_NODES) {
+        throw new RangeError(`Studio property schema exceeds ${MAX_SCHEMA_NODES} schema nodes.`);
+    }
+    for (const [keyword, keywordValue] of Object.entries(value)) {
+        assertSafeObjectKey(keyword, path);
+        if (!allowedKeywords.has(keyword)) {
+            throw new TypeError(`${path}.${keyword} is not allowed by the Studio Schema Profile.`);
+        }
+        switch (keyword) {
+            case '$defs':
+            case 'properties':
+                visitSchemaMap(keywordValue, `${path}.${keyword}`, depth + 1, state);
+                break;
+            case 'additionalProperties':
+            case 'else':
+            case 'if':
+            case 'items':
+            case 'not':
+            case 'propertyNames':
+            case 'then':
+                visitSubschema(keywordValue, `${path}.${keyword}`, depth + 1, state);
+                break;
+            case 'allOf':
+            case 'anyOf':
+            case 'oneOf':
+            case 'prefixItems':
+                visitSchemaArray(keywordValue, `${path}.${keyword}`, depth + 1, state);
+                break;
+            case '$ref':
+                visitReference(keywordValue, `${path}.${keyword}`, state);
+                break;
+            case '$schema':
+                if (keywordValue !== DRAFT_2020_12) {
+                    throw new TypeError(`${path} must declare JSON Schema Draft 2020-12.`);
+                }
+                break;
+            case 'enum':
+                if (!Array.isArray(keywordValue) || keywordValue.length > MAX_ENUM_MEMBERS) {
+                    throw new RangeError(`${path}.enum exceeds ${MAX_ENUM_MEMBERS} members.`);
+                }
+                visitJsonValue(keywordValue, `${path}.enum`, depth + 1, state);
+                break;
+            default:
+                visitJsonValue(keywordValue, `${path}.${keyword}`, depth + 1, state);
+        }
+    }
+}
+function visitSchemaMap(value, path, depth, state) {
+    if (!isRecord(value)) {
+        throw new TypeError(`${path} must be an object of schemas.`);
+    }
+    trackObject(value, path, state);
+    const entries = Object.entries(value);
+    if (entries.length > MAX_SCHEMA_MAP_PROPERTIES) {
+        throw new RangeError(`${path} exceeds ${MAX_SCHEMA_MAP_PROPERTIES} schema entries.`);
+    }
+    for (const [name, schema] of entries) {
+        assertSafeObjectKey(name, path);
+        visitSchema(schema, `${path}.${name}`, depth, state);
+    }
+}
+function visitSchemaArray(value, path, depth, state) {
+    if (!Array.isArray(value) || value.length > MAX_ALTERNATIVES) {
+        throw new RangeError(`${path} must contain at most ${MAX_ALTERNATIVES} schemas.`);
+    }
+    trackObject(value, path, state);
+    assertDenseArray(value, path);
+    for (const [index, schema] of value.entries()) {
+        visitSubschema(schema, `${path}[${index}]`, depth, state);
+    }
+}
+function visitSubschema(value, path, depth, state) {
+    if (typeof value === 'boolean') {
+        return;
+    }
+    visitSchema(value, path, depth, state);
+}
+function visitReference(value, path, state) {
+    if (typeof value !== 'string' ||
+        (value !== '#' && !value.startsWith('#/')) ||
+        value.length > 500) {
+        throw new TypeError(`${path} must be a bounded local JSON Pointer reference.`);
+    }
+    state.references += 1;
+    if (state.references > MAX_REFERENCES) {
+        throw new RangeError(`Studio property schema exceeds ${MAX_REFERENCES} references.`);
+    }
+}
+function visitJsonValue(value, path, depth, state) {
+    if (value === null ||
+        typeof value === 'boolean' ||
+        typeof value === 'string' ||
+        (typeof value === 'number' && Number.isFinite(value))) {
+        return;
+    }
+    if (depth > MAX_JSON_DEPTH) {
+        throw new RangeError(`${path} exceeds the Studio Schema Profile JSON depth limit.`);
+    }
+    if (Array.isArray(value)) {
+        trackObject(value, path, state);
+        assertDenseArray(value, path);
+        if (value.length > MAX_JSON_ITEMS) {
+            throw new RangeError(`${path} exceeds ${MAX_JSON_ITEMS} JSON items.`);
+        }
+        for (const [index, entry] of value.entries()) {
+            visitJsonValue(entry, `${path}[${index}]`, depth + 1, state);
+        }
+        return;
+    }
+    if (isRecord(value)) {
+        trackObject(value, path, state);
+        const entries = Object.entries(value);
+        if (entries.length > MAX_JSON_PROPERTIES) {
+            throw new RangeError(`${path} exceeds ${MAX_JSON_PROPERTIES} JSON properties.`);
+        }
+        for (const [key, entry] of entries) {
+            assertSafeObjectKey(key, path);
+            visitJsonValue(entry, `${path}.${key}`, depth + 1, state);
+        }
+        return;
+    }
+    throw new TypeError(`${path} is not JSON-compatible.`);
+}
+function assertSafeObjectKey(key, path) {
+    if (key.length === 0 ||
+        key.length > MAX_OBJECT_KEY_LENGTH ||
+        key === '__proto__' ||
+        key === 'constructor' ||
+        key === 'prototype' ||
+        containsControlCharacter(key)) {
+        throw new TypeError(`${path} contains forbidden object member name ${JSON.stringify(key)}.`);
+    }
+}
+function assertNonRecursiveSchema(root) {
+    const active = new WeakSet();
+    const finished = new WeakSet();
+    const stack = [{ entered: false, node: root }];
+    while (stack.length > 0) {
+        const frame = stack.pop();
+        if (frame === undefined || finished.has(frame.node)) {
+            continue;
+        }
+        if (frame.entered) {
+            active.delete(frame.node);
+            finished.add(frame.node);
+            continue;
+        }
+        if (active.has(frame.node)) {
+            throw new TypeError('Recursive contributed schemas are not admitted by the alpha profile.');
+        }
+        active.add(frame.node);
+        stack.push({ entered: true, node: frame.node });
+        const dependencies = schemaDependencies(frame.node, root);
+        for (let index = dependencies.length - 1; index >= 0; index -= 1) {
+            const dependency = dependencies[index];
+            if (dependency === undefined || finished.has(dependency)) {
+                continue;
+            }
+            if (active.has(dependency)) {
+                throw new TypeError('Recursive contributed schemas are not admitted by the alpha profile.');
+            }
+            stack.push({ entered: false, node: dependency });
+        }
+    }
+}
+function schemaDependencies(schema, root) {
+    const dependencies = [];
+    for (const keyword of [
+        'additionalProperties',
+        'else',
+        'if',
+        'items',
+        'not',
+        'propertyNames',
+        'then',
+    ]) {
+        appendSchemaDependency(dependencies, schema[keyword]);
+    }
+    for (const keyword of ['allOf', 'anyOf', 'oneOf', 'prefixItems']) {
+        const candidates = schema[keyword];
+        if (Array.isArray(candidates)) {
+            for (const candidate of candidates) {
+                appendSchemaDependency(dependencies, candidate);
+            }
+        }
+    }
+    for (const keyword of ['$defs', 'properties']) {
+        const schemaMap = schema[keyword];
+        if (isRecord(schemaMap)) {
+            for (const candidate of Object.values(schemaMap)) {
+                appendSchemaDependency(dependencies, candidate);
+            }
+        }
+    }
+    if (typeof schema.$ref === 'string') {
+        appendSchemaDependency(dependencies, resolveLocalReference(root, schema.$ref));
+    }
+    return dependencies;
+}
+function appendSchemaDependency(dependencies, value) {
+    if (isRecord(value)) {
+        dependencies.push(value);
+    }
+}
+function resolveLocalReference(root, reference) {
+    if (reference === '#') {
+        return root;
+    }
+    let current = root;
+    for (const encodedToken of reference.slice(2).split('/')) {
+        if (/(?:~[^01]|~$)/u.test(encodedToken)) {
+            throw new TypeError(`Local schema reference ${reference} is not a valid JSON Pointer.`);
+        }
+        const token = encodedToken.replaceAll('~1', '/').replaceAll('~0', '~');
+        if (!isRecord(current) && !Array.isArray(current)) {
+            throw new TypeError(`Local schema reference ${reference} does not resolve to a schema.`);
+        }
+        if (!Object.hasOwn(current, token)) {
+            throw new TypeError(`Local schema reference ${reference} does not resolve to a schema.`);
+        }
+        current = current[token];
+    }
+    if (typeof current !== 'boolean' && !isRecord(current)) {
+        throw new TypeError(`Local schema reference ${reference} does not resolve to a schema.`);
+    }
+    return current;
+}
+function containsControlCharacter(value) {
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        if (code <= 0x1f || code === 0x7f) {
+            return true;
+        }
+    }
+    return false;
+}
+function assertDenseArray(value, path) {
+    const keys = Object.keys(value);
+    if (keys.length !== value.length || keys.some((key, index) => key !== String(index))) {
+        throw new TypeError(`${path} must be a dense JSON array without extra properties.`);
+    }
+}
+function trackObject(value, path, state) {
+    if (state.seen.has(value)) {
+        throw new TypeError(`${path} reuses or cycles a JSON object.`);
+    }
+    state.seen.add(value);
+}
+function isRecord(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function utf8ByteLength(value) {
+    let bytes = 0;
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        if (code <= 0x7f) {
+            bytes += 1;
+        }
+        else if (code <= 0x7ff) {
+            bytes += 2;
+        }
+        else if (code >= 0xd800 && code <= 0xdbff) {
+            const next = value.charCodeAt(index + 1);
+            if (next >= 0xdc00 && next <= 0xdfff) {
+                bytes += 4;
+                index += 1;
+            }
+            else {
+                bytes += 3;
+            }
+        }
+        else {
+            bytes += 3;
+        }
+    }
+    return bytes;
+}
+//# sourceMappingURL=schema-profile.js.map

package/dist/schema-profile.js.map

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

package/dist/semver.d.ts

@@ -0,0 +1,20 @@
+export interface ParsedSemanticVersion {
+    major: number;
+    minor: number;
+    patch: number;
+    prerelease: readonly (number | string)[];
+}
+export declare function parseSemanticVersion(value: string): ParsedSemanticVersion;
+/** SemVer 2.0 precedence; build metadata never participates. */
+export declare function compareSemanticVersions(left: string, right: string): -1 | 0 | 1;
+/**
+ * Expand caret and tilde shorthands into their conventional comparator
+ * conjunctions. The supported grammar is deliberately small and
+ * deterministic: exact versions, `^`/`~` shorthands, and space-joined
+ * comparators; disjunctions are unsupported until the compatibility
+ * contract ratifies them.
+ */
+export declare function normalizeVersionRange(range: string): string;
+/** Whether a version satisfies every comparator of the supported range grammar. */
+export declare function satisfiesVersionRange(version: string, range: string): boolean;
+//# sourceMappingURL=semver.d.ts.map

package/dist/semver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semver.d.ts","sourceRoot":"","sources":["../src/semver.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CAC1C;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAgBzE;AAED,gEAAgE;AAChE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CA0C/E;AAOD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA4B3D;AAED,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAkB7E"}

package/dist/semver.js

@@ -0,0 +1,128 @@
+const VERSION_PATTERN = /^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)(?:-((?:0|[1-9][0-9]*|[0-9]*[A-Za-z-][0-9A-Za-z-]*)(?:\.(?:0|[1-9][0-9]*|[0-9]*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\+([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$/u;
+export function parseSemanticVersion(value) {
+    const match = value.length <= 100 ? VERSION_PATTERN.exec(value) : null;
+    if (match === null) {
+        throw new TypeError(`${value} is not a canonical semantic version.`);
+    }
+    return {
+        major: Number(match[1]),
+        minor: Number(match[2]),
+        patch: Number(match[3]),
+        prerelease: match[4] === undefined
+            ? []
+            : match[4]
+                .split('.')
+                .map((part) => (/^(0|[1-9][0-9]*)$/u.test(part) ? Number(part) : part)),
+    };
+}
+/** SemVer 2.0 precedence; build metadata never participates. */
+export function compareSemanticVersions(left, right) {
+    const a = parseSemanticVersion(left);
+    const b = parseSemanticVersion(right);
+    for (const member of ['major', 'minor', 'patch']) {
+        if (a[member] !== b[member]) {
+            return a[member] < b[member] ? -1 : 1;
+        }
+    }
+    if (a.prerelease.length === 0 && b.prerelease.length === 0) {
+        return 0;
+    }
+    if (a.prerelease.length === 0) {
+        return 1;
+    }
+    if (b.prerelease.length === 0) {
+        return -1;
+    }
+    const length = Math.max(a.prerelease.length, b.prerelease.length);
+    for (let index = 0; index < length; index += 1) {
+        const first = a.prerelease[index];
+        const second = b.prerelease[index];
+        if (first === undefined) {
+            return -1;
+        }
+        if (second === undefined) {
+            return 1;
+        }
+        if (first === second) {
+            continue;
+        }
+        if (typeof first === 'number' && typeof second === 'number') {
+            return first < second ? -1 : 1;
+        }
+        if (typeof first === 'number') {
+            return -1;
+        }
+        if (typeof second === 'number') {
+            return 1;
+        }
+        return first < second ? -1 : 1;
+    }
+    return 0;
+}
+/**
+ * Expand caret and tilde shorthands into their conventional comparator
+ * conjunctions. The supported grammar is deliberately small and
+ * deterministic: exact versions, `^`/`~` shorthands, and space-joined
+ * comparators; disjunctions are unsupported until the compatibility
+ * contract ratifies them.
+ */
+export function normalizeVersionRange(range) {
+    const trimmed = range.trim();
+    if (trimmed.length === 0 || trimmed.length > 120 || trimmed.includes('||')) {
+        throw new TypeError(`${range} is not a supported version range.`);
+    }
+    return trimmed
+        .split(/\s+/u)
+        .map((part) => {
+        if (part.startsWith('^')) {
+            const source = part.slice(1);
+            const version = parseSemanticVersion(source);
+            const upper = version.major > 0
+                ? `${version.major + 1}.0.0-0`
+                : version.minor > 0
+                    ? `0.${version.minor + 1}.0-0`
+                    : `0.0.${version.patch + 1}-0`;
+            return `>=${source} <${upper}`;
+        }
+        if (part.startsWith('~')) {
+            const source = part.slice(1);
+            const version = parseSemanticVersion(source);
+            return `>=${source} <${version.major}.${version.minor + 1}.0-0`;
+        }
+        parseComparator(part);
+        return part;
+    })
+        .join(' ');
+}
+/** Whether a version satisfies every comparator of the supported range grammar. */
+export function satisfiesVersionRange(version, range) {
+    parseSemanticVersion(version);
+    const comparators = normalizeVersionRange(range).split(/\s+/u).map(parseComparator);
+    return comparators.every((comparator) => {
+        const comparison = compareSemanticVersions(version, comparator.version);
+        switch (comparator.operator) {
+            case '<':
+                return comparison < 0;
+            case '<=':
+                return comparison <= 0;
+            case '=':
+                return comparison === 0;
+            case '>':
+                return comparison > 0;
+            default:
+                return comparison >= 0;
+        }
+    });
+}
+function parseComparator(part) {
+    const match = /^(>=|<=|>|<|=)?([^<>=].*)$/u.exec(part);
+    if (match?.[2] === undefined) {
+        throw new TypeError(`${part} is not a supported version comparator.`);
+    }
+    parseSemanticVersion(match[2]);
+    return {
+        operator: (match[1] ?? '='),
+        version: match[2],
+    };
+}
+//# sourceMappingURL=semver.js.map

package/dist/semver.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,33 @@
+import type { BlueprintCommand, BlueprintDocument, NodeId, Revision } from '@kumwe/studio-protocol';
+export interface StudioSessionOptions {
+    document: BlueprintDocument;
+    maximumHistoryEntries?: number;
+    sessionGeneration: Revision;
+    sessionState: 'editable' | 'read-only';
+}
+/**
+ * A deterministic editing session over one Blueprint document: bounded
+ * history, an explicit selection model, and the session-level guards the
+ * command contract requires before any reducer runs. Session generation,
+ * read-only state, and expected-revision checks fail closed; a rejected
+ * command changes neither the document nor the selection.
+ */
+export declare class StudioSession {
+    #private;
+    constructor(options: Readonly<StudioSessionOptions>);
+    get canRedo(): boolean;
+    get canUndo(): boolean;
+    get dirty(): boolean;
+    get document(): BlueprintDocument;
+    get selection(): readonly NodeId[];
+    get sessionState(): 'editable' | 'read-only';
+    get stateVersion(): number;
+    execute(command: BlueprintCommand): BlueprintDocument;
+    markSaved(revision: Revision): void;
+    get savedRevision(): Revision;
+    select(nodeIds: readonly NodeId[]): readonly NodeId[];
+    clearSelection(): void;
+    undo(): BlueprintDocument;
+    redo(): BlueprintDocument;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAEjB,MAAM,EACN,QAAQ,EACT,MAAM,wBAAwB,CAAC;AAIhC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,QAAQ,CAAC;IAC5B,YAAY,EAAE,UAAU,GAAG,WAAW,CAAC;CACxC;AAED;;;;;;GAMG;AACH,qBAAa,aAAa;;gBAQL,OAAO,EAAE,QAAQ,CAAC,oBAAoB,CAAC;IAO1D,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED,IAAW,KAAK,IAAI,OAAO,CAE1B;IAED,IAAW,QAAQ,IAAI,iBAAiB,CAEvC;IAED,IAAW,SAAS,IAAI,SAAS,MAAM,EAAE,CAExC;IAED,IAAW,YAAY,IAAI,UAAU,GAAG,WAAW,CAElD;IAED,IAAW,YAAY,IAAI,MAAM,CAEhC;IAEM,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,iBAAiB;IA2BrD,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAK1C,IAAW,aAAa,IAAI,QAAQ,CAEnC;IAEM,MAAM,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE;IAmBrD,cAAc,IAAI,IAAI;IAItB,IAAI,IAAI,iBAAiB;IAMzB,IAAI,IAAI,iBAAiB;CAWjC"}