@flyingrobots/bijou 4.4.1 → 7.0.0

package/dist/core/layout/envelope.d.ts

@@ -0,0 +1,174 @@
+export type LayoutBound = number | 'unbounded';
+export type LayoutDirection = 'ltr' | 'rtl' | 'auto';
+export type LogicalAxis = 'inline' | 'block';
+export type LogicalAlign = 'start' | 'center' | 'end' | 'stretch';
+export type LayoutFitPolicy = 'fixed' | 'shrink' | 'grow' | 'truncate' | 'wrap' | 'overflow' | 'clip' | 'priority';
+export interface LayoutConstraints {
+    readonly minInline: number;
+    readonly maxInline: LayoutBound;
+    readonly minBlock: number;
+    readonly maxBlock: LayoutBound;
+}
+export interface LayoutConstraintsInput {
+    readonly minInline?: number;
+    readonly maxInline?: LayoutBound;
+    readonly minBlock?: number;
+    readonly maxBlock?: LayoutBound;
+}
+export interface LayoutPreference {
+    readonly minInline: number;
+    readonly preferredInline: number;
+    readonly maxInline: LayoutBound;
+    readonly minBlock: number;
+    readonly preferredBlock: number;
+    readonly maxBlock: LayoutBound;
+}
+export interface LayoutPreferenceInput {
+    readonly minInline?: number;
+    readonly preferredInline?: number;
+    readonly maxInline?: LayoutBound;
+    readonly minBlock?: number;
+    readonly preferredBlock?: number;
+    readonly maxBlock?: LayoutBound;
+}
+export interface AssignedLayoutRect {
+    readonly inlineStart: number;
+    readonly blockStart: number;
+    readonly inlineSize: number;
+    readonly blockSize: number;
+}
+export interface AssignedLayoutRectInput {
+    readonly inlineStart?: number;
+    readonly blockStart?: number;
+    readonly inlineSize?: number;
+    readonly blockSize?: number;
+}
+export interface LayoutEnvelope {
+    readonly id: string;
+    readonly role: string;
+    readonly direction: LayoutDirection;
+    readonly constraints: LayoutConstraints;
+    readonly preference: LayoutPreference;
+    readonly fit?: LayoutFitPolicy;
+    readonly assigned?: AssignedLayoutRect;
+    readonly reason?: string;
+}
+export interface ResolvedLayoutEnvelope extends LayoutEnvelope {
+    readonly assigned: AssignedLayoutRect;
+    readonly reason: string;
+}
+export interface LayoutEnvelopeInput {
+    readonly id: string;
+    readonly role: string;
+    readonly direction?: LayoutDirection;
+    readonly constraints: LayoutConstraints;
+    readonly preference: LayoutPreference;
+    readonly fit?: LayoutFitPolicy;
+}
+export interface LayoutFact {
+    readonly kind: string;
+    readonly key: string;
+    readonly value: string | number | boolean;
+}
+export interface ContentExtent {
+    readonly source: 'surface' | 'buffer' | 'text';
+    readonly inlineSize: number;
+    readonly blockSize: number;
+    readonly baseline?: number;
+    readonly facts: readonly LayoutFact[];
+}
+export interface ContentExtentInput {
+    readonly width?: number;
+    readonly height?: number;
+    readonly inlineSize?: number;
+    readonly blockSize?: number;
+    readonly baseline?: number;
+    readonly facts?: readonly LayoutFact[];
+}
+export interface TextMeasurementInput {
+    readonly text: string;
+    readonly availableInline: number;
+    readonly direction: LayoutDirection;
+    readonly wrap: 'none' | 'word';
+}
+export type TextMeasurementAdapter = (input: TextMeasurementInput) => Omit<ContentExtent, 'source'>;
+export interface MeasureTextContentInput {
+    readonly text: string;
+    readonly availableInline: number;
+    readonly direction?: LayoutDirection;
+    readonly wrap?: 'none' | 'word';
+    readonly adapter: TextMeasurementAdapter;
+}
+export type StackTrack = {
+    readonly kind: 'fixed';
+    readonly size: number;
+} | {
+    readonly kind: 'flex';
+    readonly weight?: number;
+};
+export interface StackLayoutChildInput {
+    readonly envelope: LayoutEnvelope;
+    readonly track: StackTrack;
+}
+export interface StackLayoutInput {
+    readonly id: string;
+    readonly role: string;
+    readonly axis: LogicalAxis;
+    readonly direction?: LayoutDirection;
+    readonly rect: AssignedLayoutRectInput;
+    readonly gap?: number;
+    readonly children: readonly StackLayoutChildInput[];
+}
+export interface StackLayoutResult {
+    readonly id: string;
+    readonly role: string;
+    readonly axis: LogicalAxis;
+    readonly direction: LayoutDirection;
+    readonly assigned: AssignedLayoutRect;
+    readonly roundingPolicy: 'largest-remainder-source-order';
+    readonly children: readonly ResolvedLayoutEnvelope[];
+}
+export interface PlaceInRectInput {
+    readonly envelope: LayoutEnvelope;
+    readonly direction?: LayoutDirection;
+    readonly parent: AssignedLayoutRectInput;
+    readonly size: {
+        readonly inlineSize: number;
+        readonly blockSize: number;
+    };
+    readonly inlineAlign: LogicalAlign;
+    readonly blockAlign: LogicalAlign;
+}
+export interface LayoutRenderInput {
+    readonly envelope: ResolvedLayoutEnvelope;
+    readonly assigned: AssignedLayoutRect;
+}
+export interface LayoutRenderResult<Output> {
+    readonly envelope: ResolvedLayoutEnvelope;
+    readonly assigned: AssignedLayoutRect;
+    readonly output: Output;
+}
+export declare const RE035_LAYOUT_SCOPE: Readonly<{
+    design: "RE-035";
+    status: "landed";
+    included: readonly string[];
+    deferred: readonly string[];
+}>;
+export declare function layoutConstraints(input?: LayoutConstraintsInput): LayoutConstraints;
+export declare function layoutPreference(input?: LayoutPreferenceInput): LayoutPreference;
+export declare function assignedLayoutRect(input: AssignedLayoutRectInput): AssignedLayoutRect;
+export declare function defineLayoutEnvelope(input: LayoutEnvelopeInput): LayoutEnvelope;
+export declare function assignLayoutChild(envelope: LayoutEnvelope, assigned: AssignedLayoutRectInput, reason: string): ResolvedLayoutEnvelope;
+export declare function isResolvedLayoutEnvelope(envelope: LayoutEnvelope): envelope is ResolvedLayoutEnvelope;
+export declare function renderWithResolvedLayout<Output>(envelope: LayoutEnvelope, renderer: (input: LayoutRenderInput) => Output): LayoutRenderResult<Output>;
+export declare function contentExtentFromSurface(surface: {
+    readonly width: number;
+    readonly height: number;
+}, facts?: readonly LayoutFact[]): ContentExtent;
+export declare function contentExtentFromBuffer(input: ContentExtentInput): ContentExtent;
+export declare function measureTextContent(input: MeasureTextContentInput): ContentExtent;
+export declare function resolveStackLayout(input: StackLayoutInput): StackLayoutResult;
+export declare function placeInRect(input: PlaceInRectInput): ResolvedLayoutEnvelope;
+export declare function layoutExplanationFacts(envelope: ResolvedLayoutEnvelope): readonly LayoutFact[];
+export declare function layoutExplanationText(envelope: ResolvedLayoutEnvelope): string;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/core/layout/envelope.d.ts.map

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

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":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAmLvD,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;QACtB,iBAAiB;QACjB,wBAAwB;QACxB,OAAO;QACP,OAAO;QACP,0BAA0B;QAC1B,wBAAwB;KACzB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;QACtB,yCAAyC;QACzC,8DAA8D;QAC9D,+DAA+D;QAC/D,mEAAmE;QACnE,oCAAoC;QACpC,uBAAuB;KACxB,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,UAAU,iBAAiB,CAAC,QAAgC,EAAE;IAClE,MAAM,SAAS,GAAG,sBAAsB,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,sBAAsB,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS;QACT,SAAS,EAAE,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC;QACrD,QAAQ;QACR,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC;KACnD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAA+B,EAAE;IAChE,MAAM,SAAS,GAAG,sBAAsB,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,sBAAsB,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAE1D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS;QACT,eAAe,EAAE,kBAAkB,CAAC,KAAK,CAAC,eAAe,EAAE,SAAS,EAAE,SAAS,CAAC;QAChF,SAAS;QACT,QAAQ;QACR,cAAc,EAAE,kBAAkB,CAAC,KAAK,CAAC,cAAc,EAAE,QAAQ,EAAE,QAAQ,CAAC;QAC5E,QAAQ;KACT,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAA8B;IAC/D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,WAAW,EAAE,sBAAsB,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QACzD,UAAU,EAAE,sBAAsB,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QACvD,UAAU,EAAE,sBAAsB,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QACvD,SAAS,EAAE,sBAAsB,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;KACtD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAA0B;IAC7D,MAAM,EAAE,GAAG,qBAAqB,CAAC,KAAK,CAAC,EAAE,EAAE,iCAAiC,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,qBAAqB,CAAC,KAAK,CAAC,IAAI,EAAE,mCAAmC,CAAC,CAAC;IACpF,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAmB;QAC/B,EAAE;QACF,IAAI;QACJ,SAAS;QACT,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;KACvD,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,QAAwB,EACxB,QAAiC,EACjC,MAAc;IAEd,MAAM,QAAQ,GAA2B;QACvC,GAAG,QAAQ;QACX,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,CAAC;QACtC,MAAM,EAAE,qBAAqB,CAAC,MAAM,EAAE,uCAAuC,CAAC;KAC/E,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAwB;IAC/D,OAAO,OAAO,QAAQ,CAAC,QAAQ,KAAK,QAAQ;WACvC,QAAQ,CAAC,QAAQ,KAAK,IAAI;WAC1B,OAAO,QAAQ,CAAC,MAAM,KAAK,QAAQ;WACnC,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,QAAwB,EACxB,QAA8C;IAE9C,IAAI,CAAC,wBAAwB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,oCAAoC,QAAQ,CAAC,EAAE,uCAAuC,CAAC,CAAC;IAC1G,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,QAAQ;QACR,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,OAA4D,EAC5D,QAA+B,EAAE;IAEjC,OAAO,aAAa,CAAC,SAAS,EAAE;QAC9B,UAAU,EAAE,OAAO,CAAC,KAAK;QACzB,SAAS,EAAE,OAAO,CAAC,MAAM;QACzB,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAyB;IAC/D,OAAO,aAAa,CAAC,QAAQ,EAAE;QAC7B,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC;QAChD,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAC/C,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;KACzB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAA8B;IAC/D,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC;QAC7B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,eAAe,EAAE,sBAAsB,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC;QACjE,SAAS,EAAE,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC;QAC9C,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,MAAM;KAC3B,CAAC,CAAC;IACH,OAAO,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAuB;IACxD,MAAM,QAAQ,GAAG,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,sBAAsB,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;IAC9E,MAAM,SAAS,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;IAC/E,MAAM,QAAQ,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,sBAAsB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC1D,MAAM,gBAAgB,GAA6B,EAAE,CAAC;IACtD,IAAI,MAAM,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;IAE5E,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAI,KAAK,QAAQ;YAC5B,CAAC,CAAC;gBACE,WAAW,EAAE,MAAM;gBACnB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,UAAU,EAAE,IAAI;gBAChB,SAAS,EAAE,SAAS;aACrB;YACH,CAAC,CAAC;gBACE,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,UAAU,EAAE,MAAM;gBAClB,UAAU,EAAE,SAAS;gBACrB,SAAS,EAAE,IAAI;aAChB,CAAC;QACN,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO;YACzC,CAAC,CAAC,SAAS,IAAI,gBAAgB,IAAI,QAAQ;YAC3C,CAAC,CAAC,SAAS,IAAI,eAAe,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,6CAA6C,CAAC;QACtG,gBAAgB,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QACvE,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,qBAAqB,CAAC,KAAK,CAAC,EAAE,EAAE,8BAA8B,CAAC;QACnE,IAAI,EAAE,qBAAqB,CAAC,KAAK,CAAC,IAAI,EAAE,gCAAgC,CAAC;QACzE,IAAI;QACJ,SAAS;QACT,QAAQ;QACR,cAAc,EAAE,gCAAyC;QACzD,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClF,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACtC,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IACpC,MAAM,UAAU,GAAG,WAAW,KAAK,SAAS;QAC1C,CAAC,CAAC,MAAM,CAAC,UAAU;QACnB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,SAAS,GAAG,UAAU,KAAK,SAAS;QACxC,CAAC,CAAC,MAAM,CAAC,SAAS;QAClB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,sBAAsB,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;IAChF,MAAM,YAAY,GAAG,mBAAmB,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAChG,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAEhF,OAAO,iBAAiB,CACtB,KAAK,CAAC,QAAQ,EACd;QACE,WAAW,EAAE,MAAM,CAAC,WAAW,GAAG,YAAY;QAC9C,UAAU,EAAE,MAAM,CAAC,UAAU,GAAG,WAAW;QAC3C,UAAU;QACV,SAAS;KACV,EACD,SAAS,SAAS,WAAW,WAAW,UAAU,UAAU,EAAE,CAC/D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAgC;IACrE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC;QAC3B,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,SAAS,CAAC;QACrC,IAAI,CAAC,oBAAoB,EAAE,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACvG,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACpG,IAAI,CAAC,mBAAmB,EAAE,gBAAgB,CACxC,QAAQ,CAAC,UAAU,CAAC,SAAS,EAC7B,QAAQ,CAAC,UAAU,CAAC,eAAe,EACnC,QAAQ,CAAC,UAAU,CAAC,SAAS,CAC9B,CAAC;QACF,IAAI,CAAC,kBAAkB,EAAE,gBAAgB,CACvC,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAC5B,QAAQ,CAAC,UAAU,CAAC,cAAc,EAClC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAC7B,CAAC;QACF,IAAI,CAAC,UAAU,EAAE;YACf,gBAAgB,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE;YAC/C,eAAe,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE;YAC7C,eAAe,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE;YAC7C,cAAc,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE;SAC5C,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC;KAChC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAgC;IACpE,MAAM,KAAK,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO;QACL,QAAQ,QAAQ,CAAC,EAAE,EAAE;QACrB,GAAG,KAAK;aACL,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC;aACxC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;KAC9C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,MAA+B,EAAE,KAAoC;IAC1F,MAAM,MAAM,GAAkB;QAC5B,MAAM;QACN,UAAU,EAAE,sBAAsB,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QACvD,SAAS,EAAE,sBAAsB,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QACrD,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,sBAAsB,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC;QAChG,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;KACtC,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,sBAAsB,CAC7B,QAA0C,EAC1C,SAAiB;IAEjB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAS,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAE,CAAC,KAAK,CAAC;QACrC,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,sBAAsB,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACnD,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YACpB,KAAK,IAAI,IAAI,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,SAAS,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;QACtB,IAAI,SAAS,GAAG,SAAS,CAAC;QAC1B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;YACrD,IAAI,QAAQ,CAAC,KAAK,CAAE,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO;gBAAE,SAAS;YACtD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;YACpD,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YACpB,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC,CAAC;IACjD,IAAI,SAAS,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAEnD,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,MAAM,gBAAgB,GAAkE,EAAE,CAAC;IAC3F,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAE,CAAC,KAAK,CAAC;QACrC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,SAAS;QACpC,MAAM,GAAG,GAAG,CAAC,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC;QACzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;QACrB,QAAQ,IAAI,KAAK,CAAC;QAClB,gBAAgB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACpC,gBAAgB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IACrG,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;QACrC,IAAI,QAAQ,IAAI,CAAC;YAAE,MAAM;QACzB,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACnD,QAAQ,IAAI,CAAC,CAAC;IAChB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,KAAiB;IACpC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACtD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,mBAAmB,CAC1B,UAAkB,EAClB,SAAiB,EACjB,KAAmB,EACnB,SAA0B;IAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,CAAC;IACtD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IAClC,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IACzD,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QACxB,OAAO,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3C,CAAC;AAED,SAAS,kBAAkB,CAAC,UAAkB,EAAE,SAAiB,EAAE,KAAmB;IACpF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,CAAC;IACtD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,CAAC,CAAC;IACvD,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IACzD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,cAAc,CAAC,KAA8B,EAAE,GAAW;IACjE,IAAI,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IACrE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,sBAAsB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAyB,EAAE,GAAW,EAAE,GAAgB;IAClF,MAAM,SAAS,GAAG,sBAAsB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACrD,IAAI,GAAG,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACzD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,kBAAkB,CAAC,SAAsC;IAChE,OAAO,SAAS,IAAI,KAAK,CAAC;AAC5B,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa,EAAE,OAAe;IAC3D,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IACtD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,WAAW,CAAC,KAA4B;IAC/C,OAAO,MAAM,CAAC,MAAM,CAClB,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;QAChC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC,CACJ,CAAC;AACJ,CAAC;AAED,SAAS,IAAI,CAAC,GAAW,EAAE,KAA0B;IACnD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,WAAW,CAAC,GAAW,EAAE,GAAgB;IAChD,OAAO,GAAG,GAAG,KAAK,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;AACvC,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW,EAAE,SAAiB,EAAE,GAAgB;IACxE,OAAO,OAAO,GAAG,cAAc,SAAS,QAAQ,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;AACrE,CAAC;AAED,SAAS,WAAW,CAAC,KAAkB;IACrC,OAAO,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC"}

