@flyingrobots/bijou 4.4.1 → 7.0.0

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

@@ -0,0 +1,113 @@
+import type { OutputMode } from './detect/tty.js';
+import type { ModeLoweringFact } from './mode-lowering.js';
+import { type CommandIntent, type ViewDataContract } from './binding.js';
+declare const BLOCK_DEFINITION_BRAND: unique symbol;
+export type BlockScale = 'app' | 'section' | 'panel' | 'control' | 'inline' | 'item' | 'data' | 'diagnostic' | 'overlay' | 'workspace';
+export type BlockConfigOptionKind = 'boolean' | 'enum' | 'number' | 'string' | 'adapter';
+export interface BlockMetadataDocs {
+    readonly summary: string;
+    readonly useWhen?: readonly string[];
+    readonly avoidWhen?: readonly string[];
+    readonly relatedDocs?: readonly string[];
+}
+export interface BlockSlot {
+    readonly id: string;
+    readonly label?: string;
+    readonly required?: boolean;
+    readonly description?: string;
+}
+export interface BlockVariantMetadata {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: string;
+    readonly requiredSlots?: readonly string[];
+    readonly optionalSlots?: readonly string[];
+    readonly facts?: readonly ModeLoweringFact[];
+}
+export interface BlockConfigOption {
+    readonly id: string;
+    readonly label?: string;
+    readonly kind: BlockConfigOptionKind;
+    readonly required?: boolean;
+    readonly description?: string;
+    readonly values?: readonly string[];
+}
+export interface BlockExample {
+    readonly id: string;
+    readonly label: string;
+    readonly path?: string;
+    readonly command?: string;
+}
+export interface BlockMetadata {
+    readonly packageName: string;
+    readonly blockName: string;
+    readonly family: string;
+    readonly scale: BlockScale;
+    readonly modes: readonly OutputMode[];
+    readonly docs: BlockMetadataDocs;
+    readonly sourcePath?: string;
+    readonly slots: readonly BlockSlot[];
+    readonly variants?: readonly BlockVariantMetadata[];
+    readonly configOptions?: readonly BlockConfigOption[];
+    readonly composedComponents?: readonly string[];
+    readonly semanticFacts?: readonly ModeLoweringFact[];
+    readonly storyIds?: readonly string[];
+    readonly examples?: readonly BlockExample[];
+    readonly tags?: readonly string[];
+}
+export interface BlockRenderInput<Config = unknown> {
+    readonly config?: Config;
+    readonly slots?: Readonly<Record<string, unknown>>;
+    readonly mode?: OutputMode;
+}
+export interface BlockRenderResult<Output = unknown> {
+    readonly output: Output;
+    readonly facts?: readonly ModeLoweringFact[];
+}
+export interface BlockDefinitionInput<Config = unknown, Output = unknown> {
+    readonly metadata: BlockMetadata;
+    readonly data?: ViewDataContract;
+    readonly commands?: readonly CommandIntent[];
+    readonly render: (input: BlockRenderInput<Config>) => BlockRenderResult<Output>;
+}
+export interface BlockDefinition<Config = unknown, Output = unknown> extends BlockDefinitionInput<Config, Output> {
+    readonly [BLOCK_DEFINITION_BRAND]: true;
+}
+export interface BlockPackageManifest {
+    readonly packageName: string;
+    readonly version: string;
+    readonly bijouPeerRange: string;
+    readonly blocks: readonly string[];
+    readonly docs?: readonly string[];
+    readonly tags?: readonly string[];
+}
+export type BlockMetadataIssueKind = 'missing-required-field' | 'empty-list' | 'duplicate-id' | 'unknown-reference' | 'invalid-value';
+export type BlockMetadataSeverity = 'error' | 'warning';
+export interface BlockMetadataIssue {
+    readonly kind: BlockMetadataIssueKind;
+    readonly severity: BlockMetadataSeverity;
+    readonly path: string;
+    readonly message: string;
+}
+export interface BlockMetadataReport {
+    readonly packageName: string;
+    readonly blockName: string;
+    readonly issues: readonly BlockMetadataIssue[];
+    readonly passed: boolean;
+}
+export interface BlockPackageManifestReport {
+    readonly packageName: string;
+    readonly issues: readonly BlockMetadataIssue[];
+    readonly passed: boolean;
+}
+export declare function defineBlock<Config = unknown, Output = unknown>(definition: BlockDefinitionInput<Config, Output>): BlockDefinition<Config, Output>;
+export declare function isBlockDefinition(value: unknown): value is BlockDefinition;
+export declare function defineBlockPackage(manifest: BlockPackageManifest): BlockPackageManifest;
+export declare function validateBlockMetadata(metadata: BlockMetadata): BlockMetadataReport;
+export declare function validateBlockPackageManifest(manifest: BlockPackageManifest): BlockPackageManifestReport;
+export declare function blockMetadataSummary(metadata: BlockMetadata): string;
+export declare function blockPackageManifestSummary(manifest: BlockPackageManifest): string;
+export declare function blockMetadataReportText(report: BlockMetadataReport): string;
+export declare function blockPackageManifestReportText(report: BlockPackageManifestReport): string;
+export {};
+//# sourceMappingURL=block-metadata.d.ts.map

