@jini-ai/chat 0.1.0

package/dist/core/persistence/title.js.map

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

package/dist/core/question-form/format.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @module question-form/format
+ *
+ * Answer presentation: turning a submitted answer set into the prose the
+ * agent reads on its next turn, plus the label/value lookups also used by
+ * `normalize.ts`'s default-value resolution. Split out of the original
+ * single-file `question-form.ts`; see `../question-form.ts` for the public
+ * facade.
+ */
+import type { FormOption, QuestionForm } from './types.js';
+/**
+ * Format a finished set of answers into a prose user message the agent can
+ * read on its next turn. The shape is stable enough that the agent can
+ * recognize "the form was answered" without any structured wrapper.
+ *
+ * @complexity O(q) in the number of questions on the form.
+ */
+export declare function formatFormAnswers(form: QuestionForm, answers: Record<string, string | string[]>): string;
+/** Resolve a submitted answer value back to its display label, or the value itself when unmatched. */
+export declare function formOptionLabelForValue(question: {
+    options?: FormOption[] | undefined;
+}, value: string): string;
+/** Resolve a label or value to the canonical option `value`, or the input itself when unmatched. */
+export declare function formOptionValueForLabel(question: {
+    options?: FormOption[] | undefined;
+}, labelOrValue: string): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/core/question-form/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/core/question-form/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE3D;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,MAAM,CAgBxG;AASD,sGAAsG;AACtG,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE;IAAE,OAAO,CAAC,EAAE,UAAU,EAAE,GAAG,SAAS,CAAA;CAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG/G;AAED,oGAAoG;AACpG,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE;IAAE,OAAO,CAAC,EAAE,UAAU,EAAE,GAAG,SAAS,CAAA;CAAE,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAGtH"}

package/dist/core/question-form/format.js

@@ -0,0 +1,45 @@
+/**
+ * Format a finished set of answers into a prose user message the agent can
+ * read on its next turn. The shape is stable enough that the agent can
+ * recognize "the form was answered" without any structured wrapper.
+ *
+ * @complexity O(q) in the number of questions on the form.
+ */
+export function formatFormAnswers(form, answers) {
+    const lines = [];
+    lines.push(`[form answers — ${form.id}]`);
+    for (const q of form.questions) {
+        const v = answers[q.id];
+        let display;
+        if (Array.isArray(v)) {
+            display = v.length > 0 ? v.map((value) => formOptionDisplayForValue(q, value)).join(', ') : '(skipped)';
+        }
+        else if (typeof v === 'string') {
+            display = v.trim().length > 0 ? formOptionDisplayForValue(q, v.trim()) : '(skipped)';
+        }
+        else {
+            display = '(skipped)';
+        }
+        lines.push(`- ${q.label}: ${display}`);
+    }
+    return lines.join('\n');
+}
+function formOptionDisplayForValue(question, value) {
+    const match = question.options?.find((option) => option.value === value || option.label === value);
+    if (!match)
+        return value;
+    if (match.value === match.label)
+        return match.label;
+    return `${match.label} [value: ${match.value}]`;
+}
+/** Resolve a submitted answer value back to its display label, or the value itself when unmatched. */
+export function formOptionLabelForValue(question, value) {
+    const match = question.options?.find((option) => option.value === value || option.label === value);
+    return match?.label ?? value;
+}
+/** Resolve a label or value to the canonical option `value`, or the input itself when unmatched. */
+export function formOptionValueForLabel(question, labelOrValue) {
+    const match = question.options?.find((option) => option.value === labelOrValue || option.label === labelOrValue);
+    return match?.value ?? labelOrValue;
+}
+//# sourceMappingURL=format.js.map

package/dist/core/question-form/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/core/question-form/format.ts"],"names":[],"mappings":"AAWA;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAkB,EAAE,OAA0C;IAC9F,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/B,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxB,IAAI,OAAe,CAAC;QACpB,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACrB,OAAO,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,yBAAyB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;QAC1G,CAAC;aAAM,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YACjC,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;QACvF,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,WAAW,CAAC;QACxB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,yBAAyB,CAAC,QAAgD,EAAE,KAAa;IAChG,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,KAAK,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IACnG,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC;IACpD,OAAO,GAAG,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,KAAK,GAAG,CAAC;AAClD,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,uBAAuB,CAAC,QAAgD,EAAE,KAAa;IACrG,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,KAAK,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IACnG,OAAO,KAAK,EAAE,KAAK,IAAI,KAAK,CAAC;AAC/B,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,uBAAuB,CAAC,QAAgD,EAAE,YAAoB;IAC5G,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,YAAY,IAAI,MAAM,CAAC,KAAK,KAAK,YAAY,CAAC,CAAC;IACjH,OAAO,KAAK,EAAE,KAAK,IAAI,YAAY,CAAC;AACtC,CAAC"}