package/dist/core/layout/geometry.d.ts

@@ -0,0 +1,39 @@
+import type { LayoutRect } from '../../ports/surface.js';
+export type GridTrack = number | `${number}fr`;
+export type SplitLayoutDirection = 'row' | 'column';
+export interface SplitPaneRectOptions {
+    readonly direction?: SplitLayoutDirection;
+    readonly width: number;
+    readonly height: number;
+    readonly ratio: number;
+    readonly minA?: number;
+    readonly minB?: number;
+    readonly dividerSize?: number;
+}
+export interface SplitPaneRects {
+    readonly paneA: LayoutRect;
+    readonly paneB: LayoutRect;
+    readonly divider: LayoutRect;
+}
+export interface SplitAxisOptions {
+    readonly available: number;
+    readonly ratio: number;
+    readonly minA?: number;
+    readonly minB?: number;
+}
+export interface SplitAxisSizes {
+    readonly paneA: number;
+    readonly paneB: number;
+}
+export interface GridRectOptions {
+    readonly width: number;
+    readonly height: number;
+    readonly columns: readonly GridTrack[];
+    readonly rows: readonly GridTrack[];
+    readonly areas: readonly string[];
+    readonly gap?: number;
+}
+export declare function solveSplitPaneRects(options: SplitPaneRectOptions): SplitPaneRects;
+export declare function solveSplitAxisSizes(options: SplitAxisOptions): SplitAxisSizes;
+export declare function solveGridRects(options: GridRectOptions): ReadonlyMap<string, LayoutRect>;
+//# sourceMappingURL=geometry.d.ts.map

package/dist/core/layout/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../../src/core/layout/geometry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC;AAC/C,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,cAAc,CAiCjF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,CAM7E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CA0ExF"}