@reverso/core 0.1.0

package/dist/utils/path.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Path utilities for parsing and building field paths.
+ * Field paths follow the format: page.section.field or page.section.$.field for repeaters.
+ */
+import type { ParsedPath } from '../types/schema.js';
+/**
+ * Parse a field path into its components.
+ *
+ * @example
+ * ```ts
+ * parsePath('home.hero.title')
+ * // { page: 'home', section: 'hero', field: 'title', isRepeater: false, full: 'home.hero.title' }
+ *
+ * parsePath('home.features.$.title')
+ * // { page: 'home', section: 'features', field: '$', isRepeater: true, repeaterField: 'title', full: 'home.features.$.title' }
+ * ```
+ */
+export declare function parsePath(path: string): ParsedPath;
+/**
+ * Build a field path from components.
+ *
+ * @example
+ * ```ts
+ * buildPath('home', 'hero', 'title')
+ * // 'home.hero.title'
+ *
+ * buildPath('home', 'features', '$', 'title')
+ * // 'home.features.$.title'
+ * ```
+ */
+export declare function buildPath(...parts: string[]): string;
+/**
+ * Get the page from a field path.
+ */
+export declare function getPageFromPath(path: string): string;
+/**
+ * Get the section from a field path.
+ */
+export declare function getSectionFromPath(path: string): string;
+/**
+ * Get the field name from a field path.
+ */
+export declare function getFieldFromPath(path: string): string;
+/**
+ * Check if a path is a repeater path.
+ */
+export declare function isRepeaterPath(path: string): boolean;
+/**
+ * Get the parent path (page.section or page.section.$ for repeaters).
+ */
+export declare function getParentPath(path: string): string;
+/**
+ * Get the page.section path.
+ */
+export declare function getPageSectionPath(path: string): string;
+/**
+ * Check if a path matches a pattern (supports * wildcard).
+ *
+ * @example
+ * ```ts
+ * matchPath('home.hero.title', 'home.*.title') // true
+ * matchPath('home.hero.title', 'home.hero.*') // true
+ * matchPath('home.hero.title', '*.hero.*') // true
+ * ```
+ */
+export declare function matchPath(path: string, pattern: string): boolean;
+/**
+ * Sort paths by page, then section, then field.
+ */
+export declare function sortPaths(paths: string[]): string[];
+/**
+ * Group paths by page.
+ */
+export declare function groupPathsByPage(paths: string[]): Map<string, string[]>;
+/**
+ * Group paths by page and section.
+ */
+export declare function groupPathsBySection(paths: string[]): Map<string, Map<string, string[]>>;
+//# sourceMappingURL=path.d.ts.map

package/dist/utils/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAiElD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CA0BpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAchE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAoBnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAWvE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAavF"}

package/dist/utils/path.js

