j,SrSSKrSSKrSSKJr SSKJr SSKJr \R"\ 5r Sr Sr SrSrSrS rSrSrSrS r\\\\\-4r"S S \5rS \S\S\\\44SjrS \S\4SjrS \S\S-4Sjr\4S\S\S\4Sjjr S\S\4Sjr!S\S\\4Sjr"\#"\RH\RJ\RL\RN15r(S\RRS\*4Sjr+g)uQReader for Apple's IWA (iWork Archive) container format. Pages, Numbers and Keynote from 2013 onwards store their documents as ``Index/*.iwa`` members inside the package. Apple has never published the schemas, but the container itself is straightforward and stable: 1. An ``.iwa`` file is a sequence of chunks. Each chunk has a four-byte header — one compression tag (``0x00`` for Snappy) plus a three-byte little-endian payload length — followed by that many bytes of **raw** Snappy: no stream identifier, no CRC-32C, so a framed Snappy decoder cannot read it. 2. Concatenating the decompressed chunks yields a stream of archives. Each is a varint length, a ``TSP.ArchiveInfo`` message carrying an object identifier and one or more ``MessageInfo`` descriptors, then the payload bytes each descriptor claims. That is enough to walk the document's object graph without any ``.proto`` definitions: the fields this backend needs are read positionally by :func:`read_fields`. Only the message *type numbers* are format knowledge, and those live in the Pages backend rather than here. N)Iterator) NamedTuple)DocumentLoadErroric8\rSrSr%Sr\\S'\\S'\\S'Srg) IWAObject7zBOne archived object: its identifier, message type and raw payload. identifier message_typepayloadN) __name__ __module__ __qualname____firstlineno____doc__int__annotations__bytes__static_attributes__rV/home/mande/repo/quber/.venv/lib/python3.13/site-packages/docling/backend/iwork/iwa.pyr r 7sLO Nrr bufposreturncSnSnU[U5:a [S5eUS:a [S5eXnUS- nX$S-U--nUS-(dX!4$US- nMR) zARead a base-128 varint, returning the value and the new position.rzTruncated varint in IWA stream.?zOverlong varint in IWA stream.r)lenr)rrresultshiftbytes r read_varintr(?sw F E  #c(?#$EF F 2:#$DE Ex q$;5((d{;    rc0nSnU[U5:a[X5up2US- US-pTU[:Xa[X5upbOyU[:Xa4[X5uprX'-[U5:a [ S5eXX'-nX'- nO;U[ :Xa XUS-US-p&O%U[ :Xa XUS-US-p&O[ SUS35eURU/5RU5 U[U5:aMU$) aWDecode a protobuf message into ``{field_number: [values]}``. Values are ``int`` for varint and fixed-width fields and ``bytes`` for length-delimited ones, which the caller re-reads as a nested message, a UTF-8 string or a packed value as the field requires. Groups (wire types 3 and 4) are obsolete and unused by iWork, so they are rejected. rr#z%Truncated length-delimited IWA field.rzUnsupported protobuf wire type z in IWA stream.) r$r( _WIRE_VARINT_WIRE_LENGTH_DELIMITEDr _WIRE_64BIT _WIRE_32BIT setdefaultappend)rfieldsrkeyfield_no wire_typevaluelengths r read_fieldsr8PsF C C.s(!Qhd )  $$S.JE3 0 0%c/KF|c#h&'(OPPcl+E MC + %37+S1W3 + %37+S1W3#1)OL  (B'..u5) C.* Mrcr[U5RSS/5Sn[U[5(aU$S$)zCRead a ``TSP.Reference``, whose only field is the target object id.rNr)r8get isinstancer)rtargets rread_referencer=rs7   ! !!dV ,Q /F,,66$6rblocklimitc<[US5up#X!:a[SUSUS35e[5n[U5nX5:GaXnUS- nUS-nU[:XaUS- nUS:a6US - n X9-U:a [S 5e[ R XX9-S 5nX9- nUS- nX8-U:a [S 5eX@X3U-- nX8- n[U5U:a[S US35eMU[:Xa.SUS- S--nX5:a [S5eUS- S-X-n US- nOGU[:XaSOSn US- S-nX;-U:a [S5e[ R XX;-S 5n X;- nU S:XdU [U5:a [S5e[U5U - n X:a XDXU-- nO([U5Hn URXLU -5 M [U5U:a[S US35eX5:aGM[U5U:wa[S[U5SUS35e[U5$)uYDecompress one raw Snappy block, emitting at most ``limit`` bytes. Implemented here rather than taken from a binding because iWork needs only the decompressor, and that half of Snappy is small: a varint length preamble followed by literal and copy elements. Keeping it in Python means the format does not depend on a compiled wheel staying maintained for future Python releases, and Pages documents are small enough that the speed difference is immaterial. Raw Snappy expands by up to 21.33x — a three-byte copy tag emits 64 bytes — and the IWA chunk length field is three bytes wide, so a single chunk may declare 16.7 MB and expand to roughly 358 MB. ``limit`` is therefore checked twice: against the declared size before any work happens, and against the output as it grows, because a hostile block can declare a small size and then emit far more. rzSnappy block declares z bytes, over the z byte limit.rr*r<;z Truncated Snappy literal length.littlezTruncated Snappy literal.z#Snappy block emitted more than the z bytes it declared.rr#zTruncated Snappy copy offset.r r+z-Snappy copy offset outside the output window.zSnappy block decoded to z bytes, expected .) r(r bytearrayr$ _TAG_LITERALr from_bytes _TAG_COPY_1B _TAG_COPY_2Branger1r)r>r?expectedroutsizetagkindr7extraoffsetwidthstartindexs rdecompress_snappy_blockrUxs" q)MH$XJ.?wl S   +C u:D *j qTz < AXF| ;%+,NOOCK(@(K  aKF|d"'(CDD V|, ,C MC3x("'9(CVW  < 3!8t+,F{'(GHHaxAo3F 1HC-A1EQh!^F{T!'(GHH^^E $s r decompressr\s +C C D /  s4y (#$AB Bi1Ws[/@ A8L { + #:3s)1E 3<( u: #$BC C  &u.?#c(.JKK# D /$ :rc ## [U5nSnU[U5:GaS[X5up2X#-[U5:a [S5e[ XX#-5nX#- nUR SS/5Sn[ U[5(d [S5eUR S/5Hn[ U[5(dM[ U5nUR SS/5SnUR SS/5Sn [ U[5(a[ U [5(d [S5eX)-[U5:a [S5e[XXXX)-5v X)- nM U[U5:aGMRg g 7f) z@Yield every archived object in one decompressed ``.iwa`` stream.rz(Truncated TSP.ArchiveInfo in IWA stream.rz*Malformed object identifier in IWA stream.rr*z$Malformed MessageInfo in IWA stream.z'Truncated object payload in IWA stream.N) r\r$r(rr8r:r;rrr ) rVstreamrinfo_leninfor message_infomessager payload_lens r iter_objectsrdsY  F C F #F0  >CK '#$NO O678 XXa!%a( *c**#$PQ Q HHQOLlE22!,/G";;q1#.q1L!++a!-a0KlC00 ;PS8T8T'(NOO 3v;.'(QRRJf3CT6UV V  C, F  s E-E42E4r`cRURS-(agUR[;$)aReport whether an archive member cannot be read because it is encrypted. Standard ZIP encryption sets bit 0 of the general-purpose flags. Pages does not use that: it leaves the flag clear and writes a compression method outside the set ZIP defines, so both signals are needed. Args: info: The archive member to inspect. Returns: Whether the member appears to be encrypted. rT) flag_bits compress_typeREADABLE_COMPRESSION_METHODS)r`s r is_encryptedris% ~~   %A AAr),rloggingzipfilecollections.abcrtypingrdocling.exceptionsr getLoggerr_logrZrYr,r.r-r/rFrHrIr[dictrlistrFieldMapr tupler(r8r=rUr\rd frozenset ZIP_STORED ZIP_DEFLATED ZIP_BZIP2ZIP_LZMArhZipInfoboolrirrrr|s{*$0"        & T#+&& ' UsCx"UxD77#*7 8IW5WWUWtUu2u)!4: )  BwB4Br