@flyingrobots/bijou 5.0.0 → 7.0.0

package/dist/core/layout/envelope.js

@@ -0,0 +1,336 @@
+import { sanitizeNonNegativeInt } from '../numeric.js';
+export const RE035_LAYOUT_SCOPE = Object.freeze({
+    design: 'RE-035',
+    status: 'landed',
+    included: Object.freeze([
+        'layout-envelope',
+        'constraint-negotiation',
+        'stack',
+        'place',
+        'content-measurement-seam',
+        'render-assignment-seam',
+    ]),
+    deferred: Object.freeze([
+        'RE-036 text measurement and inline flow',
+        'RE-037 overflow, viewports, scroll anchoring, and scrollbars',
+        'RE-038 box model, chrome regions, hit testing, and focus maps',
+        'RE-039 responsive variants, compression, and constraint fallbacks',
+        'RE-040 accessible layout semantics',
+        'WS-001 workspace tree',
+    ]),
+});
+export function layoutConstraints(input = {}) {
+    const minInline = sanitizeNonNegativeInt(input.minInline, 0);
+    const minBlock = sanitizeNonNegativeInt(input.minBlock, 0);
+    return Object.freeze({
+        minInline,
+        maxInline: normalizeBound(input.maxInline, minInline),
+        minBlock,
+        maxBlock: normalizeBound(input.maxBlock, minBlock),
+    });
+}
+export function layoutPreference(input = {}) {
+    const minInline = sanitizeNonNegativeInt(input.minInline, 0);
+    const minBlock = sanitizeNonNegativeInt(input.minBlock, 0);
+    const maxInline = normalizeBound(input.maxInline, minInline);
+    const maxBlock = normalizeBound(input.maxBlock, minBlock);
+    return Object.freeze({
+        minInline,
+        preferredInline: normalizePreferred(input.preferredInline, minInline, maxInline),
+        maxInline,
+        minBlock,
+        preferredBlock: normalizePreferred(input.preferredBlock, minBlock, maxBlock),
+        maxBlock,
+    });
+}
+export function assignedLayoutRect(input) {
+    return Object.freeze({
+        inlineStart: sanitizeNonNegativeInt(input.inlineStart, 0),
+        blockStart: sanitizeNonNegativeInt(input.blockStart, 0),
+        inlineSize: sanitizeNonNegativeInt(input.inlineSize, 0),
+        blockSize: sanitizeNonNegativeInt(input.blockSize, 0),
+    });
+}
+export function defineLayoutEnvelope(input) {
+    const id = normalizeRequiredText(input.id, 'layout envelope: id is required');
+    const role = normalizeRequiredText(input.role, 'layout envelope: role is required');
+    const direction = normalizeDirection(input.direction);
+    const envelope = {
+        id,
+        role,
+        direction,
+        constraints: input.constraints,
+        preference: input.preference,
+        ...(input.fit === undefined ? {} : { fit: input.fit }),
+    };
+    return Object.freeze(envelope);
+}
+export function assignLayoutChild(envelope, assigned, reason) {
+    const resolved = {
+        ...envelope,
+        assigned: assignedLayoutRect(assigned),
+        reason: normalizeRequiredText(reason, 'layout assignment: reason is required'),
+    };
+    return Object.freeze(resolved);
+}
+export function isResolvedLayoutEnvelope(envelope) {
+    return typeof envelope.assigned === 'object'
+        && envelope.assigned !== null
+        && typeof envelope.reason === 'string'
+        && envelope.reason.length > 0;
+}
+export function renderWithResolvedLayout(envelope, renderer) {
+    if (!isResolvedLayoutEnvelope(envelope)) {
+        throw new Error(`layout render seam: visible node ${envelope.id} requires an assigned layout envelope`);
+    }
+    const output = renderer({ envelope, assigned: envelope.assigned });
+    return Object.freeze({
+        envelope,
+        assigned: envelope.assigned,
+        output,
+    });
+}
+export function contentExtentFromSurface(surface, facts = []) {
+    return contentExtent('surface', {
+        inlineSize: surface.width,
+        blockSize: surface.height,
+        facts,
+    });
+}
+export function contentExtentFromBuffer(input) {
+    return contentExtent('buffer', {
+        inlineSize: input.inlineSize ?? input.width ?? 0,
+        blockSize: input.blockSize ?? input.height ?? 0,
+        baseline: input.baseline,
+        facts: input.facts ?? [],
+    });
+}
+export function measureTextContent(input) {
+    const measured = input.adapter({
+        text: input.text,
+        availableInline: sanitizeNonNegativeInt(input.availableInline, 0),
+        direction: normalizeDirection(input.direction),
+        wrap: input.wrap ?? 'none',
+    });
+    return contentExtent('text', measured);
+}
+export function resolveStackLayout(input) {
+    const children = [...input.children];
+    const assigned = assignedLayoutRect(input.rect);
+    const axis = input.axis;
+    const direction = normalizeDirection(input.direction);
+    const gap = sanitizeNonNegativeInt(input.gap, 0);
+    const mainSize = axis === 'inline' ? assigned.inlineSize : assigned.blockSize;
+    const crossSize = axis === 'inline' ? assigned.blockSize : assigned.inlineSize;
+    const totalGap = gap * Math.max(0, children.length - 1);
+    const available = Math.max(0, mainSize - totalGap);
+    const sizes = resolveStackTrackSizes(children, available);
+    const resolvedChildren = [];
+    let cursor = axis === 'inline' ? assigned.inlineStart : assigned.blockStart;
+    for (let index = 0; index < children.length; index++) {
+        const child = children[index];
+        const size = sizes[index] ?? 0;
+        const rect = axis === 'inline'
+            ? {
+                inlineStart: cursor,
+                blockStart: assigned.blockStart,
+                inlineSize: size,
+                blockSize: crossSize,
+            }
+            : {
+                inlineStart: assigned.inlineStart,
+                blockStart: cursor,
+                inlineSize: crossSize,
+                blockSize: size,
+            };
+        const reason = child.track.kind === 'fixed'
+            ? `stack ${axis} fixed track ${size} cells`
+            : `stack ${axis} flex track ${trackWeight(child.track)} resolved by largest-remainder-source-order`;
+        resolvedChildren.push(assignLayoutChild(child.envelope, rect, reason));
+        cursor += size + (index < children.length - 1 ? gap : 0);
+    }
+    return Object.freeze({
+        id: normalizeRequiredText(input.id, 'stack layout: id is required'),
+        role: normalizeRequiredText(input.role, 'stack layout: role is required'),
+        axis,
+        direction,
+        assigned,
+        roundingPolicy: 'largest-remainder-source-order',
+        children: Object.freeze(resolvedChildren),
+    });
+}
+export function placeInRect(input) {
+    const parent = assignedLayoutRect(input.parent);
+    const direction = normalizeDirection(input.direction ?? input.envelope.direction);
+    const inlineAlign = input.inlineAlign;
+    const blockAlign = input.blockAlign;
+    const inlineSize = inlineAlign === 'stretch'
+        ? parent.inlineSize
+        : Math.min(parent.inlineSize, sanitizeNonNegativeInt(input.size.inlineSize, 0));
+    const blockSize = blockAlign === 'stretch'
+        ? parent.blockSize
+        : Math.min(parent.blockSize, sanitizeNonNegativeInt(input.size.blockSize, 0));
+    const inlineOffset = resolveInlineOffset(parent.inlineSize, inlineSize, inlineAlign, direction);
+    const blockOffset = resolveBlockOffset(parent.blockSize, blockSize, blockAlign);
+    return assignLayoutChild(input.envelope, {
+        inlineStart: parent.inlineStart + inlineOffset,
+        blockStart: parent.blockStart + blockOffset,
+        inlineSize,
+        blockSize,
+    }, `place ${direction} inline ${inlineAlign} block ${blockAlign}`);
+}
+export function layoutExplanationFacts(envelope) {
+    return Object.freeze([
+        fact('node.id', envelope.id),
+        fact('role', envelope.role),
+        fact('direction', envelope.direction),
+        fact('constraints.inline', formatRange(envelope.constraints.minInline, envelope.constraints.maxInline)),
+        fact('constraints.block', formatRange(envelope.constraints.minBlock, envelope.constraints.maxBlock)),
+        fact('preference.inline', formatPreference(envelope.preference.minInline, envelope.preference.preferredInline, envelope.preference.maxInline)),
+        fact('preference.block', formatPreference(envelope.preference.minBlock, envelope.preference.preferredBlock, envelope.preference.maxBlock)),
+        fact('assigned', [
+            `inline-start ${envelope.assigned.inlineStart}`,
+            `block-start ${envelope.assigned.blockStart}`,
+            `inline-size ${envelope.assigned.inlineSize}`,
+            `block-size ${envelope.assigned.blockSize}`,
+        ].join(' ')),
+        fact('reason', envelope.reason),
+    ]);
+}
+export function layoutExplanationText(envelope) {
+    const facts = layoutExplanationFacts(envelope);
+    return [
+        `node ${envelope.id}`,
+        ...facts
+            .filter((item) => item.key !== 'node.id')
+            .map((item) => `${item.key} ${item.value}`),
+    ].join('\n');
+}
+function contentExtent(source, input) {
+    const extent = {
+        source,
+        inlineSize: sanitizeNonNegativeInt(input.inlineSize, 0),
+        blockSize: sanitizeNonNegativeInt(input.blockSize, 0),
+        ...(input.baseline === undefined ? {} : { baseline: sanitizeNonNegativeInt(input.baseline, 0) }),
+        facts: freezeFacts(input.facts ?? []),
+    };
+    return Object.freeze(extent);
+}
+function resolveStackTrackSizes(children, available) {
+    const sizes = new Array(children.length).fill(0);
+    let fixed = 0;
+    let totalFlex = 0;
+    for (let index = 0; index < children.length; index++) {
+        const track = children[index].track;
+        if (track.kind === 'fixed') {
+            const size = sanitizeNonNegativeInt(track.size, 0);
+            sizes[index] = size;
+            fixed += size;
+        }
+        else {
+            totalFlex += trackWeight(track);
+        }
+    }
+    if (fixed > available) {
+        let remaining = available;
+        for (let index = 0; index < children.length; index++) {
+            if (children[index].track.kind !== 'fixed')
+                continue;
+            const next = Math.min(sizes[index] ?? 0, remaining);
+            sizes[index] = next;
+            remaining = Math.max(0, remaining - next);
+        }
+        return sizes;
+    }
+    const remaining = Math.max(0, available - fixed);
+    if (totalFlex <= 0 || remaining <= 0)
+        return sizes;
+    let assigned = 0;
+    const fractionalShares = [];
+    for (let index = 0; index < children.length; index++) {
+        const track = children[index].track;
+        if (track.kind !== 'flex')
+            continue;
+        const raw = (remaining * trackWeight(track)) / totalFlex;
+        const whole = Math.floor(raw);
+        sizes[index] = whole;
+        assigned += whole;
+        fractionalShares.push({ index, remainder: raw - whole });
+    }
+    let leftover = remaining - assigned;
+    fractionalShares.sort((left, right) => right.remainder - left.remainder || left.index - right.index);
+    for (const share of fractionalShares) {
+        if (leftover <= 0)
+            break;
+        sizes[share.index] = (sizes[share.index] ?? 0) + 1;
+        leftover -= 1;
+    }
+    return sizes;
+}
+function trackWeight(track) {
+    if (track.kind !== 'flex')
+        return 0;
+    const weight = track.weight ?? 1;
+    if (!Number.isFinite(weight) || weight <= 0)
+        return 1;
+    return Math.max(1, Math.floor(weight));
+}
+function resolveInlineOffset(parentSize, childSize, align, direction) {
+    const remaining = Math.max(0, parentSize - childSize);
+    if (align === 'stretch')
+        return 0;
+    if (align === 'center')
+        return Math.floor(remaining / 2);
+    if (direction === 'rtl') {
+        return align === 'start' ? remaining : 0;
+    }
+    return align === 'start' ? 0 : remaining;
+}
+function resolveBlockOffset(parentSize, childSize, align) {
+    const remaining = Math.max(0, parentSize - childSize);
+    if (align === 'stretch' || align === 'start')
+        return 0;
+    if (align === 'center')
+        return Math.floor(remaining / 2);
+    return remaining;
+}
+function normalizeBound(value, min) {
+    if (value === 'unbounded' || value === undefined)
+        return 'unbounded';
+    return Math.max(min, sanitizeNonNegativeInt(value, min));
+}
+function normalizePreferred(value, min, max) {
+    const preferred = sanitizeNonNegativeInt(value, min);
+    if (max === 'unbounded')
+        return Math.max(min, preferred);
+    return Math.max(min, Math.min(max, preferred));
+}
+function normalizeDirection(direction) {
+    return direction ?? 'ltr';
+}
+function normalizeRequiredText(value, message) {
+    const normalized = value.trim();
+    if (normalized.length === 0)
+        throw new Error(message);
+    return normalized;
+}
+function freezeFacts(facts) {
+    return Object.freeze(facts.map((item) => Object.freeze({
+        kind: item.kind,
+        key: item.key,
+        value: item.value,
+    })));
+}
+function fact(key, value) {
+    return Object.freeze({ kind: 'layout', key, value });
+}
+function formatRange(min, max) {
+    return `${min}..${formatBound(max)}`;
+}
+function formatPreference(min, preferred, max) {
+    return `min ${min} preferred ${preferred} max ${formatBound(max)}`;
+}
+function formatBound(bound) {
+    return bound === 'unbounded' ? 'unbounded' : String(bound);
+}
+//# sourceMappingURL=envelope.js.map

