aegis-desktop 1.0.13 → 1.0.15

package/renderer/avatar/assemble.js

@@ -1,337 +1,3 @@
 // SPDX-License-Identifier: AGPL-3.0-or-later
 // Copyright (C) 2026 Niklas Borneklint — AEGIS Code (aegiscode) / Aegiscloud.
-// AEGIS Code (aegiscode) — source: https://github.com/aegisinfo/aegiscode-plugin
-// Conveying a modified copy, or running one as a network service, owes the
-// corresponding source under this licence (§5/§13) — see LICENSING.md.
-'use strict';
-
-/**
- * assemble.js — persona JSON in, layered SVG out.
- *
- * A pure string builder. It takes a validated persona record plus one
- * expression id and returns the markup, the layer list it walked, and — the
- * part that matters — a `warnings`/`missing` pair. Three rules:
- *
- *  1. **Never blank, never throw.** An id the manifest does not know (a persona
- *     hand-edited, or written by a newer release) renders the default part and
- *     is REPORTED. `persona.js` made the same choice at the storage boundary
- *     for the same reason: the user's own file must not be able to take the
- *     companion's face away.
- *
- *  2. **No interpolation of user text.** Nothing the user typed is placed in
- *     the markup, so there is no escaping question and no injection surface:
- *     the only persona-supplied value that reaches the SVG is `hairColor`, and
- *     it is re-checked against `#rrggbb` here even though `persona.js` already
- *     checked it. Geometry comes from the manifest, which is code.
- *
- *  3. **No styles, no scripts, no references.** The output carries no `<style>`,
- *     no `on*` attribute and no `href`/`url(...)`: motion lives in avatar.css,
- *     keyed off the `data-motion` attribute this file sets. That keeps the
- *     renderer's CSP (`script-src 'self'; style-src 'self'`) satisfied by
- *     construction, and `desktop/test/avatar-render.test.mjs` asserts all four
- *     absences rather than trusting this paragraph.
- *
- * Pure: no DOM, no Electron. It runs identically under `node --test` and in the
- * renderer, which is what makes the whole phase testable.
- */
-
-'use strict';
-
-const pkg = typeof window !== 'undefined' && window.AegisAvatarParts
-  ? window.AegisAvatarParts
-  : typeof module !== 'undefined' && module.exports
-    ? require('./parts.js')
-    : null;
-
-if (!pkg) throw new Error('avatar/assemble.js: avatar/parts.js must be loaded first');
-
-const HEX = /^#[0-9a-f]{6}$/i;
-
-/** Lighten (`amount > 0`) or darken (`amount < 0`) a `#rrggbb` colour. */
-function shade(hex, amount) {
-  const m = HEX.exec(String(hex || ''));
-  if (!m) return hex;
-  const n = parseInt(m[0].slice(1), 16);
-  const target = amount < 0 ? 0 : 255;
-  const k = Math.min(1, Math.abs(amount));
-  const mix = (c) => Math.round(c * (1 - k) + target * k);
-  const r = mix((n >> 16) & 255);
-  const g = mix((n >> 8) & 255);
-  const b = mix(n & 255);
-  return `#${((r << 16) | (g << 8) | b).toString(16).padStart(6, '0')}`;
-}
-
-/** Walk a flat list of shape specs, keeping only the ones with geometry. */
-function shapesOf(list) {
-  return Array.isArray(list) ? list.filter((s) => s && typeof s === 'object') : [];
-}
-
-/** A path string from an expression is geometry — normalise it to a shape. */
-function asStrokes(value) {
-  if (typeof value === 'string' && value.trim()) return [{ kind: 'path', d: value, stroke: true }];
-  if (!Array.isArray(value)) return [];
-  return value
-    .map((v) => (typeof v === 'string' ? { kind: 'path', d: v, stroke: true } : v))
-    .filter((s) => s && typeof s === 'object');
-}
-
-function call(fn, ...args) {
-  return typeof fn === 'function' ? fn(...args) : undefined;
-}
-
-/**
- * Resolve a custom expression from `persona.expressions.custom`.
- *
- * A custom expression is DATA too: `{ mouth, brows, eyes }` where `mouth` is an
- * SVG path, `brows` is a path or a list of paths, and `eyes` names one of the
- * manifest's eye overrides. Anything unrecognised is dropped with a warning, so
- * a half-written custom expression renders the core face rather than nothing.
- */
-function customExpression(persona, id, warnings) {
-  const custom = persona && persona.expressions && persona.expressions.custom;
-  const record = custom && typeof custom === 'object' ? custom[id] : null;
-  if (!record || typeof record !== 'object') return null;
-  const out = { label: id, custom: true };
-  if (typeof record.mouth === 'string' && record.mouth.trim()) out.mouth = record.mouth.trim();
-  if (record.brows !== undefined) out.brows = asStrokes(record.brows).map((s) => s.d);
-  if (record.eyes !== undefined) {
-    if (typeof record.eyes === 'string' && pkg.EYE_OVERRIDES[record.eyes]) out.eyes = record.eyes;
-    else warnings.push(`custom expression ${id}: unknown eye override ${JSON.stringify(record.eyes)} — ignored`);
-  }
-  if (out.mouth === undefined && out.brows === undefined && out.eyes === undefined) {
-    warnings.push(`custom expression ${id} carries no drawable geometry — ignored`);
-    return null;
-  }
-  return out;
-}
-
-/**
- * Assemble the avatar.
- *
- * @param {object} persona a persona record (validated or raw — both survive)
- * @param {object} [opts]
- * @param {string} [opts.expression] an `events.js` expression id
- * @param {boolean} [opts.reducedMotion] the OS preference; forces `minimal`
- * @param {string} [opts.motion] explicit override, mostly for tests
- * @returns {{ svg: string, layers: object[], warnings: string[], missing: string[],
- *             expression: string, palette: string, frame: string, motion: string }}
- */
-function assemble(persona, opts = {}) {
-  const warnings = [];
-  const missing = [];
-  const p = persona && typeof persona === 'object' ? persona : pkg.defaultPersona();
-  const presentation = p.presentation && typeof p.presentation === 'object' ? p.presentation : {};
-  const appearance = p.appearance && typeof p.appearance === 'object' ? p.appearance : {};
-
-  // ---- palette / skin / hair colour --------------------------------------
-  const paletteId = pkg.PALETTES[presentation.palette] ? presentation.palette : 'amber';
-  if (presentation.palette !== undefined && paletteId !== presentation.palette) {
-    warnings.push(`unknown palette ${JSON.stringify(presentation.palette)} — using ${paletteId}`);
-  }
-  const palette = pkg.PALETTES[paletteId];
-  const skin = Number.isInteger(presentation.skin) && presentation.skin >= 0 && presentation.skin < pkg.SKIN_TONES.length
-    ? presentation.skin
-    : 2;
-  const skinTone = pkg.SKIN_TONES[skin];
-  const hairColor = HEX.test(String(presentation.hairColor || '')) ? String(presentation.hairColor) : '#3b2a20';
-
-  function colorFor(role) {
-    switch (role) {
-      case 'skin': return skinTone;
-      case 'skinShade': return shade(skinTone, -0.18);
-      case 'hair': return hairColor;
-      case 'hairShade': return shade(hairColor, -0.25);
-      case 'cloth': return palette.cloth;
-      case 'clothShade': return palette.clothShade;
-      case 'accent': return palette.accent;
-      case 'metal': return palette.metal;
-      case 'bg': return palette.bg;
-      case 'ink': return palette.ink;
-      case 'sclera': return '#fdfbf7';
-      case 'highlight': return '#ffffff';
-      default: return palette.ink;
-    }
-  }
-
-  // ---- parts -------------------------------------------------------------
-  function part(table, kind, id, fallback) {
-    const got = table[id];
-    if (got) return got;
-    if (id !== undefined && id !== null && id !== '') {
-      missing.push(`${kind}:${id}`);
-      warnings.push(`unknown ${kind} ${JSON.stringify(id)} — using ${fallback}`);
-    }
-    return table[fallback];
-  }
-
-  const frameId = pkg.FRAMES[presentation.frame] ? presentation.frame : 'A';
-  const frame = pkg.FRAMES[frameId];
-  const hair = part(pkg.HAIR, 'hair', presentation.hair, 'bob-2');
-  const eyes = part(pkg.EYES, 'eyes', presentation.eyes, 'soft');
-
-  const outfitIds = [];
-  for (const item of Array.isArray(presentation.outfit) ? presentation.outfit : []) {
-    if (pkg.OUTFITS[item]) outfitIds.push(item);
-    else missing.push(`outfit:${item}`);
-  }
-  if (!outfitIds.length && Array.isArray(presentation.outfit) && presentation.outfit.length) {
-    warnings.push('no known outfit layer — wearing the plain tee');
-  }
-  const outfits = outfitIds.slice(0, 3).map((id) => pkg.OUTFITS[id]);
-
-  // ---- expression --------------------------------------------------------
-  const requested = typeof opts.expression === 'string' && opts.expression ? opts.expression : 'neutral';
-  let expression = pkg.EXPRESSIONS[requested];
-  let expressionId = requested;
-  if (!expression) {
-    const custom = customExpression(p, requested, warnings);
-    if (custom) {
-      expression = custom;
-    } else {
-      if (requested !== 'neutral') {
-        missing.push(`expression:${requested}`);
-        warnings.push(`unknown expression ${JSON.stringify(requested)} — using neutral`);
-      }
-      expression = pkg.EXPRESSIONS.neutral;
-      expressionId = 'neutral';
-    }
-  }
-
-  const eyeOverride = expression.eyes && pkg.EYE_OVERRIDES[expression.eyes] ? pkg.EYE_OVERRIDES[expression.eyes] : null;
-  const browShapes = Array.isArray(expression.brows)
-    ? asStrokes(expression.brows)
-    : asStrokes(expression.brows);
-  const mouthShapes = asStrokes(expression.mouth);
-
-  const sheet = {
-    shadow: [{ kind: 'ellipse', cx: 100, cy: 254, rx: 62, ry: 10, role: 'clothShade', opacity: 0.5 }],
-    hairBack: shapesOf(hair.back),
-    body: [
-      { kind: 'path', d: pkg.BODY.neck, role: 'skinShade' },
-      { kind: 'path', d: pkg.BODY.shirt, role: 'cloth' },
-      { kind: 'path', d: pkg.BODY.sleeveL, role: 'cloth' },
-      { kind: 'path', d: pkg.BODY.sleeveR, role: 'cloth' },
-    ],
-    outfitUnder: [],
-    head: [
-      { kind: 'path', d: frame.head, role: 'skin' },
-      ...frame.ear.map((e) => ({ kind: 'circle', cx: e.cx, cy: e.cy, r: e.r, role: 'skin' })),
-    ],
-    face: [
-      ...(eyeOverride
-        ? eyeOverride.map((s) => ({ ...s, stroke: true }))
-        : [...eyes.left, ...eyes.right]),
-      ...browShapes,
-      ...shapesOf(pkg.FACE.nose),
-      ...mouthShapes,
-    ],
-    hairFront: [...shapesOf(hair.front), ...shapesOf(hair.detail)],
-    outfitOver: [],
-    accessory: [],
-    effect: [],
-  };
-
-  // Outfit layers draw in the order the persona listed them: the last one is
-  // the outermost. Items flagged `accessory` (headphones, glasses) go on top of
-  // the hair instead of into the clothes pile.
-  const under = sheet.outfitUnder;
-  for (const item of outfits) {
-    under.push(...shapesOf(item.under).map((s) => ({ ...s, defaultRole: 'cloth' })));
-    const overShapes = shapesOf(item.over).map((s) => ({ ...s, defaultRole: 'cloth' }));
-    if (item.accessory) sheet.accessory.push(...overShapes);
-    else sheet.outfitOver.push(...overShapes);
-  }
-
-  // A celebrating face gets a few sparks — motion-gated in CSS, and the only
-  // thing on the `effect` layer.
-  if (expressionId === 'happy' || expressionId === 'playful' || expressionId === 'delighted') {
-    sheet.effect.push(
-      { kind: 'path', d: 'M28 66 l4 10 l10 4 l-10 4 l-4 10 l-4 -10 l-10 -4 l10 -4 Z', role: 'accent', opacity: 0.9 },
-      { kind: 'path', d: 'M172 88 l3 8 l8 3 l-8 3 l-3 8 l-3 -8 l-8 -3 l8 -3 Z', role: 'accent', opacity: 0.7 }
-    );
-  }
-
-  // ---- markup ------------------------------------------------------------
-  /** Per-layer default fill role, so a manifest entry rarely repeats itself. */
-  const layerDefaultRole = {
-    shadow: 'clothShade',
-    hairBack: 'hair',
-    body: 'cloth',
-    outfitUnder: 'cloth',
-    head: 'skin',
-    face: 'ink',
-    hairFront: 'hair',
-    outfitOver: 'cloth',
-    accessory: 'metal',
-    effect: 'accent',
-  };
-
-  function renderShape(shape, layer) {
-    const role = shape.role || shape.defaultRole || layerDefaultRole[layer] || 'ink';
-    const fill = colorFor(role);
-    const common = [];
-    if (shape.stroke) {
-      common.push('fill="none"', `stroke="${fill}"`, 'stroke-width="3.5"', 'stroke-linecap="round"', 'stroke-linejoin="round"');
-    } else {
-      common.push(`fill="${fill}"`);
-    }
-    if (typeof shape.opacity === 'number') common.push(`opacity="${shape.opacity}"`);
-
-    switch (shape.kind) {
-      case 'circle':
-        return `<circle cx="${shape.cx}" cy="${shape.cy}" r="${shape.r}" ${common.join(' ')}/>`;
-      case 'ellipse':
-        return `<ellipse cx="${shape.cx}" cy="${shape.cy}" rx="${shape.rx}" ry="${shape.ry}" ${common.join(' ')}/>`;
-      case 'rect': {
-        const rx = shape.rx === undefined ? 0 : shape.rx;
-        return `<rect x="${shape.x}" y="${shape.y}" width="${shape.width}" height="${shape.height}" rx="${rx}" ${common.join(' ')}/>`;
-      }
-      case 'path':
-      default:
-        return `<path d="${shape.d}" ${common.join(' ')}/>`;
-    }
-  }
-
-  const motion = opts.motion
-    ? String(opts.motion)
-    : pkg.motionFor(p, Boolean(opts.reducedMotion));
-  const size = ['small', 'medium', 'large'].includes(appearance.size) ? appearance.size : 'medium';
-
-  const layers = [];
-  const groups = [];
-  for (const name of pkg.LAYERS) {
-    const shapes = sheet[name] || [];
-    layers.push({ name, shapes: shapes.length });
-    if (!shapes.length) continue;
-    const body = shapes.map((s) => renderShape(s, name)).join('');
-    groups.push(`<g class="avatar-layer avatar-${name}" data-layer="${name}">${body}</g>`);
-  }
-
-  const svg =
-    `<svg class="avatar-svg" viewBox="0 0 200 268" xmlns="http://www.w3.org/2000/svg" ` +
-    `aria-hidden="true" focusable="false" role="presentation" ` +
-    `data-motion="${motion}" data-size="${size}" data-frame="${frameId}" ` +
-    `data-palette="${paletteId}" data-expression="${expressionId}">` +
-    `<rect class="avatar-bg" x="0" y="0" width="200" height="268" rx="24" fill="${colorFor('bg')}"/>` +
-    groups.join('') +
-    '</svg>';
-
-  return {
-    svg,
-    layers,
-    warnings,
-    missing,
-    expression: expressionId,
-    expressionLabel: expression.label || expressionId,
-    palette: paletteId,
-    frame: frameId,
-    hair: hair === pkg.HAIR[presentation.hair] ? presentation.hair : 'bob-2',
-    motion,
-    size,
-  };
-}
-
-const API = Object.freeze({ assemble, shade });
-
-if (typeof module !== 'undefined' && module.exports) module.exports = API;
-else if (typeof globalThis !== 'undefined') globalThis.AegisAvatarAssemble = API;
+"use strict";const pkg="undefined"!=typeof window&&window.AegisAvatarParts?window.AegisAvatarParts:"undefined"!=typeof module&&module.exports?require("./parts.js"):null;if(!pkg)throw new Error("avatar/assemble.js: avatar/parts.js must be loaded first");const HEX=/^#[0-9a-f]{6}$/i;function shade(e,t){const r=HEX.exec(String(e||""));if(!r)return e;const s=parseInt(r[0].slice(1),16),o=t<0?0:255,a=Math.min(1,Math.abs(t)),n=e=>Math.round(e*(1-a)+o*a);return`#${(n(s>>16&255)<<16|n(s>>8&255)<<8|n(255&s)).toString(16).padStart(6,"0")}`}function shapesOf(e){return Array.isArray(e)?e.filter((e=>e&&"object"==typeof e)):[]}function asStrokes(e){return"string"==typeof e&&e.trim()?[{kind:"path",d:e,stroke:!0}]:Array.isArray(e)?e.map((e=>"string"==typeof e?{kind:"path",d:e,stroke:!0}:e)).filter((e=>e&&"object"==typeof e)):[]}function call(e,...t){return"function"==typeof e?e(...t):void 0}function customExpression(e,t,r){const s=e&&e.expressions&&e.expressions.custom,o=s&&"object"==typeof s?s[t]:null;if(!o||"object"!=typeof o)return null;const a={label:t,custom:!0};return"string"==typeof o.mouth&&o.mouth.trim()&&(a.mouth=o.mouth.trim()),void 0!==o.brows&&(a.brows=asStrokes(o.brows).map((e=>e.d))),void 0!==o.eyes&&("string"==typeof o.eyes&&pkg.EYE_OVERRIDES[o.eyes]?a.eyes=o.eyes:r.push(`custom expression ${t}: unknown eye override ${JSON.stringify(o.eyes)} — ignored`)),void 0===a.mouth&&void 0===a.brows&&void 0===a.eyes?(r.push(`custom expression ${t} carries no drawable geometry — ignored`),null):a}function assemble(e,t={}){const r=[],s=[],o=e&&"object"==typeof e?e:pkg.defaultPersona(),a=o.presentation&&"object"==typeof o.presentation?o.presentation:{},n=o.appearance&&"object"==typeof o.appearance?o.appearance:{},i=pkg.PALETTES[a.palette]?a.palette:"amber";void 0!==a.palette&&i!==a.palette&&r.push(`unknown palette ${JSON.stringify(a.palette)} — using ${i}`);const l=pkg.PALETTES[i],c=Number.isInteger(a.skin)&&a.skin>=0&&a.skin<pkg.SKIN_TONES.length?a.skin:2,p=pkg.SKIN_TONES[c],u=HEX.test(String(a.hairColor||""))?String(a.hairColor):"#3b2a20";function h(e){switch(e){case"skin":return p;case"skinShade":return shade(p,-.18);case"hair":return u;case"hairShade":return shade(u,-.25);case"cloth":return l.cloth;case"clothShade":return l.clothShade;case"accent":return l.accent;case"metal":return l.metal;case"bg":return l.bg;case"ink":default:return l.ink;case"sclera":return"#fdfbf7";case"highlight":return"#ffffff"}}function d(e,t,o,a){return e[o]||(null!=o&&""!==o&&(s.push(`${t}:${o}`),r.push(`unknown ${t} ${JSON.stringify(o)} — using ${a}`)),e[a])}const f=pkg.FRAMES[a.frame]?a.frame:"A",g=pkg.FRAMES[f],y=d(pkg.HAIR,"hair",a.hair,"bob-2"),k=d(pkg.EYES,"eyes",a.eyes,"soft"),m=[];for(const e of Array.isArray(a.outfit)?a.outfit:[])pkg.OUTFITS[e]?m.push(e):s.push(`outfit:${e}`);!m.length&&Array.isArray(a.outfit)&&a.outfit.length&&r.push("no known outfit layer — wearing the plain tee");const b=m.slice(0,3).map((e=>pkg.OUTFITS[e])),$="string"==typeof t.expression&&t.expression?t.expression:"neutral";let S=pkg.EXPRESSIONS[$],x=$;if(!S){const e=customExpression(o,$,r);e?S=e:("neutral"!==$&&(s.push(`expression:${$}`),r.push(`unknown expression ${JSON.stringify($)} — using neutral`)),S=pkg.EXPRESSIONS.neutral,x="neutral")}const w=S.eyes&&pkg.EYE_OVERRIDES[S.eyes]?pkg.EYE_OVERRIDES[S.eyes]:null,E=(Array.isArray(S.brows),asStrokes(S.brows)),v=asStrokes(S.mouth),A={shadow:[{kind:"ellipse",cx:100,cy:254,rx:62,ry:10,role:"clothShade",opacity:.5}],hairBack:shapesOf(y.back),body:[{kind:"path",d:pkg.BODY.neck,role:"skinShade"},{kind:"path",d:pkg.BODY.shirt,role:"cloth"},{kind:"path",d:pkg.BODY.sleeveL,role:"cloth"},{kind:"path",d:pkg.BODY.sleeveR,role:"cloth"}],outfitUnder:[],head:[{kind:"path",d:g.head,role:"skin"},...g.ear.map((e=>({kind:"circle",cx:e.cx,cy:e.cy,r:e.r,role:"skin"})))],face:[...w?w.map((e=>({...e,stroke:!0}))):[...k.left,...k.right],...E,...shapesOf(pkg.FACE.nose),...v],hairFront:[...shapesOf(y.front),...shapesOf(y.detail)],outfitOver:[],accessory:[],effect:[]},O=A.outfitUnder;for(const e of b){O.push(...shapesOf(e.under).map((e=>({...e,defaultRole:"cloth"}))));const t=shapesOf(e.over).map((e=>({...e,defaultRole:"cloth"})));e.accessory?A.accessory.push(...t):A.outfitOver.push(...t)}"happy"!==x&&"playful"!==x&&"delighted"!==x||A.effect.push({kind:"path",d:"M28 66 l4 10 l10 4 l-10 4 l-4 10 l-4 -10 l-10 -4 l10 -4 Z",role:"accent",opacity:.9},{kind:"path",d:"M172 88 l3 8 l8 3 l-8 3 l-3 8 l-3 -8 l-8 -3 l8 -3 Z",role:"accent",opacity:.7});const j={shadow:"clothShade",hairBack:"hair",body:"cloth",outfitUnder:"cloth",head:"skin",face:"ink",hairFront:"hair",outfitOver:"cloth",accessory:"metal",effect:"accent"};function R(e,t){const r=h(e.role||e.defaultRole||j[t]||"ink"),s=[];switch(e.stroke?s.push('fill="none"',`stroke="${r}"`,'stroke-width="3.5"','stroke-linecap="round"','stroke-linejoin="round"'):s.push(`fill="${r}"`),"number"==typeof e.opacity&&s.push(`opacity="${e.opacity}"`),e.kind){case"circle":return`<circle cx="${e.cx}" cy="${e.cy}" r="${e.r}" ${s.join(" ")}/>`;case"ellipse":return`<ellipse cx="${e.cx}" cy="${e.cy}" rx="${e.rx}" ry="${e.ry}" ${s.join(" ")}/>`;case"rect":{const t=void 0===e.rx?0:e.rx;return`<rect x="${e.x}" y="${e.y}" width="${e.width}" height="${e.height}" rx="${t}" ${s.join(" ")}/>`}default:return`<path d="${e.d}" ${s.join(" ")}/>`}}const I=t.motion?String(t.motion):pkg.motionFor(o,Boolean(t.reducedMotion)),T=["small","medium","large"].includes(n.size)?n.size:"medium",N=[],P=[];for(const e of pkg.LAYERS){const t=A[e]||[];if(N.push({name:e,shapes:t.length}),!t.length)continue;const r=t.map((t=>R(t,e))).join("");P.push(`<g class="avatar-layer avatar-${e}" data-layer="${e}">${r}</g>`)}return{svg:`<svg class="avatar-svg" viewBox="0 0 200 268" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" role="presentation" data-motion="${I}" data-size="${T}" data-frame="${f}" data-palette="${i}" data-expression="${x}"><rect class="avatar-bg" x="0" y="0" width="200" height="268" rx="24" fill="${h("bg")}"/>`+P.join("")+"</svg>",layers:N,warnings:r,missing:s,expression:x,expressionLabel:S.label||x,palette:i,frame:f,hair:y===pkg.HAIR[a.hair]?a.hair:"bob-2",motion:I,size:T}}const API=Object.freeze({assemble:assemble,shade:shade});"undefined"!=typeof module&&module.exports?module.exports=API:"undefined"!=typeof globalThis&&(globalThis.AegisAvatarAssemble=API);