@pattern-stack/codegen 0.20.2 → 0.21.0

package/dist/src/cli/index.js

@@ -1,11 +1,15 @@
 #!/usr/bin/env node
 import {
   DIRECTION_TO_POOL,
+  EAV_DATA_TYPE_TO_FIELD_TYPE,
   EVENT_FIELD_TYPES,
+  EXTERNAL_SYNC_FIELDS,
+  EXTERNAL_SYNC_GROUP,
   _resetRegistryForTests,
   analyzeDomain,
   buildManifest,
   collectEntitySurfaces,
+  deriveFieldMeta,
   detectYamlType,
   findYamlFiles,
   formatConsole,
@@ -17,7 +21,9 @@ import {
   getManifestDir,
   getOrchestrationPatternNames,
   getPendingSuggestions,
+  hasExternalSyncShape,
   isActiveProvider,
+  isEntityRefField,
   isManifestStale,
   loadAppPatterns,
   loadEntities,
@@ -38,7 +44,7 @@ import {
   validateOrchestrationProject,
   validateProviders,
   writeManifest
-} from "../../chunk-KK5A7B2T.js";
+} from "../../chunk-524YKITE.js";
 import "../../chunk-KVOWSC5S.js";
 import "../../chunk-QFUIE37H.js";
 import "../../chunk-FFUDEIFF.js";
@@ -5494,79 +5500,11 @@ function emitStore(ctx, outDir) {
 
 // src/emitters/frontend/emit-fields.ts
 import { join as join15 } from "path";
-
-// src/emitters/frontend/field-meta.ts
-var CAMEL2 = (s) => s.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
-function formatLabel(fieldName) {
-  return fieldName.replace(/_/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
-}
-function inferUiType(field) {
-  if (field.ui.type) return field.ui.type;
-  if (Array.isArray(field.choices) && field.choices.length > 0) return "enum";
-  if (field.foreignKey) return "reference";
-  const nameLower = field.name.toLowerCase();
-  if (nameLower.includes("email")) return "email";
-  if (nameLower.includes("url") || nameLower.includes("website")) return "url";
-  if (nameLower.includes("password")) return "password";
-  if (nameLower.includes("price") || nameLower.includes("amount") || nameLower.includes("cost") || nameLower.includes("value") || nameLower.includes("revenue")) {
-    return "money";
-  }
-  if (nameLower.includes("percent") || nameLower.includes("rate")) {
-    return "percentage";
-  }
-  switch (field.type) {
-    case "string":
-      return field.constraints.maxLength && field.constraints.maxLength > 500 ? "textarea" : "text";
-    case "integer":
-    case "decimal":
-      return "number";
-    case "boolean":
-      return "boolean";
-    case "uuid":
-      return "text";
-    case "date":
-      return "date";
-    case "datetime":
-      return "datetime";
-    case "json":
-      return "json";
-    default:
-      return "text";
-  }
-}
-function inferUiImportance(field) {
-  if (field.ui.importance) return field.ui.importance;
-  const nameLower = field.name.toLowerCase();
-  if (["id", "created_at", "updated_at", "deleted_at"].includes(nameLower)) {
-    return "tertiary";
-  }
-  if (field.foreignKey && nameLower.endsWith("_id")) return "secondary";
-  if (field.required) return "primary";
-  if (nameLower.includes("name") || nameLower.includes("title")) return "primary";
-  return "secondary";
-}
-function isEntityRefField(field) {
-  if (field.type === "entity_ref") return true;
-  return field.name.endsWith("_entity_type") || field.name.endsWith("_entity_id");
-}
-function deriveFieldMeta(field) {
-  const hasChoices = Array.isArray(field.choices) && field.choices.length > 0;
-  const meta = {
-    field: CAMEL2(field.name),
-    label: field.ui.label ?? formatLabel(field.name),
-    type: inferUiType(field),
-    importance: inferUiImportance(field),
-    sortable: field.ui.sortable ?? false,
-    filterable: field.ui.filterable ?? false
-  };
-  if (hasChoices) meta.choices = field.choices;
-  if (field.foreignKey) meta.reference = field.foreignKey.table;
-  return meta;
-}
-
-// src/emitters/frontend/emit-fields.ts
 var SOURCE_DESC_SET5 = "the entity set";
 function buildFieldMetaTypeFile() {
+  const eavKeys = Object.keys(EAV_DATA_TYPE_TO_FIELD_TYPE);
+  const eavUnion = eavKeys.map((k) => `	| '${k}'`).join("\n");
+  const eavEntries = Object.entries(EAV_DATA_TYPE_TO_FIELD_TYPE).map(([k, v]) => `	${k}: '${v}',`).join("\n");
   const body = `/**
  * Field metadata types for DataGrid, forms, and admin surfaces.
  */
@@ -5598,37 +5536,85 @@ export interface FieldMeta<T = unknown> {
 	importance: FieldImportance;
 	sortable?: boolean;
 	filterable?: boolean;
+	/** Layout grouping (e.g. 'external_sync'). */
+	group?: string;
+	/** \`false\` \u21D2 hidden by default. Absent means visible. */
+	visible?: boolean;
+	placeholder?: string;
+	/** Help/description text shown alongside the field. */
+	help?: string;
 	format?: Record<string, unknown>;
 	choices?: string[];
 	reference?: string;
+	/** Curated/displayed field \u2014 drives card & preview field selection. */
+	isKeyField?: boolean;
+	/** Sort position within the key-field set. */
+	keyFieldOrder?: number;
 }
+
+/** EAV \`field_definitions.data_type\` vocabulary. */
+export type EavDataType =
+${eavUnion};
+
+/**
+ * EAV \`field_definitions.data_type\` \u2192 \`FieldType\` rendering contract: an EAV
+ * field renders through the same vocabulary as a native column. Note both
+ * \`picklist\` and \`multipicklist\` map to \`enum\` \u2014 multi-select rendering is a
+ * consumer-side concern (check the EAV row's cardinality, not the FieldType).
+ */
+export const EAV_DATA_TYPE_TO_FIELD_TYPE: Record<EavDataType, FieldType> = {
+${eavEntries}
+};
 `;
   return withBanner(SOURCE_DESC_SET5, body);
 }
 function hasTimestamps(parsed) {
   return parsed?.behaviors.includes("timestamps") ?? false;
 }
+function hasSoftDelete(parsed) {
+  return parsed?.behaviors.includes("soft_delete") ?? false;
+}
 function displayFields(parsed) {
   if (!parsed) return [];
+  const syncShape = hasExternalSyncShape(parsed.fields.keys());
   const out = [];
   for (const field of parsed.fields.values()) {
     if (field.name === "id") continue;
     if (isEntityRefField(field)) continue;
-    out.push(deriveFieldMeta(field));
+    const defaults = syncShape && EXTERNAL_SYNC_FIELDS.has(field.name) ? { group: EXTERNAL_SYNC_GROUP } : void 0;
+    out.push(deriveFieldMeta(field, defaults));
   }
   return out;
 }
+function quote(s) {
+  return s.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+}
 function renderFieldMeta(meta) {
   const lines = [
     `		field: '${meta.field}',`,
-    `		label: '${meta.label}',`,
+    `		label: '${quote(meta.label)}',`,
     `		type: '${meta.type}' as FieldType,`,
     `		importance: '${meta.importance}' as FieldImportance,`
   ];
   if (meta.sortable) lines.push("		sortable: true,");
   if (meta.filterable) lines.push("		filterable: true,");
+  if (meta.group !== void 0) lines.push(`		group: '${quote(meta.group)}',`);
+  if (meta.visible !== void 0) lines.push(`		visible: ${meta.visible},`);
+  if (meta.placeholder !== void 0) {
+    lines.push(`		placeholder: '${quote(meta.placeholder)}',`);
+  }
+  if (meta.help !== void 0) lines.push(`		help: '${quote(meta.help)}',`);
+  if (meta.format !== void 0) {
+    lines.push(`		format: ${JSON.stringify(meta.format)},`);
+  }
   if (meta.choices) lines.push(`		choices: ${JSON.stringify(meta.choices)},`);
   if (meta.reference) lines.push(`		reference: '${meta.reference}',`);
+  if (meta.isKeyField) {
+    lines.push("		isKeyField: true,");
+    if (meta.keyFieldOrder !== void 0) {
+      lines.push(`		keyFieldOrder: ${meta.keyFieldOrder},`);
+    }
+  }
   return `	${meta.field}: {
 ${lines.join("\n")}
 	},`;
@@ -5642,6 +5628,7 @@ function buildEntityFieldsFile(entity, ctx) {
   const fields = displayFields(parsed);
   const rels = resolvableRels(entity, ctx);
   const ts3 = hasTimestamps(parsed);
+  const sd = hasSoftDelete(parsed);
   const fieldEntries = fields.map(renderFieldMeta);
   const relEntries = rels.map(
     (r) => `	${r.propertyName}: {
@@ -5668,8 +5655,22 @@ function buildEntityFieldsFile(entity, ctx) {
 		format: { dateFormat: 'relative' },
 	},`
   ] : [];
-  const allEntries = [...fieldEntries, ...relEntries, ...tsEntries].join("\n");
+  const sdEntries = sd ? [
+    `	deletedAt: {
+		field: 'deletedAt',
+		label: 'Deleted',
+		type: 'datetime' as FieldType,
+		importance: 'tertiary' as FieldImportance,
+		format: { dateFormat: 'relative' },
+	},`
+  ] : [];
+  const allEntries = [...fieldEntries, ...relEntries, ...tsEntries, ...sdEntries].join(
+    "\n"
+  );
   const primaryFields = fields.filter((f) => f.importance === "primary").map((f) => `		'${f.field}',`).join("\n");
+  const keyFields = fields.filter((f) => f.isKeyField).sort(
+    (a, b) => (a.keyFieldOrder ?? Number.MAX_SAFE_INTEGER) - (b.keyFieldOrder ?? Number.MAX_SAFE_INTEGER)
+  ).map((f) => `		'${f.field}',`).join("\n");
   const searchFields = fields.filter((f) => f.filterable).map((f) => `		'${f.field}',`).join("\n");
   const defaultSortField = ts3 ? "createdAt" : "id";
   const expose = parsed?.expose ?? ["repository", "rest", "trpc"];
@@ -5691,6 +5692,9 @@ export const ${camelName}Metadata = {
 
 	primaryFields: [
 ${primaryFields}
+	],
+	keyFields: [
+${keyFields}
 	],
 	searchFields: [
 ${searchFields}
@@ -8657,7 +8661,7 @@ function buildAuthImportRewriter(subsystemsRoot) {
     const relPosix = rel2.split(path24.sep).join("/");
     return content.replace(
       AUTH_BARE_IMPORT_RE,
-      (_match, quote) => `${quote}${relPosix}${quote}`
+      (_match, quote2) => `${quote2}${relPosix}${quote2}`
     );
   };
 }