@aquera/mcp-ui-render 0.0.1

package/src/elements/aq-mcp-section.js

@@ -0,0 +1,261 @@
+var AqMcpSection_1;
+import { __decorate, __metadata } from "tslib";
+/**
+ * `<aq-mcp-section>` — one section rendered as a card (design Option A): header
+ * with the section label, an `authType` badge, and a save-target caption
+ * ("connector saves · <submitTool>" or "platform saves · applications_update",
+ * §13); a body of two-column fields (applicable, non-hidden, in order, §12,
+ * and — for `test-connection-report`/`permissions-report` specifically — only
+ * once there's actually a value to show, see `hasNothingToShow`); and a save
+ * footer whose button emits `section-submit`. A host may register
+ * a custom footer for `section.key` via `registerSectionFooter` to replace the
+ * default button entirely; absent that, the default "Save <label>" renders.
+ * `showFooter` (default true) is a master switch that hides EITHER — custom
+ * or default — when false, e.g. when the host drives submission itself.
+ * `compact` (set by `<aq-mcp-config>` in `sectionsLayout: 'tabs'` mode) drops
+ * the card's own border + title, since the tab nav already shows the label.
+ *
+ * Light DOM by design (see `<aq-mcp-config>`'s own doc comment) — requires
+ * the host to load `mcp-ui-render.css` globally.
+ */
+import { LitElement, html } from 'lit';
+import { customElement, property } from 'lit/decorators.js';
+import { fieldApplies } from '../engine/values.js';
+import { sectionHasEditableFields } from '../engine/submit.js';
+import { resolveSectionFooter } from '../registry.js';
+import './aq-mcp-field.js';
+/**
+ * `ui-component`s whose control renders NOTHING when there's no value yet
+ * (`test-connection-report`/`permissions-report`'s own "null renders nothing"
+ * rule, see `controls.ts`) — distinct from `properties-table`, which always
+ * shows its own header/toolbar even with zero rows, so it's deliberately not
+ * in this set. Without this filter, `<aq-mcp-field>` still renders its usual
+ * label-left/control-right row for one of these with the right column blank —
+ * a label dangling next to nothing, e.g. "Validation Report" shown before a
+ * host has ever run its test. A field in this set with no value yet is
+ * skipped entirely (no `<aq-mcp-field>` element at all, not even an empty
+ * one), so nothing — not even the row's own padding/border — is left behind.
+ */
+const HIDE_ENTIRELY_WHEN_EMPTY = new Set(['test-connection-report', 'permissions-report']);
+function hasNothingToShow(field, values) {
+    if (!HIDE_ENTIRELY_WHEN_EMPTY.has(field['ui-component']))
+        return false;
+    const value = values[field.attribute];
+    return value === null || value === undefined;
+}
+let AqMcpSection = AqMcpSection_1 = class AqMcpSection extends LitElement {
+    constructor() {
+        super(...arguments);
+        this.values = {};
+        this.errors = {};
+        /** Host-fed options for `select`/`radio` fields resolved dynamically via `field.tool`
+         *  (§9.6) — see `<aq-mcp-config>`'s own `dynamicOptions` property for the full contract. */
+        this.dynamicOptions = {};
+        /** Master switch for this section's footer (§13/§14) — the default "Save
+         *  <label>" button, AND any `registerSectionFooter` override. Default true;
+         *  set false to hide the footer entirely regardless of what's registered,
+         *  e.g. when the host drives submission itself via its own button(s). */
+        this.showFooter = true;
+        /** Set by `<aq-mcp-config>` when this section is rendered as a tab panel
+         *  (`sectionsLayout: 'tabs'`) — drops the card's own border and title
+         *  (the tab nav already shows the label) to avoid double-boxing/duplicate
+         *  labeling. The authType badge and save-target caption still render. */
+        this.compact = false;
+        /** Set by `<aq-mcp-config>` when this section is the body of a
+         *  `nile-accordion` (`sectionsLayout: 'accordion'`). Drops the card AND the
+         *  whole header — the accordion's own summary already carries the label,
+         *  authType badge and completion chips — and lays the body out as a
+         *  two-column grid of label-above-control fields (`dense` is passed down to
+         *  every `<aq-mcp-field>`). The save-target caption moves into the footer,
+         *  the only place it still has anything to explain, and only when a footer
+         *  actually renders. */
+        this.dense = false;
+        /** Column ceiling for the dense field grid — see `<aq-mcp-config>`'s
+         *  `accordionColumns`. Only meaningful when `dense` is set. */
+        this.columns = 2;
+    }
+    createRenderRoot() {
+        return this;
+    }
+    caption() {
+        return this.section.submitTool
+            ? `connector saves · ${this.section.submitTool}`
+            : 'platform saves · applications_update';
+    }
+    saveLabel() {
+        return `Save ${(this.section.label ?? 'changes').toLowerCase()}`;
+    }
+    emitSubmit() {
+        this.dispatchEvent(new CustomEvent('section-submit', { detail: { sectionKey: this.section.key }, bubbles: true, composed: true }));
+    }
+    renderFooter(showSave) {
+        if (!showSave || !this.showFooter)
+            return html ``;
+        const custom = resolveSectionFooter(this.section.key);
+        if (custom) {
+            return custom({ section: this.section, values: this.values, onSubmit: () => this.emitSubmit() });
+        }
+        return html `<div class="aq-mcp-section__footer">
+      ${this.dense ? html `<div class="aq-mcp-section__caption">${this.caption()}</div>` : ''}
+      <nile-button variant="primary" @click=${() => this.emitSubmit()}>${this.saveLabel()}</nile-button>
+    </div>`;
+    }
+    renderHeader() {
+        const s = this.section;
+        // Accordion mode: the accordion's own summary is the header. Rendering a
+        // second one here would repeat the label and badge inside the panel.
+        if (this.dense)
+            return html ``;
+        const badge = s.authType ? html `<nile-badge variant="info">${s.authType}</nile-badge>` : '';
+        if (this.compact) {
+            return html `<div class="aq-mcp-section__header aq-mcp-section__header--compact">
+        ${badge}
+        <div class="aq-mcp-section__caption">${this.caption()}</div>
+      </div>`;
+        }
+        return html `<div class="aq-mcp-section__header">
+      <div class="aq-mcp-section__title">${s.label} ${badge}</div>
+      <div class="aq-mcp-section__caption">${this.caption()}</div>
+    </div>`;
+    }
+    /**
+     * Split the dense (accordion) body into the three zones the design calls for.
+     *
+     * The `bootstrap` descriptor has NO layout vocabulary — no group, column,
+     * width or span key — and its shape is fixed, so this cannot be declared and
+     * has to be derived. It is derived only from data the descriptor already
+     * carries, never from the attribute name or anything else guessed:
+     *
+     *  - **toggles** — `datatype: "boolean"`. Last, full width. A switch with a
+     *    one-line description is a different row shape from a labelled control,
+     *    which is why these group even though it reorders them.
+     *  - **defaults** — has a `defaultValue`, is NOT required, and is not a
+     *    credential. Two-up, below a plain rule. The rule carries NO caption: a
+     *    heading there ("Defaults you can tune") would be the renderer
+     *    describing the connector's own fields in words the descriptor never
+     *    supplied. The separation is conveyed by position and density instead,
+     *    which needs no invented copy.
+     *  - **primary** — everything else, full width, first: required fields,
+     *    credentials, and optional fields the connector gave no default for.
+     *    These are the ones where the user has to supply something.
+     *
+     * The `isRequired`/`secret` exclusions matter: a required field that happens
+     * to carry a default is still something the user must confirm, and a stored
+     * credential is never "a default you can tune" — filing either under that
+     * heading would tell the reader they can skip it.
+     *
+     * This DOES reorder relative to the descriptor's `fields` order, and it is
+     * the only layout that does. Order is preserved WITHIN each zone, so a
+     * connector's intended sequence still shows through.
+     */
+    zones(applied) {
+        const primary = [];
+        const defaults = [];
+        const toggles = [];
+        for (const f of applied) {
+            if (f.datatype === 'boolean')
+                toggles.push(f);
+            else if (AqMcpSection_1.isTunableDefault(f))
+                defaults.push(f);
+            else
+                primary.push(f);
+        }
+        return { primary, defaults, toggles };
+    }
+    /** See `zones()` — "the connector already chose an answer, and you may
+     *  leave it alone". `datatype: "none"` (buttons, reports) has no value to
+     *  default; a required field must still be confirmed; a secret is never a
+     *  tunable default however it was seeded. */
+    static isTunableDefault(f) {
+        return (f.datatype !== 'none' &&
+            f.defaultValue !== undefined &&
+            !f.isRequired &&
+            !f.secret &&
+            !f.writeOnce);
+    }
+    renderFields(fields) {
+        return fields.map((f) => html `<aq-mcp-field
+        class="aq-mcp-field ${this.dense ? 'aq-mcp-field--dense' : ''}"
+        data-attr=${f.attribute}
+        .field=${f}
+        .value=${this.values[f.attribute]}
+        .error=${this.errors[f.attribute] ?? null}
+        .dense=${this.dense}
+        .dynamicOptions=${this.dynamicOptions}
+      ></aq-mcp-field>`);
+    }
+    renderDenseBody(applied) {
+        const { primary, defaults, toggles } = this.zones(applied);
+        const twoUp = this.columns === 2;
+        return html `
+      ${primary.length ? html `<div class="aq-mcp-zone aq-mcp-zone--primary">${this.renderFields(primary)}</div>` : ''}
+      ${defaults.length
+            ? html `
+            <div class="aq-mcp-zone__rule" role="separator"></div>
+            <div class="aq-mcp-zone aq-mcp-zone--defaults ${twoUp ? 'aq-mcp-zone--two-up' : ''}">
+              ${this.renderFields(defaults)}
+            </div>
+          `
+            : ''}
+      ${toggles.length ? html `<div class="aq-mcp-zone aq-mcp-zone--toggles">${this.renderFields(toggles)}</div>` : ''}
+    `;
+    }
+    render() {
+        const s = this.section;
+        if (!s)
+            return html ``;
+        const applied = (s.fields ?? []).filter((f) => !f.hidden && fieldApplies(f, this.values) && !hasNothingToShow(f, this.values));
+        const showSave = sectionHasEditableFields(s, this.values);
+        return html `
+      <div
+        class="aq-mcp-section ${this.compact ? 'aq-mcp-section--compact' : ''} ${this.dense
+            ? 'aq-mcp-section--dense'
+            : ''}"
+        data-section=${s.key}
+      >
+        ${this.renderHeader()}
+        <div class="aq-mcp-section__body ${this.dense ? 'aq-mcp-section__body--dense' : ''}">
+          ${this.dense ? this.renderDenseBody(applied) : this.renderFields(applied)}
+        </div>
+        ${this.renderFooter(showSave)}
+      </div>
+    `;
+    }
+};
+__decorate([
+    property({ attribute: false }),
+    __metadata("design:type", Object)
+], AqMcpSection.prototype, "section", void 0);
+__decorate([
+    property({ attribute: false }),
+    __metadata("design:type", Object)
+], AqMcpSection.prototype, "values", void 0);
+__decorate([
+    property({ attribute: false }),
+    __metadata("design:type", Object)
+], AqMcpSection.prototype, "errors", void 0);
+__decorate([
+    property({ attribute: false }),
+    __metadata("design:type", Object)
+], AqMcpSection.prototype, "dynamicOptions", void 0);
+__decorate([
+    property({ type: Boolean }),
+    __metadata("design:type", Object)
+], AqMcpSection.prototype, "showFooter", void 0);
+__decorate([
+    property({ type: Boolean }),
+    __metadata("design:type", Object)
+], AqMcpSection.prototype, "compact", void 0);
+__decorate([
+    property({ type: Boolean }),
+    __metadata("design:type", Object)
+], AqMcpSection.prototype, "dense", void 0);
+__decorate([
+    property({ type: Number }),
+    __metadata("design:type", Number)
+], AqMcpSection.prototype, "columns", void 0);
+AqMcpSection = AqMcpSection_1 = __decorate([
+    customElement('aq-mcp-section')
+], AqMcpSection);
+export { AqMcpSection };
+//# sourceMappingURL=aq-mcp-section.js.map

