@apertura/chart

Fills in what a shape leaves to the theme. What the shape states itself always wins: `p:style` is the default, and `p:spPr` is the override. A shape that turns its fill off states that too, and `filled: false` is respected rather than overwritten.

The colour inside a container such as `a:solidFill` or `a:fillRef`.

A fill as a CSS background. A gradient becomes a gradient, a pattern becomes a repeating one — CSS has no hatch, and a striped background at the right density and angle reads as the same texture — and a picture returns nothing, because the caller has to resolve the part before it can name a URL.

Reads whichever fill a shape's properties carry. The five are alternatives in the schema and the first one found wins, which is also what the schema says: a shape has one fill.

Reads `p:spPr`/`xdr:spPr`: what shape the shape is. `a:prstGeom` names one of the specification's shapes and adjusts it; `a:custGeom` writes the outline out. Both are read here, into one type, so that a slide and a worksheet describe an arrow the same way and the renderer that draws one draws the other.

The path a geometry describes, or nothing when it is one CSS handles. A zero-sized box has no path: a shape whose frame the file never stated would otherwise produce `M 0 0 Z`, which paints a dot at the corner of the slide.

Whether a preset is one this library can draw.

The three shapes CSS draws better than an SVG path would. A rectangle is a div, a rounded rectangle is a border-radius, and an ellipse is a fifty-per-cent one. Those three are 2 568 of the corpus's 4 311 shapes, and routing them through a path would trade working code for a redraw.

`a:ln`: the width, the dash pattern and the colour it is stroked with.

Parses a whole chart part.

Reads a theme part whole.

The preset's name, whichever of the two forms the look carries.

Reads the colour inside a container such as `a:solidFill`. Every colour model shares one shape: an element that names the colour, with the transforms applied to it as its children.

Reads `a:prstGeom` or `a:custGeom` from a stream. The DOM reader in `element.ts` answers the same question for the formats that parse a drawing into a tree first. A document does not: `word/document.xml` is read once, in order, and so the shape of a shape has to be taken as it goes past. The parser must be positioned on the geometry element itself; it is consumed whole.

Reads `a:ln`: width, dash pattern and the colour it is stroked with.

Renders a chart part into an element of the given frame size.

Turns a DrawingML colour into CSS. The transforms are applied in the order they were written, because they compose: SmartArt colour lists shift hue, saturation and luminance together to derive one node's colour from the previous one, and applying them in a fixed order of our own choosing produces a different palette.

A shadow as CSS. The file states a distance and a direction; CSS wants two offsets, so the angle is resolved into them. The blur radius is DrawingML's, which is twice what CSS calls one — a `blurRad` of 40 000 EMUs is a soft edge four pixels wide, not eight.

Reads `a:effectLst`: what the shape does beyond its own outline. Only the shadow, and only the first one: a shape may state a glow, a reflection and a soft edge as well, and of the corpus's 1 044 effect lists 784 hold a shadow while three hold a glow. The shadow is what shows.

The declarations that draw a shape. The geometry is honoured as far as CSS can take it: a rectangle is a rectangle, rounded corners are a radius, an ellipse is a radius of half. Everything else is drawn as its bounding rectangle — which the corpus says is a fair trade, since of the 2 862 shapes in it 2 827 are plain rectangles and 34 are rounded ones.

The shape's outline as an SVG, for the geometries CSS cannot draw. Returned rather than appended so that the caller decides where it goes; every viewer puts it behind the shape's text, which the browser lays out in the shape's own box. The path is painted with the shape's own fill and line. A path the file marks as unfilled — a brace, a connector, a freehand squiggle — is stroked only, whatever fill the shape carries, because filling it would blot the slide.

Reads `p:style`, `xdr:style` or `wps:style`: how the theme paints the shape. The element is in the format's own namespace but everything inside it is DrawingML, which is why one reader serves all three.

Builds a lookup from a theme part. The pairs are aliases: `tx1` is `dk1` and `bg1` is `lt1`, which is how a chart and a cell can name the same colour differently.

The colour of the theme entry a fill reference names.

The line of the theme entry a line reference names.

A chart part, reduced to what is drawn.

One `c:*Chart` inside the plot area.

One value of a series, with the point it belongs to.

What drawing a chart needs from the application around it. Two things and no more: a document to create elements in, and the theme's answer for a colour slot. Deliberately this narrow — the renderer used to take the Word view's whole render context, and that is the only reason it could not be used from a spreadsheet.

One series of a plot.

The text of one part of a chart, `c:txPr/a:pPr/a:defRPr`. A chart states its type sizes rather than inheriting them from the page: an axis whose labels are 9pt says so, and drawing them at the renderer's own default is a chart whose every label is the wrong size — which is what `long_legendentry` measures as 13.33px against Word's 12.

`a:custGeom`: one or more outlines, each in its own coordinate space.

One transform applied to a colour, `a:lumMod` and its siblings. Kept as a list rather than resolved fields because the transforms compose in document order, and SmartArt relies on that: a colour list shifts hue, saturation and luminance together to spread one accent colour across the nodes of a diagram.

What shape a shape is: a named preset with its adjustments, or an outline written out point by point. The two are alternatives in the file (`a:prstGeom` or `a:custGeom`) and are kept as alternatives here. The preset's name matters even when the renderer cannot draw it — a `rect` is a div and needs no path at all — so the name is carried rather than resolved at parse time.

`a:outerShdw`: the shadow a shape casts. Stated as a distance and a direction rather than as two offsets, because that is how a drawing application asks for one: "ten points, down and to the right". Seven hundred and eighty-four shapes of the corpus cast one, and a panel drawn without its shadow sits flat against the slide behind it.

The box a shape is drawn in, in pixels.

The look of a shape, as much of it as the format states. Every field is optional because the formats state different amounts: a spreadsheet shape carries text insets and a wrap flag, a slide shape carries neither, and both carry a geometry, a fill and an outline.

Where a shape's outline is drawn and how it is painted.

`p:style`: the four references a shape is painted by.

One `a:fillRef`/`a:lnRef`/`a:effectRef`/`a:fontRef`.

The whole theme, not just its colours. A shape rarely states how it is painted. It states a *reference* — "the second fill of the theme, in accent 1" — and the theme's `a:fmtScheme` holds the three fills, the three lines and the three effect sets that every shape in the deck is drawn from. Thirty per cent of the corpus's slides have shapes like that, and without the format scheme they are drawn with no fill at all, which is how a SmartArt diagram comes out as invisible text on white.

One entry of the theme's fill list. Every colour in it is `phClr` — the placeholder the referring shape fills in — carrying the transforms that make the entry what it is: the "moderate" fill is the shape's own colour tinted and lightened. Only the first colour is kept, because a gradient drawn as its first stop is much closer than a gradient drawn as nothing.

`c:grouping`, which decides whether values stack.

How the marks of one plot are laid out.

Where the legend goes, `c:legendPos`.

How a shape is filled, when a flat colour is not the answer. `a:solidFill` is one of five, and the other four were all drawn as nothing: a gradient panel, a hatched box, a shape filled with a photograph and a shape explicitly filled with nothing came out identical — unpainted.

How a chart finds out what a theme slot is worth.

An empty theme, for the documents that carry none.