llmbic 1.0.0

package/dist/merge.js

@@ -0,0 +1,230 @@
+/**
+ * Walk every schema field, build the {@link RuleMatch} if rules produced a
+ * value, fuse it with the LLM candidate via {@link merge.field}, and collect
+ * per-field outcomes. Invoked once at the top of {@link merge.apply}.
+ */
+function fuseAllFields(schemaKeys, rulesResult, llmResult, policy, logger) {
+    const data = {};
+    const confidence = {};
+    const conflicts = [];
+    const missing = [];
+    let rulesMatched = 0;
+    for (const field of schemaKeys) {
+        const hasRuleValue = field in rulesResult.values;
+        // hasRuleValue implies confidence[field] is defined — rule.apply only writes
+        // to `confidence` when it also writes to `values`.
+        const ruleMatch = hasRuleValue
+            ? {
+                value: rulesResult.values[field],
+                confidence: rulesResult.confidence[field],
+            }
+            : null;
+        if (hasRuleValue) {
+            rulesMatched += 1;
+        }
+        const llmValue = llmResult?.values[field] ?? null;
+        const fused = merge.field(field, ruleMatch, llmValue, policy, logger);
+        data[field] = fused.value;
+        confidence[field] = fused.confidence;
+        if (fused.conflict !== undefined) {
+            conflicts.push(fused.conflict);
+        }
+        if (fused.value === null) {
+            missing.push(field);
+        }
+    }
+    return { data, confidence, conflicts, missing, rulesMatched };
+}
+/**
+ * Apply every configured {@link Normalizer} to the merged data in declared
+ * order. Normalizers may mutate their argument; the returned reference is
+ * what the rest of the pipeline observes.
+ */
+function runNormalizers(data, normalizers, content) {
+    let current = data;
+    for (const normalizer of normalizers ?? []) {
+        current = normalizer(current, content);
+    }
+    return current;
+}
+/**
+ * Produce the violation list for the normalized data: first the Zod schema
+ * re-validation (skipping fields already tracked in `missing`), then every
+ * configured validator.
+ */
+function collectViolations(schema, normalized, missing, validators) {
+    const violations = [];
+    const missingSet = new Set(missing);
+    const parsed = schema.safeParse(normalized);
+    if (!parsed.success) {
+        for (const issue of parsed.error.issues) {
+            const [firstPath] = issue.path;
+            const field = typeof firstPath === 'string' ? firstPath : undefined;
+            if (field !== undefined && missingSet.has(field)) {
+                continue;
+            }
+            violations.push({
+                field,
+                rule: 'schema',
+                message: issue.message,
+                severity: 'error',
+            });
+        }
+    }
+    for (const validator of validators ?? []) {
+        violations.push(...validator(normalized));
+    }
+    return violations;
+}
+/**
+ * Field-level and object-level merge primitives.
+ *
+ * For now, only {@link merge.field} is exposed; the top-level object merge
+ * will be added in a later slice.
+ */
+export const merge = {
+    /**
+     * Library defaults applied by {@link merge.field} when the caller omits
+     * one or more policy fields. Exposed so consumers can reference or spread
+     * them (e.g. `{ ...merge.defaultFieldPolicy, strategy: 'prefer-llm' }`).
+     *
+     * See {@link FieldMergePolicy} for the meaning of each field.
+     */
+    defaultFieldPolicy: {
+        /** See {@link FieldMergePolicy.strategy}. */
+        strategy: 'flag',
+        /** See {@link FieldMergePolicy.defaultLlmConfidence}. */
+        defaultLlmConfidence: 0.7,
+        /** See {@link FieldMergePolicy.flaggedConfidence}. */
+        flaggedConfidence: 0.3,
+        /** See {@link FieldMergePolicy.agreementConfidence}. */
+        agreementConfidence: 1.0,
+        /** See {@link FieldMergePolicy.compare}. Case-insensitive for strings, strict equality otherwise. */
+        compare: (a, b) => {
+            if (typeof a === 'string' && typeof b === 'string') {
+                return a.toLowerCase() === b.toLowerCase();
+            }
+            return a === b;
+        },
+    },
+    /**
+     * Fuse a rule match and an LLM value for a single field, following the
+     * provided policy. Returns the kept value, its confidence, and a conflict
+     * record if the strategy flagged a disagreement.
+     *
+     * Any policy field omitted from `policy` falls back to
+     * {@link merge.defaultFieldPolicy}.
+     *
+     * Decision table (in order): rule-only, llm-only, both-null, agree,
+     * prefer-rule, prefer-llm, flag (default fallback).
+     *
+     * @typeParam T - Type of the rule value.
+     * @param field - Name of the field being merged.
+     * @param ruleMatch - Value proposed by a deterministic rule, or `null` if none.
+     * @param llmValue - Value proposed by the LLM, or `null` if none. Cast to `T`
+     *   without runtime type-check — callers that expose `merge.field` via
+     *   `merge.apply` rely on the final Zod re-validation to reject invalid LLM values.
+     * @param policy - Optional strategy and confidence overrides.
+     * @param logger - Optional logger notified of unexpected runtime situations
+     *   (e.g. an unknown strategy slipped past the type system).
+     */
+    field(field, ruleMatch, llmValue, policy, logger) {
+        const fullPolicy = { ...merge.defaultFieldPolicy, ...policy };
+        const normalizedLlm = llmValue ?? null;
+        if (ruleMatch !== null && normalizedLlm === null) {
+            return {
+                value: ruleMatch.value,
+                confidence: ruleMatch.confidence,
+                conflict: undefined,
+            };
+        }
+        if (ruleMatch === null && normalizedLlm !== null) {
+            return {
+                value: normalizedLlm,
+                confidence: fullPolicy.defaultLlmConfidence,
+                conflict: undefined,
+            };
+        }
+        if (ruleMatch === null || normalizedLlm === null) {
+            return { value: null, confidence: null, conflict: undefined };
+        }
+        if (fullPolicy.compare(ruleMatch.value, normalizedLlm)) {
+            return {
+                value: ruleMatch.value,
+                confidence: fullPolicy.agreementConfidence,
+                conflict: undefined,
+            };
+        }
+        if (fullPolicy.strategy === 'prefer-rule') {
+            return {
+                value: ruleMatch.value,
+                confidence: ruleMatch.confidence,
+                conflict: undefined,
+            };
+        }
+        if (fullPolicy.strategy === 'prefer-llm') {
+            return {
+                value: normalizedLlm,
+                confidence: fullPolicy.defaultLlmConfidence,
+                conflict: undefined,
+            };
+        }
+        if (fullPolicy.strategy !== 'flag') {
+            logger?.warn('unknown conflict strategy, falling back to flag', {
+                strategy: fullPolicy.strategy,
+                field,
+            });
+        }
+        return {
+            value: ruleMatch.value,
+            confidence: fullPolicy.flaggedConfidence,
+            conflict: {
+                field,
+                ruleValue: ruleMatch.value,
+                ruleConfidence: ruleMatch.confidence,
+                llmValue: normalizedLlm,
+            },
+        };
+    },
+    /**
+     * Walk every field of `schema`, fuse the rules pass result with the LLM
+     * result via {@link merge.field}, and produce a typed
+     * {@link ExtractionResult}.
+     *
+     * Passing `llmResult = null` runs in rules-only mode: every field keeps
+     * whatever the rules produced and `meta.llmCalled` is `false`.
+     *
+     * Orchestration only — the three phases (fusion, normalization, validation)
+     * each live in their own private helper above.
+     *
+     * Runtime fields of `meta` (`durationMs`, `tokensUsed`) are populated by
+     * later slices; for now `durationMs` is `0`.
+     *
+     * @typeParam S - A Zod object schema.
+     * @param schema - Zod object schema describing the target data shape.
+     * @param rulesResult - Output of {@link rule.apply} for the same schema.
+     * @param llmResult - Parsed LLM response, or `null` for rules-only mode.
+     * @param content - Original text the rules and LLM were derived from; forwarded to normalizers so they can cross-reference the source.
+     * @param options - Optional behavior overrides (policy, normalizers, validators, logger).
+     */
+    apply(schema, rulesResult, llmResult, content, options) {
+        const schemaKeys = Object.keys(schema.shape);
+        const fusion = fuseAllFields(schemaKeys, rulesResult, llmResult, options?.policy, options?.logger);
+        const normalized = runNormalizers(fusion.data, options?.normalizers, content);
+        const violations = collectViolations(schema, normalized, fusion.missing, options?.validators);
+        const valid = !violations.some((v) => v.severity === 'error');
+        return {
+            data: normalized,
+            confidence: fusion.confidence,
+            conflicts: fusion.conflicts,
+            missing: fusion.missing,
+            validation: { valid, violations },
+            meta: {
+                rulesMatched: fusion.rulesMatched,
+                llmCalled: llmResult !== null,
+                durationMs: 0,
+            },
+        };
+    },
+};
+//# sourceMappingURL=merge.js.map