package/src/elements/aq-mcp-section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aq-mcp-section.js","sourceRoot":"","sources":["../../../../../apps/mcp-ui-render/src/elements/aq-mcp-section.ts"],"names":[],"mappings":"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"}

package/src/engine/status.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Section-completeness engine — the derived data behind `sectionsLayout:
+ * 'accordion'`'s per-card attention state. A collapsed section shows nothing
+ * of its contents, so something has to answer "is there anything left to do in
+ * here" without opening it; that answer is currently rendered as the card's
+ * tinted edge rather than as header text.
+ *
+ * Deliberately distinct from `<aq-mcp-config>`'s own `sectionHasError()`,
+ * which reads recorded validation errors: a required field the user simply
+ * hasn't reached yet is INCOMPLETE, not INVALID. This module reports
+ * completeness (has a value been supplied), the error machinery keeps
+ * reporting validity (is the supplied value acceptable) — they answer
+ * different questions and neither replaces the other.
+ */
+import type { Section, Values } from '../types.js';
+/** What the accordion header renders from. */
+export interface SectionStatus {
+    /** Applicable, non-hidden, value-bearing fields. */
+    fieldCount: number;
+    requiredEmpty: number;
+    optionalEmpty: number;
+    /**
+     * - `incomplete` — at least one required field has no value (needs attention)
+     * - `complete`   — every counted field has a value
+     * - `required-set` — every REQUIRED field has a value, some optional ones don't
+     * - `neutral`   — nothing to count (a section of buttons/reports only)
+     */
+    state: 'complete' | 'required-set' | 'incomplete' | 'neutral';
+}
+/** Summarise one section against the current values. Pure — no element state. */
+export declare function sectionStatus(section: Section, values: Values): SectionStatus;