@@ -0,0 +1,219 @@
+/**
+ * Path utilities for parsing and building field paths.
+ * Field paths follow the format: page.section.field or page.section.$.field for repeaters.
+ */
+import { PATH_SEPARATOR, REPEATER_PLACEHOLDER } from '../constants.js';
+/**
+ * Parse a field path into its components.
+ *
+ * @example
+ * ```ts
+ * parsePath('home.hero.title')
+ * // { page: 'home', section: 'hero', field: 'title', isRepeater: false, full: 'home.hero.title' }
+ *
+ * parsePath('home.features.$.title')
+ * // { page: 'home', section: 'features', field: '$', isRepeater: true, repeaterField: 'title', full: 'home.features.$.title' }
+ * ```
+ */
+export function parsePath(path) {
+    const trimmed = path.trim();
+    if (!trimmed) {
+        throw new Error('Path cannot be empty');
+    }
+    const parts = trimmed.split(PATH_SEPARATOR);
+    if (parts.length < 3) {
+        throw new Error(`Invalid path "${path}": must have at least 3 parts (page.section.field)`);
+    }
+    // Check for empty parts (consecutive dots or leading/trailing dots)
+    for (let i = 0; i < parts.length; i++) {
+        const part = parts[i];
+        if (!part || (part !== REPEATER_PLACEHOLDER && part.trim() === '')) {
+            throw new Error(`Invalid path "${path}": contains empty segment at position ${i + 1}`);
+        }
+    }
+    const page = parts[0];
+    const section = parts[1];
+    // Count $ placeholders
+    const dollarCount = parts.filter((p) => p === REPEATER_PLACEHOLDER).length;
+    if (dollarCount > 1) {
+        throw new Error(`Invalid path "${path}": can only contain one $ repeater placeholder`);
+    }
+    const isRepeater = dollarCount === 1;
+    if (isRepeater) {
+        const repeaterIndex = parts.indexOf(REPEATER_PLACEHOLDER);
+        // $ must be at position 2 (third element: page.section.$)
+        if (repeaterIndex !== 2) {
+            throw new Error(`Invalid path "${path}": $ placeholder must be at position 3 (page.section.$)`);
+        }
+        const repeaterField = parts.slice(repeaterIndex + 1).join(PATH_SEPARATOR) || undefined;
+        return {
+            page,
+            section,
+            field: REPEATER_PLACEHOLDER,
+            isRepeater: true,
+            repeaterField,
+            full: trimmed,
+        };
+    }
+    // For non-repeaters: page.section.field
+    const field = parts.slice(2).join(PATH_SEPARATOR);
+    return {
+        page,
+        section,
+        field,
+        isRepeater: false,
+        full: trimmed,
+    };
+}
+/**
+ * Build a field path from components.
+ *
+ * @example
+ * ```ts
+ * buildPath('home', 'hero', 'title')
+ * // 'home.hero.title'
+ *
+ * buildPath('home', 'features', '$', 'title')
+ * // 'home.features.$.title'
+ * ```
+ */
+export function buildPath(...parts) {
+    // Check for empty parts first
+    for (let i = 0; i < parts.length; i++) {
+        if (!parts[i] || parts[i]?.trim() === '') {
+            throw new Error(`Path part at index ${i} cannot be empty`);
+        }
+    }
+    if (parts.length < 3) {
+        throw new Error('Path must have at least 3 parts (page.section.field)');
+    }
+    // Validate $ placeholder usage
+    const dollarIndices = parts
+        .map((part, index) => (part === REPEATER_PLACEHOLDER ? index : -1))
+        .filter((i) => i !== -1);
+    if (dollarIndices.length > 1) {
+        throw new Error('Path can only contain one $ repeater placeholder');
+    }
+    if (dollarIndices.length === 1 && dollarIndices[0] !== 2) {
+        throw new Error('Repeater placeholder $ must be at position 3 (page.section.$)');
+    }
+    return parts.join(PATH_SEPARATOR);
+}
+/**
+ * Get the page from a field path.
+ */
+export function getPageFromPath(path) {
+    const parsed = parsePath(path);
+    return parsed.page;
+}
+/**
+ * Get the section from a field path.
+ */
+export function getSectionFromPath(path) {
+    const parsed = parsePath(path);
+    return parsed.section;
+}
+/**
+ * Get the field name from a field path.
+ */
+export function getFieldFromPath(path) {
+    const parsed = parsePath(path);
+    return parsed.repeaterField ?? parsed.field;
+}
+/**
+ * Check if a path is a repeater path.
+ */
+export function isRepeaterPath(path) {
+    return (path.includes(`${PATH_SEPARATOR}${REPEATER_PLACEHOLDER}${PATH_SEPARATOR}`) ||
+        path.endsWith(`${PATH_SEPARATOR}${REPEATER_PLACEHOLDER}`));
+}
+/**
+ * Get the parent path (page.section or page.section.$ for repeaters).
+ */
+export function getParentPath(path) {
+    const parts = path.split(PATH_SEPARATOR);
+    if (parts.length <= 2) {
+        return parts[0] ?? '';
+    }
+    return parts.slice(0, -1).join(PATH_SEPARATOR);
+}
+/**
+ * Get the page.section path.
+ */
+export function getPageSectionPath(path) {
+    const parsed = parsePath(path);
+    return `${parsed.page}${PATH_SEPARATOR}${parsed.section}`;
+}
+/**
+ * Check if a path matches a pattern (supports * wildcard).
+ *
+ * @example
+ * ```ts
+ * matchPath('home.hero.title', 'home.*.title') // true
+ * matchPath('home.hero.title', 'home.hero.*') // true
+ * matchPath('home.hero.title', '*.hero.*') // true
+ * ```
+ */
+export function matchPath(path, pattern) {
+    const pathParts = path.split(PATH_SEPARATOR);
+    const patternParts = pattern.split(PATH_SEPARATOR);
+    if (pathParts.length !== patternParts.length) {
+        return false;
+    }
+    return patternParts.every((patternPart, index) => {
+        if (patternPart === '*') {
+            return true;
+        }
+        return patternPart === pathParts[index];
+    });
+}
+/**
+ * Sort paths by page, then section, then field.
+ */
+export function sortPaths(paths) {
+    return [...paths].sort((a, b) => {
+        const parsedA = parsePath(a);
+        const parsedB = parsePath(b);
+        // Sort by page
+        if (parsedA.page !== parsedB.page) {
+            return parsedA.page.localeCompare(parsedB.page);
+        }
+        // Sort by section
+        if (parsedA.section !== parsedB.section) {
+            return parsedA.section.localeCompare(parsedB.section);
+        }
+        // Sort by field
+        const fieldA = parsedA.repeaterField ?? parsedA.field;
+        const fieldB = parsedB.repeaterField ?? parsedB.field;
+        return fieldA.localeCompare(fieldB);
+    });
+}
+/**
+ * Group paths by page.
+ */
+export function groupPathsByPage(paths) {
+    const grouped = new Map();
+    for (const path of paths) {
+        const page = getPageFromPath(path);
+        const existing = grouped.get(page) ?? [];
+        existing.push(path);
+        grouped.set(page, existing);
+    }
+    return grouped;
+}
+/**
+ * Group paths by page and section.
+ */
+export function groupPathsBySection(paths) {
+    const grouped = new Map();
+    for (const path of paths) {
+        const parsed = parsePath(path);
+        const pageGroup = grouped.get(parsed.page) ?? new Map();
+        const sectionPaths = pageGroup.get(parsed.section) ?? [];
+        sectionPaths.push(path);
+        pageGroup.set(parsed.section, sectionPaths);
+        grouped.set(parsed.page, pageGroup);
+    }
+    return grouped;
+}
+//# sourceMappingURL=path.js.map

