@plan2net/typo3-playwright-toolkit 0.5.0 → 0.6.0

package/README.md

@@ -47,9 +47,10 @@ Add a `tsconfig.json` next to your tests that extends the one shipped here:
 }
 ```
 
-Important: this package is ESM and needs `"moduleResolution": "NodeNext"`. Without
-it TypeScript cannot read the package's exports, so `page` and `state` in your tests
-type as `any` and you lose every check your editor could give you.
+> [!IMPORTANT]
+> This package is ESM and needs `"moduleResolution": "NodeNext"`. Without it
+> TypeScript cannot read the package's exports, so `page` and `state` in your tests
+> type as `any` and you lose every check your editor could give you.
 
 ## Configure
 
@@ -82,8 +83,9 @@ directory is not an error: the run works and writes its state somewhere you did
 expect. Use `fileURLToPath` rather than `new URL(...).pathname`, which
 percent-encodes a project path containing spaces or non-ASCII characters.
 
-Important: `defineToolkitConfig` must run before the first import from this package.
-Everything else reads the values it stores.
+> [!IMPORTANT]
+> `defineToolkitConfig` must run before the first import from this package.
+> Everything else reads the values it stores.
 
 ## Using the package
 
@@ -209,6 +211,50 @@ A key with the name of a core CType replaces the built-in builder, and the other
 core types stay as they are. That works for the type too: `ContentTypeMap` starts
 empty, so your `text: MyTextContent` is what `.configure()` hands you.
 
+### Files and child records
+
+Four setters attach a relation, and they work the same on a content type, on a
+child record, and on the builder in a test:
+
+```ts
+export class AccordionContent extends CoreContent {
+    readonly type = 'accordion'
+
+    withItems(items: AccordionItem[]): this {
+        return this.withChildren('items', 'tx_myext_accordion_item', items, (item, data) =>
+            item
+                .withField('title', data.title)
+                .withFileReference('image', data.imageId),
+        )
+    }
+}
+```
+
+`withFileReference(column, fileUid)` and `withFileReferences(column, fileUids)` take
+the reference's own fields as a third argument, such as a `crop`. `withChild` and
+`withChildren` hand the callback a record with the same four setters, so a child can
+carry its own files and children.
+
+The order you call them in is the order the records get. A child takes `pid` and
+`sys_language_uid` from the record above it, so a translation sets the language once,
+at the top.
+
+Never set `uid_local`, `uid_foreign`, `tablenames`, `fieldname` or `sorting_foreign`:
+the toolkit writes them, and your own value fails. A wrong `uid_foreign` saves a row
+that points at nothing, and TYPO3 reports no error.
+
+If a builder has no setter for a column, add the relation in the test:
+
+```ts
+await builders.content().onPage(page.id).ofType('textmedia')
+    .configure((element) => element.withHeader('Gallery', 'h2'))
+    .withFileReferences('assets', [1, 2], { crop: imageCrop({ ratio: '16:9' }) })
+    .create()
+```
+
+Fill a column from one place only. Both the content type and the test, or `withField`
+on top, fails.
+
 ### Calling the site directly
 
 The `request` client — the one `defineScenario` hands your setup, and the `request`
@@ -271,8 +317,9 @@ await runAccessibilityScan(page, { exclude: '#ads' })
 await runAccessibilityScan(page, { disabledRules: ['color-contrast'] })
 ```
 
-Important: the test also fails when the check ran no rules at all. An empty area
-would otherwise pass without testing anything.
+> [!IMPORTANT]
+> The test also fails when the check ran no rules at all. An empty area would
+> otherwise pass without testing anything.
 
 A check with `include` turns off the `heading-order` rule, because axe compares the
 headings of a part of the page with the structure of the whole page. Checks of a
