@10x-media/form-builder 0.1.0-beta.4 → 0.1.0-beta.6

package/dist/fields/data/regions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regions.js","names":[],"sources":["../../../src/fields/data/regions.ts"],"sourcesContent":["/**\n * Fixed option sets for the built-in `country` and `state` field types: the author never authors\n * these, so unlike `select` they live in code, not per-instance config. A plain data module with no\n * dependencies, imported on both the server (validation, `format`, poll options) and the client (the\n * frontend renderer, the condition builder), so it must stay isomorphic. `value` is the stored code\n * and is the stable identity contract (never localize it); `label` is the English display name.\n */\n\n/** ISO 3166-1 alpha-2 codes with their English short names (every officially assigned code). */\nexport const COUNTRIES: { label: string; value: string }[] = [\n\t{ value: 'AF', label: 'Afghanistan' },\n\t{ value: 'AX', label: 'Åland Islands' },\n\t{ value: 'AL', label: 'Albania' },\n\t{ value: 'DZ', label: 'Algeria' },\n\t{ value: 'AS', label: 'American Samoa' },\n\t{ value: 'AD', label: 'Andorra' },\n\t{ value: 'AO', label: 'Angola' },\n\t{ value: 'AI', label: 'Anguilla' },\n\t{ value: 'AQ', label: 'Antarctica' },\n\t{ value: 'AG', label: 'Antigua and Barbuda' },\n\t{ value: 'AR', label: 'Argentina' },\n\t{ value: 'AM', label: 'Armenia' },\n\t{ value: 'AW', label: 'Aruba' },\n\t{ value: 'AU', label: 'Australia' },\n\t{ value: 'AT', label: 'Austria' },\n\t{ value: 'AZ', label: 'Azerbaijan' },\n\t{ value: 'BS', label: 'Bahamas' },\n\t{ value: 'BH', label: 'Bahrain' },\n\t{ value: 'BD', label: 'Bangladesh' },\n\t{ value: 'BB', label: 'Barbados' },\n\t{ value: 'BY', label: 'Belarus' },\n\t{ value: 'BE', label: 'Belgium' },\n\t{ value: 'BZ', label: 'Belize' },\n\t{ value: 'BJ', label: 'Benin' },\n\t{ value: 'BM', label: 'Bermuda' },\n\t{ value: 'BT', label: 'Bhutan' },\n\t{ value: 'BO', label: 'Bolivia' },\n\t{ value: 'BQ', label: 'Bonaire, Sint Eustatius and Saba' },\n\t{ value: 'BA', label: 'Bosnia and Herzegovina' },\n\t{ value: 'BW', label: 'Botswana' },\n\t{ value: 'BV', label: 'Bouvet Island' },\n\t{ value: 'BR', label: 'Brazil' },\n\t{ value: 'IO', label: 'British Indian Ocean Territory' },\n\t{ value: 'BN', label: 'Brunei Darussalam' },\n\t{ value: 'BG', label: 'Bulgaria' },\n\t{ value: 'BF', label: 'Burkina Faso' },\n\t{ value: 'BI', label: 'Burundi' },\n\t{ value: 'CV', label: 'Cabo Verde' },\n\t{ value: 'KH', label: 'Cambodia' },\n\t{ value: 'CM', label: 'Cameroon' },\n\t{ value: 'CA', label: 'Canada' },\n\t{ value: 'KY', label: 'Cayman Islands' },\n\t{ value: 'CF', label: 'Central African Republic' },\n\t{ value: 'TD', label: 'Chad' },\n\t{ value: 'CL', label: 'Chile' },\n\t{ value: 'CN', label: 'China' },\n\t{ value: 'CX', label: 'Christmas Island' },\n\t{ value: 'CC', label: 'Cocos (Keeling) Islands' },\n\t{ value: 'CO', label: 'Colombia' },\n\t{ value: 'KM', label: 'Comoros' },\n\t{ value: 'CG', label: 'Congo' },\n\t{ value: 'CD', label: 'Congo, Democratic Republic of the' },\n\t{ value: 'CK', label: 'Cook Islands' },\n\t{ value: 'CR', label: 'Costa Rica' },\n\t{ value: 'CI', label: \"Côte d'Ivoire\" },\n\t{ value: 'HR', label: 'Croatia' },\n\t{ value: 'CU', label: 'Cuba' },\n\t{ value: 'CW', label: 'Curaçao' },\n\t{ value: 'CY', label: 'Cyprus' },\n\t{ value: 'CZ', label: 'Czechia' },\n\t{ value: 'DK', label: 'Denmark' },\n\t{ value: 'DJ', label: 'Djibouti' },\n\t{ value: 'DM', label: 'Dominica' },\n\t{ value: 'DO', label: 'Dominican Republic' },\n\t{ value: 'EC', label: 'Ecuador' },\n\t{ value: 'EG', label: 'Egypt' },\n\t{ value: 'SV', label: 'El Salvador' },\n\t{ value: 'GQ', label: 'Equatorial Guinea' },\n\t{ value: 'ER', label: 'Eritrea' },\n\t{ value: 'EE', label: 'Estonia' },\n\t{ value: 'SZ', label: 'Eswatini' },\n\t{ value: 'ET', label: 'Ethiopia' },\n\t{ value: 'FK', label: 'Falkland Islands (Malvinas)' },\n\t{ value: 'FO', label: 'Faroe Islands' },\n\t{ value: 'FJ', label: 'Fiji' },\n\t{ value: 'FI', label: 'Finland' },\n\t{ value: 'FR', label: 'France' },\n\t{ value: 'GF', label: 'French Guiana' },\n\t{ value: 'PF', label: 'French Polynesia' },\n\t{ value: 'TF', label: 'French Southern Territories' },\n\t{ value: 'GA', label: 'Gabon' },\n\t{ value: 'GM', label: 'Gambia' },\n\t{ value: 'GE', label: 'Georgia' },\n\t{ value: 'DE', label: 'Germany' },\n\t{ value: 'GH', label: 'Ghana' },\n\t{ value: 'GI', label: 'Gibraltar' },\n\t{ value: 'GR', label: 'Greece' },\n\t{ value: 'GL', label: 'Greenland' },\n\t{ value: 'GD', label: 'Grenada' },\n\t{ value: 'GP', label: 'Guadeloupe' },\n\t{ value: 'GU', label: 'Guam' },\n\t{ value: 'GT', label: 'Guatemala' },\n\t{ value: 'GG', label: 'Guernsey' },\n\t{ value: 'GN', label: 'Guinea' },\n\t{ value: 'GW', label: 'Guinea-Bissau' },\n\t{ value: 'GY', label: 'Guyana' },\n\t{ value: 'HT', label: 'Haiti' },\n\t{ value: 'HM', label: 'Heard Island and McDonald Islands' },\n\t{ value: 'VA', label: 'Holy See' },\n\t{ value: 'HN', label: 'Honduras' },\n\t{ value: 'HK', label: 'Hong Kong' },\n\t{ value: 'HU', label: 'Hungary' },\n\t{ value: 'IS', label: 'Iceland' },\n\t{ value: 'IN', label: 'India' },\n\t{ value: 'ID', label: 'Indonesia' },\n\t{ value: 'IR', label: 'Iran' },\n\t{ value: 'IQ', label: 'Iraq' },\n\t{ value: 'IE', label: 'Ireland' },\n\t{ value: 'IM', label: 'Isle of Man' },\n\t{ value: 'IL', label: 'Israel' },\n\t{ value: 'IT', label: 'Italy' },\n\t{ value: 'JM', label: 'Jamaica' },\n\t{ value: 'JP', label: 'Japan' },\n\t{ value: 'JE', label: 'Jersey' },\n\t{ value: 'JO', label: 'Jordan' },\n\t{ value: 'KZ', label: 'Kazakhstan' },\n\t{ value: 'KE', label: 'Kenya' },\n\t{ value: 'KI', label: 'Kiribati' },\n\t{ value: 'KP', label: \"Korea, Democratic People's Republic of\" },\n\t{ value: 'KR', label: 'Korea, Republic of' },\n\t{ value: 'KW', label: 'Kuwait' },\n\t{ value: 'KG', label: 'Kyrgyzstan' },\n\t{ value: 'LA', label: \"Lao People's Democratic Republic\" },\n\t{ value: 'LV', label: 'Latvia' },\n\t{ value: 'LB', label: 'Lebanon' },\n\t{ value: 'LS', label: 'Lesotho' },\n\t{ value: 'LR', label: 'Liberia' },\n\t{ value: 'LY', label: 'Libya' },\n\t{ value: 'LI', label: 'Liechtenstein' },\n\t{ value: 'LT', label: 'Lithuania' },\n\t{ value: 'LU', label: 'Luxembourg' },\n\t{ value: 'MO', label: 'Macao' },\n\t{ value: 'MG', label: 'Madagascar' },\n\t{ value: 'MW', label: 'Malawi' },\n\t{ value: 'MY', label: 'Malaysia' },\n\t{ value: 'MV', label: 'Maldives' },\n\t{ value: 'ML', label: 'Mali' },\n\t{ value: 'MT', label: 'Malta' },\n\t{ value: 'MH', label: 'Marshall Islands' },\n\t{ value: 'MQ', label: 'Martinique' },\n\t{ value: 'MR', label: 'Mauritania' },\n\t{ value: 'MU', label: 'Mauritius' },\n\t{ value: 'YT', label: 'Mayotte' },\n\t{ value: 'MX', label: 'Mexico' },\n\t{ value: 'FM', label: 'Micronesia' },\n\t{ value: 'MD', label: 'Moldova' },\n\t{ value: 'MC', label: 'Monaco' },\n\t{ value: 'MN', label: 'Mongolia' },\n\t{ value: 'ME', label: 'Montenegro' },\n\t{ value: 'MS', label: 'Montserrat' },\n\t{ value: 'MA', label: 'Morocco' },\n\t{ value: 'MZ', label: 'Mozambique' },\n\t{ value: 'MM', label: 'Myanmar' },\n\t{ value: 'NA', label: 'Namibia' },\n\t{ value: 'NR', label: 'Nauru' },\n\t{ value: 'NP', label: 'Nepal' },\n\t{ value: 'NL', label: 'Netherlands' },\n\t{ value: 'NC', label: 'New Caledonia' },\n\t{ value: 'NZ', label: 'New Zealand' },\n\t{ value: 'NI', label: 'Nicaragua' },\n\t{ value: 'NE', label: 'Niger' },\n\t{ value: 'NG', label: 'Nigeria' },\n\t{ value: 'NU', label: 'Niue' },\n\t{ value: 'NF', label: 'Norfolk Island' },\n\t{ value: 'MK', label: 'North Macedonia' },\n\t{ value: 'MP', label: 'Northern Mariana Islands' },\n\t{ value: 'NO', label: 'Norway' },\n\t{ value: 'OM', label: 'Oman' },\n\t{ value: 'PK', label: 'Pakistan' },\n\t{ value: 'PW', label: 'Palau' },\n\t{ value: 'PS', label: 'Palestine, State of' },\n\t{ value: 'PA', label: 'Panama' },\n\t{ value: 'PG', label: 'Papua New Guinea' },\n\t{ value: 'PY', label: 'Paraguay' },\n\t{ value: 'PE', label: 'Peru' },\n\t{ value: 'PH', label: 'Philippines' },\n\t{ value: 'PN', label: 'Pitcairn' },\n\t{ value: 'PL', label: 'Poland' },\n\t{ value: 'PT', label: 'Portugal' },\n\t{ value: 'PR', label: 'Puerto Rico' },\n\t{ value: 'QA', label: 'Qatar' },\n\t{ value: 'RE', label: 'Réunion' },\n\t{ value: 'RO', label: 'Romania' },\n\t{ value: 'RU', label: 'Russian Federation' },\n\t{ value: 'RW', label: 'Rwanda' },\n\t{ value: 'BL', label: 'Saint Barthélemy' },\n\t{ value: 'SH', label: 'Saint Helena, Ascension and Tristan da Cunha' },\n\t{ value: 'KN', label: 'Saint Kitts and Nevis' },\n\t{ value: 'LC', label: 'Saint Lucia' },\n\t{ value: 'MF', label: 'Saint Martin (French part)' },\n\t{ value: 'PM', label: 'Saint Pierre and Miquelon' },\n\t{ value: 'VC', label: 'Saint Vincent and the Grenadines' },\n\t{ value: 'WS', label: 'Samoa' },\n\t{ value: 'SM', label: 'San Marino' },\n\t{ value: 'ST', label: 'Sao Tome and Principe' },\n\t{ value: 'SA', label: 'Saudi Arabia' },\n\t{ value: 'SN', label: 'Senegal' },\n\t{ value: 'RS', label: 'Serbia' },\n\t{ value: 'SC', label: 'Seychelles' },\n\t{ value: 'SL', label: 'Sierra Leone' },\n\t{ value: 'SG', label: 'Singapore' },\n\t{ value: 'SX', label: 'Sint Maarten (Dutch part)' },\n\t{ value: 'SK', label: 'Slovakia' },\n\t{ value: 'SI', label: 'Slovenia' },\n\t{ value: 'SB', label: 'Solomon Islands' },\n\t{ value: 'SO', label: 'Somalia' },\n\t{ value: 'ZA', label: 'South Africa' },\n\t{ value: 'GS', label: 'South Georgia and the South Sandwich Islands' },\n\t{ value: 'SS', label: 'South Sudan' },\n\t{ value: 'ES', label: 'Spain' },\n\t{ value: 'LK', label: 'Sri Lanka' },\n\t{ value: 'SD', label: 'Sudan' },\n\t{ value: 'SR', label: 'Suriname' },\n\t{ value: 'SJ', label: 'Svalbard and Jan Mayen' },\n\t{ value: 'SE', label: 'Sweden' },\n\t{ value: 'CH', label: 'Switzerland' },\n\t{ value: 'SY', label: 'Syrian Arab Republic' },\n\t{ value: 'TW', label: 'Taiwan' },\n\t{ value: 'TJ', label: 'Tajikistan' },\n\t{ value: 'TZ', label: 'Tanzania' },\n\t{ value: 'TH', label: 'Thailand' },\n\t{ value: 'TL', label: 'Timor-Leste' },\n\t{ value: 'TG', label: 'Togo' },\n\t{ value: 'TK', label: 'Tokelau' },\n\t{ value: 'TO', label: 'Tonga' },\n\t{ value: 'TT', label: 'Trinidad and Tobago' },\n\t{ value: 'TN', label: 'Tunisia' },\n\t{ value: 'TR', label: 'Türkiye' },\n\t{ value: 'TM', label: 'Turkmenistan' },\n\t{ value: 'TC', label: 'Turks and Caicos Islands' },\n\t{ value: 'TV', label: 'Tuvalu' },\n\t{ value: 'UG', label: 'Uganda' },\n\t{ value: 'UA', label: 'Ukraine' },\n\t{ value: 'AE', label: 'United Arab Emirates' },\n\t{ value: 'GB', label: 'United Kingdom' },\n\t{ value: 'US', label: 'United States of America' },\n\t{ value: 'UM', label: 'United States Minor Outlying Islands' },\n\t{ value: 'UY', label: 'Uruguay' },\n\t{ value: 'UZ', label: 'Uzbekistan' },\n\t{ value: 'VU', label: 'Vanuatu' },\n\t{ value: 'VE', label: 'Venezuela' },\n\t{ value: 'VN', label: 'Viet Nam' },\n\t{ value: 'VG', label: 'Virgin Islands (British)' },\n\t{ value: 'VI', label: 'Virgin Islands (U.S.)' },\n\t{ value: 'WF', label: 'Wallis and Futuna' },\n\t{ value: 'EH', label: 'Western Sahara' },\n\t{ value: 'YE', label: 'Yemen' },\n\t{ value: 'ZM', label: 'Zambia' },\n\t{ value: 'ZW', label: 'Zimbabwe' },\n]\n\n/** The 50 US states plus the District of Columbia, keyed by USPS code. Matches native's US-only `state` block. */\nexport const US_STATES: { label: string; value: string }[] = [\n\t{ value: 'AL', label: 'Alabama' },\n\t{ value: 'AK', label: 'Alaska' },\n\t{ value: 'AZ', label: 'Arizona' },\n\t{ value: 'AR', label: 'Arkansas' },\n\t{ value: 'CA', label: 'California' },\n\t{ value: 'CO', label: 'Colorado' },\n\t{ value: 'CT', label: 'Connecticut' },\n\t{ value: 'DE', label: 'Delaware' },\n\t{ value: 'DC', label: 'District of Columbia' },\n\t{ value: 'FL', label: 'Florida' },\n\t{ value: 'GA', label: 'Georgia' },\n\t{ value: 'HI', label: 'Hawaii' },\n\t{ value: 'ID', label: 'Idaho' },\n\t{ value: 'IL', label: 'Illinois' },\n\t{ value: 'IN', label: 'Indiana' },\n\t{ value: 'IA', label: 'Iowa' },\n\t{ value: 'KS', label: 'Kansas' },\n\t{ value: 'KY', label: 'Kentucky' },\n\t{ value: 'LA', label: 'Louisiana' },\n\t{ value: 'ME', label: 'Maine' },\n\t{ value: 'MD', label: 'Maryland' },\n\t{ value: 'MA', label: 'Massachusetts' },\n\t{ value: 'MI', label: 'Michigan' },\n\t{ value: 'MN', label: 'Minnesota' },\n\t{ value: 'MS', label: 'Mississippi' },\n\t{ value: 'MO', label: 'Missouri' },\n\t{ value: 'MT', label: 'Montana' },\n\t{ value: 'NE', label: 'Nebraska' },\n\t{ value: 'NV', label: 'Nevada' },\n\t{ value: 'NH', label: 'New Hampshire' },\n\t{ value: 'NJ', label: 'New Jersey' },\n\t{ value: 'NM', label: 'New Mexico' },\n\t{ value: 'NY', label: 'New York' },\n\t{ value: 'NC', label: 'North Carolina' },\n\t{ value: 'ND', label: 'North Dakota' },\n\t{ value: 'OH', label: 'Ohio' },\n\t{ value: 'OK', label: 'Oklahoma' },\n\t{ value: 'OR', label: 'Oregon' },\n\t{ value: 'PA', label: 'Pennsylvania' },\n\t{ value: 'RI', label: 'Rhode Island' },\n\t{ value: 'SC', label: 'South Carolina' },\n\t{ value: 'SD', label: 'South Dakota' },\n\t{ value: 'TN', label: 'Tennessee' },\n\t{ value: 'TX', label: 'Texas' },\n\t{ value: 'UT', label: 'Utah' },\n\t{ value: 'VT', label: 'Vermont' },\n\t{ value: 'VA', label: 'Virginia' },\n\t{ value: 'WA', label: 'Washington' },\n\t{ value: 'WV', label: 'West Virginia' },\n\t{ value: 'WI', label: 'Wisconsin' },\n\t{ value: 'WY', label: 'Wyoming' },\n]\n\nconst countryLabelByValue = new Map(COUNTRIES.map((country) => [country.value, country.label]))\nconst usStateLabelByValue = new Map(US_STATES.map((state) => [state.value, state.label]))\n\n/** The English name for an ISO country code, or `undefined` when the code is not a known country. */\nexport const countryLabel = (value: string): string | undefined => countryLabelByValue.get(value)\n\n/** The name for a US state/DC code, or `undefined` when the code is not a known state. */\nexport const usStateLabel = (value: string): string | undefined => usStateLabelByValue.get(value)\n\n/** Whether `value` is a known ISO country code. */\nexport const isCountryCode = (value: string): boolean => countryLabelByValue.has(value)\n\n/** Whether `value` is a known US state/DC code. */\nexport const isUsStateCode = (value: string): boolean => usStateLabelByValue.has(value)\n\nconst FIXED_FIELD_OPTIONS: Record<string, { label: string; value: string }[]> = {\n\tcountry: COUNTRIES,\n\tstate: US_STATES,\n}\n\n/**\n * The fixed option set a built-in field type carries in code (country/state), or `undefined` for\n * every other type. Lets surfaces that key off authored `options` (the condition builder) offer the\n * same choices for these types, which author none.\n */\nexport const fixedFieldOptions = (\n\tblockType: string\n): { label: string; value: string }[] | undefined => FIXED_FIELD_OPTIONS[blockType]\n"],"mappings":"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"}

