ex-thumbnailator/AGENTS.md

AGENTS.md

Repo: ex-thumbnailator

XQuery module for BaseX 10+ wrapping thumbnailator Java library.

Quick start

• Build: tools/build.xq → dist/thumbnailator-8.0.1.xar
• Test: src/test/test.xqm (%unit:test functions)
• Sample: src/test/sample.xq

API

Function	Returns
thumbnails:size($src, $w, $h)	xs:base64Binary
thumbnails:scale($src, $x, $y)	xs:base64Binary
thumbnails:task($src, $task)	xs:base64Binary
thumbnails:validate($src)	empty-sequence() or error
thumbnails:validation-report($src)	element(report)

Inputs from fetch:binary(), outputs via file:write-binary().

XML schema

• Root: <thumbnail> (not <task>)
• Either <size> or <scale> required
• constrain@exif="true" default: swaps dimensions for portrait, ignores flip

Structure

src/main/           # XQuery, JARs, XSD, basex.xml, expath-pkg.xml
src/java/           # Thumbs.java (BaseX QueryModule)
src/test/           # test.xqm, sample.xq, test tasks
tools/              # build.xq
dist/               # built xar package

Setup

• BaseX 10+, Java 17
• JARs: thumbnailator-0.4.13.jar, thumbhelper-8.0.0.jar