@carlonicora/nextjs-jsonapi 1.2.0 → 1.3.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.
Files changed (202) hide show
  1. package/dist/scripts/generate-web-module/generator.d.ts +15 -0
  2. package/dist/scripts/generate-web-module/generator.d.ts.map +1 -0
  3. package/dist/scripts/generate-web-module/generator.js +320 -0
  4. package/dist/scripts/generate-web-module/generator.js.map +1 -0
  5. package/dist/scripts/generate-web-module/index.d.ts +16 -0
  6. package/dist/scripts/generate-web-module/index.d.ts.map +1 -0
  7. package/dist/scripts/generate-web-module/index.js +80 -0
  8. package/dist/scripts/generate-web-module/index.js.map +1 -0
  9. package/dist/scripts/generate-web-module/templates/components/container.template.d.ts +14 -0
  10. package/dist/scripts/generate-web-module/templates/components/container.template.d.ts.map +1 -0
  11. package/dist/scripts/generate-web-module/templates/components/container.template.js +124 -0
  12. package/dist/scripts/generate-web-module/templates/components/container.template.js.map +1 -0
  13. package/dist/scripts/generate-web-module/templates/components/content.template.d.ts +15 -0
  14. package/dist/scripts/generate-web-module/templates/components/content.template.d.ts.map +1 -0
  15. package/dist/scripts/generate-web-module/templates/components/content.template.js +39 -0
  16. package/dist/scripts/generate-web-module/templates/components/content.template.js.map +1 -0
  17. package/dist/scripts/generate-web-module/templates/components/deleter.template.d.ts +14 -0
  18. package/dist/scripts/generate-web-module/templates/components/deleter.template.d.ts.map +1 -0
  19. package/dist/scripts/generate-web-module/templates/components/deleter.template.js +51 -0
  20. package/dist/scripts/generate-web-module/templates/components/deleter.template.js.map +1 -0
  21. package/dist/scripts/generate-web-module/templates/components/details.template.d.ts +14 -0
  22. package/dist/scripts/generate-web-module/templates/components/details.template.d.ts.map +1 -0
  23. package/dist/scripts/generate-web-module/templates/components/details.template.js +109 -0
  24. package/dist/scripts/generate-web-module/templates/components/details.template.js.map +1 -0
  25. package/dist/scripts/generate-web-module/templates/components/editor.template.d.ts +14 -0
  26. package/dist/scripts/generate-web-module/templates/components/editor.template.d.ts.map +1 -0
  27. package/dist/scripts/generate-web-module/templates/components/editor.template.js +459 -0
  28. package/dist/scripts/generate-web-module/templates/components/editor.template.js.map +1 -0
  29. package/dist/scripts/generate-web-module/templates/components/index.d.ts +15 -0
  30. package/dist/scripts/generate-web-module/templates/components/index.d.ts.map +1 -0
  31. package/dist/scripts/generate-web-module/templates/components/index.js +29 -0
  32. package/dist/scripts/generate-web-module/templates/components/index.js.map +1 -0
  33. package/dist/scripts/generate-web-module/templates/components/list-container.template.d.ts +14 -0
  34. package/dist/scripts/generate-web-module/templates/components/list-container.template.d.ts.map +1 -0
  35. package/dist/scripts/generate-web-module/templates/components/list-container.template.js +30 -0
  36. package/dist/scripts/generate-web-module/templates/components/list-container.template.js.map +1 -0
  37. package/dist/scripts/generate-web-module/templates/components/list.template.d.ts +14 -0
  38. package/dist/scripts/generate-web-module/templates/components/list.template.d.ts.map +1 -0
  39. package/dist/scripts/generate-web-module/templates/components/list.template.js +84 -0
  40. package/dist/scripts/generate-web-module/templates/components/list.template.js.map +1 -0
  41. package/dist/scripts/generate-web-module/templates/components/multi-selector.template.d.ts +14 -0
  42. package/dist/scripts/generate-web-module/templates/components/multi-selector.template.d.ts.map +1 -0
  43. package/dist/scripts/generate-web-module/templates/components/multi-selector.template.js +184 -0
  44. package/dist/scripts/generate-web-module/templates/components/multi-selector.template.js.map +1 -0
  45. package/dist/scripts/generate-web-module/templates/components/selector.template.d.ts +14 -0
  46. package/dist/scripts/generate-web-module/templates/components/selector.template.d.ts.map +1 -0
  47. package/dist/scripts/generate-web-module/templates/components/selector.template.js +199 -0
  48. package/dist/scripts/generate-web-module/templates/components/selector.template.js.map +1 -0
  49. package/dist/scripts/generate-web-module/templates/context.template.d.ts +14 -0
  50. package/dist/scripts/generate-web-module/templates/context.template.d.ts.map +1 -0
  51. package/dist/scripts/generate-web-module/templates/context.template.js +121 -0
  52. package/dist/scripts/generate-web-module/templates/context.template.js.map +1 -0
  53. package/dist/scripts/generate-web-module/templates/data/fields.template.d.ts +14 -0
  54. package/dist/scripts/generate-web-module/templates/data/fields.template.d.ts.map +1 -0
  55. package/dist/scripts/generate-web-module/templates/data/fields.template.js +55 -0
  56. package/dist/scripts/generate-web-module/templates/data/fields.template.js.map +1 -0
  57. package/dist/scripts/generate-web-module/templates/data/index.d.ts +10 -0
  58. package/dist/scripts/generate-web-module/templates/data/index.d.ts.map +1 -0
  59. package/dist/scripts/generate-web-module/templates/data/index.js +26 -0
  60. package/dist/scripts/generate-web-module/templates/data/index.js.map +1 -0
  61. package/dist/scripts/generate-web-module/templates/data/interface.template.d.ts +14 -0
  62. package/dist/scripts/generate-web-module/templates/data/interface.template.d.ts.map +1 -0
  63. package/dist/scripts/generate-web-module/templates/data/interface.template.js +116 -0
  64. package/dist/scripts/generate-web-module/templates/data/interface.template.js.map +1 -0
  65. package/dist/scripts/generate-web-module/templates/data/model.template.d.ts +14 -0
  66. package/dist/scripts/generate-web-module/templates/data/model.template.d.ts.map +1 -0
  67. package/dist/scripts/generate-web-module/templates/data/model.template.js +274 -0
  68. package/dist/scripts/generate-web-module/templates/data/model.template.js.map +1 -0
  69. package/dist/scripts/generate-web-module/templates/data/service.template.d.ts +14 -0
  70. package/dist/scripts/generate-web-module/templates/data/service.template.d.ts.map +1 -0
  71. package/dist/scripts/generate-web-module/templates/data/service.template.js +168 -0
  72. package/dist/scripts/generate-web-module/templates/data/service.template.js.map +1 -0
  73. package/dist/scripts/generate-web-module/templates/index.d.ts +12 -0
  74. package/dist/scripts/generate-web-module/templates/index.d.ts.map +1 -0
  75. package/dist/scripts/generate-web-module/templates/index.js +37 -0
  76. package/dist/scripts/generate-web-module/templates/index.js.map +1 -0
  77. package/dist/scripts/generate-web-module/templates/module.template.d.ts +14 -0
  78. package/dist/scripts/generate-web-module/templates/module.template.d.ts.map +1 -0
  79. package/dist/scripts/generate-web-module/templates/module.template.js +64 -0
  80. package/dist/scripts/generate-web-module/templates/module.template.js.map +1 -0
  81. package/dist/scripts/generate-web-module/templates/pages/detail-page.template.d.ts +14 -0
  82. package/dist/scripts/generate-web-module/templates/pages/detail-page.template.d.ts.map +1 -0
  83. package/dist/scripts/generate-web-module/templates/pages/detail-page.template.js +65 -0
  84. package/dist/scripts/generate-web-module/templates/pages/detail-page.template.js.map +1 -0
  85. package/dist/scripts/generate-web-module/templates/pages/index.d.ts +8 -0
  86. package/dist/scripts/generate-web-module/templates/pages/index.d.ts.map +1 -0
  87. package/dist/scripts/generate-web-module/templates/pages/index.js +13 -0
  88. package/dist/scripts/generate-web-module/templates/pages/index.js.map +1 -0
  89. package/dist/scripts/generate-web-module/templates/pages/list-page.template.d.ts +14 -0
  90. package/dist/scripts/generate-web-module/templates/pages/list-page.template.d.ts.map +1 -0
  91. package/dist/scripts/generate-web-module/templates/pages/list-page.template.js +37 -0
  92. package/dist/scripts/generate-web-module/templates/pages/list-page.template.js.map +1 -0
  93. package/dist/scripts/generate-web-module/templates/table-hook.template.d.ts +14 -0
  94. package/dist/scripts/generate-web-module/templates/table-hook.template.d.ts.map +1 -0
  95. package/dist/scripts/generate-web-module/templates/table-hook.template.js +174 -0
  96. package/dist/scripts/generate-web-module/templates/table-hook.template.js.map +1 -0
  97. package/dist/scripts/generate-web-module/transformers/field-mapper.d.ts +55 -0
  98. package/dist/scripts/generate-web-module/transformers/field-mapper.d.ts.map +1 -0
  99. package/dist/scripts/generate-web-module/transformers/field-mapper.js +179 -0
  100. package/dist/scripts/generate-web-module/transformers/field-mapper.js.map +1 -0
  101. package/dist/scripts/generate-web-module/transformers/i18n-generator.d.ts +78 -0
  102. package/dist/scripts/generate-web-module/transformers/i18n-generator.d.ts.map +1 -0
  103. package/dist/scripts/generate-web-module/transformers/i18n-generator.js +182 -0
  104. package/dist/scripts/generate-web-module/transformers/i18n-generator.js.map +1 -0
  105. package/dist/scripts/generate-web-module/transformers/import-resolver.d.ts +106 -0
  106. package/dist/scripts/generate-web-module/transformers/import-resolver.d.ts.map +1 -0
  107. package/dist/scripts/generate-web-module/transformers/import-resolver.js +193 -0
  108. package/dist/scripts/generate-web-module/transformers/import-resolver.js.map +1 -0
  109. package/dist/scripts/generate-web-module/transformers/index.d.ts +12 -0
  110. package/dist/scripts/generate-web-module/transformers/index.d.ts.map +1 -0
  111. package/dist/scripts/generate-web-module/transformers/index.js +28 -0
  112. package/dist/scripts/generate-web-module/transformers/index.js.map +1 -0
  113. package/dist/scripts/generate-web-module/transformers/name-transformer.d.ts +60 -0
  114. package/dist/scripts/generate-web-module/transformers/name-transformer.d.ts.map +1 -0
  115. package/dist/scripts/generate-web-module/transformers/name-transformer.js +115 -0
  116. package/dist/scripts/generate-web-module/transformers/name-transformer.js.map +1 -0
  117. package/dist/scripts/generate-web-module/transformers/parent-detector.d.ts +57 -0
  118. package/dist/scripts/generate-web-module/transformers/parent-detector.d.ts.map +1 -0
  119. package/dist/scripts/generate-web-module/transformers/parent-detector.js +88 -0
  120. package/dist/scripts/generate-web-module/transformers/parent-detector.js.map +1 -0
  121. package/dist/scripts/generate-web-module/transformers/relationship-resolver.d.ts +68 -0
  122. package/dist/scripts/generate-web-module/transformers/relationship-resolver.d.ts.map +1 -0
  123. package/dist/scripts/generate-web-module/transformers/relationship-resolver.js +219 -0
  124. package/dist/scripts/generate-web-module/transformers/relationship-resolver.js.map +1 -0
  125. package/dist/scripts/generate-web-module/types/field-mapping.types.d.ts +68 -0
  126. package/dist/scripts/generate-web-module/types/field-mapping.types.d.ts.map +1 -0
  127. package/dist/scripts/generate-web-module/types/field-mapping.types.js +129 -0
  128. package/dist/scripts/generate-web-module/types/field-mapping.types.js.map +1 -0
  129. package/dist/scripts/generate-web-module/types/index.d.ts +9 -0
  130. package/dist/scripts/generate-web-module/types/index.d.ts.map +1 -0
  131. package/dist/scripts/generate-web-module/types/index.js +25 -0
  132. package/dist/scripts/generate-web-module/types/index.js.map +1 -0
  133. package/dist/scripts/generate-web-module/types/json-schema.interface.d.ts +40 -0
  134. package/dist/scripts/generate-web-module/types/json-schema.interface.d.ts.map +1 -0
  135. package/dist/scripts/generate-web-module/types/json-schema.interface.js +10 -0
  136. package/dist/scripts/generate-web-module/types/json-schema.interface.js.map +1 -0
  137. package/dist/scripts/generate-web-module/types/template-data.interface.d.ts +128 -0
  138. package/dist/scripts/generate-web-module/types/template-data.interface.d.ts.map +1 -0
  139. package/dist/scripts/generate-web-module/types/template-data.interface.js +9 -0
  140. package/dist/scripts/generate-web-module/types/template-data.interface.js.map +1 -0
  141. package/dist/scripts/generate-web-module/utils/bootstrapper-updater.d.ts +29 -0
  142. package/dist/scripts/generate-web-module/utils/bootstrapper-updater.d.ts.map +1 -0
  143. package/dist/scripts/generate-web-module/utils/bootstrapper-updater.js +153 -0
  144. package/dist/scripts/generate-web-module/utils/bootstrapper-updater.js.map +1 -0
  145. package/dist/scripts/generate-web-module/utils/file-writer.d.ts +38 -0
  146. package/dist/scripts/generate-web-module/utils/file-writer.d.ts.map +1 -0
  147. package/dist/scripts/generate-web-module/utils/file-writer.js +126 -0
  148. package/dist/scripts/generate-web-module/utils/file-writer.js.map +1 -0
  149. package/dist/scripts/generate-web-module/utils/i18n-updater.d.ts +28 -0
  150. package/dist/scripts/generate-web-module/utils/i18n-updater.d.ts.map +1 -0
  151. package/dist/scripts/generate-web-module/utils/i18n-updater.js +122 -0
  152. package/dist/scripts/generate-web-module/utils/i18n-updater.js.map +1 -0
  153. package/dist/scripts/generate-web-module/utils/index.d.ts +9 -0
  154. package/dist/scripts/generate-web-module/utils/index.d.ts.map +1 -0
  155. package/dist/scripts/generate-web-module/utils/index.js +20 -0
  156. package/dist/scripts/generate-web-module/utils/index.js.map +1 -0
  157. package/dist/scripts/generate-web-module/validators/json-schema-validator.d.ts +46 -0
  158. package/dist/scripts/generate-web-module/validators/json-schema-validator.d.ts.map +1 -0
  159. package/dist/scripts/generate-web-module/validators/json-schema-validator.js +265 -0
  160. package/dist/scripts/generate-web-module/validators/json-schema-validator.js.map +1 -0
  161. package/package.json +27 -21
  162. package/scripts/generate-web-module/generator.ts +363 -0
  163. package/scripts/generate-web-module/index.ts +49 -0
  164. package/scripts/generate-web-module/templates/components/container.template.ts +129 -0
  165. package/scripts/generate-web-module/templates/components/content.template.ts +40 -0
  166. package/scripts/generate-web-module/templates/components/deleter.template.ts +51 -0
  167. package/scripts/generate-web-module/templates/components/details.template.ts +115 -0
  168. package/scripts/generate-web-module/templates/components/editor.template.ts +495 -0
  169. package/scripts/generate-web-module/templates/components/index.ts +18 -0
  170. package/scripts/generate-web-module/templates/components/list-container.template.ts +30 -0
  171. package/scripts/generate-web-module/templates/components/list.template.ts +91 -0
  172. package/scripts/generate-web-module/templates/components/multi-selector.template.ts +184 -0
  173. package/scripts/generate-web-module/templates/components/selector.template.ts +199 -0
  174. package/scripts/generate-web-module/templates/context.template.ts +121 -0
  175. package/scripts/generate-web-module/templates/data/fields.template.ts +64 -0
  176. package/scripts/generate-web-module/templates/data/index.ts +10 -0
  177. package/scripts/generate-web-module/templates/data/interface.template.ts +136 -0
  178. package/scripts/generate-web-module/templates/data/model.template.ts +327 -0
  179. package/scripts/generate-web-module/templates/data/service.template.ts +185 -0
  180. package/scripts/generate-web-module/templates/index.ts +34 -0
  181. package/scripts/generate-web-module/templates/module.template.ts +69 -0
  182. package/scripts/generate-web-module/templates/pages/detail-page.template.ts +65 -0
  183. package/scripts/generate-web-module/templates/pages/index.ts +8 -0
  184. package/scripts/generate-web-module/templates/pages/list-page.template.ts +37 -0
  185. package/scripts/generate-web-module/templates/table-hook.template.ts +182 -0
  186. package/scripts/generate-web-module/transformers/field-mapper.ts +201 -0
  187. package/scripts/generate-web-module/transformers/i18n-generator.ts +199 -0
  188. package/scripts/generate-web-module/transformers/import-resolver.ts +250 -0
  189. package/scripts/generate-web-module/transformers/index.ts +12 -0
  190. package/scripts/generate-web-module/transformers/name-transformer.ts +115 -0
  191. package/scripts/generate-web-module/transformers/parent-detector.ts +87 -0
  192. package/scripts/generate-web-module/transformers/relationship-resolver.ts +221 -0
  193. package/scripts/generate-web-module/tsconfig.json +24 -0
  194. package/scripts/generate-web-module/types/field-mapping.types.ts +141 -0
  195. package/scripts/generate-web-module/types/index.ts +9 -0
  196. package/scripts/generate-web-module/types/json-schema.interface.ts +42 -0
  197. package/scripts/generate-web-module/types/template-data.interface.ts +164 -0
  198. package/scripts/generate-web-module/utils/bootstrapper-updater.ts +145 -0
  199. package/scripts/generate-web-module/utils/file-writer.ts +115 -0
  200. package/scripts/generate-web-module/utils/i18n-updater.ts +108 -0
  201. package/scripts/generate-web-module/utils/index.ts +9 -0
  202. package/scripts/generate-web-module/validators/json-schema-validator.ts +306 -0
