@plasius/gpu-model-core 0.3.0 → 0.4.1

package/dist/index.d.cts

@@ -733,6 +733,197 @@ declare function isGpuModelResourceGraph(value: unknown): value is GpuModelResou
  */
 declare function createGpuModelResourceGraph(document: unknown, input: unknown): GpuModelResourceGraph;
 
+/** Inert provenance hints. Never put credentials or signed URLs in this metadata. */
+interface ModelProvenance {
+    readonly sourceId?: string;
+    readonly sourceSystem?: string;
+    readonly acquiredAt?: string;
+    readonly licenseHint?: string;
+}
+interface SourceHints {
+    readonly mimeTypeHint?: string;
+    readonly fileNameHint?: string;
+    readonly provenance?: ModelProvenance;
+}
+/** Node Readable streams implement AsyncIterable; no Node types enter browser declarations. */
+type ModelReadableStream = ReadableStream<Uint8Array> | AsyncIterable<Uint8Array>;
+/** Portable subset also implemented by Node Writable streams. */
+type ModelWritableStream = WritableStream<Uint8Array> | {
+    write(chunk: Uint8Array): boolean;
+    end(): unknown;
+};
+/** Declarative IO; the injected adapter/runtime owns resolution and authorization. */
+type ModelSource = SourceHints & ({
+    readonly kind: "file-path";
+    readonly path: string;
+} | {
+    readonly kind: "url";
+    readonly url: string;
+    readonly headers?: Readonly<Record<string, string>>;
+} | {
+    readonly kind: "blob-storage-url";
+    readonly url: string;
+    readonly credentialMode?: "anonymous" | "signed" | "runtime-resolved";
+} | {
+    readonly kind: "blob";
+    readonly blob: Blob;
+} | {
+    readonly kind: "array-buffer";
+    readonly bytes: ArrayBuffer;
+} | {
+    readonly kind: "uint8-array";
+    readonly bytes: Uint8Array;
+} | {
+    readonly kind: "stream";
+    readonly stream: ModelReadableStream;
+    readonly byteLengthHint?: number;
+});
+/** Each call selects exactly one output destination. */
+type ModelTarget = {
+    readonly kind: "file-path";
+    readonly path: string;
+    readonly overwrite?: boolean;
+} | {
+    readonly kind: "blob-storage-url";
+    readonly url: string;
+    readonly overwrite?: boolean;
+    readonly contentType?: string;
+    readonly metadata?: Readonly<Record<string, string>>;
+} | {
+    readonly kind: "blob";
+    readonly mimeType?: string;
+    readonly fileName?: string;
+} | {
+    readonly kind: "array-buffer";
+} | {
+    readonly kind: "uint8-array";
+} | {
+    readonly kind: "stream";
+    readonly stream: ModelWritableStream;
+    readonly contentType?: string;
+} | {
+    readonly kind: "package";
+    readonly packageFormat: "zip" | "tar" | "directory-manifest";
+    readonly destinationHint?: string;
+    readonly includeSourcePayload?: boolean;
+};
+type RepairMode = GpuModelDiagnosticMode;
+/** Caller policy is authoritative; cancellation/deadline apply to the whole conversion. */
+interface ModelOperationOptions {
+    readonly mode?: RepairMode;
+    readonly allowLoss?: boolean;
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+}
+type InspectOptions = ModelOperationOptions;
+type LoadOptions = ModelOperationOptions;
+type ExportOptions = ModelOperationOptions;
+type ValidateOptions = ModelOperationOptions;
+interface AdapterCapabilityMetadata {
+    readonly formatId: string;
+    readonly displayName: string;
+    readonly supportedSourceKinds: readonly ModelSource["kind"][];
+    readonly supportedTargetKinds: readonly ModelTarget["kind"][];
+    readonly supportsAnimations: boolean;
+    readonly supportsSkins: boolean;
+    readonly supportsAnalyticGeometry: boolean;
+}
+/** Packaging descriptors are not proof of exported bytes or asset promotion. */
+interface ResourcePackageManifest {
+    readonly format: "zip" | "tar" | "directory-manifest" | "inline";
+    readonly entries: readonly {
+        readonly id: string;
+        readonly role: "mesh" | "material" | "texture" | "animation" | "auxiliary";
+        readonly path: string;
+        readonly contentType?: string;
+    }[];
+}
+/** Construct through createModelResultBase; derived fields cannot disagree with the report. */
+interface ModelResultBase {
+    readonly report: GpuModelDiagnosticReport;
+    readonly diagnostics: readonly GpuModelConversionDiagnostic[];
+    readonly warnings: readonly GpuModelConversionDiagnostic[];
+    readonly repairs: readonly GpuModelRepairRecord[];
+    readonly lossReports: GpuModelDiagnosticReport["losses"];
+}
+interface ModelInspectResult extends ModelResultBase {
+    readonly detectedFormat?: string;
+    readonly capabilities: AdapterCapabilityMetadata;
+}
+interface ModelLoadResult extends ModelResultBase {
+    readonly document?: GpuModelDocument;
+    readonly resourcePackage?: ResourcePackageManifest;
+}
+interface ModelExportResult extends ModelResultBase {
+    readonly target: ModelTarget["kind"];
+    readonly resourcePackage?: ResourcePackageManifest;
+    readonly output?: Blob | ArrayBuffer | Uint8Array;
+}
+interface ModelValidateResult extends ModelResultBase {
+    readonly valid: boolean;
+}
+/** Trusted injected adapter: stage writes and enforce policy before committing output. */
+interface ModelAdapter {
+    readonly metadata: AdapterCapabilityMetadata;
+    inspect(source: ModelSource, options?: InspectOptions): Promise<ModelInspectResult>;
+    load(source: ModelSource, options?: LoadOptions): Promise<ModelLoadResult>;
+    export(document: GpuModelDocument, target: ModelTarget, options?: ExportOptions): Promise<ModelExportResult>;
+    validate(input: ModelSource | GpuModelDocument, options?: ValidateOptions): Promise<ModelValidateResult>;
+}
+interface ModelConversionStage {
+    readonly formatId: string;
+    readonly operation: "inspect" | "load" | "capabilities" | "validate" | "export";
+    readonly report: GpuModelDiagnosticReport;
+}
+/** No source/target descriptors or exception causes are retained in a ledger. */
+interface ModelRegistryResult {
+    readonly accepted: boolean;
+    readonly stages: readonly ModelConversionStage[];
+    readonly diagnostics: readonly GpuModelConversionDiagnostic[];
+    readonly warnings: readonly GpuModelConversionDiagnostic[];
+    readonly repairs: readonly GpuModelRepairRecord[];
+    readonly lossReports: GpuModelDiagnosticReport["losses"];
+    readonly document?: GpuModelDocument;
+    readonly inspection?: ModelInspectResult;
+    readonly resourcePackage?: ResourcePackageManifest;
+    readonly exported?: ModelExportResult;
+}
+interface ModelConversionRequest {
+    readonly sourceFormat: string;
+    readonly targetFormat: string;
+    readonly source: ModelSource;
+    readonly target: ModelTarget;
+}
+interface ModelConversionRegistry {
+    readonly capabilities: readonly AdapterCapabilityMetadata[];
+    inspect(format: string, source: ModelSource, options?: InspectOptions): Promise<ModelRegistryResult>;
+    load(format: string, source: ModelSource, options?: LoadOptions): Promise<ModelRegistryResult>;
+    validate(format: string, input: ModelSource | GpuModelDocument, options?: ValidateOptions): Promise<ModelRegistryResult>;
+    export(format: string, document: GpuModelDocument, target: ModelTarget, options?: ExportOptions): Promise<ModelRegistryResult>;
+    convert(request: ModelConversionRequest, options?: ModelOperationOptions): Promise<ModelRegistryResult>;
+}
+declare const MODEL_REGISTRY_LIMITS: Readonly<{
+    adapters: 128;
+    concurrent: 8;
+    timeoutMs: 30000;
+    maxTimeoutMs: 300000;
+    string: 4096;
+    mapEntries: 64;
+    manifestEntries: 4096;
+    memoryBytes: number;
+}>;
+type ModelRegistryErrorCode = "invalid-input" | "invalid-adapter" | "duplicate-format" | "unsupported-format" | "unsupported-source" | "unsupported-target" | "invalid-result" | "adapter-failed" | "aborted" | "deadline-exceeded" | "capacity-exceeded";
+declare class ModelRegistryError extends TypeError {
+    readonly code: ModelRegistryErrorCode;
+    constructor(code: ModelRegistryErrorCode);
+}
+/** Evaluates, copies and freezes bounded adapter evidence using the core repair policy. */
+declare function createModelResultBase(input: GpuModelDiagnosticInput): ModelResultBase;
+/** Creates an immutable fixed registry. No global discovery, format sniffing or IO. */
+declare function createModelConversionRegistry(adapters: readonly ModelAdapter[], limits?: {
+    readonly maxConcurrent?: number;
+}): ModelConversionRegistry;
+
 /** Package identity and rollout metadata for the initial repository baseline. */
 declare const packageName: "@plasius/gpu-model-core";
 declare const packageBootstrap: Readonly<{
@@ -741,4 +932,4 @@ declare const packageBootstrap: Readonly<{
     readonly status: "bootstrap";
 }>;
 
-export { CANONICAL_GPU_MODEL_COORDINATE_SYSTEM, GPU_MODEL_DIAGNOSTIC_LIMITS, GPU_MODEL_DOCUMENT_LIMITS, GPU_MODEL_DOCUMENT_SCHEMA_VERSION, GPU_MODEL_REPAIR_RULES, GPU_MODEL_RESOURCE_GRAPH_LIMITS, GPU_MODEL_RESOURCE_GRAPH_SCHEMA_VERSION, GPU_MODEL_RESOURCE_VERIFICATION_LIMITS, GPU_MODEL_STATIC_DEMO_FEATURE_FLAG, GPU_MODEL_STATIC_DEMO_LIMITS, GPU_MODEL_STATIC_DEMO_MAX_ABSOLUTE_COORDINATE_METRES, GPU_MODEL_STATIC_DEMO_MAX_DIAGONAL_METRES, GPU_MODEL_STATIC_DEMO_MAX_EXTENT_METRES, GPU_MODEL_STATIC_DEMO_NORMALIZATION_CONTRACT, GPU_MODEL_STATIC_DEMO_PROFILE_VERSION, type GpuModelAccessor, type GpuModelAccessorComponentType, type GpuModelAccessorElementType, type GpuModelAlphaMode, type GpuModelAnalyticGeometry, type GpuModelAnimation, type GpuModelAnimationChannel, type GpuModelAnimationInterpolation, type GpuModelAnimationSampler, type GpuModelAnimationTargetType, type GpuModelBlendShape, type GpuModelBlendShapeDelta, type GpuModelBounds, type GpuModelConversionDiagnostic, type GpuModelConversionIssue, type GpuModelConversionIssueBase, type GpuModelConversionLoss, type GpuModelConversionResourcePackage, type GpuModelConversionViolation, type GpuModelConversionWarning, type GpuModelDiagnostic, type GpuModelDiagnosticInput, type GpuModelDiagnosticMode, type GpuModelDiagnosticReport, type GpuModelDiagnosticSeverity, type GpuModelDiagnosticStandard, GpuModelDiagnosticsError, type GpuModelDocument, GpuModelDocumentError, type GpuModelDocumentErrorCode, type GpuModelJoint, type GpuModelMaterial, type GpuModelMaterialTextures, type GpuModelMaterialWorkflow, type GpuModelMatrix4, type GpuModelMesh, type GpuModelMetadata, type GpuModelMetadataValue, type GpuModelNode, type GpuModelPrimitive, type GpuModelPrimitiveAttribute, type GpuModelPrimitiveTopology, type GpuModelProvenance, type GpuModelRepairRecord, type GpuModelResource, type GpuModelResourceBinding, type GpuModelResourceGraph, GpuModelResourceGraphError, type GpuModelResourceGraphInput, type GpuModelResourceGraphKind, type GpuModelResourceGraphNode, type GpuModelResourceInspection, type GpuModelResourceKind, type GpuModelResourceLocation, type GpuModelResourceReference, type GpuModelResourceVerificationContext, type GpuModelResourceVerificationLimits, type GpuModelResourceVerificationOptions, type GpuModelResourceVerificationPort, type GpuModelSkeleton, type GpuModelSkin, type GpuModelSourceMetadata, type GpuModelSourceUnit, type GpuModelStaticDemoCompilerInput, type GpuModelStaticDemoCompilerOptions, type GpuModelStaticDemoLimits, type GpuModelStaticDemoMaterial, type GpuModelStaticDemoSourceEvidence, type GpuModelStaticDemoWorldTriangle, type GpuModelTexture, type GpuModelTextureBinding, type GpuModelTextureColorSpace, type GpuModelTextureEmbeddingPolicy, type GpuModelTextureSampler, type GpuModelTextureTransform, type GpuModelTextureUsage, type GpuModelTextureWrap, type GpuModelTransformTrs, type GpuModelTriangleVec3, type GpuModelUnsupportedData, type GpuModelVec2, type GpuModelVec3, type GpuModelVec4, type GpuModelVertexWeightSet, assertGpuModelStaticDemoNormalization, canCreateGpuModelDocument, createAndVerifyGpuModelDocument, createGpuModelDocument, createGpuModelResourceGraph, createGpuModelStaticDemoCompilerInput, encodeGpuModelDocumentCanonical, evaluateGpuModelDiagnostics, gpuModelResourceKey, hashGpuModelDocumentCanonical, isGpuModelDocument, isGpuModelResourceGraph, packageBootstrap, packageName, verifyGpuModelResource };
+export { type AdapterCapabilityMetadata, CANONICAL_GPU_MODEL_COORDINATE_SYSTEM, type ExportOptions, GPU_MODEL_DIAGNOSTIC_LIMITS, GPU_MODEL_DOCUMENT_LIMITS, GPU_MODEL_DOCUMENT_SCHEMA_VERSION, GPU_MODEL_REPAIR_RULES, GPU_MODEL_RESOURCE_GRAPH_LIMITS, GPU_MODEL_RESOURCE_GRAPH_SCHEMA_VERSION, GPU_MODEL_RESOURCE_VERIFICATION_LIMITS, GPU_MODEL_STATIC_DEMO_FEATURE_FLAG, GPU_MODEL_STATIC_DEMO_LIMITS, GPU_MODEL_STATIC_DEMO_MAX_ABSOLUTE_COORDINATE_METRES, GPU_MODEL_STATIC_DEMO_MAX_DIAGONAL_METRES, GPU_MODEL_STATIC_DEMO_MAX_EXTENT_METRES, GPU_MODEL_STATIC_DEMO_NORMALIZATION_CONTRACT, GPU_MODEL_STATIC_DEMO_PROFILE_VERSION, type GpuModelAccessor, type GpuModelAccessorComponentType, type GpuModelAccessorElementType, type GpuModelAlphaMode, type GpuModelAnalyticGeometry, type GpuModelAnimation, type GpuModelAnimationChannel, type GpuModelAnimationInterpolation, type GpuModelAnimationSampler, type GpuModelAnimationTargetType, type GpuModelBlendShape, type GpuModelBlendShapeDelta, type GpuModelBounds, type GpuModelConversionDiagnostic, type GpuModelConversionIssue, type GpuModelConversionIssueBase, type GpuModelConversionLoss, type GpuModelConversionResourcePackage, type GpuModelConversionViolation, type GpuModelConversionWarning, type GpuModelDiagnostic, type GpuModelDiagnosticInput, type GpuModelDiagnosticMode, type GpuModelDiagnosticReport, type GpuModelDiagnosticSeverity, type GpuModelDiagnosticStandard, GpuModelDiagnosticsError, type GpuModelDocument, GpuModelDocumentError, type GpuModelDocumentErrorCode, type GpuModelJoint, type GpuModelMaterial, type GpuModelMaterialTextures, type GpuModelMaterialWorkflow, type GpuModelMatrix4, type GpuModelMesh, type GpuModelMetadata, type GpuModelMetadataValue, type GpuModelNode, type GpuModelPrimitive, type GpuModelPrimitiveAttribute, type GpuModelPrimitiveTopology, type GpuModelProvenance, type GpuModelRepairRecord, type GpuModelResource, type GpuModelResourceBinding, type GpuModelResourceGraph, GpuModelResourceGraphError, type GpuModelResourceGraphInput, type GpuModelResourceGraphKind, type GpuModelResourceGraphNode, type GpuModelResourceInspection, type GpuModelResourceKind, type GpuModelResourceLocation, type GpuModelResourceReference, type GpuModelResourceVerificationContext, type GpuModelResourceVerificationLimits, type GpuModelResourceVerificationOptions, type GpuModelResourceVerificationPort, type GpuModelSkeleton, type GpuModelSkin, type GpuModelSourceMetadata, type GpuModelSourceUnit, type GpuModelStaticDemoCompilerInput, type GpuModelStaticDemoCompilerOptions, type GpuModelStaticDemoLimits, type GpuModelStaticDemoMaterial, type GpuModelStaticDemoSourceEvidence, type GpuModelStaticDemoWorldTriangle, type GpuModelTexture, type GpuModelTextureBinding, type GpuModelTextureColorSpace, type GpuModelTextureEmbeddingPolicy, type GpuModelTextureSampler, type GpuModelTextureTransform, type GpuModelTextureUsage, type GpuModelTextureWrap, type GpuModelTransformTrs, type GpuModelTriangleVec3, type GpuModelUnsupportedData, type GpuModelVec2, type GpuModelVec3, type GpuModelVec4, type GpuModelVertexWeightSet, type InspectOptions, type LoadOptions, MODEL_REGISTRY_LIMITS, type ModelAdapter, type ModelConversionRegistry, type ModelConversionRequest, type ModelConversionStage, type ModelExportResult, type ModelInspectResult, type ModelLoadResult, type ModelOperationOptions, type ModelProvenance, type ModelReadableStream, ModelRegistryError, type ModelRegistryErrorCode, type ModelRegistryResult, type ModelResultBase, type ModelSource, type ModelTarget, type ModelValidateResult, type ModelWritableStream, type RepairMode, type ResourcePackageManifest, type ValidateOptions, assertGpuModelStaticDemoNormalization, canCreateGpuModelDocument, createAndVerifyGpuModelDocument, createGpuModelDocument, createGpuModelResourceGraph, createGpuModelStaticDemoCompilerInput, createModelConversionRegistry, createModelResultBase, encodeGpuModelDocumentCanonical, evaluateGpuModelDiagnostics, gpuModelResourceKey, hashGpuModelDocumentCanonical, isGpuModelDocument, isGpuModelResourceGraph, packageBootstrap, packageName, verifyGpuModelResource };

package/dist/index.d.ts

@@ -733,6 +733,197 @@ declare function isGpuModelResourceGraph(value: unknown): value is GpuModelResou
  */
 declare function createGpuModelResourceGraph(document: unknown, input: unknown): GpuModelResourceGraph;
 
+/** Inert provenance hints. Never put credentials or signed URLs in this metadata. */
+interface ModelProvenance {
+    readonly sourceId?: string;
+    readonly sourceSystem?: string;
+    readonly acquiredAt?: string;
+    readonly licenseHint?: string;
+}
+interface SourceHints {
+    readonly mimeTypeHint?: string;
+    readonly fileNameHint?: string;
+    readonly provenance?: ModelProvenance;
+}
+/** Node Readable streams implement AsyncIterable; no Node types enter browser declarations. */
+type ModelReadableStream = ReadableStream<Uint8Array> | AsyncIterable<Uint8Array>;
+/** Portable subset also implemented by Node Writable streams. */
+type ModelWritableStream = WritableStream<Uint8Array> | {
+    write(chunk: Uint8Array): boolean;
+    end(): unknown;
+};
+/** Declarative IO; the injected adapter/runtime owns resolution and authorization. */
+type ModelSource = SourceHints & ({
+    readonly kind: "file-path";
+    readonly path: string;
+} | {
+    readonly kind: "url";
+    readonly url: string;
+    readonly headers?: Readonly<Record<string, string>>;
+} | {
+    readonly kind: "blob-storage-url";
+    readonly url: string;
+    readonly credentialMode?: "anonymous" | "signed" | "runtime-resolved";
+} | {
+    readonly kind: "blob";
+    readonly blob: Blob;
+} | {
+    readonly kind: "array-buffer";
+    readonly bytes: ArrayBuffer;
+} | {
+    readonly kind: "uint8-array";
+    readonly bytes: Uint8Array;
+} | {
+    readonly kind: "stream";
+    readonly stream: ModelReadableStream;
+    readonly byteLengthHint?: number;
+});
+/** Each call selects exactly one output destination. */
+type ModelTarget = {
+    readonly kind: "file-path";
+    readonly path: string;
+    readonly overwrite?: boolean;
+} | {
+    readonly kind: "blob-storage-url";
+    readonly url: string;
+    readonly overwrite?: boolean;
+    readonly contentType?: string;
+    readonly metadata?: Readonly<Record<string, string>>;
+} | {
+    readonly kind: "blob";
+    readonly mimeType?: string;
+    readonly fileName?: string;
+} | {
+    readonly kind: "array-buffer";
+} | {
+    readonly kind: "uint8-array";
+} | {
+    readonly kind: "stream";
+    readonly stream: ModelWritableStream;
+    readonly contentType?: string;
+} | {
+    readonly kind: "package";
+    readonly packageFormat: "zip" | "tar" | "directory-manifest";
+    readonly destinationHint?: string;
+    readonly includeSourcePayload?: boolean;
+};
+type RepairMode = GpuModelDiagnosticMode;
+/** Caller policy is authoritative; cancellation/deadline apply to the whole conversion. */
+interface ModelOperationOptions {
+    readonly mode?: RepairMode;
+    readonly allowLoss?: boolean;
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+}
+type InspectOptions = ModelOperationOptions;
+type LoadOptions = ModelOperationOptions;
+type ExportOptions = ModelOperationOptions;
+type ValidateOptions = ModelOperationOptions;
+interface AdapterCapabilityMetadata {
+    readonly formatId: string;
+    readonly displayName: string;
+    readonly supportedSourceKinds: readonly ModelSource["kind"][];
+    readonly supportedTargetKinds: readonly ModelTarget["kind"][];
+    readonly supportsAnimations: boolean;
+    readonly supportsSkins: boolean;
+    readonly supportsAnalyticGeometry: boolean;
+}
+/** Packaging descriptors are not proof of exported bytes or asset promotion. */
+interface ResourcePackageManifest {
+    readonly format: "zip" | "tar" | "directory-manifest" | "inline";
+    readonly entries: readonly {
+        readonly id: string;
+        readonly role: "mesh" | "material" | "texture" | "animation" | "auxiliary";
+        readonly path: string;
+        readonly contentType?: string;
+    }[];
+}
+/** Construct through createModelResultBase; derived fields cannot disagree with the report. */
+interface ModelResultBase {
+    readonly report: GpuModelDiagnosticReport;
+    readonly diagnostics: readonly GpuModelConversionDiagnostic[];
+    readonly warnings: readonly GpuModelConversionDiagnostic[];
+    readonly repairs: readonly GpuModelRepairRecord[];
+    readonly lossReports: GpuModelDiagnosticReport["losses"];
+}
+interface ModelInspectResult extends ModelResultBase {
+    readonly detectedFormat?: string;
+    readonly capabilities: AdapterCapabilityMetadata;
+}
+interface ModelLoadResult extends ModelResultBase {
+    readonly document?: GpuModelDocument;
+    readonly resourcePackage?: ResourcePackageManifest;
+}
+interface ModelExportResult extends ModelResultBase {
+    readonly target: ModelTarget["kind"];
+    readonly resourcePackage?: ResourcePackageManifest;
+    readonly output?: Blob | ArrayBuffer | Uint8Array;
+}
+interface ModelValidateResult extends ModelResultBase {
+    readonly valid: boolean;
+}
+/** Trusted injected adapter: stage writes and enforce policy before committing output. */
+interface ModelAdapter {
+    readonly metadata: AdapterCapabilityMetadata;
+    inspect(source: ModelSource, options?: InspectOptions): Promise<ModelInspectResult>;
+    load(source: ModelSource, options?: LoadOptions): Promise<ModelLoadResult>;
+    export(document: GpuModelDocument, target: ModelTarget, options?: ExportOptions): Promise<ModelExportResult>;
+    validate(input: ModelSource | GpuModelDocument, options?: ValidateOptions): Promise<ModelValidateResult>;
+}
+interface ModelConversionStage {
+    readonly formatId: string;
+    readonly operation: "inspect" | "load" | "capabilities" | "validate" | "export";
+    readonly report: GpuModelDiagnosticReport;
+}
+/** No source/target descriptors or exception causes are retained in a ledger. */
+interface ModelRegistryResult {
+    readonly accepted: boolean;
+    readonly stages: readonly ModelConversionStage[];
+    readonly diagnostics: readonly GpuModelConversionDiagnostic[];
+    readonly warnings: readonly GpuModelConversionDiagnostic[];
+    readonly repairs: readonly GpuModelRepairRecord[];
+    readonly lossReports: GpuModelDiagnosticReport["losses"];
+    readonly document?: GpuModelDocument;
+    readonly inspection?: ModelInspectResult;
+    readonly resourcePackage?: ResourcePackageManifest;
+    readonly exported?: ModelExportResult;
+}
+interface ModelConversionRequest {
+    readonly sourceFormat: string;
+    readonly targetFormat: string;
+    readonly source: ModelSource;
+    readonly target: ModelTarget;
+}
+interface ModelConversionRegistry {
+    readonly capabilities: readonly AdapterCapabilityMetadata[];
+    inspect(format: string, source: ModelSource, options?: InspectOptions): Promise<ModelRegistryResult>;
+    load(format: string, source: ModelSource, options?: LoadOptions): Promise<ModelRegistryResult>;
+    validate(format: string, input: ModelSource | GpuModelDocument, options?: ValidateOptions): Promise<ModelRegistryResult>;
+    export(format: string, document: GpuModelDocument, target: ModelTarget, options?: ExportOptions): Promise<ModelRegistryResult>;
+    convert(request: ModelConversionRequest, options?: ModelOperationOptions): Promise<ModelRegistryResult>;
+}
+declare const MODEL_REGISTRY_LIMITS: Readonly<{
+    adapters: 128;
+    concurrent: 8;
+    timeoutMs: 30000;
+    maxTimeoutMs: 300000;
+    string: 4096;
+    mapEntries: 64;
+    manifestEntries: 4096;
+    memoryBytes: number;
+}>;
+type ModelRegistryErrorCode = "invalid-input" | "invalid-adapter" | "duplicate-format" | "unsupported-format" | "unsupported-source" | "unsupported-target" | "invalid-result" | "adapter-failed" | "aborted" | "deadline-exceeded" | "capacity-exceeded";
+declare class ModelRegistryError extends TypeError {
+    readonly code: ModelRegistryErrorCode;
+    constructor(code: ModelRegistryErrorCode);
+}
+/** Evaluates, copies and freezes bounded adapter evidence using the core repair policy. */
+declare function createModelResultBase(input: GpuModelDiagnosticInput): ModelResultBase;
+/** Creates an immutable fixed registry. No global discovery, format sniffing or IO. */
+declare function createModelConversionRegistry(adapters: readonly ModelAdapter[], limits?: {
+    readonly maxConcurrent?: number;
+}): ModelConversionRegistry;
+
 /** Package identity and rollout metadata for the initial repository baseline. */
 declare const packageName: "@plasius/gpu-model-core";
 declare const packageBootstrap: Readonly<{
@@ -741,4 +932,4 @@ declare const packageBootstrap: Readonly<{
     readonly status: "bootstrap";
 }>;
 
-export { CANONICAL_GPU_MODEL_COORDINATE_SYSTEM, GPU_MODEL_DIAGNOSTIC_LIMITS, GPU_MODEL_DOCUMENT_LIMITS, GPU_MODEL_DOCUMENT_SCHEMA_VERSION, GPU_MODEL_REPAIR_RULES, GPU_MODEL_RESOURCE_GRAPH_LIMITS, GPU_MODEL_RESOURCE_GRAPH_SCHEMA_VERSION, GPU_MODEL_RESOURCE_VERIFICATION_LIMITS, GPU_MODEL_STATIC_DEMO_FEATURE_FLAG, GPU_MODEL_STATIC_DEMO_LIMITS, GPU_MODEL_STATIC_DEMO_MAX_ABSOLUTE_COORDINATE_METRES, GPU_MODEL_STATIC_DEMO_MAX_DIAGONAL_METRES, GPU_MODEL_STATIC_DEMO_MAX_EXTENT_METRES, GPU_MODEL_STATIC_DEMO_NORMALIZATION_CONTRACT, GPU_MODEL_STATIC_DEMO_PROFILE_VERSION, type GpuModelAccessor, type GpuModelAccessorComponentType, type GpuModelAccessorElementType, type GpuModelAlphaMode, type GpuModelAnalyticGeometry, type GpuModelAnimation, type GpuModelAnimationChannel, type GpuModelAnimationInterpolation, type GpuModelAnimationSampler, type GpuModelAnimationTargetType, type GpuModelBlendShape, type GpuModelBlendShapeDelta, type GpuModelBounds, type GpuModelConversionDiagnostic, type GpuModelConversionIssue, type GpuModelConversionIssueBase, type GpuModelConversionLoss, type GpuModelConversionResourcePackage, type GpuModelConversionViolation, type GpuModelConversionWarning, type GpuModelDiagnostic, type GpuModelDiagnosticInput, type GpuModelDiagnosticMode, type GpuModelDiagnosticReport, type GpuModelDiagnosticSeverity, type GpuModelDiagnosticStandard, GpuModelDiagnosticsError, type GpuModelDocument, GpuModelDocumentError, type GpuModelDocumentErrorCode, type GpuModelJoint, type GpuModelMaterial, type GpuModelMaterialTextures, type GpuModelMaterialWorkflow, type GpuModelMatrix4, type GpuModelMesh, type GpuModelMetadata, type GpuModelMetadataValue, type GpuModelNode, type GpuModelPrimitive, type GpuModelPrimitiveAttribute, type GpuModelPrimitiveTopology, type GpuModelProvenance, type GpuModelRepairRecord, type GpuModelResource, type GpuModelResourceBinding, type GpuModelResourceGraph, GpuModelResourceGraphError, type GpuModelResourceGraphInput, type GpuModelResourceGraphKind, type GpuModelResourceGraphNode, type GpuModelResourceInspection, type GpuModelResourceKind, type GpuModelResourceLocation, type GpuModelResourceReference, type GpuModelResourceVerificationContext, type GpuModelResourceVerificationLimits, type GpuModelResourceVerificationOptions, type GpuModelResourceVerificationPort, type GpuModelSkeleton, type GpuModelSkin, type GpuModelSourceMetadata, type GpuModelSourceUnit, type GpuModelStaticDemoCompilerInput, type GpuModelStaticDemoCompilerOptions, type GpuModelStaticDemoLimits, type GpuModelStaticDemoMaterial, type GpuModelStaticDemoSourceEvidence, type GpuModelStaticDemoWorldTriangle, type GpuModelTexture, type GpuModelTextureBinding, type GpuModelTextureColorSpace, type GpuModelTextureEmbeddingPolicy, type GpuModelTextureSampler, type GpuModelTextureTransform, type GpuModelTextureUsage, type GpuModelTextureWrap, type GpuModelTransformTrs, type GpuModelTriangleVec3, type GpuModelUnsupportedData, type GpuModelVec2, type GpuModelVec3, type GpuModelVec4, type GpuModelVertexWeightSet, assertGpuModelStaticDemoNormalization, canCreateGpuModelDocument, createAndVerifyGpuModelDocument, createGpuModelDocument, createGpuModelResourceGraph, createGpuModelStaticDemoCompilerInput, encodeGpuModelDocumentCanonical, evaluateGpuModelDiagnostics, gpuModelResourceKey, hashGpuModelDocumentCanonical, isGpuModelDocument, isGpuModelResourceGraph, packageBootstrap, packageName, verifyGpuModelResource };
+export { type AdapterCapabilityMetadata, CANONICAL_GPU_MODEL_COORDINATE_SYSTEM, type ExportOptions, GPU_MODEL_DIAGNOSTIC_LIMITS, GPU_MODEL_DOCUMENT_LIMITS, GPU_MODEL_DOCUMENT_SCHEMA_VERSION, GPU_MODEL_REPAIR_RULES, GPU_MODEL_RESOURCE_GRAPH_LIMITS, GPU_MODEL_RESOURCE_GRAPH_SCHEMA_VERSION, GPU_MODEL_RESOURCE_VERIFICATION_LIMITS, GPU_MODEL_STATIC_DEMO_FEATURE_FLAG, GPU_MODEL_STATIC_DEMO_LIMITS, GPU_MODEL_STATIC_DEMO_MAX_ABSOLUTE_COORDINATE_METRES, GPU_MODEL_STATIC_DEMO_MAX_DIAGONAL_METRES, GPU_MODEL_STATIC_DEMO_MAX_EXTENT_METRES, GPU_MODEL_STATIC_DEMO_NORMALIZATION_CONTRACT, GPU_MODEL_STATIC_DEMO_PROFILE_VERSION, type GpuModelAccessor, type GpuModelAccessorComponentType, type GpuModelAccessorElementType, type GpuModelAlphaMode, type GpuModelAnalyticGeometry, type GpuModelAnimation, type GpuModelAnimationChannel, type GpuModelAnimationInterpolation, type GpuModelAnimationSampler, type GpuModelAnimationTargetType, type GpuModelBlendShape, type GpuModelBlendShapeDelta, type GpuModelBounds, type GpuModelConversionDiagnostic, type GpuModelConversionIssue, type GpuModelConversionIssueBase, type GpuModelConversionLoss, type GpuModelConversionResourcePackage, type GpuModelConversionViolation, type GpuModelConversionWarning, type GpuModelDiagnostic, type GpuModelDiagnosticInput, type GpuModelDiagnosticMode, type GpuModelDiagnosticReport, type GpuModelDiagnosticSeverity, type GpuModelDiagnosticStandard, GpuModelDiagnosticsError, type GpuModelDocument, GpuModelDocumentError, type GpuModelDocumentErrorCode, type GpuModelJoint, type GpuModelMaterial, type GpuModelMaterialTextures, type GpuModelMaterialWorkflow, type GpuModelMatrix4, type GpuModelMesh, type GpuModelMetadata, type GpuModelMetadataValue, type GpuModelNode, type GpuModelPrimitive, type GpuModelPrimitiveAttribute, type GpuModelPrimitiveTopology, type GpuModelProvenance, type GpuModelRepairRecord, type GpuModelResource, type GpuModelResourceBinding, type GpuModelResourceGraph, GpuModelResourceGraphError, type GpuModelResourceGraphInput, type GpuModelResourceGraphKind, type GpuModelResourceGraphNode, type GpuModelResourceInspection, type GpuModelResourceKind, type GpuModelResourceLocation, type GpuModelResourceReference, type GpuModelResourceVerificationContext, type GpuModelResourceVerificationLimits, type GpuModelResourceVerificationOptions, type GpuModelResourceVerificationPort, type GpuModelSkeleton, type GpuModelSkin, type GpuModelSourceMetadata, type GpuModelSourceUnit, type GpuModelStaticDemoCompilerInput, type GpuModelStaticDemoCompilerOptions, type GpuModelStaticDemoLimits, type GpuModelStaticDemoMaterial, type GpuModelStaticDemoSourceEvidence, type GpuModelStaticDemoWorldTriangle, type GpuModelTexture, type GpuModelTextureBinding, type GpuModelTextureColorSpace, type GpuModelTextureEmbeddingPolicy, type GpuModelTextureSampler, type GpuModelTextureTransform, type GpuModelTextureUsage, type GpuModelTextureWrap, type GpuModelTransformTrs, type GpuModelTriangleVec3, type GpuModelUnsupportedData, type GpuModelVec2, type GpuModelVec3, type GpuModelVec4, type GpuModelVertexWeightSet, type InspectOptions, type LoadOptions, MODEL_REGISTRY_LIMITS, type ModelAdapter, type ModelConversionRegistry, type ModelConversionRequest, type ModelConversionStage, type ModelExportResult, type ModelInspectResult, type ModelLoadResult, type ModelOperationOptions, type ModelProvenance, type ModelReadableStream, ModelRegistryError, type ModelRegistryErrorCode, type ModelRegistryResult, type ModelResultBase, type ModelSource, type ModelTarget, type ModelValidateResult, type ModelWritableStream, type RepairMode, type ResourcePackageManifest, type ValidateOptions, assertGpuModelStaticDemoNormalization, canCreateGpuModelDocument, createAndVerifyGpuModelDocument, createGpuModelDocument, createGpuModelResourceGraph, createGpuModelStaticDemoCompilerInput, createModelConversionRegistry, createModelResultBase, encodeGpuModelDocumentCanonical, evaluateGpuModelDiagnostics, gpuModelResourceKey, hashGpuModelDocumentCanonical, isGpuModelDocument, isGpuModelResourceGraph, packageBootstrap, packageName, verifyGpuModelResource };