@north-light/crouter 0.3.318 → 0.3.320

package/dist/core/human/page-schema.js

@@ -1,373 +1 @@
-import { z } from 'zod';
-import { BUILTIN_PAGE_KINDS, productPageComponent } from './page-catalog.js';
-export const PAGE_SLOT_ID_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
-const idSchema = z.string().regex(PAGE_SLOT_ID_PATTERN, { error: 'slot id must match /^[A-Za-z0-9_-]{1,64}$/' });
-const itemIdSchema = z.string().min(1);
-const selectModeSchema = z.enum(['none', 'single', 'multi']);
-const jsonObjectSchema = z.record(z.string(), z.unknown());
-function uniqueIds(items, ctx, label) {
-    const seen = new Set();
-    items.forEach((item, index) => {
-        if (seen.has(item.id))
-            ctx.addIssue({ code: 'custom', path: [index, 'id'], message: `duplicate ${label} id "${item.id}"` });
-        seen.add(item.id);
-    });
-}
-// Response comments qualify the answer itself, so anchors name only answerable structure:
-// one of a question's options, or a table row. Feedback on rendered page content — including
-// the question text itself — is a ticket-level feedback comment (feedback.ts), not part of
-// any response.
-export const pageCommentAnchorSchema = z.discriminatedUnion('kind', [
-    z.object({ kind: z.literal('option'), optionId: itemIdSchema }).strict(),
-    z.object({ kind: z.literal('row'), rowId: itemIdSchema }).strict(),
-]);
-export const commentSchema = z.object({ id: z.string().min(1), anchor: pageCommentAnchorSchema, text: z.string() }).strict();
-export const optionSchema = z.object({ id: itemIdSchema, label: z.string().min(1), description: z.string().optional(), recommended: z.boolean().optional() }).strict();
-export const optionsConfigSchema = z.object({
-    label: z.string().optional(),
-    body: z.string().optional(),
-    options: z.array(optionSchema).min(1).superRefine((items, ctx) => uniqueIds(items, ctx, 'option')),
-    mode: z.enum(['single', 'multi']),
-    // Defaults with the mode: a radio group means "pick one", while an empty checkbox
-    // list is itself an answer ("none of these apply").
-    required: z.boolean().optional(),
-    allowFreetext: z.boolean().optional(),
-    freetextLabel: z.string().optional(),
-    freetextPlaceholder: z.string().optional(),
-}).strict().superRefine((config, ctx) => {
-    const recommended = config.options.filter((option) => option.recommended === true);
-    if (recommended.length > 1)
-        ctx.addIssue({ code: 'custom', path: ['options'], message: `at most one option may be recommended, but ${recommended.length} are` });
-});
-export const optionsResponseSchema = z.object({ selectedOptionIds: z.array(itemIdSchema), comments: z.array(commentSchema), freetext: z.string().optional() }).strict();
-// Text is a writing surface, always: its whole point is the string the user hands back, so
-// there is no read-only mode. `singleLine` only swaps the multi-line surface for one compact
-// form field — a subject line, a name, a URL.
-export const textConfigSchema = z.object({ label: z.string().optional(), initialText: z.string(), placeholder: z.string().optional(), singleLine: z.boolean().optional(), required: z.boolean().optional() }).strict();
-export const textResponseSchema = z.object({ text: z.string(), edited: z.boolean() }).strict();
-export const tableColumnSchema = z.object({ id: itemIdSchema, label: z.string().min(1), align: z.enum(['left', 'right']).optional(), mono: z.boolean().optional() }).strict();
-export const tableCellSchema = z.union([z.string(), z.number(), z.boolean(), z.null()]);
-export const tableRowSchema = z.object({ id: itemIdSchema, cells: z.record(z.string(), tableCellSchema) }).strict();
-export const tableRowsSchema = z.array(tableRowSchema).superRefine((items, ctx) => uniqueIds(items, ctx, 'row'));
-const tableConfigFields = {
-    label: z.string().optional(),
-    body: z.string().optional(),
-    columns: z.array(tableColumnSchema).min(1).superRefine((items, ctx) => uniqueIds(items, ctx, 'column')),
-    rows: tableRowsSchema.optional(),
-    rowSelect: selectModeSchema.default('none'),
-    columnSelect: selectModeSchema.default('none'),
-    required: z.boolean().optional(),
-};
-/** Table config: its data is always embedded. */
-export const tableConfigSchema = z.object(tableConfigFields).strict();
-export const tableResponseSchema = z.object({ selectedRowIds: z.array(itemIdSchema), selectedColumnIds: z.array(itemIdSchema), comments: z.array(commentSchema) }).strict();
-export const cardSchema = z.object({ id: itemIdSchema, title: z.string().min(1), subtitle: z.string().optional(), body: z.string().optional(), tag: z.string().optional() }).strict();
-export const cardsSchema = z.array(cardSchema).superRefine((items, ctx) => uniqueIds(items, ctx, 'card'));
-const cardsConfigFields = {
-    label: z.string().optional(),
-    body: z.string().optional(),
-    cards: cardsSchema.optional(),
-    mode: z.enum(['single', 'multi']),
-    columns: z.union([z.literal(2), z.literal(3)]).optional(),
-    required: z.boolean().optional(),
-};
-/** Cards config: its data is always embedded. */
-export const cardsConfigSchema = z.object(cardsConfigFields).strict();
-export const cardsResponseSchema = z.object({ selectedCardIds: z.array(itemIdSchema) }).strict();
-export const chartSeriesSchema = z.object({ field: z.string().min(1), label: z.string().optional() }).strict();
-export const chartDataRowsSchema = z.array(z.record(z.string(), z.unknown()));
-const chartConfigFields = {
-    kind: z.enum(['line', 'bar', 'area']),
-    x: z.string().min(1),
-    y: z.array(chartSeriesSchema).min(1),
-    title: z.string().optional(),
-    data: chartDataRowsSchema.optional(),
-};
-/** Chart config: its data is always embedded. */
-export const chartConfigSchema = z.object(chartConfigFields).strict();
-const sourceSchema = z.object({ sessionName: z.string().optional(), askedBy: z.string().optional(), emittedAt: z.string().datetime({ offset: true }).optional(), profileName: z.string().optional(), nodeId: z.string().optional() }).strict();
-export const pageDeliverySchema = z.object({ placement: z.enum(['inline', 'panel']), inbox: z.boolean(), reply: z.boolean() }).strict();
-const rawSlotSchema = z.object({ id: idSchema.optional(), kind: z.string().min(1), step: z.number().int().nonnegative(), config: jsonObjectSchema, unvalidated: z.literal(true).optional(), display: z.literal(true).optional() }).strict();
-const rawPageManifestSchema = z.object({
-    schema: z.literal('crtr.page/v2'),
-    dialect: z.enum(['jsx', 'html']),
-    title: z.string().trim().min(1),
-    subtitle: z.string().optional(),
-    delivery: pageDeliverySchema,
-    document: z.enum(['page.tsx', 'page.html']),
-    steps: z.number().int().positive(),
-    slots: z.array(rawSlotSchema),
-    source: sourceSchema.optional(),
-}).strict().superRefine((manifest, ctx) => {
-    if ((manifest.dialect === 'jsx') !== (manifest.document === 'page.tsx'))
-        ctx.addIssue({ code: 'custom', path: ['document'], message: 'document must agree with dialect' });
-    if (manifest.dialect === 'html' && (manifest.steps !== 1 || manifest.slots.length !== 0))
-        ctx.addIssue({ code: 'custom', path: ['slots'], message: 'HTML pages have exactly one step and no slots' });
-});
-export const BUILTIN_PAGE_CONFIG_SCHEMAS = {
-    options: optionsConfigSchema,
-    text: textConfigSchema,
-    table: tableConfigSchema,
-    cards: cardsConfigSchema,
-    chart: chartConfigSchema,
-};
-export const BUILTIN_PAGE_RESPONSE_SCHEMAS = {
-    options: optionsResponseSchema,
-    text: textResponseSchema,
-    table: tableResponseSchema,
-    cards: cardsResponseSchema,
-};
-export function issueText(error) {
-    return error.issues.map((issue) => `${issue.path.length === 0 ? 'value' : issue.path.join('.')}: ${issue.message}`).join('; ');
-}
-/** Derive both overview facts from a manifest alone. Pure: no ticket state, no second read. */
-export function pageOverviewActions(manifest) {
-    const recommendedOptions = [];
-    for (const slot of manifest.slots) {
-        if (slot.kind !== 'options' || slot.id === undefined)
-            continue;
-        // Persisted manifests predate the one-recommendation rule, so take the first rather than assuming.
-        const option = slot.config.options.find((candidate) => candidate.recommended === true);
-        if (option !== undefined)
-            recommendedOptions.push({ slotId: slot.id, optionId: option.id, label: option.label });
-    }
-    // An inline page lives in the transcript, where there is no row to press.
-    if (manifest.delivery.placement !== 'panel')
-        return { recommendedOptions };
-    const answerable = manifest.slots.filter(isResponseBearingSlot);
-    // A notice settles on the empty map, which is exactly what Acknowledge publishes from the page.
-    if (answerable.length === 0)
-        return { recommendedOptions, fastAction: { kind: 'acknowledge', responses: {} } };
-    if (answerable.length > 1)
-        return { recommendedOptions };
-    const slot = answerable[0];
-    const recommendation = recommendedOptions.find((candidate) => candidate.slotId === slot.id);
-    if (slot.kind !== 'options' || recommendation === undefined)
-        return { recommendedOptions };
-    return {
-        recommendedOptions,
-        fastAction: { kind: 'answer', responses: { [slot.id]: { selectedOptionIds: [recommendation.optionId], comments: [] } } },
-    };
-}
-/** Whether this page is waiting on a person: it asks something, or an agent bridge is parked on its reply. */
-export function pageAwaitsResponse(manifest) {
-    return manifest.delivery.reply || manifest.slots.some(isResponseBearingSlot);
-}
-/** The canonical response-bearing predicate used by every page consumer. */
-export function isResponseBearingSlot(slot) {
-    if (slot.display === true)
-        return false;
-    if (slot.unvalidated === true)
-        return true;
-    if (slot.kind === 'options' || slot.kind === 'text' || slot.kind === 'cards')
-        return true;
-    if (slot.kind !== 'table')
-        return false;
-    const config = slot.config;
-    return (config.rowSelect ?? 'none') !== 'none' || (config.columnSelect ?? 'none') !== 'none';
-}
-function validateManifest(parsed, productComponents, authored) {
-    const manifest = rawPageManifestSchema.parse(parsed);
-    if (!authored && manifest.dialect === 'html')
-        return manifest;
-    const seen = new Set();
-    const slots = manifest.slots.map((raw, index) => {
-        if (raw.step >= manifest.steps)
-            throw new Error(`slot ${raw.id === undefined ? `#${index}` : `"${raw.id}"`} has step ${raw.step}, outside page steps ${manifest.steps}`);
-        let slot;
-        if (BUILTIN_PAGE_KINDS.includes(raw.kind)) {
-            if (raw.unvalidated === true)
-                throw new Error(`built-in slot kind "${raw.kind}" cannot be unvalidated`);
-            if (raw.display === true)
-                throw new Error(`built-in slot kind "${raw.kind}" cannot set display: true`);
-            const result = BUILTIN_PAGE_CONFIG_SCHEMAS[raw.kind].safeParse(raw.config);
-            if (!result.success)
-                throw new Error(`invalid config for slot ${raw.id === undefined ? `#${index}` : `"${raw.id}"`} (${raw.kind}): ${issueText(result.error)}`);
-            // Authoring-time only: persisted manifests predate this rule and must keep reading.
-            if (authored && raw.kind === 'options') {
-                const options = result.data;
-                const slotName = raw.id === undefined ? `#${index}` : `"${raw.id}"`;
-                if ((options.label ?? '').trim() === '')
-                    throw new Error(`slot ${slotName} (options): label is required — the question itself, drawn as the bold first line`);
-                if ((options.body ?? '').trim() === '')
-                    throw new Error(`slot ${slotName} (options): body is required — the context under the question a label cannot carry`);
-            }
-            slot = { ...(raw.id === undefined ? {} : { id: raw.id }), kind: raw.kind, step: raw.step, config: result.data };
-        }
-        else {
-            const component = productComponents === undefined ? undefined : productPageComponent(raw.kind, productComponents);
-            if (authored && component === undefined)
-                throw new Error(`unregistered page slot kind "${raw.kind}" at slot #${index}`);
-            if (raw.unvalidated !== true)
-                throw new Error(`registered page slot kind "${raw.kind}" must set unvalidated: true`);
-            if (!authored)
-                slot = { ...(raw.id === undefined ? {} : { id: raw.id }), kind: raw.kind, step: raw.step, config: raw.config, unvalidated: true, ...(raw.display === true ? { display: true } : {}) };
-            else {
-                if (raw.display === true && component?.display !== true)
-                    throw new Error(`non-display page slot kind "${raw.kind}" cannot set display: true`);
-                slot = { ...(raw.id === undefined ? {} : { id: raw.id }), kind: raw.kind, step: raw.step, config: raw.config, unvalidated: true, ...(component?.display === true ? { display: true } : {}) };
-            }
-        }
-        if (isResponseBearingSlot(slot) && slot.id === undefined) {
-            throw new Error(slot.unvalidated === true
-                ? `product slot kind "${slot.kind}" at slot #${index} requires an id prop`
-                : `response-bearing slot kind "${slot.kind}" at slot #${index} requires an id prop`);
-        }
-        if (slot.id !== undefined) {
-            if (seen.has(slot.id))
-                throw new Error(`duplicate slot id "${slot.id}"`);
-            seen.add(slot.id);
-        }
-        return slot;
-    });
-    return { ...manifest, slots };
-}
-/** Validate a persisted manifest. Publish-time validation made its slots authoritative, so reads do not resolve a component catalog. */
-export function validatePageManifest(parsed) {
-    return validateManifest(parsed, undefined, false);
-}
-/** Validate a manifest derived from an authored page, where the display flag comes from the registration rather than the source. */
-export function validateAuthoredPageManifest(parsed, productComponents = []) {
-    return validateManifest(parsed, productComponents, true);
-}
-export function createPageManifestSchema() {
-    return z.custom((value) => {
-        try {
-            validatePageManifest(value);
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }, { error: 'invalid page manifest' }).transform((value) => validatePageManifest(value));
-}
-export const pageManifestSchema = createPageManifestSchema();
-function assertUnique(values, slotId, field) {
-    if (new Set(values).size !== values.length)
-        throw new Error(`slot "${slotId}" has duplicate id in ${field}`);
-}
-function validateComments(slot, comments) {
-    const config = slot.config;
-    for (const comment of comments) {
-        const anchor = comment.anchor;
-        if (slot.kind === 'options' && anchor.kind === 'option') {
-            if (!config.options.some((option) => option.id === anchor.optionId))
-                throw new Error(`slot "${slot.id}" comment names unknown option id "${anchor.optionId}"`);
-            continue;
-        }
-        if (slot.kind === 'table' && anchor.kind === 'row') {
-            if (!(config.rows ?? []).some((row) => row.id === anchor.rowId))
-                throw new Error(`slot "${slot.id}" comment names unknown row id "${anchor.rowId}"`);
-            continue;
-        }
-        throw new Error(`slot "${slot.id}" does not allow comment anchor kind "${anchor.kind}"`);
-    }
-}
-/** A picker's minimum: authored `required` wins, else the mode's own reading of an empty answer. */
-export function optionsRequired(config) {
-    return config.required ?? config.mode === 'single';
-}
-function parseResponse(slot, raw) {
-    if (slot.unvalidated === true) {
-        const result = jsonObjectSchema.safeParse(raw);
-        if (!result.success)
-            throw new Error(`response for unvalidated slot "${slot.id}" must be an object`);
-        return result.data;
-    }
-    if (slot.kind === 'options') {
-        const result = optionsResponseSchema.safeParse(raw);
-        if (!result.success)
-            throw new Error(`invalid response for slot "${slot.id}": ${issueText(result.error)}`);
-        const response = result.data;
-        const config = slot.config;
-        assertUnique(response.selectedOptionIds, slot.id, 'selectedOptionIds');
-        for (const id of response.selectedOptionIds)
-            if (!config.options.some((option) => option.id === id))
-                throw new Error(`slot "${slot.id}" selects unknown option id "${id}"`);
-        if (response.freetext !== undefined && config.allowFreetext !== true)
-            throw new Error(`slot "${slot.id}" does not allow freetext`);
-        if (config.mode === 'single' && response.selectedOptionIds.length > 1)
-            throw new Error(`slot "${slot.id}" is single-select but received ${response.selectedOptionIds.length} option ids`);
-        const hasFreetext = config.allowFreetext === true && (response.freetext?.trim() ?? '') !== '';
-        if (optionsRequired(config)) {
-            if (config.mode === 'single' && response.selectedOptionIds.length !== 1 && !hasFreetext)
-                throw new Error(`single-select slot "${slot.id}" requires exactly one selection or nonempty allowed freetext`);
-            if (config.mode === 'multi' && response.selectedOptionIds.length === 0 && response.comments.length === 0 && !hasFreetext)
-                throw new Error(`multi-select slot "${slot.id}" requires a selection, comment, or nonempty allowed freetext`);
-        }
-        validateComments(slot, response.comments);
-        return response;
-    }
-    if (slot.kind === 'text') {
-        const result = textResponseSchema.safeParse(raw);
-        if (!result.success)
-            throw new Error(`invalid response for slot "${slot.id}": ${issueText(result.error)}`);
-        if (slot.config.required === true && result.data.text.trim() === '')
-            throw new Error(`slot "${slot.id}" is required and was left empty`);
-        return result.data;
-    }
-    if (slot.kind === 'table') {
-        const result = tableResponseSchema.safeParse(raw);
-        if (!result.success)
-            throw new Error(`invalid response for slot "${slot.id}": ${issueText(result.error)}`);
-        const response = result.data;
-        const config = slot.config;
-        assertUnique(response.selectedRowIds, slot.id, 'selectedRowIds');
-        assertUnique(response.selectedColumnIds, slot.id, 'selectedColumnIds');
-        const rowIds = new Set((config.rows ?? []).map((row) => row.id));
-        const columnIds = new Set(config.columns.map((column) => column.id));
-        for (const id of response.selectedRowIds)
-            if (!rowIds.has(id))
-                throw new Error(`slot "${slot.id}" selects unknown row id "${id}"`);
-        for (const id of response.selectedColumnIds)
-            if (!columnIds.has(id))
-                throw new Error(`slot "${slot.id}" selects unknown column id "${id}"`);
-        if (config.required === true && response.selectedRowIds.length === 0 && response.selectedColumnIds.length === 0)
-            throw new Error(`slot "${slot.id}" is required and nothing is selected`);
-        if ((config.rowSelect === 'none' && response.selectedRowIds.length > 0) || (config.rowSelect === 'single' && response.selectedRowIds.length > 1))
-            throw new Error(`slot "${slot.id}" response violates row select mode "${config.rowSelect}"`);
-        if ((config.columnSelect === 'none' && response.selectedColumnIds.length > 0) || (config.columnSelect === 'single' && response.selectedColumnIds.length > 1))
-            throw new Error(`slot "${slot.id}" response violates column select mode "${config.columnSelect}"`);
-        validateComments(slot, response.comments);
-        return response;
-    }
-    if (slot.kind === 'cards') {
-        const result = cardsResponseSchema.safeParse(raw);
-        if (!result.success)
-            throw new Error(`invalid response for slot "${slot.id}": ${issueText(result.error)}`);
-        const response = result.data;
-        const config = slot.config;
-        assertUnique(response.selectedCardIds, slot.id, 'selectedCardIds');
-        for (const id of response.selectedCardIds)
-            if (!(config.cards ?? []).some((card) => card.id === id))
-                throw new Error(`slot "${slot.id}" selects unknown card id "${id}"`);
-        if (config.mode === 'single' && response.selectedCardIds.length > 1)
-            throw new Error(`slot "${slot.id}" is single-select but received ${response.selectedCardIds.length} card ids`);
-        if (config.required === true && response.selectedCardIds.length === 0)
-            throw new Error(`slot "${slot.id}" is required and nothing is selected`);
-        return response;
-    }
-    throw new Error(`slot "${slot.id}" kind "${slot.kind}" does not accept a response`);
-}
-function validateResponses(manifest, raw, partial) {
-    const result = jsonObjectSchema.safeParse(raw);
-    if (!result.success)
-        throw new Error('page responses must be an object keyed by slot id');
-    const expected = new Map(manifest.slots.filter(isResponseBearingSlot).map((slot) => [slot.id, slot]));
-    const responses = {};
-    for (const [id, value] of Object.entries(result.data)) {
-        const slot = expected.get(id);
-        if (slot === undefined)
-            throw new Error(`response names unknown or non-response-bearing slot id "${id}"`);
-        responses[id] = parseResponse(slot, value);
-    }
-    if (!partial)
-        for (const id of expected.keys())
-            if (!(id in responses))
-                throw new Error(`final page response is missing response-bearing slot id "${id}"`);
-    return responses;
-}
-/** Validate a complete final response map. */
-export function validatePageResponses(manifest, responses) { return validateResponses(manifest, responses, false); }
-/** Validate an autosaved response map, permitting omitted response-bearing components. */
-export function validatePartialPageResponses(manifest, responses) { return validateResponses(manifest, responses, true); }
+var q=Object.defineProperty;var c=(t,o)=>q(t,"name",{value:o,configurable:!0});import{z as e}from"zod";import{BUILTIN_PAGE_KINDS as P,productPageComponent as A}from"./page-catalog.js";const O=/^[A-Za-z0-9_-]{1,64}$/,_=e.string().regex(O,{error:"slot id must match /^[A-Za-z0-9_-]{1,64}$/"}),p=e.string().min(1),k=e.enum(["none","single","multi"]),w=e.record(e.string(),e.unknown());function m(t,o,s){const i=new Set;t.forEach((r,d)=>{i.has(r.id)&&o.addIssue({code:"custom",path:[d,"id"],message:`duplicate ${s} id "${r.id}"`}),i.add(r.id)})}c(m,"uniqueIds");const M=e.discriminatedUnion("kind",[e.object({kind:e.literal("option"),optionId:p}).strict(),e.object({kind:e.literal("row"),rowId:p}).strict()]),x=e.object({id:e.string().min(1),anchor:M,text:e.string()}).strict(),N=e.object({id:p,label:e.string().min(1),description:e.string().optional(),recommended:e.boolean().optional()}).strict(),T=e.object({label:e.string().optional(),body:e.string().optional(),options:e.array(N).min(1).superRefine((t,o)=>m(t,o,"option")),mode:e.enum(["single","multi"]),required:e.boolean().optional(),allowFreetext:e.boolean().optional(),freetextLabel:e.string().optional(),freetextPlaceholder:e.string().optional()}).strict().superRefine((t,o)=>{const s=t.options.filter(i=>i.recommended===!0);s.length>1&&o.addIssue({code:"custom",path:["options"],message:`at most one option may be recommended, but ${s.length} are`})}),I=e.object({selectedOptionIds:e.array(p),comments:e.array(x),freetext:e.string().optional()}).strict(),F=e.object({label:e.string().optional(),initialText:e.string(),placeholder:e.string().optional(),singleLine:e.boolean().optional(),required:e.boolean().optional()}).strict(),S=e.object({text:e.string(),edited:e.boolean()}).strict(),L=e.object({id:p,label:e.string().min(1),align:e.enum(["left","right"]).optional(),mono:e.boolean().optional()}).strict(),B=e.union([e.string(),e.number(),e.boolean(),e.null()]),G=e.object({id:p,cells:e.record(e.string(),B)}).strict(),U=e.array(G).superRefine((t,o)=>m(t,o,"row")),z={label:e.string().optional(),body:e.string().optional(),columns:e.array(L).min(1).superRefine((t,o)=>m(t,o,"column")),rows:U.optional(),rowSelect:k.default("none"),columnSelect:k.default("none"),required:e.boolean().optional()},D=e.object(z).strict(),y=e.object({selectedRowIds:e.array(p),selectedColumnIds:e.array(p),comments:e.array(x)}).strict(),H=e.object({id:p,title:e.string().min(1),subtitle:e.string().optional(),body:e.string().optional(),tag:e.string().optional()}).strict(),Z=e.array(H).superRefine((t,o)=>m(t,o,"card")),K={label:e.string().optional(),body:e.string().optional(),cards:Z.optional(),mode:e.enum(["single","multi"]),columns:e.union([e.literal(2),e.literal(3)]).optional(),required:e.boolean().optional()},J=e.object(K).strict(),E=e.object({selectedCardIds:e.array(p)}).strict(),Q=e.object({field:e.string().min(1),label:e.string().optional()}).strict(),V=e.array(e.record(e.string(),e.unknown())),W={kind:e.enum(["line","bar","area"]),x:e.string().min(1),y:e.array(Q).min(1),title:e.string().optional(),data:V.optional()},X=e.object(W).strict(),Y=e.object({sessionName:e.string().optional(),askedBy:e.string().optional(),emittedAt:e.string().datetime({offset:!0}).optional(),profileName:e.string().optional(),nodeId:e.string().optional()}).strict(),ee=e.object({placement:e.enum(["inline","panel"]),inbox:e.boolean(),reply:e.boolean()}).strict(),te=e.object({id:_.optional(),kind:e.string().min(1),step:e.number().int().nonnegative(),config:w,unvalidated:e.literal(!0).optional(),display:e.literal(!0).optional()}).strict(),ne=e.object({schema:e.literal("crtr.page/v2"),dialect:e.enum(["jsx","html"]),title:e.string().trim().min(1),subtitle:e.string().optional(),delivery:ee,document:e.enum(["page.tsx","page.html"]),steps:e.number().int().positive(),slots:e.array(te),source:Y.optional()}).strict().superRefine((t,o)=>{t.dialect==="jsx"!=(t.document==="page.tsx")&&o.addIssue({code:"custom",path:["document"],message:"document must agree with dialect"}),t.dialect==="html"&&(t.steps!==1||t.slots.length!==0)&&o.addIssue({code:"custom",path:["slots"],message:"HTML pages have exactly one step and no slots"})}),oe={options:T,text:F,table:D,cards:J,chart:X},le={options:I,text:S,table:y,cards:E};function f(t){return t.issues.map(o=>`${o.path.length===0?"value":o.path.join(".")}: ${o.message}`).join("; ")}c(f,"issueText");function pe(t){const o=[];for(const d of t.slots){if(d.kind!=="options"||d.id===void 0)continue;const n=d.config.options.find(a=>a.recommended===!0);n!==void 0&&o.push({slotId:d.id,optionId:n.id,label:n.label})}if(t.delivery.placement!=="panel")return{recommendedOptions:o};const s=t.slots.filter(g);if(s.length===0)return{recommendedOptions:o,fastAction:{kind:"acknowledge",responses:{}}};if(s.length>1)return{recommendedOptions:o};const i=s[0],r=o.find(d=>d.slotId===i.id);return i.kind!=="options"||r===void 0?{recommendedOptions:o}:{recommendedOptions:o,fastAction:{kind:"answer",responses:{[i.id]:{selectedOptionIds:[r.optionId],comments:[]}}}}}c(pe,"pageOverviewActions");function ue(t){return t.delivery.reply||t.slots.some(g)}c(ue,"pageAwaitsResponse");function g(t){if(t.display===!0)return!1;if(t.unvalidated===!0||t.kind==="options"||t.kind==="text"||t.kind==="cards")return!0;if(t.kind!=="table")return!1;const o=t.config;return(o.rowSelect??"none")!=="none"||(o.columnSelect??"none")!=="none"}c(g,"isResponseBearingSlot");function v(t,o,s){const i=ne.parse(t);if(!s&&i.dialect==="html")return i;const r=new Set,d=i.slots.map((n,a)=>{if(n.step>=i.steps)throw new Error(`slot ${n.id===void 0?`#${a}`:`"${n.id}"`} has step ${n.step}, outside page steps ${i.steps}`);let l;if(P.includes(n.kind)){if(n.unvalidated===!0)throw new Error(`built-in slot kind "${n.kind}" cannot be unvalidated`);if(n.display===!0)throw new Error(`built-in slot kind "${n.kind}" cannot set display: true`);const u=oe[n.kind].safeParse(n.config);if(!u.success)throw new Error(`invalid config for slot ${n.id===void 0?`#${a}`:`"${n.id}"`} (${n.kind}): ${f(u.error)}`);if(s&&n.kind==="options"){const b=u.data,$=n.id===void 0?`#${a}`:`"${n.id}"`;if((b.label??"").trim()==="")throw new Error(`slot ${$} (options): label is required \u2014 the question itself, drawn as the bold first line`);if((b.body??"").trim()==="")throw new Error(`slot ${$} (options): body is required \u2014 the context under the question a label cannot carry`)}l={...n.id===void 0?{}:{id:n.id},kind:n.kind,step:n.step,config:u.data}}else{const u=o===void 0?void 0:A(n.kind,o);if(s&&u===void 0)throw new Error(`unregistered page slot kind "${n.kind}" at slot #${a}`);if(n.unvalidated!==!0)throw new Error(`registered page slot kind "${n.kind}" must set unvalidated: true`);if(!s)l={...n.id===void 0?{}:{id:n.id},kind:n.kind,step:n.step,config:n.config,unvalidated:!0,...n.display===!0?{display:!0}:{}};else{if(n.display===!0&&u?.display!==!0)throw new Error(`non-display page slot kind "${n.kind}" cannot set display: true`);l={...n.id===void 0?{}:{id:n.id},kind:n.kind,step:n.step,config:n.config,unvalidated:!0,...u?.display===!0?{display:!0}:{}}}}if(g(l)&&l.id===void 0)throw new Error(l.unvalidated===!0?`product slot kind "${l.kind}" at slot #${a} requires an id prop`:`response-bearing slot kind "${l.kind}" at slot #${a} requires an id prop`);if(l.id!==void 0){if(r.has(l.id))throw new Error(`duplicate slot id "${l.id}"`);r.add(l.id)}return l});return{...i,slots:d}}c(v,"validateManifest");function j(t){return v(t,void 0,!1)}c(j,"validatePageManifest");function fe(t,o=[]){return v(t,o,!0)}c(fe,"validateAuthoredPageManifest");function ie(){return e.custom(t=>{try{return j(t),!0}catch{return!1}},{error:"invalid page manifest"}).transform(t=>j(t))}c(ie,"createPageManifestSchema");const me=ie();function h(t,o,s){if(new Set(t).size!==t.length)throw new Error(`slot "${o}" has duplicate id in ${s}`)}c(h,"assertUnique");function C(t,o){const s=t.config;for(const i of o){const r=i.anchor;if(t.kind==="options"&&r.kind==="option"){if(!s.options.some(d=>d.id===r.optionId))throw new Error(`slot "${t.id}" comment names unknown option id "${r.optionId}"`);continue}if(t.kind==="table"&&r.kind==="row"){if(!(s.rows??[]).some(d=>d.id===r.rowId))throw new Error(`slot "${t.id}" comment names unknown row id "${r.rowId}"`);continue}throw new Error(`slot "${t.id}" does not allow comment anchor kind "${r.kind}"`)}}c(C,"validateComments");function re(t){return t.required??t.mode==="single"}c(re,"optionsRequired");function se(t,o){if(t.unvalidated===!0){const s=w.safeParse(o);if(!s.success)throw new Error(`response for unvalidated slot "${t.id}" must be an object`);return s.data}if(t.kind==="options"){const s=I.safeParse(o);if(!s.success)throw new Error(`invalid response for slot "${t.id}": ${f(s.error)}`);const i=s.data,r=t.config;h(i.selectedOptionIds,t.id,"selectedOptionIds");for(const n of i.selectedOptionIds)if(!r.options.some(a=>a.id===n))throw new Error(`slot "${t.id}" selects unknown option id "${n}"`);if(i.freetext!==void 0&&r.allowFreetext!==!0)throw new Error(`slot "${t.id}" does not allow freetext`);if(r.mode==="single"&&i.selectedOptionIds.length>1)throw new Error(`slot "${t.id}" is single-select but received ${i.selectedOptionIds.length} option ids`);const d=r.allowFreetext===!0&&(i.freetext?.trim()??"")!=="";if(re(r)){if(r.mode==="single"&&i.selectedOptionIds.length!==1&&!d)throw new Error(`single-select slot "${t.id}" requires exactly one selection or nonempty allowed freetext`);if(r.mode==="multi"&&i.selectedOptionIds.length===0&&i.comments.length===0&&!d)throw new Error(`multi-select slot "${t.id}" requires a selection, comment, or nonempty allowed freetext`)}return C(t,i.comments),i}if(t.kind==="text"){const s=S.safeParse(o);if(!s.success)throw new Error(`invalid response for slot "${t.id}": ${f(s.error)}`);if(t.config.required===!0&&s.data.text.trim()==="")throw new Error(`slot "${t.id}" is required and was left empty`);return s.data}if(t.kind==="table"){const s=y.safeParse(o);if(!s.success)throw new Error(`invalid response for slot "${t.id}": ${f(s.error)}`);const i=s.data,r=t.config;h(i.selectedRowIds,t.id,"selectedRowIds"),h(i.selectedColumnIds,t.id,"selectedColumnIds");const d=new Set((r.rows??[]).map(a=>a.id)),n=new Set(r.columns.map(a=>a.id));for(const a of i.selectedRowIds)if(!d.has(a))throw new Error(`slot "${t.id}" selects unknown row id "${a}"`);for(const a of i.selectedColumnIds)if(!n.has(a))throw new Error(`slot "${t.id}" selects unknown column id "${a}"`);if(r.required===!0&&i.selectedRowIds.length===0&&i.selectedColumnIds.length===0)throw new Error(`slot "${t.id}" is required and nothing is selected`);if(r.rowSelect==="none"&&i.selectedRowIds.length>0||r.rowSelect==="single"&&i.selectedRowIds.length>1)throw new Error(`slot "${t.id}" response violates row select mode "${r.rowSelect}"`);if(r.columnSelect==="none"&&i.selectedColumnIds.length>0||r.columnSelect==="single"&&i.selectedColumnIds.length>1)throw new Error(`slot "${t.id}" response violates column select mode "${r.columnSelect}"`);return C(t,i.comments),i}if(t.kind==="cards"){const s=E.safeParse(o);if(!s.success)throw new Error(`invalid response for slot "${t.id}": ${f(s.error)}`);const i=s.data,r=t.config;h(i.selectedCardIds,t.id,"selectedCardIds");for(const d of i.selectedCardIds)if(!(r.cards??[]).some(n=>n.id===d))throw new Error(`slot "${t.id}" selects unknown card id "${d}"`);if(r.mode==="single"&&i.selectedCardIds.length>1)throw new Error(`slot "${t.id}" is single-select but received ${i.selectedCardIds.length} card ids`);if(r.required===!0&&i.selectedCardIds.length===0)throw new Error(`slot "${t.id}" is required and nothing is selected`);return i}throw new Error(`slot "${t.id}" kind "${t.kind}" does not accept a response`)}c(se,"parseResponse");function R(t,o,s){const i=w.safeParse(o);if(!i.success)throw new Error("page responses must be an object keyed by slot id");const r=new Map(t.slots.filter(g).map(n=>[n.id,n])),d={};for(const[n,a]of Object.entries(i.data)){const l=r.get(n);if(l===void 0)throw new Error(`response names unknown or non-response-bearing slot id "${n}"`);d[n]=se(l,a)}if(!s){for(const n of r.keys())if(!(n in d))throw new Error(`final page response is missing response-bearing slot id "${n}"`)}return d}c(R,"validateResponses");function ge(t,o){return R(t,o,!1)}c(ge,"validatePageResponses");function he(t,o){return R(t,o,!0)}c(he,"validatePartialPageResponses");export{oe as BUILTIN_PAGE_CONFIG_SCHEMAS,le as BUILTIN_PAGE_RESPONSE_SCHEMAS,O as PAGE_SLOT_ID_PATTERN,H as cardSchema,J as cardsConfigSchema,E as cardsResponseSchema,Z as cardsSchema,X as chartConfigSchema,V as chartDataRowsSchema,Q as chartSeriesSchema,x as commentSchema,ie as createPageManifestSchema,g as isResponseBearingSlot,f as issueText,N as optionSchema,T as optionsConfigSchema,re as optionsRequired,I as optionsResponseSchema,ue as pageAwaitsResponse,M as pageCommentAnchorSchema,ee as pageDeliverySchema,me as pageManifestSchema,pe as pageOverviewActions,B as tableCellSchema,L as tableColumnSchema,D as tableConfigSchema,y as tableResponseSchema,G as tableRowSchema,U as tableRowsSchema,F as textConfigSchema,S as textResponseSchema,fe as validateAuthoredPageManifest,j as validatePageManifest,ge as validatePageResponses,he as validatePartialPageResponses};

package/dist/core/human/page-synth.js

@@ -1,30 +1,11 @@
-import { join } from 'node:path';
-import { mkdtempSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-/** Text reaches JSX as a string expression, so arbitrary bytes need no markup escaping. */
-function jsxText(value) { return `{${JSON.stringify(value)}}`; }
-function bodyJsx(body) {
-    if (body === '')
-        return '';
-    const lines = body.replace(/\r\n/g, '\n').split('\n');
-    return `      <p className="whitespace-pre-wrap">${lines.map(jsxText).join('<br />')}</p>\n`;
-}
-/** Build a complete TSX page from title, subtitle, and body for internal producers. */
-export function synthesizedPageDocument(title, subtitle, body, responseBearing) {
-    const interactive = responseBearing ? `      <UserText id="response" initialText="" />\n` : '';
-    const subtitleProp = subtitle === '' ? '' : ` subtitle=${jsxText(subtitle)}`;
-    return `export default function SynthesizedPage() {
+var a=Object.defineProperty;var n=(e,t)=>a(e,"name",{value:t,configurable:!0});import{join as o}from"node:path";import{mkdtempSync as u,writeFileSync as m}from"node:fs";import{tmpdir as f}from"node:os";function i(e){return`{${JSON.stringify(e)}}`}n(i,"jsxText");function d(e){return e===""?"":`      <p className="whitespace-pre-wrap">${e.replace(/\r\n/g,`
+`).split(`
+`).map(i).join("<br />")}</p>
+`}n(d,"bodyJsx");function h(e,t,r,s){const p=s?`      <UserText id="response" initialText="" />
+`:"",c=t===""?"":` subtitle=${i(t)}`;return`export default function SynthesizedPage() {
   return (
-    <Page title=${jsxText(title)}${subtitleProp}>
-${bodyJsx(body)}${interactive}    </Page>
+    <Page title=${i(e)}${c}>
+${d(r)}${p}    </Page>
   );
 }
-`;
-}
-/** Materialize an internally generated document into a private temp dir; the caller removes it after submission. */
-export function writeSynthesizedPage(document) {
-    const dir = mkdtempSync(join(tmpdir(), 'crtr-human-page-'));
-    const path = join(dir, 'page.tsx');
-    writeFileSync(path, document, { encoding: 'utf8', mode: 0o600 });
-    return { dir, path };
-}
+`}n(h,"synthesizedPageDocument");function y(e){const t=u(o(f(),"crtr-human-page-")),r=o(t,"page.tsx");return m(r,e,{encoding:"utf8",mode:384}),{dir:t,path:r}}n(y,"writeSynthesizedPage");export{h as synthesizedPageDocument,y as writeSynthesizedPage};