package/dist/merge.js.map

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

package/dist/prompt.d.ts

@@ -0,0 +1,50 @@
+import type { z } from 'zod';
+import type { ExtractionResult, LlmResult } from './types/merge.types.js';
+import type { LlmRequest } from './types/prompt.types.js';
+/**
+ * Prompt-building primitives that turn a partial extraction result into an
+ * {@link LlmRequest} targeted at the fields the deterministic pass could not
+ * produce.
+ */
+export declare const prompt: {
+    /**
+     * Build an LLM request restricted to `partial.missing`. The response schema
+     * is a JSON Schema covering only those fields, and values already produced
+     * by the deterministic pass are surfaced both as `knownValues` and as a
+     * hint block prepended to `userContent`.
+     *
+     * Orchestration only — the four phases (response-schema build, known-values
+     * collection, user-content formatting, request assembly) each live in their
+     * own private helper above.
+     *
+     * @typeParam S - A Zod object schema describing the full target shape.
+     * @param schema - Zod object schema that drives the field selection.
+     * @param partial - Output of {@link merge.apply} (or any equivalent partial)
+     *   — only `data` and `missing` are read.
+     * @param content - Original text the request will refer to.
+     * @param options - Optional behavior overrides (custom system prompt).
+     * @throws When a missing field uses a Zod kind outside the supported
+     *   whitelist; the error message names the offending field.
+     */
+    build<S extends z.ZodObject<z.ZodRawShape>>(schema: S, partial: Pick<ExtractionResult<z.infer<S>>, "data" | "missing">, content: string, options?: {
+        systemPrompt?: string;
+    }): LlmRequest;
+    /**
+     * Parse a raw LLM response permissively. Accepts either an already-decoded
+     * object or a JSON-encoded string. Each field listed in `missing` is
+     * validated individually against its Zod schema — valid fields flow into
+     * `values`, invalid ones are dropped and surfaced as warnings. Keys outside
+     * `missing` are dropped as well, with a single aggregated warning so the
+     * caller can spot a prompt/provider mismatch.
+     *
+     * Best-effort by design: never throws, always returns an {@link LlmResult}.
+     *
+     * @typeParam S - A Zod object schema describing the full target shape.
+     * @param schema - Zod object schema whose fields back the validation.
+     * @param missing - Fields the LLM was expected to produce (typically
+     *   {@link ExtractionResult.missing}).
+     * @param raw - The provider response — object or JSON string.
+     */
+    parse<S extends z.ZodObject<z.ZodRawShape>>(schema: S, missing: readonly (keyof z.infer<S>)[], raw: unknown): LlmResult;
+};
+//# sourceMappingURL=prompt.d.ts.map

