@x12i/made-easy 0.0.0-stage → 0.1.0

package/dist/contracts/diagnostics.d.ts

@@ -0,0 +1,111 @@
+import { z } from 'zod';
+export type Severity = 'error' | 'warning' | 'info';
+export type ValidationMode = 'draft' | 'release';
+/**
+ * Stable diagnostic codes shared by the SDK, CLI, HTTP API, MCP tools and Studio.
+ * The value is a one-line description used for documentation and editor hints.
+ */
+export declare const DIAGNOSTIC_CODES: {
+    readonly BUNDLE_FILE_MISSING: "A file required by the bundle is missing.";
+    readonly BUNDLE_PATH_UNSAFE: "A path escapes the bundle root, is absolute, or uses a forbidden form.";
+    readonly BUNDLE_LIMIT_EXCEEDED: "The bundle exceeds a configured size, file-count or extraction limit.";
+    readonly YAML_PARSE_ERROR: "A YAML file cannot be parsed.";
+    readonly SCHEMA_INVALID: "A file does not match its versioned schema.";
+    readonly SCHEMA_VERSION_UNSUPPORTED: "The schema major version is not supported by this SDK.";
+    readonly ID_DUPLICATE: "An identifier is used more than once in the same namespace.";
+    readonly REF_UNRESOLVED: "A reference does not resolve to an entry, check, claim, source, result, pause rule or asset.";
+    readonly RECIPE_UNKNOWN: "The pinned recipe ID is not known.";
+    readonly RECIPE_VERSION_UNSUPPORTED: "The pinned recipe version is not available.";
+    readonly THEME_UNSUPPORTED: "The pinned theme ID or version is not available.";
+    readonly SUBJECT_RECIPE_MISMATCH: "The subject type does not match the subject profile of the pinned recipe.";
+    readonly ROLE_MISSING: "A required section role is missing from the track.";
+    readonly ROLE_ORDER: "Required section roles are not in recipe order.";
+    readonly ROLE_DUPLICATE: "A required section role appears more than once.";
+    readonly BLOCK_PARSE_ERROR: "A structured block cannot be parsed as YAML.";
+    readonly BLOCK_UNKNOWN_TYPE: "A structured block uses an unregistered type.";
+    readonly BLOCK_PROPS_INVALID: "A structured block has props that do not match its typed schema.";
+    readonly BLOCK_REQUIRED_MISSING: "The recipe requires a structured block that is not present in the section.";
+    readonly FIELD_REQUIRED_MISSING: "The recipe requires a field that is missing or empty.";
+    readonly CONTENT_TOO_SHORT: "The section has less prose than the preset requires.";
+    readonly PLACEHOLDER_PRESENT: "Explicit placeholder text remains. Allowed in drafts, blocked in release.";
+    readonly PIN_MISSING: "The brief does not pin an operator-reference entry.";
+    readonly PIN_UNRESOLVED: "A pinned operator-reference entry does not exist.";
+    readonly PIN_STALE: "A pinned operator-reference entry changed after it was pinned.";
+    readonly PAUSE_NOT_COVERED: "A brief pause rule is not shown in the ownership section.";
+    readonly CHECK_NOT_COVERED: "An acceptance check is not defined or not used by every worked result.";
+    readonly RESULT_CHECK_MISMATCH: "A worked result is not recorded against the same acceptance checks.";
+    readonly RESULT_VERDICT_INCONSISTENT: "A worked result verdict contradicts its recorded check outcomes.";
+    readonly CLAIM_UNRESOLVED: "A material claim is recorded as unresolved.";
+    readonly CLAIM_NO_EVIDENCE: "A supported claim has no evidence.";
+    readonly SOURCE_SYNTHETIC: "Evidence is synthetic and is labelled as such in outputs.";
+    readonly ASSET_FILE_MISSING: "A declared asset file is missing.";
+    readonly ASSET_DIGEST_MISMATCH: "An asset file does not match its recorded digest.";
+    readonly ASSET_ALT_MISSING: "An asset needs alternative text or an explicit decorative marker.";
+    readonly ASSET_MEDIA_TYPE_MISMATCH: "An asset media type does not match its file extension.";
+    readonly PUBLICATION_PRIVATE_REFERENCE: "Published content references a private source or asset.";
+    readonly EXAMPLE_FIXTURE_MISSING: "An executable example has no fixture files.";
+    readonly EXAMPLE_UNVERIFIED: "An executable example has no verification record.";
+    readonly EXAMPLE_VERIFICATION_STALE: "The verification record does not match the current example.";
+    readonly EXAMPLE_VERIFICATION_FAILED: "The verification record reports a failing example.";
+    readonly SECRET_DETECTED: "The bundle appears to contain a secret or credential.";
+    readonly ANCHOR_UNSTABLE: "A heading has no explicit anchor, so editing it changes its link.";
+    readonly PROFILE_FIELD_MISSING: "The operator reference lacks a field required by the subject profile.";
+    readonly SDK_VERSION_NOT_EXACT: "The SDK version is not an exact version.";
+    readonly SDK_INTEGRITY_MISSING: "The npm integrity metadata is missing.";
+    readonly SDK_EXAMPLE_MISSING: "The SDK profile requires a complete runnable example with an expected result.";
+    readonly PDF_BROWSER_NOT_FOUND: "No Chromium-based browser was found for PDF output.";
+    readonly PDF_RENDER_FAILED: "The PDF renderer failed.";
+    readonly PDF_NETWORK_BLOCKED: "The renderer attempted a network request, which is blocked.";
+    readonly PDF_LAYOUT_OVERFLOW: "A block is too tall to fit on one page.";
+    readonly OUTPUT_EXISTS: "The output directory exists and overwrite was not requested.";
+    readonly OUTPUT_FAILED: "The output could not be delivered.";
+    readonly UNSUPPORTED_FORMAT: "The requested output format is not supported.";
+    readonly REVISION_MISMATCH: "The expected revision does not match the current revision.";
+    readonly DRAFT_ADAPTER_MISSING: "No draft adapter is configured.";
+    readonly DRAFT_PROPOSAL_INVALID: "A draft proposal is malformed or cites sources outside its snapshot.";
+    readonly NPM_RESOLVE_FAILED: "The npm registry lookup failed.";
+    readonly VERIFY_FAILED: "An example verification run failed.";
+};
+export type DiagnosticCode = keyof typeof DIAGNOSTIC_CODES;
+export declare const DiagnosticSchema: z.ZodObject<{
+    code: z.ZodString;
+    severity: z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+        info: "info";
+    }>;
+    path: z.ZodString;
+    message: z.ZodString;
+    line: z.ZodOptional<z.ZodNumber>;
+    column: z.ZodOptional<z.ZodNumber>;
+    blockId: z.ZodOptional<z.ZodString>;
+    pointer: z.ZodOptional<z.ZodString>;
+    hint: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export interface Diagnostic {
+    code: DiagnosticCode | (string & {});
+    severity: Severity;
+    path: string;
+    message: string;
+    line?: number;
+    column?: number;
+    blockId?: string;
+    pointer?: string;
+    hint?: string;
+}
+/** Deterministic ordering so every adapter returns identical diagnostics. */
+export declare function sortDiagnostics(diagnostics: Diagnostic[]): Diagnostic[];
+export declare function dedupeDiagnostics(diagnostics: Diagnostic[]): Diagnostic[];
+export interface DiagnosticSummary {
+    errors: number;
+    warnings: number;
+    infos: number;
+}
+export declare function summarizeDiagnostics(diagnostics: Diagnostic[]): DiagnosticSummary;
+/** Error carrying structured diagnostics; thrown only by programmer-facing helpers. */
+export declare class MadeEasyError extends Error {
+    readonly code: string;
+    readonly diagnostics: Diagnostic[];
+    constructor(code: string, message: string, diagnostics?: Diagnostic[]);
+}
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/contracts/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/contracts/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AACpD,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4DnB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAE3D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;iBAY3B,CAAC;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACrC,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAUvE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAWzE;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,iBAAiB,CAMjF;AAED,uFAAuF;AACvF,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;gBACvB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAE,UAAU,EAAO;CAQ1E"}

