@plan2net/typo3-playwright-toolkit 0.1.0

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

@@ -0,0 +1,127 @@
+import type { ContentBuilderInterface, ContentFields } from '../types/content-builder.js';
+import type { RecordDataMap } from '../http/record-edit.js';
+export declare abstract class CoreContent implements ContentBuilderInterface {
+    abstract readonly type: string;
+    protected fields: ContentFields;
+    withHeader(header: string): this;
+    withSubheader(subheader: string): this;
+    /** 0 is "hidden", 1–5 are h1–h5 in a stock fluid_styled_content install. */
+    withHeaderLayout(layout: number): this;
+    withHeaderLink(link: string): this;
+    withColPos(colPos: number): this;
+    setHidden(hidden?: boolean): this;
+    /** Any column the typed setters do not cover, including your own. */
+    withField(column: string, value: ContentFields[string]): this;
+    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;
+    withImageSize(width?: number, height?: number): this;
+}
+export declare class HeaderContent extends CoreContent {
+    readonly type = "header";
+}
+export declare class TextContent extends CoreContent {
+    readonly type = "text";
+    withBodyText(html: string): this;
+}
+export declare class TextmediaContent extends GalleryCoreContent {
+    readonly type = "textmedia";
+    protected readonly mediaColumn = "assets";
+    withBodyText(html: string): this;
+}
+export declare class TextpicContent extends GalleryCoreContent {
+    readonly type = "textpic";
+    protected readonly mediaColumn = "image";
+    withBodyText(html: string): this;
+}
+export declare class ImageContent extends GalleryCoreContent {
+    readonly type = "image";
+    protected readonly mediaColumn = "image";
+}
+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;
+}
+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;
+    private delimiter;
+}
+export declare class UploadsContent extends MediaCoreContent {
+    readonly type = "uploads";
+    protected readonly mediaColumn = "media";
+}
+export declare class HtmlContent extends CoreContent {
+    readonly type = "html";
+    withHtml(html: string): this;
+}
+export declare class DividerContent extends CoreContent {
+    readonly type = "div";
+}
+export declare class ShortcutContent extends CoreContent {
+    readonly type = "shortcut";
+    /** Each entry is `tt_content_<uid>`, or a bare uid for tt_content. */
+    withRecords(records: string[]): this;
+}
+export declare class MenuContent extends CoreContent {
+    readonly type: string;
+    constructor(type: string);
+    withPages(pageUids: number[]): this;
+    withSelectedCategories(categoryUids: number[]): this;
+}
+export declare const MENU_TYPES: readonly ["menu_pages", "menu_subpages", "menu_sitemap", "menu_sitemap_pages", "menu_section", "menu_section_pages", "menu_abstract", "menu_recently_updated", "menu_related_pages", "menu_categorized_pages", "menu_categorized_content"];
+export type MenuType = (typeof MENU_TYPES)[number];
+export interface CoreContentTypeMap extends Record<MenuType, MenuContent> {
+    header: HeaderContent;
+    text: TextContent;
+    textmedia: TextmediaContent;
+    textpic: TextpicContent;
+    image: ImageContent;
+    bullets: BulletsContent;
+    table: TableContent;
+    uploads: UploadsContent;
+    html: HtmlContent;
+    div: DividerContent;
+    shortcut: ShortcutContent;
+}
+/**
+ * Consumers add their own CTypes by merging into this interface, which is what
+ * keeps `configure` typed for them too:
+ *
+ * ```ts
+ * declare module '@plan2net/typo3-playwright-toolkit' {
+ *     interface ContentTypeMap { my_teaser: TeaserContent }
+ * }
+ * ```
+ *
+ * It starts empty so a key here can also replace a core one, the way
+ * `registerContentTypes` replaces the builder behind it.
+ */
+export interface ContentTypeMap {
+}
+export type ContentTypeKey = keyof ContentTypeMap | keyof CoreContentTypeMap;
+export type ContentTypeFor<K extends ContentTypeKey> = K extends keyof ContentTypeMap ? ContentTypeMap[K] : K extends keyof CoreContentTypeMap ? CoreContentTypeMap[K] : never;
+export declare function coreContentTypes(): Record<string, new () => ContentBuilderInterface>;
+export {};
+//# sourceMappingURL=core-content.d.ts.map

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

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

package/dist/builders/core-content.js