package/dist/core/block-metadata.d.ts.map

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

package/dist/core/block-metadata.js

@@ -0,0 +1,376 @@
+import { isCommandIntent, isViewDataContract, } from './binding.js';
+const BLOCK_DEFINITION_BRAND = Symbol('BlockDefinition');
+const CONFIG_OPTION_KINDS = [
+    'boolean',
+    'enum',
+    'number',
+    'string',
+    'adapter',
+];
+const BLOCK_SCALES = [
+    'app',
+    'section',
+    'panel',
+    'control',
+    'inline',
+    'item',
+    'data',
+    'diagnostic',
+    'overlay',
+    'workspace',
+];
+const OUTPUT_MODES = [
+    'interactive',
+    'static',
+    'pipe',
+    'accessible',
+];
+const LIST_SEPARATOR = ',';
+const EMPTY_LABEL = '-';
+export function defineBlock(definition) {
+    const report = validateBlockMetadata(definition.metadata);
+    const hasError = report.issues.some((issue) => issue.severity === 'error');
+    if (hasError) {
+        throw new Error(blockMetadataReportText(report));
+    }
+    if (definition.data !== undefined && !isViewDataContract(definition.data)) {
+        throw new Error('block definition: data must be created by defineViewData()');
+    }
+    const commands = definition.commands ?? [];
+    commands.forEach((command, index) => {
+        if (!isCommandIntent(command)) {
+            throw new Error(`block definition: command at index ${index} must be created by commandIntent()`);
+        }
+    });
+    const block = {
+        ...definition,
+        ...(definition.commands === undefined ? {} : { commands: Object.freeze([...commands]) }),
+    };
+    Object.defineProperty(block, BLOCK_DEFINITION_BRAND, { value: true });
+    return Object.freeze(block);
+}
+export function isBlockDefinition(value) {
+    return Boolean(value
+        && typeof value === 'object'
+        && value[BLOCK_DEFINITION_BRAND] === true);
+}
+export function defineBlockPackage(manifest) {
+    const report = validateBlockPackageManifest(manifest);
+    const hasError = report.issues.some((issue) => issue.severity === 'error');
+    if (hasError) {
+        throw new Error(blockPackageManifestReportText(report));
+    }
+    return manifest;
+}
+export function validateBlockMetadata(metadata) {
+    const issues = [];
+    const slots = metadata.slots ?? [];
+    const variants = metadata.variants ?? [];
+    const configOptions = metadata.configOptions ?? [];
+    const examples = metadata.examples ?? [];
+    pushRequiredTextIssue(issues, 'packageName', metadata.packageName);
+    pushRequiredTextIssue(issues, 'blockName', metadata.blockName);
+    pushRequiredTextIssue(issues, 'family', metadata.family);
+    pushRequiredTextIssue(issues, 'docs.summary', metadata.docs?.summary ?? '');
+    pushScaleIssue(issues, metadata.scale);
+    pushModesIssues(issues, metadata.modes ?? []);
+    pushSlotsIssues(issues, slots);
+    pushVariantIssues(issues, variants, slots);
+    pushConfigOptionIssues(issues, configOptions);
+    pushExampleIssues(issues, examples);
+    pushDuplicateStringIssues(issues, metadata.composedComponents ?? [], {
+        label: 'composed component',
+        pathPrefix: 'composedComponents',
+    });
+    pushDuplicateStringIssues(issues, metadata.storyIds ?? [], {
+        label: 'story id',
+        pathPrefix: 'storyIds',
+    });
+    pushDuplicateStringIssues(issues, metadata.tags ?? [], {
+        label: 'tag',
+        pathPrefix: 'tags',
+    });
+    return {
+        packageName: metadata.packageName,
+        blockName: metadata.blockName,
+        issues,
+        passed: issues.length === 0,
+    };
+}
+export function validateBlockPackageManifest(manifest) {
+    const issues = [];
+    pushRequiredTextIssue(issues, 'packageName', manifest.packageName);
+    pushRequiredTextIssue(issues, 'version', manifest.version);
+    pushRequiredTextIssue(issues, 'bijouPeerRange', manifest.bijouPeerRange);
+    if (manifest.blocks.length === 0) {
+        issues.push({
+            kind: 'empty-list',
+            severity: 'error',
+            path: 'blocks',
+            message: 'blocks must include at least one block id',
+        });
+    }
+    pushDuplicateStringIssues(issues, manifest.blocks, {
+        label: 'block id',
+        pathPrefix: 'blocks',
+    });
+    pushDuplicateStringIssues(issues, manifest.docs ?? [], {
+        label: 'doc path',
+        pathPrefix: 'docs',
+    });
+    pushDuplicateStringIssues(issues, manifest.tags ?? [], {
+        label: 'tag',
+        pathPrefix: 'tags',
+    });
+    return {
+        packageName: manifest.packageName,
+        issues,
+        passed: issues.length === 0,
+    };
+}
+export function blockMetadataSummary(metadata) {
+    return [
+        `block metadata: ${metadata.packageName}/${metadata.blockName}`,
+        `family=${metadata.family}`,
+        `scale=${metadata.scale}`,
+        `modes=${joinLabels(metadata.modes)}`,
+        `slots=${joinLabels(metadata.slots.map((slot) => slot.id))}`,
+        `requiredSlots=${joinLabels(metadata.slots.filter((slot) => slot.required !== false).map((slot) => slot.id))}`,
+        `variants=${joinLabels((metadata.variants ?? []).map((variant) => variant.id))}`,
+        `config=${joinLabels((metadata.configOptions ?? []).map((option) => option.id))}`,
+        `components=${joinLabels(metadata.composedComponents ?? [])}`,
+        `facts=${joinLabels((metadata.semanticFacts ?? []).map(factLabel))}`,
+        `stories=${joinLabels(metadata.storyIds ?? [])}`,
+        `source=${metadata.sourcePath ?? EMPTY_LABEL}`,
+    ].join('\n');
+}
+export function blockPackageManifestSummary(manifest) {
+    return [
+        `block package: ${manifest.packageName}@${manifest.version}`,
+        `bijouPeerRange=${manifest.bijouPeerRange}`,
+        `blocks=${joinLabels(manifest.blocks)}`,
+        `docs=${joinLabels(manifest.docs ?? [])}`,
+        `tags=${joinLabels(manifest.tags ?? [])}`,
+    ].join('\n');
+}
+export function blockMetadataReportText(report) {
+    const status = report.passed ? 'passed' : 'failed';
+    const block = report.blockName.trim() === '' ? EMPTY_LABEL : report.blockName.trim();
+    const lines = [`block metadata: ${status} block=${block}`];
+    if (report.issues.length === 0) {
+        return lines.join('\n');
+    }
+    lines.push('issues:');
+    for (const issue of report.issues) {
+        lines.push(`- ${issue.severity} ${issue.kind} path=${issue.path}: ${issue.message}`);
+    }
+    return lines.join('\n');
+}
+export function blockPackageManifestReportText(report) {
+    const status = report.passed ? 'passed' : 'failed';
+    const packageName = report.packageName.trim() === '' ? EMPTY_LABEL : report.packageName.trim();
+    const lines = [`block package manifest: ${status} package=${packageName}`];
+    if (report.issues.length === 0) {
+        return lines.join('\n');
+    }
+    lines.push('issues:');
+    for (const issue of report.issues) {
+        lines.push(`- ${issue.severity} ${issue.kind} path=${issue.path}: ${issue.message}`);
+    }
+    return lines.join('\n');
+}
+function pushScaleIssue(issues, scale) {
+    if (typeof scale !== 'string' || scale.trim() === '') {
+        issues.push({
+            kind: 'missing-required-field',
+            severity: 'error',
+            path: 'scale',
+            message: 'scale is required',
+        });
+        return;
+    }
+    if (!BLOCK_SCALES.includes(scale)) {
+        issues.push({
+            kind: 'invalid-value',
+            severity: 'error',
+            path: 'scale',
+            message: `unsupported block scale ${String(scale)}`,
+        });
+    }
+}
+function pushModesIssues(issues, modes) {
+    if (modes.length === 0) {
+        issues.push({
+            kind: 'empty-list',
+            severity: 'error',
+            path: 'modes',
+            message: 'modes must include at least one output mode',
+        });
+        return;
+    }
+    modes.forEach((mode, index) => {
+        if (OUTPUT_MODES.includes(mode)) {
+            return;
+        }
+        issues.push({
+            kind: 'invalid-value',
+            severity: 'error',
+            path: `modes[${index}]`,
+            message: `unsupported output mode ${String(mode)}`,
+        });
+    });
+    pushDuplicateStringIssues(issues, modes, {
+        label: 'mode',
+        pathPrefix: 'modes',
+    });
+}
+function pushSlotsIssues(issues, slots) {
+    if (slots.length === 0) {
+        issues.push({
+            kind: 'empty-list',
+            severity: 'error',
+            path: 'slots',
+            message: 'slots must include at least one slot',
+        });
+        return;
+    }
+    slots.forEach((slot, index) => {
+        pushRequiredTextIssue(issues, `slots[${index}].id`, slot.id);
+    });
+    pushDuplicateStringIssues(issues, slots.map((slot) => slot.id), {
+        label: 'slot id',
+        pathPrefix: 'slots',
+        valuePath: 'id',
+    });
+}
+function pushVariantIssues(issues, variants, slots) {
+    const slotIds = new Set(slots.map((slot) => slot.id).filter((id) => id.trim() !== ''));
+    variants.forEach((variant, index) => {
+        pushRequiredTextIssue(issues, `variants[${index}].id`, variant.id);
+        pushRequiredTextIssue(issues, `variants[${index}].label`, variant.label);
+        pushSlotReferenceIssues(issues, `variants[${index}].requiredSlots`, variant.requiredSlots ?? [], slotIds);
+        pushSlotReferenceIssues(issues, `variants[${index}].optionalSlots`, variant.optionalSlots ?? [], slotIds);
+    });
+    pushDuplicateStringIssues(issues, variants.map((variant) => variant.id), {
+        label: 'variant id',
+        pathPrefix: 'variants',
+        valuePath: 'id',
+    });
+}
+function pushConfigOptionIssues(issues, options) {
+    options.forEach((option, index) => {
+        pushRequiredTextIssue(issues, `configOptions[${index}].id`, option.id);
+        if (!CONFIG_OPTION_KINDS.includes(option.kind)) {
+            issues.push({
+                kind: 'invalid-value',
+                severity: 'error',
+                path: `configOptions[${index}].kind`,
+                message: `unsupported config option kind ${String(option.kind)}`,
+            });
+        }
+        if (option.kind === 'enum' && (option.values ?? []).length === 0) {
+            issues.push({
+                kind: 'empty-list',
+                severity: 'error',
+                path: `configOptions[${index}].values`,
+                message: 'enum config options must include values',
+            });
+        }
+        pushDuplicateStringIssues(issues, option.values ?? [], {
+            label: 'config enum value',
+            pathPrefix: `configOptions[${index}].values`,
+        });
+    });
+    pushDuplicateStringIssues(issues, options.map((option) => option.id), {
+        label: 'config option id',
+        pathPrefix: 'configOptions',
+        valuePath: 'id',
+    });
+}
+function pushExampleIssues(issues, examples) {
+    examples.forEach((example, index) => {
+        pushRequiredTextIssue(issues, `examples[${index}].id`, example.id);
+        pushRequiredTextIssue(issues, `examples[${index}].label`, example.label);
+    });
+    pushDuplicateStringIssues(issues, examples.map((example) => example.id), {
+        label: 'example id',
+        pathPrefix: 'examples',
+        valuePath: 'id',
+    });
+}
+function pushSlotReferenceIssues(issues, pathPrefix, references, slotIds) {
+    references.forEach((reference, index) => {
+        const normalized = reference.trim();
+        if (normalized === '') {
+            issues.push({
+                kind: 'missing-required-field',
+                severity: 'error',
+                path: `${pathPrefix}[${index}]`,
+                message: `${pathPrefix}[${index}] is required`,
+            });
+            return;
+        }
+        if (!slotIds.has(normalized)) {
+            issues.push({
+                kind: 'unknown-reference',
+                severity: 'error',
+                path: `${pathPrefix}[${index}]`,
+                message: `unknown slot reference ${normalized}`,
+            });
+        }
+    });
+    pushDuplicateStringIssues(issues, references, {
+        label: 'slot reference',
+        pathPrefix,
+    });
+}
+function pushDuplicateStringIssues(issues, values, options) {
+    const seenValues = new Set();
+    const reportedValues = new Set();
+    values.forEach((value, index) => {
+        const normalized = value.trim();
+        if (normalized === '') {
+            return;
+        }
+        if (!seenValues.has(normalized)) {
+            seenValues.add(normalized);
+            return;
+        }
+        if (reportedValues.has(normalized)) {
+            return;
+        }
+        reportedValues.add(normalized);
+        issues.push({
+            kind: 'duplicate-id',
+            severity: 'error',
+            path: indexedPath(options.pathPrefix, index, options.valuePath ?? ''),
+            message: `duplicate ${options.label} ${normalized}`,
+        });
+    });
+}
+function pushRequiredTextIssue(issues, path, value) {
+    if (value.trim() !== '') {
+        return;
+    }
+    issues.push({
+        kind: 'missing-required-field',
+        severity: 'error',
+        path,
+        message: `${path} is required`,
+    });
+}
+function factLabel(fact) {
+    return fact.value === undefined
+        ? `${fact.kind}:${fact.key}`
+        : `${fact.kind}:${fact.key}=${String(fact.value)}`;
+}
+function indexedPath(pathPrefix, index, valuePath) {
+    if (valuePath === '') {
+        return `${pathPrefix}[${index}]`;
+    }
+    return `${pathPrefix}[${index}].${valuePath}`;
+}
+function joinLabels(values) {
+    return values.length === 0 ? EMPTY_LABEL : values.join(LIST_SEPARATOR);
+}
+//# sourceMappingURL=block-metadata.js.map

