@flyingrobots/bijou 7.1.0 → 8.0.0-rc.1

package/dist/core/block-metadata.js

@@ -1,376 +1,4 @@
-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);
-}
+export { defineBlock, isBlockDefinition } from './block-metadata.part02.js';
+export { defineBlockPackage, validateBlockMetadata, validateBlockPackageManifest } from './block-metadata.part03.js';
+export { blockMetadataReportText, blockMetadataSummary, blockPackageManifestReportText, blockPackageManifestSummary } from './block-metadata.part04.js';
 //# sourceMappingURL=block-metadata.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"block-metadata.js","sourceRoot":"","sources":["../../src/core/block-metadata.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"block-metadata.js","sourceRoot":"","sources":["../../src/core/block-metadata.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE5E,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AACrH,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC"}

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

@@ -0,0 +1,76 @@
+import type { OutputMode } from './detect/tty.js';
+import type { ModeLoweringFact } from './mode-lowering.js';
+import type { CommandIntent, ViewDataContract } from './binding.js';
+export 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;
+}
+//# sourceMappingURL=block-metadata.part01.d.ts.map

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

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

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

@@ -0,0 +1,2 @@
+export const BLOCK_DEFINITION_BRAND = Symbol('BlockDefinition');
+//# sourceMappingURL=block-metadata.part01.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"block-metadata.part01.js","sourceRoot":"","sources":["../../src/core/block-metadata.part01.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,sBAAsB,GAAkB,MAAM,CAAC,iBAAiB,CAAC,CAAC"}

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

@@ -0,0 +1,37 @@
+import type { OutputMode } from './detect/tty.js';
+import type { BlockConfigOptionKind, BlockDefinition, BlockDefinitionInput, BlockScale } from './block-metadata.part01.js';
+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 const CONFIG_OPTION_KINDS: readonly BlockConfigOptionKind[];
+export declare const BLOCK_SCALES: readonly BlockScale[];
+export declare const OUTPUT_MODES: readonly OutputMode[];
+export declare const LIST_SEPARATOR = ",";
+export declare const EMPTY_LABEL = "-";
+export declare function defineBlock<Config = unknown, Output = unknown>(definition: BlockDefinitionInput<Config, Output>): BlockDefinition<Config, Output>;
+export declare function isBlockDefinition(value: unknown): value is BlockDefinition;
+//# sourceMappingURL=block-metadata.part02.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"block-metadata.part02.d.ts","sourceRoot":"","sources":["../../src/core/block-metadata.part02.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAMlD,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAO3H,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AACD,MAAM,MAAM,sBAAsB,GAC9B,wBAAwB,GACxB,YAAY,GACZ,cAAc,GACd,mBAAmB,GACnB,eAAe,CAAC;AACpB,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,SAAS,CAAC;AACxD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AACD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AACD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AACD,eAAO,MAAM,mBAAmB,EAAE,SAAS,qBAAqB,EAM/D,CAAC;AACF,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAW7C,CAAC;AACF,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAK7C,CAAC;AACF,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,WAAW,MAAM,CAAC;AAC/B,wBAAgB,WAAW,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO,EAC5D,UAAU,EAAE,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/C,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAyBjC;AACD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAM1E"}

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

@@ -0,0 +1,59 @@
+import { isCommandIntent, isViewDataContract } from './binding.js';
+import { BLOCK_DEFINITION_BRAND } from './block-metadata.part01.js';
+import { brand, validateBlockMetadata } from './block-metadata.part03.js';
+import { blockMetadataReportText } from './block-metadata.part04.js';
+export const CONFIG_OPTION_KINDS = [
+    'boolean',
+    'enum',
+    'number',
+    'string',
+    'adapter',
+];
+export const BLOCK_SCALES = [
+    'app',
+    'section',
+    'panel',
+    'control',
+    'inline',
+    'item',
+    'data',
+    'diagnostic',
+    'overlay',
+    'workspace',
+];
+export const OUTPUT_MODES = [
+    'interactive',
+    'static',
+    'pipe',
+    'accessible',
+];
+export const LIST_SEPARATOR = ',';
+export 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 ${String(index)} must be created by commandIntent()`);
+        }
+    });
+    const block = {
+        ...definition,
+        ...(definition.commands === undefined ? {} : { commands: Object.freeze([...commands]) }),
+    };
+    brand(block);
+    return Object.freeze(block);
+}
+export function isBlockDefinition(value) {
+    return Boolean(value
+        && typeof value === 'object'
+        && value[BLOCK_DEFINITION_BRAND] === true);
+}
+//# sourceMappingURL=block-metadata.part02.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"block-metadata.part02.js","sourceRoot":"","sources":["../../src/core/block-metadata.part02.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAIpE,OAAO,EAAE,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAI1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAiCrE,MAAM,CAAC,MAAM,mBAAmB,GAAqC;IACnE,SAAS;IACT,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,SAAS;CACV,CAAC;AACF,MAAM,CAAC,MAAM,YAAY,GAA0B;IACjD,KAAK;IACL,SAAS;IACT,OAAO;IACP,SAAS;IACT,QAAQ;IACR,MAAM;IACN,MAAM;IACN,YAAY;IACZ,SAAS;IACT,WAAW;CACZ,CAAC;AACF,MAAM,CAAC,MAAM,YAAY,GAA0B;IACjD,aAAa;IACb,QAAQ;IACR,MAAM;IACN,YAAY;CACb,CAAC;AACF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAClC,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;AAC/B,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,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC5G,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;KACzF,CAAC;IAEF,KAAK,CAAC,KAAK,CAAC,CAAC;IACb,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AACD,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"}

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

@@ -0,0 +1,11 @@
+import { BLOCK_DEFINITION_BRAND } from './block-metadata.part01.js';
+import type { BlockDefinition, BlockDefinitionInput, BlockMetadata } from './block-metadata.part01.js';
+import type { BlockMetadataReport, BlockPackageManifest, BlockPackageManifestReport } from './block-metadata.part02.js';
+export declare function defineBlockPackage(manifest: BlockPackageManifest): BlockPackageManifest;
+export interface BlockDefinitionBrandCarrier {
+    readonly [BLOCK_DEFINITION_BRAND]?: true;
+}
+export declare function brand<C, O>(b: BlockDefinitionInput<C, O> & BlockDefinitionBrandCarrier): asserts b is BlockDefinition<C, O>;
+export declare function validateBlockMetadata(metadata: BlockMetadata): BlockMetadataReport;
+export declare function validateBlockPackageManifest(manifest: BlockPackageManifest): BlockPackageManifestReport;
+//# sourceMappingURL=block-metadata.part03.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"block-metadata.part03.d.ts","sourceRoot":"","sources":["../../src/core/block-metadata.part03.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEvG,OAAO,KAAK,EAAsB,mBAAmB,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAS5I,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,oBAAoB,CAQvF;AACD,MAAM,WAAW,2BAA2B;IAAG,QAAQ,CAAC,CAAC,sBAAsB,CAAC,CAAC,EAAE,IAAI,CAAC;CAAE;AAC1F,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,2BAA2B,GAAG,OAAO,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAuE;AACnM,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,mBAAmB,CAoClF;AACD,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,oBAAoB,GAC7B,0BAA0B,CAgC5B"}