package/dist/utils/path.js.map

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

package/dist/utils/validation.d.ts

@@ -0,0 +1,256 @@
+/**
+ * Validation schemas and utilities using Zod.
+ */
+import { z } from 'zod';
+import type { FieldType } from '../types/fields.js';
+/**
+ * All valid field types.
+ */
+export declare const FIELD_TYPES: FieldType[];
+/**
+ * Zod schema for field type validation.
+ */
+export declare const fieldTypeSchema: z.ZodEnum<{
+    number: "number";
+    boolean: "boolean";
+    text: "text";
+    textarea: "textarea";
+    range: "range";
+    email: "email";
+    url: "url";
+    phone: "phone";
+    wysiwyg: "wysiwyg";
+    markdown: "markdown";
+    code: "code";
+    blocks: "blocks";
+    select: "select";
+    multiselect: "multiselect";
+    checkbox: "checkbox";
+    checkboxgroup: "checkboxgroup";
+    radio: "radio";
+    image: "image";
+    file: "file";
+    gallery: "gallery";
+    video: "video";
+    audio: "audio";
+    oembed: "oembed";
+    date: "date";
+    datetime: "datetime";
+    time: "time";
+    relation: "relation";
+    taxonomy: "taxonomy";
+    link: "link";
+    pagelink: "pagelink";
+    user: "user";
+    color: "color";
+    map: "map";
+    repeater: "repeater";
+    group: "group";
+    flexible: "flexible";
+    message: "message";
+    tab: "tab";
+    accordion: "accordion";
+    buttongroup: "buttongroup";
+}>;
+/**
+ * Zod schema for field path validation.
+ */
+export declare const fieldPathSchema: z.ZodString;
+/**
+ * Zod schema for field attributes validation.
+ */
+export declare const fieldAttributesSchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        number: "number";
+        boolean: "boolean";
+        text: "text";
+        textarea: "textarea";
+        range: "range";
+        email: "email";
+        url: "url";
+        phone: "phone";
+        wysiwyg: "wysiwyg";
+        markdown: "markdown";
+        code: "code";
+        blocks: "blocks";
+        select: "select";
+        multiselect: "multiselect";
+        checkbox: "checkbox";
+        checkboxgroup: "checkboxgroup";
+        radio: "radio";
+        image: "image";
+        file: "file";
+        gallery: "gallery";
+        video: "video";
+        audio: "audio";
+        oembed: "oembed";
+        date: "date";
+        datetime: "datetime";
+        time: "time";
+        relation: "relation";
+        taxonomy: "taxonomy";
+        link: "link";
+        pagelink: "pagelink";
+        user: "user";
+        color: "color";
+        map: "map";
+        repeater: "repeater";
+        group: "group";
+        flexible: "flexible";
+        message: "message";
+        tab: "tab";
+        accordion: "accordion";
+        buttongroup: "buttongroup";
+    }>>;
+    label: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodCoercedBoolean<unknown>>;
+    validation: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodString>;
+    condition: z.ZodOptional<z.ZodString>;
+    default: z.ZodOptional<z.ZodString>;
+    help: z.ZodOptional<z.ZodString>;
+    min: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    max: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    step: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    accept: z.ZodOptional<z.ZodString>;
+    multiple: z.ZodOptional<z.ZodCoercedBoolean<unknown>>;
+    rows: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    width: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    readonly: z.ZodOptional<z.ZodCoercedBoolean<unknown>>;
+    hidden: z.ZodOptional<z.ZodCoercedBoolean<unknown>>;
+}, z.core.$strip>;
+/**
+ * Zod schema for a complete field schema.
+ */
+export declare const fieldSchema: z.ZodObject<{
+    label: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodCoercedBoolean<unknown>>;
+    validation: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodString>;
+    condition: z.ZodOptional<z.ZodString>;
+    default: z.ZodOptional<z.ZodString>;
+    help: z.ZodOptional<z.ZodString>;
+    min: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    max: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    step: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    accept: z.ZodOptional<z.ZodString>;
+    multiple: z.ZodOptional<z.ZodCoercedBoolean<unknown>>;
+    rows: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    width: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    readonly: z.ZodOptional<z.ZodCoercedBoolean<unknown>>;
+    hidden: z.ZodOptional<z.ZodCoercedBoolean<unknown>>;
+    path: z.ZodString;
+    type: z.ZodEnum<{
+        number: "number";
+        boolean: "boolean";
+        text: "text";
+        textarea: "textarea";
+        range: "range";
+        email: "email";
+        url: "url";
+        phone: "phone";
+        wysiwyg: "wysiwyg";
+        markdown: "markdown";
+        code: "code";
+        blocks: "blocks";
+        select: "select";
+        multiselect: "multiselect";
+        checkbox: "checkbox";
+        checkboxgroup: "checkboxgroup";
+        radio: "radio";
+        image: "image";
+        file: "file";
+        gallery: "gallery";
+        video: "video";
+        audio: "audio";
+        oembed: "oembed";
+        date: "date";
+        datetime: "datetime";
+        time: "time";
+        relation: "relation";
+        taxonomy: "taxonomy";
+        link: "link";
+        pagelink: "pagelink";
+        user: "user";
+        color: "color";
+        map: "map";
+        repeater: "repeater";
+        group: "group";
+        flexible: "flexible";
+        message: "message";
+        tab: "tab";
+        accordion: "accordion";
+        buttongroup: "buttongroup";
+    }>;
+    file: z.ZodString;
+    line: z.ZodNumber;
+    column: z.ZodNumber;
+    element: z.ZodOptional<z.ZodString>;
+    defaultContent: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Validate a field type string.
+ */
+export declare function isValidFieldType(type: string): type is FieldType;
+/**
+ * Validate a field path string.
+ */
+export declare function isValidFieldPath(path: string): boolean;
+/**
+ * Validate field attributes.
+ */
+export declare function validateFieldAttributes(attrs: Record<string, unknown>): {
+    success: boolean;
+    data?: z.infer<typeof fieldAttributesSchema>;
+    errors?: string[];
+};
+/**
+ * Validate a complete field schema.
+ */
+export declare function validateFieldSchema(schema: unknown): {
+    success: boolean;
+    data?: z.infer<typeof fieldSchema>;
+    errors?: string[];
+};
+/**
+ * Check if an attribute name is a valid data-reverso-* attribute.
+ */
+export declare function isValidAttribute(name: string): boolean;
+/**
+ * Extract the attribute name from a data-reverso-* attribute.
+ *
+ * @example
+ * ```ts
+ * extractAttributeName('data-reverso-type') // 'type'
+ * extractAttributeName('data-reverso') // null
+ * extractAttributeName('data-other') // null
+ * ```
+ */
+export declare function extractAttributeName(attr: string): string | null;
+/**
+ * Parse options string into array of option objects.
+ *
+ * @example
+ * ```ts
+ * parseOptions('red,green,blue')
+ * // [{ label: 'Red', value: 'red' }, { label: 'Green', value: 'green' }, { label: 'Blue', value: 'blue' }]
+ *
+ * parseOptions('[{"label":"Red","value":"#f00"}]')
+ * // [{ label: 'Red', value: '#f00' }]
+ * ```
+ */
+export declare function parseOptions(optionsStr: string): Array<{
+    label: string;
+    value: string;
+}>;
+/**
+ * Parse a condition string (basic format: field=value or field!=value).
+ */
+export declare function parseCondition(conditionStr: string): {
+    field: string;
+    operator: '=' | '!=' | '>' | '<' | '>=' | '<=';
+    value: string;
+} | null;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,EAyClC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAqD,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,eAAe,aAU3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmBhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQtB,CAAC;AAEH;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,SAAS,CAEhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACvE,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;IAC7C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CASA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CASA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQhE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CA+CxF;AASD;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,IAAI,CAeP"}