@metaobjectsdev/render 0.7.0-rc.9 → 0.8.0-rc.1

package/dist/index.d.ts

@@ -2,4 +2,12 @@ export { render, type RenderOptions } from "./render.js";
 export { type Provider, InMemoryProvider } from "./provider.js";
 export { ESCAPERS, type RenderFormat } from "./escapers.js";
 export { verify, ERR_VAR_NOT_ON_PAYLOAD, ERR_PARTIAL_UNRESOLVED, ERR_REQUIRED_SLOT_UNUSED, ERR_OUTPUT_TAG_MISSING, type PayloadField, type VerifyError, type VerifyOptions, } from "./verify.js";
+export { recover } from "./recover/recover.js";
+export { Format, FieldKind, FieldRecovery, Tolerance, RecoveryReport, scalar, enumField, range, object, recoverSchema, defaults, type FieldSpec, type RecoverSchema, type RecoverOptions, type RecoverOutcome, type RecoveryResult, type Coercion, type OnField, } from "./recover/types.js";
+export { asString, asInt, asLong, asDouble, asBool, asStringList, } from "./recover/recover-map.js";
+export { renderOutputFormat } from "./prompt/output-format-renderer.js";
+export { PromptStyle, promptStyleFrom } from "./prompt/prompt-style.js";
+export { PROMPT_OVERRIDES_NONE, noOverrides, type PromptOverrides, } from "./prompt/prompt-overrides.js";
+export type { OutputFormatSpec } from "./prompt/output-format-spec.js";
+export type { PromptField } from "./prompt/prompt-field.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,KAAK,QAAQ,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EACL,MAAM,EACN,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,KAAK,QAAQ,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EACL,MAAM,EACN,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EACL,MAAM,EACN,SAAS,EACT,aAAa,EACb,SAAS,EACT,cAAc,EACd,MAAM,EACN,SAAS,EACT,KAAK,EACL,MAAM,EACN,aAAa,EACb,QAAQ,EACR,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,OAAO,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,QAAQ,EACR,KAAK,EACL,MAAM,EACN,QAAQ,EACR,MAAM,EACN,YAAY,GACb,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EACL,qBAAqB,EACrB,WAAW,EACX,KAAK,eAAe,GACrB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -2,4 +2,12 @@ export { render } from "./render.js";
 export { InMemoryProvider } from "./provider.js";
 export { ESCAPERS } from "./escapers.js";
 export { verify, ERR_VAR_NOT_ON_PAYLOAD, ERR_PARTIAL_UNRESOLVED, ERR_REQUIRED_SLOT_UNUSED, ERR_OUTPUT_TAG_MISSING, } from "./verify.js";
+// FR-010 tolerant recover engine (Tier-2 forgiving parser).
+export { recover } from "./recover/recover.js";
+export { Format, FieldKind, FieldRecovery, Tolerance, RecoveryReport, scalar, enumField, range, object, recoverSchema, defaults, } from "./recover/types.js";
+export { asString, asInt, asLong, asDouble, asBool, asStringList, } from "./recover/recover-map.js";
+// FR-010 artifact 1 — output-format prompt renderer ("produce your answer like this").
+export { renderOutputFormat } from "./prompt/output-format-renderer.js";
+export { PromptStyle, promptStyleFrom } from "./prompt/prompt-style.js";
+export { PROMPT_OVERRIDES_NONE, noOverrides, } from "./prompt/prompt-overrides.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAsB,MAAM,aAAa,CAAC;AACzD,OAAO,EAAiB,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAqB,MAAM,eAAe,CAAC;AAC5D,OAAO,EACL,MAAM,EACN,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,GAIvB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAsB,MAAM,aAAa,CAAC;AACzD,OAAO,EAAiB,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAqB,MAAM,eAAe,CAAC;AAC5D,OAAO,EACL,MAAM,EACN,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,GAIvB,MAAM,aAAa,CAAC;AAErB,4DAA4D;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EACL,MAAM,EACN,SAAS,EACT,aAAa,EACb,SAAS,EACT,cAAc,EACd,MAAM,EACN,SAAS,EACT,KAAK,EACL,MAAM,EACN,aAAa,EACb,QAAQ,GAQT,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,QAAQ,EACR,KAAK,EACL,MAAM,EACN,QAAQ,EACR,MAAM,EACN,YAAY,GACb,MAAM,0BAA0B,CAAC;AAElC,uFAAuF;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EACL,qBAAqB,EACrB,WAAW,GAEZ,MAAM,8BAA8B,CAAC"}

