@tangle-network/browser-agent-driver 0.33.2 → 0.34.0

package/dist/design/audit/reference/dna/derive.js

@@ -0,0 +1,381 @@
+/**
+ * Design-DNA derivation — the PURE core of the reference engine's FOUNDATION.
+ *
+ * `toDesignDNA` folds an already-extracted `DesignTokens` record (+ optional
+ * deterministic `MeasurementBundle`) into the normalised, browser-free
+ * `DesignDNA` identity. It performs NO IO, NO LLM, NO browser work and is fully
+ * deterministic, so it unit-tests on static token fixtures alone.
+ *
+ * Altitude discipline (per ARCHITECTURE.md §0): this is a LOSSY normalisation of
+ * tokens. It CARRIES THROUGH the already-computed `ColorToken.cluster` and
+ * `ViewportTokens.gridBaseUnit` rather than re-clustering colours or re-detecting
+ * a grid — those decisions belong to the token extractor, not here.
+ */
+import { foldScrollMotion } from './scroll-capture.js';
+// Adjacent type-scale ratios this close to each other (max/min) read as one
+// modular scale; beyond it the scale is irregular and no ratio is reported.
+const RATIO_CONSISTENCY_TOLERANCE = 1.12;
+// CSS `line-height: normal` has no numeric value to read; this is the
+// conventional ~1.2 approximation used only when the keyword/garbage is present.
+const NORMAL_LINE_HEIGHT = 1.2;
+// A heading at or above this rendered size is classified as a display step.
+const DISPLAY_MIN_PX = 40;
+// Distinct component-pattern thresholds for the whitespace-free density proxy.
+const SPARSE_MAX_PATTERNS = 4;
+const BALANCED_MAX_PATTERNS = 12;
+// Substrings that mark a detected library as motion-related.
+const ANIMATION_LIB_PATTERNS = [
+    'gsap',
+    'framer',
+    'lottie',
+    'anime',
+    'aos',
+    'velocity',
+    'react-spring',
+    'lenis',
+    'scrollmagic',
+    'rive',
+    'three.js',
+    'threejs',
+];
+const round2 = (n) => Math.round(n * 100) / 100;
+function primaryFamily(stack) {
+    const first = stack.split(',')[0]?.trim() ?? '';
+    return first.replace(/^["']|["']$/g, '');
+}
+function parseWeight(raw) {
+    const n = parseInt(raw, 10);
+    if (Number.isFinite(n) && n > 0)
+        return n;
+    const named = { normal: 400, bold: 700, lighter: 300, bolder: 700 };
+    return named[raw.trim().toLowerCase()] ?? 400;
+}
+function lineHeightRatio(raw, fontSizePx) {
+    const trimmed = raw.trim();
+    if (trimmed === 'normal' || trimmed === '')
+        return NORMAL_LINE_HEIGHT;
+    const px = trimmed.match(/^([\d.]+)px$/);
+    if (px && fontSizePx > 0)
+        return round2(parseFloat(px[1]) / fontSizePx);
+    const pct = trimmed.match(/^([\d.]+)%$/);
+    if (pct)
+        return round2(parseFloat(pct[1]) / 100);
+    const num = parseFloat(trimmed);
+    if (Number.isFinite(num) && !/[a-z%]/i.test(trimmed))
+        return round2(num);
+    return NORMAL_LINE_HEIGHT;
+}
+function stepRole(usage, fontSizePx) {
+    if (usage === 'heading')
+        return fontSizePx >= DISPLAY_MIN_PX ? 'display' : 'heading';
+    return usage;
+}
+function parsePx(raw) {
+    const m = raw.trim().match(/^(-?[\d.]+)px$/);
+    if (!m)
+        return undefined;
+    const n = parseFloat(m[1]);
+    return Number.isFinite(n) ? n : undefined;
+}
+function detectRatio(steps) {
+    const sizes = [...new Set(steps.map((s) => s.fontSizePx))].sort((a, b) => a - b);
+    if (sizes.length < 2)
+        return undefined;
+    const ratios = [];
+    for (let i = 1; i < sizes.length; i++) {
+        if (sizes[i - 1] > 0)
+            ratios.push(sizes[i] / sizes[i - 1]);
+    }
+    if (ratios.length === 0)
+        return undefined;
+    const min = Math.min(...ratios);
+    const max = Math.max(...ratios);
+    if (min <= 0 || max / min > RATIO_CONSISTENCY_TOLERANCE)
+        return undefined;
+    return round2(ratios.reduce((a, b) => a + b, 0) / ratios.length);
+}
+function deriveDensity(componentPatternCount, whitespaceRatio) {
+    if (whitespaceRatio !== undefined) {
+        if (whitespaceRatio >= 0.6)
+            return 'sparse';
+        if (whitespaceRatio >= 0.35)
+            return 'balanced';
+        return 'dense';
+    }
+    if (componentPatternCount <= SPARSE_MAX_PATTERNS)
+        return 'sparse';
+    if (componentPatternCount <= BALANCED_MAX_PATTERNS)
+        return 'balanced';
+    return 'dense';
+}
+function aggregateSpacingSteps(responsive) {
+    const set = new Set();
+    for (const vp of Object.values(responsive)) {
+        for (const s of vp.spacing) {
+            const px = parsePx(s.value);
+            if (px !== undefined && px > 0)
+                set.add(Math.round(px));
+        }
+    }
+    return [...set].sort((a, b) => a - b);
+}
+function aggregateRadii(responsive) {
+    const set = new Set();
+    for (const vp of Object.values(responsive)) {
+        for (const b of vp.borders) {
+            const px = parsePx(b.borderRadius);
+            if (px !== undefined && px > 0)
+                set.add(Math.round(px));
+        }
+    }
+    return [...set].sort((a, b) => a - b);
+}
+function pickGridBaseUnit(responsive) {
+    const desktop = responsive['desktop'];
+    if (desktop && desktop.gridBaseUnit !== undefined)
+        return desktop.gridBaseUnit;
+    const counts = new Map();
+    for (const vp of Object.values(responsive)) {
+        if (vp.gridBaseUnit !== undefined)
+            counts.set(vp.gridBaseUnit, (counts.get(vp.gridBaseUnit) ?? 0) + 1);
+    }
+    if (counts.size === 0)
+        return undefined;
+    let best;
+    let bestCount = -1;
+    // Sort by unit asc first so an equal-frequency tie resolves to the smallest unit.
+    for (const [unit, count] of [...counts.entries()].sort((a, b) => a[0] - b[0])) {
+        if (count > bestCount) {
+            bestCount = count;
+            best = unit;
+        }
+    }
+    return best;
+}
+function parseDurationsMs(value) {
+    const out = [];
+    const re = /(\d*\.?\d+)\s*(ms|s)\b/gi;
+    let m;
+    while ((m = re.exec(value)) !== null) {
+        const n = parseFloat(m[1]);
+        if (!Number.isFinite(n))
+            continue;
+        const ms = m[2].toLowerCase() === 's' ? n * 1000 : n;
+        if (ms > 0)
+            out.push(Math.round(ms));
+    }
+    return out;
+}
+function parseEasings(value) {
+    const out = [];
+    const fn = /(cubic-bezier|steps)\s*\([^)]*\)/gi;
+    let m;
+    while ((m = fn.exec(value)) !== null)
+        out.push(m[0].replace(/\s+/g, ''));
+    const named = /\b(ease-in-out|ease-in|ease-out|ease|linear|step-start|step-end)\b/gi;
+    while ((m = named.exec(value)) !== null)
+        out.push(m[1].toLowerCase());
+    return out;
+}
+function detectAnimationLibraries(libs) {
+    const out = new Set();
+    for (const lib of libs) {
+        const norm = lib.toLowerCase();
+        if (ANIMATION_LIB_PATTERNS.some((p) => norm.includes(p)))
+            out.add(lib);
+    }
+    return [...out].sort();
+}
+function deriveMotion(responsive, detectedLibraries, scroll) {
+    const durations = new Set();
+    const easings = new Set();
+    for (const vp of Object.values(responsive)) {
+        for (const a of vp.animations) {
+            for (const d of parseDurationsMs(a.value))
+                durations.add(d);
+            for (const e of parseEasings(a.value))
+                easings.add(e);
+        }
+    }
+    const motion = {
+        durationsMs: [...durations].sort((a, b) => a - b),
+        easings: [...easings].sort(),
+        libraries: detectAnimationLibraries(detectedLibraries),
+    };
+    // Live-observed scroll motion, when the opt-in capture pass ran. Absent =
+    // not captured (never read as "no scroll motion").
+    if (scroll)
+        motion.scroll = foldScrollMotion(scroll);
+    return motion;
+}
+function distinctComponentCount(responsive, kind) {
+    const set = new Set();
+    for (const vp of Object.values(responsive)) {
+        for (const c of vp.components[kind])
+            set.add(c.fingerprint);
+    }
+    return set.size;
+}
+function distinctNavCount(responsive) {
+    const set = new Set();
+    for (const vp of Object.values(responsive)) {
+        for (const n of vp.components.nav)
+            set.add(n.selector);
+    }
+    return set.size;
+}
+/**
+ * A coarse, deterministic structural archetype label derived from the dominant
+ * component composition. Free-form by contract — a hint for retrieval, never a
+ * forced bucket — so novel compositions fall through to `content-flow`.
+ */
+function deriveArchetype(c) {
+    if (c.buttons === 0 && c.inputs === 0 && c.cards === 0 && c.nav === 0)
+        return 'minimal';
+    if (c.inputs >= 3 && c.inputs >= c.cards)
+        return 'form-shell';
+    if (c.cards >= 3 && c.cards >= c.inputs)
+        return 'card-grid';
+    if (c.nav >= 1 && c.buttons >= 2 && c.cards < 3)
+        return 'nav-content';
+    return 'content-flow';
+}
+/**
+ * Fold a `DesignTokens` record (+ optional measurements + optional live
+ * `RawScrollCapture`) into a `DesignDNA`. Pure and deterministic: identical
+ * inputs always yield an identical DNA. `scroll` is attached as `motion.scroll`
+ * only when supplied — the browser layer captures it; this fold never observes a
+ * page.
+ */
+export function toDesignDNA(tokens, measurements, scroll) {
+    const steps = tokens.typography.scale
+        .map((e) => {
+        const fontSizePx = round2(parseFloat(e.fontSize));
+        return {
+            fontSizePx,
+            weight: parseWeight(e.fontWeight),
+            lineHeight: lineHeightRatio(e.lineHeight, fontSizePx),
+            family: primaryFamily(e.fontFamily),
+            role: stepRole(e.usage, fontSizePx),
+        };
+    })
+        .filter((s) => Number.isFinite(s.fontSizePx) && s.fontSizePx > 0)
+        .sort((a, b) => a.fontSizePx - b.fontSizePx);
+    const families = tokens.typography.families.map((f) => ({
+        family: f.family,
+        role: f.classification,
+        weights: [...f.weights].sort((a, b) => a - b),
+    }));
+    // Colour roles are a 1:1 carry-through of the precomputed cluster — never a
+    // re-clustering. Tokens with no cluster are deliberately dropped, not guessed.
+    const roles = {
+        primary: [],
+        secondary: [],
+        accent: [],
+        neutral: [],
+        background: [],
+        border: [],
+    };
+    for (const c of tokens.colors) {
+        if (!c.cluster)
+            continue;
+        const bucket = roles[c.cluster];
+        if (!bucket.includes(c.hex))
+            bucket.push(c.hex);
+    }
+    const failures = measurements?.contrast.aaFailures ?? [];
+    const contrastFloor = failures.length > 0 ? round2(Math.min(...failures.map((f) => f.ratio))) : undefined;
+    const components = {
+        buttons: distinctComponentCount(tokens.responsive, 'buttons'),
+        inputs: distinctComponentCount(tokens.responsive, 'inputs'),
+        cards: distinctComponentCount(tokens.responsive, 'cards'),
+        nav: distinctNavCount(tokens.responsive),
+    };
+    const baseUnit = pickGridBaseUnit(tokens.responsive);
+    const density = deriveDensity(components.buttons + components.inputs + components.cards + components.nav);
+    const signals = measurements
+        ? {
+            contrastAaPassRate: measurements.contrast.summary.aaPassRate,
+            a11yBlockingCount: measurements.a11y.violations.filter((v) => v.impact === 'critical' || v.impact === 'serious').length,
+        }
+        : undefined;
+    return {
+        url: tokens.url,
+        capturedAt: tokens.extractedAt,
+        type: {
+            steps,
+            ratio: detectRatio(steps),
+            families,
+        },
+        color: {
+            roles,
+            contrastFloor,
+        },
+        spacing: {
+            baseUnit,
+            steps: aggregateSpacingSteps(tokens.responsive),
+            density,
+        },
+        radii: {
+            steps: aggregateRadii(tokens.responsive),
+        },
+        motion: deriveMotion(tokens.responsive, tokens.detectedLibraries, scroll),
+        layout: {
+            columns: undefined,
+            gridBaseUnit: baseUnit,
+            whitespaceRatio: undefined,
+            density,
+            archetype: deriveArchetype(components),
+        },
+        components,
+        signals,
+    };
+}
+/**
+ * Render the observed scroll-motion as a compact clause appended to the motion
+ * line, or '' when no scroll pass was captured (honest absence). Reports the
+ * measured numbers even when `scrollDriven` is false (a captured-but-quiet page),
+ * tagging that case so the reader can distinguish it from a motion-rich one.
+ */
+function scrollMotionClause(scroll) {
+    if (!scroll)
+        return '';
+    const parts = [`${scroll.pageHeightRatio}× tall`, `${scroll.reveals.count} reveals`];
+    if (scroll.reveals.kinds.length)
+        parts[parts.length - 1] += ` (${scroll.reveals.kinds.join('/')})`;
+    if (scroll.stickyCount > 0)
+        parts.push(`${scroll.stickyCount} sticky`);
+    if (scroll.parallax > 0)
+        parts.push(`parallax ${scroll.parallax}`);
+    return `; scroll: ${parts.join(', ')}${scroll.scrollDriven ? '' : ' (quiet)'}`;
+}
+/**
+ * A budget-bounded, prompt-ready summary of a `DesignDNA`. Deterministic and
+ * IO-free; truncates to `maxChars` so an injected reference can never blow the
+ * generation/judge token budget.
+ */
+export function summarizeDNA(dna, opts = {}) {
+    const maxChars = opts.maxChars ?? 1200;
+    const sizes = dna.type.steps.map((s) => s.fontSizePx).join('/');
+    const ratio = dna.type.ratio !== undefined ? `~${dna.type.ratio}×` : 'irregular';
+    const fams = dna.type.families.map((f) => `${f.family}(${f.role})`).join(', ');
+    const colorLine = Object.keys(dna.color.roles)
+        .filter((r) => dna.color.roles[r].length > 0)
+        .map((r) => `${r}:${dna.color.roles[r].join(' ')}`)
+        .join('  ');
+    const lines = [
+        `type: ${sizes || 'none'} px, scale ${ratio}; families ${fams || 'none'}`,
+        `color: ${colorLine || 'none'}${dna.color.contrastFloor !== undefined ? ` (contrast floor ${dna.color.contrastFloor})` : ''}`,
+        `spacing: base ${dna.spacing.baseUnit ?? 'none'} px, steps ${dna.spacing.steps.join('/') || 'none'}, ${dna.spacing.density}`,
+        `radii: ${dna.radii.steps.join('/') || 'none'} px`,
+        `motion: ${dna.motion.durationsMs.join('/') || 'none'} ms, ${dna.motion.easings.join(' ') || 'no-easing'}${dna.motion.libraries.length ? `, libs ${dna.motion.libraries.join(' ')}` : ''}${scrollMotionClause(dna.motion.scroll)}`,
+        `layout: ${dna.layout.archetype}, ${dna.layout.density}`,
+        `components: ${dna.components.buttons}btn ${dna.components.inputs}input ${dna.components.cards}card ${dna.components.nav}nav`,
+    ];
+    if (dna.signals) {
+        lines.push(`signals: contrast AA ${dna.signals.contrastAaPassRate ?? '?'}, a11y blocking ${dna.signals.a11yBlockingCount ?? '?'}`);
+    }
+    const body = lines.join('\n');
+    return body.length > maxChars ? `${body.slice(0, maxChars - 1)}…` : body;
+}
+//# sourceMappingURL=derive.js.map

package/dist/design/audit/reference/dna/derive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.js","sourceRoot":"","sources":["../../../../../src/design/audit/reference/dna/derive.ts"],"names":[],"mappings":"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"}

package/dist/design/audit/reference/dna/descriptor.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Design-DNA derivatives for RETRIEVAL — the two PURE projections of a
+ * `DesignDNA` the reference engine needs before it can match exemplars.
+ *
+ *  - `aestheticDescriptor` renders a DNA as a compact, qualitative aesthetic
+ *    PHRASE — the text the `EmbeddingProvider` embeds. It deliberately does NOT
+ *    overlap `summarizeDNA` (dna/derive.ts): that summary is a numeric SPEC dump
+ *    for prompt/judge injection (exact px lists, hex values); this is a bag of
+ *    aesthetic KEYWORDS (density, archetype, scale character, palette
+ *    temperature, roundness, motion energy) chosen so semantically-similar
+ *    designs land near each other in embedding space. Same field-traversal order
+ *    as `summarizeDNA`, no shared logic — neither duplicates the other.
+ *  - `structuralFeatures` renders a DNA as a deterministic, fixed-length numeric
+ *    vector — the matcher's optional secondary (structural) similarity signal.
+ *    The matcher derives the exemplar side of this comparison with the SAME
+ *    function, so both sides live in one feature space.
+ *
+ * Both are pure: no IO, no LLM, no browser; identical inputs → identical output.
+ */
+import type { DesignDNA } from '../contracts.js';
+/**
+ * Render a `DesignDNA` as a budget-bounded, qualitative aesthetic descriptor for
+ * embedding/retrieval. Deterministic and IO-free; clipped to `maxChars` so an
+ * embedder's token budget can never be blown.
+ */
+export declare function aestheticDescriptor(dna: DesignDNA, opts?: {
+    maxChars?: number;
+}): string;
+/**
+ * Project a `DesignDNA` onto a deterministic, fixed-length structural feature
+ * vector. Order-stable and identical across calls; every component is bounded so
+ * the vector is safe to feed straight into `cosineSimilarity`. Missing signals
+ * collapse to a neutral 0 rather than being dropped, keeping the length fixed.
+ */
+export declare function structuralFeatures(dna: DesignDNA): number[];
+//# sourceMappingURL=descriptor.d.ts.map

package/dist/design/audit/reference/dna/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../../../../src/design/audit/reference/dna/descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,iBAAiB,CAAA;AA8F3D;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CA+B5F;AAuBD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,EAAE,CAsB3D"}

package/dist/design/audit/reference/dna/descriptor.js

@@ -0,0 +1,209 @@
+/**
+ * Design-DNA derivatives for RETRIEVAL — the two PURE projections of a
+ * `DesignDNA` the reference engine needs before it can match exemplars.
+ *
+ *  - `aestheticDescriptor` renders a DNA as a compact, qualitative aesthetic
+ *    PHRASE — the text the `EmbeddingProvider` embeds. It deliberately does NOT
+ *    overlap `summarizeDNA` (dna/derive.ts): that summary is a numeric SPEC dump
+ *    for prompt/judge injection (exact px lists, hex values); this is a bag of
+ *    aesthetic KEYWORDS (density, archetype, scale character, palette
+ *    temperature, roundness, motion energy) chosen so semantically-similar
+ *    designs land near each other in embedding space. Same field-traversal order
+ *    as `summarizeDNA`, no shared logic — neither duplicates the other.
+ *  - `structuralFeatures` renders a DNA as a deterministic, fixed-length numeric
+ *    vector — the matcher's optional secondary (structural) similarity signal.
+ *    The matcher derives the exemplar side of this comparison with the SAME
+ *    function, so both sides live in one feature space.
+ *
+ * Both are pure: no IO, no LLM, no browser; identical inputs → identical output.
+ */
+const round2 = (n) => Math.round(n * 100) / 100;
+const clamp01 = (n) => (n < 0 ? 0 : n > 1 ? 1 : n);
+const COLOR_ROLE_ORDER = ['primary', 'secondary', 'accent', 'neutral', 'background', 'border'];
+/** Parse `#rgb` / `#rrggbb` into 0-255 channels, or undefined for anything else. */
+function parseHex(hex) {
+    const m = hex.trim().match(/^#([0-9a-f]{3}|[0-9a-f]{6})$/i);
+    if (!m)
+        return undefined;
+    const h = m[1];
+    const full = h.length === 3 ? h.replace(/(.)/g, '$1$1') : h;
+    const r = parseInt(full.slice(0, 2), 16);
+    const g = parseInt(full.slice(2, 4), 16);
+    const b = parseInt(full.slice(4, 6), 16);
+    return { r, g, b };
+}
+/**
+ * Qualitative colour temperature of a hex: warm (red-led), cool (blue-led) or
+ * neutral (low saturation / green-led). A coarse aesthetic cue for retrieval.
+ */
+function colorTemperature(hex) {
+    const rgb = parseHex(hex);
+    if (!rgb)
+        return 'neutral';
+    const { r, g, b } = rgb;
+    const max = Math.max(r, g, b);
+    const min = Math.min(r, g, b);
+    const sat = max === 0 ? 0 : (max - min) / max;
+    if (sat < 0.15)
+        return 'neutral';
+    if (r >= b && r >= g)
+        return 'warm';
+    if (b >= r && b >= g)
+        return 'cool';
+    return 'neutral';
+}
+/** Aggressiveness of the modular type scale, as an aesthetic word. */
+function scaleCharacter(ratio) {
+    if (ratio === undefined)
+        return 'irregular scale';
+    if (ratio < 1.18)
+        return `tight scale ~${round2(ratio)}`;
+    if (ratio < 1.4)
+        return `modular scale ~${round2(ratio)}`;
+    return `dramatic scale ~${round2(ratio)}`;
+}
+/** Corner roundness as an aesthetic word, from the largest radius. */
+function roundnessCharacter(steps) {
+    if (steps.length === 0)
+        return 'sharp corners';
+    const max = Math.max(...steps);
+    if (max >= 999)
+        return 'pill corners';
+    if (max >= 16)
+        return `very rounded corners ${max}px`;
+    if (max >= 6)
+        return `rounded corners ${max}px`;
+    return `slightly rounded corners ${max}px`;
+}
+/** Static motion energy as an aesthetic word, from the token rip. */
+function staticMotionCharacter(dna) {
+    const { durationsMs, libraries } = dna.motion;
+    if (libraries.length > 0)
+        return `animated motion (${libraries.join(' ')})`;
+    if (durationsMs.length === 0)
+        return 'static, no motion';
+    const median = durationsMs[Math.floor(durationsMs.length / 2)];
+    if (median <= 200)
+        return `snappy motion ~${median}ms`;
+    if (median <= 450)
+        return `smooth motion ~${median}ms`;
+    return `slow motion ~${median}ms`;
+}
+/**
+ * Motion energy as an aesthetic word. Appends scroll-driven keywords ONLY when a
+ * scroll pass was captured AND read the page as motion-rich, so scroll-rich pages
+ * cluster near scroll-rich exemplars in embedding space. A page with no captured
+ * scroll (or a captured-but-quiet one) reads exactly as before — the existing
+ * corpus, captured statically, is unaffected.
+ */
+function motionCharacter(dna) {
+    const base = staticMotionCharacter(dna);
+    const s = dna.motion.scroll;
+    if (!s || !s.scrollDriven)
+        return base;
+    const words = [];
+    if (s.pageHeightRatio >= 2.5)
+        words.push('long-form scroll');
+    if (s.reveals.count >= 2) {
+        words.push(`${s.reveals.count} scroll reveals${s.reveals.kinds.length ? ` (${s.reveals.kinds.join('/')})` : ''}`);
+    }
+    if (s.stickyCount >= 1)
+        words.push('sticky pinning');
+    if (s.parallax >= 0.25)
+        words.push('parallax depth');
+    return words.length ? `${base}, scroll-driven: ${words.join(', ')}` : base;
+}
+/** Contrast posture as an aesthetic word, when a floor was measured. */
+function contrastCharacter(floor) {
+    if (floor === undefined)
+        return undefined;
+    if (floor >= 7)
+        return 'high-contrast';
+    if (floor >= 4.5)
+        return 'adequate-contrast';
+    return 'low-contrast';
+}
+/**
+ * Render a `DesignDNA` as a budget-bounded, qualitative aesthetic descriptor for
+ * embedding/retrieval. Deterministic and IO-free; clipped to `maxChars` so an
+ * embedder's token budget can never be blown.
+ */
+export function aestheticDescriptor(dna, opts = {}) {
+    const maxChars = opts.maxChars ?? 600;
+    const displayLed = dna.type.steps.some((s) => s.role === 'display');
+    const families = dna.type.families.map((f) => f.family).filter(Boolean);
+    const typeParts = [
+        `${dna.type.steps.length}-step ${scaleCharacter(dna.type.ratio)}`,
+        displayLed ? 'display-led' : 'text-led',
+        families.length ? `families ${families.join(' ')}` : 'system fonts',
+    ];
+    const populatedRoles = COLOR_ROLE_ORDER.filter((r) => dna.color.roles[r].length > 0);
+    const primaryHex = dna.color.roles.primary[0] ?? dna.color.roles.accent[0];
+    const paletteTemp = primaryHex ? colorTemperature(primaryHex) : 'neutral';
+    const paletteSize = populatedRoles.length <= 2 ? 'minimal palette' : populatedRoles.length >= 5 ? 'rich palette' : 'balanced palette';
+    const contrastWord = contrastCharacter(dna.color.contrastFloor);
+    const colorParts = [`${paletteTemp} ${paletteSize}`, `${populatedRoles.length} roles`];
+    if (contrastWord)
+        colorParts.push(contrastWord);
+    const c = dna.components;
+    const lines = [
+        `${dna.layout.density} density, ${dna.layout.archetype} archetype`,
+        `type: ${typeParts.join(', ')}`,
+        `colour: ${colorParts.join(', ')}`,
+        `spacing: ${dna.spacing.density} rhythm${dna.spacing.baseUnit !== undefined ? ` on ${dna.spacing.baseUnit}px grid` : ', no clear grid'}`,
+        `form: ${roundnessCharacter(dna.radii.steps)}`,
+        `motion: ${motionCharacter(dna)}`,
+        `components: ${c.buttons} button, ${c.inputs} input, ${c.cards} card, ${c.nav} nav patterns`,
+    ];
+    const body = lines.join('; ');
+    return body.length > maxChars ? `${body.slice(0, maxChars - 1)}…` : body;
+}
+// Fixed feature layout — index order is the contract, every slot is bounded to
+// ~[0,1] so cosine similarity over the vector stays well-conditioned. Changing
+// the order or length is a breaking change to any corpus embedded against it.
+const TYPE_STEP_SCALE = 8;
+const TYPE_FAMILY_SCALE = 4;
+const COLOR_ROLE_COUNT = 6;
+const MAX_CONTRAST_RATIO = 21;
+const MAX_GRID_UNIT = 16;
+const SPACING_STEP_SCALE = 10;
+const RADIUS_ROUNDNESS_SCALE = 32;
+const RADIUS_STEP_SCALE = 6;
+const MOTION_DURATION_SCALE = 6;
+const COMPONENT_SCALE = 8;
+const NAV_SCALE = 4;
+const DENSITY_SCORE = {
+    sparse: 0,
+    balanced: 0.5,
+    dense: 1,
+};
+/**
+ * Project a `DesignDNA` onto a deterministic, fixed-length structural feature
+ * vector. Order-stable and identical across calls; every component is bounded so
+ * the vector is safe to feed straight into `cosineSimilarity`. Missing signals
+ * collapse to a neutral 0 rather than being dropped, keeping the length fixed.
+ */
+export function structuralFeatures(dna) {
+    const populatedRoles = COLOR_ROLE_ORDER.filter((r) => dna.color.roles[r].length > 0).length;
+    const maxRadius = dna.radii.steps.length ? Math.max(...dna.radii.steps) : 0;
+    const c = dna.components;
+    return [
+        clamp01(dna.type.steps.length / TYPE_STEP_SCALE),
+        dna.type.ratio !== undefined ? clamp01((dna.type.ratio - 1) / 0.6) : 0,
+        clamp01(dna.type.families.length / TYPE_FAMILY_SCALE),
+        clamp01(populatedRoles / COLOR_ROLE_COUNT),
+        dna.color.contrastFloor !== undefined ? clamp01(dna.color.contrastFloor / MAX_CONTRAST_RATIO) : 0,
+        dna.spacing.baseUnit !== undefined ? clamp01(dna.spacing.baseUnit / MAX_GRID_UNIT) : 0,
+        clamp01(dna.spacing.steps.length / SPACING_STEP_SCALE),
+        DENSITY_SCORE[dna.spacing.density],
+        clamp01(maxRadius / RADIUS_ROUNDNESS_SCALE),
+        clamp01(dna.radii.steps.length / RADIUS_STEP_SCALE),
+        clamp01(dna.motion.durationsMs.length / MOTION_DURATION_SCALE),
+        dna.motion.libraries.length > 0 ? 1 : 0,
+        clamp01(c.buttons / COMPONENT_SCALE),
+        clamp01(c.inputs / COMPONENT_SCALE),
+        clamp01(c.cards / COMPONENT_SCALE),
+        clamp01(c.nav / NAV_SCALE),
+    ].map(round2);
+}
+//# sourceMappingURL=descriptor.js.map