@memberjunction/interactive-component-types 5.37.0 → 5.39.0

package/README.md

@@ -477,6 +477,26 @@ All interfaces are fully typed with TypeScript, providing:
 - Better code documentation
 - Reduced runtime errors
 
+## Forms subpath (`@memberjunction/interactive-component-types/forms`)
+
+The `/forms` subpath provides the **form-role contract** for components that
+declare `componentRole: 'form'` — the substrate that lets MJ render
+runtime-author forms inside Explorer with the same toolbar / save / delete
+behavior as a CodeGen-generated Angular form.
+
+| Export | Purpose |
+|---|---|
+| `FormHostProps` | What the host wrapper passes a form-role React component (entity name, primary key, record snapshot, mode, permissions). |
+| `FormEventNames` / `FormBeforeSaveArgs` / etc. | Standard event names + payload types the component emits via `callbacks.NotifyEvent`. |
+| `FormMethodNames` | Standard methods the component registers (`RequestSave`, `RequestCancel`) so the host toolbar can drive its save flow. |
+| `isFormRole(spec)` | Type-guard: does this `ComponentSpec` declare `componentRole: 'form'`? |
+| `CuratedFormSchema`, `buildCuratedFormSchema(entityName, provider)` | Curated, LLM-friendly view of an entity's schema for form authoring — FK references resolved to `{entity, displayField}`, value lists annotated with `allowedValues`, audit/virtual/computed fields stripped. |
+| `buildDefaultFormScaffold(entityName, provider)` | Produces a working form-role `ComponentSpec` that mirrors the CodeGen Angular default layout. Used as the baseline by the Form Builder agent and the dashboard's "New form" flow. |
+| `buildFixtureFormHostProps(schema, mode?)` | Synthesizes type-appropriate fixture values for live-preview rendering when no real `BaseEntity` is available (used by Component Studio preview + the chat artifact viewer's fallback mode). |
+| `getDeclaredFormEntityName(spec)` | Resolves the entity a form binds to from `spec.entityName` or `spec.dataRequirements.entities[0].name`. Pure helper shared by every form-role consumer. |
+
+See [/plans/interactive-forms/phase-2-runtime-loop.md](../../plans/interactive-forms/phase-2-runtime-loop.md) for the full architecture, lifecycle, and security model (Create / Modify / Activate / Revert + ownership checks).
+
 ## Dependencies
 
 - `@memberjunction/core`: Core MemberJunction types and interfaces

package/dist/component-spec.d.ts

@@ -2,6 +2,12 @@ import { ComponentEvent, ComponentProperty } from "./component-props-events.js";
 import { ComponentDataRequirements } from "./data-requirements.js";
 import { ComponentLibraryDependency } from "./library-dependency.js";
 import { ComponentTypeDefinition } from "./component-constraints.js";
+/**
+ * Contract a component commits to implementing. Hosts use this to decide how
+ * to mount the component and what props/events to wire up. Authoring agents
+ * use it to target a known shape.
+ */
+export type ComponentRole = 'form' | 'dashboard' | 'widget' | 'report' | 'detail-pane';
 /**
  * Tracks the current change being applied to this component.
  * Populated by Impact Assessor at the start of a modification flow,
@@ -128,6 +134,20 @@ export declare class ComponentSpec {
      * Self-declared type - some common options below, can be any string if the standard ones aren't sufficient
      */
     type: "report" | "dashboard" | "form" | "table" | "chart" | "navigation" | "search" | string;
+    /**
+     * Declares the contract this component implements.
+     *
+     * Distinct from `type` (which is descriptive): `componentRole` is a *commitment* that the
+     * component's props, events, and methods conform to a role-specific contract, letting hosts
+     * mount it generically and letting authoring agents target a known shape.
+     *
+     * - `form`: implements `FormHostProps` + standard form events/methods (see `@memberjunction/interactivecomponents/forms`).
+     *   Hosted by `InteractiveFormComponent` against a `BaseEntity` record.
+     * - `dashboard` | `widget` | `report` | `detail-pane`: reserved for future role contracts.
+     *
+     * Unset = a generic component, mounted directly. No behavior change for existing components.
+     */
+    componentRole?: ComponentRole;
     /**
      * JavaScript code
      */

package/dist/component-spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-spec.d.ts","sourceRoot":"","sources":["../src/component-spec.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"component-spec.d.ts","sourceRoot":"","sources":["../src/component-spec.ts"],"names":[],"mappings":"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"}

package/dist/component-spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"component-spec.js","sourceRoot":"","sources":["../src/component-spec.ts"],"names":[],"mappings":"AAgFA;;GAEG;AACH,MAAM,OAAO,aAAa;CA+KzB;AAAA,CAAC"}
+{"version":3,"file":"component-spec.js","sourceRoot":"","sources":["../src/component-spec.ts"],"names":[],"mappings":"AAuFA;;GAEG;AACH,MAAM,OAAO,aAAa;CA8LzB;AAAA,CAAC"}