package/src/engine/status.js

@@ -0,0 +1,44 @@
+import { fieldApplies } from './values.js';
+import { isEmpty } from './validate.js';
+import { WRITE_ONCE_UNCHANGED } from './submit.js';
+/**
+ * A field counts toward a section's status when it can actually hold a value
+ * the user is expected to supply: same "is this in play" rule
+ * `<aq-mcp-config>`'s `fieldNeedsValidation()` uses, so the chip can never
+ * claim a section is complete while a field it skipped is failing validation.
+ * `datatype: 'none'` (buttons, `test-connection-report`, `permissions-report`,
+ * `properties-table`) is excluded — those never hold a submitted value, and
+ * counting them would inflate "N fields" with things the user can't fill in.
+ */
+function counts(field, values) {
+    return field.datatype !== 'none' && !field.hidden && fieldApplies(field, values);
+}
+/**
+ * A stored write-once secret (§7) is SET, even though its recorded value is
+ * only the sentinel rather than the real secret — the whole point of the
+ * sentinel is "the host already has this on record." Treating it as empty
+ * would flag every saved credentials section as incomplete forever.
+ */
+function hasValue(value) {
+    return value === WRITE_ONCE_UNCHANGED || !isEmpty(value);
+}
+/** Summarise one section against the current values. Pure — no element state. */
+export function sectionStatus(section, values) {
+    let fieldCount = 0;
+    let requiredEmpty = 0;
+    let optionalEmpty = 0;
+    for (const field of section?.fields ?? []) {
+        if (!counts(field, values))
+            continue;
+        fieldCount += 1;
+        if (hasValue(values[field.attribute]))
+            continue;
+        if (field.isRequired)
+            requiredEmpty += 1;
+        else
+            optionalEmpty += 1;
+    }
+    const state = fieldCount === 0 ? 'neutral' : requiredEmpty > 0 ? 'incomplete' : optionalEmpty === 0 ? 'complete' : 'required-set';
+    return { fieldCount, requiredEmpty, optionalEmpty, state };
+}
+//# sourceMappingURL=status.js.map

