@pilotiq/pilotiq 0.1.0

package/dist/validation/rules.js

@@ -0,0 +1,61 @@
+import { makeValidator } from './Validator.js';
+const isEmpty = (v) => v === undefined || v === null || v === '';
+export function required(message = 'This field is required') {
+    return makeValidator(v => (isEmpty(v) ? message : null), { rule: 'required', message });
+}
+const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+export function email(message = 'Must be a valid email') {
+    return makeValidator(v => {
+        if (isEmpty(v))
+            return null;
+        if (typeof v !== 'string' || !EMAIL_RE.test(v))
+            return message;
+        return null;
+    }, { rule: 'email', message });
+}
+export function minLength(n, message = `Must be at least ${n} characters`) {
+    return makeValidator(v => {
+        if (isEmpty(v))
+            return null;
+        if (typeof v !== 'string')
+            return null;
+        return v.length < n ? message : null;
+    }, { rule: 'minLength', value: n, message });
+}
+export function maxLength(n, message = `Must be at most ${n} characters`) {
+    return makeValidator(v => {
+        if (isEmpty(v))
+            return null;
+        if (typeof v !== 'string')
+            return null;
+        return v.length > n ? message : null;
+    }, { rule: 'maxLength', value: n, message });
+}
+export function min(n, message = `Must be at least ${n}`) {
+    return makeValidator(v => {
+        if (isEmpty(v))
+            return null;
+        if (typeof v !== 'number')
+            return null;
+        return v < n ? message : null;
+    }, { rule: 'min', value: n, message });
+}
+export function max(n, message = `Must be at most ${n}`) {
+    return makeValidator(v => {
+        if (isEmpty(v))
+            return null;
+        if (typeof v !== 'number')
+            return null;
+        return v > n ? message : null;
+    }, { rule: 'max', value: n, message });
+}
+export function pattern(regex, message = 'Invalid format') {
+    return makeValidator(v => {
+        if (isEmpty(v))
+            return null;
+        if (typeof v !== 'string')
+            return null;
+        return regex.test(v) ? null : message;
+    }, { rule: 'pattern', source: regex.source, flags: regex.flags, message });
+}
+//# sourceMappingURL=rules.js.map

package/dist/validation/rules.js.map

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

package/dist/validation/runValidators.d.ts

@@ -0,0 +1,30 @@
+import { Element } from '../schema/Element.js';
+export interface ValidationErrors {
+    [fieldName: string]: string[];
+}
+/**
+ * Walk an Element tree, run every Field's validators against the matching
+ * value in `values`, and return a `{ name -> errors[] }` map.
+ *
+ * The map is empty when every field passes. Fields with no validators
+ * (and no `required` flag) never appear in the output. The caller decides
+ * whether a non-empty map should reject the submit.
+ *
+ * `record` is the persisted record under edit, when present — it propagates
+ * to each validator's `ctx` for cross-field rules that need it.
+ *
+ * Plan #14 — Repeater fields validate each row's inner schema recursively.
+ * Per-row errors are flat-keyed as `${fieldName}.${i}.${childName}` so the
+ * client can surface them inline on the right row. `minItems` / `maxItems`
+ * land under the bare repeater name.
+ *
+ * Async — `Field.runValidators` is awaited per field, so async validators
+ * (e.g. `unique()` probing the DB) work transparently. The walker is still
+ * sequential per field within the same scope to preserve declaration order
+ * in the error output; cross-field parallelism would only matter on forms
+ * with many DB-probing validators and is left for a future profile.
+ */
+export declare function validateSchema(elements: Element[], values: Record<string, unknown>, record?: unknown): Promise<ValidationErrors>;
+/** True when no field returned any error. */
+export declare function isValid(errors: ValidationErrors): boolean;
+//# sourceMappingURL=runValidators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runValidators.d.ts","sourceRoot":"","sources":["../../src/validation/runValidators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAK9C,MAAM,WAAW,gBAAgB;IAC/B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,EAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,MAAM,CAAC,EAAG,OAAO,GAChB,OAAO,CAAC,gBAAgB,CAAC,CAkC3B;AA2SD,6CAA6C;AAC7C,wBAAgB,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAEzD"}

