@metaobjectsdev/codegen-ts 0.24.5 → 1.0.0-rc.1

package/dist/templates/entity-ui-descriptor.d.ts

@@ -0,0 +1,112 @@
+import type { MetaData, MetaField, MetaObject, MetaRoot } from "@metaobjectsdev/metadata";
+/** One validation rule, in the order its source was declared. */
+export type UiRule = {
+    readonly kind: "required";
+    readonly message: string;
+} | {
+    readonly kind: "minLength";
+    readonly value: number;
+    readonly message: string;
+} | {
+    readonly kind: "maxLength";
+    readonly value: number;
+    readonly message: string;
+}
+/** `pattern` is the RAW authored regex source — never pre-escaped. */
+ | {
+    readonly kind: "pattern";
+    readonly pattern: string;
+    readonly message: string;
+};
+export interface UiFieldDescriptor {
+    readonly name: string;
+    readonly label: string;
+    /** The MetaView subtype resolved for the FORM context. */
+    readonly view: string;
+    /** Present only when the view maps to a real HTML `<input type=…>`. Derived from the
+     *  view subtype — there is no authored override (see `htmlTypeFromView`). */
+    readonly htmlType?: string | undefined;
+    /** Empty when the field declares nothing to validate. */
+    readonly rules: readonly UiRule[];
+    /** Present only for a `field.currency`. */
+    readonly currency?: {
+        readonly currency: string;
+        readonly locale: string;
+    } | undefined;
+    /**
+     * Present when the generated FORM renders this field as a nested value-object
+     * sub-form rather than an input — a `field.object` whose `@objectRef` resolves (see
+     * `valueObjectFor`). Computed only when `buildEntityUiDescriptor` is given the loaded
+     * root; `renderEntityConstants` does not pass one and emits nothing for it, so the
+     * `<Entity>` const is byte-identical either way.
+     */
+    readonly nested?: {
+        readonly objectRef: string;
+        readonly isArray: boolean;
+    } | undefined;
+}
+export interface EntityUiDescriptor {
+    readonly entity: string;
+    /** The address the generated routes SERVE this object at — `/subscribers`, and
+     *  `/vehicles/car` for a TPH subtype. Emitted as `$path`. See {@link restPath}. */
+    readonly path: string;
+    /** Every field, INHERITED INCLUDED (ADR-0039 resolving `fields()`). */
+    readonly fields: readonly UiFieldDescriptor[];
+}
+/**
+ * An object's OWN pluralized resource path — the one derivation of that spelling, and the
+ * input {@link restPath} composes an address from. It is NOT `$path` on its own.
+ *
+ * A projection is KEBAB-cased and an entity is SNAKE-cased, and that split is not a
+ * style choice: both spellings are already mounted. `renderProjectionDecl` emits
+ * `$path: "/order-summaries"` and `renderEntityConstants` emits `$path:
+ * "/order_summaries"`, and `routes-file.ts` mounts whichever const belongs to the object
+ * — so an address computed without the split is wrong for every multi-word projection.
+ * It used to live in a second function inside `projection-decl.ts`, which is exactly how
+ * `agent/ui.md` and `api/AGENT-API.md` both came to print `/order_summaries` for a
+ * projection served at `/order-summaries`.
+ *
+ *   "Subscriber"     → "/subscribers"
+ *   "WorkoutEvent"   → "/workout_events"
+ *   "ProgramSummary" → "/program-summaries"   (projection)
+ *
+ * A TPH SUBTYPE is not addressed by this path — it is mounted under its base — so this is
+ * an INPUT to {@link restPath}, not the answer. `$path` carries `restPath`; call this only
+ * when you specifically want an object's own pluralized name, never to build an address.
+ */
+export declare function resourcePath(entity: MetaData): string;
+/**
+ * THE address the generated routes serve this object at — and therefore what the
+ * `<Entity>` const emits as `$path`.
+ *
+ * `resourcePath` answers a different question: an object's own pluralized name. The two
+ * agree for everything EXCEPT a TPH subtype, which emits no routes file of its own —
+ * `routes-file.ts` mounts the whole hierarchy from the discriminator BASE, giving the
+ * union read-only routes at the base path and each subtype a full CRUD set at
+ * `<base path>/<route segment>`.
+ *
+ * `$path` used to carry `resourcePath`, so a subtype's own `$path` named an endpoint that
+ * did not exist. That was not confined to prose: `agent/ui.md` printed it as fact, and the
+ * TanStack `grid-hook-file.ts` builds its fetch URL from `<Entity>.$path` with no TPH
+ * branch at all, so an opted-in per-subtype grid requested an address nothing served.
+ * Fixing it here fixes every consumer, because every consumer reads the const.
+ *
+ * The composition is the same one `routes-file.ts` and `hooks-file.ts` emit as CODE
+ * (`Base.$path + "/car"`); they reference the const rather than a computed string, so this
+ * is the one place it can be evaluated. The SEGMENT rule is not restated —
+ * `tphRouteSegment` owns it, and all three read it from there.
+ */
+export declare function restPath(entity: MetaObject): string;
+/**
+ * Describe one field's form presentation.
+ *
+ * `root` is OPTIONAL and only decides whether `nested` is filled in: resolving a
+ * `field.object`'s `@objectRef` needs the run's other objects, and the two callers differ
+ * — `renderEntityConstants` has no root (it is also ejected into adopter repos with a
+ * fixed signature) while the docs surface does. Passing one adds a member the const
+ * emitter ignores; it never changes any member the const emits.
+ */
+export declare function buildUiFieldDescriptor(field: MetaField, root?: MetaRoot): UiFieldDescriptor;
+/** Describe one object's whole form surface. See {@link buildUiFieldDescriptor} for `root`. */
+export declare function buildEntityUiDescriptor(obj: MetaObject, root?: MetaRoot): EntityUiDescriptor;
+//# sourceMappingURL=entity-ui-descriptor.d.ts.map