@@ -0,0 +1,223 @@
+import { newRecordIdentifier } from './identifier.js';
+export class CoreContent {
+    fields = {};
+    withHeader(header) {
+        return this.set('header', header);
+    }
+    withSubheader(subheader) {
+        return this.set('subheader', subheader);
+    }
+    /** 0 is "hidden", 1–5 are h1–h5 in a stock fluid_styled_content install. */
+    withHeaderLayout(layout) {
+        return this.set('header_layout', layout);
+    }
+    withHeaderLink(link) {
+        return this.set('header_link', link);
+    }
+    withColPos(colPos) {
+        return this.set('colPos', colPos);
+    }
+    setHidden(hidden = true) {
+        return this.set('hidden', hidden);
+    }
+    /** Any column the typed setters do not cover, including your own. */
+    withField(column, value) {
+        return this.set(column, value);
+    }
+    getFields() {
+        return { CType: this.type, ...this.fields };
+    }
+    set(column, value) {
+        this.fields[column] = value;
+        return this;
+    }
+}
+class MediaCoreContent extends CoreContent {
+    fileUids = [];
+    identifiers = [];
+    withFile(fileUid) {
+        this.fileUids.push(fileUid);
+        return this;
+    }
+    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;
+    }
+}
+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);
+    }
+    withImageSize(width, height) {
+        if (undefined !== width) {
+            this.set('imagewidth', width);
+        }
+        if (undefined !== height) {
+            this.set('imageheight', height);
+        }
+        return this;
+    }
+}
+export class HeaderContent extends CoreContent {
+    type = 'header';
+}
+export class TextContent extends CoreContent {
+    type = 'text';
+    withBodyText(html) {
+        return this.set('bodytext', html);
+    }
+}
+export class TextmediaContent extends GalleryCoreContent {
+    type = 'textmedia';
+    mediaColumn = 'assets';
+    withBodyText(html) {
+        return this.set('bodytext', html);
+    }
+}
+export class TextpicContent extends GalleryCoreContent {
+    type = 'textpic';
+    mediaColumn = 'image';
+    withBodyText(html) {
+        return this.set('bodytext', html);
+    }
+}
+export class ImageContent extends GalleryCoreContent {
+    type = 'image';
+    mediaColumn = 'image';
+}
+export class BulletsContent extends CoreContent {
+    type = 'bullets';
+    /** One bullet per line — the column is a plain newline-separated text field. */
+    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);
+    }
+}
+export class TableContent extends CoreContent {
+    type = 'table';
+    withRows(rows) {
+        const delimiter = String.fromCharCode(this.delimiter());
+        return this.set('bodytext', rows.map((row) => row.join(delimiter)).join('\n')).set('cols', rows[0]?.length ?? 0);
+    }
+    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);
+    }
+    delimiter() {
+        const configured = this.fields.table_delimiter;
+        return 'number' === typeof configured ? configured : 124;
+    }
+}
+export class UploadsContent extends MediaCoreContent {
+    type = 'uploads';
+    mediaColumn = 'media';
+}
+export class HtmlContent extends CoreContent {
+    type = 'html';
+    withHtml(html) {
+        return this.set('bodytext', html);
+    }
+}
+export class DividerContent extends CoreContent {
+    type = 'div';
+}
+export class ShortcutContent extends CoreContent {
+    type = 'shortcut';
+    /** Each entry is `tt_content_<uid>`, or a bare uid for tt_content. */
+    withRecords(records) {
+        return this.set('records', records.join(','));
+    }
+}
+export class MenuContent extends CoreContent {
+    type;
+    constructor(type) {
+        super();
+        this.type = type;
+    }
+    withPages(pageUids) {
+        return this.set('pages', pageUids.join(','));
+    }
+    withSelectedCategories(categoryUids) {
+        return this.set('selected_categories', categoryUids.join(','));
+    }
+}
+export const MENU_TYPES = [
+    'menu_pages',
+    'menu_subpages',
+    'menu_sitemap',
+    'menu_sitemap_pages',
+    'menu_section',
+    'menu_section_pages',
+    'menu_abstract',
+    'menu_recently_updated',
+    'menu_related_pages',
+    'menu_categorized_pages',
+    'menu_categorized_content',
+];
+export function coreContentTypes() {
+    const types = {
+        header: HeaderContent,
+        text: TextContent,
+        textmedia: TextmediaContent,
+        textpic: TextpicContent,
+        image: ImageContent,
+        bullets: BulletsContent,
+        table: TableContent,
+        uploads: UploadsContent,
+        html: HtmlContent,
+        div: DividerContent,
+        shortcut: ShortcutContent,
+    };
+    for (const menuType of MENU_TYPES) {
+        types[menuType] = class extends MenuContent {
+            constructor() {
+                super(menuType);
+            }
+        };
+    }
+    return types;
+}
+//# sourceMappingURL=core-content.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core-content.js","sourceRoot":"","sources":["../../src/builders/core-content.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAErD,MAAM,OAAgB,WAAW;IAGnB,MAAM,GAAkB,EAAE,CAAA;IAEpC,UAAU,CAAC,MAAc;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IACrC,CAAC;IAED,aAAa,CAAC,SAAiB;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;IAC3C,CAAC;IAED,4EAA4E;IAC5E,gBAAgB,CAAC,MAAc;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,CAAA;IAC5C,CAAC;IAED,cAAc,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,CAAA;IACxC,CAAC;IAED,UAAU,CAAC,MAAc;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IACrC,CAAC;IAED,SAAS,CAAC,MAAM,GAAG,IAAI;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IACrC,CAAC;IAED,qEAAqE;IACrE,SAAS,CAAC,MAAc,EAAE,KAA4B;QAClD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IAClC,CAAC;IAED,SAAS;QACL,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;IAC/C,CAAC;IAES,GAAG,CAAC,MAAc,EAAE,KAA4B;QACtD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,CAAA;QAE3B,OAAO,IAAI,CAAA;IACf,CAAC;CACJ;AAED,MAAe,gBAAiB,SAAQ,WAAW;IAIvC,QAAQ,GAAa,EAAE,CAAA;IACvB,WAAW,GAAa,EAAE,CAAA;IAElC,QAAQ,CAAC,OAAe;QACpB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAE3B,OAAO,IAAI,CAAA;IACf,CAAC;IAED,SAAS,CAAC,QAAkB;QACxB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAA;QAE/B,OAAO,IAAI,CAAA;IACf,CAAC;IAEQ,SAAS;QACd,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,EAAE,CAAA;QAChC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACpE,CAAC;QAED,OAAO,MAAM,CAAA;IACjB,CAAC;IAED,oBAAoB,CAAC,iBAAyB,EAAE,MAAc;QAC1D,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,CAAA;QACb,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAA;QAC/C,MAAM,UAAU,GAA4C,EAAE,CAAA;QAC9D,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;YACrC,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,GAAG;gBAC7B,SAAS,EAAE,OAAO;gBAClB,GAAG,EAAE,MAAM;gBACX,UAAU,EAAE,YAAY;gBACxB,SAAS,EAAE,IAAI,CAAC,WAAW;gBAC3B,gBAAgB,EAAE,CAAC;gBACnB,eAAe,EAAE,KAAK,GAAG,CAAC;aAC7B,CAAA;QACL,CAAC,CAAC,CAAA;QAEF,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,CAAA;IAC7C,CAAC;IAED,+DAA+D;IAC/D,4EAA4E;IACpE,oBAAoB;QACxB,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAA;QAChD,CAAC;QAED,OAAO,IAAI,CAAC,WAAW,CAAA;IAC3B,CAAC;CACJ;AAED,MAAe,kBAAmB,SAAQ,gBAAgB;IACtD,WAAW,CAAC,SAAiB;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;IAC3C,CAAC;IAED,6EAA6E;IAC7E,eAAe,CAAC,WAAmB;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAA;IAC/C,CAAC;IAED,aAAa,CAAC,KAAc,EAAE,MAAe;QACzC,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,CAAA;QACjC,CAAC;QACD,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;YACvB,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;QACnC,CAAC;QAED,OAAO,IAAI,CAAA;IACf,CAAC;CACJ;AAED,MAAM,OAAO,aAAc,SAAQ,WAAW;IACjC,IAAI,GAAG,QAAQ,CAAA;CAC3B;AAED,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC/B,IAAI,GAAG,MAAM,CAAA;IAEtB,YAAY,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;IACrC,CAAC;CACJ;AAED,MAAM,OAAO,gBAAiB,SAAQ,kBAAkB;IAC3C,IAAI,GAAG,WAAW,CAAA;IAER,WAAW,GAAG,QAAQ,CAAA;IAEzC,YAAY,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;IACrC,CAAC;CACJ;AAED,MAAM,OAAO,cAAe,SAAQ,kBAAkB;IACzC,IAAI,GAAG,SAAS,CAAA;IAEN,WAAW,GAAG,OAAO,CAAA;IAExC,YAAY,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;IACrC,CAAC;CACJ;AAED,MAAM,OAAO,YAAa,SAAQ,kBAAkB;IACvC,IAAI,GAAG,OAAO,CAAA;IAEJ,WAAW,GAAG,OAAO,CAAA;CAC3C;AAED,MAAM,OAAO,cAAe,SAAQ,WAAW;IAClC,IAAI,GAAG,SAAS,CAAA;IAEzB,gFAAgF;IAChF,SAAS,CAAC,KAAe;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IACjD,CAAC;IAED,sDAAsD;IACtD,eAAe,CAAC,WAAmB;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,WAAW,CAAC,CAAA;IAChD,CAAC;CACJ;AAED,MAAM,OAAO,YAAa,SAAQ,WAAW;IAChC,IAAI,GAAG,OAAO,CAAA;IAEvB,QAAQ,CAAC,IAAgB;QACrB,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;QAEvD,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAC9E,MAAM,EACN,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CACvB,CAAA;IACL,CAAC;IAED,WAAW,CAAC,OAAe;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,OAAO,CAAC,CAAA;IAC7C,CAAC;IAED,uEAAuE;IACvE,kBAAkB,CAAC,QAAgB;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CAAA;IACtD,CAAC;IAEO,SAAS;QACb,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAA;QAE9C,OAAO,QAAQ,KAAK,OAAO,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAA;IAC5D,CAAC;CACJ;AAED,MAAM,OAAO,cAAe,SAAQ,gBAAgB;IACvC,IAAI,GAAG,SAAS,CAAA;IAEN,WAAW,GAAG,OAAO,CAAA;CAC3C;AAED,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC/B,IAAI,GAAG,MAAM,CAAA;IAEtB,QAAQ,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;IACrC,CAAC;CACJ;AAED,MAAM,OAAO,cAAe,SAAQ,WAAW;IAClC,IAAI,GAAG,KAAK,CAAA;CACxB;AAED,MAAM,OAAO,eAAgB,SAAQ,WAAW;IACnC,IAAI,GAAG,UAAU,CAAA;IAE1B,sEAAsE;IACtE,WAAW,CAAC,OAAiB;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IACjD,CAAC;CACJ;AAED,MAAM,OAAO,WAAY,SAAQ,WAAW;IACnB;IAArB,YAAqB,IAAY;QAC7B,KAAK,EAAE,CAAA;QADU,SAAI,GAAJ,IAAI,CAAQ;IAEjC,CAAC;IAED,SAAS,CAAC,QAAkB;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAChD,CAAC;IAED,sBAAsB,CAAC,YAAsB;QACzC,OAAO,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAClE,CAAC;CACJ;AAED,MAAM,CAAC,MAAM,UAAU,GAAG;IACtB,YAAY;IACZ,eAAe;IACf,cAAc;IACd,oBAAoB;IACpB,cAAc;IACd,oBAAoB;IACpB,eAAe;IACf,uBAAuB;IACvB,oBAAoB;IACpB,wBAAwB;IACxB,0BAA0B;CACpB,CAAA;AA0CV,MAAM,UAAU,gBAAgB;IAC5B,MAAM,KAAK,GAAsD;QAC7D,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,gBAAgB;QAC3B,OAAO,EAAE,cAAc;QACvB,KAAK,EAAE,YAAY;QACnB,OAAO,EAAE,cAAc;QACvB,KAAK,EAAE,YAAY;QACnB,OAAO,EAAE,cAAc;QACvB,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,cAAc;QACnB,QAAQ,EAAE,eAAe;KAC5B,CAAA;IAED,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAChC,KAAK,CAAC,QAAQ,CAAC,GAAG,KAAM,SAAQ,WAAW;YACvC;gBACI,KAAK,CAAC,QAAQ,CAAC,CAAA;YACnB,CAAC;SACJ,CAAA;IACL,CAAC;IAED,OAAO,KAAK,CAAA;AAChB,CAAC"}

