ormbridge 0.9.0 → 0.10.0

package/dist/parsers/jpaEntities.js

@@ -0,0 +1,181 @@
+import { accessOf, classNotes, classOverrides, isEntityClass, isMappedSuperclass, membersOf, } from './jpaClasses.js';
+// ---------------------------------------------------------------------------
+// Entities and hierarchies
+// ---------------------------------------------------------------------------
+const IGNORED_SUPERCLASSES = new Set([
+    'Object',
+    'Serializable',
+]);
+function strategyOf(project, root) {
+    const strategy = classNotes(project, root)
+        .get('Inheritance')
+        ?.member('strategy');
+    switch (strategy) {
+        case 'JOINED':
+            return 'joined';
+        case 'TABLE_PER_CLASS':
+            return 'tablePerClass';
+        default:
+            return 'singleTable';
+    }
+}
+/** The superclasses of a class that are in the input, root first. */
+function superclassChain(project, cls, warn) {
+    const chain = [];
+    const seen = new Set([cls.name]);
+    let current = cls;
+    while (current.superclass !== undefined) {
+        const name = current.superclass.name;
+        const parent = project.classes.get(name);
+        if (parent === undefined) {
+            if (!IGNORED_SUPERCLASSES.has(name)) {
+                warn(`${cls.name}: the superclass ${name} is not in the input, so the attributes it declares are not read.`);
+            }
+            break;
+        }
+        if (seen.has(name)) {
+            break;
+        }
+        seen.add(name);
+        chain.unshift(parent);
+        current = parent;
+    }
+    return chain;
+}
+/** Finds the entity classes of the input and arranges them into hierarchies. */
+export function discoverEntities(project, warn) {
+    const infos = new Map();
+    for (const cls of project.classes.values()) {
+        if (!isEntityClass(project, cls)) {
+            continue;
+        }
+        const notes = classNotes(project, cls);
+        const chain = [...superclassChain(project, cls, warn), cls];
+        infos.set(cls.name, {
+            cls,
+            name: cls.name,
+            entityName: notes.get('Entity')?.string('name') || cls.name,
+            notes,
+            chain,
+            children: [],
+            // Set to the first entity of the hierarchy below, once every entity is known.
+            root: undefined,
+            inheritance: 'none',
+            accesses: [],
+            isAbstract: cls.modifiers.includes('abstract'),
+            members: [],
+        });
+    }
+    for (const info of infos.values()) {
+        const ancestors = info.chain
+            .slice(0, -1)
+            .flatMap((cls) => {
+            const found = infos.get(cls.name);
+            return found === undefined ? [] : [found];
+        });
+        const parent = ancestors[ancestors.length - 1];
+        if (parent !== undefined) {
+            info.parent = parent;
+            parent.children.push(info);
+        }
+        info.root = ancestors[0] ?? info;
+    }
+    for (const info of infos.values()) {
+        if (info.root === info && info.children.length === 0) {
+            info.inheritance = 'none';
+        }
+        else {
+            info.inheritance = strategyOf(project, info.root.cls);
+        }
+        let access = 'field';
+        for (const cls of info.chain) {
+            access = accessOf(project, cls, access);
+            info.accesses.push(access);
+        }
+    }
+    return [...infos.values()];
+}
+/**
+ * The type arguments the classes below `position` of a chain gave to its generic class:
+ * `class User extends BaseEntity<Long>` makes the parameter `T` of `BaseEntity` a `Long`.
+ */
+function genericsAt(chain, position) {
+    const generics = new Map();
+    for (let index = chain.length - 2; index >= position; index -= 1) {
+        const parent = chain[index];
+        const child = chain[index + 1];
+        const given = child?.superclass?.args ?? [];
+        const next = new Map();
+        parent?.typeParameters.forEach((name, argument) => {
+            const type = given[argument];
+            if (type !== undefined) {
+                next.set(name, generics.get(type.name) ?? type);
+            }
+        });
+        generics.clear();
+        for (const [name, type] of next) {
+            generics.set(name, type);
+        }
+    }
+    return generics;
+}
+/** True for a class whose attributes JPA maps into the tables of its subclasses or itself. */
+function isPersistentClass(project, cls) {
+    return isEntityClass(project, cls) || isMappedSuperclass(project, cls);
+}
+/** The persistence annotations that only make sense on a mapped class. */
+const MAPPING_ANNOTATIONS = new Set([
+    'Id',
+    'Column',
+    'ManyToOne',
+    'OneToOne',
+    'OneToMany',
+    'ManyToMany',
+    'Embedded',
+    'EmbeddedId',
+    'Basic',
+]);
+/**
+ * The members that make up an entity's table. Mapped superclasses come first. With single-table inheritance the
+ * root also takes the members of every subclass (they must allow null); with joined inheritance a subclass takes
+ * only what it declares itself; with table-per-class every class of the chain contributes.
+ */
+export function entityMembers(project, info, warn) {
+    const members = [];
+    const add = (entity, from) => {
+        const overrides = classOverrides(project, entity.cls, warn);
+        entity.chain.forEach((cls, position) => {
+            if (position < from) {
+                return;
+            }
+            if (!isPersistentClass(project, cls)) {
+                if (cls.fields.some((field) => field.annotations.some((item) => MAPPING_ANNOTATIONS.has(item.name)))) {
+                    warn(`${entity.name}: the superclass ${cls.name} has mapping annotations but no @MappedSuperclass or @Entity, so JPA does not persist its attributes.`);
+                }
+                return;
+            }
+            members.push(...membersOf({
+                project,
+                warn,
+                declaredIn: entity.name,
+                generics: genericsAt(entity.chain, position),
+            }, cls, entity.accesses[position] ?? 'field', [], overrides, false));
+        });
+    };
+    let first = 0;
+    if (info.inheritance === 'joined' && info.parent !== undefined) {
+        first = info.chain.indexOf(info.parent.cls) + 1;
+    }
+    add(info, first);
+    if (info.inheritance === 'singleTable' && info.root === info) {
+        const visit = (entity) => {
+            for (const child of entity.children) {
+                add(child, child.chain.indexOf(entity.cls) + 1);
+                visit(child);
+            }
+        };
+        visit(info);
+    }
+    return members;
+}
+//# sourceMappingURL=jpaEntities.js.map

