@pattern-stack/codegen 0.20.2 → 0.21.0

package/dist/src/index.d.ts

@@ -32,6 +32,13 @@ interface ParsedField {
         sortable?: boolean;
         filterable?: boolean;
         visible?: boolean;
+        placeholder?: string;
+        help?: string;
+        format?: Record<string, unknown>;
+        /** Curated/displayed field (qField `isKeyField` parity, ADR-040). */
+        keyField?: boolean;
+        /** Sort position within the key-field set (qField `keyFieldOrder`). */
+        keyFieldOrder?: number;
     };
 }
 interface ParsedRelationship {
@@ -379,6 +386,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder: z.ZodOptional<z.ZodString>;
         ui_help: z.ZodOptional<z.ZodString>;
         ui_format: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        ui_key_field: z.ZodOptional<z.ZodBoolean>;
+        ui_key_field_order: z.ZodOptional<z.ZodNumber>;
     } & {
         measure: z.ZodOptional<z.ZodBoolean>;
         analytics_aggregation: z.ZodOptional<z.ZodEnum<["sum", "min", "max", "count", "count_distinct", "average", "median", "percentile", "sum_boolean"]>>;
@@ -442,6 +451,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -485,6 +496,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -528,6 +541,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -571,6 +586,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -614,6 +631,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -657,6 +676,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -700,6 +721,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -743,6 +766,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -786,6 +811,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -829,6 +856,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -872,6 +901,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -915,6 +946,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -958,6 +991,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -1001,6 +1036,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -1044,6 +1081,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -1087,6 +1126,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -1130,6 +1171,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -1173,6 +1216,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -1216,6 +1261,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -1259,6 +1306,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -1302,6 +1351,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -1345,6 +1396,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -2066,6 +2119,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -2277,6 +2332,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -2488,6 +2545,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -2699,6 +2758,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -2910,6 +2971,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -3121,6 +3184,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         ui_placeholder?: string | undefined;
         ui_help?: string | undefined;
         ui_format?: Record<string, unknown> | undefined;
+        ui_key_field?: boolean | undefined;
+        ui_key_field_order?: number | undefined;
         max_length?: number | undefined;
         min_length?: number | undefined;
         choices?: string[] | undefined;
@@ -4469,6 +4534,51 @@ interface OrchestrationProjectContext {
 }
 declare function validateOrchestrationProject(ctx: OrchestrationProjectContext): AnalysisIssue[];
 
+/**
+ * Frontend emitter — field UI-metadata derivation (ADR-038, FE-3).
+ *
+ * Ports the UI-inference helpers from the deleted `templates/entity/new/prompt.js`
+ * (`inferUiType`, `inferUiImportance`, `formatLabel`, the entity_ref skip rules,
+ * the choices/FK handling) into pure functions over `ParsedField`. The fields
+ * emitter (`emit-fields.ts`) consumes these to build the `FieldMeta` objects the
+ * old `fields.ejs.t` template emitted — same output contract.
+ *
+ * Naming for FK `reference` and belongs_to rows comes from the registry, never
+ * re-pluralized here (the one place pts/prompt.js diverged; FE-1/FE-3 unify on
+ * the registry).
+ */
+
+/**
+ * The EAV `field_definitions.data_type` vocabulary → frontend `FieldType`
+ * rendering contract. This is the rallying point for external-system field
+ * types: an EAV row's `data_type` maps through this table to the same
+ * rendering vocabulary native columns use, so one renderer serves both.
+ *
+ * Notes:
+ * - `picklist` AND `multipicklist` both map to `enum` — multi-select rendering
+ *   is a consumer-side concern (the renderer checks the EAV row's cardinality,
+ *   not the FieldType).
+ * - `string` maps to `text`; EAV has no textarea heuristic (no `max_length`).
+ *
+ * The same constant is emitted into the generated `fields/field-meta.ts` (see
+ * `buildFieldMetaTypeFile`) so consumer apps get it locally, rendered from
+ * THIS object — the two cannot drift.
+ */
+declare const EAV_DATA_TYPE_TO_FIELD_TYPE: {
+    readonly string: "text";
+    readonly integer: "number";
+    readonly decimal: "number";
+    readonly boolean: "boolean";
+    readonly date: "date";
+    readonly datetime: "datetime";
+    readonly json: "json";
+    readonly reference: "reference";
+    readonly picklist: "enum";
+    readonly multipicklist: "enum";
+};
+/** The EAV `field_definitions.data_type` vocabulary. */
+type EavDataType = keyof typeof EAV_DATA_TYPE_TO_FIELD_TYPE;
+
 /**
  * Entity Codegen & Domain Analyzer
  *
@@ -4513,4 +4623,4 @@ declare function validateEntities(entitiesDir: string): {
     errors: string[];
 };
 
-export { ActivityPattern, type AnalysisIssue, type AnalysisResult, type AnalyzeDomainOptions, type AnyPatternDefinition, BASE_JUNCTION_FIELD_NAMES, BaseJunctionFields, BasePattern, type CodegenManifest, type DomainGraph, type DomainStatistics, type EntityNode, IntegratedPattern, type JunctionDefinition, JunctionDefinitionSchema, JunctionPattern, KnowledgePattern, type LoadAppPatternsResult, type ManifestEntity, type ManifestField, type ManifestRelationship, type ManifestSuggestion, MetadataPattern, type OrchestrationPatternDefinition, type OrchestrationProjectContext, type OrchestrationRegistrySpec, type OutputFormat, type ParsedEntity, type ParsedEvent, type ParsedField, type ParsedIntegration, type ParsedProviderIntegration, type ParsedQuery, type ParsedRelationship, type ParsedRelationshipDefinition, type ParsedTypeDirection, type PathHop, type PatternColumnContribution, type PatternDefinition, type PatternKind, type PatternProjectContext, type RelationshipEdge, type Severity, type TransitivePath, type TransitiveSuggestion, analyzeDomain, buildDomainGraph, checkConsistency, computeStatistics, defineOrchestrationPattern, definePattern, findCircularDependencies, findOrphanEntities, formatConsole, formatJson, formatMarkdown, formatMermaidGraph, getAllOrchestrationPatterns, getAllPatternNames, getAppPatternNames, getLibraryPatternNames, getOrchestrationPattern, getOrchestrationPatternNames, getPattern, getRelatedEntities, isDomainPattern, isOrchestrationPattern, isPatternDefinition, loadAppPatterns, loadEntities, loadEntityFromYaml, loadJunctionFromYaml, loadRelationshipFromYaml, loadRelationships, registerLibraryPattern, safeValidateJunctionDefinition, validateEntities, validateJunctionDefinition, validateOrchestrationProject, validatePatternComposition, validatePatternProject };
+export { ActivityPattern, type AnalysisIssue, type AnalysisResult, type AnalyzeDomainOptions, type AnyPatternDefinition, BASE_JUNCTION_FIELD_NAMES, BaseJunctionFields, BasePattern, type CodegenManifest, type DomainGraph, type DomainStatistics, EAV_DATA_TYPE_TO_FIELD_TYPE, type EavDataType, type EntityNode, IntegratedPattern, type JunctionDefinition, JunctionDefinitionSchema, JunctionPattern, KnowledgePattern, type LoadAppPatternsResult, type ManifestEntity, type ManifestField, type ManifestRelationship, type ManifestSuggestion, MetadataPattern, type OrchestrationPatternDefinition, type OrchestrationProjectContext, type OrchestrationRegistrySpec, type OutputFormat, type ParsedEntity, type ParsedEvent, type ParsedField, type ParsedIntegration, type ParsedProviderIntegration, type ParsedQuery, type ParsedRelationship, type ParsedRelationshipDefinition, type ParsedTypeDirection, type PathHop, type PatternColumnContribution, type PatternDefinition, type PatternKind, type PatternProjectContext, type RelationshipEdge, type Severity, type TransitivePath, type TransitiveSuggestion, analyzeDomain, buildDomainGraph, checkConsistency, computeStatistics, defineOrchestrationPattern, definePattern, findCircularDependencies, findOrphanEntities, formatConsole, formatJson, formatMarkdown, formatMermaidGraph, getAllOrchestrationPatterns, getAllPatternNames, getAppPatternNames, getLibraryPatternNames, getOrchestrationPattern, getOrchestrationPatternNames, getPattern, getRelatedEntities, isDomainPattern, isOrchestrationPattern, isPatternDefinition, loadAppPatterns, loadEntities, loadEntityFromYaml, loadJunctionFromYaml, loadRelationshipFromYaml, loadRelationships, registerLibraryPattern, safeValidateJunctionDefinition, validateEntities, validateJunctionDefinition, validateOrchestrationProject, validatePatternComposition, validatePatternProject };

package/dist/src/index.js

@@ -3,6 +3,7 @@ import {
   BASE_JUNCTION_FIELD_NAMES,
   BaseJunctionFields,
   BasePattern,
+  EAV_DATA_TYPE_TO_FIELD_TYPE,
   IntegratedPattern,
   JunctionDefinitionSchema,
   JunctionPattern,
@@ -44,7 +45,7 @@ import {
   validateOrchestrationProject,
   validatePatternComposition,
   validatePatternProject
-} from "../chunk-KK5A7B2T.js";
+} from "../chunk-524YKITE.js";
 import "../chunk-KVOWSC5S.js";
 import "../chunk-QFUIE37H.js";
 import "../chunk-FFUDEIFF.js";
@@ -72,6 +73,7 @@ export {
   BASE_JUNCTION_FIELD_NAMES,
   BaseJunctionFields,
   BasePattern,
+  EAV_DATA_TYPE_TO_FIELD_TYPE,
   IntegratedPattern,
   JunctionDefinitionSchema,
   JunctionPattern,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pattern-stack/codegen",
-  "version": "0.20.2",
+  "version": "0.21.0",
   "description": "Entity-driven code generation for full-stack TypeScript applications",
   "license": "MIT",
   "type": "module",