package/src/engine/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../../apps/mcp-ui-render/src/engine/status.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAiBnD;;;;;;;;GAQG;AACH,SAAS,MAAM,CAAC,KAAY,EAAE,MAAc;IAC1C,OAAO,KAAK,CAAC,QAAQ,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AACnF,CAAC;AAED;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,oBAAoB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,aAAa,CAAC,OAAgB,EAAE,MAAc;IAC5D,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,aAAa,GAAG,CAAC,CAAC;IAEtB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC;YAAE,SAAS;QACrC,UAAU,IAAI,CAAC,CAAC;QAChB,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAAE,SAAS;QAChD,IAAI,KAAK,CAAC,UAAU;YAAE,aAAa,IAAI,CAAC,CAAC;;YACpC,aAAa,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,KAAK,GACT,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC;IAEtH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAC7D,CAAC"}

package/src/engine/submit.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Submit assembly (§14) + save-target resolution (§13).
+ *
+ * Values keyed by `attribute`, only for fields that applied. `datatype:"none"`
+ * and hidden fields submit nothing (hidden omitted = unchanged). A blank
+ * password/`writeOnce` field is omitted (= keep current). Numbers are coerced.
+ * `submitTool` (per section) vs the platform default is carried on the payload;
+ * the library never calls the tool itself.
+ */
+import type { Section, Values } from '../types.js';
+/**
+ * Sentinel a host seeds as a `writeOnce` field's value to mean "a value is
+ * stored, unchanged". The field renders masked + "Replace" (§7) and submit omits
+ * it. Once the user clicks Replace and types, the real value replaces it.
+ */
+export declare const WRITE_ONCE_UNCHANGED = "__aq_write_once_unchanged__";
+export interface SubmitPayload {
+    sectionKey: string;
+    /** Connector tool to call, or null → platform default (`applications_update`) (§13). */
+    submitTool: string | null;
+    values: Values;
+}
+/** Build the submit payload for one section (§13/§14). */
+export declare function collectSubmit(section: Section, values: Values): SubmitPayload;
+/** True when a section has at least one editable (value-bearing, visible, applied) field. */
+export declare function sectionHasEditableFields(section: Section, values: Values): boolean;