package/dist/parsers/jpaEntities.js.map

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

package/dist/parsers/jpaIndexes.d.ts

@@ -0,0 +1,12 @@
+import type { IrIndex } from '../ir.js';
+import type { EntityInfo } from './jpaModel.js';
+export interface IndexResult {
+    indexes: IrIndex[];
+    /** IR names of columns that carry a single-column unnamed unique constraint. */
+    uniqueFields: Set<string>;
+}
+/**
+ * Reads `@Table(uniqueConstraints, indexes)` and the natural id into IR indexes. `names` maps a column name (any
+ * case) or an attribute name to the IR field or relation that owns it.
+ */
+export declare function buildIndexes(entity: EntityInfo, names: ReadonlyMap<string, string>, naturalId: readonly string[], warn: (message: string) => void): IndexResult;

package/dist/parsers/jpaIndexes.js

@@ -0,0 +1,87 @@
+import { cleanIdentifier } from './jpaColumns.js';
+/** Splits `a, b DESC, c ASC` into column names and sort flags. */
+function parseColumnList(list) {
+    return list
+        .split(',')
+        .map((part) => part.trim())
+        .filter((part) => part !== '')
+        .map((part) => {
+        const match = part.match(/^(.*?)(?:\s+(ASC|DESC))?$/i);
+        return {
+            column: cleanIdentifier((match?.[1] ?? part).trim()),
+            descending: (match?.[2] ?? '').toUpperCase() === 'DESC',
+        };
+    });
+}
+/**
+ * Reads `@Table(uniqueConstraints, indexes)` and the natural id into IR indexes. `names` maps a column name (any
+ * case) or an attribute name to the IR field or relation that owns it.
+ */
+export function buildIndexes(entity, names, naturalId, warn) {
+    const indexes = [];
+    const uniqueFields = new Set();
+    const place = entity.name;
+    const table = entity.notes.get('Table');
+    const resolve = (columns, label) => {
+        const resolved = [];
+        for (const column of columns) {
+            const found = names.get(column.toLowerCase()) ?? names.get(column);
+            if (found === undefined) {
+                warn(`${place}: ${label} refers to "${column}", which is not a column of the table; it was skipped.`);
+                return undefined;
+            }
+            resolved.push(found);
+        }
+        return resolved.length === 0 ? undefined : resolved;
+    };
+    const seen = new Set();
+    const add = (columns, unique, name, descending, label) => {
+        const fields = resolve(columns, label);
+        if (fields === undefined) {
+            return;
+        }
+        const signature = `${unique ? 'u' : 'i'}|${fields.join(',')}|${name ?? ''}`;
+        if (seen.has(signature)) {
+            return;
+        }
+        seen.add(signature);
+        const only = fields[0];
+        if (unique && fields.length === 1 && only !== undefined && !name) {
+            uniqueFields.add(only);
+            return;
+        }
+        const fieldOptions = {};
+        descending.forEach((flag, position) => {
+            const field = fields[position];
+            if (flag && field !== undefined) {
+                fieldOptions[field] = { sort: 'desc' };
+            }
+        });
+        indexes.push({
+            fields,
+            isUnique: unique,
+            ...(name ? { name } : {}),
+            ...(Object.keys(fieldOptions).length === 0 ? {} : { fieldOptions }),
+        });
+    };
+    for (const constraint of table?.annotations('uniqueConstraints') ?? []) {
+        const name = constraint.string('name');
+        const columns = constraint.strings('columnNames');
+        add(columns.map(cleanIdentifier), true, name, columns.map(() => false), `the unique constraint${name ? ` "${name}"` : ''}`);
+    }
+    for (const index of table?.annotations('indexes') ?? []) {
+        const name = index.string('name');
+        const parts = parseColumnList(index.string('columnList') ?? '');
+        add(parts.map((part) => part.column), index.boolean('unique') === true, name, parts.map((part) => part.descending), `the index${name ? ` "${name}"` : ''}`);
+    }
+    if (naturalId.length > 0) {
+        if (naturalId.length === 1 && naturalId[0] !== undefined) {
+            uniqueFields.add(naturalId[0]);
+        }
+        else {
+            indexes.push({ fields: [...naturalId], isUnique: true });
+        }
+    }
+    return { indexes, uniqueFields };
+}
+//# sourceMappingURL=jpaIndexes.js.map