package/dist/core/block-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-metadata.js","sourceRoot":"","sources":["../../src/core/block-metadata.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,eAAe,EACf,kBAAkB,GAGnB,MAAM,cAAc,CAAC;AAEtB,MAAM,sBAAsB,GAAkB,MAAM,CAAC,iBAAiB,CAAC,CAAC;AA2IxE,MAAM,mBAAmB,GAAqC;IAC5D,SAAS;IACT,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,SAAS;CACV,CAAC;AACF,MAAM,YAAY,GAA0B;IAC1C,KAAK;IACL,SAAS;IACT,OAAO;IACP,SAAS;IACT,QAAQ;IACR,MAAM;IACN,MAAM;IACN,YAAY;IACZ,SAAS;IACT,WAAW;CACZ,CAAC;AACF,MAAM,YAAY,GAA0B;IAC1C,aAAa;IACb,QAAQ;IACR,MAAM;IACN,YAAY;CACb,CAAC;AACF,MAAM,cAAc,GAAG,GAAG,CAAC;AAC3B,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,MAAM,UAAU,WAAW,CACzB,UAAgD;IAEhD,MAAM,MAAM,GAAG,qBAAqB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAC3E,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QAClC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,sCAAsC,KAAK,qCAAqC,CAAC,CAAC;QACpG,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG;QACZ,GAAG,UAAU;QACb,GAAG,CAAC,UAAU,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC;IAErC,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,sBAAsB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,OAAO,CACZ,KAAK;WACA,OAAO,KAAK,KAAK,QAAQ;WACxB,KAAqC,CAAC,sBAAsB,CAAC,KAAK,IAAI,CAC7E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAA8B;IAC/D,MAAM,MAAM,GAAG,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAC3E,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAMD,MAAM,UAAU,qBAAqB,CAAC,QAAuB;IAC3D,MAAM,MAAM,GAAyB,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;IACzC,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,IAAI,EAAE,CAAC;IACnD,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;IAEzC,qBAAqB,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IACnE,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC/D,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzD,qBAAqB,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IAC5E,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvC,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC9C,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC/B,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC3C,sBAAsB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC9C,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpC,yBAAyB,CAAC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,IAAI,EAAE,EAAE;QACnE,KAAK,EAAE,oBAAoB;QAC3B,UAAU,EAAE,oBAAoB;KACjC,CAAC,CAAC;IACH,yBAAyB,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,IAAI,EAAE,EAAE;QACzD,KAAK,EAAE,UAAU;QACjB,UAAU,EAAE,UAAU;KACvB,CAAC,CAAC;IACH,yBAAyB,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE;QACrD,KAAK,EAAE,KAAK;QACZ,UAAU,EAAE,MAAM;KACnB,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,MAAM;QACN,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,QAA8B;IAE9B,MAAM,MAAM,GAAyB,EAAE,CAAC;IAExC,qBAAqB,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IACnE,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3D,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACzE,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,2CAA2C;SACrD,CAAC,CAAC;IACL,CAAC;IACD,yBAAyB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE;QACjD,KAAK,EAAE,UAAU;QACjB,UAAU,EAAE,QAAQ;KACrB,CAAC,CAAC;IACH,yBAAyB,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE;QACrD,KAAK,EAAE,UAAU;QACjB,UAAU,EAAE,MAAM;KACnB,CAAC,CAAC;IACH,yBAAyB,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE;QACrD,KAAK,EAAE,KAAK;QACZ,UAAU,EAAE,MAAM;KACnB,CAAC,CAAC;IAEH,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,MAAM;QACN,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAuB;IAC1D,OAAO;QACL,mBAAmB,QAAQ,CAAC,WAAW,IAAI,QAAQ,CAAC,SAAS,EAAE;QAC/D,UAAU,QAAQ,CAAC,MAAM,EAAE;QAC3B,SAAS,QAAQ,CAAC,KAAK,EAAE;QACzB,SAAS,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;QACrC,SAAS,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE;QAC5D,iBAAiB,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE;QAC9G,YAAY,UAAU,CAAC,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE;QAChF,UAAU,UAAU,CAAC,CAAC,QAAQ,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE;QACjF,cAAc,UAAU,CAAC,QAAQ,CAAC,kBAAkB,IAAI,EAAE,CAAC,EAAE;QAC7D,SAAS,UAAU,CAAC,CAAC,QAAQ,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE;QACpE,WAAW,UAAU,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE;QAChD,UAAU,QAAQ,CAAC,UAAU,IAAI,WAAW,EAAE;KAC/C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,QAA8B;IACxE,OAAO;QACL,kBAAkB,QAAQ,CAAC,WAAW,IAAI,QAAQ,CAAC,OAAO,EAAE;QAC5D,kBAAkB,QAAQ,CAAC,cAAc,EAAE;QAC3C,UAAU,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;QACvC,QAAQ,UAAU,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE;QACzC,QAAQ,UAAU,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE;KAC1C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAA2B;IACjE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IACnD,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IACrF,MAAM,KAAK,GAAG,CAAC,mBAAmB,MAAM,UAAU,KAAK,EAAE,CAAC,CAAC;IAE3D,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,MAAkC;IAC/E,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IACnD,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IAC/F,MAAM,KAAK,GAAG,CAAC,2BAA2B,MAAM,YAAY,WAAW,EAAE,CAAC,CAAC;IAE3E,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,cAAc,CAAC,MAA4B,EAAE,KAAiB;IACrE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,wBAAwB;YAC9B,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,mBAAmB;SAC7B,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,eAAe;YACrB,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,2BAA2B,MAAM,CAAC,KAAK,CAAC,EAAE;SACpD,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CACtB,MAA4B,EAC5B,KAA4B;IAE5B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,6CAA6C;SACvD,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC5B,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,OAAO;QACT,CAAC;QAED,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,eAAe;YACrB,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,SAAS,KAAK,GAAG;YACvB,OAAO,EAAE,2BAA2B,MAAM,CAAC,IAAI,CAAC,EAAE;SACnD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,yBAAyB,CAAC,MAAM,EAAE,KAAK,EAAE;QACvC,KAAK,EAAE,MAAM;QACb,UAAU,EAAE,OAAO;KACpB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CACtB,MAA4B,EAC5B,KAA2B;IAE3B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,sCAAsC;SAChD,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC5B,qBAAqB,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IACH,yBAAyB,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QAC9D,KAAK,EAAE,SAAS;QAChB,UAAU,EAAE,OAAO;QACnB,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CACxB,MAA4B,EAC5B,QAAyC,EACzC,KAA2B;IAE3B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACvF,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QAClC,qBAAqB,CAAC,MAAM,EAAE,YAAY,KAAK,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QACnE,qBAAqB,CAAC,MAAM,EAAE,YAAY,KAAK,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACzE,uBAAuB,CAAC,MAAM,EAAE,YAAY,KAAK,iBAAiB,EAAE,OAAO,CAAC,aAAa,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QAC1G,uBAAuB,CAAC,MAAM,EAAE,YAAY,KAAK,iBAAiB,EAAE,OAAO,CAAC,aAAa,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC5G,CAAC,CAAC,CAAC;IACH,yBAAyB,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE;QACvE,KAAK,EAAE,YAAY;QACnB,UAAU,EAAE,UAAU;QACtB,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,sBAAsB,CAC7B,MAA4B,EAC5B,OAAqC;IAErC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAChC,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,KAAK,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,eAAe;gBACrB,QAAQ,EAAE,OAAO;gBACjB,IAAI,EAAE,iBAAiB,KAAK,QAAQ;gBACpC,OAAO,EAAE,kCAAkC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;aACjE,CAAC,CAAC;QACL,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjE,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,YAAY;gBAClB,QAAQ,EAAE,OAAO;gBACjB,IAAI,EAAE,iBAAiB,KAAK,UAAU;gBACtC,OAAO,EAAE,yCAAyC;aACnD,CAAC,CAAC;QACL,CAAC;QACD,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE;YACrD,KAAK,EAAE,mBAAmB;YAC1B,UAAU,EAAE,iBAAiB,KAAK,UAAU;SAC7C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;QACpE,KAAK,EAAE,kBAAkB;QACzB,UAAU,EAAE,eAAe;QAC3B,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CACxB,MAA4B,EAC5B,QAAiC;IAEjC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QAClC,qBAAqB,CAAC,MAAM,EAAE,YAAY,KAAK,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QACnE,qBAAqB,CAAC,MAAM,EAAE,YAAY,KAAK,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IACH,yBAAyB,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE;QACvE,KAAK,EAAE,YAAY;QACnB,UAAU,EAAE,UAAU;QACtB,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,uBAAuB,CAC9B,MAA4B,EAC5B,UAAkB,EAClB,UAA6B,EAC7B,OAA4B;IAE5B,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE;QACtC,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,wBAAwB;gBAC9B,QAAQ,EAAE,OAAO;gBACjB,IAAI,EAAE,GAAG,UAAU,IAAI,KAAK,GAAG;gBAC/B,OAAO,EAAE,GAAG,UAAU,IAAI,KAAK,eAAe;aAC/C,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,mBAAmB;gBACzB,QAAQ,EAAE,OAAO;gBACjB,IAAI,EAAE,GAAG,UAAU,IAAI,KAAK,GAAG;gBAC/B,OAAO,EAAE,0BAA0B,UAAU,EAAE;aAChD,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IACH,yBAAyB,CAAC,MAAM,EAAE,UAAU,EAAE;QAC5C,KAAK,EAAE,gBAAgB;QACvB,UAAU;KACX,CAAC,CAAC;AACL,CAAC;AAQD,SAAS,yBAAyB,CAChC,MAA4B,EAC5B,MAAyB,EACzB,OAA8B;IAE9B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC9B,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAChC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,IAAI,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACnC,OAAO;QACT,CAAC;QAED,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;YACrE,OAAO,EAAE,aAAa,OAAO,CAAC,KAAK,IAAI,UAAU,EAAE;SACpD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAC5B,MAA4B,EAC5B,IAAY,EACZ,KAAa;IAEb,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IAED,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,wBAAwB;QAC9B,QAAQ,EAAE,OAAO;QACjB,IAAI;QACJ,OAAO,EAAE,GAAG,IAAI,cAAc;KAC/B,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAAC,IAAsB;IACvC,OAAO,IAAI,CAAC,KAAK,KAAK,SAAS;QAC7B,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE;QAC5B,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,SAAS,WAAW,CAAC,UAAkB,EAAE,KAAa,EAAE,SAAiB;IACvE,IAAI,SAAS,KAAK,EAAE,EAAE,CAAC;QACrB,OAAO,GAAG,UAAU,IAAI,KAAK,GAAG,CAAC;IACnC,CAAC;IAED,OAAO,GAAG,UAAU,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;AAChD,CAAC;AAED,SAAS,UAAU,CAAC,MAAyB;IAC3C,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AACzE,CAAC"}

