@plan2net/typo3-playwright-toolkit 0.1.0

package/README.md

@@ -0,0 +1,404 @@
+<p align="center">
+  <img src="../playwright-toolkit/Resources/Public/Icons/Extension.svg" alt="" width="96" height="96">
+</p>
+<h1 align="center">@plan2net/typo3-playwright-toolkit</h1>
+<p align="center"><em>Playwright fixtures and content builders for TYPO3, one test database per test file.</em></p>
+<br>
+
+[![npm](https://img.shields.io/npm/v/@plan2net/typo3-playwright-toolkit)](https://www.npmjs.com/package/@plan2net/typo3-playwright-toolkit)
+[![Node](https://img.shields.io/badge/Node-22.12%2B-5fa04e)](https://nodejs.org)
+[![Playwright](https://img.shields.io/badge/Playwright-1.56%2B-2ead33)](https://playwright.dev)
+[![licence](https://img.shields.io/badge/licence-GPL--2.0--or--later-blue)](LICENSE)
+
+An npm package. It provides the Playwright fixtures, the content builders that
+create TYPO3 records, and the accessibility and CSP checks.
+
+It needs the [Composer extension](https://github.com/plan2net/typo3-playwright-toolkit/tree/main/packages/playwright-toolkit), which creates the test
+databases, and the [DDEV add-on](https://github.com/plan2net/typo3-playwright-toolkit/tree/main/packages/ddev-typo3-playwright-toolkit), which provides
+the database service and the commands.
+
+[Requirements](#requirements) · [Install](#install) · [Configure](#configure) ·
+[Using the package](#using-the-package) · [Reference](#reference) ·
+[Troubleshooting](#troubleshooting) · [Related packages](#related-packages)
+
+## Requirements
+
+- Node 22.12 or newer
+- `@playwright/test` 1.56 or newer
+- The Composer extension, installed in the same project
+
+You do not need a database client. This package never talks to the database; it asks
+the extension to create and delete them. That is why PHP and Node may run in
+different containers.
+
+## Install
+
+```bash
+npm i -D @plan2net/typo3-playwright-toolkit @playwright/test
+```
+
+Add a `tsconfig.json` next to your tests that extends the one shipped here:
+
+```json
+{
+    "extends": "@plan2net/typo3-playwright-toolkit/tsconfig.base.json",
+    "include": ["**/*.ts"]
+}
+```
+
+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
+
+Call `defineToolkitConfig(...)` at the top of your `playwright.config.ts`, before any
+other file from this package is loaded. Two values are enough:
+
+```ts
+// <project>/tests/playwright/playwright.config.ts
+import { fileURLToPath } from 'url'
+import { defineToolkitConfig, defineBasePlaywrightConfig } from '@plan2net/typo3-playwright-toolkit/playwright'
+
+const toolkitConfig = defineToolkitConfig({
+    testingURL: 'https://example-testing.test',
+    paths: { consumerRoot: fileURLToPath(new URL('../..', import.meta.url)) },
+})
+
+export default defineBasePlaywrightConfig(toolkitConfig, {
+    testDir: './tests',
+})
+```
+
+`testingURL` is the host name that runs in the Testing context. It is the only URL
+this package uses, because the test database exists nowhere else.
+
+`consumerRoot` is the root of your TYPO3 project. The package derives the state and
+session folders from it, so it works from `node_modules` without knowing its own
+location. Count the `..` from where your config actually sits — the example assumes
+`<project>/tests/playwright/`, so it climbs two levels. Pointing it at the wrong
+directory is not an error: the run works and writes its state somewhere you did not
+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.
+
+## Using the package
+
+### Writing a test
+
+One test file is one scenario: a setup function that creates content through the real
+TYPO3 backend, and the tests that read it.
+
+```ts
+// tests/my-feature.spec.ts
+import { defineScenario, expect } from '@plan2net/typo3-playwright-toolkit'
+
+const test = defineScenario(async ({ builders }) => {
+    const { id, slug } = await builders
+        .page()
+        .withTitle('My Page')
+        .withSlug('/my-page')
+        .create()
+
+    await builders
+        .content()
+        .onPage(id)
+        .ofType('textmedia')
+        .configure((element) => element.withHeader('Hello').withBodyText('<p>Copy.</p>'))
+        .create()
+
+    return { slug }
+})
+
+test('renders the page title', async ({ page, state }) => {
+    await page.goto(state.slug)
+
+    await expect(page.locator('h1')).toHaveText('My Page')
+})
+```
+
+`state` is whatever your setup returned. The first test that needs it runs the
+setup, and the other tests wait. If the setup fails, the tests are skipped with the
+reason instead of failing because content is missing.
+
+The setup runs once per file, even when the file runs in several browser projects.
+The other projects use the state and the test database that the first one created.
+
+```mermaid
+flowchart TD
+    F["one test file"]
+    S["setup — runs once<br>builds content through the backend"]
+    D["state + its own test database"]
+    X["tests skip, with the reason"]
+    P1["chromium-desktop"]
+    P2["firefox"]
+    P3["webkit"]
+
+    F --> S
+    S -->|built| D
+    S -->|failed| X
+    D --> P1 & P2 & P3
+
+    classDef ok fill:#2ea04326,stroke:#2ea043b3
+    classDef bad fill:#f8514926,stroke:#f85149b3
+    class D ok
+    class X bad
+```
+
+Besides `builders`, the setup receives `testId` (the database this attempt runs
+against), `attempt` (`1` on the first try), `signal` (aborted when the attempt times
+out, so pass it to your own long requests), and a `page` and `request` that already
+carry the toolkit headers. Your tests get `testId` beside `state`, which is the
+database name without its `db` prefix and what the backend shows in brackets behind
+the site name:
+
+```ts
+test('reports which database it used', async ({ page, state, testId }) => {
+    await page.goto(state.slug)
+
+    console.log(`built in db${testId}`)
+})
+```
+
+### Your own content types
+
+Every CType of a normal TYPO3 installation already has a builder. For your own,
+extend `CoreContent` to get the shared setters, then register the class:
+
+```ts
+import { CoreContent } from '@plan2net/typo3-playwright-toolkit'
+
+export class ArticleContent extends CoreContent {
+    readonly type = 'article'
+
+    withTeaser(text: string): this {
+        return this.withField('tx_myext_teaser', text)
+    }
+}
+```
+
+```ts
+// playwright.config.ts
+contentTypes: { article: ArticleContent }
+```
+
+To get typed setters in `.configure()`, add the class to `ContentTypeMap`:
+
+```ts
+declare module '@plan2net/typo3-playwright-toolkit' {
+    interface ContentTypeMap {
+        article: ArticleContent
+    }
+}
+```
+
+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.
+
+### Calling the site directly
+
+The `request` client — the one `defineScenario` hands your setup, and the `request`
+fixture in your tests — carries the test ID for `testingURL`, so it reads and
+writes the same throwaway database the browser does. Requests to any other host
+get neither toolkit header.
+
+### Stubbing a third-party script
+
+A cookie banner or a tracking script can swallow the clicks your test makes.
+`prepareContext` runs on every context a test uses, after the toolkit's own
+routes are in place:
+
+```ts
+// playwright.config.ts
+prepareContext: async (context) => {
+    await context.route('**/vendor-widget.js', (route) => route.fulfill({ body: '' }))
+},
+```
+
+### Screenshots
+
+`takeScreenshot` waits for fonts, images and animations, hides the selectors from
+`hideBeforeScreenshot`, and then compares against the stored image.
+
+```ts
+import { takeScreenshot } from '@plan2net/typo3-playwright-toolkit'
+
+await takeScreenshot(page, 'my-page')                             // the whole page
+await takeScreenshot(page, 'accordion', { include: '.accordion' }) // one element
+```
+
+The name carries no file extension; Playwright adds `.png` and the platform suffix
+itself. The first run writes the missing image and fails, as Playwright always does.
+Every other option is passed on to `toHaveScreenshot`.
+
+`takeScreenshot` waits for animations itself. When you interact and then assert
+without a screenshot — an accessibility scan after opening an accordion, say — wait
+first:
+
+```ts
+import { waitForAnimations } from '@plan2net/typo3-playwright-toolkit'
+
+await page.locator('summary').first().click()
+await waitForAnimations(page, '.accordion')
+await runAccessibilityScan(page, { include: '.accordion' })
+```
+
+### Accessibility checks
+
+`runAccessibilityScan` checks the current page with axe and fails the test if it
+finds a problem.
+
+```ts
+import { runAccessibilityScan } from '@plan2net/typo3-playwright-toolkit'
+
+await runAccessibilityScan(page)                       // the whole page
+await runAccessibilityScan(page, { include: '.card' }) // one component
+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.
+
+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
+whole page do test the heading structure.
+
+To check every test without writing the call each time, turn it on in the config:
+
+```ts
+accessibility: { auto: true },
+```
+
+Every test that opened a page is then scanned after it finishes. A test that never
+navigated is skipped, because there is nothing to check, and a test that already
+failed is skipped too, so the first failure stays the one you read.
+
+`scanAccessibility(page, options)` returns the raw axe result instead of failing the
+test. It returns `null` when the current project does not run checks.
+
+### CSP violations
+
+`CspVerifier` collects policy violations from your own pages and fails the test if
+there were any.
+
+```ts
+import { CspVerifier } from '@plan2net/typo3-playwright-toolkit'
+
+const verifier = new CspVerifier(context)
+await verifier.install()          // before the first page is opened
+
+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.
+
+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
+report as a JSON file when the test fails.
+
+## Reference
+
+### Configuration options
+
+Required:
+
+| Name | Purpose |
+|---|---|
+| `paths.consumerRoot` | Absolute path to your TYPO3 project root |
+| `testingURL` | Bare origin that runs in the Testing context |
+
+Everything else:
+
+| Name | Default | Purpose |
+|---|---|---|
+| `accessibility.auto` | `false` | Scan after every test that opened a page, instead of calling `runAccessibilityScan` yourself |
+| `accessibility.disabledRules` | `[]` | axe rules turned off for the whole project |
+| `accessibility.projects` | all projects | Projects that run axe checks |
+| `accessibility.tags` | `DEFAULT_SCAN_TAGS` | Which axe rule sets to run |
+| `cleanup.failOnLeak` | true in CI | Fail the run if a test database could not be deleted |
+| `cleanup.orphanAgeMs` | 24 hours | How old a leftover database must be before cleanup deletes it |
+| `cleanup.preserveOnFailure` | `failed` | Which test databases to keep after a failure: `failed`, `all` or `none` |
+| `contentTypes` | `{}` | Your own content builders, one per CType |
+| `csp.expectedOrigin` | origin of `testingURL` | Whose violations count |
+| `csp.mode` | `any` | Which policy header a page must send: `any`, `report-only` or `enforced` |
+| `hideBeforeScreenshot` | `[]` | CSS selectors hidden before every screenshot |
+| `paths.sessionDir` | `<consumerRoot>/var/session` | TYPO3 session folder, cleaned after a run |
+| `paths.stateDir` | `<consumerRoot>/.test-state` | Folder for setup state |
+| `prepareContext` | none | Runs on every context a test uses, for your own routes and stubs |
+| `screenshot.maxDiffPixelRatio` | `0.005` | How many pixels may differ, as a share of the image |
+| `screenshot.threshold` | `0.2` | How different one pixel may be, from 0 to 1 |
+| `setup.attemptTimeoutMs` | `90000` | How long one setup attempt may take |
+| `setup.attempts` | `2` | Attempts per setup, so `2` means one retry |
+| `setup.lockStaleMs` | `15000` | Silence after which another worker may take over the setup |
+| `setup.pollMs` | `100` | Gap between polls while waiting for a scenario |
+| `setup.waitTimeoutMs` | `300000` | How long a test waits for its scenario in total, lock included |
+
+`defineBasePlaywrightConfig` sets Playwright's `baseURL` to `testingURL` and adds
+this package's setup and cleanup functions. Values in its second argument win, and
+`use` and `expect` are merged instead of replaced.
+
+### Content types
+
+Every CType of a normal TYPO3 installation has a builder, and you register nothing:
+`header`, `text`, `textmedia`, `textpic`, `image`, `bullets`, `table`, `uploads`,
+`html`, `div`, `shortcut`, and the eleven `menu_*` types.
+
+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`.
+
+### The inspect command
+
+The package installs `typo3-playwright-inspect`. Run it from your project root
+after a failed run to print a backend link for every test database that was kept,
+optionally filtered by a part of the test file name:
+
+```bash
+npx typo3-playwright-inspect            # every kept database
+npx typo3-playwright-inspect accordion  # only matching test files
+```
+
+It reads the API secret from `var/playwright/api-secret` or from
+`PLAYWRIGHT_TOOLKIT_SECRET`. On DDEV, `ddev playwright-inspect` wraps it. The links
+log in as the pre-seeded backend user and live 15 minutes.
+
+## Troubleshooting
+
+**"No test ID for this request".** The builder received a page that the toolkit
+fixtures did not create. Use the `builders` argument of `defineScenario`.
+
+**Settings seem to be ignored.** `defineToolkitConfig` ran too late. It must be the
+first thing in `playwright.config.ts`.
+
+**Cleanup refuses a path.** `stateDir` and `sessionDir` must be absolute and inside
+`consumerRoot`, because cleanup deletes files in both.
+
+**"Timed out after 300000ms waiting for the setup".** A setup that builds a lot of
+content can outgrow the defaults on a slow machine. Raise `setup.attemptTimeoutMs`
+for the setup itself and `setup.waitTimeoutMs` for the tests waiting on it — the
+second has to stay comfortably above the first, since it covers every attempt plus
+the time spent waiting for the lock.
+
+**Test databases stay after a failed run.** That is intended: the databases of the
+failed test files are kept for debugging, and the run prints a link for each one
+that opens it in the TYPO3 backend. Set `cleanup.preserveOnFailure` to `none` to
+turn this off.
+
+**You want to look at what a failing test built.** Open the link the run printed
+under "Kept for debugging". It logs you into that test's backend, and the frontend
+is reachable from there. The link is signed with the API secret and lives 15
+minutes.
+
+## Related packages
+
+- [`plan2net/playwright-toolkit`](https://github.com/plan2net/typo3-playwright-toolkit/tree/main/packages/playwright-toolkit) — Composer extension
+- [DDEV add-on](https://github.com/plan2net/typo3-playwright-toolkit/tree/main/packages/ddev-typo3-playwright-toolkit) — database service and commands

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

@@ -0,0 +1,30 @@
+import { Page } from '@playwright/test';
+import { ContentBuilderInterface } from '../types/content-builder.js';
+import type { ContentTypeFor, ContentTypeKey } from './core-content.js';
+import { type RequestContext } from './request-context.js';
+export declare class ContentBuilder {
+    private page;
+    private pageId;
+    private readonly requestContext?;
+    constructor(page: Page, requestContext?: Partial<RequestContext>);
+    onPage(pageId: string): this;
+    /**
+     * A key of ContentTypeMap hands `.configure()` that builder's own type, so
+     * the setters autocomplete; any other string falls back to the bare interface.
+     */
+    ofType<K extends ContentTypeKey>(type: K): TypedContentBuilder<ContentTypeFor<K>>;
+    ofType(type: string): TypedContentBuilder<ContentBuilderInterface>;
+}
+declare class TypedContentBuilder<B extends ContentBuilderInterface = ContentBuilderInterface> {
+    private page;
+    private pageId;
+    private requestContext?;
+    private builder;
+    constructor(page: Page, pageId: string, type: string, requestContext?: Partial<RequestContext> | undefined);
+    configure(fn: (builder: B) => void): this;
+    create(): Promise<{
+        id: string;
+    }>;
+}
+export {};
+//# sourceMappingURL=content-builder.d.ts.map

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

@@ -0,0 +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,EAAyB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAGjF,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;CAiC1C"}

package/dist/builders/content-builder.js

@@ -0,0 +1,67 @@
+import { createContent } from './content-factory.js';
+import { saveRecord } from '../http/record-edit.js';
+import { coerceFields } from './fields.js';
+import { resolveRequestContext } from './request-context.js';
+import { newRecordIdentifier } from './identifier.js';
+export class ContentBuilder {
+    page;
+    pageId = '';
+    requestContext;
+    constructor(page, requestContext) {
+        this.page = page;
+        this.requestContext = requestContext;
+    }
+    onPage(pageId) {
+        this.pageId = pageId;
+        return this;
+    }
+    ofType(type) {
+        if (!this.pageId) {
+            throw new Error(`[typo3-playwright-toolkit] Call .onPage(pageId) before .ofType('${type}') — ` +
+                'without a page the content element has nowhere to live.');
+        }
+        return new TypedContentBuilder(this.page, this.pageId, type, this.requestContext);
+    }
+}
+class TypedContentBuilder {
+    page;
+    pageId;
+    requestContext;
+    builder;
+    constructor(page, pageId, type, requestContext) {
+        this.page = page;
+        this.pageId = pageId;
+        this.requestContext = requestContext;
+        this.builder = createContent(type);
+    }
+    configure(fn) {
+        fn(this.builder);
+        return this;
+    }
+    async create() {
+        const context = resolveRequestContext(this.page, this.requestContext);
+        const identifier = newRecordIdentifier();
+        const fields = this.builder.getFields();
+        // 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 record = {
+            pid: this.pageId,
+            sys_language_uid: 0,
+            CType: fields.CType || this.builder.type,
+            colPos: fields.colPos ?? 0,
+            ...coerceFields(own),
+        };
+        const uid = await saveRecord(this.page.request, context, {
+            table: 'tt_content',
+            identifier: identifier,
+            target: Number(this.pageId),
+            data: {
+                tt_content: { [identifier]: record },
+                ...(this.builder.getAdditionalRecords?.(identifier, this.pageId) ?? {}),
+            },
+        });
+        return { id: String(uid) };
+    }
+}
+//# sourceMappingURL=content-builder.js.map

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

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

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

@@ -0,0 +1,10 @@
+import type { ContentBuilderInterface } from '../types/content-builder.js';
+import type { ContentTypeConstructor } from '../config.js';
+/**
+ * Core CTypes are always registered. A consumer key with the same name replaces
+ * the shipped builder. Each call replaces the whole set, so calling
+ * defineToolkitConfig twice gives the same result as calling it once.
+ */
+export declare function registerContentTypes(types: Record<string, ContentTypeConstructor>): void;
+export declare function createContent(type: string): ContentBuilderInterface;
+//# sourceMappingURL=content-factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"content-factory.d.ts","sourceRoot":"","sources":["../../src/builders/content-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAC1E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAK1D;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,GAAG,IAAI,CAKxF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,CAWnE"}

package/dist/builders/content-factory.js

@@ -0,0 +1,23 @@
+import { coreContentTypes } from './core-content.js';
+const registry = new Map();
+/**
+ * Core CTypes are always registered. A consumer key with the same name replaces
+ * the shipped builder. Each call replaces the whole set, so calling
+ * defineToolkitConfig twice gives the same result as calling it once.
+ */
+export function registerContentTypes(types) {
+    registry.clear();
+    for (const [type, constructor] of Object.entries({ ...coreContentTypes(), ...types })) {
+        registry.set(type, constructor);
+    }
+}
+export function createContent(type) {
+    const Constructor = registry.get(type) ?? coreContentTypes()[type];
+    if (!Constructor) {
+        throw new Error(`[typo3-playwright-toolkit] Content type "${type}" is not registered. ` +
+            `Core CTypes ship with the toolkit; add your own to contentTypes in ` +
+            `defineToolkitConfig(...). Registered: [${[...registry.keys()].sort().join(', ')}].`);
+    }
+    return new Constructor();
+}
+//# sourceMappingURL=content-factory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"content-factory.js","sourceRoot":"","sources":["../../src/builders/content-factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEpD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkC,CAAA;AAE1D;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAA6C;IAC9E,QAAQ,CAAC,KAAK,EAAE,CAAA;IAChB,KAAK,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,gBAAgB,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,EAAE,CAAC;QACpF,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;IACnC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACtC,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,gBAAgB,EAAE,CAAC,IAAI,CAAC,CAAA;IAClE,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACX,4CAA4C,IAAI,uBAAuB;YACnE,qEAAqE;YACrE,0CAA0C,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAC3F,CAAA;IACL,CAAC;IAED,OAAO,IAAI,WAAW,EAAE,CAAA;AAC5B,CAAC"}