package/src/engine/submit.js

@@ -0,0 +1,37 @@
+import { fieldApplies } from './values.js';
+/**
+ * Sentinel a host seeds as a `writeOnce` field's value to mean "a value is
+ * stored, unchanged". The field renders masked + "Replace" (§7) and submit omits
+ * it. Once the user clicks Replace and types, the real value replaces it.
+ */
+export const WRITE_ONCE_UNCHANGED = '__aq_write_once_unchanged__';
+function coerce(field, value) {
+    if (field.datatype === 'number') {
+        const n = Number(value);
+        return Number.isNaN(n) ? value : n;
+    }
+    return value;
+}
+/** Build the submit payload for one section (§13/§14). */
+export function collectSubmit(section, values) {
+    const out = {};
+    for (const field of section.fields ?? []) {
+        if (field.datatype === 'none' || field.hidden)
+            continue;
+        if (!fieldApplies(field, values))
+            continue;
+        const v = values[field.attribute];
+        const isSecretEntry = field['ui-component'] === 'password' || field.writeOnce;
+        if (isSecretEntry && (v == null || v === '' || v === WRITE_ONCE_UNCHANGED))
+            continue; // blank/unchanged
+        if (v === undefined)
+            continue;
+        out[field.attribute] = coerce(field, v);
+    }
+    return { sectionKey: section.key, submitTool: section.submitTool ?? null, values: out };
+}
+/** True when a section has at least one editable (value-bearing, visible, applied) field. */
+export function sectionHasEditableFields(section, values) {
+    return (section.fields ?? []).some((f) => f.datatype !== 'none' && !f.hidden && fieldApplies(f, values));
+}
+//# sourceMappingURL=submit.js.map

package/src/engine/submit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit.js","sourceRoot":"","sources":["../../../../../apps/mcp-ui-render/src/engine/submit.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,6BAA6B,CAAC;AAElE,SAAS,MAAM,CAAC,KAAY,EAAE,KAAc;IAC1C,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AASD,0DAA0D;AAC1D,MAAM,UAAU,aAAa,CAAC,OAAgB,EAAE,MAAc;IAC5D,MAAM,GAAG,GAAW,EAAE,CAAC;IACvB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACzC,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM;YAAE,SAAS;QACxD,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC;YAAE,SAAS;QAC3C,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAClC,MAAM,aAAa,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,UAAU,IAAI,KAAK,CAAC,SAAS,CAAC;QAC9E,IAAI,aAAa,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,oBAAoB,CAAC;YAAE,SAAS,CAAC,kBAAkB;QACxG,IAAI,CAAC,KAAK,SAAS;YAAE,SAAS;QAC9B,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AAC1F,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,wBAAwB,CAAC,OAAgB,EAAE,MAAc;IACvE,OAAO,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CACrE,CAAC;AACJ,CAAC"}

