@uwmd/core 1.1.2 → 1.5.0

package/dist/lease-abstract.js.map

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

package/dist/lite-bridge.d.ts

@@ -0,0 +1,67 @@
+import type { UWDocumentEnvelope } from './envelope.js';
+import type { ParsedUWLite } from './lite.js';
+export declare const UW_LITE_BRIDGE_PROFILE: "deal-summary-v1";
+export declare const UW_LITE_SOURCE_EXTENSION: "x_uw_lite_source";
+export interface UWLiteFieldMapping {
+    lite_path: string;
+    target_path: string;
+    expected_unit?: string;
+    label: string;
+}
+export interface UWLiteCompilationIssue {
+    code: string;
+    severity: 'error' | 'warning';
+    message: string;
+    field_path?: string;
+}
+export interface UWLiteCompilationReport {
+    profile: typeof UW_LITE_BRIDGE_PROFILE;
+    mappings: Array<{
+        lite_path: string;
+        target_path: string;
+    }>;
+    defaults: Array<{
+        path: string;
+        value: unknown;
+        reason: string;
+    }>;
+    issues: UWLiteCompilationIssue[];
+    source_preserved_in: typeof UW_LITE_SOURCE_EXTENSION;
+}
+export type UWLiteCompilationResult = {
+    ok: true;
+    envelope: UWDocumentEnvelope;
+    report: UWLiteCompilationReport;
+} | {
+    ok: false;
+    report: UWLiteCompilationReport;
+};
+export interface UWLiteProjectionReport {
+    profile: typeof UW_LITE_BRIDGE_PROFILE;
+    projected_paths: string[];
+    omitted_paths: string[];
+    /**
+     * Sections the source record externalized into `.uwpart.md` fragments
+     * (RFC 0021 §3), in envelope order. Projection is UWX→Lite only and never
+     * resolves fragments, so the content of these sections is absent from the
+     * projection *and* absent from `omitted_paths` — nothing in the envelope
+     * enumerates rows the record does not carry. Naming the section is the only
+     * complete account available, and §3 requires it.
+     */
+    externalized_sections: string[];
+    warnings: string[];
+    lossy: boolean;
+}
+export interface UWLiteProjectionResult {
+    content: string;
+    report: UWLiteProjectionReport;
+}
+export declare class UWLiteBridgeError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare const UW_LITE_FIELD_MAPPINGS: readonly UWLiteFieldMapping[];
+export declare function compileUWLite(document: ParsedUWLite): UWLiteCompilationResult;
+export declare function projectUWEnvelopeToLite(envelope: UWDocumentEnvelope): UWLiteProjectionResult;
+export declare function stringifyUWX(envelope: UWDocumentEnvelope): string;
+//# sourceMappingURL=lite-bridge.d.ts.map

package/dist/lite-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lite-bridge.d.ts","sourceRoot":"","sources":["../src/lite-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAGnB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,WAAW,CAAC;AAM7E,eAAO,MAAM,sBAAsB,EAAG,iBAA0B,CAAC;AACjE,eAAO,MAAM,wBAAwB,EAAG,kBAA2B,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,sBAAsB,CAAC;IACvC,QAAQ,EAAE,KAAK,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACjC,mBAAmB,EAAE,OAAO,wBAAwB,CAAC;CACtD;AAED,MAAM,MAAM,uBAAuB,GAC/B;IACE,EAAE,EAAE,IAAI,CAAC;IACT,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,EAAE,uBAAuB,CAAC;CACjC,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,uBAAuB,CAAC;CACjC,CAAC;AAEN,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,sBAAsB,CAAC;IACvC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB;;;;;;;OAOG;IACH,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,eAAO,MAAM,sBAAsB,EAAE,SAAS,kBAAkB,EA+CtD,CAAC;AA8BX,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,uBAAuB,CA8H7E;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,kBAAkB,GAC3B,sBAAsB,CAsExB;AA4BD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CA4CjE"}

package/dist/lite-bridge.js