package/dist/core/question-form/normalize.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @module question-form/normalize
+ *
+ * Normalization of a raw (already-JSON-parsed) question object into this
+ * package's stable `FormQuestion`/`DirectionCard` shape — tolerant of the
+ * looser vocabulary a model tends to emit (`"multi"` for `checkbox`,
+ * `"default"` for `defaultValue`, etc). Split out of the original
+ * single-file `question-form.ts`; see `../question-form.ts` for the public
+ * facade and `./scan.ts` for the caller that turns raw JSON into these
+ * question objects.
+ */
+import type { FormQuestion } from './types.js';
+export declare function mapRawQuestion(q: unknown, index: number): FormQuestion | null;
+/**
+ * Whether a model-supplied palette entry may be written into a CSS value.
+ *
+ * `palette` reaches `QuestionForm`'s swatch as `style={{ background: c }}`, and `background` is a
+ * SHORTHAND — it accepts far more than a colour. An agent (or anything that can influence one)
+ * emitting `url(https://attacker.example/pixel)` therefore got the browser to issue a request the
+ * moment the card rendered: a tracking beacon inside the chat transcript, needing no click. Neither
+ * React nor the CSSOM filters this; React passes style values through, and the CSSOM happily
+ * accepts a valid shorthand.
+ *
+ * Enforced HERE rather than at the swatch, because this is the normalization boundary and the
+ * component is not the only thing that could ever read `palette`. An entry that fails is DROPPED
+ * rather than substituted: a silently recoloured swatch would misrepresent the agent's proposal,
+ * and a card with fewer swatches is honest about what survived validation.
+ */
+export declare function isRenderableColor(value: string): boolean;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/core/question-form/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/core/question-form/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAA6B,YAAY,EAAgB,MAAM,YAAY,CAAC;AAGxF,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CA6C7E;AA0FD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAMxD"}

package/dist/core/question-form/normalize.js

