jV vSrSSKrSSKrSSKrSSKJr SSKJr SSKJ r SSK J r SSK JrJrJrJr SSKJrJrJrJrJrJrJrJrJrJrJrJrJrJ r J!r!J"r"J#r# SSK$J%r% \RL"\'5r(\"S 5r)S r*S r+S \+S 3r,S \+S3r-S \+S3r.Sr/S \+S3r0S \+S3r1S \+S3r2S \+S3r3S \+S3r4S \+S3r5S \/S3r6S \+S3r7S \+S3r8S \+S3r9S \+S3r:S \+S3r;SrS \+S 3r?S!r@\A"\=\>15rBS \+S"3rCS \+S#3rDS \+S$3rES \+S%3rFS \+S&3rGS \+S'3rHS \+S(3rIS)rJ\A"1S*k5rKS \+S+3rLS \+S,3rMS-rNS \+S.3S/S \+S03S1S \+S23S3S \+S43S50rOS \+S63rPS \+S73rQS \+S83rRS \+S93rS\A"\P\Q\R\S15rTS \+S:3rUS \+S;3rVS \+S<3rWS \/S=3rXS>\RS?\ZS@\[SA\ZSB\ 4 SCjr\S>\RS?\ZS@\[SA\ZSB\4 SDjr]SE\ SB\S-4SFjr^SG\ S>\RSB\S-4SHjr_SI\ SJ\ZSB\ZS-4SKjr`SI\ SJ\ZSB\[S-4SLjraSM\ SB\b\ 4SNjrcSO\ SP\d\ZS-\S-4SB\e\SQ44SRjrfSM\ SS\ZST\d\ZS-\ZS-4SP\d\ZS-\S-4SB\b\4 SUjrgSM\ SB\b\4SVjrhSM\ SS\ZSW\\ /\)4SB\d\ZS-\)44SXjriSM\ SB\d\Z\44SYjrjSO\ SZ\d\Z\4SB\S-4S[jrkS\\ SB\S-4S]jrlS^\ZSB\[4S_jrmg)`axReader for the ``index.xml`` of an iWork '09 (and earlier) document. Pages wrote a plain XML tree before 2013, in the ``sf`` namespace, and the content the modern container keeps in an object graph is spelled out in elements and attributes instead. Page furniture and comments each carry their own ``sf:text-body``, so the body walk prunes them and they are read separately. N)Callable)TypeVar)Element) FormattingScript TableCell TableData)LABEL_TYPE_NONELABEL_TYPE_NUMBERLABEL_TYPE_STRINGSCRIPTSBlockCommentContent ListLabel ListStyle ParagraphPictureRunbuild_formattingcleanlabel_for_styletrimunique_paragraphs)DocumentLoadError_Ti@z(http://developer.apple.com/namespaces/sf{z}pz }ghost-textz}paragraphstylez)http://developer.apple.com/namespaces/sfaz}identz}namez}stylez}numcolsz}numrowsz}num-header-rowsz}sz}tabular-modelz}gridz}ctz}spanz}characterstylez1{http://developer.apple.com/namespaces/sfa}numberz}mediaz}imagez}datapathz }liststylez}list-label-typeinfoz }text-labelz}typez}formatz }list-levelz }list-stylenone>textimagebulletstringz }superscriptz}linkhrefz}boldboldz}italicitalicz }underline underlinez }strikethru strikethroughz}headerz}footerz }footnotesz }annotationsz }annotationz}annotation-fieldz}targetz}IDarchivemembermax_total_bytes document_hashreturnc URU5nURS5(a][[U5n[R "SS9nUR XE5nUR(a[SUSUSUS35e[R"U5$![Ran[SUSUS 35UeS nAff=f![an[S USUS 35UeS nAff=f) aDecompress and parse the ``index.xml`` of an iWork '09 document. Args: archive: The open ``.pages`` container. member: The name of its index member. max_total_bytes: The largest index this is willing to decompress to. document_hash: The document's hash, for error messages. Returns: The parsed root element. Raises: DocumentLoadError: If the member cannot be decompressed or parsed. z.gz)wbits'z' in Pages document with hash z expands beyond the z byte limit.zCould not decompress '.NzCould not parse ') readendswithminMAX_LEGACY_XML_BYTESzlib decompressobj decompressunconsumed_tailrerrorET fromstring Exception)r)r*r+r,rawlimit decompressorexcs \/home/mande/repo/quber/.venv/lib/python3.13/site-packages/docling/backend/iwork/pages_xml.py _parse_indexrDs" ,,v C u(/: --B7L))#5C++'x=m_M**/ >,}}S!!zz #(0N /$   x'Em_TU V  s0A BC C0CC C-C((C-c j^^^[XX#5m[T[S5m[T[[5m[ T5n/n[ T5GHnUR[:Xa![U5nUbURU5 M9UR[;a![X`5nUbURU5 Mn[UT5n U (dMUR[5n [!TRU 55up[#SUR%[&555n UR[)U U U [+Xd5[#SU 5555 GM S[,S[.[(4UUU4Sjjn[1UU"[25U"[45U"[65[9T5S9$)aRead the content of an iWork '09 document out of its ``index.xml``. Args: archive: The open ``.pages`` container, which also holds any image data. member: The name of its index member. max_total_bytes: The largest index this is willing to decompress to. document_hash: The document's hash, for error messages. Returns: Everything the document holds. Raises: DocumentLoadError: If the index cannot be decompressed or parsed. c,UR[5$N)get SF_ATTR_NAME)elements rCread_content..s '++l2Kc3\# UH"oR[5=(d Sv M$ g7f)N)rH SFA_ATTR_ID).0fields rC read_content..s# 6WUIIk " (b (6Ws*,c36# UHo(dM Uv M g7frG)rQanchors rCrSrT#s=7fff7s  tagr-c >[TUTT5$rG)legacy_furniture)rXcharacter_stylesroot style_namess rC furnitureread_content..furniture'sc;8HIIrM)blocksheadersfooters footnotescomments)rD legacy_stylesSF_PARAGRAPH_STYLESF_CHARACTER_STYLElegacy_formattinglegacy_list_stylesiter_body_elementsrXSF_TABULAR_MODEL legacy_tableappendSF_MEDIA_ELEMENTSlegacy_picture legacy_runsrH SF_ATTR_STYLErtupleiterSF_ANNOTATION_FIELDrlegacy_list_labelstrlistr SF_HEADER SF_FOOTER SF_FOOTNOTESlegacy_comments)r)r*r+r, list_stylesr`rJtablepicturerunsstylelabellevelanchorsr^r[r\r]s @@@rC read_contentrs(  HD  "KK%T+=?PQ$T*KF%d+ ;;* * )E  e$  ;;+ +$W6G" g& 7$45  M*&{u'=>  6=llCV6W    !'7=7==   ),<JsJtIJJ )$)$L) &  rMmodelc [[UR[55S5nUcg[U[5n[U[ 5n[U[ 5=(d SnU(aU(dgUR[5Vs/sHUn[UR[5=(d SRUR555R5PMW nnU(dg/n[USX#-5H7up[X5upUR![#U U U S-U U S-X:S95 M9 [%X2US9$s snf)aJBuild table data from one ``sf:tabular-model`` of an '09 document. Cells are stored flat in ``sf:datasource``, in row-major order, so the grid dimensions on ``sf:grid`` are what give them their positions. Args: model: An ``sf:tabular-model`` element. Returns: The table, or None when its grid or its cells are missing. NrrO)r start_row_offset_idxend_row_offset_idxstart_col_offset_idxend_col_offset_idx column_header)num_rowsnum_cols table_cells)nextrsSF_GRIDint_attrSF_ATTR_NUMCOLSSF_ATTR_NUMROWSSF_ATTR_HEADER_ROWS SF_CELL_TEXTrrHSFA_ATTR_STRINGjoinitertextstrip enumeratedivmodrmrr ) rgridrr header_rowscellvaluescellsindexr rowcols rCrlrl3s) UZZ()4 0D |o.Ho.H5"56;!K 8JJ|,,D dhh'C2774==?+CDJJL,  E (=(*=!>? %* %(#&7%(#&7!/   @ hu MM+s AE mediacUR[5H8n[U[5nU(dM[ UR U5U5s $ g![ a' [RSU5 [ SU5ss $f=f)zRead an '09 image, whose bytes are a member of the container. Args: media: An ``sf:media`` or ``sf:image`` element. archive: The open ``.pages`` container. Returns: The picture, or None when the element names no stored data. z%Pages image data member %s is missingN) rsSF_DATAsf_attr SF_ATTR_PATHrr3KeyError_logdebug)rr)datars rCroroasv 7#t\*  '7<<-t4 4 $  ' JJ> E4& & 'sA,BBrJnamechURS[SU35=(d URU5$)uRead an attribute iWork '09 may or may not have qualified. Most attributes carry the ``sf`` namespace, but a few — ``href`` on ``sf:link`` among them — are written unqualified, and which spelling a document uses varies with the release that wrote it. Args: element: The element to read. name: The local name of the attribute. Returns: The attribute's value under either spelling, or None. r})rH SF_NAMESPACE)rJrs rCrrws. ;;L>D62 3 Hw{{47HHrMcdURU5nUcg[U5$![a gf=f)zARead an integer attribute, tolerating absent or malformed values.N)rHint ValueError)rJrr?s rCrrs8 ++d C {3x s " //r\c/nU/nU(aUR5nUR[:XdUR[:XaUR U5 MRUR[ ;aUR U5 My[ [U55H*nUR[;dMUR U5 M, U(aMU$)a~Collect the body content of an '09 document, skipping page furniture. Headers, footers and footnotes each hold their own ``sf:text-body``, so a plain ``root.iter()`` would pull their paragraphs into the body flow. They are pruned instead, which matches the IWA reader: it follows ``TP.DocumentArchive`` to the body storage and never sees them. A table and an image are not descended into once found, so the paragraphs inside a table cell stay in the table rather than reappearing as body text. Args: root: The parsed ``index.xml`` root element. Returns: The paragraph, table and image elements of the body, in document order. ) poprX SF_PARAGRAPHrkrmrnreversedrw SF_FURNITURE)r\elementsstacknodechilds rCrjrjs"!H!6E yy{ 88| #txx3C'C OOD !  88( ( OOD ! d4j)Eyy , U#* % OrM paragraphr[.c/nUSSS4/nU(GagUR5upEpgU(aAUR(a.UR[[ UR5XV55 McUR (a.UR[[ UR 5XV55 [ [U55HnURXUS45 UR[:XaM-Un UR[:Xa%URUR[5U5n Un UR[:Xa[U[5=(d Un URXU S45 M U(aGMg[!U5$)amBuild the runs of an iWork '09 paragraph. ``sf:span`` carries the character style, so the paragraph is walked span by span rather than flattened. Template placeholder text is skipped, as ``itertext()`` would otherwise emit what the template displays before the author types anything. Walked with an explicit stack: nesting depth is attacker-controlled, and a recursive walk exhausts the interpreter stack on a deeply nested document. Args: paragraph: An ``sf:p`` element. character_styles: Character style formatting, keyed by style identifier. Returns: The paragraph's non-empty runs, in document order. NFT)rtailrmrrr rrwrX SF_GHOST_TEXTSF_SPANrHrqSF_LINKr SF_ATTR_HREFr) rr[rrrJ formattinglink want_tailr inheritednesteds rCrprps+(D D$&HE /4yy{,T || Cgll 3ZFG  << KKE',,/B Cd7m,E LL%T48 9yyM)"IyyG#,00=1I:V FyyG#  5= LL%FE: ;- %2 :rMrXr]c @/nURU5H}nUR[5Han[Xc5nU(dM[UR UR [ 555upUR [XxU 55 Mc M [U5$)a7Read the paragraphs of one kind of '09 page furniture. Pages writes a first-page, an even-page and an odd-page variant of every header and footer whether or not the author filled them in, so identical text is emitted once. Args: root: The parsed ``index.xml`` root element. tag: The furniture element to collect, one of :data:`SF_FURNITURE`. style_names: Paragraph style names, keyed by style identifier. character_styles: Character style formatting, keyed by style identifier. Returns: The furniture's non-empty paragraphs, in document order. ) rsrrprrHrqrmrr) r\rXr]r[ paragraphsrJpararrrs rCrZrZs~*#%J99S>LL.Dt6D*;??488M;R+STLE   iU; < /" Z ((rMc 2/nUR[5H{nSRSUR[555R 5nU(dMEUR [ X2R[5=(d S55 M} U$)a=Read the comments of an '09 document, with the text each one annotates. An ``sf:annotation`` holds its text in a storage of its own and names the ``sf:annotation-field`` in the body that it targets. Args: root: The parsed ``index.xml`` root element. Returns: One comment per annotation, in document order.  c3f# UH'nSRS[U0555v M) g7f)rOc38# UHoRv M g7frG)r )rQruns rCrS,legacy_comments...s>(=HH(=sN)rrp)rQrs rCrS"legacy_comments..s0 5 GG> D"(=> > >5s/1rO) rs SF_ANNOTATIONrrrrmrrHSF_ATTR_TARGET)r\rd annotationr s rCr{r{sy!Hii . xx " 5   %'  4 OOGD..*H*NBO P / OrMdecodec0nURU5HjnUR[5UR[5/n[ U5(dM?U"U5nUHnU(dM UR Xv5 M Ml U$)a,Read one kind of iWork '09 style, keyed by every name it answers to. A paragraph or a span names its style through ``sf:style``, and what it puts there is sometimes the style's ``sf:ident`` and sometimes its ``sfa:ID``. Both are indexed so a reference resolves either way; a style that carries neither cannot be referenced at all and is skipped. Args: root: The parsed ``index.xml`` root element. tag: The style element to collect. decode: Reads one style element into the value to key. Returns: The decoded styles, keyed by identifier. )rsrH SF_ATTR_IDENTrPany setdefault)r\rXrstylesrJkeysvaluekeys rCrere%sp$$&F99S> M*GKK ,DE4yy wCs!!#- " MrMc ^ 0m UR[5GHnUR[5UR[5/n[ U 4SjU55(dMJ/n/nUR[ 5GHnUR[5[:Xa(UR[5 URS5 MI[[UR[55S5nUbUR[5OSnUb2U[;a(UR[5 URS5 MUR[5 URUbUR[ 5=(d SOS5 GM [#[%U5[%U55nUHn U (dM T R'X5 M GM T $)zRead the ``sf:liststyle`` definitions of an '09 document by identifier. Args: root: The parsed ``index.xml`` root element. Returns: The label ladder of every named list style, keyed by its identifier. c3>># UHo=(a UT;v M g7frGrV)rQrrs rCrS%legacy_list_styles..Ps=,3f,,srON)rs SF_LIST_STYLErHrrPrSF_LIST_LABEL_TYPE SF_ATTR_TYPESF_LABEL_TYPE_NONErmr r SF_TEXT_LABELSF_BULLET_LABEL_TYPESr r SF_ATTR_FORMATrrrr) r\rJr label_typesstringsr text_labelkindrrrs @rCririCsg$&F99]+ M*GKK ,DE==== !# \\"45Eyy&*<<""?3r"d5::m#<=tDJ3=3I:>>,/tDD0E$E""#45r"   0 1 NN:D:P/52VX 6$% ,eGn=Cs!!#-5,< MrMr|cURUR[5=(d S5nUcg[U[5=(d SnUR [ US- S55$)a)Return how an '09 paragraph is labelled as a list item, if it is one. Args: paragraph: An ``sf:p`` element. list_styles: The document's list styles, keyed by identifier. Returns: The label, or None when the paragraph names no list style or the style leaves its level unlabelled. rONrr)rHSF_ATTR_LIST_STYLErSF_ATTR_LIST_LEVELrmax)rr|rrs rCruruosU OOIMM*<=C DE } Y 2 3 8qE ;;s519a( ))rMrcr[5nSnUR5Hn[SU5S5nUS;aM[R UR 5nUbUR U5 MSUR [:XdMiUcMn[R"[U55nM [X5$)zERead an iWork '09 character style's property map as a ``Formatting``.Nc3|# UH2nUR[5cMUR[5v M4 g7frG)rHSFA_ATTR_NUMBER)rQrs rCrS$legacy_formatting..s1 $E99_-+ /**$s<<)N0) setrsrSF_PROPERTY_LABELSrHrXaddSF_SUPERSCRIPTr as_intr)ractivescriptrJnumberrs rCrhrhsuF F::< $     [ "&&w{{3   JJu  [[N *v/A[[0F! $ F ++rMrcL[[U55$![a gf=f)z?Read an iWork property number, which may be written as a float.r)rfloatr)rs rCrrs(5=!! s  ##)n__doc__loggingzipfiler7collections.abcrtypingrxml.etree.ElementTreerdefusedxml.ElementTree ElementTreer<docling_core.types.docrrrr docling.backend.iwork.contentr r r r rrrrrrrrrrrrrdocling.exceptionsr getLogger__name__rrr6rrrrf SFA_NAMESPACErrIrqrrrrrkrrrrgrSF_MEDIASF_IMAGErr frozensetrnrrrrrrrrrrrrrrxryrzSF_ANNOTATIONSrrrtrrPZipFilervrrDrrlrorrrwrjdictrrrprZr{rerirurhrrVrMrCrs $)#&1" T] )9 L>% \N,/ ,'78; \N'* L>( \N'* |nI.|nI.<.(9:}oS) ~_5 |nF #L>& |nF #,'78E  ~W %  ~W % |nF # x23\N+. ,'<=\N,/ L>( l^8,,|4,|4E!"GHLl^=1 |nF #  fvhk"Kl#_  Uh ' h ' L>- l^=1)Y nMN \N,/ <.(:;l^8,=/& * __*&)*