@@ -307,8 +354,9 @@ await page.goto('/')
 await verifier.assertNoViolations(testInfo)  // testInfo is optional
 ```
 
-Important: `install()` must run before anything is loaded. A page that is already
-open reports nothing.
+> [!IMPORTANT]
+> `install()` must run before anything is loaded. A page that is already open
+> reports nothing.
 
 The test also fails if pages were requested but none of your own pages ever arrived,
 so a navigation that never loaded cannot pass. Pass `testInfo` to attach the full
@@ -368,9 +416,32 @@ Every CType of a normal TYPO3 installation has a builder, and you register nothi
 
 All builders share `withHeader`, `withSubheader`, `withHeaderLayout`,
 `withHeaderLink`, `withColPos`, `setHidden`, and `withField(column, value)` for any
-other TCA column. Types with images add `withFile` and `withFiles`, which write the
-`sys_file_reference` rows for you, plus `withColumns`, `withOrientation` and
-`withImageSize`.
+other TCA column. They also share the four relation setters above —
+`withFileReference`, `withFileReferences`, `withChild` and `withChildren`. Types with
+images add `withFile` and `withFiles` for their own media column, plus `withColumns`,
+`withOrientation` and `withImageSize`.
+
+Where core stores a number that means nothing on its own, the setter takes the name
+and your editor suggests the options:
+
+```ts
+element.withHeader('Chapter', 'h3')      // header_layout 3, or 'hidden' for 100
+element.withBulletsType('numbers')       // bullets_type 1
+element.withHeaderPosition('top')        // table_header_position 1
+element.withOrientation('in-text-right') // imageorient 17
+```
+
+`PageBuilder` does the same for the page type: `withDoktype('folder')` writes 254.
+It also takes a number, for a doktype your own project registered.
+
+The `crop` column of a file reference holds JSON text, which `imageCrop()` writes for
+you. Without an area it keeps the whole image, which is what naming only a ratio
+means:
+
+```ts
+imageCrop({ ratio: '16:9' })
+imageCrop({ area: { x: 0.1, y: 0, width: 0.5, height: 1 } })
+```
 
 A flexform column takes `flexForm()`, because the form posts one field per value
 rather than one for the column:

package/dist/builders/content-builder.d.ts

@@ -1,6 +1,7 @@
 import { Page } from '@playwright/test';
-import { ContentBuilderInterface } from '../types/content-builder.js';
+import { ContentBuilderInterface, type ContentFields } from '../types/content-builder.js';
 import type { ContentTypeFor, ContentTypeKey } from './core-content.js';
+import { type ChildRecord } from './relations.js';
 import { type RequestContext } from './request-context.js';
 export declare class ContentBuilder {
     private page;
@@ -20,8 +21,15 @@ declare class TypedContentBuilder<B extends ContentBuilderInterface = ContentBui
     private pageId;
     private requestContext?;
     private builder;
+    private readonly fields;
+    private readonly relations;
     constructor(page: Page, pageId: string, type: string, requestContext?: Partial<RequestContext> | undefined);
     configure(fn: (builder: B) => void): this;
+    withField(column: string, value: ContentFields[string]): this;
+    withFileReference(column: string, fileUid: number, fields?: ContentFields): this;
+    withFileReferences(column: string, fileUids: number[], fields?: ContentFields): this;
+    withChild(column: string, table: string, configure: (child: ChildRecord) => void): this;
+    withChildren<T>(column: string, table: string, items: T[], configure: (child: ChildRecord, item: T) => void): this;
     create(): Promise<{
         id: string;
     }>;

package/dist/builders/content-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content-builder.d.ts","sourceRoot":"","sources":["../../src/builders/content-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAErE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGvE,OAAO,EAAyC,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAGjG,qBAAa,cAAc;IACvB,OAAO,CAAC,IAAI,CAAM;IAClB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAyB;gBAE7C,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAKhE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5B;;;OAGG;IACH,MAAM,CAAC,CAAC,SAAS,cAAc,EAAE,IAAI,EAAE,CAAC,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IACjF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAAC,uBAAuB,CAAC;CAWrE;AAED,cAAM,mBAAmB,CAAC,CAAC,SAAS,uBAAuB,GAAG,uBAAuB;IAI7E,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,MAAM;IAEd,OAAO,CAAC,cAAc,CAAC;IAN3B,OAAO,CAAC,OAAO,CAAyB;gBAG5B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,EACJ,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,YAAA;IAKpD,SAAS,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAKnC,MAAM,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAkC1C"}
+{"version":3,"file":"content-builder.d.ts","sourceRoot":"","sources":["../../src/builders/content-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,uBAAuB,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAEzF,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvE,OAAO,EAA6B,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE5E,OAAO,EAAyC,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAKjG,qBAAa,cAAc;IACvB,OAAO,CAAC,IAAI,CAAM;IAClB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAyB;gBAE7C,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAKhE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5B;;;OAGG;IACH,MAAM,CAAC,CAAC,SAAS,cAAc,EAAE,IAAI,EAAE,CAAC,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IACjF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAAC,uBAAuB,CAAC;CAWrE;AAED,cAAM,mBAAmB,CAAC,CAAC,SAAS,uBAAuB,GAAG,uBAAuB;IAM7E,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,MAAM;IAEd,OAAO,CAAC,cAAc,CAAC;IAR3B,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmE;gBAGjF,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,EACJ,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,YAAA;IAKpD,SAAS,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAKzC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI;IAM7D,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB,GAAG,IAAI;IAMpF,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,GAAE,aAAkB,GAAG,IAAI;IAMxF,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAMvF,YAAY,CAAC,CAAC,EACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,KAAK,IAAI,GACjD,IAAI;IAMD,MAAM,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAmD1C"}

package/dist/builders/content-builder.js

@@ -1,8 +1,10 @@
 import { createContent } from './content-factory.js';
 import { saveRecord } from '../http/record-edit.js';
-import { coerceFields } from './fields.js';
+import { mergeRecords, RelationSet } from './relations.js';
+import { toColumnValues } from './fields.js';
 import { replayParentId, resolveRequestContext } from './request-context.js';
 import { newRecordIdentifier } from './identifier.js';
+const lastElementOnPage = new WeakMap();
 export class ContentBuilder {
     page;
     pageId = '';
@@ -28,6 +30,8 @@ class TypedContentBuilder {
     pageId;
     requestContext;
     builder;
+    fields = {};
+    relations = new RelationSet('tt_content', (column) => column in this.fields);
     constructor(page, pageId, type, requestContext) {
         this.page = page;
         this.pageId = pageId;
@@ -38,6 +42,26 @@ class TypedContentBuilder {
         fn(this.builder);
         return this;
     }
+    withField(column, value) {
+        this.fields[column] = value;
+        return this;
+    }
+    withFileReference(column, fileUid, fields = {}) {
+        this.relations.withFileReference(column, fileUid, fields);
+        return this;
+    }
+    withFileReferences(column, fileUids, fields = {}) {
+        this.relations.withFileReferences(column, fileUids, fields);
+        return this;
+    }
+    withChild(column, table, configure) {
+        this.relations.withChild(column, table, configure);
+        return this;
+    }
+    withChildren(column, table, items, configure) {
+        this.relations.withChildren(column, table, items, configure);
+        return this;
+    }
     async create() {
         const context = resolveRequestContext(this.page, this.requestContext);
         const identifier = newRecordIdentifier();
@@ -46,23 +70,56 @@ class TypedContentBuilder {
         // CType and colPos are set below; an empty string means "the type did not
         // set it".
         const own = Object.fromEntries(Object.entries(fields).filter(([column, value]) => value !== '' && !['CType', 'colPos'].includes(column)));
+        const columnValues = toColumnValues({ ...own, ...this.fields });
+        // Not the record's own pid, which carries the -uid positioning the element.
+        const owner = {
+            pid: columnValues.pid ?? pageId,
+            sys_language_uid: columnValues.sys_language_uid ?? 0,
+        };
+        const inner = this.builder.getRelations?.(owner) ?? { columns: {}, records: {} };
+        const outer = this.relations.materialise(owner);
+        refuseSharedColumns(inner.columns, outer.columns);
         const record = {
-            pid: pageId,
+            pid: insertPosition(this.page, pageId),
             sys_language_uid: 0,
             CType: fields.CType || this.builder.type,
             colPos: fields.colPos ?? 0,
-            ...coerceFields(own),
+            ...columnValues,
+            ...inner.columns,
+            ...outer.columns,
         };
+        // Merged per table, not spread: a child table may be tt_content itself.
+        const data = { tt_content: { [identifier]: record } };
+        mergeRecords(data, this.builder.getAdditionalRecords?.(identifier, pageId) ?? {});
+        mergeRecords(data, inner.records);
+        mergeRecords(data, outer.records);
         const uid = await saveRecord(this.page.request, context, {
             table: 'tt_content',
             identifier: identifier,
             target: Number(pageId),
-            data: {
-                tt_content: { [identifier]: record },
-                ...(this.builder.getAdditionalRecords?.(identifier, pageId) ?? {}),
-            },
+            data,
         });
+        lastElementOnPage.get(this.page)?.set(pageId, uid);
         return { id: String(uid) };
     }
 }
+function refuseSharedColumns(inner, outer) {
+    const shared = Object.keys(outer).filter((column) => column in inner);
+    if (shared.length > 0) {
+        throw new Error(`[typo3-playwright-toolkit] The column ${shared.join(' and ')} is filled twice — ` +
+            'once inside configure() and once on the builder. Nothing decides which of ' +
+            'the two comes first, so the records would end up in a random order. Put ' +
+            'them all in one place.');
+    }
+}
+/** Keyed by the page: `builders.content()` hands out a fresh builder per call. */
+function insertPosition(page, pageId) {
+    let created = lastElementOnPage.get(page);
+    if (undefined === created) {
+        created = new Map();
+        lastElementOnPage.set(page, created);
+    }
+    const previous = created.get(pageId);
+    return undefined === previous ? pageId : `-${previous}`;
+}
 //# sourceMappingURL=content-builder.js.map

package/dist/builders/content-builder.js.map

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

package/dist/builders/core-content.d.ts

@@ -1,9 +1,45 @@
 import type { ContentBuilderInterface, ContentFields } from '../types/content-builder.js';
-import type { RecordDataMap } from '../http/record-edit.js';
+import { RelationSet, type ChildRecord, type RelationOutput, type RelationOwner } from './relations.js';
+declare const HEADING_LEVELS: {
+    readonly h1: 1;
+    readonly h2: 2;
+    readonly h3: 3;
+    readonly h4: 4;
+    readonly h5: 5;
+    readonly hidden: 100;
+};
+declare const BULLET_TYPES: {
+    readonly bullets: 0;
+    readonly numbers: 1;
+    readonly definition: 2;
+};
+declare const TABLE_HEADER_POSITIONS: {
+    readonly none: 0;
+    readonly top: 1;
+    readonly left: 2;
+    readonly both: 3;
+};
+declare const IMAGE_ORIENTATIONS: {
+    readonly 'above-center': 0;
+    readonly 'above-right': 1;
+    readonly 'above-left': 2;
+    readonly 'below-center': 8;
+    readonly 'below-right': 9;
+    readonly 'below-left': 10;
+    readonly 'in-text-right': 17;
+    readonly 'in-text-left': 18;
+    readonly 'beside-text-right': 25;
+    readonly 'beside-text-left': 26;
+};
+export type HeadingLevel = keyof typeof HEADING_LEVELS;
+export type BulletType = keyof typeof BULLET_TYPES;
+export type TableHeaderPosition = keyof typeof TABLE_HEADER_POSITIONS;
+export type ImageOrientation = keyof typeof IMAGE_ORIENTATIONS;
 export declare abstract class CoreContent implements ContentBuilderInterface {
     abstract readonly type: string;
     protected fields: ContentFields;
-    withHeader(header: string): this;
+    protected readonly relations: RelationSet;
+    withHeader(header: string, level?: HeadingLevel): this;
     withSubheader(subheader: string): this;
     /** 0 is "hidden", 1–5 are h1–h5 in a stock fluid_styled_content install. */
     withHeaderLayout(layout: number): this;
@@ -12,24 +48,23 @@ export declare abstract class CoreContent implements ContentBuilderInterface {
     setHidden(hidden?: boolean): this;
     /** Any column the typed setters do not cover, including your own. */
     withField(column: string, value: ContentFields[string]): this;
+    withFileReference(column: string, fileUid: number, fields?: ContentFields): this;
+    withFileReferences(column: string, fileUids: number[], fields?: ContentFields): this;
+    withChild(column: string, table: string, configure: (child: ChildRecord) => void): this;
+    withChildren<T>(column: string, table: string, items: T[], configure: (child: ChildRecord, item: T) => void): this;
+    getRelations(owner: RelationOwner): RelationOutput;
     getFields(): ContentFields;
     protected set(column: string, value: ContentFields[string]): this;
 }
 declare abstract class MediaCoreContent extends CoreContent {
     /** The tt_content column the references hang off — `assets`, `image`, `media`. */
     protected abstract readonly mediaColumn: string;
-    private fileUids;
-    private identifiers;
     withFile(fileUid: number): this;
     withFiles(fileUids: number[]): this;
-    getFields(): ContentFields;
-    getAdditionalRecords(contentIdentifier: string, pageId: string): RecordDataMap;
-    private referenceIdentifiers;
 }
 declare abstract class GalleryCoreContent extends MediaCoreContent {
     withColumns(imagecols: number): this;
-    /** TCA `imageorient`: 0 above-center, 8 below-center, 17 in-text-right, … */
-    withOrientation(imageorient: number): this;
+    withOrientation(orientation: ImageOrientation): this;
     withImageSize(width?: number, height?: number): this;
 }
 export declare class HeaderContent extends CoreContent {
@@ -57,15 +92,13 @@ export declare class BulletsContent extends CoreContent {
     readonly type = "bullets";
     /** One bullet per line — the column is a plain newline-separated text field. */
     withItems(items: string[]): this;
-    /** TCA `bullets_type`: 0 disc, 1 numbered, 2 none. */
-    withBulletsType(bulletsType: number): this;
+    withBulletsType(type: BulletType): this;
 }
 export declare class TableContent extends CoreContent {
     readonly type = "table";
     withRows(rows: string[][]): this;
     withCaption(caption: string): this;
-    /** 1 puts the first row in a thead; 0 none, 2 first column, 3 both. */
-    withHeaderPosition(position: number): this;
+    withHeaderPosition(position: TableHeaderPosition): this;
     private delimiter;
 }
 export declare class UploadsContent extends MediaCoreContent {

package/dist/builders/core-content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core-content.d.ts","sourceRoot":"","sources":["../../src/builders/core-content.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"core-content.d.ts","sourceRoot":"","sources":["../../src/builders/core-content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AACzF,OAAO,EACH,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,aAAa,EACrB,MAAM,gBAAgB,CAAA;AAEvB,QAAA,MAAM,cAAc;;;;;;;CAA8D,CAAA;AAClF,QAAA,MAAM,YAAY;;;;CAAqD,CAAA;AACvE,QAAA,MAAM,sBAAsB;;;;;CAAiD,CAAA;AAC7E,QAAA,MAAM,kBAAkB;;;;;;;;;;;CAWd,CAAA;AAEV,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,cAAc,CAAA;AACtD,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,YAAY,CAAA;AAClD,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,sBAAsB,CAAA;AACrE,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,kBAAkB,CAAA;AAE9D,8BAAsB,WAAY,YAAW,uBAAuB;IAChE,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAE9B,SAAS,CAAC,MAAM,EAAE,aAAa,CAAK;IACpC,SAAS,CAAC,QAAQ,CAAC,SAAS,cAG3B;IAED,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,IAAI;IAMtD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAItC,4EAA4E;IAC5E,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAItC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIlC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIhC,SAAS,CAAC,MAAM,UAAO,GAAG,IAAI;IAI9B,qEAAqE;IACrE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI;IAI7D,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB,GAAG,IAAI;IAMpF,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,GAAE,aAAkB,GAAG,IAAI;IAMxF,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAMvF,YAAY,CAAC,CAAC,EACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,KAAK,IAAI,GACjD,IAAI;IAMP,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc;IAIlD,SAAS,IAAI,aAAa;IAI1B,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI;CAMpE;AAED,uBAAe,gBAAiB,SAAQ,WAAW;IAC/C,kFAAkF;IAClF,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAE/C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI/B,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;CAGtC;AAED,uBAAe,kBAAmB,SAAQ,gBAAgB;IACtD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIpC,eAAe,CAAC,WAAW,EAAE,gBAAgB,GAAG,IAAI;IAIpD,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;CAUvD;AAED,qBAAa,aAAc,SAAQ,WAAW;IAC1C,QAAQ,CAAC,IAAI,YAAW;CAC3B;AAED,qBAAa,WAAY,SAAQ,WAAW;IACxC,QAAQ,CAAC,IAAI,UAAS;IAEtB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAGnC;AAED,qBAAa,gBAAiB,SAAQ,kBAAkB;IACpD,QAAQ,CAAC,IAAI,eAAc;IAE3B,SAAS,CAAC,QAAQ,CAAC,WAAW,YAAW;IAEzC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAGnC;AAED,qBAAa,cAAe,SAAQ,kBAAkB;IAClD,QAAQ,CAAC,IAAI,aAAY;IAEzB,SAAS,CAAC,QAAQ,CAAC,WAAW,WAAU;IAExC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAGnC;AAED,qBAAa,YAAa,SAAQ,kBAAkB;IAChD,QAAQ,CAAC,IAAI,WAAU;IAEvB,SAAS,CAAC,QAAQ,CAAC,WAAW,WAAU;CAC3C;AAED,qBAAa,cAAe,SAAQ,WAAW;IAC3C,QAAQ,CAAC,IAAI,aAAY;IAEzB,gFAAgF;IAChF,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAIhC,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;CAG1C;AAED,qBAAa,YAAa,SAAQ,WAAW;IACzC,QAAQ,CAAC,IAAI,WAAU;IAEvB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI;IAShC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIlC,kBAAkB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAIvD,OAAO,CAAC,SAAS;CAKpB;AAED,qBAAa,cAAe,SAAQ,gBAAgB;IAChD,QAAQ,CAAC,IAAI,aAAY;IAEzB,SAAS,CAAC,QAAQ,CAAC,WAAW,WAAU;CAC3C;AAED,qBAAa,WAAY,SAAQ,WAAW;IACxC,QAAQ,CAAC,IAAI,UAAS;IAEtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAG/B;AAED,qBAAa,cAAe,SAAQ,WAAW;IAC3C,QAAQ,CAAC,IAAI,SAAQ;CACxB;AAED,qBAAa,eAAgB,SAAQ,WAAW;IAC5C,QAAQ,CAAC,IAAI,cAAa;IAE1B,sEAAsE;IACtE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;CAGvC;AAED,qBAAa,WAAY,SAAQ,WAAW;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;IAIjC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAInC,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI;CAGvD;AAED,eAAO,MAAM,UAAU,4OAYb,CAAA;AAEV,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;AAElD,MAAM,WAAW,kBAAmB,SAAQ,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC;IACrE,MAAM,EAAE,aAAa,CAAA;IACrB,IAAI,EAAE,WAAW,CAAA;IACjB,SAAS,EAAE,gBAAgB,CAAA;IAC3B,OAAO,EAAE,cAAc,CAAA;IACvB,KAAK,EAAE,YAAY,CAAA;IACnB,OAAO,EAAE,cAAc,CAAA;IACvB,KAAK,EAAE,YAAY,CAAA;IACnB,OAAO,EAAE,cAAc,CAAA;IACvB,IAAI,EAAE,WAAW,CAAA;IACjB,GAAG,EAAE,cAAc,CAAA;IACnB,QAAQ,EAAE,eAAe,CAAA;CAC5B;AAED;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,cAAc;CAAG;AAElC,MAAM,MAAM,cAAc,GAAG,MAAM,cAAc,GAAG,MAAM,kBAAkB,CAAA;AAE5E,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,cAAc,IAAI,CAAC,SAAS,MAAM,cAAc,GAC/E,cAAc,CAAC,CAAC,CAAC,GACjB,CAAC,SAAS,MAAM,kBAAkB,GAChC,kBAAkB,CAAC,CAAC,CAAC,GACrB,KAAK,CAAA;AAEb,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,uBAAuB,CAAC,CAwBpF"}

package/dist/builders/core-content.js

@@ -1,8 +1,25 @@
-import { newRecordIdentifier } from './identifier.js';
+import { RelationSet, } from './relations.js';
+const HEADING_LEVELS = { h1: 1, h2: 2, h3: 3, h4: 4, h5: 5, hidden: 100 };
+const BULLET_TYPES = { bullets: 0, numbers: 1, definition: 2 };
+const TABLE_HEADER_POSITIONS = { none: 0, top: 1, left: 2, both: 3 };
+const IMAGE_ORIENTATIONS = {
+    'above-center': 0,
+    'above-right': 1,
+    'above-left': 2,
+    'below-center': 8,
+    'below-right': 9,
+    'below-left': 10,
+    'in-text-right': 17,
+    'in-text-left': 18,
+    'beside-text-right': 25,
+    'beside-text-left': 26,
+};
 export class CoreContent {
     fields = {};
-    withHeader(header) {
-        return this.set('header', header);
+    relations = new RelationSet('tt_content', (column) => column in this.fields);
+    withHeader(header, level) {
+        this.set('header', header);
+        return undefined === level ? this : this.withHeaderLayout(HEADING_LEVELS[level]);
     }
     withSubheader(subheader) {
         return this.set('subheader', subheader);
@@ -24,66 +41,48 @@ export class CoreContent {
     withField(column, value) {
         return this.set(column, value);
     }
+    withFileReference(column, fileUid, fields = {}) {
+        this.relations.withFileReference(column, fileUid, fields);
+        return this;
+    }
+    withFileReferences(column, fileUids, fields = {}) {
+        this.relations.withFileReferences(column, fileUids, fields);
+        return this;
+    }
+    withChild(column, table, configure) {
+        this.relations.withChild(column, table, configure);
+        return this;
+    }
+    withChildren(column, table, items, configure) {
+        this.relations.withChildren(column, table, items, configure);
+        return this;
+    }
+    getRelations(owner) {
+        return this.relations.materialise(owner);
+    }
     getFields() {
         return { CType: this.type, ...this.fields };
     }
     set(column, value) {
+        this.relations.refuseColumnHeld(column);
         this.fields[column] = value;
         return this;
     }
 }
 class MediaCoreContent extends CoreContent {
-    fileUids = [];
-    identifiers = [];
     withFile(fileUid) {
-        this.fileUids.push(fileUid);
-        return this;
+        return this.withFileReference(this.mediaColumn, fileUid);
     }
     withFiles(fileUids) {
-        this.fileUids.push(...fileUids);
-        return this;
-    }
-    getFields() {
-        const fields = super.getFields();
-        if (this.fileUids.length > 0) {
-            fields[this.mediaColumn] = this.referenceIdentifiers().join(',');
-        }
-        return fields;
-    }
-    getAdditionalRecords(contentIdentifier, pageId) {
-        if (this.fileUids.length === 0) {
-            return {};
-        }
-        const identifiers = this.referenceIdentifiers();
-        const references = {};
-        this.fileUids.forEach((fileUid, index) => {
-            references[identifiers[index]] = {
-                uid_local: fileUid,
-                pid: pageId,
-                tablenames: 'tt_content',
-                fieldname: this.mediaColumn,
-                sys_language_uid: 0,
-                sorting_foreign: index + 1,
-            };
-        });
-        return { sys_file_reference: references };
-    }
-    // Minted once: getFields() lists them in the parent column and
-    // getAdditionalRecords() keys the children by them, and the two must agree.
-    referenceIdentifiers() {
-        while (this.identifiers.length < this.fileUids.length) {
-            this.identifiers.push(newRecordIdentifier());
-        }
-        return this.identifiers;
+        return this.withFileReferences(this.mediaColumn, fileUids);
     }
 }
 class GalleryCoreContent extends MediaCoreContent {
     withColumns(imagecols) {
         return this.set('imagecols', imagecols);
     }
-    /** TCA `imageorient`: 0 above-center, 8 below-center, 17 in-text-right, … */
-    withOrientation(imageorient) {
-        return this.set('imageorient', imageorient);
+    withOrientation(orientation) {
+        return this.set('imageorient', IMAGE_ORIENTATIONS[orientation]);
     }
     withImageSize(width, height) {
         if (undefined !== width) {
@@ -128,9 +127,8 @@ export class BulletsContent extends CoreContent {
     withItems(items) {
         return this.set('bodytext', items.join('\n'));
     }
-    /** TCA `bullets_type`: 0 disc, 1 numbered, 2 none. */
-    withBulletsType(bulletsType) {
-        return this.set('bullets_type', bulletsType);
+    withBulletsType(type) {
+        return this.set('bullets_type', BULLET_TYPES[type]);
     }
 }
 export class TableContent extends CoreContent {
@@ -142,9 +140,8 @@ export class TableContent extends CoreContent {
     withCaption(caption) {
         return this.set('table_caption', caption);
     }
-    /** 1 puts the first row in a thead; 0 none, 2 first column, 3 both. */
     withHeaderPosition(position) {
-        return this.set('table_header_position', position);
+        return this.set('table_header_position', TABLE_HEADER_POSITIONS[position]);
     }
     delimiter() {
         const configured = this.fields.table_delimiter;

package/dist/builders/core-content.js.map

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

package/dist/builders/fields.d.ts

@@ -1,4 +1,19 @@
 import type { NestedFields } from '../types/common.js';
+export interface CropRectangle {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * The `crop` column of a file reference, which holds JSON text. Without an area it
+ * keeps the whole image, which is what a ratio on its own means.
+ */
+export declare function imageCrop(options?: {
+    ratio?: string;
+    area?: CropRectangle;
+    focus?: CropRectangle | null;
+}): string;
 export type FlexFormValues = Record<string, string | number | boolean>;
 /**
  * A flexform column, for `withField('pi_flexform', flexForm({...}))`. Plain values
@@ -10,5 +25,5 @@ export declare function flexForm(sheets: Record<string, FlexFormValues>): Nested
  * A boolean is a 0/1 int column. An undefined field is left out rather than sent
  * as null, which DataHandler would write.
  */
-export declare function coerceFields(fields: Record<string, unknown>): Record<string, unknown>;
+export declare function toColumnValues(fields: Record<string, unknown>): Record<string, unknown>;
 //# sourceMappingURL=fields.d.ts.map

package/dist/builders/fields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/builders/fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;AAEtE;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAAA;AAC9D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,YAAY,CAAA;AAoB9E;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAerF"}
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/builders/fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,MAAM,WAAW,aAAa;IAC1B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACjB;AAID;;;GAGG;AACH,wBAAgB,SAAS,CACrB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,aAAa,CAAC;IAAC,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;CAAO,GACrF,MAAM,CAQR;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;AAEtE;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAAA;AAC9D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,YAAY,CAAA;AAoB9E;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAevF"}

package/dist/builders/fields.js

@@ -1,3 +1,17 @@
+const WHOLE_IMAGE = { x: 0, y: 0, width: 1, height: 1 };
+/**
+ * The `crop` column of a file reference, which holds JSON text. Without an area it
+ * keeps the whole image, which is what a ratio on its own means.
+ */
+export function imageCrop(options = {}) {
+    return JSON.stringify({
+        default: {
+            cropArea: options.area ?? WHOLE_IMAGE,
+            selectedRatio: options.ratio ?? 'NaN',
+            focusArea: options.focus ?? null,
+        },
+    });
+}
 export function flexForm(input) {
     const sheets = Object.values(input).every((value) => 'object' === typeof value)
         ? input
@@ -16,18 +30,18 @@ export function flexForm(input) {
  * A boolean is a 0/1 int column. An undefined field is left out rather than sent
  * as null, which DataHandler would write.
  */
-export function coerceFields(fields) {
-    const coerced = {};
+export function toColumnValues(fields) {
+    const values = {};
     for (const [column, value] of Object.entries(fields)) {
         if (value === undefined) {
             continue;
         }
         if ('boolean' === typeof value) {
-            coerced[column] = value ? 1 : 0;
+            values[column] = value ? 1 : 0;
             continue;
         }
-        coerced[column] = value;
+        values[column] = value;
     }
-    return coerced;
+    return values;
 }
 //# sourceMappingURL=fields.js.map

package/dist/builders/fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../src/builders/fields.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,QAAQ,CACpB,KAAsD;IAEtD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,KAAK,OAAO,KAAK,CAAC;QAC3E,CAAC,CAAE,KAAwC;QAC3C,CAAC,CAAC,EAAE,IAAI,EAAE,KAAuB,EAAE,CAAA;IAEvC,MAAM,IAAI,GAAiB,EAAE,CAAA;IAC7B,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,MAAM,MAAM,GAAiB,EAAE,CAAA;QAC/B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACjD,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;QAClC,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IAClC,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,CAAA;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAA+B;IACxD,MAAM,OAAO,GAA4B,EAAE,CAAA;IAE3C,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,SAAQ;QACZ,CAAC;QACD,IAAI,SAAS,KAAK,OAAO,KAAK,EAAE,CAAC;YAC7B,OAAO,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;YAC/B,SAAQ;QACZ,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,GAAG,KAAK,CAAA;IAC3B,CAAC;IAED,OAAO,OAAO,CAAA;AAClB,CAAC"}
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../src/builders/fields.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,GAAkB,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAA;AAEtE;;;GAGG;AACH,MAAM,UAAU,SAAS,CACrB,UAAkF,EAAE;IAEpF,OAAO,IAAI,CAAC,SAAS,CAAC;QAClB,OAAO,EAAE;YACL,QAAQ,EAAE,OAAO,CAAC,IAAI,IAAI,WAAW;YACrC,aAAa,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK;YACrC,SAAS,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI;SACnC;KACJ,CAAC,CAAA;AACN,CAAC;AAUD,MAAM,UAAU,QAAQ,CACpB,KAAsD;IAEtD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,KAAK,OAAO,KAAK,CAAC;QAC3E,CAAC,CAAE,KAAwC;QAC3C,CAAC,CAAC,EAAE,IAAI,EAAE,KAAuB,EAAE,CAAA;IAEvC,MAAM,IAAI,GAAiB,EAAE,CAAA;IAC7B,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,MAAM,MAAM,GAAiB,EAAE,CAAA;QAC/B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACjD,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;QAClC,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IAClC,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,CAAA;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAA+B;IAC1D,MAAM,MAAM,GAA4B,EAAE,CAAA;IAE1C,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,SAAQ;QACZ,CAAC;QACD,IAAI,SAAS,KAAK,OAAO,KAAK,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;YAC9B,SAAQ;QACZ,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,CAAA;IAC1B,CAAC;IAED,OAAO,MAAM,CAAA;AACjB,CAAC"}

package/dist/builders/identifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identifier.d.ts","sourceRoot":"","sources":["../../src/builders/identifier.ts"],"names":[],"mappings":"AASA,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}
+{"version":3,"file":"identifier.d.ts","sourceRoot":"","sources":["../../src/builders/identifier.ts"],"names":[],"mappings":"AAEA,wBAAgB,mBAAmB,IAAI,MAAM,CAK5C"}

package/dist/builders/identifier.js

@@ -1,11 +1,8 @@
 // Hex only, like StringUtility::getUniqueId(): RelationHandler reads a list
 // entry containing `_` as table_uid and never resolves it back to the record.
-function typo3StyleIdentifier() {
+export function newRecordIdentifier() {
     const time = Date.now().toString(16);
     const entropy = Math.floor(Math.random() * 0xffffffff).toString(16);
     return `NEW${time}${entropy.padStart(8, '0')}`;
 }
-export function newRecordIdentifier() {
-    return typo3StyleIdentifier();
-}
 //# sourceMappingURL=identifier.js.map

package/dist/builders/identifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"identifier.js","sourceRoot":"","sources":["../../src/builders/identifier.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8EAA8E;AAC9E,SAAS,oBAAoB;IACzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IAEnE,OAAO,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAA;AAClD,CAAC;AAED,MAAM,UAAU,mBAAmB;IAC/B,OAAO,oBAAoB,EAAE,CAAA;AACjC,CAAC"}
+{"version":3,"file":"identifier.js","sourceRoot":"","sources":["../../src/builders/identifier.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8EAA8E;AAC9E,MAAM,UAAU,mBAAmB;IAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IAEnE,OAAO,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAA;AAClD,CAAC"}

package/dist/builders/page-builder.d.ts

@@ -4,6 +4,16 @@ import { type RequestContext } from './request-context.js';
 interface Fields {
     [key: string]: string | number | boolean | undefined | NestedFields;
 }
+declare const DOKTYPES: {
+    readonly page: 1;
+    readonly link: 3;
+    readonly shortcut: 4;
+    readonly 'backend-user-section': 6;
+    readonly mountpoint: 7;
+    readonly spacer: 199;
+    readonly folder: 254;
+};
+export type Doktype = keyof typeof DOKTYPES;
 export declare class PageBuilder {
     protected fields: Fields;
     private page;
@@ -19,6 +29,8 @@ export declare class PageBuilder {
     withSlug(slug: string): this;
     withExistingImage(fileId: number): this;
     withImageCropFocus(cropConfig: CropConfig): this;
+    /** A name core ships, or a number if your project registered its own doktype. */
+    withDoktype(type: Doktype | number): this;
     atParentId(id: number): this;
     create(): Promise<{
         id: string;

package/dist/builders/page-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page-builder.d.ts","sourceRoot":"","sources":["../../src/builders/page-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAE7D,OAAO,EAAwD,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAKhH,UAAU,MAAM;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,CAAA;CACtE;AAKD,qBAAa,WAAW;IACpB,SAAS,CAAC,MAAM,EAAE,MAAM,CAOvB;IAED,OAAO,CAAC,IAAI,CAAM;IAClB,OAAO,CAAC,WAAW,CAAC,CAAQ;IAC5B,OAAO,CAAC,eAAe,CAAC,CAAY;IACpC,OAAO,CAAC,oBAAoB,CAAC,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAyB;gBAE7C,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAKhE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK9B,+EAA+E;IAC/E,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI;IAKjE,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAa5B,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKvC,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAKhD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKtB,MAAM,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAsB/C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAiBnE,OAAO,CAAC,SAAS;IAiBjB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,eAAe;CAK1B"}
+{"version":3,"file":"page-builder.d.ts","sourceRoot":"","sources":["../../src/builders/page-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAE7D,OAAO,EAAwD,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAKhH,UAAU,MAAM;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,CAAA;CACtE;AAED,QAAA,MAAM,QAAQ;;;;;;;;CAQJ,CAAA;AAEV,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,QAAQ,CAAA;AAE3C,qBAAa,WAAW;IACpB,SAAS,CAAC,MAAM,EAAE,MAAM,CAOvB;IAED,OAAO,CAAC,IAAI,CAAM;IAClB,OAAO,CAAC,WAAW,CAAC,CAAQ;IAC5B,OAAO,CAAC,eAAe,CAAC,CAAY;IACpC,OAAO,CAAC,oBAAoB,CAAC,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAyB;gBAE7C,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAKhE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK9B,+EAA+E;IAC/E,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI;IAKjE,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAa5B,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKvC,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAKhD,iFAAiF;IACjF,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAMzC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKtB,MAAM,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAsB/C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAiBnE,OAAO,CAAC,SAAS;IAiBjB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,eAAe;CAK1B"}

package/dist/builders/page-builder.js

@@ -1,9 +1,17 @@
 import { saveRecord } from '../http/record-edit.js';
 import { replayParentId, requireTestId, resolveRequestContext } from './request-context.js';
-import { coerceFields } from './fields.js';
+import { toColumnValues, imageCrop } from './fields.js';
 import { newRecordIdentifier } from './identifier.js';
 import { getToolkitConfig } from '../config.js';
-const DEFAULT_CROP = '{"default":{"cropArea":{"x":0,"y":0,"width":1,"height":1},"selectedRatio":"NaN","focusArea":null}}';
+const DOKTYPES = {
+    page: 1,
+    link: 3,
+    shortcut: 4,
+    'backend-user-section': 6,
+    mountpoint: 7,
+    spacer: 199,
+    folder: 254,
+};
 export class PageBuilder {
     fields = {
         doktype: 1,
@@ -50,6 +58,11 @@ export class PageBuilder {
         this.imageCropConfig = cropConfig;
         return this;
     }
+    /** A name core ships, or a number if your project registered its own doktype. */
+    withDoktype(type) {
+        this.fields.doktype = 'number' === typeof type ? type : DOKTYPES[type];
+        return this;
+    }
     atParentId(id) {
         this.fields.pid = id;
         return this;
@@ -118,13 +131,13 @@ export class PageBuilder {
                     alternative: '',
                     description: '',
                     title: '',
-                    crop: this.imageCropConfig ? JSON.stringify(this.imageCropConfig) : DEFAULT_CROP,
+                    crop: this.imageCropConfig ? JSON.stringify(this.imageCropConfig) : imageCrop(),
                 },
             },
         };
     }
     pageFields() {
-        const fields = coerceFields(this.fields);
+        const fields = toColumnValues(this.fields);
         if (this.imageFileId) {
             fields.media = this.mediaIdentifier();
         }

package/dist/builders/page-builder.js.map

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

package/dist/builders/relations.d.ts

@@ -0,0 +1,41 @@
+import type { RecordDataMap } from '../http/record-edit.js';
+import type { ContentFields } from '../types/content-builder.js';
+export interface RelationOwner {
+    pid: string | number;
+    sys_language_uid: string | number;
+}
+export interface RelationOutput {
+    columns: Record<string, string>;
+    records: RecordDataMap;
+}
+export declare function mergeRecords(into: RecordDataMap, from: RecordDataMap): void;
+export declare class ChildRecord {
+    private readonly fields;
+    private readonly relations;
+    constructor(table: string);
+    withField(column: string, value: ContentFields[string]): this;
+    withFileReference(column: string, fileUid: number, fields?: ContentFields): this;
+    withChild(column: string, table: string, configure: (child: ChildRecord) => void): this;
+    /** Relations inherit from the merged row, so a pid the child sets reaches them. */
+    materialise(owner: RelationOwner): {
+        row: Record<string, unknown>;
+        records: RecordDataMap;
+    };
+}
+export declare class RelationSet {
+    private readonly ownerTable;
+    private readonly isColumnSet;
+    private readonly references;
+    private readonly children;
+    private readonly claims;
+    constructor(ownerTable: string, isColumnSet?: (column: string) => boolean);
+    withFileReference(column: string, fileUid: number, fields?: ContentFields): this;
+    withFileReferences(column: string, fileUids: number[], fields?: ContentFields): this;
+    withChild(column: string, table: string, configure: (child: ChildRecord) => void): this;
+    withChildren<T>(column: string, table: string, items: T[], configure: (child: ChildRecord, item: T) => void): this;
+    refuseColumnHeld(column: string): void;
+    materialise(owner: RelationOwner): RelationOutput;
+    private claim;
+    private refuseWiredColumns;
+}
+//# sourceMappingURL=relations.d.ts.map

package/dist/builders/relations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.d.ts","sourceRoot":"","sources":["../../src/builders/relations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAGhE,MAAM,WAAW,aAAa;IAC1B,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;IACpB,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAAA;CACpC;AAED,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,OAAO,EAAE,aAAa,CAAA;CACzB;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAc3E;AAgBD,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;gBAE3B,KAAK,EAAE,MAAM;IAIzB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI;IAO7D,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB,GAAG,IAAI;IAMpF,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAMvF,mFAAmF;IACnF,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,OAAO,EAAE,aAAa,CAAA;KAAE;CAO9F;AAED,qBAAa,WAAW;IAMhB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW;IANhC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;gBAG9B,UAAU,EAAE,MAAM,EAClB,WAAW,GAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAqB;IAG3E,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB,GAAG,IAAI;IAQpF,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,GAAE,aAAkB,GAAG,IAAI;IAMxF,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IASvF,YAAY,CAAC,CAAC,EACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,KAAK,IAAI,GACjD,IAAI;IAMP,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAUtC,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc;IAiCjD,OAAO,CAAC,KAAK;IAqBb,OAAO,CAAC,kBAAkB;CAU7B"}

package/dist/builders/relations.js

@@ -0,0 +1,130 @@
+import { newRecordIdentifier } from './identifier.js';
+const WIRED_COLUMNS = ['uid_local', 'uid_foreign', 'tablenames', 'fieldname', 'sorting_foreign'];
+export function mergeRecords(into, from) {
+    for (const [table, rows] of Object.entries(from)) {
+        const existing = (into[table] ??= {});
+        for (const [identifier, row] of Object.entries(rows)) {
+            if (identifier in existing) {
+                throw new Error(`[typo3-playwright-toolkit] Two records claim the identifier ` +
+                    `"${identifier}" in ${table}. Each record needs its own, or one ` +
+                    'silently merges into the other.');
+            }
+            existing[identifier] = row;
+        }
+    }
+}
+export class ChildRecord {
+    fields = {};
+    relations;
+    constructor(table) {
+        this.relations = new RelationSet(table, (column) => column in this.fields);
+    }
+    withField(column, value) {
+        this.relations.refuseColumnHeld(column);
+        this.fields[column] = value;
+        return this;
+    }
+    withFileReference(column, fileUid, fields = {}) {
+        this.relations.withFileReference(column, fileUid, fields);
+        return this;
+    }
+    withChild(column, table, configure) {
+        this.relations.withChild(column, table, configure);
+        return this;
+    }
+    /** Relations inherit from the merged row, so a pid the child sets reaches them. */
+    materialise(owner) {
+        const row = { pid: owner.pid, sys_language_uid: owner.sys_language_uid, ...this.fields };
+        const { columns, records } = this.relations.materialise(row);
+        return { row: { ...row, ...columns }, records };
+    }
+}
+export class RelationSet {
+    ownerTable;
+    isColumnSet;
+    references = [];
+    children = [];
+    claims = new Map();
+    constructor(ownerTable, isColumnSet = () => false) {
+        this.ownerTable = ownerTable;
+        this.isColumnSet = isColumnSet;
+    }
+    withFileReference(column, fileUid, fields = {}) {
+        this.refuseWiredColumns(fields);
+        this.claim(column, 'sys_file_reference');
+        this.references.push({ column, identifier: newRecordIdentifier(), fileUid, fields });
+        return this;
+    }
+    withFileReferences(column, fileUids, fields = {}) {
+        fileUids.forEach((fileUid) => this.withFileReference(column, fileUid, fields));
+        return this;
+    }
+    withChild(column, table, configure) {
+        this.claim(column, table);
+        const child = new ChildRecord(table);
+        configure(child);
+        this.children.push({ column, table, identifier: newRecordIdentifier(), child });
+        return this;
+    }
+    withChildren(column, table, items, configure) {
+        items.forEach((item) => this.withChild(column, table, (child) => configure(child, item)));
+        return this;
+    }
+    refuseColumnHeld(column) {
+        if (this.claims.has(column)) {
+            throw new Error(`[typo3-playwright-toolkit] The column "${column}" already holds a relation, ` +
+                'so setting it with withField would decide what the test builds by ' +
+                'whichever call ran last.');
+        }
+    }
+    materialise(owner) {
+        const tokens = {};
+        const records = {};
+        this.references.forEach(({ column, identifier, fileUid, fields }) => {
+            const ordered = (tokens[column] ??= []);
+            ordered.push(identifier);
+            const rows = (records.sys_file_reference ??= {});
+            rows[identifier] = {
+                uid_local: fileUid,
+                pid: owner.pid,
+                tablenames: this.ownerTable,
+                fieldname: column,
+                sys_language_uid: owner.sys_language_uid,
+                sorting_foreign: ordered.length,
+                ...fields,
+            };
+        });
+        this.children.forEach(({ column, table, identifier, child }) => {
+            ;
+            (tokens[column] ??= []).push(identifier);
+            const { row, records: nested } = child.materialise(owner);
+            (records[table] ??= {})[identifier] = row;
+            mergeRecords(records, nested);
+        });
+        const columns = Object.fromEntries(Object.entries(tokens).map(([column, ordered]) => [column, ordered.join(',')]));
+        return { columns, records };
+    }
+    claim(column, table) {
+        if (this.isColumnSet(column)) {
+            throw new Error(`[typo3-playwright-toolkit] The column "${column}" is already set with ` +
+                'withField, so a relation on it would decide what the test builds by ' +
+                'whichever call ran last.');
+        }
+        const claimed = this.claims.get(column);
+        if (undefined !== claimed && claimed !== table) {
+            throw new Error(`[typo3-playwright-toolkit] The column "${column}" already holds ${claimed} ` +
+                `records and cannot also hold ${table} ones. A column resolves against a ` +
+                'single foreign_table, so the others would be written and never found.');
+        }
+        this.claims.set(column, table);
+    }
+    refuseWiredColumns(fields) {
+        const wired = Object.keys(fields).filter((column) => WIRED_COLUMNS.includes(column));
+        if (wired.length > 0) {
+            throw new Error(`[typo3-playwright-toolkit] ${wired.join(', ')} cannot be set on a relation — ` +
+                'the toolkit writes it, and a value of your own would point the row ' +
+                'somewhere the parent column does not.');
+        }
+    }
+}
+//# sourceMappingURL=relations.js.map

package/dist/builders/relations.js.map

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

package/dist/index.d.ts

@@ -7,7 +7,7 @@ export { PageBuilder } from './builders/page-builder.js';
 export { CoreContent, HeaderContent, TextContent, TextmediaContent, TextpicContent, ImageContent, BulletsContent, TableContent, UploadsContent, HtmlContent, DividerContent, ShortcutContent, MenuContent, type ContentTypeMap, type CoreContentTypeMap, } from './builders/core-content.js';
 export type { RecordDataMap, RecordToSave } from './http/record-edit.js';
 export { newRecordIdentifier } from './builders/identifier.js';
-export { flexForm } from './builders/fields.js';
+export { flexForm, imageCrop } from './builders/fields.js';
 export { expectScreenshot, waitForAnimations } from './checks/screenshot.js';
 export { runAccessibilityScan, scanAccessibility, DEFAULT_SCAN_TAGS, type AccessibilityScanOptions, } from './checks/accessibility.js';
 export { CspVerifier, type CspMode, type CspViolation } from './checks/csp.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,UAAU,GAClB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EACH,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,GAC9B,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,0BAA0B,EAAE,KAAK,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAEtG,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EACH,WAAW,EACX,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,WAAW,EACX,cAAc,EACd,eAAe,EACf,WAAW,EACX,KAAK,cAAc,EACnB,KAAK,kBAAkB,GAC1B,MAAM,4BAA4B,CAAA;AACnC,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAE/C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC5E,OAAO,EACH,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,wBAAwB,GAChC,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAC9D,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACjE,YAAY,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AACxF,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,UAAU,GAClB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EACH,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,GAC9B,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,0BAA0B,EAAE,KAAK,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAEtG,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EACH,WAAW,EACX,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,WAAW,EACX,cAAc,EACd,eAAe,EACf,WAAW,EACX,KAAK,cAAc,EACnB,KAAK,kBAAkB,GAC1B,MAAM,4BAA4B,CAAA;AACnC,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAE1D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC5E,OAAO,EACH,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,wBAAwB,GAChC,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,WAAW,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE9E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAC9D,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACjE,YAAY,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AACxF,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA"}

package/dist/index.js

@@ -6,7 +6,7 @@ export { ContentBuilder } from './builders/content-builder.js';
 export { PageBuilder } from './builders/page-builder.js';
 export { CoreContent, HeaderContent, TextContent, TextmediaContent, TextpicContent, ImageContent, BulletsContent, TableContent, UploadsContent, HtmlContent, DividerContent, ShortcutContent, MenuContent, } from './builders/core-content.js';
 export { newRecordIdentifier } from './builders/identifier.js';
-export { flexForm } from './builders/fields.js';
+export { flexForm, imageCrop } from './builders/fields.js';
 export { expectScreenshot, waitForAnimations } from './checks/screenshot.js';
 export { runAccessibilityScan, scanAccessibility, DEFAULT_SCAN_TAGS, } from './checks/accessibility.js';
 export { CspVerifier } from './checks/csp.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,GAIjB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EACH,mBAAmB,EACnB,gBAAgB,GAMnB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,0BAA0B,EAAgC,MAAM,6BAA6B,CAAA;AAEtG,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EACH,WAAW,EACX,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,WAAW,EACX,cAAc,EACd,eAAe,EACf,WAAW,GAGd,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAE/C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC5E,OAAO,EACH,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,GAEpB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,WAAW,EAAmC,MAAM,iBAAiB,CAAA;AAE9E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,GAIjB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EACH,mBAAmB,EACnB,gBAAgB,GAMnB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,0BAA0B,EAAgC,MAAM,6BAA6B,CAAA;AAEtG,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EACH,WAAW,EACX,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,WAAW,EACX,cAAc,EACd,eAAe,EACf,WAAW,GAGd,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAE1D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC5E,OAAO,EACH,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,GAEpB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,WAAW,EAAmC,MAAM,iBAAiB,CAAA;AAE9E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/types/content-builder.d.ts

@@ -1,5 +1,6 @@
 import { NestedFields } from './common.js';
 import type { RecordDataMap } from '../http/record-edit.js';
+import type { RelationOutput, RelationOwner } from '../builders/relations.js';
 export interface ContentFields {
     [key: string]: string | number | NestedFields | boolean | undefined;
 }
@@ -12,5 +13,7 @@ export interface ContentBuilderInterface {
      * substitutes the real uid once it has assigned one.
      */
     getAdditionalRecords?(contentIdentifier: string, pageId: string): RecordDataMap;
+    /** Beside the two above, never through them: an override would drop relations silently. */
+    getRelations?(owner: RelationOwner): RelationOutput;
 }
 //# sourceMappingURL=content-builder.d.ts.map

package/dist/types/content-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content-builder.d.ts","sourceRoot":"","sources":["../../src/types/content-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAE3D,MAAM,WAAW,aAAa;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,OAAO,GAAG,SAAS,CAAA;CACtE;AAED,MAAM,WAAW,uBAAuB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,SAAS,IAAI,aAAa,CAAA;IAC1B;;;;OAIG;IACH,oBAAoB,CAAC,CAAC,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAAA;CAClF"}
+{"version":3,"file":"content-builder.d.ts","sourceRoot":"","sources":["../../src/types/content-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAE7E,MAAM,WAAW,aAAa;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,OAAO,GAAG,SAAS,CAAA;CACtE;AAED,MAAM,WAAW,uBAAuB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,SAAS,IAAI,aAAa,CAAA;IAC1B;;;;OAIG;IACH,oBAAoB,CAAC,CAAC,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAAA;IAC/E,2FAA2F;IAC3F,YAAY,CAAC,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAAA;CACtD"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@plan2net/typo3-playwright-toolkit",
-    "version": "0.5.0",
+    "version": "0.6.0",
     "description": "Playwright toolkit for TYPO3 end-to-end tests: fixtures, content builders, per-test databases.",
     "keywords": [
         "typo3",