package/dist/core/block-tree-render.d.ts

@@ -0,0 +1,17 @@
+import type { OutputMode } from './detect/tty.js';
+import { type BlockDefinition, type BlockRenderInput, type BlockRenderResult } from './block-metadata.js';
+declare const BLOCK_RENDER_NODE_BRAND: unique symbol;
+export interface BlockRenderNode<Config = unknown> {
+    readonly [BLOCK_RENDER_NODE_BRAND]: true;
+    readonly block: BlockDefinition<Config>;
+    readonly input: BlockRenderInput<Config>;
+}
+export interface BlockTreeRenderOptions {
+    readonly mode?: OutputMode;
+    readonly maxDepth?: number;
+}
+export declare function blockRenderNode<Config = unknown>(block: BlockDefinition<Config>, input?: BlockRenderInput<Config>): BlockRenderNode<Config>;
+export declare function isBlockRenderNode(value: unknown): value is BlockRenderNode;
+export declare function renderBlockTree<Config = unknown>(target: BlockDefinition<Config> | BlockRenderNode<Config>, options?: BlockTreeRenderOptions): BlockRenderResult;
+export {};
+//# sourceMappingURL=block-tree-render.d.ts.map

package/dist/core/block-tree-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-tree-render.d.ts","sourceRoot":"","sources":["../../src/core/block-tree-render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAC;AAE7B,QAAA,MAAM,uBAAuB,EAAE,OAAO,MAAkC,CAAC;AAGzE,MAAM,WAAW,eAAe,CAAC,MAAM,GAAG,OAAO;IAC/C,QAAQ,CAAC,CAAC,uBAAuB,CAAC,EAAE,IAAI,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAgBD,wBAAgB,eAAe,CAAC,MAAM,GAAG,OAAO,EAC9C,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,EAC9B,KAAK,GAAE,gBAAgB,CAAC,MAAM,CAAM,GACnC,eAAe,CAAC,MAAM,CAAC,CAYzB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAM1E;AAED,wBAAgB,eAAe,CAAC,MAAM,GAAG,OAAO,EAC9C,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,EACzD,OAAO,GAAE,sBAA2B,GACnC,iBAAiB,CAMnB"}