package/dist/templates/entity-ui-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-ui-descriptor.d.ts","sourceRoot":"","sources":["../../src/templates/entity-ui-descriptor.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAiC1F,iEAAiE;AACjE,MAAM,MAAM,MAAM,GACd;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAChF;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAClF,sEAAsE;GACpE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;iFAC6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACvF;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;CACzF;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;uFACmF;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC/C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAOrD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAKnD;AAoGD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,iBAAiB,CAuB3F;AAED,+FAA+F;AAC/F,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,kBAAkB,CAW5F"}

package/dist/templates/entity-ui-descriptor.js

@@ -0,0 +1,238 @@
+// The per-field FORM descriptor — the one derivation of "what does this field look like
+// in a UI", shared by everything that answers that question.
+//
+// Two consumers, and the reason they must share:
+//
+//   • `renderEntityConstants()` emits it as the `<Entity>` const in `<Entity>.meta.ts`,
+//     which `useEntityForm` reads at RUNTIME to render the form;
+//   • the `agent/ui.md` docs surface renders it as a table, which is what an agent reads
+//     BEFORE it writes code against that form.
+//
+// If those two were derived separately, the page describing the form and the descriptor
+// driving it could disagree — and the disagreement would be invisible, because the page
+// looks authoritative and nothing compares them. That is the same "a name resolved twice
+// is a name that can disagree with itself" rule `names.ts` states for physical names, one
+// tier up.
+//
+// #356 — THE SURFACE IS THE FORM. `view` resolves through `inferViewKind(field, "form")`,
+// which selects the view named for the form context, so a field declaring several views is
+// described by the one the generated `<Entity>.form.tsx` actually renders. The grid tiers
+// compute their own view kind at codegen time and never read this.
+//
+// RULES ARE AN ORDERED LIST, NOT A KEYED OBJECT, and that is load-bearing rather than
+// stylistic: the emitted `rules: { ... }` object preserves the order the field's validator
+// children were declared in, so a field whose `validator.regex` precedes its
+// `validator.required` emits `pattern` first. A keyed shape would impose one fixed order
+// and silently rewrite every such entity's descriptor.
+//
+// The pattern is carried RAW. Escaping it into a `/.../` literal is a TypeScript-emission
+// concern and belongs to the emitter, not to the description of the field.
+import { VIEW_SUBTYPE_TEXT, VIEW_SUBTYPE_TEXTAREA, VIEW_SUBTYPE_NUMBER, VIEW_SUBTYPE_CHECKBOX, VIEW_SUBTYPE_DATE, VIEW_SUBTYPE_PASSWORD, VIEW_SUBTYPE_HIDDEN, VIEW_SUBTYPE_DROPDOWN, VIEW_SUBTYPE_RADIO, VALIDATOR_SUBTYPE_REQUIRED, VALIDATOR_SUBTYPE_LENGTH, VALIDATOR_SUBTYPE_REGEX, VALIDATOR_ATTR_MIN, VALIDATOR_ATTR_MAX, VALIDATOR_ATTR_PATTERN, FIELD_ATTR_MAX_LENGTH, FIELD_ATTR_REQUIRED, pluralize, toSnakeCase, } from "@metaobjectsdev/metadata";
+import { inferViewKind, currencyMetaFor, labelFor, humanize, valueObjectFor } from "./field-meta.js";
+import { VIEW_CONTEXT_FORM } from "../view-context.js";
+import { isProjection } from "../projection/projection-detector.js";
+// `restPath` lives HERE rather than in api-surface.ts, which is where it used to sit and
+// which now re-exports it. The descriptor is what emits `$path`, so the composition has to
+// be reachable from this module; importing it back from `api-surface.js` would be a cycle,
+// since that module imports `resourcePath` from this one. Neither of these two imports
+// reaches back here, so moving the function down is the acyclic direction.
+import { tphDiscriminatorBase, tphDiscriminatorPin } from "./zod-validators.js";
+import { tphRouteSegment } from "./tph-discriminator.js";
+/**
+ * An object's OWN pluralized resource path — the one derivation of that spelling, and the
+ * input {@link restPath} composes an address from. It is NOT `$path` on its own.
+ *
+ * A projection is KEBAB-cased and an entity is SNAKE-cased, and that split is not a
+ * style choice: both spellings are already mounted. `renderProjectionDecl` emits
+ * `$path: "/order-summaries"` and `renderEntityConstants` emits `$path:
+ * "/order_summaries"`, and `routes-file.ts` mounts whichever const belongs to the object
+ * — so an address computed without the split is wrong for every multi-word projection.
+ * It used to live in a second function inside `projection-decl.ts`, which is exactly how
+ * `agent/ui.md` and `api/AGENT-API.md` both came to print `/order_summaries` for a
+ * projection served at `/order-summaries`.
+ *
+ *   "Subscriber"     → "/subscribers"
+ *   "WorkoutEvent"   → "/workout_events"
+ *   "ProgramSummary" → "/program-summaries"   (projection)
+ *
+ * A TPH SUBTYPE is not addressed by this path — it is mounted under its base — so this is
+ * an INPUT to {@link restPath}, not the answer. `$path` carries `restPath`; call this only
+ * when you specifically want an object's own pluralized name, never to build an address.
+ */
+export function resourcePath(entity) {
+    // The two compositions differ in ORDER as well as separator, and both are load-bearing:
+    // pluralize-then-snake is what the projection const has always emitted, snake-then-
+    // pluralize is what the entity const has. Neither may be "tidied" into the other.
+    return isProjection(entity)
+        ? `/${toSnakeCase(pluralize(entity.name)).replace(/_/g, "-")}`
+        : `/${pluralize(toSnakeCase(entity.name))}`;
+}
+/**
+ * THE address the generated routes serve this object at — and therefore what the
+ * `<Entity>` const emits as `$path`.
+ *
+ * `resourcePath` answers a different question: an object's own pluralized name. The two
+ * agree for everything EXCEPT a TPH subtype, which emits no routes file of its own —
+ * `routes-file.ts` mounts the whole hierarchy from the discriminator BASE, giving the
+ * union read-only routes at the base path and each subtype a full CRUD set at
+ * `<base path>/<route segment>`.
+ *
+ * `$path` used to carry `resourcePath`, so a subtype's own `$path` named an endpoint that
+ * did not exist. That was not confined to prose: `agent/ui.md` printed it as fact, and the
+ * TanStack `grid-hook-file.ts` builds its fetch URL from `<Entity>.$path` with no TPH
+ * branch at all, so an opted-in per-subtype grid requested an address nothing served.
+ * Fixing it here fixes every consumer, because every consumer reads the const.
+ *
+ * The composition is the same one `routes-file.ts` and `hooks-file.ts` emit as CODE
+ * (`Base.$path + "/car"`); they reference the const rather than a computed string, so this
+ * is the one place it can be evaluated. The SEGMENT rule is not restated —
+ * `tphRouteSegment` owns it, and all three read it from there.
+ */
+export function restPath(entity) {
+    const pin = tphDiscriminatorPin(entity);
+    const base = tphDiscriminatorBase(entity);
+    if (pin === undefined || base === undefined)
+        return resourcePath(entity);
+    return `${resourcePath(base)}/${tphRouteSegment(pin.value)}`;
+}
+/**
+ * Map a MetaView subtype to a real HTML `<input type=…>` value. Returns undefined for
+ * views that don't map to `<input>` at all (textarea, dropdown) — consumers render the
+ * right element type themselves.
+ *
+ * THE MAPPING IS THE ONLY SOURCE. An `@htmlType` override used to be read off the view
+ * node ahead of this switch; nothing registers that attribute, so the override was
+ * unreachable and this mapping was always the answer. A consumer needing a different
+ * `type=` edits the emitted `<Entity>.meta.ts`, whose hand edits the merge preserves.
+ */
+function htmlTypeFromView(view) {
+    switch (view) {
+        case VIEW_SUBTYPE_TEXT:
+            return "text";
+        case VIEW_SUBTYPE_NUMBER:
+            return "number";
+        case VIEW_SUBTYPE_DATE:
+            return "date";
+        case VIEW_SUBTYPE_PASSWORD:
+            return "password";
+        case VIEW_SUBTYPE_CHECKBOX:
+            return "checkbox";
+        case VIEW_SUBTYPE_HIDDEN:
+            return "hidden";
+        case VIEW_SUBTYPE_RADIO:
+            return "radio";
+        case "month":
+            return "month";
+        case "email":
+            return "email";
+        case VIEW_SUBTYPE_TEXTAREA:
+        case VIEW_SUBTYPE_DROPDOWN:
+            return undefined;
+        default:
+            return undefined;
+    }
+}
+/**
+ * The field's validation rules, in DECLARATION ORDER — see the ordering note at the top
+ * of this file.
+ *
+ * The field-level `@required` / `@maxLength` attrs append only when no validator child
+ * already supplied that rule, so the two authoring spellings never double up.
+ */
+function buildFieldRules(field) {
+    const rules = [];
+    let hasRequired = false;
+    let hasMaxLength = false;
+    // ADR-0039: resolving — a validator may inherit its config attrs (@min/@max/@pattern)
+    // via extends.
+    //
+    // THE MESSAGES ARE DERIVED, NOT AUTHORED. `@message` / `@minMessage` / `@maxMessage`
+    // used to be read here as overrides; no provider registers any of them, so the reads
+    // were unreachable and the defaults below were always what shipped. A consumer wanting
+    // different wording edits the emitted `rules` object in `<Entity>.meta.ts`, which is a
+    // generated file whose hand edits the three-way merge preserves. See ADR-0023.
+    for (const child of field.validators()) {
+        if (child.subType === VALIDATOR_SUBTYPE_REQUIRED) {
+            rules.push({ kind: "required", message: `${humanize(field.name)} is required` });
+            hasRequired = true;
+        }
+        else if (child.subType === VALIDATOR_SUBTYPE_LENGTH) {
+            const min = child.attr(VALIDATOR_ATTR_MIN);
+            const max = child.attr(VALIDATOR_ATTR_MAX);
+            if (typeof min === "number") {
+                rules.push({ kind: "minLength", value: min, message: `Must be at least ${min} characters` });
+            }
+            if (typeof max === "number") {
+                rules.push({ kind: "maxLength", value: max, message: `Must be ${max} characters or fewer` });
+                hasMaxLength = true;
+            }
+        }
+        else if (child.subType === VALIDATOR_SUBTYPE_REGEX) {
+            const pattern = child.attr(VALIDATOR_ATTR_PATTERN);
+            if (typeof pattern === "string") {
+                rules.push({ kind: "pattern", pattern, message: "Invalid format" });
+            }
+        }
+    }
+    // Field-level @required attr (if not already covered by validator).
+    if (!hasRequired && field.attr(FIELD_ATTR_REQUIRED) === true) {
+        rules.push({ kind: "required", message: `${humanize(field.name)} is required` });
+    }
+    // Field-level @maxLength attr (if not already covered).
+    const maxLenAttr = field.attr(FIELD_ATTR_MAX_LENGTH);
+    if (!hasMaxLength && typeof maxLenAttr === "number") {
+        rules.push({
+            kind: "maxLength",
+            value: maxLenAttr,
+            message: `Must be ${maxLenAttr} characters or fewer`,
+        });
+    }
+    return rules;
+}
+/**
+ * Describe one field's form presentation.
+ *
+ * `root` is OPTIONAL and only decides whether `nested` is filled in: resolving a
+ * `field.object`'s `@objectRef` needs the run's other objects, and the two callers differ
+ * — `renderEntityConstants` has no root (it is also ejected into adopter repos with a
+ * fixed signature) while the docs surface does. Passing one adds a member the const
+ * emitter ignores; it never changes any member the const emits.
+ */
+export function buildUiFieldDescriptor(field, root) {
+    // `inferViewKind` IS the resolution: the view child declared for the FORM (own or
+    // inherited) wins, else the field subtype's default. This module used to keep a
+    // `resolveView` that returned the same string plus the view NODE, and the node existed
+    // only to read `@placeholder` / `@helpText` / `@htmlType` off it — none of which any
+    // provider registers, so all three reads were unreachable. With them gone the node has
+    // no reader and the two functions were the same function.
+    const view = inferViewKind(field, VIEW_CONTEXT_FORM);
+    const currencyMeta = currencyMetaFor(field, VIEW_CONTEXT_FORM);
+    const vo = root === undefined ? undefined : valueObjectFor(field, root);
+    return {
+        name: field.name,
+        label: labelFor(field, VIEW_CONTEXT_FORM),
+        view,
+        htmlType: htmlTypeFromView(view),
+        rules: buildFieldRules(field),
+        currency: currencyMeta === null
+            ? undefined
+            : { currency: currencyMeta.currency, locale: currencyMeta.locale },
+        nested: vo === undefined
+            ? undefined
+            : { objectRef: vo.name, isArray: field.resolvedIsArray() },
+    };
+}
+/** Describe one object's whole form surface. See {@link buildUiFieldDescriptor} for `root`. */
+export function buildEntityUiDescriptor(obj, root) {
+    return {
+        entity: obj.name,
+        // `restPath`, not `resourcePath`: `$path` is the address this object is SERVED at.
+        // They differ only for a TPH subtype, and for that one case `resourcePath` names an
+        // endpoint nothing mounts (see restPath's note).
+        path: restPath(obj),
+        // ADR-0039: resolving `fields()` so inherited fields appear, exactly as the emitted
+        // descriptor has always done.
+        fields: obj.fields().map((f) => buildUiFieldDescriptor(f, root)),
+    };
+}
+//# sourceMappingURL=entity-ui-descriptor.js.map

