@heroiclands/package-build 25.0.0 → 25.1.1

package/types/engine/script-fonts.d.mts

@@ -4,6 +4,7 @@
  * @typedef {object} FaceCodepoint
  * @property {string} codepoint - `U+` and the hexadecimal code point.
  * @property {string} glyph - The glyph's name in the face.
+ * @property {string} [code] - The font's case-sensitive glyph code.
  * @property {string} kind - What it is: `letter`, `numeral`, `mark` and so on.
  */
 /**
@@ -77,6 +78,10 @@ export type FaceCodepoint = {
      * - The glyph's name in the face.
      */
     glyph: string;
+    /**
+     * - The font's case-sensitive glyph code.
+     */
+    code?: string | undefined;
     /**
      * - What it is: `letter`, `numeral`, `mark` and so on.
      */

package/types/engine/site-preview.d.mts

@@ -11,7 +11,7 @@
  * @param {string} text - Markdown, optionally beginning with YAML frontmatter.
  * @param {{dark?: boolean, infobox?: boolean, file?: string, currentDate?: string,
  *   index?: import("./preview-index.mjs").PreviewIndex}} [options] - Explicit palette, profile visibility, diagnostic filename, neutral current date (default "720.1") and the content index, from {@link module:engine/preview-index.previewIndex}.
- * @returns {{ok: boolean, html: string, frontmatter: object, findings: object[]}} HTML and metadata with locally calculable ages; unavailable ages remain absent or null.
+ * @returns {{ok: boolean, html: string, frontmatter: object, findings: object[]}} HTML and metadata with locally calculable ages; unavailable ages remain absent or null. Error findings set `ok` to false while retaining the HTML.
  */
 export function renderPreview(text: string, { dark, infobox, file, currentDate, index }?: {
     dark?: boolean;

package/types/engine/word-inflections.d.mts

@@ -0,0 +1,25 @@
+/**
+ * A noun's stated plural, or the first literal ending replacement that fits.
+ *
+ * @param {{form: string, class?: unknown, plural?: unknown}} word - A word of
+ *   `data.words`.
+ * @param {Record<string, any>|undefined} grammar - Its language's
+ *   `data.grammar`.
+ * @returns {string|null} The plural, or `null` for a word that is no noun or
+ *   that no rule fits.
+ */
+export function pluralOf(word: {
+    form: string;
+    class?: unknown;
+    plural?: unknown;
+}, grammar: Record<string, any> | undefined): string | null;
+/**
+ * The plural a language's `data.grammar.plural` rule gives a form: the first
+ * literal ending replacement that fits, whatever the form's class.
+ *
+ * @param {string} form - The form.
+ * @param {Record<string, any>|undefined} grammar - Its language's
+ *   `data.grammar`.
+ * @returns {string|null} The plural, or `null` where no rule fits.
+ */
+export function pluralByRule(form: string, grammar: Record<string, any> | undefined): string | null;