callman-core 1.38.0 → 1.40.0

package/dist/mock-engine/data/seed.js

@@ -0,0 +1,239 @@
+// Seed data: explicit records plus N generated ones per resource.
+//
+// Deterministic: the random source is seeded by (mockId, resource, salt), so
+// every session — and every replica — sees the same generated data. Resources
+// are generated in reference order (parents first) so ref fields point at
+// records that exist. Records whose unique values collide are skipped.
+import { hashPassword, isHashedPassword } from "../auth.js";
+import { seededRandom } from "../context.js";
+import { resolveDollarToken, resolveMockTemplate } from "../templates.js";
+import { randomIntBetween, randomNanoId, randomObjectId, randomUuid } from "../util.js";
+import { encodeRecord, valueFromKey } from "./record-codec.js";
+const NAME_HINTS = [
+    [/^(first_?name|given_?name)$/i, "$randomFirstName"],
+    [/^(last_?name|surname|family_?name)$/i, "$randomLastName"],
+    [/^(full_?name|name|display_?name|author)$/i, "$randomFullName"],
+    [/^(user_?name|login|handle)$/i, "$randomUserName"],
+    [/(phone|mobile|tel)/i, "$randomPhoneNumber"],
+    [/^city$/i, "$randomCity"],
+    [/^country$/i, "$randomCountry"],
+    [/^country_?code$/i, "$randomCountryCode"],
+    [/(address|street)/i, "$randomStreetAddress"],
+    [/(zip|postal)/i, "$randomZipCode"],
+    [/(company|organi[sz]ation)/i, "$randomCompanyName"],
+    [/^(job_?title|position)$/i, "$randomJobTitle"],
+    [/^department$/i, "$randomDepartment"],
+    [/^(title|subject|headline)$/i, "$randomSentence"],
+    [/(description|bio|body|content|summary|notes?)$/i, "$randomParagraph"],
+    [/(website|url|link|homepage)$/i, "$randomUrl"],
+    [/(avatar|image|photo|picture|thumbnail)/i, "$randomImageUrl"],
+    [/^colou?r$/i, "$randomColor"],
+    [/^(currency|currency_?code)$/i, "$randomCurrencyCode"],
+    [/^(product|product_?name)$/i, "$randomProductName"],
+    [/^(lat|latitude)$/i, "$randomLatitude"],
+    [/^(lng|lon|longitude)$/i, "$randomLongitude"],
+    [/^ip(_?address)?$/i, "$randomIP"],
+    [/^(domain|host(name)?)$/i, "$randomDomainName"],
+];
+const NUMBER_HINTS = [
+    [/(price|amount|total|cost|balance|salary)/i, (rt) => Math.round(randomIntBetween(() => rt.random.next(), 100, 100_000)) / 100],
+    [/(qty|quantity|count|stock)/i, (rt) => randomIntBetween(() => rt.random.next(), 0, 100)],
+    [/(age)$/i, (rt) => randomIntBetween(() => rt.random.next(), 18, 80)],
+    [/(rating|score|stars)/i, (rt) => randomIntBetween(() => rt.random.next(), 1, 5)],
+];
+const pickFrom = (rt, values) => values[Math.floor(rt.random.next() * values.length)] ?? values[0];
+const clampString = (field, value) => field.maxLength !== undefined && value.length > field.maxLength ? value.slice(0, field.maxLength) : value;
+/** A plausible value for one field (no uniqueness guarantee). */
+export const generateFieldValue = (field, rt, index, refPool) => {
+    if (field.ref) {
+        const pool = refPool[field.ref.resource] ?? [];
+        if (pool.length === 0)
+            return field.nullable || !field.required ? null : undefined;
+        return pickFrom(rt, pool);
+    }
+    if (field.enum && field.enum.length > 0)
+        return pickFrom(rt, field.enum);
+    if (field.fakerHint) {
+        const hint = field.fakerHint.trim();
+        let value;
+        if (hint.includes("{{"))
+            value = resolveMockTemplate(hint, { request: { method: "GET", params: {}, query: {}, headers: {} } }, rt);
+        else if (hint.startsWith("$"))
+            value = resolveDollarToken(hint, rt);
+        else if (hint.startsWith("faker.") || hint.startsWith("random."))
+            value = resolveMockTemplate(`{{${hint}}}`, { request: { method: "GET", params: {}, query: {}, headers: {} } }, rt);
+        if (value !== undefined && value !== null) {
+            if ((field.type === "number" || field.type === "integer") && typeof value === "string" && /^-?\d+(\.\d+)?$/.test(value)) {
+                return field.type === "integer" ? Math.round(Number(value)) : Number(value);
+            }
+            return typeof value === "string" ? clampString(field, value) : value;
+        }
+    }
+    const next = () => rt.random.next();
+    switch (field.type) {
+        case "email":
+            return resolveDollarToken("$randomEmail", rt);
+        case "uuid":
+            return randomUuid(next);
+        case "boolean":
+            return next() >= 0.5;
+        case "integer": {
+            const hint = NUMBER_HINTS.find(([re]) => re.test(field.name));
+            const base = hint ? Math.round(hint[1](rt)) : randomIntBetween(next, field.min ?? 1, field.max ?? 1000);
+            return Math.min(field.max ?? base, Math.max(field.min ?? base, base));
+        }
+        case "number": {
+            const hint = NUMBER_HINTS.find(([re]) => re.test(field.name));
+            const base = hint ? hint[1](rt) : Math.round((field.min ?? 0) * 100 + next() * ((field.max ?? 1000) - (field.min ?? 0)) * 100) / 100;
+            return Math.min(field.max ?? base, Math.max(field.min ?? base, base));
+        }
+        case "date":
+            return new Date(rt.now() - Math.floor(next() * 365) * 86_400_000).toISOString().slice(0, 10);
+        case "datetime":
+            return new Date(rt.now() - Math.floor(next() * 365 * 86_400_000)).toISOString();
+        case "password":
+            return "password";
+        case "object":
+            return {};
+        case "array":
+            return [];
+        default: {
+            const hint = NAME_HINTS.find(([re]) => re.test(field.name));
+            const value = hint ? resolveDollarToken(hint[1], rt) : `${String(resolveDollarToken("$randomWord", rt))} ${index + 1}`;
+            return clampString(field, String(value));
+        }
+    }
+};
+/** Parents before children (ref order); cycles fall back to declaration order. */
+export const resourcesInRefOrder = (definition) => {
+    const byName = new Map(definition.resources.map((resource) => [resource.name, resource]));
+    const ordered = [];
+    const state = new Map();
+    const visit = (resource) => {
+        const mark = state.get(resource.name);
+        if (mark === "done" || mark === "visiting")
+            return;
+        state.set(resource.name, "visiting");
+        for (const field of resource.fields) {
+            const parent = field.ref ? byName.get(field.ref.resource) : undefined;
+            if (parent && parent !== resource)
+                visit(parent);
+        }
+        state.set(resource.name, "done");
+        ordered.push(resource);
+    };
+    definition.resources.forEach(visit);
+    return ordered;
+};
+const assignId = (resource, record, rt, seq, now) => {
+    if (record[resource.idField] !== undefined && record[resource.idField] !== null && record[resource.idField] !== "") {
+        const value = record[resource.idField];
+        if (typeof value === "number" && value > seq.value)
+            seq.value = value;
+        return;
+    }
+    const next = () => rt.random.next();
+    switch (resource.idStrategy) {
+        case "incremental":
+            seq.value += 1;
+            record[resource.idField] = seq.value;
+            break;
+        case "nanoid":
+            record[resource.idField] = randomNanoId(next);
+            break;
+        case "objectId":
+            record[resource.idField] = randomObjectId(next, now);
+            break;
+        default:
+            record[resource.idField] = randomUuid(next);
+    }
+};
+/** Build the complete seed plan for a namespace. */
+export const buildSeedPlan = async (definition, options) => {
+    const docs = [];
+    const sequences = {};
+    const refPool = {};
+    for (const resource of resourcesInRefOrder(definition)) {
+        const seed = resource.seed;
+        const rt = {
+            random: seededRandom(`${options.mockId}:${resource.resourceId}:${seed?.salt ?? ""}`),
+            now: () => options.now,
+        };
+        const seq = { value: 0 };
+        const explicit = (seed?.records ?? []).map((record) => ({ ...record }));
+        // Explicit numeric ids raise the sequence before generation starts.
+        for (const record of explicit) {
+            const id = record[resource.idField];
+            if (typeof id === "number" && id > seq.value)
+                seq.value = id;
+        }
+        const generateCount = Math.max(0, Math.min(seed?.generate ?? 0, options.maxGenerate));
+        const generated = [];
+        for (let i = 0; i < generateCount; i += 1) {
+            const record = {};
+            for (const field of resource.fields) {
+                if (field.name === resource.idField)
+                    continue;
+                if (field.default !== undefined && field.fakerHint === undefined && !field.enum) {
+                    record[field.name] = typeof field.default === "string" && field.default.includes("{{")
+                        ? resolveMockTemplate(field.default, { request: { method: "GET", params: {}, query: {}, headers: {} } }, rt)
+                        : field.default;
+                    continue;
+                }
+                const value = generateFieldValue(field, rt, i, refPool);
+                if (value !== undefined)
+                    record[field.name] = value;
+            }
+            generated.push(record);
+        }
+        const all = [...explicit, ...generated];
+        const seenUnique = new Set();
+        const total = all.length;
+        let index = 0;
+        for (const record of all) {
+            assignId(resource, record, rt, seq, options.now);
+            const stamp = new Date(options.now - (total - index) * 60_000).toISOString();
+            if (resource.timestamps.createdAt && record[resource.timestamps.createdAt] === undefined)
+                record[resource.timestamps.createdAt] = stamp;
+            if (resource.timestamps.updatedAt && record[resource.timestamps.updatedAt] === undefined)
+                record[resource.timestamps.updatedAt] = stamp;
+            for (const field of resource.fields) {
+                if (field.type === "password" && typeof record[field.name] === "string" && !isHashedPassword(record[field.name])) {
+                    record[field.name] = await hashPassword(options.crypto, record[field.name]);
+                }
+            }
+            index += 1;
+            const encoded = encodeRecord(resource, record, 1);
+            if (!encoded.ok)
+                continue;
+            if (encoded.doc.uniq.some((token) => seenUnique.has(token)))
+                continue;
+            encoded.doc.uniq.forEach((token) => seenUnique.add(token));
+            encoded.doc.ordinal = docs.length + 1;
+            docs.push(encoded.doc);
+            const pool = refPool[resource.name] ?? (refPool[resource.name] = []);
+            pool.push(valueFromKey(encoded.doc.key));
+        }
+        if (seq.value > 0)
+            sequences[resource.resourceId] = seq.value;
+    }
+    return { docs, sequences };
+};
+/** Generate records for previews and the data browser's "Generate" (passwords left plain). */
+export const generateSeedRecords = (resource, count, options = {}) => {
+    const rt = { random: seededRandom(options.seed ?? `${resource.resourceId}:preview:${Date.now()}`), now: () => options.now ?? Date.now() };
+    const out = [];
+    for (let i = 0; i < count; i += 1) {
+        const record = {};
+        for (const field of resource.fields) {
+            if (field.name === resource.idField)
+                continue;
+            const value = generateFieldValue(field, rt, i, options.refPool ?? {});
+            if (value !== undefined)
+                record[field.name] = value;
+        }
+        out.push(record);
+    }
+    return out;
+};
+//# sourceMappingURL=seed.js.map