package/dist/fields/fieldKey.d.ts

@@ -0,0 +1,15 @@
+import { FormFieldInstance } from "../submissions/types.js";
+
+//#region src/fields/fieldKey.d.ts
+/**
+ * Stable identity for a field instance: its machine name, else the hidden block row `id` Payload
+ * injects into every row (bare blocks carry no name). Flow step assignments and React render keys
+ * use this, so name-based flows keep working for named fields while bare blocks are addressable
+ * by row id. Admin-authored rows always carry a client-generated id; a bare row created via
+ * `payload.create` without an explicit `id` gets one during the write, so it cannot be
+ * flow-referenced in that same call.
+ */
+declare const fieldKey: (instance: FormFieldInstance) => string;
+//#endregion
+export { fieldKey };
+//# sourceMappingURL=fieldKey.d.ts.map

package/dist/fields/fieldKey.js

@@ -0,0 +1,16 @@
+//#region src/fields/fieldKey.ts
+/** Whether the instance carries a machine name. Bare blocks (e.g. `message`) do not. */
+const isNamedField = (instance) => typeof instance.name === "string";
+/**
+* Stable identity for a field instance: its machine name, else the hidden block row `id` Payload
+* injects into every row (bare blocks carry no name). Flow step assignments and React render keys
+* use this, so name-based flows keep working for named fields while bare blocks are addressable
+* by row id. Admin-authored rows always carry a client-generated id; a bare row created via
+* `payload.create` without an explicit `id` gets one during the write, so it cannot be
+* flow-referenced in that same call.
+*/
+const fieldKey = (instance) => instance.name ?? String(instance.id);
+//#endregion
+export { fieldKey, isNamedField };
+
+//# sourceMappingURL=fieldKey.js.map

