@kurot/ui-document 0.5.2 → 0.6.0

package/dist/kurot/serialization/xml/xml-node.js

@@ -0,0 +1,230 @@
+import { compareStrings } from '../../shared/strings.js';
+import { decodeXMLValue, encodeXMLValue, escapeXML, parseComplexValue, serializeComplexValue, } from './xml-values.js';
+const RESERVED_ATTRIBUTES = new Set(['appearance', 'appearanceVariant', 'id', 'xmlns']);
+/**
+ * Collects custom component namespace prefixes used by a node tree.
+ */
+export function collectNodePrefixes(node, prefixes) {
+    const separator = node.type.indexOf('.');
+    const prefix = separator === -1 ? 'kui' : node.type.slice(0, separator);
+    if (prefix !== 'kui')
+        prefixes.add(prefix);
+    for (const child of node.children) {
+        collectNodePrefixes(child, prefixes);
+    }
+    if (node.instance) {
+        for (const nodes of Object.values(node.instance.slots)) {
+            for (const child of nodes) {
+                collectNodePrefixes(child, prefixes);
+            }
+        }
+    }
+}
+/**
+ * Serializes one semantic node using component tags.
+ */
+export function serializeNode(node, depth) {
+    const indent = '    '.repeat(depth);
+    const tag = componentTag(node.type);
+    const attributes = [`id="${escapeXML(node.id)}"`];
+    const complex = [];
+    if (node.appearance) {
+        attributes.push(`appearance="${escapeXML(node.appearance.assetId)}"`);
+        if (node.appearance.variant !== undefined) {
+            attributes.push(`appearanceVariant="${escapeXML(node.appearance.variant)}"`);
+        }
+    }
+    for (const [name, value] of sortedEntries(node.properties)) {
+        const encoded = encodeXMLValue(value);
+        if (encoded === undefined || RESERVED_ATTRIBUTES.has(name) || name.startsWith('xmlns')) {
+            complex.push([name, value]);
+        }
+        else {
+            attributes.push(`${name}="${escapeXML(encoded)}"`);
+        }
+    }
+    if (complex.length === 0 && node.instance === undefined && node.children.length === 0) {
+        return [`${indent}<${tag} ${attributes.join(' ')} />`];
+    }
+    const lines = [`${indent}<${tag} ${attributes.join(' ')}>`];
+    if (complex.length > 0) {
+        lines.push(`${indent}    <properties>`);
+        for (const [name, value] of complex) {
+            const encoded = encodeXMLValue(value);
+            if (encoded !== undefined) {
+                lines.push(`${indent}        <property name="${escapeXML(name)}" value="${escapeXML(encoded)}" />`);
+            }
+            else {
+                lines.push(`${indent}        <property name="${escapeXML(name)}">`);
+                lines.push(...serializeComplexValue(value, depth + 3));
+                lines.push(`${indent}        </property>`);
+            }
+        }
+        lines.push(`${indent}    </properties>`);
+    }
+    if (node.instance)
+        lines.push(...serializeInstance(node.instance, depth + 1));
+    for (const child of node.children) {
+        lines.push(...serializeNode(child, depth + 1));
+    }
+    lines.push(`${indent}</${tag}>`);
+    return lines;
+}
+/**
+ * Parses one component element into a semantic node.
+ */
+export function parseNode(element, namespaces) {
+    const id = requiredAttribute(element, 'id');
+    const properties = {};
+    let appearance;
+    let instance;
+    const children = [];
+    const appearanceId = element.attributes.appearance;
+    if (appearanceId !== undefined) {
+        appearance = {
+            kind: 'asset',
+            assetId: appearanceId,
+            ...(element.attributes.appearanceVariant === undefined
+                ? {}
+                : { variant: element.attributes.appearanceVariant }),
+        };
+    }
+    for (const [name, value] of Object.entries(element.attributes)) {
+        if (RESERVED_ATTRIBUTES.has(name) || name.startsWith('xmlns:'))
+            continue;
+        properties[name] = decodeXMLValue(value);
+    }
+    for (const child of element.children) {
+        if (child.name === 'properties') {
+            parseProperties(child, properties);
+        }
+        else if (child.name === 'instance') {
+            if (instance !== undefined)
+                throw new Error(`<${element.name}> contains duplicate <instance> metadata.`);
+            instance = parseInstance(child, namespaces);
+        }
+        else {
+            children.push(parseNode(child, namespaces));
+        }
+    }
+    return {
+        id,
+        type: componentType(element.name, namespaces),
+        properties,
+        ...(instance === undefined ? {} : { instance }),
+        ...(appearance === undefined ? {} : { appearance }),
+        children,
+    };
+}
+function serializeInstance(instance, depth) {
+    const indent = '    '.repeat(depth);
+    const variant = instance.variant === undefined ? '' : ` variant="${escapeXML(instance.variant)}"`;
+    const lines = [`${indent}<instance source="${escapeXML(instance.source.assetId)}"${variant}>`];
+    for (const [name, value] of sortedEntries(instance.parameters)) {
+        lines.push(...serializeNamedValue('parameter', name, value, depth + 1));
+    }
+    for (const override of instance.overrides) {
+        lines.push(...serializeOverride(override, depth + 1));
+    }
+    for (const [name, nodes] of sortedEntries(instance.slots)) {
+        lines.push(`${indent}    <slot name="${escapeXML(name)}">`);
+        for (const node of nodes) {
+            lines.push(...serializeNode(node, depth + 2));
+        }
+        lines.push(`${indent}    </slot>`);
+    }
+    lines.push(`${indent}</instance>`);
+    return lines;
+}
+function parseInstance(element, namespaces) {
+    const parameters = {};
+    const overrides = [];
+    const slots = {};
+    for (const child of element.children) {
+        if (child.name === 'parameter') {
+            parameters[requiredAttribute(child, 'name')] = parseNamedValue(child);
+        }
+        else if (child.name === 'override') {
+            overrides.push({
+                part: requiredAttribute(child, 'part'),
+                property: requiredAttribute(child, 'property'),
+                value: parseNamedValue(child),
+            });
+        }
+        else if (child.name === 'slot') {
+            const name = requiredAttribute(child, 'name');
+            slots[name] = child.children.map(node => parseNode(node, namespaces));
+        }
+        else {
+            throw new Error(`Unexpected <${child.name}> inside <instance>.`);
+        }
+    }
+    return {
+        source: { kind: 'asset', assetId: requiredAttribute(element, 'source') },
+        parameters,
+        ...(element.attributes.variant === undefined ? {} : { variant: element.attributes.variant }),
+        overrides,
+        slots,
+    };
+}
+function serializeOverride(override, depth) {
+    const attributes = `part="${escapeXML(override.part)}" property="${escapeXML(override.property)}"`;
+    return serializeValueElement('override', attributes, override.value, depth);
+}
+function serializeNamedValue(tag, name, value, depth) {
+    return serializeValueElement(tag, `name="${escapeXML(name)}"`, value, depth);
+}
+function serializeValueElement(tag, attributes, value, depth) {
+    const indent = '    '.repeat(depth);
+    const encoded = encodeXMLValue(value);
+    if (encoded !== undefined) {
+        return [`${indent}<${tag} ${attributes} value="${escapeXML(encoded)}" />`];
+    }
+    return [
+        `${indent}<${tag} ${attributes}>`,
+        ...serializeComplexValue(value, depth + 1),
+        `${indent}</${tag}>`,
+    ];
+}
+function parseProperties(element, properties) {
+    for (const child of element.children) {
+        if (child.name !== 'property')
+            throw new Error(`Unexpected <${child.name}> inside <properties>.`);
+        properties[requiredAttribute(child, 'name')] = parseNamedValue(child);
+    }
+}
+function parseNamedValue(element) {
+    if (element.attributes.value !== undefined)
+        return decodeXMLValue(element.attributes.value);
+    if (element.children.length !== 1 || element.children[0] === undefined) {
+        throw new Error(`<${element.name}> requires a value attribute or one complex value.`);
+    }
+    return parseComplexValue(element.children[0]);
+}
+function componentTag(type) {
+    const separator = type.indexOf('.');
+    if (separator === -1)
+        return type;
+    const prefix = type.slice(0, separator);
+    const name = type.slice(separator + 1);
+    return prefix === 'kui' ? name : `${prefix}:${name}`;
+}
+function componentType(tag, namespaces) {
+    const separator = tag.indexOf(':');
+    if (separator === -1)
+        return `kui.${tag}`;
+    const prefix = tag.slice(0, separator);
+    if (!Object.hasOwn(namespaces.prefixes, prefix))
+        throw new Error(`Undeclared component namespace prefix "${prefix}".`);
+    return `${prefix}.${tag.slice(separator + 1)}`;
+}
+function requiredAttribute(element, name) {
+    const value = element.attributes[name];
+    if (value === undefined || value.length === 0)
+        throw new Error(`<${element.name}> requires ${name}.`);
+    return value;
+}
+function sortedEntries(record) {
+    return Object.entries(record).sort(([left], [right]) => compareStrings(left, right));
+}
+//# sourceMappingURL=xml-node.js.map

