@memberjunction/interactive-component-types 6.2.0-edge.1 → 6.2.0-edge.3

package/dist/component-spec.d.ts

@@ -2,12 +2,13 @@ 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";
+import type { FormContributionSpec } from "./forms/form-contribution-spec.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';
+export type ComponentRole = 'form' | 'form-panel' | '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,
@@ -204,11 +205,27 @@ export declare class ComponentSpec {
      *
      * - `form`: implements `FormHostProps` + standard form events/methods (see `@memberjunction/interactivecomponents/forms`).
      *   Hosted by `InteractiveFormComponent` against a `BaseEntity` record.
+     * - `form-panel`: one contribution on an entity form (hero, pane, related-grid claim). Implements
+     *   `FormPanelHostProps` + `FormPanelEventNames` / `FormPanelMethodNames`; hosted by
+     *   `InteractiveFormPanelComponent` inside `<mj-form-panel-slot>`.
      * - `dashboard` | `widget` | `report` | `detail-pane`: reserved for future role contracts.
      *
      * Unset = a generic component, mounted directly. No behavior change for existing components.
      */
     componentRole?: ComponentRole;
+    /**
+     * Canonical entity name a `form` or `form-panel` component binds to. For a `form`, hosts
+     * resolve the entity from this first, then `dataRequirements.entities[0].name`. A
+     * `form-panel` must set it: a related-grid panel usually lists the child entity first, so
+     * the fallback would name the wrong form.
+     */
+    entityName?: string;
+    /**
+     * Registration intent for `componentRole: 'form-panel'` — where the panel mounts and
+     * what it claims. Consumers (Skip apply flow, Form Builder, `mj sync`) turn this into a
+     * `MJ: Entity Form Contributions` row. Never carries precedence; that is a host decision.
+     */
+    formContribution?: FormContributionSpec;
     /**
      * 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":"AA0JA;;GAEG;AACH,MAAM,OAAO,aAAa;CA0MzB;AAAA,CAAC"}
+{"version":3,"file":"component-spec.js","sourceRoot":"","sources":["../src/component-spec.ts"],"names":[],"mappings":"AA2JA;;GAEG;AACH,MAAM,OAAO,aAAa;CA4NzB;AAAA,CAAC"}

package/dist/forms/form-contribution-key.d.ts

@@ -0,0 +1,50 @@
+import type { FormContributionSpec } from './form-contribution-spec.js';
+/**
+ * Keys a form contribution is identified by, and the section keys it is matched against.
+ *
+ * The server actions, the apply flow and the renderer all derive keys here, so a key written
+ * on one side is the key the other side computes.
+ */
+/**
+ * Characters a contribution key may contain.
+ *
+ * Keys are compared in SQL filters and matched by `MJ: Form Chrome Rules`, and they can arrive
+ * from an LLM. A key that cannot contain a quote cannot break a filter. The space is permitted
+ * because a related-grid key embeds an entity name, and MJ entity names contain spaces.
+ */
+export declare const CONTRIBUTION_KEY_PATTERN: RegExp;
+/** Trims a join field and removes one wrapping `[...]` pair. */
+export declare function StripJoinFieldBrackets(join: string | null | undefined): string;
+/** `related:<entity>:<join>` — the key of a contribution that stands in for a related-entity grid. */
+export declare function RelatedContributionKey(relatedEntityName: string, joinField: string | null | undefined): string;
+/** True for a key {@link PanelContributionKey} derives. */
+export declare function IsPanelContributionKey(key: string | null | undefined): key is string;
+/**
+ * `panel:<component name>`, with characters {@link CONTRIBUTION_KEY_PATTERN} rejects folded
+ * to `-`. Null when the name carries nothing usable.
+ */
+export declare function PanelContributionKey(componentName: string | null | undefined): string | null;
+/**
+ * The key a contribution row carries. The key is the contribution's identity: the duplicate
+ * check, the rail and "replace an installed panel" all find a contribution by it.
+ *
+ * The author's key wins. A related-grid claim derives {@link RelatedContributionKey}. Anything
+ * else derives {@link PanelContributionKey} from the component name, which is stable across
+ * re-applies of the same panel and distinct between different ones. Null when none applies.
+ *
+ * @param relatedEntityName The registered name of the related entity the spec claims, or null.
+ * @param componentName The component name that seeds a panel key. Omit it to get no panel key.
+ */
+export declare function ResolveContributionWriteKey(spec: Pick<FormContributionSpec, 'contributionKey' | 'relatedJoinField'>, relatedEntityName: string | null, componentName?: string | null): string | null;
+/**
+ * camelCase with every character that is not a letter or digit removed. Matches `camelCase` in
+ * CodeGenLib `angular-codegen.ts`, which names the sections a generated form emits; any other
+ * result stops matching the section keys of forms already generated.
+ */
+export declare function FormSectionCamelCase(str: string): string;
+/**
+ * The section key a generated form gives a related-entity grid. When another grid on the form
+ * shows the same entity, the join field is appended so the two keys differ.
+ */
+export declare function RelatedGridSectionKey(relatedEntity: string, joinField: string | null | undefined, sharesRelatedEntity: boolean): string;
+//# sourceMappingURL=form-contribution-key.d.ts.map

package/dist/forms/form-contribution-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-contribution-key.d.ts","sourceRoot":"","sources":["../../src/forms/form-contribution-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE;;;;;GAKG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,QAA8B,CAAC;AAEpE,gEAAgE;AAChE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAE9E;AAED,sGAAsG;AACtG,wBAAgB,sBAAsB,CAAC,iBAAiB,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAE9G;AAID,2DAA2D;AAC3D,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,GAAG,IAAI,MAAM,CAEpF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAS5F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACvC,IAAI,EAAE,IAAI,CAAC,oBAAoB,EAAE,iBAAiB,GAAG,kBAAkB,CAAC,EACxE,iBAAiB,EAAE,MAAM,GAAG,IAAI,EAChC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAC9B,MAAM,GAAG,IAAI,CAKf;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUxD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACjC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,mBAAmB,EAAE,OAAO,GAC7B,MAAM,CAIR"}

package/dist/forms/form-contribution-key.js

@@ -0,0 +1,86 @@
+/**
+ * Keys a form contribution is identified by, and the section keys it is matched against.
+ *
+ * The server actions, the apply flow and the renderer all derive keys here, so a key written
+ * on one side is the key the other side computes.
+ */
+/**
+ * Characters a contribution key may contain.
+ *
+ * Keys are compared in SQL filters and matched by `MJ: Form Chrome Rules`, and they can arrive
+ * from an LLM. A key that cannot contain a quote cannot break a filter. The space is permitted
+ * because a related-grid key embeds an entity name, and MJ entity names contain spaces.
+ */
+export const CONTRIBUTION_KEY_PATTERN = /^[A-Za-z0-9:._ -]{1,256}$/;
+/** Trims a join field and removes one wrapping `[...]` pair. */
+export function StripJoinFieldBrackets(join) {
+    return (join ?? '').trim().replace(/^\[/, '').replace(/\]$/, '');
+}
+/** `related:<entity>:<join>` — the key of a contribution that stands in for a related-entity grid. */
+export function RelatedContributionKey(relatedEntityName, joinField) {
+    return `related:${relatedEntityName.trim()}:${StripJoinFieldBrackets(joinField)}`;
+}
+const PANEL_KEY_PREFIX = 'panel:';
+/** True for a key {@link PanelContributionKey} derives. */
+export function IsPanelContributionKey(key) {
+    return !!key && key.startsWith(PANEL_KEY_PREFIX);
+}
+/**
+ * `panel:<component name>`, with characters {@link CONTRIBUTION_KEY_PATTERN} rejects folded
+ * to `-`. Null when the name carries nothing usable.
+ */
+export function PanelContributionKey(componentName) {
+    const slug = (componentName ?? '')
+        .trim()
+        .replace(/[^A-Za-z0-9._ -]+/g, '-')
+        .replace(/-{2,}/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, 240)
+        .trim();
+    return slug ? `${PANEL_KEY_PREFIX}${slug}` : null;
+}
+/**
+ * The key a contribution row carries. The key is the contribution's identity: the duplicate
+ * check, the rail and "replace an installed panel" all find a contribution by it.
+ *
+ * The author's key wins. A related-grid claim derives {@link RelatedContributionKey}. Anything
+ * else derives {@link PanelContributionKey} from the component name, which is stable across
+ * re-applies of the same panel and distinct between different ones. Null when none applies.
+ *
+ * @param relatedEntityName The registered name of the related entity the spec claims, or null.
+ * @param componentName The component name that seeds a panel key. Omit it to get no panel key.
+ */
+export function ResolveContributionWriteKey(spec, relatedEntityName, componentName) {
+    const authored = spec.contributionKey?.trim();
+    if (authored)
+        return authored;
+    if (relatedEntityName?.trim())
+        return RelatedContributionKey(relatedEntityName, spec.relatedJoinField);
+    return PanelContributionKey(componentName);
+}
+/**
+ * camelCase with every character that is not a letter or digit removed. Matches `camelCase` in
+ * CodeGenLib `angular-codegen.ts`, which names the sections a generated form emits; any other
+ * result stops matching the section keys of forms already generated.
+ */
+export function FormSectionCamelCase(str) {
+    const sanitized = str.replace(/[^a-zA-Z0-9\s]/g, ' ');
+    let result = sanitized
+        .replace(/\s(.)/g, (_match, char) => char.toUpperCase())
+        .replace(/\s/g, '')
+        .replace(/^(.)/, (_match, char) => char.toLowerCase());
+    if (/^\d/.test(result)) {
+        result = '_' + result;
+    }
+    return result.length === 0 ? 'section' : result;
+}
+/**
+ * The section key a generated form gives a related-entity grid. When another grid on the form
+ * shows the same entity, the join field is appended so the two keys differ.
+ */
+export function RelatedGridSectionKey(relatedEntity, joinField, sharesRelatedEntity) {
+    return sharesRelatedEntity
+        ? FormSectionCamelCase(`${relatedEntity} ${StripJoinFieldBrackets(joinField)}`)
+        : FormSectionCamelCase(relatedEntity);
+}
+//# sourceMappingURL=form-contribution-key.js.map

package/dist/forms/form-contribution-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-contribution-key.js","sourceRoot":"","sources":["../../src/forms/form-contribution-key.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,2BAA2B,CAAC;AAEpE,gEAAgE;AAChE,MAAM,UAAU,sBAAsB,CAAC,IAA+B;IAClE,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,sBAAsB,CAAC,iBAAyB,EAAE,SAAoC;IAClG,OAAO,WAAW,iBAAiB,CAAC,IAAI,EAAE,IAAI,sBAAsB,CAAC,SAAS,CAAC,EAAE,CAAC;AACtF,CAAC;AAED,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAElC,2DAA2D;AAC3D,MAAM,UAAU,sBAAsB,CAAC,GAA8B;IACjE,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,aAAwC;IACzE,MAAM,IAAI,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC;SAC7B,IAAI,EAAE;SACN,OAAO,CAAC,oBAAoB,EAAE,GAAG,CAAC;SAClC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;SACb,IAAI,EAAE,CAAC;IACZ,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,gBAAgB,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACtD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,2BAA2B,CACvC,IAAwE,EACxE,iBAAgC,EAChC,aAA6B;IAE7B,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC;IAC9C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,IAAI,iBAAiB,EAAE,IAAI,EAAE;QAAE,OAAO,sBAAsB,CAAC,iBAAiB,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACvG,OAAO,oBAAoB,CAAC,aAAa,CAAC,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC5C,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IACtD,IAAI,MAAM,GAAG,SAAS;SACjB,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;SAC/D,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;SAClB,OAAO,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACnE,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC;IAC1B,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACjC,aAAqB,EACrB,SAAoC,EACpC,mBAA4B;IAE5B,OAAO,mBAAmB;QACtB,CAAC,CAAC,oBAAoB,CAAC,GAAG,aAAa,IAAI,sBAAsB,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/E,CAAC,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC;AAC9C,CAAC"}

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

@@ -0,0 +1,85 @@
+import type { ComponentSpec } from '../component-spec.js';
+/** Slot names — byte-identical to `FormPanelSlot` in @memberjunction/ng-base-forms. */
+export type FormContributionSlot = 'top-area' | 'before-fields' | 'after-fields' | 'after-related' | 'after-everything';
+export type FormContributionPresentation = 'panel' | 'bare';
+export type FormContributionInclusion = 'Primary' | 'More' | 'None';
+export type FormContributionChromeGroup = 'details' | 'more';
+export declare const DEFAULT_FORM_CONTRIBUTION_SLOT: FormContributionSlot;
+export declare const FORM_CONTRIBUTION_SLOTS: readonly FormContributionSlot[];
+/**
+ * The slots a generated form actually emits.
+ *
+ * CodeGen writes `before-fields`, `after-fields` and `after-related` into every form it
+ * produces, and the record container always terminates the fallback chain with
+ * `after-everything`. `top-area` is absent: no form emits it, so a panel aimed there
+ * falls through to the bottom.
+ *
+ * Used wherever a form's real slot set is not yet known, so a position nothing renders is
+ * never offered as a choice. A hand-written template can differ, which is why a form that
+ * can be read is read instead of assumed.
+ */
+export declare const GENERATED_FORM_CONTRIBUTION_SLOTS: readonly FormContributionSlot[];
+/**
+ * Registration intent carried on `ComponentSpec.formContribution`. Mirrors
+ * `MJ: Entity Form Contributions` columns one-to-one, minus scope and precedence
+ * (host decisions) and minus identity (`Name` / `ComponentID`).
+ */
+export interface FormContributionSpec {
+    /**
+     * Where on the form the panel sits.
+     *
+     * Optional because placement is the user's choice, made in the apply dialog. A slot named
+     * here is a proposal: the dialog starts on it when the form draws it, and on its default
+     * otherwise. {@link GetDeclaredFormContribution} fills the default, so everything
+     * downstream of normalization still sees a concrete slot.
+     */
+    slot?: FormContributionSlot;
+    sortKey?: number;
+    contributionKey?: string;
+    relatedEntity?: string;
+    relatedJoinField?: string;
+    replacesSectionKey?: string;
+    /**
+     * Fields the panel stands in for, all within one section. The panel renders at the top
+     * of that section and the named fields are not drawn. Set instead of
+     * `replacesSectionKey` or `relatedEntity`, never alongside either.
+     *
+     * One section, because the panel has one place to draw: a claim spread over two
+     * sections has no single top to sit at.
+     */
+    replacesFieldNames?: string[];
+    /**
+     * Sections the panel stands in for, all within one tab. It draws in the place of the first
+     * of them and the others are not drawn. A single section uses `replacesSectionKey` instead.
+     */
+    replacesSectionKeys?: string[];
+    /** A section the panel draws inside, replacing nothing. `sectionPosition` says where. */
+    inSectionKey?: string;
+    /**
+     * Where inside its section the panel draws, for `inSectionKey` and for a field claim.
+     * Absent means the start.
+     */
+    sectionPosition?: FormContributionSectionPosition;
+    inclusion?: FormContributionInclusion;
+    chromeGroup?: FormContributionChromeGroup;
+    presentation: FormContributionPresentation;
+    title: string;
+    icon?: string;
+    configuration?: Record<string, unknown>;
+}
+/** Where inside a section a panel draws. */
+export type FormContributionSectionPosition = 'start' | 'end';
+/** A contribution block after normalization, where the slot has been resolved. */
+export type NormalizedFormContributionSpec = FormContributionSpec & {
+    slot: FormContributionSlot;
+};
+/** True iff the spec commits to the form-panel contract. */
+export declare function IsFormPanelRole(spec: Pick<ComponentSpec, 'componentRole'>): boolean;
+/**
+ * Normalized registration intent for a form-panel spec, or `null` when the spec
+ * is not a form panel. Fills defaults (`slot`, `presentation`, `configuration`),
+ * trims strings, drops unknown slot / inclusion / chromeGroup values, and falls
+ * back to `spec.title` when the block has no title.
+ */
+export declare function GetDeclaredFormContribution(spec: Pick<ComponentSpec, 'componentRole' | 'title' | 'formContribution'> | null | undefined): NormalizedFormContributionSpec | null;
+//# sourceMappingURL=form-contribution-spec.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"form-contribution-spec.d.ts","sourceRoot":"","sources":["../../src/forms/form-contribution-spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,uFAAuF;AACvF,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,eAAe,GAAG,cAAc,GAAG,eAAe,GAAG,kBAAkB,CAAC;AACxH,MAAM,MAAM,4BAA4B,GAAG,OAAO,GAAG,MAAM,CAAC;AAC5D,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AACpE,MAAM,MAAM,2BAA2B,GAAG,SAAS,GAAG,MAAM,CAAC;AAE7D,eAAO,MAAM,8BAA8B,EAAE,oBAAqC,CAAC;AACnF,eAAO,MAAM,uBAAuB,EAAE,SAAS,oBAAoB,EACmB,CAAC;AAEvF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iCAAiC,EAAE,SAAS,oBAAoB,EACH,CAAC;AAE3E;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,eAAe,CAAC,EAAE,+BAA+B,CAAC;IAClD,SAAS,CAAC,EAAE,yBAAyB,CAAC;IACtC,WAAW,CAAC,EAAE,2BAA2B,CAAC;IAC1C,YAAY,EAAE,4BAA4B,CAAC;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,4CAA4C;AAC5C,MAAM,MAAM,+BAA+B,GAAG,OAAO,GAAG,KAAK,CAAC;AAE9D,kFAAkF;AAClF,MAAM,MAAM,8BAA8B,GAAG,oBAAoB,GAAG;IAAE,IAAI,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAEnG,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,GAAG,OAAO,CAEnF;AAuBD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACvC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,eAAe,GAAG,OAAO,GAAG,kBAAkB,CAAC,GAAG,IAAI,GAAG,SAAS,GAC7F,8BAA8B,GAAG,IAAI,CA+BvC"}

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

@@ -0,0 +1,92 @@
+export const DEFAULT_FORM_CONTRIBUTION_SLOT = 'after-fields';
+export const FORM_CONTRIBUTION_SLOTS = ['top-area', 'before-fields', 'after-fields', 'after-related', 'after-everything'];
+/**
+ * The slots a generated form actually emits.
+ *
+ * CodeGen writes `before-fields`, `after-fields` and `after-related` into every form it
+ * produces, and the record container always terminates the fallback chain with
+ * `after-everything`. `top-area` is absent: no form emits it, so a panel aimed there
+ * falls through to the bottom.
+ *
+ * Used wherever a form's real slot set is not yet known, so a position nothing renders is
+ * never offered as a choice. A hand-written template can differ, which is why a form that
+ * can be read is read instead of assumed.
+ */
+export const GENERATED_FORM_CONTRIBUTION_SLOTS = ['before-fields', 'after-fields', 'after-related', 'after-everything'];
+/** True iff the spec commits to the form-panel contract. */
+export function IsFormPanelRole(spec) {
+    return spec.componentRole === 'form-panel';
+}
+function isSlot(value) {
+    return typeof value === 'string' && FORM_CONTRIBUTION_SLOTS.includes(value);
+}
+/** A list of non-empty trimmed strings, de-duplicated, or undefined when there are none. */
+function cleanStringList(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const out = [];
+    for (const item of value) {
+        const name = cleanString(item);
+        if (name && !out.includes(name))
+            out.push(name);
+    }
+    return out.length > 0 ? out : undefined;
+}
+function cleanString(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+/**
+ * Normalized registration intent for a form-panel spec, or `null` when the spec
+ * is not a form panel. Fills defaults (`slot`, `presentation`, `configuration`),
+ * trims strings, drops unknown slot / inclusion / chromeGroup values, and falls
+ * back to `spec.title` when the block has no title.
+ */
+export function GetDeclaredFormContribution(spec) {
+    if (!spec || !IsFormPanelRole(spec))
+        return null;
+    const raw = spec.formContribution ?? {};
+    const title = cleanString(raw.title) ?? cleanString(spec.title) ?? 'Panel';
+    const out = {
+        slot: isSlot(raw.slot) ? raw.slot : DEFAULT_FORM_CONTRIBUTION_SLOT,
+        presentation: raw.presentation === 'bare' ? 'bare' : 'panel',
+        title,
+        configuration: raw.configuration && typeof raw.configuration === 'object' ? { ...raw.configuration } : {},
+    };
+    if (typeof raw.sortKey === 'number' && Number.isFinite(raw.sortKey))
+        out.sortKey = raw.sortKey;
+    const key = cleanString(raw.contributionKey);
+    if (key)
+        out.contributionKey = key;
+    const related = cleanString(raw.relatedEntity);
+    if (related)
+        out.relatedEntity = related;
+    const join = cleanString(raw.relatedJoinField);
+    if (join)
+        out.relatedJoinField = join;
+    const replaces = cleanString(raw.replacesSectionKey);
+    if (replaces)
+        out.replacesSectionKey = replaces;
+    const replacedFields = cleanStringList(raw.replacesFieldNames);
+    if (replacedFields)
+        out.replacesFieldNames = replacedFields;
+    const replacedSections = cleanStringList(raw.replacesSectionKeys);
+    if (replacedSections)
+        out.replacesSectionKeys = replacedSections;
+    const inSection = cleanString(raw.inSectionKey);
+    if (inSection)
+        out.inSectionKey = inSection;
+    if (raw.sectionPosition === 'start' || raw.sectionPosition === 'end')
+        out.sectionPosition = raw.sectionPosition;
+    if (raw.inclusion === 'Primary' || raw.inclusion === 'More' || raw.inclusion === 'None')
+        out.inclusion = raw.inclusion;
+    if (raw.chromeGroup === 'details' || raw.chromeGroup === 'more')
+        out.chromeGroup = raw.chromeGroup;
+    const icon = cleanString(raw.icon);
+    if (icon)
+        out.icon = icon;
+    return out;
+}
+//# sourceMappingURL=form-contribution-spec.js.map

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

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

package/dist/forms/form-panel-events.d.ts

@@ -0,0 +1,36 @@
+import type { BaseEventArgs } from '../component-events.js';
+/** Events a form-panel component emits via `callbacks.NotifyEvent`. */
+export declare const FormPanelEventNames: {
+    /** Related-row count for the rail badge. */
+    readonly RowCountChanged: "RowCountChanged";
+    /** Reused from the whole-form contract: proposes one field value on the PARENT record. */
+    readonly FieldChanged: "FieldChanged";
+    /** Reused from the whole-form contract. */
+    readonly ValidationChanged: "ValidationChanged";
+};
+export type FormPanelEventName = typeof FormPanelEventNames[keyof typeof FormPanelEventNames];
+export interface FormPanelRowCountChangedArgs extends BaseEventArgs {
+    count: number;
+}
+/** Methods a form-panel component may register via `callbacks.RegisterMethod`. All optional. */
+export declare const FormPanelMethodNames: {
+    /** Parent record was reloaded from the database. */
+    readonly OnRecordRefreshed: "OnRecordRefreshed";
+    /** Host toolbar entered or left edit mode. */
+    readonly SetEditMode: "SetEditMode";
+    /** Host is about to save the parent record; return validity. May be async. */
+    readonly Validate: "Validate";
+};
+export type FormPanelMethodName = typeof FormPanelMethodNames[keyof typeof FormPanelMethodNames];
+export type FormPanelSetEditModeArgs = {
+    mode: 'view' | 'edit';
+};
+/**
+ * Shape a registered `Validate` method returns. The host awaits the value before
+ * reading it, so a panel that validates against the server may return a Promise.
+ */
+export interface FormPanelValidateResult {
+    isValid: boolean;
+    errors: string[];
+}
+//# sourceMappingURL=form-panel-events.d.ts.map

package/dist/forms/form-panel-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-panel-events.d.ts","sourceRoot":"","sources":["../../src/forms/form-panel-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,uEAAuE;AACvE,eAAO,MAAM,mBAAmB;IAC5B,4CAA4C;;IAE5C,0FAA0F;;IAE1F,2CAA2C;;CAErC,CAAC;AACX,MAAM,MAAM,kBAAkB,GAAG,OAAO,mBAAmB,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAE9F,MAAM,WAAW,4BAA6B,SAAQ,aAAa;IAC/D,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,gGAAgG;AAChG,eAAO,MAAM,oBAAoB;IAC7B,oDAAoD;;IAEpD,8CAA8C;;IAE9C,8EAA8E;;CAExE,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,OAAO,oBAAoB,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC;AAEjG,MAAM,MAAM,wBAAwB,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IAAG,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE"}

package/dist/forms/form-panel-events.js

@@ -0,0 +1,20 @@
+import { FormEventNames } from './form-event-names.js';
+/** Events a form-panel component emits via `callbacks.NotifyEvent`. */
+export const FormPanelEventNames = {
+    /** Related-row count for the rail badge. */
+    RowCountChanged: 'RowCountChanged',
+    /** Reused from the whole-form contract: proposes one field value on the PARENT record. */
+    FieldChanged: FormEventNames.FieldChanged,
+    /** Reused from the whole-form contract. */
+    ValidationChanged: FormEventNames.ValidationChanged,
+};
+/** Methods a form-panel component may register via `callbacks.RegisterMethod`. All optional. */
+export const FormPanelMethodNames = {
+    /** Parent record was reloaded from the database. */
+    OnRecordRefreshed: 'OnRecordRefreshed',
+    /** Host toolbar entered or left edit mode. */
+    SetEditMode: 'SetEditMode',
+    /** Host is about to save the parent record; return validity. May be async. */
+    Validate: 'Validate',
+};
+//# sourceMappingURL=form-panel-events.js.map

package/dist/forms/form-panel-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-panel-events.js","sourceRoot":"","sources":["../../src/forms/form-panel-events.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,uEAAuE;AACvE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAC/B,4CAA4C;IAC5C,eAAe,EAAE,iBAAiB;IAClC,0FAA0F;IAC1F,YAAY,EAAE,cAAc,CAAC,YAAY;IACzC,2CAA2C;IAC3C,iBAAiB,EAAE,cAAc,CAAC,iBAAiB;CAC7C,CAAC;AAOX,gGAAgG;AAChG,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC,oDAAoD;IACpD,iBAAiB,EAAE,mBAAmB;IACtC,8CAA8C;IAC9C,WAAW,EAAE,aAAa;IAC1B,8EAA8E;IAC9E,QAAQ,EAAE,UAAU;CACd,CAAC"}

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

@@ -0,0 +1,36 @@
+import type { FormHostProps } from './form-host-props.js';
+import type { FormContributionPresentation, FormContributionSlot } from './form-contribution-spec.js';
+/** Identity + configuration of the contribution this panel instance renders. */
+export interface FormPanelContributionContext {
+    key: string;
+    slot: FormContributionSlot;
+    title: string;
+    presentation: FormContributionPresentation;
+    configuration: Record<string, unknown>;
+}
+/** Present only when the panel claims a related-entity grid. */
+export interface FormPanelRelatedContext {
+    entityName: string;
+    joinField?: string;
+    /** Prebuilt by the host from BaseFormComponent.BuildRelationshipViewParamsByEntityName — includes join.any OR filters. */
+    viewParams: {
+        EntityName: string;
+        ExtraFilter: string;
+        OrderBy?: string;
+    };
+    /** From BaseFormComponent.NewRecordValues so a "New" action pre-links the child to this record. */
+    newRecordValues: Record<string, unknown>;
+}
+/**
+ * Props the host (`InteractiveFormPanelComponent`) passes to a `componentRole: 'form-panel'`
+ * component. Extends the whole-form props: the panel sees the same record snapshot,
+ * metadata, mode and permissions, plus its own registration context.
+ */
+export interface FormPanelHostProps extends FormHostProps {
+    contribution: FormPanelContributionContext;
+    related?: FormPanelRelatedContext;
+    /** Section expanded state (accordion) or "is the active rail group" (left-nav). Defer loads while false. */
+    isExpanded: boolean;
+    layout: 'accordion' | 'left-nav';
+}
+//# sourceMappingURL=form-panel-host-props.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"form-panel-host-props.d.ts","sourceRoot":"","sources":["../../src/forms/form-panel-host-props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,4BAA4B,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEnG,gFAAgF;AAChF,MAAM,WAAW,4BAA4B;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,oBAAoB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,4BAA4B,CAAC;IAC3C,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,gEAAgE;AAChE,MAAM,WAAW,uBAAuB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0HAA0H;IAC1H,UAAU,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,mGAAmG;IACnG,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACrD,YAAY,EAAE,4BAA4B,CAAC;IAC3C,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC,4GAA4G;IAC5G,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,WAAW,GAAG,UAAU,CAAC;CACpC"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=form-panel-host-props.js.map

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

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

package/dist/forms/form-variant-preference.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Where a user's choice of form for an entity is stored.
+ *
+ * A single Active `MJ: Entity Form Overrides` row does not mean the user sees that form.
+ * They can pick any of the forms on offer, including the generated one, and that choice is
+ * a per-user setting. Anything deciding "is a full custom form rendering here" has to read
+ * it, or it answers for the wrong form.
+ *
+ * Lives here rather than in the Angular resolver so the browser and the server read the
+ * same key: they disagreed once, and the server told an agent a form was unreachable while
+ * the user was looking at it.
+ */
+/** `MJ: User Settings` key prefix for the per-entity form choice. */
+export declare const FORM_VARIANT_SETTING_PREFIX = "mj.formVariant.";
+/**
+ * Stored when the user explicitly picks the generated form.
+ *
+ * Distinct from a missing setting, which means "no preference, apply the auto-pick rules".
+ * The leading `__` keeps it apart from the override UUIDs stored under the same key.
+ */
+export declare const FORM_VARIANT_EXPLICIT_DEFAULT = "__codegen-default__";
+/** The settings key for one entity. Lowercased, so case variants collapse onto one row. */
+export declare function FormVariantSettingKey(entityName: string): string;
+//# sourceMappingURL=form-variant-preference.d.ts.map

package/dist/forms/form-variant-preference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-variant-preference.d.ts","sourceRoot":"","sources":["../../src/forms/form-variant-preference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,qEAAqE;AACrE,eAAO,MAAM,2BAA2B,oBAAoB,CAAC;AAE7D;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;AAEnE,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/dist/forms/form-variant-preference.js

@@ -0,0 +1,26 @@
+/**
+ * Where a user's choice of form for an entity is stored.
+ *
+ * A single Active `MJ: Entity Form Overrides` row does not mean the user sees that form.
+ * They can pick any of the forms on offer, including the generated one, and that choice is
+ * a per-user setting. Anything deciding "is a full custom form rendering here" has to read
+ * it, or it answers for the wrong form.
+ *
+ * Lives here rather than in the Angular resolver so the browser and the server read the
+ * same key: they disagreed once, and the server told an agent a form was unreachable while
+ * the user was looking at it.
+ */
+/** `MJ: User Settings` key prefix for the per-entity form choice. */
+export const FORM_VARIANT_SETTING_PREFIX = 'mj.formVariant.';
+/**
+ * Stored when the user explicitly picks the generated form.
+ *
+ * Distinct from a missing setting, which means "no preference, apply the auto-pick rules".
+ * The leading `__` keeps it apart from the override UUIDs stored under the same key.
+ */
+export const FORM_VARIANT_EXPLICIT_DEFAULT = '__codegen-default__';
+/** The settings key for one entity. Lowercased, so case variants collapse onto one row. */
+export function FormVariantSettingKey(entityName) {
+    return FORM_VARIANT_SETTING_PREFIX + (entityName ?? '').toLowerCase();
+}
+//# sourceMappingURL=form-variant-preference.js.map

package/dist/forms/form-variant-preference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-variant-preference.js","sourceRoot":"","sources":["../../src/forms/form-variant-preference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,qEAAqE;AACrE,MAAM,CAAC,MAAM,2BAA2B,GAAG,iBAAiB,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,qBAAqB,CAAC;AAEnE,2FAA2F;AAC3F,MAAM,UAAU,qBAAqB,CAAC,UAAkB;IACpD,OAAO,2BAA2B,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAC1E,CAAC"}

package/dist/forms/index.d.ts

@@ -22,7 +22,12 @@ 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-variant-preference.js';
 export * from './form-spec-info.js';
+export * from './form-contribution-spec.js';
+export * from './form-contribution-key.js';
+export * from './form-panel-host-props.js';
+export * from './form-panel-events.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;

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

@@ -1 +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;AAED,0CAA0C;AAC1C,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,GAAG,OAAO,CAE9E"}
+{"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,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AAEpC,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;AAED,0CAA0C;AAC1C,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,GAAG,OAAO,CAE9E"}

package/dist/forms/index.js

@@ -22,7 +22,12 @@ 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-variant-preference.js';
 export * from './form-spec-info.js';
+export * from './form-contribution-spec.js';
+export * from './form-contribution-key.js';
+export * from './form-panel-host-props.js';
+export * from './form-panel-events.js';
 /** True iff the spec commits to the form-role contract. */
 export function IsFormRole(spec) {
     return spec.componentRole === 'form';

package/dist/forms/index.js.map

@@ -1 +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;AAED,0CAA0C;AAC1C,MAAM,UAAU,UAAU,CAAC,IAA0C;IACjE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC"}
+{"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,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AAIpC,2DAA2D;AAC3D,MAAM,UAAU,UAAU,CAAC,IAA0C;IACjE,OAAO,IAAI,CAAC,aAAa,KAAK,MAAM,CAAC;AACzC,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,UAAU,CAAC,IAA0C;IACjE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/interactive-component-types",
   "type": "module",
-  "version": "6.2.0-edge.1",
+  "version": "6.2.0-edge.3",
   "description": "MemberJunction: Interactive Component - Type specifications for MJ Interactive UI Componentry",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -27,8 +27,8 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@memberjunction/core": "6.2.0-edge.1",
-    "@memberjunction/ai-vectors-memory": "6.2.0-edge.1"
+    "@memberjunction/core": "6.2.0-edge.3",
+    "@memberjunction/ai-vectors-memory": "6.2.0-edge.3"
   },
   "repository": {
     "type": "git",