package/dist/templates/entity-ui-descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-ui-descriptor.js","sourceRoot":"","sources":["../../src/templates/entity-ui-descriptor.ts"],"names":[],"mappings":"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"}

package/dist/templates/field-meta.d.ts

@@ -1,9 +1,14 @@
 import { MetaField } from "@metaobjectsdev/metadata";
+import type { MetaObject, MetaRoot } from "@metaobjectsdev/metadata";
 /**
- * Resolve the cell-renderer key (view kind) for a field.
- * Explicit view child wins; field subType determines default.
+ * Resolve the cell-renderer key (view kind) for a field, for the surface named
+ * by `context`.
+ *
+ * An explicit view declared for THAT surface wins; field subType determines the
+ * default. #356: `context` is required rather than defaulting, because a caller
+ * that omits it is exactly the caller that renders somebody else's view.
  */
-export declare function inferViewKind(field: MetaField): string;
+export declare function inferViewKind(field: MetaField, context: string): string;
 /**
  * Resolve the Zod validator expression for a field's storage type.
  *
@@ -18,16 +23,48 @@ export declare function inferViewKind(field: MetaField): string;
  */
 export declare function zodTypeFor(field: MetaField, timestampMode?: "date" | "string"): string;
 /**
- * Resolve currency code + locale for a currency-subtype field.
- * Returns null for non-currency fields.
+ * Resolve currency code + locale for a currency-subtype field, for the surface
+ * named by `context`. Returns null for non-currency fields.
  */