package/dist/prompt/output-format-renderer.d.ts

@@ -0,0 +1,8 @@
+import type { OutputFormatSpec } from "./output-format-spec.js";
+import type { PromptOverrides } from "./prompt-overrides.js";
+/**
+ * Render an {@link OutputFormatSpec} into an output-format prompt fragment. The
+ * effective style is the override's style if present, otherwise the spec's.
+ */
+export declare function renderOutputFormat(spec: OutputFormatSpec, overrides: PromptOverrides): string;
+//# sourceMappingURL=output-format-renderer.d.ts.map

package/dist/prompt/output-format-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format-renderer.d.ts","sourceRoot":"","sources":["../../src/prompt/output-format-renderer.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAe7D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,eAAe,GAAG,MAAM,CAU7F"}

package/dist/prompt/output-format-renderer.js

@@ -0,0 +1,164 @@
+// FR-010 artifact 1 — output-format prompt renderer ("produce your answer like this").
+//
+// Renders an OutputFormatSpec into a prompt fragment that teaches an LLM how to
+// shape its answer. Three comment-free styles (guide / inline / exampleOnly) ×
+// two formats (json / xml). Guidance is carried in prose / inline placeholders /
+// a filled skeleton — NEVER in comments (models ignore them).
+//
+// Cross-port INVARIANT: the rendered text is byte-identical to the Java/C#/Kotlin
+// reference (com.metaobjects.render.prompt.OutputFormatRenderer). Do not change
+// the verbatim prose, skeleton shapes, or numeric-vs-quoted decision.
+import { ESCAPERS } from "../escapers.js";
+import { FieldKind, Format } from "../recover/types.js";
+import { PromptStyle } from "./prompt-style.js";
+const NUMERIC_KINDS = new Set([
+    FieldKind.INT,
+    FieldKind.LONG,
+    FieldKind.DOUBLE,
+    FieldKind.BOOLEAN,
+]);
+// The render engine OWNS format-keyed escaping; Format ("JSON"/"XML") maps to the
+// lowercase ESCAPERS keys.
+const escapeXml = (s) => ESCAPERS.xml(s);
+const escapeJson = (s) => ESCAPERS.json(s);
+/**
+ * Render an {@link OutputFormatSpec} into an output-format prompt fragment. The
+ * effective style is the override's style if present, otherwise the spec's.
+ */
+export function renderOutputFormat(spec, overrides) {
+    const effectiveStyle = overrides.style ?? spec.style;
+    switch (effectiveStyle) {
+        case PromptStyle.EXAMPLE_ONLY:
+            return renderExampleOnly(spec, overrides);
+        case PromptStyle.INLINE:
+            return renderInline(spec, overrides);
+        default:
+            return renderGuide(spec, overrides);
+    }
+}
+// ---- INLINE ----------------------------------------------------------------
+function renderInline(spec, overrides) {
+    return spec.format === Format.XML
+        ? renderXmlInline(spec, overrides)
+        : renderJsonInline(spec, overrides);
+}
+function renderXmlInline(spec, overrides) {
+    const lines = spec.fields.map((field) => {
+        const escaped = escapeXml(inlineContent(field, overrides));
+        return `  <${field.name}>${escaped}</${field.name}>\n`;
+    });
+    return `<${spec.rootName}>\n${lines.join("")}</${spec.rootName}>`;
+}
+function renderJsonInline(spec, overrides) {
+    const lines = spec.fields.map((field) => `  "${field.name}": "${escapeJson(inlineContent(field, overrides))}"`);
+    // Empty object is `{\n}` (Java/C# parity), not `{\n\n}` from join("") on no lines.
+    return spec.fields.length === 0 ? "{\n}" : `{\n${lines.join(",\n")}\n}`;
+}
+function inlineContent(field, overrides) {
+    if (field.kind === FieldKind.ENUM && field.enumValues != null && field.enumValues.length > 0) {
+        return field.enumValues.join(" | ");
+    }
+    if (field.kind === FieldKind.BOOLEAN) {
+        return "true | false";
+    }
+    const instruction = resolveInstruction(field, overrides);
+    return instruction != null ? `{${instruction}}` : `{${field.name}}`;
+}
+/** Effective instruction: override first, then the field default, else null. */
+function resolveInstruction(field, overrides) {
+    const ov = overrides.instructions?.[field.name];
+    if (ov != null)
+        return ov;
+    return field.instruction;
+}
+// ---- GUIDE -----------------------------------------------------------------
+function renderGuide(spec, overrides) {
+    let sb = "Fill in each field as described below:\n";
+    for (const field of spec.fields) {
+        const req = field.required ? "required" : "optional";
+        sb += `- ${field.name} (${req})`;
+        const instruction = resolveInstruction(field, overrides);
+        if (instruction != null) {
+            sb += `: ${instruction}`;
+        }
+        sb += "\n";
+        if (field.kind === FieldKind.ENUM && field.enumValues != null && field.enumValues.length > 0) {
+            sb += `    one of ${field.enumValues.join(", ")}\n`;
+            const enumDoc = field.enumDoc;
+            if (enumDoc != null) {
+                for (const val of field.enumValues) {
+                    const doc = enumDoc[val];
+                    if (doc != null) {
+                        sb += `      ${val} = ${doc}\n`;
+                    }
+                }
+            }
+        }
+        const eg = exampleValueIfDeclared(field, overrides);
+        if (eg != null) {
+            sb += `    e.g. ${eg}\n`;
+        }
+    }
+    sb += "\nRespond exactly like this:\n";
+    sb += renderExampleOnly(spec, overrides);
+    return sb;
+}
+// ---- EXAMPLE-ONLY (also the skeleton appended by GUIDE) ---------------------
+function renderExampleOnly(spec, overrides) {
+    return spec.format === Format.XML
+        ? renderXmlSkeleton(spec, overrides)
+        : renderJsonSkeleton(spec, overrides);
+}
+function renderXmlSkeleton(spec, overrides) {
+    const lines = spec.fields.map((field) => {
+        const escaped = escapeXml(exampleValue(field, overrides));
+        return `  <${field.name}>${escaped}</${field.name}>\n`;
+    });
+    return `<${spec.rootName}>\n${lines.join("")}</${spec.rootName}>`;
+}
+function renderJsonSkeleton(spec, overrides) {
+    // NOTE: FieldKind.OBJECT / nested fields are not expanded here — they render as
+    // a "{fieldName}" placeholder. Nested-object expansion is a bounded deferral
+    // (mirrors Java/C#).
+    const lines = spec.fields.map((field) => {
+        const value = exampleValue(field, overrides);
+        const rendered = isNumericOrBoolean(field.kind, value) ? value : `"${escapeJson(value)}"`;
+        return `  "${field.name}": ${rendered}`;
+    });
+    // Empty object is `{\n}` (Java/C# parity), not `{\n\n}` from join("") on no lines.
+    return spec.fields.length === 0 ? "{\n}" : `{\n${lines.join(",\n")}\n}`;
+}
+function exampleValueIfDeclared(field, overrides) {
+    const ov = overrides.examples?.[field.name];
+    if (ov != null)
+        return ov;
+    if (field.example != null)
+        return field.example;
+    return null;
+}
+function exampleValue(field, overrides) {
+    const ov = overrides.examples?.[field.name];
+    if (ov != null)
+        return ov;
+    if (field.example != null)
+        return field.example;
+    if (field.kind === FieldKind.ENUM && field.enumValues != null && field.enumValues.length > 0) {
+        return field.enumValues[0];
+    }
+    return `{${field.name}}`;
+}
+function isNumericOrBoolean(kind, value) {
+    if (!NUMERIC_KINDS.has(kind))
+        return false;
+    if (value === "true" || value === "false")
+        return true;
+    // Finite-only: NaN/Infinity fall through to a quoted string so the emitted JSON
+    // stays valid. Number("") is 0, so guard the empty/blank case explicitly. Reject
+    // JS-only radix literals (0x../0b../0o..) that Number() accepts but Java/C# don't —
+    // same guard as the recover engine's parseFiniteNumber (keeps the JSON valid + parity).
+    const t = value.trim();
+    if (t === "" || /^[+-]?0[xXbBoO]/.test(t))
+        return false;
+    return Number.isFinite(Number(t));
+}
+//# sourceMappingURL=output-format-renderer.js.map

