@carlonicora/nextjs-jsonapi 1.1.1 → 1.3.0

package/dist/scripts/generate-web-module/transformers/name-transformer.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * Name Transformer
+ *
+ * Transforms module names to various case conventions
+ * needed for code generation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transformNames = transformNames;
+exports.toCamelCase = toCamelCase;
+exports.toKebabCase = toKebabCase;
+exports.toPascalCase = toPascalCase;
+exports.toTitleCase = toTitleCase;
+exports.pluralize = pluralize;
+exports.singularize = singularize;
+/**
+ * Transform a module name to all necessary case conventions
+ *
+ * @param moduleName - PascalCase module name (e.g., "Comment")
+ * @param endpoint - Optional kebab-case plural endpoint (e.g., "comments"), derived from moduleName if not provided
+ * @returns All name transformations
+ */
+function transformNames(moduleName, endpoint) {
+    const pluralPascal = toPascalCase(pluralize(moduleName));
+    const pluralCamel = toCamelCase(pluralPascal);
+    const pluralKebab = endpoint || toKebabCase(pluralize(moduleName));
+    return {
+        pascalCase: moduleName,
+        camelCase: toCamelCase(moduleName),
+        kebabCase: toKebabCase(moduleName),
+        pluralPascal,
+        pluralCamel,
+        pluralKebab,
+        titleCase: toTitleCase(moduleName),
+        pluralTitleCase: toTitleCase(pluralPascal),
+    };
+}
+/**
+ * Convert PascalCase to camelCase
+ *
+ * @param str - PascalCase string
+ * @returns camelCase string
+ */
+function toCamelCase(str) {
+    return str.charAt(0).toLowerCase() + str.slice(1);
+}
+/**
+ * Convert PascalCase to kebab-case
+ *
+ * @param str - PascalCase string
+ * @returns kebab-case string
+ */
+function toKebabCase(str) {
+    return str
+        .replace(/([A-Z])/g, "-$1")
+        .toLowerCase()
+        .replace(/^-/, "");
+}
+/**
+ * Convert string to PascalCase
+ *
+ * @param str - Any case string
+ * @returns PascalCase string
+ */
+function toPascalCase(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+/**
+ * Convert PascalCase/camelCase to Title Case with spaces
+ * e.g., "firstName" -> "First Name", "UserProfile" -> "User Profile"
+ *
+ * @param str - PascalCase or camelCase string
+ * @returns Title Case string with spaces
+ */
+function toTitleCase(str) {
+    return str
+        .replace(/([A-Z])/g, " $1")
+        .replace(/^./, (char) => char.toUpperCase())
+        .trim();
+}
+/**
+ * Simple pluralization
+ * Note: This is a basic implementation. For production, consider using a library like 'pluralize'
+ *
+ * @param str - Singular form
+ * @returns Plural form
+ */
+function pluralize(str) {
+    if (str.endsWith("s")) {
+        return str + "es";
+    }
+    if (str.endsWith("y") && !["a", "e", "i", "o", "u"].includes(str[str.length - 2])) {
+        return str.slice(0, -1) + "ies";
+    }
+    return str + "s";
+}
+/**
+ * Simple singularization (reverse of pluralize)
+ *
+ * @param str - Plural form
+ * @returns Singular form
+ */
+function singularize(str) {
+    if (str.endsWith("ies")) {
+        return str.slice(0, -3) + "y";
+    }
+    if (str.endsWith("ses") || str.endsWith("xes") || str.endsWith("zes")) {
+        return str.slice(0, -2);
+    }
+    if (str.endsWith("s") && !str.endsWith("ss")) {
+        return str.slice(0, -1);
+    }
+    return str;
+}
+//# sourceMappingURL=name-transformer.js.map

package/dist/scripts/generate-web-module/transformers/name-transformer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-transformer.js","sourceRoot":"","sources":["../../../../scripts/generate-web-module/transformers/name-transformer.ts"],"names":[],"mappings":"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"}

package/dist/scripts/generate-web-module/transformers/parent-detector.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Parent Class Detector
+ *
+ * Determines whether a module should extend Content or AbstractApiData
+ * based on the presence of Content-specific fields.
+ */
+import { JsonFieldDefinition } from "../types/json-schema.interface";
+/**
+ * Check if a module should extend Content based on its fields
+ *
+ * @param fields - Array of field definitions from JSON schema
+ * @returns true if the module should extend Content
+ */
+export declare function detectExtendsContent(fields: JsonFieldDefinition[]): boolean;
+/**
+ * Get the parent class name based on detection result
+ *
+ * @param extendsContent - Whether the module extends Content
+ * @returns Parent class name
+ */
+export declare function getParentClassName(extendsContent: boolean): string;
+/**
+ * Get the parent interface name based on detection result
+ *
+ * @param extendsContent - Whether the module extends Content
+ * @returns Parent interface name
+ */
+export declare function getParentInterfaceName(extendsContent: boolean): string;
+/**
+ * Get the parent input type name based on detection result
+ *
+ * @param extendsContent - Whether the module extends Content
+ * @returns Parent input type or null if standalone
+ */
+export declare function getParentInputType(extendsContent: boolean): string | null;
+/**
+ * Get the import path for the parent class
+ *
+ * @param extendsContent - Whether the module extends Content
+ * @returns Import path for parent class
+ */
+export declare function getParentClassImport(extendsContent: boolean): string;
+/**
+ * Check if the module needs to call super.addContentInput() in createJsonApi
+ *
+ * @param extendsContent - Whether the module extends Content
+ * @returns true if super.addContentInput() should be called
+ */
+export declare function needsAddContentInput(extendsContent: boolean): boolean;
+/**
+ * Get fields that are inherited from Content and should not be declared
+ *
+ * @param extendsContent - Whether the module extends Content
+ * @returns Array of field names to exclude from generation
+ */
+export declare function getInheritedFields(extendsContent: boolean): string[];
+//# sourceMappingURL=parent-detector.d.ts.map

package/dist/scripts/generate-web-module/transformers/parent-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parent-detector.d.ts","sourceRoot":"","sources":["../../../../scripts/generate-web-module/transformers/parent-detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGrE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAG3E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM,CAEtE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM,CAKpE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,OAAO,GAAG,OAAO,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM,EAAE,CAMpE"}

package/dist/scripts/generate-web-module/transformers/parent-detector.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * Parent Class Detector
+ *
+ * Determines whether a module should extend Content or AbstractApiData
+ * based on the presence of Content-specific fields.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectExtendsContent = detectExtendsContent;
+exports.getParentClassName = getParentClassName;
+exports.getParentInterfaceName = getParentInterfaceName;
+exports.getParentInputType = getParentInputType;
+exports.getParentClassImport = getParentClassImport;
+exports.needsAddContentInput = needsAddContentInput;
+exports.getInheritedFields = getInheritedFields;
+const field_mapping_types_1 = require("../types/field-mapping.types");
+/**
+ * Check if a module should extend Content based on its fields
+ *
+ * @param fields - Array of field definitions from JSON schema
+ * @returns true if the module should extend Content
+ */
+function detectExtendsContent(fields) {
+    const fieldNames = fields.map((f) => f.name);
+    return field_mapping_types_1.CONTENT_INDICATOR_FIELDS.some((indicator) => fieldNames.includes(indicator));
+}
+/**
+ * Get the parent class name based on detection result
+ *
+ * @param extendsContent - Whether the module extends Content
+ * @returns Parent class name
+ */
+function getParentClassName(extendsContent) {
+    return extendsContent ? "Content" : "AbstractApiData";
+}
+/**
+ * Get the parent interface name based on detection result
+ *
+ * @param extendsContent - Whether the module extends Content
+ * @returns Parent interface name
+ */
+function getParentInterfaceName(extendsContent) {
+    return extendsContent ? "ContentInterface" : "BaseInterface";
+}
+/**
+ * Get the parent input type name based on detection result
+ *
+ * @param extendsContent - Whether the module extends Content
+ * @returns Parent input type or null if standalone
+ */
+function getParentInputType(extendsContent) {
+    return extendsContent ? "ContentInput" : null;
+}
+/**
+ * Get the import path for the parent class
+ *
+ * @param extendsContent - Whether the module extends Content
+ * @returns Import path for parent class
+ */
+function getParentClassImport(extendsContent) {
+    if (extendsContent) {
+        return '@carlonicora/nextjs-jsonapi/core';
+    }
+    return '@carlonicora/nextjs-jsonapi/core';
+}
+/**
+ * Check if the module needs to call super.addContentInput() in createJsonApi
+ *
+ * @param extendsContent - Whether the module extends Content
+ * @returns true if super.addContentInput() should be called
+ */
+function needsAddContentInput(extendsContent) {
+    return extendsContent;
+}
+/**
+ * Get fields that are inherited from Content and should not be declared
+ *
+ * @param extendsContent - Whether the module extends Content
+ * @returns Array of field names to exclude from generation
+ */
+function getInheritedFields(extendsContent) {
+    if (extendsContent) {
+        // These fields are already in Content, don't redeclare them
+        return ["name", "tldr", "abstract", "relevance"];
+    }
+    return [];
+}
+//# sourceMappingURL=parent-detector.js.map

package/dist/scripts/generate-web-module/transformers/parent-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parent-detector.js","sourceRoot":"","sources":["../../../../scripts/generate-web-module/transformers/parent-detector.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAWH,oDAGC;AAQD,gDAEC;AAQD,wDAEC;AAQD,gDAEC;AAQD,oDAKC;AAQD,oDAEC;AAQD,gDAMC;AA9ED,sEAAwE;AAExE;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,MAA6B;IAChE,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC7C,OAAO,8CAAwB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AACtF,CAAC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,cAAuB;IACxD,OAAO,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB,CAAC,cAAuB;IAC5D,OAAO,cAAc,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,eAAe,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,cAAuB;IACxD,OAAO,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,cAAuB;IAC1D,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,kCAAkC,CAAC;IAC5C,CAAC;IACD,OAAO,kCAAkC,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,cAAuB;IAC1D,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,cAAuB;IACxD,IAAI,cAAc,EAAE,CAAC;QACnB,4DAA4D;QAC5D,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/scripts/generate-web-module/transformers/relationship-resolver.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Relationship Resolver
+ *
+ * Resolves JSON relationship definitions to frontend representations
+ * including form fields, imports, and service methods.
+ */
+import { JsonRelationshipDefinition } from "../types/json-schema.interface";
+import { FrontendRelationship, RelationshipServiceMethod } from "../types/template-data.interface";
+/**
+ * Resolve a JSON relationship to frontend representation
+ *
+ * @param rel - JSON relationship definition
+ * @returns Frontend relationship representation
+ */
+export declare function resolveRelationship(rel: JsonRelationshipDefinition): FrontendRelationship;
+/**
+ * Resolve all relationships from JSON schema
+ *
+ * @param relationships - Array of JSON relationship definitions
+ * @returns Array of frontend relationship representations
+ */
+export declare function resolveRelationships(relationships: JsonRelationshipDefinition[]): FrontendRelationship[];
+/**
+ * Map directory value to web path
+ * e.g., "features" -> "features", "foundations" -> "foundations"
+ *
+ * @param directory - Directory value from JSON
+ * @returns Web path segment
+ */
+export declare function mapDirectoryToWebPath(directory: string): string;
+/**
+ * Generate service method definitions for relationships
+ *
+ * @param relationships - Array of frontend relationships
+ * @returns Array of service method definitions
+ */
+export declare function generateServiceMethods(relationships: FrontendRelationship[]): RelationshipServiceMethod[];
+/**
+ * Get unique selector imports needed for the editor
+ *
+ * @param relationships - Array of frontend relationships
+ * @returns Deduplicated array of import statements
+ */
+export declare function getSelectorImports(relationships: FrontendRelationship[]): string[];
+/**
+ * Get form JSX for a relationship field
+ *
+ * @param rel - Frontend relationship
+ * @param moduleName - Module name for i18n keys
+ * @returns JSX code for the relationship selector
+ */
+export declare function getRelationshipFormJsx(rel: FrontendRelationship, moduleName: string): string;
+/**
+ * Get default value expression for a relationship in form
+ *
+ * @param rel - Frontend relationship
+ * @param modelVarName - Variable name for the model (e.g., "article")
+ * @returns Expression for default value
+ */
+export declare function getDefaultValueExpression(rel: FrontendRelationship, modelVarName: string): string;
+/**
+ * Get payload mapping for a relationship
+ *
+ * @param rel - Frontend relationship
+ * @returns Payload field assignment code
+ */
+export declare function getPayloadMapping(rel: FrontendRelationship): string;
+//# sourceMappingURL=relationship-resolver.d.ts.map

package/dist/scripts/generate-web-module/transformers/relationship-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-resolver.d.ts","sourceRoot":"","sources":["../../../../scripts/generate-web-module/transformers/relationship-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAInG;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,0BAA0B,GAAG,oBAAoB,CA+DzF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,0BAA0B,EAAE,GAAG,oBAAoB,EAAE,CAExG;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,oBAAoB,EAAE,GAAG,yBAAyB,EAAE,CAUzG;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,CAclF;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAyB5F;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAoBjG;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,oBAAoB,GAAG,MAAM,CAMnE"}

package/dist/scripts/generate-web-module/transformers/relationship-resolver.js

@@ -0,0 +1,219 @@
+"use strict";
+/**
+ * Relationship Resolver
+ *
+ * Resolves JSON relationship definitions to frontend representations
+ * including form fields, imports, and service methods.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRelationship = resolveRelationship;
+exports.resolveRelationships = resolveRelationships;
+exports.mapDirectoryToWebPath = mapDirectoryToWebPath;
+exports.generateServiceMethods = generateServiceMethods;
+exports.getSelectorImports = getSelectorImports;
+exports.getRelationshipFormJsx = getRelationshipFormJsx;
+exports.getDefaultValueExpression = getDefaultValueExpression;
+exports.getPayloadMapping = getPayloadMapping;
+const field_mapping_types_1 = require("../types/field-mapping.types");
+const name_transformer_1 = require("./name-transformer");
+/**
+ * Resolve a JSON relationship to frontend representation
+ *
+ * @param rel - JSON relationship definition
+ * @returns Frontend relationship representation
+ */
+function resolveRelationship(rel) {
+    const isAuthor = rel.variant === field_mapping_types_1.AUTHOR_VARIANT;
+    const effectiveName = rel.variant || rel.name;
+    const effectiveNameLower = (0, name_transformer_1.toCamelCase)(effectiveName);
+    const modelKebab = (0, name_transformer_1.toKebabCase)(rel.name);
+    // Form field ID
+    const formFieldId = effectiveNameLower;
+    const formFieldIdPlural = (0, name_transformer_1.pluralize)(effectiveNameLower);
+    // Payload field ID for API calls
+    let payloadFieldId;
+    if (rel.single) {
+        payloadFieldId = `${effectiveNameLower}Id`;
+    }
+    else {
+        payloadFieldId = `${(0, name_transformer_1.toCamelCase)(rel.name)}Ids`;
+    }
+    // Selector component name
+    let selectorComponent;
+    if (rel.single) {
+        selectorComponent = `${rel.name}Selector`;
+    }
+    else {
+        selectorComponent = `${rel.name}MultiSelector`;
+    }
+    // Zod schema
+    let zodSchema;
+    if (isAuthor) {
+        zodSchema = rel.nullable
+            ? `${field_mapping_types_1.AUTHOR_ZOD_SCHEMA}.optional()`
+            : `${field_mapping_types_1.AUTHOR_ZOD_SCHEMA}.refine((data) => data.id && data.id.length > 0, { message: t(\`generic.relationships.author.error\`) })`;
+    }
+    else if (rel.single) {
+        zodSchema = rel.nullable
+            ? `${field_mapping_types_1.ENTITY_ZOD_SCHEMA}.optional()`
+            : `${field_mapping_types_1.ENTITY_ZOD_SCHEMA}.refine((data) => data.id && data.id.length > 0, { message: t(\`generic.relationships.${effectiveNameLower}.error\`) })`;
+    }
+    else {
+        zodSchema = rel.nullable ? `z.array(${field_mapping_types_1.ENTITY_ZOD_SCHEMA}).optional()` : `z.array(${field_mapping_types_1.ENTITY_ZOD_SCHEMA})`;
+    }
+    // Import paths - map directory to web path
+    const webDirectory = mapDirectoryToWebPath(rel.directory);
+    const importPath = `@/features/${webDirectory}/${modelKebab}/components/forms/${selectorComponent}`;
+    const interfaceImportPath = `@/features/${webDirectory}/${modelKebab}/data/${rel.name}Interface`;
+    const serviceImportPath = `@/features/${webDirectory}/${modelKebab}/data/${rel.name}Service`;
+    return {
+        name: rel.name,
+        variant: rel.variant,
+        directory: rel.directory,
+        single: rel.single,
+        nullable: rel.nullable,
+        formFieldId,
+        formFieldIdPlural,
+        payloadFieldId,
+        selectorComponent,
+        zodSchema,
+        importPath,
+        interfaceImportPath,
+        serviceImportPath,
+        interfaceName: `${rel.name}Interface`,
+        modelKebab,
+    };
+}
+/**
+ * Resolve all relationships from JSON schema
+ *
+ * @param relationships - Array of JSON relationship definitions
+ * @returns Array of frontend relationship representations
+ */
+function resolveRelationships(relationships) {
+    return relationships.map(resolveRelationship);
+}
+/**
+ * Map directory value to web path
+ * e.g., "features" -> "features", "foundations" -> "foundations"
+ *
+ * @param directory - Directory value from JSON
+ * @returns Web path segment
+ */
+function mapDirectoryToWebPath(directory) {
+    // The directory value maps directly to the web path
+    return directory;
+}
+/**
+ * Generate service method definitions for relationships
+ *
+ * @param relationships - Array of frontend relationships
+ * @returns Array of service method definitions
+ */
+function generateServiceMethods(relationships) {
+    return relationships.map((rel) => {
+        const effectiveName = rel.variant || rel.name;
+        return {
+            methodName: `findManyBy${(0, name_transformer_1.toPascalCase)(effectiveName)}`,
+            paramName: `${(0, name_transformer_1.toCamelCase)(effectiveName)}Id`,
+            relationshipName: rel.name,
+            relationshipEndpoint: (0, name_transformer_1.pluralize)((0, name_transformer_1.toKebabCase)(rel.name)),
+        };
+    });
+}
+/**
+ * Get unique selector imports needed for the editor
+ *
+ * @param relationships - Array of frontend relationships
+ * @returns Deduplicated array of import statements
+ */
+function getSelectorImports(relationships) {
+    const imports = new Set();
+    relationships.forEach((rel) => {
+        // Don't import User selector from same module - it's typically a library import
+        if (rel.name === "User" && rel.variant === field_mapping_types_1.AUTHOR_VARIANT) {
+            // User selector is imported from library or user feature
+            imports.add(`import { UserSelector } from "@/features/foundations/user/components/forms/UserSelector";`);
+        }
+        else {
+            imports.add(`import ${rel.selectorComponent} from "${rel.importPath}";`);
+        }
+    });
+    return Array.from(imports);
+}
+/**
+ * Get form JSX for a relationship field
+ *
+ * @param rel - Frontend relationship
+ * @param moduleName - Module name for i18n keys
+ * @returns JSX code for the relationship selector
+ */
+function getRelationshipFormJsx(rel, moduleName) {
+    const isRequired = !rel.nullable;
+    const lowerModuleName = moduleName.toLowerCase();
+    if (rel.single) {
+        // Single selector
+        if (rel.variant === field_mapping_types_1.AUTHOR_VARIANT) {
+            // Author is auto-set, usually not shown in form or read-only
+            return "";
+        }
+        return `<${rel.name}Selector
+  id="${rel.formFieldId}"
+  form={form}
+  label={t(\`generic.relationships.${rel.formFieldId}.label\`)}
+  placeholder={t(\`generic.relationships.${rel.formFieldId}.placeholder\`)}
+  ${isRequired ? "isRequired" : ""}
+/>`;
+    }
+    else {
+        // Multi selector
+        return `<${rel.name}MultiSelector
+  id="${rel.formFieldId}"
+  form={form}
+  label={t(\`types.${(0, name_transformer_1.pluralize)((0, name_transformer_1.toKebabCase)(rel.name))}\`, { count: 2 })}
+/>`;
+    }
+}
+/**
+ * Get default value expression for a relationship in form
+ *
+ * @param rel - Frontend relationship
+ * @param modelVarName - Variable name for the model (e.g., "article")
+ * @returns Expression for default value
+ */
+function getDefaultValueExpression(rel, modelVarName) {
+    const propertyName = rel.variant ? (0, name_transformer_1.toCamelCase)(rel.variant) : (0, name_transformer_1.toCamelCase)(rel.name);
+    const pluralPropertyName = (0, name_transformer_1.pluralize)(propertyName);
+    if (rel.single) {
+        if (rel.variant === field_mapping_types_1.AUTHOR_VARIANT) {
+            // Author has special shape with avatar
+            return `${modelVarName}?.${propertyName}
+        ? { id: ${modelVarName}.${propertyName}.id, name: ${modelVarName}.${propertyName}.name, avatar: ${modelVarName}.${propertyName}.avatar }
+        : undefined`;
+        }
+        return `${modelVarName}?.${propertyName}
+        ? { id: ${modelVarName}.${propertyName}.id, name: ${modelVarName}.${propertyName}.name }
+        : undefined`;
+    }
+    else {
+        // Multi-select
+        return `${modelVarName}?.${pluralPropertyName}
+        ? ${modelVarName}.${pluralPropertyName}.map((item) => ({ id: item.id, name: item.name }))
+        : []`;
+    }
+}
+/**
+ * Get payload mapping for a relationship
+ *
+ * @param rel - Frontend relationship
+ * @returns Payload field assignment code
+ */
+function getPayloadMapping(rel) {
+    if (rel.single) {
+        return `${rel.payloadFieldId}: values.${rel.formFieldId}?.id`;
+    }
+    else {
+        return `${rel.payloadFieldId}: values.${rel.formFieldId} ? values.${rel.formFieldId}.map((item) => item.id) : []`;
+    }
+}
+//# sourceMappingURL=relationship-resolver.js.map

package/dist/scripts/generate-web-module/transformers/relationship-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-resolver.js","sourceRoot":"","sources":["../../../../scripts/generate-web-module/transformers/relationship-resolver.ts"],"names":[],"mappings":"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"}

package/dist/scripts/generate-web-module/types/field-mapping.types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Field Mapping Types
+ *
+ * Defines the mapping rules between JSON schema field types
+ * and their TypeScript, Zod, and form component equivalents.
+ */
+import { FormComponentType } from "./template-data.interface";
+/**
+ * Mapping from JSON type to TypeScript type
+ */
+export declare const JSON_TO_TS_TYPE: Record<string, string>;
+/**
+ * Mapping from JSON type to Zod schema (base, without modifiers)
+ */
+export declare const JSON_TO_ZOD_BASE: Record<string, string>;
+/**
+ * Special field names that get specific form components
+ */
+export declare const SPECIAL_FIELD_COMPONENTS: Record<string, FormComponentType>;
+/**
+ * Default form component by type
+ */
+export declare const TYPE_TO_FORM_COMPONENT: Record<string, FormComponentType>;
+/**
+ * Fields that indicate the module extends Content
+ */
+export declare const CONTENT_INDICATOR_FIELDS: string[];
+/**
+ * Standard fields added to all modules
+ */
+export declare const STANDARD_FIELDS: string[];
+/**
+ * Author variant special handling
+ */
+export declare const AUTHOR_VARIANT = "Author";
+/**
+ * Zod schema for author relationships
+ */
+export declare const AUTHOR_ZOD_SCHEMA = "userObjectSchema";
+/**
+ * Zod schema for entity relationships (non-author)
+ */
+export declare const ENTITY_ZOD_SCHEMA = "entityObjectSchema";
+/**
+ * Default icon for new modules
+ */
+export declare const DEFAULT_MODULE_ICON = "FileTextIcon";
+/**
+ * Get TypeScript type for a field
+ */
+export declare function getTsType(jsonType: string): string;
+/**
+ * Get base Zod schema for a field type
+ */
+export declare function getZodBase(jsonType: string): string;
+/**
+ * Get form component for a field
+ */
+export declare function getFormComponent(fieldName: string, fieldType: string): FormComponentType;
+/**
+ * Check if a field name indicates BlockNoteEditor should be used
+ */
+export declare function isContentField(fieldName: string): boolean;
+/**
+ * Build complete Zod schema for a field
+ */
+export declare function buildZodSchema(fieldType: string, nullable: boolean, fieldName: string): string;
+//# sourceMappingURL=field-mapping.types.d.ts.map

package/dist/scripts/generate-web-module/types/field-mapping.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-mapping.types.d.ts","sourceRoot":"","sources":["../../../../scripts/generate-web-module/types/field-mapping.types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMlD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMnD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAKtE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAMpE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,UAA+B,CAAC;AAErE;;GAEG;AACH,eAAO,MAAM,eAAe,UAA6B,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,iBAAiB,uBAAuB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAElD;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAOxF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAsB9F"}