From 1a762c2689b490520864217e0d7015ceb183a312 Mon Sep 17 00:00:00 2001 From: ericek111 Date: Sat, 10 Oct 2026 13:15:28 +0000 Subject: [PATCH] Import bookmarks in TeamSpeak's order TeamSpeak stores sync items in creation order; each names the item above it in its folder, and a reorder only rewrites those links. The decoder now keeps that link and SyncOrder follows the chains, so items read from settings.db or myTeamSpeak come out as the official client lists them, a folder's contents in its place. Broken links and loops go last in stored order. Bookmarks imported earlier keep their place. The reordered.db fixture was written by the official client. Co-Authored-By: Claude Opus 5.5 --- .../java/com/ts3client/myts/MyTeamSpeak.java | 3 +- .../com/ts3client/teamspeak/SyncItem.java | 9 ++- .../ts3client/teamspeak/SyncItemDecoder.java | 20 ++--- .../com/ts3client/teamspeak/SyncOrder.java | 69 ++++++++++++++++++ .../teamspeak/TeamSpeakSettingsDb.java | 4 +- .../ts3client/teamspeak/SyncOrderTest.java | 55 ++++++++++++++ .../teamspeak/TeamSpeakImporterTest.java | 2 +- .../src/test/resources/teamspeak/reordered.db | Bin 0 -> 212992 bytes 8 files changed, 146 insertions(+), 16 deletions(-) create mode 100644 ts3-client/core/src/main/java/com/ts3client/teamspeak/SyncOrder.java create mode 100644 ts3-client/core/src/test/java/com/ts3client/teamspeak/SyncOrderTest.java create mode 100644 ts3-client/core/src/test/resources/teamspeak/reordered.db diff --git a/ts3-client/core/src/main/java/com/ts3client/myts/MyTeamSpeak.java b/ts3-client/core/src/main/java/com/ts3client/myts/MyTeamSpeak.java index d435aae..4bfaf40 100644 --- a/ts3-client/core/src/main/java/com/ts3client/myts/MyTeamSpeak.java +++ b/ts3-client/core/src/main/java/com/ts3client/myts/MyTeamSpeak.java @@ -4,6 +4,7 @@ import com.ts3client.proto.ProtobufReader; import com.ts3client.proto.ProtobufWriter; import com.ts3client.teamspeak.SyncItem; import com.ts3client.teamspeak.SyncItemDecoder; +import com.ts3client.teamspeak.SyncOrder; import java.io.IOException; import java.net.URI; @@ -181,7 +182,7 @@ public final class MyTeamSpeak { } if (item != null) items.add(item); } - return items; + return SyncOrder.sorted(items); } /** diff --git a/ts3-client/core/src/main/java/com/ts3client/teamspeak/SyncItem.java b/ts3-client/core/src/main/java/com/ts3client/teamspeak/SyncItem.java index 47fc5fc..854f6af 100644 --- a/ts3-client/core/src/main/java/com/ts3client/teamspeak/SyncItem.java +++ b/ts3-client/core/src/main/java/com/ts3client/teamspeak/SyncItem.java @@ -14,14 +14,17 @@ public sealed interface SyncItem { /** UUID of the {@link Folder} the item sits in, or empty at the top level. */ String parentUuid(); - record Folder(String uuid, String parentUuid, String name) implements SyncItem { + /** UUID of the item just above it in its folder, or empty when it is the first. */ + String previousUuid(); + + record Folder(String uuid, String parentUuid, String previousUuid, String name) implements SyncItem { } /** * @param identity the key in TeamSpeak's obfuscated {@code V} identity form * @param nickname the nickname used with this identity when a bookmark names none */ - record Identity(String uuid, String parentUuid, String identity, String name, + record Identity(String uuid, String parentUuid, String previousUuid, String identity, String name, String nickname, String phoneticNickname, boolean isDefault) implements SyncItem { } @@ -31,7 +34,7 @@ public sealed interface SyncItem { * @param defaultChannel channel path to join, "/"-separated; empty for the server default * @param defaultChannelId the same channel by id, {@code 0} when unknown */ - record Bookmark(String uuid, String parentUuid, String name, String address, int port, + record Bookmark(String uuid, String parentUuid, String previousUuid, String name, String address, int port, String nickname, String phoneticNickname, String identityUuid, String serverPassword, String defaultChannel, String defaultChannelPassword, long defaultChannelId, boolean autoconnect) implements SyncItem { diff --git a/ts3-client/core/src/main/java/com/ts3client/teamspeak/SyncItemDecoder.java b/ts3-client/core/src/main/java/com/ts3client/teamspeak/SyncItemDecoder.java index e767661..207d99b 100644 --- a/ts3-client/core/src/main/java/com/ts3client/teamspeak/SyncItemDecoder.java +++ b/ts3-client/core/src/main/java/com/ts3client/teamspeak/SyncItemDecoder.java @@ -26,6 +26,7 @@ public final class SyncItemDecoder { public static SyncItem decode(byte[] blob) throws IOException { String uuid = ""; String parent = ""; + String previous = ""; boolean deleted = false; ProtobufReader content = null; int contentField = 0; @@ -36,6 +37,7 @@ public final class SyncItemDecoder { case 2 -> uuid = r.readString(); case 4 -> deleted = r.readVarint() == ITEM_DELETED; case 7 -> parent = r.readString(); + case 8 -> previous = r.readString(); case 16, 17, 22 -> { contentField = r.fieldNumber(); content = r.readMessage(); @@ -46,13 +48,13 @@ public final class SyncItemDecoder { if (deleted || content == null) return null; if (parent.equals(ROOT_PARENT)) parent = ""; return switch (contentField) { - case 16 -> bookmark(uuid, parent, content); - case 17 -> identity(uuid, parent, content); - default -> folder(uuid, parent, content); + case 16 -> bookmark(uuid, parent, previous, content); + case 17 -> identity(uuid, parent, previous, content); + default -> folder(uuid, parent, previous, content); }; } - private static SyncItem.Bookmark bookmark(String uuid, String parent, ProtobufReader r) throws IOException { + private static SyncItem.Bookmark bookmark(String uuid, String parent, String previous, ProtobufReader r) throws IOException { String name = "", address = "", nickname = "", phonetic = "", identity = ""; String serverPassword = "", channel = "", channelPassword = ""; int port = 9987; @@ -74,11 +76,11 @@ public final class SyncItemDecoder { default -> r.skip(); } } - return new SyncItem.Bookmark(uuid, parent, name, address, port, nickname, phonetic, identity, + return new SyncItem.Bookmark(uuid, parent, previous, name, address, port, nickname, phonetic, identity, serverPassword, channel, channelPassword, channelId, autoconnect); } - private static SyncItem.Identity identity(String uuid, String parent, ProtobufReader r) throws IOException { + private static SyncItem.Identity identity(String uuid, String parent, String previous, ProtobufReader r) throws IOException { String identity = "", name = "", nickname = "", phonetic = ""; boolean isDefault = false; while (r.next()) { @@ -91,15 +93,15 @@ public final class SyncItemDecoder { default -> r.skip(); } } - return new SyncItem.Identity(uuid, parent, identity, name, nickname, phonetic, isDefault); + return new SyncItem.Identity(uuid, parent, previous, identity, name, nickname, phonetic, isDefault); } - private static SyncItem.Folder folder(String uuid, String parent, ProtobufReader r) throws IOException { + private static SyncItem.Folder folder(String uuid, String parent, String previous, ProtobufReader r) throws IOException { String name = ""; while (r.next()) { if (r.fieldNumber() == 1) name = r.readString(); else r.skip(); } - return new SyncItem.Folder(uuid, parent, name); + return new SyncItem.Folder(uuid, parent, previous, name); } } diff --git a/ts3-client/core/src/main/java/com/ts3client/teamspeak/SyncOrder.java b/ts3-client/core/src/main/java/com/ts3client/teamspeak/SyncOrder.java new file mode 100644 index 0000000..1d0215a --- /dev/null +++ b/ts3-client/core/src/main/java/com/ts3client/teamspeak/SyncOrder.java @@ -0,0 +1,69 @@ +package com.ts3client.teamspeak; + +import java.util.ArrayDeque; +import java.util.ArrayList; +import java.util.HashSet; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.Set; + +/** + * Puts sync items in the order the TeamSpeak client lists them. The store keeps them in the + * order they were created; each item names the one above it in its folder, so a reorder only + * rewrites those links. + */ +public final class SyncOrder { + + private SyncOrder() { + } + + /** + * The items top to bottom, each folder's contents right after the folder. Items whose + * links lead nowhere, or whose folder is missing, come last in their stored order. + */ + public static List sorted(List items) { + Map> byFolder = new LinkedHashMap<>(); + for (SyncItem item : items) byFolder.computeIfAbsent(item.parentUuid(), k -> new ArrayList<>()).add(item); + + List out = new ArrayList<>(items.size()); + Set placed = new HashSet<>(); + appendFolder("", byFolder, placed, out); + for (List stray : byFolder.values()) { + for (SyncItem item : stray) { + if (!placed.contains(item)) appendFolder(item.parentUuid(), byFolder, placed, out); + } + } + return out; + } + + private static void appendFolder(String folder, Map> byFolder, Set placed, + List out) { + List members = byFolder.getOrDefault(folder, List.of()); + Map> byPrevious = new LinkedHashMap<>(); + for (SyncItem item : members) byPrevious.computeIfAbsent(item.previousUuid(), k -> new ArrayList<>()).add(item); + + List chain = new ArrayList<>(members.size()); + follow(byPrevious.getOrDefault("", List.of()), byPrevious, placed, chain); + // Broken links: the rest start chains of their own. + for (SyncItem item : members) follow(List.of(item), byPrevious, placed, chain); + for (SyncItem item : chain) { + out.add(item); + if (item instanceof SyncItem.Folder) appendFolder(item.uuid(), byFolder, placed, out); + } + } + + /** Appends {@code heads} and, after each, the items below it, depth first. */ + private static void follow(List heads, Map> byPrevious, Set placed, + List chain) { + ArrayDeque stack = new ArrayDeque<>(); + for (int i = heads.size() - 1; i >= 0; i--) stack.push(heads.get(i)); + while (!stack.isEmpty()) { + SyncItem item = stack.pop(); + if (!placed.add(item)) continue; + chain.add(item); + List below = byPrevious.getOrDefault(item.uuid(), List.of()); + for (int i = below.size() - 1; i >= 0; i--) stack.push(below.get(i)); + } + } +} diff --git a/ts3-client/core/src/main/java/com/ts3client/teamspeak/TeamSpeakSettingsDb.java b/ts3-client/core/src/main/java/com/ts3client/teamspeak/TeamSpeakSettingsDb.java index 8c2c80a..23a6790 100644 --- a/ts3-client/core/src/main/java/com/ts3client/teamspeak/TeamSpeakSettingsDb.java +++ b/ts3-client/core/src/main/java/com/ts3client/teamspeak/TeamSpeakSettingsDb.java @@ -63,7 +63,7 @@ public final class TeamSpeakSettingsDb { } /** - * The synchronised items in database order. Rows that are not items — the + * The synchronised items in the order the client lists them. Rows that are not items — the * table's checksum, unmodelled classes, pending deletions — are left out. * * @throws IOException when the file is not a readable SQLite database @@ -80,7 +80,7 @@ public final class TeamSpeakSettingsDb { } if (item != null) items.add(item); } - return items; + return SyncOrder.sorted(items); } /** The {@code value} column of a key/value table, in row order; empty when the table is absent. */ diff --git a/ts3-client/core/src/test/java/com/ts3client/teamspeak/SyncOrderTest.java b/ts3-client/core/src/test/java/com/ts3client/teamspeak/SyncOrderTest.java new file mode 100644 index 0000000..2e3a663 --- /dev/null +++ b/ts3-client/core/src/test/java/com/ts3client/teamspeak/SyncOrderTest.java @@ -0,0 +1,55 @@ +package com.ts3client.teamspeak; + +import org.junit.jupiter.api.Test; + +import java.io.File; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.assertEquals; + +class SyncOrderTest { + + /** + * Written by the official client: Charlie, Alpha and Bravo added in that order, Bravo dragged + * to the top, Charlie removed, then a folder with Delta and Echo added below TeamSpeak Public. + */ + @Test + void readsBookmarksInTheOrderTheOfficialClientListsThem() throws Exception { + File db = new File(SyncOrderTest.class.getResource("/teamspeak/reordered.db").getFile()); + assertEquals(List.of("Bravo", "TeamSpeak Public", "[New Folder]", "Delta", "Echo", "Alpha"), + names(TeamSpeakSettingsDb.readSyncItems(db))); + } + + @Test + void putsItemsWithBrokenLinksLastInStoredOrder() { + List items = List.of( + folder("f", "", "b"), + bookmark("x", "", "lost"), + bookmark("c", "f", ""), + bookmark("a", "", ""), + bookmark("y", "gone", ""), + bookmark("b", "", "a")); + assertEquals(List.of("a", "b", "[f]", "c", "x", "y"), names(SyncOrder.sorted(items))); + } + + @Test + void survivesALoop() { + List items = List.of(bookmark("a", "", "b"), bookmark("b", "", "a")); + assertEquals(List.of("a", "b"), names(SyncOrder.sorted(items))); + } + + private static SyncItem.Bookmark bookmark(String uuid, String parent, String previous) { + return new SyncItem.Bookmark(uuid, parent, previous, uuid, uuid + ".example", 9987, "", "", "", "", "", "", + 0, false); + } + + private static SyncItem.Folder folder(String uuid, String parent, String previous) { + return new SyncItem.Folder(uuid, parent, previous, uuid); + } + + private static List names(List items) { + return items.stream().map(i -> i instanceof SyncItem.Bookmark b ? b.name() + : i instanceof SyncItem.Folder f ? "[" + f.name() + "]" : null) + .filter(n -> n != null).toList(); + } +} diff --git a/ts3-client/core/src/test/java/com/ts3client/teamspeak/TeamSpeakImporterTest.java b/ts3-client/core/src/test/java/com/ts3client/teamspeak/TeamSpeakImporterTest.java index 526a445..30d88f1 100644 --- a/ts3-client/core/src/test/java/com/ts3client/teamspeak/TeamSpeakImporterTest.java +++ b/ts3-client/core/src/test/java/com/ts3client/teamspeak/TeamSpeakImporterTest.java @@ -84,7 +84,7 @@ class TeamSpeakImporterTest { Bookmarks bookmarks = new Bookmarks(); SyncItem.Identity identity = TeamSpeakSettingsDb.readSyncItems(SyncItemsTest.fixture()).stream() .filter(SyncItem.Identity.class::isInstance).map(SyncItem.Identity.class::cast).findFirst().orElseThrow(); - SyncItem.Bookmark bookmark = new SyncItem.Bookmark("b", "", "Server", "example.com", 9987, "", "", + SyncItem.Bookmark bookmark = new SyncItem.Bookmark("b", "", "", "Server", "example.com", 9987, "", "", identity.name(), "", "", "", 0, false); new TeamSpeakImporter(identities, bookmarks, settings).importAll(List.of(bookmark, identity)); diff --git a/ts3-client/core/src/test/resources/teamspeak/reordered.db b/ts3-client/core/src/test/resources/teamspeak/reordered.db new file mode 100644 index 0000000000000000000000000000000000000000..31f0078d7c9743fb9ff50c5eefee76f691e823ab GIT binary patch literal 212992 zcmeIb3w#^bb>|NV;6s#1$gm|?lw}Vg$pS46G4H|HVO*M`DLE1;i=<>H?PBL~hlB_M z3;>E^ciRn}G`ndwO+Rg(PTHjDBW>2(cH2C*>o(iw(O2Iw~tNoZ~D)syXhv` zrrmA-ZZ`klodF1dqU5oo_>mrn0tPdK`}od%oOABE_s%_hw$xyPU#+d!4MC0Vi^b!y z?-7JpEcROb*YLmfx)TS<))#!nJC3h+_}bXm+&}K&H>aNF_o%6-hen5fZSc1TGlOs6 z`|&;B+WY1`j}LrtPif!{yMJTg{OHSb&zPH@-u3ouEOfDz? zHaU>^zQpGedw0pZelPxHJQ4rl>qYyl&Tl4jeVN0D+(l=HZ2@lfo6dyvACWNAsh-naRWPSgGQ%tMylx@mPxXTB90#FSg<> z%B`cZ#__(){U_p^dxAT{+h%>gT&l2htX{VlS-pt(x1BoK%+8saQ&W!!*Zq|+J0ooS zrI15tqnihh^<_>V+EPGk+dbR9-qXcy+r^uYaQyDx%)=+Hhj3f;MS0ta6SGHqGvdMc zVh7LZa@DcR9AkJix&yuTJsev2EoAkB*}lxdgYnHv0jlsy_dR=%?@bKmj!W}<`9`C7G6b=Led z4Ym^0x2_XMb|BStLkm{d$tJH`@94`MM|3RU)pbYLmys@NU6*b?IO}k4=G^h?f$NIA zD0h9$P9N&cjP8#YJLt`@^#B_G6n0?My3Wf}a8J+%T|L;B*}p%&ITwK8=lTCTyD)@z z-|QN7e7HAr-~Q|6p2t~~`TJe7w_nqiOn6?k667{KI=n-E+xPGshu@lQ$$`$cB)k&7 zAL`0?>o+$$=O;2ZYD>aci*opR$L#)Va{qwsH9Ms6=)exSZ{NdnAAW1*{?^XihgZV) z+q!b!`pr$x{cShOeHd#|4nOxVrh7BivG_mhDCcJ?4YpXb8>MCm==^@`4kS9Sx0;B~ zbIlfF-@d-gv19Q~H>e1mH*_A~(uJt=%FS;c%v*XhuQ+zS3ep*OQSSVfzLe_C$cN*h zxD${oqV@1gaQgX0UylY)-eGYZOX`Q|KVDdvZ67O2^22Ey= z>6E*-H)9@&|C5eVG_kr`F1bM|;(6`(I=BOtj>|1F9jBUb1_$~wM~=id?Vtp8T<av%`P$GuHMYVq3hM0X0#CY!yG0;4Ou!c zh=abNH^x#=4t;Fs{X=g|y>aMIQ=ffS`ZL{31c(3;AOb{y2oM1xKm>>Y5g-CY;Mouu z?n@@~smq^udSPy(;?7=SwJRmIKDSg|ugC{`lSwhScGj*pf^%m}F00g;p6N*@NBO0Z z=9!DE#tk3(rnsjkdEzni@>9yoC)a8Dtxe)q*iD8*3Ck}vUHr`QFR12 zHjqr7xR0ln=W$`xvm0!3iMh*)q!^+s;cs46?$xAwRcXvL<=c1RexC8WPI2pf8aR5> ziP3nsX`|=X#EJMelg1u?Zkyp?fS=oD9N2{v4Yd>Y5g-EJK7kjh{?GmYvgz~Oi@ zX~y_00lo~vTrde?x>j9Vy;Q=2JdFY5E1vpt41e?@0z`la5CI}U1c(3;AOb{y2oM1x zKm=ae1a425yGj3lX+J|sJrN)RM1Tko0U|&IhyW2F0z`la5P@eRa9#aB^#7;v|7QY7 z*NFfTAOb{y2oM1xKm>>Y5g-CYfC#(<2xKq|;I4yw7Qn-;O%U`kSsyEe{{P>IrM~eJ z$OR>l2oM1xKm>>Y5g-CYfCvx)B0vO)01=2vU~l5C-CI@w(*L7kqx*;e5g-CYfCvx) zB0vO)01+SpM1TmqqzH8B|J?sSk$PV&^|{n<HpCX(_KV> z2oM1xKm>>Y5g-CYfCvx)B0vOQa01_k{y#YMc&u;mn~Bs{Q=c08!@+M3{o|qIDdh#v z5hZ{K5CI}U1c(3;AOb{y2oM1x@Es#CbTsxiN%6J!!&&;R=gann183>{snA=Re?M1p zC(9*wxjtK&Z7i``ecZRpbvAH{T`9TjRH?p-n`Z14Hr_lnKF|v09DJ>3udv!At29_` zZk5@~tk(Sb#PsBNqqfEd_)T-wwTd@&b=9uaOV!G_f|DM?o2;(*)mmewTB@_DiVeqZ zulehX)$-a3!(Ao6gdn9L%FdLoSDJTrh7ta1Tr{L(eaWPC2w4_7a>{dlzE<^1W!5|k z717+EOrAK$ozN%k)y7(lwbkYc5f(ju{|YZ5(ty3_2BF`%3lB8LA80E}-AUTVCj@j|=i~o# zkimlqvvq&By`pC%F&%HI^UV;uwfY0MCQfX>V?U3-^{ejNcX9v!)+N&azq^VZ<%S3l z0U|&IhyW2F0z`la5CI}U1fFLCFA@Epum8U*btslPjW>D`0U|&IhyW2F0z`la5CI}U z1c(3;_=iW}1eVpme}vC@ID?5Bi?zUCzkaq*tikM+I-eUd=2lnorFM+P z5@rF^^NrxQ&5zsTLgJoWe>}Z+Zq2E?wbCk|OEBC!k7*!+-27CUpXxos{kzh8FR*f$ zgQe2yaQ}nVa=E(BYJB{ESL&0o)F)G4{D=35DaS;B2oM1xKm>>Y5g-CYfCvx)B0vOQ zyaeR!_6TlZxILlAcRIi4aN_=JE^HYv_LBbp;(gAPG9o|(hyW2F0z`la5CI}U1c(3; z_=ip4X6pZe|Nq{zvAuP?(TfNW0U|&IhyW2F0z`la5CI|(k-#xHOsj#z^aHlH$gXvj zHdM0!SLxTU?deU9KK7;uxwCZpRz8Z^@9z7V*SzI-dxw89K5$f$BwbMzChBT|iJI#u zqNO^9=$T$YWd&0$C{}v+`4Vf)t>A5VuH{$l1ksCp^>nPczs2ZF-{zPSKDtgTgqdvm!b|M+dM?Umxg|1rp0LAGtl z7YnZ9iJDQ6MaQx5RkIYIxte8}X8N{s3;_$1OEq}Ouh?}#kra9OQp7wya|C&}6*3Pv zE1s=Zmxc8uyCKZkm4OWvdk(192gC9I&&E=pP5nj0YEHKi0U|&I zhyW2F0z`la5CI}U1c(3;AObH4fn(iPv~*%L-hF0ICZTqm+V1~P`u_{^*eFsWKm>>Y z5g-CYfCvx)B0vO)01+Sp&x*iv*Z&dC?KQS&*F3>4mxU^vCTfCTtu@vv@C0GyGWQZ$ ztCSk`vE0|*@Rm*PKk;wif>7`Zn(FyBTo7b99!MrUK}<&#EzR}af-kAeGSaEGPs3cp z_Wj{Uw|OA!?4c7S?EKbxiAAi$==<6Iv%X()OLkcZq7u%r6^GSwzx0`>KEl)d!641P zt(vwgI+_F*7R@k3N3~SZ_Z7LI*_Q43YI@%+97fh{tkWo*W%lA4i|G4N0E}k}JU@Hs zY%ws*WDlPKWxfPs;QO&X&fK>?{kPxX-X5PuvMottaD#G1Uo|Ww+jD^0H$`366ejD2 zBDrpQZ{VtO&UTkd6*hb^66YuZ=NoWVDXxU!X79UHtt~T8D3_MuEF?5fbC035RnKnV zoabS&O77B9Ut480@zrZ3cUjzv+4LA!`yt=RiXQ{A8 z)N^nD+0Vb3m!2@m1xYTbs>n6E<@ zxbj4O8p<<=pKk@vU4*hbMV9-<8-Db!df<=t0Zv)fnQkk#Xz3a%spi_EZJV~J>#k`j z1szU9a(dsCie$Tp!8(`TzJY@8AXG zvq1)!YZxBf6)mJ)V`@QkBndu?rsVmO>l?16rG<8rIKk_RaEe`F9%xXRg@Xj_IX`ewm!9Z$71Sx(>9ESVM7F8ON2_C87kt&(41b<`_G%^o_7 z;uJVE2943mhA?lh*o##(+@;*t{{H9R!yn79^5mP6Yf21FjRaRrO?G9`c6C=Q$Zo;1 zCBrpsBc17NYA)E0Q)=+Kt48!)j1mWY7tu7=+03In;Os4@s%SwSIAXH0P(xQRlKbYn zKJb&=mGnRGRJ)$6E4C>*zM-QqxlFWCKt)6G6w@#ZzG>O%Y`ZW`R##S8qr{g1ZdPL< z=xCxof(X&&c^qLA5%yts+$j3oU;NoG{=d8-`ZCWAvlZ1fc_XhQH(o(O&nvkiTt_wA zc4Z0PvFSVc@Oe}hszSfL8S!naHoX}rNcI=6?oL1wpUj-IukdNd;GmW{unQ9e}tUchKUj-6+{n5 zqGlE}(Xk;MsXjW4f~T;8p>OpPC=RV&LLOd-RPUpNpT81zLKOxd*_Une2%ewg-oQ?I zjhz(c0`J(+U3hMtu||;7I=H}p7{0<|x!1id6#00Ow0-6os;{9PfTOIYnU-ifXx}8} zOS8^VNFT?N-+H(CZG#FEDn*{w*5kP*roMLUcnduX1w z%t5;VDVBfMgt@iVRY`Dnsr;qqbbC zc)6eFF7ZhByLh_I0=%$Q2p^_iKsRZkD#>^X8X61B(QHZ8lyvfbydqYZC;{f-Vx2v3 z0m((tVGR_O&}SLi0n2^kf4%F+dFnpGQ&&(x(bnNit)ik^3Pfy%dhao$5ih1QCp|cA zWBqhILoRn%!}F2KMU;^9t$<}Ko4r`7mm28C+l>@Dyw(jt%(I+I<U8CJXGOw6=l^68w3|^LK7Mz9CVJ5MGHE!{DM``+;nmt>;Ff5_)!AP^Y9?n zW^ZX8oJ6q=&WzbV+iW$hod>%{z zin#39hHIyXPD8T5_6lew5n0r}-PNBtXtc!5kkPl_778QXk>%d}?*IKpp4#8xsWr5M znEXt z?EGaU_klNm?f>#-?q3J_C^)XGE20T07&?dn-AeP2Ez?mXQ#O3dvD1U6q1&w6Pzw-` z5>fJXjb{!yUte26{lQKg%!U56lD(Dp)GMsa>+IOrn6Lz`H23vi{!ee`-1$r}*J75b ztA+^m8>S|J7Ht_lqU~$2coa-qGnG#9{Tf|xu2hD$JUaY+(JDZM=(@GRdJz83`k>m; zX9fvt>w{15yfG9eO+#_=9W>>>WWeeNlZa9&5#^Ex1`mTi}XHZ^XB$o>2G|I44? z1?k@gskhLb!`5VB@*uQVm=_8j+8oy^NQP$0s%*;XJ=2hf+38bb70iN+)_r=~Gl!d> zK6m<5_Qa!HhCU(-=g@(=H5>EmW*`E>5XkMs0ypXivLtLk4zK6l@PB^-_K;n{j6qLh zwxqzk=h$4rc3~$js1EFw=(5m{Squ$O`qr=s<2^{Af(OlIv4BrM%W5t2n$ z<5e2niCDnoM-i=$=6e=Qw6c`mf8It2p}ZzsVr-cUn#S-yid2iE#E@U*5fm4>1daZM z=Sw!S$1kwOKzT*ZytNuPknNa|+>d_YEg$1u@+WzQ(0FQDmq97@ zA~sM_g3s68Qn{Rc*+QiZYcd`LQad+!=ImMFd>NMDFTUn2m>1iOAEt!{YE=bKvC;_b z3oF$crl|hr`<@I$W^NE=GIVUNjOZ$6r)n^~q3=fhVR&w~S8zPVD5P(JKF@_aJe-#K zHrmsP5_+E73|ZxJbpx`fyPO@FK#K({)`ozoy+I8Mt_yxRnRwN%IglqC9kYPzF`h7$2>eZWt2NFc5<_4Hn(NpaOd?rYc9&1)~HEL5YWmYOH35rg$EL z6kjQ^_1tIQ^JnkniF}GD(t{n`gHEE@3L01k76Ds^0;_qF;k&NnnWnK*_kd~;ZN7Pw z2-*@-Hh-q^#n-$u#Jf_39bg@1Csy;<$|yqbfL4gBtuYbaV&-1=GhYj;!LRVl__|?2 zrW1Y5z>Ilaf%3v6Q#2ri0t9T(j+ef5ZWR`7^pn^KOgIafrc!4Stxr+H&vyi$J<$Au z>fpda+nVB>``SA{6eu-(l)_gOSK%fl^u}mdJ(PGTuNH>8bj5QO1J+t6o#I0@Xr>=v zHmvdU7bA9aQNqsGoW_;x!EF%;Eko8u?#KS{ZGXTUnxE&1#UynPV{jt$ZWzH#Xoj}R zd{Os3nNv1hzmVRep@&4Tz5#1uM6yxB&1>l2o55yp>xe^e*Xj*O4z=9ZU;p;s=Sk%% zw_nhG6DB|rf+(LQ&WAfe6IuWUXJs_+3XHD1CpR!my1G_bj#!+dgqq(9G<)C@6PCD0 zZVPUyfjWqF2GH>3KJuZDLAVdAAO=ohW`(wGXdVPgRrX=h;$z8DLDL-H^Ayk8xo6cP z_N-B2*r{jLvPU|4Ry624^{QI#EC2o{gV7Q`Fz!3Dt|>5i=|1C%E?Vt^jv*5Wo|5Ca zo@cAxHvLeET1FxS-Ju^U*heZ$4(mPOeVIYfLDe5yS=DmC`IBFL9Bm-f|KXi& zm{ArP$gi!QEUv8GkgbCJ7P^^537w;yAn65o<-sKT%p zN?!Uvw@HB;JGpB`L~S%m6dmPME@IzH9(?v?Q+ACT>Cja`%!SBNTE%D(gjx6#a3y40 zs+vC&>R8^xUfHsHaO=LT%NCO$tV@Os*-3}t(UP&+hh4A@Phu_{D0b96)QHy6DB`{bf!@KG1?Gvz(*;s>xYktByv=0okEZU_??)9&Ed!X)db1ozgxlkzRBD!uE_huqK%>zkn|c0WgqC@GLMK+qdBYq-yCs7%(XFMxU>s63rzAOUyiDxTwR;fWNJ3 zEW3_msu~Qv8gHIW4T>tS60RmQ9nMXr4|R;s zZ;QI#RNi(Ce+&;mk#q}YFAQ2)Fz0C|3QEC}Fz({Yx@1_6jQX5D*bV{<^T4Ai7`GMF zF=_aGq-H2eEcqa4HG6D(WV7pVCJFQ&72ai2UNAVF`-3Mw9(XqKQl!9ThPf(qXv4xI z(D|sAp}82#a7{=6kiA{=dYMq7XCgu@`9^gW`hWJw&Y2Jeg?B~GEd11`p7;`%T|U9H z0RJU8?iiw9fH#w-!Se%cD9rLqF&M03eA%aTdTadVG^SxI_s)9~c8LoW^Yd zg<>Eedf6jeaZX)z%WHL5J-DLCThpyXY>gyw-9af7Y~8^4kp>Y3CRSLQEEfwr!A8KC z$6yUmmGmuVR-mXhFg$;uT4p?|i2f>3LeIAXFSY{Drsugk7XAYBUb*DMkL=0Eel)Oe z^OcYk$1g~V30EQJL*X$z7v>8LiK=)ewuB*SS>r2il~yD*ab?0@_4)4bep2}p4*1H)mmC}Z&~ zZcT#PsT9y57c{Kig#Vg?^{3{lQ2Ti68BNuU5-3_v9_n*$I=MAoflO|zC@PA?xJM9l zHw#N?L8X zo_pd8pAAN(xip}{XVSMp7d8|0R`5}U9~_Lqwkj(=#BxW`q#Y`$84-Jw;PdGAtGt4m z**iL`A#{qZipsC%e($3n`j6Z~$H$s9sQ^I}-M_6%sFFT3PK!G#zykn+riwMppw17$ zCLmUii)XO{8r)|h8m*%Qo#!FXwgS$k&#kX5*>>k&?yFCH<$v-q8s30#3zgwPl++kE zv>PzL*^mV=P~-cCXJFYl$=Dj=gBoI&f+4J<%N42ZunNQ0_J!hhRuH3v-{H2`bbP+nX;rqioL0FDiRLJ#1GiPt zfg=uDMvUAP92kaV&Cx9bjz-X~)B6+&)qJ8-LAO?`L%WUW3mPSG$n8b0TGg{7lhBx* zTBw6yO+GHj2ZIA!QbO*3zv-9$1usjynbBNBwtbjc;OD|yayT_RXk0`^_g&~&Hq39* zb9O0;68N)lDf;QAOA++{%r6CLXPT9C#jKqXo+zy2O3&d3TBt8Xn)|+`ZGY!a4hLwU&G1JHCcSeOJ(f zVldm6nd^(T#1}zSP_kh>KzD>fqN%ndsgmC9YE+2YHbw}!Tj+}5ZPa$#;e}jBx$qpf zfbj}m$PJ7~Vn7cTFzzL#JIDhHd6%D*5i#*mLheeuk-e+K#?>4>>ggwwC3WyD*+#gWd$c@QCtylnA=K7gw9%XYXpogn^@u zX1$e`joka*A385`#Ys0{dg5bshKq($gN%TD;HzRW&4SI>kWDFl;1s$J#s{5NR^b+0 ze|Ga(qC}BDHQAcaa-?fM%g!<9{?l9D^#5^bfqRwfkO?#-S5$RW19+*x$l+p9S%aCf z4<8|1&N<7^cQl2FZ!+rXAd9i zvf5JmmIrOLVzo{YINIP`l+g2j5O^KZ4sVLH2WP7A--Sanmo!mw*U?!CE=INMxsU(J z*Wb#UP3}Twz;#2za>Sy<2U;`*KIQP(bVb*Iby+vzYXHacuKKG*tiMr0?yA39_E1O5 zvrQ6iTh)1KF)$-YmSu=BuwHT{NrC?>%mumuuPfWfAQvACo#R$Rdwz+{*5LA2fx$AG zvKJ-v{CpK&x!K%o+4hCtSoj{H0d2!w8f#p^px3sjx75@i`I>CQ>s=S&6$>e|fXQ5z z3Hexp`hgX#G2Z|SL+?fy@B`uMUNo85h!84Q_js_+xv=vQIzv+w83SA*#@M;CiiNlx z8@|$(Wx#sFd>^jI&_i0Id%{D^D@8>gA!zPsI6Iv^*y&=3!VTB*rq_3_eMd!Tnv)< zGOYK8t)=(3fp=K*SCtvFn6@9V()zV^Z%7wH@Gxuz(vdqmZg?4 zkc*LjE(t3tcmBjI5GWuRY=>>N?Ye+*wb0yOX+)IdqePJpz1)z4TPIpNQwfWKmzW2y zz1+us1h~%gcJ#59$Y2ic7>+L)!=OF!&4HD?6+Z(?1pd}W5yUJ;)iqa!;Pr-MTsEK1La}z zPaaJ+@Pgsi#|hq2hOzRmlU2B4yQmtuZ@uFq!3yVm>>6`HefVR*ByYfi0ACRg@-ftM zI8$3_NwG+~Y@~b7oq2F__FP0IBubF^m68ubYW9vWWZ|C*Q{1S6T6!KX7}XjEa9}@Z znP~VP1&~`D&w~&KKSH$Zn6t&F$3Q7jWDhDy0UEfG9+*~ysXCv7QjgfQM+r7RtrVM~ zX789-L?WT028t`(BRN`IK)gPja$fV{&;Kkh9(?o?12dk6*$krVVY~)rUWmYktD$Ft z=|=W2r%$uew}ehPbAj6{*YwngX5J{FW9Sc4sESRWS{^v8HQW;q(_x_0H|P6e4iQ)F zS?<3+_3LkYuZ-0H1W&!`y1oT{&oEsyESTOZ+R&p!lRG+Kk{^V4JKc8fHwoS7TbiR zDQ(rLpPQ|qgDi8eK+M&FX&UNuYhJ$#uYeM}4_#25 z@BbGc`qdcz=tTsG01+SpM1Tko0U|&IhyW2F0z}}&MBuT9;yuZQ*G*sk#M2|XUC=S& zf&o1pHbywwW7rzA@h~cbjr>$BEdbx7aQ&n4wzYH))0x-`X6dasrw6!^0i$EZQn>g` zd0dtT8XK!@{QTL4=`%9}utQYpaCj>hVGZT`BaSy}YpnINad}K1@UWOgt+dM5-WkW- zdjts63nqcVOAagOVa^7;XJJM1xs4evq}&c9C|Lf?;(B?FtyFQ>hQOUHunth5sJGKP zS%%L_V{D*Q@vGx*@a5HOm<|UwzcmbT4DcyrJf^IV#`(FP{3N82;!*1c(3;AOb{y2oM1xKm>>Y5g-CYfC#+A z2pmr=?2cj_A^ra)_FyTwM1Tko0U|&IhyW2F0z`la5CI}U1Ud*r)&IHwe{%5ui4C0{ zDhv(afL=s^2oM1xKm>>Y5g-CYfCvx)BJh$Vkn2w-@4D~uQ_B4_>}q3jiMh*|Zf;uFQ)Pi=hFPS_x&hI>ng>KGOy^@c0GH|nwMYKgpo0qM7b@N`?8j~dH zmFeDO^6)L;-Ic{Pdl7q`y;kn&NgjUvxiGf%`aEKM*@!4ETsS-4T5foKeSK_Yqk*Mj zuzI(>JciX4I@iOxf32}ntYfWj7k>72wHSK5-_6frkCW2c$~c_um$6uHaLUEXR(5Hz zGF}fhGA%A)zYHvVP+Y~XF;!7~`2ZFO#2WN2d6_LN)tEn?eg1)DU%n0e%kuWi2U5QqOQxQTrM{8+ zV(Q7%XI_$poDxk0hyW2F0z`la5CI}U1c(3;AOb|-yO+S;#Njw>4uP4a2ie@)vhWNh z?!twpwWohy;#j=XqSMEJho$xdqfIaA|KGg@gmOj%hyW2F0z`la5CI}U1c(3;AOhbN z1a6A{&;9=g`hPr@@`nD;(Dx1w?0I_6Jp(_m`-%Qv!%2D(0U|&IhyW2F0z}~XA#ij6 zuBF=Lr_?V8?yA@)>h2%=$`4$*^AEmv`gcF`vA4f!@=b?7X%#kCclRVyuYH8yXQhu~ z7bsb_`R>+|SrC20)I>v;6wzg_CR>JMI<_Rl?m3DL(1Mr9-?zPmSA1WJ-Fwu*HueSI zfupQ~9kM*r!bVP(C5f(W7cA_FjD36c2e28g>MN4VaF>DI9I^K*mY?y(1p`<#>E^rk`i|HlF1|I#T2}Jq}uu47MZNmL634bLANW@FzkMKlYhh3#Nn>^Uhv ztHeesavk)8JqXi-c6oK_xzT@YFWj|LuiMAz>nKj1>B}Z|+bhUEYLF?L*p1p(v6;Cd zY1m(l$;^Lt8H(~eTTkdU@qvBqRnO0_Ipva@zV%AA>k|n*@#@I>2#g>7y3*e6(B@ z`Ij|Ulx=MBXW7_p&cgQGlBO|5^X$kt;=E#?{!LyOe>nc-_`vVSHS6NkdiAnqJ^auk zS1vmB`ISffxw)lzCf|MH_}E|lx@&cj}1LV2ZsYN>qs;>Cxw zS5%h#v+D~FdeaY0vQveng^D!oKHONiAYWacoOo#Q!P8b{;o`*9D;_*^t9 z<)ud+(67#%UY~eWe#kqsyt?|p)P*H?(wciznt5npVMehl7Z)Dgur9jO4>cA}zf!$) z@#3jVD|+2tzIth9d1>L?spap#uyFC*!_vi>b1U8j=i-cg?sQo_KQE1^TkMCMtywmf zi*MeZ;MF_FiK^+NE=cOwv0Zfdro)!&IHIjH30o#>j;t0u30urYCYlI{evlJ=JT4DJ zdg5D&6ynRfkh0Ago-!qU6gvwCFA@9PV>{%oH~x*kBB!h;NZEUN%03WJ_Q!9JZyv;k z1*ymG;jzi-NcB8&Y`usrQq>Jxj$ern4Gi#!3J+Gx9;@w(@%8@(QXh?_o=*Ku>T9Y0 zp8E6D=TiSA_36}qz)5-$0U|&IhyW2F0z`la5CI}U1c(3;AObG}0^9|lWh5WyNu=V| zZvI~A=kI18e>ZyhyWYd!wIqL66Z~D-l}w~|%cTFm2p%IPfd~)*B0vO)01+SpM1Tko z0U|&Ih`eE2L&GC#^ zpXfp2cDQ@eUTv(^Soh8MB$LU9cgV?3xqdK_Oit{OpEDk|Cnz;G7S>9h?MSL>6=?Xg>Y5g-CLhd?Hw#&@t#>^+pYFMb`{#GX46<6GCZn>Y5oiUDdO z)v>nzG^?(#Mr}iqJss@Ac)Igl zHw(en8~o-jOaiciIUsHolQG=Jsghl;E}pB_*j&SIFo}=@ui;w`H5^#M>MB-q=+P$*@fb{>Y5!ji)bJqX4|9?F7L=1oQA_7E!2oM1xKm>>Y5g-CYfCvx)B0vOQ z1OzVZ>Pa5i?B}x%FwJ0YwOnd6SS_3p;5VlYNa3^rNm7FIDhsCwNCj7t{pM@y9^A{v z|Kq8z$M8olB0vO)01+SpM1Tko0U|&IhyW2F0z}}ugg`2BB;H{>*hTvPcgcgLY!Cq= zKm>>Y5g-CYfCvx)B0vO)01@aQuwDNT{Qrl3E`~pP5dk7V1c(3;AOb{y2oM1xKm>>Y z5qNE_l3!x2-)}o94P06()mK?`2W+f)YC8UBc|wy01+SpM1Tko0U|&IhyW2F0z`la5P|Omfn*}JyE*@#^#AV! zU<#865CI}U1c(3;AOb{y2oM1xKm>@ui-16&{}1+$#t!uTLM%0v`sC2phen5fZSc1T zGlOs6`|&;B+WY1`j}LrtPif!{yMJTg{OHSb&zPH@-u3ouE zOfDz?HaU>^zQpGedw0pZelPxHJQ4rl*au>3__xyw0cg`B@mQ(iv8(l0V;w_QwBfxG zd@s&5>_({$*N1vhZXYX`?&;0QhvVT*;hmG!O2c*=_2M$yXdUM#FHB9$PYGvcPE9=` zTzj7|J0rC26>|9DX#Z&M&t(oDj&HuIVLN5ky4d;@n*q*GJaBfZn&YnFfAbjEC#D&Sz6BoA5;=VHvFHD^juGr-@*19~J zAMMRd9=;xwR%(iJ>u9WhwCAh$pNMbn2{IYxblV<~9L%;;CwJhp?H2wkj%nNJ7OkGE znG=Y%6wums&$h4kbg|oZQOMnFgyVPjW*$CqJ%rn$FUs3aoai4-{)BiizSzNYx?FYa zG6xbKjqX6NeGi8gervHxo;`RlzIiD?6CwPeI&l#k$V)i3UeE!%3`yIHNV}x1BLE;o3*TYe~U)q<(ZL@_-3(H&zhIpKRw!o zrG5V97Zp|L&0N0;YR4SZw`Mwz^^flQr}rI?Zzehzov&3JRcFmV(_kw>L)3NR$PT2s zZfMoDu9GcZyM{8y5giM7b=}eRWu%K**QJ{e&N|$iId}YeWvVOkqTKa0+dmo~AKf1> zcF@C8GyydJDeS1NtpvFZj}GsU-}XH`$KkiIH2mO!zD&C<39p3jhr06J`pwPG zdFpRt;`Q5-FxH|Re%>*=zc;fj_Yc_KA`5aK9v#>r_w9Rl?!#}*+~3-n`|wKmep^@W zTfe#4xj%8+jat$$)}kDK?q5vzW~^iJf7VgX&r}+0u?D%OSpqu0-?{^d&g-ovqVrrx zWpm%YzRa;>@l7|V2%R@{9^cZ1sPoFrZywBBdNZ#$cD)MH8Fx|c{Fc6yx<*1Hm zVWDXq@7n=Z>skv`>w6PYa6E*-H)9@& z|C5eVG_i^`zulk|@w|3?9ozv+$K@88j#EuIg9Ck;BS+$!aBfCZ+Ht+(a8DPajte)R zlD?-mbLPnPicd$>XlmLp_Rj9UroEZx`3c&a@MvHMLhXBadlPl$GzROQ3KQP0tHZHK$YK@QH zox(B)ili8#EQzu>Y5g-CYfCvx) zB0vO)01@cVA-`;N$<9zJC)-{bA~{RR7QyhTb+58~mNYOM9Q%`_{eMo)7N% z=X;ES#|K`u`%An3(QdK-GyT*3Y1~dPB0vO)01+SpMBw=(P!xMJ+otKXC&_W|&Gt8K z2RFv{)t0Ac`%LJ}sGhvh%$WAwU6b=R2Tt^L%>Y5g-CY;5$xW$MOIFADaQ%Jpcdz literal 0 HcmV?d00001