package/dist/prompt/output-format-renderer.js.map

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

package/dist/prompt/output-format-spec.d.ts

@@ -0,0 +1,18 @@
+import type { Format } from "../recover/types.js";
+import type { PromptField } from "./prompt-field.js";
+import type { PromptStyle } from "./prompt-style.js";
+/**
+ * A complete output-format descriptor: the format, the root element/object name,
+ * the default presentation style, and the ordered fields. Drives
+ * {@link renderOutputFormat}.
+ *
+ * Precondition: `rootName` must be identifier-safe (valid XML element name / JSON
+ * key). The renderer does not escape it.
+ */
+export interface OutputFormatSpec {
+    readonly format: Format;
+    readonly rootName: string;
+    readonly style: PromptStyle;
+    readonly fields: readonly PromptField[];
+}
+//# sourceMappingURL=output-format-spec.d.ts.map

package/dist/prompt/output-format-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format-spec.d.ts","sourceRoot":"","sources":["../../src/prompt/output-format-spec.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;CACzC"}

package/dist/prompt/output-format-spec.js

@@ -0,0 +1,3 @@
+// FR-010 artifact 1 — a complete output-format descriptor.
+export {};
+//# sourceMappingURL=output-format-spec.js.map

package/dist/prompt/output-format-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format-spec.js","sourceRoot":"","sources":["../../src/prompt/output-format-spec.ts"],"names":[],"mappings":"AAAA,2DAA2D"}

