@zzish/math-rich-input 0.1.57 → 0.1.59

package/README.md

@@ -36,6 +36,28 @@ export default class App extends Component {
 }
 ```
 
+### KaTeX stylesheet
+
+The field draws formulas with KaTeX and puts KaTeX's stylesheet on the page itself, as `<style id="katex-css">`,
+when the first field mounts (and, in the standalone build, when the element is defined). It is the stylesheet of
+`katex@0.11.1`, the one the field has always used, carried inside the package with its woff2 fonts inlined:
+nothing is fetched from a CDN, and nothing arrives late to resize a field that was already drawn.
+
+Up to 0.1.58 the same stylesheet was appended from `cdn.jsdelivr.net`. Hosts keep exactly the look they had.
+A host that wants its own KaTeX stylesheet instead puts it on the page under the id `katex-css` first; the field
+then adds nothing.
+
+`src/katexStylesheet.generated.js` is built from the pinned `katex-0.11.1` dev dependency by
+`scripts/build-katex-stylesheet.js`, which `npm run build` and `npm test` run first.
+
+### Custom element: drawn before the first paint
+
+`<math-rich-input>` (the standalone build) draws its first render synchronously, before the browser
+can paint, wherever it is connected from — inside a click, in a framework's microtask flush, or when
+the bundle arrives and upgrades fields already on the page. Until 0.1.58 a field connected outside a
+discrete event was drawn later, in React's scheduled slices: a host showed empty fields that filled
+one at a time.
+
 ### Normal usage
 
 ```js