package/dist/parsers/jpaIndexes.js.map

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

package/dist/parsers/jpaJoins.d.ts

@@ -0,0 +1,68 @@
+import type { IrOnDelete } from '../ir.js';
+import type { Ann } from './jpaAnnotations.js';
+import type { BuiltField } from './jpaColumns.js';
+import type { EntityInfo, Member, Project } from './jpaModel.js';
+import type { IrCompositeForeignKey, IrField, IrRelation } from '../ir.js';
+/** A primary key column of an entity: the IR name of its field (or relation) and the database column. */
+export interface KeyColumn {
+    name: string;
+    columnName: string;
+}
+/** Everything the relationship steps look up. */
+export interface Resolver {
+    project: Project;
+    entities: Map<string, EntityInfo>;
+    warn: (message: string) => void;
+    /** Built fields of every model, by model name, for the types of foreign key columns. */
+    fieldsOf: (model: EntityInfo) => readonly BuiltField[];
+    /** The primary key columns of an entity's table. */
+    keyOf: (entity: EntityInfo) => KeyColumn[];
+}
+/** A relationship placed on a model, with the position of its attribute (for ordering). */
+export interface PlacedRelation {
+    order: number;
+    relation: IrRelation;
+}
+export interface RelationOutput {
+    relations: PlacedRelation[];
+    composite: IrCompositeForeignKey[];
+    /** Local columns that composite foreign keys need and no attribute declares. */
+    extraFields: IrField[];
+    /** Paths (`a.b`) of scalar members whose column a relationship now carries. */
+    consumed: Map<string, string>;
+    /** Relationships that belong on another model (a one-to-many with a join column). */
+    foreign: {
+        model: EntityInfo;
+        relation: IrRelation;
+    }[];
+    /** The inverse sides: the owning relationship named `attribute` on `model` gets `relatedName`. */
+    inverse: {
+        model: EntityInfo;
+        attribute: string;
+        relatedName: string;
+    }[];
+}
+/** The model a table belongs to: single-table subclasses live in the table of their root. */
+export declare function modelOwner(entity: EntityInfo): EntityInfo;
+export declare function relationAnnotation(member: Member): Ann;
+/** The entity a relationship points at: `targetEntity`, else the (element) type of the attribute. */
+export declare function targetOf(member: Member, annotation: Ann, resolver: Resolver): EntityInfo | undefined;
+/** `@JoinColumn` entries of an attribute: one, several (`@JoinColumns`), or none. */
+export declare function joinColumnsOf(member: Member): Ann[];
+export interface JoinPair {
+    /** The column in the table that holds the foreign key. */
+    columnName: string;
+    /** The key column of the target it points at. */
+    target: KeyColumn;
+    nullable: boolean | undefined;
+    unique: boolean;
+    constraint?: Ann;
+}
+/** Pairs each join column with the target key column it refers to, applying the JPA default names. */
+export declare function joinPairs(member: Member, target: EntityInfo, resolver: Resolver, place: string): JoinPair[] | undefined;
+/** The referential action of a relationship: `@OnDelete` or, for none, the database default. */
+export declare function onDeleteOf(member: Member, place: string, resolver: Resolver): IrOnDelete;
+export declare function cascadeNote(member: Member, annotation: Ann, place: string, resolver: Resolver): void;
+export declare function constraintName(pair: JoinPair | undefined, member: Member, place: string, resolver: Resolver): string | undefined;
+/** The table name of an entity: `@Table(name)`, else the entity name. */
+export declare function tableNameOf(entity: EntityInfo): string;