package/dist/prompt/prompt-field.d.ts

@@ -0,0 +1,22 @@
+import type { FieldKind } from "../recover/types.js";
+import type { OutputFormatSpec } from "./output-format-spec.js";
+/**
+ * One field of an output-format fragment. `enumValues`/`enumDoc` are non-null
+ * only for ENUM; `nested` non-null only for OBJECT; `example`/`instruction` are
+ * nullable.
+ *
+ * Precondition: `name` must be identifier-safe (valid XML element name / JSON
+ * key). The renderer does not escape field names.
+ */
+export interface PromptField {
+    readonly name: string;
+    readonly kind: FieldKind;
+    readonly required: boolean;
+    readonly array: boolean;
+    readonly enumValues: readonly string[] | null;
+    readonly enumDoc: Readonly<Record<string, string>> | null;
+    readonly example: string | null;
+    readonly instruction: string | null;
+    readonly nested: OutputFormatSpec | null;
+}
+//# sourceMappingURL=prompt-field.d.ts.map

package/dist/prompt/prompt-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-field.d.ts","sourceRoot":"","sources":["../../src/prompt/prompt-field.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC1C"}

package/dist/prompt/prompt-field.js

@@ -0,0 +1,3 @@
+// FR-010 artifact 1 — one field of an output-format fragment.
+export {};
+//# sourceMappingURL=prompt-field.js.map

package/dist/prompt/prompt-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-field.js","sourceRoot":"","sources":["../../src/prompt/prompt-field.ts"],"names":[],"mappings":"AAAA,8DAA8D"}

package/dist/prompt/prompt-overrides.d.ts