package/dist/kurot/serialization/xml/xml-node.js.map

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

package/dist/kurot/serialization/xml/xml-parser.d.ts

@@ -0,0 +1,10 @@
+export interface XMLElement {
+    readonly name: string;
+    readonly attributes: Readonly<Record<string, string>>;
+    readonly children: readonly XMLElement[];
+}
+/**
+ * Parses the XML subset used by canonical KUI documents.
+ */
+export declare function parseXML(source: string): XMLElement;
+//# sourceMappingURL=xml-parser.d.ts.map

package/dist/kurot/serialization/xml/xml-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-parser.d.ts","sourceRoot":"","sources":["../../../../src/kurot/serialization/xml/xml-parser.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;CACzC;AAOD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAGnD"}

package/dist/kurot/serialization/xml/xml-parser.js

@@ -0,0 +1,134 @@
+const NAME = '[A-Za-z_][\\w:.-]*';
+const OPEN_PATTERN = new RegExp(`^<(${NAME})`);
+const CLOSE_PATTERN = new RegExp(`^<\\/(${NAME})\\s*>`);
+const ATTRIBUTE_PATTERN = new RegExp(`^(${NAME})\\s*=\\s*(?:"([^"]*)"|'([^']*)')`);
+/**
+ * Parses the XML subset used by canonical KUI documents.
+ */
+export function parseXML(source) {
+    const parser = new XMLParser(source);
+    return parser.parse();
+}
+class XMLParser {
+    _source;
+    _position = 0;
+    constructor(_source) {
+        this._source = _source;
+    }
+    parse() {
+        this._skipMiscellaneous();
+        const root = this._parseElement();
+        this._skipMiscellaneous();
+        if (this._position !== this._source.length) {
+            throw this._error('Unexpected content after the root element.');
+        }
+        return root;
+    }
+    _parseElement() {
+        const opening = this._source.slice(this._position).match(OPEN_PATTERN);
+        if (!opening || opening[1] === undefined) {
+            throw this._error('Expected an XML element.');
+        }
+        const name = opening[1];
+        this._position += opening[0].length;
+        const attributes = {};
+        for (;;) {
+            this._skipWhitespace();
+            if (this._source.startsWith('/>', this._position)) {
+                this._position += 2;
+                return { name, attributes, children: [] };
+            }
+            if (this._source[this._position] === '>') {
+                this._position++;
+                break;
+            }
+            const attribute = this._source.slice(this._position).match(ATTRIBUTE_PATTERN);
+            if (!attribute || attribute[1] === undefined) {
+                throw this._error(`Invalid attribute in <${name}>.`);
+            }
+            if (Object.hasOwn(attributes, attribute[1])) {
+                throw this._error(`Duplicate attribute "${attribute[1]}" in <${name}>.`);
+            }
+            attributes[attribute[1]] = decodeXML(attribute[2] ?? attribute[3] ?? '');
+            this._position += attribute[0].length;
+        }
+        const children = [];
+        for (;;) {
+            this._skipMiscellaneous();
+            const closing = this._source.slice(this._position).match(CLOSE_PATTERN);
+            if (closing) {
+                if (closing[1] !== name) {
+                    throw this._error(`Expected </${name}>, received </${String(closing[1])}>.`);
+                }
+                this._position += closing[0].length;
+                return { name, attributes, children };
+            }
+            if (this._position >= this._source.length) {
+                throw this._error(`Missing closing tag </${name}>.`);
+            }
+            if (this._source[this._position] !== '<') {
+                const text = this._readText();
+                if (text.trim().length > 0) {
+                    throw this._error(`Text content is not allowed inside <${name}>.`);
+                }
+                continue;
+            }
+            children.push(this._parseElement());
+        }
+    }
+    _readText() {
+        const start = this._position;
+        while (this._position < this._source.length && this._source[this._position] !== '<') {
+            this._position++;
+        }
+        return decodeXML(this._source.slice(start, this._position));
+    }
+    _skipMiscellaneous() {
+        for (;;) {
+            this._skipWhitespace();
+            if (this._source.startsWith('<!--', this._position)) {
+                this._skipThrough('-->', 'Unterminated XML comment.');
+                continue;
+            }
+            if (this._source.startsWith('<?', this._position)) {
+                this._skipThrough('?>', 'Unterminated processing instruction.');
+                continue;
+            }
+            return;
+        }
+    }
+    _skipThrough(terminator, message) {
+        const end = this._source.indexOf(terminator, this._position + 2);
+        if (end === -1) {
+            throw this._error(message);
+        }
+        this._position = end + terminator.length;
+    }
+    _skipWhitespace() {
+        while (/\s/.test(this._source[this._position] ?? '')) {
+            this._position++;
+        }
+    }
+    _error(message) {
+        return new Error(`${message} (offset ${this._position})`);
+    }
+}
+function decodeXML(value) {
+    const named = {
+        amp: '&',
+        apos: "'",
+        gt: '>',
+        lt: '<',
+        quot: '"',
+    };
+    return value.replace(/&(#x[0-9a-f]+|#\d+|amp|apos|gt|lt|quot);/gi, (match, entity) => {
+        if (entity.startsWith('#x')) {
+            return String.fromCodePoint(Number.parseInt(entity.slice(2), 16));
+        }
+        if (entity.startsWith('#')) {
+            return String.fromCodePoint(Number.parseInt(entity.slice(1), 10));
+        }
+        return named[entity] ?? match;
+    });
+}
+//# sourceMappingURL=xml-parser.js.map

