blendops 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +62 -0
- package/LICENSE +21 -0
- package/README.md +189 -2
- package/bin/blendops.mjs +4 -0
- package/bundles/claude-desktop-manual/BLENDOPS_SINGLE_FILE.md +78 -0
- package/bundles/claude-desktop-manual/IMPORT_STEPS.md +43 -0
- package/bundles/claude-desktop-manual/INSTALL_REPORT_TEMPLATE.md +13 -0
- package/bundles/claude-desktop-manual/README.md +70 -0
- package/bundles/claude-desktop-manual/SKILL.md +62 -0
- package/bundles/claude-desktop-manual/manifest.json +278 -0
- package/bundles/claude-desktop-manual/references/evidence-rules.md +13 -0
- package/bundles/claude-desktop-manual/references/install-boundary.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/evidence-before-done.md +14 -0
- package/bundles/claude-desktop-manual/references/laws/no-arbitrary-python-interface.md +12 -0
- package/bundles/claude-desktop-manual/references/laws/non-blender-user-language.md +13 -0
- package/bundles/claude-desktop-manual/references/laws/official-runtime-only.md +20 -0
- package/bundles/claude-desktop-manual/references/packs/product-hero-v0.md +30 -0
- package/bundles/claude-desktop-manual/references/runtime-stacks.md +13 -0
- package/bundles/claude-desktop-manual/references/skill-map.md +36 -0
- package/bundles/claude-desktop-manual/references/skills/acceptance-criteria-builder.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-discovery.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/asset-fallback-strategy.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/asset-library-plan.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-license-checker.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/asset-style-check.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/blender-brainstorming.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/blender-recipe-decomposer.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/blender-troubleshooting.md +78 -0
- package/bundles/claude-desktop-manual/references/skills/blendops-help.md +82 -0
- package/bundles/claude-desktop-manual/references/skills/bridge-conflicts.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/camera-composition.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/character-portrait.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/cli-appendix-job-outline.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/color-management-decision.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/composition-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/cycles-vs-eevee-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/done-criteria.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/environment-shot.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/glb-animation-handoff.md +69 -0
- package/bundles/claude-desktop-manual/references/skills/glb-web-handoff.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/intent-to-3d-brief-writer.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/interior-scene.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-material-plan.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/lighting-quality-checker.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/material-quality-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/mobile-glb-budget.md +73 -0
- package/bundles/claude-desktop-manual/references/skills/output-format-decision.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/pack-prerequisite-checker.md +74 -0
- package/bundles/claude-desktop-manual/references/skills/path-one-host-outline.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/plain-language-response.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/polycount-budget-checker.md +71 -0
- package/bundles/claude-desktop-manual/references/skills/pre-handoff-verification.md +76 -0
- package/bundles/claude-desktop-manual/references/skills/preview-report.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/product-grid-scene-planner.md +72 -0
- package/bundles/claude-desktop-manual/references/skills/product-hero-scene-planner.md +68 -0
- package/bundles/claude-desktop-manual/references/skills/r3f-component-plan.md +66 -0
- package/bundles/claude-desktop-manual/references/skills/recipe-fit-assessor.md +75 -0
- package/bundles/claude-desktop-manual/references/skills/render-export-evidence.md +70 -0
- package/bundles/claude-desktop-manual/references/skills/resolution-aspect-decision.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-attempt-report.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-path-picker.md +67 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-readiness.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/runtime-setup.md +63 -0
- package/bundles/claude-desktop-manual/references/skills/scene-readiness.md +65 -0
- package/bundles/claude-desktop-manual/references/skills/scope-guard.md +62 -0
- package/bundles/claude-desktop-manual/references/skills/stage-gates.md +91 -0
- package/bundles/claude-desktop-manual/references/skills/workflow-stage-router.md +67 -0
- package/bundles/generic-project-local/BLENDOPS.md +71 -0
- package/bundles/generic-project-local/INSTALL_REPORT_TEMPLATE.md +52 -0
- package/bundles/generic-project-local/README.md +72 -0
- package/bundles/generic-project-local/ROLLBACK.md +66 -0
- package/bundles/generic-project-local/manifest.json +66 -0
- package/bundles/skill-package/README.md +54 -0
- package/bundles/skill-package/blendops/LICENSE.txt +21 -0
- package/bundles/skill-package/blendops/SKILL.md +50 -0
- package/bundles/skill-package/blendops/agents/README.md +61 -0
- package/bundles/skill-package/blendops/agents/openai.yaml +4 -0
- package/bundles/skill-package/blendops/references/evidence-rules.md +17 -0
- package/bundles/skill-package/blendops/references/install-boundary.md +13 -0
- package/bundles/skill-package/blendops/references/law-evidence-before-done.md +12 -0
- package/bundles/skill-package/blendops/references/law-no-arbitrary-python-interface.md +7 -0
- package/bundles/skill-package/blendops/references/law-non-blender-user-language.md +8 -0
- package/bundles/skill-package/blendops/references/law-official-runtime-only.md +9 -0
- package/bundles/skill-package/blendops/references/pack-product-hero-v0.md +21 -0
- package/bundles/skill-package/blendops/references/runtime-stacks.md +13 -0
- package/bundles/skill-package/blendops/references/skill-acceptance-criteria-builder.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-discovery.md +54 -0
- package/bundles/skill-package/blendops/references/skill-asset-fallback-strategy.md +48 -0
- package/bundles/skill-package/blendops/references/skill-asset-library-plan.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-license-checker.md +51 -0
- package/bundles/skill-package/blendops/references/skill-asset-style-check.md +52 -0
- package/bundles/skill-package/blendops/references/skill-blender-brainstorming.md +43 -0
- package/bundles/skill-package/blendops/references/skill-blender-recipe-decomposer.md +48 -0
- package/bundles/skill-package/blendops/references/skill-blender-troubleshooting.md +59 -0
- package/bundles/skill-package/blendops/references/skill-blendops-help.md +62 -0
- package/bundles/skill-package/blendops/references/skill-bridge-conflicts.md +48 -0
- package/bundles/skill-package/blendops/references/skill-camera-composition.md +48 -0
- package/bundles/skill-package/blendops/references/skill-character-portrait.md +50 -0
- package/bundles/skill-package/blendops/references/skill-cli-appendix-job-outline.md +44 -0
- package/bundles/skill-package/blendops/references/skill-color-management-decision.md +50 -0
- package/bundles/skill-package/blendops/references/skill-composition-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-cycles-vs-eevee-decision.md +47 -0
- package/bundles/skill-package/blendops/references/skill-done-criteria.md +53 -0
- package/bundles/skill-package/blendops/references/skill-environment-shot.md +47 -0
- package/bundles/skill-package/blendops/references/skill-glb-animation-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-glb-web-handoff.md +51 -0
- package/bundles/skill-package/blendops/references/skill-intent-to-3d-brief-writer.md +50 -0
- package/bundles/skill-package/blendops/references/skill-interior-scene.md +54 -0
- package/bundles/skill-package/blendops/references/skill-lighting-material-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-lighting-quality-checker.md +52 -0
- package/bundles/skill-package/blendops/references/skill-map.md +32 -0
- package/bundles/skill-package/blendops/references/skill-material-quality-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-mobile-glb-budget.md +55 -0
- package/bundles/skill-package/blendops/references/skill-output-format-decision.md +46 -0
- package/bundles/skill-package/blendops/references/skill-pack-prerequisite-checker.md +56 -0
- package/bundles/skill-package/blendops/references/skill-path-one-host-outline.md +48 -0
- package/bundles/skill-package/blendops/references/skill-plain-language-response.md +53 -0
- package/bundles/skill-package/blendops/references/skill-polycount-budget-checker.md +53 -0
- package/bundles/skill-package/blendops/references/skill-pre-handoff-verification.md +57 -0
- package/bundles/skill-package/blendops/references/skill-preview-report.md +45 -0
- package/bundles/skill-package/blendops/references/skill-product-grid-scene-planner.md +54 -0
- package/bundles/skill-package/blendops/references/skill-product-hero-scene-planner.md +51 -0
- package/bundles/skill-package/blendops/references/skill-r3f-component-plan.md +48 -0
- package/bundles/skill-package/blendops/references/skill-recipe-fit-assessor.md +57 -0
- package/bundles/skill-package/blendops/references/skill-render-export-evidence.md +51 -0
- package/bundles/skill-package/blendops/references/skill-resolution-aspect-decision.md +48 -0
- package/bundles/skill-package/blendops/references/skill-runtime-attempt-report.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-path-picker.md +49 -0
- package/bundles/skill-package/blendops/references/skill-runtime-readiness.md +45 -0
- package/bundles/skill-package/blendops/references/skill-runtime-setup.md +45 -0
- package/bundles/skill-package/blendops/references/skill-scene-readiness.md +48 -0
- package/bundles/skill-package/blendops/references/skill-scope-guard.md +44 -0
- package/bundles/skill-package/blendops/references/skill-stage-gates.md +73 -0
- package/bundles/skill-package/blendops/references/skill-workflow-stage-router.md +49 -0
- package/docs/examples/glb-web-handoff/README.md +174 -0
- package/docs/examples/glb-web-handoff/r3f-glb-viewer.tsx +320 -0
- package/docs/examples/glb-web-handoff/threejs-glb-viewer.mjs +709 -0
- package/docs/knowledge-and-recipe-catalog.md +236 -0
- package/docs/recipes/README.md +27 -0
- package/docs/recipes/cyberpunk-shoe-hero.md +97 -0
- package/docs/workflows/README.md +14 -0
- package/docs/workflows/full-non-blender-user-workflow.md +210 -0
- package/docs/workflows/product-hero-workflow.md +92 -0
- package/laws/README.md +32 -0
- package/laws/evidence-before-done.md +37 -0
- package/laws/no-arbitrary-python-interface.md +32 -0
- package/laws/non-blender-user-language.md +32 -0
- package/laws/official-runtime-only.md +78 -0
- package/package.json +99 -4
- package/packs/README.md +11 -0
- package/packs/product-hero-v0/PACK.md +114 -0
- package/registry/catalog-index.json +21344 -0
- package/registry/compatibility-matrix.json +533 -0
- package/registry/contract-context-fields.json +391 -0
- package/registry/knowledge-catalog.json +4648 -0
- package/registry/knowledge-sources.json +438 -0
- package/registry/recipe-catalog.json +2565 -0
- package/registry/runtime-capability-policy.json +525 -0
- package/registry/runtime-operations.json +4468 -0
- package/registry/skills.json +10231 -0
- package/registry/workflow-graph.json +7390 -0
- package/schemas/adapter-compatibility-matrix.schema.json +166 -0
- package/schemas/contract-context-fields.schema.json +147 -0
- package/schemas/execution-plan.schema.json +325 -0
- package/schemas/glb-web-handoff-manifest.schema.json +744 -0
- package/schemas/knowledge-record.schema.json +460 -0
- package/schemas/knowledge-source-registry.schema.json +268 -0
- package/schemas/operation-execution-ledger.schema.json +348 -0
- package/schemas/recipe-record.schema.json +469 -0
- package/schemas/runtime-capability-policy.schema.json +184 -0
- package/schemas/runtime-evidence-packet.schema.json +211 -0
- package/schemas/runtime-operations.schema.json +535 -0
- package/schemas/runtime-qualification-report.schema.json +540 -0
- package/schemas/runtime-session.schema.json +350 -0
- package/schemas/scene-spec.schema.json +624 -0
- package/schemas/skill-contract.schema.json +402 -0
- package/schemas/skill-eval.schema.json +509 -0
- package/scripts/build-knowledge-catalog.mjs +2376 -0
- package/scripts/compile-scene-plan.mjs +1945 -0
- package/scripts/export-claude-skills.mjs +634 -0
- package/scripts/generate-glb-handoff-report.mjs +2376 -0
- package/scripts/inspect-glb.mjs +1627 -0
- package/scripts/install-skills.mjs +5369 -0
- package/scripts/runtime-orchestrator.mjs +7652 -0
- package/scripts/validate-capability-policy.mjs +531 -0
- package/scripts/validate-evidence-packet.mjs +256 -0
- package/skills/README.md +315 -0
- package/skills/_template/SKILL.md +296 -0
- package/skills/acceptance-criteria-builder/EVAL.md +25 -0
- package/skills/acceptance-criteria-builder/SKILL.md +257 -0
- package/skills/acceptance-criteria-builder/contract.json +205 -0
- package/skills/acceptance-criteria-builder/references/brief-to-criteria-mapper.md +22 -0
- package/skills/acceptance-criteria-builder/references/checklist-patterns.md +22 -0
- package/skills/acceptance-criteria-builder/references/evidence-hook-rules.md +19 -0
- package/skills/asset-discovery/EVAL.md +81 -0
- package/skills/asset-discovery/SKILL.md +252 -0
- package/skills/asset-discovery/contract.json +291 -0
- package/skills/asset-discovery/references/asset-strategy-decision-tree.md +40 -0
- package/skills/asset-discovery/references/budget-reconciliation-patterns.md +54 -0
- package/skills/asset-discovery/references/license-confidence-table.md +41 -0
- package/skills/asset-fallback-strategy/EVAL.md +34 -0
- package/skills/asset-fallback-strategy/SKILL.md +248 -0
- package/skills/asset-fallback-strategy/contract.json +190 -0
- package/skills/asset-fallback-strategy/references/drop-with-caveat-rules.md +36 -0
- package/skills/asset-fallback-strategy/references/fallback-option-types.md +55 -0
- package/skills/asset-fallback-strategy/references/scoring-rubric.md +61 -0
- package/skills/asset-library-plan/EVAL.md +28 -0
- package/skills/asset-library-plan/SKILL.md +263 -0
- package/skills/asset-library-plan/contract.json +177 -0
- package/skills/asset-library-plan/references/folder-structure-rules.md +63 -0
- package/skills/asset-library-plan/references/metadata-schema.md +62 -0
- package/skills/asset-library-plan/references/naming-rules.md +51 -0
- package/skills/asset-license-checker/EVAL.md +33 -0
- package/skills/asset-license-checker/SKILL.md +245 -0
- package/skills/asset-license-checker/contract.json +172 -0
- package/skills/asset-license-checker/references/attribution-rendering-patterns.md +48 -0
- package/skills/asset-license-checker/references/common-license-mapping.md +39 -0
- package/skills/asset-license-checker/references/license-source-rules.md +38 -0
- package/skills/asset-style-check/EVAL.md +26 -0
- package/skills/asset-style-check/SKILL.md +238 -0
- package/skills/asset-style-check/contract.json +251 -0
- package/skills/asset-style-check/references/drift-classification.md +40 -0
- package/skills/asset-style-check/references/intentional-mixed-style.md +39 -0
- package/skills/asset-style-check/references/style-axes.md +46 -0
- package/skills/blender-brainstorming/EVAL.md +79 -0
- package/skills/blender-brainstorming/SKILL.md +228 -0
- package/skills/blender-brainstorming/contract.json +115 -0
- package/skills/blender-brainstorming/references/alternative-scoping-templates.md +43 -0
- package/skills/blender-brainstorming/references/clarification-patterns.md +29 -0
- package/skills/blender-brainstorming/references/intent-summary-style-guide.md +25 -0
- package/skills/blender-recipe-decomposer/EVAL.md +35 -0
- package/skills/blender-recipe-decomposer/SKILL.md +258 -0
- package/skills/blender-recipe-decomposer/contract.json +152 -0
- package/skills/blender-recipe-decomposer/references/dependency-patterns.md +53 -0
- package/skills/blender-recipe-decomposer/references/recipe-grouping-rules.md +58 -0
- package/skills/blender-recipe-decomposer/references/recipe-naming-rules.md +44 -0
- package/skills/blender-troubleshooting/EVAL.md +78 -0
- package/skills/blender-troubleshooting/SKILL.md +263 -0
- package/skills/blender-troubleshooting/contract.json +352 -0
- package/skills/blender-troubleshooting/references/common-symptom-playbooks.md +51 -0
- package/skills/blender-troubleshooting/references/divergence-routing-table.md +23 -0
- package/skills/blender-troubleshooting/references/four-phase-template.md +51 -0
- package/skills/blendops-help/EVAL.md +67 -0
- package/skills/blendops-help/SKILL.md +312 -0
- package/skills/blendops-help/contract.json +229 -0
- package/skills/blendops-help/references/lifecycle-phases.md +91 -0
- package/skills/blendops-help/references/quick-start-prompts.md +65 -0
- package/skills/blendops-help/references/routing-decision-tree.md +57 -0
- package/skills/bridge-conflicts/EVAL.md +83 -0
- package/skills/bridge-conflicts/SKILL.md +246 -0
- package/skills/bridge-conflicts/contract.json +145 -0
- package/skills/bridge-conflicts/references/bridge-state-matrix-template.md +82 -0
- package/skills/bridge-conflicts/references/conflict-playbooks.md +99 -0
- package/skills/bridge-conflicts/references/do-not-reminders.md +42 -0
- package/skills/camera-composition/EVAL.md +32 -0
- package/skills/camera-composition/SKILL.md +196 -0
- package/skills/camera-composition/contract.json +180 -0
- package/skills/camera-composition/references/camera-presets.md +30 -0
- package/skills/camera-composition/references/camera-rubric.md +24 -0
- package/skills/camera-composition/references/hero-composition-patterns.md +24 -0
- package/skills/camera-composition/references/web-layout-negative-space.md +25 -0
- package/skills/character-portrait/EVAL.md +42 -0
- package/skills/character-portrait/SKILL.md +245 -0
- package/skills/character-portrait/contract.json +205 -0
- package/skills/character-portrait/references/portrait-framing-rules.md +39 -0
- package/skills/character-portrait/references/portrait-lighting-patterns.md +50 -0
- package/skills/character-portrait/references/style-consistency-rules.md +41 -0
- package/skills/cli-appendix-job-outline/EVAL.md +26 -0
- package/skills/cli-appendix-job-outline/SKILL.md +252 -0
- package/skills/cli-appendix-job-outline/contract.json +147 -0
- package/skills/cli-appendix-job-outline/references/flag-order-reminders.md +16 -0
- package/skills/cli-appendix-job-outline/references/job-type-matrix.md +13 -0
- package/skills/cli-appendix-job-outline/references/stateless-limitations.md +12 -0
- package/skills/color-management-decision/EVAL.md +28 -0
- package/skills/color-management-decision/SKILL.md +254 -0
- package/skills/color-management-decision/contract.json +162 -0
- package/skills/color-management-decision/references/look-comparison.md +44 -0
- package/skills/color-management-decision/references/per-channel-rules.md +49 -0
- package/skills/color-management-decision/references/pipeline-mapping.md +47 -0
- package/skills/composition-quality-checker/EVAL.md +38 -0
- package/skills/composition-quality-checker/SKILL.md +260 -0
- package/skills/composition-quality-checker/contract.json +221 -0
- package/skills/composition-quality-checker/references/aspect-ratio-rules.md +37 -0
- package/skills/composition-quality-checker/references/composition-rules.md +58 -0
- package/skills/composition-quality-checker/references/headroom-leadroom-rules.md +46 -0
- package/skills/cycles-vs-eevee-decision/EVAL.md +26 -0
- package/skills/cycles-vs-eevee-decision/SKILL.md +249 -0
- package/skills/cycles-vs-eevee-decision/contract.json +142 -0
- package/skills/cycles-vs-eevee-decision/references/engine-feature-matrix.md +39 -0
- package/skills/cycles-vs-eevee-decision/references/gpu-device-rules.md +51 -0
- package/skills/cycles-vs-eevee-decision/references/samples-by-quality.md +53 -0
- package/skills/done-criteria/EVAL.md +33 -0
- package/skills/done-criteria/SKILL.md +225 -0
- package/skills/done-criteria/contract.json +199 -0
- package/skills/done-criteria/references/done-vs-perfect.md +56 -0
- package/skills/done-criteria/references/out-of-scope-patterns.md +50 -0
- package/skills/done-criteria/references/stop-condition-templates.md +39 -0
- package/skills/environment-shot/EVAL.md +44 -0
- package/skills/environment-shot/SKILL.md +237 -0
- package/skills/environment-shot/contract.json +162 -0
- package/skills/environment-shot/references/depth-layering-rules.md +49 -0
- package/skills/environment-shot/references/time-and-weather-rules.md +35 -0
- package/skills/environment-shot/references/wide-shot-camera-rules.md +51 -0
- package/skills/glb-animation-handoff/EVAL.md +39 -0
- package/skills/glb-animation-handoff/SKILL.md +271 -0
- package/skills/glb-animation-handoff/contract.json +247 -0
- package/skills/glb-animation-handoff/references/animation-types.md +36 -0
- package/skills/glb-animation-handoff/references/transition-rules.md +55 -0
- package/skills/glb-animation-handoff/references/web-stack-caveats.md +40 -0
- package/skills/glb-web-handoff/EVAL.md +33 -0
- package/skills/glb-web-handoff/SKILL.md +212 -0
- package/skills/glb-web-handoff/contract.json +171 -0
- package/skills/glb-web-handoff/references/artifact-status-language.md +26 -0
- package/skills/glb-web-handoff/references/glb-handoff-checklist.md +30 -0
- package/skills/glb-web-handoff/references/performance-caveats.md +26 -0
- package/skills/glb-web-handoff/references/threejs-r3f-handoff.md +28 -0
- package/skills/intent-to-3d-brief-writer/EVAL.md +82 -0
- package/skills/intent-to-3d-brief-writer/SKILL.md +238 -0
- package/skills/intent-to-3d-brief-writer/contract.json +195 -0
- package/skills/intent-to-3d-brief-writer/references/acceptance-criteria-patterns.md +46 -0
- package/skills/intent-to-3d-brief-writer/references/eight-slot-template.md +123 -0
- package/skills/intent-to-3d-brief-writer/references/mixed-audience-handling.md +39 -0
- package/skills/interior-scene/EVAL.md +44 -0
- package/skills/interior-scene/SKILL.md +261 -0
- package/skills/interior-scene/contract.json +277 -0
- package/skills/interior-scene/references/furniture-layout-rules.md +51 -0
- package/skills/interior-scene/references/interior-architecture-rules.md +47 -0
- package/skills/interior-scene/references/interior-camera-rules.md +47 -0
- package/skills/lighting-material-plan/EVAL.md +32 -0
- package/skills/lighting-material-plan/SKILL.md +194 -0
- package/skills/lighting-material-plan/contract.json +213 -0
- package/skills/lighting-material-plan/references/cyberpunk-lookdev.md +22 -0
- package/skills/lighting-material-plan/references/lighting-patterns.md +30 -0
- package/skills/lighting-material-plan/references/material-portability.md +25 -0
- package/skills/lighting-material-plan/references/reflective-floor-pattern.md +22 -0
- package/skills/lighting-material-plan/references/web-material-simplification.md +23 -0
- package/skills/lighting-quality-checker/EVAL.md +41 -0
- package/skills/lighting-quality-checker/SKILL.md +247 -0
- package/skills/lighting-quality-checker/contract.json +187 -0
- package/skills/lighting-quality-checker/references/hdri-balance-rules.md +48 -0
- package/skills/lighting-quality-checker/references/intensity-ranges.md +73 -0
- package/skills/lighting-quality-checker/references/shadow-softness-rules.md +38 -0
- package/skills/material-quality-checker/EVAL.md +40 -0
- package/skills/material-quality-checker/SKILL.md +261 -0
- package/skills/material-quality-checker/contract.json +244 -0
- package/skills/material-quality-checker/references/consumer-stack-rules.md +62 -0
- package/skills/material-quality-checker/references/pbr-sanity-rules.md +78 -0
- package/skills/material-quality-checker/references/texture-budget-rules.md +48 -0
- package/skills/mobile-glb-budget/EVAL.md +40 -0
- package/skills/mobile-glb-budget/SKILL.md +264 -0
- package/skills/mobile-glb-budget/contract.json +309 -0
- package/skills/mobile-glb-budget/references/budget-tiers.md +30 -0
- package/skills/mobile-glb-budget/references/degradation-plan.md +34 -0
- package/skills/mobile-glb-budget/references/violation-rules.md +43 -0
- package/skills/output-format-decision/EVAL.md +27 -0
- package/skills/output-format-decision/SKILL.md +222 -0
- package/skills/output-format-decision/contract.json +179 -0
- package/skills/output-format-decision/references/bit-depth-rules.md +56 -0
- package/skills/output-format-decision/references/compression-tradeoffs.md +62 -0
- package/skills/output-format-decision/references/format-decision-matrix.md +34 -0
- package/skills/pack-prerequisite-checker/EVAL.md +26 -0
- package/skills/pack-prerequisite-checker/SKILL.md +272 -0
- package/skills/pack-prerequisite-checker/contract.json +214 -0
- package/skills/pack-prerequisite-checker/references/blocked-start-playbook.md +21 -0
- package/skills/pack-prerequisite-checker/references/pack-readiness-template.md +38 -0
- package/skills/pack-prerequisite-checker/references/prerequisite-matrix.md +20 -0
- package/skills/path-one-host-outline/EVAL.md +26 -0
- package/skills/path-one-host-outline/SKILL.md +251 -0
- package/skills/path-one-host-outline/contract.json +167 -0
- package/skills/path-one-host-outline/references/connector-vs-manual-matrix.md +21 -0
- package/skills/path-one-host-outline/references/host-checklist-template.md +35 -0
- package/skills/path-one-host-outline/references/lab-addon-reminders.md +12 -0
- package/skills/plain-language-response/EVAL.md +33 -0
- package/skills/plain-language-response/SKILL.md +194 -0
- package/skills/plain-language-response/contract.json +242 -0
- package/skills/plain-language-response/references/caveat-language.md +25 -0
- package/skills/plain-language-response/references/plain-language-patterns.md +30 -0
- package/skills/plain-language-response/references/stakeholder-friendly-examples.md +30 -0
- package/skills/plain-language-response/references/status-summary-templates.md +50 -0
- package/skills/polycount-budget-checker/EVAL.md +40 -0
- package/skills/polycount-budget-checker/SKILL.md +251 -0
- package/skills/polycount-budget-checker/contract.json +196 -0
- package/skills/polycount-budget-checker/references/instance-counting-rules.md +39 -0
- package/skills/polycount-budget-checker/references/per-mesh-rules.md +43 -0
- package/skills/polycount-budget-checker/references/topology-hints.md +56 -0
- package/skills/pre-handoff-verification/EVAL.md +84 -0
- package/skills/pre-handoff-verification/SKILL.md +252 -0
- package/skills/pre-handoff-verification/contract.json +295 -0
- package/skills/pre-handoff-verification/references/downgrade-rules.md +39 -0
- package/skills/pre-handoff-verification/references/seven-point-checklist.md +46 -0
- package/skills/pre-handoff-verification/references/text-only-mode-handling.md +36 -0
- package/skills/preview-report/EVAL.md +39 -0
- package/skills/preview-report/SKILL.md +254 -0
- package/skills/preview-report/contract.json +141 -0
- package/skills/preview-report/references/handoff-recipients.md +41 -0
- package/skills/preview-report/references/report-schema.md +60 -0
- package/skills/preview-report/references/truth-label-rules.md +36 -0
- package/skills/product-grid-scene-planner/EVAL.md +42 -0
- package/skills/product-grid-scene-planner/SKILL.md +246 -0
- package/skills/product-grid-scene-planner/contract.json +257 -0
- package/skills/product-grid-scene-planner/references/grid-consistency-rules.md +53 -0
- package/skills/product-grid-scene-planner/references/grid-layout-rules.md +42 -0
- package/skills/product-grid-scene-planner/references/grid-output-naming-rules.md +52 -0
- package/skills/product-hero-scene-planner/EVAL.md +33 -0
- package/skills/product-hero-scene-planner/SKILL.md +227 -0
- package/skills/product-hero-scene-planner/contract.json +228 -0
- package/skills/product-hero-scene-planner/references/clarification-patterns.md +24 -0
- package/skills/product-hero-scene-planner/references/cyberpunk-shoe-example.md +28 -0
- package/skills/product-hero-scene-planner/references/product-hero-playbooks.md +22 -0
- package/skills/product-hero-scene-planner/references/scene-plan-schema.md +35 -0
- package/skills/r3f-component-plan/EVAL.md +43 -0
- package/skills/r3f-component-plan/SKILL.md +290 -0
- package/skills/r3f-component-plan/contract.json +171 -0
- package/skills/r3f-component-plan/references/component-shape-patterns.md +54 -0
- package/skills/r3f-component-plan/references/suspense-placement-rules.md +50 -0
- package/skills/r3f-component-plan/references/usegltf-caching-rules.md +53 -0
- package/skills/recipe-fit-assessor/EVAL.md +28 -0
- package/skills/recipe-fit-assessor/SKILL.md +266 -0
- package/skills/recipe-fit-assessor/contract.json +220 -0
- package/skills/recipe-fit-assessor/references/recipe-catalog.md +30 -0
- package/skills/recipe-fit-assessor/references/scope-gap-rules.md +27 -0
- package/skills/recipe-fit-assessor/references/workflow-recommendation-template.md +34 -0
- package/skills/render-export-evidence/EVAL.md +86 -0
- package/skills/render-export-evidence/SKILL.md +339 -0
- package/skills/render-export-evidence/contract.json +206 -0
- package/skills/render-export-evidence/references/attempted-vs-failed-rubric.md +75 -0
- package/skills/render-export-evidence/references/evidence-record-templates.md +143 -0
- package/skills/render-export-evidence/references/truth-label-decision-tree.md +57 -0
- package/skills/resolution-aspect-decision/EVAL.md +26 -0
- package/skills/resolution-aspect-decision/SKILL.md +246 -0
- package/skills/resolution-aspect-decision/contract.json +160 -0
- package/skills/resolution-aspect-decision/references/aspect-defaults.md +41 -0
- package/skills/resolution-aspect-decision/references/print-vs-screen-rules.md +58 -0
- package/skills/resolution-aspect-decision/references/resolution-defaults.md +64 -0
- package/skills/runtime-attempt-report/EVAL.md +26 -0
- package/skills/runtime-attempt-report/SKILL.md +268 -0
- package/skills/runtime-attempt-report/contract.json +176 -0
- package/skills/runtime-attempt-report/references/attempt-record-template.md +49 -0
- package/skills/runtime-attempt-report/references/triage-next-steps.md +15 -0
- package/skills/runtime-attempt-report/references/truth-label-blocks.md +27 -0
- package/skills/runtime-path-picker/EVAL.md +26 -0
- package/skills/runtime-path-picker/SKILL.md +268 -0
- package/skills/runtime-path-picker/contract.json +191 -0
- package/skills/runtime-path-picker/references/anti-patterns.md +14 -0
- package/skills/runtime-path-picker/references/decision-tree.md +29 -0
- package/skills/runtime-path-picker/references/path-constraints-table.md +18 -0
- package/skills/runtime-readiness/EVAL.md +33 -0
- package/skills/runtime-readiness/SKILL.md +218 -0
- package/skills/runtime-readiness/contract.json +190 -0
- package/skills/runtime-readiness/references/blocker-report-template.md +28 -0
- package/skills/runtime-readiness/references/evidence-examples.md +23 -0
- package/skills/runtime-readiness/references/readiness-matrix.md +46 -0
- package/skills/runtime-setup/EVAL.md +33 -0
- package/skills/runtime-setup/SKILL.md +209 -0
- package/skills/runtime-setup/contract.json +171 -0
- package/skills/runtime-setup/references/runtime-option-decision-tree.md +28 -0
- package/skills/runtime-setup/references/setup-summary-template.md +33 -0
- package/skills/runtime-setup/references/source-confidence-labels.md +23 -0
- package/skills/scene-readiness/EVAL.md +33 -0
- package/skills/scene-readiness/SKILL.md +195 -0
- package/skills/scene-readiness/contract.json +198 -0
- package/skills/scene-readiness/references/blocker-catalog.md +24 -0
- package/skills/scene-readiness/references/not-run-handling.md +22 -0
- package/skills/scene-readiness/references/quality-rubric.md +23 -0
- package/skills/scene-readiness/references/verdict-language.md +22 -0
- package/skills/scope-guard/EVAL.md +33 -0
- package/skills/scope-guard/SKILL.md +222 -0
- package/skills/scope-guard/contract.json +171 -0
- package/skills/scope-guard/references/options-language-template.md +51 -0
- package/skills/scope-guard/references/recurring-creep-patterns.md +55 -0
- package/skills/scope-guard/references/scope-addition-classification.md +55 -0
- package/skills/stage-gates/EVAL.md +40 -0
- package/skills/stage-gates/SKILL.md +257 -0
- package/skills/stage-gates/contract.json +490 -0
- package/skills/stage-gates/references/failed-gate-handling.md +42 -0
- package/skills/stage-gates/references/gate-template.md +46 -0
- package/skills/stage-gates/references/stage-decomposition-patterns.md +55 -0
- package/skills/workflow-stage-router/EVAL.md +25 -0
- package/skills/workflow-stage-router/SKILL.md +259 -0
- package/skills/workflow-stage-router/contract.json +150 -0
- package/skills/workflow-stage-router/references/milestone-model.md +20 -0
- package/skills/workflow-stage-router/references/routing-decision-tree.md +32 -0
- package/skills/workflow-stage-router/references/stage-handoff-template.md +37 -0
- package/skills.sh.json +102 -0
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/stage-gates/SKILL.md and skills/stage-gates/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# stage-gates
|
|
3
|
+
|
|
4
|
+
Purpose: Define explicit per-stage gates and acceptance checklists before any modeling, render, or export work — work only proceeds gate by gate.
|
|
5
|
+
|
|
6
|
+
Enforce a checklist-driven discipline where every stage of a Blender recipe (brief → asset → scene → render → export → handoff) has a written acceptance gate. Work does not advance until the previous stage's gate is checked off. Inspired by Anthropic Superpowers `/test-driven-development` analog: gate first, work second.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `process-discipline` | Role `stage-gate-checklist-enforcer` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
|
|
10
|
+
## When to use & trigger cues
|
|
11
|
+
- complex multi-stage recipe (4+ distinct stages) requiring per-stage gate enforcement
|
|
12
|
+
- when work must be locked behind explicit `Pending | Pass | Fail | Blocked` stage gates before advancing
|
|
13
|
+
- when the user wants verifiable proof that each stage passes its checks before starting the next stage
|
|
14
|
+
- before any runtime work begins, to lock concrete checks, required evidence, and failure exits per stage
|
|
15
|
+
- Trigger phrases: "let's do this step by step", "what's done before we move on", "checklist for this work", "I want to make sure each stage is solid"
|
|
16
|
+
|
|
17
|
+
## When not to use (delegation boundaries)
|
|
18
|
+
- single-step requests → use `blender-brainstorming` (`references/skill-blender-brainstorming.md`; Delegates out-of-scope requests to blender-brainstorming)
|
|
19
|
+
- pure exploratory brainstorming → use `blender-brainstorming` (`references/skill-blender-brainstorming.md`; use blender-brainstorming)
|
|
20
|
+
- decomposing a brief into stages → use `blender-recipe-decomposer` (`references/skill-blender-recipe-decomposer.md`; use blender-recipe-decomposer)
|
|
21
|
+
- writing measurable acceptance criteria rows from scratch → use `acceptance-criteria-builder` (`references/skill-acceptance-criteria-builder.md`; use acceptance-criteria-builder)
|
|
22
|
+
- pinning the overall done/stop condition → use `done-criteria` (`references/skill-done-criteria.md`; use done-criteria)
|
|
23
|
+
- guarding against mid-flight scope creep → use `scope-guard` (`references/skill-scope-guard.md`; use scope-guard)
|
|
24
|
+
- selecting which skill runs next across the workflow → use `workflow-stage-router` (`references/skill-workflow-stage-router.md`; use workflow-stage-router)
|
|
25
|
+
- fixing repeated stage failures or broken renders → use `blender-troubleshooting` (`references/skill-blender-troubleshooting.md`; use blender-troubleshooting)
|
|
26
|
+
- executing the final 7-point handoff gate → use `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`; use pre-handoff-verification)
|
|
27
|
+
|
|
28
|
+
## Input & output contract
|
|
29
|
+
- Required input `active_workflow_stages` (`array`): Ordered stages of the selected BlendOps recipe or custom workflow
|
|
30
|
+
- Required input `locked_acceptance_criteria` (`object`): Measurable acceptance rows from acceptance-criteria-builder
|
|
31
|
+
- Optional input `current_stage_status` (`string`): Current stage progress and completed gate checks
|
|
32
|
+
- Output contract: `stage_gate_checklists`, `entry_and_exit_preconditions`, `gate_failure_routing_rules` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
33
|
+
|
|
34
|
+
## Quick-start steps
|
|
35
|
+
1. list the stages of the user's recipe
|
|
36
|
+
2. write the gate per stage (specific, checkable conditions)
|
|
37
|
+
3. run the gate after each stage; do not proceed if it fails
|
|
38
|
+
4. record the gate result + evidence per stage
|
|
39
|
+
|
|
40
|
+
## Cross-skill handoffs
|
|
41
|
+
- [upstream_reference] Brainstorming → `blender-brainstorming` (`references/skill-blender-brainstorming.md`) — `when.all: [goal.clarity equals "ambiguous_or_mixed"]`
|
|
42
|
+
- [upstream_reference] Brief authoring → `intent-to-3d-brief-writer` (`references/skill-intent-to-3d-brief-writer.md`) — `when.all: [goal.clarity equals "clear"; brief.locked equals false]`
|
|
43
|
+
- [upstream_reference] Recipe stage decomposition → `blender-recipe-decomposer` (`references/skill-blender-recipe-decomposer.md`) — `when.all: [fit.multiDeliverableDetected equals true]`
|
|
44
|
+
- [upstream_reference] Measurable acceptance rows → `acceptance-criteria-builder` (`references/skill-acceptance-criteria-builder.md`) — `when.all: [brief.locked equals true; stage.current equals "acceptance_criteria"]`
|
|
45
|
+
- [upstream_reference] Overall done condition → `done-criteria` (`references/skill-done-criteria.md`) — `when.all: [brief.locked equals true; stage.current equals "stop_condition"]`
|
|
46
|
+
- [progression] Scope creep protection → `scope-guard` (`references/skill-scope-guard.md`) — `when.all: [scope.driftDetected equals true]`
|
|
47
|
+
- [progression] Next-skill routing across stages → `workflow-stage-router` (`references/skill-workflow-stage-router.md`) — `when.all: [preflight.passed equals true; inventory.exists equals true]`
|
|
48
|
+
- [progression] Asset discovery → `asset-discovery` (`references/skill-asset-discovery.md`) — `when.all: [brief.locked equals true; assets.discoveryComplete equals false]`
|
|
49
|
+
- [progression] Scene planners (camera-composition) → `camera-composition` (`references/skill-camera-composition.md`) — `when.all: [brief.locked equals true; stage.current equals "camera_planning"]`
|
|
50
|
+
- [progression] Scene planners (lighting-material-plan) → `lighting-material-plan` (`references/skill-lighting-material-plan.md`) — `when.all: [brief.locked equals true; stage.current equals "lookdev_planning"]`
|
|
51
|
+
- [alternative] Scene planners (character-portrait) → `character-portrait` (`references/skill-character-portrait.md`) — `when.all: [brief.locked equals true; recipe.domain equals "character_portrait"]`
|
|
52
|
+
- [alternative] Scene planners (environment-shot) → `environment-shot` (`references/skill-environment-shot.md`) — `when.all: [brief.locked equals true; recipe.domain equals "environment_shot"]`
|
|
53
|
+
- [alternative] Scene planners (interior-scene) → `interior-scene` (`references/skill-interior-scene.md`) — `when.all: [brief.locked equals true; recipe.domain equals "interior_archviz"]`
|
|
54
|
+
- [alternative] Scene planners (product-grid-scene-planner) → `product-grid-scene-planner` (`references/skill-product-grid-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_grid"]`
|
|
55
|
+
- [alternative] Scene planners (product-hero-scene-planner) → `product-hero-scene-planner` (`references/skill-product-hero-scene-planner.md`) — `when.all: [brief.locked equals true; recipe.domain equals "product_hero"]`
|
|
56
|
+
- [progression] Quality validators (scene-readiness) → `scene-readiness` (`references/skill-scene-readiness.md`) — `when.all: [quality.domain equals "holistic"; stage.current equals "quality_validation"]`
|
|
57
|
+
- [progression] Quality validators (composition-quality-checker) → `composition-quality-checker` (`references/skill-composition-quality-checker.md`) — `when.all: [quality.domain equals "composition"; quality.verdict equals "not_run"]`
|
|
58
|
+
- [progression] Quality validators (lighting-quality-checker) → `lighting-quality-checker` (`references/skill-lighting-quality-checker.md`) — `when.all: [quality.domain equals "lighting"; quality.verdict equals "not_run"]`
|
|
59
|
+
- [progression] Quality validators (material-quality-checker) → `material-quality-checker` (`references/skill-material-quality-checker.md`) — `when.all: [quality.domain equals "material"; quality.verdict equals "not_run"]`
|
|
60
|
+
- [progression] Quality validators (polycount-budget-checker) → `polycount-budget-checker` (`references/skill-polycount-budget-checker.md`) — `when.all: [quality.domain equals "polycount"; budget.verdict equals "Not Run"]`
|
|
61
|
+
- [fallback] Repeated gate failures → `blender-troubleshooting` (`references/skill-blender-troubleshooting.md`) — `when.all: [runtime.errorDetected equals true]`
|
|
62
|
+
- [progression] Final 7-point gate → `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`) — `when.all: [stage.current equals "final_verification"]`
|
|
63
|
+
|
|
64
|
+
## Safety boundaries & non-goals
|
|
65
|
+
- Runtime boundary: Process / discipline skill — does not run Blender. Gates are written and evaluated against produced artifacts (per `evidence-before-done.md`). Gate verdicts are honest labels, not motivation.
|
|
66
|
+
- Run Blender or execute Python.
|
|
67
|
+
- Decompose recipes into stages (`blender-recipe-decomposer`).
|
|
68
|
+
- Write measurable acceptance criteria rows (`acceptance-criteria-builder`).
|
|
69
|
+
- Pin the overall done/stop condition (`done-criteria`).
|
|
70
|
+
- Guard against scope creep (`scope-guard`).
|
|
71
|
+
- Pick next skills across the workflow (`workflow-stage-router`).
|
|
72
|
+
- Diagnose repeated technical failures (`blender-troubleshooting`).
|
|
73
|
+
- Replace the final 7-point handoff gate (`pre-handoff-verification`).
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
<!-- Generated by scripts/generate-bundle-reference-summaries.mjs from skills/workflow-stage-router/SKILL.md and skills/workflow-stage-router/contract.json. Run `npm run bundles:summaries:build` to regenerate. Do not edit manually. -->
|
|
2
|
+
# workflow-stage-router
|
|
3
|
+
|
|
4
|
+
Purpose: Given current artifacts and intent, name the next BlendOps skill or workflow stage and preconditions to advance.
|
|
5
|
+
|
|
6
|
+
Reduce skill-choice paralysis by mapping **current state → next narrow skill** across BlendOps workflows while preserving evidence and runtime boundaries.
|
|
7
|
+
|
|
8
|
+
Metadata: Contract `v1.0.0` | Category `routing-and-governance` | Role `mid-workflow-stage-router` | Tier `L0` | Runtime default `Not Run` | Artifact default `Not Produced` | Mutation `downgrade_only`
|
|
9
|
+
Routing precedence: group `entry-and-stage-routing`, rank `4` | activationGate: `goalClarity="clear"`, `recipeSelected=true`, `preflightPassed=true`, `hasStageOrArtifactInventory=true`
|
|
10
|
+
|
|
11
|
+
## When to use & trigger cues
|
|
12
|
+
- user asks "what skill next" after partial progress
|
|
13
|
+
- agent risks loading too many skills at once
|
|
14
|
+
- resume after interruption
|
|
15
|
+
- Trigger phrases: "where are we in the workflow", "what's next", "resume from here", "next skill"
|
|
16
|
+
|
|
17
|
+
## When not to use (delegation boundaries)
|
|
18
|
+
- Initial goal is vague or entry point is unknown → use `blendops-help` (`references/skill-blendops-help.md`; Triages ambiguous entry requests at precedence Rank 1)
|
|
19
|
+
- Goal is clear but no recipe or pack has been chosen yet → use `recipe-fit-assessor` (`references/skill-recipe-fit-assessor.md`; Selects the fitting recipe/pack at precedence Rank 2)
|
|
20
|
+
- Pack is selected and brief exists, but pack preflight has not completed yet → use `pack-prerequisite-checker` (`references/skill-pack-prerequisite-checker.md`; Executes preflight readiness verification at precedence Rank 3 before stage routing)
|
|
21
|
+
- Active MCP runtime bridge conflict on port 9876 → use `bridge-conflicts` (`references/skill-bridge-conflicts.md`; Resolves port and dual add-on conflicts before advancing)
|
|
22
|
+
- Final stakeholder-facing wording and plain-language summary → use `plain-language-response` (`references/skill-plain-language-response.md`; Formats validated workflow outputs for non-Blender users)
|
|
23
|
+
|
|
24
|
+
## Input & output contract
|
|
25
|
+
- Required input `current_artifact_inventory` (`artifact_inventory`): Determines current milestone stage and downgrade-only truth labels
|
|
26
|
+
- Required input `active_intent` (`string`): Prevents routing to the wrong domain branch
|
|
27
|
+
- Optional input `target_pack_or_recipe` (`string`): Narrows milestone track
|
|
28
|
+
- Output contract: `current_stage_name`, `single_immediate_next_skill`, `preconditions_checklist` (Runtime status: `Not Run`, Artifact status: `Not Produced`, `downgrade_only`).
|
|
29
|
+
|
|
30
|
+
## Quick-start steps
|
|
31
|
+
1. capture what exists now (brief, plan, renders, GLB, evidence logs)
|
|
32
|
+
2. compare against `skills/workflow-stage-router/references/milestone-model.md`
|
|
33
|
+
3. emit route via `skills/workflow-stage-router/references/routing-decision-tree.md`
|
|
34
|
+
4. fill `skills/workflow-stage-router/references/stage-handoff-template.md`
|
|
35
|
+
|
|
36
|
+
## Cross-skill handoffs
|
|
37
|
+
- [upstream_reference] Pack entry preflight gate → `pack-prerequisite-checker` (`references/skill-pack-prerequisite-checker.md`) — `when.all: [preflight.passed equals false]`
|
|
38
|
+
- [conditional] Runtime readiness check → `runtime-readiness` (`references/skill-runtime-readiness.md`) — `when.all: [runtime.status equals "Not Run"; stage.requiresRuntime equals true]`
|
|
39
|
+
- [fallback] Active MCP bridge conflict on port 9876 → `bridge-conflicts` (`references/skill-bridge-conflicts.md`) — `when.all: [runtime.conflictDetected equals true]`
|
|
40
|
+
- [boundary_delegation] Mid-workflow scope expansion or unapproved deliverable addition → `scope-guard` (`references/skill-scope-guard.md`) — `when.all: [scope.driftDetected equals true]`
|
|
41
|
+
- [progression] Evidence updates for render or export outputs → `render-export-evidence` (`references/skill-render-export-evidence.md`) — `when.all: [stage.current equals "post_execution_audit"]`
|
|
42
|
+
- [fallback] Failed gate / blocked mode exit / final gate → `pre-handoff-verification` (`references/skill-pre-handoff-verification.md`) — `when.any: [gate.status equals "failed"; runtime.mode equals "blocked"; stage.current equals "final_verification"]`
|
|
43
|
+
|
|
44
|
+
## Safety boundaries & non-goals
|
|
45
|
+
- Runtime boundary: Routing only — no Python and no Blender execution (`execute_blender_code` is never invoked here). If the next step requires runtime selection or configuration, route to `runtime-path-picker`, `runtime-setup`, `runtime-readiness`, `path-one-host-outline`, or `cli-appendix-job-outline` with these locked boundaries:
|
|
46
|
+
- Initial entry triage when the user's goal is unclear (use `blendops-help`).
|
|
47
|
+
- Selecting a recipe/pack (`recipe-fit-assessor`) or running initial pack preflight (`pack-prerequisite-checker`).
|
|
48
|
+
- Executing domain scene planning, running Blender or Python, or verifying artifact files directly.
|
|
49
|
+
- Writing final stakeholder-facing delivery copy (use `plain-language-response` after verification).
|
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
# GLB Web Handoff & Viewer Integration Examples
|
|
2
|
+
|
|
3
|
+
> **Truth-State Boundary:** These integration modules and CLI tools inspect existing `.glb` files and generate deterministic web handoff manifests, HTML/Markdown reports, and viewer integration code. They do **not** run Blender, do **not** export models from a `.blend` scene, and do **not** upgrade `Runtime status: Not Run` or `Artifact status: Not Produced` without a real runtime evidence record.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## What is in this folder
|
|
8
|
+
|
|
9
|
+
| File | Stack | Purpose |
|
|
10
|
+
|---|---|---|
|
|
11
|
+
| [`./threejs-glb-viewer.mjs`](./threejs-glb-viewer.mjs) | Vanilla Three.js (`r150+`) | Reusable ESM controller + pure helpers for manifest normalization, `GLTFLoader` decoder wiring (`DRACOLoader`, `MeshoptDecoder`, `KTX2Loader`), bounding-box camera framing, animation clip inspection, and scene graph memory disposal. |
|
|
12
|
+
| [`./r3f-glb-viewer.tsx`](./r3f-glb-viewer.tsx) | React Three Fiber (`@react-three/fiber` + `@react-three/drei`) | Reusable TypeScript component (`BlendOpsGlbModel`, `BlendOpsGlbViewerCanvas`, `GlbViewerErrorBoundary`) with `useGLTF`, `useAnimations`, `<Suspense>`, imperative ref handle, and unmount cache control. |
|
|
13
|
+
|
|
14
|
+
Related repository artifacts:
|
|
15
|
+
- Handoff manifest JSON Schema: [`../../../schemas/glb-web-handoff-manifest.schema.json`](../../../schemas/glb-web-handoff-manifest.schema.json)
|
|
16
|
+
- GLB 2.0 binary & structural inspector: [`../../../scripts/inspect-glb.mjs`](../../../scripts/inspect-glb.mjs)
|
|
17
|
+
- Web handoff report & manifest generator: [`../../../scripts/generate-glb-handoff-report.mjs`](../../../scripts/generate-glb-handoff-report.mjs)
|
|
18
|
+
- GLB web handoff skill: [`../../../skills/glb-web-handoff/SKILL.md`](../../../skills/glb-web-handoff/SKILL.md)
|
|
19
|
+
- React Three Fiber component planner skill: [`../../../skills/r3f-component-plan/SKILL.md`](../../../skills/r3f-component-plan/SKILL.md)
|
|
20
|
+
- Workflow contract: [`../../workflow-contract.md`](../../workflow-contract.md)
|
|
21
|
+
- Golden-path reference: [`../../golden-path-cyberpunk-shoe.md`](../../golden-path-cyberpunk-shoe.md)
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## 1. Quick CLI workflow
|
|
26
|
+
|
|
27
|
+
Before dropping a `.glb` into a web application, run the BlendOps GLB inspection and handoff report commands:
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
# 1. Inspect GLB 2.0 binary container, scene hierarchy, meshes, materials, textures, animations, and 4 validation tiers
|
|
31
|
+
npx blendops glb-inspect ./path/to/model.glb
|
|
32
|
+
|
|
33
|
+
# 2. Generate a complete web handoff package (glb-handoff-manifest.json, glb-handoff-report.md, glb-handoff-report.html)
|
|
34
|
+
npx blendops glb-handoff ./path/to/model.glb --out-dir ./glb-handoff-out --viewer react-three-fiber
|
|
35
|
+
|
|
36
|
+
# 3. Validate an existing handoff manifest against schemas/glb-web-handoff-manifest.schema.json + semantic truth rules
|
|
37
|
+
npx blendops glb-validate-manifest ./glb-handoff-out/glb-handoff-manifest.json
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
When testing with synthetic fixtures inside automated tests, pass `--synthetic` so the generated manifest records `provenance: "synthetic_fixture"` and keeps `Artifact status: Not Produced`:
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
npx blendops glb-handoff ./fixture.glb --out-dir ./tmp-report --synthetic
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
## 2. Four-Tier Validation Model
|
|
49
|
+
|
|
50
|
+
Every BlendOps GLB inspection and handoff report separates verification into four explicit tiers so structural container checks are never mistaken for visual or live Blender runtime verification:
|
|
51
|
+
|
|
52
|
+
| Tier | Name | What it verifies | Default status on local `.glb` inspection |
|
|
53
|
+
|---|---|---|---|
|
|
54
|
+
| **Tier 1** | Container & Structural (`inspect-glb.mjs`) | 12-byte GLB header, chunk alignment, JSON/BIN bounds, bufferViews, accessors, node hierarchy (no cycles/multi-parents), declared extensions, and URI traversal safety. | `Pass` or `Fail` |
|
|
55
|
+
| **Tier 2** | Full glTF 2.0 Specification (`gltf-validator`) | Complete Khronos glTF 2.0 schema and accessor payload validation when `--khronos` is enabled and `gltf-validator` is installed. | `Skipped` (or `Pass` / `Warn` / `Fail` with `--khronos`) |
|
|
56
|
+
| **Tier 3** | Visual & Aesthetic Quality | Lighting balance, silhouette clarity, UV seam visibility, and PBR material response in the target viewport. | `Not Evaluated` |
|
|
57
|
+
| **Tier 4** | Live Blender Runtime Execution | Whether a live Blender session (Path 1 Blender Lab MCP in Blender 5.1+, Path 2 community `mcp-for-blender`, or CLI appendix) exported the asset with a recorded eval packet. | `Not Run` |
|
|
58
|
+
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
## 3. Using the Vanilla Three.js Viewer (`threejs-glb-viewer.mjs`)
|
|
62
|
+
|
|
63
|
+
### Dependencies in your web project
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
npm install three
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### Example usage
|
|
70
|
+
|
|
71
|
+
```js
|
|
72
|
+
import { createThreeGlbViewer } from './threejs-glb-viewer.mjs';
|
|
73
|
+
import manifest from './glb-handoff-out/glb-handoff-manifest.json' with { type: 'json' };
|
|
74
|
+
|
|
75
|
+
const container = document.getElementById('viewer-root');
|
|
76
|
+
|
|
77
|
+
const viewer = await createThreeGlbViewer({
|
|
78
|
+
container,
|
|
79
|
+
manifest,
|
|
80
|
+
assetUrl: '/models/product-hero.glb',
|
|
81
|
+
decoderPaths: {
|
|
82
|
+
dracoGltfPath: '/decoders/draco/gltf/',
|
|
83
|
+
basisTranscoderPath: '/decoders/basis/',
|
|
84
|
+
},
|
|
85
|
+
onProgress: ({ ratio }) => {
|
|
86
|
+
if (ratio !== null) {
|
|
87
|
+
console.log(`Loading GLB: ${(ratio * 100).toFixed(1)}%`);
|
|
88
|
+
}
|
|
89
|
+
},
|
|
90
|
+
onLoad: ({ animations, framing }) => {
|
|
91
|
+
console.log('Loaded clips:', animations);
|
|
92
|
+
console.log('Camera framing:', framing);
|
|
93
|
+
},
|
|
94
|
+
onError: (err) => {
|
|
95
|
+
console.error('GLB load failed:', err);
|
|
96
|
+
},
|
|
97
|
+
});
|
|
98
|
+
|
|
99
|
+
await viewer.loadAsset();
|
|
100
|
+
|
|
101
|
+
// Drive the render loop
|
|
102
|
+
let lastTime = performance.now();
|
|
103
|
+
function animate(now) {
|
|
104
|
+
const dt = (now - lastTime) / 1000;
|
|
105
|
+
lastTime = now;
|
|
106
|
+
viewer.stepFrame(dt);
|
|
107
|
+
requestAnimationFrame(animate);
|
|
108
|
+
}
|
|
109
|
+
requestAnimationFrame(animate);
|
|
110
|
+
|
|
111
|
+
window.addEventListener('resize', () => viewer.resize());
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
---
|
|
115
|
+
|
|
116
|
+
## 4. Using the React Three Fiber Component (`r3f-glb-viewer.tsx`)
|
|
117
|
+
|
|
118
|
+
### Dependencies in your React project
|
|
119
|
+
|
|
120
|
+
```bash
|
|
121
|
+
npm install three @types/three @react-three/fiber @react-three/drei
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
### Example usage
|
|
125
|
+
|
|
126
|
+
```tsx
|
|
127
|
+
import React, { useRef } from 'react';
|
|
128
|
+
import {
|
|
129
|
+
BlendOpsGlbViewerCanvas,
|
|
130
|
+
type BlendOpsGlbModelHandle,
|
|
131
|
+
} from './r3f-glb-viewer';
|
|
132
|
+
|
|
133
|
+
export function ProductHeroPreview() {
|
|
134
|
+
const modelRef = useRef<BlendOpsGlbModelHandle | null>(null);
|
|
135
|
+
|
|
136
|
+
return (
|
|
137
|
+
<div>
|
|
138
|
+
<BlendOpsGlbViewerCanvas
|
|
139
|
+
ref={modelRef}
|
|
140
|
+
url="/models/product-hero.glb"
|
|
141
|
+
environmentPreset="city"
|
|
142
|
+
autoFitBounds={true}
|
|
143
|
+
dracoDecoderPath="/decoders/draco/gltf/"
|
|
144
|
+
enableMeshopt={false}
|
|
145
|
+
onLoaded={({ clipNames }) => {
|
|
146
|
+
console.log('Available animation clips:', clipNames);
|
|
147
|
+
}}
|
|
148
|
+
/>
|
|
149
|
+
<div style={{ display: 'flex', gap: '8px', marginTop: '8px' }}>
|
|
150
|
+
<button type="button" onClick={() => modelRef.current?.playClip('Turntable')}>
|
|
151
|
+
Play Turntable
|
|
152
|
+
</button>
|
|
153
|
+
<button type="button" onClick={() => modelRef.current?.stopAllClips()}>
|
|
154
|
+
Stop Clips
|
|
155
|
+
</button>
|
|
156
|
+
</div>
|
|
157
|
+
</div>
|
|
158
|
+
);
|
|
159
|
+
}
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
## 5. Decoder & Transform Reference
|
|
165
|
+
|
|
166
|
+
1. **Coordinate System & Units:**
|
|
167
|
+
- glTF 2.0 uses `+Y up, +Z forward, -X right` with `1 unit = 1 meter`.
|
|
168
|
+
- Blender's internal `-Y forward, +Z up` axes are converted automatically when the Blender glTF 2.0 exporter's `+Y Up` option is enabled.
|
|
169
|
+
- If `spatial.hasNonIdentityRootScale` is `true` in `glb-handoff-manifest.json`, apply transforms (`Ctrl+A -> All Transforms`) in Blender before final delivery so physics colliders and `<Bounds>` framing behave predictably.
|
|
170
|
+
- If `spatial.hasNegativeScale` is `true`, mesh face winding may invert in WebGL (`gl.BACK` culling), causing inside-out surfaces.
|
|
171
|
+
2. **Compression Decoders:**
|
|
172
|
+
- `compression.draco: true` (`KHR_draco_mesh_compression`) requires `DRACOLoader` with WASM/JS decoder files hosted at `dracoGltfPath`.
|
|
173
|
+
- `compression.meshopt: true` (`EXT_meshopt_compression`) requires `MeshoptDecoder` attached via `loader.setMeshoptDecoder(MeshoptDecoder)`.
|
|
174
|
+
- `compression.ktx2BasisU: true` (`KHR_texture_basisu`) requires `KTX2Loader` initialized with `ktx2Loader.detectSupport(renderer)` before `loader.load()`.
|
|
@@ -0,0 +1,320 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* BlendOps — Reusable React Three Fiber (`@react-three/fiber` + `@react-three/drei`)
|
|
3
|
+
* GLB Viewer Integration Example
|
|
4
|
+
*
|
|
5
|
+
* Designed to pair directly with a BlendOps GLB Web Handoff Manifest
|
|
6
|
+
* (`schemas/glb-web-handoff-manifest.schema.json`) and the component shape rules in
|
|
7
|
+
* `skills/three-fiber-component-shape-planner/SKILL.md`.
|
|
8
|
+
*
|
|
9
|
+
* Dependencies in target web app:
|
|
10
|
+
* npm install three @types/three @react-three/fiber @react-three/drei
|
|
11
|
+
*/
|
|
12
|
+
|
|
13
|
+
import React, {
|
|
14
|
+
Component,
|
|
15
|
+
Suspense,
|
|
16
|
+
forwardRef,
|
|
17
|
+
useEffect,
|
|
18
|
+
useImperativeHandle,
|
|
19
|
+
useRef,
|
|
20
|
+
type ErrorInfo,
|
|
21
|
+
type ReactNode,
|
|
22
|
+
} from 'react';
|
|
23
|
+
import { Canvas, useThree } from '@react-three/fiber';
|
|
24
|
+
import { Bounds, Center, Environment, Html, OrbitControls, useAnimations, useGLTF } from '@react-three/drei';
|
|
25
|
+
import type { AnimationClip, Group, Object3D } from 'three';
|
|
26
|
+
import { KTX2Loader } from 'three/addons/loaders/KTX2Loader.js';
|
|
27
|
+
import { MeshoptDecoder } from 'three/addons/libs/meshopt_decoder.module.js';
|
|
28
|
+
|
|
29
|
+
export interface BlendOpsGlbModelProps {
|
|
30
|
+
/** Public URL or path to the `.glb` asset (e.g. `/models/product-hero.glb`). */
|
|
31
|
+
url: string;
|
|
32
|
+
/** Optional animation clip name to play on mount. */
|
|
33
|
+
clipName?: string;
|
|
34
|
+
/** Whether to auto-play the selected or first available animation clip (default: true). */
|
|
35
|
+
autoPlay?: boolean;
|
|
36
|
+
/** Uniform or 3-axis scale override (default: 1, assuming 1 unit = 1 meter). */
|
|
37
|
+
scale?: number | [number, number, number];
|
|
38
|
+
/** Root position offset in meters (default: [0, 0, 0]). */
|
|
39
|
+
position?: [number, number, number];
|
|
40
|
+
/** Root Euler rotation in radians (default: [0, 0, 0]). */
|
|
41
|
+
rotation?: [number, number, number];
|
|
42
|
+
/** Enable Draco decoder (`KHR_draco_mesh_compression`) or provide a custom decoder path. */
|
|
43
|
+
dracoDecoderPath?: boolean | string;
|
|
44
|
+
/** Enable Meshopt decoder (`EXT_meshopt_compression`). */
|
|
45
|
+
enableMeshopt?: boolean;
|
|
46
|
+
/** Enable KTX2 BasisU transcoder (`KHR_texture_basisu`) and provide transcoder folder URL. */
|
|
47
|
+
basisTranscoderPath?: string;
|
|
48
|
+
/** Apply castShadow/receiveShadow to child meshes (default: true). */
|
|
49
|
+
shadows?: boolean;
|
|
50
|
+
/** Whether to clear the `useGLTF` cache entry when this component unmounts (default: false). */
|
|
51
|
+
clearCacheOnUnmount?: boolean;
|
|
52
|
+
/** Callback fired once the GLB scene and animation clips are ready. */
|
|
53
|
+
onLoaded?: (summary: {
|
|
54
|
+
scene: Group;
|
|
55
|
+
clipNames: string[];
|
|
56
|
+
animations: AnimationClip[];
|
|
57
|
+
}) => void;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
export interface BlendOpsGlbModelHandle {
|
|
61
|
+
/** Underlying Three.js root Group reference. */
|
|
62
|
+
getRootGroup: () => Group | null;
|
|
63
|
+
/** List of animation clip names discovered in the GLB. */
|
|
64
|
+
getAvailableClips: () => string[];
|
|
65
|
+
/** Play a named animation clip with optional crossfade duration in seconds. */
|
|
66
|
+
playClip: (clipName: string, fadeSeconds?: number) => boolean;
|
|
67
|
+
/** Stop all currently playing animation clips. */
|
|
68
|
+
stopAllClips: () => void;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/**
|
|
72
|
+
* Error boundary that catches GLB network, decoder, or parsing errors around `<Suspense>`
|
|
73
|
+
* and renders a structured diagnostic fallback instead of crashing the React tree.
|
|
74
|
+
*/
|
|
75
|
+
export interface GlbErrorBoundaryProps {
|
|
76
|
+
assetUrl: string;
|
|
77
|
+
fallback?: (error: Error, reset: () => void) => ReactNode;
|
|
78
|
+
onError?: (error: Error, info: ErrorInfo) => void;
|
|
79
|
+
children: ReactNode;
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
interface GlbErrorBoundaryState {
|
|
83
|
+
error: Error | null;
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
export class GlbViewerErrorBoundary extends Component<GlbErrorBoundaryProps, GlbErrorBoundaryState> {
|
|
87
|
+
public state: GlbErrorBoundaryState = { error: null };
|
|
88
|
+
|
|
89
|
+
public static getDerivedStateFromError(error: Error): GlbErrorBoundaryState {
|
|
90
|
+
return { error };
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
public componentDidCatch(error: Error, info: ErrorInfo): void {
|
|
94
|
+
if (this.props.onError) {
|
|
95
|
+
this.props.onError(error, info);
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
private handleReset = (): void => {
|
|
100
|
+
this.setState({ error: null });
|
|
101
|
+
};
|
|
102
|
+
|
|
103
|
+
public render(): ReactNode {
|
|
104
|
+
const { error } = this.state;
|
|
105
|
+
if (error) {
|
|
106
|
+
if (this.props.fallback) {
|
|
107
|
+
return this.props.fallback(error, this.handleReset);
|
|
108
|
+
}
|
|
109
|
+
return (
|
|
110
|
+
<div
|
|
111
|
+
role="alert"
|
|
112
|
+
style={{
|
|
113
|
+
padding: '1rem',
|
|
114
|
+
borderRadius: '0.5rem',
|
|
115
|
+
border: '1px solid #ef4444',
|
|
116
|
+
background: '#18181b',
|
|
117
|
+
color: '#fca5a5',
|
|
118
|
+
fontFamily: 'ui-monospace, SFMono-Regular, Menlo, monospace',
|
|
119
|
+
fontSize: '0.85rem',
|
|
120
|
+
}}
|
|
121
|
+
>
|
|
122
|
+
<strong>GLB Viewer Load Error ({this.props.assetUrl})</strong>
|
|
123
|
+
<p style={{ margin: '0.5rem 0' }}>{error.message}</p>
|
|
124
|
+
<button
|
|
125
|
+
type="button"
|
|
126
|
+
onClick={this.handleReset}
|
|
127
|
+
style={{
|
|
128
|
+
padding: '0.35rem 0.75rem',
|
|
129
|
+
borderRadius: '0.375rem',
|
|
130
|
+
border: '1px solid #52525b',
|
|
131
|
+
background: '#27272a',
|
|
132
|
+
color: '#fafafa',
|
|
133
|
+
cursor: 'pointer',
|
|
134
|
+
}}
|
|
135
|
+
>
|
|
136
|
+
Retry Load
|
|
137
|
+
</button>
|
|
138
|
+
</div>
|
|
139
|
+
);
|
|
140
|
+
}
|
|
141
|
+
return this.props.children;
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
/**
|
|
146
|
+
* Scene-level GLB model component using `@react-three/drei`'s `useGLTF` and `useAnimations`.
|
|
147
|
+
*/
|
|
148
|
+
export const BlendOpsGlbModel = forwardRef<BlendOpsGlbModelHandle, BlendOpsGlbModelProps>(
|
|
149
|
+
function BlendOpsGlbModel(
|
|
150
|
+
{
|
|
151
|
+
url,
|
|
152
|
+
clipName,
|
|
153
|
+
autoPlay = true,
|
|
154
|
+
scale = 1,
|
|
155
|
+
position = [0, 0, 0],
|
|
156
|
+
rotation = [0, 0, 0],
|
|
157
|
+
dracoDecoderPath = true,
|
|
158
|
+
enableMeshopt = false,
|
|
159
|
+
basisTranscoderPath,
|
|
160
|
+
shadows = true,
|
|
161
|
+
clearCacheOnUnmount = false,
|
|
162
|
+
onLoaded,
|
|
163
|
+
},
|
|
164
|
+
ref,
|
|
165
|
+
) {
|
|
166
|
+
const groupRef = useRef<Group | null>(null);
|
|
167
|
+
const gl = useThree((state) => state.gl);
|
|
168
|
+
|
|
169
|
+
const gltf = useGLTF(url, dracoDecoderPath, enableMeshopt, (loader) => {
|
|
170
|
+
if (enableMeshopt) {
|
|
171
|
+
loader.setMeshoptDecoder(MeshoptDecoder);
|
|
172
|
+
}
|
|
173
|
+
if (basisTranscoderPath) {
|
|
174
|
+
const ktx2Loader = new KTX2Loader();
|
|
175
|
+
ktx2Loader.setTranscoderPath(basisTranscoderPath);
|
|
176
|
+
ktx2Loader.detectSupport(gl);
|
|
177
|
+
loader.setKTX2Loader(ktx2Loader);
|
|
178
|
+
}
|
|
179
|
+
});
|
|
180
|
+
|
|
181
|
+
const { actions, names } = useAnimations(gltf.animations, groupRef);
|
|
182
|
+
|
|
183
|
+
useEffect(() => {
|
|
184
|
+
if (!gltf.scene) return;
|
|
185
|
+
gltf.scene.traverse((obj: Object3D) => {
|
|
186
|
+
if ('isMesh' in obj && (obj as unknown as { isMesh: boolean }).isMesh) {
|
|
187
|
+
obj.castShadow = shadows;
|
|
188
|
+
obj.receiveShadow = shadows;
|
|
189
|
+
}
|
|
190
|
+
});
|
|
191
|
+
if (onLoaded) {
|
|
192
|
+
onLoaded({
|
|
193
|
+
scene: gltf.scene,
|
|
194
|
+
clipNames: names,
|
|
195
|
+
animations: gltf.animations,
|
|
196
|
+
});
|
|
197
|
+
}
|
|
198
|
+
}, [gltf.scene, gltf.animations, names, shadows, onLoaded]);
|
|
199
|
+
|
|
200
|
+
useEffect(() => {
|
|
201
|
+
if (!autoPlay || names.length === 0) return;
|
|
202
|
+
const targetName = clipName && actions[clipName] ? clipName : names[0];
|
|
203
|
+
const action = targetName ? actions[targetName] : null;
|
|
204
|
+
if (action) {
|
|
205
|
+
action.reset().fadeIn(0.2).play();
|
|
206
|
+
}
|
|
207
|
+
return () => {
|
|
208
|
+
if (action) {
|
|
209
|
+
action.fadeOut(0.2);
|
|
210
|
+
}
|
|
211
|
+
};
|
|
212
|
+
}, [actions, names, clipName, autoPlay]);
|
|
213
|
+
|
|
214
|
+
useEffect(() => {
|
|
215
|
+
return () => {
|
|
216
|
+
if (clearCacheOnUnmount) {
|
|
217
|
+
useGLTF.clear(url);
|
|
218
|
+
}
|
|
219
|
+
};
|
|
220
|
+
}, [url, clearCacheOnUnmount]);
|
|
221
|
+
|
|
222
|
+
useImperativeHandle(
|
|
223
|
+
ref,
|
|
224
|
+
() => ({
|
|
225
|
+
getRootGroup: () => groupRef.current,
|
|
226
|
+
getAvailableClips: () => [...names],
|
|
227
|
+
playClip: (targetClip: string, fadeSeconds = 0.2) => {
|
|
228
|
+
const nextAction = actions[targetClip];
|
|
229
|
+
if (!nextAction) return false;
|
|
230
|
+
for (const [name, act] of Object.entries(actions)) {
|
|
231
|
+
if (name !== targetClip && act) {
|
|
232
|
+
act.fadeOut(fadeSeconds);
|
|
233
|
+
}
|
|
234
|
+
}
|
|
235
|
+
nextAction.reset().fadeIn(fadeSeconds).play();
|
|
236
|
+
return true;
|
|
237
|
+
},
|
|
238
|
+
stopAllClips: () => {
|
|
239
|
+
for (const act of Object.values(actions)) {
|
|
240
|
+
act?.stop();
|
|
241
|
+
}
|
|
242
|
+
},
|
|
243
|
+
}),
|
|
244
|
+
[actions, names],
|
|
245
|
+
);
|
|
246
|
+
|
|
247
|
+
return (
|
|
248
|
+
<group ref={groupRef} scale={scale} position={position} rotation={rotation} dispose={null}>
|
|
249
|
+
<primitive object={gltf.scene} />
|
|
250
|
+
</group>
|
|
251
|
+
);
|
|
252
|
+
},
|
|
253
|
+
);
|
|
254
|
+
|
|
255
|
+
export interface BlendOpsGlbViewerCanvasProps extends BlendOpsGlbModelProps {
|
|
256
|
+
/** Environment preset from `@react-three/drei` (default: `'city'`). */
|
|
257
|
+
environmentPreset?:
|
|
258
|
+
| 'apartment'
|
|
259
|
+
| 'city'
|
|
260
|
+
| 'dawn'
|
|
261
|
+
| 'forest'
|
|
262
|
+
| 'lobby'
|
|
263
|
+
| 'night'
|
|
264
|
+
| 'park'
|
|
265
|
+
| 'studio'
|
|
266
|
+
| 'sunset'
|
|
267
|
+
| 'warehouse';
|
|
268
|
+
/** Automatically center and fit camera bounds around the loaded model (default: true). */
|
|
269
|
+
autoFitBounds?: boolean;
|
|
270
|
+
/** CSS height of the viewer container (default: `'480px'`). */
|
|
271
|
+
height?: string;
|
|
272
|
+
}
|
|
273
|
+
|
|
274
|
+
/**
|
|
275
|
+
* Complete drop-in React Three Fiber viewer canvas with error boundary,
|
|
276
|
+
* `<Suspense>` loading state, environment lighting, bounds framing, and OrbitControls.
|
|
277
|
+
*/
|
|
278
|
+
export function BlendOpsGlbViewerCanvas({
|
|
279
|
+
url,
|
|
280
|
+
environmentPreset = 'city',
|
|
281
|
+
autoFitBounds = true,
|
|
282
|
+
height = '480px',
|
|
283
|
+
...modelProps
|
|
284
|
+
}: BlendOpsGlbViewerCanvasProps) {
|
|
285
|
+
return (
|
|
286
|
+
<GlbViewerErrorBoundary assetUrl={url}>
|
|
287
|
+
<div style={{ width: '100%', height, position: 'relative', background: '#09090b' }}>
|
|
288
|
+
<Canvas shadows dpr={[1, 2]} camera={{ position: [2.2, 1.6, 2.8], fov: 45 }}>
|
|
289
|
+
<Suspense
|
|
290
|
+
fallback={
|
|
291
|
+
<Html center>
|
|
292
|
+
<span
|
|
293
|
+
style={{
|
|
294
|
+
color: '#e4e4e7',
|
|
295
|
+
fontFamily: 'ui-monospace, SFMono-Regular, Menlo, monospace',
|
|
296
|
+
fontSize: '0.85rem',
|
|
297
|
+
}}
|
|
298
|
+
>
|
|
299
|
+
Loading {url}...
|
|
300
|
+
</span>
|
|
301
|
+
</Html>
|
|
302
|
+
}
|
|
303
|
+
>
|
|
304
|
+
<Environment preset={environmentPreset} />
|
|
305
|
+
{autoFitBounds ? (
|
|
306
|
+
<Bounds fit clip observe margin={1.25}>
|
|
307
|
+
<Center top>
|
|
308
|
+
<BlendOpsGlbModel url={url} {...modelProps} />
|
|
309
|
+
</Center>
|
|
310
|
+
</Bounds>
|
|
311
|
+
) : (
|
|
312
|
+
<BlendOpsGlbModel url={url} {...modelProps} />
|
|
313
|
+
)}
|
|
314
|
+
</Suspense>
|
|
315
|
+
<OrbitControls makeDefault enableDamping dampingFactor={0.05} />
|
|
316
|
+
</Canvas>
|
|
317
|
+
</div>
|
|
318
|
+
</GlbViewerErrorBoundary>
|
|
319
|
+
);
|
|
320
|
+
}
|