@@ -0,0 +1,16 @@
+import type { PromptStyle } from "./prompt-style.js";
+/**
+ * Render-time overrides of the metadata defaults. `style` undefined keeps the
+ * spec's style; the maps override `PromptField.example`/`PromptField.instruction`
+ * per field name.
+ */
+export interface PromptOverrides {
+    readonly style?: PromptStyle;
+    readonly examples?: Readonly<Record<string, string>>;
+    readonly instructions?: Readonly<Record<string, string>>;
+}
+/** No overrides — keep every metadata default. Mirrors Java `PromptOverrides.none()`. */
+export declare const PROMPT_OVERRIDES_NONE: PromptOverrides;
+/** No overrides — keep every metadata default. */
+export declare function noOverrides(): PromptOverrides;
+//# sourceMappingURL=prompt-overrides.d.ts.map

package/dist/prompt/prompt-overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-overrides.d.ts","sourceRoot":"","sources":["../../src/prompt/prompt-overrides.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC1D;AAED,yFAAyF;AACzF,eAAO,MAAM,qBAAqB,EAAE,eAKlC,CAAC;AAEH,kDAAkD;AAClD,wBAAgB,WAAW,IAAI,eAAe,CAE7C"}

package/dist/prompt/prompt-overrides.js

@@ -0,0 +1,13 @@
+// FR-010 artifact 1 — render-time overrides of the metadata defaults.
+/** No overrides — keep every metadata default. Mirrors Java `PromptOverrides.none()`. */
+export const PROMPT_OVERRIDES_NONE = Object.freeze({
+    // `style` omitted (not `undefined`) under exactOptionalPropertyTypes: an absent
+    // style keeps the spec's own style, matching Java `PromptOverrides.none()`.
+    examples: {},
+    instructions: {},
+});
+/** No overrides — keep every metadata default. */
+export function noOverrides() {
+    return PROMPT_OVERRIDES_NONE;
+}
+//# sourceMappingURL=prompt-overrides.js.map

package/dist/prompt/prompt-overrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-overrides.js","sourceRoot":"","sources":["../../src/prompt/prompt-overrides.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAetE,yFAAyF;AACzF,MAAM,CAAC,MAAM,qBAAqB,GAAoB,MAAM,CAAC,MAAM,CAAC;IAClE,gFAAgF;IAChF,4EAA4E;IAC5E,QAAQ,EAAE,EAAE;IACZ,YAAY,EAAE,EAAE;CACjB,CAAC,CAAC;AAEH,kDAAkD;AAClD,MAAM,UAAU,WAAW;IACzB,OAAO,qBAAqB,CAAC;AAC/B,CAAC"}

package/dist/prompt/prompt-style.d.ts

@@ -0,0 +1,17 @@
+/**
+ * - `"guide"`: prose field list ("Fill in each field…") followed by an example skeleton.
+ * - `"inline"`: a single skeleton whose field values are inline placeholders / enum choices.
+ * - `"exampleOnly"`: just a filled example skeleton, nothing else.
+ */
+export declare const PromptStyle: {
+    readonly GUIDE: "guide";
+    readonly INLINE: "inline";
+    readonly EXAMPLE_ONLY: "exampleOnly";
+};
+export type PromptStyle = (typeof PromptStyle)[keyof typeof PromptStyle];
+/**
+ * Maps the `@promptStyle` attribute string to a {@link PromptStyle}. Null or any
+ * unrecognized value falls back to `"guide"` (matches Java `PromptStyle.from`).
+ */
+export declare function promptStyleFrom(s?: string | null): PromptStyle;
+//# sourceMappingURL=prompt-style.d.ts.map

package/dist/prompt/prompt-style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-style.d.ts","sourceRoot":"","sources":["../../src/prompt/prompt-style.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;CAId,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEzE;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,CAS9D"}

package/dist/prompt/prompt-style.js

