@squaredr/fieldcraft-pro 1.7.0 → 1.8.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/LICENSE.txt CHANGED
@@ -1,51 +1,51 @@
1
- SquaredR Commercial License
2
-
3
- Copyright (c) 2024-2026 SquaredR. All rights reserved.
4
-
5
- This software and associated documentation files (the "Software") are the
6
- proprietary property of SquaredR.
7
-
8
- GRANT OF LICENSE
9
-
10
- Subject to the terms of this license and payment of applicable fees, SquaredR
11
- grants you a non-exclusive, non-transferable license to:
12
-
13
- 1. Use the Software in a single production application per license key.
14
- 2. Modify the Software for your own internal use within the licensed
15
- application.
16
- 3. Use the Software in unlimited development and staging environments
17
- without a license key (development mode).
18
-
19
- RESTRICTIONS
20
-
21
- You may NOT:
22
-
23
- 1. Redistribute, sublicense, sell, or otherwise transfer the Software or
24
- any derivative works to third parties.
25
- 2. Remove or alter any copyright notices, license keys, or proprietary
26
- markings in the Software.
27
- 3. Use the Software to build a competing product or service.
28
- 4. Share license keys across organizations or unrelated projects.
29
-
30
- DEVELOPMENT MODE
31
-
32
- The Software may be used without a license key for development and evaluation
33
- purposes. Development mode includes visual watermarks and console notices to
34
- indicate unlicensed usage. Production deployment requires a valid license key.
35
-
36
- DISCLAIMER OF WARRANTIES
37
-
38
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
39
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
40
- FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL
41
- SQUAREDR BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY ARISING FROM
42
- THE USE OF THE SOFTWARE.
43
-
44
- TERMINATION
45
-
46
- This license is effective until terminated. It will terminate automatically
47
- if you fail to comply with any term. Upon termination, you must destroy all
48
- copies of the Software in your possession.
49
-
50
- For licensing inquiries: support@squaredr.tech
51
- Purchase a license: https://squaredr.tech/products/fieldcraft/admin-pro#pricing
1
+ SquaredR Commercial License
2
+
3
+ Copyright (c) 2024-2026 SquaredR. All rights reserved.
4
+
5
+ This software and associated documentation files (the "Software") are the
6
+ proprietary property of SquaredR.
7
+
8
+ GRANT OF LICENSE
9
+
10
+ Subject to the terms of this license and payment of applicable fees, SquaredR
11
+ grants you a non-exclusive, non-transferable license to:
12
+
13
+ 1. Use the Software in a single production application per license key.
14
+ 2. Modify the Software for your own internal use within the licensed
15
+ application.
16
+ 3. Use the Software in unlimited development and staging environments
17
+ without a license key (development mode).
18
+
19
+ RESTRICTIONS
20
+
21
+ You may NOT:
22
+
23
+ 1. Redistribute, sublicense, sell, or otherwise transfer the Software or
24
+ any derivative works to third parties.
25
+ 2. Remove or alter any copyright notices, license keys, or proprietary
26
+ markings in the Software.
27
+ 3. Use the Software to build a competing product or service.
28
+ 4. Share license keys across organizations or unrelated projects.
29
+
30
+ DEVELOPMENT MODE
31
+
32
+ The Software may be used without a license key for development and evaluation
33
+ purposes. Development mode includes visual watermarks and console notices to
34
+ indicate unlicensed usage. Production deployment requires a valid license key.
35
+
36
+ DISCLAIMER OF WARRANTIES
37
+
38
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
39
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
40
+ FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL
41
+ SQUAREDR BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY ARISING FROM
42
+ THE USE OF THE SOFTWARE.
43
+
44
+ TERMINATION
45
+
46
+ This license is effective until terminated. It will terminate automatically
47
+ if you fail to comply with any term. Upon termination, you must destroy all
48
+ copies of the Software in your possession.
49
+
50
+ For licensing inquiries: support@squaredr.tech
51
+ Purchase a license: https://squaredr.tech/products/fieldcraft/admin-pro#pricing
package/README.md CHANGED
@@ -1,139 +1,139 @@
1
- # @squaredr/fieldcraft-pro
2
-
3
- [![npm version](https://img.shields.io/npm/v/@squaredr/fieldcraft-pro.svg)](https://www.npmjs.com/package/@squaredr/fieldcraft-pro)
4
- [![license](https://img.shields.io/badge/license-Commercial-blue.svg)](https://fieldcraft.squaredr.tech/pro#pricing)
5
-
6
- Pro components for [FieldCraft](https://fieldcraft.squaredr.tech) — a schema-driven form engine for React. Build forms visually, view responses, and customize themes without writing code.
7
-
8
- ## What's Included
9
-
10
- | Component | Description |
11
- |-----------|-------------|
12
- | **FormBuilder** | Drag-and-drop visual form designer with 44 field types, undo/redo, import/export, and live preview |
13
- | **ResponseViewer** | Read-only viewer for submitted form data with table and detail views, CSV/JSON export |
14
- | **ThemeEditor** | Visual theme editor for form styling with color pickers, typography controls, and live preview |
15
-
16
- ## Install
17
-
18
- ```bash
19
- npm install @squaredr/fieldcraft-pro @squaredr/fieldcraft-core @squaredr/fieldcraft-react
20
- ```
21
-
22
- ## Quick Start
23
-
24
- ```tsx
25
- import { FieldCraftProProvider, FormBuilder } from "@squaredr/fieldcraft-pro";
26
- import "@squaredr/fieldcraft-pro/styles.css";
27
-
28
- function App() {
29
- return (
30
- <FieldCraftProProvider licenseKey="YOUR_LICENSE_KEY">
31
- <FormBuilder
32
- onSave={(schema) => console.log(schema)}
33
- height="100vh"
34
- />
35
- </FieldCraftProProvider>
36
- );
37
- }
38
- ```
39
-
40
- ## Subpath Imports
41
-
42
- ```tsx
43
- // Root — everything
44
- import { FormBuilder, ResponseViewer, ThemeEditor } from "@squaredr/fieldcraft-pro";
45
-
46
- // Tree-shakeable subpath imports
47
- import { FormBuilder } from "@squaredr/fieldcraft-pro/form-builder";
48
- import { ResponseViewer } from "@squaredr/fieldcraft-pro/response-viewer";
49
- import { ThemeEditor } from "@squaredr/fieldcraft-pro/theme-editor";
50
-
51
- // CSS
52
- import "@squaredr/fieldcraft-pro/styles.css"; // Form Builder styles
53
- import "@squaredr/fieldcraft-pro/theme-editor/styles.css"; // Theme Editor styles
54
- ```
55
-
56
- ## Form Builder
57
-
58
- Visual form designer with drag-and-drop, live preview, and schema export:
59
-
60
- ```tsx
61
- import { FormBuilder } from "@squaredr/fieldcraft-pro";
62
-
63
- <FormBuilder
64
- onSave={(schema) => saveToServer(schema)}
65
- onChange={(schema) => setPreview(schema)}
66
- height="100vh"
67
- />
68
- ```
69
-
70
- ### Field Types (42)
71
-
72
- | Category | Fields |
73
- |----------|--------|
74
- | Text | Short Text, Long Text, Email, Phone, URL, Password |
75
- | Numeric | Number, Slider, Rating, NPS, Opinion Scale, Currency |
76
- | Selection | Single Select, Multi Select, Dropdown, Yes/No, Ranking, Checkbox Group |
77
- | Date/Time | Date, Time, Date Range, Date of Birth |
78
- | Media | File Upload, Signature, Image Capture |
79
- | Content | Welcome Screen, Thank You Screen, Rich Text, Image, Video, Divider, Spacer |
80
- | Structural | Section Header, Info Block, Page Break, Consent |
81
- | Advanced | Matrix, Calculated, Hidden, Repeater, Address, Legal Name, Country Select |
82
-
83
- ### Extending with Custom Fields
84
-
85
- The FormBuilder accepts `questionTypes` and `palette` props to inject additional field types at runtime:
86
-
87
- ```tsx
88
- import { FormBuilder, QUESTION_TYPE_INFO, DEFAULT_PALETTE } from "@squaredr/fieldcraft-pro";
89
-
90
- <FormBuilder
91
- questionTypes={{ ...QUESTION_TYPE_INFO, ...myCustomTypes }}
92
- palette={[...DEFAULT_PALETTE, ...myCustomCategories]}
93
- />
94
- ```
95
-
96
- ## Response Viewer
97
-
98
- Display submitted form responses in table or card/detail views:
99
-
100
- ```tsx
101
- import { ResponseViewer } from "@squaredr/fieldcraft-pro";
102
-
103
- <ResponseViewer
104
- schema={schema}
105
- responses={responses}
106
- onExport={(format) => console.log(`Export as ${format}`)}
107
- />
108
- ```
109
-
110
- ## Theme Editor
111
-
112
- Live-edit form themes with color pickers, typography controls, and shape/spacing sliders:
113
-
114
- ```tsx
115
- import { ThemeEditor } from "@squaredr/fieldcraft-pro";
116
-
117
- <ThemeEditor
118
- onChange={(theme) => console.log(theme)}
119
- onSave={(theme) => saveToServer(theme)}
120
- />
121
- ```
122
-
123
- Includes presets: Clean, Dark, Modern, High Contrast, Clinical, Playful.
124
-
125
- ## Requirements
126
-
127
- - React 18 or 19
128
- - `@squaredr/fieldcraft-core` >= 1.6.0
129
- - `@squaredr/fieldcraft-react` >= 1.6.0
130
-
131
- ## License
132
-
133
- Commercial license required for production use. Free in development mode.
134
-
135
- See [LICENSE.txt](./LICENSE.txt) for details.
136
-
137
- ---
138
-
139
- [Get a license](https://fieldcraft.squaredr.tech/pro#pricing) | [Documentation](https://fieldcraft.squaredr.tech/docs) | [GitHub](https://github.com/SquaredR98/fieldcraft-pro) | [Discord](https://discord.gg/squaredr)
1
+ # @squaredr/fieldcraft-pro
2
+
3
+ [![npm version](https://img.shields.io/npm/v/@squaredr/fieldcraft-pro.svg)](https://www.npmjs.com/package/@squaredr/fieldcraft-pro)
4
+ [![license](https://img.shields.io/badge/license-Commercial-blue.svg)](https://fieldcraft.squaredr.tech/pro#pricing)
5
+
6
+ Pro components for [FieldCraft](https://fieldcraft.squaredr.tech) — a schema-driven form engine for React. Build forms visually, view responses, and customize themes without writing code.
7
+
8
+ ## What's Included
9
+
10
+ | Component | Description |
11
+ |-----------|-------------|
12
+ | **FormBuilder** | Drag-and-drop visual form designer with 44 field types, undo/redo, import/export, and live preview |
13
+ | **ResponseViewer** | Read-only viewer for submitted form data with table and detail views, CSV/JSON export |
14
+ | **ThemeEditor** | Visual theme editor for form styling with color pickers, typography controls, and live preview |
15
+
16
+ ## Install
17
+
18
+ ```bash
19
+ npm install @squaredr/fieldcraft-pro @squaredr/fieldcraft-core @squaredr/fieldcraft-react
20
+ ```
21
+
22
+ ## Quick Start
23
+
24
+ ```tsx
25
+ import { FieldCraftProProvider, FormBuilder } from "@squaredr/fieldcraft-pro";
26
+ import "@squaredr/fieldcraft-pro/styles.css";
27
+
28
+ function App() {
29
+ return (
30
+ <FieldCraftProProvider licenseKey="YOUR_LICENSE_KEY">
31
+ <FormBuilder
32
+ onSave={(schema) => console.log(schema)}
33
+ height="100vh"
34
+ />
35
+ </FieldCraftProProvider>
36
+ );
37
+ }
38
+ ```
39
+
40
+ ## Subpath Imports
41
+
42
+ ```tsx
43
+ // Root — everything
44
+ import { FormBuilder, ResponseViewer, ThemeEditor } from "@squaredr/fieldcraft-pro";
45
+
46
+ // Tree-shakeable subpath imports
47
+ import { FormBuilder } from "@squaredr/fieldcraft-pro/form-builder";
48
+ import { ResponseViewer } from "@squaredr/fieldcraft-pro/response-viewer";
49
+ import { ThemeEditor } from "@squaredr/fieldcraft-pro/theme-editor";
50
+
51
+ // CSS
52
+ import "@squaredr/fieldcraft-pro/styles.css"; // Form Builder styles
53
+ import "@squaredr/fieldcraft-pro/theme-editor/styles.css"; // Theme Editor styles
54
+ ```
55
+
56
+ ## Form Builder
57
+
58
+ Visual form designer with drag-and-drop, live preview, and schema export:
59
+
60
+ ```tsx
61
+ import { FormBuilder } from "@squaredr/fieldcraft-pro";
62
+
63
+ <FormBuilder
64
+ onSave={(schema) => saveToServer(schema)}
65
+ onChange={(schema) => setPreview(schema)}
66
+ height="100vh"
67
+ />
68
+ ```
69
+
70
+ ### Field Types (42)
71
+
72
+ | Category | Fields |
73
+ |----------|--------|
74
+ | Text | Short Text, Long Text, Email, Phone, URL, Password |
75
+ | Numeric | Number, Slider, Rating, NPS, Opinion Scale, Currency |
76
+ | Selection | Single Select, Multi Select, Dropdown, Yes/No, Ranking, Checkbox Group |
77
+ | Date/Time | Date, Time, Date Range, Date of Birth |
78
+ | Media | File Upload, Signature, Image Capture |
79
+ | Content | Welcome Screen, Thank You Screen, Rich Text, Image, Video, Divider, Spacer |
80
+ | Structural | Section Header, Info Block, Page Break, Consent |
81
+ | Advanced | Matrix, Calculated, Hidden, Repeater, Address, Legal Name, Country Select |
82
+
83
+ ### Extending with Custom Fields
84
+
85
+ The FormBuilder accepts `questionTypes` and `palette` props to inject additional field types at runtime:
86
+
87
+ ```tsx
88
+ import { FormBuilder, QUESTION_TYPE_INFO, DEFAULT_PALETTE } from "@squaredr/fieldcraft-pro";
89
+
90
+ <FormBuilder
91
+ questionTypes={{ ...QUESTION_TYPE_INFO, ...myCustomTypes }}
92
+ palette={[...DEFAULT_PALETTE, ...myCustomCategories]}
93
+ />
94
+ ```
95
+
96
+ ## Response Viewer
97
+
98
+ Display submitted form responses in table or card/detail views:
99
+
100
+ ```tsx
101
+ import { ResponseViewer } from "@squaredr/fieldcraft-pro";
102
+
103
+ <ResponseViewer
104
+ schema={schema}
105
+ responses={responses}
106
+ onExport={(format) => console.log(`Export as ${format}`)}
107
+ />
108
+ ```
109
+
110
+ ## Theme Editor
111
+
112
+ Live-edit form themes with color pickers, typography controls, and shape/spacing sliders:
113
+
114
+ ```tsx
115
+ import { ThemeEditor } from "@squaredr/fieldcraft-pro";
116
+
117
+ <ThemeEditor
118
+ onChange={(theme) => console.log(theme)}
119
+ onSave={(theme) => saveToServer(theme)}
120
+ />
121
+ ```
122
+
123
+ Includes presets: Clean, Dark, Modern, High Contrast, Clinical, Playful.
124
+
125
+ ## Requirements
126
+
127
+ - React 18 or 19
128
+ - `@squaredr/fieldcraft-core` >= 1.6.0
129
+ - `@squaredr/fieldcraft-react` >= 1.6.0
130
+
131
+ ## License
132
+
133
+ Commercial license required for production use. Free in development mode.
134
+
135
+ See [LICENSE.txt](./LICENSE.txt) for details.
136
+
137
+ ---
138
+
139
+ [Get a license](https://fieldcraft.squaredr.tech/pro#pricing) | [Documentation](https://fieldcraft.squaredr.tech/docs) | [GitHub](https://github.com/SquaredR98/fieldcraft-pro) | [Discord](https://discord.gg/squaredr)