package/dist/core/layout/envelope.js.map

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

package/dist/core/mode-lowering.d.ts

@@ -0,0 +1,48 @@
+import type { OutputMode } from './detect/tty.js';
+export type ModeLoweringFactKind = 'entity' | 'edge' | 'count' | 'label' | 'state' | 'custom';
+export type ModeLoweringFactValue = string | number | boolean;
+export interface ModeLoweringFact {
+    readonly kind: ModeLoweringFactKind;
+    readonly key: string;
+    readonly value?: ModeLoweringFactValue;
+    readonly label?: string;
+    readonly required?: boolean;
+}
+export interface ModeLoweringModeFacts {
+    readonly mode: OutputMode;
+    readonly facts: readonly ModeLoweringFact[];
+}
+export type ModeLoweringSeverity = 'warning' | 'error';
+export type ModeLoweringIssueKind = 'missing-required-fact' | 'mismatched-fact-value' | 'duplicate-fact' | 'custom-assertion-failed';
+export interface ModeLoweringIssue {
+    readonly kind: ModeLoweringIssueKind;
+    readonly severity: ModeLoweringSeverity;
+    readonly mode?: OutputMode;
+    readonly baselineMode?: OutputMode;
+    readonly factKind?: ModeLoweringFactKind;
+    readonly key?: string;
+    readonly expected?: ModeLoweringFactValue;
+    readonly actual?: ModeLoweringFactValue;
+    readonly message: string;
+}
+export interface ModeLoweringAssertionResult {
+    readonly passed: boolean;
+    readonly message: string;
+    readonly mode?: OutputMode;
+    readonly key?: string;
+    readonly severity?: ModeLoweringSeverity;
+}
+export interface ModeLoweringOptions {
+    readonly baselineMode?: OutputMode;
+    readonly modes: readonly ModeLoweringModeFacts[];
+    readonly assertions?: readonly ModeLoweringAssertionResult[];
+}
+export interface ModeLoweringReport {
+    readonly baselineMode: OutputMode;
+    readonly checkedModes: readonly OutputMode[];
+    readonly issues: readonly ModeLoweringIssue[];
+    readonly passed: boolean;
+}
+export declare function lintModeLowering(options: ModeLoweringOptions): ModeLoweringReport;
+export declare function modeLoweringReportText(report: ModeLoweringReport): string;
+//# sourceMappingURL=mode-lowering.d.ts.map