package/dist/builders/fields.d.ts

@@ -0,0 +1,7 @@
+/**
+ * TYPO3 columns take scalars: a boolean is a 0/1 int column and a crop config is
+ * a JSON *string* column, not a nested object. 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>;
+//# sourceMappingURL=fields.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../src/builders/fields.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAerF"}

package/dist/builders/fields.js

@@ -0,0 +1,20 @@
+/**
+ * TYPO3 columns take scalars: a boolean is a 0/1 int column and a crop config is
+ * a JSON *string* column, not a nested object. An undefined field is left out
+ * rather than sent as null, which DataHandler would write.
+ */
+export function coerceFields(fields) {
+    const coerced = {};
+    for (const [column, value] of Object.entries(fields)) {
+        if (value === undefined) {
+            continue;
+        }
+        if ('boolean' === typeof value) {
+            coerced[column] = value ? 1 : 0;
+            continue;
+        }
+        coerced[column] = 'object' === typeof value ? JSON.stringify(value) : value;
+    }
+    return coerced;
+}
+//# sourceMappingURL=fields.js.map

package/dist/builders/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../src/builders/fields.ts"],"names":[],"mappings":"AAAA;;;;GAIG;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,QAAQ,KAAK,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IAC/E,CAAC;IAED,OAAO,OAAO,CAAA;AAClB,CAAC"}

