================================================================================
AUTO FORM BUILDER - SOURCE CODE DOCUMENTATION
WordPress.org Plugin Guidelines Compliance (Section 4 - Human Readable Code)
================================================================================

IMPORTANT FOR WORDPRESS.ORG REVIEWERS:
This file documents all compiled/minified code and their source locations.

NOTE: The plugin distribution includes:
- /src/ directory (React source code)
- /src-assets/ directory (standalone source files)
- vite.config.js (build configuration)
- package.json (dependencies list)
- This SOURCE-CODE.txt file

The node_modules/ directory is excluded (too large) but can be rebuilt with:
$ npm install

================================================================================
COMPILED/MINIFIED FILES & THEIR SOURCES
================================================================================

1. REACT FORM BUILDER (Compiled with Vite 4.4.5)
   -----------------------------------------------
   Compiled Files:
   - /dist/js/main.js (minified, CSS inlined into JS bundle)
   
   Source Code Location:
   - /src/ directory (40+ React JSX files, fully human-readable)
     - /src/main.jsx - Entry point
     - /src/App.jsx - Main application
     - /src/components/ - All React components
     - /src/store/ - State management (Zustand)
     - /src/styles/ - 18 CSS files
     - /src/utils/ - Utility functions
     - /src/hooks/ - Custom React hooks
   
   Build Configuration:
   - vite.config.js (plugin root directory)
   - package.json (plugin root directory)
   
   Build Commands:
   $ npm install          # Install dependencies
   $ npm run build        # Build for production → outputs to /dist/
   $ npm run dev          # Development server with hot reload
   
   Node.js Version Required: v14 or higher

2. STANDALONE JAVASCRIPT/CSS (Not Compiled - Direct Copy)
   --------------------------------------------------------
   These files are copied directly from source to dist (identical):
   
   - /dist/js/custom-date-picker-frontend.js
     Source: /src-assets/js/custom-date-picker-frontend.js (280 lines)
   
   - /dist/css/custom-date-picker-frontend.css
     Source: /src-assets/css/custom-date-picker-frontend.css
   
   - /dist/css/modern-file-upload.css
     Source: /src-assets/css/modern-file-upload.css
   
   See: /src-assets/README.md for more details

3. THIRD-PARTY LIBRARIES (External, Already Minified)
   ----------------------------------------------------
   Flatpickr v4.6.13 (MIT License) - Date Picker Library
   
   Plugin Files:
   - assets/js/vendor/flatpickr.min.js
   - assets/css/vendor/flatpickr.min.css
   - assets/css/vendor/flatpickr-material-blue.css
   
   Original Source Code:
   - GitHub: https://github.com/flatpickr/flatpickr
   - Unminified Source: https://github.com/flatpickr/flatpickr/tree/master/src
   - License: https://github.com/flatpickr/flatpickr/blob/master/LICENSE.md
   
   React & Dependencies (Bundled in /dist/js/main.js via npm):
   - React 18.2.0: https://github.com/facebook/react (MIT)
   - React DOM 18.2.0: https://github.com/facebook/react (MIT)
   - @dnd-kit: https://github.com/clauderic/dnd-kit (MIT)
   - Zustand: https://github.com/pmndrs/zustand (MIT)
   - Immer: https://github.com/immerjs/immer (MIT)
   
   All npm dependencies with exact versions: package.json

================================================================================
HUMAN-READABLE (NON-COMPILED) FILES
================================================================================

All other JavaScript and CSS files are human-readable source code:

1. JavaScript Files (31 files):
   - /assets/js/admin/ (14 files) - Admin interface scripts
   - /assets/js/form/ (14 files) - Form functionality
   - /assets/js/frontend/ (3 files) - Frontend scripts

2. CSS Files (37 files):
   - /assets/css/admin/ (13 files) - Admin styles
   - /assets/css/form/ (22 files) - Form and field styles
   - /assets/css/frontend/ (2 files) - Frontend styles

3. PHP Files (30+ files):
   - /includes/ - All plugin PHP classes
   - /assets/ - PHP templates
   - auto-form-builder.php - Main plugin file

TOTAL: 68 human-readable JavaScript/CSS files + 30+ PHP files

================================================================================
COMPLIANCE SUMMARY
================================================================================

✓ All compiled code has source included in plugin
✓ All build tools documented with complete instructions
✓ All third-party libraries documented with GitHub source links
✓ Build process documented and reproducible
✓ No obfuscation beyond standard minification
✓ Complete transparency - nothing hidden

STATUS: FULLY COMPLIANT with WordPress.org Plugin Guidelines Section 4

================================================================================
QUICK REFERENCE
================================================================================

Q: Where is the source code for /dist/js/main.js?
A: /src/ directory (40+ React JSX files)

Q: How do I rebuild the compiled files?
A: Run: npm install && npm run build

Q: Where are the build instructions?
A: This file, readme.txt, and vite.config.js

Q: Are there any hidden/obfuscated files?
A: No. All source code is included and documented.

Q: Where can I find third-party library sources?
A: See "Third-Party Libraries" section above with GitHub links

================================================================================

For more details, see:
- readme.txt (WordPress.org standard readme with detailed documentation)
- README.md (Developer documentation)
- /src-assets/README.md (Standalone assets documentation)
- vite.config.js (Build configuration)
- package.json (Dependencies)

================================================================================
Last Updated: April 15, 2026
Plugin Version: 1.2.0
================================================================================