package/dist/forms/curated-form-schema.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Curated form-relevant view of an entity's metadata.
+ *
+ * Used in three places:
+ *   - The `GetEntitySchemaForForm` action, which serves this shape to the
+ *     Form Builder agent so the LLM has tight, LLM-friendly field info
+ *     (FKs resolved, value lists annotated, audit/internal fields stripped).
+ *   - The Component Studio field-binding inspector, which lists these
+ *     fields in its right-panel sidebar.
+ *   - The Component Studio fixture-record live preview, which generates
+ *     type-appropriate sample values per field for the in-progress form.
+ *
+ * The shape is deliberately tighter than `EntityInfo`/`EntityFieldInfo`:
+ * audit fields are out, FK references are resolved to `{entity, displayField}`,
+ * value-list fields are normalised to `allowedValues: string[]`, and the
+ * type union is narrowed to six LLM-friendly buckets rather than raw SQL
+ * type strings.
+ */
+import type { EntityInfo, IMetadataProvider } from '@memberjunction/core';
+/** Foreign-key target info, resolved at curation time. */
+export interface CuratedFormFieldFK {
+    /** Display name of the related entity, e.g. "Accounts". */
+    entity: string;
+    /** The name-field on the related entity, e.g. "Name". May be absent if the related entity has no NameField. */
+    displayField?: string;
+}
+/** Normalised type bucket for a form field. */
+export type CuratedFormFieldType = 'string' | 'number' | 'boolean' | 'datetime' | 'enum' | 'foreign-key';
+/** A single field in the curated schema. */
+export interface CuratedFormField {
+    /** Database column name, e.g. "AccountID". */
+    name: string;
+    /** Human-readable label if different from `name`. */
+    displayName?: string;
+    /** Field description from extended properties / EntityField.Description. */
+    description?: string;
+    /** Normalised type bucket. */
+    type: CuratedFormFieldType;
+    /** True iff a user must supply a value when creating a new record. */
+    required: boolean;
+    /** True iff the field is part of the primary key. */
+    isPrimaryKey: boolean;
+    /** Maximum string length when `type === 'string'`. */
+    maxLength?: number;
+    /** Allowed values when `type === 'enum'`. */
+    allowedValues?: string[];
+    /** FK target when `type === 'foreign-key'`. */
+    references?: CuratedFormFieldFK;
+    /** Display order from `EntityField.Sequence`. */
+    sequence: number;
+}
+/** Curated entity-level schema for form authoring / rendering. */
+export interface CuratedFormSchema {
+    /** Fully-qualified entity name, e.g. "MJ: Applications". */
+    entityName: string;
+    /** Human-readable label, e.g. "Application". */
+    displayName: string;
+    /** Entity description if available. */
+    description?: string;
+    /** Name of the field that serves as the record's display label. */
+    nameField?: string;
+    /** Curated fields, in display order. */
+    fields: CuratedFormField[];
+}
+/**
+ * Build the curated schema for an entity.
+ *
+ * Strips fields the form layer shouldn't surface:
+ *   - `__mj_*` audit columns (CreatedAt / UpdatedAt).
+ *   - Computed columns (`IsVirtual && IsComputed`) — read-only at the DB level.
+ *   - Pure view-only columns (`IsVirtual && !IsComputed`) — not writable.
+ *
+ * Primary-key fields are kept but flagged with `isPrimaryKey`. The form
+ * layer uses these for display only; persistence flows through
+ * `FormHostProps.primaryKey`.
+ *
+ * Returns `null` if the entity is not registered with the provider.
+ */
+export declare function buildCuratedFormSchema(entityName: string, provider: IMetadataProvider): CuratedFormSchema | null;
+/**
+ * Same as {@link buildCuratedFormSchema} but takes an already-resolved
+ * `EntityInfo`. Useful when callers already hold the EntityInfo (e.g.
+ * inside `InteractiveFormComponent.rebuildFormHostProps`) and want to
+ * skip the second lookup.
+ */
+export declare function curateFromEntityInfo(entity: EntityInfo, provider: IMetadataProvider): CuratedFormSchema;
+//# sourceMappingURL=curated-form-schema.d.ts.map

package/dist/forms/curated-form-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"curated-form-schema.d.ts","sourceRoot":"","sources":["../../src/forms/curated-form-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAmB,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE3F,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IAC/B,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,+GAA+G;IAC/G,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,+CAA+C;AAC/C,MAAM,MAAM,oBAAoB,GAC1B,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,UAAU,GACV,MAAM,GACN,aAAa,CAAC;AAEpB,4CAA4C;AAC5C,MAAM,WAAW,gBAAgB;IAC7B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,sEAAsE;IACtE,QAAQ,EAAE,OAAO,CAAC;IAClB,qDAAqD;IACrD,YAAY,EAAE,OAAO,CAAC;IACtB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IAC9B,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAClC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,iBAAiB,GAC5B,iBAAiB,GAAG,IAAI,CAM1B;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAChC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,iBAAiB,GAC5B,iBAAiB,CAanB"}

package/dist/forms/curated-form-schema.js

@@ -0,0 +1,124 @@
+/**
+ * Build the curated schema for an entity.
+ *
+ * Strips fields the form layer shouldn't surface:
+ *   - `__mj_*` audit columns (CreatedAt / UpdatedAt).
+ *   - Computed columns (`IsVirtual && IsComputed`) — read-only at the DB level.
+ *   - Pure view-only columns (`IsVirtual && !IsComputed`) — not writable.
+ *
+ * Primary-key fields are kept but flagged with `isPrimaryKey`. The form
+ * layer uses these for display only; persistence flows through
+ * `FormHostProps.primaryKey`.
+ *
+ * Returns `null` if the entity is not registered with the provider.
+ */
+export function buildCuratedFormSchema(entityName, provider) {
+    const entity = provider.EntityByName(entityName);
+    if (!entity) {
+        return null;
+    }
+    return curateFromEntityInfo(entity, provider);
+}
+/**
+ * Same as {@link buildCuratedFormSchema} but takes an already-resolved
+ * `EntityInfo`. Useful when callers already hold the EntityInfo (e.g.
+ * inside `InteractiveFormComponent.rebuildFormHostProps`) and want to
+ * skip the second lookup.
+ */
+export function curateFromEntityInfo(entity, provider) {
+    const fields = entity.Fields
+        .filter(shouldIncludeField)
+        .map(f => curateField(f, provider))
+        .sort((a, b) => a.sequence - b.sequence);
+    return {
+        entityName: entity.Name,
+        displayName: entity.DisplayName ?? entity.Name,
+        description: entity.Description ?? undefined,
+        nameField: entity.NameField?.Name,
+        fields,
+    };
+}
+/** Pre-filter: drop audit and non-writable columns. */
+function shouldIncludeField(field) {
+    if (field.Name?.startsWith('__mj_')) {
+        return false;
+    }
+    if (field.IsVirtual) {
+        return false;
+    }
+    return true;
+}
+function curateField(field, provider) {
+    const type = inferType(field);
+    const required = isRequired(field);
+    const out = {
+        name: field.Name,
+        displayName: field.DisplayName && field.DisplayName !== field.Name ? field.DisplayName : undefined,
+        description: field.Description ?? undefined,
+        type,
+        required,
+        isPrimaryKey: !!field.IsPrimaryKey,
+        sequence: field.Sequence ?? 0,
+    };
+    if (type === 'string') {
+        const max = field.MaxLength;
+        if (max && max > 0) {
+            out.maxLength = max;
+        }
+    }
+    if (type === 'enum') {
+        out.allowedValues = field.EntityFieldValues?.map(v => v.Value).filter(Boolean) ?? [];
+    }
+    if (type === 'foreign-key') {
+        out.references = resolveForeignKey(field, provider);
+    }
+    return out;
+}
+/**
+ * Map an `EntityFieldInfo` to one of six normalised buckets. Order of checks
+ * matters: foreign-key trumps the raw TSType (an FK can be stored as
+ * uniqueidentifier and would otherwise look like 'string'), and enum trumps
+ * the raw type when the field has a value list.
+ */
+function inferType(field) {
+    if (field.RelatedEntity) {
+        return 'foreign-key';
+    }
+    if (field.ValueListType && field.ValueListType !== 'None' &&
+        field.EntityFieldValues && field.EntityFieldValues.length > 0) {
+        return 'enum';
+    }
+    switch (field.TSType) {
+        case 'number':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'Date':
+            return 'datetime';
+        default:
+            return 'string';
+    }
+}
+/**
+ * A field is "required" for form purposes when the user must supply a value
+ * to create the record. PKs are excluded (auto-assigned) and so are fields
+ * with database defaults (the DB will fill them).
+ */
+function isRequired(field) {
+    if (field.IsPrimaryKey) {
+        return false;
+    }
+    if (field.DefaultValue && field.DefaultValue.length > 0) {
+        return false;
+    }
+    return !field.AllowsNull;
+}
+function resolveForeignKey(field, provider) {
+    const targetName = field.RelatedEntity;
+    const target = provider.EntityByName(targetName);
+    return {
+        entity: targetName,
+        displayField: target?.NameField?.Name,
+    };
+}
+//# sourceMappingURL=curated-form-schema.js.map