package/dist/mock-engine/data/seed.js.map

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

package/dist/mock-engine/data/validate-record.d.ts

@@ -0,0 +1,30 @@
+import type { MockField, MockInvalidField, MockRegexRunner, MockResource } from "../types.js";
+export type RecordWriteMode = "create" | "replace" | "patch";
+/** Check one field value; returns a message or null. */
+export declare const validateFieldValue: (field: MockField, value: unknown, regex: MockRegexRunner) => string | null;
+export interface PrepareRecordInput {
+    resource: MockResource;
+    input: unknown;
+    mode: RecordWriteMode;
+    /** The stored record for replace/patch. */
+    existing?: Record<string, unknown>;
+    regex: MockRegexRunner;
+    /** Resolves a default (literal or template). */
+    resolveDefault: (value: unknown) => unknown;
+    /** Management writes may set read-only fields (data browser, imports). */
+    allowReadOnly?: boolean;
+    /** Values the server sets (owner, parent id): they win over the body and count as given. */
+    fixed?: Record<string, unknown>;
+}
+/**
+ * Validate a client write and build the record to store (without id,
+ * timestamps and password hashing — the caller adds those).
+ */
+export declare const prepareRecord: ({ resource, input, mode, existing, regex, resolveDefault, allowReadOnly, fixed, }: PrepareRecordInput) => {
+    ok: true;
+    data: Record<string, unknown>;
+} | {
+    ok: false;
+    invalidFields: MockInvalidField[];
+};
+//# sourceMappingURL=validate-record.d.ts.map