package/dist/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAEV,gBAAgB,EAChB,SAAS,EACV,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAuK1D;;;;GAIG;AACH,eAAO,MAAM,MAAM;IACjB;;;;;;;;;;;;;;;;;;OAkBG;UACG,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,UAChC,CAAC,WACA,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,WACtD,MAAM,YACL;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAClC,UAAU;IAcb;;;;;;;;;;;;;;;OAeG;UACG,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,UAChC,CAAC,WACA,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,OACjC,OAAO,GACX,SAAS;CAiBb,CAAC"}

package/dist/prompt.js

@@ -0,0 +1,205 @@
+const DEFAULT_SYSTEM_PROMPT = 'Extract the listed fields from the content as a JSON object.';
+/**
+ * Convert a single Zod field schema to JSON Schema. Throws on any Zod kind
+ * outside the documented whitelist (`string`, `number`, `boolean`, `enum`,
+ * `nullable`), naming the offending field so the caller can restructure
+ * their schema.
+ */
+function zodFieldToJsonSchema(zodType, field) {
+    const def = zodType.def;
+    const kind = def.type;
+    if (kind === 'string') {
+        return { type: 'string' };
+    }
+    if (kind === 'number') {
+        return { type: 'number' };
+    }
+    if (kind === 'boolean') {
+        return { type: 'boolean' };
+    }
+    if (kind === 'enum') {
+        const entries = def.entries;
+        return { type: 'string', enum: Object.values(entries) };
+    }
+    if (kind === 'nullable') {
+        const inner = zodFieldToJsonSchema(def.innerType, field);
+        if (typeof inner.type !== 'string') {
+            throw new Error(`Unsupported nested nullable on field "${field}"`);
+        }
+        return { ...inner, type: [inner.type, 'null'] };
+    }
+    throw new Error(`Unsupported Zod type "${kind}" on field "${field}"`);
+}
+/**
+ * Build the JSON Schema handed to the LLM, restricted to the fields the
+ * deterministic pass could not produce.
+ */
+function buildResponseSchema(schema, missing) {
+    const properties = {};
+    const shape = schema.shape;
+    for (const field of missing) {
+        const zodField = shape[field];
+        if (zodField === undefined) {
+            continue;
+        }
+        properties[field] = zodFieldToJsonSchema(zodField, field);
+    }
+    return { type: 'object', properties, required: [...missing] };
+}
+/**
+ * Pick the non-null, non-missing entries of the partial result — the values
+ * the deterministic pass has already resolved.
+ */
+function collectKnownValues(data, missing) {
+    const missingSet = new Set(missing);
+    const known = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (missingSet.has(key)) {
+            continue;
+        }
+        if (value === null || value === undefined) {
+            continue;
+        }
+        known[key] = value;
+    }
+    return known;
+}
+/**
+ * Prepend the known values as a short hint block so the LLM can ground its
+ * extraction in the deterministic pass. Returns the raw content unchanged
+ * when nothing is known yet.
+ */
+function formatUserContent(content, knownValues) {
+    const keys = Object.keys(knownValues);
+    if (keys.length === 0) {
+        return content;
+    }
+    const lines = keys.map((key) => `- ${key} = ${JSON.stringify(knownValues[key])}`);
+    return `Already extracted:\n${lines.join('\n')}\n\n${content}`;
+}
+/**
+ * Decode a raw LLM response into a plain object. Accepts either an already
+ * parsed object or a JSON-encoded string. Returns a warning message instead
+ * of throwing when the payload cannot be used.
+ */
+function decodeRaw(raw) {
+    let candidate = raw;
+    if (typeof raw === 'string') {
+        try {
+            candidate = JSON.parse(raw);
+        }
+        catch {
+            return { warning: 'response is not valid JSON' };
+        }
+    }
+    if (candidate === null ||
+        typeof candidate !== 'object' ||
+        Array.isArray(candidate)) {
+        return { warning: 'response is not valid JSON' };
+    }
+    return { object: candidate };
+}
+/**
+ * Validate the fields the LLM was asked to produce, keeping those that match
+ * their Zod schema and collecting a warning per field that fails validation.
+ */
+function validateMissingFields(schema, missing, object) {
+    const shape = schema.shape;
+    const values = {};
+    const warnings = [];
+    for (const field of missing) {
+        if (!(field in object)) {
+            continue;
+        }
+        const fieldSchema = shape[field];
+        if (fieldSchema === undefined) {
+            continue;
+        }
+        const parsed = fieldSchema.safeParse(object[field]);
+        if (parsed.success) {
+            values[field] = parsed.data;
+        }
+        else {
+            const reason = parsed.error.issues[0]?.message ?? 'invalid value';
+            warnings.push(`field ${field}: ${reason}`);
+        }
+    }
+    return { values, warnings };
+}
+/**
+ * Collect the keys present in the response that were not part of `missing`.
+ * These are dropped, but the caller surfaces an aggregated warning so prompt
+ * engineering issues (LLM ignoring the restricted schema) stay visible.
+ */
+function collectUnexpectedKeys(object, missing) {
+    const missingSet = new Set(missing);
+    return Object.keys(object).filter((key) => !missingSet.has(key));
+}
+/**
+ * Prompt-building primitives that turn a partial extraction result into an
+ * {@link LlmRequest} targeted at the fields the deterministic pass could not
+ * produce.
+ */
+export const prompt = {
+    /**
+     * Build an LLM request restricted to `partial.missing`. The response schema
+     * is a JSON Schema covering only those fields, and values already produced
+     * by the deterministic pass are surfaced both as `knownValues` and as a
+     * hint block prepended to `userContent`.
+     *
+     * Orchestration only — the four phases (response-schema build, known-values
+     * collection, user-content formatting, request assembly) each live in their
+     * own private helper above.
+     *
+     * @typeParam S - A Zod object schema describing the full target shape.
+     * @param schema - Zod object schema that drives the field selection.
+     * @param partial - Output of {@link merge.apply} (or any equivalent partial)
+     *   — only `data` and `missing` are read.
+     * @param content - Original text the request will refer to.
+     * @param options - Optional behavior overrides (custom system prompt).
+     * @throws When a missing field uses a Zod kind outside the supported
+     *   whitelist; the error message names the offending field.
+     */
+    build(schema, partial, content, options) {
+        const missing = partial.missing;
+        const responseSchema = buildResponseSchema(schema, missing);
+        const knownValues = collectKnownValues(partial.data, partial.missing);
+        const userContent = formatUserContent(content, knownValues);
+        return {
+            systemPrompt: options?.systemPrompt ?? DEFAULT_SYSTEM_PROMPT,
+            userContent,
+            responseSchema,
+            knownValues,
+        };
+    },
+    /**
+     * Parse a raw LLM response permissively. Accepts either an already-decoded
+     * object or a JSON-encoded string. Each field listed in `missing` is
+     * validated individually against its Zod schema — valid fields flow into
+     * `values`, invalid ones are dropped and surfaced as warnings. Keys outside
+     * `missing` are dropped as well, with a single aggregated warning so the
+     * caller can spot a prompt/provider mismatch.
+     *
+     * Best-effort by design: never throws, always returns an {@link LlmResult}.
+     *
+     * @typeParam S - A Zod object schema describing the full target shape.
+     * @param schema - Zod object schema whose fields back the validation.
+     * @param missing - Fields the LLM was expected to produce (typically
+     *   {@link ExtractionResult.missing}).
+     * @param raw - The provider response — object or JSON string.
+     */
+    parse(schema, missing, raw) {
+        const missingKeys = missing;
+        const decoded = decodeRaw(raw);
+        if ('warning' in decoded) {
+            return { values: {}, warnings: [decoded.warning] };
+        }
+        const { values, warnings } = validateMissingFields(schema, missingKeys, decoded.object);
+        const unexpected = collectUnexpectedKeys(decoded.object, missingKeys);
+        if (unexpected.length > 0) {
+            warnings.push(`unexpected fields dropped: ${unexpected.join(', ')}`);
+        }
+        return warnings.length > 0 ? { values, warnings } : { values };
+    },
+};
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

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

