@plasius/gpu-model-core 0.1.0 → 0.3.0

package/dist/index.d.cts

@@ -495,6 +495,244 @@ declare function assertGpuModelStaticDemoNormalization(document: GpuModelDocumen
  */
 declare function createGpuModelStaticDemoCompilerInput(document: GpuModelDocument, options: GpuModelStaticDemoCompilerOptions): Promise<GpuModelStaticDemoCompilerInput>;
 
+/** Supported policy modes; strict is always the default. */
+type GpuModelDiagnosticMode = "strict" | "tolerant" | "forensic";
+/** Adapter compliance profiles inherited from the canonical conversion policy. */
+type GpuModelDiagnosticStandard = "gltf-glb" | "obj-mtl" | "fbx" | "cad-bim";
+/** Stable repair definitions; format adapters apply and verify these actions. */
+declare const GPU_MODEL_REPAIR_RULES: readonly Readonly<{
+    standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
+    id: "missing-normals";
+    action: "Generate deterministic vertex normals from validated triangle geometry.";
+    severity: "warning";
+    confidence: "high";
+    policy: "Generate deterministic vertex normals from validated triangle geometry and record the generation basis.";
+} | {
+    standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
+    id: "bad-winding";
+    action: "Normalize winding to the adapter coordinate convention.";
+    severity: "warning";
+    confidence: "medium";
+    policy: "Normalize winding to the adapter coordinate convention and record the inferred orientation.";
+} | {
+    standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
+    id: "invalid-indices";
+    action: "Drop the invalid primitive.";
+    severity: "error";
+    confidence: "medium";
+    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.";
+} | {
+    standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
+    id: "nan-transforms";
+    action: "Replace non-finite transform components with identity components.";
+    severity: "error";
+    confidence: "high";
+    policy: "Replace the non-finite component with the identity transform component and record the source value and fallback.";
+} | {
+    standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
+    id: "non-normalized-weights";
+    action: "Normalize finite non-negative skin weights.";
+    severity: "warning";
+    confidence: "high";
+    policy: "Normalize finite, non-negative influences and record the pre-normalization weights and discarded influence policy.";
+} | {
+    standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
+    id: "missing-texture-path";
+    action: "Leave the missing or unsafe texture slot unresolved.";
+    severity: "warning";
+    confidence: "low";
+    policy: "Resolve only an explicitly bounded package-relative fallback; otherwise keep the material slot unresolved and emit a visible warning.";
+} | {
+    standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
+    id: "malformed-material-reference";
+    action: "Attach the canonical default material.";
+    severity: "error";
+    confidence: "medium";
+    policy: "Attach the canonical default material only when the target policy permits it and preserve the unresolved source reference.";
+}>[];
+/** Defensive ceilings for a complete report, including its source snapshots. */
+declare const GPU_MODEL_DIAGNOSTIC_LIMITS: Readonly<{
+    readonly issues: 4096;
+    readonly values: 16384;
+    readonly depth: 12;
+    readonly members: 1024;
+    readonly string: 65536;
+    readonly bytes: 1048576;
+}>;
+/** An inert, bounded report was malformed; errors never echo caller values. */
+declare class GpuModelDiagnosticsError extends TypeError {
+    constructor();
+}
+/** Common, path-addressable fields; callers must remove sensitive source text. */
+interface GpuModelConversionIssueBase {
+    readonly code: string;
+    readonly path: string;
+    readonly message: string;
+}
+/** Adapter-reported standard violation, with explicit completed-repair evidence. */
+interface GpuModelConversionViolation extends GpuModelConversionIssueBase {
+    readonly kind: "violation";
+    readonly ruleId: string;
+    readonly originalValue: GpuModelMetadataValue;
+    readonly repairApplied: boolean;
+}
+/** Unsupported source/target semantics are always blocking. */
+interface GpuModelUnsupportedData extends GpuModelConversionIssueBase {
+    readonly kind: "unsupported";
+}
+/** An advisory that does not represent a standard violation or lost data. */
+interface GpuModelConversionWarning extends GpuModelConversionIssueBase {
+    readonly kind: "warning";
+}
+/** Explicit source-fidelity loss, requiring caller consent even after repair. */
+interface GpuModelConversionLoss extends GpuModelConversionIssueBase {
+    readonly kind: "loss";
+    readonly effect: "dropped" | "approximated";
+}
+/** Discriminated adapter input contract; unknown rule IDs remain blocking. */
+type GpuModelConversionIssue = GpuModelConversionViolation | GpuModelUnsupportedData | GpuModelConversionWarning | GpuModelConversionLoss;
+/** Typed construction contract; the evaluator also validates unknown input. */
+interface GpuModelDiagnosticInput {
+    readonly standard: GpuModelDiagnosticStandard;
+    readonly mode?: GpuModelDiagnosticMode;
+    readonly allowLoss?: boolean;
+    readonly issues: readonly GpuModelConversionIssue[];
+    readonly rawSource?: GpuModelMetadataValue;
+    readonly maxEvidenceBytes?: number;
+}
+/** One verified report of an adapter-applied repair; never a repair request. */
+interface GpuModelRepairRecord {
+    readonly ruleId: typeof GPU_MODEL_REPAIR_RULES[number]["id"];
+    readonly originalValue: GpuModelMetadataValue;
+    readonly action: string;
+    readonly severity: GpuModelDiagnosticSeverity;
+    readonly affectedPath: string;
+    readonly confidence: "high" | "medium" | "low";
+}
+/** Separate categories prevent warnings from disguising violations or loss. */
+type GpuModelConversionDiagnostic = (GpuModelConversionIssueBase & {
+    readonly kind: "blocking-error";
+    readonly severity: "error";
+    readonly ruleId: string;
+}) | (GpuModelConversionIssueBase & {
+    readonly kind: "repair";
+    readonly severity: GpuModelDiagnosticSeverity;
+    readonly ruleId: string;
+}) | (GpuModelUnsupportedData & {
+    readonly severity: "error";
+}) | (GpuModelConversionWarning & {
+    readonly severity: "warning";
+}) | (GpuModelConversionLoss & {
+    readonly severity: "warning";
+});
+/** Immutable owned ledger. Acceptance validates reports, not repaired geometry. */
+interface GpuModelDiagnosticReport {
+    readonly mode: GpuModelDiagnosticMode;
+    readonly standard: GpuModelDiagnosticStandard;
+    readonly accepted: boolean;
+    readonly diagnostics: readonly GpuModelConversionDiagnostic[];
+    readonly repairs: readonly GpuModelRepairRecord[];
+    readonly losses: readonly (GpuModelConversionLoss & {
+        readonly severity: "warning";
+    })[];
+    readonly rawSource?: GpuModelMetadataValue;
+}
+/**
+ * Validate a bounded inert adapter report and build an immutable conversion ledger.
+ * Strict rejects violations. Tolerant/forensic require explicit applied repairs.
+ * Callers must scrub source snapshots before supplying them and must not log them.
+ * Throws GpuModelDiagnosticsError for malformed or over-budget reports.
+ */
+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;
+
 /** Package identity and rollout metadata for the initial repository baseline. */
 declare const packageName: "@plasius/gpu-model-core";
 declare const packageBootstrap: Readonly<{
@@ -503,4 +741,4 @@ declare const packageBootstrap: Readonly<{
     readonly status: "bootstrap";
 }>;
 
-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 };
+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 };

