@plasius/gpu-model-core 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -495,6 +495,156 @@ declare function assertGpuModelStaticDemoNormalization(document: GpuModelDocumen
495
495
  */
496
496
  declare function createGpuModelStaticDemoCompilerInput(document: GpuModelDocument, options: GpuModelStaticDemoCompilerOptions): Promise<GpuModelStaticDemoCompilerInput>;
497
497
 
498
+ /** Supported policy modes; strict is always the default. */
499
+ type GpuModelDiagnosticMode = "strict" | "tolerant" | "forensic";
500
+ /** Adapter compliance profiles inherited from the canonical conversion policy. */
501
+ type GpuModelDiagnosticStandard = "gltf-glb" | "obj-mtl" | "fbx" | "cad-bim";
502
+ /** Stable repair definitions; format adapters apply and verify these actions. */
503
+ declare const GPU_MODEL_REPAIR_RULES: readonly Readonly<{
504
+ standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
505
+ id: "missing-normals";
506
+ action: "Generate deterministic vertex normals from validated triangle geometry.";
507
+ severity: "warning";
508
+ confidence: "high";
509
+ policy: "Generate deterministic vertex normals from validated triangle geometry and record the generation basis.";
510
+ } | {
511
+ standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
512
+ id: "bad-winding";
513
+ action: "Normalize winding to the adapter coordinate convention.";
514
+ severity: "warning";
515
+ confidence: "medium";
516
+ policy: "Normalize winding to the adapter coordinate convention and record the inferred orientation.";
517
+ } | {
518
+ standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
519
+ id: "invalid-indices";
520
+ action: "Drop the invalid primitive.";
521
+ severity: "error";
522
+ confidence: "medium";
523
+ policy: "Reject the invalid primitive or clamp only when the fixture and adapter policy explicitly prove a safe repair; retain the original index in the record.";
524
+ } | {
525
+ standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
526
+ id: "nan-transforms";
527
+ action: "Replace non-finite transform components with identity components.";
528
+ severity: "error";
529
+ confidence: "high";
530
+ policy: "Replace the non-finite component with the identity transform component and record the source value and fallback.";
531
+ } | {
532
+ standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
533
+ id: "non-normalized-weights";
534
+ action: "Normalize finite non-negative skin weights.";
535
+ severity: "warning";
536
+ confidence: "high";
537
+ policy: "Normalize finite, non-negative influences and record the pre-normalization weights and discarded influence policy.";
538
+ } | {
539
+ standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
540
+ id: "missing-texture-path";
541
+ action: "Leave the missing or unsafe texture slot unresolved.";
542
+ severity: "warning";
543
+ confidence: "low";
544
+ policy: "Resolve only an explicitly bounded package-relative fallback; otherwise keep the material slot unresolved and emit a visible warning.";
545
+ } | {
546
+ standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
547
+ id: "malformed-material-reference";
548
+ action: "Attach the canonical default material.";
549
+ severity: "error";
550
+ confidence: "medium";
551
+ policy: "Attach the canonical default material only when the target policy permits it and preserve the unresolved source reference.";
552
+ }>[];
553
+ /** Defensive ceilings for a complete report, including its source snapshots. */
554
+ declare const GPU_MODEL_DIAGNOSTIC_LIMITS: Readonly<{
555
+ readonly issues: 4096;
556
+ readonly values: 16384;
557
+ readonly depth: 12;
558
+ readonly members: 1024;
559
+ readonly string: 65536;
560
+ readonly bytes: 1048576;
561
+ }>;
562
+ /** An inert, bounded report was malformed; errors never echo caller values. */
563
+ declare class GpuModelDiagnosticsError extends TypeError {
564
+ constructor();
565
+ }
566
+ /** Common, path-addressable fields; callers must remove sensitive source text. */
567
+ interface GpuModelConversionIssueBase {
568
+ readonly code: string;
569
+ readonly path: string;
570
+ readonly message: string;
571
+ }
572
+ /** Adapter-reported standard violation, with explicit completed-repair evidence. */
573
+ interface GpuModelConversionViolation extends GpuModelConversionIssueBase {
574
+ readonly kind: "violation";
575
+ readonly ruleId: string;
576
+ readonly originalValue: GpuModelMetadataValue;
577
+ readonly repairApplied: boolean;
578
+ }
579
+ /** Unsupported source/target semantics are always blocking. */
580
+ interface GpuModelUnsupportedData extends GpuModelConversionIssueBase {
581
+ readonly kind: "unsupported";
582
+ }
583
+ /** An advisory that does not represent a standard violation or lost data. */
584
+ interface GpuModelConversionWarning extends GpuModelConversionIssueBase {
585
+ readonly kind: "warning";
586
+ }
587
+ /** Explicit source-fidelity loss, requiring caller consent even after repair. */
588
+ interface GpuModelConversionLoss extends GpuModelConversionIssueBase {
589
+ readonly kind: "loss";
590
+ readonly effect: "dropped" | "approximated";
591
+ }
592
+ /** Discriminated adapter input contract; unknown rule IDs remain blocking. */
593
+ type GpuModelConversionIssue = GpuModelConversionViolation | GpuModelUnsupportedData | GpuModelConversionWarning | GpuModelConversionLoss;
594
+ /** Typed construction contract; the evaluator also validates unknown input. */
595
+ interface GpuModelDiagnosticInput {
596
+ readonly standard: GpuModelDiagnosticStandard;
597
+ readonly mode?: GpuModelDiagnosticMode;
598
+ readonly allowLoss?: boolean;
599
+ readonly issues: readonly GpuModelConversionIssue[];
600
+ readonly rawSource?: GpuModelMetadataValue;
601
+ readonly maxEvidenceBytes?: number;
602
+ }
603
+ /** One verified report of an adapter-applied repair; never a repair request. */
604
+ interface GpuModelRepairRecord {
605
+ readonly ruleId: typeof GPU_MODEL_REPAIR_RULES[number]["id"];
606
+ readonly originalValue: GpuModelMetadataValue;
607
+ readonly action: string;
608
+ readonly severity: GpuModelDiagnosticSeverity;
609
+ readonly affectedPath: string;
610
+ readonly confidence: "high" | "medium" | "low";
611
+ }
612
+ /** Separate categories prevent warnings from disguising violations or loss. */
613
+ type GpuModelConversionDiagnostic = (GpuModelConversionIssueBase & {
614
+ readonly kind: "blocking-error";
615
+ readonly severity: "error";
616
+ readonly ruleId: string;
617
+ }) | (GpuModelConversionIssueBase & {
618
+ readonly kind: "repair";
619
+ readonly severity: GpuModelDiagnosticSeverity;
620
+ readonly ruleId: string;
621
+ }) | (GpuModelUnsupportedData & {
622
+ readonly severity: "error";
623
+ }) | (GpuModelConversionWarning & {
624
+ readonly severity: "warning";
625
+ }) | (GpuModelConversionLoss & {
626
+ readonly severity: "warning";
627
+ });
628
+ /** Immutable owned ledger. Acceptance validates reports, not repaired geometry. */
629
+ interface GpuModelDiagnosticReport {
630
+ readonly mode: GpuModelDiagnosticMode;
631
+ readonly standard: GpuModelDiagnosticStandard;
632
+ readonly accepted: boolean;
633
+ readonly diagnostics: readonly GpuModelConversionDiagnostic[];
634
+ readonly repairs: readonly GpuModelRepairRecord[];
635
+ readonly losses: readonly (GpuModelConversionLoss & {
636
+ readonly severity: "warning";
637
+ })[];
638
+ readonly rawSource?: GpuModelMetadataValue;
639
+ }
640
+ /**
641
+ * Validate a bounded inert adapter report and build an immutable conversion ledger.
642
+ * Strict rejects violations. Tolerant/forensic require explicit applied repairs.
643
+ * Callers must scrub source snapshots before supplying them and must not log them.
644
+ * Throws GpuModelDiagnosticsError for malformed or over-budget reports.
645
+ */
646
+ declare function evaluateGpuModelDiagnostics(value: unknown): GpuModelDiagnosticReport;
647
+
498
648
  /** Package identity and rollout metadata for the initial repository baseline. */
499
649
  declare const packageName: "@plasius/gpu-model-core";
500
650
  declare const packageBootstrap: Readonly<{
@@ -503,4 +653,4 @@ declare const packageBootstrap: Readonly<{
503
653
  readonly status: "bootstrap";
504
654
  }>;
505
655
 
506
- export { CANONICAL_GPU_MODEL_COORDINATE_SYSTEM, GPU_MODEL_DOCUMENT_LIMITS, GPU_MODEL_DOCUMENT_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 GpuModelDiagnostic, type GpuModelDiagnosticSeverity, 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 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 GpuModelVec2, type GpuModelVec3, type GpuModelVec4, type GpuModelVertexWeightSet, assertGpuModelStaticDemoNormalization, canCreateGpuModelDocument, createAndVerifyGpuModelDocument, createGpuModelDocument, createGpuModelStaticDemoCompilerInput, encodeGpuModelDocumentCanonical, hashGpuModelDocumentCanonical, isGpuModelDocument, packageBootstrap, packageName, verifyGpuModelResource };
656
+ 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 };
package/dist/index.d.ts CHANGED
@@ -495,6 +495,156 @@ declare function assertGpuModelStaticDemoNormalization(document: GpuModelDocumen
495
495
  */
496
496
  declare function createGpuModelStaticDemoCompilerInput(document: GpuModelDocument, options: GpuModelStaticDemoCompilerOptions): Promise<GpuModelStaticDemoCompilerInput>;
497
497
 
498
+ /** Supported policy modes; strict is always the default. */
499
+ type GpuModelDiagnosticMode = "strict" | "tolerant" | "forensic";
500
+ /** Adapter compliance profiles inherited from the canonical conversion policy. */
501
+ type GpuModelDiagnosticStandard = "gltf-glb" | "obj-mtl" | "fbx" | "cad-bim";
502
+ /** Stable repair definitions; format adapters apply and verify these actions. */
503
+ declare const GPU_MODEL_REPAIR_RULES: readonly Readonly<{
504
+ standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
505
+ id: "missing-normals";
506
+ action: "Generate deterministic vertex normals from validated triangle geometry.";
507
+ severity: "warning";
508
+ confidence: "high";
509
+ policy: "Generate deterministic vertex normals from validated triangle geometry and record the generation basis.";
510
+ } | {
511
+ standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
512
+ id: "bad-winding";
513
+ action: "Normalize winding to the adapter coordinate convention.";
514
+ severity: "warning";
515
+ confidence: "medium";
516
+ policy: "Normalize winding to the adapter coordinate convention and record the inferred orientation.";
517
+ } | {
518
+ standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
519
+ id: "invalid-indices";
520
+ action: "Drop the invalid primitive.";
521
+ severity: "error";
522
+ confidence: "medium";
523
+ policy: "Reject the invalid primitive or clamp only when the fixture and adapter policy explicitly prove a safe repair; retain the original index in the record.";
524
+ } | {
525
+ standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
526
+ id: "nan-transforms";
527
+ action: "Replace non-finite transform components with identity components.";
528
+ severity: "error";
529
+ confidence: "high";
530
+ policy: "Replace the non-finite component with the identity transform component and record the source value and fallback.";
531
+ } | {
532
+ standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
533
+ id: "non-normalized-weights";
534
+ action: "Normalize finite non-negative skin weights.";
535
+ severity: "warning";
536
+ confidence: "high";
537
+ policy: "Normalize finite, non-negative influences and record the pre-normalization weights and discarded influence policy.";
538
+ } | {
539
+ standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
540
+ id: "missing-texture-path";
541
+ action: "Leave the missing or unsafe texture slot unresolved.";
542
+ severity: "warning";
543
+ confidence: "low";
544
+ policy: "Resolve only an explicitly bounded package-relative fallback; otherwise keep the material slot unresolved and emit a visible warning.";
545
+ } | {
546
+ standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
547
+ id: "malformed-material-reference";
548
+ action: "Attach the canonical default material.";
549
+ severity: "error";
550
+ confidence: "medium";
551
+ policy: "Attach the canonical default material only when the target policy permits it and preserve the unresolved source reference.";
552
+ }>[];
553
+ /** Defensive ceilings for a complete report, including its source snapshots. */
554
+ declare const GPU_MODEL_DIAGNOSTIC_LIMITS: Readonly<{
555
+ readonly issues: 4096;
556
+ readonly values: 16384;
557
+ readonly depth: 12;
558
+ readonly members: 1024;
559
+ readonly string: 65536;
560
+ readonly bytes: 1048576;
561
+ }>;
562
+ /** An inert, bounded report was malformed; errors never echo caller values. */
563
+ declare class GpuModelDiagnosticsError extends TypeError {
564
+ constructor();
565
+ }
566
+ /** Common, path-addressable fields; callers must remove sensitive source text. */
567
+ interface GpuModelConversionIssueBase {
568
+ readonly code: string;
569
+ readonly path: string;
570
+ readonly message: string;
571
+ }
572
+ /** Adapter-reported standard violation, with explicit completed-repair evidence. */
573
+ interface GpuModelConversionViolation extends GpuModelConversionIssueBase {
574
+ readonly kind: "violation";
575
+ readonly ruleId: string;
576
+ readonly originalValue: GpuModelMetadataValue;
577
+ readonly repairApplied: boolean;
578
+ }
579
+ /** Unsupported source/target semantics are always blocking. */
580
+ interface GpuModelUnsupportedData extends GpuModelConversionIssueBase {
581
+ readonly kind: "unsupported";
582
+ }
583
+ /** An advisory that does not represent a standard violation or lost data. */
584
+ interface GpuModelConversionWarning extends GpuModelConversionIssueBase {
585
+ readonly kind: "warning";
586
+ }
587
+ /** Explicit source-fidelity loss, requiring caller consent even after repair. */
588
+ interface GpuModelConversionLoss extends GpuModelConversionIssueBase {
589
+ readonly kind: "loss";
590
+ readonly effect: "dropped" | "approximated";
591
+ }
592
+ /** Discriminated adapter input contract; unknown rule IDs remain blocking. */
593
+ type GpuModelConversionIssue = GpuModelConversionViolation | GpuModelUnsupportedData | GpuModelConversionWarning | GpuModelConversionLoss;
594
+ /** Typed construction contract; the evaluator also validates unknown input. */
595
+ interface GpuModelDiagnosticInput {
596
+ readonly standard: GpuModelDiagnosticStandard;
597
+ readonly mode?: GpuModelDiagnosticMode;
598
+ readonly allowLoss?: boolean;
599
+ readonly issues: readonly GpuModelConversionIssue[];
600
+ readonly rawSource?: GpuModelMetadataValue;
601
+ readonly maxEvidenceBytes?: number;
602
+ }
603
+ /** One verified report of an adapter-applied repair; never a repair request. */
604
+ interface GpuModelRepairRecord {
605
+ readonly ruleId: typeof GPU_MODEL_REPAIR_RULES[number]["id"];
606
+ readonly originalValue: GpuModelMetadataValue;
607
+ readonly action: string;
608
+ readonly severity: GpuModelDiagnosticSeverity;
609
+ readonly affectedPath: string;
610
+ readonly confidence: "high" | "medium" | "low";
611
+ }
612
+ /** Separate categories prevent warnings from disguising violations or loss. */
613
+ type GpuModelConversionDiagnostic = (GpuModelConversionIssueBase & {
614
+ readonly kind: "blocking-error";
615
+ readonly severity: "error";
616
+ readonly ruleId: string;
617
+ }) | (GpuModelConversionIssueBase & {
618
+ readonly kind: "repair";
619
+ readonly severity: GpuModelDiagnosticSeverity;
620
+ readonly ruleId: string;
621
+ }) | (GpuModelUnsupportedData & {
622
+ readonly severity: "error";
623
+ }) | (GpuModelConversionWarning & {
624
+ readonly severity: "warning";
625
+ }) | (GpuModelConversionLoss & {
626
+ readonly severity: "warning";
627
+ });
628
+ /** Immutable owned ledger. Acceptance validates reports, not repaired geometry. */
629
+ interface GpuModelDiagnosticReport {
630
+ readonly mode: GpuModelDiagnosticMode;
631
+ readonly standard: GpuModelDiagnosticStandard;
632
+ readonly accepted: boolean;
633
+ readonly diagnostics: readonly GpuModelConversionDiagnostic[];
634
+ readonly repairs: readonly GpuModelRepairRecord[];
635
+ readonly losses: readonly (GpuModelConversionLoss & {
636
+ readonly severity: "warning";
637
+ })[];
638
+ readonly rawSource?: GpuModelMetadataValue;
639
+ }
640
+ /**
641
+ * Validate a bounded inert adapter report and build an immutable conversion ledger.
642
+ * Strict rejects violations. Tolerant/forensic require explicit applied repairs.
643
+ * Callers must scrub source snapshots before supplying them and must not log them.
644
+ * Throws GpuModelDiagnosticsError for malformed or over-budget reports.
645
+ */
646
+ declare function evaluateGpuModelDiagnostics(value: unknown): GpuModelDiagnosticReport;
647
+
498
648
  /** Package identity and rollout metadata for the initial repository baseline. */
499
649
  declare const packageName: "@plasius/gpu-model-core";
500
650
  declare const packageBootstrap: Readonly<{
@@ -503,4 +653,4 @@ declare const packageBootstrap: Readonly<{
503
653
  readonly status: "bootstrap";
504
654
  }>;
505
655
 
506
- export { CANONICAL_GPU_MODEL_COORDINATE_SYSTEM, GPU_MODEL_DOCUMENT_LIMITS, GPU_MODEL_DOCUMENT_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 GpuModelDiagnostic, type GpuModelDiagnosticSeverity, 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 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 GpuModelVec2, type GpuModelVec3, type GpuModelVec4, type GpuModelVertexWeightSet, assertGpuModelStaticDemoNormalization, canCreateGpuModelDocument, createAndVerifyGpuModelDocument, createGpuModelDocument, createGpuModelStaticDemoCompilerInput, encodeGpuModelDocumentCanonical, hashGpuModelDocumentCanonical, isGpuModelDocument, packageBootstrap, packageName, verifyGpuModelResource };
656
+ 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 };