@@ -0,0 +1,34 @@
+// FR-010 artifact 1 — output-format prompt renderer.
+//
+// How the output-format fragment teaches the model. Guidance is NEVER carried in
+// comments (models ignore them) — it lives in prose / inline placeholders / a
+// filled skeleton. Default is "guide".
+//
+// Tier-2 idiomatic TS: the Java SCREAMING_SNAKE enum (GUIDE/INLINE/EXAMPLE_ONLY)
+// becomes a string-union whose members ARE the wire `@promptStyle` values
+// ("guide" | "inline" | "exampleOnly") — no name<->wire mapping table needed.
+/**
+ * - `"guide"`: prose field list ("Fill in each field…") followed by an example skeleton.
+ * - `"inline"`: a single skeleton whose field values are inline placeholders / enum choices.
+ * - `"exampleOnly"`: just a filled example skeleton, nothing else.
+ */
+export const PromptStyle = {
+    GUIDE: "guide",
+    INLINE: "inline",
+    EXAMPLE_ONLY: "exampleOnly",
+};
+/**
+ * Maps the `@promptStyle` attribute string to a {@link PromptStyle}. Null or any
+ * unrecognized value falls back to `"guide"` (matches Java `PromptStyle.from`).
+ */
+export function promptStyleFrom(s) {
+    switch (s) {
+        case PromptStyle.INLINE:
+            return PromptStyle.INLINE;
+        case PromptStyle.EXAMPLE_ONLY:
+            return PromptStyle.EXAMPLE_ONLY;
+        default:
+            return PromptStyle.GUIDE;
+    }
+}
+//# sourceMappingURL=prompt-style.js.map

package/dist/prompt/prompt-style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-style.js","sourceRoot":"","sources":["../../src/prompt/prompt-style.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,EAAE;AACF,iFAAiF;AACjF,8EAA8E;AAC9E,uCAAuC;AACvC,EAAE;AACF,iFAAiF;AACjF,0EAA0E;AAC1E,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,YAAY,EAAE,aAAa;CACnB,CAAC;AAGX;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,CAAiB;IAC/C,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,WAAW,CAAC,MAAM;YACrB,OAAO,WAAW,CAAC,MAAM,CAAC;QAC5B,KAAK,WAAW,CAAC,YAAY;YAC3B,OAAO,WAAW,CAAC,YAAY,CAAC;QAClC;YACE,OAAO,WAAW,CAAC,KAAK,CAAC;IAC7B,CAAC;AACH,CAAC"}

package/dist/recover/coerce.d.ts

@@ -0,0 +1,5 @@
+import type { FieldSpec, RecoverOptions, RecoveryReport } from "./types.js";
+/** Sentinel: the value was present but could not be coerced to the declared kind/vocabulary. */
+export declare const MALFORMED: unique symbol;
+export declare function coerceValue(raw: string | null, spec: FieldSpec, opts: RecoverOptions, fieldPath: string, report: RecoveryReport): unknown | typeof MALFORMED;
+//# sourceMappingURL=coerce.d.ts.map

package/dist/recover/coerce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerce.d.ts","sourceRoot":"","sources":["../../src/recover/coerce.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5E,gGAAgG;AAChG,eAAO,MAAM,SAAS,EAAE,OAAO,MAA2C,CAAC;AAE3E,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,GACrB,OAAO,GAAG,OAAO,SAAS,CAmC5B"}

package/dist/recover/coerce.js

