@girs/harfbuzz-0.0 7.1.0-3.2.2 → 8.1.1-3.2.8

package/README.md

@@ -5,7 +5,7 @@
 ![downloads/week](https://img.shields.io/npm/dw/@girs/harfbuzz-0.0)
 
 
-GJS TypeScript type definitions for HarfBuzz-0.0, generated from library version 7.1.0 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v3.2.2.
+GJS TypeScript type definitions for HarfBuzz-0.0, generated from library version 8.1.1 using [ts-for-gir](https://github.com/gjsify/ts-for-gir) v3.2.8.
 
 
 ## Install
@@ -81,6 +81,19 @@ Now you have also type support for this, too:
 const HarfBuzz = imports.gi.HarfBuzz;
 ```
 
+
+### ESM vs. CommonJS
+
+GJS supports two different import syntaxes. The new modern ESM syntax and the old global imports syntax.
+
+In TypeScript projects for GJS and GNOME Shell extensions, you have the flexibility to use `ESM` syntax and then decide the import syntax for your bundled file. If your bundler is configured to use `CommonJS`, it will convert to the GJS-specific global imports syntax, like `const moduleName = imports.gi[moduleName]`. This is different from the traditional `require` syntax seen in Node.js. The global imports syntax is chosen because it aligns with the CommonJS format supported by NPM, which is used for the generated type definitions and this package.
+
+On the other hand, if you configure your bundler to use ESM, it will retain the ESM import syntax. It's crucial to ensure that your bundler is set up to correctly translate and bundle these imports into either CommonJS or ESM format, depending on your project's requirements.
+
+This approach is particularly important due to the `@girs` types, which include both `*.cjs `files, using the GJS global imports syntax, and `*.js` files, which utilize the ESM syntax. By appropriately setting up your bundler, you can control which syntax—CommonJS or ESM—is used in your project. The choice of CommonJS in this context is also due to the similarity between the GJS-specific global imports and CommonJS syntax, allowing for easier management and bundling in these specific types of projects.
+
+Since GNOME Shell 45, you should only use ESM, even for GNOME Shell extensions. Before that, extensions had to use the global import syntax, unlike normal GJS applications, where ESM has been available for some time.
+
 ### Bundle
 
 Depending on your project configuration, it is recommended to use a bundler like [esbuild](https://esbuild.github.io/). You can find examples using different bundlers [here](https://github.com/gjsify/ts-for-gir/tree/main/examples).

package/harfbuzz-0.0-ambient.d.ts

@@ -1,5 +1,4 @@
 
-
 declare module 'gi://HarfBuzz?version=0.0' {
     import HarfBuzz00 from '@girs/harfbuzz-0.0';
     export default HarfBuzz00;

package/harfbuzz-0.0-ambient.js

@@ -0,0 +1,2 @@
+export {}
+

package/harfbuzz-0.0-import.d.ts

@@ -1,5 +1,4 @@
 
-
 import HarfBuzz00 from '@girs/harfbuzz-0.0';
 
 declare global {

package/harfbuzz-0.0-import.js

@@ -0,0 +1,3 @@
+const gi = globalThis.imports?.gi || {};
+export default gi;
+

package/harfbuzz-0.0.d.cts

@@ -2973,9 +2973,9 @@ export enum unicode_combining_class_t {
      */
     CCC130,
     /**
-     * [Tibetan]
+     * [Tibetan] Since: 7.2.0
      */
-    CCC133,
+    CCC132,
     /**
      * Marks attached at the bottom left
      */
@@ -3483,6 +3483,10 @@ export const AAT_LAYOUT_NO_SELECTOR_INDEX: number
  * Set to U+FFFD REPLACEMENT CHARACTER.
  */
 export const BUFFER_REPLACEMENT_CODEPOINT_DEFAULT: number
+/**
+ * Unused #hb_codepoint_t value.
+ */
+export const CODEPOINT_INVALID: codepoint_t
 /**
  * Special setting for #hb_feature_t.start to apply the feature from the start
  * of the buffer.
@@ -3498,10 +3502,6 @@ export const FONT_NO_VAR_NAMED_INSTANCE: number
  * An unset #hb_language_t.
  */
 export const LANGUAGE_INVALID: language_t
-/**
- * Unset #hb_map_t value.
- */
-export const MAP_VALUE_INVALID: codepoint_t
 /**
  * Special value for language index indicating default or unsupported language.
  */
@@ -3531,9 +3531,9 @@ export const OT_MAX_TAGS_PER_SCRIPT: number
  */
 export const OT_VAR_NO_AXIS_INDEX: number
 /**
- * Unset #hb_set_t value.
+ * [Tibetan]
  */
-export const SET_VALUE_INVALID: codepoint_t
+export const UNICODE_COMBINING_CLASS_CCC133: number
 /**
  * Maximum valid Unicode code point.
  */
@@ -3542,22 +3542,10 @@ export const UNICODE_MAX: number
  * See Unicode 6.1 for details on the maximum decomposition length.
  */
 export const UNICODE_MAX_DECOMPOSITION_LEN: number
-/**
- * The major component of the library version available at compile-time.
- */
 export const VERSION_MAJOR: number
-/**
- * The micro component of the library version available at compile-time.
- */
 export const VERSION_MICRO: number
-/**
- * The minor component of the library version available at compile-time.
- */
 export const VERSION_MINOR: number
-/**
- * A string literal containing the library version available at compile-time.
- */
-export const VERSION_STRING: string | null
+export const VERSION_STRING: string
 /**
  * Fetches the name identifier of the specified feature type in the face's `name` table.
  * @param face #hb_face_t to work upon
@@ -3621,14 +3609,14 @@ export function blob_copy_writable_or_fail(blob: blob_t): blob_t
  * @param file_name A font filename
  * @returns An #hb_blob_t pointer with the content of the file, or hb_blob_get_empty() if failed.
  */
-export function blob_create_from_file(file_name: string | null): blob_t
+export function blob_create_from_file(file_name: string): blob_t
 /**
  * Creates a new blob containing the data from the
  * specified binary font file.
  * @param file_name A font filename
  * @returns An #hb_blob_t pointer with the content of the file, or `NULL` if failed.
  */
-export function blob_create_from_file_or_fail(file_name: string | null): blob_t
+export function blob_create_from_file_or_fail(file_name: string): blob_t
 /**
  * Returns a blob that represents a range of bytes in `parent`.  The new
  * blob is always created with #HB_MEMORY_MODE_READONLY, meaning that it
@@ -3803,7 +3791,7 @@ export function buffer_create_similar(src: buffer_t): buffer_t
  * @param format the #hb_buffer_serialize_format_t of the input `buf`
  * @returns `true` if parse was successful, `false` if an error occurred.
  */
-export function buffer_deserialize_glyphs(buffer: buffer_t, buf: string[], font: font_t | null, format: buffer_serialize_format_t): [ /* returnType */ bool_t, /* end_ptr */ string | null ]
+export function buffer_deserialize_glyphs(buffer: buffer_t, buf: string[], font: font_t | null, format: buffer_serialize_format_t): [ /* returnType */ bool_t, /* end_ptr */ string ]
 /**
  * Deserializes Unicode `buffer` from textual representation in the format
  * produced by hb_buffer_serialize_unicode().
@@ -3812,7 +3800,7 @@ export function buffer_deserialize_glyphs(buffer: buffer_t, buf: string[], font:
  * @param format the #hb_buffer_serialize_format_t of the input `buf`
  * @returns `true` if parse was successful, `false` if an error occurred.
  */
-export function buffer_deserialize_unicode(buffer: buffer_t, buf: string[], format: buffer_serialize_format_t): [ /* returnType */ bool_t, /* end_ptr */ string | null ]
+export function buffer_deserialize_unicode(buffer: buffer_t, buf: string[], format: buffer_serialize_format_t): [ /* returnType */ bool_t, /* end_ptr */ string ]
 /**
  * If dottedcircle_glyph is (hb_codepoint_t) -1 then #HB_BUFFER_DIFF_FLAG_DOTTED_CIRCLE_PRESENT
  * and #HB_BUFFER_DIFF_FLAG_NOTDEF_PRESENT are never returned.  This should be used by most
@@ -4024,7 +4012,7 @@ export function buffer_serialize_format_from_string(str: Uint8Array): buffer_ser
  * @param format an #hb_buffer_serialize_format_t to convert.
  * @returns  A `NULL` terminated string corresponding to @format. Should not be freed.
  */
-export function buffer_serialize_format_to_string(format: buffer_serialize_format_t): string | null
+export function buffer_serialize_format_to_string(format: buffer_serialize_format_t): string
 /**
  * Serializes `buffer` into a textual representation of its glyph content,
  * useful for showing the contents of the buffer, for example during debugging.
@@ -4324,7 +4312,7 @@ export function direction_from_string(str: Uint8Array): direction_t
  * @param direction The #hb_direction_t to convert
  * @returns The string corresponding to @direction
  */
-export function direction_to_string(direction: direction_t): string | null
+export function direction_to_string(direction: direction_t): string
 /**
  * Perform a "close-path" draw operation.
  * @param dfuncs draw functions
@@ -4484,7 +4472,7 @@ export function face_count(blob: blob_t): number
  * a face index into that blob.
  * 
  * The face index is used for blobs of file formats such as TTC and
- * and DFont that can contain more than one face.  Face indices within
+ * DFont that can contain more than one face.  Face indices within
  * such collections are zero-based.
  * 
  * <note>Note: If the blob font format is not a collection, `index`
@@ -4722,8 +4710,7 @@ export function font_funcs_is_immutable(ffuncs: font_funcs_t): bool_t
  */
 export function font_funcs_make_immutable(ffuncs: font_funcs_t): void
 /**
- * Sets the implementation function for #hb_font_draw_glyph_func_t,
- * which is the same as #hb_font_get_glyph_shape_func_t.
+ * Sets the implementation function for #hb_font_draw_glyph_func_t.
  * @param ffuncs A font-function structure
  * @param func The callback function to assign
  */
@@ -5661,7 +5648,7 @@ export function language_matches(language: language_t, specific: language_t): bo
  * @param language The #hb_language_t to convert
  * @returns  A `NULL`-terminated string representing the @language. Must not be freed by the caller.
  */
-export function language_to_string(language: language_t): string | null
+export function language_to_string(language: language_t): string
 /**
  * Tests whether memory allocation for a set was successful.
  * @param map A map
@@ -5912,6 +5899,15 @@ export function ot_font_set_funcs(font: font_t): void
  * @param features The array of features to collect,   terminated by %HB_TAG_NONE
  */
 export function ot_layout_collect_features(face: face_t, table_tag: tag_t, scripts: tag_t[] | null, languages: tag_t[] | null, features: tag_t[] | null): /* feature_indexes */ set_t
+/**
+ * Fetches the mapping from feature tags to feature indexes for
+ * the specified script and language.
+ * @param face #hb_face_t to work upon
+ * @param table_tag #HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS
+ * @param script_index The index of the requested script tag
+ * @param language_index The index of the requested language tag
+ */
+export function ot_layout_collect_features_map(face: face_t, table_tag: tag_t, script_index: number, language_index: number): /* feature_map */ map_t
 /**
  * Fetches a list of all feature-lookup indexes in the specified face's GSUB
  * table or GPOS table, underneath the specified scripts, languages, and
@@ -5988,6 +5984,19 @@ export function ot_layout_get_attach_points(face: face_t, glyph: codepoint_t, st
  * @returns `true` if found baseline value in the font.
  */
 export function ot_layout_get_baseline(font: font_t, baseline_tag: ot_layout_baseline_tag_t, direction: direction_t, script_tag: tag_t, language_tag: tag_t): [ /* returnType */ bool_t, /* coord */ position_t | null ]
+/**
+ * Fetches a baseline value from the face.
+ * 
+ * This function is like hb_ot_layout_get_baseline() but takes
+ * #hb_script_t and #hb_language_t instead of OpenType #hb_tag_t.
+ * @param font a font
+ * @param baseline_tag a baseline tag
+ * @param direction text direction.
+ * @param script script.
+ * @param language language, currently unused.
+ * @returns `true` if found baseline value in the font.
+ */
+export function ot_layout_get_baseline2(font: font_t, baseline_tag: ot_layout_baseline_tag_t, direction: direction_t, script: script_t, language: language_t | null): [ /* returnType */ bool_t, /* coord */ position_t | null ]
 /**
  * Fetches a baseline value from the face, and synthesizes
  * it if the font does not have it.
@@ -5998,6 +6007,54 @@ export function ot_layout_get_baseline(font: font_t, baseline_tag: ot_layout_bas
  * @param language_tag language tag, currently unused.
  */
 export function ot_layout_get_baseline_with_fallback(font: font_t, baseline_tag: ot_layout_baseline_tag_t, direction: direction_t, script_tag: tag_t, language_tag: tag_t): /* coord */ position_t
+/**
+ * Fetches a baseline value from the face, and synthesizes
+ * it if the font does not have it.
+ * 
+ * This function is like hb_ot_layout_get_baseline_with_fallback() but takes
+ * #hb_script_t and #hb_language_t instead of OpenType #hb_tag_t.
+ * @param font a font
+ * @param baseline_tag a baseline tag
+ * @param direction text direction.
+ * @param script script.
+ * @param language language, currently unused.
+ */
+export function ot_layout_get_baseline_with_fallback2(font: font_t, baseline_tag: ot_layout_baseline_tag_t, direction: direction_t, script: script_t, language: language_t | null): /* coord */ position_t
+/**
+ * Fetches script/language-specific font extents.  These values are
+ * looked up in the `BASE` table's `MinMax` records.
+ * 
+ * If no such extents are found, the default extents for the font are
+ * fetched. As such, the return value of this function can for the
+ * most part be ignored.  Note that the per-script/language extents
+ * do not have a line-gap value, and the line-gap is set to zero in
+ * that case.
+ * @param font a font
+ * @param direction text direction.
+ * @param script_tag script tag.
+ * @param language_tag language tag.
+ * @returns `true` if found script/language-specific font extents.
+ */
+export function ot_layout_get_font_extents(font: font_t, direction: direction_t, script_tag: tag_t, language_tag: tag_t): [ /* returnType */ bool_t, /* extents */ font_extents_t | null ]
+/**
+ * Fetches script/language-specific font extents.  These values are
+ * looked up in the `BASE` table's `MinMax` records.
+ * 
+ * If no such extents are found, the default extents for the font are
+ * fetched. As such, the return value of this function can for the
+ * most part be ignored.  Note that the per-script/language extents
+ * do not have a line-gap value, and the line-gap is set to zero in
+ * that case.
+ * 
+ * This function is like hb_ot_layout_get_font_extents() but takes
+ * #hb_script_t and #hb_language_t instead of OpenType #hb_tag_t.
+ * @param font a font
+ * @param direction text direction.
+ * @param script script.
+ * @param language language.
+ * @returns `true` if found script/language-specific font extents.
+ */
+export function ot_layout_get_font_extents2(font: font_t, direction: direction_t, script: script_t, language: language_t | null): [ /* returnType */ bool_t, /* extents */ font_extents_t | null ]
 /**
  * Fetches the GDEF class of the requested glyph in the specified face.
  * @param face The #hb_face_t to work on
@@ -6298,7 +6355,7 @@ export function ot_layout_table_select_script(face: face_t, table_tag: tag_t, sc
  * 
  * However, if the requested constant is #HB_OT_MATH_CONSTANT_SCRIPT_PERCENT_SCALE_DOWN,
  * #HB_OT_MATH_CONSTANT_SCRIPT_SCRIPT_PERCENT_SCALE_DOWN or
- * #HB_OT_MATH_CONSTANT_SCRIPT_PERCENT_SCALE_DOWN, then the return value is
+ * #HB_OT_MATH_CONSTANT_RADICAL_DEGREE_BOTTOM_RAISE_PERCENT, then the return value is
  * an integer between 0 and 100 representing that percentage.
  * @param font #hb_font_t to work upon
  * @param constant #hb_ot_math_constant_t the constant to retrieve
@@ -6562,7 +6619,7 @@ export function ot_tags_from_script(script: script_t): [ /* script_tag_1 */ tag_
  * @param script_count maximum number of script tags to retrieve (IN) and actual number of script tags retrieved (OUT)
  * @param language_count maximum number of language tags to retrieve (IN) and actual number of language tags retrieved (OUT)
  */
-export function ot_tags_from_script_and_language(script: script_t, language: language_t, script_count?: number, language_count?: number): [ /* script_count */ number, /* script_tags */ tag_t, /* language_count */ number, /* language_tags */ tag_t ]
+export function ot_tags_from_script_and_language(script: script_t, language: language_t | null, script_count?: number, language_count?: number): [ /* script_count */ number, /* script_tags */ tag_t, /* language_count */ number, /* language_tags */ tag_t ]
 /**
  * Converts a script tag and a language tag to an #hb_script_t and an
  * #hb_language_t.
@@ -7273,7 +7330,7 @@ export function shape_plan_get_empty(): shape_plan_t
  * @param shape_plan A shaping plan
  * @returns The shaper
  */
-export function shape_plan_get_shaper(shape_plan: shape_plan_t): string | null
+export function shape_plan_get_shaper(shape_plan: shape_plan_t): string
 /**
  * Searches variation axes of a #hb_font_t object for a specific axis first,
  * if not set, then tries to get default style values from different
@@ -7471,24 +7528,6 @@ export function variation_from_string(str: Uint8Array): [ /* returnType */ bool_
  * @param variation an #hb_variation_t to convert
  */
 export function variation_to_string(variation: variation_t): /* buf */ string[]
-/**
- * Returns library version as three integer components.
- */
-export function version(): [ /* major */ number, /* minor */ number, /* micro */ number ]
-/**
- * Tests the library version against a minimum value,
- * as three integer components.
- * @param major Library major version component
- * @param minor Library minor version component
- * @param micro Library micro version component
- * @returns `true` if the library is equal to or greater than the test value, `false` otherwise
- */
-export function version_atleast(major: number, minor: number, micro: number): bool_t
-/**
- * Returns library version as a string with three components.
- * @returns Library version string
- */
-export function version_string(): string | null
 /**
  * A callback method for #hb_buffer_t. The method gets called with the
  * #hb_buffer_t it was set on, the #hb_font_t the buffer is shaped with and a
@@ -7502,7 +7541,7 @@ export function version_string(): string | null
  * @returns `true` to perform the shaping step, `false` to skip it.
  */
 export interface buffer_message_func_t {
-    (buffer: buffer_t, font: font_t, message: string | null): bool_t
+    (buffer: buffer_t, font: font_t, message: string): bool_t
 }
 /**
  * A virtual method for the #hb_color_line_t to fetch color stops.
@@ -8655,7 +8694,7 @@ export interface language_t {
      * Converts an #hb_language_t to a string.
      * @returns  A `NULL`-terminated string representing the @language. Must not be freed by the caller.
      */
-    _string(): string | null
+    _string(): string
 }
 
 /**

package/harfbuzz-0.0.d.ts

@@ -2975,9 +2975,9 @@ enum unicode_combining_class_t {
      */
     CCC130,
     /**
-     * [Tibetan]
+     * [Tibetan] Since: 7.2.0
      */
-    CCC133,
+    CCC132,
     /**
      * Marks attached at the bottom left
      */
@@ -3485,6 +3485,10 @@ const AAT_LAYOUT_NO_SELECTOR_INDEX: number
  * Set to U+FFFD REPLACEMENT CHARACTER.
  */
 const BUFFER_REPLACEMENT_CODEPOINT_DEFAULT: number
+/**
+ * Unused #hb_codepoint_t value.
+ */
+const CODEPOINT_INVALID: codepoint_t
 /**
  * Special setting for #hb_feature_t.start to apply the feature from the start
  * of the buffer.
@@ -3500,10 +3504,6 @@ const FONT_NO_VAR_NAMED_INSTANCE: number
  * An unset #hb_language_t.
  */
 const LANGUAGE_INVALID: language_t
-/**
- * Unset #hb_map_t value.
- */
-const MAP_VALUE_INVALID: codepoint_t
 /**
  * Special value for language index indicating default or unsupported language.
  */
@@ -3533,9 +3533,9 @@ const OT_MAX_TAGS_PER_SCRIPT: number
  */
 const OT_VAR_NO_AXIS_INDEX: number
 /**
- * Unset #hb_set_t value.
+ * [Tibetan]
  */
-const SET_VALUE_INVALID: codepoint_t
+const UNICODE_COMBINING_CLASS_CCC133: number
 /**
  * Maximum valid Unicode code point.
  */
@@ -3544,22 +3544,10 @@ const UNICODE_MAX: number
  * See Unicode 6.1 for details on the maximum decomposition length.
  */
 const UNICODE_MAX_DECOMPOSITION_LEN: number
-/**
- * The major component of the library version available at compile-time.
- */
 const VERSION_MAJOR: number
-/**
- * The micro component of the library version available at compile-time.
- */
 const VERSION_MICRO: number
-/**
- * The minor component of the library version available at compile-time.
- */
 const VERSION_MINOR: number
-/**
- * A string literal containing the library version available at compile-time.
- */
-const VERSION_STRING: string | null
+const VERSION_STRING: string
 /**
  * Fetches the name identifier of the specified feature type in the face's `name` table.
  * @param face #hb_face_t to work upon
@@ -3623,14 +3611,14 @@ function blob_copy_writable_or_fail(blob: blob_t): blob_t
  * @param file_name A font filename
  * @returns An #hb_blob_t pointer with the content of the file, or hb_blob_get_empty() if failed.
  */
-function blob_create_from_file(file_name: string | null): blob_t
+function blob_create_from_file(file_name: string): blob_t
 /**
  * Creates a new blob containing the data from the
  * specified binary font file.
  * @param file_name A font filename
  * @returns An #hb_blob_t pointer with the content of the file, or `NULL` if failed.
  */
-function blob_create_from_file_or_fail(file_name: string | null): blob_t
+function blob_create_from_file_or_fail(file_name: string): blob_t
 /**
  * Returns a blob that represents a range of bytes in `parent`.  The new
  * blob is always created with #HB_MEMORY_MODE_READONLY, meaning that it
@@ -3805,7 +3793,7 @@ function buffer_create_similar(src: buffer_t): buffer_t
  * @param format the #hb_buffer_serialize_format_t of the input `buf`
  * @returns `true` if parse was successful, `false` if an error occurred.
  */
-function buffer_deserialize_glyphs(buffer: buffer_t, buf: string[], font: font_t | null, format: buffer_serialize_format_t): [ /* returnType */ bool_t, /* end_ptr */ string | null ]
+function buffer_deserialize_glyphs(buffer: buffer_t, buf: string[], font: font_t | null, format: buffer_serialize_format_t): [ /* returnType */ bool_t, /* end_ptr */ string ]
 /**
  * Deserializes Unicode `buffer` from textual representation in the format
  * produced by hb_buffer_serialize_unicode().
@@ -3814,7 +3802,7 @@ function buffer_deserialize_glyphs(buffer: buffer_t, buf: string[], font: font_t
  * @param format the #hb_buffer_serialize_format_t of the input `buf`
  * @returns `true` if parse was successful, `false` if an error occurred.
  */
-function buffer_deserialize_unicode(buffer: buffer_t, buf: string[], format: buffer_serialize_format_t): [ /* returnType */ bool_t, /* end_ptr */ string | null ]
+function buffer_deserialize_unicode(buffer: buffer_t, buf: string[], format: buffer_serialize_format_t): [ /* returnType */ bool_t, /* end_ptr */ string ]
 /**
  * If dottedcircle_glyph is (hb_codepoint_t) -1 then #HB_BUFFER_DIFF_FLAG_DOTTED_CIRCLE_PRESENT
  * and #HB_BUFFER_DIFF_FLAG_NOTDEF_PRESENT are never returned.  This should be used by most
@@ -4026,7 +4014,7 @@ function buffer_serialize_format_from_string(str: Uint8Array): buffer_serialize_
  * @param format an #hb_buffer_serialize_format_t to convert.
  * @returns  A `NULL` terminated string corresponding to @format. Should not be freed.
  */
-function buffer_serialize_format_to_string(format: buffer_serialize_format_t): string | null
+function buffer_serialize_format_to_string(format: buffer_serialize_format_t): string
 /**
  * Serializes `buffer` into a textual representation of its glyph content,
  * useful for showing the contents of the buffer, for example during debugging.
@@ -4326,7 +4314,7 @@ function direction_from_string(str: Uint8Array): direction_t
  * @param direction The #hb_direction_t to convert
  * @returns The string corresponding to @direction
  */
-function direction_to_string(direction: direction_t): string | null
+function direction_to_string(direction: direction_t): string
 /**
  * Perform a "close-path" draw operation.
  * @param dfuncs draw functions
@@ -4486,7 +4474,7 @@ function face_count(blob: blob_t): number
  * a face index into that blob.
  * 
  * The face index is used for blobs of file formats such as TTC and
- * and DFont that can contain more than one face.  Face indices within
+ * DFont that can contain more than one face.  Face indices within
  * such collections are zero-based.
  * 
  * <note>Note: If the blob font format is not a collection, `index`
@@ -4724,8 +4712,7 @@ function font_funcs_is_immutable(ffuncs: font_funcs_t): bool_t
  */
 function font_funcs_make_immutable(ffuncs: font_funcs_t): void
 /**
- * Sets the implementation function for #hb_font_draw_glyph_func_t,
- * which is the same as #hb_font_get_glyph_shape_func_t.
+ * Sets the implementation function for #hb_font_draw_glyph_func_t.
  * @param ffuncs A font-function structure
  * @param func The callback function to assign
  */
@@ -5663,7 +5650,7 @@ function language_matches(language: language_t, specific: language_t): bool_t
  * @param language The #hb_language_t to convert
  * @returns  A `NULL`-terminated string representing the @language. Must not be freed by the caller.
  */
-function language_to_string(language: language_t): string | null
+function language_to_string(language: language_t): string
 /**
  * Tests whether memory allocation for a set was successful.
  * @param map A map
@@ -5914,6 +5901,15 @@ function ot_font_set_funcs(font: font_t): void
  * @param features The array of features to collect,   terminated by %HB_TAG_NONE
  */
 function ot_layout_collect_features(face: face_t, table_tag: tag_t, scripts: tag_t[] | null, languages: tag_t[] | null, features: tag_t[] | null): /* feature_indexes */ set_t
+/**
+ * Fetches the mapping from feature tags to feature indexes for
+ * the specified script and language.
+ * @param face #hb_face_t to work upon
+ * @param table_tag #HB_OT_TAG_GSUB or #HB_OT_TAG_GPOS
+ * @param script_index The index of the requested script tag
+ * @param language_index The index of the requested language tag
+ */
+function ot_layout_collect_features_map(face: face_t, table_tag: tag_t, script_index: number, language_index: number): /* feature_map */ map_t
 /**
  * Fetches a list of all feature-lookup indexes in the specified face's GSUB
  * table or GPOS table, underneath the specified scripts, languages, and
@@ -5990,6 +5986,19 @@ function ot_layout_get_attach_points(face: face_t, glyph: codepoint_t, start_off
  * @returns `true` if found baseline value in the font.
  */
 function ot_layout_get_baseline(font: font_t, baseline_tag: ot_layout_baseline_tag_t, direction: direction_t, script_tag: tag_t, language_tag: tag_t): [ /* returnType */ bool_t, /* coord */ position_t | null ]
+/**
+ * Fetches a baseline value from the face.
+ * 
+ * This function is like hb_ot_layout_get_baseline() but takes
+ * #hb_script_t and #hb_language_t instead of OpenType #hb_tag_t.
+ * @param font a font
+ * @param baseline_tag a baseline tag
+ * @param direction text direction.
+ * @param script script.
+ * @param language language, currently unused.
+ * @returns `true` if found baseline value in the font.
+ */
+function ot_layout_get_baseline2(font: font_t, baseline_tag: ot_layout_baseline_tag_t, direction: direction_t, script: script_t, language: language_t | null): [ /* returnType */ bool_t, /* coord */ position_t | null ]
 /**
  * Fetches a baseline value from the face, and synthesizes
  * it if the font does not have it.
@@ -6000,6 +6009,54 @@ function ot_layout_get_baseline(font: font_t, baseline_tag: ot_layout_baseline_t
  * @param language_tag language tag, currently unused.
  */
 function ot_layout_get_baseline_with_fallback(font: font_t, baseline_tag: ot_layout_baseline_tag_t, direction: direction_t, script_tag: tag_t, language_tag: tag_t): /* coord */ position_t
+/**
+ * Fetches a baseline value from the face, and synthesizes
+ * it if the font does not have it.
+ * 
+ * This function is like hb_ot_layout_get_baseline_with_fallback() but takes
+ * #hb_script_t and #hb_language_t instead of OpenType #hb_tag_t.
+ * @param font a font
+ * @param baseline_tag a baseline tag
+ * @param direction text direction.
+ * @param script script.
+ * @param language language, currently unused.
+ */
+function ot_layout_get_baseline_with_fallback2(font: font_t, baseline_tag: ot_layout_baseline_tag_t, direction: direction_t, script: script_t, language: language_t | null): /* coord */ position_t
+/**
+ * Fetches script/language-specific font extents.  These values are
+ * looked up in the `BASE` table's `MinMax` records.
+ * 
+ * If no such extents are found, the default extents for the font are
+ * fetched. As such, the return value of this function can for the
+ * most part be ignored.  Note that the per-script/language extents
+ * do not have a line-gap value, and the line-gap is set to zero in
+ * that case.
+ * @param font a font
+ * @param direction text direction.
+ * @param script_tag script tag.
+ * @param language_tag language tag.
+ * @returns `true` if found script/language-specific font extents.
+ */
+function ot_layout_get_font_extents(font: font_t, direction: direction_t, script_tag: tag_t, language_tag: tag_t): [ /* returnType */ bool_t, /* extents */ font_extents_t | null ]
+/**
+ * Fetches script/language-specific font extents.  These values are
+ * looked up in the `BASE` table's `MinMax` records.
+ * 
+ * If no such extents are found, the default extents for the font are
+ * fetched. As such, the return value of this function can for the
+ * most part be ignored.  Note that the per-script/language extents
+ * do not have a line-gap value, and the line-gap is set to zero in
+ * that case.
+ * 
+ * This function is like hb_ot_layout_get_font_extents() but takes
+ * #hb_script_t and #hb_language_t instead of OpenType #hb_tag_t.
+ * @param font a font
+ * @param direction text direction.
+ * @param script script.
+ * @param language language.
+ * @returns `true` if found script/language-specific font extents.
+ */
+function ot_layout_get_font_extents2(font: font_t, direction: direction_t, script: script_t, language: language_t | null): [ /* returnType */ bool_t, /* extents */ font_extents_t | null ]
 /**
  * Fetches the GDEF class of the requested glyph in the specified face.
  * @param face The #hb_face_t to work on
@@ -6300,7 +6357,7 @@ function ot_layout_table_select_script(face: face_t, table_tag: tag_t, script_co
  * 
  * However, if the requested constant is #HB_OT_MATH_CONSTANT_SCRIPT_PERCENT_SCALE_DOWN,
  * #HB_OT_MATH_CONSTANT_SCRIPT_SCRIPT_PERCENT_SCALE_DOWN or
- * #HB_OT_MATH_CONSTANT_SCRIPT_PERCENT_SCALE_DOWN, then the return value is
+ * #HB_OT_MATH_CONSTANT_RADICAL_DEGREE_BOTTOM_RAISE_PERCENT, then the return value is
  * an integer between 0 and 100 representing that percentage.
  * @param font #hb_font_t to work upon
  * @param constant #hb_ot_math_constant_t the constant to retrieve
@@ -6564,7 +6621,7 @@ function ot_tags_from_script(script: script_t): [ /* script_tag_1 */ tag_t, /* s
  * @param script_count maximum number of script tags to retrieve (IN) and actual number of script tags retrieved (OUT)
  * @param language_count maximum number of language tags to retrieve (IN) and actual number of language tags retrieved (OUT)
  */
-function ot_tags_from_script_and_language(script: script_t, language: language_t, script_count?: number, language_count?: number): [ /* script_count */ number, /* script_tags */ tag_t, /* language_count */ number, /* language_tags */ tag_t ]
+function ot_tags_from_script_and_language(script: script_t, language: language_t | null, script_count?: number, language_count?: number): [ /* script_count */ number, /* script_tags */ tag_t, /* language_count */ number, /* language_tags */ tag_t ]
 /**
  * Converts a script tag and a language tag to an #hb_script_t and an
  * #hb_language_t.
@@ -7275,7 +7332,7 @@ function shape_plan_get_empty(): shape_plan_t
  * @param shape_plan A shaping plan
  * @returns The shaper
  */
-function shape_plan_get_shaper(shape_plan: shape_plan_t): string | null
+function shape_plan_get_shaper(shape_plan: shape_plan_t): string
 /**
  * Searches variation axes of a #hb_font_t object for a specific axis first,
  * if not set, then tries to get default style values from different
@@ -7473,24 +7530,6 @@ function variation_from_string(str: Uint8Array): [ /* returnType */ bool_t, /* v
  * @param variation an #hb_variation_t to convert
  */
 function variation_to_string(variation: variation_t): /* buf */ string[]
-/**
- * Returns library version as three integer components.
- */
-function version(): [ /* major */ number, /* minor */ number, /* micro */ number ]
-/**
- * Tests the library version against a minimum value,
- * as three integer components.
- * @param major Library major version component
- * @param minor Library minor version component
- * @param micro Library micro version component
- * @returns `true` if the library is equal to or greater than the test value, `false` otherwise
- */
-function version_atleast(major: number, minor: number, micro: number): bool_t
-/**
- * Returns library version as a string with three components.
- * @returns Library version string
- */
-function version_string(): string | null
 /**
  * A callback method for #hb_buffer_t. The method gets called with the
  * #hb_buffer_t it was set on, the #hb_font_t the buffer is shaped with and a
@@ -7504,7 +7543,7 @@ function version_string(): string | null
  * @returns `true` to perform the shaping step, `false` to skip it.
  */
 interface buffer_message_func_t {
-    (buffer: buffer_t, font: font_t, message: string | null): bool_t
+    (buffer: buffer_t, font: font_t, message: string): bool_t
 }
 /**
  * A virtual method for the #hb_color_line_t to fetch color stops.
@@ -8657,7 +8696,7 @@ interface language_t {
      * Converts an #hb_language_t to a string.
      * @returns  A `NULL`-terminated string representing the @language. Must not be freed by the caller.
      */
-    _string(): string | null
+    _string(): string
 }
 
 /**

package/package.json

@@ -1,13 +1,19 @@
 {
   "name": "@girs/harfbuzz-0.0",
-  "version": "7.1.0-3.2.2",
-  "description": "GJS TypeScript type definitions for HarfBuzz-0.0, generated from library version 7.1.0",
+  "version": "8.1.1-3.2.8",
+  "description": "GJS TypeScript type definitions for HarfBuzz-0.0, generated from library version 8.1.1",
   "type": "module",
   "module": "harfbuzz-0.0.js",
   "main": "harfbuzz-0.0.js",
   "exports": {
-    "./ambient": "./harfbuzz-0.0-ambient.d.ts",
-    "./import": "./harfbuzz-0.0-import.d.ts",
+    "./ambient": {
+      "types": "./harfbuzz-0.0-ambient.d.ts",
+      "default": "./harfbuzz-0.0-ambient.js"
+    },
+    "./import": {
+      "types": "./harfbuzz-0.0-import.d.ts",
+      "default": "./harfbuzz-0.0-import.js"
+    },
     ".": {
       "import": {
         "types": "./harfbuzz-0.0.d.ts",
@@ -25,10 +31,10 @@
     "test:cjs": "NODE_OPTIONS=--max_old_space_size=9216 tsc --noEmit harfbuzz-0.0.d.cts"
   },
   "dependencies": {
-    "@girs/freetype2-2.0": "^2.0.0-3.2.2",
-    "@girs/gjs": "^3.2.2",
-    "@girs/glib-2.0": "^2.77.0-3.2.2",
-    "@girs/gobject-2.0": "^2.77.0-3.2.2"
+    "@girs/freetype2-2.0": "^2.0.0-3.2.8",
+    "@girs/gjs": "^3.2.8",
+    "@girs/glib-2.0": "^2.77.0-3.2.8",
+    "@girs/gobject-2.0": "^2.77.0-3.2.8"
   },
   "devDependencies": {
     "typescript": "*"
@@ -45,7 +51,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/gjsify/types.git"
+    "url": "git+https://github.com/gjsify/ts-for-gir.git"
   },
   "bugs": {
     "url": "https://github.com/gjsify/ts-for-gir/issues"