193 lines
6.0 KiB
JavaScript
193 lines
6.0 KiB
JavaScript
import test from 'node:test';
|
|
import assert from 'node:assert/strict';
|
|
import { readFileSync } from 'node:fs';
|
|
import {
|
|
formFieldGuidance,
|
|
formHelpPlacement,
|
|
normaliseHelpLabel,
|
|
readFormHelpAutomatic,
|
|
simulationStepGuidance,
|
|
} from '../../resources/js/lib/form-help.ts';
|
|
import { getSimulationSections } from '../../resources/js/lib/simulation-form.ts';
|
|
|
|
test('guidance explains actual fiscal/financial inputs without inventing rates or replacing periods', () => {
|
|
for (const [label, expected] of [
|
|
['Volume de negócios anterior', /período pedido/],
|
|
['Imposto liquidado', /documento correspondente/],
|
|
['Retenções na fonte', /documentado/],
|
|
['Receita mensal', /previsão/],
|
|
['Custo unitário', /unitário, mensal, anual ou total/],
|
|
['Moeda do projecto', /moeda/],
|
|
['Residência fiscal', /enquadramento/],
|
|
['NUIT', /documento/],
|
|
['Fonte documental', /recuperar e conferir/],
|
|
]) {
|
|
const result = formFieldGuidance({
|
|
label,
|
|
type: 'text',
|
|
required: false,
|
|
value: 'PRIVATE-INPUT-123',
|
|
});
|
|
assert.match(result.instruction, expected);
|
|
assert.doesNotMatch(JSON.stringify(result), /PRIVATE-INPUT|\d+%/);
|
|
}
|
|
});
|
|
|
|
test('native and accessible custom field types receive useful instructions', () => {
|
|
for (const type of [
|
|
'text',
|
|
'number',
|
|
'range',
|
|
'select',
|
|
'combobox',
|
|
'checkbox',
|
|
'radio',
|
|
'date',
|
|
'month',
|
|
'email',
|
|
'tel',
|
|
'url',
|
|
'password',
|
|
'file',
|
|
'textarea',
|
|
]) {
|
|
const result = formFieldGuidance({
|
|
label: 'Campo de ensaio',
|
|
type,
|
|
required: true,
|
|
});
|
|
assert.ok(result.instruction.length > 30, type);
|
|
}
|
|
assert.match(
|
|
formFieldGuidance({
|
|
label: 'Autorização',
|
|
type: 'checkbox',
|
|
required: false,
|
|
}).instruction,
|
|
/apenas se/,
|
|
);
|
|
assert.match(
|
|
formFieldGuidance({ label: 'Documento', type: 'file', required: false })
|
|
.instruction,
|
|
/formatos indicados/,
|
|
);
|
|
assert.equal(
|
|
normaliseHelpLabel('RETENÇÕES — MOÇAMBIQUE'),
|
|
'retencoes — mocambique',
|
|
);
|
|
});
|
|
|
|
test('all adaptive simulator sections have specific step guidance', () => {
|
|
const seen = new Set();
|
|
for (const draft of [
|
|
{},
|
|
{ purpose: 'simulate_only' },
|
|
{ journey_type: 'company' },
|
|
{ journey_type: 'personal' },
|
|
{ journey_type: 'investor' },
|
|
{ journey_type: 'small_business' },
|
|
{ purpose: 'prepare_investment', journey_type: 'investor' },
|
|
]) {
|
|
for (const step of getSimulationSections(draft)) {
|
|
seen.add(step.id);
|
|
assert.notEqual(
|
|
simulationStepGuidance(step.id),
|
|
simulationStepGuidance('unknown-section'),
|
|
step.id,
|
|
);
|
|
}
|
|
}
|
|
for (const code of [
|
|
'purpose',
|
|
'market',
|
|
'investment',
|
|
'financial',
|
|
'operating',
|
|
'cashflow',
|
|
'tax',
|
|
'review',
|
|
'team',
|
|
'scenarios',
|
|
'procedures',
|
|
]) {
|
|
assert.ok(simulationStepGuidance(code).length > 40);
|
|
}
|
|
assert.ok(seen.size >= 11);
|
|
});
|
|
|
|
test('browser help preference is optional and does not store field contents', () => {
|
|
assert.equal(readFormHelpAutomatic(null), true);
|
|
assert.equal(readFormHelpAutomatic('off'), false);
|
|
assert.equal(readFormHelpAutomatic('on'), true);
|
|
assert.equal(readFormHelpAutomatic('corrupt'), true);
|
|
for (const file of [
|
|
'components/form-field-help.tsx',
|
|
'lib/form-help-dom.ts',
|
|
]) {
|
|
const source = readFileSync(
|
|
new URL('../../resources/js/' + file, import.meta.url),
|
|
'utf8',
|
|
);
|
|
assert.doesNotMatch(
|
|
source,
|
|
/\.value\b|FormData|fetch\(|router\.|\.submit\(|\.requestSubmit\(/,
|
|
);
|
|
}
|
|
});
|
|
|
|
test('help is placed above or below the focused mobile field without covering it', () => {
|
|
for (const rect of [
|
|
{ left: 24, top: 180, bottom: 224 },
|
|
{ left: 24, top: 440, bottom: 484 },
|
|
{ left: 24, top: 700, bottom: 744 },
|
|
]) {
|
|
const layout = formHelpPlacement(rect, 390, 844);
|
|
assert.ok(layout.maxHeight >= 96 && layout.maxHeight <= 844 * 0.45);
|
|
if (layout.vertical === 'top')
|
|
assert.ok(80 + layout.maxHeight + 60 < rect.top);
|
|
else assert.ok(844 - 12 - layout.maxHeight - 60 > rect.bottom);
|
|
}
|
|
});
|
|
|
|
test('help mounts once across portal pages and the simulator publishes its current adaptive step', () => {
|
|
const app = readFileSync(
|
|
new URL('../../resources/js/app.tsx', import.meta.url),
|
|
'utf8',
|
|
);
|
|
assert.equal((app.match(/<FormFieldHelp\s*\/>/g) ?? []).length, 1);
|
|
const simulator = readFileSync(
|
|
new URL(
|
|
'../../resources/js/components/simulation-form.tsx',
|
|
import.meta.url,
|
|
),
|
|
'utf8',
|
|
);
|
|
assert.match(simulator, /data-form-help-step=\{current.id\}/);
|
|
assert.match(simulator, /data-form-help-title=\{current.title\}/);
|
|
assert.match(
|
|
simulator,
|
|
/<button[^>]*type="button"[^>]*data-form-help-open/s,
|
|
);
|
|
});
|
|
|
|
test('modal assistance remains inside the dialog focus scope and leaves form controls mounted', () => {
|
|
const component = readFileSync(
|
|
new URL(
|
|
'../../resources/js/components/form-field-help.tsx',
|
|
import.meta.url,
|
|
),
|
|
'utf8',
|
|
);
|
|
assert.match(component, /createPortal\(content, dialog\)/);
|
|
assert.doesNotMatch(
|
|
component,
|
|
/innerHTML|replaceChildren|appendChild|removeChild/,
|
|
);
|
|
const dom = readFileSync(
|
|
new URL('../../resources/js/lib/form-help-dom.ts', import.meta.url),
|
|
'utf8',
|
|
);
|
|
assert.match(dom, /dialog\[open\]/);
|
|
assert.doesNotMatch(dom, /cloneNode|\.value\b/);
|
|
});
|