package/dist/core/mode-lowering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-lowering.d.ts","sourceRoot":"","sources":["../../src/core/mode-lowering.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,MAAM,GACN,OAAO,GACP,OAAO,GACP,OAAO,GACP,QAAQ,CAAC;AAEb,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC7C;AAED,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,OAAO,CAAC;AAEvD,MAAM,MAAM,qBAAqB,GAC7B,uBAAuB,GACvB,uBAAuB,GACvB,gBAAgB,GAChB,yBAAyB,CAAC;AAE9B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CAC1C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,2BAA2B,EAAE,CAAC;CAC9D;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,SAAS,UAAU,EAAE,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAQD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,CAgDjF;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAiBzE"}

package/dist/core/mode-lowering.js

@@ -0,0 +1,176 @@
+const DEFAULT_BASELINE_MODE = 'interactive';
+const MODE_ORDER = ['interactive', 'static', 'pipe', 'accessible'];
+const FACT_SEPARATOR = ':';
+const LIST_SEPARATOR = ',';
+const EMPTY_LABEL = '-';
+export function lintModeLowering(options) {
+    const modes = [...options.modes].sort(compareModeFacts);
+    const modeNames = modes.map((modeFacts) => modeFacts.mode);
+    const modeFactsByMode = new Map();
+    for (const modeFacts of modes) {
+        modeFactsByMode.set(modeFacts.mode, modeFacts);
+    }
+    const baselineMode = resolveBaselineMode(options.baselineMode, modeFactsByMode, modes);
+    const baselineFacts = modeFactsByMode.get(baselineMode)?.facts ?? [];
+    const issues = [];
+    for (const modeFacts of modes) {
+        issues.push(...duplicateFactIssues(modeFacts));
+    }
+    for (const modeFacts of modes) {
+        if (modeFacts.mode === baselineMode) {
+            continue;
+        }
+        issues.push(...compareAgainstBaseline({
+            baselineMode,
+            baselineFacts,
+            modeFacts,
+        }));
+    }
+    for (const assertion of options.assertions ?? []) {
+        if (assertion.passed) {
+            continue;
+        }
+        issues.push({
+            kind: 'custom-assertion-failed',
+            severity: assertion.severity ?? 'error',
+            mode: assertion.mode,
+            key: assertion.key,
+            message: assertion.message,
+        });
+    }
+    return {
+        baselineMode,
+        checkedModes: modeNames,
+        issues,
+        passed: issues.length === 0,
+    };
+}
+export function modeLoweringReportText(report) {
+    const status = report.passed ? 'passed' : 'failed';
+    const checked = report.checkedModes.length === 0
+        ? EMPTY_LABEL
+        : report.checkedModes.join(LIST_SEPARATOR);
+    const lines = [`mode lowering: ${status} baseline=${report.baselineMode} checked=${checked}`];
+    if (report.issues.length === 0) {
+        return lines.join('\n');
+    }
+    lines.push('issues:');
+    for (const issue of report.issues) {
+        lines.push(`- ${issue.severity} ${issue.kind}${issueModeText(issue)}${issueFactText(issue)}: ${issue.message}`);
+    }
+    return lines.join('\n');
+}
+function compareAgainstBaseline(options) {
+    const issues = [];
+    const factsByIdentity = firstFactsByIdentity(options.modeFacts.facts);
+    for (const baselineFact of options.baselineFacts) {
+        if (baselineFact.required === false) {
+            continue;
+        }
+        const candidate = factsByIdentity.get(factIdentity(baselineFact));
+        if (candidate === undefined) {
+            issues.push(missingFactIssue(options.baselineMode, options.modeFacts.mode, baselineFact));
+            continue;
+        }
+        if (factValueDiffers(baselineFact, candidate)) {
+            issues.push(mismatchedFactIssue(options.baselineMode, options.modeFacts.mode, baselineFact, candidate));
+        }
+    }
+    return issues;
+}
+function duplicateFactIssues(modeFacts) {
+    const seenIdentities = new Set();
+    const duplicateIdentities = new Set();
+    const issues = [];
+    for (const fact of modeFacts.facts) {
+        const identity = factIdentity(fact);
+        if (!seenIdentities.has(identity)) {
+            seenIdentities.add(identity);
+            continue;
+        }
+        if (duplicateIdentities.has(identity)) {
+            continue;
+        }
+        duplicateIdentities.add(identity);
+        issues.push({
+            kind: 'duplicate-fact',
+            severity: 'warning',
+            mode: modeFacts.mode,
+            factKind: fact.kind,
+            key: fact.key,
+            message: `${modeFacts.mode} has duplicate ${fact.kind} ${fact.key}`,
+        });
+    }
+    return issues;
+}
+function missingFactIssue(baselineMode, mode, fact) {
+    return {
+        kind: 'missing-required-fact',
+        severity: 'error',
+        mode,
+        baselineMode,
+        factKind: fact.kind,
+        key: fact.key,
+        message: `${mode} is missing required ${fact.kind} ${fact.key} from ${baselineMode}`,
+    };
+}
+function mismatchedFactIssue(baselineMode, mode, expected, actual) {
+    return {
+        kind: 'mismatched-fact-value',
+        severity: 'error',
+        mode,
+        baselineMode,
+        factKind: expected.kind,
+        key: expected.key,
+        expected: expected.value,
+        actual: actual.value,
+        message: `${mode} ${expected.kind} ${expected.key} differs from ${baselineMode}: expected ${formatFactValue(expected.value)}, got ${formatFactValue(actual.value)}`,
+    };
+}
+function firstFactsByIdentity(facts) {
+    const factsByIdentity = new Map();
+    for (const fact of facts) {
+        const identity = factIdentity(fact);
+        if (!factsByIdentity.has(identity)) {
+            factsByIdentity.set(identity, fact);
+        }
+    }
+    return factsByIdentity;
+}
+function factIdentity(fact) {
+    return `${fact.kind}${FACT_SEPARATOR}${fact.key}`;
+}
+function factValueDiffers(expected, actual) {
+    if (expected.value === undefined) {
+        return false;
+    }
+    return expected.value !== actual.value;
+}
+function resolveBaselineMode(requestedMode, modeFactsByMode, modes) {
+    if (requestedMode !== undefined) {
+        return requestedMode;
+    }
+    if (modeFactsByMode.has(DEFAULT_BASELINE_MODE)) {
+        return DEFAULT_BASELINE_MODE;
+    }
+    return modes[0]?.mode ?? DEFAULT_BASELINE_MODE;
+}
+function compareModeFacts(a, b) {
+    return modeRank(a.mode) - modeRank(b.mode);
+}
+function modeRank(mode) {
+    return MODE_ORDER.indexOf(mode);
+}
+function issueModeText(issue) {
+    return issue.mode === undefined ? '' : ` mode=${issue.mode}`;
+}
+function issueFactText(issue) {
+    if (issue.factKind === undefined || issue.key === undefined) {
+        return '';
+    }
+    return ` fact=${issue.factKind}${FACT_SEPARATOR}${issue.key}`;
+}
+function formatFactValue(value) {
+    return value === undefined ? EMPTY_LABEL : String(value);
+}
+//# sourceMappingURL=mode-lowering.js.map

