@appinternalleads/ui 0.2.0

package/dist/cjs/fields/control.js

@@ -0,0 +1,343 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LEGAL_PREFERRED = exports.DEFAULT_CONTROL = void 0;
+exports.itemSpec = itemSpec;
+exports.preferredOf = preferredOf;
+exports.controlOf = controlOf;
+exports.resolveHint = resolveHint;
+exports.isVisible = isVisible;
+exports.initialAnswers = initialAnswers;
+exports.validateField = validateField;
+exports.collectErrors = collectErrors;
+exports.validateBlock = validateBlock;
+/**
+ * The spec one element of a list is validated and rendered against.
+ *
+ * Synthesised rather than declared, because a list states its element type once and its elements
+ * are positional. The key is the index, so a nested error lands at `tags.2` — the same dotted
+ * path the renderer looks itself up by.
+ */
+function itemSpec(field, index) {
+    return {
+        key: String(index),
+        type: field.itemType ?? 'text',
+        label: `${field.label} ${index + 1}`,
+        options: field.options,
+        source: field.source,
+    };
+}
+/**
+ * The default control for each type, so a spec that omits `control` still renders.
+ *
+ * This table and §5 of `spec/QUESTION-SCHEMA.md` are the same table. The schema's `default`
+ * keywords are documentation — ajv does not apply defaults unless asked, and relying on it to
+ * would put the fallback in the validator rather than in the renderer, which is the one place
+ * it is always needed.
+ */
+exports.DEFAULT_CONTROL = {
+    text: 'single',
+    email: 'single',
+    number: 'single',
+    toggle: 'switch',
+    date: 'picker',
+    datetime: 'picker',
+    enum: 'select',
+    list: 'tags',
+    group: 'section',
+    variant: 'tabs',
+    json: 'code',
+    range: 'track',
+    counters: 'rows',
+    share: 'donut',
+    file: 'dropzone',
+    media: 'audio',
+    action: 'buttons',
+};
+/**
+ * **The `preferred` hint, resolved.** Returns the widget a spec asks for, or `undefined`.
+ *
+ * A hint is honoured only when it is legal for the field's own type and control (decision Q2b).
+ * An illegal one is **dropped, not rejected** — that is the whole safety property: a stored
+ * `preferred` that a later schema change makes illegal degrades to the derived widget instead of
+ * failing a question that was valid when it was written.
+ */
+exports.LEGAL_PREFERRED = {
+    text: ['text-input-field', 'text-field', 'text-area'],
+    email: ['text-input-field', 'text-field'],
+    number: ['slider', 'numerical-holder'],
+    enum: ['dropdown', 'radio-button', 'horizontal-list-picker', 'card-picker', 'arc-picker', 'checkboxes'],
+    date: ['date-time-picker'],
+    datetime: ['date-time-picker'],
+    range: ['range-picker'],
+    counters: ['counter-group'],
+    share: ['pie-chart-picker'],
+    file: ['file-upload'],
+    media: ['voice-recorder'],
+    action: ['button'],
+};
+function preferredOf(field) {
+    const want = field.preferred;
+    if (!want)
+        return undefined;
+    /* Multi-select cannot be drawn by a single-select widget, whatever the hint says. */
+    const multi = field.type === 'enum' && field.multiple === true;
+    const singleOnly = ['dropdown', 'radio-button', 'arc-picker', 'horizontal-list-picker'];
+    if (multi && singleOnly.includes(want))
+        return undefined;
+    if (!multi && want === 'checkboxes')
+        return undefined;
+    return exports.LEGAL_PREFERRED[field.type]?.includes(want) ? want : undefined;
+}
+function controlOf(field) {
+    return field.control ?? exports.DEFAULT_CONTROL[field.type];
+}
+/**
+ * Interpolate `{default}` and `{constraints.*}` into a hint.
+ *
+ * The copy that motivated this read *"Top 10 of 47 will be shown for review"* with both numbers
+ * written out — correct exactly until someone changes `max`, and then it is a lie that nothing
+ * detects. An unresolvable reference is left visible as `{whatever}` rather than blanked: a
+ * broken template that shows its own braces gets noticed and fixed, one that silently renders
+ * an empty gap does not.
+ */
+/** `default` is absent on three of the seventeen types — a file, a recording and an action. */
+function defaultOf(field) {
+    return 'default' in field ? field.default : undefined;
+}
+function resolveHint(field) {
+    if (!field.hint)
+        return undefined;
+    return field.hint.replace(/\{([a-z]+(?:\.[a-zA-Z]+)?)\}/g, (whole, path) => {
+        if (path === 'default') {
+            const d = defaultOf(field);
+            return d === undefined ? whole : String(d);
+        }
+        const [head, tail] = path.split('.');
+        if (head === 'constraints' && tail) {
+            /* `in` rather than a cast: `toggle` genuinely has no `constraints`, and the union is
+               right to say so. A template referencing one on a toggle resolves to nothing and stays
+               visible, which is the same failure mode as any other unresolvable reference. */
+            const c = 'constraints' in field ? field.constraints : undefined;
+            const v = c?.[tail];
+            return v === undefined ? whole : String(v);
+        }
+        return whole;
+    });
+}
+/** A field renders only when every `showIf` entry matches the answers so far. */
+function isVisible(field, answers) {
+    if (!field.showIf)
+        return true;
+    return Object.entries(field.showIf).every(([k, v]) => answers[k] === v);
+}
+/** Seed answers from `default`. A field with no default starts absent, never as `''`. */
+function initialAnswers(block) {
+    const out = {};
+    for (const f of block.fields) {
+        const d = defaultOf(f);
+        if (d !== undefined)
+            out[f.key] = d;
+        /* `counters` seeds from its rows rather than from one `default` object, because each row
+           carries its own — and a row with no default still has to exist in the answer. */
+        if (f.type === 'counters' && d === undefined) {
+            out[f.key] = Object.fromEntries(f.rows.map(r => [r.key, r.default ?? 0]));
+        }
+    }
+    return out;
+}
+const EMAIL = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+/**
+ * UTF-8 byte length, without `TextEncoder`.
+ *
+ * **`TextEncoder` is not in React Native's type environment** — it exists at runtime on Hermes but
+ * `tsc` in an app with no DOM lib rejects it, which is exactly how this file failed the moment a
+ * consumer typechecked against the package. Counting the code points is portable and needs no lib.
+ */
+function utf8Bytes(s) {
+    let n = 0;
+    for (const ch of s) {
+        const c = ch.codePointAt(0) ?? 0;
+        n += c < 0x80 ? 1 : c < 0x800 ? 2 : c < 0x10000 ? 3 : 4;
+    }
+    return n;
+}
+/**
+ * Runtime validation of one answer.
+ *
+ * The JSON Schema constrains what an AUTHOR may write; this constrains what a USER may enter.
+ * They are different jobs on the same keys, which is why `maxLength` appears in both and means
+ * something different in each.
+ *
+ * Returns an error string, or `undefined` when the value is acceptable.
+ */
+function validateField(field, value, options) {
+    /* `false` is an ANSWER on a toggle, not an absence. Treating it as empty would make every
+       unchecked required checkbox unsubmittable while looking answered. */
+    const empty = field.type === 'toggle'
+        ? value === undefined || value === null
+        : value === undefined || value === null || value === '';
+    if (empty && field.type !== 'group' && field.type !== 'variant') {
+        return field.required ? `${field.label} is required.` : undefined;
+    }
+    if (field.type === 'enum') {
+        const allowed = options ?? field.options;
+        /* No `options` and no resolved list means the host has not answered `source` yet. That is a
+           loading state, not an invalid answer — reporting it as one would blame the user for the
+           app's timing. */
+        if (!allowed)
+            return undefined;
+        /**
+         * ⚠ **Normalised, because `options` and `field.options` are different shapes.**
+         *
+         * A resolved list is `string[]`; a spec's own list is `OptionEntry[]`, which is *either*
+         * bare strings or `{ value, label }` objects. Comparing against the raw array matched bare
+         * strings and never matched a rich option — so every `cards`, `chips` or noted `radio` field
+         * reported *"… is not one of the options"* for an answer that came from its own list.
+         * Measured on `15-horizontal-list-picker`: `default: 'balanced'`, an option with that exact
+         * value, and the block would not submit.
+         */
+        const values = allowed.map(o => (typeof o === 'string' ? o : o.value));
+        /**
+         * **`multiple` answers with an ARRAY, and each element is checked on its own.**
+         *
+         * `String(['maya','tobias'])` is `'maya,tobias'`, which is in no option list ever written —
+         * so a multi-select could not be valid at all. Decision Q3a put multi-select on `enum` as a
+         * flag; the validator had not followed it here.
+         */
+        if (field.multiple === true) {
+            if (!Array.isArray(value))
+                return `${field.label} is not one of the options.`;
+            return value.every(v => values.includes(String(v)))
+                ? undefined
+                : `${field.label} is not one of the options.`;
+        }
+        return values.includes(String(value)) ? undefined : `${field.label} is not one of the options.`;
+    }
+    if (field.type === 'group') {
+        /* A group has no error of its own — everything wrong with it is wrong with a child, and
+           reporting "Contact is required" above three fields that each say what they need is noise
+           stacked on top of the answer. */
+        return undefined;
+    }
+    if (field.type === 'variant') {
+        const v = value;
+        if (!v?.variant)
+            return field.required ? `${field.label} is required.` : undefined;
+        return field.children.some(c => c.key === v.variant)
+            ? undefined
+            : `${field.label} is not one of the options.`;
+    }
+    if (field.type === 'list') {
+        const items = Array.isArray(value) ? value : [];
+        const { minItems, maxItems } = field.constraints ?? {};
+        if (minItems !== undefined && items.length < minItems) {
+            return `${field.label} needs at least ${minItems} ${minItems === 1 ? 'item' : 'items'}.`;
+        }
+        if (maxItems !== undefined && items.length > maxItems) {
+            return `${field.label} allows at most ${maxItems} ${maxItems === 1 ? 'item' : 'items'}.`;
+        }
+        return undefined;
+    }
+    if (field.type === 'date' || field.type === 'datetime') {
+        const s = String(value);
+        if (Number.isNaN(Date.parse(s)))
+            return `${field.label} is not a valid date.`;
+        const { min, max } = field.constraints ?? {};
+        /* Compared as ISO STRINGS, not as Dates. ISO sorts lexicographically, and parsing a
+           date-only value to a Date drags in a timezone the field never had — which is how a date
+           one day inside the bound starts failing for users west of UTC. */
+        if (min !== undefined && s < min)
+            return `${field.label} must be ${min} or later.`;
+        if (max !== undefined && s > max)
+            return `${field.label} must be ${max} or earlier.`;
+        return undefined;
+    }
+    if (field.type === 'json') {
+        const s = String(value);
+        const max = field.constraints?.maxBytes;
+        if (max !== undefined && utf8Bytes(s) > max) {
+            return `${field.label} must be ${max} bytes or fewer.`;
+        }
+        try {
+            JSON.parse(s);
+        }
+        catch {
+            return `${field.label} is not valid JSON.`;
+        }
+        return undefined;
+    }
+    if (field.type === 'text' || field.type === 'email') {
+        const s = String(value);
+        const c = field.constraints ?? {};
+        if ('minLength' in c && typeof c.minLength === 'number' && s.length < c.minLength) {
+            return `${field.label} must be at least ${c.minLength} characters.`;
+        }
+        if (typeof c.maxLength === 'number' && s.length > c.maxLength) {
+            return `${field.label} must be ${c.maxLength} characters or fewer.`;
+        }
+        if (field.type === 'email' && !EMAIL.test(s))
+            return 'Enter a valid email address.';
+        if ('pattern' in c && typeof c.pattern === 'string' && !new RegExp(c.pattern).test(s)) {
+            return `${field.label} is not in the expected format.`;
+        }
+        return undefined;
+    }
+    if (field.type === 'number') {
+        const n = typeof value === 'number' ? value : Number(value);
+        if (!Number.isFinite(n))
+            return `${field.label} must be a number.`;
+        const c = field.constraints ?? {};
+        if (typeof c.min === 'number' && n < c.min)
+            return `${field.label} must be ${c.min} or more.`;
+        if (typeof c.max === 'number' && n > c.max)
+            return `${field.label} must be ${c.max} or less.`;
+        return undefined;
+    }
+    return undefined;
+}
+/** Every error in the block, keyed by field. Skips fields hidden by `showIf`. */
+/**
+ * Validates one field and everything inside it, writing dotted paths into `out`.
+ *
+ * **A composite reports its own error AND its children's.** A list that is too short and whose
+ * second element is also invalid has two problems, and surfacing one at a time makes the user
+ * fix, resubmit, and discover the next — which is the slowest possible way to fill in a form.
+ */
+function collectErrors(field, value, path, options, out) {
+    const own = validateField(field, value, options?.[path] ?? options?.[field.key]);
+    if (own)
+        out[path] = own;
+    if (field.type === 'list') {
+        const items = Array.isArray(value) ? value : [];
+        items.forEach((item, i) => {
+            collectErrors(itemSpec(field, i), item, `${path}.${i}`, options, out);
+        });
+    }
+    if (field.type === 'group') {
+        const obj = (value ?? {});
+        for (const child of field.children) {
+            if (!isVisible(child, obj))
+                continue;
+            collectErrors(child, obj[child.key], `${path}.${child.key}`, options, out);
+        }
+    }
+    if (field.type === 'variant') {
+        /* **Only the SELECTED branch is validated.** The others are not incomplete answers, they
+           are answers the user did not give — reporting them would make every variant permanently
+           invalid no matter what was filled in. */
+        const v = value;
+        const child = field.children.find(c => c.key === v?.variant);
+        if (child)
+            collectErrors(child, v?.value, `${path}.${child.key}`, options, out);
+    }
+}
+function validateBlock(block, answers, options) {
+    const errors = {};
+    for (const f of block.fields) {
+        if (!isVisible(f, answers))
+            continue;
+        collectErrors(f, answers[f.key], f.key, options, errors);
+    }
+    return errors;
+}
+//# sourceMappingURL=control.js.map