@@ -0,0 +1,192 @@
+import { formOptionValueForLabel } from './format.js';
+export function mapRawQuestion(q, index) {
+    if (!q || typeof q !== 'object')
+        return null;
+    const qo = q;
+    const id = typeof qo.id === 'string' && qo.id.trim().length > 0 ? qo.id.trim() : `q${index + 1}`;
+    const label = typeof qo.label === 'string' ? qo.label : id;
+    const type = normalizeType(qo.type);
+    const options = parseOptions(qo.options);
+    const placeholder = typeof qo.placeholder === 'string' ? qo.placeholder : undefined;
+    const help = typeof qo.help === 'string' ? qo.help : undefined;
+    const required = qo.required === true;
+    const maxSelections = typeof qo.maxSelections === 'number' && Number.isInteger(qo.maxSelections) && qo.maxSelections > 0
+        ? qo.maxSelections
+        : undefined;
+    const cards = parseDirectionCards(qo.cards);
+    const defaultValue = parseDefaultValue(qo, options);
+    const allowCustom = qo.allowCustom === false ? false : qo.allowCustom === true || qo.custom === true ? true : undefined;
+    const customLabel = typeof qo.customLabel === 'string' ? qo.customLabel : undefined;
+    const customPlaceholder = typeof qo.customPlaceholder === 'string' ? qo.customPlaceholder : undefined;
+    const min = parseNumberAttr(qo.min);
+    const max = parseNumberAttr(qo.max);
+    const step = parseNumberAttr(qo.step);
+    const multiple = qo.multiple === true;
+    const accept = typeof qo.accept === 'string' ? qo.accept : undefined;
+    return {
+        id,
+        label,
+        type,
+        ...(options ? { options } : {}),
+        ...(placeholder ? { placeholder } : {}),
+        ...(help ? { help } : {}),
+        ...(required ? { required } : {}),
+        ...(defaultValue !== undefined ? { defaultValue } : {}),
+        ...(maxSelections !== undefined && type === 'checkbox' ? { maxSelections } : {}),
+        ...(allowCustom !== undefined ? { allowCustom } : {}),
+        ...(customLabel ? { customLabel } : {}),
+        ...(customPlaceholder ? { customPlaceholder } : {}),
+        ...(min !== undefined ? { min } : {}),
+        ...(max !== undefined ? { max } : {}),
+        ...(step !== undefined ? { step } : {}),
+        ...(multiple && type === 'file' ? { multiple } : {}),
+        ...(accept && type === 'file' ? { accept } : {}),
+        ...(cards ? { cards } : {}),
+    };
+}
+function normalizeType(raw) {
+    if (typeof raw !== 'string')
+        return 'text';
+    const lower = raw.toLowerCase().trim();
+    if (lower === 'radio' || lower === 'single' || lower === 'choice')
+        return 'radio';
+    if (lower === 'checkbox' || lower === 'multi' || lower === 'multiple')
+        return 'checkbox';
+    if (lower === 'select' || lower === 'dropdown')
+        return 'select';
+    if (lower === 'textarea' || lower === 'long' || lower === 'paragraph')
+        return 'textarea';
+    if (lower === 'number' || lower === 'numeric')
+        return 'number';
+    if (lower === 'range' || lower === 'slider')
+        return 'range';
+    if (lower === 'date')
+        return 'date';
+    if (lower === 'time')
+        return 'time';
+    if (lower === 'datetime-local' || lower === 'datetime' || lower === 'date-time' || lower === 'datetime_local') {
+        return 'datetime-local';
+    }
+    if (lower === 'color' || lower === 'colour' || lower === 'color-picker')
+        return 'color';
+    if (lower === 'url' || lower === 'link')
+        return 'url';
+    if (lower === 'email')
+        return 'email';
+    if (lower === 'tel' || lower === 'phone')
+        return 'tel';
+    if (lower === 'file' || lower === 'upload' || lower === 'attachment')
+        return 'file';
+    if (lower === 'switch' || lower === 'toggle' || lower === 'boolean')
+        return 'switch';
+    if (lower === 'direction-cards' || lower === 'directions' || lower === 'cards' || lower === 'direction') {
+        return 'direction-cards';
+    }
+    return 'text';
+}
+function parseNumberAttr(raw) {
+    if (typeof raw === 'number' && Number.isFinite(raw))
+        return raw;
+    if (typeof raw !== 'string')
+        return undefined;
+    const n = Number(raw);
+    return Number.isFinite(n) ? n : undefined;
+}
+function parseOptions(raw) {
+    if (!Array.isArray(raw))
+        return undefined;
+    const options = raw.map(parseOption).filter((option) => option !== null);
+    return options.length > 0 ? options : undefined;
+}
+function parseOption(raw) {
+    if (typeof raw === 'string') {
+        const label = raw.trim();
+        return label.length > 0 ? { label, value: label } : null;
+    }
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const obj = raw;
+    const label = typeof obj.label === 'string' ? obj.label.trim() : '';
+    if (label.length === 0)
+        return null;
+    const value = typeof obj.value === 'string' && obj.value.trim().length > 0 ? obj.value.trim() : label;
+    const description = typeof obj.description === 'string' && obj.description.trim().length > 0 ? obj.description.trim() : undefined;
+    return {
+        label,
+        value,
+        ...(description ? { description } : {}),
+    };
+}
+function parseDefaultValue(question, options) {
+    const raw = typeof question.defaultValue === 'string' || Array.isArray(question.defaultValue)
+        ? question.defaultValue
+        : typeof question.defaultValue === 'number' || typeof question.defaultValue === 'boolean'
+            ? String(question.defaultValue)
+            : typeof question.default === 'string'
+                ? question.default
+                : typeof question.default === 'number' || typeof question.default === 'boolean'
+                    ? String(question.default)
+                    : undefined;
+    if (typeof raw === 'string')
+        return formOptionValueForLabel({ options }, raw);
+    if (Array.isArray(raw)) {
+        return raw.filter((value) => typeof value === 'string').map((value) => formOptionValueForLabel({ options }, value));
+    }
+    return undefined;
+}
+/** `#rgb`, `#rgba`, `#rrggbb`, `#rrggbbaa`. */
+const HEX_COLOR = /^#(?:[0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/i;
+/** A bare CSS colour keyword. Letters only — with no parenthesis it cannot become a function call. */
+const COLOR_KEYWORD = /^[a-z]+$/i;
+/**
+ * A colour function. The argument charset deliberately excludes `(`, so no nested function —
+ * `var()`, `url()`, `image-set()`, `attr()` — can appear inside one of these either.
+ */
+const COLOR_FUNCTION = /^(?:rgb|rgba|hsl|hsla|hwb|lab|lch|oklab|oklch|color)\(\s*[0-9a-z%.,/\s+-]*\)$/i;
+/**
+ * Whether a model-supplied palette entry may be written into a CSS value.
+ *
+ * `palette` reaches `QuestionForm`'s swatch as `style={{ background: c }}`, and `background` is a
+ * SHORTHAND — it accepts far more than a colour. An agent (or anything that can influence one)
+ * emitting `url(https://attacker.example/pixel)` therefore got the browser to issue a request the
+ * moment the card rendered: a tracking beacon inside the chat transcript, needing no click. Neither
+ * React nor the CSSOM filters this; React passes style values through, and the CSSOM happily
+ * accepts a valid shorthand.
+ *
+ * Enforced HERE rather than at the swatch, because this is the normalization boundary and the
+ * component is not the only thing that could ever read `palette`. An entry that fails is DROPPED
+ * rather than substituted: a silently recoloured swatch would misrepresent the agent's proposal,
+ * and a card with fewer swatches is honest about what survived validation.
+ */
+export function isRenderableColor(value) {
+    const candidate = value.trim();
+    // Bounded before any regex runs: these come from model output, and the function pattern's `\s*`
+    // plus a character class is the shape that makes a pathological input worth not accepting at all.
+    if (candidate.length === 0 || candidate.length > 64)
+        return false;
+    return HEX_COLOR.test(candidate) || COLOR_KEYWORD.test(candidate) || COLOR_FUNCTION.test(candidate);
+}
+function parseDirectionCards(raw) {
+    if (!Array.isArray(raw))
+        return undefined;
+    const out = [];
+    for (const entry of raw) {
+        if (!entry || typeof entry !== 'object')
+            continue;
+        const e = entry;
+        const id = typeof e.id === 'string' && e.id.trim().length > 0 ? e.id.trim() : null;
+        const label = typeof e.label === 'string' ? e.label : null;
+        if (id === null || label === null)
+            continue;
+        const mood = typeof e.mood === 'string' ? e.mood : '';
+        const references = Array.isArray(e.references) ? e.references.filter((r) => typeof r === 'string').slice(0, 6) : [];
+        const palette = Array.isArray(e.palette)
+            ? e.palette.filter((p) => typeof p === 'string' && isRenderableColor(p)).slice(0, 8)
+            : [];
+        const displayFont = typeof e.displayFont === 'string' ? e.displayFont : 'Georgia, serif';
+        const bodyFont = typeof e.bodyFont === 'string' ? e.bodyFont : '-apple-system, system-ui, sans-serif';
+        out.push({ id, label, mood, references, palette, displayFont, bodyFont });
+    }
+    return out.length > 0 ? out : undefined;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/core/question-form/normalize.js.map

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

package/dist/core/question-form/scan.d.ts

@@ -0,0 +1,50 @@
+import type { FormSegment, QuestionForm } from './types.js';
+/**
+ * Split `input` into ordered prose/form segments. Scans repeatedly for
+ * `question-form`/`ask-question` opens; for each, locates the matching close
+ * tag and tries to parse the JSON body. A block that doesn't parse cleanly,
+ * or has no close tag yet, is left in the prose stream verbatim.
+ *
+ * @complexity O(n) amortized in `input.length` — each iteration advances the
+ *   cursor past the segment it just emitted.
+ */
+export declare function splitOnQuestionForms(input: string): FormSegment[];
+/** The first complete, parseable `<question-form>` in `input`, or `null`. */
+export declare function findFirstQuestionForm(input: string): {
+    form: QuestionForm;
+    raw: string;
+} | null;
+/**
+ * Convenience wrapper over {@link findFirstQuestionForm} matching the
+ * `parseQuestionForm()` name from the target API — returns just the form
+ * (dropping the matched raw text), or `null` when `input` has no complete
+ * question-form block. For a still-streaming block use
+ * {@link parsePartialQuestionForm} instead.
+ */
+export declare function parseQuestionForm(input: string): QuestionForm | null;
+/**
+ * Drop a trailing, not-yet-closed question-form block from streaming text so
+ * a chat surface doesn't flash raw `<question-form>{…` markup before the
+ * JSON finishes. Returns the visible text plus whether such an open block
+ * existed (meaning a form is mid-generation).
+ */
+export declare function stripTrailingOpenQuestionForm(input: string): {
+    text: string;
+    hadOpenForm: boolean;
+};
+/** `true` when a question-form open tag is present but its close tag hasn't streamed in yet. */
+export declare function hasUnterminatedQuestionForm(input: string): boolean;
+/**
+ * Tolerant parser for a still-streaming `<question-form>` block. Unlike
+ * {@link tryParseForm} it does not require valid, complete JSON: it reads the
+ * title/id from the open tag's attrs (available the instant the tag streams
+ * in) and extracts however many *complete* question objects have arrived so
+ * far, so a Questions panel can render a frame immediately and fill
+ * questions in progressively. Returns `null` only when no open tag is
+ * present at all.
+ *
+ * @complexity O(n) in `input.length` (one regex scan plus a linear
+ *   string-aware brace walk via {@link parsePartialJson}).
+ */
+export declare function parsePartialQuestionForm(input: string): QuestionForm | null;
+//# sourceMappingURL=scan.d.ts.map

package/dist/core/question-form/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../src/core/question-form/scan.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAgB,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAiB1E;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAoCjE;AAED,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAK/F;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAiBnG;AAED,gGAAgG;AAChG,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElE;AAoDD;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAoC3E"}