@@ -0,0 +1,51 @@
1
+ /**
2
+ * Deleter Template
3
+ *
4
+ * Generates {Module}Deleter.tsx component for delete confirmation.
5
+ */
6
+
7
+ import { FrontendTemplateData } from "../../types/template-data.interface";
8
+
9
+ /**
10
+ * Generate the deleter component file content
11
+ *
12
+ * @param data - Frontend template data
13
+ * @returns Generated file content
14
+ */
15
+ export function generateDeleterTemplate(data: FrontendTemplateData): string {
16
+ const { names } = data;
17
+
18
+ return `"use client";
19
+
20
+ import { ${names.pascalCase}Interface } from "@/features/${data.targetDir}/${names.kebabCase}/data/${names.pascalCase}Interface";
21
+ import { ${names.pascalCase}Service } from "@/features/${data.targetDir}/${names.kebabCase}/data/${names.pascalCase}Service";
22
+ import { CommonDeleter } from "@carlonicora/nextjs-jsonapi/components";
23
+ import { usePageUrlGenerator } from "@carlonicora/nextjs-jsonapi/hooks";
24
+
25
+ import { Modules } from "@carlonicora/nextjs-jsonapi/core";
26
+ import { useTranslations } from "next-intl";
27
+
28
+ type ${names.pascalCase}DeleterProps = {
29
+ ${names.camelCase}: ${names.pascalCase}Interface;
30
+ };
31
+
32
+ function ${names.pascalCase}DeleterInternal({ ${names.camelCase} }: ${names.pascalCase}DeleterProps) {
33
+ const t = useTranslations();
34
+ const generateUrl = usePageUrlGenerator();
35
+
36
+ if (!${names.camelCase}) return null;
37
+
38
+ return (
39
+ <CommonDeleter
40
+ type={\`${names.pluralKebab}\`}
41
+ deleteFunction={() => ${names.pascalCase}Service.delete({ ${names.camelCase}Id: ${names.camelCase}.id })}
42
+ redirectTo={generateUrl({ page: Modules.${names.pascalCase} })}
43
+ />
44
+ );
45
+ }
46
+
47
+ export default function ${names.pascalCase}Deleter(props: ${names.pascalCase}DeleterProps) {
48
+ return <${names.pascalCase}DeleterInternal {...props} />;
49
+ }
50
+ `;
51
+ }
@@ -0,0 +1,115 @@
1
+ /**
2
+ * Details Template
3
+ *
4
+ * Generates {Module}Details.tsx component for displaying item details.
5
+ */
6
+
7
+ import { FrontendTemplateData } from "../../types/template-data.interface";
8
+ import { toCamelCase, pluralize } from "../../transformers/name-transformer";
9
+
10
+ /**
11
+ * Generate the details component file content
12
+ *
13
+ * @param data - Frontend template data
14
+ * @returns Generated file content
15
+ */
16
+ export function generateDetailsTemplate(data: FrontendTemplateData): string {
17
+ const { names, fields, relationships, extendsContent } = data;
18
+
19
+ const attributeElements = generateAttributeElements(data);
20
+
21
+ return `"use client";
22
+
23
+ import { use${names.pascalCase}Context } from "@/features/${data.targetDir}/${names.kebabCase}/contexts/${names.pascalCase}Context";
24
+ import { AttributeElement, ContentTitle, ReactMarkdownContainer } from "@carlonicora/nextjs-jsonapi/components";
25
+ import { useSharedContext } from "@carlonicora/nextjs-jsonapi/contexts";
26
+ import { useTranslations } from "next-intl";
27
+
28
+ function ${names.pascalCase}DetailsInternal() {
29
+ const { ${names.camelCase}, reload${names.pascalCase} } = use${names.pascalCase}Context();
30
+ const t = useTranslations();
31
+ const { title } = useSharedContext();
32
+
33
+ if (!${names.camelCase}) return null;
34
+
35
+ return (
36
+ <div className="flex w-full flex-col gap-y-2">
37
+ <ContentTitle type={title.type} element={title.element} functions={title.functions} />
38
+ ${attributeElements}
39
+ </div>
40
+ );
41
+ }
42
+
43
+ export default function ${names.pascalCase}Details() {
44
+ const { ${names.camelCase} } = use${names.pascalCase}Context();
45
+ if (!${names.camelCase}) return null;
46
+
47
+ return <${names.pascalCase}DetailsInternal />;
48
+ }
49
+ `;
50
+ }
51
+
52
+ /**
53
+ * Generate attribute elements for display fields
54
+ */
55
+ function generateAttributeElements(data: FrontendTemplateData): string {
56
+ const { names, fields, relationships, extendsContent } = data;
57
+ const elements: string[] = [];
58
+
59
+ // Show abstract if Content-extending
60
+ if (extendsContent) {
61
+ elements.push(` <AttributeElement
62
+ title={t(\`generic.abstract\`)}
63
+ value={<ReactMarkdownContainer size="small" content={${names.camelCase}.abstract} />}
64
+ />`);
65
+ }
66
+
67
+ // Add custom fields (excluding name, tldr, abstract, content which are handled elsewhere)
68
+ const displayableFields = fields.filter(
69
+ (f) => !["name", "tldr", "abstract", "content", "id"].includes(f.name)
70
+ );
71
+
72
+ displayableFields.forEach((field) => {
73
+ if (field.type === "string") {
74
+ elements.push(` <AttributeElement
75
+ title={t(\`features.${names.camelCase}.fields.${field.name}.label\`)}
76
+ value={${names.camelCase}.${field.name}}
77
+ />`);
78
+ } else if (field.type === "boolean") {
79
+ elements.push(` <AttributeElement
80
+ title={t(\`features.${names.camelCase}.fields.${field.name}.label\`)}
81
+ value={${names.camelCase}.${field.name} ? t(\`generic.yes\`) : t(\`generic.no\`)}
82
+ />`);
83
+ } else if (field.type === "number") {
84
+ elements.push(` <AttributeElement
85
+ title={t(\`features.${names.camelCase}.fields.${field.name}.label\`)}
86
+ value={${names.camelCase}.${field.name}?.toString()}
87
+ />`);
88
+ }
89
+ });
90
+
91
+ // Add relationship displays (basic - can be enhanced manually)
92
+ relationships
93
+ .filter((rel) => rel.variant !== "Author") // Skip author, usually shown in title
94
+ .forEach((rel) => {
95
+ if (rel.single) {
96
+ const propName = toCamelCase(rel.variant || rel.name);
97
+ elements.push(` {${names.camelCase}.${propName} && (
98
+ <AttributeElement
99
+ title={t(\`generic.relationships.${propName}.label\`)}
100
+ value={${names.camelCase}.${propName}.name}
101
+ />
102
+ )}`);
103
+ } else {
104
+ const propName = pluralize(toCamelCase(rel.name));
105
+ elements.push(` {${names.camelCase}.${propName} && ${names.camelCase}.${propName}.length > 0 && (
106
+ <AttributeElement
107
+ title={t(\`types.${pluralize(rel.name.toLowerCase())}\`, { count: 2 })}
108
+ value={${names.camelCase}.${propName}.map((item) => item.name).join(", ")}
109
+ />
110
+ )}`);
111
+ }
112
+ });
113
+
114
+ return elements.join("\n");
115
+ }
@@ -0,0 +1,495 @@
1
+ /**
2
+ * Editor Template
3
+ *
4
+ * Generates {Module}Editor.tsx dialog-based form component.
5
+ */
6
+
7
+ import { FrontendTemplateData, FrontendField, FrontendRelationship } from "../../types/template-data.interface";
8
+ import { toCamelCase, pluralize, toPascalCase } from "../../transformers/name-transformer";
9
+ import { AUTHOR_VARIANT } from "../../types/field-mapping.types";
10
+ import { getFormFieldJsx } from "../../transformers/field-mapper";
11
+ import { getRelationshipFormJsx, getDefaultValueExpression, getPayloadMapping } from "../../transformers/relationship-resolver";
12
+
13
+ /**
14
+ * Generate the editor component file content
15
+ *
16
+ * @param data - Frontend template data
17
+ * @returns Generated file content
18
+ */
19
+ export function generateEditorTemplate(data: FrontendTemplateData): string {
20
+ const { names, fields, relationships, extendsContent } = data;
21
+
22
+ const imports = generateImports(data);
23
+ const propsType = generatePropsType(data);
24
+ const formSchema = generateFormSchema(data);
25
+ const defaultValues = generateDefaultValues(data);
26
+ const onSubmit = generateOnSubmit(data);
27
+ const formFields = generateFormFields(data);
28
+
29
+ const hasAuthor = relationships.some((r) => r.variant === AUTHOR_VARIANT);
30
+
31
+ return `"use client";
32
+
33
+ ${imports}
34
+
35
+ ${propsType}
36
+
37
+ function ${names.pascalCase}EditorInternal({
38
+ ${names.camelCase},
39
+ propagateChanges,
40
+ trigger,
41
+ forceShow,
42
+ onClose,
43
+ dialogOpen,
44
+ onDialogOpenChange,
45
+ }: ${names.pascalCase}EditorProps) {
46
+ const router = useRouter();
47
+ const generateUrl = usePageUrlGenerator();
48
+ const [open, setOpen] = useState<boolean>(false);
49
+ const t = useTranslations();
50
+ ${hasAuthor ? ` const { currentUser } = useCurrentUserContext<UserInterface>();` : ""}
51
+
52
+ useEffect(() => {
53
+ if (dialogOpen !== undefined) {
54
+ setOpen(dialogOpen);
55
+ }
56
+ }, [dialogOpen]);
57
+
58
+ useEffect(() => {
59
+ if (typeof onDialogOpenChange === "function") {
60
+ onDialogOpenChange(open);
61
+ }
62
+ }, [open, onDialogOpenChange]);
63
+
64
+ useEffect(() => {
65
+ if (forceShow) setOpen(true);
66
+ }, [forceShow]);
67
+
68
+ ${formSchema}
69
+
70
+ ${defaultValues}
71
+
72
+ const form = useForm<z.infer<typeof formSchema>>({
73
+ resolver: zodResolver(formSchema),
74
+ defaultValues: getDefaultValues(),
75
+ });
76
+
77
+ useEffect(() => {
78
+ if (!open) {
79
+ form.reset(getDefaultValues());
80
+ if (onClose) onClose();
81
+ }
82
+ }, [open]);
83
+
84
+ ${hasAuthor ? ` useEffect(() => {
85
+ if (currentUser && !form.getValues("author")?.id) {
86
+ form.setValue("author", { id: currentUser.id, name: currentUser.name, avatar: currentUser.avatar });
87
+ }
88
+ }, [currentUser]);` : ""}
89
+
90
+ ${onSubmit}
91
+
92
+ useEffect(() => {
93
+ const handleKeyDown = (event: KeyboardEvent) => {
94
+ if (event.key === "Escape" && open) {
95
+ event.preventDefault();
96
+ event.stopPropagation();
97
+ }
98
+ };
99
+
100
+ if (open) {
101
+ document.addEventListener("keydown", handleKeyDown, true);
102
+ }
103
+
104
+ return () => {
105
+ document.removeEventListener("keydown", handleKeyDown, true);
106
+ };
107
+ }, [open]);
108
+
109
+ return (
110
+ <Dialog open={open} onOpenChange={setOpen}>
111
+ {dialogOpen === undefined && (trigger ? trigger : <CommonEditorTrigger isEdit={!!${names.camelCase}} />)}
112
+ <DialogContent
113
+ className={\`flex max-h-[90vh] max-w-[90vw] flex-col overflow-y-auto\`}
114
+ onEscapeKeyDown={(e) => e.preventDefault()}
115
+ >
116
+ <CommonEditorHeader type={t(\`types.${names.pluralKebab}\`, { count: 1 })} name={${names.camelCase}?.name} />
117
+ <Form {...form}>
118
+ <form onSubmit={form.handleSubmit(onSubmit)} className="flex w-full flex-col gap-y-4">
119
+ <div className="flex flex-col justify-between gap-x-4">
120
+ ${formFields}
121
+ <CommonEditorButtons form={form} setOpen={setOpen} isEdit={!!${names.camelCase}} />
122
+ </div>
123
+ </form>
124
+ </Form>
125
+ </DialogContent>
126
+ </Dialog>
127
+ );
128
+ }
129
+
130
+ export default function ${names.pascalCase}Editor(props: ${names.pascalCase}EditorProps) {
131
+ const action = props.${names.camelCase} ? Action.Update : Action.Create;
132
+
133
+ return <${names.pascalCase}EditorInternal {...props} />;
134
+ }
135
+ `;
136
+ }
137
+
138
+ /**
139
+ * Generate import statements
140
+ */
141
+ function generateImports(data: FrontendTemplateData): string {
142
+ const { names, relationships, fields, extendsContent } = data;
143
+ const imports: string[] = [];
144
+
145
+ // Module imports
146
+ imports.push(`import { ${names.pascalCase}Input, ${names.pascalCase}Interface } from "@/features/${data.targetDir}/${names.kebabCase}/data/${names.pascalCase}Interface";`);
147
+ imports.push(`import { ${names.pascalCase}Service } from "@/features/${data.targetDir}/${names.kebabCase}/data/${names.pascalCase}Service";`);
148
+
149
+ // Relationship selector imports
150
+ const hasAuthor = relationships.some((r) => r.variant === AUTHOR_VARIANT);
151
+
152
+ relationships.forEach((rel) => {
153
+ if (rel.variant === AUTHOR_VARIANT) {
154
+ imports.push(`import { UserInterface } from "@/features/foundations/user/data/UserInterface";`);
155
+ } else {
156
+ const componentName = rel.single ? `${rel.name}Selector` : `${rel.name}MultiSelector`;
157
+ imports.push(`import ${componentName} from "${rel.importPath}";`);
158
+ }
159
+ });
160
+
161
+ // Router import
162
+ imports.push(`import { useRouter } from "@/i18n/routing";`);
163
+
164
+ // Utility imports
165
+ imports.push(`import { revalidatePaths } from "@/utils/revalidation";`);
166
+
167
+ // Library component imports
168
+ const componentImports: string[] = [
169
+ "CommonEditorButtons",
170
+ "CommonEditorHeader",
171
+ "CommonEditorTrigger",
172
+ "errorToast",
173
+ ];
174
+
175
+ // Check for field types that need specific components
176
+ const hasContentField = fields.some((f) => f.isContentField || f.name === "content");
177
+ if (hasContentField) {
178
+ componentImports.push("BlockNoteEditorContainer", "FormContainerGeneric");
179
+ }
180
+
181
+ const hasStringFields = fields.some((f) => f.formComponent === "FormInput" || f.formComponent === "FormInputNumber");
182
+ if (hasStringFields) {
183
+ componentImports.push("FormInput");
184
+ }
185
+
186
+ imports.push(`import {
187
+ ${componentImports.join(",\n ")},
188
+ } from "@carlonicora/nextjs-jsonapi/components";`);
189
+
190
+ // Context imports
191
+ if (hasAuthor) {
192
+ imports.push(`import { useCurrentUserContext } from "@carlonicora/nextjs-jsonapi/contexts";`);
193
+ }
194
+
195
+ // Core imports
196
+ imports.push(`import { Modules } from "@carlonicora/nextjs-jsonapi/core";`);
197
+ imports.push(`import { usePageUrlGenerator } from "@carlonicora/nextjs-jsonapi/hooks";`);
198
+ imports.push(`import { Action } from "@carlonicora/nextjs-jsonapi/permissions";`);
199
+ imports.push(`import { Dialog, DialogContent, Form } from "@carlonicora/nextjs-jsonapi/shadcnui";`);
200
+
201
+ // Zod schema imports
202
+ const zodSchemaImports = ["entityObjectSchema"];
203
+ if (hasAuthor) {
204
+ zodSchemaImports.push("userObjectSchema");
205
+ }
206
+ imports.push(`import { ${zodSchemaImports.join(", ")} } from "@carlonicora/nextjs-jsonapi/utils";`);
207
+
208
+ // Other imports
209
+ imports.push(`import { zodResolver } from "@hookform/resolvers/zod";`);
210
+ imports.push(`import { useTranslations } from "next-intl";`);
211
+ imports.push(`import { ReactNode, useEffect, useState } from "react";`);
212
+ imports.push(`import { SubmitHandler, useForm } from "react-hook-form";`);
213
+ imports.push(`import { v4 } from "uuid";`);
214
+ imports.push(`import { z } from "zod";`);
215
+
216
+ return imports.join("\n");
217
+ }
218
+
219
+ /**
220
+ * Generate props type
221
+ */
222
+ function generatePropsType(data: FrontendTemplateData): string {
223
+ const { names } = data;
224
+
225
+ return `type ${names.pascalCase}EditorProps = {
226
+ ${names.camelCase}?: ${names.pascalCase}Interface;
227
+ propagateChanges?: (${names.camelCase}: ${names.pascalCase}Interface) => void;
228
+ trigger?: ReactNode;
229
+ forceShow?: boolean;
230
+ onClose?: () => void;
231
+ dialogOpen?: boolean;
232
+ onDialogOpenChange?: (open: boolean) => void;
233
+ };`;
234
+ }
235
+
236
+ /**
237
+ * Generate form schema
238
+ */
239
+ function generateFormSchema(data: FrontendTemplateData): string {
240
+ const { names, fields, relationships, extendsContent } = data;
241
+ const schemaFields: string[] = [];
242
+
243
+ // ID field
244
+ schemaFields.push(` id: z.uuidv4(),`);
245
+
246
+ // Regular fields (excluding inherited)
247
+ const fieldsToInclude = extendsContent
248
+ ? fields.filter((f) => !["name", "tldr", "abstract"].includes(f.name))
249
+ : fields;
250
+
251
+ // Add name field for Content-extending modules
252
+ if (extendsContent) {
253
+ schemaFields.push(` name: z.string().min(1, {
254
+ message: t(\`features.${names.camelCase}.fields.name.error\`),
255
+ }),`);
256
+ }
257
+
258
+ fieldsToInclude.forEach((field) => {
259
+ if (field.name === "content" || field.isContentField) {
260
+ schemaFields.push(` ${field.name}: z.any(),`);
261
+ } else if (field.type === "string") {
262
+ if (field.nullable) {
263
+ schemaFields.push(` ${field.name}: z.string().optional(),`);
264
+ } else {
265
+ schemaFields.push(` ${field.name}: z.string().min(1, {
266
+ message: t(\`features.${names.camelCase}.fields.${field.name}.error\`),
267
+ }),`);
268
+ }
269
+ } else {
270
+ schemaFields.push(` ${field.name}: ${field.zodSchema},`);
271
+ }
272
+ });
273
+
274
+ // Relationship fields
275
+ relationships.forEach((rel) => {
276
+ const fieldId = toCamelCase(rel.variant || rel.name);
277
+ if (rel.variant === AUTHOR_VARIANT) {
278
+ schemaFields.push(` ${fieldId}: userObjectSchema.refine((data) => data.id && data.id.length > 0, {
279
+ message: t(\`generic.relationships.author.error\`),
280
+ }),`);
281
+ } else if (rel.single) {
282
+ if (rel.nullable) {
283
+ schemaFields.push(` ${fieldId}: entityObjectSchema.optional(),`);
284
+ } else {
285
+ schemaFields.push(` ${fieldId}: entityObjectSchema.refine((data) => data.id && data.id.length > 0, {
286
+ message: t(\`generic.relationships.${fieldId}.error\`),
287
+ }),`);
288
+ }
289
+ } else {
290
+ schemaFields.push(` ${fieldId}: z.array(entityObjectSchema).optional(),`);
291
+ }
292
+ });
293
+
294
+ return ` const formSchema = z.object({
295
+ ${schemaFields.join("\n")}
296
+ });`;
297
+ }
298
+
299
+ /**
300
+ * Generate default values function
301
+ */
302
+ function generateDefaultValues(data: FrontendTemplateData): string {
303
+ const { names, fields, relationships, extendsContent } = data;
304
+ const defaults: string[] = [];
305
+
306
+ // ID default
307
+ defaults.push(` id: ${names.camelCase}?.id || v4(),`);
308
+
309
+ // Name for Content-extending modules
310
+ if (extendsContent) {
311
+ defaults.push(` name: ${names.camelCase}?.name || "",`);
312
+ }
313
+
314
+ // Field defaults
315
+ const fieldsToInclude = extendsContent
316
+ ? fields.filter((f) => !["name", "tldr", "abstract"].includes(f.name))
317
+ : fields;
318
+
319
+ fieldsToInclude.forEach((field) => {
320
+ if (field.name === "content" || field.isContentField) {
321
+ defaults.push(` ${field.name}: ${names.camelCase}?.${field.name} || [],`);
322
+ } else if (field.type === "string") {
323
+ defaults.push(` ${field.name}: ${names.camelCase}?.${field.name} || "",`);
324
+ } else if (field.type === "number") {
325
+ defaults.push(` ${field.name}: ${names.camelCase}?.${field.name} || 0,`);
326
+ } else if (field.type === "boolean") {
327
+ defaults.push(` ${field.name}: ${names.camelCase}?.${field.name} || false,`);
328
+ } else {
329
+ defaults.push(` ${field.name}: ${names.camelCase}?.${field.name},`);
330
+ }
331
+ });
332
+
333
+ // Relationship defaults
334
+ relationships.forEach((rel) => {
335
+ const fieldId = toCamelCase(rel.variant || rel.name);
336
+ const propertyName = rel.variant ? toCamelCase(rel.variant) : toCamelCase(rel.name);
337
+ const pluralPropertyName = pluralize(toCamelCase(rel.name));
338
+
339
+ if (rel.variant === AUTHOR_VARIANT) {
340
+ defaults.push(` ${fieldId}: ${names.camelCase}?.${propertyName}
341
+ ? { id: ${names.camelCase}.${propertyName}.id, name: ${names.camelCase}.${propertyName}.name, avatar: ${names.camelCase}.${propertyName}.avatar }
342
+ : undefined,`);
343
+ } else if (rel.single) {
344
+ defaults.push(` ${fieldId}: ${names.camelCase}?.${propertyName}
345
+ ? { id: ${names.camelCase}.${propertyName}.id, name: ${names.camelCase}.${propertyName}.name }
346
+ : undefined,`);
347
+ } else {
348
+ defaults.push(` ${fieldId}: ${names.camelCase}?.${pluralPropertyName}
349
+ ? ${names.camelCase}.${pluralPropertyName}.map((item) => ({ id: item.id, name: item.name }))
350
+ : [],`);
351
+ }
352
+ });
353
+
354
+ return ` const getDefaultValues = () => ({
355
+ ${defaults.join("\n")}
356
+ });`;
357
+ }
358
+
359
+ /**
360
+ * Generate onSubmit handler
361
+ */
362
+ function generateOnSubmit(data: FrontendTemplateData): string {
363
+ const { names, fields, relationships, extendsContent } = data;
364
+ const payloadFields: string[] = [];
365
+
366
+ // ID
367
+ payloadFields.push(` id: values.id,`);
368
+
369
+ // Name for Content-extending modules
370
+ if (extendsContent) {
371
+ payloadFields.push(` name: values.name,`);
372
+ }
373
+
374
+ // Fields
375
+ const fieldsToInclude = extendsContent
376
+ ? fields.filter((f) => !["name", "tldr", "abstract"].includes(f.name))
377
+ : fields;
378
+
379
+ fieldsToInclude.forEach((field) => {
380
+ payloadFields.push(` ${field.name}: values.${field.name},`);
381
+ });
382
+
383
+ // Relationships
384
+ relationships.forEach((rel) => {
385
+ const fieldId = toCamelCase(rel.variant || rel.name);
386
+ const payloadKey = rel.single
387
+ ? `${fieldId}Id`
388
+ : `${toCamelCase(rel.name)}Ids`;
389
+
390
+ if (rel.single) {
391
+ payloadFields.push(` ${payloadKey}: values.${fieldId}?.id,`);
392
+ } else {
393
+ payloadFields.push(` ${payloadKey}: values.${fieldId} ? values.${fieldId}.map((item) => item.id) : [],`);
394
+ }
395
+ });
396
+
397
+ return ` const onSubmit: SubmitHandler<z.infer<typeof formSchema>> = async (values: z.infer<typeof formSchema>) => {
398
+ const payload: ${names.pascalCase}Input = {
399
+ ${payloadFields.join("\n")}
400
+ };
401
+
402
+ try {
403
+ const updated${names.pascalCase} = ${names.camelCase} ? await ${names.pascalCase}Service.update(payload) : await ${names.pascalCase}Service.create(payload);
404
+
405
+ setOpen(false);
406
+ revalidatePaths(generateUrl({ page: Modules.${names.pascalCase}, id: updated${names.pascalCase}.id, language: \`[locale]\` }));
407
+ if (${names.camelCase} && propagateChanges) {
408
+ propagateChanges(updated${names.pascalCase});
409
+ } else {
410
+ router.push(generateUrl({ page: Modules.${names.pascalCase}, id: updated${names.pascalCase}.id }));
411
+ }
412
+ } catch (error) {
413
+ errorToast({
414
+ title: ${names.camelCase} ? t(\`generic.errors.update\`) : t(\`generic.errors.create\`),
415
+ error,
416
+ });
417
+ }
418
+ };`;
419
+ }
420
+
421
+ /**
422
+ * Generate form fields JSX
423
+ */
424
+ function generateFormFields(data: FrontendTemplateData): string {
425
+ const { names, fields, relationships, extendsContent } = data;
426
+ const formElements: string[] = [];
427
+
428
+ // Name field for Content-extending
429
+ if (extendsContent) {
430
+ formElements.push(` <FormInput
431
+ form={form}
432
+ id="name"
433
+ name={t(\`features.${names.camelCase}.fields.name.label\`)}
434
+ placeholder={t(\`features.${names.camelCase}.fields.name.placeholder\`)}
435
+ isRequired
436
+ />`);
437
+ }
438
+
439
+ // Regular fields
440
+ const fieldsToInclude = extendsContent
441
+ ? fields.filter((f) => !["name", "tldr", "abstract"].includes(f.name))
442
+ : fields;
443
+
444
+ fieldsToInclude.forEach((field) => {
445
+ if (field.name === "content" || field.isContentField) {
446
+ formElements.push(` <FormContainerGeneric form={form} id="${field.name}" name={t(\`features.${names.camelCase}.fields.${field.name}.label\`)}>
447
+ <BlockNoteEditorContainer
448
+ id={form.getValues("id")}
449
+ type="${names.camelCase}"
450
+ initialContent={form.getValues("${field.name}")}
451
+ onChange={(content, isEmpty, hasUnresolvedDiff) => {
452
+ form.setValue("${field.name}", content);
453
+ }}
454
+ placeholder={t(\`features.${names.camelCase}.fields.${field.name}.placeholder\`)}
455
+ bordered
456
+ />
457
+ </FormContainerGeneric>`);
458
+ } else {
459
+ const isRequired = !field.nullable;
460
+ formElements.push(` <FormInput
461
+ form={form}
462
+ id="${field.name}"
463
+ name={t(\`features.${names.camelCase}.fields.${field.name}.label\`)}
464
+ placeholder={t(\`features.${names.camelCase}.fields.${field.name}.placeholder\`)}${isRequired ? "\n isRequired" : ""}
465
+ />`);
466
+ }
467
+ });
468
+
469
+ // Relationship selectors
470
+ relationships.forEach((rel) => {
471
+ if (rel.variant === AUTHOR_VARIANT) {
472
+ // Author is auto-set, skip
473
+ return;
474
+ }
475
+
476
+ const fieldId = toCamelCase(rel.variant || rel.name);
477
+
478
+ if (rel.single) {
479
+ formElements.push(` <${rel.name}Selector
480
+ id="${fieldId}"
481
+ form={form}
482
+ label={t(\`generic.relationships.${fieldId}.label\`)}
483
+ placeholder={t(\`generic.relationships.${fieldId}.placeholder\`)}${!rel.nullable ? "\n isRequired" : ""}
484
+ />`);
485
+ } else {
486
+ formElements.push(` <${rel.name}MultiSelector
487
+ id="${fieldId}"
488
+ form={form}
489
+ label={t(\`types.${pluralize(rel.name.toLowerCase())}\`, { count: 2 })}
490
+ />`);
491
+ }
492
+ });
493
+
494
+ return formElements.join("\n");
495
+ }
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Component Templates Index
3
+ *
4
+ * Exports all component template generators.
5
+ */
6
+
7
+ // Form components
8
+ export { generateEditorTemplate } from "./editor.template";
9
+ export { generateDeleterTemplate } from "./deleter.template";
10
+ export { generateSelectorTemplate } from "./selector.template";
11
+ export { generateMultiSelectorTemplate } from "./multi-selector.template";
12
+
13
+ // Display components
14
+ export { generateListTemplate } from "./list.template";
15
+ export { generateDetailsTemplate } from "./details.template";
16
+ export { generateContentTemplate } from "./content.template";
17
+ export { generateContainerTemplate } from "./container.template";
18
+ export { generateListContainerTemplate } from "./list-container.template";