nucleus-core-ts 0.10.147 → 0.10.151

package/dist/fe/components/IntegrationsPage/components/connectionDraft.js

@@ -45,19 +45,19 @@ export function draftFromSource(source) {
         timeoutMs: source.timeoutMs == null ? '' : String(source.timeoutMs)
     };
 }
-/**
- * The boxes a SAVED record should correct, and only those.
- *
- * After an edit the form has to show what was actually stored — the server
- * trims, defaults and ignores things, and the boxes went on showing what was
- * typed. But re-deriving the whole draft from the reply is not safe: a
- * field-scoped patch claim strips columns out of the response, and
- * {@link draftFromSource} substitutes a default for every column it does not
- * find. A reply that legitimately omits `name` would therefore blank the name
- * box — trading a stale screen for a destroyed one.
- *
- * So this reads the reply key by key and says nothing about a key that is not
- * there. What it returns is a patch, applied over the draft the operator has.
+/**
+ * The boxes a SAVED record should correct, and only those.
+ *
+ * After an edit the form has to show what was actually stored — the server
+ * trims, defaults and ignores things, and the boxes went on showing what was
+ * typed. But re-deriving the whole draft from the reply is not safe: a
+ * field-scoped patch claim strips columns out of the response, and
+ * {@link draftFromSource} substitutes a default for every column it does not
+ * find. A reply that legitimately omits `name` would therefore blank the name
+ * box — trading a stale screen for a destroyed one.
+ *
+ * So this reads the reply key by key and says nothing about a key that is not
+ * there. What it returns is a patch, applied over the draft the operator has.
  */ export function draftPatchFromSource(source) {
     const full = draftFromSource(source);
     const patch = {};
@@ -96,13 +96,13 @@ export function usesQueryParam(authType) {
 export function usesOauth(authType) {
     return authType === 'oauth2';
 }
-/**
- * Rebuilds the record.
- *
- * Fields the chosen auth type does not use are sent as null rather than left
- * alone. Switching a connection from OAuth to a bearer token and leaving the old
- * token URL behind is how a source ends up carrying settings nobody can see in
- * the form but the server still reads.
+/**
+ * Rebuilds the record.
+ *
+ * Fields the chosen auth type does not use are sent as null rather than left
+ * alone. Switching a connection from OAuth to a bearer token and leaving the old
+ * token URL behind is how a source ends up carrying settings nobody can see in
+ * the form but the server still reads.
  */ export function draftToSource(draft, id) {
     const oauth = usesOauth(draft.authType);
     const timeout = Number.parseInt(draft.timeoutMs.trim(), 10);
@@ -139,13 +139,13 @@ export function usesOauth(authType) {
 }
 const SLUG_PATTERN = /^[a-z0-9][a-z0-9_-]*$/;
 const DIGITS_PATTERN = /^\d+$/;
-/**
- * What must be filled in before a save is worth attempting.
- *
- * The base URL is checked for a scheme and nothing else. It is deliberately not
- * checked for https, for a public host or for a resolvable name: an in-cluster
- * service on plain http is a normal target, and a form that rejected it would be
- * rejecting a working setup.
+/**
+ * What must be filled in before a save is worth attempting.
+ *
+ * The base URL is checked for a scheme and nothing else. It is deliberately not
+ * checked for https, for a public host or for a resolvable name: an in-cluster
+ * service on plain http is a normal target, and a form that rejected it would be
+ * rejecting a working setup.
  */ export function validateConnectionDraft(draft) {
     const errors = {};
     if (draft.name.trim().length === 0) errors.name = 'Give the connection a name.';

package/dist/fe/components/IntegrationsPage/components/credentialSlots.js

@@ -14,24 +14,24 @@
     if (slot === 'oauthClientSecret') return source.oauthClientSecretHint ?? null;
     return source.oauthPasswordHint ?? null;
 }
-/**
- * Every name a server might return a preview under.
- *
- * This list was wrong, and the way it was wrong is worth keeping: it accepted
- * the slot name and the hint column, on the reasoning that a server would use
- * one or the other. Nucleus' own route uses NEITHER for the OAuth pair — it
- * answers `clientSecret` and `password`. So a saved password came back under a
- * name nothing looked for, {@link hintFromResult} said "the reply mentioned no
- * such slot", and the screen went on showing the record it had loaded BEFORE
- * the save: "Not set", under the words "Saved". Refreshing fixed it, which is
- * the tell — the value was in the database the whole time.
- *
- * `token` was unaffected, because for that one slot the guess happened to
- * match. One correct name out of three is what let this ship.
- *
- * The guard against it happening again is not a longer list: it is
- * `credentialSlots.contract.test.ts`, which reads the server route and fails if
- * it ever emits a name this does not accept.
+/**
+ * Every name a server might return a preview under.
+ *
+ * This list was wrong, and the way it was wrong is worth keeping: it accepted
+ * the slot name and the hint column, on the reasoning that a server would use
+ * one or the other. Nucleus' own route uses NEITHER for the OAuth pair — it
+ * answers `clientSecret` and `password`. So a saved password came back under a
+ * name nothing looked for, {@link hintFromResult} said "the reply mentioned no
+ * such slot", and the screen went on showing the record it had loaded BEFORE
+ * the save: "Not set", under the words "Saved". Refreshing fixed it, which is
+ * the tell — the value was in the database the whole time.
+ *
+ * `token` was unaffected, because for that one slot the guess happened to
+ * match. One correct name out of three is what let this ship.
+ *
+ * The guard against it happening again is not a longer list: it is
+ * `credentialSlots.contract.test.ts`, which reads the server route and fails if
+ * it ever emits a name this does not accept.
  */ const HINT_KEYS = {
     token: [
         'token',
@@ -49,13 +49,13 @@
         'oauthPasswordHint'
     ]
 };
-/**
- * The record columns a set of new masks writes to.
- *
- * The counterpart of {@link storedHint}: that reads a hint off the record, this
- * puts one back. Both exist because the screen answers from local state OR from
- * the record, and if only one of the two is updated after a save the answer
- * depends on whether the component happens to have been remounted since.
+/**
+ * The record columns a set of new masks writes to.
+ *
+ * The counterpart of {@link storedHint}: that reads a hint off the record, this
+ * puts one back. Both exist because the screen answers from local state OR from
+ * the record, and if only one of the two is updated after a save the answer
+ * depends on whether the component happens to have been remounted since.
  */ export function hintColumnsFor(hints) {
     const columns = {};
     if ('token' in hints) columns.authTokenHint = hints.token ?? null;

package/dist/fe/components/IntegrationsPage/components/deleteIsConfirmed.js

@@ -1,12 +1,12 @@
-/**
- * Whether what the operator typed matches the connection they are deleting.
- *
- * Kept out of the component so the rule can be tested: it is the only thing
- * standing between a stray click and a connection's calls, mappings and run
- * history. Trimmed on both sides because a name pasted out of the list carries
- * a trailing space often enough that refusing it reads as a bug, and compared
- * exactly otherwise — two connections called "HR" and "HR 2" must not confirm
- * for each other.
+/**
+ * Whether what the operator typed matches the connection they are deleting.
+ *
+ * Kept out of the component so the rule can be tested: it is the only thing
+ * standing between a stray click and a connection's calls, mappings and run
+ * history. Trimmed on both sides because a name pasted out of the list carries
+ * a trailing space often enough that refusing it reads as a bug, and compared
+ * exactly otherwise — two connections called "HR" and "HR 2" must not confirm
+ * for each other.
  */ export function deleteIsConfirmed(name, typed) {
     const target = name.trim();
     if (target.length === 0) return false;

package/dist/fe/components/IntegrationsPage/components/fieldMappingOptions.js

@@ -1,7 +1,7 @@
-/**
- * The vocabulary of a field mapping row, kept out of the components so the
- * header, the row and the editor cannot disagree about what a column is called
- * or how wide it is.
+/**
+ * The vocabulary of a field mapping row, kept out of the components so the
+ * header, the row and the editor cannot disagree about what a column is called
+ * or how wide it is.
  */ /** A source that reads from the record the PARENT endpoint produced. */ export const PARENT_PREFIX = '__parent.';
 /** One template for the header and every row, so the columns cannot drift apart. */ export const FIELD_MAPPING_GRID = 'grid grid-cols-1 gap-2 sm:grid-cols-2 lg:grid-cols-[1fr_1fr_1fr_1fr_1fr_auto]';
 export const FIELD_MAPPING_COLUMNS = [

package/dist/fe/components/IntegrationsPage/components/formSupport.js

@@ -1,13 +1,13 @@
-/**
- * The small things every form in this panel needs and none of them deserves a file.
- */ /**
- * How an endpoint should read in a list someone has to choose from.
- *
- * The parameter-binding picker showed `tag`, which groups the endpoints of one
- * API — so a source whose endpoints are all tagged `corporate-portal` offered
- * three identical options and no way to tell which one supplied the value.
- * The name is what distinguishes them; the path is what distinguishes them when
- * nobody typed a name, since it is the one field that cannot be blank.
+/**
+ * The small things every form in this panel needs and none of them deserves a file.
+ */ /**
+ * How an endpoint should read in a list someone has to choose from.
+ *
+ * The parameter-binding picker showed `tag`, which groups the endpoints of one
+ * API — so a source whose endpoints are all tagged `corporate-portal` offered
+ * three identical options and no way to tell which one supplied the value.
+ * The name is what distinguishes them; the path is what distinguishes them when
+ * nobody typed a name, since it is the one field that cannot be blank.
  */ /** Same caps as the engine's `flattenKeys`: this feeds a dropdown, not an analysis. */ const MAX_FIELDS_LISTED = 200;
 const MAX_FIELD_DEPTH = 4;
 function walkKeys(value, prefix, out, depth) {
@@ -27,18 +27,18 @@ function walkKeys(value, prefix, out, depth) {
     }
     return out;
 }
-/**
- * The field names an endpoint's STORED sample reports.
- *
- * A sample is persisted on the endpoint precisely so the field list survives a
- * reload, but the mapping editor was reading only the sample taken in this
- * browser session. Come back to a connection tomorrow and it said "sample the
- * endpoint first" about an endpoint it had already sampled and saved — so the
- * source names had to be typed from memory, which is the one thing the sample
- * exists to prevent.
- *
- * Mirrors the engine's `flattenKeys` rather than calling it: that lives in the
- * server bundle, which this kit cannot import.
+/**
+ * The field names an endpoint's STORED sample reports.
+ *
+ * A sample is persisted on the endpoint precisely so the field list survives a
+ * reload, but the mapping editor was reading only the sample taken in this
+ * browser session. Come back to a connection tomorrow and it said "sample the
+ * endpoint first" about an endpoint it had already sampled and saved — so the
+ * source names had to be typed from memory, which is the one thing the sample
+ * exists to prevent.
+ *
+ * Mirrors the engine's `flattenKeys` rather than calling it: that lives in the
+ * server bundle, which this kit cannot import.
  */ export function fieldsOfStoredSample(sample) {
     const first = sample?.records?.[0];
     if (!first || typeof first !== 'object') return [];
@@ -51,24 +51,24 @@ export function endpointLabel(endpoint) {
     if (path) return `${endpoint.method} ${path}`;
     return endpoint.tag;
 }
-/**
- * The ids a control should point `aria-describedby` at.
- *
- * {@link Field} renders its hint as `<id>-hint` and its error as `<id>-error`,
- * so pointing at an id that was not rendered would leave a screen reader
- * announcing nothing — the ids are named here only when they exist.
+/**
+ * The ids a control should point `aria-describedby` at.
+ *
+ * {@link Field} renders its hint as `<id>-hint` and its error as `<id>-error`,
+ * so pointing at an id that was not rendered would leave a screen reader
+ * announcing nothing — the ids are named here only when they exist.
  */ export function describedBy(id, hasHint, hasError) {
     if (hasHint && hasError) return `${id}-hint ${id}-error`;
     if (hasHint) return `${id}-hint`;
     if (hasError) return `${id}-error`;
     return undefined;
 }
-/**
- * Whatever a rejected action carries, as a sentence.
- *
- * The server's own wording is kept verbatim wherever there is one: it is the
- * only text that knows WHICH setting was wrong, and a friendlier replacement
- * would be a friendlier way of saying nothing.
+/**
+ * Whatever a rejected action carries, as a sentence.
+ *
+ * The server's own wording is kept verbatim wherever there is one: it is the
+ * only text that knows WHICH setting was wrong, and a friendlier replacement
+ * would be a friendlier way of saying nothing.
  */ export function errorText(reason, fallback) {
     if (reason instanceof Error && reason.message.length > 0) return reason.message;
     if (typeof reason === 'string' && reason.length > 0) return reason;

package/dist/fe/components/IntegrationsPage/components/jsonArray.js

@@ -1,17 +1,17 @@
-/**
- * Reading a jsonb column that is supposed to hold a list.
- *
- * It is not always a list. The schema generator wrote every object-shaped
- * default — including `[]` — into Postgres as `'{}'`, which is an empty OBJECT.
- * So every row that never had a value reads back as `{}`, and the first
- * `for…of` over it throws "object is not iterable". That is every existing row
- * the moment a new column is added to a table already in use, which is exactly
- * when nobody is looking: the column is new, nothing has filled it in, and the
- * screen that reads it dies on the next click.
- *
- * The generator is fixed. This exists because the rows it already wrote are
- * still there, and because a value crossing the wire from a database is not
- * something a component should have to trust.
+/**
+ * Reading a jsonb column that is supposed to hold a list.
+ *
+ * It is not always a list. The schema generator wrote every object-shaped
+ * default — including `[]` — into Postgres as `'{}'`, which is an empty OBJECT.
+ * So every row that never had a value reads back as `{}`, and the first
+ * `for…of` over it throws "object is not iterable". That is every existing row
+ * the moment a new column is added to a table already in use, which is exactly
+ * when nobody is looking: the column is new, nothing has filled it in, and the
+ * screen that reads it dies on the next click.
+ *
+ * The generator is fixed. This exists because the rows it already wrote are
+ * still there, and because a value crossing the wire from a database is not
+ * something a component should have to trust.
  */ export function asArray(value) {
     return Array.isArray(value) ? value : [];
 }

package/dist/fe/components/IntegrationsPage/components/jsonObjectField.js

@@ -1,18 +1,18 @@
-/**
- * A JSON object typed into a form field.
- *
- * Query parameters and a request body are `Record<string, unknown>` on the wire
- * — an endpoint may need `{"employeeTypes": ["A", "S"]}`, which no key/value
- * grid of strings can express. So the field takes JSON, and the only question
- * is whether a form is allowed to save what it cannot parse. It is not: a body
- * saved as broken text fails at RUN time, against a live service, with an error
- * from somewhere else entirely.
- */ /**
- * Parses the text of a JSON-object field.
- *
- * Empty is `null` rather than `{}` — "nothing configured" and "an empty object
- * configured" read the same on screen but not in a request, and the column is
- * nullable precisely so the difference survives.
+/**
+ * A JSON object typed into a form field.
+ *
+ * Query parameters and a request body are `Record<string, unknown>` on the wire
+ * — an endpoint may need `{"employeeTypes": ["A", "S"]}`, which no key/value
+ * grid of strings can express. So the field takes JSON, and the only question
+ * is whether a form is allowed to save what it cannot parse. It is not: a body
+ * saved as broken text fails at RUN time, against a live service, with an error
+ * from somewhere else entirely.
+ */ /**
+ * Parses the text of a JSON-object field.
+ *
+ * Empty is `null` rather than `{}` — "nothing configured" and "an empty object
+ * configured" read the same on screen but not in a request, and the column is
+ * nullable precisely so the difference survives.
  */ export function parseJsonObject(text) {
     const trimmed = text.trim();
     if (trimmed === '') return {

package/dist/fe/components/IntegrationsPage/components/mappingDraft.js

@@ -1,10 +1,10 @@
 import { asArray } from './jsonArray';
 import { missingRecordFieldsIncomplete } from './MappingWriteModeFields';
-/**
- * Upsert and ignore: the two choices that cannot lose a row by themselves.
- *
- * `targetEntity` is filled in when the operator arrived from the table itself —
- * they have already said which one, and asking again is the panel forgetting.
+/**
+ * Upsert and ignore: the two choices that cannot lose a row by themselves.
+ *
+ * `targetEntity` is filled in when the operator arrived from the table itself —
+ * they have already said which one, and asking again is the panel forgetting.
  */ export function blankMappingDraft(endpointId, targetEntity = '') {
     return {
         endpointId,
@@ -42,11 +42,11 @@ import { missingRecordFieldsIncomplete } from './MappingWriteModeFields';
         enabled: mapping.enabled
     };
 }
-/**
- * Everything standing between this draft and a run that does what it says.
- *
- * Reported as a list rather than a boolean because "Save is greyed out" with no
- * reason is the single most common way a form wastes somebody's afternoon.
+/**
+ * Everything standing between this draft and a run that does what it says.
+ *
+ * Reported as a list rather than a boolean because "Save is greyed out" with no
+ * reason is the single most common way a form wastes somebody's afternoon.
  */ export function mappingDraftIssues(draft) {
     const issues = [];
     if (draft.name.trim() === '') issues.push('Give the mapping a name.');

package/dist/fe/components/IntegrationsPage/components/mappingStaleness.js

@@ -1,31 +1,31 @@
-/**
- * Whether a mapping is actually keeping its table up to date.
- *
- * The list already said "Last run: 2026-08-02 12:51". Next to four siblings that
- * all ran the previous night, that line is the difference between a working
- * integration and a table two days out of date — and it takes arithmetic to see
- * it, so nobody did. What happened instead: a chief executive was missing from
- * the directory, a director's title was the one he had held in July, and people
- * who had left were still listed. All four were the same fact, and the screen
- * that knew it showed a timestamp.
- *
- * The cause underneath was smaller still: that mapping had no schedule. Its
- * siblings ran nightly; it only ever ran when somebody pressed a button, and
- * nobody had pressed it since Sunday. Nothing on the screen said so.
- *
- * So this answers two questions the timestamp cannot: does anything run this on
- * its own, and is what it wrote still recent. Both are properties of the row, so
- * they belong on the row.
+/**
+ * Whether a mapping is actually keeping its table up to date.
+ *
+ * The list already said "Last run: 2026-08-02 12:51". Next to four siblings that
+ * all ran the previous night, that line is the difference between a working
+ * integration and a table two days out of date — and it takes arithmetic to see
+ * it, so nobody did. What happened instead: a chief executive was missing from
+ * the directory, a director's title was the one he had held in July, and people
+ * who had left were still listed. All four were the same fact, and the screen
+ * that knew it showed a timestamp.
+ *
+ * The cause underneath was smaller still: that mapping had no schedule. Its
+ * siblings ran nightly; it only ever ran when somebody pressed a button, and
+ * nobody had pressed it since Sunday. Nothing on the screen said so.
+ *
+ * So this answers two questions the timestamp cannot: does anything run this on
+ * its own, and is what it wrote still recent. Both are properties of the row, so
+ * they belong on the row.
  */ const HOUR = 60 * 60 * 1000;
 export function mappingStaleness(question) {
     const unscheduled = question.scheduleEnabled !== true;
     const staleAfter = (question.staleAfterHours ?? 24) * HOUR;
     const parsed = question.lastRunAt ? Date.parse(question.lastRunAt) : Number.NaN;
     if (!Number.isFinite(parsed)) {
-        /*
-     * Never run is only worth a warning when nothing is going to run it.
-     * A mapping created five minutes ago with a schedule on it is not a
-     * problem — it is a mapping waiting for tonight.
+        /*
+     * Never run is only worth a warning when nothing is going to run it.
+     * A mapping created five minutes ago with a schedule on it is not a
+     * problem — it is a mapping waiting for tonight.
      */ return {
             unscheduled,
             neverRun: true,

package/dist/fe/components/IntegrationsPage/components/nextRuns.js

@@ -1,12 +1,12 @@
 import { nextFireTimes } from '../../../../src/Shared/cron';
-/**
- * A fixed, unambiguous format rather than the reader's locale.
- *
- * `toLocaleString()` here would render the server's locale on the server and
- * the browser's on the client — two different strings for one row, and a
- * hydration tear. It would also print 8/5/2026, which in Turkey reads as the
- * 8th of May. Year-first with the zone spelled out cannot be misread in either
- * direction.
+/**
+ * A fixed, unambiguous format rather than the reader's locale.
+ *
+ * `toLocaleString()` here would render the server's locale on the server and
+ * the browser's on the client — two different strings for one row, and a
+ * hydration tear. It would also print 8/5/2026, which in Turkey reads as the
+ * 8th of May. Year-first with the zone spelled out cannot be misread in either
+ * direction.
  */ function partsIn(when, timeZone) {
     const parts = new Intl.DateTimeFormat('en-CA', {
         timeZone,

package/dist/fe/components/IntegrationsPage/components/passwordIsNeeded.js

@@ -1,16 +1,16 @@
-/**
- * Does starting this import require a password?
- *
- * Two ways it can: the mapping writes one into a column of the record's own
- * table, or it creates a login alongside each record. Either way the operator
- * types it once, on the run screen, and it goes no further than that run.
- *
- * A function rather than three expressions, because it WAS three: the field that
- * asks for the password, the button that starts the import, and the request that
- * carries it each decided for themselves. Two were updated when accounts were
- * added and one was not — so the field appeared, the button enabled, and the
- * request sent nothing. Every import that created logins was refused for a
- * missing password the operator had typed.
+/**
+ * Does starting this import require a password?
+ *
+ * Two ways it can: the mapping writes one into a column of the record's own
+ * table, or it creates a login alongside each record. Either way the operator
+ * types it once, on the run screen, and it goes no further than that run.
+ *
+ * A function rather than three expressions, because it WAS three: the field that
+ * asks for the password, the button that starts the import, and the request that
+ * carries it each decided for themselves. Two were updated when accounts were
+ * added and one was not — so the field appeared, the button enabled, and the
+ * request sent nothing. Every import that created logins was refused for a
+ * missing password the operator had typed.
  */ export function passwordIsNeeded(mapping) {
     return Boolean(mapping.passwordTargetColumn) || mapping.accountRule != null;
 }

package/dist/fe/components/IntegrationsPage/components/pathParams.js

@@ -1,9 +1,9 @@
-/**
- * Reading the parameter names out of an endpoint path.
- *
- * Shared by the sample screen, which asks for a value by hand, and the binding
- * editor, which asks where the value should come from on a real run. One reader
- * so the two screens can never disagree about what a path needs.
+/**
+ * Reading the parameter names out of an endpoint path.
+ *
+ * Shared by the sample screen, which asks for a value by hand, and the binding
+ * editor, which asks where the value should come from on a real run. One reader
+ * so the two screens can never disagree about what a path needs.
  */ const PARAM_PATTERN = /\{([^{}]+)\}|:([A-Za-z_][A-Za-z0-9_]*)/g;
 /** `{brace}` and `:colon` are both accepted, so both are read back. */ export function pathParamNames(path) {
     const names = [];

package/dist/fe/components/IntegrationsPage/components/runFormat.js

@@ -1,9 +1,9 @@
-/**
- * The small conversions the run screens share.
- *
- * Nothing here touches the server or React — it turns a record into the words an
- * operator reads, and it does so the SAME way in every place, so a duration on a
- * history row cannot disagree with the one on the panel above it.
+/**
+ * The small conversions the run screens share.
+ *
+ * Nothing here touches the server or React — it turns a record into the words an
+ * operator reads, and it does so the SAME way in every place, so a duration on a
+ * history row cannot disagree with the one on the panel above it.
  */ /** A run's outcome, coloured. Reverted is deliberately calm: nothing is wrong with it. */ export const RUN_STATUS_TONE = {
     queued: 'neutral',
     running: 'info',
@@ -18,12 +18,12 @@ export function errorText(error, fallback) {
 function pad(value) {
     return String(value).padStart(2, '0');
 }
-/**
- * A moment, in UTC.
- *
- * Deliberately not locale-formatted: `toLocaleString` reads the server's zone on
- * the server and the browser's on the client, so the two renders differ and the
- * row tears on hydration. UTC is the same number everywhere, and it is labelled.
+/**
+ * A moment, in UTC.
+ *
+ * Deliberately not locale-formatted: `toLocaleString` reads the server's zone on
+ * the server and the browser's on the client, so the two renders differ and the
+ * row tears on hydration. UTC is the same number everywhere, and it is labelled.
  */ export function formatMoment(value) {
     if (!value) return '—';
     const date = new Date(value);
@@ -65,12 +65,12 @@ export function formatDuration(startedAt, finishedAt) {
     if (run.errorCount > 0) parts.push(`${run.errorCount} failed`);
     return parts.join(' · ');
 }
-/**
- * What a destructive run takes away, counted wherever there is a plan to count from.
- *
- * The mapping alone can say WHAT will happen; only the plan can say to how many
- * rows. Both wordings exist because an operator is allowed to skip the preview,
- * and a confirmation that says "some rows" is not a confirmation.
+/**
+ * What a destructive run takes away, counted wherever there is a plan to count from.
+ *
+ * The mapping alone can say WHAT will happen; only the plan can say to how many
+ * rows. Both wordings exist because an operator is allowed to skip the preview,
+ * and a confirmation that says "some rows" is not a confirmation.
  */ export function describeLosses(mapping, plan) {
     const lines = [];
     const target = mapping.targetEntity;

package/dist/fe/components/IntegrationsPage/components/settleOwnership.js

@@ -1,21 +1,21 @@
-/**
- * Who owns a busy flag when a late answer arrives.
- *
- * Every request in this panel sets a shared "in progress" flag on the way in and
- * clears it on the way out. That breaks the moment an answer is DISCARDED —
- * because the operator moved on, or because a newer request replaced this one —
- * since a bare `return` skips the clearing too and the flag stays set with
- * nobody left to unset it. The panel then shows a skeleton for a request that
- * has already finished and will never be written.
- *
- * Two questions, and they are not the same question:
- *
- *   superseded — a NEWER request of the same kind has started. It set the flag
- *                after this one did and will clear it when it settles, so this
- *                answer must leave the flag strictly alone.
- *   movedOn    — the operator is looking at something else. Nobody else is
- *                coming: this request is the last one out and must clear the
- *                flag before dropping its answer.
+/**
+ * Who owns a busy flag when a late answer arrives.
+ *
+ * Every request in this panel sets a shared "in progress" flag on the way in and
+ * clears it on the way out. That breaks the moment an answer is DISCARDED —
+ * because the operator moved on, or because a newer request replaced this one —
+ * since a bare `return` skips the clearing too and the flag stays set with
+ * nobody left to unset it. The panel then shows a skeleton for a request that
+ * has already finished and will never be written.
+ *
+ * Two questions, and they are not the same question:
+ *
+ *   superseded — a NEWER request of the same kind has started. It set the flag
+ *                after this one did and will clear it when it settles, so this
+ *                answer must leave the flag strictly alone.
+ *   movedOn    — the operator is looking at something else. Nobody else is
+ *                coming: this request is the last one out and must clear the
+ *                flag before dropping its answer.
  */ export function settlementOf(args) {
     const superseded = args.latest !== args.mine;
     const movedOn = args.selectedNow !== args.requestedFor;

package/dist/fe/components/IntegrationsPage/components/useInfiniteList.js

@@ -3,14 +3,14 @@ import { useEffect, useEffectEvent, useRef, useState } from 'react';
 const DEFAULT_PAGE_SIZE = 20;
 export function useInfiniteList(options) {
     const pageSize = options.pageSize ?? DEFAULT_PAGE_SIZE;
-    /**
-   * The caller's deps as ONE value.
-   *
-   * Spreading them into the dependency array made its LENGTH depend on the
-   * caller, and React requires that length to be constant across renders — an
-   * array that grows or shrinks silently stops the effect re-running when it
-   * should. Collapsing to a string keeps one slot no matter how many things the
-   * caller watches.
+    /**
+   * The caller's deps as ONE value.
+   *
+   * Spreading them into the dependency array made its LENGTH depend on the
+   * caller, and React requires that length to be constant across renders — an
+   * array that grows or shrinks silently stops the effect re-running when it
+   * should. Collapsing to a string keeps one slot no matter how many things the
+   * caller watches.
    */ const depsKey = JSON.stringify(options.deps);
     const [items, setItems] = useState([]);
     const [total, setTotal] = useState(0);