package/dist/forms/curated-form-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"curated-form-schema.js","sourceRoot":"","sources":["../../src/forms/curated-form-schema.ts"],"names":[],"mappings":"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"}

package/dist/forms/default-form-scaffold.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Default form scaffold builder.
+ *
+ * Given an entity's curated schema + section/category metadata from CodeGen,
+ * produces a working `ComponentSpec` whose JSX mirrors the layout the Angular
+ * CodeGen form would render for the same entity. This is the *floor* that
+ * agents (Form Builder, Skip) and Form Studio's "New form" flow start from —
+ * not the ceiling. Most rich forms transform or replace this aggressively;
+ * the scaffold's job is to guarantee day-one parity with the default Angular
+ * form so the runtime form path is never worse than the default.
+ *
+ * The output is intentionally a small, hand-readable JSX function that uses
+ * the host-provided `record`, `entityMetadata`, `mode`, and `callbacks`. It
+ * does NOT touch BaseEntity, Metadata, or RunView for the record being
+ * edited — that's the form-role layering invariant.
+ */
+import type { EntityInfo, IMetadataProvider } from '@memberjunction/core';
+import type { ComponentSpec } from '../component-spec.js';
+/**
+ * Build a working scaffold ComponentSpec for `entityName`. Returns `null` if
+ * the entity isn't registered.
+ *
+ * Scaffold rules (mirror CodeGen):
+ *   - Sections come from `EntityField.Category` + `GeneratedFormSectionType`.
+ *   - Top-section fields render above the section list.
+ *   - Field input type derives from `TSType` + `ValueListType` (textarea for
+ *     long strings, checkbox for booleans, datepicker for dates, select for
+ *     value lists, fk-picker for FKs, number for numeric).
+ *   - System Metadata section is always last and starts collapsed.
+ *   - 2-column grid by default; long-string and textarea fields go full-span.
+ */
+export declare function buildDefaultFormScaffold(entityName: string, provider: IMetadataProvider): ComponentSpec | null;
+/** Same as {@link buildDefaultFormScaffold} but takes an already-resolved EntityInfo. */
+export declare function buildScaffoldFromEntityInfo(entity: EntityInfo, provider: IMetadataProvider): ComponentSpec;
+/** Strip non-identifier characters so the function name is valid JS. */
+export declare function sanitizeComponentName(raw: string): string;
+//# sourceMappingURL=default-form-scaffold.d.ts.map

package/dist/forms/default-form-scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-form-scaffold.d.ts","sourceRoot":"","sources":["../../src/forms/default-form-scaffold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,UAAU,EAAmB,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAkCvD;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACpC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,iBAAiB,GAC5B,aAAa,GAAG,IAAI,CAItB;AAED,yFAAyF;AACzF,wBAAgB,2BAA2B,CACvC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,iBAAiB,GAC5B,aAAa,CAgBf;AA2OD,wEAAwE;AACxE,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIzD"}

package/dist/forms/default-form-scaffold.js

