@plasius/gpu-model-core 0.2.0 → 0.4.0

package/dist/index.d.cts

@@ -645,6 +645,285 @@ interface GpuModelDiagnosticReport {
  */
 declare function evaluateGpuModelDiagnostics(value: unknown): GpuModelDiagnosticReport;
 
+/** Fixed work ceilings for one resource graph; callers cannot raise them. */
+declare const GPU_MODEL_RESOURCE_GRAPH_LIMITS: Readonly<{
+    nodes: 65536;
+    edges: 262144;
+    packages: 256;
+    pathLength: 1024;
+}>;
+/** Versioned graph schema, independent of any adapter or renderer. */
+declare const GPU_MODEL_RESOURCE_GRAPH_SCHEMA_VERSION: "plasius.gpu-model-resource-graph/1";
+declare const KINDS: readonly ["resource", "accessor", "texture", "material", "skeleton", "skin", "animation", "provenance", "package"];
+/** Logical namespaces; content hashes remain on the verified byte resources. */
+type GpuModelResourceGraphKind = typeof KINDS[number];
+/** An explicit logical reference within a single canonical document/graph. */
+interface GpuModelResourceReference {
+    readonly kind: GpuModelResourceGraphKind;
+    readonly id: string;
+}
+/** Source location metadata only; external paths never grant I/O permission. */
+type GpuModelResourceLocation = {
+    readonly kind: "embedded";
+} | {
+    readonly kind: "external";
+    readonly relativePath: string;
+};
+/** Exactly one descriptor is required per verified document resource. */
+interface GpuModelResourceBinding {
+    readonly resourceId: string;
+    readonly location: GpuModelResourceLocation;
+    readonly exportEmbeddingPolicy: GpuModelTextureEmbeddingPolicy;
+}
+/** Conversion package membership; not an asset promotion or archive-writing contract. */
+interface GpuModelConversionResourcePackage {
+    readonly id: string;
+    readonly members: readonly GpuModelResourceReference[];
+}
+/** Raw descriptors are validated at construction, including nested properties. */
+interface GpuModelResourceGraphInput {
+    readonly resources: readonly GpuModelResourceBinding[];
+    readonly packages: readonly GpuModelConversionResourcePackage[];
+}
+interface NodeValues {
+    resource: {
+        readonly resource: GpuModelResource;
+        readonly location: GpuModelResourceLocation;
+        readonly exportEmbeddingPolicy: GpuModelTextureEmbeddingPolicy;
+    };
+    accessor: GpuModelAccessor;
+    texture: GpuModelTexture;
+    material: GpuModelMaterial;
+    skeleton: {
+        readonly skeleton: GpuModelSkeleton;
+        readonly joints: readonly GpuModelJoint[];
+    };
+    skin: GpuModelSkin;
+    animation: GpuModelAnimation;
+    provenance: GpuModelProvenance;
+    package: GpuModelConversionResourcePackage;
+}
+/** Discriminated immutable node; dependencies use canonical tuple keys. */
+type GpuModelResourceGraphNode = {
+    [K in GpuModelResourceGraphKind]: {
+        readonly kind: K;
+        readonly id: string;
+        readonly key: string;
+        readonly value: NodeValues[K];
+        readonly dependencies: readonly string[];
+    };
+}[GpuModelResourceGraphKind];
+/** Validated dependency DAG. Canonical payload arrays retain their semantic order. */
+interface GpuModelResourceGraph {
+    readonly schemaVersion: typeof GPU_MODEL_RESOURCE_GRAPH_SCHEMA_VERSION;
+    readonly nodes: readonly GpuModelResourceGraphNode[];
+}
+/** Fixed, value-free errors suitable for worker or adapter diagnostics. */
+declare class GpuModelResourceGraphError extends TypeError {
+    readonly code: "invalid-value" | "limit-exceeded" | "unverified-document" | "duplicate-reference" | "missing-reference" | "graph-cycle";
+    constructor(code: "invalid-value" | "limit-exceeded" | "unverified-document" | "duplicate-reference" | "missing-reference" | "graph-cycle");
+}
+/** Collision-free stable logical key; identifiers use the canonical v1 grammar. */
+declare function gpuModelResourceKey(kind: GpuModelResourceGraphKind, id: string): string;
+/** Narrows only graphs created in this package instance; clones are untrusted. */
+declare function isGpuModelResourceGraph(value: unknown): value is GpuModelResourceGraph;
+/**
+ * Project verified canonical content and explicit package descriptors into a DAG.
+ * No file/network resolution, hash calculation or exporter execution occurs here.
+ */
+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<{
@@ -653,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_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 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 GpuModelResourceInspection, type GpuModelResourceKind, 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, createGpuModelStaticDemoCompilerInput, encodeGpuModelDocumentCanonical, evaluateGpuModelDiagnostics, hashGpuModelDocumentCanonical, isGpuModelDocument, 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

@@ -645,6 +645,285 @@ interface GpuModelDiagnosticReport {
  */
 declare function evaluateGpuModelDiagnostics(value: unknown): GpuModelDiagnosticReport;
 
+/** Fixed work ceilings for one resource graph; callers cannot raise them. */
+declare const GPU_MODEL_RESOURCE_GRAPH_LIMITS: Readonly<{
+    nodes: 65536;
+    edges: 262144;
+    packages: 256;
+    pathLength: 1024;
+}>;
+/** Versioned graph schema, independent of any adapter or renderer. */
+declare const GPU_MODEL_RESOURCE_GRAPH_SCHEMA_VERSION: "plasius.gpu-model-resource-graph/1";
+declare const KINDS: readonly ["resource", "accessor", "texture", "material", "skeleton", "skin", "animation", "provenance", "package"];
+/** Logical namespaces; content hashes remain on the verified byte resources. */
+type GpuModelResourceGraphKind = typeof KINDS[number];
+/** An explicit logical reference within a single canonical document/graph. */
+interface GpuModelResourceReference {
+    readonly kind: GpuModelResourceGraphKind;
+    readonly id: string;
+}
+/** Source location metadata only; external paths never grant I/O permission. */
+type GpuModelResourceLocation = {
+    readonly kind: "embedded";
+} | {
+    readonly kind: "external";
+    readonly relativePath: string;
+};
+/** Exactly one descriptor is required per verified document resource. */
+interface GpuModelResourceBinding {
+    readonly resourceId: string;
+    readonly location: GpuModelResourceLocation;
+    readonly exportEmbeddingPolicy: GpuModelTextureEmbeddingPolicy;
+}
+/** Conversion package membership; not an asset promotion or archive-writing contract. */
+interface GpuModelConversionResourcePackage {
+    readonly id: string;
+    readonly members: readonly GpuModelResourceReference[];
+}
+/** Raw descriptors are validated at construction, including nested properties. */
+interface GpuModelResourceGraphInput {
+    readonly resources: readonly GpuModelResourceBinding[];
+    readonly packages: readonly GpuModelConversionResourcePackage[];
+}
+interface NodeValues {
+    resource: {
+        readonly resource: GpuModelResource;
+        readonly location: GpuModelResourceLocation;
+        readonly exportEmbeddingPolicy: GpuModelTextureEmbeddingPolicy;
+    };
+    accessor: GpuModelAccessor;
+    texture: GpuModelTexture;
+    material: GpuModelMaterial;
+    skeleton: {
+        readonly skeleton: GpuModelSkeleton;
+        readonly joints: readonly GpuModelJoint[];
+    };
+    skin: GpuModelSkin;
+    animation: GpuModelAnimation;
+    provenance: GpuModelProvenance;
+    package: GpuModelConversionResourcePackage;
+}
+/** Discriminated immutable node; dependencies use canonical tuple keys. */
+type GpuModelResourceGraphNode = {
+    [K in GpuModelResourceGraphKind]: {
+        readonly kind: K;
+        readonly id: string;
+        readonly key: string;
+        readonly value: NodeValues[K];
+        readonly dependencies: readonly string[];
+    };
+}[GpuModelResourceGraphKind];
+/** Validated dependency DAG. Canonical payload arrays retain their semantic order. */
+interface GpuModelResourceGraph {
+    readonly schemaVersion: typeof GPU_MODEL_RESOURCE_GRAPH_SCHEMA_VERSION;
+    readonly nodes: readonly GpuModelResourceGraphNode[];
+}
+/** Fixed, value-free errors suitable for worker or adapter diagnostics. */
+declare class GpuModelResourceGraphError extends TypeError {
+    readonly code: "invalid-value" | "limit-exceeded" | "unverified-document" | "duplicate-reference" | "missing-reference" | "graph-cycle";
+    constructor(code: "invalid-value" | "limit-exceeded" | "unverified-document" | "duplicate-reference" | "missing-reference" | "graph-cycle");
+}
+/** Collision-free stable logical key; identifiers use the canonical v1 grammar. */
+declare function gpuModelResourceKey(kind: GpuModelResourceGraphKind, id: string): string;
+/** Narrows only graphs created in this package instance; clones are untrusted. */
+declare function isGpuModelResourceGraph(value: unknown): value is GpuModelResourceGraph;
+/**
+ * Project verified canonical content and explicit package descriptors into a DAG.
+ * No file/network resolution, hash calculation or exporter execution occurs here.
+ */
+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<{
@@ -653,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_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 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 GpuModelResourceInspection, type GpuModelResourceKind, 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, createGpuModelStaticDemoCompilerInput, encodeGpuModelDocumentCanonical, evaluateGpuModelDiagnostics, hashGpuModelDocumentCanonical, isGpuModelDocument, 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 };