package/dist/mock-engine/data/validate-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-record.d.ts","sourceRoot":"","sources":["../../../src/mock-engine/data/validate-record.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI9F,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AA2D7D,wDAAwD;AACxD,eAAO,MAAM,kBAAkB,GAAI,OAAO,SAAS,EAAE,OAAO,OAAO,EAAE,OAAO,eAAe,KAAG,MAAM,GAAG,IAqBtG,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,eAAe,CAAC;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,EAAE,eAAe,CAAC;IACvB,gDAAgD;IAChD,cAAc,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAC5C,0EAA0E;IAC1E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,4FAA4F;IAC5F,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,mFAS3B,kBAAkB,KAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,aAAa,EAAE,gBAAgB,EAAE,CAAA;CAgEnH,CAAC"}

package/dist/mock-engine/data/validate-record.js

@@ -0,0 +1,165 @@
+// Record validation against a resource's field definitions. Hand-rolled on
+// purpose (no Ajv): it runs in the renderer, where the CSP forbids eval.
+import { isPlainObject } from "../util.js";
+import { sanitizeRecordKeys } from "./record-codec.js";
+const EMAIL = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const DATE = /^\d{4}-\d{2}-\d{2}$/;
+const describeType = (field) => {
+    switch (field.type) {
+        case "integer":
+            return "an integer";
+        case "number":
+            return "a number";
+        case "boolean":
+            return "true or false";
+        case "object":
+            return "an object";
+        case "array":
+            return "an array";
+        case "date":
+            return "a date (YYYY-MM-DD)";
+        case "datetime":
+            return "a date-time (ISO 8601)";
+        case "email":
+            return "an email address";
+        case "uuid":
+            return "a UUID";
+        default:
+            return "a string";
+    }
+};
+const checkScalar = (type, value) => {
+    switch (type) {
+        case "string":
+        case "password":
+            return typeof value === "string";
+        case "number":
+            return typeof value === "number" && Number.isFinite(value);
+        case "integer":
+            return typeof value === "number" && Number.isInteger(value);
+        case "boolean":
+            return typeof value === "boolean";
+        case "object":
+            return isPlainObject(value);
+        case "array":
+            return Array.isArray(value);
+        case "date":
+            return typeof value === "string" && DATE.test(value) && !Number.isNaN(Date.parse(value));
+        case "datetime":
+            return typeof value === "string" && !Number.isNaN(Date.parse(value)) && /\d{4}-\d{2}-\d{2}T/.test(value);
+        case "email":
+            return typeof value === "string" && EMAIL.test(value);
+        case "uuid":
+            return typeof value === "string" && UUID.test(value);
+        default:
+            return true;
+    }
+};
+/** Check one field value; returns a message or null. */
+export const validateFieldValue = (field, value, regex) => {
+    if (value === null)
+        return field.nullable || !field.required ? null : "must not be null";
+    if (!checkScalar(field.type, value))
+        return `must be ${describeType(field)}`;
+    if (field.enum && field.enum.length > 0 && !field.enum.some((option) => option === value)) {
+        return `must be one of: ${field.enum.join(", ")}`;
+    }
+    if (typeof value === "number") {
+        if (field.min !== undefined && value < field.min)
+            return `must be at least ${field.min}`;
+        if (field.max !== undefined && value > field.max)
+            return `must be at most ${field.max}`;
+    }
+    if (typeof value === "string") {
+        if (field.minLength !== undefined && value.length < field.minLength)
+            return `must be at least ${field.minLength} characters`;
+        if (field.maxLength !== undefined && value.length > field.maxLength)
+            return `must be at most ${field.maxLength} characters`;
+        if (field.pattern && !regex.test(field.pattern, value))
+            return "does not match the required pattern";
+    }
+    if (Array.isArray(value) && field.items) {
+        const itemType = field.items.type;
+        const bad = value.findIndex((item) => !checkScalar(itemType, item));
+        if (bad >= 0)
+            return `item ${bad} must be ${describeType({ name: field.name, type: itemType })}`;
+    }
+    return null;
+};
+/**
+ * Validate a client write and build the record to store (without id,
+ * timestamps and password hashing — the caller adds those).
+ */
+export const prepareRecord = ({ resource, input, mode, existing, regex, resolveDefault, allowReadOnly, fixed, }) => {
+    if (!isPlainObject(input))
+        return { ok: false, invalidFields: [{ field: "(body)", message: "must be a JSON object" }] };
+    const keyError = sanitizeRecordKeys(input);
+    if (keyError)
+        return { ok: false, invalidFields: [keyError] };
+    const declared = new Map(resource.fields.map((field) => [field.name, field]));
+    const invalid = [];
+    const systemFields = new Set([resource.idField, resource.timestamps.createdAt, resource.timestamps.updatedAt].filter(Boolean));
+    const incoming = {};
+    for (const [key, value] of Object.entries(input)) {
+        const field = declared.get(key);
+        if (!field) {
+            if (systemFields.has(key)) {
+                incoming[key] = value;
+                continue;
+            }
+            if (resource.fields.length === 0 || resource.additionalFields === "allow")
+                incoming[key] = value;
+            else if (resource.additionalFields === "reject")
+                invalid.push({ field: key, message: "is not an allowed field" });
+            continue;
+        }
+        if (field.readOnly && !allowReadOnly && key !== resource.idField)
+            continue;
+        incoming[key] = value;
+    }
+    let data;
+    if (mode === "patch" && existing) {
+        data = { ...existing, ...incoming };
+    }
+    else if (mode === "replace" && existing) {
+        data = { ...incoming };
+        // Read-only fields survive a full replace.
+        for (const field of resource.fields) {
+            if (field.readOnly && existing[field.name] !== undefined && !(allowReadOnly && field.name in incoming))
+                data[field.name] = existing[field.name];
+        }
+    }
+    else {
+        data = { ...incoming };
+    }
+    if (fixed) {
+        Object.assign(data, fixed);
+        Object.assign(incoming, fixed);
+    }
+    if (mode !== "patch") {
+        for (const field of resource.fields) {
+            if (data[field.name] === undefined && field.default !== undefined)
+                data[field.name] = resolveDefault(field.default);
+        }
+    }
+    for (const field of resource.fields) {
+        const value = data[field.name];
+        const touched = mode !== "patch" || Object.prototype.hasOwnProperty.call(incoming, field.name);
+        if (value === undefined) {
+            if (field.required && touched && field.name !== resource.idField && mode !== "patch") {
+                invalid.push({ field: field.name, message: "is required" });
+            }
+            continue;
+        }
+        if (!touched)
+            continue;
+        const message = validateFieldValue(field, value, regex);
+        if (message)
+            invalid.push({ field: field.name, message });
+    }
+    if (invalid.length > 0)
+        return { ok: false, invalidFields: invalid };
+    return { ok: true, data };
+};
+//# sourceMappingURL=validate-record.js.map