package/dist/parsers/jpaJoins.js

@@ -0,0 +1,131 @@
+import { cleanIdentifier } from './jpaColumns.js';
+import { onDeleteAction } from './jpaTypes.js';
+const RELATION_NAMES = [
+    'ManyToOne',
+    'OneToOne',
+    'OneToMany',
+    'ManyToMany',
+];
+/** The model a table belongs to: single-table subclasses live in the table of their root. */
+export function modelOwner(entity) {
+    return entity.inheritance === 'singleTable' ? entity.root : entity;
+}
+export function relationAnnotation(member) {
+    for (const name of RELATION_NAMES) {
+        const found = member.attr.notes.get(name);
+        if (found !== undefined) {
+            return found;
+        }
+    }
+    // Callers only pass members that carry one of the four annotations.
+    throw new Error(`${member.attr.name} has no relationship annotation`);
+}
+/** The entity a relationship points at: `targetEntity`, else the (element) type of the attribute. */
+export function targetOf(member, annotation, resolver) {
+    const type = member.attr.type;
+    const named = annotation.className('targetEntity') ??
+        (type.args.length > 0 ? type.args[type.args.length - 1]?.name : type.name);
+    return named === undefined ? undefined : resolver.entities.get(named);
+}
+/** `@JoinColumn` entries of an attribute: one, several (`@JoinColumns`), or none. */
+export function joinColumnsOf(member) {
+    return member.attr.notes.repeated('JoinColumn', 'JoinColumns');
+}
+/** The column a join column refers to: a key column, or any other column of the target (a unique one, usually). */
+function referencedKey(keys, target, columnName, resolver) {
+    const wanted = columnName.toLowerCase();
+    const key = keys.find((item) => item.columnName.toLowerCase() === wanted);
+    if (key !== undefined) {
+        return key;
+    }
+    const other = resolver
+        .fieldsOf(target)
+        .find((item) => item.field.columnName.toLowerCase() === wanted);
+    return other === undefined
+        ? undefined
+        : { name: other.field.name, columnName: other.field.columnName };
+}
+/** Pairs each join column with the target key column it refers to, applying the JPA default names. */
+export function joinPairs(member, target, resolver, place) {
+    const keys = resolver.keyOf(target);
+    const columns = joinColumnsOf(member);
+    if (keys.length === 0) {
+        resolver.warn(`${place}: the target ${target.name} has no primary key, so the foreign key cannot be placed.`);
+        return undefined;
+    }
+    if (columns.length === 0) {
+        return keys.map((key) => ({
+            columnName: `${member.attr.name}_${key.columnName}`,
+            target: key,
+            nullable: undefined,
+            unique: false,
+        }));
+    }
+    const pairs = [];
+    columns.forEach((column, position) => {
+        const referenced = column.string('referencedColumnName');
+        const key = referenced === undefined || referenced === ''
+            ? (keys[position] ?? keys[0])
+            : referencedKey(keys, target, cleanIdentifier(referenced), resolver);
+        const named = column.string('name');
+        if (key === undefined) {
+            resolver.warn(`${place}: the join column refers to "${referenced ?? ''}", which is not a key column of ${target.name}; the relationship was skipped.`);
+            return;
+        }
+        const constraint = column.annotation('foreignKey');
+        pairs.push({
+            columnName: named === undefined || named === ''
+                ? `${member.attr.name}_${key.columnName}`
+                : cleanIdentifier(named),
+            target: key,
+            nullable: column.boolean('nullable'),
+            unique: column.boolean('unique') ?? false,
+            ...(constraint === undefined ? {} : { constraint }),
+        });
+    });
+    return pairs.length === columns.length ? pairs : undefined;
+}
+/** The referential action of a relationship: `@OnDelete` or, for none, the database default. */
+export function onDeleteOf(member, place, resolver) {
+    const action = member.attr.notes.get('OnDelete', true);
+    const name = action?.member('action');
+    if (name === undefined) {
+        return 'noAction';
+    }
+    const mapped = onDeleteAction(name);
+    if (mapped === undefined) {
+        resolver.warn(`${place}: the @OnDelete action ${name} is not known; the database default (no action) was used.`);
+        return 'noAction';
+    }
+    return mapped;
+}
+export function cascadeNote(member, annotation, place, resolver) {
+    const cascade = annotation.members('cascade');
+    const removes = cascade.some((name) => name === 'REMOVE' || name === 'ALL');
+    const orphan = annotation.boolean('orphanRemoval') === true;
+    if (!removes && !orphan) {
+        return;
+    }
+    const cascadesInDatabase = member.attr.notes.get('OnDelete', true)?.member('action') === 'CASCADE';
+    if (!cascadesInDatabase) {
+        resolver.warn(`${place}: ${removes ? `cascade ${cascade.includes('ALL') ? 'ALL' : 'REMOVE'}` : 'orphanRemoval'} deletes children through the ORM only; it adds no ON DELETE CASCADE to the foreign key, which is written as read (add @OnDelete(action = OnDeleteAction.CASCADE) on the owning side for that).`);
+    }
+}
+export function constraintName(pair, member, place, resolver) {
+    const own = pair?.constraint ??
+        member.attr.notes.get('JoinColumn')?.annotation('foreignKey');
+    const legacy = member.attr.notes.get('ForeignKey', true);
+    if (own?.member('value') === 'NO_CONSTRAINT') {
+        resolver.warn(`${place}: ConstraintMode.NO_CONSTRAINT means Hibernate creates no foreign key constraint; it was read as a foreign key.`);
+    }
+    const name = own?.string('name') ?? legacy?.string('name');
+    return name === undefined || name === '' ? undefined : name;
+}
+/** The table name of an entity: `@Table(name)`, else the entity name. */
+export function tableNameOf(entity) {
+    const given = entity.notes.get('Table')?.string('name');
+    return given === undefined || given === ''
+        ? entity.entityName
+        : cleanIdentifier(given);
+}
+//# sourceMappingURL=jpaJoins.js.map