package/dist/builders/identifier.d.ts

@@ -0,0 +1,2 @@
+export declare function newRecordIdentifier(): string;
+//# sourceMappingURL=identifier.d.ts.map

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

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

package/dist/builders/identifier.js

@@ -0,0 +1,11 @@
+// Hex only, like StringUtility::getUniqueId(): RelationHandler reads a list
+// entry containing `_` as table_uid and never resolves it back to the record.
+function typo3StyleIdentifier() {
+    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

@@ -0,0 +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"}

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

@@ -0,0 +1,40 @@
+import { Page } from '@playwright/test';
+import { CropConfig } from '../types/common.js';
+import { type RequestContext } from './request-context.js';
+interface Fields {
+    [key: string]: string | number | boolean | undefined | CropConfig;
+}
+export declare class PageBuilder {
+    protected fields: Fields;
+    private page;
+    private imageFileId?;
+    private imageCropConfig?;
+    private mediaIdentifierValue?;
+    private readonly requestContext?;
+    constructor(page: Page, requestContext?: Partial<RequestContext>);
+    withTitle(title: string): this;
+    /** Any other TCA column — doktype, layout, backend_layout, shortcut_mode, … */
+    withField(column: string, value: string | number | boolean): this;
+    /** The test ID is appended so two runs never claim the same URL. */
+    withSlug(slug: string): this;
+    withExistingImage(fileId: number): this;
+    withImageCropFocus(cropConfig: CropConfig): this;
+    atParentId(id: number): this;
+    create(): Promise<{
+        id: string;
+        slug: string;
+    }>;
+    update(pageId: string): Promise<{
+        id: string;
+        slug: string;
+    }>;
+    /**
+     * A second record the page's own `media` field lists, which is what makes
+     * DataHandler link it once the page has a uid.
+     */
+    private mediaRecords;
+    private pageFields;
+    private mediaIdentifier;
+}
+export {};
+//# sourceMappingURL=page-builder.d.ts.map

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

@@ -0,0 +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,MAAM,oBAAoB,CAAA;AAE/C,OAAO,EAAwC,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAIhG,UAAU,MAAM;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAA;CACpE;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;IAU5B,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;IAiB/C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAgBnE;;;OAGG;IACH,OAAO,CAAC,YAAY;IAuBpB,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,eAAe;CAK1B"}

package/dist/builders/page-builder.js

@@ -0,0 +1,119 @@
+import { saveRecord } from '../http/record-edit.js';
+import { requireTestId, resolveRequestContext } from './request-context.js';
+import { coerceFields } from './fields.js';
+import { newRecordIdentifier } from './identifier.js';
+const DEFAULT_CROP = '{"default":{"cropArea":{"x":0,"y":0,"width":1,"height":1},"selectedRatio":"NaN","focusArea":null}}';
+export class PageBuilder {
+    fields = {
+        doktype: 1,
+        shortcut_mode: 0,
+        pid: 1,
+        hidden: false,
+        layout: 0,
+        subtitle: '',
+    };
+    page;
+    imageFileId;
+    imageCropConfig;
+    mediaIdentifierValue;
+    requestContext;
+    constructor(page, requestContext) {
+        this.page = page;
+        this.requestContext = requestContext;
+    }
+    withTitle(title) {
+        this.fields.title = title;
+        return this;
+    }
+    /** Any other TCA column — doktype, layout, backend_layout, shortcut_mode, … */
+    withField(column, value) {
+        this.fields[column] = value;
+        return this;
+    }
+    /** The test ID is appended so two runs never claim the same URL. */
+    withSlug(slug) {
+        const testId = requireTestId(this.page, this.requestContext?.testId);
+        let normalizedSlug = slug.startsWith('/') ? slug : `/${slug}`;
+        normalizedSlug = normalizedSlug.endsWith('/') ? normalizedSlug.slice(0, -1) : normalizedSlug;
+        this.fields.slug = `${normalizedSlug}-${testId.toLowerCase()}`;
+        return this;
+    }
+    withExistingImage(fileId) {
+        this.imageFileId = fileId;
+        return this;
+    }
+    withImageCropFocus(cropConfig) {
+        this.imageCropConfig = cropConfig;
+        return this;
+    }
+    atParentId(id) {
+        this.fields.pid = id;
+        return this;
+    }
+    async create() {
+        const context = resolveRequestContext(this.page, this.requestContext);
+        const identifier = newRecordIdentifier();
+        const uid = await saveRecord(this.page.request, context, {
+            table: 'pages',
+            identifier,
+            target: Number(this.fields.pid),
+            data: {
+                pages: { [identifier]: this.pageFields() },
+                ...this.mediaRecords(identifier),
+            },
+        });
+        return { id: String(uid), slug: this.fields.slug || '' };
+    }
+    async update(pageId) {
+        const context = resolveRequestContext(this.page, this.requestContext);
+        await saveRecord(this.page.request, context, {
+            table: 'pages',
+            identifier: pageId,
+            target: Number(pageId),
+            data: {
+                pages: { [pageId]: this.pageFields() },
+                ...this.mediaRecords(pageId),
+            },
+        });
+        return { id: pageId, slug: this.fields.slug || '' };
+    }
+    /**
+     * A second record the page's own `media` field lists, which is what makes
+     * DataHandler link it once the page has a uid.
+     */
+    mediaRecords(pageIdentifier) {
+        if (!this.imageFileId) {
+            return {};
+        }
+        return {
+            sys_file_reference: {
+                [this.mediaIdentifier()]: {
+                    uid_local: this.imageFileId,
+                    pid: pageIdentifier,
+                    tablenames: 'pages',
+                    fieldname: 'media',
+                    hidden: 0,
+                    sys_language_uid: 0,
+                    alternative: '',
+                    description: '',
+                    title: '',
+                    crop: this.imageCropConfig ? JSON.stringify(this.imageCropConfig) : DEFAULT_CROP,
+                },
+            },
+        };
+    }
+    pageFields() {
+        const fields = coerceFields(this.fields);
+        if (this.imageFileId) {
+            fields.media = this.mediaIdentifier();
+        }
+        return fields;
+    }
+    // Minted once: pageFields() lists it in `media` and mediaRecords() keys the
+    // reference by it, and the two must agree.
+    mediaIdentifier() {
+        this.mediaIdentifierValue ??= newRecordIdentifier();
+        return this.mediaIdentifierValue;
+    }
+}
+//# sourceMappingURL=page-builder.js.map

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

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

package/dist/builders/request-context.d.ts

@@ -0,0 +1,23 @@
+/** TYPO3's own default for `BE/entryPoint`, which 11.5 and 12.4 have no setting for. */
+export declare const DEFAULT_BACKEND_PATH = "/typo3";
+export interface RequestContext {
+    baseUrl: string;
+    /** Where the backend routes answer, from `BE/entryPoint`; the session endpoint reports it. */
+    backendPath: string;
+    testId: string;
+    /** For `record_edit`; the session endpoint hands it out. */
+    routeToken: string;
+}
+export interface RequestContextSource {
+    url(): string;
+    context(): unknown;
+}
+/**
+ * The fixtures put the test ID on the page and context; an explicit one overrides
+ * it. An empty ID is refused rather than sent, because the extension reads an
+ * empty header as "use the base database".
+ */
+export declare function ambientTestId(page: RequestContextSource): string | undefined;
+export declare function requireTestId(page: RequestContextSource, explicit?: string): string;
+export declare function resolveRequestContext(page: RequestContextSource, explicit?: Partial<RequestContext>): RequestContext;
+//# sourceMappingURL=request-context.d.ts.map

package/dist/builders/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../src/builders/request-context.ts"],"names":[],"mappings":"AAGA,wFAAwF;AACxF,eAAO,MAAM,oBAAoB,WAAW,CAAA;AAE5C,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,8FAA8F;IAC9F,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,oBAAoB;IACjC,GAAG,IAAI,MAAM,CAAA;IACb,OAAO,IAAI,OAAO,CAAA;CACrB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,GAAG,SAAS,CAM5E;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAWnF;AAED,wBAAgB,qBAAqB,CACjC,IAAI,EAAE,oBAAoB,EAC1B,QAAQ,GAAE,OAAO,CAAC,cAAc,CAAM,GACvC,cAAc,CAShB"}