package/dist/cjs/fields/control.js.map

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

package/dist/cjs/fields/index.js

@@ -0,0 +1,62 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.supersede = exports.overrode = exports.answerBlock = exports.lintQuestion = exports.SOFT_FIELD_LIMIT = exports.validateField = exports.validateBlock = exports.resolveHint = exports.preferredOf = exports.itemSpec = exports.isVisible = exports.initialAnswers = exports.collectErrors = exports.controlOf = exports.LEGAL_PREFERRED = exports.DEFAULT_CONTROL = exports.FieldShell = exports.FieldRenderer = exports.VariantField = exports.GroupField = exports.ListField = exports.DateField = exports.JsonField = exports.EnumField = exports.ToggleField = exports.NumberField = exports.TextInputField = exports.QuestionBlock = void 0;
+var QuestionBlock_1 = require("./QuestionBlock");
+Object.defineProperty(exports, "QuestionBlock", { enumerable: true, get: function () { return QuestionBlock_1.QuestionBlock; } });
+var TextInputField_1 = require("./TextInputField");
+Object.defineProperty(exports, "TextInputField", { enumerable: true, get: function () { return TextInputField_1.TextInputField; } });
+var NumberField_1 = require("./NumberField");
+Object.defineProperty(exports, "NumberField", { enumerable: true, get: function () { return NumberField_1.NumberField; } });
+var ToggleField_1 = require("./ToggleField");
+Object.defineProperty(exports, "ToggleField", { enumerable: true, get: function () { return ToggleField_1.ToggleField; } });
+var EnumField_1 = require("./EnumField");
+Object.defineProperty(exports, "EnumField", { enumerable: true, get: function () { return EnumField_1.EnumField; } });
+var JsonField_1 = require("./JsonField");
+Object.defineProperty(exports, "JsonField", { enumerable: true, get: function () { return JsonField_1.JsonField; } });
+var DateField_1 = require("./DateField");
+Object.defineProperty(exports, "DateField", { enumerable: true, get: function () { return DateField_1.DateField; } });
+var ListField_1 = require("./ListField");
+Object.defineProperty(exports, "ListField", { enumerable: true, get: function () { return ListField_1.ListField; } });
+var GroupField_1 = require("./GroupField");
+Object.defineProperty(exports, "GroupField", { enumerable: true, get: function () { return GroupField_1.GroupField; } });
+var VariantField_1 = require("./VariantField");
+Object.defineProperty(exports, "VariantField", { enumerable: true, get: function () { return VariantField_1.VariantField; } });
+var FieldRenderer_1 = require("./FieldRenderer");
+Object.defineProperty(exports, "FieldRenderer", { enumerable: true, get: function () { return FieldRenderer_1.FieldRenderer; } });
+var FieldShell_1 = require("./FieldShell");
+Object.defineProperty(exports, "FieldShell", { enumerable: true, get: function () { return FieldShell_1.FieldShell; } });
+var control_1 = require("./control");
+Object.defineProperty(exports, "DEFAULT_CONTROL", { enumerable: true, get: function () { return control_1.DEFAULT_CONTROL; } });
+Object.defineProperty(exports, "LEGAL_PREFERRED", { enumerable: true, get: function () { return control_1.LEGAL_PREFERRED; } });
+Object.defineProperty(exports, "controlOf", { enumerable: true, get: function () { return control_1.controlOf; } });
+Object.defineProperty(exports, "collectErrors", { enumerable: true, get: function () { return control_1.collectErrors; } });
+Object.defineProperty(exports, "initialAnswers", { enumerable: true, get: function () { return control_1.initialAnswers; } });
+Object.defineProperty(exports, "isVisible", { enumerable: true, get: function () { return control_1.isVisible; } });
+Object.defineProperty(exports, "itemSpec", { enumerable: true, get: function () { return control_1.itemSpec; } });
+Object.defineProperty(exports, "preferredOf", { enumerable: true, get: function () { return control_1.preferredOf; } });
+Object.defineProperty(exports, "resolveHint", { enumerable: true, get: function () { return control_1.resolveHint; } });
+Object.defineProperty(exports, "validateBlock", { enumerable: true, get: function () { return control_1.validateBlock; } });
+Object.defineProperty(exports, "validateField", { enumerable: true, get: function () { return control_1.validateField; } });
+var lint_1 = require("./lint");
+Object.defineProperty(exports, "SOFT_FIELD_LIMIT", { enumerable: true, get: function () { return lint_1.SOFT_FIELD_LIMIT; } });
+Object.defineProperty(exports, "lintQuestion", { enumerable: true, get: function () { return lint_1.lintQuestion; } });
+var answer_1 = require("./answer");
+Object.defineProperty(exports, "answerBlock", { enumerable: true, get: function () { return answer_1.answerBlock; } });
+Object.defineProperty(exports, "overrode", { enumerable: true, get: function () { return answer_1.overrode; } });
+Object.defineProperty(exports, "supersede", { enumerable: true, get: function () { return answer_1.supersede; } });
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/fields/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/fields/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iDAAyE;AAAhE,8GAAA,aAAa,OAAA;AACtB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,iDAAyE;AAAhE,8GAAA,aAAa,OAAA;AACtB,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,qCAGmB;AAFjB,0GAAA,eAAe,OAAA;AAAE,0GAAA,eAAe,OAAA;AAAE,oGAAA,SAAS,OAAA;AAAE,wGAAA,aAAa,OAAA;AAAE,yGAAA,cAAc,OAAA;AAAE,oGAAA,SAAS,OAAA;AACrF,mGAAA,QAAQ,OAAA;AAAE,sGAAA,WAAW,OAAA;AAAE,sGAAA,WAAW,OAAA;AAAE,wGAAA,aAAa,OAAA;AAAE,wGAAA,aAAa,OAAA;AAElE,+BAEgB;AADd,wGAAA,gBAAgB,OAAA;AAAE,oGAAA,YAAY,OAAA;AAEhC,mCAA4D;AAAnD,qGAAA,WAAW,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAAE,mGAAA,SAAS,OAAA;AACzC,0CAAwB"}

