{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://artifacts.apis.io/cueframe-ai/json-schema/cueframe-ai-component-source-response-schema.json", "title": "ComponentSourceResponse", "description": "Installed component SOURCE snapshot + ownership provenance per §Components. tsxSource is present for a retired TSX (version 3) snapshot and a historical version 2 source.", "x-generated": "2026-11-10", "x-method": "derived", "x-generator": "derive-json-schema.py", "x-source": "openapi/cueframe-ai-components-api-openapi.yml#/components/schemas/ComponentSourceResponse", "type": "object", "properties": { "tsxSource": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "description": { "type": "string", "maxLength": 2000 }, "propSchema": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "origin": { "type": "string", "enum": [ "customer-owned", "server-native" ] }, "ejectedFrom": { "type": "string", "maxLength": 200 }, "tokens": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "durationInFrames": { "type": "number", "exclusiveMinimum": 0 }, "manifest": { "$ref": "#/$defs/ComponentManifest" }, "id": { "type": "string" }, "source": { "type": "string", "enum": [ "default", "installed" ] }, "metadataStatus": { "description": "Historical source-only reads omit unavailable discovery name/description instead of borrowing current metadata.", "type": "string", "const": "unresolved" }, "sourceVersionId": { "type": "string", "description": "Exact immutable source pin; distinct from bundle revisions." }, "componentVersionId": { "description": "Exact owned source history row; equal source hashes can have different ancestry.", "type": "string", "minLength": 1, "maxLength": 128 }, "registryProvenance": { "description": "Server-derived acquisition ancestry for this exact source row; pending is not captured qualification or portable closure.", "oneOf": [ { "type": "object", "properties": { "orgId": { "type": "string", "minLength": 1, "maxLength": 128 }, "receiptRef": { "type": "object", "properties": { "bundleSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "bundleBytes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 134217728 }, "format": { "type": "string", "const": "cueframe-registry-provenance-v1" }, "receiptId": { "type": "string", "minLength": 1, "maxLength": 128 } }, "required": [ "bundleSha256", "bundleBytes", "format", "receiptId" ], "additionalProperties": false }, "artifact": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "component-version" }, "componentId": { "type": "string", "maxLength": 128, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]*$" }, "componentVersionId": { "type": "string", "minLength": 1, "maxLength": 128 }, "sourceVersionId": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "kind", "componentId", "componentVersionId", "sourceVersionId" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "template-document" }, "templateId": { "type": "string", "minLength": 1, "maxLength": 128 }, "documentSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "kind", "templateId", "documentSha256" ], "additionalProperties": false } ], "type": "object" }, "status": { "type": "string", "const": "pending" } }, "required": [ "orgId", "receiptRef", "artifact", "status" ], "additionalProperties": false }, { "type": "object", "properties": { "orgId": { "type": "string", "minLength": 1, "maxLength": 128 }, "receiptRef": { "type": "object", "properties": { "bundleSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "bundleBytes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 134217728 }, "format": { "type": "string", "const": "cueframe-registry-provenance-v1" }, "receiptId": { "type": "string", "minLength": 1, "maxLength": 128 } }, "required": [ "bundleSha256", "bundleBytes", "format", "receiptId" ], "additionalProperties": false }, "artifact": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "component-version" }, "componentId": { "type": "string", "maxLength": 128, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]*$" }, "componentVersionId": { "type": "string", "minLength": 1, "maxLength": 128 }, "sourceVersionId": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "kind", "componentId", "componentVersionId", "sourceVersionId" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "template-document" }, "templateId": { "type": "string", "minLength": 1, "maxLength": 128 }, "documentSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "kind", "templateId", "documentSha256" ], "additionalProperties": false } ], "type": "object" }, "status": { "type": "string", "const": "captured" }, "adaptationReceiptRef": { "type": "object", "properties": { "format": { "type": "string", "const": "cueframe-registry-adaptation-v1" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "byteLength": { "type": "integer", "exclusiveMinimum": 0, "maximum": 134217728 } }, "required": [ "format", "sha256", "byteLength" ], "additionalProperties": false } }, "required": [ "orgId", "receiptRef", "artifact", "status", "adaptationReceiptRef" ], "additionalProperties": false } ], "type": "object" }, "sourceSnapshot": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "version": { "type": "number", "const": 3 }, "componentId": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]*$" }, "tsxSource": { "type": "string", "minLength": 1, "maxLength": 8000000 }, "manifest": { "type": "object", "properties": { "version": { "type": "number", "const": 2 }, "assets": { "type": "object", "propertyNames": { "type": "string", "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "image", "video", "audio", "data", "visual" ] }, "required": { "type": "boolean" }, "mimeTypes": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1 } }, "mediaDemand": { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "const": "original" } }, "required": [ "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "tier" }, "tier": { "anyOf": [ { "type": "number", "const": 256 }, { "type": "number", "const": 512 }, { "type": "number", "const": 1024 }, { "type": "number", "const": 2048 } ] } }, "required": [ "mode", "tier" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "auto" }, "maxProjectedWidthRatio": { "type": "number", "exclusiveMinimum": 0, "maximum": 64 }, "maxProjectedHeightRatio": { "type": "number", "exclusiveMinimum": 0, "maximum": 64 }, "minVisibleSourceWidthRatio": { "default": 1, "type": "number", "exclusiveMinimum": 0, "maximum": 1 }, "minVisibleSourceHeightRatio": { "default": 1, "type": "number", "exclusiveMinimum": 0, "maximum": 1 } }, "required": [ "mode", "maxProjectedWidthRatio", "maxProjectedHeightRatio", "minVisibleSourceWidthRatio", "minVisibleSourceHeightRatio" ], "additionalProperties": false } ], "type": "object" } }, "required": [ "kind", "required" ], "additionalProperties": false } }, "graphics": { "type": "object", "properties": { "api": { "type": "string", "enum": [ "canvas2d", "webgl", "webgl2", "webgpu" ] }, "required": { "type": "boolean", "const": true }, "accelerationPreference": { "type": "string", "enum": [ "hardware-preferred", "software-allowed" ] } }, "required": [ "api", "required", "accelerationPreference" ], "additionalProperties": false }, "alphaPolicy": { "type": "string", "enum": [ "requires-transparency", "allows-opaque" ] }, "sceneShot": { "type": "object", "properties": { "version": { "type": "number", "const": 2 } }, "required": [ "version" ], "additionalProperties": false }, "visualMedia": { "type": "object", "properties": { "version": { "type": "number", "const": 1 } }, "required": [ "version" ], "additionalProperties": false } }, "required": [ "version", "assets", "graphics", "alphaPolicy" ], "additionalProperties": false }, "definition": { "type": "object", "properties": { "inputSchema": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "defaults": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "brandBindings": { "type": "array", "items": { "type": "object", "properties": { "propPath": { "type": "string", "minLength": 1, "maxLength": 128 }, "cssVar": { "type": "string", "minLength": 1, "maxLength": 128 }, "fallback": { "type": "string" }, "brandKitPath": { "type": "string", "minLength": 1, "maxLength": 128 } }, "required": [ "propPath", "cssVar" ], "additionalProperties": false } }, "timing": { "type": "object", "properties": { "defaultDuration": { "type": "object", "properties": { "frames": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "fps": { "type": "number", "exclusiveMinimum": 0 } }, "required": [ "frames", "fps" ], "additionalProperties": false }, "minDurationSec": { "type": "number", "exclusiveMinimum": 0 }, "maxDurationSec": { "type": "number", "exclusiveMinimum": 0 } }, "required": [ "defaultDuration" ], "additionalProperties": false }, "capabilities": { "minItems": 1, "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "clip" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "cut-transition" }, "protocol": { "type": "string", "const": "per-child" } }, "required": [ "kind", "protocol" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "content-slots" }, "slots": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 128 }, "min": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "max": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "ownership": { "type": "string", "enum": [ "reference", "exclusive" ] }, "sizing": { "type": "string", "enum": [ "canvas", "container" ] } }, "required": [ "name", "min", "max", "ownership", "sizing" ], "additionalProperties": false } } }, "required": [ "kind", "slots" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "clip-wrapper" }, "ordering": { "type": "string", "enum": [ "any", "innermost" ] }, "acceptsWrappedTargets": { "type": "boolean" } }, "required": [ "kind", "ordering", "acceptsWrappedTargets" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "global-wrapper" }, "scope": { "type": "string", "const": "media-lanes" }, "ordering": { "type": "string", "enum": [ "any", "innermost" ] }, "acceptsWrappedTargets": { "type": "boolean" } }, "required": [ "kind", "scope", "ordering", "acceptsWrappedTargets" ], "additionalProperties": false } ], "type": "object" } }, "mediaBindings": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 128 }, "propPath": { "minItems": 1, "maxItems": 16, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 128 } }, "kind": { "type": "string", "enum": [ "image", "video", "visual" ] }, "collection": { "type": "string", "enum": [ "scalar", "array" ] }, "cardinality": { "type": "object", "properties": { "min": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "max": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "min" ], "additionalProperties": false }, "mimeTypes": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1 } }, "mediaDemand": { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "const": "original" } }, "required": [ "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "tier" }, "tier": { "anyOf": [ { "type": "number", "const": 256 }, { "type": "number", "const": 512 }, { "type": "number", "const": 1024 }, { "type": "number", "const": 2048 } ] } }, "required": [ "mode", "tier" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "auto" }, "maxProjectedWidthRatio": { "type": "number", "exclusiveMinimum": 0, "maximum": 64 }, "maxProjectedHeightRatio": { "type": "number", "exclusiveMinimum": 0, "maximum": 64 }, "minVisibleSourceWidthRatio": { "default": 1, "type": "number", "exclusiveMinimum": 0, "maximum": 1 }, "minVisibleSourceHeightRatio": { "default": 1, "type": "number", "exclusiveMinimum": 0, "maximum": 1 } }, "required": [ "mode", "maxProjectedWidthRatio", "maxProjectedHeightRatio", "minVisibleSourceWidthRatio", "minVisibleSourceHeightRatio" ], "additionalProperties": false } ], "type": "object" } }, "required": [ "name", "propPath", "kind", "collection", "cardinality" ], "additionalProperties": false } }, "preview": { "type": "object", "properties": { "params": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "format": { "$ref": "#/$defs/Format" }, "assets": { "type": "object", "propertyNames": { "type": "string", "minLength": 1, "maxLength": 128 }, "additionalProperties": { "anyOf": [ { "type": "object", "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https:\\/\\/.*" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "mimeType": { "type": "string", "minLength": 1 }, "frameRate": { "type": "number", "exclusiveMinimum": 0 }, "durationSec": { "type": "number", "exclusiveMinimum": 0 } }, "required": [ "url", "sha256", "mimeType" ], "additionalProperties": false }, { "type": "object", "properties": { "mediaId": { "type": "string", "minLength": 1, "maxLength": 128 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "mimeType": { "type": "string", "minLength": 1 }, "frameRate": { "type": "number", "exclusiveMinimum": 0 }, "durationSec": { "type": "number", "exclusiveMinimum": 0 } }, "required": [ "mediaId", "sha256", "mimeType" ], "additionalProperties": false } ] } }, "mediaBindings": { "type": "object", "propertyNames": { "type": "string", "minLength": 1, "maxLength": 128 }, "additionalProperties": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https:\\/\\/.*" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "mimeType": { "type": "string", "minLength": 1 }, "frameRate": { "type": "number", "exclusiveMinimum": 0 }, "durationSec": { "type": "number", "exclusiveMinimum": 0 } }, "required": [ "url", "sha256", "mimeType" ], "additionalProperties": false }, { "type": "object", "properties": { "mediaId": { "type": "string", "minLength": 1, "maxLength": 128 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "mimeType": { "type": "string", "minLength": 1 }, "frameRate": { "type": "number", "exclusiveMinimum": 0 }, "durationSec": { "type": "number", "exclusiveMinimum": 0 } }, "required": [ "mediaId", "sha256", "mimeType" ], "additionalProperties": false } ] } } } }, "additionalProperties": false } }, "required": [ "inputSchema", "defaults", "brandBindings", "timing", "capabilities" ], "additionalProperties": false } }, "required": [ "version", "componentId", "tsxSource", "manifest", "definition" ], "additionalProperties": false }, { "type": "object", "properties": { "version": { "type": "number", "const": 4 }, "componentId": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]*$" }, "template": { "type": "string", "minLength": 1, "maxLength": 2000000 }, "manifest": { "type": "object", "properties": { "version": { "type": "number", "const": 4 }, "runtime": { "type": "string", "const": "hyperframes" }, "hfContract": { "type": "number", "const": 1 }, "kind": { "type": "string", "const": "scene" }, "sceneShot": { "type": "object", "properties": { "version": { "type": "number", "const": 2 } }, "required": [ "version" ], "additionalProperties": false }, "assets": { "type": "object", "propertyNames": { "type": "string", "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "image", "video", "audio", "data", "visual" ] }, "required": { "type": "boolean" }, "mimeTypes": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1 } }, "mediaDemand": { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "const": "original" } }, "required": [ "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "tier" }, "tier": { "anyOf": [ { "type": "number", "const": 256 }, { "type": "number", "const": 512 }, { "type": "number", "const": 1024 }, { "type": "number", "const": 2048 } ] } }, "required": [ "mode", "tier" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "auto" }, "maxProjectedWidthRatio": { "type": "number", "exclusiveMinimum": 0, "maximum": 64 }, "maxProjectedHeightRatio": { "type": "number", "exclusiveMinimum": 0, "maximum": 64 }, "minVisibleSourceWidthRatio": { "default": 1, "type": "number", "exclusiveMinimum": 0, "maximum": 1 }, "minVisibleSourceHeightRatio": { "default": 1, "type": "number", "exclusiveMinimum": 0, "maximum": 1 } }, "required": [ "mode", "maxProjectedWidthRatio", "maxProjectedHeightRatio", "minVisibleSourceWidthRatio", "minVisibleSourceHeightRatio" ], "additionalProperties": false } ], "type": "object" } }, "required": [ "kind", "required" ], "additionalProperties": false } }, "graphics": { "type": "object", "properties": { "api": { "type": "string", "enum": [ "canvas2d", "webgl", "webgl2", "webgpu" ] }, "required": { "type": "boolean", "const": true }, "accelerationPreference": { "type": "string", "enum": [ "hardware-preferred", "software-allowed" ] } }, "required": [ "api", "required", "accelerationPreference" ], "additionalProperties": false }, "alphaPolicy": { "type": "string", "enum": [ "requires-transparency", "allows-opaque" ] } }, "required": [ "version", "runtime", "hfContract", "kind", "assets", "graphics", "alphaPolicy" ], "additionalProperties": false }, "definition": { "type": "object", "properties": { "inputSchema": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "defaults": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "brandBindings": { "type": "array", "items": { "type": "object", "properties": { "propPath": { "type": "string", "minLength": 1, "maxLength": 128 }, "cssVar": { "type": "string", "minLength": 1, "maxLength": 128 }, "fallback": { "type": "string" }, "brandKitPath": { "type": "string", "minLength": 1, "maxLength": 128 } }, "required": [ "propPath", "cssVar" ], "additionalProperties": false } }, "timing": { "type": "object", "properties": { "defaultDuration": { "type": "object", "properties": { "frames": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "fps": { "type": "number", "exclusiveMinimum": 0 } }, "required": [ "frames", "fps" ], "additionalProperties": false }, "minDurationSec": { "type": "number", "exclusiveMinimum": 0 }, "maxDurationSec": { "type": "number", "exclusiveMinimum": 0 } }, "required": [ "defaultDuration" ], "additionalProperties": false }, "capabilities": { "minItems": 1, "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "clip" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "cut-transition" }, "protocol": { "type": "string", "const": "per-child" } }, "required": [ "kind", "protocol" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "content-slots" }, "slots": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 128 }, "min": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "max": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "ownership": { "type": "string", "enum": [ "reference", "exclusive" ] }, "sizing": { "type": "string", "enum": [ "canvas", "container" ] } }, "required": [ "name", "min", "max", "ownership", "sizing" ], "additionalProperties": false } } }, "required": [ "kind", "slots" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "clip-wrapper" }, "ordering": { "type": "string", "enum": [ "any", "innermost" ] }, "acceptsWrappedTargets": { "type": "boolean" } }, "required": [ "kind", "ordering", "acceptsWrappedTargets" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "global-wrapper" }, "scope": { "type": "string", "const": "media-lanes" }, "ordering": { "type": "string", "enum": [ "any", "innermost" ] }, "acceptsWrappedTargets": { "type": "boolean" } }, "required": [ "kind", "scope", "ordering", "acceptsWrappedTargets" ], "additionalProperties": false } ], "type": "object" } }, "mediaBindings": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 128 }, "propPath": { "minItems": 1, "maxItems": 16, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 128 } }, "kind": { "type": "string", "enum": [ "image", "video", "visual" ] }, "collection": { "type": "string", "enum": [ "scalar", "array" ] }, "cardinality": { "type": "object", "properties": { "min": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "max": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "min" ], "additionalProperties": false }, "mimeTypes": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1 } }, "mediaDemand": { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "const": "original" } }, "required": [ "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "tier" }, "tier": { "anyOf": [ { "type": "number", "const": 256 }, { "type": "number", "const": 512 }, { "type": "number", "const": 1024 }, { "type": "number", "const": 2048 } ] } }, "required": [ "mode", "tier" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "auto" }, "maxProjectedWidthRatio": { "type": "number", "exclusiveMinimum": 0, "maximum": 64 }, "maxProjectedHeightRatio": { "type": "number", "exclusiveMinimum": 0, "maximum": 64 }, "minVisibleSourceWidthRatio": { "default": 1, "type": "number", "exclusiveMinimum": 0, "maximum": 1 }, "minVisibleSourceHeightRatio": { "default": 1, "type": "number", "exclusiveMinimum": 0, "maximum": 1 } }, "required": [ "mode", "maxProjectedWidthRatio", "maxProjectedHeightRatio", "minVisibleSourceWidthRatio", "minVisibleSourceHeightRatio" ], "additionalProperties": false } ], "type": "object" } }, "required": [ "name", "propPath", "kind", "collection", "cardinality" ], "additionalProperties": false } }, "preview": { "type": "object", "properties": { "params": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "format": { "$ref": "#/$defs/Format" }, "assets": { "type": "object", "propertyNames": { "type": "string", "minLength": 1, "maxLength": 128 }, "additionalProperties": { "anyOf": [ { "type": "object", "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https:\\/\\/.*" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "mimeType": { "type": "string", "minLength": 1 }, "frameRate": { "type": "number", "exclusiveMinimum": 0 }, "durationSec": { "type": "number", "exclusiveMinimum": 0 } }, "required": [ "url", "sha256", "mimeType" ], "additionalProperties": false }, { "type": "object", "properties": { "mediaId": { "type": "string", "minLength": 1, "maxLength": 128 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "mimeType": { "type": "string", "minLength": 1 }, "frameRate": { "type": "number", "exclusiveMinimum": 0 }, "durationSec": { "type": "number", "exclusiveMinimum": 0 } }, "required": [ "mediaId", "sha256", "mimeType" ], "additionalProperties": false } ] } }, "mediaBindings": { "type": "object", "propertyNames": { "type": "string", "minLength": 1, "maxLength": 128 }, "additionalProperties": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https:\\/\\/.*" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "mimeType": { "type": "string", "minLength": 1 }, "frameRate": { "type": "number", "exclusiveMinimum": 0 }, "durationSec": { "type": "number", "exclusiveMinimum": 0 } }, "required": [ "url", "sha256", "mimeType" ], "additionalProperties": false }, { "type": "object", "properties": { "mediaId": { "type": "string", "minLength": 1, "maxLength": 128 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "mimeType": { "type": "string", "minLength": 1 }, "frameRate": { "type": "number", "exclusiveMinimum": 0 }, "durationSec": { "type": "number", "exclusiveMinimum": 0 } }, "required": [ "mediaId", "sha256", "mimeType" ], "additionalProperties": false } ] } } } }, "additionalProperties": false } }, "required": [ "inputSchema", "defaults", "brandBindings", "timing", "capabilities" ], "additionalProperties": false } }, "required": [ "version", "componentId", "template", "manifest", "definition" ], "additionalProperties": false } ] }, { "type": "object", "properties": { "version": { "type": "number", "const": 2 }, "componentId": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[a-z0-9][a-z0-9._-]*$" }, "tsxSource": { "type": "string", "minLength": 1 }, "manifest": { "type": "object", "properties": { "version": { "type": "number", "const": 2 }, "assets": { "type": "object", "propertyNames": { "type": "string", "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "image", "video", "audio", "data", "visual" ] }, "required": { "type": "boolean" }, "mimeTypes": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1 } }, "mediaDemand": { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "const": "original" } }, "required": [ "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "tier" }, "tier": { "anyOf": [ { "type": "number", "const": 256 }, { "type": "number", "const": 512 }, { "type": "number", "const": 1024 }, { "type": "number", "const": 2048 } ] } }, "required": [ "mode", "tier" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "auto" }, "maxProjectedWidthRatio": { "type": "number", "exclusiveMinimum": 0, "maximum": 64 }, "maxProjectedHeightRatio": { "type": "number", "exclusiveMinimum": 0, "maximum": 64 }, "minVisibleSourceWidthRatio": { "default": 1, "type": "number", "exclusiveMinimum": 0, "maximum": 1 }, "minVisibleSourceHeightRatio": { "default": 1, "type": "number", "exclusiveMinimum": 0, "maximum": 1 } }, "required": [ "mode", "maxProjectedWidthRatio", "maxProjectedHeightRatio", "minVisibleSourceWidthRatio", "minVisibleSourceHeightRatio" ], "additionalProperties": false } ], "type": "object" } }, "required": [ "kind", "required" ], "additionalProperties": false } }, "graphics": { "type": "object", "properties": { "api": { "type": "string", "enum": [ "canvas2d", "webgl", "webgl2", "webgpu" ] }, "required": { "type": "boolean", "const": true }, "accelerationPreference": { "type": "string", "enum": [ "hardware-preferred", "software-allowed" ] } }, "required": [ "api", "required", "accelerationPreference" ], "additionalProperties": false }, "alphaPolicy": { "type": "string", "enum": [ "requires-transparency", "allows-opaque" ] }, "sceneShot": { "type": "object", "properties": { "version": { "type": "number", "const": 2 } }, "required": [ "version" ], "additionalProperties": false }, "visualMedia": { "type": "object", "properties": { "version": { "type": "number", "const": 1 } }, "required": [ "version" ], "additionalProperties": false } }, "required": [ "version", "assets", "graphics", "alphaPolicy" ], "additionalProperties": false } }, "required": [ "version", "componentId", "tsxSource", "manifest" ], "additionalProperties": false } ], "description": "Immutable source snapshot: a version 4 template, a retired version 3 TSX module, or the historical version 2 source of a component stored before versioned sources (read-only; it never executes). source remains provenance." } }, "required": [ "propSchema", "manifest", "id", "source", "sourceVersionId", "sourceSnapshot" ], "additionalProperties": false, "$defs": { "ComponentManifest": { "anyOf": [ { "$ref": "#/$defs/ComponentManifestV4" }, { "$ref": "#/$defs/ComponentManifestV2" } ] }, "ComponentManifestV2": { "type": "object", "properties": { "version": { "type": "number", "const": 2 }, "assets": { "type": "object", "propertyNames": { "type": "string", "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "image", "video", "audio", "data", "visual" ] }, "required": { "type": "boolean" }, "mimeTypes": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1 } }, "mediaDemand": { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "const": "original" } }, "required": [ "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "tier" }, "tier": { "anyOf": [ { "type": "number", "const": 256 }, { "type": "number", "const": 512 }, { "type": "number", "const": 1024 }, { "type": "number", "const": 2048 } ] } }, "required": [ "mode", "tier" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "auto" }, "maxProjectedWidthRatio": { "type": "number", "exclusiveMinimum": 0, "maximum": 64 }, "maxProjectedHeightRatio": { "type": "number", "exclusiveMinimum": 0, "maximum": 64 }, "minVisibleSourceWidthRatio": { "default": 1, "type": "number", "exclusiveMinimum": 0, "maximum": 1 }, "minVisibleSourceHeightRatio": { "default": 1, "type": "number", "exclusiveMinimum": 0, "maximum": 1 } }, "required": [ "mode", "maxProjectedWidthRatio", "maxProjectedHeightRatio", "minVisibleSourceWidthRatio", "minVisibleSourceHeightRatio" ], "additionalProperties": false } ], "type": "object" } }, "required": [ "kind", "required" ], "additionalProperties": false } }, "graphics": { "type": "object", "properties": { "api": { "type": "string", "enum": [ "canvas2d", "webgl", "webgl2", "webgpu" ] }, "required": { "type": "boolean", "const": true }, "accelerationPreference": { "type": "string", "enum": [ "hardware-preferred", "software-allowed" ] } }, "required": [ "api", "required", "accelerationPreference" ], "additionalProperties": false }, "alphaPolicy": { "type": "string", "enum": [ "requires-transparency", "allows-opaque" ] }, "sceneShot": { "type": "object", "properties": { "version": { "type": "number", "const": 2 } }, "required": [ "version" ], "additionalProperties": false }, "visualMedia": { "type": "object", "properties": { "version": { "type": "number", "const": 1 } }, "required": [ "version" ], "additionalProperties": false } }, "required": [ "version", "assets", "graphics", "alphaPolicy" ], "additionalProperties": false }, "ComponentManifestV4": { "type": "object", "properties": { "version": { "type": "number", "const": 4 }, "runtime": { "type": "string", "const": "hyperframes" }, "hfContract": { "type": "number", "const": 1 }, "kind": { "type": "string", "const": "scene" }, "sceneShot": { "type": "object", "properties": { "version": { "type": "number", "const": 2 } }, "required": [ "version" ], "additionalProperties": false }, "assets": { "type": "object", "propertyNames": { "type": "string", "minLength": 1 }, "additionalProperties": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "image", "video", "audio", "data", "visual" ] }, "required": { "type": "boolean" }, "mimeTypes": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1 } }, "mediaDemand": { "oneOf": [ { "type": "object", "properties": { "mode": { "type": "string", "const": "original" } }, "required": [ "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "tier" }, "tier": { "anyOf": [ { "type": "number", "const": 256 }, { "type": "number", "const": 512 }, { "type": "number", "const": 1024 }, { "type": "number", "const": 2048 } ] } }, "required": [ "mode", "tier" ], "additionalProperties": false }, { "type": "object", "properties": { "mode": { "type": "string", "const": "auto" }, "maxProjectedWidthRatio": { "type": "number", "exclusiveMinimum": 0, "maximum": 64 }, "maxProjectedHeightRatio": { "type": "number", "exclusiveMinimum": 0, "maximum": 64 }, "minVisibleSourceWidthRatio": { "default": 1, "type": "number", "exclusiveMinimum": 0, "maximum": 1 }, "minVisibleSourceHeightRatio": { "default": 1, "type": "number", "exclusiveMinimum": 0, "maximum": 1 } }, "required": [ "mode", "maxProjectedWidthRatio", "maxProjectedHeightRatio", "minVisibleSourceWidthRatio", "minVisibleSourceHeightRatio" ], "additionalProperties": false } ], "type": "object" } }, "required": [ "kind", "required" ], "additionalProperties": false } }, "graphics": { "type": "object", "properties": { "api": { "type": "string", "enum": [ "canvas2d", "webgl", "webgl2", "webgpu" ] }, "required": { "type": "boolean", "const": true }, "accelerationPreference": { "type": "string", "enum": [ "hardware-preferred", "software-allowed" ] } }, "required": [ "api", "required", "accelerationPreference" ], "additionalProperties": false }, "alphaPolicy": { "type": "string", "enum": [ "requires-transparency", "allows-opaque" ] } }, "required": [ "version", "runtime", "hfContract", "kind", "assets", "graphics", "alphaPolicy" ], "additionalProperties": false }, "Format": { "type": "object", "properties": { "aspectRatio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:5" ] }, "fps": { "anyOf": [ { "type": "number", "const": 24 }, { "type": "number", "const": 25 }, { "type": "number", "const": 30 }, { "type": "number", "const": 60 } ] }, "resolution": { "type": "string", "enum": [ "hd", "fhd", "4k" ] }, "platform": { "type": "string" } }, "required": [ "aspectRatio" ] } } }