exonous 0.0.0-stage → 2.10.4
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/README.md +100 -2
- package/assets/THIRD-PARTY-NOTICES.md +29 -0
- package/assets/adapters/opencode/exonous.js +54 -0
- package/assets/agents/exo-backend.md +22 -0
- package/assets/agents/exo-cto.md +22 -0
- package/assets/agents/exo-data-ai.md +22 -0
- package/assets/agents/exo-designer.md +22 -0
- package/assets/agents/exo-devops.md +22 -0
- package/assets/agents/exo-frontend.md +22 -0
- package/assets/agents/exo-infra.md +22 -0
- package/assets/agents/exo-mobile.md +22 -0
- package/assets/agents/exo-pm.md +22 -0
- package/assets/agents/exo-qa.md +22 -0
- package/assets/agents/exo-researcher.md +22 -0
- package/assets/agents/exo-security.md +22 -0
- package/assets/agents/roster.json +209 -0
- package/assets/agents/taxis.js +189 -0
- package/assets/editors/cursor/frontend-skills.mdc +27 -0
- package/assets/editors/hooks/cursor/hooks.json +11 -0
- package/assets/machine/PR-TEMPLATE.md +21 -0
- package/assets/machine/hooks/anamnesis.cjs +61 -0
- package/assets/machine/hooks/ethos.cjs +48 -0
- package/assets/machine/hooks/kairos.cjs +46 -0
- package/assets/machine/hooks/lib/cli-options.cjs +133 -0
- package/assets/machine/hooks/lib/memory.cjs +488 -0
- package/assets/machine/hooks/lib/metron.cjs +52 -0
- package/assets/machine/hooks/lib/paths.cjs +99 -0
- package/assets/machine/hooks/lib/payload.cjs +81 -0
- package/assets/machine/hooks/lib/pr-template-validate.cjs +103 -0
- package/assets/machine/hooks/lib/release.cjs +58 -0
- package/assets/machine/hooks/lib/repo.cjs +138 -0
- package/assets/machine/hooks/lib/sanitize.cjs +37 -0
- package/assets/machine/hooks/lib/selfupdate.cjs +354 -0
- package/assets/machine/hooks/lib/shell.cjs +722 -0
- package/assets/machine/hooks/lib/template.cjs +70 -0
- package/assets/machine/hooks/lib/token.cjs +110 -0
- package/assets/machine/hooks/lib/validate-pr-body.cjs +21 -0
- package/assets/machine/hooks/pyle.cjs +302 -0
- package/assets/rules/nomos.md +59 -0
- package/assets/rules/praxis.md +38 -0
- package/assets/skills/code-review/SKILL.md +124 -0
- package/assets/skills/commit-changes/SKILL.md +49 -0
- package/assets/skills/deliver/SKILL.md +114 -0
- package/assets/skills/deliver/references/parallel.md +37 -0
- package/assets/skills/doc/SKILL.md +140 -0
- package/assets/skills/doc/doc.mjs +277 -0
- package/assets/skills/issue-board/SKILL.md +84 -0
- package/assets/skills/issue-board/board.mjs +389 -0
- package/assets/skills/issue-board/config.example.json +9 -0
- package/assets/skills/issue-board/render.py +189 -0
- package/assets/skills/make-pr/SKILL.md +24 -0
- package/assets/skills/native-ui/SKILL.md +67 -0
- package/assets/skills/native-ui/reference/apple.md +180 -0
- package/assets/skills/native-ui/reference/mobile-feel.md +221 -0
- package/assets/skills/native-ui/reference/swift.md +289 -0
- package/assets/skills/project-memory/SKILL.md +59 -0
- package/assets/skills/project-memory/config.example.json +4 -0
- package/assets/skills/project-memory/project-memory.mjs +478 -0
- package/assets/skills/security-review/SKILL.md +102 -0
- package/assets/skills/session-handoff/SKILL.md +23 -0
- package/assets/skills/session-handoff/config.example.json +3 -0
- package/assets/skills/ui-design/SKILL.md +75 -0
- package/assets/skills/ui-design/reference/adapt.md +151 -0
- package/assets/skills/ui-design/reference/adapt.native.md +35 -0
- package/assets/skills/ui-design/reference/android.md +50 -0
- package/assets/skills/ui-design/reference/animate.md +87 -0
- package/assets/skills/ui-design/reference/audit.md +76 -0
- package/assets/skills/ui-design/reference/audit.native.md +126 -0
- package/assets/skills/ui-design/reference/bolder.md +33 -0
- package/assets/skills/ui-design/reference/clarify.md +84 -0
- package/assets/skills/ui-design/reference/colorize.md +86 -0
- package/assets/skills/ui-design/reference/craft-floor.md +25 -0
- package/assets/skills/ui-design/reference/critique.md +345 -0
- package/assets/skills/ui-design/reference/degraded/asset-producer.md +35 -0
- package/assets/skills/ui-design/reference/degraded/documenter.md +23 -0
- package/assets/skills/ui-design/reference/degraded/finish-reviewer.md +43 -0
- package/assets/skills/ui-design/reference/degraded/manual-edit-applier.md +56 -0
- package/assets/skills/ui-design/reference/delight.md +63 -0
- package/assets/skills/ui-design/reference/distill.md +98 -0
- package/assets/skills/ui-design/reference/doctor.md +49 -0
- package/assets/skills/ui-design/reference/document.md +273 -0
- package/assets/skills/ui-design/reference/extract.md +52 -0
- package/assets/skills/ui-design/reference/harden.md +122 -0
- package/assets/skills/ui-design/reference/hooks.md +114 -0
- package/assets/skills/ui-design/reference/init.md +47 -0
- package/assets/skills/ui-design/reference/ios.md +55 -0
- package/assets/skills/ui-design/reference/layout.md +81 -0
- package/assets/skills/ui-design/reference/live-setup.md +75 -0
- package/assets/skills/ui-design/reference/live.md +326 -0
- package/assets/skills/ui-design/reference/new-work.md +350 -0
- package/assets/skills/ui-design/reference/onboard.md +85 -0
- package/assets/skills/ui-design/reference/operate.md +29 -0
- package/assets/skills/ui-design/reference/optimize.md +101 -0
- package/assets/skills/ui-design/reference/overdrive.md +83 -0
- package/assets/skills/ui-design/reference/polish.md +77 -0
- package/assets/skills/ui-design/reference/quieter.md +95 -0
- package/assets/skills/ui-design/reference/routing.md +37 -0
- package/assets/skills/ui-design/reference/shape.md +43 -0
- package/assets/skills/ui-design/reference/styles/brutalist.md +45 -0
- package/assets/skills/ui-design/reference/styles/design-md.md +70 -0
- package/assets/skills/ui-design/reference/styles/direction.md +95 -0
- package/assets/skills/ui-design/reference/styles/full-output.md +42 -0
- package/assets/skills/ui-design/reference/styles/minimalist.md +64 -0
- package/assets/skills/ui-design/reference/styles/premium.md +65 -0
- package/assets/skills/ui-design/reference/styles/redesign.md +59 -0
- package/assets/skills/ui-design/reference/typeset.md +73 -0
- package/assets/skills/ui-design/reference/visualize.md +156 -0
- package/assets/skills/ui-design/scripts/ENGINE-LICENSE +191 -0
- package/assets/skills/ui-design/scripts/VERSION +1 -0
- package/assets/skills/ui-design/scripts/bin/darwin-arm64/impeccable +0 -0
- package/assets/skills/ui-design/scripts/command-metadata.json +94 -0
- package/assets/skills/ui-design/scripts/data/font-index-failures.json +121 -0
- package/assets/skills/ui-design/scripts/data/font-index.json +1 -0
- package/assets/skills/ui-design/scripts/impeccable +206 -0
- package/assets/skills/ui-design/scripts/impeccable.cmd +214 -0
- package/assets/skills/ui-design/scripts/live-browser-dom.js +167 -0
- package/assets/skills/ui-design/scripts/live-browser-ignores.js +242 -0
- package/assets/skills/ui-design/scripts/live-browser-session.js +144 -0
- package/assets/skills/ui-design/scripts/live-browser.js +12990 -0
- package/assets/skills/ui-design/scripts/modern-screenshot.umd.js +14 -0
- package/assets/skills/ui-design/scripts/ui-design +6 -0
- package/assets/skills/ui-design/scripts/ui-design.cmd +3 -0
- package/assets/skills/ui-design/scripts/ui-design.mjs +124 -0
- package/assets/skills/ui-mockup/SKILL.md +68 -0
- package/assets/skills/ui-mockup/reference/brandkit.md +101 -0
- package/assets/skills/ui-mockup/reference/image-to-code.md +83 -0
- package/assets/skills/ui-mockup/reference/mobile-comps.md +94 -0
- package/assets/skills/ui-mockup/reference/web-comps.md +83 -0
- package/assets/skills/ui-motion/SKILL.md +112 -0
- package/assets/skills/ui-motion/reference/expo.md +224 -0
- package/assets/skills/ui-motion/reference/opportunities.md +81 -0
- package/assets/skills/ui-motion/reference/prototype.md +238 -0
- package/assets/skills/ui-motion/reference/review.md +163 -0
- package/assets/skills/ui-motion/reference/toasts.md +144 -0
- package/assets/skills/ui-motion/reference/ui-libraries.md +71 -0
- package/assets/skills/ui-motion/reference/vocabulary.md +130 -0
- package/assets/skills/ui-motion/reference/web.md +294 -0
- package/assets/skills/ui-patterns/SKILL.md +105 -0
- package/assets/skills/ui-patterns/references/stacks/html-tailwind.md +40 -0
- package/assets/skills/ui-patterns/references/stacks/nextjs.md +52 -0
- package/assets/skills/ui-patterns/references/stacks/nuxt.md +100 -0
- package/assets/skills/ui-patterns/references/stacks/react-native.md +48 -0
- package/assets/skills/ui-patterns/references/stacks/react.md +49 -0
- package/assets/skills/ui-patterns/references/stacks/shadcn.md +57 -0
- package/assets/skills/ui-patterns/references/stacks/vue.md +37 -0
- package/assets/techne/.claude-plugin/marketplace.json +31 -0
- package/assets/techne/.claude-plugin/plugin.json +24 -0
- package/assets/techne/.mcp.json +8 -0
- package/assets/techne/commands/build-fix.md +48 -0
- package/assets/techne/commands/refactor-clean.md +46 -0
- package/assets/techne/commands/test-coverage.md +42 -0
- package/assets/techne/hooks/hooks.json +49 -0
- package/assets/techne/rules/angular/coding-style.md +49 -0
- package/assets/techne/rules/angular/hooks.md +23 -0
- package/assets/techne/rules/angular/patterns.md +48 -0
- package/assets/techne/rules/angular/security.md +26 -0
- package/assets/techne/rules/angular/testing.md +46 -0
- package/assets/techne/rules/arkts/coding-style.md +63 -0
- package/assets/techne/rules/arkts/hooks.md +38 -0
- package/assets/techne/rules/arkts/patterns.md +42 -0
- package/assets/techne/rules/arkts/security.md +35 -0
- package/assets/techne/rules/arkts/testing.md +39 -0
- package/assets/techne/rules/common/agents.md +6 -0
- package/assets/techne/rules/common/code-review.md +15 -0
- package/assets/techne/rules/common/coding-style.md +13 -0
- package/assets/techne/rules/common/development-workflow.md +5 -0
- package/assets/techne/rules/common/git-workflow.md +30 -0
- package/assets/techne/rules/common/hooks.md +7 -0
- package/assets/techne/rules/common/patterns.md +3 -0
- package/assets/techne/rules/common/performance.md +3 -0
- package/assets/techne/rules/common/security.md +5 -0
- package/assets/techne/rules/common/testing.md +3 -0
- package/assets/techne/rules/cpp/coding-style.md +31 -0
- package/assets/techne/rules/cpp/hooks.md +26 -0
- package/assets/techne/rules/cpp/patterns.md +31 -0
- package/assets/techne/rules/cpp/security.md +37 -0
- package/assets/techne/rules/cpp/testing.md +31 -0
- package/assets/techne/rules/csharp/coding-style.md +30 -0
- package/assets/techne/rules/csharp/hooks.md +24 -0
- package/assets/techne/rules/csharp/patterns.md +28 -0
- package/assets/techne/rules/csharp/security.md +32 -0
- package/assets/techne/rules/csharp/testing.md +27 -0
- package/assets/techne/rules/dart/coding-style.md +47 -0
- package/assets/techne/rules/dart/hooks.md +26 -0
- package/assets/techne/rules/dart/patterns.md +38 -0
- package/assets/techne/rules/dart/security.md +44 -0
- package/assets/techne/rules/dart/testing.md +39 -0
- package/assets/techne/rules/fsharp/coding-style.md +34 -0
- package/assets/techne/rules/fsharp/hooks.md +25 -0
- package/assets/techne/rules/fsharp/patterns.md +43 -0
- package/assets/techne/rules/fsharp/security.md +32 -0
- package/assets/techne/rules/fsharp/testing.md +27 -0
- package/assets/techne/rules/golang/coding-style.md +30 -0
- package/assets/techne/rules/golang/hooks.md +17 -0
- package/assets/techne/rules/golang/patterns.md +43 -0
- package/assets/techne/rules/golang/security.md +33 -0
- package/assets/techne/rules/golang/testing.md +20 -0
- package/assets/techne/rules/java/coding-style.md +51 -0
- package/assets/techne/rules/java/hooks.md +18 -0
- package/assets/techne/rules/java/patterns.md +55 -0
- package/assets/techne/rules/java/security.md +33 -0
- package/assets/techne/rules/java/testing.md +33 -0
- package/assets/techne/rules/kotlin/coding-style.md +50 -0
- package/assets/techne/rules/kotlin/hooks.md +17 -0
- package/assets/techne/rules/kotlin/patterns.md +44 -0
- package/assets/techne/rules/kotlin/security.md +34 -0
- package/assets/techne/rules/kotlin/testing.md +38 -0
- package/assets/techne/rules/nuxt/coding-style.md +20 -0
- package/assets/techne/rules/nuxt/hooks.md +16 -0
- package/assets/techne/rules/nuxt/patterns.md +46 -0
- package/assets/techne/rules/nuxt/security.md +19 -0
- package/assets/techne/rules/nuxt/testing.md +15 -0
- package/assets/techne/rules/perl/coding-style.md +33 -0
- package/assets/techne/rules/perl/hooks.md +22 -0
- package/assets/techne/rules/perl/patterns.md +43 -0
- package/assets/techne/rules/perl/security.md +39 -0
- package/assets/techne/rules/perl/testing.md +42 -0
- package/assets/techne/rules/php/coding-style.md +30 -0
- package/assets/techne/rules/php/hooks.md +24 -0
- package/assets/techne/rules/php/patterns.md +26 -0
- package/assets/techne/rules/php/security.md +27 -0
- package/assets/techne/rules/php/testing.md +28 -0
- package/assets/techne/rules/python/coding-style.md +38 -0
- package/assets/techne/rules/python/fastapi.md +57 -0
- package/assets/techne/rules/python/hooks.md +19 -0
- package/assets/techne/rules/python/patterns.md +37 -0
- package/assets/techne/rules/python/security.md +26 -0
- package/assets/techne/rules/python/testing.md +32 -0
- package/assets/techne/rules/react/coding-style.md +24 -0
- package/assets/techne/rules/react/hooks.md +62 -0
- package/assets/techne/rules/react/patterns.md +48 -0
- package/assets/techne/rules/react/security.md +45 -0
- package/assets/techne/rules/react/testing.md +42 -0
- package/assets/techne/rules/react-native/accessibility.md +14 -0
- package/assets/techne/rules/react-native/coding-style.md +16 -0
- package/assets/techne/rules/react-native/hooks.md +16 -0
- package/assets/techne/rules/react-native/patterns.md +18 -0
- package/assets/techne/rules/react-native/performance.md +14 -0
- package/assets/techne/rules/react-native/production-readiness.md +16 -0
- package/assets/techne/rules/react-native/security.md +16 -0
- package/assets/techne/rules/react-native/testing.md +14 -0
- package/assets/techne/rules/ruby/coding-style.md +40 -0
- package/assets/techne/rules/ruby/hooks.md +33 -0
- package/assets/techne/rules/ruby/patterns.md +33 -0
- package/assets/techne/rules/ruby/security.md +39 -0
- package/assets/techne/rules/ruby/testing.md +35 -0
- package/assets/techne/rules/rust/coding-style.md +41 -0
- package/assets/techne/rules/rust/hooks.md +16 -0
- package/assets/techne/rules/rust/patterns.md +42 -0
- package/assets/techne/rules/rust/security.md +33 -0
- package/assets/techne/rules/rust/testing.md +30 -0
- package/assets/techne/rules/swift/coding-style.md +30 -0
- package/assets/techne/rules/swift/hooks.md +20 -0
- package/assets/techne/rules/swift/patterns.md +30 -0
- package/assets/techne/rules/swift/security.md +22 -0
- package/assets/techne/rules/swift/testing.md +28 -0
- package/assets/techne/rules/typescript/coding-style.md +38 -0
- package/assets/techne/rules/typescript/hooks.md +14 -0
- package/assets/techne/rules/typescript/patterns.md +12 -0
- package/assets/techne/rules/typescript/security.md +14 -0
- package/assets/techne/rules/typescript/testing.md +12 -0
- package/assets/techne/rules/vue/coding-style.md +19 -0
- package/assets/techne/rules/vue/hooks.md +13 -0
- package/assets/techne/rules/vue/patterns.md +29 -0
- package/assets/techne/rules/vue/security.md +11 -0
- package/assets/techne/rules/vue/testing.md +11 -0
- package/assets/techne/rules/web/coding-style.md +25 -0
- package/assets/techne/rules/web/design-quality.md +21 -0
- package/assets/techne/rules/web/hooks.md +39 -0
- package/assets/techne/rules/web/patterns.md +23 -0
- package/assets/techne/rules/web/performance.md +25 -0
- package/assets/techne/rules/web/security.md +23 -0
- package/assets/techne/rules/web/testing.md +21 -0
- package/assets/techne/scripts/hooks/config-guard.js +50 -0
- package/assets/techne/scripts/hooks/edit-tracker.js +26 -0
- package/assets/techne/scripts/hooks/lib/shell.js +204 -0
- package/assets/techne/scripts/hooks/no-verify-guard.js +205 -0
- package/assets/techne/scripts/hooks/run.js +92 -0
- package/assets/techne/scripts/hooks/stop-checks.js +136 -0
- package/assets/techne/skills/angular/SKILL.md +34 -0
- package/assets/techne/skills/angular/reference/components-and-templates.md +63 -0
- package/assets/techne/skills/angular/reference/dependency-injection.md +44 -0
- package/assets/techne/skills/angular/reference/forms.md +97 -0
- package/assets/techne/skills/angular/reference/routing.md +50 -0
- package/assets/techne/skills/angular/reference/signals-and-state.md +59 -0
- package/assets/techne/skills/angular/reference/styling-motion-a11y.md +54 -0
- package/assets/techne/skills/angular/reference/testing.md +52 -0
- package/assets/techne/skills/angular/reference/tooling.md +31 -0
- package/assets/techne/skills/cpp/SKILL.md +27 -0
- package/assets/techne/skills/cpp/reference/coding-standards.md +160 -0
- package/assets/techne/skills/databases/SKILL.md +35 -0
- package/assets/techne/skills/databases/reference/clickhouse.md +102 -0
- package/assets/techne/skills/databases/reference/migrations.md +94 -0
- package/assets/techne/skills/databases/reference/mysql.md +101 -0
- package/assets/techne/skills/databases/reference/postgres.md +72 -0
- package/assets/techne/skills/databases/reference/prisma.md +105 -0
- package/assets/techne/skills/databases/reference/redis.md +108 -0
- package/assets/techne/skills/delivery/SKILL.md +35 -0
- package/assets/techne/skills/delivery/reference/deployment-patterns.md +58 -0
- package/assets/techne/skills/delivery/reference/docker-patterns.md +77 -0
- package/assets/techne/skills/delivery/reference/git-workflow.md +64 -0
- package/assets/techne/skills/delivery/reference/github-ops.md +67 -0
- package/assets/techne/skills/delivery/reference/jira-integration.md +53 -0
- package/assets/techne/skills/delivery/reference/kubernetes-patterns.md +67 -0
- package/assets/techne/skills/dotnet/SKILL.md +27 -0
- package/assets/techne/skills/dotnet/reference/dotnet-core.md +131 -0
- package/assets/techne/skills/flutter/SKILL.md +29 -0
- package/assets/techne/skills/flutter/reference/code-review.md +76 -0
- package/assets/techne/skills/flutter/reference/patterns.md +201 -0
- package/assets/techne/skills/go/SKILL.md +28 -0
- package/assets/techne/skills/go/reference/patterns.md +87 -0
- package/assets/techne/skills/go/reference/testing.md +142 -0
- package/assets/techne/skills/java/SKILL.md +29 -0
- package/assets/techne/skills/java/reference/java-standards.md +117 -0
- package/assets/techne/skills/java/reference/springboot.md +108 -0
- package/assets/techne/skills/kotlin/SKILL.md +35 -0
- package/assets/techne/skills/kotlin/reference/android-clean-architecture.md +115 -0
- package/assets/techne/skills/kotlin/reference/compose-multiplatform-patterns.md +113 -0
- package/assets/techne/skills/kotlin/reference/kotlin-coroutines-flows.md +93 -0
- package/assets/techne/skills/kotlin/reference/kotlin-patterns.md +74 -0
- package/assets/techne/skills/kotlin/reference/kotlin-testing.md +115 -0
- package/assets/techne/skills/ml/SKILL.md +34 -0
- package/assets/techne/skills/ml/reference/ai-regression-testing.md +99 -0
- package/assets/techne/skills/ml/reference/cost-aware-llm-pipeline.md +133 -0
- package/assets/techne/skills/ml/reference/eval-harness.md +94 -0
- package/assets/techne/skills/ml/reference/mle-workflow.md +177 -0
- package/assets/techne/skills/ml/reference/prompt-optimizer.md +107 -0
- package/assets/techne/skills/ml/reference/pytorch-patterns.md +164 -0
- package/assets/techne/skills/php/SKILL.md +27 -0
- package/assets/techne/skills/php/reference/laravel.md +142 -0
- package/assets/techne/skills/python/SKILL.md +33 -0
- package/assets/techne/skills/python/reference/django.md +104 -0
- package/assets/techne/skills/python/reference/fastapi.md +118 -0
- package/assets/techne/skills/python/reference/python-core.md +88 -0
- package/assets/techne/skills/python/reference/python-testing.md +105 -0
- package/assets/techne/skills/quality/SKILL.md +34 -0
- package/assets/techne/skills/quality/reference/benchmark.md +55 -0
- package/assets/techne/skills/quality/reference/browser-qa.md +60 -0
- package/assets/techne/skills/quality/reference/coding-standards.md +88 -0
- package/assets/techne/skills/quality/reference/e2e-testing.md +99 -0
- package/assets/techne/skills/quality/reference/tdd-workflow.md +89 -0
- package/assets/techne/skills/quality/reference/verification-loop.md +80 -0
- package/assets/techne/skills/react/SKILL.md +30 -0
- package/assets/techne/skills/react/reference/nextjs-turbopack.md +42 -0
- package/assets/techne/skills/react/reference/react-patterns.md +139 -0
- package/assets/techne/skills/react/reference/react-performance.md +101 -0
- package/assets/techne/skills/react/reference/react-testing.md +139 -0
- package/assets/techne/skills/react-native/SKILL.md +28 -0
- package/assets/techne/skills/react-native/reference/expo-patterns.md +196 -0
- package/assets/techne/skills/research/SKILL.md +35 -0
- package/assets/techne/skills/research/reference/architecture-decision-records.md +65 -0
- package/assets/techne/skills/research/reference/codebase-onboarding.md +44 -0
- package/assets/techne/skills/research/reference/deep-research.md +50 -0
- package/assets/techne/skills/research/reference/iterative-retrieval.md +62 -0
- package/assets/techne/skills/research/reference/product-lens.md +38 -0
- package/assets/techne/skills/research/reference/search-first.md +50 -0
- package/assets/techne/skills/rust/SKILL.md +28 -0
- package/assets/techne/skills/rust/reference/patterns.md +108 -0
- package/assets/techne/skills/rust/reference/testing.md +142 -0
- package/assets/techne/skills/services/SKILL.md +32 -0
- package/assets/techne/skills/services/reference/api-contracts.md +139 -0
- package/assets/techne/skills/services/reference/backend-layers.md +95 -0
- package/assets/techne/skills/services/reference/errors-and-resilience.md +146 -0
- package/assets/techne/skills/services/reference/hexagonal-boundaries.md +93 -0
- package/assets/techne/skills/services/reference/mcp-servers.md +50 -0
- package/assets/techne/skills/services/reference/nestjs.md +96 -0
- package/assets/techne/skills/swift/SKILL.md +29 -0
- package/assets/techne/skills/swift/reference/concurrency.md +83 -0
- package/assets/techne/skills/swift/reference/swiftui.md +139 -0
- package/assets/techne/skills/vue/SKILL.md +29 -0
- package/assets/techne/skills/vue/reference/nuxt4-patterns.md +90 -0
- package/assets/techne/skills/vue/reference/ui-to-vue.md +90 -0
- package/assets/techne/skills/vue/reference/vue-patterns.md +151 -0
- package/assets/techne/skills/web/SKILL.md +30 -0
- package/assets/techne/skills/web/reference/bun-runtime.md +55 -0
- package/assets/techne/skills/web/reference/frontend-patterns.md +54 -0
- package/assets/techne/skills/web/reference/seo.md +77 -0
- package/assets/techne/skills/web/reference/vite-patterns.md +96 -0
- package/bin/native.cjs +30 -0
- package/native/aarch64-apple-darwin/exonous +0 -0
- package/native/aarch64-unknown-linux-gnu/exonous +0 -0
- package/native/x86_64-apple-darwin/exonous +0 -0
- package/native/x86_64-pc-windows-msvc/exonous.exe +0 -0
- package/native/x86_64-unknown-linux-gnu/exonous +0 -0
- package/package.json +1 -6
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// techne hook entry: node run.js <hook-id>, Claude Code hook payload on stdin.
|
|
3
|
+
// A hook module returns { block: reason } to stop the tool call (exit 2) or nothing to allow it.
|
|
4
|
+
'use strict';
|
|
5
|
+
|
|
6
|
+
const HOOKS = {
|
|
7
|
+
'pre:config-guard': { load: () => require('./config-guard'), phase: 'pre' },
|
|
8
|
+
'pre:bash:no-verify': { load: () => require('./no-verify-guard'), phase: 'pre' },
|
|
9
|
+
'post:edit-tracker': { load: () => require('./edit-tracker'), phase: 'post' },
|
|
10
|
+
'stop:checks': { load: () => require('./stop-checks'), phase: 'stop' },
|
|
11
|
+
};
|
|
12
|
+
|
|
13
|
+
const PROFILES = {
|
|
14
|
+
minimal: new Set(),
|
|
15
|
+
standard: new Set(Object.keys(HOOKS)),
|
|
16
|
+
strict: new Set(Object.keys(HOOKS)),
|
|
17
|
+
};
|
|
18
|
+
|
|
19
|
+
const MAX_INPUT_BYTES = 1024 * 1024;
|
|
20
|
+
|
|
21
|
+
function enabled(id, env = process.env) {
|
|
22
|
+
const profile = PROFILES[(env.EXONOUS_HOOK_PROFILE || 'standard').trim().toLowerCase()] || PROFILES.standard;
|
|
23
|
+
const disabled = (env.EXONOUS_DISABLED_HOOKS || '').split(',').map((s) => s.trim()).filter(Boolean);
|
|
24
|
+
return profile.has(id) && !disabled.includes(id);
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
function readInput() {
|
|
28
|
+
return new Promise((resolve) => {
|
|
29
|
+
const chunks = [];
|
|
30
|
+
let size = 0;
|
|
31
|
+
let truncated = false;
|
|
32
|
+
process.stdin.on('data', (chunk) => {
|
|
33
|
+
if (truncated) return;
|
|
34
|
+
size += chunk.length;
|
|
35
|
+
if (size > MAX_INPUT_BYTES) truncated = true;
|
|
36
|
+
else chunks.push(chunk);
|
|
37
|
+
});
|
|
38
|
+
process.stdin.on('end', () => resolve({ raw: truncated ? '' : Buffer.concat(chunks).toString('utf8'), truncated }));
|
|
39
|
+
process.stdin.on('error', () => resolve({ raw: '', truncated: true }));
|
|
40
|
+
});
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
function parse(raw) {
|
|
44
|
+
try {
|
|
45
|
+
const value = raw.trim() ? JSON.parse(raw) : {};
|
|
46
|
+
return value && typeof value === 'object' ? value : {};
|
|
47
|
+
} catch {
|
|
48
|
+
return {};
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
async function main() {
|
|
53
|
+
const id = process.argv[2];
|
|
54
|
+
const hook = HOOKS[id];
|
|
55
|
+
if (!hook) {
|
|
56
|
+
process.stderr.write(`[techne] unknown hook id: ${id || '(none)'}\n`);
|
|
57
|
+
return 0;
|
|
58
|
+
}
|
|
59
|
+
const { raw, truncated } = await readInput();
|
|
60
|
+
const payload = parse(raw);
|
|
61
|
+
|
|
62
|
+
// Cursor feeds Claude plugin hooks its own payload shape; pre hooks stay neutral there.
|
|
63
|
+
if (hook.phase === 'pre' && payload.cursor_version) {
|
|
64
|
+
process.stdout.write('{}');
|
|
65
|
+
return 0;
|
|
66
|
+
}
|
|
67
|
+
if (!enabled(id)) return 0;
|
|
68
|
+
|
|
69
|
+
try {
|
|
70
|
+
const result = hook.load()(payload, { truncated });
|
|
71
|
+
if (result && result.block) {
|
|
72
|
+
process.stderr.write(`[techne] ${result.block}\n`);
|
|
73
|
+
return 2;
|
|
74
|
+
}
|
|
75
|
+
} catch (err) {
|
|
76
|
+
process.stderr.write(`[techne] ${id} failed: ${err && err.message ? err.message : err}\n`);
|
|
77
|
+
// Guards fail closed: an unreadable command is not a safe command.
|
|
78
|
+
if (hook.phase === 'pre') {
|
|
79
|
+
process.stderr.write('[techne] refusing the tool call; set EXONOUS_DISABLED_HOOKS to bypass only if the user asks.\n');
|
|
80
|
+
return 2;
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
return 0;
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
if (require.main === module) {
|
|
87
|
+
main().then((code) => {
|
|
88
|
+
process.exitCode = code;
|
|
89
|
+
});
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
module.exports = { enabled, HOOKS };
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
// Stop: format the JS/TS files this session edited, type-check them, and flag leftover console.log.
|
|
2
|
+
// Advisory only — findings go to stderr and the hook always exits 0.
|
|
3
|
+
'use strict';
|
|
4
|
+
|
|
5
|
+
const fs = require('fs');
|
|
6
|
+
const os = require('os');
|
|
7
|
+
const path = require('path');
|
|
8
|
+
const { spawnSync } = require('child_process');
|
|
9
|
+
const { listFile } = require('./edit-tracker');
|
|
10
|
+
|
|
11
|
+
const CODE = /\.(c|m)?(j|t)sx?$/;
|
|
12
|
+
const TS = /\.(c|m)?tsx?$/;
|
|
13
|
+
const CONSOLE_EXEMPT = [/\.(test|spec)\.[cm]?[jt]sx?$/, /\.config\.[cm]?[jt]s$/, /[\\/](scripts|__tests__|__mocks__)[\\/]/];
|
|
14
|
+
const BUDGET_MS = 270000;
|
|
15
|
+
const PRETTIER_CONFIGS = ['.prettierrc', '.prettierrc.json', '.prettierrc.yml', '.prettierrc.yaml', '.prettierrc.json5', '.prettierrc.js', '.prettierrc.cjs', '.prettierrc.mjs', '.prettierrc.toml', 'prettier.config.js', 'prettier.config.cjs', 'prettier.config.mjs', 'prettier.config.ts'];
|
|
16
|
+
|
|
17
|
+
function takeEditedFiles(sessionId) {
|
|
18
|
+
const file = listFile(sessionId);
|
|
19
|
+
let raw = '';
|
|
20
|
+
try {
|
|
21
|
+
raw = fs.readFileSync(file, 'utf8');
|
|
22
|
+
fs.unlinkSync(file);
|
|
23
|
+
} catch {
|
|
24
|
+
return [];
|
|
25
|
+
}
|
|
26
|
+
return [...new Set(raw.split('\n').map((l) => l.trim()).filter(Boolean))];
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
function isInside(child, parent) {
|
|
30
|
+
const rel = path.relative(parent, child);
|
|
31
|
+
return rel !== '' && !rel.startsWith('..') && !path.isAbsolute(rel);
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
function eligible(file, cwd) {
|
|
35
|
+
if (!CODE.test(file) || !fs.existsSync(file)) return false;
|
|
36
|
+
if (file.split(path.sep).includes('node_modules')) return false;
|
|
37
|
+
// Windows runs .cmd shims through cmd.exe; never hand it a path it would parse as syntax.
|
|
38
|
+
if (process.platform === 'win32' && /[&|<>^%!\s()"]/.test(file)) return false;
|
|
39
|
+
const pluginRoots = [path.join(cwd, '.claude', 'plugins'), path.join(os.homedir(), '.claude', 'plugins')];
|
|
40
|
+
if (pluginRoots.some((root) => isInside(file, root))) return false;
|
|
41
|
+
return isInside(file, cwd);
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
function nearest(start, stop, names) {
|
|
45
|
+
let dir = start;
|
|
46
|
+
for (;;) {
|
|
47
|
+
if (names.some((n) => fs.existsSync(path.join(dir, n)))) return dir;
|
|
48
|
+
if (dir === stop || path.dirname(dir) === dir) return null;
|
|
49
|
+
dir = path.dirname(dir);
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
function localBin(root, name) {
|
|
54
|
+
const bin = path.join(root, 'node_modules', '.bin', process.platform === 'win32' ? `${name}.cmd` : name);
|
|
55
|
+
return fs.existsSync(bin) ? bin : null;
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
function usesPrettier(root) {
|
|
59
|
+
if (PRETTIER_CONFIGS.some((n) => fs.existsSync(path.join(root, n)))) return true;
|
|
60
|
+
try {
|
|
61
|
+
return Boolean(JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).prettier);
|
|
62
|
+
} catch {
|
|
63
|
+
return false;
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
function makeRunner(deadline) {
|
|
68
|
+
return (bin, args, cwd) => {
|
|
69
|
+
const timeout = Math.min(120000, deadline - Date.now());
|
|
70
|
+
if (timeout <= 1000) return { skipped: true, output: '' };
|
|
71
|
+
const res = spawnSync(bin, args, { cwd, encoding: 'utf8', timeout, shell: process.platform === 'win32', stdio: ['ignore', 'pipe', 'pipe'] });
|
|
72
|
+
return { status: res.status, output: `${res.stdout || ''}${res.stderr || ''}`, error: res.error };
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
function groupBy(files, keyOf) {
|
|
77
|
+
const groups = new Map();
|
|
78
|
+
for (const file of files) {
|
|
79
|
+
const key = keyOf(file);
|
|
80
|
+
if (!key) continue;
|
|
81
|
+
if (!groups.has(key)) groups.set(key, []);
|
|
82
|
+
groups.get(key).push(file);
|
|
83
|
+
}
|
|
84
|
+
return groups;
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
function format(files, cwd, run, report) {
|
|
88
|
+
for (const [root, group] of groupBy(files, (f) => nearest(path.dirname(f), cwd, ['package.json']))) {
|
|
89
|
+
const biome = fs.existsSync(path.join(root, 'biome.json')) || fs.existsSync(path.join(root, 'biome.jsonc'));
|
|
90
|
+
const tool = biome ? localBin(root, 'biome') : usesPrettier(root) ? localBin(root, 'prettier') : null;
|
|
91
|
+
if (!tool) continue;
|
|
92
|
+
const args = biome ? ['format', '--write', ...group] : ['--write', '--log-level', 'warn', ...group];
|
|
93
|
+
const res = run(tool, args, root);
|
|
94
|
+
if (res.error || (res.status && res.status !== 0)) report(`format failed in ${root}:\n${res.output.trim()}`);
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
function typecheck(files, cwd, run, report) {
|
|
99
|
+
const tsFiles = files.filter((f) => TS.test(f));
|
|
100
|
+
for (const [project, group] of groupBy(tsFiles, (f) => nearest(path.dirname(f), cwd, ['tsconfig.json']))) {
|
|
101
|
+
const root = nearest(project, cwd, ['node_modules']) || project;
|
|
102
|
+
const tsc = localBin(root, 'tsc');
|
|
103
|
+
if (!tsc) continue;
|
|
104
|
+
const res = run(tsc, ['--noEmit', '--pretty', 'false', '-p', project], project);
|
|
105
|
+
if (res.skipped || res.status === 0) continue;
|
|
106
|
+
const relevant = res.output.split('\n').filter((line) => group.some((f) => line.includes(path.relative(project, f))));
|
|
107
|
+
if (relevant.length) report(`type errors in edited files:\n${relevant.slice(0, 30).join('\n')}`);
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
function consoleLogs(files, report) {
|
|
112
|
+
const hits = [];
|
|
113
|
+
for (const file of files) {
|
|
114
|
+
if (CONSOLE_EXEMPT.some((re) => re.test(file))) continue;
|
|
115
|
+
fs.readFileSync(file, 'utf8').split('\n').forEach((line, idx) => {
|
|
116
|
+
if (/\bconsole\.log\s*\(/.test(line) && !/^\s*(\/\/|\*)/.test(line)) hits.push(`${file}:${idx + 1}`);
|
|
117
|
+
});
|
|
118
|
+
}
|
|
119
|
+
if (hits.length) report(`console.log left in edited files:\n${hits.slice(0, 20).join('\n')}`);
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
module.exports = function stopChecks(payload) {
|
|
123
|
+
const cwd = path.resolve(payload.cwd || process.cwd());
|
|
124
|
+
const files = takeEditedFiles(payload.session_id).filter((f) => eligible(f, cwd));
|
|
125
|
+
if (!files.length) return null;
|
|
126
|
+
const report = (msg) => process.stderr.write(`[techne] ${msg}\n`);
|
|
127
|
+
const run = makeRunner(Date.now() + BUDGET_MS);
|
|
128
|
+
for (const step of [() => format(files, cwd, run, report), () => typecheck(files, cwd, run, report), () => consoleLogs(files, report)]) {
|
|
129
|
+
try {
|
|
130
|
+
step();
|
|
131
|
+
} catch (err) {
|
|
132
|
+
report(`stop check error: ${err.message}`);
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
return null;
|
|
136
|
+
};
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: angular
|
|
3
|
+
description: Angular application guidance — standalone components, signals, signal forms, DI, router, SSR/SSG, testing, CLI. Use when scaffolding or changing Angular apps, components, services, routes, forms, or build/test tooling.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
Scope: ship and maintain Angular workspaces with version-aware defaults (signals-first, standalone components, modern control flow). Confirm the project's Angular version from `package.json` before recommending APIs. After codegen, run `ng build` and fix compile errors before stopping. For UI accessibility beyond ARIA primitives, use `ui-design` (`audit`, `harden`). For framework docs, use `biblos` MCP; for repo structure, use `atlas` MCP. Quality gates: `techne:quality` (tests), `exo-qa` / `security-review` / `exo-security` as needed.
|
|
7
|
+
|
|
8
|
+
## Non-negotiable rules
|
|
9
|
+
|
|
10
|
+
1. **CLI over hand-rolling structure** — `ng generate` for components, services, guards; `ng add` (not bare `npm install`) for Angular libraries so schematics update config.
|
|
11
|
+
2. **Standalone by default** — import dependencies in `@Component({ imports: [...] })`; match the repo if it still uses `NgModule`.
|
|
12
|
+
3. **Signals for new state** — prefer `signal` / `computed`; expose `asReadonly()` from services; never sync two signals with `effect()` — use `computed` or `linkedSignal`.
|
|
13
|
+
4. **Modern templates** — `@if`, `@for` (mandatory `track`), `@switch`; no `$parent` in nested `@for` — capture outer index with `let outerIdx = $index`.
|
|
14
|
+
5. **Signal I/O** — prefer `input()` / `output()` / `model()` over `@Input` / `@Output` / `EventEmitter`.
|
|
15
|
+
6. **Forms** — on supported versions, default new forms to signal forms (`@angular/forms/signals`); never seed fields with `null`/`undefined` (use `''`, `0`, `[]`); call fields before flags: `form.email().valid()` not `form.email.valid()`.
|
|
16
|
+
7. **DI** — use `inject()` in injection contexts only; elsewhere `runInInjectionContext`; services as `@Injectable({ providedIn: 'root' })` unless a scoped instance is required.
|
|
17
|
+
8. **Routing** — functional guards/resolvers; lazy-load feature areas; client guards are not authorization — enforce on the server.
|
|
18
|
+
9. **Change detection** — prefer `ChangeDetectionStrategy.OnPush`; read signals before `await` inside reactive contexts.
|
|
19
|
+
10. **Styling** — Tailwind v4 via `@import 'tailwindcss'` and PostCSS plugin; do not add legacy v3 `@tailwind` layers or default `tailwind.config.js` unless the project already uses them.
|
|
20
|
+
11. **Testing** — Act → `await fixture.whenStable()` → assert; router tests via `RouterTestingHarness`, not mocked `Router`; prefer harness APIs over brittle DOM selectors.
|
|
21
|
+
12. **Project creation** — explicit version → `npx @angular/cli@<ver> new …`; else `ng version` success → `ng new …`; else `npx @angular/cli@latest new …`.
|
|
22
|
+
|
|
23
|
+
## References
|
|
24
|
+
|
|
25
|
+
| File | Load when |
|
|
26
|
+
|------|-----------|
|
|
27
|
+
| [reference/components-and-templates.md](reference/components-and-templates.md) | Components, control flow, inputs/outputs, host bindings |
|
|
28
|
+
| [reference/signals-and-state.md](reference/signals-and-state.md) | Signals, `linkedSignal`, `resource`, effects, async reactivity |
|
|
29
|
+
| [reference/forms.md](reference/forms.md) | Signal, reactive, or template-driven forms |
|
|
30
|
+
| [reference/dependency-injection.md](reference/dependency-injection.md) | Services, providers, injectors, tokens |
|
|
31
|
+
| [reference/routing.md](reference/routing.md) | Routes, guards, resolvers, outlets, SSR/rendering |
|
|
32
|
+
| [reference/styling-motion-a11y.md](reference/styling-motion-a11y.md) | CSS encapsulation, Tailwind, motion, `@angular/aria` |
|
|
33
|
+
| [reference/testing.md](reference/testing.md) | Unit, harness, router, E2E |
|
|
34
|
+
| [reference/tooling.md](reference/tooling.md) | CLI workflows, proxy, Angular CLI MCP server |
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# Components and templates
|
|
2
|
+
|
|
3
|
+
## Definition
|
|
4
|
+
|
|
5
|
+
`@Component` binds selector, template (inline or `templateUrl`), styles, and `imports` for standalone usage.
|
|
6
|
+
|
|
7
|
+
```ts
|
|
8
|
+
@Component({
|
|
9
|
+
selector: 'app-profile',
|
|
10
|
+
imports: [CommonModule],
|
|
11
|
+
template: `@if (visible()) { <button (click)="save()">Save</button> }`,
|
|
12
|
+
styles: `:host { display: block; }`,
|
|
13
|
+
})
|
|
14
|
+
export class Profile {
|
|
15
|
+
visible = signal(true);
|
|
16
|
+
save() { /* persist */ }
|
|
17
|
+
}
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
Match project naming (suffix or not). Default since recent majors: standalone without declaring `standalone: true`.
|
|
21
|
+
|
|
22
|
+
## Control flow
|
|
23
|
+
|
|
24
|
+
- **`@if` / `@else if` / `@else`** — conditionals; `as` alias: `@if (user(); as u) { … }`.
|
|
25
|
+
- **`@for`** — requires `track`; locals: `$index`, `$count`, `$first`, `$last`, `$even`, `$odd`; `@empty` for empty collections.
|
|
26
|
+
- **`@switch`** — strict `===`, no fallthrough; `@default never` for exhaustive unions.
|
|
27
|
+
|
|
28
|
+
Nested loops: capture outer index — `$parent` does not exist.
|
|
29
|
+
|
|
30
|
+
## Inputs and outputs
|
|
31
|
+
|
|
32
|
+
```ts
|
|
33
|
+
export class UserRow {
|
|
34
|
+
name = input('Guest');
|
|
35
|
+
userId = input.required<string>();
|
|
36
|
+
disabled = input(false, { transform: booleanAttribute });
|
|
37
|
+
picked = output<number>();
|
|
38
|
+
selection = model<string>(); // two-way [(selection)]
|
|
39
|
+
}
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
Prefer `input()` / `output()` / `model()` over decorators. Output names: camelCase, no `on` prefix; avoid DOM event name collisions.
|
|
43
|
+
|
|
44
|
+
## Host element
|
|
45
|
+
|
|
46
|
+
Prefer `host: { … }` in metadata over `@HostBinding` / `@HostListener`.
|
|
47
|
+
|
|
48
|
+
```ts
|
|
49
|
+
@Component({
|
|
50
|
+
selector: 'app-slider',
|
|
51
|
+
host: {
|
|
52
|
+
role: 'slider',
|
|
53
|
+
'[attr.aria-valuenow]': 'value()',
|
|
54
|
+
'[class.active]': 'active()',
|
|
55
|
+
'(keydown)': 'onKey($event)',
|
|
56
|
+
},
|
|
57
|
+
})
|
|
58
|
+
export class Slider { /* … */ }
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
Static attributes: `inject(new HostAttributeToken('type'))` (optional variant available).
|
|
62
|
+
|
|
63
|
+
Binding precedence: consumer static wins over component static; dynamic vs dynamic favors component host binding.
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
# Dependency injection
|
|
2
|
+
|
|
3
|
+
## Services
|
|
4
|
+
|
|
5
|
+
```ts
|
|
6
|
+
@Injectable({ providedIn: 'root' })
|
|
7
|
+
export class AuditLog {
|
|
8
|
+
private http = inject(HttpClient);
|
|
9
|
+
record(event: string) { /* … */ }
|
|
10
|
+
}
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
`providedIn: 'root'` → app singleton + tree-shaking when unused. Component-scoped: `@Component({ providers: [LocalState] })`.
|
|
14
|
+
|
|
15
|
+
## inject()
|
|
16
|
+
|
|
17
|
+
Valid in: field initializers and constructors of DI-created classes, functional guards/resolvers/interceptors, provider factories.
|
|
18
|
+
|
|
19
|
+
Invalid in ordinary methods — use `runInInjectionContext(injector, () => inject(Token))` or pass dependencies in.
|
|
20
|
+
|
|
21
|
+
Utilities: `assertInInjectionContext(fn)` for shared helpers.
|
|
22
|
+
|
|
23
|
+
## Providers
|
|
24
|
+
|
|
25
|
+
| Pattern | Use |
|
|
26
|
+
|---------|-----|
|
|
27
|
+
| `useClass` | Swap implementation |
|
|
28
|
+
| `useValue` | Config constants |
|
|
29
|
+
| `useFactory` | Dynamic construction (`inject()` inside factory) |
|
|
30
|
+
| `useExisting` | Alias token |
|
|
31
|
+
| `multi: true` | Interceptors, multi-plugins |
|
|
32
|
+
|
|
33
|
+
`InjectionToken<T>` for non-class values; can use `providedIn: 'root'` + factory.
|
|
34
|
+
|
|
35
|
+
Libraries: export `provideFeature(config): Provider[]`.
|
|
36
|
+
|
|
37
|
+
## Hierarchy
|
|
38
|
+
|
|
39
|
+
Resolution: walk **ElementInjector** up from host, then **EnvironmentInjector**. Modifiers: `optional`, `self`, `skipSelf`, `host`.
|
|
40
|
+
|
|
41
|
+
`providers` — visible to component, view, and projected content.
|
|
42
|
+
`viewProviders` — component + view only (not projected content).
|
|
43
|
+
|
|
44
|
+
Route-level `providers` scope services to a feature branch.
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
# Forms
|
|
2
|
+
|
|
3
|
+
## Choose an API
|
|
4
|
+
|
|
5
|
+
| Situation | API |
|
|
6
|
+
|-----------|-----|
|
|
7
|
+
| New app on version with signal forms | `@angular/forms/signals` |
|
|
8
|
+
| Legacy codebase | Match existing (reactive or template) |
|
|
9
|
+
| Simple two-way template | Template-driven + `FormsModule` |
|
|
10
|
+
| Complex dynamic trees | Reactive `FormGroup`/`FormArray` or signal forms |
|
|
11
|
+
|
|
12
|
+
## Signal forms essentials
|
|
13
|
+
|
|
14
|
+
Model is a `signal` with concrete defaults (`''`, `0`, `[]`) — never `null`/`undefined` field values.
|
|
15
|
+
|
|
16
|
+
```ts
|
|
17
|
+
import { form, FormField, submit, required, email } from '@angular/forms/signals';
|
|
18
|
+
|
|
19
|
+
model = signal({ email: '', age: 0 });
|
|
20
|
+
profileForm = form(this.model, (p) => {
|
|
21
|
+
required(p.email, { message: 'Required' });
|
|
22
|
+
email(p.email);
|
|
23
|
+
});
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
Template: `[formField]="profileForm.email"`. Flags: **call** the field — `profileForm.email().invalid()`, root `profileForm().invalid()`.
|
|
27
|
+
|
|
28
|
+
Schema rules: `disabled`, `hidden`, `readonly`, `debounce`, `validate`, `validateAsync`, `applyWhen`, `applyEach` (single path arg). Context uses `value()`, `state.touched()`, `valueOf(path)`, `stateOf(path)` — paths in schema callbacks are not callable.
|
|
29
|
+
|
|
30
|
+
Do **not** put `min`/`max`/`value`/`disabled`/`readonly` on `[formField]` inputs — encode in schema.
|
|
31
|
+
|
|
32
|
+
Submit: `submit(form, async () => { … })` — callback must be `async`.
|
|
33
|
+
|
|
34
|
+
Async validation: `validateAsync` needs `params: ({ value }) => value()`, `factory`, `onSuccess`, **required** `onError`. Pair with `resource({ params: signal, loader })`.
|
|
35
|
+
|
|
36
|
+
Arrays: mutate model signal; `@for` over `form.items`; length via structural `form.items.length`. Multi-select arrays: `<select multiple>` or checkboxes (boolean only per checkbox).
|
|
37
|
+
|
|
38
|
+
## Reactive forms
|
|
39
|
+
|
|
40
|
+
`ReactiveFormsModule`, `FormBuilder`, `formControlName`, `patchValue` / `setValue`, unified `events` stream (`ValueChangeEvent`, etc.).
|
|
41
|
+
|
|
42
|
+
## Template-driven
|
|
43
|
+
|
|
44
|
+
`FormsModule`, `[(ngModel)]` **requires** `name`, `#f="ngForm"`, validation CSS classes (`ng-valid`, `ng-invalid`, …).
|
|
45
|
+
|
|
46
|
+
## Signal forms pitfall matrix
|
|
47
|
+
|
|
48
|
+
| Mistake | Fix |
|
|
49
|
+
|---------|-----|
|
|
50
|
+
| `field.valid()` | `field().valid()` |
|
|
51
|
+
| `form.invalid()` | `form().invalid()` |
|
|
52
|
+
| `field.set(x)` | Update backing model signal |
|
|
53
|
+
| `form.items().length` | `form.items.length` (structural) |
|
|
54
|
+
| `({ touched }) => …` in validate | `({ state }) => state.touched()` |
|
|
55
|
+
| `applyWhen(p.x, () => p.x() …)` | `valueOf(p.x)` / `stateOf(p.x)` |
|
|
56
|
+
| `pattern(..., { when })` | `when` only on `required()` |
|
|
57
|
+
| `submit(form, () => …)` | `async` callback required |
|
|
58
|
+
| `validateAsync` without `onError` | always supply `onError` |
|
|
59
|
+
| `resource({ request: sig })` | use `params: sig` |
|
|
60
|
+
| `applyEach(..., (item, i) => …)` | single `(item) =>` arg |
|
|
61
|
+
| Checkbox on `string[]` field | checkboxes bind `boolean` only |
|
|
62
|
+
| `[readonly]` on input with `[formField]` | `readonly()` in schema |
|
|
63
|
+
|
|
64
|
+
## Custom validators
|
|
65
|
+
|
|
66
|
+
Synchronous `validate(path, ({ value, valueOf, state }) => …)` returns `{ kind, message? }` or `undefined`. Do not return `null`.
|
|
67
|
+
|
|
68
|
+
Conditional blocks: `applyWhen(path, predicate, (subPath) => { required(subPath.x); })` — three arguments.
|
|
69
|
+
|
|
70
|
+
HTTP-backed rules: `validateHttp` / `validateStandardSchema` when integrating external schema libraries (check version docs via `biblos` MCP).
|
|
71
|
+
|
|
72
|
+
## End-to-end sketch
|
|
73
|
+
|
|
74
|
+
```ts
|
|
75
|
+
@Component({ imports: [FormField], template: `
|
|
76
|
+
<form (submit)="save(); $event.preventDefault()">
|
|
77
|
+
<input [formField]="f.contact.email" />
|
|
78
|
+
@if (f.contact.email().touched() && f.contact.email().errors().length) {
|
|
79
|
+
<span>{{ f.contact.email().errors()[0].message }}</span>
|
|
80
|
+
}
|
|
81
|
+
<button [disabled]="f().invalid() || f().pending()">Send</button>
|
|
82
|
+
</form>` })
|
|
83
|
+
export class ContactPage {
|
|
84
|
+
model = signal({ contact: { email: '' } });
|
|
85
|
+
f = form(this.model, (p) => {
|
|
86
|
+
required(p.contact.email);
|
|
87
|
+
email(p.contact.email);
|
|
88
|
+
});
|
|
89
|
+
save() {
|
|
90
|
+
submit(this.f, async () => {
|
|
91
|
+
await this.api.post('/contacts', this.model());
|
|
92
|
+
});
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
Dynamic rows: push into `model` array; `applyEach` on collection path; template `@for (row of f.items; track $index)` with `[formField]="row.label"`.
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
# Routing and rendering
|
|
2
|
+
|
|
3
|
+
## Configuration
|
|
4
|
+
|
|
5
|
+
```ts
|
|
6
|
+
export const routes: Routes = [
|
|
7
|
+
{ path: '', component: Home },
|
|
8
|
+
{ path: 'admin', canActivate: [authGuard], loadComponent: () => import('./admin/admin') },
|
|
9
|
+
{ path: '**', component: NotFound },
|
|
10
|
+
];
|
|
11
|
+
|
|
12
|
+
bootstrapApplication(App, { providers: [provideRouter(routes, withComponentInputBinding())] });
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Order matters (first match). Params: `:id`. Redirects: `redirectTo`. Titles: `title` or `TitleStrategy`. Child routes need parent `<router-outlet />`.
|
|
16
|
+
|
|
17
|
+
Lazy: `loadComponent` / `loadChildren`. Loaders run in route injection context — `inject(FeatureFlags)` allowed.
|
|
18
|
+
|
|
19
|
+
## Navigation
|
|
20
|
+
|
|
21
|
+
Declarative: `RouterLink`, `routerLinkActive`. Programmatic: `Router.navigate([...], { queryParams, relativeTo })` or `navigateByUrl(string, { replaceUrl })`.
|
|
22
|
+
|
|
23
|
+
## Guards and resolvers
|
|
24
|
+
|
|
25
|
+
Functional guards return `boolean | UrlTree | Observable/Promise thereof`. Types: `canActivate`, `canActivateChild`, `canDeactivate`, `canMatch`.
|
|
26
|
+
|
|
27
|
+
```ts
|
|
28
|
+
export const authGuard: CanActivateFn = () =>
|
|
29
|
+
inject(AuthService).isSignedIn() ? true : inject(Router).parseUrl('/login');
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
Resolvers (`ResolveFn`) prefetch before activation; failures block navigation — handle with `catchError` or global `withNavigationErrorHandler`. Resolved data: route `data` signal or `withComponentInputBinding()` → `input()`.
|
|
33
|
+
|
|
34
|
+
## Outlets
|
|
35
|
+
|
|
36
|
+
Primary `<router-outlet />`; named outlets `{ outlet: 'sidebar' }`. Events: `activate`, `deactivate`. Pass data: `[routerOutletData]` → `inject(ROUTER_OUTLET_DATA)`.
|
|
37
|
+
|
|
38
|
+
## Lifecycle events
|
|
39
|
+
|
|
40
|
+
Subscribe to `Router.events` — `NavigationStart`, `GuardsCheck*`, `Resolve*`, `NavigationEnd`, `NavigationCancel`, `NavigationError`. Debug: `withDebugTracing()`. View transitions: `withViewTransitions()` + global CSS on `::view-transition-old/new(root)`.
|
|
41
|
+
|
|
42
|
+
## Rendering modes
|
|
43
|
+
|
|
44
|
+
| Need | Mode |
|
|
45
|
+
|------|------|
|
|
46
|
+
| SEO + static | SSG / prerender |
|
|
47
|
+
| SEO + dynamic | SSR + hydration |
|
|
48
|
+
| Internal tools | CSR default |
|
|
49
|
+
|
|
50
|
+
Hydration: full vs incremental (`@defer`); event replay for early clicks.
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
# Signals and reactive state
|
|
2
|
+
|
|
3
|
+
## Writable and derived
|
|
4
|
+
|
|
5
|
+
```ts
|
|
6
|
+
const count = signal(0);
|
|
7
|
+
count.set(3);
|
|
8
|
+
count.update((n) => n + 1);
|
|
9
|
+
|
|
10
|
+
const doubled = computed(() => count() * 2);
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Services: private writable + public `asReadonly()`.
|
|
14
|
+
|
|
15
|
+
## Reactive contexts
|
|
16
|
+
|
|
17
|
+
Reads inside `computed`, `effect`, templates, and `linkedSignal` establish dependencies. Use `untracked(other)` when a read must not subscribe.
|
|
18
|
+
|
|
19
|
+
**Async rule:** read signals before `await`; post-await reads are not tracked.
|
|
20
|
+
|
|
21
|
+
## linkedSignal
|
|
22
|
+
|
|
23
|
+
Writable state reset from a source, with optional manual override.
|
|
24
|
+
|
|
25
|
+
```ts
|
|
26
|
+
selected = linkedSignal(() => this.options()[0]);
|
|
27
|
+
|
|
28
|
+
selected = linkedSignal({
|
|
29
|
+
source: this.options,
|
|
30
|
+
computation: (next, prev) =>
|
|
31
|
+
next.find((o) => o.id === prev?.value.id) ?? next[0],
|
|
32
|
+
});
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Use for user-overridable defaults — not `effect()` + `.set()`.
|
|
36
|
+
|
|
37
|
+
## resource (experimental)
|
|
38
|
+
|
|
39
|
+
Async loader tied to reactive `params`:
|
|
40
|
+
|
|
41
|
+
```ts
|
|
42
|
+
userRes = resource({
|
|
43
|
+
params: () => ({ id: this.userId() }),
|
|
44
|
+
loader: async ({ params, abortSignal }) => {
|
|
45
|
+
const res = await fetch(`/api/users/${params.id}`, { signal: abortSignal });
|
|
46
|
+
return res.json();
|
|
47
|
+
},
|
|
48
|
+
});
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
Status: `value()`, `hasValue()`, `isLoading()`, `error()`, `status()`. Imperative refresh: `.reload()`. HTTP stack: prefer `httpResource` when using `HttpClient`.
|
|
52
|
+
|
|
53
|
+
## Effects
|
|
54
|
+
|
|
55
|
+
For imperative side effects (analytics, `localStorage`, canvas/chart libs). **Not** for mirroring state between signals.
|
|
56
|
+
|
|
57
|
+
Create in injection context (constructor/field init). Cleanup via `onCleanup` callback.
|
|
58
|
+
|
|
59
|
+
DOM after paint: `afterRenderEffect` with phased `earlyRead` / `write` / `read` — no DOM reads in `write`. Skips SSR.
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
# Styling, motion, accessibility primitives
|
|
2
|
+
|
|
3
|
+
## Component styles
|
|
4
|
+
|
|
5
|
+
Inline `styles` / `styleUrl`. Encapsulation: `Emulated` (default), `ShadowDom`, `None`. Selectors: `:host`, `:host-context(.theme-dark)`. Avoid `::ng-deep`.
|
|
6
|
+
|
|
7
|
+
## Tailwind v4 (default for new setup)
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
ng add tailwindcss
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Manual: install `tailwindcss`, `@tailwindcss/postcss`, `postcss`; `.postcssrc.json` with `@tailwindcss/postcss`; global `src/styles.css`:
|
|
14
|
+
|
|
15
|
+
```css
|
|
16
|
+
@import 'tailwindcss';
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
Do not default to v3 `@tailwind base/components/utilities` or a generated `tailwind.config.js` unless the repo already uses them.
|
|
20
|
+
|
|
21
|
+
## Motion
|
|
22
|
+
|
|
23
|
+
Check Angular version in `package.json`. **v20.2+:** prefer `animate.enter` / `animate.leave` with CSS keyframes; call `event.animationComplete()` when using custom `(animate.leave)` handlers.
|
|
24
|
+
|
|
25
|
+
Legacy `@angular/animations` DSL only when already entrenched — do not mix with native animate directives in one component. Bootstrap legacy: `provideAnimationsAsync()`.
|
|
26
|
+
|
|
27
|
+
Route transitions: browser View Transitions API via router `withViewTransitions()`.
|
|
28
|
+
|
|
29
|
+
## @angular/aria (headless)
|
|
30
|
+
|
|
31
|
+
Install when missing: `ng add` / package install for `@angular/aria`. Directives manage keyboard, ARIA, focus — **you supply markup and CSS**.
|
|
32
|
+
|
|
33
|
+
Style via `[aria-expanded]`, `[aria-selected]`, `[aria-pressed]`, `:focus-visible`. Patterns: accordion, listbox, combobox/select, menu/menubar, tabs, toolbar, tree, grid.
|
|
34
|
+
|
|
35
|
+
Rules:
|
|
36
|
+
|
|
37
|
+
- Use `ng*` directives instead of native `<select>` when implementing these patterns.
|
|
38
|
+
- Lazy panels: `ng-template` + `ngAccordionContent` / `ngTabContent`.
|
|
39
|
+
- Full product a11y audits: `ui-design` skill, not this file alone.
|
|
40
|
+
|
|
41
|
+
## Aria pattern quick map
|
|
42
|
+
|
|
43
|
+
| Pattern | Directives (import from `@angular/aria/...`) | Notes |
|
|
44
|
+
|---------|-----------------------------------------------|-------|
|
|
45
|
+
| Accordion | `ngAccordionGroup`, `ngAccordionTrigger`, `ngAccordionPanel`, `ngAccordionContent` | `[multiExpandable]`; lazy content in `ng-template` |
|
|
46
|
+
| Listbox | `ngListbox`, `ngOption` | Visible list; not a native `<select>` |
|
|
47
|
+
| Combobox / Select | `ngCombobox`, `ngComboboxInput`, `ngComboboxPopupContainer` + listbox | Autocomplete vs readonly select |
|
|
48
|
+
| Menu / Menubar | `ngMenuBar`, `ngMenu`, `ngMenuItem`, `ngMenuTrigger` | Actions, not form values |
|
|
49
|
+
| Tabs | `ngTabs`, `ngTabList`, `ngTab`, `ngTabPanel`, `ngTabContent` | ≤ ~7 tabs for usability |
|
|
50
|
+
| Toolbar | `ngToolbar`, `ngToolbarWidget`, `ngToolbarWidgetGroup` | `[multi]` groups for toggles |
|
|
51
|
+
| Tree | `ngTree`, `ngTreeItem`, `ngTreeGroup` | Expand via `[aria-expanded]` styling |
|
|
52
|
+
| Grid | `ngGrid`, `ngGridRow`, `ngGridCell`, `ngGridCellWidget` | Roving focus / selection |
|
|
53
|
+
|
|
54
|
+
Install package before first use. Agent supplies semantic HTML + CSS; directives manage focus and ARIA state.
|