package/dist/kurot/serialization/xml/xml-parser.js.map

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

package/dist/kurot/serialization/xml/xml-values.d.ts

@@ -0,0 +1,23 @@
+import type { UIPropertyValue } from '../../model/UIPropertyValue.js';
+import type { XMLElement } from './xml-parser.js';
+/**
+ * Encodes a scalar or reference value for an XML attribute.
+ */
+export declare function encodeXMLValue(value: UIPropertyValue): string | undefined;
+/**
+ * Decodes the canonical scalar and reference attribute syntax.
+ */
+export declare function decodeXMLValue(source: string): UIPropertyValue;
+/**
+ * Serializes an array or object property as explicit value elements.
+ */
+export declare function serializeComplexValue(value: UIPropertyValue, depth: number): string[];
+/**
+ * Parses one explicit array or object value element.
+ */
+export declare function parseComplexValue(element: XMLElement): UIPropertyValue;
+/**
+ * Escapes text for a double-quoted XML attribute.
+ */
+export declare function escapeXML(value: string): string;
+//# sourceMappingURL=xml-values.d.ts.map

package/dist/kurot/serialization/xml/xml-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-values.d.ts","sourceRoot":"","sources":["../../../../src/kurot/serialization/xml/xml-values.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAOxF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAKlD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAiBzE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAiB9D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA6BrF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,eAAe,CAatE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM/C"}

