@dragonmastery/zinia-forms-core 0.3.0

package/LICENSE

@@ -0,0 +1,75 @@
+ZINIA FORMS EVALUATION LICENSE
+
+Copyright (c) 2025 DragonMastery. All rights reserved.
+
+================================================================================
+
+NOTICE: This software and associated documentation files (the "Software") are
+proprietary to DragonMastery.
+
+GRANT OF EVALUATION LICENSE:
+
+DragonMastery grants you a limited, non-exclusive, non-transferable, revocable
+license to:
+
+1. EVALUATION USE: Download and use the Software for evaluation and testing
+   purposes in non-production environments only.
+
+2. DEVELOPMENT USE: Use the Software in local development environments for
+   proof-of-concept and evaluation purposes only.
+
+3. INSPECTION: View and study the source code for evaluation purposes only.
+
+RESTRICTIONS:
+
+Without a separate commercial license from DragonMastery, you may NOT:
+
+1. Use the Software in any production environment or live application
+2. Use the Software in any commercial capacity or revenue-generating service
+3. Modify, adapt, or create derivative works based on the Software
+4. Redistribute, sublicense, sell, rent, lease, or transfer the Software
+5. Remove or alter any copyright, trademark, or proprietary notices
+6. Use the Software to develop competing products or services
+7. Provide access to the Software to third parties for their use
+
+PRODUCTION & COMMERCIAL LICENSE:
+
+To use this Software in production environments or for commercial purposes, you
+MUST obtain a separate commercial license from DragonMastery.
+
+Contact for licensing:
+
+- Repository: https://github.com/DragonMastery/zinia-forms
+- Open a GitHub issue for licensing inquiries
+
+TERMINATION:
+
+This License is effective until terminated. Your rights under this License
+terminate automatically without notice if you fail to comply with any term. Upon
+termination, you must immediately cease all use and destroy all copies of the
+Software.
+
+DISCLAIMER OF WARRANTY:
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. DRAGONMASTERY MAKES NO WARRANTY
+THAT THE SOFTWARE WILL BE ERROR-FREE OR UNINTERRUPTED.
+
+LIMITATION OF LIABILITY:
+
+IN NO EVENT SHALL DRAGONMASTERY BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
+OF SUCH DAMAGE.
+
+ACKNOWLEDGMENT:
+
+By downloading, installing, or using the Software, you acknowledge that you have
+read this License, understand it, and agree to be bound by its terms and
+conditions.
+
+================================================================================

package/README.md

@@ -0,0 +1,108 @@
+# Zinia Forms
+
+A modern, type-safe form system for Vue 3 applications powered by:
+
+- **Zod**: TypeScript-first schema validation
+- **Vue 3**: Reactivity and component architecture
+- **TypeScript**: End-to-end type safety
+- **DaisyUI v5**: Beautiful UI components for Tailwind CSS v4
+
+## 🌟 Key Features
+
+- **Complete Type Safety**: Leverages TypeScript and Zod for end-to-end type
+  safety
+- **Schema-Driven Forms**: Generate forms automatically from Zod schemas
+- **Rich Field Types**: Support for all standard form fields plus custom
+  components
+- **Component Generation**: Automatically generates typed components for each
+  field
+- **Metadata Registry**: Enhance schemas with UI metadata for fine-grained
+  control
+- **Style Flexibility**: Plugin-based style system with built-in DaisyUI and
+  minimal styling options
+- **Nested Forms**: Handle complex nested data structures with ease
+- **Form State Management**: Built-in validation, error handling, and form state
+- **Smart Form Persistence**: Intelligent merging of server and local data
+- **Automatic Data Loading**: Built-in data fetching with loading states
+- **Reactive Loading States**: Track loading, errors, and form readiness
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+# Install Zinia Forms and its peer dependencies
+npm install zinia-forms zod vue@3 pinia
+
+# Install UI dependencies (optional, but recommended for beautiful forms)
+npm install tailwindcss@latest daisyui@latest
+```
+
+### Basic Usage
+
+```typescript
+import { z } from "zod";
+import { useForm } from "zinia-forms";
+
+// Define your schema
+const loginSchema = z.object({
+  email: z.string().email("Please enter a valid email address"),
+  password: z.string().min(8, "Password must be at least 8 characters"),
+});
+
+// Use in your component
+const { form, ZiniaForm, zinia, ZiniaSubmitButton } = useForm(loginSchema);
+
+const handleSubmit = async (data) => {
+  console.log("Form data:", data);
+};
+```
+
+```vue
+<template>
+  <ZiniaForm :handleSubmit="handleSubmit">
+    <zinia.EmailField label="Email Address" />
+    <zinia.PasswordField label="Password" />
+    <ZiniaSubmitButton submitText="Login" />
+  </ZiniaForm>
+</template>
+```
+
+## 📚 Documentation
+
+For complete documentation, examples, and guides, visit the
+[GitHub repository](https://github.com/DragonMastery/zinia-forms).
+
+## ⚖️ License
+
+**PROPRIETARY - Evaluation Use Only**
+
+This software is proprietary and confidential. This package is provided for:
+
+- ✅ Evaluation and testing in non-production environments
+- ✅ Local development and proof-of-concept work
+
+**❌ Production use is NOT permitted without a commercial license.**
+
+### To Use in Production:
+
+You must obtain a commercial license from DragonMastery.
+
+**Contact for licensing:**
+
+- Visit: https://github.com/DragonMastery/zinia-forms
+- Open an issue for licensing inquiries
+
+### License Restrictions:
+
+Without a commercial license, you may NOT:
+
+- Use this software in production environments
+- Use this software in commercial applications
+- Redistribute or share the software
+
+See the [LICENSE](./LICENSE) file for complete terms and conditions.
+
+---
+
+© 2025 DragonMastery. All rights reserved.