package/dist/contracts/diagnostics.js

@@ -0,0 +1,122 @@
+import { z } from 'zod';
+/**
+ * Stable diagnostic codes shared by the SDK, CLI, HTTP API, MCP tools and Studio.
+ * The value is a one-line description used for documentation and editor hints.
+ */
+export const DIAGNOSTIC_CODES = {
+    BUNDLE_FILE_MISSING: 'A file required by the bundle is missing.',
+    BUNDLE_PATH_UNSAFE: 'A path escapes the bundle root, is absolute, or uses a forbidden form.',
+    BUNDLE_LIMIT_EXCEEDED: 'The bundle exceeds a configured size, file-count or extraction limit.',
+    YAML_PARSE_ERROR: 'A YAML file cannot be parsed.',
+    SCHEMA_INVALID: 'A file does not match its versioned schema.',
+    SCHEMA_VERSION_UNSUPPORTED: 'The schema major version is not supported by this SDK.',
+    ID_DUPLICATE: 'An identifier is used more than once in the same namespace.',
+    REF_UNRESOLVED: 'A reference does not resolve to an entry, check, claim, source, result, pause rule or asset.',
+    RECIPE_UNKNOWN: 'The pinned recipe ID is not known.',
+    RECIPE_VERSION_UNSUPPORTED: 'The pinned recipe version is not available.',
+    THEME_UNSUPPORTED: 'The pinned theme ID or version is not available.',
+    SUBJECT_RECIPE_MISMATCH: 'The subject type does not match the subject profile of the pinned recipe.',
+    ROLE_MISSING: 'A required section role is missing from the track.',
+    ROLE_ORDER: 'Required section roles are not in recipe order.',
+    ROLE_DUPLICATE: 'A required section role appears more than once.',
+    BLOCK_PARSE_ERROR: 'A structured block cannot be parsed as YAML.',
+    BLOCK_UNKNOWN_TYPE: 'A structured block uses an unregistered type.',
+    BLOCK_PROPS_INVALID: 'A structured block has props that do not match its typed schema.',
+    BLOCK_REQUIRED_MISSING: 'The recipe requires a structured block that is not present in the section.',
+    FIELD_REQUIRED_MISSING: 'The recipe requires a field that is missing or empty.',
+    CONTENT_TOO_SHORT: 'The section has less prose than the preset requires.',
+    PLACEHOLDER_PRESENT: 'Explicit placeholder text remains. Allowed in drafts, blocked in release.',
+    PIN_MISSING: 'The brief does not pin an operator-reference entry.',
+    PIN_UNRESOLVED: 'A pinned operator-reference entry does not exist.',
+    PIN_STALE: 'A pinned operator-reference entry changed after it was pinned.',
+    PAUSE_NOT_COVERED: 'A brief pause rule is not shown in the ownership section.',
+    CHECK_NOT_COVERED: 'An acceptance check is not defined or not used by every worked result.',
+    RESULT_CHECK_MISMATCH: 'A worked result is not recorded against the same acceptance checks.',
+    RESULT_VERDICT_INCONSISTENT: 'A worked result verdict contradicts its recorded check outcomes.',
+    CLAIM_UNRESOLVED: 'A material claim is recorded as unresolved.',
+    CLAIM_NO_EVIDENCE: 'A supported claim has no evidence.',
+    SOURCE_SYNTHETIC: 'Evidence is synthetic and is labelled as such in outputs.',
+    ASSET_FILE_MISSING: 'A declared asset file is missing.',
+    ASSET_DIGEST_MISMATCH: 'An asset file does not match its recorded digest.',
+    ASSET_ALT_MISSING: 'An asset needs alternative text or an explicit decorative marker.',
+    ASSET_MEDIA_TYPE_MISMATCH: 'An asset media type does not match its file extension.',
+    PUBLICATION_PRIVATE_REFERENCE: 'Published content references a private source or asset.',
+    EXAMPLE_FIXTURE_MISSING: 'An executable example has no fixture files.',
+    EXAMPLE_UNVERIFIED: 'An executable example has no verification record.',
+    EXAMPLE_VERIFICATION_STALE: 'The verification record does not match the current example.',
+    EXAMPLE_VERIFICATION_FAILED: 'The verification record reports a failing example.',
+    SECRET_DETECTED: 'The bundle appears to contain a secret or credential.',
+    ANCHOR_UNSTABLE: 'A heading has no explicit anchor, so editing it changes its link.',
+    PROFILE_FIELD_MISSING: 'The operator reference lacks a field required by the subject profile.',
+    SDK_VERSION_NOT_EXACT: 'The SDK version is not an exact version.',
+    SDK_INTEGRITY_MISSING: 'The npm integrity metadata is missing.',
+    SDK_EXAMPLE_MISSING: 'The SDK profile requires a complete runnable example with an expected result.',
+    PDF_BROWSER_NOT_FOUND: 'No Chromium-based browser was found for PDF output.',
+    PDF_RENDER_FAILED: 'The PDF renderer failed.',
+    PDF_NETWORK_BLOCKED: 'The renderer attempted a network request, which is blocked.',
+    PDF_LAYOUT_OVERFLOW: 'A block is too tall to fit on one page.',
+    OUTPUT_EXISTS: 'The output directory exists and overwrite was not requested.',
+    OUTPUT_FAILED: 'The output could not be delivered.',
+    UNSUPPORTED_FORMAT: 'The requested output format is not supported.',
+    REVISION_MISMATCH: 'The expected revision does not match the current revision.',
+    DRAFT_ADAPTER_MISSING: 'No draft adapter is configured.',
+    DRAFT_PROPOSAL_INVALID: 'A draft proposal is malformed or cites sources outside its snapshot.',
+    NPM_RESOLVE_FAILED: 'The npm registry lookup failed.',
+    VERIFY_FAILED: 'An example verification run failed.',
+};
+export const DiagnosticSchema = z.object({
+    code: z.string(),
+    severity: z.enum(['error', 'warning', 'info']),
+    /** Bundle-relative file path (or a logical path such as `request`). */
+    path: z.string(),
+    message: z.string(),
+    line: z.number().int().positive().optional(),
+    column: z.number().int().positive().optional(),
+    blockId: z.string().optional(),
+    /** JSON pointer into the file for YAML sources. */
+    pointer: z.string().optional(),
+    hint: z.string().optional(),
+});
+const severityRank = { error: 0, warning: 1, info: 2 };
+/** Deterministic ordering so every adapter returns identical diagnostics. */
+export function sortDiagnostics(diagnostics) {
+    return [...diagnostics].sort((a, b) => severityRank[a.severity] - severityRank[b.severity] ||
+        a.path.localeCompare(b.path) ||
+        (a.line ?? 0) - (b.line ?? 0) ||
+        a.code.localeCompare(b.code) ||
+        (a.pointer ?? '').localeCompare(b.pointer ?? '') ||
+        a.message.localeCompare(b.message));
+}
+export function dedupeDiagnostics(diagnostics) {
+    const seen = new Set();
+    const out = [];
+    for (const d of diagnostics) {
+        const key = [d.code, d.severity, d.path, d.line ?? '', d.blockId ?? '', d.pointer ?? '', d.message].join('\u0000');
+        if (!seen.has(key)) {
+            seen.add(key);
+            out.push(d);
+        }
+    }
+    return out;
+}
+export function summarizeDiagnostics(diagnostics) {
+    return {
+        errors: diagnostics.filter((d) => d.severity === 'error').length,
+        warnings: diagnostics.filter((d) => d.severity === 'warning').length,
+        infos: diagnostics.filter((d) => d.severity === 'info').length,
+    };
+}
+/** Error carrying structured diagnostics; thrown only by programmer-facing helpers. */
+export class MadeEasyError extends Error {
+    code;
+    diagnostics;
+    constructor(code, message, diagnostics = []) {
+        super(message);
+        this.name = 'MadeEasyError';
+        this.code = code;
+        this.diagnostics = diagnostics.length
+            ? diagnostics
+            : [{ code, severity: 'error', path: 'request', message }];
+    }
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/contracts/diagnostics.js.map

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

package/dist/contracts/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Browser-safe contracts: schemas, typed block definitions, recipe discovery,
+ * diagnostics and shared request/result/job shapes. No Node.js imports.
+ */
+export * from './diagnostics.js';
+export * from './schemas.js';
+export * from './blocks.js';
+export * from './recipe.js';
+export * from './api.js';
+export * from './json-schema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC"}

package/dist/contracts/index.js

@@ -0,0 +1,11 @@
+/**
+ * Browser-safe contracts: schemas, typed block definitions, recipe discovery,
+ * diagnostics and shared request/result/job shapes. No Node.js imports.
+ */
+export * from './diagnostics.js';
+export * from './schemas.js';
+export * from './blocks.js';
+export * from './recipe.js';
+export * from './api.js';
+export * from './json-schema.js';
+//# sourceMappingURL=index.js.map

package/dist/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC"}

package/dist/contracts/json-schema.d.ts

@@ -0,0 +1,5 @@
+type JsonSchema = Record<string, unknown>;
+/** Versioned JSON Schemas for every file format and shared contract. Keys are file names (without .json). */
+export declare function getJsonSchemas(): Record<string, JsonSchema>;
+export {};
+//# sourceMappingURL=json-schema.d.ts.map

package/dist/contracts/json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../src/contracts/json-schema.ts"],"names":[],"mappings":"AA2BA,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAO1C,6GAA6G;AAC7G,wBAAgB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CA4B3D"}

package/dist/contracts/json-schema.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { ArtifactDescriptorSchema, BuildRequestSchema, BuildResultSchema, CreateGuideRequestSchema, DraftRequestSchema, JobRecordSchema, PreviewRequestSchema, PreviewResultSchema, ProblemSchema, SourceRefSchema, ValidateRequestSchema, ValidateResultSchema, } from './api.js';
+import { BLOCK_DEFINITIONS, BLOCK_TYPES, BlockEnvelopeSchema } from './blocks.js';
+import { DiagnosticSchema } from './diagnostics.js';
+import { RecipeDefinitionSchema } from './recipe.js';
+import { AssetsSchema, BriefSchema, ChecksSchema, GuideSchema, SourcesSchema, VerificationSchema, } from './schemas.js';
+function toJson(schema, id, title) {
+    const js = z.toJSONSchema(schema, { io: 'input', unrepresentable: 'any' });
+    return { $id: `https://x12i.dev/made-easy/schemas/${id}.json`, title, ...js };
+}
+/** Versioned JSON Schemas for every file format and shared contract. Keys are file names (without .json). */
+export function getJsonSchemas() {
+    const schemas = {
+        'guide.v1': toJson(GuideSchema, 'guide.v1', 'guide.yaml'),
+        'brief.v1': toJson(BriefSchema, 'brief.v1', 'brief.yaml'),
+        'checks.v1': toJson(ChecksSchema, 'checks.v1', 'checks.yaml'),
+        'sources.v1': toJson(SourcesSchema, 'sources.v1', 'sources.yaml'),
+        'assets.v1': toJson(AssetsSchema, 'assets.v1', 'assets.yaml'),
+        'verification.v1': toJson(VerificationSchema, 'verification.v1', 'operator/fixtures/verification.yaml'),
+        'block.v1': toJson(BlockEnvelopeSchema, 'block.v1', 'Structured block envelope'),
+        'recipe-definition.v1': toJson(RecipeDefinitionSchema, 'recipe-definition.v1', 'Recipe definition'),
+        'diagnostic.v1': toJson(DiagnosticSchema, 'diagnostic.v1', 'Diagnostic'),
+        'artifact.v1': toJson(ArtifactDescriptorSchema, 'artifact.v1', 'Artifact descriptor'),
+        'source-ref.v1': toJson(SourceRefSchema, 'source-ref.v1', 'Source reference'),
+        'create-request.v1': toJson(CreateGuideRequestSchema, 'create-request.v1', 'Create guide request'),
+        'validate-request.v1': toJson(ValidateRequestSchema, 'validate-request.v1', 'Validate request'),
+        'validate-result.v1': toJson(ValidateResultSchema, 'validate-result.v1', 'Validate result'),
+        'preview-request.v1': toJson(PreviewRequestSchema, 'preview-request.v1', 'Preview request'),
+        'preview-result.v1': toJson(PreviewResultSchema, 'preview-result.v1', 'Preview result'),
+        'build-request.v1': toJson(BuildRequestSchema, 'build-request.v1', 'Build request'),
+        'build-result.v1': toJson(BuildResultSchema, 'build-result.v1', 'Build result'),
+        'draft-request.v1': toJson(DraftRequestSchema, 'draft-request.v1', 'Draft request'),
+        'job.v1': toJson(JobRecordSchema, 'job.v1', 'Job record'),
+        'problem.v1': toJson(ProblemSchema, 'problem.v1', 'Problem response'),
+    };
+    for (const type of BLOCK_TYPES) {
+        schemas[`blocks/${type}.v1`] = toJson(BLOCK_DEFINITIONS[type].schema, `blocks/${type}.v1`, `${BLOCK_DEFINITIONS[type].title} props`);
+    }
+    return schemas;
+}
+//# sourceMappingURL=json-schema.js.map

package/dist/contracts/json-schema.js.map

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