package/dist/cjs/fields/lint.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SOFT_FIELD_LIMIT = void 0;
+exports.lintQuestion = lintQuestion;
+const control_1 = require("./control");
+const types_1 = require("./types");
+/** §7's soft ceiling. Past this an ask is doing two jobs (decision Q11b). */
+exports.SOFT_FIELD_LIMIT = 6;
+/** Past this many options a menu is a list, and a segmented control is unreadable. */
+const SEGMENTED_MAX = 4;
+const RADIO_MAX = 8;
+function lintQuestion(block) {
+    const out = [];
+    const add = (rule, level, where, message) => out.push({ rule, level, where, message });
+    /**
+     * **A soft limit, and the reason is written down** (decision Q11b). A hard limit gets worked
+     * around by splitting one coherent ask into two incoherent ones, which is worse than the thing
+     * being prevented — so this warns and lets the author decide.
+     */
+    if (block.fields.length > exports.SOFT_FIELD_LIMIT) {
+        add('too-many-fields', 'warn', block.slug, `${block.fields.length} fields in one ask. Past ${exports.SOFT_FIELD_LIMIT} it is usually two asks `
+            + 'wearing one card — but split only if the halves stand alone.');
+    }
+    /**
+     * A halt with no stated cause can read as a bug rather than as a decision waiting on the user —
+     * but only when something actually went wrong, and **nothing in the JSON says whether it did.**
+     * A shortlist review is derived and blocking and perfectly ordinary.
+     *
+     * So this is `info`. Written as a warning first, it fired on `17-card-picker.json`, which is
+     * exactly the failure decision Q10c predicts: a quality rule guessed before there was output to
+     * measure. Promote it if agent output shows unexplained halts are common.
+     */
+    if (block.blocking && !block.reason && block.provenance === 'derived') {
+        add('blocking-without-reason', 'info', block.slug, 'A derived blocking ask with no `reason`. If the run stopped because something went wrong, '
+            + 'say so — the user cannot see what it found.');
+    }
+    if (block.reason && block.blocking === false) {
+        add('reason-without-blocking', 'info', block.slug, '`reason` on a non-blocking ask. Nothing has stopped, so there is nothing to explain.');
+    }
+    for (const f of block.fields)
+        out.push(...lintField(f));
+    return out;
+}
+function lintField(f) {
+    const out = [];
+    const add = (rule, level, message) => out.push({ rule, level, where: f.key, message });
+    const control = (0, control_1.controlOf)(f);
+    if (f.preferred && !(0, control_1.preferredOf)(f)) {
+        add('preferred-dropped', 'info', `\`preferred: "${f.preferred}"\` is not legal for a ${f.type}${f.type === 'enum' && f.multiple ? ' (multiple)' : ''}, so it was dropped. `
+            + 'The derived widget renders instead — this is a note, not a fault.');
+    }
+    if (f.type === 'enum') {
+        const options = f.options?.map(types_1.toOption);
+        if (options) {
+            if (control === 'segmented' && options.length > SEGMENTED_MAX) {
+                add('segmented-too-wide', 'warn', `${options.length} options in a segmented control. Past ${SEGMENTED_MAX} the labels `
+                    + 'shrink below legible — this wants to be a select.');
+            }
+            if (control === 'radio' && options.length > RADIO_MAX) {
+                add('radio-too-long', 'warn', `${options.length} radio rows. Past ${RADIO_MAX} use a select — a list this long is `
+                    + 'scrolled, and a scrolled radio group hides its own options.');
+            }
+            if (control === 'select' && options.length <= RADIO_MAX && options.length > 0) {
+                add('select-too-short', 'info', `${options.length} options behind a menu. Below ${RADIO_MAX} use radio rows — options `
+                    + 'hidden behind a tap are options the user has to remember they can reach.');
+            }
+            /**
+             * **Which controls actually draw a note.** `cards` and `radio` draw one per option;
+             * `chips` draws the SELECTED option's note beneath the row, which is widget 15's whole
+             * point. The rest draw none, and options carrying notes into them lose the run's work.
+             *
+             * ⚠ The form-layer `Chips` control does not draw the note — only the widget-layer
+             * Horizontal List Picker does. Recorded rather than smoothed over: this rule is right
+             * about the widget and optimistic about the form.
+             */
+            const SHOWS_NOTE = ['cards', 'radio', 'chips'];
+            if (options.some(o => o.note) && !SHOWS_NOTE.includes(control)) {
+                add('notes-not-shown', 'warn', 'Options carry `note` text that a ' + control + ' control does not draw. A face showing '
+                    + "only a name has hidden the run's work.");
+            }
+            /**
+             * **A required single-select with no escape, and no working default.**
+             *
+             * Forcing a choice from someone who has none produces a worse answer than admitting the
+             * gap. But **a default IS an escape** — a field that starts on a working answer never
+             * forces an uninformed one, which is why the salary-stance fixture (five preferences, one
+             * sensible default) does not need a way out and the primary-source fixture does.
+             *
+             * The escape is a flag, not a phrase. The well-known wordings stay recognised so a bare
+             * `string[]` still counts, but new options should mark themselves.
+             */
+            if (f.required && !f.multiple && options.length > 1 && f.default === undefined) {
+                /* `toOption` has already applied the wording fallback, so `escape` is the only check. */
+                if (!options.some(o => o.escape)) {
+                    add('no-escape-option', 'warn', 'A required single-select with no escape and no default. Mark the way out with '
+                        + '`escape: true`, or give the field a working default — forcing a choice from '
+                        + 'someone who has none produces a worse answer than the gap does.');
+                }
+            }
+        }
+        if (!f.options && !f.source) {
+            add('enum-without-options', 'warn', 'An enum with neither `options` nor `source` can draw nothing.');
+        }
+    }
+    if (f.type === 'share') {
+        /**
+         * **The one rule the schema cannot hold.** JSON Schema cannot sum an array, and a donut over
+         * numbers that are not a partition is a lie the geometry tells before any label corrects it.
+         */
+        const total = f.options.reduce((a, o) => a + (o.pct ?? 0), 0);
+        if (Math.abs(total - 100) > 0.01) {
+            add('share-does-not-sum', 'warn', `Slices sum to ${total}, not 100. A share widget asserts a partition — if these are not `
+                + 'parts of one whole, this is the wrong widget.');
+        }
+    }
+    if (f.type === 'number' || f.type === 'range') {
+        const c = f.constraints;
+        if ((0, control_1.controlOf)(f) === 'slider' && (c?.min === undefined || c?.max === undefined)) {
+            add('slider-without-bounds', 'warn', 'A slider with no `min`/`max`. The track has no meaning without both ends.');
+        }
+    }
+    if (f.type === 'range' && f.default) {
+        const [lo, hi] = f.default;
+        if (lo >= hi) {
+            add('range-default-inverted', 'warn', `Default \`[${lo}, ${hi}]\` has no width.`);
+        }
+    }
+    if (f.type === 'counters' && !f.counter?.empty) {
+        add('no-zero-consequence', 'info', 'No `counter.empty`. At zero the card will show a count where it should state the '
+            + 'consequence of leaving it there.');
+    }
+    if (f.type === 'action' && !f.consequence.trim()) {
+        add('action-without-consequence', 'warn', 'An action with no consequence sentence asks the user to guess the blast radius.');
+    }
+    if ('children' in f && f.children) {
+        for (const c of f.children)
+            out.push(...lintField(c));
+    }
+    return out;
+}
+//# sourceMappingURL=lint.js.map

package/dist/cjs/fields/lint.js.map

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