package/dist/mock-engine/data/validate-record.js.map

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

package/dist/mock-engine/definition.d.ts

@@ -0,0 +1,31 @@
+import type { MockDefinition, MockDefinitionDraft, MockFaultConfig, MockResource, MockResourceEndpointConfig, MockResourceEndpointName, MockResourceListConfig, MockRoute, MockSessionConfig, MockSimpleFaults, MockUserAuthConfig } from "./types.js";
+export declare const DEFAULT_SESSION_CONFIG: MockSessionConfig;
+export declare const defaultListConfig: () => MockResourceListConfig;
+export declare const defaultEndpoints: () => Record<MockResourceEndpointName, MockResourceEndpointConfig>;
+export declare const defaultUserAuth: (usersResource?: string) => MockUserAuthConfig;
+export declare const normalizeResource: (draft: Partial<MockResource> & {
+    name?: string;
+}) => MockResource;
+export declare const normalizeRoute: (draft: Partial<MockRoute>) => MockRoute;
+/** Fill ids and defaults. Accepts a draft or a complete definition. */
+export declare const normalizeMockDefinition: (draft: MockDefinitionDraft | MockDefinition) => MockDefinition;
+export declare const faultsFromSimple: (simple: MockSimpleFaults | null | undefined) => MockFaultConfig | null;
+export declare const toSimpleFaults: (config: MockFaultConfig | null | undefined) => MockSimpleFaults;
+export interface MockDefinitionIssue {
+    path: string;
+    message: string;
+}
+/** Every derived endpoint path for a resource (used for conflict checks and UIs). */
+export declare const resourceEndpointRoutes: (resource: MockResource) => Array<{
+    method: string;
+    path: string;
+    endpoint: MockResourceEndpointName;
+}>;
+export declare const findResource: (definition: MockDefinition, name: string) => MockResource | undefined;
+export declare const validateMockDefinition: (definition: MockDefinition) => MockDefinitionIssue[];
+export declare const MOCK_RESOURCE_TEMPLATES: ReadonlyArray<{
+    id: string;
+    label: string;
+    resource: () => MockResource;
+}>;
+//# sourceMappingURL=definition.d.ts.map