package/dist/rules.d.ts

@@ -0,0 +1,73 @@
+import type { z } from 'zod';
+import type { Logger } from './types/logger.types.js';
+import type { ExtractionRule, RuleMatch, RulesResult } from './types/rule.types.js';
+/**
+ * Namespace bundling every primitive used to declare and run deterministic
+ * extraction rules.
+ */
+export declare const rule: {
+    /**
+     * Declare a deterministic extraction rule targeting a single schema field.
+     *
+     * The `extract` callback receives the raw content and must return either a
+     * {@link RuleMatch} or `null` when the rule does not apply.
+     *
+     * @param field - Name of the schema field the rule writes to.
+     * @param extract - Callback that inspects the content and proposes a value.
+     * @returns An {@link ExtractionRule} ready to be passed to {@link rule.apply}.
+     */
+    create(field: string, extract: (content: string) => RuleMatch<unknown> | null): ExtractionRule;
+    /**
+     * Shortcut to build a regex-based {@link ExtractionRule}. On match, the
+     * value is taken from capture group 1 (or the full match if none), then
+     * optionally passed through a `transform` callback.
+     *
+     * @typeParam T - Type produced by `transform`, defaults to `string`.
+     * @param field - Name of the schema field the rule writes to.
+     * @param pattern - Regular expression to evaluate against the content.
+     * @param confidenceScore - Confidence score assigned on a successful match.
+     * @param transform - Optional mapper from the raw `RegExpMatchArray` to a value.
+     * @returns An {@link ExtractionRule} ready to be passed to {@link rule.apply}.
+     */
+    regex<T = string>(field: string, pattern: RegExp, confidenceScore: number, transform?: (match: RegExpMatchArray) => T): ExtractionRule;
+    /**
+     * Build a {@link RuleMatch} from a value and a confidence score. Syntactic
+     * sugar used inside custom rule callbacks to avoid writing the object literal
+     * by hand.
+     *
+     * @typeParam T - Type of the extracted value.
+     * @param value - The extracted value.
+     * @param score - Confidence score in `[0, 1]`.
+     * @returns A {@link RuleMatch} wrapping `value` and `score`.
+     *
+     * @example
+     * ```ts
+     * const ageRule = rule.create('age', (text) => {
+     *   const match = text.match(/(\d+)\s*years/);
+     *   return match ? rule.confidence(Number(match[1]), 0.9) : null;
+     * });
+     * ```
+     */
+    confidence<T>(value: T, score: number): RuleMatch<T>;
+    /**
+     * Run every deterministic rule against `content`, collect their matches,
+     * resolve collisions by confidence, and type-check each candidate against
+     * the Zod schema before accepting it.
+     *
+     * Behavior:
+     * - Rules targeting a field absent from the schema are silently skipped.
+     * - On field collisions, the highest-confidence match wins; ties favor the
+     *   first-declared rule.
+     * - Values failing the per-field Zod `safeParse` are discarded and the
+     *   field falls back to `missing`. An optional logger receives a warning.
+     *
+     * @typeParam S - A Zod object schema.
+     * @param content - Raw content to extract from (typically markdown or text).
+     * @param rules - Deterministic rules to evaluate.
+     * @param schema - Zod object schema describing the target data shape.
+     * @param logger - Optional logger notified when a value is rejected.
+     * @returns The deterministic extraction result (values, confidence, missing).
+     */
+    apply<S extends z.ZodObject<z.ZodRawShape>>(content: string, rules: ExtractionRule[], schema: S, logger?: Logger): RulesResult<z.infer<S>>;
+};
+//# sourceMappingURL=rules.d.ts.map

package/dist/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpF;;;GAGG;AACH,eAAO,MAAM,IAAI;IACf;;;;;;;;;OASG;kBAEM,MAAM,WACJ,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,GACtD,cAAc;IAIjB;;;;;;;;;;;OAWG;UACG,CAAC,kBACE,MAAM,WACJ,MAAM,mBACE,MAAM,cACX,CAAC,KAAK,EAAE,gBAAgB,KAAK,CAAC,GACzC,cAAc;IAcjB;;;;;;;;;;;;;;;;;OAiBG;eACQ,CAAC,SAAS,CAAC,SAAS,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAIpD;;;;;;;;;;;;;;;;;;OAkBG;UACG,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,WAC/B,MAAM,SACR,cAAc,EAAE,UACf,CAAC,WACA,MAAM,GACd,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;CAqC3B,CAAC"}