@@ -0,0 +1,278 @@
+import { curateFromEntityInfo } from './curated-form-schema.js';
+const DEFAULT_ICON = 'fa-solid fa-circle-info';
+/**
+ * Build a working scaffold ComponentSpec for `entityName`. Returns `null` if
+ * the entity isn't registered.
+ *
+ * Scaffold rules (mirror CodeGen):
+ *   - Sections come from `EntityField.Category` + `GeneratedFormSectionType`.
+ *   - Top-section fields render above the section list.
+ *   - Field input type derives from `TSType` + `ValueListType` (textarea for
+ *     long strings, checkbox for booleans, datepicker for dates, select for
+ *     value lists, fk-picker for FKs, number for numeric).
+ *   - System Metadata section is always last and starts collapsed.
+ *   - 2-column grid by default; long-string and textarea fields go full-span.
+ */
+export function buildDefaultFormScaffold(entityName, provider) {
+    const entity = provider.EntityByName(entityName);
+    if (!entity)
+        return null;
+    return buildScaffoldFromEntityInfo(entity, provider);
+}
+/** Same as {@link buildDefaultFormScaffold} but takes an already-resolved EntityInfo. */
+export function buildScaffoldFromEntityInfo(entity, provider) {
+    const schema = curateFromEntityInfo(entity, provider);
+    const layout = computeSectionLayout(entity, schema);
+    const code = renderJsx(entity, schema, layout);
+    const name = sanitizeComponentName(`${entity.ClassName || entity.Name}Form`);
+    return {
+        name,
+        title: `${schema.displayName} Form`,
+        description: `Default form scaffold for ${schema.displayName}. Mirrors the CodeGen Angular layout. Customize freely.`,
+        type: 'Form',
+        componentRole: 'form',
+        location: 'embedded',
+        code,
+        functionalRequirements: defaultFunctionalRequirements(schema),
+        technicalDesign: defaultTechnicalDesign(schema, layout),
+    };
+}
+// ── section / field planning ─────────────────────────────────────────────
+function computeSectionLayout(entity, schema) {
+    const sections = new Map();
+    // Index for stable ordering: insertion order matches CodeGen behaviour
+    // because we walk entity.Fields, which is already sequence-ordered.
+    const topFields = [];
+    for (const field of entity.Fields) {
+        if (!field.IncludeInGeneratedForm)
+            continue;
+        if (field.Name?.startsWith('__mj_'))
+            continue; // audit
+        if (field.IsPrimaryKey)
+            continue; // PKs not editable in forms
+        if (field.IsVirtual)
+            continue; // virtual / computed
+        const sf = toScaffoldField(field, schema);
+        switch (field.GeneratedFormSectionType) {
+            case 'Top':
+                topFields.push(sf);
+                break;
+            case 'Category': {
+                const cat = (field.Category && field.Category.trim()) || 'Details';
+                ensureSection(sections, cat, iconForCategory(cat, entity), false).fields.push(sf);
+                break;
+            }
+            case 'Details':
+            default:
+                ensureSection(sections, 'Details', 'fa-solid fa-circle-info', false).fields.push(sf);
+                break;
+        }
+    }
+    // System metadata always last, collapsed by default
+    const systemFields = entity.Fields
+        .filter(f => f.Name === '__mj_CreatedAt' || f.Name === '__mj_UpdatedAt')
+        .map(f => ({
+        name: f.Name,
+        label: f.DisplayName || f.Name,
+        inputType: 'datepicker',
+        fullSpan: false,
+        readOnly: true,
+    }));
+    const ordered = [];
+    if (topFields.length > 0) {
+        ordered.push({ title: '', icon: '', fields: topFields, collapsed: false });
+    }
+    for (const sect of sections.values()) {
+        if (sect.fields.length > 0)
+            ordered.push(sect);
+    }
+    if (systemFields.length > 0) {
+        ordered.push({
+            title: 'System Metadata',
+            icon: 'fa-solid fa-cog',
+            fields: systemFields,
+            collapsed: true,
+        });
+    }
+    return ordered;
+}
+function ensureSection(map, title, icon, collapsed) {
+    let s = map.get(title);
+    if (!s) {
+        s = { title, icon, fields: [], collapsed };
+        map.set(title, s);
+    }
+    return s;
+}
+function toScaffoldField(field, schema) {
+    const curated = schema.fields.find(c => c.name === field.Name);
+    const label = field.DisplayName && field.DisplayName !== field.Name ? field.DisplayName : field.Name;
+    const inputType = pickInputType(field, curated);
+    const fullSpan = inputType === 'textarea' || (field.MaxLength && field.MaxLength > 100) || false;
+    return {
+        name: field.Name,
+        label,
+        inputType,
+        relatedEntity: field.RelatedEntity || undefined,
+        allowedValues: curated?.allowedValues,
+        fullSpan: !!fullSpan,
+        readOnly: !!field.ReadOnly,
+    };
+}
+function pickInputType(field, curated) {
+    // FK takes precedence — FKs may be numeric/uuid but we want a picker.
+    if (field.RelatedEntity)
+        return 'fk';
+    if (curated?.type === 'enum')
+        return 'select';
+    if (field.ValueListType && field.ValueListType !== 'None')
+        return 'select';
+    if (field.TSType === 'boolean')
+        return 'checkbox';
+    if (field.TSType === 'Date')
+        return 'datepicker';
+    if (field.TSType === 'number')
+        return 'number';
+    // long strings → textarea
+    if ((field.MaxLength ?? 0) < 0 || (field.MaxLength ?? 0) > 1000)
+        return 'textarea';
+    return 'textbox';
+}
+function iconForCategory(category, _entity) {
+    const lower = category.toLowerCase();
+    if (/address|location|geo/.test(lower))
+        return 'fa-solid fa-map-marker-alt';
+    if (/contact|email|phone/.test(lower))
+        return 'fa-solid fa-address-card';
+    if (/price|cost|payment|financial|billing|invoice/.test(lower))
+        return 'fa-solid fa-dollar-sign';
+    if (/date|time|schedule|calendar/.test(lower))
+        return 'fa-solid fa-calendar';
+    if (/status|state|stage|workflow/.test(lower))
+        return 'fa-solid fa-flag';
+    if (/metadata|technical|system|config/.test(lower))
+        return 'fa-solid fa-cog';
+    if (/identity|profile|user|account/.test(lower))
+        return 'fa-solid fa-fingerprint';
+    if (/description|notes|comment|narrative/.test(lower))
+        return 'fa-solid fa-align-left';
+    return DEFAULT_ICON;
+}
+// ── JSX rendering ────────────────────────────────────────────────────────
+function renderJsx(entity, schema, layout) {
+    const componentName = sanitizeComponentName(`${entity.ClassName || entity.Name}Form`);
+    const renderField = (f, indent) => {
+        const span = f.fullSpan ? ' span={2}' : '';
+        const readOnly = f.readOnly ? ' readOnly' : '';
+        // The scaffold uses host-provided primitives we register in the
+        // harness. The agent or user can swap these for arbitrary JSX.
+        return `${indent}<Field name="${f.name}" label="${escapeJsx(f.label)}"${span}${readOnly} />`;
+    };
+    const renderSection = (s, indent) => {
+        if (!s.title) {
+            // top-area fields render bare
+            return s.fields.map(f => renderField(f, indent)).join('\n');
+        }
+        const grid = s.fields.map(f => renderField(f, `${indent}    `)).join('\n');
+        return [
+            `${indent}<Section title="${escapeJsx(s.title)}" icon="${s.icon}"${s.collapsed ? ' defaultCollapsed' : ''}>`,
+            `${indent}    <Grid columns={2}>`,
+            grid,
+            `${indent}    </Grid>`,
+            `${indent}</Section>`,
+        ].join('\n');
+    };
+    const body = layout.map(s => renderSection(s, '            ')).join('\n\n');
+    return `function ${componentName}(props) {
+    // FormHostProps — see @memberjunction/interactive-component-types/forms
+    const { record, entityMetadata, mode, canEdit, canDelete, canCreate, callbacks, utilities } = props;
+
+    // Local edit state. Saves flow through callbacks.NotifyEvent('BeforeSave', { dirtyFields });
+    // the wrapper applies dirtyFields to its BaseEntity and persists.
+    const [draft, setDraft] = React.useState(record || {});
+    const [dirtyFields, setDirty] = React.useState({});
+
+    // Re-flow when host pushes a new record (after save, after mode change, etc.)
+    React.useEffect(() => {
+        if (record) {
+            setDraft(record);
+            setDirty({});
+        }
+    }, [record]);
+
+    // Toolbar contract: the host's record-form-container has Save / Cancel buttons.
+    // Register methods so those buttons drive our save flow.
+    React.useEffect(() => {
+        if (!callbacks?.RegisterMethod) return;
+        callbacks.RegisterMethod('RequestSave', () => {
+            callbacks.NotifyEvent('BeforeSave', { dirtyFields, cancel: false });
+        });
+        callbacks.RegisterMethod('RequestCancel', () => {
+            setDraft(record || {});
+            setDirty({});
+        });
+    }, [callbacks, dirtyFields, record]);
+
+    const onField = (name, value) => {
+        setDraft(d => ({ ...d, [name]: value }));
+        setDirty(d => ({ ...d, [name]: value }));
+        callbacks?.NotifyEvent?.('FieldChanged', { fieldName: name, value });
+    };
+
+    // Convenience: pass everything needed by the registered <Field> primitive.
+    const Field = ({ name, label, span, readOnly }) => {
+        const fieldMeta = entityMetadata?.fields?.find(x => x.name === name);
+        return utilities.components.FormField({
+            name, label, span, readOnly: readOnly || !canEdit || mode === 'view',
+            value: draft?.[name],
+            onChange: onField,
+            field: fieldMeta,
+        });
+    };
+    const Section = utilities.components.FormSection;
+    const Grid = utilities.components.FormGrid;
+
+    return (
+        <div className="mj-form" data-entity="${escapeJsx(schema.entityName)}">
+${body || '            {/* no fields visible — entity has no IncludeInGeneratedForm fields */}'}
+        </div>
+    );
+}`;
+}
+function defaultFunctionalRequirements(schema) {
+    return [
+        `Default form for ${schema.displayName}.`,
+        '',
+        `Renders all editable fields for the entity in the layout defined by EntityField metadata`,
+        `(Category, GeneratedFormSectionType, Sequence). Mirrors the Angular CodeGen form so the`,
+        `runtime form path achieves day-one parity with the default Angular form.`,
+        '',
+        'Supports view, edit, and create modes. Emits BeforeSave with dirty-field deltas.',
+    ].join('\n');
+}
+function defaultTechnicalDesign(schema, layout) {
+    return [
+        `Bound to entity '${schema.entityName}'.`,
+        '',
+        'Layout:',
+        ...layout.map(s => s.title
+            ? `  - ${s.title} (${s.fields.length} field${s.fields.length === 1 ? '' : 's'}${s.collapsed ? ', collapsed by default' : ''})`
+            : `  - [Top area] (${s.fields.length} field${s.fields.length === 1 ? '' : 's'})`),
+        '',
+        'Host contract:',
+        '  - FormHostProps.record is the live snapshot from BaseEntity.',
+        '  - callbacks.NotifyEvent(\'BeforeSave\', { dirtyFields }) commits.',
+        '  - RegisterMethod(\'RequestSave\') / (\'RequestCancel\') hook into the host toolbar.',
+    ].join('\n');
+}
+/** Strip non-identifier characters so the function name is valid JS. */
+export function sanitizeComponentName(raw) {
+    const cleaned = raw.replace(/[^A-Za-z0-9_]/g, '');
+    if (!cleaned || /^\d/.test(cleaned))
+        return `Form_${cleaned || 'Component'}`;
+    return cleaned.charAt(0).toUpperCase() + cleaned.slice(1);
+}
+function escapeJsx(s) {
+    return s.replace(/"/g, '&quot;');
+}
+//# sourceMappingURL=default-form-scaffold.js.map

package/dist/forms/default-form-scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-form-scaffold.js","sourceRoot":"","sources":["../../src/forms/default-form-scaffold.ts"],"names":[],"mappings":"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"}

package/dist/forms/form-event-names.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Standard event names for components that declare `componentRole: 'form'`.
+ *
+ * The host (`InteractiveFormComponent` on the Angular side) listens for these
+ * events on the React component via the existing `NotifyEvent` callback and
+ * the cancelable/paired event infrastructure in `component-events.ts`.
+ *
+ * Every name is exported as a `const` so authoring agents and component code
+ * can reference the same string without typos.
+ */
+import type { CancelableEventArgs, AfterEventArgs, BaseEventArgs } from '../component-events.js';
+export declare const FormEventNames: {
+    /** Cancelable. Host requests save. Component emits with the dirty-field diff. */
+    readonly BeforeSave: "BeforeSave";
+    /** Reports save outcome. Paired with BeforeSave. */
+    readonly AfterSave: "AfterSave";
+    /** Cancelable. Host requests delete. */
+    readonly BeforeDelete: "BeforeDelete";
+    /** Reports delete outcome. Paired with BeforeDelete. */
+    readonly AfterDelete: "AfterDelete";
+    /** Cancelable. Form asks host (or vice versa) to switch between view/edit. */
+    readonly EditModeChangeRequested: "EditModeChangeRequested";
+    /** Reports a single field change. Drives dirty tracking on the host. */
+    readonly FieldChanged: "FieldChanged";
+    /** Reports dirty state transitions. */
+    readonly DirtyStateChanged: "DirtyStateChanged";
+    /** Reports validity transitions. */
+    readonly ValidationChanged: "ValidationChanged";
+};
+export type FormEventName = typeof FormEventNames[keyof typeof FormEventNames];
+/** Args for `BeforeSave`. Component fills `dirtyFields` with the typed diff. */
+export interface FormBeforeSaveArgs extends CancelableEventArgs {
+    dirtyFields: Record<string, unknown>;
+}
+/** Args for `AfterSave`. */
+export interface FormAfterSaveArgs extends AfterEventArgs {
+    /** Optional: the saved record snapshot (post-save server values). */
+    record?: Record<string, unknown>;
+}
+/** Args for `BeforeDelete`. No payload beyond the cancel flag. */
+export type FormBeforeDeleteArgs = CancelableEventArgs;
+/** Args for `AfterDelete`. */
+export type FormAfterDeleteArgs = AfterEventArgs;
+/** Args for `EditModeChangeRequested`. */
+export interface FormEditModeChangeRequestedArgs extends CancelableEventArgs {
+    requestedMode: 'view' | 'edit';
+}
+/** Args for `FieldChanged`. */
+export interface FormFieldChangedArgs extends BaseEventArgs {
+    fieldName: string;
+    oldValue: unknown;
+    newValue: unknown;
+}
+/** Args for `DirtyStateChanged`. */
+export interface FormDirtyStateChangedArgs extends BaseEventArgs {
+    isDirty: boolean;
+    dirtyFieldCount: number;
+}
+/** Args for `ValidationChanged`. */
+export interface FormValidationChangedArgs extends BaseEventArgs {
+    isValid: boolean;
+    errors?: string[];
+}
+//# sourceMappingURL=form-event-names.d.ts.map

package/dist/forms/form-event-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-event-names.d.ts","sourceRoot":"","sources":["../../src/forms/form-event-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE9F,eAAO,MAAM,cAAc;IACvB,iFAAiF;;IAEjF,oDAAoD;;IAEpD,wCAAwC;;IAExC,wDAAwD;;IAExD,8EAA8E;;IAE9E,wEAAwE;;IAExE,uCAAuC;;IAEvC,oCAAoC;;CAE9B,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAE/E,gFAAgF;AAChF,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC3D,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,4BAA4B;AAC5B,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACrD,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,kEAAkE;AAClE,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAEvD,8BAA8B;AAC9B,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAEjD,0CAA0C;AAC1C,MAAM,WAAW,+BAAgC,SAAQ,mBAAmB;IACxE,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AAED,+BAA+B;AAC/B,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED,oCAAoC;AACpC,MAAM,WAAW,yBAA0B,SAAQ,aAAa;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED,oCAAoC;AACpC,MAAM,WAAW,yBAA0B,SAAQ,aAAa;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/dist/forms/form-event-names.js

@@ -0,0 +1,29 @@
+/**
+ * Standard event names for components that declare `componentRole: 'form'`.
+ *
+ * The host (`InteractiveFormComponent` on the Angular side) listens for these
+ * events on the React component via the existing `NotifyEvent` callback and
+ * the cancelable/paired event infrastructure in `component-events.ts`.
+ *
+ * Every name is exported as a `const` so authoring agents and component code
+ * can reference the same string without typos.
+ */
+export const FormEventNames = {
+    /** Cancelable. Host requests save. Component emits with the dirty-field diff. */
+    BeforeSave: 'BeforeSave',
+    /** Reports save outcome. Paired with BeforeSave. */
+    AfterSave: 'AfterSave',
+    /** Cancelable. Host requests delete. */
+    BeforeDelete: 'BeforeDelete',
+    /** Reports delete outcome. Paired with BeforeDelete. */
+    AfterDelete: 'AfterDelete',
+    /** Cancelable. Form asks host (or vice versa) to switch between view/edit. */
+    EditModeChangeRequested: 'EditModeChangeRequested',
+    /** Reports a single field change. Drives dirty tracking on the host. */
+    FieldChanged: 'FieldChanged',
+    /** Reports dirty state transitions. */
+    DirtyStateChanged: 'DirtyStateChanged',
+    /** Reports validity transitions. */
+    ValidationChanged: 'ValidationChanged',
+};
+//# sourceMappingURL=form-event-names.js.map

package/dist/forms/form-event-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-event-names.js","sourceRoot":"","sources":["../../src/forms/form-event-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B,iFAAiF;IACjF,UAAU,EAAE,YAAY;IACxB,oDAAoD;IACpD,SAAS,EAAE,WAAW;IACtB,wCAAwC;IACxC,YAAY,EAAE,cAAc;IAC5B,wDAAwD;IACxD,WAAW,EAAE,aAAa;IAC1B,8EAA8E;IAC9E,uBAAuB,EAAE,yBAAyB;IAClD,wEAAwE;IACxE,YAAY,EAAE,cAAc;IAC5B,uCAAuC;IACvC,iBAAiB,EAAE,mBAAmB;IACtC,oCAAoC;IACpC,iBAAiB,EAAE,mBAAmB;CAChC,CAAC"}

package/dist/forms/form-host-props-fixture.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Fixture `FormHostProps` builder. Renders a form-role component against
+ * synthetic, type-appropriate data when no real BaseEntity is available —
+ * used by:
+ *   - Component Studio's live preview (designing a form before any record exists)
+ *   - The chat artifact viewer when the spec's declared entity is unknown,
+ *     unresolvable, or has no rows yet
+ *
+ * Field-value rules (kept small + deterministic so the preview is stable
+ * across re-renders):
+ *   string                       → "Sample <FieldName>"
+ *   string with maxLength <= 24  → "Sample"
+ *   number                       → 42
+ *   boolean                      → true
+ *   datetime                     → today, ISO format
+ *   enum                         → allowedValues[0]
+ *   foreign-key                  → { ID: STABLE_FK_UUID, <displayField>: "Sample <TargetEntity>" }
+ *   primary key                  → STABLE_FIXTURE_UUID
+ */
+import type { CuratedFormSchema } from './curated-form-schema.js';
+import type { FormHostProps, FormMode } from './form-host-props.js';
+export declare function buildFixtureFormHostProps(schema: CuratedFormSchema, mode?: FormMode): FormHostProps;
+//# sourceMappingURL=form-host-props-fixture.d.ts.map

package/dist/forms/form-host-props-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-host-props-fixture.d.ts","sourceRoot":"","sources":["../../src/forms/form-host-props-fixture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAoB,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGjE,wBAAgB,yBAAyB,CACrC,MAAM,EAAE,iBAAiB,EACzB,IAAI,GAAE,QAAiB,GACxB,aAAa,CAyBf"}

package/dist/forms/form-host-props-fixture.js

@@ -0,0 +1,74 @@
+export function buildFixtureFormHostProps(schema, mode = 'view') {
+    const record = {};
+    for (const f of schema.fields) {
+        record[f.name] = fixtureValue(f);
+    }
+    const primaryKeyFields = schema.fields.filter(f => f.isPrimaryKey);
+    const primaryKey = mode === 'create' || primaryKeyFields.length === 0
+        ? null
+        : Object.fromEntries(primaryKeyFields.map(f => [f.name, record[f.name]]));
+    return {
+        entityName: schema.entityName,
+        primaryKey,
+        record,
+        entityMetadata: {
+            fields: schemaFieldsToSimple(schema),
+            displayName: schema.displayName,
+            nameField: schema.nameField,
+        },
+        mode,
+        canEdit: true,
+        canDelete: true,
+        canCreate: true,
+    };
+}
+/** Convert curated fields to the minimal SimpleEntityFieldInfo shape FormHostProps needs. */
+function schemaFieldsToSimple(schema) {
+    return schema.fields.map(f => ({
+        name: f.name,
+        sequence: f.sequence,
+        defaultInView: !f.isPrimaryKey,
+        type: f.type,
+        allowsNull: !f.required,
+        isPrimaryKey: f.isPrimaryKey,
+        possibleValues: f.allowedValues,
+        description: f.description,
+        // SimpleEntityFieldInfo is a class; we cast to the structural shape
+        // — the React component doesn't call methods on it, only reads.
+    }));
+}
+function fixtureValue(f) {
+    if (f.isPrimaryKey) {
+        return STABLE_FIXTURE_ID;
+    }
+    switch (f.type) {
+        case 'number':
+            return 42;
+        case 'boolean':
+            return true;
+        case 'datetime':
+            return new Date().toISOString();
+        case 'enum':
+            return f.allowedValues?.[0] ?? null;
+        case 'foreign-key': {
+            const targetEntity = f.references?.entity ?? 'Related';
+            const displayField = f.references?.displayField ?? 'Name';
+            return {
+                ID: STABLE_FIXTURE_FK_ID,
+                [displayField]: `Sample ${targetEntity.replace(/^MJ:\s*/, '')}`,
+            };
+        }
+        case 'string':
+        default: {
+            const max = f.maxLength ?? 0;
+            if (max > 0 && max <= 24) {
+                return 'Sample';
+            }
+            return `Sample ${f.displayName ?? f.name}`;
+        }
+    }
+}
+/** Stable fake UUIDs so re-renders don't churn React component identity. */
+const STABLE_FIXTURE_ID = '00000000-0000-0000-0000-000000000001';
+const STABLE_FIXTURE_FK_ID = '00000000-0000-0000-0000-000000000002';
+//# sourceMappingURL=form-host-props-fixture.js.map

package/dist/forms/form-host-props-fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-host-props-fixture.js","sourceRoot":"","sources":["../../src/forms/form-host-props-fixture.ts"],"names":[],"mappings":"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"}

package/dist/forms/form-host-props.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Props the host (`InteractiveFormComponent`) passes to a form-role component.
+ *
+ * The React side never touches `BaseEntity` — it operates against this plain
+ * snapshot. When the form needs to commit, it fires `BeforeSave` with the
+ * dirty-field diff and the host applies that to the BaseEntity and calls
+ * `record.Save()`. This keeps the React contract portable and avoids the
+ * `.Set()` stringly-typed trap.
+ */
+import { SimpleEntityFieldInfo } from '../data-requirements.js';
+/** Mode the form is currently rendered in. */
+export type FormMode = 'view' | 'edit' | 'create';
+/** Subset of the entity's metadata the form needs at render time. */
+export interface FormEntityMetadata {
+    /** Field list, simplified (plain objects, no BaseEntity methods). */
+    fields: SimpleEntityFieldInfo[];
+    /** Human-readable name of the entity (e.g. "Customer"). */
+    displayName: string;
+    /** Optional: the field used as the record's display name (e.g. "Name", "Title"). */
+    nameField?: string;
+}
+/**
+ * Props passed to every form-role component. Plain data, no instance methods.
+ *
+ * `primaryKey` is serialized as a plain object — the React side does not need
+ * the `CompositeKey` class; the Angular wrapper reconstructs one when it has to
+ * load or save. `null` indicates a not-yet-persisted record (create flow).
+ */
+export interface FormHostProps {
+    entityName: string;
+    /** Composite-key field values as a plain object, or `null` for new records. */
+    primaryKey: Record<string, unknown> | null;
+    /** Plain snapshot of the record (BaseEntity.GetAll() result). */
+    record: Record<string, unknown>;
+    entityMetadata: FormEntityMetadata;
+    mode: FormMode;
+    canEdit: boolean;
+    canDelete: boolean;
+    canCreate: boolean;
+}
+//# sourceMappingURL=form-host-props.d.ts.map

package/dist/forms/form-host-props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-host-props.d.ts","sourceRoot":"","sources":["../../src/forms/form-host-props.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,8CAA8C;AAC9C,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAElD,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IAC/B,qEAAqE;IACrE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC3C,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,cAAc,EAAE,kBAAkB,CAAC;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACtB"}

package/dist/forms/form-host-props.js

@@ -0,0 +1,11 @@
+/**
+ * Props the host (`InteractiveFormComponent`) passes to a form-role component.
+ *
+ * The React side never touches `BaseEntity` — it operates against this plain
+ * snapshot. When the form needs to commit, it fires `BeforeSave` with the
+ * dirty-field diff and the host applies that to the BaseEntity and calls
+ * `record.Save()`. This keeps the React contract portable and avoids the
+ * `.Set()` stringly-typed trap.
+ */
+export {};
+//# sourceMappingURL=form-host-props.js.map

package/dist/forms/form-host-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-host-props.js","sourceRoot":"","sources":["../../src/forms/form-host-props.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/forms/form-method-names.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Standard method names a form-role component registers with the host via
+ * `RegisterMethod`. The host (`InteractiveFormComponent`) invokes these in
+ * response to toolbar actions, sidebar updates, etc.
+ *
+ * Components don't have to implement every method — `RequestSave` and
+ * `RequestCancel` are the minimum useful set.
+ */
+export declare const FormMethodNames: {
+    /** Host (toolbar) asks the form to start its save flow. Form fires `BeforeSave`. */
+    readonly RequestSave: "RequestSave";
+    /** Discard edits. Form fires `EditModeChangeRequested` → 'view'. */
+    readonly RequestCancel: "RequestCancel";
+    /** Host pushes a mode change (e.g. entered edit via the toolbar). */
+    readonly SetEditMode: "SetEditMode";
+    /** Host pulls a single field value (used by related panels). */
+    readonly GetFieldValue: "GetFieldValue";
+    /** Host pushes a single field value (used by sidebars / related panels). */
+    readonly SetFieldValue: "SetFieldValue";
+};
+export type FormMethodName = typeof FormMethodNames[keyof typeof FormMethodNames];
+/** Signature for the `SetEditMode` method. */
+export type FormSetEditModeArgs = {
+    mode: 'view' | 'edit';
+};
+/** Signature for the `GetFieldValue` method. */
+export type FormGetFieldValueArgs = {
+    fieldName: string;
+};
+/** Signature for the `SetFieldValue` method. */
+export type FormSetFieldValueArgs = {
+    fieldName: string;
+    value: unknown;
+};
+//# sourceMappingURL=form-method-names.d.ts.map

package/dist/forms/form-method-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-method-names.d.ts","sourceRoot":"","sources":["../../src/forms/form-method-names.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,eAAe;IACxB,oFAAoF;;IAEpF,oEAAoE;;IAEpE,qEAAqE;;IAErE,gEAAgE;;IAEhE,4EAA4E;;CAEtE,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAElF,8CAA8C;AAC9C,MAAM,MAAM,mBAAmB,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AAE5D,gDAAgD;AAChD,MAAM,MAAM,qBAAqB,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,gDAAgD;AAChD,MAAM,MAAM,qBAAqB,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC"}

package/dist/forms/form-method-names.js

@@ -0,0 +1,21 @@
+/**
+ * Standard method names a form-role component registers with the host via
+ * `RegisterMethod`. The host (`InteractiveFormComponent`) invokes these in
+ * response to toolbar actions, sidebar updates, etc.
+ *
+ * Components don't have to implement every method — `RequestSave` and
+ * `RequestCancel` are the minimum useful set.
+ */
+export const FormMethodNames = {
+    /** Host (toolbar) asks the form to start its save flow. Form fires `BeforeSave`. */
+    RequestSave: 'RequestSave',
+    /** Discard edits. Form fires `EditModeChangeRequested` → 'view'. */
+    RequestCancel: 'RequestCancel',
+    /** Host pushes a mode change (e.g. entered edit via the toolbar). */
+    SetEditMode: 'SetEditMode',
+    /** Host pulls a single field value (used by related panels). */
+    GetFieldValue: 'GetFieldValue',
+    /** Host pushes a single field value (used by sidebars / related panels). */
+    SetFieldValue: 'SetFieldValue',
+};
+//# sourceMappingURL=form-method-names.js.map

package/dist/forms/form-method-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-method-names.js","sourceRoot":"","sources":["../../src/forms/form-method-names.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC3B,oFAAoF;IACpF,WAAW,EAAE,aAAa;IAC1B,oEAAoE;IACpE,aAAa,EAAE,eAAe;IAC9B,qEAAqE;IACrE,WAAW,EAAE,aAAa;IAC1B,gEAAgE;IAChE,aAAa,EAAE,eAAe;IAC9B,4EAA4E;IAC5E,aAAa,EAAE,eAAe;CACxB,CAAC"}

package/dist/forms/form-spec-info.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Small pure helpers for extracting form-binding info from a `ComponentSpec`.
+ *
+ * The artifact viewer's form-aware branch and the Form Builder dashboard
+ * both need to answer "which entity does this form bind to?" — the answer
+ * lives in either `spec.entityName` (explicit) or
+ * `spec.dataRequirements.entities[0].name` (inferred). Centralizing the
+ * resolution rule here means both surfaces produce the same answer and a
+ * spec author only has to learn one convention.
+ */
+import type { ComponentSpec } from '../component-spec.js';
+/**
+ * Resolve the entity the form binds to.
+ *
+ * Lookup order:
+ *   1. `spec.entityName` if set (trimmed; empty strings → null)
+ *   2. `spec.dataRequirements.entities[0].name` if present
+ *   3. `null` — caller decides whether to fall back to a fixture or warn
+ */
+export declare function getDeclaredFormEntityName(spec: (ComponentSpec & {
+    entityName?: unknown;
+}) | null | undefined): string | null;
+//# sourceMappingURL=form-spec-info.d.ts.map

package/dist/forms/form-spec-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-spec-info.d.ts","sourceRoot":"","sources":["../../src/forms/form-spec-info.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAIrC,IAAI,EAAE,CAAC,aAAa,GAAG;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GACpE,MAAM,GAAG,IAAI,CAYf"}

package/dist/forms/form-spec-info.js

@@ -0,0 +1,27 @@
+/**
+ * Resolve the entity the form binds to.
+ *
+ * Lookup order:
+ *   1. `spec.entityName` if set (trimmed; empty strings → null)
+ *   2. `spec.dataRequirements.entities[0].name` if present
+ *   3. `null` — caller decides whether to fall back to a fixture or warn
+ */
+export function getDeclaredFormEntityName(
+// `entityName` isn't a typed ComponentSpec field — it's an extension some
+// specs carry. Use a structural input that allows it without breaking on
+// strict-mode Pick<>.
+spec) {
+    if (!spec)
+        return null;
+    const direct = spec.entityName;
+    if (typeof direct === 'string' && direct.trim().length > 0) {
+        return direct.trim();
+    }
+    const dr = spec.dataRequirements;
+    const first = dr?.entities?.[0]?.name;
+    if (typeof first === 'string' && first.trim().length > 0) {
+        return first.trim();
+    }
+    return null;
+}
+//# sourceMappingURL=form-spec-info.js.map

package/dist/forms/form-spec-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-spec-info.js","sourceRoot":"","sources":["../../src/forms/form-spec-info.ts"],"names":[],"mappings":"AAYA;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB;AACrC,0EAA0E;AAC1E,yEAAyE;AACzE,sBAAsB;AACtB,IAAmE;IAEnE,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,MAAM,GAAI,IAA4C,CAAC,UAAU,CAAC;IACxE,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,CAAC,gBAAmF,CAAC;IACpG,MAAM,KAAK,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/forms/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Form-role contract for components that declare `componentRole: 'form'`.
+ *
+ * Three small pieces, kept on a subpath so the generic IC package stays clean:
+ *   - `FormHostProps` — what the host passes the component
+ *   - `FormEventNames` + typed arg interfaces — events the component emits
+ *   - `FormMethodNames` + arg types — methods the component registers
+ *
+ * Hand-written, Studio-built, and agent-generated form components all target
+ * this contract. Import via the subpath:
+ *
+ *     import { FormHostProps, FormEventNames, FormMethodNames }
+ *         from '@memberjunction/interactive-component-types/forms';
+ *
+ * Note: this is the npm package name — the plan doc shorthands it as
+ * `@memberjunction/interactivecomponents`, which is the directory name, not
+ * the published name.
+ */
+export * from './form-host-props.js';
+export * from './form-event-names.js';
+export * from './form-method-names.js';
+export * from './curated-form-schema.js';
+export * from './default-form-scaffold.js';
+export * from './form-host-props-fixture.js';
+export * from './form-spec-info.js';
+import type { ComponentSpec } from '../component-spec.js';
+/** True iff the spec commits to the form-role contract. */
+export declare function isFormRole(spec: Pick<ComponentSpec, 'componentRole'>): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/forms/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/forms/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AAEjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,2DAA2D;AAC3D,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,GAAG,OAAO,CAE9E"}

package/dist/forms/index.js

@@ -0,0 +1,30 @@
+/**
+ * Form-role contract for components that declare `componentRole: 'form'`.
+ *
+ * Three small pieces, kept on a subpath so the generic IC package stays clean:
+ *   - `FormHostProps` — what the host passes the component
+ *   - `FormEventNames` + typed arg interfaces — events the component emits
+ *   - `FormMethodNames` + arg types — methods the component registers
+ *
+ * Hand-written, Studio-built, and agent-generated form components all target
+ * this contract. Import via the subpath:
+ *
+ *     import { FormHostProps, FormEventNames, FormMethodNames }
+ *         from '@memberjunction/interactive-component-types/forms';
+ *
+ * Note: this is the npm package name — the plan doc shorthands it as
+ * `@memberjunction/interactivecomponents`, which is the directory name, not
+ * the published name.
+ */
+export * from './form-host-props.js';
+export * from './form-event-names.js';
+export * from './form-method-names.js';
+export * from './curated-form-schema.js';
+export * from './default-form-scaffold.js';
+export * from './form-host-props-fixture.js';
+export * from './form-spec-info.js';
+/** True iff the spec commits to the form-role contract. */
+export function isFormRole(spec) {
+    return spec.componentRole === 'form';
+}
+//# sourceMappingURL=index.js.map

package/dist/forms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/forms/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AAIjC,2DAA2D;AAC3D,MAAM,UAAU,UAAU,CAAC,IAA0C;IACjE,OAAO,IAAI,CAAC,aAAa,KAAK,MAAM,CAAC;AACzC,CAAC"}

package/package.json

@@ -1,10 +1,22 @@
 {
   "name": "@memberjunction/interactive-component-types",
   "type": "module",
-  "version": "5.37.0",
+  "version": "5.39.0",
   "description": "MemberJunction: Interactive Component - Type specifications for MJ Interactive UI Componentry",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./forms": {
+      "types": "./dist/forms/index.d.ts",
+      "import": "./dist/forms/index.js",
+      "default": "./dist/forms/index.js"
+    }
+  },
   "files": [
     "/dist"
   ],
@@ -20,8 +32,8 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@memberjunction/core": "5.37.0",
-    "@memberjunction/ai-vectors-memory": "5.37.0"
+    "@memberjunction/core": "5.39.0",
+    "@memberjunction/ai-vectors-memory": "5.39.0"
   },
   "repository": {
     "type": "git",