similarbuild 0.1.0

package/templates/skills/sb-tweak/scripts/tests/test-intent-parser.mjs

@@ -0,0 +1,496 @@
+#!/usr/bin/env node
+// test-intent-parser.mjs — Unit tests for lib/intent-parser.mjs.
+// Covers: action verbs (PT/EN), target types, qualifiers, property phrases,
+// value extraction, language detection, confidence scoring, and edge cases.
+
+import { strict as assert } from 'node:assert'
+import { parseIntent, extractValue, defaultProperty } from '../lib/intent-parser.mjs'
+
+let passed = 0
+let failed = 0
+
+function test(name, fn) {
+  try {
+    fn()
+    process.stdout.write(`ok - ${name}\n`)
+    passed++
+  } catch (err) {
+    process.stdout.write(`not ok - ${name}\n  ${err.message}\n`)
+    failed++
+  }
+}
+
+// ─── Action verbs ─────────────────────────────────────────────────────────────
+
+test('PT: "aumenta" → increase', () => {
+  const i = parseIntent('aumenta o título do hero pra 32px')
+  assert.equal(i.action, 'increase')
+})
+
+test('PT: "diminui" → decrease', () => {
+  const i = parseIntent('diminui o subtítulo para 14px')
+  assert.equal(i.action, 'decrease')
+})
+
+test('PT: "muda" → set', () => {
+  const i = parseIntent('muda a cor do botão pra #fff')
+  assert.equal(i.action, 'set')
+})
+
+test('PT: "troca" → set', () => {
+  const i = parseIntent('troca a imagem do hero')
+  assert.equal(i.action, 'set')
+})
+
+test('PT: "adiciona" → add', () => {
+  const i = parseIntent('adiciona alt="Logo" na primeira imagem')
+  assert.equal(i.action, 'add')
+})
+
+test('PT: "remove" → remove', () => {
+  const i = parseIntent('remove o segundo botão')
+  assert.equal(i.action, 'remove')
+})
+
+test('EN: "increase" → increase', () => {
+  const i = parseIntent('increase the hero title to 32px')
+  assert.equal(i.action, 'increase')
+})
+
+test('EN: "shrink" → decrease', () => {
+  const i = parseIntent('shrink the button text to 16px')
+  assert.equal(i.action, 'decrease')
+})
+
+test('EN: "change" → set', () => {
+  const i = parseIntent('change the hero title color to #fff')
+  assert.equal(i.action, 'set')
+})
+
+test('EN: "add" → add', () => {
+  const i = parseIntent('add alt "Logo" to the first image')
+  assert.equal(i.action, 'add')
+})
+
+test('EN: "remove" → remove', () => {
+  const i = parseIntent('remove the last button')
+  assert.equal(i.action, 'remove')
+})
+
+// ─── Target types ─────────────────────────────────────────────────────────────
+
+test('target: título → heading', () => {
+  const i = parseIntent('aumenta o título pra 32px')
+  assert.equal(i.target.type, 'heading')
+})
+
+test('target: subtítulo → subheading', () => {
+  const i = parseIntent('diminui o subtítulo para 14px')
+  assert.equal(i.target.type, 'subheading')
+})
+
+test('target: imagem → image', () => {
+  const i = parseIntent('troca a imagem do hero')
+  assert.equal(i.target.type, 'image')
+})
+
+test('target: botão → button', () => {
+  const i = parseIntent('muda a cor do botão pra #fff')
+  assert.equal(i.target.type, 'button')
+})
+
+test('target: button (EN) → button', () => {
+  const i = parseIntent('change the button color to red')
+  assert.equal(i.target.type, 'button')
+})
+
+test('target: image (EN) → image', () => {
+  const i = parseIntent('change the hero image alt to "Hero shot"')
+  assert.equal(i.target.type, 'image')
+})
+
+test('target: link → link', () => {
+  const i = parseIntent('change the link to https://example.com')
+  assert.equal(i.target.type, 'link')
+})
+
+test('target: ícone → icon', () => {
+  const i = parseIntent('aumenta o ícone para 24px')
+  assert.equal(i.target.type, 'icon')
+})
+
+// ─── Qualifiers ───────────────────────────────────────────────────────────────
+
+test('qualifier: hero', () => {
+  const i = parseIntent('aumenta o título do hero pra 32px')
+  assert.equal(i.target.qualifier, 'hero')
+})
+
+test('qualifier: footer', () => {
+  const i = parseIntent('muda o texto do footer')
+  assert.equal(i.target.qualifier, 'footer')
+})
+
+test('qualifier: header', () => {
+  const i = parseIntent('aumenta o link do header pra 18px')
+  assert.equal(i.target.qualifier, 'header')
+})
+
+test('qualifier: primeira (PT) → first', () => {
+  const i = parseIntent('adiciona alt na primeira imagem')
+  assert.equal(i.target.qualifier, 'first')
+})
+
+test('qualifier: segundo (PT) → second', () => {
+  const i = parseIntent('remove o segundo botão')
+  assert.equal(i.target.qualifier, 'second')
+})
+
+test('qualifier: third (EN)', () => {
+  const i = parseIntent('change the third button text to "Buy"')
+  assert.equal(i.target.qualifier, 'third')
+})
+
+test('qualifier: last', () => {
+  const i = parseIntent('remove the last button')
+  assert.equal(i.target.qualifier, 'last')
+})
+
+// ─── Property detection ───────────────────────────────────────────────────────
+
+test('property: explicit "tamanho" → font-size', () => {
+  const i = parseIntent('aumenta o tamanho do título para 32px')
+  assert.equal(i.property, 'font-size')
+})
+
+test('property: explicit "cor de fundo" → background-color', () => {
+  const i = parseIntent('muda a cor de fundo do hero pra #1a1a1a')
+  assert.equal(i.property, 'background-color')
+})
+
+test('property: explicit "cor do texto" → color', () => {
+  const i = parseIntent('muda a cor do texto do botão pra #fff')
+  assert.equal(i.property, 'color')
+})
+
+test('property: bare "cor" defaults to color (text)', () => {
+  const i = parseIntent('muda a cor do título pra red')
+  // The dictionary returns property='color' from "cor"; default would also be color.
+  assert.equal(i.property, 'color')
+})
+
+test('property: alt → alt', () => {
+  const i = parseIntent('change the image alt to "Hero shot"')
+  assert.equal(i.property, 'alt')
+})
+
+test('property: src → src', () => {
+  const i = parseIntent('change the image src to https://example.com/x.png')
+  assert.equal(i.property, 'src')
+})
+
+test('property: default for "increase title" with px → font-size', () => {
+  const i = parseIntent('increase the hero title to 32px')
+  assert.equal(i.property, 'font-size')
+})
+
+test('property: default for "set image alt" via quoted text', () => {
+  const i = parseIntent('change the hero image to "AlphaInfuse hero"')
+  // No "alt" word → defaults from value.kind=text + target.type=image → alt
+  assert.equal(i.property, 'alt')
+})
+
+// ─── Value extraction ─────────────────────────────────────────────────────────
+
+test('value: pixels', () => {
+  const v = extractValue('aumenta pra 32px')
+  assert.equal(v.kind, 'pixels')
+  assert.equal(v.parsed, 32)
+})
+
+test('value: pixels with decimal', () => {
+  const v = extractValue('change to 1.5px')
+  assert.equal(v.kind, 'pixels')
+  assert.equal(v.parsed, 1.5)
+})
+
+test('value: rem', () => {
+  const v = extractValue('change to 2rem')
+  assert.equal(v.kind, 'length')
+  assert.equal(v.parsed.value, 2)
+  assert.equal(v.parsed.unit, 'rem')
+})
+
+test('value: percent', () => {
+  const v = extractValue('change to 100%')
+  assert.equal(v.kind, 'length')
+  assert.equal(v.parsed.unit, '%')
+})
+
+test('value: hex color', () => {
+  const v = extractValue('cor pra #fff')
+  assert.equal(v.kind, 'color')
+  assert.equal(v.parsed, '#fff')
+})
+
+test('value: long hex color', () => {
+  const v = extractValue('cor pra #1a2b3c')
+  assert.equal(v.kind, 'color')
+  assert.equal(v.parsed, '#1a2b3c')
+})
+
+test('value: rgb()', () => {
+  const v = extractValue('change color to rgb(255, 0, 0)')
+  assert.equal(v.kind, 'color')
+  assert.match(v.parsed, /rgb\(/)
+})
+
+test('value: rgba()', () => {
+  const v = extractValue('change to rgba(0, 0, 0, 0.5)')
+  assert.equal(v.kind, 'color')
+})
+
+test('value: color name (red)', () => {
+  const v = extractValue('change color to red')
+  assert.equal(v.kind, 'color')
+  assert.equal(v.parsed, 'red')
+})
+
+test('value: color name PT (vermelho)', () => {
+  const v = extractValue('muda a cor pra vermelho')
+  assert.equal(v.kind, 'color')
+})
+
+test('value: quoted text (double)', () => {
+  const v = extractValue('change alt to "Hero shot"')
+  assert.equal(v.kind, 'text')
+  assert.equal(v.parsed, 'Hero shot')
+})
+
+test('value: quoted text (single)', () => {
+  const v = extractValue("change alt to 'Hero shot'")
+  assert.equal(v.kind, 'text')
+  assert.equal(v.parsed, 'Hero shot')
+})
+
+test('value: URL', () => {
+  const v = extractValue('change src to https://cdn.example.com/img.png')
+  assert.equal(v.kind, 'url')
+})
+
+test('value: bare number → number', () => {
+  const v = extractValue('aumenta para 32')
+  assert.equal(v.kind, 'number')
+  assert.equal(v.parsed, 32)
+})
+
+test('value: empty → null', () => {
+  const v = extractValue('aumenta o título')
+  assert.equal(v, null)
+})
+
+test('value: URL beats hex (URLs come first)', () => {
+  const v = extractValue('https://example.com/path?c=#fff')
+  assert.equal(v.kind, 'url')
+})
+
+test('value: quoted hex stays text not color', () => {
+  const v = extractValue('write "#fff" in the title')
+  assert.equal(v.kind, 'text')
+})
+
+// ─── Confidence scoring ───────────────────────────────────────────────────────
+
+test('confidence: complete request scores ≥ 0.7', () => {
+  const i = parseIntent('aumenta o título do hero pra 32px')
+  assert.ok(i.confidence >= 0.7, `confidence was ${i.confidence}`)
+})
+
+test('confidence: missing action drops below 0.7', () => {
+  const i = parseIntent('o título do hero pra 32px')
+  assert.ok(i.confidence < 0.7, `confidence was ${i.confidence}`)
+  assert.equal(i.reason, 'no-action-verb')
+})
+
+test('confidence: missing target drops', () => {
+  const i = parseIntent('aumenta para 32px')
+  assert.ok(i.confidence < 0.7, `confidence was ${i.confidence}`)
+})
+
+test('confidence: missing value for "set" drops', () => {
+  const i = parseIntent('troca o título do hero')
+  assert.ok(i.confidence < 0.7, `confidence was ${i.confidence}`)
+  assert.equal(i.reason, 'no-value')
+})
+
+test('confidence: remove without value is fine', () => {
+  const i = parseIntent('remove o segundo botão')
+  assert.ok(i.confidence >= 0.7, `confidence was ${i.confidence}`)
+})
+
+// ─── Language detection ──────────────────────────────────────────────────────
+
+test('language: PT', () => {
+  const i = parseIntent('aumenta o título do hero')
+  assert.equal(i.language, 'pt')
+})
+
+test('language: EN', () => {
+  const i = parseIntent('increase the hero title')
+  assert.equal(i.language, 'en')
+})
+
+test('language: unknown returns confidence ≤ 0.1', () => {
+  const i = parseIntent('zzz xxx yyy 123')
+  assert.equal(i.language, 'unknown')
+  assert.ok(i.confidence <= 0.2)
+  assert.equal(i.reason, 'language-unsupported')
+})
+
+test('language: empty request', () => {
+  const i = parseIntent('')
+  assert.equal(i.confidence, 0)
+})
+
+test('language: whitespace-only request', () => {
+  const i = parseIntent('   \t  \n  ')
+  assert.equal(i.confidence, 0)
+})
+
+// ─── defaultProperty ──────────────────────────────────────────────────────────
+
+test('defaultProperty: increase + heading + pixels → font-size', () => {
+  const p = defaultProperty({
+    action: 'increase',
+    target: { type: 'heading' },
+    value: { kind: 'pixels', parsed: 32 },
+  })
+  assert.equal(p, 'font-size')
+})
+
+test('defaultProperty: set + button + color → background-color', () => {
+  const p = defaultProperty({
+    action: 'set',
+    target: { type: 'button' },
+    value: { kind: 'color', parsed: '#fff' },
+  })
+  assert.equal(p, 'background-color')
+})
+
+test('defaultProperty: set + heading + color → color (text)', () => {
+  const p = defaultProperty({
+    action: 'set',
+    target: { type: 'heading' },
+    value: { kind: 'color', parsed: '#fff' },
+  })
+  assert.equal(p, 'color')
+})
+
+test('defaultProperty: set + image + url → src', () => {
+  const p = defaultProperty({
+    action: 'set',
+    target: { type: 'image' },
+    value: { kind: 'url', parsed: 'https://x' },
+  })
+  assert.equal(p, 'src')
+})
+
+test('defaultProperty: set + image + text → alt', () => {
+  const p = defaultProperty({
+    action: 'set',
+    target: { type: 'image' },
+    value: { kind: 'text', parsed: 'hero' },
+  })
+  assert.equal(p, 'alt')
+})
+
+test('defaultProperty: set + heading + text → text', () => {
+  const p = defaultProperty({
+    action: 'set',
+    target: { type: 'heading' },
+    value: { kind: 'text', parsed: 'New title' },
+  })
+  assert.equal(p, 'text')
+})
+
+test('defaultProperty: increase + image → width', () => {
+  const p = defaultProperty({
+    action: 'increase',
+    target: { type: 'image' },
+    value: { kind: 'pixels', parsed: 200 },
+  })
+  assert.equal(p, 'width')
+})
+
+test('defaultProperty: remove → null', () => {
+  const p = defaultProperty({
+    action: 'remove',
+    target: { type: 'button' },
+    value: null,
+  })
+  assert.equal(p, null)
+})
+
+test('defaultProperty: no target → null', () => {
+  const p = defaultProperty({ action: 'set', target: null, value: null })
+  assert.equal(p, null)
+})
+
+// ─── Edge cases ───────────────────────────────────────────────────────────────
+
+test('edge: typing "trocar" infinitive form', () => {
+  const i = parseIntent('quero trocar a imagem do hero por https://x.com/y.png')
+  assert.equal(i.action, 'set')
+  assert.equal(i.target.type, 'image')
+})
+
+test('edge: capitalization', () => {
+  const i = parseIntent('AUMENTA o TÍTULO do HERO PARA 32PX')
+  assert.equal(i.action, 'increase')
+  assert.equal(i.target.type, 'heading')
+  assert.equal(i.target.qualifier, 'hero')
+})
+
+test('edge: extra whitespace', () => {
+  const i = parseIntent('  aumenta   o   título   pra   32px  ')
+  assert.equal(i.action, 'increase')
+  assert.equal(i.value.parsed, 32)
+})
+
+test('edge: ordinal "1º" → first', () => {
+  const i = parseIntent('remove o 1º botão')
+  assert.equal(i.target.qualifier, 'first')
+})
+
+test('edge: longest target match wins (subtítulo not título)', () => {
+  const i = parseIntent('aumenta o subtítulo pra 16px')
+  assert.equal(i.target.type, 'subheading')
+})
+
+test('edge: increase + size verb gets px from bare number? No — needs explicit unit', () => {
+  // We treat bare number as "number" kind; CLI converts to px when target/property implies it.
+  const i = parseIntent('aumenta o título pra 32')
+  assert.equal(i.action, 'increase')
+  assert.equal(i.value.kind, 'number')
+})
+
+test('edge: link with quoted text targets href if URL given', () => {
+  const i = parseIntent('change the link to https://example.com')
+  assert.equal(i.target.type, 'link')
+  assert.equal(i.property, 'href')
+})
+
+test('edge: "fundo" alone implies background-color', () => {
+  const i = parseIntent('muda o fundo do hero pra #1a1a1a')
+  assert.equal(i.property, 'background-color')
+})
+
+test('edge: returns raw request for debugging', () => {
+  const i = parseIntent('aumenta o título')
+  assert.equal(i.raw, 'aumenta o título')
+})
+
+// ─── Done ─────────────────────────────────────────────────────────────────────
+
+process.stdout.write(`\n1..${passed + failed}\n# passed ${passed}, failed ${failed}\n`)
+process.exit(failed === 0 ? 0 : 1)