package/dist/kurot/serialization/xml/xml-values.js

@@ -0,0 +1,133 @@
+import { isUIAssetReference, isUIDesignTokenReference, isUIResourceReference, } from '../../model/UIReference.js';
+import { compareStrings } from '../../shared/strings.js';
+const NUMBER_PATTERN = /^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/;
+const REFERENCE_PATTERN = /^@(asset|resource|token):/;
+/**
+ * Encodes a scalar or reference value for an XML attribute.
+ */
+export function encodeXMLValue(value) {
+    if (typeof value === 'boolean' || typeof value === 'number') {
+        return String(value);
+    }
+    if (typeof value === 'string') {
+        return needsStringEscape(value) ? `\\${value}` : value;
+    }
+    if (isUIAssetReference(value)) {
+        return `@asset:${value.assetId}`;
+    }
+    if (isUIResourceReference(value)) {
+        return `@resource:${value.resourceType}:${value.key}`;
+    }
+    if (isUIDesignTokenReference(value)) {
+        return `@token:${value.tokenType}:${value.key}`;
+    }
+    return undefined;
+}
+/**
+ * Decodes the canonical scalar and reference attribute syntax.
+ */
+export function decodeXMLValue(source) {
+    if (source.startsWith('\\'))
+        return source.slice(1);
+    if (source === 'true')
+        return true;
+    if (source === 'false')
+        return false;
+    if (NUMBER_PATTERN.test(source))
+        return Number(source);
+    if (source.startsWith('@asset:')) {
+        return { kind: 'asset', assetId: source.slice('@asset:'.length) };
+    }
+    if (source.startsWith('@resource:')) {
+        const [resourceType, ...key] = source.slice('@resource:'.length).split(':');
+        return { kind: 'resource', resourceType: resourceType ?? '', key: key.join(':') };
+    }
+    if (source.startsWith('@token:')) {
+        const [tokenType, ...key] = source.slice('@token:'.length).split(':');
+        return { kind: 'token', tokenType: tokenType ?? '', key: key.join(':') };
+    }
+    return source;
+}
+/**
+ * Serializes an array or object property as explicit value elements.
+ */
+export function serializeComplexValue(value, depth) {
+    const indent = '    '.repeat(depth);
+    if (Array.isArray(value)) {
+        return serializeCollection('array', value.map(item => ['', item]), depth);
+    }
+    const object = value;
+    const entries = Object.entries(object).sort(([left], [right]) => compareStrings(left, right));
+    return serializeCollection('object', entries, depth);
+    function serializeCollection(name, items, itemDepth) {
+        const lines = [`${indent}<${name}>`];
+        for (const [key, item] of items) {
+            const encoded = encodeXMLValue(item);
+            const keyAttribute = key === '' ? '' : ` name="${escapeXML(key)}"`;
+            if (encoded !== undefined) {
+                lines.push(`${'    '.repeat(itemDepth + 1)}<value${keyAttribute} value="${escapeXML(encoded)}" />`);
+                continue;
+            }
+            lines.push(`${'    '.repeat(itemDepth + 1)}<value${keyAttribute}>`);
+            lines.push(...serializeComplexValue(item, itemDepth + 2));
+            lines.push(`${'    '.repeat(itemDepth + 1)}</value>`);
+        }
+        lines.push(`${indent}</${name}>`);
+        return lines;
+    }
+}
+/**
+ * Parses one explicit array or object value element.
+ */
+export function parseComplexValue(element) {
+    if (element.name === 'array') {
+        return element.children.map(parseValueElement);
+    }
+    if (element.name === 'object') {
+        const result = {};
+        for (const child of element.children) {
+            const name = requiredAttribute(child, 'name');
+            result[name] = parseValueElement(child);
+        }
+        return result;
+    }
+    throw new Error(`Expected <array> or <object>, received <${element.name}>.`);
+}
+/**
+ * Escapes text for a double-quoted XML attribute.
+ */
+export function escapeXML(value) {
+    return value
+        .replaceAll('&', '&amp;')
+        .replaceAll('"', '&quot;')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;');
+}
+function parseValueElement(element) {
+    if (element.name !== 'value') {
+        throw new Error(`Expected <value>, received <${element.name}>.`);
+    }
+    const scalar = element.attributes.value;
+    if (scalar !== undefined) {
+        if (element.children.length > 0) {
+            throw new Error('<value> cannot contain both a value attribute and child content.');
+        }
+        return decodeXMLValue(scalar);
+    }
+    const child = element.children[0];
+    if (child === undefined || element.children.length !== 1) {
+        throw new Error('<value> must contain exactly one <array> or <object>.');
+    }
+    return parseComplexValue(child);
+}
+function requiredAttribute(element, name) {
+    const value = element.attributes[name];
+    if (value === undefined || value.length === 0) {
+        throw new Error(`<${element.name}> requires a non-empty ${name} attribute.`);
+    }
+    return value;
+}
+function needsStringEscape(value) {
+    return value.startsWith('\\') || value === 'true' || value === 'false' || NUMBER_PATTERN.test(value) || REFERENCE_PATTERN.test(value);
+}
+//# sourceMappingURL=xml-values.js.map

package/dist/kurot/serialization/xml/xml-values.js.map

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

package/dist/kurot/serialization/xml.d.ts

@@ -0,0 +1,14 @@
+import type { UIDocument } from '../model/UIDocument.js';
+/**
+ * Default namespace of canonical KUI XML documents.
+ */
+export declare const KUI_XML_NAMESPACE = "https://kurot.dev/ui/1";
+/**
+ * Serializes a semantic document as canonical KUI XML.
+ */
+export declare function serializeUIDocument(document: UIDocument): string;
+/**
+ * Parses and validates one canonical KUI XML document.
+ */
+export declare function parseUIDocument(source: string): UIDocument;
+//# sourceMappingURL=xml.d.ts.map

package/dist/kurot/serialization/xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../../../src/kurot/serialization/xml.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAWzD;;GAEG;AACH,eAAO,MAAM,iBAAiB,2BAA2B,CAAC;AAE1D;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,CAmBhE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAgD1D"}