@sheetxl/io-xlsx 0.8.0-beta.1 → 0.8.0-beta.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (191) hide show
  1. package/browser/esm/BiDqExNXiY7ykk8E.mjs +2327 -0
  2. package/browser/esm/{Ctqql4O-3xj2K8vv.mjs → Bs0EzhdU8WgGfPzf.mjs} +193 -143
  3. package/browser/esm/CLWsOc6DO8l1G_LF.mjs +2213 -0
  4. package/browser/esm/{CLWzJJyoSrykkVLX.mjs → CZ9I80og75SDRjv0.mjs} +2 -2
  5. package/browser/esm/{Dz1Dp8DDJvhd09RR.mjs → CuAXx5i4uqTz-mMY.mjs} +1 -1
  6. package/browser/esm/Cv3R6fGatARKedSn.mjs +8635 -0
  7. package/browser/esm/{BkNXyG6NC-w5Xo92.mjs → CzFYJPxmLyKgEKF0.mjs} +28 -13
  8. package/browser/esm/DICL6ecj9BdJv8aX.mjs +104 -0
  9. package/browser/esm/DatIA9fZbEPjW4bh.mjs +5638 -0
  10. package/browser/esm/index.mjs +2 -3
  11. package/browser/esm/yveeVJ6hKDI5KDEz.mjs +4168 -0
  12. package/licenses/dependencies.txt +2 -2
  13. package/node/esm/B9Zn6H1RV07Ob377.mjs +2294 -0
  14. package/node/esm/Bpqm_PpGLpdjL47-.mjs +2368 -0
  15. package/node/esm/{fOnuUjpPCAzmuIXN.mjs → CAJxmJdobUbzpUz5.mjs} +2 -2
  16. package/node/esm/{CEV7nKotMpeRRnQC.mjs → CxlSbH7mmnEEsqmX.mjs} +1 -1
  17. package/node/esm/DD-yXSBzvDYy0TX5.mjs +5842 -0
  18. package/node/esm/DScqM1V4wPntNP6-.mjs +5235 -0
  19. package/node/esm/{CEAmv36xpTNgFwl_.mjs → fopiRR7OiVoEiF7B.mjs} +49 -35
  20. package/node/esm/index.mjs +77 -25
  21. package/node/esm/ipiyzn5Pfohw2afB.mjs +4271 -0
  22. package/package.json +7 -8
  23. package/types/src/AutoFilterRules.d.ts +94 -11
  24. package/types/src/ConditionalFormatRules.d.ts +5 -5
  25. package/types/src/DataValidationRules.d.ts +18 -2
  26. package/types/src/DefinedNameAttributes.d.ts +8 -0
  27. package/types/src/ExcelCalcStamp.d.ts +39 -0
  28. package/types/src/ExcelCompat.d.ts +209 -42
  29. package/types/src/ExcelReservedNames.d.ts +3 -4
  30. package/types/src/KnownFonts.d.ts +50 -0
  31. package/types/src/LegacyFormula.d.ts +41 -7
  32. package/types/src/OOXMLExtensions.d.ts +14 -2
  33. package/types/src/PageLayoutAttributes.d.ts +8 -0
  34. package/types/src/Plugin.d.ts +28 -5
  35. package/types/src/ProtectionAttributes.d.ts +38 -0
  36. package/types/src/SheetKinds.d.ts +57 -0
  37. package/types/src/SheetViewAttributes.d.ts +4 -0
  38. package/types/src/SortExtent.d.ts +16 -0
  39. package/types/src/SourcePackage.d.ts +31 -12
  40. package/types/src/Types.d.ts +28 -0
  41. package/types/src/XlsxHeader.d.ts +19 -0
  42. package/types/src/chart/ChartExXml.d.ts +38 -0
  43. package/types/src/chart/ChartPartXml.d.ts +47 -0
  44. package/types/src/chart/ChartSpaceXml.d.ts +36 -0
  45. package/types/src/chart/_XmlTree.d.ts +34 -0
  46. package/types/src/chart/_chartCodecs.d.ts +10 -0
  47. package/types/src/chart/_chartExCodecs.d.ts +7 -0
  48. package/types/src/chart/_chartExFold.d.ts +14 -0
  49. package/types/src/chart/_chartExMarkup.d.ts +236 -0
  50. package/types/src/chart/_chartExStyle.d.ts +22 -0
  51. package/types/src/chart/_codec.d.ts +78 -0
  52. package/types/src/chart/_drawingml.d.ts +10 -0
  53. package/types/src/chart/_xml.d.ts +70 -0
  54. package/types/src/reader/DocumentPropertiesRead.d.ts +16 -0
  55. package/types/src/reader/DummyFunctionUnwrap.d.ts +2 -2
  56. package/types/src/reader/HeaderStyles.d.ts +15 -0
  57. package/types/src/reader/HiddenFormulas.d.ts +16 -0
  58. package/types/src/reader/IsoDateCell.d.ts +20 -0
  59. package/types/src/reader/LibreOfficeDataTable.d.ts +11 -0
  60. package/types/src/reader/SlicerJoin.d.ts +24 -0
  61. package/types/src/reader/Warning.d.ts +29 -0
  62. package/types/src/reader/ZipReader.d.ts +1 -1
  63. package/types/src/reader/_SlicerRecord.d.ts +37 -0
  64. package/types/src/reader/dom/CustGeomUtils.d.ts +7 -0
  65. package/types/src/reader/dom/DOMTransformer.d.ts +2 -2
  66. package/types/src/reader/dom/ExecutionContext.d.ts +16 -3
  67. package/types/src/reader/dom/Types.d.ts +19 -3
  68. package/types/src/reader/domVisitors/AppPropertiesVisitor.d.ts +13 -1
  69. package/types/src/reader/domVisitors/AutoFilterVisitor.d.ts +16 -3
  70. package/types/src/reader/domVisitors/ColorContainerVisitor.d.ts +15 -2
  71. package/types/src/reader/domVisitors/CommentVisitor.d.ts +24 -2
  72. package/types/src/reader/domVisitors/CommentsVisitor.d.ts +2 -2
  73. package/types/src/reader/domVisitors/DrawingCxnSpVisitor.d.ts +1 -0
  74. package/types/src/reader/domVisitors/DrawingElementVisitor.d.ts +34 -1
  75. package/types/src/reader/domVisitors/DrawingGraphicFrameVisitor.d.ts +9 -0
  76. package/types/src/reader/domVisitors/DrawingGrpSpVisitor.d.ts +14 -2
  77. package/types/src/reader/domVisitors/DrawingPicVisitor.d.ts +30 -2
  78. package/types/src/reader/domVisitors/DrawingSpVisitor.d.ts +20 -1
  79. package/types/src/reader/domVisitors/DrawingVisitor.d.ts +10 -0
  80. package/types/src/reader/domVisitors/ExternalLinkVisitor.d.ts +21 -3
  81. package/types/src/reader/domVisitors/FmtSchemeVisitor.d.ts +4 -4
  82. package/types/src/reader/domVisitors/FontSchemeVisitor.d.ts +3 -2
  83. package/types/src/reader/domVisitors/FormControlPrVisitor.d.ts +9 -0
  84. package/types/src/reader/domVisitors/ObjectDefaultsVisitor.d.ts +11 -0
  85. package/types/src/reader/domVisitors/ShapeTextVisitor.d.ts +44 -0
  86. package/types/src/reader/domVisitors/SheetColorContainerVisitor.d.ts +3 -3
  87. package/types/src/reader/domVisitors/SheetStyleVisitor.d.ts +21 -6
  88. package/types/src/reader/domVisitors/SlicerCacheDefinitionVisitor.d.ts +7 -2
  89. package/types/src/reader/domVisitors/SlicersVisitor.d.ts +7 -3
  90. package/types/src/reader/domVisitors/SortStateVisitor.d.ts +2 -2
  91. package/types/src/reader/domVisitors/TextPropertiesVisitor.d.ts +13 -1
  92. package/types/src/reader/domVisitors/ThreadedCommentVisitor.d.ts +18 -1
  93. package/types/src/reader/domVisitors/ThreadedCommentsVisitor.d.ts +2 -2
  94. package/types/src/reader/domVisitors/WorkbookVisitor.d.ts +11 -1
  95. package/types/src/reader/domVisitors/_Dxfs.d.ts +10 -0
  96. package/types/src/reader/domVisitors/index.d.ts +6 -32
  97. package/types/src/reader/sax/LeanSaxParser.d.ts +58 -0
  98. package/types/src/reader/sax/SaxParser.d.ts +11 -1
  99. package/types/src/reader/sax/SaxVisitor.d.ts +3 -2
  100. package/types/src/reader/saxVisitors/ContentTypesVisitor.d.ts +9 -0
  101. package/types/src/reader/saxVisitors/SharedStringsVisitor.d.ts +46 -6
  102. package/types/src/reader/saxVisitors/WorksheetVisitor.d.ts +23 -11
  103. package/types/src/utils/DrawingMLText.d.ts +39 -0
  104. package/types/src/utils/FormControls.d.ts +170 -0
  105. package/types/src/utils/SharedNames.d.ts +13 -0
  106. package/types/src/utils/SpreadsheetFont.d.ts +38 -0
  107. package/types/src/utils/VmlNoteShapes.d.ts +128 -0
  108. package/types/src/utils/VmlNoteStyle.d.ts +44 -0
  109. package/types/src/utils/VmlPrefixes.d.ts +24 -0
  110. package/types/src/vba/VBAProject.d.ts +52 -4
  111. package/types/src/writer/builder/ContentTypes.d.ts +13 -0
  112. package/types/src/writer/builder/Emitter.d.ts +11 -6
  113. package/types/src/writer/builder/OpcXmlUtils.d.ts +2 -0
  114. package/types/src/writer/builder/PackageBuilder.d.ts +74 -22
  115. package/types/src/writer/builder/PartWriter.d.ts +5 -0
  116. package/types/src/writer/builder/RelationshipSet.d.ts +3 -0
  117. package/types/src/writer/builder/Types.d.ts +124 -38
  118. package/types/src/writer/builder/_Types.d.ts +17 -0
  119. package/types/src/writer/emitters/CommentsEmitter.d.ts +58 -0
  120. package/types/src/writer/emitters/DrawingEmitter.d.ts +2 -2
  121. package/types/src/writer/emitters/EmbeddedPartEmitter.d.ts +60 -0
  122. package/types/src/writer/emitters/ExternalLinkEmitter.d.ts +19 -0
  123. package/types/src/writer/emitters/LegacyDrawingEmitter.d.ts +18 -0
  124. package/types/src/writer/emitters/PersonsEmitter.d.ts +17 -0
  125. package/types/src/writer/emitters/PivotTableEmitter.d.ts +45 -0
  126. package/types/src/writer/emitters/PropsCoreEmitter.d.ts +7 -2
  127. package/types/src/writer/emitters/PropsCustomEmitter.d.ts +15 -0
  128. package/types/src/writer/emitters/SharedStringsEmitter.d.ts +6 -3
  129. package/types/src/writer/emitters/SlicerEmitter.d.ts +66 -0
  130. package/types/src/writer/emitters/StylesEmitter.d.ts +2 -2
  131. package/types/src/writer/emitters/TableEmitter.d.ts +14 -0
  132. package/types/src/writer/emitters/ThreadedCommentsEmitter.d.ts +27 -0
  133. package/types/src/writer/emitters/WorkbookEmitter.d.ts +21 -3
  134. package/types/src/writer/emitters/WorksheetEmitter.d.ts +4 -3
  135. package/types/src/writer/utils/AutoFilter.d.ts +3 -3
  136. package/types/src/writer/utils/CustGeomUtils.d.ts +5 -0
  137. package/types/src/writer/utils/DefaultRows.d.ts +38 -0
  138. package/types/src/writer/utils/DrawMLUtils.d.ts +57 -3
  139. package/types/src/writer/utils/DummyFunction.d.ts +0 -2
  140. package/types/src/writer/utils/DxfCollector.d.ts +14 -11
  141. package/types/src/writer/utils/HiddenFormulaXfs.d.ts +28 -0
  142. package/types/src/writer/utils/PrstGeomUtils.d.ts +6 -0
  143. package/types/src/writer/utils/SheetStyleLayout.d.ts +73 -0
  144. package/types/src/writer/utils/TextUtils.d.ts +26 -2
  145. package/types/src/writer/utils/UnsupportedFunctions.d.ts +2 -2
  146. package/browser/cjs/B6sirGz6w-Bm7Ofo.cjs +0 -1
  147. package/browser/cjs/B7_pDFYCVzt-3hUs.cjs +0 -1
  148. package/browser/cjs/BAtEL-5TLyoaPFDP.cjs +0 -2
  149. package/browser/cjs/Bg0e53JZa8vhmm5a.cjs +0 -1
  150. package/browser/cjs/CIpMN7SDVREKQUQE.cjs +0 -6
  151. package/browser/cjs/CK5FFUvet6FnIYO_.cjs +0 -5
  152. package/browser/cjs/D5Y4KQhKdukOkjvA.cjs +0 -2
  153. package/browser/cjs/DV6LeTEiiFUrZoxj.cjs +0 -1
  154. package/browser/cjs/DWkuoJSgvcXJTdN1.cjs +0 -1
  155. package/browser/cjs/Db8YjGM6TG34c8aT.cjs +0 -1
  156. package/browser/cjs/index.cjs +0 -1
  157. package/browser/cjs/xQ6-wbTw5UzZUM1Y.cjs +0 -1
  158. package/browser/esm/4BWLu134ABlCQEtM.mjs +0 -3655
  159. package/browser/esm/BzQ_lPzc8C4OTIGZ.mjs +0 -99
  160. package/browser/esm/CJknI8BYGSZr-4zS.mjs +0 -52
  161. package/browser/esm/Cok_fBIUCHDSrKw0.mjs +0 -2211
  162. package/browser/esm/D-m_kQLaewdwuXaF.mjs +0 -2685
  163. package/browser/esm/Dj7D2nVdAZ3TiUks.mjs +0 -4743
  164. package/browser/esm/ijQzHH-bvDfUHIi1.mjs +0 -24
  165. package/node/esm/CF1R5ovFsRNu--Rw.mjs +0 -3744
  166. package/node/esm/Ctcl4jN52INWpKWC.mjs +0 -2255
  167. package/node/esm/CvnRSooxEQdlJgMn.mjs +0 -2766
  168. package/node/esm/DQd0vxzTaPt2qSL-.mjs +0 -108
  169. package/node/esm/ssSlRCbCqxvZ9IX8.mjs +0 -2481
  170. package/types/src/legacyChart/OOXMLMappings.d.ts +0 -8
  171. package/types/src/legacyChart/OOXMLUtils.d.ts +0 -78
  172. package/types/src/legacyChart/ToOOXMLConverter.d.ts +0 -30
  173. package/types/src/reader/domVisitors/AxisVisitor.d.ts +0 -12
  174. package/types/src/reader/domVisitors/BarChartTypeVisitor.d.ts +0 -6
  175. package/types/src/reader/domVisitors/ChartSpaceVisitor.d.ts +0 -6
  176. package/types/src/reader/domVisitors/ChartTypeVisitor.d.ts +0 -7
  177. package/types/src/reader/domVisitors/ChartVisitor.d.ts +0 -7
  178. package/types/src/reader/domVisitors/DataLabelsVisitor.d.ts +0 -8
  179. package/types/src/reader/domVisitors/DataPointVisitor.d.ts +0 -6
  180. package/types/src/reader/domVisitors/HyperlinkVisitor.d.ts +0 -6
  181. package/types/src/reader/domVisitors/LayoutVisitor.d.ts +0 -5
  182. package/types/src/reader/domVisitors/LegendEntryVisitor.d.ts +0 -5
  183. package/types/src/reader/domVisitors/LegendVisitor.d.ts +0 -5
  184. package/types/src/reader/domVisitors/MarkerVisitor.d.ts +0 -5
  185. package/types/src/reader/domVisitors/NegativeShapeVisitor.d.ts +0 -6
  186. package/types/src/reader/domVisitors/PlotAreaVisitor.d.ts +0 -5
  187. package/types/src/reader/domVisitors/SeriesVisitor.d.ts +0 -8
  188. package/types/src/reader/domVisitors/TitleVisitor.d.ts +0 -9
  189. package/types/src/writer/emitters/ChartColorsEmitter.d.ts +0 -7
  190. package/types/src/writer/emitters/ChartEmitter.d.ts +0 -14
  191. package/types/src/writer/emitters/ChartStyleEmitter.d.ts +0 -46
