@mytechtoday/augment-extensions 0.7.0 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +265 -232
- package/README.md +956 -771
- package/augment-extensions/coding-standards/bash/README.md +196 -196
- package/augment-extensions/coding-standards/bash/module.json +163 -163
- package/augment-extensions/coding-standards/bash/rules/naming-conventions.md +336 -336
- package/augment-extensions/coding-standards/bash/rules/universal-standards.md +289 -289
- package/augment-extensions/coding-standards/css/README.md +40 -40
- package/augment-extensions/coding-standards/css/examples/css-examples.css +550 -550
- package/augment-extensions/coding-standards/css/module.json +44 -44
- package/augment-extensions/coding-standards/css/rules/css-modern-features.md +448 -448
- package/augment-extensions/coding-standards/css/rules/css-standards.md +492 -492
- package/augment-extensions/coding-standards/html/README.md +40 -40
- package/augment-extensions/coding-standards/html/examples/html-examples.html +267 -267
- package/augment-extensions/coding-standards/html/examples/responsive-layout.html +505 -505
- package/augment-extensions/coding-standards/html/module.json +44 -44
- package/augment-extensions/coding-standards/html/rules/html-standards.md +349 -349
- package/augment-extensions/coding-standards/html-css-js/README.md +194 -194
- package/augment-extensions/coding-standards/html-css-js/examples/async-examples.js +487 -487
- package/augment-extensions/coding-standards/html-css-js/examples/css-examples.css +550 -550
- package/augment-extensions/coding-standards/html-css-js/examples/dom-examples.js +667 -667
- package/augment-extensions/coding-standards/html-css-js/examples/html-examples.html +267 -267
- package/augment-extensions/coding-standards/html-css-js/examples/javascript-examples.js +612 -612
- package/augment-extensions/coding-standards/html-css-js/examples/responsive-layout.html +505 -505
- package/augment-extensions/coding-standards/html-css-js/module.json +48 -48
- package/augment-extensions/coding-standards/html-css-js/rules/async-patterns.md +515 -515
- package/augment-extensions/coding-standards/html-css-js/rules/css-modern-features.md +448 -448
- package/augment-extensions/coding-standards/html-css-js/rules/css-standards.md +492 -492
- package/augment-extensions/coding-standards/html-css-js/rules/dom-manipulation.md +439 -439
- package/augment-extensions/coding-standards/html-css-js/rules/html-standards.md +349 -349
- package/augment-extensions/coding-standards/html-css-js/rules/javascript-standards.md +486 -486
- package/augment-extensions/coding-standards/html-css-js/rules/performance.md +463 -463
- package/augment-extensions/coding-standards/html-css-js/rules/tooling.md +543 -543
- package/augment-extensions/coding-standards/js/README.md +46 -46
- package/augment-extensions/coding-standards/js/examples/async-examples.js +487 -487
- package/augment-extensions/coding-standards/js/examples/dom-examples.js +667 -667
- package/augment-extensions/coding-standards/js/examples/javascript-examples.js +612 -612
- package/augment-extensions/coding-standards/js/module.json +49 -49
- package/augment-extensions/coding-standards/js/rules/async-patterns.md +515 -515
- package/augment-extensions/coding-standards/js/rules/dom-manipulation.md +439 -439
- package/augment-extensions/coding-standards/js/rules/javascript-standards.md +486 -486
- package/augment-extensions/coding-standards/js/rules/performance.md +463 -463
- package/augment-extensions/coding-standards/js/rules/tooling.md +543 -543
- package/augment-extensions/coding-standards/php/README.md +248 -248
- package/augment-extensions/coding-standards/php/examples/api-endpoint-example.php +204 -204
- package/augment-extensions/coding-standards/php/examples/cli-command-example.php +206 -206
- package/augment-extensions/coding-standards/php/examples/legacy-refactoring-example.php +234 -234
- package/augment-extensions/coding-standards/php/examples/web-application-example.php +211 -211
- package/augment-extensions/coding-standards/php/examples/woocommerce-extension-example.php +215 -215
- package/augment-extensions/coding-standards/php/examples/wordpress-plugin-example.php +189 -189
- package/augment-extensions/coding-standards/php/module.json +166 -166
- package/augment-extensions/coding-standards/php/rules/api-development.md +480 -480
- package/augment-extensions/coding-standards/php/rules/category-configuration.md +332 -332
- package/augment-extensions/coding-standards/php/rules/cli-tools.md +472 -472
- package/augment-extensions/coding-standards/php/rules/cms-integration.md +561 -561
- package/augment-extensions/coding-standards/php/rules/code-quality.md +402 -402
- package/augment-extensions/coding-standards/php/rules/documentation.md +425 -425
- package/augment-extensions/coding-standards/php/rules/ecommerce.md +627 -627
- package/augment-extensions/coding-standards/php/rules/error-handling.md +336 -336
- package/augment-extensions/coding-standards/php/rules/legacy-migration.md +677 -677
- package/augment-extensions/coding-standards/php/rules/naming-conventions.md +279 -279
- package/augment-extensions/coding-standards/php/rules/performance.md +392 -392
- package/augment-extensions/coding-standards/php/rules/psr-standards.md +186 -186
- package/augment-extensions/coding-standards/php/rules/security.md +358 -358
- package/augment-extensions/coding-standards/php/rules/testing.md +403 -403
- package/augment-extensions/coding-standards/php/rules/type-declarations.md +331 -331
- package/augment-extensions/coding-standards/php/rules/web-applications.md +426 -426
- package/augment-extensions/coding-standards/powershell/README.md +154 -154
- package/augment-extensions/coding-standards/powershell/examples/admin-example.ps1 +272 -272
- package/augment-extensions/coding-standards/powershell/examples/automation-example.ps1 +173 -173
- package/augment-extensions/coding-standards/powershell/examples/cloud-example.ps1 +243 -243
- package/augment-extensions/coding-standards/powershell/examples/cross-platform-example.ps1 +297 -297
- package/augment-extensions/coding-standards/powershell/examples/dsc-example.ps1 +224 -224
- package/augment-extensions/coding-standards/powershell/examples/legacy-migration-example.ps1 +340 -340
- package/augment-extensions/coding-standards/powershell/examples/module-example.psm1 +255 -255
- package/augment-extensions/coding-standards/powershell/module.json +165 -165
- package/augment-extensions/coding-standards/powershell/rules/administrative-tools.md +439 -439
- package/augment-extensions/coding-standards/powershell/rules/automation-scripts.md +240 -240
- package/augment-extensions/coding-standards/powershell/rules/cloud-orchestration.md +384 -384
- package/augment-extensions/coding-standards/powershell/rules/configuration-schema.md +383 -383
- package/augment-extensions/coding-standards/powershell/rules/cross-platform-scripts.md +482 -482
- package/augment-extensions/coding-standards/powershell/rules/dsc-configurations.md +296 -296
- package/augment-extensions/coding-standards/powershell/rules/error-handling.md +314 -314
- package/augment-extensions/coding-standards/powershell/rules/legacy-migrations.md +466 -466
- package/augment-extensions/coding-standards/powershell/rules/modules-functions.md +244 -244
- package/augment-extensions/coding-standards/powershell/rules/naming-conventions.md +266 -266
- package/augment-extensions/coding-standards/powershell/rules/performance-optimization.md +209 -209
- package/augment-extensions/coding-standards/powershell/rules/security-practices.md +314 -314
- package/augment-extensions/coding-standards/powershell/rules/testing-guidelines.md +268 -268
- package/augment-extensions/coding-standards/powershell/rules/universal-standards.md +197 -197
- package/augment-extensions/coding-standards/python/README.md +48 -48
- package/augment-extensions/coding-standards/python/examples/best-practices.py +373 -373
- package/augment-extensions/coding-standards/python/module.json +30 -30
- package/augment-extensions/coding-standards/python/rules/async-patterns.md +884 -884
- package/augment-extensions/coding-standards/python/rules/best-practices.md +232 -232
- package/augment-extensions/coding-standards/python/rules/code-organization.md +220 -220
- package/augment-extensions/coding-standards/python/rules/documentation.md +831 -831
- package/augment-extensions/coding-standards/python/rules/error-handling.md +1008 -1008
- package/augment-extensions/coding-standards/python/rules/naming-conventions.md +172 -172
- package/augment-extensions/coding-standards/python/rules/testing.md +409 -409
- package/augment-extensions/coding-standards/python/rules/tooling.md +446 -446
- package/augment-extensions/coding-standards/python/rules/type-hints.md +253 -253
- package/augment-extensions/coding-standards/react/README.md +45 -45
- package/augment-extensions/coding-standards/react/module.json +27 -27
- package/augment-extensions/coding-standards/react/rules/component-patterns.md +214 -214
- package/augment-extensions/coding-standards/react/rules/hooks-best-practices.md +235 -235
- package/augment-extensions/coding-standards/react/rules/performance.md +300 -300
- package/augment-extensions/coding-standards/react/rules/state-management.md +265 -265
- package/augment-extensions/coding-standards/react/rules/typescript-react.md +271 -271
- package/augment-extensions/coding-standards/typescript/README.md +45 -45
- package/augment-extensions/coding-standards/typescript/module.json +27 -27
- package/augment-extensions/coding-standards/typescript/rules/naming-conventions.md +225 -225
- package/augment-extensions/collections/html-css-js/README.md +82 -82
- package/augment-extensions/collections/html-css-js/collection.json +41 -41
- package/augment-extensions/domain-rules/api-design/README.md +41 -41
- package/augment-extensions/domain-rules/api-design/module.json +27 -27
- package/augment-extensions/domain-rules/api-design/rules/authentication.md +263 -263
- package/augment-extensions/domain-rules/api-design/rules/documentation.md +395 -395
- package/augment-extensions/domain-rules/api-design/rules/error-handling.md +290 -290
- package/augment-extensions/domain-rules/api-design/rules/graphql-api.md +313 -313
- package/augment-extensions/domain-rules/api-design/rules/rest-api.md +214 -214
- package/augment-extensions/domain-rules/api-design/rules/versioning.md +268 -268
- package/augment-extensions/domain-rules/database/README.md +161 -161
- package/augment-extensions/domain-rules/database/examples/flat-database-example.md +793 -793
- package/augment-extensions/domain-rules/database/examples/hybrid-database-example.md +1132 -1132
- package/augment-extensions/domain-rules/database/examples/nosql-document-example.md +868 -868
- package/augment-extensions/domain-rules/database/examples/nosql-graph-example.md +805 -805
- package/augment-extensions/domain-rules/database/examples/relational-schema-example.md +621 -621
- package/augment-extensions/domain-rules/database/examples/vector-database-example.md +965 -965
- package/augment-extensions/domain-rules/database/module.json +28 -28
- package/augment-extensions/domain-rules/database/rules/flat-databases.md +624 -624
- package/augment-extensions/domain-rules/database/rules/nosql-databases.md +588 -588
- package/augment-extensions/domain-rules/database/rules/nosql-document-stores.md +856 -856
- package/augment-extensions/domain-rules/database/rules/nosql-graph-databases.md +778 -778
- package/augment-extensions/domain-rules/database/rules/nosql-key-value-stores.md +963 -963
- package/augment-extensions/domain-rules/database/rules/performance-optimization.md +1076 -1076
- package/augment-extensions/domain-rules/database/rules/relational-databases.md +697 -697
- package/augment-extensions/domain-rules/database/rules/relational-indexing.md +671 -671
- package/augment-extensions/domain-rules/database/rules/relational-query-optimization.md +607 -607
- package/augment-extensions/domain-rules/database/rules/relational-schema-design.md +907 -907
- package/augment-extensions/domain-rules/database/rules/relational-transactions.md +783 -783
- package/augment-extensions/domain-rules/database/rules/security-standards.md +980 -980
- package/augment-extensions/domain-rules/database/rules/universal-best-practices.md +485 -485
- package/augment-extensions/domain-rules/database/rules/vector-databases.md +521 -521
- package/augment-extensions/domain-rules/database/rules/vector-embeddings.md +858 -858
- package/augment-extensions/domain-rules/database/rules/vector-indexing.md +934 -934
- package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/catppuccin-latte/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/catppuccin-mocha/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/dracula/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/dracula/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/gruvbox-dark/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/gruvbox-light/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/high-contrast/README.md +27 -27
- package/augment-extensions/domain-rules/design/color/themes/high-contrast/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/monokai/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/monokai/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/nord/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/nord/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/one-dark/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/one-dark/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/one-light/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/one-light/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/solarized-dark/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/solarized-dark/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/solarized-light/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/solarized-light/module.json +26 -26
- package/augment-extensions/domain-rules/design/color/themes/tokyo-night/README.md +23 -23
- package/augment-extensions/domain-rules/design/color/themes/tokyo-night/module.json +26 -26
- package/augment-extensions/domain-rules/mcp/README.md +150 -150
- package/augment-extensions/domain-rules/mcp/examples/compressed-example.md +522 -522
- package/augment-extensions/domain-rules/mcp/examples/graph-augmented-example.md +520 -520
- package/augment-extensions/domain-rules/mcp/examples/hybrid-example.md +570 -570
- package/augment-extensions/domain-rules/mcp/examples/state-based-example.md +427 -427
- package/augment-extensions/domain-rules/mcp/examples/token-based-example.md +435 -435
- package/augment-extensions/domain-rules/mcp/examples/vector-based-example.md +502 -502
- package/augment-extensions/domain-rules/mcp/module.json +49 -49
- package/augment-extensions/domain-rules/mcp/rules/compressed-mcp.md +595 -595
- package/augment-extensions/domain-rules/mcp/rules/configuration.md +345 -345
- package/augment-extensions/domain-rules/mcp/rules/graph-augmented-mcp.md +687 -687
- package/augment-extensions/domain-rules/mcp/rules/hybrid-mcp.md +636 -636
- package/augment-extensions/domain-rules/mcp/rules/state-based-mcp.md +484 -484
- package/augment-extensions/domain-rules/mcp/rules/testing-validation.md +360 -360
- package/augment-extensions/domain-rules/mcp/rules/token-based-mcp.md +393 -393
- package/augment-extensions/domain-rules/mcp/rules/universal-rules.md +194 -194
- package/augment-extensions/domain-rules/mcp/rules/vector-based-mcp.md +625 -625
- package/augment-extensions/domain-rules/security/README.md +41 -41
- package/augment-extensions/domain-rules/security/module.json +28 -28
- package/augment-extensions/domain-rules/security/rules/authentication-security.md +361 -361
- package/augment-extensions/domain-rules/security/rules/encryption.md +208 -208
- package/augment-extensions/domain-rules/security/rules/input-validation.md +294 -294
- package/augment-extensions/domain-rules/security/rules/owasp-top-10.md +339 -339
- package/augment-extensions/domain-rules/security/rules/secure-coding.md +293 -293
- package/augment-extensions/domain-rules/security/rules/web-security.md +268 -268
- package/augment-extensions/domain-rules/seo-sales-marketing/ANNOUNCEMENT.md +143 -0
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/README.md +140 -136
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/SCHEMA-VALIDATION-REPORT.md +216 -216
- package/augment-extensions/domain-rules/seo-sales-marketing/TEST-VALIDATION.md +129 -0
- package/augment-extensions/domain-rules/seo-sales-marketing/USAGE-GUIDES.md +254 -0
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/brand-kit-example.yaml +292 -292
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/campaign-brief-example.yaml +389 -389
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/content-calendar-example.yaml +643 -643
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/email-newsletter-example.md +376 -376
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/landing-page-example.md +934 -934
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/ppc-ad-copy-example.md +301 -301
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/seo-blog-post-example.md +347 -347
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/examples/social-media-campaign-example.md +606 -606
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/module.json +50 -50
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/affiliate-influencer-marketing.md +593 -593
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/asset-management.md +418 -418
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/brand-consistency.md +210 -210
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/content-marketing.md +337 -337
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/conversion-optimization.md +455 -455
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/direct-sales.md +499 -499
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/email-marketing.md +439 -439
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/legal-compliance.md +227 -227
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/ppc-advertising.md +569 -569
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/seo-optimization.md +470 -470
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/social-media-marketing.md +414 -414
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/rules/universal-marketing.md +177 -177
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/asset-inventory.schema.json +247 -247
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/brand-kit.schema.json +326 -326
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/campaign-brief.schema.json +342 -342
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/color-palette.schema.json +223 -223
- package/augment-extensions/domain-rules/{marketing-standards/seo-sales-marketing → seo-sales-marketing}/schemas/content-template.schema.json +383 -383
- package/augment-extensions/domain-rules/wordpress/README.md +163 -163
- package/augment-extensions/domain-rules/wordpress/module.json +32 -32
- package/augment-extensions/domain-rules/wordpress/rules/coding-standards.md +617 -617
- package/augment-extensions/domain-rules/wordpress/rules/directory-structure.md +270 -270
- package/augment-extensions/domain-rules/wordpress/rules/file-patterns.md +423 -423
- package/augment-extensions/domain-rules/wordpress/rules/gutenberg-blocks.md +493 -493
- package/augment-extensions/domain-rules/wordpress/rules/performance.md +568 -568
- package/augment-extensions/domain-rules/wordpress/rules/plugin-development.md +510 -510
- package/augment-extensions/domain-rules/wordpress/rules/project-detection.md +251 -251
- package/augment-extensions/domain-rules/wordpress/rules/rest-api.md +501 -501
- package/augment-extensions/domain-rules/wordpress/rules/security.md +564 -564
- package/augment-extensions/domain-rules/wordpress/rules/theme-development.md +388 -388
- package/augment-extensions/domain-rules/wordpress/rules/woocommerce.md +441 -441
- package/augment-extensions/domain-rules/wordpress-plugin/README.md +139 -139
- package/augment-extensions/domain-rules/wordpress-plugin/examples/ajax-plugin.md +1599 -1599
- package/augment-extensions/domain-rules/wordpress-plugin/examples/custom-post-type-plugin.md +1727 -1727
- package/augment-extensions/domain-rules/wordpress-plugin/examples/gutenberg-block-plugin.md +428 -428
- package/augment-extensions/domain-rules/wordpress-plugin/examples/gutenberg-block.md +422 -422
- package/augment-extensions/domain-rules/wordpress-plugin/examples/mvc-plugin.md +1623 -1623
- package/augment-extensions/domain-rules/wordpress-plugin/examples/object-oriented-plugin.md +1343 -1343
- package/augment-extensions/domain-rules/wordpress-plugin/examples/rest-endpoint.md +734 -734
- package/augment-extensions/domain-rules/wordpress-plugin/examples/settings-page-plugin.md +1350 -1350
- package/augment-extensions/domain-rules/wordpress-plugin/examples/simple-procedural-plugin.md +503 -503
- package/augment-extensions/domain-rules/wordpress-plugin/examples/singleton-plugin.md +971 -971
- package/augment-extensions/domain-rules/wordpress-plugin/module.json +53 -53
- package/augment-extensions/domain-rules/wordpress-plugin/rules/activation-hooks.md +770 -770
- package/augment-extensions/domain-rules/wordpress-plugin/rules/admin-interface.md +874 -874
- package/augment-extensions/domain-rules/wordpress-plugin/rules/ajax-handlers.md +629 -629
- package/augment-extensions/domain-rules/wordpress-plugin/rules/asset-management.md +559 -559
- package/augment-extensions/domain-rules/wordpress-plugin/rules/context-providers.md +709 -709
- package/augment-extensions/domain-rules/wordpress-plugin/rules/cron-jobs.md +736 -736
- package/augment-extensions/domain-rules/wordpress-plugin/rules/database-management.md +1057 -1057
- package/augment-extensions/domain-rules/wordpress-plugin/rules/documentation-standards.md +463 -463
- package/augment-extensions/domain-rules/wordpress-plugin/rules/frontend-functionality.md +478 -478
- package/augment-extensions/domain-rules/wordpress-plugin/rules/gutenberg-blocks.md +818 -818
- package/augment-extensions/domain-rules/wordpress-plugin/rules/internationalization.md +416 -416
- package/augment-extensions/domain-rules/wordpress-plugin/rules/migration.md +667 -667
- package/augment-extensions/domain-rules/wordpress-plugin/rules/performance-optimization.md +878 -878
- package/augment-extensions/domain-rules/wordpress-plugin/rules/plugin-architecture.md +693 -693
- package/augment-extensions/domain-rules/wordpress-plugin/rules/plugin-structure.md +352 -352
- package/augment-extensions/domain-rules/wordpress-plugin/rules/rest-api.md +818 -818
- package/augment-extensions/domain-rules/wordpress-plugin/rules/scaffolding-workflow.md +624 -624
- package/augment-extensions/domain-rules/wordpress-plugin/rules/security-best-practices.md +866 -866
- package/augment-extensions/domain-rules/wordpress-plugin/rules/testing-patterns.md +1165 -1165
- package/augment-extensions/domain-rules/wordpress-plugin/rules/testing.md +414 -414
- package/augment-extensions/domain-rules/wordpress-plugin/rules/vscode-integration.md +751 -751
- package/augment-extensions/domain-rules/wordpress-plugin/rules/woocommerce-integration.md +949 -949
- package/augment-extensions/domain-rules/wordpress-plugin/rules/wordpress-org-submission.md +458 -458
- package/augment-extensions/examples/design-patterns/README.md +37 -37
- package/augment-extensions/examples/design-patterns/examples/behavioral-patterns.md +370 -370
- package/augment-extensions/examples/design-patterns/examples/creational-patterns.md +250 -250
- package/augment-extensions/examples/design-patterns/examples/structural-patterns.md +264 -264
- package/augment-extensions/examples/design-patterns/module.json +27 -27
- package/augment-extensions/examples/gutenberg-block-plugin/README.md +101 -101
- package/augment-extensions/examples/gutenberg-block-plugin/examples/testimonial-block.md +428 -428
- package/augment-extensions/examples/gutenberg-block-plugin/module.json +40 -40
- package/augment-extensions/examples/rest-api-plugin/README.md +98 -98
- package/augment-extensions/examples/rest-api-plugin/examples/task-manager-api.md +1299 -1299
- package/augment-extensions/examples/rest-api-plugin/module.json +40 -40
- package/augment-extensions/examples/woocommerce-extension/README.md +98 -98
- package/augment-extensions/examples/woocommerce-extension/examples/product-customizer.md +763 -763
- package/augment-extensions/examples/woocommerce-extension/module.json +40 -40
- package/augment-extensions/workflows/beads/README.md +135 -135
- package/augment-extensions/workflows/beads/examples/complete-workflow-example.md +278 -278
- package/augment-extensions/workflows/beads/module.json +55 -55
- package/augment-extensions/workflows/beads/rules/best-practices.md +398 -398
- package/augment-extensions/workflows/beads/rules/file-format.md +327 -327
- package/augment-extensions/workflows/beads/rules/manual-setup.md +315 -315
- package/augment-extensions/workflows/beads/rules/workflow.md +326 -326
- package/augment-extensions/workflows/beads-integration/IMPLEMENTATION-STATUS.md +145 -145
- package/augment-extensions/workflows/beads-integration/README.md +143 -143
- package/augment-extensions/workflows/beads-integration/config/defaults.json +32 -32
- package/augment-extensions/workflows/beads-integration/config/schema.json +140 -140
- package/augment-extensions/workflows/beads-integration/examples/basic-task-generation.md +293 -293
- package/augment-extensions/workflows/beads-integration/module.json +75 -75
- package/augment-extensions/workflows/beads-integration/rules/core-rules.md +219 -219
- package/augment-extensions/workflows/beads-integration/rules/effectiveness-standards.md +256 -256
- package/augment-extensions/workflows/beads-integration/rules/task-generation.md +607 -607
- package/augment-extensions/workflows/database/README.md +195 -195
- package/augment-extensions/workflows/database/ai-prompt-testing.md +295 -295
- package/augment-extensions/workflows/database/examples/migration-example.md +498 -498
- package/augment-extensions/workflows/database/examples/optimization-example.md +496 -496
- package/augment-extensions/workflows/database/examples/schema-design-example.md +444 -444
- package/augment-extensions/workflows/database/module.json +42 -42
- package/augment-extensions/workflows/database/rules/data-migration.md +249 -249
- package/augment-extensions/workflows/database/rules/documentation-standards.md +339 -339
- package/augment-extensions/workflows/database/rules/migration-workflow.md +352 -352
- package/augment-extensions/workflows/database/rules/optimization-workflow.md +435 -435
- package/augment-extensions/workflows/database/rules/schema-design-workflow.md +535 -535
- package/augment-extensions/workflows/database/rules/testing-patterns.md +305 -305
- package/augment-extensions/workflows/database/rules/workflow.md +458 -458
- package/augment-extensions/workflows/wordpress-plugin/README.md +232 -232
- package/augment-extensions/workflows/wordpress-plugin/ai-prompts.md +839 -839
- package/augment-extensions/workflows/wordpress-plugin/bead-decomposition-patterns.md +854 -854
- package/augment-extensions/workflows/wordpress-plugin/examples/complete-plugin-example.md +540 -540
- package/augment-extensions/workflows/wordpress-plugin/examples/custom-post-type-example.md +1083 -1083
- package/augment-extensions/workflows/wordpress-plugin/examples/feature-addition-workflow.md +669 -669
- package/augment-extensions/workflows/wordpress-plugin/examples/plugin-creation-workflow.md +597 -597
- package/augment-extensions/workflows/wordpress-plugin/examples/secure-form-handler-example.md +925 -925
- package/augment-extensions/workflows/wordpress-plugin/examples/security-audit-workflow.md +752 -752
- package/augment-extensions/workflows/wordpress-plugin/examples/wordpress-org-submission-workflow.md +773 -773
- package/augment-extensions/workflows/wordpress-plugin/module.json +49 -49
- package/augment-extensions/workflows/wordpress-plugin/rules/best-practices.md +942 -942
- package/augment-extensions/workflows/wordpress-plugin/rules/development-workflow.md +702 -702
- package/augment-extensions/workflows/wordpress-plugin/rules/submission-workflow.md +728 -728
- package/augment-extensions/workflows/wordpress-plugin/rules/testing-workflow.md +775 -775
- package/augment-extensions/writing-standards/screenplay/README.md +339 -300
- package/augment-extensions/writing-standards/screenplay/_templates/README.md +121 -121
- package/augment-extensions/writing-standards/screenplay/_templates/genre-template.md +153 -153
- package/augment-extensions/writing-standards/screenplay/_templates/style-template.md +243 -243
- package/augment-extensions/writing-standards/screenplay/_templates/theme-template.md +213 -213
- package/augment-extensions/writing-standards/screenplay/examples/aaa-hollywood-scene.fountain +164 -164
- package/augment-extensions/writing-standards/screenplay/examples/beat-sheet-example.yaml +95 -95
- package/augment-extensions/writing-standards/screenplay/examples/character-profile-example.yaml +116 -116
- package/augment-extensions/writing-standards/screenplay/examples/commercial-30sec.fountain +151 -151
- package/augment-extensions/writing-standards/screenplay/examples/independent-monologue.fountain +67 -67
- package/augment-extensions/writing-standards/screenplay/examples/news-segment.fountain +142 -142
- package/augment-extensions/writing-standards/screenplay/examples/plot-outline-example.yaml +184 -184
- package/augment-extensions/writing-standards/screenplay/examples/tv-episode-teaser.fountain +204 -204
- package/augment-extensions/writing-standards/screenplay/genres/README.md +181 -181
- package/augment-extensions/writing-standards/screenplay/genres/examples/.gitkeep +2 -2
- package/augment-extensions/writing-standards/screenplay/genres/module.json +70 -70
- package/augment-extensions/writing-standards/screenplay/genres/rules/.gitkeep +2 -2
- package/augment-extensions/writing-standards/screenplay/genres/rules/action.md +399 -399
- package/augment-extensions/writing-standards/screenplay/genres/rules/adventure.md +407 -407
- package/augment-extensions/writing-standards/screenplay/genres/rules/animation.md +293 -293
- package/augment-extensions/writing-standards/screenplay/genres/rules/biographical.md +293 -293
- package/augment-extensions/writing-standards/screenplay/genres/rules/comedy.md +401 -401
- package/augment-extensions/writing-standards/screenplay/genres/rules/documentary.md +293 -293
- package/augment-extensions/writing-standards/screenplay/genres/rules/drama.md +409 -409
- package/augment-extensions/writing-standards/screenplay/genres/rules/fantasy.md +293 -293
- package/augment-extensions/writing-standards/screenplay/genres/rules/historical.md +293 -293
- package/augment-extensions/writing-standards/screenplay/genres/rules/horror.md +268 -268
- package/augment-extensions/writing-standards/screenplay/genres/rules/musical.md +294 -294
- package/augment-extensions/writing-standards/screenplay/genres/rules/mystery.md +293 -293
- package/augment-extensions/writing-standards/screenplay/genres/rules/noir.md +294 -294
- package/augment-extensions/writing-standards/screenplay/genres/rules/romance.md +293 -293
- package/augment-extensions/writing-standards/screenplay/genres/rules/sci-fi.md +289 -289
- package/augment-extensions/writing-standards/screenplay/genres/rules/superhero.md +293 -293
- package/augment-extensions/writing-standards/screenplay/genres/rules/thriller.md +294 -294
- package/augment-extensions/writing-standards/screenplay/genres/rules/western.md +293 -293
- package/augment-extensions/writing-standards/screenplay/module.json +124 -124
- package/augment-extensions/writing-standards/screenplay/rules/aaa-hollywood-films.md +339 -339
- package/augment-extensions/writing-standards/screenplay/rules/ai-integration-testing.md +329 -329
- package/augment-extensions/writing-standards/screenplay/rules/character-development.md +169 -169
- package/augment-extensions/writing-standards/screenplay/rules/commercials.md +437 -437
- package/augment-extensions/writing-standards/screenplay/rules/dialogue-writing.md +263 -263
- package/augment-extensions/writing-standards/screenplay/rules/diversity-inclusion.md +261 -261
- package/augment-extensions/writing-standards/screenplay/rules/examples-guide.md +315 -315
- package/augment-extensions/writing-standards/screenplay/rules/file-organization.md +213 -0
- package/augment-extensions/writing-standards/screenplay/rules/formatting-validation.md +413 -413
- package/augment-extensions/writing-standards/screenplay/rules/fountain-format.md +372 -372
- package/augment-extensions/writing-standards/screenplay/rules/independent-films.md +374 -374
- package/augment-extensions/writing-standards/screenplay/rules/live-tv-productions.md +443 -443
- package/augment-extensions/writing-standards/screenplay/rules/narrative-structures.md +207 -207
- package/augment-extensions/writing-standards/screenplay/rules/news-broadcasts.md +444 -444
- package/augment-extensions/writing-standards/screenplay/rules/pacing-timing.md +331 -331
- package/augment-extensions/writing-standards/screenplay/rules/quality-review-checklist.md +334 -334
- package/augment-extensions/writing-standards/screenplay/rules/quick-reference.md +299 -299
- package/augment-extensions/writing-standards/screenplay/rules/screen-continuity.md +263 -263
- package/augment-extensions/writing-standards/screenplay/rules/streaming-content.md +412 -412
- package/augment-extensions/writing-standards/screenplay/rules/trope-management.md +370 -370
- package/augment-extensions/writing-standards/screenplay/rules/tv-series.md +374 -374
- package/augment-extensions/writing-standards/screenplay/rules/universal-formatting.md +339 -339
- package/augment-extensions/writing-standards/screenplay/rules/vscode-integration.md +277 -277
- package/augment-extensions/writing-standards/screenplay/rules/web-content.md +393 -393
- package/augment-extensions/writing-standards/screenplay/schemas/beat-sheet.json +332 -332
- package/augment-extensions/writing-standards/screenplay/schemas/character-profile.json +247 -247
- package/augment-extensions/writing-standards/screenplay/schemas/feature-selection.json +200 -200
- package/augment-extensions/writing-standards/screenplay/schemas/plot-outline.json +233 -233
- package/augment-extensions/writing-standards/screenplay/schemas/screenplay-config.json +245 -245
- package/augment-extensions/writing-standards/screenplay/schemas/trope-inventory.json +221 -221
- package/augment-extensions/writing-standards/screenplay/styles/README.md +159 -159
- package/augment-extensions/writing-standards/screenplay/styles/examples/.gitkeep +2 -2
- package/augment-extensions/writing-standards/screenplay/styles/examples/style-applications.md +1449 -1449
- package/augment-extensions/writing-standards/screenplay/styles/module.json +64 -64
- package/augment-extensions/writing-standards/screenplay/styles/rules/.gitkeep +2 -2
- package/augment-extensions/writing-standards/screenplay/styles/rules/dialogue-centric.md +520 -520
- package/augment-extensions/writing-standards/screenplay/styles/rules/ensemble.md +499 -499
- package/augment-extensions/writing-standards/screenplay/styles/rules/epic.md +497 -497
- package/augment-extensions/writing-standards/screenplay/styles/rules/experimental.md +492 -492
- package/augment-extensions/writing-standards/screenplay/styles/rules/flashback.md +509 -509
- package/augment-extensions/writing-standards/screenplay/styles/rules/linear.md +490 -490
- package/augment-extensions/writing-standards/screenplay/styles/rules/minimalist.md +499 -499
- package/augment-extensions/writing-standards/screenplay/styles/rules/non-linear.md +501 -501
- package/augment-extensions/writing-standards/screenplay/styles/rules/poetic.md +499 -499
- package/augment-extensions/writing-standards/screenplay/styles/rules/realistic.md +498 -498
- package/augment-extensions/writing-standards/screenplay/styles/rules/satirical.md +499 -499
- package/augment-extensions/writing-standards/screenplay/styles/rules/surreal.md +508 -508
- package/augment-extensions/writing-standards/screenplay/styles/rules/voice-over.md +500 -500
- package/augment-extensions/writing-standards/screenplay/themes/README.md +158 -158
- package/augment-extensions/writing-standards/screenplay/themes/examples/.gitkeep +2 -2
- package/augment-extensions/writing-standards/screenplay/themes/examples/common-mistakes-and-fixes.md +643 -643
- package/augment-extensions/writing-standards/screenplay/themes/examples/complete-scene-example.md +311 -311
- package/augment-extensions/writing-standards/screenplay/themes/examples/individual-theme-examples.md +562 -562
- package/augment-extensions/writing-standards/screenplay/themes/examples/multi-theme-weaving.md +538 -538
- package/augment-extensions/writing-standards/screenplay/themes/examples/theme-application-guide.md +432 -432
- package/augment-extensions/writing-standards/screenplay/themes/examples/theme-integration-across-acts.md +637 -637
- package/augment-extensions/writing-standards/screenplay/themes/module.json +66 -66
- package/augment-extensions/writing-standards/screenplay/themes/rules/.gitkeep +2 -2
- package/augment-extensions/writing-standards/screenplay/themes/rules/ambition.md +458 -458
- package/augment-extensions/writing-standards/screenplay/themes/rules/betrayal.md +490 -490
- package/augment-extensions/writing-standards/screenplay/themes/rules/environment.md +458 -458
- package/augment-extensions/writing-standards/screenplay/themes/rules/fate.md +459 -459
- package/augment-extensions/writing-standards/screenplay/themes/rules/friendship.md +491 -491
- package/augment-extensions/writing-standards/screenplay/themes/rules/growth.md +491 -491
- package/augment-extensions/writing-standards/screenplay/themes/rules/identity.md +490 -490
- package/augment-extensions/writing-standards/screenplay/themes/rules/isolation.md +464 -464
- package/augment-extensions/writing-standards/screenplay/themes/rules/justice.md +461 -461
- package/augment-extensions/writing-standards/screenplay/themes/rules/love.md +489 -489
- package/augment-extensions/writing-standards/screenplay/themes/rules/power.md +494 -494
- package/augment-extensions/writing-standards/screenplay/themes/rules/redemption.md +483 -483
- package/augment-extensions/writing-standards/screenplay/themes/rules/revenge.md +489 -489
- package/augment-extensions/writing-standards/screenplay/themes/rules/survival.md +496 -496
- package/augment-extensions/writing-standards/screenplay/themes/rules/technology.md +463 -463
- package/augment-extensions/writing-standards/screenplay/utils/__tests__/file-organization.test.ts +169 -0
- package/augment-extensions/writing-standards/screenplay/utils/file-organization.ts +165 -0
- package/cli/MODULES.md +302 -302
- package/cli/dist/cli.js +109 -22
- package/cli/dist/cli.js.map +1 -1
- package/cli/dist/commands/gui.d.ts.map +1 -1
- package/cli/dist/commands/gui.js +54 -6
- package/cli/dist/commands/gui.js.map +1 -1
- package/cli/dist/commands/init.d.ts.map +1 -1
- package/cli/dist/commands/init.js +76 -23
- package/cli/dist/commands/init.js.map +1 -1
- package/cli/dist/commands/self-remove.d.ts.map +1 -1
- package/cli/dist/commands/self-remove.js +48 -74
- package/cli/dist/commands/self-remove.js.map +1 -1
- package/cli/dist/commands/show.d.ts +11 -0
- package/cli/dist/commands/show.d.ts.map +1 -1
- package/cli/dist/commands/show.js +120 -0
- package/cli/dist/commands/show.js.map +1 -1
- package/cli/dist/commands/showCompleted.d.ts +21 -0
- package/cli/dist/commands/showCompleted.d.ts.map +1 -0
- package/cli/dist/commands/showCompleted.js +225 -0
- package/cli/dist/commands/showCompleted.js.map +1 -0
- package/cli/dist/commands/skill.js +88 -88
- package/cli/dist/commands/update.d.ts +2 -0
- package/cli/dist/commands/update.d.ts.map +1 -1
- package/cli/dist/commands/update.js +67 -1
- package/cli/dist/commands/update.js.map +1 -1
- package/cli/dist/utils/beadsCompletedChecker.d.ts +72 -0
- package/cli/dist/utils/beadsCompletedChecker.d.ts.map +1 -0
- package/cli/dist/utils/beadsCompletedChecker.js +198 -0
- package/cli/dist/utils/beadsCompletedChecker.js.map +1 -0
- package/cli/dist/utils/catalog-sync.js +13 -13
- package/cli/dist/utils/extractCommandHelp.d.ts +51 -0
- package/cli/dist/utils/extractCommandHelp.d.ts.map +1 -0
- package/cli/dist/utils/extractCommandHelp.js +250 -0
- package/cli/dist/utils/extractCommandHelp.js.map +1 -0
- package/cli/dist/utils/install-rules.js +55 -55
- package/cli/dist/utils/mcp-integration.js +44 -44
- package/cli/dist/utils/rule-install-hooks.js +8 -8
- package/modules.md +667 -630
- package/package.json +85 -85
|
@@ -1,543 +1,543 @@
|
|
|
1
|
-
# Tooling and Code Quality
|
|
2
|
-
|
|
3
|
-
## Overview
|
|
4
|
-
|
|
5
|
-
This guide provides recommendations for linting, formatting, and browser compatibility tools to maintain code quality in HTML, CSS, and JavaScript projects.
|
|
6
|
-
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
## JavaScript Linting
|
|
10
|
-
|
|
11
|
-
### ESLint
|
|
12
|
-
|
|
13
|
-
**RECOMMENDED**: Use ESLint for JavaScript linting:
|
|
14
|
-
|
|
15
|
-
```bash
|
|
16
|
-
# Install ESLint
|
|
17
|
-
npm install --save-dev eslint
|
|
18
|
-
|
|
19
|
-
# Initialize configuration
|
|
20
|
-
npx eslint --init
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
**Configuration** (`.eslintrc.json`):
|
|
24
|
-
|
|
25
|
-
```json
|
|
26
|
-
{
|
|
27
|
-
"env": {
|
|
28
|
-
"browser": true,
|
|
29
|
-
"es2021": true
|
|
30
|
-
},
|
|
31
|
-
"extends": "eslint:recommended",
|
|
32
|
-
"parserOptions": {
|
|
33
|
-
"ecmaVersion": "latest",
|
|
34
|
-
"sourceType": "module"
|
|
35
|
-
},
|
|
36
|
-
"rules": {
|
|
37
|
-
"no-var": "error",
|
|
38
|
-
"prefer-const": "error",
|
|
39
|
-
"prefer-arrow-callback": "warn",
|
|
40
|
-
"no-console": "warn",
|
|
41
|
-
"eqeqeq": ["error", "always"],
|
|
42
|
-
"curly": ["error", "all"],
|
|
43
|
-
"no-unused-vars": ["error", { "argsIgnorePattern": "^_" }]
|
|
44
|
-
}
|
|
45
|
-
}
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
**Usage**:
|
|
49
|
-
|
|
50
|
-
```bash
|
|
51
|
-
# Lint files
|
|
52
|
-
npx eslint src/**/*.js
|
|
53
|
-
|
|
54
|
-
# Auto-fix issues
|
|
55
|
-
npx eslint src/**/*.js --fix
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
### Recommended ESLint Rules
|
|
59
|
-
|
|
60
|
-
```json
|
|
61
|
-
{
|
|
62
|
-
"rules": {
|
|
63
|
-
// Variables
|
|
64
|
-
"no-var": "error",
|
|
65
|
-
"prefer-const": "error",
|
|
66
|
-
"no-unused-vars": "error",
|
|
67
|
-
|
|
68
|
-
// Best Practices
|
|
69
|
-
"eqeqeq": ["error", "always"],
|
|
70
|
-
"no-eval": "error",
|
|
71
|
-
"no-implied-eval": "error",
|
|
72
|
-
"no-with": "error",
|
|
73
|
-
|
|
74
|
-
// ES6+
|
|
75
|
-
"prefer-arrow-callback": "warn",
|
|
76
|
-
"prefer-template": "warn",
|
|
77
|
-
"prefer-destructuring": "warn",
|
|
78
|
-
"object-shorthand": "warn",
|
|
79
|
-
|
|
80
|
-
// Style
|
|
81
|
-
"curly": ["error", "all"],
|
|
82
|
-
"brace-style": ["error", "1tbs"],
|
|
83
|
-
"comma-dangle": ["error", "never"],
|
|
84
|
-
"quotes": ["error", "single"],
|
|
85
|
-
"semi": ["error", "always"]
|
|
86
|
-
}
|
|
87
|
-
}
|
|
88
|
-
```
|
|
89
|
-
|
|
90
|
-
---
|
|
91
|
-
|
|
92
|
-
## Code Formatting
|
|
93
|
-
|
|
94
|
-
### Prettier
|
|
95
|
-
|
|
96
|
-
**RECOMMENDED**: Use Prettier for consistent code formatting:
|
|
97
|
-
|
|
98
|
-
```bash
|
|
99
|
-
# Install Prettier
|
|
100
|
-
npm install --save-dev prettier
|
|
101
|
-
|
|
102
|
-
# Create configuration
|
|
103
|
-
echo {} > .prettierrc.json
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
**Configuration** (`.prettierrc.json`):
|
|
107
|
-
|
|
108
|
-
```json
|
|
109
|
-
{
|
|
110
|
-
"semi": true,
|
|
111
|
-
"singleQuote": true,
|
|
112
|
-
"tabWidth": 2,
|
|
113
|
-
"useTabs": false,
|
|
114
|
-
"trailingComma": "es5",
|
|
115
|
-
"printWidth": 80,
|
|
116
|
-
"arrowParens": "avoid",
|
|
117
|
-
"endOfLine": "lf"
|
|
118
|
-
}
|
|
119
|
-
```
|
|
120
|
-
|
|
121
|
-
**Usage**:
|
|
122
|
-
|
|
123
|
-
```bash
|
|
124
|
-
# Format files
|
|
125
|
-
npx prettier --write "src/**/*.{js,css,html}"
|
|
126
|
-
|
|
127
|
-
# Check formatting
|
|
128
|
-
npx prettier --check "src/**/*.{js,css,html}"
|
|
129
|
-
```
|
|
130
|
-
|
|
131
|
-
### Prettier + ESLint Integration
|
|
132
|
-
|
|
133
|
-
**RECOMMENDED**: Integrate Prettier with ESLint:
|
|
134
|
-
|
|
135
|
-
```bash
|
|
136
|
-
# Install integration packages
|
|
137
|
-
npm install --save-dev eslint-config-prettier eslint-plugin-prettier
|
|
138
|
-
```
|
|
139
|
-
|
|
140
|
-
**ESLint Configuration**:
|
|
141
|
-
|
|
142
|
-
```json
|
|
143
|
-
{
|
|
144
|
-
"extends": [
|
|
145
|
-
"eslint:recommended",
|
|
146
|
-
"plugin:prettier/recommended"
|
|
147
|
-
],
|
|
148
|
-
"plugins": ["prettier"],
|
|
149
|
-
"rules": {
|
|
150
|
-
"prettier/prettier": "error"
|
|
151
|
-
}
|
|
152
|
-
}
|
|
153
|
-
```
|
|
154
|
-
|
|
155
|
-
---
|
|
156
|
-
|
|
157
|
-
## CSS Linting
|
|
158
|
-
|
|
159
|
-
### Stylelint
|
|
160
|
-
|
|
161
|
-
**RECOMMENDED**: Use Stylelint for CSS linting:
|
|
162
|
-
|
|
163
|
-
```bash
|
|
164
|
-
# Install Stylelint
|
|
165
|
-
npm install --save-dev stylelint stylelint-config-standard
|
|
166
|
-
```
|
|
167
|
-
|
|
168
|
-
**Configuration** (`.stylelintrc.json`):
|
|
169
|
-
|
|
170
|
-
```json
|
|
171
|
-
{
|
|
172
|
-
"extends": "stylelint-config-standard",
|
|
173
|
-
"rules": {
|
|
174
|
-
"selector-class-pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$",
|
|
175
|
-
"max-nesting-depth": 3,
|
|
176
|
-
"no-descending-specificity": true,
|
|
177
|
-
"declaration-no-important": true,
|
|
178
|
-
"color-hex-length": "short",
|
|
179
|
-
"color-named": "never",
|
|
180
|
-
"font-family-name-quotes": "always-where-recommended",
|
|
181
|
-
"function-url-quotes": "always",
|
|
182
|
-
"number-leading-zero": "always",
|
|
183
|
-
"unit-allowed-list": ["px", "em", "rem", "%", "vh", "vw", "s", "ms", "deg"]
|
|
184
|
-
}
|
|
185
|
-
}
|
|
186
|
-
```
|
|
187
|
-
|
|
188
|
-
**Usage**:
|
|
189
|
-
|
|
190
|
-
```bash
|
|
191
|
-
# Lint CSS files
|
|
192
|
-
npx stylelint "src/**/*.css"
|
|
193
|
-
|
|
194
|
-
# Auto-fix issues
|
|
195
|
-
npx stylelint "src/**/*.css" --fix
|
|
196
|
-
```
|
|
197
|
-
|
|
198
|
-
---
|
|
199
|
-
|
|
200
|
-
## HTML Validation
|
|
201
|
-
|
|
202
|
-
### HTMLHint
|
|
203
|
-
|
|
204
|
-
**RECOMMENDED**: Use HTMLHint for HTML validation:
|
|
205
|
-
|
|
206
|
-
```bash
|
|
207
|
-
# Install HTMLHint
|
|
208
|
-
npm install --save-dev htmlhint
|
|
209
|
-
```
|
|
210
|
-
|
|
211
|
-
**Configuration** (`.htmlhintrc`):
|
|
212
|
-
|
|
213
|
-
```json
|
|
214
|
-
{
|
|
215
|
-
"tagname-lowercase": true,
|
|
216
|
-
"attr-lowercase": true,
|
|
217
|
-
"attr-value-double-quotes": true,
|
|
218
|
-
"doctype-first": true,
|
|
219
|
-
"tag-pair": true,
|
|
220
|
-
"spec-char-escape": true,
|
|
221
|
-
"id-unique": true,
|
|
222
|
-
"src-not-empty": true,
|
|
223
|
-
"attr-no-duplication": true,
|
|
224
|
-
"title-require": true,
|
|
225
|
-
"alt-require": true,
|
|
226
|
-
"doctype-html5": true,
|
|
227
|
-
"id-class-value": "dash",
|
|
228
|
-
"style-disabled": true,
|
|
229
|
-
"inline-style-disabled": true,
|
|
230
|
-
"inline-script-disabled": true,
|
|
231
|
-
"space-tab-mixed-disabled": "space",
|
|
232
|
-
"attr-unsafe-chars": true
|
|
233
|
-
}
|
|
234
|
-
```
|
|
235
|
-
|
|
236
|
-
**Usage**:
|
|
237
|
-
|
|
238
|
-
```bash
|
|
239
|
-
# Validate HTML files
|
|
240
|
-
npx htmlhint "src/**/*.html"
|
|
241
|
-
```
|
|
242
|
-
|
|
243
|
-
---
|
|
244
|
-
|
|
245
|
-
## Browser Compatibility
|
|
246
|
-
|
|
247
|
-
### Feature Detection
|
|
248
|
-
|
|
249
|
-
**RECOMMENDED**: Use feature detection instead of browser detection:
|
|
250
|
-
|
|
251
|
-
```javascript
|
|
252
|
-
// ✅ GOOD: Feature detection
|
|
253
|
-
if ('IntersectionObserver' in window) {
|
|
254
|
-
const observer = new IntersectionObserver(callback);
|
|
255
|
-
observer.observe(element);
|
|
256
|
-
} else {
|
|
257
|
-
// Fallback or polyfill
|
|
258
|
-
loadPolyfill();
|
|
259
|
-
}
|
|
260
|
-
|
|
261
|
-
// Check for CSS support
|
|
262
|
-
if (CSS.supports('display', 'grid')) {
|
|
263
|
-
element.classList.add('grid-layout');
|
|
264
|
-
} else {
|
|
265
|
-
element.classList.add('flexbox-layout');
|
|
266
|
-
}
|
|
267
|
-
|
|
268
|
-
// ❌ BAD: Browser detection
|
|
269
|
-
if (navigator.userAgent.includes('Chrome')) {
|
|
270
|
-
// Unreliable and fragile
|
|
271
|
-
}
|
|
272
|
-
```
|
|
273
|
-
|
|
274
|
-
### Polyfills
|
|
275
|
-
|
|
276
|
-
**RECOMMENDED**: Provide polyfills for unsupported features:
|
|
277
|
-
|
|
278
|
-
```javascript
|
|
279
|
-
// ✅ GOOD: Conditional polyfill loading
|
|
280
|
-
async function loadPolyfills() {
|
|
281
|
-
const polyfills = [];
|
|
282
|
-
|
|
283
|
-
if (!('fetch' in window)) {
|
|
284
|
-
polyfills.push(import('whatwg-fetch'));
|
|
285
|
-
}
|
|
286
|
-
|
|
287
|
-
if (!('Promise' in window)) {
|
|
288
|
-
polyfills.push(import('promise-polyfill'));
|
|
289
|
-
}
|
|
290
|
-
|
|
291
|
-
if (!('IntersectionObserver' in window)) {
|
|
292
|
-
polyfills.push(import('intersection-observer'));
|
|
293
|
-
}
|
|
294
|
-
|
|
295
|
-
await Promise.all(polyfills);
|
|
296
|
-
}
|
|
297
|
-
|
|
298
|
-
// Load polyfills before app initialization
|
|
299
|
-
loadPolyfills().then(() => {
|
|
300
|
-
initializeApp();
|
|
301
|
-
});
|
|
302
|
-
```
|
|
303
|
-
|
|
304
|
-
**Popular Polyfill Services**:
|
|
305
|
-
- [Polyfill.io](https://polyfill.io/) - Automatic polyfills based on user agent
|
|
306
|
-
- [core-js](https://github.com/zloirock/core-js) - Comprehensive polyfills
|
|
307
|
-
|
|
308
|
-
### Graceful Degradation
|
|
309
|
-
|
|
310
|
-
**RECOMMENDED**: Implement graceful degradation:
|
|
311
|
-
|
|
312
|
-
```javascript
|
|
313
|
-
// ✅ GOOD: Graceful degradation
|
|
314
|
-
function setupLazyLoading() {
|
|
315
|
-
if ('IntersectionObserver' in window) {
|
|
316
|
-
// Modern approach
|
|
317
|
-
const observer = new IntersectionObserver((entries) => {
|
|
318
|
-
entries.forEach(entry => {
|
|
319
|
-
if (entry.isIntersecting) {
|
|
320
|
-
loadImage(entry.target);
|
|
321
|
-
}
|
|
322
|
-
});
|
|
323
|
-
});
|
|
324
|
-
|
|
325
|
-
images.forEach(img => observer.observe(img));
|
|
326
|
-
} else {
|
|
327
|
-
// Fallback: Load all images immediately
|
|
328
|
-
images.forEach(img => loadImage(img));
|
|
329
|
-
}
|
|
330
|
-
}
|
|
331
|
-
```
|
|
332
|
-
|
|
333
|
-
### Progressive Enhancement
|
|
334
|
-
|
|
335
|
-
**RECOMMENDED**: Build with progressive enhancement:
|
|
336
|
-
|
|
337
|
-
```html
|
|
338
|
-
<!-- ✅ GOOD: Progressive enhancement -->
|
|
339
|
-
<!-- Base HTML works without JavaScript -->
|
|
340
|
-
<form action="/submit" method="post">
|
|
341
|
-
<input type="text" name="query" required>
|
|
342
|
-
<button type="submit">Search</button>
|
|
343
|
-
</form>
|
|
344
|
-
|
|
345
|
-
<script>
|
|
346
|
-
// Enhance with JavaScript
|
|
347
|
-
const form = document.querySelector('form');
|
|
348
|
-
form.addEventListener('submit', async (e) => {
|
|
349
|
-
e.preventDefault();
|
|
350
|
-
const formData = new FormData(form);
|
|
351
|
-
const results = await searchAPI(formData.get('query'));
|
|
352
|
-
displayResults(results);
|
|
353
|
-
});
|
|
354
|
-
</script>
|
|
355
|
-
```
|
|
356
|
-
|
|
357
|
-
### Autoprefixer
|
|
358
|
-
|
|
359
|
-
**RECOMMENDED**: Use Autoprefixer for vendor prefixes:
|
|
360
|
-
|
|
361
|
-
```bash
|
|
362
|
-
# Install Autoprefixer
|
|
363
|
-
npm install --save-dev autoprefixer postcss postcss-cli
|
|
364
|
-
```
|
|
365
|
-
|
|
366
|
-
**PostCSS Configuration** (`postcss.config.js`):
|
|
367
|
-
|
|
368
|
-
```javascript
|
|
369
|
-
module.exports = {
|
|
370
|
-
plugins: [
|
|
371
|
-
require('autoprefixer')({
|
|
372
|
-
overrideBrowserslist: [
|
|
373
|
-
'last 2 versions',
|
|
374
|
-
'> 1%',
|
|
375
|
-
'not dead'
|
|
376
|
-
]
|
|
377
|
-
})
|
|
378
|
-
]
|
|
379
|
-
};
|
|
380
|
-
```
|
|
381
|
-
|
|
382
|
-
**Usage**:
|
|
383
|
-
|
|
384
|
-
```bash
|
|
385
|
-
# Process CSS with Autoprefixer
|
|
386
|
-
npx postcss src/styles.css -o dist/styles.css
|
|
387
|
-
```
|
|
388
|
-
|
|
389
|
-
**Input**:
|
|
390
|
-
|
|
391
|
-
```css
|
|
392
|
-
.element {
|
|
393
|
-
display: flex;
|
|
394
|
-
user-select: none;
|
|
395
|
-
}
|
|
396
|
-
```
|
|
397
|
-
|
|
398
|
-
**Output**:
|
|
399
|
-
|
|
400
|
-
```css
|
|
401
|
-
.element {
|
|
402
|
-
display: -webkit-box;
|
|
403
|
-
display: -ms-flexbox;
|
|
404
|
-
display: flex;
|
|
405
|
-
-webkit-user-select: none;
|
|
406
|
-
-moz-user-select: none;
|
|
407
|
-
-ms-user-select: none;
|
|
408
|
-
user-select: none;
|
|
409
|
-
}
|
|
410
|
-
```
|
|
411
|
-
|
|
412
|
-
---
|
|
413
|
-
|
|
414
|
-
## Build Tools Integration
|
|
415
|
-
|
|
416
|
-
### Package.json Scripts
|
|
417
|
-
|
|
418
|
-
**RECOMMENDED**: Add scripts for common tasks:
|
|
419
|
-
|
|
420
|
-
```json
|
|
421
|
-
{
|
|
422
|
-
"scripts": {
|
|
423
|
-
"lint": "npm run lint:js && npm run lint:css && npm run lint:html",
|
|
424
|
-
"lint:js": "eslint 'src/**/*.js'",
|
|
425
|
-
"lint:css": "stylelint 'src/**/*.css'",
|
|
426
|
-
"lint:html": "htmlhint 'src/**/*.html'",
|
|
427
|
-
"format": "prettier --write 'src/**/*.{js,css,html}'",
|
|
428
|
-
"format:check": "prettier --check 'src/**/*.{js,css,html}'",
|
|
429
|
-
"fix": "npm run lint:js -- --fix && npm run lint:css -- --fix",
|
|
430
|
-
"validate": "npm run lint && npm run format:check"
|
|
431
|
-
}
|
|
432
|
-
}
|
|
433
|
-
```
|
|
434
|
-
|
|
435
|
-
### Pre-commit Hooks
|
|
436
|
-
|
|
437
|
-
**RECOMMENDED**: Use Husky and lint-staged for pre-commit hooks:
|
|
438
|
-
|
|
439
|
-
```bash
|
|
440
|
-
# Install Husky and lint-staged
|
|
441
|
-
npm install --save-dev husky lint-staged
|
|
442
|
-
npx husky install
|
|
443
|
-
```
|
|
444
|
-
|
|
445
|
-
**Package.json Configuration**:
|
|
446
|
-
|
|
447
|
-
```json
|
|
448
|
-
{
|
|
449
|
-
"lint-staged": {
|
|
450
|
-
"*.js": [
|
|
451
|
-
"eslint --fix",
|
|
452
|
-
"prettier --write"
|
|
453
|
-
],
|
|
454
|
-
"*.css": [
|
|
455
|
-
"stylelint --fix",
|
|
456
|
-
"prettier --write"
|
|
457
|
-
],
|
|
458
|
-
"*.html": [
|
|
459
|
-
"htmlhint",
|
|
460
|
-
"prettier --write"
|
|
461
|
-
]
|
|
462
|
-
}
|
|
463
|
-
}
|
|
464
|
-
```
|
|
465
|
-
|
|
466
|
-
**Husky Hook** (`.husky/pre-commit`):
|
|
467
|
-
|
|
468
|
-
```bash
|
|
469
|
-
#!/bin/sh
|
|
470
|
-
. "$(dirname "$0")/_/husky.sh"
|
|
471
|
-
|
|
472
|
-
npx lint-staged
|
|
473
|
-
```
|
|
474
|
-
|
|
475
|
-
---
|
|
476
|
-
|
|
477
|
-
## Editor Integration
|
|
478
|
-
|
|
479
|
-
### VS Code
|
|
480
|
-
|
|
481
|
-
**RECOMMENDED**: Configure VS Code for automatic linting and formatting:
|
|
482
|
-
|
|
483
|
-
**Extensions**:
|
|
484
|
-
- ESLint
|
|
485
|
-
- Prettier - Code formatter
|
|
486
|
-
- Stylelint
|
|
487
|
-
- HTMLHint
|
|
488
|
-
|
|
489
|
-
**Settings** (`.vscode/settings.json`):
|
|
490
|
-
|
|
491
|
-
```json
|
|
492
|
-
{
|
|
493
|
-
"editor.formatOnSave": true,
|
|
494
|
-
"editor.defaultFormatter": "esbenp.prettier-vscode",
|
|
495
|
-
"editor.codeActionsOnSave": {
|
|
496
|
-
"source.fixAll.eslint": true,
|
|
497
|
-
"source.fixAll.stylelint": true
|
|
498
|
-
},
|
|
499
|
-
"eslint.validate": [
|
|
500
|
-
"javascript",
|
|
501
|
-
"javascriptreact"
|
|
502
|
-
],
|
|
503
|
-
"stylelint.validate": [
|
|
504
|
-
"css",
|
|
505
|
-
"scss"
|
|
506
|
-
]
|
|
507
|
-
}
|
|
508
|
-
```
|
|
509
|
-
|
|
510
|
-
---
|
|
511
|
-
|
|
512
|
-
## Summary
|
|
513
|
-
|
|
514
|
-
**Key Tools**:
|
|
515
|
-
|
|
516
|
-
1. **ESLint** - JavaScript linting
|
|
517
|
-
2. **Prettier** - Code formatting
|
|
518
|
-
3. **Stylelint** - CSS linting
|
|
519
|
-
4. **HTMLHint** - HTML validation
|
|
520
|
-
5. **Autoprefixer** - Vendor prefixes
|
|
521
|
-
6. **Husky + lint-staged** - Pre-commit hooks
|
|
522
|
-
|
|
523
|
-
**Best Practices**:
|
|
524
|
-
|
|
525
|
-
1. Use **feature detection** over browser detection
|
|
526
|
-
2. Provide **polyfills** for unsupported features
|
|
527
|
-
3. Implement **graceful degradation**
|
|
528
|
-
4. Build with **progressive enhancement**
|
|
529
|
-
5. Use **Autoprefixer** for vendor prefixes
|
|
530
|
-
6. Set up **pre-commit hooks** for code quality
|
|
531
|
-
7. Configure **editor integration** for automatic fixes
|
|
532
|
-
8. Run **validation** in CI/CD pipeline
|
|
533
|
-
|
|
534
|
-
**Workflow**:
|
|
535
|
-
|
|
536
|
-
1. Write code
|
|
537
|
-
2. Editor auto-formats on save (Prettier)
|
|
538
|
-
3. Editor shows linting errors (ESLint, Stylelint)
|
|
539
|
-
4. Pre-commit hook validates and fixes code
|
|
540
|
-
5. CI/CD runs full validation
|
|
541
|
-
|
|
542
|
-
|
|
543
|
-
|
|
1
|
+
# Tooling and Code Quality
|
|
2
|
+
|
|
3
|
+
## Overview
|
|
4
|
+
|
|
5
|
+
This guide provides recommendations for linting, formatting, and browser compatibility tools to maintain code quality in HTML, CSS, and JavaScript projects.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## JavaScript Linting
|
|
10
|
+
|
|
11
|
+
### ESLint
|
|
12
|
+
|
|
13
|
+
**RECOMMENDED**: Use ESLint for JavaScript linting:
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
# Install ESLint
|
|
17
|
+
npm install --save-dev eslint
|
|
18
|
+
|
|
19
|
+
# Initialize configuration
|
|
20
|
+
npx eslint --init
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
**Configuration** (`.eslintrc.json`):
|
|
24
|
+
|
|
25
|
+
```json
|
|
26
|
+
{
|
|
27
|
+
"env": {
|
|
28
|
+
"browser": true,
|
|
29
|
+
"es2021": true
|
|
30
|
+
},
|
|
31
|
+
"extends": "eslint:recommended",
|
|
32
|
+
"parserOptions": {
|
|
33
|
+
"ecmaVersion": "latest",
|
|
34
|
+
"sourceType": "module"
|
|
35
|
+
},
|
|
36
|
+
"rules": {
|
|
37
|
+
"no-var": "error",
|
|
38
|
+
"prefer-const": "error",
|
|
39
|
+
"prefer-arrow-callback": "warn",
|
|
40
|
+
"no-console": "warn",
|
|
41
|
+
"eqeqeq": ["error", "always"],
|
|
42
|
+
"curly": ["error", "all"],
|
|
43
|
+
"no-unused-vars": ["error", { "argsIgnorePattern": "^_" }]
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
**Usage**:
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
# Lint files
|
|
52
|
+
npx eslint src/**/*.js
|
|
53
|
+
|
|
54
|
+
# Auto-fix issues
|
|
55
|
+
npx eslint src/**/*.js --fix
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
### Recommended ESLint Rules
|
|
59
|
+
|
|
60
|
+
```json
|
|
61
|
+
{
|
|
62
|
+
"rules": {
|
|
63
|
+
// Variables
|
|
64
|
+
"no-var": "error",
|
|
65
|
+
"prefer-const": "error",
|
|
66
|
+
"no-unused-vars": "error",
|
|
67
|
+
|
|
68
|
+
// Best Practices
|
|
69
|
+
"eqeqeq": ["error", "always"],
|
|
70
|
+
"no-eval": "error",
|
|
71
|
+
"no-implied-eval": "error",
|
|
72
|
+
"no-with": "error",
|
|
73
|
+
|
|
74
|
+
// ES6+
|
|
75
|
+
"prefer-arrow-callback": "warn",
|
|
76
|
+
"prefer-template": "warn",
|
|
77
|
+
"prefer-destructuring": "warn",
|
|
78
|
+
"object-shorthand": "warn",
|
|
79
|
+
|
|
80
|
+
// Style
|
|
81
|
+
"curly": ["error", "all"],
|
|
82
|
+
"brace-style": ["error", "1tbs"],
|
|
83
|
+
"comma-dangle": ["error", "never"],
|
|
84
|
+
"quotes": ["error", "single"],
|
|
85
|
+
"semi": ["error", "always"]
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
---
|
|
91
|
+
|
|
92
|
+
## Code Formatting
|
|
93
|
+
|
|
94
|
+
### Prettier
|
|
95
|
+
|
|
96
|
+
**RECOMMENDED**: Use Prettier for consistent code formatting:
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
# Install Prettier
|
|
100
|
+
npm install --save-dev prettier
|
|
101
|
+
|
|
102
|
+
# Create configuration
|
|
103
|
+
echo {} > .prettierrc.json
|
|
104
|
+
```
|
|
105
|
+
|
|
106
|
+
**Configuration** (`.prettierrc.json`):
|
|
107
|
+
|
|
108
|
+
```json
|
|
109
|
+
{
|
|
110
|
+
"semi": true,
|
|
111
|
+
"singleQuote": true,
|
|
112
|
+
"tabWidth": 2,
|
|
113
|
+
"useTabs": false,
|
|
114
|
+
"trailingComma": "es5",
|
|
115
|
+
"printWidth": 80,
|
|
116
|
+
"arrowParens": "avoid",
|
|
117
|
+
"endOfLine": "lf"
|
|
118
|
+
}
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
**Usage**:
|
|
122
|
+
|
|
123
|
+
```bash
|
|
124
|
+
# Format files
|
|
125
|
+
npx prettier --write "src/**/*.{js,css,html}"
|
|
126
|
+
|
|
127
|
+
# Check formatting
|
|
128
|
+
npx prettier --check "src/**/*.{js,css,html}"
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
### Prettier + ESLint Integration
|
|
132
|
+
|
|
133
|
+
**RECOMMENDED**: Integrate Prettier with ESLint:
|
|
134
|
+
|
|
135
|
+
```bash
|
|
136
|
+
# Install integration packages
|
|
137
|
+
npm install --save-dev eslint-config-prettier eslint-plugin-prettier
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
**ESLint Configuration**:
|
|
141
|
+
|
|
142
|
+
```json
|
|
143
|
+
{
|
|
144
|
+
"extends": [
|
|
145
|
+
"eslint:recommended",
|
|
146
|
+
"plugin:prettier/recommended"
|
|
147
|
+
],
|
|
148
|
+
"plugins": ["prettier"],
|
|
149
|
+
"rules": {
|
|
150
|
+
"prettier/prettier": "error"
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
---
|
|
156
|
+
|
|
157
|
+
## CSS Linting
|
|
158
|
+
|
|
159
|
+
### Stylelint
|
|
160
|
+
|
|
161
|
+
**RECOMMENDED**: Use Stylelint for CSS linting:
|
|
162
|
+
|
|
163
|
+
```bash
|
|
164
|
+
# Install Stylelint
|
|
165
|
+
npm install --save-dev stylelint stylelint-config-standard
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
**Configuration** (`.stylelintrc.json`):
|
|
169
|
+
|
|
170
|
+
```json
|
|
171
|
+
{
|
|
172
|
+
"extends": "stylelint-config-standard",
|
|
173
|
+
"rules": {
|
|
174
|
+
"selector-class-pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$",
|
|
175
|
+
"max-nesting-depth": 3,
|
|
176
|
+
"no-descending-specificity": true,
|
|
177
|
+
"declaration-no-important": true,
|
|
178
|
+
"color-hex-length": "short",
|
|
179
|
+
"color-named": "never",
|
|
180
|
+
"font-family-name-quotes": "always-where-recommended",
|
|
181
|
+
"function-url-quotes": "always",
|
|
182
|
+
"number-leading-zero": "always",
|
|
183
|
+
"unit-allowed-list": ["px", "em", "rem", "%", "vh", "vw", "s", "ms", "deg"]
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
```
|
|
187
|
+
|
|
188
|
+
**Usage**:
|
|
189
|
+
|
|
190
|
+
```bash
|
|
191
|
+
# Lint CSS files
|
|
192
|
+
npx stylelint "src/**/*.css"
|
|
193
|
+
|
|
194
|
+
# Auto-fix issues
|
|
195
|
+
npx stylelint "src/**/*.css" --fix
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
---
|
|
199
|
+
|
|
200
|
+
## HTML Validation
|
|
201
|
+
|
|
202
|
+
### HTMLHint
|
|
203
|
+
|
|
204
|
+
**RECOMMENDED**: Use HTMLHint for HTML validation:
|
|
205
|
+
|
|
206
|
+
```bash
|
|
207
|
+
# Install HTMLHint
|
|
208
|
+
npm install --save-dev htmlhint
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
**Configuration** (`.htmlhintrc`):
|
|
212
|
+
|
|
213
|
+
```json
|
|
214
|
+
{
|
|
215
|
+
"tagname-lowercase": true,
|
|
216
|
+
"attr-lowercase": true,
|
|
217
|
+
"attr-value-double-quotes": true,
|
|
218
|
+
"doctype-first": true,
|
|
219
|
+
"tag-pair": true,
|
|
220
|
+
"spec-char-escape": true,
|
|
221
|
+
"id-unique": true,
|
|
222
|
+
"src-not-empty": true,
|
|
223
|
+
"attr-no-duplication": true,
|
|
224
|
+
"title-require": true,
|
|
225
|
+
"alt-require": true,
|
|
226
|
+
"doctype-html5": true,
|
|
227
|
+
"id-class-value": "dash",
|
|
228
|
+
"style-disabled": true,
|
|
229
|
+
"inline-style-disabled": true,
|
|
230
|
+
"inline-script-disabled": true,
|
|
231
|
+
"space-tab-mixed-disabled": "space",
|
|
232
|
+
"attr-unsafe-chars": true
|
|
233
|
+
}
|
|
234
|
+
```
|
|
235
|
+
|
|
236
|
+
**Usage**:
|
|
237
|
+
|
|
238
|
+
```bash
|
|
239
|
+
# Validate HTML files
|
|
240
|
+
npx htmlhint "src/**/*.html"
|
|
241
|
+
```
|
|
242
|
+
|
|
243
|
+
---
|
|
244
|
+
|
|
245
|
+
## Browser Compatibility
|
|
246
|
+
|
|
247
|
+
### Feature Detection
|
|
248
|
+
|
|
249
|
+
**RECOMMENDED**: Use feature detection instead of browser detection:
|
|
250
|
+
|
|
251
|
+
```javascript
|
|
252
|
+
// ✅ GOOD: Feature detection
|
|
253
|
+
if ('IntersectionObserver' in window) {
|
|
254
|
+
const observer = new IntersectionObserver(callback);
|
|
255
|
+
observer.observe(element);
|
|
256
|
+
} else {
|
|
257
|
+
// Fallback or polyfill
|
|
258
|
+
loadPolyfill();
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
// Check for CSS support
|
|
262
|
+
if (CSS.supports('display', 'grid')) {
|
|
263
|
+
element.classList.add('grid-layout');
|
|
264
|
+
} else {
|
|
265
|
+
element.classList.add('flexbox-layout');
|
|
266
|
+
}
|
|
267
|
+
|
|
268
|
+
// ❌ BAD: Browser detection
|
|
269
|
+
if (navigator.userAgent.includes('Chrome')) {
|
|
270
|
+
// Unreliable and fragile
|
|
271
|
+
}
|
|
272
|
+
```
|
|
273
|
+
|
|
274
|
+
### Polyfills
|
|
275
|
+
|
|
276
|
+
**RECOMMENDED**: Provide polyfills for unsupported features:
|
|
277
|
+
|
|
278
|
+
```javascript
|
|
279
|
+
// ✅ GOOD: Conditional polyfill loading
|
|
280
|
+
async function loadPolyfills() {
|
|
281
|
+
const polyfills = [];
|
|
282
|
+
|
|
283
|
+
if (!('fetch' in window)) {
|
|
284
|
+
polyfills.push(import('whatwg-fetch'));
|
|
285
|
+
}
|
|
286
|
+
|
|
287
|
+
if (!('Promise' in window)) {
|
|
288
|
+
polyfills.push(import('promise-polyfill'));
|
|
289
|
+
}
|
|
290
|
+
|
|
291
|
+
if (!('IntersectionObserver' in window)) {
|
|
292
|
+
polyfills.push(import('intersection-observer'));
|
|
293
|
+
}
|
|
294
|
+
|
|
295
|
+
await Promise.all(polyfills);
|
|
296
|
+
}
|
|
297
|
+
|
|
298
|
+
// Load polyfills before app initialization
|
|
299
|
+
loadPolyfills().then(() => {
|
|
300
|
+
initializeApp();
|
|
301
|
+
});
|
|
302
|
+
```
|
|
303
|
+
|
|
304
|
+
**Popular Polyfill Services**:
|
|
305
|
+
- [Polyfill.io](https://polyfill.io/) - Automatic polyfills based on user agent
|
|
306
|
+
- [core-js](https://github.com/zloirock/core-js) - Comprehensive polyfills
|
|
307
|
+
|
|
308
|
+
### Graceful Degradation
|
|
309
|
+
|
|
310
|
+
**RECOMMENDED**: Implement graceful degradation:
|
|
311
|
+
|
|
312
|
+
```javascript
|
|
313
|
+
// ✅ GOOD: Graceful degradation
|
|
314
|
+
function setupLazyLoading() {
|
|
315
|
+
if ('IntersectionObserver' in window) {
|
|
316
|
+
// Modern approach
|
|
317
|
+
const observer = new IntersectionObserver((entries) => {
|
|
318
|
+
entries.forEach(entry => {
|
|
319
|
+
if (entry.isIntersecting) {
|
|
320
|
+
loadImage(entry.target);
|
|
321
|
+
}
|
|
322
|
+
});
|
|
323
|
+
});
|
|
324
|
+
|
|
325
|
+
images.forEach(img => observer.observe(img));
|
|
326
|
+
} else {
|
|
327
|
+
// Fallback: Load all images immediately
|
|
328
|
+
images.forEach(img => loadImage(img));
|
|
329
|
+
}
|
|
330
|
+
}
|
|
331
|
+
```
|
|
332
|
+
|
|
333
|
+
### Progressive Enhancement
|
|
334
|
+
|
|
335
|
+
**RECOMMENDED**: Build with progressive enhancement:
|
|
336
|
+
|
|
337
|
+
```html
|
|
338
|
+
<!-- ✅ GOOD: Progressive enhancement -->
|
|
339
|
+
<!-- Base HTML works without JavaScript -->
|
|
340
|
+
<form action="/submit" method="post">
|
|
341
|
+
<input type="text" name="query" required>
|
|
342
|
+
<button type="submit">Search</button>
|
|
343
|
+
</form>
|
|
344
|
+
|
|
345
|
+
<script>
|
|
346
|
+
// Enhance with JavaScript
|
|
347
|
+
const form = document.querySelector('form');
|
|
348
|
+
form.addEventListener('submit', async (e) => {
|
|
349
|
+
e.preventDefault();
|
|
350
|
+
const formData = new FormData(form);
|
|
351
|
+
const results = await searchAPI(formData.get('query'));
|
|
352
|
+
displayResults(results);
|
|
353
|
+
});
|
|
354
|
+
</script>
|
|
355
|
+
```
|
|
356
|
+
|
|
357
|
+
### Autoprefixer
|
|
358
|
+
|
|
359
|
+
**RECOMMENDED**: Use Autoprefixer for vendor prefixes:
|
|
360
|
+
|
|
361
|
+
```bash
|
|
362
|
+
# Install Autoprefixer
|
|
363
|
+
npm install --save-dev autoprefixer postcss postcss-cli
|
|
364
|
+
```
|
|
365
|
+
|
|
366
|
+
**PostCSS Configuration** (`postcss.config.js`):
|
|
367
|
+
|
|
368
|
+
```javascript
|
|
369
|
+
module.exports = {
|
|
370
|
+
plugins: [
|
|
371
|
+
require('autoprefixer')({
|
|
372
|
+
overrideBrowserslist: [
|
|
373
|
+
'last 2 versions',
|
|
374
|
+
'> 1%',
|
|
375
|
+
'not dead'
|
|
376
|
+
]
|
|
377
|
+
})
|
|
378
|
+
]
|
|
379
|
+
};
|
|
380
|
+
```
|
|
381
|
+
|
|
382
|
+
**Usage**:
|
|
383
|
+
|
|
384
|
+
```bash
|
|
385
|
+
# Process CSS with Autoprefixer
|
|
386
|
+
npx postcss src/styles.css -o dist/styles.css
|
|
387
|
+
```
|
|
388
|
+
|
|
389
|
+
**Input**:
|
|
390
|
+
|
|
391
|
+
```css
|
|
392
|
+
.element {
|
|
393
|
+
display: flex;
|
|
394
|
+
user-select: none;
|
|
395
|
+
}
|
|
396
|
+
```
|
|
397
|
+
|
|
398
|
+
**Output**:
|
|
399
|
+
|
|
400
|
+
```css
|
|
401
|
+
.element {
|
|
402
|
+
display: -webkit-box;
|
|
403
|
+
display: -ms-flexbox;
|
|
404
|
+
display: flex;
|
|
405
|
+
-webkit-user-select: none;
|
|
406
|
+
-moz-user-select: none;
|
|
407
|
+
-ms-user-select: none;
|
|
408
|
+
user-select: none;
|
|
409
|
+
}
|
|
410
|
+
```
|
|
411
|
+
|
|
412
|
+
---
|
|
413
|
+
|
|
414
|
+
## Build Tools Integration
|
|
415
|
+
|
|
416
|
+
### Package.json Scripts
|
|
417
|
+
|
|
418
|
+
**RECOMMENDED**: Add scripts for common tasks:
|
|
419
|
+
|
|
420
|
+
```json
|
|
421
|
+
{
|
|
422
|
+
"scripts": {
|
|
423
|
+
"lint": "npm run lint:js && npm run lint:css && npm run lint:html",
|
|
424
|
+
"lint:js": "eslint 'src/**/*.js'",
|
|
425
|
+
"lint:css": "stylelint 'src/**/*.css'",
|
|
426
|
+
"lint:html": "htmlhint 'src/**/*.html'",
|
|
427
|
+
"format": "prettier --write 'src/**/*.{js,css,html}'",
|
|
428
|
+
"format:check": "prettier --check 'src/**/*.{js,css,html}'",
|
|
429
|
+
"fix": "npm run lint:js -- --fix && npm run lint:css -- --fix",
|
|
430
|
+
"validate": "npm run lint && npm run format:check"
|
|
431
|
+
}
|
|
432
|
+
}
|
|
433
|
+
```
|
|
434
|
+
|
|
435
|
+
### Pre-commit Hooks
|
|
436
|
+
|
|
437
|
+
**RECOMMENDED**: Use Husky and lint-staged for pre-commit hooks:
|
|
438
|
+
|
|
439
|
+
```bash
|
|
440
|
+
# Install Husky and lint-staged
|
|
441
|
+
npm install --save-dev husky lint-staged
|
|
442
|
+
npx husky install
|
|
443
|
+
```
|
|
444
|
+
|
|
445
|
+
**Package.json Configuration**:
|
|
446
|
+
|
|
447
|
+
```json
|
|
448
|
+
{
|
|
449
|
+
"lint-staged": {
|
|
450
|
+
"*.js": [
|
|
451
|
+
"eslint --fix",
|
|
452
|
+
"prettier --write"
|
|
453
|
+
],
|
|
454
|
+
"*.css": [
|
|
455
|
+
"stylelint --fix",
|
|
456
|
+
"prettier --write"
|
|
457
|
+
],
|
|
458
|
+
"*.html": [
|
|
459
|
+
"htmlhint",
|
|
460
|
+
"prettier --write"
|
|
461
|
+
]
|
|
462
|
+
}
|
|
463
|
+
}
|
|
464
|
+
```
|
|
465
|
+
|
|
466
|
+
**Husky Hook** (`.husky/pre-commit`):
|
|
467
|
+
|
|
468
|
+
```bash
|
|
469
|
+
#!/bin/sh
|
|
470
|
+
. "$(dirname "$0")/_/husky.sh"
|
|
471
|
+
|
|
472
|
+
npx lint-staged
|
|
473
|
+
```
|
|
474
|
+
|
|
475
|
+
---
|
|
476
|
+
|
|
477
|
+
## Editor Integration
|
|
478
|
+
|
|
479
|
+
### VS Code
|
|
480
|
+
|
|
481
|
+
**RECOMMENDED**: Configure VS Code for automatic linting and formatting:
|
|
482
|
+
|
|
483
|
+
**Extensions**:
|
|
484
|
+
- ESLint
|
|
485
|
+
- Prettier - Code formatter
|
|
486
|
+
- Stylelint
|
|
487
|
+
- HTMLHint
|
|
488
|
+
|
|
489
|
+
**Settings** (`.vscode/settings.json`):
|
|
490
|
+
|
|
491
|
+
```json
|
|
492
|
+
{
|
|
493
|
+
"editor.formatOnSave": true,
|
|
494
|
+
"editor.defaultFormatter": "esbenp.prettier-vscode",
|
|
495
|
+
"editor.codeActionsOnSave": {
|
|
496
|
+
"source.fixAll.eslint": true,
|
|
497
|
+
"source.fixAll.stylelint": true
|
|
498
|
+
},
|
|
499
|
+
"eslint.validate": [
|
|
500
|
+
"javascript",
|
|
501
|
+
"javascriptreact"
|
|
502
|
+
],
|
|
503
|
+
"stylelint.validate": [
|
|
504
|
+
"css",
|
|
505
|
+
"scss"
|
|
506
|
+
]
|
|
507
|
+
}
|
|
508
|
+
```
|
|
509
|
+
|
|
510
|
+
---
|
|
511
|
+
|
|
512
|
+
## Summary
|
|
513
|
+
|
|
514
|
+
**Key Tools**:
|
|
515
|
+
|
|
516
|
+
1. **ESLint** - JavaScript linting
|
|
517
|
+
2. **Prettier** - Code formatting
|
|
518
|
+
3. **Stylelint** - CSS linting
|
|
519
|
+
4. **HTMLHint** - HTML validation
|
|
520
|
+
5. **Autoprefixer** - Vendor prefixes
|
|
521
|
+
6. **Husky + lint-staged** - Pre-commit hooks
|
|
522
|
+
|
|
523
|
+
**Best Practices**:
|
|
524
|
+
|
|
525
|
+
1. Use **feature detection** over browser detection
|
|
526
|
+
2. Provide **polyfills** for unsupported features
|
|
527
|
+
3. Implement **graceful degradation**
|
|
528
|
+
4. Build with **progressive enhancement**
|
|
529
|
+
5. Use **Autoprefixer** for vendor prefixes
|
|
530
|
+
6. Set up **pre-commit hooks** for code quality
|
|
531
|
+
7. Configure **editor integration** for automatic fixes
|
|
532
|
+
8. Run **validation** in CI/CD pipeline
|
|
533
|
+
|
|
534
|
+
**Workflow**:
|
|
535
|
+
|
|
536
|
+
1. Write code
|
|
537
|
+
2. Editor auto-formats on save (Prettier)
|
|
538
|
+
3. Editor shows linting errors (ESLint, Stylelint)
|
|
539
|
+
4. Pre-commit hook validates and fixes code
|
|
540
|
+
5. CI/CD runs full validation
|
|
541
|
+
|
|
542
|
+
|
|
543
|
+
|