package/dist/index.d.ts

@@ -495,6 +495,244 @@ declare function assertGpuModelStaticDemoNormalization(document: GpuModelDocumen
  */
 declare function createGpuModelStaticDemoCompilerInput(document: GpuModelDocument, options: GpuModelStaticDemoCompilerOptions): Promise<GpuModelStaticDemoCompilerInput>;
 
+/** Supported policy modes; strict is always the default. */
+type GpuModelDiagnosticMode = "strict" | "tolerant" | "forensic";
+/** Adapter compliance profiles inherited from the canonical conversion policy. */
+type GpuModelDiagnosticStandard = "gltf-glb" | "obj-mtl" | "fbx" | "cad-bim";
+/** Stable repair definitions; format adapters apply and verify these actions. */
+declare const GPU_MODEL_REPAIR_RULES: readonly Readonly<{
+    standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
+    id: "missing-normals";
+    action: "Generate deterministic vertex normals from validated triangle geometry.";
+    severity: "warning";
+    confidence: "high";
+    policy: "Generate deterministic vertex normals from validated triangle geometry and record the generation basis.";
+} | {
+    standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
+    id: "bad-winding";
+    action: "Normalize winding to the adapter coordinate convention.";
+    severity: "warning";
+    confidence: "medium";
+    policy: "Normalize winding to the adapter coordinate convention and record the inferred orientation.";
+} | {
+    standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
+    id: "invalid-indices";
+    action: "Drop the invalid primitive.";
+    severity: "error";
+    confidence: "medium";
+    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.";
+} | {
+    standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
+    id: "nan-transforms";
+    action: "Replace non-finite transform components with identity components.";
+    severity: "error";
+    confidence: "high";
+    policy: "Replace the non-finite component with the identity transform component and record the source value and fallback.";
+} | {
+    standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
+    id: "non-normalized-weights";
+    action: "Normalize finite non-negative skin weights.";
+    severity: "warning";
+    confidence: "high";
+    policy: "Normalize finite, non-negative influences and record the pre-normalization weights and discarded influence policy.";
+} | {
+    standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
+    id: "missing-texture-path";
+    action: "Leave the missing or unsafe texture slot unresolved.";
+    severity: "warning";
+    confidence: "low";
+    policy: "Resolve only an explicitly bounded package-relative fallback; otherwise keep the material slot unresolved and emit a visible warning.";
+} | {
+    standardIds: Readonly<readonly ["gltf-glb", "obj-mtl", "fbx", "cad-bim"] | readonly ["gltf-glb", "fbx", "cad-bim"]>;
+    id: "malformed-material-reference";
+    action: "Attach the canonical default material.";
+    severity: "error";
+    confidence: "medium";
+    policy: "Attach the canonical default material only when the target policy permits it and preserve the unresolved source reference.";
+}>[];
+/** Defensive ceilings for a complete report, including its source snapshots. */
+declare const GPU_MODEL_DIAGNOSTIC_LIMITS: Readonly<{
+    readonly issues: 4096;
+    readonly values: 16384;
+    readonly depth: 12;
+    readonly members: 1024;
+    readonly string: 65536;
+    readonly bytes: 1048576;
+}>;
+/** An inert, bounded report was malformed; errors never echo caller values. */
+declare class GpuModelDiagnosticsError extends TypeError {
+    constructor();
+}
+/** Common, path-addressable fields; callers must remove sensitive source text. */
+interface GpuModelConversionIssueBase {
+    readonly code: string;
+    readonly path: string;
+    readonly message: string;
+}
+/** Adapter-reported standard violation, with explicit completed-repair evidence. */
+interface GpuModelConversionViolation extends GpuModelConversionIssueBase {
+    readonly kind: "violation";
+    readonly ruleId: string;
+    readonly originalValue: GpuModelMetadataValue;
+    readonly repairApplied: boolean;
+}
+/** Unsupported source/target semantics are always blocking. */
+interface GpuModelUnsupportedData extends GpuModelConversionIssueBase {
+    readonly kind: "unsupported";
+}
+/** An advisory that does not represent a standard violation or lost data. */
+interface GpuModelConversionWarning extends GpuModelConversionIssueBase {
+    readonly kind: "warning";
+}
+/** Explicit source-fidelity loss, requiring caller consent even after repair. */
+interface GpuModelConversionLoss extends GpuModelConversionIssueBase {
+    readonly kind: "loss";
+    readonly effect: "dropped" | "approximated";
+}
+/** Discriminated adapter input contract; unknown rule IDs remain blocking. */
+type GpuModelConversionIssue = GpuModelConversionViolation | GpuModelUnsupportedData | GpuModelConversionWarning | GpuModelConversionLoss;
+/** Typed construction contract; the evaluator also validates unknown input. */
+interface GpuModelDiagnosticInput {
+    readonly standard: GpuModelDiagnosticStandard;
+    readonly mode?: GpuModelDiagnosticMode;
+    readonly allowLoss?: boolean;
+    readonly issues: readonly GpuModelConversionIssue[];
+    readonly rawSource?: GpuModelMetadataValue;
+    readonly maxEvidenceBytes?: number;
+}
+/** One verified report of an adapter-applied repair; never a repair request. */
+interface GpuModelRepairRecord {
+    readonly ruleId: typeof GPU_MODEL_REPAIR_RULES[number]["id"];
+    readonly originalValue: GpuModelMetadataValue;
+    readonly action: string;
+    readonly severity: GpuModelDiagnosticSeverity;
+    readonly affectedPath: string;
+    readonly confidence: "high" | "medium" | "low";
+}
+/** Separate categories prevent warnings from disguising violations or loss. */
+type GpuModelConversionDiagnostic = (GpuModelConversionIssueBase & {
+    readonly kind: "blocking-error";
+    readonly severity: "error";
+    readonly ruleId: string;
+}) | (GpuModelConversionIssueBase & {
+    readonly kind: "repair";
+    readonly severity: GpuModelDiagnosticSeverity;
+    readonly ruleId: string;
+}) | (GpuModelUnsupportedData & {
+    readonly severity: "error";
+}) | (GpuModelConversionWarning & {
+    readonly severity: "warning";
+}) | (GpuModelConversionLoss & {
+    readonly severity: "warning";
+});
+/** Immutable owned ledger. Acceptance validates reports, not repaired geometry. */
+interface GpuModelDiagnosticReport {
+    readonly mode: GpuModelDiagnosticMode;
+    readonly standard: GpuModelDiagnosticStandard;
+    readonly accepted: boolean;
+    readonly diagnostics: readonly GpuModelConversionDiagnostic[];
+    readonly repairs: readonly GpuModelRepairRecord[];
+    readonly losses: readonly (GpuModelConversionLoss & {
+        readonly severity: "warning";
+    })[];
+    readonly rawSource?: GpuModelMetadataValue;
+}
+/**
+ * Validate a bounded inert adapter report and build an immutable conversion ledger.
+ * Strict rejects violations. Tolerant/forensic require explicit applied repairs.
+ * Callers must scrub source snapshots before supplying them and must not log them.
+ * Throws GpuModelDiagnosticsError for malformed or over-budget reports.
+ */
+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;
+
 /** Package identity and rollout metadata for the initial repository baseline. */
 declare const packageName: "@plasius/gpu-model-core";
 declare const packageBootstrap: Readonly<{
@@ -503,4 +741,4 @@ declare const packageBootstrap: Readonly<{
     readonly status: "bootstrap";
 }>;
 
-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 };
+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 };