package/dist/mock-engine/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/mock-engine/definition.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,eAAe,EAGf,YAAY,EACZ,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAKpB,eAAO,MAAM,sBAAsB,EAAE,iBAAiF,CAAC;AAEvH,eAAO,MAAM,iBAAiB,QAAO,sBAQnC,CAAC;AAEH,eAAO,MAAM,gBAAgB,QAAO,MAAM,CAAC,wBAAwB,EAAE,0BAA0B,CAO7F,CAAC;AAEH,eAAO,MAAM,eAAe,GAAI,sBAAuB,KAAG,kBAaxD,CAAC;AA2BH,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,CAAC,YAAY,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,YAmCpF,CAAC;AAYF,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,CAAC,SAAS,CAAC,KAAG,SAkB1D,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,GAAI,OAAO,mBAAmB,GAAG,cAAc,KAAG,cAcrF,CAAC;AAIF,eAAO,MAAM,gBAAgB,GAAI,QAAQ,gBAAgB,GAAG,IAAI,GAAG,SAAS,KAAG,eAAe,GAAG,IAiChG,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,QAAQ,eAAe,GAAG,IAAI,GAAG,SAAS,KAAG,gBAoB3E,CAAC;AAIF,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAWD,qFAAqF;AACrF,eAAO,MAAM,sBAAsB,GACjC,UAAU,YAAY,KACrB,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,wBAAwB,CAAA;CAAE,CAY5E,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,YAAY,cAAc,EAAE,MAAM,MAAM,KAAG,YAAY,GAAG,SACU,CAAC;AAElG,eAAO,MAAM,sBAAsB,GAAI,YAAY,cAAc,KAAG,mBAAmB,EAmGtF,CAAC;AAMF,eAAO,MAAM,uBAAuB,EAAE,aAAa,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,YAAY,CAAA;CAAE,CA6E9G,CAAC"}