@@ -1,4 +1,4 @@
1
- import { IStyle } from '@sheetxl/sdk';
1
+ import { ICellStyle } from '@sheetxl/sdk';
2
2
  import { TransformerOptions } from './Types';
3
3
  import { Visitor } from './Visitor';
4
4
  import { ExecutionContext } from './ExecutionContext';
@@ -22,7 +22,7 @@ export declare class DOMTransformer {
22
22
  * the `dxfs` table, so it arrives from the streaming reader with no index to look up. The
23
23
  * `processingDXFs` flag matters: a dxf's solid pattern fill has its colors inverted.
24
24
  */
25
- parseDxf(elem: Element, location?: string): IStyle.JSON;
25
+ parseDxf(elem: Element, location?: string, options?: TransformerOptions): ICellStyle.JSON;
26
26
  getVisitorParamsState(): Map<string, any>;
27
27
  transform(xmlRootDoc: Document, location: string, options?: TransformerOptions): any;
28
28
  protected _walkScoped(elemName: string, context: ExecutionContext, visited: VisitedRecord[], elemParent: Element, jsonParent: any, location: string, options: TransformerOptions): void;
@@ -1,4 +1,5 @@
1
- import { IComment } from '@sheetxl/sdk';
1
+ import { IPerson, IEmbeddedPart } from '@sheetxl/sdk';
2
+ import { WarningOptions } from '../Warning';
2
3
  import { RelationShipType, TransformerOptions } from './Types';
3
4
  export interface VisitorParamsContainer {
4
5
  getVisitorParamsState(): Map<string, any>;
@@ -22,18 +23,30 @@ export declare class ExecutionContext {
22
23
  private _onWarning?;
23
24
  private _addPerson?;
24
25
  private _serializeElement?;
26
+ private _readEmbeddedPart?;
25
27
  constructor(parent: ExecutionContext | null, sharedState: VisitorParamsContainer, currentPath: string, elemRoot: Element, jsonRoot: any, fileLocation?: string | null, options?: TransformerOptions);
26
28
  getRef(relId: string, asResource?: boolean): any;
29
+ /**
30
+ * The part this relationship names, and every part that part references, as one carried subtree.
31
+ *
32
+ * @remarks
33
+ * Not a flavor of {@link ExecutionContext.getRef}: that one interprets a relationship into
34
+ * whatever the reader models its target as, this one carries the target away unread so a writer
35
+ * can put it back. See {@link TransformerOptions.readEmbeddedPart}.
36
+ */
37
+ readEmbeddedPart(relId: string): IEmbeddedPart.JSON | null;
27
38
  getRelationships(): Map<string, RelationShipType>;
28
39
  getPath(): string;
29
40
  /** The OPC path of the file currently being read (e.g. "xl/drawings/drawing1.xml"). */
30
41
  getFileLocation(): string;
31
42
  getElemRoot(): Element;
32
43
  getJsonRoot(): any;
33
- warn(message: string): void;
44
+ warn(message: string, options?: WarningOptions): void;
45
+ /** Carries the originating part's path up to whichever context holds the sink. */
46
+ private _raiseWarning;
34
47
  /** Serializes a parsed DOM element back to an XML string, verbatim. Returns null if unavailable. */
35
48
  serializeElement(elem: Element): string | null;
36
- addPerson(person: string | Partial<IComment.PersonJSON>): IComment.PersonJSON | null;
49
+ addPerson(person: string | Partial<IPerson.JSON>): IPerson.JSON | null;
37
50
  getVisitorParamsState<T = any>(): Map<string, T>;
38
51
  /**
39
52
  * Evaluates a path expression against an XML element and returns matching elements.
@@ -1,4 +1,5 @@
1
- import { IComment } from '@sheetxl/sdk';
1
+ import { IPerson, IEmbeddedPart } from '@sheetxl/sdk';
2
+ import { OnWarning } from '../Warning';
2
3
  export interface RelationShipType {
3
4
  target?: string;
4
5
  type?: string;
@@ -19,9 +20,24 @@ export interface TransformerOptions {
19
20
  };
20
21
  getRefs?: (refLocation: string, parsedRefs?: Map<string, Map<string, RelationShipType>>) => Map<string, RelationShipType>;
21
22
  parsedRefs?: Map<string, any>;
22
- onWarning?: (message: string) => void;
23
- addPerson?: (person: Partial<IComment.PersonJSON>) => IComment.PersonJSON;
23
+ /** Where the warnings this transform raises are reported. See {@link OnWarning}. */
24
+ onWarning?: OnWarning;
25
+ addPerson?: (person: Partial<IPerson.JSON>) => IPerson.JSON;
24
26
  /** Serializes a parsed DOM element back to an XML string, verbatim. Used to capture unmodeled content. */
25
27
  serializeElement?: (elem: Element) => string;
28
+ /**
29
+ * Resolves a relationship to the part it names and, recursively, the parts that part references,
30
+ * as content to be carried on the model and written back unchanged.
31
+ *
32
+ * @remarks
33
+ * The other half of {@link TransformerOptions.getRef}, not a variant of it. `getRef` *interprets*:
34
+ * it dispatches on the relationship type and hands back a sheet, an external book, a resource id
35
+ * — whatever the reader models that part as. This hands back the part itself: its markup as text,
36
+ * its bytes as a resource, and the same again for everything it references, none of it read. Use
37
+ * `getRef` for a part the model understands and this for one it only has to keep.
38
+ *
39
+ * See `readEmbeddedPart` in `XLSXReader` for what it costs and why it is not a visitor's job.
40
+ */
41
+ readEmbeddedPart?: (relId: string, refLocation: string) => IEmbeddedPart.JSON | null;
26
42
  }
27
43
  //# sourceMappingURL=Types.d.ts.map
@@ -3,8 +3,20 @@ interface CoreProperty {
3
3
  key: string;
4
4
  value: string;
5
5
  }
6
+ /** A `docProps/custom.xml` `<property>`: its name, the local name of its `vt:` value, and the value's text. */
7
+ export interface CustomPropertyEntry {
8
+ key: string;
9
+ kind: string | null;
10
+ value: string;
11
+ linkTarget?: string;
12
+ }
13
+ /**
14
+ * `<Properties>` is the root of both `docProps/app.xml` and `docProps/custom.xml`. The custom part's
15
+ * children are `<property>`, which the app part never has.
16
+ */
6
17
  export declare class AppPropertiesVisitor implements Visitor {
7
- visit(context: ExecutionContext, elemParent: Element, jsonParent: any): CoreProperty[];
18
+ visit(context: ExecutionContext, elemParent: Element, jsonParent: any): CoreProperty[] | CustomPropertyEntry[];
19
+ visitCustom(elemParent: Element, jsonParent: any): CustomPropertyEntry[];
8
20
  processProperty(context: ExecutionContext, elem: Element): CoreProperty | undefined;
9
21
  }
10
22
  export {};
@@ -1,23 +1,36 @@
1
- import { ICondition, IFilter, Scalar, ITable } from '@sheetxl/sdk';
1
+ import { ICondition, Scalar, ITable } from '@sheetxl/sdk';
2
2
  import { Visitor, ExecutionContext } from '../dom';
3
3
  /**
4
4
  * Auto Filter Visitor assumes that we are always nested within a Table.
5
5
  *
6
6
  * @remarks
7
7
  * We have 2 implementations 1 in dom and 1 in sax. The sax parser is used for AutoTables within
8
- * the SheetView.
8
+ * the WorksheetView.
9
9
  */
10
10
  export declare class AutoFilterVisitor implements Visitor {
11
- visit(context: ExecutionContext, elem: Element, jsonTable: ITable.JSON): IFilter.JSON | undefined;
11
+ visit(context: ExecutionContext, elem: Element, jsonTable: ITable.JSON): ITable.JSON | undefined;
12
12
  processColorFilter(context: ExecutionContext, elem: Element): ICondition.JSON;
13
13
  processCustomFilter(context: ExecutionContext, elem: Element): ICondition.JSON | null;
14
14
  processCustomFilters(context: ExecutionContext, elem: Element): ICondition.JSON;
15
+ /**
16
+ * `dynamicFilter` is Excel's Average (`aboveAverage` / `belowAverage`) or a TimePeriod.
17
+ *
18
+ * @remarks
19
+ * `val` and `maxVal` are Excel's cache of the last evaluation (the average; a period's start
20
+ * and exclusive end), not an anchor and not a deviation count. Excel honors `type` alone and
21
+ * rewrites them on save (`probe-filter-dynamic`), so they are dropped here.
22
+ */
15
23
  processDynamicFilter(context: ExecutionContext, elem: Element): ICondition.JSON;
16
24
  processDateGroupItem(context: ExecutionContext, elem: Element): ICondition.DateGroupItem;
17
25
  processFilterItem(context: ExecutionContext, elem: Element): Scalar | undefined;
18
26
  processFilters(context: ExecutionContext, elem: Element): ICondition.JSON;
19
27
  processIcon(context: ExecutionContext, elem: Element): ICondition.JSON;
20
28
  processTop10(context: ExecutionContext, elem: Element): ICondition.JSON;
29
+ /**
30
+ * A date group applied through VBA/COM is written only as `xlrd2:filterColumn` inside the
31
+ * column's own extLst, with nothing in the main namespace.
32
+ */
33
+ processFilterColumnExt(context: ExecutionContext, extLst: Element): ICondition.JSON | undefined;
21
34
  processFilterCriteria(context: ExecutionContext, elem: Element): ICondition.JSON | undefined;
22
35
  processFilterColumn(context: ExecutionContext, elem: Element, jsonTable: ITable.JSON): ICondition.JSON | null | undefined;
23
36
  processFilterColumns(context: ExecutionContext, elem: Element, conditions: ICondition.JSON[], jsonTable: ITable.JSON): ICondition.JSON[] | undefined;
@@ -1,3 +1,4 @@
1
+ import { Rectangle } from '@sheetxl/utils';
1
2
  import { IFill, IEffect } from '@sheetxl/sdk';
2
3
  import { Visitor, ExecutionContext } from '../dom';
3
4
  export declare class ColorContainerVisitor implements Visitor {
@@ -23,8 +24,20 @@ export declare class ColorContainerVisitor implements Visitor {
23
24
  processEffectElement(_context: ExecutionContext, elem: Element, name: string): IEffect.JSON | undefined;
24
25
  getFill(context: ExecutionContext, shPropsElement: Element): any;
25
26
  processGradFill(context: ExecutionContext, gradFillElement: Element): IFill.GradientJSON;
26
- getRect(fillToRectElement: Element): any;
27
- processImageFill(_context: ExecutionContext, imageFillElement: Element): IFill.ImageJSON;
27
+ /**
28
+ * A path gradient's focus from its `fillToRect`: the inner rectangle's edges as `0…1` positions
29
+ * across the shape, as a cell's gradient states them. DrawingML states the right and bottom edges
30
+ * as insets from the far side; SpreadsheetML (and the model) as positions from the near side.
31
+ * `null` for an element that states no edge.
32
+ */
33
+ getFocus(fillToRectElement: Element): Rectangle | null;
34
+ /**
35
+ * A `blipFill`: the image as a workbook resource (the blip's embed or link relationship), the
36
+ * part of it used, and whether it is stretched or tiled.
37
+ */
38
+ processImageFill(context: ExecutionContext, imageFillElement: Element): IFill.ImageJSON;
39
+ /** A relative rectangle's insets (`l`/`t`/`r`/`b`, thousandths of a percent) as percentages; `{}` when none. */
40
+ getRectInsets(elem: Element): IFill.RectInsets;
28
41
  processPatternFill(context: ExecutionContext, pattFill: Element): IFill.PatternJSON;
29
42
  processAdjColor(context: ExecutionContext, fillElement: Element): string | null;
30
43
  processScrgbClrElement(context: ExecutionContext, elem: Element): string;
@@ -1,6 +1,28 @@
1
- import { IRange, IComment } from '@sheetxl/sdk';
1
+ import { IRange, IComment, IFontStyle } from '@sheetxl/sdk';
2
2
  import { Visitor, ExecutionContext } from '../dom';
3
+ /**
4
+ * One `<comment>` of a legacy comments part, as read: its author as an index into the part's
5
+ * `<authors>`, and its rich text.
6
+ */
7
+ export interface LegacyNoteEntry {
8
+ authorId?: number;
9
+ content: IComment.Content;
10
+ }
11
+ /**
12
+ * `<comment ref authorId>` with its `<text>`: the runs are SpreadsheetML rich text — `<r>` with
13
+ * an `<rPr>` of child elements (`<b/>`, `<sz val>`, `<rFont val>`, `<color>`, ...) — read here
14
+ * rather than by the DrawingML text visitor, whose properties are attributes.
15
+ */
3
16
  export declare class CommentVisitor implements Visitor {
4
- visit(context: ExecutionContext, elem: Element, jsonParent: IRange.JSONReferenceEntry<IComment.RichJSON>[]): any;
17
+ visit(context: ExecutionContext, elem: Element, jsonParent: IRange.JSONReferenceEntry<LegacyNoteEntry>[]): any;
5
18
  }
19
+ /**
20
+ * The runs of a `<text>`, as a string when none carries formatting.
21
+ */
22
+ export declare function readRichText(textElement: Element | null): IComment.Content;
23
+ /**
24
+ * A run's `<rPr>` as the font properties it sets, or `null` when it sets none. Unlike a cell font
25
+ * record, a run is differential: what it leaves out is inherited, so nothing is defaulted.
26
+ */
27
+ export declare function readRunProperties(rPr: Element): IFontStyle.JSON | null;
6
28
  //# sourceMappingURL=CommentVisitor.d.ts.map
@@ -1,7 +1,7 @@
1
- import { IRange, IComment } from '@sheetxl/sdk';
1
+ import { IRange } from '@sheetxl/sdk';
2
2
  import { Visitor, ExecutionContext } from '../dom';
3
3
  export declare class CommentsVisitor implements Visitor {
4
- visit(context: ExecutionContext, elemParent: Element, jsonParent: any): IRange.JSONReferenceEntry<IComment.JSON>[] | undefined;
4
+ visit(context: ExecutionContext, elemParent: Element, jsonParent: any): IRange.JSONReferenceEntry<any>[] | undefined;
5
5
  processAuthors(context: ExecutionContext, elem: Element, authors: string[]): void;
6
6
  }
7
7
  //# sourceMappingURL=CommentsVisitor.d.ts.map
@@ -1,6 +1,7 @@
1
1
  import { IMovable } from '@sheetxl/sdk';
2
2
  import { Visitor, ExecutionContext } from '../dom';
3
3
  import { DrawingSpVisitor } from './DrawingSpVisitor';
4
+ /** A `cxnSp`: a connector, read as a shape whose `type` is `connector`. */
4
5
  export declare class DrawingCxnSpVisitor extends DrawingSpVisitor implements Visitor {
5
6
  visit(context: ExecutionContext, elem: Element, json: IMovable.JSON): any;
6
7
  }
@@ -1,6 +1,39 @@
1
- import { IMovable } from '@sheetxl/sdk';
1
+ import { IGroup, IMovable, IShape, ITheme } from '@sheetxl/sdk';
2
2
  import { Visitor, ExecutionContext } from '../dom';
3
+ /** Every reference a `style` element states, defaults included. */
4
+ export declare const readStyleRefsElement: (context: ExecutionContext, elemStyle: Element) => ITheme.StyleRefsJSON;
3
5
  export declare class DrawingElementVisitor implements Visitor {
4
6
  visit(context: ExecutionContext, elem: Element, json: IMovable.JSON): IMovable.JSON | undefined;
7
+ /** A `cNvPr`'s title and hyperlinks onto the JSON that will hold the content's identity. */
8
+ protected readNonVisualDetails(context: ExecutionContext, elemCNvPr: Element, target: IShape.JSON): void;
9
+ /**
10
+ * Sets the content of a movable, and gives it the name and description read from its `cNvPr`.
11
+ */
12
+ protected setContent(json: IMovable.JSON, content: IMovable.ContentJSON<any>): void;
13
+ /** Whether the JSON a drawing element is read into is a group's content, i.e. the element is a member. */
14
+ protected isGroupContent(json: unknown): json is IGroup.JSON & {
15
+ members: IMovable.JSON[];
16
+ };
17
+ /**
18
+ * A group member: an ordinary movable JSON whose content is of `type`, named and hidden as its
19
+ * `cNvPr` says. The walker fills the content in (`spPr`, `txBody`) as it descends; where the
20
+ * member sits is hoisted from the content onto the movable once the drawing is read
21
+ * (`DrawingVisitor.afterVisit`).
22
+ */
23
+ protected readMemberHeader(context: ExecutionContext, elem: Element, type: string): {
24
+ movable: IMovable.JSON;
25
+ content: any;
26
+ };
27
+ /**
28
+ * A shape's `style` element — its references into the theme's format scheme — onto the content
29
+ * JSON. Excel's own shapes state their fill and line this way and nothing in `spPr`. A reference
30
+ * equal to Excel's default for the kind of shape is left out; `content.type` must already say
31
+ * what kind it is.
32
+ */
33
+ protected readStyleRefs(context: ExecutionContext, elem: Element, content: IShape.JSON): void;
34
+ /** A locks element's flags (`spLocks`, `cxnSpLocks`, `grpSpLocks`, `picLocks`) by the file's own names. */
35
+ protected readLocks(elemLocks: Element | null): Record<string, boolean> | undefined;
36
+ /** The element's original `cNvPr` id, kept so a replayed fragment's id can be made unique on write. */
37
+ protected readSourceId(context: ExecutionContext, elem: Element): number | undefined;
5
38
  }
6
39
  //# sourceMappingURL=DrawingElementVisitor.d.ts.map
@@ -1,7 +1,16 @@
1
1
  import { IMovable } from '@sheetxl/sdk';
2
2
  import { Visitor, ExecutionContext } from '../dom';
3
3
  import { DrawingElementVisitor } from './DrawingElementVisitor';
4
+ /**
5
+ * A `graphicFrame`: a chart (its part read into its model), a slicer, or another graphic,
6
+ * placed by a movable or a member of a group.
7
+ */
4
8
  export declare class DrawingGraphicFrameVisitor extends DrawingElementVisitor implements Visitor {
5
9
  visit(context: ExecutionContext, elem: Element, json: IMovable.JSON): any;
10
+ /**
11
+ * The content a frame's `graphic/graphicData` names: a chart as its model and part,
12
+ * a slicer or anything else by its relationship.
13
+ */
14
+ protected readGraphic(context: ExecutionContext, elem: Element): IMovable.ContentJSON<any>;
6
15
  }
7
16
  //# sourceMappingURL=DrawingGraphicFrameVisitor.d.ts.map
@@ -1,7 +1,19 @@
1
1
  import { IMovable } from '@sheetxl/sdk';
2
2
  import { Visitor, ExecutionContext } from '../dom';
3
- import { DrawingSpVisitor } from './DrawingSpVisitor';
4
- export declare class DrawingGrpSpVisitor extends DrawingSpVisitor implements Visitor {
3
+ import { DrawingElementVisitor } from './DrawingElementVisitor';
4
+ /**
5
+ * A `grpSp`: a group, read as a movable whose content is of type `group` with its members in
6
+ * `members`, each an ordinary movable JSON.
7
+ *
8
+ * @remarks
9
+ * The group's `grpSpPr/xfrm` is its frame (`off`/`ext`) and the space its members' frames are
10
+ * stated in (`chOff`/`chExt`), both in pixels. A top-level group's frame is its anchor's; a
11
+ * nested group's is its own anchor in the enclosing group's child space. Rotation and flips are
12
+ * the movable's. Members are read by the walker as it descends — each `sp`/`cxnSp`/`grpSp`/`pic`/
13
+ * `graphicFrame` under the group adds itself to `members` in document order, which is z-order.
14
+ */
15
+ export declare class DrawingGrpSpVisitor extends DrawingElementVisitor implements Visitor {
16
+ private readonly _fills;
5
17
  visit(context: ExecutionContext, elem: Element, json: IMovable.JSON): any;
6
18
  }
7
19
  //# sourceMappingURL=DrawingGrpSpVisitor.d.ts.map
@@ -1,7 +1,35 @@
1
- import { IMovable } from '@sheetxl/sdk';
1
+ import { IMovable, IPicture } from '@sheetxl/sdk';
2
2
  import { Visitor, ExecutionContext } from '../dom';
3
3
  import { DrawingElementVisitor } from './DrawingElementVisitor';
4
+ /**
5
+ * A `pic`: the picture content of a movable, or of a member of a group.
6
+ *
7
+ * @remarks
8
+ * What the element itself states — its image and how it fills the frame, its non-visual
9
+ * properties and locks — is read here onto the picture's JSON; its frame properties (the shape
10
+ * it is cropped to, a fill behind the image, a border, effects) are read into the same JSON by
11
+ * the `spPr` visitor the walker runs over its children, and what that reads of placement is
12
+ * hoisted onto the movable afterwards. A member of a group is read the same way, as a movable of
13
+ * the group's `members`.
14
+ */
4
15
  export declare class DrawingPicVisitor extends DrawingElementVisitor implements Visitor {
5
- visit(context: ExecutionContext, elem: Element, jsonHandle: IMovable.JSON): IMovable.JSON | undefined;
16
+ visit(context: ExecutionContext, elem: Element, jsonHandle: IMovable.JSON): any;
17
+ /**
18
+ * The image (`blipFill`), the macro and publish flag, the resize preference and the locks onto
19
+ * the content; the aspect lock onto the movable too, as a shape's is.
20
+ */
21
+ protected readPictureDetails(context: ExecutionContext, elem: Element, image: PictureImage | undefined, movable: IMovable.JSON, content: IPicture.JSON): void;
22
+ /**
23
+ * The picture's image and how it fills the frame: the `blipFill` read as an image fill is.
24
+ * `undefined` when the element has no `blip`, `null` when the blip names no relationship
25
+ * (warned once). The whole image stretched over the whole frame is the default and is left out.
26
+ */
27
+ protected readImage(context: ExecutionContext, elem: Element): PictureImage | null | undefined;
6
28
  }
29
+ /** What a `blipFill` gives a picture: its image as a resource, and how it fills the frame. */
30
+ interface PictureImage {
31
+ resId: number | undefined;
32
+ image: IPicture.ImageJSON | undefined;
33
+ }
34
+ export {};
7
35
  //# sourceMappingURL=DrawingPicVisitor.d.ts.map
@@ -1,7 +1,26 @@
1
- import { IMovable } from '@sheetxl/sdk';
1
+ import { IMovable, IShape } from '@sheetxl/sdk';
2
2
  import { Visitor, ExecutionContext } from '../dom';
3
3
  import { DrawingElementVisitor } from './DrawingElementVisitor';
4
+ /**
5
+ * An `sp`: the shape content of a movable, or of a member of a group.
6
+ *
7
+ * @remarks
8
+ * What the element itself states — its kind, attributes, non-visual properties, style references
9
+ * — is read here; its properties and text are read into the same content JSON by the `spPr` and
10
+ * `txBody` visitors the walker runs over its children. A member of a group is read the same way,
11
+ * as a movable of the group's `members`.
12
+ */
4
13
  export declare class DrawingSpVisitor extends DrawingElementVisitor implements Visitor {
5
14
  visit(context: ExecutionContext, elem: Element, json: IMovable.JSON): any;
15
+ protected visitShape(context: ExecutionContext, elem: Element, json: IMovable.JSON, type: 'sp' | 'cxnSp', locksPath: string): any;
16
+ /**
17
+ * The VML shape a form control's hidden twin names, by its `spid` (`_x0000_s1025` is 1025).
18
+ */
19
+ protected readTwinOf(context: ExecutionContext, elem: Element): number | undefined;
20
+ /**
21
+ * What the element itself and its non-visual properties say beyond the name: the macro and
22
+ * text link, the text-box flag, the edit locks by name, and a connector's glued ends.
23
+ */
24
+ protected readShapeDetails(context: ExecutionContext, elem: Element, type: 'sp' | 'cxnSp', locksPath: string, content: IShape.JSON): void;
6
25
  }
7
26
  //# sourceMappingURL=DrawingSpVisitor.d.ts.map
@@ -1,5 +1,15 @@
1
+ import { IMovable } from '@sheetxl/sdk';
1
2
  import { Visitor, ExecutionContext } from '../dom';
2
3
  export declare class DrawingVisitor implements Visitor {
3
4
  visit(context: ExecutionContext, elemParent: Element, jsonParent: any): any;
5
+ /**
6
+ * What the `spPr` visitor reads onto a content — `xfrm/@rot`, the flips and, for a group
7
+ * member, the frame — is the movable's: a top-level shape's rotation and flips move to its
8
+ * movable, and a member's frame becomes its anchor in the group's child space. Nested groups
9
+ * are walked the same way.
10
+ */
11
+ afterVisit(_context: ExecutionContext, _elemParent: Element, jsonDrawing: {
12
+ movables?: Partial<IMovable.JSON>[];
13
+ }): void;
4
14
  }
5
15
  //# sourceMappingURL=DrawingVisitor.d.ts.map
@@ -9,12 +9,12 @@ import { Visitor, ExecutionContext } from '../dom';
9
9
  * for the other two `jsonParent` is left untouched (empty), which the reader normalizes to `null`
10
10
  * — DDE/OLE are never modeled, and package passthrough covers their bytes separately.
11
11
  *
12
- * The book's identity — the ordered `(relTypeUri, target)` list from the part's OWN `.rels` file —
12
+ * The book's sources — the ordered `(relTypeUri, target)` list from the part's OWN `.rels` file —
13
13
  * is deliberately not read here: a visitor only ever sees its own part's XML, never a sibling rels
14
- * file. `XLSXReader` attaches `identity` after this visitor returns.
14
+ * file. `XLSXReader` attaches `sources` after this visitor returns.
15
15
  */
16
16
  export declare class ExternalLinkVisitor implements Visitor {
17
- visit(context: ExecutionContext, elem: Element, jsonParent: Partial<IExternalBook.JSON>): Partial<IExternalBook.JSON>;
17
+ visit(context: ExecutionContext, elem: Element, jsonParent: Partial<IExternalBook.JSON> & ExternalLinkVisitor.RelIds): Partial<IExternalBook.JSON>;
18
18
  processSheetNames(context: ExecutionContext, elemBook: Element, jsonBook: IExternalBook.JSON): void;
19
19
  processDefinedNames(context: ExecutionContext, elemBook: Element, jsonBook: IExternalBook.JSON): void;
20
20
  processSheetDataSet(context: ExecutionContext, elemBook: Element, jsonBook: IExternalBook.JSON): void;
@@ -28,5 +28,23 @@ export declare class ExternalLinkVisitor implements Visitor {
28
28
  */
29
29
  private _readCellValue;
30
30
  private _findChild;
31
+ /** `<xxl21:alternateUrls><xxl21:absoluteUrl r:id="rIdN"/></xxl21:alternateUrls>` — design doc §2.2. */
32
+ private _findAbsoluteUrlRelId;
33
+ }
34
+ export declare namespace ExternalLinkVisitor {
35
+ /**
36
+ * The `r:id`s the part's XML points at, handed to `XLSXReader` so it can say which of the part's
37
+ * relationships is the book's own path and which is the 2021 `absoluteUrl` companion — then
38
+ * stripped. **Not part of {@link IExternalBook.JSON}**: an rId is a name inside one package, and
39
+ * a saved book gets fresh ones.
40
+ *
41
+ * @remarks
42
+ * The relationship type cannot answer this on its own — both can be `externalLinkPath` (measured
43
+ * on task 40234).
44
+ */
45
+ interface RelIds {
46
+ __bookRelId?: string;
47
+ __absoluteUrlRelId?: string;
48
+ }
31
49
  }
32
50
  //# sourceMappingURL=ExternalLinkVisitor.d.ts.map
@@ -7,10 +7,10 @@ import { ColorContainerVisitor } from './ColorContainerVisitor';
7
7
  * idx-referencing shape/chart styles (`<a:lnRef idx="N">`, `<a:fillRef>`, `<a:effectRef>`) keep
8
8
  * resolving against the same source definitions on save — see DESIGN-PACKAGE-PASSTHROUGH.md §11.2.
9
9
  *
10
- * If anything in the fragment isn't fully modeled (an effect outside the "common" set — see
11
- * `IEffect` — or a `scene3d`/`sp3d` on an effect style), falls back to capturing the whole
12
- * `<a:fmtScheme>` verbatim (`ITheme.JSON.formatSchemeXml`), exactly as before this was modeled —
13
- * `ThemeEmitter` replays that raw fragment instead of synthesizing from the typed fields.
10
+ * Each list that is fully modeled is kept, so the theme draws with the file's own fills and
11
+ * lines. If any list isn't (an effect outside the "common" set — see `IEffect` — or a
12
+ * `scene3d`/`sp3d` on an effect style), the whole `<a:fmtScheme>` is also captured verbatim
13
+ * (`ITheme.JSON.formatSchemeXml`) and `ThemeEmitter` replays that instead of writing the lists.
14
14
  */
15
15
  export declare class FmtSchemeVisitor extends ColorContainerVisitor implements Visitor {
16
16
  visit(context: ExecutionContext, elemParent: Element, jsonParent: ITheme.JSON): void;
@@ -1,7 +1,8 @@
1
- import { ITheme, IStyledFont } from '@sheetxl/sdk';
1
+ import { ITheme } from '@sheetxl/sdk';
2
2
  import { Visitor, ExecutionContext } from '../dom';
3
3
  export declare class FontSchemeVisitor implements Visitor {
4
4
  visit(context: ExecutionContext, elemParent: Element, jsonParent: ITheme.JSON): ITheme.FontSchemeJSON;
5
- processFontElement(context: ExecutionContext, elem: Element, jsonFont: Partial<IStyledFont.Properties>): Partial<IStyledFont.Properties> | undefined;
5
+ /** A `majorFont`/`minorFont`: the latin, East Asian and complex-script fonts, then the fonts by script. */
6
+ processFontCollection(context: ExecutionContext, elem: Element): ITheme.FontCollectionJSON | undefined;
6
7
  }
7
8
  //# sourceMappingURL=FontSchemeVisitor.d.ts.map
@@ -0,0 +1,9 @@
1
+ import { Visitor, ExecutionContext } from '../dom';
2
+ /**
3
+ * A `ctrlProp` part (`<formControlPr>`): what kind of form control a `<control>` is and what it
4
+ * holds, read onto `formControl` as the content type and that kind's fields.
5
+ */
6
+ export declare class FormControlPrVisitor implements Visitor {
7
+ visit(context: ExecutionContext, elem: Element, jsonParent: any): any;
8
+ }
9
+ //# sourceMappingURL=FormControlPrVisitor.d.ts.map
@@ -0,0 +1,11 @@
1
+ import { IShape, ITheme } from '@sheetxl/sdk';
2
+ import { Visitor, ExecutionContext } from '../dom';
3
+ /**
4
+ * A theme's `objectDefaults`: each of `spDef`, `lnDef` and `txDef` read as the shape JSON it gives a
5
+ * new object, its style references in full.
6
+ */
7
+ export declare class ObjectDefaultsVisitor implements Visitor {
8
+ visit(context: ExecutionContext, elemParent: Element, jsonParent: ITheme.JSON): object;
9
+ processDefault(context: ExecutionContext, elemDef: Element): IShape.JSON;
10
+ }
11
+ //# sourceMappingURL=ObjectDefaultsVisitor.d.ts.map
@@ -0,0 +1,44 @@
1
+ import { IText, ITextFrame } from '@sheetxl/sdk';
2
+ import { ExecutionContext } from '../dom/ExecutionContext';
3
+ import { TextPropertiesVisitor } from './TextPropertiesVisitor';
4
+ /** The plain text of a paragraph: its runs concatenated, a line break as `\n`. */
5
+ export declare const paragraphText: (paragraph: IText.ParagraphJSON) => string;
6
+ /**
7
+ * The plain text of a text body: paragraphs joined by a newline, blank ones trimmed from the ends.
8
+ * The same rule `IShape.getTextFrame().getText()` applies, so the reader can decide what a body says.
9
+ */
10
+ export declare const textBodyText: (text: ITextFrame.JSON) => string;
11
+ /**
12
+ * DrawingML's defaults where SheetXL's differ ({@link ShapeStyleUtils.TEXT_DEFAULTS}): what a file
13
+ * that leaves these out means. The reader states them, so the shape keeps what the file meant.
14
+ */
15
+ export declare const DRAWINGML_TEXT_DEFAULTS: Readonly<{
16
+ readonly verticalOverflow: "visible";
17
+ readonly horizontalOverflow: "visible";
18
+ readonly size: 18;
19
+ }>;
20
+ /**
21
+ * A shape's `txBody`, read paragraph by paragraph into {@link ITextFrame.JSON}.
22
+ *
23
+ * @remarks
24
+ * Elements are matched by local name, so other producers' prefixes read the same as Excel's.
25
+ * A `br` is a run of `\n`; a field (`fld`) reads as its text; any other `t` — an equation's
26
+ * `m:t` included — reads as a run of its own. The run and paragraph formatting the chart text
27
+ * reader models (size, weight, color, font…) is read the same way onto each run and paragraph.
28
+ */
29
+ export declare class ShapeTextVisitor extends TextPropertiesVisitor {
30
+ visit(context: ExecutionContext, elem: Element, jsonParent: any): any;
31
+ /**
32
+ * Reads a `txBody`. With no context the text and layout are read but no run formatting,
33
+ * colors or list style.
34
+ */
35
+ readTextBody(context: ExecutionContext | null, body: Element): ITextFrame.JSON;
36
+ readParagraph(context: ExecutionContext | null, p: Element): IText.ParagraphJSON;
37
+ /** A `pPr`, `defPPr` or `lvlNpPr`: how a paragraph is laid out. Colors and the default run need a context. */
38
+ readParagraphProperties(context: ExecutionContext | null, pPr: Element): IText.ParagraphPropertiesJSON;
39
+ /** A `lstStyle`: the default and per-level paragraph properties, or nothing when it states none. */
40
+ readListStyle(context: ExecutionContext, lstStyle: Element): ITextFrame.ListStyleJSON | undefined;
41
+ }
42
+ /** A `bodyPr`'s attributes and autofit/warp children. Rotation is read separately. */
43
+ export declare const readBodyProperties: (bodyPr: Element) => ITextFrame.BodyJSON;
44
+ //# sourceMappingURL=ShapeTextVisitor.d.ts.map
@@ -1,4 +1,4 @@
1
- import { IFill, IBorder, IStyledFont } from '@sheetxl/sdk';
1
+ import { IFill, IBorders, IFontStyle } from '@sheetxl/sdk';
2
2
  import { Visitor, ExecutionContext } from '../dom';
3
3
  export declare class SheetColorContainerVisitor implements Visitor {
4
4
  visit(_context: ExecutionContext, _elemParent: Element, _jsonParent: any): any;
@@ -7,7 +7,7 @@ export declare class SheetColorContainerVisitor implements Visitor {
7
7
  */
8
8
  processDataBarColor(context: ExecutionContext, elemColor: Element, jsonParent: any, key: string, auto?: string): any;
9
9
  processFonts(context: ExecutionContext, elem: Element, jsonParent: any): any;
10
- processFont(context: ExecutionContext, elem: Element, jsonFont: IStyledFont.Properties<string>): any;
10
+ processFont(context: ExecutionContext, elem: Element, jsonFont: IFontStyle.Properties<string>): any;
11
11
  processFills(context: ExecutionContext, elem: Element, jsonParent: any): any;
12
12
  processFill(context: ExecutionContext, elem: Element, jsonParent: any, index: number): any;
13
13
  processGradientFill(context: ExecutionContext, elem: Element, jsonParent: IFill.GradientJSON): any;
@@ -23,6 +23,6 @@ export declare class SheetColorContainerVisitor implements Visitor {
23
23
  * border definitions. In both SheetXL and Excel these values are ignored.
24
24
  */
25
25
  processBorder(context: ExecutionContext, elem: Element, jsonParent: any, index: number, tile: boolean): any;
26
- processBorderStroke(context: ExecutionContext, elem: Element, jsonParent: IBorder.JSON, edge: IBorder.Edge): any;
26
+ processBorderStroke(context: ExecutionContext, elem: Element, jsonParent: IBorders.JSON, edge: IBorders.Edge): any;
27
27
  }
28
28
  //# sourceMappingURL=SheetColorContainerVisitor.d.ts.map
@@ -1,20 +1,35 @@
1
- import { IStyle, IStyleCollection } from '@sheetxl/sdk';
1
+ import { ICellStyle, IStyleCollection } from '@sheetxl/sdk';
2
2
  import { Visitor, ExecutionContext } from '../dom';
3
3
  import { SheetColorContainerVisitor } from './SheetColorContainerVisitor';
4
4
  export declare class SheetStyleVisitor extends SheetColorContainerVisitor implements Visitor {
5
5
  visit(context: ExecutionContext, elem: Element, jsonParent: IStyleCollection.JSON): any;
6
+ /** The font of the Normal style (`builtinId` 0): its named xf's `fontId`, 0 when not stated. */
7
+ normalFontId(context: ExecutionContext, elem: Element): number;
6
8
  processIndexColors(context: ExecutionContext, elem: Element, jsonParent: any): void;
7
9
  processMruColors(context: ExecutionContext, elem: Element, jsonParent: any): void;
8
10
  processNumFmts(context: ExecutionContext, elem: Element, _jsonParent: any[] | null): void;
9
- processXFs(context: ExecutionContext, elem: Element, jsonParent: IStyle.JSON[], denormalized: any, namedIds?: Map<number, string> | null, ignoreApplys?: boolean): any;
10
- processXF(context: ExecutionContext, elem: Element, jsonParent: IStyle.JSON, denormalized: any, namedIds: Map<number, string> | null, ignoreApplys: boolean): any;
11
+ processXFs(context: ExecutionContext, elem: Element, jsonParent: ICellStyle.JSON[], denormalized: any, namedIds?: Map<number, string> | null, ignoreApplys?: boolean): any;
12
+ processXF(context: ExecutionContext, elem: Element, jsonParent: ICellStyle.JSON, denormalized: any, namedIds: Map<number, string> | null, ignoreApplys: boolean): any;
11
13
  processAlignment(context: ExecutionContext, elem: Element, jsonParent: any): any;
14
+ /**
15
+ * The cell xfs whose `<protection>` says `hidden="1"`. They become the sheet's `showFormulas` once
16
+ * the sheets are read (`applyHiddenFormulas`), since a format alone cannot say it.
17
+ */
18
+ collectHiddenXfs(elem: Element): Set<number>;
12
19
  processProtection(context: ExecutionContext, elem: Element, jsonParent: any): any;
13
- processDXF(context: ExecutionContext, elem: Element, jsonParent: IStyle.JSON): any;
20
+ processDXF(context: ExecutionContext, elem: Element, jsonParent: ICellStyle.JSON): any;
14
21
  processDXFs(context: ExecutionContext, elem: Element, jsonParent: any[]): any;
15
- processTableStyle(_context: ExecutionContext, elem: Element, jsonParent: any, dxfs: any[], shiftTableDx?: boolean): any;
22
+ /**
23
+ * Reads the slicer styles from the styles part's `extLst`: `x14:slicerStyles` names each slicer
24
+ * style's eight item elements, as ids into `x14:dxfs` (a list of its own, apart from the main
25
+ * `dxfs`). A slicer style's frame and header are in the file as a hidden table style of the same
26
+ * name (`table="0" pivot="0"`); that table style is taken out of the table styles and joins the
27
+ * slicer style.
28
+ */
29
+ processSlicerStyles(context: ExecutionContext, elemExtLst: Element | null, jsonParent: any): void;
30
+ processTableStyle(context: ExecutionContext, elem: Element, jsonParent: any, dxfs: any[], shiftTableDx?: boolean): any;
16
31
  processTableStyles(context: ExecutionContext, elem: Element, jsonParent: any, dxfs: any[], shiftTableDx?: boolean): any;
17
- processCellStyles(context: ExecutionContext, elem: Element, named: IStyle.NamedJSON[], namedXfs: IStyle.JSON[], namedIds: Map<number, string>): any;
32
+ processCellStyles(context: ExecutionContext, elem: Element, named: ICellStyle.NamedJSON[], namedXfs: ICellStyle.JSON[], namedIds: Map<number, string>): any;
18
33
  afterVisit(_context: ExecutionContext, _elem: Element, _json: any): void;
19
34
  }
20
35
  //# sourceMappingURL=SheetStyleVisitor.d.ts.map
@@ -1,6 +1,11 @@
1
- import { ISlicer } from '@sheetxl/sdk';
1
+ import { SlicerRecord } from '../_SlicerRecord';
2
2
  import { Visitor, ExecutionContext } from '../dom';
3
+ /**
4
+ * A slicer cache part: its name and source name, and for a table slicer the `tableSlicerCache`
5
+ * ext that names the table and column by id. A cache with no such ext is a pivot or OLAP slicer's,
6
+ * which names no table and is left as the file has it.
7
+ */
3
8
  export declare class SlicerCacheDefinitionVisitor implements Visitor {
4
- visit(context: ExecutionContext, elem: Element, jsonSlicer: ISlicer.JSON): ISlicer.JSON;
9
+ visit(context: ExecutionContext, elem: Element, jsonSlicer: SlicerRecord): SlicerRecord;
5
10
  }
6
11
  //# sourceMappingURL=SlicerCacheDefinitionVisitor.d.ts.map