The v1 release introduced several API-breaking changes. See MIGRATING for migrating from v0.x.
Usage examples
import * as hb from "harfbuzzjs";// Load data from a font file:const response = await fetch("font.ttf");const arrayBuffer = await response.arrayBuffer();// Create a HarfBuzz font object from the data:const blob = new hb.Blob(arrayBuffer);const face = new hb.Face(blob);const font = new hb.Font(face);// Shape text in a HarfBuzz buffer with the font:const buffer = new hb.Buffer();buffer.addText
harfbuzzjs uses a stripped-down version of Harfbuzz generated by compiling Harfbuzz with -DHB_TINY. This may mean that some functions you need are not available. Look at src/harfbuzz-config.hh in the Harfbuzz source directory to see what has been removed. For example, HB_TINY defines HB_LEAN which (amongst other things) defines HB_NO_OT_GLYPH_NAMES. If, for example, you really need to get at the glyph names:
First, undefine the macro in question, by adding e.g. #undef HB_NO_OT_GLYPH_NAMES to config-override.h.
Next, export any function that you need by adding a line to harfbuzz.symbols; in this case _hb_ot_get_glyph_name.
Now the function will be exported through the WASM object, but you need to add TypeScript to bridge to it - in this case, handling the memory allocation of the char * parameter name and marshalling it to a JavaScript string. The best way to do this is to look at the source files in src/ for functions which use similar signatures.
If you have extended harfbuzzjs in ways that you think others will also benefit from, please raise a pull request. If there are parts of Harfbuzz that you need but the instructions above don't work, describe what you are trying to do in an issue.