pretext-pdf 1.9.0 → 2.0.2

package/dist/schema.d.ts

@@ -19,7 +19,7 @@ export declare const pdfDocumentSchema: {
             readonly type: "array";
             readonly description: "Document content elements rendered top-to-bottom.";
             readonly items: {
-                readonly anyOf: readonly [{
+                readonly oneOf: readonly [{
                     readonly type: "object";
                     readonly required: readonly ["type", "text"];
                     readonly properties: {
@@ -265,21 +265,13 @@ export declare const pdfDocumentSchema: {
                             readonly pattern: "^#[0-9A-Fa-f]{6}$";
                             readonly description: "6-digit hex color e.g. #FF0000";
                         };
-                        readonly spaceAbove: {
-                            readonly type: "number";
-                            readonly description: "Space above line in pt. Default: 12. Primary field.";
-                        };
-                        readonly spaceBelow: {
-                            readonly type: "number";
-                            readonly description: "Space below line in pt. Default: 12. Primary field.";
-                        };
                         readonly spaceBefore: {
                             readonly type: "number";
-                            readonly description: "Alias for spaceAbove (primary).";
+                            readonly description: "Space above line in pt. Default: 12.";
                         };
                         readonly spaceAfter: {
                             readonly type: "number";
-                            readonly description: "Alias for spaceBelow (primary).";
+                            readonly description: "Space below line in pt. Default: 12.";
                         };
                     };
                 }, {
@@ -1249,91 +1241,345 @@ export declare const pdfDocumentSchema: {
                 }, {
                     readonly type: "object";
                     readonly required: readonly ["type", "fieldType", "name"];
-                    readonly properties: {
-                        readonly type: {
-                            readonly type: "string";
-                            readonly const: "form-field";
-                        };
-                        readonly fieldType: {
-                            readonly type: "string";
-                            readonly enum: readonly ["text", "checkbox", "radio", "dropdown", "button"];
-                        };
-                        readonly name: {
-                            readonly type: "string";
-                        };
-                        readonly label: {
-                            readonly type: "string";
-                        };
-                        readonly placeholder: {
-                            readonly type: "string";
-                        };
-                        readonly defaultValue: {
-                            readonly type: "string";
-                        };
-                        readonly multiline: {
-                            readonly type: "boolean";
-                        };
-                        readonly maxLength: {
-                            readonly type: "number";
+                    readonly oneOf: readonly [{
+                        readonly description: "Single-line or multi-line text input.";
+                        readonly properties: {
+                            readonly fieldType: {
+                                readonly type: "string";
+                                readonly const: "text";
+                            };
+                            readonly placeholder: {
+                                readonly type: "string";
+                            };
+                            readonly defaultValue: {
+                                readonly type: "string";
+                            };
+                            readonly multiline: {
+                                readonly type: "boolean";
+                            };
+                            readonly maxLength: {
+                                readonly type: "number";
+                                readonly minimum: 1;
+                            };
+                            readonly type: {
+                                readonly type: "string";
+                                readonly const: "form-field";
+                            };
+                            readonly name: {
+                                readonly type: "string";
+                                readonly description: "Unique field name used in PDF AcroForm dictionary.";
+                            };
+                            readonly label: {
+                                readonly type: "string";
+                            };
+                            readonly width: {
+                                readonly type: "number";
+                            };
+                            readonly height: {
+                                readonly type: "number";
+                            };
+                            readonly fontSize: {
+                                readonly type: "number";
+                            };
+                            readonly borderColor: {
+                                readonly type: "string";
+                                readonly pattern: "^#[0-9A-Fa-f]{6}$";
+                                readonly description: "6-digit hex color e.g. #FF0000";
+                            };
+                            readonly backgroundColor: {
+                                readonly type: "string";
+                                readonly pattern: "^#[0-9A-Fa-f]{6}$";
+                                readonly description: "6-digit hex color e.g. #FF0000";
+                            };
+                            readonly keepTogether: {
+                                readonly type: "boolean";
+                                readonly description: "If true, never break this element across pages. Default: true";
+                            };
+                            readonly spaceAfter: {
+                                readonly type: "number";
+                                readonly description: "Space in points (pt)";
+                            };
+                            readonly spaceBefore: {
+                                readonly type: "number";
+                                readonly description: "Space in points (pt)";
+                            };
+                            readonly accessibilityLabel: {
+                                readonly type: "string";
+                                readonly description: "Written to the PDF /TU AcroForm annotation entry for screen-reader announcements.";
+                            };
                         };
-                        readonly checked: {
-                            readonly type: "boolean";
+                        readonly required: readonly ["type", "fieldType", "name"];
+                    }, {
+                        readonly description: "Boolean on/off checkbox.";
+                        readonly properties: {
+                            readonly fieldType: {
+                                readonly type: "string";
+                                readonly const: "checkbox";
+                            };
+                            readonly checked: {
+                                readonly type: "boolean";
+                                readonly description: "Initial checked state. Default: false.";
+                            };
+                            readonly type: {
+                                readonly type: "string";
+                                readonly const: "form-field";
+                            };
+                            readonly name: {
+                                readonly type: "string";
+                                readonly description: "Unique field name used in PDF AcroForm dictionary.";
+                            };
+                            readonly label: {
+                                readonly type: "string";
+                            };
+                            readonly width: {
+                                readonly type: "number";
+                            };
+                            readonly height: {
+                                readonly type: "number";
+                            };
+                            readonly fontSize: {
+                                readonly type: "number";
+                            };
+                            readonly borderColor: {
+                                readonly type: "string";
+                                readonly pattern: "^#[0-9A-Fa-f]{6}$";
+                                readonly description: "6-digit hex color e.g. #FF0000";
+                            };
+                            readonly backgroundColor: {
+                                readonly type: "string";
+                                readonly pattern: "^#[0-9A-Fa-f]{6}$";
+                                readonly description: "6-digit hex color e.g. #FF0000";
+                            };
+                            readonly keepTogether: {
+                                readonly type: "boolean";
+                                readonly description: "If true, never break this element across pages. Default: true";
+                            };
+                            readonly spaceAfter: {
+                                readonly type: "number";
+                                readonly description: "Space in points (pt)";
+                            };
+                            readonly spaceBefore: {
+                                readonly type: "number";
+                                readonly description: "Space in points (pt)";
+                            };
+                            readonly accessibilityLabel: {
+                                readonly type: "string";
+                                readonly description: "Written to the PDF /TU AcroForm annotation entry for screen-reader announcements.";
+                            };
                         };
-                        readonly options: {
-                            readonly type: "array";
-                            readonly items: {
-                                readonly type: "object";
-                                readonly required: readonly ["value", "label"];
-                                readonly properties: {
-                                    readonly value: {
-                                        readonly type: "string";
-                                    };
-                                    readonly label: {
-                                        readonly type: "string";
+                        readonly required: readonly ["type", "fieldType", "name"];
+                    }, {
+                        readonly description: "Radio button group — exactly one option is selectable.";
+                        readonly properties: {
+                            readonly fieldType: {
+                                readonly type: "string";
+                                readonly const: "radio";
+                            };
+                            readonly options: {
+                                readonly type: "array";
+                                readonly minItems: 1;
+                                readonly items: {
+                                    readonly type: "object";
+                                    readonly required: readonly ["value", "label"];
+                                    readonly properties: {
+                                        readonly value: {
+                                            readonly type: "string";
+                                            readonly minLength: 1;
+                                        };
+                                        readonly label: {
+                                            readonly type: "string";
+                                            readonly minLength: 1;
+                                        };
                                     };
+                                    readonly additionalProperties: false;
                                 };
                             };
+                            readonly defaultSelected: {
+                                readonly type: "string";
+                                readonly description: "value of the pre-selected option.";
+                            };
+                            readonly type: {
+                                readonly type: "string";
+                                readonly const: "form-field";
+                            };
+                            readonly name: {
+                                readonly type: "string";
+                                readonly description: "Unique field name used in PDF AcroForm dictionary.";
+                            };
+                            readonly label: {
+                                readonly type: "string";
+                            };
+                            readonly width: {
+                                readonly type: "number";
+                            };
+                            readonly height: {
+                                readonly type: "number";
+                            };
+                            readonly fontSize: {
+                                readonly type: "number";
+                            };
+                            readonly borderColor: {
+                                readonly type: "string";
+                                readonly pattern: "^#[0-9A-Fa-f]{6}$";
+                                readonly description: "6-digit hex color e.g. #FF0000";
+                            };
+                            readonly backgroundColor: {
+                                readonly type: "string";
+                                readonly pattern: "^#[0-9A-Fa-f]{6}$";
+                                readonly description: "6-digit hex color e.g. #FF0000";
+                            };
+                            readonly keepTogether: {
+                                readonly type: "boolean";
+                                readonly description: "If true, never break this element across pages. Default: true";
+                            };
+                            readonly spaceAfter: {
+                                readonly type: "number";
+                                readonly description: "Space in points (pt)";
+                            };
+                            readonly spaceBefore: {
+                                readonly type: "number";
+                                readonly description: "Space in points (pt)";
+                            };
+                            readonly accessibilityLabel: {
+                                readonly type: "string";
+                                readonly description: "Written to the PDF /TU AcroForm annotation entry for screen-reader announcements.";
+                            };
                         };
-                        readonly width: {
-                            readonly type: "number";
-                        };
-                        readonly height: {
-                            readonly type: "number";
-                        };
-                        readonly fontSize: {
-                            readonly type: "number";
-                        };
-                        readonly borderColor: {
-                            readonly type: "string";
-                            readonly pattern: "^#[0-9A-Fa-f]{6}$";
-                            readonly description: "6-digit hex color e.g. #FF0000";
-                        };
-                        readonly backgroundColor: {
-                            readonly type: "string";
-                            readonly pattern: "^#[0-9A-Fa-f]{6}$";
-                            readonly description: "6-digit hex color e.g. #FF0000";
-                        };
-                        readonly defaultSelected: {
-                            readonly type: "string";
-                            readonly description: "Pre-selected value for radio groups and dropdowns.";
-                        };
-                        readonly keepTogether: {
-                            readonly type: "boolean";
-                            readonly description: "If true, never break this element across pages. Default: true";
-                        };
-                        readonly spaceAfter: {
-                            readonly type: "number";
-                            readonly description: "Space in points (pt)";
-                        };
-                        readonly spaceBefore: {
-                            readonly type: "number";
-                            readonly description: "Space in points (pt)";
+                        readonly required: readonly ["type", "fieldType", "name", "options"];
+                    }, {
+                        readonly description: "Dropdown / select list — exactly one option is selectable.";
+                        readonly properties: {
+                            readonly fieldType: {
+                                readonly type: "string";
+                                readonly const: "dropdown";
+                            };
+                            readonly options: {
+                                readonly type: "array";
+                                readonly minItems: 1;
+                                readonly items: {
+                                    readonly type: "object";
+                                    readonly required: readonly ["value", "label"];
+                                    readonly properties: {
+                                        readonly value: {
+                                            readonly type: "string";
+                                            readonly minLength: 1;
+                                        };
+                                        readonly label: {
+                                            readonly type: "string";
+                                            readonly minLength: 1;
+                                        };
+                                    };
+                                    readonly additionalProperties: false;
+                                };
+                            };
+                            readonly defaultSelected: {
+                                readonly type: "string";
+                                readonly description: "value of the pre-selected option.";
+                            };
+                            readonly type: {
+                                readonly type: "string";
+                                readonly const: "form-field";
+                            };
+                            readonly name: {
+                                readonly type: "string";
+                                readonly description: "Unique field name used in PDF AcroForm dictionary.";
+                            };
+                            readonly label: {
+                                readonly type: "string";
+                            };
+                            readonly width: {
+                                readonly type: "number";
+                            };
+                            readonly height: {
+                                readonly type: "number";
+                            };
+                            readonly fontSize: {
+                                readonly type: "number";
+                            };
+                            readonly borderColor: {
+                                readonly type: "string";
+                                readonly pattern: "^#[0-9A-Fa-f]{6}$";
+                                readonly description: "6-digit hex color e.g. #FF0000";
+                            };
+                            readonly backgroundColor: {
+                                readonly type: "string";
+                                readonly pattern: "^#[0-9A-Fa-f]{6}$";
+                                readonly description: "6-digit hex color e.g. #FF0000";
+                            };
+                            readonly keepTogether: {
+                                readonly type: "boolean";
+                                readonly description: "If true, never break this element across pages. Default: true";
+                            };
+                            readonly spaceAfter: {
+                                readonly type: "number";
+                                readonly description: "Space in points (pt)";
+                            };
+                            readonly spaceBefore: {
+                                readonly type: "number";
+                                readonly description: "Space in points (pt)";
+                            };
+                            readonly accessibilityLabel: {
+                                readonly type: "string";
+                                readonly description: "Written to the PDF /TU AcroForm annotation entry for screen-reader announcements.";
+                            };
                         };
-                        readonly accessibilityLabel: {
-                            readonly type: "string";
-                            readonly description: "Accessible label for screen-reader announcements (v1.8+). Stored but has no render-time effect in v1.x.";
+                        readonly required: readonly ["type", "fieldType", "name", "options"];
+                    }, {
+                        readonly description: "Clickable push-button (no value submitted).";
+                        readonly properties: {
+                            readonly fieldType: {
+                                readonly type: "string";
+                                readonly const: "button";
+                            };
+                            readonly type: {
+                                readonly type: "string";
+                                readonly const: "form-field";
+                            };
+                            readonly name: {
+                                readonly type: "string";
+                                readonly description: "Unique field name used in PDF AcroForm dictionary.";
+                            };
+                            readonly label: {
+                                readonly type: "string";
+                            };
+                            readonly width: {
+                                readonly type: "number";
+                            };
+                            readonly height: {
+                                readonly type: "number";
+                            };
+                            readonly fontSize: {
+                                readonly type: "number";
+                            };
+                            readonly borderColor: {
+                                readonly type: "string";
+                                readonly pattern: "^#[0-9A-Fa-f]{6}$";
+                                readonly description: "6-digit hex color e.g. #FF0000";
+                            };
+                            readonly backgroundColor: {
+                                readonly type: "string";
+                                readonly pattern: "^#[0-9A-Fa-f]{6}$";
+                                readonly description: "6-digit hex color e.g. #FF0000";
+                            };
+                            readonly keepTogether: {
+                                readonly type: "boolean";
+                                readonly description: "If true, never break this element across pages. Default: true";
+                            };
+                            readonly spaceAfter: {
+                                readonly type: "number";
+                                readonly description: "Space in points (pt)";
+                            };
+                            readonly spaceBefore: {
+                                readonly type: "number";
+                                readonly description: "Space in points (pt)";
+                            };
+                            readonly accessibilityLabel: {
+                                readonly type: "string";
+                                readonly description: "Written to the PDF /TU AcroForm annotation entry for screen-reader announcements.";
+                            };
                         };
-                    };
+                        readonly required: readonly ["type", "fieldType", "name"];
+                    }];
                 }, {
                     readonly type: "object";
                     readonly required: readonly ["type", "image", "float", "content"];
@@ -1874,5 +2120,6 @@ export declare const pdfDocumentSchema: {
             readonly description: "Restrict filesystem access to these absolute directory paths.";
         };
     };
+    readonly additionalProperties: false;
 };
 //# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA6iBH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuRc,CAAA"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmmBH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8Rc,CAAA"}

package/dist/schema.js

@@ -129,10 +129,8 @@ const hrSchema = {
         type: { type: 'string', const: 'hr' },
         thickness: { type: 'number' },
         color: colorSchema,
-        spaceAbove: { type: 'number', description: 'Space above line in pt. Default: 12. Primary field.' },
-        spaceBelow: { type: 'number', description: 'Space below line in pt. Default: 12. Primary field.' },
-        spaceBefore: { type: 'number', description: 'Alias for spaceAbove (primary).' },
-        spaceAfter: { type: 'number', description: 'Alias for spaceBelow (primary).' },
+        spaceBefore: { type: 'number', description: 'Space above line in pt. Default: 12.' },
+        spaceAfter: { type: 'number', description: 'Space below line in pt. Default: 12.' },
     },
 };
 const pageBreakSchema = {
@@ -460,41 +458,95 @@ const commentSchema = {
         spaceAfter: spaceSchema,
     },
 };
+/** Shared base properties present on every FormFieldElement variant. */
+const formFieldBaseProperties = {
+    type: { type: 'string', const: 'form-field' },
+    name: { type: 'string', description: 'Unique field name used in PDF AcroForm dictionary.' },
+    label: { type: 'string' },
+    width: { type: 'number' },
+    height: { type: 'number' },
+    fontSize: { type: 'number' },
+    borderColor: colorSchema,
+    backgroundColor: colorSchema,
+    keepTogether: { type: 'boolean', description: 'If true, never break this element across pages. Default: true' },
+    spaceAfter: spaceSchema,
+    spaceBefore: spaceSchema,
+    accessibilityLabel: { type: 'string', description: 'Written to the PDF /TU AcroForm annotation entry for screen-reader announcements.' },
+};
+/** Shared options array used by radio and dropdown variants. */
+const formFieldOptionsSchema = {
+    type: 'array',
+    minItems: 1,
+    items: {
+        type: 'object',
+        required: ['value', 'label'],
+        properties: {
+            value: { type: 'string', minLength: 1 },
+            label: { type: 'string', minLength: 1 },
+        },
+        additionalProperties: false,
+    },
+};
+/**
+ * Discriminated-union schema for form-field elements.
+ * The `fieldType` property is the discriminant; each oneOf branch constrains
+ * the allowed properties to the specific variant so AI agents and schema
+ * validators get accurate narrowed feedback.
+ */
 const formFieldSchema = {
     type: 'object',
     required: ['type', 'fieldType', 'name'],
-    properties: {
-        type: { type: 'string', const: 'form-field' },
-        fieldType: { type: 'string', enum: ['text', 'checkbox', 'radio', 'dropdown', 'button'] },
-        name: { type: 'string' },
-        label: { type: 'string' },
-        placeholder: { type: 'string' },
-        defaultValue: { type: 'string' },
-        multiline: { type: 'boolean' },
-        maxLength: { type: 'number' },
-        checked: { type: 'boolean' },
-        options: {
-            type: 'array',
-            items: {
-                type: 'object',
-                required: ['value', 'label'],
-                properties: {
-                    value: { type: 'string' },
-                    label: { type: 'string' },
-                },
+    oneOf: [
+        {
+            description: 'Single-line or multi-line text input.',
+            properties: {
+                ...formFieldBaseProperties,
+                fieldType: { type: 'string', const: 'text' },
+                placeholder: { type: 'string' },
+                defaultValue: { type: 'string' },
+                multiline: { type: 'boolean' },
+                maxLength: { type: 'number', minimum: 1 },
             },
+            required: ['type', 'fieldType', 'name'],
         },
-        width: { type: 'number' },
-        height: { type: 'number' },
-        fontSize: { type: 'number' },
-        borderColor: colorSchema,
-        backgroundColor: colorSchema,
-        defaultSelected: { type: 'string', description: 'Pre-selected value for radio groups and dropdowns.' },
-        keepTogether: { type: 'boolean', description: 'If true, never break this element across pages. Default: true' },
-        spaceAfter: spaceSchema,
-        spaceBefore: spaceSchema,
-        accessibilityLabel: { type: 'string', description: 'Accessible label for screen-reader announcements (v1.8+). Stored but has no render-time effect in v1.x.' },
-    },
+        {
+            description: 'Boolean on/off checkbox.',
+            properties: {
+                ...formFieldBaseProperties,
+                fieldType: { type: 'string', const: 'checkbox' },
+                checked: { type: 'boolean', description: 'Initial checked state. Default: false.' },
+            },
+            required: ['type', 'fieldType', 'name'],
+        },
+        {
+            description: 'Radio button group — exactly one option is selectable.',
+            properties: {
+                ...formFieldBaseProperties,
+                fieldType: { type: 'string', const: 'radio' },
+                options: formFieldOptionsSchema,
+                defaultSelected: { type: 'string', description: 'value of the pre-selected option.' },
+            },
+            required: ['type', 'fieldType', 'name', 'options'],
+        },
+        {
+            description: 'Dropdown / select list — exactly one option is selectable.',
+            properties: {
+                ...formFieldBaseProperties,
+                fieldType: { type: 'string', const: 'dropdown' },
+                options: formFieldOptionsSchema,
+                defaultSelected: { type: 'string', description: 'value of the pre-selected option.' },
+            },
+            required: ['type', 'fieldType', 'name', 'options'],
+        },
+        {
+            description: 'Clickable push-button (no value submitted).',
+            properties: {
+                ...formFieldBaseProperties,
+                fieldType: { type: 'string', const: 'button' },
+            },
+            required: ['type', 'fieldType', 'name'],
+        },
+    ],
 };
 const floatGroupSchema = {
     type: 'object',
@@ -548,7 +600,7 @@ export const pdfDocumentSchema = {
             type: 'array',
             description: 'Document content elements rendered top-to-bottom.',
             items: {
-                anyOf: [
+                oneOf: [
                     paragraphSchema,
                     headingSchema,
                     spacerSchema,
@@ -798,5 +850,12 @@ export const pdfDocumentSchema = {
             description: 'Restrict filesystem access to these absolute directory paths.',
         },
     },
+    // additionalProperties: false on the root object catches unknown top-level keys
+    // in AI-agent and MCP code-generation contexts, where an LLM might hallucinate
+    // a property that doesn't exist. Element schemas (content items) are intentionally
+    // not locked down here — they use runtime validation in validate/index.ts which
+    // produces precise per-property VALIDATION_ERROR messages for better DX than
+    // JSON Schema's generic "additional property" error.
+    additionalProperties: false,
 };
 //# sourceMappingURL=schema.js.map