package/src/engine/validate.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Validation engine (bootstrap contract §8). The engine owns the *logic* and
+ * returns a message; the Nile control owns *display* (the caller pushes the
+ * message into the control's `error`/`errorMessage`) — the split from D-7.
+ *
+ * Rules: patterns are ECMAScript regex sources, matched against the whole value,
+ * AND-combined. Emptiness is governed by `isRequired`, not regex. A regex that
+ * fails to compile is a descriptor defect — logged and skipped, never blocking.
+ */
+import type { Field } from '../types.js';
+/**
+ * "Has this field got a value at all" — the single emptiness notion in this
+ * library. Exported (not just used by `validateField`'s `isRequired` check)
+ * so `engine/status.ts`'s section-completeness counts mean exactly the same
+ * thing the required-check means: a whitespace-only string, `[]` and `{}` are
+ * empty; `false` (an off toggle) and a `File` are NOT — they are values a user
+ * chose. Two separate emptiness rules would let a section read "Complete"
+ * while a field it contains still fails validation.
+ */
+export declare function isEmpty(value: unknown): boolean;
+/**
+ * Validate a field's value. Returns the message to show, or null when valid.
+ */
+export declare function validateField(field: Field, value: unknown): string | null;

package/src/engine/validate.js

@@ -0,0 +1,144 @@
+import { WRITE_ONCE_UNCHANGED } from './submit.js';
+const REQUIRED_MESSAGE = 'This field is required.';
+/**
+ * "Has this field got a value at all" — the single emptiness notion in this
+ * library. Exported (not just used by `validateField`'s `isRequired` check)
+ * so `engine/status.ts`'s section-completeness counts mean exactly the same
+ * thing the required-check means: a whitespace-only string, `[]` and `{}` are
+ * empty; `false` (an off toggle) and a `File` are NOT — they are values a user
+ * chose. Two separate emptiness rules would let a section read "Complete"
+ * while a field it contains still fails validation.
+ */
+export function isEmpty(value) {
+    if (value == null)
+        return true;
+    if (typeof value === 'string')
+        return value.trim() === '';
+    if (Array.isArray(value))
+        return value.length === 0;
+    if (typeof File !== 'undefined' && value instanceof File)
+        return false; // a File has no own enumerable keys
+    if (typeof value === 'object')
+        return Object.keys(value).length === 0;
+    return false;
+}
+/** `accept` match against a File's MIME type or filename extension (§8, `file` datatype). */
+function acceptMatches(accept, file) {
+    return accept.some((a) => {
+        if (a.startsWith('.'))
+            return file.name.toLowerCase().endsWith(a.toLowerCase());
+        if (a.endsWith('/*'))
+            return file.type.startsWith(a.slice(0, -1));
+        return file.type === a;
+    });
+}
+function validateFile(field, file, msg) {
+    // `value` reaching here is only ever SUPPOSED to be a real File — but a stale
+    // value from before the field became a file-upload type, or any other bad
+    // input the host hands back, is a plain object/string with no `.name`/`.size`.
+    // Fail safe (invalid, same as any other malformed value) instead of crashing.
+    if (!(typeof File !== 'undefined' && file instanceof File))
+        return msg;
+    if (field.maxSizeKB != null && file.size > field.maxSizeKB * 1024)
+        return msg;
+    if (field.accept?.length && !acceptMatches(field.accept, file))
+        return msg;
+    return null;
+}
+function compile(patterns) {
+    const out = [];
+    for (const p of patterns ?? []) {
+        try {
+            out.push(new RegExp(p));
+        }
+        catch {
+            // eslint-disable-next-line no-console
+            console.warn(`[mcp-ui-render] invalid regex "${p}": field treated as unvalidated (§8).`);
+        }
+    }
+    return out;
+}
+function allMatch(regexes, s) {
+    return regexes.every((r) => r.test(s));
+}
+/**
+ * Validate a field's value. Returns the message to show, or null when valid.
+ */
+export function validateField(field, value) {
+    // A `writeOnce` field's already-stored value is this sentinel string, never
+    // the real value (§7) — validating it against the field's own rules is
+    // meaningless (it's not what will be submitted) and, for `file` fields,
+    // actively crashes: `validateFile` below reads `.name`/`.size` expecting a
+    // real `File`, which a plain string doesn't have. Short-circuit before any
+    // datatype-specific check ever sees it, same as `<aq-mcp-field>`'s own
+    // `isSetWriteOnce()` already treats this sentinel as "stored, don't touch."
+    if (value === WRITE_ONCE_UNCHANGED)
+        return null;
+    const dt = field.datatype;
+    if (dt === 'none')
+        return null;
+    if (isEmpty(value))
+        return field.isRequired ? REQUIRED_MESSAGE : null;
+    if (dt === 'boolean')
+        return null;
+    const msg = field.validationmessage ?? 'Invalid value.';
+    const regexes = compile(field.validation);
+    if (field['ui-component'] === 'file') {
+        // Covers both single-file (`datatype: "file"`) and multi-file (`datatype:
+        // "array"` + `ui-component: "file"`) — binary content, so `validation`
+        // regex doesn't apply; only `minItems`/`maxItems` (multi) + `accept`/`maxSizeKB` (§8).
+        const files = Array.isArray(value) ? value : [value];
+        if (dt === 'array') {
+            if (field.minItems != null && files.length < field.minItems)
+                return msg;
+            if (field.maxItems != null && files.length > field.maxItems)
+                return msg;
+        }
+        return files.every((f) => validateFile(field, f, msg) === null) ? null : msg;
+    }
+    switch (dt) {
+        case 'string':
+            return regexes.length && !allMatch(regexes, String(value)) ? msg : null;
+        case 'number': {
+            if (regexes.length && !allMatch(regexes, String(value)))
+                return msg;
+            const n = Number(value);
+            if (!Number.isNaN(n)) {
+                if (field.min != null && n < field.min)
+                    return msg;
+                if (field.max != null && n > field.max)
+                    return msg;
+            }
+            return null;
+        }
+        case 'array': {
+            const arr = Array.isArray(value) ? value : [value];
+            if (field.minItems != null && arr.length < field.minItems)
+                return msg;
+            if (field.maxItems != null && arr.length > field.maxItems)
+                return msg;
+            if (regexes.length && !arr.every((el) => allMatch(regexes, String(el))))
+                return msg;
+            return null;
+        }
+        case 'object': {
+            const obj = typeof value === 'object' && value ? value : {};
+            for (const k of field.requiredKeys ?? []) {
+                if (!(k in obj))
+                    return msg;
+            }
+            if (regexes.length && !Object.values(obj).every((v) => allMatch(regexes, String(v))))
+                return msg;
+            return null;
+        }
+        default: {
+            // Unknown datatype → treat as string, warn if required (§9.2).
+            if (field.isRequired) {
+                // eslint-disable-next-line no-console
+                console.warn(`[mcp-ui-render] unknown datatype "${String(dt)}" on required field "${field.attribute}": validating as string (§9.2).`);
+            }
+            return regexes.length && !allMatch(regexes, String(value)) ? msg : null;
+        }
+    }
+}
+//# sourceMappingURL=validate.js.map

package/src/engine/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../../../apps/mcp-ui-render/src/engine/validate.ts"],"names":[],"mappings":"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"}

package/src/engine/values.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Value-model helpers: dependency applicability (§12) and default seeding.
+ * Unknown keys already survive because `Values` is an open record and updates
+ * are shallow merges — nothing here drops properties it doesn't recognise (§9.4).
+ */
+import type { Descriptor, Field, Values } from '../types.js';
+export declare function asArray(v: string | string[] | undefined): string[];
+/**
+ * A field applies unless it declares at least one dependency condition — either
+ * `dependencyAttribute`/`dependencyValue` (single attribute) or `dependsOn` (a list
+ * of attribute/value conditions, §9.7) — and NONE of them currently match. With
+ * both present, or multiple `dependsOn` entries, they're OR'd together: any one
+ * condition matching is enough (e.g. an FTP-server picker relevant when EITHER
+ * `sourceConnectionType === 'directConnection'` OR `storageType === 'sftpStorage'`).
+ * A field with no dependency declared at all always applies (§12). Non-applying
+ * fields are skipped and their stored value dropped by the caller.
+ */
+export declare function fieldApplies(field: Field, values: Values): boolean;
+/** Seed `defaultValue` for applied, value-bearing fields that have no value yet (§12). */
+export declare function seedDefaults(descriptor: Descriptor, values: Values): Values;