package/dist/core/mode-lowering.js.map

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

package/dist/core/schema-block.d.ts

@@ -0,0 +1,63 @@
+import { type BlockDefinition, type BlockRenderInput } from './block-metadata.js';
+import type { BindingFact, BindingIssueSeverity, DeepReadonly } from './binding.js';
+declare const BLOCK_SCHEMA_ADAPTER_BRAND: unique symbol;
+declare const SCHEMA_BOUND_BLOCK_BRAND: unique symbol;
+export interface BlockSchemaIssue {
+    readonly severity: BindingIssueSeverity;
+    readonly code: string;
+    readonly message: string;
+    readonly path?: string;
+}
+export type BlockSchemaResult<Data> = {
+    readonly ok: true;
+    readonly data: DeepReadonly<Data>;
+} | {
+    readonly ok: false;
+    readonly issues: readonly BlockSchemaIssue[];
+};
+export interface BlockSchemaDescription {
+    readonly requiredFields?: readonly string[];
+    readonly optionalFields?: readonly string[];
+    readonly redactedFields?: readonly string[];
+    readonly facts?: readonly BindingFact[];
+}
+export interface BlockSchemaAdapterInput<Data> {
+    readonly id: string;
+    readonly parse: (input: unknown) => BlockSchemaResult<Data>;
+    readonly describe?: () => BlockSchemaDescription;
+}
+export interface BlockSchemaAdapter<Data = unknown> {
+    readonly [BLOCK_SCHEMA_ADAPTER_BRAND]: true;
+    readonly id: string;
+    readonly parse: (input: unknown) => BlockSchemaResult<Data>;
+    readonly describe?: () => BlockSchemaDescription;
+}
+export type SchemaBlockBindOutput<Config = unknown> = BlockRenderInput<Config> | {
+    readonly input: BlockRenderInput<Config>;
+    readonly facts?: readonly BindingFact[];
+};
+export interface SchemaBoundBlockDefinitionInput<Data = unknown, Config = unknown, Output = unknown> {
+    readonly block: BlockDefinition<Config, Output>;
+    readonly schema: BlockSchemaAdapter<Data>;
+    readonly bind: (data: DeepReadonly<Data>) => SchemaBlockBindOutput<Config>;
+}
+export interface SchemaBoundBlockDefinition<Data = unknown, Config = unknown, Output = unknown> extends SchemaBoundBlockDefinitionInput<Data, Config, Output> {
+    readonly [SCHEMA_BOUND_BLOCK_BRAND]: true;
+}
+export type SchemaBlockBindResult<Config = unknown> = {
+    readonly ok: true;
+    readonly input: DeepReadonly<BlockRenderInput<Config>>;
+    readonly facts: readonly BindingFact[];
+} | {
+    readonly ok: false;
+    readonly issues: readonly BlockSchemaIssue[];
+    readonly facts: readonly BindingFact[];
+};
+export declare function defineBlockSchemaAdapter<Data>(input: BlockSchemaAdapterInput<Data>): BlockSchemaAdapter<Data>;
+export declare function isBlockSchemaAdapter(value: unknown): value is BlockSchemaAdapter;
+export declare function parseBlockSchema<Data>(schema: BlockSchemaAdapter<Data>, input: unknown): BlockSchemaResult<Data>;
+export declare function defineSchemaBlock<Data = unknown, Config = unknown, Output = unknown>(input: SchemaBoundBlockDefinitionInput<Data, Config, Output>): SchemaBoundBlockDefinition<Data, Config, Output>;
+export declare function isSchemaBoundBlockDefinition(value: unknown): value is SchemaBoundBlockDefinition;
+export declare function bindSchemaBlockInput<Data = unknown, Config = unknown, Output = unknown>(block: SchemaBoundBlockDefinition<Data, Config, Output>, input: unknown): SchemaBlockBindResult<Config>;
+export {};
+//# sourceMappingURL=schema-block.d.ts.map