@panneau/protocol 5.0.0-alpha.1 → 5.0.0-alpha.3

package/README.md

@@ -18,15 +18,16 @@ import { checkValues, evaluateCondition } from '@panneau/protocol/runtime';
 
 **In the browser,** import the helpers from `@panneau/protocol/runtime`, and only types from `@panneau/protocol`. The main entry point loads zod and builds every schema, which bundlers can't drop (about 360 KB of source). `@panneau/core`, `fields`, `forms` and `lists` follow this rule, and ESLint enforces it in them.
 
-| Export                                     | Content                                                                                                                                                                                                                                                                                                                |
-| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `@panneau/protocol`                        | Schemas (Zod) and types, `validateDefinition()`, `validateBootConfig()`, `lintDefinition()`, `checkValues()` (portable rules), `evaluateCondition()`, list query helpers, OpenAPI and JSON Schema generators                                                                                                           |
-| `@panneau/protocol/runtime`                | The constants and the helpers that run in the browser, without zod: `checkValues()`, `checkRules()`, `evaluateCondition()`, `lintDefinition()`, `getValue()`, `isFilled()`, `isProblem()`, `toSearchParams()`, `fromSearchParams()`, `isFilterRange()`, `matchesFilterRange()`. The main entry point also exports them |
-| `@panneau/protocol/mock`                   | `createMockBackend()`: an in-memory backend for tests and development                                                                                                                                                                                                                                                  |
-| `@panneau/protocol/conformance`            | `runConformance()`: checks a live backend against the protocol                                                                                                                                                                                                                                                         |
-| `@panneau/protocol/definition.schema.json` | JSON Schema of the definition                                                                                                                                                                                                                                                                                          |
-| `@panneau/protocol/openapi.json`           | OpenAPI 3.1 document of the API                                                                                                                                                                                                                                                                                        |
-| `@panneau/protocol/boot.schema.json`       | JSON Schema of the boot config, which a server writes in the page of the app                                                                                                                                                                                                                                           |
+| Export                                     | Content                                                                                                                                                                                                                                                                                                                                 |
+| ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `@panneau/protocol`                        | Schemas (Zod) and types, `validateDefinition()`, `validateBootConfig()`, `lintDefinition()`, `checkValues()` (portable rules), `evaluateCondition()`, list query helpers, OpenAPI and JSON Schema generators                                                                                                                            |
+| `@panneau/protocol/runtime`                | The constants and the helpers that run in the browser, without zod: `checkValues()`, `checkRules()`, `evaluateCondition()`, `lintDefinition()`, `getValue()`, `isFilled()`, `isProblem()`, `toSearchParams()`, `fromSearchParams()`, `isFilterRange()`, `matchesFilterRange()`, `mergeThemes()`. The main entry point also exports them |
+| `@panneau/protocol/mock`                   | `createMockBackend()`: an in-memory backend for tests and development                                                                                                                                                                                                                                                                   |
+| `@panneau/protocol/conformance`            | `runConformance()`: checks a live backend against the protocol                                                                                                                                                                                                                                                                          |
+| `@panneau/protocol/definition.schema.json` | JSON Schema of the definition                                                                                                                                                                                                                                                                                                           |
+| `@panneau/protocol/openapi.json`           | OpenAPI 3.1 document of the API                                                                                                                                                                                                                                                                                                         |
+| `@panneau/protocol/boot.schema.json`       | JSON Schema of the boot config, which a server writes in the page of the app                                                                                                                                                                                                                                                            |
+| `@panneau/protocol/theme.schema.json`      | JSON Schema of a theme of `@panneau/ui`, for themes written as JSON files                                                                                                                                                                                                                                                               |
 
 ## Changing the protocol
 

package/dist/conformance/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conformance/index.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,kBAAkB;IAC/B,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjE,wEAAwE;IACxE,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE;QACL,mCAAmC;QACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,kCAAkC;QAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,2FAA2F;QAC3F,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC;CACL;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,iBAAiB,CAAC;IAC1B,qDAAqD;IACrD,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAoED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAiU5F;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAU9D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conformance/index.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,kBAAkB;IAC/B,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjE,wEAAwE;IACxE,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE;QACL,mCAAmC;QACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,kCAAkC;QAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,2FAA2F;QAC3F,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC;CACL;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,iBAAiB,CAAC;IAC1B,qDAAqD;IACrD,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAoED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA2X5F;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAU9D"}

package/dist/conformance/index.js

@@ -2,7 +2,7 @@ import { PROBLEM_CONTENT_TYPE } from "../version.js";
 import { isFilled } from "../values.js";
 import { toSearchParams } from "../query.js";
 import { Definition } from "../schemas/definition.js";
-import { ItemResponse, ListResponse, Problem } from "../schemas/api.js";
+import { ActionResult, ItemResponse, ListResponse, Problem } from "../schemas/api.js";
 //#region src/conformance/index.ts
 var UNKNOWN = "__panneau_conformance_unknown__";
 function describeIssues(error) {
@@ -154,6 +154,39 @@ async function runConformance(options) {
 		const future = await list({ from: "9999-12-31" }, "The list filtered from 9999-12-31");
 		if (future !== null) check.expect(future.meta.total === 0, `Filtered from 9999-12-31, the list has ${future.meta.total} items, expected 0.`);
 	});
+	await run("action.dry-run", "A dry run of an action counts what it would do, and changes nothing", async (check) => {
+		const action = resource?.actions?.find((candidate) => candidate.dryRun === true && candidate.kind === "server" && candidate.scope.includes("selection"));
+		if (action === void 0) {
+			check.skip("The resource declares no selection action with dryRun.");
+			return;
+		}
+		const page = async (label) => {
+			const reply = await request(`${resourcePath()}?page=1&perPage=20`);
+			return check.expectStatus(reply, 200) ? check.expectSchema(ListResponse, reply.body, label) : null;
+		};
+		const before = await page("The list before the dry run");
+		const reply = await request(`${resourcePath()}/actions/${encodeURIComponent(action.id)}`, {
+			method: "POST",
+			body: JSON.stringify({
+				selection: { query: {} },
+				dryRun: true
+			})
+		});
+		if (!check.expectStatus(reply, 200)) return;
+		const result = check.expectSchema(ActionResult, reply.body, "The dry run result");
+		if (result !== null && before !== null) {
+			check.expect(result.summary !== void 0, "A dry run result must have a summary of the items that would succeed and be skipped.");
+			if (result.summary !== void 0) {
+				const counted = result.summary.succeeded + result.summary.failed + result.summary.skipped;
+				check.expect(counted === before.meta.total, `The dry run counts ${counted} items; the list has ${before.meta.total}.`);
+			}
+		}
+		const after = await page("The list after the dry run");
+		if (before !== null && after !== null) {
+			const versions = (list) => JSON.stringify(list.data.map((item) => [item.id, item.version ?? null]));
+			check.expect(after.meta.total === before.meta.total && versions(after) === versions(before), "A dry run must not change the items.");
+		}
+	});
 	await run("list.unknown-resource", "An unknown resource is a 404 problem", async (check) => {
 		check.expectProblem(await request(`/resources/${UNKNOWN}`), 404);
 	});