@@ -0,0 +1,124 @@
+// Stage 7: canonicalize a raw scalar string per its FieldSpec. Returns the MALFORMED
+// sentinel when present-but-uncoercible. Mirrors Java Coerce.
+//
+// Tier-2 divergence (documented, parity with the C# port's KNOWN_GAPS): JS has one
+// number type. INT/LONG both truncate toward zero via Math.trunc and return `number`.
+// Coercion uses Number(...) + Number.isFinite, NOT Java's Double.parseDouble — so JS
+// does NOT accept Java's numeric suffixes ("42d"/"42f") or hex-float literals. The
+// load-bearing contract (finite-only acceptance; NaN/±Infinity → MALFORMED; numeric
+// classification) is identical across ports.
+import { FieldKind, Tolerance } from "./types.js";
+/** Sentinel: the value was present but could not be coerced to the declared kind/vocabulary. */
+export const MALFORMED = Symbol("recover.coerce.MALFORMED");
+export function coerceValue(raw, spec, opts, fieldPath, report) {
+    if (raw == null)
+        return MALFORMED;
+    if (opts.onField != null) {
+        const hooked = opts.onField(fieldPath, raw, spec);
+        if (hooked != null) {
+            report.addCoercion({ fieldPath, from: raw, to: stringify(hooked), kind: "onField" });
+            return hooked;
+        }
+    }
+    // Per-field runtime normalizer (bounded 20% surface). Keyed by field path, then simple name.
+    const norm = opts.normalizers[fieldPath] ?? opts.normalizers[spec.name];
+    if (norm != null) {
+        const normalized = norm(raw);
+        if (normalized != null) {
+            report.addCoercion({ fieldPath, from: raw, to: stringify(normalized), kind: "normalizer" });
+            return normalized;
+        }
+    }
+    const ci = opts.tolerance !== Tolerance.STRICT;
+    switch (spec.kind) {
+        case FieldKind.ENUM:
+            return coerceEnum(raw, spec, opts, fieldPath, report, ci);
+        case FieldKind.INT:
+        case FieldKind.LONG:
+            return coerceInt(raw, spec, fieldPath, report);
+        case FieldKind.DOUBLE:
+            return coerceDouble(raw, spec, fieldPath, report);
+        case FieldKind.BOOLEAN:
+            return coerceBool(raw, ci);
+        default:
+            return raw;
+    }
+}
+function coerceEnum(raw, spec, opts, path, report, ci) {
+    if (spec.enumValues != null) {
+        for (const v of spec.enumValues) {
+            if (v === raw)
+                return v;
+            if (ci && v.toLowerCase() === raw.toLowerCase()) {
+                report.addCoercion({ fieldPath: path, from: raw, to: v, kind: "case" });
+                return v;
+            }
+        }
+    }
+    const schemaTarget = spec.enumAlias == null ? undefined : spec.enumAlias[raw];
+    const runtimeTarget = opts.aliases[raw];
+    if (runtimeTarget != null) {
+        const kind = schemaTarget != null && schemaTarget !== runtimeTarget ? "runtime-alias-override" : "alias";
+        report.addCoercion({ fieldPath: path, from: raw, to: runtimeTarget, kind });
+        return runtimeTarget;
+    }
+    if (schemaTarget != null) {
+        report.addCoercion({ fieldPath: path, from: raw, to: schemaTarget, kind: "alias" });
+        return schemaTarget;
+    }
+    return MALFORMED;
+}
+function coerceInt(raw, spec, path, report) {
+    const n = parseFiniteNumber(raw);
+    if (n === null)
+        return MALFORMED;
+    return clamp(Math.trunc(n), spec, path, report);
+}
+function coerceDouble(raw, spec, path, report) {
+    const n = parseFiniteNumber(raw);
+    if (n === null)
+        return MALFORMED;
+    return clamp(n, spec, path, report);
+}
+/** Parse a trimmed numeric string; null if empty, non-numeric, or non-finite (NaN/±Infinity). */
+function parseFiniteNumber(raw) {
+    const t = raw.trim();
+    if (t.length === 0)
+        return null;
+    // Reject JS-only radix-prefixed literals (0x.., 0b.., 0o..) that Number() would
+    // accept but Java/C# numeric parsing rejects → MALFORMED. Keeps cross-port parity.
+    if (/^[+-]?0[xXbBoO]/.test(t))
+        return null;
+    const n = Number(t); // Number("") === 0, hence the empty guard above
+    return Number.isFinite(n) ? n : null;
+}
+function clamp(n, spec, path, report) {
+    let c = n;
+    if (spec.min != null && c < spec.min)
+        c = spec.min;
+    if (spec.max != null && c > spec.max)
+        c = spec.max;
+    if (c !== n)
+        report.addCoercion({ fieldPath: path, from: stringify(n), to: stringify(c), kind: "clamp" });
+    return c;
+}
+function coerceBool(raw, ci) {
+    const t = ci ? raw.trim().toLowerCase() : raw.trim();
+    switch (t) {
+        case "true":
+        case "yes":
+        case "1":
+            return true;
+        case "false":
+        case "no":
+        case "0":
+            return false;
+        default:
+            return MALFORMED;
+    }
+}
+/** Canonical string form (locale-independent), mirroring Java String.valueOf for the corpus. */
+function stringify(v) {
+    return String(v);
+}
+//# sourceMappingURL=coerce.js.map