package/dist/parsers/jpaJoins.js.map

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

package/dist/parsers/jpaModel.d.ts

@@ -0,0 +1,73 @@
+import type { Ann, Annotated } from './jpaAnnotations.js';
+import type { ConstLookup, JavaClass, JavaType, SyntaxNode } from './javaSyntax.js';
+/** What the reader knows about the whole input; shared by every step. */
+export interface Project {
+    /** Every class of the input by simple name (enums are in `enums`). */
+    classes: Map<string, JavaClass>;
+    /** Java `enum` types by simple name. */
+    enums: Map<string, JavaClass>;
+    /** `AttributeConverter` classes by simple name. */
+    converters: Map<string, ConverterInfo>;
+    lookup: ConstLookup;
+    warnings: string[];
+    appLabel: string;
+}
+/** An `AttributeConverter<X, Y>` class: attributes of type X are stored as Y. */
+export interface ConverterInfo {
+    name: string;
+    attributeType: JavaType;
+    columnType: JavaType;
+    autoApply: boolean;
+}
+/** A mapped attribute of a class: a field, or a getter under property access. */
+export interface Attribute {
+    name: string;
+    type: JavaType;
+    notes: Annotated;
+    /** The class that declares the attribute. */
+    declaredIn: string;
+    /** The class's imports, to tell `java.sql.Date` from `java.util.Date`. */
+    imports: readonly string[];
+    isProperty: boolean;
+    initializer?: SyntaxNode;
+}
+export type MemberKind = 'basic' | 'relation' | 'collection';
+/** An attribute of an entity after embeddables are flattened into it. */
+export interface Member {
+    attr: Attribute;
+    /** Attribute names from the entity down to this attribute: `['address', 'street']`. */
+    path: string[];
+    kind: MemberKind;
+    /** The `@Column` that applies: from the closest `@AttributeOverride`, else the attribute's own. */
+    column?: Ann;
+    /** True for `@Id` attributes and the attributes of an `@EmbeddedId`. */
+    isId: boolean;
+    /** True for the attributes of an `@EmbeddedId`. */
+    inEmbeddedId: boolean;
+    /** The entity class the member belongs to (the subclass in a hierarchy). */
+    declaredIn: string;
+}
+export type InheritanceKind = 'none' | 'singleTable' | 'joined' | 'tablePerClass';
+/** An entity class with its position in a hierarchy. */
+export interface EntityInfo {
+    cls: JavaClass;
+    /** The class name, which is also the IR model name. */
+    name: string;
+    /** The JPA entity name: `@Entity(name)`, else the class name. */
+    entityName: string;
+    notes: Annotated;
+    /** The superclasses in the input, root first, ending with the class itself. */
+    chain: JavaClass[];
+    /** The access type of each class of `chain`. */
+    accesses: ('field' | 'property')[];
+    /** The closest superclass that is an entity, when there is one. */
+    parent?: EntityInfo;
+    /** The entities that extend this one directly. */
+    children: EntityInfo[];
+    /** The first entity of the hierarchy. */
+    root: EntityInfo;
+    inheritance: InheritanceKind;
+    isAbstract: boolean;
+    /** The attributes that become columns or relationships of this entity's table. */
+    members: Member[];
+}