package/dist/fields/fieldKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldKey.js","names":[],"sources":["../../src/fields/fieldKey.ts"],"sourcesContent":["import type { FormFieldInstance } from '../submissions/types'\n\n/** A field instance guaranteed to carry a machine name (every value-bearing field). */\nexport type NamedFormFieldInstance = FormFieldInstance & { name: string }\n\n/** Whether the instance carries a machine name. Bare blocks (e.g. `message`) do not. */\nexport const isNamedField = (instance: FormFieldInstance): instance is NamedFormFieldInstance =>\n\ttypeof instance.name === 'string'\n\n/**\n * Stable identity for a field instance: its machine name, else the hidden block row `id` Payload\n * injects into every row (bare blocks carry no name). Flow step assignments and React render keys\n * use this, so name-based flows keep working for named fields while bare blocks are addressable\n * by row id. Admin-authored rows always carry a client-generated id; a bare row created via\n * `payload.create` without an explicit `id` gets one during the write, so it cannot be\n * flow-referenced in that same call.\n */\nexport const fieldKey = (instance: FormFieldInstance): string =>\n\tinstance.name ?? String(instance.id)\n"],"mappings":";;AAMA,MAAa,gBAAgB,aAC5B,OAAO,SAAS,SAAS;;;;;;;;;AAU1B,MAAa,YAAY,aACxB,SAAS,QAAQ,OAAO,SAAS,EAAE"}

package/dist/fields/fieldNamesOfType.js

@@ -1,25 +1,30 @@
 //#region src/fields/fieldNamesOfType.ts
 /**
-* Names of form `fields` blocks whose `blockType` is in `types`, trimmed and non-empty.
-* Server-safe and defensive: `fields` may be missing, non-array, or contain garbled rows
-* mid-edit. The single source of truth for which field names are selectable and valid as
-* a field reference (e.g. the confirmation action's `toField`), so client options and
-* server validation cannot drift apart.
+* Trimmed, non-empty names of form `fields` rows, optionally filtered to a set of block `types`.
+* Server-safe and defensive: `fields` may be missing, non-array, or contain garbled rows mid-edit.
+* The single source of truth for which field names are selectable and valid as a field reference,
+* so a picker's client options and its server-side existence check cannot drift apart. Any caller
+* mounting `FieldNameSelect` (or validating its stored value) MUST resolve names through here with
+* the same `types` argument (or lack of one) it hands the picker.
 */