package/dist/validation/runValidators.js

@@ -0,0 +1,438 @@
+import { Field } from '../fields/Field.js';
+import { RepeaterField } from '../fields/RepeaterField.js';
+import { BuilderField } from '../fields/BuilderField.js';
+/**
+ * Walk an Element tree, run every Field's validators against the matching
+ * value in `values`, and return a `{ name -> errors[] }` map.
+ *
+ * The map is empty when every field passes. Fields with no validators
+ * (and no `required` flag) never appear in the output. The caller decides
+ * whether a non-empty map should reject the submit.
+ *
+ * `record` is the persisted record under edit, when present — it propagates
+ * to each validator's `ctx` for cross-field rules that need it.
+ *
+ * Plan #14 — Repeater fields validate each row's inner schema recursively.
+ * Per-row errors are flat-keyed as `${fieldName}.${i}.${childName}` so the
+ * client can surface them inline on the right row. `minItems` / `maxItems`
+ * land under the bare repeater name.
+ *
+ * Async — `Field.runValidators` is awaited per field, so async validators
+ * (e.g. `unique()` probing the DB) work transparently. The walker is still
+ * sequential per field within the same scope to preserve declaration order
+ * in the error output; cross-field parallelism would only matter on forms
+ * with many DB-probing validators and is left for a future profile.
+ */
+export async function validateSchema(elements, values, record) {
+    const errors = {};
+    const fields = [];
+    const repeaters = [];
+    const builders = [];
+    // Two-pass to preserve order: collect first (sync walk), then await each.
+    walk(elements, el => {
+        if (el instanceof RepeaterField) {
+            repeaters.push(el);
+            return;
+        }
+        if (el instanceof BuilderField) {
+            builders.push(el);
+            return;
+        }
+        if (el instanceof Field)
+            fields.push(el);
+    });
+    for (const el of fields) {
+        const value = values[el.name];
+        const ctx = { values };
+        if (record !== undefined)
+            ctx.record = record;
+        const fieldErrors = await el.runValidators(value, ctx);
+        if (fieldErrors.length > 0)
+            errors[el.name] = fieldErrors;
+    }
+    for (const rep of repeaters) {
+        const raw = values[rep.name];
+        const rows = Array.isArray(raw) ? raw : foldFlatRepeaterRows(values, rep.name);
+        await validateRepeater(rep, rows, record, errors);
+    }
+    for (const bld of builders) {
+        const raw = values[bld.name];
+        const rows = Array.isArray(raw) ? raw : foldFlatBuilderRows(values, bld.name);
+        await validateBuilder(bld, rows, record, errors);
+    }
+    return errors;
+}
+async function validateRepeater(field, raw, record, errors) {
+    const rows = Array.isArray(raw) ? raw : [];
+    const baseErrors = [];
+    const min = field.getMinItems();
+    if (min !== undefined && rows.length < min) {
+        baseErrors.push(min === 1
+            ? 'At least 1 item is required'
+            : `At least ${min} items are required`);
+    }
+    const max = field.getMaxItems();
+    if (max !== undefined && rows.length > max) {
+        baseErrors.push(max === 1
+            ? 'At most 1 item is allowed'
+            : `At most ${max} items are allowed`);
+    }
+    if (baseErrors.length > 0)
+        errors[field.name] = baseErrors;
+    const inner = field.getInnerSchema();
+    const simpleInner = field.getSimpleInnerField();
+    for (let i = 0; i < rows.length; i++) {
+        const row = rows[i];
+        // For `simple()` repeaters, wrap primitive entries inline so per-field
+        // validators run against the standard `{ <innerName>: v }` shape. A
+        // primitive in a non-simple Repeater is genuinely malformed and gets
+        // skipped (the prior posture).
+        let rowValues;
+        if (row && typeof row === 'object' && !Array.isArray(row)) {
+            rowValues = row;
+        }
+        else if (simpleInner && row !== undefined) {
+            rowValues = { [simpleInner.name]: row };
+        }
+        else {
+            rowValues = null;
+        }
+        if (!rowValues)
+            continue;
+        const rowErrors = await validateSchema(inner, rowValues, record);
+        for (const [childName, msgs] of Object.entries(rowErrors)) {
+            errors[`${field.name}.${i}.${childName}`] = msgs;
+        }
+    }
+    checkDistinctRows({
+        fieldName: field.name,
+        innerFields: collectDistinctFields(inner),
+        rows,
+        errorKey: (rowIdx, childName) => `${field.name}.${rowIdx}.${childName}`,
+        // `simple()` repeaters can hand bare primitive rows to the comparator;
+        // when the row matches the inner field, treat the primitive itself as
+        // the value. Object rows still read by child key as normal.
+        extractValue: (row, childName) => {
+            if (row && typeof row === 'object' && !Array.isArray(row)) {
+                return row[childName];
+            }
+            if (simpleInner && simpleInner.name === childName)
+                return row;
+            return undefined;
+        },
+        rowMatches: () => true,
+        errors,
+    });
+}
+/**
+ * Validate a single Builder field's rows. Per-row errors are flat-keyed
+ * `${field.name}.${i}.data.${childName}` so the client can surface them
+ * inline on the right row's inner field. `minItems` / `maxItems` /
+ * `Block.maxItems` (per-block-type ceiling) and unknown-block-type
+ * errors land under the bare builder name.
+ */
+async function validateBuilder(field, raw, record, errors) {
+    const rows = Array.isArray(raw) ? raw : [];
+    const baseErrors = [];
+    const min = field.getMinItems();
+    if (min !== undefined && rows.length < min) {
+        baseErrors.push(min === 1
+            ? 'At least 1 item is required'
+            : `At least ${min} items are required`);
+    }
+    const max = field.getMaxItems();
+    if (max !== undefined && rows.length > max) {
+        baseErrors.push(max === 1
+            ? 'At most 1 item is allowed'
+            : `At most ${max} items are allowed`);
+    }
+    // Per-block-type ceiling (`Block.maxItems`) is enforced post-row-walk
+    // so we can count the rows of each type in one pass.
+    const typeCounts = new Map();
+    for (let i = 0; i < rows.length; i++) {
+        const row = rows[i];
+        if (!row || typeof row !== 'object' || Array.isArray(row))
+            continue;
+        const t = row['type'];
+        if (typeof t === 'string' && t !== '') {
+            typeCounts.set(t, (typeCounts.get(t) ?? 0) + 1);
+        }
+    }
+    for (const block of field.getBlocks()) {
+        const cap = block.getMaxItems();
+        if (cap === undefined)
+            continue;
+        const count = typeCounts.get(block.name) ?? 0;
+        if (count > cap) {
+            baseErrors.push(cap === 1
+                ? `At most 1 "${block.getLabel()}" block is allowed`
+                : `At most ${cap} "${block.getLabel()}" blocks are allowed`);
+        }
+    }
+    for (let i = 0; i < rows.length; i++) {
+        const row = rows[i];
+        if (!row || typeof row !== 'object' || Array.isArray(row))
+            continue;
+        const r = row;
+        const t = r['type'];
+        if (typeof t !== 'string' || t === '') {
+            errors[`${field.name}.${i}`] = ['Block type is required'];
+            continue;
+        }
+        const block = field.getBlock(t);
+        if (!block) {
+            errors[`${field.name}.${i}`] = [`Unknown block type "${t}"`];
+            continue;
+        }
+        const dataRaw = r['data'];
+        const data = (dataRaw && typeof dataRaw === 'object' && !Array.isArray(dataRaw))
+            ? dataRaw
+            : {};
+        const rowErrors = await validateSchema(block.getSchema(), data, record);
+        for (const [childName, msgs] of Object.entries(rowErrors)) {
+            errors[`${field.name}.${i}.data.${childName}`] = msgs;
+        }
+    }
+    // Distinct check is per-block-type — comparing a `heading.title` against a
+    // `paragraph.text` is meaningless (different schemas, different fields).
+    // We re-walk the rows once per block type so each pass only sees rows
+    // matching that type.
+    for (const block of field.getBlocks()) {
+        const distinctFields = collectDistinctFields(block.getSchema());
+        if (distinctFields.length === 0)
+            continue;
+        checkDistinctRows({
+            fieldName: field.name,
+            innerFields: distinctFields,
+            rows,
+            errorKey: (rowIdx, childName) => `${field.name}.${rowIdx}.data.${childName}`,
+            extractValue: (row, childName) => {
+                if (!row || typeof row !== 'object' || Array.isArray(row))
+                    return undefined;
+                const r = row;
+                const data = r['data'];
+                if (!data || typeof data !== 'object' || Array.isArray(data))
+                    return undefined;
+                return data[childName];
+            },
+            rowMatches: row => {
+                if (!row || typeof row !== 'object' || Array.isArray(row))
+                    return false;
+                return row['type'] === block.name;
+            },
+            errors,
+        });
+    }
+    if (baseErrors.length > 0)
+        errors[field.name] = baseErrors;
+}
+/**
+ * Walk the inner schema for fields with `.distinct()` set. Stops at any
+ * nested Repeater / Builder so the outer field's distinct pass doesn't
+ * accidentally walk into a child array's leaves (those rows are
+ * validated by their own array-field pass when they're submitted).
+ */
+function collectDistinctFields(elements) {
+    const out = [];
+    const visit = (els) => {
+        for (const el of els) {
+            if (el instanceof RepeaterField)
+                continue;
+            if (el instanceof BuilderField)
+                continue;
+            if (el instanceof Field) {
+                const opts = el.getDistinct();
+                if (opts)
+                    out.push({ field: el, opts });
+            }
+            const children = el.getChildren();
+            if (children && children.length > 0)
+                visit(children);
+        }
+    };
+    visit(elements);
+    return out;
+}
+/**
+ * Cross-row distinct comparison shared by Repeater + Builder. The first
+ * occurrence of each value passes; subsequent rows with the same value
+ * (after `caseInsensitive` / `ignoreNulls` normalization) get the
+ * configured rejection message under their flat-keyed error path.
+ *
+ * `rowMatches` lets the Builder caller scope the comparison to a single
+ * block type; Repeater always passes `() => true`.
+ */
+function checkDistinctRows(args) {
+    if (args.innerFields.length === 0)
+        return;
+    for (const { field: child, opts } of args.innerFields) {
+        const ignoreNulls = opts.ignoreNulls !== false; // default true
+        const seen = new Map();
+        for (let i = 0; i < args.rows.length; i++) {
+            const row = args.rows[i];
+            if (!args.rowMatches(row))
+                continue;
+            const value = args.extractValue(row, child.name);
+            if (ignoreNulls && (value === undefined || value === null || value === ''))
+                continue;
+            const key = (opts.caseInsensitive && typeof value === 'string')
+                ? value.toLowerCase()
+                : value;
+            if (!seen.has(key)) {
+                seen.set(key, i);
+                continue;
+            }
+            const errKey = args.errorKey(i, child.name);
+            const message = opts.message ?? 'Must be unique';
+            const existing = args.errors[errKey];
+            if (existing)
+                existing.push(message);
+            else
+                args.errors[errKey] = [message];
+        }
+    }
+}
+/**
+ * Group flat-key form-encoded Builder rows into an array of row bodies
+ * shaped `{ __id?, type, data: {…} }`. Mirrors `coerceBuilderValue` in
+ * `dispatchForm.ts`. Validation runs before coercion so we can't reuse
+ * the coerced array directly.
+ */
+function foldFlatBuilderRows(values, fieldName) {
+    const prefix = `${fieldName}.`;
+    const grouped = new Map();
+    let maxIdx = -1;
+    for (const key of Object.keys(values)) {
+        if (!key.startsWith(prefix))
+            continue;
+        const rest = key.slice(prefix.length);
+        const dot = rest.indexOf('.');
+        if (dot < 0)
+            continue;
+        const idxStr = rest.slice(0, dot);
+        const tail = rest.slice(dot + 1);
+        const idx = Number(idxStr);
+        if (!Number.isInteger(idx) || idx < 0)
+            continue;
+        if (idx > maxIdx)
+            maxIdx = idx;
+        let row = grouped.get(idx);
+        if (!row) {
+            row = { type: '', data: {} };
+            grouped.set(idx, row);
+        }
+        const value = values[key];
+        if (tail === '__id') {
+            if (typeof value === 'string')
+                row.__id = value;
+        }
+        else if (tail === 'type') {
+            if (typeof value === 'string')
+                row.type = value;
+        }
+        else if (tail.startsWith('data.')) {
+            row.data[tail.slice('data.'.length)] = value;
+        }
+    }
+    if (maxIdx < 0)
+        return [];
+    const out = [];
+    for (let i = 0; i <= maxIdx; i++) {
+        const row = grouped.get(i) ?? { type: '', data: {} };
+        const obj = { type: row.type, data: row.data };
+        if (typeof row.__id === 'string')
+            obj['__id'] = row.__id;
+        out.push(obj);
+    }
+    while (out.length > 0 && isBuilderRowEmpty(out[out.length - 1]))
+        out.pop();
+    return out;
+}
+function isBuilderRowEmpty(row) {
+    const data = row['data'];
+    if (!data || typeof data !== 'object' || Array.isArray(data))
+        return true;
+    for (const [, v] of Object.entries(data)) {
+        if (v === undefined || v === null || v === '')
+            continue;
+        return false;
+    }
+    return true;
+}
+/** True when no field returned any error. */
+export function isValid(errors) {
+    return Object.keys(errors).length === 0;
+}
+/**
+ * Group flat-key form-encoded Repeater rows into an array of row bodies.
+ * Mirrors the same fold path as `coerceRepeaterValue` in
+ * `dispatchForm.ts` but kept private here so validation works against
+ * raw bodies (validation runs before coercion in `dispatchFormSubmit`).
+ *
+ * Returns an empty array when no matching keys exist — the Repeater's
+ * `minItems` validator then surfaces the right error.
+ */
+function foldFlatRepeaterRows(values, fieldName) {
+    const prefix = `${fieldName}.`;
+    const grouped = new Map();
+    let maxIdx = -1;
+    for (const key of Object.keys(values)) {
+        if (!key.startsWith(prefix))
+            continue;
+        const rest = key.slice(prefix.length);
+        const dot = rest.indexOf('.');
+        if (dot < 0)
+            continue;
+        const idxStr = rest.slice(0, dot);
+        const childKey = rest.slice(dot + 1);
+        const idx = Number(idxStr);
+        if (!Number.isInteger(idx) || idx < 0)
+            continue;
+        if (idx > maxIdx)
+            maxIdx = idx;
+        let row = grouped.get(idx);
+        if (!row) {
+            row = {};
+            grouped.set(idx, row);
+        }
+        row[childKey] = values[key];
+    }
+    if (maxIdx < 0)
+        return [];
+    // Trim trailing untouched rows so `minItems` lines up with what
+    // coercion will eventually persist.
+    const out = [];
+    for (let i = 0; i <= maxIdx; i++)
+        out.push(grouped.get(i) ?? {});
+    while (out.length > 0 && isRowEmpty(out[out.length - 1]))
+        out.pop();
+    return out;
+}
+function isRowEmpty(row) {
+    for (const [k, v] of Object.entries(row)) {
+        if (k === '__id')
+            continue;
+        if (v === undefined || v === null || v === '')
+            continue;
+        return false;
+    }
+    return true;
+}
+function walk(elements, visit) {
+    for (const el of elements) {
+        visit(el);
+        // Plan #14 — don't recurse into Repeater / Builder children. The
+        // visitor handles per-row validation by calling `validateSchema`
+        // recursively against the row's local values map (per-block schema
+        // for Builder). Recursing here would validate inner fields against
+        // the parent `values`, missing the row scope entirely.
+        if (el instanceof RepeaterField)
+            continue;
+        if (el instanceof BuilderField)
+            continue;
+        const children = el.getChildren();
+        if (children && children.length > 0)
+            walk(children, visit);
+    }
+}
+//# sourceMappingURL=runValidators.js.map

