adevkit 0.1.0__py3-none-any.whl
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.
- adevkit-0.1.0.dist-info/METADATA +171 -0
- adevkit-0.1.0.dist-info/RECORD +731 -0
- adevkit-0.1.0.dist-info/WHEEL +5 -0
- adevkit-0.1.0.dist-info/entry_points.txt +3 -0
- adevkit-0.1.0.dist-info/top_level.txt +1 -0
- devkit/__init__.py +4 -0
- devkit/cli.py +442 -0
- devkit/config.py +21 -0
- devkit/prompts.py +197 -0
- devkit/scaffold/__init__.py +16 -0
- devkit/scaffold/agents_md.py +152 -0
- devkit/scaffold/env_setup.py +59 -0
- devkit/scaffold/git_setup.py +69 -0
- devkit/scaffold/prd_md.py +85 -0
- devkit/scaffold/vscode_setup.py +38 -0
- devkit/skills/__init__.py +10 -0
- devkit/skills/catalog.py +156 -0
- devkit/skills/embedded/SKILL.md +52 -0
- devkit/skills/embedded/animate/RECIPES.md +324 -0
- devkit/skills/embedded/animate/SKILL.md +207 -0
- devkit/skills/embedded/animate-expo/RECIPES.md +385 -0
- devkit/skills/embedded/animate-expo/SKILL.md +263 -0
- devkit/skills/embedded/animation-performance/SKILL.md +222 -0
- devkit/skills/embedded/animation-vocabulary/SKILL.md +181 -0
- devkit/skills/embedded/apple-design/SKILL.md +290 -0
- devkit/skills/embedded/ask-sonner/API.md +64 -0
- devkit/skills/embedded/ask-sonner/SKILL.md +88 -0
- devkit/skills/embedded/banner-design/SKILL.md +145 -0
- devkit/skills/embedded/banner-design/references/banner-sizes-and-styles.md +118 -0
- devkit/skills/embedded/brand/SKILL.md +108 -0
- devkit/skills/embedded/brand/references/approval-checklist.md +169 -0
- devkit/skills/embedded/brand/references/asset-organization.md +157 -0
- devkit/skills/embedded/brand/references/brand-guideline-template.md +140 -0
- devkit/skills/embedded/brand/references/color-palette-management.md +186 -0
- devkit/skills/embedded/brand/references/consistency-checklist.md +94 -0
- devkit/skills/embedded/brand/references/logo-usage-rules.md +185 -0
- devkit/skills/embedded/brand/references/messaging-framework.md +85 -0
- devkit/skills/embedded/brand/references/typography-specifications.md +214 -0
- devkit/skills/embedded/brand/references/update.md +129 -0
- devkit/skills/embedded/brand/references/visual-identity.md +96 -0
- devkit/skills/embedded/brand/references/voice-framework.md +88 -0
- devkit/skills/embedded/brand/scripts/extract-colors.cjs +337 -0
- devkit/skills/embedded/brand/scripts/inject-brand-context.cjs +349 -0
- devkit/skills/embedded/brand/scripts/sync-brand-to-tokens.cjs +415 -0
- devkit/skills/embedded/brand/scripts/tests/test_sync_brand_to_tokens.py +368 -0
- devkit/skills/embedded/brand/scripts/validate-asset.cjs +387 -0
- devkit/skills/embedded/brand/templates/brand-guidelines-starter.md +275 -0
- devkit/skills/embedded/break-ui/CATALOG.md +135 -0
- devkit/skills/embedded/break-ui/SKILL.md +175 -0
- devkit/skills/embedded/chrome-devtools/SKILL.md +74 -0
- devkit/skills/embedded/deploy-to-vercel/Archive.zip +0 -0
- devkit/skills/embedded/deploy-to-vercel/SKILL.md +296 -0
- devkit/skills/embedded/deploy-to-vercel/resources/deploy-codex.sh +301 -0
- devkit/skills/embedded/deploy-to-vercel/resources/deploy.sh +301 -0
- devkit/skills/embedded/design/SKILL.md +333 -0
- devkit/skills/embedded/design/data/cip/deliverables.csv +51 -0
- devkit/skills/embedded/design/data/cip/industries.csv +21 -0
- devkit/skills/embedded/design/data/cip/mockup-contexts.csv +21 -0
- devkit/skills/embedded/design/data/cip/styles.csv +21 -0
- devkit/skills/embedded/design/data/icon/styles.csv +16 -0
- devkit/skills/embedded/design/data/logo/colors.csv +56 -0
- devkit/skills/embedded/design/data/logo/industries.csv +56 -0
- devkit/skills/embedded/design/data/logo/styles.csv +56 -0
- devkit/skills/embedded/design/references/banner-sizes-and-styles.md +118 -0
- devkit/skills/embedded/design/references/cip-deliverable-guide.md +95 -0
- devkit/skills/embedded/design/references/cip-design.md +123 -0
- devkit/skills/embedded/design/references/cip-prompt-engineering.md +84 -0
- devkit/skills/embedded/design/references/cip-style-guide.md +68 -0
- devkit/skills/embedded/design/references/design-routing.md +207 -0
- devkit/skills/embedded/design/references/icon-design.md +122 -0
- devkit/skills/embedded/design/references/logo-color-psychology.md +101 -0
- devkit/skills/embedded/design/references/logo-design.md +110 -0
- devkit/skills/embedded/design/references/logo-prompt-engineering.md +158 -0
- devkit/skills/embedded/design/references/logo-style-guide.md +109 -0
- devkit/skills/embedded/design/references/slides-copywriting-formulas.md +84 -0
- devkit/skills/embedded/design/references/slides-create.md +4 -0
- devkit/skills/embedded/design/references/slides-html-template.md +295 -0
- devkit/skills/embedded/design/references/slides-layout-patterns.md +137 -0
- devkit/skills/embedded/design/references/slides-strategies.md +94 -0
- devkit/skills/embedded/design/references/slides.md +42 -0
- devkit/skills/embedded/design/references/social-photos-design.md +329 -0
- devkit/skills/embedded/design/scripts/cip/core.py +215 -0
- devkit/skills/embedded/design/scripts/cip/generate.py +504 -0
- devkit/skills/embedded/design/scripts/cip/render-html.py +424 -0
- devkit/skills/embedded/design/scripts/cip/search.py +127 -0
- devkit/skills/embedded/design/scripts/icon/generate.py +535 -0
- devkit/skills/embedded/design/scripts/logo/core.py +175 -0
- devkit/skills/embedded/design/scripts/logo/generate.py +812 -0
- devkit/skills/embedded/design/scripts/logo/search.py +114 -0
- devkit/skills/embedded/design/scripts/logo/tests/test_generate.py +454 -0
- devkit/skills/embedded/design/scripts/tests/test_cip_generate.py +134 -0
- devkit/skills/embedded/design/scripts/tests/test_icon_generate.py +178 -0
- devkit/skills/embedded/design-system/SKILL.md +248 -0
- devkit/skills/embedded/design-system/data/slide-backgrounds.csv +11 -0
- devkit/skills/embedded/design-system/data/slide-charts.csv +26 -0
- devkit/skills/embedded/design-system/data/slide-color-logic.csv +14 -0
- devkit/skills/embedded/design-system/data/slide-copy.csv +26 -0
- devkit/skills/embedded/design-system/data/slide-layout-logic.csv +16 -0
- devkit/skills/embedded/design-system/data/slide-layouts.csv +26 -0
- devkit/skills/embedded/design-system/data/slide-strategies.csv +16 -0
- devkit/skills/embedded/design-system/data/slide-typography.csv +15 -0
- devkit/skills/embedded/design-system/references/component-specs.md +236 -0
- devkit/skills/embedded/design-system/references/component-tokens.md +214 -0
- devkit/skills/embedded/design-system/references/primitive-tokens.md +203 -0
- devkit/skills/embedded/design-system/references/semantic-tokens.md +215 -0
- devkit/skills/embedded/design-system/references/states-and-variants.md +241 -0
- devkit/skills/embedded/design-system/references/tailwind-integration.md +251 -0
- devkit/skills/embedded/design-system/references/token-architecture.md +224 -0
- devkit/skills/embedded/design-system/scripts/embed-tokens.cjs +103 -0
- devkit/skills/embedded/design-system/scripts/fetch-background.py +339 -0
- devkit/skills/embedded/design-system/scripts/generate-slide.py +770 -0
- devkit/skills/embedded/design-system/scripts/generate-tokens.cjs +205 -0
- devkit/skills/embedded/design-system/scripts/html-token-validator.py +359 -0
- devkit/skills/embedded/design-system/scripts/search-slides.py +228 -0
- devkit/skills/embedded/design-system/scripts/slide-token-validator.py +35 -0
- devkit/skills/embedded/design-system/scripts/slide_search_core.py +453 -0
- devkit/skills/embedded/design-system/scripts/tests/test_validate_tokens.py +52 -0
- devkit/skills/embedded/design-system/scripts/validate-tokens.cjs +246 -0
- devkit/skills/embedded/design-system/templates/design-tokens-starter.json +143 -0
- devkit/skills/embedded/design-taste-frontend/README.md +81 -0
- devkit/skills/embedded/design-taste-frontend/SKILL.md +542 -0
- devkit/skills/embedded/design-taste-frontend/assets/app.css +216 -0
- devkit/skills/embedded/design-taste-frontend/assets/base.css +105 -0
- devkit/skills/embedded/design-taste-frontend/assets/base.js +37 -0
- devkit/skills/embedded/design-taste-frontend/assets/charts.js +619 -0
- devkit/skills/embedded/design-taste-frontend/assets/scenes/stage.css +28 -0
- devkit/skills/embedded/design-taste-frontend/assets/scenes/stage.js +134 -0
- devkit/skills/embedded/design-taste-frontend/evals/evals.json +76 -0
- devkit/skills/embedded/design-taste-frontend/library/app.json +1327 -0
- devkit/skills/embedded/design-taste-frontend/library/directions.json +1078 -0
- devkit/skills/embedded/design-taste-frontend/library/heroes.json +1086 -0
- devkit/skills/embedded/design-taste-frontend/library/motions.json +92 -0
- devkit/skills/embedded/design-taste-frontend/library/palettes.json +1485 -0
- devkit/skills/embedded/design-taste-frontend/library/photos.json +7240 -0
- devkit/skills/embedded/design-taste-frontend/library/sections.json +4429 -0
- devkit/skills/embedded/design-taste-frontend/library/sites.json +8350 -0
- devkit/skills/embedded/design-taste-frontend/library/type.json +2024 -0
- devkit/skills/embedded/design-taste-frontend/references/app-screens.md +1199 -0
- devkit/skills/embedded/design-taste-frontend/references/colour.md +141 -0
- devkit/skills/embedded/design-taste-frontend/references/copy.md +177 -0
- devkit/skills/embedded/design-taste-frontend/references/critique.md +182 -0
- devkit/skills/embedded/design-taste-frontend/references/imagery.md +791 -0
- devkit/skills/embedded/design-taste-frontend/references/layout.md +292 -0
- devkit/skills/embedded/design-taste-frontend/references/motion.md +980 -0
- devkit/skills/embedded/design-taste-frontend/references/research.md +356 -0
- devkit/skills/embedded/design-taste-frontend/references/scenes.md +174 -0
- devkit/skills/embedded/design-taste-frontend/references/tells.md +115 -0
- devkit/skills/embedded/design-taste-frontend/references/type.md +170 -0
- devkit/skills/embedded/design-taste-frontend/scripts/assets.mjs +865 -0
- devkit/skills/embedded/design-taste-frontend/scripts/draw.mjs +584 -0
- devkit/skills/embedded/design-taste-frontend/scripts/inspect.mjs +308 -0
- devkit/skills/embedded/design-taste-frontend/scripts/lib/app-draw.mjs +203 -0
- devkit/skills/embedded/design-taste-frontend/scripts/lib/cdp.mjs +248 -0
- devkit/skills/embedded/design-taste-frontend/scripts/lib/inspection-files.mjs +9 -0
- devkit/skills/embedded/design-taste-frontend/scripts/lib/probe.mjs +929 -0
- devkit/skills/embedded/design-taste-frontend/scripts/lib/rules.mjs +243 -0
- devkit/skills/embedded/design-taste-frontend/scripts/lint.mjs +119 -0
- devkit/skills/embedded/design-taste-frontend/scripts/scenes.mjs +124 -0
- devkit/skills/embedded/emil-design-eng/SKILL.md +674 -0
- devkit/skills/embedded/find-animation-opportunities/SKILL.md +140 -0
- devkit/skills/embedded/gemini-api-dev/SKILL.md +458 -0
- devkit/skills/embedded/gemini-api-dev/references/migration.md +180 -0
- devkit/skills/embedded/impeccable/SKILL.md +86 -0
- devkit/skills/embedded/impeccable/agents/impeccable_asset_producer.toml +47 -0
- devkit/skills/embedded/impeccable/agents/impeccable_documenter.toml +27 -0
- devkit/skills/embedded/impeccable/agents/impeccable_finish_reviewer.toml +41 -0
- devkit/skills/embedded/impeccable/agents/impeccable_manual_edit_applier.toml +95 -0
- devkit/skills/embedded/impeccable/agents/openai.yaml +4 -0
- devkit/skills/embedded/impeccable/reference/adapt.md +318 -0
- devkit/skills/embedded/impeccable/reference/adapt.native.md +58 -0
- devkit/skills/embedded/impeccable/reference/android.md +46 -0
- devkit/skills/embedded/impeccable/reference/animate.md +89 -0
- devkit/skills/embedded/impeccable/reference/audit.md +139 -0
- devkit/skills/embedded/impeccable/reference/audit.native.md +139 -0
- devkit/skills/embedded/impeccable/reference/bolder.md +33 -0
- devkit/skills/embedded/impeccable/reference/clarify.md +94 -0
- devkit/skills/embedded/impeccable/reference/colorize.md +86 -0
- devkit/skills/embedded/impeccable/reference/component-review.md +63 -0
- devkit/skills/embedded/impeccable/reference/craft-floor.md +50 -0
- devkit/skills/embedded/impeccable/reference/craft.md +5 -0
- devkit/skills/embedded/impeccable/reference/critique.md +841 -0
- devkit/skills/embedded/impeccable/reference/degraded/asset-producer.md +44 -0
- devkit/skills/embedded/impeccable/reference/degraded/documenter.md +24 -0
- devkit/skills/embedded/impeccable/reference/degraded/finish-reviewer.md +38 -0
- devkit/skills/embedded/impeccable/reference/degraded/manual-edit-applier.md +92 -0
- devkit/skills/embedded/impeccable/reference/delight.md +70 -0
- devkit/skills/embedded/impeccable/reference/distill.md +111 -0
- devkit/skills/embedded/impeccable/reference/doctor.md +54 -0
- devkit/skills/embedded/impeccable/reference/document.md +416 -0
- devkit/skills/embedded/impeccable/reference/extract.md +69 -0
- devkit/skills/embedded/impeccable/reference/generate.md +101 -0
- devkit/skills/embedded/impeccable/reference/harden.md +362 -0
- devkit/skills/embedded/impeccable/reference/hooks.md +113 -0
- devkit/skills/embedded/impeccable/reference/init.md +131 -0
- devkit/skills/embedded/impeccable/reference/ios.md +51 -0
- devkit/skills/embedded/impeccable/reference/layout.md +84 -0
- devkit/skills/embedded/impeccable/reference/live-setup.md +104 -0
- devkit/skills/embedded/impeccable/reference/live.md +327 -0
- devkit/skills/embedded/impeccable/reference/mode-operate.md +21 -0
- devkit/skills/embedded/impeccable/reference/mode-persuade.md +19 -0
- devkit/skills/embedded/impeccable/reference/mode-read.md +21 -0
- devkit/skills/embedded/impeccable/reference/new-work.md +152 -0
- devkit/skills/embedded/impeccable/reference/onboard.md +234 -0
- devkit/skills/embedded/impeccable/reference/operate.md +61 -0
- devkit/skills/embedded/impeccable/reference/optimize.md +257 -0
- devkit/skills/embedded/impeccable/reference/overdrive.md +127 -0
- devkit/skills/embedded/impeccable/reference/polish.md +105 -0
- devkit/skills/embedded/impeccable/reference/quieter.md +99 -0
- devkit/skills/embedded/impeccable/reference/region-map.md +26 -0
- devkit/skills/embedded/impeccable/reference/routing.md +24 -0
- devkit/skills/embedded/impeccable/reference/shape.md +59 -0
- devkit/skills/embedded/impeccable/reference/typeset.md +90 -0
- devkit/skills/embedded/impeccable/reference/visualize.md +47 -0
- devkit/skills/embedded/impeccable/scripts/VERSION +1 -0
- devkit/skills/embedded/impeccable/scripts/command-metadata.json +98 -0
- devkit/skills/embedded/impeccable/scripts/data/font-index-failures.json +121 -0
- devkit/skills/embedded/impeccable/scripts/data/font-index.json +1 -0
- devkit/skills/embedded/impeccable/scripts/impeccable +213 -0
- devkit/skills/embedded/impeccable/scripts/impeccable.cmd +239 -0
- devkit/skills/embedded/impeccable/scripts/live-browser-dom.js +320 -0
- devkit/skills/embedded/impeccable/scripts/live-browser-ignores.js +246 -0
- devkit/skills/embedded/impeccable/scripts/live-browser-session.js +183 -0
- devkit/skills/embedded/impeccable/scripts/live-browser.js +13645 -0
- devkit/skills/embedded/impeccable/scripts/modern-screenshot.umd.js +14 -0
- devkit/skills/embedded/improve-animations/AUDIT.md +115 -0
- devkit/skills/embedded/improve-animations/PLAN-TEMPLATE.md +73 -0
- devkit/skills/embedded/improve-animations/SKILL.md +109 -0
- devkit/skills/embedded/mobile-native/SKILL.md +311 -0
- devkit/skills/embedded/modern-web-guidance/SKILL.md +135 -0
- devkit/skills/embedded/pick-ui-library/SKILL.md +85 -0
- devkit/skills/embedded/ponytail/SKILL.md +52 -0
- devkit/skills/embedded/ponytail-audit/SKILL.md +103 -0
- devkit/skills/embedded/ponytail-debt/SKILL.md +44 -0
- devkit/skills/embedded/ponytail-gain/SKILL.md +52 -0
- devkit/skills/embedded/ponytail-help/SKILL.md +76 -0
- devkit/skills/embedded/ponytail-review/SKILL.md +101 -0
- devkit/skills/embedded/prototype/PICKER.md +197 -0
- devkit/skills/embedded/prototype/SKILL.md +98 -0
- devkit/skills/embedded/review-animations/SKILL.md +120 -0
- devkit/skills/embedded/review-animations/STANDARDS.md +187 -0
- devkit/skills/embedded/skills-lock.json +239 -0
- devkit/skills/embedded/slides/SKILL.md +44 -0
- devkit/skills/embedded/slides/references/copywriting-formulas.md +84 -0
- devkit/skills/embedded/slides/references/create.md +4 -0
- devkit/skills/embedded/slides/references/html-template.md +295 -0
- devkit/skills/embedded/slides/references/layout-patterns.md +137 -0
- devkit/skills/embedded/slides/references/slide-strategies.md +94 -0
- devkit/skills/embedded/ui-styling/LICENSE.txt +202 -0
- devkit/skills/embedded/ui-styling/SKILL.md +336 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/ArsenalSC-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/ArsenalSC-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/BigShoulders-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/BigShoulders-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/BigShoulders-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Boldonse-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Boldonse-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/BricolageGrotesque-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/BricolageGrotesque-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/BricolageGrotesque-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/CrimsonPro-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/CrimsonPro-Italic.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/CrimsonPro-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/CrimsonPro-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/DMMono-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/DMMono-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/EricaOne-OFL.txt +94 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/EricaOne-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/GeistMono-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/GeistMono-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/GeistMono-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Gloock-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Gloock-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexMono-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexMono-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexMono-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexSerif-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexSerif-BoldItalic.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexSerif-Italic.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/IBMPlexSerif-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSans-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSans-BoldItalic.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSans-Italic.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSans-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSans-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSerif-Italic.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/InstrumentSerif-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Italiana-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Italiana-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/JetBrainsMono-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/JetBrainsMono-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/JetBrainsMono-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Jura-Light.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Jura-Medium.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Jura-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/LibreBaskerville-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/LibreBaskerville-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Lora-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Lora-BoldItalic.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Lora-Italic.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Lora-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Lora-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/NationalPark-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/NationalPark-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/NationalPark-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/NothingYouCouldDo-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/NothingYouCouldDo-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Outfit-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Outfit-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Outfit-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/PixelifySans-Medium.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/PixelifySans-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/PoiretOne-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/PoiretOne-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/RedHatMono-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/RedHatMono-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/RedHatMono-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Silkscreen-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Silkscreen-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/SmoochSans-Medium.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/SmoochSans-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Tektur-Medium.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Tektur-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/Tektur-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/WorkSans-Bold.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/WorkSans-BoldItalic.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/WorkSans-Italic.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/WorkSans-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/WorkSans-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/YoungSerif-OFL.txt +93 -0
- devkit/skills/embedded/ui-styling/canvas-fonts/YoungSerif-Regular.ttf +0 -0
- devkit/skills/embedded/ui-styling/references/canvas-design-system.md +320 -0
- devkit/skills/embedded/ui-styling/references/shadcn-accessibility.md +471 -0
- devkit/skills/embedded/ui-styling/references/shadcn-components.md +424 -0
- devkit/skills/embedded/ui-styling/references/shadcn-theming.md +373 -0
- devkit/skills/embedded/ui-styling/references/tailwind-customization.md +483 -0
- devkit/skills/embedded/ui-styling/references/tailwind-responsive.md +382 -0
- devkit/skills/embedded/ui-styling/references/tailwind-utilities.md +455 -0
- devkit/skills/embedded/ui-styling/scripts/.coverage +0 -0
- devkit/skills/embedded/ui-styling/scripts/requirements.txt +17 -0
- devkit/skills/embedded/ui-styling/scripts/shadcn_add.py +308 -0
- devkit/skills/embedded/ui-styling/scripts/tailwind_config_gen.py +508 -0
- devkit/skills/embedded/ui-styling/scripts/tests/coverage-ui.json +1 -0
- devkit/skills/embedded/ui-styling/scripts/tests/requirements.txt +3 -0
- devkit/skills/embedded/ui-styling/scripts/tests/test_shadcn_add.py +266 -0
- devkit/skills/embedded/ui-styling/scripts/tests/test_tailwind_config_gen.py +508 -0
- devkit/skills/embedded/ui-ux-pro-max/SKILL.md +214 -0
- devkit/skills/embedded/ui-ux-pro-max/data/app-interface.csv +33 -0
- devkit/skills/embedded/ui-ux-pro-max/data/catalog-summary.json +78 -0
- devkit/skills/embedded/ui-ux-pro-max/data/charts.csv +26 -0
- devkit/skills/embedded/ui-ux-pro-max/data/colors.csv +193 -0
- devkit/skills/embedded/ui-ux-pro-max/data/data-provenance.json +1348 -0
- devkit/skills/embedded/ui-ux-pro-max/data/google-font-licenses.json +20185 -0
- devkit/skills/embedded/ui-ux-pro-max/data/google-fonts.csv +1935 -0
- devkit/skills/embedded/ui-ux-pro-max/data/icons.csv +106 -0
- devkit/skills/embedded/ui-ux-pro-max/data/landing.csv +35 -0
- devkit/skills/embedded/ui-ux-pro-max/data/motion.csv +18 -0
- devkit/skills/embedded/ui-ux-pro-max/data/phosphor-icons-upstream.json +32582 -0
- devkit/skills/embedded/ui-ux-pro-max/data/products.csv +193 -0
- devkit/skills/embedded/ui-ux-pro-max/data/react-performance.csv +45 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/angular.csv +51 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/astro.csv +54 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/avalonia.csv +57 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/html-tailwind.csv +60 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/javafx.csv +76 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/laravel.csv +51 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/nextjs.csv +62 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/nuxt-ui.csv +77 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/nuxtjs.csv +68 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/react.csv +67 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/shadcn.csv +69 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/svelte.csv +56 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/threejs.csv +54 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/uno.csv +60 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/uwp.csv +56 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/vue.csv +50 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/winui.csv +60 -0
- devkit/skills/embedded/ui-ux-pro-max/data/stacks/wpf.csv +57 -0
- devkit/skills/embedded/ui-ux-pro-max/data/styles.csv +89 -0
- devkit/skills/embedded/ui-ux-pro-max/data/typography.csv +75 -0
- devkit/skills/embedded/ui-ux-pro-max/data/ui-reasoning.csv +193 -0
- devkit/skills/embedded/ui-ux-pro-max/data/ux-guidelines.csv +120 -0
- devkit/skills/embedded/ui-ux-pro-max/references/pro-rules.md +117 -0
- devkit/skills/embedded/ui-ux-pro-max/references/quick-reference.md +256 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/core.py +993 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/design_system.py +1668 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/reasoning_contract.py +123 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/search.py +177 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-api.json +36 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-catalog.json +33 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-existing.csv +3 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-metadata.json +17 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-overrides.json +7 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/icons-curated.csv +4 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-core.json +23 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-package.json +13 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-react-exports.json +4 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-react-package.json +5 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/relevance-baseline.json +3366 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/relevance-cases.json +111 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/fixtures/relevance-thresholds.json +100 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_catalog_refresh.py +354 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_catalog_summary_line_endings.py +78 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_core.py +343 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_core_data_quality.py +198 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_data_contracts.py +421 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_design_system_mode.py +233 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_design_system_stack.py +61 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_native_desktop_stack_freshness.py +179 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_relevance_evaluator.py +182 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_skill_script_paths.py +82 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_style_taxonomy.py +175 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_text_layout_resilience.py +120 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/tests/test_web_stack_freshness.py +177 -0
- devkit/skills/embedded/ui-ux-pro-max/scripts/validate_data.py +1095 -0
- devkit/skills/embedded/vercel-cli-with-tokens/SKILL.md +353 -0
- devkit/skills/embedded/vercel-composition-patterns/AGENTS.md +946 -0
- devkit/skills/embedded/vercel-composition-patterns/README.md +60 -0
- devkit/skills/embedded/vercel-composition-patterns/SKILL.md +89 -0
- devkit/skills/embedded/vercel-composition-patterns/rules/_sections.md +29 -0
- devkit/skills/embedded/vercel-composition-patterns/rules/_template.md +24 -0
- devkit/skills/embedded/vercel-composition-patterns/rules/architecture-avoid-boolean-props.md +100 -0
- devkit/skills/embedded/vercel-composition-patterns/rules/architecture-compound-components.md +112 -0
- devkit/skills/embedded/vercel-composition-patterns/rules/patterns-children-over-render-props.md +87 -0
- devkit/skills/embedded/vercel-composition-patterns/rules/patterns-explicit-variants.md +100 -0
- devkit/skills/embedded/vercel-composition-patterns/rules/react19-no-forwardref.md +42 -0
- devkit/skills/embedded/vercel-composition-patterns/rules/state-context-interface.md +191 -0
- devkit/skills/embedded/vercel-composition-patterns/rules/state-decouple-implementation.md +113 -0
- devkit/skills/embedded/vercel-composition-patterns/rules/state-lift-state.md +125 -0
- devkit/skills/embedded/vercel-optimize/AGENTS.md +48 -0
- devkit/skills/embedded/vercel-optimize/CONTRIBUTING.md +41 -0
- devkit/skills/embedded/vercel-optimize/README.md +91 -0
- devkit/skills/embedded/vercel-optimize/SKILL.md +322 -0
- devkit/skills/embedded/vercel-optimize/lib/auth-route.mjs +23 -0
- devkit/skills/embedded/vercel-optimize/lib/budget-summary.mjs +182 -0
- devkit/skills/embedded/vercel-optimize/lib/citations.mjs +139 -0
- devkit/skills/embedded/vercel-optimize/lib/cost-coverage.mjs +143 -0
- devkit/skills/embedded/vercel-optimize/lib/dedup-recs.mjs +325 -0
- devkit/skills/embedded/vercel-optimize/lib/deep-dive.mjs +350 -0
- devkit/skills/embedded/vercel-optimize/lib/display-labels.mjs +185 -0
- devkit/skills/embedded/vercel-optimize/lib/extract-claims.mjs +550 -0
- devkit/skills/embedded/vercel-optimize/lib/framework-support.mjs +67 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/build-minutes-fanout.mjs +69 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/cold-start.mjs +66 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/contract.mjs +79 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/cwv-poor.mjs +87 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/external-api-slow.mjs +55 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/hard-gates.mjs +73 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/index.mjs +45 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/isr-overrevalidation.mjs +62 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/middleware-heavy.mjs +51 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/observability-events-attribution.mjs +56 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/platform-bot-protection.mjs +115 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/platform-fluid-compute.mjs +83 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/region-misconfig.mjs +64 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/route-errors.mjs +80 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/scanner-driven.mjs +122 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/select-candidates.mjs +134 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/slow-route.mjs +88 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/types.d.ts +38 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/uncached-route.mjs +93 -0
- devkit/skills/embedded/vercel-optimize/lib/gates/usage-spike-triage.mjs +121 -0
- devkit/skills/embedded/vercel-optimize/lib/grade-recommendation.mjs +155 -0
- devkit/skills/embedded/vercel-optimize/lib/impact-label.mjs +126 -0
- devkit/skills/embedded/vercel-optimize/lib/impact-magnitude.mjs +60 -0
- devkit/skills/embedded/vercel-optimize/lib/investigation-brief.mjs +610 -0
- devkit/skills/embedded/vercel-optimize/lib/observation-safety.mjs +174 -0
- devkit/skills/embedded/vercel-optimize/lib/project-facts.mjs +99 -0
- devkit/skills/embedded/vercel-optimize/lib/queries.mjs +315 -0
- devkit/skills/embedded/vercel-optimize/lib/reconcile-candidates.mjs +372 -0
- devkit/skills/embedded/vercel-optimize/lib/render-report.mjs +955 -0
- devkit/skills/embedded/vercel-optimize/lib/repo-root.mjs +86 -0
- devkit/skills/embedded/vercel-optimize/lib/route-normalize.mjs +220 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/bot-protection-certainty.mjs +38 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/cache-tag-invalidation-certainty.mjs +30 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/count-correct.mjs +52 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/function-duration-invocations.mjs +38 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/index.mjs +79 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/middleware-conflict.mjs +36 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/missing-citation.mjs +16 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/pre-release.mjs +74 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/rate-limit.mjs +67 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/rendering-mode-mislabel.mjs +38 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/undeclared-dep.mjs +78 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/vercel-directive-strip.mjs +37 -0
- devkit/skills/embedded/vercel-optimize/lib/sanitizers/window-units.mjs +32 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/cache-components-suspense-dedupe.mjs +109 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/edge-heavy-import.mjs +94 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/force-dynamic.mjs +42 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/headers-in-page.mjs +44 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/index.mjs +35 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/large-static-asset.mjs +92 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/max-age-without-s-maxage.mjs +42 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/middleware-broad-matcher.mjs +55 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/missing-cache-headers.mjs +90 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/prisma-include-tree.mjs +42 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/region-pin-in-config.mjs +88 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/source-maps-production.mjs +36 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/sveltekit-prerender-missing.mjs +43 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/turbo-force-bypass.mjs +129 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/unoptimized-image.mjs +113 -0
- devkit/skills/embedded/vercel-optimize/lib/scanners/use-cache-date-stamp.mjs +106 -0
- devkit/skills/embedded/vercel-optimize/lib/support-topics.mjs +355 -0
- devkit/skills/embedded/vercel-optimize/lib/throttle.mjs +273 -0
- devkit/skills/embedded/vercel-optimize/lib/util.mjs +17 -0
- devkit/skills/embedded/vercel-optimize/lib/vercel.mjs +864 -0
- devkit/skills/embedded/vercel-optimize/lib/verify-claim.mjs +1296 -0
- devkit/skills/embedded/vercel-optimize/lib/workspace-resolver.mjs +521 -0
- devkit/skills/embedded/vercel-optimize/references/candidates.md +176 -0
- devkit/skills/embedded/vercel-optimize/references/data-collection.md +218 -0
- devkit/skills/embedded/vercel-optimize/references/docs-library.json +683 -0
- devkit/skills/embedded/vercel-optimize/references/doctrine.md +105 -0
- devkit/skills/embedded/vercel-optimize/references/observability-plus.md +108 -0
- devkit/skills/embedded/vercel-optimize/references/playbooks/README.md +53 -0
- devkit/skills/embedded/vercel-optimize/references/playbooks/ai-application.md +32 -0
- devkit/skills/embedded/vercel-optimize/references/playbooks/api-service.md +30 -0
- devkit/skills/embedded/vercel-optimize/references/playbooks/content-site.md +30 -0
- devkit/skills/embedded/vercel-optimize/references/playbooks/ecommerce.md +30 -0
- devkit/skills/embedded/vercel-optimize/references/playbooks/marketing.md +30 -0
- devkit/skills/embedded/vercel-optimize/references/playbooks/saas.md +31 -0
- devkit/skills/embedded/vercel-optimize/references/playbooks/sveltekit.md +75 -0
- devkit/skills/embedded/vercel-optimize/references/recommendations.md +203 -0
- devkit/skills/embedded/vercel-optimize/references/scanner-patterns.md +251 -0
- devkit/skills/embedded/vercel-optimize/references/scoring.md +205 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/README.md +46 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/astro-edge-middleware-scope.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/astro-output-mode-and-isr.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/auth-preserving-parallelization.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/bot-protection-product-guardrails.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/build-minutes-monorepo-fanout.md +23 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/cache-components-static-shell-boundaries.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/cache-components-suspense-dedupe-pitfall.md +23 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/cdn-cache-auth-safety.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/cold-start-initialization-bundle.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/core-web-vitals-client-bottlenecks.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/database-egress-pooling-region.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/dynamic-rendering-traps.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/external-api-critical-path-platform.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/external-api-critical-path.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/fast-data-transfer-payloads.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/fluid-compute-caveats.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/function-duration-io-and-after.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/function-invocation-reduction.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/function-region-misconfiguration-ttfb.md +23 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/image-optimization-cost-control.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/isr-revalidation-static-generation.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/middleware-proxy-edge-cost.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/next-fetch-revalidate-floor.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/next-font-cls-self-hosting.md +23 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/next-heavy-ui-lazy-load-boundaries.md +23 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/next-image-lcp-preload-sizes.md +23 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/next-route-handler-get-cache-defaults.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/next-script-third-party-strategy.md +23 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/nextjs-version-cache-semantics.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/not-found-catchall-request-waste.md +23 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/nuxt-route-rules-cache-isr.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/observability-events-cost-attribution.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/post-response-work-waituntil.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/route-error-durable-offload.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/route-error-runtime-limits.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/runtime-cache-reusable-data.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/sveltekit-isr-prerender-safety.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/sveltekit-split-cold-start-tradeoff.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/usage-spike-triage.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/use-cache-date-stamp-isr-write-amplifier.md +23 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/use-cache-remote-shared-origin-data.md +22 -0
- devkit/skills/embedded/vercel-optimize/references/support-topics/workflow-resumable-stream-routes.md +23 -0
- devkit/skills/embedded/vercel-optimize/references/verification.md +102 -0
- devkit/skills/embedded/vercel-optimize/references/voice.md +76 -0
- devkit/skills/embedded/vercel-optimize/scripts/budget-summary.mjs +56 -0
- devkit/skills/embedded/vercel-optimize/scripts/build-docs.mjs +74 -0
- devkit/skills/embedded/vercel-optimize/scripts/check-citations.mjs +81 -0
- devkit/skills/embedded/vercel-optimize/scripts/check-docs-fresh.mjs +93 -0
- devkit/skills/embedded/vercel-optimize/scripts/collect-signals.mjs +576 -0
- devkit/skills/embedded/vercel-optimize/scripts/collect-sub-agent-outputs.mjs +296 -0
- devkit/skills/embedded/vercel-optimize/scripts/deep-dive.mjs +319 -0
- devkit/skills/embedded/vercel-optimize/scripts/gate-investigations.mjs +166 -0
- devkit/skills/embedded/vercel-optimize/scripts/merge-signals.mjs +192 -0
- devkit/skills/embedded/vercel-optimize/scripts/prepare-investigation-brief.mjs +231 -0
- devkit/skills/embedded/vercel-optimize/scripts/reconcile-candidates.mjs +62 -0
- devkit/skills/embedded/vercel-optimize/scripts/render-report.mjs +437 -0
- devkit/skills/embedded/vercel-optimize/scripts/scan-codebase.mjs +313 -0
- devkit/skills/embedded/vercel-optimize/scripts/verify-and-regen.mjs +346 -0
- devkit/skills/embedded/vercel-optimize/scripts/verify-finding.mjs +19 -0
- devkit/skills/embedded/vercel-react-best-practices/AGENTS.md +3810 -0
- devkit/skills/embedded/vercel-react-best-practices/README.md +123 -0
- devkit/skills/embedded/vercel-react-best-practices/SKILL.md +149 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/_sections.md +46 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/_template.md +28 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/advanced-effect-event-deps.md +56 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/advanced-event-handler-refs.md +55 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/advanced-init-once.md +42 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/advanced-use-latest.md +39 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/async-api-routes.md +38 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/async-defer-await.md +82 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/async-dependencies.md +51 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/async-parallel.md +28 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/async-suspense-boundaries.md +99 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/bundle-analyzable-paths.md +63 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/bundle-barrel-imports.md +60 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/bundle-conditional.md +31 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/bundle-defer-third-party.md +49 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/bundle-dynamic-imports.md +35 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/bundle-preload.md +50 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/client-event-listeners.md +74 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/client-localstorage-schema.md +71 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/client-passive-event-listeners.md +48 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/client-swr-dedup.md +56 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-batch-dom-css.md +107 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-cache-function-results.md +80 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-cache-property-access.md +28 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-cache-storage.md +70 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-combine-iterations.md +32 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-early-exit.md +50 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-flatmap-filter.md +60 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-hoist-regexp.md +45 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-index-maps.md +37 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-length-check-first.md +49 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-min-max-loop.md +82 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-request-idle-callback.md +105 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-set-map-lookups.md +24 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/js-tosorted-immutable.md +57 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-activity.md +26 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-conditional-render.md +40 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-content-visibility.md +38 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-hoist-jsx.md +46 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-resource-hints.md +85 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-script-defer-async.md +68 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-svg-precision.md +28 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rendering-usetransition-loading.md +75 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-defer-reads.md +39 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-dependencies.md +45 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-derived-state.md +29 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-functional-setstate.md +74 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-lazy-state-init.md +58 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-memo.md +44 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-no-inline-components.md +82 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-transitions.md +40 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-use-deferred-value.md +59 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/server-after-nonblocking.md +73 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/server-auth-actions.md +96 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/server-cache-lru.md +41 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/server-cache-react.md +76 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/server-dedup-props.md +65 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/server-hoist-static-io.md +149 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/server-no-shared-module-state.md +50 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/server-parallel-fetching.md +83 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
- devkit/skills/embedded/vercel-react-best-practices/rules/server-serialization.md +38 -0
- devkit/skills/embedded/vercel-react-native-skills/AGENTS.md +2897 -0
- devkit/skills/embedded/vercel-react-native-skills/README.md +165 -0
- devkit/skills/embedded/vercel-react-native-skills/SKILL.md +121 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/_sections.md +86 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/_template.md +28 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/animation-derived-value.md +53 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/animation-gesture-detector-press.md +95 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/animation-gpu-properties.md +65 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/design-system-compound-components.md +66 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/fonts-config-plugin.md +71 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/imports-design-system-folder.md +68 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/js-hoist-intl.md +61 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-callbacks.md +44 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-function-references.md +132 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-images.md +53 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-inline-objects.md +97 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-item-expensive.md +94 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-item-memo.md +82 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-item-types.md +104 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/list-performance-virtualize.md +67 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/monorepo-native-deps-in-app.md +46 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/monorepo-single-dependency-versions.md +63 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/navigation-native-navigators.md +188 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/react-compiler-destructure-functions.md +50 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/react-compiler-reanimated-shared-values.md +48 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/react-state-dispatcher.md +91 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/react-state-fallback.md +56 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/react-state-minimize.md +65 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/rendering-no-falsy-and.md +74 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/rendering-text-in-text-component.md +36 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/scroll-position-no-state.md +82 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/state-ground-truth.md +80 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/ui-expo-image.md +66 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/ui-image-gallery.md +104 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/ui-measure-views.md +78 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/ui-menus.md +174 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/ui-native-modals.md +77 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/ui-pressable.md +61 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/ui-safe-area-scroll.md +65 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/ui-scrollview-content-inset.md +45 -0
- devkit/skills/embedded/vercel-react-native-skills/rules/ui-styling.md +87 -0
- devkit/skills/embedded/vercel-react-view-transitions/AGENTS.md +1380 -0
- devkit/skills/embedded/vercel-react-view-transitions/README.md +44 -0
- devkit/skills/embedded/vercel-react-view-transitions/SKILL.md +332 -0
- devkit/skills/embedded/vercel-react-view-transitions/references/css-recipes.md +312 -0
- devkit/skills/embedded/vercel-react-view-transitions/references/implementation.md +170 -0
- devkit/skills/embedded/vercel-react-view-transitions/references/nextjs.md +233 -0
- devkit/skills/embedded/vercel-react-view-transitions/references/patterns.md +274 -0
- devkit/skills/embedded/vercel-react-view-transitions/references/troubleshooting.md +47 -0
- devkit/skills/embedded/web-design-guidelines/SKILL.md +39 -0
- devkit/skills/embedded/write-swift/SKILL.md +396 -0
- devkit/skills/embedded/writing-guidelines/SKILL.md +39 -0
- devkit/skills/installer.py +110 -0
- devkit/templates/__init__.py +76 -0
- devkit/templates/ai_agents_python.py +160 -0
- devkit/templates/base.py +37 -0
- devkit/templates/content_site.py +117 -0
- devkit/templates/custom.py +129 -0
- devkit/templates/design_system.py +167 -0
- devkit/templates/expo_fullstack.py +278 -0
- devkit/templates/expo_mobile.py +127 -0
- devkit/templates/minimal_agentic.py +34 -0
- devkit/templates/nextjs.py +219 -0
- devkit/templates/python_fastapi.py +125 -0
- devkit/templates/saas_fullstack.py +212 -0
- devkit/templates/vite_react.py +176 -0
- devkit/ui.py +61 -0
- devkit/utils/__init__.py +15 -0
- devkit/utils/system.py +48 -0
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ponytail-audit
|
|
3
|
+
description: >
|
|
4
|
+
Quality audit of a whole repo: bugs, security holes, what breaks under real
|
|
5
|
+
load, risky code without tests, slow paths, and what to delete, merge or
|
|
6
|
+
split. Ranked, each finding explained in plain English. One-shot report,
|
|
7
|
+
changes nothing. Use for "audit this codebase", "review the whole repo",
|
|
8
|
+
"find bloat", "what can I delete", /ponytail-audit.
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
Audit the whole repo like the senior developer who just inherited it and
|
|
12
|
+
will be paged when it breaks. Order of importance: correct, safe, holds under
|
|
13
|
+
load, tested, fast, lean. Lean still matters: every extra line must be read,
|
|
14
|
+
tested and fixed later. This is a report the user asked for, so give it in full.
|
|
15
|
+
|
|
16
|
+
## 1. Map first
|
|
17
|
+
|
|
18
|
+
- Audit what the user names: a folder, a package, or the whole repo.
|
|
19
|
+
Nothing named: the whole repo.
|
|
20
|
+
- Read the README, the deploy and build config, the dependency list, the
|
|
21
|
+
entry points (main, routes, handlers, jobs, CLI commands) and the tests.
|
|
22
|
+
- Find the expected load: one person running a script, or many users and
|
|
23
|
+
processes at once. Judge scale against that, and say which load you assumed.
|
|
24
|
+
- Trace the main flows end to end: where data comes in, what is stored,
|
|
25
|
+
what goes out. Read those paths fully: input from users, money, auth,
|
|
26
|
+
data writes, background jobs, anything shared between processes.
|
|
27
|
+
- Big repo: go deep where a mistake costs the most, not file by file. Say
|
|
28
|
+
which parts you did not read.
|
|
29
|
+
|
|
30
|
+
## 2. Look for
|
|
31
|
+
|
|
32
|
+
1. **Bug:** wrong result, crash, missed edge case (empty, zero, last item,
|
|
33
|
+
rounding, time zones), callers that disagree with what a function returns,
|
|
34
|
+
the same rule applied differently in two places.
|
|
35
|
+
2. **Risk:** security holes (injection, weak randomness, secrets in code,
|
|
36
|
+
missing checks on input from users), data loss (errors swallowed, writes
|
|
37
|
+
in the wrong order, no transaction).
|
|
38
|
+
3. **Scale:** fine for one user, wrong for many: check-then-write races, the
|
|
39
|
+
same work done by every process, memory or lists that only grow, a query
|
|
40
|
+
per item, O(n^2) on big input, per-process state that must be shared.
|
|
41
|
+
4. **Missing test:** risky logic (a branch, a parser, money, security, data
|
|
42
|
+
writes) with no test that fails when it breaks. One good test, not coverage.
|
|
43
|
+
5. **Speed:** big slowdowns are problems. Small wins (work repeated in a hot
|
|
44
|
+
loop) are suggestions; some software counts every millisecond.
|
|
45
|
+
6. **Lean:** code that should not exist or should be smaller.
|
|
46
|
+
- delete: dead code, unused options, flags and config, speculative features
|
|
47
|
+
- reuse: two helpers doing the same thing (keep one, name the path)
|
|
48
|
+
- stdlib / native: the standard library or platform already does it;
|
|
49
|
+
a dependency doing what a few lines or the platform can do
|
|
50
|
+
- yagni: interface with one implementation, factory with one product,
|
|
51
|
+
wrapper that only passes calls through
|
|
52
|
+
- merge: near-copies that must change together
|
|
53
|
+
- split: one function or class doing several unrelated jobs, so it is
|
|
54
|
+
hard to read or test. Split by job, never by line count, and never into
|
|
55
|
+
helpers that exist only to make a function shorter.
|
|
56
|
+
|
|
57
|
+
## 3. Check before you report
|
|
58
|
+
|
|
59
|
+
- Every finding needs a concrete case: "this input or situation leads to this
|
|
60
|
+
wrong result". No case, no finding.
|
|
61
|
+
- Before calling code unused, grep the whole tree for it, including tests,
|
|
62
|
+
fixtures, config, and string or dynamic references.
|
|
63
|
+
- A shortcut marked with a `shortcut:` (or older `ponytail:`) comment that names its limit is a
|
|
64
|
+
decision, not a finding, unless the expected load already crosses it.
|
|
65
|
+
- Propose the smallest fix that works. Prefer fixes that delete code. Never
|
|
66
|
+
add layers, frameworks or config the problem does not need.
|
|
67
|
+
- No style taste, no "consider", no vague worries.
|
|
68
|
+
|
|
69
|
+
## 4. Output
|
|
70
|
+
|
|
71
|
+
Very simple English: short sentences, everyday words. Explain a technical
|
|
72
|
+
term the first time you use it. The reader may never have seen this code.
|
|
73
|
+
|
|
74
|
+
Start with `What this repo does:` in two or three sentences, and the load
|
|
75
|
+
you assumed.
|
|
76
|
+
|
|
77
|
+
Then the findings in three groups, most important first, skip empty groups:
|
|
78
|
+
- **Must fix:** bug, security, data loss, breaks at the expected load.
|
|
79
|
+
- **Should fix:** risky code without a test, real slowness, duplication, a
|
|
80
|
+
function that mixes jobs, code that should not exist.
|
|
81
|
+
- **Nice to have:** small speed-ups, shorter forms.
|
|
82
|
+
|
|
83
|
+
Number findings across all groups, so the user can say "fix 2 and 5". At
|
|
84
|
+
most 20 findings; if you left smaller ones out, say how many.
|
|
85
|
+
Every finding has all four parts, each one or two short sentences:
|
|
86
|
+
|
|
87
|
+
2. **Orders land on the wrong day** (`billing/close_day.py:L40-52`)
|
|
88
|
+
- **What this is:** At midnight this job closes the day and bills all orders of that day.
|
|
89
|
+
- **Problem:** It takes "today" from the server clock, which runs in UTC. An order placed
|
|
90
|
+
at 00:30 in Berlin is billed on the day before.
|
|
91
|
+
- **Fix:** Compute the day once in the shop's time zone:
|
|
92
|
+
`datetime.now(ZoneInfo("Europe/Berlin")).date()`. One line, nothing else changes.
|
|
93
|
+
- **If we skip it:** Late orders show the wrong date, and accounting fixes them by hand.
|
|
94
|
+
|
|
95
|
+
End with:
|
|
96
|
+
- `Verdict:` one line: healthy, or what to fix first.
|
|
97
|
+
- `Lean: -<N> lines, -<M> dependencies possible.` when lean findings exist.
|
|
98
|
+
- `Not checked:` the parts you did not read or could not run.
|
|
99
|
+
|
|
100
|
+
Nothing found: `What this repo does:`, then `Healthy. Nothing to fix.` and
|
|
101
|
+
one line on what you checked.
|
|
102
|
+
|
|
103
|
+
One-shot report, changes no code.
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ponytail-debt
|
|
3
|
+
description: >
|
|
4
|
+
List every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report,
|
|
5
|
+
changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the
|
|
6
|
+
shortcuts", /ponytail-debt.
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
Every deliberate ponytail shortcut is marked with a `shortcut:` comment naming
|
|
10
|
+
its ceiling and upgrade path (older code may say `ponytail:`). This collects them into one ledger so a deferral
|
|
11
|
+
can't quietly become permanent.
|
|
12
|
+
|
|
13
|
+
## Scan
|
|
14
|
+
|
|
15
|
+
Grep the repo for comment markers, skipping `.git` and everything the
|
|
16
|
+
`.gitignore` files ignore (dependencies, build output, caches, in any stack):
|
|
17
|
+
|
|
18
|
+
`git grep --no-index --exclude-standard -nE '(#|//|/[*]) ?(shortcut|ponytail):'` (add other comment prefixes if your stack uses them)
|
|
19
|
+
|
|
20
|
+
If the user names their own marker word (`/ponytail-debt TODO`), grep for that word instead.
|
|
21
|
+
|
|
22
|
+
Each hit is one ledger row. The comment prefix keeps prose that merely mentions
|
|
23
|
+
the convention out of the ledger. Skip hits that are not a deferral, like a note
|
|
24
|
+
about a keyboard shortcut.
|
|
25
|
+
|
|
26
|
+
## Output
|
|
27
|
+
|
|
28
|
+
One row per marker, grouped by file:
|
|
29
|
+
|
|
30
|
+
`<file>:<line>, <what was simplified>. ceiling: <the limit named>. upgrade: <the trigger to revisit>.`
|
|
31
|
+
|
|
32
|
+
The convention is `shortcut: <ceiling>, <upgrade path>`, so pull the ceiling
|
|
33
|
+
and the trigger straight from the comment. Want an owner per row too? add
|
|
34
|
+
`git blame -L<line>,<line>`.
|
|
35
|
+
|
|
36
|
+
Flag the rot risk: any marker comment that names no upgrade path or
|
|
37
|
+
trigger gets a `no-trigger` tag, those are the ones that silently rot.
|
|
38
|
+
|
|
39
|
+
End with `<N> markers, <M> with no trigger.` Nothing found: `No shortcut debt. Clean ledger.`
|
|
40
|
+
|
|
41
|
+
## Boundaries
|
|
42
|
+
|
|
43
|
+
Reads and reports only, changes nothing. To persist it, ask and it writes the
|
|
44
|
+
ledger to a file (e.g. `PONYTAIL-DEBT.md`). One-shot.
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ponytail-gain
|
|
3
|
+
description: >
|
|
4
|
+
Show ponytail's measured savings (code, cost, speed) from the benchmark.
|
|
5
|
+
One-shot display. Use for /ponytail-gain, "what does ponytail save",
|
|
6
|
+
"ponytail impact".
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Ponytail Gain
|
|
10
|
+
|
|
11
|
+
Display this scoreboard when invoked. One-shot: do NOT change mode, write flag
|
|
12
|
+
files, or persist anything.
|
|
13
|
+
|
|
14
|
+
The figures are the published agentic benchmark of Ponytail 5: headless Claude
|
|
15
|
+
Code (Opus 5.5, default effort) on 39 tasks (feature tickets in a real FastAPI +
|
|
16
|
+
React repo, bug fixes, security and privacy cases, small apps), 5 runs each,
|
|
17
|
+
against the same agent without the skill. 18 of the tasks have hidden checks
|
|
18
|
+
for correctness and safety. Each figure is the geometric mean of the per-task
|
|
19
|
+
medians. They are measured, not computed from the current repo.
|
|
20
|
+
Source: `benchmarks/results/2026-10-07-agentic.md` and the README.
|
|
21
|
+
|
|
22
|
+
## Scoreboard
|
|
23
|
+
|
|
24
|
+
Render plain ASCII bars. The bar length shows ponytail as a share of the
|
|
25
|
+
no-skill baseline; the label carries the exact figure:
|
|
26
|
+
|
|
27
|
+
```
|
|
28
|
+
ponytail gain benchmark · 39 tasks × 5 runs · Opus 5.5
|
|
29
|
+
|
|
30
|
+
no-skill ████████████████████ 100%
|
|
31
|
+
Lines of code █████████··········· 47% ▼ 53%
|
|
32
|
+
Output tokens ███████████········· 55% ▼ 45%
|
|
33
|
+
Cost ███████████████····· 74% ▼ 26%
|
|
34
|
+
Time ████████████········ 59% ▼ 41%
|
|
35
|
+
Hidden checks passed 97% (no-skill 96%)
|
|
36
|
+
Tests where the logic needs one 98% (no-skill 68%)
|
|
37
|
+
|
|
38
|
+
This repo: /ponytail-debt (shortcuts you deferred)
|
|
39
|
+
/ponytail-audit (what's still cuttable)
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
## Honesty boundary
|
|
43
|
+
|
|
44
|
+
These are benchmark averages, not this repo. NEVER print a per-repo savings
|
|
45
|
+
number ("you saved X lines/tokens here"): the unbuilt version was never
|
|
46
|
+
written, so there is no real baseline to subtract from in a live repo. The
|
|
47
|
+
only real per-repo figures come from `/ponytail-debt` (a counted ledger), and
|
|
48
|
+
this card points there instead of inventing one.
|
|
49
|
+
|
|
50
|
+
## Boundaries
|
|
51
|
+
|
|
52
|
+
One-shot display. Edits nothing, changes no mode.
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ponytail-help
|
|
3
|
+
description: >
|
|
4
|
+
Quick reference for ponytail levels, skills and commands. One-shot display.
|
|
5
|
+
Use for /ponytail-help, "ponytail help", "how do I use ponytail".
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Ponytail Help
|
|
9
|
+
|
|
10
|
+
Display this reference card when invoked. One-shot, do NOT change mode,
|
|
11
|
+
write flag files, or persist anything.
|
|
12
|
+
|
|
13
|
+
## Levels
|
|
14
|
+
|
|
15
|
+
| Level | Trigger | What change |
|
|
16
|
+
|-------|---------|-------------|
|
|
17
|
+
| **Lite** | `/ponytail lite` | Build what was asked, name the smaller option in one line. |
|
|
18
|
+
| **Full** | `/ponytail` | The smallest complete change, a check where the logic needs one, and a reply that names what was skipped and any risk. Default. |
|
|
19
|
+
| **Ultra** | `/ponytail ultra` | Also questions the request and pushes back before building. |
|
|
20
|
+
|
|
21
|
+
Level sticks until changed or session end.
|
|
22
|
+
|
|
23
|
+
## Skills
|
|
24
|
+
|
|
25
|
+
| Skill | Trigger | What it does |
|
|
26
|
+
|-------|---------|--------------|
|
|
27
|
+
| **ponytail** | `/ponytail` | Lazy mode itself: least new code, clear replies that name skipped work and risks. |
|
|
28
|
+
| **ponytail-review** | `/ponytail-review` | Quality review of a diff: bugs, security, load, missing tests, speed, what to cut. Each finding says what goes wrong and how to fix it. |
|
|
29
|
+
| **ponytail-audit** | `/ponytail-audit` | The same quality review for the whole repo, ranked. |
|
|
30
|
+
| **ponytail-debt** | `/ponytail-debt` | Harvest `shortcut:` comments into a tracked ledger. |
|
|
31
|
+
| **ponytail-gain** | `/ponytail-gain` | Measured-impact scoreboard: less code, less cost, more speed. |
|
|
32
|
+
| **ponytail-help** | `/ponytail-help` | This card. |
|
|
33
|
+
|
|
34
|
+
In Codex CLI and the IDE extension, invoke skills with `$ponytail:ponytail`,
|
|
35
|
+
`$ponytail:ponytail-review`, or `$ponytail:ponytail-help`. Claude Code and OpenCode use the
|
|
36
|
+
slash-command forms above (OpenCode ships all six as slash commands).
|
|
37
|
+
|
|
38
|
+
## Deactivate
|
|
39
|
+
|
|
40
|
+
Say "stop ponytail" or "normal mode". Resume anytime with `/ponytail`.
|
|
41
|
+
`/ponytail off` also works.
|
|
42
|
+
|
|
43
|
+
## Band (Claude Code)
|
|
44
|
+
|
|
45
|
+
`/ponytail band` hides the band above the prompt, the same command brings it back.
|
|
46
|
+
`/ponytail band on` and `/ponytail band off` set it directly. The level stays.
|
|
47
|
+
`/ponytail band import` adds your past Claude Code sessions (cost, agent time, tokens) to the board.
|
|
48
|
+
|
|
49
|
+
## Configure Default Mode
|
|
50
|
+
|
|
51
|
+
Default mode = `full`, auto-active every session. Change it:
|
|
52
|
+
|
|
53
|
+
**Environment variable** (highest priority):
|
|
54
|
+
```bash
|
|
55
|
+
export PONYTAIL_DEFAULT_MODE=ultra
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
**Config file** (`~/.config/ponytail/config.json`, Windows: `%APPDATA%\ponytail\config.json`):
|
|
59
|
+
```json
|
|
60
|
+
{ "defaultMode": "lite" }
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
Set `"off"` to disable auto-activation on session start, activate manually
|
|
64
|
+
with `/ponytail` when wanted.
|
|
65
|
+
|
|
66
|
+
Resolution: env var > config file > `full`.
|
|
67
|
+
|
|
68
|
+
## Update
|
|
69
|
+
|
|
70
|
+
Enable auto-update once: open `/plugin`, go to Marketplaces, pick ponytail, Enable auto-update. Claude Code then pulls new versions at startup (run `/reload-plugins` when it prompts). Manual refresh: `/plugin marketplace update ponytail` then `/reload-plugins`.
|
|
71
|
+
|
|
72
|
+
If `/plugin` is not recognized, your Claude Code is out of date. Update it (`npm install -g @anthropic-ai/claude-code@latest`, or `brew upgrade claude-code`) and restart. Other hosts use their own update flow.
|
|
73
|
+
|
|
74
|
+
## More
|
|
75
|
+
|
|
76
|
+
Full docs + examples: https://github.com/DietrichGebert/ponytail
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ponytail-review
|
|
3
|
+
description: >
|
|
4
|
+
Quality review of a change: is the logic right, is it safe, does it hold
|
|
5
|
+
under real load, is risky code tested, is it fast enough, and is every line
|
|
6
|
+
needed. Reads the connected code, not only the diff. Each finding is
|
|
7
|
+
explained in plain English. Use for "review this", "code review", "review
|
|
8
|
+
the last commit", "review my PR", "is this over-engineered", /ponytail-review.
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
Review a change like the senior developer who will be paged when it breaks.
|
|
12
|
+
Order of importance: correct, safe, holds under load, tested, fast, lean.
|
|
13
|
+
Lean still matters: every extra line must be read, tested and fixed later.
|
|
14
|
+
This is a report the user asked for, so give it in full.
|
|
15
|
+
|
|
16
|
+
## 1. Understand first
|
|
17
|
+
|
|
18
|
+
- Review what the user names: uncommitted or staged changes, a branch, a PR
|
|
19
|
+
link, or files. Nothing named: the uncommitted changes, or the last commit
|
|
20
|
+
if there are none.
|
|
21
|
+
- Read the diff, then the code it touches: callers of every changed function,
|
|
22
|
+
the functions it calls, the tests, the README.
|
|
23
|
+
- Trace the real flow: where data comes in, what is stored, what goes out.
|
|
24
|
+
- A change can break code it does not touch. When a signature, return value
|
|
25
|
+
or behavior changes, grep every caller.
|
|
26
|
+
- Find the expected load in the repo (README, deploy config): one person
|
|
27
|
+
running a script, or many users and processes at once. Judge scale against
|
|
28
|
+
that, and say which load you assumed.
|
|
29
|
+
|
|
30
|
+
## 2. Look for
|
|
31
|
+
|
|
32
|
+
1. **Bug:** wrong result, crash, missed edge case (empty, zero, last item,
|
|
33
|
+
rounding, time zones), a caller broken by the change, a fix applied in one
|
|
34
|
+
caller while the shared function stays broken.
|
|
35
|
+
2. **Risk:** security holes (injection, weak randomness, secrets, missing
|
|
36
|
+
checks on input from users), data loss (errors swallowed, writes in the
|
|
37
|
+
wrong order, no transaction).
|
|
38
|
+
3. **Scale:** fine for one user, wrong for many: check-then-write races, the
|
|
39
|
+
same work done by every process, memory or lists that only grow, a query
|
|
40
|
+
per item, O(n^2) on big input, per-process state that must be shared.
|
|
41
|
+
4. **Missing test:** risky new logic (a branch, a parser, money, security,
|
|
42
|
+
data writes, a bug fix) with no test that fails when it breaks. One good
|
|
43
|
+
test, not coverage.
|
|
44
|
+
5. **Speed:** big slowdowns are problems. Small wins (work repeated in a hot
|
|
45
|
+
loop) are suggestions; some software counts every millisecond.
|
|
46
|
+
6. **Lean:** code that should not exist or should be smaller.
|
|
47
|
+
- delete: dead code, unused options, speculative features
|
|
48
|
+
- reuse: the repo already has this helper (name the path)
|
|
49
|
+
- stdlib / native: the standard library or platform already does it; a
|
|
50
|
+
new dependency for a few lines
|
|
51
|
+
- yagni: abstraction with one implementation, config nobody sets
|
|
52
|
+
- merge: near-copies that must change together
|
|
53
|
+
- split: one function doing several unrelated jobs, so it is hard to read
|
|
54
|
+
or test. Split by job, never by line count, and never into helpers that
|
|
55
|
+
exist only to make a function shorter.
|
|
56
|
+
|
|
57
|
+
## 3. Check before you report
|
|
58
|
+
|
|
59
|
+
- Every finding needs a concrete case: "this input or situation leads to this
|
|
60
|
+
wrong result". No case, no finding.
|
|
61
|
+
- Re-read the lines and confirm: the caller exists, the value can really be
|
|
62
|
+
empty, the code really is unused.
|
|
63
|
+
- A shortcut marked with a `shortcut:` (or older `ponytail:`) comment that names its limit is a
|
|
64
|
+
decision, not a finding, unless the expected load already crosses it.
|
|
65
|
+
- Propose the smallest fix that works. Prefer fixes that delete code. Never
|
|
66
|
+
add layers, frameworks or config the problem does not need.
|
|
67
|
+
- No style taste, no "consider", no vague worries.
|
|
68
|
+
|
|
69
|
+
## 4. Output
|
|
70
|
+
|
|
71
|
+
Very simple English: short sentences, everyday words. Explain a technical
|
|
72
|
+
term the first time you use it. The reader may never have seen this code.
|
|
73
|
+
|
|
74
|
+
Start with `What this change does:` in two or three sentences.
|
|
75
|
+
|
|
76
|
+
Then the findings in three groups, skip empty groups:
|
|
77
|
+
- **Must fix:** bug, security, data loss, breaks at the expected load.
|
|
78
|
+
- **Should fix:** risky code without a test, real slowness, duplication, a
|
|
79
|
+
function that mixes jobs, code that should not exist.
|
|
80
|
+
- **Nice to have:** small speed-ups, shorter forms.
|
|
81
|
+
|
|
82
|
+
Number findings across all groups, so the user can say "fix 2 and 5".
|
|
83
|
+
Every finding has all four parts, each one or two short sentences:
|
|
84
|
+
|
|
85
|
+
2. **Orders land on the wrong day** (`billing/close_day.py:L40-52`)
|
|
86
|
+
- **What this is:** At midnight this job closes the day and bills all orders of that day.
|
|
87
|
+
- **Problem:** It takes "today" from the server clock, which runs in UTC. An order placed
|
|
88
|
+
at 00:30 in Berlin is billed on the day before.
|
|
89
|
+
- **Fix:** Compute the day once in the shop's time zone:
|
|
90
|
+
`datetime.now(ZoneInfo("Europe/Berlin")).date()`. One line, nothing else changes.
|
|
91
|
+
- **If we skip it:** Late orders show the wrong date, and accounting fixes them by hand.
|
|
92
|
+
|
|
93
|
+
End with:
|
|
94
|
+
- `Verdict: Ship.` or `Verdict: fix 1 and 3 first.`
|
|
95
|
+
- `Lean: -<N> lines possible.` when lean findings exist.
|
|
96
|
+
- `Not checked:` one line, if something mattered and you could not check it.
|
|
97
|
+
|
|
98
|
+
Nothing found: `What this change does:`, then `Looks good. Ship.` and one line
|
|
99
|
+
on what you checked.
|
|
100
|
+
|
|
101
|
+
Lists findings, changes no code.
|
|
@@ -0,0 +1,197 @@
|
|
|
1
|
+
# The Picker
|
|
2
|
+
|
|
3
|
+
The picker's appearance is **not a design decision** — it is this spec. Copy the markup, CSS, and wiring below verbatim; the only values that change per run are the variant names and count. It stays identical across every project so it always reads as harness chrome, never as part of the design being judged. Do not restyle it with the project's tokens, fonts, or colors.
|
|
4
|
+
|
|
5
|
+
It is a floating dark pill, bottom-center. Dark glass works on top of any page — light or dark — which is why it is not theme-aware.
|
|
6
|
+
|
|
7
|
+
## Markup
|
|
8
|
+
|
|
9
|
+
The sliding highlight span first, one button per variant, a hairline divider, then the replay button (only when at least one variant has motion to re-trigger):
|
|
10
|
+
|
|
11
|
+
```html
|
|
12
|
+
<nav class="proto-picker" aria-label="Prototype variants">
|
|
13
|
+
<span class="proto-picker-highlight" aria-hidden="true"></span>
|
|
14
|
+
<button class="proto-picker-item" data-active aria-current="true">Quiet</button>
|
|
15
|
+
<button class="proto-picker-item">Editorial</button>
|
|
16
|
+
<button class="proto-picker-item">Playful</button>
|
|
17
|
+
<span class="proto-picker-divider" aria-hidden="true"></span>
|
|
18
|
+
<button class="proto-picker-item proto-picker-replay" aria-label="Replay animation (R)">↻</button>
|
|
19
|
+
</nav>
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
In a framework, keep the class names and structure; only the rendering syntax changes.
|
|
23
|
+
|
|
24
|
+
## Styles
|
|
25
|
+
|
|
26
|
+
```css
|
|
27
|
+
.proto-picker {
|
|
28
|
+
position: fixed;
|
|
29
|
+
bottom: 24px;
|
|
30
|
+
left: 50%;
|
|
31
|
+
transform: translateX(-50%);
|
|
32
|
+
z-index: 2147483647;
|
|
33
|
+
display: flex;
|
|
34
|
+
align-items: center;
|
|
35
|
+
gap: 2px;
|
|
36
|
+
padding: 4px;
|
|
37
|
+
border-radius: 999px;
|
|
38
|
+
background: rgba(10, 10, 10, 0.82);
|
|
39
|
+
-webkit-backdrop-filter: blur(12px) saturate(1.4);
|
|
40
|
+
backdrop-filter: blur(12px) saturate(1.4);
|
|
41
|
+
box-shadow:
|
|
42
|
+
0 0 0 1px rgba(255, 255, 255, 0.08) inset,
|
|
43
|
+
0 8px 24px rgba(0, 0, 0, 0.24),
|
|
44
|
+
0 2px 6px rgba(0, 0, 0, 0.12);
|
|
45
|
+
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
|
|
46
|
+
font-size: 13px;
|
|
47
|
+
line-height: 1;
|
|
48
|
+
-webkit-font-smoothing: antialiased;
|
|
49
|
+
user-select: none;
|
|
50
|
+
-webkit-user-select: none;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
.proto-picker-highlight {
|
|
54
|
+
position: absolute;
|
|
55
|
+
top: 4px;
|
|
56
|
+
left: 0;
|
|
57
|
+
height: 28px;
|
|
58
|
+
border-radius: 999px;
|
|
59
|
+
background: rgba(255, 255, 255, 0.12);
|
|
60
|
+
will-change: transform;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/* The slide is enabled only after first paint (data-ready), so load doesn't animate. */
|
|
64
|
+
.proto-picker[data-ready] .proto-picker-highlight {
|
|
65
|
+
transition:
|
|
66
|
+
transform 250ms cubic-bezier(0.23, 1, 0.32, 1),
|
|
67
|
+
width 250ms cubic-bezier(0.23, 1, 0.32, 1);
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
@media (prefers-reduced-motion: reduce) {
|
|
71
|
+
.proto-picker[data-ready] .proto-picker-highlight { transition: none; }
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
.proto-picker-item {
|
|
75
|
+
position: relative; /* sits above the highlight */
|
|
76
|
+
display: flex;
|
|
77
|
+
align-items: center;
|
|
78
|
+
height: 28px;
|
|
79
|
+
padding: 0 12px;
|
|
80
|
+
border: 0;
|
|
81
|
+
border-radius: 999px;
|
|
82
|
+
background: transparent;
|
|
83
|
+
color: rgba(255, 255, 255, 0.55);
|
|
84
|
+
font: inherit;
|
|
85
|
+
cursor: pointer;
|
|
86
|
+
transition: color 150ms ease-out;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
.proto-picker-item:hover {
|
|
90
|
+
color: rgba(255, 255, 255, 0.85);
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
.proto-picker-item:active {
|
|
94
|
+
transform: scale(0.97);
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
.proto-picker-item:focus-visible {
|
|
98
|
+
outline: 2px solid rgba(255, 255, 255, 0.4);
|
|
99
|
+
outline-offset: 2px;
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
.proto-picker-item[data-active] {
|
|
103
|
+
color: #fff;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
.proto-picker-divider {
|
|
107
|
+
width: 1px;
|
|
108
|
+
height: 16px;
|
|
109
|
+
margin: 0 4px;
|
|
110
|
+
background: rgba(255, 255, 255, 0.12);
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
.proto-picker-replay {
|
|
114
|
+
padding: 0 10px;
|
|
115
|
+
font-size: 14px;
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
.proto-picker[data-position="top"] {
|
|
119
|
+
bottom: auto;
|
|
120
|
+
top: 24px;
|
|
121
|
+
}
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
## Rules
|
|
125
|
+
|
|
126
|
+
- **Verbatim.** These values are the spec. No project fonts, no brand colors, no theme switching, no extra shadows or borders.
|
|
127
|
+
- **The highlight slides; the variant swap stays instant.** The active pill animates between buttons (250ms, strong ease-out) as spatial feedback on the picker itself — but the variant being previewed still switches with no transition. The `width` transition is a deliberate exception to the transform/opacity rule: the element is 28px tall, absolutely positioned, and has no layout dependents, so the paint cost is negligible.
|
|
128
|
+
- **One allowed modification:** if a variant occupies the bottom-center of the screen (a toast stack, a bottom sheet, a dock), set `data-position="top"` so the picker never covers the work. Nothing else about it may move or change.
|
|
129
|
+
- **Replay is conditional.** Render the replay button and its divider only when at least one variant has an entrance or state animation worth re-triggering; a static comparison gets a shorter pill.
|
|
130
|
+
|
|
131
|
+
## Behavior contract
|
|
132
|
+
|
|
133
|
+
The contract is fixed regardless of how the harness renders:
|
|
134
|
+
|
|
135
|
+
- Number keys `1–N` and `←`/`→` switch variants; `R` replays. Ignore key events when focus is in an input, textarea, select, or contenteditable, or when a modifier is held.
|
|
136
|
+
- Clicking an item switches to it; exactly one item carries `data-active` and `aria-current="true"` at all times, and the highlight slides to it.
|
|
137
|
+
- Selection persists across reload via a URL param (`?v=2`), falling back to variant 1. The highlight takes its initial position without animating (`data-ready` is added after first paint).
|
|
138
|
+
- Switching re-mounts the variant (so entrance animations re-run); the replay key re-mounts without switching.
|
|
139
|
+
|
|
140
|
+
## Reference wiring
|
|
141
|
+
|
|
142
|
+
Verbatim for the standalone-HTML branch; in a framework, keep the same behavior but express it idiomatically (state instead of `innerHTML`, a keyed re-mount instead of `requestAnimationFrame`, refs + a layout effect for the highlight measurement).
|
|
143
|
+
|
|
144
|
+
```js
|
|
145
|
+
// `variants` is an array of render functions, one per variant, in picker order.
|
|
146
|
+
const stage = document.getElementById('stage');
|
|
147
|
+
const picker = document.querySelector('.proto-picker');
|
|
148
|
+
const highlight = picker.querySelector('.proto-picker-highlight');
|
|
149
|
+
const items = [...picker.querySelectorAll('.proto-picker-item:not(.proto-picker-replay)')];
|
|
150
|
+
const replay = picker.querySelector('.proto-picker-replay');
|
|
151
|
+
let current = 0;
|
|
152
|
+
|
|
153
|
+
function moveHighlight() {
|
|
154
|
+
const el = items[current];
|
|
155
|
+
highlight.style.width = el.offsetWidth + 'px';
|
|
156
|
+
highlight.style.transform = `translateX(${el.offsetLeft}px)`;
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
function mount(i) {
|
|
160
|
+
stage.innerHTML = '';
|
|
161
|
+
// Clear first, render next frame, so entrance animations re-run.
|
|
162
|
+
requestAnimationFrame(() => { stage.innerHTML = variants[i](); });
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
function setActive(i) {
|
|
166
|
+
if (i < 0 || i >= variants.length) return;
|
|
167
|
+
current = i;
|
|
168
|
+
items.forEach((el, j) => {
|
|
169
|
+
el.toggleAttribute('data-active', j === i);
|
|
170
|
+
if (j === i) el.setAttribute('aria-current', 'true');
|
|
171
|
+
else el.removeAttribute('aria-current');
|
|
172
|
+
});
|
|
173
|
+
moveHighlight();
|
|
174
|
+
const url = new URL(location);
|
|
175
|
+
url.searchParams.set('v', i + 1);
|
|
176
|
+
history.replaceState(null, '', url);
|
|
177
|
+
mount(i);
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
items.forEach((el, i) => el.addEventListener('click', () => setActive(i)));
|
|
181
|
+
replay?.addEventListener('click', () => mount(current));
|
|
182
|
+
window.addEventListener('resize', moveHighlight);
|
|
183
|
+
|
|
184
|
+
document.addEventListener('keydown', (e) => {
|
|
185
|
+
if (/^(INPUT|TEXTAREA|SELECT)$/.test(e.target.tagName) || e.target.isContentEditable) return;
|
|
186
|
+
if (e.metaKey || e.ctrlKey || e.altKey) return;
|
|
187
|
+
const num = parseInt(e.key, 10);
|
|
188
|
+
if (num >= 1 && num <= variants.length) setActive(num - 1);
|
|
189
|
+
else if (e.key === 'ArrowRight') setActive((current + 1) % variants.length);
|
|
190
|
+
else if (e.key === 'ArrowLeft') setActive((current - 1 + variants.length) % variants.length);
|
|
191
|
+
else if (e.key === 'r' || e.key === 'R') mount(current);
|
|
192
|
+
});
|
|
193
|
+
|
|
194
|
+
setActive((parseInt(new URLSearchParams(location.search).get('v'), 10) || 1) - 1);
|
|
195
|
+
// Enable the slide only after first paint, so load doesn't animate.
|
|
196
|
+
requestAnimationFrame(() => requestAnimationFrame(() => picker.setAttribute('data-ready', '')));
|
|
197
|
+
```
|