-export declare function currencyMetaFor(field: MetaField): {
+export declare function currencyMetaFor(field: MetaField, context: string): {
     currency: string;
     locale: string;
 } | null;
 /**
- * Resolve the human-readable label for a field.
- * Uses @label attr on a view child if present; otherwise humanizes the field name.
+ * The `object.value` a `field.object`'s `@objectRef` names, or `undefined` when the
+ * field is not an object field, declares no ref, or names one that is not in the run.
+ *
+ * THIS IS THE "DOES THE FORM NEST THIS FIELD?" PREDICATE, and it lives here because two
+ * tiers have to give one answer: `codegen-ts-react`'s form generator recurses into the
+ * referenced value object as a `<fieldset>` sub-form (or a `useFieldArray` repeatable
+ * group when the field is an array) instead of emitting an input at all, and
+ * `agent/ui.md` documents what that form renders. When they answered separately the page
+ * printed `text` — the field's resolved `view.*` subtype, which the form never consults
+ * for a nested field — as if it were the control.
+ *
+ * The resolution is BARE-NAME on purpose: it is the same lookup the Zod and
+ * inferred-type templates perform, and changing it here would change what the generated
+ * form nests. A package-aware resolution is a separate decision with its own blast
+ * radius (ADR-0042).
+ */
+export declare function valueObjectFor(field: MetaField, root: MetaRoot): MetaObject | undefined;
+/**
+ * Resolve the human-readable label for a field, for the surface named by `context`.
+ * Uses the registered `@title` common attr — on that surface's view first, else on the
+ * field itself; otherwise humanizes the field name.
+ *
+ * #353 — this read `@label`, which no provider registers on any `view.*` subtype, so the
+ * override branch was unreachable: authoring it fails the strict load `meta verify` runs
+ * (ERR_UNKNOWN_ATTR). `title` is already a registered common attr on every node and
+ * already means "a noun phrase", so nothing was registered for this (ADR-0037 step 0).
+ */
+export declare function labelFor(field: MetaField, context: string): string;
+/**
+ * Convert a camelCase or PascalCase field name to a human-friendly label.
+ *
+ * THE one copy in this package: `entity-ui-descriptor.ts` re-exports this rather than
+ * keeping a second body, because two spellings of "humanize" is two answers to what a
+ * field is CALLED — the label a form renders and the label the docs page prints.
  */
-export declare function labelFor(field: MetaField): string;
+export declare function humanize(s: string): string;
 //# sourceMappingURL=field-meta.d.ts.map

package/dist/templates/field-meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-meta.d.ts","sourceRoot":"","sources":["../../src/templates/field-meta.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAsCrD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAMtD;AA2BD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,aAAa,GAAE,MAAM,GAAG,QAAmB,GAAG,MAAM,CAuDhG;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAU7F;AAMD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAOjD"}
+{"version":3,"file":"field-meta.d.ts","sourceRoot":"","sources":["../../src/templates/field-meta.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AA2CrE;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAMvE;AA2CD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,aAAa,GAAE,MAAM,GAAG,QAAmB,GAAG,MAAM,CAuDhG;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,MAAM,GACd;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkB7C;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAOvF;AAMD;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CASlE;AAMD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAM1C"}

package/dist/templates/field-meta.js

@@ -3,19 +3,25 @@
 //
 // All helpers take a MetaField node.
 import { MetaField } from "@metaobjectsdev/metadata";
-import { FIELD_SUBTYPE_STRING, FIELD_SUBTYPE_INT, FIELD_SUBTYPE_LONG, FIELD_SUBTYPE_DOUBLE, FIELD_SUBTYPE_FLOAT, FIELD_SUBTYPE_DECIMAL, FIELD_SUBTYPE_BOOLEAN, FIELD_SUBTYPE_DATE, FIELD_SUBTYPE_TIME, FIELD_SUBTYPE_TIMESTAMP, FIELD_SUBTYPE_CURRENCY, FIELD_SUBTYPE_ENUM, FIELD_SUBTYPE_UUID, FIELD_SUBTYPE_URI, FIELD_SUBTYPE_INET, FIELD_ATTR_STRING_FORMAT, FIELD_ATTR_LENIENT, STRING_FORMAT_EMAIL, STRING_FORMAT_HOSTNAME, VIEW_SUBTYPE_TEXT, VIEW_SUBTYPE_DATE, VIEW_SUBTYPE_NUMBER, VIEW_SUBTYPE_CHECKBOX, VIEW_SUBTYPE_CURRENCY, FIELD_ATTR_CURRENCY, FIELD_ATTR_CURRENCY_DEFAULT, VIEW_CURRENCY_ATTR_LOCALE, VIEW_CURRENCY_ATTR_LOCALE_DEFAULT, } from "@metaobjectsdev/metadata";
+import { stripPackage } from "@metaobjectsdev/metadata";
+import { FIELD_SUBTYPE_STRING, FIELD_SUBTYPE_INT, FIELD_SUBTYPE_LONG, FIELD_SUBTYPE_DOUBLE, FIELD_SUBTYPE_FLOAT, FIELD_SUBTYPE_DECIMAL, FIELD_SUBTYPE_BOOLEAN, FIELD_SUBTYPE_DATE, FIELD_SUBTYPE_TIME, FIELD_SUBTYPE_TIMESTAMP, FIELD_SUBTYPE_CURRENCY, FIELD_SUBTYPE_ENUM, FIELD_SUBTYPE_UUID, FIELD_SUBTYPE_URI, FIELD_SUBTYPE_INET, FIELD_SUBTYPE_OBJECT, FIELD_ATTR_OBJECT_REF, FIELD_ATTR_STRING_FORMAT, FIELD_ATTR_LENIENT, STRING_FORMAT_EMAIL, STRING_FORMAT_HOSTNAME, VIEW_SUBTYPE_TEXT, VIEW_SUBTYPE_DATE, VIEW_SUBTYPE_NUMBER, VIEW_SUBTYPE_CHECKBOX, VIEW_SUBTYPE_CURRENCY, VIEW_SUBTYPE_DROPDOWN, FIELD_ATTR_CURRENCY, FIELD_ATTR_CURRENCY_DEFAULT, VIEW_CURRENCY_ATTR_LOCALE, VIEW_CURRENCY_ATTR_LOCALE_DEFAULT, } from "@metaobjectsdev/metadata";
 import { enumValues, zodEnumExpr } from "../enum-meta.js";
+import { viewForContext } from "../view-context.js";
 import { ZOD_INET_EXPR } from "./net-regex.js";
 // ---------------------------------------------------------------------------
 // inferViewKind
 // ---------------------------------------------------------------------------
 /**
- * Resolve the cell-renderer key (view kind) for a field.
- * Explicit view child wins; field subType determines default.
+ * Resolve the cell-renderer key (view kind) for a field, for the surface named
+ * by `context`.
+ *
+ * An explicit view declared for THAT surface wins; field subType determines the
+ * default. #356: `context` is required rather than defaulting, because a caller
+ * that omits it is exactly the caller that renders somebody else's view.
  */
-export function inferViewKind(field) {
-    // Explicit view (own or inherited via extends) has highest priority.
-    const viewChild = field.views()[0];
+export function inferViewKind(field, context) {
+    // Explicit view for this surface (own or inherited via extends) has highest priority.
+    const viewChild = viewForContext(field, context);
     if (viewChild)
         return viewChild.subType;
     // Field subtype → default view.
@@ -37,6 +43,22 @@ function defaultViewForSubType(subType) {
             return VIEW_SUBTYPE_DATE;
         case FIELD_SUBTYPE_CURRENCY:
             return VIEW_SUBTYPE_CURRENCY;
+        case FIELD_SUBTYPE_ENUM:
+            // A closed member set is a CHOICE, and the generated form has always rendered it as
+            // one: `codegen-ts-react`'s `viewKindFor` returns `dropdown` for an enum declaring no
+            // view, and emits a `<select>` with an `<option>` per member.
+            //
+            // This branch was missing, so the same question had two answers. The emitted
+            // `<Entity>` descriptor — which `useEntityForm` reads at RUNTIME — fell through to
+            // `text` and told every consumer the control was a free-text input, for the one field
+            // subtype where free text is exactly what the model forbids. The form was right and
+            // the descriptor describing it was wrong.
+            //
+            // Fixed HERE rather than in the react tier because this is the shared resolver: the
+            // descriptor, the `agent/ui.md` page and the form must give one answer, and pinning
+            // the agreement in the tier that renders it would leave the two other readers still
+            // computing their own.
+            return VIEW_SUBTYPE_DROPDOWN;
         default:
             return VIEW_SUBTYPE_TEXT;
     }
@@ -117,40 +139,92 @@ export function zodTypeFor(field, timestampMode = "string") {
 // currencyMetaFor
 // ---------------------------------------------------------------------------
 /**
- * Resolve currency code + locale for a currency-subtype field.
- * Returns null for non-currency fields.
+ * Resolve currency code + locale for a currency-subtype field, for the surface
+ * named by `context`. Returns null for non-currency fields.
  */
-export function currencyMetaFor(field) {
+export function currencyMetaFor(field, context) {
     if (field.subType !== FIELD_SUBTYPE_CURRENCY)
         return null;
     const currency = field.attr(FIELD_ATTR_CURRENCY) ?? FIELD_ATTR_CURRENCY_DEFAULT;
-    const viewChild = field.views().find((c) => c.subType === VIEW_SUBTYPE_CURRENCY);
+    // #356: the surface's own view carries the @locale for that surface — two
+    // currency views with different locales must not be resolved by position.
+    // When the surface's view is NOT a currency view (or there is none), keep the
+    // pre-#356 scan: an authored @locale anywhere on the field beats the default.
+    const contextView = viewForContext(field, context);
+    const viewChild = contextView?.subType === VIEW_SUBTYPE_CURRENCY
+        ? contextView
+        : field.views().find((c) => c.subType === VIEW_SUBTYPE_CURRENCY);
     // ADR-0039: resolving — a view may inherit @locale via extends.
     const locale = viewChild?.attr(VIEW_CURRENCY_ATTR_LOCALE) ??
         VIEW_CURRENCY_ATTR_LOCALE_DEFAULT;
     return { currency, locale };
 }
 // ---------------------------------------------------------------------------
+// valueObjectFor
+// ---------------------------------------------------------------------------
+/**
+ * The `object.value` a `field.object`'s `@objectRef` names, or `undefined` when the
+ * field is not an object field, declares no ref, or names one that is not in the run.
+ *
+ * THIS IS THE "DOES THE FORM NEST THIS FIELD?" PREDICATE, and it lives here because two
+ * tiers have to give one answer: `codegen-ts-react`'s form generator recurses into the
+ * referenced value object as a `<fieldset>` sub-form (or a `useFieldArray` repeatable
+ * group when the field is an array) instead of emitting an input at all, and
+ * `agent/ui.md` documents what that form renders. When they answered separately the page
+ * printed `text` — the field's resolved `view.*` subtype, which the form never consults
+ * for a nested field — as if it were the control.
+ *
+ * The resolution is BARE-NAME on purpose: it is the same lookup the Zod and
+ * inferred-type templates perform, and changing it here would change what the generated
+ * form nests. A package-aware resolution is a separate decision with its own blast
+ * radius (ADR-0042).
+ */
+export function valueObjectFor(field, root) {
+    if (field.subType !== FIELD_SUBTYPE_OBJECT)
+        return undefined;
+    // ADR-0039: resolving — @objectRef may be inherited via extends.
+    const ref = field.attr(FIELD_ATTR_OBJECT_REF);
+    if (typeof ref !== "string" || ref.length === 0)
+        return undefined;
+    const base = stripPackage(ref);
+    return root.objects().find((o) => o.name === base);
+}
+// ---------------------------------------------------------------------------
 // labelFor
 // ---------------------------------------------------------------------------
 /**
- * Resolve the human-readable label for a field.
- * Uses @label attr on a view child if present; otherwise humanizes the field name.
+ * Resolve the human-readable label for a field, for the surface named by `context`.
+ * Uses the registered `@title` common attr — on that surface's view first, else on the
+ * field itself; otherwise humanizes the field name.
+ *
+ * #353 — this read `@label`, which no provider registers on any `view.*` subtype, so the
+ * override branch was unreachable: authoring it fails the strict load `meta verify` runs
+ * (ERR_UNKNOWN_ATTR). `title` is already a registered common attr on every node and
+ * already means "a noun phrase", so nothing was registered for this (ADR-0037 step 0).
  */
-export function labelFor(field) {
-    for (const child of field.views()) {
-        // ADR-0039: resolving — a view may inherit @label via extends.
-        const label = child.attr("label");
-        if (typeof label === "string" && label.length > 0)
-            return label;
-    }
+export function labelFor(field, context) {
+    // #356: the label reads the view for THIS surface, not whichever view was
+    // declared first — a grid header must not retitle the form's field.
+    // ADR-0039: resolving — a view may inherit @title via extends.
+    const title = viewForContext(field, context)?.attr("title");
+    if (typeof title === "string" && title.length > 0)
+        return title;
+    const fieldTitle = field.attr("title");
+    if (typeof fieldTitle === "string" && fieldTitle.length > 0)
+        return fieldTitle;
     return humanize(field.name);
 }
 // ---------------------------------------------------------------------------
 // Internal
 // ---------------------------------------------------------------------------
-/** Convert a camelCase or PascalCase field name to a human-friendly label. */
-function humanize(s) {
+/**
+ * Convert a camelCase or PascalCase field name to a human-friendly label.
+ *
+ * THE one copy in this package: `entity-ui-descriptor.ts` re-exports this rather than
+ * keeping a second body, because two spellings of "humanize" is two answers to what a
+ * field is CALLED — the label a form renders and the label the docs page prints.
+ */
+export function humanize(s) {
     return s
         .replace(/([a-z])([A-Z])/g, "$1 $2")
         .replace(/_/g, " ")

package/dist/templates/field-meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"field-meta.js","sourceRoot":"","sources":["../../src/templates/field-meta.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,+EAA+E;AAC/E,EAAE;AACF,qCAAqC;AAErC,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,2BAA2B,EAC3B,yBAAyB,EACzB,iCAAiC,GAClC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAgB;IAC5C,qEAAqE;IACrE,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,OAAO,CAAC;IACxC,gCAAgC;IAChC,OAAO,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAe;IAC5C,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,qBAAqB;YACxB,OAAO,qBAAqB,CAAC;QAC/B,KAAK,iBAAiB,CAAC;QACvB,KAAK,kBAAkB,CAAC;QACxB,KAAK,oBAAoB,CAAC;QAC1B,KAAK,mBAAmB,CAAC;QACzB,KAAK,qBAAqB;YACxB,OAAO,mBAAmB,CAAC;QAC7B,KAAK,kBAAkB,CAAC;QACxB,KAAK,kBAAkB,CAAC;QACxB,KAAK,uBAAuB;YAC1B,OAAO,iBAAiB,CAAC;QAC3B,KAAK,sBAAsB;YACzB,OAAO,qBAAqB,CAAC;QAC/B;YACE,OAAO,iBAAiB,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,KAAgB,EAAE,gBAAmC,QAAQ;IACtF,QAAQ,KAAK,CAAC,OAAO,EAAE,CAAC;QACtB,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,2EAA2E;YAC3E,qDAAqD;YACrD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YACjD,IAAI,GAAG,KAAK,mBAAmB;gBAAE,OAAO,oBAAoB,CAAC;YAC7D,IAAI,GAAG,KAAK,sBAAsB,EAAE,CAAC;gBACnC,OAAO,yIAAyI,CAAC;YACnJ,CAAC;YACD,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,KAAK,kBAAkB;YACrB,OAAO,YAAY,CAAC;QACtB,KAAK,iBAAiB;YACpB,qEAAqE;YACrE,oEAAoE;YACpE,OAAO,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,kBAAkB,CAAC;QACrF,KAAK,kBAAkB;YACrB,0EAA0E;YAC1E,sEAAsE;YACtE,mEAAmE;YACnE,OAAO,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC;QAChF,KAAK,qBAAqB;YACxB,OAAO,aAAa,CAAC;QACvB,KAAK,kBAAkB,CAAC;QACxB,KAAK,kBAAkB;YACrB,0EAA0E;YAC1E,0DAA0D;YAC1D,OAAO,YAAY,CAAC;QACtB,KAAK,uBAAuB;YAC1B,4EAA4E;YAC5E,mEAAmE;YACnE,8EAA8E;YAC9E,wEAAwE;YACxE,sEAAsE;YACtE,yEAAyE;YACzE,sEAAsE;YACtE,uBAAuB;YACvB,OAAO,aAAa,KAAK,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,YAAY,CAAC;QACrE,KAAK,iBAAiB,CAAC;QACvB,KAAK,kBAAkB,CAAC;QACxB,KAAK,sBAAsB;YACzB,OAAO,kBAAkB,CAAC;QAC5B,KAAK,oBAAoB,CAAC;QAC1B,KAAK,mBAAmB,CAAC;QACzB,KAAK,qBAAqB;YACxB,OAAO,YAAY,CAAC;QACtB,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YACjC,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;QACnE,CAAC;QACD;YACE,OAAO,aAAa,CAAC;IACzB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAgB;IAC9C,IAAI,KAAK,CAAC,OAAO,KAAK,sBAAsB;QAAE,OAAO,IAAI,CAAC;IAC1D,MAAM,QAAQ,GACX,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAwB,IAAI,2BAA2B,CAAC;IACzF,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,qBAAqB,CAAC,CAAC;IACjF,gEAAgE;IAChE,MAAM,MAAM,GACT,SAAS,EAAE,IAAI,CAAC,yBAAyB,CAAwB;QAClE,iCAAiC,CAAC;IACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAgB;IACvC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QAClC,+DAA+D;QAC/D,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IAClE,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,8EAA8E;AAC9E,SAAS,QAAQ,CAAC,CAAS;IACzB,OAAO,CAAC;SACL,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;SAClB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SACxC,IAAI,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"field-meta.js","sourceRoot":"","sources":["../../src/templates/field-meta.ts"],"names":[],"mappings":"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"}