package/dist/conformance/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/conformance/index.ts"],"sourcesContent":["import type { z } from 'zod';\n\nimport { type FilterRange, toSearchParams } from '../query';\nimport { Definition, type Resource } from '../schemas';\nimport { ItemResponse, ListResponse, Problem } from '../schemas/api';\nimport { isFilled } from '../values';\nimport { PROBLEM_CONTENT_TYPE } from '../version';\n\nexport interface ConformanceOptions {\n    /** Base URL of the API, the same as `api.baseUrl` of the definition, but absolute. */\n    baseUrl: string;\n    /** The `fetch` to use. Defaults to the global one. */\n    fetch?: (input: string, init?: RequestInit) => Promise<Response>;\n    /** Merged into every request, for authentication headers or cookies. */\n    init?: RequestInit;\n    /** Resource to test. Defaults to the first resource of the definition. */\n    resource?: string;\n    /**\n     * Enables the checks that write data, on the tested resource. Use a test database: these\n     * checks create, update and delete an item.\n     */\n    writes?: {\n        /** Valid values for a new item. */\n        create: Record<string, unknown>;\n        /** Valid values for an update. */\n        update: Record<string, unknown>;\n        /** Values that must be refused with a `422`. Defaults to `{}` when a field is required. */\n        invalid?: Record<string, unknown>;\n    };\n}\n\nexport type ConformanceStatus = 'passed' | 'failed' | 'skipped';\n\nexport interface ConformanceCheck {\n    id: string;\n    title: string;\n    status: ConformanceStatus;\n    /** What went wrong, or why the check was skipped. */\n    issues: string[];\n}\n\nexport interface ConformanceReport {\n    passed: boolean;\n    checks: ConformanceCheck[];\n}\n\ninterface Reply {\n    status: number;\n    contentType: string;\n    etag: string | null;\n    body: unknown;\n}\n\nconst UNKNOWN = '__panneau_conformance_unknown__';\n\nfunction describeIssues(error: z.ZodError): string[] {\n    return error.issues.slice(0, 10).map((issue) => {\n        const path = issue.path.map(String).join('.');\n        return path === '' ? issue.message : `${path}: ${issue.message}`;\n    });\n}\n\nfunction normalizeEtag(value: string): string {\n    return value.replace(/^W\\//, '');\n}\n\nclass Check {\n    issues: string[] = [];\n    skippedBecause: string | null = null;\n\n    expect(condition: boolean, issue: string): boolean {\n        if (!condition) {\n            this.issues.push(issue);\n        }\n        return condition;\n    }\n\n    expectStatus(reply: Reply, status: number): boolean {\n        return this.expect(\n            reply.status === status,\n            `Expected status ${status}, got ${reply.status}.`,\n        );\n    }\n\n    expectSchema<T extends z.ZodType>(schema: T, value: unknown, label: string): z.infer<T> | null {\n        const result = schema.safeParse(value);\n        if (result.success) {\n            return result.data;\n        }\n        this.issues.push(\n            `${label} does not match the schema:`,\n            ...describeIssues(result.error).map((issue) => `  ${issue}`),\n        );\n        return null;\n    }\n\n    expectProblem(reply: Reply, status: number): Problem | null {\n        if (!this.expectStatus(reply, status)) {\n            return null;\n        }\n        this.expect(\n            reply.contentType.startsWith(PROBLEM_CONTENT_TYPE),\n            `Expected content type ${PROBLEM_CONTENT_TYPE}, got \"${reply.contentType}\".`,\n        );\n        return this.expectSchema(Problem, reply.body, 'The error');\n    }\n\n    skip(reason: string) {\n        this.skippedBecause = reason;\n    }\n}\n\n/**\n * Runs the protocol's conformance checks against a live backend. Read-only checks always run;\n * checks that write data run only with `writes`.\n */\nexport async function runConformance(options: ConformanceOptions): Promise<ConformanceReport> {\n    const fetcher = options.fetch ?? ((input: string, init?: RequestInit) => fetch(input, init));\n    const baseUrl = options.baseUrl.replace(/\\/$/, '');\n    const checks: ConformanceCheck[] = [];\n\n    const request = async (path: string, init: RequestInit = {}): Promise<Reply> => {\n        const headers = new Headers(options.init?.headers);\n        headers.set('Accept', 'application/json');\n        new Headers(init.headers).forEach((value, key) => headers.set(key, value));\n        if (init.body !== undefined) {\n            headers.set('Content-Type', 'application/json');\n        }\n        const response = await fetcher(`${baseUrl}${path}`, { ...options.init, ...init, headers });\n        const text = await response.text();\n        const parse = (): unknown => {\n            if (text === '') {\n                return null;\n            }\n            try {\n                return JSON.parse(text);\n            } catch {\n                return text;\n            }\n        };\n        const body = parse();\n        return {\n            status: response.status,\n            contentType: response.headers.get('Content-Type') ?? '',\n            etag: response.headers.get('ETag'),\n            body,\n        };\n    };\n\n    const run = async (id: string, title: string, body: (check: Check) => Promise<void>) => {\n        const check = new Check();\n        try {\n            await body(check);\n        } catch (error) {\n            check.issues.push(\n                `Request failed: ${error instanceof Error ? error.message : String(error)}`,\n            );\n        }\n        const status: ConformanceStatus =\n            check.issues.length > 0\n                ? 'failed'\n                : check.skippedBecause !== null\n                  ? 'skipped'\n                  : 'passed';\n        checks.push({\n            id,\n            title,\n            status,\n            issues:\n                status === 'skipped' && check.skippedBecause !== null\n                    ? [check.skippedBecause]\n                    : check.issues,\n        });\n    };\n\n    let definition: Definition | null = null;\n    let resource: Resource | null = null;\n    let firstItemId: string | null = null;\n\n    await run('definition', 'GET /definition returns a valid definition', async (check) => {\n        const reply = await request('/definition');\n        if (check.expectStatus(reply, 200)) {\n            definition = check.expectSchema(Definition, reply.body, 'The definition');\n        }\n    });\n\n    await run('definition.resource', 'The definition has the resource to test', async (check) => {\n        const current = definition as Definition | null;\n        if (current === null) {\n            check.skip('No valid definition.');\n            return;\n        }\n        resource =\n            (options.resource !== undefined\n                ? current.resources.find((candidate) => candidate.id === options.resource)\n                : current.resources[0]) ?? null;\n        check.expect(\n            resource !== null,\n            options.resource !== undefined\n                ? `The definition has no resource \"${options.resource}\".`\n                : 'The definition has no resources.',\n        );\n    });\n\n    const resourcePath = () =>\n        `/resources/${encodeURIComponent((resource as Resource | null)?.id ?? '')}`;\n\n    await run('list', 'GET /resources/{resource} returns a page of items', async (check) => {\n        if (resource === null) {\n            check.skip('No resource to test.');\n            return;\n        }\n        const reply = await request(`${resourcePath()}?page=1&perPage=2`);\n        if (!check.expectStatus(reply, 200)) {\n            return;\n        }\n        const list = check.expectSchema(ListResponse, reply.body, 'The list');\n        if (list === null) {\n            return;\n        }\n        check.expect(list.data.length <= 2, `perPage=2 returned ${list.data.length} items.`);\n        check.expect(list.meta.page === 1, `meta.page is ${list.meta.page}, expected 1.`);\n        check.expect(list.meta.perPage === 2, `meta.perPage is ${list.meta.perPage}, expected 2.`);\n        firstItemId = list.data[0]?.id ?? null;\n    });\n\n    await run('list.sort', 'GET /resources/{resource} accepts a sort', async (check) => {\n        const sort = (resource as Resource | null)?.list?.sorts?.[0];\n        if (sort === undefined) {\n            check.skip('The resource declares no sorts.');\n            return;\n        }\n        const reply = await request(`${resourcePath()}?sort=${encodeURIComponent(`-${sort}`)}`);\n        if (check.expectStatus(reply, 200)) {\n            check.expectSchema(ListResponse, reply.body, 'The sorted list');\n        }\n    });\n\n    await run(\n        'list.filter-range',\n        'GET /resources/{resource} reads the bounds of a range filter',\n        async (check) => {\n            const filter = (resource as Resource | null)?.list?.filters?.find(\n                (candidate) => candidate.type === 'date-range',\n            );\n            if (filter === undefined) {\n                check.skip('The resource declares no date-range filter.');\n                return;\n            }\n            const list = async (range: FilterRange | null, label: string) => {\n                const query =\n                    range !== null ? `?${toSearchParams({ filter: { [filter.id]: range } })}` : '';\n                const reply = await request(`${resourcePath()}${query}`);\n                if (!check.expectStatus(reply, 200)) {\n                    return null;\n                }\n                return check.expectSchema(ListResponse, reply.body, label);\n            };\n            const all = await list(null, 'The list');\n            if (all === null) {\n                return;\n            }\n            // Items of the first page with a value: a range that covers every day includes them.\n            const dated = all.data.filter((item) => isFilled(item[filter.id])).length;\n            const ranges: [FilterRange, string][] = [\n                [{ from: '0001-01-01', to: '9999-12-31' }, 'from 0001-01-01 to 9999-12-31'],\n                [{ to: '9999-12-31' }, 'up to 9999-12-31 (an open start)'],\n            ];\n            for (const [range, label] of ranges) {\n                const reply = await list(range, `The list filtered ${label}`);\n                if (reply !== null) {\n                    check.expect(\n                        reply.meta.total >= dated,\n                        `Filtered ${label}, the list has ${reply.meta.total} items; the first page alone has ${dated} with a ${filter.id}.`,\n                    );\n                }\n            }\n            const future = await list({ from: '9999-12-31' }, 'The list filtered from 9999-12-31');\n            if (future !== null) {\n                check.expect(\n                    future.meta.total === 0,\n                    `Filtered from 9999-12-31, the list has ${future.meta.total} items, expected 0.`,\n                );\n            }\n        },\n    );\n\n    await run('list.unknown-resource', 'An unknown resource is a 404 problem', async (check) => {\n        check.expectProblem(await request(`/resources/${UNKNOWN}`), 404);\n    });\n\n    await run(\n        'item',\n        'GET /resources/{resource}/{id} returns the item with its ETag',\n        async (check) => {\n            if (firstItemId === null) {\n                check.skip('The list has no items.');\n                return;\n            }\n            const reply = await request(`${resourcePath()}/${encodeURIComponent(firstItemId)}`);\n            if (!check.expectStatus(reply, 200)) {\n                return;\n            }\n            const item = check.expectSchema(ItemResponse, reply.body, 'The item');\n            if (item === null) {\n                return;\n            }\n            check.expect(\n                item.data.id === firstItemId,\n                `Asked for item \"${firstItemId}\", got \"${item.data.id}\".`,\n            );\n            if (item.data.version !== null) {\n                check.expect(\n                    reply.etag !== null && normalizeEtag(reply.etag) === `\"${item.data.version}\"`,\n                    `Expected ETag \"${item.data.version}\" (quoted), got ${reply.etag ?? 'none'}.`,\n                );\n            }\n        },\n    );\n\n    await run('item.missing', 'A missing item is a 404 problem', async (check) => {\n        if (resource === null) {\n            check.skip('No resource to test.');\n            return;\n        }\n        check.expectProblem(await request(`${resourcePath()}/${UNKNOWN}`), 404);\n    });\n\n    const writes = options.writes;\n    let createdId: string | null = null;\n    let createdVersion: string | null = null;\n\n    await run('create.invalid', 'Invalid values are refused with a 422 problem', async (check) => {\n        if (writes === undefined || resource === null) {\n            check.skip('Write checks are disabled.');\n            return;\n        }\n        const hasRequired = resource.fields.some((field) =>\n            (field.rules ?? []).some((rule) => rule.rule === 'required'),\n        );\n        if (writes.invalid === undefined && !hasRequired) {\n            check.skip('No invalid values given, and the resource has no required field.');\n            return;\n        }\n        const reply = await request(resourcePath(), {\n            method: 'POST',\n            body: JSON.stringify(writes.invalid ?? {}),\n        });\n        const failure = check.expectProblem(reply, 422);\n        if (failure !== null) {\n            check.expect(\n                failure.errors !== undefined && Object.keys(failure.errors).length > 0,\n                'A 422 problem must list the invalid values in `errors`.',\n            );\n        }\n    });\n\n    await run('create', 'POST /resources/{resource} creates an item', async (check) => {\n        if (writes === undefined || resource === null) {\n            check.skip('Write checks are disabled.');\n            return;\n        }\n        const reply = await request(resourcePath(), {\n            method: 'POST',\n            body: JSON.stringify(writes.create),\n        });\n        if (!check.expectStatus(reply, 201)) {\n            return;\n        }\n        const item = check.expectSchema(ItemResponse, reply.body, 'The created item');\n        createdId = item?.data.id ?? null;\n        createdVersion = item?.data.version ?? null;\n    });\n\n    const itemPath = () => `${resourcePath()}/${encodeURIComponent(createdId ?? '')}`;\n\n    await run('update', 'PATCH /resources/{resource}/{id} updates the item', async (check) => {\n        if (createdId === null || writes === undefined) {\n            check.skip('No item was created.');\n            return;\n        }\n        const reply = await request(itemPath(), {\n            method: 'PATCH',\n            body: JSON.stringify(writes.update),\n            headers: createdVersion !== null ? { 'If-Match': `\"${createdVersion}\"` } : {},\n        });\n        if (!check.expectStatus(reply, 200)) {\n            return;\n        }\n        const item = check.expectSchema(ItemResponse, reply.body, 'The updated item');\n        if (item !== null && createdVersion !== null) {\n            check.expect(\n                item.data.version !== createdVersion,\n                'The version did not change after an update.',\n            );\n        }\n    });\n\n    await run(\n        'update.conflict',\n        'A stale If-Match is a 412 problem with the current item',\n        async (check) => {\n            if (createdId === null || writes === undefined) {\n                check.skip('No item was created.');\n                return;\n            }\n            if (createdVersion === null) {\n                check.skip('The backend has no versions.');\n                return;\n            }\n            const reply = await request(itemPath(), {\n                method: 'PATCH',\n                body: JSON.stringify(writes.update),\n                headers: { 'If-Match': '\"__panneau_conformance_stale__\"' },\n            });\n            const failure = check.expectProblem(reply, 412);\n            if (failure !== null) {\n                check.expect(\n                    failure.current !== undefined,\n                    'A 412 problem must include the current item.',\n                );\n            }\n        },\n    );\n\n    await run('delete', 'DELETE /resources/{resource}/{id} deletes the item', async (check) => {\n        if (createdId === null) {\n            check.skip('No item was created.');\n            return;\n        }\n        if (!check.expectStatus(await request(itemPath(), { method: 'DELETE' }), 204)) {\n            return;\n        }\n        check.expectProblem(await request(itemPath()), 404);\n    });\n\n    return { passed: checks.every((check) => check.status !== 'failed'), checks };\n}\n\n/** Formats a report as text, one line per check. */\nexport function formatReport(report: ConformanceReport): string {\n    const symbols: Record<ConformanceStatus, string> = { passed: '✓', failed: '✗', skipped: '-' };\n    return report.checks\n        .map((check) =>\n            [\n                `${symbols[check.status]} ${check.title}`,\n                ...check.issues.map((issue) => `    ${issue}`),\n            ].join('\\n'),\n        )\n        .join('\\n');\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/conformance/index.ts"],"sourcesContent":["import type { z } from 'zod';\n\nimport { type FilterRange, toSearchParams } from '../query';\nimport { Definition, type Resource } from '../schemas';\nimport { ActionResult, ItemResponse, ListResponse, Problem } from '../schemas/api';\nimport { isFilled } from '../values';\nimport { PROBLEM_CONTENT_TYPE } from '../version';\n\nexport interface ConformanceOptions {\n    /** Base URL of the API, the same as `api.baseUrl` of the definition, but absolute. */\n    baseUrl: string;\n    /** The `fetch` to use. Defaults to the global one. */\n    fetch?: (input: string, init?: RequestInit) => Promise<Response>;\n    /** Merged into every request, for authentication headers or cookies. */\n    init?: RequestInit;\n    /** Resource to test. Defaults to the first resource of the definition. */\n    resource?: string;\n    /**\n     * Enables the checks that write data, on the tested resource. Use a test database: these\n     * checks create, update and delete an item.\n     */\n    writes?: {\n        /** Valid values for a new item. */\n        create: Record<string, unknown>;\n        /** Valid values for an update. */\n        update: Record<string, unknown>;\n        /** Values that must be refused with a `422`. Defaults to `{}` when a field is required. */\n        invalid?: Record<string, unknown>;\n    };\n}\n\nexport type ConformanceStatus = 'passed' | 'failed' | 'skipped';\n\nexport interface ConformanceCheck {\n    id: string;\n    title: string;\n    status: ConformanceStatus;\n    /** What went wrong, or why the check was skipped. */\n    issues: string[];\n}\n\nexport interface ConformanceReport {\n    passed: boolean;\n    checks: ConformanceCheck[];\n}\n\ninterface Reply {\n    status: number;\n    contentType: string;\n    etag: string | null;\n    body: unknown;\n}\n\nconst UNKNOWN = '__panneau_conformance_unknown__';\n\nfunction describeIssues(error: z.ZodError): string[] {\n    return error.issues.slice(0, 10).map((issue) => {\n        const path = issue.path.map(String).join('.');\n        return path === '' ? issue.message : `${path}: ${issue.message}`;\n    });\n}\n\nfunction normalizeEtag(value: string): string {\n    return value.replace(/^W\\//, '');\n}\n\nclass Check {\n    issues: string[] = [];\n    skippedBecause: string | null = null;\n\n    expect(condition: boolean, issue: string): boolean {\n        if (!condition) {\n            this.issues.push(issue);\n        }\n        return condition;\n    }\n\n    expectStatus(reply: Reply, status: number): boolean {\n        return this.expect(\n            reply.status === status,\n            `Expected status ${status}, got ${reply.status}.`,\n        );\n    }\n\n    expectSchema<T extends z.ZodType>(schema: T, value: unknown, label: string): z.infer<T> | null {\n        const result = schema.safeParse(value);\n        if (result.success) {\n            return result.data;\n        }\n        this.issues.push(\n            `${label} does not match the schema:`,\n            ...describeIssues(result.error).map((issue) => `  ${issue}`),\n        );\n        return null;\n    }\n\n    expectProblem(reply: Reply, status: number): Problem | null {\n        if (!this.expectStatus(reply, status)) {\n            return null;\n        }\n        this.expect(\n            reply.contentType.startsWith(PROBLEM_CONTENT_TYPE),\n            `Expected content type ${PROBLEM_CONTENT_TYPE}, got \"${reply.contentType}\".`,\n        );\n        return this.expectSchema(Problem, reply.body, 'The error');\n    }\n\n    skip(reason: string) {\n        this.skippedBecause = reason;\n    }\n}\n\n/**\n * Runs the protocol's conformance checks against a live backend. Read-only checks always run;\n * checks that write data run only with `writes`.\n */\nexport async function runConformance(options: ConformanceOptions): Promise<ConformanceReport> {\n    const fetcher = options.fetch ?? ((input: string, init?: RequestInit) => fetch(input, init));\n    const baseUrl = options.baseUrl.replace(/\\/$/, '');\n    const checks: ConformanceCheck[] = [];\n\n    const request = async (path: string, init: RequestInit = {}): Promise<Reply> => {\n        const headers = new Headers(options.init?.headers);\n        headers.set('Accept', 'application/json');\n        new Headers(init.headers).forEach((value, key) => headers.set(key, value));\n        if (init.body !== undefined) {\n            headers.set('Content-Type', 'application/json');\n        }\n        const response = await fetcher(`${baseUrl}${path}`, { ...options.init, ...init, headers });\n        const text = await response.text();\n        const parse = (): unknown => {\n            if (text === '') {\n                return null;\n            }\n            try {\n                return JSON.parse(text);\n            } catch {\n                return text;\n            }\n        };\n        const body = parse();\n        return {\n            status: response.status,\n            contentType: response.headers.get('Content-Type') ?? '',\n            etag: response.headers.get('ETag'),\n            body,\n        };\n    };\n\n    const run = async (id: string, title: string, body: (check: Check) => Promise<void>) => {\n        const check = new Check();\n        try {\n            await body(check);\n        } catch (error) {\n            check.issues.push(\n                `Request failed: ${error instanceof Error ? error.message : String(error)}`,\n            );\n        }\n        const status: ConformanceStatus =\n            check.issues.length > 0\n                ? 'failed'\n                : check.skippedBecause !== null\n                  ? 'skipped'\n                  : 'passed';\n        checks.push({\n            id,\n            title,\n            status,\n            issues:\n                status === 'skipped' && check.skippedBecause !== null\n                    ? [check.skippedBecause]\n                    : check.issues,\n        });\n    };\n\n    let definition: Definition | null = null;\n    let resource: Resource | null = null;\n    let firstItemId: string | null = null;\n\n    await run('definition', 'GET /definition returns a valid definition', async (check) => {\n        const reply = await request('/definition');\n        if (check.expectStatus(reply, 200)) {\n            definition = check.expectSchema(Definition, reply.body, 'The definition');\n        }\n    });\n\n    await run('definition.resource', 'The definition has the resource to test', async (check) => {\n        const current = definition as Definition | null;\n        if (current === null) {\n            check.skip('No valid definition.');\n            return;\n        }\n        resource =\n            (options.resource !== undefined\n                ? current.resources.find((candidate) => candidate.id === options.resource)\n                : current.resources[0]) ?? null;\n        check.expect(\n            resource !== null,\n            options.resource !== undefined\n                ? `The definition has no resource \"${options.resource}\".`\n                : 'The definition has no resources.',\n        );\n    });\n\n    const resourcePath = () =>\n        `/resources/${encodeURIComponent((resource as Resource | null)?.id ?? '')}`;\n\n    await run('list', 'GET /resources/{resource} returns a page of items', async (check) => {\n        if (resource === null) {\n            check.skip('No resource to test.');\n            return;\n        }\n        const reply = await request(`${resourcePath()}?page=1&perPage=2`);\n        if (!check.expectStatus(reply, 200)) {\n            return;\n        }\n        const list = check.expectSchema(ListResponse, reply.body, 'The list');\n        if (list === null) {\n            return;\n        }\n        check.expect(list.data.length <= 2, `perPage=2 returned ${list.data.length} items.`);\n        check.expect(list.meta.page === 1, `meta.page is ${list.meta.page}, expected 1.`);\n        check.expect(list.meta.perPage === 2, `meta.perPage is ${list.meta.perPage}, expected 2.`);\n        firstItemId = list.data[0]?.id ?? null;\n    });\n\n    await run('list.sort', 'GET /resources/{resource} accepts a sort', async (check) => {\n        const sort = (resource as Resource | null)?.list?.sorts?.[0];\n        if (sort === undefined) {\n            check.skip('The resource declares no sorts.');\n            return;\n        }\n        const reply = await request(`${resourcePath()}?sort=${encodeURIComponent(`-${sort}`)}`);\n        if (check.expectStatus(reply, 200)) {\n            check.expectSchema(ListResponse, reply.body, 'The sorted list');\n        }\n    });\n\n    await run(\n        'list.filter-range',\n        'GET /resources/{resource} reads the bounds of a range filter',\n        async (check) => {\n            const filter = (resource as Resource | null)?.list?.filters?.find(\n                (candidate) => candidate.type === 'date-range',\n            );\n            if (filter === undefined) {\n                check.skip('The resource declares no date-range filter.');\n                return;\n            }\n            const list = async (range: FilterRange | null, label: string) => {\n                const query =\n                    range !== null ? `?${toSearchParams({ filter: { [filter.id]: range } })}` : '';\n                const reply = await request(`${resourcePath()}${query}`);\n                if (!check.expectStatus(reply, 200)) {\n                    return null;\n                }\n                return check.expectSchema(ListResponse, reply.body, label);\n            };\n            const all = await list(null, 'The list');\n            if (all === null) {\n                return;\n            }\n            // Items of the first page with a value: a range that covers every day includes them.\n            const dated = all.data.filter((item) => isFilled(item[filter.id])).length;\n            const ranges: [FilterRange, string][] = [\n                [{ from: '0001-01-01', to: '9999-12-31' }, 'from 0001-01-01 to 9999-12-31'],\n                [{ to: '9999-12-31' }, 'up to 9999-12-31 (an open start)'],\n            ];\n            for (const [range, label] of ranges) {\n                const reply = await list(range, `The list filtered ${label}`);\n                if (reply !== null) {\n                    check.expect(\n                        reply.meta.total >= dated,\n                        `Filtered ${label}, the list has ${reply.meta.total} items; the first page alone has ${dated} with a ${filter.id}.`,\n                    );\n                }\n            }\n            const future = await list({ from: '9999-12-31' }, 'The list filtered from 9999-12-31');\n            if (future !== null) {\n                check.expect(\n                    future.meta.total === 0,\n                    `Filtered from 9999-12-31, the list has ${future.meta.total} items, expected 0.`,\n                );\n            }\n        },\n    );\n\n    await run(\n        'action.dry-run',\n        'A dry run of an action counts what it would do, and changes nothing',\n        async (check) => {\n            const action = (resource as Resource | null)?.actions?.find(\n                (candidate) =>\n                    candidate.dryRun === true &&\n                    candidate.kind === 'server' &&\n                    candidate.scope.includes('selection'),\n            );\n            if (action === undefined) {\n                check.skip('The resource declares no selection action with dryRun.');\n                return;\n            }\n            const page = async (label: string) => {\n                const reply = await request(`${resourcePath()}?page=1&perPage=20`);\n                return check.expectStatus(reply, 200)\n                    ? check.expectSchema(ListResponse, reply.body, label)\n                    : null;\n            };\n            const before = await page('The list before the dry run');\n            const reply = await request(\n                `${resourcePath()}/actions/${encodeURIComponent(action.id)}`,\n                {\n                    method: 'POST',\n                    body: JSON.stringify({ selection: { query: {} }, dryRun: true }),\n                },\n            );\n            if (!check.expectStatus(reply, 200)) {\n                return;\n            }\n            const result = check.expectSchema(ActionResult, reply.body, 'The dry run result');\n            if (result !== null && before !== null) {\n                check.expect(\n                    result.summary !== undefined,\n                    'A dry run result must have a summary of the items that would succeed and be skipped.',\n                );\n                if (result.summary !== undefined) {\n                    const counted =\n                        result.summary.succeeded + result.summary.failed + result.summary.skipped;\n                    check.expect(\n                        counted === before.meta.total,\n                        `The dry run counts ${counted} items; the list has ${before.meta.total}.`,\n                    );\n                }\n            }\n            const after = await page('The list after the dry run');\n            if (before !== null && after !== null) {\n                const versions = (list: typeof before) =>\n                    JSON.stringify(list.data.map((item) => [item.id, item.version ?? null]));\n                check.expect(\n                    after.meta.total === before.meta.total && versions(after) === versions(before),\n                    'A dry run must not change the items.',\n                );\n            }\n        },\n    );\n\n    await run('list.unknown-resource', 'An unknown resource is a 404 problem', async (check) => {\n        check.expectProblem(await request(`/resources/${UNKNOWN}`), 404);\n    });\n\n    await run(\n        'item',\n        'GET /resources/{resource}/{id} returns the item with its ETag',\n        async (check) => {\n            if (firstItemId === null) {\n                check.skip('The list has no items.');\n                return;\n            }\n            const reply = await request(`${resourcePath()}/${encodeURIComponent(firstItemId)}`);\n            if (!check.expectStatus(reply, 200)) {\n                return;\n            }\n            const item = check.expectSchema(ItemResponse, reply.body, 'The item');\n            if (item === null) {\n                return;\n            }\n            check.expect(\n                item.data.id === firstItemId,\n                `Asked for item \"${firstItemId}\", got \"${item.data.id}\".`,\n            );\n            if (item.data.version !== null) {\n                check.expect(\n                    reply.etag !== null && normalizeEtag(reply.etag) === `\"${item.data.version}\"`,\n                    `Expected ETag \"${item.data.version}\" (quoted), got ${reply.etag ?? 'none'}.`,\n                );\n            }\n        },\n    );\n\n    await run('item.missing', 'A missing item is a 404 problem', async (check) => {\n        if (resource === null) {\n            check.skip('No resource to test.');\n            return;\n        }\n        check.expectProblem(await request(`${resourcePath()}/${UNKNOWN}`), 404);\n    });\n\n    const writes = options.writes;\n    let createdId: string | null = null;\n    let createdVersion: string | null = null;\n\n    await run('create.invalid', 'Invalid values are refused with a 422 problem', async (check) => {\n        if (writes === undefined || resource === null) {\n            check.skip('Write checks are disabled.');\n            return;\n        }\n        const hasRequired = resource.fields.some((field) =>\n            (field.rules ?? []).some((rule) => rule.rule === 'required'),\n        );\n        if (writes.invalid === undefined && !hasRequired) {\n            check.skip('No invalid values given, and the resource has no required field.');\n            return;\n        }\n        const reply = await request(resourcePath(), {\n            method: 'POST',\n            body: JSON.stringify(writes.invalid ?? {}),\n        });\n        const failure = check.expectProblem(reply, 422);\n        if (failure !== null) {\n            check.expect(\n                failure.errors !== undefined && Object.keys(failure.errors).length > 0,\n                'A 422 problem must list the invalid values in `errors`.',\n            );\n        }\n    });\n\n    await run('create', 'POST /resources/{resource} creates an item', async (check) => {\n        if (writes === undefined || resource === null) {\n            check.skip('Write checks are disabled.');\n            return;\n        }\n        const reply = await request(resourcePath(), {\n            method: 'POST',\n            body: JSON.stringify(writes.create),\n        });\n        if (!check.expectStatus(reply, 201)) {\n            return;\n        }\n        const item = check.expectSchema(ItemResponse, reply.body, 'The created item');\n        createdId = item?.data.id ?? null;\n        createdVersion = item?.data.version ?? null;\n    });\n\n    const itemPath = () => `${resourcePath()}/${encodeURIComponent(createdId ?? '')}`;\n\n    await run('update', 'PATCH /resources/{resource}/{id} updates the item', async (check) => {\n        if (createdId === null || writes === undefined) {\n            check.skip('No item was created.');\n            return;\n        }\n        const reply = await request(itemPath(), {\n            method: 'PATCH',\n            body: JSON.stringify(writes.update),\n            headers: createdVersion !== null ? { 'If-Match': `\"${createdVersion}\"` } : {},\n        });\n        if (!check.expectStatus(reply, 200)) {\n            return;\n        }\n        const item = check.expectSchema(ItemResponse, reply.body, 'The updated item');\n        if (item !== null && createdVersion !== null) {\n            check.expect(\n                item.data.version !== createdVersion,\n                'The version did not change after an update.',\n            );\n        }\n    });\n\n    await run(\n        'update.conflict',\n        'A stale If-Match is a 412 problem with the current item',\n        async (check) => {\n            if (createdId === null || writes === undefined) {\n                check.skip('No item was created.');\n                return;\n            }\n            if (createdVersion === null) {\n                check.skip('The backend has no versions.');\n                return;\n            }\n            const reply = await request(itemPath(), {\n                method: 'PATCH',\n                body: JSON.stringify(writes.update),\n                headers: { 'If-Match': '\"__panneau_conformance_stale__\"' },\n            });\n            const failure = check.expectProblem(reply, 412);\n            if (failure !== null) {\n                check.expect(\n                    failure.current !== undefined,\n                    'A 412 problem must include the current item.',\n                );\n            }\n        },\n    );\n\n    await run('delete', 'DELETE /resources/{resource}/{id} deletes the item', async (check) => {\n        if (createdId === null) {\n            check.skip('No item was created.');\n            return;\n        }\n        if (!check.expectStatus(await request(itemPath(), { method: 'DELETE' }), 204)) {\n            return;\n        }\n        check.expectProblem(await request(itemPath()), 404);\n    });\n\n    return { passed: checks.every((check) => check.status !== 'failed'), checks };\n}\n\n/** Formats a report as text, one line per check. */\nexport function formatReport(report: ConformanceReport): string {\n    const symbols: Record<ConformanceStatus, string> = { passed: '✓', failed: '✗', skipped: '-' };\n    return report.checks\n        .map((check) =>\n            [\n                `${symbols[check.status]} ${check.title}`,\n                ...check.issues.map((issue) => `    ${issue}`),\n            ].join('\\n'),\n        )\n        .join('\\n');\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export * from './runtime';
 export * from './schemas';
 export { type ValidationIssue, type ValidationResult, validate, validateBootConfig, validateDefinition, } from './validate';
-export { createBootConfigJsonSchema, createComponentSchemas, createDefinitionJsonSchema, createOpenApiDocument, } from './openapi';
+export { createBootConfigJsonSchema, createComponentSchemas, createDefinitionJsonSchema, createOpenApiDocument, createThemeJsonSchema, } from './openapi';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,OAAO,EACH,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,QAAQ,EACR,kBAAkB,EAClB,kBAAkB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACH,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,qBAAqB,GACxB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,OAAO,EACH,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,QAAQ,EACR,kBAAkB,EAClB,kBAAkB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACH,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,GACxB,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -6,16 +6,18 @@ import { checkRules, checkValues } from "./rules.js";
 import { lintDefinition } from "./lint.js";
 import { fromSearchParams, isFilterRange, matchesFilterRange, toSearchParams } from "./query.js";
 import { isProblem } from "./problem.js";
+import { mergeThemes } from "./themes.js";
 import { Abilities, Condition, Id, Option, RouteReference } from "./schemas/common.js";
 import { BlockType, Field, Rule } from "./schemas/field.js";
 import { LayoutNode } from "./schemas/layout.js";
 import { Action, ActionConfirm, ActionPlacement, ActionScope } from "./schemas/action.js";
 import { Column, Filter, ListDefinition } from "./schemas/list.js";
 import { Resource, ResourceFeatures } from "./schemas/resource.js";
+import { DefinitionTheme, Theme, ThemeFont, ThemeFontFace, ThemeFontStylesheet, ThemeTokens, ToneInput, ToneValues } from "./schemas/theme.js";
 import { Auth, AuthProvider, Definition, MenuItem, Page, Uploads, User, Widget } from "./schemas/definition.js";
 import { ActionItemResult, ActionRequest, ActionResult, ActionRun, ActionRunResponse, Item, ItemResponse, ListResponse, Media, MediaListResponse, MediaResponse, MediaTransform, Pagination, PreviewResponse, Problem, SearchResponse, Selection, Session } from "./schemas/api.js";
 import { BootConfig } from "./schemas/boot.js";
 import { createSchemaRegistry, namedSchemas } from "./schemas/index.js";
 import { validate, validateBootConfig, validateDefinition } from "./validate.js";
-import { createBootConfigJsonSchema, createComponentSchemas, createDefinitionJsonSchema, createOpenApiDocument } from "./openapi.js";
-export { Abilities, Action, ActionConfirm, ActionItemResult, ActionPlacement, ActionRequest, ActionResult, ActionRun, ActionRunResponse, ActionScope, Auth, AuthProvider, BOOT_CONFIG_ELEMENT_ID, BUILT_IN_ACTIONS, BUILT_IN_FIELD_TYPES, BUILT_IN_LAYOUT_NODE_TYPES, BUILT_IN_LIST_LAYOUTS, BlockType, BootConfig, Column, Condition, Definition, Field, Filter, Id, Item, ItemResponse, LayoutNode, ListDefinition, ListResponse, Media, MediaListResponse, MediaResponse, MediaTransform, MenuItem, Option, PORTABLE_RULES, PROBLEM_CONTENT_TYPE, PROTOCOL_VERSION, Page, Pagination, PreviewResponse, Problem, Resource, ResourceFeatures, RouteReference, Rule, SearchResponse, Selection, Session, Uploads, User, Widget, checkRules, checkValues, createBootConfigJsonSchema, createComponentSchemas, createDefinitionJsonSchema, createOpenApiDocument, createSchemaRegistry, evaluateCondition, fromSearchParams, getValue, isFilled, isFilterRange, isProblem, lintDefinition, matchesFilterRange, namedSchemas, toSearchParams, validate, validateBootConfig, validateDefinition };
+import { createBootConfigJsonSchema, createComponentSchemas, createDefinitionJsonSchema, createOpenApiDocument, createThemeJsonSchema } from "./openapi.js";
+export { Abilities, Action, ActionConfirm, ActionItemResult, ActionPlacement, ActionRequest, ActionResult, ActionRun, ActionRunResponse, ActionScope, Auth, AuthProvider, BOOT_CONFIG_ELEMENT_ID, BUILT_IN_ACTIONS, BUILT_IN_FIELD_TYPES, BUILT_IN_LAYOUT_NODE_TYPES, BUILT_IN_LIST_LAYOUTS, BlockType, BootConfig, Column, Condition, Definition, DefinitionTheme, Field, Filter, Id, Item, ItemResponse, LayoutNode, ListDefinition, ListResponse, Media, MediaListResponse, MediaResponse, MediaTransform, MenuItem, Option, PORTABLE_RULES, PROBLEM_CONTENT_TYPE, PROTOCOL_VERSION, Page, Pagination, PreviewResponse, Problem, Resource, ResourceFeatures, RouteReference, Rule, SearchResponse, Selection, Session, Theme, ThemeFont, ThemeFontFace, ThemeFontStylesheet, ThemeTokens, ToneInput, ToneValues, Uploads, User, Widget, checkRules, checkValues, createBootConfigJsonSchema, createComponentSchemas, createDefinitionJsonSchema, createOpenApiDocument, createSchemaRegistry, createThemeJsonSchema, evaluateCondition, fromSearchParams, getValue, isFilled, isFilterRange, isProblem, lintDefinition, matchesFilterRange, mergeThemes, namedSchemas, toSearchParams, validate, validateBootConfig, validateDefinition };

package/dist/mock/example.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../../src/mock/example.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,eAAe,CA0IzD"}
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../../src/mock/example.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,eAAe,CA2IzD"}

package/dist/mock/example.js

@@ -145,7 +145,8 @@ function createExampleDefinition() {
 				fields: [{
 					name: "notify",
 					type: "boolean"
-				}]
+				}],
+				dryRun: true
 			}, {
 				id: "edit",
 				label: "Modifier",

package/dist/mock/example.js.map

@@ -1 +1 @@
-{"version":3,"file":"example.js","names":[],"sources":["../../src/mock/example.ts"],"sourcesContent":["import type { DefinitionInput } from '../schemas';\n\n/**\n * A small but complete definition: pages with localized titles, a status, a publication date shown\n * for published pages, an author and typed blocks, in tabs and a sidebar, plus authors. For tests\n * and stories, with `createMockBackend()`.\n */\nexport function createExampleDefinition(): DefinitionInput {\n    return {\n        protocol: 1,\n        name: 'Test site',\n        locale: 'fr',\n        locales: ['fr', 'en'],\n        api: { baseUrl: '/panneau/api' },\n        resources: [\n            {\n                id: 'pages',\n                label: { singular: 'page', plural: 'pages' },\n                itemTitle: 'title',\n                fields: [\n                    {\n                        name: 'title',\n                        type: 'text',\n                        label: 'Titre',\n                        localized: true,\n                        rules: [{ rule: 'required' }, { rule: 'max', value: 120 }],\n                    },\n                    {\n                        name: 'status',\n                        type: 'select',\n                        options: [\n                            { value: 'draft', label: 'Brouillon' },\n                            { value: 'published', label: 'Publiée' },\n                        ],\n                        rules: [\n                            { rule: 'required' },\n                            { rule: 'in', value: ['draft', 'published'] },\n                        ],\n                    },\n                    {\n                        name: 'published_at',\n                        type: 'datetime',\n                        visibleWhen: { field: 'status', equals: 'published' },\n                        rules: [{ rule: 'required' }],\n                    },\n                    { name: 'author', type: 'relation', resource: 'authors' },\n                    {\n                        name: 'blocks',\n                        type: 'repeater',\n                        types: [\n                            {\n                                id: 'text',\n                                label: 'Texte',\n                                fields: [\n                                    {\n                                        name: 'body',\n                                        type: 'richtext',\n                                        rules: [{ rule: 'required' }],\n                                    },\n                                ],\n                            },\n                            {\n                                id: 'image',\n                                label: 'Image',\n                                fields: [\n                                    {\n                                        name: 'image',\n                                        type: 'media',\n                                        rules: [\n                                            { rule: 'accept', value: ['image/*'] },\n                                            { rule: 'maxSize', value: 1000 },\n                                        ],\n                                    },\n                                ],\n                            },\n                        ],\n                    },\n                ],\n                form: {\n                    layout: [\n                        {\n                            type: 'tabs',\n                            children: [\n                                {\n                                    type: 'tab',\n                                    label: 'Contenu',\n                                    children: [\n                                        {\n                                            type: 'row',\n                                            children: [\n                                                { type: 'field', name: 'title', width: 8 },\n                                                { type: 'field', name: 'status', width: 4 },\n                                            ],\n                                        },\n                                        { type: 'field', name: 'blocks' },\n                                    ],\n                                },\n                            ],\n                        },\n                        { type: 'sidebar', children: [{ type: 'field', name: 'published_at' }] },\n                    ],\n                },\n                list: {\n                    columns: [\n                        { field: 'title', sortable: true },\n                        { field: 'status' },\n                        { id: 'updated' },\n                    ],\n                    filters: [\n                        { id: 'status', type: 'select' },\n                        { id: 'published_at', type: 'date-range', label: 'Publication' },\n                    ],\n                    sorts: ['title', 'published_at'],\n                    defaultSort: 'title',\n                    perPage: 20,\n                    search: true,\n                },\n                actions: [\n                    {\n                        id: 'publish',\n                        label: 'Publier',\n                        scope: ['item', 'selection'],\n                        placement: ['row', 'toolbar'],\n                        confirm: { message: 'Publier {count} pages ?' },\n                        fields: [{ name: 'notify', type: 'boolean' }],\n                    },\n                    {\n                        id: 'edit',\n                        label: 'Modifier',\n                        kind: 'link',\n                        url: '/pages/{id}/edit',\n                        scope: ['item'],\n                    },\n                ],\n                abilities: { viewAny: true, create: true },\n            },\n            {\n                id: 'authors',\n                label: { singular: 'auteur', plural: 'auteurs' },\n                fields: [{ name: 'name', type: 'text', rules: [{ rule: 'required' }] }],\n            },\n        ],\n        menus: { main: [{ type: 'resources' }, { type: 'link', label: 'Site', url: '/' }] },\n        auth: { mode: 'panneau', password: true, providers: [{ id: 'google', label: 'Google' }] },\n    };\n}\n"],"mappings":"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"}
+{"version":3,"file":"example.js","names":[],"sources":["../../src/mock/example.ts"],"sourcesContent":["import type { DefinitionInput } from '../schemas';\n\n/**\n * A small but complete definition: pages with localized titles, a status, a publication date shown\n * for published pages, an author and typed blocks, in tabs and a sidebar, plus authors. For tests\n * and stories, with `createMockBackend()`.\n */\nexport function createExampleDefinition(): DefinitionInput {\n    return {\n        protocol: 1,\n        name: 'Test site',\n        locale: 'fr',\n        locales: ['fr', 'en'],\n        api: { baseUrl: '/panneau/api' },\n        resources: [\n            {\n                id: 'pages',\n                label: { singular: 'page', plural: 'pages' },\n                itemTitle: 'title',\n                fields: [\n                    {\n                        name: 'title',\n                        type: 'text',\n                        label: 'Titre',\n                        localized: true,\n                        rules: [{ rule: 'required' }, { rule: 'max', value: 120 }],\n                    },\n                    {\n                        name: 'status',\n                        type: 'select',\n                        options: [\n                            { value: 'draft', label: 'Brouillon' },\n                            { value: 'published', label: 'Publiée' },\n                        ],\n                        rules: [\n                            { rule: 'required' },\n                            { rule: 'in', value: ['draft', 'published'] },\n                        ],\n                    },\n                    {\n                        name: 'published_at',\n                        type: 'datetime',\n                        visibleWhen: { field: 'status', equals: 'published' },\n                        rules: [{ rule: 'required' }],\n                    },\n                    { name: 'author', type: 'relation', resource: 'authors' },\n                    {\n                        name: 'blocks',\n                        type: 'repeater',\n                        types: [\n                            {\n                                id: 'text',\n                                label: 'Texte',\n                                fields: [\n                                    {\n                                        name: 'body',\n                                        type: 'richtext',\n                                        rules: [{ rule: 'required' }],\n                                    },\n                                ],\n                            },\n                            {\n                                id: 'image',\n                                label: 'Image',\n                                fields: [\n                                    {\n                                        name: 'image',\n                                        type: 'media',\n                                        rules: [\n                                            { rule: 'accept', value: ['image/*'] },\n                                            { rule: 'maxSize', value: 1000 },\n                                        ],\n                                    },\n                                ],\n                            },\n                        ],\n                    },\n                ],\n                form: {\n                    layout: [\n                        {\n                            type: 'tabs',\n                            children: [\n                                {\n                                    type: 'tab',\n                                    label: 'Contenu',\n                                    children: [\n                                        {\n                                            type: 'row',\n                                            children: [\n                                                { type: 'field', name: 'title', width: 8 },\n                                                { type: 'field', name: 'status', width: 4 },\n                                            ],\n                                        },\n                                        { type: 'field', name: 'blocks' },\n                                    ],\n                                },\n                            ],\n                        },\n                        { type: 'sidebar', children: [{ type: 'field', name: 'published_at' }] },\n                    ],\n                },\n                list: {\n                    columns: [\n                        { field: 'title', sortable: true },\n                        { field: 'status' },\n                        { id: 'updated' },\n                    ],\n                    filters: [\n                        { id: 'status', type: 'select' },\n                        { id: 'published_at', type: 'date-range', label: 'Publication' },\n                    ],\n                    sorts: ['title', 'published_at'],\n                    defaultSort: 'title',\n                    perPage: 20,\n                    search: true,\n                },\n                actions: [\n                    {\n                        id: 'publish',\n                        label: 'Publier',\n                        scope: ['item', 'selection'],\n                        placement: ['row', 'toolbar'],\n                        confirm: { message: 'Publier {count} pages ?' },\n                        fields: [{ name: 'notify', type: 'boolean' }],\n                        dryRun: true,\n                    },\n                    {\n                        id: 'edit',\n                        label: 'Modifier',\n                        kind: 'link',\n                        url: '/pages/{id}/edit',\n                        scope: ['item'],\n                    },\n                ],\n                abilities: { viewAny: true, create: true },\n            },\n            {\n                id: 'authors',\n                label: { singular: 'auteur', plural: 'auteurs' },\n                fields: [{ name: 'name', type: 'text', rules: [{ rule: 'required' }] }],\n            },\n        ],\n        menus: { main: [{ type: 'resources' }, { type: 'link', label: 'Site', url: '/' }] },\n        auth: { mode: 'panneau', password: true, providers: [{ id: 'google', label: 'Google' }] },\n    };\n}\n"],"mappings":";;;;;;AAOA,SAAgB,0BAA2C;CACvD,OAAO;EACH,UAAU;EACV,MAAM;EACN,QAAQ;EACR,SAAS,CAAC,MAAM,IAAI;EACpB,KAAK,EAAE,SAAS,eAAe;EAC/B,WAAW,CACP;GACI,IAAI;GACJ,OAAO;IAAE,UAAU;IAAQ,QAAQ;GAAQ;GAC3C,WAAW;GACX,QAAQ;IACJ;KACI,MAAM;KACN,MAAM;KACN,OAAO;KACP,WAAW;KACX,OAAO,CAAC,EAAE,MAAM,WAAW,GAAG;MAAE,MAAM;MAAO,OAAO;KAAI,CAAC;IAC7D;IACA;KACI,MAAM;KACN,MAAM;KACN,SAAS,CACL;MAAE,OAAO;MAAS,OAAO;KAAY,GACrC;MAAE,OAAO;MAAa,OAAO;KAAU,CAC3C;KACA,OAAO,CACH,EAAE,MAAM,WAAW,GACnB;MAAE,MAAM;MAAM,OAAO,CAAC,SAAS,WAAW;KAAE,CAChD;IACJ;IACA;KACI,MAAM;KACN,MAAM;KACN,aAAa;MAAE,OAAO;MAAU,QAAQ;KAAY;KACpD,OAAO,CAAC,EAAE,MAAM,WAAW,CAAC;IAChC;IACA;KAAE,MAAM;KAAU,MAAM;KAAY,UAAU;IAAU;IACxD;KACI,MAAM;KACN,MAAM;KACN,OAAO,CACH;MACI,IAAI;MACJ,OAAO;MACP,QAAQ,CACJ;OACI,MAAM;OACN,MAAM;OACN,OAAO,CAAC,EAAE,MAAM,WAAW,CAAC;MAChC,CACJ;KACJ,GACA;MACI,IAAI;MACJ,OAAO;MACP,QAAQ,CACJ;OACI,MAAM;OACN,MAAM;OACN,OAAO,CACH;QAAE,MAAM;QAAU,OAAO,CAAC,SAAS;OAAE,GACrC;QAAE,MAAM;QAAW,OAAO;OAAK,CACnC;MACJ,CACJ;KACJ,CACJ;IACJ;GACJ;GACA,MAAM,EACF,QAAQ,CACJ;IACI,MAAM;IACN,UAAU,CACN;KACI,MAAM;KACN,OAAO;KACP,UAAU,CACN;MACI,MAAM;MACN,UAAU,CACN;OAAE,MAAM;OAAS,MAAM;OAAS,OAAO;MAAE,GACzC;OAAE,MAAM;OAAS,MAAM;OAAU,OAAO;MAAE,CAC9C;KACJ,GACA;MAAE,MAAM;MAAS,MAAM;KAAS,CACpC;IACJ,CACJ;GACJ,GACA;IAAE,MAAM;IAAW,UAAU,CAAC;KAAE,MAAM;KAAS,MAAM;IAAe,CAAC;GAAE,CAC3E,EACJ;GACA,MAAM;IACF,SAAS;KACL;MAAE,OAAO;MAAS,UAAU;KAAK;KACjC,EAAE,OAAO,SAAS;KAClB,EAAE,IAAI,UAAU;IACpB;IACA,SAAS,CACL;KAAE,IAAI;KAAU,MAAM;IAAS,GAC/B;KAAE,IAAI;KAAgB,MAAM;KAAc,OAAO;IAAc,CACnE;IACA,OAAO,CAAC,SAAS,cAAc;IAC/B,aAAa;IACb,SAAS;IACT,QAAQ;GACZ;GACA,SAAS,CACL;IACI,IAAI;IACJ,OAAO;IACP,OAAO,CAAC,QAAQ,WAAW;IAC3B,WAAW,CAAC,OAAO,SAAS;IAC5B,SAAS,EAAE,SAAS,0BAA0B;IAC9C,QAAQ,CAAC;KAAE,MAAM;KAAU,MAAM;IAAU,CAAC;IAC5C,QAAQ;GACZ,GACA;IACI,IAAI;IACJ,OAAO;IACP,MAAM;IACN,KAAK;IACL,OAAO,CAAC,MAAM;GAClB,CACJ;GACA,WAAW;IAAE,SAAS;IAAM,QAAQ;GAAK;EAC7C,GACA;GACI,IAAI;GACJ,OAAO;IAAE,UAAU;IAAU,QAAQ;GAAU;GAC/C,QAAQ,CAAC;IAAE,MAAM;IAAQ,MAAM;IAAQ,OAAO,CAAC,EAAE,MAAM,WAAW,CAAC;GAAE,CAAC;EAC1E,CACJ;EACA,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,YAAY,GAAG;GAAE,MAAM;GAAQ,OAAO;GAAQ,KAAK;EAAI,CAAC,EAAE;EAClF,MAAM;GAAE,MAAM;GAAW,UAAU;GAAM,WAAW,CAAC;IAAE,IAAI;IAAU,OAAO;GAAS,CAAC;EAAE;CAC5F;AACJ"}

package/dist/mock/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mock/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAgB,IAAI,EAAsB,MAAM,gBAAgB,CAAC;AAI7E,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtC,MAAM,WAAW,kBAAkB;IAC/B,kGAAkG;IAClG,UAAU,EAAE,eAAe,CAAC;IAC5B,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,WAAW;IACxB,oEAAoE;IACpE,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChF,uCAAuC;IACvC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC;CACvC;AA6GD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,UAAU,EAAE,KAAU,EAAE,EAAE,kBAAkB,GAAG,WAAW,CAyN7F;AAED,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mock/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAgB,IAAI,EAAsB,MAAM,gBAAgB,CAAC;AAI7E,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtC,MAAM,WAAW,kBAAkB;IAC/B,kGAAkG;IAClG,UAAU,EAAE,eAAe,CAAC;IAC5B,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,WAAW;IACxB,oEAAoE;IACpE,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChF,uCAAuC;IACvC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC;CACvC;AA6GD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,UAAU,EAAE,KAAU,EAAE,EAAE,kBAAkB,GAAG,WAAW,CA+O7F;AAED,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC"}

package/dist/mock/index.js

@@ -196,8 +196,27 @@ function createMockBackend({ definition, items = {} }) {
 		}
 		if (segments[2] === "actions" && segments[3] !== void 0 && segments.length === 4) {
 			if (method !== "POST") return problem(405, "Method not allowed.");
-			if (segments[3] !== "delete") return problem(404, "Action not found.");
+			const actionId = segments[3];
+			const action = (resource.actions ?? []).find((candidate) => candidate.id === actionId);
 			const body = await readBody();
+			if (body.dryRun === true) {
+				if (action?.dryRun !== true) return problem(400, "This action does not support dry runs.");
+				const selected = selectItems(list, body.selection);
+				const allowed = selected.filter((item) => item.abilities?.[actionId] !== false);
+				return json(200, {
+					summary: {
+						succeeded: allowed.length,
+						failed: 0,
+						skipped: selected.length - allowed.length
+					},
+					results: selected.filter((item) => !allowed.includes(item)).slice(0, 20).map((item) => ({
+						id: item.id,
+						status: "skipped",
+						reason: "forbidden"
+					}))
+				});
+			}
+			if (actionId !== "delete") return problem(404, "Action not found.");
 			const selected = selectItems(list, body.selection);
 			store.set(resource.id, list.filter((item) => !selected.includes(item)));
 			return json(200, {

package/dist/mock/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/mock/index.ts"],"sourcesContent":["import { type ListQuery, fromSearchParams, isFilterRange, matchesFilterRange } from '../query';\nimport { type RuleFailure, checkValues } from '../rules';\nimport type { DefinitionInput, ResourceInput } from '../schemas';\nimport type { ActionResult, Item, Problem, Selection } from '../schemas/api';\nimport { isRecord } from '../values';\nimport { PROBLEM_CONTENT_TYPE } from '../version';\n\ntype Values = Record<string, unknown>;\n\nexport interface MockBackendOptions {\n    /** The definition served by `GET /definition`. Its `api.baseUrl` is the prefix of every route. */\n    definition: DefinitionInput;\n    /** Initial values of the items, per resource id. Items without an `id` get one. */\n    items?: Record<string, Values[]>;\n}\n\nexport interface MockBackend {\n    /** A `fetch`-compatible function that answers protocol requests. */\n    fetch: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;\n    /** The current items of a resource. */\n    items: (resource: string) => Item[];\n}\n\nconst RESERVED_KEYS = new Set(['id', 'version', 'abilities']);\n\nconst DEFAULT_MESSAGES: Record<string, (failure: RuleFailure) => string> = {\n    required: () => 'This field is required.',\n    min: (failure) => `This value must be at least ${String(failure.value)}.`,\n    max: (failure) => `This value must be at most ${String(failure.value)}.`,\n    pattern: () => 'This value has an invalid format.',\n    email: () => 'This value must be an email address.',\n    url: () => 'This value must be a URL.',\n    in: () => 'This value is not one of the choices.',\n    accept: () => 'This file type is not accepted.',\n    maxSize: () => 'This file is too large.',\n    before: () => 'This date is too late.',\n    after: () => 'This date is too early.',\n};\n\nfunction message(failure: RuleFailure): string {\n    return failure.message ?? DEFAULT_MESSAGES[failure.rule]?.(failure) ?? 'This value is invalid.';\n}\n\nfunction json(status: number, body: unknown, headers: Record<string, string> = {}): Response {\n    return new Response(status === 204 ? null : JSON.stringify(body), {\n        status,\n        headers: status === 204 ? headers : { 'Content-Type': 'application/json', ...headers },\n    });\n}\n\nfunction problem(status: number, title: string, extra: Partial<Problem> = {}): Response {\n    const body: Problem = { type: 'about:blank', title, status, ...extra };\n    return new Response(JSON.stringify(body), {\n        status,\n        headers: { 'Content-Type': PROBLEM_CONTENT_TYPE },\n    });\n}\n\nfunction etag(item: Item): Record<string, string> {\n    return item.version === null ? {} : { ETag: `\"${item.version}\"` };\n}\n\nfunction parseEtag(value: string): string {\n    return value.replace(/^W\\//, '').replace(/^\"(.*)\"$/, '$1');\n}\n\nfunction searchableText(value: unknown): string {\n    if (typeof value === 'string') {\n        return value;\n    }\n    if (isRecord(value)) {\n        return Object.values(value).map(searchableText).join(' ');\n    }\n    return '';\n}\n\nfunction compare(a: unknown, b: unknown): number {\n    const left = isRecord(a) ? searchableText(a) : a;\n    const right = isRecord(b) ? searchableText(b) : b;\n    if (left === right) {\n        return 0;\n    }\n    if (left === undefined || left === null) {\n        return 1;\n    }\n    if (right === undefined || right === null) {\n        return -1;\n    }\n    return String(left).localeCompare(String(right), undefined, { numeric: true });\n}\n\nfunction applyQuery(items: Item[], query: Pick<ListQuery, 'filter' | 'q' | 'sort'>): Item[] {\n    let result = items;\n    Object.entries(query.filter ?? {}).forEach(([key, expected]) => {\n        if (isFilterRange(expected)) {\n            result = result.filter((item) => matchesFilterRange(item[key], expected));\n            return;\n        }\n        const accepted = (Array.isArray(expected) ? expected : [expected]).map(String);\n        result = result.filter((item) => {\n            const value = item[key];\n            const values = Array.isArray(value) ? value : [value];\n            return values.some((candidate) => accepted.includes(String(candidate)));\n        });\n    });\n    if (query.q !== undefined && query.q !== '') {\n        const terms = query.q.toLowerCase();\n        result = result.filter((item) =>\n            Object.entries(item)\n                .filter(([key]) => !RESERVED_KEYS.has(key))\n                .some(([, value]) => searchableText(value).toLowerCase().includes(terms)),\n        );\n    }\n    const sort = query.sort ?? [];\n    if (sort.length > 0) {\n        result = [...result].sort((a, b) => {\n            for (const part of sort) {\n                const descending = part.startsWith('-');\n                const key = descending ? part.slice(1) : part;\n                const order = compare(a[key], b[key]);\n                if (order !== 0) {\n                    return descending ? -order : order;\n                }\n            }\n            return 0;\n        });\n    }\n    return result;\n}\n\n/**\n * An in-memory backend that implements the protocol's resource routes: definition, list, show,\n * create, update (with `If-Match`), delete and the built-in `delete` action. Values are checked\n * with the portable rules. Used to test the conformance kit, and to develop frontends without a\n * real backend.\n */\nexport function createMockBackend({ definition, items = {} }: MockBackendOptions): MockBackend {\n    const store = new Map<string, Item[]>();\n    let nextId = 1;\n\n    const abilitiesFor = (resource: ResourceInput) =>\n        Object.fromEntries([\n            ['update', true],\n            ['delete', true],\n            ...(resource.actions ?? []).map((action) => [action.id, true]),\n        ]);\n\n    const makeItem = (resource: ResourceInput, values: Values): Item => {\n        const id =\n            typeof values.id === 'string' || typeof values.id === 'number'\n                ? String(values.id)\n                : String(nextId++);\n        const rest = Object.fromEntries(\n            Object.entries(values).filter(([key]) => !RESERVED_KEYS.has(key)),\n        );\n        return { ...rest, id, version: '1', abilities: abilitiesFor(resource) };\n    };\n\n    definition.resources.forEach((resource) => {\n        store.set(\n            resource.id,\n            (items[resource.id] ?? []).map((values) => makeItem(resource, values)),\n        );\n    });\n\n    const basePath = new URL(definition.api.baseUrl, 'http://panneau.test').pathname.replace(\n        /\\/$/,\n        '',\n    );\n\n    const validationProblem = (\n        resource: ResourceInput,\n        values: Values,\n        mode: 'create' | 'update',\n    ) => {\n        const failures = checkValues(resource.fields, values, {\n            mode,\n            partial: mode === 'update',\n            locales: definition.locales,\n        });\n        const paths = Object.keys(failures);\n        if (paths.length === 0) {\n            return null;\n        }\n        return problem(422, 'The given data was invalid.', {\n            type: 'urn:panneau:problem:validation',\n            errors: Object.fromEntries(\n                paths.map((path) => [path, (failures[path] ?? []).map(message)]),\n            ),\n        });\n    };\n\n    const selectItems = (list: Item[], selection: Selection | undefined): Item[] => {\n        if (selection === undefined) {\n            return [];\n        }\n        if ('ids' in selection) {\n            const ids = selection.ids as string[];\n            return list.filter((item) => ids.includes(item.id));\n        }\n        const except = selection.except ?? [];\n        const { filter, q } = selection.query;\n        const query: Pick<ListQuery, 'filter' | 'q'> = {};\n        if (filter !== undefined) {\n            query.filter = filter as NonNullable<ListQuery['filter']>;\n        }\n        if (q !== undefined) {\n            query.q = q;\n        }\n        return applyQuery(list, query).filter((item) => !except.includes(item.id));\n    };\n\n    const handle = async (request: Request): Promise<Response> => {\n        const url = new URL(request.url, 'http://panneau.test');\n        if (!url.pathname.startsWith(basePath)) {\n            return problem(404, 'Not found.');\n        }\n        const segments = url.pathname\n            .slice(basePath.length)\n            .split('/')\n            .filter((segment) => segment !== '')\n            .map(decodeURIComponent);\n        const method = request.method.toUpperCase();\n        const readBody = async (): Promise<Values> => {\n            const body: unknown = await request.json().catch(() => null);\n            return isRecord(body) ? body : {};\n        };\n\n        if (segments.length === 1 && segments[0] === 'definition' && method === 'GET') {\n            return json(200, definition);\n        }\n        if (segments[0] !== 'resources' || segments[1] === undefined) {\n            return problem(404, 'Not found.');\n        }\n\n        const resource = definition.resources.find((candidate) => candidate.id === segments[1]);\n        const list = resource !== undefined ? store.get(resource.id) : undefined;\n        if (resource === undefined || list === undefined) {\n            return problem(404, 'Resource not found.');\n        }\n\n        if (segments.length === 2) {\n            if (method === 'GET') {\n                const query = fromSearchParams(url.searchParams);\n                const perPage = query.perPage ?? resource.list?.perPage ?? 20;\n                const page = query.page ?? 1;\n                const sort = query.sort ?? resource.list?.defaultSort?.split(',');\n                const matching = applyQuery(list, {\n                    ...query,\n                    ...(sort !== undefined ? { sort } : {}),\n                });\n                return json(200, {\n                    data: matching.slice((page - 1) * perPage, page * perPage),\n                    meta: {\n                        page,\n                        perPage,\n                        total: matching.length,\n                        lastPage: Math.max(1, Math.ceil(matching.length / perPage)),\n                    },\n                });\n            }\n            if (method === 'POST') {\n                const values = await readBody();\n                const invalid = validationProblem(resource, values, 'create');\n                if (invalid !== null) {\n                    return invalid;\n                }\n                const item = makeItem(resource, { ...values, id: undefined });\n                list.push(item);\n                return json(201, { data: item }, etag(item));\n            }\n            return problem(405, 'Method not allowed.');\n        }\n\n        if (segments[2] === 'actions' && segments[3] !== undefined && segments.length === 4) {\n            if (method !== 'POST') {\n                return problem(405, 'Method not allowed.');\n            }\n            if (segments[3] !== 'delete') {\n                return problem(404, 'Action not found.');\n            }\n            const body = await readBody();\n            const selected = selectItems(list, body.selection as Selection | undefined);\n            store.set(\n                resource.id,\n                list.filter((item) => !selected.includes(item)),\n            );\n            const result: ActionResult = {\n                message: `${selected.length} deleted.`,\n                summary: { succeeded: selected.length, failed: 0, skipped: 0 },\n                refresh: 'list',\n            };\n            return json(200, result);\n        }\n\n        if (segments.length !== 3 || segments[2] === undefined) {\n            return problem(404, 'Not found.');\n        }\n        const id = segments[2];\n        const index = list.findIndex((item) => item.id === id);\n        const current = list[index];\n        if (current === undefined) {\n            return problem(404, 'Item not found.');\n        }\n\n        if (method === 'GET') {\n            return json(200, { data: current }, etag(current));\n        }\n        if (method === 'PATCH') {\n            const ifMatch = request.headers.get('If-Match');\n            if (\n                ifMatch !== null &&\n                current.version !== null &&\n                parseEtag(ifMatch) !== current.version\n            ) {\n                return problem(412, 'The item was changed by someone else.', {\n                    type: 'urn:panneau:problem:version-conflict',\n                    current,\n                });\n            }\n            const values = await readBody();\n            const invalid = validationProblem(resource, values, 'update');\n            if (invalid !== null) {\n                return invalid;\n            }\n            const updates = Object.fromEntries(\n                Object.entries(values).filter(([key]) => !RESERVED_KEYS.has(key)),\n            );\n            const updated: Item = {\n                ...current,\n                ...updates,\n                version: current.version === null ? null : String(Number(current.version) + 1),\n            };\n            list[index] = updated;\n            return json(200, { data: updated }, etag(updated));\n        }\n        if (method === 'DELETE') {\n            list.splice(index, 1);\n            return json(204, null);\n        }\n        return problem(405, 'Method not allowed.');\n    };\n\n    return {\n        fetch: (input, init) => {\n            if (input instanceof Request) {\n                return handle(input);\n            }\n            // Relative URLs are accepted, as a browser would resolve them.\n            return handle(new Request(new URL(input, 'http://panneau.test'), init));\n        },\n        items: (resource) => [...(store.get(resource) ?? [])],\n    };\n}\n\nexport { createExampleDefinition } from './example';\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/mock/index.ts"],"sourcesContent":["import { type ListQuery, fromSearchParams, isFilterRange, matchesFilterRange } from '../query';\nimport { type RuleFailure, checkValues } from '../rules';\nimport type { DefinitionInput, ResourceInput } from '../schemas';\nimport type { ActionResult, Item, Problem, Selection } from '../schemas/api';\nimport { isRecord } from '../values';\nimport { PROBLEM_CONTENT_TYPE } from '../version';\n\ntype Values = Record<string, unknown>;\n\nexport interface MockBackendOptions {\n    /** The definition served by `GET /definition`. Its `api.baseUrl` is the prefix of every route. */\n    definition: DefinitionInput;\n    /** Initial values of the items, per resource id. Items without an `id` get one. */\n    items?: Record<string, Values[]>;\n}\n\nexport interface MockBackend {\n    /** A `fetch`-compatible function that answers protocol requests. */\n    fetch: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;\n    /** The current items of a resource. */\n    items: (resource: string) => Item[];\n}\n\nconst RESERVED_KEYS = new Set(['id', 'version', 'abilities']);\n\nconst DEFAULT_MESSAGES: Record<string, (failure: RuleFailure) => string> = {\n    required: () => 'This field is required.',\n    min: (failure) => `This value must be at least ${String(failure.value)}.`,\n    max: (failure) => `This value must be at most ${String(failure.value)}.`,\n    pattern: () => 'This value has an invalid format.',\n    email: () => 'This value must be an email address.',\n    url: () => 'This value must be a URL.',\n    in: () => 'This value is not one of the choices.',\n    accept: () => 'This file type is not accepted.',\n    maxSize: () => 'This file is too large.',\n    before: () => 'This date is too late.',\n    after: () => 'This date is too early.',\n};\n\nfunction message(failure: RuleFailure): string {\n    return failure.message ?? DEFAULT_MESSAGES[failure.rule]?.(failure) ?? 'This value is invalid.';\n}\n\nfunction json(status: number, body: unknown, headers: Record<string, string> = {}): Response {\n    return new Response(status === 204 ? null : JSON.stringify(body), {\n        status,\n        headers: status === 204 ? headers : { 'Content-Type': 'application/json', ...headers },\n    });\n}\n\nfunction problem(status: number, title: string, extra: Partial<Problem> = {}): Response {\n    const body: Problem = { type: 'about:blank', title, status, ...extra };\n    return new Response(JSON.stringify(body), {\n        status,\n        headers: { 'Content-Type': PROBLEM_CONTENT_TYPE },\n    });\n}\n\nfunction etag(item: Item): Record<string, string> {\n    return item.version === null ? {} : { ETag: `\"${item.version}\"` };\n}\n\nfunction parseEtag(value: string): string {\n    return value.replace(/^W\\//, '').replace(/^\"(.*)\"$/, '$1');\n}\n\nfunction searchableText(value: unknown): string {\n    if (typeof value === 'string') {\n        return value;\n    }\n    if (isRecord(value)) {\n        return Object.values(value).map(searchableText).join(' ');\n    }\n    return '';\n}\n\nfunction compare(a: unknown, b: unknown): number {\n    const left = isRecord(a) ? searchableText(a) : a;\n    const right = isRecord(b) ? searchableText(b) : b;\n    if (left === right) {\n        return 0;\n    }\n    if (left === undefined || left === null) {\n        return 1;\n    }\n    if (right === undefined || right === null) {\n        return -1;\n    }\n    return String(left).localeCompare(String(right), undefined, { numeric: true });\n}\n\nfunction applyQuery(items: Item[], query: Pick<ListQuery, 'filter' | 'q' | 'sort'>): Item[] {\n    let result = items;\n    Object.entries(query.filter ?? {}).forEach(([key, expected]) => {\n        if (isFilterRange(expected)) {\n            result = result.filter((item) => matchesFilterRange(item[key], expected));\n            return;\n        }\n        const accepted = (Array.isArray(expected) ? expected : [expected]).map(String);\n        result = result.filter((item) => {\n            const value = item[key];\n            const values = Array.isArray(value) ? value : [value];\n            return values.some((candidate) => accepted.includes(String(candidate)));\n        });\n    });\n    if (query.q !== undefined && query.q !== '') {\n        const terms = query.q.toLowerCase();\n        result = result.filter((item) =>\n            Object.entries(item)\n                .filter(([key]) => !RESERVED_KEYS.has(key))\n                .some(([, value]) => searchableText(value).toLowerCase().includes(terms)),\n        );\n    }\n    const sort = query.sort ?? [];\n    if (sort.length > 0) {\n        result = [...result].sort((a, b) => {\n            for (const part of sort) {\n                const descending = part.startsWith('-');\n                const key = descending ? part.slice(1) : part;\n                const order = compare(a[key], b[key]);\n                if (order !== 0) {\n                    return descending ? -order : order;\n                }\n            }\n            return 0;\n        });\n    }\n    return result;\n}\n\n/**\n * An in-memory backend that implements the protocol's resource routes: definition, list, show,\n * create, update (with `If-Match`), delete and the built-in `delete` action. Values are checked\n * with the portable rules. Used to test the conformance kit, and to develop frontends without a\n * real backend.\n */\nexport function createMockBackend({ definition, items = {} }: MockBackendOptions): MockBackend {\n    const store = new Map<string, Item[]>();\n    let nextId = 1;\n\n    const abilitiesFor = (resource: ResourceInput) =>\n        Object.fromEntries([\n            ['update', true],\n            ['delete', true],\n            ...(resource.actions ?? []).map((action) => [action.id, true]),\n        ]);\n\n    const makeItem = (resource: ResourceInput, values: Values): Item => {\n        const id =\n            typeof values.id === 'string' || typeof values.id === 'number'\n                ? String(values.id)\n                : String(nextId++);\n        const rest = Object.fromEntries(\n            Object.entries(values).filter(([key]) => !RESERVED_KEYS.has(key)),\n        );\n        return { ...rest, id, version: '1', abilities: abilitiesFor(resource) };\n    };\n\n    definition.resources.forEach((resource) => {\n        store.set(\n            resource.id,\n            (items[resource.id] ?? []).map((values) => makeItem(resource, values)),\n        );\n    });\n\n    const basePath = new URL(definition.api.baseUrl, 'http://panneau.test').pathname.replace(\n        /\\/$/,\n        '',\n    );\n\n    const validationProblem = (\n        resource: ResourceInput,\n        values: Values,\n        mode: 'create' | 'update',\n    ) => {\n        const failures = checkValues(resource.fields, values, {\n            mode,\n            partial: mode === 'update',\n            locales: definition.locales,\n        });\n        const paths = Object.keys(failures);\n        if (paths.length === 0) {\n            return null;\n        }\n        return problem(422, 'The given data was invalid.', {\n            type: 'urn:panneau:problem:validation',\n            errors: Object.fromEntries(\n                paths.map((path) => [path, (failures[path] ?? []).map(message)]),\n            ),\n        });\n    };\n\n    const selectItems = (list: Item[], selection: Selection | undefined): Item[] => {\n        if (selection === undefined) {\n            return [];\n        }\n        if ('ids' in selection) {\n            const ids = selection.ids as string[];\n            return list.filter((item) => ids.includes(item.id));\n        }\n        const except = selection.except ?? [];\n        const { filter, q } = selection.query;\n        const query: Pick<ListQuery, 'filter' | 'q'> = {};\n        if (filter !== undefined) {\n            query.filter = filter as NonNullable<ListQuery['filter']>;\n        }\n        if (q !== undefined) {\n            query.q = q;\n        }\n        return applyQuery(list, query).filter((item) => !except.includes(item.id));\n    };\n\n    const handle = async (request: Request): Promise<Response> => {\n        const url = new URL(request.url, 'http://panneau.test');\n        if (!url.pathname.startsWith(basePath)) {\n            return problem(404, 'Not found.');\n        }\n        const segments = url.pathname\n            .slice(basePath.length)\n            .split('/')\n            .filter((segment) => segment !== '')\n            .map(decodeURIComponent);\n        const method = request.method.toUpperCase();\n        const readBody = async (): Promise<Values> => {\n            const body: unknown = await request.json().catch(() => null);\n            return isRecord(body) ? body : {};\n        };\n\n        if (segments.length === 1 && segments[0] === 'definition' && method === 'GET') {\n            return json(200, definition);\n        }\n        if (segments[0] !== 'resources' || segments[1] === undefined) {\n            return problem(404, 'Not found.');\n        }\n\n        const resource = definition.resources.find((candidate) => candidate.id === segments[1]);\n        const list = resource !== undefined ? store.get(resource.id) : undefined;\n        if (resource === undefined || list === undefined) {\n            return problem(404, 'Resource not found.');\n        }\n\n        if (segments.length === 2) {\n            if (method === 'GET') {\n                const query = fromSearchParams(url.searchParams);\n                const perPage = query.perPage ?? resource.list?.perPage ?? 20;\n                const page = query.page ?? 1;\n                const sort = query.sort ?? resource.list?.defaultSort?.split(',');\n                const matching = applyQuery(list, {\n                    ...query,\n                    ...(sort !== undefined ? { sort } : {}),\n                });\n                return json(200, {\n                    data: matching.slice((page - 1) * perPage, page * perPage),\n                    meta: {\n                        page,\n                        perPage,\n                        total: matching.length,\n                        lastPage: Math.max(1, Math.ceil(matching.length / perPage)),\n                    },\n                });\n            }\n            if (method === 'POST') {\n                const values = await readBody();\n                const invalid = validationProblem(resource, values, 'create');\n                if (invalid !== null) {\n                    return invalid;\n                }\n                const item = makeItem(resource, { ...values, id: undefined });\n                list.push(item);\n                return json(201, { data: item }, etag(item));\n            }\n            return problem(405, 'Method not allowed.');\n        }\n\n        if (segments[2] === 'actions' && segments[3] !== undefined && segments.length === 4) {\n            if (method !== 'POST') {\n                return problem(405, 'Method not allowed.');\n            }\n            const actionId = segments[3];\n            const action = (resource.actions ?? []).find((candidate) => candidate.id === actionId);\n            const body = await readBody();\n            if (body.dryRun === true) {\n                // A dry run counts what the action would do, and changes nothing.\n                if (action?.dryRun !== true) {\n                    return problem(400, 'This action does not support dry runs.');\n                }\n                const selected = selectItems(list, body.selection as Selection | undefined);\n                const allowed = selected.filter((item) => item.abilities?.[actionId] !== false);\n                const result: ActionResult = {\n                    summary: {\n                        succeeded: allowed.length,\n                        failed: 0,\n                        skipped: selected.length - allowed.length,\n                    },\n                    results: selected\n                        .filter((item) => !allowed.includes(item))\n                        .slice(0, 20)\n                        .map((item) => ({ id: item.id, status: 'skipped', reason: 'forbidden' })),\n                };\n                return json(200, result);\n            }\n            if (actionId !== 'delete') {\n                return problem(404, 'Action not found.');\n            }\n            const selected = selectItems(list, body.selection as Selection | undefined);\n            store.set(\n                resource.id,\n                list.filter((item) => !selected.includes(item)),\n            );\n            const result: ActionResult = {\n                message: `${selected.length} deleted.`,\n                summary: { succeeded: selected.length, failed: 0, skipped: 0 },\n                refresh: 'list',\n            };\n            return json(200, result);\n        }\n\n        if (segments.length !== 3 || segments[2] === undefined) {\n            return problem(404, 'Not found.');\n        }\n        const id = segments[2];\n        const index = list.findIndex((item) => item.id === id);\n        const current = list[index];\n        if (current === undefined) {\n            return problem(404, 'Item not found.');\n        }\n\n        if (method === 'GET') {\n            return json(200, { data: current }, etag(current));\n        }\n        if (method === 'PATCH') {\n            const ifMatch = request.headers.get('If-Match');\n            if (\n                ifMatch !== null &&\n                current.version !== null &&\n                parseEtag(ifMatch) !== current.version\n            ) {\n                return problem(412, 'The item was changed by someone else.', {\n                    type: 'urn:panneau:problem:version-conflict',\n                    current,\n                });\n            }\n            const values = await readBody();\n            const invalid = validationProblem(resource, values, 'update');\n            if (invalid !== null) {\n                return invalid;\n            }\n            const updates = Object.fromEntries(\n                Object.entries(values).filter(([key]) => !RESERVED_KEYS.has(key)),\n            );\n            const updated: Item = {\n                ...current,\n                ...updates,\n                version: current.version === null ? null : String(Number(current.version) + 1),\n            };\n            list[index] = updated;\n            return json(200, { data: updated }, etag(updated));\n        }\n        if (method === 'DELETE') {\n            list.splice(index, 1);\n            return json(204, null);\n        }\n        return problem(405, 'Method not allowed.');\n    };\n\n    return {\n        fetch: (input, init) => {\n            if (input instanceof Request) {\n                return handle(input);\n            }\n            // Relative URLs are accepted, as a browser would resolve them.\n            return handle(new Request(new URL(input, 'http://panneau.test'), init));\n        },\n        items: (resource) => [...(store.get(resource) ?? [])],\n    };\n}\n\nexport { createExampleDefinition } from './example';\n"],"mappings":"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"}

package/dist/openapi.d.ts

@@ -3,6 +3,8 @@ type JsonObject = Record<string, unknown>;
 export declare function createComponentSchemas(): Record<string, JsonObject>;
 /** The JSON Schema of the definition (`GET /definition`). */
 export declare function createDefinitionJsonSchema(): JsonObject;
+/** The JSON Schema of a theme, for themes written as JSON files. */
+export declare function createThemeJsonSchema(): JsonObject;
 /** The JSON Schema of the boot config, which a server writes in the page of the app. */
 export declare function createBootConfigJsonSchema(): JsonObject;
 /** The OpenAPI 3.1 document of the Panneau HTTP API. */

package/dist/openapi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"AAOA,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA2E1C,oEAAoE;AACpE,wBAAgB,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAWnE;AAED,6DAA6D;AAC7D,wBAAgB,0BAA0B,IAAI,UAAU,CAQvD;AAED,wFAAwF;AACxF,wBAAgB,0BAA0B,IAAI,UAAU,CAQvD;AAED,wDAAwD;AACxD,wBAAgB,qBAAqB,IAAI,UAAU,CAialD"}
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"AAQA,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA4E1C,oEAAoE;AACpE,wBAAgB,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAWnE;AAED,6DAA6D;AAC7D,wBAAgB,0BAA0B,IAAI,UAAU,CAQvD;AAED,oEAAoE;AACpE,wBAAgB,qBAAqB,IAAI,UAAU,CAQlD;AAED,wFAAwF;AACxF,wBAAgB,0BAA0B,IAAI,UAAU,CAQvD;AAED,wDAAwD;AACxD,wBAAgB,qBAAqB,IAAI,UAAU,CAialD"}

package/dist/openapi.js

@@ -1,4 +1,5 @@
 import { PROBLEM_CONTENT_TYPE } from "./version.js";
+import { Theme } from "./schemas/theme.js";
 import { Definition } from "./schemas/definition.js";
 import { BootConfig } from "./schemas/boot.js";
 import { createSchemaRegistry } from "./schemas/index.js";
@@ -12,6 +13,7 @@ var ok = (description, schema, headers) => ({
 	...headers !== void 0 ? { headers } : {}
 });
 var PROBLEMS = {
+	400: "Bad request, such as a dry run of an action that does not declare `dryRun`.",
 	401: "Not authenticated.",
 	403: "Not allowed.",
 	404: "Not found.",
@@ -95,6 +97,16 @@ function createDefinitionJsonSchema() {
 		})
 	};
 }
+/** The JSON Schema of a theme, for themes written as JSON files. */
+function createThemeJsonSchema() {
+	return {
+		$id: "https://github.com/folkloreinc/panneau-js/blob/v5.x/packages/protocol/schema/theme.schema.json",
+		...z.toJSONSchema(Theme, {
+			io: "input",
+			metadata: createSchemaRegistry()
+		})
+	};
+}
 /** The JSON Schema of the boot config, which a server writes in the page of the app. */
 function createBootConfigJsonSchema() {
 	return {
@@ -209,7 +221,7 @@ function createOpenApiDocument() {
 					responses: {
 						200: ok("The result.", ref("ActionResult")),
 						202: ok("The action runs in the background.", ref("ActionRunResponse")),
-						...problems(401, 403, 404, 409, 422)
+						...problems(400, 401, 403, 404, 409, 422)
 					}
 				}
 			},
@@ -535,6 +547,6 @@ function createOpenApiDocument() {
 	};
 }
 //#endregion
-export { createBootConfigJsonSchema, createComponentSchemas, createDefinitionJsonSchema, createOpenApiDocument };
+export { createBootConfigJsonSchema, createComponentSchemas, createDefinitionJsonSchema, createOpenApiDocument, createThemeJsonSchema };
 
 //# sourceMappingURL=openapi.js.map