From 446540ffa8611dd87422c7d34acbd114121ca44a Mon Sep 17 00:00:00 2001 From: Marcus Vorwaller Date: Mon, 9 Nov 2026 20:20:08 -0800 Subject: [PATCH 1/4] Render native stickers with bounded transparent media previews Preserve sticker associations and activity timestamps, render known placements and use a compact parent strip for unknown placements and sticker reactions. Validate bounded raster decodes, retain alpha and animate supported previews without changing the surrounding theme. Add synthetic metadata, codec, Qt rendering and demo coverage. --- .github/workflows/ci.yml | 5 + BlipView.qml | 114 +++++++++++++- StickerImage.qml | 95 ++++++++++++ StickerLayer.qml | 41 +++++ Stickers.mjs | 133 ++++++++++++++++ bridge/mac/imsg | 260 +++++++++++++++++++++++++++---- bridge/mac/test_stickers.py | 261 +++++++++++++++++++++++++++++++ collector.ts | 30 +++- docs/STICKERS.md | 165 ++++++++++++++++++++ docs/img/stickers.png | Bin 0 -> 104697 bytes fetch.ts | 287 +++++++++++++++++++++++++++++++--- save-attachment.ts | 4 +- scripts/blip-setup | 7 + scripts/demo/fake-imsg | 18 ++- scripts/demo/fixtures.json | 74 ++++++++- scripts/test-sticker-ui.py | 163 +++++++++++++++++++ stickers.test.ts | 301 ++++++++++++++++++++++++++++++++++++ stickers.ts | 169 ++++++++++++++++++++ thread.ts | 12 +- ui.test.ts | 2 +- 20 files changed, 2067 insertions(+), 74 deletions(-) create mode 100644 StickerImage.qml create mode 100644 StickerLayer.qml create mode 100644 Stickers.mjs create mode 100644 bridge/mac/test_stickers.py create mode 100644 docs/STICKERS.md create mode 100644 docs/img/stickers.png create mode 100644 scripts/test-sticker-ui.py create mode 100644 stickers.test.ts create mode 100644 stickers.ts diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 9742edea..8159b4a4 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -28,6 +28,11 @@ jobs: python3 test_otp_desktop.py - name: Mac tools compile (python3 syntax, no macOS needed) run: python3 -m py_compile bridge/linux/blip-bridged bridge/mac/imsg bridge/mac/imsg-send bridge/mac/contacts bridge/mac/tcc-check bridge/mac/blip-check bridge/mac/blip-dispatch bridge/mac/imsg-read bridge/mac/imsg-react bridge/mac/calling_codes.py bridge/mac/contact-save bridge/mac/read_state.py bridge/mac/findmy_city.py + - name: Sticker metadata and bounded animated rendering + run: | + sudo apt-get install -y -q ffmpeg imagemagick qt6-image-formats-plugins + python3 bridge/mac/test_stickers.py + python3 scripts/test-sticker-ui.py - name: shared city (synthetic AX and Contacts, no macOS needed) run: python3 bridge/mac/test_findmy_city.py - name: read pushes require verified completion (no macOS needed) diff --git a/BlipView.qml b/BlipView.qml index 1d62cf8f..2b593da6 100644 --- a/BlipView.qml +++ b/BlipView.qml @@ -1,3 +1,4 @@ +import "Stickers.mjs" as Stickers import "SendState.mjs" as SendState import "MessageActions.mjs" as MessageActions import "SourceId.mjs" as SourceId @@ -1143,11 +1144,12 @@ FocusScope { } } fetchQueue.push({ id: id, name: String(att.name || "file"), - mime: String(att.mime || ""), action: action || "", + mime: String(att.mime || ""), sticker: !!att.sticker, action: action || "", auto: auto === true }) pumpFetch() } + property bool fetchJobSticker: false property string fetchJobAction: "" property string fetchJobMime: "" property string fetchJobName: "" @@ -1158,8 +1160,9 @@ FocusScope { fetchJobAction = job.action fetchJobMime = job.mime fetchJobName = job.name + fetchJobSticker = job.sticker === true // Auto-pulls carry a hard transfer cap: claimed metadata is not the limit. - fetchProc.command = ["bun", root.fetchScript, job.id, job.name, job.mime, job.auto ? "5242880" : ""] + fetchProc.command = ["bun", root.fetchScript, job.id, job.name, job.mime, job.auto ? "5242880" : ""].concat(job.sticker ? ["--sticker"] : []) fetchProc.running = true } @@ -1171,7 +1174,7 @@ FocusScope { function autoFetchImages() { if (!inThread) return for (var i = 0; i < bubbles.length; i++) { - var atts = bubbles[i].attachments || [] + var atts = (bubbles[i].attachments || []).concat((bubbles[i].stickers || []).map(function(sticker) { return sticker.attachment })) for (var j = 0; j < atts.length; j++) { // Bytes must be KNOWN — null/0 must not slip through and auto-pull // something the click-path 100 MB ceiling would allow. The SOURCE cap @@ -1180,7 +1183,7 @@ FocusScope { // while sips turns a 5.07 MB HEIC into a 7.80 MB JPEG, so full-size // iPhone photos were rejected at both ends and simply never appeared. var b = atts[j].bytes - if (isImageMime(atts[j].mime) && typeof b === "number" && b > 0 && b <= root.autoFetchMaxSource) + if ((isImageMime(atts[j].mime) || (atts[j].sticker && String(atts[j].mime || "").indexOf("video/") === 0)) && typeof b === "number" && b > 0 && b <= root.autoFetchMaxSource) enqueueFetch(atts[j], "", true) } // link-card preview PNGs are small; the auto-fetch transfer cap bounds them @@ -1192,6 +1195,15 @@ FocusScope { /** Chip/image click: fetch-then-open. ALWAYS round-trips fetch.ts, even * when attFiles already has a url — the LRU may have evicted the file * since (Codex finding #5); a cache hit is instant anyway. */ + function stickerLoading(id) { + return id !== "" && (root.fetchingId === id || root.fetchQueue.some(function(job) { return job.id === id })) + } + function activateSticker(att) { + var id = String(att.id || "") + if (!id) return + if (!root.attFiles[id]) root.enqueueFetch(att, "preview", true) + else root.openAttachment(att) + } function openAttachment(att) { var id = String(att.id || "") if (id === "") return @@ -1983,7 +1995,7 @@ FocusScope { if (!isFinite(pixelHeight) || pixelHeight < 1 || pixelHeight > 100000) pixelHeight = 0 if (!keepInline) { var metrics = Object.assign({}, root.attMetrics) - metrics[id] = { pixelRatio: ratio, pixelWidth: pixelWidth, pixelHeight: pixelHeight } + metrics[id] = { pixelRatio: ratio, pixelWidth: pixelWidth, pixelHeight: pixelHeight, animated: d.animated === true, renderMime: String(d.renderMime || ""), animationUnavailable: d.animationUnavailable === true } root.attMetrics = metrics } if (d.ok === true && root.fetchJobAction === "copy") { @@ -3551,7 +3563,8 @@ FocusScope { readonly property var fileUrl: root.attFiles[chipRow.attId] readonly property bool failed: chipRow.fileUrl === "" readonly property var imageMetrics: root.attMetrics[chipRow.attId] || ({}) - readonly property bool showImage: + readonly property bool isSticker: !!modelData.sticker + readonly property bool showImage: !isSticker && root.isImageMime(chipRow.modelData.mime) && chipRow.fileUrl !== undefined && chipRow.fileUrl !== "" Layout.fillWidth: true @@ -3571,6 +3584,18 @@ FocusScope { // every right-aligned element off-screen with it. Item { id: attImage + StickerLayer { + anchors.fill: parent + z: 3 + visible: chipRow.index === 0 && !textBubbleRow.visible + stickers: visible ? Stickers.placedStickers(bubbleRow.modelData.stickers) : [] + files: root.attFiles; metrics: root.attMetrics + fetchingId: root.fetchingId; fetchQueue: root.fetchQueue + textColor: root.dim + playing: root.surfaceOpen && bubbleRow.y + chipRow.y + height >= flick.contentY && bubbleRow.y + chipRow.y <= flick.contentY + flick.height + onOpenRequested: function(att) { root.activateSticker(att) } + onContextRequested: function(att) { root.openAttachmentMenu(bubbleRow.modelData, att) } + } TapbackPill { visible: chipRow.pillHere; mine: bubbleRow.mine; tapbacks: bubbleRow.modelData.tapbacks } visible: chipRow.showImage readonly property bool animated: root.isAnimatedMime(chipRow.modelData.mime) @@ -3652,9 +3677,38 @@ FocusScope { } } + StickerImage { + visible: chipRow.isSticker + Layout.preferredWidth: Math.min(Style.space(160), content.width * 0.50) + Layout.preferredHeight: Layout.preferredWidth + attachment: chipRow.modelData + source: chipRow.isSticker ? (chipRow.fileUrl || "") : "" + loading: root.stickerLoading(chipRow.attId) + failed: chipRow.attId === "" || chipRow.failed + animated: chipRow.imageMetrics.animated === true + animationUnavailable: chipRow.imageMetrics.animationUnavailable === true + playing: root.surfaceOpen && chipRow.y + bubbleRow.y + height >= flick.contentY && chipRow.y + bubbleRow.y <= flick.contentY + flick.height + textColor: root.dim + fontSize: root.fontCaption + onTapped: root.activateSticker(chipRow.modelData) + onContextRequested: root.openAttachmentMenu(bubbleRow.modelData, chipRow.modelData) + StickerLayer { + anchors.fill: parent + z: 3 + visible: chipRow.index === 0 && !textBubbleRow.visible + stickers: visible ? Stickers.placedStickers(bubbleRow.modelData.stickers) : [] + files: root.attFiles; metrics: root.attMetrics + fetchingId: root.fetchingId; fetchQueue: root.fetchQueue + textColor: root.dim + playing: root.surfaceOpen && bubbleRow.y + chipRow.y + height >= flick.contentY && bubbleRow.y + chipRow.y <= flick.contentY + flick.height + onOpenRequested: function(att) { root.activateSticker(att) } + onContextRequested: function(att) { root.openAttachmentMenu(bubbleRow.modelData, att) } + } + TapbackPill { visible: chipRow.pillHere; mine: bubbleRow.mine; tapbacks: bubbleRow.shownTapbacks } + } Rectangle { TapbackPill { visible: chipRow.pillHere; mine: bubbleRow.mine; tapbacks: bubbleRow.modelData.tapbacks } - visible: !chipRow.showImage + visible: !chipRow.showImage && !chipRow.isSticker Layout.preferredWidth: Math.ceil(chipText.implicitWidth) + Style.space(18) Layout.preferredHeight: Math.ceil(chipText.implicitHeight) + Style.space(12) radius: Style.space(14) @@ -3800,6 +3854,7 @@ FocusScope { // the sender's far side guarantees right/left placement even // when the delegate's own width collapses to its content. RowLayout { + id: textBubbleRow Layout.fillWidth: true // a tapback pill overlaps the top edge — leave room for it Layout.topMargin: (modelData.groupStart ? Style.space(6) : 0) @@ -3894,6 +3949,17 @@ FocusScope { } } + StickerLayer { + anchors.fill: parent + z: 3 + stickers: Stickers.placedStickers(bubbleRow.modelData.stickers) + files: root.attFiles; metrics: root.attMetrics + fetchingId: root.fetchingId; fetchQueue: root.fetchQueue + textColor: root.dim + playing: root.surfaceOpen && bubbleRow.y + height >= flick.contentY && bubbleRow.y <= flick.contentY + flick.height + onOpenRequested: function(att) { root.activateSticker(att) } + onContextRequested: function(att) { root.openAttachmentMenu(bubbleRow.modelData, att) } + } TapbackPill { mine: bubbleRow.mine; tapbacks: bubbleRow.shownTapbacks } } @@ -3934,6 +4000,40 @@ FocusScope { Item { Layout.fillWidth: true; visible: !bubbleRow.mine } } + RowLayout { + Layout.fillWidth: true + visible: unplacedStickerFlow.stickers.length > 0 + Item { Layout.fillWidth: true; visible: bubbleRow.mine } + Flow { + id: unplacedStickerFlow + readonly property bool imageSurface: (bubbleRow.modelData.attachments || []).length > 0 && (root.isImageMime(bubbleRow.modelData.attachments[0].mime) || !!bubbleRow.modelData.attachments[0].sticker) && !!root.attFiles[String(bubbleRow.modelData.attachments[0].id)] + readonly property var stickers: textBubbleRow.visible || imageSurface ? (bubbleRow.modelData.stickers || []).filter(function(sticker) { return sticker.reaction === true || !sticker.placement || sticker.part !== 0 }) : (bubbleRow.modelData.stickers || []) + Layout.preferredWidth: Math.min(content.width * 0.78, stickers.length * Style.space(58)) + Layout.preferredHeight: childrenRect.height + spacing: Style.space(6) + Repeater { + model: unplacedStickerFlow.stickers + delegate: StickerImage { + required property var modelData + readonly property string attachmentId: String(modelData.attachment.id || "") + width: Style.space(52); height: width + attachment: modelData.attachment + source: root.attFiles[attachmentId] || "" + loading: root.stickerLoading(attachmentId) + failed: attachmentId === "" || root.attFiles[attachmentId] === "" + animated: (root.attMetrics[attachmentId] || {}).animated === true + animationUnavailable: (root.attMetrics[attachmentId] || {}).animationUnavailable === true + playing: root.surfaceOpen && bubbleRow.y + height >= flick.contentY && bubbleRow.y <= flick.contentY + flick.height + compact: true + textColor: root.dim + Accessible.description: (animationUnavailable ? "Static preview; animation unavailable. " : "") + "Sticker attached to message part " + String(modelData.part + 1) + onTapped: root.activateSticker(modelData.attachment) + onContextRequested: root.openAttachmentMenu(bubbleRow.modelData, modelData.attachment) + } + } + } + Item { Layout.fillWidth: true; visible: !bubbleRow.mine } + } // Delivered becomes Read under the newest sent message. RowLayout { Layout.fillWidth: true diff --git a/StickerImage.qml b/StickerImage.qml new file mode 100644 index 00000000..cd2b87dc --- /dev/null +++ b/StickerImage.qml @@ -0,0 +1,95 @@ +import QtQuick + +// Presentation only. Attribution, animation detection, and geometry come +// from TypeScript; the parent owns fetching and conversation positioning. +Item { + id: root + property var attachment: ({}) + property url source: "" + property bool loading: false + property bool failed: false + property bool animated: false + property bool animationUnavailable: false + property bool playing: true + property bool compact: false + property bool iconOnly: false + property color textColor: "#8e8e93" + property int fontSize: 12 + readonly property bool ready: animated ? motion.status === Image.Ready : still.status === Image.Ready + readonly property bool decodeFailed: animated ? motion.status === Image.Error : still.status === Image.Error + readonly property real paintedWidth: animated ? motion.paintedWidth : still.paintedWidth + readonly property real paintedHeight: animated ? motion.paintedHeight : still.paintedHeight + readonly property int currentFrame: motion.currentFrame + readonly property int frameCount: motion.frameCount + signal tapped() + signal contextRequested() + + implicitWidth: compact ? 48 : 160 + implicitHeight: compact ? 48 : 160 + activeFocusOnTab: true + Accessible.role: Accessible.Button + Accessible.name: String(attachment.sticker && attachment.sticker.label || "Sticker") + Accessible.description: failed || decodeFailed ? "Unavailable. Activate to retry." + : animationUnavailable ? "Static preview; animation unavailable. Open sticker." : "Open sticker" + Accessible.onPressAction: tapped() + + Image { + id: still + anchors.fill: parent + source: !root.animated ? root.source : "" + visible: !root.animated + asynchronous: true + autoTransform: true + fillMode: Image.PreserveAspectFit + sourceSize.width: 640 + sourceSize.height: 640 + smooth: true + mipmap: true + } + AnimatedImage { + id: motion + anchors.fill: parent + source: root.animated ? root.source : "" + visible: root.animated + playing: root.playing && root.visible && root.animated + asynchronous: true + autoTransform: true + fillMode: Image.PreserveAspectFit + // AnimatedImage.sourceSize was read-only in Qt 6.4. A static assignment + // prevents the whole component from loading there. Newer Qt can bound + // decoder output; older Qt still receives validated <=2048px rasters. + Component.onCompleted: { + try { motion.sourceSize = Qt.size(640, 640) } catch (error) { } + } + cache: false + smooth: true + } + Text { + anchors.centerIn: parent + width: parent.width + visible: !root.ready + text: root.iconOnly ? (root.loading ? "…" : root.failed || root.decodeFailed ? "!" : "◇") + : root.loading ? "Loading…" : root.failed || root.decodeFailed ? "Sticker unavailable" : "Sticker" + textFormat: Text.PlainText + horizontalAlignment: Text.AlignHCenter + wrapMode: Text.Wrap + color: root.textColor + font.pixelSize: root.fontSize + } + Rectangle { + anchors.fill: parent + visible: root.activeFocus + color: "transparent" + border.color: root.textColor + border.width: 1 + radius: 6 + } + TapHandler { onTapped: root.tapped() } + TapHandler { + acceptedButtons: Qt.RightButton + onTapped: root.contextRequested() + } + Keys.onReturnPressed: tapped() + Keys.onEnterPressed: tapped() + Keys.onMenuPressed: contextRequested() +} diff --git a/StickerLayer.qml b/StickerLayer.qml new file mode 100644 index 00000000..813fbb16 --- /dev/null +++ b/StickerLayer.qml @@ -0,0 +1,41 @@ +import QtQuick +import "Stickers.mjs" as Stickers + +// Position only when the bridge supplied a body-part mapping we understand. +// Unknown placements stay in a separate attachment strip in BlipView. +Item { + id: root + property var stickers: [] + property var files: ({}) + property var metrics: ({}) + property bool playing: true + property string fetchingId: "" + property var fetchQueue: [] + property color textColor: "#8e8e93" + signal openRequested(var attachment) + signal contextRequested(var attachment) + Repeater { + model: root.stickers + delegate: StickerImage { + required property var modelData + readonly property string attachmentId: String(modelData.attachment.id || "") + readonly property var metric: root.metrics[attachmentId] || ({}) + readonly property var geometry: Stickers.stickerGeometry(modelData.placement, root.width, root.height, Number(metric.pixelWidth || 64), Number(metric.pixelHeight || 64)) + x: geometry.x; y: geometry.y + width: geometry.width; height: geometry.height + rotation: geometry.rotation + z: 2 + attachment: modelData.attachment + source: root.files[attachmentId] || "" + loading: attachmentId !== "" && (root.fetchingId === attachmentId || root.fetchQueue.some(function(job) { return job.id === attachmentId })) + failed: attachmentId === "" || root.files[attachmentId] === "" + animated: metric.animated === true + animationUnavailable: metric.animationUnavailable === true + playing: root.playing + compact: true + textColor: root.textColor + onTapped: root.openRequested(modelData.attachment) + onContextRequested: root.contextRequested(modelData.attachment) + } + } +} diff --git a/Stickers.mjs b/Stickers.mjs new file mode 100644 index 00000000..178d5bfc --- /dev/null +++ b/Stickers.mjs @@ -0,0 +1,133 @@ +// stickers.ts +var MAX_VISIBLE_STICKERS = 24; +var sources = new Set(["memoji", "genmoji", "user", "app", "unknown"]); +var record = (value) => !!value && typeof value === "object" && !Array.isArray(value); +var finite = (value, min, max) => typeof value === "number" && Number.isFinite(value) && value >= min && value <= max; +var label = (value, max = 160) => typeof value === "string" ? value.replace(/[\p{Cc}\p{Cf}]/gu, "").trim().slice(0, max) : ""; +function normalizeStickerPlacement(value) { + if (!record(value) || !finite(value.x, -3, 3) || !finite(value.y, -3, 3) || !finite(value.scale, 0.1, 4) || !finite(value.rotation, -Math.PI * 2, Math.PI * 2)) + return; + return Object.assign({ x: value.x, y: value.y, scale: value.scale, rotation: value.rotation }, finite(value.parentWidth, 1, 1e4) ? { parentWidth: value.parentWidth } : {}); +} +function normalizeStickerMetadata(value) { + if (!record(value)) + return; + const placement = normalizeStickerPlacement(value.placement); + const app = label(value.app_name, 80); + return Object.assign({ + source: typeof value.source === "string" && sources.has(value.source) ? value.source : "unknown", + label: label(value.label) || "Sticker", + animated: value.animated === true + }, app ? { app_name: app } : {}, placement ? { placement } : {}); +} +function normalizeStickerAttachment(attachment) { + const sticker = normalizeStickerMetadata(attachment.sticker); + if (sticker) + return Object.assign({}, attachment, { sticker }); + const plain = Object.assign({}, attachment); + delete plain.sticker; + return plain; +} +function normalizeStickerOverlays(value) { + if (!Array.isArray(value)) + return { stickers: [], overflow: 0 }; + const valid = []; + const identities = new Set; + let total = 0; + for (const raw of value) { + if (!record(raw) || !record(raw.attachment)) + continue; + const a = raw.attachment; + const sticker = normalizeStickerMetadata(a.sticker); + if (!sticker) + continue; + const id = typeof a.id === "string" && /^[0-9]{1,18}$/.test(a.id) ? a.id : ""; + const guid = label(raw.guid, 128); + const key = `${guid}\x00${id}`; + if ((guid || id) && identities.has(key)) + continue; + if (guid || id) + identities.add(key); + total++; + if (valid.length >= MAX_VISIBLE_STICKERS) + continue; + const placement = normalizeStickerPlacement(raw.placement) ?? sticker.placement; + valid.push(Object.assign({ + attachment: { + id, + name: label(a.name, 256) || "Sticker", + mime: typeof a.mime === "string" ? a.mime.slice(0, 100) : null, + bytes: finite(a.bytes, 0, Number.MAX_SAFE_INTEGER) ? a.bytes : null, + sticker + }, + guid, + part: finite(raw.part, 0, 999999) && Number.isInteger(raw.part) ? raw.part : 0, + from_me: raw.from_me === true, + by: label(raw.by, 160) || null, + ts: typeof raw.ts === "string" ? raw.ts : "" + }, raw.reaction === true ? { reaction: true } : {}, placement ? { placement } : {})); + } + return { stickers: valid, overflow: Math.max(0, total - valid.length) }; +} +function mergeStickers(a, b) { + const all = [...a ?? [], ...b ?? []]; + if (!all.length) + return; + const seen = new Set; + return all.filter((s) => { + const key = `${s.guid}\x00${s.attachment?.id ?? ""}`; + if (seen.has(key)) + return false; + seen.add(key); + return true; + }); +} +function placedStickers(stickers) { + return (stickers ?? []).filter((s) => s.reaction !== true && s.part === 0 && !!normalizeStickerPlacement(s.placement)); +} +function unplacedStickers(stickers) { + return (stickers ?? []).filter((s) => s.reaction !== true && (s.part !== 0 || !normalizeStickerPlacement(s.placement))); +} +function reactionStickers(stickers) { + return (stickers ?? []).filter((s) => s.reaction === true); +} +function stickerGeometry(placement, width, height, naturalWidth = 64, naturalHeight = 64) { + const w = finite(width, 1, 1e4) ? width : 64; + const h = finite(height, 1, 1e4) ? height : 64; + const nw = finite(naturalWidth, 1, 1e5) ? naturalWidth : 64; + const nh = finite(naturalHeight, 1, 1e5) ? naturalHeight : 64; + const p = normalizeStickerPlacement(placement); + const scale = p?.scale ?? 1; + const longEdge = Math.min(Math.max(40 * scale, 24), 120, w); + let sw = nw >= nh ? longEdge : longEdge * nw / nh; + let sh = nh >= nw ? longEdge : longEdge * nh / nw; + const angle = p?.rotation ?? 0; + const cos = Math.abs(Math.cos(angle)), sin = Math.abs(Math.sin(angle)); + let bw = sw * cos + sh * sin, bh = sh * cos + sw * sin; + const fit = Math.min(1, w / bw, h / bh); + sw *= fit; + sh *= fit; + bw *= fit; + bh *= fit; + const insetX = (bw - sw) / 2, insetY = (bh - sh) / 2; + return { + x: p ? Math.max(insetX, Math.min(w - sw - insetX, p.x * w - sw / 2)) : 0, + y: p ? Math.max(insetY, Math.min(h - sh - insetY, p.y * h - sh / 2)) : 0, + width: sw, + height: sh, + rotation: p ? p.rotation * 180 / Math.PI : 0, + placed: !!p + }; +} +export { + MAX_VISIBLE_STICKERS, + mergeStickers, + normalizeStickerAttachment, + normalizeStickerMetadata, + normalizeStickerOverlays, + normalizeStickerPlacement, + placedStickers, + reactionStickers, + stickerGeometry, + unplacedStickers +}; diff --git a/bridge/mac/imsg b/bridge/mac/imsg index 139564a5..22037810 100755 --- a/bridge/mac/imsg +++ b/bridge/mac/imsg @@ -28,6 +28,7 @@ import hashlib import html import io import json +import math import os import plistlib import re @@ -37,6 +38,7 @@ import subprocess import sys import unicodedata from glob import glob +from xml.parsers.expat import ExpatError sys.path.insert(0, os.path.dirname(os.path.realpath(__file__))) from read_state import read_state @@ -68,7 +70,13 @@ ATTACHMENT_MIME_SQL = """COALESCE(NULLIF(a.mime_type, ''), CASE a.uti WHEN 'org.3gpp.adaptive-multi-rate-audio' THEN 'audio/amr' WHEN 'public.jpeg' THEN 'image/jpeg' WHEN 'public.png' THEN 'image/png' + WHEN 'public.webp' THEN 'image/webp' + WHEN 'org.webmproject.webp' THEN 'image/webp' + WHEN 'com.compuserve.gif' THEN 'image/gif' WHEN 'public.heic' THEN 'image/heic' + WHEN 'public.heif' THEN 'image/heif' + WHEN 'public.heics' THEN 'image/heic-sequence' + WHEN 'public.heifs' THEN 'image/heif-sequence' WHEN 'com.apple.quicktime-movie' THEN 'video/quicktime' WHEN 'public.mpeg-4' THEN 'video/mp4' END)""" @@ -899,7 +907,7 @@ def pin_order_for(pins: list[set[str]], *candidates: str | None) -> int | None: return None -# ---------- --rich enrichment (tapbacks, read receipts, replies, attachments) ---------- +# ---------- --rich enrichment (tapbacks, stickers, read receipts, replies, attachments) ---------- # Tapback rows are their own messages pointing at a target via # associated_message_guid ("p:0/" / "bp:"). 2xxx adds, 3xxx removes; @@ -928,6 +936,105 @@ def _strip_assoc(guid: str | None) -> str: return guid +def _assoc_part(guid: str | None) -> int: + """The body-part index in p:N/GUID; a balloon/bare GUID targets part 0.""" + match = re.match(r"^p:(\d{1,6})/", guid or "") + return int(match.group(1)) if match else 0 + + +def _row_value(row, key, default=None): + # Older schemas and callers' projected rows need not have new columns. + try: + return row[key] + except (KeyError, IndexError): + return default + + +def _small_plist_dict(blob) -> dict: + """Sticker metadata is untrusted, optional, and never an executable archive.""" + if not isinstance(blob, (bytes, bytearray, memoryview)) or len(blob) > 65536: + return {} + try: + value = plistlib.loads(bytes(blob)) + return value if isinstance(value, dict) else {} + except (plistlib.InvalidFileException, ExpatError, ValueError, TypeError, OverflowError, RecursionError): + return {} + + +def _sticker_number(value, low, high): + # Apple's geometry values are usually decimal strings. Never accept a + # boolean, NaN, infinity, or an enormous value as a layout coordinate. + if isinstance(value, bool) or not isinstance(value, (str, int, float)): + return None + try: + number = float(value) + except (ValueError, OverflowError): + return None + return number if math.isfinite(number) and low <= number <= high else None + + +def _sticker_label(value, limit=160) -> str: + if not isinstance(value, str): + return "" + return "".join(c for c in value if not unicodedata.category(c).startswith("C"))[:limit].strip() + + +def sticker_metadata(row, force=False) -> dict | None: + """Recognize by Messages' flag or association, never by size/name/MIME. + + sticker_user_info uses sxs/sys (normalized center), ssa (scale), sro + (clockwise radians), spw (parent preview width), and pid (source bundle). + See docs/STICKERS.md for the independently inspected format sources. + Unknown/malformed geometry falls back to a separate attached-sticker row. + No raw plist, path, or arbitrary metadata is forwarded. + """ + if not (force or _row_value(row, "is_sticker") == 1): + return None + info = _small_plist_dict(_row_value(row, "sticker_user_info")) + attribution = _small_plist_dict(_row_value(row, "attribution_info")) + bundle = info.get("pid", "") + bundle = bundle.rsplit(":", 1)[-1] if isinstance(bundle, str) else "" + source = { + "com.apple.messages.genmoji": "genmoji", + "com.apple.Animoji.StickersApp.MessagesExtension": "memoji", + "com.apple.Jellyfish.Animoji": "memoji", + "com.apple.Stickers.UserGenerated.MessagesExtension": "user", + }.get(bundle, "app" if bundle else "unknown") + label = _sticker_label(_row_value(row, "emoji_description")) or _sticker_label(attribution.get("accessl")) + out = {"source": source, "label": label or ("Memoji" if source == "memoji" else "Sticker")} + name = _sticker_label(attribution.get("name"), 80) + if name: + out["app_name"] = name + placement = {key: _sticker_number(info.get(raw), low, high) for key, raw, low, high in ( + ("x", "sxs", -3, 3), ("y", "sys", -3, 3), + ("scale", "ssa", 0.1, 4), ("rotation", "sro", -math.pi * 2, math.pi * 2), + )} + if all(value is not None for value in placement.values()): + parent_width = _sticker_number(info.get("spw"), 1, 10000) + if parent_width is not None: + placement["parentWidth"] = parent_width + out["placement"] = placement + mime = (_row_value(row, "mime") or "").lower() + out["animated"] = mime in ("image/gif", "image/apng", "image/heics", "image/heic-sequence", "image/heif-sequence") or mime.startswith("video/") + return out + + +def sticker_attachment_columns(con): + """Optional fields were introduced in different macOS releases.""" + names = {_pragma_name(r) for r in con.execute("PRAGMA table_info(attachment)")} + fields = {"is_sticker": "0", "sticker_user_info": "NULL", "attribution_info": "NULL", + "emoji_image_short_description": "NULL"} + return ", ".join( + ("a." + field if field in names else default) + " AS " + + ("emoji_description" if field == "emoji_image_short_description" else field) + for field, default in fields.items() + ) + + +def sticker_flag_sql(con): + return "a.is_sticker" if any(_pragma_name(r) == "is_sticker" for r in con.execute("PRAGMA table_info(attachment)")) else "0" + + def _effect_name(style_id: str | None) -> str | None: """'com.apple.messages.effect.CKConfettiEffect' → 'confetti'.""" if not style_id: @@ -1021,24 +1128,44 @@ def enrich(con, rows, with_names: bool): kept = [r for r in rows if not (r["assoc_type"] and 2000 <= r["assoc_type"] < 4000)] targets = {r["guid"]: r["ROWID"] for r in kept if r["guid"]} extras: dict[int, dict] = {r["ROWID"]: {} for r in kept} + # An associated sticker can be inside the window while its parent is + # outside it. Keep it visible as a standalone sticker in that case. + orphans = {r["ROWID"]: r for r in rows if r["assoc_type"] == 2007 + and _strip_assoc(_row_value(r, "assoc_guid")) not in targets} + orphan_targets = {_strip_assoc(_row_value(r, "assoc_guid")) for r in orphans.values()} + legacy_stickers = [] # Tapbacks: scan every assoc row in the DB (type-filtered), net per sender+target. emoji_col = ", m.associated_message_emoji AS emo" if has_emoji else "" - latest: dict[tuple[str, str], sqlite3.Row] = {} + latest: dict[tuple[str, str, int], sqlite3.Row] = {} for r in con.execute( - f"""SELECT m.associated_message_guid AS ag, m.associated_message_type AS t, + f"""SELECT m.ROWID AS mid, m.guid, m.associated_message_guid AS ag, m.associated_message_type AS t, m.is_from_me, m.date, h.id AS handle{emoji_col} FROM {MESSAGE_SRC} m LEFT JOIN handle h ON h.ROWID = m.handle_id - WHERE m.associated_message_type BETWEEN 2000 AND 3999""" + WHERE m.associated_message_type = 1000 OR m.associated_message_type BETWEEN 2000 AND 3999""" ): tg = _strip_assoc(r["ag"]) - if tg not in targets: + if tg not in targets and tg not in orphan_targets: + continue + if r["t"] == 1000: + # A dragged sticker is additive, not the sender's one tapback + # slot. Several stickers from the same person must all survive. + if tg in targets: + legacy_stickers.append(r) continue who = "me" if r["is_from_me"] else (r["handle"] or "?") - key = (who, tg) - if key not in latest or r["date"] > latest[key]["date"]: + key = (who, tg, _assoc_part(r["ag"])) + if key not in latest or (r["date"], _row_value(r, "mid", 0)) > (latest[key]["date"], _row_value(latest[key], "mid", 0)): latest[key] = r - for (who, tg), r in latest.items(): + sticker_rows = list(legacy_stickers) + for (who, tg, part), r in latest.items(): + if tg not in targets: + # Only the currently active sticker is shown, not a later + # removed/replaced sticker that happened to fall in the window. + if r["t"] == 2007 and _row_value(r, "mid") in orphans: + kept.append(orphans[r["mid"]]) + extras[r["mid"]] = {"sticker_orphan": True} + continue # A rendered reaction (or its removal) is newer activity than the # target bubble. Preserve its timestamp for the client's read boundary. e = extras[targets[tg]] @@ -1046,34 +1173,102 @@ def enrich(con, rows, with_names: bool): e["activity_ts"] = max(e.get("activity_ts", ""), activity) if not (2000 <= r["t"] < 3000): continue # net-removed + if r["t"] == 2007: + sticker_rows.append(r) + continue # a sticker has image bytes, never a made-up star emoji kind = r["t"] - 2000 emoji = (r["emo"] if has_emoji and r["emo"] else None) or TAPBACK_EMOJI.get(kind, "⭐") extras[targets[tg]].setdefault("tapbacks", []).append({ "emoji": emoji, "from_me": bool(r["is_from_me"]), "by": None if r["is_from_me"] else (name_for(r["handle"]) if with_names else None) or r["handle"], + **({"kind": "emoji"} if kind == 6 else {}), }) + # Fold sticker events onto their parent, even when the event itself fell + # outside the query window. The target's display date stays unchanged. + sticker_destinations = {} + for r in sticker_rows: + mid = r["mid"] + target = targets[_strip_assoc(r["ag"])] + if mid == target: + continue # malformed self-reference + sticker_destinations[mid] = (target, r) + e = extras[target] + e["activity_ts"] = max(e.get("activity_ts", ""), fmt_ts(r["date"])) + # A sticker can itself be the target of another sticker. Keep both on + # the surviving root bubble; coordinates relative to a removed sticker + # are not coordinates relative to the root, so those use the strip. + nested_stickers = set() + for mid in list(sticker_destinations): + target, event = sticker_destinations[mid] + seen = {mid} + while target in sticker_destinations and target not in seen: + seen.add(target) + target = sticker_destinations[target][0] + if target in seen: + del sticker_destinations[mid] # malformed cycle: keep the event row + elif target != sticker_destinations[mid][0]: + sticker_destinations[mid] = (target, event) + nested_stickers.add(mid) + extras[target]["activity_ts"] = max(extras[target].get("activity_ts", ""), fmt_ts(event["date"])) + kept = [r for r in kept if r["ROWID"] not in sticker_destinations] + # Preserve the input chronology after adding orphan 2007 rows. + order = {r["ROWID"]: i for i, r in enumerate(rows)} + kept.sort(key=lambda r: order[r["ROWID"]]) + # Attachments. transfer_name is null mid-download; .pluginPayloadAttachment # blobs are rich-link-preview internals (a URL message can carry four of # them), not user files — both are noise to a client. - rowids = [r["ROWID"] for r in kept] + rowids = [r["ROWID"] for r in kept] + list(sticker_destinations) + force_stickers = {r["ROWID"] for r in kept if r["assoc_type"] in (1000, 2007)} | set(sticker_destinations) + attachment_fields = sticker_attachment_columns(con) for a in _chunked_in( con, f"""SELECT maj.message_id AS mid, a.ROWID AS aid, a.transfer_name AS name, - {attachment_mime_sql(con)} AS mime, a.total_bytes AS bytes + {attachment_mime_sql(con)} AS mime, a.total_bytes AS bytes, {attachment_fields} FROM message_attachment_join maj JOIN attachment a ON a.ROWID = maj.attachment_id - WHERE a.transfer_name IS NOT NULL - AND a.transfer_name NOT LIKE '%.pluginPayloadAttachment' + WHERE (a.transfer_name IS NULL OR a.transfer_name NOT LIKE '%.pluginPayloadAttachment') AND maj.message_id IN ({{marks}})""", rowids, ): - extras.setdefault(a["mid"], {}).setdefault("attachments", []).append( - # id as a STRING: attachment ROWIDs are 64-bit and JS number - # consumers lose precision past 2^53. - {"id": str(a["aid"]), "name": a["name"], "mime": a["mime"], "bytes": a["bytes"]} - ) + # id as a STRING: attachment ROWIDs are 64-bit and JS number + # consumers lose precision past 2^53. + attachment = {"id": str(a["aid"]), "name": a["name"] or "Sticker", "mime": a["mime"], "bytes": a["bytes"]} + sticker = sticker_metadata(a, force=a["mid"] in force_stickers) + if a["name"] is None and sticker is None: + continue # unfinished ordinary transfer, not a displayable file + if sticker is not None: + attachment["sticker"] = sticker + extras.setdefault(a["mid"], {}).setdefault("attachments", []).append(attachment) + + for mid in force_stickers: + if not extras.get(mid, {}).get("attachments"): + extras.setdefault(mid, {})["attachments"] = [{"id": "", "name": "Sticker", "mime": None, "bytes": None, + "sticker": {"source": "unknown", "label": "Sticker", "animated": False}}] + + for mid, (target, r) in sticker_destinations.items(): + attachments = extras.get(mid, {}).get("attachments", []) + if not attachments: + attachments = [{"id": "", "name": "Sticker", "mime": None, "bytes": None, + "sticker": {"source": "unknown", "label": "Sticker", "animated": False}}] + for attachment in attachments: + overlay = {"attachment": attachment, "guid": r["guid"] or "", "part": _assoc_part(r["ag"]), + "from_me": bool(r["is_from_me"]), "ts": fmt_ts(r["date"]), + "by": None if r["is_from_me"] else (name_for(r["handle"]) if with_names else None) or r["handle"]} + if r["t"] == 2007: + overlay["reaction"] = True + placement = attachment.get("sticker", {}).get("placement") + if placement is not None and mid not in nested_stickers: + overlay["placement"] = placement + elif mid in nested_stickers: + # Preserve attribution but never apply the old target's + # coordinate system to an unrelated body part. + attachment = dict(attachment) + attachment["sticker"] = {k: v for k, v in attachment.get("sticker", {}).items() if k != "placement"} + overlay["attachment"] = attachment + extras[target].setdefault("stickers", []).append(overlay) # Rich-link cards: the balloon payload names the URL/title/summary; the # preview image is the nth .pluginPayloadAttachment row of the message. @@ -1160,7 +1355,7 @@ def render(rows, as_json: bool, with_names: bool = True, con=None, rich: bool = **_edit_flags(r["date_edited"], r["date_retracted"], r["message_summary_info"]), # Tapback rows are messages too, but no Apple client counts # them toward a badge — flag them so clients can match. - "tapback": bool(r["assoc_type"] and 2000 <= r["assoc_type"] < 4000), + "tapback": bool(r["assoc_type"] == 1000 or (r["assoc_type"] and 2000 <= r["assoc_type"] < 4000)), # Delivery failure code on OWN messages (0 = fine). AppleScript # reports success for sends that die later; this is the only # place the truth lands (e.g. 25 = attachment not readable). @@ -1290,6 +1485,7 @@ def base_select(con) -> str: m.service, h.id AS handle, c.chat_identifier, c.room_name, m.guid, m.date_read, m.is_delivered, m.is_read, m.error, {edit_cols} {sched_cols} m.associated_message_type AS assoc_type, + m.associated_message_guid AS assoc_guid, m.thread_originator_guid AS orig_guid, m.expressive_send_style_id AS style_id, m.is_audio_message, @@ -1659,7 +1855,8 @@ def cmd_chats(con, args): attachments = {} for attachment in _chunked_in( con, - f"""SELECT maj.message_id AS mid, a.transfer_name AS name, {attachment_mime_sql(con)} AS mime + f"""SELECT maj.message_id AS mid, a.transfer_name AS name, {attachment_mime_sql(con)} AS mime, + {sticker_flag_sql(con)} AS is_sticker FROM message_attachment_join maj JOIN attachment a ON a.ROWID = maj.attachment_id WHERE maj.message_id IN ({{marks}}) @@ -1669,6 +1866,7 @@ def cmd_chats(con, args): ): attachments.setdefault(attachment["mid"], { "name": attachment["name"] or "", "mime": attachment["mime"] or "", + **({"sticker": True} if attachment["is_sticker"] == 1 else {}), }) participants = {} @@ -2364,12 +2562,14 @@ def cmd_attachment(con, args): """ if not re.fullmatch(r"[0-9]{1,18}", args.id): sys.exit("error: attachment id must be decimal digits") + sticker_column = sticker_flag_sql(con) + " = 1" row = con.execute( f"""SELECT a.filename, {attachment_mime_sql(con)} AS mime_type FROM attachment a JOIN message_attachment_join maj ON maj.attachment_id = a.ROWID JOIN {MESSAGE_SRC} m ON m.ROWID = maj.message_id - WHERE a.ROWID = ? AND a.transfer_name IS NOT NULL + WHERE a.ROWID = ? AND (a.transfer_name IS NOT NULL OR {sticker_column} + OR m.associated_message_type IN (1000, 2007)) LIMIT 1""", (int(args.id),), ).fetchone() @@ -2401,16 +2601,19 @@ def cmd_attachment(con, args): src = path tmp = None - if args.jpeg and (row["mime_type"] or "").startswith("image/"): + image_format = "png" if getattr(args, "png", False) else "jpeg" + if (getattr(args, "jpeg", False) or getattr(args, "png", False)) and (row["mime_type"] or "").startswith("image/"): import subprocess import tempfile - fd_t, tmp = tempfile.mkstemp(suffix=".jpg") + fd_t, tmp = tempfile.mkstemp(suffix=".png" if image_format == "png" else ".jpg") os.close(fd_t) - cmd = ["sips", "-s", "format", "jpeg"] + cmd = ["sips", "-s", "format", image_format] if getattr(args, "max_dim", 0): # -Z is "resample, longest edge, preserve aspect"; it never upscales. - cmd += ["-Z", str(int(args.max_dim)), "-s", "formatOptions", "80"] + cmd += ["-Z", str(int(args.max_dim))] + if image_format == "jpeg": + cmd += ["-s", "formatOptions", "80"] cmd += [path, "--out", tmp] try: r = subprocess.run(cmd, capture_output=True, timeout=60) @@ -2780,7 +2983,7 @@ def build_parser() -> argparse.ArgumentParser: help="do not resolve handles via Contacts") common.add_argument("--rich", action="store_true", default=argparse.SUPPRESS, help="JSON only: fold tapbacks onto their targets and add " - "read_at/edited/retracted/reply_to/attachments/effect/audio") + "read_at/edited/retracted/reply_to/attachments/stickers/effect/audio") common.add_argument("--hide-spam", action="store_true", default=argparse.SUPPRESS, help="omit chats with is_filtered=2 (iPhone Spam)") common.add_argument("--hide-unknown", action="store_true", default=argparse.SUPPRESS, @@ -2810,10 +3013,13 @@ def build_parser() -> argparse.ArgumentParser: s = sub.add_parser("attachment", parents=[common], help="stream one attachment's bytes to stdout (id from --rich)") s.add_argument("id") - s.add_argument("--jpeg", action="store_true", + conversion = s.add_mutually_exclusive_group() + conversion.add_argument("--jpeg", action="store_true", help="convert image/* (HEIC) to JPEG via sips before streaming") + conversion.add_argument("--png", action="store_true", + help="convert image/* to PNG via sips, preserving sticker transparency") s.add_argument("--max-dim", type=int, default=0, dest="max_dim", - help="with --jpeg, resample to N px on the long edge (inline previews)") + help="with --jpeg/--png, resample to N px on the long edge (inline previews)") s.set_defaults(func=cmd_attachment) s = sub.add_parser("avatar", parents=[common], help="stream a contact photo (JPEG) for a handle, or a group's own photo with --chat") s.add_argument("handle", nargs="?", default="") diff --git a/bridge/mac/test_stickers.py b/bridge/mac/test_stickers.py new file mode 100644 index 00000000..d5f33d32 --- /dev/null +++ b/bridge/mac/test_stickers.py @@ -0,0 +1,261 @@ +#!/usr/bin/env python3 +"""Synthetic sticker rows only. Never opens the user's Messages database.""" +import math +import io +import plistlib +import sqlite3 +import tempfile +import unittest +from importlib.machinery import SourceFileLoader +from importlib.util import module_from_spec, spec_from_loader +from pathlib import Path +from types import SimpleNamespace +from unittest.mock import patch + + +def load_imsg(): + loader = SourceFileLoader("blip_sticker_test", str(Path(__file__).with_name("imsg"))) + module = module_from_spec(spec_from_loader(loader.name, loader)) + loader.exec_module(module) + return module + + +T0 = 800_000_000_000_000_000 + + +class Stickers(unittest.TestCase): + def setUp(self): + self.imsg = load_imsg() + self.con = sqlite3.connect(":memory:") + self.con.row_factory = sqlite3.Row + self.con.executescript(""" + CREATE TABLE message ( + ROWID INTEGER PRIMARY KEY, guid TEXT, date INTEGER, is_from_me INTEGER DEFAULT 0, + handle_id INTEGER DEFAULT 1, text TEXT, attributedBody BLOB, item_type INTEGER DEFAULT 0, + associated_message_type INTEGER DEFAULT 0, associated_message_guid TEXT, + associated_message_emoji TEXT, date_read INTEGER DEFAULT 0, + balloon_bundle_id TEXT, payload_data BLOB, thread_originator_guid TEXT, + expressive_send_style_id TEXT, is_audio_message INTEGER DEFAULT 0); + CREATE TABLE handle (ROWID INTEGER PRIMARY KEY, id TEXT); + CREATE TABLE attachment (ROWID INTEGER PRIMARY KEY, transfer_name TEXT, mime_type TEXT, + uti TEXT, total_bytes INTEGER, is_sticker INTEGER DEFAULT 0, sticker_user_info BLOB, + attribution_info BLOB, emoji_image_short_description TEXT); + CREATE TABLE message_attachment_join (message_id INTEGER, attachment_id INTEGER); + CREATE TABLE chat_recoverable_message_join (message_id INTEGER); + INSERT INTO handle VALUES (1, '+15551234567'); + """) + + def tearDown(self): + self.con.close() + + def message(self, guid, kind=0, target=None, date=T0, emoji=None, mine=False): + cur = self.con.execute("""INSERT INTO message + (guid, date, associated_message_type, associated_message_guid, associated_message_emoji, is_from_me) + VALUES (?, ?, ?, ?, ?, ?)""", (guid, date, kind, target, emoji, mine)) + return cur.lastrowid + + def attachment(self, mid, aid, sticker=True, name="sticker.png", mime="image/png", info=None): + self.con.execute("INSERT INTO attachment VALUES (?, ?, ?, NULL, 128, ?, ?, NULL, NULL)", + (aid, name, mime, sticker, plistlib.dumps(info) if info is not None else None)) + self.con.execute("INSERT INTO message_attachment_join VALUES (?, ?)", (mid, aid)) + + def enrich(self, ids): + marks = ",".join("?" for _ in ids) + rows = list(self.con.execute(f"""SELECT m.*, associated_message_type AS assoc_type, + associated_message_guid AS assoc_guid, thread_originator_guid AS orig_guid, + expressive_send_style_id AS style_id FROM {self.imsg.MESSAGE_SRC} m + WHERE ROWID IN ({marks}) ORDER BY date, ROWID""", ids)) + return self.imsg.enrich(self.con, rows, False) + + def test_standalone_sticker_is_not_a_photo(self): + a, b = self.message("S"), self.message("P") + self.attachment(a, 1) + self.attachment(b, 2, sticker=False) + kept, extra = self.enrich([a, b]) + self.assertEqual(len(kept), 2) + self.assertEqual(extra[a]["attachments"][0]["sticker"]["label"], "Sticker") + self.assertNotIn("sticker", extra[b]["attachments"][0]) + + def test_sticker_without_transfer_name_is_preserved(self): + s = self.message("S") + self.attachment(s, 1, name=None) + self.assertEqual(self.enrich([s])[1][s]["attachments"][0]["name"], "Sticker") + + def test_ordinary_unfinished_and_link_payload_attachments_stay_hidden(self): + m = self.message("M") + self.attachment(m, 1, sticker=False, name=None) + self.attachment(m, 2, sticker=False, name="x.pluginPayloadAttachment") + self.assertNotIn("attachments", self.enrich([m])[1][m]) + + def test_legacy_stickers_fold_additively_onto_parent_even_outside_window(self): + parent = self.message("P") + one = self.message("S1", 1000, "p:0/P", T0 + 1_000_000_000) + two = self.message("S2", 1000, "p:0/P", T0 + 2_000_000_000) + self.attachment(one, 1) + self.attachment(two, 2) + for window in ([parent], [parent, one, two]): + kept, extra = self.enrich(window) + self.assertEqual([r["ROWID"] for r in kept], [parent]) + self.assertEqual([s["attachment"]["id"] for s in extra[parent]["stickers"]], ["1", "2"]) + self.assertTrue(all(not s.get("reaction") for s in extra[parent]["stickers"])) + self.assertEqual(extra[parent]["activity_ts"], self.imsg.fmt_ts(T0 + 2_000_000_000)) + + def test_sticker_tapback_never_becomes_star_and_can_be_removed(self): + parent = self.message("P") + sticker = self.message("S", 2007, "p:0/P", T0 + 1_000_000_000) + self.attachment(sticker, 1) + kept, extra = self.enrich([parent, sticker]) + self.assertEqual(len(kept), 1) + self.assertNotIn("tapbacks", extra[parent]) + self.assertEqual(len(extra[parent]["stickers"]), 1) + self.assertIs(extra[parent]["stickers"][0]["reaction"], True) + self.message("R", 3007, "p:0/P", T0 + 2_000_000_000) + extra = self.enrich([parent, sticker])[1] + self.assertNotIn("stickers", extra[parent]) + self.assertEqual(extra[parent]["activity_ts"], self.imsg.fmt_ts(T0 + 2_000_000_000)) + + def test_emoji_replaces_sticker_slot_but_not_legacy_decorations(self): + p = self.message("P") + legacy = self.message("L", 1000, "p:0/P") + modern = self.message("S", 2007, "p:0/P") + self.attachment(legacy, 1) + self.attachment(modern, 2) + self.message("E", 2006, "p:0/P", T0 + 1_000_000_000, emoji="👍") + extra = self.enrich([p])[1][p] + self.assertEqual([s["guid"] for s in extra["stickers"]], ["L"]) + self.assertEqual(extra["tapbacks"][0]["kind"], "emoji") + self.assertEqual(extra["tapbacks"][0]["emoji"], "👍") + + def test_body_parts_keep_separate_reaction_slots(self): + p = self.message("P") + s = self.message("S", 2007, "p:2/P") + self.attachment(s, 1) + self.message("E", 2001, "p:0/P", T0 + 1_000_000_000) + extra = self.enrich([p])[1][p] + self.assertEqual(extra["stickers"][0]["part"], 2) + self.assertEqual(extra["tapbacks"][0]["emoji"], "👍") + + def test_same_timestamp_later_rowid_wins(self): + p = self.message("P") + s = self.message("S", 2007, "p:0/P") + self.attachment(s, 1) + self.message("R", 3007, "p:0/P") + self.assertNotIn("stickers", self.enrich([p])[1][p]) + + def test_orphan_sticker_stays_visible_until_removed(self): + self.message("P") + s = self.message("S", 2007, "p:0/P") + self.attachment(s, 1) + kept, extra = self.enrich([s]) + self.assertEqual([r["ROWID"] for r in kept], [s]) + self.assertIn("sticker", extra[s]["attachments"][0]) + self.message("R", 3007, "p:0/P", T0 + 1_000_000_000) + self.assertEqual(self.enrich([s])[0], []) + + def test_legacy_orphan_is_retained(self): + s = self.message("S", 1000, "p:0/missing") + self.attachment(s, 1, sticker=False) # association works on older schemas + kept, extra = self.enrich([s]) + self.assertEqual(len(kept), 1) + self.assertIn("sticker", extra[s]["attachments"][0]) + + def test_missing_sticker_media_gets_an_explicit_placeholder(self): + p = self.message("P") + self.message("S", 2007, "p:0/P") + overlay = self.enrich([p])[1][p]["stickers"][0] + self.assertEqual(overlay["attachment"]["id"], "") + self.assertEqual(overlay["attachment"]["sticker"]["label"], "Sticker") + + def test_orphan_missing_media_still_has_a_labeled_attachment(self): + s = self.message("S", 2007, "p:0/missing") + self.assertEqual(self.enrich([s])[1][s]["attachments"][0]["sticker"]["label"], "Sticker") + + def test_nested_sticker_survives_on_root_without_wrong_coordinates(self): + p = self.message("P") + one = self.message("S1", 1000, "p:0/P") + two = self.message("S2", 1000, "p:0/S1", T0 + 1_000_000_000) + geometry = {"sxs": "0.5", "sys": "0.5", "ssa": "1", "sro": "0"} + self.attachment(one, 1, info=geometry) + self.attachment(two, 2, info=geometry) + kept, extra = self.enrich([p, one, two]) + self.assertEqual([r["ROWID"] for r in kept], [p]) + self.assertEqual(len(extra[p]["stickers"]), 2) + nested = next(s for s in extra[p]["stickers"] if s["guid"] == "S2") + self.assertNotIn("placement", nested) + self.assertNotIn("placement", nested["attachment"]["sticker"]) + + def test_cyclic_sticker_association_keeps_one_visible_row(self): + one = self.message("S1", 1000, "p:0/S2") + two = self.message("S2", 1000, "p:0/S1") + self.attachment(one, 1) + self.attachment(two, 2) + kept, extra = self.enrich([one, two]) + self.assertTrue(kept) + self.assertEqual(len(extra[kept[0]["ROWID"]]["attachments"]), 1) + + def test_deleted_sticker_does_not_reappear(self): + p = self.message("P") + s = self.message("S", 1000, "p:0/P") + self.attachment(s, 1) + self.con.execute("INSERT INTO chat_recoverable_message_join VALUES (?)", (s,)) + self.assertNotIn("stickers", self.enrich([p])[1][p]) + + def test_schema_without_sticker_columns_still_reads_ordinary_images(self): + self.con.execute("DROP TABLE attachment") + self.con.execute("CREATE TABLE attachment (ROWID INTEGER PRIMARY KEY, transfer_name TEXT, mime_type TEXT, total_bytes INTEGER)") + p = self.message("P") + self.con.execute("INSERT INTO attachment VALUES (1, 'image.png', 'image/png', 10)") + self.con.execute("INSERT INTO message_attachment_join VALUES (?, 1)", (p,)) + self.assertEqual(self.enrich([p])[1][p]["attachments"], [{"id": "1", "name": "image.png", "mime": "image/png", "bytes": 10}]) + + def test_geometry_and_accessible_label_are_bounded_and_typed(self): + info = {"sxs": "0.75", "sys": "0.1", "ssa": "1.2", "sro": "-0.4", "spw": "164", + "pid": "extension:team:com.apple.messages.genmoji", "untrusted": "not forwarded"} + r = {"is_sticker": 1, "mime": "image/heic", "sticker_user_info": plistlib.dumps(info), + "emoji_description": "Smile\x00", "attribution_info": None} + m = self.imsg.sticker_metadata(r) + self.assertEqual(m["placement"], {"x": .75, "y": .1, "scale": 1.2, "rotation": -.4, "parentWidth": 164}) + self.assertEqual((m["label"], m["source"]), ("Smile", "genmoji")) + self.assertNotIn("untrusted", m) + for bad in ["nan", "inf", "1e999", -100, True]: + r["sticker_user_info"] = plistlib.dumps({**info, "sxs": bad}) + self.assertNotIn("placement", self.imsg.sticker_metadata(r)) + + def test_bad_plists_never_take_down_thread(self): + for bad in [None, b"garbage", b"", + b"&unknown;", b"x" * 65537, plistlib.dumps([1, 2])]: + self.assertEqual(self.imsg._small_plist_dict(bad), {}) + self.assertEqual(self.imsg.sticker_metadata({"is_sticker": 1, "sticker_user_info": bad})["source"], "unknown") + + def test_png_conversion_flag_is_exclusive_with_jpeg(self): + args = self.imsg.build_parser().parse_args(["attachment", "42", "--png"]) + self.assertTrue(args.png) + self.assertFalse(args.jpeg) + + def test_attachment_png_conversion_preserves_stream_and_cleans_temp(self): + m = self.message("S") + self.attachment(m, 1, name=None, mime="image/heic") + self.con.execute("ALTER TABLE attachment ADD COLUMN filename TEXT") + with tempfile.TemporaryDirectory(prefix="blip-sticker-test-") as directory: + source = Path(directory) / "source.heic" + source.write_bytes(b"synthetic heic input") + self.con.execute("UPDATE attachment SET filename=? WHERE ROWID=1", (str(source),)) + output, temporary = io.BytesIO(), [] + + def convert(argv, **kwargs): + self.assertEqual(argv[:4], ["sips", "-s", "format", "png"]) + temporary.append(argv[-1]) + Path(argv[-1]).write_bytes(b"\x89PNG\r\n\x1a\nsynthetic output") + return SimpleNamespace(returncode=0, stderr=b"") + + with patch.object(self.imsg, "ATTACHMENTS_ROOT", directory), \ + patch("subprocess.run", side_effect=convert), \ + patch.object(self.imsg.sys, "stdout", SimpleNamespace(buffer=output)): + self.imsg.cmd_attachment(self.con, SimpleNamespace(id="1", png=True, jpeg=False, max_dim=0)) + self.assertEqual(output.getvalue(), b"\x89PNG\r\n\x1a\nsynthetic output") + self.assertTrue(temporary) + self.assertFalse(Path(temporary[0]).exists()) + + +if __name__ == "__main__": + unittest.main() diff --git a/collector.ts b/collector.ts index efd0d9b2..9dabbcfb 100644 --- a/collector.ts +++ b/collector.ts @@ -25,6 +25,7 @@ import { spawn, spawnSync } from "node:child_process"; import { createHash } from "node:crypto"; import { appendFileSync, chmodSync, lstatSync, mkdirSync, readdirSync, readFileSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs"; import { basename, dirname, join } from "node:path"; +import { mergeStickers, type StickerOverlay } from "./stickers"; import { parseReadSnapshot, parseReadIntents, queueReadIntent, retryReadIntent, reconcileReadIntents, type ReadSnapshot, type ReadIntents } from "./read-sync"; @@ -47,10 +48,10 @@ export const POLL_WINDOW = 150; export const DEEP_WINDOW = 500; /** One reaction folded onto its target message (imsg --rich). */ -export interface Tapback { emoji: string; from_me: boolean; by: string | null } +export interface Tapback { emoji: string; from_me: boolean; by: string | null; kind?: "classic" | "emoji" | "sticker" } /** Attachment metadata only — the file itself stays on the Mac until * fetch.ts pulls it by `id` (attachment ROWID as a string: 64-bit safe). */ -export interface AttachmentMeta { id?: string; name: string; mime: string | null; bytes: number | null } +export interface AttachmentMeta { id?: string; name: string; mime: string | null; bytes: number | null; sticker?: import("./stickers").StickerMetadata } export interface ImsgMessage { /** Stable chat.db message ROWID, supplied by bridges that expose it. */ @@ -91,6 +92,7 @@ export interface ImsgMessage { delivered?: boolean | null; tapbacks?: Tapback[] | null; attachments?: AttachmentMeta[] | null; + stickers?: import("./stickers").StickerOverlay[] | null; reply_to?: { text: string; from_me: boolean } | null; edited?: boolean | null; retracted?: boolean | null; @@ -437,11 +439,12 @@ export function prettyHandle(id: string): string { /** Never expose Messages' U+FFFC attachment marker as a dotted OBJ glyph. */ export function messagePreview( text: unknown, - attachment?: { name?: unknown; mime?: unknown } | null, + attachment?: { name?: unknown; mime?: unknown; sticker?: unknown } | null, ): string { const cleaned = String(text ?? "").replace(/\uFFFC/g, "").trim(); if (cleaned) return cleaned; if (!attachment) return ""; + if (attachment.sticker === true || (attachment.sticker && typeof attachment.sticker === "object")) return "Sticker"; const mime = String(attachment.mime ?? "").toLowerCase(); const name = String(attachment.name ?? "").toLowerCase(); if (mime.startsWith("image/") || /\.(?:avif|gif|heic|heif|jpe?g|png|webp)$/.test(name)) return "Photo"; @@ -530,11 +533,15 @@ export function dedupeSelfEcho(msgs: ImsgMessage[], knownSelfChats: string[] = [ // on your own note is seen no matter which twin carried it. const emptySentReceipt = new Map>(); const emptySentTapbacks = new Map(); + const emptySentStickers = new Map(); + const emptySentActivity = new Map(); for (const m of msgs) { if (selfChats.has(chatKey(m)) && m.from_me && m.text === "") { const k = contextKey(m); emptySentReceipt.set(k, sentReceipt(emptySentReceipt.get(k), m)); emptySentTapbacks.set(k, mergeTapbacks(emptySentTapbacks.get(k), m.tapbacks)); + emptySentStickers.set(k, mergeStickers(emptySentStickers.get(k), m.stickers)); + if (m.activity_ts && m.activity_ts > (emptySentActivity.get(k) ?? "")) emptySentActivity.set(k, m.activity_ts); } } const retractedSent = new Set( @@ -564,14 +571,20 @@ export function dedupeSelfEcho(msgs: ImsgMessage[], knownSelfChats: string[] = [ const idx = selfText.get(key); if (idx !== undefined && out[idx]!.from_me !== m.from_me) { const kept = out[idx]!; - out[idx] = { ...kept, ...sentReceipt(kept, m), from_me: kept.from_me || m.from_me, tapbacks: mergeTapbacks(kept.tapbacks, m.tapbacks) }; + const stickers = mergeStickers(kept.stickers, m.stickers); + const activity = [kept.activity_ts ?? "", m.activity_ts ?? ""].sort().at(-1); + out[idx] = { ...kept, ...sentReceipt(kept, m), from_me: kept.from_me || m.from_me, tapbacks: mergeTapbacks(kept.tapbacks, m.tapbacks), + ...(stickers ? { stickers } : {}), ...(activity ? { activity_ts: activity } : {}) }; continue; } selfText.set(key, out.length); } if (emptySent.has(context) && !m.from_me) { - out.push({ ...m, ...emptySentReceipt.get(context), from_me: true, tapbacks: mergeTapbacks(m.tapbacks, emptySentTapbacks.get(context)) }); + const stickers = mergeStickers(m.stickers, emptySentStickers.get(context)); + const activity = [m.activity_ts ?? "", emptySentActivity.get(context) ?? ""].sort().at(-1); + out.push({ ...m, ...emptySentReceipt.get(context), from_me: true, tapbacks: mergeTapbacks(m.tapbacks, emptySentTapbacks.get(context)), + ...(stickers ? { stickers } : {}), ...(activity ? { activity_ts: activity } : {}) }); continue; } out.push(m); @@ -1955,7 +1968,7 @@ export interface ChatInfo { /** Mirrored from Messages' pinning preferences; absent on old bridges. */ pinned: boolean; pin_order: number | null; - last_attachment?: { name: string; mime: string } | null; + last_attachment?: { name: string; mime: string; sticker?: boolean } | null; pin_name: string | null; muted: boolean; } @@ -2013,14 +2026,15 @@ export function fetchChats(runner = spawnSync): ChatInfo[] | null { last_text: messagePreview( r.last_text, r.last_attachment && typeof r.last_attachment === "object" - ? { name: r.last_attachment.name, mime: r.last_attachment.mime } + ? { name: r.last_attachment.name, mime: r.last_attachment.mime, sticker: r.last_attachment.sticker === true } : null, ), last_from_me: r.last_from_me === true, last_handle: String(r.last_handle ?? ""), last_name: typeof r.last_name === "string" ? r.last_name : null, last_attachment: r.last_attachment && typeof r.last_attachment === "object" - ? { name: String(r.last_attachment.name ?? ""), mime: String(r.last_attachment.mime ?? "") } + ? { name: String(r.last_attachment.name ?? ""), mime: String(r.last_attachment.mime ?? ""), + ...(r.last_attachment.sticker === true ? { sticker: true } : {}) } : null, pinned: r.pinned === true || boundedPinOrder !== null, pin_order: boundedPinOrder, diff --git a/docs/STICKERS.md b/docs/STICKERS.md new file mode 100644 index 00000000..4f741cf1 --- /dev/null +++ b/docs/STICKERS.md @@ -0,0 +1,165 @@ +# Receiving stickers + +The rich bridge distinguishes a sticker from a photo using +`attachment.is_sticker` or a sticker association (`1000` or `2007`). A small +PNG, transparent photo, filename, or MIME type alone does not make a sticker. +Standalone stickers render without a photo bubble. Associated stickers belong +to their original message rather than appearing as duplicate message rows. + +| Received media | Inline display | +|---|---| +| PNG, JPEG | Original pixels; PNG transparency preserved | +| HEIC / HEIF | Full-size PNG converted by the Mac's `sips`; alpha preserved | +| GIF | Original animated file through Qt's `AnimatedImage` | +| Animated WebP | Original animated file through Qt's `AnimatedImage` | +| APNG, including APNG declared `image/png` | Lossless animated WebP preview; original PNG retained for explicit Open, Copy, and Save | +| HEICS / HEIC sequence | Animated color and grayscale alpha tracks combined into lossless WebP when the container layout is recognized | +| Sticker video | Bounded WebP animation; a separate grayscale alpha track is used when present | + +All inline sticker rasters, including static PNG/JPEG and converted HEIC +stills, must have positive dimensions no larger than 2048 pixels per edge. +Larger static assets show an unavailable placeholder; this path does not +silently resize them. The table's original-pixel and full-size descriptions +apply within that limit. + +HEICS conversion uses the animated pair in a four-track container. FFprobe +checks dimensions, frame count, duration, and track layout before FFmpeg +decodes it. Supported animations have at most 100 frames, eight seconds, a +2048-pixel edge, and 64 million total decoded pixels. Unknown or larger +sequences get a transparent still when available. Missing tools, malformed +media, timeouts, or an oversized converted preview keep the usable still; +the fetch result explicitly reports `animationUnavailable`. HEICS explicit +Open/Copy/Save currently uses the Mac's full-size transparent still, not a +native HEICS export. Video Open still opens the original video externally. + +Qt's PNG reader displays APNG as a single frame on the tested Qt 6 stack. +That is why the inline APNG conversion exists. Animated images do not retain +all decoded frames in the QML cache, and the view pauses playback outside the +visible conversation viewport. + +## Associations and placement + +The wire attachment gains a `sticker` object with a bounded plain-text label, +source (`memoji`, `genmoji`, `user`, `app`, or `unknown`), optional app name, +animation hint, and optional placement. The bridge exposes only selected +fields, never the raw property list or a Mac attachment path. + +Associated media appears in the parent message's `stickers` array: + +```json +{ + "attachment": { + "id": "42", + "name": "sticker.png", + "mime": "image/png", + "bytes": 1024, + "sticker": {"source": "user", "label": "Sticker", "animated": false} + }, + "guid": "EXAMPLE-STICKER-GUID", + "part": 0, + "from_me": false, + "by": null, + "ts": "2026-11-06T12:01:00Z", + "placement": {"x": 0.9, "y": 0.1, "scale": 1, "rotation": -0.2, "parentWidth": 164} +} +``` + +`sticker_user_info` stores the normalized center in `sxs`/`sys`, scale in +`ssa`, clockwise radians in `sro`, and the source parent preview width in +`spw`. Blip validates every value. Its small-panel layout preserves the +relative position and rotation while bounding the rotated rectangle to the +rendered target. This is an approximation, not pixel-perfect reconstruction +of the sender's Messages layout; `parentWidth` is retained as metadata. + +`p:N/GUID` identifies a body part, not an index into the attachment array. +Blip can safely position part 0 on text or the first rendered image. Other +parts, missing geometry, or an unavailable placement target use a compact +attached-sticker strip. Nested associations resolved inside the loaded window +retain their media on the surviving root bubble but use the strip because +their coordinates refer to another sticker. Native sticker effect shaders +are not recreated; Blip displays the decoded media pixels. + +Legacy type `1000` decorations are additive, so several stickers from one +sender survive. A type `2007` sticker occupies that sender's tapback slot for +one body part; a later emoji replaces it, and type `3007` removes it. It never +becomes a fabricated star emoji. Legacy sticker rows hidden by Recently +Deleted stay hidden; other legacy removal encodings have not been verified. +Type `2007` overlays carry `reaction: true` so the client can use a round +reaction badge without putting ordinary placed stickers inside a bubble. +Sticker metadata is fetched for loaded parents even when the associated event +is outside the message window. A current sticker whose parent is outside the +window remains visible on its own. Missing media remains a labeled unavailable +sticker instead of disappearing. + +The decoration's timestamp advances the parent's `seen_ts` without changing +its displayed message time. Self-thread deduplication preserves decorations +and that boundary from either echo. At most 24 distinct associated stickers +are rendered per bubble; an overflow count explains omitted decorations. +Unsent parent messages hide their sticker decoration. + +## Sending and privacy + +This receiving path does not add a native sticker-send command. Sending an +ordinary transparent image through the existing attachment composer remains +an image send; it does not place a native sticker on a selected message. +An Accessibility route through Messages' sticker picker needs separately +verified target and sticker identities before it can safely be offered. + +A separate synthetic feasibility probe found a possible standalone route: +public ImageIO encoded a transparent HEIC with `tiff:DocumentName` and +`dc:description`; AppKit accepted it as `NSAdaptiveImageGlyph`, and its +identifier survived an attributed-string RTFD roundtrip. Plain PNG and +untagged HEIC were not accepted. Apple's +[Genmoji API overview](https://developer.apple.com/videos/play/wwdc2024/10220/) +documents rich-text and pasteboard support, but the probe did not access the +clipboard, open Messages, or send. A native Messages receipt and exact target +handling remain unverified, so no native sticker-send control is shipped. +Bubble placement is a further capability beyond standalone glyph transport. + +Media uses the existing private attachment cache (directory `0700`, files +`0600`, 500 MB LRU). Automatic transfers retain the five-MB output ceiling; +the absolute source/transport ceiling remains 100 MB. Conversion inputs are +private temporary **media** files, always removed, or bounded pipes. FFmpeg +and FFprobe receive fixed arguments, deadlines, output caps, and a restricted +protocol list. No message body enters arguments, files, or logs. Read-state +snapshots remain metadata only, and no Messages database is written. +The sticker render path accepts only PNG, JPEG, GIF, or WebP raster signatures +matching the advertised or converted format, with nonzero dimensions no +larger than 2048 pixels per edge. Cache hits are checked too. SVG and other +resource-bearing formats are never loaded through sticker attribution. + +## Evidence and checks + +The parsers and conversion code are independently implemented from observed +format facts; no upstream implementation was copied or vendored. The sources +used to cross-check those facts are pinned here: + +- [ReagentX/imessage-exporter attachment fields and source metadata](https://github.com/ReagentX/imessage-exporter/blob/47b75148b82e666b25db1211ce1dcecf32ab40a8/imessage-database/src/tables/attachment.rs) + (`is_sticker`, `pid`, Memoji/Genmoji source, sequence media types). +- [Its association type definitions](https://github.com/ReagentX/imessage-exporter/blob/47b75148b82e666b25db1211ce1dcecf32ab40a8/imessage-database/src/tables/messages/message.rs) + (`1000`, `2007`, `3007`). That project is GPL-3.0 licensed. +- [Its documented HEICS track roles](https://github.com/ReagentX/imessage-exporter/blob/47b75148b82e666b25db1211ce1dcecf32ab40a8/imessage-exporter/src/app/compatibility/converters/sticker.rs). + Blip uses one bounded color/alpha filter into lossless WebP rather than that + implementation's temporary PNG sequences and GIF palette workflow. +- [openclaw/imsg sticker geometry metadata](https://github.com/openclaw/imsg/blob/1bc0679663bf3978a744a61a5a9161d9ba518764/Sources/IMsgHelper/StickerAssets.inc) + and [placement fixtures](https://github.com/openclaw/imsg/blob/1bc0679663bf3978a744a61a5a9161d9ba518764/Tests/IMsgHelperTests/StickerPlacementTests.m) + (`sxs`, `sys`, `ssa`, `sro`, `spw`). That project is MIT licensed; its + sending implementation is not used. + +The current gateway schema was checked for the needed column names and types +without selecting message rows or attachment content. All media tests use +generated synthetic fixtures: + +```sh +bun test stickers.test.ts +python3 -m unittest discover -s bridge/mac -p test_stickers.py +python3 scripts/test-sticker-ui.py +``` + +The Qt test runs the shipping `StickerImage.qml`, verifies background showing +through transparent corners, checks that both converted animation types +advance frames, and checks playback pause. It does not open Messages or send. + +In the upstream UI, native sticker reactions are shown in a compact strip attached to the parent message. Known part-0 placements overlay the text or first image surface; unknown placements remain in the strip. The fork’s reaction-balloon restyle is not included. + +![Synthetic sticker examples in the upstream UI](img/stickers.png) diff --git a/docs/img/stickers.png b/docs/img/stickers.png new file mode 100644 index 0000000000000000000000000000000000000000..ad24440e078c5c405e46f629dffcffb6a79f73a9 GIT binary patch literal 104697 zcmb@tbyQSu)HXb{fRuD2pdgK;vpRRSnDuz&VA0k?|tumUDw`(sjGqs@M!QrAP|9~g6vxm2=hG%gmw4; z9rz^P7lsQ0F@Y3iUut@!?=8A}&`r(?A6~r>s4iZzn@tjTctkbd0IEZK7s)RqW0mtG zgjGi27037XtEa52p5qwS>q;y+GgJ!O^akt>0p5-?@lEiWCV{QX+i#Ozr4}YiN&M%? zIeZJtk-_v7`pZ)t3zm2W z`X9+jT@K|gnfj++-n|$RbojGy{P^E6JF>!JOzi1# zyXmG$u^`F)p)sv^(#Sk^^+wv!;6jTjU=PuK@SDaOFII3il$CkM-hX2LuXll;;kjmd z=>1WMkE#254Z}hC1THJ9c|M|!(@@lt_aPGVK}r2h<*$5W0aA>A1Jj$Qqo89dZRpGA zaIzs%zIOY#_@7?ljFzsl{|+$cc*B#(xJTW|rgvyyhYM-6_mMJ-`!Qf@`hWM2X>e1s zJX>wydHFn{{=xffnqgPgfOjqIRU1a~;C~~yP6$NlGb0ywwRn|VDHoH^XaiuU91Ip( z*#9hnigntVmUA17Ri7y*TzS3>89d~$aCIjL`!^3l#&XkqZGKXYm4VNsEGekkCAa?> z_QWJ_=`2LKbM7z-w;(vmE^9@LcW24#-%F9u`vJCA=za)-*~l`5EgmdQ!<)4Jo6utC z>=nmq6Nn1ruwn479^O>^-{%vO=_nziNePhrq?orc@&HBrZzw1W6lR3;{=0MWyFSo= z?<6&`&~mK2rnROuyfIku@9vYwmZtg(JB>YEb?)ve|K2T-8=7y9q-XwcDq zPZ)CVK<|G>mS$_6S4cP9`|oR}qkUC*tvXETq9N&jF5wjL4Jq+#9zgO3Igu(jXNUYcj|6Qc`F!sNv#Zxi;XQ?MI zsC8!-4ROTYQkmr|zpy{q)`*IVf81GA4HU^9hTfCs>lX7~7h@VO)iM$AxCC@E%_2n|grPH~+ z7a6)Q?q5jEi(h8PA_#{F)u(pg7HKxQ9KiHhGB# zZ@GM+!1}0IyPW#P--e3koXO?eJ^f_l51O-X_U>qCX!I7fAPB>% z^~iBGA_R};`65pV`~6hu4XKzk;$eQf^YtoOeyV;(OS$z3qgFdl_i6TL^KDg}E)A(mF4n7$ah?u0; zxvILFzSr8$&d$ops#e-)ru~uMx~Qs=gM&E)a-k*b^6?`r4b7u4*<$_Li8vmAX5h5y zqsz|jj%lS%!TBT2$<)-;@bLYWd2VFO`9YJ??b&pjM<&j4KPQj>zp1rPfwm29C3W?W~%yh~)Zc6M6J2U*u1 zqXB3jxBaD?AH2RVZu0i__H4^rymlsvur4o|O-mPnbru+rxLSTqRR7R}r}^;HZdnVq z3=}$~BI0ko+La)EH9K;0FgZX)8q>QqoaR0vd9I~BT~l&)@@LDy>(3JmoQF<^lmWGF z`kt5X)TC~HmFPZ9xZj^}LX7V$$)P?dfvnb@@PV{aE)EX(b=5$=Y6dEi*T1$om-$qq zt<@K8LUY<@f2y2feG6lIviRZ(adi;?L@9=w6JxpY0HSTEYh-jZF|LN3hZ!TR1n2ff zVc~U*9XNz^7i)|+6%7p@#-)+ZxVV~E{|@A!Vwp4MB`ZoW#|*}fy9uC!UA#YbL{=4tw`UxVp_)~oKVAH882oR7lNJ$tCl z&3l)CjbK)(gCay;+@3#GN&VK!Xr_GUcjM5oQf-;;i7Ku4lVpftTz-DPImce|FB+oR zj6W+-R+R&X$(nZeCq^Lr#3vCY71_&Y$b~7F;#>wfAOiR;2jY;n5@j1BT7z&1uCJtT z8~tuj743=IhH*=@L)d}&uGw0dTQ|%8$cK3>5W^a)BbJy!JwE@yS_+w$ez$i^o?tgO z?I9^H<{)e$!sPS4#WW-HTCLi=f-1YqzjJeQP9g6KRPE3HD6(ac$%A324t(DHsjbaT z;Kt`-Ra3+MwzrXB3vRt@H;)D>U$47moV&FeiWoHF<+W*JoJlwwexe%x#MjGzCm~CL z_p(UMkC~i)a%zf4A8z;Ox4Do|pH@CeX9&V|JZeAdU*e?~tYf0jkzKD+;w4B%cq3cN zmr$oL7|iKrNCe?J7EB4E;`g~|55y30TuN^>QB@r-_d8ANhrxga!{==VwSU6GzdJ4W zAIX&5YL&htkpWH&rwPP^bZy&?7m)>Z`(t_A;)uqUn{bs3FD*qyToB|2CDK~^p)cOa zS66qo-0$+EnX*PqF8;7Ia)nwz{Lh=ct#~CKsk#zD1Ha=ak#{CvV7DihcgY-2nWgV8 zN9JbLh%p_Tk2Y(pEitIPJE*3QuWOc^SG+)zlS0MQC5okYzrZ~GBO@5gSGPmPC>M^+ zbUu^om;=<~05lBjbU)Oe(){ROgM+SgTlr~@x=n7S{1&UJT- z%-V*~4LM3fOr}*&AOXIC=0>nRA{y~wZE-?{k&#m{IBktcT^Z=iM@B|!uz-2|uJ)aL zS!w8@*T0-RhZkP_QDn+jmE<%4jA8k9j3fXHpMuAr#^bu75(I4Erb&<@xU_c+lL-;0**0DLf`=XJ3E5 zrKb4%03?PF1fc1>7%2*#PzA4ohW2xakijH0V|MO$-ZNR^57m04Qn?03Fjo8rc z&le_x-;y{Xr)7+{RwD#i|a>&yr@ffDwy3JOZGu~|fSP@B!i=)O?IP$m-#9>h07rya!R37My zOG$(h7bxFj8JsTApHLvf@H8x6zf((DC{W9?5@e}uE&Vzb@={C7qG7b&5s~I_ox3J# zZ39%C66nz%pjpC zEQ1+UnwrC!*F;U2UxM<$Q8ZF^-`3!uj*n_TN`CbZ+MPPRBo-9jOXe&uYn5V%X)2?Q z=uV9?-~b}^1q)>qqjVVnnaXzQS5xlMm_{$ZjF<}ngT(d$<09m1(jY3-#qFJcH4pUe z=5DUl3@k{~aui|wfRwGd=|f)*7@V_}<-gMWafE;^jDwRNKof7w2JfSbpV;}Sr^#km z((nt*xg5ru4ELp$y}z8D8z&{M1V1(-Hhd})t}!#2%;*rq}1*0_)ABBYD}6BB=Z_HJZRt6$OGUYK|7cS zet7GD)3h-thhqX*ZW1ziiFL{B(nD>@Wn5XcH&azoQgS#7q&6RY+SaBIid<8Ax%QKM zFO0xCw)z&kJkS0B;lz*4PJPa(@&yLKw_gYk{_zz;AmQ<7>*#m@ za8axWETv#QC*VosBH@!DmUOUeW_1Ef(c9PDQ@RQk8QfIhSn>JI69j{j@9e`h{%di;t z?i@z1?G-+&XB=D-$AbcMoQo?UmyLhx43b^{o}jujULc~kUamAd^;P!@0LYGKW0q1k zMTZOJEoZ5O4Dcrqd#g9=>TiD+%x+{nH}8LmO!*f&OG-(rbXfKg@amnjPjm=hVF`O#l%p8DrbA^CT z6Cs z7RT97B;x*TDW|#26|Lw?SDY_=bTl+HgayEcGeyon9S>vhS)6P;nGf7TP5N}J8JceD z9MPx%eu4DcIs*{y?V|S?83maEYD|f@dHK3xu)ftdAjNII-eD0=s+JDQHg5B)UqVgd zFnUx}!C>GR2EY!N4V7$k{h9Z!R>(rdL{BJSF(|P=@h*gr9zDCE;iB01(xn>R`|RN6 zIO{gO)#7JIuztP6{&YEG0I90z%6VHGTl&?5_9msIuZf9rVk|N{lf~22mg!?V-~zQ5 z+_ej%qld@F*Ut_7-238_jr=Z41V%7{#M*$nhP1C+3E$u}^4_m~U9PVL6EoXn5m~yB z1NmN^N&e{~MWjkgU$e7`7nhR0xLi*dKX*d5v^my|6l8fleHh!{AAh_)oFZN@c?~UZ z{@dR;K0+AiQyhyk7}D^Zg1laKi-(w2HV-uHB4 z#Eynp?mku-u7~cLy3d+3wyb;^@jLjK#r^Erp98pSsx0%-siU9mN^W~h}``RDf>!>F1+%3n?DQnQ$mTc_fX7J+gj#x!)@ zw#@Y988l{No;L7SDTwUWtF{;dn8`aw$mwN%pdz>LU9`Bd=jo)Dw3q!^y7<90;&sU& zu$}M8O1J6NZ;UTn4Q`8Y%S?NLVupL*08L^k#8Q+U7Dq0OAPyUyY7{*^0a{onFgZE3 zwwta5wI`3ls0A!&NFa-|f_8o9L08DTD=CbrQ&<{YHH5-ZnHi{;<+vA{ceC z#(F%*;72S>>aaa%RTQT8&M@It!^~_AgGe$xE(KR6=zV(tTAGL>c13+v6$_hbQ1-@2 zEev(uc31uVyV{OD;QY^kybP9xUj^bYif!#xhdiWztD|0FKVNrV=it5C$Hv*ush5Ok z-e|#L@F13vh_mul{Xt>marEQzn9{(due%fcke8i(rqOI`@5M(W&yC6J=4L1Dz}m2z zHj;l#lI!hgUPIGvtfrnGYS;LtgR0tTY<1p2{CgnXy}QWDBD3h88SVjWxb1FnK8nA| zZ6EcM$ZuwG@}Gp4OO(g*Lo-T#RPz4Lj`(e^O&g{qC)We)z)1xlYHc^Aj>=hn!v}^< zoE&2d_)os%Q$qaqlrti0T|t)liU#Qnx&5e^M0aQHV-*HN$YgPWMP zJ0ZJu509R~tAi{2006)*C-E*ml!3JUP1M&eF?a?b?6xd=|7!)%>FFtB%U-ya<#!2# z@8aV=5x;7x3*?zeK$n-Ez|VfN+R!(}e?x;C0FXK1^3u<*AvPf)K`$jO+2?j-WPpG& zcdT$tbdiP$x+|doL)Ew4<<-=$ zgoKZXtUDb|%^J^vq%_CYAC;Ar-n*~=4W01>fUK>pKhJL_Xh`~o`-)176nQs2Gq*g! zGGexWZdnPAJbVCtbguz0N&7Fi2bQ;@^vC$9KQPeL zB>(S{6O)f!m)&Z;G@!5icNQPrz~ct~k=yZVdfvULbn*)d1$P@i+1Ok^VH}kfV9A5Sy~a1W zOI6c=RN%MPyL#lIqGC^siNiIkY;F!gIq{M_<2k@(qKMFjKx(T^25xZtD!fNBld%5& z{rmiR?#kb2dhyQSOi3@Q-tXnsy84ib>B(CEQh4Yt{O0PElbuVUYfZo2zPQA0LGg=1&F4yxwB1?R3r_Y_jReDM8)wQ0}7m855P6*V!Hk4|1-y zY2&l&AJpkC0Qw4T-1p~deXpY3-cXQHoNzunVvg%?Nz`BRF0Zyx0*ngg!d3`*ZT%wOY-f``3M(m5 z261YYd2Q!}=u>QKXr6?r88A*A9yIyy;GhNkCh0855U}4WGdy27zB-xnyGHH0xVZcl zK~%dVk4M@n03jk;Gyh#AmDDxBhY8g;!V13H{N`q#o=EW7-r{`8_ceI3p;w=C zFMXQcxVo|Q?pW`1iJ^BWBJixQ) z#obUZi2W+S z>1OD@U174H9G6dn{gPO#ys+XB##v4U?5D?CwLy6Jcv5GToYhs&A<*+OLqM(rMT;NI zDDm7X=%)$#R-y&OOZiG2|4}eeJin*N3l@WKy2@rmu&pj+?eVJubRm|TRK zfI79(<0tMpAGNn9AI8g>Ps z8eQF;2Gk0(v2AVAw#CM!c+M3S*ex_vZa54K4BVY;wShuqnJv?$%zu9mySX~2ec`hH z`-jpw{rOhg!{p@nV6 z^a5}f?c$dlWi+jb+eG17mKQ3er>7?=ZQ&!5k%N;nivM*8VG9bz8OaZ*-)Df+lol7G zS`BV0i@!X4f!*GOIJM)XYZ2I=pmSsfZj#f3r+e#hc-$lZ=(OTL=g$g7qpow&w-`>H=tfR zfrirfXlEK)+7LqORZk=E86DZ!vAEfm%(@M=%7?_K-_I+^l?a4 zCs1i1l$opX6bLYC@d_R<5_OBrROAOE(dlb+i~3N zCQk>219})}rouUI%Tv<(go@v^3&4)!Hhos|u9L7y0PX>_veNZWRWze%@9;VwsyRKK zexI-iNfxJosgf*7W@{r9E>B1|HyQHmi6&9Yyv`P^xVY_n34vVHpIs!MEvP=2Y4yDd zSCC*RFDyLtML-wh?GW#y)xtal0P2=B&TRC z@D%R?BLlO`bzvMxv$pJbvxi>L>HUnO&DGg{M(xNMIR(WR-=w1KJp_ZtsKwy7S?HLCAPv3C;PT<* zQR!QEJ2|=T9J&_QE+>$<`$0*$<4mO)4iKPO2+c!)ym6A#P4T^R=QC-Kj0v59-OMN; zpVsT-RVesE(%` zRsd`#RfmfrN*;%Z;RN6$bzF4OeY$l%m!FT;2KwKShNRD4{))RL2YK9_icoMFc!XY& z#ogW{6dguWOI$o4ihUIJ8TMr$daWjby?h)wGXeTeKr8(DPV)3?AAp3Scd_jeW+Wq$ zrxWkqI#RlE9ob>D{ckTop5(pvo&wBO%Y?}UaP%U>D%aV^`TKbLGnF3!x=*Z3CC$)& zcQs(FKfL`Liv0y6R@iQPHV-ENKpQ`UaFUaf>S&nIDyCYGhns*>BBQk1UT%Hb$ll4% z+V?+Sfq;sVP|skdWWgkv4Kf*4W>5=Y?KLzm{nqPI_n9A=K%ASHsV**qSC!NZF*s!S z^`7lc^U@taAi9&);25V|BQxc;)+cH6-w1F6AOtuafVNYYI(Bbpsq_mSr;EZJ<2%&( z2|ohqcq}}H6L<%(u*NcRixaDnV?YGkuk5}1IGX5V93CFtfu=B?pCM^KH(PWH)Dmng zi_e$l^|Xx<{xWx$Aqzb&>mJav^wgal1=i=lTLJ;^&*ZcPBWkb!WHIFBdbal>Ot!hI z>U8iA_^T%V+bgk~XnKB$7rSGCYTs~&TG_``KsFycQ1$p<=_B6%EA2j0{_Uhg??jlD zT@hB*M7_hbM+!#oTP!Ocq zUk=3ki{B9phogeZ9YTVA@0hJ|cboG!WScxGjnX7>WLO`i@R|5nLM#ADi7|A0`(~$0 z+--X_2V`Sw`%c8<8->fv;pTYv7k}A5xR0awO&n#UxohbIK4j;DKTl`*EG&Irx$yon!0+ExG zx80sPc22jP-#&hbKCjrE4~w8|BY3~iK)6vg(AW3E5+w)%>N)_@vQK)kwfAxOg}AR~ z-%EUfu;i~_KbV`N6UPCC!j4qrVoN~=!99qy9)Aid$b5dOFmRM{@SsS)V4*Tj;d?^^ zTL2(@Jb^N{UiTM+fJ`f5OM^$c03_S<9SB_+wS<+rD5ti~aIyME=7;h&KzRRxKRc@n z=u{vM4#Icg3IJ-~q1e-L`GEUrdEb30h0pK0a4m-SVD{tmfh5M&`M|&k&S6iQV_lm) z6nY8>FiJ{FYGTeE#pSI@qU(sp0#(V~lIme)<7&5|xsxUJ70~w+BV}N2$V^E|uQM)t zZ(&x@eE)#0t<4+MiS^btz&)~T>&cUU|6oW1 zen|;bDM+6xi=N=!gQ5?X1xB;8vpuu!on#agK<*pFg1yU_y>(!g- zQQ^LKxY7ygT01&XCi3Rw>@4vzd4BVCXJ-ch`r*B6(QA=FTHdb6VScOs?ih)~VE01Q zsb>&emza#PjVO22)wQ;;$S3$zkmV_Ca8JjTM1t{T3RaIpJE`1+qO|rkj3nxA_oMswfXJu zthOblYOQNs%&4gMUf}(5z;&|(Xm_eqEvx?-w2F4hv9MT;ka}ml$$exs6V%ac0>Z<` zzdGHWw}HId!jgd$7Z(E>&b1rPozEVO6UZQIM;D9Im%2FRhiJfRB-86pZC)%>cxH|HA=9T)P>!?C6x`=vgK$Cbe}Hzy~S zIzT(k2fT*}zoOu;_ZKR;@!i$Md-3#>^bUj{h0%H2>3(ys%*{0g(9HgV;p-4O0jtq$ z1=cEnqi%3&xvka=-^U!;N7xFkf(;uI6 ztu*}qfA!@2-wjmH={8ra?X10*bU(pRcJtoojEq*by8rF)QG7{MclKY;5gPIT^XdQH zGyY#1i2gqg?REfyLm_12*nepe!o)20rUL7qvKGo-q@)+iRm16aF9FEP zPW*tg%9wimJC|jYHGIUx|LR^%0pyfi9^6=2>c{tsNHT^)lpy%uWS>A)@ZW0hef?*Z z!U*UP6|0!nGfhp9Oov@CI+ZmE8K>Pec0V3D78$V&i2Om##$$35l?jl^q<(P{2NN+t zGRUmPa}Cx3V`s_@VDIQuj9B{45r7UyirSD_hd|I|V;>YRPCSOl>NiH>fO9xj-1Agy zG3oC%m=~y+S0-)uuOvT*>oR%H#-ES<%xuWN#gO}Jq2M=0{GA|pZ)P~bxcF5RdaM?* za6MRsrF8M5iueQ0eEaLDP-C}@JA zCNz3vPVkGzssWg+0rF&J;f{i_n}+h;IvAuOdXu5yXeF=o$ndjD2_`za(9DEZt(s?# zN;HC5cF@sS(V#gR3b~%O6KExGK$rnCQ5`VM)Q8%1ft)l_r|kBQtG4V*x+0F6pKzw!KCspZR|Q^Q^_L=_vf}mE73Ke zXlNycn7LDX=MOoEDK$dzL8h#;(c^k8taf70M<0Ole$T8%(y>P73lq`ie@gPMdWt3# zfD@&M%M_>qod|@|39V>hhj~G6gCRJrm2&*#qH(ap1IYJ)8b`r}V7>$`2nn2)U?=V@XshJlLocdXD z5Ah2lZ&inP_9S_s(Vp9b6vP4JaKsu0; z|3zkh0;r3JhNhYY03tUmoWr0!lvS1{or1_;MeWW|3+pH+x)9?C%UOd2s#0we3JWWe zCy!?0d!(Rm@`;009ct23Z>O) zZ>C|CZm{Hi=;0`h>E zij^!nJkLg!n|KNOPw<4lnN}tn5JZ6avED;UAiX+lB5dq`5=~ZThcaiT?91O^2EyKO znhA;p$}t79#HK6LyLa$Y8%^l+exH1aW*ii3JGHk!u5-%N+AcB$QM^TOyHhNBlfA>_ zBujgBHpJe~Wu?VR(IuRWw0~$vtm7<8Ca>Q($qhQChfw<6NqOp~L<{vW4^&3$V6=mY zseB!k%()8d@yzmaUpf$ao&Tbof8ig)ETvpqt~>A6YfJmKQU!d=AvD^v$Bup02Wc~U z43m!?4-2~@t#jTjOT|6~IosPgAv!|WY9IRPjcdwhYn2k9(+WOag+@hHdJroWc0dwk ze9R(Y;om;|iSAa=!pJKN%69cw35aKSLZ$S5?*fD-c2~WFtW4^R*EA#`Ncl1Cv~Z@Q4;^t19VJ{VB06yc?*TzHzIp?&)}!?)ldlalO;1(KVhmqj@yOD^+pXVhDn> z%e)N?UBi41uNhHm^*8LI!kM#s7~|-S4C1}pXZ*M-3{#z9;rTtmZNsQR63mNBP6-S1 z*r#-CutW9Tq|!S(2KgK$Njq>jlC8nSfSAR`$DOJ*@sV{U2lbT{e2v_nwxn_H7NfyH zXXnbTZ1>#kp7uXV4tBOBZ$&TrN&QaV|2V%|@*>04QX8SBP?~Qms_Vvns)Q#Z7ZB@Q4nf!5oUUAd$1w1i%J3RxyzKK!agw@4i6d7MJIb>)|h zM}iT`51lp^xDAi!0mt#BmJ)MD1zJp94sSVL?!(V_gy`m`YfGzvgHD9Da44V;8 z2QuE1@Pp*D;dTjs>)01%kv!cnj@n$@z*-n{bRmdvR6^!a6ud|JxJJXc>Cf*DcDmiy z28moRU*!-ud!AedpWoa}!o{ZHfmCKf0j!aNA3Qb6&Goxp{*~L27)s36TjpHI|LTgv z8qF;u5x);l>3PLHf!3_*LpK6+fC`6Ngf|ebrj!l+l?aMX_t29H;xi6ZaFF#PjQ&c{ zFYUimsb3En_Wju1mZ=M9;L#NmS3Bkf%;*Byj?RB#GpX~JFbTVqu*~t=e~mtF8R$nf zpH9)pW$)DZ>OOoQ*j{)_{DCQHKlLGyJU}vnrHK$(0l_%>s1FuQI~SRF6P2T~%S}8q z4ieO2y)Au=|ry#d-yN{zBn6$tGPe{Vvj`8!6huhrjdES zAAG|w@(&hN5L^)j(S@NuNZ0CZDr7=C1s!#xJ564wjO-V2QItAtD;Nlp2FT?R7_h90 zsSY%MD*BS9#gP)u9|9!#ON~T^4%LLsb}9d&t!lm(9dsna+1o8oXK)$S%L5I4~MVK@#g_TmJXK<6HgZ_W1pOyCMG)Brn$`YRuDoSioVEa5_{O5bQ@Oquxu@g6ZBVKghF zJ23NUWr(r{&?x3#i8Dc;Y+4VJ2V)c4f=JqCZy)0ZC!~)mVw!@SK^Q_0;(2lP5bBW~ z1moFC-+apwNr^^89>)_O$@#owI_w0BAm)`1EFqsrTMhVozpgJ{mW~+k`Q}=cvQS+0 zrtcrpiAeWK`p>a~F;`z2u+Yed{H}Q)K-x<<@Qb)O@KslMjg%Kh`feYtxGzk!G-Ivx zS9KBEGiA;tGCsv`)x&5De2CBvG&}7A>HF$8w!%put7+bx$Nt8a*i)Y=G7L@|ZiDuZ zWb#6EJkZS|Hu4QI^fv3&k>SW$Iyt7N2clEKY_$c^`&Z*ggK=@~$ga)>i=OaGRl|ir zFSn(U+moy}(l#c~Sz`%nKo7_sFu{I*RVOS8J~N_t`Zzv7kF*dIJyh&>KNp-k<^it) zRWY81GkNsWEirqy2fZQq33Nk=c0FSaRv?9ME(A`aZx+)rn`LCXabzcg>ZXRjO62Z| z!z_V21VC?3f?B4#v&Oy~?nh>7^w%zYk{q@RHQ+I}zkSXj!`%EY-cIkE^-zEme~ z2Q4sU;Fj(maIN^k0we!e93xShFqKsw~)Gj3d;U~yZ z_ui5%$*`U6qf&REsWhazo&i}h|3??2@XctIW9BPwiVqKW5^cMZ*TV|K*Yv9$I?v`r zJI$Fzl7b%=JdYq8^C@b}$c7JI(KUw^4y6ec)-+fbGkw?e)t_xI!T zTta0RJ&s}y?A37YXM?Egf_(q0VgG|NH;5hh%VTP3pltIN9OxSqVFyuZ7N+3*vk@Nk zDpE*zCnaJeMZ$lqZD#_1S#$?kymFQFhWYW37C@ggM1cP%VN|fW!Oa7&TY3SlkG-It zT;Y6w_?>jt&BYTI6a_{gxi+S5k8&oT-9c_`CDUpVxwS}#hyO_aBar+m^;>Drg$hUi zQ+O^{LVASO<3|@2r_NW~2@!sGFIJYY zJwgXsVi_g5+}T=46@{uJiN@~>&}k>~wxM@=XUvQ&dv@0~)aEL<$4(t2Uo$IBHq~|( zk86Cj+D+}iL^Iq;i@BrOyQkfHRebK&jp0E|4$Zzgbt2UPui+-}mZdtq%Be`Sx(nyl zuidXkG~leVHf20{E#79$#uuHCk}}q0dG?1C?6VgyaCJ5)%!gMTKm&cRxqqS2OJ_Xi zex~0fE*kvKPqk-4pqJezFSCO~7J|@ewsyDQ-=O>|H}T5ki4#+SDwWpPwFxb(DXLx+ z&Rx0Hc*XOv8WM|i7C>$;Y^sc)_hph}8O9n{J4zQ_W}|(e$x*y(Y~1WHi85SyT}#AX z64X`17S%r#-Of*3xc~iy8X9Pd1iY(8EwFu-R=%CaC>N^`N)Ve~n9t86kg4N?yeZ$e zj)XrIe@$G88+aNu{!?AqWI`5$Z9LU(_k(_dxk{24jt7>i+u#SL)ReuuAK2T=Btq#d z5EWG>xj-^qGTj7H29cW$mK}X*?y#&^=w|6M&r8;E-hQZMk6oakwa|a|Ho?S%98GZW z^_YaHrZYxD=~JZ)J7|?qV>)Fkdf!o;;X7o>oX*{O$QIBi>c3P~`-WT{Bal~XC6q>+ z|Ms&9b|s-jWtz|G#V0yvW#ZuzEG7ogX*!fj=9^}TJrn&Ez z)Zim@EptX?a^Q_*-w}>U@sjvL9UoIcOCg7Y*@iotd8~)Y_HvG1 z`tnqI*DO%)^R)1F56EY{kZ*Dt$!jsfcFFJe3C8;QcyL;gG> zv(Y5T^f%{EUzJm;J6M1$7R*4Gi$XEWEU%S@sjspulL|ee$Fy8_!xBFPe9s>u{R9go z50vi;n+3`DKKyf(fb`9`)OxQ8NeA_eH_S2RTWpRy-dxlRtf>;keJ+*?0QKp9qnmt> z_%6l4JS4XGgcA!oQ7z24M()Dl-U$(PdVCgH`u(jJu z%}5v?`ivcPl^D&Smf}GP9x-`=#snp8u%MDbS?o8<>QC(&p@|jwL*?}{IaBQ~p9|I5 z_b*Lp%76+Bj@lcdRHxzz=G~E{)H6*oWSOCOWE8^Nx;pP81BFKhNjATco^mq>Qc?Q( z39E{gm0JlqT!$83Mij#fC`<6^*95Q}rnH9=uNs`t=6})n(1@ zF*!XX!GUOzbOIG>8fBVO*i*T)oj;xujS0^EAc%%((1wzJ3&kx7nfbh?6wDt z{wg**=B$%D) z0bQ7(&+SC>wH-I-%X{Vg zx(23HJE>P!El4tx?+JEeV($k@jV9NlMihF{u02j)_`_etoTI+msUhj$ zfmrE1ag(K&?J!shXm0cv%CspCM}1kY^&Ft3ozM|73BWAiV>{j(2ji~pYblSN1r-G1 zp>vwb1%3%z!$w@z+Txt{N7ICUuAV9^6z8tIW7}zl=lg}LUo)* zQQ(nNC4xQ`n(;I(ua|_5-wx(X+2~hhK&Z?jdor>uCMuTd5ndbZODWjVg_OhRHcv=o zETt;9>(3>1=cxiegwkY3F?c`ga|?9CbM;RcBN>3wUhx z#qa3*A*&gQ{TiDrnof`TQ7Bb!157K2b6VSR(WsP9UZr~&eu;EADdl|0#Gw_5_JwFq z$kd59VmZ4lT~h>p;@DQ27VLh%m?nV48SR6<8@!lEw??rkUy%O%cYB~1aj+t0*3HyWqx%fwtZ_D+>1ft+8ZdWD9BjbV8urM!!@r_zaQ`GfTNj`(W$oAGur zT(5QWbdmiJYgB$M0DA{h4+qKOAo*@!rKZcQTMPuB9tT~WJ{wlN-Q!VL#B3EnmL|@- zPtnT6Jy@RTHQzM*2=+Z@AyE`=3!Nz`l=Qsb?jA7uj3IbBxO<_1%8$C503@Z%L0;21n-Mj$z9BC`QHG$Z4e1g*_b~$iBBm-)sW~z2)T$e(x3@&N6-V^Hy#Vh7+?VD* zJ(xhxbxJN{;L@2kr(H~gTjhQT)Oe*1MzlBJt|dE8(;9dgI8ZEq2m(UnLP~rob>tg^(%#o zIP7)sBRx~T2GAE!{w#5OgS&xKd3=dYaq?nH<9Yhld2dV8oQ3t1eFeRX=9KAy;#qOa zgO-o(jR?st3ATPEi(13K2h#`Q&u||>J|(C;%Vr4uX@gy}kOV3NVp@Yp zhpkfrd|HcCjcsnOgZeL{E3~unvM#3NB()x5QmC|Q;=v%EVZXIVC;VETJc&&g?eLHFt#YyPkjnKkwnqqkT0 zrWfC?%UgFnq8$4*y_U7%0wd2kI#Ly7O;ab6xrt#c0k&J0p`>ixRpnQ?@!_9m#E<&C zY@O}a3@C#8geXD`wHm0LmP)8dbyN%9VjG}?Mol#}H}#G6)5Biof0DmHc!3{7M3GnGge z!u{sfnsTtP^mACAHka-R;_jm(!{lJZcaE3b%{p=L4DKK!>YqcEVU4+mnTcq8cJ&DB z^}3e%r@pg?5BnRw~hKStb4mLam29^87K!BZA30NRbJ!W`EuTf zBOf21?q{3OPM z#k^``vN3C@Gg4B=h?i3G#fRjuu%z}ai>gz#LH3ZgMr(nJO*_1%LVB@^zK|Q#p|d<1 z9=r0A3=_PRZxSfknOlA#&BSdS3Y}9kc2L#jwHOCei}{`w>STnWsWkV0n7wpZ@LQ=l zrN!f9!5&sZI%}SF+%|#`U)SR|Ir#$_(i}P@5Yy{!w1Wujk4p7q*J~pK#qZgbY$0Ll zqF!?sDax`$oU@HRp*;LvZmU(W_h^dqy(E<+Pjt z598h7q$;0);BG*>9{}179~#dlaS#pKfA_w7Kr`V}d`EV0?R3T36yo&z&!VXgNVpmg z!~s@r3aasT{@KMCoUvjPA9+d8z-=r)O7=XZJ>A~;f|>qO*ty0hSlw&QH~OMt`vqC1 zdbMgOdLFJ#{k+mm{1R@BMcPLfy1+KWk7#!grppfb#M-dWI(Qp{d{}iidx(S9>xNW} zH;V}R_*H1XCb4X`9Y0)OgQIZxvGoLGyU)?}{HOr7U1T(_FT!%ZZmvJ!kWFXl+ajPQ z6(&?5_n32UsFB%G6lB_nomJ82S)v-85Rw0A>T>Rt!>o~GZ+uT%QCoWD#|LL!L9b3< z^=^~_5mA?Lgzz(zZGKy%)Y^bvw^#m&->3QX+te8n-|RmT@-V4#%SYFx;>AS64xi~stV-mZKmaGS#%X5r zx<*C4GVc^l`i_xpUeGT=2o=GJzFC1Bf-3vJl@s4|SQ=dxZ)C9yagwFWk!fX_e8 zoDvUa_|h1t#)=0T+J;&pa_Up;o{Tuhuv{V{3TT|Xlq=q~({* zdAFk%tEg8sGoBh(L8Zd5ROupC2vDhjg-BafYPd|Z6PioL4`UT8lbm*XBx@dUYzuEd zb$Fu~dF=PjRX4mXYl+Tas#^3yVj`>`Br(u#rcZA&WMJzSPKR(-kZX2 z)^OBYqU0x3!$Y^Lf*zMvQ<2?jhu6ds{F9Em(@Fyi4uxb3hb9ze>x{dXIu>rrTK5^3Npc!s_@fmU#K#UDFiha1 zF2qB>2`FauF&mZQAbVJ$64R=uqP;pY-Ka&_OKUuw)?AH-#=f{O{q1b6*Y{Z;naHi# z^qFGI%3V|0=EfN&bB!EP{hy!coKgBFh=PXd_VR7`{E7cugS5Fm5mD83`Ry;YdessA z7QrV)NTdj5IGaU>uoC53PDHpuB3lkA%=QOJQNdriA=U0lH0{bt0n2H7)Xqk($@ zZ+>ds?Y0OScj2wLL)WumzFNewg0QPYK9&Bs`jXXPCq)zX&D%qi=jb*vaT7W4Mf?l0 zT+{-(zGY{A${+W_Y&QcElkg(_$Sppq(zEr$_ShX{*6F^_q$@1#(nQnrmFf=;fn!@* z;`=|YF}yXYKZKHROKug@(#vCeyIDqO3~4G`5U=?;`L)ed%u7g{llnq^-Rf1_b6FKL zh|$p5q&lPYz&f?qB5HM|)>c9krgVvY8^e3cZN19)%64&3{Wpa?(-J8XQ^;p{R5Y(J z7vGpX`x3 zIk}uX5DZesl68Mb6uhldnQ$SYUL#kEB26A{XM=eT%X{J);(w=X3a#XlN|W_TLQv4n zxu|LT$S;Ajdd1hBaZ9v8&T9sRE z45dB1i6}=bn`E;=BJ1hpH<#4uZk<@}N6s664`feV4ZOip{WM*FFj8DE`Kk8!5SP(% z)^Qn2@YygJjK5|MUvUUmp%T#!^gh$6gkuiTG66Fb4Ps*Y4)YIVqly&b)^ls!Lrgj$ zg2Z}sPV-{0dbdUOH6~2_hQ(kwRD8mW_mrXS<&%~d!`dxz z%$Is0qxtH`@;7ekEE5Axj_VI9lNUykR8_StZz9%ngSwak4p>1Kll~k;yG;eI!350D z6Z{Vh$1igCzsAt%EyQ!WExKI+Z?f>a(O^cap6>Ar4pK8rcy@|HoLNS)k_d*b>9DRl)AaZ!%R-z; zX>Cdd;~rC0Q3uGrEj)O+E^z1T?BFMq`2}#nsC+4kpEsjeq z1NU9=J${kd7P;IN7Mi$F{I+Im@Uxl9dv8-BXZ4ed>s#*iW$Qa`+_MZGmH8=IqxDdT zGOjxlW_AX{y9nzgs6Dwi*~1|GRExtfH&x8?sB0oCMamXpcU>rj{@0h{EO6rA$Xc+x?mApU{Lym!l`Nu)3K!Z6g6Y;h0 zZx8R%g1p!)+$oJ0npe8T&fV2ZM4MMOXgvfQ*tK7LZC5v+o7!vbd&VC1i3)e*=CKb{2_beDK7#z%}0vz}7P>;OZwmeuAY`y_J^=@5r#cBMVf z2;KXkX4R{ZD<~7`u(A@QG{Xc}U!EmLp+aIIg8^tqHz9%=t*WiE+|_7gep-12eSKUb z8>&CR(bnmf=({0hVV=OJCF(zzVPNpan97XPen)=l;M$Hs!H`ONxL$(78@20kzCV$* z&f(G+;ltcf4YQZ3yOQe>4!Je_n&0Xq#1Q5Bk3Xbzri3lC(UdKY=j0FBY0IlrEKXX? z8q;=aP;n*MwRb`z5-3Uk6rqe$NUsx4Ne!pqiG%S0LBOk5?~=kk-$dICq|rWzl-hkc ziOgkP&8U&W*vDrCt-58yYT<6Y(67?R2NBl&lg2s@vu4J*E}tG`8rz9}i-k4j-HZUu zuGkE1>(N43 zAO1_#HF1c%kn2`g1%)|8`9zm`wDMQ|Mz3et$_U5PQ$;eQwTfh1Ra`vE%*=ERMz5(S zxek=t&+yWf(myEeN4>TJJicjl$wsR=O zqCLuwf?CTk^S>)BN?<41Yrr>`H!^EPkdzhX?_kp!P;ZVssFGt{;zHIRkJDFEmUe?& zSWQUhnu*zMAZw8KPbr|C&%S;lOd6G5v3k=7LEX;_z&M0cav81zvMYconh7Y0~M&L%R6YS zWmJK~B5dJpV@WW78@d<~%4^xiH~RAq&y;Xe!@($OFh1$xVObtTMMMAX(}V0&Z7=Zg zA_AYL9q57aPu>dad&H%sCAG(KstI|aI$;K*4Jx@5J;(GsFMCK~{IMri_GtU(Ft3Q0 zO}TiqRR#u@)Zpuer3eljRz!*W1@hfZmWk&ciQf8Bi(j;-c=+W-r-P$|Pxg>-nBTRL z#%SAg|6CuoY!F|s*zF@#p+$`!J5H2=vD&)$6zp9O43QTH&~ zetTiG+5jhE%j|<*h;^}xvU%jb3LP4fMt4j&qPdGAQr=Ov+?O;i_a7^B3BGOO^=^XU z0uj-LYkYgK+H@!R$!kpEd5%B5WLwO6ZCLGkw50voI<)Ra2o^(AmzMw^jtIb4)^l)b z7I3a=YC83N6M^cCcNQ*Xn%4Vu&aQ6bcyRe*sl)*@-`ZW8aB;l(jW0{`R|5RT`rc}n z9`8>DpCq$1JTnvV>YPiFD2MiIiTkg>O{(vq0JYE}!we{1n zg+zua3Ea7-&ddi1QA!Ft?{D=#E23d5irR+xi*2^DZ<4=+^@z=WIWR>u9_J>IoBNKx zZaE_DC`K1WqHVPNyIGo+5UrlL6aT0px z-9u}lLt{X=@56;?hb4tKD%vl7=F#K!TuiKxaNoEm4=DqoR1=4@bFlgG8&d*nc|a@_@|v~cf_Op_^ufs^i&_Lf&APLYtG-A^RrwxuaQu1 zIl-hs+EPUo+{?%H4WKk@LjjnxWM-k#r3fO%&L$K0zVOgk)B%jUgjsPQbsd7iq`3w_ zT}H-pQxbCBrl+AGt;gdZR8O|9&^d32R)Uso`8gTnjS83p4$PQL_+JMl$%+e9U>GmQo}A4ogJ*zy3RjMhWn{-u8!v;#m?)F(GmIm zKECA_oN%iG7-{R-8#*j{EI{Hzt0S*p&afSl z4a{f!J|3CT&aT22A+*=L)*ZXvVPdcksT8HO96yibXGG49HFE`~G&sm_{Xs5K(Snb8 z*}r(n$d$P9=OKqIZlk@8fhSdwgpF2D1Zmd~Kdv!~E;CddA5XU*KBx=rIEMTTX3alr&TM|)%f_Hmw6Z4dj9YcxvpngYXgG}^_26NPg#r=Lp;GBJ6`O~_ zjw~bHDa-LiB4fPyem8nKNQ2iu*eV_M#6PqX>Xn2_CyvoFryPYSq4G?vuJ`5~mY`sW zAUu^V|A_u$o+Zu4uE+Hk8ljvr+7FVg`N!rCLQ9}iLU0RbPgSXYu1T@s)TF?&e$*mPCw z${@9e>NGEvQ_pMlkMzyq5XFRNHZ~6O?5vvO)~aXUXk<;Q=J$VO%x&|gtmKW}| zhhpiwLj}DNjkF>q!NK_3GKItw&luiznJK>{Q|VExEwq70+Qr(*XD8iL-#c;+0^Hy= zj}Kq0^h*j!^0RHI%&IAKZ*JvG1m73fR4l11{u!2INfl@+ZFj??EmFvY|fQYTC^vkvY~z*f|Y= zggyN9H?A4mr=K?LA{~V=JGneX+^^fXuHVkJWf!%RwZ8{hdF9qb54l zz-dc|wCEo9CZAF`Xeb-14H@xTtKXVxwC2Q2^Zr?uIxX7QQ5>c!?A34R+_VWvJ3lbD zt>p+;$tm>U&bHYww$0c@&Sm;9Ez)(=PoPF|N-dCam-{UT&N;dw!mkBY%4-yOW zhs^E|X5&Y+QDzlKmkX?gc`RI)=H{dV7*aca2vZ_3#c9l@6}}UnYWyJ;!B)cR8G3Ox zao0mztVcBOWXm~p!9tuYDxpj3HltU=m5F6-74e?ZIM4UzC*8Hpmm?T zdW7L}0hFp*D)Kx|*(hRycX&K{se>NBo4_c5?^=L2aMYx7%0a>tc=ac}=p36ORBpKh znV@Nf9d5WTF_fP)v*7)+V36ram=m?1ODCs+E!*5_j<2A`kTolAQ5*H3@-DTMnTq0r zxa)%ox>*Ecj0x{HOkwwdW2dQyAMyy&6%l(4>1WT4Cdi(3c+^XB^{Ut?(6pm9D(4&5 zEbPt)3tA*vDh+QHCACW+-;1<`W{ZYGP89paf-#$E#HD0ToIw4Ksu`yUUm-m{;x{La zJC?@7I~sho)3hCm&PN%13_IpMc@-}deOzb+_bG{p?&MK(YBFP#uu@CXIdINHDw8O0 z-SGG@aRIN1kdB&>fVXzpomDp{)*mZ^M2^ffn-xZQyM)z39js3Ktxeoe_HyZ}iX4So zBTq-3-aLw_uiF7qE(!|iid^+%OhM2#-tbWyNTg#}QDk_1+v%tHR9|Y>?4j%g4aJTS z&xN`jI~u@sl*JbdD^I=^e5?i1tYT%e5s6b^S3*d?QITM?;aSQ!6z}E8XA8I2@6|B> z5D~5?nAkL*@Ve}PGoQ9IoSm(H%%wV4937M$5nagUcb$@&rBeb}+tteM6difm)EHiP z^hvHHJ1Oi1R8uEJo_IY{ zx%qh*wP8;53PG+$0W5y$@D6o^r`R!fL{@Kcdn?jLGTHMl@fyBi&mJmaqw;VAg+mKP zls(JJXd@VW@}ZiPg2gE$OAS|CI2?-X1S8Egg`Y~AJ))u%iR=Vb^R(lwTe0u++4323 z+1knDDzqp?_#{=+dw(>pnOiMwDH;$b4zBpiY%1}+DhhvZXON(;plOgxPk)y!o6554 z_B*wY+)Il3>~x8C&L9`NnAzYHJ_t3nAeT;uVi9rNkBl(78Oc9{qE*YgIcee|Qc^m& zbq{Ah4o2+`TrwC-X;>=ws=*n@~aY z)=~Uk(%#5^=J14KJTi&C{6W6BfnKjd2QQ6Vr?Xw_V7kgu?%jChL~aXqom#&qjymZo z1{_oSEt4AQ7i%r-%y~42IOypn;XZSvs`O-+KYr z6gMM57D@tdi*B%1g4nX_Rc@$vIIyve8ZDVPt8j=@mshNQ3V*@LW=La{Eax>m7&%_k z$f$VQsd`VVIwH5C9Gn#u7FMNhOfEx-&X&_`@*Clv4bU-uunzT&yA#Vf(g{h4c#*A1 zT`Tgkkf!(hcxoX;uUB*b!51>z&GOl=Jq|pnb@?g|Y%3DwFV^}gy2$UItKHUN7gP=C zmIiF4v%Tu03Y|2y*Ubsxm+qc(@^Mn}c}AIx@vt?kx0u}E|{_BNTJywQIcnJfH5+NmcDwsh7NT;2Az zBZ5>?c17e%&_!)8HwLNx@W;)r&iu*nVA(is+DL9|+JIqI?uJCA{SZ#5wV^;wtYOS_ z75x0>*5GhkUly=~_vUH@!wn;i4#(|nbA`HFId&_x-exza2NX0*w!dUg-XtQL8_Q;9 zKbJkKO^rB!Gtr72Jioyux;}}gy_lrm*XFeHU4(Ljsk92$uTeXsDPVEFl+&tkO7^DW zGwzxR+?(RzE|NL)2DV7vl$w&}9`RcY?Kq<>XAa@x5Vx z7~pO+9P2EtL@W0P(KCgo+_V7r1d$qH;tilcP<|l%d{THsfTVaubpcqx050+sf!4S| zSAc(?k!D}{eeSOZs$YaS9%2sDnhFtuc{D!o;dVg zm$C|D0{;E~)WToQbMVi!?}t7(1{r9SfZ-zZ?a{h!F|l~iGygxC;n`Sjj|`UA*GwUW@{cQw*~w)n4upsNm@ zPSsgu1RnT0E&osM|L1m9Q(cu4T?s8&U6=knT%gZS3CG<3-VKM|TkOt?IfOgDgAV?+ zPf!11=D%P4i~Ijh)_;C9-T0*k z_lc|XulyE_XQU3A6uS2qE(3SGqP_E12Ob~@Pdsr@rO*}TWF?FOeZcxJ*?6VvNE?y& zt4Cky$02NFYNA1gyS5Fw}``Fd!X>Q-fw^YPcr`hG89~KJl+JlyE2n5{r6D+Z;7E}U!dcE3GRO+ z&_OkhSjbWFw~XroqoyYFmnL=qOGW>)Ig9(n^#78{za(HB@&ExXwfkiNO(Ix-k^Kbp z%hV8k{A>LF?%Chw&W4;y@wc$ZmEJ{bM*kj7U^$Y|?5FW~X7=BVB8)bxcd6YC!g-St zjtjlN6@nl@G>wMB1P~x1KBd%O%EPVG`J3!g!a~V!Q&%Wr-IDsAU<#g*{tqM z&*RPZ+o0Y*tm3?V_m{K!I^BN#-@2@;zIr?Lx1IiP8)q{5R)O-@-By%;nXiA>w%fsfzn=*wI6|W7d-wlc*8b@_|4H-z;8*|eFZO1_Uq3H&Fe%a>9Y00I_e}8J^)%xoku;l{0w2O4+^MF!%#I2I?!RYmQe-&lsf{8Bk_#exs!LZM z&J0wP%-9K6mduc{Zhtlhe9~7HB+Z4Q`26a_8k5qbqh=8J)rhX@m>R^}Q-yiozu5w{ zV{bE)3BL=xx`~^>73RQGcFj2et6?@w=_unvXj4G}d~7U%Isv%jP_1PWUTzDYK8=Zq z0m^IF)QEO3vz@uT95T3MxmMbqIFAY=x3`@f9p~<#$hVE{%LdcL zY&|&uqq?nm_=rNc)NqSI3}#r2T*Y2Kj^LOA!WS4mG;~EXPED+2AkOo@qKMbbs!a^mAkkf!gcL4O&rWg7clgN2 z%*bbGBa-R0pqzn}l;o_`p+-GHi4SVi{vb5I&CYb8U2kG&h@5kkK$KhKo!fc#vm-OT zYRX?l*=07?w>45T0TKD4T>bF2A4*C}syI=t7;%+;3!12AYg>TT7zH>yZDqpz0pQkC z)Kz-cU<;su!;(qjTz1X+xr^Q^rlzLf9sz>+N;>d7rh<<{+8b198}k4cY%r$gRb>*ea?f%vWXf_Ei8>qB4t8I#tCon+$5^qPZb?+y zV!->0%FHu*r1KiJl*YAFSkGuP4$W%>X>HU~|05pT zI7{~#n%s11ZXX|^GU6xfvojCWi#%}N-EF79?^=WAVN-`__o#As@x%R~N~B zahKO3d+?|8t#r{%_#p6T55)59Tk?s8xGQ|#sOfA)$Y$GhB-6A3fDSoD7i0zd)A<-E z)QniVogc3aKHU8Z)Cl(b*`*2KBft+f#{4%iQmCdaW!W>GTMzs9|7u?Z!-DJyA23--*R7P^+5y;i?!?xinShVlElge17HZr z=7)*VX`<1A!xS>Uz=nWyy}*SLK;K&Nr>(V^Il*9DU$H1qNf576Jh53{7Jz(nj4rO8 z1weONe2~@Zv;sH%A6o=>ZE$4-j>?>Fk1Z_VdfH>n08Aq(I+NMCIiP}RhP1S_<>?8H zZC21EuviLfZpPK;^#>olWs#Xc=@m~n&{+oR;I+Cm(?o+X`({(%2>spcsCQ zTYE^FOT%%JsSA@g>D+Q}0%A9WggjG-s~>%Zih?vEADMfP0c-6lRr=q4Ojbc z@!fmd^x)a$Agr@6L|XvtI{f!ckI6ik3G8JU*fvw5f+b8rL(e zjKH4fu;BXNt_|#L>={IVJlyQLbH0&>Ty$;1F3_j6GkKZhlH4F^u zyIat-M^=VE^f_OfG<8MJec}c?*$e~q(t`Ck={#lt+>+|$`ZaQiOT z6khCQcXq1V3`(v~tfep53CrN$3&Gk=Q^iG_lWC z_H@Icnx|P>r4_p>hJ&Xe^aH09_*>5$Yv~TSe915byi9VyVZf%-~$12 z*`-~13W?=#t}I>#zd=U}X}~OSsArxoCAU-om6fY>CD4gwfj=27!5ewWfj=&?{Q2DR z@@xCC0`Q3tesTnUUO$YRt6$4F9f>_Rh&uEEWB1-tWR3w6y|5ttEyveoqk%>I^>iOfuY4o$>)Of8eBEBq7jusE*D3J`gqF6}u^ z_PkOYsm$!waYgpXmd^aByY+a`RVi;h+v+Ympyvz492b4PgTgWh&^w=fZ{US1TWlu* zbOJwg($X=f)_gUr$@wK%oVff%gM2 zwdAj|zB}D%!~-hc0?iEU>y>HlTgJ++Vc1l#gizrKScQ_v5PrkN*^M6lIV-*^6ZXFNM3An}^p7ZuVWVzS?1x9ItJ|BotNPGT_7MpOW zK1Q#h=G(}>nUoW}sj;K~2k)PCpE}huP3vAR*6sbAEU~CWe7q|*zgrBT-3_ElZ?#=v zNf)$Iy80a1;MJLQs-0$Iqb+@`k587x4G6Khe~rTVtZOn3t|HEm-H~OM;I`wn%+m%& zu-DJwbL`rjZ?A_s@xX*}!;A1RPp>4uE-A6+XGaf*0rY?waHVaQpZCt^P{3;AyP3ft zsnhWj(D#Lfg)~vuol{$F?dHbDf}9*_)iIl-aFsmWjqUCECVM^XSGM5(B>sTj=b=b3 z>sH$=^D1goqqVw^B{OZDO=Z0`dUXf}6V^NhO{;i%Rz>zeCW=pG>)j`yauWAd`D-#q)8Yr0%}^;{W4gu3{t|fL>5^8XeeO(}wEAFaj}G@V#mW zrd&f|sgJ3A#uW+%T&PCZO1Pb?D^TdYH-e_0LUR2!rNqmw^R3A;0pfxpU_FsKuIuZH z8w3*)rVq`jaTo(ux`~@yeYA0>h}Ifc(lj)jOSN+5mS-hguS^}q0}C)qT6>#$?fF-s zaO_aM8l>fPA^8B@Qd}vo0F?@eN54jaY+8?2$k;$NR_~iKprjHJ*#hNwq0R}ZDtGzG z0b=JQ_Hap`k@u)=eBelyAya8=6k!JZC7_!9Hd0G5xj*Wr(Bm-HcXSp{n}Lv)E7SKe zBtM}*%Y0I*#l_VF4{QYj<8cB00w&p$lYojh$^D!M;x+LI*AXLMt622Vpp+B*(@rB9 zqgV**bN97(b+x4yBtSfB>N0R8H=0pYG;I)9plvh(gb#+%ht1 z$?iUmHU!`sxpbPS#1{J0Ut;sCP!pEe=1cT$5G(@Jf77qb2Bs+083ZT zq8QM{CGW0JmY7Qgom9X#Y%A%El3<|0tsmoAPEs3YC8b;$2`b)=-ZnbxYGO9A$b4SX^kp4Y({B{$;KxxWHG zZMSrPibxpRn6LL3EGg6V+Zx{@)5!pgE=+jTNpz~j7;qXg=&u(~W$`h!tw`zQmVlw{ znZ}yfM(EQL@7B9|CtTTnp@WRV)V83=CObr6y?`-^n zyP13>3%D|Tmo^HrChbIBTQ*h~g7hz@&S=9L&qsYM-FrEb&AcWIv>zUi14hOI3z^c$ zl0nWWM$+=xA3tg%gxixPZ_jrr5dI5ZQ`p2107mKb3QhF1s8Hj1!xrMOM%EvH3J;hu z5&$30C{~*wqlC1ia0g=mwAj&mf#4#JMt*kyH^Dpl9vunHpcuNDE_GOEbt+ni%?wa{ zfjc1^mT9yDn&59a%0>m@XQQ{KSloNs0PusI@4CK-vq_Ok8vu%M>r*REmgSzIYQtiP z<)HMzceym&a<{C66MWvsJaErCIS2@)M@eH!yU={u&qb_$ z#l634-3rOKPxzKZ`)6b8LQrEA(t9q~e)dtSC|PB~wAi8oIYC{m%Khb7qlvu z6L&wuje`f$16I?8a>D&tGCYQ*nV)idWmoCPTN|&e&;a3RSxL!uU@-XPV1q^WI6(k> ztX>OuN0-*l-{N+1aq-*d(#}BoE02Ge{_@<)-~VKE&LwEOTzQT}J1HaZOj(;0Lkmx` z2EK92+DGqqMfINTC%4dZANV(0o>!I~-o34Af@#|Xz+8aI&fy&5#3tamx%mRN1uH9! zeb30NsQA8Cz;w3$g@(=QRO?CN*PlQk>qn2`OMuZ{Md1%!ZH6Hd0h1c4GFhnF)>GU? zEMlruF18yjfZs10%h$d~F9s{E_Cmp%fl}c3Lll0pbQZSIXz9PPveJ(_nw@GHwU{0q z-9Mt%7Nr=?9;|8EwgLv>)oUTp67`klk*caHIaeWRK4*nj4!SuJ&SM+a_>CB(-=($cUrbg23AN)H$}fK;NcYHvrV zQ=5?M2s5@bo&+W|H|RqaToBccJ_b{#X9ubl7V!0`s6!fCmXh=P*FVg=Of^Y(uwUMB zo!dFtf+bb~z)voIw>>mg(~T?RZ%kXDV&gwLiiDsIM=&nrYp7dgjueZG<%+X>-vF*RFo9 zJ32yvQLSe(2&0z$>gQ<_04i`{G2;Mo1n`nCb&}htq@Eo`3-CmRN0U8_iH&UBY1qw!m9Oqi zTEEPB`a^AOe*POVVfleo?$IAgw6Wb|^8*KfOL=5>{llxcy!!f?{$Gb-z#(OBeSPZ2 z9pLHfK$`Q8qNAy)y!_kYH4@At-~}+VOYF}Sc2An3$;g;#r+{w0y8&=Qy1xQ|a0bvf zA4^{+w95pX6C|8tOk-e_C!8Y!2)UixB;zW7apNjLaqjKg7g)z;Cnu-Bf9;b5o{4+= z>e4$U4-b!vjSqm^qwWI@)%iWl{ECa29$_Rr0i>?mySLDyVzt6zVgae*z{H9^?yAby zmjF2cUJ9S)ptAyjZc4z@lYSNjdO0~eySi6ZUH*x{qh)~4Z`)DW)3e~#;Wg}OP;eGv z%@ytY(Ahc3`n|s$&}f~$l13n?up9Un$cDbTxe4@-kmm%r2K>Id{d>Ld((l~#?XXwC z;1ChX{Z7zc{VOSa{r7U{o9)lcuh=`gySX?xOmw{r0C*KISrZkFZJc*4fb9MH%E(Ag z`p_42b5rwdo`?7?K|#Uzp~R{MPmbQ&W)~-7zfS#rJeTCQzW6a!gnj+hdD7+(G4KSM1lX1vC3DfAw7;BDzha zsvxJI9-r>MmeC&&O6bPw}{o z_wjc);=63D`7DD&ht~i^;;8^s*|wu4fsznq?u+ry>3tTwY**Ju0a&5@y(phr zLw5I|(F7FVKXNu{Kd{d@)oen>ev(A~aiPdAP{-bQCS_nG2nh%dpf7(~KZ=N9PL%NX zG`61s;8+;A{gBmDKS5SP%CRvq%mzk2H6AMf!l27xiE%s-v(>q;KrI;O%RSaEH&pT# ze?E6wlN`&}5+wDQt3l%E&r$?aUw68vHg_^NF4VZ9-~jTQ$^+6n0%ATZr}w&TqBoQY zSw5l=O>Qy!u&A()p4nAZ9*gBax!4tzl)Q?!JtZ5Z*SmxT4lH>4p(W7GhXpU_y9QE) z$mDTXRe)jswy>zIrluCd>{V}8E+{Asr9X|NP*8Z+-Pz5>#U+su1DQ2xzkf0dC?wIV z#T$J$bA`OT;uF*3=j-otNT^l-AOMX9!2nkH*5)Ru{m=Zt<{IzCBex$v+Adz9@ZR9& zkdTo%-;Ik82?=S5d3evUBsYgc*_xhYb$EEF7hYlQSSx8!R`B_A`EA+Z74k9y%$cks z#taRFaYWD9uUS8Gu(JbzOvbj2D`9|z0#fO!T|ic^JBFzdm|x}R=er~Vx%}DcE&lH& zfoAh-vRIW*HU?gp{6SNwK%J%8Gu&KPblQpFzMEfta4SmRul_lG(#mju|JKb9yy{oT znR$76Nl8fNnyl{;RG*0c_;FL@LSG{Ar8gA73WEZU>-6f0;-k`i;l8KGQ@~cKSf~V3 zT7X86*((GJyjdXY2zH=X($QJ0$WwPUtEj81o8ENZu{nFUCz|GbT7zt6ZvHYoJ^kg& zmv-ehy_?@Zw*&L5@Yqqn%7%P*d9Y1Ij@Z}0vP<|<0!x=UhZ zWjDOVDU}qM*jq>kE~~7`11Q|R0|WErR^1~x-LoVY8-uZsJb>}AbC=;~^h!WzwJ}!U zgM=?w0DyBJArJ>hJ_3bOP9xB+6!rvurKqApSJ%bDW$hbKF<+G?aiJiVQ!9Plz25Bk zb80TlZSTUoJnKLm9UB{)wQu9&`l@8M!`{W)FU0}a62$bpXRc#kgTl3I*T@@jKL8kn z$r5KgfJDaHIGFVD<8&-BVNjxOeI`|zt8vDj1V*|(6$ZAIhXEeAr{|_nzCgqCIKbG= z{@ncJJm(_}{E3RX%uV9HFUp5XGYCNhYwapNO0#>0@&8)Zgv0wor_c2sG6>Z8%5L@tHK)>3sT9Uw@ov zWQnZV(Hh;e0;c{;-OV*)t9wnmqv}3@?L}*f!2`#lUw;G4Bb}vxk?l&VkgW=CK2uIN z*aBvKteyFAqW(*E(|pC5#LNr}_)PUv?$p6Vs|sP+`PnqR;2x_5y-h6v%QYb({slb% z`T^jY9{N7S*>x|zyb;9+AbG4~P4n{dLdjWnZmO`|xua|wlT_u3Y6WsFb6QC$WG8no*X7y|@>YlqlJsB{Qd%Nwv91 zbX711)M#AOCSEAxn%ini<{5WdNI=xtH;u`M0a9zdIS8dB_2gdk$)KgVzLNu5x=BOW%_)sx8*0|hC{FH-mi`>t&Qzm>9>gghH@x}Y} zX61cmx6{UW&4rwTsDQmVUw`aso|J&$KD+_Gg;)Ogq1WNbZ5?6a5bDhQYts$!YuPnU z{Jg7>&!uO(spOq2H!;@j9@4*d1(1GBe6S#kH8lgS71n`hQbFUl=tF>TLIu!|Mt8odMYn+%*2Vvm0wlyQxETbbyXEwTW)DDhwd( zqj+^*xwId2xnExTPa>l~E!&t3&EOxre+7#`Q4F8PL~+*f9HN(bU#PfFLVc-z(RtFV zmbqzra`o%(J{@mud;zKXDItFRuHE8RYbrSNnfdaodyzB=NX9-@cEWhAQ`}?g>}!@F zyojU1-L-;EH>A+*uPZ@GG}4^F6=L?G(r(vLFmL?Zgr)un8tE>zED?q1xzIv$AS1P5 zlQ%?)xqkhDOQTahyGYf0f9{LVR1oHc$_2ggY7Ur#r01Jrqj$|$Sr+mbE5sb1772O% zsFrgz8u-=6FYk}XY(xF8UroKj2|b%T0UN#dzje_{bxx}{z9|@4%$%=9W{)-UIvS=~ zq|axT@A+UTon7I|bI)d%5nC`EKPYj8d_dS$b<(DmCY{@;@_bo{z5OcYHu1KR)WPfp zzrc3Mte;hP&;C?VzTmBQ_&GJMJig$mePuK?3x$9GFCt_rvt-jr zgmP_@y;4t7GNH2b6MLS@@6Ri@EYZm^W63t$Tv~k0&JuYnuqjvsKTV5_Daiv&Uocb2 z2*R@To5Doxrgi`ZC$ew6NiFa1U*r^GF}V1Tw6oSOp_wAjh`6fbm=hJB-rVrF@` zT+uIluw4<;7pxxJ#2ee1!!DtVNH6Y`aF^1De?p)}$I>RycY0%|5ay-x;++j%`No|h zC$X_!pYmN<%x%S%*GGzYR6b0VG12%3zV-g-Q?#3L49U#L#;&JoB|BYi`H&cWa$*`U zEM*QB6!Ybtb75r4F);$JK z`Izne;M>Nd1HzixiGDi+{1R%lt6Ks_m$boT8(1F)``3XxwqDP?58d!ELUvwyB;8|>J^M^?}}9X+;}sfRj{4p?fIwdYhf?M zC6NFF-QueSz!(H@t>1H9pOTVf z`|fBsqyJ6mMN1-rXc0to(Yu5MqXt3LiA3+cmxz|AQKFaVov4FRB7!JG7)-|pG7``4cRXZJn+a2T)m-uK>5d!Em8akEtT`4^&Y%Kit>twr2yTK(NN5ltIS zc7_Tun%!Cu)l8nsjPx=O>D(f|FCsM*O>sj(M{=Bo+XD>c^V?VZ@7AOr` zCnyJad}$R|Zqu(28+5JoT^Hr{R68kUMYrDYwohplQ&+ct<))Pd&y213q~7~^Ou7Kx zZ8NnXu2*^XIvr~tE zkydDZXi5H+a3`=L#-CK@O|J}hVy@`xf33^+-nybKtTep$s^vh>&#NGFyky=QQk_>Q zvM%HBJIUPrhN6fm=Z|a;a*vb`v|Nd5lB5T{E$3w?FloQh$MLuknK8^Ng zxh3~m(IqM^r(gX60wP(IS|L*n={cU_Y-g`7X4l{TR&hUfvI~uymnP@;OSlwk?RUA&PSSd@~`!VwuQj&KzSsrD^Pl`}nS4UwYij@Y6I!kx1>J4WqLFiX{eK_i1 zN;J8G4zAtASQ=ifViRJZE3GG<}&WzW?5kcFX639FFgy@XE8nrZu#_Dc6QQ! zHX+Ua(<0dm0!|YNH04c+(J^YnwAWmBv3pCX6JG;1xpvGzTb(Q;eLSjCCo6L{w_D`b z=gs>8+xNt6EQwo-t6i$V39Wr;IP&3y7)r=_WXRm{^>Q9H>>*u=?W%Ovtz_k%PwU2Q zlS`Z@B`oYr0KZ3Puo7(JNzf51_J^j5F)Fe7Ji1WBw^|aMi|&uRSi_32-}?F5#UMj11>cY3wna6GN6a%-!o zQQIUt1V;7Ce&52~=5fOYe}1>ankMz(rvrSCuzSnJ!u)RChqa+c5i9PBni?Pc-4v2` z9K%T5#`#Z*5yvN`xaFV{htX|udhv2xzIXX+g~7eHS^G1oF&LzU@Js%t#bW3B9w?)N zK^eVkOxMU}`1#q!63KbuI(T_nI}eKeEf>#<9+y^Qys}ZAnCG-@y;X!LjK@tF73gBBmc@^hN8(@T zY9TMzNSQ{pra>a6eBASBTHqNpHG6jRcToIdl7CyNjA}+v{H&%)4p;GBnZDnIMg{!Q zV|LkClL>GB*9h~~Hv7-4(>oG=p0x{0vzdirG%Y09#`5ECo4r**f@_U=9?r$x=A$RK zs<)CGcQ!-!61vguIEwA5ejwhYRR-Hm1xc@pB z*|ig)+m!tMZRP+h_l9ElXF-;eZ@7-ccyUktcr8I0ty~2(p+g*5DR2r_o^a7)4T0eg z@MpHXy2+|yPR_~nuvAEdW|=|01w4;A!{BrTSy|ubfUePU#d;RE)fmWS4>6}PO@49G z9Wjr|+tl(6j7T_+B_FI;(o}+uMPG66nKddt(<{a0hr4pTdzE!UYFkXzV5b599uVnP zPR|-;rx~OCZGJj#x^V)O0S$$u-BCzGtS8 zLEA(oZtm;$w@_GOU$W7X2O10Wb(jPe`id{Jni@H_p=6np{a<@HA-O-Ao)gP8Ny8Of z;_^!5TLPXt*-smLZjYC@L5pxP=uV%LldIxZmhpKbyOq@>8{LjtD7~(>^in7pJn?aFYZYuL^jh(7(rRTXmzdFL$dyfW#r)wJwI7HdApC|GJA4^g+Sg-d z{I|wa#$O3-$#bE5RQdC$Hizi1^hS;e>3QRxbvEI=x4%xaoBj2NX)(05@@rWbT&sOH zRdJIwl(UPTMA0I3bY883R|Jr&*qmmIA@aLizl@{ixlDhhT4;Z_6^ zH;7u>zv$<>(TpIAQ7lZPbj1@lc&jKt-b^eGOSLH=jJbJ7WT2(}mQkO^4w63}P% zo3UTId;O03bO}6M92ofSwY}{pQBgyTSRLbZ`4HfbPCa3pJaNdes%P%nxrV~3YGX2n zxle||o!ABR1D+@d48NKzTX1XH^SO|?w?JB*hvgZ8^1gibp&)NHOaxsan_)FX>?2|A z|1w7lml|78Xs_*FHmrblr~q!N&jzhK>22lpE`^0KcxPImbpese>|-5k1JdZHSu~Uq z*YY#4l^Qyc3@JIYGvgYE+fGvZYhMLrLDst5_!XXjp=72zp3azd zsNRd19IShwdSW&E)>O4d`YhbvD+~m6v*}b^We%f$0c*~jfA;s=wi9Q3UZbKh$zjFT z8y__jU1y2C7oJV0Q>CZecff@UU<=9eg7D51V*61Z%O0<6wpNF9PihbzPEoCg zss6qZt?-w#M$}wo_QM3;%LmoOTgSNH5#HOzQj&V)>SXu4@yEmKEmJCEai=CN*&G|ILcBKprj;`JA4jPwfmGr?Mef?8a><-g1-R}Z z{#8oojKq{vyei~C?PY>im<{e3gz-4sZGAx23x7Q74)K1IGet)5E#@+SMZ|BWrna++P+|wZy^UCJJx= zmk#s%MR!Y6eH+L)P>Yj)I7nV2WXC{szKwA?kb14<}{3oKjOul3jGm=_)X% zLuQe~mngIo@{p<%(DGRz1BkHk@Cm&0!!1vzRGe^Y#ne(Z4#fH%N-fU=u{|yZW)PGq zyNFt8%-U}&))$s&Q7^*rk~`!+Wx>fK!=eln`DKR(lZCv-Wd`J`!wGkf@Dr|@0aNsb zMq`|5*;n2rFwVvzGdH~n$xPGfm1(86ISSGo!!|jF8!odd6qSIqWpB83 zlhHZrXQP`%Z1|m}U7L3)#+;jeC>;1$R?#@RI%PsHTV|t4F)v+2e<5CcW@8X`1uG=! zIB=$_bB1c!k3I+JjyqsmP+w&0UErU>*xB`Wi^6RLF@@O-N)D&i6{kz$QgwQ>`cB!_ z6!Ep2#Nx=ZAsOloB;=)(v9iB`!MMhae%n}|}Mhk(phK@9^W=v}0#(T}Z1g^I&t zS{;0k|L(}22U-M^1UtbsS-(cYZvm*-(J{CPB1);pGFH;@Y7 zUwr!)u*4s%1?;Gw)x3;(Yl%?Pbx&s@m^{Clw-j=-rnCuyHL~?-`M$)M$L!ndcpf=Z zKPy`-o=MB9emme2!$3s+*6_TrB7ZCQZCc}5{>zw)L{};P+0!gNe7HuP1gH(YeJ<08u)5GymgVn1)?B;yb=*z{aM6YV@D{~tCt?Rbm9H8r{{ll z$t=O)2~5%~o&5%Yf8TulS24Sl95yQq!~fh84)K0K#P{Gl2;dX7l?X7if5d#Dp?TbJ z?shf6U3qJql()rE* z^1m5j;I|H6imbkK^StDkWqy8pM=!qnYBWm*h%O~gN#om)YzDIT>OkZTK(@BjcDSyd zD08%aZoW<|yWyA1Z+@QxwBOCTET!!dE1sy^=@rL|F>G{UJ)}jH> zw#@&%3fr(Db|#`%eHEs9etT+n;leM%pg?OI!loAs(eVV8&@#v6B%(di^JxUA;OGBa zl=%EE?<15I!KK2-Ra(+i(A3m4i(z>Lj=p~MI#F9s&#l${YAJ76$88D^lW>}DmfIxg|5H8Z%X#tq`IOtr&febMeq218dh6kE z9}b7}vs;<**;Io-ta#ZuIekvmc>$bG?hU> zTM4J+bl>=6qUh!2)!5hw&=vr`8W8Y!{NdqYYHDhxsuVsYOjA>{-fs4EK!VeKbBglb zy~KR>K$gc$0i-FDfOyl*5l(c_9wBIm5luxx%ORROifLHc6E)7jqTS}Dn9{;$D1lc^X1h{ z1wcw_ZSk?_PiE@ji)@~nI+%ru3EQYZeP|4AhtJIwqrEf1HNw~D5rp`pxiQ_GkEU`F-?XQf0C0Kv?KjaBA6fk zSeRb`kCv{cfIuTdP4?6D`=}boq`CwgsxIYoSOhVz=pT zxjtqG$SdnQtFGcKW5e{NME}JFs7tqLR`)Y{r8D*#qM#hz%LgVpD!mtgUSX4XDSiA6}&q0Na!3`!CAZ_{8*t^AXinS63UDRie&0H9|Hhz}1MT zw@o!SF$wHmV6QA%Re(}yf6f9-3$-sv;4(;*;pMG_>30PNT_Xlp*AjN3g>4b7c)q~_ z5ItG%2hXE*FuX%UL-Y7kWMuPp7i-);X4)fL*SNn9WlRA;iyHUx!4=x@R{sAE`!d87 zmNY$LmTFnq5&MVw#>L0KeVY>zagb*I5rz81dfu=3T~SBFxC%U_*Y2`Ejx#{VeJ3xk zcH|X&+E_!wX=kL^Uqr%gVr0C={7YgYVEgz#J`RtHA|)o4@U<6ck_#gnOp{=fmTsLi z`a(iu#-^@=8aZrkZEC7{GBiZ+R|pC@x1RuRDV4!*{Tj-xF;@XRgo>h~E$^1`cipXR z)}x(JF9tvX6XDTwUhYqkIi1~|7REA^wO&jUPe`Dvn#2TN12A$Aq6f|JnFMfDWC(jT z81)lE!BygaW`-Ia%_!lH|MLU_ZaCvH+X7YygM{~n?-$aJhVN1l0B*F0*4Jid&!O6m z>jVFu$!Un-XcMX#s?^Sz$pzlDtadHeo3#0w4y!-Ldw(TpS!qs;WY& zNbJEuUHjaBa62Ay0WkKcsOc&f3sqIsO3Fv7sf*5yEUM{(RTfW`)FA$UTYV-cBmo~D zJCH6W@V%Ai0TWZZ35-$P*AsLIVM55lTxO=kAdpXhv*%~$C<+ei0#oZqbDfwNZayd5 zHha*1t#nY=V!a+iN=h0P6*XD!*0!YKx>s}!+cqm0Maeni77~(Qm|u6M41sKdCHOf$ zo*Df+TP}l`oKcz!Et%#Q^WYpbARVuxq8f9eg)$5|2!l$KSlPbh5A9 z+cV%EDh6!Q5cr@mlcc0?e{%o6_&HMx-0l5?ivP5T|38d~{!fgj^9kTndHe3|2ART% zR^=cHumvV2#BDDrs;DHG>gfOy6cm~k7e_}y%ZXO8v-9$L0flb5!{VJbQE69wu{qq@aSV2LvGLD|x``F2QCQC@7G|&VU7)WbBn+ zowGAc3sF(=U2VVSEwy(@Aw%{&;XNRIEP3##D=B_n#Cf+J5YDQ&)`un5HU^epfGME} zI6mI{<16Bf-iHF@Vi{yeLBLan9e0qkB9foH8!JmmoW*W?o~>Lvn`~pa7X8lzHOwFS zN@opP^u$H>_xCHvoHYVt-|@TBYX4|YLfm`Ag2DUo=V%TNPR`O27C`Zo!vB^7r!-I7 z&~`Q8@lHoaU5#F81HMLjiES1c#afR7&=E1L8EMjMbs5TwuA+D57cRw6P|O4Jmy1B6 znUJ91^5XL4%;n|9^a?S%{7tqvW`xWJGmU@LWFkP3}rVj|P7@p&MonZI<+9FZ>eIkvE% z5F)ST63_agp+iecOFdn5sPTi`mQB(yPss0h#=D(2clEU%oAH3f%?)HfA|J_U zX2mp!MS#zd(B&g}*Z$!MT>e=OgEM~riAXA4_}|rZD{)9We)A&&9ANN`qoKdQn!7u! z7elqrl9_gKt;{cf3b0eJZNgFJHRZ=|aL2fHxb|d=#o(kvn?S&6vvgEV;Z!;uB(N{P zx;q-t(}M;iHcBjSrl^UmzJ5u^=I4B*kkF+K*T4T6O^%R=h;sF~9flP!e44Y7`AR(y z2w>(z8`pwJX@zU4cnm#pcrW_f51FKyczGR8_URp32<|>}QU_DhnI?cvL@~d>-M6;B zQ^i-PrDV|Kb3u)%UG z+qRc0jNr$@KX-o(3?#Y&zoIO^|EEe!Y`j#ra#N?Uu3Wo%XJ;p!tPr(cURlYQP;u?U zxsQ9#sq5+KsiTvamzs(UjMK=?v2U33)|+UwL8YpXy-utHU3ifAN8C-P6F>xibTs43 zU3w{w&(ZGK@fxdzM>Ji4E=){(6A);cz4{V+dzBz5DJg-juk^I*{0UdXI{b0kx_WE7 zqe7%nq&!KSz^%KO$jgW39fxi@&HtY3P{$wk5Z9VhcNuxiSltJ-AxBHEc$)nM;sXp1XZJPG4XD5?WEy%q*XzIEKb_w*axQv)gTIu9hZjH&JVaSqjZAH-Phg zhClAB_CMW)DuQWg-kh)*Mj|a#vReJRqopy_{_Gd29%M)xt#5m>fDIWH5wY$?6K9p& zc@nYGpTdp)JJ*qtt3bZVcl=ML0vIV)8^FyBHBrgne=%&}&{FemWne!yFr$Iu&Yjk6 zT&0^&wuw6z5qvK61=v6hPbY4a-COsas^-#5JZ|mX^Z*QcK)@_iNugu7ZLDD&E9G96 zmjQRrlA6robie4~TT)(5Koawwc4h_0Y5Lo5e!Z5Lo^A_aQ%mUT?5vYnJ%75I3=ZD2 z(}REqJ?prM8d*klS($T>{N}aZ*a@~05dS~jxB)^{&_udU_xa-5+FCvK&rtcd@;afd zHz3Fpu;~AsPp(rb?Y@_6rsobP2xNJEW1L&Lb3Sdz0@Y9x(Bh7{IpAHsS!b>@MhyWG z9o#Yvfj}5nqU>Stj*e??-{?J_rt+KZB(TR%_Ql8Dp(hI~TsKpU17`3q*_#LdWf?E? z)PwaZbTIAVprWE;Y`@tq7j`l1Vj&jL-}P$teR;D4z2fpfS`nxm$0FuEb!8NLpv+I& z!58_|1CScu-{6p9&V4f_3RxGiwQd7CyRd2Z^`AE=STHj!Cv_DtwL?8 z6E@}G;Kt*ipCS*uE6T5aA||HSO-)_B?O?`7 zEnW0BEro=;Z6e^uFGjrw9u6>Q^&#Xk_!N*fjN8>OCYWZ;ItU<6N!>v6BIMJjIBEQ9 zZaqWk$i?$-I+gFy@=N0n7wp4??Z)Hc)7HODo^A9&IoQS4NL;RNMy+pqgM5^+NI=+U z19YU2N(z%`0q*DtX!v*t)+J%XLLEA<->?A|Z((oWq%v2ZxYyb%;JobZ)dt~AQI84u z?em~4sdykw5BsM|;9G%xyEgGfR-hCX;62ybRUn_#C-m-kuhGT4ySp277o5(;oS}xN z=!$khqzx|CB~uG1I4%qHx!2oHkJ-g+fZ!@d=ID7GLa-aKMHd%+cY5yQJQ(f5ru{KO z#H^zz6lj-Q@*UmBOrGU3g0rL;Pc3I>{HDq1#WbtEan?P~qI5?`UV*M7pkW2SI|$2! z1Gwb5=kveN!$$b;tC{jK;Y~lY>!I&QFyckukw1eyePWhAPLs~qFA(1R{K*#j&F6e0 z{xLN-mwz6tJORwV)ZpEF_kQuQ(2M!zNpbwa>`ygME#{f_?dYOL?qYd28~e+?etWXTNAcl_Jsxm${Gczq|W!HdcI3 zQe%|&9u*fCqyJPb5PSd^j+uFP*Lh)nUeXx);>A(6T$qIVP1Zt|Yr+}p+S{k|%8mN$ z;F4xC*3>rBejtApln)B>3P9XgR90Nf&c%^1GB$jkXYGpv`vIIN3y#FIBlO&AgKh$@ zs&jhb|5>lWKSMzD{|R|=HN=FPtPqKIOs@ZaW((RR&8b5n>6eK9BD<=&KugB%k)L$d z(!r7M>Aw~Zb3L7+u&aNS1V3B^3*SXF!$d8tgJ#)PR91=(BpY-j9p5H5+zpa`{7(%Z zN4~AMNJ+ncv3!1+rLbe}rU%@R2X6N~5-{F_6OnU{;&iuf@BELZ5eD_5Yghh;|JTZb zcK{PHZJz_!_@ca(gOgKJ!&6fmtdA~GzZKT?d~PXTKMttBAO@JShxK&6094K=DspP@ z`5cw3*_|U^3~K>+IPnZMq@bTPV-nj1YVqtFiezET92^|{{KMuoK(!rIM(O*E?l2a^+vd+dxSZ9fdpb=!mTRPCJEMov9_8^9em(ZpiEdZefPb3smV=6FfRT$*ULoTzYMJC zJ`0uN5$|7i3|0uGTz=mF%SFEF#48kV#Z66v`4?n2p=9v1Mgosob=n zb{31ud15jYE8HQdij0gQZ?pa&!Q6TVpO~=Q|M*KWtmDbYh0Bhtv^(!jYsMdr*8qBe zVrashcU>I=*Nyzt_MP*$N{~1n9^@#8hEOk{ScMa=S2PgSN9c zR2-9Dp!5zTf z2062MW#jSMUZm?v2W=?^{{fzgB*J1nk*Xcc7r?UE6}AKks7nhXn?uEsh8PmpJCKu^o$}wO`datSQW* z39UdPhwWQ%iHT!lP{JB2Xy!0@`^A+jSGKpe0}BgnY|i!ysjjwA8HR&q!ze^=cyu(G zBsVvw&n^Pytpn%sUod+5W+==|4;`^$Ea!>YMek<%Bp1*m-J+pc z+5wGXsRdR7QQr|!BoO|xH#hlBkJ9eztEXEYqYYFQdi}~7N?jyO)D%ET@o4}lP^Kj5 zm?NR}lmIn5Y~zg?DUVqkkRp+h*;~088ykCeiaitO;3#SNSzU&j^?au&ksy*x+?aLtR#D<6pQ_75ZLx_-3;vr<#qpa5+`I<$d(o3gZam{~kJ+d9={Q24xGa8X&l*%$RM>kq)sNe`tPF^GZvFlW^94Qk+@I+hnq|Y}K z&r+xnv_GA){S0iwB_{3H(49SHBbqe-n4vH>zRdSvCItPG3u|ER3U zr@DK%O<{woSRnVL)>K6xR9Ef|3kGoLjIgk=o)=>rJ3^zf8T!8PNJ*&>sZ{ zYfRhrSec%Lp&adP61fUKW{L5{ER#VsHg2T+Hpc{f~}elV-4SyHG1?@YNEW z?!W8Ryi~Y0JM;2vej+ike)lvh5;+I@Pgk>;ZYb6VPW|}%_WXFpfPSTqF&^R>AT-7- zxh(g$?x%);9Iw3G?ixA0_eln2p<2co{s%y>!Wf#{T3gR+?HGC(Z<@GSc;Aw^`}`qL zRd>c8e#)dzDKIgzeaI>zRDo1G+jZ zTii{&UMvBKC;%(vVPO&T#SAl1a{%cBkk2_~jz!=EVfv6Y5(9@rUwK_Q#5evmdWf~ekUp}=ReQNl%~U}@K3wrZg> z$#~NX@;#)@Q>#El&l9IzDsybvy-y#P$km$t_3Pi~R%m737A|%%v7=TWEZFbsY*}UK z^#^Qf>7F2m&_Zewq-Q|~nQocq!Jq8~j6yf)LN)SE%VU%}eGa3NKKxDq4PF3vGR8gY z9!4}A9!}afHh%l|ea;a8b>~%lM*lqx7}ZR`YzqJrIA?sI!x-3fVnX`J$VjdI^s$JK z!LsWop5sp9Ux*&#TFas2eig|1JUcA)5>6s`^9f-Lz7KeK?9a|Xr7)~pW7_AEj9ssA zxjQSydNluwDbRp`)Gvh-w;aq!gc4bO-nu9va!??`Bf=D%_*t2hHJi2Fm89V!&!4V_ zKBLaKQQb-N85#4s`?$A#aU0l`xw$I&8iAUL+)>|y^j(Qr-`!0gEcwwxNPxh+d1BI_ zl!?8wk~0h4OugMn8x?Ow#hRcP65|ea!F{25a|U(ZPYSFHFUm!zE8?NUH@j& zPv%XpB3=MrWAHHc7b7Df{wQ#^^@K7{$ zfPiw)PG^~v6r1V4oMLg_ahym-FJ5cCR01+w==whKrkZn>`&uzYL>IAMh0Lq7@!@>G zGaiyH?wr}_0yS<4bRIx1D*n zhSogC@3okS@qML`Tgz!|yXx5e7cfM!hT8QTp|WweXwYcjO1;(w1D*t2=InEZ^d#`` zKFlqvtu@7^*3lb?@^W(p%JXhUj6c5Lk-h$IBk%;fdqRj+%quR2#4c4=4}-5HWA7tOCzfR2 zGMpsXf^ah^l*PrdOSpprvo%eg zJ(K;A3%0Fi1FukBUfv?2eXsy%oY+utC97Y*5h9zu3&;x~Fp@g^5rM7ies2W#SXnv2 zxchj^AGfxg%#$xhB2px}b4mh)Cf8dnH@2S{y~d;1#_qEVwe5Z$Xp^2L48TCm zQRVuLt3k4H{QUgOh^&KO%mIci-m1QgN>&gEMBB}67VCK_DJ_1tgK-9QKv!6`zx=hn zefQqo{tS@=pgHD+pNNDG@*uxI&TkdWLM?bLH?AzuMqQo#{rm9yrGwJ&;d>;HSXj~< z98H{@wl5vXSlVx00;-ScY4**5n)g3FpP2Xn_!g(l&5bTA_{BmQk$?o@R!h9pEFtTjCW|IP)F@W(eax-8?@P;H;s(hqHJw>65i-D|3#b+DP9-DZKTVd$|S zE=-ZKF&Cw)s3_JjGusEP;$X=hSDqd8uw|uYb*2DuLm&mW+GMO{lzZE6XK_A`J$}~j zpe1|MCs`(7h7<)=xNc=>dHre-J9|%KBWU>^JnrQ6udB)V09HJAreKeCT^A$2mvhz8 zby^X7!GQ7dx%|PjfFCshM;$1idLzED$U)r(mM85eo(iL`!y|MOS^+E(wpod++mu^ZIdq%}C;DDxm+bvHbla#0 zdqB)|KP`3MZ3b{3banK15F%*-XJHDF3_)e42p+ms|w_)0>gd>ga@a897XZaGXh2KN|>g1H$BXN zYc1<+XAda7$X}0TK?6CH3;~P%FS^F3Ku)NW(G4-Go1b53_vhO-uliYCMMboWbim9F zl(7#YO2n|uep!F$kYZf#{h=pm&}2KEqK5qsPXd_K;*Ln=w)mLyry|$`3cHtE!5S z6NPi-fy3$kf@S_FxZw^3w(;Nulvph?yv&<-qcpuSLb~Xt(;d#r)|x|lRTKq925ia| z`T5c?c#cv5zM}3ZY8-%ZTVS3{SX?~W zJTU=aB7`k#Z+|jkVQ}7Hwy9%kEBKa(VL(RX-00Ytb!uX4iv31bY|0UkTFdks(CbQA zDl1cw-7D#Br+k+#nr#UXJfQUvgWn!Pq`~;Q3e+;1R_hHa8t~P;x|J2B<;=mBspo(% zkesqwj@)U(`f;DWZku(ed+o0C>L)f$Yy~#!59jIwM!rxxE8yAnShJ&gu)M|VHa_eQ z3V1j57bJc;-G`Ce%~Xfn(tQ0nVAfBDi<7gj|JR=y5A4^>7mTD1Kqw7?s7m5OtiV@u zh;xTl-^EB(nPc>gP!U}*@ZAB245uzMz|w&G_HpQjO=7?ZrI;3r3o~z$uieWUzQ%AE zAn))cyT}qBuP%A-Y$t-Z)pt+5iWe9@a8mN(+FGi@>0x(^&%uoWs{X8iC2id)?>+?J zNgZ6pMT;a8=SAF`E+|=>1eOWNCdg%f?ptcYjHPu)(Rz%VCADt-hzJtbH~fG+8cRFF zuP(&68F{ci0^zunl~pT+y13K!1DUsqj-nN9oBB%Vnn6kUB69Fy>_^TgPD2=26em~n z#;|gx9l3dW)eG1R2Mf9mq<|-w&R9hj5VA#2I?&4aPXWm*!g87e&EOuD%$ZfQ{{tq| zQ#_#9WZXJ)-k$e}KN6XPEAYKxWqm+7IVzo{wv*^wXvAJS$n;)ghx#^pgQLxZj#K!$DjGI4jZgvG z5m3AF`)M?8!=H#N8<*EOE1PzJ)}CM+FzTvKdkSvbL?F+o+OJ-&g=NNHtQyA;x)|IQ_^ zQQO82nUew6a8tFhu_C;EN2p<}wVh@}3((z`y-qt|aGOZ9o>ckTUM&4vw!S<037WlP zgS@}mmJ-vhGbu|Ozx7ShY})!6(o}IadnQG}sQwRgP?pxXo1d4L*Ee*>sDjEEpSHbi zDoQ8p{Bbsm3L8^WQ7q>8_j}-_YmxB$OOJ#KGSmAbNh-T*%=&Z|9*v4lxD2*^wVLRs z5hzBxbOYHQsQs&_2xkKbK$6&@CUTM?I_@`GH`1u8GLmyMGRd*g@ub)bW z#W0M{%W%pn+B|r3ioPuA$%{V&2=V+R@~rV+u_4IpTO*r z(zf|;cP2e%+FeGhFB}50WYDO!*BK#@tZV)2`rON3_;uvSllE3Z4C8wCN+y6VT_&fVGJde0l;wIV2Y23IPozAt|MReBPFMf@77RvmlOfK zB$=}#E7@OrJJDmS2P>?P#9{W+`(3mSp|VV>$dc01bAbpWlzK9)jb~GZh_Fx!Gy*UY zQ=t)uLst)@6|MtOi@V_rQqGdCGn%{XC#B?ay>G<~=q6i+Q znUZWz+Gk=NYm3IFs9(2KZ8wtZyVHH#PmBJ=7obB-)LlP^ekSfrn2`N==C$gv9YE_R zK|AJv@3yJzK7c^fqUCe1t*`Zym;I@;k!F%cHVDbd`2~43yiiuQ;iFDqfn2|RGh`po zKK};EJPdxR1f+IOUMxhM;*;7o|5W9kgm^U@D_JFxe*@C>KsqK}t+0fnOSPu+Z7geX z70}foU~}fq4densB&dK>>?(c-)%N6cPFeY+bI@N?%V>Au>=+9gmwcKTj8L2$;-ov{ zAg#N>){jtBXPg)(rz;Z7Dy`mmU$L%Z)7{ULhETd*jFB|1sxDEYUE5KRr(Vq|Xe#*j z^}BTqDJI$Hz$2B!<;|JD>_^0mlVA+kE9j~@)<=)-ld7X|fK-ty@dM+0TNZGM+>8!9 zr6?)kzE-Wh&)gX`l(hV$jZiQL>>m7^-K4OrT3>&Eq{FzLhEq}N%)&M(lCG^;gGe7F z4X=>3+6A9XTLl@J^7{0NBFv2xl#t+^h{l~&YusK75Q(Ptj z!EQ&rh7`UcDd zkxPH`ILL$&mSIwxDd`D$HWLiU2lBGN0DRb|1bQC$TLq)4nf+Q9NK0b+(o&VKkGGT} zi8Y|m+2P^0HG10G^!g!@ei;@4G~7t@8q)fwH6o+R*T-iXSD|ihINku9&2D1to~!J~ zCrw-x1qF}plCeD!7hCE2+K`1`wCI9?9p*G?2LsxPIH-^QS}#8OU^na3L)8rtaC+F* zgq3Gk#d*6LRjx@wY*7`{!MC8+*1pQ#-c1$jM!gp?5{~b0-GLfg{naWk`>u)G3(yDNE9v7 zQAaj>TT&m-3@a)arIQ5Wz}3JGqzvizJop%5ILO+m6-KX00EE5UBN66GJ);y-E2HFb7{P#hg2zPTVvY6#K*?7nk$WV zW=6^fL_@lFSp@`wG$(%lxf><#;_S@9;m*p&TB$Fzx?|a;-!nH5JJZ0X!%eTQhr(%d z0#)ycVnFHOyUJy@VmgW0riR@7+Y{z-bn8r$w#GK_D6c_m>wP@iD13re3%4 z;I$ae=Nz>3G#Vq1vesw0qd^%WAgofE@!72Fj~mKpl8}m!`csngQVGaGySkX%SU^3~ zTx`!2q$a6&UFAHGJ}z@QcxDMIY*Md%zEGE*1`|2n))-bV8fuRp~U2$}af+e)1~l zRUjGtb~%svF>t1bxr_(!Zz2|DMV7uvQJ}awL3BFNa@v(9*V+s=eCj0C(a`A8b1R%PD z*QCc~9g~rx&|AIKcb?+|$1DFdRlw$6{$l+8g+OyLy_BJWgLaVGrssOsI4|}3ABb5? z8mou1g@AOAG*niou8!I71wl03qj}E#TfMs=bjD=uRH38_oRVt64&uX;-!{AUa-6z^ z^T4K}f`^w^9ReBX9q8>HNPUuv5AWkWLB5Nrd@|Z7R-JR7JiLrtL`;U@j1{Z-@xp8W za$!i?&gZ`gdo)FEQuTag+aDE0tFcda`;=3qr>X7jXrDVrTfZjI5`|jUUSk>dinDb1 zko{Zg0RO;sM4`+Nza6LB^+xE5s4rO(yeN>n_VH$ogGB$QJ>&-l_k}DagRq zp=a*c2chEJIU752T*^ZV8<8`NbFosdciF>xl| z^tC$9dyUFjv9TYTh-rB4UxI(w&Ywsi3BJRi(*7f}Y8KobVF;j6|~pCnr69 za;I{7jt{%6=y*%^Vo=$WrxRzdOESW~)5Jfy>hoCkBkyQ8&199|N$WsOXyh})4vY7s zl?4Uz$lA!gJwfOMV0GSLn)KLER8!l@Kh7DlbQ}G<{2+F}UD;?^r_;E4pfaRly;P?> zCqXSsn46io1MO-*+nU?hsAVSm&Io+)pyK z1+iXg0nMe`2p|1dUtDRYJTKE=DQ{%Va#FtoQScDREvPHoDJ*T6gGDJMq=Wa~R0nB>{t5h4$*?TBA0*%jnWDuh?8BM{t_aCZVGKgq_%1{Ci{pOIZWLy+)`+P<7>8H z$99a)oIBr)ooZey>G~U8kc7|^U$DZq5+bWUW%P*{xei_Nm}<5B#X59c=YTafLJ{92 z?%!p7rEOHZI!5cz%;fKK>-uGoZP^K@c^NS)q04AMm3Y0s*Z!c`uKfYpooYCDetv!y zf1GrNgPvL4<)k%m-U3>r}lgyqKn+F*U;dbD#|UaMJt17z{|fi;JN~BgP+gA9a+GF7hNx%tE;cCudO$? zuwY{mjXWCn+25#p&4s2xgA!zUP`Y~M`tiQqBzwMApEyDG3m_H9*4xcYn4OvR>E4nx zA4oQ7er=@V%@n*bQD=a{fua9qWnr0eI>`ate)E?o^Lr#$bBBt!`j%e|_YeNC^vuuC z2scnmkxaQ&-T4Z=o`x{E&SaM1!O6*)TWhlvs%AkRlIee38T{F%qH%(slko@OBxKZ$Db}jLi{Kb>q0Wi-%Df4Gxvd%`?Z#O^RIZv13(e02cvL8!& zdznx+=rj$FK+TDzodNOPNC|tWAV8xI6UzFg| zbR-nAf*Ewy*W0#@F$RodIvaKo&)sq;WEDkoM1&Q_?5y>U&2lT&rDNy}?nJs2YH{}^ zQE&zMRF0iXJcnBMUt^K|)pmNstAqwR%0LnuwA5_6ii1qD)@48%UR%4E<`DY2q7W){ zjokj!yoQZ+Y0_i%%NkCfI}r#FI?Vd5fQh)gvOSnAqx+oi?>Fqv_Kl zBh7aOcUX{Fs4VE1<7?e8<~>v#a+{`p?Kb*FHyzXyq_cQML{^poGWSZdc=KgTReiAu zBDD^bmEs?%HXnnkx29%X+*FdG^EP-q;240H^OkzX3vyid&9ZNk7;tumOUa-`-RlAs z9_h1YmuoO%Rd`8n$ynk&sQyF=_-d9FN*+p&h_!uB6DIL;7Gjs`x zbhk9f(A`L@gv1boLxV~TG4z1aAc6x7B`qy2-Cgeu`26_(e(&FR*3!jdF*E1h=bRna zzV_Y?hn~hwzX34n>C)QXUS;~)ntf?aZN0xQ(6@ERiSHd?cV22~eMrdA;k8uM9?&ga z7fl9ey-(}BH#@p8wQ~nDG^K5J<-pPOUmEvLNK(U-3!Cb|fApT+YaOM>0U$@Z5&;JF zj^krujU?QGa+_0I%qm4<+D*g!vwtdj6T_r3iByyQ0AX2JSz1|H7`<*jw$AXh;-@$- zYryu49WFVwTfpcD7Vg)shSBVv?3V^Ls9@J@hphtW)u)yHlii(0&$cZ8rpsrR3yIyq z9NZFS_v{}5JWtlX<+B;Q4OR}&)@yOCyu`_Xk&KWy?=i7kn7l|i-9B_P#t%5U^eS_V~)^( zKD}x(x_!qk3}9X!{lVKfzktWHYAHXZGj%>$ERekXQ9mwuv2CEJh$%|p+o;_&+>U<# zXh?GJ=cUKxH-MP20VD<2v!b|wDLZ_#l%M=ALV*NcviE@JQ;EceV;%|kLi%*$AHiL@ z@7|R!AD{kii4}A>^KF;g065!X9|IOg3riYTFzj3`FIxq#;EJP}_uX1O@0x#qy4d@b z;T^a-4-9JoD9g}j01i=$l^`+Afbi@ABN%p?PdC#vBm!iQJ*4FMDFQZ*NlWTycj&}J z%|LtepFTCt9gO!pJxm9>yUPvmXT-iwbkQsqFgbf@b$M|POkP@|bgsVmj>}!W^&J;_s_DJ&@PIhwf~x{DI+Qa_)8$pIsU`~cbz zFqXp9e-23DUtXNjCVTts76$=+P*s5e0`DdN{HfEcuv!NYBwqg!l1J}peg6ajgEO3a zfte+X&=|THr6jJ?!=~wtUuq+lhe1I>K<3~Rzw5hWzRy(`$74$6^t=t-+(dcr)>|M6 zFp}n6yAAl}b+bF2v*Q32hUR==?y1rI*L7O|qdo-|uKJ_d7`(~A!@A3e%evUGk#oKz zXF;dhD{Ut{=b^~TBsxN|`beO9Jp_mowi!D~(^KnRl~(U{J}N%0)rX~UXs9rxf7n%1 zNY$8?cU9UZh=6NyN!vwgCesaXJirsTd>`g0&w@p@Yh$j7A&|5&Fc_Pm4FT7hUEGpt z2a5H?<9exqF0O0(d;zvstQo(DMD^Sal!2WVy!=GM6M1)(Y%_%lI zuT;###<8mR_lNk2E1dw8k=U0uf#+9<)60){{XX6s8XK!M&;RmWQ~cv>1Q8A$?ST(B zU^+WH^G^L6TNqN>e_I-bVa2<$fCk@Ay6y4NP#DV;YmR3ch zdwnbfssb*K5EUKU#U#&W4+Rtl698J@} zWa~+Vjh*EIt%fOeP$iIx04OS6KA))8#HO%R($)D3s(+b(85|l8I9^x@I6c^}9zV+3 zwnQLGT3Z1U1&}|Qs$5Rv65IRr8}9?7!oolv>Eq}m%VRUgb)Z{yZ4s-*XE+I|TB^FX zMY$f*-mdX%wsRvpqeP0#V_V%Xb|2%cDP^8c*!bfvW`65jr?Jj@DU@A}Ug?l9;0od>1rSVrBQ` zrKijD*3FEC37JR|n3)u(EJj}~WsQ4eqib_xn}qiUNGWg8@y3rP zu8#`nnSf>H0KU}^93~To_1guYe*uNzuyQMvk$5Sjv`%P2HTWS&SV1*VBLz+0?`(-0*on z#9V+yrF+YOLr^C1jsP>a#)^C#%Ob0j-)ggLL)Fadx6df=`~Umx)hu$zs}*m>ML6aN z46NC#%T??b&IjV4MB{dP2^ZBUJC*3Sj*lNYb2^?JF1@uzl0sE*%|?fNyAP9?~%Qx zd3$XJjp$0?rXR}cIzHMEBh%E^PHb;9a6EmRe+*z&`9P5d;d0(LYOHV1K3|`>2e{1< zooIfkeVfXf8b?E!Id|Ghj!WjjU!p$)X@IK%ijdxSX}FlF{n`I8Q$d8#Is}~cC21!{ znt`*s`_-To)*FV~H>dp$gug?fr!tF) z*Gj4j#4W7Ws~)LX-^#FM=d%Pd8dfv2UkpB>aOF_V9Wg(1$ZF!T@q`>#Ys{ z*yR+^cKW(96f4`9kpk!T*sZtEZd1!)@pR!|D}ud9X$ByWcPxI34-`~TJ-*qWm5}c< zE+Dc8p)HyCcL)FZ))#X9g$%$H)GHkT{L|n>%6w552H4(@>^m5--ehJ)D6ldFTn#A( zUfH)Omw{1RS1&To>n{R+GXMYkp;g`#i!Ou_7{rjrsAXIVuzmry6&)?hkGbs}#?@LA zW8;Bw*OJ>WyTPGL4iBtV_nk#hdp&JZchSDP3S&d&+^6! z8^XTFnAYvJEkl}{m)BOcHr;f&dHK4ypukqW4Iq6bnYg*y0eOVZ#(-0kz=fe_Pt2y4 zvT(VD&)muHw>|#o-6Ikb7X;K(niiWnUkncxSOV!jCWZPvOreQ0}H z$N9-V;0!k7t6q(Bz`~OI=VkF%n5YnB?PRr7Wk0vX@Nfti&RXF#DXJ*{{Q2|1z>8D? zdk^DHR1i?o2gEVJ?i{`_cHh?lDx82aI^+7IjM7GfQjnsFi3z|!eQEk53m4&`zO+J# z@Bk3(o{$h5eoW1g?*Q|z_xVLVaP`J&U+4~@ELU}<+JRcuv3JdkRjWYq8lZSl4c1&Q z>UTbQ2TcwRQDppw_>mIh!_BH`!LMuMO{OeB(2i-1AR6)BNE88hgx2sRA}QSxV3g85 z+SI0m#a*9u-CLZOiBvSES2M*D9_8x0v3hE@J%PBtp9W45?3Fzj5L-$yW9UI}k)YY-Obmgva zol4WsEG{MjC=v39ftGt&L4j-B+|iAAZ74fv7$I9}BXeM9{>CC8fLvqEmh%Xt1OplhO63l$fpolXl;`NqLZ8jx zFBCw6Q7kw%dh{OBzJzJ-Dk=~mi;xDcdw25~fb?#(EP;O1@>7= zz>xy3rV&?C7HE7tstn(fCc+YC4lTnzP( z`rDKe*Yfj0p9F`NJ#=++Wawd6{d*+O$}Z&&%mEGnFz&UuvGKy0yI}(H`Vc0XH2o=W z^#lN^L-0f5GQ_;QJ__&wLn|oaKtufNKrk2?Br?x(=lToe+JKuc)xH6YY~37_!QNh4 zF!mZnh_SPI>8!0dS}WSp+LHiflb?d7YP!3-d&N(UK*TF^MgV0m$uv-ZdTB-F)hjy0 z9uPhYIdgzGfV|Oy8Q#rDXJgv$G5(9#8`M&x3#mWd@O!!umz3mp;j=`bIQ{xOdR@%R zW15bEZ#O=Q+u`Buk3I)A02tZW>p5ndw^BPbUUL%Y;OpxP%q2T{NI6T%qMZDD_m~Wl zn)~qJ&Gp)Oe4&YN_#MZzlRCd_6qW*mXZ$8ItE=^Nbfo0B=Vv$mVI4~HU06uE6PyW5 zPHt>$41BT#91dgWrIi0)~LAE@K4&))CHH$|ri(f*^5?)I!PBt6|Gkd~wvu`m1 z=^Ea*4w-P$Fof&kocdmRNAjk`(1$m*xGqIA(4zpmh-s@Tw^AiIiC%+~Z4UQ+^xbRM z7fU!-T~Rybcpza`e5i!CREe#->STh@+9QYiAsVae@3%(+fz3`4@#v>qJz{31q9?}t z)gknKX35e5UDEFwKmT0@D-KEG0_-VQhto{DhQ4}UG=imbnKhmxlL+Ugn*tVA8$3r^ zf=*6F;SU)blW_N5`y3yq;2rO#pLh>$ij5)n5RB|HDMF*Lg@idurspgRdIsZ_rQTnL z1Z6xPpn|8a9ZIZk;CJ9Gd5)+0Y(3?SqM|FlxT+NmZc6G(iogBrY=pBI7@j--?7+T~ zY8$qKdZ|)1)w_L<4}~tXo(fLy&4~G6pI`nJ544QkK{JMFgax4(gWut6VlEJpvrxn}%Ch5E_IuA%9=9dqCs} zr>_x_Zi2olGChT3lv5dd;_i#ypS)K~G3$cBna8SoIZr20189A}XXfbx2RI7xpA~TE zhd6zVzau~6;rRY7zlMA?V;o?J?bR;IO^6}0jz?n4nGz$wIK0(wXmggMESy8R5b^_15Z)C&sb(EtkiIHinhQ2RmRPLR-f_eIn%U2Gh z=?27!v&1G}piFK59jU+7Ow$1z6$m2! zGb|44I$XsB3lS6KTRuCOzE$L`nidD| zM)W`by(?BJb++oYk)}T`Q%I*2=>BS{xzK`?rdV-2qj2|r$A?`GFI+_dtiLOxh7(2% z>{%2PeOvTQi3F>Eul`NAnSI*+jcgsI82`KVQ?BxXVTK?YjM=EZ30$!tVP=C)5Q!@I z(g&jT@;B0~mQcPPy-lLHSr7#3j`k5}aFuP~V&zs*a8=L^-Pfk0iedPB%B(=V-3K6( zB#VueSLwJqi|;=CV?`-j!-yjzc*sz|+r8ah!1Y!&XO8Oc>d3utKk1rLCfUNI+X6V| zjM{k@f|H-OGSL+N`PuVoMypM~&C)=_OwmYpxQ7Y@z!3emULRsdJ&SyAo#J1{} zP0jTFdGW$tPU*`#Ei=Dv;(4s>jNgN=X7o*dd}1zCJf(JUNT;%f?$=2;c=Jm}2LJ5Q^Qke1|JzMK9e#;$tlVW*WC|>7W12Mt(HRj+!A75S@_97hP9jc88&)SwUpRr! z0*jX^2%Cfb2_n6|*{~Nl9S3YINg}8Qln*=UJEeD2Q_qCaWJydE4}MeuDzT%=Hnq{$ z(B3oP$mP)^2!Zdl|7NyFn9lsGx{cFc!L45Dy(UK3`W;_j^%r8OtumAkovcy(mT%>& zyD2JtZC)@TQ@dsR?#<1R5h@t1-2ojLG^lP4_wU}y!U+}B zlY*D>*ljydK43iz+1y$99a0FKda1S2q6o>;q}H+1?v)V10BXDw;&3H&vS?uj zeHtJCL^~Z(Cw*23U}N<~-z~R)8;f<|I*Utx!aT1RpP@&wBz%J`VP(TO$`wQsMLtle zrr8GQDb_Gn8N zJJx`tM+r8cXTf=!MV8=TwhaRFmM&Ws$NS^CR|lo`{K$dCZTJ*`DL-H%a7Ia*!oeR4|A)lIU4f z;_bed8G-}(lJ%-S7?F;vpOx{i=Br#wyG(&*G?-}l^$j40m5mM2PDmMHIv$vpuJid0 zv}FeOu#%&brN}Mc@oC+igXYvqm#8UJy6Zm}_$@&u^Y>y96Qt)bh6CnH0X}=Dku@9Y zjuEkR5Z={r=+;B~_`|6o{LSb9rx~UAbV1iv-MrAg`+rX>K^o?M1)L+6vARI>9X?8C zVK!geELXcdK8I~FMP4@)Fbx&;ylv~d<&R2vuAT`>0*}9q`^mtDyG#3ykmHgOh)~R6 zIYdFK9pxjOF^R$4FP`HimZ9mPAmF)w4Z#DleuhH;t)=oecndUrhs|1kVSNP!)BSQu zwEk25K#_b&d3Mpw$15S>@vle}CrKzcCftMLx}`NB^S9tso25p^(N_y7;PP^~g~yUa{m-<5~fh1s++%|iZL;S(HDx=!AT_Qgt1Wl3}Rk6ZnHGUP<4E~bw3 z&i)SxB1G%tteTs#!C<_M6Dn;fM zP13xpVuTl+diMs|Ul)ymyQ4V@H3XMVY1_p{NX0YikT>^Gplfp2s1Xz(9mdpU7}^r4 zn{arpN0$BfM1*K4);ksOPbaRd$Wz1dnQ=3r^EQIa)#?_zk>y6}O=>CW*5!t=8_ANw z27liI@Pvi4$yxim=nV}}<`;JXE+F{b^AKKiC=UyN1nj%A=a_I>Cv(}8elX5oA;h=Z z#%sMcc8k|)#r4-hSN~RaLI2U<+HxdG3unAd^quUujm#4mYN(;;sievdNsjR7`rGsr zmV@CKDLjg2bgJdEO#gxY8h!Lk5HQgp90XbQ3jKddByz8u)v@F;^cP62a_t6L|6cB67d~zJY*2Sfw&zR@}ZsEm3s;i7OWl zM()BYL6f46Ov@Ukv+%)<<9HdV(hRDDbhlTDT%B!U39zCA8xZR#;7mBpY~TJa%%}TI z6cg2Q5T*%CA%eCQ3Sg^dczuLFA*42f$^MY}4*RRX7=qnbl;U>=hHg`m)(7k}psN|( z6`*FGn-H#w~A({@U5|HO^kuoZR9lPX0h2N|^AU*L zl=KA-QN5DR)6%G<$G`gHEo|Y&98{0~#wh=wK1V!)EocCyu)q9_z%re$N3QQkR7&3A zIb)A7q#j}gAK-EeaPy6yF9W}ofy6$}E?l_Qmag=DTsxWx(sebP;ckGl-X*Iq8kre_ zOJkT(kYU!kN;qmF1Cw14X!$)8dW9;!A^5Enk7*n4j~8X$QU`K_Qi;npoaric#XXF- z*}H($pB}aD#7kO+Evf5!(T67M1||Y2qw@0FsSQ~zrCb!^`b0C|gSi+x>P0`aDrh8H zE=t#R_Q=^61vmdaL)nVhsW#RfsxbIBoeuHS@E^L*D2o4y;8hgivr-^X#0K~@X_yHd z@ljR>5{n$jKR33JN+<9mKlVjNGLe;hnas82uq8l>gr13}|@CvChBBvo zWjEqn%dq?%U+PM{TRo};BXjD&fXUBkmx_n#KZRf+;CytQMy>ZZz={^l@kFmxk?}T^ z``NcM)gU>KuiyKNMYuyDfn~A4>&qM$5HDIrC=im1K?cYmQm{~t6mF3pOe!5!zQ$J$ zWBGp~A(Syk91n+T5vIq)ytRRA(kU3Zh=vgoB8&hg;jVHHRjEHlTTT_p>-F*O-hXep ztDhC&wc)8`k`$*h)DUeM3W7k`Xf@CxMCscxI%y7Uhc%Y5N{VH!@CwSho6G;(M!syT zl2N1?)6L$@+f$97?c@4uii|u0_qmAuwA5`Dg-08nxC+qnynkJ9A^;bDATqIiJG8pN zUtJQQk_q)Pk5Lr4QjL2g+kE$@_9g!@~W&ru;j^o7T(BVO8t%v_AR{u6i#HRdk&Itts z3{wX+hVsQPeMr0YwKms9$1$f(&K4+DrRm$Z36U0fid@!+mK87_*~>4H6Uefa2HFF# zq?XuI(1qBD_TkXgmMn+hXRXT3bWk_lJolTp1NBz2S0UJ{ck@!e;qi5oQXe;$|E7XZCi{g7>mi{wYRqjuHMe2sW@+#|_#0`kCaxsv{jI z@o+E!C)F@RDosor&{4rodLSZ~$oPdK1=o$70eB`v^E=2AElIWj-8#6$ZNAMA|5*w@ zf{!koBbh#*F`1r7hDSd)T^$X|taYX8iEbn8Nog%;jlfr4luk_M(9p?^G>h!wxUT~| zQMF92ZbAX?%bd4i)R^QrCT6sqD1EEEJYZUx6r!X(jPv06ygHV!wY7agG30V{84b2w z@jsmS{e~|L3_)Wg{o_);JX8hRKQ)LsqUPHBTi2GVm)OpNgE|3-LL>!@7T)7be6vofpaY+C8fJ+xyo(6Q-qk%FMElhd^jh0Wv=#D|7^- zv^;dL;N7-K;b#duYzk>9ez2Y1U-;2Ex$3AZD|T?dQuVij*XoD zh24YVQlIhUU59#2If@tB)^zq%AKcSLKQO~ZopJ`{YhZ5d3%VZ+$*a=5vYJ0|esmb? zNX&5BwdfR;qvUjxMw1y|{x~dY``Lc0{^Z^2YeD~Qk891D?l`H$GrB4k#ZhB{XSFNDr~C}GUV#00OqH@r&Lid%<`IcH9Q6hD+RqC=gY!wF`=kqkCQf>h_q0Uo@9I2;K!-`qKKedQ zBmEk*wk-(*t{Il!uMKPcS~Z_aC}t>7S>qsLD&YN-`7j2nG{#DyRdT^N@UVyi zJve0vBZnSbCtkJnSQR?`M_L8SJNb2}sBlSDLjLjK$Ym@=7LLYyq8uBG&bus+1r%F2 zw0$_)sEK(&s}_%=6md%}3oPR>_D?f+`i`D}k+IB?=zJt|N$KIZPz&g0yGSd`%c9%M zz+vyBCXypM^z48Abor82Oj-{sp1be-=vDF%uVHR0g*~e$9N05E#&iU*Yblz1b5_AD z6cbLryxfJ4Qyj*;f(I-(M)DkUiub_-vQ)o>9}YA3FvlEPJ#As8M>!B#XB56?t-Xlt zZYs`uUu*NKE|B-btF{O}Zhhrqqz@ukN;LQvd8-N6xzULX6}+FjGM|wfqG7xIr6>#n zqGh`M&{dB&Q_4=eH9z$;MHVa{{78%?i;RGvxFRJ2$tJ5EjU>~g7Sx2Q)n@^XOubJj zuD0iZCd*fWQb5x!aiv^2RdcZ#=Ejh1h3STlr#K4OWHqnnW;pCvbgF)FWUm-@;xIGh zj)Bla+R3b1ER>((nnP>@=vyrcVhrckeD6|LJrr;05wl{ZFPUT5-YV_;;WI3fCUF>p z*v_TTL^4K_b7>Uju^C*d=;%nx=pZhBIGJwFh54mRuLdZt&M`-4(Q79ycWg<7jei<` zc`J2hGM``wUzs~L!=J3ux8}k9%kS%(` zHa?<*^|?{Myb4)NhwqZ1IjagtWrgBjyBs*vgtBAB^KQ7|Lnq4#`PJ&O@k5@-VQ)!C z2Vgjttp`#6A1(xEcILh_ud;j#KmS=6Lye95Dq-xT;TB=ILp-XmYVASQ{-2YukKLw& z76WX~29qGY(9h@eUibD>)aq_Rq2Dq`W;9%eq!i(9xVlq3jaDRh4J)x0uJSg?ZjO-EgbZD~1CQkce(jFuBK=-e^KM>8|4af>dHE!l5{YHeRn$R@W85RYQiT<1N zNp&&Lc;#y%KF>IZ3TiMHhd}aG{w{Qq{cZ%d2^|H_Y_Ey<;rtFx0tgstngs>N)H_Ij z+3`Kkyle`rI2%f6?l;(Sbr7V9E{oRnt17*6*36u>AX%yP@y|1(?CF%2e|mhc_mL+^ znQ>N;8eUc3A=B0guTl^A48u&Cct!;9i)+mULR(8WvZ0B0& zHGaf_EmBs_<*`oR9sQ2#CzS!QQ;Q7btIE-ST0d{YOX{6&ulqM*PHXv`@y5d%myM1v zKMD1?*C+QFA&ZX4<|ntxjNY~GLXQ?DGc?oW(f6IIYd3Oa<54clOTVmjJAb}?>fR9B zd)Q;tJ#xY;dynSn4QcV4Ad!F%LWov3SZeIyN1Gk#&VFB}jL7f@YD<+pCEmmTtSKNV zUKHI8ryR9Pb`R`R|!^LSmgKDX<28n^Z!{Nzu-hX#GhG^ zJDJQt4hcJN&)QF9T$6j(ATJ}O54aHK;iA0M21d9`&cw6#>?qtOe3bW9%x%9Y3K)p)sJ~ zmoF0ny4q%fqAs3jCrFb&<+T06{mFm)a%*)1I1`(kKC}m#qP#ak7gHR9o7_V@P$U2+ z7Qi&?UX4f^RWTG&FhN!{`b$i>zkSL?QXsgBqI8((Df51WJFB}W%%B?KZYkaY%OEn|hS-EF^UW=Pojl4% zBC!j=Xna2ME|^(Tf&2q7F@hVT=Q!%EeW%8y@aV{4GrP2IdXiK3lyG)RRqig+HE3P> z5%0uCz~3#is+y$r&svV7m65j~8ALk=<4!J{@Q4QRq2ovX;EV7{7!g;n=#sP*%?RBiCD-uxa{OrPHN5Zl7`(ZcIU$VODZh{Cjp+1Ziv!^E$L5 zBtj)4R9gqak4}CiAtn3nrF=9}dh><;as7iS=QXj&ES~~z8Xek<<#Wj<)0)60DtOi@ zBh_ESQWmvxvS~s$vhnzN*K&&j!xzua!!06d{>TFMbr&c{JsWbila1IifmHL}{>-X@ zZ-Z~s8Q!Jm@`$PT2KULzHYV)pjny_2DoAB(S5#vweLh6^h1V;wdJ32z%a$96#Y9hU z4m1x{K!VZgKBn-@B1UvHmbS0)N=RwRgFyG(({c9(F!k0Zw-IZV3Pwu-{(?He_rhYhGBzu@ZrsAzZ^>lfa|Xge_h zSs9&ZHZaldhRHhapQY`Ytftojmn&&gq|Dd}TAsH6#dc~uXq zuH4fV*vF3u@22s&h4);n;q~Ej&t>1h1M|&Q-1FU})2hvcDE3BVD@a7CC*HmOWiA(; z#7vCSBzsbrw?+CwgQwiSMp-6DfC(A{>@lH0u+#?kDL2<)kYCB+ctyjHF99yYeHAyC z6H1_?<=as8$1jvIhB?j4>U&I}o;0H@y?K@O@R+CX_9||JTCazsC6lt^>os|qRjLzQX9b7H3J3)D4a6u8 z8RDf?BxAj4wLfJno79R{U$&1RY-$^enYbLAeG8vJWTN}q{~1uFtFfqdvt@gX?@xt-}m^r zf*hKxYWzAgiKRv&L(6d*NN0&4{4!bDwlra3FC3%Zr>;Z)-GK-q>91&MFU>*!=3Hi8PpM_>Um^tJu5 zFE>a4n|nUH^BdEEc`xanclzM(UFyWGajDDCDmnN*eYwBKJvF)WjT4;M(AXOH)o^&s zweV6GoMB>QwB3A}@{hDh`z(r9Jb;;xS-Q*M&}Z{cpXO^c+?F)LuE>9M^*v^FcsP_d zS*>Y3=*V+vmHjx_l6F?u(QL=wtDHbk7qYX~wx1`-aAED4%b!W_`c=0(tT(1J~ z28mL($(djZRF*hxpv9DhpTnvAh^Ie~56-+>nUy+rUQfc1NO@4+h-6r=e7*m?k$~!#5dj^MNL!sV4 zXq9Yhg`pOKPZ;L!SfeAn258dM#=Eyu-vrR|bt_9wQ-4`2Z?UZtkoDHi%ho$)>kTl8 z8TOIu%j$O@*$p~+y#V-nGm7D-jlHL=>it*tq3m9MD#$=L*DyrYG`TzCMFC|>RX&&v ziELe+oQA}~v{m#KmMvfPN&1zK7C=UOgT%KFR=Y=+%P+W(khvU)v0(4YKw<}-hdb)W zeWK2gu6~0v?jVEHt-_ws)gNvw+B0u*|1%@+wV&7hThp`_(FGgLfoU>KQmN;M%NAr4 zfMXTTtG?ufZE$J_zZG`{y(+d9T92KwyV&n#j_uBic7V!qsZ|Eb1@eUVR%aigmtzF` zVcd$Q@a$z!q=dmk>(a-UTXhNC+;}8neYC$lEN&vu0}?{2BLAfAH1TD}*x{@-Tsg^B2pS%81Z>1wI3b;&}5(f7A% z|0#ZMLID|sH|hC#g3FFN?+~h^tT6@(W}^pFWJ|X~%7%MHB>2<1dYRn^Vp62|*{tlo ze-uqTU${qfd1C#6wthgu4dm%Xm3Ui%bm{1)a)4ZfB~cb^U+m;KmgS zB>QW$qQ;V`BW#vEZ8!+jGur=3-4 zmn~|{7YD%+4DL=@uY@GtW_;mNph)S|6uaBjPJ-|_b+!Fb>LK+p>dT-)%&mX)x;BROZqj8?o7N1P}Q}1XJ%1Qba`kc6obyZ9F$w_JV)lSER|Jv9| z%#lS$L-Bf<>Rvw_F9e>nyq*CF6OXbUSd#nmtX5>R*$5>SdPhkbuU+n1+gFhw@rg%m zh!cNZ1#@eT$lQV0DjHo28JBID71Xn_Yn6D?y68Ba0Iky67z;aAJU`az+tNl z@n)Bio=h(^!jSR!LI>0dCYxNxr6u#UpH?rH>n@`2UA!6bk-RB?`4$KmnBvg)?9K7E zmR?R6QKd9;1#Lzo$gocT^}SOlG8`CUa?dBfKBW2rwXKmj{GBxEF5s>O?0Fu}xIN1_ z9Qdn{h%}U!Jst7yA@DWonzh#Z1Ux;J39~W7gyg}=m7ns__yHeZ`hX2O%%IyEB@>*I z4LnC%t35TV$Fl}o@^WhLJxo2Avwtg%$JNF(m*7ln&qmAo(p8i9`c(t47z!h`l+`Es{ zNA*c*tQ#g0PZ2>F@T7BC1oD8l-y{!72oWHIH#Gmr%^vgi##|oAELB%G*VpHiT@yfYvn<*Ga@W|ft&{b?jcq$Y%)2(5t` zre|1}VPgZIWO1AZ_l?FO3*Jo`?=_wIuU9AqvwKHneb3Ea3dOnN{C~S(w3Fg*pg&Mr zek?jV+cIDn!>=R2WpYjN`*m3gXxTmU%VDV@Zb8|w zt)-i+>YAa3hq`YI!l&h{4iYXk<(w+zy`d06Y_((~woNdq4-bOjzoB--qXQ zvVC&C(-hEm3`GAxT-{*gLb8T;lMpWJ{bA!9%25+KQ9FSfg9I^RPF7{LI~7YON-tVU z69c^)tI8;lZyfgC-R%3L+XBqU4t8?l+G-LM{E-SvSD3BRd6fo&Vi$;s9l+xEzZUsx zpfOR>6(8S74GsmK0gjgB#jE|*!sG0r-?Wksa00PzP`Y5Lp%5G0+U?1{pmaMMTC{^h~Gn$g4sH&Zy6N`1z#+4EeNO-#} z_nm7V!f!JToz49VR8!U367#ynfS}eQj8owTY$12gaedN~Z5E}jE9y3-kr5*yF@7FP zTaw-c^S(!@v2@=5_u)tcm?M`-`^j7Jbq4u)RjCjiCty@o%i>+gim^ie*KtlZ!UjB< zg-+g+GFXhX2ZDWsmbgi5d~nLBG7aB()h>_6f$Y(Axpq2$;kI(${)^+8~*+!e(sqor1`s3 zsyCYPUJ}JX=fX_nVIR+cMW-O4>V%7lb{<2*4aBl%mroEu_^!7T2{I42dWv=Yq_E-j zjPCL2Zo_oOW`KJ(h}|OF@g_)j`5BQqWMZU;BaterC}*u@T}8#fuE8j~N(BbaHHUy5 zKe1&WWe74JWMv^*c-_!Jzdg^hQ!EYEyoU%U>l~CXm@HeR zE%D3MiH-;FgKS@xdQWTWL~D``|3DJL`dVU~xU@|Jg|6cLzu*ci#w%oe{hI0Xrkn>f zTQ#!#oOSX!aR!hKyDS$W)s-$Rdw%#;O9!TYj2elZily0K2`+j#9|iP% z>-A`CjOX^0`nG1%c9Sr`LKlq$y)+T?=~CK$zLfVtS8!}p{gWPBtMqVuGZ;0VD{+5# z>FVm=n;ffkIS<_L8<~vl_3kz9OcMQvebtNj`rcwWAnQx^EsIHa74cM<*6&)gZu{bE zYDDxI)ES?`qzCWuff!}yCO+!dk!Byb<2!m8uwn{ zao&|J2wuR~SZZjwIizN|0@qFwsc!w3Ypf*==gosr#_}HUc#`s6WNwki7ow6$Hn!4% z4<#mjLKk;y{Jo!U9zYUN73i^~28YKHbYU1J?CerWy+@Z@rwOJ(Lk+LlHy0^fiPw7m z60X|rfGq(WrZUanU&4_YjsT=7J&zi+#Az@xd_mj|gbo6iJ84r3_Q#*&WHAwQ(X{*@ zv;OSZReRMP0lzQyTiCIaC;FJ~a^~iqQ>*dxsQV4EOp@3(;5;|^Pu09;H(gf>mzOKO zrFflj`i3=f`Q;?&1YHn@ zJU%|ng$bl1w%6W-YupPpYBEl*`FXV<10m%~$8b@BWh-XK_$^#(M)SZT8XnnzvRMF% zp7hZx-jn7L^VPW#LYV^ z&eR@4#y=;R4lEYw3tZN*A6FR?H#nG{Z0|K*F|AE3Eeb`&qzxV$M z1i?;{J-y7*i|v{GKIKRp-qseOuO(#_%DV#_^RS!*@Q3HpzLx(zbFxaRdOTTHx3xR- z*9gCvJ1$7{y@0Lu%YpZuq$TsQ)SeXCQvvFaBCAm(f!m}+LHi#%ygryVUjAk(NG0>M z6*$}O?5Uc5=rqOddw%pk}}kjfFP)JmmuAZB1$(%gLId~(5Q5Gm$cN- zUDDFhF)(xvF!TU3z`hXw&-3p0INts4Py5TBV?5NkdR=S%;{2U!oim$EWdS#+(IZP< z6tXQnIm2nVWr-V4+eN;^bch$vBmz%ja&>aCT;)GkCmDBw)K)Tw_WY`JX7!dX2?Cc~ zKoB9Yy3pD_dY>(IfVBbhE!v zs+qz%YRTR!it)gh9BNu$2#l}c;ye`_nGv7TOy!Fr5@XjC}J>H)DOPZy( zkJu=fKj})?uvtk=p$JZiuQ{;q3nduXKuUEItopK)2GrQXcS@T@lcewjxKg<|p%E&H z-e279C-%BMFxKrvwUOfuw(Hy>B8MqhgadS}E4~twS%iph|MU^mP6^-_SyDgdHv_KW z1abcN#nU(L+=|D407(V5*)@c|9cs69s)?SMc#~q5ONxlF&3uT2uv1n_tcdR6_;xS- zMz}zlsveq~&YrkhET1L!ZgCp*i@bR+#q^emo3-Nob>fSDEgW_Q;^k`XGoX2VE_2S1 zc6CpO=vbku;16m>+q|DO^!i(9+v;2GGwpJT**# z=QAdpZez(jY6kea6!)aW->OP$YMr_ruA$xFoa~euT5vyCBU!6>W#U4YY_4f#vH4B; z`KeyhReiaJZi8kTa8Dbb+l~};Aw9-(%pOM?m!a5nBCd6(my$`Ste_xf&MLx-f5W?4 z9hjOt3!Hd=aA+7J82@ua_D)k*BR5wQXl2~=DXBTciTP60MztHXR3RonUbmNEV>%D( zU9UL^Q+WC|QN1%AZF0{e-h@+ld(3Yyf;KlhN@8F+Qr|@cwK~VUczTQTU6kB!pjpmr zp1$U7OS+sz?in3hT;fVlPO45M=7AMLgMLK+zIx%af4Q3eviu#}-R!Gg_S6sk5~eZ9 zkIkm1L$M$&brF1eUuw8UD+?m>oIRXl4u+b#DSY}#7wwW^sc#t+I+HogWI8b~;K? zd(4j81pmTeuP90Mq8}#7aB#$9sSrPz;Px&L|Br#ET1_His3EG229vv~vVtM4vqQ#^ zR=37c>w^9kfu7&?hX z&qi?qt#-4QqkhWy+V<#hTo>?$&K+rD^cB`-+ zz#CiI7q@G6Bru56ZN-wOV zDfM5ku|NGNGFuDS=+{=)r?KHV#}+HUwEC6haf__Zk^(H`Cxen+5oLdjPtX&W&FBTJ z3yAkf1}L1U-BfdX=fwD>5KdQ>wOth#^2&2-$$8J}N@zcema{%d7~DtzND{{?wie7M znabw>K+x~#v9+H#0`nJwFSz7(dqTy#hFcGwRg5UwNnLiM;q_t{n6aLY=KXY!CVhm&Bn;0UE7U|qc@9%DI^U*F9L!~jRpb+KUgh@hboZC!|`BlE(YPQo-gr*Ju2jNf-6a0oZeUFK?12d(L}Jk5C;+zRRu zoQ`(7%B%Epp#+A^K z*YVYfGTcyk(!F%SajKo2*sM=Wz@6_3;=_G$4JpNw7-L!`O(MaX6#go%P3P5juVHShuXtCqE=1j#S$jzmBGb$yfVuPFu9^@Ag$b{Cb%r|R8 zy);Dj*k+Zq;M`9duk9e8Ovlm%GFrSV4|@uCOUJ|CaY|JgfIcNJzcl_)>wq20?6G6d zG5Oh~7ulj|R=?Gq^Pt!$vQ|Yuk7j9kEh5gzSO!jA-efAUac~0hI@;tNrPu@mH z|5q?7oeofqmHjb92S`00md$pe= zZ6D|yZEW`dTST0hgt<~>t9OfK0MOd#SEUSIS&@NjoA|__Yo&#t?<>JfTx^a%`P{vk ziT+(woRukcC@jptjNhS*je>y6h*_@MrmAmTrFL?y@G)|(&)Q(L%&B86L|+T5vNSf1 zYrWIa)>a@n)d3ij1(7Cp8McG6O&=PKkl`5-$u=u1k_}|h$=0*)#$6O!L)hou{++;? zN=M{r2nDzuTcLy2rFrR4&tsZ|!pWs+1s-`4IphOPokMlIm-t|S`tVk>FysR}RVP*8 z<_MN}Ku{X@;AyZFm#~S?ksh*zH`Ok~@^*N|;>n;wre1i%kCJ8^MtSEshUDgqs%HE?Bxr)aa|3N*ERXh z?DYU4jeVb}R>{BJ#}OZQbb;B39wFfaUN-F^d<;^U-aIzn1JJj}FUA+;a{fJy;-!#Q3%S>D9Km8#k``z<<#BPNFksg&npB-8Wo0>?oD4o)5fyASXB1zQgRU95&B zw`-9FC$A?TJyq>lg+&h^1;=o-BhZc9>sU?caR_S%r$U01XgP-B=;!9G?N?s;Z3^wY z^k#dgc>C;Z`L@3w>3+A$@@Zgq*Zhq%32D0A23^VfH*@U&y*KU2T=ec%39(H*U4C!I=+Vk~sugCq7xg+w-lPDVz7I?aX}bBl zw?jf@+#FW_*y+`cb9am-XI<(C;ReCi8=QQs|H8vkr}qfRuWZ(36Pe7xskg_=&69& z_C(g&LaZhyu^S&v=b-r3IaJOVlM`>;d=@cpe3YXyi+Ud5@n2_mOo$+rhVrGDQ2+Dz z(V|h-HS^3RgpIS^F8x0RToU{fneHQQ6lWY!Qj=?MKUu6nIG{EuRF;q z_U_^&`|sSi8Oi0d3D*LKW;QXOgxKi-n~7Vg{qjw13fH7*Xz#^d0O)q@prtofycaV7 zpP->(H8Tw8omJ?PM&D+hHtkMnW;aNIoLHprghuQ*o3n2FDB7GVBts-kzUBkt=&vY~ z+NW2}M&E+S28ykRP}PFmZF$M0wSO5tUwL?!p@Nf13uA8TgdH%>(WtDoP@{S`Uu~if33p z5>uKyy+D8vVH*DL{V|?9h=A{V5GD|N?QT#N|Aw0+T_BAl*;)H? zCkdgE_tml`pT!U7HF>{swx>^8HkFbe6(P6f1Z{*aN0^kynqF`+bEJH0WmlR=jBbRDEct9w`#R2xQ1G0H)!SvnnY1JWr7Kyz|XTzh>?z#*>vItMHoZ@ z`p=ppDZ6MKG`YgV(rGsivHirm1_!lQbf_!r$YfZ_Kc5j1M$)=K?!4O47fYV=tMTyZ zNK?SA{Q$?2Aqzu_EW<|8^goVzJXWF+;o)OsY`7@5H1Yf_;y_HPsHSFgP=wn8%$hZ3 z5FD5iS?&#cL1jp`r)S3toM}p_B?>Mc6R`z2& ze*2yr2w;+cYv6gGssYKy0x|Z0OAkEF8g-?wa5aR)3!kVjMc}`Sy8iOSMJlE?rSn@z z#gL@zZdy2dz)+J5U})25$)lob|FT`az7ya3SE0tHF)!n*^-4+ADj~M2npnvIftY4@ zWeog9-6=-H_4no$#RaV&B2B+VeW>+eyemt%iDgyVGLDd=+9DMuRIJ z#?B*`=D4dPEayJSd$EZV?aUJJDcc$|Oj&}{rfCYFoNOfI;Qn8;NJ7WCPw#p;1_$OrcZi^WLVZwR*4}xZcdO;EyT2e z*bd6t)}rR=!P(~7)Lf^^j4%xA98uz?vHkWk|x+w)vlF%Qz=4TzargmIF=@^s?B0Qn#h{>aSb*S&LcdgF-2obW8bPv#L%V*$9ILo> zhg6gAVswY^0oD+(641cx5GV|>Qw)@HVc11Yq1XNCE7*%Cw!%dMSE8w5Q$F7S{!0UK zQ$vYMPGr9NFPOv_@M`NK%=UUVUNQxbisvXX8qtKvkOCDq$w`u%oENs3fqxdGTiWMcO7v`m(zkdf1;4yeZ z^}S~KLCkFxiZAl~evBkXe3)e49>-|0vs;6w+oC2t_PUM=JL#OQODkXxXrGN{hs8%) ztPp7$a#S{@(F6yVs*MT=vJwG7=`~W7 zq2V^T@5K&GUc6>ymkevH=@txu>K;w+$1m!Pu+FozHmL|{VJ*D%O#UkMJUsr8Qm<9b z3GK5_;pNilMx?%7vl~-tCe%|N9IJhxCvK<-pIZq;7& z<{P5@x9-mPSz2X<7?fT8ft7KuBKQTcvsoh4}ffk!fKfijl_mkX?(9&=DowQ!Rh7bNr4^r%@u1t5n(|@IybT0%OaxxcDDdi++4+&GQQtY+<5^5S*gGn;GuNrFym0FUmws7^k*v^w}t7553< zDhZH0&*xg@!X7P(cO|%)B?e->ZqE5bLd}k=H=#}X@mNW{ae1HGXJc*&;DrEW9v`i`f_6?yesW=j^PM8XC}on_s`5<>N@502Y_0CJCle3Oi&G&#@fu5-=GMbT4O$ zHlQH+m-85c>-?;DC zLG5^zp(M0~Mq$B}l0I)9HPJ|E0|ZV(XyJwvmCG=lyu=QQBsutBUX`77Q^aDu@ZDM| zOW*AiHuCqJAmLMPoKgSHKd| zV_rl7@RQ2gc0C>3?6>7dNyW(riy4eu|8ZjgeqWiJ%VaqdbYq z{-l}2DNb@+H%g$<+!%{X`T^yr_L|{nV%Bv@&M|WAn^!%urxjYoSf2gcO+!9(l#vfa zjL^EsyjdB#;)003r|D6=Q2faLFt`HB$a%>>u;6;^eX&;xtp9$o4q0!>vuwa$bsZ4~ zNW4VZ0b4ERAe^%K*EcKS81508zy)F^|O|(%G>Mljyogx2FHyJRdcDxZ4FJ!=2BPZRQzsig0tf2#S{mIG(Q?(K=IU zx$5rvy#|Gpm2G6|Z0Xi3HCH}??m9yZW^JvRC2bh#u*@=D|Qq{pQ$c08R~OkWb@8+x2(U zniw4J&2u3NK*q@oi8fwc39njTy;G}jw5WGLc2o&Ur2K zGxZk7D8Gqj9|iyxAh(g7-jon;W`@B4ZYdCBHe39I7aSK zxc?(QIK|l8c-f(qVm=p~KZIM$wfs_` z?Htx5HqPB`N}ju5sGGxje|m19av*d!D9%J>0N^8XsF7>d6NjG4CBf(XS;c9XWH#z% zcfsOIn!48}(lMiE3X1Ps=TcasmC6i>X=eTOfKHF%(_p&w%%>!p*kukH8cdqObPvvk z*f$+SviG6r0XWv>?4M+K2&AB;UR4RUQVYuPg_`NAbT_3um%_=I#=HdgQG}6^bGpE( zP(kBKws)H2buU6_(P6=Q*l{6N5M5NUPxkjLeBZLK<0o_AKuMXGakD}LQ-ic(*LX>^mC%XqNsH&jeqEgCawO@yjL&Ph$m~}6u%znPWKrL zPpf%0opwAT~d{J-Kbt~YKt;LHTu)UL`hG@a5 zkAvVkv4mH;as_cmNAgSV%G0tCo=(bz-+3f*dhue@&T`{^&sVzOwL6^u!y2Hy) z3tD;?8byyUp-!7$68o^^6jd_Ff2dB4tf9nv6in~uO`!4>RZ6)Fphd-8XibF_2flAE zm0xA~amc>o95j?AYB!_u$4QCP%9;Tk`u>Q3g_;J`k^Rz30`Z(ayIn0RUqod(e>&;7 z0Ahg5rFBsz*7OI~Tu^3I%z!mEq$PqLz;iFYzj-`@Eu>Gwc@6UzW3^G(v+Q%ha*eI? zLnNWcN#gAY6x!p& z#L?nOW;YJ%@TsUK66b{z@ZUz?Kc5#^jd1~$yZ6#XGg5M~mqGoquk+&I9^lP&(naS7 zBiQ$Sesw9akXO41AS2dXYE2Pj!=wTkaI%9Vmc^0x-~Cn@rjNA+(qu)p{Gw<3Z9t!gQff7oz_fDJ_BpI zNw`ta7hn!9TQ^~2(45wF)P!}LAS!Mj{F=9TPNjB#74!QU7<<4w(iKd z+vx63`6f@FTf3=m{)c-XTuUJ(gT*-b7Gk!_Q;Y?*X~glzyAVt$qlUc3)yGt(HJq z#y_mdSmz(S1^j(YB2ODf+LC7`Q<4{-yCdRF)LBC^;&cJc!}ARMTuzPx!hDPO9gP-g z2E|GF7L67UGw_2}&~l{+F<|lR!tf)9FrwRd_)|z|Ky{BL=Sy$1iiGE4mMJbNv@S&& zfpf<~BLjlo(8uzHDv8670wXpfodf~})73!*plV~ZG4DPDAp*Vc;!w5pD_h1*M4l(D zxJ22shS6|ImFYxEz7l4IzezX;`aA`W*j9oCL4YZN|7>m+{v_7|TXPIhbCLTPPk5^K z!LEP6L1*{XUGJ^03=*lTBe3214;NsVB{E@-CZ*O!<6{N*LmwJFcj0y;Qz5WQaAj>rl9CyzP(s_eolPb6 z-OHL>@5v@~ac({d&3vvrE-&(r)T6gc$c$BYw_Zf^PlPW84n6!3E_Yeld(`xF)1}4~ zLE2Y`;A>%6Gtu?n{vU`;30V6N^*SEAu_lr$Bbm@uht(Dy+ue-LCp?%<1Qoc{t+5>9LXBwQMQ65k#fuOxK2Y_* zwv21CwXu7;CLu4TuDS9PO4aYEpU1)@Al(-a8Oxo3RNO0N3!JK!0@fdIiL!0sB58HoN>BlR(sgv$IdDj;D zK-vdKs6;1HuS#U(KBHhtAwpD~bEbpNBO zos#XEjro5CiQLW3SP#6GG1k!{aK4fg76)2j>g$C=+fS#HWm9q@4LeJ!4Yr=J~<>-}9wpHHv6fE$5I4ceXV+aWC!j6NZPah*lhiN(AdPG(^eRMr6`JHCr zB6lIU2*p5Ca|07U{F(@I>Ws=GufoYMoK#CubI1{0N2bjS8r}w`Ul;~>OjN?vv<a4EEV3lPDb3oNifIu&knKcJ-kgW7SyDWxehKx)nYI}k*Ve`iI?!nK zph)<2J~aN0`*3BLiqh{@hQ_)KgW9ht`KOYU@8rwatp>sqR-Yru9tl4WjzACq-p&54 zYWz0PUx2X#F6IiyBa~uTM_w<9mAv)-{yD;Zb?+q7XB@FI)m8hTVc&1lJvZktHxBS= zxxSt0!&ycb``%@({b7O5@9^I}y=02vOm6w;uD0>Rx4-`y0BLl&%2VoxL=@0bidW%XPw_~d^!puH5&@!Q(%!aU$1(%Fs%V`=eZP78c?KzhcMn zgAx3`u$#+_6B&p~lUAkf12WoX`tNUojpr6q2WnjSs&+~THUbuFikOV860!*0v!)Qg z6Ey;?i+HSFW2q!6KQX;8ap&hANii_J3!NF`$n#El?587QzUOpC+P7!jw=Wzc=p?i# zytJ;{DxskG6*r>#~htoTh-FP#OD#s!@i398DgZ6CuZ`q@;{-ZYN_? z^q)GP>|5o24aramr+37cs^4$jQttHBx~*`Mn~lO{xL5L5*(LXq!qkUxIDKK6{g)C= zX~Kby>0aJGjK9|3Imep{Wv2_o8xvLv6#=fIm$(sz*?H##-=;h_Vb7`UU>nN9!vL3E z;z5t?Xnm@fN9UGLFkSnsmz26Zlo?2vJW8g$u7|q7Q-i4d-%VvqP3}ru#uo4LW3mlO z!5zCK2Qh^A$AbO@$@vs=c+M|+!UP6b9!qYg`D`UQ<__@BZ#Opzw&c(XMx7Pf@kl+A zUeleNh39|v*6&vrb2@Pk=iV3;u=-GHk&z?-7#mJlDfPld1oV&;p8IERP|`O{IUZF) zzz$N%AReqEI}X3q+JZW@gL%(P&dB;`t6E`?L)c~inf3fVwdaD3+1yIsV(fC>xLy%N z${PCQ9ew~f|C}&MRhlde*IntE_*m=&y{;hca>mtu@LCkq*VokMG%iP zXdJvM-?m5*h)j+=*Dt`tKg4?$7Zdaa1e@(Yn14)HQ?X@ACv|t@)kjK%ECMCHpQ_Y( zY*{FS=fJFcM`hia_Zsn)GX44-|I1JY`AP0CvnlBtN1i`pM)sx zpL;6o`JHF7(|X(KMIjSyd!IJU3m~aSQWA;xN7RF54=$l6S*sU-Un$cjYx-;;`@|r5 z%pqQ(u%l}9UG$b~lYIhGGfnv)egYjB#6Rb#T-)6W5bH zb`#ey1Ts^$M~}YtZ(Im?79KxXN27v&zCZRV?Q=B;aQHo)qPsGhqWGKJHO0PA{XvB9 zJ^y1c?|uI>RPNn-|0lh^_v%kKy!YnW9k(Ln|As@O*`a?{w6=HQ20k_1%7x(ljQ#!n z(bjpcp^%UegUp?s9f6vP+S)VBk%+VWU}KKVfp`%BrObmh;$#;T(4zxVsQDI?larf1 z&uVHObF}1I zhR1#ezfl0r3Lq%yv43&8DPUjmY5AMr;*B?D*SLacl@0Q2tN>iUapqX&tOMboe zyZxP55Py}~qT|RyD;y9pyYjSk&-nAkes?leBcOzCxE_Ms zNB(+;?Nz{rP_}IU1_<8*a%@-@2rqcDnYZ2?Zuke==EI(^;@Q;>`|}N;Mdtz=2y5HX zPD*i^z(_l*xvdLH0b3E}KT_yfFn4v($XK_`lYcDw#%LuVbEZRS4jH_{3V*uNrxmSA zV+T3sp#)}apX=Q!|Ag8z7uv4=_}73=MdQ`lgu?(cufEr$nplv!o|p60C03pS7A8%t zErjRXzGpBQ?zQM4ARyp<;7k86@$2HE{i}n(qYD&v#<_t&tjNt5E~}}*4#S4z&Tg{K z-yrxLpyy&q=@(b&c8%K1)E6~7D>-i7cFX>wBE{w~lqsr@ez;>*7SHpNY&ew{BxyEK z8GvFd39tYr2*LxA?npAPU5An5e<67|fsrH^8-On3QoFBM;V}uI!LCU|!tV+Q-y|d` zzEb5MeEO=vV+3l>1t`es>g$_nnkv|p#T^O3Ju;I1a9HWUk~CC)zf7z0!u~A;8Vj11bU_Oinjd*mTh3CP4=XFj3Ie*ykE_k!I^vx7Mv#koqw1C4 zIyxTPx2(0+E$TJ99%lPv)WT=@_qQegIFK*FyQR$9emHfD-r7trUsrb-RzU39+*>234p~TT_QYNkmM9*}1i~WiAQ` z8nK*rVf(0_8yv2@2YTf+a^DqR*LIa&K~jMu7S!J_4XMQ@5mI%n_qqA%Y&ET_u8z&$ zF7;$~3JP5qU-h{D`6fHN*>g~WL+h@0ig_GPw~5S*eV*KT-9IoOC?Fs-k}7C6d`!%f zb`@_{4akTTgRQMBEkn8u3so&;0|b63zFGO5+RpBg4-JJa~9;H@wg%5@b55$C0)cEA!e znCi;O4fTYlN^jab?R|@*iBjg_<~}_;vt6t(DtG9Mp~b?&O36=muix{#BazVsP8OH_ zC@Gn5w9!^j7%3-BVAUsk;_rtukibfe8|5jg(P%6M-2B)VRnbyC$>=`g9+xzrqvjjz zirRl#?UC~h&$lSmZpsIP&(04cDq0q1vO`D#kHYqNrq*i}i}&Hz8$jJP13Z#yXCsxT zyzO*ZS_dUMngGOm{1xHe)1{&K%+)r6WRY!~!gbTC($J<2!1B-pVgpkp9UI&C;-PYs9f&dF2 zjo+mGTSy;$66&oS-4e0d8~v37%bo-wzc=+KQ zZw%L1!w#0Ix1HR}-_hVEb6ahE%5?aKit;UU@WOr-p8kDo_5>GCoU z)XI)mGLMtMmp@U(C=)drY|(QIfMEg`&8v+OtH^6UtlI`qY4<~yOt1)`T2_2zyoF~d zl%&HnUM^dbYk{<%Si4pzVKiv0xGGdAY-1@}UT^9i2@b{b?q>j~TRn6+j}9dhpi z61sa~F=Qd)y_-FNw&jP_LsveMsTm!=iX4j+8_fhD&)q|Ff}(s?q7r(75}pn6LX{a{LB8YPyc*j&Q&{E6-was}5oCEp;05nX767+wMF@Cmnm z<{t*!@ScH{=Y^f`jkX#slBLl%Zr5bA|A@~`(LK=Lzv7@fJ_3C~AefRrTg%Kn)VJB| z!36A(^qWP`*$)tF4*if9hrbu`lY+s7i6~sWw}9qW-iR(V^!e?znLY?~xW*{=7%K6! z0o`l~ljXx34mnPuP=~Q+J?UA*qZ)(87$m>}@~hv_XmqEIDw1q8@h?C8l$=R;5!&sP z9&Qh8BgeFSkI2#z_uhf!^=D zFIK_X#U)}n-ezFXq{_(kEpS0uOMDs%DF(R#ksBC6z~RNn&HAopl^@QmbuAcd>wSy@ zEx5xLQA3F_g%cP0KK(XZ=A;ntv@&icztMtq<>^5lK|n%#|~sarX1M z{ae#0Cojy;iC|c?Jzs1e4Q_CIPxGn}szo9&1y==YdoBHVrpXTco>32h$2Jv z$pERri2)Y9=JPX9Td{+?$`Tr&YS@OFEIZp@;GL^T&c9fq7Xe$$QAdhQO;3Zy*ubrq zJH=%?+uLrthw#KRpXnys7SxfN$)PJ_I<&&8cO>)b{dOw_!+Pd*A2|kP>(%dfv%7+O zhy{?HjocmvYjeE~SMd_K?Yi;B>yOX9SyU~MYxLwKo*xUBtn`sRQHgQgtK`=Qfg2;4 ztlSNt5vb42p${hT*~WX~4@G7`)OA}KiNfjdf~WO-RukJ$@vz1`FWdU-MnFjVR$p*> zSeG2Ngl0ONLU?|yZD(@%P-hpoidk}Dx{<4Qf*rumcKpHzdlm`SKF{+3%~7P(aOro|F-ki z*1GJc@lWgfEF@m{-t6w}k?!)?T{pWj(RE9y2m@k-z}Znlc6vmU2OY}?FA~cbZ5X_g z`iuj28>5xI&qi*vfpjOkt*x=~tPuv*t@zxn?{$sQ7h|rasdVVi>e*UZ$&oDW3<6D0 zO?V$XK+FRp)8~p;Uz#q~cY!MUSCQK5NOI9@U_9kbaM8o#)YTWgkv56U+GoJQ?C8*7 zUhj4Egm$rA=__|val=|xZ2R`l{FOF&+n z)(t8ER@StC2?H}@Ntzs8iYt5$!#qsH?@Y(o(OhnrU(`6!O7?2Y`(M`5=6G zb$qVqMZ9lr5OqGFr)>#UbM+3ZugjXL{K}b-KG&l9xMHYD{VPzfvvjY|7)I_{56n*J zbUgFXTb#&V(JNry6`=b`Ucb2y_ku6Cvj9zW6(1ijdVQ$ieReVqR8q$G8)3tXZa1XZ zBK9|h$o71>)HA>!eHz~wk}jN^n;W_6HY?!e25UEM)Ded+pY;QZm!-PnV{?~?n}c{U zOzrwl?Pj9Ly&2&OtEsZqpwBUn}(vpN>r(`sgemzRJ@d)4YHzpRMSXvk9!c1V) z1KA`HUVB}R`+P}jr-!cAquK8l7KHtsX#CK> zE%ni7O4G!KCbB#Z49q~cChF;tOMSv#Qe0ddMX6rG1ip+_2IjNKNf%0xxjEU#Si)Pq zMnsSpoowLdoqhvo4C9e+g}!00=B-mFa5A_*Mo_A$EbX;U-gX&o=UJ7Pr^XxhJ`{h! z=Z5^MbMXe=c-c5+Tf@!W3I`=JspE+O3c^n)iSj40Yq_|&81tTHHV>?Cjq*^6d)e&q zhuHwxu~?9{U5iQiVE{2$UE0R=u)96ssFFi&+`X|$2DEhk)*dy(PATqeGh`0;pmcI} zNf>4Th9d?g6Egh>G^sYJ+z&*!GWstbzBQ95h^uUFHvIJnn_O7y^1xiX35V)s@Y7n^ z;xZL!XQwo$Y$Yq00i}3nwM9V$n_^KpmXvPL7p}h78o<+i!qolY7}axNS=M@XSzOj) z3pwj}gaN&|MsV};`kZlQUhHPxxZ(WhXu<4^N^!aAz5a2c=09fa@`{U(22z<92U_$} zx2WqdPPE9BVcrG8@zWfHm+@p#e67vq@deOn3C9cS$OWgMQzA3HY;u(1P=^5P^uEnw zf6DYuuU;LfgEaYNtEe%SUKY)V=8}@?8DE_25+;%JT`7E_1~T8+5z&h^m4=uPot0d2 z$QGb$=Pk%~;)ud)Qs;ABcK!Jp<)*Id zHaSq%%yC`aEDx#K%B;$9JFZ^^qVpyMUDqSd+2ghLdUDN+EwhT0A zQZAj-8^%F#tUhAa)`Jz)#c}>f8m07oWvGM5aq@`3u;%9o? z7HU5N2%af6sWm@zl-*;h1Q>A>6RH5%r%vr(Ijm^>9t$!Abf&`%Z6NBcN0CO(2uc(NP9x9` zY*KRb)Etr3q&3zaquKshzop)fO_elgp^uJ@DZBoN6PTL<0*SFa8R;gkr3WCNomgx@ zu6X!D6b+j!Mp@6Hd;J~wtWZJ36=DMyse8+qm*L~xf@664BJp(|fWBNsJ$>MH)u02; zZ)~j1eJU>W(#G2Q)pLFVYild3SY-el^DOVK-J7j4W5^Q_RA4k^D_U*<7r@+UKI>JK z7dHu_f7|BFmylk`i#z&?CUVxN;7vsm9Cr4NnVDI+e|;b^k*5{j0>7A`C)cSm9V%yK z$IK}&vmRvlv!2q@Lt#~AZR?V*Uc(~FcvlKk5I!U~3iD+{b~B4T3T8$tS-tXW%E*LlHt+S$p)7K%Dr zDwZAhTtq@)e8W{E*V(^Uklp}%0p$5FS+r)x=63il=2B8_p~*&PtE$=g04(Bv^&vt& z*CvU~3sq)tXp6@PTX|~+6bOxMFDgx1T3Q}lUAeq+8ftV#K#^Gi0RiwENZSj#5^2CY z?aJt1!UXqS^%>(uoT!K+<8@d-Q{BlxAFCIaoxgQsZ8w2so*SH*835t~43kaYJ-}(} zU-ye9ywroV8uco8AFVBb7EgP9P=)P1IxGkU{VR7Kq?+#QAttbWzp*!n9s#{drzr$ z-8BrL$5Ekw`cj`ujm~8n+@I(H*2vVpR0YuHHuZF$*}vVy`gY; zI42GTWDa-h0u1vmdRkS-)3hQEr~!qhL_q2|@%l1Uy0GJ{oLT}{$9q7ZKTxT~Yw73e z;!PbAz&HWW*}8nxVZqJ|mWf0LNEJD546?|Qb8}&;JVXicg9SIH0i@w44eje939pC0 zHMx0sB97>ly=$bO7tVg@Upw*rO#$gg-kSZwz&MABJ~l zPnT%(dYtWgiug3=7_Hjz(y0_46K2F6`CRSYXagSqg4MHP&m6MdIF!z5w%-2&ki`bx zq@c_Ge3jYxAu8i%SRAKSS!^uB$`5BW-jU1_YrmS$>rHY)bw(CDwa|Vlx{~ zYXC+nB~SCg%2HK=$qU9KEEnQx*7pMBP;D`@g4dP#QM zD&}(EzHqe zjO&&4xAQIwfZg-N7~-Y#92@3cv4Lam;o<-DIPqbgDr5SveFiJ=!|*Qx_&@jX(>6T{ zpKqfBKbT3p>3E(9N^@fD?!SG|u!sLVR?*~1l~alb(x7|PAKr9KtToy$H&ZjZ1EABV zHFU`&OQFR9Q^#5BDWjF!Q{;#P`z&7o3HyLa<N(3X&XsXK+D0zmDv8c+cDC!W-vB{e0hog*0(I$FfBSO3gnklw5R-2Klo=!} zi>zvG7ivugUIMg!AZ;$uaai;sciYN>Ki|-kX4WWwgI)o6bjrO}xbX4dh>Ujj=&x{I zC|{IhT9yLS%a-K;VrgVpTHNQij#aCC{z_PnCB@Knr<*+76It|>(IsUPSor6rc&s+U z9P4k_Q2i2WD)eA1hBnj+xUlu?<*`{Nb9Hr1-D{u*rBmUwJ+?<*5TR|`aIsSi#uaNm z+9`%j+r9F#{6taV45@7o+R}^i^Yedij`os?>Sk7@ z{BIU};solNZpTu+WRK&&h5tX*o^;T4go);?_1T=&6aXIv>^V;Bf--7GG?}e4$RA!; zto8zlI9T=f{Jf_nd0yB5RPvF!H7fV$S`RTLfuQh(*gTMaik%q9R2^iiq?MK>ktR(#NN7?L1O%i*XbK{| zh9X@+>Agkzw*%*Q=bP`pJ9FpWn_8DM35@9z@TICa4PvVZ zVK<|=IC;G5a{R}zUe8r@pFmuwUm17j{EP!Ag7oxmQ~<|rwln2m>V^+duB?=o7M>`x z541RMZEx>_m=GH4Hv1F?gITOP%EvgaE)Ccv7_Z6Ocn+UN7C4?P1f7ZV86-ZOF^(kLtES9(6zaRmw4q@ z8MJc}ikE=Sa&06BX7PGMX!g?9V0?ZKI7w9NcLw!jQb(#BvSX*m*KkfC;aHApp4lMO z%b^>*(jAQBo_LUuI^M0I z>*h;zs4Uwd26~LrK*UMXYd;Z)Mr!q1ogP&EXJ$W8B>ieW&Vx^h=^%A-r)OK9Oqw1C zN^-kT-ZN-(e1N#DD)SyWYibj-B7EsBA&Vm$^#3B!TXVpdSso>nuN};Jro0iYc|Fyz zh_>u@(u=tF*fE2Q@cJP6-&p(JX*uIc6Eqd|h|Ahd>5e3^q2m0;polE|!nf;Dil&2~ z6aBovh0m!-%`gxlRp(y4{XpSy_Kx|C-v9p(z=h-0ODq7%*#25k(DCtv2~m{!ZX%@r zQ5rJUQZcL$qPmKZUL$5@zP2Ew)tRiV@~Gt}9JJiLF#P{p>l~a)y_?ov?yTb0_Vb^0 z{u83$7rr-fn)YwaT6A{?+xDh#q+5#ty^Hof=Im?HEZXwN)f08b-rogy;|N4u^2(nlIPz8EX7S@GIl;z2 zGu^4@T*d$fWRolWFh&tHI0scZ@@2t%Vi$bT84=qI6Evk`8ZGS{Cf{vyyP0C<{69^y zl&W62e{yqYGo=eeEd?5lyg&uG&4jpuC&3W&G3Ut8)Bh+zjqXm*YHc93;*m)>q#`?P zG^F`+Q%S>ClJsQ-X5xg28iib8(MZ5seZI5xz>FXNg^L|SAq|1Gm**Pq3oB>vUza^S zJ{l+^t{Ca*l?aVIHw$QpH_{D|XU7=n^}efGEp~MZFq;2dOdLJq_x|gOXjYDleW&&| z0ll*e`fg{mPX8gCDs|q9c0SLE{uT4ID28rtPNQ152`twK2SFylASKHA->$x=2Omy z0GG1hcHfSZ92{Lve|@2SR@S`#%bP<4?c#v28GHo`{uQ%JwYnS)iqIPFC1m}w3PF%!r0 zMk(p-KT0vocLxhwtJ#= zr*ysx$uQadz&PO2lghPj3Kr;5MFa}P4-?lgp*V*sGK<1Ux!T>Xw7jphG2SNiPuPPT zWFSh8c~&bl1J6OuN)!rT?72 z;&=JFH}wSN9S`&RvutSNQC!LQEp3XqUz~L^m;Fv88KTSP%ZrY1bUE_nV2d)3B3PYt zG^y2IjiQ^iY!T5X_}VXsIS&`gLWppRXHFDbgVhlnD&%~KDU~iqEpg7u%|Ze`nGuf} zeKb~63Tm>pwtHxSu{B16=&8K*A%W&sV)X$4YX9o2NO5n*M}A%7g=C219n8=8iBTxh1=|ZQY38@ zSo!ieuj}PwUSpLgLo(3PS6#IIaV~Wt*RdL)jl`lU;iNE980R6EFnboO5W6D~yhU`s zFy?B`lKnR_kJhl~LdNKF;gN;R^PN4g_FNu_tQdci97*hR zDBHvHn72|nQWvE!{`(ww$Xc<_O}0mg<9HK=sPPs0pqoXJ!SapLI~uN-4sOjFKoQ7l zt?@GcJ~^@|k}6`+%xGL7Ajhiw;e+xQRK4vPFP+A?LXp@4BwX`*IQFhGpgD*)Lmpy; zxJtOp$7?vAW`A>*z?_eB(ll&afn5$RO=!E6n7p>%K+s}kVCj3tJd<7GJ*e&mc_VR$ z?dC-&NqX$_3>pk6sZZVQOht9#ynT0wIv;J;qNo$dEn(XBC0|a)o$K>3R>+atwDn7V zoLp(h2LlZo&4ffIJjfMY91|G5LY7prXH*@(tuQ&jGr^l|xL9>nu z{;A--xt(3BDbn(!Zi&5{I#EBeZErz8(&24QW?vO!60bk8Y{|LXO>(4)fD?eyjyLSR z7wlj9g!rK%%Y+u9GW#kEmI&_CHd@1(;xdpnrd9F!g{aL!x=zOz7<-xY?#)NL ztcc`|u#s1H>2$d?)|MsU(44P?tp#h=#0BMjwR-XOc?SuUL_zndug>>vK3#EpdaQM8 zpy(Qc%cliH)T?1@B?J@UN)% zpg+D>=cg}$oDIXfe;wac3fj&W7me`w7cQX9=c!GL#$-RnuI*K6K8a~twe0lt@#@AG zl5MkircDz!-&cP}^$XDy4O?1@CC zqM)qB2NCA=dnH{7<=GxFSr5PuUrEyi`GV}r`KYd(l>Fhy{LWAO4e~$~U?!Fw5AMvq zFTT*K@}%NOYCp}pugFe;BjuW+0m zOixt%w-L@5H*avP$b|J)&5K7Z(A09zip1mdBspaJjby7g@OSKKo_v(0Z)tV(8qM6ddF| zQMRVYvqW(!8%i_G^pqZ#|GgDldeYH;Vc2v1O2vSF(Q}eJvTf~-c$z8k=$Xqwqg$<| zYi>|z@6g))HTy*?6%(N?$!8xYY&x-h-V`K58u=?#nm-u!+O;S|hpo*S2k;3eO?eki z4jr{E>gVi!5@Sw$IbmC5eTSib7rPMXk;wo8O$)l6C`UQ`_ z+T$rl_k&K?DyB>Js$#|)S$LoAfYG={vrHF zkWMC3!uthO*T6isIefFS&fac$WZ;i*+^k}V#NX5eHH(-FiSZ`G3^hGlc-Vy%2_A=2 zDKll^%(ZIvAbWImbfjTncWv@TtuwNw;K@Dih(snmC@h&jm+hgxnwfnas~JmHxTPIp zL9WR*&#o7>mSZ<1B-6UK3E6t14wCz@HNm6Mi3@6LVsiMvcOW7F^O*bgo|!hq&grW|oC%P5%SW?t$e zpHa!k4ZmMwHm6qbA*>SYrRUOs$e3>8W|-qfUY;%v8xoR9lWK0^_#4!=n|2Ho($6VW`?-VoW(Lu_>Fv{t)f!J_0dHAzme^R!k zaw{N&&4S+*sjDNK&a5#OL#N^;r!s#!(BI>)PI^5J`_c@oH0Av%bKl7JHQiUD5UtWT zXG~O_^}*$=iPg`KjH6xHb%@4|3e#-~#yhV6icTz*JBo%6$h+w*0u6@{4D42frp#aDxLqIYI7emV6Vc@YlXepr)WK&MlmGg)2=_+Uc6 z6}x2N(BCN^Yw>%33J=OxRTG-Sa!EDB_E@sM5>l*J6%|&~EpXRM=af$6H`X+aa86#~ zb_RB=lp6sFOUEnJjU1Y9Rwe9L?~j?J?4{P_T4^T?ywJ7aAu~`^xN>7I)xFN5d7^YK z&+$iLz5w0g=e{Ln1fE>tR-dsE>JU0lRFainew^r}N8yEawarxW1h_OHDh~4{xDNxS z5MdoO>;C1#Y{>TEdSU?r6lOj|saew0e z{K&D|I^W%Hkus4*Xe)4x@0$R(`>H9F82>X7mpuMTLB`$4r8kE@ z+J$3(myg0j&SS&H?PxJUq5Q$zTt0GyY4J0Q3jD-W%{Y2V&DHy3L%E0x)@$XCSzbbO z9%rDE0vy`OXRVi}Yb)3I(iWQQi#oN2H3buaRo8|ok!Di1M2lEU-IDgVMs<-LoRqrE zO{ymoQk&D}a>^h%Wgi3N-qCj$Utkq^<)>}EYz={^cKx2{NOZ8VpBwW*c6B5tDkY0T zhLn~~#V6K7_`hAY7BP9?+!HdmTCkeCn2Tn>akocH-Gb*mJoHX!e7x9~nQPm6{O^rP zi@l~B3HOdVo*uTY4mK(D=i+>YgZ#- zhb0cfw=GH_9%CvZ>xV5{7eE1H|7Zc5Jjd`lB+7HBynlaJhdCYTGPbG8-dWmV+F^y_ ztH({bH+?*BOGGh#L{q_}`h;{7`UbhmR5b9Vtr73&A7Z|64~&>%t@;SI(CwWA2(C6t zzo=Btk5YQ*Pqe#O!A|%uu(Hx`VWXil+C+`^YM-ikax*Tv(@9>rHfIT^3DwN;W6A0VNJ&j3 zE!@cxv^n>jKXk@+56hFZ6o&T4(z@TN1`&I+d0YW{G3?=jT!|;~c@1BMxZnH6hFIkR zmUg9M%wsMr{x*M9vE%Lbp|d*aOJT_E*5 zq>UMK9#x(cl%2r%<%SJ4A;y%TojrIZFJvZizK^#!ikOmkv!-+JAEZ{^K;J7i7&{_u zfy!B(@>1Q}-1u9KH}@o$DDh=YvSWhA+;K(ce zwXL&kQ>8Z7wr^I}XXQ@=`7g!>g}mGchZsr6>J%V$xBnHl;eH zms8`)@|xtn+-ktlPBr9F{9n1eUoTtzZNMn808Nf*b(GFGv|%{uOI)ENhL3dks63_M z895V*kK$}zL(@2FWz}gedVky5ywto=xI;A|`FL}8BPujyRq^Tep?zL9jqC%}zk3)@ z!mG8Yk|Mtw7zUlB*KC&qQHlI|kZ>`z-!Z@gx>-`TYu+wo`iZ7JflM_llxct1HTMwVGahgfh1^t%L) zn&vgNmGNl(60UgYUXefQXMCSyj*Z}qDimYIuRQssAw-WO>Bfayr+P$9Xa1ko{((g* zPFlRsQMr|W1|O;4*LLdUu$WG_p@SO8Q(EtpwMNK+_)r=%&NTT~$@MvSw#TyP>RiOo zWIgNPhuxX0-Ksy7^Rtu~ID|WkcQE1dUeGlL_RCZEYKShXZ?0YsF@8s9uaQJwQ8tQN zN2F@Z{q`EF9-gZu=+1TrUFkw_Q~I$b8`xZx;ZMHyKDjfcI@-rrq4S1wwhM~v!eoVU zIc>xOmfy}#42E}2D96ia4;EfehY0(p}9e(>H966x1< zW)`uD31kZkDbQ{)Pq}IFs^wr^bJnM3kWi7?ICLOhFY2v29-E=)DrcA9E#}m_aDO|Y ze;!L}Hm_imB?N;$=1C1``sz|kS8*tquvK-Qn<%*PKEFNzs2Lye83DfxzI+r@#PVoY zybS&zP*+>8PZ{`(e|;<9tp*K^Gw(!4y#uquUzOdLg$bM&@z(cXl>WVnJo9h->Y|LB z$qB9WIaeU8+CrDEc0*>$ZO~B8G!9NoKN$?tpGzf3t6eMOu!#e=JeO`K;$oK>p| z6Ko$D3<)K4tTf*uG2?RG?JXPvw0{C1pY9Yvr+k@j0{N-vov7s>YI`qW7m z_LHOWGOL7UOAP~N+LBx4ptuPK6Q)lHp^^78-%(lv-qD&#v@kS>-liH4J>O0wB|Gw4BmZunxk^Zzm69Z3k@*(*f1TC z6tFck_O@AoxFD~3^(r-%$q<7>ufxl51?=^|?i^*zRBBg~GNiV7zTwzv8fbVWLekil zDn%*Rz$tIQ`o!t6k5$%RU4>)f3JgA69Lu1u$cn|WCWxSg?Sy0VO^I6b+-y_B3gbhr z6_2E7HS0otr$m>URlU7#p5NXlswa60fnrZ;RlE(;^g^Crd~{$lGpI9%(AZ7zQpdY#6#-iEh-x+%g?=fOW_ktCq2O( zoC=r4Y;bOn+!s&oawgq)pWN#0R{Lf$mW9Tg)hp$)7a0GNH6pB1Q1l`~ zFW0tGXPu+wP9xWAD46f^bljCt@2K!)aB<%z)YN6-dYt=Ukvl>>sLy?s{*P!QaK?O% z{g3$?=6jL&wb>~l>>S%^VT*H8v}erMw*M$G@@J&k|CfJ?)t<(}V9FeJdc+>m42+IK z<_KA5j36_Caj6R8`G3y;brQv=L-C+(*D~P?Nzd8yLjI4X`TW-EG_&S;B@v6%jfX>#51|@p zN@fzjUrCbbOSsfIt?Hi}XESE5%ueJ`Bx23rnGt=j(PVS$RJOi`HQf$&-m52E?YXe*Id1y6@7C2KDdk*N z6RC=)lFoOjkuN$Y7D=;p@)}Qk$8Q+Hdb$pkw=sZZmpnJotHVF4${GXhRB$~jdR`f0 znmb)Bpu!%d$fD8e=1OrkOcWTVrhwK8hd%{#oJtdC8vbmCShHh8nvL%~S$mDmiUlCV zzS}GReL)@3yt2qGfo>^ZaTPb{Rp5H>YdX3cqxQ7O=j162pNk-Nem&*mlKbZd&ijq}m|vMp!ZpYV>>{2#i+ z=u(v8_fhSFdmeuPkTc0K%ZLVG28TTQ4r>N5J;-y;ZTNsRw&({;F|64ste%<@Fx22WU$pZCBYcba(!Qp+33TwG_o$bsI za-V&Cn(f3PYZ9PHwfh`r%QD}TkBVtW>D1daZTw&($O)xuVCBu@(&Fz>~n2gsEU}3GVH{LLuuXF{wq3_E+4hJwNVPU2Q z`;83HaSm|n$8TOW2JVbj*aGUd4ic2y@*pf|8BPXw3(JjznjHk(~g$|ybkWK%+J%%<|q#r^$ zX1XOcGJxy8)lDx16Aa6MPi8!4`&nLVJDHh-?gzydtW`rk%SyfMv5K@e1R#Hx`#DGs zlDBjaTkD^d>QJYmOp|H5dOe6Om2}O?w=0Ti-=-Ra488Z%#u13jMoUY}Sh$3QMCO7biQV+yjReDE{7=>Qv72MV4z{&ByTP{~ zHSkeN`y06)epjle5fbXB3*>)d-H8^KephjW-u_;;&@x~!hBWGo*xPsM z!;gAw&t$^ibrMjxt<#9fhwCV3kMH>gCHo4JhXBJO{SKe4mcZle>>MATVeRwl-|RGR z%iYl)t=A8#FVRP0)s!Ck|J^)Ha9Y@IS%1TtloA;s>tzBc6@_bqKSL{QcCIq@EsXSX zCR)pr6nV;x{uFdq5JVq3uB)!SiLBmsP{3v6I$aJAl77Ko<%9`=`_{wtEXp3k3CFH z5hGM=L0GjtN{*I(*Q@%TVtO__$xlW`IbP^^sn92`doD;pe&2S-u+DvFvnli$&HL+| zl%&+Wh?gbqJ3hyMBmuod#oYAOoAr^hC2C%Sqow>*p%FjIO$8oLk!MjD zTfe_0O&Qv>VQVxGZ#z1u+c}AW+izbY9woZyn3a!{J|}*>U1^1RC$kJ2K|u<~e;Ifs zPYxYm%JCmc3}!UbCGysC>fzL(O$GcVzgWvW8+wc0$MAX|RAwa@xFZ43eT8!rSO-=_ zq!>`GNmqgbkB=r#bkHX+HiznuQH0g;rJ;OfEF3__z>5xIy}rBV@n=B0c{Pl1<79ni zH;yyKGrh17!WK{XCdl1>FQ(1hvajMpWh>F4e?wi`TJD!x$4F-AbF>3smnw(xOE{n7 zEyL^LN3kD7XRHFvb$_pnY5aqH;(gMmtg&kPoUJnGdhG-M=g_8^4Vlw96_A^&f-XIZEvV zDW~6FGCXRp^rZ}piiIQ5G=d$eUoPitk4+x#R+wZGBfxw?Lc)2o9qqjJ;&wSLpV&es zT(|N8X1-(grtzTMM3+SIW#kj6hknPW1nNK|P}jnH<_D;f!S4SWg-mqRp*-b6WY4Ws z+_*y;5V*hJdo`*(fty-7S%T11*=ld!5M6A|!wFiW=xdE>8o`H+FY-!#!+VTnO{=E}7-1(cMFbZq&HIC?zq^L&Eg- z&CSo_pPolua|uZ?qT#Iff_|m|1c5(Ih1w&I&dy!0(ZdTG*#J+!0aUby_Xgk-J);4z z+v(QqGy$h0{LEzX_mP2tG7Cau_5HEOe0)8_!?bcn99ktVYX(fR+Tgxl>hvmZ1%F>0 zXhn^dBWfJk+4kej*2bzD1v*nxCwl)#L2R8#neJEm5bH=_loR|Z^SQYrBzAwcD4LHI zsXkImwbm;#-dWU=JZeshEzrj~x{Xb4(#@W$PR=w0x>%ioIfJE>1 zHZ!Q5R1nSkF;xox9}VQBX3r>8C0@@`t$HM3_x#o*C0D1v`E|$Fy~~*Q0SpO2QpLsx z4+?8{N4{C4jT7b{fch<2j{IR6E)yPw+1VD3Kg+C!R8yYTqLv03j(;7P_|#MsuJxqL zWHQh2z+zi&rG7x}?R+cZyi&mljtG_TpO^S33RZf^XH zNszAvAZ5-`@ET#h2}t7zoZ~{XuqG%5s$8iAcV zWW1h3^LGQeVw3SkPxab_krYxGgdStAhi1H<-nmBo#76&QjShmcw6WpXKmOIT4nUpI zM|Z=W=6gT~cK6!K%L4;1!-jy_bg;h%>cc;$LnZQsE7Q5$FBi#(!A^Mtsi&bg-w$6T{WrQjnVZr5i0PTg_V^g z*Y(ph^JY|dug84b$O$w z%9GG)o=YrtYFbSDC?RiK<3CrFC8>3mBTZ$M3lJ*=hyO3fEXCjGL#O%HfL>TEFJUvL)I3a2?pkciyatXJ!E9*6p zdfI7q2Lyzyk&gr@4RLWIi=$-NZHfMWu9>iQ(Ae1cj3z6Zo!u-T^_HAEYf`H@sH5Ji z^Pj&<5jfSdu2@9#-GqO%eD3f#K>Azj+?p|koZzieX5Pr#J@=cA7|vvd@-dbbS{I&05V$Ua z$&YFMZT}cA#N95$?Xge(aA-@s;ui=GxM?ll4VSw@bgI5u2N>zFQIZC{rFeivzKqAP zV@hvf*tu^JV+l)=Ml`sBB{zezYYb{wx_HfMVqEN;4uvQiF^F;Q|BN4D=)wmIi2ChZ zu9^~T!Cj`To%kQ$MGa`?SrkV)R!mXe>wi9ufpRqd7x0meLHChg4>^rxrNa_TB^N>5L+3PO(vze~9{Rs~8#b{Q%0uD&6Cu~a2iTo0bE;%;RKHK{_GvLcypl`Ui^lpa#= z6O*myR+TE06#!9%gel;8)VmDZg26!vZvXiuw_b7we-`5>hZK{I-nNPq>Zn^>OCcX9#AF3B)GHa`>c-V z)~~N8?Q>l(>Ru9?ej-6YP!IT>f%GE5HBrlRy@+~+`gcu(%`a0vs4;|k zI3VO>x#-LCNPnXy)p}O8cWvwFI79L|*Y3e_e#WHa7Mdt$udcJ@uw&SBlpYF$f9Y_T dSP}feq0elWjo74WnJe*{N^+{Q1=6qH{x8G5`GWue literal 0 HcmV?d00001 diff --git a/fetch.ts b/fetch.ts index 027a99c8..d85110f2 100644 --- a/fetch.ts +++ b/fetch.ts @@ -53,6 +53,12 @@ export function wantsJpeg(mime: string): boolean { return mime === "image/heic" || mime === "image/heif"; } +/** HEIC stickers need alpha-preserving PNG, including a still fallback for + * Live Sticker sequences that sips cannot export as an animation. */ +export function wantsStickerPng(mime: string): boolean { + return ["image/heic", "image/heif", "image/heics", "image/heic-sequence", "image/heif-sequence"].includes(String(mime || "").toLowerCase()); +} + /** * Formats whose whole point is that they MOVE. * @@ -79,6 +85,7 @@ export function sanitizeName(name: string): string { * from the sender's filename: "image/png" + "evil.desktop" caches as .png. */ const MIME_EXT: Record = { "image/png": "png", "image/jpeg": "jpg", "image/gif": "gif", "image/webp": "webp", + "image/apng": "png", "image/heic": "jpg", "image/heif": "jpg", "image/tiff": "tiff", "image/bmp": "bmp", "video/mp4": "mp4", "video/quicktime": "mov", "video/x-m4v": "m4v", "audio/mpeg": "mp3", "audio/mp4": "m4a", "audio/x-m4a": "m4a", "audio/aac": "aac", "audio/amr": "amr", @@ -88,18 +95,19 @@ const MIME_EXT: Record = { "audio/x-caf": "ogg", "application/pdf": "pdf", "text/plain": "txt", "text/vcard": "vcf", "text/calendar": "ics", }; -export function cacheFileName(id: string, name: string, mime: string, preview = false): string { +export function cacheFileName(id: string, name: string, mime: string, preview = false, sticker = false): string { // Three transforms, never colliding: `orig` is the untouched file, `jpg` a // sips HEIC→JPEG at full size, `prev` a resampled inline preview. A preview // is ALWAYS JPEG whatever the source was, so its extension is too — // xdg-open dispatches on extension, and a JPEG inside a .png would be a lie // (war room #49). - const transform = preview ? "prev" : wantsJpeg(mime) ? "jpg" : "orig"; + const png = sticker && wantsStickerPng(mime); + const transform = png ? "png" : preview ? "prev" : wantsJpeg(mime) ? "jpg" : "orig"; let base = sanitizeName(name); // The extension is ALWAYS ours. An unmapped type (image/svg+xml, anything // exotic) used to keep the sender's name — "evil.desktop" with an image MIME // passed the opening gate and reached xdg-open by extension (Astra B#1). - const ext = preview ? "jpg" : (MIME_EXT[String(mime || "").toLowerCase()] ?? "bin"); + const ext = png ? "png" : preview ? "jpg" : (MIME_EXT[String(mime || "").toLowerCase()] ?? "bin"); base = base.replace(/\.[^.]{1,8}$/, "") + "." + ext; return `${id}-${transform}-${base}`; } @@ -154,6 +162,21 @@ export function imageMetrics(bytes: Buffer, mime: string): ImageMetrics { }; } + // WebP extended header (including animations), lossless, and lossy. + if (bytes.length >= 30 && bytes.toString("ascii", 0, 4) === "RIFF" && bytes.toString("ascii", 8, 12) === "WEBP") { + const kind = bytes.toString("ascii", 12, 16); + if (kind === "VP8X") return { + pixelWidth: bytes.readUIntLE(24, 3) + 1, pixelHeight: bytes.readUIntLE(27, 3) + 1, pixelRatio: 1, + }; + if (kind === "VP8L" && bytes[20] === 0x2f) return { + pixelWidth: 1 + (bytes.readUInt32LE(21) & 0x3fff), + pixelHeight: 1 + ((bytes.readUInt32LE(21) >>> 14) & 0x3fff), pixelRatio: 1, + }; + if (kind === "VP8 " && bytes[23] === 0x9d && bytes[24] === 0x01 && bytes[25] === 0x2a) return { + pixelWidth: bytes.readUInt16LE(26) & 0x3fff, pixelHeight: bytes.readUInt16LE(28) & 0x3fff, pixelRatio: 1, + }; + } + const png = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]); if (bytes.length >= 24 && bytes.subarray(0, 8).equals(png)) { const pixelWidth = bytes.readUInt32BE(16); @@ -208,22 +231,168 @@ export function imageMetrics(bytes: Buffer, mime: string): ImageMetrics { return { ...EMPTY_IMAGE_METRICS }; } -function cachedImageMetrics(path: string, mime: string): ImageMetrics { +export interface ImageAnimation { animated: boolean; frames: number; format: string } + +/** Sticker images bypass JPEG previewing, so do not let a sender use that + * path to load SVG or another resource-bearing format in the QML renderer. */ +export function stickerRasterMime(bytes: Buffer): string { + if (bytes.length >= 24 && bytes.toString("hex", 0, 8) === "89504e470d0a1a0a" + && bytes.toString("ascii", 12, 16) === "IHDR") return "image/png"; + if (bytes.length >= 4 && bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff) return "image/jpeg"; + if (bytes.length >= 10 && ["GIF87a", "GIF89a"].includes(bytes.toString("ascii", 0, 6))) return "image/gif"; + if (bytes.length >= 30 && bytes.toString("ascii", 0, 4) === "RIFF" && bytes.toString("ascii", 8, 12) === "WEBP" + && ["VP8X", "VP8L", "VP8 "].includes(bytes.toString("ascii", 12, 16))) return "image/webp"; + return ""; +} + +function stickerRasterValid(bytes: Buffer, mime: string): boolean { + const expected = mime === "image/apng" ? "image/png" : mime; + if (stickerRasterMime(bytes) !== expected) return false; + const metrics = imageMetrics(bytes, expected); + return metrics.pixelWidth > 0 && metrics.pixelHeight > 0 && metrics.pixelWidth <= 2048 && metrics.pixelHeight <= 2048; +} + +/** Only inspect bounded container headers. PNG's acTL precedes IDAT. */ +export function imageAnimation(bytes: Buffer): ImageAnimation { + const plain = { animated: false, frames: 1, format: "" }; + if (bytes.length >= 10 && ["GIF87a", "GIF89a"].includes(bytes.toString("ascii", 0, 6))) + return { animated: true, frames: 0, format: "gif" }; + if (bytes.length >= 30 && bytes.toString("ascii", 0, 4) === "RIFF" && bytes.toString("ascii", 8, 12) === "WEBP") + return { animated: bytes.toString("ascii", 12, 16) === "VP8X" && (bytes[20]! & 2) !== 0, frames: 0, format: "webp" }; + if (bytes.length < 24 || bytes.toString("hex", 0, 8) !== "89504e470d0a1a0a") return plain; + for (let pos = 8; pos + 12 <= bytes.length;) { + const length = bytes.readUInt32BE(pos); + if (length > IMAGE_HEADER_BYTES || pos + 12 + length > bytes.length) break; + const type = bytes.toString("ascii", pos + 4, pos + 8); + if (type === "acTL" && length === 8) { + const frames = bytes.readUInt32BE(pos + 8); + return { animated: frames > 1, frames, format: "png" }; + } + if (type === "IDAT" || type === "IEND") break; + pos += length + 12; + } + return { ...plain, format: "png" }; +} + +/** Qt's PNG reader renders APNG as a still. Convert only the inline sticker + * preview to lossless animated WebP, preserving alpha. Originals still back + * explicit Open/Copy/Save; no conversation text enters files or argv. */ +export function stickerAnimationPreview(bytes: Buffer, runner = spawnSync, dir = CACHE_DIR): { bytes: Buffer; converted: boolean; unavailable: boolean } { + const animation = imageAnimation(bytes.subarray(0, IMAGE_HEADER_BYTES)); + if (animation.format !== "png" || !animation.animated) return { bytes, converted: false, unavailable: false }; + const size = imageMetrics(bytes.subarray(0, IMAGE_HEADER_BYTES), "image/png"); + if (animation.frames > 100 || size.pixelWidth <= 0 || size.pixelHeight <= 0 + || size.pixelWidth > 2048 || size.pixelHeight > 2048 + || size.pixelWidth * size.pixelHeight * animation.frames > 64_000_000) + return { bytes, converted: false, unavailable: true }; + // FFmpeg 6's APNG demuxer asks for input length even with ignore_loop=1; + // a looping APNG on stdin fails with ENOSYS. Keep one bounded, seekable + // private media file, as with HEICS, and remove it on every exit path. + const tmp = join(dir, `.sticker-${process.pid}-${Math.random().toString(36).slice(2, 10)}.apng`); + try { + mkdirSync(dir, { recursive: true, mode: 0o700 }); + const fd = openSync(tmp, "wx", 0o600); + try { writeSync(fd, bytes); } finally { closeSync(fd); } + const res = runner("ffmpeg", ["-nostdin", "-v", "error", "-protocol_whitelist", "file,pipe", "-f", "apng", "-ignore_loop", "1", "-i", tmp, + "-map_metadata", "-1", "-c:v", "libwebp_anim", "-lossless", "1", "-loop", "0", + "-frames:v", "100", "-f", "webp", "pipe:1"], + { timeout: 30000, maxBuffer: FETCH_MAX_BYTES + (1 << 20) }); + const out = res.stdout as Buffer; + if (res.status === 0 && Buffer.isBuffer(out) && out.length > 30 && imageAnimation(out).format === "webp") + return { bytes: out, converted: true, unavailable: false }; + } catch { /* A missing ffmpeg or decoder retains a usable transparent still. */ } + finally { try { unlinkSync(tmp); } catch { /* no temp file survived */ } } + return { bytes, converted: false, unavailable: true }; +} + +interface StickerSequenceResult { bytes: Buffer; renderMime: "image/webp" | "image/png"; unavailable: boolean } + +/** Live Stickers use a color track and a separate grayscale alpha track. + * In HEICS the first pair is the still image; tracks 2/3 are the animation. + * Probe only container metadata before allowing bounded decode. A private + * media temp file supplies seekable input (MOV/HEICS often puts moov last). + */ +export function stickerSequencePreview(bytes: Buffer, mime: string, runner = spawnSync, dir = CACHE_DIR): StickerSequenceResult | undefined { + if (!bytes.length || bytes.length > FETCH_MAX_BYTES) return undefined; + const tmp = join(dir, `.sticker-${process.pid}-${Math.random().toString(36).slice(2, 10)}.media`); + try { + mkdirSync(dir, { recursive: true, mode: 0o700 }); + const fd = openSync(tmp, "wx", 0o600); + try { writeSync(fd, bytes); } finally { closeSync(fd); } + const probe = runner("ffprobe", ["-v", "error", "-protocol_whitelist", "file,pipe", + "-show_entries", "stream=index,codec_type,width,height,nb_frames,duration,pix_fmt", + "-of", "json", tmp], { timeout: 10000, maxBuffer: 65536 }); + if (probe.status !== 0) return undefined; + const data = JSON.parse(String(probe.stdout)); + if (!Array.isArray(data.streams) || data.streams.length > 8) return undefined; + const video = data.streams.filter((s: any) => s.codec_type === "video"); + const heics = wantsStickerPng(mime); + if (!video.length || (heics && video.length < 4)) return undefined; + const color = heics ? video[2] : video[0]; + const mask = heics ? video[3] : video.length === 2 && /^gray/.test(video[1].pix_fmt) ? video[1] : null; + const width = Number(color.width), height = Number(color.height), count = Number(color.nb_frames), seconds = Number(color.duration); + const validSize = (s: any) => Number.isInteger(s.index) && s.index >= 0 && s.index <= 16 + && Number.isInteger(s.width) && Number.isInteger(s.height) && s.width > 0 && s.height > 0 && s.width <= 2048 && s.height <= 2048; + if (!validSize(color) || (mask && (!validSize(mask) || mask.width !== width || mask.height !== height || !/^gray/.test(mask.pix_fmt)))) return undefined; + const animate = Number.isInteger(count) && count > 1 && count <= 100 + && width * height * count <= 64_000_000 && Number.isFinite(seconds) && seconds > 0 && seconds <= 8; + const filter = mask + ? `[0:${color.index}][0:${mask.index}]alphamerge,format=rgba[out]` + : `[0:${color.index}]format=rgba[out]`; + const output = animate + ? ["-c:v", "libwebp_anim", "-lossless", "1", "-loop", "0", "-frames:v", "100", "-t", "8", "-f", "webp"] + : ["-c:v", "png", "-frames:v", "1", "-f", "image2pipe"]; + const result = runner("ffmpeg", ["-nostdin", "-v", "error", "-protocol_whitelist", "file,pipe", + "-threads", "1", "-i", tmp, "-filter_complex_threads", "1", "-filter_complex", filter, + "-map", "[out]", "-an", "-map_metadata", "-1", ...output, "pipe:1"], + { timeout: 30000, maxBuffer: FETCH_MAX_BYTES + (1 << 20) }); + const out = result.stdout as Buffer; + if (result.status !== 0 || !Buffer.isBuffer(out) || out.length > FETCH_MAX_BYTES) return undefined; + const format = imageAnimation(out).format; + if ((animate && format !== "webp") || (!animate && format !== "png")) return undefined; + return { bytes: out, renderMime: animate ? "image/webp" : "image/png", unavailable: !animate }; + } catch { return undefined; } + finally { try { unlinkSync(tmp); } catch { /* no temp file survived */ } } +} + +function cachedImageMetrics(path: string, mime: string): ImageMetrics & { animated: boolean; animationUnavailable: boolean; rasterMime: string } { + const empty = { ...EMPTY_IMAGE_METRICS, animated: false, animationUnavailable: false, rasterMime: "" }; let fd = -1; try { fd = openSync(path, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK); const st = fstatSync(fd); - if (!st.isFile() || st.uid !== process.getuid() || st.size <= 0) return { ...EMPTY_IMAGE_METRICS }; + if (!st.isFile() || st.uid !== process.getuid() || st.size <= 0) return empty; const header = Buffer.alloc(Math.min(st.size, IMAGE_HEADER_BYTES)); const count = readSync(fd, header, 0, header.length, 0); - return imageMetrics(header.subarray(0, count), mime); + const bytes = header.subarray(0, count); + const animation = imageAnimation(bytes); + return { ...imageMetrics(bytes, mime), animated: animation.animated && animation.format !== "png", + animationUnavailable: animation.animated && animation.format === "png", rasterMime: stickerRasterMime(bytes) }; } catch { - return { ...EMPTY_IMAGE_METRICS }; + return empty; } finally { if (fd >= 0) closeSync(fd); } } +function cachedMediaBytes(path: string, cap: number): Buffer | undefined { + let fd = -1; + try { + fd = openSync(path, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK); + const stat = fstatSync(fd); + if (!stat.isFile() || stat.uid !== process.getuid() || stat.size <= 0 || stat.size > cap) return undefined; + const bytes = Buffer.alloc(stat.size); + let offset = 0; + while (offset < bytes.length) { + const n = readSync(fd, bytes, offset, bytes.length - offset, offset); + if (!n) return undefined; + offset += n; + } + return bytes; + } catch { return undefined; } + finally { if (fd >= 0) closeSync(fd); } +} + function evict(keep: string): void { let entries: { name: string; bytes: number; mtimeMs: number }[] = []; try { @@ -348,6 +517,12 @@ export interface FetchResult { pixelWidth: number; pixelHeight: number; pixelRatio: number; + /** Actual cached bytes, for clipboard MIME and sticker render selection. */ + renderMime: string; + animated: boolean; + /** A transparent still is available, but its source animation could not be decoded. */ + animationUnavailable: boolean; + /** Real decoded envelope, kept in memory; absent for non-audio media. */ } /** An iPhone voice message (CAF, Opus inside) → Ogg Opus, so the default @@ -383,24 +558,52 @@ export function fetchAttachment( mime: string, runner = spawnSync, maxBytes = FETCH_MAX_BYTES, + sticker = false, ): FetchResult { const fail = (error: string, online = true): FetchResult => - ({ ok: false, online, path: "", url: "", error, ...EMPTY_IMAGE_METRICS }); + ({ ok: false, online, path: "", url: "", error, ...EMPTY_IMAGE_METRICS, + renderMime: "", animated: false, animationUnavailable: false }); if (!/^[0-9]{1,18}$/.test(id)) return fail("bad attachment id"); + mime = String(mime || "").toLowerCase(); + if (sticker && !["image/png", "image/apng", "image/jpeg", "image/gif", "image/webp"].includes(mime) + && !wantsStickerPng(mime) && !mime.startsWith("video/")) return fail("unsupported sticker media format"); mkdirSync(CACHE_DIR, { recursive: true, mode: 0o700 }); - const preview = maxBytes < FETCH_MAX_BYTES && isImageMime(mime) && !isAnimatedMime(mime); - const file = join(CACHE_DIR, cacheFileName(id, name, mime, preview)); - try { - const st = lstatSync(file); + const auto = maxBytes < FETCH_MAX_BYTES; + const preview = auto && isImageMime(mime) && !isAnimatedMime(mime) && !sticker; + const png = sticker && wantsStickerPng(mime); + const animatedPreview = sticker && auto && ["image/png", "image/apng"].includes(mime.toLowerCase()); + const sequencePreview = sticker && auto && (mime.toLowerCase().startsWith("video/") + || (png && !["image/heic", "image/heif"].includes(mime.toLowerCase()))); + const rawFile = join(CACHE_DIR, cacheFileName(id, name, mime, preview, sticker)); + const animationFile = join(CACHE_DIR, cacheFileName(id, name, "image/webp").replace(`${id}-orig-`, `${id}-anim-`)); + const stillFile = join(CACHE_DIR, cacheFileName(id, name, "image/png").replace(`${id}-orig-`, `${id}-still-`)); + let file = rawFile; + let cachedRaw: Buffer | undefined; + let renderMime = png ? "image/png" : preview || wantsJpeg(mime) ? "image/jpeg" : mime; + const sequenceStill = png && !["image/heic", "image/heif"].includes(mime.toLowerCase()); + const candidates = sequencePreview ? [animationFile, stillFile].concat(png ? [rawFile] : []) + : animatedPreview ? [animationFile, rawFile] : [rawFile]; + for (const candidate of candidates) try { + const st = lstatSync(candidate); // A symlink planted in the cache must never be followed (or touched). - if (st.isFile() && st.size > 0) { + if (st.isFile() && st.size > 0 && st.size <= Math.min(maxBytes, FETCH_MAX_BYTES)) { const now = new Date(); - utimesSync(file, now, now); // mtime is the LRU clock + utimesSync(candidate, now, now); // mtime is the LRU clock + const cachedMime = candidate === animationFile ? "image/webp" : candidate === stillFile ? "image/png" : renderMime; + const { rasterMime, ...metrics } = cachedImageMetrics(candidate, cachedMime); + if (sticker && !cachedMime.startsWith("video/") && (rasterMime !== (cachedMime === "image/apng" ? "image/png" : cachedMime) + || metrics.pixelWidth <= 0 || metrics.pixelHeight <= 0 || metrics.pixelWidth > 2048 || metrics.pixelHeight > 2048)) + return fail("sticker media is not a supported bounded raster image"); + if (animatedPreview && candidate === rawFile && metrics.animationUnavailable) { + cachedRaw = cachedMediaBytes(candidate, Math.min(maxBytes, FETCH_MAX_BYTES)); + if (cachedRaw) break; // convert an already cached APNG without another bridge read + } return { - ok: true, online: true, path: file, url: pathToFileURL(file).href, error: "", - ...cachedImageMetrics(file, mime), + ok: true, online: true, path: candidate, url: pathToFileURL(candidate).href, error: "", + renderMime: cachedMime, ...metrics, + animationUnavailable: candidate !== animationFile && (sequenceStill || candidate === stillFile || metrics.animationUnavailable), }; } } catch { /* not cached */ } @@ -415,10 +618,10 @@ export function fetchAttachment( // still fetch the untouched original into `-orig-…`. const args = [ "attachment", id, - ...(wantsJpeg(mime) || preview ? ["--jpeg"] : []), + ...(png && !sequencePreview ? ["--png"] : !sequencePreview && (wantsJpeg(mime) || preview) ? ["--jpeg"] : []), ...(preview ? ["--max-dim", String(PREVIEW_MAX_DIM)] : []), ]; - const res = runner(shimPath("imsg"), args, { + const res = cachedRaw ? { status: 0, stdout: cachedRaw, stderr: "" } : runner(shimPath("imsg"), args, { timeout: 120000, maxBuffer: FETCH_MAX_BYTES + (1 << 20), }); @@ -430,9 +633,46 @@ export function fetchAttachment( const raw = res.stdout as Buffer; if (!raw || raw.length === 0) return fail("empty attachment stream"); if (raw.length > Math.min(maxBytes, FETCH_MAX_BYTES)) return fail("attachment exceeds the fetch ceiling"); - const bytes = String(mime || "").toLowerCase() === "audio/x-caf" + let bytes = String(mime || "").toLowerCase() === "audio/x-caf" ? rewrapCaf(raw, runner) : bakeOrientation(raw, runner); + let animationUnavailable = sequenceStill; + if (sequencePreview) { + const converted = stickerSequencePreview(bytes, mime, runner); + if (converted && converted.bytes.length <= Math.min(maxBytes, FETCH_MAX_BYTES)) { + bytes = converted.bytes; + file = converted.renderMime === "image/webp" ? animationFile : stillFile; + renderMime = converted.renderMime; + animationUnavailable = converted.unavailable; + } else if (png) { + // A missing ffmpeg, unknown HEICS layout, or oversized preview still + // gets the Mac's transparent first image. Never cache raw HEICS as PNG. + const fallback = runner(shimPath("imsg"), ["attachment", id, "--png"], + { timeout: 120000, maxBuffer: FETCH_MAX_BYTES + (1 << 20) }); + if (fallback.status === 69 || fallback.status === 255) return fail("Mac unreachable", false); + const still = fallback.stdout as Buffer; + if (fallback.status !== 0 || !Buffer.isBuffer(still) || imageAnimation(still).format !== "png") + return fail("sticker animation and still preview unavailable"); + if (still.length > Math.min(maxBytes, FETCH_MAX_BYTES)) return fail("sticker preview exceeds the fetch ceiling"); + bytes = still; + animationUnavailable = true; + } else { + return fail("sticker video preview unavailable; open the original attachment"); + } + } + if (animatedPreview) { + const converted = stickerAnimationPreview(bytes, runner); + animationUnavailable = converted.unavailable; + if (converted.converted) { + if (converted.bytes.length <= Math.min(maxBytes, FETCH_MAX_BYTES)) { + bytes = converted.bytes; + file = animationFile; + renderMime = "image/webp"; + } else animationUnavailable = true; + } + } + if (sticker && !renderMime.startsWith("video/") && !stickerRasterValid(bytes.subarray(0, IMAGE_HEADER_BYTES), renderMime)) + return fail("sticker media is not a supported bounded raster image"); // tmp + fsync + rename: a killed fetch must never leave a cache hit that // looks complete. @@ -446,10 +686,13 @@ export function fetchAttachment( closeSync(fd); } renameSync(tmp, file); - evict(cacheFileName(id, name, mime, preview)); + evict(file.slice(file.lastIndexOf("/") + 1)); + const animation = imageAnimation(bytes.subarray(0, IMAGE_HEADER_BYTES)); return { ok: true, online: true, path: file, url: pathToFileURL(file).href, error: "", - ...imageMetrics(bytes.subarray(0, IMAGE_HEADER_BYTES), mime), + ...imageMetrics(bytes.subarray(0, IMAGE_HEADER_BYTES), renderMime), renderMime, + animated: animation.animated && animation.format !== "png", + animationUnavailable: animationUnavailable || (animation.animated && animation.format === "png"), }; } @@ -457,7 +700,7 @@ if (import.meta.main) { const [id, name, mime] = [process.argv[2] ?? "", process.argv[3] ?? "file", process.argv[4] ?? ""]; const cap = Number(process.argv[5] ?? ""); try { - console.log(JSON.stringify(fetchAttachment(id, name, mime, undefined, cap > 0 ? cap : FETCH_MAX_BYTES))); + console.log(JSON.stringify(fetchAttachment(id, name, mime, undefined, cap > 0 ? cap : FETCH_MAX_BYTES, process.argv.includes("--sticker")))); } catch (e) { console.log(JSON.stringify({ ok: false, online: true, path: "", url: "", error: String(e) })); } diff --git a/save-attachment.ts b/save-attachment.ts index d0356625..698e5aaf 100644 --- a/save-attachment.ts +++ b/save-attachment.ts @@ -26,13 +26,13 @@ import { CACHE_DIR, FETCH_MAX_BYTES } from "./fetch"; const CONTROL = /[\x00-\x1f\x7f-\x9f\u202a-\u202e\u2066-\u2069]/; -/** Only an original (`-orig-…`) or the full-size HEIC→JPEG (`-jpg-…`) +/** Only an original (`-orig-…`) or full-size HEIC→JPEG/PNG (`-jpg-`/`-png-`) * inside the media cache is a valid source: never a preview, never a path a * caller made up. Returns the resolved path. */ export function cachedOriginal(path: string, cacheDir = CACHE_DIR): string { if (typeof path !== "string" || !isAbsolute(path) || CONTROL.test(path)) throw new Error("Invalid attachment path"); const resolved = realpathSync(path); - if (dirname(resolved) !== realpathSync(cacheDir) || !/^[^/]+-(orig|jpg)-[^/]+$/.test(basename(resolved))) + if (dirname(resolved) !== realpathSync(cacheDir) || !/^[^/]+-(orig|jpg|png)-[^/]+$/.test(basename(resolved))) throw new Error("Not a fetched original"); const st = lstatSync(resolved); if (!st.isFile()) throw new Error("Not a fetched original"); diff --git a/scripts/blip-setup b/scripts/blip-setup index d5a02a45..4a54524f 100755 --- a/scripts/blip-setup +++ b/scripts/blip-setup @@ -30,6 +30,13 @@ for dep in ssh scp bun jq notify-send wl-copy xdg-open; do [[ " ${pkgs[*]} " == *" ${pkg_for[$dep]} "* ]] || pkgs+=("${pkg_for[$dep]}") fi done +webp_available=0 +for qt_root in /usr/lib/qt6 /usr/lib64/qt6 /usr/lib/x86_64-linux-gnu/qt6 /usr/lib/aarch64-linux-gnu/qt6; do + [[ -f "$qt_root/plugins/imageformats/libqwebp.so" ]] && webp_available=1 + done +if (( !webp_available )); then + missing+=("Qt WebP image plugin"); pkgs+=(qt6-imageformats) +fi if (( ${#missing[@]} )); then echo "✗ missing on this machine: ${missing[*]}" >&2 echo " sudo pacman -S --needed ${pkgs[*]} (Omarchy/Arch names), then re-run blip-setup" >&2 diff --git a/scripts/demo/fake-imsg b/scripts/demo/fake-imsg index 93148815..66a026c9 100755 --- a/scripts/demo/fake-imsg +++ b/scripts/demo/fake-imsg @@ -105,14 +105,15 @@ function conversation(): Row[] { tapback: m.tapback === true, error: 0, read_at: m.read_at ? stamp(Number(m.min) + 2) : null, - tapbacks: null, + tapbacks: m.tapbacks || null, + stickers: Array.isArray(m.stickers) ? (m.stickers as any[]).map(sticker => ({...sticker, ts: stamp(Number(m.min) + 1)})) : [], attachments: Array.isArray(m.attachments) - ? (m.attachments as unknown as Array<{ name: string; mime: string }>).map((a, k) => ({ - id: String(700000 + i * 10 + k), name: a.name, mime: a.mime, bytes: 1843200, + ? (m.attachments as unknown as Array<{ name: string; mime: string; sticker?: unknown }>).map((a, k) => ({ + id: String(700000 + i * 10 + k), name: a.name, mime: a.mime, bytes: a.mime.startsWith("audio/") ? 1152044 : a.sticker ? 12000 : 1843200, ...(a.sticker ? {sticker:a.sticker} : {}), })) : null, reply_to: m.reply_to ? { text: String(m.reply_to), from_me: false } : null, - edited: m.edited === true, retracted: m.retracted === true, effect: null, audio: false, link: null, + edited: m.edited === true, retracted: m.retracted === true, effect: null, audio: m.audio === true, link: null, }; return row; }); @@ -205,12 +206,19 @@ function main(): void { if (sub === "attachment") { const dim = val("--max-dim") || "1600"; const id = argv.find((a) => /^[0-9]+$/.test(a)) ?? "0"; + const isSticker = id === "990001" || id === "990002" || conversation().some(row => (row.attachments as any[] || []).some(a => a.id === id && a.sticker)); + if (isSticker) { + // Procedural transparent art: no real person's image or downloaded media. + const r = spawnSync("magick", ["-size", "192x192", "xc:none", "-fill", "#ffd45c", "-stroke", "#edb742", "-strokewidth", "3", "-draw", "polygon 96,10 118,64 176,68 132,108 146,168 96,138 46,168 60,108 16,68 74,64", "-stroke", "none", "-fill", "#513d32", "-draw", "circle 75,87 79,87 circle 117,87 121,87", "-stroke", "#513d32", "-strokewidth", "5", "-fill", "none", "-draw", "path 'M 76,110 Q 96,130 116,110'", "png:-"], { maxBuffer: 8 << 20 }); + if (r.status !== 0 || !r.stdout?.length) process.exit(1); + process.stdout.write(r.stdout as Buffer); return; + } const hue = (Number(id) % 12) * 30; const r = spawnSync("magick", [ "-size", `${dim}x${Math.round(Number(dim) * 0.75)}`, `gradient:hsl(${hue},60%,42%)-hsl(${(hue + 40) % 360},55%,22%)`, "-gravity", "center", "-font", FONT, "-pointsize", String(Math.round(Number(dim) / 12)), - "-fill", "white", "-annotate", "+0+0", "demo photo", + "-fill", "white", "-annotate", "+0+0", "LAKE TRAIL", "-quality", "80", "jpg:-", ], { maxBuffer: 32 << 20 }); if (r.status !== 0 || !r.stdout?.length) process.exit(1); diff --git a/scripts/demo/fixtures.json b/scripts/demo/fixtures.json index 1869c957..c19b500d 100644 --- a/scripts/demo/fixtures.json +++ b/scripts/demo/fixtures.json @@ -106,7 +106,7 @@ { "min": -181, "from_me": false, - "text": "Loved “7 works. bringing the good thermos”", + "text": "Loved \u201c7 works. bringing the good thermos\u201d", "tapback": true }, { @@ -140,6 +140,78 @@ "from_me": true, "text": "on my way, ten minutes out", "read_at": true + }, + { + "min": -12, + "from_me": false, + "text": "Perfect. I found a new overlook for our coffee stop.", + "stickers": [ + { + "attachment": { + "id": "990001", + "name": "sunshine.png", + "mime": "image/png", + "bytes": 12000, + "sticker": { + "source": "user", + "label": "Sunshine sticker", + "animated": false + } + }, + "guid": "DEMO-STICKER-1", + "part": 0, + "from_me": true, + "by": "You", + "placement": { + "x": 1.0, + "y": 0.0, + "scale": 1.0, + "rotation": -0.12, + "parentWidth": 300 + } + } + ] + }, + { + "min": -10, + "from_me": true, + "text": "", + "attachments": [ + { + "name": "happy-star.png", + "mime": "image/png", + "sticker": { + "source": "user", + "label": "Happy star sticker", + "animated": false + } + } + ] + }, + { + "min": -8, + "from_me": false, + "text": "See you there!", + "stickers": [ + { + "reaction": true, + "attachment": { + "id": "990002", + "name": "reaction-star.png", + "mime": "image/png", + "bytes": 12000, + "sticker": { + "source": "user", + "label": "Star reaction", + "animated": false + } + }, + "guid": "DEMO-REACTION-STICKER", + "part": 0, + "from_me": true, + "by": "You" + } + ] } ] } diff --git a/scripts/test-sticker-ui.py b/scripts/test-sticker-ui.py new file mode 100644 index 00000000..a09a530e --- /dev/null +++ b/scripts/test-sticker-ui.py @@ -0,0 +1,163 @@ +#!/usr/bin/env python3 +"""Decode synthetic sticker media through the shipping fetcher and QML item. + +Requires Bun, ffmpeg/ffprobe, and Qt 6 QtQuick/QtTest. No Mac, network, real +Messages rows, or live app is used. --capture writes a synthetic preview. +""" +import argparse +import json +import os +from pathlib import Path +import shutil +import struct +import subprocess +import tempfile +import zlib + + +ROOT = Path(__file__).resolve().parents[1] + + +def png(width, height, raw, channels): + def chunk(kind, data): + return struct.pack(">I", len(data)) + kind + data + struct.pack(">I", zlib.crc32(kind + data)) + scan = b"".join(b"\0" + raw[y * width * channels:(y + 1) * width * channels] for y in range(height)) + return (b"\x89PNG\r\n\x1a\n" + chunk(b"IHDR", struct.pack(">IIBBBBB", width, height, 8, 6 if channels == 4 else 0, 0, 0, 0)) + + chunk(b"IDAT", zlib.compress(scan)) + chunk(b"IEND", b"")) + + +def run(command, **kwargs): + subprocess.run(command, check=True, timeout=45, **kwargs) + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--capture", type=Path) + args = parser.parse_args() + runner = shutil.which("qmltestrunner") or next((str(p) for p in ( + Path("/usr/lib/qt6/bin/qmltestrunner"), Path("/usr/lib/qt6/libexec/qmltestrunner")) if p.is_file()), None) + if not runner: + raise SystemExit("Qt 6 qmltestrunner not found") + if not shutil.which("ffmpeg") or not shutil.which("ffprobe"): + raise SystemExit("ffmpeg and ffprobe are required for the synthetic codec test") + with tempfile.TemporaryDirectory(prefix="blip-sticker-ui-") as directory: + folder = Path(directory) + width = height = 64 + mask = bytes(128 if (x - 32) ** 2 + (y - 32) ** 2 < 24 ** 2 else 0 + for y in range(height) for x in range(width)) + red = b"".join(bytes((240, 80, 100, a)) for a in mask) + blue = b"".join(bytes((60, 160, 250, a)) for a in mask) + (folder / "still.png").write_bytes(png(width, height, red, 4)) + (folder / "mask.png").write_bytes(png(width, height, mask, 1)) + run(["ffmpeg", "-v", "error", "-f", "rawvideo", "-pixel_format", "rgba", "-video_size", "64x64", + "-framerate", "5", "-i", "pipe:0", "-plays", "0", "-f", "apng", str(folder / "animated.png")], input=red + blue) + # Four independently addressable tracks model HEICS's still pair + # and animated color/alpha pair, without importing someone's sticker. + run(["ffmpeg", "-v", "error", "-f", "lavfi", "-i", "testsrc=size=64x64:rate=5:duration=1", + "-loop", "1", "-framerate", "5", "-i", str(folder / "mask.png"), "-t", "1", + "-map", "0:v", "-map", "1:v", "-map", "0:v", "-map", "1:v", "-c:v", "png", + str(folder / "four-track.mov")]) + prepare = folder / "prepare.ts" + prepare.write_text('''import { readFileSync, writeFileSync } from "node:fs"; +import { spawnSync } from "node:child_process"; +import { stickerAnimationPreview, stickerSequencePreview } from @MODULE@; +const dir = process.argv[2]; +// Synthetic inputs only: expose codec diagnostics here, never in shipping +// message/media logs. CI must explain unsupported decoders rather than skip. +const diagnosticRunner = ((command, args, options) => { + const result = spawnSync(command, args, options); + if (result.status !== 0) console.error(command, "exit", result.status, + String(result.stderr || "").slice(0, 4096), result.error?.message || ""); + return result; +}) as typeof spawnSync; +const apng = stickerAnimationPreview(readFileSync(dir + "/animated.png"), diagnosticRunner, dir); +if (!apng.converted || apng.unavailable) throw Error("APNG conversion failed"); +writeFileSync(dir + "/animated.webp", apng.bytes); +const sequence = stickerSequencePreview(readFileSync(dir + "/four-track.mov"), "image/heic-sequence", diagnosticRunner, dir); +if (!sequence || sequence.unavailable || sequence.renderMime !== "image/webp") throw Error("sequence conversion failed"); +writeFileSync(dir + "/sequence.webp", sequence.bytes); +'''.replace("@MODULE@", json.dumps(str(ROOT / "fetch.ts")))) + run(["bun", str(prepare), str(folder)], env={**os.environ, "XDG_CACHE_HOME": str(folder / "cache")}) + shutil.copy(ROOT / "StickerImage.qml", folder) + shutil.copy(ROOT / "Stickers.mjs", folder) + capture = "" if args.capture is None else str(args.capture.resolve()) + if capture: + args.capture.resolve().parent.mkdir(parents=True, exist_ok=True) + (folder / "tst_sticker.qml").write_text('''import QtQuick +import QtTest +import "Stickers.mjs" as Stickers +Item { + id: root + width: 580; height: 220 + Rectangle { anchors.fill: parent; color: "#202127" } + StickerImage { + id: still; x: 20; y: 30; width: 160; height: 160 + source: "still.png" + attachment: ({sticker:{label:"Synthetic translucent circle"}}) + } + StickerImage { + id: apng; x: 210; y: 30; width: 160; height: 160 + source: "animated.webp"; animated: true + } + StickerImage { + id: sequence; x: 400; y: 30; width: 160; height: 160 + source: "sequence.webp"; animated: true + } + TestCase { + name: "StickerRendering" + when: windowShown + function initTestCase() { + tryCompare(still, "ready", true) + tryCompare(apng, "ready", true) + tryCompare(sequence, "ready", true) + } + function test_alpha_survives_static_and_animated_paths() { + for (var item of [still, apng, sequence]) { + var captured = grabImage(item) + // grabImage includes the parent's opaque background. Transparent + // corners must show that background, never black or an image matte. + compare(captured.red(1, 1), 32) + compare(captured.green(1, 1), 33) + compare(captured.blue(1, 1), 39) + } + var staticImage = grabImage(still) + // The center is 50% red over the background, not opaque source red. + verify(staticImage.red(80, 80) > 130 && staticImage.red(80, 80) < 145) + } + function test_frames_advance_for_both_animation_formats() { + compare(apng.frameCount, 2) + compare(sequence.frameCount, 5) + for (var item of [apng, sequence]) { + var first = item.currentFrame + tryVerify(function() { return item.currentFrame !== first }, 2000) + } + } + function test_pause_releases_animation_work() { + apng.playing = false + wait(250) + var first = apng.currentFrame + wait(400) + compare(apng.currentFrame, first) + apng.playing = true + } + function test_geometry_module_loads_in_qml() { + var g = Stickers.stickerGeometry({x:1,y:0,scale:1,rotation:0.5}, 180, 80, 64, 64) + verify(g.placed) + verify(g.width > 0 && isFinite(g.rotation)) + compare(Stickers.placedStickers([{part:0,placement:{x:0.5,y:0.5,scale:1,rotation:0}}]).length, 1) + } + function cleanupTestCase() { + var path = @CAPTURE@ + if (path !== "") grabImage(root).save(path) + } + } +} +'''.replace("@CAPTURE@", json.dumps(capture))) + result = subprocess.run([runner, "-input", str(folder), "-platform", "offscreen"], timeout=30, + env={**os.environ, "QT_QPA_PLATFORM": "offscreen", "QT_QPA_PLATFORMTHEME": "generic", + "QT_QUICK_BACKEND": "software"}) + return result.returncode + + +if __name__ == "__main__": + raise SystemExit(main()) diff --git a/stickers.test.ts b/stickers.test.ts new file mode 100644 index 00000000..657b5746 --- /dev/null +++ b/stickers.test.ts @@ -0,0 +1,301 @@ +import { describe, expect, test } from "bun:test"; +import { mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from "node:fs"; +import { tmpdir } from "node:os"; +import { join } from "node:path"; +import { decorate } from "./thread"; +import { dedupeSelfEcho, messagePreview, type ImsgMessage } from "./collector"; +import { MAX_VISIBLE_STICKERS, normalizeStickerAttachment, normalizeStickerMetadata, + normalizeStickerOverlays, normalizeStickerPlacement, placedStickers, unplacedStickers, reactionStickers, stickerGeometry, + type StickerOverlay } from "./stickers"; +import { CACHE_DIR, FETCH_MAX_BYTES, cacheFileName, fetchAttachment, imageAnimation, imageMetrics, + stickerAnimationPreview, stickerSequencePreview, wantsStickerPng } from "./fetch"; +import { cachedOriginal } from "./save-attachment"; + +const position = { x: 0.9, y: 0.1, scale: 1.2, rotation: -.2, parentWidth: 160 }; +const overlay = (n = 1): StickerOverlay => ({ + attachment: { id: String(n), name: "sticker.png", mime: "image/png", bytes: 128, + sticker: { source: "user", label: "Heart", placement: position } }, + guid: `S${n}`, part: 0, from_me: false, by: "Example", ts: "2026-11-06T10:01:00Z", placement: position, +}); +const message = (overrides: Partial = {}): ImsgMessage => ({ + guid: "P", ts: "2026-11-06T10:00:00Z", text: "Example", from_me: false, + chat: "+15551234567", handle: "+15551234567", name: null, service: "iMessage", ...overrides, +}); + +describe("sticker presentation model", () => { + test("a transparent photo never becomes a sticker based on its filename or MIME", () => { + const a = { name: "sticker.png", mime: "image/png", bytes: 100 }; + expect(normalizeStickerAttachment(a)).toEqual(a); + expect(normalizeStickerMetadata(true)).toBeUndefined(); + expect(normalizeStickerMetadata([])).toBeUndefined(); + expect(messagePreview("\uFFFC", a)).toBe("Photo"); + expect(messagePreview("\uFFFC", { ...a, sticker: true })).toBe("Sticker"); + expect(messagePreview("caption", { ...a, sticker: true })).toBe("caption"); + }); + test("only finite bounded placement numbers reach the renderer", () => { + expect(normalizeStickerPlacement(position)).toEqual(position); + for (const value of [NaN, Infinity, -Infinity, true, "0.5", null, 100]) + expect(normalizeStickerPlacement({ ...position, x: value })).toBeUndefined(); + expect(normalizeStickerPlacement({ ...position, parentWidth: Infinity })).not.toHaveProperty("parentWidth"); + }); + test("labels are bounded plain text; unknown attribution is still a sticker", () => { + expect(normalizeStickerMetadata({ source: "weird", label: "\u202e\0" })).toEqual({ + source: "unknown", label: "", animated: false, + }); + expect(normalizeStickerMetadata({ label: "a".repeat(1000) })!.label.length).toBe(160); + expect(normalizeStickerMetadata({ source: { toString: "not callable" } })!.source).toBe("unknown"); + }); + test("duplicates do not consume the bounded overlay budget; overflow is honest", () => { + const input = Array.from({ length: MAX_VISIBLE_STICKERS + 9 }, (_, i) => overlay(i + 1)); + const result = normalizeStickerOverlays([null, {}, ...input, input[0], input[1]]); + expect(result.stickers.length).toBe(MAX_VISIBLE_STICKERS); + expect(result.overflow).toBe(9); + }); + test("missing media survives as a labeled non-fetchable placeholder", () => { + const s = overlay(); s.attachment.id = "not-an-id"; + const result = normalizeStickerOverlays([s]); + expect(result.stickers[0]!.attachment.id).toBe(""); + expect(result.stickers[0]!.attachment.sticker!.label).toBe("Heart"); + }); + test("unknown body parts and absent geometry use an attached strip", () => { + const first = overlay(1), second = { ...overlay(2), part: 2 }, third = overlay(3); + delete third.placement; + delete third.attachment.sticker!.placement; + expect(placedStickers([first, second, third]).map(s => s.guid)).toEqual(["S1"]); + expect(unplacedStickers([first, second, third]).map(s => s.guid)).toEqual(["S2", "S3"]); + }); + test("decorating preserves sticker activity without moving message time", () => { + const result = decorate([message({ stickers: [overlay()], activity_ts: "2026-11-06T10:01:00Z" })], "2026-11-06")[0]!; + expect(result.ts).toBe("2026-11-06T10:00:00Z"); + expect(result.seen_ts).toBe("2026-11-06T10:01:00Z"); + expect(result.stickers[0]!.placement).toEqual(position); + expect(result.tapbacks).toEqual([]); + }); + test("native sticker reactions remain distinct from additive decorations", () => { + const input = [overlay(1), { ...overlay(2), reaction: true }, + { ...overlay(3), reaction: "true" }, { ...overlay(4), reaction: true, part: 2 }]; + const normalized = normalizeStickerOverlays(input).stickers; + expect(reactionStickers(normalized).map(s => s.guid)).toEqual(["S2", "S4"]); + expect(placedStickers(normalized).map(s => s.guid)).toEqual(["S1", "S3"]); + expect(unplacedStickers(normalized)).toEqual([]); + expect(decorate([message({ stickers: normalized })], "2026-11-06")[0]!.stickers[1]!.reaction).toBe(true); + }); + test("an unsent parent hides sticker decoration", () => { + const b = decorate([message({ stickers: [overlay()], retracted: true })], "2026-11-06")[0]!; + expect(b.stickers).toEqual([]); + expect(b.stickersOverflow).toBe(0); + }); + test("either self-thread twin keeps stickers and their read boundary", () => { + for (const reversed of [false, true]) { + const rows = [message({ from_me: true }), message({ stickers: [overlay()], activity_ts: "2026-11-06T10:01:00Z" })]; + const result = dedupeSelfEcho(reversed ? rows.reverse() : rows, ["+15551234567"]); + expect(result.length).toBe(1); + expect(result[0]!.stickers!.length).toBe(1); + expect(result[0]!.activity_ts).toBe("2026-11-06T10:01:00Z"); + } + }); + test("empty outbound self echo transfers its decorations to the displayed inbound", () => { + const result = dedupeSelfEcho([ + message({ text: "", from_me: true, stickers: [overlay()], activity_ts: "2026-11-06T10:01:00Z" }), + message({ text: "" }), + ], ["+15551234567"]); + expect(result.length).toBe(1); + expect(result[0]!.stickers![0]!.guid).toBe("S1"); + expect(result[0]!.activity_ts).toBe("2026-11-06T10:01:00Z"); + }); + test("geometry preserves image aspect and clamps absurd source dimensions", () => { + const g = stickerGeometry(position, 200, 100, 200, 100); + expect(g.width / g.height).toBe(2); + expect(g.rotation).toBeCloseTo(-.2 * 180 / Math.PI); + expect(g.x).toBeGreaterThanOrEqual(0); + expect(g.x + g.width).toBeLessThanOrEqual(200); + const fallback = stickerGeometry(undefined, NaN, Infinity, 0, -1); + expect(Object.values(fallback).every(v => typeof v !== "number" || Number.isFinite(v))).toBe(true); + expect(fallback.placed).toBe(false); + for (const rotation of [0, Math.PI / 4, Math.PI / 2, Math.PI, -Math.PI / 3]) { + const g = stickerGeometry({ ...position, x: 3, y: -3, scale: 4, rotation }, 80, 30, 200, 100); + const bw = g.width * Math.abs(Math.cos(rotation)) + g.height * Math.abs(Math.sin(rotation)); + const bh = g.height * Math.abs(Math.cos(rotation)) + g.width * Math.abs(Math.sin(rotation)); + expect(g.x + g.width / 2 - bw / 2).toBeGreaterThanOrEqual(-1e-6); + expect(g.y + g.height / 2 - bh / 2).toBeGreaterThanOrEqual(-1e-6); + expect(g.x + g.width / 2 + bw / 2).toBeLessThanOrEqual(80 + 1e-6); + expect(g.y + g.height / 2 + bh / 2).toBeLessThanOrEqual(30 + 1e-6); + } + }); +}); + +// Deliberately tiny container headers for parser/runner tests. Pixel decoding +// is covered by scripts/test-sticker-ui.py with generated, valid media. +function png(frames = 1, width = 64, height = 64): Buffer { + const chunk = (type: string, body: Buffer) => { + const b = Buffer.alloc(12 + body.length); b.writeUInt32BE(body.length); b.write(type, 4); body.copy(b, 8); return b; + }; + const ihdr = Buffer.alloc(13); ihdr.writeUInt32BE(width, 0); ihdr.writeUInt32BE(height, 4); ihdr[8] = 8; ihdr[9] = 6; + const actl = Buffer.alloc(8); actl.writeUInt32BE(frames); + return Buffer.concat([Buffer.from("89504e470d0a1a0a", "hex"), chunk("IHDR", ihdr), + ...(frames > 1 ? [chunk("acTL", actl)] : []), chunk("IDAT", Buffer.alloc(0))]); +} +function webp(): Buffer { + const b = Buffer.alloc(40); b.write("RIFF", 0); b.writeUInt32LE(32, 4); b.write("WEBPVP8X", 8); + b.writeUInt32LE(10, 16); b[20] = 0x12; b.writeUIntLE(63, 24, 3); b.writeUIntLE(31, 27, 3); return b; +} +const cap = 5 * 1024 * 1024; +let nextId = 80000; +const id = () => String(nextId++); + +describe("alpha and animated sticker fetches", () => { + test("HEIC and HEICS sticker transforms have PNG filenames; photos retain JPEG", () => { + expect(wantsStickerPng("image/heic-sequence")).toBe(true); + expect(cacheFileName("1", "evil.desktop", "image/heic", false, true)).toBe("1-png-evil.png"); + expect(cacheFileName("1", "same.heic", "image/heic")).toBe("1-jpg-same.jpg"); + }); + test("sticker attribution never admits SVG or MIME-spoofed external-resource media", () => { + let calls = 0; + const svg = Buffer.from(''); + const runner = (() => { calls++; return { status: 0, stdout: svg }; }) as never; + expect(fetchAttachment(id(), "unsafe.svg", "image/svg+xml", runner, cap, true).ok).toBe(false); + expect(calls).toBe(0); + for (const mime of ["image/png", "image/gif", "image/jpeg", "image/webp", "image/heic"]) + expect(fetchAttachment(id(), "fake.png", mime, runner, cap, true).ok).toBe(false); + expect(fetchAttachment(id(), "wrong.gif", "image/gif", (() => ({ status: 0, stdout: png() })) as never, cap, true).ok).toBe(false); + expect(fetchAttachment(id(), "zero.png", "image/png", (() => ({ status: 0, stdout: png(1, 0, 0) })) as never, cap, true).ok).toBe(false); + }); + test("cached sticker bytes are revalidated instead of trusting their extension", () => { + const aid = id(); + mkdirSync(CACHE_DIR, { recursive: true, mode: 0o700 }); + const file = join(CACHE_DIR, cacheFileName(aid, "cached.png", "image/png")); + writeFileSync(file, '', { mode: 0o600 }); + let called = false; + const result = fetchAttachment(aid, "cached.png", "image/png", (() => { called = true; throw Error("unexpected"); }) as never, cap, true); + expect(result.ok).toBe(false); + expect(result.error).toContain("raster"); + expect(called).toBe(false); + }); + test("transparent PNG stickers avoid sips JPEG preview, on first fetch and cache hit", () => { + const calls: string[][] = []; + const runner = ((_cmd: string, args: string[]) => { calls.push(args); return { status: 0, stdout: png() }; }) as never; + const aid = id(); + const result = fetchAttachment(aid, "sticker.png", "image/png", runner, cap, true); + expect(result.ok).toBe(true); + expect(calls).toEqual([["attachment", aid]]); + expect(result.renderMime).toBe("image/png"); + expect(readFileSync(result.path)).toEqual(png()); + expect(statSync(result.path).mode & 0o777).toBe(0o600); + expect(fetchAttachment(aid, "sticker.png", "image/png", runner, cap, true).url).toBe(result.url); + expect(calls.length).toBe(1); + }); + test("HEIC sticker asks for PNG and can be saved as a full-size converted original", () => { + const calls: string[][] = []; + const runner = ((_cmd: string, args: string[]) => { calls.push(args); return { status: 0, stdout: png() }; }) as never; + const aid = id(); + const result = fetchAttachment(aid, "sticker.heic", "image/heic", runner, cap, true); + expect(calls).toEqual([["attachment", aid, "--png"]]); + expect(result.renderMime).toBe("image/png"); + expect(result.path).toContain("-png-"); + expect(cachedOriginal(result.path)).toBe(result.path); + }); + test("APNG auto-preview becomes animated WebP; copy/save retains original PNG", () => { + const calls: any[] = []; + const runner = ((cmd: string, args: string[], options: any) => { + calls.push({ cmd, args, options }); + if (cmd === "ffmpeg") { + const input = args[args.indexOf("-i") + 1]!; + expect(readFileSync(input)).toEqual(png(2)); + expect(statSync(input).mode & 0o777).toBe(0o600); + } + return { status: 0, stdout: cmd === "ffmpeg" ? webp() : png(2) }; + }) as never; + const aid = id(); + const result = fetchAttachment(aid, "animated.png", "image/png", runner, cap, true); + expect(result.renderMime).toBe("image/webp"); expect(result.animated).toBe(true); + expect(result.path).toContain("-anim-"); + expect(calls[1].options.input).toBeUndefined(); + expect(calls[1].args).toContain("-ignore_loop"); + expect(readdirSync(CACHE_DIR).some(n => n.startsWith(".sticker-"))).toBe(false); + expect(calls[1].args).toContain("-lossless"); + expect(() => cachedOriginal(result.path)).toThrow("original"); + const original = fetchAttachment(aid, "animated.png", "image/png", runner, FETCH_MAX_BYTES, true); + expect(original.renderMime).toBe("image/png"); + expect(readFileSync(original.path)).toEqual(png(2)); + expect(cachedOriginal(original.path)).toBe(original.path); + const count = calls.length; + expect(fetchAttachment(aid, "animated.png", "image/png", runner, cap, true).path).toBe(result.path); + expect(calls.length).toBe(count); + }); + test("an APNG cached by copy converts locally without another bridge read", () => { + const aid = id(); + fetchAttachment(aid, "loop.png", "image/png", (() => ({ status: 0, stdout: png(2) })) as never, FETCH_MAX_BYTES, true); + const calls: string[] = []; + const r = fetchAttachment(aid, "loop.png", "image/png", ((cmd: string) => { + calls.push(cmd); return { status: 0, stdout: webp() }; + }) as never, cap, true); + expect(calls).toEqual(["ffmpeg"]); + expect(r.animated).toBe(true); + }); + test("malformed headers cannot make the parser read past the buffer", () => { + for (let end = 0; end < png(2).length; end++) expect(() => imageAnimation(png(2).subarray(0, end))).not.toThrow(); + const malformed = png(2); malformed.writeUInt32BE(0xffffffff, 8); + expect(imageAnimation(malformed).animated).toBe(false); + expect(imageMetrics(webp(), "image/webp")).toEqual({ pixelWidth: 64, pixelHeight: 32, pixelRatio: 1 }); + }); + test("huge APNG dimensions or frame counts never enter a decoder", () => { + let calls = 0; + const runner = (() => { calls++; throw Error("must not run"); }) as never; + for (const bytes of [png(101), png(2, 100000, 100000), png(100, 2048, 2048)]) { + const r = stickerAnimationPreview(bytes, runner); + expect(r.unavailable).toBe(true); expect(r.bytes).toBe(bytes); + } + expect(calls).toBe(0); + }); + test("missing decoder, timeout, corrupt output, and large output preserve a transparent still", () => { + for (const behavior of ["missing", "timeout", "corrupt", "large"]) { + const runner = ((cmd: string, _args: string[], opts: any) => { + if (cmd !== "ffmpeg") return { status: 0, stdout: png(2) }; + expect(opts.timeout).toBe(30000); expect(opts.maxBuffer).toBeLessThanOrEqual(FETCH_MAX_BYTES + (1 << 20)); + if (behavior === "missing") throw Error("ENOENT"); + if (behavior === "timeout") return { status: null, stdout: Buffer.alloc(0), error: Error("ETIMEDOUT") }; + if (behavior === "large") return { status: 0, stdout: Buffer.concat([webp(), Buffer.alloc(cap)]) }; + return { status: 0, stdout: Buffer.from("not an image") }; + }) as never; + const r = fetchAttachment(id(), "loop.png", "image/png", runner, cap, true); + expect(r.ok).toBe(true); expect(r.animationUnavailable).toBe(true); + expect(r.renderMime).toBe("image/png"); expect(readFileSync(r.path)).toEqual(png(2)); + expect(readdirSync(CACHE_DIR).some(n => n.startsWith(".sticker-"))).toBe(false); + } + }); + test("HEICS failure asks the Mac for a transparent still and names the lost motion", () => { + const calls: any[] = []; + const runner = ((cmd: string, args: string[]) => { + calls.push({ cmd, args }); + if (cmd === "ffprobe") return { status: 1, stdout: "" }; + return { status: 0, stdout: args.includes("--png") ? png() : Buffer.from("synthetic sequence") }; + }) as never; + const aid = id(), r = fetchAttachment(aid, "live.heics", "image/heic-sequence", runner, cap, true); + expect(r.ok).toBe(true); expect(r.renderMime).toBe("image/png"); expect(r.animationUnavailable).toBe(true); + expect(calls[0].args).toEqual(["attachment", aid]); + expect(calls.at(-1).args).toEqual(["attachment", aid, "--png"]); + expect(readdirSync(CACHE_DIR).some(n => n.startsWith(".sticker-"))).toBe(false); + }); + test("HEICS color and alpha tracks are selected only after bounded metadata validation", () => { + const dir = mkdtempSync(join(tmpdir(), "blip-sticker-sequence-")); + const streams = Array.from({ length: 4 }, (_, index) => ({ index, codec_type: "video", width: 64, height: 32, + pix_fmt: index % 2 ? "gray" : "yuv420p", nb_frames: "5", duration: "1" })); + const calls: any[] = []; + const runner = ((cmd: string, args: string[], opts: any) => { + calls.push({ cmd, args, opts }); + if (cmd === "ffprobe") { expect(statSync(args.at(-1)!).mode & 0o777).toBe(0o600); return { status: 0, stdout: JSON.stringify({ streams }) }; } + return { status: 0, stdout: webp() }; + }) as never; + try { + expect(stickerSequencePreview(Buffer.from("media"), "image/heics", runner, dir)?.renderMime).toBe("image/webp"); + expect(calls[1].args).toContain("[0:2][0:3]alphamerge,format=rgba[out]"); + expect(calls[1].args).toContain("file,pipe"); + expect(readdirSync(dir)).toEqual([]); + streams[2]!.width = 999999; + calls.length = 0; + expect(stickerSequencePreview(Buffer.from("media"), "image/heics", runner, dir)).toBeUndefined(); + expect(calls.length).toBe(1); + expect(readdirSync(dir)).toEqual([]); + } finally { rmSync(dir, { recursive: true, force: true }); } + }); +}); diff --git a/stickers.ts b/stickers.ts new file mode 100644 index 00000000..840506d2 --- /dev/null +++ b/stickers.ts @@ -0,0 +1,169 @@ +/** Sticker wire normalization and layout. No files, processes, or message state. + * Regenerate the QML module: bun build stickers.ts --target=browser --format=esm --outfile=Stickers.mjs + */ +import type { AttachmentMeta } from "./collector"; + +export interface StickerPlacement { + /** Center as a fraction of the target bubble's dimensions. */ + x: number; + y: number; + scale: number; + /** Clockwise radians, as stored by Messages. */ + rotation: number; + parentWidth?: number; +} +export interface StickerMetadata { + source: "memoji" | "genmoji" | "user" | "app" | "unknown"; + label: string; + app_name?: string; + animated?: boolean; + placement?: StickerPlacement; +} +export interface StickerOverlay { + attachment: AttachmentMeta; + guid: string; + part: number; + from_me: boolean; + by: string | null; + ts: string; + /** Native type 2007 occupies the sender's Tapback slot, unlike decoration 1000. */ + reaction?: boolean; + placement?: StickerPlacement; +} + +/** Protect the render tree from a very long history of decorations on one message. */ +export const MAX_VISIBLE_STICKERS = 24; +const sources = new Set(["memoji", "genmoji", "user", "app", "unknown"]); +const record = (value: unknown): value is Record => + !!value && typeof value === "object" && !Array.isArray(value); +const finite = (value: unknown, min: number, max: number): value is number => + typeof value === "number" && Number.isFinite(value) && value >= min && value <= max; +const label = (value: unknown, max = 160): string => + typeof value === "string" ? value.replace(/[\p{Cc}\p{Cf}]/gu, "").trim().slice(0, max) : ""; + +export function normalizeStickerPlacement(value: unknown): StickerPlacement | undefined { + if (!record(value) || !finite(value.x, -3, 3) || !finite(value.y, -3, 3) + || !finite(value.scale, 0.1, 4) || !finite(value.rotation, -Math.PI * 2, Math.PI * 2)) return undefined; + return Object.assign({ x: value.x, y: value.y, scale: value.scale, rotation: value.rotation }, + finite(value.parentWidth, 1, 10000) ? { parentWidth: value.parentWidth } : {}); +} + +export function normalizeStickerMetadata(value: unknown): StickerMetadata | undefined { + if (!record(value)) return undefined; + const placement = normalizeStickerPlacement(value.placement); + const app = label(value.app_name, 80); + return Object.assign({ + source: typeof value.source === "string" && sources.has(value.source) ? value.source as StickerMetadata["source"] : "unknown", + label: label(value.label) || "Sticker", + animated: value.animated === true, + }, app ? { app_name: app } : {}, placement ? { placement } : {}); +} + +/** Ordinary transparent PNGs remain ordinary images: sticker attribution is explicit. */ +export function normalizeStickerAttachment(attachment: AttachmentMeta): AttachmentMeta { + const sticker = normalizeStickerMetadata(attachment.sticker); + if (sticker) return Object.assign({}, attachment, { sticker }); + const plain = Object.assign({}, attachment); + delete plain.sticker; + return plain; +} + +export function normalizeStickerOverlays(value: unknown): { stickers: StickerOverlay[]; overflow: number } { + if (!Array.isArray(value)) return { stickers: [], overflow: 0 }; + const valid: StickerOverlay[] = []; + const identities = new Set(); + let total = 0; + for (const raw of value) { + if (!record(raw) || !record(raw.attachment)) continue; + const a = raw.attachment; + const sticker = normalizeStickerMetadata(a.sticker); + if (!sticker) continue; + const id = typeof a.id === "string" && /^[0-9]{1,18}$/.test(a.id) ? a.id : ""; + const guid = label(raw.guid, 128); + const key = `${guid}\0${id}`; + // A missing-media placeholder still needs its message identity to avoid + // merging unrelated unloaded stickers. Blank identities are not deduped. + if ((guid || id) && identities.has(key)) continue; + if (guid || id) identities.add(key); + total++; + if (valid.length >= MAX_VISIBLE_STICKERS) continue; + const placement = normalizeStickerPlacement(raw.placement) ?? sticker.placement; + valid.push(Object.assign({ + attachment: { + id, name: label(a.name, 256) || "Sticker", + mime: typeof a.mime === "string" ? a.mime.slice(0, 100) : null, + bytes: finite(a.bytes, 0, Number.MAX_SAFE_INTEGER) ? a.bytes : null, + sticker, + }, + guid, + part: finite(raw.part, 0, 999999) && Number.isInteger(raw.part) ? raw.part : 0, + from_me: raw.from_me === true, + by: label(raw.by, 160) || null, + ts: typeof raw.ts === "string" ? raw.ts : "", + }, raw.reaction === true ? { reaction: true } : {}, placement ? { placement } : {})); + } + return { stickers: valid, overflow: Math.max(0, total - valid.length) }; +} + +/** A self-thread can store decoration on either echo. Preserve both, once. */ +export function mergeStickers(a?: StickerOverlay[] | null, b?: StickerOverlay[] | null): StickerOverlay[] | undefined { + const all = [...(a ?? []), ...(b ?? [])]; + if (!all.length) return undefined; + const seen = new Set(); + return all.filter(s => { + const key = `${s.guid}\0${s.attachment?.id ?? ""}`; + if (seen.has(key)) return false; + seen.add(key); + return true; + }); +} + +/** Body-part 0 is the only safely addressable part without attributed-body + * range mapping. The renderer anchors it to text, or the first attachment. + */ +export function placedStickers(stickers: StickerOverlay[] | undefined): StickerOverlay[] { + return (stickers ?? []).filter(s => s.reaction !== true && s.part === 0 && !!normalizeStickerPlacement(s.placement)); +} + +export function unplacedStickers(stickers: StickerOverlay[] | undefined): StickerOverlay[] { + return (stickers ?? []).filter(s => s.reaction !== true && (s.part !== 0 || !normalizeStickerPlacement(s.placement))); +} + +export function reactionStickers(stickers: StickerOverlay[] | undefined): StickerOverlay[] { + return (stickers ?? []).filter(s => s.reaction === true); +} + +/** A compact decoration stays bounded even when metadata claims huge scaling. + * Unknown placement gets a readable row below the bubble, never a guessed + * position obscuring its text. The renderer chooses the target body part. + */ +export function stickerGeometry(placement: StickerPlacement | undefined, width: number, height: number, + naturalWidth = 64, naturalHeight = 64): + { x: number; y: number; width: number; height: number; rotation: number; placed: boolean } { + const w = finite(width, 1, 10000) ? width : 64; + const h = finite(height, 1, 10000) ? height : 64; + const nw = finite(naturalWidth, 1, 100000) ? naturalWidth : 64; + const nh = finite(naturalHeight, 1, 100000) ? naturalHeight : 64; + const p = normalizeStickerPlacement(placement); + const scale = p?.scale ?? 1; + const longEdge = Math.min(Math.max(40 * scale, 24), 120, w); + let sw = nw >= nh ? longEdge : longEdge * nw / nh; + let sh = nh >= nw ? longEdge : longEdge * nh / nw; + const angle = p?.rotation ?? 0; + const cos = Math.abs(Math.cos(angle)), sin = Math.abs(Math.sin(angle)); + let bw = sw * cos + sh * sin, bh = sh * cos + sw * sin; + const fit = Math.min(1, w / bw, h / bh); + sw *= fit; sh *= fit; bw *= fit; bh *= fit; + const insetX = (bw - sw) / 2, insetY = (bh - sh) / 2; + return { + // Sender offsets can sit outside the native bubble. Clamp to our target + // so they cannot escape the panel or cover another message's actions. + // Rotation is around the image center; clamp its rotated bounding box, + // not just the unrotated image, to the target. parentWidth is preserved + // as provenance but native point-for-point scale is intentionally not + // reproduced in a much narrower Linux bubble. + x: p ? Math.max(insetX, Math.min(w - sw - insetX, p.x * w - sw / 2)) : 0, + y: p ? Math.max(insetY, Math.min(h - sh - insetY, p.y * h - sh / 2)) : 0, + width: sw, height: sh, rotation: p ? p.rotation * 180 / Math.PI : 0, placed: !!p, + }; +} diff --git a/thread.ts b/thread.ts index 430537d5..40fb5c37 100644 --- a/thread.ts +++ b/thread.ts @@ -13,6 +13,7 @@ import { homedir } from "node:os"; import { spawnSync } from "node:child_process"; import { readFileSync } from "node:fs"; +import { normalizeStickerAttachment, normalizeStickerOverlays, type StickerOverlay } from "./stickers"; import { chatKey, dedupeSelfEcho, @@ -80,6 +81,10 @@ export interface Bubble { tapbacks: Tapback[]; /** Attachment chips ("📷 IMG_4502.png"); metadata only, files stay on the Mac. */ attachments: AttachmentMeta[]; + /** Stickers placed on this message, independent of the sender's tapback. */ + stickers: StickerOverlay[]; + /** Additional decorations omitted from the bounded render tree. */ + stickersOverflow: number; /** Inline-reply context: the quoted snippet, "" when not a reply. */ replyText: string; replyMine: boolean; @@ -307,6 +312,7 @@ export function decorate(msgs: ImsgMessage[], today: string, formats = DEFAULT_F localDay(next.ts) !== localDay(m.ts) || !sameSender(m, next) || minutesBetween(m.ts, next.ts) > GROUP_GAP_MINUTES; + const stickerState = normalizeStickerOverlays(m.stickers); out.push({ ts: m.ts, @@ -326,7 +332,9 @@ export function decorate(msgs: ImsgMessage[], today: string, formats = DEFAULT_F // Belt to imsg 1.5.1's suspenders: link-preview payloads are not files. attachments: (m.attachments ?? []).filter( (a) => !String(a.name || "").endsWith(".pluginPayloadAttachment"), - ), + ).map(normalizeStickerAttachment), + stickers: m.retracted ? [] : stickerState.stickers, + stickersOverflow: m.retracted ? 0 : stickerState.overflow, replyText: m.reply_to?.text ?? "", replyMine: m.reply_to?.from_me ?? false, edited: m.edited === true, @@ -420,6 +428,8 @@ export function pendingBubble(prev: Bubble | undefined, send: PendingSend, today receipt: "", tapbacks: [], attachments: [], + stickers: [], + stickersOverflow: 0, replyText: "", replyMine: false, edited: false, diff --git a/ui.test.ts b/ui.test.ts index f5bcc294..da7ad713 100644 --- a/ui.test.ts +++ b/ui.test.ts @@ -1076,7 +1076,7 @@ test("a thread response taken before a local send or failure cannot replace bubb // the picture (or file chip) itself, through the one shared TapbackPill. test("tapbacks on picture-only messages get a pill on the picture", () => { expect(panel).toContain("component TapbackPill: Rectangle {"); - expect(panel.split("TapbackPill {").length - 1).toBe(3); // text bubble, picture, file chip + expect(panel.split("TapbackPill {").length - 1).toBe(4); // text bubble, picture, file chip, standalone sticker expect(panel).toContain('readonly property bool pillHere: index === 0 && String(bubbleRow.modelData.text || "") === ""'); expect(panel).toContain("+ (pillHere ? Style.space(12) : 0)"); }); From cabdeef8bec48ea2699bfe3a7682b3b15a799da2 Mon Sep 17 00:00:00 2001 From: Marcus Vorwaller Date: Tue, 10 Nov 2026 08:48:20 -0800 Subject: [PATCH 2/4] Bound sticker decoders and preserve attachment cache behavior Pin MOV demuxing and decoder pixel limits, cap output frames by the pixel budget, and cache failed previews. Bound PNG conversion on the Mac, retain legacy unread behavior, and make WebP optional. Add regression coverage with synthetic media only. --- CLAUDE.md | 2 ++ bridge/mac/imsg | 2 +- bridge/mac/test_stickers.py | 5 ++++ collector.ts | 2 +- docs/STICKERS.md | 2 ++ fetch.ts | 28 +++++++++++++------- scripts/blip-setup | 6 ++++- stickers.test.ts | 52 +++++++++++++++++++++++++++++++++++-- 8 files changed, 85 insertions(+), 14 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index bfad9a8e..7e577080 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -745,3 +745,5 @@ Read-sync UI regression: `python3 scripts/test-read-ui.py` executes the shipping QML badge bindings and read/unread functions with synthetic data under QtTest. `threadsJson` must remain bound to the CURRENT threads, including optimistic edits; a poll-only cache allowed a 3-unread badge alongside only 2 unread rows. + +Sticker Save also accepts the `-png-` transform: HEIC is a bounded PNG conversion, and HEICS is a single-frame still, not the original sequence. diff --git a/bridge/mac/imsg b/bridge/mac/imsg index 22037810..843bfb0a 100755 --- a/bridge/mac/imsg +++ b/bridge/mac/imsg @@ -1355,7 +1355,7 @@ def render(rows, as_json: bool, with_names: bool = True, con=None, rich: bool = **_edit_flags(r["date_edited"], r["date_retracted"], r["message_summary_info"]), # Tapback rows are messages too, but no Apple client counts # them toward a badge — flag them so clients can match. - "tapback": bool(r["assoc_type"] == 1000 or (r["assoc_type"] and 2000 <= r["assoc_type"] < 4000)), + "tapback": bool(r["assoc_type"] and 2000 <= r["assoc_type"] < 4000), # Delivery failure code on OWN messages (0 = fine). AppleScript # reports success for sends that die later; this is the only # place the truth lands (e.g. 25 = attachment not readable). diff --git a/bridge/mac/test_stickers.py b/bridge/mac/test_stickers.py index d5f33d32..c5c8e511 100644 --- a/bridge/mac/test_stickers.py +++ b/bridge/mac/test_stickers.py @@ -221,6 +221,11 @@ def test_geometry_and_accessible_label_are_bounded_and_typed(self): r["sticker_user_info"] = plistlib.dumps({**info, "sxs": bad}) self.assertNotIn("placement", self.imsg.sticker_metadata(r)) + def test_valid_plist_over_cap_is_rejected(self): + blob = plistlib.dumps({"value": "x" * 65536}) + self.assertGreater(len(blob), 65536) + self.assertEqual(self.imsg._small_plist_dict(blob), {}) + def test_bad_plists_never_take_down_thread(self): for bad in [None, b"garbage", b"", b"&unknown;", b"x" * 65537, plistlib.dumps([1, 2])]: diff --git a/collector.ts b/collector.ts index 9dabbcfb..e90cd53b 100644 --- a/collector.ts +++ b/collector.ts @@ -48,7 +48,7 @@ export const POLL_WINDOW = 150; export const DEEP_WINDOW = 500; /** One reaction folded onto its target message (imsg --rich). */ -export interface Tapback { emoji: string; from_me: boolean; by: string | null; kind?: "classic" | "emoji" | "sticker" } +export interface Tapback { emoji: string; from_me: boolean; by: string | null; kind?: "emoji" } /** Attachment metadata only — the file itself stays on the Mac until * fetch.ts pulls it by `id` (attachment ROWID as a string: 64-bit safe). */ export interface AttachmentMeta { id?: string; name: string; mime: string | null; bytes: number | null; sticker?: import("./stickers").StickerMetadata } diff --git a/docs/STICKERS.md b/docs/STICKERS.md index 4f741cf1..34fdfd74 100644 --- a/docs/STICKERS.md +++ b/docs/STICKERS.md @@ -163,3 +163,5 @@ advance frames, and checks playback pause. It does not open Messages or send. In the upstream UI, native sticker reactions are shown in a compact strip attached to the parent message. Known part-0 placements overlay the text or first image surface; unknown placements remain in the strip. The fork’s reaction-balloon restyle is not included. ![Synthetic sticker examples in the upstream UI](img/stickers.png) + +Legacy type-1000 rows retain upstream unread counting and toast behavior. Decoder output is capped to min(100, floor(64 million / frame pixels)) frames even when container frame counts lie. Failed APNG conversions cache the still fallback. diff --git a/fetch.ts b/fetch.ts index d85110f2..be2995ba 100644 --- a/fetch.ts +++ b/fetch.ts @@ -293,9 +293,9 @@ export function stickerAnimationPreview(bytes: Buffer, runner = spawnSync, dir = mkdirSync(dir, { recursive: true, mode: 0o700 }); const fd = openSync(tmp, "wx", 0o600); try { writeSync(fd, bytes); } finally { closeSync(fd); } - const res = runner("ffmpeg", ["-nostdin", "-v", "error", "-protocol_whitelist", "file,pipe", "-f", "apng", "-ignore_loop", "1", "-i", tmp, + const res = runner("ffmpeg", ["-nostdin", "-v", "error", "-protocol_whitelist", "file,pipe", "-max_pixels", "4194304", "-f", "apng", "-ignore_loop", "1", "-i", tmp, "-map_metadata", "-1", "-c:v", "libwebp_anim", "-lossless", "1", "-loop", "0", - "-frames:v", "100", "-f", "webp", "pipe:1"], + "-frames:v", String(Math.min(100, Math.floor(64_000_000 / (size.pixelWidth * size.pixelHeight)))), "-f", "webp", "pipe:1"], { timeout: 30000, maxBuffer: FETCH_MAX_BYTES + (1 << 20) }); const out = res.stdout as Buffer; if (res.status === 0 && Buffer.isBuffer(out) && out.length > 30 && imageAnimation(out).format === "webp") @@ -321,7 +321,7 @@ export function stickerSequencePreview(bytes: Buffer, mime: string, runner = spa try { writeSync(fd, bytes); } finally { closeSync(fd); } const probe = runner("ffprobe", ["-v", "error", "-protocol_whitelist", "file,pipe", "-show_entries", "stream=index,codec_type,width,height,nb_frames,duration,pix_fmt", - "-of", "json", tmp], { timeout: 10000, maxBuffer: 65536 }); + "-of", "json", "-max_pixels", "4194304", "-f", "mov", "-i", tmp], { timeout: 10000, maxBuffer: 65536 }); if (probe.status !== 0) return undefined; const data = JSON.parse(String(probe.stdout)); if (!Array.isArray(data.streams) || data.streams.length > 8) return undefined; @@ -340,10 +340,10 @@ export function stickerSequencePreview(bytes: Buffer, mime: string, runner = spa ? `[0:${color.index}][0:${mask.index}]alphamerge,format=rgba[out]` : `[0:${color.index}]format=rgba[out]`; const output = animate - ? ["-c:v", "libwebp_anim", "-lossless", "1", "-loop", "0", "-frames:v", "100", "-t", "8", "-f", "webp"] + ? ["-c:v", "libwebp_anim", "-lossless", "1", "-loop", "0", "-frames:v", String(Math.min(100, Math.floor(64_000_000 / (width * height)))), "-t", "8", "-f", "webp"] : ["-c:v", "png", "-frames:v", "1", "-f", "image2pipe"]; const result = runner("ffmpeg", ["-nostdin", "-v", "error", "-protocol_whitelist", "file,pipe", - "-threads", "1", "-i", tmp, "-filter_complex_threads", "1", "-filter_complex", filter, + "-threads", "1", "-max_pixels", "4194304", "-f", "mov", "-i", tmp, "-filter_complex_threads", "1", "-filter_complex", filter, "-map", "[out]", "-an", "-map_metadata", "-1", ...output, "pipe:1"], { timeout: 30000, maxBuffer: FETCH_MAX_BYTES + (1 << 20) }); const out = result.stdout as Buffer; @@ -579,16 +579,20 @@ export function fetchAttachment( const rawFile = join(CACHE_DIR, cacheFileName(id, name, mime, preview, sticker)); const animationFile = join(CACHE_DIR, cacheFileName(id, name, "image/webp").replace(`${id}-orig-`, `${id}-anim-`)); const stillFile = join(CACHE_DIR, cacheFileName(id, name, "image/png").replace(`${id}-orig-`, `${id}-still-`)); + const failedFile = stillFile + ".failed"; + if (sequencePreview && cachedMediaBytes(failedFile, 16)?.toString() === "unavailable") { + try { if (Date.now() - lstatSync(failedFile).mtimeMs < 3600000) return fail("sticker preview unavailable; open the original attachment"); } catch {} + } let file = rawFile; let cachedRaw: Buffer | undefined; let renderMime = png ? "image/png" : preview || wantsJpeg(mime) ? "image/jpeg" : mime; const sequenceStill = png && !["image/heic", "image/heif"].includes(mime.toLowerCase()); const candidates = sequencePreview ? [animationFile, stillFile].concat(png ? [rawFile] : []) - : animatedPreview ? [animationFile, rawFile] : [rawFile]; + : animatedPreview ? [animationFile, stillFile, rawFile] : [rawFile]; for (const candidate of candidates) try { const st = lstatSync(candidate); // A symlink planted in the cache must never be followed (or touched). - if (st.isFile() && st.size > 0 && st.size <= Math.min(maxBytes, FETCH_MAX_BYTES)) { + if (st.isFile() && st.size > 0 && st.size <= (sticker ? Math.min(maxBytes, FETCH_MAX_BYTES) : FETCH_MAX_BYTES)) { const now = new Date(); utimesSync(candidate, now, now); // mtime is the LRU clock const cachedMime = candidate === animationFile ? "image/webp" : candidate === stillFile ? "image/png" : renderMime; @@ -619,7 +623,7 @@ export function fetchAttachment( const args = [ "attachment", id, ...(png && !sequencePreview ? ["--png"] : !sequencePreview && (wantsJpeg(mime) || preview) ? ["--jpeg"] : []), - ...(preview ? ["--max-dim", String(PREVIEW_MAX_DIM)] : []), + ...(png && !sequencePreview ? ["--max-dim", "2048"] : preview ? ["--max-dim", String(PREVIEW_MAX_DIM)] : []), ]; const res = cachedRaw ? { status: 0, stdout: cachedRaw, stderr: "" } : runner(shimPath("imsg"), args, { timeout: 120000, @@ -647,7 +651,7 @@ export function fetchAttachment( } else if (png) { // A missing ffmpeg, unknown HEICS layout, or oversized preview still // gets the Mac's transparent first image. Never cache raw HEICS as PNG. - const fallback = runner(shimPath("imsg"), ["attachment", id, "--png"], + const fallback = runner(shimPath("imsg"), ["attachment", id, "--png", "--max-dim", "2048"], { timeout: 120000, maxBuffer: FETCH_MAX_BYTES + (1 << 20) }); if (fallback.status === 69 || fallback.status === 255) return fail("Mac unreachable", false); const still = fallback.stdout as Buffer; @@ -657,6 +661,11 @@ export function fetchAttachment( bytes = still; animationUnavailable = true; } else { + try { + const fd = openSync(failedFile, constants.O_WRONLY | constants.O_CREAT | constants.O_NOFOLLOW | constants.O_TRUNC, 0o600); + try { writeSync(fd, "unavailable"); } finally { closeSync(fd); } + evict(failedFile.slice(failedFile.lastIndexOf("/") + 1)); + } catch { /* the failure itself must still be reported */ } return fail("sticker video preview unavailable; open the original attachment"); } } @@ -671,6 +680,7 @@ export function fetchAttachment( } else animationUnavailable = true; } } + if (animatedPreview && animationUnavailable) file = stillFile; if (sticker && !renderMime.startsWith("video/") && !stickerRasterValid(bytes.subarray(0, IMAGE_HEADER_BYTES), renderMime)) return fail("sticker media is not a supported bounded raster image"); diff --git a/scripts/blip-setup b/scripts/blip-setup index 4a54524f..ed33e8f9 100755 --- a/scripts/blip-setup +++ b/scripts/blip-setup @@ -34,8 +34,12 @@ webp_available=0 for qt_root in /usr/lib/qt6 /usr/lib64/qt6 /usr/lib/x86_64-linux-gnu/qt6 /usr/lib/aarch64-linux-gnu/qt6; do [[ -f "$qt_root/plugins/imageformats/libqwebp.so" ]] && webp_available=1 done +IFS=: read -r -a qt_extra <<< "${QT_PLUGIN_PATH:-}" +for qt_path in "${qt_extra[@]}"; do + [[ -f "$qt_path/imageformats/libqwebp.so" ]] && webp_available=1 +done if (( !webp_available )); then - missing+=("Qt WebP image plugin"); pkgs+=(qt6-imageformats) + echo "• optional, for animated stickers: sudo pacman -S --needed qt6-imageformats" fi if (( ${#missing[@]} )); then echo "✗ missing on this machine: ${missing[*]}" >&2 diff --git a/stickers.test.ts b/stickers.test.ts index 657b5746..75c374ba 100644 --- a/stickers.test.ts +++ b/stickers.test.ts @@ -189,7 +189,7 @@ describe("alpha and animated sticker fetches", () => { const runner = ((_cmd: string, args: string[]) => { calls.push(args); return { status: 0, stdout: png() }; }) as never; const aid = id(); const result = fetchAttachment(aid, "sticker.heic", "image/heic", runner, cap, true); - expect(calls).toEqual([["attachment", aid, "--png"]]); + expect(calls).toEqual([["attachment", aid, "--png", "--max-dim", "2048"]]); expect(result.renderMime).toBe("image/png"); expect(result.path).toContain("-png-"); expect(cachedOriginal(result.path)).toBe(result.path); @@ -273,7 +273,7 @@ describe("alpha and animated sticker fetches", () => { const aid = id(), r = fetchAttachment(aid, "live.heics", "image/heic-sequence", runner, cap, true); expect(r.ok).toBe(true); expect(r.renderMime).toBe("image/png"); expect(r.animationUnavailable).toBe(true); expect(calls[0].args).toEqual(["attachment", aid]); - expect(calls.at(-1).args).toEqual(["attachment", aid, "--png"]); + expect(calls.at(-1).args).toEqual(["attachment", aid, "--png", "--max-dim", "2048"]); expect(readdirSync(CACHE_DIR).some(n => n.startsWith(".sticker-"))).toBe(false); }); test("HEICS color and alpha tracks are selected only after bounded metadata validation", () => { @@ -299,3 +299,51 @@ describe("alpha and animated sticker fetches", () => { } finally { rmSync(dir, { recursive: true, force: true }); } }); }); + +test("decoder frame budget does not trust advertised APNG count", () => { + stickerAnimationPreview(png(2, 1024, 1024), ((_cmd: string, args: string[]) => { + expect(args[args.indexOf("-frames:v") + 1]).toBe("61"); + expect(args[args.indexOf("-max_pixels") + 1]).toBe("4194304"); + return {status: 0, stdout: webp()}; + }) as never); +}); +test("MOV input gate, pixel ceiling, and independent sequence limits", () => { + for (const [width, height, count, seconds, animated] of [ + [2048, 2048, 2, 1, true], [2049, 2049, 2, 1, false], + [64, 64, 100, 8, true], [64, 64, 101, 8, false], + [64, 64, 100, 8.01, false], [1024, 1024, 62, 1, false], + ] as const) { + let decoded = false; + const r = stickerSequencePreview(Buffer.from("media"), "video/quicktime", ((cmd: string, args: string[]) => { + expect(args[args.indexOf("-f") + 1]).toBe("mov"); + expect(args.indexOf("-f")).toBeLessThan(args.indexOf("-i")); + expect(args[args.indexOf("-max_pixels") + 1]).toBe("4194304"); + if (cmd === "ffprobe") return {status: 0, stdout: JSON.stringify({streams:[{index:0, codec_type:"video", width,height,nb_frames:String(count),duration:String(seconds)}]})}; + decoded = true; + if (animated) expect(Number(args[args.indexOf("-frames:v") + 1]) * width * height).toBeLessThanOrEqual(64_000_000); + return {status:0, stdout:animated ? webp() : png()}; + }) as never); + expect(r?.renderMime === "image/webp").toBe(animated); + expect(decoded).toBe(width <= 2048); + } +}); +test("failed APNG conversion is cached as a still", () => { + const aid=id(); let calls=0; + const runner=((cmd:string)=>{calls++; return {status:cmd === "ffmpeg" ? 1 : 0, stdout:png(2)};}) as never; + expect(fetchAttachment(aid,"failure.png","image/png",runner,cap,true).animationUnavailable).toBe(true); + const before=calls; + expect(fetchAttachment(aid,"failure.png","image/png",runner,cap,true).animationUnavailable).toBe(true); + expect(calls).toBe(before); +}); + +test("a failed video decode is not retried on every thread open", () => { + const aid=id(); let calls=0; + const runner=((cmd:string)=>{calls++; return {status:cmd === "ffprobe" ? 1 : 0, stdout:Buffer.from("ffconcat version 1.0\nfile other.png")};}) as never; + expect(fetchAttachment(aid,"fake.mov","video/quicktime",runner,cap,true).ok).toBe(false); + const before=calls; + expect(fetchAttachment(aid,"fake.mov","video/quicktime",runner,cap,true).ok).toBe(false); + expect(calls).toBe(before); +}); +test("the real MOV demuxer refuses a concat payload", () => { + expect(stickerSequencePreview(Buffer.from("ffconcat version 1.0\nfile other.png"),"video/quicktime")).toBeUndefined(); +}); From bc4e4afd824b8a68badf1a2e1b54192f6877a223 Mon Sep 17 00:00:00 2001 From: Marcus Vorwaller Date: Tue, 10 Nov 2026 08:52:46 -0800 Subject: [PATCH 3/4] Clarify bounded still exports and failed preview caching Document the 2048-pixel Mac conversion and one-hour negative video cache without claiming full-size originals. --- docs/STICKERS.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/STICKERS.md b/docs/STICKERS.md index 34fdfd74..6a303dcb 100644 --- a/docs/STICKERS.md +++ b/docs/STICKERS.md @@ -9,7 +9,7 @@ to their original message rather than appearing as duplicate message rows. | Received media | Inline display | |---|---| | PNG, JPEG | Original pixels; PNG transparency preserved | -| HEIC / HEIF | Full-size PNG converted by the Mac's `sips`; alpha preserved | +| HEIC / HEIF | PNG bounded to 2048 pixels per edge, converted by the Mac's `sips`; alpha preserved | | GIF | Original animated file through Qt's `AnimatedImage` | | Animated WebP | Original animated file through Qt's `AnimatedImage` | | APNG, including APNG declared `image/png` | Lossless animated WebP preview; original PNG retained for explicit Open, Copy, and Save | @@ -18,8 +18,7 @@ to their original message rather than appearing as duplicate message rows. All inline sticker rasters, including static PNG/JPEG and converted HEIC stills, must have positive dimensions no larger than 2048 pixels per edge. -Larger static assets show an unavailable placeholder; this path does not -silently resize them. The table's original-pixel and full-size descriptions +Larger raw static assets show an unavailable placeholder; HEIC stills are resized on the Mac before transfer. The table's original-pixel and full-size descriptions apply within that limit. HEICS conversion uses the animated pair in a four-track container. FFprobe @@ -29,7 +28,7 @@ decodes it. Supported animations have at most 100 frames, eight seconds, a sequences get a transparent still when available. Missing tools, malformed media, timeouts, or an oversized converted preview keep the usable still; the fetch result explicitly reports `animationUnavailable`. HEICS explicit -Open/Copy/Save currently uses the Mac's full-size transparent still, not a +Open/Copy/Save currently uses the Mac's bounded transparent still, not a native HEICS export. Video Open still opens the original video externally. Qt's PNG reader displays APNG as a single frame on the tested Qt 6 stack. @@ -165,3 +164,5 @@ In the upstream UI, native sticker reactions are shown in a compact strip attach ![Synthetic sticker examples in the upstream UI](img/stickers.png) Legacy type-1000 rows retain upstream unread counting and toast behavior. Decoder output is capped to min(100, floor(64 million / frame pixels)) frames even when container frame counts lie. Failed APNG conversions cache the still fallback. + +Failed video previews are remembered for one hour to avoid repeated decoder work on thread open; explicit Open remains available. From 4c0ba922d1b6bc0d80d6ba6dd3a166e83a082326 Mon Sep 17 00:00:00 2001 From: Marcus Vorwaller Date: Tue, 10 Nov 2026 08:54:34 -0800 Subject: [PATCH 4/4] Exercise independent sticker limits and ordinary cache hits Derive mocked codec output from actual argv so threshold mutations fail, and cover the 2048 edge and cached non-sticker GIF above the auto-fetch cap. --- stickers.test.ts | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/stickers.test.ts b/stickers.test.ts index 75c374ba..cb855b81 100644 --- a/stickers.test.ts +++ b/stickers.test.ts @@ -321,7 +321,7 @@ test("MOV input gate, pixel ceiling, and independent sequence limits", () => { if (cmd === "ffprobe") return {status: 0, stdout: JSON.stringify({streams:[{index:0, codec_type:"video", width,height,nb_frames:String(count),duration:String(seconds)}]})}; decoded = true; if (animated) expect(Number(args[args.indexOf("-frames:v") + 1]) * width * height).toBeLessThanOrEqual(64_000_000); - return {status:0, stdout:animated ? webp() : png()}; + return {status:0, stdout:args.includes("libwebp_anim") ? webp() : png()}; }) as never); expect(r?.renderMime === "image/webp").toBe(animated); expect(decoded).toBe(width <= 2048); @@ -347,3 +347,17 @@ test("a failed video decode is not retried on every thread open", () => { test("the real MOV demuxer refuses a concat payload", () => { expect(stickerSequencePreview(Buffer.from("ffconcat version 1.0\nfile other.png"),"video/quicktime")).toBeUndefined(); }); + +test("a non-sticker GIF cached by Open remains a hit above the auto-fetch ceiling", () => { + const aid=id(); mkdirSync(CACHE_DIR,{recursive:true,mode:0o700}); + const path=join(CACHE_DIR,cacheFileName(aid,"large.gif","image/gif")); + const bytes=Buffer.alloc(6*1024*1024); bytes.write("GIF89a"); bytes.writeUInt16LE(64,6); bytes.writeUInt16LE(64,8); + writeFileSync(path,bytes,{mode:0o600}); + expect(fetchAttachment(aid,"large.gif","image/gif",(()=>{throw Error("cache miss");}) as never,cap).ok).toBe(true); +}); +test("static sticker edge checks are independent of animation and mask checks", () => { + for (const width of [2048,2049]) { + const r=fetchAttachment(id(),"edge.png","image/png",(()=>({status:0,stdout:png(1,width,64)})) as never,cap,true); + expect(r.ok).toBe(width === 2048); + } +});