package/dist/validation/runValidators.js.map

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

package/dist/validation/uniqueValidator.d.ts

@@ -0,0 +1,61 @@
+import { type Validator, type ValidatorContext } from './Validator.js';
+import { type ModelLike } from '../orm/modelDefaults.js';
+export interface UniqueOptions {
+    /**
+     * The model to probe. Any `ModelLike` works — `query().where(col, value)
+     * .paginate(1, 2)` is the only contract used, so no new ORM method is
+     * required. A class extending `@rudderjs/orm`'s `Model` satisfies this
+     * automatically.
+     */
+    model: ModelLike;
+    /**
+     * Column to match the field's value against. Defaults to the field's own
+     * name — sufficient for the common `email` / `slug` / `username` case.
+     */
+    column?: string;
+    /**
+     * Whether to exclude the record under edit from the probe. Defaults to
+     * `true` — on edit, the validator skips when the only matching row IS
+     * the current record (so saving "no change" doesn't trigger a conflict).
+     * Pass `false` to forbid all matches even when editing the same row.
+     *
+     * Has no effect on create — there's no `ctx.record` to ignore.
+     */
+    ignoreRecord?: boolean;
+    /**
+     * Extra equality clauses for scoped uniqueness. Receives the validator
+     * context (`{ values, record }`) so the scope can read sibling fields:
+     *
+     *     unique({ model: Project, where: ({ values }) => ({ tenantId: values.tenantId }) })
+     *
+     * Each entry is applied as `query().where(key, value)`. Skipped entirely
+     * when the function returns `undefined` or an empty object.
+     */
+    where?: (ctx: ValidatorContext) => Record<string, unknown> | undefined;
+    /**
+     * Treat string comparisons as case-insensitive. Implemented via SQL
+     * `LIKE` on the value with `%` / `_` / `\` escaped — so it stays an
+     * exact match, just collation-folded. Works on SQLite (default `NOCASE`
+     * for ASCII) and MySQL (default collation), and is collation-dependent
+     * on Postgres. For Postgres apps that need locale-aware folding, use a
+     * `citext` column or a custom `where(fn)` against a generated lower-cased
+     * column instead of this flag.
+     */
+    caseInsensitive?: boolean;
+    /** Override the default error message. */
+    message?: string;
+}
+/**
+ * Async validator: rejects when another row in the table already has the
+ * same value in `column` (subject to `where` / `ignoreRecord`). Empty
+ * values pass — pair with `required()` if the field is mandatory.
+ *
+ * The probe is `M.query().where(column, value).paginate(1, 2)` — pulls at
+ * most 2 rows so we can distinguish "no match" / "only own record" /
+ * "real conflict" without a `count(*)` contract.
+ *
+ * Carries no `serialized` descriptor, so the client doesn't try to mirror
+ * the rule for live UX. The roundtrip happens once on submit.
+ */
+export declare function unique(opts: UniqueOptions): Validator;
+//# sourceMappingURL=uniqueValidator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uniqueValidator.d.ts","sourceRoot":"","sources":["../../src/validation/uniqueValidator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACrF,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAEvE,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,KAAK,EAAE,SAAS,CAAA;IAEhB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IAEtB;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,gBAAgB,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;IAEtE;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IAEzB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAgDrD"}