-const fieldNamesOfType = (fields, types) => {
+const collectNames = (fields, types) => {
 	if (!Array.isArray(fields)) return [];
 	const names = [];
 	for (const row of fields) {
 		if (!row || typeof row !== "object") continue;
 		const { blockType, name } = row;
-		if (typeof blockType !== "string" || !types.includes(blockType)) continue;
+		if (types && (typeof blockType !== "string" || !types.includes(blockType))) continue;
 		if (typeof name !== "string") continue;
 		const trimmed = name.trim();
 		if (trimmed.length > 0) names.push(trimmed);
 	}
 	return names;
 };
+/** Names of form `fields` blocks whose `blockType` is in `types`. */
+const fieldNamesOfType = (fields, types) => collectNames(fields, types);
+/** Names of every named form `fields` block, regardless of type. Bare (nameless) blocks are excluded. */
+const fieldNames = (fields) => collectNames(fields, void 0);
 //#endregion
-export { fieldNamesOfType };
+export { fieldNames, fieldNamesOfType };
 
 //# sourceMappingURL=fieldNamesOfType.js.map

package/dist/fields/fieldNamesOfType.js.map

@@ -1 +1 @@
-{"version":3,"file":"fieldNamesOfType.js","names":[],"sources":["../../src/fields/fieldNamesOfType.ts"],"sourcesContent":["/**\n * Names of form `fields` blocks whose `blockType` is in `types`, trimmed and non-empty.\n * Server-safe and defensive: `fields` may be missing, non-array, or contain garbled rows\n * mid-edit. The single source of truth for which field names are selectable and valid as\n * a field reference (e.g. the confirmation action's `toField`), so client options and\n * server validation cannot drift apart.\n */\nexport const fieldNamesOfType = (fields: unknown, types: readonly string[]): string[] => {\n\tif (!Array.isArray(fields)) {\n\t\treturn []\n\t}\n\tconst names: string[] = []\n\tfor (const row of fields) {\n\t\tif (!row || typeof row !== 'object') {\n\t\t\tcontinue\n\t\t}\n\t\tconst { blockType, name } = row as { blockType?: unknown; name?: unknown }\n\t\tif (typeof blockType !== 'string' || !types.includes(blockType)) {\n\t\t\tcontinue\n\t\t}\n\t\tif (typeof name !== 'string') {\n\t\t\tcontinue\n\t\t}\n\t\tconst trimmed = name.trim()\n\t\tif (trimmed.length > 0) {\n\t\t\tnames.push(trimmed)\n\t\t}\n\t}\n\treturn names\n}\n"],"mappings":";;;;;;;;AAOA,MAAa,oBAAoB,QAAiB,UAAuC;CACxF,IAAI,CAAC,MAAM,QAAQ,MAAM,GACxB,OAAO,CAAC;CAET,MAAM,QAAkB,CAAC;CACzB,KAAK,MAAM,OAAO,QAAQ;EACzB,IAAI,CAAC,OAAO,OAAO,QAAQ,UAC1B;EAED,MAAM,EAAE,WAAW,SAAS;EAC5B,IAAI,OAAO,cAAc,YAAY,CAAC,MAAM,SAAS,SAAS,GAC7D;EAED,IAAI,OAAO,SAAS,UACnB;EAED,MAAM,UAAU,KAAK,KAAK;EAC1B,IAAI,QAAQ,SAAS,GACpB,MAAM,KAAK,OAAO;CAEpB;CACA,OAAO;AACR"}
+{"version":3,"file":"fieldNamesOfType.js","names":[],"sources":["../../src/fields/fieldNamesOfType.ts"],"sourcesContent":["/**\n * Trimmed, non-empty names of form `fields` rows, optionally filtered to a set of block `types`.\n * Server-safe and defensive: `fields` may be missing, non-array, or contain garbled rows mid-edit.\n * The single source of truth for which field names are selectable and valid as a field reference,\n * so a picker's client options and its server-side existence check cannot drift apart. Any caller\n * mounting `FieldNameSelect` (or validating its stored value) MUST resolve names through here with\n * the same `types` argument (or lack of one) it hands the picker.\n */\nconst collectNames = (fields: unknown, types: readonly string[] | undefined): string[] => {\n\tif (!Array.isArray(fields)) {\n\t\treturn []\n\t}\n\tconst names: string[] = []\n\tfor (const row of fields) {\n\t\tif (!row || typeof row !== 'object') {\n\t\t\tcontinue\n\t\t}\n\t\tconst { blockType, name } = row as { blockType?: unknown; name?: unknown }\n\t\tif (types && (typeof blockType !== 'string' || !types.includes(blockType))) {\n\t\t\tcontinue\n\t\t}\n\t\tif (typeof name !== 'string') {\n\t\t\tcontinue\n\t\t}\n\t\tconst trimmed = name.trim()\n\t\tif (trimmed.length > 0) {\n\t\t\tnames.push(trimmed)\n\t\t}\n\t}\n\treturn names\n}\n\n/** Names of form `fields` blocks whose `blockType` is in `types`. */\nexport const fieldNamesOfType = (fields: unknown, types: readonly string[]): string[] =>\n\tcollectNames(fields, types)\n\n/** Names of every named form `fields` block, regardless of type. Bare (nameless) blocks are excluded. */\nexport const fieldNames = (fields: unknown): string[] => collectNames(fields, undefined)\n"],"mappings":";;;;;;;;;AAQA,MAAM,gBAAgB,QAAiB,UAAmD;CACzF,IAAI,CAAC,MAAM,QAAQ,MAAM,GACxB,OAAO,CAAC;CAET,MAAM,QAAkB,CAAC;CACzB,KAAK,MAAM,OAAO,QAAQ;EACzB,IAAI,CAAC,OAAO,OAAO,QAAQ,UAC1B;EAED,MAAM,EAAE,WAAW,SAAS;EAC5B,IAAI,UAAU,OAAO,cAAc,YAAY,CAAC,MAAM,SAAS,SAAS,IACvE;EAED,IAAI,OAAO,SAAS,UACnB;EAED,MAAM,UAAU,KAAK,KAAK;EAC1B,IAAI,QAAQ,SAAS,GACpB,MAAM,KAAK,OAAO;CAEpB;CACA,OAAO;AACR;;AAGA,MAAa,oBAAoB,QAAiB,UACjD,aAAa,QAAQ,KAAK;;AAG3B,MAAa,cAAc,WAA8B,aAAa,QAAQ,KAAA,CAAS"}

package/dist/fields/instanceOptions.js

@@ -0,0 +1,20 @@
+//#region src/fields/instanceOptions.ts
+/**
+* Normalize a field instance's authored options to `{ value, label }` pairs, dropping entries
+* without a string value and falling back to the value as label. Returns `undefined` when the
+* instance declares no usable options, so callers can distinguish "not a choice field" from an
+* empty choice set. Shared by response aggregation and poll outcome resolution so both read the
+* same choice set from a form document.
+*/
+const instanceOptionsOf = (field) => {
+	if (!Array.isArray(field.options)) return;
+	const options = field.options.filter((option) => typeof option?.value === "string").map((option) => ({
+		value: String(option.value),
+		label: option.label ?? String(option.value)
+	}));
+	return options.length > 0 ? options : void 0;
+};
+//#endregion
+export { instanceOptionsOf };
+
+//# sourceMappingURL=instanceOptions.js.map

package/dist/fields/instanceOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instanceOptions.js","names":[],"sources":["../../src/fields/instanceOptions.ts"],"sourcesContent":["import type { FormFieldInstance } from '../submissions/types'\n\n/**\n * Normalize a field instance's authored options to `{ value, label }` pairs, dropping entries\n * without a string value and falling back to the value as label. Returns `undefined` when the\n * instance declares no usable options, so callers can distinguish \"not a choice field\" from an\n * empty choice set. Shared by response aggregation and poll outcome resolution so both read the\n * same choice set from a form document.\n */\nexport const instanceOptionsOf = (\n\tfield: FormFieldInstance\n): { value: string; label: string }[] | undefined => {\n\tif (!Array.isArray(field.options)) {\n\t\treturn undefined\n\t}\n\tconst options = (field.options as Array<{ label?: string; value?: string }>)\n\t\t.filter((option) => typeof option?.value === 'string')\n\t\t.map((option) => ({ value: String(option.value), label: option.label ?? String(option.value) }))\n\treturn options.length > 0 ? options : undefined\n}\n"],"mappings":";;;;;;;;AASA,MAAa,qBACZ,UACoD;CACpD,IAAI,CAAC,MAAM,QAAQ,MAAM,OAAO,GAC/B;CAED,MAAM,UAAW,MAAM,QACrB,QAAQ,WAAW,OAAO,QAAQ,UAAU,QAAQ,EACpD,KAAK,YAAY;EAAE,OAAO,OAAO,OAAO,KAAK;EAAG,OAAO,OAAO,SAAS,OAAO,OAAO,KAAK;CAAE,EAAE;CAChG,OAAO,QAAQ,SAAS,IAAI,UAAU,KAAA;AACvC"}

package/dist/fields/registry.d.ts

@@ -1,4 +1,5 @@
 import { AnyFormFieldDefinition } from "./types.js";
+import { Payload } from "payload";
 
 //#region src/fields/registry.d.ts
 type FieldTypeRegistry = Map<string, AnyFormFieldDefinition>;

package/dist/fields/registry.js

@@ -1,3 +1,4 @@
+import { customStateOf, stashCustomState } from "../plugin/customState.js";
 //#region src/fields/registry.ts
 const buildRegistry = (definitions) => {
 	const registry = /* @__PURE__ */ new Map();
@@ -5,9 +6,18 @@ const buildRegistry = (definitions) => {
 	return registry;
 };
 /**
+* A bare definition without `value: 'none'` would no-op silently: its instances are nameless,
+* so `validate`/`schema` never run and no value is ever stored. Failing the boot makes the
+* misconfiguration impossible to ship.
+*/
+const assertBareContract = (definition) => {
+	if (definition.bare === true && definition.value !== "none") throw new Error(`form-builder: bare field types must be display-only (value: 'none'); '${definition.type}' declares value '${definition.value}'`);
+};
+/**
 * Resolve the active field-type registry from the built-in defaults and the plugin `fields` option.
 * `false` removes a type, `true` keeps the default, an object adds a new type or replaces an existing
-* one (its `type` is forced to the config key so an override cannot rename the slot).
+* one (its `type` is forced to the config key so an override cannot rename the slot). Every resolved
+* definition must honor the bare contract; a violation throws at plugin boot.
 */
 const resolveFieldTypes = (defaults, config = {}) => {
 	const registry = buildRegistry(defaults);
@@ -16,9 +26,18 @@ const resolveFieldTypes = (defaults, config = {}) => {
 		...option,
 		type
 	});
+	for (const definition of registry.values()) assertBareContract(definition);
 	return registry;
 };
+/**
+* Park the resolved field-type registry on the config so `resolveEffectivePollOptions` can look up
+* a poll results field's definition (and its `resolveOptions`) at request time via `payload.config`,
+* the same way poll option sources and consent sources are stashed for root-level helpers.
+*/
+const stashFieldTypes = (custom, registry) => stashCustomState(custom, { fieldTypes: registry });
+/** The field-type registry stashed at boot, or an empty registry when the plugin never booted. */
+const fieldTypesOf = (payload) => customStateOf(payload).fieldTypes ?? /* @__PURE__ */ new Map();
 //#endregion
-export { buildRegistry, resolveFieldTypes };
+export { buildRegistry, fieldTypesOf, resolveFieldTypes, stashFieldTypes };
 
 //# sourceMappingURL=registry.js.map

package/dist/fields/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","names":[],"sources":["../../src/fields/registry.ts"],"sourcesContent":["import type { AnyFormFieldDefinition } from './types'\n\nexport type FieldTypeRegistry = Map<string, AnyFormFieldDefinition>\n\n/** Per-type opt-in: `false` removes a built-in, `true` keeps it, an object adds a new type or replaces one. */\nexport type FieldTypeOption = boolean | AnyFormFieldDefinition\n\nexport type FieldTypesConfig = Record<string, FieldTypeOption>\n\nexport const buildRegistry = (definitions: AnyFormFieldDefinition[]): FieldTypeRegistry => {\n\tconst registry: FieldTypeRegistry = new Map()\n\tfor (const definition of definitions) {\n\t\tregistry.set(definition.type, definition)\n\t}\n\treturn registry\n}\n\n/**\n * Resolve the active field-type registry from the built-in defaults and the plugin `fields` option.\n * `false` removes a type, `true` keeps the default, an object adds a new type or replaces an existing\n * one (its `type` is forced to the config key so an override cannot rename the slot).\n */\nexport const resolveFieldTypes = (\n\tdefaults: AnyFormFieldDefinition[],\n\tconfig: FieldTypesConfig = {}\n): FieldTypeRegistry => {\n\tconst registry = buildRegistry(defaults)\n\tfor (const [type, option] of Object.entries(config)) {\n\t\tif (option === false) {\n\t\t\tregistry.delete(type)\n\t\t} else if (option === true) {\n\t\t\t// keep the default; a no-op when no default exists for this key\n\t\t} else {\n\t\t\tregistry.set(type, { ...option, type })\n\t\t}\n\t}\n\treturn registry\n}\n"],"mappings":";AASA,MAAa,iBAAiB,gBAA6D;CAC1F,MAAM,2BAA8B,IAAI,IAAI;CAC5C,KAAK,MAAM,cAAc,aACxB,SAAS,IAAI,WAAW,MAAM,UAAU;CAEzC,OAAO;AACR;;;;;;AAOA,MAAa,qBACZ,UACA,SAA2B,CAAC,MACL;CACvB,MAAM,WAAW,cAAc,QAAQ;CACvC,KAAK,MAAM,CAAC,MAAM,WAAW,OAAO,QAAQ,MAAM,GACjD,IAAI,WAAW,OACd,SAAS,OAAO,IAAI;MACd,IAAI,WAAW,MAAM,CAE5B,OACC,SAAS,IAAI,MAAM;EAAE,GAAG;EAAQ;CAAK,CAAC;CAGxC,OAAO;AACR"}
+{"version":3,"file":"registry.js","names":[],"sources":["../../src/fields/registry.ts"],"sourcesContent":["import type { Payload } from 'payload'\nimport { customStateOf, stashCustomState } from '../plugin/customState'\nimport type { AnyFormFieldDefinition } from './types'\n\nexport type FieldTypeRegistry = Map<string, AnyFormFieldDefinition>\n\n/** Per-type opt-in: `false` removes a built-in, `true` keeps it, an object adds a new type or replaces one. */\nexport type FieldTypeOption = boolean | AnyFormFieldDefinition\n\nexport type FieldTypesConfig = Record<string, FieldTypeOption>\n\nexport const buildRegistry = (definitions: AnyFormFieldDefinition[]): FieldTypeRegistry => {\n\tconst registry: FieldTypeRegistry = new Map()\n\tfor (const definition of definitions) {\n\t\tregistry.set(definition.type, definition)\n\t}\n\treturn registry\n}\n\n/**\n * A bare definition without `value: 'none'` would no-op silently: its instances are nameless,\n * so `validate`/`schema` never run and no value is ever stored. Failing the boot makes the\n * misconfiguration impossible to ship.\n */\nconst assertBareContract = (definition: AnyFormFieldDefinition): void => {\n\tif (definition.bare === true && definition.value !== 'none') {\n\t\tthrow new Error(\n\t\t\t`form-builder: bare field types must be display-only (value: 'none'); '${definition.type}' declares value '${definition.value}'`\n\t\t)\n\t}\n}\n\n/**\n * Resolve the active field-type registry from the built-in defaults and the plugin `fields` option.\n * `false` removes a type, `true` keeps the default, an object adds a new type or replaces an existing\n * one (its `type` is forced to the config key so an override cannot rename the slot). Every resolved\n * definition must honor the bare contract; a violation throws at plugin boot.\n */\nexport const resolveFieldTypes = (\n\tdefaults: AnyFormFieldDefinition[],\n\tconfig: FieldTypesConfig = {}\n): FieldTypeRegistry => {\n\tconst registry = buildRegistry(defaults)\n\tfor (const [type, option] of Object.entries(config)) {\n\t\tif (option === false) {\n\t\t\tregistry.delete(type)\n\t\t} else if (option === true) {\n\t\t\t// keep the default; a no-op when no default exists for this key\n\t\t} else {\n\t\t\tregistry.set(type, { ...option, type })\n\t\t}\n\t}\n\tfor (const definition of registry.values()) {\n\t\tassertBareContract(definition)\n\t}\n\treturn registry\n}\n\ntype FieldTypesCustomState = { fieldTypes: FieldTypeRegistry }\n\n/**\n * Park the resolved field-type registry on the config so `resolveEffectivePollOptions` can look up\n * a poll results field's definition (and its `resolveOptions`) at request time via `payload.config`,\n * the same way poll option sources and consent sources are stashed for root-level helpers.\n */\nexport const stashFieldTypes = (\n\tcustom: Record<string, unknown> | undefined,\n\tregistry: FieldTypeRegistry\n): Record<string, unknown> =>\n\tstashCustomState<FieldTypesCustomState>(custom, { fieldTypes: registry })\n\n/** The field-type registry stashed at boot, or an empty registry when the plugin never booted. */\nexport const fieldTypesOf = (payload: Payload): FieldTypeRegistry =>\n\tcustomStateOf<FieldTypesCustomState>(payload).fieldTypes ?? new Map()\n"],"mappings":";;AAWA,MAAa,iBAAiB,gBAA6D;CAC1F,MAAM,2BAA8B,IAAI,IAAI;CAC5C,KAAK,MAAM,cAAc,aACxB,SAAS,IAAI,WAAW,MAAM,UAAU;CAEzC,OAAO;AACR;;;;;;AAOA,MAAM,sBAAsB,eAA6C;CACxE,IAAI,WAAW,SAAS,QAAQ,WAAW,UAAU,QACpD,MAAM,IAAI,MACT,yEAAyE,WAAW,KAAK,oBAAoB,WAAW,MAAM,EAC/H;AAEF;;;;;;;AAQA,MAAa,qBACZ,UACA,SAA2B,CAAC,MACL;CACvB,MAAM,WAAW,cAAc,QAAQ;CACvC,KAAK,MAAM,CAAC,MAAM,WAAW,OAAO,QAAQ,MAAM,GACjD,IAAI,WAAW,OACd,SAAS,OAAO,IAAI;MACd,IAAI,WAAW,MAAM,CAE5B,OACC,SAAS,IAAI,MAAM;EAAE,GAAG;EAAQ;CAAK,CAAC;CAGxC,KAAK,MAAM,cAAc,SAAS,OAAO,GACxC,mBAAmB,UAAU;CAE9B,OAAO;AACR;;;;;;AASA,MAAa,mBACZ,QACA,aAEA,iBAAwC,QAAQ,EAAE,YAAY,SAAS,CAAC;;AAGzE,MAAa,gBAAgB,YAC5B,cAAqC,OAAO,EAAE,8BAAc,IAAI,IAAI"}

package/dist/fields/sharedConfig.js

@@ -13,14 +13,37 @@ const conditionField = (name, labelKey, conditionTypes) => ({
 	} } }
 });
 /**
-* Config every field instance carries regardless of type. `name` is the machine key written into
-* submissions; `width` is stored for the layout grid. Field types add their own `config` after
-* these inside the Field tab (see `fieldBlockTabs`). Content-bearing fields (`label`,
-* `placeholder`, `description`) are localized unless `localize` is false; identifiers and
-* behavior flags never are. The rows below are presentational only (unnamed, data paths stay
-* flat); `required` sits last, under `description`, per the admin layout.
+* Let a lone row survivor span its row: Payload styles a row child with no `admin.width` as
+* `flex: 1 1 auto` (see `mergeFieldStyles`), so dropping the key is the "fill the row" signal.
+* Without this, omitting one half of a 50/50 row would strand the other half at 50%.
 */
-const sharedFieldConfig = (localize = true) => [
+const spanRow = (field) => {
+	if (field.admin?.width === void 0) return field;
+	const { width: _width, ...admin } = field.admin;
+	return {
+		...field,
+		admin
+	};
+};
+/**
+* Drop the shared fields a type never uses, descending into the presentational rows so a nested
+* field is reachable. An emptied row is dropped whole; a row pruned down to one field lets that
+* field span it. A row that lost nothing is left exactly as authored, single-child rows included.
+*/
+const applyOmissions = (fields, omit) => fields.flatMap((field) => {
+	if (field.type === "row") {
+		const kept = applyOmissions(field.fields, omit);
+		if (kept.length === 0) return [];
+		const strandsSurvivor = kept.length === 1 && kept.length < field.fields.length;
+		return [{
+			...field,
+			fields: strandsSurvivor ? kept.map(spanRow) : kept
+		}];
+	}
+	return "name" in field && omit.has(field.name) ? [] : [field];
+});
+/** The full shared config, before a type's `omitShared` prunes it. See `sharedFieldConfig`. */
+const baseSharedFieldConfig = (localize) => [
 	{
 		type: "row",
 		fields: [{
@@ -87,12 +110,26 @@ const sharedFieldConfig = (localize = true) => [
 		label: labelFor(keys.configRequired)
 	}
 ];
-const fieldBlockTabs = ({ conditionTypes, typeConfig, validations, localize = true }) => ({
+/**
+* Config every field instance carries regardless of type. `name` is the machine key written into
+* submissions; `width` is stored for the layout grid. Field types add their own `config` after
+* these inside the Field tab (see `fieldBlockTabs`) and drop the ones they never read via
+* `omitShared`, so an author is never offered a setting the renderer ignores. Content-bearing
+* fields (`label`, `placeholder`, `description`) are localized unless `localize` is false;
+* identifiers and behavior flags never are. The rows are presentational only (unnamed, data paths
+* stay flat); `required` sits last, under `description`, per the admin layout.
+*/
+const sharedFieldConfig = (localize = true, omitShared = []) => {
+	const omit = new Set(omitShared);
+	omit.delete("name");
+	return applyOmissions(baseSharedFieldConfig(localize), omit);
+};
+const fieldBlockTabs = ({ conditionTypes, typeConfig, validations, localize = true, omitShared }) => ({
 	type: "tabs",
 	tabs: [
 		{
 			label: labelFor(keys.tabField),
-			fields: [...sharedFieldConfig(localize), ...typeConfig]
+			fields: [...sharedFieldConfig(localize, omitShared), ...typeConfig]
 		},
 		{
 			label: labelFor(keys.tabValidation),

package/dist/fields/sharedConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"sharedConfig.js","names":[],"sources":["../../src/fields/sharedConfig.ts"],"sourcesContent":["import type { Field } from 'payload'\nimport type { ConditionFieldType } from '../conditions/fieldTypes'\nimport { keys } from '../translations/keys'\nimport { labelFor } from '../translations/server'\nimport { localizedIf } from './localizedIf'\n\nconst CONDITION_FIELD_REF = '@10x-media/form-builder/client#FormConditionField'\n\nconst conditionField = (\n\tname: 'visibleWhen' | 'validateWhen',\n\tlabelKey: string,\n\tconditionTypes: Record<string, ConditionFieldType>\n): Field => ({\n\tname,\n\ttype: 'json',\n\tlabel: labelFor(labelKey),\n\tadmin: {\n\t\tcomponents: {\n\t\t\tField: { path: CONDITION_FIELD_REF, clientProps: { conditionTypes } },\n\t\t},\n\t},\n})\n\n/**\n * Config every field instance carries regardless of type. `name` is the machine key written into\n * submissions; `width` is stored for the layout grid. Field types add their own `config` after\n * these inside the Field tab (see `fieldBlockTabs`). Content-bearing fields (`label`,\n * `placeholder`, `description`) are localized unless `localize` is false; identifiers and\n * behavior flags never are. The rows below are presentational only (unnamed, data paths stay\n * flat); `required` sits last, under `description`, per the admin layout.\n */\nexport const sharedFieldConfig = (localize = true): Field[] => [\n\t{\n\t\ttype: 'row',\n\t\tfields: [\n\t\t\t{\n\t\t\t\tname: 'name',\n\t\t\t\ttype: 'text',\n\t\t\t\trequired: true,\n\t\t\t\tlabel: labelFor(keys.configName),\n\t\t\t\tadmin: { width: '50%' },\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'label',\n\t\t\t\ttype: 'text',\n\t\t\t\tlabel: labelFor(keys.configLabel),\n\t\t\t\tadmin: { width: '50%' },\n\t\t\t\t...localizedIf(localize),\n\t\t\t},\n\t\t],\n\t},\n\t{\n\t\ttype: 'row',\n\t\tfields: [\n\t\t\t{\n\t\t\t\tname: 'width',\n\t\t\t\ttype: 'select',\n\t\t\t\trequired: true,\n\t\t\t\tdefaultValue: 'full',\n\t\t\t\tlabel: labelFor(keys.configWidth),\n\t\t\t\tadmin: { width: '50%', isClearable: false },\n\t\t\t\toptions: [\n\t\t\t\t\t{ label: 'Full', value: 'full' },\n\t\t\t\t\t{ label: 'Half', value: 'half' },\n\t\t\t\t\t{ label: 'Third', value: 'third' },\n\t\t\t\t\t{ label: 'Two thirds', value: 'twoThirds' },\n\t\t\t\t],\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'placeholder',\n\t\t\t\ttype: 'text',\n\t\t\t\tlabel: labelFor(keys.configPlaceholder),\n\t\t\t\tadmin: { width: '50%' },\n\t\t\t\t...localizedIf(localize),\n\t\t\t},\n\t\t],\n\t},\n\t{\n\t\tname: 'description',\n\t\ttype: 'textarea',\n\t\tlabel: labelFor(keys.configDescription),\n\t\t...localizedIf(localize),\n\t},\n\t{ name: 'required', type: 'checkbox', label: labelFor(keys.configRequired) },\n]\n\n/**\n * The single field of every field block: unnamed tabs (presentational only, data paths stay flat).\n * Field tab holds the shared basics plus the type's own config; Validation holds the rule blocks and\n * `validateWhen`; Advanced holds `visibleWhen` and `hidden`. `visibleWhen`/`validateWhen` store a\n * canonical Payload `Where`, edited by the native condition builder.\n */\ntype FieldBlockTabsArgs = {\n\tconditionTypes: Record<string, ConditionFieldType>\n\ttypeConfig: Field[]\n\tvalidations: Field\n\tlocalize?: boolean\n}\n\nexport const fieldBlockTabs = ({\n\tconditionTypes,\n\ttypeConfig,\n\tvalidations,\n\tlocalize = true,\n}: FieldBlockTabsArgs): Field => ({\n\ttype: 'tabs',\n\ttabs: [\n\t\t{\n\t\t\tlabel: labelFor(keys.tabField),\n\t\t\tfields: [...sharedFieldConfig(localize), ...typeConfig],\n\t\t},\n\t\t{\n\t\t\tlabel: labelFor(keys.tabValidation),\n\t\t\tfields: [\n\t\t\t\tvalidations,\n\t\t\t\tconditionField('validateWhen', keys.configValidateWhen, conditionTypes),\n\t\t\t],\n\t\t},\n\t\t{\n\t\t\tlabel: labelFor(keys.tabAdvanced),\n\t\t\tfields: [\n\t\t\t\tconditionField('visibleWhen', keys.configVisibleWhen, conditionTypes),\n\t\t\t\t{ name: 'hidden', type: 'checkbox', label: labelFor(keys.configHidden) },\n\t\t\t],\n\t\t},\n\t],\n})\n"],"mappings":";;;;AAMA,MAAM,sBAAsB;AAE5B,MAAM,kBACL,MACA,UACA,oBACY;CACZ;CACA,MAAM;CACN,OAAO,SAAS,QAAQ;CACxB,OAAO,EACN,YAAY,EACX,OAAO;EAAE,MAAM;EAAqB,aAAa,EAAE,eAAe;CAAE,EACrE,EACD;AACD;;;;;;;;;AAUA,MAAa,qBAAqB,WAAW,SAAkB;CAC9D;EACC,MAAM;EACN,QAAQ,CACP;GACC,MAAM;GACN,MAAM;GACN,UAAU;GACV,OAAO,SAAS,KAAK,UAAU;GAC/B,OAAO,EAAE,OAAO,MAAM;EACvB,GACA;GACC,MAAM;GACN,MAAM;GACN,OAAO,SAAS,KAAK,WAAW;GAChC,OAAO,EAAE,OAAO,MAAM;GACtB,GAAG,YAAY,QAAQ;EACxB,CACD;CACD;CACA;EACC,MAAM;EACN,QAAQ,CACP;GACC,MAAM;GACN,MAAM;GACN,UAAU;GACV,cAAc;GACd,OAAO,SAAS,KAAK,WAAW;GAChC,OAAO;IAAE,OAAO;IAAO,aAAa;GAAM;GAC1C,SAAS;IACR;KAAE,OAAO;KAAQ,OAAO;IAAO;IAC/B;KAAE,OAAO;KAAQ,OAAO;IAAO;IAC/B;KAAE,OAAO;KAAS,OAAO;IAAQ;IACjC;KAAE,OAAO;KAAc,OAAO;IAAY;GAC3C;EACD,GACA;GACC,MAAM;GACN,MAAM;GACN,OAAO,SAAS,KAAK,iBAAiB;GACtC,OAAO,EAAE,OAAO,MAAM;GACtB,GAAG,YAAY,QAAQ;EACxB,CACD;CACD;CACA;EACC,MAAM;EACN,MAAM;EACN,OAAO,SAAS,KAAK,iBAAiB;EACtC,GAAG,YAAY,QAAQ;CACxB;CACA;EAAE,MAAM;EAAY,MAAM;EAAY,OAAO,SAAS,KAAK,cAAc;CAAE;AAC5E;AAeA,MAAa,kBAAkB,EAC9B,gBACA,YACA,aACA,WAAW,YACsB;CACjC,MAAM;CACN,MAAM;EACL;GACC,OAAO,SAAS,KAAK,QAAQ;GAC7B,QAAQ,CAAC,GAAG,kBAAkB,QAAQ,GAAG,GAAG,UAAU;EACvD;EACA;GACC,OAAO,SAAS,KAAK,aAAa;GAClC,QAAQ,CACP,aACA,eAAe,gBAAgB,KAAK,oBAAoB,cAAc,CACvE;EACD;EACA;GACC,OAAO,SAAS,KAAK,WAAW;GAChC,QAAQ,CACP,eAAe,eAAe,KAAK,mBAAmB,cAAc,GACpE;IAAE,MAAM;IAAU,MAAM;IAAY,OAAO,SAAS,KAAK,YAAY;GAAE,CACxE;EACD;CACD;AACD"}
+{"version":3,"file":"sharedConfig.js","names":[],"sources":["../../src/fields/sharedConfig.ts"],"sourcesContent":["import type { Field } from 'payload'\nimport type { ConditionFieldType } from '../conditions/fieldTypes'\nimport { keys } from '../translations/keys'\nimport { labelFor } from '../translations/server'\nimport { localizedIf } from './localizedIf'\nimport type { OmittableSharedField } from './types'\n\nconst CONDITION_FIELD_REF = '@10x-media/form-builder/client#FormConditionField'\n\nconst conditionField = (\n\tname: 'visibleWhen' | 'validateWhen',\n\tlabelKey: string,\n\tconditionTypes: Record<string, ConditionFieldType>\n): Field => ({\n\tname,\n\ttype: 'json',\n\tlabel: labelFor(labelKey),\n\tadmin: {\n\t\tcomponents: {\n\t\t\tField: { path: CONDITION_FIELD_REF, clientProps: { conditionTypes } },\n\t\t},\n\t},\n})\n\n/**\n * Let a lone row survivor span its row: Payload styles a row child with no `admin.width` as\n * `flex: 1 1 auto` (see `mergeFieldStyles`), so dropping the key is the \"fill the row\" signal.\n * Without this, omitting one half of a 50/50 row would strand the other half at 50%.\n */\nconst spanRow = <T extends Field>(field: T): T => {\n\tif (field.admin?.width === undefined) {\n\t\treturn field\n\t}\n\tconst { width: _width, ...admin } = field.admin\n\treturn { ...field, admin }\n}\n\n/**\n * Drop the shared fields a type never uses, descending into the presentational rows so a nested\n * field is reachable. An emptied row is dropped whole; a row pruned down to one field lets that\n * field span it. A row that lost nothing is left exactly as authored, single-child rows included.\n */\nconst applyOmissions = (fields: Field[], omit: ReadonlySet<string>): Field[] =>\n\tfields.flatMap((field): Field[] => {\n\t\tif (field.type === 'row') {\n\t\t\tconst kept = applyOmissions(field.fields, omit)\n\t\t\tif (kept.length === 0) {\n\t\t\t\treturn []\n\t\t\t}\n\t\t\tconst strandsSurvivor = kept.length === 1 && kept.length < field.fields.length\n\t\t\treturn [{ ...field, fields: strandsSurvivor ? kept.map(spanRow) : kept }]\n\t\t}\n\t\treturn 'name' in field && omit.has(field.name) ? [] : [field]\n\t})\n\n/** The full shared config, before a type's `omitShared` prunes it. See `sharedFieldConfig`. */\nconst baseSharedFieldConfig = (localize: boolean): Field[] => [\n\t{\n\t\ttype: 'row',\n\t\tfields: [\n\t\t\t{\n\t\t\t\tname: 'name',\n\t\t\t\ttype: 'text',\n\t\t\t\trequired: true,\n\t\t\t\tlabel: labelFor(keys.configName),\n\t\t\t\tadmin: { width: '50%' },\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'label',\n\t\t\t\ttype: 'text',\n\t\t\t\tlabel: labelFor(keys.configLabel),\n\t\t\t\tadmin: { width: '50%' },\n\t\t\t\t...localizedIf(localize),\n\t\t\t},\n\t\t],\n\t},\n\t{\n\t\ttype: 'row',\n\t\tfields: [\n\t\t\t{\n\t\t\t\tname: 'width',\n\t\t\t\ttype: 'select',\n\t\t\t\trequired: true,\n\t\t\t\tdefaultValue: 'full',\n\t\t\t\tlabel: labelFor(keys.configWidth),\n\t\t\t\tadmin: { width: '50%', isClearable: false },\n\t\t\t\toptions: [\n\t\t\t\t\t{ label: 'Full', value: 'full' },\n\t\t\t\t\t{ label: 'Half', value: 'half' },\n\t\t\t\t\t{ label: 'Third', value: 'third' },\n\t\t\t\t\t{ label: 'Two thirds', value: 'twoThirds' },\n\t\t\t\t],\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'placeholder',\n\t\t\t\ttype: 'text',\n\t\t\t\tlabel: labelFor(keys.configPlaceholder),\n\t\t\t\tadmin: { width: '50%' },\n\t\t\t\t...localizedIf(localize),\n\t\t\t},\n\t\t],\n\t},\n\t{\n\t\tname: 'description',\n\t\ttype: 'textarea',\n\t\tlabel: labelFor(keys.configDescription),\n\t\t...localizedIf(localize),\n\t},\n\t{ name: 'required', type: 'checkbox', label: labelFor(keys.configRequired) },\n]\n\n/**\n * Config every field instance carries regardless of type. `name` is the machine key written into\n * submissions; `width` is stored for the layout grid. Field types add their own `config` after\n * these inside the Field tab (see `fieldBlockTabs`) and drop the ones they never read via\n * `omitShared`, so an author is never offered a setting the renderer ignores. Content-bearing\n * fields (`label`, `placeholder`, `description`) are localized unless `localize` is false;\n * identifiers and behavior flags never are. The rows are presentational only (unnamed, data paths\n * stay flat); `required` sits last, under `description`, per the admin layout.\n */\nexport const sharedFieldConfig = (\n\tlocalize = true,\n\tomitShared: readonly OmittableSharedField[] = []\n): Field[] => {\n\tconst omit = new Set<string>(omitShared)\n\t// `name` is the storage key every read and write path gates on (`isNamedField`). The type\n\t// already excludes it; dropping it here too keeps an untyped caller from breaking storage.\n\tomit.delete('name')\n\treturn applyOmissions(baseSharedFieldConfig(localize), omit)\n}\n\n/**\n * The single field of every field block: unnamed tabs (presentational only, data paths stay flat).\n * Field tab holds the shared basics plus the type's own config; Validation holds the rule blocks and\n * `validateWhen`; Advanced holds `visibleWhen` and `hidden`. `visibleWhen`/`validateWhen` store a\n * canonical Payload `Where`, edited by the native condition builder.\n */\ntype FieldBlockTabsArgs = {\n\tconditionTypes: Record<string, ConditionFieldType>\n\ttypeConfig: Field[]\n\tvalidations: Field\n\tlocalize?: boolean\n\t/** See `FormFieldDefinition.omitShared`: shared basics this type never uses, left unauthored. */\n\tomitShared?: readonly OmittableSharedField[]\n}\n\nexport const fieldBlockTabs = ({\n\tconditionTypes,\n\ttypeConfig,\n\tvalidations,\n\tlocalize = true,\n\tomitShared,\n}: FieldBlockTabsArgs): Field => ({\n\ttype: 'tabs',\n\ttabs: [\n\t\t{\n\t\t\tlabel: labelFor(keys.tabField),\n\t\t\tfields: [...sharedFieldConfig(localize, omitShared), ...typeConfig],\n\t\t},\n\t\t{\n\t\t\tlabel: labelFor(keys.tabValidation),\n\t\t\tfields: [\n\t\t\t\tvalidations,\n\t\t\t\tconditionField('validateWhen', keys.configValidateWhen, conditionTypes),\n\t\t\t],\n\t\t},\n\t\t{\n\t\t\tlabel: labelFor(keys.tabAdvanced),\n\t\t\tfields: [\n\t\t\t\tconditionField('visibleWhen', keys.configVisibleWhen, conditionTypes),\n\t\t\t\t{ name: 'hidden', type: 'checkbox', label: labelFor(keys.configHidden) },\n\t\t\t],\n\t\t},\n\t],\n})\n"],"mappings":"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"}

package/dist/fields/types.d.ts

@@ -1,6 +1,8 @@
+import { PollOption } from "../poll/definePollOptionSource.js";
+import { FormFieldInstance } from "../submissions/types.js";
 import { FileRef } from "../uploads/types.js";
 import { ConditionFieldType } from "../conditions/fieldTypes.js";
-import { Field } from "payload";
+import { Field, Payload, PayloadRequest } from "payload";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/fields/types.d.ts
@@ -23,6 +25,12 @@ type ValueKindTypeMap = {
 type ValueOfKind<K extends FormFieldValueKind> = ValueKindTypeMap[K];
 /** Resolved per-instance config values for a field type (loose at the DB boundary, narrowed by the author's generic). */
 type FormFieldConfigValues = Record<string, unknown>;
+/**
+ * The shared config fields a type may drop via {@link FormFieldDefinition.omitShared}. `name` is
+ * deliberately absent and can never be dropped: it is the storage key every read and write path
+ * gates on (see `isNamedField`), so a named field without it would silently store nothing.
+ */
+type OmittableSharedField = 'label' | 'placeholder' | 'description' | 'width' | 'required';
 /** A `t`-like resolver. The engine supplies one from the request i18n; the renderer will supply the client i18n. */
 type Translate = (key: string) => string;
 type FormFieldValidateArgs<K extends FormFieldValueKind, TConfig extends FormFieldConfigValues> = {
@@ -42,6 +50,16 @@ type FormFieldFormatArgs<K extends FormFieldValueKind, TConfig extends FormField
   t: Translate;
 };
 type FormFieldFormat<K extends FormFieldValueKind, TConfig extends FormFieldConfigValues> = (args: FormFieldFormatArgs<K, TConfig>) => string;
+/** Arguments a {@link FormFieldDefinition.resolveOptions} implementation receives. */
+type ResolveFieldOptionsArgs = {
+  /** The configured field instance, so the resolver can read the values the author selected. */instance: FormFieldInstance;
+  form: {
+    id: number | string;
+    title?: string;
+  };
+  payload: Payload;
+  req?: PayloadRequest;
+};
 /**
  * A field type, authored once. `value` drives typed `validate`/`format`; `config` is a Payload
  * `Field[]` for the add-field drawer; `Field` is the client renderer import-map ref;
@@ -54,11 +72,46 @@ type FormFieldDefinition<K extends FormFieldValueKind = FormFieldValueKind, TCon
   config?: Field[];
   validate?: FormFieldValidate<K, TConfig>;
   format?: FormFieldFormat<K, TConfig>;
-  Field?: string; /** Optional Standard Schema validator (Zod/Valibot/etc.), run by the engine after the intrinsic validator. */
+  Field?: string;
+  /**
+   * Import-map ref for a custom block row Label, replacing the default `FieldBlockLabel` for this
+   * type's add-field block. Receives the same `{ typeLabelKey }` clientProps. The `consent` type
+   * uses this to resolve and show the referenced source's name.
+   */
+  blockLabel?: string; /** Optional Standard Schema validator (Zod/Valibot/etc.), run by the engine after the intrinsic validator. */
   schema?: StandardSchemaV1;
   icon?: string;
   group?: string; /** How this field appears in the condition builder. Defaults from `value` (see `defaultConditionType`). */
   conditionType?: ConditionFieldType;
+  /**
+   * Bare definitions render without the shared chrome: no name/label/width/required/placeholder/
+   * description and no validation tabs; the definition's `config` IS the entire block. Instances
+   * are nameless (identified by Payload's hidden block row `id`, see `fieldKey`), so bare types
+   * must be display-only (`value: 'none'`): with no name there is nothing to validate or store.
+   */
+  bare?: boolean;
+  /**
+   * Shared config fields this type never uses, so authors are not offered a setting the renderer
+   * ignores (e.g. a placeholder on a checkbox). Unlike `bare`, which drops the shared chrome
+   * wholesale, this keeps the rest of it. An emptied layout row collapses and a lone survivor
+   * spans the row (see `sharedFieldConfig`).
+   */
+  omitShared?: OmittableSharedField[];
+  /**
+   * The type can be chosen as a poll's results field. Its instances must produce enumerable
+   * answers: either authored `options` or options resolved from a poll option source.
+   */
+  pollEligible?: boolean;
+  /**
+   * Source this `pollEligible` type's poll choices from the field instance itself, instead of
+   * authored `options` or a poll `optionSource`. A type that holds enumerable data (for example a
+   * `hasMany` relationship to the voteable records) returns one {@link PollOption} per selectable
+   * value, read from the live instance the author configured (so it can `payload.find` over the
+   * ids it holds). The result backs submission validation, the admin winner select, and results
+   * labeling exactly like a source would; it is consulted after an `optionSource` and before the
+   * instance's authored `options`.
+   */
+  resolveOptions?: (args: ResolveFieldOptionsArgs) => PollOption[] | Promise<PollOption[]>;
 };
 /** The erased shape stored in the heterogeneous registry. Value is `unknown`; config re-narrows per matched type at execution. */
 type AnyFormFieldValidate = (args: {
@@ -83,12 +136,17 @@ type AnyFormFieldDefinition = {
   config?: Field[];
   validate?: AnyFormFieldValidate;
   format?: AnyFormFieldFormat;
-  Field?: string;
+  Field?: string; /** See `FormFieldDefinition.blockLabel`: import-map ref for a custom block row Label. */
+  blockLabel?: string;
   schema?: StandardSchemaV1;
   icon?: string;
   group?: string; /** How this field appears in the condition builder. Defaults from `value` (see `defaultConditionType`). */
-  conditionType?: ConditionFieldType;
+  conditionType?: ConditionFieldType; /** See `FormFieldDefinition.bare`: the block is the definition's `config` alone, instances are nameless. */
+  bare?: boolean; /** See `FormFieldDefinition.omitShared`: shared config fields this type never uses, never authored. */
+  omitShared?: OmittableSharedField[]; /** See `FormFieldDefinition.pollEligible`: choosable as a poll's results field. */
+  pollEligible?: boolean; /** See `FormFieldDefinition.resolveOptions`: source poll choices from the instance itself. */
+  resolveOptions?: (args: ResolveFieldOptionsArgs) => PollOption[] | Promise<PollOption[]>;
 };
 //#endregion
-export { AnyFormFieldDefinition, FormFieldConfigValues, FormFieldDefinition, FormFieldFormat, FormFieldValidate, FormFieldValueKind, Translate };
+export { AnyFormFieldDefinition, FormFieldConfigValues, FormFieldDefinition, FormFieldFormat, FormFieldValidate, FormFieldValueKind, OmittableSharedField, ResolveFieldOptionsArgs, Translate };
 //# sourceMappingURL=types.d.ts.map

package/dist/flow/engine.d.ts

@@ -3,14 +3,16 @@ import { FormFlow } from "./types.js";
 //#region src/flow/engine.d.ts
 /** The entry step id (the first step), or `undefined` for an empty flow. */
 declare const firstStepId: (flow: FormFlow) => string | undefined;
-/** The field machine names a step renders (empty for an unknown step). */
+/** The field keys a step renders (names for named fields, block row ids for bare blocks; empty for an unknown step). */
 declare const stepFieldNames: (flow: FormFlow, id: string) => string[];
 /**
- * Resolve the next step id from the current step + answers: the first transition whose `when` matches
- * (via `evaluateCondition`), else the default `next`, else `undefined` (terminal). Pure + isomorphic.
+ * Resolve the next step id from the current step + answers. Precedence: the first transition whose
+ * `when` matches (via `evaluateCondition`) wins, else the step's `next` (a step id to jump to, or
+ * `null` for an explicit end), else the next step in array order (the last step ends the flow).
+ * Returns `undefined` when the flow ends here. Pure + isomorphic.
  */
 declare const resolveNextStepId: (flow: FormFlow, currentId: string, answers: Record<string, unknown>) => string | undefined;
-/** Whether the current step is terminal (no matching transition + no default next). */
+/** Whether the flow ends at the current step (`resolveNextStepId` finds no step to advance to). */
 declare const isTerminalStepId: (flow: FormFlow, currentId: string, answers: Record<string, unknown>) => boolean;
 //#endregion
 export { firstStepId, isTerminalStepId, resolveNextStepId, stepFieldNames };

package/dist/flow/engine.js

@@ -4,19 +4,24 @@ import { evaluateCondition } from "../conditions/evaluate.js";
 const firstStepId = (flow) => flow.steps[0]?.id;
 /** The step with the given id, or `undefined`. */
 const getStep = (flow, id) => flow.steps.find((step) => step.id === id);
-/** The field machine names a step renders (empty for an unknown step). */
+/** The field keys a step renders (names for named fields, block row ids for bare blocks; empty for an unknown step). */
 const stepFieldNames = (flow, id) => getStep(flow, id)?.fields ?? [];
 /**
-* Resolve the next step id from the current step + answers: the first transition whose `when` matches
-* (via `evaluateCondition`), else the default `next`, else `undefined` (terminal). Pure + isomorphic.
+* Resolve the next step id from the current step + answers. Precedence: the first transition whose
+* `when` matches (via `evaluateCondition`) wins, else the step's `next` (a step id to jump to, or
+* `null` for an explicit end), else the next step in array order (the last step ends the flow).
+* Returns `undefined` when the flow ends here. Pure + isomorphic.
 */
 const resolveNextStepId = (flow, currentId, answers) => {
-	const step = getStep(flow, currentId);
+	const index = flow.steps.findIndex((step) => step.id === currentId);
+	const step = flow.steps[index];
 	if (!step) return;
 	for (const transition of step.transitions ?? []) if (evaluateCondition(transition.when, answers)) return transition.to;
-	return step.next;
+	if (step.next === null) return;
+	if (step.next !== void 0) return step.next;
+	return flow.steps[index + 1]?.id;
 };
-/** Whether the current step is terminal (no matching transition + no default next). */
+/** Whether the flow ends at the current step (`resolveNextStepId` finds no step to advance to). */
 const isTerminalStepId = (flow, currentId, answers) => resolveNextStepId(flow, currentId, answers) === void 0;
 //#endregion
 export { firstStepId, isTerminalStepId, resolveNextStepId, stepFieldNames };

package/dist/flow/engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine.js","names":[],"sources":["../../src/flow/engine.ts"],"sourcesContent":["import { evaluateCondition } from '../conditions/evaluate'\nimport type { FlowStep, FormFlow } from './types'\n\n/** The entry step id (the first step), or `undefined` for an empty flow. */\nexport const firstStepId = (flow: FormFlow): string | undefined => flow.steps[0]?.id\n\n/** The step with the given id, or `undefined`. */\nexport const getStep = (flow: FormFlow, id: string): FlowStep | undefined =>\n\tflow.steps.find((step) => step.id === id)\n\n/** The field machine names a step renders (empty for an unknown step). */\nexport const stepFieldNames = (flow: FormFlow, id: string): string[] =>\n\tgetStep(flow, id)?.fields ?? []\n\n/**\n * Resolve the next step id from the current step + answers: the first transition whose `when` matches\n * (via `evaluateCondition`), else the default `next`, else `undefined` (terminal). Pure + isomorphic.\n */\nexport const resolveNextStepId = (\n\tflow: FormFlow,\n\tcurrentId: string,\n\tanswers: Record<string, unknown>\n): string | undefined => {\n\tconst step = getStep(flow, currentId)\n\tif (!step) {\n\t\treturn undefined\n\t}\n\tfor (const transition of step.transitions ?? []) {\n\t\tif (evaluateCondition(transition.when, answers)) {\n\t\t\treturn transition.to\n\t\t}\n\t}\n\treturn step.next\n}\n\n/** Whether the current step is terminal (no matching transition + no default next). */\nexport const isTerminalStepId = (\n\tflow: FormFlow,\n\tcurrentId: string,\n\tanswers: Record<string, unknown>\n): boolean => resolveNextStepId(flow, currentId, answers) === undefined\n"],"mappings":";;;AAIA,MAAa,eAAe,SAAuC,KAAK,MAAM,IAAI;;AAGlF,MAAa,WAAW,MAAgB,OACvC,KAAK,MAAM,MAAM,SAAS,KAAK,OAAO,EAAE;;AAGzC,MAAa,kBAAkB,MAAgB,OAC9C,QAAQ,MAAM,EAAE,GAAG,UAAU,CAAC;;;;;AAM/B,MAAa,qBACZ,MACA,WACA,YACwB;CACxB,MAAM,OAAO,QAAQ,MAAM,SAAS;CACpC,IAAI,CAAC,MACJ;CAED,KAAK,MAAM,cAAc,KAAK,eAAe,CAAC,GAC7C,IAAI,kBAAkB,WAAW,MAAM,OAAO,GAC7C,OAAO,WAAW;CAGpB,OAAO,KAAK;AACb;;AAGA,MAAa,oBACZ,MACA,WACA,YACa,kBAAkB,MAAM,WAAW,OAAO,MAAM,KAAA"}
+{"version":3,"file":"engine.js","names":[],"sources":["../../src/flow/engine.ts"],"sourcesContent":["import { evaluateCondition } from '../conditions/evaluate'\nimport type { FlowStep, FormFlow } from './types'\n\n/** The entry step id (the first step), or `undefined` for an empty flow. */\nexport const firstStepId = (flow: FormFlow): string | undefined => flow.steps[0]?.id\n\n/** The step with the given id, or `undefined`. */\nexport const getStep = (flow: FormFlow, id: string): FlowStep | undefined =>\n\tflow.steps.find((step) => step.id === id)\n\n/** The field keys a step renders (names for named fields, block row ids for bare blocks; empty for an unknown step). */\nexport const stepFieldNames = (flow: FormFlow, id: string): string[] =>\n\tgetStep(flow, id)?.fields ?? []\n\n/**\n * Resolve the next step id from the current step + answers. Precedence: the first transition whose\n * `when` matches (via `evaluateCondition`) wins, else the step's `next` (a step id to jump to, or\n * `null` for an explicit end), else the next step in array order (the last step ends the flow).\n * Returns `undefined` when the flow ends here. Pure + isomorphic.\n */\nexport const resolveNextStepId = (\n\tflow: FormFlow,\n\tcurrentId: string,\n\tanswers: Record<string, unknown>\n): string | undefined => {\n\tconst index = flow.steps.findIndex((step) => step.id === currentId)\n\tconst step = flow.steps[index]\n\tif (!step) {\n\t\treturn undefined\n\t}\n\tfor (const transition of step.transitions ?? []) {\n\t\tif (evaluateCondition(transition.when, answers)) {\n\t\t\treturn transition.to\n\t\t}\n\t}\n\tif (step.next === null) {\n\t\treturn undefined\n\t}\n\tif (step.next !== undefined) {\n\t\treturn step.next\n\t}\n\treturn flow.steps[index + 1]?.id\n}\n\n/** Whether the flow ends at the current step (`resolveNextStepId` finds no step to advance to). */\nexport const isTerminalStepId = (\n\tflow: FormFlow,\n\tcurrentId: string,\n\tanswers: Record<string, unknown>\n): boolean => resolveNextStepId(flow, currentId, answers) === undefined\n"],"mappings":";;;AAIA,MAAa,eAAe,SAAuC,KAAK,MAAM,IAAI;;AAGlF,MAAa,WAAW,MAAgB,OACvC,KAAK,MAAM,MAAM,SAAS,KAAK,OAAO,EAAE;;AAGzC,MAAa,kBAAkB,MAAgB,OAC9C,QAAQ,MAAM,EAAE,GAAG,UAAU,CAAC;;;;;;;AAQ/B,MAAa,qBACZ,MACA,WACA,YACwB;CACxB,MAAM,QAAQ,KAAK,MAAM,WAAW,SAAS,KAAK,OAAO,SAAS;CAClE,MAAM,OAAO,KAAK,MAAM;CACxB,IAAI,CAAC,MACJ;CAED,KAAK,MAAM,cAAc,KAAK,eAAe,CAAC,GAC7C,IAAI,kBAAkB,WAAW,MAAM,OAAO,GAC7C,OAAO,WAAW;CAGpB,IAAI,KAAK,SAAS,MACjB;CAED,IAAI,KAAK,SAAS,KAAA,GACjB,OAAO,KAAK;CAEb,OAAO,KAAK,MAAM,QAAQ,IAAI;AAC/B;;AAGA,MAAa,oBACZ,MACA,WACA,YACa,kBAAkB,MAAM,WAAW,OAAO,MAAM,KAAA"}

package/dist/flow/normalizeFlow.js

@@ -1,14 +1,23 @@
 //#region src/flow/normalizeFlow.ts
 const isRecord = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
 /**
-* Pure guard that normalizes a raw (possibly untrusted) flow value against the
-* form's current field list. Returns `undefined` when the flow is absent, empty,
-* or resolves to fewer than two steps (a single step is an ordinary form).
-* A field assigned to multiple steps keeps only its first occurrence in step order.
+* Pure guard that normalizes a raw (possibly untrusted) flow value against the form's current
+* field keys (machine names for named fields, block row ids for bare blocks; see `fieldKey`).
+* Returns `undefined` when the flow is absent, empty, or resolves to fewer than two steps
+* (a single step is an ordinary form). A field assigned to multiple steps keeps only its
+* first occurrence in step order. `next: null` (explicit end of form) is preserved as distinct
+* from an absent `next` (sequential fall-through); a `next` pointing at an unknown step is
+* dropped to absent.
+*
+* A step is kept even when it ends up with no fields, which happens when every field it named was
+* deleted from the form. Dropping it would be wrong twice over: a host can render its own content
+* per step off `useFormStep()`, so an empty step is not necessarily an empty page, and dropping
+* one would strand the `next` and transition targets that point at it. The visitor gets a page with
+* only navigation on it, which is visible to the author in the flow builder and recoverable there.
 */
-const normalizeFlow = (raw, fieldNames) => {
+const normalizeFlow = (raw, fieldKeys) => {
 	if (!isRecord(raw) || !Array.isArray(raw.steps)) return;
-	const knownFields = new Set(fieldNames);
+	const knownFields = new Set(fieldKeys);
 	const rawSteps = raw.steps.filter((s) => isRecord(s) && typeof s.id === "string");
 	const knownIds = new Set(rawSteps.map((s) => s.id));
 	if (knownIds.size < 2) return;
@@ -24,7 +33,7 @@ const normalizeFlow = (raw, fieldNames) => {
 			when: t.when,
 			to: t.to
 		}));
-		const next = typeof s.next === "string" && knownIds.has(s.next) ? s.next : void 0;
+		const next = s.next === null ? null : typeof s.next === "string" && knownIds.has(s.next) ? s.next : void 0;
 		const step = {
 			id,
 			fields