package/dist/recover/coerce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerce.js","sourceRoot":"","sources":["../../src/recover/coerce.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,8DAA8D;AAC9D,EAAE;AACF,mFAAmF;AACnF,sFAAsF;AACtF,qFAAqF;AACrF,mFAAmF;AACnF,oFAAoF;AACpF,6CAA6C;AAE7C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGlD,gGAAgG;AAChG,MAAM,CAAC,MAAM,SAAS,GAAkB,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAE3E,MAAM,UAAU,WAAW,CACzB,GAAkB,EAClB,IAAe,EACf,IAAoB,EACpB,SAAiB,EACjB,MAAsB;IAEtB,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IAElC,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAClD,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACnB,MAAM,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;YACrF,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,6FAA6F;IAC7F,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxE,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACjB,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;YAC5F,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,MAAM,CAAC;IAC/C,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,SAAS,CAAC,IAAI;YACjB,OAAO,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QAC5D,KAAK,SAAS,CAAC,GAAG,CAAC;QACnB,KAAK,SAAS,CAAC,IAAI;YACjB,OAAO,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QACjD,KAAK,SAAS,CAAC,MAAM;YACnB,OAAO,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QACpD,KAAK,SAAS,CAAC,OAAO;YACpB,OAAO,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC7B;YACE,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CACjB,GAAW,EACX,IAAe,EACf,IAAoB,EACpB,IAAY,EACZ,MAAsB,EACtB,EAAW;IAEX,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAChC,IAAI,CAAC,KAAK,GAAG;gBAAE,OAAO,CAAC,CAAC;YACxB,IAAI,EAAE,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;gBAChD,MAAM,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;gBACxE,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC9E,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,aAAa,IAAI,IAAI,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,YAAY,IAAI,IAAI,IAAI,YAAY,KAAK,aAAa,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,OAAO,CAAC;QACzG,MAAM,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5E,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;QACzB,MAAM,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACpF,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,SAAS,CAAC,GAAW,EAAE,IAAe,EAAE,IAAY,EAAE,MAAsB;IACnF,MAAM,CAAC,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACjC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,YAAY,CAAC,GAAW,EAAE,IAAe,EAAE,IAAY,EAAE,MAAsB;IACtF,MAAM,CAAC,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACjC,OAAO,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,iGAAiG;AACjG,SAAS,iBAAiB,CAAC,GAAW;IACpC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,gFAAgF;IAChF,mFAAmF;IACnF,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,gDAAgD;IACrE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvC,CAAC;AAED,SAAS,KAAK,CAAC,CAAS,EAAE,IAAe,EAAE,IAAY,EAAE,MAAsB;IAC7E,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG;QAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;IACnD,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG;QAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;IACnD,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1G,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,UAAU,CAAC,GAAW,EAAE,EAAW;IAC1C,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IACrD,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,MAAM,CAAC;QACZ,KAAK,KAAK,CAAC;QACX,KAAK,GAAG;YACN,OAAO,IAAI,CAAC;QACd,KAAK,OAAO,CAAC;QACb,KAAK,IAAI,CAAC;QACV,KAAK,GAAG;YACN,OAAO,KAAK,CAAC;QACf;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,gGAAgG;AAChG,SAAS,SAAS,CAAC,CAAU;IAC3B,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC"}

package/dist/recover/json-forgiving-reader.d.ts

@@ -0,0 +1,5 @@
+/** Sentinel: a key appeared in the text but its value was empty/cut-off (present-but-garbled). */
+export declare const TRUNCATED: unique symbol;
+/** Parse a tolerant JSON object span into a forgiving record. Never throws. */
+export declare function readJson(span: string | null | undefined): Record<string, unknown>;
+//# sourceMappingURL=json-forgiving-reader.d.ts.map

package/dist/recover/json-forgiving-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-forgiving-reader.d.ts","sourceRoot":"","sources":["../../src/recover/json-forgiving-reader.ts"],"names":[],"mappings":"AAGA,kGAAkG;AAClG,eAAO,MAAM,SAAS,EAAE,OAAO,MAAyC,CAAC;AA+JzE,+EAA+E;AAC/E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEjF"}