package/dist/parsers/jpaModel.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=jpaModel.js.map

package/dist/parsers/jpaModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jpaModel.js","sourceRoot":"","sources":["../../src/parsers/jpaModel.ts"],"names":[],"mappings":""}

package/dist/parsers/jpaNotes.d.ts

@@ -0,0 +1,20 @@
+import type { IrField, IrRelation } from '../ir.js';
+import type { BuiltField } from './jpaColumns.js';
+import type { EntityInfo } from './jpaModel.js';
+import type { Resolver } from './jpaJoins.js';
+/** What the inheritance of an entity adds to its model. */
+export interface InheritanceParts {
+    leadingFields: IrField[];
+    trailingFields: IrField[];
+    relations: IrRelation[];
+    /** Set when the primary key is the foreign key to the parent table (joined inheritance). */
+    primaryKeyRelation?: IrRelation;
+}
+/**
+ * Reads the inheritance strategy. Single-table subclasses are merged into the root (the discriminator column is
+ * added), joined subclasses get the foreign key to their parent as primary key, and table-per-class entities
+ * are independent tables; each case warns, because the shared model has no inheritance.
+ */
+export declare function inheritanceNotes(entity: EntityInfo, fields: readonly IrField[], resolver: Resolver): InheritanceParts;
+/** Warns about table-level settings that have no place in the shared model. */
+export declare function tableNotes(entity: EntityInfo, built: readonly BuiltField[], warn: (message: string) => void): void;