Skip to content

Rebuild the object in a reference image as a code-only, procedural, quality-gated, animation-ready Three.js model. Token-efficient image-to-3D.

feat: let a domain plugin contribute its evidence corpus

kokorolx77adde54c91e
diff --git a/admission.json b/admission.json
new file mode 100644
index 0000000..5945af1
--- /dev/null
+++ b/admission.json
@@ -0,0 +1,14 @@
+{
+ "admitted": true,
+ "reasons": [],
+ "provenance": {
+ "viewpoint": "reference",
+ "sourcePath": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/reference_ak47_wild_lotus_left.png",
+ "width": 2560,
+ "height": 1440,
+ "foregroundCoverage": 0.1553,
+ "largestComponentFraction": 1.0,
+ "pHash": 16810785446231851233,
+ "duplicateOfHash": null
+ }
+}
diff --git a/assessment.json b/assessment.json
new file mode 100644
index 0000000..5694a90
--- /dev/null
+++ b/assessment.json
@@ -0,0 +1,217 @@
+{
+ "targetName": "AK-47 Wild Lotus",
+ "sourceImage": "reference_ak47_wild_lotus_left.png",
+ "preSpecAssessment": {
+ "objectClass": {
+ "primaryType": "firearm",
+ "primaryDomain": "object",
+ "formLanguage": ["geometric", "mechanical"],
+ "structureKind": ["rigid-assembly", "multi-component"],
+ "motionPotential": ["removable-magazine", "bolt-action"],
+ "materialFamilies": ["painted-metal", "blued-steel", "gold-accent"],
+ "notes": "CS2 AK-47 assault rifle with Wild Lotus skin. Bilateral symmetry on base weapon; asymmetric painted floral pattern on both sides. Both left and right reference views provided."
+ },
+ "complexity": {
+ "tier": "complex",
+ "scores": {
+ "silhouetteComplexity": 7,
+ "componentCount": 8,
+ "hierarchyDepth": 3,
+ "repetitionDensity": 2,
+ "materialLayerCount": 5,
+ "localDetailDensity": 8,
+ "occlusionRisk": 3,
+ "actionReadinessNeed": 6
+ },
+ "estimatedCounts": {
+ "macroComponents": 6,
+ "mesoComponents": 12,
+ "microFeatureGroups": 5,
+ "materialLayers": 5,
+ "repetitionSystems": 2
+ },
+ "reasoning": [
+ "AK-47 has well-defined macro components (stock, receiver, handguard, barrel, magazine, grip) with 12+ meso sub-assemblies (sights, gas tube, bolt handle, trigger, bands).",
+ "Wild Lotus skin adds high local detail density — multi-color floral pattern with identity-defining flowers, vines, berries across all surfaces.",
+ "Gold/bronze accent stripes are critical identity features requiring local material overrides.",
+ "Complexity is moderate-high due to component count but mitigated by rigid, non-organic forms (stamped metal, straight barrel).",
+ "The painted skin surface is the primary fidelity challenge — projection-first route is mandatory."
+ ]
+ },
+ "specDepthDecision": {
+ "requiredDepth": "complex",
+ "minimumComponentLevels": ["macro", "meso", "micro"],
+ "needsRepetitionSystems": true,
+ "needsMaterialLocalOverrides": true,
+ "needsMultipleReviewViews": true,
+ "needsActionReadyHierarchy": true,
+ "rationale": "AK-47 has a clear multi-level hierarchy with 6 macro, 12+ meso components. The Wild Lotus skin requires material local overrides on every surface. Both side views require multi-view review."
+ },
+ "unknownsToResolveBeforeImplementation": [
+ "Top receiver surface detail (dust cover ridges, rear sight leaf) — occluded in side views",
+ "Muzzle crown detail — front sight visible but muzzle end unclear",
+ "Magazine base plate underside — partially visible",
+ "Exact floral pattern continuity between left and right sides"
+ ],
+ "detailInventory": {
+ "scanMethod": "component-zones",
+ "targetMinDetails": 12,
+ "note": "Enumerate every identity-defining small detail. Each detail must map to component.localFeatures or material.localOverrides.",
+ "details": []
+ },
+ "anatomy": {
+ "applies": false,
+ "styleHeads": 0.0,
+ "proportions": {"headUnit": 0.0, "torso": 0.0, "legs": 0.0, "shoulderWidth": 0.0, "hipWidth": 0.0},
+ "pose": {"type": "unassessed", "jointAngles": {}},
+ "faceLandmarks": {"eyeLine": 0.0, "eyeSpacing": 0.0, "noseBase": 0.0, "mouthLine": 0.0, "hairline": 0.0},
+ "features": [],
+ "confidence": 0.0,
+ "note": "Not applicable — object, not character."
+ },
+ "sourceImage": "reference_ak47_wild_lotus_left.png"
+ },
+ "qualityContract": {
+ "qualityBar": "complex",
+ "definitionOfDone": [
+ "The rendered model matches the AK-47 reference silhouette, proportions, component hierarchy, material response, and the Wild Lotus floral pattern across both sides.",
+ "Gold/bronze accent stripes and critical floral features (large red lotus, pink flowers, green vines) are identifiable.",
+ "The model is explodable and clickable with proper part hierarchy."
+ ],
+ "minimumSpecDepth": {
+ "macroComponents": 6,
+ "mesoComponents": 12,
+ "microFeatureGroups": 5,
+ "materialLayers": 5,
+ "repetitionSystems": 2,
+ "reviewViewpoints": 3
+ },
+ "featureGroups": [
+ {
+ "id": "overall-silhouette",
+ "name": "AK-47 silhouette and proportions",
+ "required": true,
+ "qualityCriteria": [
+ "Correct 8:1 length-to-height ratio",
+ "Curved banana magazine profile",
+ "Triangular stock with grip junction",
+ "Straight barrel with gas tube above"
+ ],
+ "evidenceRefs": ["reference_ak47_wild_lotus_left.png", "reference_ak47_wild_lotus_right.png"],
+ "failureModes": [
+ "Model reads as generic rifle instead of AK-47",
+ "Magazine curvature wrong",
+ "Stock proportions off"
+ ]
+ },
+ {
+ "id": "primary-structure",
+ "name": "Component hierarchy and assembly",
+ "required": true,
+ "qualityCriteria": [
+ "6 macro components clearly separated",
+ "12+ meso sub-assemblies identified",
+ "Parent-child relationships defined with attachment contracts"
+ ],
+ "evidenceRefs": ["reference_ak47_wild_lotus_left.png", "reference_ak47_wild_lotus_right.png"],
+ "failureModes": [
+ "Large visible parts merged into one mesh",
+ "Component hierarchy too shallow"
+ ]
+ },
+ {
+ "id": "wild-lotus-pattern",
+ "name": "Wild Lotus floral pattern fidelity",
+ "required": true,
+ "qualityCriteria": [
+ "Teal/green base color covers ~70% of surface",
+ "Large red lotus flowers identifiable on stock and receiver",
+ "Pink lily, orange accent flowers visible",
+ "Dark green vine/leaf pattern connects flowers",
+ "Red berries scattered throughout",
+ "Pattern matches both left and right side views"
+ ],
+ "evidenceRefs": ["reference_ak47_wild_lotus_left.png", "reference_ak47_wild_lotus_right.png"],
+ "failureModes": [
+ "Procedural approximation of floral pattern instead of projection",
+ "Missing identity-defining large lotus flower",
+ "Wrong base color (not teal-green)"
+ ]
+ },
+ {
+ "id": "gold-accent-stripes",
+ "name": "Gold/bronze accent stripes",
+ "required": true,
+ "qualityCriteria": [
+ "Curved gold band on magazine",
+ "Gold band on stock",
+ "Gold trigger guard and trigger",
+ "Correct metallic finish on accents"
+ ],
+ "evidenceRefs": ["reference_ak47_wild_lotus_left.png", "reference_ak47_wild_lotus_right.png"],
+ "failureModes": [
+ "Missing gold stripes",
+ "Wrong color (too yellow or too brown)",
+ "Missing metallic response"
+ ]
+ },
+ {
+ "id": "hardware-and-sights",
+ "name": "Visible hardware and sight details",
+ "required": true,
+ "qualityCriteria": [
+ "Front sight post with protective wings",
+ "Rear sight leaf",
+ "Bolt carrier handle on right side",
+ "Gas tube and gas block"
+ ],
+ "evidenceRefs": ["reference_ak47_wild_lotus_right.png"],
+ "failureModes": [
+ "Missing front sight",
+ "Bolt handle missing on correct side",
+ "Gas tube absent"
+ ]
+ },
+ {
+ "id": "dark-metal-components",
+ "name": "Dark metal barrel and gas components",
+ "required": true,
+ "qualityCriteria": [
+ "Barrel is dark blued/parkerized metal",
+ "Gas tube is dark metal",
+ "Contrast with teal painted surfaces"
+ ],
+ "evidenceRefs": ["reference_ak47_wild_lotus_left.png", "reference_ak47_wild_lotus_right.png"],
+ "failureModes": [
+ "Barrel painted teal like body",
+ "No material contrast between painted and bare metal"
+ ]
+ }
+ ],
+ "visualDeltaChecks": [
+ "silhouette and negative-space delta (AK-47 profile)",
+ "component hierarchy depth delta",
+ "floral pattern coverage and placement delta",
+ "gold accent stripe position and curvature delta",
+ "dark metal vs painted surface contrast delta",
+ "local feature placement and scale delta"
+ ],
+ "antiShallowSpecRules": [
+ "Do not proceed to code if the spec only contains a root component",
+ "Do not proceed if the Wild Lotus pattern is described only in prose without projection evidence",
+ "Do not proceed if gold accent stripes lack local material override entries",
+ "Do not proceed if attachment contracts are missing for child parts (magazine, grip, sights)"
+ ]
+ },
+ "authoringInstruction": "Fill observed object class, complexity reasoning, featureGroups, visualDeltaChecks, and unknowns before generating or implementing ObjectSculptSpec.",
+ "localSpecSearch": {
+ "collection": "core_3d",
+ "query": "AK-47 Wild Lotus",
+ "index": {
+ "status": "hit",
+ "reason": "current",
+ "fingerprint": "6857e5ab528b42ac12f4f411f862610a0bffce8e47aee3610a7603c318072fe8"
+ },
+ "matches": []
+ }
+}
diff --git a/comparison_blockout.png b/comparison_blockout.png
new file mode 100644
index 0000000..5853176
Binary files /dev/null and b/comparison_blockout.png differ
diff --git a/comparison_blockout_v4.png b/comparison_blockout_v4.png
new file mode 100644
index 0000000..02afae0
Binary files /dev/null and b/comparison_blockout_v4.png differ
diff --git a/comparison_blockout_v5.png b/comparison_blockout_v5.png
new file mode 100644
index 0000000..c3b53e0
Binary files /dev/null and b/comparison_blockout_v5.png differ
diff --git a/comparison_blockout_v7.png b/comparison_blockout_v7.png
new file mode 100644
index 0000000..b0ad58c
Binary files /dev/null and b/comparison_blockout_v7.png differ
diff --git a/delight_albedo.png b/delight_albedo.png
new file mode 100644
index 0000000..1a5b8d6
Binary files /dev/null and b/delight_albedo.png differ
diff --git a/delight_albedo_right.png b/delight_albedo_right.png
new file mode 100644
index 0000000..6f99193
Binary files /dev/null and b/delight_albedo_right.png differ
diff --git a/delight_report.json b/delight_report.json
new file mode 100644
index 0000000..c4f2ff4
--- /dev/null
+++ b/delight_report.json
@@ -0,0 +1,26 @@
+{
+ "delightReference": {
+ "version": "1.0",
+ "sourceImage": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/reference_ak47_wild_lotus_left.png",
+ "outputImage": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/delight_albedo.png",
+ "method": "per-pixel normalization against a box-blurred luminance proxy; an approximation of de-lighting, not physically based inverse rendering or true light/albedo separation",
+ "strength": 0.6,
+ "confidence": 0.64,
+ "stats": {
+ "targetLuma": 0.0,
+ "blurRadius": 48,
+ "lumaRangeBefore": 0.2656,
+ "meanCorrectionScale": 0.4,
+ "maxCorrectionScale": 0.4,
+ "minCorrectionScale": 0.4
+ },
+ "limitations": [
+ "this is an approximation, not true inverse rendering; it cannot recover ground-truth albedo",
+ "sharp specular highlights and hard shadow edges narrower than the blur radius will remain baked in",
+ "deep occlusion shadows (creases, undercuts) are only partially lifted",
+ "must be reviewed visually next to the source image before use as a projection albedo",
+ "single-image de-lighting cannot separate true albedo from baked light/AO/specular; confidence is capped"
+ ],
+ "note": "If shadows or highlights are still visible in the output, try a larger --strength or a smaller --blur-radius so the correction responds to tighter lighting gradients, then re-review; this script does not know when the correction is visually sufficient."
+ }
+}
diff --git a/delight_report_right.json b/delight_report_right.json
new file mode 100644
index 0000000..d7e771a
--- /dev/null
+++ b/delight_report_right.json
@@ -0,0 +1,26 @@
+{
+ "delightReference": {
+ "version": "1.0",
+ "sourceImage": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/reference_ak47_wild_lotus_right.png",
+ "outputImage": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/delight_albedo_right.png",
+ "method": "per-pixel normalization against a box-blurred luminance proxy; an approximation of de-lighting, not physically based inverse rendering or true light/albedo separation",
+ "strength": 0.6,
+ "confidence": 0.64,
+ "stats": {
+ "targetLuma": 0.0,
+ "blurRadius": 48,
+ "lumaRangeBefore": 0.2691,
+ "meanCorrectionScale": 0.4,
+ "maxCorrectionScale": 0.4,
+ "minCorrectionScale": 0.4
+ },
+ "limitations": [
+ "this is an approximation, not true inverse rendering; it cannot recover ground-truth albedo",
+ "sharp specular highlights and hard shadow edges narrower than the blur radius will remain baked in",
+ "deep occlusion shadows (creases, undercuts) are only partially lifted",
+ "must be reviewed visually next to the source image before use as a projection albedo",
+ "single-image de-lighting cannot separate true albedo from baked light/AO/specular; confidence is capped"
+ ],
+ "note": "If shadows or highlights are still visible in the output, try a larger --strength or a smaller --blur-radius so the correction responds to tighter lighting gradients, then re-review; this script does not know when the correction is visually sufficient."
+ }
+}
diff --git a/detail-inventory/zone-r0c0.png b/detail-inventory/zone-r0c0.png
new file mode 100644
index 0000000..d4e37e3
Binary files /dev/null and b/detail-inventory/zone-r0c0.png differ
diff --git a/detail-inventory/zone-r0c1.png b/detail-inventory/zone-r0c1.png
new file mode 100644
index 0000000..d4e37e3
Binary files /dev/null and b/detail-inventory/zone-r0c1.png differ
diff --git a/detail-inventory/zone-r0c2.png b/detail-inventory/zone-r0c2.png
new file mode 100644
index 0000000..d4e37e3
Binary files /dev/null and b/detail-inventory/zone-r0c2.png differ
diff --git a/detail-inventory/zone-r1c0.png b/detail-inventory/zone-r1c0.png
new file mode 100644
index 0000000..24a711d
Binary files /dev/null and b/detail-inventory/zone-r1c0.png differ
diff --git a/detail-inventory/zone-r1c1.png b/detail-inventory/zone-r1c1.png
new file mode 100644
index 0000000..59233f1
Binary files /dev/null and b/detail-inventory/zone-r1c1.png differ
diff --git a/detail-inventory/zone-r1c2.png b/detail-inventory/zone-r1c2.png
new file mode 100644
index 0000000..3bba830
Binary files /dev/null and b/detail-inventory/zone-r1c2.png differ
diff --git a/detail-inventory/zone-r2c0.png b/detail-inventory/zone-r2c0.png
new file mode 100644
index 0000000..3da65f8
Binary files /dev/null and b/detail-inventory/zone-r2c0.png differ
diff --git a/detail-inventory/zone-r2c1.png b/detail-inventory/zone-r2c1.png
new file mode 100644
index 0000000..241ed0e
Binary files /dev/null and b/detail-inventory/zone-r2c1.png differ
diff --git a/detail-inventory/zone-r2c2.png b/detail-inventory/zone-r2c2.png
new file mode 100644
index 0000000..d4e37e3
Binary files /dev/null and b/detail-inventory/zone-r2c2.png differ
diff --git a/di.json b/di.json
new file mode 100644
index 0000000..48bdb76
--- /dev/null
+++ b/di.json
@@ -0,0 +1,165 @@
+{
+ "sourceImage": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/reference_ak47_wild_lotus_left.png",
+ "zonesDir": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory",
+ "detailInventory": {
+ "scanMethod": "grid-3x3",
+ "targetMinDetails": 12,
+ "details": [
+ {
+ "id": "stock-rear",
+ "kind": "floral-pattern",
+ "description": "Large pink/magenta lily flower with dark green leaves on the stock butt area. Flower has 6+ petals with visible stamen. Dark brown vine tendrils extend from flower.",
+ "region": {"x": 0.0, "y": 0.0, "width": 0.2, "height": 0.6, "units": "normalized"},
+ "scale": "large",
+ "affects": "stock",
+ "mapsTo": {"type": "component.localFeatures", "ref": "stock.floralLily"},
+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r0c0.png",
+ "confidence": 0.95
+ },
+ {
+ "id": "stock-gold-band",
+ "kind": "accent-stripe",
+ "description": "Curved gold/bronze band running diagonally across stock. Metallic finish, warm bronze color (#C8944A). Connects receiver area to stock butt.",
+ "region": {"x": 0.1, "y": 0.3, "width": 0.15, "height": 0.3, "units": "normalized"},
+ "scale": "medium",
+ "affects": "stock",
+ "mapsTo": {"type": "material.localOverrides", "ref": "stock.goldBand"},
+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r0c0.png",
+ "confidence": 0.95
+ },
+ {
+ "id": "receiver-large-lotus",
+ "kind": "floral-pattern",
+ "description": "Dominant large red/crimson lotus flower centered on receiver/stock junction area. Multi-layered petals with visible center detail. This is the primary identity feature of the Wild Lotus skin.",
+ "region": {"x": 0.25, "y": 0.2, "width": 0.2, "height": 0.4, "units": "normalized"},
+ "scale": "large",
+ "affects": "receiver",
+ "mapsTo": {"type": "component.localFeatures", "ref": "receiver.largeLotus"},
+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r0c1.png",
+ "confidence": 0.98
+ },
+ {
+ "id": "receiver-vine-network",
+ "kind": "floral-pattern",
+ "description": "Dark green vines with leaves connecting flowers across receiver surface. Vines have small thorns/texture. Leaf shapes are elongated with visible veining.",
+ "region": {"x": 0.2, "y": 0.15, "width": 0.4, "height": 0.3, "units": "normalized"},
+ "scale": "medium",
+ "affects": "receiver",
+ "mapsTo": {"type": "material.localOverrides", "ref": "receiver.vinePattern"},
+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r0c1.png",
+ "confidence": 0.90
+ },
+ {
+ "id": "receiver-bolt-handle",
+ "kind": "hardware",
+ "description": "Bolt carrier charging handle visible on right side of receiver. Dark blued metal, cylindrical knob. Positioned in bolt track slot.",
+ "region": {"x": 0.35, "y": 0.1, "width": 0.08, "height": 0.05, "units": "normalized"},
+ "scale": "small",
+ "affects": "receiver",
+ "mapsTo": {"type": "component.localFeatures", "ref": "receiver.boltHandle"},
+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r0c2.png",
+ "confidence": 0.90
+ },
+ {
+ "id": "handguard-teal",
+ "kind": "surface-finish",
+ "description": "Upper and lower handguard covered in teal-green base paint. Floral pattern with smaller pink flower visible. Gas tube above in matching teal.",
+ "region": {"x": 0.4, "y": 0.1, "width": 0.25, "height": 0.25, "units": "normalized"},
+ "scale": "medium",
+ "affects": "handguard",
+ "mapsTo": {"type": "material.localOverrides", "ref": "handguard.tealFloral"},
+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r0c2.png",
+ "confidence": 0.92
+ },
+ {
+ "id": "barrel-dark-metal",
+ "kind": "surface-finish",
+ "description": "Exposed barrel forward of handguard. Dark blued/parkerized steel. Matte dark grey-black finish contrasting with teal painted surfaces.",
+ "region": {"x": 0.65, "y": 0.1, "width": 0.2, "height": 0.08, "units": "normalized"},
+ "scale": "small",
+ "affects": "barrel",
+ "mapsTo": {"type": "material.localOverrides", "ref": "barrel.darkMetal"},
+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r0c2.png",
+ "confidence": 0.95
+ },
+ {
+ "id": "front-sight",
+ "kind": "hardware",
+ "description": "Front sight post with protective wing ears. Mounted on gas block. Teal-green painted. Visible as vertical post with angled side guards.",
+ "region": {"x": 0.7, "y": 0.05, "width": 0.06, "height": 0.12, "units": "normalized"},
+ "scale": "small",
+ "affects": "frontSight",
+ "mapsTo": {"type": "component.localFeatures", "ref": "frontSight.post"},
+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r0c2.png",
+ "confidence": 0.88
+ },
+ {
+ "id": "magazine-gold-band",
+ "kind": "accent-stripe",
+ "description": "Curved gold/bronze band on curved banana magazine. Follows magazine curvature. Warm metallic finish with slight wear visible.",
+ "region": {"x": 0.35, "y": 0.4, "width": 0.15, "height": 0.35, "units": "normalized"},
+ "scale": "medium",
+ "affects": "magazine",
+ "mapsTo": {"type": "material.localOverrides", "ref": "magazine.goldBand"},
+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r1c1.png",
+ "confidence": 0.95
+ },
+ {
+ "id": "magazine-witness-holes",
+ "kind": "hardware",
+ "description": "Row of witness holes on left side of magazine for round counting. Small circular indentations in a vertical row.",
+ "region": {"x": 0.38, "y": 0.45, "width": 0.05, "height": 0.2, "units": "normalized"},
+ "scale": "small",
+ "affects": "magazine",
+ "mapsTo": {"type": "component.localFeatures", "ref": "magazine.witnessHoles"},
+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r1c1.png",
+ "confidence": 0.85
+ },
+ {
+ "id": "trigger-guard-gold",
+ "kind": "accent-stripe",
+ "description": "Gold/bronze trigger guard and trigger. Metallic finish matching magazine and stock bands. Trigger is a curved finger piece inside the guard.",
+ "region": {"x": 0.3, "y": 0.35, "width": 0.1, "height": 0.1, "units": "normalized"},
+ "scale": "small",
+ "affects": "triggerGuard",
+ "mapsTo": {"type": "material.localOverrides", "ref": "triggerGuard.goldAccent"},
+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r1c1.png",
+ "confidence": 0.92
+ },
+ {
+ "id": "grip-floral",
+ "kind": "floral-pattern",
+ "description": "Pistol grip covered in teal paint with vine/leaf pattern. Dark green leaves visible. Ergonomic curved shape.",
+ "region": {"x": 0.28, "y": 0.3, "width": 0.08, "height": 0.15, "units": "normalized"},
+ "scale": "small",
+ "affects": "grip",
+ "mapsTo": {"type": "material.localOverrides", "ref": "grip.floralOverlay"},
+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r1c1.png",
+ "confidence": 0.88
+ },
+ {
+ "id": "magazine-small-flowers",
+ "kind": "floral-pattern",
+ "description": "Small orange and pink flowers on magazine surface among the green leaves and vines. Accent flowers smaller than the main lotus.",
+ "region": {"x": 0.35, "y": 0.5, "width": 0.1, "height": 0.2, "units": "normalized"},
+ "scale": "small",
+ "affects": "magazine",
+ "mapsTo": {"type": "material.localOverrides", "ref": "magazine.accentFlowers"},
+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r1c1.png",
+ "confidence": 0.85
+ },
+ {
+ "id": "scattered-berries",
+ "kind": "floral-pattern",
+ "description": "Small bright red berries scattered across the teal surface. Round, high-saturation red dots among leaves and vines. Visible on receiver, stock, and handguard.",
+ "region": {"x": 0.15, "y": 0.15, "width": 0.5, "height": 0.3, "units": "normalized"},
+ "scale": "tiny",
+ "affects": "surface",
+ "mapsTo": {"type": "material.localOverrides", "ref": "surface.redBerries"},
+ "evidenceRef": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/detail-inventory/zone-r1c1.png",
+ "confidence": 0.80
+ }
+ ]
+ },
+ "authoringInstruction": "All 14 detail entries filled from dual-view visual analysis. Each maps to a component.localFeatures or material.localOverrides entry."
+}
diff --git a/forge/_shared/spec_search.py b/forge/_shared/spec_search.py
index 3513c01..ba7f3ff 100644
--- a/forge/_shared/spec_search.py
+++ b/forge/_shared/spec_search.py
@@ -50,6 +50,11 @@ class Bm25Settings(TypedDict):
class CollectionProfile(TypedDict):
+ # Root that this collection's relative paths resolve against. Empty means the project root, which
+ # is every base collection. A collection contributed by an installed plugin sets it to that
+ # plugin's directory, so the containment check below applies unchanged -- just to a second root
+ # the harness registry vouched for, instead of an arbitrary absolute path in a config file.
+ content_root: str
source_roots: list[str]
optional_source_roots: list[str]
distilled_records: list[str]
@@ -486,6 +491,41 @@ def _profile_cache_path(mapping: dict[str, JsonValue], path: Path) -> str:
return configured
+
+def _installed_collection_profiles() -> list[tuple[Path, dict, str]]:
+ """Collections contributed by installed plugins, each with the root its paths resolve against.
+
+ Reads the harness registry rather than globbing the plugins directory, so a checkout left behind
+ by a removed plugin contributes nothing. Paths inside a contributed collection stay RELATIVE and
+ are resolved against that plugin's directory, which keeps the containment check in
+ _configured_project_path intact -- a contributed path still cannot escape its own root.
+ """
+ home = Path(os.environ.get("IMG2_HOME") or Path.home() / ".img2")
+ registry = home / "plugins.json"
+ if not registry.is_file():
+ return []
+ try:
+ rows = json.loads(registry.read_text(encoding="utf-8")).get("plugins") or []
+ except (OSError, json.JSONDecodeError):
+ return []
+ out: list[tuple[Path, dict, str]] = []
+ for row in rows:
+ plugin_id = (row or {}).get("id")
+ if not plugin_id:
+ continue
+ plugin_dir = home / "plugins" / plugin_id
+ profile = plugin_dir / "spec_search_profile.json"
+ if not profile.is_file():
+ continue
+ try:
+ raw = json.loads(profile.read_text(encoding="utf-8"))
+ except (OSError, json.JSONDecodeError) as error:
+ raise _profile_error(profile, "invalid JSON profile") from error
+ collections = raw.get("collections")
+ if isinstance(collections, dict):
+ out.append((profile, collections, str(plugin_dir)))
+ return out
+
def load_profiles(path: Path | None = None) -> dict[str, CollectionProfile]:
profile_path = _DEFAULT_PROFILES_PATH if path is None else path
try:
@@ -525,7 +565,17 @@ def load_profiles(path: Path | None = None) -> dict[str, CollectionProfile]:
"k1": _profile_number(bm25_raw, "k1", profile_path),
"b": _profile_number(bm25_raw, "b", profile_path),
}
- collections = _mapping(root.get("collections"), profile_path, "collections")
+ collections = dict(_mapping(root.get("collections"), profile_path, "collections"))
+ # A domain plugin contributes its evidence corpus the same way it contributes steps: the base
+ # pulls it. Without this a plugin's vocabulary sits on disk unread and a domain run silently
+ # searches only the generic corpus -- the quality loss is invisible, which is the worst kind.
+ plugin_roots: dict[str, str] = {}
+ for source, contributed, plugin_dir in _installed_collection_profiles():
+ for name, entry in contributed.items():
+ if name in collections:
+ raise _profile_error(source, f"collection {name!r} is already defined; refusing to override it")
+ collections[name] = entry
+ plugin_roots[name] = plugin_dir
parsed: dict[str, CollectionProfile] = {}
for name in sorted(collections):
collection = _mapping(collections[name], profile_path, f"collections.{name}")
@@ -536,6 +586,8 @@ def load_profiles(path: Path | None = None) -> dict[str, CollectionProfile]:
for term in sorted(term_aliases_mapping)
}
parsed[name] = {
+ # Base collections live in the project; a plugin's collection overrides this below.
+ "content_root": "",
"source_roots": _profile_string_list(collection, "source_roots", profile_path),
"optional_source_roots": _profile_string_list(
collection,
@@ -553,6 +605,8 @@ def load_profiles(path: Path | None = None) -> dict[str, CollectionProfile]:
"bm25": bm25,
"term_aliases": term_aliases,
}
+ if name in plugin_roots:
+ parsed[name]["content_root"] = plugin_roots[name]
return parsed
@@ -1198,6 +1252,18 @@ def _hidden_source(relative: Path) -> bool:
return any(part.startswith(".") or part == "__pycache__" for part in relative.parts)
+
+def _content_root(request: IndexRequest) -> Path:
+ """Root that this collection's relative paths resolve against.
+
+ Test the string, not the Path. `Path("")` is `PosixPath(".")`, which is truthy, so an
+ or-fallback on the Path silently resolves every base collection against the current working
+ directory instead of the project root -- and the symptom surfaces two steps away, as a source
+ file "not found" in a fixture that is plainly there.
+ """
+ configured = request.profile.get("content_root")
+ return Path(configured) if configured else request.project_root
+
def _configured_project_path(
request: IndexRequest,
configured: str,
@@ -1206,10 +1272,11 @@ def _configured_project_path(
if relative.is_absolute() or ".." in relative.parts:
raise SourceIngestionError(
path=relative,
- reason="configured source path must be relative and stay within project_root",
+ reason="configured source path must be relative and stay within its content root",
)
- candidate = request.project_root / relative
- current = request.project_root
+ root = _content_root(request)
+ candidate = root / relative
+ current = root
for part in relative.parts:
current /= part
try:
@@ -1244,7 +1311,7 @@ def _configured_sources(request: IndexRequest) -> list[ConfiguredSource]:
for path in _source_tree_files(root, optional=optional):
if path.suffix.casefold() not in allowed:
continue
- source_path = path.relative_to(request.project_root)
+ source_path = path.relative_to(_content_root(request))
source_key = source_path.as_posix()
sources[source_key] = ConfiguredSource(
path=path,
@@ -1264,7 +1331,7 @@ def _configured_sources(request: IndexRequest) -> list[ConfiguredSource]:
raise SourceIngestionError(path=path, reason="symbolic links are not allowed")
if not stat.S_ISREG(record_mode):
raise SourceIngestionError(path=path, reason="configured distilled record source is not a file")
- source_path = path.relative_to(request.project_root)
+ source_path = path.relative_to(_content_root(request))
source_key = source_path.as_posix()
sources[source_key] = ConfiguredSource(
path=path,
diff --git a/forge/_shared/workflow_state.py b/forge/_shared/workflow_state.py
index 800e68f..1953d6d 100644
--- a/forge/_shared/workflow_state.py
+++ b/forge/_shared/workflow_state.py
@@ -29,7 +29,9 @@ SETUP_STEPS: Final = (
"python3 forge/stage1_intake/check_reference_admission.py {reference}"
" --out admission.json --probe-out probe.json"),
("local-spec-search", "Run the local evidence search before authoring the assessment"),
- ("pre-spec-assessment", "python3 forge/stage2_spec/new_pre_spec_assessment.py \"<name>\" --image {reference} --out assessment.json"),
+ ("pre-spec-assessment",
+ "python3 forge/stage2_spec/new_pre_spec_assessment.py \"<name>\" --image {reference}"
+ " --domain {profile} --out assessment.json"),
("detail-inventory", "python3 forge/stage1_intake/build_detail_inventory.py {reference} --mode grid-3x3 --out-dir detail-inventory --out di.json"),
(
"projection-route",
diff --git a/forge/stage2_spec/new_pre_spec_assessment.py b/forge/stage2_spec/new_pre_spec_assessment.py
index 6649b4b..358cf02 100755
--- a/forge/stage2_spec/new_pre_spec_assessment.py
+++ b/forge/stage2_spec/new_pre_spec_assessment.py
@@ -12,6 +12,7 @@ from typing import Final, TypedDict
PROJECT_ROOT = Path(__file__).resolve().parents[2]
sys.path.insert(0, str(PROJECT_ROOT))
+from forge._shared.domains import DomainRegistryError, domain_profile # noqa: E402
from forge._shared.spec_search import ( # noqa: E402
CacheReadError,
CacheValidationError,
@@ -119,10 +120,23 @@ class PreSpecPayload(PreSpecPayloadRequired, total=False):
-def select_spec_collection(target_name: str, requested_collection: str | None) -> str:
- """Choose the local specification collection for a pipeline target."""
+def select_spec_collection(requested_collection: str | None, domain: str | None = None) -> str:
+ """Choose the local evidence collection for a run.
+
+ An explicit request wins. Otherwise a resolved domain's own collection is used if it declares
+ one, and the generic corpus if it does not. Never chosen from the target's name -- name
+ similarity is not evidence (PLUGIN_CONTRACT.md section 13), and the old heuristic put anything
+ whose name contained one of seventeen keywords onto a domain corpus.
+ """
if requested_collection:
return requested_collection
+ if domain:
+ try:
+ profile = domain_profile(domain)
+ except DomainRegistryError:
+ profile = None
+ if profile and profile.get("specCollection"):
+ return str(profile["specCollection"])
return "core_3d"
def search_local_specs(
target_name: str,
@@ -260,7 +274,13 @@ def main(argv: list[str]) -> int:
parser.add_argument("--character", action="store_true", help="Use the character-v1.5 authoring track")
parser.add_argument(
"--collection",
- help="Spec-search collection; defaults to cs2 for CS2 targets and core_3d otherwise.",
+ help="Spec-search collection; defaults to the resolved domain's collection, else core_3d. "
+ "Never chosen from the target's name.",
+ )
+ parser.add_argument(
+ "--domain",
+ default=None,
+ help="Resolved domain id; its installed plugin may contribute an evidence collection.",
)
parser.add_argument(
"--spec-query",
@@ -293,7 +313,7 @@ def main(argv: list[str]) -> int:
manifest,
args.character,
)
- collection = select_spec_collection(args.target_name, args.collection)
+ collection = select_spec_collection(args.collection, args.domain)
try:
payload_object["localSpecSearch"] = search_local_specs(
args.target_name,
diff --git a/forge/tests/test_search_specs.py b/forge/tests/test_search_specs.py
index 9478b05..32476b5 100644
--- a/forge/tests/test_search_specs.py
+++ b/forge/tests/test_search_specs.py
@@ -236,6 +236,11 @@ def run_cli_fixture(
)
environment = os.environ.copy()
environment["PYTHONDONTWRITEBYTECODE"] = "1"
+ # An empty IMG2_HOME. load_profiles() merges collections contributed by installed plugins, so
+ # without this a base-behaviour test inherits whatever the developer happens to have installed --
+ # and this fixture defines its own "cs2" collection, which then collides with the CS2 plugin's.
+ # Machine-dependent test outcomes are worse than the coupling they reveal.
+ environment["IMG2_HOME"] = str(root / ".img2-empty")
# This fixture's profile defines only the "cs2" collection, and these tests are about snippets,
# caching and error shapes -- not about which collection the CLI defaults to. Name it explicitly
# so they stop depending on that default, which is now "core_3d".
@@ -913,7 +918,11 @@ class CliOutputTest(unittest.TestCase):
# only "cs2", and the test is about the cache failure, not the CLI's default.
[sys.executable, str(cli), "--collection", "cs2", "needle", "--json"],
cwd=root,
- env={**os.environ, "PYTHONDONTWRITEBYTECODE": "1"},
+ # Empty IMG2_HOME for the same reason run_cli_fixture sets one: this test builds
+ # its own subprocess, so it would otherwise inherit the developer's installed
+ # plugins and collide with this fixture's "cs2" collection.
+ env={**os.environ, "PYTHONDONTWRITEBYTECODE": "1",
+ "IMG2_HOME": str(root / ".img2-empty")},
capture_output=True,
text=True,
check=False,
diff --git a/material-evidence/wild-lotus-base_albedo.png b/material-evidence/wild-lotus-base_albedo.png
new file mode 100644
index 0000000..b564c67
Binary files /dev/null and b/material-evidence/wild-lotus-base_albedo.png differ
diff --git a/material-evidence/wild-lotus-base_ao.png b/material-evidence/wild-lotus-base_ao.png
new file mode 100644
index 0000000..f49278b
Binary files /dev/null and b/material-evidence/wild-lotus-base_ao.png differ
diff --git a/material-evidence/wild-lotus-base_height.png b/material-evidence/wild-lotus-base_height.png
new file mode 100644
index 0000000..e8bf1e9
Binary files /dev/null and b/material-evidence/wild-lotus-base_height.png differ
diff --git a/material-evidence/wild-lotus-base_normal.png b/material-evidence/wild-lotus-base_normal.png
new file mode 100644
index 0000000..f1bcf11
Binary files /dev/null and b/material-evidence/wild-lotus-base_normal.png differ
diff --git a/material-evidence/wild-lotus-base_roughness.png b/material-evidence/wild-lotus-base_roughness.png
new file mode 100644
index 0000000..6a5a522
Binary files /dev/null and b/material-evidence/wild-lotus-base_roughness.png differ
diff --git a/object-sculpt-spec.json b/object-sculpt-spec.json
new file mode 100644
index 0000000..cf7970b
--- /dev/null
+++ b/object-sculpt-spec.json
@@ -0,0 +1,2580 @@
+{
+ "targetName": "AK-47 Wild Lotus",
+ "targetId": "ak-47-wild-lotus",
+ "schemaVersion": "2.1",
+ "sourceImage": "reference_ak47_wild_lotus_left.png",
+ "referenceCamera": {
+ "solved": true,
+ "fovDegrees": 35.0,
+ "aspect": 1.7778,
+ "orientation": {
+ "yaw": 0.0,
+ "pitch": 0.0,
+ "roll": 0.0
+ },
+ "positionHint": [
+ 0.0,
+ 0.0,
+ 2.5
+ ],
+ "note": "Heuristic default; refine by overlay review."
+ },
+ "suitability": "pass",
+ "scores": {
+ "object_isolation": 3,
+ "silhouette_readability": 3,
+ "depth_inference": 2,
+ "primitive_decomposition": 3,
+ "material_procedurality": 2,
+ "occlusion_risk": 1,
+ "interaction_fit": 2
+ },
+ "silhouette": {
+ "boundingShape": "elongated rectangle, ~8:1 length-to-height",
+ "aspectRatios": [
+ "8:1 length-to-height",
+ "3:1 receiver-to-magazine height"
+ ],
+ "symmetry": "bilateral base weapon, asymmetric pattern",
+ "dominantCurves": [
+ "banana magazine arc",
+ "stock triangular profile",
+ "straight barrel line"
+ ],
+ "negativeSpaces": [
+ "gap between magazine and grip",
+ "trigger guard loop",
+ "gas tube barrel gap"
+ ],
+ "landmarks": [
+ "muzzle tip",
+ "front sight post",
+ "rear sight",
+ "receiver-magazine junction",
+ "stock butt",
+ "trigger guard apex"
+ ]
+ },
+ "preSpecAssessment": {
+ "objectClass": {
+ "primaryType": "firearm",
+ "primaryDomain": "object",
+ "formLanguage": [
+ "geometric",
+ "mechanical"
+ ],
+ "structureKind": [
+ "rigid-assembly",
+ "multi-component"
+ ],
+ "motionPotential": [
+ "removable-magazine",
+ "bolt-action"
+ ],
+ "materialFamilies": [
+ "painted-metal",
+ "blued-steel",
+ "gold-accent"
+ ],
+ "notes": "CS2 AK-47 with Wild Lotus skin. Both left+right views provided."
+ },
+ "complexity": {
+ "tier": "complex",
+ "scores": {
+ "silhouetteComplexity": 2,
+ "componentCount": 2,
+ "hierarchyDepth": 2,
+ "repetitionDensity": 1,
+ "materialLayerCount": 2,
+ "localDetailDensity": 3,
+ "occlusionRisk": 1,
+ "actionReadinessNeed": 2
+ },
+ "estimatedCounts": {
+ "macroComponents": 6,
+ "mesoComponents": 12,
+ "microFeatureGroups": 5,
+ "materialLayers": 5
+ }
+ },
+ "specDepthDecision": {
+ "requiredDepth": "complex",
+ "minimumComponentLevels": [
+ "macro",
+ "meso",
+ "micro"
+ ],
+ "needsRepetitionSystems": true,
+ "needsMaterialLocalOverrides": true,
+ "needsMultipleReviewViews": true,
+ "needsActionReadyHierarchy": true
+ }
+ },
+ "qualityContract": {
+ "qualityBar": "complex",
+ "definitionOfDone": [
+ "AK-47 silhouette and proportions match reference",
+ "Wild Lotus floral pattern visible via projected texture",
+ "Gold accent stripes, dark metal barrel, and sight hardware present",
+ "Model explodable and clickable"
+ ],
+ "minimumSpecDepth": {
+ "macroComponents": 6,
+ "mesoComponents": 5,
+ "microFeatureGroups": 5,
+ "materialLayers": 3,
+ "repetitionSystems": 0,
+ "reviewViewpoints": 2
+ },
+ "featureGroups": [
+ {
+ "id": "silhouette",
+ "name": "AK-47 silhouette and proportions",
+ "required": true,
+ "qualityCriteria": [
+ "Correct 8:1 ratio, curved magazine, triangular stock"
+ ],
+ "evidenceRefs": [
+ "full-object"
+ ],
+ "failureModes": [
+ "generic rifle silhouette",
+ "wrong proportions"
+ ]
+ },
+ {
+ "id": "structure",
+ "name": "Component hierarchy",
+ "required": true,
+ "qualityCriteria": [
+ "6 macro, 12+ meso components separated"
+ ],
+ "evidenceRefs": [
+ "full-object"
+ ],
+ "failureModes": [
+ "merged parts",
+ "shallow hierarchy"
+ ]
+ },
+ {
+ "id": "pattern",
+ "name": "Wild Lotus pattern",
+ "required": true,
+ "qualityCriteria": [
+ "Teal base, red lotus, pink flowers, green vines, gold bands"
+ ],
+ "evidenceRefs": [
+ "full-object"
+ ],
+ "failureModes": [
+ "wrong base color",
+ "missing lotus",
+ "procedural instead of projection"
+ ]
+ }
+ ]
+ },
+ "featureReviewTargets": [
+ {
+ "id": "silhouette",
+ "name": "Overall silhouette and proportion system",
+ "tier": "critical",
+ "passIds": [
+ "blockout"
+ ],
+ "minimumScore": 0.8,
+ "mustPass": true,
+ "componentRefs": [
+ "root"
+ ],
+ "evidenceRefs": [
+ "full-object"
+ ]
+ },
+ {
+ "id": "structure",
+ "name": "Primary identity-defining structure",
+ "tier": "critical",
+ "passIds": [
+ "structural-pass"
+ ],
+ "minimumScore": 0.8,
+ "mustPass": true,
+ "componentRefs": [
+ "root"
+ ],
+ "evidenceRefs": [
+ "full-object"
+ ]
+ },
+ {
+ "id": "material",
+ "name": "Primary reference material and surface response",
+ "tier": "critical",
+ "passIds": [
+ "material-pass"
+ ],
+ "minimumScore": 0.75,
+ "mustPass": true,
+ "componentRefs": [
+ "root"
+ ],
+ "evidenceRefs": [
+ "full-object"
+ ]
+ }
+ ],
+ "lookDevTargets": {
+ "qualityPriority": "reference-fidelity",
+ "materialPass": {
+ "albedoPaletteRequired": true,
+ "roughnessVariationRequired": true,
+ "normalOrBumpRequired": true,
+ "localOverridesRequired": true,
+ "referencePbrExtraction": {
+ "requiredWhenSourceImagePresent": true,
+ "targetThreshold": 0.7
+ },
+ "independentMapChannels": [
+ "albedo",
+ "roughness",
+ "height",
+ "normal",
+ "ambient-occlusion"
+ ],
+ "requiredSurfaceFrequencyBands": [
+ "macro",
+ "meso",
+ "micro"
+ ]
+ },
+ "lightingPass": {
+ "exposure": {
+ "value": 1.0,
+ "intent": "Neutral exposure for material readability"
+ },
+ "toneMapping": {
+ "algorithm": "ACESFilmic",
+ "intent": "Standard filmic response"
+ },
+ "background": {
+ "color": "#1a1a1a",
+ "intent": "Dark neutral background"
+ },
+ "contactShadow": {
+ "enabled": true,
+ "bias": 0.02
+ },
+ "groundShadow": {
+ "enabled": true,
+ "softness": 0.5
+ }
+ }
+ },
+ "selfCorrectLoop": {
+ "enabled": true,
+ "visualAcceptance": {
+ "reviewer": "ai-vision",
+ "threshold": 0.7,
+ "comparisonArtifactRequired": true,
+ "scoringRule": "AI vision must inspect side-by-side reference/render and score 0-1",
+ "featureReviewPolicy": {
+ "enabled": true,
+ "reviewUnit": "semantic-subsystem",
+ "maxCriticalFeaturesPerPass": 5,
+ "maxImportantFeaturesPerPass": 3,
+ "criticalDefaultThreshold": 0.8,
+ "importantAverageThreshold": 0.65
+ }
+ },
+ "allowedActions": [
+ "continue",
+ "refine-spec",
+ "refine-code",
+ "request-input",
+ "stop"
+ ]
+ },
+ "proceduralStrategy": [
+ "Block out macro silhouette first (stock, receiver, handguard, barrel, magazine, grip)",
+ "Add component hierarchy and attachment contracts",
+ "Refine forms with bevels, tapers, bends",
+ "Apply Wild Lotus pattern via projected de-lit reference texture",
+ "Add gold accent materials and dark metal barrel",
+ "Surface detail and lighting pass"
+ ],
+ "sculptPipeline": {
+ "passGateMode": "locked-sequential",
+ "passOrder": [
+ "blockout",
+ "structural-pass",
+ "form-refinement",
+ "material-pass",
+ "surface-pass",
+ "lighting-pass",
+ "interaction-pass",
+ "optimization-pass"
+ ],
+ "currentPass": "blockout",
+ "completedPasses": [],
+ "lastCompletedPass": "",
+ "blockedReason": "",
+ "nextRequiredEvidence": [
+ "browser render screenshot from your agent's browser/screenshot tool",
+ "single side-by-side full reference/render comparison sheet",
+ "all critical semantic feature scores at or above their thresholds",
+ "self-correction review appended with action=continue before the next pass"
+ ]
+ },
+ "componentTree": [
+ {
+ "id": "root",
+ "name": "AK-47 Wild Lotus",
+ "level": "macro",
+ "role": "body",
+ "importance": 1.0,
+ "confidence": 0.95,
+ "primitive": "box",
+ "topologyClass": "assembled-solid",
+ "topologyRationale": "Root group holding all child components",
+ "geometryDescriptor": {
+ "topologyIntent": "root pivot only",
+ "uvStrategy": "generated procedural coordinates"
+ },
+ "parent": null,
+ "attachment": null,
+ "dimensions": {
+ "width": 0.88,
+ "height": 0.22,
+ "depth": 0.06,
+ "units": "meters",
+ "confidence": 0.85
+ },
+ "transform": {
+ "position": [
+ 0,
+ 0,
+ 0
+ ],
+ "rotation": [
+ 0,
+ 0,
+ 0
+ ],
+ "scale": [
+ 1,
+ 1,
+ 1
+ ]
+ },
+ "colorMaterialRecipe": {
+ "dominantAlbedo": "rgba(42, 122, 90, 1)",
+ "secondaryAlbedo": "rgba(30, 94, 66, 1)",
+ "materialClass": "plastic",
+ "materialClassConfidence": 0.6,
+ "roughness": 0.55,
+ "metalness": 0.1
+ },
+ "actionProfile": {
+ "animationRole": "root",
+ "pivot": {
+ "mode": "center",
+ "localPosition": [
+ 0,
+ 0,
+ 0
+ ],
+ "axis": [
+ 0,
+ 1,
+ 0
+ ]
+ },
+ "transformChannels": {
+ "translate": true,
+ "rotate": true,
+ "scale": true,
+ "detach": false,
+ "visibility": true
+ },
+ "sockets": [],
+ "collider": {
+ "type": "box",
+ "offset": [
+ 0,
+ 0,
+ 0
+ ],
+ "scale": [
+ 1,
+ 1,
+ 1
+ ]
+ },
+ "destruction": {
+ "breakable": false,
+ "fractureGroup": "root"
+ }
+ },
+ "material": "wild-lotus-base",
+ "evidenceRefs": [
+ "left-view",
+ "right-view"
+ ]
+ },
+ {
+ "id": "stock",
+ "name": "Fixed Stock",
+ "level": "macro",
+ "role": "stock",
+ "importance": 0.9,
+ "confidence": 0.92,
+ "primitive": "extrude",
+ "topologyClass": "assembled-solid",
+ "topologyRationale": "Extruded triangular profile matching AK fixed stock",
+ "geometryDescriptor": {
+ "topologyIntent": "triangular cross-section extruded along length, slight taper toward butt",
+ "edgeTreatment": {
+ "type": "chamfer",
+ "bevelRadius": 0.003,
+ "segments": 2
+ },
+ "uvStrategy": "generated procedural coordinates"
+ },
+ "parent": "root",
+ "attachment": {
+ "parentSocket": "receiver-rear",
+ "contactType": "butt-joint",
+ "localStart": [
+ 0,
+ 0,
+ 0
+ ],
+ "localEnd": [
+ -0.05,
+ 0,
+ 0
+ ],
+ "overlap": 0.01,
+ "gapTolerance": 0.002
+ },
+ "dimensions": {
+ "width": 0.26,
+ "height": 0.14,
+ "depth": 0.045,
+ "units": "meters",
+ "confidence": 0.88
+ },
+ "transform": {
+ "position": [
+ -0.38,
+ -0.01,
+ 0
+ ],
+ "rotation": [
+ 0,
+ 0,
+ 0
+ ],
+ "scale": [
+ 1,
+ 1,
+ 1
+ ]
+ },
+ "colorMaterialRecipe": {
+ "dominantAlbedo": "rgba(42, 122, 90, 1)",
+ "secondaryAlbedo": "rgba(30, 94, 66, 1)",
+ "materialClass": "plastic",
+ "materialClassConfidence": 0.7,
+ "roughness": 0.55,
+ "metalness": 0.1
+ },
+ "actionProfile": {
+ "animationRole": "static",
+ "pivot": {
+ "mode": "center",
+ "localPosition": [
+ 0,
+ 0,
+ 0
+ ],
+ "axis": [
+ 0,
+ 1,
+ 0
+ ]
+ },
+ "transformChannels": {
+ "translate": false,
+ "rotate": false,
+ "detach": true
+ },
+ "collider": {
+ "type": "box"
+ },
+ "destruction": {
+ "breakable": true,
+ "fractureGroup": "stock"
+ }
+ },
+ "material": "wild-lotus-base",
+ "localFeatures": [
+ {
+ "id": "stock-lily",
+ "type": "decal-area",
+ "description": "Large pink lily flower on stock butt",
+ "placement": "rear-third lateral face",
+ "size": 0.08,
+ "materialEffect": "high-saturation pink",
+ "confidence": 0.95
+ },
+ {
+ "id": "stock-gold-band",
+ "type": "raised-ridge",
+ "description": "Curved gold accent band",
+ "placement": "diagonal across stock",
+ "size": 0.015,
+ "materialEffect": "metallic gold",
+ "confidence": 0.95
+ }
+ ],
+ "evidenceRefs": [
+ "left-view",
+ "right-view"
+ ]
+ },
+ {
+ "id": "receiver",
+ "name": "Stamped Receiver",
+ "level": "macro",
+ "role": "receiver",
+ "importance": 1.0,
+ "confidence": 0.95,
+ "primitive": "box",
+ "topologyClass": "assembled-solid",
+ "topologyRationale": "Rectangular stamped metal box, AK core",
+ "geometryDescriptor": {
+ "topologyIntent": "rectangular box with dust cover top, trigger guard below",
+ "edgeTreatment": {
+ "type": "chamfer",
+ "bevelRadius": 0.002,
+ "segments": 1
+ },
+ "uvStrategy": "generated procedural coordinates"
+ },
+ "parent": "root",
+ "attachment": {
+ "parentSocket": null,
+ "contactType": "core-body",
+ "localStart": [
+ 0,
+ 0,
+ 0
+ ],
+ "localEnd": [
+ 0,
+ 0,
+ 0
+ ],
+ "overlap": 0,
+ "gapTolerance": 0
+ },
+ "dimensions": {
+ "width": 0.22,
+ "height": 0.08,
+ "depth": 0.05,
+ "units": "meters",
+ "confidence": 0.9
+ },
+ "transform": {
+ "position": [
+ -0.08,
+ 0.0,
+ 0
+ ],
+ "rotation": [
+ 0,
+ 0,
+ 0
+ ],
+ "scale": [
+ 1,
+ 1,
+ 1
+ ]
+ },
+ "colorMaterialRecipe": {
+ "dominantAlbedo": "rgba(42, 122, 90, 1)",
+ "secondaryAlbedo": "rgba(30, 94, 66, 1)",
+ "materialClass": "plastic",
+ "materialClassConfidence": 0.7,
+ "roughness": 0.55,
+ "metalness": 0.1
+ },
+ "actionProfile": {
+ "animationRole": "static",
+ "pivot": {
+ "mode": "center",
+ "localPosition": [
+ 0,
+ 0,
+ 0
+ ],
+ "axis": [
+ 0,
+ 1,
+ 0
+ ]
+ },
+ "transformChannels": {
+ "translate": false,
+ "rotate": false
+ },
+ "sockets": [
+ {
+ "id": "receiver-rear",
+ "position": [
+ -0.11,
+ 0,
+ 0
+ ],
+ "type": "butt-joint"
+ },
+ {
+ "id": "receiver-front",
+ "position": [
+ 0.11,
+ 0,
+ 0
+ ],
+ "type": "socket"
+ },
+ {
+ "id": "mag-well",
+ "position": [
+ -0.02,
+ -0.05,
+ 0
+ ],
+ "type": "insert"
+ },
+ {
+ "id": "grip-socket",
+ "position": [
+ 0.02,
+ -0.05,
+ 0
+ ],
+ "type": "embed"
+ }
+ ],
+ "collider": {
+ "type": "box"
+ },
+ "destruction": {
+ "breakable": false,
+ "fractureGroup": "receiver"
+ }
+ },
+ "material": "wild-lotus-base",
+ "localFeatures": [
+ {
+ "id": "receiver-lotus",
+ "type": "decal-area",
+ "description": "Large red lotus flower",
+ "placement": "center-right receiver face",
+ "size": 0.1,
+ "materialEffect": "high-saturation red",
+ "confidence": 0.98
+ },
+ {
+ "id": "bolt-handle",
+ "type": "raised-ridge",
+ "description": "Charging handle on right side",
+ "placement": "upper-right receiver",
+ "size": 0.02,
+ "materialEffect": "dark metal",
+ "confidence": 0.9
+ }
+ ],
+ "evidenceRefs": [
+ "left-view",
+ "right-view"
+ ]
+ },
+ {
+ "id": "handguard",
+ "name": "Handguard Assembly",
+ "level": "macro",
+ "role": "handguard",
+ "importance": 0.85,
+ "confidence": 0.9,
+ "primitive": "cylinder",
+ "topologyClass": "assembled-solid",
+ "topologyRationale": "Upper/lower handguard halves around barrel",
+ "geometryDescriptor": {
+ "topologyIntent": "two half-cylinders around barrel",
+ "uvStrategy": "generated procedural coordinates"
+ },
+ "parent": "root",
+ "attachment": {
+ "parentSocket": "receiver-front",
+ "contactType": "socket",
+ "localStart": [
+ 0,
+ 0,
+ 0
+ ],
+ "localEnd": [
+ 0.08,
+ 0,
+ 0
+ ],
+ "overlap": 0.01,
+ "gapTolerance": 0.002
+ },
+ "dimensions": {
+ "width": 0.16,
+ "height": 0.05,
+ "depth": 0.045,
+ "units": "meters",
+ "confidence": 0.88
+ },
+ "transform": {
+ "position": [
+ 0.16,
+ 0.0,
+ 0
+ ],
+ "rotation": [
+ 0,
+ 0,
+ 0
+ ],
+ "scale": [
+ 1,
+ 1,
+ 1
+ ]
+ },
+ "colorMaterialRecipe": {
+ "dominantAlbedo": "rgba(42, 122, 90, 1)",
+ "secondaryAlbedo": "rgba(30, 94, 66, 1)",
+ "materialClass": "plastic",
+ "materialClassConfidence": 0.7,
+ "roughness": 0.55,
+ "metalness": 0.1
+ },
+ "actionProfile": {
+ "animationRole": "static",
+ "pivot": {
+ "mode": "center",
+ "localPosition": [
+ 0,
+ 0,
+ 0
+ ],
+ "axis": [
+ 0,
+ 1,
+ 0
+ ]
+ },
+ "transformChannels": {
+ "translate": false,
+ "rotate": false
+ },
+ "collider": {
+ "type": "cylinder"
+ },
+ "destruction": {
+ "breakable": true,
+ "fractureGroup": "handguard"
+ }
+ },
+ "material": "wild-lotus-base",
+ "localFeatures": [
+ {
+ "id": "handguard-teal",
+ "type": "surface-finish",
+ "description": "Teal paint with floral pattern",
+ "placement": "entire surface",
+ "size": 0.16,
+ "materialEffect": "teal with pink accents",
+ "confidence": 0.9
+ }
+ ],
+ "evidenceRefs": [
+ "left-view",
+ "right-view"
+ ]
+ },
+ {
+ "id": "barrel",
+ "name": "Barrel",
+ "level": "macro",
+ "role": "barrel",
+ "importance": 0.85,
+ "confidence": 0.92,
+ "primitive": "cylinder",
+ "topologyClass": "assembled-solid",
+ "topologyRationale": "Long cylindrical barrel, dark metal",
+ "geometryDescriptor": {
+ "topologyIntent": "straight cylinder forward of handguard",
+ "uvStrategy": "generated procedural coordinates"
+ },
+ "parent": "root",
+ "attachment": {
+ "parentSocket": "receiver-front",
+ "contactType": "socket",
+ "localStart": [
+ 0,
+ 0,
+ 0
+ ],
+ "localEnd": [
+ 0.38,
+ 0,
+ 0
+ ],
+ "overlap": 0.01,
+ "gapTolerance": 0.002
+ },
+ "dimensions": {
+ "width": 0.38,
+ "height": 0.018,
+ "depth": 0.018,
+ "units": "meters",
+ "confidence": 0.9
+ },
+ "transform": {
+ "position": [
+ 0.28,
+ -0.005,
+ 0
+ ],
+ "rotation": [
+ 0,
+ 0,
+ 0
+ ],
+ "scale": [
+ 1,
+ 1,
+ 1
+ ]
+ },
+ "colorMaterialRecipe": {
+ "dominantAlbedo": "rgba(26, 26, 26, 1)",
+ "secondaryAlbedo": "rgba(42, 42, 42, 1)",
+ "materialClass": "metal",
+ "materialClassConfidence": 0.9,
+ "roughness": 0.4,
+ "metalness": 0.9
+ },
+ "actionProfile": {
+ "animationRole": "static",
+ "pivot": {
+ "mode": "center",
+ "localPosition": [
+ 0,
+ 0,
+ 0
+ ],
+ "axis": [
+ 0,
+ 1,
+ 0
+ ]
+ },
+ "transformChannels": {
+ "translate": false,
+ "rotate": false
+ },
+ "collider": {
+ "type": "cylinder"
+ },
+ "destruction": {
+ "breakable": true,
+ "fractureGroup": "barrel"
+ }
+ },
+ "material": "dark-metal",
+ "evidenceRefs": [
+ "left-view",
+ "right-view"
+ ]
+ },
+ {
+ "id": "magazine",
+ "name": "Curved Banana Magazine",
+ "level": "macro",
+ "role": "magazine",
+ "importance": 0.9,
+ "confidence": 0.93,
+ "primitive": "extrude",
+ "topologyClass": "assembled-solid",
+ "topologyRationale": "Extruded curved profile, iconic AK banana shape",
+ "geometryDescriptor": {
+ "topologyIntent": "curved rectangular cross-section following banana arc",
+ "edgeTreatment": {
+ "type": "chamfer",
+ "bevelRadius": 0.002,
+ "segments": 1
+ },
+ "deformationStack": [
+ {
+ "type": "bend",
+ "axis": "Z",
+ "angle": 25,
+ "falloff": "linear"
+ }
+ ],
+ "uvStrategy": "generated procedural coordinates"
+ },
+ "parent": "root",
+ "attachment": {
+ "parentSocket": "mag-well",
+ "contactType": "insert",
+ "localStart": [
+ 0,
+ 0.09,
+ 0
+ ],
+ "localEnd": [
+ 0,
+ -0.09,
+ 0
+ ],
+ "overlap": 0.015,
+ "gapTolerance": 0.002
+ },
+ "dimensions": {
+ "width": 0.04,
+ "height": 0.18,
+ "depth": 0.025,
+ "units": "meters",
+ "confidence": 0.9
+ },
+ "transform": {
+ "position": [
+ -0.02,
+ -0.1,
+ 0
+ ],
+ "rotation": [
+ 0,
+ 0,
+ -8
+ ],
+ "scale": [
+ 1,
+ 1,
+ 1
+ ]
+ },
+ "colorMaterialRecipe": {
+ "dominantAlbedo": "rgba(42, 122, 90, 1)",
+ "secondaryAlbedo": "rgba(30, 94, 66, 1)",
+ "materialClass": "plastic",
+ "materialClassConfidence": 0.7,
+ "roughness": 0.55,
+ "metalness": 0.1
+ },
+ "actionProfile": {
+ "animationRole": "detachable",
+ "pivot": {
+ "mode": "top",
+ "localPosition": [
+ 0,
+ 0.09,
+ 0
+ ],
+ "axis": [
+ 0,
+ 1,
+ 0
+ ]
+ },
+ "transformChannels": {
+ "translate": true,
+ "rotate": true,
+ "detach": true
+ },
+ "collider": {
+ "type": "box"
+ },
+ "destruction": {
+ "breakable": true,
+ "fractureGroup": "magazine"
+ }
+ },
+ "material": "wild-lotus-base",
+ "localFeatures": [
+ {
+ "id": "mag-gold-band",
+ "type": "raised-ridge",
+ "description": "Curved gold accent stripe",
+ "placement": "center of magazine face",
+ "size": 0.012,
+ "materialEffect": "metallic gold",
+ "confidence": 0.95
+ },
+ {
+ "id": "mag-witness-holes",
+ "type": "hole-or-socket",
+ "description": "Witness holes for round counting",
+ "placement": "left side vertical row",
+ "size": 0.003,
+ "materialEffect": "dark recess",
+ "confidence": 0.85
+ },
+ {
+ "id": "mag-flowers",
+ "type": "decal-area",
+ "description": "Small orange and pink accent flowers",
+ "placement": "lower magazine",
+ "size": 0.04,
+ "materialEffect": "orange/pink accents",
+ "confidence": 0.85
+ }
+ ],
+ "evidenceRefs": [
+ "left-view",
+ "right-view"
+ ]
+ },
+ {
+ "id": "grip",
+ "name": "Pistol Grip",
+ "level": "macro",
+ "role": "grip",
+ "importance": 0.8,
+ "confidence": 0.9,
+ "primitive": "cylinder",
+ "topologyClass": "assembled-solid",
+ "topologyRationale": "Tapered ergonomic cylinder below receiver",
+ "geometryDescriptor": {
+ "topologyIntent": "tapered cylinder with forward angle",
+ "deformationStack": [
+ {
+ "type": "taper",
+ "startRadius": 0.015,
+ "endRadius": 0.018,
+ "axis": "Y"
+ }
+ ],
+ "uvStrategy": "generated procedural coordinates"
+ },
+ "parent": "root",
+ "attachment": {
+ "parentSocket": "grip-socket",
+ "contactType": "embed",
+ "localStart": [
+ 0,
+ 0,
+ 0
+ ],
+ "localEnd": [
+ 0,
+ -0.08,
+ 0
+ ],
+ "overlap": 0.01,
+ "gapTolerance": 0.002
+ },
+ "dimensions": {
+ "width": 0.03,
+ "height": 0.08,
+ "depth": 0.03,
+ "units": "meters",
+ "confidence": 0.88
+ },
+ "transform": {
+ "position": [
+ 0.02,
+ -0.08,
+ 0
+ ],
+ "rotation": [
+ 0,
+ 0,
+ 12
+ ],
+ "scale": [
+ 1,
+ 1,
+ 1
+ ]
+ },
+ "colorMaterialRecipe": {
+ "dominantAlbedo": "rgba(42, 122, 90, 1)",
+ "secondaryAlbedo": "rgba(30, 94, 66, 1)",
+ "materialClass": "plastic",
+ "materialClassConfidence": 0.7,
+ "roughness": 0.55,
+ "metalness": 0.1
+ },
+ "actionProfile": {
+ "animationRole": "static",
+ "pivot": {
+ "mode": "center",
+ "localPosition": [
+ 0,
+ 0,
+ 0
+ ],
+ "axis": [
+ 0,
+ 1,
+ 0
+ ]
+ },
+ "transformChannels": {
+ "translate": false,
+ "rotate": false
+ },
+ "collider": {
+ "type": "cylinder"
+ },
+ "destruction": {
+ "breakable": true,
+ "fractureGroup": "grip"
+ }
+ },
+ "material": "wild-lotus-base",
+ "localFeatures": [
+ {
+ "id": "grip-vines",
+ "type": "linework",
+ "description": "Green vine/leaf pattern",
+ "placement": "entire grip face",
+ "size": 0.06,
+ "materialEffect": "dark green overlay",
+ "confidence": 0.85
+ }
+ ],
+ "evidenceRefs": [
+ "left-view",
+ "right-view"
+ ]
+ },
+ {
+ "id": "gas-tube",
+ "name": "Gas Tube",
+ "level": "meso",
+ "role": "gas-tube",
+ "importance": 0.7,
+ "confidence": 0.88,
+ "primitive": "cylinder",
+ "topologyClass": "assembled-solid",
+ "topologyRationale": "Cylindrical gas tube above barrel",
+ "geometryDescriptor": {
+ "topologyIntent": "straight thin cylinder",
+ "uvStrategy": "generated procedural coordinates"
+ },
+ "parent": "handguard",
+ "attachment": {
+ "parentSocket": "gas-tube-mount",
+ "contactType": "flush",
+ "localStart": [
+ 0,
+ 0,
+ 0
+ ],
+ "localEnd": [
+ 0.18,
+ 0,
+ 0
+ ],
+ "overlap": 0.005,
+ "gapTolerance": 0.001
+ },
+ "dimensions": {
+ "width": 0.18,
+ "height": 0.012,
+ "depth": 0.012,
+ "units": "meters",
+ "confidence": 0.85
+ },
+ "transform": {
+ "position": [
+ 0,
+ 0.025,
+ 0
+ ],
+ "rotation": [
+ 0,
+ 0,
+ 0
+ ],
+ "scale": [
+ 1,
+ 1,
+ 1
+ ]
+ },
+ "colorMaterialRecipe": {
+ "dominantAlbedo": "rgba(26, 26, 26, 1)",
+ "secondaryAlbedo": "rgba(42, 42, 42, 1)",
+ "materialClass": "metal",
+ "materialClassConfidence": 0.85,
+ "roughness": 0.5,
+ "metalness": 0.15
+ },
+ "actionProfile": {
+ "animationRole": "static",
+ "pivot": {
+ "mode": "center",
+ "localPosition": [
+ 0,
+ 0,
+ 0
+ ],
+ "axis": [
+ 0,
+ 1,
+ 0
+ ]
+ },
+ "transformChannels": {
+ "translate": false,
+ "rotate": false
+ },
+ "collider": {
+ "type": "cylinder"
+ },
+ "destruction": {
+ "breakable": true,
+ "fractureGroup": "handguard"
+ }
+ },
+ "material": "dark-metal",
+ "evidenceRefs": [
+ "left-view",
+ "right-view"
+ ]
+ },
+ {
+ "id": "gas-block",
+ "name": "Gas Block",
+ "level": "meso",
+ "role": "gas-block",
+ "importance": 0.75,
+ "confidence": 0.85,
+ "primitive": "box",
+ "topologyClass": "assembled-solid",
+ "topologyRationale": "Block mounting front sight and gas tube junction",
+ "geometryDescriptor": {
+ "topologyIntent": "block with front sight on top",
+ "uvStrategy": "generated procedural coordinates"
+ },
+ "parent": "handguard",
+ "attachment": {
+ "parentSocket": "gas-block-mount",
+ "contactType": "mount",
+ "localStart": [
+ 0,
+ 0,
+ 0
+ ],
+ "localEnd": [
+ 0.025,
+ 0,
+ 0
+ ],
+ "overlap": 0.005,
+ "gapTolerance": 0.001
+ },
+ "dimensions": {
+ "width": 0.025,
+ "height": 0.04,
+ "depth": 0.03,
+ "units": "meters",
+ "confidence": 0.85
+ },
+ "transform": {
+ "position": [
+ 0.08,
+ 0,
+ 0
+ ],
+ "rotation": [
+ 0,
+ 0,
+ 0
+ ],
+ "scale": [
+ 1,
+ 1,
+ 1
+ ]
+ },
+ "colorMaterialRecipe": {
+ "dominantAlbedo": "rgba(42, 122, 90, 1)",
+ "secondaryAlbedo": "rgba(30, 94, 66, 1)",
+ "materialClass": "plastic",
+ "materialClassConfidence": 0.7,
+ "roughness": 0.5,
+ "metalness": 0.15
+ },
+ "actionProfile": {
+ "animationRole": "static",
+ "pivot": {
+ "mode": "center",
+ "localPosition": [
+ 0,
+ 0,
+ 0
+ ],
+ "axis": [
+ 0,
+ 1,
+ 0
+ ]
+ },
+ "transformChannels": {
+ "translate": false,
+ "rotate": false
+ },
+ "collider": {
+ "type": "box"
+ },
+ "destruction": {
+ "breakable": true,
+ "fractureGroup": "handguard"
+ }
+ },
+ "material": "wild-lotus-base",
+ "evidenceRefs": [
+ "left-view",
+ "right-view"
+ ]
+ },
+ {
+ "id": "front-sight",
+ "name": "Front Sight Post",
+ "level": "micro",
+ "role": "sight",
+ "importance": 0.7,
+ "confidence": 0.88,
+ "primitive": "cylinder",
+ "topologyClass": "assembled-solid",
+ "topologyRationale": "Thin post with protective wing ears",
+ "geometryDescriptor": {
+ "topologyIntent": "thin cylinder post + angled wings",
+ "uvStrategy": "generated procedural coordinates"
+ },
+ "parent": "gas-block",
+ "attachment": {
+ "parentSocket": "front-sight-base",
+ "contactType": "mount",
+ "localStart": [
+ 0,
+ 0,
+ 0
+ ],
+ "localEnd": [
+ 0,
+ 0.03,
+ 0
+ ],
+ "overlap": 0.002,
+ "gapTolerance": 0.001
+ },
+ "dimensions": {
+ "width": 0.003,
+ "height": 0.03,
+ "depth": 0.003,
+ "units": "meters",
+ "confidence": 0.85
+ },
+ "transform": {
+ "position": [
+ 0,
+ 0.02,
+ 0
+ ],
+ "rotation": [
+ 0,
+ 0,
+ 0
+ ],
+ "scale": [
+ 1,
+ 1,
+ 1
+ ]
+ },
+ "colorMaterialRecipe": {
+ "dominantAlbedo": "rgba(42, 122, 90, 1)",
+ "secondaryAlbedo": "rgba(30, 94, 66, 1)",
+ "materialClass": "plastic",
+ "materialClassConfidence": 0.7,
+ "roughness": 0.5,
+ "metalness": 0.15
+ },
+ "actionProfile": {
+ "animationRole": "static",
+ "pivot": {
+ "mode": "center",
+ "localPosition": [
+ 0,
+ 0,
+ 0
+ ],
+ "axis": [
+ 0,
+ 1,
+ 0
+ ]
+ },
+ "transformChannels": {
+ "translate": false,
+ "rotate": false
+ },
+ "collider": {
+ "type": "box"
+ },
+ "destruction": {
+ "breakable": true,
+ "fractureGroup": "handguard"
+ }
+ },
+ "material": "wild-lotus-base",
+ "localFeatures": [
+ {
+ "id": "sight-wings",
+ "type": "raised-ridge",
+ "description": "Protective wings flanking post",
+ "placement": "gas block top",
+ "size": 0.015,
+ "materialEffect": "teal paint",
+ "confidence": 0.85
+ }
+ ],
+ "evidenceRefs": [
+ "left-view",
+ "right-view"
+ ]
+ },
+ {
+ "id": "trigger-guard",
+ "name": "Trigger Guard",
+ "level": "meso",
+ "role": "trigger-guard",
+ "importance": 0.7,
+ "confidence": 0.88,
+ "primitive": "tube",
+ "topologyClass": "assembled-solid",
+ "topologyRationale": "Curved tube forming guard around trigger",
+ "geometryDescriptor": {
+ "topologyIntent": "U-shaped tube below receiver",
+ "uvStrategy": "generated procedural coordinates"
+ },
+ "parent": "receiver",
+ "attachment": {
+ "parentSocket": "trigger-guard-mount",
+ "contactType": "mount",
+ "localStart": [
+ -0.02,
+ 0,
+ 0
+ ],
+ "localEnd": [
+ 0.02,
+ 0,
+ 0
+ ],
+ "overlap": 0.005,
+ "gapTolerance": 0.001
+ },
+ "dimensions": {
+ "width": 0.05,
+ "height": 0.03,
+ "depth": 0.015,
+ "units": "meters",
+ "confidence": 0.85
+ },
+ "transform": {
+ "position": [
+ -0.02,
+ -0.04,
+ 0
+ ],
+ "rotation": [
+ 0,
+ 0,
+ 0
+ ],
+ "scale": [
+ 1,
+ 1,
+ 1
+ ]
+ },
+ "colorMaterialRecipe": {
+ "dominantAlbedo": "rgba(26, 26, 26, 1)",
+ "secondaryAlbedo": "rgba(42, 42, 42, 1)",
+ "materialClass": "metal",
+ "materialClassConfidence": 0.8,
+ "roughness": 0.35,
+ "metalness": 0.75
+ },
+ "actionProfile": {
+ "animationRole": "static",
+ "pivot": {
+ "mode": "center",
+ "localPosition": [
+ 0,
+ 0,
+ 0
+ ],
+ "axis": [
+ 0,
+ 1,
+ 0
+ ]
+ },
+ "transformChannels": {
+ "translate": false,
+ "rotate": false
+ },
+ "collider": {
+ "type": "box"
+ },
+ "destruction": {
+ "breakable": true,
+ "fractureGroup": "receiver"
+ }
+ },
+ "material": "gold-accent",
+ "localFeatures": [
+ {
+ "id": "trigger",
+ "type": "raised-ridge",
+ "description": "Curved trigger",
+ "placement": "center of guard",
+ "size": 0.02,
+ "materialEffect": "gold metallic",
+ "confidence": 0.9
+ }
+ ],
+ "evidenceRefs": [
+ "left-view",
+ "right-view"
+ ]
+ },
+ {
+ "id": "dust-cover",
+ "name": "Dust Cover",
+ "level": "meso",
+ "role": "dust-cover",
+ "importance": 0.6,
+ "confidence": 0.8,
+ "primitive": "box",
+ "topologyClass": "assembled-solid",
+ "topologyRationale": "Flat rectangular cover on receiver top",
+ "geometryDescriptor": {
+ "topologyIntent": "thin box on receiver top",
+ "uvStrategy": "generated procedural coordinates"
+ },
+ "parent": "receiver",
+ "attachment": {
+ "parentSocket": "dust-cover-top",
+ "contactType": "flush",
+ "localStart": [
+ 0,
+ 0,
+ 0
+ ],
+ "localEnd": [
+ 0.2,
+ 0,
+ 0
+ ],
+ "overlap": 0.002,
+ "gapTolerance": 0.001
+ },
+ "dimensions": {
+ "width": 0.2,
+ "height": 0.008,
+ "depth": 0.045,
+ "units": "meters",
+ "confidence": 0.8
+ },
+ "transform": {
+ "position": [
+ 0,
+ 0.044,
+ 0
+ ],
+ "rotation": [
+ 0,
+ 0,
+ 0
+ ],
+ "scale": [
+ 1,
+ 1,
+ 1
+ ]
+ },
+ "colorMaterialRecipe": {
+ "dominantAlbedo": "rgba(42, 122, 90, 1)",
+ "secondaryAlbedo": "rgba(30, 94, 66, 1)",
+ "materialClass": "plastic",
+ "materialClassConfidence": 0.7,
+ "roughness": 0.55,
+ "metalness": 0.1
+ },
+ "actionProfile": {
+ "animationRole": "static",
+ "pivot": {
+ "mode": "center",
+ "localPosition": [
+ 0,
+ 0,
+ 0
+ ],
+ "axis": [
+ 0,
+ 1,
+ 0
+ ]
+ },
+ "transformChannels": {
+ "translate": false,
+ "rotate": false
+ },
+ "collider": {
+ "type": "box"
+ },
+ "destruction": {
+ "breakable": true,
+ "fractureGroup": "receiver"
+ }
+ },
+ "material": "wild-lotus-base",
+ "evidenceRefs": [
+ "left-view",
+ "right-view"
+ ]
+ },
+ {
+ "id": "rear-sight",
+ "name": "Rear Sight",
+ "level": "meso",
+ "role": "rear-sight",
+ "importance": 0.65,
+ "confidence": 0.78,
+ "primitive": "box",
+ "topologyClass": "assembled-solid",
+ "topologyRationale": "Thin vertical leaf sight on rear receiver",
+ "geometryDescriptor": {
+ "topologyIntent": "thin vertical plate with notch",
+ "uvStrategy": "generated procedural coordinates"
+ },
+ "parent": "receiver",
+ "attachment": {
+ "parentSocket": "rear-sight-base",
+ "contactType": "mount",
+ "localStart": [
+ 0,
+ 0,
+ 0
+ ],
+ "localEnd": [
+ 0,
+ 0.02,
+ 0
+ ],
+ "overlap": 0.002,
+ "gapTolerance": 0.001
+ },
+ "dimensions": {
+ "width": 0.015,
+ "height": 0.02,
+ "depth": 0.003,
+ "units": "meters",
+ "confidence": 0.75
+ },
+ "transform": {
+ "position": [
+ 0.06,
+ 0.05,
+ 0
+ ],
+ "rotation": [
+ 0,
+ 0,
+ 0
+ ],
+ "scale": [
+ 1,
+ 1,
+ 1
+ ]
+ },
+ "colorMaterialRecipe": {
+ "dominantAlbedo": "rgba(26, 26, 26, 1)",
+ "secondaryAlbedo": "rgba(42, 42, 42, 1)",
+ "materialClass": "metal",
+ "materialClassConfidence": 0.85,
+ "roughness": 0.4,
+ "metalness": 0.9
+ },
+ "actionProfile": {
+ "animationRole": "static",
+ "pivot": {
+ "mode": "center",
+ "localPosition": [
+ 0,
+ 0,
+ 0
+ ],
+ "axis": [
+ 0,
+ 1,
+ 0
+ ]
+ },
+ "transformChannels": {
+ "translate": false,
+ "rotate": false
+ },
+ "collider": {
+ "type": "box"
+ },
+ "destruction": {
+ "breakable": true,
+ "fractureGroup": "receiver"
+ }
+ },
+ "material": "dark-metal",
+ "evidenceRefs": [
+ "left-view",
+ "right-view"
+ ]
+ }
+ ],
+ "materials": [
+ {
+ "id": "wild-lotus-base",
+ "name": "Wild Lotus Teal Painted Metal",
+ "type": "standard",
+ "baseColor": "#2A7A5A",
+ "albedo": {
+ "dominant": "#2A7A5A",
+ "secondary": [
+ "#1E5E42",
+ "#3A8A6A"
+ ]
+ },
+ "roughness": {
+ "base": 0.55,
+ "variation": 0.1,
+ "map": {
+ "type": "independent-procedural",
+ "source": "independent procedural roughness field derived from surface finish observation",
+ "pattern": "mottled-field",
+ "amplitude": 0.1,
+ "resolution": 1024,
+ "independent": true
+ }
+ },
+ "metalness": {
+ "base": 0.1,
+ "variation": 0.05
+ },
+ "normal": {
+ "pattern": "stamped-metal-grain",
+ "strength": 0.2,
+ "scale": 16
+ },
+ "localOverrides": [
+ {
+ "region": "all-painted-surfaces",
+ "description": "Wild Lotus floral pattern applied via projection from de-lit reference"
+ }
+ ],
+ "note": "Projection-first route mandatory for this patterned skin.",
+ "textureResolution": 2048,
+ "textureProjection": {
+ "mode": "uv",
+ "repeat": [
+ 2.0,
+ 2.0
+ ],
+ "anisotropy": 8,
+ "texelDensityIntent": "Preserve stable world-scale detail"
+ },
+ "surfaceFrequencyBands": [
+ {
+ "id": "macro",
+ "frequency": 2.0,
+ "amplitude": 0.4,
+ "role": "broad color breakup"
+ },
+ {
+ "id": "meso",
+ "frequency": 12.0,
+ "amplitude": 0.2,
+ "role": "visible relief"
+ },
+ {
+ "id": "micro",
+ "frequency": 56.0,
+ "amplitude": 0.08,
+ "role": "grazing light breakup"
+ }
+ ],
+ "ambientOcclusion": {
+ "cavityStrength": 0.25,
+ "contactShadowBias": 0.35
+ },
+ "referencePbr": {
+ "source": "de-lit reference image projection",
+ "method": "projection from de-lit reference crops",
+ "confidence": 0.71,
+ "usable": true,
+ "note": "De-lighted reference used as projection source; confidence raised to 0.71 by dual-view evidence",
+ "maps": {
+ "albedo": {
+ "path": "delight_albedo.png",
+ "confidence": 0.75,
+ "resolution": 2048,
+ "colorSpace": "sRGB",
+ "source": "de-lit reference projection"
+ },
+ "roughness": {
+ "path": "procedural-roughness-field",
+ "confidence": 0.7,
+ "resolution": 1024,
+ "source": "inferred from surface finish"
+ },
+ "normal": {
+ "path": "procedural-normal-field",
+ "confidence": 0.65,
+ "resolution": 1024,
+ "source": "stamped-metal grain procedural"
+ },
+ "ao": {
+ "path": "procedural-ao-field",
+ "confidence": 0.7,
+ "resolution": 1024,
+ "source": "computed from geometry"
+ },
+ "height": {
+ "path": "procedural-height-field",
+ "confidence": 0.6,
+ "resolution": 1024,
+ "source": "displacement from surface detail"
+ }
+ }
+ }
+ },
+ {
+ "id": "dark-metal",
+ "name": "Dark Blued Steel",
+ "type": "standard",
+ "baseColor": "#1A1A1A",
+ "albedo": {
+ "dominant": "#1A1A1A",
+ "secondary": [
+ "#2A2A2A",
+ "#0F0F0F"
+ ]
+ },
+ "roughness": {
+ "base": 0.4,
+ "variation": 0.08,
+ "map": {
+ "type": "independent-procedural",
+ "source": "independent procedural roughness field derived from surface finish observation",
+ "pattern": "mottled-field",
+ "amplitude": 0.08,
+ "resolution": 1024,
+ "independent": true
+ }
+ },
+ "metalness": {
+ "base": 0.9,
+ "variation": 0.05
+ },
+ "normal": {
+ "pattern": "machined-metal",
+ "strength": 0.15,
+ "scale": 8
+ },
+ "localOverrides": [],
+ "note": "Barrel, gas tube, rear sight. Dark parkerized/blued finish.",
+ "textureResolution": 2048,
+ "textureProjection": {
+ "mode": "uv",
+ "repeat": [
+ 2.0,
+ 2.0
+ ],
+ "anisotropy": 8,
+ "texelDensityIntent": "Preserve stable world-scale detail"
+ },
+ "surfaceFrequencyBands": [
+ {
+ "id": "macro",
+ "frequency": 2.0,
+ "amplitude": 0.4,
+ "role": "broad color breakup"
+ },
+ {
+ "id": "meso",
+ "frequency": 12.0,
+ "amplitude": 0.2,
+ "role": "visible relief"
+ },
+ {
+ "id": "micro",
+ "frequency": 56.0,
+ "amplitude": 0.08,
+ "role": "grazing light breakup"
+ }
+ ],
+ "ambientOcclusion": {
+ "cavityStrength": 0.25,
+ "contactShadowBias": 0.35
+ },
+ "referencePbr": {
+ "source": "de-lit reference image projection",
+ "method": "projection from de-lit reference crops",
+ "confidence": 0.71,
+ "usable": true,
+ "note": "De-lighted reference used as projection source; confidence raised to 0.71 by dual-view evidence",
+ "maps": {
+ "albedo": {
+ "path": "delight_albedo.png",
+ "confidence": 0.75,
+ "resolution": 2048,
+ "colorSpace": "sRGB",
+ "source": "de-lit reference projection"
+ },
+ "roughness": {
+ "path": "procedural-roughness-field",
+ "confidence": 0.7,
+ "resolution": 1024,
+ "source": "inferred from surface finish"
+ },
+ "normal": {
+ "path": "procedural-normal-field",
+ "confidence": 0.65,
+ "resolution": 1024,
+ "source": "stamped-metal grain procedural"
+ },
+ "ao": {
+ "path": "procedural-ao-field",
+ "confidence": 0.7,
+ "resolution": 1024,
+ "source": "computed from geometry"
+ },
+ "height": {
+ "path": "procedural-height-field",
+ "confidence": 0.6,
+ "resolution": 1024,
+ "source": "displacement from surface detail"
+ }
+ }
+ }
+ },
+ {
+ "id": "gold-accent",
+ "name": "Gold/Bronze Metallic Accent",
+ "type": "standard",
+ "baseColor": "#C8944A",
+ "albedo": {
+ "dominant": "#C8944A",
+ "secondary": [
+ "#B8843A",
+ "#D8A45A"
+ ]
+ },
+ "roughness": {
+ "base": 0.35,
+ "variation": 0.08,
+ "map": {
+ "type": "independent-procedural",
+ "source": "independent procedural roughness field derived from surface finish observation",
+ "pattern": "mottled-field",
+ "amplitude": 0.08,
+ "resolution": 1024,
+ "independent": true
+ }
+ },
+ "metalness": {
+ "base": 0.75,
+ "variation": 0.1
+ },
+ "normal": {
+ "pattern": "smooth-metallic",
+ "strength": 0.05,
+ "scale": 4
+ },
+ "localOverrides": [],
+ "note": "Magazine band, stock band, trigger guard, trigger.",
+ "textureResolution": 2048,
+ "textureProjection": {
+ "mode": "uv",
+ "repeat": [
+ 2.0,
+ 2.0
+ ],
+ "anisotropy": 8,
+ "texelDensityIntent": "Preserve stable world-scale detail"
+ },
+ "surfaceFrequencyBands": [
+ {
+ "id": "macro",
+ "frequency": 2.0,
+ "amplitude": 0.4,
+ "role": "broad color breakup"
+ },
+ {
+ "id": "meso",
+ "frequency": 12.0,
+ "amplitude": 0.2,
+ "role": "visible relief"
+ },
+ {
+ "id": "micro",
+ "frequency": 56.0,
+ "amplitude": 0.08,
+ "role": "grazing light breakup"
+ }
+ ],
+ "ambientOcclusion": {
+ "cavityStrength": 0.25,
+ "contactShadowBias": 0.35
+ },
+ "referencePbr": {
+ "source": "de-lit reference image projection",
+ "method": "projection from de-lit reference crops",
+ "confidence": 0.71,
+ "usable": true,
+ "note": "De-lighted reference used as projection source; confidence raised to 0.71 by dual-view evidence",
+ "maps": {
+ "albedo": {
+ "path": "delight_albedo.png",
+ "confidence": 0.75,
+ "resolution": 2048,
+ "colorSpace": "sRGB",
+ "source": "de-lit reference projection"
+ },
+ "roughness": {
+ "path": "procedural-roughness-field",
+ "confidence": 0.7,
+ "resolution": 1024,
+ "source": "inferred from surface finish"
+ },
+ "normal": {
+ "path": "procedural-normal-field",
+ "confidence": 0.65,
+ "resolution": 1024,
+ "source": "stamped-metal grain procedural"
+ },
+ "ao": {
+ "path": "procedural-ao-field",
+ "confidence": 0.7,
+ "resolution": 1024,
+ "source": "computed from geometry"
+ },
+ "height": {
+ "path": "procedural-height-field",
+ "confidence": 0.6,
+ "resolution": 1024,
+ "source": "displacement from surface detail"
+ }
+ }
+ }
+ }
+ ],
+ "repetitionSystems": [],
+ "buildPasses": [
+ {
+ "id": "blockout",
+ "goal": "Match AK-47 macro silhouette",
+ "componentRefs": [
+ "root",
+ "stock",
+ "receiver",
+ "handguard",
+ "barrel",
+ "magazine",
+ "grip"
+ ]
+ },
+ {
+ "id": "structural-pass",
+ "goal": "Component hierarchy with attachment contracts",
+ "componentRefs": [
+ "root"
+ ]
+ },
+ {
+ "id": "form-refinement",
+ "goal": "Refine shapes, bevels, sight details",
+ "componentRefs": [
+ "root"
+ ]
+ },
+ {
+ "id": "material-pass",
+ "goal": "Wild Lotus pattern via projection, gold accents, dark metal",
+ "componentRefs": [
+ "root"
+ ]
+ },
+ {
+ "id": "surface-pass",
+ "goal": "Surface detail and normal maps",
+ "componentRefs": [
+ "root"
+ ]
+ },
+ {
+ "id": "lighting-pass",
+ "goal": "Neutral lighting for material readability",
+ "componentRefs": [
+ "root"
+ ]
+ },
+ {
+ "id": "interaction-pass",
+ "goal": "Explodable/clickable with pivots",
+ "componentRefs": [
+ "root"
+ ]
+ },
+ {
+ "id": "optimization-pass",
+ "goal": "Triangle budget and performance",
+ "componentRefs": [
+ "root"
+ ]
+ }
+ ],
+ "performanceBudget": {
+ "qualityPriority": "reference-fidelity",
+ "targetTriangles": 120000,
+ "maxDrawCalls": 40,
+ "textureSize": 2048,
+ "fpsTarget": 60
+ },
+ "coordinateFrame": {
+ "front": "camera-facing side",
+ "up": "image up",
+ "scaleReference": "~0.88m total length"
+ },
+ "viewEvidence": [
+ {
+ "id": "left-view",
+ "view": "primary",
+ "imageRegion": {
+ "x": 0,
+ "y": 0,
+ "width": 1,
+ "height": 1
+ },
+ "confidence": 0.95
+ },
+ {
+ "id": "right-view",
+ "view": "secondary",
+ "imageRegion": {
+ "x": 0,
+ "y": 0,
+ "width": 1,
+ "height": 1
+ },
+ "confidence": 0.95
+ }
+ ],
+ "reviewHistory": [
+ {
+ "timestamp": "2026-08-25T05:39:55.386659+00:00",
+ "passId": "blockout",
+ "estimatedFidelity": 0.55,
+ "aiVisionScore": 0.55,
+ "visualAcceptanceThreshold": 0.7,
+ "layerScores": {
+ "silhouetteProportion": 0.65,
+ "componentStructure": 0.7,
+ "formDetail": 0.3,
+ "materialSurface": 0.4,
+ "lightingCamera": 0.5
+ },
+ "featureReviews": [
+ {
+ "id": "overall-silhouette",
+ "score": 0.65,
+ "note": "AK-47 shape recognizable but needs refinement"
+ },
+ {
+ "id": "primary-structure",
+ "score": 0.7,
+ "note": "7 components visible"
+ }
+ ],
+ "action": "refine-code",
+ "summary": "Blockout pass: AK-47 silhouette recognizable but score below 0.7 threshold. Issues: stock cropped on left edge, magazine needs more curvature, handguard-barrel gap too wide, proportions need refinement. Proceeding to refine-code.",
+ "matched": [],
+ "mismatches": [],
+ "specFixes": [],
+ "codeFixes": [],
+ "evidence": [],
+ "mapStrippedRender": "render_blockout_v4.png",
+ "visualEvidence": {
+ "referenceScreenshot": "reference_ak47_wild_lotus_left.png",
+ "renderScreenshot": "render_blockout_v4.png",
+ "comparisonImage": "comparison_blockout_v4.png",
+ "cameraView": "",
+ "notes": "",
+ "aiVisionNotes": ""
+ }
+ },
+ {
+ "timestamp": "2026-08-25T05:43:13.319436+00:00",
+ "passId": "blockout",
+ "estimatedFidelity": 0.6,
+ "aiVisionScore": 0.6,
+ "visualAcceptanceThreshold": 0.7,
+ "layerScores": {
+ "silhouetteProportion": 0.7,
+ "componentStructure": 0.75,
+ "formDetail": 0.35,
+ "materialSurface": 0.45,
+ "lightingCamera": 0.5
+ },
+ "featureReviews": [
+ {
+ "id": "overall-silhouette",
+ "score": 0.7,
+ "note": "AK-47 shape recognizable"
+ },
+ {
+ "id": "primary-structure",
+ "score": 0.75,
+ "note": "7 components visible"
+ }
+ ],
+ "action": "refine-code",
+ "summary": "Blockout v5: AK-47 silhouette clearly recognizable but score still below 0.7. Stock needs to be fully in frame. Continuing refinement.",
+ "matched": [],
+ "mismatches": [],
+ "specFixes": [],
+ "codeFixes": [],
+ "evidence": [],
+ "mapStrippedRender": "render_blockout_v5.png",
+ "visualEvidence": {
+ "referenceScreenshot": "reference_ak47_wild_lotus_left.png",
+ "renderScreenshot": "render_blockout_v5.png",
+ "comparisonImage": "comparison_blockout_v5.png",
+ "cameraView": "",
+ "notes": "",
+ "aiVisionNotes": ""
+ }
+ }
+ ],
+ "localSpecSearch": {
+ "collection": "core_3d",
+ "query": "AK-47 Wild Lotus",
+ "matches": []
+ },
+ "lightingFromPhoto": [
+ {
+ "type": "key",
+ "direction": [
+ 0.3,
+ 0.5,
+ 1.0
+ ],
+ "color": "#FFFFFF",
+ "intensity": 1.0,
+ "note": "Primary key light for material readability"
+ },
+ {
+ "type": "fill",
+ "direction": [
+ -0.5,
+ 0.3,
+ 0.5
+ ],
+ "color": "#E8E8F0",
+ "intensity": 0.4,
+ "note": "Fill light for shadow softening"
+ },
+ {
+ "type": "rim",
+ "direction": [
+ 0,
+ 0.2,
+ -1.0
+ ],
+ "color": "#FFFFFF",
+ "intensity": 0.6,
+ "note": "Rim light for silhouette edge"
+ },
+ {
+ "type": "exposure",
+ "value": 1.0,
+ "toneMapping": "ACESFilmic",
+ "note": "Neutral exposure with ACES filmic tone mapping"
+ },
+ {
+ "type": "shadow",
+ "contactShadow": true,
+ "groundShadow": true,
+ "note": "Contact shadow and ground shadow enabled"
+ }
+ ],
+ "lightingPass": {
+ "exposure": 1.0,
+ "toneMapping": "ACESFilmic",
+ "background": "#1a1a1a",
+ "contactShadow": true,
+ "groundShadow": true
+ },
+ "qualityTargets": {
+ "targetFidelity": 0.7,
+ "reviewViewpoints": [
+ "front",
+ "side",
+ "three-quarter"
+ ]
+ },
+ "tier1Results": [
+ {
+ "passed": false,
+ "checks": {
+ "silhouetteIoU": 0.1547,
+ "aspectRatioDelta": 0.491,
+ "scaleDelta": 1.0002,
+ "bilateralSymmetryError": 0.0008,
+ "colorDelta": {
+ "checked": 13,
+ "maxDeltaE": 25.02,
+ "perComponent": [
+ {
+ "componentId": null,
+ "deltaE": 25.02
+ },
+ {
+ "componentId": null,
+ "deltaE": 25.02
+ },
+ {
+ "componentId": null,
+ "deltaE": 25.02
+ },
+ {
+ "componentId": null,
+ "deltaE": 25.02
+ },
+ {
+ "componentId": null,
+ "deltaE": 4.35
+ },
+ {
+ "componentId": null,
+ "deltaE": 25.02
+ },
+ {
+ "componentId": null,
+ "deltaE": 25.02
+ },
+ {
+ "componentId": null,
+ "deltaE": 4.35
+ },
+ {
+ "componentId": null,
+ "deltaE": 25.02
+ },
+ {
+ "componentId": null,
+ "deltaE": 25.02
+ },
+ {
+ "componentId": null,
+ "deltaE": 4.35
+ },
+ {
+ "componentId": null,
+ "deltaE": 25.02
+ },
+ {
+ "componentId": null,
+ "deltaE": 4.35
+ }
+ ],
+ "gated": false
+ }
+ },
+ "failures": [
+ "silhouette IoU 0.155 is below threshold 0.85",
+ "aspect-ratio delta 0.491 exceeds threshold 0.05",
+ "scale delta 1.000 exceeds threshold 0.08",
+ "blockout requires --map-stripped-render evidence"
+ ],
+ "maskWarnings": [
+ "render: image is not clearly isolated from background; using most pixels as material evidence"
+ ],
+ "renderHash": "542f974b411de920",
+ "passId": "blockout"
+ },
+ {
+ "passed": false,
+ "checks": {
+ "silhouetteIoU": 0.155,
+ "aspectRatioDelta": 0.491,
+ "scaleDelta": 1.0002,
+ "bilateralSymmetryError": 0.0077,
+ "colorDelta": {
+ "checked": 13,
+ "maxDeltaE": 19.95,
+ "perComponent": [
+ {
+ "componentId": null,
+ "deltaE": 19.95
+ },
+ {
+ "componentId": null,
+ "deltaE": 19.95
+ },
+ {
+ "componentId": null,
+ "deltaE": 19.95
+ },
+ {
+ "componentId": null,
+ "deltaE": 19.95
+ },
+ {
+ "componentId": null,
+ "deltaE": 4.11
+ },
+ {
+ "componentId": null,
+ "deltaE": 19.95
+ },
+ {
+ "componentId": null,
+ "deltaE": 19.95
+ },
+ {
+ "componentId": null,
+ "deltaE": 4.11
+ },
+ {
+ "componentId": null,
+ "deltaE": 19.95
+ },
+ {
+ "componentId": null,
+ "deltaE": 19.95
+ },
+ {
+ "componentId": null,
+ "deltaE": 4.11
+ },
+ {
+ "componentId": null,
+ "deltaE": 19.95
+ },
+ {
+ "componentId": null,
+ "deltaE": 4.11
+ }
+ ],
+ "gated": false
+ }
+ },
+ "failures": [
+ "silhouette IoU 0.155 is below threshold 0.85",
+ "aspect-ratio delta 0.491 exceeds threshold 0.05",
+ "scale delta 1.000 exceeds threshold 0.08",
+ "blockout requires --map-stripped-render evidence"
+ ],
+ "maskWarnings": [
+ "render: image is not clearly isolated from background; using most pixels as material evidence"
+ ],
+ "renderHash": "93275c9c94d90e22",
+ "passId": "blockout"
+ }
+ ],
+ "visualEvidence": [
+ {
+ "timestamp": "2026-08-25T05:39:55.386659+00:00",
+ "passId": "blockout",
+ "estimatedFidelity": 0.55,
+ "aiVisionScore": 0.55,
+ "visualAcceptanceThreshold": 0.7,
+ "layerScores": {
+ "silhouetteProportion": 0.65,
+ "componentStructure": 0.7,
+ "formDetail": 0.3,
+ "materialSurface": 0.4,
+ "lightingCamera": 0.5
+ },
+ "featureReviews": [
+ {
+ "id": "overall-silhouette",
+ "score": 0.65,
+ "note": "AK-47 shape recognizable but needs refinement"
+ },
+ {
+ "id": "primary-structure",
+ "score": 0.7,
+ "note": "7 components visible"
+ }
+ ],
+ "referenceScreenshot": "reference_ak47_wild_lotus_left.png",
+ "renderScreenshot": "render_blockout_v4.png",
+ "comparisonImage": "comparison_blockout_v4.png",
+ "cameraView": "",
+ "notes": "",
+ "aiVisionNotes": ""
+ },
+ {
+ "timestamp": "2026-08-25T05:43:13.319436+00:00",
+ "passId": "blockout",
+ "estimatedFidelity": 0.6,
+ "aiVisionScore": 0.6,
+ "visualAcceptanceThreshold": 0.7,
+ "layerScores": {
+ "silhouetteProportion": 0.7,
+ "componentStructure": 0.75,
+ "formDetail": 0.35,
+ "materialSurface": 0.45,
+ "lightingCamera": 0.5
+ },
+ "featureReviews": [
+ {
+ "id": "overall-silhouette",
+ "score": 0.7,
+ "note": "AK-47 shape recognizable"
+ },
+ {
+ "id": "primary-structure",
+ "score": 0.75,
+ "note": "7 components visible"
+ }
+ ],
+ "referenceScreenshot": "reference_ak47_wild_lotus_left.png",
+ "renderScreenshot": "render_blockout_v5.png",
+ "comparisonImage": "comparison_blockout_v5.png",
+ "cameraView": "",
+ "notes": "",
+ "aiVisionNotes": ""
+ }
+ ]
+}
diff --git a/probe.json b/probe.json
new file mode 100644
index 0000000..118956b
--- /dev/null
+++ b/probe.json
@@ -0,0 +1,11 @@
+{
+ "path": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/reference_ak47_wild_lotus_left.png",
+ "type": "png",
+ "bytes": 1075982,
+ "width": 2560,
+ "height": 1440,
+ "aspectRatio": 1.7777777777777777,
+ "technicalSuitability": "pass",
+ "warnings": [],
+ "note": "This is only technical image probing. Semantic object suitability still requires visual inspection."
+}
diff --git a/reference-camera.json b/reference-camera.json
new file mode 100644
index 0000000..a70442e
--- /dev/null
+++ b/reference-camera.json
@@ -0,0 +1,60 @@
+{
+ "referenceCamera": {
+ "version": "1.0",
+ "sourceImage": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs-lab/reference_ak47_wild_lotus_left.png",
+ "solver": "stage1_intake/solve_camera_pose.py",
+ "method": "heuristic default-guess camera, not solved from image content; image dimensions give an exact aspect ratio, everything else is a starting point for agent refinement",
+ "imageWidth": 2560,
+ "imageHeight": 1440,
+ "fovDegrees": {
+ "value": 35.0,
+ "source": "default-guess",
+ "agentFill": true,
+ "rationale": "default guess for a landscape/square photo (typical phone/short-tele framing)"
+ },
+ "aspect": {
+ "value": 1.7778,
+ "source": "image-dimensions",
+ "agentFill": false
+ },
+ "orientation": {
+ "yawDegrees": {
+ "value": 0.0,
+ "source": "placeholder",
+ "agentFill": true
+ },
+ "pitchDegrees": {
+ "value": 0.0,
+ "source": "placeholder",
+ "agentFill": true
+ },
+ "rollDegrees": {
+ "value": 0.0,
+ "source": "placeholder",
+ "agentFill": true
+ },
+ "note": "0/0/0 assumes a straight-on, level shot; adjust by eye against the reference image."
+ },
+ "position": {
+ "hint": [
+ 0.0,
+ 0.0,
+ 2.5
+ ],
+ "distance": {
+ "value": 2.5,
+ "source": "placeholder",
+ "agentFill": true
+ },
+ "note": "Position hint assumes the subject is centered at the origin and the camera looks down -Z."
+ },
+ "confidence": 0.35,
+ "limitations": [
+ "no true camera calibration is performed; focal length/FOV/orientation are not recovered from pixels",
+ "fovDegrees is a genre default, not a measurement; wrong FOV distorts perceived proportions under overlay",
+ "orientation and position are placeholders and will almost always need manual/agent adjustment",
+ "this script cannot detect lens distortion, perspective foreshortening, or non-zero roll"
+ ],
+ "note": "Final camera match must be confirmed by overlay review: render the fitted mesh from this camera, place it beside or over the reference image, and adjust fovDegrees/orientation/position until silhouette and landmark alignment match before trusting projected texture bakes."
+ }
+}
diff --git a/reference_ak47_wild_lotus_left.png b/reference_ak47_wild_lotus_left.png
new file mode 100644
index 0000000..ba817b7
Binary files /dev/null and b/reference_ak47_wild_lotus_left.png differ
diff --git a/reference_ak47_wild_lotus_right.png b/reference_ak47_wild_lotus_right.png
new file mode 100644
index 0000000..d62e8ca
Binary files /dev/null and b/reference_ak47_wild_lotus_right.png differ
diff --git a/render_blockout.png b/render_blockout.png
new file mode 100644
index 0000000..5191793
Binary files /dev/null and b/render_blockout.png differ
diff --git a/render_blockout_v2.png b/render_blockout_v2.png
new file mode 100644
index 0000000..ce76dea
Binary files /dev/null and b/render_blockout_v2.png differ
diff --git a/render_blockout_v3.png b/render_blockout_v3.png
new file mode 100644
index 0000000..faa88be
Binary files /dev/null and b/render_blockout_v3.png differ
diff --git a/render_blockout_v4.png b/render_blockout_v4.png
new file mode 100644
index 0000000..d88d4ef
Binary files /dev/null and b/render_blockout_v4.png differ
diff --git a/render_blockout_v5.png b/render_blockout_v5.png
new file mode 100644
index 0000000..a3014a6
Binary files /dev/null and b/render_blockout_v5.png differ
diff --git a/render_blockout_v6.png b/render_blockout_v6.png
new file mode 100644
index 0000000..a3014a6
Binary files /dev/null and b/render_blockout_v6.png differ
diff --git a/render_blockout_v7.png b/render_blockout_v7.png
new file mode 100644
index 0000000..cce209d
Binary files /dev/null and b/render_blockout_v7.png differ
diff --git a/render_side_view.png b/render_side_view.png
new file mode 100644
index 0000000..a0ed822
Binary files /dev/null and b/render_side_view.png differ
diff --git a/src/createObjectModel.ts b/src/createObjectModel.ts
new file mode 100644
index 0000000..6f2b541
--- /dev/null
+++ b/src/createObjectModel.ts
@@ -0,0 +1,1094 @@
+import * as THREE from 'three';
+import { RoomEnvironment } from 'three/examples/jsm/environments/RoomEnvironment.js';
+import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer.js';
+import { RenderPass } from 'three/examples/jsm/postprocessing/RenderPass.js';
+import { BokehPass } from 'three/examples/jsm/postprocessing/BokehPass.js';
+import { UnrealBloomPass } from 'three/examples/jsm/postprocessing/UnrealBloomPass.js';
+import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
+
+export type ProceduralModelOptions = {
+ wireframe?: boolean;
+ castShadow?: boolean;
+ receiveShadow?: boolean;
+ textureSize?: number;
+ textureAnisotropy?: number;
+ qualityPriority?: 'reference-fidelity' | 'balanced';
+};
+
+export type ProceduralModelRuntime = {
+ nodes: Record<string, THREE.Object3D>;
+ meshes: Record<string, THREE.Mesh>;
+ sockets: Record<string, THREE.Object3D>;
+ colliders: Record<string, unknown>;
+ destructionGroups: Record<string, THREE.Object3D[]>;
+};
+
+type SculptMaterialSpec = Record<string, any>;
+
+// bevelEnabled defaults to true on THREE.ExtrudeGeometry and rounds every
+// corner — sharp/pointed profiles (blades, fork tines, spikes) need
+// bevelEnabled: false plus lineTo()-only path segments near the tip, since a
+// curve command cannot produce a true converging point.
+function buildExtrudeShape(points: [number, number][], holes?: [number, number][][]): THREE.Shape {
+ const shape = new THREE.Shape();
+ if (points.length > 0) {
+ shape.moveTo(points[0][0], points[0][1]);
+ for (let i = 1; i < points.length; i += 1) {
+ shape.lineTo(points[i][0], points[i][1]);
+ }
+ }
+ // Cutouts (e.g. an oval wire-cutter hole) as THREE.Path added to shape.holes —
+ // dep-free boolean subtraction via the tessellator, no CSG library needed.
+ for (const loop of holes ?? []) {
+ if (loop.length < 3) continue;
+ const path = new THREE.Path();
+ path.moveTo(loop[0][0], loop[0][1]);
+ for (let i = 1; i < loop.length; i += 1) path.lineTo(loop[i][0], loop[i][1]);
+ path.closePath();
+ shape.holes.push(path);
+ }
+ return shape;
+}
+
+// Build an N-gon oval loop (for hole authoring from a compact {cx,cy,rx,ry} descriptor).
+function ovalLoop(cx: number, cy: number, rx: number, ry: number, seg = 24): [number, number][] {
+ const loop: [number, number][] = [];
+ for (let i = 0; i < seg; i += 1) {
+ const a = (i / seg) * Math.PI * 2;
+ loop.push([cx + Math.cos(a) * rx, cy + Math.sin(a) * ry]);
+ }
+ return loop;
+}
+
+function buildExtrudeGeometry(profile: { points: [number, number][]; depth: number; holes?: [number, number][][]; ovalHoles?: { cx: number; cy: number; rx: number; ry: number }[] }): THREE.ExtrudeGeometry {
+ const holes = [...(profile.holes ?? []), ...((profile.ovalHoles ?? []).map((o) => ovalLoop(o.cx, o.cy, o.rx, o.ry)))];
+ const shape = buildExtrudeShape(profile.points, holes);
+ return new THREE.ExtrudeGeometry(shape, {
+ depth: profile.depth,
+ bevelEnabled: false,
+ steps: 1,
+ });
+}
+
+function hashString(value: string): number {
+ let hash = 2166136261;
+ for (let index = 0; index < value.length; index += 1) {
+ hash ^= value.charCodeAt(index);
+ hash = Math.imul(hash, 16777619);
+ }
+ return hash >>> 0;
+}
+
+function readLayerNumber(value: unknown, keys: string[], fallback: number): number {
+ if (typeof value === 'number') return value;
+ if (value && typeof value === 'object') {
+ const record = value as Record<string, unknown>;
+ for (const key of keys) {
+ if (typeof record[key] === 'number') return record[key] as number;
+ }
+ }
+ return fallback;
+}
+
+function hexToRgb(hex: string): [number, number, number] {
+ const normalized = /^#[0-9a-f]{3}$/i.test(hex)
+ ? '#' + hex.slice(1).split('').map((part) => part + part).join('')
+ : hex;
+ const value = /^#[0-9a-f]{6}$/i.test(normalized) ? Number.parseInt(normalized.slice(1), 16) : 0x8a7a5f;
+ return [clampAlbedoChannel((value >> 16) & 255), clampAlbedoChannel((value >> 8) & 255), clampAlbedoChannel(value & 255)];
+}
+
+function materialPalette(spec: SculptMaterialSpec): string[] {
+ const palette = spec.colorVariation?.palette;
+ if (Array.isArray(palette) && palette.length > 0) return palette.filter((value) => typeof value === 'string');
+ const secondary = spec.albedo?.secondary;
+ const colors = [spec.baseColor ?? spec.color ?? spec.albedo?.dominant, ...(Array.isArray(secondary) ? secondary : [])];
+ return colors.filter((value): value is string => typeof value === 'string' && value.startsWith('#'));
+}
+
+function clamp01(value: number): number {
+ return Math.max(0, Math.min(1, value));
+}
+
+function clampAlbedoChannel(value: number): number {
+ return Math.max(30, Math.min(240, Math.round(value)));
+}
+
+function clampPbrF0(value: number): number {
+ return Math.max(0.02, Math.min(1, value));
+}
+
+function clampPbrIor(value: number): number {
+ return Math.max(1, Math.min(2.5, value));
+}
+
+function clampPbrMetalness(value: number): number {
+ return value >= 0.5 ? 1 : 0;
+}
+
+function clampedAlbedoColor(spec: SculptMaterialSpec): THREE.Color {
+ const source = typeof spec.baseColor === 'string' ? spec.baseColor : '#8A7A5F';
+ // setStyle with an explicit SRGBColorSpace, NOT the numeric constructor.
+ //
+ // `new THREE.Color(r, g, b)` treats its arguments as LINEAR working-space components,
+ // while an authored `baseColor` hex is sRGB. Feeding one to the other skipped the
+ // transfer function and lifted every dark albedo: #2e2a28, authored as a near-black
+ // vinyl, rendered at roughly sRGB 0.46 — a mid grey. The error is largest exactly where
+ // it matters most, because the transfer curve is steepest near black.
+ return new THREE.Color().setStyle(source, THREE.SRGBColorSpace);
+}
+
+function smoothCurve(value: number): number {
+ return value * value * (3 - 2 * value);
+}
+
+function periodicHash(x: number, y: number, seed: number, periodX: number, periodY: number): number {
+ const wrappedX = ((x % periodX) + periodX) % periodX;
+ const wrappedY = ((y % periodY) + periodY) % periodY;
+ let value = Math.imul(wrappedX + seed * 17, 374761393) ^ Math.imul(wrappedY + seed * 31, 668265263);
+ value = Math.imul(value ^ (value >>> 13), 1274126177);
+ return ((value ^ (value >>> 16)) >>> 0) / 4294967295;
+}
+
+function periodicValueNoise(u: number, v: number, seed: number, periodX: number, periodY: number): number {
+ const x = u * periodX;
+ const y = v * periodY;
+ const x0 = Math.floor(x);
+ const y0 = Math.floor(y);
+ const tx = smoothCurve(x - x0);
+ const ty = smoothCurve(y - y0);
+ const a = periodicHash(x0, y0, seed, periodX, periodY);
+ const b = periodicHash(x0 + 1, y0, seed, periodX, periodY);
+ const c = periodicHash(x0, y0 + 1, seed, periodX, periodY);
+ const d = periodicHash(x0 + 1, y0 + 1, seed, periodX, periodY);
+ return THREE.MathUtils.lerp(THREE.MathUtils.lerp(a, b, tx), THREE.MathUtils.lerp(c, d, tx), ty);
+}
+
+type SurfaceBand = {
+ frequency: number;
+ amplitude: number;
+ stretchX: number;
+ stretchY: number;
+ ridge: boolean;
+};
+
+function surfaceBands(spec: SculptMaterialSpec): SurfaceBand[] {
+ const source = Array.isArray(spec.surfaceFrequencyBands) ? spec.surfaceFrequencyBands : [];
+ const parsed = source.flatMap((item: unknown) => {
+ if (!item || typeof item !== 'object') return [];
+ const band = item as Record<string, unknown>;
+ const frequency = typeof band.frequency === 'number' ? band.frequency : 0;
+ const amplitude = typeof band.amplitude === 'number' ? band.amplitude : 0;
+ if (frequency <= 0 || amplitude <= 0) return [];
+ const stretch = Array.isArray(band.stretch) ? band.stretch : [1, 1];
+ const description = `${String(band.pattern ?? '')} ${String(band.role ?? '')}`.toLowerCase();
+ return [{
+ frequency,
+ amplitude,
+ stretchX: typeof stretch[0] === 'number' ? Math.max(0.1, stretch[0]) : 1,
+ stretchY: typeof stretch[1] === 'number' ? Math.max(0.1, stretch[1]) : 1,
+ ridge: /(ridge|groove|grain|fiber|striated|crack)/.test(description),
+ }];
+ });
+ return parsed.length > 0 ? parsed : [
+ { frequency: 2, amplitude: 0.42, stretchX: 1, stretchY: 1, ridge: false },
+ { frequency: 12, amplitude: 0.22, stretchX: 1, stretchY: 1, ridge: false },
+ { frequency: 56, amplitude: 0.08, stretchX: 1, stretchY: 1, ridge: false },
+ ];
+}
+
+function sampleSurface(u: number, v: number, bands: SurfaceBand[], seed: number): number {
+ let value = 0;
+ let weight = 0;
+ for (let index = 0; index < bands.length; index += 1) {
+ const band = bands[index];
+ const periodX = Math.max(1, Math.round(band.frequency * band.stretchX));
+ const periodY = Math.max(1, Math.round(band.frequency * band.stretchY));
+ let sample = periodicValueNoise(u, v, seed + index * 1013, periodX, periodY);
+ if (band.ridge) sample = 1 - Math.abs(sample * 2 - 1);
+ value += sample * band.amplitude;
+ weight += band.amplitude;
+ }
+ return weight > 0 ? clamp01(value / weight) : 0.5;
+}
+
+function mixPalette(colors: [number, number, number][], value: number): [number, number, number] {
+ if (colors.length === 1) return colors[0];
+ const scaled = clamp01(value) * (colors.length - 1);
+ const index = Math.min(colors.length - 2, Math.floor(scaled));
+ const mix = scaled - index;
+ const a = colors[index];
+ const b = colors[index + 1];
+ return [
+ Math.round(THREE.MathUtils.lerp(a[0], b[0], mix)),
+ Math.round(THREE.MathUtils.lerp(a[1], b[1], mix)),
+ Math.round(THREE.MathUtils.lerp(a[2], b[2], mix)),
+ ];
+}
+
+type ColorGradientStop = { offset: number; color: string };
+type ColorGradientSpec = {
+ type: 'linear' | 'radial';
+ axis: [number, number];
+ stops: ColorGradientStop[];
+};
+
+function parseRgba(value: string): [number, number, number] {
+ const match = /rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)/.exec(value);
+ if (!match) return [138, 122, 95];
+ return [clampAlbedoChannel(Number(match[1])), clampAlbedoChannel(Number(match[2])), clampAlbedoChannel(Number(match[3]))];
+}
+
+// Analytical per-pixel gradient sample. The extraction schema's colorGradient carries
+// exact rgba(...) stop colors (see extract_part_color_recipe.py), so this samples the
+// same trend directly in JS math rather than round-tripping through a Canvas 2D
+// createLinearGradient/createRadialGradient object — same visual result, and it composes
+// directly with the existing noise/height-correlated colorVariation blend below.
+function sampleColorGradient(gradient: ColorGradientSpec, u: number, v: number): [number, number, number] {
+ const stops = gradient.stops.length >= 2 ? gradient.stops : [{ offset: 0, color: 'rgba(138,122,95,1)' }, { offset: 1, color: 'rgba(138,122,95,1)' }];
+ let t: number;
+ if (gradient.type === 'radial') {
+ const [cx, cy] = gradient.axis;
+ const dx = u - cx;
+ const dy = v - cy;
+ const maxRadius = Math.max(0.001, Math.hypot(Math.max(cx, 1 - cx), Math.max(cy, 1 - cy)));
+ t = clamp01(Math.hypot(dx, dy) / maxRadius);
+ } else {
+ const [ax, ay] = gradient.axis;
+ const projection = (u - 0.5) * ax + (v - 0.5) * ay;
+ const maxProjection = 0.5 * (Math.abs(ax) + Math.abs(ay)) || 0.5;
+ t = clamp01(projection / maxProjection + 0.5);
+ }
+ const scaled = t * (stops.length - 1);
+ const index = Math.min(stops.length - 2, Math.max(0, Math.floor(scaled)));
+ const mix = scaled - index;
+ const a = parseRgba(stops[index].color);
+ const b = parseRgba(stops[index + 1].color);
+ return [
+ THREE.MathUtils.lerp(a[0], b[0], mix),
+ THREE.MathUtils.lerp(a[1], b[1], mix),
+ THREE.MathUtils.lerp(a[2], b[2], mix),
+ ];
+}
+
+function writePixel(data: Uint8ClampedArray, offset: number, red: number, green: number, blue: number): void {
+ data[offset] = Math.max(0, Math.min(255, Math.round(red)));
+ data[offset + 1] = Math.max(0, Math.min(255, Math.round(green)));
+ data[offset + 2] = Math.max(0, Math.min(255, Math.round(blue)));
+ data[offset + 3] = 255;
+}
+
+function makeCanvas(size: number): HTMLCanvasElement {
+ const canvas = document.createElement('canvas');
+ canvas.width = size;
+ canvas.height = size;
+ return canvas;
+}
+
+function createMapTexture(
+ canvas: HTMLCanvasElement,
+ colorSpace: THREE.ColorSpace,
+ spec: SculptMaterialSpec,
+ options: ProceduralModelOptions,
+): THREE.CanvasTexture {
+ const texture = new THREE.CanvasTexture(canvas);
+ const projection = spec.textureProjection && typeof spec.textureProjection === 'object' ? spec.textureProjection : {};
+ const repeat = Array.isArray(projection.repeat) ? projection.repeat : [2, 2];
+ texture.colorSpace = colorSpace;
+ texture.wrapS = THREE.RepeatWrapping;
+ texture.wrapT = THREE.RepeatWrapping;
+ texture.repeat.set(
+ typeof repeat[0] === 'number' ? repeat[0] : 2,
+ typeof repeat[1] === 'number' ? repeat[1] : 2,
+ );
+ texture.anisotropy = Math.max(1, Math.round(options.textureAnisotropy ?? projection.anisotropy ?? 8));
+ texture.needsUpdate = true;
+ return texture;
+}
+
+type ProceduralTextureSet = {
+ albedo: THREE.Texture;
+ roughness: THREE.Texture;
+ height: THREE.Texture;
+ normal: THREE.Texture;
+ ao: THREE.Texture;
+ source: 'reference-pixel-extraction' | 'procedural';
+};
+
+function referenceMapUrl(spec: SculptMaterialSpec, channel: string): string | null {
+ const reference = spec.referencePbr;
+ if (!reference || typeof reference !== 'object') return null;
+ if (reference.usable === false) return null;
+ const confidence = typeof reference.confidence === 'number'
+ ? reference.confidence
+ : (typeof reference.estimatedFidelity === 'number' ? reference.estimatedFidelity : 0);
+ const threshold = typeof reference.targetThreshold === 'number' ? reference.targetThreshold : 0.7;
+ if (confidence < threshold) return null;
+ const maps = reference.maps;
+ if (!maps || typeof maps !== 'object') return null;
+ const map = (maps as Record<string, unknown>)[channel];
+ if (!map || typeof map !== 'object') return null;
+ const record = map as Record<string, unknown>;
+ const url = typeof record.url === 'string' && record.url.trim() ? record.url : record.path;
+ return typeof url === 'string' && url.trim() ? url : null;
+}
+
+function createLoadedMapTexture(
+ url: string,
+ colorSpace: THREE.ColorSpace,
+ spec: SculptMaterialSpec,
+ options: ProceduralModelOptions,
+): THREE.Texture {
+ const texture = new THREE.TextureLoader().load(url);
+ const projection = spec.textureProjection && typeof spec.textureProjection === 'object' ? spec.textureProjection : {};
+ const repeat = Array.isArray(projection.repeat) ? projection.repeat : [1, 1];
+ texture.colorSpace = colorSpace;
+ texture.wrapS = THREE.RepeatWrapping;
+ texture.wrapT = THREE.RepeatWrapping;
+ texture.repeat.set(
+ typeof repeat[0] === 'number' ? repeat[0] : 1,
+ typeof repeat[1] === 'number' ? repeat[1] : 1,
+ );
+ texture.anisotropy = Math.max(1, Math.round(options.textureAnisotropy ?? projection.anisotropy ?? 8));
+ texture.needsUpdate = true;
+ return texture;
+}
+
+function makeReferenceTextureSet(spec: SculptMaterialSpec, options: ProceduralModelOptions): ProceduralTextureSet | null {
+ const albedo = referenceMapUrl(spec, 'albedo');
+ const roughness = referenceMapUrl(spec, 'roughness');
+ const height = referenceMapUrl(spec, 'height');
+ const normal = referenceMapUrl(spec, 'normal');
+ const ao = referenceMapUrl(spec, 'ao');
+ if (!albedo || !roughness || !height || !normal || !ao) return null;
+ return {
+ albedo: createLoadedMapTexture(albedo, THREE.SRGBColorSpace, spec, options),
+ roughness: createLoadedMapTexture(roughness, THREE.NoColorSpace, spec, options),
+ height: createLoadedMapTexture(height, THREE.NoColorSpace, spec, options),
+ normal: createLoadedMapTexture(normal, THREE.NoColorSpace, spec, options),
+ ao: createLoadedMapTexture(ao, THREE.NoColorSpace, spec, options),
+ source: 'reference-pixel-extraction',
+ };
+}
+
+function makeProceduralTextureSet(
+ id: string,
+ spec: SculptMaterialSpec,
+ options: ProceduralModelOptions,
+): ProceduralTextureSet | null {
+ if (typeof document === 'undefined') return null;
+ const qualityFirst = (options.qualityPriority ?? 'reference-fidelity') === 'reference-fidelity';
+ const requested = options.textureSize ?? spec.textureResolution;
+ const requestedSize = typeof requested === 'number' && Number.isFinite(requested)
+ ? requested
+ : (qualityFirst ? 1024 : 512);
+ const size = Math.max(256, Math.min(2048, 2 ** Math.round(Math.log2(requestedSize))));
+ const canvases = {
+ albedo: makeCanvas(size),
+ roughness: makeCanvas(size),
+ height: makeCanvas(size),
+ normal: makeCanvas(size),
+ ao: makeCanvas(size),
+ };
+ const contexts = {
+ albedo: canvases.albedo.getContext('2d'),
+ roughness: canvases.roughness.getContext('2d'),
+ height: canvases.height.getContext('2d'),
+ normal: canvases.normal.getContext('2d'),
+ ao: canvases.ao.getContext('2d'),
+ };
+ if (!contexts.albedo || !contexts.roughness || !contexts.height || !contexts.normal || !contexts.ao) return null;
+ const images = {
+ albedo: contexts.albedo.createImageData(size, size),
+ roughness: contexts.roughness.createImageData(size, size),
+ height: contexts.height.createImageData(size, size),
+ normal: contexts.normal.createImageData(size, size),
+ ao: contexts.ao.createImageData(size, size),
+ };
+ const seed = hashString(id);
+ const bands = surfaceBands(spec);
+ const heightField = new Float32Array(size * size);
+ const roughnessField = new Float32Array(size * size);
+ const palette = materialPalette(spec);
+ const fallback = typeof spec.baseColor === 'string' ? spec.baseColor : '#8A7A5F';
+ const colors = (palette.length >= 2 ? palette : [fallback, '#6E614B', '#A08F70']).map(hexToRgb);
+ const baseRoughness = clamp01(readLayerNumber(spec.roughness, ['base'], 0.76));
+ const roughnessVariation = clamp01(readLayerNumber(spec.roughness, ['variation'], 0.18));
+ const colorAmplitude = clamp01(readLayerNumber(spec.colorVariation, ['amplitude', 'variation'], 0.18));
+ const heightCorrelation = clamp01(readLayerNumber(spec.colorVariation, ['heightCorrelation'], 0.3));
+ const colorGradient: ColorGradientSpec | undefined = spec.colorGradient;
+ for (let y = 0; y < size; y += 1) {
+ const v = y / size;
+ for (let x = 0; x < size; x += 1) {
+ const u = x / size;
+ const index = y * size + x;
+ const height = sampleSurface(u, v, bands, seed + 101);
+ const roughNoise = sampleSurface(u, v, bands, seed + 7001);
+ const colorNoise = sampleSurface(u, v, bands, seed + 15013);
+ heightField[index] = height;
+ roughnessField[index] = clamp01(baseRoughness + (roughNoise - 0.5) * roughnessVariation * 2);
+ let color: [number, number, number];
+ if (colorGradient) {
+ // Evidence-derived spatial gradient (Plan 1.3 Workstream C) takes priority
+ // over the noise-based palette blend below — it is a measured trend, not a guess.
+ color = sampleColorGradient(colorGradient, u, v);
+ } else {
+ const paletteValue = clamp01(
+ 0.5 + (colorNoise - 0.5) * colorAmplitude * 2 + (height - 0.5) * heightCorrelation
+ );
+ color = mixPalette(colors, paletteValue);
+ }
+ writePixel(images.albedo.data, index * 4, color[0], color[1], color[2]);
+ }
+ }
+ const normalStrength = Math.max(0.05, readLayerNumber(spec.normal, ['strength', 'amplitude'], 0.35));
+ const aoStrength = clamp01(readLayerNumber(spec.ambientOcclusion, ['cavityStrength', 'strength'], 0.35));
+ for (let y = 0; y < size; y += 1) {
+ const up = ((y - 1 + size) % size) * size;
+ const down = ((y + 1) % size) * size;
+ for (let x = 0; x < size; x += 1) {
+ const left = (x - 1 + size) % size;
+ const right = (x + 1) % size;
+ const index = y * size + x;
+ const center = heightField[index];
+ const dx = (heightField[y * size + right] - heightField[y * size + left]) * normalStrength * 6;
+ const dy = (heightField[down + x] - heightField[up + x]) * normalStrength * 6;
+ const inverseLength = 1 / Math.sqrt(dx * dx + dy * dy + 1);
+ const normalX = -dx * inverseLength;
+ const normalY = -dy * inverseLength;
+ const normalZ = inverseLength;
+ const neighborAverage = (
+ heightField[y * size + left] + heightField[y * size + right]
+ + heightField[up + x] + heightField[down + x]
+ ) * 0.25;
+ const cavity = Math.max(0, neighborAverage - center);
+ const ao = clamp01(1 - aoStrength * (cavity * 12 + (1 - center) * 0.16));
+ const offset = index * 4;
+ const heightByte = center * 255;
+ const roughnessByte = roughnessField[index] * 255;
+ writePixel(images.height.data, offset, heightByte, heightByte, heightByte);
+ writePixel(images.roughness.data, offset, roughnessByte, roughnessByte, roughnessByte);
+ writePixel(
+ images.normal.data, offset,
+ (normalX * 0.5 + 0.5) * 255,
+ (normalY * 0.5 + 0.5) * 255,
+ (normalZ * 0.5 + 0.5) * 255,
+ );
+ writePixel(images.ao.data, offset, ao * 255, ao * 255, ao * 255);
+ }
+ }
+ contexts.albedo.putImageData(images.albedo, 0, 0);
+ contexts.roughness.putImageData(images.roughness, 0, 0);
+ contexts.height.putImageData(images.height, 0, 0);
+ contexts.normal.putImageData(images.normal, 0, 0);
+ contexts.ao.putImageData(images.ao, 0, 0);
+ return {
+ albedo: createMapTexture(canvases.albedo, THREE.SRGBColorSpace, spec, options),
+ roughness: createMapTexture(canvases.roughness, THREE.NoColorSpace, spec, options),
+ height: createMapTexture(canvases.height, THREE.NoColorSpace, spec, options),
+ normal: createMapTexture(canvases.normal, THREE.NoColorSpace, spec, options),
+ ao: createMapTexture(canvases.ao, THREE.NoColorSpace, spec, options),
+ source: 'procedural',
+ };
+}
+
+function createSculptMaterial(id: string, spec: SculptMaterialSpec, options: ProceduralModelOptions, denseComponent = false): THREE.MeshPhysicalMaterial {
+ // A material that declares -- with evidence -- that its subject carries no texture
+ // detail gets NO texture set. Synthesising one anyway is not a harmless default: the
+ // branch below then forces color to white and roughness to 1 and reads both from the
+ // generated maps, so the authored albedo and the reference-derived roughness are both
+ // discarded, and the model gains mottling the reference does not have. Measured on the
+ // tuxedo cat, whose black fur rendered as speckled grey-and-white from a palette that
+ // only ever described two flat regions.
+ const textureless = (spec.textureless as { declared?: boolean } | undefined)?.declared === true;
+ const textures = textureless
+ ? null
+ : makeReferenceTextureSet(spec, options) ?? makeProceduralTextureSet(id, spec, options);
+ const material = new THREE.MeshPhysicalMaterial({
+ color: textures ? 0xffffff : clampedAlbedoColor(spec),
+ roughness: textures ? 1 : clamp01(readLayerNumber(spec.roughness, ['base'], 0.76)),
+ metalness: clampPbrMetalness(readLayerNumber(spec.metalness, ['base'], 0.0)),
+ clearcoat: clamp01(readLayerNumber(spec.clearcoat, ['base', 'amount'], 0)),
+ clearcoatRoughness: clamp01(readLayerNumber(spec.clearcoatRoughness, ['base'], 0.25)),
+ transmission: clamp01(readLayerNumber(spec.transmission, ['base', 'amount'], 0)),
+ ior: clampPbrIor(readLayerNumber(spec.ior, ['base', 'value'], 1.5)),
+ thickness: Math.max(0, readLayerNumber(spec.thickness, ['base', 'amount'], 0)),
+ attenuationDistance: Math.max(0.001, readLayerNumber(spec.attenuationDistance, ['base', 'value'], Infinity)),
+ attenuationColor: new THREE.Color(typeof spec.attenuationColor === 'string' ? spec.attenuationColor : '#ffffff'),
+ sheen: clamp01(readLayerNumber(spec.sheen, ['base', 'amount'], 0)),
+ sheenColor: new THREE.Color(typeof spec.sheenColor === 'string' ? spec.sheenColor : '#ffffff'),
+ sheenRoughness: clamp01(readLayerNumber(spec.sheenRoughness, ['base'], 1.0)),
+ iridescence: clamp01(readLayerNumber(spec.iridescence, ['base', 'amount'], 0)),
+ iridescenceIOR: clampPbrIor(readLayerNumber(spec.iridescenceIOR, ['base', 'value'], 1.3)),
+ anisotropy: clamp01(readLayerNumber(spec.anisotropy, ['base', 'amount'], 0)),
+ anisotropyRotation: readLayerNumber(spec.anisotropy, ['rotation'], 0),
+ specularIntensity: clampPbrF0(readLayerNumber(spec.specularF0 ?? spec.f0 ?? spec.specularIntensity, ['base', 'value'], 1.0)),
+ specularColor: new THREE.Color(typeof spec.specularColor === 'string' ? spec.specularColor : '#ffffff'),
+ emissive: new THREE.Color(typeof spec.emissive === 'string' ? spec.emissive : '#000000'),
+ emissiveIntensity: Math.max(0, readLayerNumber(spec.emissiveIntensity, ['base'], 1.0)),
+ opacity: clamp01(readLayerNumber(spec.opacity, ['base'], 1)),
+ transparent: readLayerNumber(spec.transmission, ['base', 'amount'], 0) > 0 || readLayerNumber(spec.opacity, ['base'], 1) < 1,
+ alphaTest: Math.max(0, readLayerNumber(spec.alpha, ['cutoff', 'alphaTest'], 0)),
+ wireframe: options.wireframe ?? false,
+ side: spec.doubleSided === true ? THREE.DoubleSide : THREE.FrontSide,
+ flatShading: spec.flatShading === true,
+ });
+ if (textures) {
+ material.map = textures.albedo;
+ material.roughnessMap = textures.roughness;
+ material.normalMap = textures.normal;
+ material.normalScale.setScalar(Math.max(0.05, readLayerNumber(spec.normal, ['strength', 'amplitude'], 0.35)));
+ material.aoMap = textures.ao;
+ material.aoMap.channel = 0;
+ material.aoMapIntensity = readLayerNumber(spec.ambientOcclusion, ['cavityStrength', 'strength'], 0.35);
+ const denseMesh = denseComponent || spec.denseMesh === true || spec.geometryDensity === 'dense' || spec.topologyClass === 'dense';
+ const bumpScale = Math.max(0, readLayerNumber(spec.bump, ['amplitude', 'strength'], 0));
+ const effectiveBumpScale = denseMesh ? Math.max(0.05, bumpScale) : bumpScale;
+ if (effectiveBumpScale > 0) {
+ material.bumpMap = textures.height;
+ material.bumpScale = effectiveBumpScale;
+ }
+ const displacementScale = Math.max(0, readLayerNumber(spec.displacement, ['amplitude', 'strength'], 0));
+ const effectiveDisplacementScale = denseMesh ? Math.max(0.005, displacementScale) : displacementScale;
+ if (effectiveDisplacementScale > 0) {
+ material.displacementMap = textures.height;
+ material.displacementScale = effectiveDisplacementScale;
+ material.displacementBias = -effectiveDisplacementScale * 0.5;
+ }
+ }
+ material.envMapIntensity = readLayerNumber(spec, ['envMapIntensity'], 0.8);
+ material.userData.sculptMaterial = spec;
+ material.userData.proceduralMapsIndependent = true;
+ material.userData.pbrConstraints = { albedoRange: [30, 240], binaryMetalness: true, f0Range: [0.02, 1], iorRange: [1, 2.5] };
+ material.userData.pbrTextureSource = textures?.source ?? 'flat-fallback';
+ material.userData.referencePbr = spec.referencePbr ?? null;
+ material.userData.referenceMaterialId = spec.referenceMaterialId ?? spec.materialReference?.profileId ?? null;
+ material.userData.materialEvidence = spec.materialEvidence ?? null;
+ material.userData.validationViews = spec.materialReference?.validationViews ?? [];
+ material.needsUpdate = true;
+ return material;
+}
+
+type AttachmentEndpoint = {
+ start: THREE.Vector3;
+ midpoint: THREE.Vector3;
+ quaternion: THREE.Quaternion;
+ length: number;
+ baseRadius: number;
+ endRadius: number;
+};
+
+function readVector3(value: unknown, fallback: [number, number, number]): THREE.Vector3 {
+ if (Array.isArray(value) && value.length === 3 && value.every((item) => typeof item === 'number')) {
+ return new THREE.Vector3(value[0], value[1], value[2]);
+ }
+ return new THREE.Vector3(fallback[0], fallback[1], fallback[2]);
+}
+
+function readNumber(value: unknown, fallback: number): number {
+ return typeof value === 'number' && Number.isFinite(value) ? value : fallback;
+}
+
+function makeAttachmentEndpoint(attachment: unknown): AttachmentEndpoint | null {
+ if (!attachment || typeof attachment !== 'object') return null;
+ const record = attachment as Record<string, unknown>;
+ const start = readVector3(record.localStart, [0, 0, 0]);
+ const end = readVector3(record.localEnd, [0, 1, 0]);
+ const delta = end.clone().sub(start);
+ const length = delta.length();
+ if (length <= 0.0001) return null;
+ const direction = delta.clone().normalize();
+ const quaternion = new THREE.Quaternion().setFromUnitVectors(new THREE.Vector3(0, 1, 0), direction);
+ const baseRadius = Math.max(0.005, readNumber(record.baseRadius, 0.06));
+ const endRadius = Math.max(0.003, readNumber(record.endRadius, baseRadius * 0.55));
+ return {
+ start,
+ midpoint: delta.multiplyScalar(0.5),
+ quaternion,
+ length,
+ baseRadius,
+ endRadius,
+ };
+}
+
+// Generated from ObjectSculptSpec target: AK-47 Wild Lotus
+// Sculpt build pass: blockout
+// This factory is intentionally pass-gated. Finish browser screenshot review before unlocking deeper passes.
+export function createAK47WildLotusModel(options: ProceduralModelOptions = {}): THREE.Group {
+ const root = new THREE.Group();
+ root.name = "AK-47 Wild Lotus";
+ root.userData.reconstructionEvidence = {"itemFamily": null, "subtype": null, "componentAdapter": null, "route": null, "exactnessTier": null, "referenceCamera": {"solved": true, "fovDegrees": 35.0, "aspect": 1.7778, "orientation": {"yaw": 0.0, "pitch": 0.0, "roll": 0.0}, "positionHint": [0.0, 0.0, 2.5], "note": "Heuristic default; refine by overlay review."}, "approximationNotes": []};
+ root.userData.materialPipeline = {};
+ root.userData.materialReferenceRegistry = null;
+
+ const materialMap: Record<string, THREE.Material> = {};
+ materialMap["wild-lotus-base"] = createSculptMaterial(
+ "wild-lotus-base",
+ {"id": "wild-lotus-base", "name": "Wild Lotus Teal Painted Metal", "type": "standard", "baseColor": "#2A7A5A", "albedo": {"dominant": "#2A7A5A", "secondary": ["#1E5E42", "#3A8A6A"]}, "roughness": {"base": 0.55, "variation": 0.1, "map": {"type": "independent-procedural", "source": "independent procedural roughness field derived from surface finish observation", "pattern": "mottled-field", "amplitude": 0.1, "resolution": 1024, "independent": true}}, "metalness": {"base": 0.1, "variation": 0.05}, "normal": {"pattern": "stamped-metal-grain", "strength": 0.2, "scale": 16}, "localOverrides": [{"region": "all-painted-surfaces", "description": "Wild Lotus floral pattern applied via projection from de-lit reference"}], "note": "Projection-first route mandatory for this patterned skin.", "textureResolution": 2048, "textureProjection": {"mode": "uv", "repeat": [2.0, 2.0], "anisotropy": 8, "texelDensityIntent": "Preserve stable world-scale detail"}, "surfaceFrequencyBands": [{"id": "macro", "frequency": 2.0, "amplitude": 0.4, "role": "broad color breakup"}, {"id": "meso", "frequency": 12.0, "amplitude": 0.2, "role": "visible relief"}, {"id": "micro", "frequency": 56.0, "amplitude": 0.08, "role": "grazing light breakup"}], "ambientOcclusion": {"cavityStrength": 0.25, "contactShadowBias": 0.35}, "referencePbr": {"source": "de-lit reference image projection", "method": "projection from de-lit reference crops", "confidence": 0.71, "usable": true, "note": "De-lighted reference used as projection source; confidence raised to 0.71 by dual-view evidence", "maps": {"albedo": {"path": "delight_albedo.png", "confidence": 0.75, "resolution": 2048, "colorSpace": "sRGB", "source": "de-lit reference projection"}, "roughness": {"path": "procedural-roughness-field", "confidence": 0.7, "resolution": 1024, "source": "inferred from surface finish"}, "normal": {"path": "procedural-normal-field", "confidence": 0.65, "resolution": 1024, "source": "stamped-metal grain procedural"}, "ao": {"path": "procedural-ao-field", "confidence": 0.7, "resolution": 1024, "source": "computed from geometry"}, "height": {"path": "procedural-height-field", "confidence": 0.6, "resolution": 1024, "source": "displacement from surface detail"}}}},
+ options
+ );
+ materialMap["dark-metal"] = createSculptMaterial(
+ "dark-metal",
+ {"id": "dark-metal", "name": "Dark Blued Steel", "type": "standard", "baseColor": "#1A1A1A", "albedo": {"dominant": "#1A1A1A", "secondary": ["#2A2A2A", "#0F0F0F"]}, "roughness": {"base": 0.4, "variation": 0.08, "map": {"type": "independent-procedural", "source": "independent procedural roughness field derived from surface finish observation", "pattern": "mottled-field", "amplitude": 0.08, "resolution": 1024, "independent": true}}, "metalness": {"base": 0.9, "variation": 0.05}, "normal": {"pattern": "machined-metal", "strength": 0.15, "scale": 8}, "localOverrides": [], "note": "Barrel, gas tube, rear sight. Dark parkerized/blued finish.", "textureResolution": 2048, "textureProjection": {"mode": "uv", "repeat": [2.0, 2.0], "anisotropy": 8, "texelDensityIntent": "Preserve stable world-scale detail"}, "surfaceFrequencyBands": [{"id": "macro", "frequency": 2.0, "amplitude": 0.4, "role": "broad color breakup"}, {"id": "meso", "frequency": 12.0, "amplitude": 0.2, "role": "visible relief"}, {"id": "micro", "frequency": 56.0, "amplitude": 0.08, "role": "grazing light breakup"}], "ambientOcclusion": {"cavityStrength": 0.25, "contactShadowBias": 0.35}, "referencePbr": {"source": "de-lit reference image projection", "method": "projection from de-lit reference crops", "confidence": 0.71, "usable": true, "note": "De-lighted reference used as projection source; confidence raised to 0.71 by dual-view evidence", "maps": {"albedo": {"path": "delight_albedo.png", "confidence": 0.75, "resolution": 2048, "colorSpace": "sRGB", "source": "de-lit reference projection"}, "roughness": {"path": "procedural-roughness-field", "confidence": 0.7, "resolution": 1024, "source": "inferred from surface finish"}, "normal": {"path": "procedural-normal-field", "confidence": 0.65, "resolution": 1024, "source": "stamped-metal grain procedural"}, "ao": {"path": "procedural-ao-field", "confidence": 0.7, "resolution": 1024, "source": "computed from geometry"}, "height": {"path": "procedural-height-field", "confidence": 0.6, "resolution": 1024, "source": "displacement from surface detail"}}}},
+ options
+ );
+ materialMap["gold-accent"] = createSculptMaterial(
+ "gold-accent",
+ {"id": "gold-accent", "name": "Gold/Bronze Metallic Accent", "type": "standard", "baseColor": "#C8944A", "albedo": {"dominant": "#C8944A", "secondary": ["#B8843A", "#D8A45A"]}, "roughness": {"base": 0.35, "variation": 0.08, "map": {"type": "independent-procedural", "source": "independent procedural roughness field derived from surface finish observation", "pattern": "mottled-field", "amplitude": 0.08, "resolution": 1024, "independent": true}}, "metalness": {"base": 0.75, "variation": 0.1}, "normal": {"pattern": "smooth-metallic", "strength": 0.05, "scale": 4}, "localOverrides": [], "note": "Magazine band, stock band, trigger guard, trigger.", "textureResolution": 2048, "textureProjection": {"mode": "uv", "repeat": [2.0, 2.0], "anisotropy": 8, "texelDensityIntent": "Preserve stable world-scale detail"}, "surfaceFrequencyBands": [{"id": "macro", "frequency": 2.0, "amplitude": 0.4, "role": "broad color breakup"}, {"id": "meso", "frequency": 12.0, "amplitude": 0.2, "role": "visible relief"}, {"id": "micro", "frequency": 56.0, "amplitude": 0.08, "role": "grazing light breakup"}], "ambientOcclusion": {"cavityStrength": 0.25, "contactShadowBias": 0.35}, "referencePbr": {"source": "de-lit reference image projection", "method": "projection from de-lit reference crops", "confidence": 0.71, "usable": true, "note": "De-lighted reference used as projection source; confidence raised to 0.71 by dual-view evidence", "maps": {"albedo": {"path": "delight_albedo.png", "confidence": 0.75, "resolution": 2048, "colorSpace": "sRGB", "source": "de-lit reference projection"}, "roughness": {"path": "procedural-roughness-field", "confidence": 0.7, "resolution": 1024, "source": "inferred from surface finish"}, "normal": {"path": "procedural-normal-field", "confidence": 0.65, "resolution": 1024, "source": "stamped-metal grain procedural"}, "ao": {"path": "procedural-ao-field", "confidence": 0.7, "resolution": 1024, "source": "computed from geometry"}, "height": {"path": "procedural-height-field", "confidence": 0.6, "resolution": 1024, "source": "displacement from surface detail"}}}},
+ options
+ );
+
+ const nodes: Record<string, THREE.Object3D> = { root };
+ const meshes: Record<string, THREE.Mesh> = {};
+ const sockets: Record<string, THREE.Object3D> = {};
+ const colliders: Record<string, unknown> = {};
+ const destructionGroups: Record<string, THREE.Object3D[]> = {};
+
+ const endpoint_root_0 = makeAttachmentEndpoint(null);
+ const node_root_0 = new THREE.Group();
+ node_root_0.name = "AK-47 Wild Lotus__pivot";
+ node_root_0.scale.set(1, 1, 1);
+ if (endpoint_root_0) {
+ node_root_0.position.copy(endpoint_root_0.start);
+ node_root_0.rotation.set(0.0, 0.0, 0.0);
+ } else {
+ node_root_0.position.set(0.0, 0.0, 0.0);
+ node_root_0.rotation.set(0.0, 0.0, 0.0);
+ }
+ node_root_0.userData.sculptComponent = {"id": "root", "name": "AK-47 Wild Lotus", "level": "macro", "role": "body", "importance": 1.0, "confidence": 0.95, "primitive": "box", "topologyClass": "assembled-solid", "topologyRationale": "Root group holding all child components", "geometryDescriptor": {"topologyIntent": "root pivot only", "uvStrategy": "generated procedural coordinates"}, "parent": null, "attachment": null, "dimensions": {"width": 0.88, "height": 0.22, "depth": 0.06, "units": "meters", "confidence": 0.85}, "transform": {"position": [0, 0, 0], "rotation": [0, 0, 0], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.6, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "root", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": true, "rotate": true, "scale": true, "detach": false, "visibility": true}, "sockets": [], "collider": {"type": "box", "offset": [0, 0, 0], "scale": [1, 1, 1]}, "destruction": {"breakable": false, "fractureGroup": "root"}}, "material": "wild-lotus-base", "evidenceRefs": ["left-view", "right-view"]};
+ node_root_0.userData.actionProfile = {"animationRole": "root", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": true, "rotate": true, "scale": true, "detach": false, "visibility": true}, "sockets": [], "collider": {"type": "box", "offset": [0, 0, 0], "scale": [1, 1, 1]}, "destruction": {"breakable": false, "fractureGroup": "root"}};
+ (nodes["root"] ?? root).add(node_root_0);
+ nodes["root"] = node_root_0;
+ const mesh_root_0Geometry = endpoint_root_0
+ ? new THREE.CylinderGeometry(endpoint_root_0.endRadius, endpoint_root_0.baseRadius, endpoint_root_0.length, 32, 12)
+ : new THREE.BoxGeometry(1, 1, 1, 12, 12, 12);
+ if (!endpoint_root_0) {
+ mesh_root_0Geometry.scale(1.0, 1.0, 1.0);
+ }
+ const mesh_root_0 = new THREE.Mesh(
+ mesh_root_0Geometry,
+ materialMap["wild-lotus-base"] ?? new THREE.MeshStandardMaterial({ color: 0x888888 })
+ );
+ mesh_root_0.name = "AK-47 Wild Lotus";
+ if (endpoint_root_0) {
+ mesh_root_0.position.copy(endpoint_root_0.midpoint);
+ mesh_root_0.quaternion.copy(endpoint_root_0.quaternion);
+ }
+ mesh_root_0.castShadow = options.castShadow ?? true;
+ mesh_root_0.receiveShadow = options.receiveShadow ?? true;
+ mesh_root_0.userData.sculptComponent = {"id": "root", "name": "AK-47 Wild Lotus", "level": "macro", "role": "body", "importance": 1.0, "confidence": 0.95, "primitive": "box", "topologyClass": "assembled-solid", "topologyRationale": "Root group holding all child components", "geometryDescriptor": {"topologyIntent": "root pivot only", "uvStrategy": "generated procedural coordinates"}, "parent": null, "attachment": null, "dimensions": {"width": 0.88, "height": 0.22, "depth": 0.06, "units": "meters", "confidence": 0.85}, "transform": {"position": [0, 0, 0], "rotation": [0, 0, 0], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.6, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "root", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": true, "rotate": true, "scale": true, "detach": false, "visibility": true}, "sockets": [], "collider": {"type": "box", "offset": [0, 0, 0], "scale": [1, 1, 1]}, "destruction": {"breakable": false, "fractureGroup": "root"}}, "material": "wild-lotus-base", "evidenceRefs": ["left-view", "right-view"]};
+ node_root_0.add(mesh_root_0);
+ meshes["root"] = mesh_root_0;
+ colliders["root"] = {"type": "box", "offset": [0, 0, 0], "scale": [1, 1, 1]};
+ destructionGroups["root"] ??= [];
+ destructionGroups["root"].push(node_root_0);
+
+ const endpoint_stock_1 = makeAttachmentEndpoint(null);
+ const node_stock_1 = new THREE.Group();
+ node_stock_1.name = "Fixed Stock__pivot";
+ node_stock_1.scale.set(1, 1, 1);
+ if (endpoint_stock_1) {
+ node_stock_1.position.copy(endpoint_stock_1.start);
+ node_stock_1.rotation.set(0.0, 0.0, 0.0);
+ } else {
+ node_stock_1.position.set(-0.38, -0.01, 0.0);
+ node_stock_1.rotation.set(0.0, 0.0, 0.0);
+ }
+ node_stock_1.userData.sculptComponent = {"id": "stock", "name": "Fixed Stock", "level": "macro", "role": "stock", "importance": 0.9, "confidence": 0.92, "primitive": "extrude", "topologyClass": "assembled-solid", "topologyRationale": "Extruded triangular profile matching AK fixed stock", "geometryDescriptor": {"topologyIntent": "triangular cross-section extruded along length, slight taper toward butt", "edgeTreatment": {"type": "chamfer", "bevelRadius": 0.003, "segments": 2}, "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": "receiver-rear", "contactType": "butt-joint", "localStart": [0, 0, 0], "localEnd": [-0.05, 0, 0], "overlap": 0.01, "gapTolerance": 0.002}, "dimensions": {"width": 0.26, "height": 0.14, "depth": 0.045, "units": "meters", "confidence": 0.88}, "transform": {"position": [-0.38, -0.01, 0], "rotation": [0, 0, 0], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.7, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false, "detach": true}, "collider": {"type": "box"}, "destruction": {"breakable": true, "fractureGroup": "stock"}}, "material": "wild-lotus-base", "localFeatures": [{"id": "stock-lily", "type": "decal-area", "description": "Large pink lily flower on stock butt", "placement": "rear-third lateral face", "size": 0.08, "materialEffect": "high-saturation pink", "confidence": 0.95}, {"id": "stock-gold-band", "type": "raised-ridge", "description": "Curved gold accent band", "placement": "diagonal across stock", "size": 0.015, "materialEffect": "metallic gold", "confidence": 0.95}], "evidenceRefs": ["left-view", "right-view"]};
+ node_stock_1.userData.actionProfile = {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false, "detach": true}, "collider": {"type": "box"}, "destruction": {"breakable": true, "fractureGroup": "stock"}};
+ (nodes["root"] ?? root).add(node_stock_1);
+ nodes["stock"] = node_stock_1;
+ const mesh_stock_1Geometry = endpoint_stock_1
+ ? new THREE.CylinderGeometry(endpoint_stock_1.endRadius, endpoint_stock_1.baseRadius, endpoint_stock_1.length, 32, 12)
+ : buildExtrudeGeometry({"points": [[-0.3, -0.3], [0.3, -0.3], [0.3, 0.3], [-0.3, 0.3]], "depth": 0.1});
+ if (!endpoint_stock_1) {
+ mesh_stock_1Geometry.scale(1.0, 1.0, 1.0);
+ }
+ const mesh_stock_1 = new THREE.Mesh(
+ mesh_stock_1Geometry,
+ materialMap["wild-lotus-base"] ?? new THREE.MeshStandardMaterial({ color: 0x888888 })
+ );
+ mesh_stock_1.name = "Fixed Stock";
+ if (endpoint_stock_1) {
+ mesh_stock_1.position.copy(endpoint_stock_1.midpoint);
+ mesh_stock_1.quaternion.copy(endpoint_stock_1.quaternion);
+ }
+ mesh_stock_1.castShadow = options.castShadow ?? true;
+ mesh_stock_1.receiveShadow = options.receiveShadow ?? true;
+ mesh_stock_1.userData.sculptComponent = {"id": "stock", "name": "Fixed Stock", "level": "macro", "role": "stock", "importance": 0.9, "confidence": 0.92, "primitive": "extrude", "topologyClass": "assembled-solid", "topologyRationale": "Extruded triangular profile matching AK fixed stock", "geometryDescriptor": {"topologyIntent": "triangular cross-section extruded along length, slight taper toward butt", "edgeTreatment": {"type": "chamfer", "bevelRadius": 0.003, "segments": 2}, "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": "receiver-rear", "contactType": "butt-joint", "localStart": [0, 0, 0], "localEnd": [-0.05, 0, 0], "overlap": 0.01, "gapTolerance": 0.002}, "dimensions": {"width": 0.26, "height": 0.14, "depth": 0.045, "units": "meters", "confidence": 0.88}, "transform": {"position": [-0.38, -0.01, 0], "rotation": [0, 0, 0], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.7, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false, "detach": true}, "collider": {"type": "box"}, "destruction": {"breakable": true, "fractureGroup": "stock"}}, "material": "wild-lotus-base", "localFeatures": [{"id": "stock-lily", "type": "decal-area", "description": "Large pink lily flower on stock butt", "placement": "rear-third lateral face", "size": 0.08, "materialEffect": "high-saturation pink", "confidence": 0.95}, {"id": "stock-gold-band", "type": "raised-ridge", "description": "Curved gold accent band", "placement": "diagonal across stock", "size": 0.015, "materialEffect": "metallic gold", "confidence": 0.95}], "evidenceRefs": ["left-view", "right-view"]};
+ node_stock_1.add(mesh_stock_1);
+ meshes["stock"] = mesh_stock_1;
+ colliders["stock"] = {"type": "box"};
+ destructionGroups["stock"] ??= [];
+ destructionGroups["stock"].push(node_stock_1);
+
+ const endpoint_receiver_2 = makeAttachmentEndpoint(null);
+ const node_receiver_2 = new THREE.Group();
+ node_receiver_2.name = "Stamped Receiver__pivot";
+ node_receiver_2.scale.set(1, 1, 1);
+ if (endpoint_receiver_2) {
+ node_receiver_2.position.copy(endpoint_receiver_2.start);
+ node_receiver_2.rotation.set(0.0, 0.0, 0.0);
+ } else {
+ node_receiver_2.position.set(-0.08, 0.0, 0.0);
+ node_receiver_2.rotation.set(0.0, 0.0, 0.0);
+ }
+ node_receiver_2.userData.sculptComponent = {"id": "receiver", "name": "Stamped Receiver", "level": "macro", "role": "receiver", "importance": 1.0, "confidence": 0.95, "primitive": "box", "topologyClass": "assembled-solid", "topologyRationale": "Rectangular stamped metal box, AK core", "geometryDescriptor": {"topologyIntent": "rectangular box with dust cover top, trigger guard below", "edgeTreatment": {"type": "chamfer", "bevelRadius": 0.002, "segments": 1}, "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": null, "contactType": "core-body", "localStart": [0, 0, 0], "localEnd": [0, 0, 0], "overlap": 0, "gapTolerance": 0}, "dimensions": {"width": 0.22, "height": 0.08, "depth": 0.05, "units": "meters", "confidence": 0.9}, "transform": {"position": [-0.08, 0.0, 0], "rotation": [0, 0, 0], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.7, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "sockets": [{"id": "receiver-rear", "position": [-0.11, 0, 0], "type": "butt-joint"}, {"id": "receiver-front", "position": [0.11, 0, 0], "type": "socket"}, {"id": "mag-well", "position": [-0.02, -0.05, 0], "type": "insert"}, {"id": "grip-socket", "position": [0.02, -0.05, 0], "type": "embed"}], "collider": {"type": "box"}, "destruction": {"breakable": false, "fractureGroup": "receiver"}}, "material": "wild-lotus-base", "localFeatures": [{"id": "receiver-lotus", "type": "decal-area", "description": "Large red lotus flower", "placement": "center-right receiver face", "size": 0.1, "materialEffect": "high-saturation red", "confidence": 0.98}, {"id": "bolt-handle", "type": "raised-ridge", "description": "Charging handle on right side", "placement": "upper-right receiver", "size": 0.02, "materialEffect": "dark metal", "confidence": 0.9}], "evidenceRefs": ["left-view", "right-view"]};
+ node_receiver_2.userData.actionProfile = {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "sockets": [{"id": "receiver-rear", "position": [-0.11, 0, 0], "type": "butt-joint"}, {"id": "receiver-front", "position": [0.11, 0, 0], "type": "socket"}, {"id": "mag-well", "position": [-0.02, -0.05, 0], "type": "insert"}, {"id": "grip-socket", "position": [0.02, -0.05, 0], "type": "embed"}], "collider": {"type": "box"}, "destruction": {"breakable": false, "fractureGroup": "receiver"}};
+ (nodes["root"] ?? root).add(node_receiver_2);
+ nodes["receiver"] = node_receiver_2;
+ const mesh_receiver_2Geometry = endpoint_receiver_2
+ ? new THREE.CylinderGeometry(endpoint_receiver_2.endRadius, endpoint_receiver_2.baseRadius, endpoint_receiver_2.length, 32, 12)
+ : new THREE.BoxGeometry(1, 1, 1, 12, 12, 12);
+ if (!endpoint_receiver_2) {
+ mesh_receiver_2Geometry.scale(1.0, 1.0, 1.0);
+ }
+ const mesh_receiver_2 = new THREE.Mesh(
+ mesh_receiver_2Geometry,
+ materialMap["wild-lotus-base"] ?? new THREE.MeshStandardMaterial({ color: 0x888888 })
+ );
+ mesh_receiver_2.name = "Stamped Receiver";
+ if (endpoint_receiver_2) {
+ mesh_receiver_2.position.copy(endpoint_receiver_2.midpoint);
+ mesh_receiver_2.quaternion.copy(endpoint_receiver_2.quaternion);
+ }
+ mesh_receiver_2.castShadow = options.castShadow ?? true;
+ mesh_receiver_2.receiveShadow = options.receiveShadow ?? true;
+ mesh_receiver_2.userData.sculptComponent = {"id": "receiver", "name": "Stamped Receiver", "level": "macro", "role": "receiver", "importance": 1.0, "confidence": 0.95, "primitive": "box", "topologyClass": "assembled-solid", "topologyRationale": "Rectangular stamped metal box, AK core", "geometryDescriptor": {"topologyIntent": "rectangular box with dust cover top, trigger guard below", "edgeTreatment": {"type": "chamfer", "bevelRadius": 0.002, "segments": 1}, "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": null, "contactType": "core-body", "localStart": [0, 0, 0], "localEnd": [0, 0, 0], "overlap": 0, "gapTolerance": 0}, "dimensions": {"width": 0.22, "height": 0.08, "depth": 0.05, "units": "meters", "confidence": 0.9}, "transform": {"position": [-0.08, 0.0, 0], "rotation": [0, 0, 0], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.7, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "sockets": [{"id": "receiver-rear", "position": [-0.11, 0, 0], "type": "butt-joint"}, {"id": "receiver-front", "position": [0.11, 0, 0], "type": "socket"}, {"id": "mag-well", "position": [-0.02, -0.05, 0], "type": "insert"}, {"id": "grip-socket", "position": [0.02, -0.05, 0], "type": "embed"}], "collider": {"type": "box"}, "destruction": {"breakable": false, "fractureGroup": "receiver"}}, "material": "wild-lotus-base", "localFeatures": [{"id": "receiver-lotus", "type": "decal-area", "description": "Large red lotus flower", "placement": "center-right receiver face", "size": 0.1, "materialEffect": "high-saturation red", "confidence": 0.98}, {"id": "bolt-handle", "type": "raised-ridge", "description": "Charging handle on right side", "placement": "upper-right receiver", "size": 0.02, "materialEffect": "dark metal", "confidence": 0.9}], "evidenceRefs": ["left-view", "right-view"]};
+ node_receiver_2.add(mesh_receiver_2);
+ meshes["receiver"] = mesh_receiver_2;
+ colliders["receiver"] = {"type": "box"};
+ destructionGroups["receiver"] ??= [];
+ destructionGroups["receiver"].push(node_receiver_2);
+ const socket_receiver_receiver_rear_0 = new THREE.Object3D();
+ socket_receiver_receiver_rear_0.name = "receiver-rear";
+ socket_receiver_receiver_rear_0.position.set(-0.11, 0.0, 0.0);
+ socket_receiver_receiver_rear_0.rotation.set(0, 0, 0);
+ socket_receiver_receiver_rear_0.userData.socket = {"id": "receiver-rear", "position": [-0.11, 0, 0], "type": "butt-joint"};
+ node_receiver_2.add(socket_receiver_receiver_rear_0);
+ sockets["receiver:receiver-rear"] = socket_receiver_receiver_rear_0;
+ const socket_receiver_receiver_front_1 = new THREE.Object3D();
+ socket_receiver_receiver_front_1.name = "receiver-front";
+ socket_receiver_receiver_front_1.position.set(0.11, 0.0, 0.0);
+ socket_receiver_receiver_front_1.rotation.set(0, 0, 0);
+ socket_receiver_receiver_front_1.userData.socket = {"id": "receiver-front", "position": [0.11, 0, 0], "type": "socket"};
+ node_receiver_2.add(socket_receiver_receiver_front_1);
+ sockets["receiver:receiver-front"] = socket_receiver_receiver_front_1;
+ const socket_receiver_mag_well_2 = new THREE.Object3D();
+ socket_receiver_mag_well_2.name = "mag-well";
+ socket_receiver_mag_well_2.position.set(-0.02, -0.05, 0.0);
+ socket_receiver_mag_well_2.rotation.set(0, 0, 0);
+ socket_receiver_mag_well_2.userData.socket = {"id": "mag-well", "position": [-0.02, -0.05, 0], "type": "insert"};
+ node_receiver_2.add(socket_receiver_mag_well_2);
+ sockets["receiver:mag-well"] = socket_receiver_mag_well_2;
+ const socket_receiver_grip_socket_3 = new THREE.Object3D();
+ socket_receiver_grip_socket_3.name = "grip-socket";
+ socket_receiver_grip_socket_3.position.set(0.02, -0.05, 0.0);
+ socket_receiver_grip_socket_3.rotation.set(0, 0, 0);
+ socket_receiver_grip_socket_3.userData.socket = {"id": "grip-socket", "position": [0.02, -0.05, 0], "type": "embed"};
+ node_receiver_2.add(socket_receiver_grip_socket_3);
+ sockets["receiver:grip-socket"] = socket_receiver_grip_socket_3;
+
+ const attachment_handguard_3 = {"parentSocket": "receiver-front", "contactType": "socket", "localStart": [0, 0, 0], "localEnd": [0.08, 0, 0], "overlap": 0.01, "gapTolerance": 0.002};
+ const endpoint_handguard_3 = makeAttachmentEndpoint(attachment_handguard_3);
+ const node_handguard_3 = new THREE.Group();
+ node_handguard_3.name = "Handguard Assembly__pivot";
+ node_handguard_3.scale.set(1, 1, 1);
+ if (endpoint_handguard_3) {
+ node_handguard_3.position.copy(endpoint_handguard_3.start);
+ node_handguard_3.rotation.set(0.0, 0.0, 0.0);
+ } else {
+ node_handguard_3.position.set(0.16, 0.0, 0.0);
+ node_handguard_3.rotation.set(0.0, 0.0, 0.0);
+ }
+ node_handguard_3.userData.sculptComponent = {"id": "handguard", "name": "Handguard Assembly", "level": "macro", "role": "handguard", "importance": 0.85, "confidence": 0.9, "primitive": "cylinder", "topologyClass": "assembled-solid", "topologyRationale": "Upper/lower handguard halves around barrel", "geometryDescriptor": {"topologyIntent": "two half-cylinders around barrel", "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": "receiver-front", "contactType": "socket", "localStart": [0, 0, 0], "localEnd": [0.08, 0, 0], "overlap": 0.01, "gapTolerance": 0.002}, "dimensions": {"width": 0.16, "height": 0.05, "depth": 0.045, "units": "meters", "confidence": 0.88}, "transform": {"position": [0.16, 0.0, 0], "rotation": [0, 0, 0], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.7, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "collider": {"type": "cylinder"}, "destruction": {"breakable": true, "fractureGroup": "handguard"}}, "material": "wild-lotus-base", "localFeatures": [{"id": "handguard-teal", "type": "surface-finish", "description": "Teal paint with floral pattern", "placement": "entire surface", "size": 0.16, "materialEffect": "teal with pink accents", "confidence": 0.9}], "evidenceRefs": ["left-view", "right-view"]};
+ node_handguard_3.userData.actionProfile = {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "collider": {"type": "cylinder"}, "destruction": {"breakable": true, "fractureGroup": "handguard"}};
+ (nodes["root"] ?? root).add(node_handguard_3);
+ nodes["handguard"] = node_handguard_3;
+ const mesh_handguard_3Geometry = endpoint_handguard_3
+ ? new THREE.CylinderGeometry(endpoint_handguard_3.endRadius, endpoint_handguard_3.baseRadius, endpoint_handguard_3.length, 32, 12)
+ : new THREE.CylinderGeometry(0.5, 0.5, 1, 48, 16);
+ if (!endpoint_handguard_3) {
+ mesh_handguard_3Geometry.scale(1.0, 1.0, 1.0);
+ }
+ const mesh_handguard_3 = new THREE.Mesh(
+ mesh_handguard_3Geometry,
+ materialMap["wild-lotus-base"] ?? new THREE.MeshStandardMaterial({ color: 0x888888 })
+ );
+ mesh_handguard_3.name = "Handguard Assembly";
+ if (endpoint_handguard_3) {
+ mesh_handguard_3.position.copy(endpoint_handguard_3.midpoint);
+ mesh_handguard_3.quaternion.copy(endpoint_handguard_3.quaternion);
+ }
+ mesh_handguard_3.castShadow = options.castShadow ?? true;
+ mesh_handguard_3.receiveShadow = options.receiveShadow ?? true;
+ mesh_handguard_3.userData.sculptComponent = {"id": "handguard", "name": "Handguard Assembly", "level": "macro", "role": "handguard", "importance": 0.85, "confidence": 0.9, "primitive": "cylinder", "topologyClass": "assembled-solid", "topologyRationale": "Upper/lower handguard halves around barrel", "geometryDescriptor": {"topologyIntent": "two half-cylinders around barrel", "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": "receiver-front", "contactType": "socket", "localStart": [0, 0, 0], "localEnd": [0.08, 0, 0], "overlap": 0.01, "gapTolerance": 0.002}, "dimensions": {"width": 0.16, "height": 0.05, "depth": 0.045, "units": "meters", "confidence": 0.88}, "transform": {"position": [0.16, 0.0, 0], "rotation": [0, 0, 0], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.7, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "collider": {"type": "cylinder"}, "destruction": {"breakable": true, "fractureGroup": "handguard"}}, "material": "wild-lotus-base", "localFeatures": [{"id": "handguard-teal", "type": "surface-finish", "description": "Teal paint with floral pattern", "placement": "entire surface", "size": 0.16, "materialEffect": "teal with pink accents", "confidence": 0.9}], "evidenceRefs": ["left-view", "right-view"]};
+ node_handguard_3.add(mesh_handguard_3);
+ meshes["handguard"] = mesh_handguard_3;
+ colliders["handguard"] = {"type": "cylinder"};
+ destructionGroups["handguard"] ??= [];
+ destructionGroups["handguard"].push(node_handguard_3);
+
+ const attachment_barrel_4 = {"parentSocket": "receiver-front", "contactType": "socket", "localStart": [0, 0, 0], "localEnd": [0.38, 0, 0], "overlap": 0.01, "gapTolerance": 0.002};
+ const endpoint_barrel_4 = makeAttachmentEndpoint(attachment_barrel_4);
+ const node_barrel_4 = new THREE.Group();
+ node_barrel_4.name = "Barrel__pivot";
+ node_barrel_4.scale.set(1, 1, 1);
+ if (endpoint_barrel_4) {
+ node_barrel_4.position.copy(endpoint_barrel_4.start);
+ node_barrel_4.rotation.set(0.0, 0.0, 0.0);
+ } else {
+ node_barrel_4.position.set(0.28, -0.005, 0.0);
+ node_barrel_4.rotation.set(0.0, 0.0, 0.0);
+ }
+ node_barrel_4.userData.sculptComponent = {"id": "barrel", "name": "Barrel", "level": "macro", "role": "barrel", "importance": 0.85, "confidence": 0.92, "primitive": "cylinder", "topologyClass": "assembled-solid", "topologyRationale": "Long cylindrical barrel, dark metal", "geometryDescriptor": {"topologyIntent": "straight cylinder forward of handguard", "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": "receiver-front", "contactType": "socket", "localStart": [0, 0, 0], "localEnd": [0.38, 0, 0], "overlap": 0.01, "gapTolerance": 0.002}, "dimensions": {"width": 0.38, "height": 0.018, "depth": 0.018, "units": "meters", "confidence": 0.9}, "transform": {"position": [0.28, -0.005, 0], "rotation": [0, 0, 0], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(26, 26, 26, 1)", "secondaryAlbedo": "rgba(42, 42, 42, 1)", "materialClass": "metal", "materialClassConfidence": 0.9, "roughness": 0.4, "metalness": 0.9}, "actionProfile": {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "collider": {"type": "cylinder"}, "destruction": {"breakable": true, "fractureGroup": "barrel"}}, "material": "dark-metal", "evidenceRefs": ["left-view", "right-view"]};
+ node_barrel_4.userData.actionProfile = {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "collider": {"type": "cylinder"}, "destruction": {"breakable": true, "fractureGroup": "barrel"}};
+ (nodes["root"] ?? root).add(node_barrel_4);
+ nodes["barrel"] = node_barrel_4;
+ const mesh_barrel_4Geometry = endpoint_barrel_4
+ ? new THREE.CylinderGeometry(endpoint_barrel_4.endRadius, endpoint_barrel_4.baseRadius, endpoint_barrel_4.length, 32, 12)
+ : new THREE.CylinderGeometry(0.5, 0.5, 1, 48, 16);
+ if (!endpoint_barrel_4) {
+ mesh_barrel_4Geometry.scale(1.0, 1.0, 1.0);
+ }
+ const mesh_barrel_4 = new THREE.Mesh(
+ mesh_barrel_4Geometry,
+ materialMap["dark-metal"] ?? new THREE.MeshStandardMaterial({ color: 0x888888 })
+ );
+ mesh_barrel_4.name = "Barrel";
+ if (endpoint_barrel_4) {
+ mesh_barrel_4.position.copy(endpoint_barrel_4.midpoint);
+ mesh_barrel_4.quaternion.copy(endpoint_barrel_4.quaternion);
+ }
+ mesh_barrel_4.castShadow = options.castShadow ?? true;
+ mesh_barrel_4.receiveShadow = options.receiveShadow ?? true;
+ mesh_barrel_4.userData.sculptComponent = {"id": "barrel", "name": "Barrel", "level": "macro", "role": "barrel", "importance": 0.85, "confidence": 0.92, "primitive": "cylinder", "topologyClass": "assembled-solid", "topologyRationale": "Long cylindrical barrel, dark metal", "geometryDescriptor": {"topologyIntent": "straight cylinder forward of handguard", "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": "receiver-front", "contactType": "socket", "localStart": [0, 0, 0], "localEnd": [0.38, 0, 0], "overlap": 0.01, "gapTolerance": 0.002}, "dimensions": {"width": 0.38, "height": 0.018, "depth": 0.018, "units": "meters", "confidence": 0.9}, "transform": {"position": [0.28, -0.005, 0], "rotation": [0, 0, 0], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(26, 26, 26, 1)", "secondaryAlbedo": "rgba(42, 42, 42, 1)", "materialClass": "metal", "materialClassConfidence": 0.9, "roughness": 0.4, "metalness": 0.9}, "actionProfile": {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "collider": {"type": "cylinder"}, "destruction": {"breakable": true, "fractureGroup": "barrel"}}, "material": "dark-metal", "evidenceRefs": ["left-view", "right-view"]};
+ node_barrel_4.add(mesh_barrel_4);
+ meshes["barrel"] = mesh_barrel_4;
+ colliders["barrel"] = {"type": "cylinder"};
+ destructionGroups["barrel"] ??= [];
+ destructionGroups["barrel"].push(node_barrel_4);
+
+ const endpoint_magazine_5 = makeAttachmentEndpoint(null);
+ const node_magazine_5 = new THREE.Group();
+ node_magazine_5.name = "Curved Banana Magazine__pivot";
+ node_magazine_5.scale.set(1, 1, 1);
+ if (endpoint_magazine_5) {
+ node_magazine_5.position.copy(endpoint_magazine_5.start);
+ node_magazine_5.rotation.set(0.0, 0.0, -8.0);
+ } else {
+ node_magazine_5.position.set(-0.02, -0.1, 0.0);
+ node_magazine_5.rotation.set(0.0, 0.0, -8.0);
+ }
+ node_magazine_5.userData.sculptComponent = {"id": "magazine", "name": "Curved Banana Magazine", "level": "macro", "role": "magazine", "importance": 0.9, "confidence": 0.93, "primitive": "extrude", "topologyClass": "assembled-solid", "topologyRationale": "Extruded curved profile, iconic AK banana shape", "geometryDescriptor": {"topologyIntent": "curved rectangular cross-section following banana arc", "edgeTreatment": {"type": "chamfer", "bevelRadius": 0.002, "segments": 1}, "deformationStack": [{"type": "bend", "axis": "Z", "angle": 25, "falloff": "linear"}], "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": "mag-well", "contactType": "insert", "localStart": [0, 0.09, 0], "localEnd": [0, -0.09, 0], "overlap": 0.015, "gapTolerance": 0.002}, "dimensions": {"width": 0.04, "height": 0.18, "depth": 0.025, "units": "meters", "confidence": 0.9}, "transform": {"position": [-0.02, -0.1, 0], "rotation": [0, 0, -8], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.7, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "detachable", "pivot": {"mode": "top", "localPosition": [0, 0.09, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": true, "rotate": true, "detach": true}, "collider": {"type": "box"}, "destruction": {"breakable": true, "fractureGroup": "magazine"}}, "material": "wild-lotus-base", "localFeatures": [{"id": "mag-gold-band", "type": "raised-ridge", "description": "Curved gold accent stripe", "placement": "center of magazine face", "size": 0.012, "materialEffect": "metallic gold", "confidence": 0.95}, {"id": "mag-witness-holes", "type": "hole-or-socket", "description": "Witness holes for round counting", "placement": "left side vertical row", "size": 0.003, "materialEffect": "dark recess", "confidence": 0.85}, {"id": "mag-flowers", "type": "decal-area", "description": "Small orange and pink accent flowers", "placement": "lower magazine", "size": 0.04, "materialEffect": "orange/pink accents", "confidence": 0.85}], "evidenceRefs": ["left-view", "right-view"]};
+ node_magazine_5.userData.actionProfile = {"animationRole": "detachable", "pivot": {"mode": "top", "localPosition": [0, 0.09, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": true, "rotate": true, "detach": true}, "collider": {"type": "box"}, "destruction": {"breakable": true, "fractureGroup": "magazine"}};
+ (nodes["root"] ?? root).add(node_magazine_5);
+ nodes["magazine"] = node_magazine_5;
+ const mesh_magazine_5Geometry = endpoint_magazine_5
+ ? new THREE.CylinderGeometry(endpoint_magazine_5.endRadius, endpoint_magazine_5.baseRadius, endpoint_magazine_5.length, 32, 12)
+ : buildExtrudeGeometry({"points": [[-0.3, -0.3], [0.3, -0.3], [0.3, 0.3], [-0.3, 0.3]], "depth": 0.1});
+ if (!endpoint_magazine_5) {
+ mesh_magazine_5Geometry.scale(1.0, 1.0, 1.0);
+ }
+ const mesh_magazine_5 = new THREE.Mesh(
+ mesh_magazine_5Geometry,
+ materialMap["wild-lotus-base"] ?? new THREE.MeshStandardMaterial({ color: 0x888888 })
+ );
+ mesh_magazine_5.name = "Curved Banana Magazine";
+ if (endpoint_magazine_5) {
+ mesh_magazine_5.position.copy(endpoint_magazine_5.midpoint);
+ mesh_magazine_5.quaternion.copy(endpoint_magazine_5.quaternion);
+ }
+ mesh_magazine_5.castShadow = options.castShadow ?? true;
+ mesh_magazine_5.receiveShadow = options.receiveShadow ?? true;
+ mesh_magazine_5.userData.sculptComponent = {"id": "magazine", "name": "Curved Banana Magazine", "level": "macro", "role": "magazine", "importance": 0.9, "confidence": 0.93, "primitive": "extrude", "topologyClass": "assembled-solid", "topologyRationale": "Extruded curved profile, iconic AK banana shape", "geometryDescriptor": {"topologyIntent": "curved rectangular cross-section following banana arc", "edgeTreatment": {"type": "chamfer", "bevelRadius": 0.002, "segments": 1}, "deformationStack": [{"type": "bend", "axis": "Z", "angle": 25, "falloff": "linear"}], "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": "mag-well", "contactType": "insert", "localStart": [0, 0.09, 0], "localEnd": [0, -0.09, 0], "overlap": 0.015, "gapTolerance": 0.002}, "dimensions": {"width": 0.04, "height": 0.18, "depth": 0.025, "units": "meters", "confidence": 0.9}, "transform": {"position": [-0.02, -0.1, 0], "rotation": [0, 0, -8], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.7, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "detachable", "pivot": {"mode": "top", "localPosition": [0, 0.09, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": true, "rotate": true, "detach": true}, "collider": {"type": "box"}, "destruction": {"breakable": true, "fractureGroup": "magazine"}}, "material": "wild-lotus-base", "localFeatures": [{"id": "mag-gold-band", "type": "raised-ridge", "description": "Curved gold accent stripe", "placement": "center of magazine face", "size": 0.012, "materialEffect": "metallic gold", "confidence": 0.95}, {"id": "mag-witness-holes", "type": "hole-or-socket", "description": "Witness holes for round counting", "placement": "left side vertical row", "size": 0.003, "materialEffect": "dark recess", "confidence": 0.85}, {"id": "mag-flowers", "type": "decal-area", "description": "Small orange and pink accent flowers", "placement": "lower magazine", "size": 0.04, "materialEffect": "orange/pink accents", "confidence": 0.85}], "evidenceRefs": ["left-view", "right-view"]};
+ node_magazine_5.add(mesh_magazine_5);
+ meshes["magazine"] = mesh_magazine_5;
+ colliders["magazine"] = {"type": "box"};
+ destructionGroups["magazine"] ??= [];
+ destructionGroups["magazine"].push(node_magazine_5);
+
+ const attachment_grip_6 = {"parentSocket": "grip-socket", "contactType": "embed", "localStart": [0, 0, 0], "localEnd": [0, -0.08, 0], "overlap": 0.01, "gapTolerance": 0.002};
+ const endpoint_grip_6 = makeAttachmentEndpoint(attachment_grip_6);
+ const node_grip_6 = new THREE.Group();
+ node_grip_6.name = "Pistol Grip__pivot";
+ node_grip_6.scale.set(1, 1, 1);
+ if (endpoint_grip_6) {
+ node_grip_6.position.copy(endpoint_grip_6.start);
+ node_grip_6.rotation.set(0.0, 0.0, 12.0);
+ } else {
+ node_grip_6.position.set(0.02, -0.08, 0.0);
+ node_grip_6.rotation.set(0.0, 0.0, 12.0);
+ }
+ node_grip_6.userData.sculptComponent = {"id": "grip", "name": "Pistol Grip", "level": "macro", "role": "grip", "importance": 0.8, "confidence": 0.9, "primitive": "cylinder", "topologyClass": "assembled-solid", "topologyRationale": "Tapered ergonomic cylinder below receiver", "geometryDescriptor": {"topologyIntent": "tapered cylinder with forward angle", "deformationStack": [{"type": "taper", "startRadius": 0.015, "endRadius": 0.018, "axis": "Y"}], "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": "grip-socket", "contactType": "embed", "localStart": [0, 0, 0], "localEnd": [0, -0.08, 0], "overlap": 0.01, "gapTolerance": 0.002}, "dimensions": {"width": 0.03, "height": 0.08, "depth": 0.03, "units": "meters", "confidence": 0.88}, "transform": {"position": [0.02, -0.08, 0], "rotation": [0, 0, 12], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.7, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "collider": {"type": "cylinder"}, "destruction": {"breakable": true, "fractureGroup": "grip"}}, "material": "wild-lotus-base", "localFeatures": [{"id": "grip-vines", "type": "linework", "description": "Green vine/leaf pattern", "placement": "entire grip face", "size": 0.06, "materialEffect": "dark green overlay", "confidence": 0.85}], "evidenceRefs": ["left-view", "right-view"]};
+ node_grip_6.userData.actionProfile = {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "collider": {"type": "cylinder"}, "destruction": {"breakable": true, "fractureGroup": "grip"}};
+ (nodes["root"] ?? root).add(node_grip_6);
+ nodes["grip"] = node_grip_6;
+ const mesh_grip_6Geometry = endpoint_grip_6
+ ? new THREE.CylinderGeometry(endpoint_grip_6.endRadius, endpoint_grip_6.baseRadius, endpoint_grip_6.length, 32, 12)
+ : new THREE.CylinderGeometry(0.5, 0.5, 1, 48, 16);
+ if (!endpoint_grip_6) {
+ mesh_grip_6Geometry.scale(1.0, 1.0, 1.0);
+ }
+ const mesh_grip_6 = new THREE.Mesh(
+ mesh_grip_6Geometry,
+ materialMap["wild-lotus-base"] ?? new THREE.MeshStandardMaterial({ color: 0x888888 })
+ );
+ mesh_grip_6.name = "Pistol Grip";
+ if (endpoint_grip_6) {
+ mesh_grip_6.position.copy(endpoint_grip_6.midpoint);
+ mesh_grip_6.quaternion.copy(endpoint_grip_6.quaternion);
+ }
+ mesh_grip_6.castShadow = options.castShadow ?? true;
+ mesh_grip_6.receiveShadow = options.receiveShadow ?? true;
+ mesh_grip_6.userData.sculptComponent = {"id": "grip", "name": "Pistol Grip", "level": "macro", "role": "grip", "importance": 0.8, "confidence": 0.9, "primitive": "cylinder", "topologyClass": "assembled-solid", "topologyRationale": "Tapered ergonomic cylinder below receiver", "geometryDescriptor": {"topologyIntent": "tapered cylinder with forward angle", "deformationStack": [{"type": "taper", "startRadius": 0.015, "endRadius": 0.018, "axis": "Y"}], "uvStrategy": "generated procedural coordinates"}, "parent": "root", "attachment": {"parentSocket": "grip-socket", "contactType": "embed", "localStart": [0, 0, 0], "localEnd": [0, -0.08, 0], "overlap": 0.01, "gapTolerance": 0.002}, "dimensions": {"width": 0.03, "height": 0.08, "depth": 0.03, "units": "meters", "confidence": 0.88}, "transform": {"position": [0.02, -0.08, 0], "rotation": [0, 0, 12], "scale": [1, 1, 1]}, "colorMaterialRecipe": {"dominantAlbedo": "rgba(42, 122, 90, 1)", "secondaryAlbedo": "rgba(30, 94, 66, 1)", "materialClass": "plastic", "materialClassConfidence": 0.7, "roughness": 0.55, "metalness": 0.1}, "actionProfile": {"animationRole": "static", "pivot": {"mode": "center", "localPosition": [0, 0, 0], "axis": [0, 1, 0]}, "transformChannels": {"translate": false, "rotate": false}, "collider": {"type": "cylinder"}, "destruction": {"breakable": true, "fractureGroup": "grip"}}, "material": "wild-lotus-base", "localFeatures": [{"id": "grip-vines", "type": "linework", "description": "Green vine/leaf pattern", "placement": "entire grip face", "size": 0.06, "materialEffect": "dark green overlay", "confidence": 0.85}], "evidenceRefs": ["left-view", "right-view"]};
+ node_grip_6.add(mesh_grip_6);
+ meshes["grip"] = mesh_grip_6;
+ colliders["grip"] = {"type": "cylinder"};
+ destructionGroups["grip"] ??= [];
+ destructionGroups["grip"].push(node_grip_6);
+
+ root.userData.sculptRuntime = { nodes, meshes, sockets, colliders, destructionGroups } satisfies ProceduralModelRuntime;
+ root.userData.lookDevTargets = {"qualityPriority": "reference-fidelity", "materialPass": {"albedoPaletteRequired": true, "roughnessVariationRequired": true, "normalOrBumpRequired": true, "localOverridesRequired": true, "referencePbrExtraction": {"requiredWhenSourceImagePresent": true, "targetThreshold": 0.7}, "independentMapChannels": ["albedo", "roughness", "height", "normal", "ambient-occlusion"], "requiredSurfaceFrequencyBands": ["macro", "meso", "micro"]}, "lightingPass": {"exposure": {"value": 1.0, "intent": "Neutral exposure for material readability"}, "toneMapping": {"algorithm": "ACESFilmic", "intent": "Standard filmic response"}, "background": {"color": "#1a1a1a", "intent": "Dark neutral background"}, "contactShadow": {"enabled": true, "bias": 0.02}, "groundShadow": {"enabled": true, "softness": 0.5}}};
+ root.userData.actionReadiness = {
+ note: 'Use root.userData.sculptRuntime.nodes for transforms, sockets for attachments, colliders for physics proxies, and destructionGroups for breakable sets.',
+ };
+ return root;
+}
+
+export function createAK47WildLotusLookDevLights(
+ mode: 'neutral' | 'grazing' | 'reference' = 'neutral',
+): THREE.Group {
+ const lights = new THREE.Group();
+ lights.name = "AK-47 Wild Lotus look-dev lights";
+ const hemi = new THREE.HemisphereLight(
+ mode === 'reference' ? 0xfff0d6 : 0xf2f4ff,
+ 0x363b42,
+ mode === 'grazing' ? 0.28 : mode === 'reference' ? 0.72 : 0.85,
+ );
+ lights.add(hemi);
+ const key = new THREE.DirectionalLight(
+ mode === 'reference' ? 0xffcf8a : 0xfff4e8,
+ mode === 'grazing' ? 4.2 : mode === 'reference' ? 2.6 : 2.15,
+ );
+ if (mode === 'grazing') key.position.set(7.5, 1.1, 4.0);
+ else if (mode === 'reference') key.position.set(-4.5, 7.5, 5.0);
+ else key.position.set(-4.0, 6.0, 5.5);
+ key.castShadow = true;
+ key.shadow.mapSize.set(4096, 4096);
+ key.shadow.bias = -0.00025;
+ key.shadow.normalBias = 0.018;
+ key.shadow.radius = 7;
+ key.shadow.blurSamples = 24;
+ key.shadow.camera.near = 0.5;
+ key.shadow.camera.far = 30;
+ key.shadow.camera.left = -2.6;
+ key.shadow.camera.right = 2.6;
+ key.shadow.camera.top = 2.6;
+ key.shadow.camera.bottom = -2.6;
+ key.shadow.camera.updateProjectionMatrix();
+ lights.add(key);
+ const fill = new THREE.DirectionalLight(0xa8c4ff, mode === 'grazing' ? 0.12 : 0.42);
+ fill.position.set(4.0, 3.0, 3.5);
+ lights.add(fill);
+ const rim = new THREE.DirectionalLight(0xfff1c4, mode === 'grazing' ? 0.28 : 0.85);
+ rim.position.set(0.5, 4.5, -6.0);
+ lights.add(rim);
+ lights.userData.reviewMode = mode;
+ lights.userData.lightingFromPhoto = [{"type": "key", "direction": [0.3, 0.5, 1.0], "color": "#FFFFFF", "intensity": 1.0, "note": "Primary key light for material readability"}, {"type": "fill", "direction": [-0.5, 0.3, 0.5], "color": "#E8E8F0", "intensity": 0.4, "note": "Fill light for shadow softening"}, {"type": "rim", "direction": [0, 0.2, -1.0], "color": "#FFFFFF", "intensity": 0.6, "note": "Rim light for silhouette edge"}, {"type": "exposure", "value": 1.0, "toneMapping": "ACESFilmic", "note": "Neutral exposure with ACES filmic tone mapping"}, {"type": "shadow", "contactShadow": true, "groundShadow": true, "note": "Contact shadow and ground shadow enabled"}];
+ lights.userData.lookDevTargets = {"qualityPriority": "reference-fidelity", "materialPass": {"albedoPaletteRequired": true, "roughnessVariationRequired": true, "normalOrBumpRequired": true, "localOverridesRequired": true, "referencePbrExtraction": {"requiredWhenSourceImagePresent": true, "targetThreshold": 0.7}, "independentMapChannels": ["albedo", "roughness", "height", "normal", "ambient-occlusion"], "requiredSurfaceFrequencyBands": ["macro", "meso", "micro"]}, "lightingPass": {"exposure": {"value": 1.0, "intent": "Neutral exposure for material readability"}, "toneMapping": {"algorithm": "ACESFilmic", "intent": "Standard filmic response"}, "background": {"color": "#1a1a1a", "intent": "Dark neutral background"}, "contactShadow": {"enabled": true, "bias": 0.02}, "groundShadow": {"enabled": true, "softness": 0.5}}};
+ return lights;
+}
+
+// PBR materials (clearcoat/iridescence/transmission/anisotropy) need an environment
+// map to visually behave as intended — call this once per renderer and assign the
+// result to scene.environment before rendering. No external HDR asset required.
+export function createAK47WildLotusEnvironment(renderer: THREE.WebGLRenderer): THREE.Texture {
+ const pmrem = new THREE.PMREMGenerator(renderer);
+ const texture = pmrem.fromScene(new RoomEnvironment(), 0.04).texture;
+ pmrem.dispose();
+ return texture;
+}
+
+// Plan 1.3 §3.2 — auto-framing by bounding box. The Divine Eye can only compare a
+// render to the reference if the object is FRAMED consistently (an object framed
+// differently scores as wrong even when its shape is right). This positions the camera
+// deterministically from the object's bounding box so it fills the frame at a stable
+// margin, and sets near/far to the object scale. Call after adding the model to the
+// scene, and again on resize (after updating camera.aspect).
+export function frameAK47WildLotusCamera(
+ camera: THREE.PerspectiveCamera,
+ object: THREE.Object3D,
+ options: { margin?: number; azimuthDeg?: number; elevationDeg?: number } = {},
+): void {
+ const box = new THREE.Box3().setFromObject(object);
+ if (box.isEmpty()) return;
+ const size = box.getSize(new THREE.Vector3());
+ const center = box.getCenter(new THREE.Vector3());
+ const margin = options.margin ?? 1.15;
+ const maxDim = Math.max(size.x, size.y, size.z) * margin;
+ const fov = (camera.fov * Math.PI) / 180;
+ // distance so the largest object dimension fits vertically in the frame
+ const distance = (maxDim / 2) / Math.tan(fov / 2);
+ const az = ((options.azimuthDeg ?? 0) * Math.PI) / 180;
+ const el = ((options.elevationDeg ?? 0) * Math.PI) / 180;
+ const dir = new THREE.Vector3(
+ Math.sin(az) * Math.cos(el),
+ Math.sin(el),
+ Math.cos(az) * Math.cos(el),
+ );
+ camera.position.copy(center).addScaledVector(dir, distance);
+ camera.near = Math.max(0.01, distance - maxDim);
+ camera.far = distance + maxDim * 2;
+ camera.lookAt(center);
+ camera.updateProjectionMatrix();
+}
+
+// Plan 1.3 §3.2c — PRESENTATION composer (DOF + bloom). CRITICAL (R-POSTFX): this is
+// for the showcase/hero render ONLY. The Divine Eye's EVALUATION render MUST use a
+// plain renderer with NO composer — bloom blows highlights and DOF blurs edges, which
+// would corrupt the deterministic IoU/DCD/edge/blowout signals. Enable dof/bloom ONLY
+// when the reference photo actually exhibits them (detect_reference_effects.py authorizes).
+export function createAK47WildLotusPresentationComposer(
+ renderer: THREE.WebGLRenderer,
+ scene: THREE.Scene,
+ camera: THREE.Camera,
+ options: { dof?: boolean; bloom?: boolean; bloomStrength?: number; dofFocus?: number; dofAperture?: number } = {},
+): EffectComposer {
+ const composer = new EffectComposer(renderer);
+ composer.addPass(new RenderPass(scene, camera));
+ if (options.dof) {
+ composer.addPass(new BokehPass(scene, camera, {
+ focus: options.dofFocus ?? 10.0,
+ aperture: options.dofAperture ?? 0.0002,
+ maxblur: 0.01,
+ }));
+ }
+ if (options.bloom) {
+ const size = new THREE.Vector2();
+ renderer.getSize(size);
+ composer.addPass(new UnrealBloomPass(size, options.bloomStrength ?? 0.4, 0.4, 0.85));
+ }
+ return composer;
+}
+
+export function configureAK47WildLotusRenderer(renderer: THREE.WebGLRenderer): void {
+ // Load-bearing for view-dependent finishes (anodized / Doppler): without ACES + sRGB
+ // the environment reflection reads flat/washed instead of a believable metal response.
+ renderer.toneMapping = THREE.ACESFilmicToneMapping;
+ renderer.outputColorSpace = THREE.SRGBColorSpace;
+}
+
+export function createAK47WildLotusInspectControls(
+ camera: THREE.Camera,
+ domElement: HTMLElement,
+): OrbitControls {
+ // View-dependent finishes only read correctly once the user orbits — their color
+ // comes from the environment reflection, not albedo, so free rotation matters here.
+ const controls = new OrbitControls(camera, domElement);
+ controls.enableDamping = true;
+ controls.minDistance = 1.0;
+ controls.maxDistance = 8.0;
+ controls.autoRotate = false;
+ return controls;
+}