@@ -0,0 +1,564 @@
+import { EXTERNAL_ANNOTATION_KEY } from './composition.js';
+import { isBlockedSegment } from './parser.js';
+import { FORMAT_VERSION } from './protocol.js';
+import { UW_LITE_REPRESENTATION_VERSION } from './source-representation.js';
+export const UW_LITE_BRIDGE_PROFILE = 'deal-summary-v1';
+export const UW_LITE_SOURCE_EXTENSION = 'x_uw_lite_source';
+export class UWLiteBridgeError extends Error {
+    code;
+    constructor(code, message) {
+        super(`[${code}] ${message}`);
+        this.name = 'UWLiteBridgeError';
+        this.code = code;
+    }
+}
+export const UW_LITE_FIELD_MAPPINGS = [
+    {
+        lite_path: 'acquisition.purchase_price',
+        target_path: 'valuation.purchase_price',
+        expected_unit: 'USD',
+        label: 'Purchase price',
+    },
+    {
+        lite_path: 'valuation.going_in_cap_rate',
+        target_path: 'valuation.going_in_cap_rate',
+        expected_unit: 'fraction',
+        label: 'Going-in cap rate',
+    },
+    {
+        lite_path: 'noi.net_operating_income',
+        target_path: 'noi_model.net_operating_income',
+        expected_unit: 'USD',
+        label: 'Net operating income',
+    },
+    {
+        lite_path: 'debt.loan_amount',
+        target_path: 'debt_structure.loan_amount',
+        expected_unit: 'USD',
+        label: 'Loan amount',
+    },
+    {
+        lite_path: 'debt.interest_rate',
+        target_path: 'debt_structure.interest_rate',
+        expected_unit: 'fraction',
+        label: 'Interest rate',
+    },
+    {
+        lite_path: 'debt.annual_debt_service',
+        target_path: 'debt_structure.annual_debt_service',
+        expected_unit: 'USD',
+        label: 'Annual debt service',
+    },
+    {
+        lite_path: 'property.total_units',
+        target_path: 'property.total_units',
+        label: 'Total units',
+    },
+    {
+        lite_path: 'property.total_nra_sqft',
+        target_path: 'property.total_nra_sqft',
+        label: 'Total NRA',
+    },
+];
+const MAPPING_BY_LITE_PATH = new Map(UW_LITE_FIELD_MAPPINGS.map((mapping) => [mapping.lite_path, mapping]));
+const _MAPPING_BY_TARGET_PATH = new Map(UW_LITE_FIELD_MAPPINGS.map((mapping) => [mapping.target_path, mapping]));
+const KNOWN_SECTIONS = new Set([
+    'deal_context',
+    'property',
+    'ownership',
+    'rent_roll',
+    'operating_statement',
+    'noi_model',
+    'valuation',
+    'debt_structure',
+    'sources_uses',
+    'dcf',
+    'stress_tests',
+    'market_analysis',
+    'borrower_sponsor',
+    'due_diligence',
+    'risk_assessment',
+    'compliance',
+    'assumptions',
+    'validation',
+    'gaps',
+]);
+export function compileUWLite(document) {
+    const report = {
+        profile: UW_LITE_BRIDGE_PROFILE,
+        mappings: [],
+        defaults: [],
+        issues: document.issues.map((issue) => ({
+            code: issue.code,
+            severity: issue.severity,
+            message: issue.message,
+            ...(issue.field_path ? { field_path: issue.field_path } : {}),
+        })),
+        source_preserved_in: UW_LITE_SOURCE_EXTENSION,
+    };
+    const frontmatter = compileFrontmatter(document, report);
+    const timestamp = readRequiredString(document.frontmatter, 'created', report);
+    if (report.issues.some((issue) => issue.severity === 'error') || !frontmatter || !timestamp) {
+        return { ok: false, report };
+    }
+    const actor = typeof document.frontmatter['created_by'] === 'string'
+        ? document.frontmatter['created_by']
+        : 'unknown';
+    if (actor === 'unknown') {
+        report.defaults.push({
+            path: 'frontmatter.created_by',
+            value: actor,
+            reason: 'Lite bridge provenance default for an unspecified author.',
+        });
+    }
+    const sectionValues = new Map();
+    for (const field of document.fields) {
+        const mapping = resolveFieldMapping(field, report);
+        if (!mapping)
+            continue;
+        if (field.period) {
+            report.issues.push({
+                code: 'LITE_COMPILE_PERIOD_UNSUPPORTED',
+                severity: 'error',
+                message: 'Period-qualified fields require a versioned period profile.',
+                field_path: field.path,
+            });
+            continue;
+        }
+        if (field.scenario && field.scenario !== 'base') {
+            report.issues.push({
+                code: 'LITE_COMPILE_SCENARIO_UNSUPPORTED',
+                severity: 'error',
+                message: 'Only the base scenario maps to a current UWX section in this profile.',
+                field_path: field.path,
+            });
+            continue;
+        }
+        if (mapping.expected_unit && field.unit !== mapping.expected_unit) {
+            report.issues.push({
+                code: 'LITE_COMPILE_UNIT_MISMATCH',
+                severity: 'error',
+                message: `Expected unit ${mapping.expected_unit}, received ${field.unit ?? 'none'}.`,
+                field_path: field.path,
+            });
+            continue;
+        }
+        const [section, ...path] = mapping.target_path.split('.');
+        if (!section || path.length === 0 || [section, ...path].some(isBlockedSegment)) {
+            throw new UWLiteBridgeError('LITE_MAPPING_INVALID', `Invalid target mapping ${mapping.target_path}.`);
+        }
+        const content = sectionValues.get(section) ?? {};
+        if (!setPath(content, path, field.value)) {
+            report.issues.push({
+                code: 'LITE_COMPILE_TARGET_CONFLICT',
+                severity: 'error',
+                message: `Multiple Lite fields map to ${mapping.target_path}.`,
+                field_path: field.path,
+            });
+            continue;
+        }
+        sectionValues.set(section, content);
+        report.mappings.push({
+            lite_path: field.path,
+            target_path: mapping.target_path,
+        });
+    }
+    if (report.issues.some((issue) => issue.severity === 'error')) {
+        return { ok: false, report };
+    }
+    const sections = {};
+    for (const [section, values] of [...sectionValues.entries()].sort(([left], [right]) => left.localeCompare(right))) {
+        sections[section] = createEnvelopeBlock(section, values, timestamp, actor);
+    }
+    const sourceExtension = createEnvelopeBlock(UW_LITE_SOURCE_EXTENSION, {
+        representation: 'uw-lite-markdown',
+        representation_version: document.representation_version,
+        profile: UW_LITE_BRIDGE_PROFILE,
+        markdown: document.raw,
+    }, timestamp, actor);
+    return {
+        ok: true,
+        envelope: {
+            envelope_version: '1.0',
+            format_version: FORMAT_VERSION,
+            frontmatter,
+            sections,
+            pipeline_log: [],
+            custom_calculations: [],
+            custom_scenarios: [],
+            extensions: { [UW_LITE_SOURCE_EXTENSION]: sourceExtension },
+            superseded: {},
+        },
+        report,
+    };
+}
+export function projectUWEnvelopeToLite(envelope) {
+    const lines = [
+        '---',
+        `uw_lite_version: ${UW_LITE_REPRESENTATION_VERSION}`,
+        ...projectFrontmatter(envelope.frontmatter),
+        '---',
+        '',
+    ];
+    const projectedPaths = [];
+    const groups = new Map();
+    for (const mapping of UW_LITE_FIELD_MAPPINGS) {
+        const value = getEnvelopePath(envelope, mapping.target_path);
+        if (value === undefined)
+            continue;
+        const section = mapping.target_path.split('.')[0] ?? 'deal';
+        const group = groups.get(section) ?? [];
+        group.push(`- ${mapping.label}: ${formatProjectedValue(value, mapping.expected_unit)} <!-- uw:${mapping.lite_path} -->`);
+        groups.set(section, group);
+        projectedPaths.push(mapping.target_path);
+    }
+    for (const [section, fields] of groups) {
+        lines.push(`# ${headingLabel(section)}`, '', ...fields, '');
+    }
+    const externalizedSections = collectExternalizedSections(envelope);
+    const allPaths = collectEnvelopeLeafPaths(envelope);
+    const ignored = new Set([
+        ...projectedPaths,
+        ...Object.keys(envelope.frontmatter).map((key) => `frontmatter.${key}`),
+    ]);
+    const omittedPaths = allPaths.filter((path) => !ignored.has(path) &&
+        !path.includes('._meta.') &&
+        !path.startsWith(`extensions.${UW_LITE_SOURCE_EXTENSION}.`) &&
+        // The directive's own keys — `parts`, `part_count`, `collection_key` —
+        // are packaging, not underwriting data. Listing them here would report
+        // the wrapper in place of the contents it stands for, which is worse
+        // than silence: an externalized record would appear to omit *fewer*
+        // paths than its inline twin. The section is named instead.
+        !externalizedSections.some((section) => path.startsWith(`${section}.${EXTERNAL_ANNOTATION_KEY}.`)));
+    const warnings = [];
+    if (omittedPaths.length > 0) {
+        warnings.push('Projection omits data that is not represented by the selected Lite profile.');
+    }
+    if (externalizedSections.length > 0) {
+        warnings.push(`Projection omits ${externalizedSections.length} externalized section(s) whose contents live in fragments this projection does not resolve: ${externalizedSections.join(', ')}.`);
+    }
+    return {
+        content: lines.join('\n').replace(/\n+$/g, '\n'),
+        report: {
+            profile: UW_LITE_BRIDGE_PROFILE,
+            projected_paths: projectedPaths.sort(),
+            omitted_paths: omittedPaths.sort(),
+            externalized_sections: externalizedSections,
+            warnings,
+            lossy: omittedPaths.length > 0 || externalizedSections.length > 0,
+        },
+    };
+}
+/**
+ * Sections carrying an RFC 0021 externalization directive, named by the same
+ * path prefix `collectEnvelopeLeafPaths` uses so the two agree on what to drop.
+ *
+ * Presence of the key is the whole test — whether the directive is *well-formed*
+ * is composition's business (`readExternalDirective` throws on a bad one). A
+ * projection must not throw over a malformed directive, and a section pointing
+ * at fragments is externalized either way.
+ */
+function collectExternalizedSections(envelope) {
+    const sections = [];
+    const isExternal = (block) => isRecord(block.content) && EXTERNAL_ANNOTATION_KEY in block.content;
+    for (const [section, entry] of Object.entries(envelope.sections)) {
+        if (isEnvelopeBlock(entry)) {
+            if (isExternal(entry))
+                sections.push(section);
+            continue;
+        }
+        for (const [variant, block] of Object.entries(entry)) {
+            if (isExternal(block))
+                sections.push(`${section}.${variant}`);
+        }
+    }
+    return sections;
+}
+export function stringifyUWX(envelope) {
+    const output = [serializeFrontmatter(envelope.frontmatter), ''];
+    for (const [, blocks] of Object.entries(envelope.superseded).sort(([left], [right]) => left.localeCompare(right))) {
+        for (const block of blocks) {
+            output.push(serializeEnvelopeBlock(block), '');
+        }
+    }
+    for (const [_section, entry] of Object.entries(envelope.sections).sort(([left], [right]) => left.localeCompare(right))) {
+        if (isEnvelopeBlock(entry)) {
+            output.push(serializeEnvelopeBlock(entry), '');
+            continue;
+        }
+        for (const [, block] of Object.entries(entry).sort(([left], [right]) => left.localeCompare(right))) {
+            output.push(serializeEnvelopeBlock(block), '');
+        }
+    }
+    for (const [id, block] of Object.entries(envelope.extensions).sort(([left], [right]) => left.localeCompare(right))) {
+        if (block.annotation.section !== id) {
+            throw new UWLiteBridgeError('UWX_EXTENSION_ID_MISMATCH', `Extension key ${id} disagrees with its block annotation.`);
+        }
+        output.push(serializeEnvelopeBlock(block), '');
+    }
+    for (const block of envelope.custom_calculations) {
+        output.push(serializeEnvelopeBlock(block), '');
+    }
+    for (const block of envelope.custom_scenarios) {
+        output.push(serializeEnvelopeBlock(block), '');
+    }
+    for (const block of envelope.pipeline_log) {
+        output.push(serializeEnvelopeBlock(block), '');
+    }
+    return output.join('\n').replace(/\n+$/g, '\n');
+}
+function compileFrontmatter(document, report) {
+    const dealId = readRequiredString(document.frontmatter, 'deal_id', report);
+    const dealName = readRequiredString(document.frontmatter, 'deal_name', report);
+    const created = readRequiredString(document.frontmatter, 'created', report);
+    if (!dealId || !dealName || !created)
+        return null;
+    const semanticVersion = typeof document.frontmatter['uw_version'] === 'string'
+        ? document.frontmatter['uw_version']
+        : FORMAT_VERSION;
+    if (document.frontmatter['uw_version'] === undefined) {
+        report.defaults.push({
+            path: 'frontmatter.uw_version',
+            value: FORMAT_VERSION,
+            reason: 'RFC 0017 keeps UW semantic format 1.1 for the initial bridge.',
+        });
+    }
+    const output = {
+        ...document.frontmatter,
+        uw_version: semanticVersion,
+        deal_id: dealId,
+        deal_name: dealName,
+        created,
+        last_modified: typeof document.frontmatter['last_modified'] === 'string'
+            ? document.frontmatter['last_modified']
+            : created,
+    };
+    delete output['uw_lite_version'];
+    return output;
+}
+function readRequiredString(frontmatter, key, report) {
+    const value = frontmatter[key];
+    if (typeof value === 'string' && value.trim() !== '')
+        return value;
+    report.issues.push({
+        code: 'LITE_COMPILE_FRONTMATTER_REQUIRED',
+        severity: 'error',
+        message: `Compilation requires frontmatter.${key}.`,
+    });
+    return null;
+}
+function resolveFieldMapping(field, report) {
+    const mapped = MAPPING_BY_LITE_PATH.get(field.path);
+    if (mapped)
+        return mapped;
+    const [section, ...rest] = field.path.split('.');
+    if (section && rest.length > 0 && KNOWN_SECTIONS.has(section)) {
+        return {
+            lite_path: field.path,
+            target_path: field.path,
+            ...(field.unit ? { expected_unit: field.unit } : {}),
+            label: field.label,
+        };
+    }
+    report.issues.push({
+        code: 'LITE_COMPILE_FIELD_UNKNOWN',
+        severity: 'error',
+        message: 'Field is not recognized by the selected bridge profile.',
+        field_path: field.path,
+    });
+    return null;
+}
+function createEnvelopeBlock(section, values, timestamp, actor) {
+    const meta = {
+        section,
+        version: 1,
+        superseded: false,
+        source: 'manual',
+        agent_id: null,
+        agent_version: null,
+        actor,
+        timestamp,
+        confidence: 'high',
+        human_review_required: false,
+        flags: [],
+        input_hash: null,
+        notes: null,
+    };
+    return {
+        annotation: {
+            section,
+            source: 'manual',
+            ts: timestamp,
+            v: 1,
+            confidence: 'high',
+        },
+        content: { _meta: meta, ...values },
+    };
+}
+function setPath(target, path, value) {
+    let cursor = target;
+    for (let index = 0; index < path.length - 1; index++) {
+        const key = path[index];
+        const existing = cursor[key];
+        if (existing !== undefined && !isRecord(existing))
+            return false;
+        const next = isRecord(existing) ? existing : {};
+        cursor[key] = next;
+        cursor = next;
+    }
+    const leaf = path.at(-1);
+    if (!leaf || Object.hasOwn(cursor, leaf))
+        return false;
+    cursor[leaf] = value;
+    return true;
+}
+function projectFrontmatter(frontmatter) {
+    const keys = ['deal_id', 'deal_name', 'created', 'last_modified', 'asset_class', 'created_by'];
+    return keys.flatMap((key) => {
+        const value = frontmatter[key];
+        return value === undefined ? [] : [`${key}: ${serializeYamlScalar(value)}`];
+    });
+}
+function getEnvelopePath(envelope, path) {
+    const [section, ...rest] = path.split('.');
+    const entry = envelope.sections[section];
+    if (!entry || !isEnvelopeBlock(entry))
+        return undefined;
+    let value = entry.content;
+    for (const segment of rest) {
+        if (!isRecord(value))
+            return undefined;
+        value = value[segment];
+    }
+    return value;
+}
+function collectEnvelopeLeafPaths(envelope) {
+    const output = [];
+    flattenLeaves(envelope.frontmatter, 'frontmatter', output);
+    for (const [section, entry] of Object.entries(envelope.sections)) {
+        if (isEnvelopeBlock(entry)) {
+            flattenLeaves(entry.content, section, output);
+        }
+        else {
+            for (const [variant, block] of Object.entries(entry)) {
+                flattenLeaves(block.content, `${section}.${variant}`, output);
+            }
+        }
+    }
+    for (const [id, block] of Object.entries(envelope.extensions)) {
+        flattenLeaves(block.content, `extensions.${id}`, output);
+    }
+    return output;
+}
+function flattenLeaves(value, prefix, output) {
+    if (Array.isArray(value)) {
+        value.forEach((item, index) => flattenLeaves(item, `${prefix}[${index}]`, output));
+        return;
+    }
+    if (isRecord(value)) {
+        for (const [key, child] of Object.entries(value)) {
+            flattenLeaves(child, `${prefix}.${key}`, output);
+        }
+        return;
+    }
+    output.push(prefix);
+}
+function formatProjectedValue(value, unit) {
+    if (typeof value !== 'number')
+        return String(value);
+    if (unit === 'USD') {
+        return `$${value.toLocaleString('en-US', { maximumFractionDigits: 2 })}`;
+    }
+    if (unit === 'fraction') {
+        return `${(value * 100).toLocaleString('en-US', { maximumFractionDigits: 6 })}%`;
+    }
+    if (unit === 'ratio')
+        return `${value}x`;
+    return value.toLocaleString('en-US', { maximumFractionDigits: 12 });
+}
+function headingLabel(section) {
+    return section
+        .split('_')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
+function serializeFrontmatter(frontmatter) {
+    const priority = ['uw_version', 'deal_id', 'deal_name', 'created', 'last_modified'];
+    const keys = Object.keys(frontmatter).sort((left, right) => {
+        const leftPriority = priority.indexOf(left);
+        const rightPriority = priority.indexOf(right);
+        if (leftPriority >= 0 || rightPriority >= 0) {
+            if (leftPriority < 0)
+                return 1;
+            if (rightPriority < 0)
+                return -1;
+            return leftPriority - rightPriority;
+        }
+        return left.localeCompare(right);
+    });
+    const lines = ['---'];
+    for (const key of keys) {
+        const value = frontmatter[key];
+        if (Array.isArray(value)) {
+            lines.push(`${key}:`);
+            for (const item of value)
+                lines.push(`  - ${serializeYamlScalar(item)}`);
+        }
+        else if (isRecord(value)) {
+            lines.push(`${key}:`);
+            for (const [childKey, child] of Object.entries(value).sort(([left], [right]) => left.localeCompare(right))) {
+                lines.push(`  ${childKey}: ${serializeYamlScalar(child)}`);
+            }
+        }
+        else {
+            lines.push(`${key}: ${serializeYamlScalar(value)}`);
+        }
+    }
+    lines.push('---');
+    return lines.join('\n');
+}
+function serializeYamlScalar(value) {
+    if (value === null || value === undefined)
+        return 'null';
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    const text = String(value);
+    if (text === '' ||
+        /^(?:true|false|null|~|-?\d+(?:\.\d+)?)$/i.test(text) ||
+        /[:#\[\]{},&*!|>'"%@\`\s]/.test(text)) {
+        return JSON.stringify(text);
+    }
+    return text;
+}
+function serializeEnvelopeBlock(block) {
+    const annotation = Object.entries(block.annotation)
+        .filter(([key]) => key !== 'section')
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([key, value]) => `${key}=${String(value)}`)
+        .join(' ');
+    const fence = `\`\`\`json uw:section=${block.annotation.section}${annotation ? ` ${annotation}` : ''}`;
+    const content = JSON.stringify(sortObject(block.content), null, 2);
+    return [block.prose?.trim(), fence, content, '\`\`\`'].filter(Boolean).join('\n');
+}
+function sortObject(value) {
+    if (Array.isArray(value))
+        return value.map(sortObject);
+    if (!isRecord(value))
+        return value;
+    return Object.fromEntries(Object.entries(value)
+        .sort(([left], [right]) => {
+        if (left === '_meta')
+            return -1;
+        if (right === '_meta')
+            return 1;
+        return left.localeCompare(right);
+    })
+        .map(([key, child]) => [key, sortObject(child)]));
+}
+function isEnvelopeBlock(value) {
+    return isRecord(value) && 'annotation' in value && 'content' in value;
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+//# sourceMappingURL=lite-bridge.js.map